@namzu/sdk 5.1.0 → 5.2.0

package/dist/directory/__tests__/supervisor-budget.test.js

@@ -0,0 +1,97 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { deriveSupervisorOptions } from '../derive-supervisor.js';
+import { loadDirectory } from '../load.js';
+/**
+ * `BaseAgentConfig` declares `tokenBudget` and `timeoutMs` as REQUIRED, and
+ * `deriveSupervisorOptions` supplied them only when `agent.ts` happened to
+ * name them — which is the uncommon case. An `as SupervisorAgentConfig` made
+ * that compile, so the returned object was typed `tokenBudget: number` while
+ * holding `undefined`.
+ *
+ * The consequence is not a type-level nicety. `buildLimitConfig` defaults only
+ * `maxIterations`, so an undefined budget and timeout disable BOTH hard stops
+ * — a project-derived supervisor ran with no token cap and no wall clock. And
+ * the child-spawn guard computes a delegate's allocation from the parent
+ * budget, so `undefined` became `NaN`, and `NaN <= 0` is false: the refusal
+ * that exists to stop an unfunded child let it through.
+ *
+ * The cast is now `satisfies`, which is what keeps this from recurring — but
+ * a type check is not a test, so the values are asserted here too.
+ */
+const provider = { id: 'mock', name: 'Mock' };
+const agentManager = { sendMessage: async () => ({}) };
+function tree(files) {
+    const root = mkdtempSync(join(tmpdir(), 'namzu-budget-'));
+    for (const [relative, body] of Object.entries(files)) {
+        const full = join(root, relative);
+        mkdirSync(join(full, '..'), { recursive: true });
+        writeFileSync(full, body);
+    }
+    return root;
+}
+const MINIMAL = {
+    'agent.js': 'export default { model: "m" }',
+    'agents/researcher/agent.js': 'export default { model: "m2" }',
+    'agents/researcher/instructions.md': 'Research things.',
+};
+describe('a derived supervisor always has a budget and a clock', () => {
+    it('defaults both when agent.ts names neither', async () => {
+        const { manifest } = await loadDirectory(tree(MINIMAL));
+        const { config } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        // The exact numbers matter less than that they are finite: a NaN or an
+        // undefined here is what silently disabled the limits.
+        expect(Number.isFinite(config.tokenBudget)).toBe(true);
+        expect(Number.isFinite(config.timeoutMs)).toBe(true);
+        expect(config.tokenBudget).toBeGreaterThan(0);
+        expect(config.timeoutMs).toBeGreaterThan(0);
+    });
+    it('uses the same defaults the SDK front door uses', async () => {
+        // Imported from the module that owns them rather than through the
+        // package entry: this file now lives inside that package, and a
+        // self-import resolves to the built `dist`, not to the source under
+        // test — which is how a stale build reads as a passing test.
+        const { DEFAULT_TIMEOUT_MS, DEFAULT_TOKEN_BUDGET } = await import('../../agents/runAgent.js');
+        const { manifest } = await loadDirectory(tree(MINIMAL));
+        const { config } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        // Two front doors that default differently is a difference nobody would
+        // find until a run behaved unlike its sibling.
+        expect(config.tokenBudget).toBe(DEFAULT_TOKEN_BUDGET);
+        expect(config.timeoutMs).toBe(DEFAULT_TIMEOUT_MS);
+    });
+    it('still honours what agent.ts declares', async () => {
+        const { manifest } = await loadDirectory(tree({
+            ...MINIMAL,
+            'agent.js': 'export default { model: "m", tokenBudget: 1234, timeoutMs: 5678 }',
+        }));
+        const { config } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        expect(config.tokenBudget).toBe(1234);
+        expect(config.timeoutMs).toBe(5678);
+    });
+    it('lets an override win over both', async () => {
+        const { manifest } = await loadDirectory(tree(MINIMAL));
+        const { config } = deriveSupervisorOptions(manifest, {
+            provider,
+            agentManager,
+            overrides: { tokenBudget: 42 },
+        });
+        expect(config.tokenBudget).toBe(42);
+    });
+});
+describe('a derived supervisor carries the skills it loaded', () => {
+    it('passes skills through instead of dropping them', async () => {
+        const { manifest } = await loadDirectory(tree({
+            ...MINIMAL,
+            'skills/plan-a-trip/SKILL.md': '---\nname: plan-a-trip\ndescription: Plan a trip\n---\n\nAsk for dates.',
+        }));
+        expect(manifest.skills).toHaveLength(1);
+        const { config } = deriveSupervisorOptions(manifest, { provider, agentManager });
+        // Loaded from disk, put on the manifest, and then — before this — left
+        // out of the config the supervisor actually runs with.
+        expect(config.skills).toHaveLength(1);
+        expect(config.skills?.[0]?.metadata.name).toBe('plan-a-trip');
+    });
+});
+//# sourceMappingURL=supervisor-budget.test.js.map

