@phnx-labs/agents-cli 0.1.0

package/dist/lib/profiles-presets.js

@@ -0,0 +1,95 @@
+// Model IDs verified against openrouter.ai/api/v1/models on 2026-04-20.
+// Presets target the top-ranked open-source model per provider based on
+// SWE-bench Verified, LiveCodeBench, HumanEval, and Chatbot Arena rankings.
+//
+// Important limitation of Claude Code + non-Anthropic models via OpenRouter:
+// Claude Code sends `thinking:{type:"enabled"}` in its Anthropic payload by
+// default, and its `--print` consolidation returns empty text when a response
+// contains thinking/redacted_thinking blocks — even when the model *also*
+// emits a text block. This means reasoning models work fine in interactive
+// `claude` mode (same env vars) but `agents run <profile> --print` sees
+// empty stdout.
+//
+// Presets flagged "print-safe" use non-reasoning variants that ignore
+// thinking:enabled. Presets flagged "reasoning" are the leaderboard leaders
+// but are best invoked interactively.
+const OPENROUTER_BASE = 'https://openrouter.ai/api';
+const OPENROUTER_AUTH = {
+    provider: 'openrouter',
+    host: 'claude',
+    authEnvVar: 'ANTHROPIC_AUTH_TOKEN',
+    signupUrl: 'https://openrouter.ai/keys',
+};
+export const PRESETS = [
+    // ----- Top coding (via OpenRouter) -----
+    {
+        name: 'kimi',
+        description: 'Kimi K2.5 via OpenRouter (262K ctx, $0.38/$1.72 per 1M). Top Kimi: 99% HumanEval, 76.8% SWE-bench. REASONING — works interactively, but `agents run --print` returns empty stdout. Use `kimi-chat` preset for scripting.',
+        ...OPENROUTER_AUTH,
+        env: {
+            ANTHROPIC_BASE_URL: OPENROUTER_BASE,
+            ANTHROPIC_MODEL: 'moonshotai/kimi-k2.5',
+            ANTHROPIC_SMALL_FAST_MODEL: 'moonshotai/kimi-k2.5',
+        },
+    },
+    {
+        name: 'kimi-chat',
+        description: 'Kimi K2 0905 via OpenRouter (262K ctx, $0.40/$2.00 per 1M). Non-reasoning sibling of K2.5 — slightly older but PRINT-SAFE, works end-to-end with `agents run --print` and in scripts/automation.',
+        ...OPENROUTER_AUTH,
+        env: {
+            ANTHROPIC_BASE_URL: OPENROUTER_BASE,
+            ANTHROPIC_MODEL: 'moonshotai/kimi-k2-0905',
+            ANTHROPIC_SMALL_FAST_MODEL: 'moonshotai/kimi-k2-0905',
+        },
+    },
+    {
+        name: 'minimax',
+        description: 'MiniMax M2.5 via OpenRouter (230B params). #1 SWE-bench Verified (80.2%) on Apr 2026 leaderboards. REASONING — works interactively, --print returns empty.',
+        ...OPENROUTER_AUTH,
+        env: {
+            ANTHROPIC_BASE_URL: OPENROUTER_BASE,
+            ANTHROPIC_MODEL: 'minimax/minimax-m2.5',
+            ANTHROPIC_SMALL_FAST_MODEL: 'minimax/minimax-m2.5',
+        },
+    },
+    {
+        name: 'glm',
+        description: 'GLM 5 via OpenRouter (80K ctx, $0.72/$2.30 per 1M). #1 Chatbot Arena ELO (1451) among open-weight models on BenchLM.ai (Apr 2026). Prompt-complexity-dependent reasoning — Claude Code\'s 38K system prompt typically triggers thinking blocks, so --print is unreliable. Interactive use is fine.',
+        ...OPENROUTER_AUTH,
+        env: {
+            ANTHROPIC_BASE_URL: OPENROUTER_BASE,
+            ANTHROPIC_MODEL: 'z-ai/glm-5',
+            ANTHROPIC_SMALL_FAST_MODEL: 'z-ai/glm-5',
+        },
+    },
+    {
+        name: 'qwen',
+        description: 'Qwen3 Coder Next via OpenRouter (256K ctx, $0.15/$0.80 per 1M, sparse MoE 80B/3B active). Latest coding-specific Qwen (Feb 2026). PRINT-SAFE — works with `agents run --print`.',
+        ...OPENROUTER_AUTH,
+        env: {
+            ANTHROPIC_BASE_URL: OPENROUTER_BASE,
+            ANTHROPIC_MODEL: 'qwen/qwen3-coder-next',
+            ANTHROPIC_SMALL_FAST_MODEL: 'qwen/qwen3-coder-next',
+        },
+    },
+    {
+        name: 'deepseek',
+        description: 'DeepSeek Chat V3 (0324) via OpenRouter. Latest DeepSeek Chat variant that ignores thinking:enabled. PRINT-SAFE. The newer V3.2 / V3.1-Terminus / V3.2-Speciale are reasoning variants — use `--model deepseek/deepseek-v3.2` to override if you want those for interactive use.',
+        ...OPENROUTER_AUTH,
+        env: {
+            ANTHROPIC_BASE_URL: OPENROUTER_BASE,
+            ANTHROPIC_MODEL: 'deepseek/deepseek-chat-v3-0324',
+            ANTHROPIC_SMALL_FAST_MODEL: 'deepseek/deepseek-chat-v3-0324',
+        },
+    },
+];
+export function getPreset(name) {
+    return PRESETS.find((p) => p.name === name);
+}
+export function listPresets() {
+    return [...PRESETS];
+}
+export function listProviders() {
+    return [...new Set(PRESETS.map((p) => p.provider))];
+}
+//# sourceMappingURL=profiles-presets.js.map

