exempclaw 0.4.0

package/dist/plugins/apply.d.ts

@@ -0,0 +1,9 @@
+import type { Tool } from "../tools/tool.js";
+import type { FailedPlugin, PluginLoadResult } from "./loader.js";
+export interface AppliedPlugins {
+    /** Plugin tools, registered into every agent's ToolRegistry by the orchestrator. */
+    extraTools: Tool[];
+    /** Loader failures plus apply-time failures (e.g. connector id collisions). */
+    failures: FailedPlugin[];
+}
+export declare function applyPlugins(result: PluginLoadResult): AppliedPlugins;

package/dist/plugins/apply.js

@@ -0,0 +1,17 @@
+import { registerConnector } from "../connectors/index.js";
+export function applyPlugins(result) {
+    const extraTools = [];
+    const failures = [...result.failures];
+    for (const plugin of result.plugins) {
+        try {
+            for (const connector of plugin.spec.connectors ?? [])
+                registerConnector(connector);
+            extraTools.push(...(plugin.spec.tools ?? []));
+        }
+        catch (err) {
+            failures.push({ dir: plugin.dir, name: plugin.manifest.name, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    return { extraTools, failures };
+}
+//# sourceMappingURL=apply.js.map

package/dist/plugins/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/plugins/apply.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAU3D,MAAM,UAAU,YAAY,CAAC,MAAwB;IACnD,MAAM,UAAU,GAAW,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE;gBAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACnF,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1H,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAClC,CAAC"}

package/dist/plugins/define.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { defineTool, type Tool } from "../tools/tool.js";
+import type { Connector } from "../connectors/connector.js";
+import type { ConnectorEnvKey } from "../connectors/index.js";
+/**
+ * Public plugin API. Plugin authors either:
+ *  - default-export `definePlugin({...})` (requires `npm i exempclaw zod` in the
+ *    plugin folder so imports resolve), or
+ *  - default-export a factory `(api: PluginApi) => PluginSpec` — zero installs,
+ *    the loader passes this module in. The scaffold uses the factory form.
+ */
+export interface PluginConnector {
+    id: string;
+    description: string;
+    envKeys: ConnectorEnvKey[];
+    make: () => Connector;
+}
+export interface PluginSpec {
+    name: string;
+    tools?: Tool[];
+    connectors?: PluginConnector[];
+}
+export declare function definePlugin(spec: PluginSpec): PluginSpec;
+export declare const pluginApi: {
+    z: typeof z;
+    defineTool: typeof defineTool;
+    definePlugin: typeof definePlugin;
+};
+export type PluginApi = typeof pluginApi;

package/dist/plugins/define.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { defineTool } from "../tools/tool.js";
+export function definePlugin(spec) {
+    if (!spec.name || typeof spec.name !== "string") {
+        throw new Error("plugin name is required (non-empty string)");
+    }
+    const seen = new Set();
+    for (const tool of spec.tools ?? []) {
+        if (seen.has(tool.name))
+            throw new Error(`duplicate tool in plugin "${spec.name}": ${tool.name}`);
+        seen.add(tool.name);
+    }
+    const seenConnectors = new Set();
+    for (const connector of spec.connectors ?? []) {
+        if (!connector.id || typeof connector.make !== "function") {
+            throw new Error(`invalid connector in plugin "${spec.name}": needs id and make()`);
+        }
+        if (seenConnectors.has(connector.id)) {
+            throw new Error(`duplicate connector id in plugin "${spec.name}": ${connector.id}`);
+        }
+        seenConnectors.add(connector.id);
+    }
+    return {
+        name: spec.name,
+        tools: spec.tools ? [...spec.tools] : undefined,
+        connectors: spec.connectors ? [...spec.connectors] : undefined,
+    };
+}
+export const pluginApi = { z, defineTool, definePlugin };
+//# sourceMappingURL=define.js.map

package/dist/plugins/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/plugins/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AAwBzD,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QAC9C,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,IAAI,wBAAwB,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,IAAI,MAAM,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAC/C,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { type PluginSpec } from "./define.js";
+declare const ManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    entry: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type PluginManifest = z.infer<typeof ManifestSchema>;
+export interface LoadedPlugin {
+    manifest: PluginManifest;
+    dir: string;
+    spec: PluginSpec;
+}
+export interface FailedPlugin {
+    dir: string;
+    /** Manifest name when known, else the folder name. */
+    name: string;
+    error: string;
+}
+export interface PluginLoadResult {
+    plugins: LoadedPlugin[];
+    failures: FailedPlugin[];
+}
+export declare function defaultPluginsDir(env?: NodeJS.ProcessEnv): string;
+/**
+ * Discovers and imports every plugin folder. A broken plugin becomes a
+ * `failures` entry — it must never throw out of this function.
+ */
+export declare function loadPlugins(dir?: string): Promise<PluginLoadResult>;
+export {};

package/dist/plugins/loader.js

@@ -0,0 +1,61 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { z } from "zod";
+import { pluginApi } from "./define.js";
+const ManifestSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().min(1),
+    description: z.string().default(""),
+    entry: z.string().default("./index.js"),
+});
+export function defaultPluginsDir(env = process.env) {
+    return env.EXEMPCLAW_PLUGINS_DIR ?? join(homedir(), ".exempclaw", "plugins");
+}
+/**
+ * Discovers and imports every plugin folder. A broken plugin becomes a
+ * `failures` entry — it must never throw out of this function.
+ */
+export async function loadPlugins(dir = defaultPluginsDir()) {
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return { plugins: [], failures: [] };
+    }
+    const plugins = [];
+    const failures = [];
+    for (const entry of entries.sort()) {
+        const pluginDir = join(dir, entry);
+        try {
+            if (!(await stat(pluginDir)).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        let manifest;
+        try {
+            const manifestRaw = await readFile(join(pluginDir, "exempclaw.plugin.json"), "utf8");
+            manifest = ManifestSchema.parse(JSON.parse(manifestRaw));
+            const entryUrl = pathToFileURL(join(pluginDir, manifest.entry)).href;
+            const mod = (await import(entryUrl));
+            const exported = mod.default;
+            const rawSpec = typeof exported === "function"
+                ? exported(pluginApi)
+                : exported;
+            const spec = rawSpec instanceof Promise ? await rawSpec : rawSpec;
+            if (!spec || typeof spec !== "object" || typeof spec.name !== "string") {
+                throw new Error("entry default export must be a PluginSpec or a factory returning one");
+            }
+            plugins.push({ manifest, dir: pluginDir, spec: spec });
+        }
+        catch (err) {
+            failures.push({ dir: pluginDir, name: manifest?.name ?? entry, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    return { plugins, failures };
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/scaffold.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Writes a working, zero-install plugin template: the entry default-exports a
+ * factory receiving the plugin API, so nothing needs `npm install` to run.
+ */
+export declare function scaffoldPlugin(pluginsDir: string, name: string): Promise<string>;

package/dist/plugins/scaffold.js

@@ -0,0 +1,72 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Writes a working, zero-install plugin template: the entry default-exports a
+ * factory receiving the plugin API, so nothing needs `npm install` to run.
+ */
+export async function scaffoldPlugin(pluginsDir, name) {
+    if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+        throw new Error(`plugin name must be lowercase letters/digits/dashes, got "${name}"`);
+    }
+    const dir = join(pluginsDir, name);
+    if (existsSync(dir))
+        throw new Error(`${dir} already exists`);
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, "exempclaw.plugin.json"), `${JSON.stringify({ name, version: "0.1.0", description: `${name} plugin`, entry: "./index.js" }, null, 2)}\n`, "utf8");
+    await writeFile(join(dir, "index.js"), `/**
+ * Exempclaw plugin: ${name}
+ *
+ * The default export is a factory that receives Exempclaw's plugin API
+ * ({ z, defineTool, definePlugin }), so this file works with zero installs.
+ * See PLUGIN.md for the full interface, including connectors.
+ */
+export default function ({ z, defineTool, definePlugin }) {
+  return definePlugin({
+    name: "${name}",
+    tools: [
+      defineTool({
+        name: "${name}_hello",
+        description: "Example tool — replace with your own. Tools that act on the outside world must set outward: true so the approval gate engages.",
+        schema: z.object({ who: z.string().describe("Who to greet") }),
+        execute: async ({ who }) => ({ content: \`Hello, \${who}! (from the ${name} plugin)\` }),
+      }),
+    ],
+  });
+}
+`, "utf8");
+    await writeFile(join(dir, "PLUGIN.md"), `# ${name} — an Exempclaw plugin
+
+Exempclaw discovers plugins in this folder's parent directory at startup
+(\`~/.exempclaw/plugins\` by default, override with \`EXEMPCLAW_PLUGINS_DIR\`).
+
+## Anatomy
+
+- \`exempclaw.plugin.json\` — name, version, description, entry (path to the module).
+- the entry module — default-exports either:
+  1. **a factory** \`(api) => spec\` (this template): \`api\` is \`{ z, defineTool, definePlugin }\`.
+     Zero installs needed.
+  2. **a spec object** built with \`import { definePlugin } from "exempclaw/plugin"\` —
+     for TypeScript authors; run \`npm i exempclaw zod\` in this folder and compile to JS.
+
+## What a plugin can provide
+
+- **tools**: capabilities every agent can call. Same shape as built-ins:
+  \`defineTool({ name, description, schema, outward, execute })\`. Set \`outward: true\`
+  for anything that touches the outside world — that engages the human-approval gate.
+- **connectors**: full integrations (tools + inbound events). Provide
+  \`{ id, description, envKeys, make }\` where \`make()\` returns an object implementing
+  the \`Connector\` interface (\`init\`, \`tools\`, optional \`listen\`/\`shutdown\`).
+  Agents opt in by listing your connector id in their config's \`connectors\` array.
+
+## Rules
+
+- A broken plugin never crashes Exempclaw — it shows up on the Plugins screen with the error.
+- Plugins cannot change the LLM. Exempclaw runs on the Claude API only.
+
+Check your work: run \`exempclaw\` and open **Plugins** — your plugin should be listed
+with its tools, or shown with a load error to fix.
+`, "utf8");
+    return dir;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/plugins/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/plugins/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB,EAAE,IAAY;IACnE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,6DAA6D,IAAI,GAAG,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,iBAAiB,CAAC,CAAC;IAC9D,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,MAAM,SAAS,CACb,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,EAClC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAC9G,MAAM,CACP,CAAC;IAEF,MAAM,SAAS,CACb,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EACrB;uBACmB,IAAI;;;;;;;;aAQd,IAAI;;;iBAGA,IAAI;;;8EAGyD,IAAI;;;;;CAKjF,EACG,MAAM,CACP,CAAC;IAEF,MAAM,SAAS,CACb,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EACtB,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BZ,EACG,MAAM,CACP,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/tools/builtin.d.ts

@@ -0,0 +1,8 @@
+import { type Tool } from "./tool.js";
+import type { MemoryStore } from "../memory/store.js";
+/**
+ * Tools every agent gets regardless of connectors: durable memory, a clock,
+ * and a status channel to the operator's terminal. These are inward (no
+ * approval needed) — they never touch the outside world.
+ */
+export declare function builtinTools(memory: MemoryStore): Tool[];

package/dist/tools/builtin.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { AGENT_ACTIVITIES, defineTool } from "./tool.js";
+/**
+ * Tools every agent gets regardless of connectors: durable memory, a clock,
+ * and a status channel to the operator's terminal. These are inward (no
+ * approval needed) — they never touch the outside world.
+ */
+export function builtinTools(memory) {
+    const remember = defineTool({
+        name: "remember",
+        description: "Store a durable fact, lesson, or piece of role context so future sessions retain it. Use for anything you'd want to know next time but that isn't already obvious from the conversation.",
+        schema: z.object({
+            text: z.string().describe("The fact or lesson to remember, stated concisely."),
+            source: z.string().default("self").describe("Where this came from, e.g. email, slack, onboarding."),
+            tags: z.array(z.string()).default([]).describe("Optional tags for later retrieval."),
+        }),
+        async execute(input) {
+            const entry = await memory.addMemory({ text: input.text, source: input.source, tags: input.tags });
+            return { content: `Stored memory ${entry.id}.` };
+        },
+    });
+    const recall = defineTool({
+        name: "recall",
+        description: "Search your durable memory for relevant context by keyword.",
+        schema: z.object({
+            query: z.string().describe("What to search for."),
+            limit: z.number().int().min(1).max(50).default(10),
+        }),
+        async execute(input) {
+            const hits = await memory.searchMemory(input.query, input.limit);
+            if (hits.length === 0)
+                return { content: "No matching memories." };
+            return { content: hits.map((m) => `- (${m.source}) ${m.text}`).join("\n") };
+        },
+    });
+    const now = defineTool({
+        name: "current_time",
+        description: "Get the current date and time in ISO-8601 (UTC).",
+        schema: z.object({}),
+        async execute() {
+            return { content: new Date().toISOString() };
+        },
+    });
+    const displayStatus = defineTool({
+        name: "display_status",
+        description: "Show the human operator a live animated status line in their terminal describing what you are doing right now. Use it when you start a distinct phase of multi-step work (searching a mailbox, reading a long thread, drafting a reply, waiting on something) so the operator can follow along — at most once per phase, and skip it for quick single-tool answers. Use \"celebrating\" once when a meaningful task fully completes, and \"alert\" only for something the operator should look at.",
+        schema: z.object({
+            activity: z.enum(AGENT_ACTIVITIES).describe("The kind of activity animation to play."),
+            message: z.string().min(1).max(100).describe("Short present-tense label, e.g. \"combing through Ana's last thread\"."),
+        }),
+        async execute(input, ctx) {
+            if (ctx.emit) {
+                ctx.emit({ kind: "status", activity: input.activity, message: input.message });
+            }
+            else {
+                ctx.log.info("agent status", { activity: input.activity, message: input.message });
+            }
+            return { content: "Status shown to the operator. Continue with the work itself." };
+        },
+    });
+    return [remember, recall, now, displayStatus];
+}
+//# sourceMappingURL=builtin.js.map

package/dist/tools/builtin.js.map

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

package/dist/tools/tool.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import type Anthropic from "@anthropic-ai/sdk";
+import type { Logger } from "../core/logger.js";
+import type { ActionPolicy } from "../config/index.js";
+/** Activities the agent can signal to the operator's terminal. */
+export declare const AGENT_ACTIVITIES: readonly ["thinking", "searching", "reading", "writing", "sending", "waiting", "celebrating", "alert"];
+export type AgentActivity = (typeof AGENT_ACTIVITIES)[number];
+/** A presentational signal from a tool to whatever UI is attached. */
+export interface AgentSignal {
+    kind: "status";
+    activity: AgentActivity;
+    message: string;
+}
+/**
+ * Context handed to every tool at execution time. Tools never read global
+ * state directly — everything they need comes through here, which keeps them
+ * unit-testable and lets the orchestrator scope resources per agent.
+ */
+export interface ToolContext {
+    agentId: string;
+    log: Logger;
+    /** Resolve an outward-action approval. The runtime wires this to the policy + UI. */
+    requestApproval(action: ApprovalRequest): Promise<boolean>;
+    /** Shared signal for cooperative cancellation. */
+    signal: AbortSignal;
+    /** Present a signal to the attached UI (animated status line in the TUI). */
+    emit?(signal: AgentSignal): void;
+}
+export interface ApprovalRequest {
+    /** Short human label, e.g. "Send email to jane@acme.com". */
+    summary: string;
+    /** Full detail shown to the approver (the email body, the Slack message, …). */
+    detail: string;
+    tool: string;
+}
+/**
+ * A capability the agent can invoke. `input` is validated with a Zod schema,
+ * which doubles as the JSON Schema sent to Claude. Mark `outward: true` for
+ * anything that affects the world outside Exempclaw (sending, posting, writing
+ * to external systems) so the approval gate engages.
+ */
+export interface Tool<I = unknown> {
+    readonly name: string;
+    readonly description: string;
+    readonly schema: z.ZodType<I>;
+    /** True if executing this tool acts on the outside world (needs approval). */
+    readonly outward: boolean;
+    execute(input: I, ctx: ToolContext): Promise<ToolResult>;
+}
+export interface ToolResult {
+    /** Text returned to the model as the tool_result content. */
+    content: string;
+    /** Marks the result as an error so the model knows the call failed. */
+    isError?: boolean;
+}
+/** Helper to declare a tool with full type inference from its Zod schema. */
+export declare function defineTool<I>(spec: {
+    name: string;
+    description: string;
+    schema: z.ZodType<I>;
+    outward?: boolean;
+    execute: (input: I, ctx: ToolContext) => Promise<ToolResult>;
+}): Tool<I>;
+/** Registry of the tools available to a single agent. */
+export declare class ToolRegistry {
+    private readonly tools;
+    register(tool: Tool): void;
+    get(name: string): Tool | undefined;
+    /** Renders the registered tools into the Anthropic tool-definition format. */
+    toAnthropicTools(): Anthropic.Tool[];
+    get size(): number;
+}
+/**
+ * Decides whether an outward action proceeds, given the deployment policy.
+ * "deny" blocks unconditionally, "auto" allows, "ask" defers to the supplied
+ * interactive approver (terminal prompt, web UI, Slack button, …).
+ */
+export declare function evaluatePolicy(policy: ActionPolicy, request: ApprovalRequest, interactiveApprover: (req: ApprovalRequest) => Promise<boolean>): Promise<boolean>;
+/**
+ * Resolves the effective policy for one tool: an exact per-tool override wins,
+ * then a "*" override, then the deployment-wide default. Lets an agent config
+ * say e.g. auto-approve Slack thread replies while still gating email sends.
+ */
+export declare function resolvePolicy(globalPolicy: ActionPolicy, overrides: Record<string, ActionPolicy> | undefined, toolName: string): ActionPolicy;

package/dist/tools/tool.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+/** Activities the agent can signal to the operator's terminal. */
+export const AGENT_ACTIVITIES = [
+    "thinking",
+    "searching",
+    "reading",
+    "writing",
+    "sending",
+    "waiting",
+    "celebrating",
+    "alert",
+];
+/** Helper to declare a tool with full type inference from its Zod schema. */
+export function defineTool(spec) {
+    return {
+        name: spec.name,
+        description: spec.description,
+        schema: spec.schema,
+        outward: spec.outward ?? false,
+        execute: spec.execute,
+    };
+}
+/** Registry of the tools available to a single agent. */
+export class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`duplicate tool registered: ${tool.name}`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    /** Renders the registered tools into the Anthropic tool-definition format. */
+    toAnthropicTools() {
+        return [...this.tools.values()].map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            input_schema: z.toJSONSchema(tool.schema, { target: "draft-7" }),
+        }));
+    }
+    get size() {
+        return this.tools.size;
+    }
+}
+/**
+ * Decides whether an outward action proceeds, given the deployment policy.
+ * "deny" blocks unconditionally, "auto" allows, "ask" defers to the supplied
+ * interactive approver (terminal prompt, web UI, Slack button, …).
+ */
+export async function evaluatePolicy(policy, request, interactiveApprover) {
+    switch (policy) {
+        case "auto":
+            return true;
+        case "deny":
+            return false;
+        case "ask":
+            return interactiveApprover(request);
+    }
+}
+/**
+ * Resolves the effective policy for one tool: an exact per-tool override wins,
+ * then a "*" override, then the deployment-wide default. Lets an agent config
+ * say e.g. auto-approve Slack thread replies while still gating email sends.
+ */
+export function resolvePolicy(globalPolicy, overrides, toolName) {
+    return overrides?.[toolName] ?? overrides?.["*"] ?? globalPolicy;
+}
+//# sourceMappingURL=tool.js.map

package/dist/tools/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,aAAa;IACb,OAAO;CACC,CAAC;AAwDX,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAAI,IAM7B;IACC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;QAC9B,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAEjD,QAAQ,CAAC,IAAU;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAY,CAAC,CAAC;IAC1C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,8EAA8E;IAC9E,gBAAgB;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAA+B;SAC/F,CAAC,CAAC,CAAC;IACN,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAoB,EACpB,OAAwB,EACxB,mBAA+D;IAE/D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;QACf,KAAK,KAAK;YACR,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,YAA0B,EAC1B,SAAmD,EACnD,QAAgB;IAEhB,OAAO,SAAS,EAAE,CAAC,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC;AACnE,CAAC"}

package/dist/ui/agent-view.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ui/agent-view.test.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// src/ui/agent-view.test.tsx
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { render } from "ink-testing-library";
+import { AgentScreen } from "./screens/agent.js";
+import { ApprovalBridge } from "./services.js";
+const tick = () => new Promise((r) => setTimeout(r, 50));
+function servicesWith(dispatch) {
+    const approvals = new ApprovalBridge();
+    const orchestrator = {
+        dispatch: (_id, input, opts) => dispatch(input, opts.hooks),
+    };
+    return {
+        config: { defaultModel: "m", dataDir: "/tmp/x", logLevel: "error", actionPolicy: "ask", contextBudgetTokens: 200_000 },
+        agentsDir: "/tmp/agents",
+        plugins: { plugins: [], failures: [] },
+        applied: { extraTools: [], failures: [] },
+        approvals,
+        listAgents: async () => ({ agents: [], broken: [] }),
+        getOrchestrator: async () => orchestrator,
+        shutdown: async () => undefined,
+    };
+}
+test("chat streams text and tool lines", async () => {
+    const services = servicesWith(async (_input, hooks) => {
+        hooks.onToolStart("recall", {});
+        hooks.onToolEnd("recall", true);
+        hooks.onText("Hello from Sam.");
+        return { text: "Hello from Sam.", usage: {}, iterations: 1, stopReason: "end_turn" };
+    });
+    const { lastFrame, stdin } = render(_jsx(AgentScreen, { services: services, agentId: "sam", onNavigate: () => undefined }));
+    await tick();
+    stdin.write("hi");
+    await tick();
+    stdin.write("\r");
+    await tick();
+    assert.match(lastFrame(), /you ▸ hi/);
+    assert.match(lastFrame(), /recall/);
+    assert.match(lastFrame(), /Hello from Sam\./);
+});
+test("approval dialog renders and resolves on y", async () => {
+    const services = servicesWith(async () => new Promise(() => undefined)); // never settles
+    const { lastFrame, stdin } = render(_jsx(AgentScreen, { services: services, agentId: "sam", onNavigate: () => undefined }));
+    await tick();
+    await tick();
+    const decision = services.approvals.approve({ tool: "email_send", summary: "Send email", detail: "body" });
+    await tick();
+    await tick();
+    assert.match(lastFrame(), /Approval required — email_send/);
+    stdin.write("y");
+    assert.equal(await decision, true);
+});
+//# sourceMappingURL=agent-view.test.js.map

package/dist/ui/agent-view.test.js.map

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

package/dist/ui/agents-data.d.ts

@@ -0,0 +1,7 @@
+export interface AgentActivity {
+    runs: number;
+    lastRunAt: string | undefined;
+    totalCostUsd: number;
+}
+export declare function agentActivity(dataDir: string, agentId: string): Promise<AgentActivity>;
+export declare function timeAgo(iso: string | undefined, now?: () => number): string;

package/dist/ui/agents-data.js

@@ -0,0 +1,25 @@
+import { RunLog } from "../core/run-log.js";
+export async function agentActivity(dataDir, agentId) {
+    const records = await new RunLog(dataDir, agentId).readAll();
+    let lastRunAt;
+    let totalCostUsd = 0;
+    for (const record of records) {
+        if (!lastRunAt || record.startedAt > lastRunAt)
+            lastRunAt = record.startedAt;
+        totalCostUsd += record.costUsd ?? 0;
+    }
+    return { runs: records.length, lastRunAt, totalCostUsd };
+}
+export function timeAgo(iso, now = Date.now) {
+    if (!iso)
+        return "never";
+    const seconds = Math.max(0, Math.floor((now() - Date.parse(iso)) / 1000));
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m ago`;
+    if (seconds < 86400)
+        return `${Math.floor(seconds / 3600)}h ago`;
+    return `${Math.floor(seconds / 86400)}d ago`;
+}
+//# sourceMappingURL=agents-data.js.map

package/dist/ui/agents-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-data.js","sourceRoot":"","sources":["../../src/ui/agents-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,OAAe;IAClE,MAAM,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7D,IAAI,SAA6B,CAAC;IAClC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,GAAG,SAAS;YAAE,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAC7E,YAAY,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAuB,EAAE,MAAoB,IAAI,CAAC,GAAG;IAC3E,IAAI,CAAC,GAAG;QAAE,OAAO,OAAO,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1E,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,OAAO,CAAC;IAC3C,IAAI,OAAO,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;IAC9D,IAAI,OAAO,GAAG,KAAK;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IACjE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;AAC/C,CAAC"}