@agenticc/core 1.0.0

package/dist/test-utils/arbitraries.js

@@ -0,0 +1,280 @@
+/**
+ * 共享的 Arbitrary 生成器
+ *
+ * 为 Property-based 测试提供统一的数据生成器
+ */
+import * as fc from 'fast-check';
+// ============================================================================
+// 标识符相关
+// ============================================================================
+/**
+ * 有效的标识符（用于工具名、变量名等）
+ * 规则：以字母开头，只包含字母、数字、下划线
+ */
+export const arbIdentifier = fc
+    .stringOf(fc.constantFrom(...'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_'.split('')), { minLength: 1, maxLength: 30 })
+    .filter((s) => /^[a-zA-Z][a-zA-Z0-9_]*$/.test(s));
+/**
+ * 有效的插件名（允许连字符）
+ */
+export const arbPluginName = fc
+    .stringOf(fc.constantFrom(...'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-'.split('')), { minLength: 1, maxLength: 30 })
+    .filter((s) => /^[a-zA-Z][a-zA-Z0-9_-]*$/.test(s));
+/**
+ * 有效的工具名（不允许连字符）
+ */
+export const arbToolName = fc
+    .stringOf(fc.constantFrom(...'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_'.split('')), { minLength: 1, maxLength: 30 })
+    .filter((s) => /^[a-zA-Z][a-zA-Z0-9_]*$/.test(s));
+/**
+ * 有效的命名空间（小写字母开头）
+ */
+export const arbNamespace = fc
+    .stringOf(fc.constantFrom(...'abcdefghijklmnopqrstuvwxyz0123456789_'.split('')), {
+    minLength: 1,
+    maxLength: 20,
+})
+    .filter((s) => /^[a-z][a-z0-9_]*$/.test(s));
+/**
+ * 有效的分类名
+ */
+export const arbCategory = fc.stringOf(fc.constantFrom(...'abcdefghijklmnopqrstuvwxyz'.split('')), {
+    minLength: 1,
+    maxLength: 20,
+});
+// ============================================================================
+// Session 相关
+// ============================================================================
+/**
+ * Session ID（UUID 格式）
+ */
+export const arbSessionId = fc.uuid().map((uuid) => `session_${uuid}`);
+/**
+ * Message ID
+ */
+export const arbMessageId = fc.uuid().map((uuid) => `msg_${uuid}`);
+/**
+ * 消息角色
+ */
+export const arbMessageRole = fc.constantFrom('user', 'assistant', 'system');
+/**
+ * 响应类型
+ */
+export const arbResponseType = fc.constantFrom('execute', 'clarify', 'confirm', 'options', 'knowledge_request');
+// ============================================================================
+// 字符串相关
+// ============================================================================
+/**
+ * 非空字符串
+ *
+ * @param maxLength - 最大长度
+ */
+export const arbNonEmptyString = (maxLength = 200) => fc.string({ minLength: 1, maxLength });
+/**
+ * 消息内容
+ */
+export const arbMessageContent = arbNonEmptyString(500);
+/**
+ * 用户消息
+ */
+export const arbUserMessage = arbNonEmptyString(1000);
+/**
+ * 安全的字符串（只包含常见字符）
+ */
+export const arbSafeString = (maxLength = 100) => fc.stringOf(fc.constantFrom(...'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 .,!?-_'.split('')), { minLength: 1, maxLength });
+// ============================================================================
+// JSON 相关
+// ============================================================================
+/**
+ * 有效的 JSON 值（排除 undefined）
+ */
+export const arbJsonValue = fc.jsonValue();
+/**
+ * 元数据对象
+ */
+export const arbMetadata = fc.option(fc.dictionary(fc.string({ minLength: 1, maxLength: 20 }), arbJsonValue), { nil: undefined });
+/**
+ * 简单的键值对对象
+ */
+export const arbSimpleObject = fc.dictionary(arbIdentifier, fc.oneof(fc.string(), fc.integer(), fc.boolean(), fc.constant(null)), { minKeys: 0, maxKeys: 5 });
+// ============================================================================
+// 工具相关
+// ============================================================================
+/**
+ * 工具参数
+ */
+export const arbToolArgs = fc.dictionary(arbIdentifier, fc.oneof(fc.string(), fc.integer(), fc.boolean(), fc.constant(null)), { minKeys: 0, maxKeys: 5 });
+/**
+ * 错误代码
+ */
+export const arbErrorCode = fc.stringOf(fc.constantFrom(...'ABCDEFGHIJKLMNOPQRSTUVWXYZ_'.split('')), { minLength: 3, maxLength: 30 });
+/**
+ * 工具执行结果
+ */
+export const arbToolResult = fc.record({
+    success: fc.boolean(),
+    content: arbNonEmptyString(200),
+    data: fc.option(arbJsonValue, { nil: undefined }),
+    error: fc.option(fc.record({
+        code: arbErrorCode,
+        message: arbNonEmptyString(100),
+    }), { nil: undefined }),
+});
+/**
+ * 成功的工具结果
+ */
+export const arbSuccessToolResult = fc.record({
+    success: fc.constant(true),
+    content: arbNonEmptyString(200),
+    data: fc.option(arbJsonValue, { nil: undefined }),
+});
+/**
+ * 失败的工具结果
+ */
+export const arbFailureToolResult = fc.record({
+    success: fc.constant(false),
+    content: arbNonEmptyString(200),
+    error: fc.record({
+        code: arbErrorCode,
+        message: arbNonEmptyString(100),
+    }),
+});
+// ============================================================================
+// 数值相关
+// ============================================================================
+/**
+ * 正整数
+ *
+ * @param max - 最大值
+ */
+export const arbPositiveInt = (max = 100) => fc.integer({ min: 1, max });
+/**
+ * 非负整数
+ *
+ * @param max - 最大值
+ */
+export const arbNonNegativeInt = (max = 60000) => fc.integer({ min: 0, max });
+/**
+ * 持续时间（毫秒）
+ */
+export const arbDurationMs = arbNonNegativeInt(60000);
+/**
+ * 温度参数（0-2）
+ */
+export const arbTemperature = fc.double({ min: 0, max: 2, noNaN: true });
+/**
+ * maxTokens 参数
+ */
+export const arbMaxTokens = fc.integer({ min: 1, max: 4096 });
+/**
+ * maxIterations 参数
+ */
+export const arbMaxIterations = fc.integer({ min: 1, max: 50 });
+// ============================================================================
+// 时间相关
+// ============================================================================
+/**
+ * 合理范围内的时间戳
+ */
+export const arbTimestamp = fc.date({
+    min: new Date('2024-01-01'),
+    max: new Date('2030-12-31'),
+});
+/**
+ * 过去的时间戳
+ */
+export const arbPastTimestamp = fc.date({
+    min: new Date('2020-01-01'),
+    max: new Date(),
+});
+// ============================================================================
+// LLM 相关
+// ============================================================================
+/**
+ * LLM 提供商
+ */
+export const arbLLMProvider = fc.constantFrom('openai', 'claude', 'qwen', 'siliconflow', 'anyrouter');
+/**
+ * LLM 任务类型
+ */
+export const arbLLMTask = fc.constantFrom('intent_parsing', 'knowledge_retrieval', 'tool_calling', 'response_generation');
+/**
+ * LLM 错误代码
+ */
+export const arbLLMErrorCode = fc.constantFrom('AUTHENTICATION_ERROR', 'RATE_LIMIT_ERROR', 'INVALID_REQUEST', 'MODEL_NOT_FOUND', 'CONTEXT_LENGTH_EXCEEDED', 'CONTENT_FILTER', 'TIMEOUT', 'NETWORK_ERROR', 'CANCELLED', 'UNKNOWN_ERROR');
+/**
+ * 风险级别
+ */
+export const arbRiskLevel = fc.constantFrom('low', 'medium', 'high');
+/**
+ * 消息操作生成器
+ */
+export const arbMessageOperation = fc.record({
+    type: fc.constantFrom('user', 'assistant', 'system'),
+    content: arbMessageContent,
+});
+/**
+ * 消息操作序列
+ */
+export const arbMessageOperations = fc.array(arbMessageOperation, {
+    minLength: 1,
+    maxLength: 20,
+});
+/**
+ * 工具调用
+ */
+export const arbToolCall = fc.record({
+    id: fc.uuid().map((id) => `call_${id}`),
+    type: fc.constant('function'),
+    function: fc.record({
+        name: arbToolName,
+        arguments: fc.json(),
+    }),
+});
+/**
+ * 工具调用数组
+ */
+export const arbToolCalls = fc.array(arbToolCall, { minLength: 1, maxLength: 5 });
+/**
+ * LLM 响应
+ */
+export const arbLLMResponse = fc.record({
+    content: arbNonEmptyString(500),
+    toolCalls: fc.option(arbToolCalls, { nil: undefined }),
+});
+// ============================================================================
+// 辅助函数
+// ============================================================================
+/**
+ * 创建唯一标识符生成器
+ *
+ * @param prefix - 前缀
+ */
+export function arbUniqueId(prefix) {
+    return fc.uuid().map((uuid) => `${prefix}_${uuid}`);
+}
+/**
+ * 创建带索引的唯一标识符生成器
+ *
+ * @param prefix - 前缀
+ */
+export function arbIndexedId(prefix) {
+    return fc.integer({ min: 0, max: 999999 }).map((i) => `${prefix}_${i}`);
+}
+/**
+ * 创建枚举生成器
+ *
+ * @param values - 枚举值数组
+ */
+export function arbEnum(...values) {
+    return fc.constantFrom(...values);
+}
+/**
+ * 创建可选值生成器
+ *
+ * @param arb - 基础生成器
+ */
+export function arbOptional(arb) {
+    return fc.option(arb, { nil: undefined });
+}
+//# sourceMappingURL=arbitraries.js.map

