@oscharko-dev/keiko-server 0.2.0 → 0.2.2

package/dist/local-knowledge-handlers.js

@@ -1,7 +1,7 @@
 import { createHash, randomUUID } from "node:crypto";
 import { statSync } from "node:fs";
 import { basename, dirname } from "node:path";
-import { addSourceToCapsule, checkpointToProgress, composeCapsules, CompositionError, createSqliteAuditSink, createDefaultParserRegistry, createCapsule, deleteCapsule, getCapsule, listCapsuleSets, listCapsuleSources, listCapsules, listExtractionCheckpoints, listResumableDocuments, openKnowledgeStore, removeSourceFromCapsule, resolveKnowledgeStorePath, runIndexingJob, updateCapsuleDetails, updateCapsuleState, } from "@oscharko-dev/keiko-local-knowledge";
+import { addSourceToCapsule, checkpointToProgress, composeCapsules, CompositionError, createSqliteAuditSink, createDefaultParserRegistry, createCapsule, deleteCapsule, getCapsule, listCapsuleSets, listCapsuleSources, listCapsules, listExtractionCheckpoints, listResumableDocuments, openKnowledgeStore, removeSourceFromCapsule, resolveKnowledgeStorePath, runIndexingJob, updateCapsuleEmbeddingModelIdentity, updateCapsuleDetails, updateCapsuleState, } from "@oscharko-dev/keiko-local-knowledge";
 import { KnowledgeNotFoundError, KnowledgeStoreError } from "@oscharko-dev/keiko-local-knowledge";
 import { localKnowledgeProtectionOptions } from "./localKnowledgeKeyProvider.js";
 import { CAPSULE_SET_MAX_MEMBERS, DEFAULT_EXTRACTION_CAPABILITY_AVAILABILITY, DEFAULT_LARGE_DOCUMENT_RESOURCE_POLICY, isSafeDisplaySummary, isSafeQualityWarning, validateCapsuleReindexRequest, validateKnowledgeSourceScope, } from "@oscharko-dev/keiko-contracts";
@@ -218,6 +218,52 @@ function configuredProviderForCapsule(deps, capsule) {
         ? provider
         : undefined;
 }
