@agent-link/agent 0.1.338 → 0.1.339

package/dist/copilot-turn-journal.js

@@ -0,0 +1,246 @@
+import { closeSync, openSync, readSync, statSync } from 'fs';
+import { isCopilotChildEvent } from './copilot-event-scope.js';
+/** Request-scoped, read-only reconciliation of the Provider's own event journal. */
+export class CopilotTurnJournal {
+    path;
+    onEvent;
+    offset = 0;
+    partial = Buffer.alloc(0);
+    seen = new Set();
+    tasks = new Set();
+    completedTasks = new Set();
+    childRuns = new Map();
+    childWrites = new Map();
+    continuation = false;
+    currentTurn;
+    finalTurn;
+    finalEnded = false;
+    finalCheckpoint = false;
+    compacting = false;
+    pendingInputs = new Set();
+    complete = false;
+    constructor(path, onEvent) {
+        this.path = path;
+        this.onEvent = onEvent;
+        try {
+            this.offset = statSync(path).size;
+        }
+        catch { /* New sessions may not have a journal yet. */ }
+    }
+    get pending() {
+        return this.tasks.size > 0 || this.childrenPending || this.continuation || this.compacting || this.pendingInputs.size > 0;
+    }
+    get childrenPending() {
+        return [...this.childRuns.values()].some(run => run.active || run.writes.size > 0);
+    }
+    observeChildRuns(event) {
+        const data = event.data || {};
+        const agentId = event.agentId || data.agentId;
+        const getRun = (id) => {
+            let run = this.childRuns.get(id);
+            if (!run) {
+                run = { active: false, initial: false, writes: new Set() };
+                this.childRuns.set(id, run);
+            }
+            return run;
+        };
+        const write = (id, name, args) => {
+            if (!id || name !== 'write_agent' || typeof args?.agent_id !== 'string' || this.childWrites.has(id))
+                return;
+            this.childWrites.set(id, args.agent_id);
+            getRun(args.agent_id).writes.add(id);
+            this.continuation = true;
+            this.resetFinal();
+        };
+        if (event.type === 'tool.execution_start')
+            write(data.toolCallId, data.toolName, data.arguments);
+        if (event.type === 'assistant.message') {
+            for (const tool of data.toolRequests || [])
+                write(tool.toolCallId, tool.name, tool.arguments);
+        }
+        if (event.type === 'tool.execution_complete' && data.success === false) {
+            const target = this.childWrites.get(data.toolCallId);
+            if (target)
+                getRun(target).writes.delete(data.toolCallId);
+        }
+        if (!agentId)
+            return;
+        const run = getRun(agentId);
+        if (event.type === 'subagent.started') {
+            run.active = true;
+            run.initial = true;
+        }
+        if (event.type === 'user.message') {
+            if (data.interactionId && data.interactionId === run.interaction)
+                return;
+            if (run.initial) {
+                run.initialInteraction = data.interactionId;
+                run.initial = false;
+            }
+            else {
+                const first = run.writes.values().next().value;
+                if (first)
+                    run.writes.delete(first);
+            }
+            run.interaction = data.interactionId;
+            run.active = true;
+            run.finalTurn = undefined;
+            this.continuation = true;
+            this.resetFinal();
+        }
+        if (event.type === 'assistant.turn_start') {
+            run.active = true;
+            run.finalTurn = undefined;
+        }
+        if (event.type === 'assistant.message' && !data.toolRequests?.length
+            && (data.phase === 'final_answer' || (!data.phase && data.content?.trim())))
+            run.finalTurn = data.turnId;
+        if (event.type === 'assistant.turn_end' && run.finalTurn !== undefined && data.turnId === run.finalTurn) {
+            run.active = false;
+            run.finalTurn = undefined;
+        }
+        // subagent.completed acknowledges initial dispatch only. It must not settle
+        // queued write_agent work or a newer interaction already running on that ID.
+        if (['subagent.completed', 'subagent.failed'].includes(event.type || '')
+            && (!run.interaction || run.interaction === run.initialInteraction))
+            run.active = false;
+    }
+    resetFinal() {
+        this.finalTurn = undefined;
+        this.finalEnded = false;
+        this.finalCheckpoint = false;
+        this.complete = false;
+    }
+    read() {
+        let fd;
+        try {
+            const size = statSync(this.path).size;
+            if (size < this.offset) {
+                this.offset = 0;
+                this.partial = Buffer.alloc(0);
+            }
+            if (size === this.offset)
+                return;
+            fd = openSync(this.path, 'r');
+            // Bound work per tick; keep UTF-8 bytes intact across partial writes.
+            let budget = 4 * 1024 * 1024;
+            while (this.offset < size && budget > 0) {
+                const bytes = Buffer.alloc(Math.min(256 * 1024, size - this.offset, budget));
+                const count = readSync(fd, bytes, 0, bytes.length, this.offset);
+                if (!count)
+                    break;
+                this.offset += count;
+                budget -= count;
+                this.partial = Buffer.concat([this.partial, bytes.subarray(0, count)]);
+                let end;
+                while ((end = this.partial.indexOf(10)) >= 0) {
+                    const line = this.partial.subarray(0, end).toString('utf8');
+                    this.partial = this.partial.subarray(end + 1);
+                    let event;
+                    try {
+                        event = JSON.parse(line);
+                    }
+                    catch {
+                        continue;
+                    }
+                    this.observe(event);
+                }
+            }
+        }
+        catch { /* Missing/locked journals must not fail or create Provider sessions. */ }
+        finally {
+            if (fd !== undefined)
+                closeSync(fd);
+        }
+    }
+    observe(event) {
+        if (event.id && this.seen.has(event.id))
+            return;
+        if (event.id)
+            this.seen.add(event.id);
+        const data = event.data || {};
+        const child = isCopilotChildEvent(event);
+        this.observeChildRuns(event);
+        const addTask = (id, name, args) => {
+            if (id && name === 'task' && args?.mode === 'background' && !this.completedTasks.has(id)) {
+                this.tasks.add(id);
+                this.continuation = true;
+                this.resetFinal();
+            }
+        };
+        if (event.type === 'tool.execution_start')
+            addTask(data.toolCallId, data.toolName, data.arguments);
+        if (event.type === 'assistant.message') {
+            for (const tool of data.toolRequests || [])
+                addTask(tool.toolCallId, tool.name, tool.arguments);
+        }
+        if (event.type === 'subagent.started' && data.toolCallId && !this.completedTasks.has(data.toolCallId)) {
+            this.tasks.add(data.toolCallId);
+            this.continuation = true;
+            this.resetFinal();
+        }
+        if (event.type === 'subagent.completed' || event.type === 'subagent.failed'
+            || (event.type === 'tool.execution_complete' && data.success === false && this.tasks.has(data.toolCallId))) {
+            this.tasks.delete(data.toolCallId);
+            this.completedTasks.add(data.toolCallId);
+            if (event.type === 'tool.execution_complete' && this.tasks.size === 0)
+                this.continuation = false;
+        }
+        if (!child) {
+            if (event.type === 'assistant.turn_start' || event.type === 'assistant.message') {
+                if (typeof data.turnId === 'string')
+                    this.currentTurn = data.turnId;
+            }
+            if (event.type === 'assistant.turn_start') {
+                this.resetFinal();
+            }
+            if (event.type === 'session.compaction_start') {
+                this.compacting = true;
+                this.complete = false;
+            }
+            if (event.type === 'session.compaction_complete' || event.type === 'session.compaction_failed')
+                this.compacting = false;
+            if (event.type === 'user_input.requested' && data.requestId)
+                this.pendingInputs.add(data.requestId);
+            if (event.type === 'user_input.completed')
+                this.pendingInputs.delete(data.requestId);
+            if (event.type === 'assistant.message' && data.phase === 'final_answer'
+                && !data.toolRequests?.length && this.tasks.size === 0 && !this.childrenPending) {
+                // The Provider can finish with an explicitly empty final after having
+                // already published its answer and performed follow-up verification.
+                // Content is not lifecycle evidence; still require this main turn's
+                // end/checkpoint and every pending-work gate below before completing.
+                this.resetFinal();
+                this.finalTurn = data.turnId;
+            }
+            else if (event.type === 'tool.execution_start' || event.type === 'user_input.requested') {
+                this.resetFinal();
+            }
+            // Goal can finish exclusively through task_complete (empty assistant
+            // content + tool request), with no phase:final_answer message. Bind its
+            // authoritative success to the main native turn, then still require the
+            // matching turn end/checkpoint and all existing completion gates.
+            if (event.type === 'session.task_complete' && data.success === true && this.currentTurn !== undefined) {
+                this.resetFinal();
+                this.finalTurn = this.currentTurn;
+                this.continuation = true;
+            }
+            if (event.type === 'assistant.turn_end' && this.finalTurn !== undefined && data.turnId === this.finalTurn) {
+                this.finalEnded = true;
+            }
+            // The final checkpoint can precede background compaction completion.
+            // Retain that evidence for this final turn so clearing the compaction
+            // gate does not require a second checkpoint that may never arrive.
+            if (event.type === 'session.usage_checkpoint' && this.finalEnded)
+                this.finalCheckpoint = true;
+            if ((event.type === 'session.usage_checkpoint' || event.type === 'session.compaction_complete'
+                || event.type === 'session.compaction_failed') && this.finalCheckpoint && this.finalEnded && !this.compacting
+                && this.tasks.size === 0 && !this.childrenPending && this.pendingInputs.size === 0) {
+                this.continuation = false;
+                this.complete = true;
+            }
+        }
+        this.onEvent(event);
+    }
+}
+//# sourceMappingURL=copilot-turn-journal.js.map

