ineedcodes 0.1.0

package/packages/agent/dist/boost.js

@@ -0,0 +1,138 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { shellQuote } from '@ineedcodes/core';
+export class BoostIntegration {
+    registry;
+    toolContext;
+    emit;
+    run;
+    constructor(registry, toolContext, emit) {
+        this.registry = registry;
+        this.toolContext = toolContext;
+        this.emit = emit;
+    }
+    active() {
+        return this.run !== undefined;
+    }
+    current() {
+        return this.run;
+    }
+    async exec(tool, input) {
+        return this.registry.execute(tool, input, this.toolContext);
+    }
+    async start(objective) {
+        if (this.run) {
+            return { ok: false, summary: 'A Boost run is already active. Finish or abort it first.', error: 'boost_active' };
+        }
+        await this.emit({ type: 'boost-phase', phase: 'start', detail: objective });
+        // Require a Git repo for worktree isolation.
+        const status = await this.exec('git_status', {});
+        if (!status.ok) {
+            return { ok: false, summary: 'Boost needs a Git repository for worktree isolation. Initialize Git first.', error: 'no_git' };
+        }
+        const id = `boost-${Date.now()}`;
+        const branch = `boost/${id.split('-')[1] ?? id}`;
+        const worktreePath = path.join(this.toolContext.workspaceRoot, '.ineedcodes', id);
+        const added = await this.exec('git_worktree', { mode: 'add', path: worktreePath, branch });
+        if (!added.ok) {
+            return { ok: false, summary: `Could not create Boost worktree: ${added.summary}`, error: 'worktree_failed' };
+        }
+        this.run = { id, worktreePath, branch, phase: 'investigate', startedAt: Date.now() };
+        return {
+            ok: true,
+            summary: `Boost started in isolated worktree ${worktreePath} (branch ${branch}). Objective: ${objective}`,
+            data: { id, worktreePath, branch }
+        };
+    }
+    worktreeContext() {
+        if (!this.run)
+            return undefined;
+        return {
+            ...this.toolContext,
+            cwd: this.run.worktreePath,
+            workspaceRoot: this.run.worktreePath
+        };
+    }
+    /** Commit any uncommitted work inside the Boost worktree so it can merge. */
+    async commitWorktreeChanges() {
+        if (!this.run)
+            return { ok: false, summary: 'No active Boost run.', error: 'no_boost' };
+        await this.exec('shell_exec', { command: `git -C ${shellQuote(this.run.worktreePath)} add -A` });
+        const commit = await this.exec('shell_exec', {
+            command: `git -C ${shellQuote(this.run.worktreePath)} commit -m ${shellQuote(`boost: ${this.run.id}`)}`
+        });
+        // "nothing to commit" is fine; real failures are not.
+        const nothingToCommit = /nothing to commit|no changes added/i.test(commit.summary + JSON.stringify(commit.data ?? ''));
+        if (!commit.ok && !nothingToCommit) {
+            return { ok: false, summary: `Could not commit Boost worktree changes: ${commit.summary}`, error: 'commit_failed' };
+        }
+        return { ok: true, summary: nothingToCommit ? 'No changes to commit in the Boost worktree.' : 'Boost changes committed.' };
+    }
+    async reconcile() {
+        if (!this.run)
+            return { ok: false, summary: 'No active Boost run.', error: 'no_boost' };
+        this.run.phase = 'reconcile';
+        await this.emit({ type: 'boost-phase', phase: 'reconcile' });
+        const committed = await this.commitWorktreeChanges();
+        if (!committed.ok)
+            return committed;
+        // Merge the boost branch back into the user's branch.
+        const result = await this.exec('shell_exec', { command: `git merge --no-ff ${this.run.branch}` });
+        if (result.ok) {
+            // Safe-delete the merged branch.
+            await this.exec('shell_exec', { command: `git branch -d ${this.run.branch}` });
+        }
+        return {
+            ok: result.ok,
+            summary: result.ok
+                ? `Boost branch ${this.run.branch} merged into your branch (${committed.summary}).`
+                : `Merge failed: ${result.summary} Run abort + cleanup if needed.`,
+            data: result.data
+        };
+    }
+    async abort(reason) {
+        if (!this.run)
+            return { ok: false, summary: 'No active Boost run.', error: 'no_boost' };
+        this.run.phase = 'abort';
+        const { worktreePath, branch } = this.run;
+        await this.emit({ type: 'boost-phase', phase: 'abort', detail: reason });
+        // A branch checked out in a worktree cannot be deleted: remove the
+        // worktree first, then the branch. Your working tree was never touched.
+        const removed = await this.exec('git_worktree', { mode: 'remove', path: worktreePath });
+        try {
+            fs.rmSync(worktreePath, { recursive: true, force: true });
+        }
+        catch {
+            // best effort
+        }
+        await this.exec('shell_exec', { command: `git branch -D ${shellQuote(branch)}` });
+        this.run = undefined;
+        return {
+            ok: true,
+            summary: `Boost run aborted (${reason}). Worktree removed${removed.ok ? '' : ' (forced)'} and branch ${branch} deleted. Your working tree was never touched by Boost changes.`
+        };
+    }
+    async cleanup() {
+        if (!this.run)
+            return { ok: false, summary: 'No active Boost run.', error: 'no_boost' };
+        this.run.phase = 'cleanup';
+        const worktree = this.run.worktreePath;
+        const branch = this.run.branch;
+        this.run = undefined;
+        const removed = await this.exec('git_worktree', { mode: 'remove', path: worktree });
+        try {
+            fs.rmSync(worktree, { recursive: true, force: true });
+        }
+        catch {
+            // best effort
+        }
+        // Safe-delete: only succeeds when the branch is fully merged.
+        await this.exec('shell_exec', { command: `git branch -d ${shellQuote(branch)}` });
+        return {
+            ok: true,
+            summary: `Boost cleaned up (worktree ${worktree} removed${removed.ok ? '' : ', with force'}).`
+        };
+    }
+}
+export const BOOST_PHASES = ['start', 'investigate', 'implement', 'test', 'verify', 'reconcile', 'abort', 'cleanup'];
+//# sourceMappingURL=boost.js.map

