@holon-run/agentinbox 0.7.0 → 1.0.0-beta.1

package/dist/src/http.js

@@ -29,6 +29,14 @@ const errorResponseSchema = {
         error: { type: "string" },
     },
 };
+const subscriptionCollectionSchema = {
+    type: "object",
+    required: ["subscriptions"],
+    additionalProperties: false,
+    properties: {
+        subscriptions: { type: "array", items: jsonObjectSchema },
+    },
+};
 const deliveryHandleSchema = {
     type: "object",
     additionalProperties: false,
@@ -41,6 +49,28 @@ const deliveryHandleSchema = {
         replyMode: { type: "string" },
     },
 };
+const deliveryTargetByHandleSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["deliveryHandle"],
+    properties: {
+        sourceId: { type: "string", minLength: 1 },
+        deliveryHandle: deliveryHandleSchema,
+    },
+};
+const deliveryTargetByFieldsSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["provider", "surface", "targetRef"],
+    properties: {
+        sourceId: { type: "string", minLength: 1 },
+        provider: { type: "string", minLength: 1 },
+        surface: { type: "string", minLength: 1 },
+        targetRef: { type: "string", minLength: 1 },
+        threadRef: { type: "string" },
+        replyMode: { type: "string" },
+    },
+};
 function buildFastifyServer(service) {
     const app = (0, fastify_1.default)({
         logger: false,
@@ -96,6 +126,153 @@ function buildFastifyServer(service) {
             },
         },
     }, async () => service.gc());
