@bryti/agent 0.0.1 → 0.1.0

package/dist/workers/spawn.js

@@ -0,0 +1,314 @@
+/**
+ * Worker session spawner and lifecycle management.
+ *
+ * Extracted from tools.ts to reduce file size and separate concerns:
+ * - tools.ts handles the tool definitions (public API)
+ * - spawn.ts handles session creation and lifecycle
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { createAgentSession, DefaultResourceLoader, SessionManager, SettingsManager, } from "@mariozechner/pi-coding-agent";
+import { embed } from "../memory/embeddings.js";
+import { createBraveSearchTool, createWebSearchTool } from "../tools/web-search.js";
+import { createFetchUrlTool } from "../tools/fetch-url.js";
+import { createWorkerScopedTools } from "./scoped-tools.js";
+import { createModelInfra, resolveModel } from "../model-infra.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+// ---------------------------------------------------------------------------
+// Worker system prompt
+// ---------------------------------------------------------------------------
+/**
+ * Build the system prompt for a worker session.
+ *
+ * The steering.md polling instruction embedded here (check every 3 tool calls)
+ * is the only communication channel from the main agent to a worker that is
+ * already running. worker_steer writes the file; the worker reads it on its
+ * own schedule. There is no push mechanism — the interval of 3 tool calls is
+ * a trade-off between responsiveness and unnecessary read_file overhead.
+ */
+function buildWorkerSystemPrompt(task, workerDir) {
+    return [
+        `You are a research worker. Your task is described below.`,
+        ``,
+        `Write your findings to result.md in your working directory.`,
+        `Structure the output as markdown with clear sections.`,
+        `Be thorough but concise. Include sources where relevant.`,
+        ``,
+        `Rules:`,
+        `- Your working directory is the root path you have access to.`,
+        `- Write your main output to result.md.`,
+        `- You may create additional files (notes.md, sources.md, etc.) as needed.`,
+        `- Do not ask for feedback or confirmation. Work autonomously.`,
+        `- When you are done, stop. Write your last thoughts to result.md and end.`,
+        ``,
+        `## Steering`,
+        ``,
+        `After every 3 tool calls, check for a file called steering.md using read_file.`,
+        `If the file exists, read it and immediately incorporate the guidance into your work.`,
+        `The steering note may narrow your focus, redirect your research, or add new requirements.`,
+        `Treat it as an authoritative update from the agent that dispatched you.`,
+        ``,
+        `## Task`,
+        ``,
+        task,
+        ``,
+        `## Working directory`,
+        ``,
+        workerDir,
+    ].join("\n");
+}
+/**
+ * Write (or overwrite) the status.json file in the worker directory.
+ *
+ * This is the primary way the main agent reads worker status via worker_check.
+ * worker_check first consults the in-memory registry; if the worker is no
+ * longer there (e.g. after a restart or 24-hour cleanup) it falls back to
+ * reading this file from disk. Writing is best-effort: failures are swallowed
+ * so they never abort a completion or timeout handler.
+ */
+export function writeStatusFile(workerDir, data) {
+    try {
+        fs.writeFileSync(path.join(workerDir, "status.json"), JSON.stringify(data, null, 2), "utf-8");
+    }
+    catch {
+        // Best-effort — don't crash the completion handler
+    }
+}
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+const ALLOWED_TOOLS = ["web_search", "fetch_url"];
+// ---------------------------------------------------------------------------
+// Worker session spawner
+// ---------------------------------------------------------------------------
+export async function spawnWorkerSession(opts) {
+    const { config, workerId, workerDir, task, modelOverride, toolNames, memoryStore, registry, timeoutMs, onTrigger, } = opts;
+    const { authStorage, modelRegistry, agentDir } = createModelInfra(config);
+    const modelsDir = path.join(config.data_dir, ".models");
+    const resultPath = path.join(workerDir, "result.md");
+    // Resolve model. Workers default to the first fallback model (cheaper) rather
+    // than the primary model. The primary might be Opus/Sonnet via OAuth; we don't
+    // want workers burning those tokens on research tasks.
+    const workerDefault = config.tools.workers.model
+        ?? config.agent.fallback_models?.[0]
+        ?? config.agent.model;
+    const modelString = modelOverride ?? workerDefault;
+    const model = resolveModel(modelString, modelRegistry);
+    if (!model) {
+        throw new Error(`Worker model not found: ${modelString}`);
+    }
+    // ---- Tool selection -------------------------------------------------------
+    // Only the tools explicitly requested by the dispatcher are included. The
+    // scoped file tools (write_file, read_file) are always added regardless.
+    const workerTools = [];
+    if (toolNames.includes("web_search") && config.tools.web_search.enabled) {
+        const ws = config.tools.web_search;
+        if (ws.brave_api_key) {
+            workerTools.push(createBraveSearchTool(ws.brave_api_key));
+        }
+        else if (ws.searxng_url) {
+            workerTools.push(createWebSearchTool(ws.searxng_url));
+        }
+        // If neither is configured, web_search is silently omitted from worker tools.
+    }
+    if (toolNames.includes("fetch_url")) {
+        workerTools.push(createFetchUrlTool(config.tools.fetch_url.timeout_ms));
+    }
+    // Scoped file tools are always present — they are the worker's only way to
+    // persist findings. The worker cannot access files outside workerDir.
+    workerTools.push(...createWorkerScopedTools(workerDir));
+    // ---- Session creation -----------------------------------------------------
+    const systemPrompt = buildWorkerSystemPrompt(task, workerDir);
+    const loader = new DefaultResourceLoader({
+        cwd: config.data_dir,
+        agentDir,
+        settingsManager: SettingsManager.create(config.data_dir, agentDir),
+        systemPromptOverride: () => systemPrompt,
+    });
+    await loader.reload();
+    const settingsManager = SettingsManager.create(config.data_dir, agentDir);
+    // Spawn the session (no persistence — in-memory only)
+    const { session } = await createAgentSession({
+        cwd: workerDir,
+        agentDir,
+        authStorage,
+        modelRegistry,
+        model,
+        thinkingLevel: "off",
+        tools: [],
+        customTools: workerTools,
+        resourceLoader: loader,
+        sessionManager: SessionManager.inMemory(workerDir),
+        settingsManager,
+    });
+    // ---- Timeout setup --------------------------------------------------------
+    registry.update(workerId, {
+        abort: () => session.abort(),
+    });
+    // Set up timeout
+    const timeoutHandle = setTimeout(async () => {
+        console.log(`[worker] ${workerId} timed out after ${timeoutMs / 1000}s`);
+        registry.update(workerId, {
+            status: "timeout",
+            completedAt: new Date(),
+            error: `Timed out after ${timeoutMs / 1000}s`,
+        });
+        const entry = registry.get(workerId);
+        try {
+            await session.abort();
+        }
+        catch {
+            // Best-effort abort
+        }
+        session.dispose();
+        if (entry) {
+            writeStatusFile(workerDir, {
+                worker_id: workerId,
+                status: "timeout",
+                task,
+                started_at: entry.startedAt.toISOString(),
+                completed_at: new Date().toISOString(),
+                model: modelString,
+                error: `Timed out after ${timeoutMs / 1000}s`,
+                result_path: resultPath,
+            });
+            const factContent = `Worker ${workerId} failed: timed out after ${timeoutMs / 1000}s`;
+            try {
+                const embedding = await embed(factContent, modelsDir);
+                memoryStore.addFact(factContent, "worker", embedding);
+                console.log(`[worker] ${workerId} timeout fact archived`);
+            }
+            catch (err) {
+                console.error(`[worker] ${workerId} failed to archive timeout fact:`, err.message);
+            }
+        }
+        scheduleCleanup(registry, workerId, workerDir);
+    }, timeoutMs);
+    // Store handle so we can cancel it if the worker finishes first
+    registry.update(workerId, { timeoutHandle });
+    // ---- Task execution and completion callback --------------------------------
+    // session.prompt() runs the worker to completion. Everything below the await
+    // is the completion callback — it runs once the model has stopped generating.
+    const taskPrompt = `Please complete the task described in the system prompt. ` +
+        `Write your findings to result.md when done.`;
+    try {
+        await session.prompt(taskPrompt);
+        // Check for model errors
+        const lastAssistant = session.messages
+            .filter((m) => m.role === "assistant")
+            .pop();
+        if (lastAssistant?.stopReason === "error") {
+            throw new Error(String(lastAssistant.errorMessage ?? "Model error"));
+        }
+        // Success path
+        clearTimeout(timeoutHandle);
+        registry.update(workerId, {
+            status: "complete",
+            completedAt: new Date(),
+            error: null,
+            timeoutHandle: null,
+        });
+        const entry = registry.get(workerId);
+        // Step 1: Write status.json so worker_check can read the result from disk
+        // even after the registry entry has been cleaned up.
+        writeStatusFile(workerDir, {
+            worker_id: workerId,
+            status: "complete",
+            task,
+            started_at: entry?.startedAt.toISOString() ?? new Date().toISOString(),
+            completed_at: new Date().toISOString(),
+            model: modelString,
+            error: null,
+            result_path: resultPath,
+        });
+        console.log(`[worker] ${workerId} complete`);
+        const factContent = `Worker ${workerId} complete, results at ${resultPath}`;
+        try {
+            // Step 2: Archive the completion fact. This is what the main agent's
+            // projection matched against trigger_on_fact (e.g. "worker w-xxx complete").
+            const embedding = await embed(factContent, modelsDir);
+            memoryStore.addFact(factContent, "worker", embedding);
+            console.log(`[worker] ${workerId} completion fact archived`);
+            // Step 3: Check the fact against active projections and invoke the
+            // onTrigger callback if any match. The callback injects a scheduler
+            // message immediately rather than waiting for the 5-minute cron tick,
+            // so the main agent wakes up as soon as the worker finishes.
+            if (onTrigger && opts.projectionStore) {
+                try {
+                    const triggered = await opts.projectionStore.checkTriggers(factContent, (text) => embed(text, modelsDir));
+                    if (triggered.length > 0) {
+                        console.log(`[worker] ${workerId} triggered ${triggered.length} projection(s)`);
+                        onTrigger(triggered);
+                    }
+                }
+                catch (triggerErr) {
+                    console.error(`[worker] ${workerId} trigger check failed:`, triggerErr.message);
+                }
+            }
+        }
+        catch (err) {
+            console.error(`[worker] ${workerId} failed to archive completion fact:`, err.message);
+        }
+    }
+    catch (error) {
+        const errMsg = error.message;
+        // Don't overwrite a terminal status set externally (timeout handler or
+        // worker_interrupt). Both set their own status before aborting the session,
+        // so the error thrown by abort() here would otherwise clobber it.
+        const currentEntry = registry.get(workerId);
+        if (currentEntry?.status === "timeout" || currentEntry?.status === "cancelled") {
+            session.dispose();
+            return;
+        }
+        clearTimeout(timeoutHandle);
+        registry.update(workerId, {
+            status: "failed",
+            completedAt: new Date(),
+            error: errMsg,
+            timeoutHandle: null,
+        });
+        const entry = registry.get(workerId);
+        writeStatusFile(workerDir, {
+            worker_id: workerId,
+            status: "failed",
+            task,
+            started_at: entry?.startedAt.toISOString() ?? new Date().toISOString(),
+            completed_at: new Date().toISOString(),
+            model: modelString,
+            error: errMsg,
+            result_path: resultPath,
+        });
+        console.error(`[worker] ${workerId} failed:`, errMsg);
+        const factContent = `Worker ${workerId} failed: ${errMsg}`;
+        try {
+            const embedding = await embed(factContent, modelsDir);
+            memoryStore.addFact(factContent, "worker", embedding);
+            console.log(`[worker] ${workerId} failure fact archived`);
+        }
+        catch (err2) {
+            console.error(`[worker] ${workerId} failed to archive failure fact:`, err2.message);
+        }
+    }
+    finally {
+        session.dispose();
+        scheduleCleanup(registry, workerId, workerDir);
+    }
+}
+// ---------------------------------------------------------------------------
+// Cleanup
+// ---------------------------------------------------------------------------
+/**
+ * Remove the worker's registry entry after 24 hours. Result files stay on
+ * disk; only the in-memory tracking is cleared.
+ */
+export function scheduleCleanup(registry, workerId, _workerDir) {
+    // Keep the entry for 24 hours so worker_check still works.
+    setTimeout(() => {
+        registry.remove(workerId);
+        console.log(`[worker] ${workerId} removed from registry after 24h`);
+    }, 24 * 60 * 60 * 1000);
+}
+//# sourceMappingURL=spawn.js.map

