@davidjinguoxu/agentcore 0.4.1

package/dist/skills/index.js

@@ -0,0 +1,8 @@
+// index.ts — aggregate skill registration for Datacore MCP server.
+import { registerTaskWorkflowSkills } from "./task-workflow.js";
+import { registerKnowledgeSkills } from "./knowledge.js";
+export function registerSkills(server) {
+    registerTaskWorkflowSkills(server);
+    registerKnowledgeSkills(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAGnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/skills/knowledge.d.ts

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

package/dist/skills/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/skills/knowledge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiG/D"}

package/dist/skills/knowledge.js

@@ -0,0 +1,78 @@
+// knowledge.ts — MCP skills for saving lessons, decisions, and team questions.
+import { z } from "zod";
+import { appendEvent } from "../storage/store.js";
+import { bronzeWriteAck } from "../mcp-slim-ack.js";
+function toTextResult(text, structuredContent) {
+    return {
+        content: [{ type: "text", text }],
+        ...(structuredContent !== undefined
+            ? { structuredContent: structuredContent }
+            : {}),
+    };
+}
+export function registerKnowledgeSkills(server) {
+    const annotations = {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false,
+    };
+    server.tool("save_lesson", "Capture a task-specific lesson learned. Writes insight events with the related task_id.", {
+        agent_id: z
+            .string()
+            .min(1)
+            .describe("Agent identifier writing the lesson (e.g. codex-session)"),
+        task_id: z
+            .string()
+            .min(1)
+            .describe("Task identifier that the lesson applies to"),
+        lesson: z.string().min(1).describe("Lesson learned in plain text"),
+    }, annotations, async ({ agent_id, task_id, lesson }) => {
+        const record = await appendEvent({
+            source: agent_id,
+            type: "insight",
+            content: `${task_id} lessons: ${lesson}`,
+            context: { task_id },
+        });
+        return toTextResult("save_lesson logged insight event", bronzeWriteAck(record.record));
+    });
+    server.tool("save_decision", "Record a decision with rationale. Writes decision events with summary in context.", {
+        agent_id: z
+            .string()
+            .min(1)
+            .describe("Agent identifier recording the decision"),
+        summary: z.string().min(1).describe("Decision summary in one sentence"),
+        rationale: z
+            .string()
+            .min(1)
+            .describe("Supporting rationale explaining the decision"),
+    }, annotations, async ({ agent_id, summary, rationale }) => {
+        const record = await appendEvent({
+            source: agent_id,
+            type: "decision",
+            content: `${summary}. Rationale: ${rationale}`,
+            context: { summary },
+        });
+        return toTextResult("save_decision logged decision event", bronzeWriteAck(record.record));
+    });
+    server.tool("ask_team", "Log a question to the team with a directed recipient. Writes question events with status=open.", {
+        agent_id: z
+            .string()
+            .min(1)
+            .describe("Agent identifier asking the question"),
+        question: z.string().min(1).describe("Question text to log"),
+        directed_to: z
+            .string()
+            .min(1)
+            .describe("Intended recipient agent (e.g. claude-desktop, openclaw)"),
+    }, annotations, async ({ agent_id, question, directed_to }) => {
+        const record = await appendEvent({
+            source: agent_id,
+            type: "question",
+            content: question,
+            context: { directed_to, status: "open" },
+        });
+        return toTextResult("ask_team logged question event", bronzeWriteAck(record.record));
+    });
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/skills/knowledge.js.map

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

package/dist/skills/task-workflow.d.ts

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

package/dist/skills/task-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-workflow.d.ts","sourceRoot":"","sources":["../../src/skills/task-workflow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0FzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuMlE"}

package/dist/skills/task-workflow.js

@@ -0,0 +1,205 @@
+// task-workflow.ts — MCP skill wrappers for consistent task lifecycle logging.
+import { z } from "zod";
+import { appendEvent } from "../storage/store.js";
+import { getTasks } from "../domain/tasks.js";
+import { bronzeWriteAck } from "../mcp-slim-ack.js";
+const LOOP_DETECT_THRESHOLD = 4; // emit task_loop_detected every N progress events
+const COMPACT_THRESHOLD = 8; // emit task_compaction_needed every N progress events
+// ── DC-T8 Tier 1: session buffer (server-side auto-capture) ───────────────
+// Tracks Datacore task lifecycle tool calls per task_id.
+// Flushed as tool_sequence event on complete_task / block_task / fail_task.
+// Module-level map persists for the lifetime of the server process.
+const sessionBuffers = new Map();
+function trackTool(taskId, toolName) {
+    const buf = sessionBuffers.get(taskId) ?? [];
+    buf.push(toolName);
+    sessionBuffers.set(taskId, buf);
+}
+const TOOL_SEQUENCE_MIN = 3; // minimum calls before logging tool_sequence
+async function flushSessionBuffer(agentId, taskId) {
+    const tools = sessionBuffers.get(taskId);
+    if (!tools || tools.length < TOOL_SEQUENCE_MIN) {
+        sessionBuffers.delete(taskId);
+        return;
+    }
+    try {
+        await appendEvent({
+            source: agentId,
+            type: "tool_sequence",
+            content: `${taskId}: ${tools.join(" → ")}. ${tools.length} Datacore tool calls (Tier 1 auto-capture).`,
+            context: {
+                task_id: taskId,
+                tools,
+                tool_count: tools.length,
+                capture_tier: 1,
+                agent: agentId,
+            },
+        });
+    }
+    catch {
+        // Non-fatal — observability must never block the main task event
+    }
+    sessionBuffers.delete(taskId);
+}
+function toTextResult(text, structuredContent) {
+    return {
+        content: [{ type: "text", text }],
+        ...(structuredContent !== undefined
+            ? { structuredContent: structuredContent }
+            : {}),
+    };
+}
+async function writeTaskEvent(options) {
+    const { agentId, taskId, eventType, status, content, extraContext } = options;
+    return appendEvent({
+        source: agentId,
+        type: eventType,
+        content,
+        context: {
+            task_id: taskId,
+            status,
+            ...(extraContext ?? {}),
+        },
+    });
+}
+export function registerTaskWorkflowSkills(server) {
+    const baseAnnotations = {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false,
+    };
+    const baseSchema = {
+        agent_id: z
+            .string()
+            .min(1)
+            .describe("Agent identifier (e.g. claude-desktop, codex-session)"),
+        task_id: z.string().min(1).describe("Task identifier (e.g. DC-T1)"),
+    };
+    server.tool("start_task", "Mark a task as in progress. Writes task_started with enforced status/context fields.", {
+        ...baseSchema,
+        summary: z
+            .string()
+            .min(1)
+            .describe("One-line summary of the work beginning"),
+    }, baseAnnotations, async ({ agent_id, task_id, summary }) => {
+        trackTool(task_id, "start_task");
+        const record = await writeTaskEvent({
+            agentId: agent_id,
+            taskId: task_id,
+            eventType: "task_started",
+            status: "in_progress",
+            content: `${task_id} — ${summary}`,
+            extraContext: { summary },
+        });
+        return toTextResult(`start_task logged task_started for ${task_id} as in_progress`, bronzeWriteAck(record.record));
+    });
+    server.tool("complete_task", "Mark a task as completed. Writes task_completed with proof and status=completed.", {
+        ...baseSchema,
+        proof: z
+            .string()
+            .min(1)
+            .describe("Proof of completion: commands run, artifacts, or summary"),
+    }, baseAnnotations, async ({ agent_id, task_id, proof }) => {
+        trackTool(task_id, "complete_task");
+        await flushSessionBuffer(agent_id, task_id);
+        const record = await writeTaskEvent({
+            agentId: agent_id,
+            taskId: task_id,
+            eventType: "task_completed",
+            status: "completed",
+            content: `${task_id} — ${proof}`,
+            extraContext: { proof },
+        });
+        return toTextResult(`complete_task logged task_completed for ${task_id} as completed`, bronzeWriteAck(record.record));
+    });
+    server.tool("block_task", "Indicate a task is blocked. Writes task_blocked with reason and status=blocked.", {
+        ...baseSchema,
+        reason: z
+            .string()
+            .min(1)
+            .describe("Blocking issue preventing further progress"),
+    }, baseAnnotations, async ({ agent_id, task_id, reason: blockReason }) => {
+        trackTool(task_id, "block_task");
+        await flushSessionBuffer(agent_id, task_id);
+        const record = await writeTaskEvent({
+            agentId: agent_id,
+            taskId: task_id,
+            eventType: "task_blocked",
+            status: "blocked",
+            content: `${task_id} — ${blockReason}`,
+            extraContext: { reason: blockReason },
+        });
+        return toTextResult(`block_task logged task_blocked for ${task_id} as blocked`, bronzeWriteAck(record.record));
+    });
+    server.tool("fail_task", "Record that a task failed. Writes task_failed with status=failed.", {
+        ...baseSchema,
+        reason: z
+            .string()
+            .min(1)
+            .describe("Why the task failed and next steps, if any"),
+    }, baseAnnotations, async ({ agent_id, task_id, reason: failReason }) => {
+        trackTool(task_id, "fail_task");
+        await flushSessionBuffer(agent_id, task_id);
+        const record = await writeTaskEvent({
+            agentId: agent_id,
+            taskId: task_id,
+            eventType: "task_failed",
+            status: "failed",
+            content: `${task_id} — ${failReason}`,
+            extraContext: { reason: failReason },
+        });
+        return toTextResult(`fail_task logged task_failed for ${task_id} as failed`, bronzeWriteAck(record.record));
+    });
+    server.tool("update_task", "Log intermediate progress on a task. Writes task_progress with status=in_progress.", {
+        ...baseSchema,
+        progress: z.string().min(1).describe("Progress update in plain text"),
+    }, baseAnnotations, async ({ agent_id, task_id, progress }) => {
+        trackTool(task_id, "update_task");
+        const record = await writeTaskEvent({
+            agentId: agent_id,
+            taskId: task_id,
+            eventType: "task_progress",
+            status: "in_progress",
+            content: `${task_id} — ${progress}`,
+            extraContext: { progress },
+        });
+        // Count progress events — fire threshold alerts for loop detection and compaction
+        try {
+            const result = await getTasks({ task_id });
+            // getTasks({task_id}) returns TaskHistoryResult with an `events` array
+            const events = "events" in result ? result.events : [];
+            const progressCount = events.filter((e) => e.type === "task_progress").length;
+            if (progressCount > 0 && progressCount % LOOP_DETECT_THRESHOLD === 0) {
+                await appendEvent({
+                    source: "datacore",
+                    type: "task_loop_detected",
+                    content: `${task_id} — ${progressCount} progress events without completion. Possible loop.`,
+                    context: {
+                        task_id,
+                        progress_count: progressCount,
+                        assigned_to: agent_id,
+                    },
+                });
+            }
+            if (progressCount > 0 && progressCount % COMPACT_THRESHOLD === 0) {
+                // session_briefing is appended in store.ts from this row (dedup in buildCompactionSessionBriefingAppendInput).
+                await appendEvent({
+                    source: "datacore",
+                    type: "task_compaction_needed",
+                    content: `${task_id} — ${progressCount} progress events. Context compaction recommended.`,
+                    context: {
+                        task_id,
+                        progress_count: progressCount,
+                        assigned_to: agent_id,
+                    },
+                });
+            }
+        }
+        catch {
+            // Non-fatal: threshold checks are best-effort, don't block the progress log
+        }
+        return toTextResult(`update_task logged task_progress for ${task_id} as in_progress`, bronzeWriteAck(record.record));
+    });
+}
+//# sourceMappingURL=task-workflow.js.map

package/dist/skills/task-workflow.js.map

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

package/dist/storage/active-backend.d.ts

@@ -0,0 +1,4 @@
+import type { StorageBackend } from "./backend.js";
+export type { StorageBackend } from "./backend.js";
+export declare const activeBackend: StorageBackend | null;
+//# sourceMappingURL=active-backend.d.ts.map

package/dist/storage/active-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-backend.d.ts","sourceRoot":"","sources":["../../src/storage/active-backend.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD,eAAO,MAAM,aAAa,EAAE,cAAc,GAAG,IAErB,CAAC"}

package/dist/storage/active-backend.js

@@ -0,0 +1,12 @@
+// active-backend.ts — Selects the active StorageBackend at startup.
+// Cosmos mode (COSMOS_ENDPOINT + COSMOS_KEY set): null — store.ts uses Cosmos directly.
+// Local mode (no Cosmos credentials): LanceDbBackend — zero config, no Azure needed.
+// NOTE: aligns with isCosmosEnabled() in cosmos-client.ts which requires BOTH keys.
+import { LanceDbBackend } from "./lancedb-backend.js";
+// Must match isCosmosEnabled() — requires both endpoint AND key
+const cosmosConfigured = !!(process.env.COSMOS_ENDPOINT && process.env.COSMOS_KEY);
+// Singleton — created once at module load
+export const activeBackend = cosmosConfigured
+    ? null // Cloud mode: Cosmos via store.ts + gold-store.ts directly
+    : new LanceDbBackend(); // Local mode: LanceDB, zero config
+//# sourceMappingURL=active-backend.js.map

package/dist/storage/active-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-backend.js","sourceRoot":"","sources":["../../src/storage/active-backend.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,wFAAwF;AACxF,qFAAqF;AACrF,oFAAoF;AAEpF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKtD,gEAAgE;AAChE,MAAM,gBAAgB,GAAG,CAAC,CAAC,CACzB,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CACtD,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,aAAa,GAA0B,gBAAgB;IAClE,CAAC,CAAC,IAAI,CAAC,2DAA2D;IAClE,CAAC,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC,mCAAmC"}

package/dist/storage/backend.d.ts

@@ -0,0 +1,12 @@
+import type { BronzeRecord, AppendEventInput, AppendEventResult, Filters, ReadAllResult, AddEntityInput, AddEntityResult, GetFactsInput, GetFactsResult, GetLinkedResult } from "../types.js";
+export interface StorageBackend {
+    getBronzeDir(): string;
+    append(input: AppendEventInput): Promise<AppendEventResult>;
+    readAll(filters?: Filters): Promise<ReadAllResult>;
+    search(query: string, project?: string): Promise<BronzeRecord[]>;
+    getGoldDir(): string;
+    upsertEntity(input: AddEntityInput): Promise<AddEntityResult>;
+    queryEntities(input: GetFactsInput): Promise<GetFactsResult>;
+    getLinkedEntities(entity_id: string): Promise<GetLinkedResult>;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/storage/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/storage/backend.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,cAAc;IAE7B,YAAY,IAAI,MAAM,CAAC;IACvB,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5D,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAGjE,UAAU,IAAI,MAAM,CAAC;IACrB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9D,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7D,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE"}

package/dist/storage/backend.js

@@ -0,0 +1,5 @@
+// backend.ts — StorageBackend interface: single contract for local (LanceDB) + cloud (Cosmos).
+// store.ts and gold-store.ts delegate to the active backend.
+// Active backend is selected once at startup based on COSMOS_ENDPOINT env var.
+export {};
+//# sourceMappingURL=backend.js.map

package/dist/storage/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/storage/backend.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,6DAA6D;AAC7D,+EAA+E"}

package/dist/storage/cosmos-client.d.ts

@@ -0,0 +1,6 @@
+import { type Container } from "@azure/cosmos";
+export declare function isCosmosEnabled(): boolean;
+export declare function getBronzeContainer(): Promise<Container>;
+export declare function getGoldContainer(): Promise<Container>;
+export declare function pingCosmos(): Promise<void>;
+//# sourceMappingURL=cosmos-client.d.ts.map

package/dist/storage/cosmos-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosmos-client.d.ts","sourceRoot":"","sources":["../../src/storage/cosmos-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAS7D,wBAAgB,eAAe,IAAI,OAAO,CAKzC;AAcD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,SAAS,CAAC,CAI7D;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC,CAI3D;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAGhD"}

package/dist/storage/cosmos-client.js

@@ -0,0 +1,38 @@
+// cosmos-client.ts — How does the MCP server connect to Cosmos DB?
+// Lazy singleton. Enabled when COSMOS_ENDPOINT + COSMOS_KEY are set
+// AND DATACORE_BRONZE_DIR is not set (BRONZE_DIR = test isolation mode).
+import { CosmosClient } from "@azure/cosmos";
+import { getCosmosDatabaseName, getCosmosBronzeContainerName, getCosmosGoldContainerName, } from "../config/datacore-constants.js";
+let client = null;
+export function isCosmosEnabled() {
+    // DATACORE_BRONZE_DIR is set by tests to force JSONL isolation — never use Cosmos in that case.
+    if (process.env.DATACORE_BRONZE_DIR || process.env.DATACORE_GOLD_DIR)
+        return false;
+    return !!(process.env.COSMOS_ENDPOINT && process.env.COSMOS_KEY);
+}
+function getClient() {
+    if (!client) {
+        const endpoint = process.env.COSMOS_ENDPOINT;
+        const key = process.env.COSMOS_KEY;
+        if (!endpoint || !key) {
+            throw new Error("COSMOS_ENDPOINT and COSMOS_KEY must be set");
+        }
+        client = new CosmosClient({ endpoint, key });
+    }
+    return client;
+}
+export async function getBronzeContainer() {
+    return getClient()
+        .database(getCosmosDatabaseName())
+        .container(getCosmosBronzeContainerName());
+}
+export async function getGoldContainer() {
+    return getClient()
+        .database(getCosmosDatabaseName())
+        .container(getCosmosGoldContainerName());
+}
+export async function pingCosmos() {
+    const db = getClient().database(getCosmosDatabaseName());
+    await db.read();
+}
+//# sourceMappingURL=cosmos-client.js.map

package/dist/storage/cosmos-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosmos-client.js","sourceRoot":"","sources":["../../src/storage/cosmos-client.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,oEAAoE;AACpE,yEAAyE;AAEzE,OAAO,EAAE,YAAY,EAAkB,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AAEzC,IAAI,MAAM,GAAwB,IAAI,CAAC;AAEvC,MAAM,UAAU,eAAe;IAC7B,gGAAgG;IAChG,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAClE,OAAO,KAAK,CAAC;IACf,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,OAAO,SAAS,EAAE;SACf,QAAQ,CAAC,qBAAqB,EAAE,CAAC;SACjC,SAAS,CAAC,4BAA4B,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,OAAO,SAAS,EAAE;SACf,QAAQ,CAAC,qBAAqB,EAAE,CAAC;SACjC,SAAS,CAAC,0BAA0B,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC,QAAQ,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/dist/storage/lancedb-backend.d.ts

@@ -0,0 +1,13 @@
+import type { StorageBackend } from "./backend.js";
+import type { BronzeRecord, AppendEventInput, AppendEventResult, Filters, ReadAllResult, AddEntityInput, AddEntityResult, GetFactsInput, GetFactsResult, GetLinkedResult } from "../types.js";
+export declare class LanceDbBackend implements StorageBackend {
+    getBronzeDir(): string;
+    getGoldDir(): string;
+    append(input: AppendEventInput): Promise<AppendEventResult>;
+    readAll(filters?: Filters): Promise<ReadAllResult>;
+    search(query: string, project?: string): Promise<BronzeRecord[]>;
+    upsertEntity(input: AddEntityInput): Promise<AddEntityResult>;
+    queryEntities(input: GetFactsInput): Promise<GetFactsResult>;
+    getLinkedEntities(entity_id: string): Promise<GetLinkedResult>;
+}
+//# sourceMappingURL=lancedb-backend.d.ts.map

package/dist/storage/lancedb-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lancedb-backend.d.ts","sourceRoot":"","sources":["../../src/storage/lancedb-backend.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,aAAa,EAEb,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,aAAa,CAAC;AAqNrB,qBAAa,cAAe,YAAW,cAAc;IACnD,YAAY,IAAI,MAAM;IAGtB,UAAU,IAAI,MAAM;IAId,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwB3D,OAAO,CAAC,OAAO,GAAE,OAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBtD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwChE,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAoD7D,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA2B5D,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAyBrE"}