@evalops/maestro 0.10.8 → 0.10.11

package/dist/platform/cerebro-facts-client.d.ts

@@ -0,0 +1,56 @@
+import { type DownstreamFailureMode } from "../utils/downstream-http.js";
+type JsonRecord = Record<string, unknown>;
+export interface MaestroFactsContextSummary {
+    thingCount: number;
+    linkCount: number;
+    pathCount: number;
+    factCount: number;
+    eventCount: number;
+    changeCount: number;
+    evidenceCount: number;
+    watermarkCount: number;
+}
+export interface MaestroFactsContext {
+    provider: "cerebro";
+    workspaceId: string;
+    query: string;
+    thingIds: string[];
+    linkIds: string[];
+    factIds: string[];
+    eventIds: string[];
+    things: JsonRecord[];
+    links: JsonRecord[];
+    paths: JsonRecord[];
+    facts: JsonRecord[];
+    events: JsonRecord[];
+    changes: JsonRecord[];
+    evidence: JsonRecord[];
+    watermarks: JsonRecord[];
+    summary: MaestroFactsContextSummary;
+}
+export interface MaestroSessionFactsInput {
+    workspaceId?: string;
+    sessionId: string;
+    actorId?: string;
+    factsQuery?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CerebroFactsServiceConfig {
+    baseUrl: string;
+    token?: string;
+    workspaceId?: string;
+    timeoutMs: number;
+    maxAttempts: number;
+    searchLimit: number;
+    changeLimit: number;
+    fetchImpl?: typeof fetch;
+}
+export declare function buildMaestroSessionFactsQuery(input: MaestroSessionFactsInput): string | undefined;
+export declare function resolveCerebroFactsServiceConfig(): CerebroFactsServiceConfig | null;
+export declare function gatherMaestroSessionFactsContext(input: MaestroSessionFactsInput, options?: {
+    config?: CerebroFactsServiceConfig | null;
+    signal?: AbortSignal;
+    failureMode?: DownstreamFailureMode;
+}): Promise<MaestroFactsContext | undefined>;
+export {};
+//# sourceMappingURL=cerebro-facts-client.d.ts.map

package/dist/platform/cerebro-facts-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cerebro-facts-client.d.ts","sourceRoot":"","sources":["../../src/platform/cerebro-facts-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,qBAAqB,EAE1B,MAAM,6BAA6B,CAAC;AAUrC,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA2B1C,MAAM,WAAW,0BAA0B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,OAAO,EAAE,0BAA0B,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACzB;AA2LD,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,wBAAwB,GAC7B,MAAM,GAAG,SAAS,CAYpB;AAED,wBAAgB,gCAAgC,IAAI,yBAAyB,GAAG,IAAI,CA0BnF;AAED,wBAAsB,gCAAgC,CACrD,KAAK,EAAE,wBAAwB,EAC/B,OAAO,CAAC,EAAE;IACT,MAAM,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACpC,GACC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAgJ1C"}

package/dist/platform/cerebro-facts-client.js

@@ -0,0 +1,297 @@
+import { fetchDownstream, } from "../utils/downstream-http.js";
+import { getEnvValue, normalizeBaseUrl, parsePositiveInt, resolveConfiguredToken, resolveWorkspaceId, trimString, } from "./client.js";
+const DEFAULT_TIMEOUT_MS = 1_500;
+const DEFAULT_MAX_ATTEMPTS = 1;
+const DEFAULT_SEARCH_LIMIT = 5;
+const DEFAULT_CHANGE_LIMIT = 10;
+const CEREBRO_BASE_URL_ENV_VARS = [
+    "MAESTRO_CEREBRO_URL",
+    "CEREBRO_URL",
+    "CEREBRO_SERVICE_URL",
+];
+const CEREBRO_TOKEN_ENV_VARS = [
+    "MAESTRO_CEREBRO_TOKEN",
+    "CEREBRO_TOKEN",
+    "MAESTRO_EVALOPS_ACCESS_TOKEN",
+    "EVALOPS_TOKEN",
+];
+const CEREBRO_WORKSPACE_ENV_VARS = [
+    "MAESTRO_CEREBRO_WORKSPACE_ID",
+    "CEREBRO_WORKSPACE_ID",
+    "MAESTRO_AGENT_RUNTIME_WORKSPACE_ID",
+    "AGENT_RUNTIME_WORKSPACE_ID",
+    "MAESTRO_WORKSPACE_ID",
+    "EVALOPS_WORKSPACE_ID",
+];
+const CEREBRO_TIMEOUT_ENV_VARS = [
+    "MAESTRO_CEREBRO_TIMEOUT_MS",
+    "CEREBRO_TIMEOUT_MS",
+];
+const CEREBRO_MAX_ATTEMPTS_ENV_VARS = [
+    "MAESTRO_CEREBRO_MAX_ATTEMPTS",
+    "CEREBRO_MAX_ATTEMPTS",
+];
+const CEREBRO_SEARCH_LIMIT_ENV_VARS = [
+    "MAESTRO_CEREBRO_SEARCH_LIMIT",
+    "CEREBRO_SEARCH_LIMIT",
+];
+const CEREBRO_CHANGE_LIMIT_ENV_VARS = [
+    "MAESTRO_CEREBRO_CHANGE_LIMIT",
+    "CEREBRO_CHANGE_LIMIT",
+];
+const CEREBRO_SERVICE_PATH = "/cerebro.v1.CerebroService/";
+const CEREBRO_SERVICE_SUFFIX = "/cerebro.v1.CerebroService";
+function jsonRecordArray(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === "object" && item !== null && !Array.isArray(item))
+        : [];
+}
+function recordId(record) {
+    const id = record.id;
+    return typeof id === "string" && id.trim().length > 0 ? id : undefined;
+}
+function recordString(record, name) {
+    const value = record[name];
+    return typeof value === "string" ? value.trim() : "";
+}
+function pushUniqueRecord(records, seen, record) {
+    if (!record) {
+        return;
+    }
+    const id = recordId(record);
+    if (id && seen.has(id)) {
+        return;
+    }
+    if (id) {
+        seen.add(id);
+    }
+    records.push(record);
+}
+function recordStringArray(record, name) {
+    const value = record[name];
+    return Array.isArray(value)
+        ? value
+            .filter((item) => typeof item === "string" && item.trim().length > 0)
+            .map((item) => item.trim())
+        : [];
+}
+function pathKey(path) {
+    const id = recordId(path);
+    if (id) {
+        return `id:${id}`;
+    }
+    const thingIds = recordStringArray(path, "thingIds");
+    const linkIds = recordStringArray(path, "linkIds");
+    if (thingIds.length === 0 && linkIds.length === 0) {
+        return undefined;
+    }
+    return `${thingIds.join("\u0000")}\u0001${linkIds.join("\u0000")}`;
+}
+function pushUniquePath(paths, seen, path) {
+    if (!path) {
+        return;
+    }
+    const key = pathKey(path);
+    if (!key || seen.has(key)) {
+        return;
+    }
+    seen.add(key);
+    paths.push(path);
+}
+function changeKey(change) {
+    const id = recordId(change);
+    if (id) {
+        return `id:${id}`;
+    }
+    const event = change.event;
+    if (typeof event === "object" && event !== null && !Array.isArray(event)) {
+        const eventId = recordString(event, "id");
+        if (eventId) {
+            return `event:${eventId}`;
+        }
+    }
+    const affectedThingIds = recordStringArray(change, "affectedThingIds");
+    const whyItMatters = recordString(change, "whyItMatters");
+    if (affectedThingIds.length === 0 && !whyItMatters) {
+        return undefined;
+    }
+    return `${affectedThingIds.join("\u0000")}\u0001${whyItMatters}`;
+}
+function pushUniqueChange(changes, seen, change) {
+    if (!change) {
+        return;
+    }
+    const key = changeKey(change);
+    if (!key || seen.has(key)) {
+        return;
+    }
+    seen.add(key);
+    changes.push(change);
+}
+function isAbortError(error) {
+    return error instanceof Error && error.name === "AbortError";
+}
+function pickMetadataString(metadata, ...names) {
+    for (const name of names) {
+        const value = metadata?.[name];
+        if (typeof value === "string" && value.trim().length > 0) {
+            return value.trim();
+        }
+    }
+    return undefined;
+}
+function normalizeCerebroBaseUrl(baseUrl) {
+    return normalizeBaseUrl(baseUrl, [CEREBRO_SERVICE_SUFFIX]);
+}
+export function buildMaestroSessionFactsQuery(input) {
+    return (trimString(input.factsQuery) ??
+        pickMetadataString(input.metadata, "prompt", "objective", "task", "title", "workspace_root"));
+}
+export function resolveCerebroFactsServiceConfig() {
+    const baseUrl = getEnvValue(CEREBRO_BASE_URL_ENV_VARS);
+    if (!baseUrl) {
+        return null;
+    }
+    return {
+        baseUrl: normalizeCerebroBaseUrl(baseUrl),
+        token: resolveConfiguredToken(CEREBRO_TOKEN_ENV_VARS),
+        workspaceId: resolveWorkspaceId(CEREBRO_WORKSPACE_ENV_VARS),
+        timeoutMs: parsePositiveInt(getEnvValue(CEREBRO_TIMEOUT_ENV_VARS), DEFAULT_TIMEOUT_MS),
+        maxAttempts: parsePositiveInt(getEnvValue(CEREBRO_MAX_ATTEMPTS_ENV_VARS), DEFAULT_MAX_ATTEMPTS),
+        searchLimit: parsePositiveInt(getEnvValue(CEREBRO_SEARCH_LIMIT_ENV_VARS), DEFAULT_SEARCH_LIMIT),
+        changeLimit: parsePositiveInt(getEnvValue(CEREBRO_CHANGE_LIMIT_ENV_VARS), DEFAULT_CHANGE_LIMIT),
+    };
+}
+export async function gatherMaestroSessionFactsContext(input, options) {
+    const config = options?.config ?? resolveCerebroFactsServiceConfig();
+    const workspaceId = trimString(input.workspaceId) ?? config?.workspaceId;
+    const query = buildMaestroSessionFactsQuery(input);
+    if (!config || !workspaceId || !query) {
+        return undefined;
+    }
+    const things = [];
+    const links = [];
+    const paths = [];
+    const facts = [];
+    const events = [];
+    const changes = [];
+    const evidence = [];
+    const watermarks = [];
+    const thingIds = new Set();
+    const linkIds = new Set();
+    const pathIds = new Set();
+    const factIds = new Set();
+    const eventIds = new Set();
+    const changeIds = new Set();
+    const evidenceIds = new Set();
+    const search = await postCerebro(config, "Search", {
+        workspaceId,
+        query,
+        limit: config.searchLimit,
+        includeMap: true,
+    }, { signal: options?.signal, failureMode: options?.failureMode });
+    for (const thing of jsonRecordArray(search.things)) {
+        pushUniqueRecord(things, thingIds, thing);
+    }
+    for (const link of jsonRecordArray(search.links)) {
+        pushUniqueRecord(links, linkIds, link);
+    }
+    for (const item of jsonRecordArray(search.evidence)) {
+        pushUniqueRecord(evidence, evidenceIds, item);
+    }
+    const mapThingIds = [...thingIds];
+    const thingResponses = await Promise.all(mapThingIds.map((thingId) => postCerebro(config, "GetThing", { workspaceId, thingId }, { signal: options?.signal, failureMode: options?.failureMode })));
+    for (const response of thingResponses) {
+        pushUniqueRecord(things, thingIds, response.thing);
+        for (const fact of jsonRecordArray(response.facts)) {
+            pushUniqueRecord(facts, factIds, fact);
+        }
+        for (const event of jsonRecordArray(response.recentEvents)) {
+            pushUniqueRecord(events, eventIds, event);
+        }
+        for (const item of jsonRecordArray(response.evidence)) {
+            pushUniqueRecord(evidence, evidenceIds, item);
+        }
+    }
+    const changeThingIds = [...thingIds];
+    if (mapThingIds.length > 0) {
+        const mapResults = await Promise.allSettled(mapThingIds.map((thingId) => postCerebro(config, "MapThing", { workspaceId, thingId, depth: 1 }, { signal: options?.signal, failureMode: options?.failureMode })));
+        for (const result of mapResults) {
+            if (result.status === "rejected") {
+                if (isAbortError(result.reason)) {
+                    throw result.reason;
+                }
+                continue;
+            }
+            const response = result.value;
+            pushUniqueRecord(things, thingIds, response.root);
+            for (const thing of jsonRecordArray(response.things)) {
+                pushUniqueRecord(things, thingIds, thing);
+            }
+            for (const link of jsonRecordArray(response.links)) {
+                pushUniqueRecord(links, linkIds, link);
+            }
+            for (const path of jsonRecordArray(response.paths)) {
+                pushUniquePath(paths, pathIds, path);
+            }
+            for (const item of jsonRecordArray(response.evidence)) {
+                pushUniqueRecord(evidence, evidenceIds, item);
+            }
+        }
+    }
+    if (changeThingIds.length > 0) {
+        const response = await postCerebro(config, "ListChanges", { workspaceId, thingIds: changeThingIds, limit: config.changeLimit }, { signal: options?.signal, failureMode: options?.failureMode });
+        for (const change of jsonRecordArray(response.changes)) {
+            pushUniqueChange(changes, changeIds, change);
+        }
+    }
+    return {
+        provider: "cerebro",
+        workspaceId,
+        query,
+        thingIds: [...thingIds],
+        linkIds: [...linkIds],
+        factIds: [...factIds],
+        eventIds: [...eventIds],
+        things,
+        links,
+        paths,
+        facts,
+        events,
+        changes,
+        evidence,
+        watermarks,
+        summary: {
+            thingCount: things.length,
+            linkCount: links.length,
+            pathCount: paths.length,
+            factCount: facts.length,
+            eventCount: events.length,
+            changeCount: changes.length,
+            evidenceCount: evidence.length,
+            watermarkCount: watermarks.length,
+        },
+    };
+}
+async function postCerebro(config, method, body, options) {
+    const response = await fetchDownstream(`${config.baseUrl}${CEREBRO_SERVICE_PATH}${method}`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            ...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),
+        },
+        body: JSON.stringify(body),
+        signal: options?.signal,
+    }, {
+        serviceName: "cerebro facts service",
+        failureMode: options?.failureMode ?? "optional",
+        timeoutMs: config.timeoutMs,
+        maxAttempts: config.maxAttempts,
+        fetchImpl: config.fetchImpl,
+    });
+    if (!response.ok) {
+        throw new Error(`cerebro facts service returned ${response.status}: ${(await response.text()) || response.statusText}`);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=cerebro-facts-client.js.map

package/dist/platform/cerebro-facts-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cerebro-facts-client.js","sourceRoot":"","sources":["../../src/platform/cerebro-facts-client.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype DownstreamFailureMode,\n\tfetchDownstream,\n} from \"../utils/downstream-http.js\";\nimport {\n\tgetEnvValue,\n\tnormalizeBaseUrl,\n\tparsePositiveInt,\n\tresolveConfiguredToken,\n\tresolveWorkspaceId,\n\ttrimString,\n} from \"./client.js\";\n\ntype JsonRecord = Record<string, unknown>;\n\ninterface CerebroSearchResponse {\n\tthings?: JsonRecord[];\n\tlinks?: JsonRecord[];\n\tevidence?: JsonRecord[];\n}\n\ninterface CerebroGetThingResponse {\n\tthing?: JsonRecord;\n\tfacts?: JsonRecord[];\n\trecentEvents?: JsonRecord[];\n\tevidence?: JsonRecord[];\n}\n\ninterface CerebroListChangesResponse {\n\tchanges?: JsonRecord[];\n}\n\ninterface CerebroMapThingResponse {\n\troot?: JsonRecord;\n\tthings?: JsonRecord[];\n\tlinks?: JsonRecord[];\n\tpaths?: JsonRecord[];\n\tevidence?: JsonRecord[];\n}\n\nexport interface MaestroFactsContextSummary {\n\tthingCount: number;\n\tlinkCount: number;\n\tpathCount: number;\n\tfactCount: number;\n\teventCount: number;\n\tchangeCount: number;\n\tevidenceCount: number;\n\twatermarkCount: number;\n}\n\nexport interface MaestroFactsContext {\n\tprovider: \"cerebro\";\n\tworkspaceId: string;\n\tquery: string;\n\tthingIds: string[];\n\tlinkIds: string[];\n\tfactIds: string[];\n\teventIds: string[];\n\tthings: JsonRecord[];\n\tlinks: JsonRecord[];\n\tpaths: JsonRecord[];\n\tfacts: JsonRecord[];\n\tevents: JsonRecord[];\n\tchanges: JsonRecord[];\n\tevidence: JsonRecord[];\n\twatermarks: JsonRecord[];\n\tsummary: MaestroFactsContextSummary;\n}\n\nexport interface MaestroSessionFactsInput {\n\tworkspaceId?: string;\n\tsessionId: string;\n\tactorId?: string;\n\tfactsQuery?: string;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface CerebroFactsServiceConfig {\n\tbaseUrl: string;\n\ttoken?: string;\n\tworkspaceId?: string;\n\ttimeoutMs: number;\n\tmaxAttempts: number;\n\tsearchLimit: number;\n\tchangeLimit: number;\n\tfetchImpl?: typeof fetch;\n}\n\nconst DEFAULT_TIMEOUT_MS = 1_500;\nconst DEFAULT_MAX_ATTEMPTS = 1;\nconst DEFAULT_SEARCH_LIMIT = 5;\nconst DEFAULT_CHANGE_LIMIT = 10;\n\nconst CEREBRO_BASE_URL_ENV_VARS = [\n\t\"MAESTRO_CEREBRO_URL\",\n\t\"CEREBRO_URL\",\n\t\"CEREBRO_SERVICE_URL\",\n] as const;\n\nconst CEREBRO_TOKEN_ENV_VARS = [\n\t\"MAESTRO_CEREBRO_TOKEN\",\n\t\"CEREBRO_TOKEN\",\n\t\"MAESTRO_EVALOPS_ACCESS_TOKEN\",\n\t\"EVALOPS_TOKEN\",\n] as const;\n\nconst CEREBRO_WORKSPACE_ENV_VARS = [\n\t\"MAESTRO_CEREBRO_WORKSPACE_ID\",\n\t\"CEREBRO_WORKSPACE_ID\",\n\t\"MAESTRO_AGENT_RUNTIME_WORKSPACE_ID\",\n\t\"AGENT_RUNTIME_WORKSPACE_ID\",\n\t\"MAESTRO_WORKSPACE_ID\",\n\t\"EVALOPS_WORKSPACE_ID\",\n] as const;\n\nconst CEREBRO_TIMEOUT_ENV_VARS = [\n\t\"MAESTRO_CEREBRO_TIMEOUT_MS\",\n\t\"CEREBRO_TIMEOUT_MS\",\n] as const;\n\nconst CEREBRO_MAX_ATTEMPTS_ENV_VARS = [\n\t\"MAESTRO_CEREBRO_MAX_ATTEMPTS\",\n\t\"CEREBRO_MAX_ATTEMPTS\",\n] as const;\n\nconst CEREBRO_SEARCH_LIMIT_ENV_VARS = [\n\t\"MAESTRO_CEREBRO_SEARCH_LIMIT\",\n\t\"CEREBRO_SEARCH_LIMIT\",\n] as const;\n\nconst CEREBRO_CHANGE_LIMIT_ENV_VARS = [\n\t\"MAESTRO_CEREBRO_CHANGE_LIMIT\",\n\t\"CEREBRO_CHANGE_LIMIT\",\n] as const;\n\nconst CEREBRO_SERVICE_PATH = \"/cerebro.v1.CerebroService/\";\nconst CEREBRO_SERVICE_SUFFIX = \"/cerebro.v1.CerebroService\";\n\nfunction jsonRecordArray(value: unknown): JsonRecord[] {\n\treturn Array.isArray(value)\n\t\t? value.filter(\n\t\t\t\t(item): item is JsonRecord =>\n\t\t\t\t\ttypeof item === \"object\" && item !== null && !Array.isArray(item),\n\t\t\t)\n\t\t: [];\n}\n\nfunction recordId(record: JsonRecord): string | undefined {\n\tconst id = record.id;\n\treturn typeof id === \"string\" && id.trim().length > 0 ? id : undefined;\n}\n\nfunction recordString(record: JsonRecord, name: string): string {\n\tconst value = record[name];\n\treturn typeof value === \"string\" ? value.trim() : \"\";\n}\n\nfunction pushUniqueRecord(\n\trecords: JsonRecord[],\n\tseen: Set<string>,\n\trecord: JsonRecord | undefined,\n): void {\n\tif (!record) {\n\t\treturn;\n\t}\n\tconst id = recordId(record);\n\tif (id && seen.has(id)) {\n\t\treturn;\n\t}\n\tif (id) {\n\t\tseen.add(id);\n\t}\n\trecords.push(record);\n}\n\nfunction recordStringArray(record: JsonRecord, name: string): string[] {\n\tconst value = record[name];\n\treturn Array.isArray(value)\n\t\t? value\n\t\t\t\t.filter(\n\t\t\t\t\t(item): item is string =>\n\t\t\t\t\t\ttypeof item === \"string\" && item.trim().length > 0,\n\t\t\t\t)\n\t\t\t\t.map((item) => item.trim())\n\t\t: [];\n}\n\nfunction pathKey(path: JsonRecord): string | undefined {\n\tconst id = recordId(path);\n\tif (id) {\n\t\treturn `id:${id}`;\n\t}\n\tconst thingIds = recordStringArray(path, \"thingIds\");\n\tconst linkIds = recordStringArray(path, \"linkIds\");\n\tif (thingIds.length === 0 && linkIds.length === 0) {\n\t\treturn undefined;\n\t}\n\treturn `${thingIds.join(\"\\u0000\")}\\u0001${linkIds.join(\"\\u0000\")}`;\n}\n\nfunction pushUniquePath(\n\tpaths: JsonRecord[],\n\tseen: Set<string>,\n\tpath: JsonRecord | undefined,\n): void {\n\tif (!path) {\n\t\treturn;\n\t}\n\tconst key = pathKey(path);\n\tif (!key || seen.has(key)) {\n\t\treturn;\n\t}\n\tseen.add(key);\n\tpaths.push(path);\n}\n\nfunction changeKey(change: JsonRecord): string | undefined {\n\tconst id = recordId(change);\n\tif (id) {\n\t\treturn `id:${id}`;\n\t}\n\tconst event = change.event;\n\tif (typeof event === \"object\" && event !== null && !Array.isArray(event)) {\n\t\tconst eventId = recordString(event as JsonRecord, \"id\");\n\t\tif (eventId) {\n\t\t\treturn `event:${eventId}`;\n\t\t}\n\t}\n\tconst affectedThingIds = recordStringArray(change, \"affectedThingIds\");\n\tconst whyItMatters = recordString(change, \"whyItMatters\");\n\tif (affectedThingIds.length === 0 && !whyItMatters) {\n\t\treturn undefined;\n\t}\n\treturn `${affectedThingIds.join(\"\\u0000\")}\\u0001${whyItMatters}`;\n}\n\nfunction pushUniqueChange(\n\tchanges: JsonRecord[],\n\tseen: Set<string>,\n\tchange: JsonRecord | undefined,\n): void {\n\tif (!change) {\n\t\treturn;\n\t}\n\tconst key = changeKey(change);\n\tif (!key || seen.has(key)) {\n\t\treturn;\n\t}\n\tseen.add(key);\n\tchanges.push(change);\n}\n\nfunction isAbortError(error: unknown): boolean {\n\treturn error instanceof Error && error.name === \"AbortError\";\n}\n\nfunction pickMetadataString(\n\tmetadata: Record<string, unknown> | undefined,\n\t...names: string[]\n): string | undefined {\n\tfor (const name of names) {\n\t\tconst value = metadata?.[name];\n\t\tif (typeof value === \"string\" && value.trim().length > 0) {\n\t\t\treturn value.trim();\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction normalizeCerebroBaseUrl(baseUrl: string): string {\n\treturn normalizeBaseUrl(baseUrl, [CEREBRO_SERVICE_SUFFIX]);\n}\n\nexport function buildMaestroSessionFactsQuery(\n\tinput: MaestroSessionFactsInput,\n): string | undefined {\n\treturn (\n\t\ttrimString(input.factsQuery) ??\n\t\tpickMetadataString(\n\t\t\tinput.metadata,\n\t\t\t\"prompt\",\n\t\t\t\"objective\",\n\t\t\t\"task\",\n\t\t\t\"title\",\n\t\t\t\"workspace_root\",\n\t\t)\n\t);\n}\n\nexport function resolveCerebroFactsServiceConfig(): CerebroFactsServiceConfig | null {\n\tconst baseUrl = getEnvValue(CEREBRO_BASE_URL_ENV_VARS);\n\tif (!baseUrl) {\n\t\treturn null;\n\t}\n\treturn {\n\t\tbaseUrl: normalizeCerebroBaseUrl(baseUrl),\n\t\ttoken: resolveConfiguredToken(CEREBRO_TOKEN_ENV_VARS),\n\t\tworkspaceId: resolveWorkspaceId(CEREBRO_WORKSPACE_ENV_VARS),\n\t\ttimeoutMs: parsePositiveInt(\n\t\t\tgetEnvValue(CEREBRO_TIMEOUT_ENV_VARS),\n\t\t\tDEFAULT_TIMEOUT_MS,\n\t\t),\n\t\tmaxAttempts: parsePositiveInt(\n\t\t\tgetEnvValue(CEREBRO_MAX_ATTEMPTS_ENV_VARS),\n\t\t\tDEFAULT_MAX_ATTEMPTS,\n\t\t),\n\t\tsearchLimit: parsePositiveInt(\n\t\t\tgetEnvValue(CEREBRO_SEARCH_LIMIT_ENV_VARS),\n\t\t\tDEFAULT_SEARCH_LIMIT,\n\t\t),\n\t\tchangeLimit: parsePositiveInt(\n\t\t\tgetEnvValue(CEREBRO_CHANGE_LIMIT_ENV_VARS),\n\t\t\tDEFAULT_CHANGE_LIMIT,\n\t\t),\n\t};\n}\n\nexport async function gatherMaestroSessionFactsContext(\n\tinput: MaestroSessionFactsInput,\n\toptions?: {\n\t\tconfig?: CerebroFactsServiceConfig | null;\n\t\tsignal?: AbortSignal;\n\t\tfailureMode?: DownstreamFailureMode;\n\t},\n): Promise<MaestroFactsContext | undefined> {\n\tconst config = options?.config ?? resolveCerebroFactsServiceConfig();\n\tconst workspaceId = trimString(input.workspaceId) ?? config?.workspaceId;\n\tconst query = buildMaestroSessionFactsQuery(input);\n\tif (!config || !workspaceId || !query) {\n\t\treturn undefined;\n\t}\n\n\tconst things: JsonRecord[] = [];\n\tconst links: JsonRecord[] = [];\n\tconst paths: JsonRecord[] = [];\n\tconst facts: JsonRecord[] = [];\n\tconst events: JsonRecord[] = [];\n\tconst changes: JsonRecord[] = [];\n\tconst evidence: JsonRecord[] = [];\n\tconst watermarks: JsonRecord[] = [];\n\tconst thingIds = new Set<string>();\n\tconst linkIds = new Set<string>();\n\tconst pathIds = new Set<string>();\n\tconst factIds = new Set<string>();\n\tconst eventIds = new Set<string>();\n\tconst changeIds = new Set<string>();\n\tconst evidenceIds = new Set<string>();\n\n\tconst search = await postCerebro<CerebroSearchResponse>(\n\t\tconfig,\n\t\t\"Search\",\n\t\t{\n\t\t\tworkspaceId,\n\t\t\tquery,\n\t\t\tlimit: config.searchLimit,\n\t\t\tincludeMap: true,\n\t\t},\n\t\t{ signal: options?.signal, failureMode: options?.failureMode },\n\t);\n\tfor (const thing of jsonRecordArray(search.things)) {\n\t\tpushUniqueRecord(things, thingIds, thing);\n\t}\n\tfor (const link of jsonRecordArray(search.links)) {\n\t\tpushUniqueRecord(links, linkIds, link);\n\t}\n\tfor (const item of jsonRecordArray(search.evidence)) {\n\t\tpushUniqueRecord(evidence, evidenceIds, item);\n\t}\n\n\tconst mapThingIds = [...thingIds];\n\tconst thingResponses = await Promise.all(\n\t\tmapThingIds.map((thingId) =>\n\t\t\tpostCerebro<CerebroGetThingResponse>(\n\t\t\t\tconfig,\n\t\t\t\t\"GetThing\",\n\t\t\t\t{ workspaceId, thingId },\n\t\t\t\t{ signal: options?.signal, failureMode: options?.failureMode },\n\t\t\t),\n\t\t),\n\t);\n\tfor (const response of thingResponses) {\n\t\tpushUniqueRecord(things, thingIds, response.thing);\n\t\tfor (const fact of jsonRecordArray(response.facts)) {\n\t\t\tpushUniqueRecord(facts, factIds, fact);\n\t\t}\n\t\tfor (const event of jsonRecordArray(response.recentEvents)) {\n\t\t\tpushUniqueRecord(events, eventIds, event);\n\t\t}\n\t\tfor (const item of jsonRecordArray(response.evidence)) {\n\t\t\tpushUniqueRecord(evidence, evidenceIds, item);\n\t\t}\n\t}\n\n\tconst changeThingIds = [...thingIds];\n\tif (mapThingIds.length > 0) {\n\t\tconst mapResults = await Promise.allSettled(\n\t\t\tmapThingIds.map((thingId) =>\n\t\t\t\tpostCerebro<CerebroMapThingResponse>(\n\t\t\t\t\tconfig,\n\t\t\t\t\t\"MapThing\",\n\t\t\t\t\t{ workspaceId, thingId, depth: 1 },\n\t\t\t\t\t{ signal: options?.signal, failureMode: options?.failureMode },\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\t\tfor (const result of mapResults) {\n\t\t\tif (result.status === \"rejected\") {\n\t\t\t\tif (isAbortError(result.reason)) {\n\t\t\t\t\tthrow result.reason;\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst response = result.value;\n\t\t\tpushUniqueRecord(things, thingIds, response.root);\n\t\t\tfor (const thing of jsonRecordArray(response.things)) {\n\t\t\t\tpushUniqueRecord(things, thingIds, thing);\n\t\t\t}\n\t\t\tfor (const link of jsonRecordArray(response.links)) {\n\t\t\t\tpushUniqueRecord(links, linkIds, link);\n\t\t\t}\n\t\t\tfor (const path of jsonRecordArray(response.paths)) {\n\t\t\t\tpushUniquePath(paths, pathIds, path);\n\t\t\t}\n\t\t\tfor (const item of jsonRecordArray(response.evidence)) {\n\t\t\t\tpushUniqueRecord(evidence, evidenceIds, item);\n\t\t\t}\n\t\t}\n\t}\n\n\tif (changeThingIds.length > 0) {\n\t\tconst response = await postCerebro<CerebroListChangesResponse>(\n\t\t\tconfig,\n\t\t\t\"ListChanges\",\n\t\t\t{ workspaceId, thingIds: changeThingIds, limit: config.changeLimit },\n\t\t\t{ signal: options?.signal, failureMode: options?.failureMode },\n\t\t);\n\t\tfor (const change of jsonRecordArray(response.changes)) {\n\t\t\tpushUniqueChange(changes, changeIds, change);\n\t\t}\n\t}\n\n\treturn {\n\t\tprovider: \"cerebro\",\n\t\tworkspaceId,\n\t\tquery,\n\t\tthingIds: [...thingIds],\n\t\tlinkIds: [...linkIds],\n\t\tfactIds: [...factIds],\n\t\teventIds: [...eventIds],\n\t\tthings,\n\t\tlinks,\n\t\tpaths,\n\t\tfacts,\n\t\tevents,\n\t\tchanges,\n\t\tevidence,\n\t\twatermarks,\n\t\tsummary: {\n\t\t\tthingCount: things.length,\n\t\t\tlinkCount: links.length,\n\t\t\tpathCount: paths.length,\n\t\t\tfactCount: facts.length,\n\t\t\teventCount: events.length,\n\t\t\tchangeCount: changes.length,\n\t\t\tevidenceCount: evidence.length,\n\t\t\twatermarkCount: watermarks.length,\n\t\t},\n\t};\n}\n\nasync function postCerebro<ResponseBody>(\n\tconfig: CerebroFactsServiceConfig,\n\tmethod: string,\n\tbody: JsonRecord,\n\toptions?: {\n\t\tsignal?: AbortSignal;\n\t\tfailureMode?: DownstreamFailureMode;\n\t},\n): Promise<ResponseBody> {\n\tconst response = await fetchDownstream(\n\t\t`${config.baseUrl}${CEREBRO_SERVICE_PATH}${method}`,\n\t\t{\n\t\t\tmethod: \"POST\",\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),\n\t\t\t},\n\t\t\tbody: JSON.stringify(body),\n\t\t\tsignal: options?.signal,\n\t\t},\n\t\t{\n\t\t\tserviceName: \"cerebro facts service\",\n\t\t\tfailureMode: options?.failureMode ?? \"optional\",\n\t\t\ttimeoutMs: config.timeoutMs,\n\t\t\tmaxAttempts: config.maxAttempts,\n\t\t\tfetchImpl: config.fetchImpl,\n\t\t},\n\t);\n\tif (!response.ok) {\n\t\tthrow new Error(\n\t\t\t`cerebro facts service returned ${response.status}: ${\n\t\t\t\t(await response.text()) || response.statusText\n\t\t\t}`,\n\t\t);\n\t}\n\treturn (await response.json()) as ResponseBody;\n}\n"]}