package/dist/directory/__tests__/supervisor-budget.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-budget.test.js","sourceRoot":"","sources":["../../../src/directory/__tests__/supervisor-budget.test.ts"],"names":[],"mappings":"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"}

package/dist/directory/derive-supervisor.d.ts

@@ -0,0 +1,58 @@
+import type { AgentIdentity } from '../agents/runAgent.js';
+import { ToolRegistry } from '../registry/tool/execute.js';
+import type { SupervisorAgentConfig } from '../types/agent/supervisor.js';
+import type { LLMProvider } from '../types/provider/index.js';
+import type { DirectoryManifest } from './types.js';
+export interface DeriveSupervisorInput {
+    readonly provider: LLMProvider;
+    /** Wins over `agent.ts`. Required when `agent.ts` names no model. */
+    readonly model?: string;
+    readonly identity?: Required<AgentIdentity>;
+    /**
+     * The lifecycle object that actually spawns delegates.
+     *
+     * Supplied by the host and never built here. An `AgentManager` owns
+     * running processes, budgets and cancellation — it is a thing with a
+     * lifetime, not a description of one, and this package's whole boundary is
+     * that it describes and does not run. Handing back options that carry a
+     * manager we constructed would make it a runner wearing a loader's name.
+     */
+    readonly agentManager: SupervisorAgentConfig['agentManager'];
+    readonly overrides?: Partial<SupervisorAgentConfig>;
+}
+export interface SupervisorPlan {
+    /** Ready for `new SupervisorAgent(...).run(input, config)`. */
+    readonly config: SupervisorAgentConfig;
+    /**
+     * What the host must register with its `AgentManager` before running,
+     * one per delegate, keyed by the id the supervisor will name.
+     *
+     * Returned rather than registered: registration is a mutation of the
+     * host's manager, and a function that quietly mutates an object it was
+     * handed for reference is the kind of surprise this package exists to
+     * avoid. The host does it, in one loop it can see.
+     */
+    readonly delegates: readonly DelegatePlan[];
+}
+export interface DelegatePlan {
+    readonly id: string;
+    readonly manifest: DirectoryManifest;
+    /** The delegate's own instructions, tools and model, already assembled. */
+    readonly systemPrompt: string;
+    readonly tools: ToolRegistry;
+    readonly model: string;
+}
+/**
+ * Turn a project that declares delegates into a supervisor configuration.
+ *
+ * The counterpart to `deriveRunOptions` for the multi-agent shape, and the
+ * same contract: it converts, it does not run. `SupervisorAgent` needs an
+ * `agentIds` roster and a manager that can spawn them; this supplies the
+ * roster from the directory and leaves the manager to the host.
+ *
+ * The delegates come back as plans rather than registered agents because
+ * registration mutates the host's manager. Two lines in the host, and the host
+ * can see exactly what it just gained.
+ */
+export declare function deriveSupervisorOptions(manifest: DirectoryManifest, input: DeriveSupervisorInput): SupervisorPlan;
+//# sourceMappingURL=derive-supervisor.d.ts.map

