psyclaw 0.25.2 → 0.26.1

package/dist/src/adapters/pi/rpc.js

@@ -0,0 +1,253 @@
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+const SAFE_TOOL_NAMES = new Set(["read", "grep", "find", "ls"]);
+const SAFE_ENV_NAMES = new Set([
+    "PATH", "Path", "SystemRoot", "WINDIR", "ComSpec", "TEMP", "TMP",
+    "HOME", "USERPROFILE", "APPDATA", "LOCALAPPDATA", "LANG", "LC_ALL",
+]);
+function assertAbsolute(value, label) {
+    if (!/^([A-Za-z]:[\\/]|[\\/]{1,2})/.test(value))
+        throw new Error(`${label} must be an absolute path`);
+}
+function assertSafeName(value, label) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/.test(value))
+        throw new Error(`${label} is invalid`);
+}
+function jsonLine(value) {
+    return `${JSON.stringify(value)}\n`;
+}
+/**
+ * Minimal, strict JSONL client for Pi RPC. It intentionally builds a narrow
+ * child environment and read-only tool allowlist for research workers.
+ */
+export class PiRpcClient {
+    config;
+    process;
+    buffer = "";
+    sequence = 0;
+    pending = new Map();
+    listeners = new Set();
+    options;
+    stderr = "";
+    constructor(config) {
+        this.config = config;
+        assertAbsolute(config.cwd, "cwd");
+        if (config.agentDir !== undefined)
+            assertAbsolute(config.agentDir, "agentDir");
+        if (config.provider !== undefined)
+            assertSafeName(config.provider, "provider");
+        if (config.model !== undefined && (!/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,255}$/.test(config.model) || config.model.includes(".."))) {
+            throw new Error("model is invalid");
+        }
+        const tools = config.tools ?? [...SAFE_TOOL_NAMES];
+        if (tools.some((tool) => !SAFE_TOOL_NAMES.has(tool))) {
+            throw new Error("Pi RPC workers may only use read-only tools");
+        }
+        if (config.systemPrompt !== undefined && (!config.systemPrompt.trim() || config.systemPrompt.length > 16_000)) {
+            throw new Error("system prompt must be non-empty and at most 16000 characters");
+        }
+        this.options = {
+            timeoutMs: config.timeoutMs ?? 120_000,
+            maxLineBytes: config.maxLineBytes ?? 2 * 1024 * 1024,
+        };
+    }
+    getStderr() {
+        return this.stderr;
+    }
+    onEvent(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    async start() {
+        if (this.process !== undefined)
+            throw new Error("Pi RPC client already started");
+        const args = ["--mode", "rpc"];
+        if (this.config.provider !== undefined)
+            args.push("--provider", this.config.provider);
+        if (this.config.model !== undefined)
+            args.push("--model", this.config.model);
+        if (this.config.systemPrompt !== undefined)
+            args.push("--append-system-prompt", this.config.systemPrompt);
+        args.push("--no-session", "--no-extensions", "--no-skills", "--no-context-files", "--tools", (this.config.tools ?? [...SAFE_TOOL_NAMES]).join(","));
+        const defaultCommand = process.platform === "win32" ? "pi.cmd" : "pi";
+        const rawCommand = this.config.cliPath === undefined ? (this.config.command ?? defaultCommand) : process.execPath;
+        const rawArgs = this.config.cliPath === undefined ? args : [this.config.cliPath, ...args];
+        const command = process.platform === "win32" ? (process.env.ComSpec ?? "cmd.exe") : rawCommand;
+        const commandArgs = process.platform === "win32" ? ["/d", "/c", rawCommand, ...rawArgs] : rawArgs;
+        const childEnv = this.buildEnvironment();
+        const child = spawn(command, commandArgs, {
+            cwd: this.config.cwd,
+            env: childEnv,
+            shell: false,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.process = child;
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => this.acceptChunk(chunk));
+        child.stderr.on("data", (chunk) => {
+            this.stderr = `${this.stderr}${chunk}`.slice(-16_384);
+        });
+        child.on("error", (error) => this.failPending(new Error(`Pi RPC process error: ${error.message}`)));
+        child.on("exit", (code, signal) => {
+            if (this.process !== child)
+                return;
+            this.process = undefined;
+            this.failPending(new Error(`Pi RPC process exited (${code ?? "?"}/${signal ?? "none"})`));
+        });
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error("Pi RPC process did not start")), 5_000);
+            child.once("spawn", () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            child.once("error", (error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+    async stop() {
+        const child = this.process;
+        if (!child)
+            return;
+        this.process = undefined;
+        this.failPending(new Error("Pi RPC client stopped"));
+        child.kill("SIGTERM");
+        await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                if (!child.killed)
+                    child.kill("SIGKILL");
+                resolve();
+            }, 1_000);
+            child.once("exit", () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    }
+    async send(command, timeoutMs = this.options.timeoutMs) {
+        const child = this.process;
+        if (!child?.stdin.writable)
+            throw new Error("Pi RPC client is not running");
+        const id = `psyclaw-${++this.sequence}`;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error("Pi RPC request timed out"));
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            child.stdin.write(jsonLine({ ...command, id }));
+        });
+    }
+    async promptAndWait(message, timeoutMs = this.options.timeoutMs) {
+        const events = [];
+        let settled = false;
+        let resolveWait;
+        let timer;
+        const unsubscribe = this.onEvent((event) => {
+            events.push(event);
+            if (!settled && (event.type === "agent_end" || event.type === "agent_settled")) {
+                settled = true;
+                if (timer !== undefined)
+                    clearTimeout(timer);
+                resolveWait?.();
+            }
+        });
+        try {
+            const wait = new Promise((resolve, reject) => {
+                resolveWait = resolve;
+                timer = setTimeout(() => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    reject(new Error("Pi RPC prompt timed out"));
+                }, timeoutMs);
+            });
+            await this.send({ type: "prompt", message }, timeoutMs);
+            await wait;
+            return events;
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            resolveWait = undefined;
+            unsubscribe();
+        }
+    }
+    buildEnvironment() {
+        const env = {};
+        for (const key of SAFE_ENV_NAMES) {
+            const value = process.env[key];
+            if (value !== undefined)
+                env[key] = value;
+        }
+        for (const [key, value] of Object.entries(this.config.env ?? {})) {
+            if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
+                throw new Error(`Invalid child environment name: ${key}`);
+            env[key] = value;
+        }
+        if (this.config.agentDir !== undefined) {
+            env.PI_CODING_AGENT_DIR = this.config.agentDir;
+            env.PI_CODING_AGENT_SESSION_DIR = join(this.config.agentDir, "sessions");
+        }
+        return env;
+    }
+    acceptChunk(chunk) {
+        this.buffer += chunk;
+        if (Buffer.byteLength(this.buffer, "utf8") > this.options.maxLineBytes * 2) {
+            this.failPending(new Error("Pi RPC output buffer exceeded limit"));
+            void this.stop();
+            return;
+        }
+        while (true) {
+            const newline = this.buffer.indexOf("\n");
+            if (newline < 0)
+                return;
+            const line = this.buffer.slice(0, newline).replace(/\r$/, "");
+            this.buffer = this.buffer.slice(newline + 1);
+            if (Buffer.byteLength(line, "utf8") > this.options.maxLineBytes) {
+                this.failPending(new Error("Pi RPC record exceeded limit"));
+                void this.stop();
+                return;
+            }
+            if (!line.trim())
+                continue;
+            let event;
+            try {
+                const parsed = JSON.parse(line);
+                if (!parsed || typeof parsed !== "object" || typeof parsed.type !== "string") {
+                    throw new Error("invalid event shape");
+                }
+                event = parsed;
+            }
+            catch {
+                this.failPending(new Error("Pi RPC emitted invalid JSONL"));
+                void this.stop();
+                return;
+            }
+            if (event.type === "response" && typeof event.id === "string") {
+                const pending = this.pending.get(event.id);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    this.pending.delete(event.id);
+                    if (event.success === false)
+                        pending.reject(new Error("Pi RPC command rejected"));
+                    else
+                        pending.resolve(event);
+                    continue;
+                }
+            }
+            for (const listener of this.listeners)
+                listener(event);
+        }
+    }
+    failPending(error) {
+        for (const [id, pending] of this.pending) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+            this.pending.delete(id);
+        }
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/src/adapters/pi/rpc.js.map

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

