@superblocksteam/vite-plugin-file-sync 2.0.129 → 2.0.130-next.0

package/dist/ai-service/tasks/poll-loop.d.ts

@@ -0,0 +1,55 @@
+import { type TaskStatus, type TaskType } from "./types.js";
+/**
+ * Clock abstraction used by the poll loop. The real clock wraps
+ * `Date.now` and `setTimeout`; `test-utils.ts` provides a deterministic
+ * `FakeClock` for tests.
+ */
+export interface PollClock {
+    now: () => number;
+    sleep: (ms: number, signal?: AbortSignal) => Promise<void>;
+}
+export interface RunPollLoopOptions<H, R> {
+    type: Pick<TaskType<unknown, H, R>, "poll" | "pollSchedule">;
+    handle: H;
+    signal: AbortSignal;
+    clock: PollClock;
+    /**
+     * Returns the jitter delta (in ms) to add to the current scheduled
+     * wait. Receives the current backoff window so the perturbation
+     * scales proportionally (the production default is ±10% of the
+     * incoming wait). Tests pass `() => 0` for determinism; the
+     * argument is intentionally optional from the caller's perspective
+     * so existing zero-arg test fixtures keep type-checking.
+     */
+    jitter: (currentWaitMs: number) => number;
+    /**
+     * Called exactly once per poll attempt — both with intermediate
+     * `running` updates and with the final terminal status.
+     */
+    onStatus: (status: TaskStatus<R>) => void;
+}
+/**
+ * Single-task polling loop with exponential backoff and jitter.
+ *
+ * Sleeps `schedule.initialMs` (+ jitter) before the first poll, then
+ * doubles the wait by `schedule.factor` after each `running` reply, up
+ * to `schedule.maxMs`. Exits as soon as `signal` aborts or `poll` reports
+ * a non-running status. Poll exceptions are wrapped as a `failed`
+ * terminal status and reported through `onStatus`.
+ */
+export declare function runPollLoop<H, R>(opts: RunPollLoopOptions<H, R>): Promise<void>;
+/**
+ * Real-clock implementation for production. Honors abort by listening on
+ * the signal and rejecting the in-flight sleep early.
+ */
+export declare const realClock: PollClock;
+/**
+ * Default jitter implementation — perturbs the next wait by ±10% so a
+ * fleet of identically-scheduled tasks doesn't all hammer the external
+ * system in lockstep. Designed to be assigned directly as the
+ * `TaskStoreOptions.jitter` callback (no curried wrapper); the previous
+ * `defaultJitter(0)` initialization captured a zero baseline that
+ * silently disabled jitter forever.
+ */
+export declare function defaultJitter(currentWaitMs: number): number;
+//# sourceMappingURL=poll-loop.d.ts.map

package/dist/ai-service/tasks/poll-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-loop.d.ts","sourceRoot":"","sources":["../../../src/ai-service/tasks/poll-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,EAAE,CAAC;IACtC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC;IAC7D,MAAM,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB;;;;;;;OAOG;IACH,MAAM,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C;;;OAGG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EACpC,IAAI,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,SAkBvB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/ai-service/tasks/poll-loop.js

