@agentworkforce/persona-kit 0.19.0

package/dist/plan.js

@@ -0,0 +1,150 @@
+import { buildInteractiveSpec } from './interactive-spec.js';
+import { resolvePersonaInputs, renderPersonaInputs } from './inputs.js';
+import { materializeSkills } from './skills.js';
+function resolvedInputBindings(inputs, values) {
+    if (!inputs)
+        return [];
+    return Object.entries(inputs)
+        .filter(([name]) => values[name] !== undefined)
+        .map(([name, spec]) => ({
+        name,
+        envName: spec.env ?? name,
+        value: values[name]
+    }));
+}
+function resolveSidecarWrite(selection) {
+    const harness = selection.runtime.harness;
+    if (harness === 'claude') {
+        if (selection.claudeMdContent !== undefined) {
+            return [
+                {
+                    filename: 'CLAUDE.md',
+                    contents: selection.claudeMdContent,
+                    mode: selection.claudeMdMode ?? 'overwrite'
+                }
+            ];
+        }
+        if (selection.claudeMd) {
+            return [
+                {
+                    filename: 'CLAUDE.md',
+                    sourcePath: selection.claudeMd,
+                    mode: selection.claudeMdMode ?? 'overwrite'
+                }
+            ];
+        }
+        return [];
+    }
+    if (harness === 'opencode' || harness === 'codex') {
+        if (selection.agentsMdContent !== undefined) {
+            return [
+                {
+                    filename: 'AGENTS.md',
+                    contents: selection.agentsMdContent,
+                    mode: selection.agentsMdMode ?? 'overwrite'
+                }
+            ];
+        }
+        if (selection.agentsMd) {
+            return [
+                {
+                    filename: 'AGENTS.md',
+                    sourcePath: selection.agentsMd,
+                    mode: selection.agentsMdMode ?? 'overwrite'
+                }
+            ];
+        }
+        return [];
+    }
+    return [];
+}
+function resolveMountPolicy(mount) {
+    if (!mount)
+        return undefined;
+    const ignored = mount.ignoredPatterns ?? [];
+    const readonly = mount.readonlyPatterns ?? [];
+    if (ignored.length === 0 && readonly.length === 0)
+        return undefined;
+    return {
+        ignoredPatterns: [...ignored],
+        readonlyPatterns: [...readonly]
+    };
+}
+/**
+ * Pure plan builder. Composes existing persona-kit helpers
+ * ({@link buildInteractiveSpec}, {@link materializeSkills},
+ * {@link resolvePersonaInputs}) into a single inspectable
+ * {@link PersonaSpawnPlan}. Does **no** filesystem writes and spawns no
+ * subprocesses.
+ *
+ * The returned plan is JSON-serializable: every field is a plain value or
+ * primitive array. Callers can stamp it into launch metadata, send it across
+ * a wire, or hand it to {@link import('./execute.js').executePersonaSpawnPlan}.
+ */
+export function buildPersonaSpawnPlan(persona, options = {}) {
+    const harness = persona.runtime.harness;
+    // Input env-var fallbacks read from `processEnv` only when ambient capture
+    // is opted into. With ambient capture off, `resolvePersonaInputs` sees an
+    // empty env and inputs must resolve from explicit values, persona
+    // `inputValues`, or `default` — keeping plans deterministic across hosts.
+    const processEnv = options.processEnv ?? (options.includeProcessEnv ? process.env : {});
+    const inputResolution = resolvePersonaInputs(persona.inputs ?? persona.inputValues
+        ? persona.inputs ?? undefined
+        : undefined, options.inputValues ?? persona.inputValues, processEnv);
+    const renderedSystemPrompt = renderPersonaInputs(persona.runtime.systemPrompt, inputResolution.values);
+    const skills = materializeSkills(persona.skills, harness, options.installRoot !== undefined ? { installRoot: options.installRoot } : {});
+    const spec = buildInteractiveSpec({
+        harness,
+        personaId: persona.personaId,
+        model: persona.runtime.model,
+        systemPrompt: renderedSystemPrompt,
+        ...(persona.mcpServers ? { mcpServers: persona.mcpServers } : {}),
+        ...(persona.permissions ? { permissions: persona.permissions } : {}),
+        ...(persona.runtime.harnessSettings
+            ? { harnessSettings: persona.runtime.harnessSettings }
+            : {}),
+        ...(skills.sessionInstallRoot
+            ? { pluginDirs: [skills.sessionInstallRoot] }
+            : {})
+    });
+    const inputBindings = resolvedInputBindings(persona.inputs, inputResolution.values);
+    const sidecars = resolveSidecarWrite(persona);
+    const mount = resolveMountPolicy(persona.mount);
+    // Env precedence (later wins):
+    //   ambient processEnv (opt-in)
+    //   → resolved input bindings
+    //   → caller envOverrides
+    //   → persona-author env
+    //
+    // Ambient capture is opt-in to keep secrets out of the JSON-serializable
+    // plan by default — callers must pass `includeProcessEnv: true` (or supply
+    // a curated `processEnv` snapshot) to forward ambient values.
+    const env = {};
+    const ambientSource = options.processEnv ?? (options.includeProcessEnv ? process.env : undefined);
+    if (ambientSource) {
+        for (const [k, v] of Object.entries(ambientSource)) {
+            if (typeof v === 'string')
+                env[k] = v;
+        }
+    }
+    for (const binding of inputBindings)
+        env[binding.envName] = binding.value;
+    if (options.envOverrides)
+        Object.assign(env, options.envOverrides);
+    if (persona.env)
+        Object.assign(env, persona.env);
+    const plan = {
+        persona,
+        cli: harness,
+        args: [...spec.args],
+        configFiles: spec.configFiles.map((f) => ({ path: f.path, contents: f.contents })),
+        skills,
+        sidecars,
+        inputs: inputBindings,
+        env,
+        ...(spec.initialPrompt !== null ? { initialPrompt: spec.initialPrompt } : {}),
+        ...(mount ? { mount } : {})
+    };
+    return plan;
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

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

package/dist/plan.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plan.test.d.ts.map

package/dist/plan.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.test.d.ts","sourceRoot":"","sources":["../src/plan.test.ts"],"names":[],"mappings":""}

package/dist/plan.test.js

@@ -0,0 +1,191 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { buildPersonaSpawnPlan } from './plan.js';
+function persona(over = {}) {
+    return {
+        personaId: 'p',
+        tier: 'best-value',
+        runtime: {
+            harness: 'claude',
+            model: 'anthropic/claude-3-5-sonnet',
+            systemPrompt: 'be helpful',
+            harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 }
+        },
+        skills: [],
+        rationale: 'test',
+        ...over
+    };
+}
+const cleanEnv = Object.freeze({});
+test('buildPersonaSpawnPlan returns the persona, cli, and args for claude', () => {
+    const plan = buildPersonaSpawnPlan(persona(), { processEnv: cleanEnv });
+    assert.equal(plan.cli, 'claude');
+    assert.ok(plan.args.length > 0);
+    assert.equal(plan.persona.personaId, 'p');
+    assert.deepEqual(plan.skills.installs, []);
+    assert.deepEqual(plan.sidecars, []);
+    assert.equal(plan.mount, undefined);
+    assert.deepEqual(plan.inputs, []);
+    assert.equal(plan.initialPrompt, undefined);
+});
+test('buildPersonaSpawnPlan emits initialPrompt for codex', () => {
+    const plan = buildPersonaSpawnPlan(persona({
+        runtime: {
+            harness: 'codex',
+            model: 'openai/gpt-5',
+            systemPrompt: 'codex prompt',
+            harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 }
+        }
+    }), { processEnv: cleanEnv });
+    assert.equal(plan.cli, 'codex');
+    assert.equal(plan.initialPrompt, 'codex prompt');
+});
+test('buildPersonaSpawnPlan emits configFiles for opencode', () => {
+    const plan = buildPersonaSpawnPlan(persona({
+        personaId: 'sample',
+        runtime: {
+            harness: 'opencode',
+            model: 'anthropic/claude-3-5-sonnet',
+            systemPrompt: 'opencode prompt',
+            harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 }
+        }
+    }), { processEnv: cleanEnv });
+    assert.equal(plan.cli, 'opencode');
+    assert.ok(plan.configFiles.some((f) => f.path.endsWith('opencode.json')), 'opencode plan must emit an opencode.json');
+});
+test('buildPersonaSpawnPlan resolves sidecars from claudeMdContent / agentsMdContent', () => {
+    const claudePlan = buildPersonaSpawnPlan(persona({
+        claudeMdContent: '# claude sidecar',
+        claudeMdMode: 'overwrite'
+    }), { processEnv: cleanEnv });
+    assert.equal(claudePlan.sidecars.length, 1);
+    assert.equal(claudePlan.sidecars[0].filename, 'CLAUDE.md');
+    assert.equal(claudePlan.sidecars[0].contents, '# claude sidecar');
+    const opencodePlan = buildPersonaSpawnPlan(persona({
+        agentsMdContent: '# agents sidecar',
+        agentsMdMode: 'extend',
+        runtime: {
+            harness: 'opencode',
+            model: 'anthropic/claude-3-5-sonnet',
+            systemPrompt: 'be helpful',
+            harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 }
+        }
+    }), { processEnv: cleanEnv });
+    assert.equal(opencodePlan.sidecars.length, 1);
+    assert.equal(opencodePlan.sidecars[0].filename, 'AGENTS.md');
+    assert.equal(opencodePlan.sidecars[0].mode, 'extend');
+});
+test('buildPersonaSpawnPlan threads mount policy through when patterns present', () => {
+    const plan = buildPersonaSpawnPlan(persona({
+        mount: { ignoredPatterns: ['secrets/**'], readonlyPatterns: ['vendor/**'] }
+    }), { processEnv: cleanEnv });
+    assert.deepEqual(plan.mount?.ignoredPatterns, ['secrets/**']);
+    assert.deepEqual(plan.mount?.readonlyPatterns, ['vendor/**']);
+});
+test('buildPersonaSpawnPlan drops empty mount policy', () => {
+    const plan = buildPersonaSpawnPlan(persona({ mount: {} }), { processEnv: cleanEnv });
+    assert.equal(plan.mount, undefined);
+});
+test('buildPersonaSpawnPlan resolves inputs into env bindings', () => {
+    const plan = buildPersonaSpawnPlan(persona({
+        inputs: {
+            OUTPUT_PATH: { default: '/tmp/out' },
+            TARGET: { env: 'TARGET_OVERRIDE' }
+        }
+    }), { processEnv: { TARGET_OVERRIDE: 'frobnicate' } });
+    const byName = Object.fromEntries(plan.inputs.map((b) => [b.name, b]));
+    assert.equal(byName.OUTPUT_PATH.envName, 'OUTPUT_PATH');
+    assert.equal(byName.OUTPUT_PATH.value, '/tmp/out');
+    assert.equal(byName.TARGET.envName, 'TARGET_OVERRIDE');
+    assert.equal(byName.TARGET.value, 'frobnicate');
+    assert.equal(plan.env.OUTPUT_PATH, '/tmp/out');
+    assert.equal(plan.env.TARGET_OVERRIDE, 'frobnicate');
+});
+test('buildPersonaSpawnPlan persona env wins over inputs and overrides', () => {
+    const plan = buildPersonaSpawnPlan(persona({
+        env: { FOO: 'persona-wins' },
+        inputs: { FOO: { default: 'from-input' } }
+    }), {
+        processEnv: cleanEnv,
+        envOverrides: { FOO: 'override-value' }
+    });
+    assert.equal(plan.env.FOO, 'persona-wins');
+});
+test('buildPersonaSpawnPlan is JSON-serializable', () => {
+    const plan = buildPersonaSpawnPlan(persona({
+        claudeMdContent: '# sidecar',
+        mount: { ignoredPatterns: ['x'] },
+        env: { FOO: 'bar' }
+    }), { processEnv: cleanEnv });
+    const round = JSON.parse(JSON.stringify(plan));
+    assert.deepEqual(round.cli, plan.cli);
+    assert.deepEqual(round.args, plan.args);
+    assert.deepEqual(round.sidecars, plan.sidecars);
+    assert.deepEqual(round.mount, plan.mount);
+    assert.deepEqual(round.env, plan.env);
+});
+test('buildPersonaSpawnPlan threads installRoot into the skill plan', () => {
+    const plan = buildPersonaSpawnPlan(persona({
+        skills: [
+            {
+                id: 'prpm/x',
+                source: '@scope/x',
+                description: 'd'
+            }
+        ]
+    }), { processEnv: cleanEnv, installRoot: '/tmp/session/plugin' });
+    assert.equal(plan.skills.sessionInstallRoot, '/tmp/session/plugin');
+    // Plugin dirs flow through into the claude argv.
+    assert.ok(plan.args.some((arg) => arg === '/tmp/session/plugin'), 'plugin-dir from installRoot should appear in claude argv');
+});
+test('buildPersonaSpawnPlan emits sourcePath when only claudeMd path is set', () => {
+    const plan = buildPersonaSpawnPlan(persona({ claudeMd: '/abs/path/to/CLAUDE.md', claudeMdMode: 'extend' }), { processEnv: cleanEnv });
+    assert.equal(plan.sidecars.length, 1);
+    assert.equal(plan.sidecars[0].filename, 'CLAUDE.md');
+    assert.equal(plan.sidecars[0].sourcePath, '/abs/path/to/CLAUDE.md');
+    assert.equal(plan.sidecars[0].contents, undefined);
+    assert.equal(plan.sidecars[0].mode, 'extend');
+});
+test('buildPersonaSpawnPlan emits sourcePath for opencode/codex agentsMd path', () => {
+    const plan = buildPersonaSpawnPlan(persona({
+        runtime: {
+            harness: 'opencode',
+            model: 'm',
+            systemPrompt: 's',
+            harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 }
+        },
+        agentsMd: '/abs/path/to/AGENTS.md'
+    }), { processEnv: cleanEnv });
+    assert.equal(plan.sidecars.length, 1);
+    assert.equal(plan.sidecars[0].sourcePath, '/abs/path/to/AGENTS.md');
+});
+test('buildPersonaSpawnPlan does not capture ambient env by default', () => {
+    // No processEnv or includeProcessEnv — plan.env should only carry persona/input bindings.
+    const plan = buildPersonaSpawnPlan(persona({ env: { ONLY: 'persona' } }));
+    assert.deepEqual(plan.env, { ONLY: 'persona' });
+});
+test('buildPersonaSpawnPlan opt-in includeProcessEnv captures process.env', () => {
+    const sentinel = `__PK_TEST_${Date.now()}_${Math.random()}__`;
+    process.env[sentinel] = 'on';
+    try {
+        const plan = buildPersonaSpawnPlan(persona(), { includeProcessEnv: true });
+        assert.equal(plan.env[sentinel], 'on');
+    }
+    finally {
+        delete process.env[sentinel];
+    }
+});
+test('buildPersonaSpawnPlan empty-skills case keeps installs empty', () => {
+    for (const harness of ['claude', 'codex', 'opencode']) {
+        const plan = buildPersonaSpawnPlan(persona({
+            runtime: {
+                harness,
+                model: 'm',
+                systemPrompt: 's',
+                harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 }
+            }
+        }), { processEnv: cleanEnv });
+        assert.equal(plan.skills.installs.length, 0, `harness ${harness}`);
+    }
+});
+//# sourceMappingURL=plan.test.js.map

