@phuetz/code-buddy 0.3.0 → 1.0.0-rc.8

package/dist/agent/plan-mode.js

@@ -0,0 +1,225 @@
+/**
+ * Plan Mode — Read-only Research & Planning Mode
+ *
+ * When active, restricts available tools to read-only operations
+ * (Read, Search, Think, Plan). Write/Execute tools are blocked
+ * or have their descriptions modified to only allow .md plan files.
+ *
+ * Inspired by Gemini CLI's plan mode.
+ *
+ * V4.4 ADR option A (2026-05-02) — bridged to OperatingModeManager.
+ * Historically this module had its own `_currentMode` state that no caller
+ * ever set to PLAN, so plan-mode features (`isPlanMode`, `filterToolsForMode`,
+ * `getPlanModePrompt`, etc.) were inert. The actual user-visible mode toggle
+ * (`/plan` slash command) lives in `OperatingModeManager.setMode('plan')`.
+ *
+ * Bridge: every "are we in plan mode?" check now consults
+ * `getOperatingModeManager().getMode() === 'plan'`. The legacy `_currentMode`
+ * state, `getAgentMode()`, and `setAgentMode()` are kept as a no-op
+ * deprecated API so existing callers (and tests) compile, but they no
+ * longer affect runtime behavior. ADR-03 (separate ticket) will fold
+ * `AgentMode` enum into `OperatingMode`.
+ */
+import { logger } from '../utils/logger.js';
+import { getOperatingModeManager } from './operating-modes.js';
+/**
+ * Single source of truth for "are we in plan mode?" — reads from
+ * OperatingModeManager (the system actually toggled by `/plan`).
+ * All public predicates below delegate here.
+ */
+function inPlanMode() {
+    return getOperatingModeManager().getMode() === 'plan';
+}
+// ============================================================================
+// Types
+// ============================================================================
+export var AgentMode;
+(function (AgentMode) {
+    AgentMode["DEFAULT"] = "default";
+    AgentMode["PLAN"] = "plan";
+    AgentMode["CODE"] = "code";
+    AgentMode["ASK"] = "ask";
+    AgentMode["ARCHITECT"] = "architect";
+})(AgentMode || (AgentMode = {}));
+/** Tool kinds for classification */
+export var ToolKind;
+(function (ToolKind) {
+    ToolKind["Read"] = "read";
+    ToolKind["Edit"] = "edit";
+    ToolKind["Delete"] = "delete";
+    ToolKind["Search"] = "search";
+    ToolKind["Execute"] = "execute";
+    ToolKind["Think"] = "think";
+    ToolKind["Plan"] = "plan";
+    ToolKind["Communicate"] = "communicate";
+    ToolKind["Other"] = "other";
+})(ToolKind || (ToolKind = {}));
+/** Tools allowed in plan mode (by name) */
+const PLAN_MODE_ALLOWED_TOOLS = new Set([
+    // Read
+    'read_file', 'view_file', 'file_read', 'list_files', 'get_file_info', 'tree',
+    // Search
+    'grep', 'glob', 'search_files', 'find_references', 'web_search', 'browser_search',
+    // Think
+    'reason', 'think',
+    // Plan
+    'plan', 'submit_plan', 'exit_plan_mode',
+    // Communicate
+    'ask_human',
+    // Knowledge
+    'knowledge_search', 'knowledge_list', 'codebase_map', 'code_graph',
+    // Other read-only
+    'todo_update', 'lessons_search', 'lessons_list', 'lessons_graph',
+    'restore_context', 'memory_search',
+]);
+/** Tools that get modified descriptions in plan mode (limited to .md files) */
+const PLAN_MODE_RESTRICTED_TOOLS = new Set([
+    'create_file', 'str_replace_editor', 'file_write', 'write_file',
+    'edit_file', 'multi_edit',
+]);
+// ============================================================================
+// State
+// ============================================================================
+/**
+ * Mode state. WARNING: These are module-level globals. In multi-session
+ * server deployments, mode should be tracked per-session via SessionFacade.
+ * These globals are safe for the single-user CLI but must be reset between sessions.
+ */
+let _currentMode = AgentMode.DEFAULT;
+let _planPath = null;
+let _awaitingApproval = false;
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Get the current agent mode.
+ *
+ * @deprecated V4.4 — use `getOperatingModeManager().getMode()` directly.
+ * This still returns the legacy module-local `_currentMode` for compat,
+ * but plan-mode predicates (`isPlanMode`, `filterToolsForMode`, etc.) no
+ * longer consult it. Will be removed in ADR-03.
+ */
+export function getAgentMode() {
+    return _currentMode;
+}
+/**
+ * Set the agent mode.
+ *
+ * @deprecated V4.4 — use `getOperatingModeManager().setMode('plan' | …)`.
+ * This still mutates legacy `_currentMode` for compat, but plan-mode
+ * predicates no longer consult it. Will be removed in ADR-03.
+ */
+export function setAgentMode(mode) {
+    const previous = _currentMode;
+    _currentMode = mode;
+    if (previous !== mode) {
+        logger.info(`Agent mode changed (legacy, no runtime effect): ${previous} → ${mode}`);
+    }
+}
+/**
+ * Check if we're in plan mode. Reads from `OperatingModeManager` (the
+ * system actually toggled by `/plan`). V4.4 ADR option A.
+ */
+export function isPlanMode() {
+    return inPlanMode();
+}
+/**
+ * Set the approved plan path (after user approves a plan).
+ */
+export function setApprovedPlanPath(planPath) {
+    _planPath = planPath;
+}
+/**
+ * Get the approved plan path.
+ */
+export function getApprovedPlanPath() {
+    return _planPath;
+}
+/**
+ * Mark plan mode as awaiting user approval (set by `exit_plan_mode` tool
+ * while the approval prompt is on screen). Used by the UI / status bar
+ * to surface a "waiting for approval" indicator.
+ */
+export function setAwaitingApproval(awaiting) {
+    _awaitingApproval = awaiting;
+}
+/** Check whether plan mode is currently awaiting user approval. */
+export function isAwaitingApproval() {
+    return _awaitingApproval;
+}
+/** Clear the awaiting-approval flag. */
+export function clearAwaitingApproval() {
+    _awaitingApproval = false;
+}
+/**
+ * Check if a tool is allowed in the current mode.
+ * In plan mode, only read/search/think/plan tools are allowed.
+ */
+export function isToolAllowedInCurrentMode(toolName) {
+    if (!inPlanMode())
+        return true;
+    return PLAN_MODE_ALLOWED_TOOLS.has(toolName) ||
+        PLAN_MODE_RESTRICTED_TOOLS.has(toolName);
+}
+/**
+ * Get a modified tool description for plan mode.
+ * Write tools get restricted to .md files in .codebuddy/plans/.
+ * Returns null if no modification needed.
+ */
+export function getPlanModeToolDescription(toolName, originalDescription) {
+    if (!inPlanMode())
+        return null;
+    if (!PLAN_MODE_RESTRICTED_TOOLS.has(toolName))
+        return null;
+    return `PLAN MODE ONLY: ${originalDescription}. You are in Plan Mode and may ONLY use this tool to write or update plan files (.md) in the .codebuddy/plans/ directory. You cannot modify source code directly.`;
+}
+/**
+ * Filter tool definitions for the current mode.
+ * In plan mode, removes disallowed tools and modifies restricted tool descriptions.
+ */
+export function filterToolsForMode(tools) {
+    if (!inPlanMode())
+        return tools;
+    return tools
+        .filter(t => isToolAllowedInCurrentMode(t.function.name))
+        .map(t => {
+        const modified = getPlanModeToolDescription(t.function.name, t.function.description ?? '');
+        if (modified) {
+            return {
+                ...t,
+                function: { ...t.function, description: modified },
+            };
+        }
+        return t;
+    });
+}
+/**
+ * Get the plan mode system prompt injection.
+ */
+export function getPlanModePrompt() {
+    if (!inPlanMode())
+        return null;
+    return `<plan_mode>
+You are in PLAN MODE (read-only research phase).
+
+Rules:
+- Use ONLY read, search, and think tools to analyze the codebase
+- Do NOT modify any source code files
+- You MAY create/edit .md plan files in .codebuddy/plans/
+- Focus on understanding the problem, identifying affected files, and designing a solution
+- When your research is complete, present a plan to the user
+
+Available operations: read files, search code, analyze dependencies, reason about architecture.
+Blocked operations: edit code, run commands, create source files.
+</plan_mode>`;
+}
+/**
+ * Reset plan mode state. Must be called between sessions in multi-session
+ * server deployments to prevent state leakage.
+ */
+export function resetPlanMode() {
+    _currentMode = AgentMode.DEFAULT;
+    _planPath = null;
+    _awaitingApproval = false;
+}
+//# sourceMappingURL=plan-mode.js.map

