@fllf/agent-sdk 0.1.2 → 0.1.3

package/dist/config/config.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Config = void 0;
+const errors_1 = require("../errors");
 class Config {
     defaultModel;
     defaultProvider;
     temperature;
     maxTokens;
+    maxInputTokens;
     requestTimeoutMs;
     maxRetries;
     retryDelayMs;
@@ -13,11 +15,16 @@ class Config {
     debug;
     logLevel;
     maxHistoryLength;
-    constructor(options = {}) {
+    envWarnings;
+    constructor(options = {}, envWarnings = []) {
+        validateConfigOptions(options);
         this.defaultModel = options.defaultModel;
         this.defaultProvider = options.defaultProvider;
-        this.temperature = options.temperature ?? 0.7;
+        // 不再默认 0.7：未显式配置时把 temperature 留给模型自身的默认值，
+        // 也避免对拒绝该参数的推理模型强行下发。
+        this.temperature = options.temperature;
         this.maxTokens = options.maxTokens;
+        this.maxInputTokens = options.maxInputTokens;
         this.requestTimeoutMs = options.requestTimeoutMs;
         this.maxRetries = options.maxRetries;
         this.retryDelayMs = options.retryDelayMs;
@@ -25,76 +32,90 @@ class Config {
         this.debug = options.debug ?? false;
         this.logLevel = options.logLevel ?? 'INFO';
         this.maxHistoryLength = options.maxHistoryLength ?? 100;
+        this.envWarnings = Object.freeze([...envWarnings]);
     }
     /**
      * 环境变量只负责覆盖运行参数。
      * 如果没有显式 MODEL，就让 LLM provider 使用自己的默认模型。
      */
-    static fromEnv() {
+    static fromEnv(fromEnvOptions = {}) {
+        const env = fromEnvOptions.env ?? process.env;
         const options = {};
-        if (process.env.MODEL) {
-            options.defaultModel = process.env.MODEL;
-        }
-        if (process.env.MODEL_PROVIDER) {
-            options.defaultProvider = process.env.MODEL_PROVIDER;
-        }
-        if (process.env.DEBUG !== undefined) {
-            options.debug = process.env.DEBUG.toLowerCase() === 'true';
-        }
-        if (process.env.LOG_LEVEL) {
-            options.logLevel = process.env.LOG_LEVEL;
-        }
-        if (process.env.TEMPERATURE !== undefined) {
-            const temperature = Number.parseFloat(process.env.TEMPERATURE);
-            if (!Number.isNaN(temperature)) {
-                options.temperature = temperature;
+        const warnings = [];
+        if (env.MODEL !== undefined) {
+            const model = readNonEmptyString(env, 'MODEL', warnings);
+            if (model !== undefined) {
+                options.defaultModel = model;
             }
         }
-        if (process.env.MAX_TOKENS !== undefined) {
-            const maxTokens = Number.parseInt(process.env.MAX_TOKENS, 10);
-            if (!Number.isNaN(maxTokens)) {
-                options.maxTokens = maxTokens;
+        if (env.MODEL_PROVIDER !== undefined) {
+            const provider = readNonEmptyString(env, 'MODEL_PROVIDER', warnings);
+            if (provider !== undefined) {
+                options.defaultProvider = provider;
             }
         }
-        if (process.env.REQUEST_TIMEOUT_MS !== undefined) {
-            const requestTimeoutMs = Number.parseInt(process.env.REQUEST_TIMEOUT_MS, 10);
-            if (!Number.isNaN(requestTimeoutMs)) {
-                options.requestTimeoutMs = requestTimeoutMs;
+        if (env.DEBUG !== undefined) {
+            const debug = readBoolean(env, 'DEBUG', warnings);
+            if (debug !== undefined) {
+                options.debug = debug;
             }
         }
-        if (process.env.MAX_RETRIES !== undefined) {
-            const maxRetries = Number.parseInt(process.env.MAX_RETRIES, 10);
-            if (!Number.isNaN(maxRetries)) {
-                options.maxRetries = maxRetries;
+        if (env.LOG_LEVEL !== undefined) {
+            const logLevel = readNonEmptyString(env, 'LOG_LEVEL', warnings);
+            if (logLevel !== undefined) {
+                options.logLevel = logLevel;
             }
         }
-        if (process.env.RETRY_DELAY_MS !== undefined) {
-            const retryDelayMs = Number.parseInt(process.env.RETRY_DELAY_MS, 10);
-            if (!Number.isNaN(retryDelayMs)) {
-                options.retryDelayMs = retryDelayMs;
-            }
+        if (env.TEMPERATURE !== undefined) {
+            assignIfDefined(options, 'temperature', readNumber(env, 'TEMPERATURE', 'a finite number', warnings));
         }
-        if (process.env.RETRY_MAX_DELAY_MS !== undefined) {
-            const retryMaxDelayMs = Number.parseInt(process.env.RETRY_MAX_DELAY_MS, 10);
-            if (!Number.isNaN(retryMaxDelayMs)) {
-                options.retryMaxDelayMs = retryMaxDelayMs;
-            }
+        if (env.MAX_TOKENS !== undefined) {
+            assignIfDefined(options, 'maxTokens', readPositiveInteger(env, 'MAX_TOKENS', warnings));
+        }
+        if (env.MAX_INPUT_TOKENS !== undefined) {
+            assignIfDefined(options, 'maxInputTokens', readPositiveInteger(env, 'MAX_INPUT_TOKENS', warnings));
+        }
+        if (env.REQUEST_TIMEOUT_MS !== undefined) {
+            assignIfDefined(options, 'requestTimeoutMs', readNonNegativeInteger(env, 'REQUEST_TIMEOUT_MS', warnings));
+        }
+        if (env.MAX_RETRIES !== undefined) {
+            assignIfDefined(options, 'maxRetries', readNonNegativeInteger(env, 'MAX_RETRIES', warnings));
+        }
+        if (env.RETRY_DELAY_MS !== undefined) {
+            assignIfDefined(options, 'retryDelayMs', readNonNegativeInteger(env, 'RETRY_DELAY_MS', warnings));
+        }
+        if (env.RETRY_MAX_DELAY_MS !== undefined) {
+            assignIfDefined(options, 'retryMaxDelayMs', readNonNegativeInteger(env, 'RETRY_MAX_DELAY_MS', warnings));
+        }
+        if (env.MAX_HISTORY_LENGTH !== undefined) {
+            assignIfDefined(options, 'maxHistoryLength', readPositiveInteger(env, 'MAX_HISTORY_LENGTH', warnings));
         }
-        if (process.env.MAX_HISTORY_LENGTH !== undefined) {
-            const maxHistoryLength = Number.parseInt(process.env.MAX_HISTORY_LENGTH, 10);
-            if (!Number.isNaN(maxHistoryLength)) {
-                options.maxHistoryLength = maxHistoryLength;
+        for (const warning of warnings) {
+            fromEnvOptions.onWarning?.(warning);
+        }
+        if (fromEnvOptions.strict && warnings.length > 0) {
+            const warning = warnings[0];
+            if (warning !== undefined) {
+                throw new errors_1.ConfigError(warning.message, {
+                    code: 'invalid_env_config',
+                    metadata: { ...warning },
+                });
             }
+            throw new errors_1.ConfigError('Invalid environment configuration.', {
+                code: 'invalid_env_config',
+            });
         }
-        return new Config(options);
+        return new Config(options, warnings);
     }
     toJSON() {
         const options = {
-            temperature: this.temperature,
             debug: this.debug,
             logLevel: this.logLevel,
             maxHistoryLength: this.maxHistoryLength,
         };
+        if (this.temperature !== undefined) {
+            options.temperature = this.temperature;
+        }
         if (this.defaultModel !== undefined) {
             options.defaultModel = this.defaultModel;
         }
@@ -104,6 +125,9 @@ class Config {
         if (this.maxTokens !== undefined) {
             options.maxTokens = this.maxTokens;
         }
+        if (this.maxInputTokens !== undefined) {
+            options.maxInputTokens = this.maxInputTokens;
+        }
         if (this.requestTimeoutMs !== undefined) {
             options.requestTimeoutMs = this.requestTimeoutMs;
         }
@@ -120,4 +144,127 @@ class Config {
     }
 }
 exports.Config = Config;
+function validateConfigOptions(options) {
+    validateOptionalString('defaultModel', options.defaultModel);
+    validateOptionalString('defaultProvider', options.defaultProvider);
+    validateOptionalFiniteNumber('temperature', options.temperature);
+    validateOptionalPositiveInteger('maxTokens', options.maxTokens);
+    validateOptionalPositiveInteger('maxInputTokens', options.maxInputTokens);
+    validateOptionalNonNegativeNumber('requestTimeoutMs', options.requestTimeoutMs);
+    validateOptionalNonNegativeInteger('maxRetries', options.maxRetries);
+    validateOptionalNonNegativeNumber('retryDelayMs', options.retryDelayMs);
+    validateOptionalNonNegativeNumber('retryMaxDelayMs', options.retryMaxDelayMs);
+    validateOptionalBoolean('debug', options.debug);
+    validateOptionalString('logLevel', options.logLevel);
+    validateOptionalPositiveInteger('maxHistoryLength', options.maxHistoryLength);
+}
+function validateOptionalString(option, value) {
+    if (value !== undefined && (typeof value !== 'string' || value.trim().length === 0)) {
+        throwInvalidConfigOption(option, 'must be a non-empty string');
+    }
+}
+function validateOptionalBoolean(option, value) {
+    if (value !== undefined && typeof value !== 'boolean') {
+        throwInvalidConfigOption(option, 'must be a boolean');
+    }
+}
+function validateOptionalFiniteNumber(option, value) {
+    if (value !== undefined && (typeof value !== 'number' || !Number.isFinite(value))) {
+        throwInvalidConfigOption(option, 'must be a finite number');
+    }
+}
+function validateOptionalPositiveInteger(option, value) {
+    if (value !== undefined
+        && (typeof value !== 'number' || !Number.isInteger(value) || value <= 0)) {
+        throwInvalidConfigOption(option, 'must be a positive integer');
+    }
+}
+function validateOptionalNonNegativeNumber(option, value) {
+    if (value !== undefined
+        && (typeof value !== 'number' || !Number.isFinite(value) || value < 0)) {
+        throwInvalidConfigOption(option, 'must be a non-negative finite number');
+    }
+}
+function validateOptionalNonNegativeInteger(option, value) {
+    if (value !== undefined
+        && (typeof value !== 'number' || !Number.isInteger(value) || value < 0)) {
+        throwInvalidConfigOption(option, 'must be a non-negative integer');
+    }
+}
+function throwInvalidConfigOption(option, reason) {
+    throw new errors_1.ConfigError(`Invalid ConfigOptions.${option}: ${reason}.`, {
+        code: 'invalid_config_options',
+        metadata: {
+            option,
+        },
+    });
+}
+function readNonEmptyString(env, variable, warnings) {
+    const rawValue = env[variable];
+    const value = rawValue?.trim();
+    if (!value) {
+        addEnvWarning(warnings, variable, 'a non-empty string', 'empty_env_var');
+        return undefined;
+    }
+    return value;
+}
+function readBoolean(env, variable, warnings) {
+    const rawValue = env[variable]?.trim().toLowerCase();
+    if (rawValue === 'true') {
+        return true;
+    }
+    if (rawValue === 'false') {
+        return false;
+    }
+    addEnvWarning(warnings, variable, '"true" or "false"', 'invalid_env_var');
+    return undefined;
+}
+function readNumber(env, variable, expected, warnings) {
+    const rawValue = env[variable]?.trim();
+    if (!rawValue) {
+        addEnvWarning(warnings, variable, expected, 'empty_env_var');
+        return undefined;
+    }
+    const value = Number(rawValue);
+    if (!Number.isFinite(value)) {
+        addEnvWarning(warnings, variable, expected, 'invalid_env_var');
+        return undefined;
+    }
+    return value;
+}
+function readPositiveInteger(env, variable, warnings) {
+    const value = readNumber(env, variable, 'a positive integer', warnings);
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Number.isInteger(value) || value <= 0) {
+        addEnvWarning(warnings, variable, 'a positive integer', 'invalid_env_var');
+        return undefined;
+    }
+    return value;
+}
+function readNonNegativeInteger(env, variable, warnings) {
+    const value = readNumber(env, variable, 'a non-negative integer', warnings);
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Number.isInteger(value) || value < 0) {
+        addEnvWarning(warnings, variable, 'a non-negative integer', 'invalid_env_var');
+        return undefined;
+    }
+    return value;
+}
+function addEnvWarning(warnings, variable, expected, code) {
+    warnings.push({
+        code,
+        variable,
+        expected,
+        message: `Invalid environment variable ${variable}: expected ${expected}.`,
+    });
+}
+function assignIfDefined(options, key, value) {
+    if (value !== undefined) {
+        options[key] = value;
+    }
+}
 //# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":";;;AAgBA,MAAa,MAAM;IACN,YAAY,CAAqB;IACjC,eAAe,CAAgC;IAC/C,WAAW,CAAS;IACpB,SAAS,CAAqB;IAC9B,gBAAgB,CAAqB;IACrC,UAAU,CAAqB;IAC/B,YAAY,CAAqB;IACjC,eAAe,CAAqB;IACpC,KAAK,CAAU;IACf,QAAQ,CAAS;IACjB,gBAAgB,CAAS;IAElC,YAAY,UAAyB,EAAE;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;QAC3C,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,GAAG,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO;QACV,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QAC7C,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YAC7B,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,cAAmC,CAAC;QAC9E,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;QAC/D,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAC7C,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC/D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;YACtC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAC9D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;YAClC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;YAChD,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAChE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;YACpC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACrE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;YACxC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,eAAe,GAAG,eAAe,CAAC;YAC9C,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;YAChD,CAAC;QACL,CAAC;QAED,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM;QACF,MAAM,OAAO,GAAkB;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SAC1C,CAAC;QAEF,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAC7C,CAAC;QACD,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACvC,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACzC,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAC7C,CAAC;QACD,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;QACnD,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ;AAtID,wBAsIC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"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"}

package/dist/config/index.d.ts

@@ -1,3 +1,3 @@
 export { Config } from './config';
-export type { ConfigOptions } from './config';
+export type { ConfigEnvWarning, ConfigEnvWarningCode, ConfigFromEnvOptions, ConfigOptions, } from './config';
 //# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACR,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GAChB,MAAM,UAAU,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,74 @@
+export interface SDKErrorOptions {
+    code: string;
+    retryable?: boolean;
+    cause?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface ComponentErrorOptions {
+    code?: string;
+    retryable?: boolean;
+    cause?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export declare class AgentSDKError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly metadata: Readonly<Record<string, unknown>> | undefined;
+    constructor(message: string, options: SDKErrorOptions);
+}
+export declare class AgentError extends AgentSDKError {
+    constructor(message: string, options?: ComponentErrorOptions);
+}
+export declare class AgentSessionError extends AgentError {
+    constructor(message: string, options?: ComponentErrorOptions);
+}
+export declare class AgentExecutionError extends AgentError {
+    constructor(message: string, options?: ComponentErrorOptions);
+}
+export declare class ToolError extends AgentSDKError {
+    readonly toolName: string | undefined;
+    constructor(message: string, options?: ComponentErrorOptions & {
+        toolName?: string;
+    });
+}
+export declare class ToolNotFoundError extends ToolError {
+    constructor(toolName: string, options?: ComponentErrorOptions);
+}
+export declare class ToolExecutionError extends ToolError {
+    constructor(toolName: string, cause: unknown, options?: ComponentErrorOptions);
+}
+export declare class ToolConfigurationError extends ToolError {
+    constructor(message: string, options?: ComponentErrorOptions & {
+        toolName?: string;
+    });
+}
+export declare class ToolPermissionError extends ToolError {
+    constructor(toolName: string, options?: ComponentErrorOptions);
+}
+export declare class ToolTimeoutError extends ToolError {
+    constructor(toolName: string, timeoutMs: number, options?: ComponentErrorOptions);
+}
+export declare class ToolAbortError extends ToolError {
+    constructor(toolName: string, options?: ComponentErrorOptions);
+}
+export declare class HistoryError extends AgentSDKError {
+    constructor(message: string, options?: ComponentErrorOptions);
+}
+export interface HistoryVersionConflictInput {
+    expectedVersion: number;
+    actualVersion: number;
+    sessionId?: string;
+}
+/**
+ * 乐观并发写入冲突：addMany 携带的 expectedVersion 与存储中的实际版本不一致。
+ * 默认 retryable：CAS 冲突的预期处理方式就是重读 getVersion/get 之后重试。
+ */
+export declare class HistoryVersionConflictError extends HistoryError {
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+    constructor(input: HistoryVersionConflictInput, options?: ComponentErrorOptions);
+}
+export declare class ConfigError extends AgentSDKError {
+    constructor(message: string, options?: ComponentErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,qBAAa,aAAc,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;gBAErD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;CAOxD;AAED,qBAAa,UAAW,SAAQ,aAAa;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAGnE;AAED,qBAAa,iBAAkB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAGnE;AAED,qBAAa,mBAAoB,SAAQ,UAAU;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAGnE;AAED,qBAAa,SAAU,SAAQ,aAAa;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAAqB,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;CAI3F;AAED,qBAAa,iBAAkB,SAAQ,SAAS;gBAChC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAYpE;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACjC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,qBAA0B;CAapF;AAED,qBAAa,sBAAuB,SAAQ,SAAS;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAAqB,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;CAY3F;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBAClC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAYpE;AAED,qBAAa,gBAAiB,SAAQ,SAAS;gBAC/B,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAavF;AAED,qBAAa,cAAe,SAAQ,SAAS;gBAC7B,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAYpE;AAED,qBAAa,YAAa,SAAQ,aAAa;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAGnE;AAED,MAAM,WAAW,2BAA2B;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,YAAY;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,KAAK,EAAE,2BAA2B,EAAE,OAAO,GAAE,qBAA0B;CAkBtF;AAED,qBAAa,WAAY,SAAQ,aAAa;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAGnE"}

package/dist/errors.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigError = exports.HistoryVersionConflictError = exports.HistoryError = exports.ToolAbortError = exports.ToolTimeoutError = exports.ToolPermissionError = exports.ToolConfigurationError = exports.ToolExecutionError = exports.ToolNotFoundError = exports.ToolError = exports.AgentExecutionError = exports.AgentSessionError = exports.AgentError = exports.AgentSDKError = void 0;
+class AgentSDKError extends Error {
+    code;
+    retryable;
+    metadata;
+    constructor(message, options) {
+        super(message, { cause: options.cause });
+        this.name = new.target.name;
+        this.code = options.code;
+        this.retryable = options.retryable ?? false;
+        this.metadata = options.metadata ? Object.freeze({ ...options.metadata }) : undefined;
+    }
+}
+exports.AgentSDKError = AgentSDKError;
+class AgentError extends AgentSDKError {
+    constructor(message, options = {}) {
+        super(message, withDefaults(options, 'agent_error', false));
+    }
+}
+exports.AgentError = AgentError;
+class AgentSessionError extends AgentError {
+    constructor(message, options = {}) {
+        super(message, withDefaults(options, 'agent_session', false));
+    }
+}
+exports.AgentSessionError = AgentSessionError;
+class AgentExecutionError extends AgentError {
+    constructor(message, options = {}) {
+        super(message, withDefaults(options, 'agent_execution', false));
+    }
+}
+exports.AgentExecutionError = AgentExecutionError;
+class ToolError extends AgentSDKError {
+    toolName;
+    constructor(message, options = {}) {
+        super(message, withDefaults(options, 'tool_error', false));
+        this.toolName = options.toolName;
+    }
+}
+exports.ToolError = ToolError;
+class ToolNotFoundError extends ToolError {
+    constructor(toolName, options = {}) {
+        super(`Tool "${toolName}" is not registered.`, {
+            ...options,
+            code: options.code ?? 'tool_not_found',
+            retryable: options.retryable ?? false,
+            toolName,
+            metadata: {
+                ...options.metadata,
+                toolName,
+            },
+        });
+    }
+}
+exports.ToolNotFoundError = ToolNotFoundError;
+class ToolExecutionError extends ToolError {
+    constructor(toolName, cause, options = {}) {
+        super(`Tool "${toolName}" failed: ${getErrorMessage(cause)}`, {
+            ...options,
+            code: options.code ?? 'tool_execution',
+            retryable: options.retryable ?? false,
+            cause,
+            toolName,
+            metadata: {
+                ...options.metadata,
+                toolName,
+            },
+        });
+    }
+}
+exports.ToolExecutionError = ToolExecutionError;
+class ToolConfigurationError extends ToolError {
+    constructor(message, options = {}) {
+        const errorOptions = {
+            ...options,
+            code: options.code ?? 'invalid_tool_options',
+            retryable: options.retryable ?? false,
+        };
+        if (options.toolName !== undefined) {
+            errorOptions.toolName = options.toolName;
+        }
+        super(message, errorOptions);
+    }
+}
+exports.ToolConfigurationError = ToolConfigurationError;
+class ToolPermissionError extends ToolError {
+    constructor(toolName, options = {}) {
+        super(`Tool "${toolName}" was denied by the permission policy.`, {
+            ...options,
+            code: options.code ?? 'tool_permission_denied',
+            retryable: options.retryable ?? false,
+            toolName,
+            metadata: {
+                ...options.metadata,
+                toolName,
+            },
+        });
+    }
+}
+exports.ToolPermissionError = ToolPermissionError;
+class ToolTimeoutError extends ToolError {
+    constructor(toolName, timeoutMs, options = {}) {
+        super(`Tool "${toolName}" timed out after ${timeoutMs}ms.`, {
+            ...options,
+            code: options.code ?? 'tool_timeout',
+            retryable: options.retryable ?? true,
+            toolName,
+            metadata: {
+                ...options.metadata,
+                toolName,
+                timeoutMs,
+            },
+        });
+    }
+}
+exports.ToolTimeoutError = ToolTimeoutError;
+class ToolAbortError extends ToolError {
+    constructor(toolName, options = {}) {
+        super(`Tool "${toolName}" was aborted.`, {
+            ...options,
+            code: options.code ?? 'tool_aborted',
+            retryable: options.retryable ?? false,
+            toolName,
+            metadata: {
+                ...options.metadata,
+                toolName,
+            },
+        });
+    }
+}
+exports.ToolAbortError = ToolAbortError;
+class HistoryError extends AgentSDKError {
+    constructor(message, options = {}) {
+        super(message, withDefaults(options, 'history_error', false));
+    }
+}
+exports.HistoryError = HistoryError;
+/**
+ * 乐观并发写入冲突：addMany 携带的 expectedVersion 与存储中的实际版本不一致。
+ * 默认 retryable：CAS 冲突的预期处理方式就是重读 getVersion/get 之后重试。
+ */
+class HistoryVersionConflictError extends HistoryError {
+    expectedVersion;
+    actualVersion;
+    constructor(input, options = {}) {
+        super(`Message history version conflict: expected version ${input.expectedVersion}, actual version ${input.actualVersion}.`, {
+            ...options,
+            code: options.code ?? 'history_version_conflict',
+            retryable: options.retryable ?? true,
+            metadata: {
+                ...options.metadata,
+                expectedVersion: input.expectedVersion,
+                actualVersion: input.actualVersion,
+                ...(input.sessionId !== undefined ? { sessionId: input.sessionId } : {}),
+            },
+        });
+        this.expectedVersion = input.expectedVersion;
+        this.actualVersion = input.actualVersion;
+    }
+}
+exports.HistoryVersionConflictError = HistoryVersionConflictError;
+class ConfigError extends AgentSDKError {
+    constructor(message, options = {}) {
+        super(message, withDefaults(options, 'config_error', false));
+    }
+}
+exports.ConfigError = ConfigError;
+function withDefaults(options, code, retryable) {
+    const normalized = {
+        code: options.code ?? code,
+        retryable: options.retryable ?? retryable,
+    };
+    if ('cause' in options) {
+        normalized.cause = options.cause;
+    }
+    if (options.metadata !== undefined) {
+        normalized.metadata = options.metadata;
+    }
+    return normalized;
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/executors/base-executor.d.ts

@@ -0,0 +1,14 @@
+import type { ChatMessage, ChatRequest } from '../llm';
+import { Message } from '../messages';
+import type { AgentContext, AgentExecutor, AgentResult } from './base';
+import type { ChatRequestBuilderOptions } from './chat-request-builder';
+export declare abstract class BaseExecutor implements AgentExecutor {
+    abstract run(context: AgentContext): Promise<AgentResult>;
+    protected createUserMessage(context: AgentContext): Message;
+    protected createAssistantMessage(content: string, metadata?: Record<string, unknown>): Message;
+    protected getHistoryWithUserMessage(context: AgentContext, userMessage: Message): Promise<Message[]>;
+    protected buildChatMessages(context: AgentContext, messages: Message[]): Promise<ChatMessage[]>;
+    protected buildChatRequest(context: AgentContext, messages: ChatMessage[], options?: ChatRequestBuilderOptions): ChatRequest;
+    protected commitMessages(context: AgentContext, messages: Message[]): Promise<Message[]>;
+}
+//# sourceMappingURL=base-executor.d.ts.map