@botbotgo/agent-harness 0.0.75 → 0.0.77

package/dist/runtime/store.js

@@ -54,9 +54,15 @@ export class FileBackedStore {
     filePath;
     delegate = new InMemoryStore();
     loaded = false;
+    operationChain = Promise.resolve();
     constructor(filePath) {
         this.filePath = filePath;
     }
+    async runSerialized(operation) {
+        const pending = this.operationChain.then(operation, operation);
+        this.operationChain = pending.then(() => undefined, () => undefined);
+        return pending;
+    }
     async ensureLoaded() {
         if (this.loaded) {
             return;
@@ -81,36 +87,48 @@ export class FileBackedStore {
         }, null, 2), "utf8");
     }
     async batch(operations) {
-        await this.ensureLoaded();
-        const result = await this.delegate.batch(operations);
-        if (operations.some((operation) => "value" in operation)) {
-            await this.persist();
-        }
-        return result;
+        return this.runSerialized(async () => {
+            await this.ensureLoaded();
+            const result = await this.delegate.batch(operations);
+            if (operations.some((operation) => "value" in operation)) {
+                await this.persist();
+            }
+            return result;
+        });
     }
     async get(namespace, key) {
-        await this.ensureLoaded();
-        return this.delegate.get(namespace, key);
+        return this.runSerialized(async () => {
+            await this.ensureLoaded();
+            return this.delegate.get(namespace, key);
+        });
     }
     async search(namespacePrefix, options) {
-        await this.ensureLoaded();
-        return this.delegate.search(namespacePrefix, options);
+        return this.runSerialized(async () => {
+            await this.ensureLoaded();
+            return this.delegate.search(namespacePrefix, options);
+        });
     }
     async put(namespace, key, value, index) {
-        await this.ensureLoaded();
-        const result = await this.delegate.put(namespace, key, value, index);
-        await this.persist();
-        return result;
+        return this.runSerialized(async () => {
+            await this.ensureLoaded();
+            const result = await this.delegate.put(namespace, key, value, index);
+            await this.persist();
+            return result;
+        });
     }
     async delete(namespace, key) {
-        await this.ensureLoaded();
-        const result = await this.delegate.delete(namespace, key);
-        await this.persist();
-        return result;
+        return this.runSerialized(async () => {
+            await this.ensureLoaded();
+            const result = await this.delegate.delete(namespace, key);
+            await this.persist();
+            return result;
+        });
     }
     async listNamespaces(options) {
-        await this.ensureLoaded();
-        return this.delegate.listNamespaces(options);
+        return this.runSerialized(async () => {
+            await this.ensureLoaded();
+            return this.delegate.listNamespaces(options);
+        });
     }
 }
 export function createInMemoryStore() {

package/dist/runtime/support/embedding-models.js

@@ -1,7 +1,51 @@
 import { OllamaEmbeddings } from "@langchain/ollama";
+import { OpenAIEmbeddings } from "@langchain/openai";
 import { compileEmbeddingModel } from "../../workspace/resource-compilers.js";
 import { resolveRefId } from "../../workspace/support/workspace-ref-utils.js";
 import { createLlamaIndexEmbeddingModel } from "./llamaindex.js";
+function asObject(value) {
+    return typeof value === "object" && value ? value : undefined;
+}
+function isPlaceholderApiKey(value) {
+    return typeof value === "string" && value.trim().toLowerCase() === "dummy";
+}
+function buildAuthOmittingFetch(baseFetch = fetch) {
+    return async (input, init) => {
+        const sanitizedHeaders = new Headers(input instanceof Request ? input.headers : undefined);
+        const initHeaders = new Headers(init?.headers);
+        initHeaders.forEach((value, key) => {
+            sanitizedHeaders.set(key, value);
+        });
+        sanitizedHeaders.delete("authorization");
+        if (input instanceof Request) {
+            return baseFetch(new Request(input, {
+                ...init,
+                headers: sanitizedHeaders,
+            }));
+        }
+        return baseFetch(input, {
+            ...init,
+            headers: sanitizedHeaders,
+        });
+    };
+}
+function normalizeOpenAICompatibleInit(init) {
+    const normalized = { ...init };
+    const configuration = asObject(init.configuration) ?? {};
+    const baseUrl = typeof init.baseUrl === "string" && init.baseUrl.trim() ? init.baseUrl.trim() : undefined;
+    const omitAuthHeader = init.omitAuthHeader === true || isPlaceholderApiKey(init.apiKey);
+    const nextConfiguration = { ...configuration };
+    if (baseUrl && typeof nextConfiguration.baseURL !== "string") {
+        nextConfiguration.baseURL = baseUrl;
+    }
+    if (omitAuthHeader) {
+        nextConfiguration.fetch = buildAuthOmittingFetch(typeof configuration.fetch === "function" ? configuration.fetch : fetch);
+    }
+    normalized.configuration = nextConfiguration;
+    delete normalized.baseUrl;
+    delete normalized.omitAuthHeader;
+    return normalized;
+}
 export function resolveCompiledEmbeddingModelRef(workspace, embeddingModelRef) {
     const resolvedId = embeddingModelRef ? resolveRefId(embeddingModelRef) : "default";
     const embeddingModel = workspace.embeddings.get(resolvedId);
@@ -26,8 +70,20 @@ export async function resolveCompiledEmbeddingModel(embeddingModel, resolver) {
             ...(embeddingModel.init ?? {}),
         });
     }
