@a5c-ai/agent-comm-mux 5.0.1-staging.016f0b0e8119

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 a5c-ai
+
+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,99 @@
+# @a5c-ai/agent-comm-mux
+
+This README is the canonical package documentation for `@a5c-ai/agent-comm-mux`.
+Canonical package doc path: `packages/agent-mux/core/README.md`.
+The repository reference mirror lives at `docs/agent-mux/reference/01-core-types-and-client.md` and
+should match this file for package identity, runtime dependencies, and import guidance.
+
+`@a5c-ai/agent-comm-mux` is the public Node.js core runtime package at
+`packages/agent-mux/core/` for agent-mux. It ships:
+
+- the main Node entrypoint with `AgentMuxClient`, `createClient`, normalized events,
+  run/session/config/auth/plugin contracts, provider and hook helpers, workspace
+  services, and atomic filesystem helpers
+- `@a5c-ai/agent-comm-mux/browser` for browser-safe type exports plus `classifyTool`
+- `@a5c-ai/agent-comm-mux/kanban` for kanban/project/workspace planning types and helpers
+- `@a5c-ai/agent-comm-mux/automation` for automation rule, trigger, routing, and execution record types
+
+## Install
+
+```bash
+npm install @a5c-ai/agent-comm-mux
+```
+
+Requires Node.js `>=20.9.0`.
+
+This package is published as ESM. The export map exposes `import`, `require`, and
+`default` conditions, but they all resolve to the same ESM build. Use `import`
+from ESM projects. From CommonJS, load it with `await import('@a5c-ai/agent-comm-mux')`
+instead of expecting a separate CJS bundle.
+
+Runtime dependencies are part of the package contract:
+
+- `@a5c-ai/agent-catalog` provides the harness image catalog plus host-detection
+  rules and metadata used by invocation and host helpers
+- `@a5c-ai/agent-mux-observability` provides the structured logging and telemetry
+  primitives used by the client, auth/session flows, and run-handle implementation
+
+## Usage
+
+```ts
+import {
+  createClient,
+  resolveProvider,
+  resolveRunOptions,
+  type AuthMethodDescriptor,
+  type PluginInfo,
+} from '@a5c-ai/agent-comm-mux';
+
+const client = createClient();
+```
+
+```ts
+import { classifyTool, type AgentEvent } from '@a5c-ai/agent-comm-mux/browser';
+import { buildKanbanProjectBoard } from '@a5c-ai/agent-comm-mux/kanban';
+import { type AutomationRule } from '@a5c-ai/agent-comm-mux/automation';
+```
+
+The public surface is grouped around:
+
+- client/runtime entry points such as `AgentMuxClient` and `createClient`
+- run, auth, hook, provider, and capability contracts such as `RunOptions`,
+  `AuthMethodDescriptor`, `HookRegistration`, and `ProviderConfig`
+- plugin contracts such as `PluginInfo`, `PluginListing`, and `PluginBrowseOptions`
+- workspace, merge, and filesystem helpers such as `WorkspaceService`,
+  `resolveRunOptions`, and `writeFileAtomic`
+
+The supported public import seams are:
+
+- `@a5c-ai/agent-comm-mux`
+- `@a5c-ai/agent-comm-mux/browser`
+- `@a5c-ai/agent-comm-mux/kanban`
+- `@a5c-ai/agent-comm-mux/automation`
+
+## Release Verification
+
+Use the package-local release checks to confirm the documented export map still
+matches the packed package surface:
+
+```bash
+npm run build --workspace=@a5c-ai/agent-comm-mux
+npm run test --workspace=@a5c-ai/agent-comm-mux
+npm run verify:release --workspace=@a5c-ai/agent-comm-mux
+npm pack --json --dry-run --workspace=@a5c-ai/agent-comm-mux
+```
+
+Release reviewers should be able to confirm from this README that the package
+intentionally publishes the root, `browser`, `kanban`, and `automation`
+subpaths and that all of them remain backed by `dist/*.js` and `dist/*.d.ts`
+artifacts.
+
+## Docs
+
+- [Agent Mux docs](../../../docs/agent-mux/README.md)
+- [Reference mirror](../../../docs/agent-mux/reference/01-core-types-and-client.md)
+- [Package family entrypoint](../README.md)
+
+## License
+
+MIT © a5c-ai