package/dist/agent/plan-mode.js.map

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

package/dist/agent/planner/progress-default-sink.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Default progress sink — Phase (d).21 ship 4.
+ *
+ * Wakes `ProgressTracker` (previously dormant: registered but no
+ * callers). Provides:
+ *   - a process-level singleton (`getProgressTracker()`)
+ *   - a default log-based sink that emits one info line per ~25%
+ *     completion threshold (avoids per-tool log spam)
+ *
+ * Boot wiring: `codebuddy-agent.ts` calls `wireDefaultProgressSink()`
+ * once at startup. Idempotent.
+ *
+ * Consumers:
+ *   - `agent-executor.runTurnLoop()` calls `start()` at loop entry and
+ *     `update()` per tool execution. Both streaming + sequential paths.
+ *   - Future Cowork progress bar can listen on `getProgressTracker()
+ *     .on('progress', ...)` for finer updates than the log thresholds.
+ *
+ * @module src/agent/planner/progress-default-sink
+ */
+import { ProgressTracker } from './progress-tracker.js';
+/** Process-level singleton. */
+export declare function getProgressTracker(): ProgressTracker;
+/**
+ * Register the default log sink. Logs progress at the 25 / 50 / 75 / 100
+ * thresholds (and never twice for the same threshold within a session).
+ * Idempotent — second call is a no-op.
+ */
+export declare function wireDefaultProgressSink(): void;
+/** Test-only — drop the singleton and the wired flag. */
+export declare function _resetForTests(): void;

