@botbotgo/agent-harness 0.0.40 → 0.0.42

package/dist/runtime/support/runtime-factories.d.ts

@@ -1,3 +1,3 @@
 import { type StoreLike } from "../store.js";
 export declare function createStoreForConfig(storeConfig: Record<string, unknown>, runRoot: string): StoreLike;
-export declare function createCheckpointerForConfig(checkpointerConfig: Record<string, unknown>, runRoot: string): unknown;
+export declare function createCheckpointerForConfig(checkpointerConfig: Record<string, unknown> | boolean, runRoot: string): unknown;

package/dist/runtime/support/runtime-factories.js

@@ -22,6 +22,9 @@ export function createStoreForConfig(storeConfig, runRoot) {
     }
 }
 export function createCheckpointerForConfig(checkpointerConfig, runRoot) {
+    if (typeof checkpointerConfig === "boolean") {
+        return checkpointerConfig;
+    }
     const kind = typeof checkpointerConfig.kind === "string" ? checkpointerConfig.kind : "FileCheckpointer";
     switch (kind) {
         case "MemorySaver":

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

@@ -43,6 +43,22 @@ function compileMiddlewareConfigs(middleware, models, ownerId) {
             compiled.model = requireModel(models, compiled.modelRef, ownerId);
             delete compiled.modelRef;
         }
+        if (compiled.kind === "llmToolSelector" && typeof compiled.modelRef === "string") {
+            compiled.model = requireModel(models, compiled.modelRef, ownerId);
+            delete compiled.modelRef;
+        }
+        if (compiled.kind === "modelFallback") {
+            const fallbackModelRefs = Array.isArray(compiled.fallbackModelRefs)
+                ? compiled.fallbackModelRefs
+                : Array.isArray(compiled.modelRefs)
+                    ? compiled.modelRefs
+                    : [];
+            if (fallbackModelRefs.length > 0) {
+                compiled.fallbackModels = fallbackModelRefs.map((modelRef) => requireModel(models, String(modelRef), ownerId));
+                delete compiled.fallbackModelRefs;
+                delete compiled.modelRefs;
+            }
+        }
         return compiled;
     });
 }
@@ -117,21 +133,24 @@ function resolveBackendConfig(agent) {
     return backendConfig ? { config: backendConfig } : undefined;
 }
 function resolveStoreConfig(agent) {
-    if (agent.executionMode !== "deepagent") {
-        return undefined;
-    }
     const inlineStore = typeof agent.deepAgentConfig?.store === "object" && agent.deepAgentConfig.store
         ? agent.deepAgentConfig.store
-        : undefined;
+        : typeof agent.langchainAgentConfig?.store === "object" && agent.langchainAgentConfig.store
+            ? agent.langchainAgentConfig.store
+            : undefined;
     return inlineStore ? { config: inlineStore } : undefined;
 }
 function resolveCheckpointerConfig(agent) {
     const inlineAgentCheckpointer = typeof agent.deepAgentConfig?.checkpointer === "object" && agent.deepAgentConfig.checkpointer
         ? agent.deepAgentConfig.checkpointer
-        : typeof agent.langchainAgentConfig?.checkpointer === "object" && agent.langchainAgentConfig.checkpointer
-            ? agent.langchainAgentConfig.checkpointer
-            : undefined;
-    return inlineAgentCheckpointer ? { config: inlineAgentCheckpointer } : undefined;
+        : typeof agent.deepAgentConfig?.checkpointer === "boolean"
+            ? agent.deepAgentConfig.checkpointer
+            : typeof agent.langchainAgentConfig?.checkpointer === "object" && agent.langchainAgentConfig.checkpointer
+                ? agent.langchainAgentConfig.checkpointer
+                : typeof agent.langchainAgentConfig?.checkpointer === "boolean"
+                    ? agent.langchainAgentConfig.checkpointer
+                    : undefined;
+    return inlineAgentCheckpointer !== undefined ? { config: inlineAgentCheckpointer } : undefined;
 }
 export function compileBinding(workspaceRoot, agent, agents, referencedSubagentIds, refs, models, tools) {
     const internalSubagent = referencedSubagentIds.has(agent.id);
@@ -162,9 +181,15 @@ export function compileBinding(workspaceRoot, agent, agents, referencedSubagentI
             model: compiledAgentModel,
             tools: requireTools(tools, agent.toolRefs, agent.id),
             systemPrompt: resolveSystemPrompt(agent),
+            stateSchema: agent.langchainAgentConfig?.stateSchema,
             responseFormat: agent.langchainAgentConfig?.responseFormat,
             contextSchema: agent.langchainAgentConfig?.contextSchema,
             middleware: compileMiddlewareConfigs(agent.langchainAgentConfig?.middleware, models, agent.id),
+            includeAgentName: agent.langchainAgentConfig?.includeAgentName === "inline" ? "inline" : undefined,
+            version: agent.langchainAgentConfig?.version === "v1" || agent.langchainAgentConfig?.version === "v2"
+                ? agent.langchainAgentConfig.version
+                : undefined,
+            name: resolveAgentRuntimeName(agent),
             description: agent.description,
         };
         return {
@@ -196,6 +221,10 @@ export function compileBinding(workspaceRoot, agent, agents, referencedSubagentI
             name: resolveAgentRuntimeName(agent),
             memory: compiledAgentMemory,
             skills: compiledAgentSkills,
+            generalPurposeAgent: typeof agent.deepAgentConfig?.generalPurposeAgent === "boolean" ? agent.deepAgentConfig.generalPurposeAgent : undefined,
+            taskDescription: typeof agent.deepAgentConfig?.taskDescription === "string" && agent.deepAgentConfig.taskDescription.trim()
+                ? agent.deepAgentConfig.taskDescription
+                : undefined,
         },
     };
 }

