@runcore-sh/runcore 0.1.2

package/dist/capabilities/definitions/board.js

@@ -0,0 +1,232 @@
+/**
+ * Board capability — create issues, mark done, comment, create projects.
+ * Operates on the active BoardProvider (Core Queue or Linear).
+ */
+import { getBoardProvider } from "../../board/provider.js";
+import { logActivity } from "../../activity/log.js";
+import { getInstanceName } from "../../instance.js";
+/** Map ActionOrigin to QueueTask origin for causal backrefs. */
+function mapOrigin(actionOrigin) {
+    switch (actionOrigin) {
+        case "chat": return "chat";
+        case "autonomous": return "autonomous";
+        case "email": return "external";
+        default: return "external";
+    }
+}
+const actionLabel = (ctx) => ctx.origin === "autonomous" ? "AUTONOMOUS" : "PROMPTED";
+const reason = (ctx) => {
+    switch (ctx.origin) {
+        case "email": return "email triggered board action";
+        case "autonomous": return "autonomous agent board action";
+        default: return "user requested via chat";
+    }
+};
+/** Log activity and return a board result in one step. */
+function boardResult(ok, message, ctx, detail) {
+    logActivity({ source: "board", summary: message, detail, actionLabel: actionLabel(ctx), reason: reason(ctx) });
+    return { capabilityId: "board", ok, message };
+}
+/** Find an issue by identifier, returning a failure result if not found. */
+async function findIssueOrFail(board, identifier, ctx) {
+    const issue = await board.findByIdentifier(identifier);
+    return issue ?? boardResult(false, `Issue not found: ${identifier}`, ctx);
+}
+/** Type guard: is the value a failure result (not a BoardIssue)? */
+function isFailure(v) {
+    return "ok" in v;
+}
+export const boardCapability = {
+    id: "board",
+    pattern: "action",
+    tag: "BOARD_ACTION",
+    keywords: ["task", "issue", "board", "backlog", "project", "todo", "done", "queue", "triage", "icebox"],
+    getPromptInstructions(ctx) {
+        const name = ctx.name ?? "the user";
+        const boardName = getBoardProvider()?.name ?? `${getInstanceName()} Queue`;
+        return [
+            `## Task Board (via [BOARD_ACTION] blocks)`,
+            `You have an internal task queue (${boardName}) that is always available, even offline.`,
+            `Tasks are organized into **projects**, each with its own identifier prefix (e.g. CORE-1, TRI-3).`,
+            `You can perform board operations by including [BOARD_ACTION] blocks in your response (similar to AGENT_REQUEST).`,
+            `Each block contains a JSON action. Available actions:`,
+            `- {"action": "create", "title": "Issue title", "description": "optional details", "project": "core-dev"} — project is required for normal tasks`,
+            `- {"action": "create_project", "name": "Project Name", "prefix": "PRJ", "description": "optional"} — create a new project`,
+            `- {"action": "done", "identifier": "CORE-1"}`,
+            `- {"action": "comment", "identifier": "CORE-1", "body": "Comment text"}`,
+            `- {"action": "comment", "identifier": "TRI-3", "body": "Comment text", "author": "Sarah", "exchangeSource": "external"} — track an exchange with an outside party`,
+            ``,
+            `Example — create an issue:`,
+            `[BOARD_ACTION]`,
+            `{"action": "create", "title": "Groom backlog weekly", "project": "core-dev"}`,
+            `[/BOARD_ACTION]`,
+            ``,
+            `Example — batch: comment on two issues (each block MUST have its own [BOARD_ACTION]...[/BOARD_ACTION] wrapper):`,
+            `[BOARD_ACTION]`,
+            `{"action": "comment", "identifier": "DASH-1", "body": "Spec added"}`,
+            `[/BOARD_ACTION]`,
+            `[BOARD_ACTION]`,
+            `{"action": "comment", "identifier": "DASH-2", "body": "Spec added"}`,
+            `[/BOARD_ACTION]`,
+            ``,
+            `CRITICAL: Every block MUST end with [/BOARD_ACTION] — not "}]" or any other closing. Without the closing tag, the action is silently dropped.`,
+            `You can include MULTIPLE [BOARD_ACTION] blocks to perform batch operations (e.g. close several issues at once).`,
+            `Results appear as activity notifications. When board context is injected below, use the real identifiers and titles you see there.`,
+            `The user can also type commands directly: "issues" (list), "todo <title>" (create), "done <ID>" (close).`,
+            `Do NOT use AGENT_REQUEST for task board operations — use BOARD_ACTION instead.`,
+            ``,
+            `## Projects`,
+            `Every task should belong to a project. When creating a task, always include the "project" field.`,
+            `Omitting "project" marks the item as an **urgent escalation** — it triggers a phone call to the user. Only do this for genuine emergencies.`,
+            ``,
+            `**When to create a new project:** If ${name} starts discussing a new domain, initiative, or workstream that doesn't fit existing projects, proactively suggest creating one. Use "create_project" with a short uppercase prefix (2-4 chars).`,
+            `**When to reuse:** If the work fits an existing project's scope, use that project's id.`,
+            `**Triage project:** Use "triage" for items that need categorization but aren't urgent.`,
+            ``,
+            `## Board rules (CRITICAL)`,
+            `- NEVER mark a coding task "done" unless an agent ACTUALLY completed the work and you saw success confirmation. Talking about it is not doing it.`,
+            `- Recurring/continuous tasks (grooming, reviews, maintenance) stay open permanently — NEVER mark them done.`,
+            `- To do coding work on a board item: spawn an AGENT_REQUEST first. Only mark "done" AFTER the agent succeeds.`,
+            ``,
+            `### Backlog vs ideas — two-tier system`,
+            `The board has TWO uses:`,
+            `1. **Backlog** = spec'd, ready-to-build work. Every backlog item MUST have: a concrete deliverable, which files/modules are involved, and acceptance criteria. If an item is in the backlog, an agent should be able to pick it up and build it.`,
+            `2. **Ideas/needs-spec** = vague concepts that need refinement. When you encounter a vague idea (e.g. "Rules Engine", "Skills Library"), create a board item titled "Spec: [topic]" with description of what needs to be decided. Do NOT put unspec'd ideas directly in the backlog.`,
+            ``,
+            `When grooming: review vague items, break them into spec'd work, and move the spec'd pieces to backlog. The goal is a backlog where every item is actionable by an agent. After grooming, commit changes to the queue in a single batch.`,
+            `When ${name} asks to work the backlog: only spawn agents for items that have real specs. For unspec'd items, ask ${name} for direction or propose a spec yourself.`,
+            `NEVER spawn an agent for a task that is already In Progress or already has an assignee. Check the board state carefully before spawning.`,
+            ``,
+            `## Viewing board items (BOARD_VIEW)`,
+            `When the user asks to SEE board items (e.g. "show the backlog", "what's in progress?", "list issues"), emit a [BOARD_VIEW] block.`,
+            `This renders issues as interactive cards in the UI — much better than plain text lists.`,
+            `BOARD_VIEW is for READING. BOARD_ACTION is for WRITING (create/done/comment). Never mix them.`,
+            ``,
+            `Format:`,
+            `[BOARD_VIEW]`,
+            `{"filter": "all"}`,
+            `[/BOARD_VIEW]`,
+            ``,
+            `Supported filters:`,
+            `- {"filter": "all"} — show all issues (default, up to 30)`,
+            `- {"stateType": "started"} — filter by state type: "icebox", "triage", "backlog", "unstarted", "started", "completed", "cancelled"`,
+            `- {"identifiers": ["DASH-1", "DASH-3"]} — show specific issues by identifier`,
+            ``,
+            `You may include brief conversational text alongside the block. The block itself is stripped from visible output and replaced with cards.`,
+        ].join("\n");
+    },
+    async execute(payload, ctx) {
+        const req = payload;
+        const board = getBoardProvider();
+        if (!board || !board.isAvailable()) {
+            return { capabilityId: "board", ok: false, message: "No board provider available" };
+        }
+        // ── Create issue ─────────────────────────────────────────────────────
+        if (req.action === "create" && req.title) {
+            try {
+                const issue = await board.createIssue(req.title, {
+                    description: req.description,
+                    project: req.project,
+                    origin: mapOrigin(ctx.origin),
+                    originSessionId: ctx.sessionId,
+                });
+                if (issue)
+                    return boardResult(true, `Created ${issue.identifier}: ${issue.title}`, ctx, issue.url);
+            }
+            catch { }
+            return boardResult(false, `Failed to create issue: ${req.title}`, ctx);
+        }
+        // ── Mark done ────────────────────────────────────────────────────────
+        if (req.action === "done" && req.identifier) {
+            try {
+                const found = await findIssueOrFail(board, req.identifier, ctx);
+                if (isFailure(found))
+                    return found;
+                const teamPrefix = req.identifier.split("-")[0];
+                const teams = await board.getTeams();
+                const team = teams?.find((t) => t.key === teamPrefix);
+                if (!team)
+                    return boardResult(false, `Team not found for: ${req.identifier}`, ctx);
+                const doneStateId = await board.getDoneStateId(team.id);
+                if (!doneStateId)
+                    return boardResult(false, `No Done state for team ${team.name}`, ctx);
+                const updated = await board.updateIssue(found.id, { stateId: doneStateId });
+                if (updated)
+                    return boardResult(true, `Closed ${req.identifier}: ${updated.title}`, ctx);
+            }
+            catch { }
+            return boardResult(false, `Failed to close ${req.identifier}`, ctx);
+        }
+        // ── Comment ──────────────────────────────────────────────────────────
+        if (req.action === "comment" && req.identifier && req.body) {
+            try {
+                const found = await findIssueOrFail(board, req.identifier, ctx);
+                if (isFailure(found))
+                    return found;
+                // If author is specified, route to exchange tracking (queue store)
+                const queueStore = board.getStore?.();
+                if (req.author && queueStore) {
+                    const ex = await queueStore.addExchange(found.id, {
+                        author: req.author,
+                        body: req.body,
+                        source: req.exchangeSource ?? "external",
+                    });
+                    const msg = ex ? `Exchange on ${req.identifier} from ${req.author}` : `Failed to add exchange on ${req.identifier}`;
+                    return boardResult(!!ex, msg, ctx);
+                }
+                const ok = await board.addComment(found.id, req.body);
+                return boardResult(ok, ok ? `Commented on ${req.identifier}` : `Failed to comment on ${req.identifier}`, ctx);
+            }
+            catch { }
+            return boardResult(false, `Failed to comment on ${req.identifier}`, ctx);
+        }
+        // ── Create project ───────────────────────────────────────────────────
+        if (req.action === "create_project" && req.name && req.prefix) {
+            try {
+                const projectStore = board.getProjectStore?.();
+                if (!projectStore)
+                    return boardResult(false, "No project store available", ctx);
+                const project = await projectStore.create({ name: req.name, prefix: req.prefix, description: req.description });
+                return boardResult(true, `Created project: ${project.name} (${project.prefix})`, ctx);
+            }
+            catch (err) {
+                return boardResult(false, `Failed to create project "${req.name}": ${err.message}`, ctx);
+            }
+        }
+        // ── View (read-only) ────────────────────────────────────────────────
+        if (req.action === "view") {
+            try {
+                let issues = null;
+                if (req.identifiers && Array.isArray(req.identifiers)) {
+                    const found = [];
+                    for (const ident of req.identifiers) {
+                        const issue = await board.findByIdentifier(ident);
+                        if (issue)
+                            found.push(issue);
+                    }
+                    issues = found;
+                }
+                else if (req.stateType) {
+                    issues = await board.listIssues({ stateType: req.stateType });
+                }
+                else {
+                    // Default: exclude done/cancelled so active items aren't crowded out
+                    issues = await board.listIssues({});
+                    if (issues) {
+                        issues = issues.filter((i) => !["Done", "Cancelled", "Icebox"].includes(i.state));
+                    }
+                }
+                // Cap results to prevent oversized payloads
+                if (issues && issues.length > 50) {
+                    issues = issues.slice(0, 50);
+                }
+                return { capabilityId: "board", ok: true, message: `Found ${issues?.length ?? 0} issues`, data: issues ?? [] };
+            }
+            catch {
+                return { capabilityId: "board", ok: false, message: "Failed to fetch board issues" };
+            }
+        }
+        return { capabilityId: "board", ok: false, message: "Unknown or incomplete board action" };
+    },
+};
+//# sourceMappingURL=board.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Browser capability — navigate, click, type, screenshot, extract, scroll
+ * via Stagehand (AI-powered) + Playwright (deterministic).
+ *
+ * Pattern: action-block
+ * Tag:     BROWSER_ACTION
+ *
+ * The LLM emits [BROWSER_ACTION]{...}[/BROWSER_ACTION] blocks.
+ * Each block specifies an `action` plus action-specific fields.
+ *
+ * Session management: Playwright browser contexts are persisted per-domain
+ * as encrypted storageState JSON in brain/browser/sessions/ with 7-day expiry.
+ */
+import type { ActionBlockCapability } from "../types.js";
+/** Shut down the browser (called on server teardown). */
+export declare function closeBrowser(): Promise<void>;
+export declare const browserCapability: ActionBlockCapability;
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/capabilities/definitions/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,qBAAqB,EAAwC,MAAM,aAAa,CAAC;AA4B/F,yDAAyD;AACzD,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAMlD;AAwID,eAAO,MAAM,iBAAiB,EAAE,qBAqG/B,CAAC"}