package/dist/agent/planner/progress-default-sink.js

@@ -0,0 +1,63 @@
+/**
+ * Default progress sink — Phase (d).21 ship 4.
+ *
+ * Wakes `ProgressTracker` (previously dormant: registered but no
+ * callers). Provides:
+ *   - a process-level singleton (`getProgressTracker()`)
+ *   - a default log-based sink that emits one info line per ~25%
+ *     completion threshold (avoids per-tool log spam)
+ *
+ * Boot wiring: `codebuddy-agent.ts` calls `wireDefaultProgressSink()`
+ * once at startup. Idempotent.
+ *
+ * Consumers:
+ *   - `agent-executor.runTurnLoop()` calls `start()` at loop entry and
+ *     `update()` per tool execution. Both streaming + sequential paths.
+ *   - Future Cowork progress bar can listen on `getProgressTracker()
+ *     .on('progress', ...)` for finer updates than the log thresholds.
+ *
+ * @module src/agent/planner/progress-default-sink
+ */
+import { ProgressTracker } from './progress-tracker.js';
+import { logger } from '../../utils/logger.js';
+let instance = null;
+let wired = false;
+/** Process-level singleton. */
+export function getProgressTracker() {
+    if (instance === null)
+        instance = new ProgressTracker();
+    return instance;
+}
+/**
+ * Register the default log sink. Logs progress at the 25 / 50 / 75 / 100
+ * thresholds (and never twice for the same threshold within a session).
+ * Idempotent — second call is a no-op.
+ */
+export function wireDefaultProgressSink() {
+    if (wired)
+        return;
+    wired = true;
+    const tracker = getProgressTracker();
+    let lastLoggedThreshold = -1;
+    tracker.on('start', (data) => {
+        lastLoggedThreshold = -1;
+        logger.debug?.('[progress] turn started', { total: data.total });
+    });
+    tracker.on('progress', (update) => {
+        const done = update.completed + update.failed;
+        const pct = update.total > 0 ? Math.round((done / update.total) * 100) : 0;
+        // Cross a 25%-quantum threshold → log. Avoids per-tool spam.
+        const bucket = Math.floor(pct / 25) * 25;
+        if (bucket > lastLoggedThreshold && bucket > 0) {
+            lastLoggedThreshold = bucket;
+            const etaPart = update.eta !== undefined ? `, ETA ~${Math.round(update.eta / 1000)}s` : '';
+            logger.info(`[progress] ${pct}% (${done}/${update.total} done${etaPart})`);
+        }
+    });
+}
+/** Test-only — drop the singleton and the wired flag. */
+export function _resetForTests() {
+    instance = null;
+    wired = false;
+}
+//# sourceMappingURL=progress-default-sink.js.map