+function embeddingIdentityMatchesCapsuleAlias(stored, current) {
+    if (stored.provider !== current.provider ||
+        stored.vectorDimensions !== current.vectorDimensions ||
+        stored.vectorMetric !== current.vectorMetric) {
+        return false;
+    }
+    if (stored.modelId === current.modelId) {
+        return true;
+    }
+    return current.modelRevision !== undefined && stored.modelId === current.modelRevision;
+}
+async function probeConfiguredProviderForCapsule(deps, provider, capsule) {
+    const adapter = createEmbeddingAdapter(provider, requestEmbeddingImpl(deps), requestEmbeddingBatchImpl(deps));
+    try {
+        const result = await verifyEmbeddingCapability(adapter, {
+            modelId: provider.modelId,
+            provider: embeddingProviderIdentity(provider),
+            vectorMetric: capsule.embeddingModelIdentity.vectorMetric,
+            expectedDimensions: capsule.embeddingModelIdentity.vectorDimensions,
+            timeoutMs: provider.timeoutMs,
+        });
+        return result.ok ? result.identity : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function resolveIndexingProviderForCapsule(deps, store, capsule) {
+    const exact = configuredProviderForCapsule(deps, capsule);
+    if (exact !== undefined) {
+        return { capsule, provider: exact };
+    }
+    const providers = configuredEmbeddingProviders(currentGatewayConfig(deps));
+    for (const provider of providers) {
+        if (!storedProviderMatchesConfiguredProvider(capsule.embeddingModelIdentity.provider, provider)) {
+            continue;
+        }
+        const identity = await probeConfiguredProviderForCapsule(deps, provider, capsule);
+        if (identity !== undefined &&
+            embeddingIdentityMatchesCapsuleAlias(capsule.embeddingModelIdentity, identity)) {
+            const repaired = updateCapsuleEmbeddingModelIdentity(store, capsule.id, identity);
+            return { capsule: repaired, provider };
+        }
+    }
+    return undefined;
+}
 function embeddingCompatibilityReason(config, capsule) {
     if (config === undefined)
         return undefined;
@@ -656,10 +702,19 @@ function storedProviderMatchesConfiguredProvider(storedProvider, provider) {
 // Issue #621 / #677: select the first provider whose resolved capability is embedding-capable.
 // Falling back to a chat model creates capsules that can never index successfully.
 export function selectEmbeddingModelId(config) {
+    return configuredEmbeddingModelIds(config)[0];
+}
+export function configuredEmbeddingModelIds(config) {
     if (config === undefined || config === null || config.providers.length === 0)
-        return undefined;
-    return config.providers.find((provider) => isConfiguredEmbeddingModel(config, provider.modelId))
-        ?.modelId;
+        return [];
+    return config.providers
+        .filter((provider) => isConfiguredEmbeddingModel(config, provider.modelId))
+        .map((provider) => provider.modelId);
+}
+export function configuredEmbeddingProviders(config) {
+    if (config === undefined || config.providers.length === 0)
+        return [];
+    return config.providers.filter((provider) => isConfiguredEmbeddingModel(config, provider.modelId));
 }
 function createCapsuleStorageReference(capsuleId) {
     return `capsules/${capsuleId}`;
@@ -687,21 +742,28 @@ async function verifiedNewCapsuleEmbeddingIdentity(deps, provider) {
 }
 async function resolveNewCapsuleEmbeddingIdentity(deps) {
     const config = currentGatewayConfig(deps);
-    const configuredModelId = selectEmbeddingModelId(config);
-    if (configuredModelId === undefined) {
+    const providers = configuredEmbeddingProviders(config);
+    if (providers.length === 0) {
         return {
             ok: false,
             result: conflict("No configured embedding-capable model is available for new capsules. Configure the Model Gateway first."),
         };
     }
-    const provider = configuredEmbeddingProvider(config, configuredModelId);
-    if (provider === undefined) {
-        return {
-            ok: false,
-            result: conflict("No configured embedding-capable model is available for new capsules. Configure the Model Gateway first."),
-        };
+    let lastFailure;
+    for (const provider of providers) {
+        const verified = await verifiedNewCapsuleEmbeddingIdentity(deps, provider);
+        if (verified.ok) {
+            return verified;
+        }
+        lastFailure = verified.result;
     }
-    return verifiedNewCapsuleEmbeddingIdentity(deps, provider);
+    if (lastFailure !== undefined) {
+        return { ok: false, result: lastFailure };
+    }
+    return {
+        ok: false,
+        result: conflict("No configured embedding-capable model is available for new capsules. Configure the Model Gateway first."),
+    };
 }
 function latestRunningJobId(store, capsuleId) {
     const row = store._internal.db
@@ -764,6 +826,9 @@ function indexingCompletionResponse(capsuleId, terminal, failedMessage) {
     }
     return actionResponse(capsuleId);
 }
+function runningIndexingJobConflict(capsuleId, runningJobId) {
+    return indexingConflict("indexing-already-running", "An indexing job is already running for this capsule.", capsuleId, runningJobId);
+}
 function buildIndexingOptions(store, capsule, adapter, options, sourceSelection, signal) {
     return {
         capsuleId: capsule.id,
@@ -1058,21 +1123,22 @@ export async function handleStartLocalKnowledgeCapsuleIndexing(ctx, deps) {
             if (capsule.sourceIds.length === 0) {
                 return emptyCapsuleIndexingConflict();
             }
-            if (configuredProviderForCapsule(deps, capsule) === undefined) {
+            const resolved = await resolveIndexingProviderForCapsule(deps, env.store, capsule);
+            if (resolved === undefined) {
                 return conflict("No configured embedding-capable model matches this capsule. Update the Model Gateway configuration before indexing it.");
             }
             // LK-003 (Epic #189): refuse to start a second concurrent indexer for the same
             // capsule — the orchestrator persists running jobs, so a duplicate POST would
             // race the in-flight one and corrupt vector counts.
-            const runningJobId = latestRunningJobId(env.store, capsule.id);
+            const runningJobId = latestRunningJobId(env.store, resolved.capsule.id);
             if (runningJobId !== undefined) {
-                return indexingConflict("indexing-already-running", "An indexing job is already running for this capsule.", capsule.id, runningJobId);
+                return runningIndexingJobConflict(resolved.capsule.id, runningJobId);
             }
-            const terminal = await runCapsuleIndexingJob(deps, env.store, capsule, {
+            const terminal = await runCapsuleIndexingJob(deps, env.store, resolved.capsule, {
                 mode: undefined,
                 force: false,
             });
-            return indexingCompletionResponse(capsule.id, terminal, "Capsule indexing failed. Review the capsule health diagnostics and job history for details.");
+            return indexingCompletionResponse(resolved.capsule.id, terminal, "Capsule indexing failed. Review the capsule health diagnostics and job history for details.");
         }
         finally {
             env.close();
@@ -1264,19 +1330,20 @@ export async function handleReindexLocalKnowledgeCapsule(ctx, deps) {
             if (capsule.sourceIds.length === 0) {
                 return emptyCapsuleIndexingConflict();
             }
-            if (configuredProviderForCapsule(deps, capsule) === undefined) {
+            const resolved = await resolveIndexingProviderForCapsule(deps, env.store, capsule);
+            if (resolved === undefined) {
                 return conflict("No configured embedding-capable model matches this capsule. Update the Model Gateway configuration before refreshing it.");
             }
             // LK-003 (Epic #189): same concurrent-run guard as the start handler.
-            const runningJobId = latestRunningJobId(env.store, capsule.id);
+            const runningJobId = latestRunningJobId(env.store, resolved.capsule.id);
             if (runningJobId !== undefined) {
-                return indexingConflict("indexing-already-running", "An indexing job is already running for this capsule.", capsule.id, runningJobId);
+                return runningIndexingJobConflict(resolved.capsule.id, runningJobId);
             }
-            const terminal = await runCapsuleIndexingJob(deps, env.store, capsule, {
+            const terminal = await runCapsuleIndexingJob(deps, env.store, resolved.capsule, {
                 mode,
                 force,
             });
-            return indexingCompletionResponse(capsule.id, terminal, "Capsule refresh failed. Review the capsule health diagnostics and job history for details.");
+            return indexingCompletionResponse(resolved.capsule.id, terminal, "Capsule refresh failed. Review the capsule health diagnostics and job history for details.");
         }
         finally {
             env.close();

package/dist/memory-embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-embedding.d.ts","sourceRoot":"","sources":["../src/memory-embedding.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,aAAa,EAGlB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAEV,QAAQ,EACR,YAAY,EAEb,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAIrE,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,MAAM,GAAG,SAAS,CAEpB;AAyDD,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;AAKpF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,WAAW,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,sBAAsB,CAAC,GAChF,cAAc,GAAG,IAAI,CAuBvB;AAKD,wBAAsB,eAAe,CACnC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAItC;AAKD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAQf;AAKD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAgBzE;AAiBD,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAKpD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,oBAAoB,GAAG,IAAI,EACtC,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EACpD,SAAS,GAAE,MAAwC,GAClD,QAAQ,GAAG,IAAI,CAYjB;AAeD,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAGlD,eAAO,MAAM,cAAc,IAAI,CAAC;AAMhC,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,oBAAoB,GAAG,IAAI,EACtC,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EACpD,KAAK,GAAE,MAAsC,EAC7C,KAAK,GAAE,MAAwC,EAC/C,QAAQ,GAAE,MAAuB,GAChC,SAAS,QAAQ,EAAE,CAWrB;AA+CD,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAEvC,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAC;CACtC;AAOD,wBAAsB,mCAAmC,CACvD,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAoB9B"}
+{"version":3,"file":"memory-embedding.d.ts","sourceRoot":"","sources":["../src/memory-embedding.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,aAAa,EAGlB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAEV,QAAQ,EACR,YAAY,EAEb,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAOrE,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,MAAM,GAAG,SAAS,CAEpB;AAkDD,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;AAKpF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,WAAW,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,sBAAsB,CAAC,GAChF,cAAc,GAAG,IAAI,CAyBvB;AAKD,wBAAsB,eAAe,CACnC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAItC;AAKD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAQf;AAKD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAgBzE;AAiBD,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAKpD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,oBAAoB,GAAG,IAAI,EACtC,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EACpD,SAAS,GAAE,MAAwC,GAClD,QAAQ,GAAG,IAAI,CAYjB;AAeD,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAGlD,eAAO,MAAM,cAAc,IAAI,CAAC;AAMhC,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,oBAAoB,GAAG,IAAI,EACtC,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EACpD,KAAK,GAAE,MAAsC,EAC7C,KAAK,GAAE,MAAwC,EAC/C,QAAQ,GAAE,MAAuB,GAChC,SAAS,QAAQ,EAAE,CAWrB;AA+CD,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAEvC,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAC;CACtC;AAOD,wBAAsB,mCAAmC,CACvD,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAoB9B"}

package/dist/memory-embedding.js

@@ -16,14 +16,11 @@
 import { requestOpenAIEmbedding, } from "@oscharko-dev/keiko-model-gateway";
 import { randomUUID } from "node:crypto";
 import { currentGatewayConfig } from "./deps.js";
-import { selectEmbeddingModelId } from "./local-knowledge-handlers.js";
+import { configuredEmbeddingProviders, selectEmbeddingModelId, } from "./local-knowledge-handlers.js";
 const MEMORY_VECTOR_METRIC = "cosine";
 export function selectMemoryEmbeddingModelId(config) {
     return selectEmbeddingModelId(config);
 }
-function providerForModel(config, modelId) {
-    return config?.providers.find((provider) => provider.modelId === modelId);
-}
 function requestEmbeddingImpl(deps) {
     // Reuses the same gateway seam as Local Knowledge so a single injected adapter drives both.
     return deps.localKnowledgeEmbeddingRequest ?? requestOpenAIEmbedding;
@@ -62,32 +59,33 @@ function toEmbeddingInput(provider, outcome) {
 // configured (or its provider is absent). The CLI backfill and the conversation paths both compose
 // through this single factory so capability-aware model selection lives in one place.
 export function createMemoryEmbedder(config, requestImpl) {
-    const modelId = selectMemoryEmbeddingModelId(config);
-    if (modelId === undefined)
-        return null;
-    const provider = providerForModel(config, modelId);
-    if (provider === undefined)
+    const providers = configuredEmbeddingProviders(config);
+    if (providers.length === 0)
         return null;
-    const adapter = buildAdapter(provider, requestImpl);
+    const candidates = providers.map((provider) => ({
+        provider,
+        adapter: buildAdapter(provider, requestImpl),
+    }));
     return async (text) => {
         if (text.length === 0)
             return null;
-        try {
-            const outcome = await adapter.request({
-                endpoint: provider.baseUrl,
-                apiKey: provider.apiKey,
-                modelId,
-                input: text,
-                ...(provider.egress !== undefined ? { egress: provider.egress } : {}),
-            });
-            if (!outcome.ok)
-                return null;
-            return toEmbeddingInput("openai", outcome);
-        }
-        catch {
-            // Model/transport boundary: a thrown adapter must degrade to "no embedding", never crash.
-            return null;
+        for (const { provider, adapter } of candidates) {
+            try {
+                const outcome = await adapter.request({
+                    endpoint: provider.baseUrl,
+                    apiKey: provider.apiKey,
+                    modelId: provider.modelId,
+                    input: text,
+                    ...(provider.egress !== undefined ? { egress: provider.egress } : {}),
+                });
+                if (outcome.ok)
+                    return toEmbeddingInput("openai", outcome);
+            }
+            catch {
+                // Model/transport boundary: a thrown adapter degrades to the next embedding provider.
+            }
         }
+        return null;
     };
 }
 // Embeds `text` against the configured embedding model. Returns null when no embedding-capable

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oscharko-dev/keiko-server",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Internal server package: local loopback BFF runtime (HTTP/SSE/WebSocket router, CSP, host check, CSRF gate, terminal, browser, files, run engine, SQLite-backed UI store) that mediates the browser presentation tier and the Node-side domain packages (ADR-0019). Not published independently.",
@@ -29,24 +29,24 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@oscharko-dev/keiko-contracts": "0.2.0",
-    "@oscharko-dev/keiko-security": "0.2.0",
-    "@oscharko-dev/keiko-model-gateway": "0.2.0",
-    "@oscharko-dev/keiko-quality-intelligence": "0.2.0",
-    "@oscharko-dev/keiko-local-knowledge": "0.2.0",
-    "@oscharko-dev/keiko-workspace": "0.2.0",
-    "@oscharko-dev/keiko-sandbox": "0.2.0",
-    "@oscharko-dev/keiko-tools": "0.2.0",
-    "@oscharko-dev/keiko-evidence": "0.2.0",
-    "@oscharko-dev/keiko-verification": "0.2.0",
-    "@oscharko-dev/keiko-harness": "0.2.0",
-    "@oscharko-dev/keiko-sdk": "0.2.0",
-    "@oscharko-dev/keiko-workflows": "0.2.0",
-    "@oscharko-dev/keiko-memory-vault": "0.2.0",
-    "@oscharko-dev/keiko-memory-governance": "0.2.0",
-    "@oscharko-dev/keiko-memory-retrieval": "0.2.0",
-    "@oscharko-dev/keiko-memory-capture": "0.2.0",
-    "@oscharko-dev/keiko-memory-consolidation": "0.2.0",
+    "@oscharko-dev/keiko-contracts": "0.2.2",
+    "@oscharko-dev/keiko-security": "0.2.2",
+    "@oscharko-dev/keiko-model-gateway": "0.2.2",
+    "@oscharko-dev/keiko-quality-intelligence": "0.2.2",
+    "@oscharko-dev/keiko-local-knowledge": "0.2.2",
+    "@oscharko-dev/keiko-workspace": "0.2.2",
+    "@oscharko-dev/keiko-sandbox": "0.2.2",
+    "@oscharko-dev/keiko-tools": "0.2.2",
+    "@oscharko-dev/keiko-evidence": "0.2.2",
+    "@oscharko-dev/keiko-verification": "0.2.2",
+    "@oscharko-dev/keiko-harness": "0.2.2",
+    "@oscharko-dev/keiko-sdk": "0.2.2",
+    "@oscharko-dev/keiko-workflows": "0.2.2",
+    "@oscharko-dev/keiko-memory-vault": "0.2.2",
+    "@oscharko-dev/keiko-memory-governance": "0.2.2",
+    "@oscharko-dev/keiko-memory-retrieval": "0.2.2",
+    "@oscharko-dev/keiko-memory-capture": "0.2.2",
+    "@oscharko-dev/keiko-memory-consolidation": "0.2.2",
     "typescript": "^6.0.3"
   }
 }