package/dist/src/adapters/pi/session.d.ts

@@ -0,0 +1,30 @@
+import { ModelRuntime, type AgentSession, type AgentSessionEvent, type AgentSessionEventListener, type ResourceLoader } from "@earendil-works/pi-coding-agent";
+import type { ModelRef } from "./model.js";
+export interface PiSessionOptions {
+    cwd: string;
+    agentDir?: string;
+    sessionPath?: string;
+    persistent?: boolean;
+    modelRuntime?: ModelRuntime;
+    model?: ModelRef;
+    tools?: readonly string[];
+    noExtensions?: boolean;
+    noSkills?: boolean;
+    noContextFiles?: boolean;
+    resourceLoader?: ResourceLoader;
+}
+export interface PiSessionHandle {
+    readonly session: AgentSession;
+    readonly resources: ResourceLoader;
+    readonly modelRuntime: ModelRuntime;
+    readonly cwd: string;
+    prompt(text: string): Promise<void>;
+    subscribe(listener: AgentSessionEventListener): () => void;
+    dispose(): void;
+}
+/**
+ * Thin Pi SDK adapter. Business code receives this stable port instead of
+ * importing AgentSession internals throughout the research implementation.
+ */
+export declare function openPiSession(options: PiSessionOptions): Promise<PiSessionHandle>;
+export type PiSessionEvent = AgentSessionEvent;

