@davidjinguoxu/agentcore 0.4.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"azure-search-client.d.ts","sourceRoot":"","sources":["../../src/search/azure-search-client.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C;AA4BD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CA2BtE;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ChB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACzB,GACL,OAAO,CAAC,iBAAiB,CAAC,CA8F5B"}

package/dist/search/azure-search-client.js

@@ -0,0 +1,191 @@
+// azure-search-client.ts — How does Azure AI Search connect?
+// Handles: credential guard, text embedding via Azure OpenAI, event indexing, vector search.
+// Uses raw fetch — no @azure/search-documents SDK dependency.
+// Falls back gracefully: if not configured, callers should use Databricks instead.
+function azureOpenAiEmbeddingsApiVersion() {
+    return process.env.AZURE_OPENAI_EMBEDDINGS_API_VERSION ?? "2024-02-01";
+}
+function azureSearchRestApiVersion() {
+    return process.env.AZURE_SEARCH_API_VERSION ?? "2024-07-01";
+}
+export function isAzureSearchEnabled() {
+    return !!(process.env.AZURE_SEARCH_ENDPOINT && process.env.AZURE_SEARCH_KEY);
+}
+export function isAzureOpenAIEnabled() {
+    return !!(process.env.AZURE_OPENAI_ENDPOINT &&
+        process.env.AZURE_OPENAI_KEY &&
+        process.env.AZURE_OPENAI_EMBEDDING_DEPLOYMENT);
+}
+function getConfig() {
+    const endpoint = process.env.AZURE_SEARCH_ENDPOINT;
+    const key = process.env.AZURE_SEARCH_KEY;
+    const indexName = process.env.AZURE_SEARCH_INDEX ?? "datacore-events";
+    const openAiEndpoint = process.env.AZURE_OPENAI_ENDPOINT ?? "";
+    const openAiKey = process.env.AZURE_OPENAI_KEY ?? "";
+    const openAiDeployment = process.env.AZURE_OPENAI_EMBEDDING_DEPLOYMENT ?? "text-embedding-ada-002";
+    if (!endpoint || !key) {
+        throw new Error("AZURE_SEARCH_ENDPOINT and AZURE_SEARCH_KEY must be set. " +
+            "Get these from: Azure Portal → search-datacore → Keys.");
+    }
+    return {
+        endpoint: endpoint.replace(/\/$/, ""),
+        key,
+        indexName,
+        openAiEndpoint: openAiEndpoint.replace(/\/$/, ""),
+        openAiKey,
+        openAiDeployment,
+    };
+}
+/**
+ * Embed a text string using Azure OpenAI.
+ * Returns a 1536-dim vector (text-embedding-ada-002) or null if not configured.
+ */
+export async function embedText(text) {
+    if (!isAzureOpenAIEnabled())
+        return null;
+    const cfg = getConfig();
+    const url = `${cfg.openAiEndpoint}/openai/deployments/${cfg.openAiDeployment}` +
+        `/embeddings?api-version=${azureOpenAiEmbeddingsApiVersion()}`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "api-key": cfg.openAiKey,
+        },
+        body: JSON.stringify({ input: text.slice(0, 8192) }),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Azure OpenAI embeddings ${response.status}: ${text}`);
+    }
+    const data = (await response.json());
+    return data.data[0]?.embedding ?? null;
+}
+/**
+ * Index a single Bronze event into Azure AI Search.
+ * Silently skips if Azure Search is not configured.
+ * Skips embedding if Azure OpenAI is not configured (text-only index).
+ */
+export async function indexEvent(record) {
+    if (!isAzureSearchEnabled())
+        return;
+    const cfg = getConfig();
+    const id = record._event_id ?? crypto.randomUUID();
+    // Attempt embedding — non-fatal if unavailable
+    let vector = null;
+    try {
+        vector = await embedText(record.content ?? "");
+    }
+    catch {
+        // Embedding failure is non-fatal — index without vector
+    }
+    const doc = {
+        id,
+        content: record.content ?? "",
+        source: record.source ?? "",
+        type: record.type ?? "",
+        timestamp: record._timestamp ?? new Date().toISOString(),
+        context: record.context ? JSON.stringify(record.context) : "",
+    };
+    if (vector !== null) {
+        doc["content_vector"] = vector;
+    }
+    const url = `${cfg.endpoint}/indexes/${cfg.indexName}/docs/index?api-version=${azureSearchRestApiVersion()}`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "api-key": cfg.key,
+        },
+        body: JSON.stringify({
+            value: [{ "@search.action": "mergeOrUpload", ...doc }],
+        }),
+    });
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`Azure AI Search index ${response.status}: ${errText}`);
+    }
+}
+/**
+ * Run a vector + keyword hybrid search against Azure AI Search.
+ */
+export async function vectorSearch(query, options = {}) {
+    const cfg = getConfig();
+    const { numResults = 5, source, type, mode = "hybrid" } = options;
+    // Build $filter expression
+    const filters = [];
+    if (source)
+        filters.push(`source eq '${source.replace(/'/g, "''")}'`);
+    if (type)
+        filters.push(`type eq '${type.replace(/'/g, "''")}'`);
+    // Attempt to get a query vector for hybrid/semantic search
+    let queryVector = null;
+    try {
+        queryVector = await embedText(query);
+    }
+    catch {
+        // Non-fatal — fall back to keyword-only if embedding fails
+    }
+    const body = {
+        search: query,
+        top: Math.min(numResults, 20),
+        select: "id,content,source,type,timestamp",
+        queryType: "simple",
+    };
+    if (filters.length > 0) {
+        body["$filter"] = filters.join(" and ");
+    }
+    // Add vector search if we have an embedding
+    if (queryVector !== null && mode !== "semantic") {
+        body["vectorQueries"] = [
+            {
+                kind: "vector",
+                vector: queryVector,
+                fields: "content_vector",
+                k: Math.min(numResults, 20),
+            },
+        ];
+    }
+    else if (queryVector !== null) {
+        // Semantic-only: vector query only, no keyword
+        body["search"] = undefined;
+        body["vectorQueries"] = [
+            {
+                kind: "vector",
+                vector: queryVector,
+                fields: "content_vector",
+                k: Math.min(numResults, 20),
+            },
+        ];
+    }
+    const url = `${cfg.endpoint}/indexes/${cfg.indexName}/docs/search?api-version=${azureSearchRestApiVersion()}`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "api-key": cfg.key,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`Azure AI Search query ${response.status}: ${errText}`);
+    }
+    const data = (await response.json());
+    const results = data.value.map((doc) => ({
+        eventId: doc.id ?? null,
+        timestamp: doc.timestamp ?? null,
+        source: doc.source ?? null,
+        type: doc.type ?? null,
+        content: doc.content ?? null,
+        score: doc["@search.score"] ?? 0,
+    }));
+    return {
+        query,
+        mode,
+        indexName: cfg.indexName,
+        totalResults: results.length,
+        results,
+    };
+}
+//# sourceMappingURL=azure-search-client.js.map

