@deriest/ai-engineering-company 1.15.2

package/dist/src/tools.js

@@ -0,0 +1,107 @@
+import { Type } from "@sinclair/typebox";
+import { validateSessionKeyRequired } from "./validation.js";
+function jsonResult(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        details: null,
+    };
+}
+// --- Schemas ---
+const DispatchParams = Type.Object({
+    message: Type.String({ description: "Task description for the Dispatcher agent." }),
+    wait: Type.Optional(Type.Boolean({ description: "Wait for completion (default: true)." })),
+    timeout: Type.Optional(Type.Number({ description: "Max wait time in milliseconds (default: 900000)." })),
+}, { additionalProperties: false });
+const StatusParams = Type.Object({
+    sessionKey: Type.Optional(Type.String({ description: "Session key to query. Omit to list recent dispatches." })),
+}, { additionalProperties: false });
+const ResultParams = Type.Object({
+    sessionKey: Type.String({ description: "Session key of the completed task." }),
+    limit: Type.Optional(Type.Number({ description: "Max messages to retrieve (default: 50)." })),
+}, { additionalProperties: false });
+// --- Tool Factories ---
+function makeDispatchTool(deps) {
+    return {
+        name: "ai_company_dispatch",
+        label: "AI Company Dispatch",
+        description: "Submit a task to the AI Engineering Company Dispatcher agent. Returns session key and run ID.",
+        parameters: DispatchParams,
+        execute: async (_toolCallId, params) => {
+            const { message, wait = true, timeout = 900_000 } = params;
+            try {
+                const result = await deps.dispatchService.dispatch(message, { wait, timeout });
+                return jsonResult({ task: "dispatch", ...result });
+            }
+            catch (err) {
+                return jsonResult({
+                    task: "dispatch",
+                    status: "error",
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        },
+    };
+}
+function makeStatusTool(deps) {
+    return {
+        name: "ai_company_status",
+        label: "AI Company Status",
+        description: "Query the status of a dispatched task or list recent dispatches.",
+        parameters: StatusParams,
+        execute: async (_toolCallId, params) => {
+            const { sessionKey } = params;
+            try {
+                if (sessionKey) {
+                    const validatedKey = validateSessionKeyRequired(sessionKey);
+                    const entry = deps.dispatchService.status(validatedKey);
+                    if (!entry) {
+                        return jsonResult({ task: "status", status: "not_found", sessionKey: validatedKey });
+                    }
+                    return jsonResult({ task: "status", status: "found", sessionKey: validatedKey, entry });
+                }
+                const all = deps.session.listSessionEntries();
+                const dispatches = all.filter((e) => e.key?.startsWith("ai-company:dispatch:"));
+                return jsonResult({
+                    task: "status",
+                    status: "list",
+                    count: dispatches.length,
+                    entries: dispatches,
+                });
+            }
+            catch (err) {
+                return jsonResult({
+                    task: "status",
+                    status: "error",
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        },
+    };
+}
+function makeResultTool(deps) {
+    return {
+        name: "ai_company_result",
+        label: "AI Company Result",
+        description: "Retrieve the result messages of a completed dispatch.",
+        parameters: ResultParams,
+        execute: async (_toolCallId, params) => {
+            const { sessionKey, limit = 50 } = params;
+            try {
+                const validatedKey = validateSessionKeyRequired(sessionKey);
+                const result = await deps.dispatchService.result(validatedKey, limit);
+                return jsonResult({ task: "result", ...result });
+            }
+            catch (err) {
+                return jsonResult({
+                    task: "result",
+                    status: "error",
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        },
+    };
+}
+export function createAiCompanyTools(deps) {
+    return [makeDispatchTool(deps), makeStatusTool(deps), makeResultTool(deps)];
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/tools.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,99 @@
+export interface SubagentRunParams {
+    sessionKey: string;
+    message: string;
+    deliver?: boolean;
+    worker?: string;
+    prompt?: string;
+    model?: string;
+}
+export interface SubagentRunResult {
+    runId: string;
+}
+export interface SubagentWaitParams {
+    runId: string;
+    timeoutMs?: number;
+}
+export interface SubagentWaitResult {
+    status: "ok" | "error" | "timeout";
+    error?: string;
+}
+export interface SubagentGetMessagesParams {
+    sessionKey: string;
+    limit?: number;
+}
+export interface SubagentGetMessagesResult {
+    messages: unknown[];
+}
+export interface SubagentApi {
+    run(params: SubagentRunParams): Promise<SubagentRunResult>;
+    waitForRun(params: SubagentWaitParams): Promise<SubagentWaitResult>;
+    getSessionMessages(params: SubagentGetMessagesParams): Promise<SubagentGetMessagesResult>;
+}
+export interface SessionEntry {
+    key?: string;
+    [k: string]: unknown;
+}
+export interface SessionApi {
+    getSessionEntry(params: {
+        sessionKey: string;
+    }): SessionEntry | undefined;
+    listSessionEntries(): SessionEntry[];
+}
+export interface DispatchOptions {
+    wait?: boolean;
+    timeout?: number;
+    limit?: number;
+    /** Worker identity to dispatch to. Validates against WorkerEngine. */
+    worker?: string;
+}
+export interface DispatchResult {
+    sessionKey: string;
+    runId: string;
+    status: "submitted" | "completed" | "timeout" | "error";
+    messages?: unknown[];
+    error?: string;
+    durationMs?: number;
+}
+export interface DispatchStatusEntry {
+    key?: string;
+    [k: string]: unknown;
+}
+export interface DispatchResultMessages {
+    sessionKey: string;
+    status: "ok" | "empty";
+    messageCount?: number;
+    messages?: unknown[];
+    error?: string;
+}
+export interface WorkboardGatewayApi {
+    isAvailable(): Promise<boolean>;
+    createCard(params: {
+        title: string;
+        description?: string;
+        status?: string;
+        priority?: string;
+        boardId?: string;
+        agentId?: string;
+    }): Promise<{
+        id: string;
+        [k: string]: unknown;
+    }>;
+    dispatchCards(): Promise<{
+        started: Array<{
+            cardId: string;
+            runId: string;
+            sessionKey: string;
+        }>;
+        startFailures: Array<{
+            cardId: string;
+            error: string;
+        }>;
+        count: number;
+    }>;
+}
+export interface WorkerFleetHealth {
+    loaded: string[];
+    skipped: string[];
+    failed: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,4 @@
+// Shared types for ai-engineering-company extension.
+// ponytail: import from SDK when stable subpath exists for subagent/session shapes
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mFAAmF"}

package/dist/src/validation.d.ts

@@ -0,0 +1,11 @@
+export declare class DispatchValidationError extends Error {
+    readonly code: string;
+    readonly field: string;
+    constructor(message: string, code: string, field: string);
+}
+export declare function validateMessage(message: unknown): string;
+export declare function validateSessionKey(sessionKey: unknown): string | undefined;
+export declare function validateTimeout(timeout: unknown): number;
+export declare function validateLimit(limit: unknown): number | undefined;
+export declare function validateSessionKeyRequired(sessionKey: unknown): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAUA,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,IAAI,EAAE,MAAM;aACZ,KAAK,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM;CAKhC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAqBxD;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAY1E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAaxD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAahE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAUtE"}

package/dist/src/validation.js

@@ -0,0 +1,69 @@
+// Input validation for ai-engineering-company dispatch operations.
+// Limits justified in Gate 0.6 architecture freeze.
+const MAX_MESSAGE_LENGTH = 128_000;
+const SESSION_KEY_PATTERN = /^ai-company:dispatch:\d{8}T\d{6}Z-[a-z0-9]{4}$/;
+const MIN_TIMEOUT = 1_000;
+const MAX_TIMEOUT = 900_000;
+const MIN_LIMIT = 1;
+const MAX_LIMIT = 100;
+export class DispatchValidationError extends Error {
+    code;
+    field;
+    constructor(message, code, field) {
+        super(message);
+        this.code = code;
+        this.field = field;
+        this.name = "DispatchValidationError";
+    }
+}
+export function validateMessage(message) {
+    if (typeof message !== "string" || message.length === 0) {
+        throw new DispatchValidationError("message is required", "INVALID_MESSAGE", "message");
+    }
+    if (message.length > MAX_MESSAGE_LENGTH) {
+        throw new DispatchValidationError(`message exceeds maximum length of ${MAX_MESSAGE_LENGTH} characters`, "INVALID_MESSAGE", "message");
+    }
+    // Block control characters except newline (U+000A)
+    // eslint-disable-next-line no-control-regex
+    if (/[\x00-\x09\x0b-\x1f]/.test(message)) {
+        throw new DispatchValidationError("message contains invalid control characters", "INVALID_MESSAGE", "message");
+    }
+    return message;
+}
+export function validateSessionKey(sessionKey) {
+    if (sessionKey === undefined || sessionKey === null) {
+        return undefined;
+    }
+    if (typeof sessionKey !== "string" || !SESSION_KEY_PATTERN.test(sessionKey)) {
+        throw new DispatchValidationError("sessionKey must match format ai-company:dispatch:YYYYMMDDTHHmmSSZ-xxxx", "INVALID_SESSION_KEY", "sessionKey");
+    }
+    return sessionKey;
+}
+export function validateTimeout(timeout) {
+    if (timeout === undefined || timeout === null) {
+        return MAX_TIMEOUT;
+    }
+    const num = typeof timeout === "string" ? Number(timeout) : timeout;
+    if (!Number.isFinite(num) || num < MIN_TIMEOUT || num > MAX_TIMEOUT) {
+        throw new DispatchValidationError(`timeout must be between ${MIN_TIMEOUT} and ${MAX_TIMEOUT}`, "INVALID_TIMEOUT", "timeout");
+    }
+    return num;
+}
+export function validateLimit(limit) {
+    if (limit === undefined || limit === null) {
+        return undefined;
+    }
+    const num = typeof limit === "string" ? Number(limit) : limit;
+    if (!Number.isFinite(num) || num < MIN_LIMIT || num > MAX_LIMIT || !Number.isInteger(num)) {
+        throw new DispatchValidationError(`limit must be an integer between ${MIN_LIMIT} and ${MAX_LIMIT}`, "INVALID_LIMIT", "limit");
+    }
+    return num;
+}
+export function validateSessionKeyRequired(sessionKey) {
+    const result = validateSessionKey(sessionKey);
+    if (result === undefined) {
+        throw new DispatchValidationError("sessionKey is required", "INVALID_SESSION_KEY", "sessionKey");
+    }
+    return result;
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/validation.js.map

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

package/dist/src/workboard-gateway.d.ts

@@ -0,0 +1,82 @@
+export type WorkboardPriority = "urgent" | "high" | "normal" | "low";
+export type WorkboardStatus = "triage" | "backlog" | "todo" | "ready" | "running" | "review" | "blocked" | "done";
+export interface WorkboardCard {
+    id: string;
+    title: string;
+    description?: string;
+    status: WorkboardStatus;
+    priority: WorkboardPriority;
+    position: number;
+    createdAt: number;
+    updatedAt: number;
+    agentId?: string;
+    metadata?: Record<string, unknown>;
+    execution?: {
+        status?: string;
+        sessionKey?: string;
+        runId?: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export interface WorkboardCreateCardParams {
+    title: string;
+    description?: string;
+    status?: WorkboardStatus;
+    priority?: WorkboardPriority;
+    boardId?: string;
+    agentId?: string;
+    [k: string]: unknown;
+}
+export interface WorkboardDispatchResult {
+    promoted: WorkboardCard[];
+    reclaimed: WorkboardCard[];
+    blocked: WorkboardCard[];
+    orchestrated: WorkboardCard[];
+    started: Array<{
+        cardId: string;
+        title: string;
+        sessionKey: string;
+        runId: string;
+    }>;
+    startFailures: Array<{
+        cardId: string;
+        title: string;
+        error: string;
+    }>;
+    count: number;
+    [k: string]: unknown;
+}
+export interface WorkboardBoard {
+    id: string;
+    name: string;
+    archived?: boolean;
+    [k: string]: unknown;
+}
+export interface GatewayClient {
+    callMethod(method: string, params: Record<string, unknown>): Promise<unknown>;
+}
+export interface WorkboardGatewayConfig {
+    gateway: GatewayClient;
+    boardId?: string;
+}
+export declare class WorkboardGateway {
+    private readonly gateway;
+    private readonly boardId;
+    constructor(config: WorkboardGatewayConfig);
+    /** Call a gateway method with a timeout guard. */
+    private callWithTimeout;
+    /** Check whether the workboard extension is available and responsive. */
+    isAvailable(): Promise<boolean>;
+    /** Ensure the default board exists. Idempotent. */
+    ensureBoard(): Promise<WorkboardBoard>;
+    /** Create a card in the workboard. */
+    createCard(params: WorkboardCreateCardParams): Promise<WorkboardCard>;
+    /** Trigger workboard dispatch — claims, starts subagents, manages lifecycle. */
+    dispatchCards(): Promise<WorkboardDispatchResult>;
+    /** List cards on the board, optionally filtered. */
+    listCards(): Promise<WorkboardCard[]>;
+    /** Get a specific card by ID. */
+    getCard(id: string): Promise<WorkboardCard | null>;
+}
+//# sourceMappingURL=workboard-gateway.d.ts.map

package/dist/src/workboard-gateway.d.ts.map

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

package/dist/src/workboard-gateway.js

@@ -0,0 +1,76 @@
+// Gateway RPC client for Workboard integration.
+// Calls workboard gateway methods via in-process RPC — no direct imports.
+// ponytail: if OpenClaw adds a typed gateway client SDK, replace this with it
+function unwrap(response) {
+    const r = response;
+    if (!r?.ok) {
+        throw new Error(r?.error?.message ?? "workboard gateway call failed");
+    }
+    return r.data ?? {};
+}
+// --- WorkboardGateway ---
+const RPC_TIMEOUT_MS = 30_000; // ponytail: make configurable if workboard extension adds latency tuning
+export class WorkboardGateway {
+    gateway;
+    boardId;
+    constructor(config) {
+        this.gateway = config.gateway;
+        this.boardId = config.boardId ?? "ai-company";
+    }
+    /** Call a gateway method with a timeout guard. */
+    async callWithTimeout(method, params) {
+        return Promise.race([
+            this.gateway.callMethod(method, params),
+            new Promise((_, reject) => {
+                setTimeout(() => reject(new Error(`RPC timeout: ${method} (${RPC_TIMEOUT_MS}ms)`)), RPC_TIMEOUT_MS);
+            }),
+        ]);
+    }
+    /** Check whether the workboard extension is available and responsive. */
+    async isAvailable() {
+        try {
+            const result = await this.callWithTimeout("workboard.boards.list", {});
+            const data = result;
+            return data?.ok === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Ensure the default board exists. Idempotent. */
+    async ensureBoard() {
+        const data = unwrap(await this.callWithTimeout("workboard.boards.upsert", {
+            id: this.boardId,
+            name: "AI Engineering Company",
+        }));
+        return data.board;
+    }
+    /** Create a card in the workboard. */
+    async createCard(params) {
+        const data = unwrap(await this.callWithTimeout("workboard.cards.create", {
+            ...params,
+            boardId: params.boardId ?? this.boardId,
+        }));
+        return data.card;
+    }
+    /** Trigger workboard dispatch — claims, starts subagents, manages lifecycle. */
+    async dispatchCards() {
+        const data = unwrap(await this.callWithTimeout("workboard.cards.dispatch", {
+            boardId: this.boardId,
+        }));
+        return data;
+    }
+    /** List cards on the board, optionally filtered. */
+    async listCards() {
+        const data = unwrap(await this.callWithTimeout("workboard.cards.list", {
+            boardId: this.boardId,
+        }));
+        return (data.cards ?? []);
+    }
+    /** Get a specific card by ID. */
+    async getCard(id) {
+        const cards = await this.listCards();
+        return cards.find((c) => c.id === id) ?? null;
+    }
+}
+//# sourceMappingURL=workboard-gateway.js.map

package/dist/src/workboard-gateway.js.map

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

package/dist/src/worker-engine.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import type { WorkerFleetHealth } from "./types.js";
+export declare const WorkerConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    office: z.ZodNullable<z.ZodString>;
+    description: z.ZodString;
+    capabilities: z.ZodArray<z.ZodString, "many">;
+    model: z.ZodString;
+    costPerHour: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    office: string | null;
+    capabilities: string[];
+    model: string;
+    costPerHour?: number | undefined;
+}, {
+    name: string;
+    description: string;
+    office: string | null;
+    capabilities: string[];
+    model: string;
+    costPerHour?: number | undefined;
+}>;
+export type WorkerConfig = z.infer<typeof WorkerConfigSchema>;
+export interface WorkerDefinition {
+    config: WorkerConfig;
+    prompt: string;
+}
+export declare class WorkerEngine {
+    private workersDir;
+    private workers;
+    constructor(workersDir: string);
+    load(): Promise<WorkerFleetHealth>;
+    getWorker(name: string): WorkerDefinition | undefined;
+    getWorkers(): WorkerDefinition[];
+}
+//# sourceMappingURL=worker-engine.d.ts.map

package/dist/src/worker-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-engine.d.ts","sourceRoot":"","sources":["../../src/worker-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAO7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAA4C;gBAE/C,UAAU,EAAE,MAAM;IAIxB,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAwDxC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIrD,UAAU,IAAI,gBAAgB,EAAE;CAGjC"}

package/dist/src/worker-engine.js

@@ -0,0 +1,73 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { z } from "zod";
+export const WorkerConfigSchema = z.object({
+    name: z.string(),
+    office: z.string().nullable(),
+    description: z.string(),
+    capabilities: z.array(z.string()),
+    model: z.string(),
+    costPerHour: z.number().optional(),
+});
+export class WorkerEngine {
+    workersDir;
+    workers = new Map();
+    constructor(workersDir) {
+        this.workersDir = workersDir;
+    }
+    async load() {
+        const health = { loaded: [], skipped: [], failed: [] };
+        try {
+            const entries = await fs.readdir(this.workersDir, { withFileTypes: true });
+            const dirs = entries.filter((e) => e.isDirectory());
+            for (const dir of dirs) {
+                const workerName = dir.name;
+                const workerPath = path.join(this.workersDir, workerName);
+                const configPath = path.join(workerPath, "config.json");
+                const promptPath = path.join(workerPath, "prompt.md");
+                try {
+                    const configRaw = await fs.readFile(configPath, "utf-8");
+                    let configObj;
+                    try {
+                        configObj = JSON.parse(configRaw);
+                    }
+                    catch {
+                        health.failed.push(workerName);
+                        continue;
+                    }
+                    // Empty object → skip silently (empty config)
+                    if (typeof configObj === "object" &&
+                        configObj !== null &&
+                        Object.keys(configObj).length === 0) {
+                        health.skipped.push(workerName);
+                        continue;
+                    }
+                    const config = WorkerConfigSchema.parse(configObj);
+                    let prompt = "";
+                    try {
+                        prompt = await fs.readFile(promptPath, "utf-8");
+                    }
+                    catch {
+                        // prompt.md missing is acceptable
+                    }
+                    this.workers.set(config.name, { config, prompt });
+                    health.loaded.push(config.name);
+                }
+                catch {
+                    health.failed.push(workerName);
+                }
+            }
+        }
+        catch {
+            // readdir or path failure — return partial health
+        }
+        return health;
+    }
+    getWorker(name) {
+        return this.workers.get(name);
+    }
+    getWorkers() {
+        return Array.from(this.workers.values());
+    }
+}
+//# sourceMappingURL=worker-engine.js.map

package/dist/src/worker-engine.js.map

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

package/dist/task-state.d.ts

@@ -0,0 +1,27 @@
+import type { DispatchResult } from "./types.js";
+export declare const TASK_STATES: readonly ["created", "submitted", "running", "awaiting_approval", "completed", "failed"];
+export type TaskState = (typeof TASK_STATES)[number];
+export interface TaskStateEntry {
+    state: TaskState;
+    sessionKey: string;
+    worker?: string;
+    startedAt: number;
+    updatedAt: number;
+    /** Retain the last dispatch result so callers can read outcome without re-fetching. */
+    lastResult?: DispatchResult;
+}
+export declare class TaskStateManager {
+    /** ponytail: Map grows unbounded — add TTL sweep if dispatch volume is high. */
+    private readonly tasks;
+    /** Create a new task in CREATED state. Returns the entry (caller mutates via transition). */
+    create(sessionKey: string, worker?: string): TaskStateEntry;
+    /** Advance task to the next state. Returns null if the transition is invalid. */
+    transition(sessionKey: string, to: TaskState, result?: DispatchResult): TaskStateEntry | null;
+    /** Look up a task by sessionKey. */
+    get(sessionKey: string): TaskStateEntry | undefined;
+    /** Return all tasks matching a state filter. */
+    list(filter?: TaskState): TaskStateEntry[];
+    /** Remove a task from tracking (cleanup, not persistence). */
+    remove(sessionKey: string): boolean;
+}
+//# sourceMappingURL=task-state.d.ts.map

package/dist/task-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-state.d.ts","sourceRoot":"","sources":["../src/task-state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,eAAO,MAAM,WAAW,0FAA2F,CAAC;AACpH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAcD,qBAAa,gBAAgB;IAC3B,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,6FAA6F;IAC7F,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc;IAa3D,iFAAiF;IACjF,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,GAAG,IAAI;IAmB7F,oCAAoC;IACpC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInD,gDAAgD;IAChD,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,cAAc,EAAE;IAK1C,8DAA8D;IAC9D,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAGpC"}