@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/workspace/object-loader.js

@@ -1,754 +1 @@
-import path from "node:path";
-import { existsSync } from "node:fs";
-import { readdir, readFile, stat } from "node:fs/promises";
-import { pathToFileURL } from "node:url";
-import { resolveIsolatedResourceModulePath } from "../resource/isolation.js";
-import { discoverToolModuleDefinitions, isSupportedToolModulePath, loadToolModuleDefinition } from "../tooling/module-loader.js";
-import { fileExists, shouldSkipScanDirectory } from "../utils/fs.js";
-import { isFileSourceUri, readRuntimeSources, resolveFileSourcePath } from "./support/source-protocols.js";
-import { readNamedYamlItems, readYamlItems, } from "./yaml-object-reader.js";
-import { CONVENTIONAL_OBJECT_DIRECTORIES, MODULE_AGENT_FILENAMES, MODULE_TOOL_ENTRY_FILENAMES, MODULE_TOOL_FILENAMES, conventionalConfigRoot, conventionalObjectRoots, frameworkWorkspaceRoot, moduleCollectionRoot, moduleRootForSourcePath, resolveModuleRelativePath, } from "./object-loader-paths.js";
-import { asMutableObject, asObject, cloneConfigValue, readAsyncSubAgentArray, readCapabilities, readMcpServerArray, readMiddlewareArray, readPathArray, readPrefixedRefArray, readRefArray, readSingleRef, readToolBindingArray, } from "./object-loader-readers.js";
-export { normalizeYamlItem, readYamlItems } from "./yaml-object-reader.js";
-const CONSUMED_AGENT_CONFIG_KEYS = [
-    "systemPrompt",
-    "checkpointer",
-    "interruptOn",
-    "stateSchema",
-    "responseFormat",
-    "responseFormatRef",
-    "contextSchema",
-    "includeAgentName",
-    "version",
-    "middleware",
-    "backend",
-    "store",
-    "runtimeMemory",
-    "proceduralMemory",
-    "taskDescription",
-    "generalPurposeAgent",
-    "filesystem",
-    "builtinTools",
-    "interactionMode",
-    "executionContract",
-];
-const NON_AGENT_CONFIG_ITEM_KEYS = [
-    "id",
-    "kind",
-    "description",
-    "capabilities",
-    "runtime",
-    "executionMode",
-    "sourcePath",
-];
-const RESERVED_AGENT_KEYS = [
-    "backend",
-    "modelRef",
-    "tools",
-    "skills",
-    "memory",
-    "subagents",
-    "mcpServers",
-    "config",
-];
-const MIGRATED_AGENT_CONFIG_KEYS = [
-    "systemPrompt",
-    "checkpointer",
-    "interruptOn",
-    "stateSchema",
-    "responseFormat",
-    "responseFormatRef",
-    "contextSchema",
-    "includeAgentName",
-    "version",
-    "middleware",
-    "store",
-    "taskDescription",
-    "generalPurposeAgent",
-    "filesystem",
-    "builtinTools",
-    "interactionMode",
-    "executionContract",
-];
-function normalizeAgentItemForMerge(item) {
-    const normalized = { ...item };
-    if (normalized.execution !== undefined) {
-        throw new Error("Agent spec.execution is no longer supported; move backend, modelRef, tools, skills, memory, subagents, mcpServers, and config directly under spec");
-    }
-    const config = asMutableObject(normalized.config);
-    const runtime = readRuntimeConfig(normalized);
-    if (config) {
-        for (const key of MIGRATED_AGENT_CONFIG_KEYS) {
-            if (!(key in config) || normalized[key] !== undefined) {
-                continue;
-            }
-            normalized[key] = cloneConfigValue(config[key]);
-            delete config[key];
-        }
-        if (config.runtimeMemory !== undefined && runtime?.runtimeMemory === undefined) {
-            const nextRuntime = runtime ?? {};
-            nextRuntime.runtimeMemory = cloneConfigValue(config.runtimeMemory);
-            normalized.runtime = nextRuntime;
-            delete config.runtimeMemory;
-        }
-        if (config.proceduralMemory !== undefined && runtime?.proceduralMemory === undefined) {
-            const nextRuntime = asMutableObject(normalized.runtime) ?? runtime ?? {};
-            nextRuntime.proceduralMemory = cloneConfigValue(config.proceduralMemory);
-            normalized.runtime = nextRuntime;
-            delete config.proceduralMemory;
-        }
-    }
-    if (config && Object.keys(config).length > 0) {
-        normalized.config = config;
-    }
-    else {
-        delete normalized.config;
-    }
-    return normalized;
-}
-function readExecutionAgentConfig(item) {
-    const config = asMutableObject(item.config) ?? {};
-    const directExecutionConfig = Object.fromEntries(Object.entries(item).filter(([key]) => !RESERVED_AGENT_KEYS.includes(key) &&
-        !NON_AGENT_CONFIG_ITEM_KEYS.includes(key)));
-    return {
-        ...config,
-        ...directExecutionConfig,
-    };
-}
-function readExecutionValue(item, key, reader) {
-    return reader(item[key]);
-}
-function readRuntimeConfig(item) {
-    return asMutableObject(item.runtime);
-}
-function readRuntimeMemoryConfig(item, runtime) {
-    if (typeof runtime?.runtimeMemory === "string" && runtime.runtimeMemory.trim()) {
-        return {
-            ref: runtime.runtimeMemory.startsWith("runtime-memory/")
-                ? runtime.runtimeMemory
-                : `runtime-memory/${runtime.runtimeMemory.trim()}`,
-        };
-    }
-    if (typeof runtime?.runtimeMemory === "object" && runtime.runtimeMemory && !Array.isArray(runtime.runtimeMemory)) {
-        return cloneConfigValue(runtime.runtimeMemory);
-    }
-    const legacyExecutionConfig = readExecutionAgentConfig(item);
-    if (typeof legacyExecutionConfig.runtimeMemory === "string" && legacyExecutionConfig.runtimeMemory.trim()) {
-        return {
-            ref: legacyExecutionConfig.runtimeMemory.startsWith("runtime-memory/")
-                ? legacyExecutionConfig.runtimeMemory
-                : `runtime-memory/${legacyExecutionConfig.runtimeMemory.trim()}`,
-        };
-    }
-    if (typeof legacyExecutionConfig.runtimeMemory === "object" &&
-        legacyExecutionConfig.runtimeMemory &&
-        !Array.isArray(legacyExecutionConfig.runtimeMemory)) {
-        return cloneConfigValue(legacyExecutionConfig.runtimeMemory);
-    }
-    return undefined;
-}
-function readProceduralMemoryConfig(item, runtime) {
-    if (typeof runtime?.proceduralMemory === "string" && runtime.proceduralMemory.trim()) {
-        return {
-            ref: runtime.proceduralMemory.startsWith("procedural-memory/")
-                ? runtime.proceduralMemory
-                : `procedural-memory/${runtime.proceduralMemory.trim()}`,
-        };
-    }
-    if (typeof runtime?.proceduralMemory === "object" && runtime.proceduralMemory && !Array.isArray(runtime.proceduralMemory)) {
-        return cloneConfigValue(runtime.proceduralMemory);
-    }
-    const legacyExecutionConfig = readExecutionAgentConfig(item);
-    if (typeof legacyExecutionConfig.proceduralMemory === "string" && legacyExecutionConfig.proceduralMemory.trim()) {
-        return {
-            ref: legacyExecutionConfig.proceduralMemory.startsWith("procedural-memory/")
-                ? legacyExecutionConfig.proceduralMemory
-                : `procedural-memory/${legacyExecutionConfig.proceduralMemory.trim()}`,
-        };
-    }
-    if (typeof legacyExecutionConfig.proceduralMemory === "object" &&
-        legacyExecutionConfig.proceduralMemory &&
-        !Array.isArray(legacyExecutionConfig.proceduralMemory)) {
-        return cloneConfigValue(legacyExecutionConfig.proceduralMemory);
-    }
-    return undefined;
-}
-function normalizeModulePromptConfig(value, moduleRoot) {
-    if (!moduleRoot || typeof value !== "object" || value === null || Array.isArray(value)) {
-        return value;
-    }
-    const typed = { ...value };
-    if (typeof typed.path === "string") {
-        typed.path = resolveModuleRelativePath(typed.path, moduleRoot);
-    }
-    return typed;
-}
-function normalizeModuleAgentConfig(config, moduleRoot) {
-    if (!moduleRoot) {
-        return config;
-    }
-    return {
-        ...config,
-        ...(config.systemPrompt !== undefined
-            ? { systemPrompt: normalizeModulePromptConfig(config.systemPrompt, moduleRoot) }
-            : {}),
-    };
-}
-function readPassthroughConfig(item, consumedKeys) {
-    const passthrough = Object.fromEntries(Object.entries(item)
-        .filter(([key]) => !consumedKeys.includes(key))
-        .map(([key, value]) => [key, cloneConfigValue(value)]));
-    return Object.keys(passthrough).length > 0 ? passthrough : undefined;
-}
-function resolveExecutionBackend(item, current) {
-    if (item.execution !== undefined || current?.execution !== undefined) {
-        throw new Error("Agent spec.execution is no longer supported; move backend, modelRef, tools, skills, memory, subagents, mcpServers, and config directly under spec");
-    }
-    const mode = typeof item.mode === "string"
-        ? item.mode
-        : typeof current?.mode === "string"
-            ? current.mode
-            : undefined;
-    if (typeof mode === "string" && mode.trim().length > 0) {
-        throw new Error("Agent mode is no longer supported; use backend");
-    }
-    const backend = typeof item.backend === "string"
-        ? item.backend.trim().toLowerCase()
-        : typeof current?.backend === "string"
-            ? current.backend.trim().toLowerCase()
-            : undefined;
-    if (backend === "langchain-v1") {
-        return "langchain-v1";
-    }
-    if (backend === "deepagent") {
-        return "deepagent";
-    }
-    if (backend === "langgraph") {
-        throw new Error("Agent backend=langgraph is no longer supported; use backend=langchain-v1 or backend=deepagent");
-    }
-    return undefined;
-}
-function readSharedAgentConfigFields(config, options = {}) {
-    return {
-        ...(typeof config.store === "object" && config.store ? { store: config.store } : {}),
-        ...(typeof config.builtinTools === "object" && config.builtinTools ? { builtinTools: cloneConfigValue(config.builtinTools) } : {}),
-        ...(options.includeDelegationControls && typeof config.taskDescription === "string" && config.taskDescription.trim()
-            ? { taskDescription: config.taskDescription }
-            : {}),
-        ...(options.includeDelegationControls && typeof config.generalPurposeAgent === "boolean"
-            ? { generalPurposeAgent: config.generalPurposeAgent }
-            : {}),
-    };
-}
-function readSharedAgentConfig(config) {
-    const middleware = readMiddlewareArray(config.middleware);
-    const backend = typeof config.backend === "string" && config.backend.trim()
-        ? { ref: config.backend.startsWith("backend/") ? config.backend : `backend/${config.backend.trim()}` }
-        : typeof config.backend === "object" && config.backend
-            ? config.backend
-            : undefined;
-    const checkpointer = typeof config.checkpointer === "string" && config.checkpointer.trim()
-        ? { ref: config.checkpointer.startsWith("checkpointer/") ? config.checkpointer : `checkpointer/${config.checkpointer.trim()}` }
-        : (typeof config.checkpointer === "object" && config.checkpointer) || typeof config.checkpointer === "boolean"
-            ? config.checkpointer
-            : undefined;
-    const store = typeof config.store === "string" && config.store.trim()
-        ? { ref: config.store.startsWith("store/") ? config.store : `store/${config.store.trim()}` }
-        : typeof config.store === "object" && config.store
-            ? config.store
-            : undefined;
-    return {
-        ...((typeof config.systemPrompt === "string" && config.systemPrompt)
-            || (typeof config.systemPrompt === "object" && config.systemPrompt && !Array.isArray(config.systemPrompt))
-            ? { systemPrompt: cloneConfigValue(config.systemPrompt) }
-            : {}),
-        ...(checkpointer !== undefined ? { checkpointer } : {}),
-        ...(typeof config.interruptOn === "object" && config.interruptOn ? { interruptOn: config.interruptOn } : {}),
-        ...(config.stateSchema !== undefined ? { stateSchema: config.stateSchema } : {}),
-        ...(config.responseFormat !== undefined ? { responseFormat: config.responseFormat } : {}),
-        ...(typeof config.responseFormatRef === "string" && config.responseFormatRef.trim()
-            ? {
-                responseFormatRef: config.responseFormatRef.startsWith("response-format/")
-                    ? config.responseFormatRef
-                    : `response-format/${config.responseFormatRef.trim()}`,
-            }
-            : {}),
-        ...(config.contextSchema !== undefined ? { contextSchema: config.contextSchema } : {}),
-        ...(config.interactionMode === "stream" || config.interactionMode === "invoke" ? { interactionMode: config.interactionMode } : {}),
-        ...(config.includeAgentName === "inline" ? { includeAgentName: "inline" } : {}),
-        ...(config.version === "v1" || config.version === "v2" ? { version: config.version } : {}),
-        ...(typeof config.filesystem === "object" && config.filesystem ? { filesystem: config.filesystem } : {}),
-        ...(typeof config.executionContract === "object" && config.executionContract ? { executionContract: config.executionContract } : {}),
-        ...(backend ? { backend } : {}),
-        ...(store ? { store } : {}),
-        ...(middleware ? { middleware } : {}),
-    };
-}
-function readAgentConfig(item, options = {}) {
-    const config = readExecutionAgentConfig(item);
-    const passthrough = readPassthroughConfig(config, [...CONSUMED_AGENT_CONFIG_KEYS]);
-    return {
-        ...readSharedAgentConfig(config),
-        ...readSharedAgentConfigFields(config, { includeDelegationControls: options.includeDelegationControls }),
-        ...(passthrough ? { passthrough } : {}),
-    };
-}
-export function parseAgentItem(item, sourcePath) {
-    const normalizedItem = normalizeAgentItemForMerge(item);
-    const moduleRoot = moduleRootForSourcePath(sourcePath, "agents");
-    const subagentRefs = readExecutionValue(normalizedItem, "subagents", readRefArray);
-    const toolBindings = readExecutionValue(normalizedItem, "tools", readToolBindingArray);
-    const subagentPathRefs = readExecutionValue(normalizedItem, "subagents", readPathArray)
-        .filter((entry) => path.isAbsolute(entry) || entry.startsWith("./") || entry.startsWith("../"))
-        .map((entry) => resolveModuleRelativePath(entry, moduleRoot));
-    const asyncSubagents = readExecutionValue(normalizedItem, "subagents", readAsyncSubAgentArray);
-    const executionMode = String(resolveExecutionBackend(normalizedItem) ?? "deepagent");
-    const runtime = readRuntimeConfig(normalizedItem);
-    return {
-        id: String(normalizedItem.id),
-        executionMode: executionMode,
-        runtimeMemory: readRuntimeMemoryConfig(normalizedItem, runtime),
-        proceduralMemory: readProceduralMemoryConfig(normalizedItem, runtime),
-        capabilities: readCapabilities(normalizedItem.capabilities) ?? (executionMode === "deepagent"
-            ? { delegation: true, memory: true }
-            : { delegation: true, memory: true }),
-        description: String(normalizedItem.description ?? ""),
-        modelRef: readExecutionValue(normalizedItem, "modelRef", readSingleRef) ?? "",
-        runtimeRoot: typeof runtime?.runtimeRoot === "string" ? runtime.runtimeRoot : undefined,
-        applicationRoot: typeof runtime?.applicationRoot === "string" ? runtime.applicationRoot : undefined,
-        dataRoot: typeof runtime?.dataRoot === "string" ? runtime.dataRoot : undefined,
-        runtimeProfile: typeof runtime?.profile === "string" ? runtime.profile : undefined,
-        toolRefs: toolBindings.map((binding) => binding.ref),
-        toolBindings,
-        inlineTools: undefined,
-        mcpServers: readExecutionValue(normalizedItem, "mcpServers", readMcpServerArray),
-        skillPathRefs: readExecutionValue(normalizedItem, "skills", (value) => readPrefixedRefArray(value, "skill")),
-        memorySources: readExecutionValue(normalizedItem, "memory", readPathArray).map((entry) => resolveModuleRelativePath(entry, moduleRoot)),
-        subagentRefs,
-        subagentPathRefs,
-        asyncSubagents,
-        langchainAgentConfig: normalizeModuleAgentConfig(readAgentConfig(normalizedItem, {
-            includeDelegationControls: executionMode === "langchain-v1",
-        }), moduleRoot),
-        deepAgentConfig: normalizeModuleAgentConfig(readAgentConfig(normalizedItem, {
-            includeObjectBackend: true,
-            includeDelegationControls: false,
-        }), moduleRoot),
-        sourcePath,
-    };
-}
-function parseWorkspaceObject(item, sourcePath) {
-    if (typeof item.id !== "string") {
-        return null;
-    }
-    const inferredKind = typeof item.kind === "string"
-        ? item.kind
-        : path.basename(sourcePath).replace(/\.(yaml|yml|json)$/i, "");
-    if (!inferredKind) {
-        return null;
-    }
-    return {
-        id: item.id,
-        kind: inferredKind,
-        sourcePath,
-        value: item,
-    };
-}
-function mergeValues(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 ? mergeValues(merged[key], value) : value;
-        }
-        return merged;
-    }
-    return override;
-}
-function mergeRawItemRecord(records, key, item, sourcePath) {
-    const current = records.get(key);
-    const mergedItem = current ? mergeValues(current.item, item) : item;
-    const kind = typeof mergedItem.kind === "string" ? mergedItem.kind : undefined;
-    const type = typeof mergedItem.type === "string" ? mergedItem.type : undefined;
-    const resolvedSourcePath = current &&
-        kind === "tool" &&
-        type === "function" &&
-        isSupportedToolModulePath(current.sourcePath) &&
-        !isSupportedToolModulePath(sourcePath)
-        ? current.sourcePath
-        : sourcePath;
-    const mergedRecord = {
-        item: mergedItem,
-        sourcePath: resolvedSourcePath,
-    };
-    records.set(key, mergedRecord);
-    return mergedRecord;
-}
-function mergeAgentRecord(records, item, sourcePath) {
-    const normalizedItem = normalizeAgentItemForMerge(item);
-    const id = typeof normalizedItem.id === "string" ? normalizedItem.id : undefined;
-    if (!id) {
-        return null;
-    }
-    const current = records.get(id);
-    const incomingHasSystemPrompt = normalizedItem.systemPrompt !== undefined;
-    const currentSystemPrompt = current?.item.systemPrompt;
-    const currentCarriesRelativePromptPath = typeof currentSystemPrompt === "object"
-        && currentSystemPrompt !== null
-        && !Array.isArray(currentSystemPrompt)
-        && typeof currentSystemPrompt.path === "string"
-        && !!currentSystemPrompt.path.trim()
-        && !path.isAbsolute(currentSystemPrompt.path);
-    if (current && currentCarriesRelativePromptPath && !incomingHasSystemPrompt) {
-        const currentPromptConfig = currentSystemPrompt;
-        const absolutizedCurrent = {
-            ...current.item,
-            systemPrompt: {
-                ...currentPromptConfig,
-                path: path.resolve(path.dirname(current.sourcePath), currentPromptConfig.path),
-            },
-        };
-        const mergedRecord = {
-            item: mergeValues(absolutizedCurrent, normalizedItem),
-            sourcePath,
-        };
-        records.set(id, mergedRecord);
-        return mergedRecord;
-    }
-    return mergeRawItemRecord(records, id, normalizedItem, sourcePath);
-}
-function mergeWorkspaceObjectRecord(records, workspaceObject, item, sourcePath) {
-    mergeRawItemRecord(records, `${workspaceObject.kind}/${workspaceObject.id}`, item, sourcePath);
-}
-async function loadModuleAgentsForRoot(root, mergedAgents) {
-    const modulesRoot = moduleCollectionRoot(root, "agents");
-    if (!(await fileExists(modulesRoot))) {
-        return;
-    }
-    const entries = await readdir(modulesRoot, { withFileTypes: true });
-    for (const entry of entries.filter((candidate) => candidate.isDirectory()).sort((left, right) => left.name.localeCompare(right.name))) {
-        const moduleRoot = path.join(modulesRoot, entry.name);
-        for (const { item, sourcePath } of await readNamedYamlItems(moduleRoot, [...MODULE_AGENT_FILENAMES])) {
-            const normalizedItem = typeof item.id === "string" && item.id.trim() ? item : { ...item, id: entry.name };
-            if (!isAgentKind(normalizedItem.kind)) {
-                continue;
-            }
-            mergeAgentRecord(mergedAgents, normalizedItem, sourcePath);
-        }
-    }
-}
-function getMergedToolModuleDiscoveryScope(mergedObjects) {
-    const runtimeDefaults = mergedObjects.get("runtime/default")?.item;
-    const toolModuleDiscovery = typeof runtimeDefaults?.toolModuleDiscovery === "object" && runtimeDefaults.toolModuleDiscovery
-        ? runtimeDefaults.toolModuleDiscovery
-        : {};
-    return toolModuleDiscovery.scope === "top-level" ? "top-level" : "recursive";
-}
-async function loadConventionalObjectsForRoot(root, runtimeRoot, mergedObjects, toolModuleDiscoveryScope) {
-    const runtimeDefaults = mergedObjects.get("runtime/default")?.item;
-    const configuredToolRoots = readRuntimeSources(runtimeDefaults).tools
-        .filter((source) => isFileSourceUri(source))
-        .map((source) => resolveFileSourcePath(source, runtimeRoot));
-    const conventionalToolRoots = conventionalObjectRoots(root);
-    const objectRoots = root === runtimeRoot
-        ? Array.from(new Set([
-            ...conventionalToolRoots,
-            ...configuredToolRoots,
-        ]))
-        : conventionalToolRoots;
-    for (const objectRoot of objectRoots) {
-        for (const { item, sourcePath } of await readYamlItemsIgnoringNodeModules(objectRoot)) {
-            const workspaceObject = parseWorkspaceObject(item, sourcePath);
-            if (!workspaceObject) {
-                continue;
-            }
-            mergeWorkspaceObjectRecord(mergedObjects, workspaceObject, item, sourcePath);
-        }
-        for (const { item, sourcePath } of await readToolModuleItems(objectRoot, { scope: toolModuleDiscoveryScope })) {
-            const workspaceObject = parseWorkspaceObject(item, sourcePath);
-            if (!workspaceObject) {
-                continue;
-            }
-            mergeWorkspaceObjectRecord(mergedObjects, workspaceObject, item, sourcePath);
-        }
-    }
-}
-async function readYamlItemsIgnoringNodeModules(root) {
-    if (!(await fileExists(root))) {
-        return [];
-    }
-    const records = [];
-    const pending = [root];
-    while (pending.length > 0) {
-        const current = pending.shift();
-        const entries = await readdir(current, { withFileTypes: true });
-        for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
-            const entryPath = path.join(current, entry.name);
-            const entryType = await resolveScanEntryType(entryPath, entry);
-            if (entryType === "directory") {
-                if (shouldSkipScanDirectory(entry.name)) {
-                    continue;
-                }
-                pending.push(entryPath);
-                continue;
-            }
-            if (entryType !== "file" || (!entry.name.endsWith(".yaml") && !entry.name.endsWith(".yml"))) {
-                continue;
-            }
-            records.push(...(await readNamedYamlItems(current, [entry.name])));
-        }
-    }
-    return records;
-}
-async function readModuleToolItems(root) {
-    const modulesRoot = moduleCollectionRoot(root, "tools");
-    if (!(await fileExists(modulesRoot))) {
-        return [];
-    }
-    const entries = await readdir(modulesRoot, { withFileTypes: true });
-    const records = [];
-    for (const entry of entries.filter((candidate) => candidate.isDirectory()).sort((left, right) => left.name.localeCompare(right.name))) {
-        const moduleRoot = path.join(modulesRoot, entry.name);
-        for (const { item, sourcePath } of await readNamedYamlItems(moduleRoot, [...MODULE_TOOL_FILENAMES])) {
-            const normalizedItem = typeof item.id === "string" && item.id.trim() ? item : { ...item, id: entry.name };
-            const workspaceObject = parseWorkspaceObject(normalizedItem, sourcePath);
-            if (!workspaceObject || workspaceObject.kind !== "tool") {
-                continue;
-            }
-            const implementation = asObject(normalizedItem.implementation);
-            const explicitPath = typeof implementation?.path === "string" ? path.resolve(moduleRoot, implementation.path) : undefined;
-            const discoveredPath = explicitPath ??
-                MODULE_TOOL_ENTRY_FILENAMES.map((filename) => path.join(moduleRoot, filename)).find((candidate) => existsSync(candidate));
-            const inferredType = typeof normalizedItem.type === "string"
-                ? normalizedItem.type
-                : normalizedItem.refs !== undefined || normalizedItem.bundle !== undefined
-                    ? "bundle"
-                    : normalizedItem.providerTool !== undefined || normalizedItem.provider !== undefined
-                        ? "provider"
-                        : normalizedItem.backend !== undefined || normalizedItem.operation !== undefined
-                            ? "backend"
-                            : normalizedItem.mcp !== undefined
-                                ? "mcp"
-                                : "function";
-            if (inferredType === "function" && !discoveredPath) {
-                throw new Error(`Module tool ${workspaceObject.id} must define implementation.path or provide index.mjs|index.js|index.cjs`);
-            }
-            const implementationName = typeof normalizedItem.implementationName === "string" && normalizedItem.implementationName.trim().length > 0
-                ? normalizedItem.implementationName.trim()
-                : typeof implementation?.export === "string" && implementation.export.trim().length > 0
-                    ? implementation.export.trim()
-                    : workspaceObject.id;
-            const schemaMetadata = inferredType === "function" && discoveredPath
-                ? await readModuleToolSchemaMetadata({
-                    sourcePath: discoveredPath,
-                    implementationName,
-                })
-                : { hasModuleSchema: false };
-            records.push({
-                item: {
-                    ...normalizedItem,
-                    ...(typeof implementation?.export === "string" && !normalizedItem.implementationName ? { implementationName } : {}),
-                    ...(schemaMetadata.hasModuleSchema ? { hasModuleSchema: true } : {}),
-                },
-                sourcePath: discoveredPath ?? sourcePath,
-            });
-        }
-    }
-    return records;
-}
-function findToolPackageRoot(startPath) {
-    let current = path.dirname(startPath);
-    for (;;) {
-        const packageJsonPath = path.join(current, "package.json");
-        if (existsSync(packageJsonPath)) {
-            return current;
-        }
-        const parent = path.dirname(current);
-        if (parent === current) {
-            return path.dirname(startPath);
-        }
-        current = parent;
-    }
-}
-async function readModuleToolSchemaMetadata(input) {
-    if (!isSupportedToolModulePath(input.sourcePath)) {
-        return { hasModuleSchema: false };
-    }
-    const packageRoot = findToolPackageRoot(input.sourcePath);
-    const isolatedSourcePath = await resolveIsolatedResourceModulePath(packageRoot, input.sourcePath);
-    const imported = await import(pathToFileURL(isolatedSourcePath).href);
-    const definition = loadToolModuleDefinition(imported, input.implementationName);
-    return {
-        hasModuleSchema: definition.hasModuleSchema,
-    };
-}
-async function loadModuleObjectsForRoot(root, mergedObjects) {
-    for (const { item, sourcePath } of await readModuleToolItems(root)) {
-        const workspaceObject = parseWorkspaceObject(item, sourcePath);
-        if (!workspaceObject) {
-            continue;
-        }
-        mergeWorkspaceObjectRecord(mergedObjects, workspaceObject, item, sourcePath);
-    }
-}
-async function loadConfigYamlForRoot(root, configRoot, mergedAgents, mergedObjects) {
-    if (!conventionalConfigRoot(root)) {
-        return;
-    }
-    for (const { item, sourcePath } of await readYamlItems(configRoot, undefined, { recursive: true })) {
-        const workspaceObject = parseWorkspaceObject(item, sourcePath);
-        if (!workspaceObject) {
-            continue;
-        }
-        if (isAgentKind(workspaceObject.kind)) {
-            mergeAgentRecord(mergedAgents, item, sourcePath);
-            continue;
-        }
-        mergeWorkspaceObjectRecord(mergedObjects, workspaceObject, item, sourcePath);
-    }
-}
-async function loadRootObjects(root, mergedObjects) {
-    for (const { item, sourcePath } of (await readYamlItems(root)).filter(({ sourcePath: fullPath }) => !fullPath.includes(`${path.sep}config${path.sep}`) &&
-        !fullPath.includes(`${path.sep}resources${path.sep}`) &&
-        !fullPath.includes(`${path.sep}agents${path.sep}`) &&
-        !CONVENTIONAL_OBJECT_DIRECTORIES.some((directory) => fullPath.includes(`${path.sep}${directory}${path.sep}`)))) {
-        const workspaceObject = parseWorkspaceObject(item, sourcePath);
-        if (!workspaceObject) {
-            continue;
-        }
-        if (workspaceObject.kind === "tool" || workspaceObject.kind === "mcp" || workspaceObject.kind === "model") {
-            continue;
-        }
-        mergeWorkspaceObjectRecord(mergedObjects, workspaceObject, item, sourcePath);
-    }
-}
-function isAgentKind(kind) {
-    return kind === "agent";
-}
-export async function readToolModuleItems(root, options = {}) {
-    if (!(await fileExists(root))) {
-        return [];
-    }
-    const scope = options.scope === "top-level" ? "top-level" : "recursive";
-    const files = [];
-    const pending = [root];
-    while (pending.length > 0) {
-        const current = pending.shift();
-        const entries = await readdir(current, { withFileTypes: true });
-        for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
-            const entryPath = path.join(current, entry.name);
-            const entryType = await resolveScanEntryType(entryPath, entry);
-            if (entryType === "directory") {
-                if (shouldSkipScanDirectory(entry.name) || scope === "top-level") {
-                    continue;
-                }
-                pending.push(entryPath);
-                continue;
-            }
-            if (entryType === "file" && isSupportedToolModulePath(entry.name)) {
-                files.push(entryPath);
-            }
-        }
-    }
-    const records = [];
-    for (const filePath of files) {
-        const sourceText = await readFile(filePath, "utf8");
-        const packageRoot = findToolPackageRoot(filePath);
-        const isolatedSourcePath = await resolveIsolatedResourceModulePath(packageRoot, filePath);
-        const imported = await import(pathToFileURL(isolatedSourcePath).href);
-        const definitions = discoverToolModuleDefinitions(sourceText, imported);
-        if (definitions.length === 0) {
-            continue;
-        }
-        for (const definition of definitions) {
-            records.push({
-                item: {
-                    kind: "tool",
-                    id: definition.implementationName,
-                    type: "function",
-                    name: definition.implementationName,
-                    description: definition.description,
-                    implementationName: definition.implementationName,
-                    hasModuleSchema: definition.hasModuleSchema,
-                    ...(definition.modelSchema ? { modelSchema: definition.modelSchema } : {}),
-                    ...(definition.retryable !== undefined ? { retryable: definition.retryable } : {}),
-                    ...(definition.memory ? { config: { memory: definition.memory } } : {}),
-                },
-                sourcePath: filePath,
-            });
-        }
-    }
-    return records;
-}
-async function resolveScanEntryType(entryPath, entry) {
-    if (entry.isDirectory()) {
-        return "directory";
-    }
-    if (entry.isFile()) {
-        return "file";
-    }
-    if (entry.isSymbolicLink?.()) {
-        try {
-            const resolved = await stat(entryPath);
-            if (resolved.isDirectory()) {
-                return "directory";
-            }
-            if (resolved.isFile()) {
-                return "file";
-            }
-        }
-        catch {
-            return "other";
-        }
-    }
-    return "other";
-}
-function inferExecutionMode(item, current) {
-    return resolveExecutionBackend(item, current);
-}
-/**
- * Load and merge workspace objects in deterministic order:
- * 1) framework workspace defaults
- * 2) overlay roots in order
- * 3) workspaceRoot
- *
- * Merge semantics:
- * - later sources override earlier sources
- * - arrays are replaced, not concatenated
- * - plain objects are merged recursively
- * - scalars and non-plain objects are replaced
- */
-export async function loadWorkspaceObjects(workspaceRoot, options = {}) {
-    const refs = new Map();
-    const mergedAgents = new Map();
-    const mergedObjects = new Map();
-    const defaultRoot = frameworkWorkspaceRoot();
-    const roots = [defaultRoot, ...(options.overlayRoots ?? []), workspaceRoot];
-    for (const root of roots) {
-        const configRoot = conventionalConfigRoot(root) ?? root;
-        await loadConfigYamlForRoot(root, configRoot, mergedAgents, mergedObjects);
-        await loadModuleAgentsForRoot(root, mergedAgents);
-        if (root !== defaultRoot) {
-            await loadConventionalObjectsForRoot(root, workspaceRoot, mergedObjects, getMergedToolModuleDiscoveryScope(mergedObjects));
-        }
-        await loadModuleObjectsForRoot(root, mergedObjects);
-        await loadRootObjects(root, mergedObjects);
-    }
-    const agents = Array.from(mergedAgents.values()).map(({ item, sourcePath }) => parseAgentItem(item, sourcePath));
-    for (const [ref, { item, sourcePath }] of mergedObjects) {
-        const workspaceObject = parseWorkspaceObject(item, sourcePath);
-        if (!workspaceObject) {
-            continue;
-        }
-        refs.set(ref, workspaceObject);
-    }
-    for (const agent of agents) {
-        refs.set(`agent/${agent.id}`, agent);
-    }
-    return { refs, agents };
-}
+import u from"node:path";import{existsSync as x}from"node:fs";import{readdir as M,readFile as J,stat as H}from"node:fs/promises";import{pathToFileURL as E}from"node:url";import{resolveIsolatedResourceModulePath as O}from"../resource/isolation.js";import{discoverToolModuleDefinitions as q,isSupportedToolModulePath as b,loadToolModuleDefinition as Q}from"../tooling/module-loader.js";import{fileExists as k,shouldSkipScanDirectory as T}from"../utils/fs.js";import{isFileSourceUri as X,readRuntimeSources as Z,resolveFileSourcePath as ee}from"./support/source-protocols.js";import{readNamedYamlItems as w,readYamlItems as F}from"./yaml-object-reader.js";import{CONVENTIONAL_OBJECT_DIRECTORIES as te,MODULE_AGENT_FILENAMES as oe,MODULE_TOOL_ENTRY_FILENAMES as re,MODULE_TOOL_FILENAMES as ne,conventionalConfigRoot as D,conventionalObjectRoots as ie,frameworkWorkspaceRoot as se,moduleCollectionRoot as N,moduleRootForSourcePath as ae,resolveModuleRelativePath as S}from"./object-loader-paths.js";import{asMutableObject as A,asObject as ce,cloneConfigValue as f,readAsyncSubAgentArray as me,readCapabilities as de,readMcpServerArray as ue,readMiddlewareArray as le,readPathArray as I,readPrefixedRefArray as pe,readRefArray as fe,readSingleRef as ye,readToolBindingArray as he}from"./object-loader-readers.js";import{normalizeYamlItem as Ze,readYamlItems as et}from"./yaml-object-reader.js";const ge=["systemPrompt","checkpointer","interruptOn","stateSchema","responseFormat","responseFormatRef","contextSchema","includeAgentName","version","middleware","backend","store","runtimeMemory","proceduralMemory","taskDescription","generalPurposeAgent","filesystem","builtinTools","interactionMode","executionContract"],Me=["id","kind","description","capabilities","runtime","executionMode","sourcePath"],be=["backend","modelRef","tools","skills","memory","subagents","mcpServers","config"],ke=["systemPrompt","checkpointer","interruptOn","stateSchema","responseFormat","responseFormatRef","contextSchema","includeAgentName","version","middleware","store","taskDescription","generalPurposeAgent","filesystem","builtinTools","interactionMode","executionContract"];function $(e){const o={...e};if(o.execution!==void 0)throw new Error("Agent spec.execution is no longer supported; move backend, modelRef, tools, skills, memory, subagents, mcpServers, and config directly under spec");const t=A(o.config),r=_(o);if(t){for(const n of ke)!(n in t)||o[n]!==void 0||(o[n]=f(t[n]),delete t[n]);if(t.runtimeMemory!==void 0&&r?.runtimeMemory===void 0){const n=r??{};n.runtimeMemory=f(t.runtimeMemory),o.runtime=n,delete t.runtimeMemory}if(t.proceduralMemory!==void 0&&r?.proceduralMemory===void 0){const n=A(o.runtime)??r??{};n.proceduralMemory=f(t.proceduralMemory),o.runtime=n,delete t.proceduralMemory}}return t&&Object.keys(t).length>0?o.config=t:delete o.config,o}function P(e){const o=A(e.config)??{},t=Object.fromEntries(Object.entries(e).filter(([r])=>!be.includes(r)&&!Me.includes(r)));return{...o,...t}}function y(e,o,t){return t(e[o])}function _(e){return A(e.runtime)}function Ae(e,o){if(typeof o?.runtimeMemory=="string"&&o.runtimeMemory.trim())return{ref:o.runtimeMemory.startsWith("runtime-memory/")?o.runtimeMemory:`runtime-memory/${o.runtimeMemory.trim()}`};if(typeof o?.runtimeMemory=="object"&&o.runtimeMemory&&!Array.isArray(o.runtimeMemory))return f(o.runtimeMemory);const t=P(e);if(typeof t.runtimeMemory=="string"&&t.runtimeMemory.trim())return{ref:t.runtimeMemory.startsWith("runtime-memory/")?t.runtimeMemory:`runtime-memory/${t.runtimeMemory.trim()}`};if(typeof t.runtimeMemory=="object"&&t.runtimeMemory&&!Array.isArray(t.runtimeMemory))return f(t.runtimeMemory)}function Re(e,o){if(typeof o?.proceduralMemory=="string"&&o.proceduralMemory.trim())return{ref:o.proceduralMemory.startsWith("procedural-memory/")?o.proceduralMemory:`procedural-memory/${o.proceduralMemory.trim()}`};if(typeof o?.proceduralMemory=="object"&&o.proceduralMemory&&!Array.isArray(o.proceduralMemory))return f(o.proceduralMemory);const t=P(e);if(typeof t.proceduralMemory=="string"&&t.proceduralMemory.trim())return{ref:t.proceduralMemory.startsWith("procedural-memory/")?t.proceduralMemory:`procedural-memory/${t.proceduralMemory.trim()}`};if(typeof t.proceduralMemory=="object"&&t.proceduralMemory&&!Array.isArray(t.proceduralMemory))return f(t.proceduralMemory)}function we(e,o){if(!o||typeof e!="object"||e===null||Array.isArray(e))return e;const t={...e};return typeof t.path=="string"&&(t.path=S(t.path,o)),t}function W(e,o){return o?{...e,...e.systemPrompt!==void 0?{systemPrompt:we(e.systemPrompt,o)}:{}}:e}function Se(e,o){const t=Object.fromEntries(Object.entries(e).filter(([r])=>!o.includes(r)).map(([r,n])=>[r,f(n)]));return Object.keys(t).length>0?t:void 0}function L(e,o){if(e.execution!==void 0||o?.execution!==void 0)throw new Error("Agent spec.execution is no longer supported; move backend, modelRef, tools, skills, memory, subagents, mcpServers, and config directly under spec");const t=typeof e.mode=="string"?e.mode:typeof o?.mode=="string"?o.mode:void 0;if(typeof t=="string"&&t.trim().length>0)throw new Error("Agent mode is no longer supported; use backend");const r=typeof e.backend=="string"?e.backend.trim().toLowerCase():typeof o?.backend=="string"?o.backend.trim().toLowerCase():void 0;if(r==="langchain-v1")return"langchain-v1";if(r==="deepagent")return"deepagent";if(r==="langgraph")throw new Error("Agent backend=langgraph is no longer supported; use backend=langchain-v1 or backend=deepagent")}function Pe(e,o={}){return{...typeof e.store=="object"&&e.store?{store:e.store}:{},...typeof e.builtinTools=="object"&&e.builtinTools?{builtinTools:f(e.builtinTools)}:{},...o.includeDelegationControls&&typeof e.taskDescription=="string"&&e.taskDescription.trim()?{taskDescription:e.taskDescription}:{},...o.includeDelegationControls&&typeof e.generalPurposeAgent=="boolean"?{generalPurposeAgent:e.generalPurposeAgent}:{}}}function je(e){const o=le(e.middleware),t=typeof e.backend=="string"&&e.backend.trim()?{ref:e.backend.startsWith("backend/")?e.backend:`backend/${e.backend.trim()}`}:typeof e.backend=="object"&&e.backend?e.backend:void 0,r=typeof e.checkpointer=="string"&&e.checkpointer.trim()?{ref:e.checkpointer.startsWith("checkpointer/")?e.checkpointer:`checkpointer/${e.checkpointer.trim()}`}:typeof e.checkpointer=="object"&&e.checkpointer||typeof e.checkpointer=="boolean"?e.checkpointer:void 0,n=typeof e.store=="string"&&e.store.trim()?{ref:e.store.startsWith("store/")?e.store:`store/${e.store.trim()}`}:typeof e.store=="object"&&e.store?e.store:void 0;return{...typeof e.systemPrompt=="string"&&e.systemPrompt||typeof e.systemPrompt=="object"&&e.systemPrompt&&!Array.isArray(e.systemPrompt)?{systemPrompt:f(e.systemPrompt)}:{},...r!==void 0?{checkpointer:r}:{},...typeof e.interruptOn=="object"&&e.interruptOn?{interruptOn:e.interruptOn}:{},...e.stateSchema!==void 0?{stateSchema:e.stateSchema}:{},...e.responseFormat!==void 0?{responseFormat:e.responseFormat}:{},...typeof e.responseFormatRef=="string"&&e.responseFormatRef.trim()?{responseFormatRef:e.responseFormatRef.startsWith("response-format/")?e.responseFormatRef:`response-format/${e.responseFormatRef.trim()}`}:{},...e.contextSchema!==void 0?{contextSchema:e.contextSchema}:{},...e.interactionMode==="stream"||e.interactionMode==="invoke"?{interactionMode:e.interactionMode}:{},...e.includeAgentName==="inline"?{includeAgentName:"inline"}:{},...e.version==="v1"||e.version==="v2"?{version:e.version}:{},...typeof e.filesystem=="object"&&e.filesystem?{filesystem:e.filesystem}:{},...typeof e.executionContract=="object"&&e.executionContract?{executionContract:e.executionContract}:{},...t?{backend:t}:{},...n?{store:n}:{},...o?{middleware:o}:{}}}function Y(e,o={}){const t=P(e),r=Se(t,[...ge]);return{...je(t),...Pe(t,{includeDelegationControls:o.includeDelegationControls}),...r?{passthrough:r}:{}}}function ve(e,o){const t=$(e),r=ae(o,"agents"),n=y(t,"subagents",fe),s=y(t,"tools",he),a=y(t,"subagents",I).filter(m=>u.isAbsolute(m)||m.startsWith("./")||m.startsWith("../")).map(m=>S(m,r)),d=y(t,"subagents",me),i=String(L(t)??"deepagent"),c=_(t);return{id:String(t.id),executionMode:i,runtimeMemory:Ae(t,c),proceduralMemory:Re(t,c),capabilities:de(t.capabilities)??(i==="deepagent"?{delegation:!0,memory:!0}:{delegation:!0,memory:!0}),description:String(t.description??""),modelRef:y(t,"modelRef",ye)??"",runtimeRoot:typeof c?.runtimeRoot=="string"?c.runtimeRoot:void 0,applicationRoot:typeof c?.applicationRoot=="string"?c.applicationRoot:void 0,dataRoot:typeof c?.dataRoot=="string"?c.dataRoot:void 0,runtimeProfile:typeof c?.profile=="string"?c.profile:void 0,toolRefs:s.map(m=>m.ref),toolBindings:s,inlineTools:void 0,mcpServers:y(t,"mcpServers",ue),skillPathRefs:y(t,"skills",m=>pe(m,"skill")),memorySources:y(t,"memory",I).map(m=>S(m,r)),subagentRefs:n,subagentPathRefs:a,asyncSubagents:d,langchainAgentConfig:W(Y(t,{includeDelegationControls:i==="langchain-v1"}),r),deepAgentConfig:W(Y(t,{includeObjectBackend:!0,includeDelegationControls:!1}),r),sourcePath:o}}function h(e,o){if(typeof e.id!="string")return null;const t=typeof e.kind=="string"?e.kind:u.basename(o).replace(/\.(yaml|yml|json)$/i,"");return t?{id:e.id,kind:t,sourcePath:o,value:e}:null}function j(e,o){if(o===void 0)return e;if(Array.isArray(e)&&Array.isArray(o))return o;if(typeof e=="object"&&e&&typeof o=="object"&&o&&!Array.isArray(e)&&!Array.isArray(o)){const t={...e};for(const[r,n]of Object.entries(o))t[r]=r in t?j(t[r],n):n;return t}return o}function z(e,o,t,r){const n=e.get(o),s=n?j(n.item,t):t,a=typeof s.kind=="string"?s.kind:void 0,d=typeof s.type=="string"?s.type:void 0,i=n&&a==="tool"&&d==="function"&&b(n.sourcePath)&&!b(r)?n.sourcePath:r,c={item:s,sourcePath:i};return e.set(o,c),c}function G(e,o,t){const r=$(o),n=typeof r.id=="string"?r.id:void 0;if(!n)return null;const s=e.get(n),a=r.systemPrompt!==void 0,d=s?.item.systemPrompt,i=typeof d=="object"&&d!==null&&!Array.isArray(d)&&typeof d.path=="string"&&!!d.path.trim()&&!u.isAbsolute(d.path);if(s&&i&&!a){const c=d,m={...s.item,systemPrompt:{...c,path:u.resolve(u.dirname(s.sourcePath),c.path)}},p={item:j(m,r),sourcePath:t};return e.set(n,p),p}return z(e,n,r,t)}function g(e,o,t,r){z(e,`${o.kind}/${o.id}`,t,r)}async function Ce(e,o){const t=N(e,"agents");if(!await k(t))return;const r=await M(t,{withFileTypes:!0});for(const n of r.filter(s=>s.isDirectory()).sort((s,a)=>s.name.localeCompare(a.name))){const s=u.join(t,n.name);for(const{item:a,sourcePath:d}of await w(s,[...oe])){const i=typeof a.id=="string"&&a.id.trim()?a:{...a,id:n.name};U(i.kind)&&G(o,i,d)}}}function xe(e){const o=e.get("runtime/default")?.item;return(typeof o?.toolModuleDiscovery=="object"&&o.toolModuleDiscovery?o.toolModuleDiscovery:{}).scope==="top-level"?"top-level":"recursive"}async function Ee(e,o,t,r){const n=t.get("runtime/default")?.item,s=Z(n).tools.filter(i=>X(i)).map(i=>ee(i,o)),a=ie(e),d=e===o?Array.from(new Set([...a,...s])):a;for(const i of d){for(const{item:c,sourcePath:m}of await Oe(i)){const p=h(c,m);p&&g(t,p,c,m)}for(const{item:c,sourcePath:m}of await $e(i,{scope:r})){const p=h(c,m);p&&g(t,p,c,m)}}}async function Oe(e){if(!await k(e))return[];const o=[],t=[e];for(;t.length>0;){const r=t.shift(),n=await M(r,{withFileTypes:!0});for(const s of n.sort((a,d)=>a.name.localeCompare(d.name))){const a=u.join(r,s.name),d=await B(a,s);if(d==="directory"){if(T(s.name))continue;t.push(a);continue}d!=="file"||!s.name.endsWith(".yaml")&&!s.name.endsWith(".yml")||o.push(...await w(r,[s.name]))}}return o}async function Te(e){const o=N(e,"tools");if(!await k(o))return[];const t=await M(o,{withFileTypes:!0}),r=[];for(const n of t.filter(s=>s.isDirectory()).sort((s,a)=>s.name.localeCompare(a.name))){const s=u.join(o,n.name);for(const{item:a,sourcePath:d}of await w(s,[...ne])){const i=typeof a.id=="string"&&a.id.trim()?a:{...a,id:n.name},c=h(i,d);if(!c||c.kind!=="tool")continue;const m=ce(i.implementation),l=(typeof m?.path=="string"?u.resolve(s,m.path):void 0)??re.map(R=>u.join(s,R)).find(R=>x(R)),v=typeof i.type=="string"?i.type:i.refs!==void 0||i.bundle!==void 0?"bundle":i.providerTool!==void 0||i.provider!==void 0?"provider":i.backend!==void 0||i.operation!==void 0?"backend":i.mcp!==void 0?"mcp":"function";if(v==="function"&&!l)throw new Error(`Module tool ${c.id} must define implementation.path or provide index.mjs|index.js|index.cjs`);const C=typeof i.implementationName=="string"&&i.implementationName.trim().length>0?i.implementationName.trim():typeof m?.export=="string"&&m.export.trim().length>0?m.export.trim():c.id,V=v==="function"&&l?await Fe({sourcePath:l,implementationName:C}):{hasModuleSchema:!1};r.push({item:{...i,...typeof m?.export=="string"&&!i.implementationName?{implementationName:C}:{},...V.hasModuleSchema?{hasModuleSchema:!0}:{}},sourcePath:l??d})}}return r}function K(e){let o=u.dirname(e);for(;;){const t=u.join(o,"package.json");if(x(t))return o;const r=u.dirname(o);if(r===o)return u.dirname(e);o=r}}async function Fe(e){if(!b(e.sourcePath))return{hasModuleSchema:!1};const o=K(e.sourcePath),t=await O(o,e.sourcePath),r=await import(E(t).href);return{hasModuleSchema:Q(r,e.implementationName).hasModuleSchema}}async function De(e,o){for(const{item:t,sourcePath:r}of await Te(e)){const n=h(t,r);n&&g(o,n,t,r)}}async function Ne(e,o,t,r){if(D(e))for(const{item:n,sourcePath:s}of await F(o,void 0,{recursive:!0})){const a=h(n,s);if(a){if(U(a.kind)){G(t,n,s);continue}g(r,a,n,s)}}}async function Ie(e,o){for(const{item:t,sourcePath:r}of(await F(e)).filter(({sourcePath:n})=>!n.includes(`${u.sep}config${u.sep}`)&&!n.includes(`${u.sep}resources${u.sep}`)&&!n.includes(`${u.sep}agents${u.sep}`)&&!te.some(s=>n.includes(`${u.sep}${s}${u.sep}`)))){const n=h(t,r);n&&(n.kind==="tool"||n.kind==="mcp"||n.kind==="model"||g(o,n,t,r))}}function U(e){return e==="agent"}async function $e(e,o={}){if(!await k(e))return[];const t=o.scope==="top-level"?"top-level":"recursive",r=[],n=[e];for(;n.length>0;){const a=n.shift(),d=await M(a,{withFileTypes:!0});for(const i of d.sort((c,m)=>c.name.localeCompare(m.name))){const c=u.join(a,i.name),m=await B(c,i);if(m==="directory"){if(T(i.name)||t==="top-level")continue;n.push(c);continue}m==="file"&&b(i.name)&&r.push(c)}}const s=[];for(const a of r){const d=await J(a,"utf8"),i=K(a),c=await O(i,a),m=await import(E(c).href),p=q(d,m);if(p.length!==0)for(const l of p)s.push({item:{kind:"tool",id:l.implementationName,type:"function",name:l.implementationName,description:l.description,implementationName:l.implementationName,hasModuleSchema:l.hasModuleSchema,...l.modelSchema?{modelSchema:l.modelSchema}:{},...l.retryable!==void 0?{retryable:l.retryable}:{},...l.memory?{config:{memory:l.memory}}:{}},sourcePath:a})}return s}async function B(e,o){if(o.isDirectory())return"directory";if(o.isFile())return"file";if(o.isSymbolicLink?.())try{const t=await H(e);if(t.isDirectory())return"directory";if(t.isFile())return"file"}catch{return"other"}return"other"}function He(e,o){return L(e,o)}async function qe(e,o={}){const t=new Map,r=new Map,n=new Map,s=se(),a=[s,...o.overlayRoots??[],e];for(const i of a){const c=D(i)??i;await Ne(i,c,r,n),await Ce(i,r),i!==s&&await Ee(i,e,n,xe(n)),await De(i,n),await Ie(i,n)}const d=Array.from(r.values()).map(({item:i,sourcePath:c})=>ve(i,c));for(const[i,{item:c,sourcePath:m}]of n){const p=h(c,m);p&&t.set(i,p)}for(const i of d)t.set(`agent/${i.id}`,i);return{refs:t,agents:d}}export{qe as loadWorkspaceObjects,Ze as normalizeYamlItem,ve as parseAgentItem,$e as readToolModuleItems,et as readYamlItems};