package/dist/copilot-turn-journal.js.map

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

package/dist/copilot-user-requests.d.ts

@@ -0,0 +1,11 @@
+import type { HistoryMessage } from './history-message-transform.js';
+export interface CopilotUserRequest extends HistoryMessage {
+    role: 'user';
+    copilotRequestId: string;
+    copilotRequestState: 'pending' | 'delivered' | 'cancelled' | 'failed';
+    backendTurnId: string;
+    timestamp: string;
+}
+export declare function readCopilotUserRequests(root: string, sessionId: string): CopilotUserRequest[];
+export declare function saveCopilotUserRequest(root: string, sessionId: string, request: CopilotUserRequest): void;
+export declare function mergeCopilotUserRequests(history: HistoryMessage[], requests: CopilotUserRequest[], liveRequestId?: string): HistoryMessage[];

package/dist/copilot-user-requests.js

@@ -0,0 +1,84 @@
+import { existsSync, readFileSync } from 'fs';
+import { join, resolve, sep } from 'path';
+import { atomicWriteCopilotSidecar } from './copilot-sidecar.js';
+const FILE = '.agentlink-user-requests.json';
+function requestFile(root, sessionId) {
+    const base = resolve(root), dir = resolve(root, sessionId);
+    if (!dir.startsWith(base + sep))
+        throw new Error('Invalid Copilot request Session');
+    return join(dir, FILE);
+}
+export function readCopilotUserRequests(root, sessionId) {
+    const file = requestFile(root, sessionId);
+    if (!existsSync(file))
+        return [];
+    const stored = JSON.parse(readFileSync(file, 'utf8'));
+    if (stored.version !== 1 || !Array.isArray(stored.requests)
+        || stored.requests.some((r) => !r || r.role !== 'user'
+            || typeof r.copilotRequestId !== 'string' || typeof r.content !== 'string'
+            || !['pending', 'delivered', 'cancelled', 'failed'].includes(r.copilotRequestState))) {
+        throw new Error('Invalid Copilot user-request history');
+    }
+    return stored.requests;
+}
+export function saveCopilotUserRequest(root, sessionId, request) {
+    const file = requestFile(root, sessionId);
+    if (!existsSync(resolve(root, sessionId)))
+        return; // A new Session is not created for bookkeeping.
+    const requests = readCopilotUserRequests(root, sessionId);
+    const index = requests.findIndex(row => row.copilotRequestId === request.copilotRequestId);
+    if (index < 0)
+        requests.push({ ...request });
+    else
+        requests[index] = { ...request };
+    atomicWriteCopilotSidecar(file, JSON.stringify({ version: 1, requests }));
+}
+// Only pending submissions without a live owner are cancelled on restore. They
+// remain visible, but are never automatically submitted after an Agent restart.
+export function mergeCopilotUserRequests(history, requests, liveRequestId) {
+    const rows = history.map(row => ({ ...row }));
+    const ordered = [...requests].sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
+    const normalize = (text) => text.replace(/^\/(plan|goal)\s+/, '').trim();
+    for (let i = 0; i < ordered.length; i++) {
+        const request = ordered[i];
+        let target = rows.find(row => row.copilotRequestId === request.copilotRequestId
+            || (request.copilotUserMessageId && row.copilotUserMessageId === request.copilotUserMessageId));
+        // Native history can flush just before the SDK callback associates its ID.
+        // Match only one exact request in its submission interval, never globally
+        // deduplicate equal text from separate turns or cancelled attempts.
+        if (!target) {
+            const start = Date.parse(request.timestamp), end = Date.parse(ordered[i + 1]?.timestamp) || Infinity;
+            target = rows.find(row => row.role === 'user' && row.copilotUserMessageId && !row.copilotRequestId
+                && Date.parse(row.timestamp || '') >= start && Date.parse(row.timestamp || '') < end
+                && normalize(row.content) === normalize(request.content));
+        }
+        if (target) {
+            target.copilotRequestId = request.copilotRequestId;
+            target.copilotRequestState = 'delivered';
+            // Preflight compaction precedes the CLI's user event, but follows the
+            // user's actual submission. Keep native in-turn compactions untouched.
+            const targetIndex = rows.indexOf(target);
+            const acceptedAt = Date.parse(request.timestamp), nativeAt = Date.parse(target.timestamp || '');
+            let first = targetIndex;
+            while (first > 0 && rows[first - 1].compaction) {
+                const compact = rows[first - 1].compaction;
+                if (compact.scope !== 'main' || compact.startedAt == null || compact.startedAt < acceptedAt
+                    || compact.completedAt == null || compact.completedAt > nativeAt)
+                    break;
+                first--;
+            }
+            if (first < targetIndex) {
+                target.timestamp = request.timestamp;
+                rows.splice(targetIndex, 1);
+                rows.splice(first, 0, target);
+            }
+            continue;
+        }
+        const row = { ...request, copilotRequestState: request.copilotRequestState === 'pending'
+                && request.copilotRequestId !== liveRequestId ? 'cancelled' : request.copilotRequestState };
+        const index = rows.findIndex(value => Date.parse(value.timestamp || '') > Date.parse(row.timestamp));
+        rows.splice(index < 0 ? rows.length : index, 0, row);
+    }
+    return rows;
+}
+//# sourceMappingURL=copilot-user-requests.js.map

package/dist/copilot-user-requests.js.map

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

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[];
@@ -111,6 +291,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,6 +301,9 @@ 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;
@@ -126,5 +311,5 @@ export declare function listAllCopilotSessionsPage(options?: {
 }): 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 };