package/dist/directory/derive-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-supervisor.d.ts","sourceRoot":"","sources":["../../src/directory/derive-supervisor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,YAAY,CAAA;AAElE,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;IAC3C;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAA;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,cAAc;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAA;CAC3C;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,qBAAqB,GAC1B,cAAc,CA+DhB"}

package/dist/directory/derive-supervisor.js

@@ -0,0 +1,88 @@
+import { DEFAULT_TIMEOUT_MS, DEFAULT_TOKEN_BUDGET } from '../agents/runAgent.js';
+import { ToolRegistry } from '../registry/tool/execute.js';
+function toolsOf(manifest) {
+    const tools = new ToolRegistry();
+    for (const entry of manifest.tools)
+        tools.register(entry.definition);
+    return tools;
+}
+function delegatePlan(entry, fallbackModel) {
+    return {
+        id: entry.id,
+        manifest: entry.manifest,
+        systemPrompt: entry.manifest.instructions,
+        tools: toolsOf(entry.manifest),
+        // A delegate may name its own model — a cheap one for a narrow job is
+        // the common case — and inherits the supervisor's only when it does
+        // not. Inheriting unconditionally would silently bill every specialist
+        // at the coordinator's rate.
+        model: entry.manifest.config.model ?? fallbackModel,
+    };
+}
+/**
+ * Turn a project that declares delegates into a supervisor configuration.
+ *
+ * The counterpart to `deriveRunOptions` for the multi-agent shape, and the
+ * same contract: it converts, it does not run. `SupervisorAgent` needs an
+ * `agentIds` roster and a manager that can spawn them; this supplies the
+ * roster from the directory and leaves the manager to the host.
+ *
+ * The delegates come back as plans rather than registered agents because
+ * registration mutates the host's manager. Two lines in the host, and the host
+ * can see exactly what it just gained.
+ */
+export function deriveSupervisorOptions(manifest, input) {
+    if (manifest.modules === 'skip') {
+        throw new Error('This manifest was loaded with modules: "skip", so no tool was imported and no delegate was evaluated. Load with modules: "evaluate" before deriving supervisor options.');
+    }
+    if (manifest.agents.length === 0) {
+        // Not a warning that degrades into a supervisor with nobody to call.
+        // An empty roster makes `create_task` unmountable by design, so the
+        // result would be a coordinator that cannot coordinate — and the
+        // caller asked for a supervisor, which means they expected delegates.
+        throw new Error(`${manifest.root} declares no delegates, so there is nothing for a supervisor to coordinate. Add directories under agents/, or use deriveRunOptions for a single agent.`);
+    }
+    const model = input.model ?? manifest.config.model;
+    if (!model) {
+        throw new Error(`No model. Declare one in ${manifest.root}/agent.ts as \`export default { model: "…" }\`, or pass \`model\` here.`);
+    }
+    const delegates = manifest.agents.map((entry) => delegatePlan(entry, model));
+    const config = {
+        provider: input.provider,
+        model,
+        agentManager: input.agentManager,
+        agentIds: delegates.map((d) => d.id),
+        systemPrompt: manifest.instructions,
+        tools: toolsOf(manifest),
+        // Skills were loaded and then dropped. The manifest reads a whole
+        // `skills/` directory and `SupervisorAgentConfig` takes them, and the
+        // cast that used to close this object meant nobody was told the field
+        // had never been supplied.
+        ...(manifest.skills.length > 0 ? { skills: manifest.skills.map((s) => s.skill) } : {}),
+        // `tokenBudget` and `timeoutMs` are REQUIRED by `BaseAgentConfig`, and
+        // this object supplied them only when `agent.ts` happened to declare
+        // them — which is the uncommon case. The `as SupervisorAgentConfig`
+        // below made that compile, so a directory that named no budget produced
+        // a config typed `tokenBudget: number` holding `undefined`, and
+        // `buildLimitConfig` then disabled BOTH hard stops: no token cap, no
+        // wall clock. Worse, the child-spawn refusal computes its allocation
+        // from the parent budget, so `undefined` became `NaN`, and `NaN <= 0`
+        // is false — the guard that exists to refuse an unfunded child let it
+        // through with a NaN budget.
+        //
+        // Defaulted to the same numbers `runAgent` uses rather than to a local
+        // guess, so the two front doors cannot drift.
+        tokenBudget: manifest.config.tokenBudget ?? DEFAULT_TOKEN_BUDGET,
+        timeoutMs: manifest.config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        ...(manifest.config.temperature !== undefined
+            ? { temperature: manifest.config.temperature }
+            : {}),
+        ...(manifest.config.maxIterations !== undefined
+            ? { maxIterations: manifest.config.maxIterations }
+            : {}),
+        ...(input.identity ?? {}),
+        ...(input.overrides ?? {}),
+    };
+    return { config, delegates };
+}
+//# sourceMappingURL=derive-supervisor.js.map