package/dist/agent/planner/progress-default-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-default-sink.js","sourceRoot":"","sources":["../../../src/agent/planner/progress-default-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,eAAe,EAAuB,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,IAAI,QAAQ,GAA2B,IAAI,CAAC;AAC5C,IAAI,KAAK,GAAG,KAAK,CAAC;AAElB,+BAA+B;AAC/B,MAAM,UAAU,kBAAkB;IAChC,IAAI,QAAQ,KAAK,IAAI;QAAE,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACxD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,IAAI,KAAK;QAAE,OAAO;IAClB,KAAK,GAAG,IAAI,CAAC;IACb,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,IAAI,mBAAmB,GAAG,CAAC,CAAC,CAAC;IAE7B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAuB,EAAE,EAAE;QAC9C,mBAAmB,GAAG,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,KAAK,EAAE,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,MAAsB,EAAE,EAAE;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,6DAA6D;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,MAAM,GAAG,mBAAmB,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,mBAAmB,GAAG,MAAM,CAAC;YAC7B,MAAM,OAAO,GACX,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,MAAM,CAAC,IAAI,CACT,cAAc,GAAG,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,QAAQ,OAAO,GAAG,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,cAAc;IAC5B,QAAQ,GAAG,IAAI,CAAC;IAChB,KAAK,GAAG,KAAK,CAAC;AAChB,CAAC"}

package/dist/agent/proactive/notification-default-sink.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Default notification sink — Phase (d).21 ship 3.
+ *
+ * Activates `NotificationManager` (previously dormant: registered but no
+ * callers). The sink:
+ *   - exposes a single `notify()` helper that the rest of the codebase
+ *     can call without touching the manager directly
+ *   - applies `shouldSend()` gates (channel allowlist, quiet hours,
+ *     rate limit)
+ *   - logs allowed notifications via `logger.info` (low/normal) or
+ *     `logger.warn` (high/urgent) so they're visible in the existing
+ *     log stream; future Cowork IPC bridge can register a richer sink
+ *     by listening on `manager.on('notification:emitted', ...)`.
+ *   - records every attempt in the manager's history (delivered=true
+ *     when allowed, false when gated, for accurate rate-limit math).
+ *
+ * Boot wiring: `codebuddy-agent.ts` calls `wireDefaultNotificationSink()`
+ * once at startup. Idempotent.
+ *
+ * @module src/agent/proactive/notification-default-sink
+ */
+import type { ProactiveMessage } from './proactive-agent.js';
+/**
+ * Register the default log-based sink. Idempotent — second call is a
+ * no-op so the boot path can call it unconditionally.
+ */
+export declare function wireDefaultNotificationSink(): void;
+/**
+ * Send a notification through the manager + default log sink.
+ * Returns `true` when delivered, `false` when gated (or wrapped error).
+ *
+ * Quick-fire helper for callers that don't want to construct a full
+ * `ProactiveMessage` — `notifyQuick` below covers the common case.
+ */
+export declare function notify(msg: ProactiveMessage): boolean;
+/**
+ * Convenience wrapper for the most common case: a CLI-channel
+ * notification with just a message + priority.
+ */
+export declare function notifyQuick(message: string, priority?: ProactiveMessage['priority']): boolean;
+/** Test-only — drop the wired flag so a fresh wire() call wakes again. */
+export declare function _resetForTests(): void;

