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

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export type { ToolClassification } from './classify.js';
+export { classifyTool } from './classify.js';

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,2 @@
+export { classifyTool } from './classify.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,288 @@
+/**
+ * Core types for @a5c-ai/agent-mux.
+ *
+ * Defines all foundational type aliases, interfaces, and union types
+ * used across the agent-mux system.
+ */
+/**
+ * Agent names — derived from Atlas graph at runtime.
+ * Any string is accepted; the adapter registry resolves names to implementations.
+ */
+export type BuiltInAgentName = string;
+export type AgentName = string;
+/** Machine-readable error codes defined by agent-mux. */
+export type ErrorCode = 'CAPABILITY_ERROR' | 'VALIDATION_ERROR' | 'AUTH_ERROR' | 'AGENT_NOT_FOUND' | 'AGENT_NOT_INSTALLED' | 'AGENT_CRASH' | 'SPAWN_ERROR' | 'TIMEOUT' | 'INACTIVITY_TIMEOUT' | 'PARSE_ERROR' | 'CONFIG_ERROR' | 'CONFIG_LOCK_ERROR' | 'SESSION_NOT_FOUND' | 'PROFILE_NOT_FOUND' | 'PLUGIN_ERROR' | 'RATE_LIMITED' | 'CONTEXT_EXCEEDED' | 'ABORTED' | 'RUN_NOT_ACTIVE' | 'STDIN_NOT_AVAILABLE' | 'NO_PENDING_INTERACTION' | 'INTERACTION_NOT_FOUND' | 'INVALID_STATE_TRANSITION' | 'PTY_NOT_AVAILABLE' | 'UNKNOWN_AGENT' | 'INTERNAL';
+/** A single field-level validation error. */
+export interface ValidationFieldError {
+    /** Dot-path to the invalid field (e.g., "temperature"). */
+    field: string;
+    /** What went wrong. */
+    message: string;
+    /** The value that was provided. */
+    received: unknown;
+    /** The expected type or range. */
+    expected: string;
+}
+/** Base shape shared by every event emitted on a RunHandle. */
+export interface BaseEvent {
+    /** Discriminator tag for the event union type. */
+    type: string;
+    /** ULID of the run that produced this event. */
+    runId: string;
+    /** Name of the agent that produced this event. */
+    agent: AgentName;
+    /**
+     * Unix epoch milliseconds when this event was created by agent-mux.
+     * This is the parse time, not the agent's internal timestamp.
+     */
+    timestamp: number;
+    /**
+     * Origin of the event inside agent-mux.
+     * Omitted for legacy agent-originated events.
+     */
+    source?: string;
+    /**
+     * The raw, unparsed line from the agent's output.
+     * Present only when the client is created with `debug: true`
+     * or the run is started with `debug: true`.
+     * Omitted in production to reduce memory pressure.
+     */
+    raw?: string;
+}
+/** Schema for `~/.agent-mux/config.json`. */
+export interface GlobalConfig {
+    /**
+     * Default agent used when `RunOptions.agent` is not specified
+     * and no profile overrides it.
+     */
+    defaultAgent?: AgentName;
+    /**
+     * Default model used when `RunOptions.model` is not specified.
+     * Agent-specific; ignored if the agent does not support this model.
+     */
+    defaultModel?: string;
+    /**
+     * Default approval mode for tool calls and file operations.
+     * @default 'prompt'
+     */
+    approvalMode?: 'yolo' | 'prompt' | 'deny';
+    /**
+     * Default run timeout in milliseconds. 0 means no timeout.
+     * @default 0
+     */
+    timeout?: number;
+    /**
+     * Default inactivity timeout in milliseconds. 0 means no timeout.
+     * @default 0
+     */
+    inactivityTimeout?: number;
+    /** Default retry policy. */
+    retryPolicy?: RetryPolicy;
+    /**
+     * Default streaming mode.
+     * @default 'auto'
+     */
+    stream?: boolean | 'auto';
+}
+/** Schema for `~/.agent-mux/auth-hints.json`. */
+export interface AuthHintsFile {
+    /** Schema version for forward compatibility. */
+    version: 1;
+    /** Per-agent cached auth state. */
+    agents: Record<AgentName, AuthHintEntry>;
+}
+/** A single cached auth-state entry. */
+export interface AuthHintEntry {
+    /** Last detected auth status. */
+    status: 'authenticated' | 'unauthenticated' | 'expired' | 'unknown';
+    /** Auth method that was detected. */
+    method?: string;
+    /** Identity string (e.g., email or username). */
+    identity?: string;
+    /** When this hint expires and should be re-checked. */
+    expiresAt?: string;
+    /** ISO 8601 timestamp of when this hint was last updated. */
+    checkedAt: string;
+}
+/** A single entry in `.agent-mux/run-index.jsonl`. */
+export interface RunIndexEntry {
+    /** Schema version for the entry format. */
+    v: 1;
+    /** ULID of the run. Globally unique, time-sortable. */
+    runId: string;
+    /** Agent that was invoked. */
+    agent: AgentName;
+    /** Model that was used (if known). */
+    model?: string;
+    /** The agent's native session ID (if applicable). */
+    sessionId?: string;
+    /**
+     * ISO 8601 timestamp when the run started.
+     * Always in UTC with 'Z' suffix.
+     */
+    timestamp: string;
+    /** Cost record, if cost data was available. */
+    cost?: CostRecord;
+    /** Consumer-provided tags for filtering and grouping. */
+    tags: string[];
+}
+/** Aggregated cost data for a single run. */
+export interface CostRecord {
+    /** Total cost in USD. */
+    totalUsd: number;
+    /** Input tokens consumed. */
+    inputTokens: number;
+    /** Output tokens generated. */
+    outputTokens: number;
+    /** Thinking/reasoning tokens (if applicable). */
+    thinkingTokens?: number;
+    /** Cached input tokens (if applicable). @deprecated Use cacheCreationTokens + cacheReadTokens for granular attribution. */
+    cachedTokens?: number;
+    /** Cache creation tokens - tokens used to create new cache entries. */
+    cacheCreationTokens?: number;
+    /** Cache read tokens - tokens read from existing cache entries. */
+    cacheReadTokens?: number;
+}
+/** Data stored in a profile JSON file. All fields are optional. */
+export interface ProfileData {
+    /** The agent to use. */
+    agent?: AgentName;
+    /** The model to use. */
+    model?: string;
+    /** Approval mode. */
+    approvalMode?: 'yolo' | 'prompt' | 'deny';
+    /** Run timeout in milliseconds. */
+    timeout?: number;
+    /** Inactivity timeout in milliseconds. */
+    inactivityTimeout?: number;
+    /** Maximum turns. */
+    maxTurns?: number;
+    /** Thinking effort level. */
+    thinkingEffort?: 'low' | 'medium' | 'high' | 'max';
+    /** Thinking budget in tokens. */
+    thinkingBudgetTokens?: number;
+    /** Override thinking behavior entirely. */
+    thinkingOverride?: Record<string, unknown>;
+    /** Temperature for sampling. */
+    temperature?: number;
+    /** Top-P for sampling. */
+    topP?: number;
+    /** Top-K for sampling. */
+    topK?: number;
+    /** Maximum output tokens. */
+    maxTokens?: number;
+    /** Maximum output tokens (alias). */
+    maxOutputTokens?: number;
+    /** Streaming mode. */
+    stream?: boolean | 'auto';
+    /** Output format. */
+    outputFormat?: 'text' | 'json' | 'jsonl';
+    /** Retry policy. */
+    retryPolicy?: RetryPolicy;
+    /** System prompt. */
+    systemPrompt?: string;
+    /** System prompt injection mode. */
+    systemPromptMode?: 'prepend' | 'append' | 'replace';
+    /** Skills to load. */
+    skills?: string[];
+    /** MCP server configurations. */
+    mcpServers?: McpServerConfig[];
+    /** Tags for run indexing. */
+    tags?: string[];
+}
+/** Supported plugin packaging formats across agents. */
+export type PluginFormat = 'npm-package' | 'skill-file' | 'skill-directory' | 'extension-ts' | 'channel-plugin' | 'mcp-server';
+/** Configuration for automatic retry on transient failures. All fields are optional with spec-defined defaults. */
+export interface RetryPolicy {
+    /**
+     * Maximum number of retry attempts. Must be an integer >= 1.
+     * @default 3
+     */
+    maxAttempts?: number;
+    /**
+     * Base delay between retries in milliseconds.
+     * Actual delay uses exponential backoff: baseDelayMs * 2^(attempt-1).
+     * @default 1000
+     */
+    baseDelayMs?: number;
+    /**
+     * Maximum delay between retries in milliseconds.
+     * Caps the exponential backoff. Must be an integer >= baseDelayMs.
+     * @default 30000
+     */
+    maxDelayMs?: number;
+    /**
+     * Jitter factor applied to the delay. 0 means no jitter; 1 means
+     * up to 100% random jitter added. Must be in [0.0, 1.0].
+     * @default 0.1
+     */
+    jitterFactor?: number;
+    /**
+     * Which error codes are retryable.
+     * @default ['RATE_LIMITED', 'AGENT_CRASH', 'TIMEOUT']
+     */
+    retryOn?: ErrorCode[];
+}
+/** A file or data attachment for a run prompt. Exactly one source must be set. */
+export interface Attachment {
+    /** Absolute path to a local file. */
+    filePath?: string;
+    /** URL to fetch the attachment from. */
+    url?: string;
+    /** Base64-encoded content. Requires `mimeType` to be set. */
+    base64?: string;
+    /** MIME type of the attachment (required when `base64` is set). */
+    mimeType?: string;
+    /** Human-readable name for the attachment. */
+    name?: string;
+}
+/** Event emitted when an agent requires user input during a run. */
+export interface InputRequiredEvent {
+    /** Discriminator. */
+    type: 'input_required';
+    /** ULID of the run. */
+    runId: string;
+    /** Agent that requires input. */
+    agent: AgentName;
+    /** Unix epoch milliseconds. */
+    timestamp: number;
+    /** Optional message describing what input is needed. */
+    message?: string;
+}
+/** Event emitted when an agent requests approval for a tool call. */
+export interface ApprovalRequestEvent {
+    /** Discriminator. */
+    type: 'approval_request';
+    /** ULID of the run. */
+    runId: string;
+    /** Agent requesting approval. */
+    agent: AgentName;
+    /** Unix epoch milliseconds. */
+    timestamp: number;
+    /** Tool name that requires approval. */
+    tool?: string;
+    /** Arguments to the tool call. */
+    arguments?: Record<string, unknown>;
+    /** Human-readable description of the action. */
+    description?: string;
+}
+/**
+ * MCP server configuration.
+ * Defines how to connect to a Model Context Protocol server.
+ */
+export interface McpServerConfig {
+    /** The name of the MCP server. Must match `^[a-zA-Z0-9_-]{1,64}$`. */
+    name: string;
+    /** The transport type. */
+    transport: 'stdio' | 'sse' | 'streamable-http';
+    /** Command to spawn (for stdio transport). */
+    command?: string;
+    /** Arguments for the command. */
+    args?: string[];
+    /** Environment variables for the server process. */
+    env?: Record<string, string>;
+    /** URL for SSE or streamable-http transports. */
+    url?: string;
+    /** Additional HTTP headers for SSE or streamable-http transports. */
+    headers?: Record<string, string>;
+}

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Core types for @a5c-ai/agent-mux.
+ *
+ * Defines all foundational type aliases, interfaces, and union types
+ * used across the agent-mux system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/workspaces.d.ts

