@bryti/agent 0.0.1 → 0.1.0

package/dist/workers/tools.js

@@ -0,0 +1,380 @@
+/**
+ * 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 fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { Type } from "@sinclair/typebox";
+import { embed } from "../memory/embeddings.js";
+import { toolError, toolSuccess } from "../tools/result.js";
+import { spawnWorkerSession, writeStatusFile, } from "./spawn.js";
+// ---------------------------------------------------------------------------
+// Constants and types
+// ---------------------------------------------------------------------------
+const ALLOWED_TOOLS = ["web_search", "fetch_url"];
+const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+// ---------------------------------------------------------------------------
+// Tool schemas
+// ---------------------------------------------------------------------------
+const dispatchWorkerSchema = Type.Object({
+    task: Type.String({
+        description: "Detailed description of what the worker should do. Be specific: include what to search for, " +
+            "what sources to look at, and what format the result should take.",
+    }),
+    type: Type.Optional(Type.String({
+        description: "Worker type name from config. When set, the worker inherits the type's model, tools, " +
+            "and timeout as defaults. Explicit model/tools/timeout_seconds parameters still override.",
+    })),
+    tools: Type.Optional(Type.Array(Type.Union([Type.Literal("web_search"), Type.Literal("fetch_url")]), {
+        description: "Tools the worker may use. Defaults to [\"web_search\", \"fetch_url\"]. " +
+            "Omit fetch_url if only keyword search is needed.",
+    })),
+    model: Type.Optional(Type.String({
+        description: "Model to use for this worker. Defaults to the type's model if a type is set, " +
+            "otherwise the configured worker default.",
+    })),
+    timeout_seconds: Type.Optional(Type.Number({
+        description: "Maximum seconds before the worker is forcibly stopped. Default: 3600 (1 hour).",
+    })),
+});
+const checkWorkerSchema = Type.Object({
+    worker_id: Type.String({ description: "The worker_id returned by worker_dispatch." }),
+});
+const interruptWorkerSchema = Type.Object({
+    worker_id: Type.String({ description: "The worker_id returned by worker_dispatch." }),
+});
+const steerWorkerSchema = Type.Object({
+    worker_id: Type.String({ description: "The worker_id returned by worker_dispatch." }),
+    guidance: Type.String({
+        description: "New instructions for the worker. Be specific: what to focus on, what to skip, " +
+            "what to add. The worker checks for this after every few tool calls and adjusts accordingly. " +
+            "Replaces any prior steering — include everything the worker needs.",
+    }),
+});
+// ---------------------------------------------------------------------------
+// Tool factory
+// ---------------------------------------------------------------------------
+/**
+ * Create worker tools (dispatch, check, interrupt, steer).
+ * When isWorkerSession is true, dispatch rejects all calls (no nesting).
+ */
+export function createWorkerTools(config, memoryStore, registry, isWorkerSession = false, projectionStore, onTrigger) {
+    // Build description dynamically to include configured worker types
+    const types = config.tools.workers.types ?? {};
+    const typeNames = Object.keys(types);
+    let typesSuffix = "";
+    if (typeNames.length > 0) {
+        const typeLines = typeNames.map((name) => {
+            const t = types[name];
+            const parts = [name];
+            if (t.description)
+                parts.push(`— ${t.description}`);
+            if (t.model)
+                parts.push(`(model: ${t.model})`);
+            return parts.join(" ");
+        });
+        typesSuffix =
+            ` Available worker types: ${typeLines.join("; ")}. ` +
+                `Set the "type" parameter to use a type's defaults.`;
+    }
+    const dispatchTool = {
+        name: "worker_dispatch",
+        label: "worker_dispatch",
+        description: "Dispatch a background worker to perform a long-running task (research, content gathering, etc.). " +
+            "Returns immediately — the worker runs in the background. " +
+            "After dispatching, create a projection with trigger_on_fact matching the worker completion fact " +
+            "(e.g. 'worker <id> complete') so you are notified when results are ready. " +
+            "Workers can use web_search and fetch_url. They write results to result.md. " +
+            `Max ${config.tools.workers.max_concurrent} concurrent workers.` +
+            typesSuffix,
+        parameters: dispatchWorkerSchema,
+        async execute(_toolCallId, { task, type: typeName, tools: requestedTools, model: modelOverride, timeout_seconds }) {
+            // Hard block: no nesting
+            if (isWorkerSession) {
+                return toolError("Workers cannot dispatch other workers.");
+            }
+            // Concurrency limit
+            const maxConcurrent = config.tools.workers.max_concurrent;
+            if (registry.runningCount() >= maxConcurrent) {
+                return toolError(`Maximum concurrent workers (${maxConcurrent}) already running. ` +
+                    `Use worker_check to see current workers, or wait for one to complete.`);
+            }
+            // Resolve worker type defaults (explicit params override type defaults)
+            const workerType = typeName ? config.tools.workers.types?.[typeName] : undefined;
+            if (typeName && !workerType) {
+                const available = Object.keys(config.tools.workers.types ?? {});
+                return toolError(`Unknown worker type "${typeName}". ` +
+                    (available.length > 0
+                        ? `Available types: ${available.join(", ")}`
+                        : "No worker types configured."));
+            }
+            const effectiveTools = requestedTools ?? workerType?.tools ?? ["web_search", "fetch_url"];
+            const effectiveTimeout = timeout_seconds ?? workerType?.timeout_seconds;
+            const effectiveModel = modelOverride ?? workerType?.model;
+            // Validate requested tools
+            const toolNames = [];
+            for (const t of effectiveTools) {
+                if (!ALLOWED_TOOLS.includes(t)) {
+                    return toolError(`Unknown tool "${t}". Allowed: ${ALLOWED_TOOLS.join(", ")}`);
+                }
+                toolNames.push(t);
+            }
+            if (toolNames.length === 0) {
+                toolNames.push("web_search", "fetch_url");
+            }
+            // Create worker directory
+            const workerId = `w-${crypto.randomUUID().slice(0, 8)}`;
+            const workerDir = path.join(config.data_dir, "files", "workers", workerId);
+            fs.mkdirSync(workerDir, { recursive: true });
+            // Write task brief
+            fs.writeFileSync(path.join(workerDir, "task.md"), task, "utf-8");
+            const timeoutMs = effectiveTimeout ? effectiveTimeout * 1000 : DEFAULT_TIMEOUT_MS;
+            // Resolve display model for registry/logs. The actual model resolution
+            // (with fallback chain) happens inside spawnWorkerSession.
+            const displayModel = effectiveModel
+                ?? config.tools.workers.model
+                ?? config.agent.fallback_models?.[0]
+                ?? config.agent.model;
+            const resultPath = path.join(workerDir, "result.md");
+            // Register immediately so worker_check can find it
+            registry.register({
+                workerId,
+                status: "running",
+                task,
+                resultPath,
+                workerDir,
+                startedAt: new Date(),
+                error: null,
+                model: displayModel,
+                abort: null,
+                timeoutHandle: null,
+            });
+            // Write initial status.json
+            writeStatusFile(workerDir, {
+                worker_id: workerId,
+                status: "running",
+                task,
+                started_at: new Date().toISOString(),
+                completed_at: null,
+                model: displayModel,
+                error: null,
+                result_path: resultPath,
+            });
+            console.log(`[worker] Dispatching ${workerId} (model: ${displayModel}, tools: ${toolNames.join(", ")})`);
+            // Spawn in background — intentionally not awaited
+            spawnWorkerSession({
+                config,
+                workerId,
+                workerDir,
+                task,
+                modelOverride: effectiveModel,
+                toolNames,
+                memoryStore,
+                projectionStore,
+                registry,
+                timeoutMs,
+                onTrigger,
+            }).catch((err) => {
+                console.error(`[worker] ${workerId} spawn failed:`, err.message);
+                registry.update(workerId, {
+                    status: "failed",
+                    completedAt: new Date(),
+                    error: `Spawn failed: ${err.message}`,
+                });
+            });
+            // Return immediately — worker is running in the background
+            const relativeResultPath = path.relative(config.data_dir, resultPath);
+            return toolSuccess({
+                worker_id: workerId,
+                status: "running",
+                result_path: relativeResultPath,
+                trigger_hint: `worker ${workerId} complete`,
+                note: `Worker dispatched. Create a projection with trigger_on_fact: "worker ${workerId} complete" ` +
+                    `to be notified when results are ready. Results will be at: ${relativeResultPath}`,
+            });
+        },
+    };
+    const checkTool = {
+        name: "worker_check",
+        label: "worker_check",
+        description: "Check the status of a background worker. " +
+            "Use when the user asks how a task is progressing, or to verify completion before reading results.",
+        parameters: checkWorkerSchema,
+        async execute(_toolCallId, { worker_id }) {
+            const entry = registry.get(worker_id);
+            if (!entry) {
+                // Try reading from status.json on disk as a fallback (survives restarts)
+                const workerDir = path.join(config.data_dir, "files", "workers", worker_id);
+                const statusFile = path.join(workerDir, "status.json");
+                if (fs.existsSync(statusFile)) {
+                    try {
+                        const data = JSON.parse(fs.readFileSync(statusFile, "utf-8"));
+                        const relResult = path.relative(config.data_dir, data.result_path);
+                        const elapsed = data.completed_at
+                            ? Math.round((new Date(data.completed_at).getTime() - new Date(data.started_at).getTime()) / 60000)
+                            : null;
+                        return toolSuccess({
+                            worker_id: data.worker_id,
+                            status: data.status,
+                            elapsed_minutes: elapsed,
+                            result_path: relResult,
+                            error: data.error ?? undefined,
+                            note: "Status read from disk (worker no longer in active registry).",
+                        });
+                    }
+                    catch {
+                        // Fall through to not-found
+                    }
+                }
+                return toolError(`Worker not found: ${worker_id}`);
+            }
+            const elapsedMs = Date.now() - entry.startedAt.getTime();
+            const elapsedMinutes = Math.round(elapsedMs / 60000);
+            const relativeResultPath = path.relative(config.data_dir, entry.resultPath);
+            return toolSuccess({
+                worker_id: entry.workerId,
+                status: entry.status,
+                elapsed_minutes: elapsedMinutes,
+                result_path: relativeResultPath,
+                ...(entry.error ? { error: entry.error } : {}),
+                ...(entry.status === "complete" ? { note: `Results available at ${relativeResultPath}` } : {}),
+            });
+        },
+    };
+    const interruptTool = {
+        name: "worker_interrupt",
+        label: "worker_interrupt",
+        description: "Cancel a running background worker immediately. " +
+            "Use when the task is no longer needed, the user asks you to stop it, or the worker is taking too long. " +
+            "If the worker has already finished, this is a no-op and returns the current status.",
+        parameters: interruptWorkerSchema,
+        async execute(_toolCallId, { worker_id }) {
+            const entry = registry.get(worker_id);
+            if (!entry) {
+                // Check disk as a fallback (worker may have been cleaned up from registry)
+                const workerDir = path.join(config.data_dir, "files", "workers", worker_id);
+                const statusFile = path.join(workerDir, "status.json");
+                if (fs.existsSync(statusFile)) {
+                    try {
+                        const data = JSON.parse(fs.readFileSync(statusFile, "utf-8"));
+                        return toolSuccess({
+                            worker_id,
+                            status: data.status,
+                            note: `Worker already finished with status "${data.status}". Nothing to interrupt.`,
+                        });
+                    }
+                    catch {
+                        // Fall through
+                    }
+                }
+                return toolError(`Worker not found: ${worker_id}`);
+            }
+            // Already in a terminal state — nothing to do
+            if (entry.status !== "running") {
+                return toolSuccess({
+                    worker_id,
+                    status: entry.status,
+                    note: `Worker already in terminal state "${entry.status}". Nothing to interrupt.`,
+                });
+            }
+            // Cancel the timeout so it doesn't fire after we've already cancelled
+            if (entry.timeoutHandle) {
+                clearTimeout(entry.timeoutHandle);
+            }
+            // Mark cancelled before calling abort() so the spawnWorkerSession catch
+            // block sees the terminal status and skips overwriting it
+            const cancelledAt = new Date();
+            registry.update(worker_id, {
+                status: "cancelled",
+                completedAt: cancelledAt,
+                error: null,
+                timeoutHandle: null,
+            });
+            writeStatusFile(path.join(config.data_dir, "files", "workers", worker_id), {
+                worker_id,
+                status: "cancelled",
+                task: entry.task,
+                started_at: entry.startedAt.toISOString(),
+                completed_at: cancelledAt.toISOString(),
+                model: entry.model,
+                error: null,
+                result_path: entry.resultPath,
+            });
+            // Abort the session if it's running. abort() may throw — treat as best-effort
+            if (entry.abort) {
+                try {
+                    await entry.abort();
+                }
+                catch {
+                    // Best-effort — the status is already set to cancelled
+                }
+            }
+            // Archive a cancellation fact so any projections watching this worker can clean up
+            const modelsDir = path.join(config.data_dir, ".models");
+            const factContent = `Worker ${worker_id} cancelled`;
+            try {
+                const embedding = await embed(factContent, modelsDir);
+                memoryStore.addFact(factContent, "worker", embedding);
+                console.log(`[worker] ${worker_id} cancellation fact archived`);
+            }
+            catch (err) {
+                console.error(`[worker] ${worker_id} failed to archive cancellation fact:`, err.message);
+            }
+            console.log(`[worker] ${worker_id} cancelled`);
+            return toolSuccess({
+                worker_id,
+                status: "cancelled",
+                note: "Worker has been cancelled. Any partial results may still exist in the worker directory.",
+            });
+        },
+    };
+    const steerTool = {
+        name: "worker_steer",
+        label: "worker_steer",
+        description: "Send updated guidance to a running background worker. " +
+            "The worker checks for a steering.md file after every few tool calls and incorporates the instructions. " +
+            "Use this to narrow focus, redirect research, add requirements, or correct course mid-task. " +
+            "Each call replaces the previous steering note — include everything the worker needs. " +
+            "Has no effect on workers that have already finished.",
+        parameters: steerWorkerSchema,
+        async execute(_toolCallId, { worker_id, guidance }) {
+            const entry = registry.get(worker_id);
+            if (!entry) {
+                return toolError(`Worker not found: ${worker_id}`);
+            }
+            if (entry.status !== "running") {
+                return toolSuccess({
+                    worker_id,
+                    status: entry.status,
+                    note: `Worker is already in terminal state "${entry.status}". Steering has no effect.`,
+                });
+            }
+            const steeringPath = path.join(entry.workerDir, "steering.md");
+            try {
+                fs.writeFileSync(steeringPath, guidance, "utf-8");
+            }
+            catch (error) {
+                return toolError(error, "Failed to write steering note");
+            }
+            console.log(`[worker] ${worker_id} steering note updated (${Buffer.byteLength(guidance, "utf-8")} bytes)`);
+            return toolSuccess({
+                worker_id,
+                status: "running",
+                note: "Steering note written. The worker will pick it up after its next few tool calls " +
+                    "and adjust its work accordingly.",
+            });
+        },
+    };
+    return [dispatchTool, checkTool, interruptTool, steerTool];
+}
+//# sourceMappingURL=tools.js.map

