@davidjinguoxu/agentcore 0.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Xu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,198 @@
+# agentcore
+
+> Shared memory and coordination layer for multi-agent AI workflows.
+> MCP server + REST API. Works locally with zero config. Scales to Azure.
+
+Any AI tool that speaks MCP — Cursor, Claude Code, Copilot CLI, Codex — connects to
+this server and gains persistent memory, task coordination, and shared knowledge across
+every session.
+
+---
+
+## Quick start
+
+```bash
+npx agentcore
+```
+
+That's it. The server starts on port 3001, stores data locally in `~/.agentcore/` using
+LanceDB, and is immediately available to any MCP client. No account, no API key, no config.
+
+---
+
+## Connect your AI tool
+
+Add to your MCP client config (Claude Code, Cursor, Copilot, etc.):
+
+```json
+{
+  "mcpServers": {
+    "datacore": {
+      "command": "npx",
+      "args": ["agentcore"]
+    }
+  }
+}
+```
+
+For **Claude Desktop**, add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "datacore": {
+      "command": "npx",
+      "args": ["agentcore"]
+    }
+  }
+}
+```
+
+---
+
+## What's included
+
+### 17 MCP tools across 4 categories
+
+**Context**
+| Tool | What it does |
+|---|---|
+| `warm_start` | Assemble full task context: spec, gotchas, knowledge graph, retry history |
+
+**Memory & search**
+| Tool | What it does |
+|---|---|
+| `log_event` | Append any event to the Bronze memory layer |
+| `search` | Full-text search across all events |
+| `deep_search` | Semantic (vector) search — finds by meaning, not keyword |
+| `get_facts` | Query curated Gold entities (decisions, lessons, skills) |
+| `get_linked` | Traverse the knowledge graph from any entity |
+| `add_entity` | Create or update a Gold entity |
+| `get_tasks` | Read the task board |
+| `get_questions` | Read async AI-to-AI questions |
+
+**Task lifecycle**
+| Tool | What it does |
+|---|---|
+| `start_task` | Mark a task in progress |
+| `complete_task` | Mark complete — auto-captures tool sequence |
+| `update_task` | Log progress (loop detection at 4×, compaction at 8×) |
+| `block_task` | Record a blocker |
+| `fail_task` | Record a failure |
+
+**Knowledge**
+| Tool | What it does |
+|---|---|
+| `save_lesson` | Extract a reusable lesson from a task |
+| `save_decision` | Record an architecture decision with rationale |
+| `ask_team` | Post an async question to another agent |
+
+### Skills
+
+Datacore ships with a set of AI-callable skills in `skills/datacore/`. These are
+standalone scripts any agent can invoke as part of completing a task:
+
+| Skill | What it does |
+|---|---|
+| `promote-to-gold.mjs` | Promote Bronze events → curated Gold entities |
+| `backfill-search.mjs` | Index Bronze events into the Silver search layer |
+| `backfill-links.mjs` | Build knowledge graph links between entities |
+| `enrich-memory.mjs` | Enrich session startup context |
+| `export-obsidian.mjs` | Export the knowledge graph to Obsidian markdown |
+
+---
+
+## Data architecture
+
+Datacore stores everything in a three-layer medallion pattern:
+
+```
+Bronze  Append-only event log. Every agent action lands here.
+        Local: LanceDB in ~/.agentcore/   Cloud: Azure Cosmos DB
+
+Silver  Vector-indexed for semantic search.
+        Local: LanceDB full-text index   Cloud: Azure AI Search
+
+Gold    Curated facts — decisions, lessons, skills, agent journals.
+        225+ entities. Queried via get_facts() and get_linked().
+```
+
+---
+
+## Upgrade to Azure (cloud mode)
+
+To persist across machines and share memory between a real team,
+set Cosmos DB credentials and the engine switches to cloud mode automatically:
+
+```bash
+export COSMOS_ENDPOINT="https://your-cosmos.documents.azure.com:443/"
+export COSMOS_KEY="your-key"
+npx agentcore
+```
+
+Optional: add Azure AI Search for semantic search across large event volumes:
+
+```bash
+export AZURE_SEARCH_ENDPOINT="https://your-search.search.windows.net"
+export AZURE_SEARCH_KEY="your-key"
+```
+
+No code changes. No config file. The engine detects credentials at startup
+and selects the right backend automatically.
+
+---
+
+## HTTP API
+
+The engine also exposes a REST API on port 3001 alongside the MCP server.
+Useful for shell scripts, cron jobs, or any tool that can't run MCP:
+
+```bash
+# Log an event
+curl -X POST http://localhost:3001/events \
+  -H "Content-Type: application/json" \
+  -d '{"source":"my-tool","type":"note","content":"built the widget"}'
+
+# Search
+curl "http://localhost:3001/search?q=widget"
+
+# Task board
+curl http://localhost:3001/tasks
+```
+
+Full reference: `API.md` in the datacore repo.
+
+---
+
+## Requirements
+
+- Node.js >= 22
+- No other dependencies for local mode
+
+---
+
+## Use as a library
+
+```typescript
+import { appendEvent, queryEntities } from 'agentcore';
+import type { BronzeRecord, GoldEntity } from 'agentcore/types';
+
+await appendEvent({
+  source: 'my-agent',
+  type: 'task_completed',
+  content: 'Finished building the widget',
+  project: 'my-project',
+});
+
+const { entities } = await queryEntities({ entity_type: 'decision' });
+```
+
+---
+
+## License
+
+MIT
+
+---
+
+*Built by [David Xu](https://github.com/david3xu) · Part of the Datacore project*

package/config/default-triggers.json

@@ -0,0 +1,119 @@
+{
+  "_comment": "Default trigger rules bundled with @datacore/engine. Uses log_event actions only — works standalone without any dispatch scripts. Override by placing triggers.json in ~/.datacore/triggers.json.",
+  "rules": [
+    {
+      "rule_id": "TR-001",
+      "name": "Queue review on task completion",
+      "condition": {
+        "event_type": "task_completed"
+      },
+      "action": {
+        "type": "log_event",
+        "event": {
+          "type": "task_assigned",
+          "source": "datacore",
+          "content": "Review queued for ${context.task_id} — assigned to claude-desktop.",
+          "context": {
+            "task_id": "${context.task_id}",
+            "assigned_to": "claude-desktop",
+            "status": "assigned",
+            "review": true
+          }
+        }
+      },
+      "enabled": true
+    },
+    {
+      "rule_id": "TR-002",
+      "name": "Re-queue task on review failure",
+      "condition": {
+        "event_type": "task_reviewed",
+        "context.verdict": "fail"
+      },
+      "action": {
+        "type": "log_event",
+        "event": {
+          "type": "task_assigned",
+          "source": "datacore",
+          "content": "Retry: ${context.task_id} failed review. Re-assigning to ${context.assigned_to}.",
+          "context": {
+            "task_id": "${context.task_id}",
+            "assigned_to": "${context.assigned_to}",
+            "status": "assigned",
+            "retry": true
+          }
+        }
+      },
+      "enabled": true
+    },
+    {
+      "rule_id": "TR-003",
+      "name": "Queue lesson extraction on review pass",
+      "condition": {
+        "event_type": "task_reviewed",
+        "context.verdict": "pass"
+      },
+      "action": {
+        "type": "log_event",
+        "event": {
+          "type": "task_assigned",
+          "source": "datacore",
+          "content": "Lesson extraction queued for ${context.task_id}.",
+          "context": {
+            "task_id": "${context.task_id}",
+            "assigned_to": "claude-desktop",
+            "status": "assigned",
+            "lesson_extraction": true
+          }
+        }
+      },
+      "enabled": true
+    },
+    {
+      "rule_id": "TR-006",
+      "name": "Loop detection — flag stuck tasks",
+      "condition": {
+        "event_type": "task_loop_detected"
+      },
+      "action": {
+        "type": "log_event",
+        "event": {
+          "type": "task_assigned",
+          "source": "datacore",
+          "content": "Loop detected on ${context.task_id} after ${context.progress_count} progress events. Manual review required.",
+          "context": {
+            "task_id": "${context.task_id}",
+            "assigned_to": "claude-desktop",
+            "status": "assigned",
+            "loop_intervention": true,
+            "progress_count": "${context.progress_count}"
+          }
+        }
+      },
+      "enabled": true
+    },
+    {
+      "rule_id": "TR-009",
+      "name": "Context compaction — flag for briefing",
+      "condition": {
+        "event_type": "task_compaction_needed"
+      },
+      "action": {
+        "type": "log_event",
+        "event": {
+          "type": "task_assigned",
+          "source": "datacore",
+          "content": "Compaction needed for ${context.task_id} — ${context.progress_count} progress events logged.",
+          "context": {
+            "task_id": "${context.task_id}",
+            "assigned_to": "claude-desktop",
+            "status": "assigned",
+            "compaction": true,
+            "progress_count": "${context.progress_count}"
+          }
+        }
+      },
+      "enabled": true
+    }
+  ]
+}

package/dist/adapters/runtime-adapter.d.ts

@@ -0,0 +1,124 @@
+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 AdapterMetadata {
+    runtime_id: string;
+    provider: string;
+    surfaces: 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[];
+}
+export interface NormalizedTask {
+    task_id: string;
+    parent_task_id?: string;
+    project_id: string;
+    title: string;
+    description: string;
+    stage: TaskStage;
+    priority: "low" | "medium" | "high" | "critical";
+    risk_level: "low" | "medium" | "high";
+    required_capabilities: string[];
+    preferred_role: AgentRole;
+    review_required: boolean;
+    worktree_mode: "shared_workspace" | "isolated_worktree" | "sandboxed_runtime";
+    acceptance_criteria: string[];
+    budget_policy?: DispatchPolicy;
+    attachments?: string[];
+    warm_start_ref?: string;
+}
+export interface TaskContext {
+    run_id: string;
+    warm_start?: string;
+    prior_attempts: number;
+    review_findings?: string[];
+    workspace_path?: string;
+}
+export interface DispatchPolicy {
+    max_cost_class?: CostClass;
+    max_retries?: number;
+    require_review?: boolean;
+    require_isolation?: boolean;
+    budget_cap_usd?: number;
+}
+export interface PreflightResult {
+    ok: boolean;
+    runtime_id: string;
+    failure_reason?: "auth_failure" | "quota_failure" | "mcp_unavailable" | "executable_missing" | "policy_denied" | "workspace_unavailable";
+    detail?: string;
+}
+export interface RunHandle {
+    run_id: string;
+    runtime_id: string;
+    task_id: string;
+    started_at: string;
+    workspace_path?: string;
+}
+export interface RunStatus {
+    run_id: string;
+    task_id: string;
+    status: "starting" | "running" | "review" | "done" | "failed" | "cancelled";
+    runtime_id: string;
+    last_heartbeat?: string;
+    model_in_use?: string;
+    artifact_refs: string[];
+}
+export interface CancelResult {
+    run_id: string;
+    reason: "user" | "policy" | "timeout" | "superseded" | "dependency_failure";
+    cancelled_at: string;
+}
+export interface TranscriptRef {
+    ref: string;
+    runtime_id: string;
+    task_id: string;
+    run_id: string;
+    path?: string;
+}
+export interface HealthcheckResult {
+    ok: boolean;
+    executable_found: boolean;
+    config_present: boolean;
+    service_reachable: boolean;
+    mcp_reachable: boolean;
+    log_path_writable: boolean;
+    detail?: string;
+}
+export interface AuthState {
+    authenticated: boolean;
+    account_id?: string;
+    token_expiry?: string;
+    provider_host?: string;
+    interactive_reauth_required: boolean;
+    mcp_auth_issues: string[];
+}
+export interface RuntimeAdapter {
+    readonly runtime_id: string;
+    /** Check auth, quota, MCP, workspace before dispatch. */
+    preflight(task: NormalizedTask, context: TaskContext, policy: DispatchPolicy): Promise<PreflightResult>;
+    /** Launch a run. Returns a handle for status polling. */
+    start(task: NormalizedTask, context: TaskContext): Promise<RunHandle>;
+    /** Current state of a run. */
+    status(task_id: string): Promise<RunStatus>;
+    /** Stop a run intentionally. */
+    cancel(task_id: string, reason: CancelResult["reason"]): Promise<CancelResult>;
+    /** Export transcript or ref pointer for the run. */
+    export_transcript(task_id: string): Promise<TranscriptRef>;
+    /** Is the runtime operational right now? */
+    healthcheck(): Promise<HealthcheckResult>;
+    /** What can this runtime do? (used by router for scoring) */
+    capabilities(): AdapterMetadata;
+    /** Auth + credential readiness. */
+    auth_state(): Promise<AuthState>;
+}
+//# sourceMappingURL=runtime-adapter.d.ts.map

package/dist/adapters/runtime-adapter.d.ts.map

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

package/dist/adapters/runtime-adapter.js

@@ -0,0 +1,5 @@
+// runtime-adapter.ts — What must every provider adapter implement?
+// Self-contained: all adapter-layer types are defined here.
+// Spec: docs/design/DC-T11-adapter-contracts.md §§1-2, §5
+export {};
+//# sourceMappingURL=runtime-adapter.js.map

package/dist/adapters/runtime-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-adapter.js","sourceRoot":"","sources":["../../src/adapters/runtime-adapter.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,4DAA4D;AAC5D,0DAA0D"}

package/dist/config/datacore-constants.d.ts

@@ -0,0 +1,21 @@
+/** Semantic version from this package's package.json (MCP server metadata). */
+export declare function getMcpServerPackageVersion(): string;
+export declare function getCosmosDatabaseName(): string;
+export declare function getCosmosBronzeContainerName(): string;
+export declare function getCosmosGoldContainerName(): string;
+/** Display / API string for the active bronze Cosmos path (not a real URL scheme). */
+export declare function getCosmosBronzeUriString(): string;
+/** Display / API string for the gold Cosmos path. */
+export declare function getCosmosGoldUriString(): string;
+/** HTTP listen port (default 3001). */
+export declare function getHttpPort(): number;
+/** Base URL for HTTP clients. */
+export declare function getHttpBaseUrl(): string;
+/**
+ * Resolved API key for HTTP auth: production callers should set MCP_API_KEY.
+ * In dev, falls back to AGENTCORE_DEV_KEY / DATACORE_HTTP_DEV_FALLBACK_KEY.
+ */
+export declare function getApiKey(): string;
+/** Insecure dev-only API key when MCP_API_KEY is unset (non-production only). */
+export declare function getHttpDevFallbackApiKey(): string;
+//# sourceMappingURL=datacore-constants.d.ts.map

package/dist/config/datacore-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datacore-constants.d.ts","sourceRoot":"","sources":["../../src/config/datacore-constants.ts"],"names":[],"mappings":"AAWA,+EAA+E;AAC/E,wBAAgB,0BAA0B,IAAI,MAAM,CAQnD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAMrD;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAMnD;AAED,sFAAsF;AACtF,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,qDAAqD;AACrD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,uCAAuC;AACvC,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED,iCAAiC;AACjC,wBAAgB,cAAc,IAAI,MAAM,CAMvC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAOlC;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,IAAI,MAAM,CAMjD"}

package/dist/config/datacore-constants.js

@@ -0,0 +1,68 @@
+// agentcore-constants.ts — Single source for package version and Cosmos display URIs.
+// Database / container names are overridable for non-default Cosmos layouts.
+// Env vars: AGENTCORE_* preferred; DATACORE_* accepted as legacy aliases.
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const packageDir = dirname(fileURLToPath(import.meta.url));
+let cachedPackageVersion;
+/** Semantic version from this package's package.json (MCP server metadata). */
+export function getMcpServerPackageVersion() {
+    if (cachedPackageVersion === undefined) {
+        const pkgPath = join(packageDir, "..", "..", "package.json");
+        const raw = readFileSync(pkgPath, "utf8");
+        const pkg = JSON.parse(raw);
+        cachedPackageVersion = pkg.version ?? "0.0.0";
+    }
+    return cachedPackageVersion;
+}
+export function getCosmosDatabaseName() {
+    return (process.env.AGENTCORE_COSMOS_DATABASE ??
+        process.env.DATACORE_COSMOS_DATABASE ??
+        "datacore");
+}
+export function getCosmosBronzeContainerName() {
+    return (process.env.AGENTCORE_COSMOS_BRONZE_CONTAINER ??
+        process.env.DATACORE_COSMOS_BRONZE_CONTAINER ??
+        "bronze");
+}
+export function getCosmosGoldContainerName() {
+    return (process.env.AGENTCORE_COSMOS_GOLD_CONTAINER ??
+        process.env.DATACORE_COSMOS_GOLD_CONTAINER ??
+        "gold");
+}
+/** Display / API string for the active bronze Cosmos path (not a real URL scheme). */
+export function getCosmosBronzeUriString() {
+    return `cosmos://${getCosmosDatabaseName()}/${getCosmosBronzeContainerName()}`;
+}
+/** Display / API string for the gold Cosmos path. */
+export function getCosmosGoldUriString() {
+    return `cosmos://${getCosmosDatabaseName()}/${getCosmosGoldContainerName()}`;
+}
+/** HTTP listen port (default 3001). */
+export function getHttpPort() {
+    return parseInt(process.env.AGENTCORE_PORT ?? process.env.DATACORE_HTTP_PORT ?? "3001", 10);
+}
+/** Base URL for HTTP clients. */
+export function getHttpBaseUrl() {
+    return (process.env.AGENTCORE_BASE_URL ??
+        process.env.DATACORE_HTTP_BASE_URL ??
+        `http://localhost:${getHttpPort()}`);
+}
+/**
+ * Resolved API key for HTTP auth: production callers should set MCP_API_KEY.
+ * In dev, falls back to AGENTCORE_DEV_KEY / DATACORE_HTTP_DEV_FALLBACK_KEY.
+ */
+export function getApiKey() {
+    return (process.env.MCP_API_KEY ??
+        process.env.AGENTCORE_DEV_KEY ??
+        process.env.DATACORE_HTTP_DEV_FALLBACK_KEY ??
+        "dev-key-change-me");
+}
+/** Insecure dev-only API key when MCP_API_KEY is unset (non-production only). */
+export function getHttpDevFallbackApiKey() {
+    return (process.env.AGENTCORE_DEV_KEY ??
+        process.env.DATACORE_HTTP_DEV_FALLBACK_KEY ??
+        "dev-key-change-me");
+}
+//# sourceMappingURL=datacore-constants.js.map