package/dist/lib/profiles-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles-presets.js","sourceRoot":"","sources":["../../src/lib/profiles-presets.ts"],"names":[],"mappings":"AAYA,wEAAwE;AACxE,wEAAwE;AACxE,4EAA4E;AAC5E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,8EAA8E;AAC9E,0EAA0E;AAC1E,2EAA2E;AAC3E,wEAAwE;AACxE,gBAAgB;AAChB,EAAE;AACF,sEAAsE;AACtE,4EAA4E;AAC5E,sCAAsC;AAEtC,MAAM,eAAe,GAAG,2BAA2B,CAAC;AACpD,MAAM,eAAe,GAAmE;IACtF,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,sBAAsB;IAClC,SAAS,EAAE,4BAA4B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAa;IAC/B,0CAA0C;IAC1C;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,0NAA0N;QACvO,GAAG,eAAe;QAClB,GAAG,EAAE;YACH,kBAAkB,EAAE,eAAe;YACnC,eAAe,EAAE,sBAAsB;YACvC,0BAA0B,EAAE,sBAAsB;SACnD;KACF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,kMAAkM;QAC/M,GAAG,eAAe;QAClB,GAAG,EAAE;YACH,kBAAkB,EAAE,eAAe;YACnC,eAAe,EAAE,yBAAyB;YAC1C,0BAA0B,EAAE,yBAAyB;SACtD;KACF;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,4JAA4J;QACzK,GAAG,eAAe;QAClB,GAAG,EAAE;YACH,kBAAkB,EAAE,eAAe;YACnC,eAAe,EAAE,sBAAsB;YACvC,0BAA0B,EAAE,sBAAsB;SACnD;KACF;IACD;QACE,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,oSAAoS;QACjT,GAAG,eAAe;QAClB,GAAG,EAAE;YACH,kBAAkB,EAAE,eAAe;YACnC,eAAe,EAAE,YAAY;YAC7B,0BAA0B,EAAE,YAAY;SACzC;KACF;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,iLAAiL;QAC9L,GAAG,eAAe;QAClB,GAAG,EAAE;YACH,kBAAkB,EAAE,eAAe;YACnC,eAAe,EAAE,uBAAuB;YACxC,0BAA0B,EAAE,uBAAuB;SACpD;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,iRAAiR;QAC9R,GAAG,eAAe;QAClB,GAAG,EAAE;YACH,kBAAkB,EAAE,eAAe;YACnC,eAAe,EAAE,gCAAgC;YACjD,0BAA0B,EAAE,gCAAgC;SAC7D;KACF;CACF,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/lib/profiles.d.ts