package/dist/test-utils/arbitraries.js.map

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

package/dist/test-utils/cleanup.d.ts

@@ -0,0 +1,184 @@
+/**
+ * 测试清理工具
+ *
+ * 确保测试后资源被正确清理，避免测试间的状态污染
+ */
+/**
+ * 清理函数类型
+ */
+export type CleanupFn = () => void | Promise<void>;
+/**
+ * 清理管理器
+ *
+ * 管理测试清理函数的注册和执行
+ *
+ * @example
+ * ```typescript
+ * const cleanup = new CleanupManager();
+ *
+ * // 注册清理函数
+ * cleanup.register(() => store.clear());
+ * cleanup.register(() => connection.close());
+ *
+ * // 测试结束后执行清理
+ * await cleanup.cleanup();
+ * ```
+ */
+export declare class CleanupManager {
+    private cleanupFns;
+    private cleaned;
+    /**
+     * 注册清理函数
+     *
+     * @param fn - 清理函数
+     * @returns this（支持链式调用）
+     */
+    register(fn: CleanupFn): this;
+    /**
+     * 执行所有清理函数
+     *
+     * 清理函数按注册的逆序执行（后注册的先清理）
+     * 即使某个清理函数失败，也会继续执行其他清理函数
+     *
+     * @throws AggregateError 如果有清理函数失败
+     */
+    cleanup(): Promise<void>;
+    /**
+     * 重置清理管理器
+     *
+     * 清除所有已注册的清理函数，允许重新使用
+     */
+    reset(): void;
+    /**
+     * 获取已注册的清理函数数量
+     */
+    get count(): number;
+    /**
+     * 检查是否已执行清理
+     */
+    get isCleaned(): boolean;
+}
+/**
+ * 创建带自动清理的测试上下文
+ *
+ * @param setup - 设置函数，接收 CleanupManager 并返回测试上下文
+ * @returns 异步函数，执行设置并在完成后自动清理
+ *
+ * @example
+ * ```typescript
+ * const runTest = withCleanup(async (cleanup) => {
+ *   const store = new KnowledgeStore();
+ *   cleanup.register(() => store.clear());
+ *   return store;
+ * });
+ *
+ * const store = await runTest();
+ * // 使用 store...
+ * // 函数返回后自动清理
+ * ```
+ */
+export declare function withCleanup<T>(setup: (cleanup: CleanupManager) => T | Promise<T>): () => Promise<{
+    result: T;
+    cleanup: () => Promise<void>;
+}>;
+/**
+ * 创建测试夹具
+ *
+ * 提供 setup 和 teardown 的便捷封装
+ *
+ * @example
+ * ```typescript
+ * const fixture = createTestFixture(
+ *   async () => {
+ *     const store = new KnowledgeStore();
+ *     await store.initialize();
+ *     return store;
+ *   },
+ *   async (store) => {
+ *     await store.clear();
+ *     await store.close();
+ *   }
+ * );
+ *
+ * // 在测试中使用
+ * const store = await fixture.setup();
+ * // ... 测试代码
+ * await fixture.teardown(store);
+ * ```
+ */
+export declare function createTestFixture<T>(setup: () => T | Promise<T>, teardown: (instance: T) => void | Promise<void>): {
+    setup: () => Promise<T>;
+    teardown: (instance: T) => Promise<void>;
+    run: <R>(fn: (instance: T) => R | Promise<R>) => Promise<R>;
+};
+/**
+ * 资源池
+ *
+ * 管理可重用的测试资源
+ *
+ * @example
+ * ```typescript
+ * const connectionPool = new ResourcePool(
+ *   () => createConnection(),
+ *   (conn) => conn.close()
+ * );
+ *
+ * const conn = await connectionPool.acquire();
+ * // 使用连接...
+ * await connectionPool.release(conn);
+ *
+ * // 测试结束后清理所有资源
+ * await connectionPool.cleanup();
+ * ```
+ */
+export declare class ResourcePool<T> {
+    private available;
+    private inUse;
+    private createFn;
+    private destroyFn;
+    constructor(create: () => T | Promise<T>, destroy: (resource: T) => void | Promise<void>);
+    /**
+     * 获取资源
+     */
+    acquire(): Promise<T>;
+    /**
+     * 释放资源
+     */
+    release(resource: T): void;
+    /**
+     * 清理所有资源
+     */
+    cleanup(): Promise<void>;
+    /**
+     * 获取池状态
+     */
+    get stats(): {
+        available: number;
+        inUse: number;
+    };
+}
+/**
+ * 延迟执行器
+ *
+ * 收集操作并在最后批量执行
+ */
+export declare class DeferredExecutor {
+    private operations;
+    /**
+     * 添加延迟操作
+     */
+    defer(operation: () => void | Promise<void>): this;
+    /**
+     * 执行所有延迟操作
+     */
+    execute(): Promise<void>;
+    /**
+     * 清除所有待执行操作
+     */
+    clear(): void;
+    /**
+     * 获取待执行操作数量
+     */
+    get count(): number;
+}
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/test-utils/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/test-utils/cleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAQ7B;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB9B;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACjD,MAAM,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAS5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC3B,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC9C;IACD,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7D,CAaA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,SAAS,CAAwC;gBAE7C,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAS3B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI;IAO1B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB9B;;OAEG;IACH,IAAI,KAAK,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAKhD;CACF;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAyC;IAE3D;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAKlD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}