@a5c-ai/agent-comm-mux 5.0.1-staging.04ca6ab00d21

package/dist/adapter.d.ts

@@ -0,0 +1,248 @@
+/**
+ * AgentAdapter interface, SpawnArgs, ParseContext, and related types.
+ *
+ * @see 05-adapter-system.md §2, §3
+ */
+import type { AgentName } from './types.js';
+import type { AgentCapabilities, ModelCapabilities } from './capabilities.js';
+import type { RunOptions } from './run-options.js';
+import type { AgentEvent } from './events.js';
+import type { StreamAssembler } from './stream-assembler.js';
+import type { InstalledPlugin, PluginInstallOptions, PluginSearchOptions, PluginListing } from './plugin-types.js';
+import type { RuntimeHookDispatcher, RuntimeHookSetup } from './runtime-hooks.js';
+export type { Session, SessionMessage, SessionToolCall, SessionSummary, FullSession, SessionListOptions, SessionQuery, CostAggregationOptions, CostSummary, CostBreakdown, SessionDiff, DiffOperation } from './session-types.js';
+import type { Session } from './session-types.js';
+export type { AuthState, AuthSetupGuidance, AuthMethod, AuthSetupStep, AuthEnvVar } from './auth-types.js';
+import type { AuthState } from './auth-types.js';
+import type { AuthSetupGuidance } from './auth-types.js';
+export type { AgentConfig, AgentConfigSchema, ConfigField, ValidationResult, ConfigValidationError, ConfigValidationWarning } from './config-types.js';
+import type { AgentConfig } from './config-types.js';
+import type { AgentConfigSchema } from './config-types.js';
+export type { InstalledPlugin, PluginInstallOptions, PluginSearchOptions, PluginListing, } from './plugin-types.js';
+/**
+ * Describes exactly how to spawn an agent subprocess.
+ * Returned by AgentAdapter.buildSpawnArgs().
+ */
+export interface SpawnArgs {
+    /** The command to execute. */
+    command: string;
+    /** Array of CLI arguments. */
+    args: string[];
+    /** Environment variables for the subprocess. */
+    env: Record<string, string>;
+    /** Working directory for the subprocess. */
+    cwd: string;
+    /** Whether the subprocess requires a pseudo-terminal (PTY). */
+    usePty: boolean;
+    /** Standard input to pipe into the subprocess after spawn. */
+    stdin?: string;
+    /**
+     * Close stdin immediately after launch setup completes.
+     * Useful for CLIs that inspect stdin and block until EOF even when the
+     * primary prompt is supplied via command-line arguments.
+     */
+    closeStdinAfterSpawn?: boolean;
+    /** Timeout in milliseconds for entire subprocess execution. */
+    timeout?: number;
+    /** Inactivity timeout in milliseconds. */
+    inactivityTimeout?: number;
+    /** Shell mode — execute via system shell. */
+    shell?: boolean;
+}
+/**
+ * Contextual state passed to AgentAdapter.parseEvent() on every line.
+ */
+export interface ParseContext {
+    /** The run ID for the current run. */
+    runId: string;
+    /** The agent name. */
+    agent: AgentName;
+    /** The session ID, if one has been established. */
+    sessionId: string | undefined;
+    /** Zero-based index of the current turn. */
+    turnIndex: number;
+    /** Whether debug mode is active. */
+    debug: boolean;
+    /** The output format requested in RunOptions.outputFormat. */
+    outputFormat: 'text' | 'json' | 'jsonl';
+    /** Whether the line came from stdout or stderr. */
+    source: 'stdout' | 'stderr';
+    /** The StreamAssembler instance for this run. */
+    assembler: StreamAssembler;
+    /** Total number of events emitted so far in this run. */
+    eventCount: number;
+    /** The last event type emitted, or null if no events have been emitted yet. */
+    lastEventType: string | null;
+    /** Adapter-managed state bag. */
+    adapterState: Record<string, unknown>;
+}
+/**
+ * Result of detecting whether a specific agent is installed and functional.
+ */
+export interface InstalledAgentInfo {
+    /** The agent identifier. */
+    agent: AgentName;
+    /** Whether the agent CLI binary was found on PATH. */
+    installed: boolean;
+    /** Absolute path to the CLI binary, or null if not found. */
+    cliPath: string | null;
+    /** Detected version string, or null. */
+    version: string | null;
+    /** Whether the detected version meets the adapter's minVersion requirement. */
+    meetsMinVersion: boolean;
+    /** The minimum version required by the adapter. */
+    minVersion: string;
+    /** Current authentication state for this agent. */
+    authState: 'authenticated' | 'unauthenticated' | 'expired' | 'unknown';
+    /** The currently active/default model, or null. */
+    activeModel: string | null;
+}
+/**
+ * Lightweight descriptor of a registered adapter.
+ */
+export interface AgentAdapterInfo {
+    /** The agent identifier. */
+    agent: AgentName;
+    /** Human-readable display name. */
+    displayName: string;
+    /** The CLI command used to invoke this agent. */
+    cliCommand: string;
+    /** Minimum CLI version required, if any. */
+    minVersion: string | undefined;
+    /** Whether this adapter was registered as a built-in or plugin. */
+    source: 'built-in' | 'plugin';
+}
+/** Result of `AgentAdapter.detectInstallation()`. */
+export interface DetectInstallationResult {
+    /** Whether the harness binary was found on PATH (or equivalent). */
+    installed: boolean;
+    /** Detected version string, if obtainable. */
+    version?: string;
+    /** Absolute path to the binary, if located. */
+    path?: string;
+    /** Optional diagnostic notes (e.g. config dir discovered). */
+    notes?: string;
+}
+/** Result of `AgentAdapter.install()` / `update()`. */
+export interface InstallResult {
+    /** Whether the operation succeeded. */
+    ok: boolean;
+    /** High-level method chosen (`npm`, `brew`, `manual`, `ssh`, `dry-run`, ...). */
+    method: string;
+    /** Command string that was (or would be) executed. */
+    command: string;
+    /** Captured stdout, if the command ran. */
+    stdout?: string;
+    /** Captured stderr, if the command ran. */
+    stderr?: string;
+    /** Version detected after a successful install. */
+    installedVersion?: string;
+    /** Human-readable message (e.g. manual install instructions). */
+    message?: string;
+}
+/** Options for `AgentAdapter.install()`. */
+export interface AdapterInstallOptions {
+    /** Explicit version tag to pin (npm only; falls through when unsupported). */
+    version?: string;
+    /** Reinstall even if already detected. */
+    force?: boolean;
+    /** Print the planned command without executing. */
+    dryRun?: boolean;
+}
+/** Options for `AgentAdapter.update()`. */
+export interface AdapterUpdateOptions {
+    /** Print the planned command without executing. */
+    dryRun?: boolean;
+}
+/**
+ * Pluggable subprocess runner used by install/update/detect.
+ * Tests replace this to avoid hitting the real system.
+ */
+export type Spawner = (command: string, args: string[], options?: {
+    env?: Record<string, string>;
+    cwd?: string;
+}) => Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * The full contract for an agent adapter.
+ */
+export interface AgentAdapter {
+    readonly agent: AgentName;
+    readonly displayName: string;
+    readonly cliCommand: string;
+    readonly minVersion?: string;
+    readonly capabilities: AgentCapabilities;
+    readonly models: ModelCapabilities[];
+    readonly defaultModelId?: string;
+    readonly configSchema: AgentConfigSchema;
+    buildSpawnArgs(options: RunOptions): SpawnArgs;
+    parseEvent(line: string, context: ParseContext): AgentEvent | AgentEvent[] | null;
+    detectAuth(): Promise<AuthState>;
+    getAuthGuidance(): AuthSetupGuidance;
+    sessionDir(cwd?: string): string;
+    parseSessionFile(filePath: string): Promise<Session>;
+    listSessionFiles(cwd?: string): Promise<string[]>;
+    readConfig(cwd?: string): Promise<AgentConfig>;
+    writeConfig(config: Partial<AgentConfig>, cwd?: string): Promise<void>;
+    /** Optional adapter-native model discovery hook used by ModelRegistry.refresh(). */
+    discoverModels?(cwd?: string): Promise<ModelCapabilities[]>;
+    /** Translate a provider config into harness-specific env vars and args. */
+    translateProvider?(config: Record<string, unknown>): {
+        env: Record<string, string>;
+        args: string[];
+        proxyRequired: boolean;
+        proxyExposedTransport?: string;
+    };
+    /** Env-var names that indicate the current process is running under this harness. */
+    readonly hostEnvSignals?: readonly string[];
+    /** Extract adapter-specific metadata (session_id, run_id, etc.) from an env snapshot. */
+    readHostMetadata?(env: NodeJS.ProcessEnv): Record<string, string | number | boolean | null>;
+    /** Detects whether the harness binary is installed. */
+    detectInstallation?(): Promise<DetectInstallationResult>;
+    /** Installs the harness binary. */
+    install?(opts?: AdapterInstallOptions): Promise<InstallResult>;
+    /** Updates the harness binary. */
+    update?(opts?: AdapterUpdateOptions): Promise<InstallResult>;
+    /** Native hook type names this harness supports (see HOOK_CATALOG). */
+    readonly supportedHookTypes?: readonly string[];
+    /**
+     * Install a hook into the harness's native config (e.g. claude's
+     * ~/.claude/settings.json). Default implementation in BaseAdapter
+     * only writes to .amux/hooks.json — override to also wire the
+     * harness natively so it actually fires the hook.
+     */
+    installHook?(hookType: string, command: string, opts?: {
+        scope?: 'global' | 'project';
+        id?: string;
+    }): Promise<void>;
+    /** Remove a hook installed by `installHook`. */
+    uninstallHook?(id: string, opts?: {
+        scope?: 'global' | 'project';
+    }): Promise<boolean>;
+    /**
+     * Optional per-run native runtime-hook bridge setup for harnesses that can
+     * invoke external hook commands before or after internal actions.
+     */
+    setupRuntimeHooks?(options: RunOptions, dispatcher: RuntimeHookDispatcher): Promise<RuntimeHookSetup | void>;
+    listPlugins?(): Promise<InstalledPlugin[]>;
+    installPlugin?(pluginId: string, options?: PluginInstallOptions): Promise<InstalledPlugin>;
+    uninstallPlugin?(pluginId: string, options?: {
+        global?: boolean;
+    }): Promise<void>;
+    searchPlugins?(query: string, options?: PluginSearchOptions): Promise<PluginListing[]>;
+}
+export type { BaseAgentAdapterInterface, SubprocessAdapter, RemoteAdapter, ProgrammaticAdapter, RemoteConnection, HttpConnection, WebSocketConnection, WebSocketMessage, ServerOptions, ServerInfo, ServerHealth, ServerManager, AgentAdapter as MultiAgentAdapter, } from './adapter-types.js';
+export { isSubprocessAdapter, isRemoteAdapter, isProgrammaticAdapter, isHttpConnection, isWebSocketConnection, } from './adapter-types.js';
+/**
+ * Legacy AgentAdapter interface - equivalent to SubprocessAdapter in new architecture.
+ *
+ * @deprecated For new adapters, import specific types from './adapter-types.js':
+ *   - SubprocessAdapter (CLI tools)
+ *   - RemoteAdapter (HTTP/WebSocket)
+ *   - ProgrammaticAdapter (direct SDK)
+ *
+ * This interface is maintained for backward compatibility with existing adapters.
+ */

