@phuetz/code-buddy 1.6.1 → 2.0.0

package/dist/codebuddy/stream-retry.d.ts

@@ -3,7 +3,7 @@
  * exponential-backoff retry on retryable errors.
  *
  * Derived from the comparative audit Gemini CLI vs Code Buddy
- * (claude-et-patrice/propositions/AUDIT-GEMINI-CLI-AGENTIC-LOOP-2026-05-04.md,
+ * (le dépôt privé de passation, propositions/AUDIT-GEMINI-CLI-AGENTIC-LOOP-2026-05-04.md,
  * recommendation #1 — vrai gap, M scope).
  *
  * Problem
@@ -31,10 +31,15 @@
  * Standalone module: pure function, easily testable, opt-in at the
  * call site. Does NOT modify `CodeBuddyClient.chatStream()` itself —
  * zero risk to existing callers.
- */
-/**
- * Options controlling the retry behavior. Mirrors Gemini CLI's
- * `MID_STREAM_RETRY_OPTIONS` shape with sensible defaults.
+ *
+ * HTTP-aware classification (2026-07)
+ * -----------------------------------
+ * Retryability now delegates to `classifyProviderError` (see
+ * `provider-error-classifier.ts`), so the predicate is no longer blind to
+ * HTTP status codes: 408/425/429/5xx are retryable, while a *fatal* 429
+ * (`insufficient_quota` / auth / invalid request) fails fast instead of
+ * re-knocking on a closed door. When the error carries a `Retry-After`, the
+ * back-off waits exactly that (bounded) instead of the blind exponential.
  */
 export interface StreamRetryOptions {
     /** Max retry attempts (the initial call counts as attempt 1; default 4 = 1 initial + 3 retries). */
@@ -57,8 +62,11 @@ export interface StreamRetryOptions {
     onRetry?: (attempt: number, delayMs: number, err: unknown) => void;
 }
 /**
- * Default heuristic for retryability. Matches the patterns we see in
- * the wild from undici / node fetch / ws libs.
+ * Default heuristic for retryability. Delegates to the HTTP-aware
+ * `classifyProviderError` so the predicate covers both the classic network
+ * errors (ECONNRESET, socket hang up, undici stream terminated …) AND HTTP
+ * status codes (408/425/429/5xx retryable; fatal 429/quota/auth/invalid fail
+ * fast). A fatal error is, by construction, `retryable === false`.
  */
 declare function defaultIsRetryable(err: unknown): boolean;
 /**
@@ -81,4 +89,9 @@ declare function defaultIsRetryable(err: unknown): boolean;
 export declare function withStreamRetry<T>(factory: () => AsyncGenerator<T> | AsyncIterable<T>, options?: StreamRetryOptions): AsyncGenerator<T>;
 /** Test-only: re-export the default isRetryable predicate for direct testing. */
 export declare const _defaultIsRetryableForTests: typeof defaultIsRetryable;
-export {};
+/**
+ * Re-export the HTTP-aware classifier so callers wiring their own predicate
+ * (or inspecting a fatal/quota verdict) can reach it from the stream-retry
+ * module without a second import.
+ */
+export { classifyProviderError, parseRetryAfter, preserveProviderErrorMetadata, MAX_RETRY_AFTER_MS, type ProviderErrorClassification, } from './provider-error-classifier.js';

package/dist/codebuddy/stream-retry.js

@@ -3,7 +3,7 @@
  * exponential-backoff retry on retryable errors.
  *
  * Derived from the comparative audit Gemini CLI vs Code Buddy
- * (claude-et-patrice/propositions/AUDIT-GEMINI-CLI-AGENTIC-LOOP-2026-05-04.md,
+ * (le dépôt privé de passation, propositions/AUDIT-GEMINI-CLI-AGENTIC-LOOP-2026-05-04.md,
  * recommendation #1 — vrai gap, M scope).
  *
  * Problem
@@ -31,7 +31,21 @@
  * Standalone module: pure function, easily testable, opt-in at the
  * call site. Does NOT modify `CodeBuddyClient.chatStream()` itself —
  * zero risk to existing callers.
+ *
+ * HTTP-aware classification (2026-07)
+ * -----------------------------------
+ * Retryability now delegates to `classifyProviderError` (see
+ * `provider-error-classifier.ts`), so the predicate is no longer blind to
+ * HTTP status codes: 408/425/429/5xx are retryable, while a *fatal* 429
+ * (`insufficient_quota` / auth / invalid request) fails fast instead of
+ * re-knocking on a closed door. When the error carries a `Retry-After`, the
+ * back-off waits exactly that (bounded) instead of the blind exponential.
+ */
+/**
+ * Options controlling the retry behavior. Mirrors Gemini CLI's
+ * `MID_STREAM_RETRY_OPTIONS` shape with sensible defaults.
  */
+import { classifyProviderError } from './provider-error-classifier.js';
 const DEFAULT_OPTIONS = {
     maxAttempts: 4,
     initialDelayMs: 1000,
@@ -39,45 +53,22 @@ const DEFAULT_OPTIONS = {
     isRetryable: defaultIsRetryable,
 };
 /**
- * Default heuristic for retryability. Matches the patterns we see in
- * the wild from undici / node fetch / ws libs.
+ * Default heuristic for retryability. Delegates to the HTTP-aware
+ * `classifyProviderError` so the predicate covers both the classic network
+ * errors (ECONNRESET, socket hang up, undici stream terminated …) AND HTTP
+ * status codes (408/425/429/5xx retryable; fatal 429/quota/auth/invalid fail
+ * fast). A fatal error is, by construction, `retryable === false`.
  */
 function defaultIsRetryable(err) {
-    if (!err)
-        return false;
-    const e = err;
-    // Common Node network error codes worth retrying
-    if (typeof e.code === 'string') {
-        const code = e.code;
-        if (code === 'ECONNRESET' ||
-            code === 'ECONNREFUSED' ||
-            code === 'ETIMEDOUT' ||
-            code === 'ENOTFOUND' ||
-            code === 'EAI_AGAIN' ||
-            code === 'EPIPE' ||
-            code === 'UND_ERR_SOCKET') {
-            return true;
-        }
-    }
-    // Undici-style error names
-    if (typeof e.name === 'string') {
-        const name = e.name;
-        if (name === 'AbortError' && (e.message ?? '').toLowerCase().includes('network'))
-            return true;
-        if (name === 'FetchError' || name === 'NetworkError' || name === 'TimeoutError')
-            return true;
-    }
-    // Loose message-level fallback
-    if (typeof e.message === 'string') {
-        const m = e.message.toLowerCase();
-        if (m.includes('socket hang up'))
-            return true;
-        if (m.includes('terminated') && m.includes('stream'))
-            return true;
-        if (m.includes('upstream connect error'))
-            return true;
-    }
-    return false;
+    return classifyProviderError(err).retryable;
+}
+/**
+ * Server-instructed back-off (ms) for this error, if any, already bounded to
+ * a sane max by the classifier. Used to override the blind exponential delay
+ * when the provider sent a `Retry-After`.
+ */
+function retryAfterDelayMs(err) {
+    return classifyProviderError(err).retryAfterMs;
 }
 /**
  * Wrap an async generator factory with exponential-backoff retry.
@@ -124,8 +115,15 @@ export async function* withStreamRetry(factory, options = {}) {
             if (!opts.isRetryable(err)) {
                 throw err;
             }
-            // Exponential backoff: initial * 2^(attempt-1), capped at max.
-            const delay = Math.min(opts.initialDelayMs * Math.pow(2, attempt - 1), opts.maxDelayMs);
+            // Honour a server-sent Retry-After (already bounded to MAX_RETRY_AFTER_MS
+            // by the classifier) — it overrides the blind exponential back-off,
+            // including opts.maxDelayMs, since the server told us exactly how long to
+            // wait. Otherwise fall back to exponential: initial * 2^(attempt-1),
+            // capped at max.
+            const serverDelay = retryAfterDelayMs(err);
+            const delay = serverDelay !== undefined
+                ? serverDelay
+                : Math.min(opts.initialDelayMs * Math.pow(2, attempt - 1), opts.maxDelayMs);
             opts.onRetry?.(attempt, delay, err);
             await waitWithAbort(delay, opts.signal);
         }
@@ -164,4 +162,10 @@ async function waitWithAbort(ms, signal) {
 }
 /** Test-only: re-export the default isRetryable predicate for direct testing. */
 export const _defaultIsRetryableForTests = defaultIsRetryable;
+/**
+ * Re-export the HTTP-aware classifier so callers wiring their own predicate
+ * (or inspecting a fatal/quota verdict) can reach it from the stream-retry
+ * module without a second import.
+ */
+export { classifyProviderError, parseRetryAfter, preserveProviderErrorMetadata, MAX_RETRY_AFTER_MS, } from './provider-error-classifier.js';
 //# sourceMappingURL=stream-retry.js.map

package/dist/codebuddy/tool-definitions/advanced-tools.d.ts

@@ -15,6 +15,7 @@ export declare const SUBAGENT_TOOL: CodeBuddyTool;
 export declare const DOCKER_TOOL: CodeBuddyTool;
 export declare const KUBERNETES_TOOL: CodeBuddyTool;
 export declare const PROCESS_TOOL: CodeBuddyTool;
+export declare const APP_SERVER_TOOL: CodeBuddyTool;
 export declare const JS_REPL_TOOL: CodeBuddyTool;
 export declare const REASON_TOOL: CodeBuddyTool;
 export declare const PLAN_TOOL: CodeBuddyTool;
@@ -24,4 +25,7 @@ export declare const EXECUTE_CODE_TOOL: CodeBuddyTool;
  * All advanced tools as an array
  */
 export declare const CODE_GRAPH_TOOL: CodeBuddyTool;
+export declare const DEPLOY_TOOL: CodeBuddyTool;
+export declare const DOCS_SEARCH_TOOL: CodeBuddyTool;
+export declare const KNOWLEDGE_GRAPH_TOOL: CodeBuddyTool;
 export declare const ADVANCED_TOOLS: CodeBuddyTool[];

package/dist/codebuddy/tool-definitions/advanced-tools.js

@@ -544,6 +544,57 @@ export const PROCESS_TOOL = {
         }
     }
 };
+// Managed dev-server lifecycle (develop → launch → browse → verify)
+export const APP_SERVER_TOOL = {
+    type: "function",
+    function: {
+        name: "app_server",
+        description: "Start a local dev server (e.g. 'npm run dev') as a managed background process, wait until its loopback URL answers, and make that origin browsable by the browser tool — use this to TEST a web app you just built. The origin stays browsable only while the server runs. Actions: start, stop, status, logs (server-side stdout/stderr — check them alongside browser_console for both faces of a bug), expose (PUBLIC preview URL via tunnel, TTL-limited — only when the user asks to share/see the app remotely, never for servers handling secrets), unexpose.",
+        parameters: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    enum: ["start", "stop", "status", "logs", "expose", "unexpose"],
+                    description: "The app server action to perform"
+                },
+                command: {
+                    type: "string",
+                    description: "Shell command that starts the server, e.g. 'npm run dev' (start)"
+                },
+                url: {
+                    type: "string",
+                    description: "Loopback readiness URL, e.g. http://127.0.0.1:5173/ — must be localhost/127.x/::1 and the port must be free (start)"
+                },
+                cwd: {
+                    type: "string",
+                    description: "Working directory for the server command (start)"
+                },
+                timeoutMs: {
+                    type: "number",
+                    description: "Readiness timeout in ms (start, default 45000)"
+                },
+                pid: {
+                    type: "number",
+                    description: "Managed server pid (stop, logs, expose, unexpose)"
+                },
+                lines: {
+                    type: "number",
+                    description: "Number of log lines (logs, default 100)"
+                },
+                stderr: {
+                    type: "boolean",
+                    description: "Show stderr instead of stdout (logs)"
+                },
+                ttlMinutes: {
+                    type: "number",
+                    description: "Public preview lifetime in minutes (expose, default 30, max 240)"
+                }
+            },
+            required: ["action"]
+        }
+    }
+};
 // JavaScript REPL tool for sandboxed code execution
 export const JS_REPL_TOOL = {
     type: "function",
@@ -723,6 +774,139 @@ export const CODE_GRAPH_TOOL = {
         },
     },
 };
