@runcore-sh/runcore 0.1.2

package/dist/capabilities/definitions/calendar.js

@@ -0,0 +1,173 @@
+/**
+ * Calendar capability — create, update, delete events via the local CalendarStore.
+ * Google sync happens in the background via the adapter.
+ */
+import { getCalendarStore } from "../../calendar/store.js";
+import { getGoogleCalendarAdapter } from "../../calendar/google-adapter.js";
+import { logActivity } from "../../activity/log.js";
+import { pushNotification } from "../../goals/notifications.js";
+import { getInstanceName } from "../../instance.js";
+const actionLabel = (ctx) => ctx.origin === "autonomous" ? "AUTONOMOUS" : "PROMPTED";
+const reason = (ctx, verb) => {
+    switch (ctx.origin) {
+        case "email": return `${getInstanceName()} email triggered calendar ${verb}`;
+        case "autonomous": return `planner ${verb}d calendar event`;
+        default: return `AI ${verb}d calendar event via chat`;
+    }
+};
+export const calendarCapability = {
+    id: "calendar",
+    pattern: "action",
+    tag: "CALENDAR_ACTION",
+    keywords: ["schedule", "calendar", "meeting", "event", "appointment", "agenda"],
+    getPromptInstructions(ctx) {
+        const name = ctx.name ?? "the user";
+        return [
+            `## Calendar (via [CALENDAR_ACTION] blocks)`,
+            `To create, update, or delete calendar events, include a [CALENDAR_ACTION] block in your response.`,
+            ``,
+            `Create an event:`,
+            `[CALENDAR_ACTION]`,
+            `{"action": "create", "title": "Team standup", "start": "2026-03-02T09:00:00-08:00", "end": "2026-03-02T09:30:00-08:00", "description": "Daily sync", "location": "Zoom", "attendees": ["alice@example.com"]}`,
+            `[/CALENDAR_ACTION]`,
+            ``,
+            `Update an event (requires eventId from calendar data):`,
+            `[CALENDAR_ACTION]`,
+            `{"action": "update", "eventId": "abc123", "title": "Renamed event", "start": "2026-03-02T10:00:00-08:00", "end": "2026-03-02T10:30:00-08:00"}`,
+            `[/CALENDAR_ACTION]`,
+            ``,
+            `Delete an event:`,
+            `[CALENDAR_ACTION]`,
+            `{"action": "delete", "eventId": "abc123"}`,
+            `[/CALENDAR_ACTION]`,
+            ``,
+            `Fields: title, start (ISO 8601), end (ISO 8601), description, location, attendees (email array), timeZone. For update/delete, eventId is required.`,
+            `Create and update events without confirmation — just do it and mention what you did. Confirm with ${name} before deleting events (destructive). When calendar data is in context, use the real eventId values.`,
+        ].join("\n");
+    },
+    getPromptOverride(origin) {
+        if (origin === "email") {
+            return [
+                `## Calendar (via [CALENDAR_ACTION] blocks)`,
+                `If someone asks to schedule a meeting, create an event, or set up an appointment — DO IT immediately with a [CALENDAR_ACTION] block.`,
+                `[CALENDAR_ACTION]`,
+                `{"action": "create", "title": "Meeting title", "start": "2026-03-05T10:00:00-08:00", "end": "2026-03-05T10:30:00-08:00", "description": "Notes", "attendees": ["email@example.com"]}`,
+                `[/CALENDAR_ACTION]`,
+                `For updates: {"action": "update", "eventId": "abc123", "title": "New title"}`,
+                `For deletes: {"action": "delete", "eventId": "abc123"}`,
+            ].join("\n");
+        }
+        if (origin === "autonomous") {
+            return [
+                `Create a calendar event:`,
+                `[CALENDAR_ACTION]`,
+                `{"action": "create", "title": "Meeting title", "start": "2026-03-05T10:00:00-08:00", "end": "2026-03-05T10:30:00-08:00", "description": "Notes", "attendees": ["email@example.com"]}`,
+                `[/CALENDAR_ACTION]`,
+                ``,
+                `Update an event:`,
+                `[CALENDAR_ACTION]`,
+                `{"action": "update", "eventId": "abc123", "title": "New title", "start": "..."}`,
+                `[/CALENDAR_ACTION]`,
+                ``,
+                `Delete an event:`,
+                `[CALENDAR_ACTION]`,
+                `{"action": "delete", "eventId": "abc123"}`,
+                `[/CALENDAR_ACTION]`,
+            ].join("\n");
+        }
+        return null;
+    },
+    async execute(payload, ctx) {
+        const store = getCalendarStore();
+        if (!store)
+            return { capabilityId: "calendar", ok: false, message: "Calendar store not initialized" };
+        const req = payload;
+        const label = actionLabel(ctx);
+        const adapter = getGoogleCalendarAdapter();
+        if (req.action === "create" && req.title && req.start && req.end) {
+            try {
+                const event = await store.create({
+                    title: req.title,
+                    start: req.start,
+                    end: req.end,
+                    description: req.description,
+                    location: req.location,
+                    attendees: req.attendees?.map((email) => ({
+                        email,
+                        role: "required",
+                        status: "needs-action",
+                    })),
+                    recurrence: req.recurrence,
+                    timezone: req.timeZone,
+                    source: "manual",
+                });
+                // Push to Google in background
+                if (adapter.isAvailable()) {
+                    adapter.push(event).catch(() => { });
+                }
+                logActivity({ source: "calendar", summary: `Created event${ctx.origin === "email" ? " via email" : ""}: ${req.title}`, actionLabel: label, reason: reason(ctx, "create") });
+                pushNotification({ timestamp: new Date().toISOString(), source: "calendar", message: `Created calendar event: **${req.title}** (${new Date(req.start).toLocaleString()})` });
+                return { capabilityId: "calendar", ok: true, message: `Created event: ${req.title}` };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logActivity({ source: "calendar", summary: `Failed to create event${ctx.origin === "email" ? " via email" : ""}: ${msg}`, actionLabel: label, reason: reason(ctx, "create") });
+                if (ctx.origin === "chat") {
+                    pushNotification({ timestamp: new Date().toISOString(), source: "calendar", message: `Failed to create event "${req.title}": ${msg}` });
+                }
+                return { capabilityId: "calendar", ok: false, message: msg };
+            }
+        }
+        if (req.action === "update" && req.eventId) {
+            try {
+                const { action: _, eventId, ...changes } = req;
+                const event = await store.update(eventId, changes);
+                if (!event)
+                    return { capabilityId: "calendar", ok: false, message: `Event not found: ${eventId}` };
+                // Push to Google in background
+                if (adapter.isAvailable() && event.externalIds.google) {
+                    adapter.push(event).catch(() => { });
+                }
+                logActivity({ source: "calendar", summary: `Updated event${ctx.origin === "email" ? " via email" : ""}: ${eventId}`, actionLabel: label, reason: reason(ctx, "update") });
+                if (ctx.origin === "chat") {
+                    pushNotification({ timestamp: new Date().toISOString(), source: "calendar", message: `Updated calendar event${req.title ? `: **${req.title}**` : ""}` });
+                }
+                return { capabilityId: "calendar", ok: true, message: `Updated event: ${eventId}` };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logActivity({ source: "calendar", summary: `Failed to update event: ${msg}`, actionLabel: label, reason: reason(ctx, "update") });
+                if (ctx.origin === "chat") {
+                    pushNotification({ timestamp: new Date().toISOString(), source: "calendar", message: `Failed to update event: ${msg}` });
+                }
+                return { capabilityId: "calendar", ok: false, message: msg };
+            }
+        }
+        if (req.action === "delete" && req.eventId) {
+            try {
+                const event = await store.cancel(req.eventId);
+                if (!event)
+                    return { capabilityId: "calendar", ok: false, message: `Event not found: ${req.eventId}` };
+                // Remove from Google in background
+                if (adapter.isAvailable() && event.externalIds.google) {
+                    adapter.remove(event.externalIds.google).catch(() => { });
+                }
+                logActivity({ source: "calendar", summary: `Deleted event${ctx.origin === "email" ? " via email" : ""}: ${req.eventId}`, actionLabel: label, reason: reason(ctx, "delete") });
+                if (ctx.origin === "chat") {
+                    pushNotification({ timestamp: new Date().toISOString(), source: "calendar", message: `Deleted calendar event` });
+                }
+                return { capabilityId: "calendar", ok: true, message: `Deleted event: ${req.eventId}` };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logActivity({ source: "calendar", summary: `Failed to delete event: ${msg}`, actionLabel: label, reason: reason(ctx, "delete") });
+                if (ctx.origin === "chat") {
+                    pushNotification({ timestamp: new Date().toISOString(), source: "calendar", message: `Failed to delete event: ${msg}` });
+                }
+                return { capabilityId: "calendar", ok: false, message: msg };
+            }
+        }
+        return { capabilityId: "calendar", ok: false, message: "Unknown or incomplete calendar action" };
+    },
+};
+//# sourceMappingURL=calendar.js.map

