@sulala/agent 0.1.0

package/README.md

@@ -0,0 +1,120 @@
+# Sulala Agent — Local AI Orchestration Platform
+
+A local-first platform that combines **file monitoring**, **task scheduling**, **AI orchestration**, and a **plugin system**. Runs on `127.0.0.1` and stays on your machine.
+
+## Architecture (high level)
+
+| Layer | Role |
+|-------|------|
+| **Gateway** | REST + WebSocket API on `localhost:3000`; auth and request handling |
+| **File watcher** | Real-time folder watch (add/change/delete) → event triggers |
+| **Task scheduler** | Cron-like scheduling + queue with retries and failure handling |
+| **AI orchestration** | Single interface to multiple providers (OpenAI, OpenRouter, Claude, Gemini, Ollama); routing and rate limits |
+| **Plugins** | Scripts and integrations that hook into events, tasks, and AI |
+| **Persistence** | SQLite for tasks, file state, logs, and AI results |
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) and the project diagram for full layout.
+
+## Quick start
+
+```bash
+# Install dependencies
+npm install
+
+# Configure (copy and edit)
+cp .env.example .env
+
+# Run gateway + watcher + scheduler (TypeScript via tsx)
+npm start
+```
+
+**Development:** `npm run dev` runs the app with `tsx watch` (restarts on file changes). For a production build: `npm run build` then `node dist/index.js` (or run the gateway with `node dist/gateway/server.js`). Run tests with `npm test` and lint with `npm run lint`.
+
+**Dashboard (React + Vite + shadcn/ui):**
+
+- **Dev:** run the UI on its own port (e.g. 5173) while the gateway runs on 3000:
+  ```bash
+  npm run dashboard
+  ```
+  Then open the URL Vite prints (e.g. http://localhost:5173). Set `VITE_GATEWAY_URL=http://127.0.0.1:3000` in `dashboard/.env` if the API is on another host.
+- **Production:** build and serve from the gateway (one origin):
+  ```bash
+  npm run dashboard:build
+  npm start
+  ```
+  Then open http://127.0.0.1:3000 — the gateway serves the built dashboard and the API.
+
+**CLI** (from project root):
+
+```bash
+# Via npm script
+npm run cli -- status
+npm run cli -- tasks --limit=20
+npm run cli -- logs --limit=50
+npm run cli -- enqueue --type=heartbeat --payload='{"x":1}'
+
+# Or install globally: npm link (from project root)
+sulala status
+sulala tasks --limit=20
+sulala skill list
+sulala skill install apple-notes [--global]
+sulala skill update
+sulala skill uninstall apple-notes [--global]
+```
+
+**Skill commands:** `sulala skill list` lists registry skills. `sulala skill install <slug> [--global]` installs to workspace (default) or managed dir (`~/.sulala/skills`). `sulala skill update` refreshes installed skills from the registry. `sulala skill uninstall <slug> [--global]
+sulala init [dir]` removes an installed skill.
+
+Set `GATEWAY_URL` and optionally `GATEWAY_API_KEY` when using gateway commands. Set `SULALA_SKILLS_DIR` and `AGENT_CONTEXT_PATH` for skill paths.
+
+**Agent runner:** Multi-turn sessions with optional tool use. Create a session, then send messages to run the agent loop (model can call tools; built-in `run_task` enqueues background tasks). See [docs/ROADMAP_AGENT_RUNNER.md](docs/ROADMAP_AGENT_RUNNER.md) and [docs/AGENT_API.md](docs/AGENT_API.md).
+- `GET /api/agent/sessions` — list sessions (query: `limit`).
+- `POST /api/agent/sessions` — create or get session (body: `{ "session_key": "my-chat", "meta": {} }`).
+- `GET /api/agent/sessions/:id` — get session and message history.
+- `POST /api/agent/sessions/:id/messages` — send a message and run the agent turn (body: `{ "message": "…", "system_prompt": "…", "provider": "openai", "timeout_ms": 300000 }`). Returns `{ finalContent, messages, turnCount }`. Runs are serialized per session; client disconnect or timeout aborts the run (`AGENT_TIMEOUT_MS` in env or `timeout_ms` in body).
+
+**AI models:** Supported providers: OpenAI (e.g. gpt-5.2, gpt-5-mini, gpt-4o-mini), OpenRouter (one key for many models, e.g. openai/gpt-5.2, anthropic/claude-sonnet-4), Claude (Opus 4.6, Sonnet 4.6, Haiku 4.5), Gemini (2.5 Flash/Pro, 3.1 Pro), Ollama (local). See [docs/MODELS.md](docs/MODELS.md) for model IDs and env vars (`AI_*_DEFAULT_MODEL`, `OPENROUTER_API_KEY`, `GOOGLE_GEMINI_API_KEY`).
+
+**Config:** Watched folders can be set in `.env` (`WATCH_FOLDERS`) or in `config/watched.json` (array `folders`); both are merged. Optional gateway auth via `GATEWAY_API_KEY`; webhooks via `WEBHOOK_URL` or `WEBHOOK_URLS` and optional `WEBHOOK_SECRET`. AI: set `OPENAI_API_KEY`, `OPENROUTER_API_KEY`, `ANTHROPIC_API_KEY`, and/or use Ollama (`OLLAMA_BASE_URL`, default `http://localhost:11434`). Optional rate limit: `RATE_LIMIT_MAX`, `RATE_LIMIT_WINDOW_MS`. See `.env.example`.
+
+**Docker:** Build and run with dashboard served from the gateway:
+```bash
+docker compose up --build
+```
+Then open http://localhost:3000. Mount `./config` for watched folders; data is stored in a named volume.
+
+## Requirements
+
+- **Node.js** 18+
+- **TypeScript** + **tsx** (dev; in package.json)
+- **Python 3.10+** (optional, for AI/automation scripts)
+- SQLite (included via `better-sqlite3`)
+
+## Project layout
+
+Backend is TypeScript (`src/**/*.ts`); runs with `tsx` or compile with `tsc` to `dist/`.
+
+```
+sulala_agent/
+├── src/
+│   ├── gateway/      # API server (REST/WS), auth
+│   ├── watcher/      # File/folder watcher (chokidar)
+│   ├── scheduler/    # Cron + task queue
+│   ├── ai/           # AI orchestration (multi-provider)
+│   ├── plugins/      # Plugin loader and hooks
+│   └── db/           # SQLite schema and access
+├── scripts/          # User and plugin automation (Python/Node/Bash)
+├── config/           # Watched folders, cron rules, plugin config
+├── docs/
+└── dashboard/        # Web UI (React + Vite + Tailwind + shadcn/ui)
+```
+
+## Security
+
+- Services bind to `127.0.0.1` only (no internet exposure by default).
+- Store API keys and secrets in `.env`; never commit them.
+- Plugins and automation scripts can be sandboxed (e.g. run in subprocess with limited permissions).
+
+## License
+
+MIT

package/bin/sulala.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Production CLI entry. Runs the built dist/cli.js.
+ * Install with: npm install -g sulala-agent (or pnpm link from sulala/)
+ * Then: sulala skill install <slug>
+ */
+import '../dist/cli.js';

package/dist/agent/loop.d.ts

@@ -0,0 +1,38 @@
+import type { AgentTurnMessage } from '../types.js';
+export type AgentStreamEvent = {
+    type: 'assistant';
+    delta: string;
+} | {
+    type: 'tool_call';
+    name: string;
+    result?: unknown;
+} | {
+    type: 'done';
+    finalContent: string;
+    turnCount: number;
+} | {
+    type: 'error';
+    message: string;
+};
+export interface RunTurnOptions {
+    sessionId: string;
+    userMessage?: string | null;
+    systemPrompt?: string | null;
+    provider?: string;
+    model?: string;
+    max_tokens?: number;
+    /** Max run time in ms; overrides config.agentTimeoutMs when set. */
+    timeoutMs?: number;
+    /** When aborted, the run throws. Used for request disconnect or cancel. */
+    signal?: AbortSignal;
+}
+export interface RunTurnResult {
+    sessionId: string;
+    messages: AgentTurnMessage[];
+    finalContent: string;
+    turnCount: number;
+}
+export declare function runAgentTurn(options: RunTurnOptions): Promise<RunTurnResult>;
+/** Run agent turn with streaming (OpenAI: deltas; others: single done). */
+export declare function runAgentTurnStream(options: RunTurnOptions, onEvent: (ev: AgentStreamEvent) => void): Promise<RunTurnResult>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/agent/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAErE,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA6CvC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AA4FD,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAmHlF;AAED,2EAA2E;AAC3E,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,IAAI,GACtC,OAAO,CAAC,aAAa,CAAC,CAyJxB"}

package/dist/agent/loop.js

@@ -0,0 +1,384 @@
+import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { complete, completeStream } from '../ai/orchestrator.js';
+import { getAgentMessages, appendAgentMessage } from '../db/index.js';
+import { log } from '../db/index.js';
+import { config } from '../config.js';
+import { runAgentHooksSessionStart, runAgentHooksSessionEnd, runAgentHooksBeforePromptBuild, runAgentHooksBeforeToolCall, runAgentHooksAfterToolCall, runAgentHooksAgentEnd, } from '../plugins/index.js';
+import { listTools, executeTool } from './tools.js';
+import { getSkillPaths } from './skills.js';
+import { isSkillEnabled } from './skills-config.js';
+const DEFAULT_SYSTEM = 'You are a helpful assistant. You have access to tools; use them when appropriate.';
+const MAX_TOOL_TURNS = 10;
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        const e = new Error('Agent run aborted');
+        e.name = 'AbortError';
+        throw e;
+    }
+}
+function buildEffectiveSignal(options) {
+    const timeoutMs = options.timeoutMs ?? config.agentTimeoutMs ?? 0;
+    if (timeoutMs <= 0 && !options.signal)
+        return { signal: undefined, cleanup: () => { } };
+    const controller = new AbortController();
+    let timer = null;
+    if (timeoutMs > 0)
+        timer = setTimeout(() => controller.abort(), timeoutMs);
+    if (options.signal)
+        options.signal.addEventListener('abort', () => controller.abort());
+    return {
+        signal: controller.signal,
+        cleanup: () => {
+            if (timer != null)
+                clearTimeout(timer);
+        },
+    };
+}
+function rowsToMessages(rows) {
+    return rows.map((r) => {
+        const msg = { role: r.role };
+        if (r.content != null)
+            msg.content = r.content;
+        if (r.tool_calls) {
+            try {
+                msg.tool_calls = JSON.parse(r.tool_calls);
+            }
+            catch {
+                // ignore
+            }
+        }
+        if (r.tool_call_id)
+            msg.tool_call_id = r.tool_call_id;
+        if (r.name)
+            msg.name = r.name;
+        return msg;
+    });
+}
+/** Parse YAML-like frontmatter (--- ... ---) and return name, description, and body. */
+function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return { body: content };
+    const block = match[1];
+    const body = match[2].trim();
+    let name;
+    let description;
+    for (const line of block.split(/\r?\n/)) {
+        const nameMatch = line.match(/^name:\s*(.+)$/);
+        if (nameMatch)
+            name = nameMatch[1].trim().replace(/^['"]|['"]$/g, '');
+        const descMatch = line.match(/^description:\s*(.+)$/);
+        if (descMatch)
+            description = descMatch[1].trim().replace(/^['"]|['"]$/g, '');
+    }
+    return { name, description, body };
+}
+function collectFiles(base) {
+    const files = [];
+    if (!existsSync(base))
+        return files;
+    try {
+        const stat = statSync(base);
+        if (stat.isFile() && (base.endsWith('.md') || base.endsWith('.txt'))) {
+            files.push({ path: base, name: base.split(/[/\\]/).pop() || '' });
+        }
+        else if (stat.isDirectory()) {
+            const names = readdirSync(base).sort();
+            for (const n of names) {
+                if (!n.endsWith('.md') && !n.endsWith('.txt'))
+                    continue;
+                files.push({ path: join(base, n), name: n });
+            }
+        }
+    }
+    catch (e) {
+        log('agent', 'warn', `Skip skill path ${base}: ${e.message}`);
+    }
+    return files;
+}
+function loadContextFromPaths() {
+    const paths = getSkillPaths(config);
+    const bySkillName = new Map();
+    const nonSkillChunks = [];
+    for (const { path: base } of paths) {
+        for (const { path: full, name: fileName } of collectFiles(base)) {
+            try {
+                const raw = readFileSync(full, 'utf8');
+                if (!fileName.endsWith('.md')) {
+                    nonSkillChunks.push(`--- ${fileName}\n${raw}`);
+                    continue;
+                }
+                const parsed = parseFrontmatter(raw);
+                if (parsed.name && parsed.description && isSkillEnabled(parsed.name)) {
+                    bySkillName.set(parsed.name, {
+                        index: { name: parsed.name, description: parsed.description },
+                        body: parsed.body,
+                    });
+                }
+                else {
+                    nonSkillChunks.push(`--- ${fileName}\n${raw}`);
+                }
+            }
+            catch (e) {
+                log('agent', 'warn', `Skip context file ${full}: ${e.message}`);
+            }
+        }
+    }
+    const skillIndex = Array.from(bySkillName.values()).map((v) => v.index);
+    const chunks = Array.from(bySkillName.values()).map((v) => `### Skill: ${v.index.name}\n\n${v.body}`);
+    chunks.push(...nonSkillChunks);
+    if (chunks.length === 0)
+        return '';
+    const indexSection = skillIndex.length > 0
+        ? `### Available skills (use when the user's request matches)\n${skillIndex.map((s) => `- **${s.name}**: ${s.description}`).join('\n')}\n\n`
+        : '';
+    return `\n\n## Context\n\n${indexSection}${chunks.join('\n\n')}`;
+}
+async function resolveSystemPrompt(sessionId, basePrompt, messageCount) {
+    const context = loadContextFromPaths();
+    const withContext = basePrompt + context;
+    const overridden = await runAgentHooksBeforePromptBuild(sessionId, {
+        systemPrompt: withContext,
+        messageCount,
+    });
+    return overridden ?? withContext;
+}
+export async function runAgentTurn(options) {
+    const { sessionId, userMessage = null, systemPrompt: optionPrompt = null, provider, model, max_tokens = 1024, } = options;
+    const { signal, cleanup } = buildEffectiveSignal(options);
+    try {
+        throwIfAborted(signal);
+        await runAgentHooksSessionStart(sessionId);
+        const history = getAgentMessages(sessionId);
+        const messages = [];
+        const baseSystem = optionPrompt ?? config.agentSystemPrompt ?? DEFAULT_SYSTEM;
+        const systemPrompt = await resolveSystemPrompt(sessionId, baseSystem, history.length + 1);
+        if (systemPrompt) {
+            messages.push({ role: 'system', content: systemPrompt });
+        }
+        messages.push(...rowsToMessages(history));
+        if (userMessage) {
+            messages.push({ role: 'user', content: userMessage });
+            appendAgentMessage({ session_id: sessionId, role: 'user', content: userMessage });
+        }
+        const toolsForApi = listTools().map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+        }));
+        let turnCount = 0;
+        let lastContent = '';
+        while (turnCount < MAX_TOOL_TURNS) {
+            throwIfAborted(signal);
+            turnCount++;
+            const result = await complete({
+                provider,
+                model,
+                messages,
+                max_tokens,
+                tools: toolsForApi.length ? toolsForApi : undefined,
+                signal,
+            });
+            lastContent = result.content ?? '';
+            const assistantContent = result.content ?? null;
+            const toolCalls = result.tool_calls;
+            appendAgentMessage({
+                session_id: sessionId,
+                role: 'assistant',
+                content: assistantContent,
+                tool_calls: toolCalls ? JSON.stringify(toolCalls) : null,
+            });
+            if (!toolCalls?.length) {
+                break;
+            }
+            messages.push({
+                role: 'assistant',
+                content: assistantContent,
+                tool_calls: toolCalls,
+            });
+            for (const tc of toolCalls) {
+                throwIfAborted(signal);
+                let args = tc.arguments ? JSON.parse(tc.arguments) : {};
+                args = await runAgentHooksBeforeToolCall(sessionId, tc.name, args);
+                let toolResult;
+                try {
+                    toolResult = await executeTool(tc.name, args);
+                }
+                catch (err) {
+                    toolResult = { error: err instanceof Error ? err.message : String(err) };
+                    log('agent', 'warn', `Tool ${tc.name} failed`, { error: err.message });
+                }
+                await runAgentHooksAfterToolCall(sessionId, tc.name, args, toolResult);
+                messages.push({
+                    role: 'tool',
+                    tool_call_id: tc.id,
+                    name: tc.name,
+                    content: typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult),
+                });
+                appendAgentMessage({
+                    session_id: sessionId,
+                    role: 'tool',
+                    tool_call_id: tc.id,
+                    name: tc.name,
+                    content: typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult),
+                });
+            }
+        }
+        const updatedHistory = getAgentMessages(sessionId);
+        const result = {
+            sessionId,
+            messages: rowsToMessages(updatedHistory),
+            finalContent: lastContent,
+            turnCount,
+        };
+        await runAgentHooksAgentEnd(sessionId, { finalContent: lastContent, turnCount });
+        return result;
+    }
+    finally {
+        cleanup();
+        await runAgentHooksSessionEnd(sessionId);
+    }
+}
+/** Run agent turn with streaming (OpenAI: deltas; others: single done). */
+export async function runAgentTurnStream(options, onEvent) {
+    const { sessionId, userMessage = null, systemPrompt: optionPrompt = null, provider, model, max_tokens = 1024, } = options;
+    const { signal, cleanup } = buildEffectiveSignal(options);
+    try {
+        throwIfAborted(signal);
+        await runAgentHooksSessionStart(sessionId);
+        const history = getAgentMessages(sessionId);
+        const messages = [];
+        const baseSystem = optionPrompt ?? config.agentSystemPrompt ?? DEFAULT_SYSTEM;
+        const systemPrompt = await resolveSystemPrompt(sessionId, baseSystem, history.length + 1);
+        if (systemPrompt)
+            messages.push({ role: 'system', content: systemPrompt });
+        messages.push(...rowsToMessages(history));
+        if (userMessage) {
+            messages.push({ role: 'user', content: userMessage });
+            appendAgentMessage({ session_id: sessionId, role: 'user', content: userMessage });
+        }
+        const toolsForApi = listTools().map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+        }));
+        let turnCount = 0;
+        let lastContent = '';
+        const useStream = ['openai', 'openrouter'].includes(provider ?? process.env.AI_DEFAULT_PROVIDER ?? 'openai');
+        while (turnCount < MAX_TOOL_TURNS) {
+            throwIfAborted(signal);
+            turnCount++;
+            const isFirstTurn = turnCount === 1;
+            if (useStream && isFirstTurn) {
+                const result = await completeStream({ provider, model, messages, max_tokens, tools: toolsForApi.length ? toolsForApi : undefined, signal }, (ev) => {
+                    if (ev.type === 'delta')
+                        onEvent({ type: 'assistant', delta: ev.content });
+                });
+                lastContent = result.content ?? '';
+                appendAgentMessage({
+                    session_id: sessionId,
+                    role: 'assistant',
+                    content: lastContent,
+                    tool_calls: result.tool_calls ? JSON.stringify(result.tool_calls) : null,
+                });
+                if (result.tool_calls?.length) {
+                    messages.push({ role: 'assistant', content: lastContent, tool_calls: result.tool_calls });
+                    for (const tc of result.tool_calls) {
+                        throwIfAborted(signal);
+                        let args = tc.arguments ? JSON.parse(tc.arguments) : {};
+                        args = await runAgentHooksBeforeToolCall(sessionId, tc.name, args);
+                        let toolResult;
+                        try {
+                            toolResult = await executeTool(tc.name, args);
+                        }
+                        catch (err) {
+                            toolResult = { error: err instanceof Error ? err.message : String(err) };
+                            log('agent', 'warn', `Tool ${tc.name} failed`, { error: err.message });
+                        }
+                        await runAgentHooksAfterToolCall(sessionId, tc.name, args, toolResult);
+                        onEvent({ type: 'tool_call', name: tc.name, result: toolResult });
+                        messages.push({
+                            role: 'tool',
+                            tool_call_id: tc.id,
+                            name: tc.name,
+                            content: typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult),
+                        });
+                        appendAgentMessage({
+                            session_id: sessionId,
+                            role: 'tool',
+                            tool_call_id: tc.id,
+                            name: tc.name,
+                            content: typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult),
+                        });
+                    }
+                    continue;
+                }
+                onEvent({ type: 'done', finalContent: lastContent, turnCount });
+                const updatedHistory = getAgentMessages(sessionId);
+                const runResult = { sessionId, messages: rowsToMessages(updatedHistory), finalContent: lastContent, turnCount };
+                await runAgentHooksAgentEnd(sessionId, { finalContent: lastContent, turnCount });
+                return runResult;
+            }
+            const result = await complete({
+                provider,
+                model,
+                messages,
+                max_tokens,
+                tools: toolsForApi.length ? toolsForApi : undefined,
+                signal,
+            });
+            lastContent = result.content ?? '';
+            const toolCalls = result.tool_calls;
+            appendAgentMessage({
+                session_id: sessionId,
+                role: 'assistant',
+                content: lastContent,
+                tool_calls: toolCalls ? JSON.stringify(toolCalls) : null,
+            });
+            if (!toolCalls?.length) {
+                onEvent({ type: 'done', finalContent: lastContent, turnCount });
+                break;
+            }
+            messages.push({ role: 'assistant', content: lastContent, tool_calls: toolCalls });
+            for (const tc of toolCalls) {
+                throwIfAborted(signal);
+                let args = tc.arguments ? JSON.parse(tc.arguments) : {};
+                args = await runAgentHooksBeforeToolCall(sessionId, tc.name, args);
+                let toolResult;
+                try {
+                    toolResult = await executeTool(tc.name, args);
+                }
+                catch (err) {
+                    toolResult = { error: err instanceof Error ? err.message : String(err) };
+                    log('agent', 'warn', `Tool ${tc.name} failed`, { error: err.message });
+                }
+                await runAgentHooksAfterToolCall(sessionId, tc.name, args, toolResult);
+                onEvent({ type: 'tool_call', name: tc.name, result: toolResult });
+                messages.push({
+                    role: 'tool',
+                    tool_call_id: tc.id,
+                    name: tc.name,
+                    content: typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult),
+                });
+                appendAgentMessage({
+                    session_id: sessionId,
+                    role: 'tool',
+                    tool_call_id: tc.id,
+                    name: tc.name,
+                    content: typeof toolResult === 'string' ? toolResult : JSON.stringify(toolResult),
+                });
+            }
+        }
+        const updatedHistory = getAgentMessages(sessionId);
+        const runResult = { sessionId, messages: rowsToMessages(updatedHistory), finalContent: lastContent, turnCount };
+        onEvent({ type: 'done', finalContent: lastContent, turnCount });
+        await runAgentHooksAgentEnd(sessionId, { finalContent: lastContent, turnCount });
+        return runResult;
+    }
+    finally {
+        cleanup();
+        await runAgentHooksSessionEnd(sessionId);
+    }
+}
+//# sourceMappingURL=loop.js.map