@@ -0,0 +1,73 @@
+import { DEFAULT_POLL_SCHEDULE, } from "./types.js";
+/**
+ * Single-task polling loop with exponential backoff and jitter.
+ *
+ * Sleeps `schedule.initialMs` (+ jitter) before the first poll, then
+ * doubles the wait by `schedule.factor` after each `running` reply, up
+ * to `schedule.maxMs`. Exits as soon as `signal` aborts or `poll` reports
+ * a non-running status. Poll exceptions are wrapped as a `failed`
+ * terminal status and reported through `onStatus`.
+ */
+export async function runPollLoop(opts) {
+    const schedule = opts.type.pollSchedule ?? DEFAULT_POLL_SCHEDULE;
+    let wait = schedule.initialMs;
+    while (true) {
+        if (opts.signal.aborted)
+            return;
+        try {
+            await opts.clock.sleep(wait + opts.jitter(wait), opts.signal);
+        }
+        catch {
+            return;
+        }
+        if (opts.signal.aborted)
+            return;
+        let status;
+        try {
+            status = await opts.type.poll(opts.handle, opts.signal);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err ?? "unknown error");
+            opts.onStatus({ state: "failed", error: message });
+            return;
+        }
+        opts.onStatus(status);
+        if (status.state !== "running")
+            return;
+        wait = Math.min(schedule.maxMs, wait * schedule.factor);
+    }
+}
+/**
+ * Real-clock implementation for production. Honors abort by listening on
+ * the signal and rejecting the in-flight sleep early.
+ */
+export const realClock = {
+    now: () => Date.now(),
+    sleep: (ms, signal) => new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new DOMException("Aborted", "AbortError"));
+            return;
+        }
+        const t = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(t);
+            reject(new DOMException("Aborted", "AbortError"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    }),
+};
+/**
+ * Default jitter implementation — perturbs the next wait by ±10% so a
+ * fleet of identically-scheduled tasks doesn't all hammer the external
+ * system in lockstep. Designed to be assigned directly as the
+ * `TaskStoreOptions.jitter` callback (no curried wrapper); the previous
+ * `defaultJitter(0)` initialization captured a zero baseline that
+ * silently disabled jitter forever.
+ */
+export function defaultJitter(currentWaitMs) {
+    return (Math.random() * 0.2 - 0.1) * currentWaitMs;
+}
+//# sourceMappingURL=poll-loop.js.map

package/dist/ai-service/tasks/poll-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-loop.js","sourceRoot":"","sources":["../../../src/ai-service/tasks/poll-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAItB,MAAM,YAAY,CAAC;AAiCpB;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAA8B;IAE9B,MAAM,QAAQ,GACZ,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,qBAAqB,CAAC;IAClD,IAAI,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC;IAE9B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAEhC,IAAI,MAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,eAAe,CAAC,CAAC;YACtE,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO;QAEvC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CACpB,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC;CACL,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,aAAqB;IACjD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,aAAa,CAAC;AACrD,CAAC"}

package/dist/ai-service/tasks/task-store.d.ts

