@ouro.bot/cli 0.1.0-alpha.210 → 0.1.0-alpha.212

package/dist/mind/diary.js

@@ -43,44 +43,14 @@ exports.searchDiaryEntries = searchDiaryEntries;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const crypto_1 = require("crypto");
-const config_1 = require("../heart/config");
 const identity_1 = require("../heart/identity");
 const runtime_1 = require("../nerves/runtime");
 const sync_1 = require("../heart/sync");
 const associative_recall_1 = require("./associative-recall");
+const embedding_provider_1 = require("./embedding-provider");
 const DEDUP_THRESHOLD = 0.6;
 const SEMANTIC_DEDUP_THRESHOLD = 0.95;
 const ENTITY_TOKEN = /[a-z0-9]+/g;
-const DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
-class OpenAIEmbeddingProvider {
-    apiKey;
-    model;
-    constructor(apiKey, model = DEFAULT_EMBEDDING_MODEL) {
-        this.apiKey = apiKey;
-        this.model = model;
-    }
-    async embed(texts) {
-        const response = await fetch("https://api.openai.com/v1/embeddings", {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${this.apiKey}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({
-                model: this.model,
-                input: texts,
-            }),
-        });
-        if (!response.ok) {
-            throw new Error(`embedding request failed: ${response.status} ${response.statusText}`);
-        }
-        const payload = (await response.json());
-        if (!payload.data || payload.data.length !== texts.length) {
-            throw new Error("embedding response missing expected vectors");
-        }
-        return payload.data.map((entry) => entry.embedding);
-    }
-}
 function ensureDiaryStorePaths(rootDir) {
     const factsPath = path.join(rootDir, "facts.jsonl");
     const entitiesPath = path.join(rootDir, "entities.json");
@@ -219,14 +189,8 @@ function appendEntriesWithDedup(stores, incoming, options) {
     });
     return { added, skipped };
 }
