@oratis/lisa 0.9.0 → 0.11.0

package/dist/integrations/shell/observer.js

@@ -0,0 +1,223 @@
+/**
+ * Shell observer (Sense S1c — what the user runs at the terminal).
+ *
+ * Tails the shell history file(s) and surfaces ONLY which programs were run
+ * (argv[0] — "git", "npm", "docker", "ssh") plus counts/recency. This widens
+ * Sense to the user's command-line rhythm without an agent involved.
+ *
+ * PRIVACY (the whole point of this adapter): it extracts the PROGRAM NAME ONLY.
+ * Never a full command line, never arguments, never paths, never the contents
+ * of `git commit -m "..."`. A planted-secret test asserts this. Off by default
+ * — shell history is sensitive; opt in via ~/.lisa/agents.json.
+ *
+ * Mapping to a session (a shell isn't an "agent"): one session per history
+ * file, project = the shell name ("zsh"/"bash"), state = "working" while there
+ * was recent activity (older ones drop out of the active window). cwd is
+ * unavailable (history records no directory), so it's omitted.
+ */
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import { EventEmitter } from "node:events";
+import { registerIntegration } from "../registry.js";
+const ACTIVE_WINDOW_MS = 30 * 60_000; // 30m
+const DEBOUNCE_MS = 500;
+const TAIL_BYTES = 16 * 1024;
+const ACTIVITY_MAX = 40; // how many recent commands to consider
+const LAST_TOOLS_MAX = 8;
+/**
+ * Extract argv[0] (the program name) from one history command line. Pure.
+ * Strips leading `VAR=val` assignments, takes the first token, basenames it,
+ * and returns null for anything that isn't a plain command name (flags, shell
+ * syntax). Deliberately surfaces ONLY the program name — nothing after it.
+ */
+export function extractArgv0(command) {
+    let s = command.trim();
+    if (!s || s.startsWith("#"))
+        return null;
+    // Drop leading environment assignments: FOO=bar BAZ="x" cmd ...
+    s = s.replace(/^(?:[A-Za-z_][A-Za-z0-9_]*=(?:"[^"]*"|'[^']*'|\S+)\s+)+/, "");
+    // Drop a leading subshell/grouping paren so "(cd x && y)" doesn't leak "(cd".
+    s = s.replace(/^[({]\s*/, "");
+    const tok = s.split(/\s+/)[0];
+    if (!tok)
+        return null;
+    const base = (tok.split("/").pop() || tok).trim();
+    // Only a plausible program name — excludes flags, redirects, var expansions.
+    if (!base || !/^[A-Za-z0-9._@+-]+$/.test(base) || base.startsWith("-"))
+        return null;
+    return base;
+}
+/**
+ * Parse a shell-history tail into a list of argv[0]s (program names only).
+ * Handles zsh EXTENDED_HISTORY (": <ts>:<elapsed>;<cmd>") and bash
+ * HISTTIMEFORMAT ("#<epoch>" lines) as well as plain command-per-line. Pure.
+ */
+export function parseHistoryArgv0s(raw) {
+    const out = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (/^#\d+$/.test(trimmed))
+            continue; // bash timestamp comment line
+        const zsh = line.match(/^: \d+:\d+;(.*)$/); // zsh extended-history prefix
+        const cmd = zsh ? zsh[1] : line;
+        const a = extractArgv0(cmd);
+        if (a)
+            out.push(a);
+    }
+    return out;
+}
+function dedupeKeepRecent(items, max) {
+    const seen = new Set();
+    const out = [];
+    for (let i = items.length - 1; i >= 0; i--) {
+        if (!seen.has(items[i])) {
+            seen.add(items[i]);
+            out.unshift(items[i]);
+        }
+    }
+    return out.slice(-max);
+}
+/** Tier-2 structural activity from recent argv[0]s. Program names + counts only. Pure. */
+export function shellActivity(argv0s) {
+    const recent = argv0s.slice(-ACTIVITY_MAX);
+    return {
+        turnCount: argv0s.length,
+        lastTools: dedupeKeepRecent(recent, LAST_TOOLS_MAX),
+        filesTouched: [], // shell history carries no file info we'd surface
+        lastCommandName: recent[recent.length - 1],
+    };
+}
+function deriveShellState(lastMtime, now) {
+    return now - lastMtime < ACTIVE_WINDOW_MS
+        ? { state: "working", reason: "recent commands" }
+        : { state: "idle", reason: "quiet" };
+}
+async function readTail(file) {
+    const st = await fsp.stat(file);
+    if (st.size === 0)
+        return "";
+    const fd = await fsp.open(file, "r");
+    try {
+        const len = Math.min(TAIL_BYTES, st.size);
+        const buf = Buffer.alloc(len);
+        await fd.read(buf, 0, len, st.size - len);
+        // latin1 avoids throwing on the non-UTF8 bytes zsh can write; we only ever
+        // keep ASCII program names out of it anyway.
+        return buf.toString("latin1");
+    }
+    finally {
+        await fd.close();
+    }
+}
+/** Default history files to watch when none are configured. */
+function defaultHistoryFiles() {
+    const home = os.homedir();
+    return [path.join(home, ".zsh_history"), path.join(home, ".bash_history")];
+}
+export class ShellObserver extends EventEmitter {
+    agent = "shell";
+    files;
+    sessions = new Map();
+    watchers = [];
+    pending = new Map();
+    emitFn = null;
+    computeActivity;
+    constructor(cfg) {
+        super();
+        const raw = Array.isArray(cfg.files) ? cfg.files : null;
+        this.files = (raw ?? defaultHistoryFiles())
+            .filter((f) => typeof f === "string")
+            .map((f) => f.replace(/^~/, os.homedir()));
+        this.computeActivity = cfg.visibility === "activity" || cfg.visibility === "intent";
+    }
+    async start(emit) {
+        this.emitFn = emit;
+        for (const file of this.files) {
+            await this.record(file);
+            this.attach(file);
+        }
+    }
+    list() {
+        const cutoff = Date.now() - ACTIVE_WINDOW_MS;
+        return [...this.sessions.values()]
+            .filter((s) => s.lastMtime >= cutoff)
+            .sort((a, b) => b.lastMtime - a.lastMtime)
+            .map(toAgentSession);
+    }
+    async stop() {
+        for (const w of this.watchers)
+            w.close();
+        this.watchers = [];
+        for (const t of this.pending.values())
+            clearTimeout(t);
+        this.pending.clear();
+    }
+    attach(file) {
+        try {
+            const w = fs.watch(file, { persistent: false }, () => {
+                const prev = this.pending.get(file);
+                if (prev)
+                    clearTimeout(prev);
+                this.pending.set(file, setTimeout(() => {
+                    this.pending.delete(file);
+                    void this.record(file).then(() => {
+                        const info = this.sessions.get(file);
+                        if (info && this.emitFn)
+                            this.emitFn(toAgentSession(info));
+                    });
+                }, DEBOUNCE_MS));
+            });
+            w.on("error", () => w.close());
+            this.watchers.push(w);
+        }
+        catch {
+            // file unwatchable (e.g. doesn't exist) → no-op
+        }
+    }
+    async record(file) {
+        try {
+            const st = await fsp.stat(file);
+            if (!st.isFile())
+                return;
+            const tail = await readTail(file);
+            const argv0s = parseHistoryArgv0s(tail);
+            const { state, reason } = deriveShellState(st.mtimeMs, Date.now());
+            this.sessions.set(file, {
+                sessionId: file,
+                project: shellName(file),
+                lastMtime: st.mtimeMs,
+                state,
+                stateReason: reason,
+                activity: this.computeActivity ? shellActivity(argv0s) : undefined,
+            });
+        }
+        catch {
+            this.sessions.delete(file); // file vanished
+        }
+    }
+}
+function shellName(file) {
+    const base = path.basename(file); // .zsh_history / .bash_history
+    if (base.includes("zsh"))
+        return "zsh";
+    if (base.includes("bash"))
+        return "bash";
+    if (base.includes("fish"))
+        return "fish";
+    return "shell";
+}
+function toAgentSession(i) {
+    return {
+        agent: "shell",
+        sessionId: i.sessionId,
+        project: i.project,
+        state: i.state,
+        stateReason: i.stateReason,
+        lastMtime: i.lastMtime,
+        activity: i.activity,
+    };
+}
+registerIntegration("shell", (cfg) => new ShellObserver(cfg));
+//# sourceMappingURL=observer.js.map

package/dist/integrations/shell/observer.js.map

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

package/dist/integrations/takoapi/a2a.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A2A task-state helpers for the TakoAPI observer (Dispatch D2b). Pure — the
+ * unit under test. No I/O, no fs, so the mapping and parsing are verifiable
+ * without the (still-evolving) live gateway.
+ */
+import type { AgentSessionState } from "../types.js";
+/**
+ * Map an A2A TaskState onto LISA's normalized session state. The A2A spec's
+ * lifecycle states collapse onto our six:
+ *   submitted | working           → working
+ *   input-required | auth-required → waiting (the agent needs the user)
+ *   completed                     → done
+ *   failed | rejected             → error
+ *   canceled                      → done (reason: canceled)
+ *   anything else                 → unknown
+ * Case-insensitive; tolerates the British "cancelled" spelling.
+ */
+export declare function taskStateToSessionState(taskState: string): {
+    state: AgentSessionState;
+    reason: string;
+};
+/**
+ * Pull an A2A Task's state + id out of a /message response body, tolerating the
+ * shapes a gateway/agent might return: a bare Task, one nested under JSON-RPC
+ * `result`, or one under `task`; with the state at `status.state` (A2A) or a
+ * flat `state`. Returns null when the body carries no task object (e.g. a plain
+ * text reply or non-JSON) — the caller then treats a successful call as
+ * `completed`. Pure.
+ *
+ * SECURITY: the response comes from an untrusted remote agent (2nd-order prompt
+ * injection). We read ONLY the structural state/id strings here; the full reply
+ * never enters the ledger or the hub.
+ */
+export declare function extractTaskState(body: string): {
+    state: string;
+    taskId?: string;
+} | null;
+//# sourceMappingURL=a2a.d.ts.map

package/dist/integrations/takoapi/a2a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.d.ts","sourceRoot":"","sources":["../../../src/integrations/takoapi/a2a.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAmB9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0B3C"}

package/dist/integrations/takoapi/a2a.js

@@ -0,0 +1,70 @@
+/**
+ * Map an A2A TaskState onto LISA's normalized session state. The A2A spec's
+ * lifecycle states collapse onto our six:
+ *   submitted | working           → working
+ *   input-required | auth-required → waiting (the agent needs the user)
+ *   completed                     → done
+ *   failed | rejected             → error
+ *   canceled                      → done (reason: canceled)
+ *   anything else                 → unknown
+ * Case-insensitive; tolerates the British "cancelled" spelling.
+ */
+export function taskStateToSessionState(taskState) {
+    switch ((taskState || "").toLowerCase()) {
+        case "submitted":
+        case "working":
+            return { state: "working", reason: taskState };
+        case "input-required":
+        case "auth-required":
+            return { state: "waiting", reason: taskState };
+        case "completed":
+            return { state: "done", reason: "completed" };
+        case "failed":
+        case "rejected":
+            return { state: "error", reason: taskState };
+        case "canceled":
+        case "cancelled":
+            return { state: "done", reason: "canceled" };
+        default:
+            return { state: "unknown", reason: taskState || "unknown" };
+    }
+}
+/**
+ * Pull an A2A Task's state + id out of a /message response body, tolerating the
+ * shapes a gateway/agent might return: a bare Task, one nested under JSON-RPC
+ * `result`, or one under `task`; with the state at `status.state` (A2A) or a
+ * flat `state`. Returns null when the body carries no task object (e.g. a plain
+ * text reply or non-JSON) — the caller then treats a successful call as
+ * `completed`. Pure.
+ *
+ * SECURITY: the response comes from an untrusted remote agent (2nd-order prompt
+ * injection). We read ONLY the structural state/id strings here; the full reply
+ * never enters the ledger or the hub.
+ */
+export function extractTaskState(body) {
+    let json;
+    try {
+        json = JSON.parse(body);
+    }
+    catch {
+        return null; // non-JSON (plain text reply) → no task object
+    }
+    if (!json || typeof json !== "object")
+        return null;
+    const j = json;
+    // A2A task objects appear bare, under JSON-RPC `result`, or under `task`.
+    const candidates = [j.result, j.task, j].filter((t) => !!t && typeof t === "object");
+    for (const task of candidates) {
+        const state = (typeof task.status?.state === "string" && task.status.state) ||
+            (typeof task.state === "string" && task.state) ||
+            "";
+        if (!state)
+            continue;
+        const taskId = (typeof task.id === "string" && task.id) ||
+            (typeof task.taskId === "string" && task.taskId) ||
+            "";
+        return taskId ? { state, taskId } : { state };
+    }
+    return null;
+}
+//# sourceMappingURL=a2a.js.map

package/dist/integrations/takoapi/a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.js","sourceRoot":"","sources":["../../../src/integrations/takoapi/a2a.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAiB;IAEjB,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACxC,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACjD,KAAK,gBAAgB,CAAC;QACtB,KAAK,eAAe;YAClB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACjD,KAAK,WAAW;YACd,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAChD,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU;YACb,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/C,KAAK,UAAU,CAAC;QAChB,KAAK,WAAW;YACd,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC/C;YACE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,SAAS,EAAE,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY;IAEZ,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,+CAA+C;IAC9D,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,CAAC,GAAG,IAA2B,CAAC;IACtC,0EAA0E;IAC1E,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAC7C,CAAC,CAAC,EAA4B,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAC9D,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,KAAK,GACT,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAC7D,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC;YAC9C,EAAE,CAAC;QACL,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,MAAM,GACV,CAAC,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC;YACxC,CAAC,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC;YAChD,EAAE,CAAC;QACL,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/integrations/takoapi/ledger.d.ts

@@ -0,0 +1,32 @@
+import { EventEmitter } from "node:events";
+export interface TakoCallEntry {
+    /** Agent slug — the session identity (one entry per slug; latest call wins). */
+    slug: string;
+    /** A2A task id, if the response carried one. */
+    taskId?: string;
+    /** Epoch ms of the first recorded call to this slug. */
+    startedAt: number;
+    /** Epoch ms of the most recent update. */
+    lastMtime: number;
+    /** Last observed A2A TaskState string (e.g. "completed", "working"). */
+    lastState: string;
+}
+/**
+ * Fires "change" after every successful write so the in-process observer can
+ * push a live update. The `takoapi` tool and the hub share one process, so an
+ * in-process event is enough (and simpler/safer than fs.watch).
+ */
+export declare const takoLedgerEvents: EventEmitter<[never]>;
+/** Read the ledger; tolerant of a missing or corrupt file (returns []). */
+export declare function loadTakoLedger(): TakoCallEntry[];
+/** Record (upsert by slug) a call LISA made to a remote agent. Returns the entry. */
+export declare function recordTakoCall(d: {
+    slug: string;
+    state: string;
+    taskId?: string;
+    /** Override the clock (tests). */
+    now?: number;
+}): TakoCallEntry;
+/** All retained calls, newest first; prunes aged-out entries as a side effect. */
+export declare function listTakoCalls(now?: number): TakoCallEntry[];
+//# sourceMappingURL=ledger.d.ts.map

package/dist/integrations/takoapi/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../../src/integrations/takoapi/ledger.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,uBAAqB,CAAC;AAYnD,2EAA2E;AAC3E,wBAAgB,cAAc,IAAI,aAAa,EAAE,CAoBhD;AAQD,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,CAAC,EAAE;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,aAAa,CAuBhB;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,GAAG,SAAa,GAAG,aAAa,EAAE,CAM/D"}

package/dist/integrations/takoapi/ledger.js

@@ -0,0 +1,96 @@
+/**
+ * TakoAPI call ledger (Dispatch D2b) — a small persistent record of the REMOTE
+ * agents LISA has called via the `takoapi` tool, so the orchestrator hub can
+ * surface them as first-class sessions (with their last A2A TaskState) alongside
+ * local agents. Mirrors dispatch-ledger.ts.
+ *
+ * DISCIPLINE: this records only agents LISA actually CALLED — never the
+ * ~200-agent registry. Discovery stays in the `takoapi discover` tool; the hub
+ * only ever shows agents you've interacted with (called) plus an explicit pin
+ * list (config).
+ *
+ * PRIVACY: structural only — slug, A2A task id, TaskState, timestamps. Never the
+ * prompt sent or the reply received (those flow through the tool, not here).
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { EventEmitter } from "node:events";
+/** How long a call is retained for readback after its last update. */
+const RETAIN_MS = 24 * 60 * 60_000;
+/**
+ * Fires "change" after every successful write so the in-process observer can
+ * push a live update. The `takoapi` tool and the hub share one process, so an
+ * in-process event is enough (and simpler/safer than fs.watch).
+ */
+export const takoLedgerEvents = new EventEmitter();
+takoLedgerEvents.setMaxListeners(64);
+function lisaHome() {
+    return process.env.LISA_HOME ?? path.join(os.homedir(), ".lisa");
+}
+/** Resolved lazily (reads env at call time) so tests can point LISA_HOME at a tmp dir. */
+function ledgerPath() {
+    return path.join(lisaHome(), "takoapi-calls.json");
+}
+/** Read the ledger; tolerant of a missing or corrupt file (returns []). */
+export function loadTakoLedger() {
+    let raw;
+    try {
+        raw = fs.readFileSync(ledgerPath(), "utf8");
+    }
+    catch {
+        return []; // no file yet
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((e) => !!e &&
+            typeof e.slug === "string" &&
+            typeof e.lastState === "string" &&
+            typeof e.lastMtime === "number");
+    }
+    catch {
+        return []; // corrupt JSON — treat as empty rather than throwing
+    }
+}
+function saveTakoLedger(entries) {
+    const file = ledgerPath();
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(entries, null, 2));
+}
+/** Record (upsert by slug) a call LISA made to a remote agent. Returns the entry. */
+export function recordTakoCall(d) {
+    const now = d.now ?? Date.now();
+    const existing = loadTakoLedger();
+    const prior = existing.find((e) => e.slug === d.slug);
+    const entry = {
+        slug: d.slug,
+        lastState: d.state,
+        lastMtime: now,
+        startedAt: prior?.startedAt ?? now,
+        // Keep the freshest task id; fall back to the prior one if this call had none.
+        ...(d.taskId
+            ? { taskId: d.taskId }
+            : prior?.taskId
+                ? { taskId: prior.taskId }
+                : {}),
+    };
+    // Replace the same-slug entry and age out calls older than the retention window.
+    const cutoff = now - RETAIN_MS;
+    const next = existing.filter((e) => e.slug !== d.slug && e.lastMtime >= cutoff);
+    next.push(entry);
+    saveTakoLedger(next);
+    takoLedgerEvents.emit("change");
+    return entry;
+}
+/** All retained calls, newest first; prunes aged-out entries as a side effect. */
+export function listTakoCalls(now = Date.now()) {
+    const all = loadTakoLedger();
+    const cutoff = now - RETAIN_MS;
+    const keep = all.filter((e) => e.lastMtime >= cutoff);
+    if (keep.length !== all.length)
+        saveTakoLedger(keep);
+    return keep.sort((a, b) => b.lastMtime - a.lastMtime);
+}
+//# sourceMappingURL=ledger.js.map

package/dist/integrations/takoapi/ledger.js.map

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

package/dist/integrations/takoapi/observer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * TakoAPI observer (Dispatch D2b) — surfaces the REMOTE agents LISA has called
+ * (or the user pinned) as first-class sessions in the orchestrator hub, with
+ * their last A2A TaskState, alongside local agents.
+ *
+ * Source of truth is the call ledger (takoapi-calls.json), written by the
+ * `takoapi` tool when LISA delegates a task. The observer NEVER lists the
+ * registry — discovery is the tool's job (`takoapi discover`); monitoring shows
+ * only agents you've interacted with (called) plus a small explicit pin list:
+ *   ~/.lisa/agents.json → { "takoapi": { "enabled": true, "pin": ["slug-a"] } }
+ *
+ * Off by default. With no calls and no pins it lists nothing (effective no-op).
+ * PRIVACY: structural only — slug, TaskState, timestamps; no prompts/replies.
+ */
+import { EventEmitter } from "node:events";
+import type { AgentIntegrationConfig, AgentObserver, AgentSession } from "../types.js";
+import { type TakoCallEntry } from "./ledger.js";
+/** Read the `pin` list off the integration config, ignoring junk. */
+export declare function pinsOf(cfg: AgentIntegrationConfig): string[];
+/**
+ * Build the hub session list from ledger entries + pinned slugs. Pure given its
+ * inputs (the unit under test):
+ *   - called agents within the active window → their mapped TaskState
+ *   - pinned slugs with no recent call       → idle ("pinned"), kept visible
+ * One row per slug (a called pin uses its real call state, not "pinned").
+ */
+export declare function buildTakoSessions(calls: TakoCallEntry[], pins: string[], now: number): AgentSession[];
+export declare class TakoApiObserver extends EventEmitter implements AgentObserver {
+    readonly agent = "takoapi";
+    private pins;
+    private emitFn;
+    private readonly onChange;
+    constructor(cfg: AgentIntegrationConfig);
+    start(emit: (s: AgentSession) => void): Promise<void>;
+    list(): AgentSession[];
+    stop(): Promise<void>;
+    private flush;
+}
+//# sourceMappingURL=observer.d.ts.map

package/dist/integrations/takoapi/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../src/integrations/takoapi/observer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAmC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAMlF,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAK5D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EAAE,EACtB,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,YAAY,EAAE,CAiChB;AAED,qBAAa,eAAgB,SAAQ,YAAa,YAAW,aAAa;IACxE,QAAQ,CAAC,KAAK,aAAa;IAC3B,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,GAAG,EAAE,sBAAsB;IAKjC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D,IAAI,IAAI,YAAY,EAAE;IAIhB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,OAAO,CAAC,KAAK;CAId"}

package/dist/integrations/takoapi/observer.js

@@ -0,0 +1,102 @@
+/**
+ * TakoAPI observer (Dispatch D2b) — surfaces the REMOTE agents LISA has called
+ * (or the user pinned) as first-class sessions in the orchestrator hub, with
+ * their last A2A TaskState, alongside local agents.
+ *
+ * Source of truth is the call ledger (takoapi-calls.json), written by the
+ * `takoapi` tool when LISA delegates a task. The observer NEVER lists the
+ * registry — discovery is the tool's job (`takoapi discover`); monitoring shows
+ * only agents you've interacted with (called) plus a small explicit pin list:
+ *   ~/.lisa/agents.json → { "takoapi": { "enabled": true, "pin": ["slug-a"] } }
+ *
+ * Off by default. With no calls and no pins it lists nothing (effective no-op).
+ * PRIVACY: structural only — slug, TaskState, timestamps; no prompts/replies.
+ */
+import { EventEmitter } from "node:events";
+import { registerIntegration } from "../registry.js";
+import { taskStateToSessionState } from "./a2a.js";
+import { listTakoCalls, takoLedgerEvents } from "./ledger.js";
+/** Remote delegations linger longer than chat sessions but shouldn't pile up. */
+const ACTIVE_WINDOW_MS = 3 * 60 * 60_000; // 3h
+const MAX_LISTED = 10;
+/** Read the `pin` list off the integration config, ignoring junk. */
+export function pinsOf(cfg) {
+    const raw = cfg.pin;
+    return Array.isArray(raw)
+        ? raw.filter((s) => typeof s === "string")
+        : [];
+}
+/**
+ * Build the hub session list from ledger entries + pinned slugs. Pure given its
+ * inputs (the unit under test):
+ *   - called agents within the active window → their mapped TaskState
+ *   - pinned slugs with no recent call       → idle ("pinned"), kept visible
+ * One row per slug (a called pin uses its real call state, not "pinned").
+ */
+export function buildTakoSessions(calls, pins, now) {
+    const cutoff = now - ACTIVE_WINDOW_MS;
+    const bySlug = new Map();
+    for (const c of calls) {
+        if (c.lastMtime < cutoff)
+            continue;
+        const { state, reason } = taskStateToSessionState(c.lastState);
+        bySlug.set(c.slug, {
+            agent: "takoapi",
+            sessionId: c.slug,
+            project: c.slug,
+            state,
+            stateReason: reason,
+            lastMtime: c.lastMtime,
+        });
+    }
+    // Pins the user wants always visible, even when idle. A pin that WAS called
+    // recently keeps its real state (set above); only never-/stale-called pins
+    // are added as idle, stamped `now` so the frontend's window keeps them.
+    for (const slug of pins) {
+        if (!bySlug.has(slug)) {
+            bySlug.set(slug, {
+                agent: "takoapi",
+                sessionId: slug,
+                project: slug,
+                state: "idle",
+                stateReason: "pinned",
+                lastMtime: now,
+            });
+        }
+    }
+    return [...bySlug.values()]
+        .sort((a, b) => b.lastMtime - a.lastMtime)
+        .slice(0, MAX_LISTED);
+}
+export class TakoApiObserver extends EventEmitter {
+    agent = "takoapi";
+    pins;
+    emitFn = null;
+    onChange = () => this.flush();
+    constructor(cfg) {
+        super();
+        this.pins = pinsOf(cfg);
+    }
+    async start(emit) {
+        this.emitFn = emit;
+        // The tool records calls in this same process; re-emit on each ledger change
+        // so a fresh delegation shows up live (not just on the next snapshot fetch).
+        takoLedgerEvents.on("change", this.onChange);
+        this.flush(); // surface any past calls / pins immediately
+    }
+    list() {
+        return buildTakoSessions(listTakoCalls(), this.pins, Date.now());
+    }
+    async stop() {
+        takoLedgerEvents.off("change", this.onChange);
+        this.emitFn = null;
+    }
+    flush() {
+        if (!this.emitFn)
+            return;
+        for (const s of this.list())
+            this.emitFn(s);
+    }
+}
+registerIntegration("takoapi", (cfg) => new TakoApiObserver(cfg));
+//# sourceMappingURL=observer.js.map

package/dist/integrations/takoapi/observer.js.map

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