package/dist/agent/proactive/notification-default-sink.js

@@ -0,0 +1,86 @@
+/**
+ * Default notification sink — Phase (d).21 ship 3.
+ *
+ * Activates `NotificationManager` (previously dormant: registered but no
+ * callers). The sink:
+ *   - exposes a single `notify()` helper that the rest of the codebase
+ *     can call without touching the manager directly
+ *   - applies `shouldSend()` gates (channel allowlist, quiet hours,
+ *     rate limit)
+ *   - logs allowed notifications via `logger.info` (low/normal) or
+ *     `logger.warn` (high/urgent) so they're visible in the existing
+ *     log stream; future Cowork IPC bridge can register a richer sink
+ *     by listening on `manager.on('notification:emitted', ...)`.
+ *   - records every attempt in the manager's history (delivered=true
+ *     when allowed, false when gated, for accurate rate-limit math).
+ *
+ * Boot wiring: `codebuddy-agent.ts` calls `wireDefaultNotificationSink()`
+ * once at startup. Idempotent.
+ *
+ * @module src/agent/proactive/notification-default-sink
+ */
+import { getNotificationManager } from './notification-manager.js';
+import { logger } from '../../utils/logger.js';
+let wired = false;
+/**
+ * Register the default log-based sink. Idempotent — second call is a
+ * no-op so the boot path can call it unconditionally.
+ */
+export function wireDefaultNotificationSink() {
+    if (wired)
+        return;
+    wired = true;
+    // No-op subscription just to mark the manager as "active". Future
+    // sinks (Cowork IPC, system tray) can register their own listeners
+    // on the same EventEmitter instance.
+    getNotificationManager();
+}
+/**
+ * Send a notification through the manager + default log sink.
+ * Returns `true` when delivered, `false` when gated (or wrapped error).
+ *
+ * Quick-fire helper for callers that don't want to construct a full
+ * `ProactiveMessage` — `notifyQuick` below covers the common case.
+ */
+export function notify(msg) {
+    const mgr = getNotificationManager();
+    const verdict = mgr.shouldSend(msg);
+    if (!verdict.allowed) {
+        mgr.record(msg, false);
+        logger.debug?.('[notification] gated', {
+            reason: verdict.reason,
+            priority: msg.priority,
+            channel: msg.channelType,
+        });
+        return false;
+    }
+    // Default log sink — visible in existing logger stream.
+    const logFn = msg.priority === 'high' || msg.priority === 'urgent'
+        ? logger.warn
+        : logger.info;
+    logFn?.(`[notification] ${msg.message}`, {
+        priority: msg.priority,
+        channel: msg.channelType,
+    });
+    mgr.record(msg, true);
+    // Emit for any non-default sinks attached via .on('notification:emitted').
+    mgr.emit('notification:emitted', msg);
+    return true;
+}
+/**
+ * Convenience wrapper for the most common case: a CLI-channel
+ * notification with just a message + priority.
+ */
+export function notifyQuick(message, priority = 'normal') {
+    return notify({
+        channelType: 'cli',
+        channelId: 'default',
+        message,
+        priority,
+    });
+}
+/** Test-only — drop the wired flag so a fresh wire() call wakes again. */
+export function _resetForTests() {
+    wired = false;
+}
+//# sourceMappingURL=notification-default-sink.js.map

