experimental-ash 0.26.0 → 0.28.0

package/dist/src/discover/connections.js

@@ -1,153 +1 @@
-import { join } from "node:path";
-import { createDiscoverErrorDiagnostic } from "#discover/diagnostics.js";
-import { normalizeLogicalPath } from "#discover/filesystem.js";
-import { createConnectionNameDiagnostic, createModuleSlotCollisionDiagnostic, DISCOVER_MODULE_SLOT_COLLISION, readSortedDirectoryEntries, } from "#discover/grammar.js";
-import { createConnectionSourceRef } from "#discover/manifest.js";
-import { collectNamedSlotCandidates } from "#discover/slots.js";
-/**
- * Shared diagnostic emitted when the authored `connections/` root is not a
- * directory.
- */
-export const DISCOVER_CONNECTIONS_DIRECTORY_INVALID = "discover/connections-directory-invalid";
-/**
- * Discovery diagnostic emitted when a connection exists in both file form
- * (`connections/<name>.ts`) and folder form (`connections/<name>/`).
- */
-export const DISCOVER_CONNECTION_FILE_FOLDER_COLLISION = "discover/connection-file-folder-collision";
-/**
- * Discovery diagnostic emitted when a folder-form connection contains no
- * `connection.ts` definition module.
- */
-export const DISCOVER_CONNECTION_FOLDER_EMPTY = "discover/connection-folder-empty";
-/**
- * Filename of the connection definition module inside a folder-form
- * connection.
- */
-const CONNECTION_DEFINITION_BASE_NAME = "connection";
-/**
- * Discovers authored connections under `agent/connections/`.
- */
-export async function discoverConnectionSources(input) {
-    const directoryName = "connections";
-    const directoryPath = join(input.rootPath, directoryName);
-    const directoryEntry = input.rootEntries.find((entry) => entry.name === directoryName);
-    if (directoryEntry === undefined) {
-        return {
-            connections: [],
-            diagnostics: [],
-        };
-    }
-    if (!directoryEntry.isDirectory()) {
-        return {
-            connections: [],
-            diagnostics: [
-                createDiscoverErrorDiagnostic({
-                    code: DISCOVER_CONNECTIONS_DIRECTORY_INVALID,
-                    message: `Expected "${directoryPath}" to be a directory of authored connections.`,
-                    sourcePath: directoryPath,
-                }),
-            ],
-        };
-    }
-    const directoryEntries = await readSortedDirectoryEntries(input.source, directoryPath);
-    const connections = [];
-    const diagnostics = [];
-    const fileFormNames = new Set();
-    for (const candidates of collectNamedSlotCandidates(directoryEntries, {
-        allowMarkdown: false,
-        allowModules: true,
-    })) {
-        const slotLogicalPath = normalizeLogicalPath(join(directoryName, candidates.slotName));
-        if (candidates.moduleFileNames.length > 1) {
-            fileFormNames.add(candidates.slotName);
-            diagnostics.push(createModuleSlotCollisionDiagnostic(directoryPath, slotLogicalPath, candidates.moduleFileNames));
-            continue;
-        }
-        const [moduleFileName] = candidates.moduleFileNames;
-        if (moduleFileName === undefined) {
-            continue;
-        }
-        fileFormNames.add(candidates.slotName);
-        const slotDiagnostic = createConnectionNameDiagnostic(candidates.slotName, join(directoryPath, moduleFileName));
-        if (slotDiagnostic !== null) {
-            diagnostics.push(slotDiagnostic);
-            continue;
-        }
-        connections.push(createConnectionSourceRef({
-            connectionName: candidates.slotName,
-            logicalPath: join(directoryName, moduleFileName),
-        }));
-    }
-    for (const entry of directoryEntries) {
-        if (!entry.isDirectory()) {
-            continue;
-        }
-        const connectionName = entry.name;
-        const folderPath = join(directoryPath, connectionName);
-        if (fileFormNames.has(connectionName)) {
-            diagnostics.push(createDiscoverErrorDiagnostic({
-                code: DISCOVER_CONNECTION_FILE_FOLDER_COLLISION,
-                message: `Connection "${connectionName}" is defined twice. ` +
-                    `Found both file-form "connections/${connectionName}.ts" and folder-form "connections/${connectionName}/". ` +
-                    `Use one form, not both.`,
-                sourcePath: folderPath,
-            }));
-            const existingIndex = connections.findIndex((connection) => connection.connectionName === connectionName);
-            if (existingIndex !== -1) {
-                connections.splice(existingIndex, 1);
-            }
-            continue;
-        }
-        const slotDiagnostic = createConnectionNameDiagnostic(connectionName, folderPath);
-        if (slotDiagnostic !== null) {
-            diagnostics.push(slotDiagnostic);
-            continue;
-        }
-        const folderEntries = await readSortedDirectoryEntries(input.source, folderPath);
-        const moduleCandidates = collectFolderConnectionModuleCandidates(folderEntries);
-        if (moduleCandidates.length > 1) {
-            diagnostics.push(createDiscoverErrorDiagnostic({
-                code: DISCOVER_MODULE_SLOT_COLLISION,
-                message: `Found multiple connection definition modules inside "${normalizeLogicalPath(join(directoryName, connectionName))}": ` +
-                    moduleCandidates.map((name) => `"${name}"`).join(", "),
-                sourcePath: folderPath,
-            }));
-            continue;
-        }
-        const [moduleFileName] = moduleCandidates;
-        if (moduleFileName === undefined) {
-            diagnostics.push(createDiscoverErrorDiagnostic({
-                code: DISCOVER_CONNECTION_FOLDER_EMPTY,
-                message: `Connection folder "connections/${connectionName}/" contains no "connection.ts" definition. ` +
-                    `Add "connections/${connectionName}/connection.ts" or use the file form "connections/${connectionName}.ts".`,
-                sourcePath: folderPath,
-            }));
-            continue;
-        }
-        connections.push(createConnectionSourceRef({
-            connectionName,
-            logicalPath: join(directoryName, connectionName, moduleFileName),
-        }));
-    }
-    return {
-        connections,
-        diagnostics,
-    };
-}
-/**
- * Returns the file names inside a folder-form connection that match the
- * `connection.ts` definition slot.
- */
-function collectFolderConnectionModuleCandidates(entries) {
-    const moduleEntries = entries.filter((entry) => entry.isFile());
-    const candidates = [];
-    for (const candidate of collectNamedSlotCandidates(moduleEntries, {
-        allowMarkdown: false,
-        allowModules: true,
-    })) {
-        if (candidate.slotName === CONNECTION_DEFINITION_BASE_NAME) {
-            candidates.push(...candidate.moduleFileNames);
-        }
-    }
-    return candidates;
-}
+import{join}from"node:path";import{createDiscoverErrorDiagnostic}from"#discover/diagnostics.js";import{normalizeLogicalPath}from"#discover/filesystem.js";import{createConnectionSourceRef}from"#discover/manifest.js";import{DISCOVER_MODULE_SLOT_COLLISION,createConnectionNameDiagnostic,createModuleSlotCollisionDiagnostic,readSortedDirectoryEntries}from"#discover/grammar.js";import{collectNamedSlotCandidates}from"#discover/slots.js";var DISCOVER_CONNECTIONS_DIRECTORY_INVALID=`discover/connections-directory-invalid`,DISCOVER_CONNECTION_FILE_FOLDER_COLLISION=`discover/connection-file-folder-collision`,DISCOVER_CONNECTION_FOLDER_EMPTY=`discover/connection-folder-empty`,CONNECTION_DEFINITION_BASE_NAME=`connection`;async function discoverConnectionSources(c){let l=`connections`,u=join(c.rootPath,l),d=c.rootEntries.find(e=>e.name===l);if(d===void 0)return{connections:[],diagnostics:[]};if(!d.isDirectory())return{connections:[],diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_CONNECTIONS_DIRECTORY_INVALID,message:`Expected "${u}" to be a directory of authored connections.`,sourcePath:u})]};let f=await readSortedDirectoryEntries(c.source,u),p=[],m=[],h=new Set;for(let t of collectNamedSlotCandidates(f,{allowMarkdown:!1,allowModules:!0})){let r=normalizeLogicalPath(join(l,t.slotName));if(t.moduleFileNames.length>1){h.add(t.slotName),m.push(createModuleSlotCollisionDiagnostic(u,r,t.moduleFileNames));continue}let[a]=t.moduleFileNames;if(a===void 0)continue;h.add(t.slotName);let o=createConnectionNameDiagnostic(t.slotName,join(u,a));if(o!==null){m.push(o);continue}p.push(createConnectionSourceRef({connectionName:t.slotName,logicalPath:join(l,a)}))}for(let i of f){if(!i.isDirectory())continue;let o=i.name,s=join(u,o);if(h.has(o)){m.push(createDiscoverErrorDiagnostic({code:DISCOVER_CONNECTION_FILE_FOLDER_COLLISION,message:`Connection "${o}" is defined twice. Found both file-form "connections/${o}.ts" and folder-form "connections/${o}/". Use one form, not both.`,sourcePath:s}));let e=p.findIndex(e=>e.connectionName===o);e!==-1&&p.splice(e,1);continue}let d=createConnectionNameDiagnostic(o,s);if(d!==null){m.push(d);continue}let f=collectFolderConnectionModuleCandidates(await readSortedDirectoryEntries(c.source,s));if(f.length>1){m.push(createDiscoverErrorDiagnostic({code:DISCOVER_MODULE_SLOT_COLLISION,message:`Found multiple connection definition modules inside "${normalizeLogicalPath(join(l,o))}": `+f.map(e=>`"${e}"`).join(`, `),sourcePath:s}));continue}let[g]=f;if(g===void 0){m.push(createDiscoverErrorDiagnostic({code:DISCOVER_CONNECTION_FOLDER_EMPTY,message:`Connection folder "connections/${o}/" contains no "connection.ts" definition. Add "connections/${o}/connection.ts" or use the file form "connections/${o}.ts".`,sourcePath:s}));continue}p.push(createConnectionSourceRef({connectionName:o,logicalPath:join(l,o,g)}))}return{connections:p,diagnostics:m}}function collectFolderConnectionModuleCandidates(e){let t=e.filter(e=>e.isFile()),n=[];for(let e of collectNamedSlotCandidates(t,{allowMarkdown:!1,allowModules:!0}))e.slotName===CONNECTION_DEFINITION_BASE_NAME&&n.push(...e.moduleFileNames);return n}export{DISCOVER_CONNECTIONS_DIRECTORY_INVALID,DISCOVER_CONNECTION_FILE_FOLDER_COLLISION,DISCOVER_CONNECTION_FOLDER_EMPTY,discoverConnectionSources};

