@nexusgpu/repterm-plugin-kubectl 0.1.0

package/dist/repterm/src/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Repterm - CLI/TUI Test Framework
+ *
+ * Public API entrypoint following Modern, Declarative conventions
+ */
+export { test, getTests, clearTests, registry } from './api/test.js';
+export { expect, AssertionError, type MatcherResult, } from './api/expect.js';
+export { describe } from './api/describe.js';
+export { step, getCurrentStepOptions, getCurrentStepName, shouldShowStepTitle, markStepTitleShown, type StepRecordingOptions } from './api/steps.js';
+export { beforeEach, afterEach, beforeAll, afterAll } from './api/hooks.js';
+export type { TestContext, TerminalAPI, WaitOptions, CommandResult, RunOptions, PTYProcess, NamedHookEntry, PluginFactory, TerminalWithPlugins } from './runner/models.js';
+export type { TestFunction, TestOptions, DescribeOptions } from './runner/models.js';
+export type { HookFunction, EnhancedHookFunction } from './api/hooks.js';
+export { definePlugin, defineConfig, createTestWithPlugins, describeWithPlugins, type PluginDefinition, type AnyPlugin, type PluginConfig, type PluginHooks, type BasePluginContext, type AugmentedTestContext, type PluginTestFunction, } from './plugin/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/repterm/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../repterm/src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,MAAM,EACN,cAAc,EACd,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACL,IAAI,EACJ,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG5E,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC3K,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrF,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/repterm/src/index.js

@@ -0,0 +1,23 @@
+/**
+ * Repterm - CLI/TUI Test Framework
+ *
+ * Public API entrypoint following Modern, Declarative conventions
+ */
+// Core test registration and execution
+export { test, getTests, clearTests, registry } from './api/test.js';
+export { expect, AssertionError, } from './api/expect.js';
+// Test organization features
+export { describe } from './api/describe.js';
+export { step, getCurrentStepOptions, getCurrentStepName, shouldShowStepTitle, markStepTitleShown } from './api/steps.js';
+export { beforeEach, afterEach, beforeAll, afterAll } from './api/hooks.js';
+// Plugin system
+export { definePlugin, defineConfig, createTestWithPlugins, describeWithPlugins, } from './plugin/index.js';
+// Attach step to test namespace for test.step() syntax
+import { test as testFn } from './api/test.js';
+import { step as stepFn } from './api/steps.js';
+import { describe as describeFn } from './api/describe.js';
+// Extend test with additional methods
+Object.assign(testFn, {
+    step: stepFn,
+    describe: describeFn,
+});

