@agent-native/core 0.7.12 → 0.7.13

package/dist/templates/default/.agents/skills/progress/SKILL.md

@@ -22,25 +22,27 @@ Separate concern from `notifications`:
 
 Common pattern: on completion, emit a `notify()` so the user sees the outcome when they're not actively watching the tray.
 
-## Available Tools
+## Tool
 
-| Tool | Purpose |
+All progress operations go through a single `manage-progress` tool with an `action` parameter:
+
+| Action | Purpose |
 |---|---|
-| `start-run` | Mark the start of a long task. Returns a runId. |
-| `update-run-progress` | Update percent and/or current step. Call frequently. |
-| `complete-run` | Mark terminal status: `succeeded`, `failed`, `cancelled`. |
-| `list-runs` | List recent runs (all or `--active=true`). |
+| `start` | Mark the start of a long task. Returns a runId. |
+| `update` | Update percent and/or current step. Call frequently. |
+| `complete` | Mark terminal status: `succeeded`, `failed`, `cancelled`. |
+| `list` | List recent runs (all or `--active=true`). |
 
 ## Canonical Flow
 
 ```
-start-run --title "Triage 128 unread emails" --step "Fetching inbox"
+manage-progress --action=start --title "Triage 128 unread emails" --step "Fetching inbox"
   → runId=abc
 
-update-run-progress --runId=abc --percent=25 --step="Classifying 32/128"
-update-run-progress --runId=abc --percent=75 --step="Drafting replies 97/128"
+manage-progress --action=update --runId=abc --percent=25 --step="Classifying 32/128"
+manage-progress --action=update --runId=abc --percent=75 --step="Drafting replies 97/128"
 
-complete-run --runId=abc --status=succeeded
+manage-progress --action=complete --runId=abc --status=succeeded
 notify --severity=info --title="Triage done" --body="12 archived, 6 drafts ready to review"
 ```
 
@@ -48,9 +50,9 @@ notify --severity=info --title="Triage done" --body="12 archived, 6 drafts ready
 
 - **Start a run for anything > ~5 seconds.** Users want feedback; a spinner with no context feels frozen.
 - **Update at natural checkpoints**, not every iteration. Every 5–10% is enough for most UIs.
-- **Always call `complete-run`** at the end — including the error path. An orphaned `running` row is worse than no row.
+- **Always call `manage-progress --action=complete`** at the end — including the error path. An orphaned `running` row is worse than no row.
 - **Pair with `notify`** on completion. The tray tells users what's *running*; notifications tell them what *finished*.
-- **Use `metadataJson`** on `start-run` to pass a link back to the produced artifact (thread id, document path), so the UI can deep-link from the runs tray.
+- **Use `metadataJson`** on `manage-progress --action=start` to pass a link back to the produced artifact (thread id, document path), so the UI can deep-link from the runs tray.
 
 ## Runs API
 

package/dist/templates/default/app/root.tsx

@@ -16,6 +16,13 @@ import { ThemeProvider } from "next-themes";
 import { useDbSync } from "@agent-native/core";
 import { ClientOnly, DefaultSpinner } from "@agent-native/core/client";
 import { Toaster } from "sonner";