-function createDefaultEmbeddingProvider() {
-    const apiKey = (0, config_1.getOpenAIEmbeddingsApiKey)().trim();
-    if (!apiKey)
-        return null;
-    return new OpenAIEmbeddingProvider(apiKey);
-}
 async function buildEmbedding(text, embeddingProvider) {
-    const provider = embeddingProvider ?? createDefaultEmbeddingProvider();
+    const provider = embeddingProvider ?? (0, embedding_provider_1.createDefaultEmbeddingProvider)();
     if (!provider) {
         (0, runtime_1.emitNervesEvent)({
             level: "warn",
@@ -287,7 +251,7 @@ async function backfillEmbeddings(options) {
     const needsEmbedding = facts.filter((f) => !Array.isArray(f.embedding) || f.embedding.length === 0);
     if (needsEmbedding.length === 0)
         return { total: facts.length, backfilled: 0, failed: 0 };
-    const provider = options?.embeddingProvider ?? createDefaultEmbeddingProvider();
+    const provider = options?.embeddingProvider ?? (0, embedding_provider_1.createDefaultEmbeddingProvider)();
     if (!provider) {
         (0, runtime_1.emitNervesEvent)({
             level: "warn",
@@ -364,7 +328,7 @@ async function searchDiaryEntries(query, facts, embeddingProvider) {
     if (embeddedFacts.length === 0) {
         return substringFallback();
     }
-    const provider = embeddingProvider ?? createDefaultEmbeddingProvider();
+    const provider = embeddingProvider ?? (0, embedding_provider_1.createDefaultEmbeddingProvider)();
     if (!provider) {
         return substringFallback();
     }

package/dist/mind/embedding-provider.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Shared OpenAI embedding provider.
+ *
+ * Both diary.ts and associative-recall.ts need to call the OpenAI embeddings
+ * API. This module provides the shared implementation so neither duplicates
+ * the fetch logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIEmbeddingProvider = void 0;
+exports.createDefaultEmbeddingProvider = createDefaultEmbeddingProvider;
+const config_1 = require("../heart/config");
+const runtime_1 = require("../nerves/runtime");
+const DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
+class OpenAIEmbeddingProvider {
+    apiKey;
+    model;
+    constructor(apiKey, model = DEFAULT_EMBEDDING_MODEL) {
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    async embed(texts) {
+        const response = await fetch("https://api.openai.com/v1/embeddings", {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                model: this.model,
+                input: texts,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`embedding request failed: ${response.status} ${response.statusText}`);
+        }
+        const payload = (await response.json());
+        if (!payload.data || payload.data.length !== texts.length) {
+            throw new Error("embedding response missing expected vectors");
+        }
+        return payload.data.map((entry) => entry.embedding);
+    }
+}
+exports.OpenAIEmbeddingProvider = OpenAIEmbeddingProvider;
+/**
+ * Create a default embedding provider from the configured API key.
+ * Returns null if no key is configured.
+ */
+function createDefaultEmbeddingProvider() {
+    const apiKey = (0, config_1.getOpenAIEmbeddingsApiKey)().trim();
+    if (!apiKey)
+        return null;
+    (0, runtime_1.emitNervesEvent)({
+        component: "mind",
+        event: "mind.embedding_provider_created",
+        message: "default embedding provider created",
+        meta: { model: DEFAULT_EMBEDDING_MODEL },
+    });
+    return new OpenAIEmbeddingProvider(apiKey);
+}

package/dist/nerves/coverage/file-completeness.js

@@ -61,6 +61,11 @@ const DISPATCH_EXEMPT_PATTERNS = [
     // cli-parse and cli-render are pure functions with no side effects.
     "daemon/cli-parse",
     "daemon/cli-render",
+    // Shared utility modules: pure helpers consumed by modules that own observability.
+    "arc/json-store",
+    "repertoire/api-client",
+    "repertoire/github-client",
+    "mind/embedding-provider",
 ];
 function isDispatchExempt(filePath) {
     return DISPATCH_EXEMPT_PATTERNS.some((pattern) => filePath.includes(pattern));

package/dist/repertoire/ado-client.js

@@ -9,6 +9,7 @@ exports.discoverOrganizations = discoverOrganizations;
 exports.discoverProjects = discoverProjects;
 const api_error_1 = require("../heart/api-error");
 const runtime_1 = require("../nerves/runtime");
+const api_client_1 = require("./api-client");
 const ADO_BASE = "https://dev.azure.com";
 const VSSPS_BASE = "https://app.vssps.visualstudio.com";
 const DEFAULT_API_VERSION = "api-version=7.1";
@@ -30,62 +31,20 @@ function resolveContentType(method, path) {
 // Generic ADO API request. Returns response body as pretty-printed JSON string.
 // `host` overrides the base URL for non-standard APIs (e.g. "vsapm.dev.azure.com", "vssps.dev.azure.com").
 async function adoRequest(token, method, org, path, body, host) {
-    try {
-        const base = host ? `https://${host}/${org}` : `${ADO_BASE}/${org}`;
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_start",
-            component: "clients",
-            message: "starting ADO request",
-            meta: { client: "ado", method, org, path },
-        });
-        const fullPath = ensureApiVersion(path);
-        const url = `${base}${fullPath}`;
-        const contentType = resolveContentType(method, path);
-        const opts = {
-            method,
-            headers: {
-                Authorization: `Bearer ${token}`,
-                "Content-Type": contentType,
-            },
-        };
-        if (body)
-            opts.body = body;
-        const res = await fetch(url, opts);
-        if (!res.ok) {
-            (0, runtime_1.emitNervesEvent)({
-                level: "error",
-                event: "client.error",
-                component: "clients",
-                message: "ADO request failed",
-                meta: { client: "ado", method, org, path, status: res.status },
-            });
-            return (0, api_error_1.handleApiError)(res, "ADO", "ado");
-        }
-        const data = await res.json();
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_end",
-            component: "clients",
-            message: "ADO request completed",
-            meta: { client: "ado", method, org, path, success: true },
-        });
-        return JSON.stringify(data, null, 2);
-    }
-    catch (err) {
-        (0, runtime_1.emitNervesEvent)({
-            level: "error",
-            event: "client.error",
-            component: "clients",
-            message: "ADO request threw exception",
-            meta: {
-                client: "ado",
-                method,
-                org,
-                path,
-                reason: err instanceof Error ? err.message : String(err),
-            },
-        });
-        return (0, api_error_1.handleApiError)(err, "ADO", "ado");
-    }
+    const base = host ? `https://${host}/${org}` : `${ADO_BASE}/${org}`;
+    const fullPath = ensureApiVersion(path);
+    return (0, api_client_1.apiRequest)({
+        baseUrl: base,
+        method,
+        path: fullPath,
+        token,
+        clientName: "ado",
+        serviceLabel: "ADO",
+        connectionName: "ado",
+        body,
+        contentType: resolveContentType(method, path),
+        eventMeta: { org },
+    });
 }
 // Backward-compatible thin wrapper: runs WIQL query and returns formatted work items.
 async function queryWorkItems(token, org, query) {

package/dist/repertoire/api-client.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Shared HTTP API client for Graph, ADO, and GitHub clients.
+ *
+ * All three API clients follow the same pattern: emit request_start event,
+ * build request with auth header, fetch, handle errors, emit request_end,
+ * and return pretty-printed JSON. This module extracts that shared logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiRequest = apiRequest;
+const api_error_1 = require("../heart/api-error");
+const runtime_1 = require("../nerves/runtime");
+/**
+ * Execute an authenticated API request with standard logging and error handling.
+ * Returns the response body as a pretty-printed JSON string.
+ */
+async function apiRequest(options) {
+    const { baseUrl, method, path, token, clientName, serviceLabel, connectionName, body, extraHeaders, contentType, eventMeta, } = options;
+    try {
+        (0, runtime_1.emitNervesEvent)({
+            event: "client.request_start",
+            component: "clients",
+            message: `starting ${serviceLabel} request`,
+            meta: { client: clientName, method, path, ...eventMeta },
+        });
+        const url = `${baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": contentType ?? "application/json",
+            ...extraHeaders,
+        };
+        const opts = { method, headers };
+        if (body)
+            opts.body = body;
+        const res = await fetch(url, opts);
+        if (!res.ok) {
+            (0, runtime_1.emitNervesEvent)({
+                level: "error",
+                event: "client.error",
+                component: "clients",
+                message: `${serviceLabel} request failed`,
+                meta: { client: clientName, method, path, status: res.status, ...eventMeta },
+            });
+            return (0, api_error_1.handleApiError)(res, serviceLabel, connectionName);
+        }
+        const data = await res.json();
+        (0, runtime_1.emitNervesEvent)({
+            event: "client.request_end",
+            component: "clients",
+            message: `${serviceLabel} request completed`,
+            meta: { client: clientName, method, path, success: true, ...eventMeta },
+        });
+        return JSON.stringify(data, null, 2);
+    }
+    catch (err) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "error",
+            event: "client.error",
+            component: "clients",
+            message: `${serviceLabel} request threw exception`,
+            meta: {
+                client: clientName,
+                method,
+                path,
+                reason: err instanceof Error ? err.message : String(err),
+                ...eventMeta,
+            },
+        });
+        return (0, api_error_1.handleApiError)(err, serviceLabel, connectionName);
+    }
+}

package/dist/repertoire/github-client.js

@@ -3,62 +3,21 @@
 // Provides a generic githubRequest() for arbitrary GitHub REST API endpoints.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.githubRequest = githubRequest;
-const api_error_1 = require("../heart/api-error");
-const runtime_1 = require("../nerves/runtime");
+const api_client_1 = require("./api-client");
 const GITHUB_BASE = "https://api.github.com";
 // Generic GitHub API request. Returns response body as pretty-printed JSON string.
 async function githubRequest(token, method, path, body) {
-    try {
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_start",
-            component: "clients",
-            message: "starting GitHub request",
-            meta: { client: "github", method, path },
-        });
-        const url = `${GITHUB_BASE}${path}`;
-        const opts = {
-            method,
-            headers: {
-                Authorization: `Bearer ${token}`,
-                Accept: "application/vnd.github+json",
-                "Content-Type": "application/json",
-            },
-        };
-        if (body)
-            opts.body = body;
-        const res = await fetch(url, opts);
-        if (!res.ok) {
-            (0, runtime_1.emitNervesEvent)({
-                level: "error",
-                event: "client.error",
-                component: "clients",
-                message: "GitHub request failed",
-                meta: { client: "github", method, path, status: res.status },
-            });
-            return (0, api_error_1.handleApiError)(res, "GitHub", "github");
-        }
-        const data = await res.json();
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_end",
-            component: "clients",
-            message: "GitHub request completed",
-            meta: { client: "github", method, path, success: true },
-        });
-        return JSON.stringify(data, null, 2);
-    }
-    catch (err) {
-        (0, runtime_1.emitNervesEvent)({
-            level: "error",
-            event: "client.error",
-            component: "clients",
-            message: "GitHub request threw exception",
-            meta: {
-                client: "github",
-                method,
-                path,
-                reason: err instanceof Error ? err.message : String(err),
-            },
-        });
-        return (0, api_error_1.handleApiError)(err, "GitHub", "github");
-    }
+    return (0, api_client_1.apiRequest)({
+        baseUrl: GITHUB_BASE,
+        method,
+        path,
+        token,
+        clientName: "github",
+        serviceLabel: "GitHub",
+        connectionName: "github",
+        body,
+        extraHeaders: {
+            Accept: "application/vnd.github+json",
+        },
+    });
 }

package/dist/repertoire/graph-client.js

@@ -7,61 +7,20 @@ exports.graphRequest = graphRequest;
 exports.getProfile = getProfile;
 const api_error_1 = require("../heart/api-error");
 const runtime_1 = require("../nerves/runtime");
+const api_client_1 = require("./api-client");
 const GRAPH_BASE = "https://graph.microsoft.com/v1.0";
 // Generic Graph API request. Returns response body as pretty-printed JSON string.
 async function graphRequest(token, method, path, body) {
-    try {
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_start",
-            component: "clients",
-            message: "starting Graph request",
-            meta: { client: "graph", method, path },
-        });
-        const url = `${GRAPH_BASE}${path}`;
-        const opts = {
-            method,
-            headers: {
-                Authorization: `Bearer ${token}`,
-                "Content-Type": "application/json",
-            },
-        };
-        if (body)
-            opts.body = body;
-        const res = await fetch(url, opts);
-        if (!res.ok) {
-            (0, runtime_1.emitNervesEvent)({
-                level: "error",
-                event: "client.error",
-                component: "clients",
-                message: "Graph request failed",
-                meta: { client: "graph", method, path, status: res.status },
-            });
-            return (0, api_error_1.handleApiError)(res, "Graph", "graph");
-        }
-        const data = await res.json();
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_end",
-            component: "clients",
-            message: "Graph request completed",
-            meta: { client: "graph", method, path, success: true },
-        });
-        return JSON.stringify(data, null, 2);
-    }
-    catch (err) {
-        (0, runtime_1.emitNervesEvent)({
-            level: "error",
-            event: "client.error",
-            component: "clients",
-            message: "Graph request threw exception",
-            meta: {
-                client: "graph",
-                method,
-                path,
-                reason: err instanceof Error ? err.message : String(err),
-            },
-        });
-        return (0, api_error_1.handleApiError)(err, "Graph", "graph");
-    }
+    return (0, api_client_1.apiRequest)({
+        baseUrl: GRAPH_BASE,
+        method,
+        path,
+        token,
+        clientName: "graph",
+        serviceLabel: "Graph",
+        connectionName: "graph",
+        body,
+    });
 }
 // Backward-compatible thin wrapper: fetches /me and formats as human-readable text.
 async function getProfile(token) {

package/dist/senses/{bluebubbles-client.js → bluebubbles/client.js}

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBlueBubblesClient = createBlueBubblesClient;
 const node_crypto_1 = require("node:crypto");
-const config_1 = require("../heart/config");
-const identity_1 = require("../heart/identity");
-const runtime_1 = require("../nerves/runtime");
-const bluebubbles_model_1 = require("./bluebubbles-model");
-const bluebubbles_media_1 = require("./bluebubbles-media");
+const config_1 = require("../../heart/config");
+const identity_1 = require("../../heart/identity");
+const runtime_1 = require("../../nerves/runtime");
+const model_1 = require("./model");
+const media_1 = require("./media");
 function buildBlueBubblesApiUrl(baseUrl, endpoint, password) {
     const root = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
     const url = new URL(endpoint.replace(/^\//, ""), root);
@@ -423,13 +423,13 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
                     });
                     return repaired;
                 }
-                const normalized = (0, bluebubbles_model_1.normalizeBlueBubblesEvent)({
+                const normalized = (0, model_1.normalizeBlueBubblesEvent)({
                     type: event.eventType,
                     data,
                 });
                 const recoveredMessage = event.kind === "mutation"
                     && !event.shouldNotifyAgent
-                    ? (0, bluebubbles_model_1.normalizeBlueBubblesEvent)({
+                    ? (0, model_1.normalizeBlueBubblesEvent)({
                         type: "new-message",
                         data,
                     })
@@ -440,7 +440,7 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
                 if (hydrated.kind === "message" &&
                     hydrated.balloonBundleId !== "com.apple.messages.URLBalloonProvider" &&
                     hydrated.attachments.length > 0) {
-                    const media = await (0, bluebubbles_media_1.hydrateBlueBubblesAttachments)(hydrated.attachments, config, channelConfig, {
+                    const media = await (0, media_1.hydrateBlueBubblesAttachments)(hydrated.attachments, config, channelConfig, {
                         preferAudioInput: providerSupportsAudioInput((0, identity_1.loadAgentConfig)().humanFacing.provider),
                     });
                     const transcriptSuffix = media.transcriptAdditions.map((entry) => `[${entry}]`).join("\n");

package/dist/senses/{bluebubbles-entry.js → bluebubbles/entry.js}

@@ -1,13 +1,13 @@
 "use strict";
-// Thin entrypoint for `npm run bluebubbles` / `node dist/senses/bluebubbles-entry.js --agent <name>`.
-// Separated from bluebubbles.ts so the BlueBubbles adapter stays testable.
+// Thin entrypoint for `npm run bluebubbles` / `node dist/senses/bluebubbles/entry.js --agent <name>`.
+// Separated from index.ts so the BlueBubbles adapter stays testable.
 Object.defineProperty(exports, "__esModule", { value: true });
 if (!process.argv.includes("--agent")) {
     // eslint-disable-next-line no-console -- pre-boot guard: --agent check before imports
-    console.error("Missing required --agent <name> argument.\nUsage: node dist/senses/bluebubbles-entry.js --agent ouroboros");
+    console.error("Missing required --agent <name> argument.\nUsage: node dist/senses/bluebubbles/entry.js --agent ouroboros");
     process.exit(1);
 }
-const bluebubbles_1 = require("./bluebubbles");
-const runtime_logging_1 = require("../heart/daemon/runtime-logging");
+const index_1 = require("./index");
+const runtime_logging_1 = require("../../heart/daemon/runtime-logging");
 (0, runtime_logging_1.configureDaemonRuntimeLogger)("bluebubbles");
-(0, bluebubbles_1.startBlueBubblesApp)();
+(0, index_1.startBlueBubblesApp)();

package/dist/senses/{bluebubbles-inbound-log.js → bluebubbles/inbound-log.js}

@@ -38,9 +38,9 @@ exports.hasRecordedBlueBubblesInbound = hasRecordedBlueBubblesInbound;
 exports.recordBlueBubblesInbound = recordBlueBubblesInbound;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
-const config_1 = require("../heart/config");
-const identity_1 = require("../heart/identity");
-const runtime_1 = require("../nerves/runtime");
+const config_1 = require("../../heart/config");
+const identity_1 = require("../../heart/identity");
+const runtime_1 = require("../../nerves/runtime");
 function getBlueBubblesInboundLogPath(agentName, sessionKey) {
     return path.join((0, identity_1.getAgentRoot)(agentName), "state", "senses", "bluebubbles", "inbound", `${(0, config_1.sanitizeKey)(sessionKey)}.ndjson`);
 }