package/dist/repterm/src/plugin/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Repterm Plugin System
+ *
+ * A type-safe plugin system that allows extending test contexts and terminal APIs.
+ * Types and definePlugin come from @repterm/plugin-api; runtime lives here.
+ */
+import type { TestContext } from '../runner/models.js';
+import { definePlugin as definePluginFromApi, type BasePluginContext as BasePluginContextGeneric, type PluginHooks, type PluginDefinition, type AnyPlugin } from '@repterm/plugin-api';
+export { definePluginFromApi as definePlugin };
+export type { PluginDefinition, AnyPlugin, PluginHooks };
+export type BasePluginContext = BasePluginContextGeneric<TestContext>;
+type ExtractContextOut<T> = T extends PluginDefinition<any, any, infer Out, any> ? Out : {};
+type ExtractMethods<T> = T extends PluginDefinition<any, any, any, infer M> ? M : {};
+type ExtractName<T> = T extends PluginDefinition<infer N, any, any, any> ? N : never;
+type MergePluginMethods<TPlugins extends readonly AnyPlugin[]> = TPlugins extends readonly [
+    infer First,
+    ...infer Rest
+] ? Rest extends readonly AnyPlugin[] ? {
+    [K in ExtractName<First>]: ExtractMethods<First>;
+} & MergePluginMethods<Rest> : {
+    [K in ExtractName<First>]: ExtractMethods<First>;
+} : {};
+type AccumulateContext<TPlugins extends readonly AnyPlugin[], TAccum extends object = {}> = TPlugins extends readonly [infer First, ...infer Rest] ? Rest extends readonly AnyPlugin[] ? AccumulateContext<Rest, TAccum & ExtractContextOut<First>> : TAccum & ExtractContextOut<First> : TAccum;
+export type AugmentedTestContext<TPlugins extends readonly AnyPlugin[]> = TestContext & {
+    plugins: MergePluginMethods<TPlugins>;
+} & AccumulateContext<TPlugins>;
+export interface PluginConfig<TPlugins extends readonly AnyPlugin[]> {
+    plugins?: TPlugins;
+    baseContext?: Partial<Omit<BasePluginContextGeneric<TestContext>, 'testContext'>>;
+}
+export declare class PluginRuntime<TPlugins extends readonly AnyPlugin[]> {
+    private plugins;
+    private baseContext;
+    private pluginMethods;
+    private pluginHooks;
+    private contextAugmentations;
+    constructor(config: PluginConfig<TPlugins>);
+    initialize(testContext: TestContext): AugmentedTestContext<TPlugins>;
+    runBeforeTestHooks(ctx: TestContext): Promise<void>;
+    runAfterTestHooks(ctx: TestContext, error?: Error): Promise<void>;
+    runBeforeCommandHooks(command: string): Promise<string>;
+    runAfterOutputHooks(output: string): Promise<string>;
+}
+export declare function defineConfig<TPlugins extends readonly AnyPlugin[]>(config: PluginConfig<TPlugins>): PluginRuntime<TPlugins>;
+export { BasePluginContext as PluginContext };
+export { createTestWithPlugins, describeWithPlugins, type PluginTestFunction, } from './withPlugins.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/repterm/src/plugin/index.d.ts.map

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

package/dist/repterm/src/plugin/index.js

@@ -0,0 +1,85 @@
+/**
+ * Repterm Plugin System
+ *
+ * A type-safe plugin system that allows extending test contexts and terminal APIs.
+ * Types and definePlugin come from @repterm/plugin-api; runtime lives here.
+ */
+import { definePlugin as definePluginFromApi, } from '@repterm/plugin-api';
+// Re-export plugin-api for consumers (repterm re-exports these from index)
+export { definePluginFromApi as definePlugin };
+// ============== Runtime Implementation ==============
+export class PluginRuntime {
+    plugins;
+    baseContext;
+    pluginMethods = {};
+    pluginHooks = [];
+    contextAugmentations = {};
+    constructor(config) {
+        this.plugins = (config.plugins || []);
+        this.baseContext = {
+            version: '1.0.0',
+            debug: false,
+            ...config.baseContext,
+        };
+    }
+    initialize(testContext) {
+        const fullContext = {
+            ...this.baseContext,
+            testContext,
+        };
+        let ctx = { ...fullContext };
+        for (const plugin of this.plugins) {
+            const result = plugin.setup(ctx);
+            this.pluginMethods[plugin.name] = result.methods;
+            if (result.hooks) {
+                this.pluginHooks.push(result.hooks);
+            }
+            if (result.context) {
+                ctx = { ...ctx, ...result.context };
+                Object.assign(this.contextAugmentations, result.context);
+            }
+        }
+        const augmentedContext = {
+            ...testContext,
+            plugins: this.pluginMethods,
+            ...this.contextAugmentations,
+        };
+        return augmentedContext;
+    }
+    async runBeforeTestHooks(ctx) {
+        for (const hooks of this.pluginHooks) {
+            if (hooks.beforeTest) {
+                await hooks.beforeTest(ctx);
+            }
+        }
+    }
+    async runAfterTestHooks(ctx, error) {
+        for (const hooks of this.pluginHooks) {
+            if (hooks.afterTest) {
+                await hooks.afterTest(ctx, error);
+            }
+        }
+    }
+    async runBeforeCommandHooks(command) {
+        let result = command;
+        for (const hooks of this.pluginHooks) {
+            if (hooks.beforeCommand) {
+                result = await hooks.beforeCommand(result);
+            }
+        }
+        return result;
+    }
+    async runAfterOutputHooks(output) {
+        let result = output;
+        for (const hooks of this.pluginHooks) {
+            if (hooks.afterOutput) {
+                result = await hooks.afterOutput(result);
+            }
+        }
+        return result;
+    }
+}
+export function defineConfig(config) {
+    return new PluginRuntime(config);
+}
+export { createTestWithPlugins, describeWithPlugins, } from './withPlugins.js';

