@aetherai/aether 0.0.8 → 0.0.10

package/dist/CLI/packages/core/src/agents/backends/tmux-commands.js

@@ -0,0 +1,349 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview Type-safe async wrappers for tmux CLI commands.
+ *
+ * All functions use `execCommand('tmux', [...args])` from shell-utils,
+ * avoiding shell injection by passing arguments as arrays (execFile).
+ */
+import { execCommand, isCommandAvailable } from '../../utils/shell-utils.js';
+import { createDebugLogger } from '../../utils/debugLogger.js';
+const debugLogger = createDebugLogger('TMUX_CMD');
+/**
+ * Minimum tmux version required for split-pane support.
+ */
+const MIN_TMUX_VERSION = '3.0';
+// ─── Helpers ────────────────────────────────────────────────────
+async function tmuxResult(args, serverName) {
+    const fullArgs = serverName ? ['-L', serverName, ...args] : args;
+    debugLogger.info(`tmux ${fullArgs.join(' ')}`);
+    const result = await execCommand('tmux', fullArgs, {
+        preserveOutputOnError: true,
+    });
+    if (result.code !== 0 && result.stderr.trim()) {
+        debugLogger.error(`tmux error: ${result.stderr.trim()}`);
+    }
+    return result;
+}
+async function tmux(args, serverName) {
+    const result = await tmuxResult(args, serverName);
+    if (result.code !== 0) {
+        throw new Error(`tmux ${args[0]} failed (exit ${result.code}): ${result.stderr.trim() || result.stdout.trim()}`);
+    }
+    return result.stdout;
+}
+function parseVersion(versionStr) {
+    // "tmux 3.4" → [3, 4]
+    const match = versionStr.match(/(\d+)\.(\d+)/);
+    if (!match)
+        return [0, 0];
+    return [parseInt(match[1], 10), parseInt(match[2], 10)];
+}
+function isVersionAtLeast(current, minimum) {
+    const [curMajor = 0, curMinor = 0] = parseVersion(current);
+    const [minMajor = 0, minMinor = 0] = parseVersion(minimum);
+    if (curMajor !== minMajor)
+        return curMajor > minMajor;
+    return curMinor >= minMinor;
+}
+// ─── Public API ─────────────────────────────────────────────────
+/**
+ * Check if tmux is available on the system.
+ */
+export function isTmuxAvailable() {
+    return isCommandAvailable('tmux').available;
+}
+/**
+ * Get tmux version string (e.g., "tmux 3.4").
+ */
+export async function tmuxVersion() {
+    const output = await tmux(['-V']);
+    return output.trim();
+}
+/**
+ * Verify tmux is available and meets minimum version requirement.
+ *
+ * @throws Error if tmux is not available or version is too old.
+ */
+export async function verifyTmux() {
+    if (!isTmuxAvailable()) {
+        throw new Error('tmux is not installed. Install tmux (version 3.0+) for split-pane mode.');
+    }
+    const version = await tmuxVersion();
+    if (!isVersionAtLeast(version, MIN_TMUX_VERSION)) {
+        throw new Error(`tmux version ${MIN_TMUX_VERSION}+ required for split-pane mode (found: ${version}).`);
+    }
+}
+/**
+ * Get the current tmux session name (when running inside tmux).
+ */
+export async function tmuxCurrentSession() {
+    const output = await tmux(['display-message', '-p', '#{session_name}']);
+    return output.trim();
+}
+/**
+ * Get the current tmux pane ID (when running inside tmux).
+ */
+export async function tmuxCurrentPaneId() {
+    const output = await tmux(['display-message', '-p', '#{pane_id}']);
+    return output.trim();
+}
+/**
+ * Get the current tmux window target (session:window_index).
+ */
+export async function tmuxCurrentWindowTarget() {
+    const output = await tmux([
+        'display-message',
+        '-p',
+        '#{session_name}:#{window_index}',
+    ]);
+    return output.trim();
+}
+/**
+ * Check if a tmux session exists.
+ */
+export async function tmuxHasSession(name, serverName) {
+    const result = await tmuxResult(['has-session', '-t', name], serverName);
+    return result.code === 0;
+}
+/**
+ * List windows in a session.
+ */
+export async function tmuxListWindows(sessionName, serverName) {
+    const output = await tmux(['list-windows', '-t', sessionName, '-F', '#{window_name} #{window_id}'], serverName);
+    const windows = [];
+    for (const line of output.trim().split('\n')) {
+        if (!line.trim())
+            continue;
+        const [name, id] = line.trim().split(/\s+/, 2);
+        if (!name || !id)
+            continue;
+        windows.push({ name, id });
+    }
+    return windows;
+}
+/**
+ * Check if a tmux window exists within a session.
+ */
+export async function tmuxHasWindow(sessionName, windowName, serverName) {
+    const windows = await tmuxListWindows(sessionName, serverName);
+    return windows.some((w) => w.name === windowName);
+}
+/**
+ * Create a new detached tmux session.
+ */
+export async function tmuxNewSession(name, opts, serverName) {
+    const args = ['new-session', '-d', '-s', name];
+    if (opts?.windowName)
+        args.push('-n', opts.windowName);
+    if (opts?.cols)
+        args.push('-x', String(opts.cols));
+    if (opts?.rows)
+        args.push('-y', String(opts.rows));
+    await tmux(args, serverName);
+}
+/**
+ * Create a new window in an existing session.
+ */
+export async function tmuxNewWindow(targetSession, windowName, serverName) {
+    // -t session: (with trailing colon) means "create window in this session"
+    // -t session (without colon) means "create at window index = session", which fails if index exists
+    await tmux(['new-window', '-t', `${targetSession}:`, '-n', windowName], serverName);
+}
+/**
+ * Split a window/pane and return the new pane ID.
+ *
+ * @param target - Target pane/window (e.g., session:window or pane ID)
+ * @param opts.horizontal - Split horizontally (left/right) if true, vertically (top/bottom) if false
+ * @param opts.percent - Size of the new pane as a percentage (e.g., 70 for 70%)
+ * @param opts.command - Shell command to execute directly in the new pane.
+ *   When provided, the command becomes the pane's process (not a shell),
+ *   so `#{pane_dead}` is set when the command exits.
+ * @returns The pane ID of the newly created pane (e.g., '%5')
+ */
+export async function tmuxSplitWindow(target, opts, serverName) {
+    const args = ['split-window', '-t', target];
+    if (opts?.horizontal) {
+        args.push('-h');
+    }
+    if (opts?.percent !== undefined) {
+        args.push('-l', `${opts.percent}%`);
+    }
+    // -P -F: print new pane info in the specified format
+    args.push('-P', '-F', '#{pane_id}');
+    if (opts?.command) {
+        args.push(opts.command);
+    }
+    const output = await tmux(args, serverName);
+    return output.trim();
+}
+/**
+ * Send keys to a tmux pane.
+ *
+ * @param paneId - Target pane ID
+ * @param keys - Keys to send
+ * @param opts.literal - If true, use -l flag (send keys literally, don't interpret)
+ */
+export async function tmuxSendKeys(paneId, keys, opts, serverName) {
+    const args = ['send-keys', '-t', paneId];
+    if (opts?.literal) {
+        args.push('-l');
+    }
+    args.push(keys);
+    if (opts?.enter) {
+        args.push('Enter');
+    }
+    await tmux(args, serverName);
+}
+/**
+ * Select (focus) a tmux pane.
+ */
+export async function tmuxSelectPane(paneId, serverName) {
+    await tmux(['select-pane', '-t', paneId], serverName);
+}
+/**
+ * Set a pane title.
+ */
+export async function tmuxSelectPaneTitle(paneId, title, serverName) {
+    await tmux(['select-pane', '-t', paneId, '-T', title], serverName);
+}
+/**
+ * Set a pane border style via select-pane -P.
+ */
+export async function tmuxSelectPaneStyle(paneId, style, serverName) {
+    await tmux(['select-pane', '-t', paneId, '-P', style], serverName);
+}
+/**
+ * Set the layout for a target window.
+ *
+ * @param target - Target window (e.g., session:window)
+ * @param layout - Layout name: 'tiled', 'even-horizontal', 'even-vertical', etc.
+ */
+export async function tmuxSelectLayout(target, layout, serverName) {
+    await tmux(['select-layout', '-t', target, layout], serverName);
+}
+/**
+ * Capture the content of a pane (including ANSI escape codes).
+ *
+ * @returns The captured pane content as a string.
+ */
+export async function tmuxCapturePaneContent(paneId, serverName) {
+    // -p: output to stdout, -e: include escape sequences
+    return await tmux(['capture-pane', '-t', paneId, '-p', '-e'], serverName);
+}
+/**
+ * List panes in a target window/session and return parsed info.
+ *
+ * @param target - Target window (e.g., session:window)
+ * @returns Array of pane information.
+ */
+export async function tmuxListPanes(target, serverName) {
+    const output = await tmux([
+        'list-panes',
+        '-t',
+        target,
+        '-F',
+        '#{pane_id} #{pane_dead} #{pane_dead_status}',
+    ], serverName);
+    return parseTmuxListPanes(output);
+}
+/**
+ * Parse the output of `tmux list-panes -F '#{pane_id} #{pane_dead} #{pane_dead_status}'`.
+ */
+export function parseTmuxListPanes(output) {
+    const panes = [];
+    for (const line of output.trim().split('\n')) {
+        if (!line.trim())
+            continue;
+        const parts = line.trim().split(/\s+/);
+        if (parts.length < 2)
+            continue;
+        panes.push({
+            paneId: parts[0],
+            dead: parts[1] === '1',
+            deadStatus: parts[2] ? parseInt(parts[2], 10) : 0,
+        });
+    }
+    return panes;
+}
+/**
+ * Set a tmux option on a target pane/window.
+ */
+export async function tmuxSetOption(target, option, value, serverName) {
+    await tmux(['set-option', '-t', target, option, value], serverName);
+}
+/**
+ * Respawn a pane with a new command.
+ *
+ * Kills the current process in the pane and starts a new one.
+ * The command becomes the pane's direct process, so `#{pane_dead}`
+ * is set when the command exits.
+ *
+ * @param paneId - Target pane ID
+ * @param command - Shell command to execute
+ */
+export async function tmuxRespawnPane(paneId, command, serverName) {
+    await tmux(['respawn-pane', '-k', '-t', paneId, command], serverName);
+}
+/**
+ * Break a pane into a target session (detaches from current window).
+ */
+export async function tmuxBreakPane(paneId, targetSession, serverName) {
+    await tmux(['break-pane', '-s', paneId, '-t', targetSession], serverName);
+}
+/**
+ * Join a pane into a target window.
+ */
+export async function tmuxJoinPane(paneId, target, serverName) {
+    await tmux(['join-pane', '-s', paneId, '-t', target], serverName);
+}
+/**
+ * Kill a tmux pane.
+ */
+export async function tmuxKillPane(paneId, serverName) {
+    await tmux(['kill-pane', '-t', paneId], serverName);
+}
+/**
+ * Resize a tmux pane.
+ *
+ * @param paneId - Target pane ID
+ * @param opts.height - Height (number for lines, or string like '50%')
+ * @param opts.width - Width (number for columns, or string like '50%')
+ */
+export async function tmuxResizePane(paneId, opts, serverName) {
+    const args = ['resize-pane', '-t', paneId];
+    if (opts.height !== undefined) {
+        args.push('-y', String(opts.height));
+    }
+    if (opts.width !== undefined) {
+        args.push('-x', String(opts.width));
+    }
+    await tmux(args, serverName);
+}
+/**
+ * Kill a tmux session.
+ */
+export async function tmuxKillSession(name, serverName) {
+    await tmux(['kill-session', '-t', name], serverName);
+}
+/**
+ * Kill a tmux window.
+ */
+export async function tmuxKillWindow(target, serverName) {
+    await tmux(['kill-window', '-t', target], serverName);
+}
+/**
+ * Get the first pane ID of a target window.
+ */
+export async function tmuxGetFirstPaneId(target, serverName) {
+    const output = await tmux(['list-panes', '-t', target, '-F', '#{pane_id}'], serverName);
+    const firstLine = output.trim().split('\n')[0];
+    if (!firstLine) {
+        throw new Error(`No panes found in target: ${target}`);
+    }
+    return firstLine.trim();
+}
+//# sourceMappingURL=tmux-commands.js.map