@@ -0,0 +1,106 @@
+import type { ToolExecutionOptions } from "ai";
+import { type PollClock } from "./poll-loop.js";
+import type { BackgroundTaskSummary, RunningTask, TaskStatus, TaskType } from "./types.js";
+/**
+ * Listener called whenever a task's state, message, result, or error
+ * changes. The same callback fires for the initial in-store snapshot
+ * after `start()` and for every poll update afterwards.
+ *
+ * Listeners must not throw — exceptions are caught and dropped.
+ */
+export type TaskStatusListener = (taskId: string, status: TaskStatus<unknown>, task: RunningTask) => void;
+export interface TaskStoreOptions {
+    /** Clock used by all poll loops. Defaults to wall-clock + `setTimeout`. */
+    clock?: PollClock;
+    /**
+     * Jitter generator (see poll-loop). Defaults to `defaultJitter` —
+     * a ±10% perturbation of the current backoff window. Tests typically
+     * pass `() => 0` for determinism.
+     */
+    jitter?: (currentWaitMs: number) => number;
+    /** ID generator (defaults to ULID). Injected for deterministic tests. */
+    generateId?: () => string;
+}
+/**
+ * Per-session registry + lifecycle owner for background tasks.
+ *
+ * Owns:
+ *   - The registered `TaskType` table (`register` / `getType`).
+ *   - The in-memory `Map<taskId, RunningTask>` of live + recently-finished tasks.
+ *   - One `AbortController` per task that drives the loop.
+ *   - Status change subscribers (peer push, in-memory `waitFor`).
+ *
+ * Does NOT yet handle:
+ *   - On-disk persistence — that lives in `persistence.ts` and wraps the store.
+ *   - Peer push or `<background_tasks>` block — those subscribe to `onStatus`.
+ *
+ * Cancellation:
+ *   - `cancel(taskId)` aborts the loop, calls `type.cancel?.()`, emits
+ *     `{ state: "cancelled" }`. Errors from `type.cancel` are logged and
+ *     swallowed so cancellation always succeeds locally.
+ *   - `cancelAll()` cancels every currently-running task.
+ *   - `dispose()` aborts all loops without changing task state — used on
+ *     FSM teardown so a restart can rehydrate the same on-disk records.
+ */
+export declare class TaskStore {
+    private readonly clock;
+    private readonly jitter;
+    private readonly generateId;
+    private readonly types;
+    private readonly tasks;
+    private readonly controllers;
+    private readonly listeners;
+    private disposed;
+    constructor(options?: TaskStoreOptions);
+    register<I, H, R>(type: TaskType<I, H, R>): void;
+    getType(name: string): TaskType<unknown, unknown, unknown> | undefined;
+    /**
+     * Start a new task of the given type. Returns the generated `taskId`
+     * and the type's `initialStatus` (or `{ state: "running" }` if absent).
+     *
+     * `ownerUserId` is optional metadata that gets stored on the task so
+     * the LLM-facing read tools can filter cross-user access (see
+     * `isTaskAccessibleTo`). Pass the JWT-derived userId when authentic.
+     */
+    start<I>(typeName: string, input: I, opts: ToolExecutionOptions, options?: {
+        ownerUserId?: string;
+    }): Promise<{
+        taskId: string;
+        initialStatus: TaskStatus<unknown>;
+        label?: string;
+    }>;
+    get(taskId: string): RunningTask | undefined;
+    list(): RunningTask[];
+    hasActiveTasks(): boolean;
+    /**
+     * Abort the task's poll loop, call `type.cancel` if defined, mark the
+     * task as cancelled, and fire one cancelled status event. Safe to call
+     * on already-terminal tasks (no-op).
+     */
+    cancel(taskId: string): Promise<void>;
+    cancelAll(): Promise<void>;
+    /**
+     * Resolves with the terminal status as soon as the task leaves
+     * `running` state. Rejects with a TimeoutError after `timeoutMs` if
+     * the task is still running.
+     */
+    waitFor(taskId: string, timeoutMs: number): Promise<TaskStatus<unknown>>;
+    /**
+     * Register a listener for task status changes. Returns an unsubscribe
+     * function.
+     */
+    onStatus(listener: TaskStatusListener): () => void;
+    /** Aborts every in-flight loop without changing task state. */
+    dispose(): void;
+    /**
+     * Summary used by the peer push and the `<background_tasks>` block.
+     * Never includes `result`.
+     */
+    summarize(task: RunningTask): BackgroundTaskSummary;
+    private spawnPollLoop;
+    private applyStatus;
+    private emit;
+    private snapshotStatus;
+}
+export declare function generateUlid(now?: number, random?: () => number): string;
+//# sourceMappingURL=task-store.d.ts.map

package/dist/ai-service/tasks/task-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-store.d.ts","sourceRoot":"","sources":["../../../src/ai-service/tasks/task-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,IAAI,CAAC;AAE/C,OAAO,EAEL,KAAK,SAAS,EAGf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,qBAAqB,EACrB,WAAW,EAEX,UAAU,EACV,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAC3B,IAAI,EAAE,WAAW,KACd,IAAI,CAAC;AAEV,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGlB;IACJ,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE,gBAAqB;IAM1C,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAIhD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS;IAItE;;;;;;;OAOG;IACG,KAAK,CAAC,CAAC,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GACrC,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAoDF,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI5C,IAAI,IAAI,WAAW,EAAE;IAIrB,cAAc,IAAI,OAAO;IAOzB;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBrC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAOhC;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAiCxE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAKlD,+DAA+D;IAC/D,OAAO,IAAI,IAAI;IAOf;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,qBAAqB;YAiBrC,aAAa;IAqB3B,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,cAAc;CAYvB;AAUD,wBAAgB,YAAY,CAAC,GAAG,SAAa,EAAE,MAAM,eAAc,GAAG,MAAM,CAY3E"}

package/dist/ai-service/tasks/task-store.js