package/dist/config/datacore-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datacore-constants.js","sourceRoot":"","sources":["../../src/config/datacore-constants.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,6EAA6E;AAC7E,0EAA0E;AAE1E,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;AAEzC,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,IAAI,oBAAwC,CAAC;AAE7C,+EAA+E;AAC/E,MAAM,UAAU,0BAA0B;IACxC,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACpD,oBAAoB,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChD,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,yBAAyB;QACrC,OAAO,CAAC,GAAG,CAAC,wBAAwB;QACpC,UAAU,CACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,iCAAiC;QAC7C,OAAO,CAAC,GAAG,CAAC,gCAAgC;QAC5C,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,+BAA+B;QAC3C,OAAO,CAAC,GAAG,CAAC,8BAA8B;QAC1C,MAAM,CACP,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,wBAAwB;IACtC,OAAO,YAAY,qBAAqB,EAAE,IAAI,4BAA4B,EAAE,EAAE,CAAC;AACjF,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,sBAAsB;IACpC,OAAO,YAAY,qBAAqB,EAAE,IAAI,0BAA0B,EAAE,EAAE,CAAC;AAC/E,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,WAAW;IACzB,OAAO,QAAQ,CACb,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM,EACtE,EAAE,CACH,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,cAAc;IAC5B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAC9B,OAAO,CAAC,GAAG,CAAC,sBAAsB;QAClC,oBAAoB,WAAW,EAAE,EAAE,CACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,WAAW;QACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,OAAO,CAAC,GAAG,CAAC,8BAA8B;QAC1C,mBAAmB,CACpB,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,wBAAwB;IACtC,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,OAAO,CAAC,GAAG,CAAC,8BAA8B;QAC1C,mBAAmB,CACpB,CAAC;AACJ,CAAC"}

package/dist/domain/embeddable.d.ts

@@ -0,0 +1,19 @@
+export declare const EMBEDDABLE_TYPES: Set<string>;
+export declare const MIN_CONTENT_LENGTH = 50;
+export declare function shouldEmbed(record: {
+    type?: string;
+    content?: string;
+}): boolean;
+export declare const KNOWN_SOURCES: Set<string>;
+export interface ValidationResult {
+    valid: boolean;
+    reasons: string[];
+}
+export declare function validateForSilver(record: Record<string, unknown>): ValidationResult;
+/**
+ * Extract a compact summary from event content for better Silver embeddings.
+ * Rule-based only — no LLM calls. For content >200 chars: first sentence + key entities.
+ * Returns null for short content (embed as-is).
+ */
+export declare function extractContentSummary(content: string | null | undefined): string | null;
+//# sourceMappingURL=embeddable.d.ts.map

package/dist/domain/embeddable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddable.d.ts","sourceRoot":"","sources":["../../src/domain/embeddable.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,aAsB3B,CAAC;AAEH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAIV;AAGD,eAAO,MAAM,aAAa,aAexB,CAAC;AAKH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB,CAkClB;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,MAAM,GAAG,IAAI,CAoBf"}