@polpo-ai/server 0.11.1 → 0.12.1

package/dist/routes/completions/schemas.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Zod request/response schemas + OpenAPI route definition for the
+ * OpenAI-compatible chat completions endpoint.
+ */
+import { z } from "@hono/zod-openapi";
+/** OpenAI-compatible content part (text, image_url, or file reference). */
+export declare const contentPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image_url">;
+    image_url: z.ZodObject<{
+        url: z.ZodString;
+        detail: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            high: "high";
+            auto: "auto";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    file_id: z.ZodString;
+}, z.core.$strip>], "type">;
+export declare const messageSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        user: "user";
+        tool: "tool";
+        assistant: "assistant";
+        system: "system";
+    }>;
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"image_url">;
+        image_url: z.ZodObject<{
+            url: z.ZodString;
+            detail: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                high: "high";
+                auto: "auto";
+            }>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"file">;
+        file_id: z.ZodString;
+    }, z.core.$strip>], "type">>]>;
+    tool_call_id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const completionRequestSchema: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            user: "user";
+            tool: "tool";
+            assistant: "assistant";
+            system: "system";
+        }>;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"image_url">;
+            image_url: z.ZodObject<{
+                url: z.ZodString;
+                detail: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    high: "high";
+                    auto: "auto";
+                }>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            file_id: z.ZodString;
+        }, z.core.$strip>], "type">>]>;
+        tool_call_id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    stream: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    model: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+    agent: z.ZodOptional<z.ZodString>;
+    loop: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/** Parsed request body shape (post-validation, defaults applied). */
+export type CompletionRequestBody = z.infer<typeof completionRequestSchema>;
+export declare const completionResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    object: z.ZodLiteral<"chat.completion">;
+    created: z.ZodNumber;
+    model: z.ZodLiteral<"polpo">;
+    choices: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        message: z.ZodObject<{
+            role: z.ZodLiteral<"assistant">;
+            content: z.ZodString;
+        }, z.core.$strip>;
+        finish_reason: z.ZodEnum<{
+            length: "length";
+            stop: "stop";
+            ask_user: "ask_user";
+            mission_preview: "mission_preview";
+            vault_preview: "vault_preview";
+        }>;
+    }, z.core.$strip>>;
+    usage: z.ZodObject<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.core.$strip>;
+    loop_trace: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const errorResponseSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        message: z.ZodString;
+        type: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const chatCompletionsRoute: {
+    method: "post";
+    path: "/";
+    tags: string[];
+    summary: string;
+    description: string;
+    request: {
+        body: {
+            content: {
+                "application/json": {
+                    schema: z.ZodObject<{
+                        messages: z.ZodArray<z.ZodObject<{
+                            role: z.ZodEnum<{
+                                user: "user";
+                                tool: "tool";
+                                assistant: "assistant";
+                                system: "system";
+                            }>;
+                            content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                type: z.ZodLiteral<"text">;
+                                text: z.ZodString;
+                            }, z.core.$strip>, z.ZodObject<{
+                                type: z.ZodLiteral<"image_url">;
+                                image_url: z.ZodObject<{
+                                    url: z.ZodString;
+                                    detail: z.ZodOptional<z.ZodEnum<{
+                                        low: "low";
+                                        high: "high";
+                                        auto: "auto";
+                                    }>>;
+                                }, z.core.$strip>;
+                            }, z.core.$strip>, z.ZodObject<{
+                                type: z.ZodLiteral<"file">;
+                                file_id: z.ZodString;
+                            }, z.core.$strip>], "type">>]>;
+                            tool_call_id: z.ZodOptional<z.ZodString>;
+                            name: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>>;
+                        stream: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                        model: z.ZodOptional<z.ZodString>;
+                        temperature: z.ZodOptional<z.ZodNumber>;
+                        max_tokens: z.ZodOptional<z.ZodNumber>;
+                        agent: z.ZodOptional<z.ZodString>;
+                        loop: z.ZodOptional<z.ZodString>;
+                        project: z.ZodOptional<z.ZodString>;
+                        user: z.ZodOptional<z.ZodString>;
+                        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    }, z.core.$strip>;
+                };
+            };
+        };
+    };
+    responses: {
+        200: {
+            content: {
+                "application/json": {
+                    schema: z.ZodObject<{
+                        id: z.ZodString;
+                        object: z.ZodLiteral<"chat.completion">;
+                        created: z.ZodNumber;
+                        model: z.ZodLiteral<"polpo">;
+                        choices: z.ZodArray<z.ZodObject<{
+                            index: z.ZodNumber;
+                            message: z.ZodObject<{
+                                role: z.ZodLiteral<"assistant">;
+                                content: z.ZodString;
+                            }, z.core.$strip>;
+                            finish_reason: z.ZodEnum<{
+                                length: "length";
+                                stop: "stop";
+                                ask_user: "ask_user";
+                                mission_preview: "mission_preview";
+                                vault_preview: "vault_preview";
+                            }>;
+                        }, z.core.$strip>>;
+                        usage: z.ZodObject<{
+                            prompt_tokens: z.ZodNumber;
+                            completion_tokens: z.ZodNumber;
+                            total_tokens: z.ZodNumber;
+                        }, z.core.$strip>;
+                        loop_trace: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+                    }, z.core.$strip>;
+                };
+            };
+            description: string;
+        };
+        400: {
+            content: {
+                "application/json": {
+                    schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            message: z.ZodString;
+                            type: z.ZodString;
+                            code: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            description: string;
+        };
+        401: {
+            content: {
+                "application/json": {
+                    schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            message: z.ZodString;
+                            type: z.ZodString;
+                            code: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            description: string;
+        };
+    };
+} & {
+    getRoutingPath(): "/";
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/routes/completions/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/routes/completions/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAe,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAInD,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;2BAa5B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcxB,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0ClC,CAAC;AAEH,qEAAqE;AACrE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE5E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBnC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;iBAM9B,CAAC;AAIH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC/B,CAAC"}

package/dist/routes/completions/schemas.js

@@ -0,0 +1,148 @@
+/**
+ * Zod request/response schemas + OpenAPI route definition for the
+ * OpenAI-compatible chat completions endpoint.
+ */
+import { createRoute, z } from "@hono/zod-openapi";
+// ── Zod Schemas ────────────────────────────────────────────────────────
+/** OpenAI-compatible content part (text, image_url, or file reference). */
+export const contentPartSchema = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("text"), text: z.string() }),
+    z.object({
+        type: z.literal("image_url"),
+        image_url: z.object({
+            url: z.string().openapi({ description: "Data URL (data:image/…;base64,…) or HTTPS URL" }),
+            detail: z.enum(["auto", "low", "high"]).optional(),
+        }),
+    }),
+    z.object({
+        type: z.literal("file"),
+        file_id: z.string().openapi({ description: "Attachment ID from a previous upload" }),
+    }),
+]);
+export const messageSchema = z.object({
+    role: z.enum(["system", "user", "assistant", "tool"]).openapi({
+        description: "Message role. System messages are appended as additional context. Tool messages carry results of client-side tool calls.",
+    }),
+    content: z.union([
+        z.string(),
+        z.array(contentPartSchema),
+    ]).openapi({ description: "Message content — plain string or array of content parts (text / image_url)" }),
+    tool_call_id: z.string().optional().openapi({
+        description: "ID of the tool call this message responds to (required for role=tool)",
+    }),
+    name: z.string().optional().openapi({
+        description: "Tool name (for role=tool messages)",
+    }),
+});
+export const completionRequestSchema = z.object({
+    messages: z.array(messageSchema).min(1).openapi({
+        description: "Conversation messages in OpenAI format",
+    }),
+    stream: z.boolean().optional().default(false).openapi({
+        description: "If true, returns an SSE stream of OpenAI-format chunks. If false, returns a complete response.",
+    }),
+    model: z.string().optional().openapi({
+        description: "Ignored. Polpo uses its configured orchestrator model (or the agent's model in agent-direct mode).",
+    }),
+    temperature: z.number().optional().openapi({
+        description: "Ignored. Reserved for future use.",
+    }),
+    max_tokens: z.number().int().optional().openapi({
+        description: "Ignored. Reserved for future use.",
+    }),
+    agent: z.string().optional().openapi({
+        description: "Target a specific agent by name for direct conversation. Uses the agent's own model, system prompt, and coding tools instead of the orchestrator. Omit to talk to the orchestrator (default).",
+    }),
+    loop: z.string().optional().openapi({
+        description: "Optional configurable loop name for agent-direct mode. Applies that loop's prompt, tools, model, reasoning, and maxTurns overrides.",
+    }),
+    project: z.string().optional().openapi({
+        description: "Deprecated. Ignored.",
+    }),
+    // OpenAI-compat identity fields. Persisted on the Session row and exposed
+    // via GET /v1/chat/sessions filters. Polpo does NOT verify `user`; the
+    // caller's API key is the trust anchor — `user` is purely opaque scoping.
+    user: z.string().optional().openapi({
+        description: "Opaque end-user identifier (OpenAI-compat). Persisted on the session and used for filtering, per-user analytics, and pass-through to billing integrations (e.g. Autumn customer_id). Polpo does not verify this — set it from your authenticated end-user id.",
+    }),
+    metadata: z
+        .record(z.string(), z.string())
+        .refine((m) => Object.keys(m).length <= 16, { message: "metadata: max 16 keys" })
+        .refine((m) => Object.keys(m).every((k) => k.length <= 64), { message: "metadata: key max 64 chars" })
+        .refine((m) => Object.values(m).every((v) => v.length <= 512), { message: "metadata: value max 512 chars" })
+        .optional()
+        .openapi({
+        description: "Arbitrary key/value tags (OpenAI-compat). Up to 16 keys, key ≤64 chars, value ≤512 chars. Persisted on the session for filtering and analytics. Use for tenant_id, plan, identity_provider, ab_variant, etc.",
+    }),
+});
+export const completionResponseSchema = z.object({
+    id: z.string().openapi({ description: "Unique completion ID (chatcmpl-...)" }),
+    object: z.literal("chat.completion"),
+    created: z.number().int().openapi({ description: "Unix timestamp" }),
+    model: z.literal("polpo"),
+    choices: z.array(z.object({
+        index: z.number().int(),
+        message: z.object({
+            role: z.literal("assistant"),
+            content: z.string(),
+        }),
+        finish_reason: z.enum(["stop", "length", "ask_user", "mission_preview", "vault_preview"]),
+    })),
+    usage: z.object({
+        prompt_tokens: z.number().int(),
+        completion_tokens: z.number().int(),
+        total_tokens: z.number().int(),
+    }),
+    loop_trace: z.array(z.unknown()).optional(),
+});
+export const errorResponseSchema = z.object({
+    error: z.object({
+        message: z.string(),
+        type: z.string(),
+        code: z.string().optional(),
+    }),
+});
+// ── Route definition ───────────────────────────────────────────────────
+export const chatCompletionsRoute = createRoute({
+    method: "post",
+    path: "/",
+    tags: ["Chat Completions"],
+    summary: "Chat completions",
+    description: "Polpo's primary conversational interface. Send messages in OpenAI format, receive responses in OpenAI format. Polpo runs its full 37-tool agentic loop internally — you describe what you need, Polpo handles the rest. Supports streaming (SSE) and non-streaming modes.",
+    request: {
+        body: {
+            content: {
+                "application/json": {
+                    schema: completionRequestSchema,
+                },
+            },
+        },
+    },
+    responses: {
+        200: {
+            content: {
+                "application/json": {
+                    schema: completionResponseSchema,
+                },
+            },
+            description: "Chat completion response (non-streaming). When stream=true, returns text/event-stream with OpenAI-format chunks ending with data: [DONE].",
+        },
+        400: {
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema,
+                },
+            },
+            description: "Invalid request (missing messages or no project available)",
+        },
+        401: {
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema,
+                },
+            },
+            description: "Invalid API key",
+        },
+    },
+});
+//# sourceMappingURL=schemas.js.map