package/dist/plan.test.js.map

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

package/dist/sidecars.d.ts

@@ -0,0 +1,17 @@
+import type { ResolvedSidecarWrite } from './plan.js';
+export interface PersonaSidecarHandle {
+    /** Reverse the write. Idempotent; safe to call twice. */
+    dispose(): Promise<void>;
+}
+/**
+ * Write each sidecar to `<cwd>/<filename>`. In `extend` mode the persona body
+ * is appended to the existing on-disk content (joined with `\n\n---\n\n`). In
+ * `overwrite` mode the file is replaced. Path-backed sidecars
+ * ({@link ResolvedSidecarWrite.sourcePath}) are read at this point, so the
+ * plan stays JSON-serializable. The returned handle restores every touched
+ * file to its prior state on `dispose()`.
+ */
+export declare function writePersonaSidecars(sidecars: readonly ResolvedSidecarWrite[], options: {
+    cwd: string;
+}): Promise<PersonaSidecarHandle>;
+//# sourceMappingURL=sidecars.d.ts.map

package/dist/sidecars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecars.d.ts","sourceRoot":"","sources":["../src/sidecars.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAyDD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA2B/B"}

package/dist/sidecars.js

@@ -0,0 +1,101 @@
+import { readFile, writeFile, unlink } from 'node:fs/promises';
+import { basename, isAbsolute, join } from 'node:path';
+const SIDECAR_DELIMITER = '\n\n---\n\n';
+/**
+ * The plan's filename is typed `'CLAUDE.md' | 'AGENTS.md'` at compile time,
+ * but plans can be JSON-deserialized from untrusted sources at runtime.
+ * Bound to safe basenames here so a hand-built or tampered plan cannot
+ * escape `cwd` via `..` or absolute path segments.
+ */
+function assertSafeSidecarFilename(filename) {
+    if (!filename)
+        throw new Error('sidecar filename must be non-empty');
+    if (isAbsolute(filename)) {
+        throw new Error(`sidecar filename must be relative; got ${JSON.stringify(filename)}`);
+    }
+    if (basename(filename) !== filename) {
+        throw new Error(`sidecar filename must be a basename (no directory segments); got ${JSON.stringify(filename)}`);
+    }
+}
+async function readIfExists(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+async function loadSidecarBody(sidecar) {
+    if (sidecar.contents !== undefined)
+        return sidecar.contents;
+    if (sidecar.sourcePath !== undefined) {
+        if (!isAbsolute(sidecar.sourcePath)) {
+            throw new Error(`ResolvedSidecarWrite.sourcePath must be absolute; got ${JSON.stringify(sidecar.sourcePath)}`);
+        }
+        return readFile(sidecar.sourcePath, 'utf8');
+    }
+    // Type system already enforces this; the runtime check keeps the message
+    // clear if a hand-built plan slips through.
+    const probe = sidecar;
+    throw new Error(`ResolvedSidecarWrite for ${probe.filename ?? '<unknown>'} must supply either contents or sourcePath.`);
+}
+/**
+ * Write each sidecar to `<cwd>/<filename>`. In `extend` mode the persona body
+ * is appended to the existing on-disk content (joined with `\n\n---\n\n`). In
+ * `overwrite` mode the file is replaced. Path-backed sidecars
+ * ({@link ResolvedSidecarWrite.sourcePath}) are read at this point, so the
+ * plan stays JSON-serializable. The returned handle restores every touched
+ * file to its prior state on `dispose()`.
+ */
+export async function writePersonaSidecars(sidecars, options) {
+    const restored = [];
+    let disposed = false;
+    try {
+        for (const sidecar of sidecars) {
+            assertSafeSidecarFilename(sidecar.filename);
+            const target = join(options.cwd, sidecar.filename);
+            const personaBody = await loadSidecarBody(sidecar);
+            const prior = await readIfExists(target);
+            restored.push({ path: target, prior });
+            const body = sidecar.mode === 'extend' && prior !== null
+                ? `${prior}${SIDECAR_DELIMITER}${personaBody}`
+                : personaBody;
+            await writeFile(target, body, 'utf8');
+        }
+    }
+    catch (err) {
+        await disposeRestored(restored);
+        throw err;
+    }
+    return {
+        async dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            await disposeRestored(restored);
+        }
+    };
+}
+async function disposeRestored(restored) {
+    for (let i = restored.length - 1; i >= 0; i -= 1) {
+        const entry = restored[i];
+        try {
+            if (entry.prior === null) {
+                await unlink(entry.path).catch((err) => {
+                    if (err.code !== 'ENOENT')
+                        throw err;
+                });
+            }
+            else {
+                await writeFile(entry.path, entry.prior, 'utf8');
+            }
+        }
+        catch {
+            // Best-effort restore — losing a file restore must not stop the
+            // remaining entries from being processed.
+        }
+    }
+}
+//# sourceMappingURL=sidecars.js.map

