@hybridaione/hybridclaw 0.1.21 → 0.1.24

package/container/src/index.ts

@@ -1,8 +1,15 @@
 import path from 'path';
 
 import { emitRuntimeEvent, runAfterToolHooks, runBeforeToolHooks } from './extensions.js';
-import { callHybridAI, HybridAIRequestError } from './hybridai-client.js';
+import { callHybridAI, callHybridAIStream, HybridAIRequestError } from './hybridai-client.js';
 import { waitForInput, writeOutput } from './ipc.js';
+import {
+  accumulateApiUsage,
+  createTokenUsageStats,
+  estimateMessageTokens,
+  estimateTextTokens,
+  finalizeTokenUsage,
+} from './token-usage.js';
 import { executeTool, getPendingSideEffects, resetSideEffects, setModelContext, setScheduledTasks, setSessionContext, TOOL_DEFINITIONS } from './tools.js';
 import type { ArtifactMetadata, ChatMessage, ContainerInput, ContainerOutput, ToolDefinition, ToolExecution } from './types.js';
 
@@ -58,6 +65,12 @@ function sleep(ms: number): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+function emitStreamDelta(delta: string): void {
+  if (!delta) return;
+  const payload = Buffer.from(delta, 'utf-8').toString('base64');
+  console.error(`[stream] ${payload}`);
+}
+
 function isRetryableError(err: unknown): boolean {
   if (err instanceof HybridAIRequestError) {
     return err.status === 429 || (err.status >= 500 && err.status <= 504);
@@ -144,8 +157,18 @@ async function callHybridAIWithRetry(params: {
   enableRag: boolean;
   history: ChatMessage[];
   tools: ToolDefinition[];
+  onTextDelta?: (delta: string) => void;
 }): Promise<Awaited<ReturnType<typeof callHybridAI>>> {
-  const { baseUrl, apiKey, model, chatbotId, enableRag, history, tools } = params;
+  const {
+    baseUrl,
+    apiKey,
+    model,
+    chatbotId,
+    enableRag,
+    history,
+    tools,
+    onTextDelta,
+  } = params;
   let attempt = 0;
   let delayMs = RETRY_BASE_DELAY_MS;
 
@@ -153,7 +176,31 @@ async function callHybridAIWithRetry(params: {
     attempt += 1;
     await emitRuntimeEvent({ event: 'before_model_call', attempt });
     try {
-      const response = await callHybridAI(baseUrl, apiKey, model, chatbotId, enableRag, history, tools);
+      let response;
+      if (onTextDelta) {
+        try {
+          response = await callHybridAIStream(
+            baseUrl,
+            apiKey,
+            model,
+            chatbotId,
+            enableRag,
+            history,
+            tools,
+            onTextDelta,
+          );
+        } catch (streamErr) {
+          const fallbackEligible =
+            streamErr instanceof HybridAIRequestError
+            && streamErr.status >= 400
+            && streamErr.status < 500
+            && streamErr.status !== 429;
+          if (!fallbackEligible) throw streamErr;
+          response = await callHybridAI(baseUrl, apiKey, model, chatbotId, enableRag, history, tools);
+        }
+      } else {
+        response = await callHybridAI(baseUrl, apiKey, model, chatbotId, enableRag, history, tools);
+      }
       await emitRuntimeEvent({ event: 'after_model_call', attempt, toolCallCount: response.choices[0]?.message?.tool_calls?.length || 0 });
       return response;
     } catch (err) {
@@ -189,10 +236,13 @@ async function processRequest(
   const toolExecutions: ToolExecution[] = [];
   const artifacts: ArtifactMetadata[] = [];
   const artifactPaths = new Set<string>();
+  const tokenUsage = createTokenUsageStats();
   let iterations = 0;
 
   while (iterations < MAX_ITERATIONS) {
     iterations++;
+    tokenUsage.modelCalls += 1;
+    tokenUsage.estimatedPromptTokens += estimateMessageTokens(history);
 
     let response;
     try {
@@ -204,6 +254,7 @@ async function processRequest(
         enableRag,
         history,
         tools,
+        onTextDelta: emitStreamDelta,
       });
     } catch (err) {
       const failed: ContainerOutput = {
@@ -212,12 +263,15 @@ async function processRequest(
         toolsUsed,
         ...(artifacts.length > 0 ? { artifacts } : {}),
         toolExecutions,
+        tokenUsage: finalizeTokenUsage(tokenUsage),
         error: `API error: ${err instanceof Error ? err.message : String(err)}`,
       };
       await emitRuntimeEvent({ event: 'turn_end', status: failed.status, toolsUsed });
       return failed;
     }
 
+    accumulateApiUsage(tokenUsage, response);
+
     const choice = response.choices[0];
     if (!choice) {
       const failed: ContainerOutput = {
@@ -226,12 +280,18 @@ async function processRequest(
         toolsUsed,
         ...(artifacts.length > 0 ? { artifacts } : {}),
         toolExecutions,
+        tokenUsage: finalizeTokenUsage(tokenUsage),
         error: 'No response from API',
       };
       await emitRuntimeEvent({ event: 'turn_end', status: failed.status, toolsUsed });
       return failed;
     }
 
+    tokenUsage.estimatedCompletionTokens += estimateTextTokens(choice.message.content);
+    if (choice.message.tool_calls?.length) {
+      tokenUsage.estimatedCompletionTokens += estimateTextTokens(JSON.stringify(choice.message.tool_calls));
+    }
+
     const assistantMessage: ChatMessage = {
       role: 'assistant',
       content: choice.message.content,
@@ -251,6 +311,7 @@ async function processRequest(
         toolsUsed: [...new Set(toolsUsed)],
         ...(artifacts.length > 0 ? { artifacts } : {}),
         toolExecutions,
+        tokenUsage: finalizeTokenUsage(tokenUsage),
       };
       await emitRuntimeEvent({ event: 'turn_end', status: completed.status, toolsUsed: completed.toolsUsed });
       return completed;
@@ -293,6 +354,7 @@ async function processRequest(
           toolsUsed,
           ...(artifacts.length > 0 ? { artifacts } : {}),
           toolExecutions,
+          tokenUsage: finalizeTokenUsage(tokenUsage),
           error: result,
         };
         await emitRuntimeEvent({ event: 'turn_end', status: failed.status, toolsUsed });
@@ -308,6 +370,7 @@ async function processRequest(
     toolsUsed: [...new Set(toolsUsed)],
     ...(artifacts.length > 0 ? { artifacts } : {}),
     toolExecutions,
+    tokenUsage: finalizeTokenUsage(tokenUsage),
   };
   await emitRuntimeEvent({ event: 'turn_end', status: completed.status, toolsUsed: completed.toolsUsed });
   return completed;

package/container/src/token-usage.ts

@@ -0,0 +1,89 @@
+import type { ChatCompletionResponse, ChatMessage, TokenUsageStats } from './types.js';
+
+const CHARS_PER_TOKEN = 4;
+
+function parseUsageNumber(value: unknown): number {
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    return Math.max(0, Math.floor(value));
+  }
+  if (typeof value === 'string' && value.trim()) {
+    const parsed = Number.parseInt(value, 10);
+    if (Number.isFinite(parsed)) return Math.max(0, parsed);
+  }
+  return 0;
+}
+
+export function createTokenUsageStats(): TokenUsageStats {
+  return {
+    modelCalls: 0,
+    apiUsageAvailable: false,
+    apiPromptTokens: 0,
+    apiCompletionTokens: 0,
+    apiTotalTokens: 0,
+    estimatedPromptTokens: 0,
+    estimatedCompletionTokens: 0,
+    estimatedTotalTokens: 0,
+  };
+}
+
+export function estimateTextTokens(text: string | null | undefined): number {
+  const normalized = typeof text === 'string' ? text : '';
+  if (!normalized) return 0;
+  return Math.max(1, Math.ceil(normalized.length / CHARS_PER_TOKEN));
+}
+
+export function estimateMessageTokens(messages: ChatMessage[]): number {
+  if (!Array.isArray(messages) || messages.length === 0) return 0;
+
+  let total = 2;
+  for (const message of messages) {
+    total += 4;
+    total += estimateTextTokens(message.role);
+    total += estimateTextTokens(message.content);
+    if (message.tool_calls) total += estimateTextTokens(JSON.stringify(message.tool_calls));
+    if (message.tool_call_id) total += estimateTextTokens(message.tool_call_id);
+  }
+  return total;
+}
+
+export function accumulateApiUsage(
+  stats: TokenUsageStats,
+  response: ChatCompletionResponse,
+): void {
+  const usage = response.usage;
+  if (!usage) return;
+
+  const hasUsageFields =
+    usage.prompt_tokens != null
+    || usage.completion_tokens != null
+    || usage.total_tokens != null
+    || usage.input_tokens != null
+    || usage.output_tokens != null;
+  if (!hasUsageFields) return;
+
+  const promptTokens = parseUsageNumber(usage.prompt_tokens ?? usage.input_tokens);
+  const completionTokens = parseUsageNumber(usage.completion_tokens ?? usage.output_tokens);
+  let totalTokens = parseUsageNumber(usage.total_tokens);
+  if (totalTokens === 0 && (promptTokens > 0 || completionTokens > 0)) {
+    totalTokens = promptTokens + completionTokens;
+  }
+
+  stats.apiUsageAvailable = true;
+  stats.apiPromptTokens += promptTokens;
+  stats.apiCompletionTokens += completionTokens;
+  stats.apiTotalTokens += totalTokens;
+}
+
+export function finalizeTokenUsage(stats: TokenUsageStats): TokenUsageStats {
+  const estimatedTotalTokens = stats.estimatedPromptTokens + stats.estimatedCompletionTokens;
+  let apiTotalTokens = stats.apiTotalTokens;
+  if (stats.apiUsageAvailable && apiTotalTokens === 0) {
+    apiTotalTokens = stats.apiPromptTokens + stats.apiCompletionTokens;
+  }
+
+  return {
+    ...stats,
+    apiTotalTokens,
+    estimatedTotalTokens,
+  };
+}

package/container/src/tools.ts

@@ -879,7 +879,14 @@ export async function executeTool(name: string, argsJson: string): Promise<strin
         });
         const header = result.title ? `# ${result.title}\n\n` : '';
         const meta = `[${result.extractor}] ${result.finalUrl} (${result.status}, ${result.tookMs}ms)`;
-        return `${meta}\n\n${header}${result.text}`;
+        const lines = [meta];
+        if (result.escalationHint) {
+          lines.push(`Escalation hint: ${result.escalationHint} (retry with browser_navigate for this URL).`);
+        }
+        if (result.warning) {
+          lines.push(`Warning: ${result.warning}`);
+        }
+        return `${lines.join('\n')}\n\n${header}${result.text}`;
       }
 
       case 'browser_navigate':
@@ -1207,7 +1214,7 @@ export const TOOL_DEFINITIONS: ToolDefinition[] = [
     function: {
       name: 'web_fetch',
       description:
-        'Fetch a URL and extract its readable content as markdown or plain text. Works with HTML pages, JSON APIs, and markdown URLs. Use for reading web pages, documentation, API responses, etc.',
+        'Fetch a URL via plain HTTP GET and extract readable content (HTML to markdown/text). No JavaScript execution, no clicks, no form interaction. Use for static read-only retrieval: articles, docs, wikis, READMEs, API JSON/text endpoints, and direct files/PDFs. Avoid for SPAs (React/Vue/Angular/Next client routes), auth/login-gated pages, dashboards/web apps, bot/challenge flows, or content loaded after render via XHR/fetch. Cost: typically ~10-100x cheaper/faster than browser tools. Default to web_fetch for read-only retrieval, then escalate to browser_navigate when output is empty/boilerplate, JavaScript-required, SPA shell-only, or bot-blocked.',
       parameters: {
         type: 'object',
         properties: {

package/container/src/types.ts

@@ -25,6 +25,13 @@ export interface ChatCompletionResponse {
     finish_reason: string;
   }>;
   model: string;
+  usage?: {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    input_tokens?: number;
+    output_tokens?: number;
+  };
 }
 
 export interface ToolDefinition {
@@ -76,6 +83,17 @@ export interface ToolExecution {
   blockedReason?: string;
 }
 
+export interface TokenUsageStats {
+  modelCalls: number;
+  apiUsageAvailable: boolean;
+  apiPromptTokens: number;
+  apiCompletionTokens: number;
+  apiTotalTokens: number;
+  estimatedPromptTokens: number;
+  estimatedCompletionTokens: number;
+  estimatedTotalTokens: number;
+}
+
 export interface ArtifactMetadata {
   path: string;
   filename: string;
@@ -88,6 +106,7 @@ export interface ContainerOutput {
   toolsUsed: string[];
   artifacts?: ArtifactMetadata[];
   toolExecutions?: ToolExecution[];
+  tokenUsage?: TokenUsageStats;
   error?: string;
   sideEffects?: {
     schedules?: ScheduleSideEffect[];

package/container/src/web-fetch.ts

@@ -19,6 +19,25 @@ const TIMEOUT_MS = 30_000;
 const CACHE_TTL_MS = 15 * 60_000; // 15 min
 const CACHE_MAX_ENTRIES = 100;
 const READABILITY_MAX_HTML_CHARS = 1_000_000;
+const ESCALATION_MIN_TEXT_CHARS = 200;
+const ESCALATION_MIN_HTML_CHARS = 5_000;
+const BOT_BLOCKED_PATTERNS = [
+  'access denied',
+  'bot detected',
+  'captcha',
+  'cf-chl-',
+  'checking your browser',
+  'cloudflare',
+  'just a moment',
+  'attention required',
+  'verification required',
+];
+const JAVASCRIPT_REQUIRED_PATTERNS = [
+  'enable javascript',
+  'javascript required',
+  'requires javascript',
+  'turn on javascript',
+];
 const USER_AGENT =
   'Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36';
 
@@ -271,10 +290,71 @@ async function fetchWithRedirects(
   throw new Error(`Too many redirects (max ${maxRedirects})`);
 }
 
+function normalizeForDetection(value: string): string {
+  return String(value || '').toLowerCase().replace(/\s+/g, ' ').trim();
+}
+
+function includesAny(haystack: string, needles: readonly string[]): boolean {
+  for (const needle of needles) {
+    if (haystack.includes(needle)) return true;
+  }
+  return false;
+}
+
+function detectEscalationHint(params: {
+  status: number;
+  contentType: string;
+  body: string;
+  extractedText: string;
+}): WebFetchEscalationHint | undefined {
+  const normalizedBody = normalizeForDetection(params.body);
+  if (params.status === 403 || params.status === 429 || includesAny(normalizedBody, BOT_BLOCKED_PATTERNS)) {
+    return 'bot_blocked';
+  }
+
+  const isHtml = params.contentType.toLowerCase().includes('text/html');
+  if (!isHtml) return undefined;
+
+  if (
+    /<noscript[\s\S]{0,2000}javascript[\s\S]{0,2000}<\/noscript>/i.test(params.body) ||
+    includesAny(normalizedBody, JAVASCRIPT_REQUIRED_PATTERNS)
+  ) {
+    return 'javascript_required';
+  }
+
+  if (
+    /<div[^>]+id=["'](?:root|app|__next)["'][^>]*>\s*<\/div>/i.test(params.body) &&
+    normalizeForDetection(params.extractedText).length < ESCALATION_MIN_TEXT_CHARS
+  ) {
+    return 'spa_shell_only';
+  }
+
+  const normalizedExtracted = normalizeForDetection(params.extractedText);
+  if (normalizedExtracted.length === 0) {
+    return 'empty_extraction';
+  }
+
+  if (
+    normalizedExtracted.length < ESCALATION_MIN_TEXT_CHARS &&
+    params.body.length > ESCALATION_MIN_HTML_CHARS
+  ) {
+    return 'boilerplate_only';
+  }
+
+  return undefined;
+}
+
 // ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
 
+export type WebFetchEscalationHint =
+  | 'javascript_required'
+  | 'empty_extraction'
+  | 'spa_shell_only'
+  | 'bot_blocked'
+  | 'boilerplate_only';
+
 export interface WebFetchResult {
   url: string;
   finalUrl: string;
@@ -290,6 +370,7 @@ export interface WebFetchResult {
   text: string;
   cached?: boolean;
   warning?: string;
+  escalationHint?: WebFetchEscalationHint;
 }
 
 export async function webFetch(params: {
@@ -327,10 +408,6 @@ export async function webFetch(params: {
       controller.signal,
     );
 
-    if (!res.ok) {
-      throw new Error(`Web fetch failed (${res.status}): ${res.statusText}`);
-    }
-
     const contentType = res.headers.get('content-type') ?? 'application/octet-stream';
     const normalizedContentType = contentType.split(';')[0]?.trim() || 'application/octet-stream';
     const bodyResult = await readResponseText(res, MAX_RESPONSE_BYTES);
@@ -357,13 +434,26 @@ export async function webFetch(params: {
       }
     }
 
+    const extractedText = extractMode === 'text' ? text : markdownToText(text);
+    const escalationHint = detectEscalationHint({
+      status: res.status,
+      contentType: normalizedContentType,
+      body,
+      extractedText,
+    });
+
+    if (!res.ok && !escalationHint) {
+      throw new Error(`Web fetch failed (${res.status}): ${res.statusText}`);
+    }
+
     // Truncate
     const truncated = text.length > maxChars;
     if (truncated) text = text.slice(0, maxChars);
 
-    const warning = bodyResult.truncated
-      ? `Response body truncated after ${MAX_RESPONSE_BYTES} bytes.`
-      : undefined;
+    const warnings: string[] = [];
+    if (!res.ok) warnings.push(`HTTP ${res.status} ${res.statusText}.`);
+    if (bodyResult.truncated) warnings.push(`Response body truncated after ${MAX_RESPONSE_BYTES} bytes.`);
+    const warning = warnings.length > 0 ? warnings.join(' ') : undefined;
 
     const result: WebFetchResult = {
       url: params.url,
@@ -379,6 +469,7 @@ export async function webFetch(params: {
       tookMs: Date.now() - start,
       text,
       warning,
+      escalationHint,
     };
 
     writeCache(cacheKey, result);

package/dist/agent.d.ts

@@ -1,3 +1,3 @@
 import type { ChatMessage, ContainerOutput, ScheduledTask, ToolProgressEvent } from './types.js';
-export declare function runAgent(sessionId: string, messages: ChatMessage[], chatbotId: string, enableRag: boolean, model: string, agentId: string, channelId: string, scheduledTasks?: ScheduledTask[], allowedTools?: string[], onToolProgress?: (event: ToolProgressEvent) => void, abortSignal?: AbortSignal): Promise<ContainerOutput>;
+export declare function runAgent(sessionId: string, messages: ChatMessage[], chatbotId: string, enableRag: boolean, model: string, agentId: string, channelId: string, scheduledTasks?: ScheduledTask[], allowedTools?: string[], onTextDelta?: (delta: string) => void, onToolProgress?: (event: ToolProgressEvent) => void, abortSignal?: AbortSignal): Promise<ContainerOutput>;
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAWjG,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,EAAE,EAChC,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,EACnD,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC,CAG1B"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAWjG,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,EAAE,EAChC,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACrC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,EACnD,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC,CAgB1B"}

package/dist/agent.js

@@ -14,8 +14,8 @@ function dumpPrompt(sessionId, messages, model, chatbotId) {
     }
     catch { /* best-effort */ }
 }
-export async function runAgent(sessionId, messages, chatbotId, enableRag, model, agentId, channelId, scheduledTasks, allowedTools, onToolProgress, abortSignal) {
+export async function runAgent(sessionId, messages, chatbotId, enableRag, model, agentId, channelId, scheduledTasks, allowedTools, onTextDelta, onToolProgress, abortSignal) {
     dumpPrompt(sessionId, messages, model, chatbotId);
-    return runContainer(sessionId, messages, chatbotId, enableRag, model, agentId, channelId, scheduledTasks, allowedTools, onToolProgress, abortSignal);
+    return runContainer(sessionId, messages, chatbotId, enableRag, model, agentId, channelId, scheduledTasks, allowedTools, onTextDelta, onToolProgress, abortSignal);
 }
 //# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,yFAAyF;AACzF,SAAS,UAAU,CAAC,SAAiB,EAAE,QAAuB,EAAE,KAAa,EAAE,SAAiB;IAC9F,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,SAAiB,EACjB,QAAuB,EACvB,SAAiB,EACjB,SAAkB,EAClB,KAAa,EACb,OAAe,EACf,SAAiB,EACjB,cAAgC,EAChC,YAAuB,EACvB,cAAmD,EACnD,WAAyB;IAEzB,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAClD,OAAO,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;AACvJ,CAAC"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,yFAAyF;AACzF,SAAS,UAAU,CAAC,SAAiB,EAAE,QAAuB,EAAE,KAAa,EAAE,SAAiB;IAC9F,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,SAAiB,EACjB,QAAuB,EACvB,SAAiB,EACjB,SAAkB,EAClB,KAAa,EACb,OAAe,EACf,SAAiB,EACjB,cAAgC,EAChC,YAAuB,EACvB,WAAqC,EACrC,cAAmD,EACnD,WAAyB;IAEzB,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAClD,OAAO,YAAY,CACjB,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,KAAK,EACL,OAAO,EACP,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,CACZ,CAAC;AACJ,CAAC"}

package/dist/chunk.d.ts

@@ -0,0 +1,6 @@
+export interface ChunkMessageOptions {
+    maxChars?: number;
+    maxLines?: number;
+}
+export declare function chunkMessage(text: string, opts?: ChunkMessageOptions): string[];
+//# sourceMappingURL=chunk.d.ts.map

package/dist/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../src/chunk.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAiFD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAoE/E"}

package/dist/chunk.js

@@ -0,0 +1,129 @@
+const DEFAULT_MAX_CHARS = 1_900;
+const DEFAULT_MAX_LINES = 20;
+function isFenceLine(line) {
+    return line.trim().startsWith('```');
+}
+function parseFenceLanguage(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith('```'))
+        return '';
+    return trimmed.slice(3).trim();
+}
+function findSentenceBoundary(input) {
+    let best = -1;
+    const re = /[.!?]\s+/g;
+    for (let match = re.exec(input); match; match = re.exec(input)) {
+        best = match.index + match[0].length;
+    }
+    return best;
+}
+function findPreferredSplit(input, hardLimit) {
+    const limit = Math.max(1, Math.min(hardLimit, input.length));
+    const window = input.slice(0, limit);
+    const paragraph = window.lastIndexOf('\n\n');
+    if (paragraph >= Math.floor(limit * 0.45)) {
+        return paragraph + 2;
+    }
+    const line = window.lastIndexOf('\n');
+    if (line >= Math.floor(limit * 0.45)) {
+        return line + 1;
+    }
+    const sentence = findSentenceBoundary(window);
+    if (sentence >= Math.floor(limit * 0.45)) {
+        return sentence;
+    }
+    const word = window.lastIndexOf(' ');
+    if (word >= Math.floor(limit * 0.35)) {
+        return word + 1;
+    }
+    return limit;
+}
+function splitLongLine(line, maxChars) {
+    if (line.length <= maxChars)
+        return [line];
+    const pieces = [];
+    let remaining = line;
+    while (remaining.length > maxChars) {
+        let splitAt = findPreferredSplit(remaining, maxChars);
+        if (splitAt <= 0 || splitAt > remaining.length) {
+            splitAt = Math.min(maxChars, remaining.length);
+        }
+        const head = remaining.slice(0, splitAt).trimEnd();
+        if (!head) {
+            const fallback = remaining.slice(0, maxChars);
+            pieces.push(fallback);
+            remaining = remaining.slice(maxChars);
+            continue;
+        }
+        pieces.push(head);
+        remaining = remaining.slice(splitAt).trimStart();
+    }
+    if (remaining.length > 0) {
+        pieces.push(remaining);
+    }
+    return pieces;
+}
+export function chunkMessage(text, opts) {
+    const maxChars = Math.max(200, opts?.maxChars ?? DEFAULT_MAX_CHARS);
+    const maxLines = Math.max(4, opts?.maxLines ?? DEFAULT_MAX_LINES);
+    const normalized = (text || '').replace(/\r\n?/g, '\n');
+    if (!normalized.trim())
+        return [];
+    const inputLines = normalized.split('\n');
+    const chunks = [];
+    let currentLines = [];
+    let currentChars = 0;
+    let openFence = false;
+    let fenceLanguage = '';
+    const flush = (isFinal) => {
+        if (currentLines.length === 0)
+            return;
+        let chunk = currentLines.join('\n');
+        if (openFence) {
+            chunk += '\n```';
+        }
+        chunks.push(chunk);
+        if (!isFinal && openFence) {
+            const reopenedFence = fenceLanguage ? `\`\`\`${fenceLanguage}` : '```';
+            currentLines = [reopenedFence];
+            currentChars = reopenedFence.length;
+        }
+        else {
+            currentLines = [];
+            currentChars = 0;
+            if (isFinal && openFence) {
+                openFence = false;
+                fenceLanguage = '';
+            }
+        }
+    };
+    const appendLine = (line) => {
+        const addedChars = currentLines.length === 0 ? line.length : line.length + 1;
+        const nextChars = currentChars + addedChars;
+        const nextLines = currentLines.length + 1;
+        if (currentLines.length > 0 && (nextChars > maxChars || nextLines > maxLines)) {
+            flush(false);
+        }
+        currentLines.push(line);
+        currentChars = currentLines.length === 1 ? line.length : currentChars + line.length + 1;
+        if (isFenceLine(line)) {
+            if (!openFence) {
+                openFence = true;
+                fenceLanguage = parseFenceLanguage(line);
+            }
+            else {
+                openFence = false;
+                fenceLanguage = '';
+            }
+        }
+    };
+    for (const rawLine of inputLines) {
+        const splitLines = splitLongLine(rawLine, maxChars);
+        for (const part of splitLines) {
+            appendLine(part);
+        }
+    }
+    flush(true);
+    return chunks;
+}
+//# sourceMappingURL=chunk.js.map

package/dist/chunk.js.map

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

package/dist/container-runner.d.ts

@@ -3,7 +3,7 @@ export declare function getActiveContainerCount(): number;
 /**
  * Send a request to a persistent container and wait for the response.
  */
-export declare function runContainer(sessionId: string, messages: ChatMessage[], chatbotId: string, enableRag: boolean, model?: string, agentId?: string, channelId?: string, scheduledTasks?: ScheduledTask[], allowedTools?: string[], onToolProgress?: (event: ToolProgressEvent) => void, abortSignal?: AbortSignal): Promise<ContainerOutput>;
+export declare function runContainer(sessionId: string, messages: ChatMessage[], chatbotId: string, enableRag: boolean, model?: string, agentId?: string, channelId?: string, scheduledTasks?: ScheduledTask[], allowedTools?: string[], onTextDelta?: (delta: string) => void, onToolProgress?: (event: ToolProgressEvent) => void, abortSignal?: AbortSignal): Promise<ContainerOutput>;
 /**
  * Stop all containers (for graceful shutdown).
  */

package/dist/container-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-runner.d.ts","sourceRoot":"","sources":["../src/container-runner.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAqC,WAAW,EAAkB,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAqDpJ,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAqKD;;GAEG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,KAAK,GAAE,MAAuB,EAC9B,OAAO,GAAE,MAAkB,EAC3B,SAAS,GAAE,MAAW,EACtB,cAAc,CAAC,EAAE,aAAa,EAAE,EAChC,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,EACnD,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC,CA4F1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC"}
+{"version":3,"file":"container-runner.d.ts","sourceRoot":"","sources":["../src/container-runner.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAqC,WAAW,EAAkB,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAsEpJ,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAuKD;;GAEG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,KAAK,GAAE,MAAuB,EAC9B,OAAO,GAAE,MAAkB,EAC3B,SAAS,GAAE,MAAW,EACtB,cAAc,CAAC,EAAE,aAAa,EAAE,EAChC,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACrC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,EACnD,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,eAAe,CAAC,CAgG1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC"}