chore: bump versions for release

- @united-workforce/util: 0.1.3 → 0.1.4
- @united-workforce/util-agent: 0.1.0 → 0.1.1
- @united-workforce/agent-hermes: 0.1.3 → 0.1.4
- @united-workforce/agent-claude-code: 0.1.2 → 0.1.3

.changeset/inject-thread-progress.md

@@ -1,12 +0,0 @@
----
-"@united-workforce/agent-hermes": patch
-"@united-workforce/agent-claude-code": patch
-"@united-workforce/util-agent": patch
----
-
-feat: inject thread progress into agent prompt (#127)
-
-Agents now receive a "Thread Progress" section in their prompt showing the
-current step number and how many times the current role has spoken before.
-This eliminates the need for agents to make tool calls (terminal, delegate_task)
-just to count their own turn history.

examples/debate.yaml

@@ -1,5 +1,22 @@
 name: debate
-description: "Structured two-side debate with host summary. Demonstrates multi-role coordination, oneOf output routing, and bounded termination."
+description: "Multi-role structured debate with critical thinking framework and host summary."
+
+# Shared frontmatter schema for debater roles (YAML anchor)
+x-debater-frontmatter: &debater-frontmatter
+  type: object
+  oneOf:
+    - properties:
+        $status: { const: speak }
+        argument: { type: string }
+      required: [$status, argument]
+    - properties:
+        $status: { const: conceded }
+        reason: { type: string }
+      required: [$status, reason]
+    - properties:
+        $status: { const: final }
+        closing: { type: string }
+      required: [$status, closing]
 
 roles:
   proponent:
@@ -9,12 +26,13 @@ roles:
     procedure: |
       You are an experienced scholar arguing FOR the proposition.
 
-      ## Critical Thinking Framework (apply before every response)
+      ## Critical Thinking Framework (execute before every speech)
 
-      ### A. Pre-response reflection (internal, do not output)
-      - Does every step in my argument chain hold? Any hidden assumptions?
+      ### A. Pre-speech reflection (internal, do not output)
+      - Does every step in my argument chain hold? Any hidden assumptions or logical gaps?
       - If I were my opponent, how would I attack this? Where am I weakest?
       - Does my evidence actually support my claim, or could it backfire?
+      - Should I go on offense or defense this round?
 
       ### B. Evidence discipline
       - Verify key numbers — watch for order-of-magnitude errors
@@ -32,21 +50,7 @@ roles:
       4. Otherwise output $status: speak and counter the opponent's points.
       5. Be rigorous, cite evidence, stay concise.
     output: "Debate argument"
-    frontmatter:
-      type: object
-      oneOf:
-        - properties:
-            $status: { const: speak }
-            argument: { type: string }
-          required: [$status, argument]
-        - properties:
-            $status: { const: conceded }
-            reason: { type: string }
-          required: [$status, reason]
-        - properties:
-            $status: { const: final }
-            closing: { type: string }
-          required: [$status, closing]
+    frontmatter: *debater-frontmatter
 
   opponent:
     description: "Argues AGAINST the proposition"
@@ -55,12 +59,13 @@ roles:
     procedure: |
       You are an experienced scholar arguing AGAINST the proposition.
 
-      ## Critical Thinking Framework (apply before every response)
+      ## Critical Thinking Framework (execute before every speech)
 
-      ### A. Pre-response reflection (internal, do not output)
-      - Does every step in my argument chain hold? Any hidden assumptions?
+      ### A. Pre-speech reflection (internal, do not output)
+      - Does every step in my argument chain hold? Any hidden assumptions or logical gaps?
       - If I were my opponent, how would I attack this? Where am I weakest?
       - Does my evidence actually support my claim, or could it backfire?
+      - Should I go on offense or defense this round?
 
       ### B. Evidence discipline
       - Verify key numbers — watch for order-of-magnitude errors
@@ -78,21 +83,7 @@ roles:
       4. Otherwise output $status: speak and counter the proponent's points.
       5. Be rigorous, cite evidence, stay concise.
     output: "Debate argument"
-    frontmatter:
-      type: object
-      oneOf:
-        - properties:
-            $status: { const: speak }
-            argument: { type: string }
-          required: [$status, argument]
-        - properties:
-            $status: { const: conceded }
-            reason: { type: string }
-          required: [$status, reason]
-        - properties:
-            $status: { const: final }
-            closing: { type: string }
-          required: [$status, closing]
+    frontmatter: *debater-frontmatter
 
   host:
     description: "Debate moderator — delivers impartial summary and verdict"

packages/agent-claude-code/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@united-workforce/agent-claude-code",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "files": [
     "src",
     "dist",

packages/agent-hermes/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@united-workforce/agent-hermes",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "files": [
     "src",
     "dist",

packages/agent-hermes/src/acp-client.ts

@@ -12,7 +12,11 @@ const OWN_VERSION = (
   }
 ).version;
 
