@agent-link/agent 0.1.338 → 0.1.340

package/dist/copilot.d.ts

@@ -1,19 +1,26 @@
 /**
  * Copilot CLI process driver for AgentLink.
  *
- * Parallel to claude.ts but simpler:
- * - Each turn spawns a new `copilot --output-format json` process
- * - Prompt is written to stdin to avoid command-line length limits
- * - No persistent process, no control_request protocol
- * - JSONL stdout parsed and emitted as backend_event messages
- * - Session state stored at ~/.copilot/session-state/<id>/
+ * Parallel to claude.ts, with a conversation-scoped persistent SDK runtime:
+ * - Chat, Plan, /goal, and /compact share one provider Session; discovery is static
+ * - Agency attachments use SDK; Direct native attachments retain the CLI fallback
+ * - Provider events are normalized into backend_event messages
+ * - Session state remains stored at ~/.copilot/session-state/<id>/
  */
 import { type ChildProcess } from 'child_process';
+import { CopilotReviewDocuments, type CopilotReviewDocument } from './copilot-review-documents.js';
+import { type CopilotUserRequest } from './copilot-user-requests.js';
+import { CopilotCompactionBarrier } from './copilot-compaction-barrier.js';
+import { CopilotCompactionLifecycle, type CopilotCompactionRecord } from './copilot-compaction-lifecycle.js';
 import type { SendFn } from './claude.js';
 import type { SessionInfo } from './history.js';
 import { type HistoryMessage } from './history-message-transform.js';