@@ -0,0 +1,35 @@
+import type { AgentId } from './types.js';
+import { type Preset } from './profiles-presets.js';
+export interface Profile {
+    name: string;
+    host: {
+        agent: AgentId;
+        version?: string;
+    };
+    env: Record<string, string>;
+    auth?: {
+        envVar: string;
+        keychainItem: string;
+    };
+    description?: string;
+    preset?: string;
+    provider?: string;
+}
+export declare function getProfilesDir(): string;
+export declare function validateProfileName(name: string): void;
+export declare function profileExists(name: string): boolean;
+export declare function readProfile(name: string): Profile;
+export declare function writeProfile(profile: Profile): void;
+export declare function deleteProfile(name: string): boolean;
+export declare function listProfiles(): Profile[];
+export declare function profileFromPreset(profileName: string, preset: Preset, version?: string): Profile;
+export declare function resolveProfileEnv(profile: Profile): Record<string, string>;
+export interface ResolvedProfileRun {
+    agent: AgentId;
+    version?: string;
+    env: Record<string, string>;
+    profileName: string;
+}
+export declare function resolveProfileForRun(name: string): ResolvedProfileRun;
+export declare function getPresetForProfile(profile: Profile): Preset | undefined;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/lib/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/lib/profiles.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAMD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAItD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmBjD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMnD;AAED,wBAAgB,YAAY,IAAI,OAAO,EAAE,CAcxC;AAKD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAahG;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1E;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAQrE;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAExE"}

package/dist/lib/profiles.js

@@ -0,0 +1,123 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import { getAgentsDir } from './state.js';
+import { getKeychainToken, keychainItemName } from './profiles-keychain.js';
+import { getPreset } from './profiles-presets.js';
+const PROFILE_NAME_PATTERN = /^[a-z0-9][a-z0-9-_]{0,48}$/i;
+export function getProfilesDir() {
+    return path.join(getAgentsDir(), 'profiles');
+}
+function profilePath(name) {
+    return path.join(getProfilesDir(), `${name}.yml`);
+}
+export function validateProfileName(name) {
+    if (!PROFILE_NAME_PATTERN.test(name)) {
+        throw new Error(`Invalid profile name '${name}'. Use letters, digits, dash, underscore (max 48 chars).`);
+    }
+}
+export function profileExists(name) {
+    return fs.existsSync(profilePath(name));
+}
+export function readProfile(name) {
+    validateProfileName(name);
+    const file = profilePath(name);
+    if (!fs.existsSync(file)) {
+        throw new Error(`Profile '${name}' not found.`);
+    }
+    const raw = fs.readFileSync(file, 'utf-8');
+    const parsed = yaml.parse(raw);
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error(`Profile '${name}' is malformed.`);
+    }
+    if (!parsed.name)
+        parsed.name = name;
+    if (!parsed.host?.agent) {
+        throw new Error(`Profile '${name}' is missing host.agent.`);
+    }
+    if (!parsed.env || typeof parsed.env !== 'object') {
+        parsed.env = {};
+    }
+    return parsed;
+}
+export function writeProfile(profile) {
+    validateProfileName(profile.name);
+    const dir = getProfilesDir();
+    fs.mkdirSync(dir, { recursive: true });
+    const body = yaml.stringify(profile);
+    const file = profilePath(profile.name);
+    const tmp = `${file}.tmp-${process.pid}`;
+    fs.writeFileSync(tmp, body, 'utf-8');
+    fs.renameSync(tmp, file);
+}
+export function deleteProfile(name) {
+    validateProfileName(name);
+    const file = profilePath(name);
+    if (!fs.existsSync(file))
+        return false;
+    fs.unlinkSync(file);
+    return true;
+}
+export function listProfiles() {
+    const dir = getProfilesDir();
+    if (!fs.existsSync(dir))
+        return [];
+    const entries = fs.readdirSync(dir).filter((f) => f.endsWith('.yml') || f.endsWith('.yaml'));
+    const profiles = [];
+    for (const entry of entries) {
+        const name = entry.replace(/\.(yml|yaml)$/, '');
+        try {
+            profiles.push(readProfile(name));
+        }
+        catch {
+            // Skip malformed profile files; surfacing via `agents profiles view <name>`.
+        }
+    }
+    return profiles.sort((a, b) => a.name.localeCompare(b.name));
+}
+// Build a profile from a preset. The keychain item is shared across all
+// profiles that point at the same provider, so adding kimi + deepseek prompts
+// for the OpenRouter key exactly once.
+export function profileFromPreset(profileName, preset, version) {
+    return {
+        name: profileName,
+        host: { agent: preset.host, version },
+        env: { ...preset.env },
+        auth: {
+            envVar: preset.authEnvVar,
+            keychainItem: keychainItemName(preset.provider),
+        },
+        description: preset.description,
+        preset: preset.name,
+        provider: preset.provider,
+    };
+}
+// Resolve a profile into the env block that should be injected into the
+// spawned agent process. Reads the token from keychain at exec time so the
+// profile YAML never holds secrets.
+export function resolveProfileEnv(profile) {
+    const env = { ...profile.env };
+    if (profile.auth) {
+        const token = getKeychainToken(profile.auth.keychainItem);
+        env[profile.auth.envVar] = token;
+    }
+    return env;
+}
+// Resolve a name into (agent, version, env). Throws if the name is not a
+// profile. Callers are expected to try agent-id resolution first and fall
+// back to this when that fails, so we don't need a "isProfile" probe.
+export function resolveProfileForRun(name) {
+    const profile = readProfile(name);
+    return {
+        agent: profile.host.agent,
+        version: profile.host.version,
+        env: resolveProfileEnv(profile),
+        profileName: profile.name,
+    };
+}
+// Look up the preset a profile was created from, if any. Used by
+// `profiles view` to show upstream metadata like signup URLs.
+export function getPresetForProfile(profile) {
+    return profile.preset ? getPreset(profile.preset) : undefined;
+}
+//# sourceMappingURL=profiles.js.map

