@soleri/core 9.5.0 → 9.7.0

package/dist/session/policy-resolver.js

@@ -0,0 +1,28 @@
+/**
+ * Policy Resolver — three-level merge for compaction policies.
+ *
+ * Merge order (highest to lowest priority):
+ *   1. Agent config (agent.yaml → engine.compactionPolicy)
+ *   2. Adapter defaults (runtime adapter may provide defaults)
+ *   3. Engine defaults (hardcoded fallback)
+ *
+ * Individual fields override — not whole-object replacement.
+ */
+import { ENGINE_DEFAULTS } from './compaction-policy.js';
+/**
+ * Resolve a final CompactionPolicy by merging three levels.
+ *
+ * Each level can provide partial overrides. Fields from higher-priority
+ * levels win over lower-priority ones. Missing fields fall through to
+ * the next level, bottoming out at ENGINE_DEFAULTS.
+ */
+export function resolvePolicy(agentConfig, adapterDefaults) {
+    return {
+        maxRuns: agentConfig?.maxRuns ?? adapterDefaults?.maxRuns ?? ENGINE_DEFAULTS.maxRuns,
+        maxInputTokens: agentConfig?.maxInputTokens ??
+            adapterDefaults?.maxInputTokens ??
+            ENGINE_DEFAULTS.maxInputTokens,
+        maxAge: agentConfig?.maxAge ?? adapterDefaults?.maxAge ?? ENGINE_DEFAULTS.maxAge,
+    };
+}
+//# sourceMappingURL=policy-resolver.js.map

package/dist/session/policy-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-resolver.js","sourceRoot":"","sources":["../../src/session/policy-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAuC,EACvC,eAA2C;IAE3C,OAAO;QACL,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,eAAe,EAAE,OAAO,IAAI,eAAe,CAAC,OAAO;QACpF,cAAc,EACZ,WAAW,EAAE,cAAc;YAC3B,eAAe,EAAE,cAAc;YAC/B,eAAe,CAAC,cAAc;QAChC,MAAM,EAAE,WAAW,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,IAAI,eAAe,CAAC,MAAM;KACjF,CAAC;AACJ,CAAC"}

package/dist/skills/sync-skills.d.ts

@@ -5,9 +5,12 @@
  * Injects agent branding so users know which agent owns the skill.
  * Called automatically at engine startup and by admin_setup_global.
  */