package/dist/capabilities/definitions/calendar.js.map

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

package/dist/capabilities/definitions/docs.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Docs/Sheets capability — create Google Docs and Spreadsheets.
+ */
+import type { ActionBlockCapability } from "../types.js";
+export declare const docsCapability: ActionBlockCapability;
+//# sourceMappingURL=docs.d.ts.map

package/dist/capabilities/definitions/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/capabilities/definitions/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,qBAAqB,EAAwC,MAAM,aAAa,CAAC;AAa/F,eAAO,MAAM,cAAc,EAAE,qBAkD5B,CAAC"}

package/dist/capabilities/definitions/docs.js

@@ -0,0 +1,62 @@
+/**
+ * Docs/Sheets capability — create Google Docs and Spreadsheets.
+ */
+import { createDocWithContent, createSpreadsheet } from "../../google/docs.js";
+import { logActivity } from "../../activity/log.js";
+import { pushNotification } from "../../goals/notifications.js";
+import { getInstanceName } from "../../instance.js";
+const actionLabel = (ctx) => ctx.origin === "autonomous" ? "AUTONOMOUS" : "PROMPTED";
+const reason = (ctx) => {
+    switch (ctx.origin) {
+        case "email": return `${getInstanceName()} email triggered doc create`;
+        case "autonomous": return "planner created document";
+        default: return "user requested via chat";
+    }
+};
+export const docsCapability = {
+    id: "docs",
+    pattern: "action",
+    tag: "DOC_ACTION",
+    keywords: ["document", "doc", "spreadsheet", "sheet", "google doc", "google sheet"],
+    getPromptInstructions(_ctx) {
+        return [
+            `## Google Docs & Sheets (create via [DOC_ACTION] blocks)`,
+            `To create a Google Doc or Sheet, include a [DOC_ACTION] block in your response:`,
+            `[DOC_ACTION]`,
+            `{"action": "create_doc", "title": "Document Title", "content": "# Heading\\nParagraph text\\n## Subheading\\nMore text"}`,
+            `[/DOC_ACTION]`,
+            ``,
+            `[DOC_ACTION]`,
+            `{"action": "create_sheet", "title": "Sheet Title", "data": [["Header1", "Header2"], ["Row1Col1", "Row1Col2"]]}`,
+            `[/DOC_ACTION]`,
+            ``,
+            `Content supports simple markdown headings (# ## ###). The URL will be returned to the user.`,
+        ].join("\n");
+    },
+    async execute(payload, ctx) {
+        const req = payload;
+        const label = actionLabel(ctx);
+        if (req.action === "create_doc" && req.title) {
+            const result = await createDocWithContent(req.title, req.content ?? "");
+            if (result.ok && result.url) {
+                logActivity({ source: "google", summary: `Created Google Doc: ${req.title}`, detail: result.url, actionLabel: label, reason: reason(ctx) });
+                pushNotification({ timestamp: new Date().toISOString(), source: "google", message: `Created Google Doc: [${req.title}](${result.url})` });
+                return { capabilityId: "docs", ok: true, message: `Created doc: ${req.title} — ${result.url}` };
+            }
+            logActivity({ source: "google", summary: `Failed to create doc: ${result.message}`, actionLabel: label, reason: reason(ctx) });
+            return { capabilityId: "docs", ok: false, message: result.message };
+        }
+        if (req.action === "create_sheet" && req.title) {
+            const result = await createSpreadsheet(req.title, req.data);
+            if (result.ok && result.data) {
+                logActivity({ source: "google", summary: `Created Google Sheet: ${req.title}`, detail: result.data.spreadsheetUrl, actionLabel: label, reason: reason(ctx) });
+                pushNotification({ timestamp: new Date().toISOString(), source: "google", message: `Created Google Sheet: [${req.title}](${result.data.spreadsheetUrl})` });
+                return { capabilityId: "docs", ok: true, message: `Created sheet: ${req.title} — ${result.data.spreadsheetUrl}` };
+            }
+            logActivity({ source: "google", summary: `Failed to create sheet: ${result.message}`, actionLabel: label, reason: reason(ctx) });
+            return { capabilityId: "docs", ok: false, message: result.message };
+        }
+        return { capabilityId: "docs", ok: false, message: "Unknown or incomplete doc action" };
+    },
+};
+//# sourceMappingURL=docs.js.map