package/dist/search/azure-search-client.js.map

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

package/dist/search/circuit-breaker.d.ts

@@ -0,0 +1,46 @@
+export declare class CircuitOpenError extends Error {
+    constructor(message: string);
+}
+type State = "CLOSED" | "OPEN" | "HALF_OPEN";
+export interface CircuitBreakerOptions {
+    /** Number of consecutive failures before opening. Default: 3 */
+    failureThreshold?: number;
+    /** Ms to wait in OPEN before allowing a probe. Default: 30_000 */
+    recoveryMs?: number;
+    /** Name for use in error messages. Default: 'circuit' */
+    name?: string;
+}
+export declare class CircuitBreaker {
+    private state;
+    private failures;
+    private openedAt;
+    private readonly failureThreshold;
+    private readonly recoveryMs;
+    private readonly name;
+    constructor(options?: CircuitBreakerOptions);
+    /** Returns current state — exposed for tests and observability. */
+    getState(): State;
+    /**
+     * Ignore a thrown error — undo the failure that call() would otherwise count.
+     * Use for non-retriable errors (e.g. 4xx) that are the caller's fault.
+     * Must be called synchronously from within the catch block of breaker.call().
+     */
+    ignore(): void;
+    /** Returns current failure count — exposed for tests. */
+    getFailures(): number;
+    /**
+     * Execute `fn` through the breaker.
+     * - CLOSED: runs fn normally.
+     * - OPEN: throws CircuitOpenError immediately (no fn call).
+     * - HALF_OPEN: runs fn as a probe; success → CLOSED, failure → OPEN.
+     */
+    call<T>(fn: () => Promise<T>): Promise<T>;
+    /** Record a success: reset failures and close the circuit. */
+    private onSuccess;
+    /** Record a failure: increment count and open if threshold reached. */
+    private onFailure;
+}
+/** Shared singleton for deepSearch — one breaker per process lifetime. */
+export declare const deepSearchBreaker: CircuitBreaker;
+export {};
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/search/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/search/circuit-breaker.ts"],"names":[],"mappings":"AAGA,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,KAAK,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAuB;IAEvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,OAAO,GAAE,qBAA0B;IAM/C,mEAAmE;IACnE,QAAQ,IAAI,KAAK;IAIjB;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAQd,yDAAyD;IACzD,WAAW,IAAI,MAAM;IAIrB;;;;;OAKG;IACG,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsB/C,8DAA8D;IAC9D,OAAO,CAAC,SAAS;IAMjB,uEAAuE;IACvE,OAAO,CAAC,SAAS;CAOlB;AAED,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,gBAI5B,CAAC"}

