@ggui-ai/negotiator 0.22.0 → 0.23.0

package/dist/llm-caller.d.ts

@@ -24,9 +24,10 @@
  *   model text. Implementations MUST NOT inject tool-use blocks when
  *   the caller didn't request them — the text path is used as a
  *   regex-JSON fallback.
- * - `callStructured?<T>(...)` is OPTIONAL. When present, it MUST
- *   return the input of the supplied `ToolSchema`'s tool, parsed as
- *   `T`, or THROW — never return anything else. It forces the tool
+ * - `callStructured?(...)` is OPTIONAL. When present, it MUST
+ *   return the input of the supplied `ToolSchema`'s tool, as the model
+ *   produced it (`unknown`: the caller parses it; ggui#1317), or THROW —
+ *   never return anything else. It forces the tool
  *   where the model allows that; a model that refuses a forced tool
  *   (the always-thinking family) is asked for it without forcing, so
  *   the call can end with no tool input, and that ending is a throw.
@@ -60,7 +61,7 @@ export interface LLMCaller {
      * this method — consumers detect absence and fall back to regex JSON
      * extraction on the text path.
      */
-    callStructured?<T>(systemPrompt: string, userMessage: string, tool: ToolSchema, maxTokens?: number): Promise<T>;
+    callStructured?(systemPrompt: string, userMessage: string, tool: ToolSchema, maxTokens?: number): Promise<unknown>;
 }
 /**
  * Provider + model selector for factory-style LLM caller

package/dist/llm-caller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-caller.d.ts","sourceRoot":"","sources":["../src/llm-caller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,IAAI,CACF,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,CAAC,EACf,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"llm-caller.d.ts","sourceRoot":"","sources":["../src/llm-caller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,IAAI,CACF,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;;;OAOG;IACH,cAAc,CAAC,CACb,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/llm-caller.js

@@ -24,9 +24,10 @@
  *   model text. Implementations MUST NOT inject tool-use blocks when
  *   the caller didn't request them — the text path is used as a
  *   regex-JSON fallback.
- * - `callStructured?<T>(...)` is OPTIONAL. When present, it MUST
- *   return the input of the supplied `ToolSchema`'s tool, parsed as
- *   `T`, or THROW — never return anything else. It forces the tool
+ * - `callStructured?(...)` is OPTIONAL. When present, it MUST
+ *   return the input of the supplied `ToolSchema`'s tool, as the model
+ *   produced it (`unknown`: the caller parses it; ggui#1317), or THROW —
+ *   never return anything else. It forces the tool
  *   where the model allows that; a model that refuses a forced tool
  *   (the always-thinking family) is asked for it without forcing, so
  *   the call can end with no tool input, and that ending is a throw.

package/dist/llm-rerank.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-rerank.d.ts","sourceRoot":"","sources":["../src/llm-rerank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,QAAA,MAAM,oBAAoB,03DAQ6U,CAAC;AAExW,QAAA,MAAM,WAAW,EAAE,UA4BlB,CAAC;AA6EF;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;CAAE,EACjC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,SAAS,eAAe,EAAE,GACrC,OAAO,CAAC,cAAc,CAAC,CAwDzB;AAGD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"llm-rerank.d.ts","sourceRoot":"","sources":["../src/llm-rerank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,QAAA,MAAM,oBAAoB,03DAQ6U,CAAC;AAExW,QAAA,MAAM,WAAW,EAAE,UA4BlB,CAAC;AA8EF;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;CAAE,EACjC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,SAAS,eAAe,EAAE,GACrC,OAAO,CAAC,cAAc,CAAC,CAwDzB;AAGD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/negotiator",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Contract-synthesis + match-judge engine for ggui's handshake. Synthesizes or repairs a conforming DataContract from an agent's draft, judges blueprint-match candidates for reuse, and validates contract structure + novelty — the primitives composed by decideHandshake in @ggui-ai/mcp-server-handlers. Deployment-agnostic: concrete embedding and vector-store bindings plug in via the storage interfaces from @ggui-ai/mcp-server-core.",
   "license": "Apache-2.0",
   "keywords": [
@@ -47,8 +47,8 @@
     }
   },
   "dependencies": {
-    "@ggui-ai/mcp-server-core": "0.22.0",
-    "@ggui-ai/protocol": "0.22.0"
+    "@ggui-ai/mcp-server-core": "0.23.0",
+    "@ggui-ai/protocol": "0.23.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/llm-caller.ts

@@ -24,9 +24,10 @@
  *   model text. Implementations MUST NOT inject tool-use blocks when
  *   the caller didn't request them — the text path is used as a
  *   regex-JSON fallback.
- * - `callStructured?<T>(...)` is OPTIONAL. When present, it MUST
- *   return the input of the supplied `ToolSchema`'s tool, parsed as
- *   `T`, or THROW — never return anything else. It forces the tool
+ * - `callStructured?(...)` is OPTIONAL. When present, it MUST
+ *   return the input of the supplied `ToolSchema`'s tool, as the model
+ *   produced it (`unknown`: the caller parses it; ggui#1317), or THROW —
+ *   never return anything else. It forces the tool
  *   where the model allows that; a model that refuses a forced tool
  *   (the always-thinking family) is asked for it without forcing, so
  *   the call can end with no tool input, and that ending is a throw.
@@ -67,12 +68,12 @@ export interface LLMCaller {
    * this method — consumers detect absence and fall back to regex JSON
    * extraction on the text path.
    */
-  callStructured?<T>(
+  callStructured?(
     systemPrompt: string,
     userMessage: string,
     tool: ToolSchema,
     maxTokens?: number,
-  ): Promise<T>;
+  ): Promise<unknown>;
 }
 
 /**

package/src/llm-rerank.ts

@@ -153,6 +153,7 @@ function truncate(text: string, max: number): string {
   return `${text.slice(0, max - 1)}…`;
 }
 
+/** The rerank tool's input once {@link parseToolInput} has validated it. */
 interface RerankToolInput {
   matchId: string | null;
   confidence: number;
@@ -169,7 +170,7 @@ function clampConfidence(value: unknown): number {
 function parseToolInput(
   raw: unknown,
   candidateIds: ReadonlySet<string>,
-): { matchId: string | null; confidence: number; reason: string } {
+): RerankToolInput {
   if (raw === null || typeof raw !== 'object') {
     return { matchId: null, confidence: 0, reason: 'parse-failed: non-object tool input' };
   }
@@ -241,7 +242,7 @@ export async function rerankCandidates(
 
   let toolInput: unknown;
   try {
-    toolInput = await deps.llm.callStructured<RerankToolInput>(
+    toolInput = await deps.llm.callStructured(
       RERANK_SYSTEM_PROMPT,
       userMessage,
       RERANK_TOOL,

package/src/synth-bench/cli-llm.ts

@@ -99,12 +99,12 @@ export function buildAnthropicLlmCaller(
         'negotiator dev caller: text-mode not exercised — use callStructured',
       );
     },
-    async callStructured<T>(
+    async callStructured(
       systemPrompt: string,
       userMessage: string,
       tool: ToolSchema,
       maxTokens?: number,
-    ): Promise<T> {
+    ): Promise<unknown> {
       // `temperature` deprecated on Haiku 4.5+ — Anthropic rejects with
       // HTTP 400. Residual stochasticity stays bounded via canonical-key
       // normalization downstream.
@@ -162,7 +162,7 @@ export function buildAnthropicLlmCaller(
           `anthropic: no tool_use block in response (stop_reason=${json.stop_reason ?? 'unknown'})`,
         );
       }
-      return toolBlock.input as T;
+      return toolBlock.input;
     },
   };
 }

package/src/synthesize-contract.ts

@@ -634,7 +634,7 @@ async function callSynthesizeTool(
   user: string,
 ): Promise<unknown> {
   if (typeof llm.callStructured === 'function') {
-    return llm.callStructured<SynthesizeToolInput>(
+    return llm.callStructured(
       system,
       user,
       SYNTHESIZE_TOOL,