@polpo-ai/server 0.15.76 → 0.15.77

package/dist/routes/completions.js

@@ -29,10 +29,12 @@
  * - chat-handler.ts       — streaming/non-streaming multi-turn chat loop
  */
 import { OpenAPIHono } from "@hono/zod-openapi";
+import { streamSSE } from "hono/streaming";
 import { chatCompletionsRoute } from "./completions/schemas.js";
-import { handleProjectLoopCompletion } from "./completions/project-loop-runner.js";
-import { runNonStreamingChatCompletion, streamChatCompletion, } from "./completions/chat-handler.js";
-import { streamChatViaRun, runNonStreamingChatViaRun } from "./completions/chat-via-run-handler.js";
+import { executeStreamingProjectLoopCompletion, handleProjectLoopCompletion, } from "./completions/project-loop-runner.js";
+import { executeStreamingChatCompletion, runNonStreamingChatCompletion, streamChatCompletion, } from "./completions/chat-handler.js";
+import { startDurableCompletion, streamDurableCompletionFrames, } from "./completions/durable-stream.js";
+import { executeStreamingChatViaRun, streamChatViaRun, runNonStreamingChatViaRun, } from "./completions/chat-via-run-handler.js";
 import { prepareChatCompletionExecution } from "./completions/conversation-turn.js";
 export { resumeProjectLoopRun } from "./completions/project-loop-runner.js";
 export { buildChatRunInjection, runChatTurnViaRun, } from "./completions/chat-via-run-handler.js";
@@ -51,6 +53,15 @@ export function completionRoutes(getDeps, apiKeys) {
         }
         // ── Parse body ──
         const body = c.req.valid("json");