package/dist/agent/proactive/notification-default-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-default-sink.js","sourceRoot":"","sources":["../../../src/agent/proactive/notification-default-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,IAAI,KAAK,GAAG,KAAK,CAAC;AAElB;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACzC,IAAI,KAAK;QAAE,OAAO;IAClB,KAAK,GAAG,IAAI,CAAC;IACb,kEAAkE;IAClE,mEAAmE;IACnE,qCAAqC;IACrC,sBAAsB,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,GAAqB;IAC1C,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,MAAM,CAAC,KAAK,EAAE,CAAC,sBAAsB,EAAE;YACrC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,OAAO,EAAE,GAAG,CAAC,WAAW;SACzB,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IACD,wDAAwD;IACxD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAChE,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAChB,KAAK,EAAE,CAAC,kBAAkB,GAAG,CAAC,OAAO,EAAE,EAAE;QACvC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,OAAO,EAAE,GAAG,CAAC,WAAW;KACzB,CAAC,CAAC;IACH,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtB,2EAA2E;IAC3E,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,WAAyC,QAAQ;IAEjD,OAAO,MAAM,CAAC;QACZ,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,SAAS;QACpB,OAAO;QACP,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,cAAc;IAC5B,KAAK,GAAG,KAAK,CAAC;AAChB,CAAC"}

package/dist/agent/prompt-suggestions.d.ts

@@ -14,6 +14,7 @@
 export declare class PromptSuggestionEngine {
     private enabled;
     private cachedSuggestions;
+    private client;
     constructor(enabled?: boolean);
     /**
      * Check if suggestions are enabled
@@ -26,10 +27,6 @@ export declare class PromptSuggestionEngine {
     /**
      * Generate 2-3 follow-up suggestions based on context and last response.
      *
-     * Currently returns the formatted prompt string that would be sent to an LLM.
-     * The actual LLM call is stubbed for now - integrate with CodeBuddyClient
-     * when ready.
-     *
      * @param context - The conversation context or user's last message
      * @param lastResponse - The assistant's last response
      * @returns Array of suggestion strings
@@ -48,8 +45,13 @@ export declare class PromptSuggestionEngine {
      */
     private buildSuggestionPrompt;
     /**
-     * Stub implementation that generates suggestions based on keywords.
-     * Replace with actual LLM call in production.
+     * Generate suggestions with the configured LLM if an API key is available.
+     */
+    private generateSuggestionsWithAI;
+    private getClient;
+    /**
+     * Local heuristic fallback when no LLM is configured.
      */
-    private parseStubSuggestions;
+    private generateHeuristicSuggestions;
+    private parseSuggestions;
 }

package/dist/agent/prompt-suggestions.js

