@felan-ai/agent-core 0.0.0-bootstrap.0

package/dist/runtime-conformance.js

@@ -0,0 +1,172 @@
+import { dirname, resolve } from 'node:path';
+const literalArguments = ['plain', 'two words', '"quoted"', "'single'", '$HOME', 'semi;colon', '', '--flag=value'];
+export const testRuntimeConformanceFixtures = {
+    argv: {
+        command: 'fixture:argv',
+        args: literalArguments,
+        stdout: JSON.stringify(literalArguments),
+    },
+    failure: {
+        command: 'fixture:failure',
+        args: [],
+        stderr: 'expected failure',
+        code: 17,
+    },
+    longRunning: {
+        command: 'fixture:wait',
+        args: [],
+    },
+    cwd: {
+        command: 'fixture:cwd',
+        args: [],
+    },
+    binary: new Uint8Array([0, 255, 1, 128, 10, 13, 239, 191, 189]),
+};
+export function createNodeRuntimeConformanceFixtures(command = 'node') {
+    return {
+        argv: {
+            command,
+            args: ['-e', 'process.stdout.write(JSON.stringify(process.argv.slice(1)))', '--', ...literalArguments],
+            stdout: JSON.stringify(literalArguments),
+        },
+        failure: {
+            command,
+            args: ['-e', "process.stderr.write('expected failure'); process.exit(17)"],
+            stderr: 'expected failure',
+            code: 17,
+        },
+        longRunning: {
+            command,
+            args: ['-e', 'setInterval(() => {}, 1000)'],
+        },
+        cwd: {
+            command,
+            args: ['-e', 'process.stdout.write(process.cwd())'],
+        },
+        binary: testRuntimeConformanceFixtures.binary.slice(),
+    };
+}
+export function createRuntimeConformanceCases(fixtures) {
+    return [
+        {
+            name: 'keeps cwd immutable and contains file paths',
+            async run(runtime) {
+                const originalCwd = runtime.cwd;
+                Reflect.set(runtime, 'cwd', resolve(runtime.cwd, 'other'));
+                equal(runtime.cwd, originalCwd, 'cwd changed');
+                await runtime.mkdir('nested', { recursive: true });
+                await runtime.writeFile('nested/relative.bin', fixtures.binary);
+                bytesEqual(await runtime.readFile(resolve(runtime.cwd, 'nested/relative.bin')), fixtures.binary);
+                await rejects(() => runtime.readFile('../outside'));
+                await rejects(() => runtime.writeFile(`${runtime.cwd}\0bad`, fixtures.binary));
+                await rejects(() => runtime.remove(runtime.cwd, { recursive: true }));
+            },
+        },
+        {
+            name: 'rejects escaping exec cwd before execution',
+            async run(runtime) {
+                await rejects(() => runtime.exec(fixtures.cwd.command, fixtures.cwd.args, {
+                    cwd: resolve(runtime.cwd, '..'),
+                }));
+                const childCwd = resolve(runtime.cwd, 'child');
+                await runtime.mkdir(childCwd, { recursive: true });
+                const result = await runtime.exec(fixtures.cwd.command, fixtures.cwd.args, { cwd: childCwd });
+                equal(result.stdout, childCwd, 'exec cwd was not contained or normalized');
+            },
+        },
+        {
+            name: 'rejects symlink-resolved escapes when supported',
+            async run(runtime, harness) {
+                if (!harness.createSymlinkEscape)
+                    return;
+                const linkPath = resolve(runtime.cwd, 'escape-link');
+                await harness.createSymlinkEscape(runtime, linkPath);
+                await rejects(() => runtime.readFile(resolve(linkPath, 'secret')));
+            },
+        },
+        {
+            name: 'preserves literal argv boundaries',
+            async run(runtime) {
+                const result = await runtime.exec(fixtures.argv.command, fixtures.argv.args);
+                equal(result.stdout, fixtures.argv.stdout ?? '', 'argv output changed');
+                equal(result.code, 0, 'argv command failed');
+                equal(result.killed, false, 'argv command was killed');
+            },
+        },
+        {
+            name: 'returns nonzero execution results',
+            async run(runtime) {
+                const result = await runtime.exec(fixtures.failure.command, fixtures.failure.args);
+                equal(result.code, fixtures.failure.code ?? 1, 'nonzero code changed');
+                equal(result.stderr, fixtures.failure.stderr ?? '', 'stderr changed');
+                equal(result.killed, false, 'failure command was killed');
+            },
+        },
+        {
+            name: 'round-trips binary file content',
+            async run(runtime) {
+                await runtime.mkdir(dirname('binary/payload.bin'), { recursive: true });
+                await runtime.writeFile('binary/payload.bin', fixtures.binary);
+                bytesEqual(await runtime.readFile('binary/payload.bin'), fixtures.binary);
+            },
+        },
+        {
+            name: 'kills execution on timeout',
+            async run(runtime) {
+                const result = await runtime.exec(fixtures.longRunning.command, fixtures.longRunning.args, { timeout: 10 });
+                killed(result, 'timeout');
+            },
+        },
+        {
+            name: 'kills execution on AbortSignal cancellation',
+            async run(runtime) {
+                const controller = new AbortController();
+                const execution = runtime.exec(fixtures.longRunning.command, fixtures.longRunning.args, {
+                    signal: controller.signal,
+                });
+                controller.abort();
+                killed(await execution, 'AbortSignal');
+            },
+        },
+    ];
+}
+export async function runRuntimeConformance(harness, fixtures) {
+    for (const testCase of createRuntimeConformanceCases(fixtures)) {
+        const runtime = await harness.createRuntime();
+        try {
+            await testCase.run(runtime, harness);
+        }
+        catch (error) {
+            throw new Error(`Runtime conformance failed: ${testCase.name}`, { cause: error });
+        }
+        finally {
+            await harness.disposeRuntime?.(runtime);
+        }
+    }
+}
+function equal(actual, expected, message) {
+    if (actual !== expected) {
+        throw new Error(`${message}: expected ${String(expected)}, received ${String(actual)}`);
+    }
+}
+function bytesEqual(actual, expected) {
+    if (actual.length !== expected.length || actual.some((value, index) => value !== expected[index])) {
+        throw new Error('Binary content changed');
+    }
+}
+async function rejects(operation) {
+    try {
+        await operation();
+    }
+    catch {
+        return;
+    }
+    throw new Error('Expected operation to reject');
+}
+function killed(result, source) {
+    equal(result.killed, true, `${source} did not kill execution`);
+    if (result.code === 0) {
+        throw new Error(`${source} returned a successful exit code`);
+    }
+}
+//# sourceMappingURL=runtime-conformance.js.map