package/packages/agent/dist/boost.js.map

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

package/packages/agent/dist/events.d.ts

@@ -0,0 +1,67 @@
+import type { ToolResult, TaskPacket, AgentStatus, ContextCheckpoint } from '@ineedcodes/core';
+export type RuntimeEvent = {
+    type: 'session-start';
+    projectRoot: string;
+    model: string;
+} | {
+    type: 'turn-start';
+    turn: number;
+} | {
+    type: 'assistant-message';
+    text: string;
+} | {
+    type: 'thinking';
+    text: string;
+} | {
+    type: 'tool-start';
+    tool: string;
+    input: unknown;
+} | {
+    type: 'tool-result';
+    tool: string;
+    result: ToolResult;
+} | {
+    type: 'agent-spawned';
+    taskId: string;
+    capability: string;
+    objective: string;
+} | {
+    type: 'agent-status';
+    taskId: string;
+    status: AgentStatus;
+} | {
+    type: 'agent-result';
+    taskId: string;
+    summary: string;
+} | {
+    type: 'boost-phase';
+    phase: string;
+    detail?: string;
+} | {
+    type: 'compaction';
+    checkpoint: ContextCheckpoint;
+} | {
+    type: 'permission-denied';
+    tool: string;
+    reason: string;
+} | {
+    type: 'memory-write';
+    content: string;
+} | {
+    type: 'skill-invoked';
+    name: string;
+} | {
+    type: 'turn-end';
+    turn: number;
+    stopReason: string;
+} | {
+    type: 'session-end';
+};
+export type EventListener = (event: RuntimeEvent) => void | Promise<void>;
+/** Tiny synchronous event bus shared by the lead agent, orchestrator, and CLI. */
+export declare class EventBus {
+    private listeners;
+    on(listener: EventListener): () => void;
+    emit(event: RuntimeEvent): Promise<void>;
+}
+export type { TaskPacket };

