@agent-relay/sdk 2.3.14 → 2.4.1

package/dist/__tests__/contract-fixtures.test.d.ts

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

package/dist/__tests__/contract-fixtures.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-fixtures.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/contract-fixtures.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/contract-fixtures.test.js

@@ -0,0 +1,85 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import path from 'node:path';
+import test from 'node:test';
+import { fileURLToPath } from 'node:url';
+import { AgentRelayClient, AgentRelayProtocolError } from '../client.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const fixturesDir = path.resolve(__dirname, '../../../contracts/fixtures');
+function readFixture(name) {
+    const fixturePath = path.join(fixturesDir, name);
+    const raw = fs.readFileSync(fixturePath, 'utf8');
+    return JSON.parse(raw);
+}
+function isCurrentSdkBrokerEventShape(event) {
+    const kind = event.kind;
+    if (typeof kind !== 'string')
+        return false;
+    switch (kind) {
+        case 'relay_inbound':
+            return (typeof event.event_id === 'string' &&
+                typeof event.from === 'string' &&
+                typeof event.target === 'string' &&
+                typeof event.body === 'string');
+        case 'agent_spawned':
+            return typeof event.name === 'string' && typeof event.runtime === 'string';
+        case 'agent_exited':
+            return typeof event.name === 'string';
+        case 'agent_released':
+            return typeof event.name === 'string';
+        case 'worker_ready':
+            return typeof event.name === 'string' && typeof event.runtime === 'string';
+        case 'agent_idle':
+            return typeof event.name === 'string' && typeof event.idle_secs === 'number';
+        case 'delivery_verified':
+            return (typeof event.name === 'string' &&
+                typeof event.delivery_id === 'string' &&
+                typeof event.event_id === 'string');
+        case 'delivery_failed':
+            return (typeof event.name === 'string' &&
+                typeof event.delivery_id === 'string' &&
+                typeof event.event_id === 'string' &&
+                typeof event.reason === 'string');
+        case 'worker_error':
+            return (typeof event.name === 'string' &&
+                typeof event.code === 'string' &&
+                typeof event.message === 'string');
+        case 'agent_restarting':
+        case 'agent_restarted':
+        case 'agent_permanently_dead':
+            return typeof event.name === 'string';
+        default:
+            return false;
+    }
+}
+test('contracts: broker-sdk unsupported_operation fallback maps to shared RelayErrorCode set', async () => {
+    const fixture = readFixture('error-fixtures.json');
+    const allowedCodes = new Set(fixture.relay_errors.map((entry) => entry.code));
+    const client = new AgentRelayClient();
+    client.start = async () => undefined;
+    client.requestOk = async () => {
+        throw new AgentRelayProtocolError({
+            code: 'unsupported_operation',
+            message: 'send_message unsupported',
+            retryable: false,
+        });
+    };
+    const result = await client.sendMessage({
+        to: 'WorkerA',
+        text: 'contract-gate probe',
+    });
+    assert.equal(result.event_id, 'unsupported_operation');
+    // TODO(contract-wave1-error-codes): broker-sdk fallback sentinel should align
+    // with shared RelayErrorCode contracts, or be mapped before surface exposure.
+    assert.equal(allowedCodes.has(result.event_id), true, `unsupported fallback code \"${result.event_id}\" is outside shared RelayErrorCode fixture set`);
+});
+test('contracts: broker-sdk event surface conforms to shared BrokerEvent fixture envelope', async () => {
+    const fixture = readFixture('event-fixtures.json');
+    for (const event of fixture.contract_events) {
+        // TODO(contract-wave1-event-envelope): broker-sdk should consume/emit the
+        // shared envelope shape (eventId/seq/timestamp/payload) from contracts fixtures.
+        assert.equal(isCurrentSdkBrokerEventShape(event), true, `event kind \"${String(event.kind)}\" does not match current broker-sdk event surface`);
+    }
+});
+//# sourceMappingURL=contract-fixtures.test.js.map

package/dist/__tests__/contract-fixtures.test.js.map

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

package/dist/__tests__/facade.test.d.ts

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

package/dist/__tests__/facade.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/facade.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/facade.test.js

