@davidjinguoxu/agentcore 0.4.1

package/dist/storage/trigger-engine.js

@@ -0,0 +1,212 @@
+// trigger-engine.ts — How do triggers fire?
+// Checks rules on every appendEvent(). Rules live in ~/.datacore/triggers.json.
+//
+// Review loop: every task_reviewed event MUST set context.verdict to "pass" or "fail"
+// so conditions like context.verdict match (TR-002/TR-003). Canonical TR-001 dispatch
+// body is exported as TR001_REVIEW_DISPATCH_MESSAGE below — keep in sync with
+// packages/triggers/src/trigger-engine.ts DEFAULT_RULES (TR-001).
+// Firings are logged as trigger_fired events. Failure policy: log and continue.
+//
+// IMPORTANT: executeTriggerActions calls appendEvent() directly (same-process).
+// It must NOT use the HTTP API — that path has auth + port-conflict issues.
+// The appendEvent import uses a lazy getter to break the circular dependency
+// (store.ts imports trigger-engine.ts, trigger-engine.ts needs appendEvent).
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { execFile } from "node:child_process";
+let _execFile = execFile;
+export function _setExecFileFn(fn) {
+    _execFile = fn;
+}
+let _appendEvent = async () => { };
+export function _setAppendEventFn(fn) {
+    _appendEvent = fn;
+}
+// TTL cache — re-read triggers.json at most once per minute
+let _cachedRules = null;
+let _cacheTime = 0;
+const CACHE_TTL_MS = 60_000;
+export function _resetRulesCache() {
+    _cachedRules = null;
+    _cacheTime = 0;
+}
+/** TR-001 dispatch message template (sync with packages/triggers/src/trigger-engine.ts TR-001). */
+export const TR001_REVIEW_DISPATCH_MESSAGE = "Task ${context.task_id} completed by ${context.builder}. " +
+    "Commit: ${context.commit_hash}. Summary: ${context.summary}. " +
+    "Procedure: Follow SK-T01 (review-task) — datacore/docs/design/08-skills-system.md Section 4. " +
+    'Read full history with get_tasks(task_id="${context.task_id}") then verify each acceptance criterion. ' +
+    'REQUIRED: call log_event(source="claude-desktop", type="task_reviewed", ' +
+    'content="<task_id> review: <one-line summary>", ' +
+    'context={ task_id: "${context.task_id}", verdict: "pass"|"fail", score: <1-10>, criteria_results: [...], ' +
+    'status: ("rework" if verdict is "fail" else "completed") }). ' +
+    'You MUST include context.verdict as the string "pass" or "fail" (TR-002/TR-003 match on context.verdict). ' +
+    'You MUST set context.status to "rework" when verdict is "fail" and "completed" when verdict is "pass" so the task board reflects review outcome. ' +
+    "Chat-only response will not close the loop.";
+function resolveTriggersPath() {
+    return (process.env.AGENTCORE_TRIGGERS_PATH ?? // primary
+        process.env.DATACORE_TRIGGERS_PATH ?? // legacy alias
+        path.join(os.homedir(), ".agentcore", "triggers.json"));
+}
+// Bundled default rules — used when no user triggers.json exists.
+// Provides the core review loop (TR-001/002/003) and safety nets (TR-006/009)
+// using log_event actions only (no dispatch scripts required).
+function resolveDefaultTriggersPath() {
+    return path.join(path.dirname(fileURLToPath(import.meta.url)), "../../config/default-triggers.json");
+}
+function loadRules() {
+    // Disable triggers in test mode
+    if (process.env.AGENTCORE_TRIGGERS_DISABLED === "true")
+        return [];
+    if (process.env.DATACORE_TRIGGERS_DISABLED === "true")
+        return []; // legacy alias
+    const now = Date.now();
+    if (_cachedRules !== null && now - _cacheTime < CACHE_TTL_MS)
+        return _cachedRules;
+    // Try user config first, fall back to bundled defaults
+    const candidates = [resolveTriggersPath(), resolveDefaultTriggersPath()];
+    for (const p of candidates) {
+        try {
+            const raw = fs.readFileSync(p, "utf8");
+            const config = JSON.parse(raw);
+            _cachedRules = config.rules.filter((r) => r.enabled);
+            _cacheTime = now;
+            return _cachedRules;
+        }
+        catch {
+            continue;
+        }
+    }
+    return [];
+}
+function matchesCondition(rule, record) {
+    const cond = rule.condition;
+    if (cond.event_type && record.type !== cond.event_type)
+        return false;
+    const ctx = (record.context ?? {});
+    for (const [key, expected] of Object.entries(cond)) {
+        if (key === "event_type")
+            continue;
+        if (key.startsWith("context.")) {
+            const field = key.slice(8);
+            if (ctx[field] !== expected)
+                return false;
+        }
+    }
+    return true;
+}
+function interpolate(template, record) {
+    const ctx = (record.context ?? {});
+    return template.replace(/\$\{context\.(\w+)\}/g, (_, field) => {
+        return String(ctx[field] ?? "");
+    });
+}
+export function checkTriggers(record) {
+    // Guard: never trigger on trigger_fired events (prevents infinite loops)
+    if (record.type === "trigger_fired")
+        return [];
+    const rules = loadRules();
+    const matches = [];
+    for (const rule of rules) {
+        if (matchesCondition(rule, record)) {
+            const msg = rule.action.message
+                ? interpolate(rule.action.message, record)
+                : "";
+            matches.push({ rule, resolvedMessage: msg });
+        }
+    }
+    return matches;
+}
+async function logTriggerFired(rule, record, result, detail) {
+    try {
+        // Use direct appendEvent (injected by store.ts) — NOT the HTTP API.
+        // The HTTP path has auth requirements and port-conflict risks. Direct call is safe.
+        await _appendEvent({
+            source: "datacore",
+            type: "trigger_fired",
+            content: `${rule.rule_id} ${result}: ${rule.name} — ${detail}`,
+            context: {
+                rule_id: rule.rule_id,
+                rule_name: rule.name,
+                triggered_by_event: record._event_id,
+                triggered_by_type: record.type,
+                action_type: rule.action.type,
+                result,
+            },
+        });
+    }
+    catch {
+        process.stderr.write(`[trigger] Failed to log trigger_fired for ${rule.rule_id}\n`);
+    }
+}
+function findDispatchScript() {
+    // Primary: resolve relative to this source file's location.
+    // trigger-engine.ts lives at engine/src/storage/  (compiled: engine/dist/storage/)
+    // dispatch-to.sh lives at scripts/dispatch-to.sh  (3 levels up from dist/storage/)
+    const __dir = path.dirname(fileURLToPath(import.meta.url));
+    const fromSourceFile = path.resolve(__dir, "..", "..", "..", "scripts", "dispatch-to.sh");
+    if (fs.existsSync(fromSourceFile))
+        return fromSourceFile;
+    // Fallback: cwd-relative (works when invoked from repo root)
+    const fromCwd = path.join(process.cwd(), "scripts", "dispatch-to.sh");
+    if (fs.existsSync(fromCwd))
+        return fromCwd;
+    return null;
+}
+export async function executeTriggerActions(matches, record) {
+    const dispatchScript = findDispatchScript();
+    for (const { rule, resolvedMessage } of matches) {
+        try {
+            const action = rule.action;
+            if (action.type === "dispatch" && action.target && dispatchScript) {
+                const resolvedTarget = interpolate(action.target, record).trim();
+                if (!resolvedTarget) {
+                    await logTriggerFired(rule, record, "failed", "Dispatch skipped: target empty after interpolation (check context.assigned_to, etc.)");
+                }
+                else {
+                    // Use execFile with args array — no shell interpolation, no injection risk
+                    _execFile(dispatchScript, [resolvedTarget, resolvedMessage], { timeout: 30000 }, () => { });
+                    await logTriggerFired(rule, record, "success", `Dispatched to ${resolvedTarget}: ${resolvedMessage.slice(0, 100)}`);
+                }
+            }
+            else if (action.type === "dispatch_multi" && dispatchScript) {
+                const ctx = (record.context ?? {});
+                const targets = Array.isArray(ctx.respond_by)
+                    ? ctx.respond_by
+                    : [];
+                for (const target of targets) {
+                    _execFile(dispatchScript, [target, resolvedMessage], { timeout: 30000 }, () => { });
+                }
+                await logTriggerFired(rule, record, "success", `Dispatched to ${targets.length} agents: ${targets.join(", ")}`);
+            }
+            else if (action.type === "log_event" && action.event) {
+                const evt = action.event;
+                const interpolatedContext = evt.context
+                    ? Object.fromEntries(Object.entries(evt.context).map(([k, v]) => [
+                        k,
+                        typeof v === "string" ? interpolate(v, record) : v,
+                    ]))
+                    : { triggered_by: rule.rule_id, ...(record.context ?? {}) };
+                // Use direct appendEvent — same reason as logTriggerFired above.
+                await _appendEvent({
+                    source: String(evt.source ?? "datacore"),
+                    type: interpolate(String(evt.type ?? "trigger_action"), record),
+                    content: interpolate(String(evt.content ?? ""), record),
+                    context: interpolatedContext,
+                });
+                await logTriggerFired(rule, record, "success", `Logged event: ${evt.type}`);
+            }
+            else if (action.type === "notify") {
+                process.stderr.write(`[trigger] ${rule.rule_id}: ${resolvedMessage}\n`);
+                await logTriggerFired(rule, record, "success", resolvedMessage);
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[trigger] ${rule.rule_id} FAILED: ${msg}\n`);
+            await logTriggerFired(rule, record, "failed", msg);
+        }
+    }
+}
+//# sourceMappingURL=trigger-engine.js.map

package/dist/storage/trigger-engine.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyBzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAohBrD"}

package/dist/tools.js

@@ -0,0 +1,413 @@
+// tools.ts — What can agents do?
+import { z } from "zod";
+import { appendEvent, getBronzeDir } from "./storage/store.js";
+import { searchEvents } from "./search/search.js";
+import { getTasks } from "./domain/tasks.js";
+import { deepSearch } from "./search/deep-search.js";
+import { upsertEntity, queryEntities, getGoldDir, getLinkedEntities, } from "./domain/gold-store.js";
+import { getQuestions } from "./domain/questions.js";
+import { buildWarmStartPreamble } from "./domain/warm-start.js";
+import { registerSkills } from "./skills/index.js";
+import { bronzeWriteAck, goldUpsertAck } from "./mcp-slim-ack.js";
+function toTextResult(text, structuredContent) {
+    return {
+        content: [{ type: "text", text }],
+        ...(structuredContent !== undefined
+            ? { structuredContent: structuredContent }
+            : {}),
+    };
+}
+export function registerTools(server) {
+    // ─── log_event ─────────────────────────────────────────────
+    server.tool("log_event", "Append a raw event to the Bronze layer in Azure Cosmos DB.", {
+        source: z.string().min(1),
+        type: z.string().min(1),
+        content: z.string().min(1),
+        project: z.string().min(1).optional(),
+        context: z.record(z.string(), z.unknown()).optional(),
+    }, {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    }, async ({ source, type, content, project, context }) => {
+        const logged = await appendEvent({
+            source,
+            type,
+            content,
+            project,
+            context,
+        });
+        return toTextResult(`Logged ${type} from ${source} to ${logged.filePath}`, bronzeWriteAck(logged.record));
+    });
+    // ─── search ───────────────────────────────────────────────
+    server.tool("search", "Search collected Bronze events using case-insensitive full-text matching.", {
+        query: z.string().min(1),
+        max_results: z.number().int().min(1).max(100).optional(),
+        source: z.string().optional().describe("Filter by source"),
+        type: z.string().optional().describe("Filter by event type"),
+    }, {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    }, async ({ query, max_results: maxResults, source, type }) => {
+        const result = await searchEvents({ query, maxResults, source, type });
+        if (result.results.length === 0) {
+            const filters = [source && `source=${source}`, type && `type=${type}`]
+                .filter(Boolean)
+                .join(", ");
+            const filterNote = filters ? ` (filters: ${filters})` : "";
+            return toTextResult(`No events matched "${query}"${filterNote} in ${result.bronzeDir}`, result);
+        }
+        const summary = result.results
+            .map((match, index) => {
+            const timestamp = match.timestamp ?? "?";
+            const src = match.source ?? "?";
+            const typ = match.type ?? "?";
+            return `${index + 1}. [${src}/${typ}] ${timestamp} ${match.snippet}`;
+        })
+            .join("\n");
+        return toTextResult(`Found ${result.results.length} match(es) for "${query}" in ${getBronzeDir()}\n${summary}`, result);
+    });
+    // ─── get_tasks ─────────────────────────────────────────────
+    server.tool("get_tasks", "Query task board from Bronze events.", {
+        status: z
+            .enum(["active", "completed", "failed", "rework", "all"])
+            .optional(),
+        assigned_to: z.string().optional(),
+        task_type: z.string().optional(),
+        task_id: z.string().optional(),
+        limit: z.number().int().min(1).max(50).optional(),
+    }, {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    }, async ({ status, assigned_to, task_type, task_id, limit }) => {
+        const result = await getTasks({
+            status,
+            assigned_to,
+            task_type,
+            task_id,
+            limit,
+        });
+        if (result.mode === "history") {
+            const { events, totalEvents } = result;
+            if (events.length === 0) {
+                return toTextResult(`No task events found for task_id "${task_id}"`, result);
+            }
+            const timeline = events
+                .map((ev, i) => {
+                const ts = ev.timestamp ?? "?";
+                const src = ev.source ?? "?";
+                return `${i + 1}. [${ev.type}] ${ts} by ${src}\n   ${ev.content}`;
+            })
+                .join("\n\n");
+            const created = events[0];
+            const ctx = created.context ?? {};
+            const contextSummary = [
+                ctx.problem && `Problem: ${ctx.problem}`,
+                ctx.impact && `Impact: ${ctx.impact}`,
+                ctx.project && `Project: ${ctx.project}`,
+                ctx.assigned_to && `Assigned to: ${ctx.assigned_to}`,
+            ]
+                .filter(Boolean)
+                .join("\n");
+            return toTextResult(`Task ${task_id} — ${totalEvents} events\n\n` +
+                (contextSummary ? `--- Context ---\n${contextSummary}\n\n` : "") +
+                `--- Timeline ---\n${timeline}`, result);
+        }
+        // Board mode
+        const { tasks, total_tasks } = result;
+        if (tasks.length === 0) {
+            return toTextResult(`No ${status ?? "active"} tasks found`, result);
+        }
+        const board = tasks
+            .map((t) => {
+            const parts = [
+                `[${t.task_id}] ${t.status.toUpperCase()}`,
+                t.assigned_to ? `→ ${t.assigned_to}` : "→ unassigned",
+                t.task_type ? `(${t.task_type})` : "",
+            ];
+            const header = parts.filter(Boolean).join(" ");
+            const lines = [header];
+            if (t.summary)
+                lines.push(`  Summary: ${t.summary.slice(0, 200)}`);
+            if (t.problem)
+                lines.push(`  Why: ${t.problem}`);
+            return lines.join("\n");
+        })
+            .join("\n\n");
+        return toTextResult(`Task Board (${status ?? "active"}) — ${total_tasks} task(s)\n\n${board}`, result);
+    });
+    // ─── deep_search ─────────────────────────────────────────
+    server.tool("deep_search", "Semantic (vector) search over Bronze events — finds by meaning, not keywords. " +
+        "Local mode: LanceDB full-text index. Cloud mode: Azure AI Search (set AZURE_SEARCH_ENDPOINT + AZURE_SEARCH_KEY).", {
+        query: z.string().min(1).describe("Natural language search query"),
+        num_results: z
+            .number()
+            .int()
+            .min(1)
+            .max(20)
+            .optional()
+            .describe("Max results (default 5)"),
+        source: z.string().optional().describe("Filter by source"),
+        type: z.string().optional().describe("Filter by event type"),
+        mode: z
+            .enum(["hybrid", "semantic"])
+            .optional()
+            .describe("'hybrid' (default) = keyword+semantic, 'semantic' = vector only"),
+    }, {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    }, async ({ query, num_results: numResults, source, type, mode }) => {
+        try {
+            const result = await deepSearch({
+                query,
+                numResults,
+                source,
+                type,
+                mode,
+            });
+            if (result.results.length === 0) {
+                return toTextResult(`No semantic matches for "${query}"`, result);
+            }
+            const summary = result.results
+                .map((r, i) => {
+                const ts = r.timestamp ?? "?";
+                const src = r.source ?? "?";
+                const typ = r.type ?? "?";
+                const content = (r.content ?? "").slice(0, 200);
+                return `${i + 1}. [${src}/${typ}] ${ts}\n   ${content}`;
+            })
+                .join("\n\n");
+            return toTextResult(`Found ${result.totalResults} semantic match(es) for "${query}" (${result.mode} mode)\n\n${summary}`, result);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            if (msg.includes("DATABRICKS_HOST")) {
+                return toTextResult("deep_search not configured. Set DATABRICKS_HOST and DATABRICKS_TOKEN env vars. " +
+                    "Run Databricks notebooks 01 and 02 first.");
+            }
+            return toTextResult(`deep_search error: ${msg}`);
+        }
+    });
+    // ─── get_facts ────────────────────────────────────────────
+    server.tool("get_facts", "Query Gold entities — structured facts extracted from Bronze events. " +
+        'Answers "what do we know about X?" rather than fuzzy search.', {
+        entity_type: z
+            .string()
+            .optional()
+            .describe("Filter by entity type: decision, fact, project, tool"),
+        project: z
+            .string()
+            .optional()
+            .describe("Filter by project name (partial match)"),
+        tag: z.string().optional().describe("Filter by tag (partial match)"),
+        query: z
+            .string()
+            .optional()
+            .describe("Keyword search within entity summaries and data"),
+    }, {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    }, async ({ entity_type, project, tag, query }) => {
+        const result = await queryEntities({ entity_type, project, tag, query });
+        if (result.total === 0) {
+            const filters = [
+                entity_type && `type=${entity_type}`,
+                project && `project=${project}`,
+                tag && `tag=${tag}`,
+                query && `query="${query}"`,
+            ]
+                .filter(Boolean)
+                .join(", ");
+            return toTextResult(`No Gold entities found${filters ? ` (${filters})` : ""} in ${getGoldDir()}`, result);
+        }
+        const lines = result.entities
+            .map((e, i) => {
+            const meta = [
+                e.project && `project=${e.project}`,
+                e.tags?.length && `tags=[${e.tags.join(", ")}]`,
+                e.links_to?.length && `links_to=[${e.links_to.join(", ")}]`,
+                e.source_events?.length && `sources=${e.source_events.length}`,
+            ]
+                .filter(Boolean)
+                .join(" ");
+            return `${i + 1}. [${e.entity_type}] ${e.summary}${meta ? `\n   ${meta}` : ""}`;
+        })
+            .join("\n\n");
+        return toTextResult(`Found ${result.total} Gold ${result.total === 1 ? "entity" : "entities"}\n\n${lines}`, result);
+    });
+    // ─── get_linked ─────────────────────────────────────────────
+    server.tool("get_linked", "Traverse the Gold knowledge graph from one entity: outbound links_to targets and inbound linkers (DC-T12).", {
+        entity_id: z
+            .string()
+            .min(1)
+            .describe("Gold entity_id (UUID from add_entity / get_facts structured output)"),
+    }, {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    }, async ({ entity_id }) => {
+        const result = await getLinkedEntities(entity_id);
+        if (!result.entity) {
+            return toTextResult(`No Gold entity with entity_id=${entity_id}`, result);
+        }
+        const e = result.entity;
+        const outLines = result.links_out.map((x) => `  → [${x.entity_type}] ${x.summary} (${x.entity_id})`);
+        const inLines = result.links_in.map((x) => `  ← [${x.entity_type}] ${x.summary} (${x.entity_id})`);
+        const text = [
+            `[${e.entity_type}] ${e.summary}`,
+            `id=${e.entity_id}`,
+            result.links_out.length
+                ? `Outbound (${result.links_out.length}):\n${outLines.join("\n")}`
+                : "Outbound: (none)",
+            result.links_in.length
+                ? `Inbound (${result.links_in.length}):\n${inLines.join("\n")}`
+                : "Inbound: (none)",
+            `Total connections: ${result.total_connections}`,
+        ].join("\n\n");
+        return toTextResult(text, result);
+    });
+    // ─── add_entity ───────────────────────────────────────────
+    server.tool("add_entity", "Create or update a Gold entity (structured fact). " +
+        "Upserts by summary+project — same summary in same project updates rather than duplicates.", {
+        entity_type: z
+            .string()
+            .min(1)
+            .describe("Entity type: decision, fact, project, tool, or custom"),
+        summary: z.string().min(1).describe("One-sentence summary of the entity"),
+        project: z.string().optional().describe("Project this entity belongs to"),
+        tags: z.array(z.string()).optional().describe("Tags for filtering"),
+        links_to: z
+            .array(z.string())
+            .optional()
+            .describe("Other Gold entity_ids this row links to (knowledge graph edges)"),
+        source_events: z
+            .array(z.string())
+            .optional()
+            .describe("Bronze event IDs that inform this entity"),
+        data: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe("Structured entity data"),
+    }, {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    }, async ({ entity_type, summary, project, tags, links_to, source_events, data, }) => {
+        const result = await upsertEntity({
+            entity_type,
+            summary,
+            project,
+            tags,
+            links_to,
+            source_events,
+            data,
+        });
+        return toTextResult(`${result.action === "created" ? "Created" : "Updated"} Gold entity ${result.entity_id} in ${result.file_path}`, goldUpsertAck(result));
+    });
+    // ─── get_questions ────────────────────────────────────────
+    server.tool("get_questions", "Query async questions between AI agents. " +
+        'Agents post questions via log_event(type="question"), others answer via log_event(type="answer"). ' +
+        "Check at session start for pending questions directed to you.", {
+        directed_to: z
+            .string()
+            .optional()
+            .describe('Filter by who the question is directed to (e.g. "claude-desktop")'),
+        status: z
+            .enum(["open", "answered", "all"])
+            .optional()
+            .describe("Filter by status: open (unanswered), answered, or all. Default: open"),
+        task_id: z
+            .string()
+            .optional()
+            .describe("Filter by task_id in question context"),
+        limit: z
+            .number()
+            .optional()
+            .describe("Max results to return. Default: 10"),
+    }, {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    }, async ({ directed_to, status, task_id, limit }) => {
+        const result = await getQuestions({
+            directed_to,
+            status,
+            task_id,
+            limit,
+        });
+        if (result.total === 0) {
+            const filters = [
+                directed_to && `directed_to=${directed_to}`,
+                status && `status=${status}`,
+                task_id && `task_id=${task_id}`,
+            ]
+                .filter(Boolean)
+                .join(", ");
+            return toTextResult(`No questions found${filters ? ` (${filters})` : ""} in ${result.bronzeDir}`, result);
+        }
+        const lines = result.questions
+            .map((q, i) => {
+            const meta = [
+                q.asked_by && `from=${q.asked_by}`,
+                q.directed_to && `to=${q.directed_to}`,
+                q.task_id && `task=${q.task_id}`,
+            ]
+                .filter(Boolean)
+                .join(" ");
+            const statusIcon = q.status === "open" ? "❓" : "✅";
+            let line = `${i + 1}. ${statusIcon} [${q.thread_id}] ${q.question.slice(0, 200)}`;
+            if (meta)
+                line += `\n   ${meta}`;
+            if (q.answer)
+                line += `\n   → ${q.answer.slice(0, 200)}`;
+            return line;
+        })
+            .join("\n\n");
+        return toTextResult(`Found ${result.total} question${result.total === 1 ? "" : "s"}\n\n${lines}`, result);
+    });
+    // ─── warm_start ──────────────────────────────────────────
+    server.tool("warm_start", "Assemble a structured context preamble for a task. " +
+        "Returns layered context: identity (L0), task spec (L1), project gotchas (L2), " +
+        "knowledge graph links (L3), recent completions (L4), retry context (L5), file manifest (L6). " +
+        "Call at session start before working on any task.", {
+        task_id: z.string().min(1).describe("Task ID to assemble context for"),
+        agent: z
+            .string()
+            .min(1)
+            .describe("Agent identity (e.g. codex, cursor, claude-desktop)"),
+        budget_tokens: z
+            .number()
+            .int()
+            .min(1000)
+            .max(32000)
+            .optional()
+            .describe("Max token budget for preamble (default 8000)"),
+    }, {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    }, async ({ task_id, agent, budget_tokens }) => {
+        const result = await buildWarmStartPreamble({
+            task_id,
+            agent,
+            budget_tokens,
+        });
+        return toTextResult(result.preamble, result);
+    });
+    // ─── Higher-level skills (task workflow & knowledge capture) ────────────────
+    registerSkills(server);
+}
+//# sourceMappingURL=tools.js.map