@agent-native/core 0.4.5 → 0.6.1

package/dist/server/agent-teams.js

@@ -0,0 +1,367 @@
+/**
+ * Agent Teams — sub-agent orchestration for agent-native.
+ *
+ * The main agent chat acts as an orchestrator. It spawns sub-agents
+ * for individual tasks, which run in their own threads. Sub-agents
+ * appear as rich preview cards (chips) inline in the main chat.
+ *
+ * This module provides the server-side infrastructure:
+ * - Creating sub-agent threads and running them in background
+ * - Tracking task status and results
+ * - Emitting SSE events for live preview cards
+ * - Bidirectional messaging between main agent and sub-agents
+ *
+ * Task state is persisted in application_state (SQL) so it survives
+ * serverless cold starts and works across multiple processes.
+ */
+import { actionsToEngineTools } from "../agent/production-agent.js";
+import { createAnthropicEngine } from "../agent/engine/anthropic-engine.js";
+import { createThread } from "../chat-threads/store.js";
+import { startRun } from "../agent/run-manager.js";
+import { runAgentLoop } from "../agent/production-agent.js";
+import { readAppState, writeAppState, listAppState, } from "../application-state/script-helpers.js";
+/** Key prefix for task records: agent-task:{taskId} */
+const TASK_PREFIX = "agent-task:";
+/** Key prefix for thread→task reverse lookup: agent-task-thread:{threadId} */
+const THREAD_PREFIX = "agent-task-thread:";
+async function saveTask(task) {
+    await writeAppState(`${TASK_PREFIX}${task.taskId}`, task);
+    await writeAppState(`${THREAD_PREFIX}${task.threadId}`, {
+        taskId: task.taskId,
+    });
+}
+async function loadTask(taskId) {
+    const data = await readAppState(`${TASK_PREFIX}${taskId}`);
+    return data ? data : null;
+}
+async function loadTaskByThread(threadId) {
+    const ref = await readAppState(`${THREAD_PREFIX}${threadId}`);
+    if (!ref || !ref.taskId)
+        return null;
+    return loadTask(ref.taskId);
+}
+function generateTaskId() {
+    return `task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+/**
+ * Spawn a sub-agent task. Creates a thread, starts a background agent run,
+ * and emits agent_task events to the parent chat stream.
+ */
+export async function spawnTask(opts) {
+    const taskId = generateTaskId();
+    // Create a dedicated thread for the sub-agent with the task as the first message
+    const thread = await createThread(opts.ownerEmail, {
+        title: opts.description.slice(0, 100),
+    });
+    // Save the initial user message to thread data so the tab shows content immediately.
+    // Format must match assistant-ui's threadRuntime.import() expectations:
+    // content must be an array of parts, not a plain string.
+    try {
+        const { updateThreadData } = await import("../chat-threads/store.js");
+        const threadData = JSON.stringify({
+            messages: [
+                {
+                    message: {
+                        id: `msg-${Date.now()}-user`,
+                        role: "user",
+                        content: [{ type: "text", text: opts.description }],
+                        metadata: {},
+                    },
+                },
+            ],
+        });
+        await updateThreadData(thread.id, threadData, opts.description.slice(0, 100), opts.description.slice(0, 200), 1);
+    }
+    catch {
+        // Best effort — thread will still work without persisted messages
+    }
+    const task = {
+        taskId,
+        threadId: thread.id,
+        description: opts.description,
+        status: "running",
+        preview: "",
+        summary: "",
+        currentStep: "",
+        createdAt: Date.now(),
+    };
+    await saveTask(task);
+    // Notify parent chat that a sub-agent was spawned
+    opts.parentSend({
+        type: "agent_task",
+        taskId,
+        threadId: thread.id,
+        description: opts.description,
+        status: "running",
+    });
+    // Build scoped system prompt
+    // Prepend a clear "you are a sub-agent" reminder so the agent doesn't
+    // start exploring the file system or database before using its actions.
+    const actionNames = Object.keys(opts.actions).join(", ");
+    const subAgentPreamble = `## You Are a Sub-Agent
+
+You are a focused sub-agent with a specific task. You have been given a curated set of actions that connect directly to the app's database and services.
+
+**Start immediately with your task. Do NOT:**
+- Run \`db-schema\` to explore the database structure
+- Run \`search-files\` or \`list-files\` to find code
+- Try to \`curl\` or access external URLs to find the app
+- Use \`shell\` for exploration — only for running \`pnpm action\` commands when no direct action exists
+
+**Your available actions (${actionNames}) work directly. Use them.**
+
+`;
+    let systemPrompt = subAgentPreamble + opts.systemPrompt;
+    if (opts.instructions) {
+        systemPrompt += `\n\n## Task-Specific Instructions\n\n${opts.instructions}`;
+    }
+    // Resolve the engine — prefer the passed engine, fall back to Anthropic with apiKey
+    const engine = opts.engine ?? createAnthropicEngine({ apiKey: opts.apiKey });
+    const model = opts.model ?? engine.defaultModel;
+    // Build tools from actions using the normalized EngineTool format
+    const tools = actionsToEngineTools(opts.actions);
+    const messages = [
+        { role: "user", content: [{ type: "text", text: opts.description }] },
+    ];
+    // Start the agent run in background
+    const runId = `run-task-${taskId}`;
+    let accumulatedText = "";
+    let lastPreviewSent = 0;
+    const PREVIEW_INTERVAL_MS = 300; // Throttle preview updates to every 300ms
+    // Gate to prevent sendPreviewUpdate from overwriting terminal status
+    let runFinished = false;
+    startRun(runId, thread.id, async (send, signal) => {
+        const sendPreviewUpdate = async (force = false) => {
+            if (runFinished)
+                return; // Don't overwrite completed/errored status
+            const now = Date.now();
+            if (!force && now - lastPreviewSent < PREVIEW_INTERVAL_MS)
+                return;
+            lastPreviewSent = now;
+            task.preview = accumulatedText.slice(-800);
+            // Persist to SQL so task-status calls from other processes see live state
+            await saveTask(task);
+            opts.parentSend({
+                type: "agent_task_update",
+                taskId,
+                preview: task.preview,
+                currentStep: task.currentStep,
+            });
+        };
+        // Wrap the send function to also emit preview updates to parent
+        const wrappedSend = (event) => {
+            send(event);
+            if (event.type === "text") {
+                accumulatedText += event.text;
+                sendPreviewUpdate();
+            }
+            else if (event.type === "tool_start") {
+                task.currentStep = `Running ${event.tool}...`;
+                sendPreviewUpdate(true);
+            }
+            else if (event.type === "tool_done") {
+                task.currentStep = "";
+                sendPreviewUpdate(true);
+            }
+        };
+        await runAgentLoop({
+            engine,
+            model,
+            systemPrompt,
+            tools,
+            messages,
+            actions: opts.actions,
+            send: wrappedSend,
+            signal,
+        });
+    }, 
+    // onComplete callback — called when the run finishes (success or error)
+    async (run) => {
+        // Prevent any in-flight sendPreviewUpdate from overwriting terminal status
+        runFinished = true;
+        if (run.status === "errored") {
+            task.status = "errored";
+            task.summary = accumulatedText.slice(-500) || "Task failed.";
+            await saveTask(task);
+            // Emit error as agent_task_complete with errored status
+            opts.parentSend({
+                type: "agent_task",
+                taskId,
+                threadId: thread.id,
+                description: task.description,
+                status: "errored",
+            });
+        }
+        else {
+            task.status = "completed";
+            task.summary =
+                accumulatedText.slice(-1000) || "Task completed successfully.";
+            await saveTask(task);
+            opts.parentSend({
+                type: "agent_task_complete",
+                taskId,
+                summary: task.summary,
+            });
+        }
+        // Persist the full conversation to threadData so the sub-agent tab
+        // can restore it later (after the in-memory run is cleaned up).
+        // Convert EngineMessage[] to the assistant-ui repository format.
+        try {
+            const { updateThreadData } = await import("../chat-threads/store.js");
+            const repoMessages = messages.map((msg, i) => {
+                const parts = [];
+                for (const part of msg.content) {
+                    if (part.type === "text") {
+                        parts.push({ type: "text", text: part.text });
+                    }
+                    else if (part.type === "tool-call") {
+                        parts.push({
+                            type: "tool-call",
+                            toolCallId: part.id,
+                            toolName: part.name,
+                            args: part.input,
+                        });
+                    }
+                    else if (part.type === "tool-result") {
+                        // Tool results in the user message — will be matched to tool-call below
+                    }
+                }
+                const repoMsg = {
+                    id: `msg-${taskId}-${i}`,
+                    role: msg.role,
+                    content: parts.length > 0 ? parts : [{ type: "text", text: "" }],
+                    metadata: {},
+                };
+                if (msg.role === "assistant") {
+                    repoMsg.status = { type: "complete", reason: "stop" };
+                }
+                return repoMsg;
+            });
+            // Attach tool results to their corresponding tool-call parts
+            for (const msg of messages) {
+                if (msg.role !== "user")
+                    continue;
+                for (const part of msg.content) {
+                    if (part.type !== "tool-result")
+                        continue;
+                    // Find the assistant message with the matching tool-call
+                    for (const repoMsg of repoMessages) {
+                        if (repoMsg.role !== "assistant")
+                            continue;
+                        const tc = repoMsg.content?.find((p) => p.type === "tool-call" && p.toolCallId === part.toolCallId);
+                        if (tc) {
+                            tc.result = part.content;
+                            break;
+                        }
+                    }
+                }
+            }
+            // Filter out user messages that only contain tool_result blocks (empty content)
+            const filteredMessages = repoMessages.filter((m) => m.content.length > 0 &&
+                !(m.content.length === 1 &&
+                    m.content[0].type === "text" &&
+                    m.content[0].text === ""));
+            // Wrap in assistant-ui's { message: ... } format
+            const repo = {
+                messages: filteredMessages.map((m) => ({ message: m })),
+            };
+            const title = opts.description.slice(0, 100);
+            const preview = accumulatedText.slice(0, 200);
+            await updateThreadData(thread.id, JSON.stringify(repo), title, preview, filteredMessages.length);
+        }
+        catch {
+            // Best effort — the in-memory replay path still works
+        }
+        // ─── Auto-follow-up on parent thread ────────────────────────────
+        // When the sub-agent finishes, start a short agent run on the
+        // parent thread so the user sees a recap without having to scroll
+        // up or manually check the sub-agent card.
+        if (opts.parentThreadId) {
+            try {
+                const { getActiveRunForThread } = await import("../agent/run-manager.js");
+                // Only auto-respond if the parent thread is idle — don't
+                // interrupt an ongoing conversation.
+                const activeRun = getActiveRunForThread(opts.parentThreadId);
+                if (!activeRun || activeRun.status !== "running") {
+                    const followUpEngine = opts.engine ?? createAnthropicEngine({ apiKey: opts.apiKey });
+                    const followUpModel = opts.model ?? followUpEngine.defaultModel;
+                    const statusEmoji = task.status === "errored" ? "!" : "done";
+                    const notification = `[Sub-agent ${statusEmoji}] The sub-agent task "${task.description}" has ${task.status === "errored" ? "failed" : "completed"}.\n\n` +
+                        `Summary of what it did:\n${task.summary}\n\n` +
+                        `Briefly let the user know the sub-agent finished and highlight any key results. Be concise — 1-2 sentences.`;
+                    const followUpRunId = `run-followup-${taskId}`;
+                    startRun(followUpRunId, opts.parentThreadId, async (send, signal) => {
+                        await runAgentLoop({
+                            engine: followUpEngine,
+                            model: followUpModel,
+                            systemPrompt: opts.systemPrompt,
+                            tools: [], // No tools needed for a recap
+                            messages: [
+                                {
+                                    role: "user",
+                                    content: [{ type: "text", text: notification }],
+                                },
+                            ],
+                            actions: {},
+                            send,
+                            signal,
+                        });
+                    });
+                }
+            }
+            catch {
+                // Best effort — don't break the sub-agent completion
+            }
+        }
+    });
+    return task;
+}
+/** Get task by ID */
+export async function getTask(taskId) {
+    const task = await loadTask(taskId);
+    return task ?? undefined;
+}
+/** Get task by thread ID */
+export async function getTaskByThread(threadId) {
+    const task = await loadTaskByThread(threadId);
+    return task ?? undefined;
+}
+/** List all tasks (most recent first) */
+export async function listTasks() {
+    const entries = await listAppState(TASK_PREFIX);
+    const tasks = entries.map((e) => e.value);
+    return tasks.sort((a, b) => b.createdAt - a.createdAt);
+}
+/** Send a message/update to a running sub-agent via application state */
+export async function sendToTask(taskId, message) {
+    const task = await loadTask(taskId);
+    if (!task)
+        return { ok: false, error: "Task not found" };
+    if (task.status !== "running")
+        return { ok: false, error: "Task is not running" };
+    // Write the message to application state so the sub-agent can read it
+    // on its next tool call or iteration
+    try {
+        const { appStatePut } = await import("../application-state/store.js");
+        const sessionId = process.env.AGENT_USER_EMAIL || "local@localhost";
+        await appStatePut(sessionId, `task-message:${taskId}`, {
+            from: "orchestrator",
+            message,
+            timestamp: Date.now(),
+        });
+    }
+    catch {
+        // Application state not available — best effort
+    }
+    return { ok: true };
+}
+/** Mark a task as errored */
+export async function markTaskErrored(taskId, error) {
+    const task = await loadTask(taskId);
+    if (task) {
+        task.status = "errored";
+        task.summary = error;
+        await saveTask(task);
+    }
+}
+//# sourceMappingURL=agent-teams.js.map