package/dist/search/circuit-breaker.js

@@ -0,0 +1,87 @@
+// circuit-breaker.ts — Prevents hammering a failing remote API.
+// States: CLOSED (normal) → OPEN (trip) → HALF_OPEN (probe).
+export class CircuitOpenError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CircuitOpenError";
+    }
+}
+export class CircuitBreaker {
+    state = "CLOSED";
+    failures = 0;
+    openedAt = null;
+    failureThreshold;
+    recoveryMs;
+    name;
+    constructor(options = {}) {
+        this.failureThreshold = options.failureThreshold ?? 3;
+        this.recoveryMs = options.recoveryMs ?? 30_000;
+        this.name = options.name ?? "circuit";
+    }
+    /** Returns current state — exposed for tests and observability. */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Ignore a thrown error — undo the failure that call() would otherwise count.
+     * Use for non-retriable errors (e.g. 4xx) that are the caller's fault.
+     * Must be called synchronously from within the catch block of breaker.call().
+     */
+    ignore() {
+        this.failures = Math.max(0, this.failures - 1);
+        if (this.state === "OPEN" && this.failures < this.failureThreshold) {
+            this.state = "CLOSED";
+            this.openedAt = null;
+        }
+    }
+    /** Returns current failure count — exposed for tests. */
+    getFailures() {
+        return this.failures;
+    }
+    /**
+     * Execute `fn` through the breaker.
+     * - CLOSED: runs fn normally.
+     * - OPEN: throws CircuitOpenError immediately (no fn call).
+     * - HALF_OPEN: runs fn as a probe; success → CLOSED, failure → OPEN.
+     */
+    async call(fn) {
+        if (this.state === "OPEN") {
+            const elapsed = Date.now() - (this.openedAt ?? 0);
+            if (elapsed < this.recoveryMs) {
+                throw new CircuitOpenError(`${this.name} is OPEN — backing off for ${Math.ceil((this.recoveryMs - elapsed) / 1000)}s more`);
+            }
+            // Recovery window has passed — probe with HALF_OPEN
+            this.state = "HALF_OPEN";
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (err) {
+            this.onFailure();
+            throw err;
+        }
+    }
+    /** Record a success: reset failures and close the circuit. */
+    onSuccess() {
+        this.failures = 0;
+        this.state = "CLOSED";
+        this.openedAt = null;
+    }
+    /** Record a failure: increment count and open if threshold reached. */
+    onFailure() {
+        this.failures += 1;
+        if (this.failures >= this.failureThreshold || this.state === "HALF_OPEN") {
+            this.state = "OPEN";
+            this.openedAt = Date.now();
+        }
+    }
+}
+/** Shared singleton for deepSearch — one breaker per process lifetime. */
+export const deepSearchBreaker = new CircuitBreaker({
+    name: "databricks-vector-search",
+    failureThreshold: 3,
+    recoveryMs: 30_000,
+});
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/search/circuit-breaker.js.map

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

package/dist/search/deep-search.d.ts

@@ -0,0 +1,24 @@
+export { CircuitOpenError } from "./circuit-breaker.js";
+export interface DeepSearchInput {
+    query: string;
+    numResults?: number;
+    source?: string;
+    type?: string;
+    mode?: "hybrid" | "semantic";
+}
+export interface DeepSearchResult {
+    eventId: string | null;
+    timestamp: string | null;
+    source: string | null;
+    type: string | null;
+    content: string | null;
+}
+export interface DeepSearchOutput {
+    query: string;
+    mode: string;
+    indexName: string;
+    totalResults: number;
+    results: DeepSearchResult[];
+}
+export declare function deepSearch(input: DeepSearchInput): Promise<DeepSearchOutput>;
+//# sourceMappingURL=deep-search.d.ts.map

package/dist/search/deep-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-search.d.ts","sourceRoot":"","sources":["../../src/search/deep-search.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAkBD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAuF3B"}

package/dist/search/deep-search.js

@@ -0,0 +1,98 @@
+// deep-search.ts — How does deep semantic search work?
+// Primary: Azure AI Search (when AZURE_SEARCH_ENDPOINT + AZURE_SEARCH_KEY set).
+// Fallback: Azure Databricks Vector Search (when DATABRICKS_HOST + DATABRICKS_TOKEN set).
+// Uses a circuit breaker on the Databricks path to prevent hammering a failing API.
+import { deepSearchBreaker } from "./circuit-breaker.js";
+import { isAzureSearchEnabled, vectorSearch } from "./azure-search-client.js";
+export { CircuitOpenError } from "./circuit-breaker.js";
+function getConfig() {
+    const host = process.env.DATABRICKS_HOST;
+    const token = process.env.DATABRICKS_TOKEN;
+    const indexName = process.env.DATABRICKS_INDEX_NAME ||
+        "datacore_databricks.datacore.bronze_events_index";
+    if (!host || !token) {
+        throw new Error("DATABRICKS_HOST and DATABRICKS_TOKEN must be set. " +
+            "Get a token from Databricks > User Settings > Developer > Access tokens.");
+    }
+    return { host: host.replace(/\/$/, ""), token, indexName };
+}
+export async function deepSearch(input) {
+    // --- PRIMARY: Azure AI Search ---
+    if (isAzureSearchEnabled()) {
+        const result = await vectorSearch(input.query, {
+            numResults: input.numResults,
+            source: input.source,
+            type: input.type,
+            mode: input.mode,
+        });
+        return result;
+    }
+    // --- FALLBACK: Azure Databricks Vector Search ---
+    const { host, token, indexName } = getConfig();
+    const { query, numResults = 5, source, type, mode = "hybrid" } = input;
+    const columns = ["event_id", "timestamp", "source", "type", "content"];
+    const body = {
+        columns,
+        query_text: query,
+        num_results: Math.min(numResults, 20),
+        query_type: mode === "semantic" ? "ANN" : "HYBRID",
+    };
+    const filters = {};
+    if (source)
+        filters["source"] = [source];
+    if (type)
+        filters["type"] = [type];
+    if (Object.keys(filters).length > 0) {
+        body.filters_json = JSON.stringify(filters);
+    }
+    const url = `${host}/api/2.0/vector-search/indexes/${indexName}/query`;
+    // Tag 4xx errors so the outer catch can call ignore() after onFailure() runs
+    class CallerError extends Error {
+    }
+    try {
+        return await deepSearchBreaker.call(async () => {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                if (response.status >= 400 && response.status < 500) {
+                    // Tag as caller error — will be unwrapped below after breaker.onFailure() runs
+                    throw new CallerError(`Databricks API ${response.status}: ${text}`);
+                }
+                // 5xx / 429 — server-side failure, let the breaker count it
+                throw new Error(`Databricks API ${response.status}: ${text}`);
+            }
+            const data = (await response.json());
+            const colNames = data.manifest.columns.map((c) => c.name);
+            const results = data.result.data_array.map((row) => {
+                const obj = {};
+                colNames.forEach((name, i) => {
+                    obj[name] = row[i] ?? null;
+                });
+                return {
+                    eventId: obj["event_id"] ?? null,
+                    timestamp: obj["timestamp"] ?? null,
+                    source: obj["source"] ?? null,
+                    type: obj["type"] ?? null,
+                    content: obj["content"] ?? null,
+                };
+            });
+            return { query, mode, indexName, totalResults: results.length, results };
+        });
+    }
+    catch (err) {
+        // 4xx caller errors: undo the failure that breaker.call() just counted
+        if (err instanceof CallerError) {
+            deepSearchBreaker.ignore();
+            throw new Error(err.message, { cause: err });
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=deep-search.js.map

package/dist/search/deep-search.js.map

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

package/dist/search/search.d.ts

@@ -0,0 +1,3 @@
+import type { SearchInput, SearchOutput } from "../types.js";
+export declare function searchEvents({ query, maxResults, source, type, }: SearchInput): Promise<SearchOutput>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/search/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,WAAW,EAEX,YAAY,EACb,MAAM,aAAa,CAAC;AA6CrB,wBAAsB,YAAY,CAAC,EACjC,KAAK,EACL,UAAgC,EAChC,MAAM,EACN,IAAI,GACL,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CA2CrC"}

package/dist/search/search.js

@@ -0,0 +1,76 @@
+// search.ts — How is data found?
+// Reads via readAllRecords (Cosmos in production, JSONL in tests/local).
+// Filtering and snippet generation happen in-memory after fetch.
+import { readAllRecords, getBronzeDir } from "../storage/store.js";
+const DEFAULT_MAX_RESULTS = 10;
+function buildSearchHaystack(record) {
+    const parts = [
+        typeof record.content === "string" ? record.content : "",
+        typeof record.type === "string" ? record.type : "",
+        typeof record.source === "string" ? record.source : "",
+    ];
+    if (record.context !== undefined) {
+        parts.push(JSON.stringify(record.context));
+    }
+    parts.push(JSON.stringify(record));
+    return parts.filter(Boolean).join("\n");
+}
+function buildSnippet(haystack, query) {
+    const normalizedHaystack = haystack.replace(/\s+/g, " ").trim();
+    const lowerHaystack = normalizedHaystack.toLowerCase();
+    const lowerQuery = query.toLowerCase();
+    const index = lowerHaystack.indexOf(lowerQuery);
+    if (index === -1) {
+        return normalizedHaystack.slice(0, 180);
+    }
+    const start = Math.max(0, index - 50);
+    const end = Math.min(normalizedHaystack.length, index + query.length + 80);
+    const prefix = start > 0 ? "..." : "";
+    const suffix = end < normalizedHaystack.length ? "..." : "";
+    return `${prefix}${normalizedHaystack.slice(start, end)}${suffix}`;
+}
+function incrementCounter(counter, value) {
+    if (typeof value !== "string")
+        return;
+    const key = value.trim();
+    if (!key)
+        return;
+    counter[key] = (counter[key] ?? 0) + 1;
+}
+export async function searchEvents({ query, maxResults = DEFAULT_MAX_RESULTS, source, type, }) {
+    const normalizedQuery = query.trim();
+    const limit = Math.max(1, Math.min(100, maxResults ?? DEFAULT_MAX_RESULTS));
+    const { records, parseErrors } = await readAllRecords({ source, type });
+    const lowerQuery = normalizedQuery.toLowerCase();
+    const matched = records.filter((r) => {
+        const haystack = buildSearchHaystack(r).toLowerCase();
+        return haystack.includes(lowerQuery);
+    });
+    matched.sort((a, b) => (b._timestamp ?? "").localeCompare(a._timestamp ?? ""));
+    const sourceCounts = {};
+    const typeCounts = {};
+    for (const r of matched) {
+        incrementCounter(sourceCounts, r._source ?? r.source);
+        incrementCounter(typeCounts, r.type);
+    }
+    const results = matched.slice(0, limit).map((r) => ({
+        eventId: r._event_id ?? null,
+        timestamp: r._timestamp ?? null,
+        source: r._source ?? r.source ?? null,
+        type: r.type ?? null,
+        trust: r._trust ?? null,
+        snippet: buildSnippet(buildSearchHaystack(r), normalizedQuery),
+        filePath: r._filePath ?? "",
+    }));
+    return {
+        bronzeDir: getBronzeDir(),
+        filesScanned: records.length,
+        eventsScanned: matched.length,
+        parseErrors,
+        totalMatches: results.length,
+        results,
+        sourceCounts,
+        typeCounts,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/search/search.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+// server.ts — How does the MCP server start?
+// Two transports: MCP stdio (for AI agents) + HTTP REST (for infrastructure).
+// Same process, same database.
+// Set DATACORE_STDIO=0 (or HTTP_ONLY=1) to run in container mode (HTTP only).
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerTools } from "./tools.js";
+import { startHttpServer } from "./transport/http-server.js";
+import { getMcpServerPackageVersion } from "./config/datacore-constants.js";
+const server = new McpServer({
+    name: "datacore",
+    version: getMcpServerPackageVersion(),
+});
+registerTools(server);
+// Start HTTP first so triggers can POST to /log as soon as MCP connects
+const httpServer = await startHttpServer();
+const httpOnly = process.env["DATACORE_STDIO"] === "0" ||
+    process.env["DATACORE_HTTP_ONLY"] === "1";
+if (httpOnly) {
+    // Container mode — HTTP transport only, no stdio
+    function shutdownHttp() {
+        httpServer.close();
+        process.exit(0);
+    }
+    process.on("SIGINT", shutdownHttp);
+    process.on("SIGTERM", shutdownHttp);
+}
+else {
+    await server.connect(new StdioServerTransport());
+    async function shutdown() {
+        httpServer.close();
+        await server.close();
+        process.exit(0);
+    }
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAEA,6CAA6C;AAC7C,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,0BAA0B,EAAE;CACtC,CAAC,CAAC;AAEH,aAAa,CAAC,MAAM,CAAC,CAAC;AAEtB,wEAAwE;AACxE,MAAM,UAAU,GAAG,MAAM,eAAe,EAAE,CAAC;AAE3C,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,GAAG;IACrC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,KAAK,GAAG,CAAC;AAE5C,IAAI,QAAQ,EAAE,CAAC;IACb,iDAAiD;IACjD,SAAS,YAAY;QACnB,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACtC,CAAC;KAAM,CAAC;IACN,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAEjD,KAAK,UAAU,QAAQ;QACrB,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/skills/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAGtD"}