@davidjinguoxu/agentcore 0.4.1

package/dist/transport/http-server.js

@@ -0,0 +1,337 @@
+// http-server.ts — How does the HTTP API work?
+// Runs alongside MCP stdio. Same process, same database, two transports.
+// Uses Node's built-in http module — no express/fastify.
+// Domain logic lives in server/src/domain/ — this file is thin routing only.
+import http from "node:http";
+import crypto from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { appendEvent } from "../storage/store.js";
+import { searchEvents } from "../search/search.js";
+import { getTasks } from "../domain/tasks.js";
+import { queryEntities, upsertEntity, getLinkedEntities, } from "../domain/gold-store.js";
+import { getQuestions } from "../domain/questions.js";
+import { deepSearch } from "../search/deep-search.js";
+import { buildInbox } from "../domain/inbox.js";
+import { buildStatus } from "../domain/office-status.js";
+import { buildWarmStartPreamble } from "../domain/warm-start.js";
+import { isCosmosEnabled, pingCosmos } from "../storage/cosmos-client.js";
+import { registerTools } from "../tools.js";
+import { getApiKey, getHttpPort, getMcpServerPackageVersion, } from "../config/datacore-constants.js";
+const startTime = Date.now();
+const API_KEY_HEADER = "x-api-key";
+const NO_AUTH_PATHS = new Set(["/health", "/ready"]);
+const sessions = new Map();
+function resolveApiKey() {
+    const key = process.env["MCP_API_KEY"];
+    if (key)
+        return key;
+    if (process.env["NODE_ENV"] === "production") {
+        throw new Error("MCP_API_KEY must be set in production — refusing to start with no auth.");
+    }
+    // eslint-disable-next-line no-console -- intentional dev-only startup warning
+    console.warn("[WARN] MCP_API_KEY not set — using insecure dev-only fallback. Do not run this configuration in production.");
+    return getApiKey();
+}
+const resolvedApiKey = resolveApiKey();
+function readHeader(req, name) {
+    const value = req.headers[name];
+    if (Array.isArray(value))
+        return value[0];
+    return value;
+}
+function authorize(req, res, skip) {
+    if (skip)
+        return true;
+    const header = readHeader(req, API_KEY_HEADER);
+    if (!header) {
+        err(res, 401, "UNAUTHORIZED", `Missing ${API_KEY_HEADER} header`);
+        return false;
+    }
+    if (header !== resolvedApiKey) {
+        err(res, 401, "UNAUTHORIZED", "Invalid API key");
+        return false;
+    }
+    return true;
+}
+function createMcpServer() {
+    const server = new McpServer({
+        name: "datacore",
+        version: getMcpServerPackageVersion(),
+    });
+    registerTools(server);
+    return server;
+}
+async function handleNewSession(req, res) {
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => crypto.randomUUID(),
+    });
+    const server = createMcpServer();
+    transport.onclose = () => {
+        const sid = transport.sessionId;
+        if (sid)
+            sessions.delete(sid);
+        server
+            .close()
+            .catch((error) => process.stderr.write(`[streamable] Failed to close MCP server: ${String(error)}\n`));
+    };
+    await server.connect(transport);
+    await transport.handleRequest(req, res);
+    const sid = transport.sessionId;
+    if (sid && !sessions.has(sid)) {
+        sessions.set(sid, transport);
+    }
+}
+async function handleStreamableRequest(req, res) {
+    const sessionId = readHeader(req, "mcp-session-id");
+    if (sessionId) {
+        const existing = sessions.get(sessionId);
+        if (existing) {
+            await existing.handleRequest(req, res);
+            if (req.method?.toUpperCase() === "DELETE") {
+                sessions.delete(sessionId);
+            }
+            return;
+        }
+    }
+    try {
+        await handleNewSession(req, res);
+    }
+    catch (error) {
+        console.error("[streamable] Failed to create session:", error); // eslint-disable-line no-console
+        err(res, 500, "SESSION_ERROR", "Failed to create MCP session");
+    }
+}
+function parseBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        req.on("error", reject);
+    });
+}
+function json(res, status, data) {
+    const body = JSON.stringify(data);
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Content-Length": Buffer.byteLength(body),
+        "Access-Control-Allow-Origin": "*",
+    });
+    res.end(body);
+}
+function err(res, status, code, message, extra) {
+    json(res, status, { error: message, code, ...extra });
+}
+async function parseJsonBody(req) {
+    const raw = await parseBody(req);
+    try {
+        return { ok: true, data: JSON.parse(raw) };
+    }
+    catch {
+        return { ok: false, message: "Invalid JSON body" };
+    }
+}
+function parseQuery(url) {
+    const idx = url.indexOf("?");
+    if (idx < 0)
+        return {};
+    const params = {};
+    const search = url.slice(idx + 1);
+    for (const pair of search.split("&")) {
+        const [k, v] = pair.split("=");
+        if (k)
+            params[decodeURIComponent(k)] = decodeURIComponent(v ?? "");
+    }
+    return params;
+}
+function pathname(url) {
+    const idx = url.indexOf("?");
+    return idx < 0 ? url : url.slice(0, idx);
+}
+async function handleRequest(req, res) {
+    const method = req.method ?? "GET";
+    const path = pathname(req.url ?? "/");
+    const query = parseQuery(req.url ?? "/");
+    try {
+        if (method === "OPTIONS") {
+            res.writeHead(204, {
+                "Access-Control-Allow-Origin": "*",
+                "Access-Control-Allow-Methods": "GET, POST, DELETE, OPTIONS",
+                "Access-Control-Allow-Headers": "Content-Type, x-api-key, mcp-session-id",
+            });
+            res.end();
+            return;
+        }
+        if (path === "/health" && method === "GET") {
+            const uptimeSeconds = Math.floor((Date.now() - startTime) / 1000);
+            const backend = isCosmosEnabled() ? "cosmos" : "local";
+            return json(res, 200, {
+                status: "ok",
+                uptime_seconds: uptimeSeconds,
+                version: getMcpServerPackageVersion(),
+                backend,
+            });
+        }
+        if (path === "/ready" && method === "GET") {
+            if (!isCosmosEnabled()) {
+                return json(res, 200, { ready: true, backend: "local" });
+            }
+            try {
+                await pingCosmos();
+                return json(res, 200, { ready: true, backend: "cosmos" });
+            }
+            catch {
+                return json(res, 503, {
+                    ready: false,
+                    error: "Cosmos DB not accessible",
+                });
+            }
+        }
+        const requiresAuth = !NO_AUTH_PATHS.has(path);
+        if (!authorize(req, res, !requiresAuth))
+            return;
+        if (path === "/mcp" &&
+            (method === "POST" || method === "GET" || method === "DELETE")) {
+            await handleStreamableRequest(req, res);
+            return;
+        }
+        if (path === "/log" && method === "POST") {
+            const parsed = await parseJsonBody(req);
+            if (parsed.ok === false)
+                return err(res, 400, "INVALID_JSON", parsed.message);
+            const body = parsed.data;
+            const missing = ["source", "type", "content"].filter((f) => !body[f]);
+            if (missing.length > 0) {
+                return err(res, 400, "MISSING_FIELDS", `Missing required fields: ${missing.join(", ")}`, {
+                    required: missing,
+                });
+            }
+            const result = await appendEvent({
+                source: body.source,
+                type: body.type,
+                content: body.content,
+                context: body.context,
+            });
+            return json(res, 201, {
+                status: "ok",
+                event_id: result.record._event_id,
+                backend: result.bronzeDir,
+            });
+        }
+        if (path === "/search" && method === "GET") {
+            const result = await searchEvents({
+                query: query.q ?? query.query ?? "",
+                maxResults: query.max ? parseInt(query.max, 10) : undefined,
+                source: query.source,
+                type: query.type,
+            });
+            return json(res, 200, result);
+        }
+        if (path === "/tasks" && method === "GET") {
+            const result = await getTasks({
+                status: query.status,
+                assigned_to: query.assigned_to,
+                task_id: query.task_id,
+                task_type: query.task_type,
+                limit: query.limit ? parseInt(query.limit, 10) : undefined,
+            });
+            return json(res, 200, result);
+        }
+        if (path === "/facts" && method === "GET") {
+            const result = await queryEntities({
+                entity_type: query.entity_type,
+                project: query.project,
+                tag: query.tag,
+                query: query.q ?? query.query,
+            });
+            return json(res, 200, result);
+        }
+        if (path === "/facts" && method === "POST") {
+            const parsed = await parseJsonBody(req);
+            if (parsed.ok === false)
+                return err(res, 400, "INVALID_JSON", parsed.message);
+            const result = await upsertEntity(parsed.data);
+            return json(res, 201, result);
+        }
+        if (path === "/linked" && method === "GET") {
+            const id = query.id ?? query.entity_id;
+            if (!id)
+                return err(res, 400, "MISSING_PARAM", "Required: ?id=<entity_id>");
+            const result = await getLinkedEntities(id);
+            if (!result.entity)
+                return err(res, 404, "NOT_FOUND", `No entity with id=${id}`);
+            return json(res, 200, result);
+        }
+        if (path === "/questions" && method === "GET") {
+            const result = await getQuestions({
+                directed_to: query.directed_to,
+                status: query.status,
+                task_id: query.task_id,
+                limit: query.limit ? parseInt(query.limit, 10) : undefined,
+            });
+            return json(res, 200, result);
+        }
+        if (path === "/search/deep" && method === "POST") {
+            const parsed = await parseJsonBody(req);
+            if (parsed.ok === false)
+                return err(res, 400, "INVALID_JSON", parsed.message);
+            const result = await deepSearch(parsed.data);
+            return json(res, 200, result);
+        }
+        // --- Virtual Office endpoints (domain logic in domain/) ---
+        if (path === "/inbox" && method === "GET") {
+            const agent = query.agent;
+            if (!agent)
+                return err(res, 400, "MISSING_PARAM", "Required: ?agent=<name>");
+            return json(res, 200, await buildInbox(agent));
+        }
+        if (path === "/status" && method === "GET") {
+            return json(res, 200, await buildStatus());
+        }
+        if (path === "/warm-start" && method === "GET") {
+            const task_id = query.task_id ?? query.task;
+            const agent = query.agent;
+            if (!task_id)
+                return err(res, 400, "MISSING_PARAM", "Required: ?task_id=<id>");
+            if (!agent)
+                return err(res, 400, "MISSING_PARAM", "Required: ?agent=<name>");
+            const budget = query.budget ? parseInt(query.budget, 10) : undefined;
+            const result = await buildWarmStartPreamble({
+                task_id,
+                agent,
+                budget_tokens: budget,
+            });
+            return json(res, result.error && result.layers_included.length <= 1 ? 404 : 200, result);
+        }
+        return err(res, 404, "NOT_FOUND", "Not found", { path });
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return err(res, 500, "INTERNAL_ERROR", message);
+    }
+}
+export function startHttpServer() {
+    return new Promise((resolve) => {
+        const port = getHttpPort();
+        const server = http.createServer(handleRequest);
+        server.on("error", (err) => {
+            // Silently disable HTTP if port is taken — stdio MCP still works fine
+            if (err.code !== "EADDRINUSE") {
+                process.stderr.write(`[http] HTTP disabled: ${err.code ?? err.message}\n`);
+            }
+            resolve(server);
+        });
+        server.on("close", () => {
+            for (const transport of Array.from(sessions.values())) {
+                transport
+                    .close()
+                    .catch((error) => process.stderr.write(`[streamable] Failed to close transport: ${String(error)}\n`));
+            }
+            sessions.clear();
+        });
+        server.listen(port, () => {
+            resolve(server);
+        });
+    });
+}
+//# sourceMappingURL=http-server.js.map