+export const DEPLOY_TOOL = {
+    type: "function",
+    function: {
+        name: "deploy",
+        description: "Deploy applications to cloud platforms (Fly.io, Railway, Render, GCP, Hetzner, Northflank). Generate configs, deploy, check status, or view logs. Requires confirmation. Not a substitute for git or docker.",
+        parameters: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    enum: ["generate_config", "deploy", "status", "logs"],
+                    description: "Deployment action: generate_config, deploy, status, or logs",
+                },
+                platform: {
+                    type: "string",
+                    enum: ["fly", "railway", "render", "hetzner", "northflank", "gcp"],
+                    description: "Target cloud platform",
+                },
+                appName: {
+                    type: "string",
+                    description: "Application name (used in config generation)",
+                },
+                region: {
+                    type: "string",
+                    description: "Deployment region (e.g. iad, us-central1)",
+                },
+                port: {
+                    type: "number",
+                    description: "Application port (default: 3000)",
+                },
+                env: {
+                    type: "object",
+                    description: "Environment variables as key-value pairs",
+                    additionalProperties: { type: "string" },
+                },
+                memory: {
+                    type: "string",
+                    description: "Memory allocation (e.g. 512mb, 1gb)",
+                },
+                cpus: {
+                    type: "number",
+                    description: "Number of CPU cores",
+                },
+                outputDir: {
+                    type: "string",
+                    description: "Directory to write generated config files (for generate_config action)",
+                },
+                tailLines: {
+                    type: "number",
+                    description: "Number of log lines to retrieve (default: 50, for logs action)",
+                },
+            },
+            required: ["action", "platform"],
+        },
+    },
+};
+export const DOCS_SEARCH_TOOL = {
+    type: "function",
+    function: {
+        name: "docs_search",
+        description: "Search project documentation for architecture, API, security, and configuration information. Read-only local docs lookup — not a web search.",
+        parameters: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query (e.g. \"security model\", \"authentication flow\")",
+                },
+                scope: {
+                    type: "string",
+                    enum: ["all", "architecture", "api", "security", "config", "testing"],
+                    description: "Limit to a category (default: all)",
+                },
+            },
+            required: ["query"],
+        },
+    },
+};
+export const KNOWLEDGE_GRAPH_TOOL = {
+    type: "function",
+    function: {
+        name: "knowledge_graph",
+        description: "Query the in-memory code knowledge graph for entity relationships (imports, calls, extends, exports). Actions: query, add, subgraph, path, stats. Distinct from code_graph (static analysis over the repo).",
+        parameters: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    enum: ["query", "add", "subgraph", "path", "stats"],
+                    description: "Action to perform on the knowledge graph",
+                },
+                subject: {
+                    type: "string",
+                    description: "Triple subject (entity name, e.g. \"src/index.ts\", \"MyClass\"). Used by query and add.",
+                },
+                predicate: {
+                    type: "string",
+                    description: "Triple predicate (relationship type: imports, exports, calls, extends, implements, dependsOn, contains, definedIn, usedBy, typeof). Used by query and add.",
+                },
+                object: {
+                    type: "string",
+                    description: "Triple object (target entity). Used by query and add.",
+                },
+                metadata: {
+                    type: "object",
+                    description: "Optional metadata key-value pairs for add action.",
+                    additionalProperties: { type: "string" },
+                },
+                entity: {
+                    type: "string",
+                    description: "Entity name for subgraph exploration.",
+                },
+                depth: {
+                    type: "number",
+                    description: "Max traversal depth for subgraph (default: 2).",
+                },
+                from: {
+                    type: "string",
+                    description: "Starting entity for path finding.",
+                },
+                to: {
+                    type: "string",
+                    description: "Target entity for path finding.",
+                },
+                maxDepth: {
+                    type: "number",
+                    description: "Max path length for path finding (default: 5).",
+                },
+            },
+            required: ["action"],
+        },
+    },
+};
 export const ADVANCED_TOOLS = [
     MULTI_EDIT_TOOL,
     GIT_TOOL,
@@ -732,10 +916,14 @@ export const ADVANCED_TOOLS = [
     DOCKER_TOOL,
     KUBERNETES_TOOL,
     PROCESS_TOOL,
+    APP_SERVER_TOOL,
     JS_REPL_TOOL,
     REASON_TOOL,
     PLAN_TOOL,
     EXECUTE_CODE_TOOL,
     RUN_SCRIPT_TOOL,
+    DEPLOY_TOOL,
+    DOCS_SEARCH_TOOL,
+    KNOWLEDGE_GRAPH_TOOL,
 ];
 //# sourceMappingURL=advanced-tools.js.map

package/dist/codebuddy/tool-definitions/agent-tools.d.ts

@@ -8,6 +8,7 @@
  * - knowledge_search / knowledge_add
  * - ask_human
  * - create_skill
+ * - extension_forge
  * - skill_discover
  * - device_manage
  * - spawn_parallel_agents
@@ -24,6 +25,7 @@ export declare const KNOWLEDGE_SEARCH_TOOL: CodeBuddyTool;
 export declare const KNOWLEDGE_ADD_TOOL: CodeBuddyTool;
 export declare const ASK_HUMAN_TOOL: CodeBuddyTool;
 export declare const CREATE_SKILL_TOOL: CodeBuddyTool;
+export declare const EXTENSION_FORGE_TOOL: CodeBuddyTool;
 export declare const SKILL_DISCOVER_TOOL: CodeBuddyTool;
 export declare const SKILLS_LIST_TOOL: CodeBuddyTool;
 export declare const SKILL_VIEW_TOOL: CodeBuddyTool;
@@ -31,6 +33,9 @@ export declare const SKILL_MANAGE_TOOL: CodeBuddyTool;
 export declare const DEVICE_MANAGE_TOOL: CodeBuddyTool;
 export declare const SPAWN_PARALLEL_AGENTS_TOOL: CodeBuddyTool;
 export declare const REMEMBER_TOOL: CodeBuddyTool;
+export declare const REPLACE_MEMORY_TOOL: CodeBuddyTool;
+export declare const REMIND_TOOL: CodeBuddyTool;
+export declare const MEMORY_PROPOSE_TOOL: CodeBuddyTool;
 export declare const RECALL_TOOL: CodeBuddyTool;
 export declare const FORGET_TOOL: CodeBuddyTool;
 export declare const RELATIONSHIP_CONTEXT_TOOL: CodeBuddyTool;