package/dist/workers/spawn.js.map

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

package/dist/workers/tools.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Worker tools: dispatch, check, interrupt, steer.
+ *
+ * Workers are background LLM sessions with a scoped tool set. They write
+ * results to a file and signal completion by archiving a fact, which triggers
+ * any matching projection in the main agent.
+ *
+ * Lifecycle:
+ *   1. dispatch: create worker dir, write task.md, spawn session
+ *   2. Worker runs autonomously (web search, fetch URL, write result.md)
+ *   3. On completion/failure/timeout: write status.json, archive a fact
+ *   4. check: query status; interrupt: cancel immediately; steer: redirect
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { Config } from "../config.js";
+import type { MemoryStore } from "../memory/store.js";
+import type { WorkerRegistry } from "./registry.js";
+import type { ProjectionStore } from "../projection/store.js";
+import { type WorkerTriggerCallback } from "./spawn.js";
+export type { WorkerTriggerCallback } from "./spawn.js";
+/**
+ * Create worker tools (dispatch, check, interrupt, steer).
+ * When isWorkerSession is true, dispatch rejects all calls (no nesting).
+ */
+export declare function createWorkerTools(config: Config, memoryStore: MemoryStore, registry: WorkerRegistry, isWorkerSession?: boolean, projectionStore?: ProjectionStore, onTrigger?: WorkerTriggerCallback): AgentTool<any>[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/workers/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/workers/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAG9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAYpB,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA8DxD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,cAAc,EACxB,eAAe,UAAQ,EACvB,eAAe,CAAC,EAAE,eAAe,EACjC,SAAS,CAAC,EAAE,qBAAqB,GAChC,SAAS,CAAC,GAAG,CAAC,EAAE,CAoWlB"}