@oratis/lisa 0.8.0 → 0.11.0

package/dist/agents/managed.js

@@ -0,0 +1,241 @@
+/**
+ * Managed agents — the controllable unit of the agent control plane.
+ *
+ * Unlike an externally-started CLI (observe + cancel only — different identity
+ * space, no control channel), a managed agent is one LISA runs itself by looping
+ * `runAgent`: it has a stable id, streams live progress, takes follow-up
+ * commands, pauses on every mutating tool for the user's approve/deny, and
+ * cancels cleanly. This is how the user "sends commands to a running agent."
+ *
+ * Tool policy (per product decision): FULL tools, but every mutating call
+ * (DEFAULT_MUTATING_TOOLS / DEFAULT_MUTATING_ACTIONS) blocks on a UI decision —
+ * so an unattended managed agent can't write/exec without explicit approval.
+ */
+import { EventEmitter } from "node:events";
+import { runAgent } from "../agent.js";
+import { DEFAULT_MODEL } from "../llm.js";
+import { providerForModel } from "../providers/registry.js";
+import { isMutatingCall, DEFAULT_MUTATING_TOOLS, DEFAULT_MUTATING_ACTIONS, } from "../approval.js";
+const MAX_TOOLS = 6;
+const MAX_FILES = 10;
+const APPROVAL_CFG = {
+    mode: "ask-mutating",
+    mutatingTools: DEFAULT_MUTATING_TOOLS,
+    mutatingActions: DEFAULT_MUTATING_ACTIONS,
+};
+let counter = 0;
+export class ManagedAgent {
+    id;
+    cwd;
+    project;
+    model;
+    state = "working";
+    stateReason = "starting";
+    lastMtime;
+    turnCount = 0;
+    tokensIn = 0;
+    tokensOut = 0;
+    lastTools = [];
+    filesTouched = [];
+    lastText = "";
+    pending;
+    /** Set by the registry to broadcast snapshots. */
+    onChange = () => { };
+    history = [];
+    tools;
+    systemPrompt;
+    provider;
+    ac = new AbortController();
+    now;
+    queue = [];
+    wake;
+    constructor(opts) {
+        this.id = "m" + (++counter).toString(36) + "-" + this.now0().toString(36).slice(-4);
+        this.cwd = opts.cwd;
+        this.project = opts.cwd.split("/").filter(Boolean).pop() || opts.cwd;
+        this.model = opts.model ?? DEFAULT_MODEL;
+        this.provider = opts.provider ?? providerForModel(this.model);
+        this.tools = opts.tools;
+        this.systemPrompt = opts.systemPrompt;
+        this.now = opts.now ?? Date.now;
+        this.lastMtime = this.now();
+        this.queue.push(opts.task);
+        void this.runLoop();
+    }
+    // Date.now indirection only for the id seed (constructor runs before this.now set).
+    now0() {
+        return Date.now();
+    }
+    /** Queue a follow-up command; wakes the loop if it's idle. */
+    send(text) {
+        if (this.ac.signal.aborted)
+            return;
+        this.queue.push(text);
+        this.wake?.();
+    }
+    /** Resolve a pending approve/deny. Returns false if nothing is pending. */
+    decide(allow) {
+        if (!this.pending)
+            return false;
+        const p = this.pending;
+        this.setState("working", "running");
+        p.resolve(allow);
+        return true;
+    }
+    /** Abort the run; unblocks any pending tool/input. */
+    cancel() {
+        if (this.ac.signal.aborted)
+            return;
+        this.ac.abort();
+        this.pending?.resolve(false);
+        this.wake?.();
+        this.setState("done", "cancelled");
+    }
+    view() {
+        return {
+            id: this.id,
+            project: this.project,
+            cwd: this.cwd,
+            model: this.model,
+            state: this.state,
+            stateReason: this.stateReason,
+            lastMtime: this.lastMtime,
+            turnCount: this.turnCount,
+            tokens: { input: this.tokensIn, output: this.tokensOut },
+            lastTools: [...this.lastTools],
+            filesTouched: [...this.filesTouched],
+            lastText: this.lastText,
+            ...(this.pending ? { pending: { tool: this.pending.tool } } : {}),
+        };
+    }
+    // ── internals ──
+    async runLoop() {
+        while (!this.ac.signal.aborted) {
+            const message = await this.nextInput();
+            if (message === null)
+                break;
+            this.setState("working", "running");
+            try {
+                const result = await runAgent({
+                    provider: this.provider,
+                    systemPrompt: this.systemPrompt,
+                    tools: this.tools,
+                    toolCtx: { cwd: this.cwd, signal: this.ac.signal, log: () => { } },
+                    history: this.history,
+                    userMessage: message,
+                    model: this.model,
+                    maxIterations: 64,
+                    onEvent: (e) => this.onAgentEvent(e),
+                    approval: (tool, input) => this.approve(tool, input),
+                });
+                this.history = result.history;
+                this.tokensIn += result.inputTokens;
+                this.tokensOut += result.outputTokens;
+                if (result.finalText)
+                    this.lastText = result.finalText;
+                this.setState("waiting", result.stopReason);
+            }
+            catch (err) {
+                if (this.ac.signal.aborted)
+                    break;
+                this.setState("error", err.message.slice(0, 80));
+            }
+        }
+        if (this.state !== "done")
+            this.setState("done", "done");
+    }
+    /** Resolve with the next queued command, or null when cancelled. */
+    nextInput() {
+        if (this.ac.signal.aborted)
+            return Promise.resolve(null);
+        if (this.queue.length)
+            return Promise.resolve(this.queue.shift());
+        return new Promise((resolve) => {
+            this.wake = () => {
+                this.wake = undefined;
+                resolve(this.ac.signal.aborted ? null : this.queue.shift() ?? null);
+            };
+        });
+    }
+    /** Approval callback: auto-allow safe tools; block mutating ones on a UI decision. */
+    approve(tool, input) {
+        if (!isMutatingCall(APPROVAL_CFG, tool, input))
+            return Promise.resolve({ allow: true });
+        return new Promise((resolve) => {
+            this.pending = {
+                tool,
+                resolve: (allow) => {
+                    this.pending = undefined;
+                    resolve(allow ? { allow: true } : { allow: false, reason: "denied in Lisa" });
+                },
+            };
+            this.setState("waiting", "permission");
+        });
+    }
+    onAgentEvent(e) {
+        if (e.type === "turn_start")
+            this.turnCount++;
+        if (e.type === "tool_call_start") {
+            if (e.toolName) {
+                this.lastTools.push(e.toolName);
+                if (this.lastTools.length > MAX_TOOLS)
+                    this.lastTools.shift();
+            }
+            const input = e.toolInput;
+            const p = input && (input.file_path ?? input.path ?? input.filename);
+            if (typeof p === "string" && p) {
+                this.filesTouched.push(p);
+                if (this.filesTouched.length > MAX_FILES)
+                    this.filesTouched.shift();
+            }
+        }
+        if (e.type === "text_delta" && e.text)
+            this.lastText = (this.lastText + e.text).slice(-2000);
+        this.touch();
+    }
+    setState(s, reason) {
+        this.state = s;
+        this.stateReason = reason;
+        this.touch();
+    }
+    touch() {
+        this.lastMtime = this.now();
+        this.onChange();
+    }
+}
+/** Process-wide registry of managed agents; emits "update" with a ManagedView. */
+export class ManagedRegistry extends EventEmitter {
+    agents = new Map();
+    start(opts) {
+        const a = new ManagedAgent(opts);
+        a.onChange = () => this.emit("update", a.view());
+        this.agents.set(a.id, a);
+        this.emit("update", a.view());
+        return a.view();
+    }
+    send(id, text) {
+        const a = this.agents.get(id);
+        if (!a)
+            return false;
+        a.send(text);
+        return true;
+    }
+    decide(id, allow) {
+        return this.agents.get(id)?.decide(allow) ?? false;
+    }
+    cancel(id) {
+        const a = this.agents.get(id);
+        if (!a)
+            return false;
+        a.cancel();
+        return true;
+    }
+    get(id) {
+        return this.agents.get(id);
+    }
+    list() {
+        return [...this.agents.values()].map((a) => a.view());
+    }
+}
+export const managedRegistry = new ManagedRegistry();
+//# sourceMappingURL=managed.js.map

