helixmind 0.5.4

package/dist/cli/agent/plan-engine.js

@@ -0,0 +1,261 @@
+/**
+ * Plan Engine — core plan lifecycle management.
+ *
+ * Creates, approves, rejects, modifies, and tracks execution of plans.
+ * Plans can originate from user plan mode, Jarvis proposals, or auto-complex tasks.
+ */
+import { randomUUID } from 'node:crypto';
+export class PlanEngine {
+    plans = new Map();
+    _activePlanId = null;
+    onChange;
+    constructor(onChange) {
+        this.onChange = onChange;
+    }
+    /** Set the change callback (for pushing events to Brain/Web) */
+    setOnChange(handler) {
+        this.onChange = handler;
+    }
+    /**
+     * Create a plan from an LLM-generated response (parsed JSON).
+     */
+    createFromLLMResponse(parsed, source = 'user_plan_mode') {
+        const steps = parsed.steps.map((s, idx) => ({
+            id: idx,
+            title: s.title,
+            description: s.description,
+            tools: s.tools ?? [],
+            affectedFiles: s.affectedFiles ?? [],
+            dependencies: s.dependencies ?? [],
+            status: 'pending',
+        }));
+        const plan = {
+            id: randomUUID(),
+            title: parsed.title,
+            description: parsed.description,
+            steps,
+            status: 'pending_approval',
+            source,
+            createdAt: Date.now(),
+            totalStepsCompleted: 0,
+            totalStepsFailed: 0,
+        };
+        this.plans.set(plan.id, plan);
+        this.onChange?.('plan_created', plan);
+        return plan;
+    }
+    /**
+     * Parse an LLM text response to extract a JSON plan.
+     * Looks for ```json ... ``` blocks containing the plan structure.
+     */
+    parseLLMPlan(llmText) {
+        // Extract JSON from code blocks
+        const jsonMatch = llmText.match(/```json\s*\n([\s\S]*?)\n\s*```/);
+        if (!jsonMatch)
+            return null;
+        try {
+            const parsed = JSON.parse(jsonMatch[1]);
+            if (!parsed.title || !Array.isArray(parsed.steps))
+                return null;
+            return parsed;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Create a plan from a Jarvis ProposalEntry.
+     */
+    createFromProposal(proposal) {
+        const steps = proposal.steps
+            ? proposal.steps.map((s, idx) => ({
+                id: idx,
+                title: s.title,
+                description: s.description,
+                tools: [],
+                affectedFiles: s.affectedFiles,
+                dependencies: s.dependencies,
+                status: 'pending',
+            }))
+            : [{
+                    id: 0,
+                    title: proposal.title,
+                    description: proposal.description,
+                    tools: [],
+                    affectedFiles: proposal.affectedFiles,
+                    dependencies: [],
+                    status: 'pending',
+                }];
+        const plan = {
+            id: randomUUID(),
+            title: proposal.title,
+            description: proposal.description,
+            steps,
+            status: 'pending_approval',
+            source: 'jarvis_proposal',
+            createdAt: Date.now(),
+            totalStepsCompleted: 0,
+            totalStepsFailed: 0,
+            proposalId: proposal.id,
+        };
+        this.plans.set(plan.id, plan);
+        this.onChange?.('plan_created', plan);
+        return plan;
+    }
+    /** Approve a plan — marks it ready for execution */
+    approve(planId) {
+        const plan = this.plans.get(planId);
+        if (!plan || plan.status !== 'pending_approval')
+            return undefined;
+        plan.status = 'approved';
+        plan.approvedAt = Date.now();
+        this._activePlanId = planId;
+        this.onChange?.('plan_approved', plan);
+        return plan;
+    }
+    /** Reject a plan with a reason */
+    reject(planId, reason) {
+        const plan = this.plans.get(planId);
+        if (!plan || plan.status !== 'pending_approval')
+            return undefined;
+        plan.status = 'rejected';
+        plan.rejectionReason = reason;
+        if (this._activePlanId === planId)
+            this._activePlanId = null;
+        this.onChange?.('plan_rejected', plan);
+        return plan;
+    }
+    /** Modify a specific step in a pending plan */
+    modifyStep(planId, stepId, changes) {
+        const plan = this.plans.get(planId);
+        if (!plan || (plan.status !== 'pending_approval' && plan.status !== 'modified'))
+            return false;
+        const step = plan.steps.find(s => s.id === stepId);
+        if (!step)
+            return false;
+        Object.assign(step, changes);
+        plan.status = 'modified';
+        this.onChange?.('plan_modified', plan);
+        return true;
+    }
+    /** Mark a plan as executing */
+    startExecution(planId) {
+        const plan = this.plans.get(planId);
+        if (!plan || (plan.status !== 'approved' && plan.status !== 'modified'))
+            return undefined;
+        plan.status = 'executing';
+        this._activePlanId = planId;
+        this.onChange?.('plan_executing', plan);
+        return plan;
+    }
+    /** Get the next step that is ready to execute (all dependencies met) */
+    getNextStep(planId) {
+        const plan = this.plans.get(planId);
+        if (!plan)
+            return undefined;
+        for (const step of plan.steps) {
+            if (step.status !== 'pending')
+                continue;
+            // Check all dependencies are completed
+            const depsOk = step.dependencies.every(depId => {
+                const dep = plan.steps.find(s => s.id === depId);
+                return dep && dep.status === 'done';
+            });
+            if (depsOk)
+                return step;
+        }
+        return undefined;
+    }
+    /** Get ALL steps that are ready to execute (all dependencies met) — used by swarm */
+    getAllReadySteps(planId) {
+        const plan = this.plans.get(planId);
+        if (!plan)
+            return [];
+        return plan.steps.filter(step => {
+            if (step.status !== 'pending')
+                return false;
+            return step.dependencies.every(depId => {
+                const dep = plan.steps.find(s => s.id === depId);
+                return dep && dep.status === 'done';
+            });
+        });
+    }
+    /** Mark a step as running */
+    startStep(planId, stepId) {
+        const plan = this.plans.get(planId);
+        if (!plan)
+            return;
+        const step = plan.steps.find(s => s.id === stepId);
+        if (!step)
+            return;
+        step.status = 'running';
+        step.startedAt = Date.now();
+        this.onChange?.('plan_step_started', plan);
+    }
+    /** Mark a step as completed */
+    completeStep(planId, stepId, result) {
+        const plan = this.plans.get(planId);
+        if (!plan)
+            return;
+        const step = plan.steps.find(s => s.id === stepId);
+        if (!step)
+            return;
+        step.status = 'done';
+        step.result = result;
+        step.completedAt = Date.now();
+        plan.totalStepsCompleted++;
+        // Check if plan is complete
+        const allDone = plan.steps.every(s => s.status === 'done' || s.status === 'skipped');
+        if (allDone) {
+            plan.status = 'completed';
+            plan.completedAt = Date.now();
+            if (this._activePlanId === planId)
+                this._activePlanId = null;
+        }
+        this.onChange?.('plan_step_completed', plan);
+    }
+    /** Mark a step as failed */
+    failStep(planId, stepId, error) {
+        const plan = this.plans.get(planId);
+        if (!plan)
+            return;
+        const step = plan.steps.find(s => s.id === stepId);
+        if (!step)
+            return;
+        step.status = 'error';
+        step.error = error;
+        step.completedAt = Date.now();
+        plan.totalStepsFailed++;
+        // Mark plan as failed if a step fails
+        plan.status = 'failed';
+        plan.completedAt = Date.now();
+        if (this._activePlanId === planId)
+            this._activePlanId = null;
+        this.onChange?.('plan_step_failed', plan);
+    }
+    /** Get the currently active plan */
+    getActive() {
+        if (!this._activePlanId)
+            return undefined;
+        return this.plans.get(this._activePlanId);
+    }
+    /** Get a plan by ID */
+    get(planId) {
+        return this.plans.get(planId);
+    }
+    /** Get all plans */
+    getAll() {
+        return [...this.plans.values()];
+    }
+    /** Clear completed/rejected plans from memory */
+    pruneOld() {
+        for (const [id, plan] of this.plans) {
+            if (plan.status === 'completed' || plan.status === 'rejected' || plan.status === 'failed') {
+                if (Date.now() - (plan.completedAt ?? plan.createdAt) > 60 * 60 * 1000) {
+                    this.plans.delete(id);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=plan-engine.js.map

package/dist/cli/agent/plan-engine.js.map

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

package/dist/cli/agent/plan-executor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Plan Executor — runs an approved plan step-by-step via the agent loop.
+ *
+ * Each step gets its own agent loop iteration with a focused prompt.
+ * History is shared between steps to maintain context.
+ */
+import type { ToolMessage } from '../providers/types.js';
+import type { AgentLoopOptions, AgentLoopResult } from './loop.js';
+import type { AgentController } from './loop.js';
+import type { ExecutionPlan, PlanStep } from './plan-types.js';
+import type { PlanEngine } from './plan-engine.js';
+export interface PlanExecutorCallbacks {
+    onPlanStepStart?: (step: PlanStep, idx: number, total: number) => void;
+    onPlanStepEnd?: (step: PlanStep, status: 'done' | 'error') => void;
+    onPlanComplete?: (plan: ExecutionPlan) => void;
+}
+/**
+ * Execute an approved plan step-by-step.
+ *
+ * For each step:
+ * 1. Fire onPlanStepStart callback
+ * 2. Build a focused prompt for just that step
+ * 3. Run the agent loop (with full tool access)
+ * 4. Mark step complete/failed in the engine
+ * 5. Fire onPlanStepEnd callback
+ *
+ * History carries across steps so the LLM maintains full context.
+ */
+export declare function executePlan(opts: {
+    plan: ExecutionPlan;
+    planEngine: PlanEngine;
+    agentLoopOptions: Omit<AgentLoopOptions, 'planMode'>;
+    controller: AgentController;
+    conversationHistory: ToolMessage[];
+    callbacks?: PlanExecutorCallbacks;
+}): Promise<AgentLoopResult>;
+//# sourceMappingURL=plan-executor.d.ts.map

package/dist/cli/agent/plan-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-executor.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/plan-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC;IACnE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IACrD,UAAU,EAAE,eAAe,CAAC;IAC5B,mBAAmB,EAAE,WAAW,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC,GAAG,OAAO,CAAC,eAAe,CAAC,CAqF3B"}

package/dist/cli/agent/plan-executor.js

@@ -0,0 +1,105 @@
+import { runAgentLoop, AgentAbortError } from './loop.js';
+/**
+ * Execute an approved plan step-by-step.
+ *
+ * For each step:
+ * 1. Fire onPlanStepStart callback
+ * 2. Build a focused prompt for just that step
+ * 3. Run the agent loop (with full tool access)
+ * 4. Mark step complete/failed in the engine
+ * 5. Fire onPlanStepEnd callback
+ *
+ * History carries across steps so the LLM maintains full context.
+ */
+export async function executePlan(opts) {
+    const { plan, planEngine, agentLoopOptions, controller, callbacks } = opts;
+    let history = [...opts.conversationHistory];
+    planEngine.startExecution(plan.id);
+    let totalToolCalls = 0;
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    const allSteps = [];
+    const allErrors = [];
+    let lastText = '';
+    const totalSteps = plan.steps.length;
+    while (true) {
+        const step = planEngine.getNextStep(plan.id);
+        if (!step)
+            break;
+        // Check abort
+        if (controller.isAborted) {
+            throw new AgentAbortError();
+        }
+        const stepIdx = plan.steps.indexOf(step);
+        callbacks?.onPlanStepStart?.(step, stepIdx + 1, totalSteps);
+        planEngine.startStep(plan.id, step.id);
+        // Build a focused prompt for this step
+        const stepPrompt = buildStepPrompt(step, stepIdx + 1, totalSteps, plan);
+        try {
+            const result = await runAgentLoop(stepPrompt, history, {
+                ...agentLoopOptions,
+                planMode: false, // Full tool access during execution
+                maxIterations: 50,
+            }, controller);
+            // Adopt updated history for next step
+            history = result.updatedHistory;
+            // Accumulate results
+            totalToolCalls += result.toolCalls;
+            totalInputTokens += result.tokensUsed.input;
+            totalOutputTokens += result.tokensUsed.output;
+            allSteps.push(...result.steps);
+            allErrors.push(...result.errors);
+            lastText = result.text;
+            if (result.errors.length > 0 && result.steps.some(s => s.status === 'error')) {
+                planEngine.failStep(plan.id, step.id, result.errors.join('; '));
+                callbacks?.onPlanStepEnd?.(step, 'error');
+                break; // Stop on first failure
+            }
+            else {
+                planEngine.completeStep(plan.id, step.id, result.text.slice(0, 200));
+                callbacks?.onPlanStepEnd?.(step, 'done');
+            }
+        }
+        catch (err) {
+            if (err instanceof AgentAbortError) {
+                planEngine.failStep(plan.id, step.id, 'Aborted by user');
+                throw err;
+            }
+            const errMsg = err instanceof Error ? err.message : String(err);
+            planEngine.failStep(plan.id, step.id, errMsg);
+            callbacks?.onPlanStepEnd?.(step, 'error');
+            allErrors.push(errMsg);
+            break;
+        }
+    }
+    // Check if plan completed
+    const updatedPlan = planEngine.get(plan.id);
+    if (updatedPlan.status === 'completed') {
+        callbacks?.onPlanComplete?.(updatedPlan);
+    }
+    return {
+        text: lastText,
+        toolCalls: totalToolCalls,
+        tokensUsed: { input: totalInputTokens, output: totalOutputTokens },
+        aborted: false,
+        steps: allSteps,
+        errors: allErrors,
+        updatedHistory: history,
+    };
+}
+/** Build a focused execution prompt for a single plan step */
+function buildStepPrompt(step, stepNum, totalSteps, plan) {
+    const lines = [];
+    lines.push(`Execute step ${stepNum} of ${totalSteps} in plan "${plan.title}":`);
+    lines.push('');
+    lines.push(`## Step: ${step.title}`);
+    lines.push(step.description);
+    if (step.affectedFiles.length > 0) {
+        lines.push('');
+        lines.push(`Target files: ${step.affectedFiles.join(', ')}`);
+    }
+    lines.push('');
+    lines.push('Complete this step fully, then stop. Do not proceed to subsequent steps.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=plan-executor.js.map

package/dist/cli/agent/plan-executor.js.map

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

package/dist/cli/agent/plan-types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Plan Mode Types & Agent Identity definitions.
+ *
+ * Plan Mode lets the agent first explore (read-only), then present a structured
+ * plan, then execute step-by-step after user approval.
+ *
+ * Agent Identities provide colored @names for all agents/sessions.
+ */
+export type PlanStepStatus = 'pending' | 'running' | 'done' | 'error' | 'skipped';
+export interface PlanStep {
+    id: number;
+    title: string;
+    description: string;
+    tools: string[];
+    affectedFiles: string[];
+    dependencies: number[];
+    status: PlanStepStatus;
+    result?: string;
+    error?: string;
+    startedAt?: number;
+    completedAt?: number;
+}
+export type PlanStatus = 'drafting' | 'pending_approval' | 'approved' | 'executing' | 'completed' | 'failed' | 'rejected' | 'modified';
+export interface ExecutionPlan {
+    id: string;
+    title: string;
+    description: string;
+    steps: PlanStep[];
+    status: PlanStatus;
+    source: 'user_plan_mode' | 'jarvis_proposal' | 'auto_complex';
+    createdAt: number;
+    approvedAt?: number;
+    completedAt?: number;
+    rejectionReason?: string;
+    totalStepsCompleted: number;
+    totalStepsFailed: number;
+    proposalId?: number;
+}
+export type PlanModeState = 'off' | 'planning' | 'reviewing' | 'executing';
+export declare const PLAN_MODE_TOOLS: Set<string>;
+export interface AgentIdentity {
+    name: string;
+    displayName: string;
+    color: string;
+    icon: string;
+}
+export declare const AGENT_IDENTITIES: Record<string, AgentIdentity>;
+/** Resolve a session name to its AgentIdentity (case-insensitive, partial match) */
+export declare function resolveAgentIdentity(sessionName: string): AgentIdentity | undefined;
+//# sourceMappingURL=plan-types.d.ts.map

package/dist/cli/agent/plan-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-types.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/plan-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAElF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,kBAAkB,GAClB,UAAU,GACV,WAAW,GACX,WAAW,GACX,QAAQ,GACR,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,cAAc,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAM3E,eAAO,MAAM,eAAe,aAU1B,CAAC;AAMH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAO1D,CAAC;AAKF,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAsBnF"}

package/dist/cli/agent/plan-types.js

@@ -0,0 +1,58 @@
+/**
+ * Plan Mode Types & Agent Identity definitions.
+ *
+ * Plan Mode lets the agent first explore (read-only), then present a structured
+ * plan, then execute step-by-step after user approval.
+ *
+ * Agent Identities provide colored @names for all agents/sessions.
+ */
+// ---------------------------------------------------------------------------
+// Read-only tool whitelist for plan mode
+// ---------------------------------------------------------------------------
+export const PLAN_MODE_TOOLS = new Set([
+    'read_file',
+    'list_directory',
+    'search_files',
+    'find_files',
+    'git_status',
+    'git_log',
+    'git_diff',
+    'spiral_query',
+    'bug_list',
+]);
+export const AGENT_IDENTITIES = {
+    main: { name: '@main', displayName: 'HelixMind', color: '#00d4ff', icon: '\u{1F4AC}' },
+    jarvis: { name: '@jarvis', displayName: 'JARVIS', color: '#8a2be2', icon: '\u{1F916}' },
+    security: { name: '@security', displayName: 'Security', color: '#ff4444', icon: '\u{1F512}' },
+    auto: { name: '@auto', displayName: 'Auto', color: '#00ff88', icon: '\u{1F504}' },
+    monitor: { name: '@monitor', displayName: 'Monitor', color: '#ff6600', icon: '\u{1F6E1}' },
+    swarm: { name: '@swarm', displayName: 'Swarm', color: '#ffd700', icon: '\u{1F41D}' },
+};
+/** Colors for swarm worker identities (cycled for workers 1-N) */
+const WORKER_COLORS = ['#00d4ff', '#ff6b9d', '#00ff88', '#ffd700', '#c084fc', '#f97316'];
+/** Resolve a session name to its AgentIdentity (case-insensitive, partial match) */
+export function resolveAgentIdentity(sessionName) {
+    const lower = sessionName.toLowerCase();
+    // Direct key match
+    if (AGENT_IDENTITIES[lower])
+        return AGENT_IDENTITIES[lower];
+    // Dynamic worker-N match: "Worker-1", "worker-3", "Worker 2"
+    const workerMatch = lower.match(/worker[- ]?(\d+)/);
+    if (workerMatch) {
+        const idx = parseInt(workerMatch[1], 10) - 1;
+        return {
+            name: `@worker-${idx + 1}`,
+            displayName: `Worker-${idx + 1}`,
+            color: WORKER_COLORS[idx % WORKER_COLORS.length],
+            icon: '\u{1F41D}',
+        };
+    }
+    // Partial match: "Security Audit" → security, "Auto: fix lint" → auto
+    for (const [key, identity] of Object.entries(AGENT_IDENTITIES)) {
+        if (lower.includes(key) || lower.includes(identity.displayName.toLowerCase())) {
+            return identity;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=plan-types.js.map

package/dist/cli/agent/plan-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-types.js","sourceRoot":"","sources":["../../../src/cli/agent/plan-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkDH,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IACrC,WAAW;IACX,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,UAAU;IACV,cAAc;IACd,UAAU;CACX,CAAC,CAAC;AAaH,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC7D,IAAI,EAAM,EAAE,IAAI,EAAE,OAAO,EAAM,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;IAC9F,MAAM,EAAI,EAAE,IAAI,EAAE,SAAS,EAAI,WAAW,EAAE,QAAQ,EAAK,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;IAC9F,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAG,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;IAC9F,IAAI,EAAM,EAAE,IAAI,EAAE,OAAO,EAAM,WAAW,EAAE,MAAM,EAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;IAC9F,OAAO,EAAG,EAAE,IAAI,EAAE,UAAU,EAAG,WAAW,EAAE,SAAS,EAAI,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;IAC9F,KAAK,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAK,WAAW,EAAE,OAAO,EAAM,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;CAC/F,CAAC;AAEF,kEAAkE;AAClE,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAEzF,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,mBAAmB;IACnB,IAAI,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5D,6DAA6D;IAC7D,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACpD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO;YACL,IAAI,EAAE,WAAW,GAAG,GAAG,CAAC,EAAE;YAC1B,WAAW,EAAE,UAAU,GAAG,GAAG,CAAC,EAAE;YAChC,KAAK,EAAE,aAAa,CAAC,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC;YAChD,IAAI,EAAE,WAAW;SAClB,CAAC;IACJ,CAAC;IACD,sEAAsE;IACtE,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/D,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC9E,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/cli/agent/sandbox.d.ts

@@ -0,0 +1,28 @@
+export declare class SecurityError extends Error {
+    constructor(message: string);
+}
+export interface PathValidation {
+    resolved: string;
+    external: boolean;
+}
+/**
+ * Validate a path, allowing external paths (outside project root).
+ * External paths need separate permission approval via the agent loop.
+ * Still blocks: sensitive files, symlinks.
+ */
+export declare function validatePathEx(requestedPath: string, projectRoot: string): PathValidation;
+/**
+ * Validate that a requested path is within the project root
+ * and not a sensitive file. Returns the resolved absolute path.
+ */
+export declare function validatePath(requestedPath: string, projectRoot: string): string;
+/**
+ * Classify a shell command's danger level.
+ */
+export declare function classifyCommand(cmd: string): 'safe' | 'ask' | 'dangerous';
+/**
+ * Check if a command is blocked entirely (should never run).
+ * These are hard-blocked even in YOLO mode.
+ */
+export declare function isBlockedCommand(cmd: string): boolean;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/cli/agent/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/sandbox.ts"],"names":[],"mappings":"AAoEA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CA0EzF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA+D/E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,CAuDzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAYrD"}