@@ -15,6 +15,7 @@ import { logger } from '../utils/logger.js';
 export class PromptSuggestionEngine {
     enabled;
     cachedSuggestions;
+    client = null;
     constructor(enabled = true) {
         this.enabled = enabled;
         this.cachedSuggestions = [];
@@ -38,10 +39,6 @@ export class PromptSuggestionEngine {
     /**
      * Generate 2-3 follow-up suggestions based on context and last response.
      *
-     * Currently returns the formatted prompt string that would be sent to an LLM.
-     * The actual LLM call is stubbed for now - integrate with CodeBuddyClient
-     * when ready.
-     *
      * @param context - The conversation context or user's last message
      * @param lastResponse - The assistant's last response
      * @returns Array of suggestion strings
@@ -55,11 +52,8 @@ export class PromptSuggestionEngine {
             this.cachedSuggestions = [];
             return [];
         }
-        // Build the prompt that would be sent to the LLM
-        const prompt = this.buildSuggestionPrompt(context, lastResponse);
-        // Stub: parse suggestions from the prompt structure
-        // In production, this would call the LLM and parse the response
-        const suggestions = this.parseStubSuggestions(context, lastResponse);
+        const suggestions = (await this.generateSuggestionsWithAI(context, lastResponse)) ||
+            this.generateHeuristicSuggestions(context, lastResponse);
         this.cachedSuggestions = suggestions;
         logger.debug(`Generated ${suggestions.length} prompt suggestions`);
         return suggestions;
@@ -93,10 +87,51 @@ export class PromptSuggestionEngine {
         ].join('\n');
     }
     /**
-     * Stub implementation that generates suggestions based on keywords.
-     * Replace with actual LLM call in production.
+     * Generate suggestions with the configured LLM if an API key is available.
+     */
+    async generateSuggestionsWithAI(context, lastResponse) {
+        const client = await this.getClient();
+        if (!client) {
+            return null;
+        }
+        try {
+            const response = await client.chat([
+                {
+                    role: 'system',
+                    content: 'You generate concise follow-up prompt suggestions. Return 2 or 3 short suggestions, one per line, with no numbering.',
+                },
+                {
+                    role: 'user',
+                    content: this.buildSuggestionPrompt(context, lastResponse),
+                },
+            ], []);
+            const content = response.choices?.[0]?.message?.content || '';
+            const suggestions = this.parseSuggestions(content);
+            return suggestions.length >= 2 ? suggestions : null;
+        }
+        catch (error) {
+            logger.debug('Falling back to heuristic prompt suggestions', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
+    async getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        const apiKey = process.env.GROK_API_KEY?.trim();
+        if (!apiKey) {
+            return null;
+        }
+        const { CodeBuddyClient } = await import('../codebuddy/client.js');
+        this.client = new CodeBuddyClient(apiKey, process.env.GROK_MODEL || 'grok-code-fast-1');
+        return this.client;
+    }
+    /**
+     * Local heuristic fallback when no LLM is configured.
      */
-    parseStubSuggestions(context, lastResponse) {
+    generateHeuristicSuggestions(context, lastResponse) {
         const combined = `${context} ${lastResponse}`.toLowerCase();
         const suggestions = [];
         if (combined.includes('test')) {
@@ -121,5 +156,21 @@ export class PromptSuggestionEngine {
         }
         return suggestions.slice(0, 3);
     }
+    parseSuggestions(content) {
+        const cleaned = content
+            .split(/\r?\n/)
+            .map((line) => line.replace(/^\s*(?:[-*]|\d+[.)])\s*/, '').trim())
+            .filter(Boolean);
+        const unique = [];
+        for (const suggestion of cleaned) {
+            if (!unique.includes(suggestion)) {
+                unique.push(suggestion);
+            }
+            if (unique.length >= 3) {
+                break;
+            }
+        }
+        return unique;
+    }
 }
 //# sourceMappingURL=prompt-suggestions.js.map

package/dist/agent/prompt-suggestions.js.map

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

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

@@ -8,3 +8,5 @@ export * from "./types.js";
 export { MCTS, createMCTS } from "./mcts.js";
 export { TreeOfThoughtReasoner, createTreeOfThoughtReasoner, getTreeOfThoughtReasoner, resetTreeOfThoughtReasoner, } from "./tree-of-thought.js";
 export type { ToTConfig } from "./tree-of-thought.js";
+export { ReasoningFacade, getReasoningFacade, resetReasoningFacade, } from "./reasoning-facade.js";
+export type { ReasoningOptions, CumulativeUsage } from "./reasoning-facade.js";

package/dist/agent/reasoning/index.js

@@ -10,4 +10,6 @@ export * from "./types.js";
 export { MCTS, createMCTS } from "./mcts.js";
 // Tree-of-Thought Reasoner
 export { TreeOfThoughtReasoner, createTreeOfThoughtReasoner, getTreeOfThoughtReasoner, resetTreeOfThoughtReasoner, } from "./tree-of-thought.js";
+// Reasoning Facade (unified entry point)
+export { ReasoningFacade, getReasoningFacade, resetReasoningFacade, } from "./reasoning-facade.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/reasoning/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE7C,2BAA2B;AAC3B,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/reasoning/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE7C,2BAA2B;AAC3B,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAI9B,yCAAyC;AACzC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}