package/dist/adapter.d.ts.map

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

package/dist/adapter.js

@@ -0,0 +1,18 @@
+/**
+ * AgentAdapter interface, SpawnArgs, ParseContext, and related types.
+ *
+ * @see 05-adapter-system.md §2, §3
+ */
+export { isSubprocessAdapter, isRemoteAdapter, isProgrammaticAdapter, isHttpConnection, isWebSocketConnection, } from './adapter-types.js';
+/**
+ * Legacy AgentAdapter interface - equivalent to SubprocessAdapter in new architecture.
+ *
+ * @deprecated For new adapters, import specific types from './adapter-types.js':
+ *   - SubprocessAdapter (CLI tools)
+ *   - RemoteAdapter (HTTP/WebSocket)
+ *   - ProgrammaticAdapter (direct SDK)
+ *
+ * This interface is maintained for backward compatibility with existing adapters.
+ */
+// Note: This interface is still the "AgentAdapter" used by existing code
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6WH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;GASG;AACH,yEAAyE"}

package/dist/atomic-fs.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Atomic filesystem helpers — the single source of truth for durable
+ * config/session writes across `@a5c-ai/agent-mux`.
+ *
+ * Guarantees:
+ *  - Writes are atomic: a concurrent reader observes either the old or the
+ *    new bytes, never a torn intermediate.
+ *  - Writes are durable: data + directory entry are fsynced before rename.
+ *  - Concurrent writers serialise through an advisory lockfile (`<path>.lock`)
+ *    which records the holder's PID and a monotonic timestamp. Stale locks
+ *    (holder dead or older than `staleMs`) are forcibly reclaimed.
+ *
+ * These primitives have no runtime dependencies beyond Node built-ins and
+ * work identically on Windows, macOS, and Linux.
+ *
+ * @see docs/08-config-and-auth.md
+ */
+export interface AtomicWriteOptions {
+    /** Acquire an advisory lock before writing. @default true */
+    readonly lock?: boolean;
+    /** Max time to wait for a lock, in ms. @default 5000 */
+    readonly lockTimeoutMs?: number;
+    /** Lock is considered stale after this many ms without refresh. @default 30000 */
+    readonly staleMs?: number;
+    /** fsync the file after write. @default true */
+    readonly fsync?: boolean;
+    /** File mode for writeFile. */
+    readonly mode?: number;
+}
+/** Write `data` to `filePath` atomically (tmp + fsync + rename). */
+export declare function writeFileAtomic(filePath: string, data: string | Uint8Array, opts?: AtomicWriteOptions): Promise<void>;
+/** Write `data` as pretty-printed JSON atomically. */
+export declare function writeJsonAtomic(filePath: string, data: unknown, opts?: AtomicWriteOptions): Promise<void>;