package/dist/capabilities/definitions/docs.js.map

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

package/dist/capabilities/definitions/email-context.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Email context provider — injects inbox summary or search results into the
+ * LLM prompt when the user mentions email-related keywords.
+ */
+import type { ContextProviderCapability } from "../types.js";
+export declare const emailContextProvider: ContextProviderCapability;
+//# sourceMappingURL=email-context.d.ts.map

package/dist/capabilities/definitions/email-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-context.d.ts","sourceRoot":"","sources":["../../../src/capabilities/definitions/email-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAmC,MAAM,aAAa,CAAC;AAE9F,eAAO,MAAM,oBAAoB,EAAE,yBAqDlC,CAAC"}

package/dist/capabilities/definitions/email-context.js

@@ -0,0 +1,55 @@
+/**
+ * Email context provider — injects inbox summary or search results into the
+ * LLM prompt when the user mentions email-related keywords.
+ */
+import { isGmailAvailable, getRecentMessages, searchMessages, getUnreadCount, formatMessagesForContext } from "../../google/gmail.js";
+export const emailContextProvider = {
+    id: "email-context",
+    pattern: "context",
+    keywords: ["email", "inbox", "mail", "unread", "message", "gmail", "reply to"],
+    getPromptInstructions(_ctx) {
+        return ""; // Context providers inject data, not prompt instructions
+    },
+    shouldInject(message) {
+        if (!isGmailAvailable())
+            return false;
+        const keywords = /\b(email|inbox|mail|unread|messages?|gmail|from .+@|reply to)\b/i;
+        return keywords.test(message);
+    },
+    async getContext(message) {
+        // Check if user is searching for a specific person/topic
+        const fromMatch = message.match(/(?:email|mail|message)s?\s+from\s+(\w+)/i);
+        if (fromMatch) {
+            const searchResult = await searchMessages(`from:${fromMatch[1]}`, 5);
+            if (!searchResult.ok || !searchResult.messages || searchResult.messages.length === 0)
+                return null;
+            return {
+                label: `Email search: from ${fromMatch[1]}`,
+                content: [
+                    `--- Email search results: from ${fromMatch[1]} ---`,
+                    formatMessagesForContext(searchResult.messages),
+                    `--- End email results ---`,
+                ].join("\n"),
+            };
+        }
+        // Generic inbox query — show recent unread
+        const [unreadResult, recentResult] = await Promise.all([
+            getUnreadCount(),
+            getRecentMessages(24),
+        ]);
+        const unreadCount = unreadResult.ok ? unreadResult.count ?? 0 : 0;
+        const recent = recentResult.ok ? recentResult.messages ?? [] : [];
+        if (recent.length === 0 && unreadCount === 0)
+            return null;
+        return {
+            label: "Inbox summary",
+            content: [
+                `--- Inbox summary (${unreadCount} unread) ---`,
+                formatMessagesForContext(recent.slice(0, 10)),
+                `--- End inbox summary ---`,
+                `Use this to answer the user's question about their email or inbox.`,
+            ].join("\n"),
+        };
+    },
+};
+//# sourceMappingURL=email-context.js.map