package/dist/sidecars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecars.js","sourceRoot":"","sources":["../src/sidecars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAcvD,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAExC;;;;;GAKG;AACH,SAAS,yBAAyB,CAAC,QAAgB;IACjD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACrE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,0CAA0C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,oEAAoE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAC/F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAA6B;IAC1D,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC5D,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,yDAAyD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAC9F,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,yEAAyE;IACzE,4CAA4C;IAC5C,MAAM,KAAK,GAAG,OAAgC,CAAC;IAC/C,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,CAAC,QAAQ,IAAI,WAAW,6CAA6C,CACvG,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAyC,EACzC,OAAwB;IAExB,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC;QACH,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnD,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACvC,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;gBACzC,CAAC,CAAC,GAAG,KAAK,GAAG,iBAAiB,GAAG,WAAW,EAAE;gBAC9C,CAAC,CAAC,WAAW,CAAC;YAClB,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO;QACL,KAAK,CAAC,OAAO;YACX,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAgC;IAC7D,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACzB,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAA0B,EAAE,EAAE;oBAC5D,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;wBAAE,MAAM,GAAG,CAAC;gBACvC,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;YAChE,0CAA0C;QAC5C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/skill-runner.d.ts

@@ -0,0 +1,30 @@
+import type { SkillMaterializationPlan } from './types.js';
+export interface PersonaSkillsHandle {
+    /**
+     * Remove the per-install ephemeral artifact paths declared by the plan
+     * (or, in session mode, the whole session install root). Idempotent.
+     */
+    dispose(): Promise<void>;
+}
+export interface RunSkillInstallsOptions {
+    cwd: string;
+    /**
+     * When true (default) the dispose handle deletes installed skills paths
+     * (or, in session mode, the entire session install root). Set false to
+     * keep installs around — e.g. for repeat runs that share a stage dir.
+     */
+    cleanupOnDispose?: boolean;
+}
+export declare class SkillInstallError extends Error {
+    readonly exitCode: number;
+    readonly output: string;
+    constructor(exitCode: number, output: string);
+}
+/**
+ * Run every install in a {@link SkillMaterializationPlan}. Aborts on the
+ * first non-zero exit code with the buffered subprocess output attached to
+ * the thrown error. The returned handle removes the installed artifacts on
+ * `dispose()` (or the whole session root in session-install-root mode).
+ */
+export declare function runSkillInstalls(plan: SkillMaterializationPlan, options: RunSkillInstallsOptions): Promise<PersonaSkillsHandle>;
+//# sourceMappingURL=skill-runner.d.ts.map

