@duetso/agent 0.2.1 → 0.2.3

package/dist/src/tasks/task-manager.d.ts

@@ -0,0 +1,101 @@
+import type { RuntimeClock } from "../turn-runner/runtime-clock.js";
+import { type PendingWork } from "./quiescence.js";
+import type { ScopeId, TaskDescriptor, TaskEvent, TaskId, TaskSettlement, TaskSnapshot, TaskStopReason } from "./types.js";
+/** Runtime hooks available to an in-process task executor. */
+export interface TaskExecutionContext {
+    /** Stable identity allocated before this executor starts. */
+    taskId: TaskId;
+    /** Aborted exactly once by task_stop, interrupt, or scope closure. */
+    signal: AbortSignal;
+    /** Append an ordered chunk to the task's retained output. */
+    onOutput(chunk: string): void;
+    /** Read the caller's reason when classifying an abort outcome. */
+    stopReason(): TaskStopReason | undefined;
+}
+interface TaskOwnership {
+    /** Scope that owns the task and is responsible for closing it. */
+    ownerScopeId: ScopeId;
+    /** Parent of a newly encountered scope; omitted only for a root scope. */
+    parentScopeId?: ScopeId;
+}
+/** Specification for work that begins executing immediately. */
+export interface InProcessTaskSpec<T = unknown> extends TaskOwnership {
+    /** Selects the executor family for listings and downstream presentation. */
+    kind: "tool" | "subagent";
+    /** Stable machine-facing name for the operation. */
+    name: string;
+    /** Human-facing description of this invocation. */
+    label: string;
+    /** Run the task; rejection is observed and converted into a failed settlement. */
+    execute(context: TaskExecutionContext): Promise<T>;
+}
+/** Specification for durable wall-clock work with no in-process executor. */
+export interface ScheduledTaskSpec extends TaskOwnership {
+    /** Marks the task as durable wall-clock work rather than an active process. */
+    kind: "scheduled";
+    /** Stable machine-facing name for the scheduled operation. */
+    name: string;
+    /** Human-facing description of what will resume. */
+    label: string;
+    /** Unix-epoch timestamp used by the quiescence decider. */
+    wakeAt: number;
+}
+export type TaskSpec<T = unknown> = InProcessTaskSpec<T> | ScheduledTaskSpec;
+/** Opaque start result used to race only the task selected for foreground delivery. */
+export interface TaskHandle {
+    readonly id: TaskId;
+}
+export type ForegroundRaceResult = {
+    kind: "settled";
+    settlement: TaskSettlement;
+} | {
+    kind: "still_running";
+    task: TaskSnapshot;
+};
+export type TaskReaper = (reason: TaskStopReason) => void | Promise<void>;
+export interface TaskManagerOptions {
+    /** Injected owner of time and timers, allowing lifecycle races without real sleeps. */
+    clock: RuntimeClock;
+    /** Receives ordered lifecycle changes without owning settlement delivery. */
+    onEvent?: (event: TaskEvent) => void;
+}
+export interface RecoverResult {
+    /** Previously running tasks that cannot exist in this process and were marked lost. */
+    lost: readonly TaskDescriptor[];
+}
+export interface TaskManager {
+    /** Register a child scope before work begins so depth is rejected at the executor boundary. */
+    openScope(scopeId: ScopeId, parentScopeId?: ScopeId): void;
+    /** Allocate an id and either spawn in-process work or record a schedule. */
+    start<T>(spec: TaskSpec<T>): TaskHandle;
+    /** Wait through a foreground budget without aborting on expiry. */
+    raceForeground(handle: TaskHandle, budgetMs: number): Promise<ForegroundRaceResult>;
+    /** Return descriptor copies, optionally restricted to their exact owner scope. */
+    list(scopeId?: string): readonly TaskDescriptor[];
+    /** Inspect retained output and terminal values without consuming settlement delivery. */
+    output(id: TaskId): TaskSnapshot | undefined;
+    /** Observe a task or the next task settling, optionally bounded by a clock-driven wait. */
+    waitForSettlement(id?: TaskId, waitMs?: number): Promise<TaskSnapshot | undefined>;
+    /** Pull the oldest undelivered settlement; this is the only consuming operation. */
+    nextSettled(): TaskSettlement | undefined;
+    /** Abort a task once and resolve only after its executor has fully unwound. */
+    stop(id: TaskId, reason: TaskStopReason): Promise<TaskSnapshot | undefined>;
+    /** Stop descendant scopes before directly owned tasks and await every unwind. */
+    closeScope(scopeId: ScopeId, reason: TaskStopReason): Promise<void>;
+    /** Abort all active and scheduled work, reap processes, and await full unwind. */
+    interruptAll(reason: TaskStopReason): Promise<void>;
+    /** Compute the current quiescence posture from task descriptors. */
+    pendingWork(): PendingWork;
+    /** Hydrate descriptors, converting process-bound running work to lost settlements. */
+    recover(descriptors: readonly TaskDescriptor[], nextTaskId?: number, outputTails?: Readonly<Partial<Record<TaskId, readonly string[]>>>): RecoverResult;
+    /** Return the numeric suffix that the next start() call will allocate. */
+    nextTaskId(): number;
+    /** Register process cleanup to run once at the next reap boundary. */
+    registerReaper(reaper: TaskReaper): () => void;
+    /** Invoke and drain all currently registered process cleanup callbacks. */
+    reapAll(reason: TaskStopReason): Promise<void>;
+}
+/** Create the single owner of task lifecycle and settlement delivery. */
+export declare function createTaskManager(options: TaskManagerOptions): TaskManager;
+export {};
+//# sourceMappingURL=task-manager.d.ts.map