+        if (durableDeliveryRequested(body) && !body.stream) {
+            return c.json({
+                error: {
+                    message: "polpo.delivery.onDisconnect=continue requires stream=true.",
+                    type: "invalid_request_error",
+                    code: "durable_delivery_requires_streaming",
+                },
+            }, 400);
+        }
         const rawSessionHeader = c.req.header("x-session-id") ?? null;
         const prepared = await prepareChatCompletionExecution(deps, body, {
             sessionId: rawSessionHeader === "new" ? null : rawSessionHeader,
@@ -68,7 +79,7 @@ export function completionRoutes(getDeps, apiKeys) {
             c.header("x-session-id", sessionId);
         }
         if (prepared.kind === "project-loop") {
-            return await handleProjectLoopCompletion(c, {
+            const loopOptions = {
                 deps: prepared.deps,
                 body: prepared.body,
                 completionId: prepared.completionId,
@@ -84,17 +95,50 @@ export function completionRoutes(getDeps, apiKeys) {
                 runtimePlan: prepared.runtimePlan,
                 executionRoute: prepared.executionRoute,
                 activatedSkills: prepared.activatedSkills,
-            });
+            };
+            if (body.stream && durableDeliveryRequested(body)) {
+                const scope = await resolveRunDeliveryScope(deps, {
+                    runId: prepared.completionId,
+                    sessionId: prepared.sessionId,
+                    agent: body.agent,
+                });
+                if ("response" in scope)
+                    return scope.response(c);
+                c.header("x-polpo-run-id", prepared.completionId);
+                return streamDurableCompletion(c, prepared.completionId, scope.value, ({ writer, signal }) => executeStreamingProjectLoopCompletion(writer, loopOptions, signal));
+            }
+            return await handleProjectLoopCompletion(c, loopOptions);
         }
         const { execution, viaRun } = prepared;
         if (viaRun) {
             c.header("x-polpo-run-id", execution.completionId);
+            if (body.stream && durableDeliveryRequested(body)) {
+                const scope = await resolveRunDeliveryScope(deps, {
+                    runId: execution.completionId,
+                    sessionId: execution.sessionId,
+                    agent: body.agent,
+                });
+                if ("response" in scope)
+                    return scope.response(c);
+                return streamDurableCompletion(c, execution.completionId, scope.value, ({ writer, signal }) => executeStreamingChatViaRun(writer, execution, signal));
+            }
             return (body.stream
                 ? await streamChatViaRun(c, execution)
                 : await runNonStreamingChatViaRun(c, execution));
         }
         if (body.stream) {
             // ── Streaming mode ──
+            if (durableDeliveryRequested(body)) {
+                const scope = await resolveRunDeliveryScope(deps, {
+                    runId: execution.completionId,
+                    sessionId: execution.sessionId,
+                    agent: body.agent,
+                });
+                if ("response" in scope)
+                    return scope.response(c);
+                c.header("x-polpo-run-id", execution.completionId);
+                return streamDurableCompletion(c, execution.completionId, scope.value, ({ writer, signal }) => executeStreamingChatCompletion(writer, execution, signal));
+            }
             return streamChatCompletion(c, execution);
         }
         // ── Non-streaming mode ──
@@ -102,4 +146,62 @@ export function completionRoutes(getDeps, apiKeys) {
     });
     return app;
 }
+function streamDurableCompletion(c, runId, scope, producer) {
+    return streamSSE(c, async (stream) => {
+        const follower = new AbortController();
+        stream.onAbort(() => follower.abort());
+        const heartbeat = setInterval(() => {
+            if (follower.signal.aborted)
+                return;
+            stream.write(": ping\n\n").catch(() => follower.abort());
+        }, 20_000);
+        const owner = startDurableCompletion({
+            runId,
+            scope,
+            producer,
+        });
+        owner.catch(() => { });
+        try {
+            await streamDurableCompletionFrames({
+                runId,
+                scope,
+                signal: follower.signal,
+                write: async (frame) => {
+                    await stream.writeSSE({
+                        data: frame.data,
+                        id: frame.cursor,
+                        ...(frame.event ? { event: frame.event } : {}),
+                    });
+                },
+            });
+        }
+        finally {
+            clearInterval(heartbeat);
+        }
+    });
+}
+function durableDeliveryRequested(body) {
+    return body.polpo?.delivery?.onDisconnect === "continue";
+}
+async function resolveRunDeliveryScope(deps, input) {
+    if (!deps.createRunDeliveryScope) {
+        return {
+            response: (c) => c.json({
+                error: {
+                    message: "Durable run delivery is not configured by this host.",
+                    type: "invalid_request_error",
+                    code: "run_delivery_unavailable",
+                },
+            }, 501),
+        };
+    }
+    return {
+        value: await deps.createRunDeliveryScope({
+            runId: input.runId,
+            ...(input.sessionId ? { sessionId: input.sessionId } : {}),
+            ...(input.agent ? { agent: input.agent } : {}),
+            onDisconnect: "continue",
+        }),
+    };
+}
 //# sourceMappingURL=completions.js.map

package/dist/routes/completions.js.map

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

package/dist/routes/run-delivery.d.ts

@@ -0,0 +1,15 @@
+import { OpenAPIHono } from "@hono/zod-openapi";
+import { type RunCancellationStore, type RunEventStore } from "@polpo-ai/core/run-delivery";
+import { type RunEventNotifier } from "@polpo-ai/core/run-delivery-follower";
+export interface ResolvedRunDelivery {
+    eventStore: RunEventStore;
+    cancellationStore: RunCancellationStore;
+    notifier?: RunEventNotifier;
+}
+export interface RunDeliveryRouteDeps {
+    /** Host-authorized resolver. Return null for missing or inaccessible runs. */
+    resolveRunDelivery?: (runId: string) => Promise<ResolvedRunDelivery | null>;
+    now?: () => Date;
+}
+export declare function runDeliveryRoutes(getDeps: () => RunDeliveryRouteDeps, apiKeys?: string[]): OpenAPIHono;
+//# sourceMappingURL=run-delivery.d.ts.map

package/dist/routes/run-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-delivery.d.ts","sourceRoot":"","sources":["../../src/routes/run-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,sCAAsC,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,aAAa,CAAC;IAC1B,iBAAiB,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAC5E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AA0DD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,oBAAoB,EACnC,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,WAAW,CAwHb"}

package/dist/routes/run-delivery.js

@@ -0,0 +1,202 @@
+import { OpenAPIHono, createRoute, z } from "@hono/zod-openapi";
+import { streamSSE } from "hono/streaming";
+import { RunDeliveryValidationError, RunEventCursorAheadError, RunEventCursorExpiredError, parseRunEventCursor, } from "@polpo-ai/core/run-delivery";
+import { followRunEvents, inspectRunEventCursor, isTerminalRunStreamEvent, } from "@polpo-ai/core/run-delivery-follower";
+const paramsSchema = z.object({ runId: z.string().min(1).max(200) });
+const errorSchema = z.object({ ok: z.literal(false), error: z.string(), code: z.string() });
+const eventsRoute = createRoute({
+    method: "get",
+    path: "/{runId}/events",
+    tags: ["Runs"],
+    summary: "Resume a durable run event stream",
+    request: {
+        params: paramsSchema,
+        query: z.object({
+            cursor: z.string().optional(),
+        }),
+    },
+    responses: {
+        200: {
+            content: { "text/event-stream": { schema: z.string() } },
+            description: "Versioned run events, replayed after the supplied cursor and followed live",
+        },
+        400: { content: { "application/json": { schema: errorSchema } }, description: "Invalid or conflicting cursor" },
+        410: { content: { "application/json": { schema: errorSchema } }, description: "Cursor history expired" },
+        404: { content: { "application/json": { schema: errorSchema } }, description: "Run not found" },
+        501: { content: { "application/json": { schema: errorSchema } }, description: "Durable run delivery unavailable" },
+    },
+});
+const cancelBodySchema = z.object({
+    reason: z.string().trim().min(1).max(500).optional(),
+}).strict();
+const cancelRoute = createRoute({
+    method: "post",
+    path: "/{runId}/cancel",
+    tags: ["Runs"],
+    summary: "Cancel a durable run",
+    request: {
+        params: paramsSchema,
+        body: { content: { "application/json": { schema: cancelBodySchema } } },
+    },
+    responses: {
+        202: {
+            content: {
+                "application/json": {
+                    schema: z.object({
+                        ok: z.literal(true),
+                        data: z.object({ runId: z.string(), accepted: z.boolean() }),
+                    }),
+                },
+            },
+            description: "Cancellation accepted or already pending",
+        },
+        404: { content: { "application/json": { schema: errorSchema } }, description: "Run not found" },
+        501: { content: { "application/json": { schema: errorSchema } }, description: "Durable run delivery unavailable" },
+    },
+});
+export function runDeliveryRoutes(getDeps, apiKeys) {
+    const app = new OpenAPIHono();
+    if (apiKeys && apiKeys.length > 0) {
+        app.use("*", async (c, next) => {
+            const auth = c.req.header("Authorization");
+            const token = auth?.startsWith("Bearer ") ? auth.slice(7) : null;
+            if (!token || !apiKeys.includes(token)) {
+                return c.json({
+                    ok: false,
+                    error: "Invalid API key",
+                    code: "invalid_api_key",
+                }, 401);
+            }
+            await next();
+        });
+    }
+    app.openapi(eventsRoute, async (c) => {
+        const deps = getDeps();
+        if (!deps.resolveRunDelivery)
+            return unavailable(c);
+        const runId = c.req.valid("param").runId;
+        const resolved = await deps.resolveRunDelivery(runId);
+        if (!resolved)
+            return notFound(c);
+        const queryCursor = c.req.valid("query").cursor;
+        const headerCursor = c.req.header("Last-Event-ID");
+        if (queryCursor !== undefined && headerCursor !== undefined && queryCursor !== headerCursor) {
+            return c.json({
+                ok: false,
+                error: "cursor and Last-Event-ID must match when both are supplied",
+                code: "RUN_CURSOR_CONFLICT",
+            }, 400);
+        }
+        const cursor = queryCursor ?? headerCursor;
+        c.header("Cache-Control", "no-cache, no-transform");
+        c.header("X-Accel-Buffering", "no");
+        try {
+            parseRunEventCursor(cursor);
+            const availability = await inspectRunEventCursor(resolved.eventStore, runId, cursor);
+            if (availability === "terminal")
+                c.header("x-polpo-run-terminal", "true");
+        }
+        catch (error) {
+            if (error instanceof RunEventCursorExpiredError) {
+                return c.json({
+                    ok: false,
+                    error: error.message,
+                    code: "RUN_CURSOR_EXPIRED",
+                }, 410);
+            }
+            if (error instanceof RunEventCursorAheadError) {
+                return c.json({
+                    ok: false,
+                    error: error.message,
+                    code: "RUN_CURSOR_AHEAD",
+                }, 400);
+            }
+            if (error instanceof RunDeliveryValidationError) {
+                return c.json({
+                    ok: false,
+                    error: error.message,
+                    code: "INVALID_RUN_CURSOR",
+                }, 400);
+            }
+            throw error;
+        }
+        return streamSSE(c, async (stream) => {
+            const followerController = new AbortController();
+            stream.onAbort(() => followerController.abort());
+            const heartbeat = setInterval(() => {
+                if (followerController.signal.aborted)
+                    return;
+                stream.write(": ping\n\n").catch(() => followerController.abort());
+            }, 20_000);
+            try {
+                for await (const event of followRunEvents({
+                    runId,
+                    store: resolved.eventStore,
+                    notifier: resolved.notifier,
+                    cursor,
+                    signal: followerController.signal,
+                })) {
+                    await stream.writeSSE({
+                        id: String(event.sequence),
+                        event: "run.event",
+                        data: JSON.stringify(event),
+                    });
+                }
+            }
+            finally {
+                clearInterval(heartbeat);
+            }
+        });
+    });
+    app.openapi(cancelRoute, async (c) => {
+        const deps = getDeps();
+        if (!deps.resolveRunDelivery)
+            return unavailable(c);
+        const runId = c.req.valid("param").runId;
+        const resolved = await deps.resolveRunDelivery(runId);
+        if (!resolved)
+            return notFound(c);
+        const body = c.req.valid("json");
+        if (await hasTerminalRunEvent(resolved.eventStore, runId)) {
+            await resolved.cancellationStore.clear(runId);
+            return c.json({ ok: true, data: { runId, accepted: false } }, 202);
+        }
+        const existing = await resolved.cancellationStore.get(runId);
+        const now = deps.now?.() ?? new Date();
+        if (!(now instanceof Date) || !Number.isFinite(now.getTime())) {
+            throw new RunDeliveryValidationError("Run delivery clock returned an invalid date");
+        }
+        await resolved.cancellationStore.request(runId, {
+            requestedAt: now.toISOString(),
+            ...(body.reason ? { reason: body.reason } : {}),
+        });
+        if (await hasTerminalRunEvent(resolved.eventStore, runId)) {
+            await resolved.cancellationStore.clear(runId);
+            return c.json({ ok: true, data: { runId, accepted: false } }, 202);
+        }
+        return c.json({ ok: true, data: { runId, accepted: existing === null } }, 202);
+    });
+    return app;
+}
+async function hasTerminalRunEvent(eventStore, runId) {
+    const bounds = await eventStore.bounds(runId);
+    if (!bounds)
+        return false;
+    const lastSequence = Number(bounds.lastCursor);
+    if (!Number.isSafeInteger(lastSequence) || lastSequence < 1)
+        return false;
+    const page = await eventStore.listAfter(runId, String(lastSequence - 1), 1);
+    const lastEvent = page.events[0];
+    return lastEvent ? isTerminalRunStreamEvent(lastEvent) : false;
+}
+function unavailable(c) {
+    return c.json({
+        ok: false,
+        error: "Durable run delivery is not configured",
+        code: "RUN_DELIVERY_UNAVAILABLE",
+    }, 501);
+}
+function notFound(c) {
+    return c.json({ ok: false, error: "Run not found", code: "RUN_NOT_FOUND" }, 404);
+}
+//# sourceMappingURL=run-delivery.js.map

package/dist/routes/run-delivery.js.map

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

package/dist/routes/run-delivery.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-delivery.test.d.ts.map

package/dist/routes/run-delivery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-delivery.test.d.ts","sourceRoot":"","sources":["../../src/routes/run-delivery.test.ts"],"names":[],"mappings":""}

package/dist/routes/run-delivery.test.js

@@ -0,0 +1,124 @@
+import { describe, expect, it } from "vitest";
+import { InMemoryRunCancellationStore, InMemoryRunEventStore, } from "@polpo-ai/core/run-delivery";
+import { InMemoryRunEventNotifier, RunEventJournal, } from "@polpo-ai/core/run-delivery-follower";
+import { runDeliveryRoutes } from "./run-delivery.js";
+function cancelRequest(runId, body = {}) {
+    return new Request(`http://localhost/${runId}/cancel`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body),
+    });
+}
+describe("runDeliveryRoutes", () => {
+    it("requires the configured bearer API key", async () => {
+        const app = runDeliveryRoutes(() => ({ resolveRunDelivery: async () => null }), ["secret"]);
+        const denied = await app.request("/run-a/events");
+        expect(denied.status).toBe(401);
+        const allowed = await app.request("/run-a/events", {
+            headers: { Authorization: "Bearer secret" },
+        });
+        expect(allowed.status).toBe(404);
+    });
+    it("returns 501 when the host has no durable run resolver", async () => {
+        const response = await runDeliveryRoutes(() => ({})).request("http://localhost/run-a/events");
+        expect(response.status).toBe(501);
+        expect(await response.json()).toMatchObject({ code: "RUN_DELIVERY_UNAVAILABLE" });
+    });
+    it("returns 404 without leaking an inaccessible run", async () => {
+        const app = runDeliveryRoutes(() => ({ resolveRunDelivery: async () => null }));
+        const events = await app.request("http://localhost/private/events");
+        const cancel = await app.request(cancelRequest("private"));
+        expect(events.status).toBe(404);
+        expect(cancel.status).toBe(404);
+    });
+    it("replays canonical events after a query cursor and ends at terminal", async () => {
+        const eventStore = new InMemoryRunEventStore();
+        const cancellationStore = new InMemoryRunCancellationStore();
+        const notifier = new InMemoryRunEventNotifier();
+        const journal = new RunEventJournal(eventStore, notifier);
+        await journal.append("run-a", { type: "run.started", data: {} });
+        await journal.append("run-a", {
+            type: "output.text.delta",
+            data: { text: "hello" },
+        });
+        await journal.append("run-a", { type: "run.completed", data: {} });
+        const app = runDeliveryRoutes(() => ({
+            resolveRunDelivery: async (runId) => runId === "run-a"
+                ? { eventStore, cancellationStore, notifier }
+                : null,
+        }));
+        const response = await app.request("http://localhost/run-a/events?cursor=1");
+        const body = await response.text();
+        expect(response.status).toBe(200);
+        expect(response.headers.get("content-type")).toContain("text/event-stream");
+        expect(body).not.toContain('"sequence":1');
+        expect(body).toContain('"sequence":2');
+        expect(body).toContain('"sequence":3');
+        expect(body).toContain("id: 2");
+        expect(body).toContain("id: 3");
+    });
+    it("accepts Last-Event-ID and rejects a conflicting query cursor", async () => {
+        const eventStore = new InMemoryRunEventStore();
+        const cancellationStore = new InMemoryRunCancellationStore();
+        await eventStore.append("run-a", { type: "run.completed", data: {} });
+        const app = runDeliveryRoutes(() => ({
+            resolveRunDelivery: async () => ({ eventStore, cancellationStore }),
+        }));
+        const resumed = await app.request(new Request("http://localhost/run-a/events", {
+            headers: { "last-event-id": "0" },
+        }));
+        expect(resumed.status).toBe(200);
+        expect(await resumed.text()).toContain('"sequence":1');
+        const conflict = await app.request(new Request("http://localhost/run-a/events?cursor=1", {
+            headers: { "last-event-id": "2" },
+        }));
+        expect(conflict.status).toBe(400);
+        expect(await conflict.json()).toMatchObject({ code: "RUN_CURSOR_CONFLICT" });
+    });
+    it("closes an already-acknowledged terminal stream and rejects ahead cursors", async () => {
+        const eventStore = new InMemoryRunEventStore();
+        const cancellationStore = new InMemoryRunCancellationStore();
+        await eventStore.append("run-a", { type: "run.completed", data: {} });
+        const app = runDeliveryRoutes(() => ({
+            resolveRunDelivery: async () => ({ eventStore, cancellationStore }),
+        }));
+        const terminal = await app.request("http://localhost/run-a/events?cursor=1");
+        expect(terminal.status).toBe(200);
+        expect(terminal.headers.get("x-polpo-run-terminal")).toBe("true");
+        expect(await terminal.text()).toBe("");
+        const ahead = await app.request("http://localhost/run-a/events?cursor=2");
+        expect(ahead.status).toBe(400);
+        expect(await ahead.json()).toMatchObject({ code: "RUN_CURSOR_AHEAD" });
+    });
+    it("persists explicit cancellation idempotently", async () => {
+        const eventStore = new InMemoryRunEventStore();
+        const cancellationStore = new InMemoryRunCancellationStore();
+        const app = runDeliveryRoutes(() => ({
+            resolveRunDelivery: async () => ({ eventStore, cancellationStore }),
+        }));
+        const first = await app.request(cancelRequest("run-a", { reason: "user_request" }));
+        const duplicate = await app.request(cancelRequest("run-a", { reason: "duplicate" }));
+        expect(first.status).toBe(202);
+        expect(duplicate.status).toBe(202);
+        const persisted = await cancellationStore.get("run-a");
+        expect(persisted?.reason).toBe("user_request");
+        expect(await first.json()).toMatchObject({ ok: true, data: { runId: "run-a", accepted: true } });
+        expect(await duplicate.json()).toMatchObject({ ok: true, data: { runId: "run-a", accepted: false } });
+    });
+    it("does not persist cancellation for an already terminal run", async () => {
+        const eventStore = new InMemoryRunEventStore();
+        const cancellationStore = new InMemoryRunCancellationStore();
+        await eventStore.append("run-a", { type: "run.completed", data: {} });
+        const app = runDeliveryRoutes(() => ({
+            resolveRunDelivery: async () => ({ eventStore, cancellationStore }),
+        }));
+        const response = await app.request(cancelRequest("run-a", { reason: "too late" }));
+        expect(response.status).toBe(202);
+        expect(await response.json()).toMatchObject({
+            ok: true,
+            data: { runId: "run-a", accepted: false },
+        });
+        expect(await cancellationStore.get("run-a")).toBeNull();
+    });
+});
+//# sourceMappingURL=run-delivery.test.js.map

package/dist/routes/run-delivery.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polpo-ai/server",
-  "version": "0.15.76",
+  "version": "0.15.77",
   "description": "Polpo API route factories — edge-compatible Hono routes for tasks, agents, missions, vault, and more",
   "type": "module",
   "main": "dist/index.js",
@@ -20,12 +20,12 @@
     "hono": ">=4.0.0",
     "nanoid": ">=5.0.0",
     "typescript": "^5.7.3",
-    "@polpo-ai/connect": "0.15.76",
-    "@polpo-ai/channels": "0.15.76",
-    "@polpo-ai/core": "0.15.76",
-    "@polpo-ai/llm": "0.15.76",
-    "@polpo-ai/connect-server": "0.15.76",
-    "@polpo-ai/tools": "0.15.76"
+    "@polpo-ai/channels": "0.15.77",
+    "@polpo-ai/connect": "0.15.77",
+    "@polpo-ai/connect-server": "0.15.77",
+    "@polpo-ai/core": "0.15.77",
+    "@polpo-ai/llm": "0.15.77",
+    "@polpo-ai/tools": "0.15.77"
   },
   "peerDependencies": {
     "ai": ">=6.0.182 <7",