package/dist/skill-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-runner.d.ts","sourceRoot":"","sources":["../src/skill-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM7C;AAwCD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAsC9B"}

package/dist/skill-runner.js

@@ -0,0 +1,94 @@
+import { spawn } from 'node:child_process';
+import { rm } from 'node:fs/promises';
+import { constants as osConstants } from 'node:os';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { buildInstallArtifacts } from './skills.js';
+export class SkillInstallError extends Error {
+    exitCode;
+    output;
+    constructor(exitCode, output) {
+        super(`Skill install failed (exit ${exitCode})`);
+        this.name = 'SkillInstallError';
+        this.exitCode = exitCode;
+        this.output = output;
+    }
+}
+function signalExitCode(signal) {
+    if (!signal)
+        return 0;
+    const num = osConstants.signals[signal];
+    return 128 + (num ?? 1);
+}
+async function spawnInstall(command, cwd) {
+    const [bin, ...args] = command;
+    if (!bin)
+        return { code: 0, output: '' };
+    return new Promise((resolve) => {
+        const child = spawn(bin, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: false,
+            cwd
+        });
+        let buffered = '';
+        child.stdout?.setEncoding('utf8');
+        child.stderr?.setEncoding('utf8');
+        child.stdout?.on('data', (chunk) => {
+            buffered += chunk;
+        });
+        child.stderr?.on('data', (chunk) => {
+            buffered += chunk;
+        });
+        child.on('error', (err) => {
+            resolve({ code: 1, output: `${buffered}${err.message}\n` });
+        });
+        child.on('close', (status, signal) => {
+            const exit = typeof status === 'number' ? status : signal ? signalExitCode(signal) : 1;
+            resolve({ code: exit, output: buffered });
+        });
+    });
+}
+/**
+ * Run every install in a {@link SkillMaterializationPlan}. Aborts on the
+ * first non-zero exit code with the buffered subprocess output attached to
+ * the thrown error. The returned handle removes the installed artifacts on
+ * `dispose()` (or the whole session root in session-install-root mode).
+ */
+export async function runSkillInstalls(plan, options) {
+    const cleanupOnDispose = options.cleanupOnDispose ?? true;
+    const artifacts = buildInstallArtifacts(plan);
+    if (artifacts.installCommandString !== ':') {
+        const { code, output } = await spawnInstall(artifacts.installCommand, options.cwd);
+        if (code !== 0) {
+            throw new SkillInstallError(code, output);
+        }
+    }
+    let disposed = false;
+    return {
+        async dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            if (!cleanupOnDispose)
+                return;
+            if (plan.sessionInstallRoot !== undefined) {
+                await rm(plan.sessionInstallRoot, { recursive: true, force: true });
+                return;
+            }
+            const cwdAbs = resolve(options.cwd);
+            for (const install of plan.installs) {
+                for (const path of install.cleanupPaths) {
+                    const abs = isAbsolute(path) ? resolve(path) : resolve(cwdAbs, path);
+                    const rel = relative(cwdAbs, abs);
+                    // Refuse to follow a tampered plan into directories outside the
+                    // workspace — `rm -rf` doesn't get a free pass just because the
+                    // path was declared in plan data.
+                    if (rel === '' || rel.startsWith('..') || isAbsolute(rel)) {
+                        throw new Error(`runSkillInstalls: cleanup path must stay within cwd; got ${JSON.stringify(path)}`);
+                    }
+                    await rm(abs, { recursive: true, force: true });
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=skill-runner.js.map

package/dist/skill-runner.js.map

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