package/dist/src/tasks/task-manager.d.ts.map

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

package/dist/src/tasks/task-manager.js

@@ -0,0 +1,311 @@
+import { computePendingWork } from "./quiescence.js";
+const MAX_SCOPE_DEPTH = 2;
+/** Create the single owner of task lifecycle and settlement delivery. */
+export function createTaskManager(options) {
+    const records = new Map();
+    const scopes = new Map();
+    const settlements = [];
+    const settlementWaiters = new Set();
+    const reapers = new Set();
+    let nextTaskNumber = 1;
+    const copyDescriptor = (descriptor) => ({ ...descriptor });
+    const snapshot = (record) => ({
+        descriptor: copyDescriptor(record.descriptor),
+        output: [...record.output],
+        ...(record.settlement ? { settlement: record.settlement } : {}),
+    });
+    const emit = (event) => options.onEvent?.(event);
+    const registerScope = (ownerScopeId, parentScopeId) => {
+        const existing = scopes.get(ownerScopeId);
+        if (existing) {
+            if (existing.parentScopeId !== parentScopeId && parentScopeId !== undefined) {
+                throw new Error(`Scope ${ownerScopeId} already has a different parent`);
+            }
+            if (existing.closed)
+                throw new Error(`Scope ${ownerScopeId} is closed`);
+            return existing;
+        }
+        let depth = 0;
+        if (parentScopeId !== undefined) {
+            const parent = scopes.get(parentScopeId);
+            if (!parent)
+                throw new Error(`Parent scope ${parentScopeId} must be registered first`);
+            if (parent.closed)
+                throw new Error(`Parent scope ${parentScopeId} is closed`);
+            depth = parent.depth + 1;
+        }
+        if (depth > MAX_SCOPE_DEPTH) {
+            throw new RangeError(`Task scope depth ${depth} exceeds maximum ${MAX_SCOPE_DEPTH}`);
+        }
+        const scope = {
+            id: ownerScopeId,
+            ...(parentScopeId === undefined ? {} : { parentScopeId }),
+            depth,
+            closed: false,
+        };
+        scopes.set(ownerScopeId, scope);
+        return scope;
+    };
+    const createRecord = (descriptor, abortController) => {
+        let resolveFinished;
+        const finished = new Promise((resolve) => {
+            resolveFinished = resolve;
+        });
+        return {
+            descriptor,
+            output: [],
+            ...(abortController ? { abortController } : {}),
+            finished,
+            resolveFinished,
+        };
+    };
+    const settle = (record, settlement) => {
+        if (record.settlement)
+            return record.settlement;
+        record.settlement = settlement;
+        record.descriptor = { ...record.descriptor, status: settlement.status };
+        settlements.push(settlement);
+        record.resolveFinished(settlement);
+        emit({ type: "settled", settlement });
+        for (const notify of settlementWaiters)
+            notify(settlement);
+        return settlement;
+    };
+    const manager = {
+        openScope(scopeId, parentScopeId) {
+            registerScope(scopeId, parentScopeId);
+        },
+        start(spec) {
+            if (spec.kind === "scheduled" && !Number.isFinite(spec.wakeAt)) {
+                throw new RangeError("wakeAt must be a finite Unix-epoch timestamp");
+            }
+            registerScope(spec.ownerScopeId, spec.parentScopeId);
+            const id = `t${nextTaskNumber++}`;
+            const descriptor = {
+                id,
+                kind: spec.kind,
+                name: spec.name,
+                label: spec.label,
+                ownerScopeId: spec.ownerScopeId,
+                status: spec.kind === "scheduled" ? "scheduled" : "running",
+                startedAt: options.clock.now(),
+                ...(spec.kind === "scheduled" ? { wakeAt: spec.wakeAt } : {}),
+            };
+            if (spec.kind === "scheduled") {
+                const record = createRecord(descriptor);
+                records.set(id, record);
+                emit({ type: "started", descriptor: copyDescriptor(descriptor) });
+                return { id };
+            }
+            const abortController = new AbortController();
+            const record = createRecord(descriptor, abortController);
+            records.set(id, record);
+            emit({ type: "started", descriptor: copyDescriptor(descriptor) });
+            const execution = Promise.resolve().then(() => spec.execute({
+                taskId: id,
+                signal: abortController.signal,
+                onOutput(chunk) {
+                    if (record.settlement)
+                        return;
+                    record.output.push(chunk);
+                    emit({ type: "output", id, chunk });
+                },
+                stopReason: () => record.stopReason,
+            }));
+            // Attach both branches synchronously: executor rejection is always observed at spawn.
+            void execution.then((result) => {
+                if (record.stopReason !== undefined) {
+                    settle(record, {
+                        id,
+                        status: "stopped",
+                        settledAt: options.clock.now(),
+                        reason: record.stopReason,
+                    });
+                    return;
+                }
+                settle(record, { id, status: "completed", settledAt: options.clock.now(), result });
+            }, (error) => {
+                if (record.stopReason !== undefined) {
+                    settle(record, {
+                        id,
+                        status: "stopped",
+                        settledAt: options.clock.now(),
+                        reason: record.stopReason,
+                    });
+                    return;
+                }
+                settle(record, { id, status: "failed", settledAt: options.clock.now(), error });
+            });
+            return { id };
+        },
+        async raceForeground(handle, budgetMs) {
+            if (!Number.isFinite(budgetMs) || budgetMs < 0) {
+                throw new RangeError("budgetMs must be a finite non-negative number");
+            }
+            const record = records.get(handle.id);
+            if (!record)
+                throw new Error(`Unknown task ${handle.id}`);
+            if (record.settlement)
+                return { kind: "settled", settlement: record.settlement };
+            let cancelBudget = () => undefined;
+            const budgetElapsed = new Promise((resolve) => {
+                cancelBudget = options.clock.schedule(resolve, budgetMs);
+            });
+            await Promise.race([record.finished, budgetElapsed]);
+            cancelBudget();
+            // A completion queued at the exact deadline wins the photo finish.
+            await Promise.resolve();
+            if (record.settlement)
+                return { kind: "settled", settlement: record.settlement };
+            return { kind: "still_running", task: snapshot(record) };
+        },
+        list(scopeId) {
+            return [...records.values()]
+                .filter((record) => scopeId === undefined || record.descriptor.ownerScopeId === scopeId)
+                .map((record) => copyDescriptor(record.descriptor));
+        },
+        output(id) {
+            const record = records.get(id);
+            return record ? snapshot(record) : undefined;
+        },
+        async waitForSettlement(id, waitMs) {
+            if (waitMs !== undefined && (!Number.isFinite(waitMs) || waitMs < 0)) {
+                throw new RangeError("waitMs must be a finite non-negative number");
+            }
+            const record = id === undefined ? undefined : records.get(id);
+            if (id !== undefined && !record)
+                return undefined;
+            if (record?.settlement)
+                return snapshot(record);
+            if (id === undefined && settlements.length > 0) {
+                return snapshot(records.get(settlements[0].id));
+            }
+            const notify = (settlement) => {
+                if (id === undefined || settlement.id === id) {
+                    settlementWaiters.delete(notify);
+                    resolveObserved(settlement);
+                }
+            };
+            let resolveObserved;
+            const observed = new Promise((resolve) => {
+                resolveObserved = resolve;
+                settlementWaiters.add(notify);
+            });
+            if (waitMs === undefined) {
+                const settlement = await observed;
+                return snapshot(records.get(settlement.id));
+            }
+            let cancelWait = () => undefined;
+            const elapsed = new Promise((resolve) => {
+                cancelWait = options.clock.schedule(() => resolve(undefined), waitMs);
+            });
+            const settlement = await Promise.race([observed, elapsed]);
+            cancelWait();
+            settlementWaiters.delete(notify);
+            return settlement ? snapshot(records.get(settlement.id)) : undefined;
+        },
+        nextSettled() {
+            return settlements.shift();
+        },
+        async stop(id, reason) {
+            const record = records.get(id);
+            if (!record)
+                return undefined;
+            if (record.settlement || isTerminal(record.descriptor))
+                return snapshot(record);
+            record.stopReason ??= reason;
+            if (record.abortController) {
+                record.abortController.abort(reason);
+                await record.finished;
+            }
+            else {
+                settle(record, { id, status: "stopped", settledAt: options.clock.now(), reason });
+            }
+            return snapshot(record);
+        },
+        async closeScope(scopeId, reason) {
+            const scope = scopes.get(scopeId);
+            if (!scope || scope.closed)
+                return;
+            const descendants = [...scopes.values()]
+                .filter((candidate) => isDescendantOf(candidate, scopeId, scopes))
+                .sort((left, right) => right.depth - left.depth);
+            for (const descendant of descendants) {
+                const owned = [...records.values()].filter((record) => record.descriptor.ownerScopeId === descendant.id && !isTerminal(record.descriptor));
+                await Promise.all(owned.map((record) => manager.stop(record.descriptor.id, reason)));
+                descendant.closed = true;
+            }
+            const directlyOwned = [...records.values()].filter((record) => record.descriptor.ownerScopeId === scopeId && !isTerminal(record.descriptor));
+            await Promise.all(directlyOwned.map((record) => manager.stop(record.descriptor.id, reason)));
+            scope.closed = true;
+        },
+        async interruptAll(reason) {
+            const pending = [...records.values()].filter((record) => !isTerminal(record.descriptor));
+            const barriers = pending.map((record) => manager.stop(record.descriptor.id, reason));
+            await manager.reapAll(reason);
+            await Promise.all(barriers);
+        },
+        pendingWork() {
+            return computePendingWork(manager.list());
+        },
+        recover(descriptors, persistedNextTaskId, outputTails) {
+            const lost = [];
+            for (const source of descriptors) {
+                if (records.has(source.id))
+                    throw new Error(`Duplicate recovered task ${source.id}`);
+                const match = /^t(\d+)$/.exec(source.id);
+                if (!match)
+                    throw new Error(`Invalid task id ${source.id}`);
+                nextTaskNumber = Math.max(nextTaskNumber, Number(match[1]) + 1);
+                registerScope(source.ownerScopeId);
+                const descriptor = copyDescriptor(source);
+                const record = createRecord(descriptor);
+                record.output.push(...(outputTails?.[descriptor.id] ?? []));
+                records.set(descriptor.id, record);
+                if (descriptor.status === "running" ||
+                    (descriptor.status === "scheduled" && !Number.isFinite(descriptor.wakeAt))) {
+                    descriptor.status = "lost";
+                    lost.push(copyDescriptor(descriptor));
+                    settle(record, {
+                        id: descriptor.id,
+                        status: "lost",
+                        settledAt: options.clock.now(),
+                    });
+                }
+            }
+            if (persistedNextTaskId !== undefined) {
+                if (!Number.isInteger(persistedNextTaskId) || persistedNextTaskId < 1) {
+                    throw new RangeError("nextTaskId must be a positive integer");
+                }
+                nextTaskNumber = Math.max(nextTaskNumber, persistedNextTaskId);
+            }
+            return { lost };
+        },
+        nextTaskId() {
+            return nextTaskNumber;
+        },
+        registerReaper(reaper) {
+            reapers.add(reaper);
+            return () => reapers.delete(reaper);
+        },
+        async reapAll(reason) {
+            const active = [...reapers];
+            reapers.clear();
+            await Promise.all(active.map((reaper) => reaper(reason)));
+        },
+    };
+    return manager;
+}
+function isDescendantOf(candidate, ancestorId, scopes) {
+    let parentScopeId = candidate.parentScopeId;
+    while (parentScopeId !== undefined) {
+        if (parentScopeId === ancestorId)
+            return true;
+        parentScopeId = scopes.get(parentScopeId)?.parentScopeId;
+    }
+    return false;
+}
+function isTerminal(descriptor) {
+    return !["running", "scheduled"].includes(descriptor.status);
+}
+//# sourceMappingURL=task-manager.js.map

