aibroker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Matthias Nott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# aibroker
+
+Platform-agnostic AI message broker — shared infrastructure for messaging
+bridges that connect WhatsApp, Telegram, and other channels to Claude Code.
+
+## Family
+
+| Package | Channel | Repo |
+|---------|---------|------|
+| **aibroker** | Shared core | [github.com/mnott/AIBroker](https://github.com/mnott/AIBroker) |
+| **whazaa** | WhatsApp | [github.com/mnott/Whazaa](https://github.com/mnott/Whazaa) |
+| **telex** | Telegram | [github.com/mnott/Telex](https://github.com/mnott/Telex) |
+
+## What's Inside
+
+- Logging with configurable prefix (`setLogPrefix`)
+- Session state management and message queuing
+- File persistence with configurable data dir (`setAppDir`)
+- Unix Domain Socket IPC (server + client)
+- macOS iTerm2 adapter (AppleScript session management)
+- Kokoro TTS (local speech synthesis + Whisper transcription)
+
+## Usage
+
+```typescript
+import { setLogPrefix, setAppDir } from "aibroker";
+
+setLogPrefix("my-app");
+setAppDir("/path/to/data");
+```
+
+## Hard Rule
+
+aibroker never imports `@whiskeysockets/baileys`, `telegram`/`gramjs`,
+`better-sqlite3`, `qrcode`, or any transport SDK. Those belong in
+the per-channel packages.
+
+## License
+
+MIT — Matthias Nott

package/dist/adapters/iterm/core.d.ts

@@ -0,0 +1,28 @@
+/**
+ * adapters/iterm/core.ts — Low-level iTerm2 AppleScript primitives.
+ *
+ * Foundation of all iTerm2 communication. Wraps `osascript` and `spawnSync`
+ * with zero transport-specific imports.
+ */
+export declare function runAppleScript(script: string): string | null;
+export declare function stripItermPrefix(id: string | undefined): string | undefined;
+export declare function withSessionAppleScript(sessionId: string, body: string, fallback?: string): string;
+export declare function sendKeystrokeToSession(sessionId: string, asciiCode: number): boolean;
+export declare function sendEscapeSequenceToSession(sessionId: string, dirChar: string): boolean;
+export declare function typeIntoSession(sessionId: string, text: string): boolean;
+export declare function pasteTextIntoSession(sessionId: string, text: string): boolean;
+export declare function findClaudeSession(): string | null;
+export declare function isClaudeRunningInSession(sessionId: string): boolean;
+export declare function isItermRunning(): boolean;
+export declare function isItermSessionAlive(sessionId: string): boolean;
+export declare function isScreenLocked(): boolean;
+export declare function writeToTty(ttyPath: string, text: string): boolean;
+export interface SessionSnapshot {
+    id: string;
+    name: string;
+    tty: string;
+    atPrompt: boolean;
+    paiName: string | null;
+}
+export declare function snapshotAllSessions(): SessionSnapshot[];
+//# sourceMappingURL=core.d.ts.map

package/dist/adapters/iterm/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/adapters/iterm/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ5D;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI3E;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAc,GAAG,MAAM,CActG;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAQpF;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQvF;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIxE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ7E;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CA+BjD;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAcnE;AAED,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO9D;AAED,wBAAgB,cAAc,IAAI,OAAO,CAWxC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA8BjE;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAgB,mBAAmB,IAAI,eAAe,EAAE,CAyCvD"}

package/dist/adapters/iterm/core.js

@@ -0,0 +1,191 @@
+/**
+ * adapters/iterm/core.ts — Low-level iTerm2 AppleScript primitives.
+ *
+ * Foundation of all iTerm2 communication. Wraps `osascript` and `spawnSync`
+ * with zero transport-specific imports.
+ */
+import { spawnSync } from "node:child_process";
+import { log } from "../../core/log.js";
+export function runAppleScript(script) {
+    const result = spawnSync("osascript", [], {
+        input: script,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 4_000,
+    });
+    if (result.status !== 0)
+        return null;
+    return result.stdout?.toString().trim() ?? null;
+}
+export function stripItermPrefix(id) {
+    if (!id)
+        return id;
+    const colonIdx = id.lastIndexOf(":");
+    return colonIdx >= 0 ? id.slice(colonIdx + 1) : id;
+}
+export function withSessionAppleScript(sessionId, body, fallback = 'return ""') {
+    const escaped = sessionId.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    return `tell application "iTerm2"
+  repeat with aWindow in windows
+    repeat with aTab in tabs of aWindow
+      repeat with aSession in sessions of aTab
+        if id of aSession is "${escaped}" then
+${body}
+        end if
+      end repeat
+    end repeat
+  end repeat
+  ${fallback}
+end tell`;
+}
+export function sendKeystrokeToSession(sessionId, asciiCode) {
+    const script = withSessionAppleScript(sessionId, `          tell aSession to write text (ASCII character ${asciiCode}) newline no\n          return "ok"`, 'return "not_found"');
+    const result = runAppleScript(script);
+    return result === "ok";
+}
+export function sendEscapeSequenceToSession(sessionId, dirChar) {
+    const script = withSessionAppleScript(sessionId, `          tell aSession to write text (ASCII character 27) & "[${dirChar}" newline no\n          return "ok"`, 'return "not_found"');
+    const result = runAppleScript(script);
+    return result === "ok";
+}
+export function typeIntoSession(sessionId, text) {
+    if (!pasteTextIntoSession(sessionId, text))
+        return false;
+    sendKeystrokeToSession(sessionId, 13);
+    return true;
+}
+export function pasteTextIntoSession(sessionId, text) {
+    const escaped = text.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    const textScript = withSessionAppleScript(sessionId, `          tell aSession to write text "${escaped}" newline no\n          return "ok"`, 'return "not_found"');
+    return runAppleScript(textScript) === "ok";
+}
+export function findClaudeSession() {
+    const script = `
+tell application "iTerm2"
+  set output to ""
+  repeat with aWindow in windows
+    repeat with aTab in tabs of aWindow
+      repeat with aSession in sessions of aTab
+        set sessionId to id of aSession
+        set sessionName to name of aSession
+        set output to output & sessionId & (ASCII character 9) & sessionName & linefeed
+      end repeat
+    end repeat
+  end repeat
+  return output
+end tell`;
+    const result = runAppleScript(script);
+    if (!result)
+        return null;
+    const lines = result.split("\n").filter(Boolean);
+    for (const line of lines) {
+        const tabIdx = line.indexOf("\t");
+        if (tabIdx < 0)
+            continue;
+        const id = line.substring(0, tabIdx);
+        const name = line.substring(tabIdx + 1).toLowerCase();
+        if (name.includes("claude")) {
+            log(`Found claude session: ${id} ("${line.substring(tabIdx + 1)}")`);
+            return id;
+        }
+    }
+    return null;
+}
+export function isClaudeRunningInSession(sessionId) {
+    const script = withSessionAppleScript(sessionId, `          if (is at shell prompt of aSession) then\n            return "shell"\n          else\n            return "running"\n          end if`, 'return "not_found"');
+    const result = runAppleScript(script);
+    if (result === "running")
+        return true;
+    if (result === "shell") {
+        log(`Session ${sessionId} is at shell prompt — Claude has exited.`);
+    }
+    else {
+        log(`Session ${sessionId} not found in iTerm2.`);
+    }
+    return false;
+}
+export function isItermRunning() {
+    const result = spawnSync("pgrep", ["-x", "iTerm2"], {
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 3_000,
+    });
+    return result.status === 0;
+}
+export function isItermSessionAlive(sessionId) {
+    const script = withSessionAppleScript(sessionId, `          return "alive"`, 'return "gone"');
+    return runAppleScript(script) === "alive";
+}
+export function isScreenLocked() {
+    try {
+        const result = spawnSync("sh", ["-c", "ioreg -n Root -d1 -a | grep -c CGSSessionScreenIsLocked"], { timeout: 3_000, encoding: "utf8" });
+        return parseInt((result.stdout ?? "0").trim(), 10) > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export function writeToTty(ttyPath, text) {
+    if (!ttyPath || !ttyPath.startsWith("/dev/ttys")) {
+        log(`writeToTty: invalid tty path "${ttyPath}"`);
+        return false;
+    }
+    const statResult = spawnSync("test", ["-c", ttyPath], {
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 1_000,
+    });
+    if (statResult.status !== 0) {
+        log(`writeToTty: device not found: ${ttyPath}`);
+        return false;
+    }
+    const safeText = text.replace(/'/g, "'\\''");
+    const writeResult = spawnSync("sh", ["-c", `printf '%s\\n' '${safeText}' > ${ttyPath}`], { stdio: ["pipe", "pipe", "pipe"], timeout: 2_000 });
+    if (writeResult.status !== 0) {
+        const stderr = writeResult.stderr?.toString().trim() ?? "";
+        log(`writeToTty: failed for ${ttyPath} — ${stderr || "exit " + writeResult.status}`);
+        return false;
+    }
+    log(`writeToTty: delivered ${text.length} chars to ${ttyPath}`);
+    return true;
+}
+export function snapshotAllSessions() {
+    const script = `
+tell application "iTerm2"
+  set output to ""
+  repeat with aWindow in windows
+    repeat with aTab in tabs of aWindow
+      repeat with aSession in sessions of aTab
+        set sessionId to id of aSession
+        set sessionName to name of aSession
+        set sessionTty to tty of aSession
+        set isAtPrompt to (is at shell prompt of aSession)
+        tell aSession
+          try
+            set paiName to (variable named "user.paiName")
+          on error
+            set paiName to ""
+          end try
+        end tell
+        set output to output & sessionId & (ASCII character 9) & sessionName & (ASCII character 9) & sessionTty & (ASCII character 9) & (isAtPrompt as text) & (ASCII character 9) & paiName & linefeed
+      end repeat
+    end repeat
+  end repeat
+  return output
+end tell`;
+    const result = runAppleScript(script);
+    if (!result)
+        return [];
+    const sessions = [];
+    for (const line of result.split("\n").filter(Boolean)) {
+        const parts = line.split("\t");
+        if (parts.length < 4)
+            continue;
+        sessions.push({
+            id: parts[0],
+            name: parts[1],
+            tty: parts[2],
+            atPrompt: parts[3] === "true",
+            paiName: (parts[4] && parts[4] !== "missing value" && parts[4] !== "") ? parts[4] : null,
+        });
+    }
+    return sessions;
+}
+//# sourceMappingURL=core.js.map

package/dist/adapters/iterm/core.js.map

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

package/dist/adapters/iterm/dictation.d.ts

@@ -0,0 +1,26 @@
+/**
+ * adapters/iterm/dictation.ts — Local mic recording and Whisper transcription.
+ *
+ * Provides recordFromMic() and transcribeLocalAudio() for desk dictation.
+ * Both functions use sox for recording and the Whisper CLI for transcription.
+ */
+/** Absolute path to the Whisper CLI binary. */
+export declare const WHISPER_BIN: string;
+/** Whisper model name (overridable via AIBROKER_WHISPER_MODEL env). */
+export declare const WHISPER_MODEL: string;
+/**
+ * Record audio from the default Mac microphone using sox.
+ * Stops automatically after ~2 seconds of silence.
+ *
+ * @param maxDurationSec - Maximum recording duration (default 60s).
+ * @returns Absolute path to the recorded WAV file.
+ */
+export declare function recordFromMic(maxDurationSec?: number): Promise<string>;
+/**
+ * Transcribe a local audio file using the Whisper CLI.
+ *
+ * @param audioPath - Absolute path to the audio file.
+ * @returns The raw transcript text.
+ */
+export declare function transcribeLocalAudio(audioPath: string): Promise<string>;
+//# sourceMappingURL=dictation.d.ts.map

package/dist/adapters/iterm/dictation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation.d.ts","sourceRoot":"","sources":["../../../src/adapters/iterm/dictation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,+CAA+C;AAC/C,eAAO,MAAM,WAAW,QAGR,CAAC;AAEjB,uEAAuE;AACvE,eAAO,MAAM,aAAa,QAA2H,CAAC;AAQtJ;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,cAAc,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAoCxE;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyC7E"}

package/dist/adapters/iterm/dictation.js

@@ -0,0 +1,99 @@
+/**
+ * adapters/iterm/dictation.ts — Local mic recording and Whisper transcription.
+ *
+ * Provides recordFromMic() and transcribeLocalAudio() for desk dictation.
+ * Both functions use sox for recording and the Whisper CLI for transcription.
+ */
+import { existsSync, readFileSync, unlinkSync } from "node:fs";
+import { promisify } from "node:util";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { execFile } from "node:child_process";
+import { log } from "../../core/log.js";
+const execFileAsync = promisify(execFile);
+/** Absolute path to the Whisper CLI binary. */
+export const WHISPER_BIN = ["/opt/homebrew/bin/whisper", "/usr/local/bin/whisper", "whisper"].find((p) => p === "whisper" || existsSync(p)) ?? "whisper";
+/** Whisper model name (overridable via AIBROKER_WHISPER_MODEL env). */
+export const WHISPER_MODEL = process.env.AIBROKER_WHISPER_MODEL ?? process.env.MSGBRIDGE_WHISPER_MODEL ?? process.env.WHAZAA_WHISPER_MODEL ?? "small";
+/** Absolute path to the sox binary. */
+const SOX_BIN = ["/opt/homebrew/bin/sox", "/usr/local/bin/sox", "sox"].find((p) => p === "sox" || existsSync(p)) ?? "sox";
+/**
+ * Record audio from the default Mac microphone using sox.
+ * Stops automatically after ~2 seconds of silence.
+ *
+ * @param maxDurationSec - Maximum recording duration (default 60s).
+ * @returns Absolute path to the recorded WAV file.
+ */
+export async function recordFromMic(maxDurationSec = 60) {
+    const wavPath = join(tmpdir(), `aibroker-dictation-${Date.now()}.wav`);
+    // Audible start indicator
+    execFile("afplay", ["/System/Library/Sounds/Tink.aiff"], () => { });
+    log(`Dictation: recording to ${wavPath} (max ${maxDurationSec}s)...`);
+    try {
+        await execFileAsync(SOX_BIN, [
+            "-d", "-r", "16000", "-c", "1", "-b", "16",
+            wavPath,
+            "silence", "1", "0.2", "1%", "1", "2.0", "1%",
+        ], {
+            timeout: maxDurationSec * 1000,
+            env: {
+                ...process.env,
+                PATH: `/opt/homebrew/bin:/usr/local/bin:${process.env.PATH || "/usr/bin:/bin"}`,
+            },
+        });
+    }
+    catch (err) {
+        if (!existsSync(wavPath)) {
+            throw new Error(`Recording failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        log("Dictation: sox exited (likely timeout/silence stop) — file exists, continuing.");
+    }
+    // Audible stop indicator
+    execFile("afplay", ["/System/Library/Sounds/Pop.aiff"], () => { });
+    log(`Dictation: recorded ${wavPath}`);
+    return wavPath;
+}
+/**
+ * Transcribe a local audio file using the Whisper CLI.
+ *
+ * @param audioPath - Absolute path to the audio file.
+ * @returns The raw transcript text.
+ */
+export async function transcribeLocalAudio(audioPath) {
+    const base = audioPath.replace(/\.[^.]+$/, "");
+    const baseName = base.split("/").pop();
+    const outDir = tmpdir();
+    const filesToClean = [
+        join(outDir, `${baseName}.txt`),
+        join(outDir, `${baseName}.json`),
+        join(outDir, `${baseName}.vtt`),
+        join(outDir, `${baseName}.srt`),
+        join(outDir, `${baseName}.tsv`),
+    ];
+    try {
+        log(`Dictation: transcribing ${audioPath} (model=${WHISPER_MODEL})...`);
+        await execFileAsync(WHISPER_BIN, [audioPath, "--model", WHISPER_MODEL, "--output_format", "txt", "--output_dir", outDir, "--verbose", "False"], {
+            timeout: 120_000,
+            env: {
+                ...process.env,
+                PATH: `/opt/homebrew/bin:/usr/local/bin:${process.env.PATH || "/usr/bin:/bin"}`,
+            },
+        });
+        const txtPath = join(outDir, `${baseName}.txt`);
+        if (!existsSync(txtPath)) {
+            throw new Error(`Whisper did not produce output at ${txtPath}`);
+        }
+        const transcript = readFileSync(txtPath, "utf-8").trim();
+        log(`Dictation: transcript (${transcript.length} chars): ${transcript.slice(0, 80)}`);
+        return transcript;
+    }
+    finally {
+        for (const f of filesToClean) {
+            try {
+                unlinkSync(f);
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
+//# sourceMappingURL=dictation.js.map

package/dist/adapters/iterm/dictation.js.map

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

package/dist/adapters/iterm/sessions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * adapters/iterm/sessions.ts — Higher-level iTerm2 session management.
+ *
+ * Session variables, tab naming, discovery, creation, and lifecycle.
+ * Does NOT import any transport send functions — callers handle message delivery.
+ */
+export declare function setItermSessionVar(itermSessionId: string, name: string): void;
+export declare function setItermTabName(itermSessionId: string, name: string): void;
+export declare function getItermSessionVar(itermSessionId: string): string | null;
+export declare function findItermSessionForTermId(termSessionId: string, itermSessionIdHint?: string): string | null;
+export declare function listClaudeSessions(): Array<{
+    id: string;
+    name: string;
+}>;
+/**
+ * Build a full session list with type classification and PAI name resolution.
+ * Returns the data used by /s command.
+ */
+export declare function getSessionList(): Array<{
+    id: string;
+    name: string;
+    path: string;
+    type: "claude" | "terminal";
+    paiName: string | null;
+    atPrompt: boolean;
+}>;
+export declare function createClaudeSession(command?: string): string | null;
+export declare function createTerminalTab(command?: string): string | null;
+export declare function restartSession(itermSessionId: string, command?: string): Promise<void>;
+export declare function killSession(itermSessionId: string): void;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/adapters/iterm/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/adapters/iterm/sessions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAG7E;AAED,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAG1E;AAED,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBxE;AAID,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,GAAG,IAAI,CA0Bf;AAID,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAKxE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC,CAoBD;AAID,wBAAgB,mBAAmB,CAAC,OAAO,SAAW,GAAG,MAAM,GAAG,IAAI,CAkBrE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBjE;AAID,wBAAsB,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,SAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9F;AAED,wBAAgB,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAMxD"}

package/dist/adapters/iterm/sessions.js

@@ -0,0 +1,156 @@
+/**
+ * adapters/iterm/sessions.ts — Higher-level iTerm2 session management.
+ *
+ * Session variables, tab naming, discovery, creation, and lifecycle.
+ * Does NOT import any transport send functions — callers handle message delivery.
+ */
+import { execSync } from "node:child_process";
+import { runAppleScript, typeIntoSession, sendKeystrokeToSession, stripItermPrefix, withSessionAppleScript, snapshotAllSessions, } from "./core.js";
+import { log } from "../../core/log.js";
+import { managedSessions, updateSessionTtyCache, } from "../../core/state.js";
+// ── Session Variable Helpers ──
+function setItermSessionProperty(itermSessionId, body) {
+    try {
+        const script = withSessionAppleScript(itermSessionId, `          tell aSession\n            ${body}\n          end tell\n          return`, "");
+        execSync(`osascript <<'APPLESCRIPT'\n${script}\nAPPLESCRIPT`, {
+            timeout: 5000,
+            shell: "/bin/bash",
+        });
+    }
+    catch {
+        // silently ignore
+    }
+}
+export function setItermSessionVar(itermSessionId, name) {
+    const escaped = name.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/[\n\r]/g, " ");
+    setItermSessionProperty(itermSessionId, `set variable named "user.paiName" to "${escaped}"`);
+}
+export function setItermTabName(itermSessionId, name) {
+    const escaped = name.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/[\n\r]/g, " ");
+    setItermSessionProperty(itermSessionId, `set name to "${escaped}"`);
+}
+export function getItermSessionVar(itermSessionId) {
+    try {
+        const script = withSessionAppleScript(itermSessionId, `          tell aSession\n            try\n              return (variable named "user.paiName")\n            on error\n              return ""\n            end try\n          end tell`, 'return ""');
+        const result = execSync(`osascript <<'APPLESCRIPT'\n${script}\nAPPLESCRIPT`, {
+            timeout: 5000,
+            encoding: "utf8",
+            shell: "/bin/bash",
+        }).trim();
+        return (result && result !== "missing value") ? result : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Session Resolution ──
+export function findItermSessionForTermId(termSessionId, itermSessionIdHint) {
+    if (itermSessionIdHint) {
+        return stripItermPrefix(itermSessionIdHint) ?? itermSessionIdHint;
+    }
+    const script = `
+tell application "iTerm2"
+  set output to ""
+  repeat with aWindow in windows
+    repeat with aTab in tabs of aWindow
+      repeat with aSession in sessions of aTab
+        set envVal to ""
+        try
+          tell aSession to set envVal to (variable named "TERM_SESSION_ID")
+        end try
+        if envVal is "${termSessionId.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}" then
+          return id of aSession
+        end if
+      end repeat
+    end repeat
+  end repeat
+  return ""
+end tell`;
+    const result = runAppleScript(script);
+    return (result && result.length > 0) ? result : null;
+}
+// ── Session Listing ──
+export function listClaudeSessions() {
+    const sessions = snapshotAllSessions();
+    return sessions
+        .filter((s) => s.name.toLowerCase().includes("claude") || s.paiName)
+        .map((s) => ({ id: s.id, name: s.paiName ?? s.name }));
+}
+/**
+ * Build a full session list with type classification and PAI name resolution.
+ * Returns the data used by /s command.
+ */
+export function getSessionList() {
+    const snapshots = snapshotAllSessions();
+    // Update TTY cache
+    updateSessionTtyCache(snapshots.map((s) => ({ id: s.id, tty: s.tty })));
+    // Prune dead managed sessions
+    const aliveIds = new Set(snapshots.map((s) => s.id));
+    for (const [id] of managedSessions) {
+        if (!aliveIds.has(id))
+            managedSessions.delete(id);
+    }
+    return snapshots.map((s) => ({
+        id: s.id,
+        name: s.paiName ?? s.name,
+        path: "",
+        type: (s.name.toLowerCase().includes("claude") || !s.atPrompt) ? "claude" : "terminal",
+        paiName: s.paiName,
+        atPrompt: s.atPrompt,
+    }));
+}
+// ── Session Creation ──
+export function createClaudeSession(command = "claude") {
+    try {
+        const script = `tell application "iTerm2"
+  tell current window
+    set newTab to (create tab with default profile)
+    tell newTab
+      tell current session
+        write text "${command.replace(/"/g, '\\"')}"
+        return id
+      end tell
+    end tell
+  end tell
+end tell`;
+        return runAppleScript(script) ?? null;
+    }
+    catch (err) {
+        log("Failed to create session:", String(err));
+        return null;
+    }
+}
+export function createTerminalTab(command) {
+    try {
+        const writeCmd = command
+            ? `write text "${command.replace(/"/g, '\\"')}"`
+            : "";
+        const script = `tell application "iTerm2"
+  tell current window
+    set newTab to (create tab with default profile)
+    tell newTab
+      tell current session
+        ${writeCmd}
+        return id
+      end tell
+    end tell
+  end tell
+end tell`;
+        return runAppleScript(script) ?? null;
+    }
+    catch (err) {
+        log("Failed to create terminal tab:", String(err));
+        return null;
+    }
+}
+// ── Session Lifecycle ──
+export async function restartSession(itermSessionId, command = "claude") {
+    sendKeystrokeToSession(itermSessionId, 3); // Ctrl+C
+    await new Promise((r) => setTimeout(r, 500));
+    typeIntoSession(itermSessionId, command);
+}
+export function killSession(itermSessionId) {
+    const script = withSessionAppleScript(itermSessionId, `          close aSession\n          return "ok"`);
+    runAppleScript(script);
+}
+//# sourceMappingURL=sessions.js.map

package/dist/adapters/iterm/sessions.js.map

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