@cuylabs/agent-core 4.9.0 → 5.0.0

package/dist/skill/types.d.ts

@@ -0,0 +1,291 @@
+/**
+ * Skill System Types
+ *
+ * Skills are modular, on-demand knowledge packs that extend an agent's
+ * capabilities with specialized instructions, workflows, and resources.
+ *
+ * Design principles:
+ *
+ * 1. **Progressive disclosure** — summaries always in context,
+ *    full content loaded only when needed. Minimizes baseline token cost.
+ *
+ * 2. **Scoped priority** — project skills override user skills
+ *    override global skills. Closest scope wins on name collision.
+ *
+ * 3. **Agent-initiated loading** — the agent decides when to
+ *    activate a skill by calling the `skill` tool. No guesswork.
+ *
+ * 4. **Bundled resources** — skills can ship scripts,
+ *    references, assets, and examples alongside instructions.
+ *
+ * 5. **Remote sources** — skills can be fetched from URLs,
+ *    enabling shared skill repositories across teams.
+ *
+ * The lifecycle:
+ *
+ *   Discovery → Registry → Summary injection → Agent tool call → Full load
+ *
+ * @packageDocumentation
+ */
+/**
+ * Where a skill was discovered, determining its override priority.
+ *
+ * When two skills share the same name, the narrower scope wins:
+ *   project > user > global > builtin
+ *
+ * Uses a 4-tier hierarchy with names that are intuitive for
+ * library consumers.
+ */
+export type SkillScope = "project" | "user" | "global" | "builtin";
+/**
+ * How a skill was obtained — local filesystem or remote URL.
+ */
+export type SkillSourceType = "local" | "remote";
+/**
+ * Where a skill came from, for provenance tracking.
+ */
+export interface SkillSource {
+    /** Local or remote origin */
+    type: SkillSourceType;
+    /** Root directory or URL this skill was discovered under */
+    root: string;
+}
+/**
+ * Classification of bundled resources within a skill directory.
+ *
+ * Resource taxonomy:
+ * - `script`    — executable code for deterministic tasks (can be run without reading)
+ * - `reference` — documentation loaded into context on demand
+ * - `asset`     — templates, images, fonts used in output (not read into context)
+ * - `example`   — working code samples for the agent to learn from
+ */
+export type SkillResourceType = "script" | "reference" | "asset" | "example";
+/**
+ * A file bundled with a skill.
+ *
+ * Resources are discovered but NOT loaded into memory until the agent
+ * explicitly requests them. This is the L3 layer of progressive disclosure.
+ */
+export interface SkillResource {
+    /** Path relative to the skill's base directory */
+    relativePath: string;
+    /** Classified resource type */
+    type: SkillResourceType;
+    /**
+     * Absolute path on disk.
+     *
+     * Undefined for pack-contributed resources that carry inline content.
+     * Either `absolutePath` or `content` must be set.
+     */
+    absolutePath?: string;
+    /**
+     * Inline resource content.
+     *
+     * Set for pack-contributed resources that have no file on disk.
+     * Takes precedence over `absolutePath` when both are present.
+     */
+    content?: string;
+}
+/**
+ * Lightweight skill metadata parsed from SKILL.md YAML frontmatter.
+ *
+ * This is the **L1 layer** — always present in the system prompt so the
+ * agent knows which skills exist. Kept intentionally small (~100 words each)
+ * to minimize baseline context cost.
+ *
+ * Uses YAML frontmatter in a SKILL.md file — the widely-adopted
+ * canonical format for skill definitions.
+ */
+export interface SkillMetadata {
+    /** Unique skill identifier (from frontmatter `name`) */
+    name: string;
+    /**
+     * When to use this skill — the single most important field.
+     *
+     * This description is what the agent reads to decide whether to
+     * activate the skill. Should contain trigger phrases that match
+     * task types. Written for another LLM to consume, not humans.
+     */
+    description: string;
+    /** Semantic version (from frontmatter, optional) */
+    version?: string;
+    /** Scope that determines override priority */
+    scope: SkillScope;
+    /** How this skill was obtained */
+    source: SkillSource;
+    /**
+     * Absolute path to the SKILL.md file.
+     *
+     * Undefined for pack-contributed skills that have no file on disk.
+     * When undefined, content must be pre-cached — use `SkillRegistry.register()`
+     * with a pre-built `SkillContent`.
+     */
+    filePath?: string;
+    /**
+     * Directory containing the skill (parent of SKILL.md).
+     *
+     * Undefined for pack-contributed skills with no file on disk.
+     */
+    baseDir?: string;
+    /** Optional tags for categorization */
+    tags?: string[];
+    /**
+     * Names of skills this skill depends on.
+     * When this skill is loaded, its dependencies are suggested to be loaded too.
+     */
+    dependencies?: string[];
+}
+/**
+ * Full skill content including the markdown body and resource listing.
+ *
+ * This is the **L2 layer** — loaded only when the agent calls the skill
+ * tool. Contains the actual instructions plus awareness of bundled resources.
+ */
+export interface SkillContent extends SkillMetadata {
+    /**
+     * The full markdown body of SKILL.md (everything below the frontmatter).
+     * This is the core instructional content injected into the conversation.
+     */
+    body: string;
+    /**
+     * Bundled resources discovered in the skill directory.
+     * Listed so the agent knows what's available but not yet loaded.
+     */
+    resources: SkillResource[];
+}
+/**
+ * Configuration for skill discovery and loading.
+ *
+ * Controls where skills are found, how deep to scan, and which
+ * external conventions to support.
+ *
+ * @example
+ * ```typescript
+ * const skillConfig: SkillConfig = {
+ *   // Scan standard locations
+ *   externalDirs: [".agents", ".claude"],
+ *   // Add custom skill roots
+ *   roots: ["./company-skills"],
+ *   // Limit scan depth for performance
+ *   maxScanDepth: 4,
+ * };
+ * ```
+ */
+export interface SkillConfig {
+    /**
+     * Additional directories to scan for skills (absolute or relative to cwd).
+     * Each directory is scanned recursively for SKILL.md files.
+     */
+    roots?: string[];
+    /**
+     * External skill directory names to scan in project and home directories.
+     *
+     * These are checked as `<project>/<dir>/skills/` and `~/<dir>/skills/`.
+     * Supports `.claude` and `.agents` directory conventions.
+     *
+     * @default [".agents", ".claude"]
+     */
+    externalDirs?: string[];
+    /**
+     * Maximum directory depth to scan within each root.
+     * Higher values find more deeply nested skills but take longer.
+     *
+     * @default 4
+     */
+    maxScanDepth?: number;
+    /**
+     * Maximum file size for SKILL.md files in bytes.
+     * Skills larger than this are skipped with a warning.
+     *
+     * @default 102400 (100KB)
+     */
+    maxFileSize?: number;
+    /**
+     * Enable fetching skills from remote URLs.
+     * When false, `remoteUrls` is ignored.
+     *
+     * @default false
+     */
+    enableRemote?: boolean;
+    /**
+     * Remote skill index URLs to fetch.
+     *
+     * Each URL should serve a JSON index listing available skills.
+     * See `RemoteSkillIndex` for the expected format.
+     *
+     * @example
+     * ```typescript
+     * remoteUrls: ["https://skills.example.com/index.json"]
+     * ```
+     */
+    remoteUrls?: string[];
+    /**
+     * Cache directory for remote skills.
+     * Defaults to `~/.cache/cuylabs/skills/`.
+     */
+    remoteCacheDir?: string;
+    /**
+     * Include built-in skills bundled with agent-core.
+     * Currently reserved for future use.
+     *
+     * @default true
+     */
+    includeBuiltin?: boolean;
+}
+/**
+ * Schema for remote skill index JSON files.
+ *
+ * Hosted at a URL like `https://skills.example.com/index.json`.
+ * Enables team-wide or organization-wide skill sharing.
+ *
+ * @example
+ * ```json
+ * {
+ *   "version": 1,
+ *   "skills": [
+ *     {
+ *       "name": "testing",
+ *       "files": ["SKILL.md", "scripts/run-tests.sh", "references/patterns.md"]
+ *     }
+ *   ]
+ * }
+ * ```
+ */
+export interface RemoteSkillIndex {
+    /** Schema version (currently 1) */
+    version: number;
+    /** List of available skills */
+    skills: RemoteSkillEntry[];
+}
+/**
+ * A single skill listing in a remote index.
+ */
+export interface RemoteSkillEntry {
+    /** Skill name (must match the `name` in SKILL.md frontmatter) */
+    name: string;
+    /** Relative file paths to download (SKILL.md is required) */
+    files: string[];
+}
+/**
+ * Result of a full skill discovery pass.
+ */
+export interface SkillDiscoveryResult {
+    /** All discovered skills (deduplicated, scope-prioritized) */
+    skills: SkillMetadata[];
+    /** Skills that failed to load with reasons */
+    errors: SkillDiscoveryError[];
+    /** Total directories scanned */
+    dirsScanned: number;
+    /** Discovery duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * An error encountered during skill discovery.
+ */
+export interface SkillDiscoveryError {
+    /** Path that caused the error */
+    path: string;
+    /** What went wrong */
+    reason: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skill/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skill/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,IAAI,EAAE,iBAAiB,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,8CAA8C;IAC9C,KAAK,EAAE,UAAU,CAAC;IAElB,kCAAkC;IAClC,MAAM,EAAE,WAAW,CAAC;IAEpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,8CAA8C;IAC9C,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/subagents/index.d.ts

@@ -1,179 +1,8 @@
-import { a_ as DispatchRole, aZ as DispatchResult, bz as LocalDispatchRuntimeOptions, C as Agent, T as Tool, a$ as DispatchRuntime, cb as Profile } from '../instance-Bg61WSyz.js';
-import '../types-C_LCeYNg.js';
-import 'ai';
-import '../types-RSCv7nQ4.js';
-import 'zod';
-import '../types-CQaXbRsS.js';
-import '../types-DMjoFKKv.js';
-import '@modelcontextprotocol/sdk/client/auth.js';
-import '@modelcontextprotocol/sdk/types.js';
-import '@ai-sdk/provider-utils';
-import '../sandbox/index.js';
-import '../llm-error-D93FNNLY.js';
-
-/**
- * Subagent types.
- *
- * Subagents are the model-facing tool surface built on top of the local
- * dispatch runtime.
- *
- * @packageDocumentation
- */
-
-type SubAgentRole = DispatchRole;
-interface SubAgentCompletedResult extends DispatchResult {
-    sessionId: string;
-}
-interface SubAgentConfig extends Omit<LocalDispatchRuntimeOptions, "parent" | "childToolIds" | "createChildTools"> {
-    async?: boolean;
-}
-type SubAgentToolsOptions = SubAgentConfig;
-declare const DEFAULT_SUBAGENT_CONCURRENCY = 6;
-declare const DEFAULT_SUBAGENT_DEPTH = 2;
-declare const DEFAULT_SUBAGENT_SESSION_PREFIX = "Subagent";
-
-/**
- * Subagent tools.
- *
- * Provides `invoke_agent`, `wait_agent`, and `close_agent` backed by the
- * local in-process dispatch runtime.
- *
- * @packageDocumentation
- */
-
-declare function createSubAgentTools(parent: Agent, options: SubAgentToolsOptions): Tool.AnyInfo[];
-
-declare const SUBAGENT_TOOL_IDS: readonly ["invoke_agent", "wait_agent", "close_agent"];
-declare function createInvokeAgentTool(runtime: DispatchRuntime, roles: readonly SubAgentRole[], options?: {
-    async?: boolean;
-    sessionTitlePrefix?: string;
-}): Tool.AnyInfo;
-declare function createWaitAgentTool(runtime: DispatchRuntime): Tool.AnyInfo;
-declare function createCloseAgentTool(runtime: DispatchRuntime): Tool.AnyInfo;
-
-declare function formatInvalidAgentTypeResult(roleName: string, validNames: string[]): Tool.ExecuteResult;
-declare function formatSpawnBlockedResult(message: string): Tool.ExecuteResult;
-declare function formatSyncSubAgentResult(roleName: string, result: SubAgentCompletedResult): Tool.ExecuteResult;
-declare function formatSyncSubAgentErrorResult(roleName: string, error: unknown): Tool.ExecuteResult;
-declare function formatAsyncSpawnedResult(agentId: string, roleName: string, sessionId?: string): Tool.ExecuteResult;
-declare function formatWaitResult(agentId: string, roleName: string, result: SubAgentCompletedResult): Tool.ExecuteResult;
-declare function formatWaitTimeoutResult(timeoutMs: number, runningIds: string[]): Tool.ExecuteResult;
-declare function formatWaitErrorResult(error: unknown): Tool.ExecuteResult;
-declare function formatMissingAgentsResult(ids: string[]): Tool.ExecuteResult;
-declare function formatCloseMissingAgentResult(id: string): Tool.ExecuteResult;
-declare function formatCloseAlreadyResolvedResult(id: string, state: string): Tool.ExecuteResult;
-declare function formatCancelledAgentResult(id: string, roleName: string): Tool.ExecuteResult;
-
-declare const LOCAL_SUBAGENT_BACKEND = "@cuylabs/agent-core/local";
-interface SubAgentInstallTarget {
-    addTool(tool: Tool.Info): void;
-    removeTool(toolId: string): boolean;
-}
-declare function configureSubAgents(agent: object, config: SubAgentConfig): SubAgentConfig;
-declare function getConfiguredSubAgents(agent: object): SubAgentConfig | undefined;
-declare function getInstalledSubAgentBackend(agent: object): string | undefined;
-declare function clearInstalledSubAgents(agent: SubAgentInstallTarget & object): void;
-declare function installSubAgentTools(options: {
-    agent: SubAgentInstallTarget & object;
-    config: SubAgentConfig;
-    backend: string;
-    tools: readonly Tool.AnyInfo[];
-}): readonly Tool.AnyInfo[];
-declare function installLocalSubAgents(agent: SubAgentInstallTarget & object, config?: SubAgentConfig): readonly Tool.AnyInfo[];
-
-/**
- * Markdown subagent role parser.
- *
- * Parses `.md` files into `SubAgentRole` objects using a hybrid approach:
- * frontmatter maps to role config, and the body becomes the system prompt.
- *
- * @packageDocumentation
- */
-
-interface MarkdownSubAgentRoleFrontmatter {
-    name: string;
-    description: string;
-    profile?: string;
-    extends?: string;
-    model?: string;
-    maxSteps?: string;
-    temperature?: string;
-    reasoning?: string;
-    tools?: string;
-    skills?: string;
-    allowFurtherDispatch?: string;
-}
-interface ParsedMarkdownSubAgentRole {
-    frontmatter: MarkdownSubAgentRoleFrontmatter;
-    body: string;
-    filePath: string;
-}
-type ToolModifier = {
-    kind: "add";
-    pattern: string;
-} | {
-    kind: "remove";
-    pattern: string;
-};
-type ParsedToolSpec = {
-    mode: "explicit";
-    patterns: string[];
-} | {
-    mode: "modifiers";
-    modifiers: ToolModifier[];
-} | {
-    mode: "inherit";
-};
-interface SubAgentRoleResolvers {
-    resolveProfile?: (name: string) => Profile | undefined;
-    resolveParent?: (name: string) => SubAgentRole | undefined;
-}
-declare function parseSubAgentRoleFrontmatter(raw: string): Record<string, string>;
-declare function parseMarkdownSubAgentRole(content: string, filePath: string): ParsedMarkdownSubAgentRole | null;
-declare function parseSubAgentToolSpec(raw?: string): ParsedToolSpec;
-declare function toSubAgentRole(parsed: ParsedMarkdownSubAgentRole, resolvers?: SubAgentRoleResolvers): SubAgentRole;
-interface MarkdownSubAgentRole extends SubAgentRole {
-    _modelId?: string;
-    _skillNames?: string[];
-    _source?: string;
-}
-declare function isMarkdownSubAgentRole(role: SubAgentRole): role is MarkdownSubAgentRole;
-type ParsedSubAgentToolSpec = ParsedToolSpec;
-type SubAgentToolModifier = ToolModifier;
-
-/**
- * Subagent role discovery.
- *
- * Discovers subagent roles from markdown files across multiple locations
- * and merges them with built-in TypeScript roles.
- *
- * @packageDocumentation
- */
-
-type SubAgentRoleSource = "builtin" | "user" | "project" | "config";
-interface DiscoveredSubAgentRole {
-    role: SubAgentRole;
-    source: SubAgentRoleSource;
-    filePath?: string;
-}
-interface SubAgentRoleDiscoveryOptions {
-    cwd: string;
-    userDir?: string;
-    projectDir?: string;
-    configPaths?: string[];
-    builtInRoles?: SubAgentRole[];
-    resolveProfile?: (name: string) => Profile | undefined;
-}
-interface SubAgentRoleDiscoveryResult {
-    roles: SubAgentRole[];
-    discovered: DiscoveredSubAgentRole[];
-    errors: Array<{
-        path: string;
-        error: string;
-    }>;
-}
-declare function getUserSubAgentRolesDir(userDir?: string): string;
-declare function getProjectSubAgentRolesDir(cwd: string, projectDir?: string): string;
-declare function discoverSubAgentRoles(options: SubAgentRoleDiscoveryOptions): SubAgentRoleDiscoveryResult;
-
-export { DEFAULT_SUBAGENT_CONCURRENCY, DEFAULT_SUBAGENT_DEPTH, DEFAULT_SUBAGENT_SESSION_PREFIX, type DiscoveredSubAgentRole, LOCAL_SUBAGENT_BACKEND, type MarkdownSubAgentRole, type MarkdownSubAgentRoleFrontmatter, type ParsedMarkdownSubAgentRole, type ParsedSubAgentToolSpec, SUBAGENT_TOOL_IDS, type SubAgentCompletedResult, type SubAgentConfig, type SubAgentRole, type SubAgentRoleDiscoveryOptions, type SubAgentRoleDiscoveryResult, type SubAgentRoleResolvers, type SubAgentRoleSource, type SubAgentToolModifier, type SubAgentToolsOptions, clearInstalledSubAgents, configureSubAgents, createCloseAgentTool, createInvokeAgentTool, createSubAgentTools, createWaitAgentTool, discoverSubAgentRoles, formatAsyncSpawnedResult, formatCancelledAgentResult, formatCloseAlreadyResolvedResult, formatCloseMissingAgentResult, formatInvalidAgentTypeResult, formatMissingAgentsResult, formatSpawnBlockedResult, formatSyncSubAgentErrorResult, formatSyncSubAgentResult, formatWaitErrorResult, formatWaitResult, formatWaitTimeoutResult, getConfiguredSubAgents, getInstalledSubAgentBackend, getProjectSubAgentRolesDir, getUserSubAgentRolesDir, installLocalSubAgents, installSubAgentTools, isMarkdownSubAgentRole, parseMarkdownSubAgentRole, parseSubAgentRoleFrontmatter, parseSubAgentToolSpec, toSubAgentRole };
+export type { SubAgentCompletedResult, SubAgentConfig, SubAgentRole, SubAgentToolsOptions, } from "./types.js";
+export { DEFAULT_SUBAGENT_CONCURRENCY, DEFAULT_SUBAGENT_DEPTH, DEFAULT_SUBAGENT_SESSION_PREFIX, } from "./types.js";
+export { createSubAgentTools } from "./tools.js";
+export { createCloseAgentTool, createInvokeAgentTool, createWaitAgentTool, SUBAGENT_TOOL_IDS, } from "./tool-factories.js";
+export { formatAsyncSpawnedResult, formatCancelledAgentResult, formatCloseAlreadyResolvedResult, formatCloseMissingAgentResult, formatInvalidAgentTypeResult, formatMissingAgentsResult, formatSpawnBlockedResult, formatSyncSubAgentErrorResult, formatSyncSubAgentResult, formatWaitErrorResult, formatWaitResult, formatWaitTimeoutResult, } from "./results.js";
+export { clearInstalledSubAgents, configureSubAgents, getConfiguredSubAgents, getInstalledSubAgentBackend, installLocalSubAgents, installSubAgentTools, LOCAL_SUBAGENT_BACKEND, } from "./installation.js";
+export * from "./roles/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/subagents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/subagents/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,gCAAgC,EAChC,6BAA6B,EAC7B,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}

package/dist/subagents/index.js

@@ -34,11 +34,12 @@ import {
   parseSubAgentRoleFrontmatter,
   parseSubAgentToolSpec,
   toSubAgentRole
-} from "../chunk-BJC46FIF.js";
+} from "../chunk-BKHWKKSG.js";
 import "../chunk-TPZ37IWI.js";
-import "../chunk-HSUPTXNV.js";
-import "../chunk-Q742PSH3.js";
-import "../chunk-H3GRHFFG.js";
+import "../chunk-556CPZ3J.js";
+import "../chunk-EDKZOPUV.js";
+import "../chunk-MJML3A2F.js";
+import "../chunk-CGP6UNCQ.js";
 export {
   DEFAULT_SUBAGENT_CONCURRENCY,
   DEFAULT_SUBAGENT_DEPTH,

package/dist/subagents/installation.d.ts

@@ -0,0 +1,23 @@
+import type { Tool } from "../tool/tool.js";
+import type { SubAgentConfig } from "./types.js";
+export declare const LOCAL_SUBAGENT_BACKEND = "@cuylabs/agent-core/local";
+export interface InstalledSubAgentBackend {
+    config: SubAgentConfig;
+    backend: string;
+}
+export interface SubAgentInstallTarget {
+    addTool(tool: Tool.Info): void;
+    removeTool(toolId: string): boolean;
+}
+export declare function configureSubAgents(agent: object, config: SubAgentConfig): SubAgentConfig;
+export declare function getConfiguredSubAgents(agent: object): SubAgentConfig | undefined;
+export declare function getInstalledSubAgentBackend(agent: object): string | undefined;
+export declare function clearInstalledSubAgents(agent: SubAgentInstallTarget & object): void;
+export declare function installSubAgentTools(options: {
+    agent: SubAgentInstallTarget & object;
+    config: SubAgentConfig;
+    backend: string;
+    tools: readonly Tool.AnyInfo[];
+}): readonly Tool.AnyInfo[];
+export declare function installLocalSubAgents(agent: SubAgentInstallTarget & object, config?: SubAgentConfig): readonly Tool.AnyInfo[];
+//# sourceMappingURL=installation.d.ts.map

package/dist/subagents/installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../src/subagents/installation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAElE,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC;AAgBD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,GACrB,cAAc,CAShB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,SAAS,CAE5B;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK7E;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,qBAAqB,GAAG,MAAM,GACpC,IAAI,CAKN;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC;IACtC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;CAChC,GAAG,SAAS,IAAI,CAAC,OAAO,EAAE,CAgB1B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,GAAG,MAAM,EACrC,MAAM,CAAC,EAAE,cAAc,GACtB,SAAS,IAAI,CAAC,OAAO,EAAE,CAazB"}

package/dist/subagents/results.d.ts

@@ -0,0 +1,15 @@
+import type { Tool } from "../tool/tool.js";
+import type { SubAgentCompletedResult } from "./types.js";
+export declare function formatInvalidAgentTypeResult(roleName: string, validNames: string[]): Tool.ExecuteResult;
+export declare function formatSpawnBlockedResult(message: string): Tool.ExecuteResult;
+export declare function formatSyncSubAgentResult(roleName: string, result: SubAgentCompletedResult): Tool.ExecuteResult;
+export declare function formatSyncSubAgentErrorResult(roleName: string, error: unknown): Tool.ExecuteResult;
+export declare function formatAsyncSpawnedResult(agentId: string, roleName: string, sessionId?: string): Tool.ExecuteResult;
+export declare function formatWaitResult(agentId: string, roleName: string, result: SubAgentCompletedResult): Tool.ExecuteResult;
+export declare function formatWaitTimeoutResult(timeoutMs: number, runningIds: string[]): Tool.ExecuteResult;
+export declare function formatWaitErrorResult(error: unknown): Tool.ExecuteResult;
+export declare function formatMissingAgentsResult(ids: string[]): Tool.ExecuteResult;
+export declare function formatCloseMissingAgentResult(id: string): Tool.ExecuteResult;
+export declare function formatCloseAlreadyResolvedResult(id: string, state: string): Tool.ExecuteResult;
+export declare function formatCancelledAgentResult(id: string, roleName: string): Tool.ExecuteResult;
+//# sourceMappingURL=results.d.ts.map

package/dist/subagents/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/subagents/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAc1D,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAAE,GACnB,IAAI,CAAC,aAAa,CAQpB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,CAM5E;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAAC,aAAa,CAepB;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,IAAI,CAAC,aAAa,CASpB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAAC,aAAa,CAWpB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAAC,aAAa,CAgBpB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAAE,GACnB,IAAI,CAAC,aAAa,CAUpB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC,aAAa,CAMxE;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAM3E;AAED,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,CAM5E;AAED,wBAAgB,gCAAgC,CAC9C,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC,aAAa,CAMpB;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,GACf,IAAI,CAAC,aAAa,CAMpB"}

package/dist/subagents/roles/discovery.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Subagent role discovery.
+ *
+ * Discovers subagent roles from markdown files across multiple locations
+ * and merges them with built-in TypeScript roles.
+ *
+ * @packageDocumentation
+ */
+import type { Profile } from "../../profiles/types.js";
+import type { SubAgentRole } from "../types.js";
+import { type MarkdownSubAgentRole, type SubAgentRoleResolvers } from "./markdown-profile.js";
+export type SubAgentRoleSource = "builtin" | "user" | "project" | "config";
+export interface DiscoveredSubAgentRole {
+    role: SubAgentRole;
+    source: SubAgentRoleSource;
+    filePath?: string;
+}
+export interface SubAgentRoleDiscoveryOptions {
+    cwd: string;
+    userDir?: string;
+    projectDir?: string;
+    configPaths?: string[];
+    builtInRoles?: SubAgentRole[];
+    resolveProfile?: (name: string) => Profile | undefined;
+}
+export interface SubAgentRoleDiscoveryResult {
+    roles: SubAgentRole[];
+    discovered: DiscoveredSubAgentRole[];
+    errors: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+export declare function getUserSubAgentRolesDir(userDir?: string): string;
+export declare function getProjectSubAgentRolesDir(cwd: string, projectDir?: string): string;
+export declare function discoverSubAgentRoles(options: SubAgentRoleDiscoveryOptions): SubAgentRoleDiscoveryResult;
+export type { MarkdownSubAgentRole, SubAgentRoleResolvers };
+//# sourceMappingURL=discovery.d.ts.map

package/dist/subagents/roles/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/subagents/roles/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AA0HD,wBAAgB,uBAAuB,CAAC,OAAO,SAAmB,GAAG,MAAM,CAE1E;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,UAAU,SAAsB,GAC/B,MAAM,CAER;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CAyD7B;AAED,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/subagents/roles/index.d.ts

@@ -0,0 +1,5 @@
+export { discoverSubAgentRoles, getProjectSubAgentRolesDir, getUserSubAgentRolesDir, } from "./discovery.js";
+export type { DiscoveredSubAgentRole, SubAgentRoleDiscoveryOptions, SubAgentRoleDiscoveryResult, SubAgentRoleSource, } from "./discovery.js";
+export { isMarkdownSubAgentRole, parseMarkdownSubAgentRole, parseSubAgentRoleFrontmatter, parseSubAgentToolSpec, toSubAgentRole, } from "./markdown-profile.js";
+export type { MarkdownSubAgentRole, MarkdownSubAgentRoleFrontmatter, ParsedMarkdownSubAgentRole, ParsedSubAgentToolSpec, SubAgentRoleResolvers, SubAgentToolModifier, } from "./markdown-profile.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/subagents/roles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/subagents/roles/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,EACrB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,oBAAoB,EACpB,+BAA+B,EAC/B,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/subagents/roles/markdown-profile.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Markdown subagent role parser.
+ *
+ * Parses `.md` files into `SubAgentRole` objects using a hybrid approach:
+ * frontmatter maps to role config, and the body becomes the system prompt.
+ *
+ * @packageDocumentation
+ */
+import type { Profile } from "../../profiles/types.js";
+import type { SubAgentRole } from "../types.js";
+export interface MarkdownSubAgentRoleFrontmatter {
+    name: string;
+    description: string;
+    profile?: string;
+    extends?: string;
+    model?: string;
+    maxSteps?: string;
+    temperature?: string;
+    reasoning?: string;
+    tools?: string;
+    skills?: string;
+    allowFurtherDispatch?: string;
+}
+export interface ParsedMarkdownSubAgentRole {
+    frontmatter: MarkdownSubAgentRoleFrontmatter;
+    body: string;
+    filePath: string;
+}
+export type ToolModifier = {
+    kind: "add";
+    pattern: string;
+} | {
+    kind: "remove";
+    pattern: string;
+};
+export type ParsedToolSpec = {
+    mode: "explicit";
+    patterns: string[];
+} | {
+    mode: "modifiers";
+    modifiers: ToolModifier[];
+} | {
+    mode: "inherit";
+};
+export interface SubAgentRoleResolvers {
+    resolveProfile?: (name: string) => Profile | undefined;
+    resolveParent?: (name: string) => SubAgentRole | undefined;
+}
+export declare function parseSubAgentRoleFrontmatter(raw: string): Record<string, string>;
+export declare function parseMarkdownSubAgentRole(content: string, filePath: string): ParsedMarkdownSubAgentRole | null;
+export declare function parseSubAgentToolSpec(raw?: string): ParsedToolSpec;
+export declare function toSubAgentRole(parsed: ParsedMarkdownSubAgentRole, resolvers?: SubAgentRoleResolvers): SubAgentRole;
+export interface MarkdownSubAgentRole extends SubAgentRole {
+    _modelId?: string;
+    _skillNames?: string[];
+    _source?: string;
+}
+export declare function isMarkdownSubAgentRole(role: SubAgentRole): role is MarkdownSubAgentRole;
+export type ParsedSubAgentToolSpec = ParsedToolSpec;
+export type SubAgentToolModifier = ToolModifier;
+//# sourceMappingURL=markdown-profile.d.ts.map