package/dist/workers/tools.js.map

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

package/docker-compose.yml

@@ -0,0 +1,72 @@
+services:
+  bryti:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    restart: unless-stopped
+    volumes:
+      - ./data:/data
+    env_file: .env
+    environment:
+      - BRYTI_DATA_DIR=/data
+
+  # ---------------------------------------------------------------------------
+  # HedgeDoc — collaborative document editing (optional)
+  #
+  # Provides document_create, document_update, document_read tools via the
+  # documents-hedgedoc extension in data/files/extensions/.
+  #
+  # To activate:
+  #   1. Uncomment this block and hedgedoc_db below
+  #   2. Set HEDGEDOC_URL and HEDGEDOC_PUBLIC_URL in your .env file
+  #   3. The extension picks them up automatically on next start
+  #
+  # .env entries needed:
+  #   HEDGEDOC_URL=http://hedgedoc:3000
+  #   HEDGEDOC_PUBLIC_URL=https://docs.yourdomain.com
+  #   HEDGEDOC_DOMAIN=docs.yourdomain.com
+  #   HEDGEDOC_SECRET=<run: openssl rand -hex 32>
+  # ---------------------------------------------------------------------------
+  # hedgedoc:
+  #   image: quay.io/hedgedoc/hedgedoc:1.10
+  #   restart: unless-stopped
+  #   environment:
+  #     - CMD_DB_URL=postgres://hedgedoc:hedgedoc@hedgedoc_db:5432/hedgedoc
+  #     - CMD_DOMAIN=${HEDGEDOC_DOMAIN}          # public hostname, no protocol
+  #     - CMD_URL_ADDPORT=false
+  #     - CMD_PROTOCOL_USESSL=true
+  #     - CMD_ALLOW_ANONYMOUS=true               # allow anonymous note creation
+  #     - CMD_ALLOW_FREEURL=true                 # required for document_update to work
+  #     - CMD_SESSION_SECRET=${HEDGEDOC_SECRET}
+  #   volumes:
+  #     - hedgedoc_uploads:/hedgedoc/public/uploads
+  #   depends_on:
+  #     - hedgedoc_db
+  #
+  # hedgedoc_db:
+  #   image: postgres:16-alpine
+  #   restart: unless-stopped
+  #   environment:
+  #     - POSTGRES_USER=hedgedoc
+  #     - POSTGRES_PASSWORD=hedgedoc
+  #     - POSTGRES_DB=hedgedoc
+  #   volumes:
+  #     - hedgedoc_db_data:/var/lib/postgresql/data
+
+  # Uncomment for production with webhook mode
+  # caddy:
+  #   image: caddy:2-alpine
+  #   restart: unless-stopped
+  #   ports:
+  #     - "80:80"
+  #     - "443:443"
+  #   volumes:
+  #     - ./Caddyfile:/etc/caddy/Caddyfile
+  #     - caddy_data:/data
+  #     - caddy_config:/config
+
+# volumes:
+#   caddy_data:
+#   caddy_config:
+#   hedgedoc_uploads:
+#   hedgedoc_db_data:

package/package.json

@@ -1,10 +1,25 @@
 {
   "name": "@bryti/agent",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Your AI colleague, in the apps you already use.",
   "license": "AGPL-3.0-only",
   "type": "module",
   "private": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/larsderidder/bryti"
+  },
+  "main": "dist/index.js",
+  "bin": {
+    "bryti": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "config.example.yml",
+    "run.sh",
+    "Dockerfile",
+    "docker-compose.yml"
+  ],
   "scripts": {
     "build": "tsc && cp -r defaults dist/",
     "dev": "tsc --watch",

package/run.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+RESTART_DELAY_SECONDS="${RESTART_DELAY_SECONDS:-2}"
+
+while true; do
+  echo "Building TypeScript..."
+  npm run build
+
+  exit_code=0
+  node --env-file=.env dist/index.js || exit_code=$?
+
+  if [ "$exit_code" -eq 0 ]; then
+    echo "Bryti stopped cleanly."
+    exit 0
+  fi
+
+  if [ "$exit_code" -eq 42 ]; then
+    echo "Bryti restart requested. Rebuilding and restarting..."
+    continue
+  fi
+
+  echo "Bryti crashed (exit code $exit_code). Restarting in ${RESTART_DELAY_SECONDS}s..."
+  sleep "$RESTART_DELAY_SECONDS"
+done