package/dist/capabilities/definitions/email-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-context.js","sourceRoot":"","sources":["../../../src/capabilities/definitions/email-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAGtI,MAAM,CAAC,MAAM,oBAAoB,GAA8B;IAC7D,EAAE,EAAE,eAAe;IACnB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC;IAE9E,qBAAqB,CAAC,IAAmB;QACvC,OAAO,EAAE,CAAC,CAAC,yDAAyD;IACtE,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,IAAI,CAAC,gBAAgB,EAAE;YAAE,OAAO,KAAK,CAAC;QACtC,MAAM,QAAQ,GAAG,kEAAkE,CAAC;QACpF,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,yDAAyD;QACzD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAE5E,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,QAAQ,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACrE,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAElG,OAAO;gBACL,KAAK,EAAE,sBAAsB,SAAS,CAAC,CAAC,CAAC,EAAE;gBAC3C,OAAO,EAAE;oBACP,kCAAkC,SAAS,CAAC,CAAC,CAAC,MAAM;oBACpD,wBAAwB,CAAC,YAAY,CAAC,QAAQ,CAAC;oBAC/C,2BAA2B;iBAC5B,CAAC,IAAI,CAAC,IAAI,CAAC;aACb,CAAC;QACJ,CAAC;QAED,2CAA2C;QAC3C,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACrD,cAAc,EAAE;YAChB,iBAAiB,CAAC,EAAE,CAAC;SACtB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAElE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE1D,OAAO;YACL,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE;gBACP,sBAAsB,WAAW,cAAc;gBAC/C,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7C,2BAA2B;gBAC3B,oEAAoE;aACrE,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/capabilities/definitions/email.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Email capability — send and reply via Gmail.
+ * Includes placeholder threadId/inReplyTo sanitization.
+ */
+import type { ActionBlockCapability } from "../types.js";
+export declare const emailCapability: ActionBlockCapability;
+//# sourceMappingURL=email.d.ts.map