@@ -0,0 +1,292 @@
+import { defaultJitter, realClock, runPollLoop, } from "./poll-loop.js";
+/**
+ * Per-session registry + lifecycle owner for background tasks.
+ *
+ * Owns:
+ *   - The registered `TaskType` table (`register` / `getType`).
+ *   - The in-memory `Map<taskId, RunningTask>` of live + recently-finished tasks.
+ *   - One `AbortController` per task that drives the loop.
+ *   - Status change subscribers (peer push, in-memory `waitFor`).
+ *
+ * Does NOT yet handle:
+ *   - On-disk persistence — that lives in `persistence.ts` and wraps the store.
+ *   - Peer push or `<background_tasks>` block — those subscribe to `onStatus`.
+ *
+ * Cancellation:
+ *   - `cancel(taskId)` aborts the loop, calls `type.cancel?.()`, emits
+ *     `{ state: "cancelled" }`. Errors from `type.cancel` are logged and
+ *     swallowed so cancellation always succeeds locally.
+ *   - `cancelAll()` cancels every currently-running task.
+ *   - `dispose()` aborts all loops without changing task state — used on
+ *     FSM teardown so a restart can rehydrate the same on-disk records.
+ */
+export class TaskStore {
+    clock;
+    jitter;
+    generateId;
+    types = new Map();
+    tasks = new Map();
+    controllers = new Map();
+    listeners = new Set();
+    disposed = false;
+    constructor(options = {}) {
+        this.clock = options.clock ?? realClock;
+        this.jitter = options.jitter ?? defaultJitter;
+        this.generateId = options.generateId ?? generateUlid;
+    }
+    register(type) {
+        this.types.set(type.name, type);
+    }
+    getType(name) {
+        return this.types.get(name);
+    }
+    /**
+     * Start a new task of the given type. Returns the generated `taskId`
+     * and the type's `initialStatus` (or `{ state: "running" }` if absent).
+     *
+     * `ownerUserId` is optional metadata that gets stored on the task so
+     * the LLM-facing read tools can filter cross-user access (see
+     * `isTaskAccessibleTo`). Pass the JWT-derived userId when authentic.
+     */
+    async start(typeName, input, opts, options = {}) {
+        if (this.disposed) {
+            throw new Error("TaskStore disposed");
+        }
+        const type = this.types.get(typeName);
+        if (!type) {
+            throw new Error(`unknown task type: ${typeName}`);
+        }
+        const startResult = (await type.start(input, opts));
+        const initialStatus = startResult.initialStatus ?? {
+            state: "running",
+        };
+        const taskId = this.generateId();
+        const task = {
+            taskId,
+            taskType: typeName,
+            externalHandle: startResult.externalHandle,
+            label: startResult.label,
+            startedAt: new Date(this.clock.now()).toISOString(),
+            state: initialStatus.state,
+            message: "message" in initialStatus ? initialStatus.message : undefined,
+            result: initialStatus.state === "completed"
+                ? initialStatus.result
+                : undefined,
+            error: initialStatus.state === "failed"
+                ? initialStatus.error
+                : undefined,
+            ownerUserId: options.ownerUserId,
+        };
+        this.tasks.set(taskId, task);
+        this.emit(taskId, initialStatus, task);
+        // Already-terminal initialStatus → no poll loop needed.
+        if (initialStatus.state === "running") {
+            const controller = new AbortController();
+            this.controllers.set(taskId, controller);
+            void this.spawnPollLoop(taskId, type, controller);
+        }
+        return {
+            taskId,
+            initialStatus,
+            label: startResult.label,
+        };
+    }
+    get(taskId) {
+        return this.tasks.get(taskId);
+    }
+    list() {
+        return [...this.tasks.values()];
+    }
+    hasActiveTasks() {
+        for (const task of this.tasks.values()) {
+            if (task.state === "running")
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Abort the task's poll loop, call `type.cancel` if defined, mark the
+     * task as cancelled, and fire one cancelled status event. Safe to call
+     * on already-terminal tasks (no-op).
+     */
+    async cancel(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task || task.state !== "running")
+            return;
+        const controller = this.controllers.get(taskId);
+        controller?.abort();
+        this.controllers.delete(taskId);
+        const type = this.types.get(task.taskType);
+        if (type?.cancel) {
+            try {
+                await type.cancel(task.externalHandle);
+            }
+            catch {
+                // Best-effort; loop is already aborted locally regardless.
+            }
+        }
+        const status = { state: "cancelled" };
+        this.applyStatus(taskId, status);
+    }
+    async cancelAll() {
+        const ids = [...this.tasks.entries()]
+            .filter(([, t]) => t.state === "running")
+            .map(([id]) => id);
+        await Promise.all(ids.map((id) => this.cancel(id)));
+    }
+    /**
+     * Resolves with the terminal status as soon as the task leaves
+     * `running` state. Rejects with a TimeoutError after `timeoutMs` if
+     * the task is still running.
+     */
+    waitFor(taskId, timeoutMs) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return Promise.reject(new Error(`unknown task: ${taskId}`));
+        }
+        if (task.state !== "running") {
+            return Promise.resolve(this.snapshotStatus(task));
+        }
+        return new Promise((resolve, reject) => {
+            const onStatus = (id, status) => {
+                if (id !== taskId)
+                    return;
+                if (status.state === "running")
+                    return;
+                cleanup();
+                resolve(status);
+            };
+            const timeoutAbort = new AbortController();
+            const cleanup = () => {
+                this.listeners.delete(onStatus);
+                timeoutAbort.abort();
+            };
+            this.listeners.add(onStatus);
+            this.clock
+                .sleep(timeoutMs, timeoutAbort.signal)
+                .then(() => {
+                cleanup();
+                reject(new Error(`timeout waiting for task ${taskId}`));
+            })
+                .catch(() => {
+                // Aborted by cleanup() — terminal status already delivered.
+            });
+        });
+    }
+    /**
+     * Register a listener for task status changes. Returns an unsubscribe
+     * function.
+     */
+    onStatus(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** Aborts every in-flight loop without changing task state. */
+    dispose() {
+        this.disposed = true;
+        for (const controller of this.controllers.values())
+            controller.abort();
+        this.controllers.clear();
+        this.listeners.clear();
+    }
+    /**
+     * Summary used by the peer push and the `<background_tasks>` block.
+     * Never includes `result`.
+     */
+    summarize(task) {
+        const startedAtMs = Date.parse(task.startedAt);
+        return {
+            taskId: task.taskId,
+            taskType: task.taskType,
+            label: task.label,
+            state: task.state,
+            message: task.message,
+            ageMs: Math.max(0, this.clock.now() - startedAtMs),
+            completedAt: task.state === "running"
+                ? undefined
+                : new Date(this.clock.now()).toISOString(),
+            error: task.error,
+        };
+    }
+    async spawnPollLoop(taskId, type, controller) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        try {
+            await runPollLoop({
+                type,
+                handle: task.externalHandle,
+                signal: controller.signal,
+                clock: this.clock,
+                jitter: this.jitter,
+                onStatus: (status) => this.applyStatus(taskId, status),
+            });
+        }
+        finally {
+            this.controllers.delete(taskId);
+        }
+    }
+    applyStatus(taskId, status) {
+        if (this.disposed)
+            return;
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        if (task.state !== "running")
+            return; // already terminal, ignore late updates
+        task.state = status.state;
+        task.message = "message" in status ? status.message : task.message;
+        task.result =
+            status.state === "completed"
+                ? status.result
+                : undefined;
+        task.error =
+            status.state === "failed"
+                ? status.error
+                : undefined;
+        this.emit(taskId, status, task);
+    }
+    emit(taskId, status, task) {
+        for (const listener of this.listeners) {
+            try {
+                listener(taskId, status, task);
+            }
+            catch {
+                // Listener must not break the loop.
+            }
+        }
+    }
+    snapshotStatus(task) {
+        switch (task.state) {
+            case "running":
+                return { state: "running", message: task.message };
+            case "completed":
+                return { state: "completed", result: task.result };
+            case "failed":
+                return { state: "failed", error: task.error ?? "unknown error" };
+            case "cancelled":
+                return { state: "cancelled" };
+        }
+    }
+}
+/**
+ * ULID generator (Crockford base32, 26 chars). Lexically sortable; no
+ * dependency added. Not collision-free under heavy concurrent use within
+ * the same millisecond, but more than sufficient for human-scale task
+ * spawns.
+ */
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+export function generateUlid(now = Date.now(), random = Math.random) {
+    let ts = now;
+    const tsChars = [];
+    for (let i = 0; i < 10; i++) {
+        tsChars.unshift(CROCKFORD[ts % 32]);
+        ts = Math.floor(ts / 32);
+    }
+    let randomPart = "";
+    for (let i = 0; i < 16; i++) {
+        randomPart += CROCKFORD[Math.floor(random() * 32)];
+    }
+    return tsChars.join("") + randomPart;
+}
+//# sourceMappingURL=task-store.js.map

