@x-code-cli/core 0.1.3 → 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guangzhi Tan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,15 @@
+# @x-code-cli/core
+
+[简体中文](./README.md) · [English](./README.en.md)
+
+Core AI engine powering [X-Code CLI](https://github.com/woai3c/x-code-cli).
+
+This package is the headless runtime consumed by `@x-code-cli/cli` — agent loop, tools, provider registry, and permission system. It has **no UI dependencies** and can in principle be embedded in other tools.
+
+> ⚠️ The public API is not yet stable — breaking changes may happen between minor versions. If you just want the CLI, install [`@x-code-cli/cli`](https://www.npmjs.com/package/@x-code-cli/cli) directly.
+
+For full installation, API key setup, and usage, see the [main repo README](https://github.com/woai3c/x-code-cli).
+
+## License
+
+[MIT](https://github.com/woai3c/x-code-cli/blob/main/LICENSE)

package/README.md

@@ -0,0 +1,15 @@
+# @x-code-cli/core
+
+[简体中文](./README.md) · [English](./README.en.md)
+
+[X-Code CLI](https://github.com/woai3c/x-code-cli) 的核心 AI 引擎。
+
+本包是 `@x-code-cli/cli` 使用的无头（headless）运行时，包含 Agent 循环、工具、模型厂商适配、权限系统等逻辑，**不依赖任何 UI 框架**，理论上可以嵌入到其他工具中使用。
+
+> ⚠️ 公共 API 尚未稳定，小版本之间可能会有破坏性变更。如果你只是想使用 CLI，请直接安装 [`@x-code-cli/cli`](https://www.npmjs.com/package/@x-code-cli/cli)。
+
+完整的安装说明、API Key 配置、使用方式请看 [主仓库 README](https://github.com/woai3c/x-code-cli)。
+
+## License
+
+[MIT](https://github.com/woai3c/x-code-cli/blob/main/LICENSE)

package/dist/agent/api-errors.d.ts

@@ -0,0 +1,11 @@
+/** Extract HTTP status from "status code 400", "(400)", or "400 ..." */
+export declare function extractHttpStatus(msg: string): number;
+/** True when an error message indicates the request exceeded the context window. */
+export declare function isContextTooLongError(err: unknown): boolean;
+export interface ClassifiedError {
+    message: string;
+    retryable: boolean;
+}
+/** Classify API error and return a user-friendly recovery message. */
+export declare function classifyApiError(err: unknown): ClassifiedError;
+//# sourceMappingURL=api-errors.d.ts.map

package/dist/agent/api-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-errors.d.ts","sourceRoot":"","sources":["../../src/agent/api-errors.ts"],"names":[],"mappings":"AAaA,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAM3D;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;CACnB;AAwBD,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAgG9D"}

package/dist/agent/api-errors.js

@@ -0,0 +1,134 @@
+// @x-code-cli/core — API error classification & pattern detection
+/** Substrings that signal the request exceeded the model's context window. */
+const CONTEXT_TOO_LONG_PATTERNS = [
+    'maximum context length',
+    'context_length_exceeded',
+    'token limit',
+    'prompt is too long',
+    'prompt_too_long',
+    'input tokens',
+    'context window',
+];
+/** Extract HTTP status from "status code 400", "(400)", or "400 ..." */
+export function extractHttpStatus(msg) {
+    const match = msg.match(/\bstatus(?:\s+code)?\s+(\d{3})\b/i) ?? msg.match(/\((\d{3})\)/) ?? msg.match(/^(\d{3})\s/);
+    return match ? Number(match[1]) : 0;
+}
+/** True when an error message indicates the request exceeded the context window. */
+export function isContextTooLongError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    for (const pattern of CONTEXT_TOO_LONG_PATTERNS) {
+        if (msg.includes(pattern))
+            return true;
+    }
+    return false;
+}
+/**
+ * Extract a meaningful error message from AI SDK errors. TypeValidationError
+ * (thrown when a provider returns non-standard JSON — e.g. Alibaba returning
+ * an error object instead of an SSE stream) embeds the real provider message
+ * inside its `.value` property. We dig it out so classifyApiError can pattern-
+ * match on the actual provider error, not the Zod validation wrapper.
+ */
+function extractErrorMessage(err) {
+    if (!(err instanceof Error))
+        return String(err);
+    const msg = err.message;
+    // AI SDK TypeValidationError: the real provider error lives in `.value`
+    const val = err.value;
+    if (val && typeof val === 'object') {
+        const inner = val.error;
+        if (inner && typeof inner === 'object') {
+            const innerMsg = inner.message;
+            if (typeof innerMsg === 'string')
+                return innerMsg;
+        }
+    }
+    return msg;
+}
+/** Classify API error and return a user-friendly recovery message. */
+export function classifyApiError(err) {
+    const msg = extractErrorMessage(err);
+    const status = extractHttpStatus(msg);
+    if (isContextTooLongError(err)) {
+        return {
+            message: "Context too long — the conversation exceeded the model's token limit. Try /compact to compress context, or /clear to start fresh.",
+            retryable: false,
+        };
+    }
+    if (msg.includes('Missing `reasoning_content`') || msg.includes('reasoning_content')) {
+        return {
+            message: 'DeepSeek Reasoner requires reasoning_content in assistant messages during tool-call chains. This is usually an SDK compatibility issue — please report it.',
+            retryable: false,
+        };
+    }
+    if (msg.includes('API key is missing') || msg.includes('API_KEY')) {
+        const providerMatch = msg.match(/^(\w+)\s+API key/i);
+        const provider = providerMatch ? providerMatch[1] : 'Provider';
+        return {
+            message: `${provider} API key is not set. Please set the corresponding environment variable (e.g. ${provider.toUpperCase()}_API_KEY).`,
+            retryable: false,
+        };
+    }
+    if (status === 401 || msg.includes('Unauthorized') || msg.includes('Invalid API Key')) {
+        return {
+            message: 'API authentication failed (401). Please check your API key with /model or reconfigure with `xc init`.',
+            retryable: false,
+        };
+    }
+    if (status === 402 ||
+        msg.includes('Insufficient Balance') ||
+        msg.includes('insufficient_balance') ||
+        msg.includes('insufficient_quota') ||
+        msg.includes('exceeded your current quota')) {
+        return {
+            message: 'API account balance insufficient (402). Top up your provider account, or switch to a different provider with /model.',
+            retryable: false,
+        };
+    }
+    if (status === 403 || msg.includes('Forbidden')) {
+        return {
+            message: 'API access forbidden (403). Your API key may not have permission for this model.',
+            retryable: false,
+        };
+    }
+    if (msg.includes('Invalid max_tokens') ||
+        msg.includes('Range of max_tokens') ||
+        msg.includes('InvalidParameter') ||
+        (msg.includes('max_tokens') && (msg.includes('invalid') || msg.includes('Invalid') || msg.includes('range') || msg.includes('Range')))) {
+        return {
+            message: 'The configured max_tokens exceeds this model\'s limit. Try switching to a different model with /model, or report this issue so we can add the correct ceiling.',
+            retryable: false,
+        };
+    }
+    if (status === 503 || msg.includes('Service Unavailable') || msg.includes('overloaded')) {
+        return {
+            message: 'Model service unavailable (503). Try switching to a different model with /model.',
+            retryable: false,
+        };
+    }
+    if (status === 429 || msg.includes('rate limit') || msg.includes('Rate limit')) {
+        return {
+            message: 'Rate limited (429). Waiting for retry... (AI SDK handles exponential backoff automatically with maxRetries: 3)',
+            retryable: true,
+        };
+    }
+    if (msg.includes('timeout') || msg.includes('ETIMEDOUT') || msg.includes('ECONNRESET')) {
+        return {
+            message: `Network error: ${msg}. Retrying...`,
+            retryable: true,
+        };
+    }
+    // AI SDK TypeValidationError — provider returned a non-standard response
+    // (e.g. an error JSON body instead of a valid SSE stream). Surface the
+    // provider's error message rather than the raw Zod validation dump.
+    if ((err instanceof Error && err.constructor.name === 'AI_TypeValidationError') ||
+        msg.includes('Type validation failed')) {
+        return {
+            message: `Provider returned an error: ${msg}. Try a different model with /model.`,
+            retryable: false,
+        };
+    }
+    return { message: msg, retryable: false };
+}
+//# sourceMappingURL=api-errors.js.map

package/dist/agent/api-errors.js.map

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

package/dist/agent/context-window.d.ts

@@ -0,0 +1,26 @@
+import type { ModelMessage } from 'ai';
+/**
+ * Compress context when usage exceeds this fraction of the model's context
+ * window. Two checks use this:
+ *   1. After each turn — based on the **real** input-token count reported by
+ *      the API, which is the most reliable signal.
+ *   2. Before each API call — based on a **character-based estimate** as a
+ *      safety net. Estimates drift (tool output, non-ASCII), so we use a
+ *      conservative multiplier. The estimate catches cases where a single
+ *      turn (e.g. reading a huge file) pushes context past the limit before
+ *      the real count is available.
+ */
+export declare const COMPRESSION_TRIGGER_RATIO = 0.8;
+/** Resolve context window (tokens) for a model id like `provider:model`. */
+export declare function getContextWindow(modelId: string): number;
+/** Token threshold above which we trigger compression for a given model. */
+export declare function getCompressionThreshold(modelId: string): number;
+/** Resolve the max_tokens ceiling we send to the provider. */
+export declare function getMaxOutputTokens(modelId: string): number;
+/**
+ * Estimate total token count from messages using character length.
+ * This is intentionally conservative (over-counting) to serve as a safety net
+ * that fires before the real API limit is hit.
+ */
+export declare function estimateTokenCount(messages: ModelMessage[]): number;
+//# sourceMappingURL=context-window.d.ts.map

package/dist/agent/context-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.d.ts","sourceRoot":"","sources":["../../src/agent/context-window.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAEtC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AA4D5C,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AA0BD,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAYnE"}

package/dist/agent/context-window.js

@@ -0,0 +1,126 @@
+/**
+ * Compress context when usage exceeds this fraction of the model's context
+ * window. Two checks use this:
+ *   1. After each turn — based on the **real** input-token count reported by
+ *      the API, which is the most reliable signal.
+ *   2. Before each API call — based on a **character-based estimate** as a
+ *      safety net. Estimates drift (tool output, non-ASCII), so we use a
+ *      conservative multiplier. The estimate catches cases where a single
+ *      turn (e.g. reading a huge file) pushes context past the limit before
+ *      the real count is available.
+ */
+export const COMPRESSION_TRIGGER_RATIO = 0.8;
+/**
+ * Rough chars-per-token ratio for pre-call estimation. Most English text is
+ * ~4 chars/token; CJK and code can be lower. We use 3.0 (aggressive) so the
+ * estimate over-counts slightly, making the safety net trigger earlier.
+ */
+const CHARS_PER_TOKEN_ESTIMATE = 3.0;
+/** Default context window when both model- and provider-level lookups miss. */
+const DEFAULT_CONTEXT_WINDOW = 128000;
+/** Context window sizes per model (tokens). */
+const MODEL_CONTEXT_WINDOWS = new Map([
+    // Anthropic
+    ['anthropic:claude-opus-4-7', 1000000],
+    ['anthropic:claude-sonnet-4-6', 1000000],
+    ['anthropic:claude-haiku-4-5', 200000],
+    // OpenAI
+    ['openai:gpt-4.1', 1047576],
+    ['openai:gpt-4.1-mini', 1047576],
+    ['openai:gpt-4.1-nano', 1047576],
+    ['openai:o3', 200000],
+    ['openai:o4-mini', 200000],
+    // Google
+    ['google:gemini-2.5-pro', 1000000],
+    ['google:gemini-2.5-flash', 1000000],
+    // DeepSeek
+    ['deepseek:deepseek-v4-flash', 1000000],
+    ['deepseek:deepseek-v4-pro', 1000000],
+    // Alibaba — per DashScope docs: qwen-turbo and qwen3-coder-plus extend to 1M;
+    // qwen-max still caps at 32k (use qwen3-max for 256k). Values verified against
+    // https://help.aliyun.com/zh/model-studio/models.
+    ['alibaba:qwen-turbo', 1000000],
+    ['alibaba:qwen-plus', 131072],
+    ['alibaba:qwen-max', 32768],
+    ['alibaba:qwen3-max', 262144],
+    ['alibaba:qwen3-coder-plus', 1000000],
+    ['alibaba:qwq-plus', 131072],
+    // xAI
+    ['xai:grok-3', 131072],
+    ['xai:grok-3-mini', 131072],
+    // Zhipu
+    ['zhipu:glm-4-plus', 128000],
+    // Moonshot
+    ['moonshotai:kimi-k2.5', 131072],
+]);
+/** Provider-level fallback context windows. */
+const PROVIDER_CONTEXT_WINDOWS = new Map([
+    ['anthropic', 1000000],
+    ['openai', 128000],
+    ['google', 1000000],
+    ['deepseek', 1000000],
+    ['alibaba', 128000],
+    ['xai', 128000],
+    ['zhipu', 128000],
+    ['moonshotai', 128000],
+]);
+/** Resolve context window (tokens) for a model id like `provider:model`. */
+export function getContextWindow(modelId) {
+    const exact = MODEL_CONTEXT_WINDOWS.get(modelId);
+    if (exact !== undefined)
+        return exact;
+    const provider = modelId.split(':')[0];
+    return PROVIDER_CONTEXT_WINDOWS.get(provider) ?? DEFAULT_CONTEXT_WINDOW;
+}
+/** Token threshold above which we trigger compression for a given model. */
+export function getCompressionThreshold(modelId) {
+    return Math.floor(getContextWindow(modelId) * COMPRESSION_TRIGGER_RATIO);
+}
+/**
+ * Per-model cap on max_tokens (reply size). Some providers reject requests
+ * that exceed their ceiling rather than clamping silently.
+ * For models without an explicit entry, we fall back to a high default that
+ * the AI SDK will clamp for known providers.
+ */
+const DEFAULT_MAX_OUTPUT_TOKENS = 16384;
+const MODEL_MAX_OUTPUT_TOKENS = new Map([
+    // DeepSeek V4: both flash and pro advertise up to 384K output tokens.
+    // We cap at a generous but conservative 131072 to avoid edge-case 400s.
+    ['deepseek:deepseek-v4-flash', 131072],
+    ['deepseek:deepseek-v4-pro', 131072],
+    // Alibaba — qwen-turbo rejects anything above 16384; other Qwen3 models
+    // support 32768 (non-thinking) / 81920 (thinking mode). We cap at the
+    // non-thinking ceiling so the request always succeeds. qwen-max only has a
+    // 32k context window, so we keep its output ceiling well below that.
+    ['alibaba:qwen-turbo', 16384],
+    ['alibaba:qwen-plus', 32000],
+    ['alibaba:qwen-max', 8192],
+    ['alibaba:qwen3-max', 32000],
+    ['alibaba:qwen3-coder-plus', 32000],
+    ['alibaba:qwq-plus', 32000],
+]);
+/** Resolve the max_tokens ceiling we send to the provider. */
+export function getMaxOutputTokens(modelId) {
+    return MODEL_MAX_OUTPUT_TOKENS.get(modelId) ?? DEFAULT_MAX_OUTPUT_TOKENS;
+}
+/**
+ * Estimate total token count from messages using character length.
+ * This is intentionally conservative (over-counting) to serve as a safety net
+ * that fires before the real API limit is hit.
+ */
+export function estimateTokenCount(messages) {
+    let chars = 0;
+    for (const msg of messages) {
+        if (typeof msg.content === 'string') {
+            chars += msg.content.length;
+        }
+        else if (Array.isArray(msg.content)) {
+            for (const part of msg.content) {
+                if (typeof part.text === 'string')
+                    chars += part.text.length;
+            }
+        }
+    }
+    return Math.ceil(chars / CHARS_PER_TOKEN_ESTIMATE);
+}
+//# sourceMappingURL=context-window.js.map

package/dist/agent/context-window.js.map

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

package/dist/agent/loop-state.d.ts

@@ -0,0 +1,14 @@
+import type { ModelMessage } from 'ai';
+import type { TokenUsage } from '../types/index.js';
+export interface LoopState {
+    messages: ModelMessage[];
+    tokenUsage: TokenUsage;
+    /** Real input-token count from the most recent API response, used to trigger compression. */
+    lastInputTokens: number;
+    sessionId: string;
+    startedAt: string;
+    filesModified: Set<string>;
+    turnCount: number;
+}
+export declare function createLoopState(): LoopState;
+//# sourceMappingURL=loop-state.d.ts.map

package/dist/agent/loop-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-state.d.ts","sourceRoot":"","sources":["../../src/agent/loop-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,UAAU,EAAE,UAAU,CAAA;IACtB,6FAA6F;IAC7F,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,eAAe,IAAI,SAAS,CAU3C"}

package/dist/agent/loop-state.js

@@ -0,0 +1,12 @@
+export function createLoopState() {
+    return {
+        messages: [],
+        tokenUsage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
+        lastInputTokens: 0,
+        sessionId: Date.now().toString(36),
+        startedAt: new Date().toISOString(),
+        filesModified: new Set(),
+        turnCount: 0,
+    };
+}
+//# sourceMappingURL=loop-state.js.map

package/dist/agent/loop-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-state.js","sourceRoot":"","sources":["../../src/agent/loop-state.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;QAC/D,eAAe,EAAE,CAAC;QAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,aAAa,EAAE,IAAI,GAAG,EAAE;QACxB,SAAS,EAAE,CAAC;KACb,CAAA;AACH,CAAC"}

package/dist/agent/loop.d.ts

@@ -1,19 +1,15 @@
 import type { LanguageModel, ModelMessage } from 'ai';
-import type { AgentCallbacks, AgentOptions, TokenUsage } from '../types/index.js';
-export interface LoopState {
-    messages: ModelMessage[];
-    tokenUsage: TokenUsage;
-    planMode: boolean;
-    planId: string | null;
-    sessionId: string;
-    startedAt: string;
-    filesModified: Set<string>;
-    turnCount: number;
-}
-/** Compress old messages into a summary */
+import type { AgentCallbacks, AgentOptions } from '../types/index.js';
+import type { LoopState } from './loop-state.js';
+export type { LoopState } from './loop-state.js';
+/** Compress old messages into a summary. */
 export declare function compressMessages(messages: ModelMessage[], model: LanguageModel): Promise<ModelMessage[]>;
-/** Main agent loop */
+/** Main agent loop. */
 export declare function agentLoop(userMessage: string, model: LanguageModel, options: AgentOptions, callbacks: AgentCallbacks, existingState?: LoopState): Promise<LoopState>;
-/** Save session on exit */
-export declare function saveSession(state: LoopState, model: LanguageModel): Promise<void>;
+/** Save session on exit. Summary generation makes an LLM call that can be
+ *  slow, so we bound it with a 2s timeout — on Ctrl+C we want to return
+ *  to the shell promptly, not wait for a roundtrip. If the timeout fires
+ *  or the call fails, we silently skip (session summaries are nice-to-have,
+ *  not critical for exit). */
+export declare function saveSession(state: LoopState, model: LanguageModel, timeoutMs?: number): Promise<void>;
 //# sourceMappingURL=loop.d.ts.map

package/dist/agent/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAYrD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAuHjF,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,UAAU,EAAE,UAAU,CAAA;IACtB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAqDD,2CAA2C;AAC3C,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAc9G;AAsJD,sBAAsB;AACtB,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,cAAc,EACzB,aAAa,CAAC,EAAE,SAAS,GACxB,OAAO,CAAC,SAAS,CAAC,CA2JpB;AAED,2BAA2B;AAC3B,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CASvF"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAMrD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAKrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAOhD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAKhD,4CAA4C;AAC5C,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAc9G;AAmLD,uBAAuB;AACvB,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,cAAc,EACzB,aAAa,CAAC,EAAE,SAAS,GACxB,OAAO,CAAC,SAAS,CAAC,CAkGpB;AAED;;;;8BAI8B;AAC9B,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBzG"}