package/dist/capabilities/definitions/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/capabilities/definitions/email.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,qBAAqB,EAAwC,MAAM,aAAa,CAAC;AAgB/F,eAAO,MAAM,eAAe,EAAE,qBAmF7B,CAAC"}

package/dist/capabilities/definitions/email.js

@@ -0,0 +1,94 @@
+/**
+ * Email capability — send and reply via Gmail.
+ * Includes placeholder threadId/inReplyTo sanitization.
+ */
+import { sendEmail } from "../../google/gmail-send.js";
+import { logActivity } from "../../activity/log.js";
+import { pushNotification } from "../../goals/notifications.js";
+import { getInstanceName } from "../../instance.js";
+/** Regex that catches common placeholder/hallucinated threadId values. */
+const PLACEHOLDER_RE = /placeholder|from.context|example|<use real/i;
+const actionLabel = (ctx) => ctx.origin === "autonomous" ? "AUTONOMOUS" : "PROMPTED";
+const reason = (ctx) => {
+    switch (ctx.origin) {
+        case "email": return `${getInstanceName()} email triggered send`;
+        case "autonomous": return "planner sent email";
+        default: return "AI sent email via chat";
+    }
+};
+export const emailCapability = {
+    id: "email",
+    pattern: "action",
+    tag: "EMAIL_ACTION",
+    keywords: ["email", "send", "inbox", "reply", "notify", "gmail", "message"],
+    getPromptInstructions(ctx) {
+        const name = ctx.name ?? "the user";
+        return [
+            `## Gmail (send/reply via [EMAIL_ACTION] blocks)`,
+            `To send an email or reply to a thread, include an [EMAIL_ACTION] block in your response.`,
+            ``,
+            `Send a new email:`,
+            `[EMAIL_ACTION]`,
+            `{"action": "send", "to": "someone@example.com", "subject": "Meeting notes", "body": "Hi,\\n\\nHere are the notes from today's meeting..."}`,
+            `[/EMAIL_ACTION]`,
+            ``,
+            `Reply to a thread (keeps it in the same Gmail conversation):`,
+            `[EMAIL_ACTION]`,
+            `{"action": "reply", "to": "someone@example.com", "subject": "Re: Meeting notes", "body": "Thanks for the follow-up!", "threadId": "<use real threadId from Gmail data>", "inReplyTo": "<use real Message-ID from Gmail data>"}`,
+            `[/EMAIL_ACTION]`,
+            ``,
+            `Fields: to (email or array), subject, body (plain text). Optional: cc, bcc, threadId (for replies), inReplyTo (Message-ID header of the email being replied to).`,
+            `IMPORTANT: For replies, you MUST use real threadId and inReplyTo values from the Gmail data in your context. Do NOT use placeholder values — if you don't have the real IDs, omit threadId/inReplyTo and send as a new email instead.`,
+            `Reply in existing threads (when threadId is present) without confirmation — just send and mention what you did. Confirm with ${name} before sending new emails to new recipients.`,
+        ].join("\n");
+    },
+    getPromptOverride(origin) {
+        if (origin === "autonomous") {
+            return [
+                `Send an email:`,
+                `[EMAIL_ACTION]`,
+                `{"action": "send", "to": "someone@example.com", "subject": "Subject", "body": "Email body"}`,
+                `[/EMAIL_ACTION]`,
+            ].join("\n");
+        }
+        // Email handler doesn't include dedicated email instructions (it's already replying)
+        return null;
+    },
+    async execute(payload, ctx) {
+        const req = payload;
+        const label = actionLabel(ctx);
+        if (!req.to || !req.subject || !req.body) {
+            return { capabilityId: "email", ok: false, message: "Missing required fields (to, subject, body)" };
+        }
+        // Sanitize placeholder threadId/inReplyTo values the LLM sometimes hallucinates
+        const threadId = req.threadId && !PLACEHOLDER_RE.test(req.threadId) ? req.threadId : undefined;
+        const inReplyTo = req.inReplyTo && !PLACEHOLDER_RE.test(req.inReplyTo) ? req.inReplyTo : undefined;
+        const result = await sendEmail({
+            to: req.to,
+            cc: req.cc,
+            bcc: req.bcc,
+            subject: req.subject,
+            body: req.body,
+            threadId,
+            inReplyTo,
+            references: req.references,
+        });
+        const toStr = Array.isArray(req.to) ? req.to.join(", ") : req.to;
+        if (result.ok) {
+            logActivity({ source: "gmail", summary: `Email sent${ctx.origin === "email" ? " via email handler" : ""} to ${toStr}: "${req.subject}"`, actionLabel: label, reason: reason(ctx) });
+            if (ctx.origin === "chat") {
+                pushNotification({ timestamp: new Date().toISOString(), source: "gmail", message: `Email sent to **${toStr}**: "${req.subject}"` });
+            }
+            if (ctx.origin === "autonomous") {
+                pushNotification({ timestamp: new Date().toISOString(), source: "gmail", message: `Email sent to **${toStr}**: "${req.subject}"` });
+            }
+            return { capabilityId: "email", ok: true, message: `Email sent to ${toStr}` };
+        }
+        logActivity({ source: "gmail", summary: `Failed to send email: ${result.message}`, actionLabel: label, reason: reason(ctx) });
+        if (ctx.origin === "chat") {
+            pushNotification({ timestamp: new Date().toISOString(), source: "gmail", message: `Failed to send email to ${toStr}: ${result.message}` });
+        }
+        return { capabilityId: "email", ok: false, message: result.message };
+    },
+};
+//# sourceMappingURL=email.js.map