@@ -0,0 +1,142 @@
+import { promises as fs } from 'node:fs';
+export type WorkspaceMaterializationMode = 'worktree' | 'symlink';
+export type WorkspaceSessionStatus = 'running' | 'stopped';
+export type WorkspaceStatus = 'active' | 'idle' | 'archived' | 'cleaned' | 'missing';
+export interface WorkspaceSessionRepoContext {
+    readonly alias: string;
+    readonly sourcePath: string;
+    readonly targetPath: string;
+    readonly mode: WorkspaceMaterializationMode;
+    readonly gitRoot: string | null;
+    readonly branch: string | null;
+    readonly head: string | null;
+}
+export interface WorkspaceSessionContext {
+    readonly workspaceId: string;
+    readonly workspaceName: string;
+    readonly workspaceRootPath: string;
+    readonly workspaceDefaultCwd: string;
+    readonly workspaceMode: WorkspaceMaterializationMode;
+    readonly currentPath?: string;
+    readonly repo?: WorkspaceSessionRepoContext;
+}
+export interface WorkspaceRepoInput {
+    readonly path: string;
+    readonly alias?: string;
+    readonly mode?: WorkspaceMaterializationMode;
+}
+export interface WorkspaceCreateInput {
+    readonly name: string;
+    readonly repos: readonly WorkspaceRepoInput[];
+    readonly mode?: WorkspaceMaterializationMode;
+    readonly branchName?: string;
+    readonly rootDir?: string;
+}
+export interface WorkspaceSessionBinding {
+    readonly agent: string;
+    readonly sessionId: string;
+    readonly status: WorkspaceSessionStatus;
+    readonly cwd?: string;
+    readonly title?: string;
+    readonly updatedAt: string;
+    readonly activeRunId?: string | null;
+    readonly latestRunId?: string | null;
+}
+export interface WorkspaceRepoRecord {
+    readonly alias: string;
+    readonly sourcePath: string;
+    readonly targetPath: string;
+    readonly mode: WorkspaceMaterializationMode;
+    readonly gitRoot: string | null;
+    readonly branch: string | null;
+    readonly head: string | null;
+}
+export interface WorkspaceRecord {
+    readonly id: string;
+    readonly name: string;
+    readonly rootPath: string;
+    readonly mode: WorkspaceMaterializationMode;
+    readonly createdAt: string;
+    readonly archivedAt: string | null;
+    readonly cleanedAt: string | null;
+    readonly repos: readonly WorkspaceRepoRecord[];
+    readonly sessions: readonly WorkspaceSessionBinding[];
+}
+export interface WorkspaceRepoSummary extends WorkspaceRepoRecord {
+    readonly exists: boolean;
+}
+export interface WorkspaceActionAvailability {
+    readonly canArchive: boolean;
+    readonly canCleanup: boolean;
+    readonly canDelete: boolean;
+    readonly canRecover: boolean;
+}
+export interface WorkspaceSummary {
+    readonly id: string;
+    readonly name: string;
+    readonly rootPath: string;
+    readonly defaultCwd: string;
+    readonly mode: WorkspaceMaterializationMode;
+    readonly status: WorkspaceStatus;
+    readonly createdAt: string;
+    readonly archivedAt: string | null;
+    readonly cleanedAt: string | null;
+    readonly repos: readonly WorkspaceRepoSummary[];
+    readonly sessions: readonly WorkspaceSessionBinding[];
+    readonly actions: WorkspaceActionAvailability;
+}
+export interface WorkspaceListResult {
+    readonly workspaces: readonly WorkspaceSummary[];
+    readonly summary: {
+        readonly total: number;
+        readonly active: number;
+        readonly idle: number;
+        readonly archived: number;
+        readonly cleaned: number;
+        readonly missing: number;
+    };
+}
+export interface WorkspaceServiceDeps {
+    readonly readFile: typeof fs.readFile;
+    readonly writeFile: typeof fs.writeFile;
+    readonly mkdir: typeof fs.mkdir;
+    readonly rm: typeof fs.rm;
+    readonly symlink: typeof fs.symlink;
+    readonly unlink: typeof fs.unlink;
+    readonly stat: typeof fs.stat;
+    readonly lstat: typeof fs.lstat;
+    readonly readdir: typeof fs.readdir;
+    readonly execGit: (args: string[], cwd: string) => Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+    readonly now: () => string;
+    readonly homedir: () => string;
+}
+export declare function resolveWorkspaceDefaultCwd(workspace: Pick<WorkspaceRecord, 'rootPath' | 'repos'> | Pick<WorkspaceSummary, 'rootPath' | 'repos'>): string;
+export declare class WorkspaceService {
+    private readonly deps;
+    constructor(deps?: Partial<WorkspaceServiceDeps>);
+    rootDir(): string;
+    listWorkspaces(options?: {
+        readonly liveSessions?: readonly WorkspaceSessionBinding[];
+    }): Promise<WorkspaceListResult>;
+    createWorkspace(input: WorkspaceCreateInput): Promise<WorkspaceRecord>;
+    archiveWorkspace(identifier: string): Promise<WorkspaceRecord>;
+    cleanupWorkspace(identifier: string): Promise<WorkspaceRecord>;
+    recoverWorkspace(identifier: string): Promise<WorkspaceRecord>;
+    deleteWorkspace(identifier: string, options?: {
+        readonly forceCleanup?: boolean;
+    }): Promise<void>;
+    bindSession(input: {
+        readonly workspaceId: string;
+        readonly session: WorkspaceSessionBinding;
+    }): Promise<WorkspaceRecord>;
+    reconcileSessions(liveSessions: readonly WorkspaceSessionBinding[]): Promise<void>;
+    resolveWorkspace(identifier: string): Promise<WorkspaceRecord | null>;
+    resolveSessionContext(input: {
+        readonly workspaceId?: string;
+        readonly cwd?: string;
+    }): Promise<WorkspaceSessionContext | null>;
+    resolveWorkspaceCwd(workspace: Pick<WorkspaceRecord, 'rootPath' | 'repos'> | Pick<WorkspaceSummary, 'rootPath' | 'repos'>): string;
+}

package/dist/workspaces.d.ts.map

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