+import { configureTracking } from "@agent-native/core/client";
+configureTracking({
+  getDefaultProps: (_name, properties) => ({
+    ...properties,
+    app: "{{APP_NAME}}",
+  }),
+});
 import "./global.css";
 
 export function Layout({ children }: { children: React.ReactNode }) {

package/dist/transcription/builder-transcription.d.ts

@@ -0,0 +1,27 @@
+export interface BuilderTranscribeOptions {
+    audioBytes: Uint8Array;
+    mimeType: string;
+    diarize?: boolean;
+    minSpeakers?: number;
+    maxSpeakers?: number;
+    language?: string;
+}
+export interface BuilderTranscribeResult {
+    text: string;
+    language: string;
+    durationSeconds: number;
+    segments: Array<{
+        startMs: number;
+        endMs: number;
+        text: string;
+        speakerLabel?: string;
+        words?: Array<{
+            startMs: number;
+            endMs: number;
+            text: string;
+            confidence?: number;
+        }>;
+    }>;
+}
+export declare function transcribeWithBuilder(opts: BuilderTranscribeOptions): Promise<BuilderTranscribeResult>;
+//# sourceMappingURL=builder-transcription.d.ts.map

package/dist/transcription/builder-transcription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-transcription.d.ts","sourceRoot":"","sources":["../../src/transcription/builder-transcription.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,KAAK,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAqDlC"}

package/dist/transcription/builder-transcription.js

@@ -0,0 +1,41 @@
+import { hasBuilderPrivateKey, getBuilderProxyOrigin, getBuilderAuthHeader, } from "../server/credential-provider.js";
+export async function transcribeWithBuilder(opts) {
+    if (!hasBuilderPrivateKey()) {
+        throw new Error("Builder private key not configured. Connect your Builder.io account in Settings.");
+    }
+    const authHeader = getBuilderAuthHeader();
+    if (!authHeader) {
+        throw new Error("Could not generate Builder auth header.");
+    }
+    const params = new URLSearchParams();
+    params.set("mimeType", opts.mimeType);
+    if (opts.diarize != null)
+        params.set("diarize", String(opts.diarize));
+    if (opts.minSpeakers != null)
+        params.set("minSpeakers", String(opts.minSpeakers));
+    if (opts.maxSpeakers != null)
+        params.set("maxSpeakers", String(opts.maxSpeakers));
+    if (opts.language)
+        params.set("language", opts.language);
+    const url = `${getBuilderProxyOrigin()}/agent-native/transcribe-audio?${params.toString()}`;
+    // Copy to a plain ArrayBuffer so TS6 accepts it as BodyInit (Uint8Array
+    // with ArrayBufferLike doesn't satisfy the strict BlobPart/BodyInit types).
+    const body = opts.audioBytes.buffer.slice(opts.audioBytes.byteOffset, opts.audioBytes.byteOffset + opts.audioBytes.byteLength);
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            Authorization: authHeader,
+            "Content-Type": "application/octet-stream",
+        },
+        body,
+    });
+    if (res.status === 402) {
+        throw new Error("Builder transcription credits exhausted. Upgrade your plan or switch to OpenAI Whisper in Settings.");
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Builder transcription failed (${res.status}): ${text.slice(0, 300)}`);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=builder-transcription.js.map

package/dist/transcription/builder-transcription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-transcription.js","sourceRoot":"","sources":["../../src/transcription/builder-transcription.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AA6B1C,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAA8B;IAE9B,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI;QAC1B,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI;QAC1B,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEzD,MAAM,GAAG,GAAG,GAAG,qBAAqB,EAAE,kCAAkC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IAE5F,wEAAwE;IACxE,4EAA4E;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CACvC,IAAI,CAAC,UAAU,CAAC,UAAU,EAC1B,IAAI,CAAC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CACzC,CAAC;IAEjB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU;YACzB,cAAc,EAAE,0BAA0B;SAC3C;QACD,IAAI;KACL,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,qGAAqG,CACtG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,iCAAiC,GAAG,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACtE,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;AACvD,CAAC"}

package/dist/triggers/actions.d.ts

@@ -4,6 +4,9 @@
  * These are registered as native tools (not template actions) so they're
  * available in every template. The agent uses them to create, list, and
  * manage automations from chat.
+ *
+ * All six operations are consolidated into a single `manage-automations` tool
+ * with an `action` discriminator to keep the tool registry compact.
  */
 import type { ActionEntry } from "../agent/production-agent.js";
 export declare function createAutomationToolEntries(getCurrentUser: () => string): Record<string, ActionEntry>;

package/dist/triggers/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/triggers/actions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAahE,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,MAAM,MAAM,GAC3B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA8S7B"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/triggers/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAiMhE,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,MAAM,MAAM,GAC3B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAuG7B"}

package/dist/triggers/actions.js

@@ -4,115 +4,192 @@
  * These are registered as native tools (not template actions) so they're
  * available in every template. The agent uses them to create, list, and
  * manage automations from chat.
+ *
+ * All six operations are consolidated into a single `manage-automations` tool
+ * with an `action` discriminator to keep the tool registry compact.
  */
 import { listEvents } from "../event-bus/index.js";
 import { resourceListAllOwners, resourcePut, resourceDelete, resourceGetByPath, } from "../resources/store.js";
 import { parseTriggerFrontmatter, buildTriggerContent } from "./dispatcher.js";
 import { refreshEventSubscriptions } from "./dispatcher.js";
+/* ------------------------------------------------------------------ */
+/*  Individual action handlers                                        */
+/* ------------------------------------------------------------------ */
+async function handleListEvents() {
+    const events = listEvents();
+    if (events.length === 0) {
+        return "No events registered yet. Events are registered by integrations (mail, calendar, clips, etc.).";
+    }
+    const lines = events.map((e) => {
+        let schemaStr = "";
+        try {
+            const s = e.payloadSchema;
+            if (s?._zod?.def?.shape) {
+                const fields = Object.keys(s._zod.def.shape);
+                schemaStr = ` Fields: ${fields.join(", ")}`;
+            }
+        }
+        catch {
+            // ignore
+        }
+        const example = e.example
+            ? `\n  Example: ${JSON.stringify(e.example)}`
+            : "";
+        return `- **${e.name}**: ${e.description}${schemaStr}${example}`;
+    });
+    return lines.join("\n");
+}
+async function handleList(args) {
+    const resources = await resourceListAllOwners("jobs/");
+    const triggers = resources
+        .filter((r) => r.path.endsWith(".md"))
+        .map((r) => {
+        const { meta, body } = parseTriggerFrontmatter(r.content);
+        const name = r.path.replace(/^jobs\//, "").replace(/\.md$/, "");
+        return { name, meta, body, owner: r.owner, id: r.id };
+    })
+        .filter((t) => {
+        if (args.domain && t.meta.domain !== args.domain)
+            return false;
+        if (args.enabled_only === "true" && !t.meta.enabled)
+            return false;
+        return true;
+    });
+    if (triggers.length === 0)
+        return "No automations found.";
+    const lines = triggers.map((t) => {
+        const type = t.meta.triggerType === "event"
+            ? `on ${t.meta.event || "?"}`
+            : `cron: ${t.meta.schedule}`;
+        const status = t.meta.enabled ? "enabled" : "disabled";
+        const lastStatus = t.meta.lastStatus ? ` (last: ${t.meta.lastStatus})` : "";
+        const condition = t.meta.condition
+            ? `\n  Condition: "${t.meta.condition}"`
+            : "";
+        const domain = t.meta.domain ? ` [${t.meta.domain}]` : "";
+        return `- **${t.name}**${domain}: ${type} → ${t.meta.mode} (${status}${lastStatus})${condition}\n  Body: ${t.body.slice(0, 100)}${t.body.length > 100 ? "..." : ""}`;
+    });
+    return lines.join("\n\n");
+}
+async function handleDefine(args, getCurrentUser) {
+    const owner = getCurrentUser();
+    const name = (args.name || "").replace(/[^a-z0-9-]/g, "-");
+    if (!name)
+        return "Error: name is required (lowercase, hyphens).";
+    const path = `jobs/${name}.md`;
+    // Check if it already exists
+    const existing = await resourceGetByPath(owner, path);
+    if (existing) {
+        return `Error: An automation named "${name}" already exists. Use a different name or delete the existing one first.`;
+    }
+    const triggerType = args.trigger_type === "schedule" ? "schedule" : "event";
+    const meta = {
+        schedule: args.schedule || "",
+        enabled: true,
+        triggerType,
+        event: args.event || undefined,
+        condition: args.condition || undefined,
+        mode: args.mode === "deterministic" ? "deterministic" : "agentic",
+        domain: args.domain || undefined,
+        createdBy: owner,
+        runAs: "creator",
+    };
+    const content = buildTriggerContent(meta, args.body || "");
+    await resourcePut(owner, path, content);
+    // Refresh event subscriptions so the new trigger is active immediately
+    await refreshEventSubscriptions();
+    const summary = triggerType === "event"
+        ? `on ${meta.event || "?"}${meta.condition ? ` when "${meta.condition}"` : ""}`
+        : `on schedule "${meta.schedule}"`;
+    return `Automation "${name}" created. Fires ${summary} in ${meta.mode} mode.`;
+}
+async function handleUpdate(args, getCurrentUser) {
+    const owner = getCurrentUser();
+    const name = args.name;
+    const path = `jobs/${name}.md`;
+    const resource = await resourceGetByPath(owner, path);
+    if (!resource) {
+        return `Automation "${name}" not found (or you don't own it).`;
+    }
+    const { meta, body } = parseTriggerFrontmatter(resource.content);
+    if (args.enabled !== undefined) {
+        meta.enabled = args.enabled !== "false";
+    }
+    if (args.condition !== undefined) {
+        meta.condition = args.condition || undefined;
+    }
+    const newBody = args.body ?? body;
+    await resourcePut(resource.owner, resource.path, buildTriggerContent(meta, newBody));
+    await refreshEventSubscriptions();
+    return `Automation "${name}" updated.`;
+}
+async function handleDelete(args, getCurrentUser) {
+    const owner = getCurrentUser();
+    const path = `jobs/${args.name}.md`;
+    const resource = await resourceGetByPath(owner, path);
+    if (!resource)
+        return `Automation "${args.name}" not found.`;
+    await resourceDelete(resource.id);
+    return `Automation "${args.name}" deleted.`;
+}
+async function handleFireTest(args) {
+    // Dynamic import to avoid circular dependency at module load time
+    const { emit } = await import("../event-bus/index.js");
+    let data = {};
+    if (args.data) {
+        try {
+            data = JSON.parse(args.data);
+        }
+        catch {
+            return "Error: invalid JSON in data parameter.";
+        }
+    }
+    emit("test.event.fired", { data });
+    return `Test event fired with payload: ${JSON.stringify({ data })}. Any automations subscribed to "test.event.fired" will be evaluated.`;
+}
+/* ------------------------------------------------------------------ */
+/*  Consolidated tool entry                                           */
+/* ------------------------------------------------------------------ */
+const VALID_ACTIONS = [
+    "list-events",
+    "list",
+    "define",
+    "update",
+    "delete",
+    "fire-test",
+];
 export function createAutomationToolEntries(getCurrentUser) {
     return {
-        "list-automation-events": {
-            tool: {
-                description: "List all registered event types that automations can subscribe to. Returns event names, descriptions, and payload schemas. Call this BEFORE defining an automation to discover available events.",
-                parameters: { type: "object", properties: {} },
-            },
-            run: async () => {
-                const events = listEvents();
-                if (events.length === 0) {
-                    return "No events registered yet. Events are registered by integrations (mail, calendar, clips, etc.).";
-                }
-                const lines = events.map((e) => {
-                    let schemaStr = "";
-                    try {
-                        const s = e.payloadSchema;
-                        if (s?._zod?.def?.shape) {
-                            const fields = Object.keys(s._zod.def.shape);
-                            schemaStr = ` Fields: ${fields.join(", ")}`;
-                        }
-                    }
-                    catch {
-                        // ignore
-                    }
-                    const example = e.example
-                        ? `\n  Example: ${JSON.stringify(e.example)}`
-                        : "";
-                    return `- **${e.name}**: ${e.description}${schemaStr}${example}`;
-                });
-                return lines.join("\n");
-            },
-            readOnly: true,
-        },
-        "list-automations": {
+        "manage-automations": {
             tool: {
-                description: "List all automations (triggers). Shows name, event, condition, mode, status, and domain.",
+                description: `Manage automations (event-triggered and scheduled tasks). Use the "action" parameter to choose an operation:
+
+- **list-events**: List all registered event types that automations can subscribe to. Returns event names, descriptions, and payload schemas. Call this BEFORE defining an automation to discover available events.
+- **list**: List all automations (triggers). Shows name, event, condition, mode, status, and domain. Optional params: domain, enabled_only.
+- **define**: Create a new automation. IMPORTANT: Always confirm with the user before calling — show them a summary of what will be created. Required params: name, trigger_type, body. Optional: event, schedule, condition, mode, domain.
+- **update**: Update an existing automation's settings (enabled, condition, body, etc.). Required param: name. Optional: enabled, condition, body.
+- **delete**: Delete an automation. Always confirm with the user first. Required param: name.
+- **fire-test**: Fire a test event to validate automations. Emits a test.event.fired event. Optional param: data (JSON string).`,
                 parameters: {
                     type: "object",
                     properties: {
-                        domain: {
+                        action: {
                             type: "string",
-                            description: "Filter by domain (mail, calendar, clips, etc.). Omit for all.",
+                            description: "The operation to perform: list-events, list, define, update, delete, or fire-test.",
+                            enum: [...VALID_ACTIONS],
                         },
-                        enabled_only: {
-                            type: "string",
-                            description: '"true" to show only enabled automations.',
-                        },
-                    },
-                },
-            },
-            run: async (args) => {
-                const resources = await resourceListAllOwners("jobs/");
-                const triggers = resources
-                    .filter((r) => r.path.endsWith(".md"))
-                    .map((r) => {
-                    const { meta, body } = parseTriggerFrontmatter(r.content);
-                    const name = r.path.replace(/^jobs\//, "").replace(/\.md$/, "");
-                    return { name, meta, body, owner: r.owner, id: r.id };
-                })
-                    .filter((t) => {
-                    if (args.domain && t.meta.domain !== args.domain)
-                        return false;
-                    if (args.enabled_only === "true" && !t.meta.enabled)
-                        return false;
-                    return true;
-                });
-                if (triggers.length === 0)
-                    return "No automations found.";
-                const lines = triggers.map((t) => {
-                    const type = t.meta.triggerType === "event"
-                        ? `on ${t.meta.event || "?"}`
-                        : `cron: ${t.meta.schedule}`;
-                    const status = t.meta.enabled ? "enabled" : "disabled";
-                    const lastStatus = t.meta.lastStatus
-                        ? ` (last: ${t.meta.lastStatus})`
-                        : "";
-                    const condition = t.meta.condition
-                        ? `\n  Condition: "${t.meta.condition}"`
-                        : "";
-                    const domain = t.meta.domain ? ` [${t.meta.domain}]` : "";
-                    return `- **${t.name}**${domain}: ${type} → ${t.meta.mode} (${status}${lastStatus})${condition}\n  Body: ${t.body.slice(0, 100)}${t.body.length > 100 ? "..." : ""}`;
-                });
-                return lines.join("\n\n");
-            },
-            readOnly: true,
-        },
-        "define-automation": {
-            tool: {
-                description: `Create a new automation. The automation is stored as a markdown resource and fires when the specified event occurs and the condition (if any) matches. IMPORTANT: Always confirm with the user before calling this — show them a summary of what will be created.`,
-                parameters: {
-                    type: "object",
-                    properties: {
                         name: {
                             type: "string",
-                            description: "Slug name for the automation (lowercase, hyphens). Example: slack-on-builder-booking",
+                            description: "Slug name for the automation (lowercase, hyphens). Used by define, update, and delete.",
                         },
                         trigger_type: {
                             type: "string",
-                            description: '"event" or "schedule".',
+                            description: '"event" or "schedule". Required for define.',
                             enum: ["event", "schedule"],
                         },
                         event: {
                             type: "string",
-                            description: "For event triggers: the event name to subscribe to. Call list-automation-events first to see available events.",
+                            description: "For event triggers: the event name to subscribe to. Call with action=list-events first to see available events.",
                         },
                         schedule: {
                             type: "string",
@@ -120,156 +197,55 @@ export function createAutomationToolEntries(getCurrentUser) {
                         },
                         condition: {
                             type: "string",
-                            description: 'Natural-language condition. Example: "attendee email ends with @builder.io". Leave empty for unconditional.',
+                            description: 'Natural-language condition. Example: "attendee email ends with @builder.io". Leave empty for unconditional. Used by define and update.',
                         },
                         mode: {
                             type: "string",
-                            description: '"agentic" (full agent loop, can use tools) or "deterministic" (fixed actions only).',
+                            description: '"agentic" (full agent loop, can use tools) or "deterministic" (fixed actions only). Used by define.',
                             enum: ["agentic", "deterministic"],
                         },
                         domain: {
                             type: "string",
-                            description: "Domain tag for grouping (mail, calendar, clips, etc.).",
+                            description: "Domain tag for grouping (mail, calendar, clips, etc.). Used by define and list.",
                         },
                         body: {
                             type: "string",
-                            description: "The natural-language instructions for what to do when the automation fires. This becomes the agent's prompt in agentic mode.",
-                        },
-                    },
-                    required: ["name", "trigger_type", "body"],
-                },
-            },
-            run: async (args) => {
-                const owner = getCurrentUser();
-                const name = (args.name || "").replace(/[^a-z0-9-]/g, "-");
-                if (!name)
-                    return "Error: name is required (lowercase, hyphens).";
-                const path = `jobs/${name}.md`;
-                // Check if it already exists
-                const existing = await resourceGetByPath(owner, path);
-                if (existing) {
-                    return `Error: An automation named "${name}" already exists. Use a different name or delete the existing one first.`;
-                }
-                const triggerType = args.trigger_type === "schedule" ? "schedule" : "event";
-                const meta = {
-                    schedule: args.schedule || "",
-                    enabled: true,
-                    triggerType,
-                    event: args.event || undefined,
-                    condition: args.condition || undefined,
-                    mode: args.mode === "deterministic" ? "deterministic" : "agentic",
-                    domain: args.domain || undefined,
-                    createdBy: owner,
-                    runAs: "creator",
-                };
-                const content = buildTriggerContent(meta, args.body || "");
-                await resourcePut(owner, path, content);
-                // Refresh event subscriptions so the new trigger is active immediately
-                await refreshEventSubscriptions();
-                const summary = triggerType === "event"
-                    ? `on ${meta.event || "?"}${meta.condition ? ` when "${meta.condition}"` : ""}`
-                    : `on schedule "${meta.schedule}"`;
-                return `Automation "${name}" created. Fires ${summary} in ${meta.mode} mode.`;
-            },
-        },
-        "update-automation": {
-            tool: {
-                description: "Update an existing automation's settings (enabled, condition, body, etc.).",
-                parameters: {
-                    type: "object",
-                    properties: {
-                        name: {
-                            type: "string",
-                            description: "Name of the automation to update.",
+                            description: "The natural-language instructions for what to do when the automation fires. This becomes the agent's prompt in agentic mode. Used by define and update.",
                         },
                         enabled: {
                             type: "string",
-                            description: '"true" or "false" to enable/disable.',
-                        },
-                        condition: {
-                            type: "string",
-                            description: "New natural-language condition (or empty to clear).",
-                        },
-                        body: {
-                            type: "string",
-                            description: "New automation body/instructions.",
+                            description: '"true" or "false" to enable/disable. Used by update.',
                         },
-                    },
-                    required: ["name"],
-                },
-            },
-            run: async (args) => {
-                const owner = getCurrentUser();
-                const name = args.name;
-                const path = `jobs/${name}.md`;
-                const resource = await resourceGetByPath(owner, path);
-                if (!resource) {
-                    return `Automation "${name}" not found (or you don't own it).`;
-                }
-                const { meta, body } = parseTriggerFrontmatter(resource.content);
-                if (args.enabled !== undefined) {
-                    meta.enabled = args.enabled !== "false";
-                }
-                if (args.condition !== undefined) {
-                    meta.condition = args.condition || undefined;
-                }
-                const newBody = args.body ?? body;
-                await resourcePut(resource.owner, resource.path, buildTriggerContent(meta, newBody));
-                await refreshEventSubscriptions();
-                return `Automation "${name}" updated.`;
-            },
-        },
-        "delete-automation": {
-            tool: {
-                description: "Delete an automation. Always confirm with the user first.",
-                parameters: {
-                    type: "object",
-                    properties: {
-                        name: {
+                        enabled_only: {
                             type: "string",
-                            description: "Name of the automation to delete.",
+                            description: '"true" to show only enabled automations. Used by list.',
                         },
-                    },
-                    required: ["name"],
-                },
-            },
-            run: async (args) => {
-                const owner = getCurrentUser();
-                const path = `jobs/${args.name}.md`;
-                const resource = await resourceGetByPath(owner, path);
-                if (!resource)
-                    return `Automation "${args.name}" not found.`;
-                await resourceDelete(resource.id);
-                return `Automation "${args.name}" deleted.`;
-            },
-        },
-        "fire-test-event": {
-            tool: {
-                description: "Fire a test event to validate automations. Emits a test.event.fired event with the provided data.",
-                parameters: {
-                    type: "object",
-                    properties: {
                         data: {
                             type: "string",
-                            description: 'JSON data to include as the event payload. Example: \'{"email": "test@example.com"}\'.',
+                            description: 'JSON data to include as the test event payload. Used by fire-test. Example: \'{"email": "test@example.com"}\'.',
                         },
                     },
+                    required: ["action"],
                 },
             },
             run: async (args) => {
-                // Dynamic import to avoid circular dependency at module load time
-                const { emit } = await import("../event-bus/index.js");
-                let data = {};
-                if (args.data) {
-                    try {
-                        data = JSON.parse(args.data);
-                    }
-                    catch {
-                        return "Error: invalid JSON in data parameter.";
-                    }
+                const action = args.action;
+                switch (action) {
+                    case "list-events":
+                        return handleListEvents();
+                    case "list":
+                        return handleList(args);
+                    case "define":
+                        return handleDefine(args, getCurrentUser);
+                    case "update":
+                        return handleUpdate(args, getCurrentUser);
+                    case "delete":
+                        return handleDelete(args, getCurrentUser);
+                    case "fire-test":
+                        return handleFireTest(args);
+                    default:
+                        return `Error: unknown action "${action}". Valid actions: ${VALID_ACTIONS.join(", ")}.`;
                 }
-                emit("test.event.fired", { data });
-                return `Test event fired with payload: ${JSON.stringify({ data })}. Any automations subscribed to "test.event.fired" will be evaluated.`;
             },
         },
     };