package/dist/capabilities/definitions/email.js.map

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

package/dist/capabilities/definitions/task-done.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Task-Done meta capability — marks board items as done when the autonomous
+ * planner emits [TASK_DONE] blocks after completing work.
+ *
+ * Meta pattern: all blocks are batched and processed together (not one-by-one).
+ * Autonomous-only — not used in chat or email flows.
+ */
+import type { MetaCapability } from "../types.js";
+export declare const taskDoneCapability: MetaCapability;
+//# sourceMappingURL=task-done.d.ts.map

package/dist/capabilities/definitions/task-done.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-done.d.ts","sourceRoot":"","sources":["../../../src/capabilities/definitions/task-done.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAyD,MAAM,aAAa,CAAC;AAIzG,eAAO,MAAM,kBAAkB,EAAE,cA+EhC,CAAC"}

package/dist/capabilities/definitions/task-done.js

@@ -0,0 +1,83 @@
+/**
+ * Task-Done meta capability — marks board items as done when the autonomous
+ * planner emits [TASK_DONE] blocks after completing work.
+ *
+ * Meta pattern: all blocks are batched and processed together (not one-by-one).
+ * Autonomous-only — not used in chat or email flows.
+ */
+import { getBoardProvider } from "../../board/provider.js";
+import { logActivity } from "../../activity/log.js";
+import { createLogger } from "../../utils/logger.js";
+const log = createLogger("cap:task-done");
+export const taskDoneCapability = {
+    id: "task-done",
+    pattern: "meta",
+    tag: "TASK_DONE",
+    keywords: ["task_done", "complete"],
+    getPromptInstructions(_ctx) {
+        return [
+            `## Task Done (via [TASK_DONE] blocks)`,
+            `After completing a task from the backlog (e.g., an agent finished work, you performed an action),`,
+            `mark the corresponding board item as done by including a [TASK_DONE] block:`,
+            ``,
+            `[TASK_DONE]`,
+            `{"taskId": "the-task-id-from-the-board"}`,
+            `[/TASK_DONE]`,
+            ``,
+            `The task ID is provided in the backlog context (e.g., "DASH-5: Schedule meeting [todo, P4] (id: abc123)").`,
+            `Use the 'id' value, not the human-readable identifier.`,
+        ].join("\n");
+    },
+    async processBlocks(blocks, ctx) {
+        const board = getBoardProvider();
+        const results = [];
+        for (const block of blocks) {
+            if (!block.payload) {
+                results.push({ ok: false, message: "Invalid JSON in TASK_DONE block" });
+                continue;
+            }
+            const req = block.payload;
+            const taskId = req.taskId;
+            if (!taskId) {
+                results.push({ ok: false, message: "Missing taskId field" });
+                continue;
+            }
+            if (!board?.isAvailable()) {
+                results.push({ ok: false, message: "Board provider not available" });
+                continue;
+            }
+            try {
+                const store = board.getStore?.();
+                if (!store) {
+                    results.push({ ok: false, message: "Queue store not available" });
+                    continue;
+                }
+                const task = await store.get(taskId);
+                if (!task) {
+                    results.push({ ok: false, message: `Task not found: ${taskId}` });
+                    continue;
+                }
+                await store.update(task.id, { state: "done" });
+                log.info(`Marked task done: ${task.identifier} — ${task.title}`);
+                logActivity({
+                    source: "autonomous",
+                    summary: `Completed task ${task.identifier}: ${task.title}`,
+                    actionLabel: "AUTONOMOUS",
+                    reason: "planner marked task done after action",
+                });
+                results.push({ ok: true, message: `Closed ${task.identifier}: ${task.title}` });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                log.warn("Failed to process TASK_DONE block", { error: msg });
+                results.push({ ok: false, message: msg });
+            }
+        }
+        return {
+            capabilityId: "task-done",
+            blocksProcessed: blocks.length,
+            results,
+        };
+    },
+};
+//# sourceMappingURL=task-done.js.map

package/dist/capabilities/definitions/task-done.js.map

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

package/dist/capabilities/definitions/vault-context.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Vault context provider — injects retrieval API instructions into the LLM
+ * prompt when form-filling keywords are detected.
+ *
+ * SECURITY: This provider NEVER injects actual vault values into the prompt.
+ * It only tells the LLM what fields are available and how to request them
+ * via the VAULT_ACTION block. Actual values are retrieved at execution time
+ * and passed directly to the form-fill target, bypassing the LLM context.
+ */
+import type { ContextProviderCapability } from "../types.js";
+export declare const vaultContextProvider: ContextProviderCapability;
+//# sourceMappingURL=vault-context.d.ts.map

package/dist/capabilities/definitions/vault-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-context.d.ts","sourceRoot":"","sources":["../../../src/capabilities/definitions/vault-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,yBAAyB,EAG1B,MAAM,aAAa,CAAC;AAKrB,eAAO,MAAM,oBAAoB,EAAE,yBAwDlC,CAAC"}