+    app.get("/hosts", {
+        schema: {
+            tags: ["sources"],
+            response: {
+                200: {
+                    type: "object",
+                    required: ["hosts"],
+                    properties: {
+                        hosts: { type: "array", items: jsonObjectSchema },
+                    },
+                },
+            },
+        },
+    }, async () => ({ hosts: service.listHosts() }));
+    app.post("/hosts", {
+        schema: {
+            tags: ["sources"],
+            body: {
+                type: "object",
+                additionalProperties: false,
+                required: ["hostType", "hostKey"],
+                properties: {
+                    hostType: { type: "string", minLength: 1 },
+                    hostKey: { type: "string", minLength: 1 },
+                    configRef: { anyOf: [{ type: "string" }, { type: "null" }] },
+                    config: jsonObjectSchema,
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+            },
+        },
+    }, async (request) => service.registerHost(request.body));
+    app.get("/hosts/:hostId", {
+        schema: {
+            tags: ["sources"],
+            params: {
+                type: "object",
+                required: ["hostId"],
+                properties: {
+                    hostId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                404: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.getHostDetails(decodeURIComponent(params.hostId));
+    });
+    app.get("/hosts/:hostId/schema", {
+        schema: {
+            tags: ["sources"],
+            params: {
+                type: "object",
+                required: ["hostId"],
+                properties: {
+                    hostId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                404: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        const host = service.getHost(decodeURIComponent(params.hostId));
+        return service.getHostSchema(host.hostType);
+    });
+    app.get("/streams", {
+        schema: {
+            tags: ["sources"],
+            response: {
+                200: {
+                    type: "object",
+                    required: ["streams"],
+                    properties: {
+                        streams: { type: "array", items: jsonObjectSchema },
+                    },
+                },
+            },
+        },
+    }, async () => ({ streams: service.listStreams() }));
+    app.post("/streams", {
+        schema: {
+            tags: ["sources"],
+            body: {
+                type: "object",
+                additionalProperties: false,
+                required: ["hostId", "streamKind", "streamKey"],
+                properties: {
+                    hostId: { type: "string", minLength: 1 },
+                    streamKind: { type: "string", minLength: 1 },
+                    streamKey: { type: "string", minLength: 1 },
+                    configRef: { anyOf: [{ type: "string" }, { type: "null" }] },
+                    config: jsonObjectSchema,
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+            },
+        },
+    }, async (request) => service.registerStream(request.body));
+    app.get("/streams/:streamId", {
+        schema: {
+            tags: ["sources"],
+            params: {
+                type: "object",
+                required: ["streamId"],
+                properties: {
+                    streamId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                404: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.getStreamDetails(decodeURIComponent(params.streamId));
+    });
+    app.get("/streams/:streamId/schema", {
+        schema: {
+            tags: ["sources"],
+            params: {
+                type: "object",
+                required: ["streamId"],
+                properties: {
+                    streamId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+                404: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.getResolvedSourceSchema(decodeURIComponent(params.streamId));
+    });
     app.get("/sources", {
         schema: {
             tags: ["sources"],
@@ -116,10 +293,11 @@ function buildFastifyServer(service) {
             body: {
                 type: "object",
                 additionalProperties: false,
-                required: ["sourceType", "sourceKey"],
+                required: ["hostId", "streamKind", "streamKey"],
                 properties: {
-                    sourceType: { type: "string", minLength: 1 },
-                    sourceKey: { type: "string", minLength: 1 },
+                    hostId: { type: "string", minLength: 1 },
+                    streamKind: { type: "string", minLength: 1 },
+                    streamKey: { type: "string", minLength: 1 },
                     configRef: { anyOf: [{ type: "string" }, { type: "null" }] },
                     config: jsonObjectSchema,
                 },
@@ -129,7 +307,7 @@ function buildFastifyServer(service) {
                 400: errorResponseSchema,
             },
         },
-    }, async (request) => service.registerSource(request.body));
+    }, async (request) => service.registerStream(request.body));
     app.get("/sources/:sourceId", {
         schema: {
             tags: ["sources"],
@@ -169,14 +347,42 @@ function buildFastifyServer(service) {
         const params = request.params;
         return service.getResolvedSourceSchema(decodeURIComponent(params.sourceId));
     });
-    app.delete("/sources/:sourceId", {
+    app.patch("/streams/:streamId", {
         schema: {
             tags: ["sources"],
             params: {
                 type: "object",
-                required: ["sourceId"],
+                required: ["streamId"],
                 properties: {
-                    sourceId: { type: "string", minLength: 1 },
+                    streamId: { type: "string", minLength: 1 },
+                },
+            },
+            body: {
+                type: "object",
+                additionalProperties: false,
+                minProperties: 1,
+                properties: {
+                    configRef: { anyOf: [{ type: "string" }, { type: "null" }] },
+                    config: jsonObjectSchema,
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.updateSource(decodeURIComponent(params.streamId), request.body);
+    });
+    app.delete("/streams/:streamId", {
+        schema: {
+            tags: ["sources"],
+            params: {
+                type: "object",
+                required: ["streamId"],
+                properties: {
+                    streamId: { type: "string", minLength: 1 },
                 },
             },
             querystring: {
@@ -199,25 +405,55 @@ function buildFastifyServer(service) {
     }, async (request) => {
         const params = request.params;
         const query = request.query;
-        return service.removeSource(decodeURIComponent(params.sourceId), {
+        return service.removeSource(decodeURIComponent(params.streamId), {
             withSubscriptions: query.with_subscriptions === true || query.with_subscriptions === "true" || query.with_subscriptions === "1",
         });
     });
-    app.patch("/sources/:sourceId", {
+    app.post("/streams/:streamId/pause", {
         schema: {
             tags: ["sources"],
             params: {
                 type: "object",
-                required: ["sourceId"],
+                required: ["streamId"],
                 properties: {
-                    sourceId: { type: "string", minLength: 1 },
+                    streamId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.pauseSource(decodeURIComponent(params.streamId));
+    });
+    app.post("/streams/:streamId/resume", {
+        schema: {
+            tags: ["sources"],
+            params: {
+                type: "object",
+                required: ["streamId"],
+                properties: {
+                    streamId: { type: "string", minLength: 1 },
                 },
             },
+            response: {
+                200: jsonObjectSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.resumeSource(decodeURIComponent(params.streamId));
+    });
+    app.post("/streams/schema-preview", {
+        schema: {
+            tags: ["sources"],
             body: {
                 type: "object",
                 additionalProperties: false,
-                minProperties: 1,
+                required: ["sourceRef"],
                 properties: {
+                    sourceRef: { type: "string", minLength: 1 },
                     configRef: { anyOf: [{ type: "string" }, { type: "null" }] },
                     config: jsonObjectSchema,
                 },
@@ -227,11 +463,64 @@ function buildFastifyServer(service) {
                 400: errorResponseSchema,
             },
         },
+    }, async (request) => service.previewSourceSchema(request.body));
+    app.post("/streams/:streamId/poll", {
+        schema: {
+            tags: ["sources"],
+            params: {
+                type: "object",
+                required: ["streamId"],
+                properties: {
+                    streamId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+            },
+        },
     }, async (request) => {
         const params = request.params;
-        return service.updateSource(decodeURIComponent(params.sourceId), request.body);
+        return service.pollSource(decodeURIComponent(params.streamId));
     });
-    app.post("/sources/:sourceId/pause", {
+    app.post("/streams/:streamId/events", {
+        schema: {
+            tags: ["sources"],
+            params: {
+                type: "object",
+                required: ["streamId"],
+                properties: {
+                    streamId: { type: "string", minLength: 1 },
+                },
+            },
+            body: {
+                type: "object",
+                additionalProperties: false,
+                required: ["sourceNativeId", "eventVariant"],
+                properties: {
+                    sourceNativeId: { type: "string", minLength: 1 },
+                    eventVariant: { type: "string", minLength: 1 },
+                    occurredAt: { type: "string", minLength: 1 },
+                    metadata: jsonObjectSchema,
+                    rawPayload: jsonObjectSchema,
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        const body = request.body;
+        return service.appendSourceEvent({
+            sourceId: decodeURIComponent(params.streamId),
+            sourceNativeId: body.sourceNativeId,
+            eventVariant: body.eventVariant,
+            occurredAt: body.occurredAt,
+            metadata: body.metadata ?? {},
+            rawPayload: body.rawPayload ?? {},
+        });
+    });
+    app.delete("/sources/:sourceId", {
         schema: {
             tags: ["sources"],
             params: {
@@ -241,15 +530,31 @@ function buildFastifyServer(service) {
                     sourceId: { type: "string", minLength: 1 },
                 },
             },
+            querystring: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    with_subscriptions: {
+                        anyOf: [
+                            { type: "boolean" },
+                            { type: "string", enum: ["true", "false", "1", "0"] },
+                        ],
+                    },
+                },
+            },
             response: {
                 200: jsonObjectSchema,
+                400: errorResponseSchema,
             },
         },
     }, async (request) => {
         const params = request.params;
-        return service.pauseSource(decodeURIComponent(params.sourceId));
+        const query = request.query;
+        return service.removeSource(decodeURIComponent(params.sourceId), {
+            withSubscriptions: query.with_subscriptions === true || query.with_subscriptions === "true" || query.with_subscriptions === "1",
+        });
     });
-    app.post("/sources/:sourceId/resume", {
+    app.patch("/sources/:sourceId", {
         schema: {
             tags: ["sources"],
             params: {
@@ -259,22 +564,32 @@ function buildFastifyServer(service) {
                     sourceId: { type: "string", minLength: 1 },
                 },
             },
+            body: {
+                type: "object",
+                additionalProperties: false,
+                minProperties: 1,
+                properties: {
+                    configRef: { anyOf: [{ type: "string" }, { type: "null" }] },
+                    config: jsonObjectSchema,
+                },
+            },
             response: {
                 200: jsonObjectSchema,
+                400: errorResponseSchema,
             },
         },
     }, async (request) => {
         const params = request.params;
-        return service.resumeSource(decodeURIComponent(params.sourceId));
+        return service.updateSource(decodeURIComponent(params.sourceId), request.body);
     });
-    app.get("/source-types/:sourceType/schema", {
+    app.post("/sources/:sourceId/pause", {
         schema: {
             tags: ["sources"],
             params: {
                 type: "object",
-                required: ["sourceType"],
+                required: ["sourceId"],
                 properties: {
-                    sourceType: { type: "string", minLength: 1 },
+                    sourceId: { type: "string", minLength: 1 },
                 },
             },
             response: {
@@ -283,27 +598,26 @@ function buildFastifyServer(service) {
         },
     }, async (request) => {
         const params = request.params;
-        return service.getSourceSchema(decodeURIComponent(params.sourceType));
+        return service.pauseSource(decodeURIComponent(params.sourceId));
     });
-    app.post("/sources/schema-preview", {
+    app.post("/sources/:sourceId/resume", {
         schema: {
             tags: ["sources"],
-            body: {
+            params: {
                 type: "object",
-                additionalProperties: false,
-                required: ["sourceRef"],
+                required: ["sourceId"],
                 properties: {
-                    sourceRef: { type: "string", minLength: 1 },
-                    configRef: { anyOf: [{ type: "string" }, { type: "null" }] },
-                    config: jsonObjectSchema,
+                    sourceId: { type: "string", minLength: 1 },
                 },
             },
             response: {
                 200: jsonObjectSchema,
-                400: errorResponseSchema,
             },
         },
-    }, async (request) => service.previewSourceSchema(request.body));
+    }, async (request) => {
+        const params = request.params;
+        return service.resumeSource(decodeURIComponent(params.sourceId));
+    });
     app.post("/sources/:sourceId/poll", {
         schema: {
             tags: ["sources"],
@@ -425,6 +739,7 @@ function buildFastifyServer(service) {
                     termProgram: { type: "string" },
                     itermSessionId: { type: "string" },
                     notifyLeaseMs: { type: "integer", minimum: 1 },
+                    minUnackedItems: { type: "integer", minimum: 1 },
                 },
             },
             response: {
@@ -447,6 +762,7 @@ function buildFastifyServer(service) {
             termProgram: optionalString(body.termProgram),
             itermSessionId: optionalString(body.itermSessionId),
             notifyLeaseMs: typeof body.notifyLeaseMs === "number" ? body.notifyLeaseMs : null,
+            minUnackedItems: typeof body.minUnackedItems === "number" ? body.minUnackedItems : null,
         });
     });
     app.get("/agents/:agentId", {
@@ -548,6 +864,7 @@ function buildFastifyServer(service) {
                     url: { type: "string", minLength: 1 },
                     activationMode: { type: "string" },
                     notifyLeaseMs: { type: "integer", minimum: 1 },
+                    minUnackedItems: { type: "integer", minimum: 1 },
                 },
             },
             response: {
@@ -562,6 +879,7 @@ function buildFastifyServer(service) {
             url: body.url,
             activationMode: body.activationMode,
             notifyLeaseMs: body.notifyLeaseMs ?? null,
+            minUnackedItems: body.minUnackedItems ?? null,
         });
     });
     app.delete("/agents/:agentId/targets/:targetId", {
@@ -731,13 +1049,7 @@ function buildFastifyServer(service) {
                 },
             },
             response: {
-                200: {
-                    type: "object",
-                    required: ["subscriptions"],
-                    properties: {
-                        subscriptions: { type: "array", items: jsonObjectSchema },
-                    },
-                },
+                200: subscriptionCollectionSchema,
             },
         },
     }, async (request) => {
@@ -777,13 +1089,13 @@ function buildFastifyServer(service) {
                 },
             },
             response: {
-                200: jsonObjectSchema,
+                200: subscriptionCollectionSchema,
                 400: errorResponseSchema,
             },
         },
     }, async (request) => {
         const body = request.body;
-        return service.registerSubscription({
+        const input = {
             agentId: String(body.agentId),
             sourceId: String(body.sourceId),
             shortcut: body.shortcut && typeof body.shortcut === "object"
@@ -800,7 +1112,8 @@ function buildFastifyServer(service) {
             startPolicy: optionalString(body.startPolicy),
             startOffset: typeof body.startOffset === "number" ? body.startOffset : undefined,
             startTime: optionalString(body.startTime) ?? undefined,
-        });
+        };
+        return { subscriptions: await service.registerSubscriptions(input) };
     });
     app.get("/subscriptions/:subscriptionId", {
         schema: {
@@ -930,7 +1243,7 @@ function buildFastifyServer(service) {
         const params = request.params;
         return service.getInboxDetailsByAgent(decodeURIComponent(params.agentId));
     });
-    app.get("/agents/:agentId/inbox/items", {
+    app.get("/agents/:agentId/inbox/entries", {
         schema: {
             tags: ["inbox"],
             params: {
@@ -944,16 +1257,16 @@ function buildFastifyServer(service) {
                 type: "object",
                 additionalProperties: false,
                 properties: {
-                    after_item_id: { type: "string" },
+                    after_entry_id: { type: "string" },
                     include_acked: { type: "string", enum: ["true", "false"] },
                 },
             },
             response: {
                 200: {
                     type: "object",
-                    required: ["items"],
+                    required: ["entries"],
                     properties: {
-                        items: { type: "array", items: jsonObjectSchema },
+                        entries: { type: "array", items: jsonObjectSchema },
                     },
                 },
             },
@@ -962,8 +1275,8 @@ function buildFastifyServer(service) {
         const params = request.params;
         const query = request.query;
         return {
-            items: service.listInboxItems(decodeURIComponent(params.agentId), {
-                afterItemId: query.after_item_id,
+            entries: service.listInboxItems(decodeURIComponent(params.agentId), {
+                afterEntryId: query.after_entry_id,
                 includeAcked: query.include_acked ? query.include_acked === "true" : undefined,
             }),
         };
@@ -1015,7 +1328,7 @@ function buildFastifyServer(service) {
                 type: "object",
                 additionalProperties: false,
                 properties: {
-                    after_item_id: { type: "string" },
+                    after_entry_id: { type: "string" },
                     include_acked: { type: "string", enum: ["true", "false"] },
                     heartbeat_ms: { type: "string", pattern: "^[1-9][0-9]*$" },
                 },
@@ -1029,7 +1342,7 @@ function buildFastifyServer(service) {
         const query = request.query;
         const agentId = decodeURIComponent(params.agentId);
         const watchOptions = {
-            afterItemId: query.after_item_id,
+            afterEntryId: query.after_entry_id,
             includeAcked: query.include_acked ? query.include_acked === "true" : undefined,
             heartbeatMs: query.heartbeat_ms ? Number(query.heartbeat_ms) : undefined,
         };
@@ -1046,7 +1359,7 @@ function buildFastifyServer(service) {
         sendSse(raw, "items", {
             event: "items",
             agentId,
-            items: session.initialItems,
+            entries: session.initialItems,
         });
         session.start();
         const heartbeatMs = watchOptions.heartbeatMs ?? 15_000;
@@ -1098,9 +1411,9 @@ function buildFastifyServer(service) {
                     {
                         type: "object",
                         additionalProperties: false,
-                        required: ["itemIds"],
+                        required: ["entryIds"],
                         properties: {
-                            itemIds: {
+                            entryIds: {
                                 type: "array",
                                 minItems: 1,
                                 items: { type: "string", minLength: 1 },
@@ -1110,9 +1423,9 @@ function buildFastifyServer(service) {
                     {
                         type: "object",
                         additionalProperties: false,
-                        required: ["throughItemId"],
+                        required: ["throughEntryId"],
                         properties: {
-                            throughItemId: { type: "string", minLength: 1 },
+                            throughEntryId: { type: "string", minLength: 1 },
                         },
                     },
                     {
@@ -1134,11 +1447,58 @@ function buildFastifyServer(service) {
         const params = request.params;
         const body = request.body;
         return service.ackInbox(decodeURIComponent(params.agentId), {
-            itemIds: body.itemIds ?? [],
-            throughItemId: body.throughItemId ?? null,
+            entryIds: body.entryIds ?? [],
+            throughEntryId: body.throughEntryId ?? null,
             all: body.all ?? false,
         });
     });
+    app.get("/agents/:agentId/inbox/policy", {
+        schema: {
+            tags: ["inbox"],
+            params: {
+                type: "object",
+                required: ["agentId"],
+                properties: {
+                    agentId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.getInboxAggregationPolicy(decodeURIComponent(params.agentId));
+    });
+    app.post("/agents/:agentId/inbox/policy", {
+        schema: {
+            tags: ["inbox"],
+            params: {
+                type: "object",
+                required: ["agentId"],
+                properties: {
+                    agentId: { type: "string", minLength: 1 },
+                },
+            },
+            body: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    enabled: { type: "boolean" },
+                    windowMs: { type: "integer", minimum: 1 },
+                    maxItems: { type: "integer", minimum: 1 },
+                    maxThreadAgeMs: { type: "integer", minimum: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        const body = request.body;
+        return service.updateInboxAggregationPolicy(decodeURIComponent(params.agentId), body);
+    });
     app.post("/deliveries/send", {
         schema: {
             tags: ["deliveries"],
@@ -1149,6 +1509,7 @@ function buildFastifyServer(service) {
                         additionalProperties: false,
                         required: ["kind", "payload", "deliveryHandle"],
                         properties: {
+                            sourceId: { type: "string", minLength: 1 },
                             kind: { type: "string", minLength: 1 },
                             payload: jsonObjectSchema,
                             deliveryHandle: deliveryHandleSchema,
@@ -1159,6 +1520,7 @@ function buildFastifyServer(service) {
                         additionalProperties: false,
                         required: ["kind", "payload", "provider", "surface", "targetRef"],
                         properties: {
+                            sourceId: { type: "string", minLength: 1 },
                             kind: { type: "string", minLength: 1 },
                             payload: jsonObjectSchema,
                             provider: { type: "string", minLength: 1 },
@@ -1176,6 +1538,57 @@ function buildFastifyServer(service) {
             },
         },
     }, async (request) => service.sendDelivery(request.body));
+    app.post("/deliveries/actions", {
+        schema: {
+            tags: ["deliveries"],
+            body: {
+                oneOf: [deliveryTargetByHandleSchema, deliveryTargetByFieldsSchema],
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+            },
+        },
+    }, async (request) => service.listDeliveryActions(request.body));
+    app.post("/deliveries/invoke", {
+        schema: {
+            tags: ["deliveries"],
+            body: {
+                oneOf: [
+                    {
+                        type: "object",
+                        additionalProperties: false,
+                        required: ["deliveryHandle", "operation", "input"],
+                        properties: {
+                            sourceId: { type: "string", minLength: 1 },
+                            deliveryHandle: deliveryHandleSchema,
+                            operation: { type: "string", minLength: 1 },
+                            input: jsonObjectSchema,
+                        },
+                    },
+                    {
+                        type: "object",
+                        additionalProperties: false,
+                        required: ["provider", "surface", "targetRef", "operation", "input"],
+                        properties: {
+                            sourceId: { type: "string", minLength: 1 },
+                            provider: { type: "string", minLength: 1 },
+                            surface: { type: "string", minLength: 1 },
+                            targetRef: { type: "string", minLength: 1 },
+                            threadRef: { type: "string" },
+                            replyMode: { type: "string" },
+                            operation: { type: "string", minLength: 1 },
+                            input: jsonObjectSchema,
+                        },
+                    },
+                ],
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+            },
+        },
+    }, async (request) => service.invokeDelivery(request.body));
     app.setNotFoundHandler((_request, reply) => {
         void reply.code(404).send({ error: "not found" });
     });
@@ -1256,7 +1669,15 @@ function isBadRequestError(message) {
         message.startsWith("manual append is not supported") ||
         message.startsWith("sources/events requires") ||
         message.startsWith("source remove requires") ||
+        message.startsWith("delivery requires") ||
+        message.startsWith("deliver send is not supported") ||
         message.startsWith("deliveryHandle requires") ||
+        message.startsWith("delivery operations are not supported") ||
+        message.startsWith("unknown GitHub delivery operation") ||
+        message.startsWith("unknown Feishu delivery operation") ||
+        message.startsWith("invalid GitHub targetRef") ||
+        message.includes("requires input.text") ||
+        message.includes("requires input.body") ||
         message.startsWith("subscriptions/reset requires") ||
         message.startsWith("agents requires") ||
         message.startsWith("agents/targets requires") ||
@@ -1277,10 +1698,13 @@ function isBadRequestError(message) {
         message.startsWith("expected integer") ||
         message.startsWith("expected positive integer") ||
         message.startsWith("notifyLeaseMs must be a positive integer") ||
+        message.startsWith("minUnackedItems must be a positive integer") ||
         message.startsWith("invalid webhook activation target") ||
         message.startsWith("remote_source requires") ||
         message.startsWith("remote_source profile") ||
         message.startsWith("remote_source module") ||
+        message.startsWith("reply_in_review_thread requires") ||
+        message.includes("does not match delivery provider") ||
         message.includes("requires tmuxPaneId") ||
         message.includes("requires iTerm2 session identity") ||
         message.includes("requires a supported terminal context") ||