package/dist/workspace/object-loader.js

@@ -213,21 +213,31 @@ function readSharedAgentConfig(item) {
     const middleware = readMiddlewareArray(item.middleware);
     return {
         ...(typeof item.systemPrompt === "string" ? { systemPrompt: item.systemPrompt } : {}),
-        ...(typeof item.checkpointer === "object" && item.checkpointer ? { checkpointer: item.checkpointer } : {}),
+        ...((typeof item.checkpointer === "object" && item.checkpointer) || typeof item.checkpointer === "boolean"
+            ? { checkpointer: item.checkpointer }
+            : {}),
         ...(typeof item.interruptOn === "object" && item.interruptOn ? { interruptOn: item.interruptOn } : {}),
+        ...(item.stateSchema !== undefined ? { stateSchema: item.stateSchema } : {}),
         ...(item.responseFormat !== undefined ? { responseFormat: item.responseFormat } : {}),
         ...(item.contextSchema !== undefined ? { contextSchema: item.contextSchema } : {}),
+        ...(item.includeAgentName === "inline" ? { includeAgentName: "inline" } : {}),
+        ...(item.version === "v1" || item.version === "v2" ? { version: item.version } : {}),
         ...(middleware ? { middleware } : {}),
     };
 }
 function readLangchainAgentConfig(item) {
-    return readSharedAgentConfig(item);
+    return {
+        ...readSharedAgentConfig(item),
+        ...(typeof item.store === "object" && item.store ? { store: item.store } : {}),
+    };
 }
 function readDeepAgentConfig(item) {
     return {
         ...readSharedAgentConfig(item),
         ...(typeof item.backend === "object" && item.backend ? { backend: item.backend } : {}),
         ...(typeof item.store === "object" && item.store ? { store: item.store } : {}),
+        ...(typeof item.taskDescription === "string" && item.taskDescription.trim() ? { taskDescription: item.taskDescription } : {}),
+        ...(typeof item.generalPurposeAgent === "boolean" ? { generalPurposeAgent: item.generalPurposeAgent } : {}),
     };
 }
 export function parseAgentItem(item, sourcePath) {

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

@@ -12,8 +12,23 @@ export type RoutingRule = {
     hasThreadId?: boolean;
     caseSensitive?: boolean;
 };
+export type RuntimeRecoveryConfig = {
+    enabled: boolean;
+    resumeOnStartup: boolean;
+};
+export type RecoveryConfig = {
+    enabled: boolean;
+    resumeResumingRunsOnStartup: boolean;
+    maxRecoveryAttempts: number;
+};
+export type ConcurrencyConfig = {
+    maxConcurrentRuns?: number;
+};
 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 getRuntimeRecoveryConfig(refs: Map<string, WorkspaceObject | ParsedAgentObject>): RuntimeRecoveryConfig;
+export declare function getRecoveryConfig(refs: Map<string, WorkspaceObject | ParsedAgentObject>): RecoveryConfig;
+export declare function getConcurrencyConfig(refs: Map<string, WorkspaceObject | ParsedAgentObject>): ConcurrencyConfig;
 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

@@ -25,6 +25,46 @@ export function getRuntimeDefaults(refs) {
     }
     return runtimes[0].value;
 }
