@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/workspace/tool-hydration.js

@@ -1,280 +1 @@
-import path from "node:path";
-import { createHash } from "node:crypto";
-import { listRemoteMcpTools } from "../resource/resource-impl.js";
-import { ensureExternalResourceSource, isExternalSourceLocator } from "../resource/sources.js";
-import { listResourceTools, listResourceToolsForSource } from "../resource/resource.js";
-import { readToolModuleItems } from "./object-loader.js";
-import { parseMcpServerObject, parseToolObject } from "./resource-compilers.js";
-function toMcpServerConfig(server) {
-    return {
-        transport: server.transport,
-        command: server.command,
-        args: server.args,
-        env: server.env,
-        cwd: server.cwd,
-        url: server.url,
-        token: server.token,
-        headers: server.headers,
-        trustTier: server.trustTier,
-        access: server.access,
-        tenantScope: server.tenantScope,
-        approvalPolicy: server.approvalPolicy,
-        promptInjectionRisk: server.promptInjectionRisk,
-        oauth: server.oauth,
-        labels: server.labels,
-    };
-}
-function readStringArray(value) {
-    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
-}
-function readStringRecord(value) {
-    if (typeof value !== "object" || !value || Array.isArray(value)) {
-        return undefined;
-    }
-    const entries = Object.entries(value).filter((entry) => typeof entry[1] === "string");
-    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
-}
-function asObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value)
-        ? value
-        : undefined;
-}
-function compileRegexList(value, label) {
-    return readStringArray(value).map((pattern) => {
-        try {
-            return new RegExp(pattern);
-        }
-        catch (error) {
-            throw new Error(`${label} contains invalid regex ${JSON.stringify(pattern)}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    });
-}
-function compileMcpToolFilter(serverItem) {
-    return {
-        includeNames: new Set(readStringArray(serverItem.tools)),
-        excludeNames: new Set(readStringArray(serverItem.excludeTools)),
-        includePatterns: compileRegexList(serverItem.toolFilters ?? serverItem.toolFilter, "toolFilter"),
-        excludePatterns: compileRegexList(serverItem.excludeToolFilters ?? serverItem.excludeToolFilter, "excludeToolFilter"),
-    };
-}
-function shouldIncludeRemoteMcpTool(filter, toolName) {
-    const { includeNames, excludeNames, includePatterns, excludePatterns } = filter;
-    const includedByName = includeNames.size === 0 || includeNames.has(toolName);
-    const includedByPattern = includePatterns.length === 0 || includePatterns.some((pattern) => pattern.test(toolName));
-    if (!includedByName || !includedByPattern) {
-        return false;
-    }
-    if (excludeNames.has(toolName)) {
-        return false;
-    }
-    if (excludePatterns.some((pattern) => pattern.test(toolName))) {
-        return false;
-    }
-    return true;
-}
-function canResolveMcpToolsFromExplicitNamesOnly(filter) {
-    return filter.includeNames.size > 0 && filter.includePatterns.length === 0;
-}
-function normalizeAgentMcpServerUsage(item) {
-    const config = asObject(item.config);
-    if (!config) {
-        return item;
-    }
-    return {
-        ...config,
-        ...item,
-    };
-}
-function hasMcpServerUsageOverrides(item) {
-    return [
-        "transport",
-        "command",
-        "args",
-        "env",
-        "cwd",
-        "url",
-        "token",
-        "headers",
-    ].some((key) => item[key] !== undefined);
-}
-function mergeReferencedMcpServer(referencedServer, item, agentId, name, sourcePath) {
-    return {
-        id: `${agentId}.${name}`,
-        transport: item.transport === "stdio" || item.transport === "http" || item.transport === "sse" || item.transport === "websocket"
-            ? item.transport
-            : referencedServer.transport,
-        url: typeof item.url === "string" ? item.url : referencedServer.url,
-        command: typeof item.command === "string" ? item.command : referencedServer.command,
-        args: Array.isArray(item.args)
-            ? item.args.filter((entry) => typeof entry === "string")
-            : referencedServer.args,
-        env: {
-            ...(referencedServer.env ?? {}),
-            ...(readStringRecord(item.env) ?? {}),
-        },
-        cwd: typeof item.cwd === "string" ? item.cwd : referencedServer.cwd,
-        token: typeof item.token === "string" ? item.token : referencedServer.token,
-        headers: {
-            ...(referencedServer.headers ?? {}),
-            ...(readStringRecord(item.headers) ?? {}),
-        },
-        trustTier: item.trustTier === "trusted" || item.trustTier === "reviewed" || item.trustTier === "untrusted"
-            ? item.trustTier
-            : referencedServer.trustTier,
-        access: item.access === "read-only" || item.access === "read-write" ? item.access : referencedServer.access,
-        tenantScope: item.tenantScope === "workspace" ||
-            item.tenantScope === "project" ||
-            item.tenantScope === "tenant" ||
-            item.tenantScope === "cross-tenant"
-            ? item.tenantScope
-            : referencedServer.tenantScope,
-        approvalPolicy: item.approvalPolicy === "always" || item.approvalPolicy === "write" || item.approvalPolicy === "never"
-            ? item.approvalPolicy
-            : referencedServer.approvalPolicy,
-        promptInjectionRisk: item.promptInjectionRisk === "low" || item.promptInjectionRisk === "medium" || item.promptInjectionRisk === "high"
-            ? item.promptInjectionRisk
-            : referencedServer.promptInjectionRisk,
-        oauth: asObject(item.oauth)
-            ? {
-                provider: typeof asObject(item.oauth)?.provider === "string" ? asObject(item.oauth)?.provider : referencedServer.oauth?.provider,
-                scopes: readStringArray(asObject(item.oauth)?.scopes) || referencedServer.oauth?.scopes,
-            }
-            : referencedServer.oauth,
-        labels: readStringArray(item.labels).length > 0 ? readStringArray(item.labels) : referencedServer.labels,
-        sourcePath,
-    };
-}
-async function hydrateExternalToolSource(tools, source, workspaceRoot, toolModuleDiscoveryScope) {
-    const externalRoot = await ensureExternalResourceSource(source, workspaceRoot);
-    const discoveredToolRefs = [];
-    const sourcePrefix = `external.${createHash("sha256").update(source).digest("hex").slice(0, 12)}`;
-    for (const { item, sourcePath } of await readToolModuleItems(path.join(externalRoot, "tools"), { scope: toolModuleDiscoveryScope })) {
-        const toolId = typeof item.id === "string" ? item.id : undefined;
-        if (!toolId) {
-            continue;
-        }
-        const namespacedId = `${sourcePrefix}.${toolId}`;
-        const parsed = parseToolObject({
-            id: namespacedId,
-            kind: "tool",
-            sourcePath,
-            value: {
-                ...item,
-                id: namespacedId,
-            },
-        });
-        tools.set(parsed.id, parsed);
-        discoveredToolRefs.push(`tool/${parsed.id}`);
-    }
-    const sourceTools = await listResourceToolsForSource(source, workspaceRoot);
-    const bundleRefs = [...sourceTools.map((tool) => tool.toolPath), ...discoveredToolRefs];
-    if (bundleRefs.length > 0) {
-        tools.set(source, {
-            id: source,
-            type: "bundle",
-            name: source,
-            description: `External tool resource loaded from ${source}`,
-            bundleRefs,
-            sourcePath: source,
-        });
-    }
-}
-export async function hydrateResourceAndExternalTools(tools, toolSourceRefs, workspaceRoot, toolModuleDiscoveryScope = "recursive") {
-    for (const source of toolSourceRefs) {
-        if (isExternalSourceLocator(source)) {
-            await hydrateExternalToolSource(tools, source, workspaceRoot, toolModuleDiscoveryScope);
-        }
-    }
-    for (const resourceTool of await listResourceTools(toolSourceRefs, workspaceRoot)) {
-        const existing = tools.get(resourceTool.toolPath);
-        tools.set(resourceTool.toolPath, {
-            id: resourceTool.toolPath,
-            type: existing?.type ?? "backend",
-            name: existing?.name || resourceTool.name,
-            description: existing?.description || resourceTool.description,
-            config: existing?.config,
-            embeddingModelRef: existing?.embeddingModelRef,
-            backendOperation: existing?.backendOperation ?? resourceTool.backendOperation,
-            bundleRefs: existing?.bundleRefs ?? [],
-            hitl: existing?.hitl ?? resourceTool.hitl,
-            retryable: existing?.retryable ?? resourceTool.retryable,
-            sourcePath: resourceTool.toolPath,
-        });
-    }
-}
-export async function hydrateAgentMcpTools(agents, mcpServers, tools) {
-    for (const agent of agents) {
-        const discoveredRefs = new Set(agent.toolRefs);
-        for (const rawItem of agent.mcpServers ?? []) {
-            const item = normalizeAgentMcpServerUsage(rawItem);
-            const serverRef = typeof item.ref === "string" ? item.ref.trim() : "";
-            const referencedServerId = serverRef.startsWith("mcp/") ? serverRef.slice(4) : serverRef;
-            const referencedServer = referencedServerId ? mcpServers.get(referencedServerId) : undefined;
-            const name = typeof item.name === "string" && item.name.trim()
-                ? item.name.trim()
-                : referencedServer?.id
-                    ? referencedServer.id
-                    : typeof item.id === "string" && item.id.trim()
-                        ? item.id.trim()
-                        : "";
-            if (!name) {
-                throw new Error(`Agent ${agent.id} has an MCP server entry without a name`);
-            }
-            let serverId = referencedServer?.id;
-            let parsedServer = referencedServer;
-            if (!parsedServer) {
-                serverId = `${agent.id}.${name}`;
-                parsedServer = parseMcpServerObject({
-                    id: serverId,
-                    kind: "mcp",
-                    sourcePath: agent.sourcePath,
-                    value: item,
-                });
-                mcpServers.set(serverId, parsedServer);
-            }
-            else if (referencedServer && hasMcpServerUsageOverrides(item)) {
-                parsedServer = mergeReferencedMcpServer(referencedServer, item, agent.id, name, agent.sourcePath);
-                serverId = parsedServer.id;
-                mcpServers.set(serverId, parsedServer);
-            }
-            const filter = compileMcpToolFilter(item);
-            const remoteTools = canResolveMcpToolsFromExplicitNamesOnly(filter)
-                ? Array.from(filter.includeNames)
-                    .filter((toolName) => shouldIncludeRemoteMcpTool(filter, toolName))
-                    .map((toolName) => ({ name: toolName }))
-                : await listRemoteMcpTools(toMcpServerConfig(parsedServer));
-            for (const remoteTool of remoteTools) {
-                if (!shouldIncludeRemoteMcpTool(filter, remoteTool.name)) {
-                    continue;
-                }
-                const toolId = `mcp.${agent.id}.${name}.${remoteTool.name}`;
-                tools.set(toolId, {
-                    id: toolId,
-                    type: "mcp",
-                    name: remoteTool.name,
-                    description: remoteTool.description ?? remoteTool.name,
-                    config: {
-                        mcp: {
-                            serverRef: `mcp/${serverId}`,
-                        },
-                        mcpServer: {
-                            transport: parsedServer.transport,
-                            ...(parsedServer.trustTier ? { trustTier: parsedServer.trustTier } : {}),
-                            ...(parsedServer.access ? { access: parsedServer.access } : {}),
-                            ...(parsedServer.tenantScope ? { tenantScope: parsedServer.tenantScope } : {}),
-                            ...(parsedServer.approvalPolicy ? { approvalPolicy: parsedServer.approvalPolicy } : {}),
-                            ...(parsedServer.promptInjectionRisk ? { promptInjectionRisk: parsedServer.promptInjectionRisk } : {}),
-                            ...(parsedServer.oauth ? { oauth: parsedServer.oauth } : {}),
-                            ...(parsedServer.labels && parsedServer.labels.length > 0 ? { labels: parsedServer.labels } : {}),
-                        },
-                    },
-                    mcpRef: remoteTool.name,
-                    bundleRefs: [],
-                    sourcePath: agent.sourcePath,
-                });
-                discoveredRefs.add(`tool/${toolId}`);
-            }
-        }
-        agent.toolRefs = Array.from(discoveredRefs);
-    }
-}
+import w from"node:path";import{createHash as k}from"node:crypto";import{listRemoteMcpTools as x}from"../resource/resource-impl.js";import{ensureExternalResourceSource as j,isExternalSourceLocator as $}from"../resource/sources.js";import{listResourceTools as A,listResourceToolsForSource as I}from"../resource/resource.js";import{readToolModuleItems as M}from"./object-loader.js";import{parseMcpServerObject as S,parseToolObject as E}from"./resource-compilers.js";function O(o){return{transport:o.transport,command:o.command,args:o.args,env:o.env,cwd:o.cwd,url:o.url,token:o.token,headers:o.headers,trustTier:o.trustTier,access:o.access,tenantScope:o.tenantScope,approvalPolicy:o.approvalPolicy,promptInjectionRisk:o.promptInjectionRisk,oauth:o.oauth,labels:o.labels}}function y(o){return Array.isArray(o)?o.filter(t=>typeof t=="string"&&t.trim().length>0):[]}function R(o){if(typeof o!="object"||!o||Array.isArray(o))return;const t=Object.entries(o).filter(a=>typeof a[1]=="string");return t.length>0?Object.fromEntries(t):void 0}function g(o){return typeof o=="object"&&o!==null&&!Array.isArray(o)?o:void 0}function b(o,t){return y(o).map(a=>{try{return new RegExp(a)}catch(e){throw new Error(`${t} contains invalid regex ${JSON.stringify(a)}: ${e instanceof Error?e.message:String(e)}`)}})}function F(o){return{includeNames:new Set(y(o.tools)),excludeNames:new Set(y(o.excludeTools)),includePatterns:b(o.toolFilters??o.toolFilter,"toolFilter"),excludePatterns:b(o.excludeToolFilters??o.excludeToolFilter,"excludeToolFilter")}}function P(o,t){const{includeNames:a,excludeNames:e,includePatterns:r,excludePatterns:s}=o,c=a.size===0||a.has(t),f=r.length===0||r.some(p=>p.test(t));return!(!c||!f||e.has(t)||s.some(p=>p.test(t)))}function N(o){return o.includeNames.size>0&&o.includePatterns.length===0}function z(o){const t=g(o.config);return t?{...t,...o}:o}function B(o){return["transport","command","args","env","cwd","url","token","headers"].some(t=>o[t]!==void 0)}function C(o,t,a,e,r){return{id:`${a}.${e}`,transport:t.transport==="stdio"||t.transport==="http"||t.transport==="sse"||t.transport==="websocket"?t.transport:o.transport,url:typeof t.url=="string"?t.url:o.url,command:typeof t.command=="string"?t.command:o.command,args:Array.isArray(t.args)?t.args.filter(s=>typeof s=="string"):o.args,env:{...o.env??{},...R(t.env)??{}},cwd:typeof t.cwd=="string"?t.cwd:o.cwd,token:typeof t.token=="string"?t.token:o.token,headers:{...o.headers??{},...R(t.headers)??{}},trustTier:t.trustTier==="trusted"||t.trustTier==="reviewed"||t.trustTier==="untrusted"?t.trustTier:o.trustTier,access:t.access==="read-only"||t.access==="read-write"?t.access:o.access,tenantScope:t.tenantScope==="workspace"||t.tenantScope==="project"||t.tenantScope==="tenant"||t.tenantScope==="cross-tenant"?t.tenantScope:o.tenantScope,approvalPolicy:t.approvalPolicy==="always"||t.approvalPolicy==="write"||t.approvalPolicy==="never"?t.approvalPolicy:o.approvalPolicy,promptInjectionRisk:t.promptInjectionRisk==="low"||t.promptInjectionRisk==="medium"||t.promptInjectionRisk==="high"?t.promptInjectionRisk:o.promptInjectionRisk,oauth:g(t.oauth)?{provider:typeof g(t.oauth)?.provider=="string"?g(t.oauth)?.provider:o.oauth?.provider,scopes:y(g(t.oauth)?.scopes)||o.oauth?.scopes}:o.oauth,labels:y(t.labels).length>0?y(t.labels):o.labels,sourcePath:r}}async function L(o,t,a,e){const r=await j(t,a),s=[],c=`external.${k("sha256").update(t).digest("hex").slice(0,12)}`;for(const{item:i,sourcePath:h}of await M(w.join(r,"tools"),{scope:e})){const d=typeof i.id=="string"?i.id:void 0;if(!d)continue;const n=`${c}.${d}`,u=E({id:n,kind:"tool",sourcePath:h,value:{...i,id:n}});o.set(u.id,u),s.push(`tool/${u.id}`)}const p=[...(await I(t,a)).map(i=>i.toolPath),...s];p.length>0&&o.set(t,{id:t,type:"bundle",name:t,description:`External tool resource loaded from ${t}`,bundleRefs:p,sourcePath:t})}async function G(o,t,a,e="recursive"){for(const r of t)$(r)&&await L(o,r,a,e);for(const r of await A(t,a)){const s=o.get(r.toolPath);o.set(r.toolPath,{id:r.toolPath,type:s?.type??"backend",name:s?.name||r.name,description:s?.description||r.description,config:s?.config,embeddingModelRef:s?.embeddingModelRef,backendOperation:s?.backendOperation??r.backendOperation,bundleRefs:s?.bundleRefs??[],hitl:s?.hitl??r.hitl,retryable:s?.retryable??r.retryable,sourcePath:r.toolPath})}}async function K(o,t,a){for(const e of o){const r=new Set(e.toolRefs);for(const s of e.mcpServers??[]){const c=z(s),f=typeof c.ref=="string"?c.ref.trim():"",p=f.startsWith("mcp/")?f.slice(4):f,i=p?t.get(p):void 0,h=typeof c.name=="string"&&c.name.trim()?c.name.trim():i?.id?i.id:typeof c.id=="string"&&c.id.trim()?c.id.trim():"";if(!h)throw new Error(`Agent ${e.id} has an MCP server entry without a name`);let d=i?.id,n=i;n?i&&B(c)&&(n=C(i,c,e.id,h,e.sourcePath),d=n.id,t.set(d,n)):(d=`${e.id}.${h}`,n=S({id:d,kind:"mcp",sourcePath:e.sourcePath,value:c}),t.set(d,n));const u=F(c),T=N(u)?Array.from(u.includeNames).filter(l=>P(u,l)).map(l=>({name:l})):await x(O(n));for(const l of T){if(!P(u,l.name))continue;const m=`mcp.${e.id}.${h}.${l.name}`;a.set(m,{id:m,type:"mcp",name:l.name,description:l.description??l.name,config:{mcp:{serverRef:`mcp/${d}`},mcpServer:{transport:n.transport,...n.trustTier?{trustTier:n.trustTier}:{},...n.access?{access:n.access}:{},...n.tenantScope?{tenantScope:n.tenantScope}:{},...n.approvalPolicy?{approvalPolicy:n.approvalPolicy}:{},...n.promptInjectionRisk?{promptInjectionRisk:n.promptInjectionRisk}:{},...n.oauth?{oauth:n.oauth}:{},...n.labels&&n.labels.length>0?{labels:n.labels}:{}}},mcpRef:l.name,bundleRefs:[],sourcePath:e.sourcePath}),r.add(`tool/${m}`)}}e.toolRefs=Array.from(r)}}export{K as hydrateAgentMcpTools,G as hydrateResourceAndExternalTools};

package/dist/workspace/validate.js

@@ -1,99 +1 @@
-import { isDelegationCapableAgent, isMemoryCapableAgent, } from "./support/agent-capabilities.js";
-import { getAgentExecutionConfigValue, getAgentExecutionConfigs } from "./support/agent-execution-config.js";
-const allowedExecutionModes = new Set(["deepagent", "langchain-v1"]);
-function validateCheckpointerConfig(agent) {
-    const checkpointer = getAgentExecutionConfigValue(agent, "checkpointer");
-    if (typeof checkpointer === "boolean") {
-        return;
-    }
-    if (!checkpointer) {
-        return;
-    }
-    const typedCheckpointer = checkpointer;
-    const kind = typeof typedCheckpointer.kind === "string" ? typedCheckpointer.kind : "SqliteSaver";
-    const hasPath = typeof typedCheckpointer.path === "string" && typedCheckpointer.path.trim().length > 0;
-    if (kind === "MemorySaver" && hasPath) {
-        throw new Error(`Agent ${agent.id} checkpointer.path is not supported for kind MemorySaver`);
-    }
-}
-function validateMiddlewareConfig(agent) {
-    const middlewareConfigs = getAgentExecutionConfigs(agent).flatMap((config) => {
-        const middleware = config.middleware;
-        return Array.isArray(middleware) ? middleware : [];
-    });
-    for (const config of middlewareConfigs) {
-        if (typeof config !== "object" || config === null || Array.isArray(config)) {
-            throw new Error(`Agent ${agent.id} middleware entries must be objects`);
-        }
-        const typed = config;
-        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`);
-        }
-        if (kind === "humanInTheLoop" && typeof typed.interruptOn !== "object") {
-            throw new Error(`Agent ${agent.id} humanInTheLoop middleware requires interruptOn`);
-        }
-        if (kind === "completionCallback" && typeof typed.callbackGraphId !== "string") {
-            throw new Error(`Agent ${agent.id} completionCallback middleware requires callbackGraphId`);
-        }
-        if (kind === "filesystem" && agent.executionMode === "deepagent") {
-            throw new Error(`Agent ${agent.id} cannot use filesystem middleware with DeepAgents; configure filesystem behavior through the deepagent backend instead`);
-        }
-        if (kind === "pii" && typeof typed.piiType !== "string") {
-            throw new Error(`Agent ${agent.id} pii middleware requires piiType`);
-        }
-    }
-}
-export function validateAgent(agent) {
-    const asyncSubagents = agent.asyncSubagents ?? [];
-    if (!agent.id) {
-        throw new Error(`Agent id is required in ${agent.sourcePath}`);
-    }
-    if (!allowedExecutionModes.has(agent.executionMode)) {
-        throw new Error(`Agent ${agent.id} has unsupported execution mode ${agent.executionMode}`);
-    }
-    if (!agent.description.trim()) {
-        throw new Error(`Agent ${agent.id} description must not be empty`);
-    }
-    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 || asyncSubagents.length > 0) && !isDelegationCapableAgent(agent)) {
-        throw new Error(`Agent ${agent.id} must use a delegation-capable backend when subagents are defined`);
-    }
-    if (asyncSubagents.length > 0 && agent.executionMode !== "deepagent") {
-        throw new Error(`Agent ${agent.id} async subagents require backend=deepagent`);
-    }
-    validateCheckpointerConfig(agent);
-    validateMiddlewareConfig(agent);
-}
-export function validateTopology(agents) {
-    const ids = new Set();
-    const referencedSubagentIds = new Set();
-    for (const agent of agents) {
-        if (ids.has(agent.id)) {
-            throw new Error(`Duplicate agent id ${agent.id}`);
-        }
-        ids.add(agent.id);
-        for (const ref of agent.subagentRefs) {
-            referencedSubagentIds.add(ref.replace(/^agent\//, ""));
-        }
-    }
-    for (const agent of agents) {
-        if (!referencedSubagentIds.has(agent.id) && !agent.modelRef) {
-            throw new Error(`Agent ${agent.id} modelRef is required`);
-        }
-        if (!referencedSubagentIds.has(agent.id)) {
-            continue;
-        }
-        if (!isDelegationCapableAgent(agent)) {
-            throw new Error(`Subagent ${agent.id} must use a delegation-capable backend`);
-        }
-    }
-}
+import{isDelegationCapableAgent as n,isMemoryCapableAgent as d}from"./support/agent-capabilities.js";import{getAgentExecutionConfigValue as a,getAgentExecutionConfigs as s}from"./support/agent-execution-config.js";const l=new Set(["deepagent","langchain-v1"]);function c(e){const o=a(e,"checkpointer");if(typeof o=="boolean"||!o)return;const i=o,r=typeof i.kind=="string"?i.kind:"SqliteSaver",t=typeof i.path=="string"&&i.path.trim().length>0;if(r==="MemorySaver"&&t)throw new Error(`Agent ${e.id} checkpointer.path is not supported for kind MemorySaver`)}function f(e){const o=s(e).flatMap(i=>{const r=i.middleware;return Array.isArray(r)?r:[]});for(const i of o){if(typeof i!="object"||i===null||Array.isArray(i))throw new Error(`Agent ${e.id} middleware entries must be objects`);const r=i,t=typeof r.kind=="string"?r.kind.trim():"";if(!t)throw new Error(`Agent ${e.id} middleware kind is required`);if(t==="summarization"&&r.model===void 0&&typeof r.modelRef!="string")throw new Error(`Agent ${e.id} summarization middleware requires model or modelRef`);if(t==="modelFallback"&&!Array.isArray(r.fallbackModels)&&!Array.isArray(r.models))throw new Error(`Agent ${e.id} modelFallback middleware requires fallbackModels or models`);if(t==="humanInTheLoop"&&typeof r.interruptOn!="object")throw new Error(`Agent ${e.id} humanInTheLoop middleware requires interruptOn`);if(t==="completionCallback"&&typeof r.callbackGraphId!="string")throw new Error(`Agent ${e.id} completionCallback middleware requires callbackGraphId`);if(t==="filesystem"&&e.executionMode==="deepagent")throw new Error(`Agent ${e.id} cannot use filesystem middleware with DeepAgents; configure filesystem behavior through the deepagent backend instead`);if(t==="pii"&&typeof r.piiType!="string")throw new Error(`Agent ${e.id} pii middleware requires piiType`)}}function h(e){const o=e.asyncSubagents??[];if(!e.id)throw new Error(`Agent id is required in ${e.sourcePath}`);if(!l.has(e.executionMode))throw new Error(`Agent ${e.id} has unsupported execution mode ${e.executionMode}`);if(!e.description.trim())throw new Error(`Agent ${e.id} description must not be empty`);if(!d(e)&&e.memorySources.length>0)throw new Error(`Agent ${e.id} cannot define memory unless it uses a memory-capable backend`);if((e.subagentRefs.length>0||e.subagentPathRefs.length>0||o.length>0)&&!n(e))throw new Error(`Agent ${e.id} must use a delegation-capable backend when subagents are defined`);if(o.length>0&&e.executionMode!=="deepagent")throw new Error(`Agent ${e.id} async subagents require backend=deepagent`);c(e),f(e)}function m(e){const o=new Set,i=new Set;for(const r of e){if(o.has(r.id))throw new Error(`Duplicate agent id ${r.id}`);o.add(r.id);for(const t of r.subagentRefs)i.add(t.replace(/^agent\//,""))}for(const r of e){if(!i.has(r.id)&&!r.modelRef)throw new Error(`Agent ${r.id} modelRef is required`);if(i.has(r.id)&&!n(r))throw new Error(`Subagent ${r.id} must use a delegation-capable backend`)}}export{h as validateAgent,m as validateTopology};