package/dist/repterm/src/plugin/withPlugins.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Plugin Integration Helpers
+ *
+ * Provides utilities to seamlessly integrate plugins with the test framework,
+ * eliminating the need for manual initialization in every test case.
+ */
+import { describe as describeFromDescribe } from '../api/describe.js';
+import type { PluginRuntime, AnyPlugin, AugmentedTestContext } from './index.js';
+/**
+ * Type for the augmented test function that receives plugin context
+ */
+export type PluginTestFunction<TPlugins extends readonly AnyPlugin[]> = (ctx: AugmentedTestContext<TPlugins>) => Promise<void>;
+/**
+ * Creates a test function that automatically initializes plugins
+ *
+ * @param config - The plugin runtime configuration
+ * @returns A wrapped test function with automatic plugin initialization
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'repterm';
+ * import { createTestWithPlugins } from 'repterm/plugin/withPlugins';
+ * import { loggerPlugin } from './plugins/logger';
+ *
+ * const config = defineConfig({
+ *   plugins: [loggerPlugin()] as const,
+ * });
+ *
+ * const test = createTestWithPlugins(config);
+ *
+ * test('my test', async (ctx) => {
+ *   // ctx automatically includes all plugins!
+ *   ctx.logger.info('Hello!');
+ *   ctx.plugins.logger.log('info', 'World!');
+ * });
+ * ```
+ */
+export declare function createTestWithPlugins<TPlugins extends readonly AnyPlugin[]>(config: PluginRuntime<TPlugins>): (name: string, fn: PluginTestFunction<TPlugins>) => void;
+/**
+ * Creates a describe block where all tests automatically have plugin access
+ *
+ * @param config - The plugin runtime configuration
+ * @param name - The describe block name
+ * @param fn - The describe block callback
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'repterm';
+ * import { describeWithPlugins } from 'repterm/plugin/withPlugins';
+ * import { loggerPlugin } from './plugins/logger';
+ *
+ * const config = defineConfig({
+ *   plugins: [loggerPlugin()] as const,
+ * });
+ *
+ * describeWithPlugins(config, 'My Suite', ({ test }) => {
+ *   test('test 1', async (ctx) => {
+ *     ctx.logger.info('Auto-initialized!');
+ *   });
+ *
+ *   test('test 2', async (ctx) => {
+ *     ctx.logger.debug('Same here!');
+ *   });
+ * });
+ * ```
+ */
+export declare function describeWithPlugins<TPlugins extends readonly AnyPlugin[]>(config: PluginRuntime<TPlugins>, name: string, fn: (helpers: {
+    test: ReturnType<typeof createTestWithPlugins<TPlugins>>;
+    describe: typeof describeFromDescribe;
+}) => void): void;
+//# sourceMappingURL=withPlugins.d.ts.map

package/dist/repterm/src/plugin/withPlugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withPlugins.d.ts","sourceRoot":"","sources":["../../../../../repterm/src/plugin/withPlugins.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,QAAQ,SAAS,SAAS,SAAS,EAAE,IAAI,CACpE,GAAG,EAAE,oBAAoB,CAAC,QAAQ,CAAC,KAClC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,SAAS,SAAS,SAAS,EAAE,EACvE,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,UAMrB,MAAM,MACR,kBAAkB,CAAC,QAAQ,CAAC,KACjC,IAAI,CAiCV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,SAAS,SAAS,EAAE,EACrE,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,OAAO,EAAE;IACV,IAAI,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzD,QAAQ,EAAE,OAAO,oBAAoB,CAAC;CACzC,KAAK,IAAI,GACX,IAAI,CAKN"}