package/dist/server/agent-teams.js.map

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

package/dist/server/agents-bundle.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Agents bundle — loads AGENTS.md and .agents/skills/ from the template.
+ *
+ * This is the single source of truth the framework's agent uses to mirror what
+ * Claude Code / Codex / any other agent would see when running locally in the
+ * repo. The filesystem is the canonical source; this module is just a loader
+ * that works both in dev (direct fs read) and production (content bundled at
+ * build time via the `virtual:agents-bundle` Vite plugin).
+ *
+ * Resolution order inside `loadAgentsBundle()`:
+ *   1. Virtual module (`virtual:agents-bundle`) — inlined at build time by the
+ *      framework's Vite plugin. This is the ONLY path that works on edge
+ *      runtimes (Cloudflare Workers) where `readFileSync` doesn't exist.
+ *   2. Filesystem fallback — `process.cwd()/AGENTS.md` +
+ *      `process.cwd()/.agents/skills/`. Only reliable in local dev and Node
+ *      production (`agent-native start`); not on Netlify/Vercel/CF at runtime.
+ *   3. Empty bundle — everything silently returns empty strings.
+ *
+ * Result is cached in module scope so it's only computed once per cold start.
+ */
+export interface SkillMeta {
+    name: string;
+    description: string;
+}
+export interface Skill {
+    meta: SkillMeta;
+    /** Contents of SKILL.md (the entry file of the skill). */
+    content: string;
+    /**
+     * Filesystem path to the skill directory, relative to the template root
+     * (e.g. `.agents/skills/create-deck`). The agent can read any file here via
+     * shell in dev — skills are folders, not single files, and may contain
+     * supporting assets, scripts, or additional markdown.
+     */
+    dir: string;
+    /**
+     * Files inside the skill directory (relative to the skill dir), excluding
+     * `SKILL.md`. Lets the agent know what else is available without a separate
+     * `ls` call. Empty array if the skill is single-file.
+     */
+    extraFiles: string[];
+}
+export interface AgentsBundle {
+    /** Contents of the template's AGENTS.md (empty string if missing). */
+    agentsMd: string;
+    /** Map from skill name → { meta, content, dir, extraFiles }. */
+    skills: Record<string, Skill>;
+}
+/**
+ * Parse the YAML frontmatter at the top of a skill file.
+ * Only pulls out `name` and `description` — deliberately simple, no YAML lib.
+ * Handles:
+ *   - Inline: `description: Some text`
+ *   - Folded scalar: `description: >-\n  multi\n  line` → "multi line"
+ *   - Literal scalar: `description: |\n  multi\n  line` → "multi\nline"
+ */
+export declare function parseSkillFrontmatter(content: string): Partial<SkillMeta>;
+/**
+ * Read AGENTS.md + all skills directly from the filesystem rooted at `cwd`.
+ * Returns an empty bundle if nothing is found. Used by both the Vite plugin
+ * (at build time) and the runtime fallback (in dev / Node prod).
+ *
+ * Synchronous — the Vite plugin's load hook calls it inline during the build.
+ */
+export declare function readAgentsBundleFromFs(cwd: string): AgentsBundle;
+/**
+ * Load the agents bundle. Returns a cached result on subsequent calls.
+ * Tries the virtual module first (works everywhere, including edge), then
+ * falls back to filesystem reads from `process.cwd()`.
+ */
+export declare function loadAgentsBundle(): Promise<AgentsBundle>;
+/**
+ * Generate the `<skills>` block to inject into the system prompt.
+ *
+ * Skills are folders at `.agents/skills/<name>/` containing a `SKILL.md` entry
+ * file plus any number of supporting files (additional markdown, examples,
+ * images, scripts). This block lists what's available and how to read them.
+ *
+ * In dev mode the agent has shell access and reads skills via `cat` — exactly
+ * like running `claude` locally in the repo. In production mode the agent has
+ * no shell; templates that need skill content at runtime should inline the
+ * critical parts directly in `AGENTS.md`.
+ */
+export declare function generateSkillsPromptBlock(bundle: AgentsBundle): string;
+/** For tests — reset the module cache. */
+export declare function __resetAgentsBundleCache(): void;
+//# sourceMappingURL=agents-bundle.d.ts.map

package/dist/server/agents-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-bundle.d.ts","sourceRoot":"","sources":["../../src/server/agents-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC/B;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA+CzE;AAKD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAiEhE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAyB9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAsBtE;AAED,0CAA0C;AAC1C,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}