package/dist/platform/client.d.ts

@@ -1,3 +1,4 @@
+import { type DownstreamFailureMode } from "../utils/downstream-http.js";
 export declare const CONNECT_PROTOCOL_VERSION = "1";
 export declare const DEFAULT_PLATFORM_TIMEOUT_MS = 2000;
 export declare const DEFAULT_PLATFORM_MAX_ATTEMPTS = 2;
@@ -27,6 +28,7 @@ export interface ResolvePlatformServiceConfigOptions {
 }
 export interface PlatformRequestOptions {
     serviceName: string;
+    failureMode: DownstreamFailureMode;
     timeoutMs: number;
     maxAttempts?: number;
     signal?: AbortSignal;
@@ -42,6 +44,5 @@ export declare function resolveConfiguredToken(envVars?: readonly string[]): str
 export declare function resolvePlatformToken(envVars?: readonly string[]): Promise<string | undefined>;
 export declare function resolvePlatformServiceConfig(options: ResolvePlatformServiceConfigOptions): Promise<PlatformServiceConfig | null>;
 export declare function buildPlatformConnectHeaders(config: Pick<PlatformServiceConfig, "organizationId" | "token">, extraHeaders?: Record<string, string | undefined>): Record<string, string>;
-export declare function fetchWithRetry(url: string, init: RequestInit, options: PlatformRequestOptions): Promise<Response>;
 export declare function postPlatformConnect(config: PlatformServiceConfig, path: string, body: Record<string, unknown>, options: PlatformRequestOptions, headers?: Record<string, string | undefined>): Promise<Response>;
 //# sourceMappingURL=client.d.ts.map

package/dist/platform/client.d.ts.map

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

package/dist/platform/client.js

@@ -1,5 +1,6 @@
 import { getOAuthToken } from "../oauth/index.js";
 import { loadOAuthCredentials } from "../oauth/storage.js";
+import { fetchDownstream, } from "../utils/downstream-http.js";
 export const CONNECT_PROTOCOL_VERSION = "1";
 export const DEFAULT_PLATFORM_TIMEOUT_MS = 2_000;
 export const DEFAULT_PLATFORM_MAX_ATTEMPTS = 2;
@@ -117,35 +118,17 @@ export function buildPlatformConnectHeaders(config, extraHeaders) {
         ...(extraHeaders ?? {}),
     });
 }
