@taskcast/server 0.2.0 → 0.3.1

package/dist/routes/workers.js

@@ -0,0 +1,169 @@
+import { OpenAPIHono, createRoute, z } from '@hono/zod-openapi';
+import { checkScope } from '../auth.js';
+import { DeclineSchema, WorkerSchema, TaskSchema, ErrorSchema } from '../schemas.js';
+export { WorkerWSHandler, WorkerWSRegistry } from './worker-ws.js';
+// ─── Route Definitions ─────────────────────────────────────────────────────
+const listWorkersRoute = createRoute({
+    method: 'get',
+    path: '/',
+    tags: ['Workers'],
+    summary: 'List all workers',
+    security: [{ Bearer: [] }],
+    responses: {
+        200: { description: 'Worker list', content: { 'application/json': { schema: z.array(WorkerSchema) } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
+});
+const pullTaskRoute = createRoute({
+    method: 'get',
+    path: '/pull',
+    tags: ['Workers'],
+    summary: 'Long-poll for a task assignment',
+    description: 'Worker long-polls to receive a task assignment. Returns 204 on timeout.',
+    security: [{ Bearer: [] }],
+    request: {
+        query: z.object({
+            workerId: z.string().optional().openapi({ description: 'Worker identifier (required)' }),
+            weight: z.string().optional().openapi({ description: 'Worker weight' }),
+            timeout: z.string().optional().openapi({ description: 'Long-poll timeout in ms (default: 30000)' }),
+        }),
+    },
+    responses: {
+        200: { description: 'Assigned task', content: { 'application/json': { schema: TaskSchema } } },
+        204: { description: 'No task available (timeout)' },
+        400: { description: 'Missing workerId', content: { 'application/json': { schema: ErrorSchema } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
+});
+const getWorkerRoute = createRoute({
+    method: 'get',
+    path: '/{workerId}',
+    tags: ['Workers'],
+    summary: 'Get worker by ID',
+    security: [{ Bearer: [] }],
+    request: {
+        params: z.object({ workerId: z.string() }),
+    },
+    responses: {
+        200: { description: 'Worker details', content: { 'application/json': { schema: WorkerSchema } } },
+        404: { description: 'Worker not found', content: { 'application/json': { schema: ErrorSchema } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
+});
+const deleteWorkerRoute = createRoute({
+    method: 'delete',
+    path: '/{workerId}',
+    tags: ['Workers'],
+    summary: 'Force disconnect a worker',
+    security: [{ Bearer: [] }],
+    request: {
+        params: z.object({ workerId: z.string() }),
+    },
+    responses: {
+        204: { description: 'Worker removed' },
+        404: { description: 'Worker not found', content: { 'application/json': { schema: ErrorSchema } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
+});
+const declineTaskRoute = createRoute({
+    method: 'post',
+    path: '/tasks/{taskId}/decline',
+    tags: ['Workers'],
+    summary: 'Worker declines a task assignment',
+    security: [{ Bearer: [] }],
+    request: {
+        params: z.object({ taskId: z.string() }),
+        body: { content: { 'application/json': { schema: DeclineSchema } } },
+    },
+    responses: {
+        200: { description: 'Task declined', content: { 'application/json': { schema: z.object({ ok: z.boolean() }) } } },
+        400: { description: 'Validation error', content: { 'application/json': { schema: ErrorSchema } } },
+        403: { description: 'Forbidden', content: { 'application/json': { schema: ErrorSchema } } },
+    },
+});
+export function createWorkersRouter(manager, engine) {
+    const router = new OpenAPIHono();
+    const register = router.openapi.bind(router);
+    // GET / — list all workers
+    register(listWorkersRoute, async (c) => {
+        const auth = c.get('auth');
+        if (!checkScope(auth, 'worker:manage'))
+            return c.json({ error: 'Forbidden' }, 403);
+        const workers = await manager.listWorkers();
+        return c.json(workers);
+    });
+    // GET /pull — long-poll for task (worker:connect scope)
+    // Must be registered before /{workerId} to avoid being matched as a param
+    register(pullTaskRoute, async (c) => {
+        const auth = c.get('auth');
+        if (!checkScope(auth, 'worker:connect'))
+            return c.json({ error: 'Forbidden' }, 403);
+        const workerId = c.req.query('workerId');
+        if (!workerId)
+            return c.json({ error: 'workerId query param required' }, 400);
+        if (auth.workerId && auth.workerId !== workerId) {
+            return c.json({ error: 'Forbidden: worker ID mismatch' }, 403);
+        }
+        const weight = c.req.query('weight');
+        if (weight)
+            await manager.updateWorker(workerId, { weight: Number(weight) });
+        await manager.heartbeat(workerId);
+        try {
+            const controller = new AbortController();
+            const timeoutMs = Number(c.req.query('timeout') ?? 30000);
+            const timeout = setTimeout(() => controller.abort(), timeoutMs);
+            c.req.raw.signal.addEventListener('abort', () => {
+                clearTimeout(timeout);
+                controller.abort();
+            });
+            const task = await manager.waitForTask(workerId, controller.signal);
+            clearTimeout(timeout);
+            return c.json(task);
+        }
+        catch {
+            return c.body(null, 204);
+        }
+    });
+    // GET /{workerId} — get single worker
+    register(getWorkerRoute, async (c) => {
+        const workerId = c.req.param('workerId');
+        const auth = c.get('auth');
+        if (!checkScope(auth, 'worker:manage'))
+            return c.json({ error: 'Forbidden' }, 403);
+        const worker = await manager.getWorker(workerId);
+        if (!worker)
+            return c.json({ error: 'Worker not found' }, 404);
+        return c.json(worker);
+    });
+    // DELETE /{workerId} — force disconnect
+    register(deleteWorkerRoute, async (c) => {
+        const workerId = c.req.param('workerId');
+        const auth = c.get('auth');
+        if (!checkScope(auth, 'worker:manage'))
+            return c.json({ error: 'Forbidden' }, 403);
+        const worker = await manager.getWorker(workerId);
+        if (!worker)
+            return c.json({ error: 'Worker not found' }, 404);
+        await manager.unregisterWorker(workerId);
+        return c.body(null, 204);
+    });
+    // POST /tasks/{taskId}/decline — worker declines a task
+    register(declineTaskRoute, async (c) => {
+        const taskId = c.req.param('taskId');
+        const auth = c.get('auth');
+        if (!checkScope(auth, 'worker:connect'))
+            return c.json({ error: 'Forbidden' }, 403);
+        const body = await c.req.json();
+        const parsed = DeclineSchema.safeParse(body);
+        if (!parsed.success)
+            return c.json({ error: parsed.error.flatten() }, 400);
+        if (auth.workerId && auth.workerId !== parsed.data.workerId) {
+            return c.json({ error: 'Forbidden: worker ID mismatch' }, 403);
+        }
+        const declineOpts = parsed.data.blacklist !== undefined ? { blacklist: parsed.data.blacklist } : {};
+        await manager.declineTask(taskId, parsed.data.workerId, declineOpts);
+        return c.json({ ok: true });
+    });
+    return router;
+}
+//# sourceMappingURL=workers.js.map

package/dist/routes/workers.js.map

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

package/dist/schemas.d.ts

@@ -0,0 +1,352 @@
+import { z } from '@hono/zod-openapi';
+export declare const TaskStatusSchema: z.ZodEnum<["pending", "assigned", "running", "paused", "blocked", "completed", "failed", "timeout", "cancelled"]>;
+export declare const LevelSchema: z.ZodEnum<["debug", "info", "warn", "error"]>;
+export declare const SeriesModeSchema: z.ZodEnum<["keep-all", "accumulate", "latest"]>;
+export declare const AssignModeSchema: z.ZodEnum<["external", "pull", "ws-offer", "ws-race"]>;
+export declare const DisconnectPolicySchema: z.ZodEnum<["reassign", "mark", "fail"]>;
+export declare const TaskErrorSchema: z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    code?: string | undefined;
+    details?: Record<string, unknown> | undefined;
+}, {
+    message: string;
+    code?: string | undefined;
+    details?: Record<string, unknown> | undefined;
+}>;
+export declare const TaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["pending", "assigned", "running", "paused", "blocked", "completed", "failed", "timeout", "cancelled"]>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        code?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        message: string;
+        code?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    assignMode: z.ZodOptional<z.ZodEnum<["external", "pull", "ws-offer", "ws-race"]>>;
+    cost: z.ZodOptional<z.ZodNumber>;
+    assignedWorker: z.ZodOptional<z.ZodString>;
+    disconnectPolicy: z.ZodOptional<z.ZodEnum<["reassign", "mark", "fail"]>>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "assigned" | "running" | "paused" | "blocked" | "completed" | "failed" | "timeout" | "cancelled";
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    type?: string | undefined;
+    error?: {
+        message: string;
+        code?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+    assignMode?: "external" | "pull" | "ws-offer" | "ws-race" | undefined;
+    disconnectPolicy?: "reassign" | "mark" | "fail" | undefined;
+    result?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    params?: Record<string, unknown> | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    completedAt?: number | undefined;
+    ttl?: number | undefined;
+    cost?: number | undefined;
+    assignedWorker?: string | undefined;
+}, {
+    status: "pending" | "assigned" | "running" | "paused" | "blocked" | "completed" | "failed" | "timeout" | "cancelled";
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    type?: string | undefined;
+    error?: {
+        message: string;
+        code?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+    assignMode?: "external" | "pull" | "ws-offer" | "ws-race" | undefined;
+    disconnectPolicy?: "reassign" | "mark" | "fail" | undefined;
+    result?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    params?: Record<string, unknown> | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    completedAt?: number | undefined;
+    ttl?: number | undefined;
+    cost?: number | undefined;
+    assignedWorker?: string | undefined;
+}>;
+export declare const TaskEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    taskId: z.ZodString;
+    index: z.ZodNumber;
+    timestamp: z.ZodNumber;
+    type: z.ZodString;
+    level: z.ZodEnum<["debug", "info", "warn", "error"]>;
+    data: z.ZodUnknown;
+    seriesId: z.ZodOptional<z.ZodString>;
+    seriesMode: z.ZodOptional<z.ZodEnum<["keep-all", "accumulate", "latest"]>>;
+    seriesAccField: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    level: "error" | "debug" | "info" | "warn";
+    index: number;
+    timestamp: number;
+    id: string;
+    taskId: string;
+    seriesMode?: "keep-all" | "accumulate" | "latest" | undefined;
+    data?: unknown;
+    seriesId?: string | undefined;
+    seriesAccField?: string | undefined;
+}, {
+    type: string;
+    level: "error" | "debug" | "info" | "warn";
+    index: number;
+    timestamp: number;
+    id: string;
+    taskId: string;
+    seriesMode?: "keep-all" | "accumulate" | "latest" | undefined;
+    data?: unknown;
+    seriesId?: string | undefined;
+    seriesAccField?: string | undefined;
+}>;
+export declare const WorkerSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<["idle", "busy", "draining", "offline"]>;
+    matchRule: z.ZodObject<{
+        taskTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        tags: z.ZodOptional<z.ZodObject<{
+            all: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            any: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            none: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            all?: string[] | undefined;
+            none?: string[] | undefined;
+            any?: string[] | undefined;
+        }, {
+            all?: string[] | undefined;
+            none?: string[] | undefined;
+            any?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        tags?: {
+            all?: string[] | undefined;
+            none?: string[] | undefined;
+            any?: string[] | undefined;
+        } | undefined;
+        taskTypes?: string[] | undefined;
+    }, {
+        tags?: {
+            all?: string[] | undefined;
+            none?: string[] | undefined;
+            any?: string[] | undefined;
+        } | undefined;
+        taskTypes?: string[] | undefined;
+    }>;
+    capacity: z.ZodNumber;
+    usedSlots: z.ZodNumber;
+    weight: z.ZodNumber;
+    connectionMode: z.ZodEnum<["pull", "websocket"]>;
+    connectedAt: z.ZodNumber;
+    lastHeartbeatAt: z.ZodNumber;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    status: "idle" | "busy" | "draining" | "offline";
+    connectionMode: "pull" | "websocket";
+    id: string;
+    matchRule: {
+        tags?: {
+            all?: string[] | undefined;
+            none?: string[] | undefined;
+            any?: string[] | undefined;
+        } | undefined;
+        taskTypes?: string[] | undefined;
+    };
+    capacity: number;
+    usedSlots: number;
+    weight: number;
+    connectedAt: number;
+    lastHeartbeatAt: number;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    status: "idle" | "busy" | "draining" | "offline";
+    connectionMode: "pull" | "websocket";
+    id: string;
+    matchRule: {
+        tags?: {
+            all?: string[] | undefined;
+            none?: string[] | undefined;
+            any?: string[] | undefined;
+        } | undefined;
+        taskTypes?: string[] | undefined;
+    };
+    capacity: number;
+    usedSlots: number;
+    weight: number;
+    connectedAt: number;
+    lastHeartbeatAt: number;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export declare const ErrorSchema: z.ZodObject<{
+    error: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+}, {
+    error: string;
+}>;
+export declare const CreateTaskSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    webhooks: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    cleanup: z.ZodOptional<z.ZodObject<{
+        rules: z.ZodArray<z.ZodUnknown, "many">;
+    }, "strip", z.ZodTypeAny, {
+        rules: unknown[];
+    }, {
+        rules: unknown[];
+    }>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    assignMode: z.ZodOptional<z.ZodEnum<["external", "pull", "ws-offer", "ws-race"]>>;
+    cost: z.ZodOptional<z.ZodNumber>;
+    disconnectPolicy: z.ZodOptional<z.ZodEnum<["reassign", "mark", "fail"]>>;
+    authConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type?: string | undefined;
+    webhooks?: unknown[] | undefined;
+    cleanup?: {
+        rules: unknown[];
+    } | undefined;
+    authConfig?: Record<string, unknown> | undefined;
+    assignMode?: "external" | "pull" | "ws-offer" | "ws-race" | undefined;
+    disconnectPolicy?: "reassign" | "mark" | "fail" | undefined;
+    tags?: string[] | undefined;
+    params?: Record<string, unknown> | undefined;
+    id?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    ttl?: number | undefined;
+    cost?: number | undefined;
+}, {
+    type?: string | undefined;
+    webhooks?: unknown[] | undefined;
+    cleanup?: {
+        rules: unknown[];
+    } | undefined;
+    authConfig?: Record<string, unknown> | undefined;
+    assignMode?: "external" | "pull" | "ws-offer" | "ws-race" | undefined;
+    disconnectPolicy?: "reassign" | "mark" | "fail" | undefined;
+    tags?: string[] | undefined;
+    params?: Record<string, unknown> | undefined;
+    id?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    ttl?: number | undefined;
+    cost?: number | undefined;
+}>;
+export declare const TransitionSchema: z.ZodObject<{
+    status: z.ZodEnum<["pending", "assigned", "running", "paused", "blocked", "completed", "failed", "timeout", "cancelled"]>;
+    result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        code?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        message: string;
+        code?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    }>>;
+    reason: z.ZodOptional<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    resumeAfterMs: z.ZodOptional<z.ZodNumber>;
+    blockedRequest: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        data: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        data?: unknown;
+    }, {
+        type: string;
+        data?: unknown;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "assigned" | "running" | "paused" | "blocked" | "completed" | "failed" | "timeout" | "cancelled";
+    error?: {
+        message: string;
+        code?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+    result?: Record<string, unknown> | undefined;
+    ttl?: number | undefined;
+    reason?: string | undefined;
+    resumeAfterMs?: number | undefined;
+    blockedRequest?: {
+        type: string;
+        data?: unknown;
+    } | undefined;
+}, {
+    status: "pending" | "assigned" | "running" | "paused" | "blocked" | "completed" | "failed" | "timeout" | "cancelled";
+    error?: {
+        message: string;
+        code?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    } | undefined;
+    result?: Record<string, unknown> | undefined;
+    ttl?: number | undefined;
+    reason?: string | undefined;
+    resumeAfterMs?: number | undefined;
+    blockedRequest?: {
+        type: string;
+        data?: unknown;
+    } | undefined;
+}>;
+export declare const PublishEventSchema: z.ZodObject<{
+    type: z.ZodString;
+    level: z.ZodEnum<["debug", "info", "warn", "error"]>;
+    data: z.ZodUnknown;
+    seriesId: z.ZodOptional<z.ZodString>;
+    seriesMode: z.ZodOptional<z.ZodEnum<["keep-all", "accumulate", "latest"]>>;
+    seriesAccField: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    level: "error" | "debug" | "info" | "warn";
+    seriesMode?: "keep-all" | "accumulate" | "latest" | undefined;
+    data?: unknown;
+    seriesId?: string | undefined;
+    seriesAccField?: string | undefined;
+}, {
+    type: string;
+    level: "error" | "debug" | "info" | "warn";
+    seriesMode?: "keep-all" | "accumulate" | "latest" | undefined;
+    data?: unknown;
+    seriesId?: string | undefined;
+    seriesAccField?: string | undefined;
+}>;
+export declare const DeclineSchema: z.ZodObject<{
+    workerId: z.ZodString;
+    blacklist: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    workerId: string;
+    blacklist?: boolean | undefined;
+}, {
+    workerId: string;
+    blacklist?: boolean | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAA;AAIrC,eAAO,MAAM,gBAAgB,mHAU3B,CAAA;AAEF,eAAO,MAAM,WAAW,+CAA6C,CAAA;AAErE,eAAO,MAAM,gBAAgB,iDAA+C,CAAA;AAE5E,eAAO,MAAM,gBAAgB,wDAAsD,CAAA;AAEnF,eAAO,MAAM,sBAAsB,yCAAuC,CAAA;AAI1E,eAAO,MAAM,eAAe;;;;;;;;;;;;EAML,CAAA;AAEvB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBL,CAAA;AAElB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaL,CAAA;AAEvB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBL,CAAA;AAEpB,eAAO,MAAM,WAAW;;;;;;EAIL,CAAA;AAInB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeA,CAAA;AAE7B,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBA,CAAA;AAE7B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EASA,CAAA;AAE/B,eAAO,MAAM,aAAa;;;;;;;;;EAKA,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,138 @@
+import { z } from '@hono/zod-openapi';
+// ─── Enums ──────────────────────────────────────────────────────────────────
+export const TaskStatusSchema = z.enum([
+    'pending',
+    'assigned',
+    'running',
+    'paused',
+    'blocked',
+    'completed',
+    'failed',
+    'timeout',
+    'cancelled',
+]);
+export const LevelSchema = z.enum(['debug', 'info', 'warn', 'error']);
+export const SeriesModeSchema = z.enum(['keep-all', 'accumulate', 'latest']);
+export const AssignModeSchema = z.enum(['external', 'pull', 'ws-offer', 'ws-race']);
+export const DisconnectPolicySchema = z.enum(['reassign', 'mark', 'fail']);
+// ─── Response Schemas ───────────────────────────────────────────────────────
+export const TaskErrorSchema = z
+    .object({
+    code: z.string().optional(),
+    message: z.string(),
+    details: z.record(z.unknown()).optional(),
+})
+    .openapi('TaskError');
+export const TaskSchema = z
+    .object({
+    id: z.string(),
+    type: z.string().optional(),
+    status: TaskStatusSchema,
+    params: z.record(z.unknown()).optional(),
+    result: z.record(z.unknown()).optional(),
+    error: TaskErrorSchema.optional(),
+    metadata: z.record(z.unknown()).optional(),
+    createdAt: z.number(),
+    updatedAt: z.number(),
+    completedAt: z.number().optional(),
+    ttl: z.number().int().positive().optional(),
+    tags: z.array(z.string()).optional(),
+    assignMode: AssignModeSchema.optional(),
+    cost: z.number().int().positive().optional(),
+    assignedWorker: z.string().optional(),
+    disconnectPolicy: DisconnectPolicySchema.optional(),
+})
+    .openapi('Task');
+export const TaskEventSchema = z
+    .object({
+    id: z.string(),
+    taskId: z.string(),
+    index: z.number().int(),
+    timestamp: z.number(),
+    type: z.string(),
+    level: LevelSchema,
+    data: z.unknown(),
+    seriesId: z.string().optional(),
+    seriesMode: SeriesModeSchema.optional(),
+    seriesAccField: z.string().optional(),
+})
+    .openapi('TaskEvent');
+export const WorkerSchema = z
+    .object({
+    id: z.string(),
+    status: z.enum(['idle', 'busy', 'draining', 'offline']),
+    matchRule: z.object({
+        taskTypes: z.array(z.string()).optional(),
+        tags: z
+            .object({
+            all: z.array(z.string()).optional(),
+            any: z.array(z.string()).optional(),
+            none: z.array(z.string()).optional(),
+        })
+            .optional(),
+    }),
+    capacity: z.number().int(),
+    usedSlots: z.number().int(),
+    weight: z.number(),
+    connectionMode: z.enum(['pull', 'websocket']),
+    connectedAt: z.number(),
+    lastHeartbeatAt: z.number(),
+    metadata: z.record(z.unknown()).optional(),
+})
+    .openapi('Worker');
+export const ErrorSchema = z
+    .object({
+    error: z.string(),
+})
+    .openapi('Error');
+// ─── Request Body Schemas ───────────────────────────────────────────────────
+export 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: AssignModeSchema.optional(),
+    cost: z.number().int().positive().optional(),
+    disconnectPolicy: DisconnectPolicySchema.optional(),
+    authConfig: z.record(z.unknown()).optional(),
+})
+    .openapi('CreateTaskInput');
+export const TransitionSchema = z
+    .object({
+    status: TaskStatusSchema,
+    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(),
+    blockedRequest: z.object({ type: z.string(), data: z.unknown() }).optional(),
+})
+    .openapi('TransitionInput');
+export const PublishEventSchema = z
+    .object({
+    type: z.string(),
+    level: LevelSchema,
+    data: z.unknown(),
+    seriesId: z.string().optional(),
+    seriesMode: SeriesModeSchema.optional(),
+    seriesAccField: z.string().optional(),
+})
+    .openapi('PublishEventInput');
+export const DeclineSchema = z
+    .object({
+    workerId: z.string(),
+    blacklist: z.boolean().optional(),
+})
+    .openapi('DeclineInput');
+//# sourceMappingURL=schemas.js.map