@compass-ai/nova 1.0.73 → 1.0.74

package/dist/acp/agent.d.ts

@@ -0,0 +1,318 @@
+/**
+ * ACP Agent - Core implementation of the Agent Client Protocol.
+ *
+ * Implements the ACP protocol methods including session management,
+ * prompt handling, and model/mode switching.
+ */
+import { ACPSessionManager } from './session-manager.js';
+import { type ACPConnection } from './event-adapter.js';
+import type { ACPConfig, ACPMCPServer, ACPSessionInfo, ACPAvailableModel, ACPAvailableMode, ACPAuthRequest, ACPAuthResponse, ACPAuthMethod } from './types.js';
+/**
+ * Initialize request from ACP client.
+ */
+export interface ACPInitializeRequest {
+    protocolVersion: number;
+    clientCapabilities?: {
+        auth?: {
+            terminal?: boolean;
+        };
+    };
+}
+/**
+ * Initialize response to ACP client.
+ */
+export interface ACPInitializeResponse {
+    protocolVersion: number;
+    agentCapabilities: {
+        loadSession: boolean;
+        mcpCapabilities: {
+            http: boolean;
+            sse: boolean;
+        };
+        promptCapabilities?: {
+            embeddedContext?: boolean;
+            image?: boolean;
+        };
+        sessionCapabilities?: {
+            fork?: Record<string, unknown>;
+            list?: Record<string, unknown>;
+            resume?: Record<string, unknown>;
+        };
+    };
+    /** Available authentication methods - per ACP Terminal Auth spec */
+    authMethods: ACPAuthMethod[];
+    agentInfo: {
+        name: string;
+        version: string;
+    };
+}
+/**
+ * New session request.
+ */
+export interface ACPNewSessionRequest {
+    cwd: string;
+    mcpServers: ACPMCPServer[];
+}
+/**
+ * New session response.
+ */
+export interface ACPNewSessionResponse {
+    sessionId: string;
+    modes: {
+        currentModeId: string;
+        availableModes: ACPAvailableMode[];
+    };
+    models: {
+        currentModelId: string;
+        availableModels: ACPAvailableModel[];
+    };
+    _meta: Record<string, unknown>;
+}
+/**
+ * Load session request.
+ */
+export interface ACPLoadSessionRequest {
+    sessionId: string;
+    cwd: string;
+    mcpServers: ACPMCPServer[];
+}
+/**
+ * Prompt request.
+ */
+export interface ACPPromptRequest {
+    sessionId: string;
+    prompt: Array<{
+        type: 'text' | 'image' | 'resource_link' | 'resource';
+        text?: string;
+        uri?: string;
+        mimeType?: string;
+        data?: string;
+        name?: string;
+        resource?: {
+            uri?: string;
+            mimeType?: string;
+            text?: string;
+            blob?: string;
+        };
+        annotations?: {
+            audience?: Array<'user' | 'assistant'>;
+        };
+    }>;
+}
+/**
+ * Prompt response.
+ * Note: JetBrains ACP client only recognizes 'end_turn', 'max_tokens', and 'stop_sequence'.
+ * Tool execution is handled internally by the agentic loop, so we always return 'end_turn'
+ * when tools complete successfully.
+ */
+export interface ACPPromptResponse {
+    stopReason: 'end_turn' | 'max_tokens' | 'stop_sequence';
+    _meta: Record<string, unknown>;
+}
+/**
+ * List sessions request.
+ */
+export interface ACPListSessionsRequest {
+    cwd?: string;
+    cursor?: string;
+}
+/**
+ * List sessions response.
+ */
+export interface ACPListSessionsResponse {
+    sessions: ACPSessionInfo[];
+    nextCursor?: string;
+}
+/**
+ * Fork session request.
+ */
+export interface ACPForkSessionRequest {
+    sessionId: string;
+    cwd: string;
+    mcpServers?: ACPMCPServer[];
+}
+/**
+ * Resume session request.
+ */
+export interface ACPResumeSessionRequest {
+    sessionId: string;
+    cwd: string;
+    mcpServers?: ACPMCPServer[];
+}
+/**
+ * Set session model request.
+ */
+export interface ACPSetSessionModelRequest {
+    sessionId: string;
+    modelId: string;
+}
+/**
+ * Set session mode request.
+ */
+export interface ACPSetSessionModeRequest {
+    sessionId: string;
+    modeId: string;
+}
+/**
+ * Cancel notification.
+ */
+export interface ACPCancelNotification {
+    sessionId: string;
+}
+/**
+ * ACP Agent class.
+ * Implements the Agent Client Protocol for integration with ACP clients.
+ */
+export declare class ACPAgent {
+    /** ACP connection */
+    private connection;
+    /** Configuration */
+    private config;
+    /** Session manager */
+    private sessionManager;
+    /** Tool bridges per session */
+    private toolBridges;
+    /** Event adapters per session */
+    private eventAdapters;
+    /** Abort controllers per session */
+    private abortControllers;
+    /** Whether the client has successfully authenticated */
+    private authenticated;
+    /**
+     * Checks credentials and throws an ACP auth error if none are configured.
+     *
+     * IMPORTANT (JetBrains ACP integration):
+     * - This MUST gate `session/new` (not just `prompt`). JetBrains only renders
+     *   the "Nova Setup" button when session creation fails with an auth error
+     *   containing `data.authMethods`. It does NOT check prompt-level errors.
+     * - The `authMethods` array must be placed inside `error.data` (JSON-RPC 2.0
+     *   compliant), not as a top-level sibling of `code`/`message`.
+     * - The auth method `type` must be `"terminal"` for JetBrains to show the
+     *   native terminal setup button.
+     */
+    private ensureAuthenticated;
+    /**
+     * Creates a new ACPAgent instance.
+     *
+     * @param config - Agent configuration
+     * @param sessionManager - Optional custom session manager
+     */
+    constructor(config: ACPConfig, sessionManager?: ACPSessionManager);
+    /**
+     * Sets the ACP connection.
+     *
+     * @param connection - ACP connection
+     */
+    setConnection(connection: ACPConnection): void;
+    /**
+     * Handles the initialize request.
+     *
+     * @param params - Initialize request parameters
+     * @returns Initialize response
+     */
+    initialize(params: ACPInitializeRequest): Promise<ACPInitializeResponse>;
+    /**
+     * Handles authentication request.
+     * Currently stubbed for MVP.
+     *
+     * @param params - Authentication request
+     * @returns Authentication response
+     */
+    authenticate(params: ACPAuthRequest): Promise<ACPAuthResponse>;
+    /**
+     * Creates a new session.
+     *
+     * @param params - New session request
+     * @returns New session response
+     */
+    newSession(params: ACPNewSessionRequest): Promise<ACPNewSessionResponse>;
+    /**
+     * Loads an existing session.
+     *
+     * @param params - Load session request
+     * @returns Session response with models and modes
+     */
+    loadSession(params: ACPLoadSessionRequest): Promise<ACPNewSessionResponse>;
+    /**
+     * Lists available sessions.
+     *
+     * @param params - List sessions request
+     * @returns List of sessions
+     */
+    listSessions(params: ACPListSessionsRequest): Promise<ACPListSessionsResponse>;
+    /**
+     * Forks an existing session.
+     *
+     * @param params - Fork session request
+     * @returns Forked session response
+     */
+    forkSession(params: ACPForkSessionRequest): Promise<ACPNewSessionResponse>;
+    /**
+     * Resumes a session without replaying history.
+     *
+     * @param params - Resume session request
+     * @returns Session response
+     */
+    resumeSession(params: ACPResumeSessionRequest): Promise<ACPNewSessionResponse>;
+    /**
+     * Handles a prompt request.
+     * Uses the SDK runner to leverage existing CLI functionality including tools,
+     * system prompt, and agentic loop.
+     *
+     * @param params - Prompt request
+     * @returns Prompt response
+     */
+    prompt(params: ACPPromptRequest): Promise<ACPPromptResponse>;
+    /**
+     * Sets the model for a session.
+     *
+     * @param params - Set model request
+     */
+    setSessionModel(params: ACPSetSessionModelRequest): Promise<{
+        _meta: Record<string, unknown>;
+    }>;
+    /**
+     * Sets the mode/agent for a session.
+     *
+     * @param params - Set mode request
+     */
+    setSessionMode(params: ACPSetSessionModeRequest): Promise<{
+        _meta: Record<string, unknown>;
+    }>;
+    /**
+     * Cancels an ongoing operation.
+     *
+     * @param params - Cancel notification
+     */
+    cancel(params: ACPCancelNotification): Promise<void>;
+    /**
+     * Gracefully shuts down the agent.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Initializes tool bridge and event adapter for a session.
+     */
+    private initializeSessionComponents;
+    /**
+     * Loads available models, modes, and commands for a session.
+     * Filters models to only include those from providers with configured API keys.
+     */
+    private loadSessionCapabilities;
+    /**
+     * Replays session history to ACP client.
+     */
+    private replaySessionHistory;
+    /**
+     * Handles slash commands.
+     */
+    private handleSlashCommand;
+}
+/**
+ * Creates a new ACPAgent instance.
+ *
+ * @param config - Agent configuration
+ * @param sessionManager - Optional custom session manager
+ * @returns A new ACPAgent instance
+ */
+export declare function createACPAgent(config: ACPConfig, sessionManager?: ACPSessionManager): ACPAgent;
+//# sourceMappingURL=agent.d.ts.map

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

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