-export async function fetchWithRetry(url, init, options) {
-    const maxAttempts = Math.max(1, options.maxAttempts ?? 1);
-    let lastError;
-    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
-        try {
-            const response = await fetch(url, {
-                ...init,
-                signal: options.signal ?? AbortSignal.timeout(Math.max(1, options.timeoutMs)),
-            });
-            if (response.status < 500 || attempt === maxAttempts) {
-                return response;
-            }
-        }
-        catch (error) {
-            lastError = error;
-            if (attempt === maxAttempts) {
-                break;
-            }
-        }
-    }
-    throw lastError instanceof Error
-        ? lastError
-        : new Error(`${options.serviceName} request failed`);
-}
 export async function postPlatformConnect(config, path, body, options, headers) {
-    return fetchWithRetry(`${config.baseUrl}${path}`, {
+    return fetchDownstream(`${config.baseUrl}${path}`, {
         method: "POST",
         headers: buildPlatformConnectHeaders(config, headers),
         body: JSON.stringify(body),
-    }, options);
+        signal: options.signal,
+    }, {
+        serviceName: options.serviceName,
+        failureMode: options.failureMode,
+        timeoutMs: options.timeoutMs,
+        maxAttempts: options.maxAttempts,
+    });
 }
 //# sourceMappingURL=client.js.map