package/dist/CLI/packages/core/src/agents/backends/tmux-commands.js.map

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

package/dist/CLI/packages/core/src/agents/backends/types.d.ts

@@ -0,0 +1,227 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview Shared types for multi-agent systems (Arena, Team, Swarm)
+ * and the Backend abstraction layer.
+ *
+ * These types are used across different agent orchestration modes.
+ */
+import type { Content } from '@google/genai';
+import type { AnsiOutput } from '../../utils/terminalSerializer.js';
+import type { PromptConfig, ModelConfig, RunConfig, ToolConfig } from '../runtime/agent-types.js';
+/**
+ * Canonical display mode values shared across core and CLI.
+ */
+export declare const DISPLAY_MODE: {
+    readonly IN_PROCESS: "in-process";
+    readonly TMUX: "tmux";
+    readonly ITERM2: "iterm2";
+};
+/**
+ * Supported display mode values.
+ */
+export type DisplayMode = (typeof DISPLAY_MODE)[keyof typeof DISPLAY_MODE];
+/**
+ * Configuration for spawning an agent subprocess.
+ */
+export interface AgentSpawnConfig {
+    /** Unique identifier for this agent */
+    agentId: string;
+    /** Command to execute (e.g., the CLI binary path) */
+    command: string;
+    /** Arguments to pass to the command */
+    args: string[];
+    /** Working directory for the subprocess */
+    cwd: string;
+    /** Additional environment variables (merged with process.env) */
+    env?: Record<string, string>;
+    /** Terminal columns (default: 120) */
+    cols?: number;
+    /** Terminal rows (default: 40) */
+    rows?: number;
+    /**
+     * Backend-specific options (optional).
+     * These are ignored by backends that do not support them.
+     */
+    backend?: {
+        tmux?: TmuxBackendOptions;
+    };
+    /**
+     * In-process spawn configuration (optional).
+     * When provided, InProcessBackend uses this to create an AgentInteractive
+     * instead of launching a PTY subprocess.
+     */
+    inProcess?: InProcessSpawnConfig;
+}
+/**
+ * Configuration for spawning an in-process agent (no PTY subprocess).
+ */
+export interface InProcessSpawnConfig {
+    /** Human-readable agent name for display. */
+    agentName: string;
+    /** Optional initial task to start working on immediately. */
+    initialTask?: string;
+    /** Runtime configuration for the AgentCore. */
+    runtimeConfig: {
+        promptConfig: PromptConfig;
+        modelConfig: ModelConfig;
+        runConfig: RunConfig;
+        toolConfig?: ToolConfig;
+    };
+    /**
+     * Per-agent auth/provider overrides. When present, a dedicated
+     * ContentGenerator is created for this agent instead of inheriting
+     * the parent process's. This enables Arena agents to target different
+     * model providers (OpenAI, Anthropic, Gemini, etc.) in the same session.
+     */
+    authOverrides?: {
+        authType: string;
+        apiKey?: string;
+        baseUrl?: string;
+    };
+    /**
+     * Optional chat history from the parent session. When provided, this
+     * history is prepended to the agent's chat so it has conversational
+     * context from the session that spawned it.
+     */
+    chatHistory?: Content[];
+}
+/**
+ * Callback for agent exit events.
+ */
+export type AgentExitCallback = (agentId: string, exitCode: number | null, signal: number | null) => void;
+/**
+ * Backend abstracts the display/pane management layer for multi-agent systems.
+ *
+ * Each display mode (in-process / tmux / iTerm2) implements this interface. The orchestration
+ * layer (Arena, Team, etc.) delegates all pane operations through the backend,
+ * making the display mode transparent.
+ */
+export interface Backend {
+    /** Backend type identifier. */
+    readonly type: DisplayMode;
+    /**
+     * Initialize the backend.
+     * - in-process: runs in the current process (not yet implemented)
+     * - tmux: verifies tmux availability, creates session
+     * - iTerm2: verifies iTerm2 is running
+     */
+    init(): Promise<void>;
+    /**
+     * Spawn a new agent subprocess.
+     *
+     * @param config - Agent spawn configuration (command, args, cwd, env, etc.)
+     * @returns Promise that resolves when the agent's pane/PTY is created and ready.
+     */
+    spawnAgent(config: AgentSpawnConfig): Promise<void>;
+    /**
+     * Stop a specific agent.
+     */
+    stopAgent(agentId: string): void;
+    /**
+     * Stop all running agents.
+     */
+    stopAll(): void;
+    /**
+     * Clean up all resources (kill processes, destroy panes/sessions).
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Register a callback for agent exit events.
+     */
+    setOnAgentExit(callback: AgentExitCallback): void;
+    /**
+     * Wait for all agents to exit, with an optional timeout.
+     *
+     * @returns true if all agents exited, false if timeout was reached.
+     */
+    waitForAll(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Switch the active agent for screen capture and input routing.
+     */
+    switchTo(agentId: string): void;
+    /**
+     * Switch to the next agent in order.
+     */
+    switchToNext(): void;
+    /**
+     * Switch to the previous agent in order.
+     */
+    switchToPrevious(): void;
+    /**
+     * Get the ID of the currently active agent.
+     */
+    getActiveAgentId(): string | null;
+    /**
+     * Get the screen snapshot for the currently active agent.
+     *
+     * @returns AnsiOutput or null if no active agent or not supported.
+     */
+    getActiveSnapshot(): AnsiOutput | null;
+    /**
+     * Get the screen snapshot for a specific agent.
+     *
+     * @param agentId - Agent to capture
+     * @param scrollOffset - Lines to scroll back from viewport (default: 0)
+     * @returns AnsiOutput or null if not found or not supported.
+     */
+    getAgentSnapshot(agentId: string, scrollOffset?: number): AnsiOutput | null;
+    /**
+     * Get the maximum scrollback length for an agent's terminal buffer.
+     *
+     * @returns Number of scrollable lines, or 0 if not supported.
+     */
+    getAgentScrollbackLength(agentId: string): number;
+    /**
+     * Forward input to the currently active agent's PTY stdin.
+     *
+     * @returns true if input was forwarded, false otherwise.
+     */
+    forwardInput(data: string): boolean;
+    /**
+     * Write input to a specific agent's PTY stdin.
+     *
+     * @returns true if input was written, false otherwise.
+     */
+    writeToAgent(agentId: string, data: string): boolean;
+    /**
+     * Resize all agent terminals/panes.
+     */
+    resizeAll(cols: number, rows: number): void;
+    /**
+     * Get a user-facing hint for how to attach to the external display session.
+     *
+     * When the backend runs in external mode (e.g., a detached tmux server),
+     * this returns a shell command the user can run to view the agent panes.
+     * Returns null if not applicable (e.g., running inside tmux or iTerm2).
+     */
+    getAttachHint(): string | null;
+}
+/**
+ * Optional tmux backend configuration.
+ */
+export interface TmuxBackendOptions {
+    /** tmux server name for -L (when running outside tmux) */
+    serverName?: string;
+    /** tmux session name to use/create (when running outside tmux) */
+    sessionName?: string;
+    /** tmux window name to use/create (when running outside tmux) */
+    windowName?: string;
+    /** Pane title for this agent */
+    paneTitle?: string;
+    /** Border style for inactive panes (tmux style string, e.g. "fg=blue") */
+    paneBorderStyle?: string;
+    /** Border style for active pane (tmux style string, e.g. "fg=green,bold") */
+    paneActiveBorderStyle?: string;
+    /** Pane border format (default: "#{pane_title}") */
+    paneBorderFormat?: string;
+    /** Pane border status location */
+    paneBorderStatus?: 'top' | 'bottom' | 'off';
+    /** Leader pane width percentage (default: 30) */
+    leaderPaneWidthPercent?: number;
+    /** First split percent when inside tmux (default: 70) */
+    firstSplitPercent?: number;
+}

package/dist/CLI/packages/core/src/agents/backends/types.js

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Canonical display mode values shared across core and CLI.
+ */
+export const DISPLAY_MODE = {
+    IN_PROCESS: 'in-process',
+    TMUX: 'tmux',
+    ITERM2: 'iterm2',
+};
+//# sourceMappingURL=types.js.map

package/dist/CLI/packages/core/src/agents/backends/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../../core/src/agents/backends/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;CACR,CAAC"}

package/dist/CLI/packages/core/src/agents/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview Multi-agent infrastructure shared across Arena, Team, and Swarm modes.
+ *
+ * This module provides the common building blocks for managing multiple concurrent
+ * agent subprocesses:
+ * - Backend: Display abstraction (tmux, iTerm2)
+ * - Shared types for agent spawning and lifecycle
+ */
+export * from './backends/index.js';
+export * from './arena/index.js';
+export * from './runtime/index.js';

package/dist/CLI/packages/core/src/agents/index.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview Multi-agent infrastructure shared across Arena, Team, and Swarm modes.
+ *
+ * This module provides the common building blocks for managing multiple concurrent
+ * agent subprocesses:
+ * - Backend: Display abstraction (tmux, iTerm2)
+ * - Shared types for agent spawning and lifecycle
+ */
+export * from './backends/index.js';
+export * from './arena/index.js';
+export * from './runtime/index.js';
+//# sourceMappingURL=index.js.map

package/dist/CLI/packages/core/src/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../core/src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}