package/dist/ai-service/tasks/task-store.js.map

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

package/dist/ai-service/tasks/test-utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Test-only helpers for the tasks subsystem. Not exported from index;
+ * production code must not import from here.
+ */
+/**
+ * Deterministic clock used by `task-store.test.ts` and `poll-loop.test.ts`.
+ *
+ * Tests advance time by calling `tick(ms)`. Any `sleep` waiters whose
+ * deadline has passed resolve synchronously after the tick, in deadline
+ * order, in microtasks (`Promise.resolve().then(...)`), so test code can
+ * `await` between ticks without flushing setImmediate / process.nextTick.
+ *
+ * Aborting the supplied signal rejects the waiter with the standard
+ * `DOMException` of name "AbortError", matching the runtime behavior we
+ * need from the real clock.
+ */
+export interface FakeClock {
+    now: () => number;
+    sleep: (ms: number, signal?: AbortSignal) => Promise<void>;
+    tick: (ms: number) => Promise<void>;
+}
+export declare function createFakeClock(initialNow?: number): FakeClock;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/ai-service/tasks/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/ai-service/tasks/test-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,wBAAgB,eAAe,CAAC,UAAU,SAAI,GAAG,SAAS,CAoDzD"}

package/dist/ai-service/tasks/test-utils.js