package/dist/runtime-conformance.js.map

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

package/dist/runtime-test-kit.d.ts

@@ -0,0 +1,5 @@
+export { createNodeRuntimeConformanceFixtures, createRuntimeConformanceCases, runRuntimeConformance, testRuntimeConformanceFixtures, } from './runtime-conformance.js';
+export type { RuntimeCommandFixture, RuntimeConformanceCase, RuntimeConformanceFixtures, RuntimeConformanceHarness, } from './runtime-conformance.js';
+export { TestAgentRuntime } from './test-agent-runtime.js';
+export type { TestAgentRuntimeOptions, TestExecCall, TestShellCall, TestShellOptions, } from './test-agent-runtime.js';
+//# sourceMappingURL=runtime-test-kit.d.ts.map

package/dist/runtime-test-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-test-kit.d.ts","sourceRoot":"","sources":["../src/runtime-test-kit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,EACpC,6BAA6B,EAC7B,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,MAAM,yBAAyB,CAAC"}

package/dist/runtime-test-kit.js

@@ -0,0 +1,3 @@
+export { createNodeRuntimeConformanceFixtures, createRuntimeConformanceCases, runRuntimeConformance, testRuntimeConformanceFixtures, } from './runtime-conformance.js';
+export { TestAgentRuntime } from './test-agent-runtime.js';
+//# sourceMappingURL=runtime-test-kit.js.map