package/dist/lib/profiles.js.map

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

package/dist/lib/pty-client.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PTY Client
+ *
+ * Thin client that connects to the PTY sidecar server over unix socket.
+ * Each call opens a connection, sends a JSON request, reads the JSON response, and closes.
+ */
+export interface PtyResponse {
+    ok: boolean;
+    error?: string;
+    [key: string]: any;
+}
+/**
+ * Send a request to the PTY server and return the response.
+ * Auto-starts the server if not running.
+ */
+export declare function ptyRequest(action: string, id?: string, params?: Record<string, any>): Promise<PtyResponse>;
+/**
+ * Parse escape sequences in user input strings.
+ * Handles: \n \r \t \e \xHH \\
+ */
+export declare function unescapeInput(input: string): string;
+//# sourceMappingURL=pty-client.d.ts.map

package/dist/lib/pty-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-client.d.ts","sourceRoot":"","sources":["../../src/lib/pty-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAQhH;AAiJD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBnD"}

package/dist/lib/pty-client.js

@@ -0,0 +1,181 @@
+/**
+ * PTY Client
+ *
+ * Thin client that connects to the PTY sidecar server over unix socket.
+ * Each call opens a connection, sends a JSON request, reads the JSON response, and closes.
+ */
+import * as net from 'net';
+import * as fs from 'fs';
+import { spawn, execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import * as path from 'path';
+import { getSocketPath, isPtyServerRunning } from './pty-server.js';
+const CONNECT_TIMEOUT_MS = 5000;
+const RESPONSE_TIMEOUT_MS = 30000;
+/**
+ * Send a request to the PTY server and return the response.
+ * Auto-starts the server if not running.
+ */
+export async function ptyRequest(action, id, params) {
+    await ensureServer();
+    const req = { action };
+    if (id)
+        req.id = id;
+    if (params)
+        req.params = params;
+    return sendRequest(req);
+}
+/**
+ * Ensure the PTY server is running. Start it if not.
+ */
+async function ensureServer() {
+    if (isPtyServerRunning())
+        return;
+    // Find the entry point to spawn the server
+    const { bin, args } = getServerSpawnArgs();
+    const logPath = path.join(path.dirname(getSocketPath()), 'pty.log');
+    const logFd = fs.openSync(logPath, 'a');
+    const child = spawn(bin, args, {
+        stdio: ['ignore', logFd, logFd],
+        detached: true,
+    });
+    child.unref();
+    fs.closeSync(logFd);
+    // Wait for socket to appear
+    const socketPath = getSocketPath();
+    const deadline = Date.now() + 5000;
+    while (Date.now() < deadline) {
+        if (fs.existsSync(socketPath)) {
+            // Verify we can connect
+            try {
+                await sendRequest({ action: 'ping' });
+                return;
+            }
+            catch {
+                // Not ready yet
+            }
+        }
+        await new Promise(r => setTimeout(r, 100));
+    }
+    throw new Error('PTY server failed to start within 5 seconds. Check ~/.agents/pty.log');
+}
+function getServerSpawnArgs() {
+    // Prefer the dist/index.js from the same installation as this code.
+    // This avoids version mismatch when a globally installed `agents` is older.
+    try {
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        const distIndex = path.join(__dirname, '..', 'index.js');
+        if (fs.existsSync(distIndex)) {
+            return { bin: process.execPath, args: [distIndex, 'pty', '_server'] };
+        }
+    }
+    catch { }
+    // Fallback: use the globally installed agents command
+    try {
+        const agentsBin = execSync('which agents', { encoding: 'utf-8' }).trim();
+        if (agentsBin) {
+            return { bin: agentsBin, args: ['pty', '_server'] };
+        }
+    }
+    catch { }
+    return { bin: 'agents', args: ['pty', '_server'] };
+}
+/**
+ * Send a JSON request over the unix socket and return the parsed response.
+ */
+function sendRequest(req) {
+    return new Promise((resolve, reject) => {
+        const socketPath = getSocketPath();
+        if (!fs.existsSync(socketPath)) {
+            reject(new Error('PTY server socket not found. Is the server running?'));
+            return;
+        }
+        const conn = net.createConnection({ path: socketPath });
+        let data = '';
+        let settled = false;
+        const connectTimeout = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                conn.destroy();
+                reject(new Error('Connection to PTY server timed out'));
+            }
+        }, CONNECT_TIMEOUT_MS);
+        const responseTimeout = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                conn.destroy();
+                reject(new Error('PTY server response timed out'));
+            }
+        }, RESPONSE_TIMEOUT_MS);
+        conn.on('connect', () => {
+            clearTimeout(connectTimeout);
+            conn.write(JSON.stringify(req) + '\n');
+        });
+        conn.on('data', (chunk) => {
+            data += chunk.toString();
+            const nlIndex = data.indexOf('\n');
+            if (nlIndex !== -1) {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(connectTimeout);
+                    clearTimeout(responseTimeout);
+                    try {
+                        resolve(JSON.parse(data.slice(0, nlIndex)));
+                    }
+                    catch (err) {
+                        reject(new Error(`Invalid JSON from PTY server: ${data.slice(0, 200)}`));
+                    }
+                }
+                conn.end();
+            }
+        });
+        conn.on('error', (err) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(connectTimeout);
+                clearTimeout(responseTimeout);
+                reject(new Error(`PTY server connection error: ${err.message}`));
+            }
+        });
+        conn.on('end', () => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(connectTimeout);
+                clearTimeout(responseTimeout);
+                if (data.trim()) {
+                    try {
+                        resolve(JSON.parse(data.trim()));
+                    }
+                    catch {
+                        reject(new Error('PTY server closed connection with invalid response'));
+                    }
+                }
+                else {
+                    reject(new Error('PTY server closed connection without response'));
+                }
+            }
+        });
+    });
+}
+/**
+ * Parse escape sequences in user input strings.
+ * Handles: \n \r \t \e \xHH \\
+ */
+export function unescapeInput(input) {
+    return input.replace(/\\(n|r|t|e|\\|x[0-9a-fA-F]{2})/g, (match, seq) => {
+        switch (seq) {
+            case 'n': return '\n';
+            case 'r': return '\r';
+            case 't': return '\t';
+            case 'e': return '\x1b';
+            case '\\': return '\\';
+            default:
+                // \xHH
+                if (seq.startsWith('x')) {
+                    return String.fromCharCode(parseInt(seq.slice(1), 16));
+                }
+                return match;
+        }
+    });
+}
+//# sourceMappingURL=pty-client.js.map

package/dist/lib/pty-client.js.map

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

package/dist/lib/pty-server.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PTY Sidecar Server
+ *
+ * Lightweight unix socket server that manages persistent PTY sessions.
+ * Started as a detached process by `agents pty` commands. Sessions survive
+ * across multiple CLI invocations. Each session holds a real PTY (via node-pty)
+ * and a headless terminal emulator (via @xterm/headless) for screen rendering.
+ *
+ * Protocol: newline-delimited JSON over ~/.agents/pty.sock
+ */
+export declare function getSocketPath(): string;
+export declare function getPtyPidPath(): string;
+export declare function getPtyLogPath(): string;
+export declare function isPtyServerRunning(): boolean;
+export declare function runPtyServer(): Promise<void>;
+//# sourceMappingURL=pty-server.d.ts.map

package/dist/lib/pty-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-server.d.ts","sourceRoot":"","sources":["../../src/lib/pty-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwCH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAY5C;AAcD,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAqYlD"}