@botbotgo/agent-harness 0.0.41 → 0.0.43

package/dist/runtime/inventory.js

@@ -1,4 +1,5 @@
 import { readSkillMetadata } from "./support/skill-metadata.js";
+import { getBindingPrimaryTools } from "./support/compiled-binding.js";
 function listHostBindings(workspace) {
     return Array.from(workspace.bindings.values()).filter((binding) => binding.harnessRuntime.hostFacing);
 }
@@ -31,7 +32,7 @@ export function listAgentTools(workspace, agentId) {
     if (!binding) {
         return [];
     }
-    return dedupeTools(binding.langchainAgentParams?.tools ?? binding.deepAgentParams?.tools ?? []);
+    return dedupeTools(getBindingPrimaryTools(binding));
 }
 export function listAgentSkills(workspace, agentId) {
     const binding = findAgentBinding(workspace, agentId);

package/dist/runtime/support/compiled-binding.d.ts

@@ -0,0 +1,15 @@
+import type { CompiledAgentBinding, CompiledModel, CompiledTool, DeepAgentParams, LangChainAgentParams } from "../../contracts/types.js";
+export declare function getBindingAdapterKind(binding: CompiledAgentBinding): string;
+export declare function getBindingAdapterConfig(binding: CompiledAgentBinding): Record<string, unknown>;
+export declare function getBindingLangChainParams(binding: CompiledAgentBinding): LangChainAgentParams | undefined;
+export declare function getBindingDeepAgentParams(binding: CompiledAgentBinding): DeepAgentParams | undefined;
+export declare function isLangChainBinding(binding: CompiledAgentBinding): boolean;
+export declare function isDeepAgentBinding(binding: CompiledAgentBinding): boolean;
+export declare function getBindingPrimaryTools(binding: CompiledAgentBinding): CompiledTool[];
+export declare function getBindingPrimaryModel(binding: CompiledAgentBinding): CompiledModel | undefined;
+export declare function getBindingSystemPrompt(binding: CompiledAgentBinding): string | undefined;
+export declare function getBindingMiddlewareConfigs(binding: CompiledAgentBinding): Array<Record<string, unknown>> | undefined;
+export declare function getBindingInterruptCompatibilityRules(binding: CompiledAgentBinding): Record<string, boolean | object> | undefined;
+export declare function getBindingModelInit(binding: CompiledAgentBinding): Record<string, unknown> | undefined;
+export declare function getBindingStoreConfig(binding: CompiledAgentBinding): Record<string, unknown> | undefined;
+export declare function bindingHasSubagents(binding: CompiledAgentBinding): boolean;

package/dist/runtime/support/compiled-binding.js

@@ -0,0 +1,56 @@
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+export function getBindingAdapterKind(binding) {
+    return binding.adapter?.kind ?? binding.agent.executionMode;
+}
+export function getBindingAdapterConfig(binding) {
+    return binding.adapter?.config ?? {};
+}
+export function getBindingLangChainParams(binding) {
+    const adapterParams = asRecord(getBindingAdapterConfig(binding).params);
+    if (getBindingAdapterKind(binding) === "langchain-v1" && adapterParams) {
+        return adapterParams;
+    }
+    return binding.langchainAgentParams;
+}
+export function getBindingDeepAgentParams(binding) {
+    const adapterParams = asRecord(getBindingAdapterConfig(binding).params);
+    if (getBindingAdapterKind(binding) === "deepagent" && adapterParams) {
+        return adapterParams;
+    }
+    return binding.deepAgentParams;
+}
+export function isLangChainBinding(binding) {
+    return getBindingAdapterKind(binding) === "langchain-v1" || Boolean(binding.langchainAgentParams);
+}
+export function isDeepAgentBinding(binding) {
+    return getBindingAdapterKind(binding) === "deepagent" || Boolean(binding.deepAgentParams);
+}
+export function getBindingPrimaryTools(binding) {
+    return binding.langchainAgentParams?.tools ?? binding.deepAgentParams?.tools ?? [];
+}
+export function getBindingPrimaryModel(binding) {
+    return binding.langchainAgentParams?.model ?? binding.deepAgentParams?.model;
+}
+export function getBindingSystemPrompt(binding) {
+    return binding.langchainAgentParams?.systemPrompt ?? binding.deepAgentParams?.systemPrompt;
+}
+export function getBindingMiddlewareConfigs(binding) {
+    return binding.langchainAgentParams?.middleware ?? binding.deepAgentParams?.middleware;
+}
+export function getBindingInterruptCompatibilityRules(binding) {
+    return binding.deepAgentParams?.interruptOn ??
+        binding.agent.langchainAgentConfig?.interruptOn;
+}
+export function getBindingModelInit(binding) {
+    return getBindingPrimaryModel(binding)?.init;
+}
+export function getBindingStoreConfig(binding) {
+    return binding.deepAgentParams?.store ?? binding.harnessRuntime.store;
+}
+export function bindingHasSubagents(binding) {
+    return (binding.deepAgentParams?.subagents.length ?? 0) > 0;
+}

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

@@ -1,4 +1,4 @@
-import type { ApprovalRecord, HarnessEvent, WorkspaceBundle } from "../../contracts/types.js";
+import type { HarnessEvent, InternalApprovalRecord, WorkspaceBundle } from "../../contracts/types.js";
 export declare function renderRuntimeFailure(error: unknown): string;
 export declare function renderToolFailure(toolName: string, output: unknown): string;
 export declare function parseInterruptContent(content: string): {
@@ -19,7 +19,7 @@ export declare function heuristicRoute(input: string, primaryBinding?: {
     };
 }): string;
 export declare function createHarnessEvent(threadId: string, runId: string, sequence: number, eventType: string, payload: Record<string, unknown>, source?: HarnessEvent["source"]): HarnessEvent;
-export declare function createPendingApproval(threadId: string, runId: string, checkpointRef: string, input: string, interruptContent?: string): ApprovalRecord;
+export declare function createPendingApproval(threadId: string, runId: string, checkpointRef: string, input: string, interruptContent?: string): InternalApprovalRecord;
 export declare function inferRoutingBindings(workspace: WorkspaceBundle): {
     primaryBinding: import("../../contracts/types.js").CompiledAgentBinding;
     secondaryBinding: import("../../contracts/types.js").CompiledAgentBinding | undefined;

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

@@ -1,4 +1,5 @@
 import { createPersistentId } from "../../utils/id.js";
+import { isDelegationCapableBinding } from "../../workspace/support/agent-capabilities.js";
 export function renderRuntimeFailure(error) {
     const message = error instanceof Error ? error.message : String(error);
     return `runtime_error=${message}`.trim();
@@ -131,20 +132,21 @@ export function inferRoutingBindings(workspace) {
     const hostBindings = Array.from(workspace.bindings.values()).filter((binding) => binding.harnessRuntime.hostFacing);
     const researchBinding = hostBindings.find((binding) => binding.agent.id === "research-lite" || binding.agent.id === "research");
     const directBinding = hostBindings.find((binding) => binding.agent.id === "direct");
-    const langchainHost = hostBindings.find((binding) => binding.agent.executionMode === "langchain-v1" && binding.agent.id !== researchBinding?.agent.id);
-    const deepagentHosts = hostBindings.filter((binding) => binding.agent.executionMode === "deepagent");
-    const defaultDeepagentHost = deepagentHosts.find((binding) => binding.agent.id === "orchestra") ??
-        deepagentHosts.find((binding) => (binding.deepAgentParams?.subagents.length ?? 0) > 0) ??
-        deepagentHosts[0];
-    const deepagentWithSubagents = deepagentHosts.find((binding) => (binding.deepAgentParams?.subagents.length ?? 0) > 0) ??
-        deepagentHosts[0];
-    const primaryBinding = defaultDeepagentHost ?? directBinding ?? langchainHost ?? hostBindings[0];
-    const secondaryBinding = langchainHost && langchainHost.agent.id !== primaryBinding?.agent.id
-        ? langchainHost
+    const delegationHosts = hostBindings.filter((binding) => isDelegationCapableBinding(binding));
+    const lightweightHosts = hostBindings.filter((binding) => !isDelegationCapableBinding(binding));
+    const defaultOrchestratingHost = hostBindings.find((binding) => binding.agent.id === "orchestra") ??
+        delegationHosts.find((binding) => (binding.deepAgentParams?.subagents.length ?? 0) > 0) ??
+        delegationHosts[0];
+    const delegationPreferredSecondary = delegationHosts.find((binding) => (binding.deepAgentParams?.subagents.length ?? 0) > 0) ??
+        delegationHosts[0];
+    const genericLightweightHost = lightweightHosts.find((binding) => binding.agent.id !== researchBinding?.agent.id);
+    const primaryBinding = defaultOrchestratingHost ?? directBinding ?? genericLightweightHost ?? hostBindings[0];
+    const secondaryBinding = genericLightweightHost && genericLightweightHost.agent.id !== primaryBinding?.agent.id
+        ? genericLightweightHost
         : directBinding && directBinding.agent.id !== primaryBinding?.agent.id
             ? directBinding
-            : deepagentWithSubagents && deepagentWithSubagents.agent.id !== primaryBinding?.agent.id
-                ? deepagentWithSubagents
+            : delegationPreferredSecondary && delegationPreferredSecondary.agent.id !== primaryBinding?.agent.id
+                ? delegationPreferredSecondary
                 : hostBindings.find((binding) => binding.agent.id !== primaryBinding?.agent.id);
     return { primaryBinding, secondaryBinding, researchBinding, hostBindings };
 }

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

@@ -1,6 +1,7 @@
 import path from "node:path";
 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, 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. " +
@@ -133,21 +134,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);
@@ -165,10 +169,21 @@ export function compileBinding(workspaceRoot, agent, agents, referencedSubagentI
             : path.join(workspaceRoot, "run-data");
     const base = {
         agent,
+        adapter: {
+            kind: agent.executionMode,
+            config: agent.executionMode === "deepagent"
+                ? {
+                    deepAgent: true,
+                }
+                : {
+                    langchainV1: true,
+                },
+        },
         harnessRuntime: {
             runRoot,
             workspaceRoot,
             hostFacing: !internalSubagent,
+            capabilities: inferAgentCapabilities(agent),
             ...(checkpointer ? { checkpointer: checkpointer.config } : {}),
             ...(store ? { store: store.config } : {}),
         },
@@ -191,37 +206,50 @@ export function compileBinding(workspaceRoot, agent, agents, referencedSubagentI
         };
         return {
             ...base,
+            adapter: {
+                kind: "langchain-v1",
+                config: {
+                    params: langchainAgentParams,
+                },
+            },
             langchainAgentParams,
             directAgentParams: langchainAgentParams,
         };
     }
+    const deepAgentParams = {
+        model: compiledAgentModel,
+        tools: requireTools(tools, agent.toolRefs, agent.id),
+        systemPrompt: resolveSystemPrompt(agent),
+        responseFormat: agent.deepAgentConfig?.responseFormat,
+        contextSchema: agent.deepAgentConfig?.contextSchema,
+        middleware: compileMiddlewareConfigs(agent.deepAgentConfig?.middleware, models, agent.id),
+        description: agent.description,
+        subagents: agent.subagentRefs.map((ref) => {
+            const subagent = agents.get(resolveRefId(ref));
+            if (!subagent) {
+                throw new Error(`Missing subagent ${ref} for agent ${agent.id}`);
+            }
+            return buildSubagent(subagent, workspaceRoot, models, tools, compiledAgentSkills, compiledAgentModel, compiledAgentMemory);
+        }),
+        interruptOn: resolveInterruptOn(agent),
+        ...(backend ? { backend: backend.config } : {}),
+        ...(store ? { store: store.config } : {}),
+        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,
+    };
     return {
         ...base,
-        deepAgentParams: {
-            model: compiledAgentModel,
-            tools: requireTools(tools, agent.toolRefs, agent.id),
-            systemPrompt: resolveSystemPrompt(agent),
-            responseFormat: agent.deepAgentConfig?.responseFormat,
-            contextSchema: agent.deepAgentConfig?.contextSchema,
-            middleware: compileMiddlewareConfigs(agent.deepAgentConfig?.middleware, models, agent.id),
-            description: agent.description,
-            subagents: agent.subagentRefs.map((ref) => {
-                const subagent = agents.get(resolveRefId(ref));
-                if (!subagent) {
-                    throw new Error(`Missing subagent ${ref} for agent ${agent.id}`);
-                }
-                return buildSubagent(subagent, workspaceRoot, models, tools, compiledAgentSkills, compiledAgentModel, compiledAgentMemory);
-            }),
-            interruptOn: resolveInterruptOn(agent),
-            ...(backend ? { backend: backend.config } : {}),
-            ...(store ? { store: store.config } : {}),
-            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,
+        adapter: {
+            kind: "deepagent",
+            config: {
+                params: deepAgentParams,
+            },
         },
+        deepAgentParams,
     };
 }

package/dist/workspace/object-loader.js

@@ -88,6 +88,8 @@ function normalizeNamedResourceSpec(document, kind) {
 }
 function normalizeKind(kind) {
     switch (kind) {
+        case "Agent":
+            return "agent";
         case "LangChainAgent":
             return "langchain-agent";
         case "DeepAgent":
@@ -209,11 +211,44 @@ function readObjectArray(items) {
         .map((item) => ({ ...item }));
     return records.length > 0 ? records : undefined;
 }
+function readCapabilities(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const typed = value;
+    const capabilities = {
+        ...(typeof typed.delegation === "boolean" ? { delegation: typed.delegation } : {}),
+        ...(typeof typed.memory === "boolean" ? { memory: typed.memory } : {}),
+    };
+    return Object.keys(capabilities).length > 0 ? capabilities : undefined;
+}
+function readExecutionConfig(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? { ...value }
+        : undefined;
+}
+function resolveExecutionBackend(item, current) {
+    const execution = readExecutionConfig(item.execution) ?? readExecutionConfig(current?.execution);
+    const backend = typeof execution?.backend === "string"
+        ? execution.backend.trim().toLowerCase()
+        : typeof execution?.mode === "string"
+            ? execution.mode.trim().toLowerCase()
+            : undefined;
+    if (backend === "langchain-v1" || backend === "langchain" || backend === "langchain-agent") {
+        return "langchain-v1";
+    }
+    if (backend === "deepagent" || backend === "deepagents") {
+        return "deepagent";
+    }
+    return undefined;
+}
 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 } : {}),
@@ -224,7 +259,10 @@ function readSharedAgentConfig(item) {
     };
 }
 function readLangchainAgentConfig(item) {
-    return readSharedAgentConfig(item);
+    return {
+        ...readSharedAgentConfig(item),
+        ...(typeof item.store === "object" && item.store ? { store: item.store } : {}),
+    };
 }
 function readDeepAgentConfig(item) {
     return {
@@ -239,12 +277,16 @@ export function parseAgentItem(item, sourcePath) {
     const subagentRefs = readRefArray(item.subagents);
     const subagentPathRefs = readPathArray(item.subagents);
     const kind = typeof item.kind === "string" ? item.kind : "agent";
-    const executionMode = String((kind === "langchain-agent" ? "langchain-v1" : undefined) ??
+    const executionMode = String(resolveExecutionBackend(item) ??
+        (kind === "langchain-agent" ? "langchain-v1" : undefined) ??
         (kind === "deepagent" ? "deepagent" : undefined) ??
         "deepagent");
     return {
         id: String(item.id),
         executionMode: executionMode,
+        capabilities: readCapabilities(item.capabilities) ?? (executionMode === "deepagent"
+            ? { delegation: true, memory: true }
+            : { delegation: false, memory: false }),
         description: String(item.description ?? ""),
         modelRef: readSingleRef(item.modelRef) ?? "",
         runRoot: typeof item.runRoot === "string" ? item.runRoot : undefined,
@@ -464,7 +506,7 @@ async function readNamedModelItems(root) {
     return records;
 }
 function isAgentKind(kind) {
-    return kind === "deepagent" || kind === "langchain-agent";
+    return kind === "deepagent" || kind === "langchain-agent" || kind === "agent";
 }
 async function readConfigAgentItems(configRoot) {
     const records = await readYamlItems(configRoot, "agents", { recursive: true });
@@ -512,6 +554,10 @@ export async function readToolModuleItems(root) {
     return records;
 }
 function inferExecutionMode(item, current) {
+    const explicitExecution = resolveExecutionBackend(item, current);
+    if (explicitExecution) {
+        return explicitExecution;
+    }
     const kind = typeof item.kind === "string" ? item.kind : typeof current?.kind === "string" ? current.kind : undefined;
     if (kind === "langchain-agent") {
         return "langchain-v1";

package/dist/workspace/support/agent-capabilities.d.ts

@@ -0,0 +1,7 @@
+import type { CompiledAgentBinding, ParsedAgentObject, RuntimeCapabilities } from "../../contracts/types.js";
+export declare function inferAgentCapabilities(agent: ParsedAgentObject): RuntimeCapabilities;
+export declare function inferBindingCapabilities(binding: CompiledAgentBinding): RuntimeCapabilities;
+export declare function isDelegationCapableAgent(agent: ParsedAgentObject): boolean;
+export declare function isMemoryCapableAgent(agent: ParsedAgentObject): boolean;
+export declare function isDelegationCapableBinding(binding: CompiledAgentBinding): boolean;
+export declare function isMemoryCapableBinding(binding: CompiledAgentBinding): boolean;

package/dist/workspace/support/agent-capabilities.js

@@ -0,0 +1,30 @@
+function normalizeCapabilities(capabilities) {
+    return {
+        delegation: capabilities?.delegation === true,
+        memory: capabilities?.memory === true,
+    };
+}
+export function inferAgentCapabilities(agent) {
+    if (agent.capabilities) {
+        return normalizeCapabilities(agent.capabilities);
+    }
+    return {
+        delegation: agent.executionMode === "deepagent",
+        memory: agent.executionMode === "deepagent",
+    };
+}
+export function inferBindingCapabilities(binding) {
+    return normalizeCapabilities(binding.harnessRuntime.capabilities ?? binding.agent.capabilities ?? inferAgentCapabilities(binding.agent));
+}
+export function isDelegationCapableAgent(agent) {
+    return inferAgentCapabilities(agent).delegation === true;
+}
+export function isMemoryCapableAgent(agent) {
+    return inferAgentCapabilities(agent).memory === true;
+}
+export function isDelegationCapableBinding(binding) {
+    return inferBindingCapabilities(binding).delegation === true;
+}
+export function isMemoryCapableBinding(binding) {
+    return inferBindingCapabilities(binding).memory === true;
+}

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

@@ -21,10 +21,14 @@ export type RecoveryConfig = {
     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

@@ -47,10 +47,24 @@ export function getRecoveryConfig(refs) {
         : 3;
     return {
         enabled: recovery.enabled !== false,
-        resumeResumingRunsOnStartup: recovery.resumeResumingRunsOnStartup !== 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,10 +1,16 @@
+import { isDelegationCapableAgent, isMemoryCapableAgent } from "./support/agent-capabilities.js";
 const allowedExecutionModes = new Set(["deepagent", "langchain-v1"]);
 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;
     }
@@ -47,14 +53,14 @@ export function validateAgent(agent) {
     if (!agent.description.trim()) {
         throw new Error(`Agent ${agent.id} description must not be empty`);
     }
-    if (agent.executionMode === "langchain-v1" && (agent.subagentRefs.length > 0 || agent.subagentPathRefs.length > 0)) {
-        throw new Error(`Agent ${agent.id} cannot define subagents unless execution.mode is deepagent`);
+    if (!isDelegationCapableAgent(agent) && (agent.subagentRefs.length > 0 || agent.subagentPathRefs.length > 0)) {
+        throw new Error(`Agent ${agent.id} cannot define subagents unless it uses a delegation-capable backend`);
     }
-    if (agent.executionMode === "langchain-v1" && agent.memorySources.length > 0) {
-        throw new Error(`Agent ${agent.id} cannot define memory unless execution.mode is deepagent`);
+    if (!isMemoryCapableAgent(agent) && agent.memorySources.length > 0) {
+        throw new Error(`Agent ${agent.id} cannot define memory unless it uses a memory-capable backend`);
     }
-    if ((agent.subagentRefs.length > 0 || agent.subagentPathRefs.length > 0) && agent.executionMode !== "deepagent") {
-        throw new Error(`Agent ${agent.id} must use deepagent execution when subagents are defined`);
+    if ((agent.subagentRefs.length > 0 || agent.subagentPathRefs.length > 0) && !isDelegationCapableAgent(agent)) {
+        throw new Error(`Agent ${agent.id} must use a delegation-capable backend when subagents are defined`);
     }
     validateCheckpointerConfig(agent);
     validateMiddlewareConfig(agent);
@@ -78,8 +84,8 @@ export function validateTopology(agents) {
         if (!referencedSubagentIds.has(agent.id)) {
             continue;
         }
-        if (agent.executionMode !== "deepagent") {
-            throw new Error(`Subagent ${agent.id} must use deepagent execution`);
+        if (!isDelegationCapableAgent(agent)) {
+            throw new Error(`Subagent ${agent.id} must use a delegation-capable backend`);
         }
         if (!hasPromptContent(agent.deepAgentConfig?.systemPrompt)) {
             throw new Error(`Subagent ${agent.id} requires deepagent.systemPrompt`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.41",
+  "version": "0.0.43",
   "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/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": "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",