package/dist/adapter-registry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AdapterRegistry interface and implementation for @a5c-ai/agent-mux.
+ *
+ * @see 05-adapter-system.md §5
+ */
+import type { AgentName } from './types.js';
+import type { AgentCapabilities, InstallMethod } from './capabilities.js';
+import type { AgentAdapter, AgentAdapterInfo, InstalledAgentInfo } from './adapter.js';
+/**
+ * Registry of agent adapters. Manages discovery, detection, capability
+ * queries, and plugin adapter registration.
+ */
+export interface AdapterRegistry {
+    /** Returns metadata for all registered adapters. Synchronous. */
+    list(): AgentAdapterInfo[];
+    /** Detects all registered agents and returns installation status. */
+    installed(): Promise<InstalledAgentInfo[]>;
+    /** Detects whether a specific agent is installed. */
+    detect(agent: AgentName): Promise<InstalledAgentInfo | null>;
+    /** Returns the capabilities manifest for a specific agent. */
+    capabilities(agent: AgentName): AgentCapabilities;
+    /** Returns platform-specific installation instructions for an agent. */
+    installInstructions(agent: AgentName, platform?: NodeJS.Platform): InstallMethod[];
+    /** Retrieves the adapter instance for a given agent. */
+    get(agent: AgentName): AgentAdapter | undefined;
+    /** Registers a new adapter or replaces an existing one. */
+    register(adapter: AgentAdapter): void;
+    /** Removes an adapter from the registry. */
+    unregister(agent: AgentName): void;
+}
+/**
+ * Map-based implementation of AdapterRegistry.
+ */
+export declare class AdapterRegistryImpl implements AdapterRegistry {
+    private readonly _adapters;
+    private readonly _detectCache;
+    /**
+     * Registers an adapter as a built-in. Same as register() but marks
+     * the source as 'built-in'.
+     */
+    registerBuiltIn(adapter: AgentAdapter): void;
+    list(): AgentAdapterInfo[];
+    installed(): Promise<InstalledAgentInfo[]>;
+    detect(agent: AgentName): Promise<InstalledAgentInfo | null>;
+    capabilities(agent: AgentName): AgentCapabilities;
+    installInstructions(agent: AgentName, platform?: NodeJS.Platform): InstallMethod[];
+    get(agent: AgentName): AgentAdapter | undefined;
+    register(adapter: AgentAdapter): void;
+    unregister(agent: AgentName): void;
+    private _validateAdapter;
+}

package/dist/adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.d.ts","sourceRoot":"","sources":["../src/adapter-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAOtB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAE3B,qEAAqE;IACrE,SAAS,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAE3C,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAE7D,8DAA8D;IAC9D,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,iBAAiB,CAAC;IAElD,wEAAwE;IACxE,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,aAAa,EAAE,CAAC;IAEnF,wDAAwD;IACxD,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAEhD,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEtC,4CAA4C;IAC5C,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACpC;AAiDD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IAEpE;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAQ5C,IAAI,IAAI,gBAAgB,EAAE;IAepB,SAAS,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQ1C,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA+ClE,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,iBAAiB;IAWjD,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,aAAa,EAAE;IAclF,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS;IAI/C,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAMrC,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAalC,OAAO,CAAC,gBAAgB;CA2EzB"}

package/dist/adapter-registry.js