package/dist/routes/completions/schemas.js.map

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

package/dist/routes/completions/sse.d.ts

@@ -0,0 +1,57 @@
+/**
+ * SSE chunk formatting, error envelopes, and the non-streaming response
+ * shape for the chat completions endpoint.
+ */
+import type { LanguageModelUsage } from "ai";
+export declare function sseChunk(id: string, delta: {
+    content?: string;
+    role?: string;
+}, finishReason?: string | null, extra?: Record<string, unknown>): string;
+/**
+ * Detect Vercel AI Gateway "model not found" errors so callers see a
+ * clean 400 (with the offending model id + agent name) instead of a
+ * generic 500 surfaced by Hono's default error handler.
+ *
+ * Triggers on:
+ *   - `GatewayModelNotFoundError` constructor name from `@ai-sdk/gateway`
+ *   - any 404 response whose body mentions `model_not_found` (covers
+ *     custom gateways that don't ship the typed error class)
+ *
+ * Returns the error envelope to send back, or null if the error isn't a
+ * model-not-found and should propagate untouched.
+ */
+export declare function modelNotFoundEnvelope(err: unknown, fallbackModelId: string | undefined, agent: string | undefined): {
+    message: string;
+    type: "model_not_found";
+    param: {
+        modelId: string;
+        agent?: string;
+    };
+} | null;
+export declare function loopRuntimeErrorEnvelope(err: unknown): {
+    message: string;
+    type: "loop_runtime_error";
+    code: "loop_policy_blocked" | "loop_permission_blocked" | "loop_approval_required" | "loop_hook_failed";
+    approvalRequestId?: string;
+    loopRunId?: string;
+} | null;
+export declare function completionResponse(id: string, content: string, usage: LanguageModelUsage, extra?: Record<string, unknown>): {
+    id: string;
+    object: "chat.completion";
+    created: number;
+    model: "polpo";
+    choices: {
+        index: number;
+        message: {
+            role: "assistant";
+            content: string;
+        };
+        finish_reason: "stop";
+    }[];
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+};
+//# sourceMappingURL=sse.d.ts.map

