@botbotgo/agent-harness 0.0.474 → 0.0.476

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

@@ -1,613 +1,3 @@
-import path from "node:path";
-import { getSkillInheritancePolicy, resolveToolTargets } from "../tooling/extensions.js";
-import { attachLegacyExecutionAliases } from "../utils/compiled-binding.js";
-import { compileModel, compileTool } from "./resource-compilers.js";
-import { inferAgentCapabilities } from "./support/agent-capabilities.js";
-import { getAgentExecutionConfigValue, getAgentExecutionObject, getAgentExecutionString } from "./support/agent-execution-config.js";
-import { discoverSkillPaths } from "./support/discovery.js";
-import { compileAgentMemories, getProceduralMemoryDefaults, getResilienceConfig, getRuntimeAgentDefaults, getRuntimeDefaults, getRuntimeMemoryDefaults, getRuntimeStorageRoots, getWorkspaceObject, resolvePromptValue, resolveRefId, } from "./support/workspace-ref-utils.js";
-import { WORKSPACE_BOUNDARY_GUIDANCE } from "../runtime/prompts/runtime-prompts.js";
-function requireSkills(pathEntries, workspaceRoot) {
-    return Array.from(new Set(discoverSkillPaths(pathEntries, workspaceRoot)));
-}
-function resolveInheritancePolicy(agent) {
-    return getAgentExecutionString(agent, "skillInheritancePolicy") ?? "default";
-}
-export function compileAgentSkills(workspaceRoot, agent, parentSkills = []) {
-    const policyName = resolveInheritancePolicy(agent);
-    const policy = getSkillInheritancePolicy(policyName);
-    if (!policy) {
-        throw new Error(`Agent ${agent.id} skill inheritance policy ${policyName} is not registered`);
-    }
-    return Array.from(new Set(policy.apply({
-        agent,
-        ownSkills: requireSkills(agent.skillPathRefs, workspaceRoot),
-        parentSkills,
-    })));
-}
-function requireModel(models, ref, ownerId) {
-    const model = models.get(resolveRefId(ref));
-    if (!model) {
-        throw new Error(`Agent ${ownerId} references missing model ${ref}`);
-    }
-    return compileModel(model);
-}
-function compileMiddlewareConfigs(middleware, models, ownerId) {
-    if (!middleware || middleware.length === 0) {
-        return undefined;
-    }
-    return middleware.map((config) => {
-        const compiled = { ...config };
-        if (compiled.kind === "summarization" && typeof compiled.modelRef === "string") {
-            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;
-    });
-}
-function resolveAgentRuntimeName(agent) {
-    const baseName = agent.id;
-    if (baseName.includes(".")) {
-        return baseName;
-    }
-    const normalizedSourcePath = agent.sourcePath.split(path.sep).join("/");
-    if (normalizedSourcePath.includes("/packages/framework/")) {
-        return `core.${baseName}`;
-    }
-    return baseName;
-}
-function asObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value)
-        ? value
-        : undefined;
-}
-function mergeConfigValue(base, override) {
-    if (override === undefined) {
-        return base;
-    }
-    if (Array.isArray(base) && Array.isArray(override)) {
-        return override;
-    }
-    if (typeof base === "object" && base && typeof override === "object" && override && !Array.isArray(base) && !Array.isArray(override)) {
-        const merged = { ...base };
-        for (const [key, value] of Object.entries(override)) {
-            merged[key] = key in merged ? mergeConfigValue(merged[key], value) : value;
-        }
-        return merged;
-    }
-    return override;
-}
-function mergeConfigObjects(base, override) {
-    const merged = mergeConfigValue(base, override);
-    return typeof merged === "object" && merged && !Array.isArray(merged)
-        ? merged
-        : undefined;
-}
-function parseHitlOverride(value) {
-    const record = asObject(value);
-    if (!record) {
-        return undefined;
-    }
-    const enabled = record.enabled === true;
-    const allow = Array.isArray(record.allow)
-        ? record.allow.filter((item) => item === "approve" || item === "edit" || item === "reject")
-        : undefined;
-    return {
-        enabled,
-        allow: allow && allow.length > 0 ? allow : undefined,
-    };
-}
-function applyToolBindingOverrides(tool, binding) {
-    const overrides = binding.overrides;
-    if (!overrides || Object.keys(overrides).length === 0) {
-        return tool;
-    }
-    const overrideConfig = mergeConfigObjects(asObject(overrides.config), asObject(overrides.execution)
-        ? {
-            execution: asObject(overrides.execution),
-        }
-        : undefined);
-    return {
-        ...tool,
-        ...(typeof overrides.name === "string" ? { name: overrides.name } : {}),
-        ...(typeof overrides.description === "string" ? { description: overrides.description } : {}),
-        ...(typeof overrides.implementationName === "string" ? { implementationName: overrides.implementationName } : {}),
-        ...(typeof overrides.inputSchemaRef === "string" ? { inputSchemaRef: overrides.inputSchemaRef } : {}),
-        ...(typeof overrides.embeddingModelRef === "string"
-            ? { embeddingModelRef: overrides.embeddingModelRef }
-            : typeof overrides.embeddingModel === "string"
-                ? {
-                    embeddingModelRef: overrides.embeddingModel.startsWith("embedding-model/")
-                        ? overrides.embeddingModel
-                        : `embedding-model/${overrides.embeddingModel}`,
-                }
-                : {}),
-        ...(typeof overrides.backendOperation === "string" ? { backendOperation: overrides.backendOperation } : {}),
-        ...(typeof overrides.mcpRef === "string" ? { mcpRef: overrides.mcpRef } : {}),
-        ...(typeof overrides.subprocess === "boolean" ? { subprocess: overrides.subprocess } : {}),
-        ...(typeof overrides.retryable === "boolean" ? { retryable: overrides.retryable } : {}),
-        ...(overrides.hitl !== undefined ? { hitl: parseHitlOverride(overrides.hitl) } : {}),
-        ...(overrideConfig ? { config: mergeConfigObjects(tool.config, overrideConfig) } : {}),
-    };
-}
-function getAgentToolBindings(agent) {
-    if (agent.toolBindings && agent.toolBindings.length > 0) {
-        return agent.toolBindings;
-    }
-    return agent.toolRefs.map((ref) => ({ ref }));
-}
-export function requireTools(tools, bindings, ownerId) {
-    const compiled = bindings.flatMap((binding) => {
-        const targets = resolveToolTargets(tools, binding.ref);
-        if (targets.length === 0) {
-            throw new Error(`Agent ${ownerId} references missing tool ${binding.ref}`);
-        }
-        return targets.flatMap((tool) => compileTool(applyToolBindingOverrides(tool, binding), tools));
-    });
-    const deduped = new Map();
-    for (const tool of compiled) {
-        deduped.set(tool.name, tool);
-    }
-    return Array.from(deduped.values());
-}
-function buildSubagent(agent, workspaceRoot, refs, models, tools, parentSkills, parentModel) {
-    const execution = compileExecutionCore(agent, workspaceRoot, refs, models, tools);
-    return {
-        agentId: agent.id,
-        name: resolveAgentRuntimeName(agent),
-        description: agent.description,
-        systemPrompt: execution.systemPrompt ?? WORKSPACE_BOUNDARY_GUIDANCE,
-        tools: execution.tools,
-        model: agent.modelRef ? execution.model : parentModel,
-        interruptOn: resolveInterruptOn(agent),
-        skills: compileAgentSkills(workspaceRoot, agent, parentSkills),
-        responseFormat: execution.responseFormat,
-        middleware: execution.middleware,
-        builtinTools: getAgentExecutionObject(agent, "builtinTools"),
-    };
-}
-function resolveSystemPrompt(agent, workspaceRoot) {
-    const promptBaseDir = path.dirname(agent.sourcePath || workspaceRoot);
-    const prompt = resolvePromptValue(getAgentExecutionConfigValue(agent, "systemPrompt"), promptBaseDir);
-    if (agent.executionMode !== "deepagent") {
-        return prompt;
-    }
-    return [prompt, WORKSPACE_BOUNDARY_GUIDANCE].filter(Boolean).join("\n\n");
-}
-function resolveInterruptOn(agent) {
-    return getAgentExecutionObject(agent, "interruptOn");
-}
-function resolveResponseFormat(agent) {
-    return getAgentExecutionConfigValue(agent, "responseFormat");
-}
-function normalizeResponseFormatRef(ref) {
-    return ref.startsWith("response-format/") ? ref : `response-format/${ref}`;
-}
-function resolveResponseFormatObject(refs, ref, ownerLabel) {
-    if (!ref) {
-        return undefined;
-    }
-    const object = getWorkspaceObject(refs, normalizeResponseFormatRef(ref));
-    if (!object) {
-        throw new Error(`${ownerLabel} responseFormatRef references missing object ${ref}`);
-    }
-    if (object.kind !== "response-format") {
-        throw new Error(`${ownerLabel} responseFormatRef references ${ref}, but expected response-format`);
-    }
-    if (!("format" in object.value)) {
-        throw new Error(`${ownerLabel} responseFormatRef ${ref} must define format`);
-    }
-    return object.value.format;
-}
-function mergeResponseFormats(base, override) {
-    if (override === undefined) {
-        return base;
-    }
-    if (typeof base === "object" &&
-        base &&
-        typeof override === "object" &&
-        override &&
-        !Array.isArray(base) &&
-        !Array.isArray(override)) {
-        const merged = { ...base };
-        for (const [key, value] of Object.entries(override)) {
-            if (key === "required" && Array.isArray(merged.required) && Array.isArray(value)) {
-                merged.required = Array.from(new Set([...merged.required, ...value]));
-                continue;
-            }
-            if (key === "properties" &&
-                typeof merged.properties === "object" &&
-                merged.properties &&
-                !Array.isArray(merged.properties) &&
-                typeof value === "object" &&
-                value &&
-                !Array.isArray(value)) {
-                merged.properties = {
-                    ...merged.properties,
-                    ...value,
-                };
-                continue;
-            }
-            merged[key] = key in merged ? mergeResponseFormats(merged[key], value) : value;
-        }
-        return merged;
-    }
-    return override;
-}
-function resolveInheritedResponseFormat(agent, refs) {
-    const defaults = getRuntimeAgentDefaults(refs);
-    if (defaults && "responseFormat" in defaults) {
-        return defaults.responseFormat === null ? undefined : defaults.responseFormat;
-    }
-    const defaultRef = typeof defaults?.responseFormatRef === "string" ? defaults.responseFormatRef.trim() : "";
-    if (defaultRef) {
-        return resolveResponseFormatObject(refs, defaultRef, "Runtime defaults.agent.config");
-    }
-    return undefined;
-}
-function resolveEffectiveResponseFormat(agent, refs) {
-    const explicitResponseFormat = resolveResponseFormat(agent);
-    if (explicitResponseFormat !== undefined) {
-        return explicitResponseFormat === null
-            ? undefined
-            : mergeResponseFormats(resolveInheritedResponseFormat(agent, refs), explicitResponseFormat);
-    }
-    const explicitRef = getAgentExecutionConfigValue(agent, "responseFormatRef");
-    if (typeof explicitRef === "string" && explicitRef.trim().length > 0) {
-        return resolveResponseFormatObject(refs, explicitRef.trim(), `Agent ${agent.id}`);
-    }
-    return resolveInheritedResponseFormat(agent, refs);
-}
-function resolveContextSchema(agent) {
-    return getAgentExecutionConfigValue(agent, "contextSchema");
-}
-function resolveExecutionContract(agent) {
-    const value = getAgentExecutionObject(agent, "executionContract");
-    if (!value) {
-        return undefined;
-    }
-    const recoveryEvidenceTool = typeof value.recoveryEvidenceTool === "string" && value.recoveryEvidenceTool.trim().length > 0
-        ? { name: value.recoveryEvidenceTool.trim() }
-        : typeof value.recoveryEvidenceTool === "object" && value.recoveryEvidenceTool && !Array.isArray(value.recoveryEvidenceTool)
-            ? value.recoveryEvidenceTool
-            : undefined;
-    const recoveryEvidenceToolName = recoveryEvidenceTool && typeof recoveryEvidenceTool.name === "string" && recoveryEvidenceTool.name.trim().length > 0
-        ? recoveryEvidenceTool.name.trim()
-        : undefined;
-    const recoveryEvidenceToolArgs = recoveryEvidenceTool
-        && typeof recoveryEvidenceTool.args === "object"
-        && recoveryEvidenceTool.args
-        && !Array.isArray(recoveryEvidenceTool.args)
-        ? recoveryEvidenceTool.args
-        : undefined;
-    return {
-        ...(value.requiresPlan === true ? { requiresPlan: true } : {}),
-        ...(recoveryEvidenceToolName
-            ? {
-                recoveryEvidenceTool: {
-                    name: recoveryEvidenceToolName,
-                    ...(recoveryEvidenceToolArgs ? { args: recoveryEvidenceToolArgs } : {}),
-                },
-            }
-            : {}),
-    };
-}
-function resolveCompiledMiddleware(agent, models) {
-    const middleware = getAgentExecutionConfigValue(agent, "middleware");
-    return compileMiddlewareConfigs(middleware, models, agent.id);
-}
-function resolvePassthrough(agent) {
-    const passthrough = getAgentExecutionObject(agent, "passthrough");
-    return passthrough ? { ...passthrough } : undefined;
-}
-function compileSubagents(agent, agents, workspaceRoot, refs, models, tools, compiledAgentSkills, compiledAgentModel) {
-    return 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, refs, models, tools, compiledAgentSkills, compiledAgentModel);
-    });
-}
-function compileAsyncSubagents(agent) {
-    return (agent.asyncSubagents ?? []).map((subagent) => ({
-        name: subagent.name,
-        description: subagent.description,
-        graphId: subagent.graphId,
-        ...(subagent.url ? { url: subagent.url } : {}),
-        ...(subagent.headers ? { headers: { ...subagent.headers } } : {}),
-    }));
-}
-function compileDeepAgentSubagents(agent, agents, workspaceRoot, refs, models, tools, compiledAgentSkills, compiledAgentModel) {
-    return [
-        ...compileSubagents(agent, agents, workspaceRoot, refs, models, tools, compiledAgentSkills, compiledAgentModel),
-        ...compileAsyncSubagents(agent),
-    ];
-}
-function compileExecutionCore(agent, workspaceRoot, refs, models, tools) {
-    return {
-        model: requireModel(models, agent.modelRef, agent.id),
-        tools: requireTools(tools, getAgentToolBindings(agent), agent.id),
-        systemPrompt: resolveSystemPrompt(agent, workspaceRoot),
-        responseFormat: resolveEffectiveResponseFormat(agent, refs),
-        contextSchema: resolveContextSchema(agent),
-        middleware: resolveCompiledMiddleware(agent, models),
-    };
-}
-function resolveBackendConfig(agent, refs) {
-    if (agent.executionMode !== "deepagent") {
-        return undefined;
-    }
-    const backendConfig = getAgentExecutionObject(agent, "backend");
-    if (!backendConfig) {
-        return undefined;
-    }
-    if (isRefConfig(backendConfig)) {
-        return {
-            config: materializeWorkspaceObjectConfig(refs, backendConfig.ref, ["backend"], `Agent ${agent.id} backend`),
-        };
-    }
-    return { config: backendConfig };
-}
-function isRefConfig(value) {
-    if (typeof value?.ref !== "string" || value.ref.trim().length === 0) {
-        return false;
-    }
-    return Object.keys(value).every((key) => key === "ref");
-}
-function mergeOpaqueConfig(base, extra) {
-    if (!base && !extra) {
-        return undefined;
-    }
-    return {
-        ...(base ?? {}),
-        ...(extra ?? {}),
-    };
-}
-function materializeWorkspaceObjectConfig(refs, ref, allowedKinds, ownerLabel) {
-    const object = getWorkspaceObject(refs, ref);
-    if (!object) {
-        throw new Error(`${ownerLabel} references missing object ${ref}`);
-    }
-    if (!allowedKinds.includes(object.kind)) {
-        throw new Error(`${ownerLabel} references ${ref}, but expected one of: ${allowedKinds.join(", ")}`);
-    }
-    const { id: _id, kind: _kind, ...config } = object.value;
-    if (object.kind === "store") {
-        const storeKind = typeof config.storeKind === "string" ? config.storeKind : undefined;
-        const { storeKind: _storeKind, ...rest } = config;
-        return storeKind ? { kind: storeKind, ...rest } : config;
-    }
-    if (object.kind === "checkpointer" || object.kind === "file-checkpointer" || object.kind === "sqlite-saver") {
-        const checkpointerKind = typeof config.checkpointerKind === "string" ? config.checkpointerKind : undefined;
-        const { checkpointerKind: _checkpointerKind, ...rest } = config;
-        return checkpointerKind ? { kind: checkpointerKind, ...rest } : config;
-    }
-    if (object.kind === "backend") {
-        const backendKind = typeof config.backendKind === "string" ? config.backendKind : undefined;
-        const { backendKind: _backendKind, ...rest } = config;
-        return backendKind ? { kind: backendKind, ...rest } : config;
-    }
-    return config;
-}
-function materializeRuntimeMemoryConfig(refs, config, ownerLabel) {
-    const runtimeMemory = { ...config };
-    const nestedStore = asObject(runtimeMemory.store);
-    if (nestedStore && isRefConfig(nestedStore)) {
-        runtimeMemory.store = materializeWorkspaceObjectConfig(refs, nestedStore.ref, ["store"], `${ownerLabel} runtimeMemory.store`);
-    }
-    return runtimeMemory;
-}
-function materializeProceduralMemoryConfig(refs, config, ownerLabel) {
-    const proceduralMemory = { ...config };
-    const nestedStore = asObject(proceduralMemory.store);
-    if (nestedStore && isRefConfig(nestedStore)) {
-        proceduralMemory.store = materializeWorkspaceObjectConfig(refs, nestedStore.ref, ["store"], `${ownerLabel} proceduralMemory.store`);
-    }
-    const nestedVectorStore = asObject(proceduralMemory.vectorStore);
-    if (nestedVectorStore && isRefConfig(nestedVectorStore)) {
-        proceduralMemory.vectorStore = materializeWorkspaceObjectConfig(refs, nestedVectorStore.ref, ["vector-store"], `${ownerLabel} proceduralMemory.vectorStore`);
-    }
-    const nestedEmbeddingModel = asObject(proceduralMemory.embeddingModel);
-    if (nestedEmbeddingModel && isRefConfig(nestedEmbeddingModel)) {
-        proceduralMemory.embeddingModel = materializeWorkspaceObjectConfig(refs, nestedEmbeddingModel.ref, ["embedding-model"], `${ownerLabel} proceduralMemory.embeddingModel`);
-    }
-    return proceduralMemory;
-}
-function resolveStoreConfig(agent, refs) {
-    const inlineStore = getAgentExecutionObject(agent, "store");
-    if (!inlineStore) {
-        return undefined;
-    }
-    if (isRefConfig(inlineStore)) {
-        return {
-            config: materializeWorkspaceObjectConfig(refs, inlineStore.ref, ["store"], `Agent ${agent.id} store`),
-        };
-    }
-    return { config: inlineStore };
-}
-function resolveCheckpointerConfig(agent, refs) {
-    const inlineAgentCheckpointer = getAgentExecutionConfigValue(agent, "checkpointer");
-    if (inlineAgentCheckpointer === undefined) {
-        return undefined;
-    }
-    if (typeof inlineAgentCheckpointer === "boolean") {
-        return { config: inlineAgentCheckpointer };
-    }
-    if (isRefConfig(inlineAgentCheckpointer)) {
-        return {
-            config: materializeWorkspaceObjectConfig(refs, inlineAgentCheckpointer.ref, ["checkpointer", "file-checkpointer", "sqlite-saver"], `Agent ${agent.id} checkpointer`),
-        };
-    }
-    return { config: inlineAgentCheckpointer };
-}
-function resolveRuntimeMemoryConfig(agent, refs) {
-    const inlineRuntimeMemory = agent.runtimeMemory ?? getAgentExecutionObject(agent, "runtimeMemory");
-    if (inlineRuntimeMemory) {
-        if (isRefConfig(inlineRuntimeMemory)) {
-            return {
-                config: materializeRuntimeMemoryConfig(refs, materializeWorkspaceObjectConfig(refs, inlineRuntimeMemory.ref, ["runtime-memory"], `Agent ${agent.id} runtimeMemory`), `Agent ${agent.id}`),
-            };
-        }
-        return { config: materializeRuntimeMemoryConfig(refs, inlineRuntimeMemory, `Agent ${agent.id}`) };
-    }
-    const runtimeMemoryDefaults = getRuntimeMemoryDefaults(refs);
-    return runtimeMemoryDefaults ? { config: materializeRuntimeMemoryConfig(refs, runtimeMemoryDefaults, `Agent ${agent.id}`) } : undefined;
-}
-function resolveProceduralMemoryConfig(agent, refs) {
-    const inlineProceduralMemory = agent.proceduralMemory ?? getAgentExecutionObject(agent, "proceduralMemory");
-    if (inlineProceduralMemory) {
-        if (isRefConfig(inlineProceduralMemory)) {
-            return {
-                config: materializeProceduralMemoryConfig(refs, materializeWorkspaceObjectConfig(refs, inlineProceduralMemory.ref, ["procedural-memory"], `Agent ${agent.id} proceduralMemory`), `Agent ${agent.id}`),
-            };
-        }
-        return { config: materializeProceduralMemoryConfig(refs, inlineProceduralMemory, `Agent ${agent.id}`) };
-    }
-    const proceduralMemoryDefaults = getProceduralMemoryDefaults(refs);
-    return proceduralMemoryDefaults
-        ? { config: materializeProceduralMemoryConfig(refs, proceduralMemoryDefaults, `Agent ${agent.id}`) }
-        : undefined;
-}
-export function compileBinding(workspaceRoot, agent, agents, referencedSubagentIds, refs, models, tools) {
-    const internalSubagent = referencedSubagentIds.has(agent.id);
-    const runtimeDefaults = getRuntimeDefaults(refs);
-    const runtimeStorage = getRuntimeStorageRoots(refs, workspaceRoot);
-    const resilience = getResilienceConfig(refs);
-    const compiledAgentSkills = compileAgentSkills(workspaceRoot, agent);
-    const compiledAgentMemory = compileAgentMemories(workspaceRoot, agent.memorySources);
-    const executionCore = compileExecutionCore({
-        ...agent,
-        modelRef: agent.modelRef || (internalSubagent ? "model/default" : ""),
-    }, workspaceRoot, refs, models, tools);
-    const passthrough = resolvePassthrough(agent);
-    const compiledAgentModel = executionCore.model;
-    const backend = resolveBackendConfig(agent, refs);
-    const store = resolveStoreConfig(agent, refs);
-    const checkpointer = resolveCheckpointerConfig(agent, refs);
-    const runtimeMemory = resolveRuntimeMemoryConfig(agent, refs);
-    const proceduralMemory = resolveProceduralMemoryConfig(agent, refs);
-    const runtimeFilesystemDefaults = agent.executionMode === "langchain-v1"
-        ? asObject(runtimeDefaults?.filesystem)
-        : undefined;
-    const runtimeGovernanceDefaults = asObject(runtimeDefaults?.governance);
-    const runtimeObservabilityDefaults = asObject(runtimeDefaults?.observability);
-    const executionContract = resolveExecutionContract(agent);
-    const compiledFilesystemConfig = agent.executionMode === "langchain-v1"
-        ? mergeConfigObjects(runtimeFilesystemDefaults, getAgentExecutionObject(agent, "filesystem", { executionMode: "langchain-v1" }))
-        : undefined;
-    const runtimeRoot = typeof agent.runtimeRoot === "string" && agent.runtimeRoot.trim().length > 0
-        ? (path.isAbsolute(agent.runtimeRoot) ? agent.runtimeRoot : path.resolve(runtimeStorage.dataRoot, agent.runtimeRoot))
-        : runtimeStorage.dataRoot;
-    const base = {
-        agent,
-        harnessRuntime: {
-            applicationRoot: runtimeStorage.applicationRoot,
-            dataRoot: runtimeStorage.dataRoot,
-            runtimeProfile: runtimeStorage.runtimeProfile,
-            runtimeRoot,
-            workspaceRoot: runtimeStorage.applicationRoot,
-            capabilities: inferAgentCapabilities(agent),
-            resilience,
-            ...(runtimeGovernanceDefaults ? { governance: runtimeGovernanceDefaults } : {}),
-            ...(runtimeObservabilityDefaults ? { observability: runtimeObservabilityDefaults } : {}),
-            ...(executionContract ? { executionContract } : {}),
-            ...(agent.executionMode === "deepagent"
-                ? {
-                    deepagent: {
-                        description: agent.description,
-                        passthrough,
-                    },
-                }
-                : {}),
-            ...(agent.executionMode === "langchain-v1"
-                ? {
-                    langchain: {
-                        passthrough,
-                        interruptOn: resolveInterruptOn(agent),
-                        filesystem: compiledFilesystemConfig,
-                        subagents: compileSubagents(agent, agents, workspaceRoot, refs, models, tools, compiledAgentSkills, compiledAgentModel),
-                        memory: compiledAgentMemory,
-                        skills: compiledAgentSkills,
-                        generalPurposeAgent: getAgentExecutionConfigValue(agent, "generalPurposeAgent", { executionMode: "langchain-v1" }),
-                        taskDescription: getAgentExecutionString(agent, "taskDescription", { executionMode: "langchain-v1" }),
-                    },
-                }
-                : {}),
-            ...(checkpointer ? { checkpointer: checkpointer.config } : {}),
-            ...(store ? { store: store.config } : {}),
-            ...(runtimeMemory ? { runtimeMemory: runtimeMemory.config } : {}),
-            ...(proceduralMemory ? { proceduralMemory: proceduralMemory.config } : {}),
-        },
-    };
-    if (agent.executionMode !== "deepagent") {
-        const langchainVersion = getAgentExecutionConfigValue(agent, "version", { executionMode: "langchain-v1" });
-        const executionBinding = {
-            kind: "langchain-v1",
-            params: {
-                model: executionCore.model,
-                tools: executionCore.tools,
-                systemPrompt: executionCore.systemPrompt,
-                stateSchema: getAgentExecutionConfigValue(agent, "stateSchema", { executionMode: "langchain-v1" }),
-                responseFormat: executionCore.responseFormat,
-                contextSchema: executionCore.contextSchema,
-                middleware: executionCore.middleware,
-                includeAgentName: getAgentExecutionConfigValue(agent, "includeAgentName", { executionMode: "langchain-v1" }) === "inline" ? "inline" : undefined,
-                version: langchainVersion === "v1" || langchainVersion === "v2"
-                    ? langchainVersion
-                    : undefined,
-                name: resolveAgentRuntimeName(agent),
-                description: agent.description,
-                builtinTools: getAgentExecutionObject(agent, "builtinTools"),
-            },
-        };
-        return attachLegacyExecutionAliases({
-            ...base,
-            execution: executionBinding,
-        });
-    }
-    const executionBinding = {
-        kind: "deepagent",
-        params: {
-            model: executionCore.model,
-            tools: executionCore.tools,
-            systemPrompt: executionCore.systemPrompt,
-            responseFormat: executionCore.responseFormat,
-            contextSchema: executionCore.contextSchema,
-            middleware: executionCore.middleware,
-            subagents: compileDeepAgentSubagents(agent, agents, workspaceRoot, refs, models, tools, compiledAgentSkills, compiledAgentModel),
-            interruptOn: resolveInterruptOn(agent),
-            ...(backend ? { backend: backend.config } : {}),
-            ...(store ? { store: store.config } : {}),
-            name: resolveAgentRuntimeName(agent),
-            memory: compiledAgentMemory,
-            skills: compiledAgentSkills,
-            interactionMode: getAgentExecutionConfigValue(agent, "interactionMode", { executionMode: "deepagent" }) === "invoke"
-                ? "invoke"
-                : getAgentExecutionConfigValue(agent, "interactionMode", { executionMode: "deepagent" }) === "stream"
-                    ? "stream"
-                    : undefined,
-            builtinTools: getAgentExecutionObject(agent, "builtinTools"),
-        },
-    };
-    return attachLegacyExecutionAliases({
-        ...base,
-        execution: executionBinding,
-    });
-}
+import A from"node:path";import{getSkillInheritancePolicy as ne,resolveToolTargets as oe}from"../tooling/extensions.js";import{attachLegacyExecutionAliases as B}from"../utils/compiled-binding.js";import{compileModel as re,compileTool as te}from"./resource-compilers.js";import{inferAgentCapabilities as ie}from"./support/agent-capabilities.js";import{getAgentExecutionConfigValue as f,getAgentExecutionObject as m,getAgentExecutionString as N}from"./support/agent-execution-config.js";import{discoverSkillPaths as ce}from"./support/discovery.js";import{compileAgentMemories as se,getProceduralMemoryDefaults as de,getResilienceConfig as ue,getRuntimeAgentDefaults as le,getRuntimeDefaults as fe,getRuntimeMemoryDefaults as me,getRuntimeStorageRoots as ae,getWorkspaceObject as I,resolvePromptValue as pe,resolveRefId as z}from"./support/workspace-ref-utils.js";import{WORKSPACE_BOUNDARY_GUIDANCE as _}from"../runtime/prompts/runtime-prompts.js";function ye(n,e){return Array.from(new Set(ce(n,e)))}function ge(n){return N(n,"skillInheritancePolicy")??"default"}function V(n,e,o=[]){const t=ge(e),r=ne(t);if(!r)throw new Error(`Agent ${e.id} skill inheritance policy ${t} is not registered`);return Array.from(new Set(r.apply({agent:e,ownSkills:ye(e.skillPathRefs,n),parentSkills:o})))}function k(n,e,o){const t=n.get(z(e));if(!t)throw new Error(`Agent ${o} references missing model ${e}`);return re(t)}function he(n,e,o){if(!(!n||n.length===0))return n.map(t=>{const r={...t};if(r.kind==="summarization"&&typeof r.modelRef=="string"&&(r.model=k(e,r.modelRef,o),delete r.modelRef),r.kind==="llmToolSelector"&&typeof r.modelRef=="string"&&(r.model=k(e,r.modelRef,o),delete r.modelRef),r.kind==="modelFallback"){const c=Array.isArray(r.fallbackModelRefs)?r.fallbackModelRefs:Array.isArray(r.modelRefs)?r.modelRefs:[];c.length>0&&(r.fallbackModels=c.map(s=>k(e,String(s),o)),delete r.fallbackModelRefs,delete r.modelRefs)}return r})}function v(n){const e=n.id;return e.includes(".")?e:n.sourcePath.split(A.sep).join("/").includes("/packages/framework/")?`core.${e}`:e}function a(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)?n:void 0}function W(n,e){if(e===void 0)return n;if(Array.isArray(n)&&Array.isArray(e))return e;if(typeof n=="object"&&n&&typeof e=="object"&&e&&!Array.isArray(n)&&!Array.isArray(e)){const o={...n};for(const[t,r]of Object.entries(e))o[t]=t in o?W(o[t],r):r;return o}return e}function R(n,e){const o=W(n,e);return typeof o=="object"&&o&&!Array.isArray(o)?o:void 0}function be(n){const e=a(n);if(!e)return;const o=e.enabled===!0,t=Array.isArray(e.allow)?e.allow.filter(r=>r==="approve"||r==="edit"||r==="reject"):void 0;return{enabled:o,allow:t&&t.length>0?t:void 0}}function Ae(n,e){const o=e.overrides;if(!o||Object.keys(o).length===0)return n;const t=R(a(o.config),a(o.execution)?{execution:a(o.execution)}:void 0);return{...n,...typeof o.name=="string"?{name:o.name}:{},...typeof o.description=="string"?{description:o.description}:{},...typeof o.implementationName=="string"?{implementationName:o.implementationName}:{},...typeof o.inputSchemaRef=="string"?{inputSchemaRef:o.inputSchemaRef}:{},...typeof o.embeddingModelRef=="string"?{embeddingModelRef:o.embeddingModelRef}:typeof o.embeddingModel=="string"?{embeddingModelRef:o.embeddingModel.startsWith("embedding-model/")?o.embeddingModel:`embedding-model/${o.embeddingModel}`}:{},...typeof o.backendOperation=="string"?{backendOperation:o.backendOperation}:{},...typeof o.mcpRef=="string"?{mcpRef:o.mcpRef}:{},...typeof o.subprocess=="boolean"?{subprocess:o.subprocess}:{},...typeof o.retryable=="boolean"?{retryable:o.retryable}:{},...o.hitl!==void 0?{hitl:be(o.hitl)}:{},...t?{config:R(n.config,t)}:{}}}function ke(n){return n.toolBindings&&n.toolBindings.length>0?n.toolBindings:n.toolRefs.map(e=>({ref:e}))}function Me(n,e,o){const t=e.flatMap(c=>{const s=oe(n,c.ref);if(s.length===0)throw new Error(`Agent ${o} references missing tool ${c.ref}`);return s.flatMap(i=>te(Ae(i,c),n))}),r=new Map;for(const c of t)r.set(c.name,c);return Array.from(r.values())}function ve(n,e,o,t,r,c,s){const i=J(n,e,o,t,r);return{agentId:n.id,name:v(n),description:n.description,systemPrompt:i.systemPrompt??_,tools:i.tools,model:n.modelRef?i.model:s,interruptOn:x(n),skills:V(e,n,c),responseFormat:i.responseFormat,middleware:i.middleware,builtinTools:m(n,"builtinTools")}}function Re(n,e){const o=A.dirname(n.sourcePath||e),t=pe(f(n,"systemPrompt"),o);return n.executionMode!=="deepagent"?t:[t,_].filter(Boolean).join(`
+
+`)}function x(n){return m(n,"interruptOn")}function xe(n){return f(n,"responseFormat")}function Se(n){return n.startsWith("response-format/")?n:`response-format/${n}`}function G(n,e,o){if(!e)return;const t=I(n,Se(e));if(!t)throw new Error(`${o} responseFormatRef references missing object ${e}`);if(t.kind!=="response-format")throw new Error(`${o} responseFormatRef references ${e}, but expected response-format`);if(!("format"in t.value))throw new Error(`${o} responseFormatRef ${e} must define format`);return t.value.format}function U(n,e){if(e===void 0)return n;if(typeof n=="object"&&n&&typeof e=="object"&&e&&!Array.isArray(n)&&!Array.isArray(e)){const o={...n};for(const[t,r]of Object.entries(e)){if(t==="required"&&Array.isArray(o.required)&&Array.isArray(r)){o.required=Array.from(new Set([...o.required,...r]));continue}if(t==="properties"&&typeof o.properties=="object"&&o.properties&&!Array.isArray(o.properties)&&typeof r=="object"&&r&&!Array.isArray(r)){o.properties={...o.properties,...r};continue}o[t]=t in o?U(o[t],r):r}return o}return e}function H(n,e){const o=le(e);if(o&&"responseFormat"in o)return o.responseFormat===null?void 0:o.responseFormat;const t=typeof o?.responseFormatRef=="string"?o.responseFormatRef.trim():"";if(t)return G(e,t,"Runtime defaults.agent.config")}function $e(n,e){const o=xe(n);if(o!==void 0)return o===null?void 0:U(H(n,e),o);const t=f(n,"responseFormatRef");return typeof t=="string"&&t.trim().length>0?G(e,t.trim(),`Agent ${n.id}`):H(n,e)}function Pe(n){return f(n,"contextSchema")}function Ce(n){const e=m(n,"executionContract");if(!e)return;const o=typeof e.recoveryEvidenceTool=="string"&&e.recoveryEvidenceTool.trim().length>0?{name:e.recoveryEvidenceTool.trim()}:typeof e.recoveryEvidenceTool=="object"&&e.recoveryEvidenceTool&&!Array.isArray(e.recoveryEvidenceTool)?e.recoveryEvidenceTool:void 0,t=o&&typeof o.name=="string"&&o.name.trim().length>0?o.name.trim():void 0,r=o&&typeof o.args=="object"&&o.args&&!Array.isArray(o.args)?o.args:void 0;return{...e.requiresPlan===!0?{requiresPlan:!0}:{},...t?{recoveryEvidenceTool:{name:t,...r?{args:r}:{}}}:{}}}function Ee(n,e){const o=f(n,"middleware");return he(o,e,n.id)}function je(n){const e=m(n,"passthrough");return e?{...e}:void 0}function Y(n,e,o,t,r,c,s,i){return n.subagentRefs.map(d=>{const l=e.get(z(d));if(!l)throw new Error(`Missing subagent ${d} for agent ${n.id}`);return ve(l,o,t,r,c,s,i)})}function Fe(n){return(n.asyncSubagents??[]).map(e=>({name:e.name,description:e.description,graphId:e.graphId,...e.url?{url:e.url}:{},...e.headers?{headers:{...e.headers}}:{}}))}function we(n,e,o,t,r,c,s,i){return[...Y(n,e,o,t,r,c,s,i),...Fe(n)]}function J(n,e,o,t,r){return{model:k(t,n.modelRef,n.id),tools:Me(r,ke(n),n.id),systemPrompt:Re(n,e),responseFormat:$e(n,o),contextSchema:Pe(n),middleware:Ee(n,t)}}function Oe(n,e){if(n.executionMode!=="deepagent")return;const o=m(n,"backend");if(o)return p(o)?{config:y(e,o.ref,["backend"],`Agent ${n.id} backend`)}:{config:o}}function p(n){return typeof n?.ref!="string"||n.ref.trim().length===0?!1:Object.keys(n).every(e=>e==="ref")}function He(n,e){if(!(!n&&!e))return{...n??{},...e??{}}}function y(n,e,o,t){const r=I(n,e);if(!r)throw new Error(`${t} references missing object ${e}`);if(!o.includes(r.kind))throw new Error(`${t} references ${e}, but expected one of: ${o.join(", ")}`);const{id:c,kind:s,...i}=r.value;if(r.kind==="store"){const d=typeof i.storeKind=="string"?i.storeKind:void 0,{storeKind:l,...g}=i;return d?{kind:d,...g}:i}if(r.kind==="checkpointer"||r.kind==="file-checkpointer"||r.kind==="sqlite-saver"){const d=typeof i.checkpointerKind=="string"?i.checkpointerKind:void 0,{checkpointerKind:l,...g}=i;return d?{kind:d,...g}:i}if(r.kind==="backend"){const d=typeof i.backendKind=="string"?i.backendKind:void 0,{backendKind:l,...g}=i;return d?{kind:d,...g}:i}return i}function S(n,e,o){const t={...e},r=a(t.store);return r&&p(r)&&(t.store=y(n,r.ref,["store"],`${o} runtimeMemory.store`)),t}function $(n,e,o){const t={...e},r=a(t.store);r&&p(r)&&(t.store=y(n,r.ref,["store"],`${o} proceduralMemory.store`));const c=a(t.vectorStore);c&&p(c)&&(t.vectorStore=y(n,c.ref,["vector-store"],`${o} proceduralMemory.vectorStore`));const s=a(t.embeddingModel);return s&&p(s)&&(t.embeddingModel=y(n,s.ref,["embedding-model"],`${o} proceduralMemory.embeddingModel`)),t}function Te(n,e){const o=m(n,"store");if(o)return p(o)?{config:y(e,o.ref,["store"],`Agent ${n.id} store`)}:{config:o}}function De(n,e){const o=f(n,"checkpointer");if(o!==void 0)return typeof o=="boolean"?{config:o}:p(o)?{config:y(e,o.ref,["checkpointer","file-checkpointer","sqlite-saver"],`Agent ${n.id} checkpointer`)}:{config:o}}function Ke(n,e){const o=n.runtimeMemory??m(n,"runtimeMemory");if(o)return p(o)?{config:S(e,y(e,o.ref,["runtime-memory"],`Agent ${n.id} runtimeMemory`),`Agent ${n.id}`)}:{config:S(e,o,`Agent ${n.id}`)};const t=me(e);return t?{config:S(e,t,`Agent ${n.id}`)}:void 0}function qe(n,e){const o=n.proceduralMemory??m(n,"proceduralMemory");if(o)return p(o)?{config:$(e,y(e,o.ref,["procedural-memory"],`Agent ${n.id} proceduralMemory`),`Agent ${n.id}`)}:{config:$(e,o,`Agent ${n.id}`)};const t=de(e);return t?{config:$(e,t,`Agent ${n.id}`)}:void 0}function Ye(n,e,o,t,r,c,s){const i=t.has(e.id),d=fe(r),l=ae(r,n),g=ue(r),h=V(n,e),P=se(n,e.memorySources),u=J({...e,modelRef:e.modelRef||(i?"model/default":"")},n,r,c,s),C=je(e),E=u.model,j=Oe(e,r),b=Te(e,r),F=De(e,r),w=Ke(e,r),O=qe(e,r),Q=e.executionMode==="langchain-v1"?a(d?.filesystem):void 0,T=a(d?.governance),D=a(d?.observability),K=Ce(e),X=e.executionMode==="langchain-v1"?R(Q,m(e,"filesystem",{executionMode:"langchain-v1"})):void 0,Z=typeof e.runtimeRoot=="string"&&e.runtimeRoot.trim().length>0?A.isAbsolute(e.runtimeRoot)?e.runtimeRoot:A.resolve(l.dataRoot,e.runtimeRoot):l.dataRoot,q={agent:e,harnessRuntime:{applicationRoot:l.applicationRoot,dataRoot:l.dataRoot,runtimeProfile:l.runtimeProfile,runtimeRoot:Z,workspaceRoot:l.applicationRoot,capabilities:ie(e),resilience:g,...T?{governance:T}:{},...D?{observability:D}:{},...K?{executionContract:K}:{},...e.executionMode==="deepagent"?{deepagent:{description:e.description,passthrough:C}}:{},...e.executionMode==="langchain-v1"?{langchain:{passthrough:C,interruptOn:x(e),filesystem:X,subagents:Y(e,o,n,r,c,s,h,E),memory:P,skills:h,generalPurposeAgent:f(e,"generalPurposeAgent",{executionMode:"langchain-v1"}),taskDescription:N(e,"taskDescription",{executionMode:"langchain-v1"})}}:{},...F?{checkpointer:F.config}:{},...b?{store:b.config}:{},...w?{runtimeMemory:w.config}:{},...O?{proceduralMemory:O.config}:{}}};if(e.executionMode!=="deepagent"){const M=f(e,"version",{executionMode:"langchain-v1"}),ee={kind:"langchain-v1",params:{model:u.model,tools:u.tools,systemPrompt:u.systemPrompt,stateSchema:f(e,"stateSchema",{executionMode:"langchain-v1"}),responseFormat:u.responseFormat,contextSchema:u.contextSchema,middleware:u.middleware,includeAgentName:f(e,"includeAgentName",{executionMode:"langchain-v1"})==="inline"?"inline":void 0,version:M==="v1"||M==="v2"?M:void 0,name:v(e),description:e.description,builtinTools:m(e,"builtinTools")}};return B({...q,execution:ee})}const L={kind:"deepagent",params:{model:u.model,tools:u.tools,systemPrompt:u.systemPrompt,responseFormat:u.responseFormat,contextSchema:u.contextSchema,middleware:u.middleware,subagents:we(e,o,n,r,c,s,h,E),interruptOn:x(e),...j?{backend:j.config}:{},...b?{store:b.config}:{},name:v(e),memory:P,skills:h,interactionMode:f(e,"interactionMode",{executionMode:"deepagent"})==="invoke"?"invoke":f(e,"interactionMode",{executionMode:"deepagent"})==="stream"?"stream":void 0,builtinTools:m(e,"builtinTools")}};return B({...q,execution:L})}export{V as compileAgentSkills,Ye as compileBinding,Me as requireTools};