package/dist/src/discover/diagnostics.js

@@ -1,82 +1 @@
-import { z } from "#compiled/zod/index.js";
-/**
- * Zod schema for structured discovery diagnostic severities.
- */
-export const discoverDiagnosticSeveritySchema = z.union([z.literal("error"), z.literal("warning")]);
-/**
- * Zod schema for one structured discovery diagnostic.
- */
-export const discoverDiagnosticSchema = z
-    .object({
-    /**
-     * Stable machine-readable diagnostic code.
-     */
-    code: z.string(),
-    /**
-     * Human-readable diagnostic message.
-     */
-    message: z.string(),
-    /**
-     * Discovery severity.
-     */
-    severity: discoverDiagnosticSeveritySchema,
-    /**
-     * Absolute source path associated with the diagnostic.
-     */
-    sourcePath: z.string(),
-})
-    .strict();
-/**
- * Zod schema for discovery diagnostic summary counts.
- */
-export const discoverDiagnosticsSummarySchema = z
-    .object({
-    errors: z.number().finite(),
-    warnings: z.number().finite(),
-})
-    .strict();
-/**
- * Root-resolution error code emitted when discovery cannot locate an Ash agent.
- */
-export const DISCOVER_PROJECT_NOT_FOUND = "discover/project-not-found";
-/**
- * Creates an error-level discovery diagnostic.
- */
-export function createDiscoverErrorDiagnostic(input) {
-    return {
-        ...input,
-        severity: "error",
-    };
-}
-/**
- * Creates a warning-level discovery diagnostic.
- */
-export function createDiscoverWarningDiagnostic(input) {
-    return {
-        ...input,
-        severity: "warning",
-    };
-}
-/**
- * Summarizes discovery diagnostics into error and warning counts.
- */
-export function summarizeDiscoverDiagnostics(diagnostics) {
-    return diagnostics.reduce((summary, diagnostic) => {
-        if (diagnostic.severity === "error") {
-            summary.errors += 1;
-        }
-        else {
-            summary.warnings += 1;
-        }
-        return summary;
-    }, {
-        errors: 0,
-        warnings: 0,
-    });
-}
-/**
- * Returns whether discovery diagnostics include at least one error.
- */
-export function hasDiscoverErrors(diagnostics) {
-    return diagnostics.some((diagnostic) => diagnostic.severity === "error");
-}
+import{z}from"#compiled/zod/index.js";var discoverDiagnosticSeveritySchema=z.union([z.literal(`error`),z.literal(`warning`)]),discoverDiagnosticSchema=z.object({code:z.string(),message:z.string(),severity:discoverDiagnosticSeveritySchema,sourcePath:z.string()}).strict(),discoverDiagnosticsSummarySchema=z.object({errors:z.number().finite(),warnings:z.number().finite()}).strict(),DISCOVER_PROJECT_NOT_FOUND=`discover/project-not-found`;function createDiscoverErrorDiagnostic(e){return{...e,severity:`error`}}function createDiscoverWarningDiagnostic(e){return{...e,severity:`warning`}}function summarizeDiscoverDiagnostics(e){return e.reduce((e,t)=>(t.severity===`error`?e.errors+=1:e.warnings+=1,e),{errors:0,warnings:0})}function hasDiscoverErrors(e){return e.some(e=>e.severity===`error`)}export{DISCOVER_PROJECT_NOT_FOUND,createDiscoverErrorDiagnostic,createDiscoverWarningDiagnostic,discoverDiagnosticSchema,discoverDiagnosticSeveritySchema,discoverDiagnosticsSummarySchema,hasDiscoverErrors,summarizeDiscoverDiagnostics};

