@codexhost/cli-linux-arm64 0.13.2 → 0.14.0

package/app/plugins/claude-code/plugin.mjs

@@ -14604,6 +14604,15 @@ var harnessDisplaySetSchema = external_exports.strictObject({
   initializeOnly: external_exports.boolean().optional()
 });
 
+// ../../shared-contracts/dist/harness-presentation.js
+var localeSchema = external_exports.string().max(64).regex(/^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/u);
+var displayText = (maximum) => external_exports.string().min(1).max(maximum).refine((text2) => text2.trim().length > 0);
+var harnessLocalizationsSchema = external_exports.record(localeSchema, external_exports.object({
+  label: displayText(256).optional(),
+  description: displayText(1024).optional()
+}).strict()).refine((entries) => Object.keys(entries).length <= 16, "Too many locales");
+var harnessLocalizedTextSchema = external_exports.record(localeSchema, displayText(4096)).refine((entries) => typeof entries.en === "string", "English fallback is required").refine((entries) => Object.keys(entries).length <= 16, "Too many locales");
+
 // ../../shared-contracts/dist/model-price-overrides.js
 var usdPerMillionTokens = external_exports.number().finite().nonnegative();
 var modelPriceOverrideSchema = external_exports.strictObject({
@@ -14653,10 +14662,19 @@ var model = external_exports.string().min(1).max(512);
 var project = external_exports.string().min(1).max(4096);
 var usageStatisticsParamsSchema = external_exports.strictObject({
   range: external_exports.enum(USAGE_STATISTICS_RANGES),
+  /** Display timezone for ranges, dates and hourly buckets; omitted means the Host's local zone. */
+  timeZone: external_exports.string().min(1).max(128).refine((value) => {
+    try {
+      new Intl.DateTimeFormat("en", { timeZone: value });
+      return true;
+    } catch {
+      return false;
+    }
+  }, "Unsupported usage statistics timezone").optional(),
   harness: harness.optional(),
   model: model.nullable().optional(),
   project: project.nullable().optional(),
-  /** One local date inside the range. */
+  /** One date in the query timezone inside the range. */
   date: localDate.optional()
 });
 var usageStatisticsTotalsSchema = external_exports.strictObject({
@@ -14692,7 +14710,7 @@ var usageStatisticsSessionSchema = external_exports.strictObject({
 });
 var usageStatisticsResultSchema = external_exports.strictObject({
   range: external_exports.enum(USAGE_STATISTICS_RANGES),
-  /** First local date of the range; null for all time. */
+  /** First date in the query timezone (Host local when omitted); null for all time. */
   from: localDate.nullable(),
   to: localDate,
   /** The filters these figures apply, echoed so a late answer to older filters is recognised. */
@@ -14732,7 +14750,7 @@ var usageStatisticsResultSchema = external_exports.strictObject({
   totals: usageStatisticsTotalsSchema,
   /** Each date and Harness of the range: every filter except the day. */
   daily: external_exports.array(external_exports.strictObject({ date: localDate, harness, ...totals })).max(2e5),
-  /** Local weekday (0 = Sunday) and hour, all filters applied. */
+  /** Weekday (0 = Sunday) and hour in the query timezone, all filters applied. */
   hourly: external_exports.array(external_exports.strictObject({
     weekday: external_exports.number().int().min(0).max(6),
     hour: external_exports.number().int().min(0).max(23),
@@ -14792,6 +14810,8 @@ var CONSOLE_HOST_METHODS = Object.freeze([
   "codexhost/harness/display-settings/set",
   "codexhost/harness/inspect",
   "codexhost/harness/installation",
+  "codexhost/harness/installation/start",
+  "codexhost/harness/installation/status",
   "codexhost/harness/launch-settings/get",
   "codexhost/harness/launch-settings/set",
   "codexhost/harness/web-ui/open",
@@ -14867,7 +14887,18 @@ var threadManualCompactionStartedSchema = external_exports.strictObject({
 var nonNegativeSafeIntegerSchema = external_exports.number().int().safe().nonnegative();
 var finiteNonNegativeNumberSchema = external_exports.number().finite().nonnegative();
 var cacheHitRatePercentSchema = external_exports.number().finite().min(0).max(100);
+var indicatorTextSchema = (maximum) => harnessLocalizedTextSchema.refine((entries) => Object.values(entries).every((text2) => text2.length <= maximum));
+var composerIndicatorsSchema = external_exports.array(external_exports.object({
+  kind: external_exports.literal("countdown"),
+  id: external_exports.string().min(1).max(64),
+  expiresAtUnix: nonNegativeSafeIntegerSchema,
+  label: indicatorTextSchema(256).optional(),
+  tooltip: indicatorTextSchema(1024).optional()
+}).strict()).max(2).refine((entries) => new Set(entries.map(({ id: id2 }) => id2)).size === entries.length, {
+  message: "Composer indicator IDs must be unique"
+});
 var threadUsageSnapshotSchema = external_exports.object({
+  composerIndicators: composerIndicatorsSchema.optional(),
   inputTokens: nonNegativeSafeIntegerSchema.optional(),
   cachedInputTokens: nonNegativeSafeIntegerSchema.optional(),
   cacheWriteInputTokens: nonNegativeSafeIntegerSchema.optional(),
@@ -14940,8 +14971,24 @@ var threadUsageSnapshotSchema = external_exports.object({
   }
 });
 var usagePercentSchema = external_exports.number().finite().min(0).max(100);
+var accountCreditsPeriodSchema = external_exports.enum([
+  "weekly",
+  "monthly",
+  "five_hour",
+  "seven_day",
+  "unknown"
+]);
+var accountCreditsScopeSchema = external_exports.object({
+  id: external_exports.string().min(1).max(256),
+  label: external_exports.string().min(1).max(256),
+  localizations: harnessLocalizationsSchema.optional()
+}).strict();
 var accountCreditsProductUsageSchema = external_exports.object({
   product: external_exports.string().min(1),
+  /** Native period and scope, never inferred from the display name. */
+  periodType: accountCreditsPeriodSchema.optional(),
+  scope: accountCreditsScopeSchema.optional(),
+  localizations: harnessLocalizationsSchema.optional(),
   used: external_exports.number().finite().nonnegative().optional(),
   // Zero is a real empty cap, not an absent field.
   limit: external_exports.number().finite().nonnegative().optional(),
@@ -14961,9 +15008,11 @@ var accountCreditsSnapshotSchema = external_exports.object({
   unit: external_exports.string().min(1).max(32).optional(),
   /** Native label when the primary limit is scoped to a model or product group. */
   label: external_exports.string().min(1).optional(),
+  scope: accountCreditsScopeSchema.optional(),
+  localizations: harnessLocalizationsSchema.optional(),
   usedPercent: usagePercentSchema,
   resetsAt: external_exports.string().min(1).optional(),
-  periodType: external_exports.enum(["weekly", "monthly", "five_hour", "seven_day", "unknown"]),
+  periodType: accountCreditsPeriodSchema,
   productUsage: external_exports.array(accountCreditsProductUsageSchema).min(1).optional(),
   resetCredits: accountResetCreditsSchema.optional()
 }).strict();
@@ -14974,7 +15023,9 @@ var threadUsageInspectionParamsSchema = external_exports.object({
 var threadUsageInspectionSchema = external_exports.object({
   threadId: hostThreadIdSchema,
   usage: threadUsageSnapshotSchema.nullable(),
-  accountCredits: accountCreditsSnapshotSchema.optional()
+  accountCredits: accountCreditsSnapshotSchema.optional(),
+  /** Whether this source can provide cached account quota independently of usage. */
+  accountCreditsSupported: external_exports.boolean().optional()
 }).strict();
 
 // ../../shared-contracts/dist/harness-accounts.js
@@ -15101,7 +15152,8 @@ var harnessPermissionModeSchema = external_exports.object({
   id: harnessPermissionModeIdSchema,
   label: nonBlankTextSchema.max(HARNESS_PERMISSION_MODE_LABEL_MAX_LENGTH),
   description: nonBlankTextSchema.max(HARNESS_PERMISSION_MODE_DESCRIPTION_MAX_LENGTH).optional(),
-  dangerous: external_exports.boolean().optional()
+  dangerous: external_exports.boolean().optional(),
+  localizations: harnessLocalizationsSchema.optional()
 }).strict();
 var harnessPermissionModeCatalogSchema = external_exports.object({
   modes: external_exports.array(harnessPermissionModeSchema).min(1).max(HARNESS_PERMISSION_MODE_CATALOG_MAX_LENGTH),
@@ -15254,7 +15306,9 @@ var harnessSessionCapabilitiesSchema = external_exports.object({
   }).strict().optional(),
   autonomousTurns: external_exports.object({
     observe: external_exports.boolean()
-  }).strict().optional()
+  }).strict().optional(),
+  /** True only when `turn.steer` delivers input into the active Turn through a native primitive. */
+  steer: external_exports.boolean().optional()
 }).strict();
 var harnessConfigurationStateSchema = external_exports.object({
   effectiveModel: harnessModelRefSchema.optional(),
@@ -15301,7 +15355,9 @@ var harnessInspectionSchema = external_exports.union([
 var harnessInspectParamsSchema = external_exports.object({
   harnessId: harnessIdSchema,
   cwd: nonBlankTextSchema2.max(16384).optional(),
-  refresh: external_exports.boolean().optional()
+  refresh: external_exports.boolean().optional(),
+  /** `availability` asks only whether the Harness can run; see `InspectHarnessInput.purpose`. */
+  purpose: external_exports.literal("availability").optional()
 }).strict();
 var harnessWebUiOpenParamsSchema = external_exports.object({
   harnessId: harnessIdSchema
@@ -15384,6 +15440,15 @@ var threadOwnershipListResultSchema = external_exports.object({
     seen.add(thread.threadId);
   }
 });
+var threadSteeringInspectParamsSchema = external_exports.object({
+  threadId: hostThreadIdSchema,
+  /** The text about to be steered; a Harness command always stops and restarts. */
+  text: external_exports.string().optional()
+}).strict();
+var threadSteerDeliverySchema = external_exports.enum(["activeTurn", "newTurn"]);
+var threadSteeringInspectResultSchema = external_exports.object({
+  delivery: external_exports.enum(["official", "activeTurn", "newTurn"])
+}).strict();
 
 // ../../shared-contracts/dist/harness-plugins.js
 var HARNESS_PLUGIN_MANIFEST_MAX_BYTES = 32 * 1024;
@@ -15485,11 +15550,31 @@ var harnessInstallationStateSchema = external_exports.object({
   latestVersion: external_exports.string().min(1).max(128),
   updateAvailable: external_exports.boolean(),
   canUpdate: external_exports.boolean(),
+  /** Defaults to CLI; some Harnesses ship only inside a desktop application. */
+  versionKind: external_exports.enum(["cli", "application"]).optional(),
+  /** Official download opened by the user; does not imply an automatic installation. */
+  manualUpdateUrl: external_exports.url().max(2048).refine((value) => /^https:\/\/[^/?#@]+(?:[/?#]|$)/iu.test(value), "Manual updates require a credential-free HTTPS URL").optional(),
   // Adapter-owned diagnostic text; UI uses messageCode rather than displaying it verbatim.
   message: external_exports.string().max(2048).optional(),
   messageCode: external_exports.string().min(1).max(128).optional(),
+  /** Safe plugin-owned explanation, distinct from raw diagnostic message. */
+  notice: harnessLocalizedTextSchema.optional(),
   latestVersionKind: external_exports.enum(["unknown", "tracking-branch"]).optional()
 }).strict();
+var harnessInstallationTaskParamsSchema = external_exports.object({ taskId: external_exports.string().uuid() }).strict();
+var harnessInstallationTaskSchema = external_exports.discriminatedUnion("status", [
+  external_exports.object({ taskId: external_exports.string().uuid(), status: external_exports.literal("running") }).strict(),
+  external_exports.object({
+    taskId: external_exports.string().uuid(),
+    status: external_exports.literal("succeeded"),
+    result: harnessInstallationStateSchema
+  }).strict(),
+  external_exports.object({
+    taskId: external_exports.string().uuid(),
+    status: external_exports.literal("failed"),
+    error: external_exports.object({ code: external_exports.number().int(), message: external_exports.string().min(1).max(2048) }).strict()
+  }).strict()
+]);
 
 // ../../shared-contracts/dist/codex-accounts.js
 var accountIdSchema = external_exports.string().min(1).max(256).regex(/^[A-Za-z0-9._~-]+$/u);
@@ -15614,6 +15699,7 @@ var harnessCommandDescriptorSchema = external_exports.object({
   invocation: commandInvocationSchema,
   label: commandLabelSchema,
   description: commandDescriptionSchema.optional(),
+  localizations: harnessLocalizationsSchema.optional(),
   argumentMode: external_exports.enum(["none", "text"]),
   /**
    * Native distinction reported by the Harness. Omitted when the Harness does
@@ -16001,6 +16087,7 @@ var usageFields = /* @__PURE__ */ new Set([
   ...safeIntegerFields,
   ...percentFields,
   "sessionCacheUsage",
+  "composerIndicators",
   "totalCostUsd",
   "totalCredits",
   "contextUsagePercent",
@@ -16023,6 +16110,7 @@ function parseHostUsage(value) {
       throw new Error(`Harness Usage contains unknown field '${key}'`);
     }
   }
+  const indicators = value.composerIndicators === void 0 ? {} : { composerIndicators: composerIndicatorsSchema.parse(value.composerIndicators) };
   for (const field of [
     "totalCredits",
     "contextUsagePercent",
@@ -16093,9 +16181,9 @@ function parseHostUsage(value) {
     if (value.costSource !== "publicPrice") {
       throw new Error("Harness Usage 'unpricedModels' must be provided with a 'publicPrice' cost");
     }
-    return { ...value, unpricedModels: [...models] };
+    return { ...value, ...indicators, unpricedModels: [...models] };
   }
-  return { ...value };
+  return { ...value, ...indicators };
 }
 var requestTokenFields = [
   "inputTokens",
@@ -16294,6 +16382,7 @@ var harnessBrokerMethodSchema = external_exports.enum([
   "adapter.open",
   "adapter.subagent.readSnapshot",
   "session.readSnapshot",
+  "session.readCapabilities",
   "session.refreshUsage",
   "session.execute",
   "session.commands.list",
@@ -16474,6 +16563,11 @@ var turnStartSchema = external_exports.object({
   turnId: hostTurnIdSchema,
   input: external_exports.array(textInputSchema)
 }).strict();
+var turnSteerSchema = external_exports.object({
+  type: external_exports.literal("turn.steer"),
+  turnId: hostTurnIdSchema,
+  input: external_exports.array(textInputSchema)
+}).strict();
 var turnCancelSchema = external_exports.object({ type: external_exports.literal("turn.cancel"), turnId: hostTurnIdSchema }).strict();
 var interactionResponseSchema = external_exports.union([
   external_exports.object({
@@ -16499,6 +16593,7 @@ var permissionSelectSchema = external_exports.object({
 }).strict();
 var brokerHostCommandSchema = external_exports.discriminatedUnion("type", [
   turnStartSchema,
+  turnSteerSchema,
   turnCancelSchema,
   interactionRespondSchema,
   modelSelectSchema,
@@ -16691,6 +16786,7 @@ function parseSessionMetadata(value) {
     sessionId: candidate.sessionId,
     sessionGeneration: candidate.sessionGeneration,
     capabilities: harnessSessionCapabilitiesSchema.parse(candidate.capabilities),
+    readCapabilities: candidate.readCapabilities === true,
     initialState: state,
     initialUsage: candidate.initialUsage === null ? null : parseHostUsage(candidate.initialUsage),
     commands: candidate.commands === true
@@ -17042,6 +17138,11 @@ var BrokeredHarnessSession = class {
       event: { type: "session.faulted", error: unavailable(error52.message) }
     });
   }
+  async readCapabilities() {
+    if (!this.#metadata.readCapabilities)
+      return { ...this.capabilities, steer: false };
+    return harnessSessionCapabilitiesSchema.parse(await this.#request("session.readCapabilities", {}));
+  }
   async refreshUsage() {
     await this.#request("session.refreshUsage", {});
   }
@@ -17073,6 +17174,8 @@ var BrokeredHarnessSession = class {
     try {
       return parseHarnessResult(await this.#request("session.execute", { command }));
     } catch (error52) {
+      if (command.type === "turn.steer")
+        throw error52;
       return {
         ok: false,
         error: unavailable(error52 instanceof Error ? error52.message : String(error52))
@@ -17160,6 +17263,8 @@ var BrokeredHarnessAdapter = class {
   commandCatalog;
   liveCommandCatalog;
   harnessId;
+  credits;
+  refreshCredits;
   #descriptorPath;
   #forwardEnvironment;
   #isInstalled;
@@ -17180,6 +17285,10 @@ var BrokeredHarnessAdapter = class {
   };
   constructor(input = {}) {
     this.harnessId = harnessPluginIdSchema.parse(input.harnessId ?? "claude-code");
+    if (input.accountCredits !== false) {
+      this.credits = () => this.#credits;
+      this.refreshCredits = () => this.#refreshAccountCredits();
+    }
     this.#forwardEnvironment = input.forwardDelegationEnvironment === true;
     if (input.commandCatalog)
       this.commandCatalog = input.commandCatalog;
@@ -17191,10 +17300,7 @@ var BrokeredHarnessAdapter = class {
     this.#startBroker = input.startBroker === false ? void 0 : input.startBroker ?? (process.platform === "darwin" && !input.descriptorPath ? () => startBrokerLaunchAgent(this.harnessId, environment) : void 0);
     this.#startTimeoutMs = input.startTimeoutMs ?? BROKER_START_TIMEOUT_MS;
   }
-  credits() {
-    return this.#credits;
-  }
-  refreshCredits() {
+  #refreshAccountCredits() {
     if (this.#closed)
       return Promise.resolve(null);
     if (this.#creditsRefresh)
@@ -17456,10 +17562,13 @@ function usageSessionTitle(value) {
     return void 0;
   if (normalized.length <= MAX_SESSION_TITLE_LENGTH)
     return normalized;
-  const characters = [...normalized];
-  if (characters.length <= MAX_SESSION_TITLE_LENGTH)
-    return normalized;
-  return `${characters.slice(0, MAX_SESSION_TITLE_LENGTH - 1).join("").trimEnd()}…`;
+  let title = "";
+  for (const character of normalized) {
+    if (title.length + character.length >= MAX_SESSION_TITLE_LENGTH)
+      break;
+    title += character;
+  }
+  return `${title.trimEnd()}…`;
 }
 function sessionIdOk(value) {
   return typeof value === "string" && value.length > 0 && value.length <= MAX_SESSION_ID_LENGTH;
@@ -17612,8 +17721,33 @@ function createClaudeUsageStatistics(environment) {
   });
 }
 
+// dist/claude-prompt-cache.js
+function lastClaudeAssistantResponseUnix(messages) {
+  let latest;
+  for (const entry of messages) {
+    if (typeof entry !== "object" || entry === null || !("type" in entry) || entry.type !== "assistant" || "isSidechain" in entry && entry.isSidechain === true || "parent_tool_use_id" in entry && entry.parent_tool_use_id != null || !("timestamp" in entry) || typeof entry.timestamp !== "string")
+      continue;
+    const time3 = Math.floor(Date.parse(entry.timestamp) / 1e3);
+    if (Number.isSafeInteger(time3) && time3 >= 0)
+      latest = Math.max(latest ?? 0, time3);
+  }
+  return latest;
+}
+function claudePromptCacheIndicators(accountCreditsSupported, lastResponseAtUnix) {
+  if (!accountCreditsSupported || lastResponseAtUnix === void 0)
+    return [];
+  return [
+    {
+      kind: "countdown",
+      id: "prompt-cache",
+      expiresAtUnix: lastResponseAtUnix + 3600,
+      label: { en: "Prompt cache", "zh-CN": "提示词缓存" }
+    }
+  ];
+}
+
 // dist/claude-code-adapter.js
-import { randomUUID as randomUUID4 } from "node:crypto";
+import { randomUUID as randomUUID5 } from "node:crypto";
 import path16 from "node:path";
 
 // ../../../node_modules/@anthropic-ai/claude-agent-sdk/sdk.mjs
@@ -54412,11 +54546,20 @@ function parseResultModelUsage(value) {
   if (!isRecord7(value))
     return void 0;
   const usage = [];
-  for (const entry of Object.values(value)) {
+  for (const [model2, entry] of Object.entries(value)) {
     if (!isRecord7(entry) || !safeNonNegativeInteger(entry.inputTokens) || !safeNonNegativeInteger(entry.outputTokens)) {
       return void 0;
     }
-    usage.push({ inputTokens: entry.inputTokens, outputTokens: entry.outputTokens });
+    const cacheRead = safeNonNegativeInteger(entry.cacheReadInputTokens) ? entry.cacheReadInputTokens : 0;
+    const cacheWrite = safeNonNegativeInteger(entry.cacheCreationInputTokens) ? entry.cacheCreationInputTokens : 0;
+    const promptTokens = entry.inputTokens + cacheRead + cacheWrite;
+    usage.push({
+      model: model2,
+      inputTokens: entry.inputTokens,
+      outputTokens: entry.outputTokens,
+      ...Number.isSafeInteger(promptTokens) ? { promptTokens } : {},
+      ...safeNonNegativeInteger(entry.contextWindow) && entry.contextWindow > 0 ? { contextWindowTokens: entry.contextWindow } : {}
+    });
   }
   return usage;
 }
@@ -54767,6 +54910,7 @@ var ClaudeNativeTurnAccumulator = class {
     events.push({
       type: "message.completed",
       messageId,
+      localCommand: true,
       ...checkpointId ? { checkpointId } : {}
     });
   }
@@ -55247,6 +55391,10 @@ function conversationMessages(values, sessionId) {
   const messages = [];
   const ids = /* @__PURE__ */ new Set();
   let promptId = null;
+  const occupancy = new ClaudeBackgroundOccupancy();
+  let accumulator = new ClaudeNativeTurnAccumulator();
+  const sends = /* @__PURE__ */ new Set();
+  let pendingNotification = false;
   for (const value of values) {
     if (!isRecord8(value))
       throw new Error("Claude history contains a malformed message");
@@ -55265,8 +55413,46 @@ function conversationMessages(values, sessionId) {
       message: value.message,
       nested: typeof value.parent_tool_use_id === "string" && value.parent_tool_use_id.length > 0,
       interrupted,
+      startsTurn: false,
       syntheticUser: value.type === "user" && (interrupted || value.isSynthetic === true || value.isMeta === true || isTaskNotificationOrigin(value) || value.toolUseResult !== void 0 && value.toolUseResult !== null)
     };
+    const notification = message.type === "user" && !message.nested && (isTaskNotificationOrigin(value) || textParts(message.message.content).some(isTaskNotificationRecord));
+    message.startsTurn = isHumanUser(message) || notification && !occupancy.unsettled && !pendingNotification;
+    if (message.startsTurn) {
+      occupancy.clear();
+      sends.clear();
+      accumulator = new ClaudeNativeTurnAccumulator();
+    }
+    for (const event of accumulator.consume(value).events) {
+      if (event.type === "subagent.started") {
+        if (event.operation === "send") {
+          sends.add(event.callId);
+          if (event.nativeSubagentId)
+            occupancy.occupyAgent(event.nativeSubagentId);
+        } else if (event.background)
+          occupancy.occupySpawn(event.callId, event.nativeSubagentId);
+      } else if (event.type === "subagent.completed") {
+        if (!event.isError && (event.continuesInBackground || sends.has(event.callId))) {
+          occupancy.occupySpawn(event.callId, event.nativeSubagentId);
+        } else
+          occupancy.release(event.callId, event.nativeSubagentId);
+        sends.delete(event.callId);
+      } else if (event.type === "workflow.launched" && event.background && !event.isError) {
+        occupancy.occupySpawn(event.callId, event.taskId);
+      } else if (event.type === "subagent.settled") {
+        occupancy.notify(event.callId, event.nativeSubagentId);
+      }
+    }
+    if (notification)
+      pendingNotification = true;
+    if (message.type === "assistant" && !message.nested) {
+      pendingNotification = false;
+      if (["end_turn", "stop_sequence", "max_tokens"].includes(String(message.message.stop_reason))) {
+        occupancy.releaseContinuations();
+      }
+    }
+    if (interrupted)
+      occupancy.clear();
     messages.push(message);
     if (isHumanUser(message)) {
       promptId = typeof value.promptId === "string" && value.promptId.length > 0 ? value.promptId : null;
@@ -55323,17 +55509,17 @@ function mapClaudeSnapshot(values, sessionId) {
   const turns = [];
   for (let index = 0; index < messages.length; ) {
     const user = messages[index];
-    if (!user || !isHumanUser(user)) {
+    if (!user || !user.startsTurn) {
       index += 1;
       continue;
     }
     let end = index + 1;
-    while (end < messages.length && !isHumanUser(messages[end]))
+    while (end < messages.length && !messages[end]?.startsTurn)
       end += 1;
     const turnMessages = messages.slice(index, end);
     const outcome = turnOutcome(turnMessages);
     const results = toolResultBlocks(turnMessages);
-    const checkpointMessage = turnMessages.findLast(({ type, interrupted }) => type === "assistant" || interrupted);
+    const checkpointMessage = turnMessages.findLast(({ type, interrupted, nested }) => !nested && (type === "assistant" || interrupted));
     let agentMessageOrdinal = 0;
     let reasoningOrdinal = 0;
     let toolOrdinal = 0;
@@ -55821,6 +56007,10 @@ async function forkClaudeSession(input) {
   return { ok: true, value: { sessionId: derivedSessionId } };
 }
 
+// dist/claude-fork-references.js
+import { randomUUID as randomUUID4 } from "node:crypto";
+import { readFile as readFile6, rename as rename4, rm as rm5, stat as stat5, writeFile as writeFile2 } from "node:fs/promises";
+
 // dist/claude-transcript.js
 import os6 from "node:os";
 import path13 from "node:path";
@@ -55838,7 +56028,7 @@ async function existingFile(file2) {
     return false;
   }
 }
-async function findTranscript(input) {
+async function findClaudeTranscript(input) {
   const projectsDirectory = path13.join(configDirectory(input.environment), "projects");
   const name = `${input.sessionId}.jsonl`;
   const expected = path13.join(projectsDirectory, projectDirectoryName(input.cwd), name);
@@ -55861,7 +56051,7 @@ function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 async function readClaudeTranscript(input) {
-  const transcript = await findTranscript(input);
+  const transcript = await findClaudeTranscript(input);
   if (!transcript)
     return null;
   const contents = await readFile5(transcript, "utf8");
@@ -55883,9 +56073,83 @@ async function readClaudeTranscript(input) {
   return [...messages.values()];
 }
 
+// dist/claude-fork-references.js
+function isRecord10(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseEntry(line) {
+  if (line.trim().length === 0)
+    return null;
+  try {
+    const entry = JSON.parse(line);
+    return isRecord10(entry) ? entry : null;
+  } catch {
+    return null;
+  }
+}
+function remapSameAs(value, copies) {
+  if (Array.isArray(value)) {
+    return value.reduce((count4, item) => count4 + remapSameAs(item, copies), 0);
+  }
+  if (!isRecord10(value))
+    return 0;
+  let count3 = 0;
+  for (const [key, child] of Object.entries(value)) {
+    const copy = key === "sameAs" && typeof child === "string" ? copies.get(child) : void 0;
+    if (copy) {
+      value[key] = copy;
+      count3 += 1;
+    } else {
+      count3 += remapSameAs(child, copies);
+    }
+  }
+  return count3;
+}
+async function remapForkedSessionReferences(input) {
+  const transcript = await findClaudeTranscript(input);
+  if (!transcript)
+    return 0;
+  const contents = await readFile6(transcript, "utf8");
+  if (!contents.includes('"sameAs"'))
+    return 0;
+  const lines = contents.split("\n");
+  const entries = lines.map(parseEntry);
+  const copies = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const source = entry?.forkedFrom;
+    if (typeof entry?.uuid === "string" && isRecord10(source) && typeof source.messageUuid === "string") {
+      copies.set(source.messageUuid, entry.uuid);
+    }
+  }
+  let remapped = 0;
+  const output = lines.map((line, index) => {
+    const entry = entries[index];
+    if (entry?.type !== "attachment")
+      return line;
+    const count3 = remapSameAs(entry.attachment, copies);
+    if (count3 === 0)
+      return line;
+    remapped += count3;
+    return JSON.stringify(entry);
+  });
+  if (remapped === 0)
+    return 0;
+  const temporary = `${transcript}.${randomUUID4()}.tmp`;
+  try {
+    await writeFile2(temporary, output.join("\n"), {
+      flag: "wx",
+      mode: (await stat5(transcript)).mode & 511
+    });
+    await rename4(temporary, transcript);
+  } finally {
+    await rm5(temporary, { force: true });
+  }
+  return remapped;
+}
+
 // dist/model-catalog.js
 import { Buffer as Buffer2 } from "node:buffer";
-import { readFile as readFile6 } from "node:fs/promises";
+import { readFile as readFile7 } from "node:fs/promises";
 import os7 from "node:os";
 import path14 from "node:path";
 
@@ -56025,7 +56289,7 @@ async function readClaudeUserModelPicker(environment = process.env) {
   const settingsPath = path14.join(resolveClaudeConfigDirectory(environment), "settings.json");
   let raw;
   try {
-    raw = await readFile6(settingsPath, "utf8");
+    raw = await readFile7(settingsPath, "utf8");
   } catch {
     return void 0;
   }
@@ -56184,26 +56448,38 @@ var claudePermissionModes = [
   {
     id: "plan",
     label: "Plan mode",
+    localizations: {
+      "zh-CN": {
+        label: "规划模式",
+        description: "探索并制定计划；批准计划后退出规划，恢复此前的权限模式。"
+      }
+    },
     description: "Explore and prepare a plan; approval exits planning and resumes the previous permission mode."
   },
   {
     id: "default",
     label: "Default",
+    localizations: { "zh-CN": { label: "默认", description: "编辑和其他受保护操作前询问。" } },
     description: "Ask before edits and other protected actions."
   },
   {
     id: "acceptEdits",
     label: "Accept edits",
+    localizations: {
+      "zh-CN": { label: "接受编辑", description: "允许文件编辑；其他受保护操作前询问。" }
+    },
     description: "Allow file edits and ask for other protected actions."
   },
   {
     id: "auto",
     label: "Auto mode",
+    localizations: { "zh-CN": { label: "自动模式", description: "由 Claude 判断权限请求。" } },
     description: "Let Claude classify permission requests."
   },
   {
     id: "bypassPermissions",
     label: "Bypass permissions",
+    localizations: { "zh-CN": { label: "绕过权限", description: "跳过 Claude Code 权限检查。" } },
     description: "Skip Claude Code permission checks.",
     dangerous: true
   }
@@ -56310,23 +56586,24 @@ function projectClaudeAccountUsage(usage, account) {
     return null;
   const limits = usage.rate_limits;
   const windows = [];
-  const add = (product, periodType, value) => {
+  const add = (product, periodType, value, scope) => {
     if (!value || typeof value.utilization !== "number" || !Number.isFinite(value.utilization) || value.utilization < 0 || value.utilization > 100)
       return;
     windows.push({
       product,
       periodType,
+      ...scope ? { scope: { id: scope, label: scope } } : {},
       usagePercent: value.utilization,
       ...value.resets_at && Number.isFinite(Date.parse(value.resets_at)) ? { resetsAt: value.resets_at } : {}
     });
   };
   add("5-hour window", "five_hour", limits.five_hour);
   add("7-day window", "seven_day", limits.seven_day);
-  add("OAuth apps · 7-day", "seven_day", limits.seven_day_oauth_apps);
-  add("Opus · 7-day", "seven_day", limits.seven_day_opus);
-  add("Sonnet · 7-day", "seven_day", limits.seven_day_sonnet);
+  add("OAuth apps · 7-day", "seven_day", limits.seven_day_oauth_apps, "OAuth apps");
+  add("Opus · 7-day", "seven_day", limits.seven_day_opus, "Opus");
+  add("Sonnet · 7-day", "seven_day", limits.seven_day_sonnet, "Sonnet");
   for (const window2 of limits.model_scoped ?? [])
-    add(`${window2.display_name} · 7-day`, "seven_day", window2);
+    add(`${window2.display_name} · 7-day`, "seven_day", window2, window2.display_name);
   const [primary, ...others] = windows;
   if (!primary)
     return null;
@@ -56337,11 +56614,14 @@ function projectClaudeAccountUsage(usage, account) {
     credits: {
       usedPercent: primary.usagePercent,
       periodType: primary.periodType,
+      ...primary.scope ? { scope: primary.scope } : {},
       ...!genericPrimary ? { label: primary.product } : {},
       ...primary.resetsAt ? { resetsAt: primary.resetsAt } : {},
       ...others.length ? {
-        productUsage: others.map(({ product, usagePercent, resetsAt }) => ({
+        productUsage: others.map(({ product, periodType, scope, usagePercent, resetsAt }) => ({
           product,
+          periodType,
+          ...scope ? { scope } : {},
           usagePercent,
           ...resetsAt ? { resetsAt } : {}
         }))
@@ -56403,12 +56683,21 @@ async function closeClaudeProcessGroup(child, timeoutMs) {
   throw new Error("Claude SDK process group did not exit");
 }
 
+// dist/transport.js
+var ClaudeSteerMissedTurnError = class extends Error {
+  constructor() {
+    super("Claude Code steer missed the active Turn");
+    this.name = "ClaudeSteerMissedTurnError";
+  }
+};
+
 // dist/sdk-transport.js
 var CLIENT_APP = "codexhost-claude-code-adapter/0.0.0";
 var SESSION_ENTRYPOINT = "codexhost-sdk";
 var APPROVAL_TITLE_MAX_LENGTH = 120;
 var APPROVAL_DESCRIPTION_MAX_LENGTH = 500;
 var DEFAULT_ABORT_TIMEOUT_MS = 2e3;
+var DEFAULT_STEER_QUEUED_TIMEOUT_MS = 5e3;
 var WORKFLOW_AGENT_LABEL_LIMIT = 1e3;
 var INTERRUPT_TIMEOUT_MESSAGE = "Claude SDK interrupt timed out";
 var PushableInput = class {
@@ -56463,17 +56752,17 @@ function rejectAfter(milliseconds, message) {
 function processExited(child) {
   return child.exitCode !== null || child.signalCode !== null;
 }
-function isRecord10(value) {
+function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function permissionModeFromMessage(value) {
-  if (!isRecord10(value) || value.type !== "system" || value.subtype !== "init" && value.subtype !== "status" || !("permissionMode" in value) || value.permissionMode === void 0) {
+  if (!isRecord11(value) || value.type !== "system" || value.subtype !== "init" && value.subtype !== "status" || !("permissionMode" in value) || value.permissionMode === void 0) {
     return void 0;
   }
   return isClaudePermissionMode(value.permissionMode) ? value.permissionMode : void 0;
 }
 function parseContextUsage(value) {
-  if (!isRecord10(value))
+  if (!isRecord11(value))
     throw new Error("Claude SDK context Usage is invalid");
   const usedTokens = value.totalTokens;
   const maxTokens = value.maxTokens;
@@ -56490,7 +56779,7 @@ function parseQuestions(input) {
   const questions = [];
   const questionTexts = /* @__PURE__ */ new Set();
   for (const value of input.questions) {
-    if (!isRecord10(value))
+    if (!isRecord11(value))
       return null;
     const question = value.question;
     const header = value.header;
@@ -56501,7 +56790,7 @@ function parseQuestions(input) {
     const labels = /* @__PURE__ */ new Set();
     const options = [];
     for (const option2 of value.options) {
-      if (!isRecord10(option2) || typeof option2.label !== "string" || option2.label.length === 0 || labels.has(option2.label) || typeof option2.description !== "string") {
+      if (!isRecord11(option2) || typeof option2.label !== "string" || option2.label.length === 0 || labels.has(option2.label) || typeof option2.description !== "string") {
         return null;
       }
       labels.add(option2.label);
@@ -56543,7 +56832,7 @@ function permissionUpdateDestination(value) {
   return void 0;
 }
 function isPermissionUpdate(value) {
-  if (!isRecord10(value) || !permissionUpdateDestination(value.destination))
+  if (!isRecord11(value) || !permissionUpdateDestination(value.destination))
     return false;
   if (value.type === "setMode") {
     return typeof value.mode === "string" && PERMISSION_MODES.has(value.mode);
@@ -56552,7 +56841,7 @@ function isPermissionUpdate(value) {
     return Array.isArray(value.directories) && value.directories.every((directory) => typeof directory === "string");
   }
   if (value.type === "addRules" || value.type === "replaceRules" || value.type === "removeRules") {
-    return typeof value.behavior === "string" && PERMISSION_BEHAVIORS.has(value.behavior) && Array.isArray(value.rules) && value.rules.every((rule) => isRecord10(rule) && typeof rule.toolName === "string" && (rule.ruleContent === void 0 || typeof rule.ruleContent === "string"));
+    return typeof value.behavior === "string" && PERMISSION_BEHAVIORS.has(value.behavior) && Array.isArray(value.rules) && value.rules.every((rule) => isRecord11(rule) && typeof rule.toolName === "string" && (rule.ruleContent === void 0 || typeof rule.ruleContent === "string"));
   }
   return false;
 }
@@ -56664,6 +56953,11 @@ var ClaudeSdkTransport = class {
   #queryFactory;
   #thinkingOptionId;
   #active = null;
+  #steerQueuedTimeoutMs;
+  #nativeSteer = false;
+  /** Root tool calls of the requested Turn that have started and not yet returned a result. */
+  #rootToolCalls = /* @__PURE__ */ new Set();
+  #pendingSteers = /* @__PURE__ */ new Map();
   #autonomous = null;
   #autonomousTurnHandler = null;
   #idleHandler = null;
@@ -56687,6 +56981,7 @@ var ClaudeSdkTransport = class {
     this.sessionId = options.sessionId;
     this.#cwd = options.cwd;
     this.#abortTimeoutMs = options.abortTimeoutMs ?? DEFAULT_ABORT_TIMEOUT_MS;
+    this.#steerQueuedTimeoutMs = options.steerQueuedTimeoutMs ?? DEFAULT_STEER_QUEUED_TIMEOUT_MS;
     this.#closeTimeoutMs = options.closeTimeoutMs;
     this.#command = options.command;
     this.#environment = options.environment ?? process.env;
@@ -56741,7 +57036,8 @@ var ClaudeSdkTransport = class {
         thinking: thinking.enabled ? { type: "adaptive", display: "summarized" } : { type: "disabled" },
         ...thinking.effort ? { effort: thinking.effort } : {},
         pathToClaudeCodeExecutable: executable,
-        settingSources: ["user"],
+        // Omitted settingSources loads user, project and local settings like the
+        // Claude Code CLI, so project CLAUDE.md and .claude/skills apply.
         permissionMode: this.#permissionMode,
         ...this.#allowDangerouslySkipPermissions ? { allowDangerouslySkipPermissions: true } : {},
         canUseTool: (toolName, input, options) => this.#canUseTool(toolName, input, options),
@@ -56778,8 +57074,42 @@ var ClaudeSdkTransport = class {
       return null;
     return { commands: this.#slashCommands, skillNames: this.#skillNames };
   }
+  supportsNativeSteer() {
+    return this.#nativeSteer;
+  }
+  /**
+   * `priority: "next"` joins after the current tool call, and a tool result is always followed by
+   * another model request. So a steer written while a root tool call runs folds into this Turn;
+   * one written while Claude streams its final text may instead run as the next Turn.
+   */
+  canSteerActiveTurn() {
+    return this.#nativeSteer && this.#active !== null && this.#rootToolCalls.size > 0;
+  }
+  #observeRootToolCalls(message) {
+    if (!isRecord11(message) || message.parent_tool_use_id != null)
+      return;
+    if (message.type !== "assistant" && message.type !== "user")
+      return;
+    const body = message.message;
+    if (!isRecord11(body) || !Array.isArray(body.content))
+      return;
+    for (const block of body.content) {
+      if (!isRecord11(block))
+        continue;
+      if (message.type === "assistant" && block.type === "tool_use" && typeof block.id === "string") {
+        this.#rootToolCalls.add(block.id);
+      } else if (message.type === "user" && block.type === "tool_result" && typeof block.tool_use_id === "string") {
+        this.#rootToolCalls.delete(block.tool_use_id);
+      }
+    }
+  }
+  #observeNativeCapabilities(message) {
+    if (!isRecord11(message) || message.type !== "system" || message.subtype !== "init")
+      return;
+    this.#nativeSteer = Array.isArray(message.capabilities) && message.capabilities.includes("msg_lifecycle_v1");
+  }
   #observeSlashCommands(message) {
-    if (!isRecord10(message) || message.type !== "system")
+    if (!isRecord11(message) || message.type !== "system")
       return;
     if (message.subtype === "init" && Array.isArray(message.skills)) {
       this.#skillNames = new Set(message.skills.filter((name) => typeof name === "string"));
@@ -56900,6 +57230,7 @@ var ClaudeSdkTransport = class {
     const unclaimed = this.#autonomous?.events ?? [];
     this.#autonomous = null;
     const promise2 = new Promise((resolve5, reject) => {
+      this.#rootToolCalls.clear();
       this.#active = {
         accumulator: new ClaudeNativeTurnAccumulator(this.#provider ? { provider: this.#provider } : {}),
         onEvent,
@@ -56919,6 +57250,51 @@ var ClaudeSdkTransport = class {
     });
     return promise2;
   }
+  /**
+   * Claude accepts the input with `queued`; Claude Code 2.1.280 then emits `started` after the
+   * current tool call, when `priority: "next"` joins the running Turn. Waiting for `started` would
+   * hold the caller for a whole tool call.
+   *
+   * Once written, the input cannot be recalled: Claude delivers it in this Turn or runs it next.
+   * The Turn ending first therefore does not reject it, and a missing `queued` receipt resolves
+   * after a bounded wait so callers that serialize requests are never held indefinitely.
+   */
+  steer(text2, messageId) {
+    if (this.#closePromise || !this.#started || !this.#query || !this.canSteerActiveTurn()) {
+      return Promise.reject(new ClaudeSteerMissedTurnError());
+    }
+    const promise2 = new Promise((resolve5, reject) => {
+      this.#pendingSteers.set(messageId, { resolve: resolve5, reject, timer: void 0 });
+    });
+    try {
+      this.#input.push({
+        type: "user",
+        message: { role: "user", content: text2 },
+        parent_tool_use_id: null,
+        session_id: this.sessionId,
+        uuid: messageId,
+        origin: { kind: "human" },
+        priority: "next"
+      });
+    } catch {
+      this.#pendingSteers.delete(messageId);
+      return Promise.reject(new ClaudeSteerMissedTurnError());
+    }
+    const pending = this.#pendingSteers.get(messageId);
+    if (pending) {
+      pending.timer = setTimeout(() => this.#acceptSteer(messageId), this.#steerQueuedTimeoutMs);
+      pending.timer.unref?.();
+    }
+    return promise2;
+  }
+  #acceptSteer(messageId) {
+    const pending = this.#pendingSteers.get(messageId);
+    if (!pending)
+      return;
+    this.#pendingSteers.delete(messageId);
+    clearTimeout(pending.timer);
+    pending.resolve();
+  }
   respondToInteraction(response) {
     const pending = this.#interactions.get(response.requestId);
     if (!pending) {
@@ -57090,6 +57466,7 @@ var ClaudeSdkTransport = class {
     }
   }
   async #close() {
+    this.#rejectPendingSteers();
     const failures = [];
     this.#closeInteractions("all", "cancelled");
     try {
@@ -57143,6 +57520,7 @@ var ClaudeSdkTransport = class {
     }
     this.#query = null;
     const active = this.#active;
+    this.#rootToolCalls.clear();
     this.#active = null;
     this.#autonomous = null;
     this.#idleAccumulator = null;
@@ -57197,11 +57575,31 @@ var ClaudeSdkTransport = class {
         await delay(10);
     }
   }
+  #rejectPendingSteers() {
+    const pending = [...this.#pendingSteers.values()];
+    this.#pendingSteers.clear();
+    const error52 = new Error("Claude Code steer receipt was lost after input was written");
+    for (const entry of pending) {
+      clearTimeout(entry.timer);
+      entry.reject(error52);
+    }
+  }
+  /** `queued` is Claude's acceptance of this message into the running Session. */
+  #observeSteer(message) {
+    if (this.#pendingSteers.size === 0 || !isRecord11(message) || message.type !== "command_lifecycle") {
+      return;
+    }
+    if (message.state !== "queued")
+      return;
+    if (typeof message.command_uuid !== "string" || message.command_uuid.length === 0)
+      return;
+    this.#acceptSteer(message.command_uuid);
+  }
   #observeBackgroundTasks(message) {
-    if (!isRecord10(message) || message.type !== "system")
+    if (!isRecord11(message) || message.type !== "system")
       return;
     if (message.subtype === "background_tasks_changed" && Array.isArray(message.tasks)) {
-      this.#backgroundTasks = new Set(message.tasks.flatMap((task) => isRecord10(task) && typeof task.task_id === "string" ? [task.task_id] : []));
+      this.#backgroundTasks = new Set(message.tasks.flatMap((task) => isRecord11(task) && typeof task.task_id === "string" ? [task.task_id] : []));
     } else if (message.subtype === "task_started" && typeof message.task_id === "string") {
       this.#backgroundTasks.add(message.task_id);
     } else if (message.subtype === "task_notification" && typeof message.task_id === "string" && ["completed", "failed", "stopped"].includes(String(message.status))) {
@@ -57217,7 +57615,7 @@ var ClaudeSdkTransport = class {
   }
   /** Remembers Workflow agent labels so their approvals can name the agent asking. */
   #observeWorkflowAgents(message) {
-    if (!isRecord10(message) || message.type !== "system" || message.subtype !== "task_progress") {
+    if (!isRecord11(message) || message.type !== "system" || message.subtype !== "task_progress") {
       return;
     }
     for (const agent of parseClaudeWorkflowAgents(message.workflow_progress) ?? []) {
@@ -57237,6 +57635,7 @@ var ClaudeSdkTransport = class {
         this.#observeBackgroundTasks(message);
         this.#observeWorkflowAgents(message);
         this.#observeSlashCommands(message);
+        this.#observeNativeCapabilities(message);
         const permissionMode = permissionModeFromMessage(message);
         if (permissionMode && permissionMode !== this.#permissionMode) {
           this.#permissionMode = permissionMode;
@@ -57245,13 +57644,16 @@ var ClaudeSdkTransport = class {
         const planLimit = parseClaudePlanLimitEvent(message);
         if (planLimit)
           this.#onPlanLimit(planLimit);
+        this.#observeSteer(message);
         const active = this.#active;
         if (active) {
+          this.#observeRootToolCalls(message);
           const interpreted2 = active.accumulator.consume(message);
           for (const event of interpreted2.events)
             active.onEvent(event);
           if (interpreted2.terminal) {
             this.#closeInteractions("root", "superseded");
+            this.#rootToolCalls.clear();
             this.#active = null;
             active.resolve(interpreted2.terminal);
           }
@@ -57278,7 +57680,7 @@ var ClaudeSdkTransport = class {
           userMessageId: null,
           live: false
         });
-        if (autonomous.userMessageId === null && isRecord10(message) && message.type === "user" && (message.parent_tool_use_id === null || message.parent_tool_use_id === void 0) && typeof message.uuid === "string" && message.uuid.length > 0) {
+        if (autonomous.userMessageId === null && isRecord11(message) && message.type === "user" && (message.parent_tool_use_id === null || message.parent_tool_use_id === void 0) && typeof message.uuid === "string" && message.uuid.length > 0) {
           autonomous.userMessageId = message.uuid;
         }
         const interpreted = autonomous.accumulator.consume(message);
@@ -57305,6 +57707,8 @@ var ClaudeSdkTransport = class {
     } catch (error52) {
       const active = this.#active;
       this.#closeInteractions("all", "cancelled");
+      this.#rejectPendingSteers();
+      this.#rootToolCalls.clear();
       this.#active = null;
       active?.reject(error52);
       if (!this.#closePromise)
@@ -57806,11 +58210,11 @@ var ClaudeWorkflowLifecycle = class {
 };
 
 // dist/task-tracker.js
-function isRecord11(value) {
+function isRecord12(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringField(value, keys) {
-  if (!isRecord11(value))
+  if (!isRecord12(value))
     return void 0;
   for (const key of keys) {
     const field = value[key];
@@ -57845,7 +58249,7 @@ var ClaudeTaskTracker = class {
     };
   }
   #create(args, result) {
-    if (!isRecord11(result) || !isRecord11(result.task))
+    if (!isRecord12(result) || !isRecord12(result.task))
       return;
     const id2 = stringField(result.task, ["id"]);
     const subject = stringField(args, ["subject"]) ?? stringField(result.task, ["subject"]);
@@ -57863,7 +58267,7 @@ var ClaudeTaskTracker = class {
     const id2 = stringField(args, ["taskId", "id", "task_id"]);
     if (!id2)
       return;
-    const status = isRecord11(args) ? taskStatus2(args.status) : void 0;
+    const status = isRecord12(args) ? taskStatus2(args.status) : void 0;
     if (status === "deleted") {
       this.#tasks.delete(id2);
       return;
@@ -57881,13 +58285,13 @@ var ClaudeTaskTracker = class {
     });
   }
   #replace(result) {
-    if (!isRecord11(result) || !Array.isArray(result.tasks))
+    if (!isRecord12(result) || !Array.isArray(result.tasks))
       return;
     const next = /* @__PURE__ */ new Map();
     for (const value of result.tasks) {
       const id2 = stringField(value, ["id"]);
       const subject = stringField(value, ["subject"]);
-      const status = isRecord11(value) ? taskStatus2(value.status) : void 0;
+      const status = isRecord12(value) ? taskStatus2(value.status) : void 0;
       if (!id2 || !subject || !status || status === "deleted")
         continue;
       const existing = this.#tasks.get(id2);
@@ -58054,11 +58458,11 @@ var ClaudeBackgroundCommandItems = class {
 };
 
 // dist/tool-lifecycle.js
-function isRecord12(value) {
+function isRecord13(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringField2(value, key) {
-  return isRecord12(value) && typeof value[key] === "string" ? value[key] : void 0;
+  return isRecord13(value) && typeof value[key] === "string" ? value[key] : void 0;
 }
 function toolFailure(toolName) {
   return {
@@ -58248,6 +58652,7 @@ var claudeCommandCatalog = harnessCommandCatalogSchema.parse({
     {
       id: "claude.compact",
       invocation: "/compact",
+      localizations: { "zh-CN": { label: "压缩上下文", description: "压缩当前对话上下文" } },
       label: "Compact context",
       description: "Compact the current conversation context",
       argumentMode: "text"
@@ -58324,7 +58729,7 @@ var CONTEXT_USAGE_TTL_MS = 1e4;
 var CONTEXT_USAGE_FAILURE_COOLDOWN_MS = 5e3;
 var REQUEST_USAGE_RETRY_DELAYS_MS = [0, 100, 250, 500, 1e3];
 var DEFAULT_CONTINUATION_QUIESCENCE_MS = 2e3;
-function isRecord13(value) {
+function isRecord14(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function safeNonNegativeInteger2(value) {
@@ -58333,7 +58738,7 @@ function safeNonNegativeInteger2(value) {
 function transcriptRequestUsage(messages, messageId) {
   for (let index = messages.length - 1; index >= 0; index -= 1) {
     const entry = messages[index];
-    if (!isRecord13(entry) || entry.type !== "assistant" || entry.parent_tool_use_id !== null && entry.parent_tool_use_id !== void 0 || !isRecord13(entry.message) || entry.message.id !== messageId || !isRecord13(entry.message.usage)) {
+    if (!isRecord14(entry) || entry.type !== "assistant" || entry.parent_tool_use_id !== null && entry.parent_tool_use_id !== void 0 || !isRecord14(entry.message) || entry.message.id !== messageId || !isRecord14(entry.message.usage)) {
       continue;
     }
     const inputTokens = entry.message.usage.input_tokens;
@@ -58481,6 +58886,7 @@ function projectClaudePlanLimitToCredits(planLimit) {
       productUsage: [
         {
           product: "7-day window",
+          periodType: "seven_day",
           usagePercent: other.utilizationPercent,
           ...other.resetsAtUnix !== void 0 ? { resetsAt: isoFromUnix(other.resetsAtUnix) } : {}
         }
@@ -58490,7 +58896,7 @@ function projectClaudePlanLimitToCredits(planLimit) {
 }
 var ClaudeHarnessSession = class {
   harnessId = claudeCodeHarnessId2;
-  capabilities = {
+  capabilities = /* @__PURE__ */ ((session) => ({
     configuration: {
       selectModel: true,
       selectThinkingOption: true,
@@ -58498,11 +58904,16 @@ var ClaudeHarnessSession = class {
       permissionModeScope: "live"
     },
     history: { fork: true, forkAcrossCwd: false, rollbackLastTurn: true },
-    subagents: { observe: true, readTranscript: true }
-  };
+    subagents: { observe: true, readTranscript: true },
+    // Read live: native delivery joins this Turn only while a requested Turn runs a root tool call
+    // on a CLI that confirms steers (`msg_lifecycle_v1`). Otherwise the Host stops and restarts.
+    get steer() {
+      return session.#transport?.canSteerActiveTurn?.() === true;
+    }
+  }))(this);
   commands;
   initialState;
-  initialUsage = null;
+  initialUsage;
   outputs;
   #channel = new HarnessOutputChannel();
   #cancelTimeoutMs;
@@ -58541,7 +58952,10 @@ var ClaudeHarnessSession = class {
   #hardCancelTask = null;
   #usageGeneration = 0;
   #latestUsage = null;
+  #lastAssistantResponseAtUnix;
+  #accountCreditsSupported;
   #minimumContextUsedTokens = null;
+  #latestRequestModel = null;
   #calibratedInputTokens = 0;
   #calibratedOutputTokens = 0;
   #calibratedCostUsd = 0;
@@ -58559,6 +58973,11 @@ var ClaudeHarnessSession = class {
   #continuationQuiescence = null;
   constructor(cwd, dependencies, closeTimeoutMs, onClosed, onPlanLimitObserved, options) {
     this.#cwd = cwd;
+    this.#lastAssistantResponseAtUnix = options.usageHistory.lastResponseAtUnix;
+    this.#accountCreditsSupported = options.accountCreditsSupported;
+    const composerIndicators = claudePromptCacheIndicators(this.#accountCreditsSupported, this.#lastAssistantResponseAtUnix);
+    this.initialUsage = composerIndicators.length ? { composerIndicators } : null;
+    this.#latestUsage = this.initialUsage;
     this.#pendingSessions = options.pendingSessions;
     const environment = options.environment;
     this.#createTransport = environment ? (input) => dependencies.createTransport({ ...input, environment }) : dependencies.createTransport;
@@ -58635,7 +59054,7 @@ var ClaudeHarnessSession = class {
             cwd: this.#cwd,
             sessionId: this.#sessionId
           }) ?? [];
-          const ids = new Set(messages.flatMap((message) => isRecord13(message) && typeof message.uuid === "string" ? [message.uuid] : []));
+          const ids = new Set(messages.flatMap((message) => isRecord14(message) && typeof message.uuid === "string" ? [message.uuid] : []));
           if (this.#unpersistedMessageIds.every((id2) => ids.has(id2))) {
             this.#unpersistedMessageIds = [];
             break;
@@ -58713,6 +59132,8 @@ var ClaudeHarnessSession = class {
     }
     if (command.type === "turn.cancel")
       return this.#cancel(command);
+    if (command.type === "turn.steer")
+      return this.#steer(command);
     if (command.type === "interaction.respond")
       return this.#respond(command);
     if (command.type === "model.select")
@@ -58849,6 +59270,45 @@ var ClaudeHarnessSession = class {
     }
     return { ok: true, value: { turnId: command.turnId } };
   }
+  async #steer(command) {
+    if (!this.#active || this.#active.command.turnId !== command.turnId) {
+      return { ok: false, error: invalidState("Claude Code steer target is not the active Turn") };
+    }
+    const text2 = command.input.map((input) => input.text).join("\n");
+    if (text2.length === 0) {
+      return {
+        ok: false,
+        error: {
+          code: "invalidRequest",
+          message: "Claude Code steer text must not be empty",
+          retryable: false
+        }
+      };
+    }
+    const transport = this.#transport;
+    if (!transport) {
+      return { ok: false, error: invalidState("Claude Code steer missed the active Turn") };
+    }
+    if (transport.supportsNativeSteer?.() !== true) {
+      return {
+        ok: false,
+        error: {
+          code: "unsupported",
+          message: "This Claude Code version does not confirm native steering",
+          retryable: false
+        }
+      };
+    }
+    try {
+      await transport.steer(text2, this.#randomUUID());
+    } catch (error52) {
+      if (error52 instanceof ClaudeSteerMissedTurnError) {
+        return { ok: false, error: invalidState("Claude Code steer missed the active Turn") };
+      }
+      throw error52;
+    }
+    return { ok: true, value: { accepted: true } };
+  }
   /** Built-ins plus the live commands and skills of the started native Session. */
   #liveCommandCatalog() {
     return claudeLiveCommandCatalog(claudeCommandCatalog, this.#transport?.slashCommands?.() ?? null);
@@ -59619,6 +60079,10 @@ var ClaudeHarnessSession = class {
         this.#completeReasoning(active, event.messageId, { status: "succeeded" });
         return;
       case "message.completed": {
+        if (!event.localCommand) {
+          this.#lastAssistantResponseAtUnix = Math.floor(Date.now() / 1e3);
+          this.publishAccountCreditsSupport(this.#accountCreditsSupported);
+        }
         this.#observeRootOutput(active);
         if (event.lastRequestUsage) {
           this.#requestUsageBoundary += 1;
@@ -59680,9 +60144,7 @@ var ClaudeHarnessSession = class {
       case "subagent.completed": {
         const subagent = active.subagents.complete(active.command.turnId, event, active.cancellationRequested);
         if (subagent.status === "running") {
-          if (subagent.nativeSubagentId) {
-            this.#occupancy.bind(event.callId, subagent.nativeSubagentId);
-          }
+          this.#occupancy.occupySpawn(event.callId, subagent.nativeSubagentId);
           return;
         }
         this.#occupancy.release(event.callId, subagent.nativeSubagentId);
@@ -60241,6 +60703,8 @@ var ClaudeHarnessSession = class {
     const promptTokens = usage.inputTokens + usage.cacheCreationInputTokens + usage.cacheReadInputTokens;
     if (promptTokens > 0)
       this.#minimumContextUsedTokens = promptTokens;
+    if (usage.model)
+      this.#latestRequestModel = usage.model;
     const cacheHitRatePercent = claudeCacheHitRatePercent(usage);
     const contextWindowTokens = this.#latestUsage?.contextWindowTokens;
     this.#mergeAndPublishUsage({
@@ -60282,8 +60746,24 @@ var ClaudeHarnessSession = class {
       if (cacheHitRatePercent !== void 0)
         delta.cacheHitRatePercent = cacheHitRatePercent;
     }
+    if (this.#latestUsage?.contextWindowTokens === void 0 && this.#minimumContextUsedTokens !== null) {
+      const contextWindowTokens = this.#resultContextWindow(event.modelUsage);
+      if (contextWindowTokens !== void 0) {
+        delta.contextUsedTokens = this.#minimumContextUsedTokens;
+        delta.contextWindowTokens = contextWindowTokens;
+      }
+    }
     this.#mergeAndPublishUsage(delta, active.command.turnId);
   }
+  /** The latest request's Model, else the Model that carried the most prompt tokens. */
+  #resultContextWindow(modelUsage) {
+    if (!modelUsage?.length)
+      return void 0;
+    const latest = this.#latestRequestModel;
+    const matched = latest ? modelUsage.find(({ model: model2 }) => model2 === latest) : void 0;
+    const main = matched ?? modelUsage.reduce((best, entry) => (entry.promptTokens ?? entry.inputTokens) > (best.promptTokens ?? best.inputTokens) ? entry : best);
+    return main.contextWindowTokens;
+  }
   /**
    * Plan usage is account-wide, not Thread-scoped, so every observation is
    * offered to the Adapter's shared cache regardless of this Session's own
@@ -60296,6 +60776,15 @@ var ClaudeHarnessSession = class {
     if (effective)
       this.publishPlanLimit(effective);
   }
+  publishAccountCreditsSupport(supported) {
+    if (this.#phase !== "open")
+      return;
+    this.#accountCreditsSupported = supported;
+    const composerIndicators = claudePromptCacheIndicators(supported, this.#lastAssistantResponseAtUnix);
+    if (composerIndicators[0]?.expiresAtUnix === this.#latestUsage?.composerIndicators?.[0]?.expiresAtUnix)
+      return;
+    this.#mergeAndPublishUsage({ composerIndicators }, this.#active?.command.turnId);
+  }
   publishPlanLimit(planLimit) {
     if (this.#phase !== "open")
       return;
@@ -60571,6 +61060,7 @@ var ClaudeCodeAdapter = class {
   #closePromise = null;
   #latestPlanLimit = null;
   #accountInspection = null;
+  #accountCreditsSupported = false;
   constructor(options = {}, dependencies) {
     const environment = options.environment ?? process.env;
     this.#environment = environment;
@@ -60591,7 +61081,7 @@ var ClaudeCodeAdapter = class {
       throw new RangeError("Claude Code continuation quiescence must be a positive safe integer");
     }
     this.#dependencies = dependencies ?? {
-      randomUUID: randomUUID4,
+      randomUUID: randomUUID5,
       bypassPermissionsAvailable: (environment2) => claudeBypassPermissionsAvailable(environment2 ?? options.environment ?? process.env),
       inspectInstallation: () => {
         resolveClaudeCodeExecutable({
@@ -60613,7 +61103,18 @@ var ClaudeCodeAdapter = class {
         abortTimeoutMs: this.#cancelTimeoutMs
       }),
       deleteSession: ({ cwd, sessionId }) => M5t(sessionId, { dir: cwd }),
-      forkSession: ({ checkpointId, cwd, sourceSessionId }) => U5t(sourceSessionId, { dir: cwd, upToMessageId: checkpointId }),
+      forkSession: async ({ checkpointId, cwd, sourceSessionId }) => {
+        const forked = await U5t(sourceSessionId, {
+          dir: cwd,
+          upToMessageId: checkpointId
+        });
+        await remapForkedSessionReferences({
+          cwd,
+          environment: options.environment ?? process.env,
+          sessionId: forked.sessionId
+        }).catch(() => void 0);
+        return forked;
+      },
       getSessionInfo: async ({ sessionId }) => {
         const info = await D5t(sessionId);
         if (!info)
@@ -60671,12 +61172,20 @@ var ClaudeCodeAdapter = class {
     return this.#accountInspection;
   }
   async #readAccount() {
+    const planLimitAtStart = this.#latestPlanLimit;
     let inspector;
     try {
       this.#dependencies.inspectInstallation();
       inspector = this.#dependencies.createInspector({ cwd: process.cwd() });
       this.#inspectors.add(inspector);
-      return await inspector.inspectAccount?.() ?? null;
+      const account = await inspector.inspectAccount?.() ?? null;
+      if (this.#latestPlanLimit === planLimitAtStart) {
+        this.#accountCreditsSupported = account?.credits !== void 0;
+        for (const session of this.#sessions) {
+          session.publishAccountCreditsSupport(this.#accountCreditsSupported);
+        }
+      }
+      return account;
     } catch {
       return null;
     } finally {
@@ -60919,6 +61428,7 @@ var ClaudeCodeAdapter = class {
       ...durableRef ? { nativeRef: durableRef } : {},
       sessionId,
       usageHistory,
+      accountCreditsSupported: this.#accountCreditsSupported,
       ...requestedModel ? { requestedModel } : {},
       requestedPermissionModeId,
       requestedThinkingOptionId,
@@ -60938,7 +61448,13 @@ var ClaudeCodeAdapter = class {
       return { requests: [], complete: true };
     try {
       const messages = await this.#dependencies.readSessionMessages({ cwd, sessionId });
-      return messages === null ? { requests: [], complete: false } : claudeUsageHistory(messages);
+      if (messages === null)
+        return { requests: [], complete: false };
+      const lastResponseAtUnix = lastClaudeAssistantResponseUnix(messages);
+      return {
+        ...claudeUsageHistory(messages),
+        ...lastResponseAtUnix !== void 0 ? { lastResponseAtUnix } : {}
+      };
     } catch {
       return { requests: [], complete: false };
     }
@@ -60950,9 +61466,17 @@ var ClaudeCodeAdapter = class {
       next.fiveHour = planLimit.fiveHour;
     if (planLimit.sevenDay)
       next.sevenDay = planLimit.sevenDay;
+    try {
+      if (!accountCreditsSnapshotSchema.safeParse(projectClaudePlanLimitToCredits(next)).success)
+        return null;
+    } catch {
+      return null;
+    }
     this.#latestPlanLimit = next.fiveHour || next.sevenDay ? next : null;
     if (this.#latestPlanLimit) {
+      this.#accountCreditsSupported = true;
       for (const session of this.#sessions) {
+        session.publishAccountCreditsSupport(true);
         if (session !== origin)
           session.publishPlanLimit(this.#latestPlanLimit);
       }
@@ -60977,11 +61501,11 @@ var ClaudeCodeAdapter = class {
 };
 
 // dist/installation.js
-import { readFile as readFile7, realpath as realpath5 } from "node:fs/promises";
+import { readFile as readFile8, realpath as realpath5 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
 import path17 from "node:path";
 async function readSettings(file2) {
-  const text2 = await readFile7(file2, "utf8").catch((error52) => {
+  const text2 = await readFile8(file2, "utf8").catch((error52) => {
     if (error52.code === "ENOENT")
       return "{}";
     throw error52;
@@ -61032,6 +61556,12 @@ function createClaudeInstallation(environment, command) {
         canUpdate,
         ...!canUpdate ? {
           messageCode: blocked ? "claude-policy-restricted" : "original-installer",
+          ...blocked ? {
+            notice: {
+              en: "Claude updates are restricted by the installation's settings or policy.",
+              "zh-CN": "此 Claude 安装的设置或策略限制了更新。"
+            }
+          } : {},
           message: blocked ? "Claude updates are restricted by the installation's settings or policy." : "Use the original installer or package manager for this Claude installation."
         } : {}
       };