@@ -0,0 +1,305 @@
+/**
+ * Facade integration tests — exercises new AgentRelay capabilities:
+ * spawn with initial task, getLogs, waitForAny, broadcast, onAgentReady, exit code.
+ *
+ * Run:
+ *   npm run build && node --test dist/__tests__/facade.test.js
+ *
+ * Requires:
+ *   RELAY_API_KEY — Relaycast workspace key
+ *   AGENT_RELAY_BIN (optional) — path to agent-relay-broker binary
+ */
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import path from "node:path";
+import test from "node:test";
+import { AgentRelay } from "../relay.js";
+// ── helpers ─────────────────────────────────────────────────────────────────
+function resolveBinaryPath() {
+    if (process.env.AGENT_RELAY_BIN) {
+        return process.env.AGENT_RELAY_BIN;
+    }
+    return path.resolve(process.cwd(), "../../target/debug/agent-relay-broker");
+}
+function requireRelaycast(t) {
+    if (!process.env.RELAY_API_KEY?.trim()) {
+        t.skip("RELAY_API_KEY is required");
+        return false;
+    }
+    return true;
+}
+function requireBinary(t) {
+    const bin = resolveBinaryPath();
+    if (!fs.existsSync(bin)) {
+        t.skip(`agent-relay-broker binary not found at ${bin}`);
+        return null;
+    }
+    return bin;
+}
+function makeRelay(bin) {
+    return new AgentRelay({
+        binaryPath: bin,
+        requestTimeoutMs: 10_000,
+        env: process.env,
+    });
+}
+// ── spawn with initial task ─────────────────────────────────────────────────
+test("facade: spawn with initial task delivers task after worker_ready", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    const readyNames = [];
+    relay.onAgentReady = (agent) => readyNames.push(agent.name);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Task-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+            task: "Hello from initial task",
+        });
+        // Wait a bit for worker_ready event to propagate
+        await new Promise((r) => setTimeout(r, 2_000));
+        assert.ok(readyNames.includes(agent.name), "onAgentReady should fire for spawned agent");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── onAgentReady ────────────────────────────────────────────────────────────
+test("facade: onAgentReady fires when worker becomes ready", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    const readyAgents = [];
+    relay.onAgentReady = (agent) => readyAgents.push(agent);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Ready-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        // Give the worker time to send worker_ready
+        await new Promise((r) => setTimeout(r, 2_000));
+        assert.ok(readyAgents.some((a) => a.name === agent.name), "onAgentReady should fire with the correct agent");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── broadcast ───────────────────────────────────────────────────────────────
+test("facade: broadcast sends to all agents", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    const sentMessages = [];
+    relay.onMessageSent = (msg) => sentMessages.push(msg);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Broadcast-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        const msg = await relay.broadcast("Hello everyone!");
+        assert.equal(msg.to, "*");
+        assert.equal(msg.text, "Hello everyone!");
+        assert.equal(msg.from, "human:orchestrator");
+        assert.equal(sentMessages.length, 1);
+        // Broadcast with custom from
+        const msg2 = await relay.broadcast("Custom sender", { from: "System" });
+        assert.equal(msg2.from, "System");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── waitForAny ──────────────────────────────────────────────────────────────
+test("facade: waitForAny returns first agent to exit", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    try {
+        const [a, b] = await Promise.all([
+            relay.spawnPty({ name: `WaitA-${suffix}`, cli: "cat", channels: ["general"] }),
+            relay.spawnPty({ name: `WaitB-${suffix}`, cli: "cat", channels: ["general"] }),
+        ]);
+        // Release agent A — it should be the first to exit
+        setTimeout(() => a.release(), 500);
+        const { agent, result } = await AgentRelay.waitForAny([a, b], 10_000);
+        assert.equal(agent.name, a.name);
+        assert.equal(result, "released");
+        await b.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── waitForAny with timeout ─────────────────────────────────────────────────
+test("facade: waitForAny respects timeout", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Timeout-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        const { result } = await AgentRelay.waitForAny([agent], 500);
+        assert.equal(result, "timeout");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── exit code ───────────────────────────────────────────────────────────────
+test("facade: onAgentExited populates exitCode and exitSignal", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    const exitedAgents = [];
+    relay.onAgentExited = (agent) => exitedAgents.push(agent);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Exit-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        await agent.release();
+        // Give time for exit event to propagate
+        await new Promise((r) => setTimeout(r, 1_000));
+        // The agent should have exited — check that exitCode or exitSignal is set
+        // (exact values depend on how cat is terminated)
+        const exited = exitedAgents.find((a) => a.name === agent.name);
+        if (exited) {
+            assert.ok(exited.exitCode !== undefined || exited.exitSignal !== undefined, "exitCode or exitSignal should be populated");
+        }
+        // It's also valid for only onAgentReleased to fire (not onAgentExited)
+        // since the broker may clean up before the process exits
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── getLogs ──────────────────────────────────────────────────────────────────
+test("facade: getLogs returns log content for agent", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const suffix = Date.now().toString(36);
+    const relay = makeRelay(bin);
+    try {
+        const agent = await relay.spawnPty({
+            name: `Logs-${suffix}`,
+            cli: "cat",
+            channels: ["general"],
+        });
+        // Give time for some output to be logged
+        await new Promise((r) => setTimeout(r, 2_000));
+        const logs = await relay.getLogs(agent.name);
+        // Logs may or may not be found depending on whether the worker writes to the log file
+        // The important thing is the API works without error
+        assert.equal(logs.agent, agent.name);
+        assert.equal(typeof logs.found, "boolean");
+        assert.equal(typeof logs.content, "string");
+        await agent.release();
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── listLoggedAgents ────────────────────────────────────────────────────────
+test("facade: listLoggedAgents returns array", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    const relay = makeRelay(bin);
+    try {
+        // Just verify the API works and returns an array
+        const agents = await relay.listLoggedAgents();
+        assert.ok(Array.isArray(agents));
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+// ── workspaceKey / observerUrl from hello_ack ────────────────────────────────
+test("facade: workspaceKey is populated from broker hello_ack after startup", async (t) => {
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    // Create relay WITHOUT passing RELAY_API_KEY in env — broker creates its own
+    // workspace and returns the key via hello_ack. This tests the fix for the
+    // "dual workspace" bug where SDK and broker used different workspace keys.
+    const envWithoutKey = { ...process.env };
+    delete envWithoutKey.RELAY_API_KEY;
+    const relay = new AgentRelay({
+        binaryPath: bin,
+        requestTimeoutMs: 15_000,
+        env: envWithoutKey,
+    });
+    try {
+        await relay.getStatus();
+        // After startup, workspaceKey MUST be set from the broker's hello_ack.
+        assert.ok(relay.workspaceKey, "workspaceKey must be set after broker startup (read from hello_ack workspace_key field)");
+        assert.match(relay.workspaceKey, /^rk_live_/, "workspaceKey must be a valid workspace key (rk_live_ prefix)");
+        // observerUrl must be correctly formatted.
+        assert.ok(relay.observerUrl, "observerUrl must be defined when workspaceKey is set");
+        assert.ok(relay.observerUrl.includes(relay.workspaceKey), "observerUrl must contain the workspace key");
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+test("facade: workspaceKey from env matches broker hello_ack when valid", async (t) => {
+    if (!requireRelaycast(t))
+        return;
+    const bin = requireBinary(t);
+    if (!bin)
+        return;
+    // When RELAY_API_KEY is valid, the broker uses it and returns the same key
+    // in hello_ack. SDK and broker must be on the same workspace.
+    const relay = makeRelay(bin);
+    try {
+        await relay.getStatus();
+        assert.ok(relay.workspaceKey, "workspaceKey must be set after startup");
+        // The workspace key returned by broker must match what we passed in.
+        assert.equal(relay.workspaceKey, process.env.RELAY_API_KEY, "broker hello_ack workspace_key must match the RELAY_API_KEY we passed — " +
+            "a mismatch means broker and SDK are on different workspaces, breaking MCP auth");
+    }
+    finally {
+        await relay.shutdown();
+    }
+});
+//# sourceMappingURL=facade.test.js.map

package/dist/__tests__/facade.test.js.map

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

package/dist/__tests__/integration.test.d.ts

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

package/dist/__tests__/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/integration.test.js

@@ -0,0 +1,169 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import test, { before } from 'node:test';
+import { AgentRelayClient, AgentRelayProcessError } from '../client.js';
+import { RelayCast } from '@relaycast/sdk';
+function resolveBinaryPath() {
+    if (process.env.AGENT_RELAY_BIN) {
+        return process.env.AGENT_RELAY_BIN;
+    }
+    return path.resolve(process.cwd(), '../../target/debug/agent-relay-broker');
+}
+function resolveBundledBinaryPath() {
+    const exe = process.platform === 'win32' ? 'agent-relay-broker.exe' : 'agent-relay-broker';
+    return path.resolve(process.cwd(), 'bin', exe);
+}
+// Ensure RELAY_API_KEY is available before any tests run.
+// Creates an ephemeral workspace if no key is set.
+before(async () => {
+    if (process.env.RELAY_API_KEY?.trim())
+        return;
+    const ws = await RelayCast.createWorkspace(`sdk-test-${Date.now().toString(36)}`);
+    const workspace = ws;
+    const apiKey = workspace.apiKey ?? workspace.api_key;
+    if (!apiKey) {
+        throw new Error('RelayCast.createWorkspace() did not return an API key');
+    }
+    process.env.RELAY_API_KEY = apiKey;
+});
+test('sdk can use bundled binary by default', async (t) => {
+    const bundledBinary = resolveBundledBinaryPath();
+    if (!fs.existsSync(bundledBinary)) {
+        t.skip(`bundled binary not found at ${bundledBinary}`);
+        return;
+    }
+    const client = await AgentRelayClient.start({
+        env: process.env,
+    });
+    try {
+        const agents = await client.listAgents();
+        assert.ok(Array.isArray(agents), 'listAgents should return an array');
+    }
+    finally {
+        await client.shutdown();
+    }
+});
+test('sdk can start broker and manage agent lifecycle', async (t) => {
+    const binaryPath = resolveBinaryPath();
+    if (!fs.existsSync(binaryPath)) {
+        t.skip(`agent-relay-broker binary not found at ${binaryPath}`);
+        return;
+    }
+    const client = await AgentRelayClient.start({
+        binaryPath,
+        requestTimeoutMs: 8_000,
+        shutdownTimeoutMs: 2_000,
+        env: process.env,
+    });
+    const spawnedName = `sdk-test-${Date.now().toString(36)}`;
+    const seenEvents = [];
+    const unsub = client.onEvent((event) => {
+        seenEvents.push(event.kind);
+    });
+    try {
+        const spawned = await client.spawnPty({
+            name: spawnedName,
+            cli: 'cat',
+            channels: ['general'],
+        });
+        assert.equal(spawned.name, spawnedName);
+        assert.equal(spawned.runtime, 'pty');
+        const agentsAfterSpawn = await client.listAgents();
+        const spawnedAgent = agentsAfterSpawn.find((agent) => agent.name === spawnedName);
+        assert.ok(spawnedAgent, 'spawned agent should be present in listAgents()');
+        assert.equal(spawnedAgent?.runtime, 'pty');
+        const released = await client.release(spawnedName);
+        assert.equal(released.name, spawnedName);
+        const agentsAfterRelease = await client.listAgents();
+        assert.equal(agentsAfterRelease.some((agent) => agent.name === spawnedName), false, 'released agent should not be present in listAgents()');
+        assert.ok(seenEvents.includes('agent_spawned'), 'expected agent_spawned event');
+        assert.ok(seenEvents.includes('agent_released'), 'expected agent_released event');
+    }
+    finally {
+        unsub();
+        await client.shutdown();
+    }
+});
+test('sdk can spawn and release headless claude worker', async (t) => {
+    const binaryPath = resolveBinaryPath();
+    if (!fs.existsSync(binaryPath)) {
+        t.skip(`agent-relay-broker binary not found at ${binaryPath}`);
+        return;
+    }
+    const client = await AgentRelayClient.start({
+        binaryPath,
+        requestTimeoutMs: 8_000,
+        shutdownTimeoutMs: 2_000,
+        env: process.env,
+    });
+    const spawnedName = `sdk-headless-${Date.now().toString(36)}`;
+    const seenEvents = [];
+    const unsub = client.onEvent((event) => {
+        seenEvents.push(event.kind);
+    });
+    try {
+        const spawned = await client.spawnHeadlessClaude({
+            name: spawnedName,
+            channels: ['general'],
+        });
+        assert.equal(spawned.name, spawnedName);
+        assert.equal(spawned.runtime, 'headless_claude');
+        const agentsAfterSpawn = await client.listAgents();
+        const spawnedAgent = agentsAfterSpawn.find((agent) => agent.name === spawnedName);
+        assert.ok(spawnedAgent, 'spawned headless agent should be present in listAgents()');
+        assert.equal(spawnedAgent?.runtime, 'headless_claude');
+        const released = await client.release(spawnedName);
+        assert.equal(released.name, spawnedName);
+        const agentsAfterRelease = await client.listAgents();
+        assert.equal(agentsAfterRelease.some((agent) => agent.name === spawnedName), false, 'released headless agent should not be present in listAgents()');
+        assert.ok(seenEvents.includes('agent_spawned'), 'expected agent_spawned event');
+        assert.ok(seenEvents.includes('agent_released'), 'expected agent_released event');
+    }
+    finally {
+        unsub();
+        await client.shutdown();
+    }
+});
+test('sdk surfaces process error when binary is missing', async () => {
+    await assert.rejects(AgentRelayClient.start({
+        binaryPath: '/definitely/missing/agent-relay-broker',
+        requestTimeoutMs: 1_000,
+    }), (error) => {
+        return error instanceof AgentRelayProcessError || error instanceof Error;
+    });
+});
+test('sdk includes broker stderr details when startup fails', async (t) => {
+    const binaryPath = resolveBinaryPath();
+    if (!fs.existsSync(binaryPath)) {
+        t.skip(`agent-relay-broker binary not found at ${binaryPath}`);
+        return;
+    }
+    const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'sdk-broker-lock-'));
+    const first = await AgentRelayClient.start({
+        binaryPath,
+        cwd,
+        requestTimeoutMs: 8_000,
+        shutdownTimeoutMs: 2_000,
+        env: process.env,
+    });
+    try {
+        await assert.rejects(AgentRelayClient.start({
+            binaryPath,
+            cwd,
+            requestTimeoutMs: 2_000,
+            shutdownTimeoutMs: 2_000,
+            env: process.env,
+        }), (error) => {
+            assert.ok(error instanceof AgentRelayProcessError || error instanceof Error);
+            assert.match(String(error.message), /another broker instance is already running/i);
+            return true;
+        });
+    }
+    finally {
+        await first.shutdown();
+        fs.rmSync(cwd, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/__tests__/integration.test.js.map

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

package/dist/__tests__/pty.test.d.ts

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

package/dist/__tests__/pty.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/pty.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/pty.test.js

@@ -0,0 +1,20 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { cleanLines, stripAnsi } from "../pty.js";
+test("stripAnsi: strips CSI/OSC sequences", () => {
+    assert.equal(stripAnsi("\x1b[32mgreen\x1b[0m"), "green");
+    assert.equal(stripAnsi("\x1b]0;title\x07text"), "text");
+});
+test("stripAnsi: preserves cursor-forward spacing for ANSI CSI", () => {
+    const input = "\x1b[1CYes,\x1b[2CI\x1b[1Caccept";
+    assert.equal(stripAnsi(input), " Yes,  I accept");
+});
+test("stripAnsi: preserves cursor-forward spacing for orphaned CSI", () => {
+    const input = "[1CYes,[2CI[1Caccept";
+    assert.equal(stripAnsi(input), " Yes,  I accept");
+});
+test("cleanLines: strips ANSI and keeps non-empty lines", () => {
+    const lines = cleanLines("\x1b[32mline-1\x1b[0m\n\nline-2\n");
+    assert.deepEqual(lines, ["line-1", "line-2"]);
+});
+//# sourceMappingURL=pty.test.js.map