package/dist/directory/derive-supervisor.js.map

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

package/dist/directory/derive.d.ts

@@ -0,0 +1,12 @@
+import type { RunAgentOptions } from '../agents/runAgent.js';
+import type { DeriveRunOptionsInput, DirectoryManifest } from './types.js';
+/**
+ * Turn a loaded project into the options `runAgent` takes.
+ *
+ * One direction, no second engine. Everything this produces is an ordinary
+ * `RunAgentOptions` field, so a caller who needs something this does not cover
+ * spreads `overrides` or stops using this function — there is no behaviour
+ * reachable only through the convention.
+ */
+export declare function deriveRunOptions(manifest: DirectoryManifest, input: DeriveRunOptionsInput): RunAgentOptions;
+//# sourceMappingURL=derive.d.ts.map

package/dist/directory/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/directory/derive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAG5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE1E;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,qBAAqB,GAC1B,eAAe,CAqDjB"}

package/dist/directory/derive.js

@@ -0,0 +1,58 @@
+import { ToolRegistry } from '../registry/tool/execute.js';
+/**
+ * Turn a loaded project into the options `runAgent` takes.
+ *
+ * One direction, no second engine. Everything this produces is an ordinary
+ * `RunAgentOptions` field, so a caller who needs something this does not cover
+ * spreads `overrides` or stops using this function — there is no behaviour
+ * reachable only through the convention.
+ */
+export function deriveRunOptions(manifest, input) {
+    if (manifest.modules === 'skip') {
+        // The manifest is structurally complete and its tools were never
+        // imported, so `manifest.tools` is empty for a reason that has nothing
+        // to do with the project. Running it would produce an agent with no
+        // capabilities and no indication why.
+        throw new Error('This manifest was loaded with modules: "skip", so no tool was imported and none can be registered. Load with modules: "evaluate" before deriving run options.');
+    }
+    const model = input.model ?? manifest.config.model;
+    if (!model) {
+        throw new Error(`No model. Declare one in ${manifest.root}/agent.ts as \`export default { model: "…" }\`, or pass \`model\` here.`);
+    }
+    const tools = new ToolRegistry();
+    for (const entry of manifest.tools)
+        tools.register(entry.definition);
+    return {
+        provider: input.provider,
+        prompt: input.prompt,
+        model,
+        tools,
+        // The one value the project knows and `runAgent` cannot infer. Left
+        // unset it would default to the host's own cwd, pointing the file
+        // tools' containment at the host's source tree rather than at the
+        // project. The root is `agent/` itself, not its parent — narrower is
+        // the safe direction, and widening it is the caller's explicit call
+        // through `overrides`.
+        workingDirectory: manifest.root,
+        ...(manifest.instructions ? { instructions: manifest.instructions } : {}),
+        ...(manifest.skills.length > 0 ? { skills: manifest.skills.map((s) => s.skill) } : {}),
+        // Only when declared. A name guessed from a directory basename becomes
+        // the agent id in traces, where two sibling projects called `agent`
+        // would silently merge into one attribution bucket — worse than the
+        // SDK's own default, which at least does not pretend to be specific.
+        ...(manifest.config.name ? { name: manifest.config.name } : {}),
+        ...(manifest.config.temperature !== undefined
+            ? { temperature: manifest.config.temperature }
+            : {}),
+        ...(manifest.config.maxIterations !== undefined
+            ? { maxIterations: manifest.config.maxIterations }
+            : {}),
+        ...(manifest.config.tokenBudget !== undefined
+            ? { tokenBudget: manifest.config.tokenBudget }
+            : {}),
+        ...(manifest.config.timeoutMs !== undefined ? { timeoutMs: manifest.config.timeoutMs } : {}),
+        ...(input.identity ?? {}),
+        ...(input.overrides ?? {}),
+    };
+}
+//# sourceMappingURL=derive.js.map