package/packages/agent/dist/events.js

@@ -0,0 +1,16 @@
+/** Tiny synchronous event bus shared by the lead agent, orchestrator, and CLI. */
+export class EventBus {
+    listeners = [];
+    on(listener) {
+        this.listeners.push(listener);
+        return () => {
+            this.listeners = this.listeners.filter((l) => l !== listener);
+        };
+    }
+    async emit(event) {
+        for (const listener of this.listeners) {
+            await listener(event);
+        }
+    }
+}
+//# sourceMappingURL=events.js.map

package/packages/agent/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAsBA,kFAAkF;AAClF,MAAM,OAAO,QAAQ;IACX,SAAS,GAAoB,EAAE,CAAC;IAExC,EAAE,CAAC,QAAuB;QACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;QAChE,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAmB;QAC5B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/packages/agent/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './system-prompts.js';
+export * from './events.js';
+export * from './runtime.js';
+export * from './lead-agent.js';
+export * from './orchestrator.js';
+export * from './boost.js';

package/packages/agent/dist/index.js

@@ -0,0 +1,7 @@
+export * from './system-prompts.js';
+export * from './events.js';
+export * from './runtime.js';
+export * from './lead-agent.js';
+export * from './orchestrator.js';
+export * from './boost.js';
+//# sourceMappingURL=index.js.map

package/packages/agent/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/packages/agent/dist/lead-agent.d.ts

@@ -0,0 +1,85 @@
+import type { JsonValue, LLMProvider, MemoryProvider, PermissionEngine, SessionState, ToolRegistry, WorkspaceInfo } from '@ineedcodes/core';
+import { SkillLoader } from '@ineedcodes/core';
+import { type ApprovalRequest, type RuntimeOutcome } from './runtime.js';
+import { EventBus, type EventListener } from './events.js';
+import { Orchestrator } from './orchestrator.js';
+import { type ExplanationDepth } from './system-prompts.js';
+import type { IneedcodesConfig } from '@ineedcodes/core';
+export interface LeadAgentOptions {
+    config: IneedcodesConfig;
+    registry: ToolRegistry;
+    permissions: PermissionEngine;
+    provider: LLMProvider;
+    workspace: WorkspaceInfo;
+    eventBus: EventBus;
+    depth: ExplanationDepth;
+    maxTurns?: number;
+    /** plan = analysis only (read-only tools); build = full autonomy. Default: build. */
+    mode?: 'plan' | 'build';
+    reasoningEffort?: 'low' | 'medium' | 'high';
+    requestApproval?: (req: ApprovalRequest) => Promise<boolean>;
+    signal?: AbortSignal;
+}
+/**
+ * The Lead Agent is the authoritative coordinator of a session.
+ */
+export declare class LeadAgent {
+    private readonly opts;
+    readonly eventBus: EventBus;
+    private readonly orchestrator;
+    private memory;
+    private messages;
+    private objective;
+    private depth;
+    private mode;
+    private reasoningEffort;
+    private readonly skillsLoader;
+    private skillCache;
+    constructor(opts: LeadAgentOptions);
+    init(): Promise<void>;
+    setDepth(depth: ExplanationDepth): void;
+    getMode(): 'plan' | 'build';
+    setMode(mode: 'plan' | 'build'): void;
+    getReasoningEffort(): 'low' | 'medium' | 'high';
+    setReasoningEffort(effort: 'low' | 'medium' | 'high'): void;
+    /** Hot-swap the LLM provider (e.g. after /model) without restarting the session. */
+    setProvider(provider: LLMProvider): void;
+    /**
+     * Reasoning effort changes real execution budget, not just a request flag:
+     * low = quick answers (fewer turns), high = deep work (many more turns).
+     */
+    private effectiveMaxTurns;
+    /** Fresh session: forget conversation and sub-agents (memory is durable, it stays). */
+    resetSession(): void;
+    /** Context usage breakdown for the /context command. */
+    contextStats(): {
+        system: number;
+        conversation: number;
+        tools: number;
+        total: number;
+        limit: number;
+        compactsAt: number;
+    };
+    getMemories(): MemoryProvider;
+    getOrchestrator(): Orchestrator;
+    listSkills(): Awaited<ReturnType<SkillLoader['list']>>;
+    reloadSkills(): Promise<void>;
+    getSkillText(name: string): string | undefined;
+    on(listener: EventListener): () => void;
+    private emitEvent;
+    private systemPromptFor;
+    recallMemories(objective: string): Promise<string[]>;
+    /**
+     * Run a user objective through the full loop:
+     * recall → inspect → reason → act → observe → verify.
+     */
+    runObjective(objective: string): Promise<RuntimeOutcome>;
+    /** Continue the current session with a new user message. */
+    continueSession(userMessage: string): Promise<RuntimeOutcome>;
+    private toolContext;
+    private recordOutcome;
+    private extractDurableKnowledge;
+    toSessionState(sessionId: string): SessionState;
+    restore(state: SessionState): void;
+}
+export type { RuntimeOutcome, ApprovalRequest, JsonValue };