package/dist/platform/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/platform/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { getOAuthToken } from \"../oauth/index.js\";\nimport { loadOAuthCredentials } from \"../oauth/storage.js\";\n\nexport const CONNECT_PROTOCOL_VERSION = \"1\";\nexport const DEFAULT_PLATFORM_TIMEOUT_MS = 2_000;\nexport const DEFAULT_PLATFORM_MAX_ATTEMPTS = 2;\n\nexport interface PlatformServiceConfig {\n\tbaseUrl: string;\n\ttoken?: string;\n\torganizationId?: string;\n\tteamId?: string;\n\tworkspaceId?: string;\n\ttimeoutMs: number;\n\tmaxAttempts: number;\n}\n\nexport interface ResolvePlatformServiceConfigOptions {\n\tbaseUrlEnvVars: readonly string[];\n\ttokenEnvVars?: readonly string[];\n\torganizationEnvVars?: readonly string[];\n\tteamEnvVars?: readonly string[];\n\tworkspaceEnvVars?: readonly string[];\n\ttimeoutEnvVars?: readonly string[];\n\tmaxAttemptsEnvVars?: readonly string[];\n\tbaseUrlSuffixes?: readonly string[];\n\tdefaultTimeoutMs?: number;\n\tdefaultMaxAttempts?: number;\n\trequireBaseUrl?: boolean;\n\trequireOrganizationId?: boolean;\n\trequireToken?: boolean;\n}\n\nexport interface PlatformRequestOptions {\n\tserviceName: string;\n\ttimeoutMs: number;\n\tmaxAttempts?: number;\n\tsignal?: AbortSignal;\n}\n\nconst SHARED_PLATFORM_BASE_URL_ENV_VARS = [\n\t\"MAESTRO_PLATFORM_BASE_URL\",\n\t\"MAESTRO_EVALOPS_BASE_URL\",\n\t\"EVALOPS_BASE_URL\",\n] as const;\n\nconst DEFAULT_TOKEN_ENV_VARS = [\n\t\"MAESTRO_EVALOPS_ACCESS_TOKEN\",\n\t\"EVALOPS_TOKEN\",\n] as const;\n\nconst DEFAULT_ORGANIZATION_ENV_VARS = [\n\t\"MAESTRO_EVALOPS_ORG_ID\",\n\t\"EVALOPS_ORGANIZATION_ID\",\n\t\"MAESTRO_ENTERPRISE_ORG_ID\",\n] as const;\n\nconst DEFAULT_TEAM_ENV_VARS = [\n\t\"MAESTRO_EVALOPS_TEAM_ID\",\n\t\"MAESTRO_LLM_GATEWAY_TEAM_ID\",\n] as const;\n\nexport function trimString(value: string | undefined): string | undefined {\n\tconst trimmed = value?.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nexport function getEnvValue(names: readonly string[]): string | undefined {\n\tfor (const name of names) {\n\t\tconst value = trimString(process.env[name]);\n\t\tif (value) {\n\t\t\treturn value;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nexport function parsePositiveInt(\n\tvalue: string | undefined,\n\tfallback: number,\n): number {\n\tconst parsed = Number.parseInt(value ?? \"\", 10);\n\treturn Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;\n}\n\nexport function normalizeBaseUrl(\n\tbaseUrl: string,\n\tsuffixes: readonly string[] = [],\n): string {\n\tlet normalized = baseUrl.trim().replace(/\\/+$/u, \"\");\n\tfor (const suffix of suffixes) {\n\t\tif (normalized.endsWith(suffix)) {\n\t\t\tnormalized = normalized.slice(0, -suffix.length).replace(/\\/+$/u, \"\");\n\t\t}\n\t}\n\treturn normalized;\n}\n\nexport function resolveOrganizationId(\n\tenvVars: readonly string[] = DEFAULT_ORGANIZATION_ENV_VARS,\n): string | undefined {\n\tconst envOrgId = getEnvValue(envVars);\n\tif (envOrgId) {\n\t\treturn envOrgId;\n\t}\n\tconst stored = loadOAuthCredentials(\"evalops\")?.metadata?.organizationId;\n\treturn typeof stored === \"string\" ? trimString(stored) : undefined;\n}\n\nexport function resolveTeamId(\n\tenvVars: readonly string[] = DEFAULT_TEAM_ENV_VARS,\n): string | undefined {\n\treturn getEnvValue(envVars);\n}\n\nexport function resolveWorkspaceId(\n\tenvVars: readonly string[] = DEFAULT_ORGANIZATION_ENV_VARS,\n): string | undefined {\n\treturn getEnvValue(envVars) ?? resolveOrganizationId();\n}\n\nexport function resolveConfiguredToken(\n\tenvVars: readonly string[] = DEFAULT_TOKEN_ENV_VARS,\n): string | undefined {\n\tconst envToken = getEnvValue(envVars);\n\tif (envToken) {\n\t\treturn envToken;\n\t}\n\tconst stored = loadOAuthCredentials(\"evalops\")?.access;\n\treturn typeof stored === \"string\" ? trimString(stored) : undefined;\n}\n\nexport async function resolvePlatformToken(\n\tenvVars: readonly string[] = DEFAULT_TOKEN_ENV_VARS,\n): Promise<string | undefined> {\n\treturn getEnvValue(envVars) ?? (await getOAuthToken(\"evalops\")) ?? undefined;\n}\n\nexport async function resolvePlatformServiceConfig(\n\toptions: ResolvePlatformServiceConfigOptions,\n): Promise<PlatformServiceConfig | null> {\n\tconst baseUrl = getEnvValue([\n\t\t...options.baseUrlEnvVars,\n\t\t...SHARED_PLATFORM_BASE_URL_ENV_VARS,\n\t]);\n\tif (!baseUrl && options.requireBaseUrl !== false) {\n\t\treturn null;\n\t}\n\n\tconst organizationId = resolveOrganizationId(options.organizationEnvVars);\n\tif (!organizationId && options.requireOrganizationId !== false) {\n\t\treturn null;\n\t}\n\n\tconst token = await resolvePlatformToken(options.tokenEnvVars);\n\tif (!token && options.requireToken !== false) {\n\t\treturn null;\n\t}\n\n\tconst workspaceId = options.workspaceEnvVars\n\t\t? resolveWorkspaceId(options.workspaceEnvVars)\n\t\t: organizationId;\n\n\treturn {\n\t\tbaseUrl: normalizeBaseUrl(baseUrl ?? \"\", options.baseUrlSuffixes),\n\t\t...(token ? { token } : {}),\n\t\t...(organizationId ? { organizationId } : {}),\n\t\tteamId: resolveTeamId(options.teamEnvVars),\n\t\t...(workspaceId ? { workspaceId } : {}),\n\t\ttimeoutMs: parsePositiveInt(\n\t\t\tgetEnvValue(options.timeoutEnvVars ?? []),\n\t\t\toptions.defaultTimeoutMs ?? DEFAULT_PLATFORM_TIMEOUT_MS,\n\t\t),\n\t\tmaxAttempts: parsePositiveInt(\n\t\t\tgetEnvValue(options.maxAttemptsEnvVars ?? []),\n\t\t\toptions.defaultMaxAttempts ?? DEFAULT_PLATFORM_MAX_ATTEMPTS,\n\t\t),\n\t};\n}\n\nfunction buildPlatformJsonHeaders(\n\tconfig: Pick<PlatformServiceConfig, \"organizationId\" | \"token\">,\n\textraHeaders?: Record<string, string | undefined>,\n): Record<string, string> {\n\treturn Object.fromEntries(\n\t\tObject.entries({\n\t\t\t...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),\n\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t...(config.organizationId\n\t\t\t\t? { \"X-Organization-ID\": config.organizationId }\n\t\t\t\t: {}),\n\t\t\t...(extraHeaders ?? {}),\n\t\t}).filter(\n\t\t\t(entry): entry is [string, string] =>\n\t\t\t\ttypeof entry[1] === \"string\" && entry[1].trim().length > 0,\n\t\t),\n\t);\n}\n\nexport function buildPlatformConnectHeaders(\n\tconfig: Pick<PlatformServiceConfig, \"organizationId\" | \"token\">,\n\textraHeaders?: Record<string, string | undefined>,\n): Record<string, string> {\n\treturn buildPlatformJsonHeaders(config, {\n\t\t\"Connect-Protocol-Version\": CONNECT_PROTOCOL_VERSION,\n\t\t...(extraHeaders ?? {}),\n\t});\n}\n\nexport async function fetchWithRetry(\n\turl: string,\n\tinit: RequestInit,\n\toptions: PlatformRequestOptions,\n): Promise<Response> {\n\tconst maxAttempts = Math.max(1, options.maxAttempts ?? 1);\n\tlet lastError: unknown;\n\tfor (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n\t\ttry {\n\t\t\tconst response = await fetch(url, {\n\t\t\t\t...init,\n\t\t\t\tsignal:\n\t\t\t\t\toptions.signal ?? AbortSignal.timeout(Math.max(1, options.timeoutMs)),\n\t\t\t});\n\t\t\tif (response.status < 500 || attempt === maxAttempts) {\n\t\t\t\treturn response;\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tlastError = error;\n\t\t\tif (attempt === maxAttempts) {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t}\n\tthrow lastError instanceof Error\n\t\t? lastError\n\t\t: new Error(`${options.serviceName} request failed`);\n}\n\nexport async function postPlatformConnect(\n\tconfig: PlatformServiceConfig,\n\tpath: string,\n\tbody: Record<string, unknown>,\n\toptions: PlatformRequestOptions,\n\theaders?: Record<string, string | undefined>,\n): Promise<Response> {\n\treturn fetchWithRetry(\n\t\t`${config.baseUrl}${path}`,\n\t\t{\n\t\t\tmethod: \"POST\",\n\t\t\theaders: buildPlatformConnectHeaders(config, headers),\n\t\t\tbody: JSON.stringify(body),\n\t\t},\n\t\toptions,\n\t);\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/platform/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { getOAuthToken } from \"../oauth/index.js\";\nimport { loadOAuthCredentials } from \"../oauth/storage.js\";\nimport {\n\ttype DownstreamFailureMode,\n\tfetchDownstream,\n} from \"../utils/downstream-http.js\";\n\nexport const CONNECT_PROTOCOL_VERSION = \"1\";\nexport const DEFAULT_PLATFORM_TIMEOUT_MS = 2_000;\nexport const DEFAULT_PLATFORM_MAX_ATTEMPTS = 2;\n\nexport interface PlatformServiceConfig {\n\tbaseUrl: string;\n\ttoken?: string;\n\torganizationId?: string;\n\tteamId?: string;\n\tworkspaceId?: string;\n\ttimeoutMs: number;\n\tmaxAttempts: number;\n}\n\nexport interface ResolvePlatformServiceConfigOptions {\n\tbaseUrlEnvVars: readonly string[];\n\ttokenEnvVars?: readonly string[];\n\torganizationEnvVars?: readonly string[];\n\tteamEnvVars?: readonly string[];\n\tworkspaceEnvVars?: readonly string[];\n\ttimeoutEnvVars?: readonly string[];\n\tmaxAttemptsEnvVars?: readonly string[];\n\tbaseUrlSuffixes?: readonly string[];\n\tdefaultTimeoutMs?: number;\n\tdefaultMaxAttempts?: number;\n\trequireBaseUrl?: boolean;\n\trequireOrganizationId?: boolean;\n\trequireToken?: boolean;\n}\n\nexport interface PlatformRequestOptions {\n\tserviceName: string;\n\tfailureMode: DownstreamFailureMode;\n\ttimeoutMs: number;\n\tmaxAttempts?: number;\n\tsignal?: AbortSignal;\n}\n\nconst SHARED_PLATFORM_BASE_URL_ENV_VARS = [\n\t\"MAESTRO_PLATFORM_BASE_URL\",\n\t\"MAESTRO_EVALOPS_BASE_URL\",\n\t\"EVALOPS_BASE_URL\",\n] as const;\n\nconst DEFAULT_TOKEN_ENV_VARS = [\n\t\"MAESTRO_EVALOPS_ACCESS_TOKEN\",\n\t\"EVALOPS_TOKEN\",\n] as const;\n\nconst DEFAULT_ORGANIZATION_ENV_VARS = [\n\t\"MAESTRO_EVALOPS_ORG_ID\",\n\t\"EVALOPS_ORGANIZATION_ID\",\n\t\"MAESTRO_ENTERPRISE_ORG_ID\",\n] as const;\n\nconst DEFAULT_TEAM_ENV_VARS = [\n\t\"MAESTRO_EVALOPS_TEAM_ID\",\n\t\"MAESTRO_LLM_GATEWAY_TEAM_ID\",\n] as const;\n\nexport function trimString(value: string | undefined): string | undefined {\n\tconst trimmed = value?.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nexport function getEnvValue(names: readonly string[]): string | undefined {\n\tfor (const name of names) {\n\t\tconst value = trimString(process.env[name]);\n\t\tif (value) {\n\t\t\treturn value;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nexport function parsePositiveInt(\n\tvalue: string | undefined,\n\tfallback: number,\n): number {\n\tconst parsed = Number.parseInt(value ?? \"\", 10);\n\treturn Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;\n}\n\nexport function normalizeBaseUrl(\n\tbaseUrl: string,\n\tsuffixes: readonly string[] = [],\n): string {\n\tlet normalized = baseUrl.trim().replace(/\\/+$/u, \"\");\n\tfor (const suffix of suffixes) {\n\t\tif (normalized.endsWith(suffix)) {\n\t\t\tnormalized = normalized.slice(0, -suffix.length).replace(/\\/+$/u, \"\");\n\t\t}\n\t}\n\treturn normalized;\n}\n\nexport function resolveOrganizationId(\n\tenvVars: readonly string[] = DEFAULT_ORGANIZATION_ENV_VARS,\n): string | undefined {\n\tconst envOrgId = getEnvValue(envVars);\n\tif (envOrgId) {\n\t\treturn envOrgId;\n\t}\n\tconst stored = loadOAuthCredentials(\"evalops\")?.metadata?.organizationId;\n\treturn typeof stored === \"string\" ? trimString(stored) : undefined;\n}\n\nexport function resolveTeamId(\n\tenvVars: readonly string[] = DEFAULT_TEAM_ENV_VARS,\n): string | undefined {\n\treturn getEnvValue(envVars);\n}\n\nexport function resolveWorkspaceId(\n\tenvVars: readonly string[] = DEFAULT_ORGANIZATION_ENV_VARS,\n): string | undefined {\n\treturn getEnvValue(envVars) ?? resolveOrganizationId();\n}\n\nexport function resolveConfiguredToken(\n\tenvVars: readonly string[] = DEFAULT_TOKEN_ENV_VARS,\n): string | undefined {\n\tconst envToken = getEnvValue(envVars);\n\tif (envToken) {\n\t\treturn envToken;\n\t}\n\tconst stored = loadOAuthCredentials(\"evalops\")?.access;\n\treturn typeof stored === \"string\" ? trimString(stored) : undefined;\n}\n\nexport async function resolvePlatformToken(\n\tenvVars: readonly string[] = DEFAULT_TOKEN_ENV_VARS,\n): Promise<string | undefined> {\n\treturn getEnvValue(envVars) ?? (await getOAuthToken(\"evalops\")) ?? undefined;\n}\n\nexport async function resolvePlatformServiceConfig(\n\toptions: ResolvePlatformServiceConfigOptions,\n): Promise<PlatformServiceConfig | null> {\n\tconst baseUrl = getEnvValue([\n\t\t...options.baseUrlEnvVars,\n\t\t...SHARED_PLATFORM_BASE_URL_ENV_VARS,\n\t]);\n\tif (!baseUrl && options.requireBaseUrl !== false) {\n\t\treturn null;\n\t}\n\n\tconst organizationId = resolveOrganizationId(options.organizationEnvVars);\n\tif (!organizationId && options.requireOrganizationId !== false) {\n\t\treturn null;\n\t}\n\n\tconst token = await resolvePlatformToken(options.tokenEnvVars);\n\tif (!token && options.requireToken !== false) {\n\t\treturn null;\n\t}\n\n\tconst workspaceId = options.workspaceEnvVars\n\t\t? resolveWorkspaceId(options.workspaceEnvVars)\n\t\t: organizationId;\n\n\treturn {\n\t\tbaseUrl: normalizeBaseUrl(baseUrl ?? \"\", options.baseUrlSuffixes),\n\t\t...(token ? { token } : {}),\n\t\t...(organizationId ? { organizationId } : {}),\n\t\tteamId: resolveTeamId(options.teamEnvVars),\n\t\t...(workspaceId ? { workspaceId } : {}),\n\t\ttimeoutMs: parsePositiveInt(\n\t\t\tgetEnvValue(options.timeoutEnvVars ?? []),\n\t\t\toptions.defaultTimeoutMs ?? DEFAULT_PLATFORM_TIMEOUT_MS,\n\t\t),\n\t\tmaxAttempts: parsePositiveInt(\n\t\t\tgetEnvValue(options.maxAttemptsEnvVars ?? []),\n\t\t\toptions.defaultMaxAttempts ?? DEFAULT_PLATFORM_MAX_ATTEMPTS,\n\t\t),\n\t};\n}\n\nfunction buildPlatformJsonHeaders(\n\tconfig: Pick<PlatformServiceConfig, \"organizationId\" | \"token\">,\n\textraHeaders?: Record<string, string | undefined>,\n): Record<string, string> {\n\treturn Object.fromEntries(\n\t\tObject.entries({\n\t\t\t...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),\n\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t...(config.organizationId\n\t\t\t\t? { \"X-Organization-ID\": config.organizationId }\n\t\t\t\t: {}),\n\t\t\t...(extraHeaders ?? {}),\n\t\t}).filter(\n\t\t\t(entry): entry is [string, string] =>\n\t\t\t\ttypeof entry[1] === \"string\" && entry[1].trim().length > 0,\n\t\t),\n\t);\n}\n\nexport function buildPlatformConnectHeaders(\n\tconfig: Pick<PlatformServiceConfig, \"organizationId\" | \"token\">,\n\textraHeaders?: Record<string, string | undefined>,\n): Record<string, string> {\n\treturn buildPlatformJsonHeaders(config, {\n\t\t\"Connect-Protocol-Version\": CONNECT_PROTOCOL_VERSION,\n\t\t...(extraHeaders ?? {}),\n\t});\n}\n\nexport async function postPlatformConnect(\n\tconfig: PlatformServiceConfig,\n\tpath: string,\n\tbody: Record<string, unknown>,\n\toptions: PlatformRequestOptions,\n\theaders?: Record<string, string | undefined>,\n): Promise<Response> {\n\treturn fetchDownstream(\n\t\t`${config.baseUrl}${path}`,\n\t\t{\n\t\t\tmethod: \"POST\",\n\t\t\theaders: buildPlatformConnectHeaders(config, headers),\n\t\t\tbody: JSON.stringify(body),\n\t\t\tsignal: options.signal,\n\t\t},\n\t\t{\n\t\t\tserviceName: options.serviceName,\n\t\t\tfailureMode: options.failureMode,\n\t\t\ttimeoutMs: options.timeoutMs,\n\t\t\tmaxAttempts: options.maxAttempts,\n\t\t},\n\t);\n}\n"]}