+import type { SkillMetadata } from '../packs/types.js';
 export interface SkillEntry {
     name: string;
     sourcePath: string;
+    /** Trust and source metadata (populated during classification) */
+    metadata?: SkillMetadata;
 }
 export interface SyncResult {
     installed: string[];
@@ -15,6 +18,13 @@ export interface SyncResult {
     skipped: string[];
     failed: string[];
 }
+/** Error thrown when a skill requires approval due to scripts trust level */
+export declare class ApprovalRequiredError extends Error {
+    readonly skillName: string;
+    readonly trust: 'scripts';
+    readonly inventory: SkillMetadata['inventory'];
+    constructor(skillName: string, inventory: SkillMetadata['inventory']);
+}
 /** Discover skill files (SKILL.md) in skills directories */
 export declare function discoverSkills(skillsDirs: string[]): SkillEntry[];
 /**
@@ -24,4 +34,21 @@ export declare function discoverSkills(skillsDirs: string[]): SkillEntry[];
  * - Missing source skills leave target untouched (other agents may own them)
  */
 export declare function syncSkillsToClaudeCode(skillsDirs: string[], agentName?: string): SyncResult;
+/**
+ * Check engine version compatibility for a skill.
+ * Returns 'compatible', 'unknown' (no version specified), or 'invalid'.
+ */
+export declare function checkSkillCompatibility(engineVersion?: string, currentVersion?: string): 'compatible' | 'unknown' | 'invalid';
+export interface ClassifySkillsOptions {
+    /** Current engine version for compatibility checking */
+    currentEngineVersion?: string;
+    /** Skills that have been explicitly approved for scripts trust level */
+    approvedScripts?: Set<string>;
+}
+/**
+ * Classify skills with trust levels and source tracking.
+ * Enriches SkillEntry[] with metadata. Throws ApprovalRequiredError
+ * for skills with 'scripts' trust unless explicitly approved.
+ */
+export declare function classifySkills(skills: SkillEntry[], options?: ClassifySkillsOptions): SkillEntry[];
 //# sourceMappingURL=sync-skills.d.ts.map

package/dist/skills/sync-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-skills.d.ts","sourceRoot":"","sources":["../../src/skills/sync-skills.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAgBjE;AAoBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAqC3F"}
+{"version":3,"file":"sync-skills.d.ts","sourceRoot":"","sources":["../../src/skills/sync-skills.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,mBAAmB,CAAC;AAInE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,6EAA6E;AAC7E,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;gBAEnC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC;CAarE;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAgBjE;AAoBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAqC3F;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,CAAC,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,YAAY,GAAG,SAAS,GAAG,SAAS,CAItC;AA+BD,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,qBAA0B,GAClC,UAAU,EAAE,CAwBd"}

package/dist/skills/sync-skills.js

@@ -6,8 +6,27 @@
  * Called automatically at engine startup and by admin_setup_global.
  */
 import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, statSync } from 'node:fs';
-import { join } from 'node:path';
+import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
+import { classifyTrust } from './trust-classifier.js';
+import { checkVersionCompat } from '../packs/resolver.js';
+/** Error thrown when a skill requires approval due to scripts trust level */
+export class ApprovalRequiredError extends Error {
+    skillName;
+    trust;
+    inventory;
+    constructor(skillName, inventory) {
+        super(`Skill "${skillName}" contains executable scripts and requires explicit approval. ` +
+            `Scripts found: ${inventory
+                .filter((i) => i.kind === 'script')
+                .map((i) => i.path)
+                .join(', ')}`);
+        this.name = 'ApprovalRequiredError';
+        this.skillName = skillName;
+        this.trust = 'scripts';
+        this.inventory = inventory;
+    }
+}
 /** Discover skill files (SKILL.md) in skills directories */
 export function discoverSkills(skillsDirs) {
     const skills = [];
@@ -84,4 +103,76 @@ export function syncSkillsToClaudeCode(skillsDirs, agentName) {
     }
     return result;
 }
+// =============================================================================
+// TRUST CLASSIFICATION & SOURCE TRACKING
+// =============================================================================
+/**
+ * Check engine version compatibility for a skill.
+ * Returns 'compatible', 'unknown' (no version specified), or 'invalid'.
+ */
+export function checkSkillCompatibility(engineVersion, currentVersion) {
+    if (!engineVersion)
+        return 'unknown';
+    if (!currentVersion)
+        return 'unknown';
+    return checkVersionCompat(currentVersion, engineVersion) ? 'compatible' : 'invalid';
+}
+/**
+ * Infer the source type for a skill based on its directory path.
+ */
+function inferSourceType(skillDir) {
+    if (skillDir.includes('node_modules'))
+        return 'npm';
+    if (skillDir.includes('.soleri') || skillDir.includes('.salvador'))
+        return 'builtin';
+    return 'local';
+}
+/**
+ * Read engine version from a skill's SKILL.md frontmatter.
+ * Looks for `engine:` or `engineVersion:` in YAML frontmatter.
+ */
+function readSkillEngineVersion(skillPath) {
+    try {
+        const content = readFileSync(skillPath, 'utf-8');
+        const fmStart = content.indexOf('---');
+        if (fmStart !== 0)
+            return undefined;
+        const fmEnd = content.indexOf('---', 3);
+        if (fmEnd === -1)
+            return undefined;
+        const fm = content.slice(3, fmEnd);
+        // eslint-disable-next-line no-control-regex
+        const match = fm.match(/^(?:engine|engineVersion)\s*:\s*["']?([^"'\n]+)["']?/m);
+        return match?.[1]?.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Classify skills with trust levels and source tracking.
+ * Enriches SkillEntry[] with metadata. Throws ApprovalRequiredError
+ * for skills with 'scripts' trust unless explicitly approved.
+ */
+export function classifySkills(skills, options = {}) {
+    return skills.map((skill) => {
+        const skillDir = dirname(skill.sourcePath);
+        const { trust, inventory } = classifyTrust(skillDir);
+        // Approval gate for scripts
+        if (trust === 'scripts' && !options.approvedScripts?.has(skill.name)) {
+            throw new ApprovalRequiredError(skill.name, inventory);
+        }
+        const engineVersion = readSkillEngineVersion(skill.sourcePath);
+        const sourceType = inferSourceType(skillDir);
+        const compatibility = checkSkillCompatibility(engineVersion, options.currentEngineVersion);
+        const metadata = {
+            trust,
+            source: { type: sourceType, uri: skillDir },
+            compatibility,
+            engineVersion,
+            inventory,
+        };
+        return { ...skill, metadata };
+    });
+}
 //# sourceMappingURL=sync-skills.js.map

package/dist/skills/sync-skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync-skills.js","sourceRoot":"","sources":["../../src/skills/sync-skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync-skills.js","sourceRoot":"","sources":["../../src/skills/sync-skills.ts"],"names":[],"mappings":"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"}

package/dist/skills/trust-classifier.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Trust Classifier — scans a skill directory and determines its trust level.
+ *
+ * Classification rules:
+ * - `.sh`, `.ts`, `.js` files (non-declaration) -> `scripts`
+ * - Non-`.md` files (images, JSON, etc.) -> `assets`
+ * - `.md` files only -> `markdown_only`
+ *
+ * Also builds a full inventory of all files with their classified kind.
+ */
+import type { TrustLevel, SkillInventoryItem } from '../packs/types.js';
+/**
+ * Classify a skill directory and return its trust level and inventory.
+ *
+ * @param dirPath - Absolute path to the skill directory
+ * @returns Trust level and full file inventory
+ */
+export declare function classifyTrust(dirPath: string): {
+    trust: TrustLevel;
+    inventory: SkillInventoryItem[];
+};
+/**
+ * Namespace object for backward compatibility and namespaced access.
+ * Delegates to standalone `classifyTrust` function.
+ */
+export declare const TrustClassifier: {
+    classify(dirPath: string): Promise<{
+        trust: TrustLevel;
+        inventory: SkillInventoryItem[];
+    }>;
+};
+//# sourceMappingURL=trust-classifier.d.ts.map

package/dist/skills/trust-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-classifier.d.ts","sourceRoot":"","sources":["../../src/skills/trust-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAWxE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAC9C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC,CAsBA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;sBACR,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC;CAG3F,CAAC"}

package/dist/skills/trust-classifier.js

@@ -0,0 +1,109 @@
+/**
+ * Trust Classifier — scans a skill directory and determines its trust level.
+ *
+ * Classification rules:
+ * - `.sh`, `.ts`, `.js` files (non-declaration) -> `scripts`
+ * - Non-`.md` files (images, JSON, etc.) -> `assets`
+ * - `.md` files only -> `markdown_only`
+ *
+ * Also builds a full inventory of all files with their classified kind.
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, extname, relative } from 'node:path';
+/** File extensions that indicate executable scripts */
+const SCRIPT_EXTENSIONS = new Set(['.sh', '.ts', '.js', '.mjs', '.cjs', '.py', '.rb', '.bash']);
+/** File extensions considered markdown/documentation */
+const MARKDOWN_EXTENSIONS = new Set(['.md', '.mdx']);
+/** File extensions for TypeScript declaration files (not executable) */
+const DECLARATION_PATTERN = /\.d\.[mc]?ts$/;
+/**
+ * Classify a skill directory and return its trust level and inventory.
+ *
+ * @param dirPath - Absolute path to the skill directory
+ * @returns Trust level and full file inventory
+ */
+export function classifyTrust(dirPath) {
+    if (!existsSync(dirPath)) {
+        return { trust: 'markdown_only', inventory: [] };
+    }
+    const inventory = [];
+    walkDir(dirPath, dirPath, inventory);
+    // Determine trust level from inventory
+    const hasScripts = inventory.some((item) => item.kind === 'script');
+    const hasAssets = inventory.some((item) => item.kind === 'asset');
+    let trust;
+    if (hasScripts) {
+        trust = 'scripts';
+    }
+    else if (hasAssets) {
+        trust = 'assets';
+    }
+    else {
+        trust = 'markdown_only';
+    }
+    return { trust, inventory };
+}
+/**
+ * Namespace object for backward compatibility and namespaced access.
+ * Delegates to standalone `classifyTrust` function.
+ */
+export const TrustClassifier = {
+    classify(dirPath) {
+        return Promise.resolve(classifyTrust(dirPath));
+    },
+};
+/** Recursively walk a directory and classify all files */
+function walkDir(rootDir, currentDir, inventory) {
+    let names;
+    try {
+        names = readdirSync(currentDir);
+    }
+    catch {
+        return;
+    }
+    for (const name of names) {
+        const fullPath = join(currentDir, name);
+        let stat;
+        try {
+            stat = statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            // Skip hidden directories and node_modules
+            if (name.startsWith('.') || name === 'node_modules')
+                continue;
+            walkDir(rootDir, fullPath, inventory);
+            continue;
+        }
+        if (!stat.isFile())
+            continue;
+        const relPath = relative(rootDir, fullPath);
+        const ext = extname(name).toLowerCase();
+        const kind = classifyFile(name, ext);
+        inventory.push({ path: relPath, kind });
+    }
+}
+/** Classify a single file by its extension and name */
+function classifyFile(fileName, ext) {
+    // SKILL.md is the primary skill definition
+    if (fileName === 'SKILL.md' || fileName === 'skill.md') {
+        return 'skill';
+    }
+    // Declaration files are not executable
+    if (DECLARATION_PATTERN.test(fileName)) {
+        return 'reference';
+    }
+    // Script files
+    if (SCRIPT_EXTENSIONS.has(ext)) {
+        return 'script';
+    }
+    // Markdown files are references
+    if (MARKDOWN_EXTENSIONS.has(ext)) {
+        return 'reference';
+    }
+    // Everything else is an asset
+    return 'asset';
+}
+//# sourceMappingURL=trust-classifier.js.map

package/dist/skills/trust-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-classifier.js","sourceRoot":"","sources":["../../src/skills/trust-classifier.ts"],"names":[],"mappings":"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"}

package/dist/subagent/concurrency-manager.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Per-agent-type semaphore for controlling concurrent subagent runs.
+ *
+ * Pure promise-based — zero external deps. FIFO ordering guarantees
+ * the first waiter is the first to acquire a slot when one frees up.
+ */
+export declare class ConcurrencyManager {
+    private state;
+    /**
+     * Acquire a concurrency slot for the given adapter type.
+     * Resolves immediately if a slot is available, otherwise queues
+     * and resolves when a slot frees up (FIFO).
+     */
+    acquire(type: string, maxConcurrent?: number): Promise<void>;
+    /**
+     * Release a concurrency slot for the given adapter type.
+     * If waiters exist, the first one (FIFO) is unblocked.
+     * No-op if the type is not tracked.
+     */
+    release(type: string): void;
+    /** Return the number of active slots for a type (0 if untracked). */
+    getActive(type: string): number;
+    /** Return the number of waiters queued for a type (0 if untracked). */
+    getWaiting(type: string): number;
+    /** Clear all state, resolving any pending waiters immediately. */
+    reset(): void;
+    private getOrCreate;
+}
+//# sourceMappingURL=concurrency-manager.d.ts.map

package/dist/subagent/concurrency-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency-manager.d.ts","sourceRoot":"","sources":["../../src/subagent/concurrency-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAqC;IAElD;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,GAAE,MAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1F;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAY3B,qEAAqE;IACrE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/B,uEAAuE;IACvE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,kEAAkE;IAClE,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,WAAW;CAQpB"}

package/dist/subagent/concurrency-manager.js

@@ -0,0 +1,73 @@
+/**
+ * Per-agent-type semaphore for controlling concurrent subagent runs.
+ *
+ * Pure promise-based — zero external deps. FIFO ordering guarantees
+ * the first waiter is the first to acquire a slot when one frees up.
+ */
+const DEFAULT_MAX_CONCURRENT = 3;
+export class ConcurrencyManager {
+    state = new Map();
+    /**
+     * Acquire a concurrency slot for the given adapter type.
+     * Resolves immediately if a slot is available, otherwise queues
+     * and resolves when a slot frees up (FIFO).
+     */
+    async acquire(type, maxConcurrent = DEFAULT_MAX_CONCURRENT) {
+        const entry = this.getOrCreate(type);
+        if (entry.active < maxConcurrent) {
+            entry.active++;
+            return;
+        }
+        // At capacity — park until a slot opens.
+        return new Promise((resolve) => {
+            entry.waiters.push(() => {
+                entry.active++;
+                resolve();
+            });
+        });
+    }
+    /**
+     * Release a concurrency slot for the given adapter type.
+     * If waiters exist, the first one (FIFO) is unblocked.
+     * No-op if the type is not tracked.
+     */
+    release(type) {
+        const entry = this.state.get(type);
+        if (!entry)
+            return;
+        entry.active = Math.max(0, entry.active - 1);
+        if (entry.waiters.length > 0) {
+            const next = entry.waiters.shift();
+            next();
+        }
+    }
+    /** Return the number of active slots for a type (0 if untracked). */
+    getActive(type) {
+        return this.state.get(type)?.active ?? 0;
+    }
+    /** Return the number of waiters queued for a type (0 if untracked). */
+    getWaiting(type) {
+        return this.state.get(type)?.waiters.length ?? 0;
+    }
+    /** Clear all state, resolving any pending waiters immediately. */
+    reset() {
+        for (const entry of this.state.values()) {
+            for (const waiter of entry.waiters) {
+                waiter();
+            }
+            entry.waiters.length = 0;
+            entry.active = 0;
+        }
+        this.state.clear();
+    }
+    // ── internal ──────────────────────────────────────────────────────
+    getOrCreate(type) {
+        let entry = this.state.get(type);
+        if (!entry) {
+            entry = { active: 0, waiters: [] };
+            this.state.set(type, entry);
+        }
+        return entry;
+    }
+}
+//# sourceMappingURL=concurrency-manager.js.map

package/dist/subagent/concurrency-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency-manager.js","sourceRoot":"","sources":["../../src/subagent/concurrency-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,MAAM,OAAO,kBAAkB;IACrB,KAAK,GAA2B,IAAI,GAAG,EAAE,CAAC;IAElD;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,gBAAwB,sBAAsB;QACxE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACjC,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,yCAAyC;QACzC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;gBACtB,KAAK,CAAC,MAAM,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAY;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE7C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAG,CAAC;YACpC,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,uEAAuE;IACvE,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,kEAAkE;IAClE,KAAK;QACH,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnC,MAAM,EAAE,CAAC;YACX,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACzB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,qEAAqE;IAE7D,WAAW,CAAC,IAAY;QAC9B,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/subagent/dispatcher.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SubagentDispatcher — the core orchestrator for subagent execution.
+ *
+ * Composes: TaskCheckout, WorkspaceResolver, ConcurrencyManager,
+ * OrphanReaper, and RuntimeAdapterRegistry to dispatch tasks to
+ * child agent processes.
+ */
+import type { RuntimeAdapterRegistry } from '../adapters/registry.js';
+import type { SubagentTask, SubagentResult, DispatchOptions, AggregatedResult } from './types.js';
+import type { GoalRepository } from '../planning/goal-ancestry.js';
+export interface SubagentDispatcherConfig {
+    /** RuntimeAdapterRegistry for looking up adapters by type */
+    adapterRegistry: RuntimeAdapterRegistry;
+    /** Base directory for git worktree isolation */
+    baseDir?: string;
+    /** Optional goal repository for injecting goal ancestry context */
+    goalRepository?: GoalRepository;
+}
+export declare class SubagentDispatcher {
+    private readonly checkout;
+    private readonly workspace;
+    private readonly concurrency;
+    private readonly reaper;
+    private readonly adapterRegistry;
+    private readonly goalAncestry?;
+    constructor(config: SubagentDispatcherConfig);
+    /**
+     * Dispatch one or more tasks to subagents.
+     *
+     * Tasks run in parallel by default (controlled by options.parallel).
+     * Each task goes through: claim → resolve workspace → acquire slot →
+     * execute via adapter → collect result.
+     */
+    dispatch(tasks: SubagentTask[], options?: DispatchOptions): Promise<AggregatedResult>;
+    /** Clean up all resources (worktrees, claims, concurrency) */
+    cleanup(): void;
+    /** Run orphan detection and cleanup */
+    reapOrphans(): SubagentResult[];
+    private dispatchParallel;
+    private executeTask;
+    /** Topological sort by dependencies (stable — preserves input order for equal deps) */
+    private resolveDependencies;
+    private getDefaultAdapterType;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/subagent/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/subagent/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EAEd,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,eAAe,EAAE,sBAAsB,CAAC;IACxC,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;gBAEjC,MAAM,EAAE,wBAAwB;IAa5C;;;;;;OAMG;IACG,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2C/F,8DAA8D;IAC9D,OAAO,IAAI,IAAI;IAOf,uCAAuC;IACvC,WAAW,IAAI,cAAc,EAAE;YAcjB,gBAAgB;YAuFhB,WAAW;IAuFzB,uFAAuF;IACvF,OAAO,CAAC,mBAAmB;IA6B3B,OAAO,CAAC,qBAAqB;CAO9B"}