@@ -0,0 +1,53 @@
+/**
+ * Test-only helpers for the tasks subsystem. Not exported from index;
+ * production code must not import from here.
+ */
+export function createFakeClock(initialNow = 0) {
+    let current = initialNow;
+    const waiters = [];
+    const settle = async () => {
+        while (true) {
+            waiters.sort((a, b) => a.deadline - b.deadline);
+            const next = waiters[0];
+            if (!next || next.deadline > current)
+                return;
+            waiters.shift();
+            next.cleanup();
+            next.resolve();
+            await Promise.resolve();
+        }
+    };
+    return {
+        now: () => current,
+        sleep: (ms, signal) => new Promise((resolve, reject) => {
+            if (signal?.aborted) {
+                reject(new DOMException("Aborted", "AbortError"));
+                return;
+            }
+            const deadline = current + ms;
+            const entry = {
+                deadline,
+                resolve,
+                reject,
+                cleanup: () => {
+                    if (onAbort)
+                        signal?.removeEventListener("abort", onAbort);
+                },
+            };
+            const onAbort = () => {
+                const idx = waiters.indexOf(entry);
+                if (idx >= 0)
+                    waiters.splice(idx, 1);
+                entry.cleanup();
+                reject(new DOMException("Aborted", "AbortError"));
+            };
+            signal?.addEventListener("abort", onAbort, { once: true });
+            waiters.push(entry);
+        }),
+        tick: async (ms) => {
+            current += ms;
+            await settle();
+        },
+    };
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/ai-service/tasks/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../../../src/ai-service/tasks/test-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,MAAM,UAAU,eAAe,CAAC,UAAU,GAAG,CAAC;IAC5C,IAAI,OAAO,GAAG,UAAU,CAAC;IACzB,MAAM,OAAO,GAKR,EAAE,CAAC;IAER,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACxB,OAAO,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,GAAG,OAAO;gBAAE,OAAO;YAC7C,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO;QAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CACpB,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YACD,MAAM,QAAQ,GAAG,OAAO,GAAG,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG;gBACZ,QAAQ;gBACR,OAAO;gBACP,MAAM;gBACN,OAAO,EAAE,GAAG,EAAE;oBACZ,IAAI,OAAO;wBAAE,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7D,CAAC;aACF,CAAC;YACF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACnC,IAAI,GAAG,IAAI,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACrC,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;YACpD,CAAC,CAAC;YACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC;QACJ,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACjB,OAAO,IAAI,EAAE,CAAC;YACd,MAAM,MAAM,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}