package/dist/transport/http-server.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,185 @@
+export interface GoldEntity {
+    entity_type: string;
+    entity_id: string;
+    summary: string;
+    project?: string;
+    tags?: string[];
+    /** Outgoing graph edges — other Gold entity_ids this row links to (DC-T12). */
+    links_to?: string[];
+    source_events?: string[];
+    data?: unknown;
+    created_at: string;
+    updated_at: string;
+}
+export interface AddEntityInput {
+    entity_type: string;
+    summary: string;
+    project?: string;
+    tags?: string[];
+    links_to?: string[];
+    source_events?: string[];
+    data?: unknown;
+}
+export interface AddEntityResult {
+    entity_id: string;
+    file_path: string;
+    action: "created" | "updated";
+}
+export interface GetFactsInput {
+    entity_type?: string;
+    project?: string;
+    tag?: string;
+    query?: string;
+}
+export interface GetFactsResult {
+    entities: GoldEntity[];
+    total: number;
+}
+export interface GetLinkedResult {
+    entity: GoldEntity | null;
+    links_out: GoldEntity[];
+    links_in: GoldEntity[];
+    total_connections: number;
+}
+export type TrustLevel = "verified" | "ai-generated" | "external";
+export interface BronzeRecord {
+    source: string;
+    type: string;
+    content: string;
+    project?: string;
+    context?: Record<string, unknown>;
+    run_id?: string;
+    _timestamp: string;
+    _source: string;
+    _event_id: string;
+    _trust: TrustLevel;
+    _filePath?: string;
+}
+export interface AppendEventInput {
+    source: string;
+    type: string;
+    content: string;
+    project?: string;
+    context?: Record<string, unknown>;
+    run_id?: string;
+}
+export interface AppendEventResult {
+    bronzeDir: string;
+    filePath: string;
+    record: BronzeRecord;
+}
+export interface SearchInput {
+    query: string;
+    maxResults?: number;
+    source?: string;
+    type?: string;
+}
+export interface SearchResult {
+    eventId: string | null;
+    timestamp: string | null;
+    source: string | null;
+    type: string | null;
+    trust: TrustLevel | null;
+    snippet: string;
+    filePath: string;
+}
+export interface SearchOutput {
+    bronzeDir: string;
+    filesScanned: number;
+    eventsScanned: number;
+    parseErrors: number;
+    totalMatches: number;
+    results: SearchResult[];
+    sourceCounts: Record<string, number>;
+    typeCounts: Record<string, number>;
+}
+export interface TaskInput {
+    status?: string;
+    assigned_to?: string;
+    task_type?: string;
+    task_id?: string;
+    limit?: number;
+}
+export interface TaskSummary {
+    task_id: string;
+    status: string;
+    task_type: string | null;
+    assigned_to: string | null;
+    score: unknown;
+    problem: unknown;
+    impact: unknown;
+    project: unknown;
+    workflow_stage: unknown;
+    phase: unknown;
+    depends_on: unknown;
+    pattern: unknown;
+    acceptance: unknown;
+    spec_file: unknown;
+    summary: string | null;
+    latest_update: string | null;
+    latest_type: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+    event_count: number;
+    tags: unknown;
+    lessons: unknown;
+}
+export interface TaskEvent {
+    eventId: string | null;
+    timestamp: string | null;
+    source: string | null;
+    type: string | null;
+    content: string | null;
+    context: Record<string, unknown> | null;
+}
+export interface Filters {
+    source?: string;
+    type?: string;
+    limit?: number;
+}
+export interface ReadAllResult {
+    bronzeDir: string;
+    files: string[];
+    records: BronzeRecord[];
+    parseErrors: number;
+}
+export interface TaskBoardResult {
+    bronzeDir: string;
+    mode: "board";
+    status_filter: string;
+    total_tasks: number;
+    tasks: TaskSummary[];
+    parseErrors: number;
+}
+export interface TaskHistoryResult {
+    bronzeDir: string;
+    mode: "history";
+    task_id: string;
+    events: TaskEvent[];
+    totalEvents: number;
+}
+export type TaskResult = TaskBoardResult | TaskHistoryResult;
+export interface QuestionInput {
+    directed_to?: string;
+    status?: "open" | "answered" | "all";
+    task_id?: string;
+    limit?: number;
+}
+export interface QuestionSummary {
+    thread_id: string;
+    question: string;
+    asked_by: string | null;
+    directed_to: string | null;
+    task_id: string | null;
+    status: "open" | "answered";
+    asked_at: string | null;
+    answered_at: string | null;
+    answer: string | null;
+    answered_by: string | null;
+}
+export interface QuestionResult {
+    bronzeDir: string;
+    total: number;
+    questions: QuestionSummary[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// types.ts — What shapes exist in the system?
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8CAA8C"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@davidjinguoxu/agentcore",
+  "version": "0.4.1",
+  "description": "Local-first AI memory engine for multi-agent workflows — 17-tool MCP server. Zero config (LanceDB) or Azure (Cosmos + AI Search).",
+  "license": "MIT",
+  "author": "David Xu",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "smoke": "node scripts/dev/smoke.mjs",
+    "inspect": "bash scripts/dev/inspect.sh",
+    "format": "npx prettier --write src/ tests/",
+    "format:check": "npx prettier --check src/ tests/",
+    "lint": "npx eslint src/",
+    "pretest": "pnpm run build",
+    "test": "node --test tests/*.test.mjs",
+    "check": "pnpm run format:check && pnpm run lint && pnpm run build && pnpm run test",
+    "migrate:sqlite": "node scripts/migrations/migrate-to-sqlite.mjs",
+    "triggers:check": "node scripts/dev/check-time-triggers.mjs"
+  },
+  "dependencies": {
+    "@azure/cosmos": "^4.9.2",
+    "@lancedb/lancedb": "^0.27.2",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@xenova/transformers": "^2.17.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.5.0",
+    "eslint": "^10.1.0",
+    "prettier": "^3.8.1",
+    "typescript": "5.8",
+    "typescript-eslint": "^8.57.2"
+  },
+  "bin": {
+    "agentcore": "scripts/run-server.mjs"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "config/",
+    "scripts/run-server.mjs",
+    "scripts/stdio-only.mjs",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "ai-memory",
+    "datacore",
+    "lancedb",
+    "semantic-search",
+    "agent",
+    "cursor",
+    "claude"
+  ],
+  "homepage": "https://github.com/david3xu/agentcore"
+}

package/scripts/run-server.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "../dist/server.js";

package/scripts/stdio-only.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import process from 'node:process';
+import { registerTools } from '../dist/tools.js';
+
+const pkgDir = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(pkgDir, '..', 'package.json'), 'utf8'));
+const version = typeof pkg.version === 'string' ? pkg.version : '0.0.0';
+
+const server = new McpServer({ name: 'datacore', version });
+registerTools(server);
+await server.connect(new StdioServerTransport());
+
+async function shutdown() {
+  await server.close().catch(() => {});
+  process.exit(0);
+}
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);