@ai-setting/roy-agent-cli 1.3.18 → 1.3.22

package/dist/core/src/env/debug/types.d.ts

@@ -1,146 +0,0 @@
-/**
- * @fileoverview Debug Component Types
- *
- * Type definitions for trace parsing, formatting, and debugging utilities.
- */
-/**
- * Trace action type
- */
-export type TraceAction = 'enter' | 'quit' | 'error';
-/**
- * Log level type
- */
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-/**
- * Trace entry representing a single log line with trace info
- */
-export interface TraceEntry {
-    /** Unique request/trace identifier */
-    traceId: string;
-    /** Timestamp of the entry (ISO format) */
-    timestamp: string;
-    /** Function/method name */
-    function: string;
-    /** Action type: enter, quit, or error */
-    action: TraceAction;
-    /** Parameters (for enter action) */
-    params?: unknown[];
-    /** Result (for quit action) */
-    result?: unknown;
-    /** Error message (for error action) */
-    error?: string;
-    /** Calculated duration in milliseconds (for quit action) */
-    durationMs?: number;
-    /** Span ID (for SQLite spans) */
-    spanId?: string;
-    /** Parent span ID (for SQLite spans) */
-    parentSpanId?: string;
-}
-/**
- * Call tree node for hierarchical trace visualization
- */
-export interface TraceTreeNode {
-    /** Unique request/trace identifier */
-    traceId: string;
-    /** Function/method name */
-    function: string;
-    /** Start timestamp */
-    startTime: string;
-    /** End timestamp (for completed nodes) */
-    endTime?: string;
-    /** Duration in milliseconds */
-    durationMs?: number;
-    /** Child nodes */
-    children: TraceTreeNode[];
-    /** Original trace entry (optional for programmatically created nodes) */
-    entry?: TraceEntry;
-    /** Span ID (for SQLite spans) */
-    spanId?: string;
-    /** Parent span ID (for SQLite spans) */
-    parentSpanId?: string;
-}
-/**
- * Options for parsing logs
- */
-export interface ParserOptions {
-    /** Log file path to read */
-    logFile?: string;
-    /** Filter by trace ID */
-    traceId?: string;
-    /** Filter by function name (supports partial match) */
-    function?: string;
-    /** Start time filter (ISO format or relative like "1h") */
-    since?: string;
-    /** End time filter (ISO format) */
-    until?: string;
-    /** Log level filter */
-    level?: LogLevel;
-}
-/**
- * Options for log discovery
- */
-export interface LogDiscoveryOptions {
-    /** Log directory to search */
-    logDir?: string;
-    /** File pattern to match */
-    pattern?: string;
-}
-/**
- * Parsed log line with extracted fields
- */
-export interface ParsedLogLine {
-    /** Original log line */
-    raw: string;
-    /** Timestamp extracted from log */
-    timestamp: string;
-    /** Log level (INFO, DEBUG, WARN, ERROR) */
-    level: string;
-    /** Source file/location */
-    source: string;
-    /** Category (traced:...) */
-    category: string;
-    /** Action symbol (>>> or <<< or !!!) */
-    action: string;
-    /** Method/function name */
-    method: string;
-    /** Action type (enter, quit, error) */
-    actionType: TraceAction;
-    /** Raw arguments string */
-    rawArgs: string;
-    /** Request ID extracted from log (if present) */
-    requestId: string | null;
-}
-/**
- * Trace ID information summary
- */
-export interface TraceIdInfo {
-    /** Trace ID */
-    traceId: string;
-    /** First occurrence timestamp */
-    firstTime: string;
-    /** Last occurrence timestamp */
-    lastTime?: string;
-    /** Number of entries for this trace */
-    count: number;
-}
-/**
- * Output format options
- */
-export interface FormatOptions {
-    /** Use pretty printing */
-    pretty?: boolean;
-    /** Maximum depth for recursive objects */
-    maxDepth?: number;
-    /** Include raw data */
-    includeRaw?: boolean;
-}
-/**
- * Trace summary for list output
- */
-export interface TraceSummary {
-    /** List of trace ID info */
-    traceIds: TraceIdInfo[];
-    /** Total count */
-    count: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/core/src/env/debug/types.js

@@ -1,7 +0,0 @@
-/**
- * @fileoverview Debug Component Types
- *
- * Type definitions for trace parsing, formatting, and debugging utilities.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/core/src/env/debug/types.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.test.d.ts.map

package/dist/core/src/env/debug/types.test.js

@@ -1,160 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-describe('Debug Types', () => {
-    describe('TraceEntry', () => {
-        test('should have correct structure for enter action', () => {
-            const entry = {
-                traceId: 'req_123_abc',
-                timestamp: '2026-04-08T19:12:36.134',
-                function: 'llm.component.invoke',
-                action: 'enter',
-                params: [
-                    { messages: [{ role: 'system', content: 'You are Roy...' }] },
-                    { providerId: 'minimax', model: 'MiniMax-M2.7' },
-                ],
-            };
-            expect(entry.traceId).toBe('req_123_abc');
-            expect(entry.function).toBe('llm.component.invoke');
-            expect(entry.action).toBe('enter');
-            expect(entry.params).toHaveLength(2);
-        });
-        test('should have correct structure for quit action', () => {
-            const entry = {
-                traceId: 'req_123_abc',
-                timestamp: '2026-04-08T19:12:39.213',
-                function: 'llm.component.invoke',
-                action: 'quit',
-                result: {
-                    output: { content: 'Hello!', finishReason: 'stop' },
-                    latencyMs: 3077,
-                },
-                durationMs: 3077,
-            };
-            expect(entry.action).toBe('quit');
-            expect(entry.durationMs).toBe(3077);
-            expect(entry.result).toBeDefined();
-        });
-        test('should have correct structure for error action', () => {
-            const entry = {
-                traceId: 'req_123_abc',
-                timestamp: '2026-04-08T19:12:39.213',
-                function: 'llm.component.invoke',
-                action: 'error',
-                error: 'Connection timeout',
-            };
-            expect(entry.action).toBe('error');
-            expect(entry.error).toBe('Connection timeout');
-        });
-    });
-    describe('TraceTreeNode', () => {
-        test('should have correct structure', () => {
-            const node = {
-                traceId: 'req_123_abc',
-                function: 'llm.component.invoke',
-                startTime: '2026-04-08T19:12:36.134',
-                endTime: '2026-04-08T19:12:39.213',
-                durationMs: 3077,
-                children: [],
-                entry: {
-                    traceId: 'req_123_abc',
-                    timestamp: '2026-04-08T19:12:36.134',
-                    function: 'llm.component.invoke',
-                    action: 'enter',
-                },
-            };
-            expect(node.children).toHaveLength(0);
-            expect(node.durationMs).toBe(3077);
-        });
-        test('should support nested children', () => {
-            const childNode = {
-                traceId: 'req_123_abc',
-                function: 'tool.execute',
-                startTime: '2026-04-08T19:12:37.000',
-                endTime: '2026-04-08T19:12:37.500',
-                durationMs: 500,
-                children: [],
-                entry: {
-                    traceId: 'req_123_abc',
-                    timestamp: '2026-04-08T19:12:37.000',
-                    function: 'tool.execute',
-                    action: 'enter',
-                },
-            };
-            const rootNode = {
-                traceId: 'req_123_abc',
-                function: 'llm.component.invoke',
-                startTime: '2026-04-08T19:12:36.134',
-                endTime: '2026-04-08T19:12:39.213',
-                durationMs: 3077,
-                children: [childNode],
-                entry: {
-                    traceId: 'req_123_abc',
-                    timestamp: '2026-04-08T19:12:36.134',
-                    function: 'llm.component.invoke',
-                    action: 'enter',
-                },
-            };
-            expect(rootNode.children).toHaveLength(1);
-            expect(rootNode.children[0].function).toBe('tool.execute');
-        });
-    });
-    describe('ParserOptions', () => {
-        test('should support all optional fields', () => {
-            const options = {
-                logFile: '/path/to/app.log',
-                traceId: 'req_123',
-                function: 'llm.component.invoke',
-                since: '2026-04-08T10:00:00',
-                until: '2026-04-08T12:00:00',
-                level: 'info',
-            };
-            expect(options.logFile).toBe('/path/to/app.log');
-            expect(options.level).toBe('info');
-        });
-        test('should allow empty options', () => {
-            const options = {};
-            expect(options.logFile).toBeUndefined();
-            expect(options.traceId).toBeUndefined();
-        });
-    });
-    describe('LogDiscoveryOptions', () => {
-        test('should have default pattern', () => {
-            const options = {
-                logDir: '/custom/logs',
-                pattern: '*.log',
-            };
-            expect(options.pattern).toBe('*.log');
-        });
-    });
-    describe('TraceIdInfo', () => {
-        test('should have correct structure', () => {
-            const info = {
-                traceId: 'req_123_abc',
-                firstTime: '2026-04-08T19:12:36',
-                lastTime: '2026-04-08T19:12:45',
-                count: 15,
-            };
-            expect(info.traceId).toBe('req_123_abc');
-            expect(info.count).toBe(15);
-        });
-    });
-    describe('ParsedLogLine', () => {
-        test('should have correct structure', () => {
-            const line = {
-                raw: '2026-04-08 19:12:36.134 [INFO] [cli/src/bin/roy.js:80752][traced:llm.component.invoke] [TRACE] >>> llm.component.invoke enter: [{}]',
-                timestamp: '2026-04-08 19:12:36.134',
-                level: 'INFO',
-                source: 'cli/src/bin/roy.js:80752',
-                category: 'traced:llm.component.invoke',
-                action: '>>>',
-                method: 'llm.component.invoke',
-                actionType: 'enter',
-                rawArgs: '[{}]',
-            };
-            expect(line.timestamp).toBe('2026-04-08 19:12:36.134');
-            expect(line.level).toBe('INFO');
-            expect(line.action).toBe('>>>');
-            expect(line.method).toBe('llm.component.invoke');
-        });
-    });
-});
-//# sourceMappingURL=types.test.js.map

package/dist/core/src/env/environment-init.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=environment-init.test.d.ts.map

package/dist/core/src/env/environment-init.test.js

@@ -1,142 +0,0 @@
-import { describe, it, expect, beforeEach } from "bun:test";
-import { BaseEnvironment } from "./environment.js";
-import { BaseComponent } from "./component.js";
-// 全局初始化计数器，用于跟踪初始化顺序
-let initCounter = 0;
-/**
- * 测试用 ConfigComponent
- */
-class TestConfigComponent extends BaseComponent {
-    name = "config";
-    version = "1.0.0";
-    initOrder = 0;
-    getInitOrder() {
-        return this.initOrder;
-    }
-    async onInit() {
-        this.initOrder = ++initCounter;
-    }
-}
-/**
- * 测试用 ToolComponent
- */
-class TestToolComponent extends BaseComponent {
-    name = "tool";
-    version = "1.0.0";
-    initOrder = 0;
-    getInitOrder() {
-        return this.initOrder;
-    }
-    async onInit() {
-        this.initOrder = ++initCounter;
-    }
-}
-/**
- * 测试用 PromptComponent
- */
-class TestPromptComponent extends BaseComponent {
-    name = "prompt";
-    version = "1.0.0";
-    initOrder = 0;
-    getInitOrder() {
-        return this.initOrder;
-    }
-    async onInit() {
-        this.initOrder = ++initCounter;
-    }
-}
-describe("Environment component initialization", () => {
-    let env;
-    beforeEach(() => {
-        env = new BaseEnvironment({ name: "test-env", version: "1.0.0" });
-    });
-    describe("分阶段初始化", () => {
-        it("should init ConfigComponent first", async () => {
-            const configComp = new TestConfigComponent();
-            const toolComp = new TestToolComponent();
-            // 故意先注册 tool，再注册 config
-            env.registerComponent(toolComp);
-            env.registerComponent(configComp);
-            await env.init();
-            // ConfigComponent 应该先于 ToolComponent 完成初始化
-            expect(configComp.getStatus()).toBe("running");
-            expect(toolComp.getStatus()).toBe("running");
-            expect(configComp.getInitOrder()).toBeLessThan(toolComp.getInitOrder());
-        });
-        it("should pass env to all components", async () => {
-            const toolComp = new TestToolComponent();
-            env.registerComponent(toolComp);
-            await env.init();
-            // 验证 env 被正确注入
-            expect(toolComp.env).toBe(env);
-        });
-        it("should not re-init already initialized components", async () => {
-            const configComp = new TestConfigComponent();
-            env.registerComponent(configComp);
-            // 手动初始化
-            await configComp.init({
-                name: "config",
-                version: "1.0.0",
-                enabled: true,
-                env,
-            });
-            const firstInitTime = configComp.getInitOrder();
-            // 调用环境初始化
-            await env.init();
-            // initOrder 不应该改变（因为已经初始化过了）
-            expect(configComp.getInitOrder()).toBe(firstInitTime);
-        });
-        it("should init multiple components in correct order", async () => {
-            const configComp = new TestConfigComponent();
-            const toolComp = new TestToolComponent();
-            const promptComp = new TestPromptComponent();
-            // 以任意顺序注册
-            env.registerComponent(promptComp);
-            env.registerComponent(toolComp);
-            env.registerComponent(configComp);
-            await env.init();
-            // 验证初始化顺序
-            expect(configComp.getInitOrder()).toBeLessThan(toolComp.getInitOrder());
-            expect(configComp.getInitOrder()).toBeLessThan(promptComp.getInitOrder());
-            // 验证所有组件都正确初始化
-            expect(configComp.getStatus()).toBe("running");
-            expect(toolComp.getStatus()).toBe("running");
-            expect(promptComp.getStatus()).toBe("running");
-        });
-        it("should handle environment without ConfigComponent", async () => {
-            const toolComp = new TestToolComponent();
-            const promptComp = new TestPromptComponent();
-            env.registerComponent(toolComp);
-            env.registerComponent(promptComp);
-            await env.init();
-            // 没有 ConfigComponent 时，其他组件也应该正常初始化
-            expect(toolComp.getStatus()).toBe("running");
-            expect(promptComp.getStatus()).toBe("running");
-        });
-        it("should set env property on Environment itself", async () => {
-            await env.init();
-            // Environment 自身也应该有 env 属性（自引用）
-            expect(env.env).toBe(env);
-        });
-    });
-    describe("getEnv() access", () => {
-        it("should allow components to access env via getEnv()", async () => {
-            const toolComp = new TestToolComponent();
-            env.registerComponent(toolComp);
-            await env.init();
-            // 组件应该能通过 getEnv() 访问 Environment
-            expect(toolComp.getEnv()).toBe(env);
-        });
-        it("should allow components to get other components", async () => {
-            const configComp = new TestConfigComponent();
-            const toolComp = new TestToolComponent();
-            env.registerComponent(configComp);
-            env.registerComponent(toolComp);
-            await env.init();
-            // 组件应该能通过 env.getComponent() 获取其他组件
-            const retrieved = toolComp.getEnv().getComponent("config");
-            expect(retrieved).toBe(configComp);
-        });
-    });
-});
-//# sourceMappingURL=environment-init.test.js.map

package/dist/core/src/env/environment-lifecycle.test.d.ts

@@ -1,16 +0,0 @@
-/**
- * @fileoverview Environment Lifecycle Integration Tests
- *
- * 测试 Environment 生命周期中组件 start() 方法的正确调用
- *
- * 背景：依赖 start() 生命周期钩子的组件（如 TaskComponent, MemoryComponent）
- * 需要在 start() 中注册工具到 ToolComponent
- *
- * 验收标准：
- * 1. env.start() 必须在 env.init() 之后被调用
- * 2. TaskComponent.start() 必须被调用并注册 task tools
- * 3. MemoryComponent.start() 必须被调用并注册 memory tools
- * 4. AgentComponent 能从 ToolComponent 获取到这些工具
- */
-export {};
-//# sourceMappingURL=environment-lifecycle.test.d.ts.map