package/dist/agent/loop.js.map

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

package/dist/agent/session-queue.d.ts

@@ -0,0 +1,2 @@
+export declare function withSessionLock<T>(sessionId: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=session-queue.d.ts.map

package/dist/agent/session-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-queue.d.ts","sourceRoot":"","sources":["../../src/agent/session-queue.ts"],"names":[],"mappings":"AAMA,wBAAsB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAY5F"}

package/dist/agent/session-queue.js

@@ -0,0 +1,13 @@
+/**
+ * Per-session lock: only one agent run per session at a time.
+ * Concurrent requests for the same session are serialized.
+ */
+const sessionTails = new Map();
+export async function withSessionLock(sessionId, fn) {
+    const prev = sessionTails.get(sessionId) ?? Promise.resolve();
+    const myRun = prev.then(() => fn(), () => fn());
+    const tail = myRun.then(() => { }, () => { });
+    sessionTails.set(sessionId, tail);
+    return myRun;
+}
+//# sourceMappingURL=session-queue.js.map

package/dist/agent/session-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-queue.js","sourceRoot":"","sources":["../../src/agent/session-queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAI,SAAiB,EAAE,EAAoB;IAC9E,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CACrB,GAAG,EAAE,CAAC,EAAE,EAAE,EACV,GAAG,EAAE,CAAC,EAAE,EAAE,CACX,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CACrB,GAAG,EAAE,GAAE,CAAC,EACR,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;IACF,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/agent/skill-install.d.ts

@@ -0,0 +1,41 @@
+export type RegistrySkill = {
+    slug: string;
+    name: string;
+    description: string;
+    url?: string;
+    version?: string;
+};
+export type RegistryIndex = {
+    skills: RegistrySkill[];
+};
+export declare function getRegistrySkills(overrideUrl?: string): Promise<RegistrySkill[]>;
+export declare function getRegistrySkillsLocal(): RegistrySkill[];
+export type InstallTarget = 'managed' | 'workspace';
+export type InstallSkillOptions = {
+    registryUrl?: string;
+};
+export declare function installSkill(slug: string, target: InstallTarget, opts?: InstallSkillOptions): Promise<{
+    success: boolean;
+    path: string;
+    error?: string;
+}>;
+export declare function uninstallSkill(slug: string, target: InstallTarget): {
+    success: boolean;
+    path: string;
+    error?: string;
+};
+export declare function updateSkillsAll(): Promise<{
+    updated: string[];
+    failed: {
+        slug: string;
+        error: string;
+    }[];
+}>;
+export type SkillUpdateInfo = {
+    slug: string;
+    installedVersion?: string;
+    registryVersion?: string;
+    updateAvailable: boolean;
+};
+export declare function getAvailableUpdates(): Promise<SkillUpdateInfo[]>;
+//# sourceMappingURL=skill-install.d.ts.map

package/dist/agent/skill-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-install.d.ts","sourceRoot":"","sources":["../../src/agent/skill-install.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAatF;AAED,wBAAgB,sBAAsB,IAAI,aAAa,EAAE,CAQxD;AAoDD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,CAAC;AAEpD,MAAM,MAAM,mBAAmB,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,EACrB,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsC7D;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,GACpB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAmBpD;AA6BD,wBAAsB,eAAe,IAAI,OAAO,CAC9C;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CACjE,CAaA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAqBtE"}