@davidjinguoxu/agentcore 0.4.1

package/dist/domain/warm-start.js

@@ -0,0 +1,225 @@
+// warm-start.ts — How is an agent preamble assembled for dispatch?
+// Assembly only: imports builders + extractors, enforces budget, returns preamble.
+// Builders live in warm-start-builders.ts. Data extraction in warm-start-extractors.ts.
+import { buildL0Identity, buildL1TaskSpec, buildL2ProjectContext, buildL3KnowledgeGraph, buildL4RecentCompletions, buildL5RetryContext, buildL6FileManifest, buildLA_AgentJournal, buildLB_TaskCheckpoint, } from "./warm-start-builders.js";
+import { extractAgentJournal, extractTaskCheckpoint, extractLatestTaskContext, extractTaskCreated, extractRetryInfo, findRelatedEntities, findRecentCompletions, getGotchas, } from "./warm-start-extractors.js";
+// Character-to-token approximation (conservative: 3.5 chars/token)
+const CHARS_PER_TOKEN = 3.5;
+function estimateTokens(text) {
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+function getProfile(agent) {
+    const AGENT_PROFILES = {
+        codex: {
+            budget_chars: 35000,
+            format: "bullets",
+            self_contained: false,
+            include_file_manifest: true,
+            drop_l4_first: false,
+        },
+        cursor: {
+            budget_chars: 35000,
+            format: "bullets",
+            self_contained: false,
+            include_file_manifest: true,
+            drop_l4_first: false,
+        },
+        "claude-desktop": {
+            budget_chars: 17500,
+            format: "prose",
+            self_contained: false,
+            include_file_manifest: false,
+            drop_l4_first: true,
+        },
+        gemini: {
+            budget_chars: 42000,
+            format: "prose",
+            self_contained: true,
+            include_file_manifest: true,
+            drop_l4_first: false,
+        },
+        "gemini-antigravity": {
+            budget_chars: 42000,
+            format: "prose",
+            self_contained: true,
+            include_file_manifest: true,
+            drop_l4_first: false,
+        },
+    };
+    return (AGENT_PROFILES[agent.toLowerCase()] ?? {
+        budget_chars: 35000,
+        format: "bullets",
+        self_contained: false,
+        include_file_manifest: true,
+        drop_l4_first: false,
+    });
+}
+// ─── Main assembly ────────────────────────────────────────────────────────────
+export async function buildWarmStartPreamble(input) {
+    const { task_id, agent } = input;
+    const assembled_at = new Date().toISOString();
+    const profile = getProfile(agent);
+    const budgetChars = profile.budget_chars;
+    const fmt = profile.format;
+    const layersIncluded = [];
+    const layersDropped = [];
+    const sections = [];
+    // ── L0: Identity (always) ───────────────────────────────────
+    const l0 = buildL0Identity(agent, task_id, fmt);
+    sections.push({ layer: "L0", text: l0 });
+    // ── LA: Agent journal ────────────────────────────────────────
+    let agentJournal = null;
+    try {
+        agentJournal = await extractAgentJournal(agent);
+    }
+    catch {
+        /* non-fatal */
+    }
+    if (agentJournal) {
+        sections.push({
+            layer: "LA",
+            text: buildLA_AgentJournal(agentJournal, fmt),
+        });
+    }
+    // ── LB: Task checkpoint (mid-task recovery) ──────────────────
+    let checkpoint = null;
+    try {
+        checkpoint = await extractTaskCheckpoint(task_id);
+    }
+    catch {
+        /* non-fatal */
+    }
+    if (checkpoint) {
+        sections.push({
+            layer: "LB",
+            text: buildLB_TaskCheckpoint(checkpoint, fmt),
+        });
+    }
+    // ── Fetch task spec ──────────────────────────────────────────
+    let taskSpec = null;
+    try {
+        taskSpec =
+            (await extractLatestTaskContext(task_id)) ??
+                (await extractTaskCreated(task_id));
+    }
+    catch {
+        /* non-fatal */
+    }
+    if (!taskSpec) {
+        const fallback = [
+            l0,
+            "",
+            `--- TASK NOT FOUND ---`,
+            `Task ${task_id} not found. Search: datacore search "${task_id}"`,
+            `Proceed with the dispatch message below.`,
+        ].join("\n");
+        return {
+            task_id,
+            agent,
+            preamble: fallback,
+            token_estimate: estimateTokens(fallback),
+            layers_included: ["L0"],
+            layers_dropped: ["L1", "L2", "L3", "L4", "L5", "L6"],
+            assembled_at,
+            error: `task_created event not found for ${task_id}`,
+        };
+    }
+    // ── L1: Task spec ────────────────────────────────────────────
+    sections.push({
+        layer: "L1",
+        text: buildL1TaskSpec(taskSpec.content, taskSpec.acceptanceCriteria, taskSpec.specFile, fmt),
+    });
+    // ── L5: Retry context (before L2 — high priority) ────────────
+    let retryInfo = {
+        isRetry: false,
+        failedCriteria: [],
+        fixInstructions: "",
+    };
+    try {
+        retryInfo = await extractRetryInfo(task_id);
+    }
+    catch {
+        /* non-fatal */
+    }
+    if (retryInfo.isRetry) {
+        const l5 = buildL5RetryContext(retryInfo.failedCriteria, retryInfo.fixInstructions, fmt);
+        if (l5)
+            sections.push({ layer: "L5", text: l5 });
+    }
+    // ── L2: Project context ──────────────────────────────────────
+    const gotchas = getGotchas(taskSpec.project);
+    if (gotchas.length > 0) {
+        sections.push({ layer: "L2", text: buildL2ProjectContext(gotchas, fmt) });
+    }
+    // ── L3: Knowledge graph links ────────────────────────────────
+    try {
+        const related = await findRelatedEntities(task_id, taskSpec.project);
+        if (related.length > 0) {
+            sections.push({
+                layer: "L3",
+                text: buildL3KnowledgeGraph(related, profile.self_contained, fmt),
+            });
+        }
+    }
+    catch {
+        /* non-fatal */
+    }
+    // ── L4: Recent completions ───────────────────────────────────
+    try {
+        const completions = await findRecentCompletions(taskSpec.project);
+        if (completions.length > 0) {
+            sections.push({
+                layer: "L4",
+                text: buildL4RecentCompletions(completions, fmt),
+            });
+        }
+    }
+    catch {
+        /* non-fatal */
+    }
+    // ── L6: File manifest ────────────────────────────────────────
+    if (profile.include_file_manifest && taskSpec.filesChanged.length > 0) {
+        sections.push({
+            layer: "L6",
+            text: buildL6FileManifest(taskSpec.filesChanged, fmt),
+        });
+    }
+    // ── Enforce budget (drop layers in order) ────────────────────
+    const PROTECTED = new Set(["L0", "L1", "L5", "LB"]);
+    const DROP_ORDER = profile.drop_l4_first
+        ? ["L4", "L6", "L3", "LA", "L2"]
+        : ["L4", "L6", "L3", "LA", "L2"];
+    let assembled = sections.map((s) => s.text).join("\n\n");
+    for (const dropLayer of DROP_ORDER) {
+        if (assembled.length <= budgetChars)
+            break;
+        if (PROTECTED.has(dropLayer))
+            continue;
+        const idx = sections.findIndex((s) => s.layer === dropLayer);
+        if (idx !== -1) {
+            sections.splice(idx, 1);
+            layersDropped.push(dropLayer);
+            assembled = sections.map((s) => s.text).join("\n\n");
+        }
+    }
+    if (assembled.length > budgetChars) {
+        assembled = assembled.slice(0, budgetChars - 100);
+        assembled += "\n\n⚠️  Preamble truncated at budget limit.";
+    }
+    const closing = fmt === "bullets"
+        ? `\n=== END PREAMBLE — REMEMBER: log_event(task_completed) + agent_journal_entry required ===`
+        : `\n=== End of warm-start context. Write task_completed + agent_journal_entry before session ends. ===`;
+    assembled += closing;
+    for (const s of sections)
+        layersIncluded.push(s.layer);
+    return {
+        task_id,
+        agent,
+        preamble: assembled,
+        token_estimate: estimateTokens(assembled),
+        layers_included: layersIncluded,
+        layers_dropped: layersDropped,
+        assembled_at,
+    };
+}
+//# sourceMappingURL=warm-start.js.map

package/dist/domain/warm-start.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./types.js";
+export { appendEvent, readAllRecords, getBronzeDir } from "./storage/store.js";
+export { queryEntities, upsertEntity, getLinkedEntities, } from "./domain/gold-store.js";
+export { buildWarmStartPreamble } from "./domain/warm-start.js";
+export { checkTriggers } from "./storage/trigger-engine.js";
+export type { StorageBackend } from "./storage/backend.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// index.ts — Public API for @datacore/engine.
+// Import from here, not from internal paths.
+export * from "./types.js";
+export { appendEvent, readAllRecords, getBronzeDir } from "./storage/store.js";
+export { queryEntities, upsertEntity, getLinkedEntities, } from "./domain/gold-store.js";
+export { buildWarmStartPreamble } from "./domain/warm-start.js";
+export { checkTriggers } from "./storage/trigger-engine.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,6CAA6C;AAE7C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/mcp-slim-ack.d.ts

@@ -0,0 +1,12 @@
+import type { AddEntityResult, BronzeRecord } from "./types.js";
+export declare function bronzeWriteAck(record: BronzeRecord): {
+    status: "ok";
+    event_id: string;
+    type: string;
+};
+export declare function goldUpsertAck(result: AddEntityResult): {
+    status: "ok";
+    entity_id: string;
+    action: AddEntityResult["action"];
+};
+//# sourceMappingURL=mcp-slim-ack.d.ts.map

package/dist/mcp-slim-ack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-slim-ack.d.ts","sourceRoot":"","sources":["../src/mcp-slim-ack.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG;IACpD,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAMA;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG;IACtD,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;CACnC,CAMA"}

package/dist/mcp-slim-ack.js

@@ -0,0 +1,16 @@
+// mcp-slim-ack.ts — Minimal structuredContent for write tools (DC-T23: avoid echoing full records into model context).
+export function bronzeWriteAck(record) {
+    return {
+        status: "ok",
+        event_id: record._event_id,
+        type: record.type,
+    };
+}
+export function goldUpsertAck(result) {
+    return {
+        status: "ok",
+        entity_id: result.entity_id,
+        action: result.action,
+    };
+}
+//# sourceMappingURL=mcp-slim-ack.js.map

package/dist/mcp-slim-ack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-slim-ack.js","sourceRoot":"","sources":["../src/mcp-slim-ack.ts"],"names":[],"mappings":"AAAA,uHAAuH;AAIvH,MAAM,UAAU,cAAc,CAAC,MAAoB;IAKjD,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,MAAM,CAAC,SAAS;QAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAuB;IAKnD,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/routing/capability-registry.d.ts

@@ -0,0 +1,38 @@
+export type CostClass = "free" | "low" | "medium" | "high";
+export type QuotaClass = "unlimited" | "subscription" | "pay-per-use" | "rate-limited";
+export type ReliabilityClass = "high" | "medium" | "experimental";
+export type AgentRole = "planner" | "builder" | "reviewer" | "architect" | "researcher" | "ops" | "director";
+export type TaskStage = "planning" | "implementation" | "review" | "rework" | "validation" | "release";
+export interface SubstrateCapability {
+    agent_id: string;
+    runtime_id?: string;
+    provider?: string;
+    supports_mcp: boolean;
+    supports_hooks: boolean;
+    supports_transcript_export: boolean;
+    supports_isolation: boolean;
+    supports_review_mode: boolean;
+    supports_parallel_subagents: boolean;
+    cost_class: CostClass;
+    quota_class?: QuotaClass;
+    reliability_class?: ReliabilityClass;
+    ideal_roles: AgentRole[];
+    ideal_stages: TaskStage[];
+    type?: string;
+    script?: string;
+    aliases?: string[];
+    notes?: string;
+}
+/** Find substrate by canonical id or alias. */
+export declare function findSubstrate(id: string): SubstrateCapability | null;
+/** All substrates suitable for a given role. */
+export declare function substratesForRole(role: AgentRole): SubstrateCapability[];
+/** All substrates suitable for a given stage. */
+export declare function substratesForStage(stage: TaskStage): SubstrateCapability[];
+/** Substrates at or below the specified cost ceiling. */
+export declare function substratesByCost(maxCost: CostClass): SubstrateCapability[];
+/** All substrates that support MCP (can write back mid-session). */
+export declare function substratesWithMcp(): SubstrateCapability[];
+/** All registered substrates. */
+export declare function allSubstrates(): SubstrateCapability[];
+//# sourceMappingURL=capability-registry.d.ts.map

package/dist/routing/capability-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-registry.d.ts","sourceRoot":"","sources":["../../src/routing/capability-registry.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,cAAc,GACd,aAAa,GACb,cAAc,CAAC;AACnB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;AAClE,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,SAAS,GACT,UAAU,GACV,WAAW,GACX,YAAY,GACZ,KAAK,GACL,UAAU,CAAC;AACf,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,gBAAgB,GAChB,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAElC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,0BAA0B,EAAE,OAAO,CAAC;IACpC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,2BAA2B,EAAE,OAAO,CAAC;IAGrC,UAAU,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IAGrC,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,YAAY,EAAE,SAAS,EAAE,CAAC;IAG1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwBD,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAUpE;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,mBAAmB,EAAE,CAExE;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,mBAAmB,EAAE,CAE1E;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,mBAAmB,EAAE,CAI1E;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,IAAI,mBAAmB,EAAE,CAEzD;AAED,iCAAiC;AACjC,wBAAgB,aAAa,IAAI,mBAAmB,EAAE,CAErD"}

package/dist/routing/capability-registry.js

@@ -0,0 +1,52 @@
+// capability-registry.ts — What execution substrates are available and what can they do?
+// Layer 2: Routing. Wraps providers/registry.json into a typed, queryable registry.
+// The registry is the single source of truth for substrate capabilities.
+// Question answered: "Given a task, which substrates are eligible?"
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+// ─── Registry ─────────────────────────────────────────────────────────────────
+function loadAgentsFile() {
+    const dir = dirname(fileURLToPath(import.meta.url));
+    // providers/registry.json is at repo root — three levels up from engine/dist/routing/
+    const agentsPath = join(dir, "..", "..", "..", "providers", "registry.json");
+    const raw = readFileSync(agentsPath, "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed.agents ?? [];
+}
+let _cached = null;
+function all() {
+    if (!_cached)
+        _cached = loadAgentsFile();
+    return _cached;
+}
+/** Find substrate by canonical id or alias. */
+export function findSubstrate(id) {
+    const normalised = id.toLowerCase();
+    return (all().find((s) => s.agent_id.toLowerCase() === normalised ||
+        s.runtime_id?.toLowerCase() === normalised ||
+        s.aliases?.some((a) => a.toLowerCase() === normalised)) ?? null);
+}
+/** All substrates suitable for a given role. */
+export function substratesForRole(role) {
+    return all().filter((s) => s.ideal_roles.includes(role));
+}
+/** All substrates suitable for a given stage. */
+export function substratesForStage(stage) {
+    return all().filter((s) => s.ideal_stages.includes(stage));
+}
+/** Substrates at or below the specified cost ceiling. */
+export function substratesByCost(maxCost) {
+    const order = ["free", "low", "medium", "high"];
+    const ceiling = order.indexOf(maxCost);
+    return all().filter((s) => order.indexOf(s.cost_class) <= ceiling);
+}
+/** All substrates that support MCP (can write back mid-session). */
+export function substratesWithMcp() {
+    return all().filter((s) => s.supports_mcp);
+}
+/** All registered substrates. */
+export function allSubstrates() {
+    return [...all()];
+}
+//# sourceMappingURL=capability-registry.js.map

package/dist/routing/capability-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-registry.js","sourceRoot":"","sources":["../../src/routing/capability-registry.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,oFAAoF;AACpF,yEAAyE;AACzE,oEAAoE;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA6DzC,iFAAiF;AAEjF,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,sFAAsF;IACtF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IAC7C,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,IAAI,OAAO,GAAiC,IAAI,CAAC;AAEjD,SAAS,GAAG;IACV,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,cAAc,EAAE,CAAC;IACzC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,CACL,GAAG,EAAE,CAAC,IAAI,CACR,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,UAAU;QACvC,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,UAAU;QAC1C,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CACzD,IAAI,IAAI,CACV,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,iBAAiB,CAAC,IAAe;IAC/C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IACjD,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,OAAkB;IACjD,MAAM,KAAK,GAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;AACpB,CAAC"}

package/dist/routing/runtime-target-resolver.d.ts

@@ -0,0 +1,42 @@
+import { type SubstrateCapability, type AgentRole, type TaskStage, type CostClass } from "./capability-registry.js";
+export { substratesForRole, substratesForStage, } from "./capability-registry.js";
+export type ExecutionTarget = {
+    kind: "cli";
+    agent_id: string;
+    script: string;
+} | {
+    kind: "agent_framework";
+    endpoint: string;
+    adapter: string;
+} | {
+    kind: "api";
+    endpoint: string;
+} | {
+    kind: "deterministic";
+    fn: string;
+} | {
+    kind: "unresolvable";
+    reason: string;
+};
+export interface RoutingRequest {
+    task_id: string;
+    preferred_role?: AgentRole;
+    preferred_stage?: TaskStage;
+    max_cost?: CostClass;
+    require_mcp?: boolean;
+    require_review?: boolean;
+    preferred_runtime?: string;
+}
+export interface RoutingDecision {
+    target: ExecutionTarget;
+    substrate?: SubstrateCapability;
+    reason: string;
+    candidates: SubstrateCapability[];
+    fallback_order: string[];
+}
+export declare function resolveTarget(req: RoutingRequest): RoutingDecision;
+/** Resolve the best builder for a task. */
+export declare function resolveBuilder(opts?: Partial<RoutingRequest>): RoutingDecision;
+/** Resolve the best reviewer for a task. */
+export declare function resolveReviewer(opts?: Partial<RoutingRequest>): RoutingDecision;
+//# sourceMappingURL=runtime-target-resolver.d.ts.map

package/dist/routing/runtime-target-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-target-resolver.d.ts","sourceRoot":"","sources":["../../src/routing/runtime-target-resolver.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAIlC,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAgCD,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,eAAe,CAiFlE;AAID,2CAA2C;AAC3C,wBAAgB,cAAc,CAC5B,IAAI,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC7B,eAAe,CAMjB;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAC7B,IAAI,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC7B,eAAe,CAOjB"}

package/dist/routing/runtime-target-resolver.js

@@ -0,0 +1,139 @@
+// runtime-target-resolver.ts — How does Datacore decide which substrate executes a task?
+// Layer 2: Routing. The decision engine between control (what should happen)
+// and execution substrates (who does the work).
+//
+// Resolution order:
+//   1. Explicit override in task context (task.preferred_runtime)
+//   2. Role-fit scoring using capability registry
+//   3. Cost policy (prefer free/low unless override)
+//   4. Reliability class
+//   5. Fallback to default substrate per role
+//
+// When Microsoft Agent Framework is integrated, it registers as a substrate here.
+// No dispatch logic lives here — only the decision.
+import { findSubstrate, substratesByCost, allSubstrates, } from "./capability-registry.js";
+// Re-export registry helpers so callers only need to import from routing/
+export { substratesForRole, substratesForStage, } from "./capability-registry.js";
+// ─── Scoring ─────────────────────────────────────────────────────────────────
+const COST_SCORE = {
+    free: 4,
+    low: 3,
+    medium: 2,
+    high: 1,
+};
+function scoreSubstrate(s, req) {
+    let score = 0;
+    if (req.preferred_role && s.ideal_roles.includes(req.preferred_role))
+        score += 10;
+    if (req.preferred_stage && s.ideal_stages.includes(req.preferred_stage))
+        score += 5;
+    if (req.require_mcp && s.supports_mcp)
+        score += 3;
+    if (req.require_review && s.supports_review_mode)
+        score += 3;
+    score += COST_SCORE[s.cost_class] ?? 1;
+    const reliability = s.reliability_class;
+    if (reliability === "high")
+        score += 2;
+    else if (reliability === "medium")
+        score += 1;
+    return score;
+}
+// ─── Resolver ────────────────────────────────────────────────────────────────
+export function resolveTarget(req) {
+    // 1. Explicit override
+    if (req.preferred_runtime) {
+        const explicit = findSubstrate(req.preferred_runtime);
+        if (explicit?.script) {
+            return {
+                target: {
+                    kind: "cli",
+                    agent_id: explicit.agent_id,
+                    script: explicit.script,
+                },
+                substrate: explicit,
+                reason: `explicit preferred_runtime: ${req.preferred_runtime}`,
+                candidates: [explicit],
+                fallback_order: [],
+            };
+        }
+        return {
+            target: {
+                kind: "unresolvable",
+                reason: `preferred_runtime '${req.preferred_runtime}' not found in registry`,
+            },
+            reason: "explicit runtime not found",
+            candidates: [],
+            fallback_order: [],
+        };
+    }
+    // 2. Build candidate pool
+    let pool = allSubstrates();
+    if (req.preferred_role)
+        pool = pool.filter((s) => s.ideal_roles.includes(req.preferred_role));
+    if (req.preferred_stage)
+        pool = pool.filter((s) => s.ideal_stages.includes(req.preferred_stage));
+    if (req.require_mcp)
+        pool = pool.filter((s) => s.supports_mcp);
+    if (req.require_review)
+        pool = pool.filter((s) => s.supports_review_mode);
+    if (req.max_cost)
+        pool = substratesByCost(req.max_cost).filter((s) => pool.includes(s));
+    if (pool.length === 0) {
+        return {
+            target: {
+                kind: "unresolvable",
+                reason: "no substrate satisfies all constraints",
+            },
+            reason: "no candidates after filtering",
+            candidates: [],
+            fallback_order: [],
+        };
+    }
+    // 3. Score and rank
+    const ranked = pool
+        .map((s) => ({ s, score: scoreSubstrate(s, req) }))
+        .sort((a, b) => b.score - a.score);
+    const winner = ranked[0].s;
+    const fallback = ranked.slice(1).map((r) => r.s.agent_id);
+    if (winner.script) {
+        return {
+            target: { kind: "cli", agent_id: winner.agent_id, script: winner.script },
+            substrate: winner,
+            reason: `scored winner (${ranked[0].score} pts) from ${pool.length} candidates`,
+            candidates: pool,
+            fallback_order: fallback,
+        };
+    }
+    // Substrate exists in registry but has no script — future substrate (e.g. Agent Framework)
+    return {
+        target: {
+            kind: "agent_framework",
+            endpoint: "pending",
+            adapter: winner.agent_id,
+        },
+        substrate: winner,
+        reason: `substrate ${winner.agent_id} registered without CLI script — Agent Framework target`,
+        candidates: pool,
+        fallback_order: fallback,
+    };
+}
+// ─── Convenience helpers ─────────────────────────────────────────────────────
+/** Resolve the best builder for a task. */
+export function resolveBuilder(opts) {
+    return resolveTarget({
+        task_id: opts?.task_id ?? "unknown",
+        preferred_role: "builder",
+        ...opts,
+    });
+}
+/** Resolve the best reviewer for a task. */
+export function resolveReviewer(opts) {
+    return resolveTarget({
+        task_id: opts?.task_id ?? "unknown",
+        preferred_role: "reviewer",
+        require_review: true,
+        ...opts,
+    });
+}
+//# sourceMappingURL=runtime-target-resolver.js.map

package/dist/routing/runtime-target-resolver.js.map

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

package/dist/search/azure-search-client.d.ts

@@ -0,0 +1,53 @@
+export interface AzureSearchConfig {
+    endpoint: string;
+    key: string;
+    indexName: string;
+    openAiEndpoint: string;
+    openAiKey: string;
+    openAiDeployment: string;
+}
+export interface AzureSearchResult {
+    eventId: string | null;
+    timestamp: string | null;
+    source: string | null;
+    type: string | null;
+    content: string | null;
+    score: number;
+}
+export interface AzureSearchOutput {
+    query: string;
+    mode: string;
+    indexName: string;
+    totalResults: number;
+    results: AzureSearchResult[];
+}
+export declare function isAzureSearchEnabled(): boolean;
+export declare function isAzureOpenAIEnabled(): boolean;
+/**
+ * Embed a text string using Azure OpenAI.
+ * Returns a 1536-dim vector (text-embedding-ada-002) or null if not configured.
+ */
+export declare function embedText(text: string): Promise<number[] | null>;
+/**
+ * Index a single Bronze event into Azure AI Search.
+ * Silently skips if Azure Search is not configured.
+ * Skips embedding if Azure OpenAI is not configured (text-only index).
+ */
+export declare function indexEvent(record: {
+    _event_id?: string;
+    source?: string;
+    type?: string;
+    content?: string;
+    _timestamp?: string;
+    context?: unknown;
+}): Promise<void>;
+/**
+ * Run a vector + keyword hybrid search against Azure AI Search.
+ */
+export declare function vectorSearch(query: string, options?: {
+    numResults?: number;
+    source?: string;
+    type?: string;
+    mode?: "hybrid" | "semantic";
+}): Promise<AzureSearchOutput>;
+//# sourceMappingURL=azure-search-client.d.ts.map