package/dist/atomic-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-fs.d.ts","sourceRoot":"","sources":["../src/atomic-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AA0HD,oEAAoE;AACpE,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAED,sDAAsD;AACtD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/atomic-fs.js

@@ -0,0 +1,190 @@
+/**
+ * Atomic filesystem helpers — the single source of truth for durable
+ * config/session writes across `@a5c-ai/agent-mux`.
+ *
+ * Guarantees:
+ *  - Writes are atomic: a concurrent reader observes either the old or the
+ *    new bytes, never a torn intermediate.
+ *  - Writes are durable: data + directory entry are fsynced before rename.
+ *  - Concurrent writers serialise through an advisory lockfile (`<path>.lock`)
+ *    which records the holder's PID and a monotonic timestamp. Stale locks
+ *    (holder dead or older than `staleMs`) are forcibly reclaimed.
+ *
+ * These primitives have no runtime dependencies beyond Node built-ins and
+ * work identically on Windows, macOS, and Linux.
+ *
+ * @see docs/08-config-and-auth.md
+ */
+import * as fs from 'node:fs/promises';
+import * as fsSync from 'node:fs';
+import * as path from 'node:path';
+/** Check if a process with the given pid is alive on this host. */
+function isPidAlive(pid) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    if (pid === process.pid)
+        return true;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const code = err.code;
+        // EPERM means the process exists but we can't signal it.
+        return code === 'EPERM';
+    }
+}
+async function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/**
+ * Rename with retry. On Windows, `rename` can briefly fail with EPERM/EBUSY
+ * if a concurrent reader has the target open (sharing-violation). The rename
+ * itself is still atomic from the filesystem's perspective — we just retry
+ * the call until the transient handle-sharing conflict clears.
+ */
+async function renameWithRetry(from, to) {
+    const maxAttempts = 40;
+    let delay = 2;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            await fs.rename(from, to);
+            return;
+        }
+        catch (err) {
+            const code = err.code;
+            if (attempt === maxAttempts || (code !== 'EPERM' && code !== 'EBUSY' && code !== 'EACCES')) {
+                throw err;
+            }
+            await sleep(delay);
+            delay = Math.min(delay * 2, 50);
+        }
+    }
+}
+async function tryAcquireLock(lockPath, staleMs) {
+    const payload = {
+        pid: process.pid,
+        host: 'local',
+        at: Date.now(),
+    };
+    const body = JSON.stringify(payload);
+    try {
+        // wx = fail if exists; O_EXCL-equivalent.
+        const handle = await fs.open(lockPath, 'wx');
+        try {
+            await handle.writeFile(body, 'utf8');
+        }
+        finally {
+            await handle.close();
+        }
+        return true;
+    }
+    catch (err) {
+        if (err.code !== 'EEXIST')
+            throw err;
+    }
+    // Lockfile exists — inspect for staleness.
+    let raw;
+    try {
+        raw = await fs.readFile(lockPath, 'utf8');
+    }
+    catch {
+        // Lock disappeared between check and read — retry on next tick.
+        return false;
+    }
+    let parsed = null;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        parsed = null;
+    }
+    const age = parsed?.at ? Date.now() - parsed.at : Infinity;
+    const holderAlive = typeof parsed?.pid === 'number' && isPidAlive(parsed.pid);
+    if (!holderAlive || age > staleMs) {
+        // Reclaim: remove stale lock then try to acquire fresh.
+        try {
+            await fs.unlink(lockPath);
+        }
+        catch {
+            // Someone else reclaimed first; fall through and retry.
+        }
+        return false;
+    }
+    return false;
+}
+async function acquireLock(lockPath, timeoutMs, staleMs) {
+    const start = Date.now();
+    let delay = 5;
+    // Ensure parent dir exists so we can create the lock.
+    await fs.mkdir(path.dirname(lockPath), { recursive: true });
+    while (true) {
+        if (await tryAcquireLock(lockPath, staleMs))
+            return;
+        if (Date.now() - start >= timeoutMs) {
+            throw new Error(`atomic-fs: timed out acquiring lock ${lockPath} after ${timeoutMs}ms`);
+        }
+        await sleep(delay);
+        delay = Math.min(delay * 2, 100);
+    }
+}
+async function releaseLock(lockPath) {
+    try {
+        await fs.unlink(lockPath);
+    }
+    catch {
+        // Best-effort.
+    }
+}
+/** Write `data` to `filePath` atomically (tmp + fsync + rename). */
+export async function writeFileAtomic(filePath, data, opts = {}) {
+    const { lock = true, lockTimeoutMs = 5000, staleMs = 30000, fsync = true, mode, } = opts;
+    const lockPath = `${filePath}.lock`;
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    if (lock)
+        await acquireLock(lockPath, lockTimeoutMs, staleMs);
+    try {
+        const tmp = `${filePath}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const handle = await fs.open(tmp, 'w', mode);
+        try {
+            await handle.writeFile(data);
+            if (fsync) {
+                try {
+                    await handle.sync();
+                }
+                catch {
+                    // Some filesystems (e.g. tmpfs on certain configs) don't support fsync.
+                }
+            }
+        }
+        finally {
+            await handle.close();
+        }
+        await renameWithRetry(tmp, filePath);
+        if (fsync) {
+            // Best-effort fsync of the parent directory so the rename is durable.
+            try {
+                const dir = fsSync.openSync(path.dirname(filePath), 'r');
+                try {
+                    fsSync.fsyncSync(dir);
+                }
+                finally {
+                    fsSync.closeSync(dir);
+                }
+            }
+            catch {
+                // Directory fsync isn't supported on Windows; ignore EPERM/EISDIR/EINVAL.
+            }
+        }
+    }
+    finally {
+        if (lock)
+            await releaseLock(lockPath);
+    }
+}
+/** Write `data` as pretty-printed JSON atomically. */
+export async function writeJsonAtomic(filePath, data, opts = {}) {
+    const body = JSON.stringify(data, null, 2);
+    await writeFileAtomic(filePath, body, opts);
+}
+//# sourceMappingURL=atomic-fs.js.map

package/dist/atomic-fs.js.map

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

package/dist/auth-manager.d.ts

@@ -0,0 +1,37 @@
+/**
+ * AuthManager interface and implementation for @a5c-ai/agent-mux.
+ *
+ * Provides read-only authentication state detection and setup guidance
+ * for all supported agents. Delegates detection to agent adapters.
+ *
+ * @see 08-config-and-auth.md
+ */
+import type { AgentName } from './types.js';
+import type { AdapterRegistry } from './adapter-registry.js';
+export type { AuthMethod as AuthMethodType, AuthState as FullAuthState, AuthSetupGuidance as FullAuthSetupGuidance, AuthSetupStep, AuthEnvVar, } from './auth-types.js';
+import type { AuthState } from './auth-types.js';
+import type { AuthSetupGuidance } from './auth-types.js';
+/** Authentication state detection and setup guidance. */
+export interface AuthManager {
+    /** Check authentication state for a single agent. */
+    check(agent: AgentName): Promise<AuthState>;
+    /** Check authentication state for all registered agents. */
+    checkAll(): Promise<Record<string, AuthState>>;
+    /** Get structured setup guidance for authenticating with an agent. */
+    getSetupGuidance(agent: AgentName): AuthSetupGuidance;
+}
+/**
+ * Implementation of AuthManager.
+ *
+ * Delegates detection to adapter.detectAuth() and guidance to
+ * adapter.getAuthGuidance(). Each call to check() performs a fresh
+ * detection (no caching).
+ */
+export declare class AuthManagerImpl implements AuthManager {
+    private readonly _adapters;
+    constructor(adapters: AdapterRegistry);
+    private _getAdapter;
+    check(agent: AgentName): Promise<AuthState>;
+    checkAll(): Promise<Record<string, AuthState>>;
+    getSetupGuidance(agent: AgentName): AuthSetupGuidance;
+}

package/dist/auth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../src/auth-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D,YAAY,EACV,UAAU,IAAI,cAAc,EAC5B,SAAS,IAAI,aAAa,EAC1B,iBAAiB,IAAI,qBAAqB,EAC1C,aAAa,EACb,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMzD,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE5C,4DAA4D;IAC5D,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAE/C,sEAAsE;IACtE,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,iBAAiB,CAAC;CACvD;AAMD;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;gBAEhC,QAAQ,EAAE,eAAe;IAMrC,OAAO,CAAC,WAAW;IAUb,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAsC3C,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAwBpD,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,iBAAiB;CAItD"}

package/dist/auth-manager.js

@@ -0,0 +1,94 @@
+/**
+ * AuthManager interface and implementation for @a5c-ai/agent-mux.
+ *
+ * Provides read-only authentication state detection and setup guidance
+ * for all supported agents. Delegates detection to agent adapters.
+ *
+ * @see 08-config-and-auth.md
+ */
+import { AgentMuxError } from './errors.js';
+import { telemetry } from '@a5c-ai/agent-mux-observability';
+// ---------------------------------------------------------------------------
+// AuthManagerImpl
+// ---------------------------------------------------------------------------
+/**
+ * Implementation of AuthManager.
+ *
+ * Delegates detection to adapter.detectAuth() and guidance to
+ * adapter.getAuthGuidance(). Each call to check() performs a fresh
+ * detection (no caching).
+ */
+export class AuthManagerImpl {
+    _adapters;
+    constructor(adapters) {
+        this._adapters = adapters;
+    }
+    // -- Helper ------------------------------------------------------------------
+    _getAdapter(agent) {
+        const adapter = this._adapters.get(agent);
+        if (!adapter) {
+            throw new AgentMuxError('AGENT_NOT_FOUND', `Unknown agent: "${agent}"`);
+        }
+        return adapter;
+    }
+    // -- check() -----------------------------------------------------------------
+    async check(agent) {
+        const span = telemetry.getTracer?.()?.startSpan(`auth.check.${agent}`);
+        const adapter = this._getAdapter(agent);
+        try {
+            const rawState = await adapter.detectAuth();
+            const state = {
+                agent,
+                status: rawState.status,
+                method: rawState.method,
+                identity: rawState.identity,
+                expiresAt: rawState.expiresAt
+                    ? (rawState.expiresAt instanceof Date ? rawState.expiresAt : new Date(rawState.expiresAt))
+                    : undefined,
+                checkedAt: new Date(),
+            };
+            if (span) {
+                span.setAttributes({
+                    status: state.status,
+                    method: state.method || 'unknown',
+                });
+                telemetry.endSpanSuccess(span);
+            }
+            telemetry.recordAuthEvent(agent, state.method || 'unknown', state.status === 'authenticated');
+            return state;
+        }
+        catch (err) {
+            if (span) {
+                telemetry.endSpanError(span, err);
+            }
+            throw err;
+        }
+    }
+    // -- checkAll() --------------------------------------------------------------
+    async checkAll() {
+        const adapters = this._adapters.list();
+        const results = {};
+        const checks = adapters.map(async (info) => {
+            try {
+                const state = await this.check(info.agent);
+                results[info.agent] = state;
+            }
+            catch {
+                results[info.agent] = {
+                    agent: info.agent,
+                    status: 'unknown',
+                    checkedAt: new Date(),
+                    details: 'Auth detection failed',
+                };
+            }
+        });
+        await Promise.all(checks);
+        return results;
+    }
+    // -- getSetupGuidance() ------------------------------------------------------
+    getSetupGuidance(agent) {
+        const adapter = this._getAdapter(agent);
+        return adapter.getAuthGuidance();
+    }
+}
+//# sourceMappingURL=auth-manager.js.map

package/dist/auth-manager.js.map

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