package/packages/agent/dist/lead-agent.js

@@ -0,0 +1,235 @@
+import { createMemoryProvider, SkillLoader, ProcessManager, estimateTokens } from '@ineedcodes/core';
+import { AgentRuntime } from './runtime.js';
+import { Orchestrator } from './orchestrator.js';
+import { buildSystemPrompt } from './system-prompts.js';
+/**
+ * The Lead Agent is the authoritative coordinator of a session.
+ */
+export class LeadAgent {
+    opts;
+    eventBus;
+    orchestrator;
+    memory;
+    messages = [];
+    objective = '';
+    depth;
+    mode;
+    reasoningEffort;
+    skillsLoader;
+    skillCache = [];
+    constructor(opts) {
+        this.opts = opts;
+        this.eventBus = opts.eventBus;
+        this.memory = createMemoryProvider(opts.config.memory.backend, opts.workspace.projectId, opts.workspace.projectRoot);
+        this.orchestrator = new Orchestrator(opts.config.permissions.maxParallelAgents);
+        this.depth = opts.depth;
+        this.mode = opts.mode ?? 'build';
+        this.reasoningEffort = opts.reasoningEffort ?? 'medium';
+        this.skillsLoader = new SkillLoader(opts.workspace.projectRoot);
+    }
+    async init() {
+        this.skillCache = await this.skillsLoader.list();
+    }
+    setDepth(depth) {
+        this.depth = depth;
+    }
+    getMode() {
+        return this.mode;
+    }
+    setMode(mode) {
+        this.mode = mode;
+    }
+    getReasoningEffort() {
+        return this.reasoningEffort;
+    }
+    setReasoningEffort(effort) {
+        this.reasoningEffort = effort;
+    }
+    /** Hot-swap the LLM provider (e.g. after /model) without restarting the session. */
+    setProvider(provider) {
+        this.opts.provider = provider;
+    }
+    /**
+     * Reasoning effort changes real execution budget, not just a request flag:
+     * low = quick answers (fewer turns), high = deep work (many more turns).
+     */
+    effectiveMaxTurns() {
+        if (this.opts.maxTurns !== undefined)
+            return this.opts.maxTurns;
+        if (this.reasoningEffort === 'low')
+            return 20;
+        if (this.reasoningEffort === 'high')
+            return 80;
+        return 40;
+    }
+    /** Fresh session: forget conversation and sub-agents (memory is durable, it stays). */
+    resetSession() {
+        this.messages = [];
+        this.objective = '';
+        this.orchestrator.clear();
+    }
+    /** Context usage breakdown for the /context command. */
+    contextStats() {
+        let system = 0;
+        let tools = 0;
+        let conversation = 0;
+        for (const m of this.messages) {
+            const t = estimateTokens(m.content ?? '') + (m.toolCalls ?? []).reduce((a, tc) => a + estimateTokens(tc.arguments), 0);
+            if (m.role === 'system')
+                system += t;
+            else if (m.role === 'tool')
+                tools += t;
+            else
+                conversation += t;
+        }
+        const limit = this.opts.provider.contextLimit;
+        return { system, conversation, tools, total: system + conversation + tools, limit, compactsAt: Math.round(limit * 0.75) };
+    }
+    getMemories() {
+        return this.memory;
+    }
+    getOrchestrator() {
+        return this.orchestrator;
+    }
+    listSkills() {
+        return this.skillCache;
+    }
+    async reloadSkills() {
+        this.skillCache = await this.skillsLoader.list();
+    }
+    getSkillText(name) {
+        return this.skillCache.find((s) => s.name.toLowerCase() === name.toLowerCase())?.instructions;
+    }
+    on(listener) {
+        return this.eventBus.on(listener);
+    }
+    emitEvent(event) {
+        return this.eventBus.emit(event);
+    }
+    systemPromptFor(objective, extraMemories = []) {
+        return buildSystemPrompt({
+            objective,
+            workspace: this.opts.workspace,
+            skills: this.skillCache,
+            memories: extraMemories,
+            depth: this.depth,
+            permissionMode: this.opts.permissions.currentMode,
+            mode: this.mode,
+            reasoningEffort: this.reasoningEffort
+        });
+    }
+    async recallMemories(objective) {
+        try {
+            const records = await this.memory.recall(objective, 5);
+            return records.map((r) => r.content);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Run a user objective through the full loop:
+     * recall → inspect → reason → act → observe → verify.
+     */
+    async runObjective(objective) {
+        this.objective = objective;
+        await this.emitEvent({ type: 'session-start', projectRoot: this.opts.workspace.projectRoot, model: this.opts.provider.model });
+        const memories = await this.recallMemories(objective);
+        if (memories.length) {
+            await this.emitEvent({ type: 'thinking', text: `Recalled ${memories.length} relevant memory item(s).` });
+        }
+        const runtime = new AgentRuntime({
+            provider: this.opts.provider,
+            registry: this.opts.registry,
+            memory: this.memory,
+            toolContext: this.toolContext(),
+            systemPrompt: this.systemPromptFor(objective, memories),
+            maxTurns: this.effectiveMaxTurns(),
+            mode: this.mode,
+            reasoningEffort: this.reasoningEffort
+        }, (event) => this.emitEvent(event), this.opts.requestApproval, this.messages, this.opts.signal);
+        const outcome = await runtime.run(objective);
+        this.messages = [...runtime.messages];
+        await this.recordOutcome(objective, outcome);
+        await this.emitEvent({ type: 'session-end' });
+        return outcome;
+    }
+    /** Continue the current session with a new user message. */
+    async continueSession(userMessage) {
+        return this.runObjective(userMessage);
+    }
+    toolContext() {
+        // The CLI normally registers a shared process manager on globalThis;
+        // library/embedded usage creates one on demand instead of failing.
+        let pm = globalThis['__ineedcodesProcessManager'];
+        if (!pm) {
+            pm = new ProcessManager();
+            globalThis['__ineedcodesProcessManager'] = pm;
+        }
+        return {
+            workspaceRoot: this.opts.workspace.projectRoot,
+            cwd: this.opts.workspace.root,
+            permissions: this.opts.permissions,
+            processManager: pm
+        };
+    }
+    async recordOutcome(objective, outcome) {
+        if (outcome.stopReason !== 'complete')
+            return;
+        // Store durable knowledge, not chat dumps (plan §14–15).
+        const durable = await this.extractDurableKnowledge(objective, outcome);
+        if (durable) {
+            try {
+                await this.memory.remember(durable, ['session', 'outcome']);
+                await this.emitEvent({ type: 'memory-write', content: durable });
+            }
+            catch {
+                // memory failures never break the session
+            }
+        }
+    }
+    async extractDurableKnowledge(objective, outcome) {
+        try {
+            const response = await this.opts.provider.complete({
+                messages: [
+                    {
+                        role: 'system',
+                        content: 'Decide whether this completed task produced durable knowledge worth remembering for future sessions ' +
+                            'in this project (conventions, solved errors, environment facts, decisions). If yes, output one ' +
+                            'concise memory sentence. If nothing is durable, output exactly NONE.'
+                    },
+                    { role: 'user', content: `Objective: ${objective}\nOutcome: ${outcome.finalMessage.slice(0, 2000)}` }
+                ],
+                temperature: 0,
+                maxTokens: 200
+            });
+            const text = (response.content ?? 'NONE').trim();
+            if (!text || text.toUpperCase().startsWith('NONE'))
+                return null;
+            return `Objective: ${objective.slice(0, 200)}: ${text.slice(0, 500)}`;
+        }
+        catch {
+            return null;
+        }
+    }
+    toSessionState(sessionId) {
+        return {
+            sessionId,
+            projectRoot: this.opts.workspace.projectRoot,
+            model: this.opts.provider.model,
+            objective: this.objective,
+            messages: this.messages,
+            agents: this.orchestrator.list(),
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString()
+        };
+    }
+    restore(state) {
+        this.messages = state.messages ?? [];
+        this.objective = state.objective ?? '';
+        for (const agent of state.agents ?? []) {
+            this.orchestrator.restore(agent);
+        }
+    }
+}
+//# sourceMappingURL=lead-agent.js.map

package/packages/agent/dist/lead-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead-agent.js","sourceRoot":"","sources":["../src/lead-agent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,YAAY,EAA8D,MAAM,cAAc,CAAC;AAExG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAyB,MAAM,qBAAqB,CAAC;AAmB/E;;GAEG;AACH,MAAM,OAAO,SAAS;IAYS;IAXpB,QAAQ,CAAW;IACX,YAAY,CAAe;IACpC,MAAM,CAAiB;IACvB,QAAQ,GAAkB,EAAE,CAAC;IAC7B,SAAS,GAAG,EAAE,CAAC;IACf,KAAK,CAAmB;IACxB,IAAI,CAAmB;IACvB,eAAe,CAA4B;IAClC,YAAY,CAAc;IACnC,UAAU,GAA6C,EAAE,CAAC;IAElE,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,oBAAoB,CAChC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAC1B,IAAI,CAAC,SAAS,CAAC,SAAS,EACxB,IAAI,CAAC,SAAS,CAAC,WAAW,CAC3B,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QAChF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC;QACjC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,QAAQ,CAAC;QACxD,IAAI,CAAC,YAAY,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;IAED,QAAQ,CAAC,KAAuB;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,OAAO,CAAC,IAAsB;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,kBAAkB,CAAC,MAAiC;QAClD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC;IAChC,CAAC;IAED,oFAAoF;IACpF,WAAW,CAAC,QAAqB;QAC9B,IAAI,CAAC,IAAkC,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACK,iBAAiB;QACvB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAChE,IAAI,IAAI,CAAC,eAAe,KAAK,KAAK;YAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,eAAe,KAAK,MAAM;YAAE,OAAO,EAAE,CAAC;QAC/C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,uFAAuF;IACvF,YAAY;QACV,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,wDAAwD;IACxD,YAAY;QAGV,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YACvH,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,CAAC,CAAC;iBAChC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;gBAAE,KAAK,IAAI,CAAC,CAAC;;gBAClC,YAAY,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IAC5H,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,YAAY,CAAC;IAChG,CAAC;IAED,EAAE,CAAC,QAAuB;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAEO,SAAS,CAAC,KAAmB;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAEO,eAAe,CAAC,SAAiB,EAAE,gBAA0B,EAAE;QACrE,OAAO,iBAAiB,CAAC;YACvB,SAAS;YACT,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC9B,MAAM,EAAE,IAAI,CAAC,UAAU;YACvB,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW;YACjD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAiB;QACpC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACvD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,SAAiB;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAE/H,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,QAAQ,CAAC,MAAM,2BAA2B,EAAE,CAAC,CAAC;QAC3G,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B;YACE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC5B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;YAC/B,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC;YACvD,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAChC,IAAI,CAAC,IAAI,CAAC,eAAe,EACzB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,IAAI,CAAC,MAAM,CACjB,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEtC,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,eAAe,CAAC,WAAmB;QACvC,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAEO,WAAW;QACjB,qEAAqE;QACrE,mEAAmE;QACnE,IAAI,EAAE,GAAI,UAA6E,CAAC,4BAA4B,CAAC,CAAC;QACtH,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,EAAE,GAAG,IAAI,cAAc,EAAE,CAAC;YACzB,UAA6E,CAAC,4BAA4B,CAAC,GAAG,EAAE,CAAC;QACpH,CAAC;QACD,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW;YAC9C,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI;YAC7B,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;YAClC,cAAc,EAAE,EAAE;SACnB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,OAAuB;QACpE,IAAI,OAAO,CAAC,UAAU,KAAM,UAAgC;YAAE,OAAO;QACrE,yDAAyD;QACzD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACvE,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC5D,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,uBAAuB,CAAC,SAAiB,EAAE,OAAuB;QAC9E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACjD,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,OAAO,EACL,sGAAsG;4BACtG,iGAAiG;4BACjG,sEAAsE;qBACzE;oBACD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,SAAS,cAAc,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE;iBACtG;gBACD,WAAW,EAAE,CAAC;gBACd,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChE,OAAO,cAAc,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,cAAc,CAAC,SAAiB;QAC9B,OAAO;YACL,SAAS;YACT,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW;YAC5C,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE;YAChC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAmB;QACzB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF"}

package/packages/agent/dist/orchestrator.d.ts

@@ -0,0 +1,43 @@
+import type { AgentCapability, AgentRecord, TaskPacket, TaskResult } from '@ineedcodes/core';
+/**
+ * Native multi-agent orchestrator (plan §9–11).
+ * Sub-agents are real isolated contexts, not simulated personas in one prompt.
+ * The Lead Agent remains the authoritative coordinator.
+ */
+export declare class Orchestrator {
+    private maxParallel;
+    private agents;
+    constructor(maxParallel?: number);
+    setMaxParallel(n: number): void;
+    get runningCount(): number;
+    createTask(opts: {
+        capability: AgentCapability;
+        objective: string;
+        parentAgentId: string;
+        context?: string;
+        constraints?: string[];
+        availableTools?: string[];
+        workspace?: string;
+        expectedResult?: string;
+    }): TaskPacket;
+    canStartMore(): boolean;
+    setStatus(taskId: string, status: AgentRecord['status']): void;
+    finish(taskId: string, result: TaskResult): void;
+    get(taskId: string): AgentRecord | undefined;
+    list(): AgentRecord[];
+    /** Forget all agents (used by /clear). */
+    clear(): void;
+    pendingTasks(): AgentRecord[];
+    restore(record: AgentRecord): void;
+    /**
+     * Run a set of task packets in parallel (bounded by maxParallel).
+     * Each worker gets its own AgentRuntime instance via the factory.
+     */
+    runParallel(packets: TaskPacket[], worker: (packet: TaskPacket) => Promise<TaskResult>, hooks?: {
+        onStatus?: (taskId: string, status: AgentRecord['status']) => Promise<void>;
+        onResult?: (taskId: string, result: TaskResult) => Promise<void>;
+    }): Promise<Map<string, TaskResult>>;
+}
+/** Serialize a task result into compact text for the Lead Agent context. */
+export declare function summarizeTaskResults(results: Map<string, TaskResult>): string;
+export declare function worktreePathFor(projectRoot: string, label: string): string;