@bike4mind/cli 0.2.42 → 0.2.43-docs-clawdbot-comparison-analysis.20555

package/dist/{artifactExtractor-35BJBKKL.js → artifactExtractor-MANDHXUQ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CurationArtifactType
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 
 // ../../b4m-core/packages/services/dist/src/notebookCurationService/artifactExtractor.js
 var ARTIFACT_TAG_REGEX = /<artifact\s+(.*?)>([\s\S]*?)<\/artifact>/gi;

package/dist/{chunk-M7WWYJKD.js → chunk-72IBWES7.js}

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@bike4mind/cli",
-  version: "0.2.42",
+  version: "0.2.43-docs-clawdbot-comparison-analysis.20555+07323408b",
   type: "module",
   description: "Interactive CLI tool for Bike4Mind with ReAct agents",
   license: "UNLICENSED",
@@ -108,6 +108,7 @@ var package_default = {
     uuid: "^9.0.1",
     voyageai: "^0.0.4",
     "web-tree-sitter": "0.25.10",
+    ws: "^8.19.0",
     xlsx: "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
     yargs: "^17.7.2",
     yauzl: "^3.1.3",
@@ -117,10 +118,10 @@ var package_default = {
   },
   devDependencies: {
     "@bike4mind/agents": "0.1.0",
-    "@bike4mind/common": "2.62.0",
-    "@bike4mind/mcp": "1.33.4",
-    "@bike4mind/services": "2.58.0",
-    "@bike4mind/utils": "2.13.0",
+    "@bike4mind/common": "2.62.1-docs-clawdbot-comparison-analysis.20555+07323408b",
+    "@bike4mind/mcp": "1.33.5-docs-clawdbot-comparison-analysis.20555+07323408b",
+    "@bike4mind/services": "2.58.1-docs-clawdbot-comparison-analysis.20555+07323408b",
+    "@bike4mind/utils": "2.13.1-docs-clawdbot-comparison-analysis.20555+07323408b",
     "@types/better-sqlite3": "^7.6.13",
     "@types/diff": "^5.0.9",
     "@types/jsonwebtoken": "^9.0.4",
@@ -128,6 +129,7 @@ var package_default = {
     "@types/picomatch": "^4.0.2",
     "@types/react": "^19.2.7",
     "@types/uuid": "^9.0.7",
+    "@types/ws": "^8.18.1",
     "@types/yargs": "^17.0.32",
     "ink-testing-library": "^4.0.0",
     tsup: "^8.5.1",
@@ -138,7 +140,7 @@ var package_default = {
   optionalDependencies: {
     "@vscode/ripgrep": "^1.17.0"
   },
-  gitHead: "74824b6ccd765d6fa6b4ec94d18ba44d90f1f360"
+  gitHead: "07323408b6ba76c4841e86ae5429f3a96ed09ba7"
 };
 
 // src/utils/updateChecker.ts

package/dist/{chunk-6DIDLC5R.js → chunk-E7GZ7B3A.js}

@@ -20,7 +20,7 @@ import {
   extractSnippetMeta,
   isGPTImageModel,
   settingsMap
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 
 // ../../b4m-core/packages/utils/dist/src/storage/S3Storage.js
 import { S3Client, PutObjectCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand } from "@aws-sdk/client-s3";
@@ -2492,6 +2492,162 @@ function getCachingAdapter(backend) {
   return ADAPTERS[backend] || new NoOpCachingAdapter();
 }
 
+// ../../b4m-core/packages/utils/dist/src/retry.js
+import { isAxiosError as isAxiosError2 } from "axios";
+function isRetryableError(error) {
+  const message = error.message.toLowerCase();
+  if (isAxiosError2(error)) {
+    const status = error.response?.status;
+    if (status === 429) {
+      return true;
+    }
+    if (status === 502 || status === 503 || status === 504) {
+      return true;
+    }
+    if (error.code === "ECONNRESET" || error.code === "ETIMEDOUT" || error.code === "ECONNREFUSED") {
+      return true;
+    }
+  }
+  if ("code" in error && (error.code === "ECONNRESET" || error.code === "ETIMEDOUT")) {
+    return true;
+  }
+  const undiciCodes = ["UND_ERR_SOCKET", "UND_ERR_CONNECT_TIMEOUT", "UND_ERR_BODY_TIMEOUT"];
+  if ("code" in error && undiciCodes.includes(String(error.code))) {
+    return true;
+  }
+  if ("code" in error && (error.code === "ENOTFOUND" || error.code === "EAI_AGAIN")) {
+    return true;
+  }
+  if (error.name === "TypeError" && message.includes("terminated")) {
+    return true;
+  }
+  const retryablePatterns = [
+    "econnreset",
+    "etimedout",
+    "connection reset",
+    "connection refused",
+    "socket hang up",
+    "terminated",
+    "network error",
+    "timeout",
+    "rate limit",
+    "too many requests",
+    "service unavailable",
+    "bad gateway",
+    "gateway timeout",
+    "overloaded",
+    // Additional patterns for TLS/socket errors (#6936, #6892)
+    "aborted",
+    // TLS socket close
+    "socket closed",
+    // Generic socket termination
+    "connection closed",
+    // Connection termination
+    "enotfound",
+    // DNS lookup failure
+    "eai_again",
+    // Temporary DNS failure
+    "und_err_socket",
+    // Undici socket error
+    "und_err_connect_timeout",
+    // Undici connection timeout
+    "fetch failed"
+    // Generic fetch failure
+  ];
+  return retryablePatterns.some((pattern) => message.includes(pattern));
+}
+function isUserInitiatedAbort(error, userSignal) {
+  if (userSignal?.aborted) {
+    return true;
+  }
+  const isAbortError = error.name === "AbortError" || error.name === "Error" && error.message === "aborted";
+  if (isAbortError && userSignal && !userSignal.aborted) {
+    return false;
+  }
+  return isAbortError && !userSignal;
+}
+function getRetryAfterMs(error) {
+  if (!isAxiosError2(error)) {
+    return null;
+  }
+  const retryAfter = error.response?.headers?.["retry-after"];
+  if (!retryAfter) {
+    return null;
+  }
+  const seconds = parseInt(retryAfter, 10);
+  if (!isNaN(seconds)) {
+    return seconds * 1e3;
+  }
+  const date = Date.parse(retryAfter);
+  if (!isNaN(date)) {
+    return Math.max(0, date - Date.now());
+  }
+  return null;
+}
+function calculateRetryDelay(attempt, initialDelayMs, maxDelayMs, jitterFactor) {
+  const exponentialDelay = initialDelayMs * Math.pow(2, attempt);
+  const cappedDelay = Math.min(exponentialDelay, maxDelayMs);
+  const jitter = cappedDelay * jitterFactor * (Math.random() * 2 - 1);
+  return Math.max(0, Math.round(cappedDelay + jitter));
+}
+async function sleep(ms, abortSignal) {
+  return new Promise((resolve, reject) => {
+    if (abortSignal?.aborted) {
+      reject(new Error("Aborted"));
+      return;
+    }
+    const timeout = setTimeout(resolve, ms);
+    abortSignal?.addEventListener("abort", () => {
+      clearTimeout(timeout);
+      reject(new Error("Aborted"));
+    });
+  });
+}
+async function withRetry(fn, options = {}) {
+  const { maxRetries = 3, initialDelayMs = 100, maxDelayMs = 5e3, jitterFactor = 0.1, isRetryable = isRetryableError, logger, abortSignal } = options;
+  let attempts = 0;
+  let totalDelayMs = 0;
+  while (true) {
+    try {
+      if (abortSignal?.aborted) {
+        throw new Error("Aborted");
+      }
+      const result = await fn();
+      return { result, attempts, totalDelayMs };
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      if (attempts >= maxRetries || !isRetryable(err)) {
+        throw error;
+      }
+      if (abortSignal?.aborted) {
+        throw error;
+      }
+      let delayMs = calculateRetryDelay(attempts, initialDelayMs, maxDelayMs, jitterFactor);
+      const retryAfterMs = getRetryAfterMs(err);
+      if (retryAfterMs !== null) {
+        delayMs = Math.min(retryAfterMs, maxDelayMs);
+        logger?.info(`Rate limited, using Retry-After delay`, {
+          retryAfterMs,
+          actualDelayMs: delayMs
+        });
+      }
+      attempts++;
+      totalDelayMs += delayMs;
+      logger?.warn(`Retry attempt ${attempts}/${maxRetries} after ${delayMs}ms`, {
+        error: err.message,
+        errorCode: "code" in err ? err.code : void 0,
+        attempt: attempts,
+        delayMs
+      });
+      try {
+        await sleep(delayMs, abortSignal);
+      } catch {
+        throw error;
+      }
+    }
+  }
+}
+
 // ../../b4m-core/packages/utils/dist/src/llm/anthropicBackend.js
 var TEMPERATURE_ONLY_MODELS = [
   ChatModels.CLAUDE_4_5_SONNET,
@@ -3078,7 +3234,15 @@ IMPORTANT! Only when someone asks, remember that you are specifically the ${mode
                 hasThinking: !!apiParams.thinking,
                 thinkingBudget: apiParams.thinking?.budget_tokens
               });
-              const stream = await this._api.messages.create({ ...apiParams, stream: true }, { signal: combinedSignal });
+              const stream = await withRetry(() => this._api.messages.create({ ...apiParams, stream: true }, { signal: combinedSignal }), {
+                maxRetries: 3,
+                initialDelayMs: 500,
+                maxDelayMs: 1e4,
+                jitterFactor: 0.25,
+                isRetryable: (err) => isRetryableError(err) && !isUserInitiatedAbort(err, options.abortSignal),
+                logger: this.logger,
+                abortSignal: combinedSignal
+              }).then((r) => r.result);
               if (requestTimeout)
                 clearTimeout(requestTimeout);
               let isInThinkingBlock = false;
@@ -3354,7 +3518,15 @@ IMPORTANT! Only when someone asks, remember that you are specifically the ${mode
           return;
         }
       } else {
-        const response = await this._api.messages.create(apiParams, { signal: options.abortSignal });
+        const response = await withRetry(() => this._api.messages.create(apiParams, { signal: options.abortSignal }), {
+          maxRetries: 3,
+          initialDelayMs: 500,
+          maxDelayMs: 1e4,
+          jitterFactor: 0.25,
+          isRetryable: (err) => isRetryableError(err) && !isUserInitiatedAbort(err, options.abortSignal),
+          logger: this.logger,
+          abortSignal: options.abortSignal
+        }).then((r) => r.result);
         const streamedText = [];
         if ("content" in response && Array.isArray(response.content)) {
           if (this.isThinkingEnabled) {
@@ -7256,9 +7428,17 @@ var OpenAIBackend = class {
         parameters.parallel_tool_calls = options.parallel_tool_calls;
       }
     }
-    const response = await this._api.chat.completions.create(parameters, {
+    const response = await withRetry(() => this._api.chat.completions.create(parameters, {
       signal: options.abortSignal
-    });
+    }), {
+      maxRetries: 3,
+      initialDelayMs: 500,
+      maxDelayMs: 1e4,
+      jitterFactor: 0.25,
+      isRetryable: (err) => isRetryableError(err) && !isUserInitiatedAbort(err, options.abortSignal),
+      logger: this.logger,
+      abortSignal: options.abortSignal
+    }).then((r) => r.result);
     let inputTokens = 0;
     let outputTokens = 0;
     if (!(response instanceof Stream)) {
@@ -12228,10 +12408,10 @@ function isMermaidSyntax(line) {
 }
 
 // ../../b4m-core/packages/utils/dist/src/adminSettings/fallback.js
-import { isAxiosError as isAxiosError2 } from "axios";
+import { isAxiosError as isAxiosError3 } from "axios";
 function shouldTriggerFallback(error) {
   const message = error.message.toLowerCase();
-  if (isAxiosError2(error)) {
+  if (isAxiosError3(error)) {
     const status = error.response?.status;
     if (status === 429 || status === 502 || status === 503 || status === 504) {
       return true;
@@ -12270,7 +12450,7 @@ function shouldTriggerFallback(error) {
 }
 function isOverloadedError(error) {
   const message = error.message.toLowerCase();
-  if (isAxiosError2(error)) {
+  if (isAxiosError3(error)) {
     const status = error.response?.status;
     if (status === 429 || status === 529 || status === 503) {
       return true;
@@ -12560,128 +12740,6 @@ function extractFilename(input) {
   }
 }
 
-// ../../b4m-core/packages/utils/dist/src/retry.js
-import { isAxiosError as isAxiosError3 } from "axios";
-function isRetryableError(error) {
-  const message = error.message.toLowerCase();
-  if (isAxiosError3(error)) {
-    const status = error.response?.status;
-    if (status === 429) {
-      return true;
-    }
-    if (status === 502 || status === 503 || status === 504) {
-      return true;
-    }
-    if (error.code === "ECONNRESET" || error.code === "ETIMEDOUT" || error.code === "ECONNREFUSED") {
-      return true;
-    }
-  }
-  if ("code" in error && (error.code === "ECONNRESET" || error.code === "ETIMEDOUT")) {
-    return true;
-  }
-  if (error.name === "TypeError" && message.includes("terminated")) {
-    return true;
-  }
-  const retryablePatterns = [
-    "econnreset",
-    "etimedout",
-    "connection reset",
-    "connection refused",
-    "socket hang up",
-    "terminated",
-    "network error",
-    "timeout",
-    "rate limit",
-    "too many requests",
-    "service unavailable",
-    "bad gateway",
-    "gateway timeout",
-    "overloaded"
-  ];
-  return retryablePatterns.some((pattern) => message.includes(pattern));
-}
-function getRetryAfterMs(error) {
-  if (!isAxiosError3(error)) {
-    return null;
-  }
-  const retryAfter = error.response?.headers?.["retry-after"];
-  if (!retryAfter) {
-    return null;
-  }
-  const seconds = parseInt(retryAfter, 10);
-  if (!isNaN(seconds)) {
-    return seconds * 1e3;
-  }
-  const date = Date.parse(retryAfter);
-  if (!isNaN(date)) {
-    return Math.max(0, date - Date.now());
-  }
-  return null;
-}
-function calculateRetryDelay(attempt, initialDelayMs, maxDelayMs, jitterFactor) {
-  const exponentialDelay = initialDelayMs * Math.pow(2, attempt);
-  const cappedDelay = Math.min(exponentialDelay, maxDelayMs);
-  const jitter = cappedDelay * jitterFactor * (Math.random() * 2 - 1);
-  return Math.max(0, Math.round(cappedDelay + jitter));
-}
-async function sleep(ms, abortSignal) {
-  return new Promise((resolve, reject) => {
-    if (abortSignal?.aborted) {
-      reject(new Error("Aborted"));
-      return;
-    }
-    const timeout = setTimeout(resolve, ms);
-    abortSignal?.addEventListener("abort", () => {
-      clearTimeout(timeout);
-      reject(new Error("Aborted"));
-    });
-  });
-}
-async function withRetry(fn, options = {}) {
-  const { maxRetries = 3, initialDelayMs = 100, maxDelayMs = 5e3, jitterFactor = 0.1, isRetryable = isRetryableError, logger, abortSignal } = options;
-  let attempts = 0;
-  let totalDelayMs = 0;
-  while (true) {
-    try {
-      if (abortSignal?.aborted) {
-        throw new Error("Aborted");
-      }
-      const result = await fn();
-      return { result, attempts, totalDelayMs };
-    } catch (error) {
-      const err = error instanceof Error ? error : new Error(String(error));
-      if (attempts >= maxRetries || !isRetryable(err)) {
-        throw error;
-      }
-      if (abortSignal?.aborted) {
-        throw error;
-      }
-      let delayMs = calculateRetryDelay(attempts, initialDelayMs, maxDelayMs, jitterFactor);
-      const retryAfterMs = getRetryAfterMs(err);
-      if (retryAfterMs !== null) {
-        delayMs = Math.min(retryAfterMs, maxDelayMs);
-        logger?.info(`Rate limited, using Retry-After delay`, {
-          retryAfterMs,
-          actualDelayMs: delayMs
-        });
-      }
-      attempts++;
-      totalDelayMs += delayMs;
-      logger?.warn(`Retry attempt ${attempts}/${maxRetries} after ${delayMs}ms`, {
-        error: err.message,
-        errorCode: "code" in err ? err.code : void 0,
-        attempt: attempts,
-        delayMs
-      });
-      try {
-        await sleep(delayMs, abortSignal);
-      } catch {
-        throw error;
-      }
-    }
-  }
-}
-
 // ../../b4m-core/packages/utils/dist/src/voiceHistory.js
 function truncateText(text, maxLength) {
   if (text.length <= maxLength)
@@ -12839,6 +12897,11 @@ export {
   stripAllToolBlocks,
   buildAndSortMessages,
   getLastBuildDebugInfo,
+  isRetryableError,
+  isUserInitiatedAbort,
+  getRetryAfterMs,
+  calculateRetryDelay,
+  withRetry,
   AnthropicBackend,
   extractThinkContent,
   AWSBackend,
@@ -12915,10 +12978,6 @@ export {
   TiktokenTokenizer,
   createTokenizer,
   extractFilename,
-  isRetryableError,
-  getRetryAfterMs,
-  calculateRetryDelay,
-  withRetry,
   formatVoiceHistory,
   buildVoiceInstructions,
   registerLambdaErrorHandlers,

package/dist/{chunk-BDUHALFT.js → chunk-IPX2RZCM.js}

@@ -2,7 +2,7 @@
 import {
   BadRequestError,
   secureParameters
-} from "./chunk-6DIDLC5R.js";
+} from "./chunk-E7GZ7B3A.js";
 import {
   CompletionApiUsageTransaction,
   GenericCreditDeductTransaction,
@@ -13,7 +13,7 @@ import {
   ToolUsageTransaction,
   TransferCreditTransaction,
   VideoGenerationUsageTransaction
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 
 // ../../b4m-core/packages/services/dist/src/creditService/subtractCredits.js
 import { z } from "zod";

package/dist/{chunk-XFH3RPVU.js → chunk-MT4FJGUE.js}

@@ -6,12 +6,12 @@ import {
   getSettingsByNames,
   obfuscateApiKey,
   secureParameters
-} from "./chunk-6DIDLC5R.js";
+} from "./chunk-E7GZ7B3A.js";
 import {
   ApiKeyType,
   MementoTier,
   isSupportedEmbeddingModel
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 
 // ../../b4m-core/packages/services/dist/src/apiKeyService/get.js
 import { z } from "zod";

package/dist/{chunk-XO4KZXR3.js → chunk-MYHJRMFR.js}

@@ -1677,6 +1677,83 @@ var CliToolResponseAction = z10.object({
   content: z10.unknown().optional(),
   error: z10.string().optional()
 });
+var KeepCommandRequestAction = z10.object({
+  action: z10.literal("keep_command_request"),
+  accessToken: z10.string().optional(),
+  commandType: z10.enum(["read_file", "list_directory", "run_tool"]),
+  params: z10.record(z10.string(), z10.unknown()),
+  requestId: z10.string()
+});
+var KeepCommandAction = z10.object({
+  action: z10.literal("keep_command"),
+  commandType: z10.enum(["read_file", "list_directory", "run_tool"]),
+  params: z10.record(z10.string(), z10.unknown()),
+  requestId: z10.string(),
+  originConnectionId: z10.string()
+});
+var KeepCommandResponseAction = z10.object({
+  action: z10.literal("keep_command_response"),
+  requestId: z10.string(),
+  originConnectionId: z10.string(),
+  success: z10.boolean(),
+  result: z10.unknown().optional(),
+  error: z10.string().optional()
+});
+var KeepCommandResultAction = z10.object({
+  action: z10.literal("keep_command_result"),
+  requestId: z10.string(),
+  success: z10.boolean(),
+  result: z10.unknown().optional(),
+  error: z10.string().optional()
+});
+var TilePositionSchema = z10.object({ x: z10.number(), y: z10.number() });
+var SceneCommandSchema = z10.discriminatedUnion("type", [
+  z10.object({
+    type: z10.literal("add_entity"),
+    params: z10.object({
+      id: z10.string(),
+      spriteSheetId: z10.string(),
+      position: TilePositionSchema,
+      facing: z10.enum(["left", "right"]).optional(),
+      animation: z10.string().optional(),
+      visible: z10.boolean().optional(),
+      zIndex: z10.number().optional(),
+      metadata: z10.record(z10.string(), z10.unknown()).optional()
+    })
+  }),
+  z10.object({ type: z10.literal("remove_entity"), id: z10.string() }),
+  z10.object({
+    type: z10.literal("walk_to"),
+    id: z10.string(),
+    target: TilePositionSchema,
+    options: z10.object({ speed: z10.number().optional() }).optional()
+  }),
+  z10.object({ type: z10.literal("teleport"), id: z10.string(), position: TilePositionSchema }),
+  z10.object({ type: z10.literal("play_animation"), id: z10.string(), animation: z10.string(), loop: z10.boolean().optional() }),
+  z10.object({
+    type: z10.literal("show_speech"),
+    id: z10.string(),
+    text: z10.string(),
+    options: z10.object({
+      duration: z10.number().optional(),
+      style: z10.enum(["speech", "thought", "shout"]).optional()
+    }).optional()
+  }),
+  z10.object({ type: z10.literal("clear_speech"), id: z10.string() }),
+  z10.object({ type: z10.literal("set_visible"), id: z10.string(), visible: z10.boolean() }),
+  z10.object({ type: z10.literal("set_facing"), id: z10.string(), facing: z10.enum(["left", "right"]) })
+]);
+var TavernSceneCommandRequestAction = z10.object({
+  action: z10.literal("tavern_scene_command"),
+  accessToken: z10.string().optional(),
+  commands: z10.array(SceneCommandSchema),
+  requestId: z10.string().optional()
+});
+var TavernSceneBroadcastAction = z10.object({
+  action: z10.literal("tavern_scene_broadcast"),
+  commands: z10.array(SceneCommandSchema),
+  clientId: z10.string().optional()
+});
 var SessionCreatedAction = shareableDocumentSchema.extend({
   action: z10.literal("session.created"),
   id: z10.string(),
@@ -1713,7 +1790,10 @@ var MessageDataToServer = z10.discriminatedUnion("action", [
   VoiceSessionSendTranscriptAction,
   VoiceSessionEndedAction,
   CliCompletionRequestAction,
-  CliToolRequestAction
+  CliToolRequestAction,
+  KeepCommandRequestAction,
+  KeepCommandResponseAction,
+  TavernSceneCommandRequestAction
 ]);
 var MessageDataToClient = z10.discriminatedUnion("action", [
   DataSubscriptionUpdateAction,
@@ -1743,7 +1823,10 @@ var MessageDataToClient = z10.discriminatedUnion("action", [
   CliCompletionChunkAction,
   CliCompletionDoneAction,
   CliCompletionErrorAction,
-  CliToolResponseAction
+  CliToolResponseAction,
+  KeepCommandAction,
+  KeepCommandResultAction,
+  TavernSceneBroadcastAction
 ]);
 
 // ../../b4m-core/packages/common/dist/src/schemas/cliCompletions.js
@@ -11422,6 +11505,12 @@ export {
   CliCompletionDoneAction,
   CliCompletionErrorAction,
   CliToolResponseAction,
+  KeepCommandRequestAction,
+  KeepCommandAction,
+  KeepCommandResponseAction,
+  KeepCommandResultAction,
+  TavernSceneCommandRequestAction,
+  TavernSceneBroadcastAction,
   SessionCreatedAction,
   MessageDataToServer,
   MessageDataToClient,

package/dist/{chunk-F33RP5VW.js → chunk-PFUH3PJW.js}

@@ -7,11 +7,11 @@ import {
   getSettingsMap,
   getSettingsValue,
   secureParameters
-} from "./chunk-6DIDLC5R.js";
+} from "./chunk-E7GZ7B3A.js";
 import {
   KnowledgeType,
   SupportedFabFileMimeTypes
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 
 // ../../b4m-core/packages/services/dist/src/fabFileService/create.js
 import { z } from "zod";

package/dist/{chunk-LSGK2ME7.js → chunk-TZVHC4LV.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ChatModels
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 import {
   DEFAULT_SANDBOX_CONFIG
 } from "./chunk-4BIBE3J7.js";

package/dist/{chunk-LIRZ74HT.js → chunk-V4ZPYJ7V.js}

@@ -4,7 +4,7 @@ import {
   getOpenWeatherKey,
   getSerperKey,
   getWolframAlphaKey
-} from "./chunk-XFH3RPVU.js";
+} from "./chunk-MT4FJGUE.js";
 import {
   BFLImageService,
   BaseStorage,
@@ -16,14 +16,14 @@ import {
   OpenAIBackend,
   OpenAIImageService,
   XAIImageService
-} from "./chunk-6DIDLC5R.js";
+} from "./chunk-E7GZ7B3A.js";
 import {
   Logger
 } from "./chunk-PFBYGCOW.js";
 import {
   ConfigStore,
   logger
-} from "./chunk-LSGK2ME7.js";
+} from "./chunk-TZVHC4LV.js";
 import {
   ALERT_THRESHOLDS,
   AiEvents,
@@ -84,7 +84,7 @@ import {
   getViewById,
   resolveNavigationIntents,
   sanitizeTelemetryError
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 
 // src/utils/fileSearch.ts
 import * as fs from "fs";
@@ -16572,6 +16572,9 @@ var WebSocketLlmBackend = class {
 };
 
 // src/ws/WebSocketConnectionManager.ts
+import WsWebSocket from "ws";
+var useWsPolyfill = typeof globalThis.WebSocket === "undefined";
+var WS = useWsPolyfill ? WsWebSocket : globalThis.WebSocket;
 var WebSocketConnectionManager = class {
   constructor(wsUrl, getToken) {
     this.ws = null;
@@ -16579,6 +16582,7 @@ var WebSocketConnectionManager = class {
     this.reconnectAttempts = 0;
     this.maxReconnectDelay = 3e4;
     this.handlers = /* @__PURE__ */ new Map();
+    this.actionHandlers = /* @__PURE__ */ new Map();
     this.disconnectHandlers = /* @__PURE__ */ new Set();
     this.reconnectTimer = null;
     this.connected = false;
@@ -16601,7 +16605,13 @@ var WebSocketConnectionManager = class {
     }
     return new Promise((resolve3, reject) => {
       logger.debug(`[WS] Connecting to ${this.wsUrl}...`);
-      this.ws = new WebSocket(this.wsUrl, [`access_token.${token}`]);
+      if (useWsPolyfill) {
+        this.ws = new WsWebSocket(this.wsUrl, {
+          headers: { "Sec-WebSocket-Protocol": `access_token.${token}` }
+        });
+      } else {
+        this.ws = new WS(this.wsUrl, [`access_token.${token}`]);
+      }
       this.ws.onopen = () => {
         logger.debug("[WS] Connected");
         this.connected = true;
@@ -16618,7 +16628,12 @@ var WebSocketConnectionManager = class {
           if (requestId && this.handlers.has(requestId)) {
             this.handlers.get(requestId)(message);
           } else {
-            logger.debug(`[WS] Unhandled message: ${message.action || "unknown"}`);
+            const action = message.action;
+            if (action && this.actionHandlers.has(action)) {
+              this.actionHandlers.get(action)(message);
+            } else {
+              logger.debug(`[WS] Unhandled message: ${action || "unknown"}`);
+            }
           }
         } catch (err) {
           logger.debug(`[WS] Failed to parse message: ${err}`);
@@ -16633,11 +16648,13 @@ var WebSocketConnectionManager = class {
         }
       };
       this.ws.onerror = (err) => {
-        logger.debug(`[WS] Error: ${err}`);
+        const underlying = err.error;
+        const detail = underlying?.message || String(err);
+        logger.debug(`[WS] Error: ${detail}`);
         if (this.connecting) {
           this.connecting = false;
           this.connected = false;
-          reject(new Error("WebSocket connection failed"));
+          reject(new Error(`WebSocket connection failed: ${detail}`));
         }
       };
     });
@@ -16650,7 +16667,7 @@ var WebSocketConnectionManager = class {
    * Send a JSON message over the WebSocket connection.
    */
   send(data) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+    if (!this.ws || this.ws.readyState !== WS.OPEN) {
       throw new Error("WebSocket is not connected");
     }
     const payload = JSON.stringify(data);
@@ -16673,6 +16690,19 @@ var WebSocketConnectionManager = class {
   offRequest(requestId) {
     this.handlers.delete(requestId);
   }
+  /**
+   * Register a handler for messages matching a specific action type.
+   * Used for server-pushed commands like keep_command.
+   */
+  onAction(action, handler) {
+    this.actionHandlers.set(action, handler);
+  }
+  /**
+   * Remove a handler for a specific action type.
+   */
+  offAction(action) {
+    this.actionHandlers.delete(action);
+  }
   /**
    * Register a handler that fires when the connection drops.
    */
@@ -16696,13 +16726,14 @@ var WebSocketConnectionManager = class {
       this.ws = null;
     }
     this.handlers.clear();
+    this.actionHandlers.clear();
     this.disconnectHandlers.clear();
   }
   startHeartbeat() {
     this.stopHeartbeat();
     this.heartbeatInterval = setInterval(
       () => {
-        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+        if (this.ws && this.ws.readyState === WS.OPEN) {
           this.ws.send(JSON.stringify({ action: "heartbeat" }));
           logger.debug("[WS] Heartbeat sent");
         }

package/dist/commands/doctorCommand.js

@@ -3,7 +3,7 @@ import {
   fetchLatestVersion,
   forceCheckForUpdate,
   package_default
-} from "../chunk-M7WWYJKD.js";
+} from "../chunk-72IBWES7.js";
 
 // src/commands/doctorCommand.ts
 import { execSync } from "child_process";

package/dist/commands/headlessCommand.js

@@ -36,20 +36,20 @@ import {
   isReadOnlyTool,
   loadContextFiles,
   setWebSocketToolExecutor
-} from "../chunk-LIRZ74HT.js";
+} from "../chunk-V4ZPYJ7V.js";
 import "../chunk-BDQBOLYG.js";
-import "../chunk-XFH3RPVU.js";
+import "../chunk-MT4FJGUE.js";
 import "../chunk-GQGOWACU.js";
-import "../chunk-BDUHALFT.js";
-import "../chunk-F33RP5VW.js";
-import "../chunk-6DIDLC5R.js";
+import "../chunk-IPX2RZCM.js";
+import "../chunk-PFUH3PJW.js";
+import "../chunk-E7GZ7B3A.js";
 import "../chunk-PFBYGCOW.js";
 import "../chunk-BPFEGDC7.js";
 import {
   ConfigStore,
   logger
-} from "../chunk-LSGK2ME7.js";
-import "../chunk-XO4KZXR3.js";
+} from "../chunk-TZVHC4LV.js";
+import "../chunk-MYHJRMFR.js";
 import {
   DEFAULT_SANDBOX_CONFIG
 } from "../chunk-4BIBE3J7.js";

package/dist/commands/mcpCommand.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   ConfigStore
-} from "../chunk-LSGK2ME7.js";
-import "../chunk-XO4KZXR3.js";
+} from "../chunk-TZVHC4LV.js";
+import "../chunk-MYHJRMFR.js";
 import "../chunk-4BIBE3J7.js";
 
 // src/commands/mcpCommand.ts

package/dist/commands/updateCommand.js

@@ -2,7 +2,7 @@
 import {
   forceCheckForUpdate,
   package_default
-} from "../chunk-M7WWYJKD.js";
+} from "../chunk-72IBWES7.js";
 
 // src/commands/updateCommand.ts
 import { execSync } from "child_process";

package/dist/{create-JFS6T2CD.js → create-3Y6VAPG4.js}

@@ -2,10 +2,10 @@
 import {
   createFabFile,
   createFabFileSchema
-} from "./chunk-F33RP5VW.js";
-import "./chunk-6DIDLC5R.js";
+} from "./chunk-PFUH3PJW.js";
+import "./chunk-E7GZ7B3A.js";
 import "./chunk-PFBYGCOW.js";
-import "./chunk-XO4KZXR3.js";
+import "./chunk-MYHJRMFR.js";
 export {
   createFabFile,
   createFabFileSchema

package/dist/index.js

@@ -46,23 +46,23 @@ import {
   setWebSocketToolExecutor,
   substituteArguments,
   warmFileCache
-} from "./chunk-LIRZ74HT.js";
+} from "./chunk-V4ZPYJ7V.js";
 import "./chunk-BDQBOLYG.js";
-import "./chunk-XFH3RPVU.js";
+import "./chunk-MT4FJGUE.js";
 import "./chunk-GQGOWACU.js";
-import "./chunk-BDUHALFT.js";
-import "./chunk-F33RP5VW.js";
-import "./chunk-6DIDLC5R.js";
+import "./chunk-IPX2RZCM.js";
+import "./chunk-PFUH3PJW.js";
+import "./chunk-E7GZ7B3A.js";
 import "./chunk-PFBYGCOW.js";
 import "./chunk-BPFEGDC7.js";
 import {
   ConfigStore,
   logger
-} from "./chunk-LSGK2ME7.js";
+} from "./chunk-TZVHC4LV.js";
 import {
   checkForUpdate,
   package_default
-} from "./chunk-M7WWYJKD.js";
+} from "./chunk-72IBWES7.js";
 import {
   selectActiveBackgroundAgents,
   useCliStore
@@ -70,7 +70,7 @@ import {
 import {
   CREDIT_DEDUCT_TRANSACTION_TYPES,
   ChatModels
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 import "./chunk-4BIBE3J7.js";
 
 // src/index.tsx
@@ -2825,14 +2825,65 @@ function CliApp() {
             tokenGetter,
             wsCompletionUrl
           });
+          wsManager.onAction("keep_command", async (message) => {
+            const { commandType, params, requestId, originConnectionId } = message;
+            let result;
+            let success = true;
+            let error;
+            try {
+              switch (commandType) {
+                case "read_file": {
+                  const filePath = params.path;
+                  if (!filePath) throw new Error("Missing required param: path");
+                  logger.info(`[Keep] Reading file: ${filePath}`);
+                  const content = await fs.readFile(filePath, "utf-8");
+                  result = { content, path: filePath };
+                  break;
+                }
+                case "list_directory": {
+                  const dirPath = params.path || ".";
+                  logger.info(`[Keep] Listing directory: ${dirPath}`);
+                  const entries = await fs.readdir(dirPath, { withFileTypes: true });
+                  result = entries.map((e) => ({ name: e.name, isDirectory: e.isDirectory() }));
+                  break;
+                }
+                default:
+                  throw new Error(`Unknown command type: ${commandType}`);
+              }
+            } catch (err) {
+              success = false;
+              error = err instanceof Error ? err.message : String(err);
+            }
+            logger.info(
+              `[Keep] Sending response: success=${success}, originConnectionId=${originConnectionId?.slice(0, 12)}..., resultSize=${JSON.stringify(result)?.length ?? 0}`
+            );
+            try {
+              wsManager.send({
+                action: "keep_command_response",
+                requestId,
+                originConnectionId,
+                success,
+                result,
+                error
+              });
+              logger.info("[Keep] Response sent successfully");
+            } catch (sendErr) {
+              logger.info(
+                `[Keep] Failed to send response: ${sendErr instanceof Error ? sendErr.message : String(sendErr)}`
+              );
+            }
+          });
           logger.debug("\u{1F50C} Using WebSocket transport (bypasses CloudFront timeout)");
         } else {
           throw new Error("No websocketUrl or wsCompletionUrl in server config");
         }
       } catch (wsError) {
-        logger.debug(
-          `[WS] WebSocket unavailable, using SSE fallback: ${wsError instanceof Error ? wsError.message : String(wsError)}`
+        console.error(
+          `\u26A0\uFE0F  WebSocket unavailable, using SSE fallback: ${wsError instanceof Error ? wsError.message : String(wsError)}`
         );
+        if (wsError instanceof Error && wsError.stack) {
+          console.error(wsError.stack);
+        }
         wsManager = null;
         setWebSocketToolExecutor(null);
         llm = new ServerLlmBackend({

package/dist/{llmMarkdownGenerator-U4MPDJOF.js → llmMarkdownGenerator-DXJLV46C.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CurationArtifactType
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 
 // ../../b4m-core/packages/services/dist/src/notebookCurationService/llmMarkdownGenerator.js
 var DEFAULT_OPTIONS = {

package/dist/{markdownGenerator-2VXZR3NZ.js → markdownGenerator-EGUVGELS.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CurationArtifactType
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 
 // ../../b4m-core/packages/services/dist/src/notebookCurationService/markdownGenerator.js
 var DEFAULT_OPTIONS = {

package/dist/{mementoService-KISKEAWK.js → mementoService-F7BYS3TG.js}

@@ -2,10 +2,10 @@
 import {
   findMostSimilarMemento,
   getRelevantMementos
-} from "./chunk-XFH3RPVU.js";
-import "./chunk-6DIDLC5R.js";
+} from "./chunk-MT4FJGUE.js";
+import "./chunk-E7GZ7B3A.js";
 import "./chunk-PFBYGCOW.js";
-import "./chunk-XO4KZXR3.js";
+import "./chunk-MYHJRMFR.js";
 export {
   findMostSimilarMemento,
   getRelevantMementos

package/dist/{src-WUPDSI4P.js → src-7WPKPQ66.js}

@@ -149,6 +149,10 @@ import {
   JIRA_MAX_ATTACHMENT_SIZE,
   JiraApi,
   JiraWebhookDeliveryStatus,
+  KeepCommandAction,
+  KeepCommandRequestAction,
+  KeepCommandResponseAction,
+  KeepCommandResultAction,
   KnowledgeType,
   LEGACY_IMAGE_MODEL_MAP,
   LIVEOPS_TRIAGE_RESULT_VALIDATION_LIMITS,
@@ -334,6 +338,8 @@ import {
   TagType,
   TaskScheduleHandler,
   TaskScheduleStatus,
+  TavernSceneBroadcastAction,
+  TavernSceneCommandRequestAction,
   TextGenerationUsageTransaction,
   TokensBySourceSchema,
   ToolErrorCategorySchema,
@@ -512,7 +518,7 @@ import {
   validateReactArtifactV2,
   validateSvgArtifactV2,
   wikiMarkupToAdf
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 export {
   ALERT_THRESHOLDS,
   ALL_IMAGE_MODELS,
@@ -664,6 +670,10 @@ export {
   JIRA_MAX_ATTACHMENT_SIZE,
   JiraApi,
   JiraWebhookDeliveryStatus,
+  KeepCommandAction,
+  KeepCommandRequestAction,
+  KeepCommandResponseAction,
+  KeepCommandResultAction,
   KnowledgeType,
   LEGACY_IMAGE_MODEL_MAP,
   LIVEOPS_TRIAGE_RESULT_VALIDATION_LIMITS,
@@ -849,6 +859,8 @@ export {
   TagType,
   TaskScheduleHandler,
   TaskScheduleStatus,
+  TavernSceneBroadcastAction,
+  TavernSceneCommandRequestAction,
   TextGenerationUsageTransaction,
   TokensBySourceSchema,
   ToolErrorCategorySchema,

package/dist/{src-SE25E3PT.js → src-Z2NQ33Z7.js}

@@ -120,6 +120,7 @@ import {
   isPrivateIP,
   isPrivateOrInternalHostname,
   isRetryableError,
+  isUserInitiatedAbort,
   isValidEnumValue,
   isZodError,
   obfuscateApiKey,
@@ -140,7 +141,7 @@ import {
   validateUrlForFetch,
   warmUpSettingsCache,
   withRetry
-} from "./chunk-6DIDLC5R.js";
+} from "./chunk-E7GZ7B3A.js";
 import {
   Logger,
   NotificationDeduplicator,
@@ -153,7 +154,7 @@ import {
   buildRateLimitLogEntry,
   isNearLimit,
   parseRateLimitHeaders
-} from "./chunk-XO4KZXR3.js";
+} from "./chunk-MYHJRMFR.js";
 export {
   AIVideoService,
   AWSBackend,
@@ -279,6 +280,7 @@ export {
   isPrivateIP,
   isPrivateOrInternalHostname,
   isRetryableError,
+  isUserInitiatedAbort,
   isValidEnumValue,
   isZodError,
   notificationDeduplicator,

package/dist/{subtractCredits-D23MKI6N.js → subtractCredits-6JTTH5RH.js}

@@ -2,10 +2,10 @@
 import {
   SubtractCreditsSchema,
   subtractCredits
-} from "./chunk-BDUHALFT.js";
-import "./chunk-6DIDLC5R.js";
+} from "./chunk-IPX2RZCM.js";
+import "./chunk-E7GZ7B3A.js";
 import "./chunk-PFBYGCOW.js";
-import "./chunk-XO4KZXR3.js";
+import "./chunk-MYHJRMFR.js";
 export {
   SubtractCreditsSchema,
   subtractCredits

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bike4mind/cli",
-  "version": "0.2.42",
+  "version": "0.2.43-docs-clawdbot-comparison-analysis.20555+07323408b",
   "type": "module",
   "description": "Interactive CLI tool for Bike4Mind with ReAct agents",
   "license": "UNLICENSED",
@@ -105,6 +105,7 @@
     "uuid": "^9.0.1",
     "voyageai": "^0.0.4",
     "web-tree-sitter": "0.25.10",
+    "ws": "^8.19.0",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
     "yargs": "^17.7.2",
     "yauzl": "^3.1.3",
@@ -114,10 +115,10 @@
   },
   "devDependencies": {
     "@bike4mind/agents": "0.1.0",
-    "@bike4mind/common": "2.62.0",
-    "@bike4mind/mcp": "1.33.4",
-    "@bike4mind/services": "2.58.0",
-    "@bike4mind/utils": "2.13.0",
+    "@bike4mind/common": "2.62.1-docs-clawdbot-comparison-analysis.20555+07323408b",
+    "@bike4mind/mcp": "1.33.5-docs-clawdbot-comparison-analysis.20555+07323408b",
+    "@bike4mind/services": "2.58.1-docs-clawdbot-comparison-analysis.20555+07323408b",
+    "@bike4mind/utils": "2.13.1-docs-clawdbot-comparison-analysis.20555+07323408b",
     "@types/better-sqlite3": "^7.6.13",
     "@types/diff": "^5.0.9",
     "@types/jsonwebtoken": "^9.0.4",
@@ -125,6 +126,7 @@
     "@types/picomatch": "^4.0.2",
     "@types/react": "^19.2.7",
     "@types/uuid": "^9.0.7",
+    "@types/ws": "^8.18.1",
     "@types/yargs": "^17.0.32",
     "ink-testing-library": "^4.0.0",
     "tsup": "^8.5.1",
@@ -135,5 +137,5 @@
   "optionalDependencies": {
     "@vscode/ripgrep": "^1.17.0"
   },
-  "gitHead": "74824b6ccd765d6fa6b4ec94d18ba44d90f1f360"
+  "gitHead": "07323408b6ba76c4841e86ae5429f3a96ed09ba7"
 }