experimental-ash 0.24.2 → 0.25.1

package/dist/src/discover/connections.d.ts

@@ -19,7 +19,7 @@ export declare const DISCOVER_CONNECTION_FOLDER_EMPTY = "discover/connection-fol
 /**
  * Result of discovering authored connection sources from a single agent root.
  */
-export interface DiscoverConnectionSourcesResult {
+interface DiscoverConnectionSourcesResult {
     connections: ConnectionSourceRef[];
     diagnostics: DiscoverDiagnostic[];
 }
@@ -31,3 +31,4 @@ export declare function discoverConnectionSources(input: {
     rootPath: string;
     source: ProjectSource;
 }): Promise<DiscoverConnectionSourcesResult>;
+export {};

package/dist/src/discover/diagnostics.d.ts

@@ -35,10 +35,6 @@ export declare const discoverDiagnosticsSummarySchema: z.ZodObject<{
  * Root-resolution error code emitted when discovery cannot locate an Ash agent.
  */
 export declare const DISCOVER_PROJECT_NOT_FOUND = "discover/project-not-found";
-/**
- * Creates a structured discovery diagnostic.
- */
-export declare function createDiscoverDiagnostic(input: DiscoverDiagnostic): DiscoverDiagnostic;
 /**
  * Creates an error-level discovery diagnostic.
  */
@@ -47,10 +43,6 @@ export declare function createDiscoverErrorDiagnostic(input: Omit<DiscoverDiagno
  * Creates a warning-level discovery diagnostic.
  */
 export declare function createDiscoverWarningDiagnostic(input: Omit<DiscoverDiagnostic, "severity">): DiscoverDiagnostic;
-/**
- * Returns whether an unknown value satisfies the discovery diagnostic shape.
- */
-export declare function isDiscoverDiagnostic(value: unknown): value is DiscoverDiagnostic;
 /**
  * Summarizes discovery diagnostics into error and warning counts.
  */

package/dist/src/discover/diagnostics.js

@@ -39,35 +39,23 @@ export const discoverDiagnosticsSummarySchema = z
  * Root-resolution error code emitted when discovery cannot locate an Ash agent.
  */
 export const DISCOVER_PROJECT_NOT_FOUND = "discover/project-not-found";
-/**
- * Creates a structured discovery diagnostic.
- */
-export function createDiscoverDiagnostic(input) {
-    return input;
-}
 /**
  * Creates an error-level discovery diagnostic.
  */
 export function createDiscoverErrorDiagnostic(input) {
-    return createDiscoverDiagnostic({
+    return {
         ...input,
         severity: "error",
-    });
+    };
 }
 /**
  * Creates a warning-level discovery diagnostic.
  */
 export function createDiscoverWarningDiagnostic(input) {
-    return createDiscoverDiagnostic({
+    return {
         ...input,
         severity: "warning",
-    });
-}
-/**
- * Returns whether an unknown value satisfies the discovery diagnostic shape.
- */
-export function isDiscoverDiagnostic(value) {
-    return discoverDiagnosticSchema.safeParse(value).success;
+    };
 }
 /**
  * Summarizes discovery diagnostics into error and warning counts.

package/dist/src/discover/discover-agent.d.ts

@@ -1,21 +1,10 @@
 import type { DiscoverDiagnostic } from "#discover/diagnostics.js";
-import { DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_HOOK_NAME_INVALID, DISCOVER_DEPRECATED_SYSTEM_SLOT, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_INSTRUCTIONS_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY } from "#discover/grammar.js";
 import { type AgentSourceManifest } from "#discover/manifest.js";
 import { type ProjectSource } from "#discover/project-source.js";
-export { DISCOVER_CONNECTION_FILE_FOLDER_COLLISION, DISCOVER_CONNECTION_FOLDER_EMPTY, DISCOVER_CONNECTIONS_DIRECTORY_INVALID, } from "#discover/connections.js";
-export { DISCOVER_SANDBOX_FOLDER_EMPTY, DISCOVER_SANDBOX_WORKSPACE_SKILLS_RESERVED, } from "#discover/sandbox.js";
-/**
- * Diagnostics emitted while discovering the non-skill core authored agent
- * grammar.
- */
-export { DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_DEPRECATED_SYSTEM_SLOT, DISCOVER_HOOK_NAME_INVALID, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_INSTRUCTIONS_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, };
-export declare const DISCOVER_CHANNELS_DIRECTORY_INVALID = "discover/channels-directory-invalid";
-export declare const DISCOVER_HOOKS_DIRECTORY_INVALID = "discover/hooks-directory-invalid";
-export { DISCOVER_SCHEDULE_FILE_UNSUPPORTED, DISCOVER_SCHEDULES_DIRECTORY_INVALID, } from "#discover/schedules.js";
 /**
  * Input for discovering the authored agent source graph from resolved roots.
  */
-export interface DiscoverAgentInput {
+interface DiscoverAgentInput {
     agentRoot: string;
     appRoot: string;
     /**
@@ -29,7 +18,7 @@ export interface DiscoverAgentInput {
 /**
  * Result of discovering one authored agent source graph.
  */
-export interface DiscoverAgentResult {
+interface DiscoverAgentResult {
     diagnostics: DiscoverDiagnostic[];
     manifest: AgentSourceManifest;
 }
@@ -38,3 +27,4 @@ export interface DiscoverAgentResult {
  * modules.
  */
 export declare function discoverAgent(input: DiscoverAgentInput): Promise<DiscoverAgentResult>;
+export {};

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

@@ -2,23 +2,13 @@ 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_CHANNEL_NAME_INVALID, DISCOVER_HOOK_NAME_INVALID, DISCOVER_DEPRECATED_SYSTEM_SLOT, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_INSTRUCTIONS_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, discoverFlatModuleSource, discoverInstructionsSource, discoverNamedSourceDirectory, readSortedDirectoryEntries, } from "#discover/grammar.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";
-export { DISCOVER_CONNECTION_FILE_FOLDER_COLLISION, DISCOVER_CONNECTION_FOLDER_EMPTY, DISCOVER_CONNECTIONS_DIRECTORY_INVALID, } from "#discover/connections.js";
-export { DISCOVER_SANDBOX_FOLDER_EMPTY, DISCOVER_SANDBOX_WORKSPACE_SKILLS_RESERVED, } from "#discover/sandbox.js";
-/**
- * Diagnostics emitted while discovering the non-skill core authored agent
- * grammar.
- */
-export { DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_DEPRECATED_SYSTEM_SLOT, DISCOVER_HOOK_NAME_INVALID, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_INSTRUCTIONS_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, };
-export const DISCOVER_CHANNELS_DIRECTORY_INVALID = "discover/channels-directory-invalid";
-export const DISCOVER_HOOKS_DIRECTORY_INVALID = "discover/hooks-directory-invalid";
-export { DISCOVER_SCHEDULE_FILE_UNSUPPORTED, DISCOVER_SCHEDULES_DIRECTORY_INVALID, } from "#discover/schedules.js";
 /**
  * Discovers the current agent's authored source graph without importing authored
  * modules.

package/dist/src/discover/discover-subagent.d.ts

@@ -10,7 +10,7 @@ export declare const DISCOVER_SUBAGENTS_DIRECTORY_INVALID = "discover/subagents-
 /**
  * Input for discovering subagent entries beneath one authored source root.
  */
-export interface DiscoverSubagentsInput {
+interface DiscoverSubagentsInput {
     agentRoot: string;
     appRoot: string;
     /**
@@ -24,7 +24,7 @@ export interface DiscoverSubagentsInput {
 /**
  * Result of discovering local subagent packages.
  */
-export interface DiscoverSubagentsResult {
+interface DiscoverSubagentsResult {
     diagnostics: DiscoverDiagnostic[];
     subagents: SubagentSourceRef[];
 }
@@ -33,3 +33,4 @@ export interface DiscoverSubagentsResult {
  * modules.
  */
 export declare function discoverSubagents(input: DiscoverSubagentsInput): Promise<DiscoverSubagentsResult>;
+export {};

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

@@ -3,7 +3,7 @@ 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/discover-agent.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";

package/dist/src/discover/filesystem.d.ts

@@ -8,31 +8,6 @@ export declare const SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS: readonly [".cts"
  * with a top-level `agent/` directory.
  */
 export declare const PROJECT_MARKER_FILE_NAMES: readonly ["package.json", "vercel.json"];
-/**
- * Supported root-level files inside an agent package.
- */
-export declare const AGENT_ROOT_FILE_NAMES: readonly ["agent.ts", "agent.cts", "agent.mts", "agent.js", "agent.cjs", "agent.mjs", "instructions.md", "instructions.ts", "instructions.cts", "instructions.mts", "instructions.js", "instructions.cjs", "instructions.mjs", "system.md", "system.ts", "system.cts", "system.mts", "system.js", "system.cjs", "system.mjs"];
-/**
- * Supported root-level directories inside an agent package.
- */
-export declare const AGENT_ROOT_DIRECTORY_NAMES: readonly ["channels", "connections", "hooks", "lib", "sandbox", "skills", "tools", "schedules", "subagents"];
-/**
- * Supported local-subagent entry file names. Subagents reuse the root
- * agent's `agent.{ts,...}` config slot.
- */
-export declare const LOCAL_SUBAGENT_FILE_NAMES: readonly ["agent.ts", "agent.cts", "agent.mts", "agent.js", "agent.cjs", "agent.mjs", "instructions.md", "instructions.ts", "instructions.cts", "instructions.mts", "instructions.js", "instructions.cjs", "instructions.mjs", "system.md", "system.ts", "system.cts", "system.mts", "system.js", "system.cjs", "system.mjs"];
-/**
- * Supported local-subagent subdirectories.
- */
-export declare const LOCAL_SUBAGENT_DIRECTORY_NAMES: readonly ["hooks", "lib", "sandbox", "skills", "tools", "subagents"];
-/**
- * Supported Agent Skills package entries.
- */
-export declare const SKILL_PACKAGE_FILE_NAMES: readonly ["SKILL.md"];
-/**
- * Optional Agent Skills package subdirectories.
- */
-export declare const SKILL_PACKAGE_DIRECTORY_NAMES: readonly ["scripts", "references", "assets"];
 /**
  * Filesystem entry type used by discovery classifiers.
  */
@@ -77,18 +52,6 @@ export declare function classifySkillPackageEntry(name: string, entryType: Direc
  * Classifies one top-level entry inside the authored `skills/` directory.
  */
 export declare function classifySkillsDirectoryEntry(name: string, entryType: DirectoryEntryType): SkillsDirectoryEntryKind;
-/**
- * Returns whether a directory entry is a supported root-level agent entry.
- */
-export declare function isAgentRootEntry(name: string, entryType: DirectoryEntryType): boolean;
-/**
- * Returns whether a directory entry is a supported local-subagent root entry.
- */
-export declare function isLocalSubagentEntry(name: string, entryType: DirectoryEntryType): boolean;
-/**
- * Returns whether a directory entry is a recognized Agent Skills package entry.
- */
-export declare function isSkillPackageEntry(name: string, entryType: DirectoryEntryType): boolean;
 /**
  * Normalizes an agent-root-relative logical path to forward slashes.
  */

package/dist/src/discover/filesystem.js

@@ -15,101 +15,7 @@ export const SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS = [
  * with a top-level `agent/` directory.
  */
 export const PROJECT_MARKER_FILE_NAMES = ["package.json", "vercel.json"];
-/**
- * Supported root-level files inside an agent package.
- */
-export const AGENT_ROOT_FILE_NAMES = [
-    "agent.ts",
-    "agent.cts",
-    "agent.mts",
-    "agent.js",
-    "agent.cjs",
-    "agent.mjs",
-    "instructions.md",
-    "instructions.ts",
-    "instructions.cts",
-    "instructions.mts",
-    "instructions.js",
-    "instructions.cjs",
-    "instructions.mjs",
-    // The `system` files are deprecated and will be removed soon.
-    // TODO: Clean up in the near future.
-    "system.md",
-    "system.ts",
-    "system.cts",
-    "system.mts",
-    "system.js",
-    "system.cjs",
-    "system.mjs",
-];
-/**
- * Supported root-level directories inside an agent package.
- */
-export const AGENT_ROOT_DIRECTORY_NAMES = [
-    "channels",
-    "connections",
-    "hooks",
-    "lib",
-    "sandbox",
-    "skills",
-    "tools",
-    "schedules",
-    "subagents",
-];
-/**
- * Supported local-subagent entry file names. Subagents reuse the root
- * agent's `agent.{ts,...}` config slot.
- */
-export const LOCAL_SUBAGENT_FILE_NAMES = [
-    "agent.ts",
-    "agent.cts",
-    "agent.mts",
-    "agent.js",
-    "agent.cjs",
-    "agent.mjs",
-    "instructions.md",
-    "instructions.ts",
-    "instructions.cts",
-    "instructions.mts",
-    "instructions.js",
-    "instructions.cjs",
-    "instructions.mjs",
-    // The `system` files are deprecated and will be removed soon.
-    // TODO: Clean up in the near future.
-    "system.md",
-    "system.ts",
-    "system.cts",
-    "system.mts",
-    "system.js",
-    "system.cjs",
-    "system.mjs",
-];
-/**
- * Supported local-subagent subdirectories.
- */
-export const LOCAL_SUBAGENT_DIRECTORY_NAMES = [
-    "hooks",
-    "lib",
-    "sandbox",
-    "skills",
-    "tools",
-    "subagents",
-];
-/**
- * Supported Agent Skills package entries.
- */
-export const SKILL_PACKAGE_FILE_NAMES = ["SKILL.md"];
-/**
- * Optional Agent Skills package subdirectories.
- */
-export const SKILL_PACKAGE_DIRECTORY_NAMES = ["scripts", "references", "assets"];
 const PROJECT_MARKER_FILE_NAME_SET = new Set(PROJECT_MARKER_FILE_NAMES);
-const AGENT_ROOT_FILE_NAME_SET = new Set(AGENT_ROOT_FILE_NAMES);
-const AGENT_ROOT_DIRECTORY_NAME_SET = new Set(AGENT_ROOT_DIRECTORY_NAMES);
-const LOCAL_SUBAGENT_FILE_NAME_SET = new Set(LOCAL_SUBAGENT_FILE_NAMES);
-const LOCAL_SUBAGENT_DIRECTORY_NAME_SET = new Set(LOCAL_SUBAGENT_DIRECTORY_NAMES);
-const SKILL_PACKAGE_FILE_NAME_SET = new Set(SKILL_PACKAGE_FILE_NAMES);
-const SKILL_PACKAGE_DIRECTORY_NAME_SET = new Set(SKILL_PACKAGE_DIRECTORY_NAMES);
 /**
  * Returns the normalized entry type for a Node filesystem dirent.
  */
@@ -271,27 +177,6 @@ export function classifySkillsDirectoryEntry(name, entryType) {
     }
     return "unknown";
 }
-/**
- * Returns whether a directory entry is a supported root-level agent entry.
- */
-export function isAgentRootEntry(name, entryType) {
-    return ((entryType === "file" && AGENT_ROOT_FILE_NAME_SET.has(name)) ||
-        (entryType === "directory" && AGENT_ROOT_DIRECTORY_NAME_SET.has(name)));
-}
-/**
- * Returns whether a directory entry is a supported local-subagent root entry.
- */
-export function isLocalSubagentEntry(name, entryType) {
-    return ((entryType === "file" && LOCAL_SUBAGENT_FILE_NAME_SET.has(name)) ||
-        (entryType === "directory" && LOCAL_SUBAGENT_DIRECTORY_NAME_SET.has(name)));
-}
-/**
- * Returns whether a directory entry is a recognized Agent Skills package entry.
- */
-export function isSkillPackageEntry(name, entryType) {
-    return ((entryType === "file" && SKILL_PACKAGE_FILE_NAME_SET.has(name)) ||
-        (entryType === "directory" && SKILL_PACKAGE_DIRECTORY_NAME_SET.has(name)));
-}
 /**
  * Normalizes an agent-root-relative logical path to forward slashes.
  */

package/dist/src/discover/grammar.d.ts

@@ -29,6 +29,16 @@ export declare const DISCOVER_SLOT_COLLISION = "discover/slot-collision";
  * directory.
  */
 export declare const DISCOVER_TOOLS_DIRECTORY_INVALID = "discover/tools-directory-invalid";
+/**
+ * Shared diagnostic emitted when the authored `hooks/` root is not a
+ * directory.
+ */
+export declare const DISCOVER_HOOKS_DIRECTORY_INVALID = "discover/hooks-directory-invalid";
+/**
+ * Shared diagnostic emitted when the authored `channels/` root is not a
+ * directory.
+ */
+export declare const DISCOVER_CHANNELS_DIRECTORY_INVALID = "discover/channels-directory-invalid";
 /**
  * Shared diagnostic emitted when an authored `tools/*.{ts,…}` filename does
  * not satisfy the model tool-name charset rule.
@@ -45,11 +55,6 @@ export declare const DISCOVER_CONNECTION_NAME_INVALID = "discover/connection-nam
  * stability across manifest versions.
  */
 export declare const DISCOVER_SANDBOX_DIRECTORY_INVALID = "discover/sandbox-directory-invalid";
-/**
- * Shared diagnostic emitted when an authored sandbox module filename does
- * not satisfy the sandbox slug charset rule.
- */
-export declare const DISCOVER_SANDBOX_NAME_INVALID = "discover/sandbox-name-invalid";
 /**
  * Shared diagnostic emitted when an authored `channels/**` filename or
  * directory segment does not satisfy the channel slug charset rule.
@@ -70,12 +75,6 @@ export declare const DISCOVER_HOOK_NAME_INVALID = "discover/hook-name-invalid";
  * want a snake_case identifier should name the file in snake_case.
  */
 export declare const TOOL_SLUG_PATTERN: RegExp;
-/**
- * Sandbox filename charset. Sandboxes are not exposed to model APIs as
- * identifiers, so they may use kebab-case slugs. The leading-letter and
- * length rules mirror the tool slug rule for consistency.
- */
-export declare const SANDBOX_SLUG_PATTERN: RegExp;
 /**
  * Connection filename charset. Connections use the same lowercase
  * kebab-case rule as sandbox since they are not directly exposed to
@@ -113,10 +112,6 @@ type InstructionsSourceRef = MarkdownSourceRef<InstructionsDefinition> | ModuleS
  * Reads one directory through `source` and returns its entries sorted by name.
  */
 export declare function readSortedDirectoryEntries(source: ProjectSource, directoryPath: string): Promise<ProjectSourceEntry[]>;
-/**
- * Returns the current filesystem type for one path, including missing paths.
- */
-export declare function getPathType(source: ProjectSource, targetPath: string): Promise<"directory" | "file" | "missing" | "other">;
 /**
  * Discovers one required `instructions.md|ts|cts|mts|js|cjs|mjs` source
  * from a root directory.
@@ -159,11 +154,6 @@ export declare function discoverFlatModuleSource(input: {
  * the compiler ever loads the module.
  */
 export declare function createToolNameDiagnostic(slotName: string, sourcePath: string): DiscoverDiagnostic | null;
-/**
- * Returns a discovery diagnostic when a sandbox slot name violates
- * {@link SANDBOX_SLUG_PATTERN}, or `null` when it satisfies the rule.
- */
-export declare function createSandboxNameDiagnostic(slotName: string, sourcePath: string): DiscoverDiagnostic | null;
 /**
  * Returns a discovery diagnostic when a connection slot name violates
  * {@link CONNECTION_SLUG_PATTERN}, or `null` when it satisfies the rule.

package/dist/src/discover/grammar.js

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { lowerInstructionsMarkdown } from "#public/helpers/markdown.js";
+import { lowerInstructionsMarkdown } from "#internal/helpers/markdown.js";
 import { createDiscoverErrorDiagnostic, createDiscoverWarningDiagnostic, } from "#discover/diagnostics.js";
 import { getDirectoryEntryType } from "#discover/filesystem.js";
 import { createModuleSourceRef } from "#discover/manifest.js";
@@ -30,6 +30,16 @@ export const DISCOVER_SLOT_COLLISION = "discover/slot-collision";
  * directory.
  */
 export const DISCOVER_TOOLS_DIRECTORY_INVALID = "discover/tools-directory-invalid";
+/**
+ * Shared diagnostic emitted when the authored `hooks/` root is not a
+ * directory.
+ */
+export const DISCOVER_HOOKS_DIRECTORY_INVALID = "discover/hooks-directory-invalid";
+/**
+ * Shared diagnostic emitted when the authored `channels/` root is not a
+ * directory.
+ */
+export const DISCOVER_CHANNELS_DIRECTORY_INVALID = "discover/channels-directory-invalid";
 /**
  * Shared diagnostic emitted when an authored `tools/*.{ts,…}` filename does
  * not satisfy the model tool-name charset rule.
@@ -46,11 +56,6 @@ export const DISCOVER_CONNECTION_NAME_INVALID = "discover/connection-name-invali
  * stability across manifest versions.
  */
 export const DISCOVER_SANDBOX_DIRECTORY_INVALID = "discover/sandbox-directory-invalid";
-/**
- * Shared diagnostic emitted when an authored sandbox module filename does
- * not satisfy the sandbox slug charset rule.
- */
-export const DISCOVER_SANDBOX_NAME_INVALID = "discover/sandbox-name-invalid";
 /**
  * Shared diagnostic emitted when an authored `channels/**` filename or
  * directory segment does not satisfy the channel slug charset rule.
@@ -71,12 +76,6 @@ export const DISCOVER_HOOK_NAME_INVALID = "discover/hook-name-invalid";
  * want a snake_case identifier should name the file in snake_case.
  */
 export const TOOL_SLUG_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
-/**
- * Sandbox filename charset. Sandboxes are not exposed to model APIs as
- * identifiers, so they may use kebab-case slugs. The leading-letter and
- * length rules mirror the tool slug rule for consistency.
- */
-export const SANDBOX_SLUG_PATTERN = /^[a-z][a-z0-9-]{0,63}$/;
 /**
  * Connection filename charset. Connections use the same lowercase
  * kebab-case rule as sandbox since they are not directly exposed to
@@ -107,12 +106,6 @@ export async function readSortedDirectoryEntries(source, directoryPath) {
     entries.sort((left, right) => left.name.localeCompare(right.name));
     return entries;
 }
-/**
- * Returns the current filesystem type for one path, including missing paths.
- */
-export async function getPathType(source, targetPath) {
-    return await source.stat(targetPath);
-}
 /**
  * Discovers one required `instructions.md|ts|cts|mts|js|cjs|mjs` source
  * from a root directory.
@@ -280,21 +273,6 @@ export function createToolNameDiagnostic(slotName, sourcePath) {
         sourcePath,
     });
 }
-/**
- * Returns a discovery diagnostic when a sandbox slot name violates
- * {@link SANDBOX_SLUG_PATTERN}, or `null` when it satisfies the rule.
- */
-export function createSandboxNameDiagnostic(slotName, sourcePath) {
-    if (SANDBOX_SLUG_PATTERN.test(slotName)) {
-        return null;
-    }
-    return createDiscoverErrorDiagnostic({
-        code: DISCOVER_SANDBOX_NAME_INVALID,
-        message: `Sandbox filename "${slotName}" is not a legal sandbox name. ` +
-            `Expected lowercase ASCII letters, digits, and dashes only, starting with a letter, up to 64 characters.`,
-        sourcePath,
-    });
-}
 /**
  * Returns a discovery diagnostic when a connection slot name violates
  * {@link CONNECTION_SLUG_PATTERN}, or `null` when it satisfies the rule.

package/dist/src/discover/lib.d.ts

@@ -14,7 +14,7 @@ export declare const DISCOVER_LIB_ENTRY_UNSUPPORTED = "discover/lib-entry-unsupp
 /**
  * Input for discovering authored helper modules under `lib/`.
  */
-export interface DiscoverLibSourcesInput {
+interface DiscoverLibSourcesInput {
     agentRoot: string;
     rootEntries: readonly ProjectSourceEntry[];
     source: ProjectSource;
@@ -22,7 +22,7 @@ export interface DiscoverLibSourcesInput {
 /**
  * Result of recursively discovering authored helper modules under `lib/`.
  */
-export interface DiscoverLibSourcesResult {
+interface DiscoverLibSourcesResult {
     diagnostics: DiscoverDiagnostic[];
     lib: ModuleSourceRef[];
 }
@@ -31,3 +31,4 @@ export interface DiscoverLibSourcesResult {
  * authored modules.
  */
 export declare function discoverLibSources(input: DiscoverLibSourcesInput): Promise<DiscoverLibSourcesResult>;
+export {};

package/dist/src/discover/manifest.d.ts

@@ -1,5 +1,5 @@
 import type { MarkdownSourceRef, ModuleSourceRef, SkillPackageSourceRef } from "#shared/source-ref.js";
-import type { InternalSkillDefinition } from "#shared/skill-definition.js";
+import type { NamedSkillDefinition } from "#shared/skill-definition.js";
 import type { ScheduleDefinition } from "#public/definitions/schedule.js";
 import type { SkillDefinition } from "#public/definitions/skill.js";
 import type { InstructionsDefinition } from "#public/definitions/instructions.js";
@@ -38,7 +38,7 @@ export type InstructionsSourceRef = MarkdownSourceRef<InstructionsDefinition> |
 /**
  * Skill source reference preserved by the discovery manifest.
  */
-export type SkillSourceRef = MarkdownSourceRef<SkillDefinition> | ModuleSourceRef | (InternalSkillDefinition & SkillPackageSourceRef);
+export type SkillSourceRef = MarkdownSourceRef<SkillDefinition> | ModuleSourceRef | (NamedSkillDefinition & SkillPackageSourceRef);
 /**
  * Recursive manifest entry for a local subagent package.
  */
@@ -244,4 +244,4 @@ export declare function createLocalSubagentSourceRef(input: CreateLocalSubagentS
 /**
  * Creates a skill package source ref while omitting optional undefined fields.
  */
-export declare function createSkillPackageSourceRef(input: CreateSkillPackageSourceRefInput): InternalSkillDefinition & SkillPackageSourceRef;
+export declare function createSkillPackageSourceRef(input: CreateSkillPackageSourceRefInput): NamedSkillDefinition & SkillPackageSourceRef;

package/dist/src/discover/markdown.d.ts

@@ -3,7 +3,7 @@ import type { ProjectSource } from "#discover/project-source.js";
 /**
  * Input for lowering one discovered markdown file into a typed source ref.
  */
-export interface DiscoverMarkdownSourceInput<TDefinition> {
+interface DiscoverMarkdownSourceInput<TDefinition> {
     logicalPath: string;
     lower: (source: string, input: {
         name: string;
@@ -16,3 +16,4 @@ export interface DiscoverMarkdownSourceInput<TDefinition> {
  * it into the shared manifest shape.
  */
 export declare function discoverMarkdownSource<TDefinition>(input: DiscoverMarkdownSourceInput<TDefinition>): Promise<MarkdownSourceRef<TDefinition>>;
+export {};

package/dist/src/discover/sandbox.d.ts

@@ -16,7 +16,7 @@ export declare const DISCOVER_SANDBOX_FOLDER_EMPTY = "discover/sandbox-folder-em
 /**
  * Result of discovering the authored sandbox from a single agent root.
  */
-export interface DiscoverSandboxSourceResult {
+interface DiscoverSandboxSourceResult {
     diagnostics: DiscoverDiagnostic[];
     sandbox: SandboxSourceRef | null;
     sandboxWorkspace: SandboxWorkspaceFolderSourceRef | null;
@@ -34,3 +34,4 @@ export declare function discoverSandboxSource(input: {
     rootPath: string;
     source: ProjectSource;
 }): Promise<DiscoverSandboxSourceResult>;
+export {};

package/dist/src/discover/schedules.d.ts

@@ -14,7 +14,7 @@ export declare const DISCOVER_SCHEDULE_FILE_UNSUPPORTED = "discover/schedule-fil
 /**
  * Input for discovering authored schedules under `schedules/`.
  */
-export interface DiscoverScheduleSourcesInput {
+interface DiscoverScheduleSourcesInput {
     agentRoot: string;
     rootEntries: readonly ProjectSourceEntry[];
     source: ProjectSource;
@@ -22,7 +22,7 @@ export interface DiscoverScheduleSourcesInput {
 /**
  * Result of discovering authored schedules under `schedules/`.
  */
-export interface DiscoverScheduleSourcesResult {
+interface DiscoverScheduleSourcesResult {
     diagnostics: DiscoverDiagnostic[];
     schedules: ScheduleSourceRef[];
 }
@@ -35,3 +35,4 @@ export interface DiscoverScheduleSourcesResult {
  * (`schedules/billing/invoice-sweep.ts` → `billing/invoice-sweep`).
  */
 export declare function discoverScheduleSources(input: DiscoverScheduleSourcesInput): Promise<DiscoverScheduleSourcesResult>;
+export {};

package/dist/src/discover/schedules.js

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { lowerScheduleMarkdown } from "#public/helpers/markdown.js";
+import { lowerScheduleMarkdown } from "#internal/helpers/markdown.js";
 import { discoverNamedSourceDirectory } from "#discover/grammar.js";
 /**
  * Diagnostic emitted when the authored `schedules/` root exists but is not

package/dist/src/discover/skills.d.ts

@@ -12,7 +12,7 @@ export declare const DISCOVER_SKILL_MARKDOWN_MISSING = "discover/skill-markdown-
 /**
  * Input for discovering authored skills.
  */
-export interface DiscoverSkillsInput {
+interface DiscoverSkillsInput {
     agentRoot: string;
     /**
      * Optional {@link ProjectSource} used for all filesystem reads. Defaults to
@@ -25,7 +25,7 @@ export interface DiscoverSkillsInput {
 /**
  * Result of discovering authored skills.
  */
-export interface DiscoverSkillsResult {
+interface DiscoverSkillsResult {
     diagnostics: DiscoverDiagnostic[];
     skills: SkillSourceRef[];
 }
@@ -35,3 +35,4 @@ export interface DiscoverSkillsResult {
  * entries or Agent Skills packages rooted at `skills/<name>/SKILL.md`.
  */
 export declare function discoverSkills(input: DiscoverSkillsInput): Promise<DiscoverSkillsResult>;
+export {};

package/dist/src/discover/skills.js

@@ -1,5 +1,5 @@
 import { join, relative, resolve } from "node:path";
-import { lowerSkillMarkdown } from "#public/helpers/markdown.js";
+import { lowerSkillMarkdown } from "#internal/helpers/markdown.js";
 import { toErrorMessage } from "#shared/errors.js";
 import { createDiscoverErrorDiagnostic } from "#discover/diagnostics.js";
 import { classifySkillPackageEntry, classifySkillsDirectoryEntry, getDirectoryEntryType, getSupportedModuleBaseName, normalizeLogicalPath, } from "#discover/filesystem.js";