package/dist/runtime-test-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-test-kit.js","sourceRoot":"","sources":["../src/runtime-test-kit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,EACpC,6BAA6B,EAC7B,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,23 @@
+import type { ExecOptions, ExecResult } from '@earendil-works/pi-coding-agent';
+export type { ExecOptions, ExecResult } from '@earendil-works/pi-coding-agent';
+export type AgentRuntimeKind = 'host' | 'docker' | 'daytona';
+export interface AgentRuntime {
+    readonly kind: AgentRuntimeKind;
+    readonly cwd: string;
+    exec(command: string, args: readonly string[], options?: ExecOptions): Promise<ExecResult>;
+    shell(command: string, options?: ExecOptions & {
+        env?: Readonly<Record<string, string>>;
+    }): Promise<ExecResult>;
+    readFile(path: string): Promise<Uint8Array>;
+    writeFile(path: string, content: Uint8Array): Promise<void>;
+    listFiles(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<string[]>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    remove(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE/E,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE/E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,IAAI,CACF,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB,KAAK,CACH,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GAAG;QAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAE,GACjE,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE"}

package/dist/runtime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":""}

package/dist/session.d.ts

@@ -0,0 +1,52 @@
+import { type AgentSession, type CreateAgentSessionOptions, type CreateAgentSessionResult, type CreateAgentSessionRuntimeFactory, type CreateAgentSessionRuntimeResult, type ModelRuntime, type SessionManager, type SessionStartEvent, type SettingsManager, type ToolDefinition } from '@earendil-works/pi-coding-agent';
+import { type ExtensionPackageImporter } from './extensions.js';
+import type { AgentRuntime } from './runtime.js';
+export type StreamFunction = AgentSession['agent']['streamFunction'];
+export interface AgentSessionHost {
+    wrapStreamFunction?(original: StreamFunction): StreamFunction;
+    createChildSession(request: AgentChildSessionRequest): Promise<AgentChildSessionResult>;
+}
+export interface AgentChildSessionRequest {
+    readonly rootSessionId: string;
+    readonly parentSessionId: string;
+    readonly personaId: string;
+    readonly prompt: string;
+    readonly block: boolean;
+    readonly model?: string;
+    readonly timeoutMinutes?: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface AgentChildSessionResult {
+    readonly ok: boolean;
+    readonly sessionId: string;
+    readonly status: 'running' | 'queued' | 'completed' | 'failed';
+    readonly result?: string;
+    readonly error?: string;
+    readonly message?: string;
+}
+export interface CreateAgentCoreSessionOptions {
+    readonly applicationKind: 'cloud' | 'tui';
+    readonly runtime: AgentRuntime;
+    readonly host: AgentSessionHost;
+    readonly extensionPackages: readonly string[];
+    readonly importExtension: ExtensionPackageImporter;
+    readonly extensionFlagValues?: ReadonlyMap<string, boolean | string>;
+    readonly modelRuntime: ModelRuntime;
+    readonly settingsManager: SettingsManager;
+    readonly sessionManager: SessionManager;
+    readonly agentDir?: string;
+    readonly model?: CreateAgentSessionOptions['model'];
+    readonly thinkingLevel?: CreateAgentSessionOptions['thinkingLevel'];
+    readonly scopedModels?: CreateAgentSessionOptions['scopedModels'];
+    readonly sessionStartEvent?: SessionStartEvent;
+    readonly customTools?: readonly ToolDefinition[];
+    readonly systemPrompt?: string;
+    readonly appendSystemPrompt?: readonly string[];
+}
+export declare function createAgentCoreSession(options: CreateAgentCoreSessionOptions): Promise<CreateAgentSessionResult>;
+export declare function createAgentCoreSessionRuntime(options: CreateAgentCoreSessionOptions): Promise<CreateAgentSessionRuntimeResult>;
+export type AgentCoreSessionRuntimeFactoryRequest = Parameters<CreateAgentSessionRuntimeFactory>[0];
+export type AgentCoreSessionRuntimeFactoryOptions = Omit<CreateAgentCoreSessionOptions, 'agentDir' | 'sessionManager' | 'sessionStartEvent'>;
+export type AgentCoreSessionRuntimeOptionsFactory = (request: AgentCoreSessionRuntimeFactoryRequest) => AgentCoreSessionRuntimeFactoryOptions | Promise<AgentCoreSessionRuntimeFactoryOptions>;
+export declare function createAgentCoreSessionRuntimeFactory(createOptions: AgentCoreSessionRuntimeOptionsFactory): CreateAgentSessionRuntimeFactory;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -0,0 +1,81 @@
+import { createAgentSession, } from '@earendil-works/pi-coding-agent';
+import { loadFelanExtensions } from './extensions.js';
+import { createAgentCoreResourceLoader } from './resource-loader.js';
+import { createRuntimeCodingTools } from './tools.js';
+export async function createAgentCoreSession(options) {
+    const composition = await composeAgentCoreSession(options);
+    return composition.result;
+}
+export async function createAgentCoreSessionRuntime(options) {
+    const composition = await composeAgentCoreSession(options);
+    return {
+        ...composition.result,
+        services: composition.services,
+        diagnostics: composition.services.diagnostics,
+    };
+}
+export function createAgentCoreSessionRuntimeFactory(createOptions) {
+    return async (request) => createAgentCoreSessionRuntime({
+        ...await createOptions(request),
+        agentDir: request.agentDir,
+        sessionManager: request.sessionManager,
+        ...(request.sessionStartEvent === undefined
+            ? {}
+            : { sessionStartEvent: request.sessionStartEvent }),
+    });
+}
+async function composeAgentCoreSession(options) {
+    const extensionFactories = await loadFelanExtensions(options.extensionPackages, options.importExtension, options.runtime);
+    const agentDir = options.agentDir ?? options.runtime.cwd;
+    const resourceLoader = await createAgentCoreResourceLoader({
+        cwd: options.runtime.cwd,
+        agentDir,
+        extensionFactories,
+        ...(options.extensionFlagValues === undefined
+            ? {}
+            : { extensionFlagValues: options.extensionFlagValues }),
+        ...(options.systemPrompt === undefined ? {} : { systemPrompt: options.systemPrompt }),
+        ...(options.appendSystemPrompt === undefined
+            ? {}
+            : { appendSystemPrompt: options.appendSystemPrompt }),
+    });
+    const customTools = [
+        ...createRuntimeCodingTools(options.runtime),
+        ...(options.customTools ?? []),
+    ];
+    const result = await createAgentSession({
+        cwd: options.runtime.cwd,
+        agentDir,
+        modelRuntime: options.modelRuntime,
+        noTools: 'builtin',
+        customTools,
+        resourceLoader,
+        sessionManager: options.sessionManager,
+        settingsManager: options.settingsManager,
+        ...(options.model === undefined ? {} : { model: options.model }),
+        ...(options.thinkingLevel === undefined ? {} : { thinkingLevel: options.thinkingLevel }),
+        ...(options.scopedModels === undefined ? {} : { scopedModels: options.scopedModels }),
+        ...(options.sessionStartEvent === undefined
+            ? {}
+            : { sessionStartEvent: options.sessionStartEvent }),
+    });
+    if (options.host.wrapStreamFunction) {
+        const wrapped = options.host.wrapStreamFunction(result.session.agent.streamFunction);
+        if (typeof wrapped !== 'function') {
+            throw new Error('AgentSessionHost.wrapStreamFunction must return a stream function');
+        }
+        result.session.agent.streamFunction = wrapped;
+    }
+    return {
+        result,
+        services: {
+            cwd: options.runtime.cwd,
+            agentDir,
+            modelRuntime: options.modelRuntime,
+            settingsManager: options.settingsManager,
+            resourceLoader,
+            diagnostics: [],
+        },
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/test-agent-runtime.d.ts

@@ -0,0 +1,41 @@
+import type { AgentRuntime, AgentRuntimeKind, ExecOptions, ExecResult } from './runtime.js';
+export type TestShellOptions = ExecOptions & {
+    env?: Readonly<Record<string, string>>;
+};
+export interface TestExecCall {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly options?: ExecOptions;
+}
+export interface TestShellCall {
+    readonly command: string;
+    readonly options?: TestShellOptions;
+}
+export interface TestAgentRuntimeOptions {
+    readonly kind?: AgentRuntimeKind;
+    readonly exec?: (call: TestExecCall) => ExecResult | Promise<ExecResult>;
+    readonly shell?: (call: TestShellCall) => ExecResult | Promise<ExecResult>;
+}
+export declare class TestAgentRuntime implements AgentRuntime {
+    #private;
+    readonly execCalls: TestExecCall[];
+    readonly shellCalls: TestShellCall[];
+    constructor(cwd?: string, options?: TestAgentRuntimeOptions);
+    get cwd(): string;
+    get kind(): AgentRuntimeKind;
+    exec(command: string, args: readonly string[], options?: ExecOptions): Promise<ExecResult>;
+    shell(command: string, options?: TestShellOptions): Promise<ExecResult>;
+    readFile(path: string): Promise<Uint8Array>;
+    writeFile(path: string, content: Uint8Array): Promise<void>;
+    listFiles(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<string[]>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    remove(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    addSymlink(path: string, target: string): void;
+}
+//# sourceMappingURL=test-agent-runtime.d.ts.map

package/dist/test-agent-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-agent-runtime.d.ts","sourceRoot":"","sources":["../src/test-agent-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE5F,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5E;AASD,qBAAa,gBAAiB,YAAW,YAAY;;IASnD,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,CAAM;IACxC,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,CAAM;gBAE9B,GAAG,SAAe,EAAE,OAAO,GAAE,uBAA4B;IAQrE,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,IAAI,IAAI,gBAAgB,CAE3B;IAEK,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAa1F,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAWvE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAS3C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAc7E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBrE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB5E,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CA+F/C"}

package/dist/test-agent-runtime.js

@@ -0,0 +1,203 @@
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+const successResult = () => ({
+    stdout: '',
+    stderr: '',
+    code: 0,
+    killed: false,
+});
+export class TestAgentRuntime {
+    #cwd;
+    #kind;
+    #execHandler;
+    #shellHandler;
+    #files = new Map();
+    #directories = new Set();
+    #symlinks = new Map();
+    execCalls = [];
+    shellCalls = [];
+    constructor(cwd = '/workspace', options = {}) {
+        this.#cwd = resolve(cwd);
+        this.#kind = options.kind ?? 'host';
+        this.#execHandler = options.exec ?? successResult;
+        this.#shellHandler = options.shell ?? successResult;
+        this.#directories.add(this.#cwd);
+    }
+    get cwd() {
+        return this.#cwd;
+    }
+    get kind() {
+        return this.#kind;
+    }
+    async exec(command, args, options) {
+        const normalizedOptions = this.#normalizeExecOptions(options);
+        if (normalizedOptions?.signal?.aborted) {
+            return this.#killedResult();
+        }
+        const call = normalizedOptions
+            ? { command, args: [...args], options: normalizedOptions }
+            : { command, args: [...args] };
+        this.execCalls.push(call);
+        return this.#run(() => this.#execHandler(call), normalizedOptions);
+    }
+    async shell(command, options) {
+        const normalizedOptions = this.#normalizeShellOptions(options);
+        if (normalizedOptions?.signal?.aborted) {
+            return this.#killedResult();
+        }
+        const call = normalizedOptions ? { command, options: normalizedOptions } : { command };
+        this.shellCalls.push(call);
+        return this.#run(() => this.#shellHandler(call), normalizedOptions);
+    }
+    async readFile(path) {
+        const resolvedPath = this.#resolvePath(path);
+        const content = this.#files.get(resolvedPath);
+        if (!content) {
+            throw new Error(`File does not exist: ${path}`);
+        }
+        return content.slice();
+    }
+    async writeFile(path, content) {
+        const resolvedPath = this.#resolvePath(path, false);
+        if (!this.#directories.has(dirname(resolvedPath))) {
+            throw new Error(`Parent directory does not exist: ${path}`);
+        }
+        this.#files.set(resolvedPath, content.slice());
+    }
+    async listFiles(path, options) {
+        const resolvedPath = this.#resolvePath(path);
+        if (!this.#directories.has(resolvedPath)) {
+            throw new Error(`Directory does not exist: ${path}`);
+        }
+        const prefix = `${resolvedPath}${sep}`;
+        return [...this.#files.keys()]
+            .filter((filePath) => filePath.startsWith(prefix))
+            .map((filePath) => relative(resolvedPath, filePath))
+            .filter((filePath) => options?.recursive || !filePath.includes(sep))
+            .sort();
+    }
+    async mkdir(path, options) {
+        const resolvedPath = this.#resolvePath(path);
+        if (options?.recursive) {
+            let current = resolvedPath;
+            const pending = [];
+            while (current !== this.#cwd && !this.#directories.has(current)) {
+                pending.push(current);
+                current = dirname(current);
+            }
+            for (const directory of pending.reverse()) {
+                this.#directories.add(directory);
+            }
+            return;
+        }
+        if (!this.#directories.has(dirname(resolvedPath))) {
+            throw new Error(`Parent directory does not exist: ${path}`);
+        }
+        this.#directories.add(resolvedPath);
+    }
+    async remove(path, options) {
+        const resolvedPath = this.#resolvePath(path, false);
+        const prefix = `${resolvedPath}${sep}`;
+        const descendants = [...this.#files.keys(), ...this.#directories, ...this.#symlinks.keys()]
+            .filter((entry) => entry.startsWith(prefix));
+        if (descendants.length > 0 && !options?.recursive) {
+            throw new Error(`Directory is not empty: ${path}`);
+        }
+        this.#files.delete(resolvedPath);
+        this.#directories.delete(resolvedPath);
+        this.#symlinks.delete(resolvedPath);
+        if (options?.recursive) {
+            for (const entry of descendants) {
+                this.#files.delete(entry);
+                this.#directories.delete(entry);
+                this.#symlinks.delete(entry);
+            }
+        }
+    }
+    addSymlink(path, target) {
+        const linkPath = this.#resolvePath(path, false, false);
+        const targetPath = isAbsolute(target) ? resolve(target) : resolve(dirname(linkPath), target);
+        this.#symlinks.set(linkPath, targetPath);
+    }
+    #normalizeExecOptions(options) {
+        if (!options) {
+            return undefined;
+        }
+        const normalized = {};
+        if (options.cwd !== undefined)
+            normalized.cwd = this.#resolvePath(options.cwd);
+        if (options.signal !== undefined)
+            normalized.signal = options.signal;
+        if (options.timeout !== undefined)
+            normalized.timeout = options.timeout;
+        return normalized;
+    }
+    #normalizeShellOptions(options) {
+        const normalized = this.#normalizeExecOptions(options);
+        if (!options?.env) {
+            return normalized;
+        }
+        return { ...normalized, env: { ...options.env } };
+    }
+    async #run(handler, options) {
+        if ((!options?.timeout || options.timeout <= 0) && !options?.signal) {
+            return handler();
+        }
+        let timeout;
+        let abortListener;
+        const cancellation = new Promise((resolveCancellation) => {
+            if (options?.timeout && options.timeout > 0) {
+                timeout = setTimeout(() => resolveCancellation(this.#killedResult()), options.timeout);
+            }
+            if (options?.signal) {
+                abortListener = () => resolveCancellation(this.#killedResult());
+                options.signal.addEventListener('abort', abortListener, { once: true });
+            }
+        });
+        try {
+            return await Promise.race([handler(), cancellation]);
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+            if (abortListener && options?.signal) {
+                options.signal.removeEventListener('abort', abortListener);
+            }
+        }
+    }
+    #killedResult() {
+        return { stdout: '', stderr: '', code: 143, killed: true };
+    }
+    #resolvePath(path, allowRoot = true, followSymlinks = true) {
+        if (path.includes('\0')) {
+            throw new Error('Paths cannot contain NUL bytes');
+        }
+        let resolvedPath = isAbsolute(path) ? resolve(path) : resolve(this.#cwd, path);
+        this.#assertContained(resolvedPath, allowRoot);
+        if (followSymlinks) {
+            const relativePath = relative(this.#cwd, resolvedPath);
+            const segments = relativePath === '' ? [] : relativePath.split(sep);
+            let current = this.#cwd;
+            for (let index = 0; index < segments.length; index += 1) {
+                current = resolve(current, segments[index]);
+                const target = this.#symlinks.get(current);
+                if (target) {
+                    resolvedPath = resolve(target, ...segments.slice(index + 1));
+                    this.#assertContained(resolvedPath, allowRoot);
+                    break;
+                }
+            }
+        }
+        return resolvedPath;
+    }
+    #assertContained(path, allowRoot) {
+        const relativePath = relative(this.#cwd, path);
+        const contained = relativePath === '' || (!relativePath.startsWith(`..${sep}`) && relativePath !== '..' && !isAbsolute(relativePath));
+        if (!contained) {
+            throw new Error(`Path escapes runtime cwd: ${path}`);
+        }
+        if (!allowRoot && relativePath === '') {
+            throw new Error('The runtime cwd cannot be modified or removed');
+        }
+    }
+}
+//# sourceMappingURL=test-agent-runtime.js.map