+    if (embeddingModel.provider === "openai-compatible") {
+        return new OpenAIEmbeddings({
+            model: embeddingModel.model,
+            ...normalizeOpenAICompatibleInit(embeddingModel.init ?? {}),
+        });
+    }
+    if (embeddingModel.provider === "openai") {
+        return new OpenAIEmbeddings({
+            model: embeddingModel.model,
+            ...(embeddingModel.init ?? {}),
+        });
+    }
     if (embeddingModel.provider === "llamaindex-ollama") {
         return createLlamaIndexEmbeddingModel(embeddingModel);
     }
-    throw new Error(`Embedding model provider ${embeddingModel.provider} is not supported by the built-in runtime. Configure embeddingModelResolver or use ollama/llamaindex-ollama.`);
+    throw new Error(`Embedding model provider ${embeddingModel.provider} is not supported by the built-in runtime. Configure embeddingModelResolver or use openai-compatible/openai/ollama/llamaindex-ollama.`);
 }

package/dist/runtime/thread-memory-sync.d.ts

@@ -1,11 +1,12 @@
 import type { HarnessEvent, HarnessEventProjection } from "../contracts/types.js";
-import type { FilePersistence } from "../persistence/file-store.js";
+import type { RuntimePersistence } from "../persistence/types.js";
 export declare class ThreadMemorySync implements HarnessEventProjection {
     private readonly persistence;
     private readonly store?;
     private readonly pending;
+    private syncChain;
     readonly name = "thread-memory-sync";
-    constructor(persistence: FilePersistence, store?: {
+    constructor(persistence: RuntimePersistence, store?: {
         put: (namespace: string[], key: string, value: Record<string, any>) => Promise<void>;
     } | undefined);
     shouldHandle(event: HarnessEvent): boolean;

package/dist/runtime/thread-memory-sync.js

@@ -53,6 +53,7 @@ export class ThreadMemorySync {
     persistence;
     store;
     pending = new Set();
+    syncChain = Promise.resolve();
     name = "thread-memory-sync";
     constructor(persistence, store) {
         this.persistence = persistence;
@@ -65,7 +66,12 @@ export class ThreadMemorySync {
         if (!this.shouldHandle(event)) {
             return;
         }
-        const task = this.syncThread(event.threadId)
+        const task = this.syncChain
+            .then(() => this.syncThread(event.threadId))
+            .catch(() => {
+            // Fail open: background memory digestion must not break the hot path.
+        });
+        this.syncChain = task
             .catch(() => {
             // Fail open: background memory digestion must not break the hot path.
         })

package/dist/workspace/agent-binding-compiler.js

@@ -3,7 +3,7 @@ import { getSkillInheritancePolicy, resolveToolTargets } from "../extensions.js"
 import { compileModel, compileTool } from "./resource-compilers.js";
 import { inferAgentCapabilities } from "./support/agent-capabilities.js";
 import { discoverSkillPaths } from "./support/discovery.js";
-import { compileAgentMemories, getRuntimeDefaults, getRuntimeMemoryDefaults, getWorkspaceObject, resolvePromptValue, resolveRefId } from "./support/workspace-ref-utils.js";
+import { compileAgentMemories, getResilienceConfig, getRuntimeDefaults, getRuntimeMemoryDefaults, getWorkspaceObject, resolvePromptValue, resolveRefId } from "./support/workspace-ref-utils.js";
 const WORKSPACE_BOUNDARY_GUIDANCE = "Keep repository and file exploration bounded to the current workspace root unless the user explicitly asks for broader host or filesystem access. " +
     "Do not inspect absolute paths outside the workspace, system directories, or unrelated repos by default. " +
     "Prefer workspace-local tools, relative paths, and the current repository checkout when analyzing code.";
@@ -235,6 +235,7 @@ function resolveRuntimeMemoryConfig(agent, refs) {
 export function compileBinding(workspaceRoot, agent, agents, referencedSubagentIds, refs, models, tools) {
     const internalSubagent = referencedSubagentIds.has(agent.id);
     const runtimeDefaults = getRuntimeDefaults(refs);
+    const resilience = getResilienceConfig(refs);
     const compiledAgentSkills = compileAgentSkills(workspaceRoot, agent);
     const compiledAgentMemory = compileAgentMemories(workspaceRoot, agent.memorySources);
     const compiledAgentModel = requireModel(models, agent.modelRef || (internalSubagent ? "model/default" : ""), agent.id);
@@ -264,6 +265,7 @@ export function compileBinding(workspaceRoot, agent, agents, referencedSubagentI
             workspaceRoot,
             hostFacing: !internalSubagent,
             capabilities: inferAgentCapabilities(agent),
+            resilience,
             ...(checkpointer ? { checkpointer: checkpointer.config } : {}),
             ...(store ? { store: store.config } : {}),
             ...(runtimeMemory ? { runtimeMemory: runtimeMemory.config } : {}),

package/dist/workspace/support/workspace-ref-utils.d.ts

@@ -20,11 +20,20 @@ export type RecoveryConfig = {
 export type ConcurrencyConfig = {
     maxConcurrentRuns: number;
 };
+export type ProviderRetryConfig = {
+    maxAttempts: number;
+    backoffMs: number;
+    retryableMessages: string[];
+};
+export type ResilienceConfig = {
+    providerRetries: ProviderRetryConfig;
+};
 export declare function getWorkspaceObject(refs: Map<string, WorkspaceObject | ParsedAgentObject>, ref: string | undefined): WorkspaceObject | undefined;
 export declare function getRuntimeDefaults(refs: Map<string, WorkspaceObject | ParsedAgentObject>): Record<string, unknown> | undefined;
 export declare function getRuntimeMemoryDefaults(refs: Map<string, WorkspaceObject | ParsedAgentObject>): Record<string, unknown> | undefined;
 export declare function getRecoveryConfig(refs: Map<string, WorkspaceObject | ParsedAgentObject>): RecoveryConfig;
 export declare function getConcurrencyConfig(refs: Map<string, WorkspaceObject | ParsedAgentObject>): ConcurrencyConfig;
+export declare function getResilienceConfig(refs: Map<string, WorkspaceObject | ParsedAgentObject>): ResilienceConfig;
 export declare function getRoutingSystemPrompt(refs: Map<string, WorkspaceObject | ParsedAgentObject>): string | undefined;
 export declare function getRoutingDefaultAgentId(refs: Map<string, WorkspaceObject | ParsedAgentObject>): string | undefined;
 export declare function isModelRoutingEnabled(refs: Map<string, WorkspaceObject | ParsedAgentObject>): boolean;

package/dist/workspace/support/workspace-ref-utils.js

@@ -65,6 +65,44 @@ export function getConcurrencyConfig(refs) {
         : 3;
     return { maxConcurrentRuns };
 }
+export function getResilienceConfig(refs) {
+    const runtimeDefaults = getRuntimeDefaults(refs);
+    const resilience = typeof runtimeDefaults?.resilience === "object" && runtimeDefaults.resilience
+        ? runtimeDefaults.resilience
+        : {};
+    const providerRetries = typeof resilience.providerRetries === "object" && resilience.providerRetries
+        ? resilience.providerRetries
+        : {};
+    const maxAttempts = typeof providerRetries.maxAttempts === "number" &&
+        Number.isFinite(providerRetries.maxAttempts) &&
+        providerRetries.maxAttempts > 0
+        ? Math.floor(providerRetries.maxAttempts)
+        : 2;
+    const backoffMs = typeof providerRetries.backoffMs === "number" &&
+        Number.isFinite(providerRetries.backoffMs) &&
+        providerRetries.backoffMs >= 0
+        ? Math.floor(providerRetries.backoffMs)
+        : 1_000;
+    const retryableMessages = Array.isArray(providerRetries.retryableMessages)
+        ? providerRetries.retryableMessages
+            .filter((value) => typeof value === "string" && value.trim().length > 0)
+            .map((value) => value.trim())
+        : [
+            "connection error",
+            "network error",
+            "fetch failed",
+            "socket hang up",
+            "econnreset",
+            "timed out",
+        ];
+    return {
+        providerRetries: {
+            maxAttempts,
+            backoffMs,
+            retryableMessages,
+        },
+    };
+}
 export function getRoutingSystemPrompt(refs) {
     const routing = getRoutingObject(refs);
     return typeof routing?.systemPrompt === "string" && routing.systemPrompt.trim() ? routing.systemPrompt : undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.75",
+  "version": "0.0.77",
   "description": "Workspace runtime for multi-agent applications",
   "type": "module",
   "packageManager": "npm@10.9.2",
@@ -53,7 +53,7 @@
   "scripts": {
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json && cp -R config dist/",
     "check": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run test/hello-file.test.ts test/public-api.test.ts test/memory-runtime.test.ts test/resource-optional-provider.test.ts test/resource-isolation.test.ts test/stock-research-app-load-harness.test.ts test/stock-research-app-run.test.ts test/stock-research-app-config.test.ts test/release-workflow.test.ts test/release-version.test.ts test/gitignore.test.ts test/package-lock.test.ts test/readme.test.ts test/product-boundary-docs.test.ts test/long-term-memory-docs.test.ts test/docs-site.test.ts test/runtime-adapter-regressions.test.ts test/runtime-capabilities.test.ts test/runtime-recovery.test.ts test/tool-extension-gaps.test.ts test/checkpoint-maintenance.test.ts test/llamaindex-dependency-compat.test.ts test/skill-standard.test.ts test/routing-config.test.ts test/workspace-compat-regressions.test.ts test/upstream-compat-regressions.test.ts test/yaml-format.test.ts test/config-secrets.test.ts test/init-command.test.ts test/coding-agent-guide.test.ts",
+    "test": "vitest run test/hello-file.test.ts test/public-api.test.ts test/runtime-health.test.ts test/memory-runtime.test.ts test/sqlite-persistence.test.ts test/runtime-record-maintenance.test.ts test/resource-optional-provider.test.ts test/resource-isolation.test.ts test/stock-research-app-load-harness.test.ts test/stock-research-app-run.test.ts test/stock-research-app-config.test.ts test/release-workflow.test.ts test/release-version.test.ts test/gitignore.test.ts test/package-lock.test.ts test/readme.test.ts test/product-boundary-docs.test.ts test/long-term-memory-docs.test.ts test/local-docs-persistence-inventory.test.ts test/docs-site.test.ts test/runtime-adapter-regressions.test.ts test/runtime-capabilities.test.ts test/runtime-recovery.test.ts test/tool-extension-gaps.test.ts test/checkpoint-maintenance.test.ts test/llamaindex-dependency-compat.test.ts test/skill-standard.test.ts test/routing-config.test.ts test/workspace-compat-regressions.test.ts test/upstream-compat-regressions.test.ts test/yaml-format.test.ts test/config-secrets.test.ts test/init-command.test.ts test/coding-agent-guide.test.ts",
     "test:real-providers": "vitest run test/real-provider-harness.test.ts",
     "release:prepare": "npm version patch --no-git-tag-version && node ./scripts/sync-example-version.mjs",
     "release:pack": "npm pack --dry-run",