@taskcast/server 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -2,20 +2,44 @@ export { createAuthMiddleware, checkScope } from './auth.js';
 export type { AuthConfig, AuthContext, JWTConfig } from './auth.js';
 export { createTasksRouter } from './routes/tasks.js';
 export { createSSERouter } from './routes/sse.js';
-export { createWorkersRouter, WorkerWSHandler } from './routes/workers.js';
+export { createWorkersRouter, WorkerWSHandler, WorkerWSRegistry } from './routes/workers.js';
 export type { WSLike, TaskSummary } from './routes/workers.js';
 export { WebhookDelivery } from './webhook.js';
-import { Hono } from 'hono';
+export { TaskSchema, TaskEventSchema, WorkerSchema, ErrorSchema, CreateTaskSchema, TransitionSchema, PublishEventSchema, } from './schemas.js';
+import type { Hono } from 'hono';
+import { WorkerWSRegistry } from './routes/worker-ws.js';
 import type { AuthConfig } from './auth.js';
-import type { TaskEngine, WorkerManager } from '@taskcast/core';
+import type { TaskEngine, WorkerManager, ShortTermStore, DisconnectPolicy } from '@taskcast/core';
 export interface TaskcastServerOptions {
     engine: TaskEngine;
     workerManager?: WorkerManager;
+    shortTermStore?: ShortTermStore;
     auth?: AuthConfig;
+    scheduler?: {
+        enabled?: boolean;
+        checkIntervalMs?: number;
+        pausedColdAfterMs?: number;
+        blockedColdAfterMs?: number;
+    };
+    heartbeat?: {
+        enabled?: boolean;
+        checkIntervalMs?: number;
+        heartbeatTimeoutMs?: number;
+        defaultDisconnectPolicy?: DisconnectPolicy;
+        disconnectGraceMs?: number;
+    };
+}
+export interface TaskcastApp {
+    app: Hono;
+    wsRegistry?: WorkerWSRegistry;
+    stop(): void;
 }
 /**
- * Creates a Hono app with all taskcast routes mounted.
+ * Creates an OpenAPIHono app with all taskcast routes mounted.
  * Can be used standalone or mounted into an existing Hono app.
+ *
+ * Returns a TaskcastApp with `app` (the Hono instance) and `stop()` to
+ * clean up scheduler/heartbeat timers.
  */
-export declare function createTaskcastApp(opts: TaskcastServerOptions): Hono;
+export declare function createTaskcastApp(opts: TaskcastServerOptions): TaskcastApp;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1E,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAK3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE/D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,UAAU,CAAA;IAClB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAUnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC5F,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EACL,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EACtD,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,GACvD,MAAM,cAAc,CAAA;AAErB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAOhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,KAAK,EAEV,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EACjB,MAAM,gBAAgB,CAAA;AAIvB,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,UAAU,CAAA;IAClB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAC5B,CAAA;IACD,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B,uBAAuB,CAAC,EAAE,gBAAgB,CAAA;QAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAC3B,CAAA;CACF;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,IAAI,CAAA;IACT,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,IAAI,IAAI,IAAI,CAAA;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,WAAW,CA0H1E"}

package/dist/index.js

@@ -1,26 +1,151 @@
 export { createAuthMiddleware, checkScope } from './auth.js';
 export { createTasksRouter } from './routes/tasks.js';
 export { createSSERouter } from './routes/sse.js';
-export { createWorkersRouter, WorkerWSHandler } from './routes/workers.js';
+export { createWorkersRouter, WorkerWSHandler, WorkerWSRegistry } from './routes/workers.js';
 export { WebhookDelivery } from './webhook.js';
-import { Hono } from 'hono';
+export { TaskSchema, TaskEventSchema, WorkerSchema, ErrorSchema, CreateTaskSchema, TransitionSchema, PublishEventSchema, } from './schemas.js';
+import { OpenAPIHono } from '@hono/zod-openapi';
+import { apiReference } from '@scalar/hono-api-reference';
 import { createAuthMiddleware } from './auth.js';
 import { createTasksRouter } from './routes/tasks.js';
 import { createSSERouter } from './routes/sse.js';
 import { createWorkersRouter } from './routes/workers.js';