package/dist/src/discover/discover-agent.js

@@ -1,159 +1 @@
-import { join, resolve } from "node:path";
-import { discoverConnectionSources } from "#discover/connections.js";
-import { discoverSubagents } from "#discover/discover-subagent.js";
-import { classifyAgentRootEntry } from "#discover/filesystem.js";
-import { createChannelNameDiagnostic, createHookNameDiagnostic, createToolNameDiagnostic, createUnsupportedRootDirectoryDiagnostics, DISCOVER_CHANNELS_DIRECTORY_INVALID, DISCOVER_HOOKS_DIRECTORY_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, discoverFlatModuleSource, discoverInstructionsSource, discoverNamedSourceDirectory, readSortedDirectoryEntries, } from "#discover/grammar.js";
-import { discoverLibSources } from "#discover/lib.js";
-import { createAgentSourceManifest, } from "#discover/manifest.js";
-import { createDiskProjectSource } from "#discover/project-source.js";
-import { discoverSandboxSource } from "#discover/sandbox.js";
-import { discoverScheduleSources } from "#discover/schedules.js";
-import { discoverSkills } from "#discover/skills.js";
-/**
- * Discovers the current agent's authored source graph without importing authored
- * modules.
- */
-export async function discoverAgent(input) {
-    const source = input.source ?? createDiskProjectSource();
-    const appRoot = resolve(input.appRoot);
-    const agentRoot = resolve(input.agentRoot);
-    const diagnostics = [];
-    const packageName = await tryReadPackageJsonName(source, appRoot);
-    const rootEntries = await readSortedDirectoryEntries(source, agentRoot);
-    diagnostics.push(...createUnsupportedRootDirectoryDiagnostics({
-        classifyEntry: classifyAgentRootEntry,
-        createUnsupportedDirectoryMessage(directoryName) {
-            return `Ignoring unsupported directory "${directoryName}/" in the agent root.`;
-        },
-        rootEntries,
-        rootPath: agentRoot,
-    }));
-    const instructionsResult = await discoverInstructionsSource({
-        rootEntries,
-        rootPath: agentRoot,
-        source,
-    });
-    diagnostics.push(...instructionsResult.diagnostics);
-    const configModuleResult = discoverFlatModuleSource({
-        rootEntries,
-        rootPath: agentRoot,
-        slotName: "agent",
-    });
-    diagnostics.push(...configModuleResult.diagnostics);
-    const channelsResult = await discoverNamedSourceDirectory({
-        directoryName: "channels",
-        invalidDirectoryCode: DISCOVER_CHANNELS_DIRECTORY_INVALID,
-        invalidDirectoryMessage: `Expected "${join(agentRoot, "channels")}" to be a directory of authored channels.`,
-        recursive: true,
-        rootEntries,
-        rootPath: agentRoot,
-        source,
-        validateSegment: createChannelNameDiagnostic,
-    });
-    diagnostics.push(...channelsResult.diagnostics);
-    const libResult = await discoverLibSources({
-        agentRoot,
-        rootEntries,
-        source,
-    });
-    diagnostics.push(...libResult.diagnostics);
-    const schedulesResult = await discoverScheduleSources({
-        agentRoot,
-        rootEntries,
-        source,
-    });
-    diagnostics.push(...schedulesResult.diagnostics);
-    const connectionsResult = await discoverConnectionSources({
-        rootEntries,
-        rootPath: agentRoot,
-        source,
-    });
-    diagnostics.push(...connectionsResult.diagnostics);
-    const sandboxResult = await discoverSandboxSource({
-        rootEntries,
-        rootPath: agentRoot,
-        source,
-    });
-    diagnostics.push(...sandboxResult.diagnostics);
-    const toolsResult = await discoverNamedSourceDirectory({
-        directoryName: "tools",
-        invalidDirectoryCode: DISCOVER_TOOLS_DIRECTORY_INVALID,
-        invalidDirectoryMessage: `Expected "${join(agentRoot, "tools")}" to be a directory of authored tools.`,
-        recursive: true,
-        rootEntries,
-        rootPath: agentRoot,
-        source,
-        validateSegment: createToolNameDiagnostic,
-    });
-    diagnostics.push(...toolsResult.diagnostics);
-    const hooksResult = await discoverNamedSourceDirectory({
-        directoryName: "hooks",
-        invalidDirectoryCode: DISCOVER_HOOKS_DIRECTORY_INVALID,
-        invalidDirectoryMessage: `Expected "${join(agentRoot, "hooks")}" to be a directory of authored hooks.`,
-        recursive: true,
-        rootEntries,
-        rootPath: agentRoot,
-        source,
-        validateSegment: createHookNameDiagnostic,
-    });
-    diagnostics.push(...hooksResult.diagnostics);
-    const skillsResult = await discoverSkills({
-        agentRoot,
-        source,
-    });
-    diagnostics.push(...skillsResult.diagnostics);
-    const subagentsResult = await discoverSubagents({
-        agentRoot,
-        appRoot,
-        source,
-    });
-    diagnostics.push(...subagentsResult.diagnostics);
-    const manifestInput = {
-        agentRoot,
-        appRoot,
-        channels: channelsResult.sources,
-        connections: connectionsResult.connections,
-        packageName,
-        diagnostics,
-        hooks: hooksResult.sources,
-        lib: libResult.lib,
-        instructions: instructionsResult.instructions,
-        sandbox: sandboxResult.sandbox,
-        sandboxWorkspaces: sandboxResult.sandboxWorkspace === null ? [] : [sandboxResult.sandboxWorkspace],
-        schedules: schedulesResult.schedules,
-        skills: skillsResult.skills,
-        tools: toolsResult.sources,
-        subagents: subagentsResult.subagents,
-    };
-    if (configModuleResult.module !== undefined) {
-        manifestInput.configModule = configModuleResult.module;
-    }
-    const manifest = createAgentSourceManifest(manifestInput);
-    return {
-        diagnostics,
-        manifest,
-    };
-}
-/**
- * Reads the `name` field from the app root's package.json through `source`
- * and strips the npm scope prefix when present (e.g. `"@org/my-agent"` →
- * `"my-agent"`).
- *
- * Returns `undefined` when the file does not exist, cannot be parsed, or does
- * not contain a non-empty string `name` field.
- */
-async function tryReadPackageJsonName(source, appRoot) {
-    try {
-        const packageJsonPath = join(appRoot, "package.json");
-        const content = JSON.parse(await source.readTextFile(packageJsonPath));
-        const name = content.name;
-        if (typeof name !== "string" || name.length === 0) {
-            return undefined;
-        }
-        const slashIndex = name.lastIndexOf("/");
-        return slashIndex === -1 ? name : name.slice(slashIndex + 1);
-    }
-    catch {
-        return undefined;
-    }
-}
+import{join,resolve}from"node:path";import{classifyAgentRootEntry}from"#discover/filesystem.js";import{createDiskProjectSource}from"#discover/project-source.js";import{createAgentSourceManifest}from"#discover/manifest.js";import{DISCOVER_CHANNELS_DIRECTORY_INVALID,DISCOVER_HOOKS_DIRECTORY_INVALID,DISCOVER_TOOLS_DIRECTORY_INVALID,createChannelNameDiagnostic,createHookNameDiagnostic,createToolNameDiagnostic,createUnsupportedRootDirectoryDiagnostics,discoverFlatModuleSource,discoverInstructionsSource,discoverNamedSourceDirectory,readSortedDirectoryEntries}from"#discover/grammar.js";import{discoverConnectionSources}from"#discover/connections.js";import{discoverSubagents}from"#discover/discover-subagent.js";import{discoverLibSources}from"#discover/lib.js";import{discoverSandboxSource}from"#discover/sandbox.js";import{discoverScheduleSources}from"#discover/schedules.js";import{discoverSkills}from"#discover/skills.js";async function discoverAgent(o){let s=o.source??createDiskProjectSource(),c=resolve(o.appRoot),l=resolve(o.agentRoot),u=[],d=await tryReadPackageJsonName(s,c),f=await readSortedDirectoryEntries(s,l);u.push(...createUnsupportedRootDirectoryDiagnostics({classifyEntry:classifyAgentRootEntry,createUnsupportedDirectoryMessage(e){return`Ignoring unsupported directory "${e}/" in the agent root.`},rootEntries:f,rootPath:l}));let p=await discoverInstructionsSource({rootEntries:f,rootPath:l,source:s});u.push(...p.diagnostics);let m=discoverFlatModuleSource({rootEntries:f,rootPath:l,slotName:`agent`});u.push(...m.diagnostics);let h=await discoverNamedSourceDirectory({directoryName:`channels`,invalidDirectoryCode:DISCOVER_CHANNELS_DIRECTORY_INVALID,invalidDirectoryMessage:`Expected "${join(l,`channels`)}" to be a directory of authored channels.`,recursive:!0,rootEntries:f,rootPath:l,source:s,validateSegment:createChannelNameDiagnostic});u.push(...h.diagnostics);let g=await discoverLibSources({agentRoot:l,rootEntries:f,source:s});u.push(...g.diagnostics);let _=await discoverScheduleSources({agentRoot:l,rootEntries:f,source:s});u.push(..._.diagnostics);let v=await discoverConnectionSources({rootEntries:f,rootPath:l,source:s});u.push(...v.diagnostics);let y=await discoverSandboxSource({rootEntries:f,rootPath:l,source:s});u.push(...y.diagnostics);let b=await discoverNamedSourceDirectory({directoryName:`tools`,invalidDirectoryCode:DISCOVER_TOOLS_DIRECTORY_INVALID,invalidDirectoryMessage:`Expected "${join(l,`tools`)}" to be a directory of authored tools.`,recursive:!0,rootEntries:f,rootPath:l,source:s,validateSegment:createToolNameDiagnostic});u.push(...b.diagnostics);let x=await discoverNamedSourceDirectory({directoryName:`hooks`,invalidDirectoryCode:DISCOVER_HOOKS_DIRECTORY_INVALID,invalidDirectoryMessage:`Expected "${join(l,`hooks`)}" to be a directory of authored hooks.`,recursive:!0,rootEntries:f,rootPath:l,source:s,validateSegment:createHookNameDiagnostic});u.push(...x.diagnostics);let S=await discoverSkills({agentRoot:l,source:s});u.push(...S.diagnostics);let C=await discoverSubagents({agentRoot:l,appRoot:c,source:s});u.push(...C.diagnostics);let w={agentRoot:l,appRoot:c,channels:h.sources,connections:v.connections,packageName:d,diagnostics:u,hooks:x.sources,lib:g.lib,instructions:p.instructions,sandbox:y.sandbox,sandboxWorkspaces:y.sandboxWorkspace===null?[]:[y.sandboxWorkspace],schedules:_.schedules,skills:S.skills,tools:b.sources,subagents:C.subagents};return m.module!==void 0&&(w.configModule=m.module),{diagnostics:u,manifest:createAgentSourceManifest(w)}}async function tryReadPackageJsonName(t,n){try{let r=join(n,`package.json`),i=JSON.parse(await t.readTextFile(r)).name;if(typeof i!=`string`||i.length===0)return;let a=i.lastIndexOf(`/`);return a===-1?i:i.slice(a+1)}catch{return}}export{discoverAgent};

