@davidjinguoxu/agentcore 0.4.2 → 0.4.4

package/README.md

@@ -1,48 +1,60 @@
-# agentcore
+# @davidjinguoxu/agentcore
 
-> Shared memory and coordination layer for multi-agent AI workflows.
-> MCP server + REST API. Works locally with zero config. Scales to Azure.
+> Local-first AI memory engine for multi-agent workflows.
+> 17-tool MCP server. Zero config (LanceDB) or Azure (Cosmos + AI Search).
 
-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.
+Any AI tool that speaks MCP — Cursor Agent, Gemini CLI, GitHub Copilot, Claude Code —
+connects to this server and gains persistent memory, task coordination, and a shared
+knowledge graph across every session.
 
 ---
 
 ## Quick start
 
 ```bash
-npx agentcore
+npx @davidjinguoxu/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.
+Starts on port 3001. Stores data in `~/.agentcore/` using LanceDB. No account, no API key.
 
 ---
 
 ## Connect your AI tool
 
-Add to your MCP client config (Claude Code, Cursor, Copilot, etc.):
-
+**Cursor Agent** (`~/.cursor/mcp.json`):
 ```json
 {
   "mcpServers": {
-    "datacore": {
+    "agentcore": {
       "command": "npx",
-      "args": ["agentcore"]
+      "args": ["@davidjinguoxu/agentcore"],
+      "env": { "MCP_API_KEY": "your-key" }
     }
   }
 }
 ```
 
-For **Claude Desktop**, add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+**Gemini CLI** (`~/.gemini/settings.json`):
+```json
+{
+  "mcpServers": {
+    "agentcore": {
+      "command": "npx",
+      "args": ["@davidjinguoxu/agentcore"],
+      "env": { "MCP_API_KEY": "your-key" }
+    }
+  }
+}
+```
 
+**GitHub Copilot** (`~/.copilot/mcp-config.json`):
 ```json
 {
   "mcpServers": {
-    "datacore": {
+    "agentcore": {
       "command": "npx",
-      "args": ["agentcore"]
+      "args": ["@davidjinguoxu/agentcore"],
+      "env": { "MCP_API_KEY": "your-key" }
     }
   }
 }
@@ -50,149 +62,95 @@ For **Claude Desktop**, add to `~/Library/Application Support/Claude/claude_desk
 
 ---
 
-## 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 |
+## The 17 tools
 
-### Skills
+Organized in 5 categories:
 
-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:
+| Category | Tools | Layer |
+|---|---|---|
+| Memory | `log_event`, `search`, `deep_search`, `get_questions` | Bronze |
+| Tasks | `start_task`, `update_task`, `complete_task`, `block_task`, `fail_task`, `get_tasks` | Bronze |
+| Knowledge | `add_entity`, `get_facts`, `get_linked` | Gold |
+| Insights | `save_lesson`, `save_decision`, `ask_team` | Bronze→Gold |
+| Context | `warm_start` | All layers |
 
-| 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 |
+Full reference: [docs/TOOLS.md](docs/TOOLS.md)
 
 ---
 
-## Data architecture
-
-Datacore stores everything in a three-layer medallion pattern:
+## Three-layer architecture
 
 ```
-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().
+Bronze  →  raw events (append-only, every AI action)
+Silver  →  vector index (semantic search)
+Gold    →  knowledge graph (permanent curated facts)
 ```
 
----
-
-## Upgrade to Azure (cloud mode)
+Every piece of data starts in Bronze. Content-rich events get indexed in Silver.
+Important facts get promoted to Gold via `add_entity`.
 
-To persist across machines and share memory between a real team,
-set Cosmos DB credentials and the engine switches to cloud mode automatically:
+`warm_start` reads all three layers and assembles a context preamble for the agent.
 
-```bash
-export COSMOS_ENDPOINT="https://your-cosmos.documents.azure.com:443/"
-export COSMOS_KEY="your-key"
-npx agentcore
-```
+Full design: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
 
-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"
-```
+## Storage backends
 
-No code changes. No config file. The engine detects credentials at startup
-and selects the right backend automatically.
+| Mode | Condition | Data location |
+|---|---|---|
+| LanceDB (default) | No `COSMOS_ENDPOINT` | `~/.agentcore/` |
+| Azure Cosmos DB | `COSMOS_ENDPOINT` + `COSMOS_KEY` set | Azure cloud |
+| Azure AI Search | `AZURE_SEARCH_ENDPOINT` + `AZURE_SEARCH_KEY` | Azure (Silver layer) |
 
 ---
 
-## 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:
+## Environment variables
 
 ```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
+AGENTCORE_DATA_DIR=~/.agentcore    # local data directory
+AGENTCORE_PORT=3001                # HTTP port
+MCP_API_KEY=your-key               # auth key for HTTP endpoints
+
+# Cloud (optional)
+COSMOS_ENDPOINT=https://...
+COSMOS_KEY=...
+AZURE_SEARCH_ENDPOINT=https://...
+AZURE_SEARCH_KEY=...
 ```
 
-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',
-});
+```bash
+npm install @davidjinguoxu/agentcore
+```
 