+import { WorkerWSRegistry } from './routes/worker-ws.js';
+import { isTerminal, matchesWorkerRule } from '@taskcast/core';
+import { TaskScheduler } from '@taskcast/core';
+import { HeartbeatMonitor } from '@taskcast/core';
 /**
- * Creates a Hono app with all taskcast routes mounted.
+ * Creates an OpenAPIHono app with all taskcast routes mounted.
  * Can be used standalone or mounted into an existing Hono app.
+ *
+ * Returns a TaskcastApp with `app` (the Hono instance) and `stop()` to
+ * clean up scheduler/heartbeat timers.
  */
 export function createTaskcastApp(opts) {
-    const app = new Hono();
+    const app = new OpenAPIHono();
     app.get('/health', (c) => c.json({ ok: true }));
     app.use('*', createAuthMiddleware(opts.auth ?? { mode: 'none' }));
     app.route('/tasks', createTasksRouter(opts.engine));
     app.route('/tasks', createSSERouter(opts.engine));
+    const cleanups = [];
+    // Wire scheduler
+    let scheduler;
+    if (opts.scheduler?.enabled !== false && opts.shortTermStore) {
+        const schedulerOpts = {
+            engine: opts.engine,
+            shortTermStore: opts.shortTermStore,
+        };
+        if (opts.scheduler?.checkIntervalMs !== undefined)
+            schedulerOpts.checkIntervalMs = opts.scheduler.checkIntervalMs;
+        if (opts.scheduler?.pausedColdAfterMs !== undefined)
+            schedulerOpts.pausedColdAfterMs = opts.scheduler.pausedColdAfterMs;
+        if (opts.scheduler?.blockedColdAfterMs !== undefined)
+            schedulerOpts.blockedColdAfterMs = opts.scheduler.blockedColdAfterMs;
+        scheduler = new TaskScheduler(schedulerOpts);
+        scheduler.start();
+        cleanups.push(() => scheduler.stop());
+    }
+    // Wire worker manager
+    let wsRegistry;
     if (opts.workerManager) {
+        const wm = opts.workerManager;
+        wsRegistry = new WorkerWSRegistry();
+        // Auto-release capacity on terminal transitions
+        opts.engine.addTransitionListener((_task, _from, to) => {
+            if (isTerminal(to)) {
+                wm.releaseTask(_task.id).catch(() => { });
+            }
+        });
+        // Wire ws-offer/ws-race dispatch on pending transitions
+        async function dispatchToWS(task) {
+            if (task.assignMode === 'ws-offer') {
+                const result = await wm.dispatchTask(task.id);
+                if (result.matched && result.workerId) {
+                    const handler = wsRegistry.get(result.workerId);
+                    if (handler)
+                        handler.offerTask(task);
+                }
+            }
+            else if (task.assignMode === 'ws-race') {
+                const workers = await wm.listWorkers({ status: ['idle', 'busy'] });
+                for (const worker of workers) {
+                    if (worker.connectionMode !== 'websocket')
+                        continue;
+                    if (!matchesWorkerRule(task, worker.matchRule))
+                        continue;
+                    const cost = task.cost ?? 1;
+                    if (worker.usedSlots + cost > worker.capacity)
+                        continue;
+                    const handler = wsRegistry.get(worker.id);
+                    if (handler)
+                        handler.broadcastAvailable(task);
+                }
+            }
+        }
+        // Dispatch on initial task creation
+        opts.engine.addCreationListener((task) => {
+            if (!task.assignMode || (task.assignMode !== 'ws-offer' && task.assignMode !== 'ws-race'))
+                return;
+            dispatchToWS(task).catch(() => { });
+        });
+        // Re-dispatch when task transitions back to pending (e.g. after decline)
+        opts.engine.addTransitionListener((task, _from, to) => {
+            if (to !== 'pending')
+                return;
+            if (!task.assignMode || (task.assignMode !== 'ws-offer' && task.assignMode !== 'ws-race'))
+                return;
+            // Fire-and-forget async dispatch
+            dispatchToWS(task).catch(() => { });
+        });
         app.route('/workers', createWorkersRouter(opts.workerManager, opts.engine));
+        // Wire heartbeat monitor
+        if (opts.heartbeat?.enabled !== false && opts.shortTermStore) {
+            const monitorOpts = {
+                workerManager: wm,
+                engine: opts.engine,
+                shortTermStore: opts.shortTermStore,
+            };
+            if (opts.heartbeat?.checkIntervalMs !== undefined)
+                monitorOpts.checkIntervalMs = opts.heartbeat.checkIntervalMs;
+            if (opts.heartbeat?.heartbeatTimeoutMs !== undefined)
+                monitorOpts.heartbeatTimeoutMs = opts.heartbeat.heartbeatTimeoutMs;
+            if (opts.heartbeat?.defaultDisconnectPolicy !== undefined)
+                monitorOpts.defaultDisconnectPolicy = opts.heartbeat.defaultDisconnectPolicy;
+            if (opts.heartbeat?.disconnectGraceMs !== undefined)
+                monitorOpts.disconnectGraceMs = opts.heartbeat.disconnectGraceMs;
+            const monitor = new HeartbeatMonitor(monitorOpts);
+            monitor.start();
+            cleanups.push(() => monitor.stop());
+        }
     }
-    return app;
+    // Register security scheme
+    app.openAPIRegistry.registerComponent('securitySchemes', 'Bearer', {
+        type: 'http',
+        scheme: 'bearer',
+        bearerFormat: 'JWT',
+        description: 'JWT Bearer token. Required scopes vary per endpoint.',
+    });
+    // OpenAPI spec endpoint
+    app.doc('/openapi.json', {
+        openapi: '3.1.0',
+        info: {
+            title: 'Taskcast API',
+            version: '0.3.0',
+            description: 'Unified long-lifecycle task tracking service for LLM streaming, agents, and async workloads.',
+        },
+        security: [{ Bearer: [] }],
+    });
+    // API documentation UI
+    app.get('/docs', apiReference({
+        url: '/openapi.json',
+    }));
+    return {
+        app: app,
+        ...(wsRegistry !== undefined && { wsRegistry }),
+        stop() {
+            for (const fn of cleanups)
+                fn();
+        },
+    };
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAUzD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA2B;IAC3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC/C,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IACjE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACnD,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACjD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,mBAAmB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IAC7E,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/routes/sse.d.ts

@@ -1,4 +1,4 @@
-import { Hono } from 'hono';
+import type { Hono } from 'hono';
 import type { TaskEngine } from '@taskcast/core';
-export declare function createSSERouter(engine: TaskEngine): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export declare function createSSERouter(engine: TaskEngine): Hono;
 //# sourceMappingURL=sse.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/routes/sse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAI3B,OAAO,KAAK,EAAE,UAAU,EAAkD,MAAM,gBAAgB,CAAA;AAkDhG,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,8EAyEjD"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/routes/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAOhC,OAAO,KAAK,EAAE,UAAU,EAAkD,MAAM,gBAAgB,CAAA;AAsFhG,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CA0ExD"}

package/dist/routes/sse.js

@@ -1,7 +1,35 @@
-import { Hono } from 'hono';
+import { OpenAPIHono, createRoute, z } from '@hono/zod-openapi';
 import { streamSSE } from 'hono/streaming';
 import { applyFilteredIndex, matchesFilter, TERMINAL_STATUSES } from '@taskcast/core';
 import { checkScope } from '../auth.js';
+import { ErrorSchema } from '../schemas.js';
+// ─── Route Definition ──────────────────────────────────────────────────────
+const sseRoute = createRoute({
+    method: 'get',
+    path: '/{taskId}/events',
+    tags: ['Events'],
+    summary: 'Subscribe to task events via SSE',
+    description: 'Server-Sent Events stream. Replays history then streams live. Closes on terminal status.',
+    security: [{ Bearer: [] }],
+    request: {
+        params: z.object({ taskId: z.string() }),
+        query: z.object({
+            types: z.string().optional().openapi({ description: 'Comma-separated type filter with wildcard support' }),
+            levels: z.string().optional().openapi({ description: 'Comma-separated level filter' }),
+            includeStatus: z.string().optional().openapi({ description: 'Include taskcast:status events (default: true)' }),
+            wrap: z.string().optional().openapi({ description: 'Wrap in SSEEnvelope (default: true)' }),
+            'since.id': z.string().optional(),
+            'since.index': z.string().optional(),
+            'since.timestamp': z.string().optional(),
+        }),
+    },
+    responses: {
+        200: { description: 'SSE event stream (text/event-stream)' },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+        404: { description: 'Task not found', content: { 'application/json': { schema: ErrorSchema } } },
+    },
+});
+// ─── Helpers ───────────────────────────────────────────────────────────────
 function parseFilter(query) {
     const get = (k) => query[k];
     const filter = {};
@@ -47,13 +75,16 @@ function toEnvelope(event, filteredIndex) {
         env.seriesId = event.seriesId;
     if (event.seriesMode !== undefined)
         env.seriesMode = event.seriesMode;
+    if (event.seriesAccField !== undefined)
+        env.seriesAccField = event.seriesAccField;
     return env;
 }
 const TERMINAL = new Set(TERMINAL_STATUSES);
 export function createSSERouter(engine) {
-    const router = new Hono();
-    router.get('/:taskId/events', async (c) => {
-        const { taskId } = c.req.param();
+    const router = new OpenAPIHono();
+    const register = router.openapi.bind(router);
+    register(sseRoute, async (c) => {
+        const taskId = c.req.param('taskId');
         const auth = c.get('auth');
         if (!checkScope(auth, 'event:subscribe', taskId))
             return c.json({ error: 'Forbidden' }, 403);

package/dist/routes/sse.js.map

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

package/dist/routes/tasks.d.ts

@@ -1,4 +1,4 @@
-import { Hono } from 'hono';
+import type { Hono } from 'hono';
 import type { TaskEngine } from '@taskcast/core';
-export declare function createTasksRouter(engine: TaskEngine): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export declare function createTasksRouter(engine: TaskEngine): Hono;
 //# sourceMappingURL=tasks.d.ts.map

package/dist/routes/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/routes/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAG3B,OAAO,KAAK,EAAE,UAAU,EAA8D,MAAM,gBAAgB,CAAA;AAwB5G,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,8EA6InD"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/routes/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAYhC,OAAO,KAAK,EAAE,UAAU,EAA8E,MAAM,gBAAgB,CAAA;AA0G5H,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAwL1D"}

package/dist/routes/tasks.js

@@ -1,29 +1,98 @@
-import { Hono } from 'hono';
-import { z } from 'zod';
+import { OpenAPIHono, createRoute, z } from '@hono/zod-openapi';
 import { checkScope } from '../auth.js';
-const CreateTaskSchema = z.object({
-    id: z.string().optional(),
-    type: z.string().optional(),
-    params: z.record(z.unknown()).optional(),
-    metadata: z.record(z.unknown()).optional(),
-    ttl: z.number().int().positive().optional(),
-    webhooks: z.array(z.unknown()).optional(),
-    cleanup: z.object({ rules: z.array(z.unknown()) }).optional(),
-    tags: z.array(z.string()).optional(),
-    assignMode: z.enum(['external', 'pull', 'ws-offer', 'ws-race']).optional(),
-    cost: z.number().int().positive().optional(),
-    disconnectPolicy: z.enum(['reassign', 'mark', 'fail']).optional(),
+import { CreateTaskSchema, PublishEventSchema, TransitionSchema, TaskSchema, TaskEventSchema, ErrorSchema, } from '../schemas.js';
+// ─── Route Definitions ─────────────────────────────────────────────────────
+const createTaskRoute = createRoute({
+    method: 'post',
+    path: '/',
+    tags: ['Tasks'],
+    summary: 'Create a new task',
+    security: [{ Bearer: [] }],
+    request: {
+        body: { content: { 'application/json': { schema: CreateTaskSchema } } },
+    },
+    responses: {
+        201: { description: 'Task created', content: { 'application/json': { schema: TaskSchema } } },
+        400: { description: 'Validation error', content: { 'application/json': { schema: ErrorSchema } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
 });
-const PublishEventSchema = z.object({
-    type: z.string(),
-    level: z.enum(['debug', 'info', 'warn', 'error']),
-    data: z.unknown(),
-    seriesId: z.string().optional(),
-    seriesMode: z.enum(['keep-all', 'accumulate', 'latest']).optional(),
+const getTaskRoute = createRoute({
+    method: 'get',
+    path: '/{taskId}',
+    tags: ['Tasks'],
+    summary: 'Get task by ID',
+    security: [{ Bearer: [] }],
+    request: {
+        params: z.object({ taskId: z.string() }),
+    },
+    responses: {
+        200: { description: 'Task details', content: { 'application/json': { schema: TaskSchema } } },
+        404: { description: 'Task not found', content: { 'application/json': { schema: ErrorSchema } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
+});
+const transitionRoute = createRoute({
+    method: 'patch',
+    path: '/{taskId}/status',
+    tags: ['Tasks'],
+    summary: 'Transition task status',
+    security: [{ Bearer: [] }],
+    request: {
+        params: z.object({ taskId: z.string() }),
+        body: { content: { 'application/json': { schema: TransitionSchema } } },
+    },
+    responses: {
+        200: { description: 'Updated task', content: { 'application/json': { schema: TaskSchema } } },
+        400: { description: 'Invalid transition', content: { 'application/json': { schema: ErrorSchema } } },
+        404: { description: 'Task not found', content: { 'application/json': { schema: ErrorSchema } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
+});
+const publishEventsRoute = createRoute({
+    method: 'post',
+    path: '/{taskId}/events',
+    tags: ['Events'],
+    summary: 'Publish events to a task',
+    description: 'Supports single event or batch (array) publishing.',
+    security: [{ Bearer: [] }],
+    request: {
+        params: z.object({ taskId: z.string() }),
+        body: { content: { 'application/json': { schema: z.union([PublishEventSchema, z.array(PublishEventSchema)]) } } },
+    },
+    responses: {
+        201: { description: 'Events published', content: { 'application/json': { schema: z.union([TaskEventSchema, z.array(TaskEventSchema)]) } } },
+        400: { description: 'Validation error', content: { 'application/json': { schema: ErrorSchema } } },
+        404: { description: 'Task not found', content: { 'application/json': { schema: ErrorSchema } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
+});
+const eventHistoryRoute = createRoute({
+    method: 'get',
+    path: '/{taskId}/events/history',
+    tags: ['Events'],
+    summary: 'Query event history',
+    security: [{ Bearer: [] }],
+    request: {
+        params: z.object({ taskId: z.string() }),
+        query: z.object({
+            'since.id': z.string().optional(),
+            'since.index': z.string().optional(),
+            'since.timestamp': z.string().optional(),
+            types: z.string().optional(),
+            levels: z.string().optional(),
+        }),
+    },
+    responses: {
+        200: { description: 'Event list', content: { 'application/json': { schema: z.array(TaskEventSchema) } } },
+        404: { description: 'Task not found', content: { 'application/json': { schema: ErrorSchema } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
 });
 export function createTasksRouter(engine) {
-    const router = new Hono();
-    router.post('/', async (c) => {
+    const router = new OpenAPIHono();
+    const register = router.openapi.bind(router);
+    register(createTaskRoute, async (c) => {
         const auth = c.get('auth');
         if (!checkScope(auth, 'task:create'))
             return c.json({ error: 'Forbidden' }, 403);
@@ -51,11 +120,17 @@ export function createTasksRouter(engine) {
             input.cost = d.cost;
         if (d.disconnectPolicy !== undefined)
             input.disconnectPolicy = d.disconnectPolicy;
+        if (d.webhooks !== undefined)
+            input.webhooks = d.webhooks;
+        if (d.cleanup !== undefined)
+            input.cleanup = d.cleanup;
+        if (d.authConfig !== undefined)
+            input.authConfig = d.authConfig;
         const task = await engine.createTask(input);
         return c.json(task, 201);
     });
-    router.get('/:taskId', async (c) => {
-        const { taskId } = c.req.param();
+    register(getTaskRoute, async (c) => {
+        const taskId = c.req.param('taskId');
         const auth = c.get('auth');
         if (!checkScope(auth, 'event:subscribe', taskId))
             return c.json({ error: 'Forbidden' }, 403);
@@ -64,25 +139,13 @@ export function createTasksRouter(engine) {
             return c.json({ error: 'Task not found' }, 404);
         return c.json(task);
     });
-    router.patch('/:taskId/status', async (c) => {
-        const { taskId } = c.req.param();
+    register(transitionRoute, async (c) => {
+        const taskId = c.req.param('taskId');
         const auth = c.get('auth');
         if (!checkScope(auth, 'task:manage', taskId))
             return c.json({ error: 'Forbidden' }, 403);
         const body = await c.req.json();
-        const schema = z.object({
-            status: z.enum(['pending', 'assigned', 'running', 'paused', 'blocked', 'completed', 'failed', 'timeout', 'cancelled']),
-            result: z.record(z.unknown()).optional(),
-            error: z.object({
-                code: z.string().optional(),
-                message: z.string(),
-                details: z.record(z.unknown()).optional(),
-            }).optional(),
-            reason: z.string().optional(),
-            ttl: z.number().int().positive().optional(),
-            resumeAfterMs: z.number().int().positive().optional(),
-        });
-        const parsed = schema.safeParse(body);
+        const parsed = TransitionSchema.safeParse(body);
         if (!parsed.success)
             return c.json({ error: parsed.error.flatten() }, 400);
         try {
@@ -104,6 +167,12 @@ export function createTasksRouter(engine) {
                 payload.ttl = parsed.data.ttl;
             if (parsed.data.resumeAfterMs !== undefined)
                 payload.resumeAfterMs = parsed.data.resumeAfterMs;
+            if (parsed.data.blockedRequest !== undefined) {
+                payload.blockedRequest = {
+                    type: parsed.data.blockedRequest.type,
+                    data: parsed.data.blockedRequest.data,
+                };
+            }
             const task = await engine.transitionTask(taskId, parsed.data.status, payload);
             return c.json(task);
         }
@@ -114,8 +183,8 @@ export function createTasksRouter(engine) {
             return c.json({ error: msg }, 400);
         }
     });
-    router.post('/:taskId/events', async (c) => {
-        const { taskId } = c.req.param();
+    register(publishEventsRoute, async (c) => {
+        const taskId = c.req.param('taskId');
         const auth = c.get('auth');
         if (!checkScope(auth, 'event:publish', taskId))
             return c.json({ error: 'Forbidden' }, 403);
@@ -134,6 +203,8 @@ export function createTasksRouter(engine) {
                     eventInput.seriesId = d.seriesId;
                 if (d.seriesMode !== undefined)
                     eventInput.seriesMode = d.seriesMode;
+                if (d.seriesAccField !== undefined)
+                    eventInput.seriesAccField = d.seriesAccField;
                 const event = await engine.publishEvent(taskId, eventInput);
                 events.push(event);
             }
@@ -146,8 +217,8 @@ export function createTasksRouter(engine) {
         }
         return c.json(isBatch ? events : events[0], 201);
     });
-    router.get('/:taskId/events/history', async (c) => {
-        const { taskId } = c.req.param();
+    register(eventHistoryRoute, async (c) => {
+        const taskId = c.req.param('taskId');
         const auth = c.get('auth');
         if (!checkScope(auth, 'event:history', taskId))
             return c.json({ error: 'Forbidden' }, 403);
@@ -170,6 +241,49 @@ export function createTasksRouter(engine) {
         const events = await engine.getEvents(taskId, since !== undefined ? { since } : undefined);
         return c.json(events);
     });
+    // ─── POST /tasks/:taskId/resolve — Resolve a blocked task ─────────────────
+    router.post('/:taskId/resolve', async (c) => {
+        const taskId = c.req.param('taskId');
+        const auth = c.get('auth');
+        if (!checkScope(auth, 'task:resolve', taskId))
+            return c.json({ error: 'Forbidden' }, 403);
+        const task = await engine.getTask(taskId);
+        if (!task)
+            return c.json({ error: 'Task not found' }, 404);
+        if (task.status !== 'blocked')
+            return c.json({ error: 'Task is not blocked' }, 400);
+        const body = await c.req.json();
+        const schema = z.object({ data: z.unknown() });
+        const parsed = schema.safeParse(body);
+        if (!parsed.success)
+            return c.json({ error: parsed.error.flatten() }, 400);
+        try {
+            const updated = await engine.transitionTask(taskId, 'running', {
+                result: typeof parsed.data.data === 'object' && parsed.data.data !== null
+                    ? parsed.data.data
+                    : { resolution: parsed.data.data },
+            });
+            return c.json(updated);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return c.json({ error: msg }, 400);
+        }
+    });
+    // ─── GET /tasks/:taskId/request — Get blocked request ────────────────────
+    router.get('/:taskId/request', async (c) => {
+        const taskId = c.req.param('taskId');
+        const auth = c.get('auth');
+        if (!checkScope(auth, 'task:resolve', taskId))
+            return c.json({ error: 'Forbidden' }, 403);
+        const task = await engine.getTask(taskId);
+        if (!task)
+            return c.json({ error: 'Task not found' }, 404);
+        if (task.status !== 'blocked' || !task.blockedRequest) {
+            return c.json({ error: 'No blocked request' }, 404);
+        }
+        return c.json(task.blockedRequest);
+    });
     return router;
 }
 //# sourceMappingURL=tasks.js.map