ineedcodes 0.1.7 → 1.0.0

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

@@ -1,85 +0,0 @@
-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

@@ -1,235 +0,0 @@
-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

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

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

@@ -1,43 +0,0 @@
-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;

package/packages/agent/dist/orchestrator.js

@@ -1,135 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import * as path from 'node:path';
-/**
- * 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 class Orchestrator {
-    maxParallel;
-    agents = new Map();
-    constructor(maxParallel = 4) {
-        this.maxParallel = maxParallel;
-    }
-    setMaxParallel(n) {
-        this.maxParallel = Math.max(1, n);
-    }
-    get runningCount() {
-        return [...this.agents.values()].filter((a) => a.status === 'running').length;
-    }
-    createTask(opts) {
-        const taskId = randomUUID();
-        const agentId = `agent-${taskId.slice(0, 8)}`;
-        const packet = {
-            taskId,
-            agentId,
-            parentAgentId: opts.parentAgentId,
-            objective: opts.objective,
-            context: opts.context ?? '',
-            constraints: opts.constraints ?? [
-                'Stay strictly within your task scope.',
-                'Do not commit or push.',
-                'Report evidence for every claim.'
-            ],
-            availableTools: opts.availableTools ?? ['*'],
-            workspace: opts.workspace ?? '.',
-            expectedResult: opts.expectedResult ?? 'A clear summary with evidence.'
-        };
-        this.agents.set(taskId, {
-            agentId,
-            parentAgentId: opts.parentAgentId,
-            capability: opts.capability,
-            status: 'pending',
-            task: packet
-        });
-        return packet;
-    }
-    canStartMore() {
-        return this.runningCount < this.maxParallel;
-    }
-    setStatus(taskId, status) {
-        const record = this.agents.get(taskId);
-        if (record)
-            record.status = status;
-    }
-    finish(taskId, result) {
-        const record = this.agents.get(taskId);
-        if (record) {
-            record.status = result.status === 'completed' ? 'completed' : 'failed';
-            record.result = result;
-        }
-    }
-    get(taskId) {
-        return this.agents.get(taskId);
-    }
-    list() {
-        return [...this.agents.values()];
-    }
-    /** Forget all agents (used by /clear). */
-    clear() {
-        this.agents.clear();
-    }
-    pendingTasks() {
-        return this.list().filter((a) => a.status === 'pending');
-    }
-    restore(record) {
-        this.agents.set(record.task.taskId, record);
-    }
-    /**
-     * Run a set of task packets in parallel (bounded by maxParallel).
-     * Each worker gets its own AgentRuntime instance via the factory.
-     */
-    async runParallel(packets, worker, hooks) {
-        const results = new Map();
-        const queue = [...packets];
-        const launchNext = async () => {
-            const packet = queue.shift();
-            if (!packet)
-                return;
-            this.setStatus(packet.taskId, 'running');
-            await hooks?.onStatus?.(packet.taskId, 'running');
-            let result;
-            try {
-                result = await worker(packet);
-            }
-            catch (err) {
-                result = {
-                    status: 'failed',
-                    summary: err instanceof Error ? err.message : String(err),
-                    evidence: [],
-                    filesChanged: [],
-                    commandsExecuted: [],
-                    unresolvedIssues: ['Worker crashed before returning a result.']
-                };
-            }
-            this.finish(packet.taskId, result);
-            results.set(packet.taskId, result);
-            await hooks?.onResult?.(packet.taskId, result);
-            if (queue.length > 0)
-                await launchNext();
-        };
-        const lanes = Math.min(this.maxParallel, Math.max(1, packets.length));
-        await Promise.all(Array.from({ length: lanes }, () => launchNext()));
-        return results;
-    }
-}
-/** Serialize a task result into compact text for the Lead Agent context. */
-export function summarizeTaskResults(results) {
-    const lines = [];
-    for (const [taskId, result] of results) {
-        lines.push(`Task ${taskId.slice(0, 8)} [${result.status}]: ${result.summary}`);
-        for (const ev of result.evidence.slice(0, 5))
-            lines.push(`  evidence: ${ev}`);
-        if (result.filesChanged.length)
-            lines.push(`  files: ${result.filesChanged.join(', ')}`);
-        if (result.tests)
-            lines.push(`  tests: ${result.tests}`);
-        for (const issue of result.unresolvedIssues)
-            lines.push(`  unresolved: ${issue}`);
-    }
-    return lines.join('\n');
-}
-export function worktreePathFor(projectRoot, label) {
-    return path.join(projectRoot, '.ineedcodes', label);
-}
-//# sourceMappingURL=orchestrator.js.map

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

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

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

@@ -1,44 +0,0 @@
-import type { ChatMessage, LLMProvider, MemoryProvider, ToolContext, ToolRegistry } from '@ineedcodes/core';
-export interface RuntimeServices {
-    provider: LLMProvider;
-    registry: ToolRegistry;
-    memory: MemoryProvider;
-    toolContext: ToolContext;
-    systemPrompt: string;
-    maxTurns: number;
-    /** plan = read-only exploration; build = full tool access. */
-    mode?: 'plan' | 'build';
-    reasoningEffort?: 'low' | 'medium' | 'high';
-}
-export type StopReason = 'complete' | 'needs_approval' | 'needs_information' | 'max_turns' | 'aborted' | 'error';
-export interface RuntimeOutcome {
-    stopReason: StopReason;
-    finalMessage: string;
-    turns: number;
-    toolCalls: number;
-}
-export interface ApprovalRequest {
-    tool: string;
-    reason: string;
-}
-/**
- * The real iterative agent loop (plan §7):
- * reason → tool call → observe actual result → update state → repeat → verify.
- */
-export declare class AgentRuntime {
-    private readonly services;
-    private readonly emit;
-    private readonly requestApproval?;
-    private signal?;
-    private engine;
-    constructor(services: RuntimeServices, emit: (event: import('./events.js').RuntimeEvent) => Promise<void>, requestApproval?: ((req: ApprovalRequest) => Promise<boolean>) | undefined, initialMessages?: ChatMessage[], signal?: AbortSignal | undefined);
-    get messages(): readonly ChatMessage[];
-    run(objective: string): Promise<RuntimeOutcome>;
-    /**
-     * Second-chance verification: when the model stops calling tools, require it
-     * to either present evidence of completion or state what is missing.
-     * Returns the single final answer (never duplicated to the UI).
-     */
-    private verifyCompletion;
-    private summarize;
-}