package/dist/repterm/src/plugin/withPlugins.js

@@ -0,0 +1,100 @@
+/**
+ * Plugin Integration Helpers
+ *
+ * Provides utilities to seamlessly integrate plugins with the test framework,
+ * eliminating the need for manual initialization in every test case.
+ */
+import { test as baseTest } from '../api/test.js';
+import { describe as describeFromDescribe } from '../api/describe.js';
+/**
+ * Creates a test function that automatically initializes plugins
+ *
+ * @param config - The plugin runtime configuration
+ * @returns A wrapped test function with automatic plugin initialization
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'repterm';
+ * import { createTestWithPlugins } from 'repterm/plugin/withPlugins';
+ * import { loggerPlugin } from './plugins/logger';
+ *
+ * const config = defineConfig({
+ *   plugins: [loggerPlugin()] as const,
+ * });
+ *
+ * const test = createTestWithPlugins(config);
+ *
+ * test('my test', async (ctx) => {
+ *   // ctx automatically includes all plugins!
+ *   ctx.logger.info('Hello!');
+ *   ctx.plugins.logger.log('info', 'World!');
+ * });
+ * ```
+ */
+export function createTestWithPlugins(config) {
+    /**
+     * Wrapped test function with automatic plugin initialization
+     */
+    function testWithPlugins(name, fn) {
+        baseTest(name, async ({ terminal }) => {
+            // Create plugin factory for new terminals
+            const pluginFactory = (newTerminal) => {
+                // Initialize plugins with new terminal context
+                const newCtx = config.initialize({ terminal: newTerminal });
+                return newCtx.plugins;
+            };
+            // Inject plugin factory into terminal
+            terminal.setPluginFactory?.(pluginFactory);
+            // Initialize plugins with test context
+            const augmentedCtx = config.initialize({ terminal });
+            // Run beforeTest hooks
+            await config.runBeforeTestHooks({ terminal });
+            try {
+                // Execute the test with augmented context
+                await fn(augmentedCtx);
+                // Run afterTest hooks (success)
+                await config.runAfterTestHooks({ terminal });
+            }
+            catch (error) {
+                // Run afterTest hooks (failure)
+                await config.runAfterTestHooks({ terminal }, error);
+                throw error;
+            }
+        });
+    }
+    return testWithPlugins;
+}
+/**
+ * Creates a describe block where all tests automatically have plugin access
+ *
+ * @param config - The plugin runtime configuration
+ * @param name - The describe block name
+ * @param fn - The describe block callback
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'repterm';
+ * import { describeWithPlugins } from 'repterm/plugin/withPlugins';
+ * import { loggerPlugin } from './plugins/logger';
+ *
+ * const config = defineConfig({
+ *   plugins: [loggerPlugin()] as const,
+ * });
+ *
+ * describeWithPlugins(config, 'My Suite', ({ test }) => {
+ *   test('test 1', async (ctx) => {
+ *     ctx.logger.info('Auto-initialized!');
+ *   });
+ *
+ *   test('test 2', async (ctx) => {
+ *     ctx.logger.debug('Same here!');
+ *   });
+ * });
+ * ```
+ */
+export function describeWithPlugins(config, name, fn) {
+    describeFromDescribe(name, () => {
+        const test = createTestWithPlugins(config);
+        fn({ test, describe: describeFromDescribe });
+    });
+}

