@nervekit/orchestrator 0.1.0

package/dist/domains/tasks/task-summary-format.js

@@ -0,0 +1,149 @@
+import { isActiveTaskStatus } from "./task-status.js";
+const MAX_COMMAND_PREVIEW = 120;
+const MAX_ERROR_PREVIEW = 120;
+const MAX_LOG_LINE = 220;
+export function truncateTaskText(value, max = MAX_COMMAND_PREVIEW) {
+    const text = value.replace(/\s+/g, " ").trim();
+    return text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1))}…`;
+}
+export function taskLabel(task) {
+    return task.name ? `${task.name} (${task.id})` : task.id;
+}
+export function taskCommandPreview(task) {
+    return truncateTaskText(task.command, MAX_COMMAND_PREVIEW);
+}
+export function formatReadiness(task) {
+    if (task.readiness.outcome === "none")
+        return undefined;
+    if (task.readiness.outcome === "timeout") {
+        const duration = task.readiness.timeoutMs
+            ? ` after ${task.readiness.timeoutMs}ms`
+            : "";
+        return isActiveTaskStatus(task.status)
+            ? `readiness=timeout${duration} (task still running)`
+            : `readiness=timeout${duration}`;
+    }
+    const matched = task.readiness.matched ?? task.readiness.readyUrl;
+    return matched
+        ? `readiness=${task.readiness.outcome} ${truncateTaskText(matched, 80)}`
+        : `readiness=${task.readiness.outcome}`;
+}
+export function oneLineTaskSummary(task, options = {}) {
+    const parts = [`${taskLabel(task)}: ${task.status}`];
+    const readiness = formatReadiness(task);
+    if (readiness)
+        parts.push(readiness);
+    if (task.exitCode !== undefined)
+        parts.push(`exit=${task.exitCode}`);
+    if (task.signal)
+        parts.push(`signal=${task.signal}`);
+    if (options.nextCursor !== undefined)
+        parts.push(`cursor=${options.nextCursor}`);
+    if (task.error)
+        parts.push(`error=${truncateTaskText(task.error, MAX_ERROR_PREVIEW)}`);
+    if (!task.name && options.includeCommandForUnnamed !== false) {
+        parts.push(`cmd=${taskCommandPreview(task)}`);
+    }
+    return parts.join("; ");
+}
+export function formatLogEvent(event) {
+    return `[${event.seq} ${event.stream} ${event.level}] ${truncateTaskText(event.line, MAX_LOG_LINE)}`;
+}
+export function formatTaskStartSummary(input) {
+    if (input.tasks.length === 0)
+        return "No tasks started.";
+    const lines = [
+        `Started ${input.tasks.length} background ${input.tasks.length === 1 ? "task" : "tasks"}${input.groupId ? ` (group ${input.groupId})` : ""}.`,
+    ];
+    for (const task of input.tasks) {
+        const readiness = formatReadiness(task);
+        const bits = [
+            `- ${task.name ?? taskCommandPreview(task)}: ${task.id} — ${task.status}`,
+        ];
+        if (readiness)
+            bits.push(readiness);
+        if (task.readiness.readyUrl)
+            bits.push(`readyUrl=${task.readiness.readyUrl}`);
+        lines.push(bits.join("; "));
+    }
+    lines.push("Task updates may arrive asynchronously. Use task_status/task_logs only if you need to inspect or debug.");
+    return lines.join("\n");
+}
+export function formatTaskStatusSummary(rows) {
+    if (rows.length === 0)
+        return "No tasks found.";
+    const lines = [`${rows.length} ${rows.length === 1 ? "task" : "tasks"}`];
+    for (const row of rows) {
+        lines.push(`- ${oneLineTaskSummary(row.task, { nextCursor: row.nextCursor })}`);
+        if (row.logs && row.logs.length > 0) {
+            for (const event of row.logs)
+                lines.push(`  ${formatLogEvent(event)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatTaskCancelSummary(results) {
+    if (results.length === 0)
+        return "No active matching tasks to cancel.";
+    return results.map((result) => `- ${result.message}`).join("\n");
+}
+export function formatTaskListSummary(tasks) {
+    if (tasks.length === 0)
+        return "No tasks found.";
+    return tasks.map((task) => oneLineTaskSummary(task)).join("\n");
+}
+export function formatTaskLogsSummary(input) {
+    const lines = [
+        `${input.autoSelected ? "Auto-selected logs for" : "Logs for"} ${taskLabel(input.task)} (${input.task.status}); mode=${input.mode}; cursor=${input.nextCursor}`,
+    ];
+    if (input.events.length === 0) {
+        lines.push("No matching log events.");
+    }
+    else {
+        lines.push(...input.events.map(formatLogEvent));
+    }
+    lines.push(`Use task_logs({ taskId: "${input.task.name ?? input.task.id}", mode: "since_cursor", sinceSeq: ${input.nextCursor} }) later for more output if needed.`);
+    return lines.join("\n");
+}
+export function isTerminalTaskStatus(status) {
+    return !isActiveTaskStatus(status);
+}
+export function taskEventTitle(task, event) {
+    const label = task.name ? `${task.name} (${task.id})` : task.id;
+    return `Background task ${label} ${event.replace("_", " ")}.`;
+}
+export function formatTaskEventSummary(input) {
+    const lines = [taskEventTitle(input.task, input.event)];
+    lines.push(oneLineTaskSummary(input.task, { nextCursor: input.nextCursor }));
+    lines.push(`Command: ${taskCommandPreview(input.task)}`);
+    if (input.task.groupId)
+        lines.push(`Group: ${input.task.groupId}`);
+    if (input.logs && input.logs.length > 0) {
+        lines.push("Relevant output:");
+        lines.push(...input.logs.map(formatLogEvent));
+    }
+    if (input.nextCursor !== undefined) {
+        lines.push(`Use task_logs({ taskId: "${input.task.name ?? input.task.id}", mode: "since_cursor", sinceSeq: ${input.nextCursor} }) later for more output if needed.`);
+    }
+    return lines.join("\n");
+}
+export function relevantFailureLogs(responses, limit) {
+    const seen = new Set();
+    const events = [];
+    let nextCursor;
+    for (const response of responses) {
+        if (!response)
+            continue;
+        nextCursor = Math.max(nextCursor ?? 0, response.nextCursor);
+        for (const event of response.events) {
+            if (seen.has(event.seq))
+                continue;
+            seen.add(event.seq);
+            events.push(event);
+            if (events.length >= limit)
+                return { events, nextCursor };
+        }
+    }
+    return { events, nextCursor };
+}
+//# sourceMappingURL=task-summary-format.js.map

package/dist/domains/tasks/task-summary-format.js.map

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

package/dist/domains/tasks/task-supervisor.d.ts

@@ -0,0 +1,34 @@
+import { type ChildProcess, spawn } from "node:child_process";
+import type { TaskRuntime } from "@nervekit/shared";
+export interface SpawnManagedTaskOptions {
+    cwd: string;
+    env?: Record<string, string>;
+}
+export interface SpawnedManagedTask {
+    child: ChildProcess;
+    runtime: TaskRuntime;
+}
+export interface TerminateTaskOptions {
+    platform?: NodeJS.Platform;
+    helperTimeoutMs?: number;
+    spawnCommand?: typeof spawn;
+    killTask?: typeof process.kill;
+}
+export interface TerminateTaskResult {
+    attempted: boolean;
+    method: "process-group" | "direct-child" | "taskkill" | "none";
+    error?: string;
+}
+export interface TaskSupervisor {
+    spawn(command: string, options: SpawnManagedTaskOptions): SpawnedManagedTask;
+    terminate(child: ChildProcess, signal: NodeJS.Signals): Promise<TerminateTaskResult>;
+    terminateRuntime(runtime: TaskRuntime, signal: NodeJS.Signals): Promise<TerminateTaskResult>;
+    isRuntimeTargetAlive(runtime: TaskRuntime): Promise<boolean>;
+}
+export declare function spawnManagedTask(command: string, options: SpawnManagedTaskOptions): SpawnedManagedTask;
+export declare function runtimeForChild(child: Pick<ChildProcess, "pid">, platform?: NodeJS.Platform, now?: Date): TaskRuntime;
+export declare function terminateTask(child: ChildProcess, signal: NodeJS.Signals, options?: TerminateTaskOptions): Promise<TerminateTaskResult>;
+export declare function terminateTaskRuntime(runtime: TaskRuntime, signal: NodeJS.Signals, options?: TerminateTaskOptions): Promise<TerminateTaskResult>;
+export declare function isTaskRuntimeTargetAlive(runtime: TaskRuntime, options?: TerminateTaskOptions): Promise<boolean>;
+export declare const defaultTaskSupervisor: TaskSupervisor;
+//# sourceMappingURL=task-supervisor.d.ts.map

package/dist/domains/tasks/task-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-supervisor.d.ts","sourceRoot":"","sources":["../../../src/domains/tasks/task-supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,KAAK,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,OAAO,CAAC,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,eAAe,GAAG,cAAc,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,kBAAkB,CAAC;IAC7E,SAAS,CACP,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,CAAC,OAAO,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,gBAAgB,CACd,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,OAAO,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,uBAAuB,GAC/B,kBAAkB,CASpB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,EAChC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,OAAa,GACf,WAAW,CAUb;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,CAAC,OAAO,EACtB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAqB9B;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,CAAC,OAAO,EACtB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAmC9B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED,eAAO,MAAM,qBAAqB,EAAE,cAKnC,CAAC"}

package/dist/domains/tasks/task-supervisor.js

@@ -0,0 +1,211 @@
+import { spawn } from "node:child_process";
+const DEFAULT_HELPER_TIMEOUT_MS = 2000;
+export function spawnManagedTask(command, options) {
+    const child = spawn(command, {
+        cwd: options.cwd,
+        shell: true,
+        env: { ...process.env, ...(options.env ?? {}) },
+        stdio: ["ignore", "pipe", "pipe"],
+        detached: process.platform !== "win32",
+    });
+    return { child, runtime: runtimeForChild(child, process.platform) };
+}
+export function runtimeForChild(child, platform = process.platform, now = new Date()) {
+    const detached = platform !== "win32";
+    return {
+        platform,
+        childPid: child.pid,
+        processGroupId: detached ? child.pid : undefined,
+        detached,
+        shell: true,
+        spawnedAt: now.toISOString(),
+    };
+}
+export async function terminateTask(child, signal, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const spawnCommand = options.spawnCommand ?? spawn;
+    const killTask = options.killTask ?? process.kill;
+    if (!child.pid)
+        return signalDirectChild(child, signal);
+    if (platform === "win32") {
+        return terminateWindowsTaskTree(child.pid, spawnCommand, options.helperTimeoutMs ?? DEFAULT_HELPER_TIMEOUT_MS);
+    }
+    try {
+        killTask(-child.pid, signal);
+        return { attempted: true, method: "process-group" };
+    }
+    catch {
+        return signalDirectChild(child, signal);
+    }
+}
+export async function terminateTaskRuntime(runtime, signal, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const spawnCommand = options.spawnCommand ?? spawn;
+    const killTask = options.killTask ?? process.kill;
+    if (runtime.platform !== platform) {
+        return {
+            attempted: false,
+            method: "none",
+            error: `Cannot clean up task spawned on ${runtime.platform} from ${platform}.`,
+        };
+    }
+    if (platform === "win32") {
+        if (!runtime.childPid)
+            return missingRuntimeTargetResult(platform);
+        return terminateWindowsTaskTree(runtime.childPid, spawnCommand, options.helperTimeoutMs ?? DEFAULT_HELPER_TIMEOUT_MS);
+    }
+    const target = nonWindowsRuntimeTarget(runtime);
+    if (!target)
+        return missingRuntimeTargetResult(platform);
+    try {
+        killTask(target.pid, signal);
+        return { attempted: true, method: target.method };
+    }
+    catch (error) {
+        return {
+            attempted: true,
+            method: target.method,
+            error: errorMessage(error),
+        };
+    }
+}
+export async function isTaskRuntimeTargetAlive(runtime, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const killTask = options.killTask ?? process.kill;
+    if (runtime.platform !== platform)
+        return false;
+    if (platform === "win32")
+        return false;
+    const target = nonWindowsRuntimeTarget(runtime);
+    if (!target)
+        return false;
+    try {
+        killTask(target.pid, 0);
+        return true;
+    }
+    catch (error) {
+        const code = errorCode(error);
+        if (code === "EPERM")
+            return true;
+        return false;
+    }
+}
+export const defaultTaskSupervisor = {
+    spawn: spawnManagedTask,
+    terminate: terminateTask,
+    terminateRuntime: terminateTaskRuntime,
+    isRuntimeTargetAlive: isTaskRuntimeTargetAlive,
+};
+function signalDirectChild(child, signal) {
+    if (typeof child.kill !== "function") {
+        return {
+            attempted: false,
+            method: "none",
+            error: "Child task has no pid and cannot be signaled directly.",
+        };
+    }
+    try {
+        const signaled = child.kill(signal);
+        return {
+            attempted: true,
+            method: "direct-child",
+            error: signaled ? undefined : "Direct child signal returned false.",
+        };
+    }
+    catch (error) {
+        return {
+            attempted: true,
+            method: "direct-child",
+            error: errorMessage(error),
+        };
+    }
+}
+function nonWindowsRuntimeTarget(runtime) {
+    if (runtime.processGroupId) {
+        return { pid: -runtime.processGroupId, method: "process-group" };
+    }
+    if (runtime.childPid) {
+        return { pid: runtime.childPid, method: "direct-child" };
+    }
+    return undefined;
+}
+function missingRuntimeTargetResult(platform) {
+    return {
+        attempted: false,
+        method: "none",
+        error: platform === "win32"
+            ? "Cannot clean up orphaned task because no child PID metadata was captured."
+            : "Cannot clean up orphaned task because no process-group or child PID metadata was captured.",
+    };
+}
+async function terminateWindowsTaskTree(pid, spawnCommand, helperTimeoutMs) {
+    let helper;
+    try {
+        helper = spawnCommand("taskkill", ["/F", "/T", "/PID", String(pid)], {
+            stdio: "ignore",
+            windowsHide: true,
+        });
+    }
+    catch (error) {
+        return {
+            attempted: true,
+            method: "taskkill",
+            error: errorMessage(error),
+        };
+    }
+    return new Promise((resolve) => {
+        let settled = false;
+        let timeout;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeout)
+                clearTimeout(timeout);
+            helper.removeAllListeners("close");
+            helper.removeAllListeners("error");
+            resolve(result);
+        };
+        timeout = setTimeout(() => {
+            let helperKillError;
+            try {
+                helper.kill("SIGKILL");
+            }
+            catch (error) {
+                helperKillError = errorMessage(error);
+            }
+            finish({
+                attempted: true,
+                method: "taskkill",
+                error: helperKillError
+                    ? `taskkill timed out after ${helperTimeoutMs}ms; failed to kill helper: ${helperKillError}`
+                    : `taskkill timed out after ${helperTimeoutMs}ms`,
+            });
+        }, Math.max(0, helperTimeoutMs));
+        helper.once("error", (error) => {
+            finish({
+                attempted: true,
+                method: "taskkill",
+                error: errorMessage(error),
+            });
+        });
+        helper.once("close", (code, closeSignal) => {
+            finish({
+                attempted: true,
+                method: "taskkill",
+                error: code === 0
+                    ? undefined
+                    : `taskkill exited with code ${code}${closeSignal ? ` and signal ${closeSignal}` : ""}`,
+            });
+        });
+    });
+}
+function errorCode(error) {
+    return typeof error === "object" && error !== null && "code" in error
+        ? String(error.code)
+        : undefined;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=task-supervisor.js.map

package/dist/domains/tasks/task-supervisor.js.map

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

package/dist/domains/tasks/task.repository.d.ts

@@ -0,0 +1,37 @@
+import { type TaskRecord } from "@nervekit/shared";
+export type LegacyProcessRecord = {
+    id: string;
+    name?: string;
+    workerId?: string;
+    projectId?: string;
+    conversationId?: string;
+    agentId?: string;
+    cwd: string;
+    command: string;
+    envInfo?: TaskRecord["envInfo"];
+    status?: string;
+    readiness?: TaskRecord["readiness"];
+    stdoutPath?: string;
+    stderrPath?: string;
+    logsPath?: string;
+    startedAt?: string;
+    updatedAt?: string;
+    exitedAt?: string;
+    exitCode?: number | null;
+    signal?: string | null;
+    error?: string;
+    runtime?: TaskRecord["runtime"];
+};
+import { type InitializedStorage } from "../../infrastructure/storage/index.js";
+export declare class TaskRepository {
+    private readonly storage;
+    constructor(storage: InitializedStorage);
+    get storageHome(): string;
+    hydrate(): Promise<TaskRecord[]>;
+    hydrateLegacyProcesses(): Promise<LegacyProcessRecord[]>;
+    write(record: TaskRecord): Promise<void>;
+    remove(taskId: string): Promise<void>;
+    removeLegacyProcess(processId: string): Promise<void>;
+    taskDir(taskId: string): string;
+}
+//# sourceMappingURL=task.repository.d.ts.map

package/dist/domains/tasks/task.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.repository.d.ts","sourceRoot":"","sources":["../../../src/domains/tasks/task.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,kBAAkB,CAAC;AAErE,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;CACjC,CAAC;AAEF,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,uCAAuC,CAAC;AAE/C,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kBAAkB;IAExD,IAAI,WAAW,IAAI,MAAM,CAExB;IAEK,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAehC,sBAAsB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAsBxD,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGhC"}

package/dist/domains/tasks/task.repository.js

@@ -0,0 +1,58 @@
+import { rm } from "node:fs/promises";
+import { join } from "node:path";
+import { taskRecordSchema } from "@nervekit/shared";
+import { atomicWriteJson, listChildDirs, readJsonFile, } from "../../infrastructure/storage/index.js";
+export class TaskRepository {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    get storageHome() {
+        return this.storage.paths.home;
+    }
+    async hydrate() {
+        const records = [];
+        const root = join(this.storage.paths.home, "tasks");
+        for (const taskId of await listChildDirs(root)) {
+            const parsed = taskRecordSchema.safeParse(await readJsonFile(join(root, taskId, "task.json")).catch(() => undefined));
+            if (!parsed.success)
+                continue;
+            records.push(parsed.data);
+        }
+        return records;
+    }
+    async hydrateLegacyProcesses() {
+        const records = [];
+        const root = join(this.storage.paths.home, "proc");
+        for (const processId of await listChildDirs(root)) {
+            const raw = await readJsonFile(join(root, processId, "process.json")).catch(() => undefined);
+            if (!raw || typeof raw !== "object")
+                continue;
+            const record = raw;
+            if (typeof record.id !== "string" ||
+                !record.id.startsWith("proc_") ||
+                typeof record.cwd !== "string" ||
+                typeof record.command !== "string") {
+                continue;
+            }
+            records.push(record);
+        }
+        return records;
+    }
+    async write(record) {
+        await atomicWriteJson(join(this.taskDir(record.id), "task.json"), record, 0o600);
+    }
+    async remove(taskId) {
+        await rm(this.taskDir(taskId), { recursive: true, force: true });
+    }
+    async removeLegacyProcess(processId) {
+        await rm(join(this.storage.paths.home, "proc", processId), {
+            recursive: true,
+            force: true,
+        });
+    }
+    taskDir(taskId) {
+        return join(this.storage.paths.home, "tasks", taskId);
+    }
+}
+//# sourceMappingURL=task.repository.js.map

package/dist/domains/tasks/task.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.repository.js","sourceRoot":"","sources":["../../../src/domains/tasks/task.repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAmB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA0BrE,OAAO,EACL,eAAe,EAEf,aAAa,EACb,YAAY,GACb,MAAM,uCAAuC,CAAC;AAE/C,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAE5D,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACpD,KAAK,MAAM,MAAM,IAAI,MAAM,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CACvC,MAAM,YAAY,CAAU,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAChE,GAAG,EAAE,CAAC,SAAS,CAChB,CACF,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,SAAS;YAC9B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,MAAM,OAAO,GAA0B,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnD,KAAK,MAAM,SAAS,IAAI,MAAM,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,MAAM,GAAG,GAAG,MAAM,YAAY,CAC5B,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,CACtC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACzB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,SAAS;YAC9C,MAAM,MAAM,GAAG,GAA8B,CAAC;YAC9C,IACE,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;gBAC7B,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;gBAC9B,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;gBAC9B,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAClC,CAAC;gBACD,SAAS;YACX,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,MAA6B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAkB;QAC5B,MAAM,eAAe,CACnB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,EAC1C,MAAM,EACN,KAAK,CACN,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,SAAiB;QACzC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE;YACzD,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/domains/tools/agent-tool-adapter.d.ts

@@ -0,0 +1,25 @@
+import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
+import { type AgentTool, type AgentToolResult } from "@nervekit/agent";
+import type { AgentRecord, ToolCallRecord, ToolName } from "@nervekit/shared";
+import type { ToolAnchor } from "../conversations/conversation-runtime.js";
+import type { ToolService } from "./tool-service.js";
+export type AgentToolPromptMetadata = {
+    activeToolNames: string[];
+    snippets: Record<string, string>;
+    guidelines: string[];
+};
+export declare function createAgentToolsForAgent(agent: AgentRecord, tools: ToolService, options?: {
+    runId?: string;
+    resolveToolAnchor?: (providerToolCallId: string) => ToolAnchor | undefined;
+    hidden?: boolean;
+    allowedToolNames?: ToolName[];
+}): AgentTool[];
+export declare function activeToolNamesForExploreAgent(): ToolName[];
+export declare function activeToolNamesForAgent(agent: AgentRecord, options?: {
+    pythonAvailable?: boolean;
+}): ToolName[];
+export declare function toolPromptMetadata(activeToolNames: string[]): AgentToolPromptMetadata;
+export declare function completedToolResult(toolCall: ToolCallRecord): AgentToolResult<unknown>;
+export declare function contentBlocksFromResult(result: unknown): Array<TextContent | ImageContent> | undefined;
+export declare function formatToolResultForModel(toolCall: ToolCallRecord): string;
+//# sourceMappingURL=agent-tool-adapter.d.ts.map

package/dist/domains/tools/agent-tool-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool-adapter.d.ts","sourceRoot":"","sources":["../../../src/domains/tools/agent-tool-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EACL,KAAK,SAAS,EACd,KAAK,eAAe,EAErB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAU9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAC;CAC1B,GACL,SAAS,EAAE,CASb;AAED,wBAAgB,8BAA8B,IAAI,QAAQ,EAAE,CAU3D;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,QAAQ,EAAE,CAqEZ;AAED,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EAAE,GACxB,uBAAuB,CAmBzB;AAsDD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,GACvB,eAAe,CAAC,OAAO,CAAC,CAU1B;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,GACd,KAAK,CAAC,WAAW,GAAG,YAAY,CAAC,GAAG,SAAS,CA0C/C;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAkDzE"}