@@ -0,0 +1,208 @@
+/**
+ * AdapterRegistry interface and implementation for @a5c-ai/agent-mux.
+ *
+ * @see 05-adapter-system.md §5
+ */
+import { AgentMuxError, ValidationError } from './errors.js';
+function parseVersionParts(version) {
+    const match = version.match(/\d+(?:\.\d+)*/);
+    if (!match)
+        return null;
+    return match[0].split('.').map((part) => Number.parseInt(part, 10));
+}
+function meetsMinVersion(version, minVersion) {
+    if (!minVersion)
+        return true;
+    if (!version)
+        return false;
+    const actual = parseVersionParts(version);
+    const required = parseVersionParts(minVersion);
+    if (!actual || !required)
+        return false;
+    const len = Math.max(actual.length, required.length);
+    for (let i = 0; i < len; i += 1) {
+        const actualPart = actual[i] ?? 0;
+        const requiredPart = required[i] ?? 0;
+        if (actualPart > requiredPart)
+            return true;
+        if (actualPart < requiredPart)
+            return false;
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// AdapterRegistryImpl
+// ---------------------------------------------------------------------------
+/** Cache duration for detect() results in milliseconds. */
+const DETECT_CACHE_TTL_MS = 30_000;
+/**
+ * Map-based implementation of AdapterRegistry.
+ */
+export class AdapterRegistryImpl {
+    _adapters = new Map();
+    _detectCache = new Map();
+    /**
+     * Registers an adapter as a built-in. Same as register() but marks
+     * the source as 'built-in'.
+     */
+    registerBuiltIn(adapter) {
+        this._validateAdapter(adapter);
+        this._adapters.set(adapter.agent, { adapter, source: 'built-in' });
+        this._detectCache.delete(adapter.agent);
+    }
+    // ── AdapterRegistry interface ────────────────────────────────────
+    list() {
+        const result = [];
+        for (const [, entry] of this._adapters) {
+            result.push({
+                agent: entry.adapter.agent,
+                displayName: entry.adapter.displayName,
+                cliCommand: entry.adapter.cliCommand,
+                minVersion: entry.adapter.minVersion,
+                source: entry.source,
+            });
+        }
+        result.sort((a, b) => a.agent.localeCompare(b.agent));
+        return result;
+    }
+    async installed() {
+        const agents = Array.from(this._adapters.keys());
+        const results = await Promise.all(agents.map((agent) => this.detect(agent)));
+        return results.filter((r) => r !== null);
+    }
+    async detect(agent) {
+        const entry = this._adapters.get(agent);
+        if (!entry)
+            return null;
+        // Check cache
+        const cached = this._detectCache.get(agent);
+        if (cached && Date.now() < cached.expiresAt) {
+            return cached.info;
+        }
+        // Perform detection
+        const adapter = entry.adapter;
+        let authState = 'unknown';
+        try {
+            const auth = await adapter.detectAuth();
+            authState = auth.status;
+        }
+        catch {
+            // Detection failure is not fatal
+        }
+        const installation = typeof adapter.detectInstallation === 'function'
+            ? await adapter.detectInstallation().catch(() => null)
+            : null;
+        const version = installation?.version ?? null;
+        const minVersion = adapter.minVersion ?? '';
+        const info = {
+            agent: adapter.agent,
+            installed: installation?.installed ?? false,
+            cliPath: installation?.path ?? null,
+            version,
+            meetsMinVersion: meetsMinVersion(version, adapter.minVersion),
+            minVersion,
+            authState,
+            activeModel: adapter.defaultModelId ?? null,
+        };
+        // Cache result
+        this._detectCache.set(agent, {
+            info,
+            expiresAt: Date.now() + DETECT_CACHE_TTL_MS,
+        });
+        return info;
+    }
+    capabilities(agent) {
+        const entry = this._adapters.get(agent);
+        if (!entry) {
+            throw new AgentMuxError('UNKNOWN_AGENT', `No adapter registered for agent "${agent}"`);
+        }
+        return entry.adapter.capabilities;
+    }
+    installInstructions(agent, platform) {
+        const entry = this._adapters.get(agent);
+        if (!entry) {
+            throw new AgentMuxError('UNKNOWN_AGENT', `No adapter registered for agent "${agent}"`);
+        }
+        const plat = platform ?? process.platform;
+        return entry.adapter.capabilities.installMethods.filter((m) => m.platform === 'all' || m.platform === plat);
+    }
+    get(agent) {
+        return this._adapters.get(agent)?.adapter;
+    }
+    register(adapter) {
+        this._validateAdapter(adapter);
+        this._adapters.set(adapter.agent, { adapter, source: 'plugin' });
+        this._detectCache.delete(adapter.agent);
+    }
+    unregister(agent) {
+        if (!this._adapters.has(agent)) {
+            throw new AgentMuxError('UNKNOWN_AGENT', `No adapter registered for agent "${agent}"`);
+        }
+        this._adapters.delete(agent);
+        this._detectCache.delete(agent);
+    }
+    // ── Validation ───────────────────────────────────────────────────
+    _validateAdapter(adapter) {
+        const errors = [];
+        if (!adapter.agent || typeof adapter.agent !== 'string') {
+            errors.push({
+                field: 'agent',
+                message: 'must be a non-empty string',
+                received: adapter.agent,
+                expected: 'non-empty string',
+            });
+        }
+        if (!adapter.displayName || typeof adapter.displayName !== 'string') {
+            errors.push({
+                field: 'displayName',
+                message: 'must be a non-empty string',
+                received: adapter.displayName,
+                expected: 'non-empty string',
+            });
+        }
+        if (!adapter.cliCommand || typeof adapter.cliCommand !== 'string') {
+            errors.push({
+                field: 'cliCommand',
+                message: 'must be a non-empty string',
+                received: adapter.cliCommand,
+                expected: 'non-empty string',
+            });
+        }
+        if (!adapter.capabilities || typeof adapter.capabilities !== 'object') {
+            errors.push({
+                field: 'capabilities',
+                message: 'must be a valid AgentCapabilities object',
+                received: adapter.capabilities,
+                expected: 'AgentCapabilities',
+            });
+        }
+        if (!Array.isArray(adapter.models)) {
+            errors.push({
+                field: 'models',
+                message: 'must be an array',
+                received: adapter.models,
+                expected: 'ModelCapabilities[]',
+            });
+        }
+        if (typeof adapter.buildSpawnArgs !== 'function') {
+            errors.push({
+                field: 'buildSpawnArgs',
+                message: 'must be a function',
+                received: typeof adapter.buildSpawnArgs,
+                expected: 'function',
+            });
+        }
+        if (typeof adapter.parseEvent !== 'function') {
+            errors.push({
+                field: 'parseEvent',
+                message: 'must be a function',
+                received: typeof adapter.parseEvent,
+                expected: 'function',
+            });
+        }
+        if (errors.length > 0) {
+            throw new ValidationError(errors);
+        }
+    }
+}
+//# sourceMappingURL=adapter-registry.js.map

package/dist/adapter-registry.js.map

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

package/dist/adapter-types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Multi-type adapter architecture interfaces.
+ *
+ * Extends agent-mux to support subprocess, remote (HTTP/WebSocket), and
+ * programmatic (SDK) adapter types beyond the original subprocess-only model.
+ *
+ * @see ../../../docs/18-multi-adapter-architecture.md
+ */
+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 { InteractionResponse } from './interaction.js';
+import type { AuthState, AuthSetupGuidance, AgentConfig, AgentConfigSchema, Session } from './adapter.js';
+/**
+ * Base interface shared across all adapter types.
+ * Contains common functionality independent of execution method.
+ */
+export interface BaseAgentAdapterInterface {
+    readonly agent: AgentName;
+    readonly displayName: string;
+    readonly adapterType: 'subprocess' | 'remote' | 'programmatic';
+    readonly minVersion?: string;
+    readonly capabilities: AgentCapabilities;
+    readonly models: ModelCapabilities[];
+    readonly defaultModelId?: string;
+    readonly configSchema: AgentConfigSchema;
+    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[]>;
+    /** Env-var names that indicate the current process is running under this harness. */
+    readonly hostEnvSignals?: readonly string[];
+    /** Extract adapter-specific metadata from an env snapshot. */
+    readHostMetadata?(env: NodeJS.ProcessEnv): Record<string, string | number | boolean | null>;
+}
+import type { AgentAdapter as LegacyAgentAdapter } from './adapter.js';
+/**
+ * Subprocess-based adapter (traditional agent-mux model).
+ * Spawns CLI process and parses line-based output.
+ */
+export interface SubprocessAdapter extends LegacyAgentAdapter {
+    readonly adapterType: 'subprocess';
+}
+/**
+ * Remote adapter for HTTP APIs, WebSocket connections, or Unix sockets.
+ * Manages persistent connections and may handle server lifecycle.
+ */
+export interface RemoteAdapter extends LegacyAgentAdapter {
+    readonly adapterType: 'remote';
+    readonly connectionType: 'http' | 'websocket' | 'unix';
+    connect(options: RunOptions): Promise<RemoteConnection>;
+    disconnect(connection: RemoteConnection): Promise<void>;
+    startServer?(options?: ServerOptions): Promise<ServerInfo>;
+    stopServer?(serverInfo: ServerInfo): Promise<void>;
+    healthCheck?(serverInfo: ServerInfo): Promise<ServerHealth>;
+}
+/**
+ * Connection abstraction for remote adapters.
+ */
+export interface RemoteConnection {
+    readonly connectionId: string;
+    readonly connectionType: 'http' | 'websocket' | 'unix';
+    readonly endpoint: string;
+    send(data: unknown): Promise<void>;
+    receive(): AsyncIterableIterator<AgentEvent>;
+    close(): Promise<void>;
+}
+/**
+ * HTTP-specific connection with REST API methods.
+ */
+export interface HttpConnection extends RemoteConnection {
+    readonly connectionType: 'http';
+    readonly baseUrl: string;
+    get(path: string, params?: Record<string, unknown>): Promise<unknown>;
+    post(path: string, data?: unknown): Promise<unknown>;
+    put(path: string, data?: unknown): Promise<unknown>;
+    delete(path: string): Promise<unknown>;
+    stream(path: string, data?: unknown): AsyncIterableIterator<AgentEvent>;
+}
+/**
+ * WebSocket-specific connection with pub/sub capabilities.
+ */
+export interface WebSocketConnection extends RemoteConnection {
+    readonly connectionType: 'websocket';
+    readonly websocketUrl: string;
+    subscribe(channel: string): AsyncIterableIterator<AgentEvent>;
+    unsubscribe(channel: string): Promise<void>;
+    send(message: WebSocketMessage): Promise<void>;
+}
+export interface WebSocketMessage {
+    type: string;
+    channel?: string;
+    data: unknown;
+}
+/**
+ * Programmatic adapter for direct SDK integration.
+ * No subprocess or network communication - direct function calls.
+ */
+export interface ProgrammaticRun extends AsyncIterableIterator<AgentEvent> {
+    send?(text: string): Promise<void>;
+    respond?(interactionId: string, response: InteractionResponse): Promise<void>;
+    interrupt?(): Promise<void>;
+    close?(): Promise<void> | void;
+}
+export interface ProgrammaticAdapter extends LegacyAgentAdapter {
+    readonly adapterType: 'programmatic';
+    execute(options: RunOptions): ProgrammaticRun;
+}
+/**
+ * Server configuration options for remote adapters.
+ */
+export interface ServerOptions {
+    port?: number;
+    host?: string;
+    timeout?: number;
+    env?: Record<string, string>;
+    args?: string[];
+}
+/**
+ * Information about a managed server instance.
+ */
+export interface ServerInfo {
+    readonly serverId: string;
+    readonly serverType: string;
+    readonly endpoint: string;
+    readonly pid?: number;
+    readonly port: number;
+    readonly startedAt: Date;
+}
+/**
+ * Server health status.
+ */
+export interface ServerHealth {
+    status: 'starting' | 'healthy' | 'unhealthy' | 'stopped';
+    uptime?: number;
+    lastCheck: Date;
+    details?: string;
+}
+/**
+ * Server lifecycle manager interface.
+ */
+export interface ServerManager {
+    start(adapter: RemoteAdapter, options?: ServerOptions): Promise<ServerInfo>;
+    stop(serverId: string): Promise<void>;
+    health(serverId: string): Promise<ServerHealth>;
+    list(): Promise<ServerInfo[]>;
+    cleanup(): Promise<void>;
+}
+/**
+ * Union of all adapter types. This replaces the original AgentAdapter interface
+ * while maintaining backward compatibility.
+ */
+export type AgentAdapter = SubprocessAdapter | RemoteAdapter | ProgrammaticAdapter;
+export declare function isSubprocessAdapter(adapter: AgentAdapter): adapter is SubprocessAdapter;
+export declare function isRemoteAdapter(adapter: AgentAdapter): adapter is RemoteAdapter;
+export declare function isProgrammaticAdapter(adapter: AgentAdapter): adapter is ProgrammaticAdapter;
+export declare function isHttpConnection(connection: RemoteConnection): connection is HttpConnection;
+export declare function isWebSocketConnection(connection: RemoteConnection): connection is WebSocketConnection;

package/dist/adapter-types.d.ts.map

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

package/dist/adapter-types.js

@@ -0,0 +1,27 @@
+/**
+ * Multi-type adapter architecture interfaces.
+ *
+ * Extends agent-mux to support subprocess, remote (HTTP/WebSocket), and
+ * programmatic (SDK) adapter types beyond the original subprocess-only model.
+ *
+ * @see ../../../docs/18-multi-adapter-architecture.md
+ */
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+export function isSubprocessAdapter(adapter) {
+    return adapter.adapterType === 'subprocess';
+}
+export function isRemoteAdapter(adapter) {
+    return adapter.adapterType === 'remote';
+}
+export function isProgrammaticAdapter(adapter) {
+    return adapter.adapterType === 'programmatic';
+}
+export function isHttpConnection(connection) {
+    return connection.connectionType === 'http';
+}
+export function isWebSocketConnection(connection) {
+    return connection.connectionType === 'websocket';
+}
+//# sourceMappingURL=adapter-types.js.map

package/dist/adapter-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-types.js","sourceRoot":"","sources":["../src/adapter-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgOH,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,UAAU,mBAAmB,CAAC,OAAqB;IACvD,OAAO,OAAO,CAAC,WAAW,KAAK,YAAY,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAqB;IACzD,OAAO,OAAO,CAAC,WAAW,KAAK,cAAc,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAA4B;IAC3D,OAAO,UAAU,CAAC,cAAc,KAAK,MAAM,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAA4B;IAChE,OAAO,UAAU,CAAC,cAAc,KAAK,WAAW,CAAC;AACnD,CAAC"}