cursor-opencode-provider 0.8.0 → 0.8.1

package/dist/pricing-data.d.ts

@@ -25,6 +25,12 @@ export declare const CURSOR_MODEL_COSTS: {
         readonly cache_read: 0.1;
         readonly cache_write: 1.25;
     };
+    readonly "claude-haiku-5-5": {
+        readonly input: 0.1;
+        readonly output: 0.5;
+        readonly cache_read: 0.01;
+        readonly cache_write: 0.125;
+    };
     readonly "claude-opus-4-5": {
         readonly input: 5;
         readonly output: 25;
@@ -94,7 +100,7 @@ export declare const CURSOR_MODEL_COSTS: {
     readonly "claude-sonnet-5-5": {
         readonly input: 2;
         readonly output: 10;
-        readonly cache_read: 0.2;
+        readonly cache_read: 0.1;
         readonly cache_write: 2.5;
     };
     readonly "composer-2.5": {
@@ -311,6 +317,10 @@ export declare const CURSOR_MODEL_CONTEXTS: {
     readonly "claude-haiku-4-5": {
         readonly maxContext: 200000;
     };
+    readonly "claude-haiku-5-5": {
+        readonly maxContext: 300000;
+        readonly maxContextForMaxMode: 1000000;
+    };
     readonly "claude-opus-4-5": {
         readonly maxContext: 200000;
         readonly maxContextForMaxMode: 200000;
@@ -465,6 +475,9 @@ export declare const CURSOR_MODEL_CAPABILITIES: {
     readonly "claude-haiku-4-5": {
         readonly supportsImages: true;
     };
+    readonly "claude-haiku-5-5": {
+        readonly supportsImages: true;
+    };
     readonly "claude-opus-4-5": {
         readonly supportsImages: true;
     };

package/dist/pricing-data.js

@@ -25,6 +25,12 @@ export const CURSOR_MODEL_COSTS = {
         "cache_read": 0.1,
         "cache_write": 1.25
     },
+    "claude-haiku-5-5": {
+        "input": 0.1,
+        "output": 0.5,
+        "cache_read": 0.01,
+        "cache_write": 0.125
+    },
     "claude-opus-4-5": {
         "input": 5,
         "output": 25,
@@ -94,7 +100,7 @@ export const CURSOR_MODEL_COSTS = {
     "claude-sonnet-5-5": {
         "input": 2,
         "output": 10,
-        "cache_read": 0.2,
+        "cache_read": 0.1,
         "cache_write": 2.5
     },
     "composer-2.5": {
@@ -311,6 +317,10 @@ export const CURSOR_MODEL_CONTEXTS = {
     "claude-haiku-4-5": {
         "maxContext": 200000
     },
+    "claude-haiku-5-5": {
+        "maxContext": 300000,
+        "maxContextForMaxMode": 1000000
+    },
     "claude-opus-4-5": {
         "maxContext": 200000,
         "maxContextForMaxMode": 200000
@@ -465,6 +475,9 @@ export const CURSOR_MODEL_CAPABILITIES = {
     "claude-haiku-4-5": {
         "supportsImages": true
     },
+    "claude-haiku-5-5": {
+        "supportsImages": true
+    },
     "claude-opus-4-5": {
         "supportsImages": true
     },

package/dist/protocol/ask-question.d.ts

@@ -76,6 +76,13 @@ export declare function decodeAskQuestionQuery(queryBytes: Uint8Array): DecodedA
 export declare function isCatchAllOptionLabel(label: string): boolean;
 /** Options as Cursor would display them: trailing catch-all removed. */
 export declare function displayOptions(question: CursorAskQuestionItem): CursorAskQuestionOption[];
+/** OpenCode `Question.Prompt.header`: short label, max 30 chars. */
+export declare function questionHeader(title: string): string;
+/**
+ * Fill required OpenCode `question` fields when a model call omits them.
+ * Live OC1 failure: SchemaError Missing key at ["questions"][0]["header"].
+ */
+export declare function normalizeOpencodeQuestionArgs(args: Record<string, unknown>): Record<string, unknown>;
 export type OpencodeQuestionInput = {
     questions: Array<{
         question: string;
@@ -100,12 +107,16 @@ export declare function asyncResult(): AskQuestionResultMessage;
 /**
  * Pull each question's answer text out of a host `question` tool output.
  *
- * OpenCode returns prose (`metadata.answers` does not cross the AI SDK
+ * OpenCode 1.x returns prose (`metadata.answers` does not cross the AI SDK
  * boundary):
  *
  *   User has answered your questions: "<q1>"="<a, b>", "<q2>"="Unanswered". You
  *   can now continue with the user's answers in mind.
  *
+ * OpenCode 2.0 sends the tool's declared output as JSON
+ * (`{ "answers": [["Yes"], …] }`) and does not put that prose on the AI SDK
+ * tool-result. Answers are positional.
+ *
  * The prose is located by its `"<question>"="` anchor — robust
  * against commas, quotes and `"="` inside question or answer text, and against
  * duplicate questions. Returns undefined for a question whose anchor is

package/dist/protocol/ask-question.js

@@ -183,7 +183,8 @@ export function displayOptions(question) {
         return question.options.slice(0, -1);
     return question.options.slice();
 }
-function header(title) {
+/** OpenCode `Question.Prompt.header`: short label, max 30 chars. */
+export function questionHeader(title) {
     const trimmed = title.trim();
     if (!trimmed)
         return "Question";
@@ -191,6 +192,40 @@ function header(title) {
         ? trimmed.slice(0, HEADER_MAX_LENGTH - 1).trimEnd() + "…"
         : trimmed;
 }
+/**
+ * Fill required OpenCode `question` fields when a model call omits them.
+ * Live OC1 failure: SchemaError Missing key at ["questions"][0]["header"].
+ */
+export function normalizeOpencodeQuestionArgs(args) {
+    if (!Array.isArray(args.questions))
+        return args;
+    return {
+        ...args,
+        questions: args.questions.map((item) => {
+            if (!item || typeof item !== "object" || Array.isArray(item))
+                return item;
+            const q = item;
+            const prompt = typeof q.question === "string" ? q.question : "";
+            const existing = typeof q.header === "string" ? q.header : "";
+            const options = Array.isArray(q.options)
+                ? q.options.map((opt) => {
+                    if (!opt || typeof opt !== "object" || Array.isArray(opt))
+                        return opt;
+                    const o = opt;
+                    return {
+                        ...o,
+                        ...(o.description === undefined ? { description: "" } : {}),
+                    };
+                })
+                : q.options;
+            return {
+                ...q,
+                header: questionHeader(existing.trim() || prompt),
+                options,
+            };
+        }),
+    };
+}
 /**
  * Build the OpenCode `question` tool input. `Question.Prompt` requires
  * `question`, `header`, and `options[{label, description}]`; Cursor options
@@ -200,7 +235,7 @@ export function askQuestionToolInput(args) {
     return {
         questions: args.questions.map((question) => ({
             question: question.prompt,
-            header: header(args.title),
+            header: questionHeader(args.title),
             options: displayOptions(question).map((option) => ({
                 label: option.label,
                 description: "",
@@ -220,18 +255,25 @@ export function asyncResult() {
 /**
  * Pull each question's answer text out of a host `question` tool output.
  *
- * OpenCode returns prose (`metadata.answers` does not cross the AI SDK
+ * OpenCode 1.x returns prose (`metadata.answers` does not cross the AI SDK
  * boundary):
  *
  *   User has answered your questions: "<q1>"="<a, b>", "<q2>"="Unanswered". You
  *   can now continue with the user's answers in mind.
  *
+ * OpenCode 2.0 sends the tool's declared output as JSON
+ * (`{ "answers": [["Yes"], …] }`) and does not put that prose on the AI SDK
+ * tool-result. Answers are positional.
+ *
  * The prose is located by its `"<question>"="` anchor — robust
  * against commas, quotes and `"="` inside question or answer text, and against
  * duplicate questions. Returns undefined for a question whose anchor is
  * absent, which is treated as unanswered rather than guessed at.
  */
 export function parseAnswerSegments(questions, output) {
+    const fromJson = parseJsonAnswerSegments(output, questions.length);
+    if (fromJson)
+        return fromJson;
     const answers = [];
     let cursor = 0;
     for (const question of questions) {
@@ -260,6 +302,38 @@ export function parseAnswerSegments(questions, output) {
     }
     return answers;
 }
+function cellText(cell) {
+    if (typeof cell === "string")
+        return cell;
+    if (typeof cell === "number" || typeof cell === "boolean")
+        return String(cell);
+    if (Array.isArray(cell)) {
+        const parts = cell.map((item) => (typeof item === "string" ? item : "")).filter(Boolean);
+        return parts.length > 0 ? parts.join(", ") : undefined;
+    }
+    return undefined;
+}
+/** OpenCode 2 `question` output `{ answers: string[][] }`, or a JSON array of cells. */
+function parseJsonAnswerSegments(output, count) {
+    const trimmed = output.trim();
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("["))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    const cells = Array.isArray(parsed)
+        ? parsed
+        : parsed && typeof parsed === "object" && Array.isArray(parsed.answers)
+            ? parsed.answers
+            : undefined;
+    if (!cells)
+        return undefined;
+    return Array.from({ length: count }, (_, index) => cellText(cells[index]));
+}
 /** OpenCode's placeholder for a question the user left blank. */
 const UNANSWERED = "Unanswered";
 /**

package/dist/protocol/create-plan.d.ts

@@ -7,10 +7,10 @@
  * does **not** — plans must stay host-portable so switching models does not
  * strand users on Cursor-specific paths or frontmatter.
  *
- * Location mirrors OpenCode Session.plan shape, but the project-config segment
- * comes from {@link hostPlansDir} / {@link opencodeProjectConfigDirs}
- * (the active host's project config dir via the path bridge), never a
- * hardcoded OpenCode-only directory name.
+ * Location is the host's own: the session plan file when the host defines one
+ * (`hostPlanFilePath`, OpenCode 1.x `Session.plan`), otherwise a new
+ * `<created>-<slug>.md` under {@link hostPlansDir} (OpenCode 2.0's Plan
+ * directory, OpenCode 1.x `<data>/plans`, or an installed path bridge).
  *
  * Body is plain markdown (the same shape a plan-mode model would write with
  * `write`). Cursor YAML frontmatter is never emitted.
@@ -58,46 +58,66 @@ export type CursorPlanStageInput = {
  *             Its tool result is the approval outcome (success = approved,
  *             error = not approved). The result may name the host's own
  *             follow-up approval call. This provider does not invent that prompt.
- * - `approve` no such tool, but the host advertises `question`: the provider
- *             writes the plan itself and then asks the same thing with upstream
- *             `PlanExitTool`'s own prompt.
- * - `ack`     nothing to ask with (or a lifecycle turn): write, or for a
- *             lifecycle turn skip the write, and acknowledge the CLI way.
+ * - `ack`     nothing to ask with (or a lifecycle turn / CreatePlan outside
+ *             plan mode): write, or for a lifecycle turn skip the write, and
+ *             acknowledge the CLI way.
+ * - `approve` plan mode is active and the host advertises `question` but not
+ *             a plan review tool: write the plan, then ask with upstream
+ *             `PlanExitTool`'s own prompt (OpenCode 1.x / 2.0 without
+ *             `plan_exit`). Explicit "Yes" is execution approval.
+ * - `exit`    the host's `plan` agent is active, advertises `plan_exit`, and
+ *             its own plan file is known: write the plan there and run the
+ *             host `plan_exit` review. The host owns approval and execution;
+ *             the turn that carries the result leaves `plan` only on approval.
+ * - `defer`   the host's `plan` agent owns planning but CreatePlan cannot be
+ *             carried out yet: an approved switch into it is still pending (it
+ *             applies after this Run), or its plan file is unknown. Nothing is
+ *             written; the error tells the model which host workflow follows.
  *
- * The plan is always persisted before any prompt: writing needs no approval,
- * executing does.
+ * The plan is always persisted before any review: writing needs no approval,
+ * executing does, and only the host asks for it.
  */
 export type CreatePlanBridge = {
     kind: "stage";
+} | {
+    kind: "ack";
 } | {
     kind: "approve";
 } | {
-    kind: "ack";
+    kind: "defer";
+    reason: string;
+} | {
+    kind: "exit";
+    planPath: string;
 };
+/** CreatePlan raised before an approved switch into the host plan agent took effect. */
+export declare const CREATE_PLAN_HOST_PLAN_PENDING_REASON: string;
+/** CreatePlan raised while the host's own plan agent owns the plan file and its review. */
+export declare const CREATE_PLAN_HOST_PLAN_WORKFLOW_REASON: string;
+/** Cursor-visible reason when the user wants the plan revised instead of run. */
+export declare const CREATE_PLAN_NOT_APPROVED_REASON: string;
 /** Upstream `PlanExitTool` wording, with the plan the provider just wrote. */
 export declare function createPlanApprovalQuestion(planLabel: string): string;
 export declare const CREATE_PLAN_APPROVAL_HEADER = "Build Agent";
-/** Cursor-visible reason when the user wants the plan revised instead of run. */
-export declare const CREATE_PLAN_NOT_APPROVED_REASON: string;
-/**
- * Resolve how this CreatePlan is satisfied. `planModeActive` is the provider's
- * own record of an approved Cursor plan/spec mode: the approval prompt guards
- * the transition *out of* planning, so a CreatePlan raised outside plan mode is
- * written and acknowledged without one.
- */
+/** Resolve how this CreatePlan is satisfied (see {@link CreatePlanBridge}). */
 export declare function resolveCreatePlanBridge(options: {
     allowTools: boolean;
     canStage?: boolean;
-    planModeActive?: boolean;
     advertised: ReadonlySet<string> | Iterable<string>;
+    /** An approved switch into the host `plan` agent waits for this Run to end. */
+    hostPlanEntryPending?: boolean;
+    /** Host primary agent of this Run, when the host reported it. */
+    hostAgent?: string;
+    /** Provider-recorded Cursor plan/spec mode (the gate out of planning). */
+    planModeActive?: boolean;
+    /** The host's own plan file for this session, when the host defines one. */
+    hostPlanFile?: string;
 }): CreatePlanBridge;
 /** Host `question` input mirroring upstream `PlanExitTool`'s own prompt. */
 export declare function createPlanApprovalQuestionInput(planLabel: string): OpencodeQuestionInput;
 /**
  * True when the emulated approval prompt came back as an explicit "Yes".
- * An unanswered, dismissed, or failed prompt keeps the model planning rather
- * than silently starting execution. OpenCode prose is anchored on the exact
- * prompt text. Every other result shape fails closed.
+ * An unanswered, dismissed, or failed prompt keeps the model planning.
  */
 export declare function createPlanApproved(output: string, isError: boolean, question: string): boolean;
 /** Decode a `create_plan_request_query` body, or undefined when unusable. */
@@ -125,7 +145,9 @@ export declare function renderOpencodePlanMarkdown(args: CursorCreatePlanArgs):
  * Write the plan under {@link hostPlansDir} and return a `file://` URI.
  * Empty / missing content is the caller's responsibility (empty plan_uri ack).
  */
-export declare function writeOpencodePlanFile(args: CursorCreatePlanArgs, workspaceRoot: string, created?: number): CreatePlanWriteResult;
+export declare function writeOpencodePlanFile(args: CursorCreatePlanArgs, workspaceRoot: string, created?: number, 
+/** Exact host-owned plan file; default is a new file under {@link hostPlansDir}. */
+target?: string): CreatePlanWriteResult;
 /**
  * The plan as the user reads it before approving execution.
  *

package/dist/protocol/create-plan.js

@@ -7,10 +7,10 @@
  * does **not** — plans must stay host-portable so switching models does not
  * strand users on Cursor-specific paths or frontmatter.
  *
- * Location mirrors OpenCode Session.plan shape, but the project-config segment
- * comes from {@link hostPlansDir} / {@link opencodeProjectConfigDirs}
- * (the active host's project config dir via the path bridge), never a
- * hardcoded OpenCode-only directory name.
+ * Location is the host's own: the session plan file when the host defines one
+ * (`hostPlanFilePath`, OpenCode 1.x `Session.plan`), otherwise a new
+ * `<created>-<slug>.md` under {@link hostPlansDir} (OpenCode 2.0's Plan
+ * directory, OpenCode 1.x `<data>/plans`, or an installed path bridge).
  *
  * Body is plain markdown (the same shape a plan-mode model would write with
  * `write`). Cursor YAML frontmatter is never emitted.
@@ -19,9 +19,9 @@ import { mkdirSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { hostPlansDir } from "../context/paths.js";
-import { parseAnswerSegments, } from "./ask-question.js";
 import { decodeMessageSparse } from "./messages.js";
 import { errorMessage } from "../debug.js";
+import { parseAnswerSegments, } from "./ask-question.js";
 const PLAN_ADJECTIVES = [
     "brave",
     "calm",
@@ -90,6 +90,17 @@ const PLAN_NOUNS = [
 export const CURSOR_PLAN_STAGE_TOOL = "cursor_plan_stage";
 /** Held InteractionQuery continuation field for a native host plan stage. */
 export const CREATE_PLAN_RESULT_FIELD = "create_plan_request_response";
+/** CreatePlan raised before an approved switch into the host plan agent took effect. */
+export const CREATE_PLAN_HOST_PLAN_PENDING_REASON = "Plan mode starts in the host's plan agent after this turn. Do not record the plan " +
+    "now and make no further tool calls: end this turn. Planning continues in the next " +
+    "turn under the host's plan-mode instructions.";
+/** CreatePlan raised while the host's own plan agent owns the plan file and its review. */
+export const CREATE_PLAN_HOST_PLAN_WORKFLOW_REASON = "This host's plan agent owns the plan file and its approval. Write the plan where the " +
+    "plan-mode instructions say, then call `plan_exit` to ask the user to approve it. Do " +
+    "not implement until it is approved.";
+/** Cursor-visible reason when the user wants the plan revised instead of run. */
+export const CREATE_PLAN_NOT_APPROVED_REASON = "The user did not approve executing this plan. Keep planning: refine the plan and "
+    + "propose it again when it is ready.";
 /** Upstream `PlanExitTool` wording, with the plan the provider just wrote. */
 export function createPlanApprovalQuestion(planLabel) {
     const where = planLabel.trim();
@@ -100,28 +111,28 @@ export function createPlanApprovalQuestion(planLabel) {
 export const CREATE_PLAN_APPROVAL_HEADER = "Build Agent";
 const CREATE_PLAN_APPROVAL_YES = "Yes";
 const CREATE_PLAN_APPROVAL_NO = "No";
-/** Cursor-visible reason when the user wants the plan revised instead of run. */
-export const CREATE_PLAN_NOT_APPROVED_REASON = "The user did not approve executing this plan. Keep planning: refine the plan and "
-    + "propose it again when it is ready.";
-/**
- * Resolve how this CreatePlan is satisfied. `planModeActive` is the provider's
- * own record of an approved Cursor plan/spec mode: the approval prompt guards
- * the transition *out of* planning, so a CreatePlan raised outside plan mode is
- * written and acknowledged without one.
- */
+/** Resolve how this CreatePlan is satisfied (see {@link CreatePlanBridge}). */
 export function resolveCreatePlanBridge(options) {
     // A lifecycle turn (title generation, compaction) runs alongside the real one
     // and must not write a second plan file or raise a second prompt.
     if (!options.allowTools)
         return { kind: "ack" };
+    if (options.hostPlanEntryPending) {
+        return { kind: "defer", reason: CREATE_PLAN_HOST_PLAN_PENDING_REASON };
+    }
     if (options.canStage)
         return { kind: "stage" };
     const names = options.advertised instanceof Set ? options.advertised : new Set(options.advertised);
-    if (options.planModeActive && names.has("question"))
+    if (options.hostAgent === "plan" && names.has("plan_exit")) {
+        return options.hostPlanFile
+            ? { kind: "exit", planPath: options.hostPlanFile }
+            : { kind: "defer", reason: CREATE_PLAN_HOST_PLAN_WORKFLOW_REASON };
+    }
+    const planModeActive = options.planModeActive === true || options.hostAgent === "plan";
+    if (planModeActive && names.has("question"))
         return { kind: "approve" };
     return { kind: "ack" };
 }
-/** The synthetic AskQuestion item backing the emulated approval prompt. */
 function createPlanApprovalItem(question) {
     return {
         id: "create_plan_approval",
@@ -156,16 +167,13 @@ export function createPlanApprovalQuestionInput(planLabel) {
 }
 /**
  * True when the emulated approval prompt came back as an explicit "Yes".
- * An unanswered, dismissed, or failed prompt keeps the model planning rather
- * than silently starting execution. OpenCode prose is anchored on the exact
- * prompt text. Every other result shape fails closed.
+ * An unanswered, dismissed, or failed prompt keeps the model planning.
  */
 export function createPlanApproved(output, isError, question) {
     if (isError)
         return false;
     const [segment] = parseAnswerSegments([createPlanApprovalItem(question)], output);
-    const answer = (segment ?? "").trim().toLowerCase();
-    return answer === CREATE_PLAN_APPROVAL_YES.toLowerCase();
+    return (segment ?? "").trim().toLowerCase() === CREATE_PLAN_APPROVAL_YES.toLowerCase();
 }
 function asRecord(value) {
     return value && typeof value === "object" && !Array.isArray(value)
@@ -334,12 +342,14 @@ export function renderOpencodePlanMarkdown(args) {
  * Write the plan under {@link hostPlansDir} and return a `file://` URI.
  * Empty / missing content is the caller's responsibility (empty plan_uri ack).
  */
-export function writeOpencodePlanFile(args, workspaceRoot, created = Date.now()) {
+export function writeOpencodePlanFile(args, workspaceRoot, created = Date.now(), 
+/** Exact host-owned plan file; default is a new file under {@link hostPlansDir}. */
+target) {
     const markdown = renderOpencodePlanMarkdown(args);
     if (!markdown.trim()) {
         return { ok: false, error: "CreatePlan produced no plan content to write" };
     }
-    const planPath = resolveHostPlanPath(workspaceRoot, args.name, created);
+    const planPath = target ?? resolveHostPlanPath(workspaceRoot, args.name, created);
     try {
         mkdirSync(path.dirname(planPath), { recursive: true });
         writeFileSync(planPath, markdown, "utf-8");

package/dist/protocol/interactions.d.ts

@@ -14,6 +14,8 @@ export type HandledInteraction = {
     variantField: number;
     variantName: string;
     outcome: "rejected" | "acknowledged" | "failed" | "bridged" | "approved";
+    /** Decoded model call id, including refusals and lifecycle acknowledgments. */
+    toolCallId?: string;
     /**
      * Immediate reply for this query. Absent for bridged *synchronous* AskQuestion
      * or SwitchMode: Cursor blocks until the host tool returns, exactly as its own
@@ -31,24 +33,29 @@ export type HandledInteraction = {
      */
     switchMode?: DecodedSwitchModeQuery & {
         bridge: SwitchModeBridge;
-        toolName?: SwitchModeHostTool | "question";
+        toolName?: SwitchModeHostTool;
     };
     /**
-     * Present when CreatePlan needs a host tool: either a native plan stage that
-     * owns the write *and* the approval, or the emulated `question` prompt the
-     * provider raises after writing the plan itself. `planUri` is set only for
-     * the emulated path, where the provider already knows the file it wrote.
+     * Present when CreatePlan needs a host tool: a host plan-stage tool that
+     * owns the write *and* the review, the host's `plan_exit` review of the
+     * plan file the provider just wrote (`planUri` / `planPath` set), or the
+     * emulated `question` prompt after that write.
      */
     createPlan?: DecodedCreatePlanQuery & {
         bridge: CreatePlanBridge;
-        toolName: typeof CURSOR_PLAN_STAGE_TOOL | "question";
+        toolName: typeof CURSOR_PLAN_STAGE_TOOL | "plan_exit" | "question";
         planUri?: string;
-        /** Filesystem path of the plan the provider just wrote (emulated path). */
+        /** Filesystem path of the plan the provider just wrote. */
         planPath?: string;
         questionInput?: ReturnType<typeof createPlanApprovalQuestionInput>;
-        /** The plan to show the user before they approve it (emulated path only). */
+        /** The plan to show the user before the host review. */
         planReview?: string;
     };
+    /**
+     * Cursor tool call id of a CreatePlan the host plan agent will record
+     * instead. Nothing was written, so its display must not be mirrored as a plan.
+     */
+    deferredCreatePlanToolCallId?: string;
     /** Present when an image generation was approved: the target to expect. */
     generateImage?: DecodedGenerateImageQuery;
 };
@@ -81,16 +88,18 @@ export type HandleInteractionQueryOptions = {
     workspaceRoot?: string;
     /** True when the advertised host plan-stage tool is available. */
     canBridgeCreatePlan?: boolean;
-    /**
-     * True when the provider has recorded an approved Cursor plan/spec mode for
-     * this session. A written plan then ends with an execution-approval prompt,
-     * which is the transition out of planning; outside plan mode there is none.
-     */
+    /** An approved switch into the host `plan` agent waits for this Run to end. */
+    hostPlanEntryPending?: boolean;
+    /** Host primary agent this Run executes under, when the host reported it. */
+    hostAgent?: string;
+    /** Provider-recorded Cursor plan/spec mode for the CreatePlan execution gate. */
     planModeActive?: boolean;
+    /** The host's own plan file for this session, when the host defines one. */
+    hostPlanFile?: string;
     /**
      * Cursor unified mode currently recorded for this session. A SwitchMode to
      * the mode already in effect needs no approval, matching Cursor's own IDE
-     * handler and keeping the plan-approval prompt from firing twice.
+     * handler and keeping the host's plan review from running twice.
      */
     activeCursorModeId?: string;
 };
@@ -112,9 +121,9 @@ export declare function inspectInteractionQueryWire(agentServerPayload: Uint8Arr
  * Bridged / persisted exceptions:
  * - AskQuestion (#3) → OpenCode `question` tool
  * - SwitchMode (#4) → OpenCode `plan_enter` / `plan_exit` when advertised
- * - CreatePlan (#7) → host-calculated plan file via hostPlansDir (project-config
- *   `plans/` in a git worktree, else host global data/plans); empty args still
- *   get the CLI empty-`plan_uri` success ack
+ * - CreatePlan (#7) → the host's plan file (session `Session.plan` file when
+ *   known, else a new file under hostPlansDir); empty args still get the CLI
+ *   empty-`plan_uri` success ack
  * - GenerateImage (#12) → approve when `cursor_image_save` is advertised
  */
 export declare function handleInteractionQuery(query: Record<string, unknown>, agentServerPayload: Uint8Array, options?: HandleInteractionQueryOptions): HandledInteraction;