@codexhost/cli-win32-arm64 0.13.2 → 0.13.3

package/app/host-runtime.mjs

@@ -20027,6 +20027,15 @@ var harnessDisplaySetSchema = external_exports.strictObject({
   initializeOnly: external_exports.boolean().optional()
 });
 
+// packages/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((text) => text.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");
+
 // packages/shared-contracts/dist/model-price-overrides.js
 var MODEL_PRICE_OVERRIDES_GET_METHOD = "codexhost/usage/model-prices/get";
 var MODEL_PRICE_OVERRIDES_SET_METHOD = "codexhost/usage/model-prices/set";
@@ -20376,8 +20385,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(),
@@ -20397,9 +20422,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();
@@ -20410,7 +20437,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();
 
 // packages/shared-contracts/dist/harness-accounts.js
@@ -20537,7 +20566,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),
@@ -20961,6 +20991,8 @@ var harnessInstallationStateSchema = external_exports.object({
   // 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();
 
@@ -21091,6 +21123,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
@@ -21482,6 +21515,9 @@ var RuntimeMaintenance = class {
   #watch = null;
   #starting = null;
   #startingVersion = null;
+  get #startTimeoutMs() {
+    return this.options.updaterStartTimeoutMs ?? UPDATER_START_TIMEOUT_MS;
+  }
   #ensureWatching() {
     if (this.#watch) return;
     this.#watch = setInterval(() => {
@@ -21578,7 +21614,7 @@ var RuntimeMaintenance = class {
             }
           } else {
             const written = (await stat(this.#statusPath)).mtimeMs;
-            alive = Date.now() - written < UPDATER_START_TIMEOUT_MS * 2;
+            alive = Date.now() - written < this.#startTimeoutMs * 2;
           }
           if (!alive) {
             parsed2.phase = "failed";
@@ -21702,7 +21738,7 @@ var RuntimeMaintenance = class {
     if (!Number.isSafeInteger(helperPid) || helperPid <= 0) {
       throw new Error("Remote updater could not be started");
     }
-    const deadline = Date.now() + UPDATER_START_TIMEOUT_MS;
+    const deadline = Date.now() + this.#startTimeoutMs;
     while (!await this.#helperReported()) {
       if (Date.now() >= deadline) {
         try {
@@ -25003,6 +25039,16 @@ function rewriteDelegationMentionInput(input, skill) {
   return rewritten;
 }
 
+// packages/harness-adapter/dist/account-credits.js
+function parseHarnessAccountCredits(value2) {
+  if (!value2 || typeof value2 !== "object" || Array.isArray(value2))
+    return null;
+  const publicValue = { ...value2 };
+  delete publicValue.fetchedAt;
+  const parsed2 = accountCreditsSnapshotSchema.safeParse(publicValue);
+  return parsed2.success ? parsed2.data : null;
+}
+
 // packages/harness-adapter/dist/output-channel.js
 var HarnessOutputChannel = class {
   outputs;
@@ -27102,6 +27148,7 @@ function projectCodexRateLimitsToCredits(usage, resetCredits) {
   const resetsAtUnix = hasFiveHour ? usage.planFiveHourResetsAtUnix : usage.planSevenDayResetsAtUnix;
   const secondary = hasFiveHour && hasSevenDay && usage.planSevenDayUsedPercent !== void 0 ? {
     product: "7-day window",
+    periodType: "seven_day",
     usagePercent: usage.planSevenDayUsedPercent,
     ...usage.planSevenDayResetsAtUnix !== void 0 ? { resetsAt: isoFromUnix(usage.planSevenDayResetsAtUnix) } : {}
   } : void 0;
@@ -35789,7 +35836,9 @@ function hasValidSessionUsage(value2) {
 }
 function isAdapter(value2) {
   if (!value2 || typeof value2 !== "object") return false;
-  return hasValidSessionUsage(value2) && ["inspect", "open", "close"].every((key) => typeof Reflect.get(value2, key) === "function");
+  return hasValidSessionUsage(value2) && ["inspect", "open", "close"].every((key) => typeof Reflect.get(value2, key) === "function") && ["credits", "refreshCredits"].every(
+    (key) => Reflect.get(value2, key) === void 0 || typeof Reflect.get(value2, key) === "function"
+  );
 }
 function isUsageAdapter(value2) {
   if (!value2 || typeof value2 !== "object" || typeof Reflect.get(value2, "close") !== "function")
@@ -37657,6 +37706,16 @@ async function moveThreadSection(input) {
   }
 }
 
+// packages/host-runtime/src/external-thread-official-defaults.ts
+var EMPTY_RESULTS = /* @__PURE__ */ new Map([
+  ["thread/attachment/list", () => ({ data: [], nextCursor: null })],
+  ["thread/queue/list", () => ({ data: [], nextCursor: null })],
+  ["thread/settings/update", () => ({})]
+]);
+function externalThreadEmptyOfficialResult(method) {
+  return EMPTY_RESULTS.get(method)?.();
+}
+
 // packages/host-runtime/src/observed-session-usage.ts
 var ObservedSessionUsage = class {
   constructor(providers, prices, diagnose) {
@@ -37825,16 +37884,6 @@ function officialThreadBusy(thread) {
   const latestTurn = turns.at(-1);
   return isRecord18(latestTurn) && (latestTurn.status === "inProgress" || latestTurn.status === "running");
 }
-function isCreditsAdapter(adapter) {
-  return typeof adapter.credits === "function";
-}
-function projectAccountCredits(value2) {
-  if (!isRecord18(value2)) return null;
-  const rest = { ...value2 };
-  delete rest.fetchedAt;
-  const parsed2 = accountCreditsSnapshotSchema.safeParse(rest);
-  return parsed2.success ? parsed2.data : null;
-}
 function errorMessage4(error51) {
   return error51 instanceof Error ? error51.message : String(error51);
 }
@@ -39271,8 +39320,9 @@ var AppServerHost = class {
       const location = await this.#locateExternalThread(request.params.threadId);
       if (await this.#writeResolutionError(request, location)) return;
       if (location.kind === "external") {
+        const emptyResult = externalThreadEmptyOfficialResult(request.method);
         await this.#writer.json(
-          rpcError(request, -32076, `External Thread does not support ${request.method}`)
+          emptyResult ? rpcEnvelope(request, { result: emptyResult }) : rpcError(request, -32076, `External Thread does not support ${request.method}`)
         );
         return;
       }
@@ -40328,6 +40378,7 @@ var AppServerHost = class {
       const result2 = threadUsageInspectionSchema.parse({
         threadId: params.data.threadId,
         usage: await this.#observedSessionUsage.read(params.data.threadId),
+        accountCreditsSupported: true,
         ...accountCredits ? { accountCredits } : {}
       });
       await this.#writer.json(rpcEnvelope(request, { result: jsonValueSchema.parse(result2) }));
@@ -40335,11 +40386,17 @@ var AppServerHost = class {
     }
     if (params.data.refresh === "exact") void resolution.thread.session.refreshUsage?.();
     const adapter = this.#externalAdapters.get(resolution.thread.harnessId);
-    if (adapter && isCreditsAdapter(adapter)) void adapter.refreshCredits?.();
-    const credits = adapter && isCreditsAdapter(adapter) ? projectAccountCredits(adapter.credits()) : null;
+    if (adapter?.credits && adapter.refreshCredits)
+      void Promise.resolve().then(() => adapter.refreshCredits?.()).catch(() => void 0);
+    let credits = null;
+    try {
+      credits = parseHarnessAccountCredits(adapter?.credits?.());
+    } catch {
+    }
     const result = threadUsageInspectionSchema.parse({
       threadId: params.data.threadId,
       usage: await this.#threadUsage(resolution.thread),
+      accountCreditsSupported: typeof adapter?.credits === "function",
       ...credits ? { accountCredits: credits } : {}
     });
     await this.#writer.json(rpcEnvelope(request, { result: jsonValueSchema.parse(result) }));
@@ -47853,8 +47910,11 @@ async function startHarnessBrokerServer(input) {
         retireWhenIdle = false;
       if (request.method === "adapter.credits") {
         harnessAccountListParamsSchema.parse(request.params);
-        const adapter = input.adapter;
-        return accountCreditsSnapshotSchema.nullable().parse(adapter.credits?.() ?? null);
+        const value2 = input.adapter.credits?.();
+        const credits = parseHarnessAccountCredits(value2);
+        if (value2 != null && !credits)
+          throw new Error("Invalid account credits snapshot");
+        return credits;
       }
       if (request.method === "adapter.inspectAccount") {
         harnessAccountListParamsSchema.parse(request.params);

package/app/plugins/antigravity/plugin.mjs

@@ -15010,6 +15010,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((text) => text.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({
@@ -15346,8 +15355,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(),
@@ -15367,9 +15392,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();
@@ -15380,7 +15407,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
@@ -15507,7 +15536,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),
@@ -15894,6 +15924,8 @@ var harnessInstallationStateSchema = external_exports.object({
   // 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();
 
@@ -16020,6 +16052,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
@@ -17080,6 +17113,12 @@ var ANTIGRAVITY_PERMISSION_MODE_CATALOG = harnessPermissionModeCatalogSchema.par
     {
       id: "dangerously-skip-permissions",
       label: "Skip permissions",
+      localizations: {
+        "zh-CN": {
+          label: "跳过权限检查",
+          description: "使用 --dangerously-skip-permissions 运行 Antigravity CLI；codexhost 不增加工具审批或工作区限制。"
+        }
+      },
       description: "Run Antigravity CLI with --dangerously-skip-permissions. codexhost adds no tool approval or workspace restrictions.",
       dangerous: true
     }
@@ -17801,6 +17840,8 @@ function parseBuckets(groups) {
       const resetsAt = nonEmptyString(bucket.reset_time);
       buckets.push({
         product: groupName ? `${groupName} · ${label}` : label,
+        periodType: periodTypeFrom(window),
+        ...groupName ? { scope: { id: groupName, label: groupName } } : {},
         usagePercent,
         window,
         ...resetsAt ? { resetsAt } : {}
@@ -17834,14 +17875,17 @@ function parseAntigravityUsageCommand(command, fetchedAt = (/* @__PURE__ */ new
     return null;
   const others = buckets.filter((bucket) => bucket !== leading);
   return {
-    label: leading.product,
+    ...leading.scope || periodTypeFrom(leading.window) === "unknown" ? { label: leading.product } : {},
+    ...leading.scope ? { scope: leading.scope } : {},
     usedPercent: leading.usagePercent,
     periodType: periodTypeFrom(leading.window),
     fetchedAt,
     ...leading.resetsAt ? { resetsAt: leading.resetsAt } : {},
     ...others.length > 0 ? {
-      productUsage: others.map(({ product, usagePercent, resetsAt }) => ({
+      productUsage: others.map(({ product, periodType, scope, usagePercent, resetsAt }) => ({
         product,
+        ...periodType ? { periodType } : {},
+        ...scope ? { scope } : {},
         usagePercent,
         ...resetsAt ? { resetsAt } : {}
       }))
@@ -19885,7 +19929,8 @@ var AntigravityAdapter = class {
       return null;
     return {
       credits: {
-        label: snapshot.label,
+        ...snapshot.label ? { label: snapshot.label } : {},
+        ...snapshot.scope ? { scope: snapshot.scope } : {},
         usedPercent: snapshot.usedPercent,
         periodType: snapshot.periodType,
         ...snapshot.resetsAt ? { resetsAt: snapshot.resetsAt } : {},
@@ -19893,7 +19938,7 @@ var AntigravityAdapter = class {
       }
     };
   }
-  /** Duck-typed by the Host Runtime to populate the account credits surface. */
+  /** Public account telemetry cache; never attributes quota to historical Thread spend. */
   credits() {
     return this.#quota;
   }