@compass-ai/nova 1.0.73 → 1.0.74

package/dist/acp/types.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Type definitions for ACP (Agent Client Protocol) implementation.
+ *
+ * This module defines all TypeScript interfaces and types used for managing
+ * ACP sessions, configuration, and protocol-specific data structures.
+ */
+import type { Writable } from 'node:stream';
+/**
+ * MCP Server configuration for ACP sessions.
+ * Represents either a local (stdio) or remote (HTTP/SSE) MCP server.
+ */
+export interface ACPMCPServer {
+    /** Server name identifier */
+    name: string;
+    /** Server type: local (stdio) or remote (http/sse) */
+    type: 'local' | 'remote';
+    /** Command for local servers */
+    command?: string;
+    /** Arguments for local server command */
+    args?: string[];
+    /** Environment variables for local servers */
+    env?: Record<string, string>;
+    /** URL for remote servers */
+    url?: string;
+    /** Headers for remote servers */
+    headers?: Record<string, string>;
+    /**
+     * Whether this server operates in silent mode.
+     * When true, tool output from this server is suppressed from user-facing
+     * presentation but still passed to the model for context continuity.
+     */
+    silent?: boolean;
+}
+/**
+ * Model configuration for ACP sessions.
+ */
+export interface ACPModelConfig {
+    /** Provider identifier (e.g., 'anthropic', 'ollama') */
+    providerId: string;
+    /** Model identifier (e.g., 'claude-opus-4-5-20251101') */
+    modelId: string;
+}
+/**
+ * Represents the state of an ACP session.
+ * Maintains all context needed for a running ACP session.
+ */
+export interface ACPSessionState {
+    /** Unique session identifier */
+    id: string;
+    /** Working directory for the session */
+    workingDir: string;
+    /** Current model configuration */
+    model: ACPModelConfig;
+    /** Connected MCP servers */
+    mcpServers: ACPMCPServer[];
+    /** Current agent/mode identifier */
+    modeId: string;
+    /** Session creation timestamp */
+    createdAt: Date;
+    /** Last activity timestamp */
+    lastActivity: Date;
+    /** Optional conversation history for replay */
+    conversationHistory?: ACPMessage[];
+    /** Optional session metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * ACP message representation for session history.
+ */
+export interface ACPMessage {
+    /** Message identifier */
+    id: string;
+    /** Message role */
+    role: 'user' | 'assistant' | 'system';
+    /** Message content parts */
+    parts: ACPMessagePart[];
+    /** Message timestamp */
+    timestamp: Date;
+}
+/**
+ * Message part types for ACP messages.
+ */
+export type ACPMessagePart = ACPTextPart | ACPToolPart | ACPFilePart | ACPReasoningPart;
+/**
+ * Text content part.
+ */
+export interface ACPTextPart {
+    type: 'text';
+    text: string;
+    /** If true, this is synthetic/system-generated content */
+    synthetic?: boolean;
+    /** If true, this content should be ignored in display */
+    ignored?: boolean;
+}
+/**
+ * Tool call/result part.
+ */
+export interface ACPToolPart {
+    type: 'tool';
+    /** Tool call identifier */
+    callId: string;
+    /** Tool name */
+    tool: string;
+    /** Tool execution state */
+    state: ACPToolState;
+    /**
+     * Whether this tool originates from a silent MCP server.
+     * When true, the tool result is suppressed from user-facing presentation
+     * but still passed to the model. Errors are always surfaced regardless.
+     */
+    silent?: boolean;
+}
+/**
+ * Tool execution state.
+ */
+export interface ACPToolState {
+    status: 'pending' | 'running' | 'completed' | 'error';
+    input?: Record<string, unknown>;
+    output?: string;
+    error?: string;
+    title?: string;
+    metadata?: Record<string, unknown>;
+    /**
+     * Whether output from this tool should be suppressed from user-facing
+     * presentation. Inherited from the parent server's `silent` config field.
+     * Note: error status always bypasses silent suppression.
+     */
+    silent?: boolean;
+}
+/**
+ * File attachment part.
+ */
+export interface ACPFilePart {
+    type: 'file';
+    url: string;
+    filename: string;
+    mime: string;
+}
+/**
+ * Reasoning/thinking part.
+ */
+export interface ACPReasoningPart {
+    type: 'reasoning';
+    text: string;
+}
+/**
+ * Configuration for ACP agent.
+ */
+export interface ACPConfig {
+    /** Default model configuration */
+    defaultModel: ACPModelConfig;
+    /** Protocol version */
+    protocolVersion?: number;
+    /** Agent name */
+    agentName?: string;
+    /** Agent version */
+    agentVersion?: string;
+    /** Enable unguarded (unleash) mode — overrides project config when true */
+    unleash?: boolean;
+}
+/**
+ * ACP tool kind classification.
+ */
+export type ACPToolKind = 'execute' | 'fetch' | 'edit' | 'search' | 'read' | 'other';
+/**
+ * Permission option for ACP permission requests.
+ */
+export interface ACPPermissionOption {
+    optionId: string;
+    kind: 'allow_once' | 'allow_always' | 'reject_once';
+    name: string;
+}
+/**
+ * Permission request from ACP.
+ */
+export interface ACPPermissionRequest {
+    id: string;
+    sessionId: string;
+    permission: string;
+    toolCallId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Terminal auth configuration for ACP.
+ * Specifies how to invoke the agent for interactive authentication.
+ */
+/**
+ * Auth method for ACP initialize response.
+ * Discriminated union on `type` (defaults to 'agent' when absent).
+ * See: https://agentclientprotocol.com/rfds/auth-methods.md
+ */
+export interface ACPAuthMethod {
+    /** Unique identifier for the auth method */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of the auth method */
+    description?: string | null;
+    /** Auth type discriminator (defaults to 'agent' when absent) */
+    type?: 'terminal' | 'env_var' | 'agent';
+    /** Terminal auth: args passed to the agent binary during setup */
+    args?: string[];
+    /** Terminal auth: environment variables supplied alongside defaults */
+    env?: Record<string, string>;
+    /** Env var auth: credential variables the client should collect */
+    vars?: Array<{
+        name: string;
+        label?: string;
+        secret?: boolean;
+        optional?: boolean;
+    }>;
+    /** Env var auth: link to credential source */
+    link?: string;
+    /** Reserved for extensibility */
+    _meta?: Record<string, unknown> | null;
+}
+/**
+ * Authentication request.
+ */
+export interface ACPAuthRequest {
+    /** The auth method ID to use (must match one from initialize authMethods) */
+    methodId: string;
+    /** Reserved for extensibility */
+    _meta?: Record<string, unknown> | null;
+    /** Non-spec extension: inline credentials (e.g. from env_var flow) */
+    credentials?: {
+        apiKey?: string;
+    };
+}
+/**
+ * Authentication response.
+ */
+export interface ACPAuthResponse {
+    /** Reserved for extensibility */
+    _meta?: Record<string, unknown> | null;
+    /** Non-spec extension: success indicator for internal use */
+    success: boolean;
+    message?: string;
+    error?: string;
+    /** Error code for programmatic handling */
+    errorCode?: 'AUTH_REQUIRED' | 'INVALID_CREDENTIALS' | 'AUTH_EXPIRED';
+}
+/**
+ * Session list entry for listing sessions.
+ */
+export interface ACPSessionInfo {
+    sessionId: string;
+    cwd: string;
+    title?: string;
+    updatedAt: string;
+}
+/**
+ * Available model entry.
+ */
+export interface ACPAvailableModel {
+    modelId: string;
+    name: string;
+}
+/**
+ * Available mode/agent entry.
+ */
+export interface ACPAvailableMode {
+    id: string;
+    name: string;
+    description?: string;
+}
+/**
+ * Available command entry.
+ */
+export interface ACPAvailableCommand {
+    name: string;
+    description: string;
+}
+/**
+ * Configuration for {@link BackpressureWriter}.
+ */
+export interface BackpressureWriterOptions {
+    /** The writable stream to write to (typically `process.stdout`). */
+    stream: Writable;
+    /**
+     * Maximum number of messages to queue while the stream is draining.
+     * When exceeded the oldest queued message is discarded and a warning is logged.
+     * @default 1000
+     */
+    maxQueueSize?: number;
+}
+/**
+ * Configuration for {@link TextChunkCoalescer}.
+ */
+export interface TextCoalescerOptions {
+    /**
+     * Coalescing window in milliseconds.
+     * Text deltas arriving within this window are merged into a single emission.
+     * Set to `0` to disable coalescing (pass-through mode).
+     * @default 16
+     */
+    windowMs?: number;
+    /**
+     * Maximum buffer size in characters before an early flush is forced,
+     * regardless of the coalescing window.
+     * @default 8192
+     */
+    maxBufferSize?: number;
+}
+/**
+ * Payload emitted by the {@link TextChunkCoalescer} after a coalescing window closes.
+ */
+export interface CoalescedTextEvent {
+    /** The merged text content. */
+    text: string;
+    /** Number of individual text deltas that were coalesced into this event. */
+    chunks: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/acp/types.d.ts.map

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

package/dist/acp/types.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for ACP (Agent Client Protocol) implementation.
+ *
+ * This module defines all TypeScript interfaces and types used for managing
+ * ACP sessions, configuration, and protocol-specific data structures.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/acp/types.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI entry point with commander setup, argument parsing, and application bootstrapping
+ *
+ * This module serves as the main entry point for the Compass CLI application.
+ * It configures the command-line interface using Commander.js, sets up all
+ * subcommands, and handles the application lifecycle.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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