package/dist/src/adapters/pi/session.js

@@ -0,0 +1,64 @@
+import { createAgentSession, getAgentDir, ModelRuntime, SessionManager, SettingsManager, } from "@earendil-works/pi-coding-agent";
+import { join } from "node:path";
+import { PiModelGateway } from "./model.js";
+import { createPiResourceLoader } from "./resources.js";
+function assertAbsolute(value, label) {
+    if (!/^([A-Za-z]:[\\/]|[\\/]{1,2})/.test(value))
+        throw new Error(`${label} must be an absolute path`);
+}
+/**
+ * Thin Pi SDK adapter. Business code receives this stable port instead of
+ * importing AgentSession internals throughout the research implementation.
+ */
+export async function openPiSession(options) {
+    assertAbsolute(options.cwd, "cwd");
+    const agentDir = options.agentDir ?? getAgentDir();
+    assertAbsolute(agentDir, "agentDir");
+    if (options.sessionPath !== undefined)
+        assertAbsolute(options.sessionPath, "sessionPath");
+    const modelRuntime = options.modelRuntime ?? await ModelRuntime.create({
+        authPath: join(agentDir, "auth.json"),
+        modelsPath: join(agentDir, "models.json"),
+        allowModelNetwork: false,
+        refreshOnCreate: false,
+    });
+    const resources = options.resourceLoader ?? await createPiResourceLoader({
+        cwd: options.cwd,
+        agentDir,
+        ...(options.noExtensions === undefined ? {} : { noExtensions: options.noExtensions }),
+        ...(options.noSkills === undefined ? {} : { noSkills: options.noSkills }),
+        ...(options.noContextFiles === undefined ? {} : { noContextFiles: options.noContextFiles }),
+    });
+    const settingsManager = SettingsManager.inMemory({
+        compaction: { enabled: true },
+        retry: { enabled: true, maxRetries: 1 },
+    });
+    const sessionManager = options.sessionPath !== undefined
+        ? SessionManager.open(options.sessionPath)
+        : options.persistent
+            ? SessionManager.create(options.cwd)
+            : SessionManager.inMemory();
+    const model = options.model === undefined
+        ? undefined
+        : new PiModelGateway(modelRuntime).resolve(options.model);
+    const result = await createAgentSession({
+        cwd: options.cwd,
+        agentDir,
+        modelRuntime,
+        ...(model === undefined ? {} : { model }),
+        tools: [...(options.tools ?? ["read", "grep", "find", "ls"])],
+        resourceLoader: resources,
+        sessionManager,
+        settingsManager,
+    });
+    return {
+        session: result.session,
+        resources,
+        modelRuntime,
+        cwd: options.cwd,
+        prompt: (text) => result.session.prompt(text),
+        subscribe: (listener) => result.session.subscribe(listener),
+        dispose: () => result.session.dispose(),
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/src/adapters/pi/session.js.map

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

package/dist/src/agents/catalog.d.ts

@@ -0,0 +1,30 @@
+export type InstallMethod = "npm" | "brew" | "pipx" | "curl-script" | "native";
+export interface AgentInstallSpec {
+    method: InstallMethod;
+    /** Command run by the installer after explicit approval. */
+    installCommand: string;
+    /** Canonical source reference recorded in the install receipt. */
+    sourceRef: string;
+    /**
+     * Pinned version/ref. The literal `unpinned` is never treated as a verified
+     * install; pin a real version/tag before any release claim.
+     */
+    ref: string;
+}
+export interface KnownAgent {
+    id: string;
+    name: string;
+    /** Config directories relative to the home directory, first match wins. */
+    configDirs: readonly string[];
+    /** Skill/command directories relative to the home directory. */
+    skillDirs: readonly string[];
+    /** Credential files whose existence is noted but whose content is never read. */
+    credentialFiles: readonly string[];
+    install?: AgentInstallSpec;
+}
+/**
+ * A curated, editable catalog of agents psyclaw can recognize. Discovery is
+ * strictly read-only and never executes these install commands; the installer
+ * is a separate, approval-gated step.
+ */
+export declare const KNOWN_AGENTS: readonly KnownAgent[];

package/dist/src/agents/catalog.js

@@ -0,0 +1,118 @@
+/**
+ * A curated, editable catalog of agents psyclaw can recognize. Discovery is
+ * strictly read-only and never executes these install commands; the installer
+ * is a separate, approval-gated step.
+ */
+export const KNOWN_AGENTS = [
+    {
+        id: "claude-code",
+        name: "Claude Code",
+        configDirs: [".claude", ".config/claude"],
+        skillDirs: [".claude/skills", ".claude/commands", ".config/claude/skills"],
+        credentialFiles: [".claude/.credentials.json", ".claude/settings.json"],
+        install: {
+            method: "npm",
+            installCommand: "npm install -g @anthropic-ai/claude-code@2.1.232",
+            sourceRef: "https://github.com/anthropics/claude-code",
+            ref: "2.1.232",
+        },
+    },
+    {
+        id: "openai-codex",
+        name: "OpenAI Codex",
+        configDirs: [".codex", ".config/codex"],
+        skillDirs: [".codex/skills", ".config/codex/skills"],
+        credentialFiles: [".codex/auth.json", ".codex/config.toml"],
+        install: {
+            method: "npm",
+            installCommand: "npm install -g @openai/codex@0.147.0",
+            sourceRef: "https://github.com/openai/codex",
+            ref: "0.147.0",
+        },
+    },
+    {
+        id: "gemini-cli",
+        name: "Gemini CLI",
+        configDirs: [".gemini", ".config/gemini"],
+        skillDirs: [".gemini/skills", ".config/gemini/skills"],
+        credentialFiles: [".gemini/settings.json", ".config/gemini/settings.json"],
+        install: {
+            method: "npm",
+            installCommand: "npm install -g @google/gemini-cli@0.55.1",
+            sourceRef: "https://github.com/google-gemini/gemini-cli",
+            ref: "0.55.1",
+        },
+    },
+    {
+        id: "opencode",
+        name: "opencode",
+        configDirs: [".config/opencode", ".opencode"],
+        skillDirs: [".config/opencode/skills", ".opencode/skills"],
+        credentialFiles: [".config/opencode/auth.json"],
+        install: {
+            method: "npm",
+            installCommand: "npm install -g opencode-ai@1.18.18",
+            sourceRef: "https://github.com/sst/opencode",
+            ref: "1.18.18",
+        },
+    },
+    {
+        id: "aider",
+        name: "Aider",
+        configDirs: [".aider"],
+        skillDirs: [],
+        credentialFiles: [".aider.conf.yml"],
+        install: {
+            method: "pipx",
+            installCommand: "pipx install aider-chat==0.16.0",
+            sourceRef: "https://github.com/Aider-AI/aider",
+            ref: "0.16.0",
+        },
+    },
+    {
+        id: "cursor",
+        name: "Cursor",
+        configDirs: [".cursor"],
+        skillDirs: [".cursor/skills"],
+        credentialFiles: [".cursor/auth.json"],
+        install: { method: "native", installCommand: "", sourceRef: "https://cursor.com", ref: "manual" },
+    },
+    {
+        id: "windsurf",
+        name: "Windsurf",
+        configDirs: [".windsurf", ".config/windsurf"],
+        skillDirs: [".windsurf/skills"],
+        credentialFiles: [],
+        install: { method: "native", installCommand: "", sourceRef: "https://windsurf.com", ref: "manual" },
+    },
+    {
+        id: "continue",
+        name: "Continue",
+        configDirs: [".continue"],
+        skillDirs: [".continue/skills"],
+        credentialFiles: [".continue/config.json"],
+        install: { method: "native", installCommand: "", sourceRef: "https://continue.dev", ref: "manual" },
+    },
+    {
+        id: "orca",
+        name: "Orca",
+        configDirs: [".orca", "orca"],
+        skillDirs: [".orca/skills", "orca/workspaces"],
+        credentialFiles: [".orca/config.json"],
+        install: { method: "native", installCommand: "", sourceRef: "https://github.com/evanw/orca", ref: "manual" },
+    },
+    {
+        id: "copilot-cli",
+        name: "GitHub Copilot CLI",
+        configDirs: [".config/github-copilot"],
+        skillDirs: [".config/github-copilot/skills"],
+        credentialFiles: [".config/github-copilot/hosts.json"],
+        install: {
+            method: "npm",
+            installCommand: "npm install -g @github/copilot@1.0.80",
+            sourceRef: "https://github.com/github/copilot-cli",
+            ref: "1.0.80",
+        },
+    },
+];
+//# sourceMappingURL=catalog.js.map

package/dist/src/agents/catalog.js.map

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

package/dist/src/agents/discover.d.ts

@@ -0,0 +1,28 @@
+import { type AgentInstallSpec, type KnownAgent } from "./catalog.js";
+export interface DiscoveredSkill {
+    name: string;
+    path: string;
+    kind: "dir" | "file";
+}
+export interface AgentScan {
+    id: string;
+    name: string;
+    found: boolean;
+    /** Absolute path of the first matching config directory. */
+    configPath?: string;
+    skills: DiscoveredSkill[];
+    skillDirs: string[];
+    hasCredentials: boolean;
+    credentialPaths: string[];
+    install?: AgentInstallSpec;
+}
+export interface DiscoverOptions {
+    homeDir?: string;
+    agents?: readonly KnownAgent[];
+}
+/**
+ * Read-only scan of local agent configurations. This never reads credential
+ * contents, never follows symlinks, and never executes an install command; it
+ * only records what exists on disk for display and import planning.
+ */
+export declare function discoverAgents(options?: DiscoverOptions): Promise<AgentScan[]>;