@polpo-ai/server 0.17.3 → 0.18.0

package/dist/routes/completions/structured-output-phases.test.js

@@ -0,0 +1,255 @@
+import { describe, expect, it, vi } from "vitest";
+import { MockLanguageModelV3, convertArrayToReadableStream } from "ai/test";
+import { normalizeChatInteractionSettings } from "@polpo-ai/core/chat-interactions";
+import { executeStreamingChatCompletion, runNonStreamingChatCompletion, } from "./chat-handler.js";
+import { modelOutputForResponseFormat } from "./structured-output.js";
+import { createGuardedCompletionToolExecutor, } from "./tool-guardrails.js";
+const responseFormat = {
+    type: "json_schema",
+    json_schema: {
+        name: "answer",
+        strict: true,
+        schema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["answer"],
+            properties: { answer: { type: "string" } },
+        },
+    },
+};
+function fixture() {
+    let operationalTurn = 0;
+    const responseFormats = [];
+    const toolCounts = [];
+    const executor = vi.fn(async () => "inspected");
+    const usage = {
+        inputTokens: { total: 4 },
+        outputTokens: { total: 2 },
+    };
+    const model = new MockLanguageModelV3({
+        doStream: async (options) => {
+            responseFormats.push(options.responseFormat);
+            toolCounts.push(options.tools?.length ?? 0);
+            if (!options.responseFormat)
+                operationalTurn += 1;
+            if (!options.responseFormat && operationalTurn === 1) {
+                return { stream: convertArrayToReadableStream([
+                        { type: "stream-start", warnings: [] },
+                        { type: "tool-call", toolCallId: "inspect_1", toolName: "inspect", input: "{}" },
+                        { type: "finish", finishReason: { unified: "tool-calls", raw: undefined }, usage },
+                    ]) };
+            }
+            const text = options.responseFormat
+                ? '{"answer":"ready"}'
+                : "Operational work complete.";
+            return { stream: convertArrayToReadableStream([
+                    { type: "stream-start", warnings: [] },
+                    { type: "text-start", id: "text" },
+                    { type: "text-delta", id: "text", delta: text },
+                    { type: "text-end", id: "text" },
+                    { type: "finish", finishReason: { unified: "stop", raw: undefined }, usage },
+                ]) };
+        },
+    });
+    const deps = {
+        getConfig: () => ({ settings: {} }),
+        emit: vi.fn(),
+        resolveAgentModel: vi.fn(async () => ({
+            model: {
+                id: "mock/model",
+                provider: "mock",
+                aiModel: model,
+                maxTokens: 8192,
+                contextWindow: 128_000,
+            },
+        })),
+    };
+    const execution = {
+        deps,
+        body: {
+            agent: "test-agent",
+            messages: [{ role: "user", content: "Inspect and answer" }],
+            response_format: responseFormat,
+        },
+        completionId: "completion",
+        agentConfig: { name: "test-agent", model: "mock/model" },
+        agentMode: true,
+        fullSystemPrompt: "Inspect before answering.",
+        m: {
+            id: "mock/model",
+            provider: "mock",
+            aiModel: model,
+            maxTokens: 8192,
+            contextWindow: 128_000,
+        },
+        modelOutput: modelOutputForResponseFormat(responseFormat),
+        effectiveTools: [{
+                name: "inspect",
+                description: "Inspect",
+                parameters: { type: "object", properties: {}, additionalProperties: false },
+            }],
+        effectiveToolExecutor: executor,
+        clientSideTools: {},
+        interactionSettings: normalizeChatInteractionSettings({}),
+        aiMessages: [{ role: "user", content: "Inspect and answer" }],
+        sessionStore: null,
+        sessionId: null,
+    };
+    return { execution, executor, responseFormats, toolCounts };
+}
+describe("chat structured-output phases", () => {
+    it("separates operational tools from terminal output in non-streaming chat", async () => {
+        const f = fixture();
+        const response = await runNonStreamingChatCompletion({
+            req: { raw: { signal: new AbortController().signal } },
+            json: (body) => body,
+        }, f.execution);
+        expect(response.choices[0].message.content).toBe('{"answer":"ready"}');
+        expect(f.responseFormats).toEqual([
+            undefined,
+            undefined,
+            expect.objectContaining({ type: "json" }),
+        ]);
+        expect(f.toolCounts).toEqual([1, 1, 0]);
+        expect(f.executor).toHaveBeenCalledOnce();
+    });
+    it("buffers and validates terminal output before publishing streaming chat", async () => {
+        const f = fixture();
+        const frames = [];
+        const writer = {
+            write: vi.fn(async () => { }),
+            writeSSE: vi.fn(async ({ data }) => { frames.push(data); }),
+        };
+        await executeStreamingChatCompletion(writer, f.execution, new AbortController().signal);
+        expect(f.responseFormats).toEqual([
+            undefined,
+            undefined,
+            expect.objectContaining({ type: "json" }),
+        ]);
+        expect(f.toolCounts).toEqual([1, 1, 0]);
+        expect(f.executor).toHaveBeenCalledOnce();
+        const contentFrames = frames
+            .filter((frame) => frame !== "[DONE]")
+            .map((frame) => JSON.parse(frame))
+            .flatMap((frame) => frame.choices ?? [])
+            .map((choice) => choice.delta?.content)
+            .filter(Boolean);
+        expect(contentFrames).toEqual(['{"answer":"ready"}']);
+    });
+});
+function repeatedStableReadFixture() {
+    const providerCalls = vi.fn();
+    const usage = {
+        inputTokens: { total: 2 },
+        outputTokens: { total: 1 },
+    };
+    let turn = 0;
+    const model = new MockLanguageModelV3({
+        doStream: async () => {
+            providerCalls();
+            turn += 1;
+            return { stream: convertArrayToReadableStream([
+                    { type: "stream-start", warnings: [] },
+                    {
+                        type: "tool-call",
+                        toolCallId: `read_${turn}`,
+                        toolName: "stable_read",
+                        input: JSON.stringify({ key: "same" }),
+                    },
+                    { type: "finish", finishReason: { unified: "tool-calls", raw: undefined }, usage },
+                ]) };
+        },
+    });
+    const executor = vi.fn(async () => "unchanged");
+    const progress = {};
+    const tool = {
+        name: "stable_read",
+        description: "Read stable state",
+        parameters: {
+            type: "object",
+            properties: { key: { type: "string" } },
+            required: ["key"],
+            additionalProperties: false,
+        },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            resultStability: "stable",
+        },
+    };
+    const guarded = createGuardedCompletionToolExecutor({
+        executor,
+        tools: [tool],
+        context: { source: "request" },
+        onProgress: ({ name, decision }) => {
+            if (decision.action !== "stall")
+                return;
+            progress.stalled = {
+                code: decision.code,
+                toolName: name,
+                fingerprint: decision.fingerprint,
+                observation: decision.observation,
+                message: decision.message,
+            };
+        },
+    });
+    const execution = {
+        deps: { getConfig: () => ({ settings: {} }), emit: vi.fn() },
+        body: { agent: "test-agent", messages: [{ role: "user", content: "Read it" }] },
+        completionId: "completion-stall",
+        agentConfig: { name: "test-agent", model: "mock/model" },
+        agentMode: true,
+        fullSystemPrompt: "Use the read tool.",
+        m: {
+            id: "mock/model",
+            provider: "mock",
+            aiModel: model,
+            maxTokens: 8192,
+            contextWindow: 128_000,
+        },
+        effectiveTools: [tool],
+        effectiveToolExecutor: guarded,
+        toolProgressState: progress,
+        clientSideTools: {},
+        interactionSettings: normalizeChatInteractionSettings({}),
+        aiMessages: [{ role: "user", content: "Read it" }],
+        sessionStore: null,
+        sessionId: null,
+    };
+    return { execution, executor, providerCalls };
+}
+describe("chat stable-read livelock boundary", () => {
+    it("returns a typed non-streaming error on the fourth observation", async () => {
+        const fixture = repeatedStableReadFixture();
+        let status = 200;
+        const response = await runNonStreamingChatCompletion({
+            req: { raw: { signal: new AbortController().signal } },
+            json: (body, nextStatus) => {
+                status = nextStatus ?? 200;
+                return body;
+            },
+        }, fixture.execution);
+        expect(status).toBe(409);
+        expect(response.error).toMatchObject({
+            type: "runtime_error",
+            code: "tool_loop_stalled",
+        });
+        expect(fixture.providerCalls).toHaveBeenCalledTimes(4);
+        expect(fixture.executor).toHaveBeenCalledTimes(1);
+    });
+    it("emits the same typed error and stops the streaming loop", async () => {
+        const fixture = repeatedStableReadFixture();
+        const frames = [];
+        await executeStreamingChatCompletion({
+            write: vi.fn(async () => { }),
+            writeSSE: vi.fn(async ({ data }) => { frames.push(data); }),
+        }, fixture.execution, new AbortController().signal);
+        const payloads = frames
+            .filter((frame) => frame !== "[DONE]")
+            .map((frame) => JSON.parse(frame));
+        expect(payloads.some((frame) => frame.choices?.[0]?.error?.code === "tool_loop_stalled")).toBe(true);
+        expect(fixture.providerCalls).toHaveBeenCalledTimes(4);
+        expect(fixture.executor).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=structured-output-phases.test.js.map

package/dist/routes/completions/structured-output-phases.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output-phases.test.js","sourceRoot":"","sources":["../../../src/routes/completions/structured-output-phases.test.ts"],"names":[],"mappings":"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"}

package/dist/routes/completions/tool-guardrails.d.ts

@@ -1,18 +1,36 @@
-import { type RunToolMiddleware, type RuntimeGuardrailContext } from "@polpo-ai/core";
+import { type ToolExecutionReceiptStore, type ToolProgressDecision, type RunToolMiddleware, type RuntimeGuardrailContext } from "@polpo-ai/core";
 export interface CompletionToolExecutionOptions {
     readonly callId?: string;
     readonly signal?: AbortSignal;
 }
 export type CompletionToolExecutor = (name: string, args: Record<string, unknown>, options?: CompletionToolExecutionOptions) => Promise<string>;
+export interface CompletionToolProgressStall {
+    readonly code: "tool_loop_stalled";
+    readonly toolName: string;
+    readonly fingerprint: string;
+    readonly observation: number;
+    readonly message: string;
+}
+/** Mutable request/run-local signal shared with the owning surface controller. */
+export interface CompletionToolProgressState {
+    stalled?: CompletionToolProgressStall;
+}
 /**
  * Adapts the shared host-neutral middleware to the completion route's legacy
- * executor contract. An absent middleware returns the original function by
- * reference, preserving the disabled path exactly.
+ * executor contract. Canonical schema validation is unconditional and runs
+ * again after a middleware rewrite, immediately before the real executor.
  */
 export declare function createGuardedCompletionToolExecutor(options: {
     readonly executor: CompletionToolExecutor;
     readonly tools: readonly any[];
     readonly middleware?: RunToolMiddleware;
     readonly context: RuntimeGuardrailContext;
+    /** Durable hosts may inject a store shared across resume/retry boundaries. */
+    readonly receiptStore?: ToolExecutionReceiptStore;
+    readonly onProgress?: (input: {
+        name: string;
+        args: Readonly<Record<string, unknown>>;
+        decision: ToolProgressDecision;
+    }) => void;
 }): CompletionToolExecutor;
 //# sourceMappingURL=tool-guardrails.d.ts.map

package/dist/routes/completions/tool-guardrails.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-guardrails.d.ts","sourceRoot":"","sources":["../../../src/routes/completions/tool-guardrails.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC7B,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,8BAA8B,KACrC,OAAO,CAAC,MAAM,CAAC,CAAC;AAUrB;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE;IAC3D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;CAC3C,GAAG,sBAAsB,CA0BzB"}
+{"version":3,"file":"tool-guardrails.d.ts","sourceRoot":"","sources":["../../../src/routes/completions/tool-guardrails.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC7B,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,8BAA8B,KACrC,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,kFAAkF;AAClF,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC;AAcD;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE;IAC3D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,yBAAyB,CAAC;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,QAAQ,EAAE,oBAAoB,CAAC;KAChC,KAAK,IAAI,CAAC;CACZ,GAAG,sBAAsB,CAqHzB"}

package/dist/routes/completions/tool-guardrails.js

@@ -1,31 +1,112 @@
-import { inferToolSideEffect, } from "@polpo-ai/core";
-function toolSchemaMap(tools) {
+import { InMemoryToolExecutionReceiptStore, admitCanonicalToolContract, inferToolSideEffect, toolArgumentsFingerprint, ToolProgressTracker, } from "@polpo-ai/core";
+import { validateToolInput } from "@polpo-ai/llm";
+function toolContractMap(tools) {
     return new Map(tools
         .filter((tool) => tool && typeof tool.name === "string")
-        .map((tool) => [tool.name, tool.parameters ?? tool.inputSchema]));
+        .map((tool) => [tool.name, admitCanonicalToolContract(tool)]));
+}
+function invalidToolArguments(error) {
+    return `Error: Invalid tool arguments: ${error.message}`;
 }
 /**
  * Adapts the shared host-neutral middleware to the completion route's legacy
- * executor contract. An absent middleware returns the original function by
- * reference, preserving the disabled path exactly.
+ * executor contract. Canonical schema validation is unconditional and runs
+ * again after a middleware rewrite, immediately before the real executor.
  */
 export function createGuardedCompletionToolExecutor(options) {
-    if (!options.middleware)
-        return options.executor;
-    const schemas = toolSchemaMap(options.tools);
+    const contracts = toolContractMap(options.tools);
+    const annotations = new Map([...contracts].map(([name, contract]) => [name, contract.annotations]));
+    const progressTracker = new ToolProgressTracker();
+    const receiptStore = options.receiptStore ?? new InMemoryToolExecutionReceiptStore();
     return async (name, args, execution) => {
+        if (!contracts.has(name)) {
+            return `Error: Tool ${JSON.stringify(name)} is not available for execution.`;
+        }
+        const schema = contracts.get(name).inputSchema;
+        const initialValidation = await validateToolInput(schema, args);
+        if (!initialValidation.success) {
+            return invalidToolArguments(initialValidation.error);
+        }
+        const executeValidated = async (request) => {
+            if (!contracts.has(request.name)) {
+                return `Error: Tool ${JSON.stringify(request.name)} is not available for execution.`;
+            }
+            const rewrittenValidation = await validateToolInput(contracts.get(request.name).inputSchema, request.args);
+            if (!rewrittenValidation.success) {
+                return invalidToolArguments(rewrittenValidation.error);
+            }
+            const validatedArgs = rewrittenValidation.value;
+            const progressCall = {
+                name: request.name,
+                args: validatedArgs,
+                annotations: annotations.get(request.name),
+            };
+            const decision = progressTracker.inspect(progressCall);
+            options.onProgress?.({ name: request.name, args: validatedArgs, decision });
+            if (decision.action === "reuse")
+                return decision.result;
+            if (decision.action === "stall")
+                return `Error: ${decision.message}`;
+            if (request.callId) {
+                const claim = await receiptStore.claim({
+                    callId: request.callId,
+                    toolName: request.name,
+                    contractFingerprint: contracts.get(request.name).definitionFingerprint,
+                    argumentsFingerprint: toolArgumentsFingerprint(request.name, validatedArgs),
+                });
+                if (claim.action === "replay")
+                    return claim.result;
+                if (claim.action === "reject") {
+                    return `Error [${claim.code}]: ${claim.message}`;
+                }
+            }
+            let result;
+            try {
+                result = await options.executor(request.name, validatedArgs, {
+                    callId: request.callId,
+                    signal: request.signal,
+                });
+            }
+            catch (error) {
+                if (request.callId) {
+                    await receiptStore.settle({
+                        callId: request.callId,
+                        state: "outcome-unknown",
+                    });
+                }
+                throw error;
+            }
+            if (request.callId) {
+                await receiptStore.settle({
+                    callId: request.callId,
+                    state: result.startsWith("Error:") ? "failed" : "completed",
+                    result,
+                });
+            }
+            progressTracker.record({
+                ...progressCall,
+                result,
+                isError: result.startsWith("Error:"),
+            });
+            return result;
+        };
+        if (!options.middleware) {
+            return executeValidated({
+                name,
+                args: initialValidation.value,
+                callId: execution?.callId,
+                signal: execution?.signal,
+            });
+        }
         const result = await options.middleware.execute({
             name,
-            args,
+            args: initialValidation.value,
             callId: execution?.callId,
             signal: execution?.signal,
-            schema: schemas.get(name),
+            schema,
             sideEffect: inferToolSideEffect(name),
             context: options.context,
-        }, (request) => options.executor(request.name, request.args, {
-            callId: request.callId,
-            signal: request.signal,
-        }));
+        }, executeValidated);
         return result.output;
     };
 }

package/dist/routes/completions/tool-guardrails.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-guardrails.js","sourceRoot":"","sources":["../../../src/routes/completions/tool-guardrails.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAGpB,MAAM,gBAAgB,CAAC;AAaxB,SAAS,aAAa,CAAC,KAAqB;IAC1C,OAAO,IAAI,GAAG,CACZ,KAAK;SACF,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;SACvD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CACnE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mCAAmC,CAAC,OAKnD;IACC,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACjD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7C,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAW,CAAC,OAAO,CAC9C;YACE,IAAI;YACJ,IAAI;YACJ,MAAM,EAAE,SAAS,EAAE,MAAM;YACzB,MAAM,EAAE,SAAS,EAAE,MAAM;YACzB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YACzB,UAAU,EAAE,mBAAmB,CAAC,IAAI,CAAC;YACrC,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,EACD,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAC3B,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,IAA+B,EACvC;YACE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CACF,CACF,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"tool-guardrails.js","sourceRoot":"","sources":["../../../src/routes/completions/tool-guardrails.ts"],"names":[],"mappings":"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"}