package/dist/capabilities/definitions/browser.js

@@ -0,0 +1,242 @@
+/**
+ * Browser capability — navigate, click, type, screenshot, extract, scroll
+ * via Stagehand (AI-powered) + Playwright (deterministic).
+ *
+ * Pattern: action-block
+ * Tag:     BROWSER_ACTION
+ *
+ * The LLM emits [BROWSER_ACTION]{...}[/BROWSER_ACTION] blocks.
+ * Each block specifies an `action` plus action-specific fields.
+ *
+ * Session management: Playwright browser contexts are persisted per-domain
+ * as encrypted storageState JSON in brain/browser/sessions/ with 7-day expiry.
+ */
+import { Stagehand } from "@browserbasehq/stagehand";
+import { logActivity } from "../../activity/log.js";
+import { pushNotification } from "../../goals/notifications.js";
+import { createLogger } from "../../utils/logger.js";
+import { saveSession, loadSession, purgeExpiredSessions } from "../../browser/sessions.js";
+const log = createLogger("browser");
+// ── Stagehand lifecycle ──────────────────────────────────────────────────────
+let _stagehand = null;
+/**
+ * Get or create the shared Stagehand instance.
+ * Uses LOCAL env with headless Chromium — no Browserbase dependency.
+ */
+async function getStagehand() {
+    if (_stagehand)
+        return _stagehand;
+    _stagehand = new Stagehand({
+        env: "LOCAL",
+        localBrowserLaunchOptions: { headless: true },
+    });
+    await _stagehand.init();
+    log.info("Stagehand initialized (LOCAL, headless)");
+    // Purge expired sessions on first launch
+    purgeExpiredSessions().catch(() => { });
+    return _stagehand;
+}
+/** Shut down the browser (called on server teardown). */
+export async function closeBrowser() {
+    if (_stagehand) {
+        await _stagehand.close();
+        _stagehand = null;
+        log.info("Stagehand closed");
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function domainFromUrl(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return "unknown";
+    }
+}
+const actionLabel = (ctx) => ctx.origin === "autonomous" ? "AUTONOMOUS" : "PROMPTED";
+// ── Action handlers ──────────────────────────────────────────────────────────
+async function handleNavigate(req, ctx) {
+    const url = req.url;
+    if (!url)
+        return { capabilityId: "browser", ok: false, message: "Missing required field: url" };
+    const stagehand = await getStagehand();
+    const domain = domainFromUrl(url);
+    // Restore session if available
+    const stored = await loadSession(domain);
+    if (stored) {
+        try {
+            await stagehand.context.addCookies(stored.cookies ?? []);
+            log.info(`Restored session for ${domain}`);
+        }
+        catch (err) {
+            log.warn(`Failed to restore session for ${domain}`, { error: String(err) });
+        }
+    }
+    const page = stagehand.context.pages()[0];
+    await page.goto(url, { waitUntil: "domcontentloaded", timeoutMs: 30_000 });
+    logActivity({ source: "browse", summary: `Navigated to ${url}`, actionLabel: actionLabel(ctx), reason: `browser navigate` });
+    return { capabilityId: "browser", ok: true, message: `Navigated to ${url}` };
+}
+async function handleClick(req, ctx) {
+    const instruction = req.instruction ?? req.selector;
+    if (!instruction)
+        return { capabilityId: "browser", ok: false, message: "Missing required field: instruction or selector" };
+    const stagehand = await getStagehand();
+    const result = await stagehand.act(`click ${instruction}`);
+    logActivity({ source: "browse", summary: `Clicked: ${instruction}`, actionLabel: actionLabel(ctx), reason: `browser click` });
+    return { capabilityId: "browser", ok: result.success, message: result.message ?? `Clicked: ${instruction}` };
+}
+async function handleType(req, ctx) {
+    const instruction = req.instruction;
+    const text = req.text;
+    const selector = req.selector;
+    if (!text)
+        return { capabilityId: "browser", ok: false, message: "Missing required field: text" };
+    const stagehand = await getStagehand();
+    const actInstruction = instruction
+        ?? (selector ? `type "${text}" into ${selector}` : `type "${text}" into the focused field`);
+    const result = await stagehand.act(actInstruction);
+    logActivity({ source: "browse", summary: `Typed into field`, actionLabel: actionLabel(ctx), reason: `browser type` });
+    return { capabilityId: "browser", ok: result.success, message: result.message ?? `Typed text` };
+}
+async function handleScreenshot(_req, ctx) {
+    const stagehand = await getStagehand();
+    const page = stagehand.context.pages()[0];
+    const buffer = await page.screenshot({ type: "png", fullPage: false });
+    const base64 = buffer.toString("base64");
+    logActivity({ source: "browse", summary: `Took screenshot`, actionLabel: actionLabel(ctx), reason: `browser screenshot` });
+    return {
+        capabilityId: "browser",
+        ok: true,
+        message: "Screenshot captured",
+        data: { base64, mimeType: "image/png" },
+    };
+}
+async function handleExtract(req, ctx) {
+    const instruction = req.instruction;
+    const stagehand = await getStagehand();
+    let extracted;
+    if (instruction) {
+        extracted = await stagehand.extract(instruction);
+    }
+    else {
+        extracted = await stagehand.extract();
+    }
+    logActivity({ source: "browse", summary: `Extracted content from page`, actionLabel: actionLabel(ctx), reason: `browser extract` });
+    return {
+        capabilityId: "browser",
+        ok: true,
+        message: "Content extracted",
+        data: extracted,
+    };
+}
+async function handleScroll(req, ctx) {
+    const direction = req.direction ?? "down";
+    const stagehand = await getStagehand();
+    const result = await stagehand.act(`scroll ${direction}`);
+    logActivity({ source: "browse", summary: `Scrolled ${direction}`, actionLabel: actionLabel(ctx), reason: `browser scroll` });
+    return { capabilityId: "browser", ok: result.success, message: result.message ?? `Scrolled ${direction}` };
+}
+// ── Capability definition ────────────────────────────────────────────────────
+export const browserCapability = {
+    id: "browser",
+    pattern: "action",
+    tag: "BROWSER_ACTION",
+    keywords: ["browse", "browser", "website", "webpage", "click", "screenshot", "scrape", "navigate", "open page", "web page"],
+    getPromptInstructions(ctx) {
+        const name = ctx.name ?? "the user";
+        return [
+            `## Browser (via [BROWSER_ACTION] blocks)`,
+            `To interact with web pages, include a [BROWSER_ACTION] block in your response.`,
+            ``,
+            `Navigate to a URL:`,
+            `[BROWSER_ACTION]`,
+            `{"action": "navigate", "url": "https://example.com"}`,
+            `[/BROWSER_ACTION]`,
+            ``,
+            `Click an element (natural language):`,
+            `[BROWSER_ACTION]`,
+            `{"action": "click", "instruction": "the Sign In button"}`,
+            `[/BROWSER_ACTION]`,
+            ``,
+            `Type text into a field:`,
+            `[BROWSER_ACTION]`,
+            `{"action": "type", "text": "hello world", "instruction": "the search input"}`,
+            `[/BROWSER_ACTION]`,
+            ``,
+            `Take a screenshot of the current page:`,
+            `[BROWSER_ACTION]`,
+            `{"action": "screenshot"}`,
+            `[/BROWSER_ACTION]`,
+            ``,
+            `Extract content from the page:`,
+            `[BROWSER_ACTION]`,
+            `{"action": "extract", "instruction": "the main article text and author"}`,
+            `[/BROWSER_ACTION]`,
+            ``,
+            `Scroll the page:`,
+            `[BROWSER_ACTION]`,
+            `{"action": "scroll", "direction": "down"}`,
+            `[/BROWSER_ACTION]`,
+            ``,
+            `Actions: navigate, click, type, screenshot, extract, scroll.`,
+            `Sessions are persisted per domain — cookies and login state carry across requests.`,
+            `Navigate, extract, screenshot, and scroll without confirmation — just do it and mention what you did. Confirm with ${name} before submitting forms (click on submit buttons, form POSTs).`,
+        ].join("\n");
+    },
+    getPromptOverride(origin) {
+        if (origin === "autonomous") {
+            return [
+                `## Browser (via [BROWSER_ACTION] blocks)`,
+                `Navigate: {"action": "navigate", "url": "https://..."}`,
+                `Click:    {"action": "click", "instruction": "the button text"}`,
+                `Type:     {"action": "type", "text": "value", "instruction": "the input field"}`,
+                `Screenshot: {"action": "screenshot"}`,
+                `Extract:  {"action": "extract", "instruction": "what to extract"}`,
+                `Scroll:   {"action": "scroll", "direction": "down|up"}`,
+                `Wrap each in [BROWSER_ACTION]...[/BROWSER_ACTION].`,
+            ].join("\n");
+        }
+        return null;
+    },
+    async execute(payload, ctx) {
+        const req = payload;
+        const action = req.action;
+        try {
+            switch (action) {
+                case "navigate": return await handleNavigate(req, ctx);
+                case "click": return await handleClick(req, ctx);
+                case "type": return await handleType(req, ctx);
+                case "screenshot": return await handleScreenshot(req, ctx);
+                case "extract": return await handleExtract(req, ctx);
+                case "scroll": return await handleScroll(req, ctx);
+                default:
+                    return { capabilityId: "browser", ok: false, message: `Unknown browser action: ${action}` };
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log.warn(`Browser action "${action}" failed`, { error: msg });
+            pushNotification({ timestamp: new Date().toISOString(), source: "browse", message: `Browser action failed: ${msg}` });
+            return { capabilityId: "browser", ok: false, message: msg };
+        }
+        finally {
+            // Persist session after navigate (cookies may have changed)
+            try {
+                const stagehand = _stagehand;
+                if (stagehand && action === "navigate") {
+                    const url = req.url;
+                    if (url) {
+                        const domain = domainFromUrl(url);
+                        const cookies = await stagehand.context.cookies();
+                        await saveSession(domain, { cookies });
+                    }
+                }
+            }
+            catch {
+                // Non-critical — session save failure shouldn't break the action
+            }
+        }
+    },
+};
+//# sourceMappingURL=browser.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Calendar context provider — injects today's schedule into the LLM prompt
+ * when the user mentions calendar-related keywords.
+ * Reads from the local CalendarStore (works offline, no Google dependency).
+ */
+import type { ContextProviderCapability } from "../types.js";
+export declare const calendarContextProvider: ContextProviderCapability;
+//# sourceMappingURL=calendar-context.d.ts.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * Calendar context provider — injects today's schedule into the LLM prompt
+ * when the user mentions calendar-related keywords.
+ * Reads from the local CalendarStore (works offline, no Google dependency).
+ */
+import { getCalendarStore } from "../../calendar/store.js";
+export const calendarContextProvider = {
+    id: "calendar-context",
+    pattern: "context",
+    keywords: ["schedule", "calendar", "event", "meeting", "agenda", "free", "busy", "available", "when am i"],
+    getPromptInstructions(_ctx) {
+        return ""; // Context providers inject data, not prompt instructions
+    },
+    shouldInject(message) {
+        const store = getCalendarStore();
+        if (!store)
+            return false;
+        const keywords = /\b(schedule|calendar|events?|meetings?|agenda|free|busy|available|when am i)\b/i;
+        return keywords.test(message);
+    },
+    async getContext(_message) {
+        const store = getCalendarStore();
+        if (!store)
+            return null;
+        const events = await store.getTodayEvents();
+        if (events.length === 0)
+            return null;
+        const dateLabel = new Date().toLocaleDateString("en-US", { weekday: "long", month: "long", day: "numeric" });
+        const formatted = store.formatEventsForContext(events);
+        return {
+            label: "Today's calendar",
+            content: [
+                `--- Today's calendar (${dateLabel}) ---`,
+                formatted,
+                `--- End calendar ---`,
+                `Use this schedule to answer the user's question about their day, meetings, or availability.`,
+            ].join("\n"),
+        };
+    },
+};
+//# sourceMappingURL=calendar-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-context.js","sourceRoot":"","sources":["../../../src/capabilities/definitions/calendar-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,MAAM,CAAC,MAAM,uBAAuB,GAA8B;IAChE,EAAE,EAAE,kBAAkB;IACtB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC;IAE1G,qBAAqB,CAAC,IAAmB;QACvC,OAAO,EAAE,CAAC,CAAC,yDAAyD;IACtE,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,MAAM,QAAQ,GAAG,iFAAiF,CAAC;QACnG,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAErC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7G,MAAM,SAAS,GAAG,KAAK,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAEvD,OAAO;YACL,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE;gBACP,yBAAyB,SAAS,OAAO;gBACzC,SAAS;gBACT,sBAAsB;gBACtB,6FAA6F;aAC9F,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Calendar capability — create, update, delete events via the local CalendarStore.
+ * Google sync happens in the background via the adapter.
+ */
+import type { ActionBlockCapability } from "../types.js";
+export declare const calendarCapability: ActionBlockCapability;
+//# sourceMappingURL=calendar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/capabilities/definitions/calendar.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,qBAAqB,EAAwC,MAAM,aAAa,CAAC;AAa/F,eAAO,MAAM,kBAAkB,EAAE,qBAkKhC,CAAC"}