package/dist/repterm/src/runner/models.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Core entities for the test framework
+ */
+/**
+ * test() 函数的配置选项
+ */
+export interface TestOptions {
+    /** 标记为录制测试，仅在 --record 模式下运行 */
+    record?: boolean;
+    /** 测试超时时间（毫秒） */
+    timeout?: number;
+}
+/**
+ * describe() 函数的配置选项
+ */
+export interface DescribeOptions {
+    /** 标记为录制测试套件，内部所有测试默认继承此配置 */
+    record?: boolean;
+}
+/**
+ * Named hook entry for beforeAll/afterAll
+ */
+export interface NamedHookEntry {
+    name?: string;
+    fn: (context: TestContext) => Promise<Record<string, unknown> | void> | Record<string, unknown> | void;
+}
+export interface TestSuite {
+    id: string;
+    name: string;
+    tests: TestCase[];
+    suites?: TestSuite[];
+    parent?: TestSuite;
+    config: SuiteConfig;
+    options?: DescribeOptions;
+    beforeAll?: NamedHookEntry[];
+    afterAll?: NamedHookEntry[];
+}
+export interface SuiteConfig {
+    timeouts?: {
+        suiteMs?: number;
+        testMs?: number;
+    };
+    parallel?: {
+        workers?: number;
+    };
+    record?: {
+        enabled?: boolean;
+        castFile?: string;
+    };
+}
+export interface TestCase {
+    id: string;
+    name: string;
+    steps: Step[];
+    timeout?: number;
+    fixtures?: Record<string, unknown>;
+    fn: TestFunction;
+    options?: TestOptions;
+}
+export type TestFunction = (context: TestContext) => Promise<void>;
+export interface TestContext {
+    terminal: TerminalAPI;
+    [key: string]: unknown;
+}
+/**
+ * 命令执行结果
+ */
+export interface CommandResult {
+    /** 命令退出码（0 表示成功） */
+    code: number;
+    /** 标准输出 */
+    stdout: string;
+    /** 标准错误 */
+    stderr: string;
+    /** 混合输出（stdout + stderr 合并） */
+    output: string;
+    /** 命令执行时长（毫秒） */
+    duration: number;
+    /** 原始命令字符串 */
+    command: string;
+    /** 是否成功（code === 0） */
+    readonly successful: boolean;
+}
+/**
+ * PTY 进程控制器
+ * 实现 PromiseLike，既可以作为 Promise 使用（await 自动调用 wait()），也可以作为控制器使用
+ */
+export interface PTYProcess extends PromiseLike<CommandResult> {
+    /** 等待指定文本出现 */
+    expect(text: string, options?: {
+        timeout?: number;
+    }): Promise<void>;
+    /** 发送输入到进程（自动追加换行符） */
+    send(input: string): Promise<void>;
+    /** 发送原始输入（不追加换行符） */
+    sendRaw(input: string): Promise<void>;
+    /** 等待命令完成并返回结果 */
+    wait(options?: {
+        timeout?: number;
+    }): Promise<CommandResult>;
+    /** 启动命令执行，等待输入完成（不等待命令执行完成） */
+    start(): Promise<void>;
+    /** 发送 Ctrl+C */
+    interrupt(): Promise<void>;
+    /** Promise catch 方法 */
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<CommandResult | TResult>;
+    /** Promise finally 方法 */
+    finally(onfinally?: (() => void) | null): Promise<CommandResult>;
+}
+/**
+ * run() 方法选项
+ */
+export interface RunOptions {
+    /** 命令超时时间（毫秒），默认：30000 */
+    timeout?: number;
+    /** 环境变量（可选） */
+    env?: Record<string, string>;
+    /** 工作目录（可选） */
+    cwd?: string;
+    /**
+     * 标记为交互式命令，使用 PTY 执行
+     * 交互式模式支持 expect/send 方法，但 exitCode 不可靠
+     */
+    interactive?: boolean;
+    /**
+     * 静默模式：即使在录制模式下也使用 Bun.spawn 执行
+     * 用于需要精确解析输出的场景（如 JSON 解析）
+     * 注意：此模式下命令不会在录制中显示
+     */
+    silent?: boolean;
+    /**
+     * 录制模式：打字速度 (ms/字符)
+     * 默认值：80ms，设为 0 则直接写入不打字
+     */
+    typingSpeed?: number;
+    /**
+     * 录制模式：命令执行后暂停时间 (ms)
+     * 用于让观众有时间阅读输出
+     */
+    pauseAfter?: number;
+    /**
+     * 录制模式：命令执行前暂停时间 (ms)
+     */
+    pauseBefore?: number;
+}
+/**
+ * 插件工厂类型 - 用于为新终端创建插件实例
+ */
+export type PluginFactory<TPlugins = Record<string, unknown>> = (terminal: TerminalAPI) => TPlugins;
+/**
+ * 带插件的终端接口
+ */
+export interface TerminalWithPlugins<TPlugins = Record<string, unknown>> extends TerminalAPI {
+    /** 插件实例（与主终端相同配置） */
+    plugins: TPlugins;
+}
+export interface TerminalAPI {
+    /**
+     * 执行命令，返回 PTYProcess（可 await 或使用控制器方法）
+     *
+     * 用法：
+     * - 非交互式：直接 await，获取 CommandResult
+     *   `const result = await terminal.run('echo hello');`
+     *
+     * - 交互式：不 await，使用控制器方法
+     *   `const proc = terminal.run('vim file.txt');`
+     *   `await proc.expect('~');`
+     *   `await proc.send(':q');`
+     *   `const result = await proc;`
+     *
+     * @param command - 要执行的命令
+     * @param options - 可选配置
+     */
+    run(command: string, options?: RunOptions): PTYProcess;
+    /** 发送输入到终端 */
+    send(text: string): Promise<void>;
+    /** 等待指定文本出现 */
+    waitForText(text: string, options?: WaitOptions): Promise<void>;
+    /** 获取当前终端输出快照 */
+    snapshot(): Promise<string>;
+    /** 关闭终端 */
+    close(): Promise<void>;
+    /**
+     * 创建新的终端实例（多终端测试）
+     * 如果设置了插件工厂，返回的终端会自动携带 plugins 属性
+     */
+    create<TPlugins = Record<string, unknown>>(): Promise<TerminalWithPlugins<TPlugins>>;
+    /** 检查是否处于录制模式 */
+    isRecording?(): boolean;
+    /** 检查是否处于 PTY 模式（包括录制模式和 ptyOnly 模式） */
+    isPtyMode?(): boolean;
+    /**
+     * 设置插件工厂（用于 create() 自动注入插件）
+     * @internal 由插件系统调用
+     */
+    setPluginFactory?<TPlugins>(factory: PluginFactory<TPlugins>): void;
+}
+export interface WaitOptions {
+    timeout?: number;
+    /**
+     * 是否移除 ANSI 转义序列后再匹配文本（录制模式下默认 true）
+     * 设为 false 可保留原始输出，用于测试 ANSI 相关功能
+     */
+    stripAnsi?: boolean;
+}
+export interface Step {
+    id: string;
+    type: 'input' | 'wait' | 'assert' | 'step';
+    payload: unknown;
+    timeout?: number;
+    name?: string;
+}
+export interface RunResult {
+    id: string;
+    suiteId: string;
+    caseId: string;
+    suiteName: string;
+    suitePath: string[];
+    caseName: string;
+    status: 'pass' | 'fail' | 'skip';
+    durationMs: number;
+    error?: TestError;
+    artifacts: Artifact[];
+    recordingPath?: string;
+}
+export interface CommandLog {
+    command: string;
+    code: number;
+    stdout: string;
+    stderr: string;
+    output: string;
+    duration: number;
+}
+export interface TestError {
+    message: string;
+    stack?: string;
+    expected?: unknown;
+    actual?: unknown;
+    commandLogs?: CommandLog[];
+}
+export interface Artifact {
+    id: string;
+    runResultId: string;
+    type: 'cast' | 'log' | 'snapshot';
+    path: string;
+}
+/**
+ * Run status for API endpoint
+ */
+export interface RunStatus {
+    runId: string;
+    status: 'queued' | 'running' | 'passed' | 'failed';
+    totals: {
+        passed: number;
+        failed: number;
+        skipped: number;
+    };
+    durationMs?: number;
+    results?: RunResult[];
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/repterm/src/runner/models.d.ts.map

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

package/dist/repterm/src/runner/models.js

@@ -0,0 +1,4 @@
+/**
+ * Core entities for the test framework
+ */
+export {};