+export function getRuntimeRecoveryConfig(refs) {
+    const runtimeDefaults = getRuntimeDefaults(refs);
+    const recovery = typeof runtimeDefaults?.recovery === "object" && runtimeDefaults.recovery
+        ? runtimeDefaults.recovery
+        : undefined;
+    return {
+        enabled: recovery?.enabled !== false,
+        resumeOnStartup: recovery?.resumeOnStartup !== false,
+    };
+}
+export function getRecoveryConfig(refs) {
+    const runtimeDefaults = getRuntimeDefaults(refs);
+    const recovery = typeof runtimeDefaults?.recovery === "object" && runtimeDefaults.recovery
+        ? runtimeDefaults.recovery
+        : {};
+    const maxRecoveryAttempts = typeof recovery.maxRecoveryAttempts === "number" &&
+        Number.isFinite(recovery.maxRecoveryAttempts) &&
+        recovery.maxRecoveryAttempts > 0
+        ? Math.floor(recovery.maxRecoveryAttempts)
+        : 3;
+    return {
+        enabled: recovery.enabled !== false,
+        resumeResumingRunsOnStartup: typeof recovery.resumeResumingRunsOnStartup === "boolean"
+            ? recovery.resumeResumingRunsOnStartup
+            : recovery.resumeOnStartup !== false,
+        maxRecoveryAttempts,
+    };
+}
+export function getConcurrencyConfig(refs) {
+    const runtimeDefaults = getRuntimeDefaults(refs);
+    const concurrency = typeof runtimeDefaults?.concurrency === "object" && runtimeDefaults.concurrency
+        ? runtimeDefaults.concurrency
+        : {};
+    const maxConcurrentRuns = typeof concurrency.maxConcurrentRuns === "number" &&
+        Number.isFinite(concurrency.maxConcurrentRuns) &&
+        concurrency.maxConcurrentRuns > 0
+        ? Math.floor(concurrency.maxConcurrentRuns)
+        : undefined;
+    return { maxConcurrentRuns };
+}
 export function getRoutingSystemPrompt(refs) {
     const routing = getRoutingObject(refs);
     return typeof routing?.systemPrompt === "string" && routing.systemPrompt.trim() ? routing.systemPrompt : undefined;

package/dist/workspace/validate.js

@@ -1,18 +1,15 @@
 const allowedExecutionModes = new Set(["deepagent", "langchain-v1"]);
-const allowedMiddlewareKinds = new Set([
-    "summarization",
-    "modelRetry",
-    "toolRetry",
-    "toolCallLimit",
-    "modelCallLimit",
-    "todoList",
-]);
 function hasPromptContent(value) {
     return typeof value === "string" && value.trim().length > 0;
 }
 function validateCheckpointerConfig(agent) {
     const checkpointer = (typeof agent.deepAgentConfig?.checkpointer === "object" && agent.deepAgentConfig.checkpointer) ||
+        (typeof agent.deepAgentConfig?.checkpointer === "boolean" ? agent.deepAgentConfig.checkpointer : undefined) ||
+        (typeof agent.langchainAgentConfig?.checkpointer === "boolean" ? agent.langchainAgentConfig.checkpointer : undefined) ||
         (typeof agent.langchainAgentConfig?.checkpointer === "object" && agent.langchainAgentConfig.checkpointer);
+    if (typeof checkpointer === "boolean") {
+        return;
+    }
     if (!checkpointer) {
         return;
     }
@@ -33,13 +30,16 @@ function validateMiddlewareConfig(agent) {
             throw new Error(`Agent ${agent.id} middleware entries must be objects`);
         }
         const typed = config;
-        const kind = typeof typed.kind === "string" ? typed.kind : "";
-        if (!allowedMiddlewareKinds.has(kind)) {
-            throw new Error(`Agent ${agent.id} middleware kind ${kind || "(missing)"} is not supported`);
+        const kind = typeof typed.kind === "string" ? typed.kind.trim() : "";
+        if (!kind) {
+            throw new Error(`Agent ${agent.id} middleware kind is required`);
         }
         if (kind === "summarization" && typed.model === undefined && typeof typed.modelRef !== "string") {
             throw new Error(`Agent ${agent.id} summarization middleware requires model or modelRef`);
         }
+        if (kind === "modelFallback" && !Array.isArray(typed.fallbackModels) && !Array.isArray(typed.models)) {
+            throw new Error(`Agent ${agent.id} modelFallback middleware requires fallbackModels or models`);
+        }
     }
 }
 export function validateAgent(agent) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.40",
+  "version": "0.0.42",
   "description": "Workspace runtime for multi-agent applications",
   "type": "module",
   "packageManager": "npm@10.9.2",
@@ -50,7 +50,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/public-api.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/release-workflow.test.ts test/release-version.test.ts test/gitignore.test.ts test/package-lock.test.ts test/readme.test.ts test/runtime-adapter-regressions.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": "vitest run test/public-api.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/release-workflow.test.ts test/release-version.test.ts test/gitignore.test.ts test/package-lock.test.ts test/readme.test.ts test/runtime-adapter-regressions.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: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",