package/dist/routes/completions/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/routes/completions/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAE7C,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,YAAY,GAAE,MAAM,GAAG,IAAW,EAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAaR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,CAkBjG;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,qBAAqB,GAAG,yBAAyB,GAAG,wBAAwB,GAAG,kBAAkB,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAwBjN;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;EAkBzH"}

package/dist/routes/completions/sse.js

@@ -0,0 +1,96 @@
+/**
+ * SSE chunk formatting, error envelopes, and the non-streaming response
+ * shape for the chat completions endpoint.
+ */
+import { LoopApprovalRequiredError, LoopPermissionApprovalRequiredError, LoopPermissionDeniedError, LoopPolicyDeniedError, } from "@polpo-ai/core";
+export function sseChunk(id, delta, finishReason = null, extra) {
+    return JSON.stringify({
+        id,
+        object: "chat.completion.chunk",
+        created: Math.floor(Date.now() / 1000),
+        model: "polpo",
+        choices: [{
+                index: 0,
+                delta,
+                finish_reason: finishReason,
+                ...extra,
+            }],
+    });
+}
+/**
+ * Detect Vercel AI Gateway "model not found" errors so callers see a
+ * clean 400 (with the offending model id + agent name) instead of a
+ * generic 500 surfaced by Hono's default error handler.
+ *
+ * Triggers on:
+ *   - `GatewayModelNotFoundError` constructor name from `@ai-sdk/gateway`
+ *   - any 404 response whose body mentions `model_not_found` (covers
+ *     custom gateways that don't ship the typed error class)
+ *
+ * Returns the error envelope to send back, or null if the error isn't a
+ * model-not-found and should propagate untouched.
+ */
+export function modelNotFoundEnvelope(err, fallbackModelId, agent) {
+    if (!err || typeof err !== "object")
+        return null;
+    const e = err;
+    const isGatewayNotFound = e.name === "GatewayModelNotFoundError" ||
+        e.constructor?.name === "GatewayModelNotFoundError" ||
+        (e.statusCode === 404 &&
+            typeof e.responseBody === "string" &&
+            e.responseBody.includes("model_not_found"));
+    if (!isGatewayNotFound)
+        return null;
+    const modelId = e.modelId ?? fallbackModelId ?? "unknown";
+    return {
+        message: `Model "${modelId}" is not available on the gateway. ` +
+            `It may have been renamed or deprecated — update the agent config (or the orchestrator default).`,
+        type: "model_not_found",
+        param: { modelId, ...(agent ? { agent } : {}) },
+    };
+}
+export function loopRuntimeErrorEnvelope(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (err instanceof LoopApprovalRequiredError || err instanceof LoopPermissionApprovalRequiredError) {
+        return {
+            message,
+            type: "loop_runtime_error",
+            code: "loop_approval_required",
+            approvalRequestId: err.approvalRequestId,
+            loopRunId: err.loopRunId,
+        };
+    }
+    if (err instanceof LoopPermissionDeniedError) {
+        return { message, type: "loop_runtime_error", code: "loop_permission_blocked", loopRunId: err.loopRunId };
+    }
+    if (err instanceof LoopPolicyDeniedError) {
+        return { message, type: "loop_runtime_error", code: "loop_policy_blocked", loopRunId: err.loopRunId };
+    }
+    if (message.startsWith("Loop policy ")) {
+        return { message, type: "loop_runtime_error", code: "loop_policy_blocked" };
+    }
+    if (message.startsWith("Loop hook ")) {
+        return { message, type: "loop_runtime_error", code: "loop_hook_failed" };
+    }
+    return null;
+}
+export function completionResponse(id, content, usage, extra) {
+    return {
+        id,
+        object: "chat.completion",
+        created: Math.floor(Date.now() / 1000),
+        model: "polpo",
+        choices: [{
+                index: 0,
+                message: { role: "assistant", content },
+                finish_reason: "stop",
+            }],
+        usage: {
+            prompt_tokens: usage.inputTokens ?? 0,
+            completion_tokens: usage.outputTokens ?? 0,
+            total_tokens: usage.totalTokens ?? 0,
+        },
+        ...extra,
+    };
+}
+//# sourceMappingURL=sse.js.map