-const HERMES_COMMAND = "hermes";
+/** Resolve hermes binary: `UWF_HERMES_BIN` override → default `"hermes"` via PATH. */
+function resolveHermesCommand(): string {
+  const override = process.env.UWF_HERMES_BIN;
+  return override !== undefined && override !== "" ? override : "hermes";
+}
 const PROTOCOL_VERSION = 1;
 
 type JsonRpcResponse = {
@@ -271,7 +275,8 @@ export class HermesAcpClient {
       return;
     }
 
-    const child = spawn(HERMES_COMMAND, ["acp"], {
+    const hermesCommand = resolveHermesCommand();
+    const child = spawn(hermesCommand, ["acp"], {
       env: process.env,
       shell: false,
       stdio: ["pipe", "pipe", "pipe"],

packages/util-agent/__tests__/build-output-format-instruction.test.ts

@@ -225,4 +225,34 @@ describe("buildOutputFormatInstruction", () => {
     const result = buildOutputFormatInstruction({});
     expect(result).toContain("Focus exclusively on YOUR role");
   });
+
+  test("renders const value as literal in flat schema example", () => {
+    const schema = {
+      type: "object",
+      properties: {
+        $status: { type: "string", const: "greeted" },
+        message: { type: "string" },
+      },
+      required: ["$status", "message"],
+    };
+    const result = buildOutputFormatInstruction(schema);
+    expect(result).toContain("$status: greeted");
+    expect(result).toContain("fixed value");
+    expect(result).not.toContain("$status: <string>");
+  });
+
+  test("renders const value for non-string types", () => {
+    const schema = {
+      type: "object",
+      properties: {
+        count: { type: "number", const: 42 },
+        done: { type: "boolean", const: true },
+      },
+      required: ["count", "done"],
+    };
+    const result = buildOutputFormatInstruction(schema);
+    expect(result).toContain("count: 42");
+    expect(result).toContain("done: true");
+    expect(result).toContain("fixed value");
+  });
 });

packages/util-agent/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@united-workforce/util-agent",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "files": [
     "src",
     "dist",

packages/util-agent/src/build-output-format-instruction.ts

@@ -74,6 +74,10 @@ function collectObjectSchemas(schema: JSONSchema): JSONSchema[] {
 }
 
 function resolvePropertySchema(prop: JSONSchema): JSONSchema {
+  if (prop.const !== undefined) {
+    return prop;
+  }
+
   if (Array.isArray(prop.enum) && prop.enum.length > 0) {
     return prop;
   }
@@ -113,6 +117,11 @@ function buildPropertyExampleLine(prop: SchemaProperty): string {
     commentParts.push("required");
   }
 
+  if (resolved.const !== undefined) {
+    commentParts.push("fixed value");
+    return `${prop.name}: ${formatYamlScalar(resolved.const)}${buildPropertyComment(commentParts)}`;
+  }
+
   if (Array.isArray(resolved.enum) && resolved.enum.length > 0) {
     const enumValues = resolved.enum.map((v) => String(v));
     commentParts.push(...enumValues);

packages/util/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@united-workforce/util",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "files": [
     "src",
     "dist",