package/dist/src/tasks/task-manager.js.map

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

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

@@ -0,0 +1,85 @@
+/** Stable task identity allocated monotonically within a TaskManager. */
+export type TaskId = `t${number}`;
+/** The execution surface responsible for a task. */
+export type TaskKind = "tool" | "subagent" | "scheduled";
+/**
+ * Structured-concurrency owner: the turn's root scope or a spawned subagent's
+ * child scope. Typed so a stray free-form id can't silently opt out of the
+ * cascade tree.
+ */
+export type ScopeId = `turn-${number}` | `task:${TaskId}`;
+/**
+ * Durable lifecycle state.
+ *
+ * `running` means an in-process executor still holds the turn open and the
+ * process must remain awake. `scheduled` is durable wall-clock work: it does
+ * not keep the process awake and resumes at `wakeAt`. All other statuses are
+ * terminal. `stopped` records an explicit task_stop, interrupt, or scope-close
+ * request; `lost` records work that was still running in a previous process
+ * and therefore cannot be resumed after hydration.
+ */
+export type TaskStatus = "running" | "scheduled" | "completed" | "failed" | "stopped" | "lost";
+/** Caller-supplied explanation used by executors to classify an abort. */
+export type TaskStopReason = string;
+/** The serializable task shape shared by runtime, persistence, protocol, and UI code. */
+export interface TaskDescriptor {
+    /** Monotonic identity generated by the manager, including across recovery. */
+    id: TaskId;
+    /** Selects whether the task is in-process work or a durable scheduled wait. */
+    kind: TaskKind;
+    /** Stable machine-facing name for logs and task listings. */
+    name: string;
+    /** Human-facing text describing the concrete work in progress. */
+    label: string;
+    /** Scope whose closure owns and cascade-stops this task. */
+    ownerScopeId: ScopeId;
+    /** Current lifecycle state; terminal states never transition again. */
+    status: TaskStatus;
+    /** Unix-epoch timestamp recorded when the task was created. */
+    startedAt: number;
+    /** Unix-epoch wake time, present only for scheduled tasks. */
+    wakeAt?: number;
+}
+/** A terminal value emitted exactly once and queued by settlement time. */
+export type TaskSettlement = {
+    id: TaskId;
+    status: "completed";
+    settledAt: number;
+    result: unknown;
+} | {
+    id: TaskId;
+    status: "failed";
+    settledAt: number;
+    error: unknown;
+} | {
+    id: TaskId;
+    status: "stopped";
+    settledAt: number;
+    reason: TaskStopReason;
+} | {
+    id: TaskId;
+    status: "lost";
+    settledAt: number;
+};
+/** Observable task state, including buffered values rather than derived counts. */
+export interface TaskSnapshot {
+    /** Copy of the durable descriptor at the time of inspection. */
+    descriptor: TaskDescriptor;
+    /** Ordered output chunks retained for later task_output inspection. */
+    output: readonly string[];
+    /** Terminal value once the task has settled. */
+    settlement?: TaskSettlement;
+}
+/** Events emitted synchronously after each externally observable task change. */
+export type TaskEvent = {
+    type: "started";
+    descriptor: TaskDescriptor;
+} | {
+    type: "output";
+    id: TaskId;
+    chunk: string;
+} | {
+    type: "settled";
+    settlement: TaskSettlement;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tasks/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;AAElC,oDAAoD;AACpD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,GAAG,QAAQ,MAAM,EAAE,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/F,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,+EAA+E;IAC/E,IAAI,EAAE,QAAQ,CAAC;IACf,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,YAAY,EAAE,OAAO,CAAC;IACtB,uEAAuE;IACvE,MAAM,EAAE,UAAU,CAAC;IACnB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACvE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAC5E;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,UAAU,EAAE,cAAc,CAAC;IAC3B,uEAAuE;IACvE,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,iFAAiF;AACjF,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,cAAc,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,cAAc,CAAA;CAAE,CAAC"}

package/dist/src/tasks/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/tasks/types.js.map

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

package/dist/src/train/archive.d.ts

@@ -10,6 +10,9 @@ export interface WriteArchiveInput {
  */
 export declare function writeArchive(input: WriteArchiveInput): Promise<string>;
 export declare function removeArchive(memoryId: string): Promise<void>;
+/** Absolute path of one archived copy: `<archive>/files/<relPath>`. Owns the
+ *  layout `writeArchive` copies into and `TrainRecord.files` reports. */
+export declare function archivedFilePath(memoryId: string, relPath: string): string;
 /**
  * Read the manifest for an archived training, or `undefined` when the
  * archive is absent or unreadable (e.g. it was pruned out of band). Keeps

package/dist/src/train/archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../src/train/archive.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAW9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa5E;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAO9F;AA+BD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgBjF"}
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../src/train/archive.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAW9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAY5E;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED;yEACyE;AACzE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAO9F;AA+BD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgBjF"}

package/dist/src/train/archive.js

@@ -16,10 +16,9 @@ function archiveRootForMemoryId(memoryId) {
  */
 export async function writeArchive(input) {
     const root = archiveRootForMemoryId(input.memoryId);
-    const filesRoot = join(root, "files");
-    await mkdir(filesRoot, { recursive: true });
+    await mkdir(join(root, "files"), { recursive: true });
     for (const file of input.files) {
-        const destination = join(filesRoot, file.relPath);
+        const destination = archivedFilePath(input.memoryId, file.relPath);
         await mkdir(dirname(destination), { recursive: true });
         await copyFile(file.absPath, destination);
     }
@@ -29,6 +28,11 @@ export async function writeArchive(input) {
 export async function removeArchive(memoryId) {
     await rm(archiveRootForMemoryId(memoryId), { recursive: true, force: true });
 }
+/** Absolute path of one archived copy: `<archive>/files/<relPath>`. Owns the
+ *  layout `writeArchive` copies into and `TrainRecord.files` reports. */
+export function archivedFilePath(memoryId, relPath) {
+    return join(archiveRootForMemoryId(memoryId), "files", relPath);
+}
 /**
  * Read the manifest for an archived training, or `undefined` when the
  * archive is absent or unreadable (e.g. it was pruned out of band). Keeps

package/dist/src/train/archive.js.map

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

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

@@ -40,11 +40,16 @@ export interface TrainListEntry {
     /** False when the manifest could not be read (archive deleted/moved). */
     hasArchive: boolean;
 }
-/** A {@link TrainListEntry} plus the full synthesized observation text, as
- *  returned by a single-row lookup (`duet train show` / `update`). */
+/** A {@link TrainListEntry} plus the full synthesized observation text and
+ *  archive contents, as returned by a single-row lookup (`duet train show` /
+ *  `update`). */
 export interface TrainRecord extends TrainListEntry {
     /** The durable memory text stored in the observation row. */
     content: string;
+    /** Absolute paths of the archived copies under the archive's `files/`
+     *  folder, from the manifest. Preferred over the original source paths,
+     *  which may have moved or been deleted since training. */
+    files?: string[];
 }
 export interface TrainManifest {
     /** Matches the inserted observation row's id; also the archive folder name. */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/train/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;sEACsE;AACtE,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC;CAClE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/train/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;iBAEiB;AACjB,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB;;+DAE2D;IAC3D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC;CAClE"}

package/dist/src/tui/app.d.ts

@@ -21,7 +21,7 @@ export interface RunTuiInput {
     packageVersion: string;
     /** User-facing model name for this CLI session. */
     modelName: string;
-    /** Provenance for modelName (e.g. "inferred from ANTHROPIC_API_KEY in .env"). */
+    /** Provenance for modelName (e.g. "inferred from AI_GATEWAY_API_KEY in .env"). */
     modelSource?: string;
     /** User-facing model name used for observational memory work. */
     memoryModelName: string;