-const { entities } = await queryEntities({ entity_type: 'decision' });
+```typescript
+import { appendEvent, queryEntities } from '@davidjinguoxu/agentcore';
+import type { BronzeRecord, GoldEntity } from '@davidjinguoxu/agentcore/types';
 ```
 
 ---
 
-## License
+## Documentation
 
-MIT
+| Doc | What it covers |
+|---|---|
+| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | Three-layer data model + all type definitions |
+| [SCHEMA.md](docs/SCHEMA.md) | 7 database tables with CREATE TABLE SQL |
+| [MEMORY.md](docs/MEMORY.md) | Hierarchical memory: tiers, time decay, graph traversal |
+| [ACTIVE-SCHEMA.md](docs/ACTIVE-SCHEMA.md) | Each table's lifecycle + concrete use cases |
+| [TOOLS.md](docs/TOOLS.md) | 17 MCP tools: inputs, outputs, database mapping |
+| [SKILLS.md](docs/SKILLS.md) | 4 skill workflows built on top of tools |
+| [MIGRATION.md](docs/MIGRATION.md) | Gap analysis + implementation phases |
 
 ---
 
-*Built by [David Xu](https://github.com/david3xu) · Part of the Datacore project*
+## npm
+
+```
+@davidjinguoxu/agentcore
+https://www.npmjs.com/package/@davidjinguoxu/agentcore
+```

package/dist/config/agentcore-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=agentcore-constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentcore-constants.d.ts","sourceRoot":"","sources":["../../src/config/agentcore-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/agentcore-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=agentcore-constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentcore-constants.js","sourceRoot":"","sources":["../../src/config/agentcore-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/bronze/questions.d.ts

@@ -0,0 +1,3 @@
+import type { QuestionInput, QuestionResult } from "../../models/index.js";
+export declare function getQuestions({ directed_to, status, task_id, limit, }?: QuestionInput): Promise<QuestionResult>;
+//# sourceMappingURL=questions.d.ts.map

package/dist/domain/bronze/questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../../src/domain/bronze/questions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,aAAa,EAEb,cAAc,EACf,MAAM,uBAAuB,CAAC;AAG/B,wBAAsB,YAAY,CAAC,EACjC,WAAW,EACX,MAAe,EACf,OAAO,EACP,KAAU,GACX,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAkE9C"}

package/dist/domain/bronze/questions.js

@@ -0,0 +1,60 @@
+// questions.ts — How do AI agents ask each other questions asynchronously?
+import { readAllRecords } from "../../storage/store.js";
+export async function getQuestions({ directed_to, status = "open", task_id, limit = 10, } = {}) {
+    const { bronzeDir, records } = await readAllRecords({});
+    // Collect all question and answer events
+    const questions = records.filter((r) => r.type === "question");
+    const answers = records.filter((r) => r.type === "answer");
+    // Index answers by thread_id for fast lookup
+    const answerMap = new Map();
+    for (const a of answers) {
+        const tid = a.context?.thread_id;
+        if (tid)
+            answerMap.set(tid, a);
+    }
+    const results = [];
+    for (const q of questions) {
+        const ctx = q.context ?? {};
+        const threadId = ctx.thread_id ?? "";
+        if (!threadId)
+            continue;
+        const answerRecord = answerMap.get(threadId);
+        const isAnswered = !!answerRecord;
+        // Filter by status
+        if (status === "open" && isAnswered)
+            continue;
+        if (status === "answered" && !isAnswered)
+            continue;
+        // Filter by directed_to
+        const directedTo = ctx.directed_to ?? null;
+        if (directed_to && directedTo?.toLowerCase() !== directed_to.toLowerCase())
+            continue;
+        // Filter by task_id
+        const qTaskId = ctx.task_id ?? null;
+        if (task_id && qTaskId !== task_id)
+            continue;
+        const answerCtx = answerRecord
+            ? (answerRecord.context ?? {})
+            : {};
+        results.push({
+            thread_id: threadId,
+            question: q.content ?? "",
+            asked_by: ctx.asked_by ?? q._source ?? null,
+            directed_to: directedTo,
+            task_id: qTaskId,
+            status: isAnswered ? "answered" : "open",
+            asked_at: q._timestamp ?? null,
+            answered_at: answerRecord?._timestamp ?? null,
+            answer: answerRecord?.content ?? null,
+            answered_by: answerCtx.answered_by ?? answerRecord?._source ?? null,
+        });
+    }
+    // Sort newest first
+    results.sort((a, b) => (b.asked_at ?? "").localeCompare(a.asked_at ?? ""));
+    return {
+        bronzeDir,
+        total: results.length,
+        questions: results.slice(0, limit),
+    };
+}
+//# sourceMappingURL=questions.js.map

package/dist/domain/bronze/questions.js.map

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

package/dist/domain/bronze/run-manager.d.ts

@@ -0,0 +1,14 @@
+export interface ActiveRun {
+    run_id: string;
+    task_id: string;
+    started_at: string;
+    agent: string;
+}
+declare const activeRuns: Map<string, ActiveRun>;
+export declare function generateRunId(taskId: string): string;
+export declare function registerActiveRun(run: ActiveRun): ActiveRun;
+export declare function getActiveRun(taskId: string): ActiveRun | undefined;
+export declare function completeActiveRun(taskId: string): ActiveRun | undefined;
+export declare function listActiveRuns(): ActiveRun[];
+export { activeRuns as activeRunsMap };
+//# sourceMappingURL=run-manager.d.ts.map

package/dist/domain/bronze/run-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-manager.d.ts","sourceRoot":"","sources":["../../../src/domain/bronze/run-manager.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,QAAA,MAAM,UAAU,wBAA+B,CAAC;AAEhD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAG3D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAElE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAIvE;AAED,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAE5C;AAED,OAAO,EAAE,UAAU,IAAI,aAAa,EAAE,CAAC"}

package/dist/domain/bronze/run-manager.js

@@ -0,0 +1,25 @@
+import { randomUUID } from "node:crypto";
+const activeRuns = new Map();
+export function generateRunId(taskId) {
+    const trimmed = (taskId ?? "").trim();
+    const safeTaskId = trimmed.length > 0 ? trimmed.replace(/\s+/g, "-") : "task";
+    return `${safeTaskId}-run-${randomUUID()}`;
+}
+export function registerActiveRun(run) {
+    activeRuns.set(run.task_id, run);
+    return run;
+}
+export function getActiveRun(taskId) {
+    return activeRuns.get(taskId);
+}
+export function completeActiveRun(taskId) {
+    const run = activeRuns.get(taskId);
+    if (run)
+        activeRuns.delete(taskId);
+    return run;
+}
+export function listActiveRuns() {
+    return [...activeRuns.values()];
+}
+export { activeRuns as activeRunsMap };
+//# sourceMappingURL=run-manager.js.map

package/dist/domain/bronze/run-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-manager.js","sourceRoot":"","sources":["../../../src/domain/bronze/run-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;AAEhD,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9E,OAAO,GAAG,UAAU,QAAQ,UAAU,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAc;IAC9C,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,GAAG;QAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,OAAO,EAAE,UAAU,IAAI,aAAa,EAAE,CAAC"}

package/dist/domain/bronze/task-event-index.d.ts

@@ -0,0 +1,31 @@
+export interface TaskAssignment {
+    taskId: string;
+    assignedTo: string;
+    timestamp: string;
+    isReview: boolean;
+    source: string | null;
+    content: string | null;
+}
+export interface TaskTimeline {
+    taskId: string;
+    status: string;
+    assignedTo: string | null;
+    latestType: string | null;
+    latestTimestamp: string | null;
+    latestContent: string | null;
+    createdTimestamp: string | null;
+    createdContent: string | null;
+    assignments: TaskAssignment[];
+    reviewAssignments: TaskAssignment[];
+    startedTimestamps: string[];
+    completedTimestamps: string[];
+    reviewedTimestamps: string[];
+    blocked: boolean;
+    contextTimestamps: string[];
+}
+export interface TaskEventIndex {
+    tasks: Map<string, TaskTimeline>;
+    taskContextIds: Set<string>;
+}
+export declare function loadTaskEventIndex(): Promise<TaskEventIndex>;
+//# sourceMappingURL=task-event-index.d.ts.map

package/dist/domain/bronze/task-event-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-event-index.d.ts","sourceRoot":"","sources":["../../../src/domain/bronze/task-event-index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AA8BD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CAsGlE"}

package/dist/domain/bronze/task-event-index.js

@@ -0,0 +1,117 @@
+// task-event-index.ts — Aggregate task-related events for inbox and status views.
+import { readAllRecords } from "../../storage/store.js";
+function ensureTimeline(map, taskId) {
+    let timeline = map.get(taskId);
+    if (!timeline) {
+        timeline = {
+            taskId,
+            status: "unknown",
+            assignedTo: null,
+            latestType: null,
+            latestTimestamp: null,
+            latestContent: null,
+            createdTimestamp: null,
+            createdContent: null,
+            assignments: [],
+            reviewAssignments: [],
+            startedTimestamps: [],
+            completedTimestamps: [],
+            reviewedTimestamps: [],
+            blocked: false,
+            contextTimestamps: [],
+        };
+        map.set(taskId, timeline);
+    }
+    return timeline;
+}
+export async function loadTaskEventIndex() {
+    const { records } = await readAllRecords({ type: "task_" });
+    const tasks = new Map();
+    const taskContextIds = new Set();
+    const sorted = [...records].sort((a, b) => (a._timestamp ?? "").localeCompare(b._timestamp ?? ""));
+    for (const record of sorted) {
+        const context = record.context ?? {};
+        const taskId = typeof context.task_id === "string" ? context.task_id : null;
+        const timestamp = record._timestamp ?? new Date().toISOString();
+        if (record.type === "task_context" && taskId) {
+            taskContextIds.add(taskId);
+        }
+        if (!taskId)
+            continue;
+        const timeline = ensureTimeline(tasks, taskId);
+        timeline.latestType = record.type ?? timeline.latestType;
+        timeline.latestTimestamp = record._timestamp ?? timeline.latestTimestamp;
+        if (record.type === "task_created" && !timeline.createdTimestamp) {
+            timeline.createdTimestamp = timestamp;
+            timeline.createdContent = record.content ?? null;
+            if (timeline.status === "unknown") {
+                timeline.status = "created";
+            }
+        }
+        timeline.latestContent = record.content ?? timeline.latestContent;
+        if (typeof context.status === "string") {
+            timeline.status = context.status;
+        }
+        if (typeof context.assigned_to === "string") {
+            timeline.assignedTo = context.assigned_to;
+        }
+        switch (record.type) {
+            case "task_assigned": {
+                const assignedTo = typeof context.assigned_to === "string" ? context.assigned_to : null;
+                if (assignedTo) {
+                    const assignment = {
+                        taskId,
+                        assignedTo,
+                        timestamp,
+                        isReview: context.review === true,
+                        source: record._source ?? null,
+                        content: record.content ?? null,
+                    };
+                    if (assignment.isReview) {
+                        timeline.reviewAssignments.push(assignment);
+                        timeline.status = "review";
+                    }
+                    else {
+                        timeline.assignments.push(assignment);
+                        if (timeline.status === "unknown")
+                            timeline.status = "assigned";
+                    }
+                }
+                break;
+            }
+            case "task_started":
+            case "task_progress":
+                timeline.startedTimestamps.push(timestamp);
+                timeline.status = "in_progress";
+                break;
+            case "task_blocked":
+                timeline.blocked = true;
+                timeline.status = "blocked";
+                break;
+            case "task_unblocked":
+                timeline.blocked = false;
+                timeline.status = "in_progress";
+                break;
+            case "task_completed":
+                timeline.completedTimestamps.push(timestamp);
+                timeline.status = "completed";
+                break;
+            case "task_failed":
+                timeline.status = "failed";
+                break;
+            case "task_reviewed":
+                timeline.reviewedTimestamps.push(timestamp);
+                if (context.verdict === "fail") {
+                    timeline.status = "rework";
+                }
+                break;
+            case "task_context":
+                timeline.contextTimestamps.push(timestamp);
+                break;
+            default:
+                break;
+        }
+    }
+    return { tasks, taskContextIds };
+}
+//# sourceMappingURL=task-event-index.js.map