-import { copilotCapabilities } from './backends/types.js';
+import { copilotCapabilities, type UsageInfo } from './backends/types.js';
+import { CopilotCommandRuntime } from './copilot-command-bridge.js';
+import type { ProviderCommand } from './provider-command-types.js';
+import { type CopilotConfiguration } from './copilot-configuration.js';
 export interface CopilotConversationState {
+    configuration?: CopilotConfiguration;
     conversationId: string;
     child: ChildProcess | null;
     abortController: AbortController | null;
@@ -21,6 +28,8 @@ export interface CopilotConversationState {
     lastCopilotSessionId: string | null;
     workDir: string;
     turnActive: boolean;
+    turnStartedAt?: number;
+    userRequest?: CopilotUserRequest;
     providerId: string;
     model: string | null;
     contextTier: CopilotContextTier | null;
@@ -30,9 +39,100 @@ export interface CopilotConversationState {
     heartbeatTimer: ReturnType<typeof setInterval> | null;
     /** True once we've sent session_started for sidebar refresh */
     sessionNotified: boolean;
+    copilotMode: CopilotSessionMode;
+    planMode: boolean;
+    planModePending: boolean;
+    isCompacting: boolean;
+    commandRuntime: CopilotCommandRuntime | null;
+    commandSessionId: string | null;
+    deferredCommandUsage: UsageInfo | null;
+    runtimeInitPromise: Promise<void> | null;
+    runtimeDisposal: Promise<void> | null;
+    runtimeConfigKey: string | null;
+    runtimeGeneration: number;
+    runtimeUnused: boolean;
+    cachedCommands: ProviderCommand[] | null;
+    activeOperation: 'chat' | 'command' | 'auto-compact' | null;
+    activeCommand?: CopilotNativeCommand;
+    /** A changed configuration skips maintenance before its first real request. */
+    skipNextPreRequestCompaction?: boolean;
+    lastUsage: UsageInfo | null;
+    contextUsageBeforeOptionsChange?: UsageInfo;
+    /** Invalidates a recount across native usage, compaction and cancellation. */
+    contextMeasurementVersion?: number;
+    contextPublishSequence?: number;
+    nativeContextFloor?: {
+        generation: number;
+        key: string;
+        tokens: number;
+        at: number;
+        activity: number;
+    };
+    contextActivityVersion?: number;
+    compactionBarrier?: CopilotCompactionBarrier;
+    compactionStartAt?: number;
+    compactionBase?: {
+        systemTokens?: number;
+        toolDefinitionsTokens?: number;
+        currentTokens?: number;
+        conversationTokens?: number;
+        model?: string;
+        contextTier?: string;
+        generation: number;
+    };
+    publishedUsage?: UsageInfo | null;
+    pendingTurnCompletion?: boolean;
+    contextCompactionAt?: number;
+    contextBoundarySessionId?: string;
+    compactionEventKeys?: Set<string>;
+    lastCompactionEventAt?: number;
+    compactionLifecycle?: CopilotCompactionLifecycle;
+    compactionLifecycleGeneration?: number;
+    compactionRecord?: CopilotCompactionRecord;
+    compactionRecords?: Map<string, CopilotCompactionRecord>;
+    compactionPublications?: Map<string, string>;
+    autoCompactionWatermark: string | null;
+    autoCompactionPending: boolean;
+    compactionFailed: boolean;
+    compactionTrigger: string | null;
+    /** Allow the next provider usage sample to cross a confirmed compaction boundary. */
+    contextUsageDecreaseAllowed: boolean;
+    /** Actual session usage reported during maintenance, committed only on success. */
+    pendingCompactionUsage?: Partial<UsageInfo> | null;
+    compactionHasConfirmedUsage?: boolean;
+    toolNamesByCallId: Map<string, string>;
+    toolStartKeys?: Set<string>;
+    reviewDocuments?: CopilotReviewDocuments;
+    streamedMessageTextById: Map<string, string>;
+    finalizedMessageIds: Set<string>;
+    lastMainMessageId?: string;
+    pendingMainReply?: {
+        id: string;
+        text: string;
+        published: boolean;
+    };
+    assistantReplyStarted?: boolean;
+    subagentMessages?: Map<string, Map<string, {
+        text: string;
+        thinking: string;
+    }>>;
+    subagentToolIds?: Map<string, string>;
+    /** Agency ACP text is held until reasoning and tool blocks for the turn finish. */
+    agencyResponseBuffer: string;
+    taskCompleteReplyEmitted: boolean;
+    taskCompleteSucceeded: boolean;
+    pendingPlanReview: PendingCopilotPlanReview | null;
+    nativePlanExit?: boolean;
+    planControlPending?: boolean;
+    readyPlanId: string | null;
+    planImplementationStarting: boolean;
+    createdAt: number;
+    lastActivityAt: number;
+    timestampMessageId?: string;
 }
 export type CopilotContextTier = 'default' | 'long_context';
 export type CopilotReasoningEffort = 'none' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export type CopilotSessionMode = 'interactive' | 'plan' | 'autopilot';
 export interface CopilotRunOptions {
     model?: string;
     context?: string;
@@ -48,7 +148,58 @@ interface CopilotChatFile {
     mimeType: string;
     data: string;
 }
+export declare const COPILOT_AUTO_COMPACTION_THRESHOLD: 0.8;
+export declare const COPILOT_IDLE_CONVERSATION_TIMEOUT_MS: number;
+export declare const COPILOT_STALE_RUNTIME_TIMEOUT_MS: number;
+export declare const COPILOT_MAX_CONVERSATIONS = 15;
+interface CopilotDecisionRequestPayload {
+    reviewDocuments?: CopilotReviewDocument[];
+    questions: Array<{
+        question: string;
+        header?: string;
+        options: Array<{
+            label: string;
+            value?: string;
+            description?: string;
+        }>;
+        multiSelect?: boolean;
+    }>;
+    source: 'tool_request_user_input';
+    presentation: 'inline';
+    kind?: 'plan_input';
+    allowFreeform: boolean;
+    expiresAt?: number;
+    timeoutAction?: 'first_option' | 'continue_plan';
+}
+interface PendingCopilotPlanReview {
+    sessionId: string;
+    content?: string;
+    languageHint: string;
+}
+export interface CopilotPlanQuestion {
+    question: string;
+    options: Array<{
+        label: string;
+        description?: string;
+    }>;
+    multiSelect?: boolean;
+}
+interface CopilotPlanAnswerRecord extends CopilotPlanQuestion {
+    answer: string;
+}
+export interface PendingCopilotDecisionSnapshot {
+    requestId: string;
+    conversationId: string;
+    providerId: string;
+    sessionId: string;
+    request: CopilotDecisionRequestPayload;
+}
 export declare function addCopilotSendFn(fn: SendFn): () => void;
+export declare function getPendingCopilotDecisions(conversationId: string): PendingCopilotDecisionSnapshot[];
+export declare function handleCopilotUserAnswer(requestId: string, answers: Record<string, unknown>, scope?: {
+    conversationId?: string;
+    providerId?: string;
+}): boolean;
 export declare function getCopilotConversation(conversationId: string): CopilotConversationState | undefined;
 export declare function getCopilotConversations(): Map<string, CopilotConversationState>;
 /**
@@ -63,23 +214,48 @@ export declare function createCopilotPlaceholder(conversationId: string, opts?:
 export declare function restartCopilotConversation(conversationId: string, opts?: {
     providerId?: string;
     model?: string;
+    preserveSession?: boolean;
 }): {
     wasTurnActive: boolean;
     copilotSessionId: string | null;
 };
 export declare function setModel(conversationId: string | undefined, model: string): void;
+export type CopilotNativeCommand = 'compact' | 'plan' | 'goal';
+/** Change routing without allocating a replacement native Session or Runtime. */
+export declare function setCopilotProvider(conversationId: string, providerId: string, options?: {
+    resumeSessionId?: string;
+    workDir?: string;
+    restoreOnly?: boolean;
+}): string;
+export declare function parseCopilotPlanAnswerHistory(content: string): CopilotPlanAnswerRecord[];
+export declare function extractCopilotPlanQuestions(content: string): CopilotPlanQuestion[];
+export declare function discoverCopilotCommandsForConversation(_conversationId: string, _providerId: string, _workDir: string, _copilotOptions?: CopilotRunOptions): Promise<ProviderCommand[]>;
+export declare function executeCopilotCommand(conversationId: string, command: CopilotNativeCommand, input: string, workDir: string, options?: CopilotChatOptions): Promise<void>;
+export declare function setCopilotPlanMode(conversationId: string, enabled: boolean, workDir: string, providerId?: string, copilotOptions?: CopilotRunOptions, resumeSessionId?: string): Promise<void>;
+export declare function startCopilotPlanImplementation(conversationId: string, planId: string, workDir: string, options?: {
+    providerId?: string;
+    resumeSessionId?: string;
+    prompt?: string;
+    copilotOptions?: CopilotRunOptions;
+}): Promise<void>;
 export interface CopilotChatOptions {
+    /** User-visible input for implicit Plan dispatch; never the expanded prompt. */
+    displayPrompt?: string;
     resumeSessionId?: string;
     providerId?: string;
     copilotOptions?: CopilotRunOptions;
+    forkSourceSessionId?: string;
+    /** Internal: mode override for the legacy native-attachment CLI path. */
+    oneShotMode?: 'plan' | 'autopilot';
 }
 export declare function normalizeCopilotRunOptions(input?: CopilotRunOptions): {
     options: NormalizedCopilotRunOptions;
     error?: string;
 };
-export declare function handleCopilotChat(conversationId: string, text: string, workDir: string, options?: CopilotChatOptions, files?: CopilotChatFile[]): void;
+export declare function handleCopilotChat(conversationId: string, text: string, workDir: string, options?: CopilotChatOptions, files?: CopilotChatFile[]): Promise<void>;
 export declare function cancelCopilotExecution(conversationId: string): void;
 export declare function cleanupAllCopilotConversations(): void;
+export declare function readCopilotSessionProvider(sessionId: string): string | undefined;
 interface CopilotSessionPage {
     sessions: SessionInfo[];
     hasMore: boolean;
@@ -93,6 +269,10 @@ interface CopilotGlobalSessionInfo {
     title: string;
     firstPrompt: string;
     lastModified: number;
+    providerId?: string;
+    isFork?: boolean;
+    forkNumber?: number;
+    forkSourceSessionId?: string;
 }
 interface CopilotGlobalSessionPage {
     sessions: CopilotGlobalSessionInfo[];
@@ -100,6 +280,10 @@ interface CopilotGlobalSessionPage {
     nextCursor?: string;
     indexState: 'ready';
 }
+export declare function listCopilotSessionsPageAsync(workDir: string, options?: {
+    limit?: number;
+    cursor?: string;
+}): Promise<CopilotSessionPage>;
 export declare function listCopilotSessions(workDir: string, options?: {
     strictReadErrors?: boolean;
 }): SessionInfo[];
@@ -111,6 +295,8 @@ export declare function listCopilotSessionsPage(workDir: string, options?: {
 export declare function readCopilotSessionMessages(_workDir: string, sessionId: string, options?: {
     strictReadErrors?: boolean;
 }): HistoryMessage[];
+export declare function readCopilotSessionMode(sessionId: string): CopilotSessionMode;
+export declare function readCopilotSessionUsage(sessionId: string): UsageInfo | null;
 export declare function getCopilotSessionWorkDir(sessionId: string): string | undefined;
 export declare function listAllCopilotSessions(limit?: number): Array<{
     sessionId: string;
@@ -119,12 +305,19 @@ export declare function listAllCopilotSessions(limit?: number): Array<{
     title: string;
     firstPrompt: string;
     lastModified: number;
+    isFork?: boolean;
+    forkNumber?: number;
+    forkSourceSessionId?: string;
 }>;
 export declare function listAllCopilotSessionsPage(options?: {
     limit?: number;
     cursor?: string;
 }): CopilotGlobalSessionPage;
+export declare function listAllCopilotSessionsPageAsync(options?: {
+    limit?: number;
+    cursor?: string;
+}): Promise<CopilotGlobalSessionPage>;
 export declare function renameCopilotSession(_workDir: string, sessionId: string, newTitle: string): boolean;
 export declare function moveCopilotSession(_fromWorkDir: string, toWorkDir: string, sessionId: string): boolean;
-export declare function deleteCopilotSession(_workDir: string, sessionId: string): boolean;
+export declare function deleteCopilotSession(_workDir: string, sessionId: string): Promise<boolean>;
 export { copilotCapabilities };