package/dist/routes/completions/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../src/routes/completions/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,yBAAyB,EACzB,mCAAmC,EACnC,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,UAAU,QAAQ,CACtB,EAAU,EACV,KAA0C,EAC1C,eAA8B,IAAI,EAClC,KAA+B;IAE/B,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,EAAE;QACF,MAAM,EAAE,uBAAuB;QAC/B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACtC,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;gBACR,KAAK;gBACL,aAAa,EAAE,YAAY;gBAC3B,GAAG,KAAK;aACT,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAY,EACZ,eAAmC,EACnC,KAAyB;IAEzB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,GAAU,CAAC;IACrB,MAAM,iBAAiB,GACrB,CAAC,CAAC,IAAI,KAAK,2BAA2B;QACtC,CAAC,CAAC,WAAW,EAAE,IAAI,KAAK,2BAA2B;QACnD,CAAC,CAAC,CAAC,UAAU,KAAK,GAAG;YACnB,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;YAClC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,iBAAiB;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,OAAO,GAAW,CAAC,CAAC,OAAO,IAAI,eAAe,IAAI,SAAS,CAAC;IAClE,OAAO;QACL,OAAO,EACL,UAAU,OAAO,qCAAqC;YACtD,iGAAiG;QACnG,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,GAAY;IAEZ,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,IAAI,GAAG,YAAY,yBAAyB,IAAI,GAAG,YAAY,mCAAmC,EAAE,CAAC;QACnG,OAAO;YACL,OAAO;YACP,IAAI,EAAE,oBAAoB;YAC1B,IAAI,EAAE,wBAAwB;YAC9B,iBAAiB,EAAG,GAAW,CAAC,iBAAiB;YACjD,SAAS,EAAG,GAAW,CAAC,SAAS;SAClC,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,YAAY,yBAAyB,EAAE,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAG,GAAW,CAAC,SAAS,EAAE,CAAC;IACrH,CAAC;IACD,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,qBAAqB,EAAE,SAAS,EAAG,GAAW,CAAC,SAAS,EAAE,CAAC;IACjH,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,OAAe,EAAE,KAAyB,EAAE,KAA+B;IACxH,OAAO;QACL,EAAE;QACF,MAAM,EAAE,iBAA0B;QAClC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACtC,KAAK,EAAE,OAAgB;QACvB,OAAO,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,EAAE,IAAI,EAAE,WAAoB,EAAE,OAAO,EAAE;gBAChD,aAAa,EAAE,MAAe;aAC/B,CAAC;QACF,KAAK,EAAE;YACL,aAAa,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC;YACrC,iBAAiB,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;YAC1C,YAAY,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC;SACrC;QACD,GAAG,KAAK;KACT,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Polpo tool → AI SDK tool mapping for the chat completions endpoint,
+ * plus tool-call side effects shared by the chat loop and the loop
+ * runtimes: file:changed events, vault credential redaction, and
+ * provider-executed tool-call bookkeeping.
+ */
+/** A tool call event surfaced by the loop runtimes (SSE + persistence). */
+export type LoopRuntimeToolCall = {
+    id: string;
+    name: string;
+    arguments?: Record<string, unknown>;
+    result?: string;
+    state: "preparing" | "calling" | "completed" | "error" | "interrupted";
+};
+/** Emit file:changed if a file-writing tool succeeded */
+export declare function emitFileChanged(toolName: string, args: Record<string, unknown>, result: string, emit: (event: string, data: any) => void): void;
+/**
+ * Redact sensitive credential values from vault tool call arguments before persistence.
+ * Returns a sanitized copy — original is NOT mutated.
+ */
+export declare function redactVaultToolCalls(toolCalls: any[]): any[];
+export declare function indexToolResultsByCallId(toolResults: any[] | undefined): Map<string, any>;
+export declare function providerToolCallEvent(call: any, toolResults: Map<string, any>): LoopRuntimeToolCall & {
+    providerExecuted: true;
+};
+export declare function recordProviderToolCall(toolCallsAccum: any[], call: any, toolResults: Map<string, any>): void;
+/**
+ * Convert Polpo tools to AI SDK tool format (without execute functions).
+ *
+ * AI SDK tools: Record<string, { description, inputSchema }>
+ * Tools without execute are "manual" — tool calls are returned but not auto-executed.
+ */
+export declare function toAITools(tools: any[]): Record<string, {
+    description?: string;
+    inputSchema: any;
+}>;
+export declare function toAIToolChoice(choice: unknown): unknown | undefined;
+export declare const CLIENT_SIDE_TOOLS: Record<string, {
+    description: string;
+    inputSchema: any;
+}>;
+/** Set of tool names that are client-side (no server execute). */
+export declare const CLIENT_SIDE_TOOL_NAMES: Set<string>;
+//# sourceMappingURL=tool-mapping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-mapping.d.ts","sourceRoot":"","sources":["../../../src/routes/completions/tool-mapping.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,CAAC;CACxE,CAAC;AAQF,yDAAyD;AACzD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,GACvC,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAe5D;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAMzF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,mBAAmB,GAAG;IAAE,gBAAgB,EAAE,IAAI,CAAA;CAAE,CAWhI;AAED,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAE5G;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,GAAG,CAAA;CAAE,CAAC,CAQlG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAWnE;AAQD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,GAAG,CAAA;CAAE,CA+CvF,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,aAA0C,CAAC"}