@agentworkforce/persona-kit 0.19.0

package/dist/parse.js

@@ -0,0 +1,475 @@
+import { CODEX_APPROVAL_POLICIES, CODEX_SANDBOX_MODES, HARNESS_VALUES, PERMISSION_MODES, PERSONA_INTENTS, PERSONA_TAGS, PERSONA_TIERS, SIDECAR_MD_MODES } from './constants.js';
+export function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+export function isHarness(value) {
+    return typeof value === 'string' && HARNESS_VALUES.includes(value);
+}
+export function isTier(value) {
+    return typeof value === 'string' && PERSONA_TIERS.includes(value);
+}
+export function isIntent(value) {
+    return typeof value === 'string' && PERSONA_INTENTS.includes(value);
+}
+export function isTag(value) {
+    return typeof value === 'string' && PERSONA_TAGS.includes(value);
+}
+export function isSidecarMode(value) {
+    return typeof value === 'string' && SIDECAR_MD_MODES.includes(value);
+}
+export function parseTags(value, context) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new Error(`${context} must be a non-empty array of tags`);
+    }
+    const out = [];
+    for (const [idx, entry] of value.entries()) {
+        if (!isTag(entry)) {
+            throw new Error(`${context}[${idx}] must be one of: ${PERSONA_TAGS.join(', ')}`);
+        }
+        if (!out.includes(entry))
+            out.push(entry);
+    }
+    return out;
+}
+export function assertSidecarPath(value, context) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Error(`${context} must be a non-empty string`);
+    }
+    if (value.startsWith('/')) {
+        throw new Error(`${context} must be a relative POSIX path; got absolute "${value}"`);
+    }
+    const segments = value.split(/[\\/]+/);
+    if (segments.some((s) => s === '..')) {
+        throw new Error(`${context} must not contain ".." segments`);
+    }
+    if (!value.toLowerCase().endsWith('.md')) {
+        throw new Error(`${context} must end with .md`);
+    }
+}
+export function parseHarnessSettings(value, context) {
+    if (!isObject(value)) {
+        throw new Error(`${context} must be an object`);
+    }
+    const { reasoning, timeoutSeconds, sandboxMode, approvalPolicy, workspaceWriteNetworkAccess, webSearch } = value;
+    if (!['low', 'medium', 'high'].includes(String(reasoning))) {
+        throw new Error(`${context}.reasoning must be low|medium|high`);
+    }
+    if (typeof timeoutSeconds !== 'number' || !Number.isFinite(timeoutSeconds) || timeoutSeconds <= 0) {
+        throw new Error(`${context}.timeoutSeconds must be a positive number`);
+    }
+    const out = {
+        reasoning: reasoning,
+        timeoutSeconds
+    };
+    if (sandboxMode !== undefined) {
+        if (!CODEX_SANDBOX_MODES.includes(sandboxMode)) {
+            throw new Error(`${context}.sandboxMode must be one of: ${CODEX_SANDBOX_MODES.join(', ')}`);
+        }
+        out.sandboxMode = sandboxMode;
+    }
+    if (approvalPolicy !== undefined) {
+        if (!CODEX_APPROVAL_POLICIES.includes(approvalPolicy)) {
+            throw new Error(`${context}.approvalPolicy must be one of: ${CODEX_APPROVAL_POLICIES.join(', ')}`);
+        }
+        out.approvalPolicy = approvalPolicy;
+    }
+    if (workspaceWriteNetworkAccess !== undefined) {
+        if (typeof workspaceWriteNetworkAccess !== 'boolean') {
+            throw new Error(`${context}.workspaceWriteNetworkAccess must be a boolean`);
+        }
+        out.workspaceWriteNetworkAccess = workspaceWriteNetworkAccess;
+    }
+    if (webSearch !== undefined) {
+        if (typeof webSearch !== 'boolean') {
+            throw new Error(`${context}.webSearch must be a boolean`);
+        }
+        out.webSearch = webSearch;
+    }
+    return out;
+}
+export function parseRuntime(value, context) {
+    if (!isObject(value)) {
+        throw new Error(`${context} must be an object`);
+    }
+    const { harness, model, systemPrompt, harnessSettings, claudeMd, claudeMdMode, agentsMd, agentsMdMode, claudeMdContent, agentsMdContent } = value;
+    if (!isHarness(harness)) {
+        throw new Error(`${context}.harness must be one of: ${HARNESS_VALUES.join(', ')}`);
+    }
+    if (typeof model !== 'string' || !model.trim()) {
+        throw new Error(`${context}.model must be a non-empty string`);
+    }
+    if (typeof systemPrompt !== 'string' || !systemPrompt.trim()) {
+        throw new Error(`${context}.systemPrompt must be a non-empty string`);
+    }
+    const parsedHarnessSettings = parseHarnessSettings(harnessSettings, `${context}.harnessSettings`);
+    if (claudeMd !== undefined)
+        assertSidecarPath(claudeMd, `${context}.claudeMd`);
+    if (agentsMd !== undefined)
+        assertSidecarPath(agentsMd, `${context}.agentsMd`);
+    if (claudeMdMode !== undefined && !isSidecarMode(claudeMdMode)) {
+        throw new Error(`${context}.claudeMdMode must be one of: ${SIDECAR_MD_MODES.join(', ')}`);
+    }
+    if (agentsMdMode !== undefined && !isSidecarMode(agentsMdMode)) {
+        throw new Error(`${context}.agentsMdMode must be one of: ${SIDECAR_MD_MODES.join(', ')}`);
+    }
+    // Mode is allowed without a same-level path: a tier may declare just
+    // `claudeMdMode` and inherit the path from the spec top-level (or vice
+    // versa). The cascade validates that a path/content actually exists at
+    // runtime — a stranded mode with no path anywhere becomes a no-op.
+    if (claudeMdContent !== undefined && (typeof claudeMdContent !== 'string' || !claudeMdContent.length)) {
+        throw new Error(`${context}.claudeMdContent must be a non-empty string`);
+    }
+    if (agentsMdContent !== undefined && (typeof agentsMdContent !== 'string' || !agentsMdContent.length)) {
+        throw new Error(`${context}.agentsMdContent must be a non-empty string`);
+    }
+    return {
+        harness,
+        model,
+        systemPrompt,
+        harnessSettings: parsedHarnessSettings,
+        ...(typeof claudeMd === 'string' ? { claudeMd } : {}),
+        ...(claudeMdMode ? { claudeMdMode: claudeMdMode } : {}),
+        ...(typeof agentsMd === 'string' ? { agentsMd } : {}),
+        ...(agentsMdMode ? { agentsMdMode: agentsMdMode } : {}),
+        ...(typeof claudeMdContent === 'string' ? { claudeMdContent } : {}),
+        ...(typeof agentsMdContent === 'string' ? { agentsMdContent } : {})
+    };
+}
+export function parseSkills(value, context) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(`${context} must be an array if provided`);
+    }
+    return value.map((entry, idx) => {
+        const entryContext = `${context}[${idx}]`;
+        if (!isObject(entry)) {
+            throw new Error(`${entryContext} must be an object`);
+        }
+        const { id, source, description } = entry;
+        if (typeof id !== 'string' || !id.trim()) {
+            throw new Error(`${entryContext}.id must be a non-empty string`);
+        }
+        if (typeof source !== 'string' || !source.trim()) {
+            throw new Error(`${entryContext}.source must be a non-empty string`);
+        }
+        if (typeof description !== 'string' || !description.trim()) {
+            throw new Error(`${entryContext}.description must be a non-empty string`);
+        }
+        return { id, source, description };
+    });
+}
+export function parseStringList(value, context) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value)) {
+        throw new Error(`${context} must be an array if provided`);
+    }
+    const parsed = value.map((entry, idx) => {
+        if (typeof entry !== 'string' || !entry.trim()) {
+            throw new Error(`${context}[${idx}] must be a non-empty string`);
+        }
+        return entry;
+    });
+    return parsed.length > 0 ? parsed : undefined;
+}
+export function parseMount(value, context) {
+    if (value === undefined)
+        return undefined;
+    if (!isObject(value)) {
+        throw new Error(`${context} must be an object if provided`);
+    }
+    const ignoredPatterns = parseStringList(value.ignoredPatterns, `${context}.ignoredPatterns`);
+    const readonlyPatterns = parseStringList(value.readonlyPatterns, `${context}.readonlyPatterns`);
+    return ignoredPatterns || readonlyPatterns
+        ? {
+            ...(ignoredPatterns ? { ignoredPatterns } : {}),
+            ...(readonlyPatterns ? { readonlyPatterns } : {})
+        }
+        : undefined;
+}
+export const INPUT_NAME_RE = /^[A-Z_][A-Z0-9_]*$/;
+export function assertInputName(name, context) {
+    if (!INPUT_NAME_RE.test(name)) {
+        throw new Error(`${context} must be an env-style name matching ${INPUT_NAME_RE.source}`);
+    }
+}
+export function parseInputs(value, context) {
+    if (value === undefined)
+        return undefined;
+    if (!isObject(value)) {
+        throw new Error(`${context} must be an object if provided`);
+    }
+    const out = {};
+    for (const [name, raw] of Object.entries(value)) {
+        assertInputName(name, `${context}.${name}`);
+        if (typeof raw === 'string') {
+            if (!raw) {
+                throw new Error(`${context}.${name} default must be non-empty`);
+            }
+            out[name] = { default: raw };
+            continue;
+        }
+        if (!isObject(raw)) {
+            throw new Error(`${context}.${name} must be a string default or an object`);
+        }
+        const { description, env, default: defaultValue, optional } = raw;
+        const parsed = {};
+        if (description !== undefined) {
+            if (typeof description !== 'string' || !description.trim()) {
+                throw new Error(`${context}.${name}.description must be a non-empty string if provided`);
+            }
+            parsed.description = description;
+        }
+        if (env !== undefined) {
+            if (typeof env !== 'string' || !env.trim()) {
+                throw new Error(`${context}.${name}.env must be a non-empty string if provided`);
+            }
+            assertInputName(env, `${context}.${name}.env`);
+            parsed.env = env;
+        }
+        if (defaultValue !== undefined) {
+            if (typeof defaultValue !== 'string' || !defaultValue) {
+                throw new Error(`${context}.${name}.default must be a non-empty string if provided`);
+            }
+            parsed.default = defaultValue;
+        }
+        if (optional !== undefined) {
+            if (typeof optional !== 'boolean') {
+                throw new Error(`${context}.${name}.optional must be a boolean if provided`);
+            }
+            if (optional && parsed.default !== undefined) {
+                throw new Error(`${context}.${name} cannot set both 'optional: true' and 'default' — pick one (defaults already make an input always-resolved)`);
+            }
+            parsed.optional = optional;
+        }
+        out[name] = parsed;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function parsePermissions(value, context) {
+    if (value === undefined)
+        return undefined;
+    if (!isObject(value)) {
+        throw new Error(`${context} must be an object if provided`);
+    }
+    const out = {};
+    const { allow, deny, mode } = value;
+    if (allow !== undefined) {
+        if (!Array.isArray(allow) || allow.some((s) => typeof s !== 'string' || !s.trim())) {
+            throw new Error(`${context}.allow must be an array of non-empty strings`);
+        }
+        out.allow = allow;
+    }
+    if (deny !== undefined) {
+        if (!Array.isArray(deny) || deny.some((s) => typeof s !== 'string' || !s.trim())) {
+            throw new Error(`${context}.deny must be an array of non-empty strings`);
+        }
+        out.deny = deny;
+    }
+    if (mode !== undefined) {
+        if (!PERMISSION_MODES.includes(mode)) {
+            throw new Error(`${context}.mode must be one of: ${PERMISSION_MODES.join(', ')}`);
+        }
+        out.mode = mode;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function parseStringMap(value, context) {
+    if (value === undefined)
+        return undefined;
+    if (!isObject(value)) {
+        throw new Error(`${context} must be an object if provided`);
+    }
+    const out = {};
+    for (const [key, v] of Object.entries(value)) {
+        if (typeof v !== 'string') {
+            throw new Error(`${context}.${key} must be a string`);
+        }
+        out[key] = v;
+    }
+    return out;
+}
+export function parseMcpServers(value, context) {
+    if (value === undefined)
+        return undefined;
+    if (!isObject(value)) {
+        throw new Error(`${context} must be an object if provided`);
+    }
+    const out = {};
+    for (const [name, raw] of Object.entries(value)) {
+        if (!isObject(raw)) {
+            throw new Error(`${context}.${name} must be an object`);
+        }
+        const type = raw.type;
+        if (type === 'http' || type === 'sse') {
+            if (typeof raw.url !== 'string' || !raw.url.trim()) {
+                throw new Error(`${context}.${name}.url must be a non-empty string for type=${type}`);
+            }
+            const headers = parseStringMap(raw.headers, `${context}.${name}.headers`);
+            out[name] = { type, url: raw.url, ...(headers ? { headers } : {}) };
+        }
+        else if (type === 'stdio') {
+            if (typeof raw.command !== 'string' || !raw.command.trim()) {
+                throw new Error(`${context}.${name}.command must be a non-empty string for type=stdio`);
+            }
+            const args = raw.args;
+            if (args !== undefined && (!Array.isArray(args) || args.some((a) => typeof a !== 'string'))) {
+                throw new Error(`${context}.${name}.args must be an array of strings`);
+            }
+            const env = parseStringMap(raw.env, `${context}.${name}.env`);
+            out[name] = {
+                type: 'stdio',
+                command: raw.command,
+                ...(args ? { args: args } : {}),
+                ...(env ? { env } : {})
+            };
+        }
+        else {
+            throw new Error(`${context}.${name}.type must be one of: http, sse, stdio`);
+        }
+    }
+    return out;
+}
+export function parsePersonaSpec(value, expectedIntent) {
+    if (!isObject(value)) {
+        throw new Error(`persona[${expectedIntent}] must be an object`);
+    }
+    const { id, intent, tags, description, tiers, defaultTier, skills, inputs, env, mcpServers, permissions, mount, claudeMd, claudeMdMode, agentsMd, agentsMdMode, claudeMdContent, agentsMdContent } = value;
+    if (typeof id !== 'string' || !id.trim()) {
+        throw new Error(`persona[${expectedIntent}].id must be a non-empty string`);
+    }
+    if (!isIntent(intent)) {
+        throw new Error(`persona[${expectedIntent}].intent is invalid`);
+    }
+    if (intent !== expectedIntent) {
+        throw new Error(`persona[${expectedIntent}] intent mismatch: got ${intent}`);
+    }
+    const parsedTags = parseTags(tags, `persona[${expectedIntent}].tags`);
+    if (typeof description !== 'string' || !description.trim()) {
+        throw new Error(`persona[${expectedIntent}].description must be a non-empty string`);
+    }
+    if (!isObject(tiers)) {
+        throw new Error(`persona[${expectedIntent}].tiers must be an object`);
+    }
+    const parsedTiers = {};
+    for (const tier of PERSONA_TIERS) {
+        parsedTiers[tier] = parseRuntime(tiers[tier], `persona[${expectedIntent}].tiers.${tier}`);
+    }
+    let parsedDefaultTier;
+    if (defaultTier !== undefined) {
+        if (!isTier(defaultTier)) {
+            throw new Error(`persona[${expectedIntent}].defaultTier must be one of: ${PERSONA_TIERS.join(', ')}`);
+        }
+        parsedDefaultTier = defaultTier;
+    }
+    const parsedSkills = parseSkills(skills, `persona[${expectedIntent}].skills`);
+    const parsedInputs = parseInputs(inputs, `persona[${expectedIntent}].inputs`);
+    const parsedEnv = parseStringMap(env, `persona[${expectedIntent}].env`);
+    const parsedMcpServers = parseMcpServers(mcpServers, `persona[${expectedIntent}].mcpServers`);
+    const parsedPermissions = parsePermissions(permissions, `persona[${expectedIntent}].permissions`);
+    const parsedMount = parseMount(mount, `persona[${expectedIntent}].mount`);
+    if (claudeMd !== undefined)
+        assertSidecarPath(claudeMd, `persona[${expectedIntent}].claudeMd`);
+    if (agentsMd !== undefined)
+        assertSidecarPath(agentsMd, `persona[${expectedIntent}].agentsMd`);
+    if (claudeMdMode !== undefined && !isSidecarMode(claudeMdMode)) {
+        throw new Error(`persona[${expectedIntent}].claudeMdMode must be one of: ${SIDECAR_MD_MODES.join(', ')}`);
+    }
+    if (agentsMdMode !== undefined && !isSidecarMode(agentsMdMode)) {
+        throw new Error(`persona[${expectedIntent}].agentsMdMode must be one of: ${SIDECAR_MD_MODES.join(', ')}`);
+    }
+    // Spec-level mode without a spec-level path is allowed — a tier may
+    // supply the path while inheriting the mode here. See parseRuntime.
+    if (claudeMdContent !== undefined &&
+        (typeof claudeMdContent !== 'string' || !claudeMdContent.length)) {
+        throw new Error(`persona[${expectedIntent}].claudeMdContent must be a non-empty string`);
+    }
+    if (agentsMdContent !== undefined &&
+        (typeof agentsMdContent !== 'string' || !agentsMdContent.length)) {
+        throw new Error(`persona[${expectedIntent}].agentsMdContent must be a non-empty string`);
+    }
+    return {
+        id,
+        intent,
+        tags: parsedTags,
+        description,
+        skills: parsedSkills,
+        ...(parsedInputs ? { inputs: parsedInputs } : {}),
+        tiers: parsedTiers,
+        ...(parsedDefaultTier ? { defaultTier: parsedDefaultTier } : {}),
+        ...(parsedEnv ? { env: parsedEnv } : {}),
+        ...(parsedMcpServers ? { mcpServers: parsedMcpServers } : {}),
+        ...(parsedPermissions ? { permissions: parsedPermissions } : {}),
+        ...(parsedMount ? { mount: parsedMount } : {}),
+        ...(typeof claudeMd === 'string' ? { claudeMd } : {}),
+        ...(claudeMdMode ? { claudeMdMode: claudeMdMode } : {}),
+        ...(typeof agentsMd === 'string' ? { agentsMd } : {}),
+        ...(agentsMdMode ? { agentsMdMode: agentsMdMode } : {}),
+        ...(typeof claudeMdContent === 'string' ? { claudeMdContent } : {}),
+        ...(typeof agentsMdContent === 'string' ? { agentsMdContent } : {})
+    };
+}
+/**
+ * Resolve the effective sidecar config for a (spec, tier) pair.
+ *
+ * Path-or-content resolution: each sidecar (`claude*`, `agents*`) is a
+ * single "channel" — its `*Md` and `*MdContent` fields are tied together
+ * and travel as a unit through the cascade. If the tier-level runtime
+ * declares EITHER `claudeMd` or `claudeMdContent`, the tier owns the
+ * channel and the top-level path/content is ignored (otherwise a tier
+ * path override would silently lose to inherited inlined content, since
+ * downstream consumers prefer Content over a path).
+ *
+ * Mode resolution: independent — a tier can set just `claudeMdMode` and
+ * inherit the top-level path. Defaults to `overwrite` if neither layer
+ * sets a mode. Modes are only meaningful when a path/content is present.
+ */
+export function resolveSidecar(spec, tier) {
+    const runtime = spec.tiers[tier];
+    const tierOwnsClaude = runtime.claudeMd !== undefined || runtime.claudeMdContent !== undefined;
+    const tierOwnsAgents = runtime.agentsMd !== undefined || runtime.agentsMdContent !== undefined;
+    const claudePath = tierOwnsClaude ? runtime.claudeMd : spec.claudeMd;
+    const claudeContent = tierOwnsClaude ? runtime.claudeMdContent : spec.claudeMdContent;
+    const agentsPath = tierOwnsAgents ? runtime.agentsMd : spec.agentsMd;
+    const agentsContent = tierOwnsAgents ? runtime.agentsMdContent : spec.agentsMdContent;
+    return {
+        ...(claudePath ? { claudeMd: claudePath } : {}),
+        ...(claudeContent ? { claudeMdContent: claudeContent } : {}),
+        claudeMdMode: runtime.claudeMdMode ?? spec.claudeMdMode ?? 'overwrite',
+        ...(agentsPath ? { agentsMd: agentsPath } : {}),
+        ...(agentsContent ? { agentsMdContent: agentsContent } : {}),
+        agentsMdMode: runtime.agentsMdMode ?? spec.agentsMdMode ?? 'overwrite'
+    };
+}
+export function sidecarSelectionFields(sidecar) {
+    return {
+        ...(sidecar.claudeMd ? { claudeMd: sidecar.claudeMd } : {}),
+        ...(sidecar.claudeMdContent ? { claudeMdContent: sidecar.claudeMdContent } : {}),
+        ...(sidecar.claudeMd || sidecar.claudeMdContent
+            ? { claudeMdMode: sidecar.claudeMdMode }
+            : {}),
+        ...(sidecar.agentsMd ? { agentsMd: sidecar.agentsMd } : {}),
+        ...(sidecar.agentsMdContent ? { agentsMdContent: sidecar.agentsMdContent } : {}),
+        ...(sidecar.agentsMd || sidecar.agentsMdContent
+            ? { agentsMdMode: sidecar.agentsMdMode }
+            : {})
+    };
+}
+export function deepFreeze(value) {
+    if (value === null || value === undefined || typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        for (const entry of value) {
+            deepFreeze(entry);
+        }
+        return Object.freeze(value);
+    }
+    for (const nested of Object.values(value)) {
+        deepFreeze(nested);
+    }
+    return Object.freeze(value);
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/dist/plan.d.ts

@@ -0,0 +1,118 @@
+import { type InteractiveConfigFile } from './interactive-spec.js';
+import type { Harness, PersonaSelection, SidecarMdMode, SkillMaterializationPlan } from './types.js';
+/**
+ * Alias of {@link PersonaSelection}. The orchestration API names the
+ * fully-resolved persona "ResolvedPersona" because callers think of a
+ * spawn plan as "what runs", not "what was selected from the catalog".
+ */
+export type ResolvedPersona = PersonaSelection;
+/**
+ * Mount policy resolved against any caller dotfiles / extra patterns.
+ * The plan carries this through verbatim; the executor passes it to the
+ * mount provider (e.g. {@link import('./mount.js').applyPersonaMount}).
+ */
+export interface ResolvedMountPolicy {
+    ignoredPatterns: string[];
+    readonlyPatterns: string[];
+}
+/**
+ * Sidecar markdown the executor must write into the harness cwd. The body
+ * is supplied either inline (built-in personas, where the catalog generator
+ * already inlined the markdown) or by absolute path (local/pack personas
+ * that ship the sidecar as a sibling file). The path form keeps the plan
+ * JSON-serializable; the executor reads the file at write time.
+ */
+export type ResolvedSidecarWrite = {
+    /** Filename inside the cwd: `CLAUDE.md` (claude) or `AGENTS.md` (opencode/codex). */
+    filename: 'CLAUDE.md' | 'AGENTS.md';
+    /**
+     * `overwrite` writes verbatim; `extend` appends a `\n\n---\n\n`-joined
+     * suffix onto whatever already exists at the destination at execute time.
+     */
+    mode: SidecarMdMode;
+} & ({
+    /** Inlined body. */
+    contents: string;
+    sourcePath?: never;
+} | {
+    /** Absolute path to read at execute time. */
+    sourcePath: string;
+    contents?: never;
+});
+/** Per-input env binding to merge into the spawn env. */
+export interface ResolvedInputBinding {
+    name: string;
+    /** Env-var name to bind under. Falls back to `name` when the spec omits one. */
+    envName: string;
+    value: string;
+}
+export interface PersonaSpawnPlan {
+    /** The fully resolved persona this plan was built from. */
+    persona: ResolvedPersona;
+    /** Which CLI to spawn (`claude` | `codex` | `opencode`). */
+    cli: Harness;
+    /** argv (excluding the cli itself) that the harness should be spawned with. */
+    args: string[];
+    /** Optional initial prompt — used by codex's argv-driven prompt mode. */
+    initialPrompt?: string;
+    /** MCP / harness config files to materialize before spawn (and restore after). */
+    configFiles: InteractiveConfigFile[];
+    /** Pure skills install plan (from {@link materializeSkills}). */
+    skills: SkillMaterializationPlan;
+    /** Resolved mount policy, or undefined if the persona declares none. */
+    mount?: ResolvedMountPolicy;
+    /** Sidecar markdown writes (claudeMd / agentsMd) staged for the run. */
+    sidecars: ResolvedSidecarWrite[];
+    /** Inputs as resolved env bindings, ready to merge into spawn env. */
+    inputs: ResolvedInputBinding[];
+    /**
+     * Final env (process.env merged with input bindings + persona env, with
+     * persona env winning on conflict). Always materialized so callers do not
+     * need to re-merge by hand.
+     */
+    env: Record<string, string>;
+}
+export interface PlanOptions {
+    /**
+     * Stage skills under this absolute directory instead of the repo's
+     * `.claude/skills/`. Claude harness only — throws otherwise (matching the
+     * existing {@link materializeSkills} behavior).
+     */
+    installRoot?: string;
+    /** Extra env bindings to merge in. Persona env wins on conflict. */
+    envOverrides?: Record<string, string>;
+    /**
+     * Process env to read input env-var fallbacks from (default: process.env).
+     * **Captured into `plan.env`.** The plan is JSON-serializable, so passing
+     * `process.env` here will inline ambient values (potentially including
+     * secrets) into the serialized plan — set `includeProcessEnv` only when
+     * you intend to forward ambient env to the harness, and prefer supplying
+     * a curated snapshot via {@link processEnv}.
+     */
+    processEnv?: NodeJS.ProcessEnv;
+    /**
+     * Opt in to capturing ambient {@link processEnv} into `plan.env`. Default
+     * `false`: when omitted, `plan.env` contains only persona-author env,
+     * resolved input bindings, and {@link envOverrides}. When `true` and no
+     * explicit {@link processEnv} is supplied, `process.env` is captured.
+     */
+    includeProcessEnv?: boolean;
+    /**
+     * Caller-supplied input values (highest precedence over env/default). Same
+     * shape as {@link import('./inputs.js').resolvePersonaInputs}'s `provided`.
+     */
+    inputValues?: Record<string, string | number | boolean | null | undefined>;
+}
+/**
+ * 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 declare function buildPersonaSpawnPlan(persona: ResolvedPersona, options?: PlanOptions): PersonaSpawnPlan;
+//# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGzF,OAAO,KAAK,EACV,OAAO,EAGP,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,qFAAqF;IACrF,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC;IACpC;;;OAGG;IACH,IAAI,EAAE,aAAa,CAAC;CACrB,GAAG,CACA;IACE,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,GACD;IACE,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,CACJ,CAAC;AAEF,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,OAAO,EAAE,eAAe,CAAC;IACzB,4DAA4D;IAC5D,GAAG,EAAE,OAAO,CAAC;IACb,+EAA+E;IAC/E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,iEAAiE;IACjE,MAAM,EAAE,wBAAwB,CAAC;IACjC,wEAAwE;IACxE,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,sEAAsE;IACtE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CAC5E;AA8ED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,WAAgB,GACxB,gBAAgB,CA8ElB"}