package/dist/agents/managed.js.map

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

package/dist/agents/pty.d.ts

@@ -0,0 +1,155 @@
+/**
+ * PTY-backed agents — EXPERIMENTAL spike (Stage C), OFF BY DEFAULT.
+ *
+ * Phase-3 managed agents run LISA's OWN agent loop (its tools, its provider).
+ * A PTY agent instead spawns the REAL `claude` / `codex` CLI inside a
+ * pseudo-terminal, so you get that tool's full configuration — its skills, MCP
+ * servers, hooks, model — while LISA owns stdin/stdout: it types your task and
+ * follow-ups, can answer prompts, and reads the stream for a coarse live status.
+ *
+ * HONEST LIMITS (why this is a flagged spike, not a shipped feature):
+ *  - Native dep: needs `node-pty` (an *optional* dependency). If it isn't built,
+ *    PTY agents are simply unavailable — nothing else in LISA changes.
+ *  - Off by default: set `LISA_PTY_AGENTS=1` to enable.
+ *  - Controls only CLIs LISA SPAWNS — NOT sessions you already opened in your
+ *    own terminal (those have no control channel; they stay observe-only).
+ *  - Output parsing is best-effort: the CLI's TUI is ANSI / box-drawn and
+ *    version-sensitive, so "state" is inferred from output quiescence, not from
+ *    parsed intent. The captured tail is shown to you (your own terminal), never
+ *    folded into the structural cross-agent roster.
+ */
+import { EventEmitter } from "node:events";
+export type PtyState = "working" | "waiting" | "error" | "done";
+/** Public, serializable snapshot of a PTY agent (structural — no output text). */
+export interface PtyView {
+    id: string;
+    /** Normalized roster kind, e.g. "claude-code" | "codex". */
+    agent: string;
+    /** The spawned binary, e.g. "claude". */
+    cli: string;
+    project: string;
+    cwd: string;
+    state: PtyState;
+    stateReason: string;
+    lastMtime: number;
+    /** Bytes of terminal output seen so far — a rough liveness signal. */
+    bytesOut: number;
+    /** When this PTY is a resume-adopt, the real claude session id it continues
+     *  (so the roster can drop the observe-only duplicate of the same session). */
+    adoptedSessionId?: string;
+}
+export interface PtyStartOpts {
+    /** "claude" | "claude-code" | "codex" | … */
+    agent: string;
+    task: string;
+    cwd: string;
+    /**
+     * Adopt an EXISTING claude session by id — spawns `claude --resume <id>` so
+     * LISA drives a continuation of a session the user started elsewhere. The
+     * caller MUST ensure the session is idle (see liveClaudeSessionIds) — resuming
+     * a live one corrupts its transcript.
+     */
+    resumeSessionId?: string;
+    /** Override the binary (else resolved from `agent`). */
+    cli?: string;
+    /** Override argv (else interactive: []). */
+    args?: string[];
+    cols?: number;
+    rows?: number;
+    /** Clock override (tests). */
+    now?: () => number;
+    /** Injected pty module (tests) — avoids spawning a real process. */
+    ptyModule?: PtyModuleLike;
+}
+export interface IPtyLike {
+    onData(cb: (data: string) => void): void;
+    onExit(cb: (e: {
+        exitCode: number;
+        signal?: number;
+    }) => void): void;
+    write(data: string): void;
+    kill(signal?: string): void;
+}
+export interface PtyModuleLike {
+    spawn(file: string, args: string[], opts: {
+        name?: string;
+        cols?: number;
+        rows?: number;
+        cwd?: string;
+        env?: Record<string, string | undefined>;
+    }): IPtyLike;
+}
+/** Is the PTY-agent spike enabled? Off unless LISA_PTY_AGENTS=1. */
+export declare function ptyEnabled(): boolean;
+/** Map a roster agent-kind to its CLI binary (env-overridable). */
+export declare function resolveCli(agent: string): string;
+/** Normalize a loose agent label to a roster AgentKind. */
+export declare function normalizeAgentKind(agent: string): string;
+/**
+ * Best binary to drive a claude session: env override → the newest app-bundled
+ * claude (matches the version that wrote the sessions, best for --resume) → the
+ * PATH `claude`. The app-bundle probe is macOS-specific and silently no-ops
+ * elsewhere. Falls back to resolveCli for non-claude agents.
+ */
+export declare function detectClaudeBinary(): string;
+/** Strip ANSI escape sequences + common bare control bytes (CR/backspace). Pure. */
+export declare function stripAnsi(s: string): string;
+/**
+ * Coarse live state from output quiescence: actively streaming ⇒ "working";
+ * quiet longer than idleMs ⇒ "waiting" (likely awaiting input or a prompt).
+ * `done`/`error` are decided by lifecycle flags, not here. Pure.
+ */
+export declare function derivePtyState(lastChunkAtMs: number, nowMs: number, idleMs: number): PtyState;
+/** One real CLI running under a pseudo-terminal that LISA drives. */
+export declare class PtyAgent {
+    readonly id: string;
+    readonly agent: string;
+    readonly cli: string;
+    readonly cwd: string;
+    readonly project: string;
+    /** Real claude session id, when this agent is a resume-adopt (claude only). */
+    readonly adoptedSessionId?: string;
+    onChange: () => void;
+    /** Called with each ANSI-stripped output chunk — drives the live attach stream
+     *  (GET /api/agents/pty/<id>/stream). Distinct from onChange (state snapshots). */
+    onOutput: (chunk: string) => void;
+    private readonly proc;
+    private readonly now;
+    private ring;
+    private bytesOut;
+    private aborted;
+    private exited;
+    private exitReason;
+    private lastChunkAt;
+    private lastMtime;
+    private constructor();
+    /** Spawn a real CLI under a PTY and type the initial task. */
+    static start(opts: PtyStartOpts): Promise<PtyAgent>;
+    /** Type a line into the CLI (initial task or a follow-up). */
+    send(text: string): void;
+    /** Kill the CLI. Idempotent. */
+    cancel(): void;
+    /**
+     * ANSI-stripped tail of the terminal — the user's window into THEIR agent.
+     * Exposed only via an explicit endpoint, never folded into the structural
+     * cross-agent roster (which stays metadata-only).
+     */
+    output(): string;
+    view(): PtyView;
+    private onData;
+    private onExit;
+    private touch;
+}
+/** Process-wide registry of PTY agents; emits "update" with a PtyView. */
+export declare class PtyRegistry extends EventEmitter {
+    private agents;
+    start(opts: PtyStartOpts): Promise<PtyView>;
+    send(id: string, text: string): boolean;
+    cancel(id: string): boolean;
+    /** ANSI-stripped tail of a PTY agent's terminal, or null if unknown. */
+    output(id: string): string | null;
+    get(id: string): PtyAgent | undefined;
+    list(): PtyView[];
+}
+export declare const ptyRegistry: PtyRegistry;
+//# sourceMappingURL=pty.d.ts.map

package/dist/agents/pty.d.ts.map

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