package/dist/src/discover/discover-subagent.js

@@ -1,223 +1 @@
-import { join, relative, resolve } from "node:path";
-import { discoverConnectionSources } from "#discover/connections.js";
-import { createDiscoverErrorDiagnostic } from "#discover/diagnostics.js";
-import { classifyLocalSubagentEntry, getDirectoryEntryType, getSupportedModuleBaseName, normalizeLogicalPath, } from "#discover/filesystem.js";
-import { createHookNameDiagnostic, createToolNameDiagnostic, createUnsupportedRootDirectoryDiagnostics, DISCOVER_TOOLS_DIRECTORY_INVALID, discoverFlatModuleSource, discoverInstructionsSource, discoverNamedSourceDirectory, readSortedDirectoryEntries, } from "#discover/grammar.js";
-import { DISCOVER_HOOKS_DIRECTORY_INVALID } from "#discover/grammar.js";
-import { discoverLibSources } from "#discover/lib.js";
-import { createAgentSourceManifest, createLocalSubagentSourceRef, createModuleSourceRef, } from "#discover/manifest.js";
-import { createDiskProjectSource, } from "#discover/project-source.js";
-import { discoverSandboxSource } from "#discover/sandbox.js";
-import { discoverSkills } from "#discover/skills.js";
-/**
- * Diagnostics emitted while discovering subagent source graphs.
- */
-export const DISCOVER_LOCAL_SUBAGENT_SCHEDULES_INVALID = "discover/local-subagent-schedules-invalid";
-export const DISCOVER_REQUIRED_SUBAGENT_CONFIG_MODULE_MISSING = "discover/required-subagent-config-module-missing";
-export const DISCOVER_SUBAGENTS_DIRECTORY_INVALID = "discover/subagents-directory-invalid";
-/**
- * Discovers local subagent packages recursively without importing authored
- * modules.
- */
-export async function discoverSubagents(input) {
-    const source = input.source ?? createDiskProjectSource();
-    const agentRoot = resolve(input.agentRoot);
-    const subagentsDirectoryPath = resolve(input.subagentsDirectoryPath ?? join(agentRoot, "subagents"));
-    const subagentsLogicalPath = normalizeLogicalPath(input.subagentsLogicalPath ?? relative(agentRoot, subagentsDirectoryPath));
-    const subagentsDirectoryType = await source.stat(subagentsDirectoryPath);
-    if (subagentsDirectoryType === "missing") {
-        return {
-            diagnostics: [],
-            subagents: [],
-        };
-    }
-    if (subagentsDirectoryType !== "directory") {
-        return {
-            diagnostics: [
-                createDiscoverErrorDiagnostic({
-                    code: DISCOVER_SUBAGENTS_DIRECTORY_INVALID,
-                    message: `Expected "${subagentsDirectoryPath}" to be a directory of authored subagents.`,
-                    sourcePath: subagentsDirectoryPath,
-                }),
-            ],
-            subagents: [],
-        };
-    }
-    const entries = await readSortedDirectoryEntries(source, subagentsDirectoryPath);
-    const diagnostics = [];
-    const subagents = [];
-    for (const entry of entries) {
-        if (entry.isFile()) {
-            const subagentId = getSupportedModuleBaseName(entry.name);
-            if (subagentId === null) {
-                continue;
-            }
-            subagents.push(discoverSingleFileSubagent({
-                agentRoot,
-                appRoot: input.appRoot,
-                subagentId,
-                subagentLogicalPath: join(subagentsLogicalPath, entry.name),
-                subagentPath: join(subagentsDirectoryPath, entry.name),
-            }));
-            continue;
-        }
-        if (!entry.isDirectory()) {
-            continue;
-        }
-        const localSubagentResult = await discoverLocalSubagentPackage({
-            appRoot: input.appRoot,
-            source,
-            subagentId: entry.name,
-            subagentLogicalPath: join(subagentsLogicalPath, entry.name),
-            subagentRoot: join(subagentsDirectoryPath, entry.name),
-        });
-        diagnostics.push(...localSubagentResult.diagnostics);
-        subagents.push(localSubagentResult.subagent);
-    }
-    return {
-        diagnostics,
-        subagents,
-    };
-}
-function discoverSingleFileSubagent(input) {
-    const configModule = createModuleSourceRef({
-        logicalPath: input.subagentLogicalPath,
-    });
-    const manifest = createAgentSourceManifest({
-        agentId: input.subagentId,
-        agentRoot: input.agentRoot,
-        appRoot: input.appRoot,
-        configModule,
-    });
-    return createLocalSubagentSourceRef({
-        entryPath: input.subagentPath,
-        logicalPath: input.subagentLogicalPath,
-        manifest,
-        rootPath: input.agentRoot,
-        subagentId: input.subagentId,
-    });
-}
-async function discoverLocalSubagentPackage(input) {
-    const diagnostics = [];
-    const rootEntries = await readSortedDirectoryEntries(input.source, input.subagentRoot);
-    diagnostics.push(...createUnsupportedRootDirectoryDiagnostics({
-        classifyEntry: classifyLocalSubagentEntry,
-        createUnsupportedDirectoryMessage(directoryName) {
-            return `Ignoring unsupported directory "${directoryName}/" in the local subagent root.`;
-        },
-        rootEntries,
-        rootPath: input.subagentRoot,
-    }));
-    const instructionsResult = await discoverInstructionsSource({
-        required: false,
-        rootEntries,
-        rootPath: input.subagentRoot,
-        source: input.source,
-    });
-    diagnostics.push(...instructionsResult.diagnostics);
-    const configModuleResult = discoverFlatModuleSource({
-        missingDiagnostic: {
-            code: DISCOVER_REQUIRED_SUBAGENT_CONFIG_MODULE_MISSING,
-            message: 'Expected one authored subagent config module at "agent.ts", "agent.cts", "agent.mts", "agent.js", "agent.cjs", or "agent.mjs".',
-        },
-        rootEntries,
-        rootPath: input.subagentRoot,
-        slotName: "agent",
-    });
-    diagnostics.push(...configModuleResult.diagnostics);
-    const connectionsResult = await discoverConnectionSources({
-        rootEntries,
-        rootPath: input.subagentRoot,
-        source: input.source,
-    });
-    diagnostics.push(...connectionsResult.diagnostics);
-    const sandboxResult = await discoverSandboxSource({
-        rootEntries,
-        rootPath: input.subagentRoot,
-        source: input.source,
-    });
-    diagnostics.push(...sandboxResult.diagnostics);
-    const toolsResult = await discoverNamedSourceDirectory({
-        directoryName: "tools",
-        invalidDirectoryCode: DISCOVER_TOOLS_DIRECTORY_INVALID,
-        invalidDirectoryMessage: `Expected "${join(input.subagentRoot, "tools")}" to be a directory of authored tools.`,
-        recursive: true,
-        rootEntries,
-        rootPath: input.subagentRoot,
-        source: input.source,
-        validateSegment: createToolNameDiagnostic,
-    });
-    diagnostics.push(...toolsResult.diagnostics);
-    const hooksResult = await discoverNamedSourceDirectory({
-        directoryName: "hooks",
-        invalidDirectoryCode: DISCOVER_HOOKS_DIRECTORY_INVALID,
-        invalidDirectoryMessage: `Expected "${join(input.subagentRoot, "hooks")}" to be a directory of authored hooks.`,
-        recursive: true,
-        rootEntries,
-        rootPath: input.subagentRoot,
-        source: input.source,
-        validateSegment: createHookNameDiagnostic,
-    });
-    diagnostics.push(...hooksResult.diagnostics);
-    const libResult = await discoverLibSources({
-        agentRoot: input.subagentRoot,
-        rootEntries,
-        source: input.source,
-    });
-    diagnostics.push(...libResult.diagnostics);
-    diagnostics.push(...createLocalSubagentScheduleDiagnostics(input.subagentRoot, rootEntries));
-    const skillsResult = await discoverSkills({
-        agentRoot: input.subagentRoot,
-        source: input.source,
-    });
-    diagnostics.push(...skillsResult.diagnostics);
-    const subagentsResult = await discoverSubagents({
-        agentRoot: input.subagentRoot,
-        appRoot: input.appRoot,
-        source: input.source,
-    });
-    diagnostics.push(...subagentsResult.diagnostics);
-    const manifestInput = {
-        agentRoot: input.subagentRoot,
-        appRoot: input.appRoot,
-        connections: connectionsResult.connections,
-        diagnostics,
-        hooks: hooksResult.sources,
-        lib: libResult.lib,
-        instructions: instructionsResult.instructions,
-        sandbox: sandboxResult.sandbox,
-        sandboxWorkspaces: sandboxResult.sandboxWorkspace === null ? [] : [sandboxResult.sandboxWorkspace],
-        skills: skillsResult.skills,
-        tools: toolsResult.sources,
-        subagents: subagentsResult.subagents,
-    };
-    if (configModuleResult.module !== undefined) {
-        manifestInput.configModule = configModuleResult.module;
-    }
-    const manifest = createAgentSourceManifest(manifestInput);
-    return {
-        diagnostics,
-        subagent: createLocalSubagentSourceRef({
-            entryPath: input.subagentRoot,
-            logicalPath: input.subagentLogicalPath,
-            manifest,
-            rootPath: input.subagentRoot,
-            subagentId: input.subagentId,
-        }),
-    };
-}
-function createLocalSubagentScheduleDiagnostics(subagentRoot, rootEntries) {
-    return rootEntries.flatMap((entry) => {
-        if (classifyLocalSubagentEntry(entry.name, getDirectoryEntryType(entry)) !==
-            "invalid-schedules-directory") {
-            return [];
-        }
-        return [
-            createDiscoverErrorDiagnostic({
-                code: DISCOVER_LOCAL_SUBAGENT_SCHEDULES_INVALID,
-                message: `Local subagent packages cannot define schedules at "${join(subagentRoot, entry.name)}".`,
-                sourcePath: join(subagentRoot, entry.name),
-            }),
-        ];
-    });
-}
+import{join,relative,resolve}from"node:path";import{createDiscoverErrorDiagnostic}from"#discover/diagnostics.js";import{classifyLocalSubagentEntry,getDirectoryEntryType,getSupportedModuleBaseName,normalizeLogicalPath}from"#discover/filesystem.js";import{createDiskProjectSource}from"#discover/project-source.js";import{createAgentSourceManifest,createLocalSubagentSourceRef,createModuleSourceRef}from"#discover/manifest.js";import{DISCOVER_HOOKS_DIRECTORY_INVALID,DISCOVER_TOOLS_DIRECTORY_INVALID,createHookNameDiagnostic,createToolNameDiagnostic,createUnsupportedRootDirectoryDiagnostics,discoverFlatModuleSource,discoverInstructionsSource,discoverNamedSourceDirectory,readSortedDirectoryEntries}from"#discover/grammar.js";import{discoverConnectionSources}from"#discover/connections.js";import{discoverLibSources}from"#discover/lib.js";import{discoverSandboxSource}from"#discover/sandbox.js";import{discoverSkills}from"#discover/skills.js";var DISCOVER_LOCAL_SUBAGENT_SCHEDULES_INVALID=`discover/local-subagent-schedules-invalid`,DISCOVER_REQUIRED_SUBAGENT_CONFIG_MODULE_MISSING=`discover/required-subagent-config-module-missing`,DISCOVER_SUBAGENTS_DIRECTORY_INVALID=`discover/subagents-directory-invalid`;async function discoverSubagents(i){let a=i.source??createDiskProjectSource(),l=resolve(i.agentRoot),u=resolve(i.subagentsDirectoryPath??join(l,`subagents`)),d=normalizeLogicalPath(i.subagentsLogicalPath??relative(l,u)),f=await a.stat(u);if(f===`missing`)return{diagnostics:[],subagents:[]};if(f!==`directory`)return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_SUBAGENTS_DIRECTORY_INVALID,message:`Expected "${u}" to be a directory of authored subagents.`,sourcePath:u})],subagents:[]};let p=await readSortedDirectoryEntries(a,u),m=[],h=[];for(let t of p){if(t.isFile()){let n=getSupportedModuleBaseName(t.name);if(n===null)continue;h.push(discoverSingleFileSubagent({agentRoot:l,appRoot:i.appRoot,subagentId:n,subagentLogicalPath:join(d,t.name),subagentPath:join(u,t.name)}));continue}if(!t.isDirectory())continue;let n=await discoverLocalSubagentPackage({appRoot:i.appRoot,source:a,subagentId:t.name,subagentLogicalPath:join(d,t.name),subagentRoot:join(u,t.name)});m.push(...n.diagnostics),h.push(n.subagent)}return{diagnostics:m,subagents:h}}function discoverSingleFileSubagent(e){let t=createModuleSourceRef({logicalPath:e.subagentLogicalPath}),n=createAgentSourceManifest({agentId:e.subagentId,agentRoot:e.agentRoot,appRoot:e.appRoot,configModule:t});return createLocalSubagentSourceRef({entryPath:e.subagentPath,logicalPath:e.subagentLogicalPath,manifest:n,rootPath:e.agentRoot,subagentId:e.subagentId})}async function discoverLocalSubagentPackage(t){let n=[],r=await readSortedDirectoryEntries(t.source,t.subagentRoot);n.push(...createUnsupportedRootDirectoryDiagnostics({classifyEntry:classifyLocalSubagentEntry,createUnsupportedDirectoryMessage(e){return`Ignoring unsupported directory "${e}/" in the local subagent root.`},rootEntries:r,rootPath:t.subagentRoot}));let a=await discoverInstructionsSource({required:!1,rootEntries:r,rootPath:t.subagentRoot,source:t.source});n.push(...a.diagnostics);let o=discoverFlatModuleSource({missingDiagnostic:{code:DISCOVER_REQUIRED_SUBAGENT_CONFIG_MODULE_MISSING,message:`Expected one authored subagent config module at "agent.ts", "agent.cts", "agent.mts", "agent.js", "agent.cjs", or "agent.mjs".`},rootEntries:r,rootPath:t.subagentRoot,slotName:`agent`});n.push(...o.diagnostics);let s=await discoverConnectionSources({rootEntries:r,rootPath:t.subagentRoot,source:t.source});n.push(...s.diagnostics);let c=await discoverSandboxSource({rootEntries:r,rootPath:t.subagentRoot,source:t.source});n.push(...c.diagnostics);let d=await discoverNamedSourceDirectory({directoryName:`tools`,invalidDirectoryCode:DISCOVER_TOOLS_DIRECTORY_INVALID,invalidDirectoryMessage:`Expected "${join(t.subagentRoot,`tools`)}" to be a directory of authored tools.`,recursive:!0,rootEntries:r,rootPath:t.subagentRoot,source:t.source,validateSegment:createToolNameDiagnostic});n.push(...d.diagnostics);let g=await discoverNamedSourceDirectory({directoryName:`hooks`,invalidDirectoryCode:DISCOVER_HOOKS_DIRECTORY_INVALID,invalidDirectoryMessage:`Expected "${join(t.subagentRoot,`hooks`)}" to be a directory of authored hooks.`,recursive:!0,rootEntries:r,rootPath:t.subagentRoot,source:t.source,validateSegment:createHookNameDiagnostic});n.push(...g.diagnostics);let _=await discoverLibSources({agentRoot:t.subagentRoot,rootEntries:r,source:t.source});n.push(..._.diagnostics),n.push(...createLocalSubagentScheduleDiagnostics(t.subagentRoot,r));let v=await discoverSkills({agentRoot:t.subagentRoot,source:t.source});n.push(...v.diagnostics);let y=await discoverSubagents({agentRoot:t.subagentRoot,appRoot:t.appRoot,source:t.source});n.push(...y.diagnostics);let b={agentRoot:t.subagentRoot,appRoot:t.appRoot,connections:s.connections,diagnostics:n,hooks:g.sources,lib:_.lib,instructions:a.instructions,sandbox:c.sandbox,sandboxWorkspaces:c.sandboxWorkspace===null?[]:[c.sandboxWorkspace],skills:v.skills,tools:d.sources,subagents:y.subagents};o.module!==void 0&&(b.configModule=o.module);let x=createAgentSourceManifest(b);return{diagnostics:n,subagent:createLocalSubagentSourceRef({entryPath:t.subagentRoot,logicalPath:t.subagentLogicalPath,manifest:x,rootPath:t.subagentRoot,subagentId:t.subagentId})}}function createLocalSubagentScheduleDiagnostics(t,n){return n.flatMap(n=>classifyLocalSubagentEntry(n.name,getDirectoryEntryType(n))===`invalid-schedules-directory`?[createDiscoverErrorDiagnostic({code:DISCOVER_LOCAL_SUBAGENT_SCHEDULES_INVALID,message:`Local subagent packages cannot define schedules at "${join(t,n.name)}".`,sourcePath:join(t,n.name)})]:[])}export{DISCOVER_LOCAL_SUBAGENT_SCHEDULES_INVALID,DISCOVER_REQUIRED_SUBAGENT_CONFIG_MODULE_MISSING,DISCOVER_SUBAGENTS_DIRECTORY_INVALID,discoverSubagents};