package/dist/directory/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../../src/directory/derive.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAI1D;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC/B,QAA2B,EAC3B,KAA4B;IAE5B,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QACjC,iEAAiE;QACjE,uEAAuE;QACvE,oEAAoE;QACpE,sCAAsC;QACtC,MAAM,IAAI,KAAK,CACd,+JAA+J,CAC/J,CAAA;IACF,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAA;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACd,4BAA4B,QAAQ,CAAC,IAAI,yEAAyE,CAClH,CAAA;IACF,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAA;IAChC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,KAAK;QAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAEpE,OAAO;QACN,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK;QACL,KAAK;QACL,oEAAoE;QACpE,kEAAkE;QAClE,kEAAkE;QAClE,qEAAqE;QACrE,oEAAoE;QACpE,uBAAuB;QACvB,gBAAgB,EAAE,QAAQ,CAAC,IAAI;QAC/B,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,uEAAuE;QACvE,oEAAoE;QACpE,oEAAoE;QACpE,qEAAqE;QACrE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS;YAC5C,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACN,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS;YAC9C,CAAC,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;QACN,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS;YAC5C,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACN,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QACzB,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;KAC1B,CAAA;AACF,CAAC"}

package/dist/directory/index.d.ts

@@ -0,0 +1,7 @@
+export { loadDirectory } from './load.js';
+export { deriveRunOptions } from './derive.js';
+export { deriveSupervisorOptions } from './derive-supervisor.js';
+export type { DelegatePlan, DeriveSupervisorInput, SupervisorPlan, } from './derive-supervisor.js';
+export type { DeriveRunOptionsInput, DirectoryDiagnosticCode, DirectoryDiagnosticSeverity, LoadDirectoryOptions, ModuleImporter, ModuleMode, DirectoryConfig, DirectoryDiagnostic, DirectoryLoadResult, DirectoryManifest, DirectorySlot, SkillEntry, SourceOutcome, SourceRef, SubAgentEntry, ToolEntry, } from './types.js';
+export { ALL_SLOTS } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/directory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,YAAY,EACX,YAAY,EACZ,qBAAqB,EACrB,cAAc,GACd,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACX,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,SAAS,GACT,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}

package/dist/directory/index.js

@@ -0,0 +1,5 @@
+export { loadDirectory } from './load.js';
+export { deriveRunOptions } from './derive.js';
+export { deriveSupervisorOptions } from './derive-supervisor.js';
+export { ALL_SLOTS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/directory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/directory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAwBhE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}

package/dist/directory/load.d.ts

@@ -0,0 +1,14 @@
+import type { DirectoryLoadResult, LoadDirectoryOptions } from './types.js';
+/**
+ * Read a conventional agent directory into typed, inspectable definitions.
+ *
+ * A LOADER, not a runner: it produces what is there and hands it back. Running
+ * it — a turn, a server, a schedule — is the host's job, which is what keeps
+ * this package free of any hosting model.
+ *
+ * It never throws on authored content. A broken tool, a missing file, a
+ * malformed config all come back as diagnostics, because a loader that throws
+ * on the first bad file tells you about one problem when you wanted the list.
+ */
+export declare function loadDirectory(dir: string, options?: LoadDirectoryOptions): Promise<DirectoryLoadResult>;
+//# sourceMappingURL=load.d.ts.map

package/dist/directory/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/directory/load.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGX,mBAAmB,EAEnB,oBAAoB,EAQpB,MAAM,YAAY,CAAA;AA2MnB;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}