@ycodium-ai/agent-kimi 0.2.2690 → 0.2.2696

package/README.md

@@ -12,6 +12,18 @@ customModels } }`; launch arguments (`acp`) and the account-directory variable (
 - Models come from the read-only `kimi provider list --json` (`src/kimiModels.ts`); the version
   from `kimi --version`. No probe session is created.
 - Sign-in is `kimi login` (device-code flow), upgrade is `kimi upgrade`.
+- Usage (ADR-0034), per instance, read only when the user asks. The account directory is the
+  `homePath` setting, an explicit `KIMI_CODE_HOME` in the instance environment, then the process
+  environment, then `~/.kimi-code`:
+  - Quota (`src/kimiQuota.ts`): `GET <base_url>/usages` with the access token from
+    `credentials/kimi-code.json`, through `host.fetch`. `base_url` is `KIMI_CODE_BASE_URL`, else the
+    one in `config.toml`, else the CLI default `https://api.kimi.com/coding/v1`; a non-official host
+    reports `customEndpoint`. The token lives ~15 minutes and only the CLI renews it: an expired token
+    reports `missingCredentials`, the refresh token is never used. Windows are labelled from
+    `{duration, timeUnit}` (`5h`, `7d`).
+  - Tokens (`src/kimiTokens.ts`): `readTokenUsage` reads the `usage.record` lines of every
+    `sessions/*/*/agents/*/wire.jsonl` (the ACP reply carries no usage), deduplicating fork copies, with an
+    in-memory byte-offset resume.
 - Manifest permission is `{ kind: "executor" }`.
 
 Shipped pre-installed as `core.agent-kimi`.

package/dist/index.js

@@ -89,8 +89,8 @@ var KIMI_CARD = {
 };
 
 // src/kimiInstance.ts
-import * as NodeOS2 from "node:os";
-import * as NodePath3 from "node:path";
+import * as NodeOS4 from "node:os";
+import * as NodePath5 from "node:path";
 import { mergeLaunchEnv, modelSelectionStringOption } from "@ycodium-ai/plugin-api/executor";
 import { nodeStreamsFromHandle } from "@ycodium-ai/plugin-api/process-stdin";
 
@@ -1363,14 +1363,14 @@ function codePointLength(str) {
   const units = str.length;
   if (!highSurrogate.test(str))
     return units;
-  let count = units;
+  let count2 = units;
   for (let i = 0; i < units - 1; i++) {
     if ((str.charCodeAt(i) & 64512) === 55296 && (str.charCodeAt(i + 1) & 64512) === 56320) {
-      count--;
+      count2--;
       i++;
     }
   }
-  return count;
+  return count2;
 }
 function getLengthableOrigin(input2) {
   if (Array.isArray(input2))
@@ -5175,7 +5175,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve2) {
+function isRecursive(inst, stack, resolve3) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -5185,7 +5185,7 @@ function isRecursive(inst, stack, resolve2) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve2);
+      const answer = isRecursive(child, stack, resolve3);
       if (answer > result)
         result = answer;
     }
@@ -5196,7 +5196,7 @@ function isRecursive(inst, stack, resolve2) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve2) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve3) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -5260,7 +5260,7 @@ function isRecursive(inst, stack, resolve2) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve2 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve3 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -5725,8 +5725,8 @@ function az_default() {
 }
 
 // ../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/locales/be.js
-function getBelarusianPlural(count, one, few, many) {
-  const absCount = Math.abs(count);
+function getBelarusianPlural(count2, one, few, many) {
+  const absCount = Math.abs(count2);
   const lastDigit = absCount % 10;
   const lastTwoDigits = absCount % 100;
   if (lastTwoDigits >= 11 && lastTwoDigits <= 19) {
@@ -8373,8 +8373,8 @@ function hu_default() {
 }
 
 // ../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/locales/hy.js
-function getArmenianPlural(count, one, many) {
-  return Math.abs(count) === 1 ? one : many;
+function getArmenianPlural(count2, one, many) {
+  return Math.abs(count2) === 1 ? one : many;
 }
 function withDefiniteArticle(word) {
   if (!word)
@@ -11112,8 +11112,8 @@ function ro_default() {
 }
 
 // ../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/locales/ru.js
-function getRussianPlural(count, one, few, many) {
-  const absCount = Math.abs(count);
+function getRussianPlural(count2, one, few, many) {
+  const absCount = Math.abs(count2);
   const lastDigit = absCount % 10;
   const lastTwoDigits = absCount % 100;
   if (lastTwoDigits >= 11 && lastTwoDigits <= 19) {
@@ -21924,11 +21924,11 @@ var Connection = class {
     const id = this.nextRequestId++;
     let cancel = () => {
     };
-    const response = new Promise((resolve2, reject) => {
+    const response = new Promise((resolve3, reject) => {
       const pendingResponse = {
         resolve: (value) => {
           try {
-            resolve2(mapResponse ? mapResponse(value) : value);
+            resolve3(mapResponse ? mapResponse(value) : value);
           } catch (error62) {
             reject(error62);
           }
@@ -21985,8 +21985,8 @@ var Connection = class {
     this.stream = stream;
     this.staticHandlers = handlers;
     this.allowBatches = options?.allowBatches ?? true;
-    this.closedPromise = new Promise((resolve2) => {
-      this.abortController.signal.addEventListener("abort", () => resolve2());
+    this.closedPromise = new Promise((resolve3) => {
+      this.abortController.signal.addEventListener("abort", () => resolve3());
     });
     void this.receive();
   }
@@ -22054,9 +22054,9 @@ var Connection = class {
       return;
     }
     const responseBatch = isResponseBatch(batch);
-    const responseCount = responseBatch ? 0 : batch.reduce((count, message) => count + (isNotificationMessage(message) ? 0 : 1), 0);
+    const responseCount = responseBatch ? 0 : batch.reduce((count2, message) => count2 + (isNotificationMessage(message) ? 0 : 1), 0);
     let remaining = responseCount;
-    let remainingNotifications = batch.reduce((count, message) => count + (isNotificationMessage(message) ? 1 : 0), 0);
+    let remainingNotifications = batch.reduce((count2, message) => count2 + (isNotificationMessage(message) ? 1 : 0), 0);
     let responseSent = false;
     const responses = [];
     const sendResponsesIfReady = async () => {
@@ -22880,8 +22880,8 @@ var AsyncQueue = class {
     if (this.failed) {
       return Promise.reject(this.failure);
     }
-    return new Promise((resolve2, reject) => {
-      this.waiters.push({ resolve: resolve2, reject });
+    return new Promise((resolve3, reject) => {
+      this.waiters.push({ resolve: resolve3, reject });
     });
   }
 };
@@ -23868,8 +23868,8 @@ function createAcpConnection(options) {
     }
     await dispatchMessage(value);
   };
-  const pullEnqueued = async (count) => {
-    for (let i = 0; i < count; i += 1) {
+  const pullEnqueued = async (count2) => {
+    for (let i = 0; i < count2; i += 1) {
       const { value, done } = await incoming.read();
       if (done || value === void 0) {
         return;
@@ -23970,8 +23970,8 @@ function createAcpConnection(options) {
     failIfClosed();
     const id = nextRequestId;
     nextRequestId += 1;
-    const { promise: promise2, resolve: resolve2, reject } = Promise.withResolvers();
-    pending.set(String(id), { method, resolve: resolve2, reject });
+    const { promise: promise2, resolve: resolve3, reject } = Promise.withResolvers();
+    pending.set(String(id), { method, resolve: resolve3, reject });
     const message = params === void 0 ? { jsonrpc: "2.0", id, method } : { jsonrpc: "2.0", id, method, params };
     try {
       await Promise.race([writeMessage(message), promise2]);
@@ -23992,8 +23992,8 @@ function createAcpConnection(options) {
     if (inboundBatches === 0) {
       return;
     }
-    await new Promise((resolve2) => {
-      idleWaiters.push(resolve2);
+    await new Promise((resolve3) => {
+      idleWaiters.push(resolve3);
       if (inboundBatches === 0) {
         releaseIdleWaiters();
       }
@@ -24172,8 +24172,8 @@ var UnboundedEventStream = class {
                 iterators.subscribers.delete(subscriber);
                 return { value: void 0, done: true };
               }
-              await new Promise((resolve2) => {
-                subscriber.wake = resolve2;
+              await new Promise((resolve3) => {
+                subscriber.wake = resolve3;
               });
             }
           },
@@ -24563,8 +24563,8 @@ var Mutex = class {
       this.locked = true;
       return Promise.resolve();
     }
-    return new Promise((resolve2) => {
-      this.waiters.push(resolve2);
+    return new Promise((resolve3) => {
+      this.waiters.push(resolve3);
     });
   }
   tryAcquire() {
@@ -24889,6 +24889,13 @@ function parseSessionModeState(sessionResponse) {
     availableModes
   };
 }
+function acpCommandsToSlashCommands(commands) {
+  return commands.map((command) => ({
+    name: command.name,
+    ...command.description === void 0 ? {} : { description: command.description },
+    ...command.inputHint === void 0 ? {} : { input: { hint: command.inputHint } }
+  }));
+}
 function parseAvailableCommandsUpdate(params) {
   const update = params.update;
   if (update["sessionUpdate"] !== "available_commands_update") {
@@ -25340,24 +25347,7 @@ function filterMcpServersByAgentCapabilities(mcpServers, agentCapabilities) {
   });
 }
 
-// ../../packages/ycodium-acp-executor/src/vendor-hooks.ts
-var defaultVendorHooks = {
-  completedStopReason: (response) => response.stopReason
-};
-
-// ../../packages/ycodium-acp-executor/src/executor.ts
-var DEFAULT_CANCEL_GRACE_MS = 5e3;
-var userInputAnswerOptionId = (question, answers) => {
-  const answer = answers[question.id];
-  const selected = typeof answer === "string" ? answer : Array.isArray(answer) && answer.length === 1 && typeof answer[0] === "string" ? answer[0] : void 0;
-  return selected !== void 0 && question.options.some((option) => option.id === selected) ? selected : void 0;
-};
-function defaultNowIso() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
-function defaultRandomId() {
-  return NodeCrypto.randomUUID();
-}
+// ../../packages/ycodium-acp-executor/src/model-selection.ts
 function normalizeModelId(value) {
   return value?.trim() || void 0;
 }
@@ -25376,6 +25366,25 @@ function modelSelectionStateFromSetup(setup) {
     advertisedModelValues: strategy === "config-option" ? modelConfigOption === void 0 ? [] : collectSessionConfigOptionValues(modelConfigOption) : collectSessionModelIds(sessionModels)
   };
 }
+
+// ../../packages/ycodium-acp-executor/src/vendor-hooks.ts
+var defaultVendorHooks = {
+  completedStopReason: (response) => response.stopReason
+};
+
+// ../../packages/ycodium-acp-executor/src/executor.ts
+var DEFAULT_CANCEL_GRACE_MS = 5e3;
+var userInputAnswerOptionId = (question, answers) => {
+  const answer = answers[question.id];
+  const selected = typeof answer === "string" ? answer : Array.isArray(answer) && answer.length === 1 && typeof answer[0] === "string" ? answer[0] : void 0;
+  return selected !== void 0 && question.options.some((option) => option.id === selected) ? selected : void 0;
+};
+function defaultNowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function defaultRandomId() {
+  return NodeCrypto.randomUUID();
+}
 function createAcpExecutor(options) {
   const hooks = { ...defaultVendorHooks, ...options.hooks };
   const cancelGraceMs = options.cancelGraceMs ?? DEFAULT_CANCEL_GRACE_MS;
@@ -25585,6 +25594,7 @@ function createAcpExecutor(options) {
     const commands = parseAvailableCommandsUpdate(params);
     if (commands !== void 0) {
       availableCommands = commands;
+      options.onAvailableCommands?.(commands);
     }
     if (sessionLoadInFlight) {
       droppedReplayUpdates += parsed.events.filter((event) => event._tag !== "ModeChanged").length;
@@ -25863,14 +25873,14 @@ function createAcpExecutor(options) {
       }
     }
     const requestId = randomId();
-    const outcome = await new Promise((resolve2) => {
+    const outcome = await new Promise((resolve3) => {
       const pending = {
         requestId,
         request: params,
         permissionRequest,
         turnId: activeTurnId,
         settled: false,
-        resolve: resolve2
+        resolve: resolve3
       };
       approvals.add(pending);
       emit(
@@ -26178,14 +26188,14 @@ function createAcpExecutor(options) {
     if (!promptMutex.isLocked) {
       return true;
     }
-    return await new Promise((resolve2) => {
+    return await new Promise((resolve3) => {
       const timer = setTimeout(() => {
         promptWaiters = promptWaiters.filter((waiter) => waiter !== onSettle);
-        resolve2(false);
+        resolve3(false);
       }, timeoutMs);
       const onSettle = () => {
         clearTimeout(timer);
-        resolve2(true);
+        resolve3(true);
       };
       promptWaiters.push(onSettle);
     });
@@ -26651,7 +26661,7 @@ function toAcpMcpServers(entries) {
 
 // ../../packages/ycodium-acp-executor/src/probe.ts
 function withProbeTimeout(promise2, timeoutMs, what) {
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     const timer = setTimeout(() => {
       reject(new Error(`${what} timed out after ${timeoutMs}ms`));
     }, timeoutMs);
@@ -26659,7 +26669,7 @@ function withProbeTimeout(promise2, timeoutMs, what) {
     promise2.then(
       (value) => {
         clearTimeout(timer);
-        resolve2(value);
+        resolve3(value);
       },
       (error62) => {
         clearTimeout(timer);
@@ -26944,6 +26954,14 @@ function readKimiContextWindow(input2) {
   return contents === void 0 ? void 0 : parseKimiContextWindow(contents);
 }
 
+// src/kimiQuota.ts
+import * as NodeFS3 from "node:fs";
+import * as NodeOS2 from "node:os";
+import * as NodePath3 from "node:path";
+import {
+  parseRetryAfterMs
+} from "@ycodium-ai/plugin-api/usage";
+
 // src/kimiAccount.ts
 import * as NodeFS2 from "node:fs";
 import * as NodeOS from "node:os";
@@ -26971,6 +26989,389 @@ function readKimiAuthState(resolvedHomePath) {
   return nonEmptyString(record2["refresh_token"]) || nonEmptyString(record2["access_token"]) ? "signed-in" : "signed-out";
 }
 
+// src/kimiQuota.ts
+var KIMI_OFFICIAL_HOSTS = /* @__PURE__ */ new Set(["api.kimi.com", "api.kimi.ai"]);
+var KIMI_DEFAULT_BASE_URL = "https://api.kimi.com/coding/v1";
+var KIMI_USAGES_PATH = "/usages";
+var QUOTA_TIMEOUT_MS = 1e4;
+var TOKEN_EXPIRY_SKEW_MS = 3e4;
+var asObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+var asString3 = (value) => typeof value === "string" && value.length > 0 ? value : null;
+var asNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : null;
+var asCount = (value) => {
+  const direct = asNumber(value);
+  if (direct !== null) return direct;
+  const text = asString3(value);
+  if (text === null) return null;
+  const parsed = Number(text);
+  return Number.isFinite(parsed) ? parsed : null;
+};
+var parseJson = (raw) => {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+};
+var clampPercent = (value) => Math.min(100, Math.max(0, value));
+var expiryMs = (value) => {
+  const raw = asNumber(value);
+  if (raw === null || raw <= 0) return null;
+  return raw > 1e12 ? raw : raw * 1e3;
+};
+var extractKimiToken = (auth, nowMs) => {
+  const record2 = asObject(auth);
+  if (record2 === null) return null;
+  const token = asString3(record2["access_token"]);
+  if (token === null) return null;
+  const expiresAtMs = expiryMs(record2["expires_at"]);
+  if (expiresAtMs === null) return token;
+  return expiresAtMs - nowMs < TOKEN_EXPIRY_SKEW_MS ? null : token;
+};
+var isOfficialUrl = (value) => {
+  const parsed = URL.parse(value.trim());
+  return parsed === null ? false : KIMI_OFFICIAL_HOSTS.has(parsed.hostname.toLowerCase());
+};
+var readTomlScalar = (raw) => {
+  const quoted = /^(["'])(.*?)\1/.exec(raw.trim());
+  if (quoted?.[2] !== void 0) return quoted[2];
+  const [beforeComment = ""] = raw.split("#");
+  return beforeComment.trim();
+};
+var TABLE_HEADER = /^\s*\[\s*([^\]]+?)\s*\]\s*(?:#.*)?$/;
+var BASE_URL_LINE = /^\s*base_url\s*=\s*(\S.*)$/;
+var kimiConfigBaseUrls = (contents) => {
+  const found = [];
+  let table = "";
+  for (const line of contents.split("\n")) {
+    const header = TABLE_HEADER.exec(line);
+    if (header !== null) {
+      table = header[1] ?? "";
+      continue;
+    }
+    const match = BASE_URL_LINE.exec(line);
+    if (match === null) continue;
+    const url2 = readTomlScalar(match[1] ?? "");
+    if (url2.length > 0) found.push({ url: url2, isTool: table.startsWith("tools.") });
+  }
+  return found;
+};
+var usagesUrlFrom = (baseUrl) => baseUrl.trim().replace(/\/+$/, "") + KIMI_USAGES_PATH;
+var kimiUsagesEndpoint = (input2) => {
+  const fromEnv = input2.envBaseUrl?.trim() ?? "";
+  if (fromEnv.length > 0) {
+    return isOfficialUrl(fromEnv) ? { usagesUrl: usagesUrlFrom(fromEnv) } : { custom: true };
+  }
+  const configured = input2.configToml === null ? [] : kimiConfigBaseUrls(input2.configToml);
+  if (configured.some((entry) => !isOfficialUrl(entry.url))) return { custom: true };
+  const root = configured.find((entry) => !entry.isTool)?.url ?? KIMI_DEFAULT_BASE_URL;
+  return { usagesUrl: usagesUrlFrom(root) };
+};
+var TIME_UNIT_MINUTES = {
+  TIME_UNIT_MINUTE: 1,
+  TIME_UNIT_HOUR: 60,
+  TIME_UNIT_DAY: 1440,
+  TIME_UNIT_WEEK: 10080
+};
+var kimiWindowSpan = (window) => {
+  const record2 = asObject(window);
+  if (record2 === null) return null;
+  const duration3 = asCount(record2["duration"]);
+  const unit = asString3(record2["timeUnit"]);
+  const minutesPerUnit = unit === null ? void 0 : TIME_UNIT_MINUTES[unit];
+  if (duration3 === null || duration3 <= 0 || minutesPerUnit === void 0) return null;
+  const minutes = duration3 * minutesPerUnit;
+  const label = minutes % 1440 === 0 ? `${minutes / 1440}d` : minutes % 60 === 0 ? `${minutes / 60}h` : `${minutes}m`;
+  return { label, windowMs: minutes * 6e4 };
+};
+var windowFrom = (id, label, detail, windowMs) => {
+  const record2 = asObject(detail);
+  if (record2 === null) return null;
+  const limit = asCount(record2["limit"]);
+  if (limit === null || limit <= 0) return null;
+  const remaining = asCount(record2["remaining"]);
+  const used = asCount(record2["used"]) ?? (remaining === null ? null : limit - remaining);
+  if (used === null) return null;
+  return {
+    id,
+    label,
+    usedPercent: clampPercent(used / limit * 100),
+    resetsAt: asString3(record2["resetTime"]),
+    ...windowMs === void 0 ? {} : { windowMs }
+  };
+};
+var kimiPlanName = (body) => {
+  const level = asString3(asObject(asObject(asObject(body)?.["user"])?.["membership"])?.["level"]);
+  if (level === null) return void 0;
+  const bare = level.replace(/^LEVEL_/, "").toLowerCase();
+  return bare.length === 0 ? void 0 : bare.charAt(0).toUpperCase() + bare.slice(1);
+};
+var kimiQuotaWindows = (body) => {
+  const root = asObject(body);
+  const windows = [];
+  const subscription = windowFrom(
+    "subscription",
+    { key: "usage.window.subscription" },
+    root?.["usage"],
+    void 0
+  );
+  if (subscription !== null) windows.push(subscription);
+  const limits = root?.["limits"];
+  if (Array.isArray(limits)) {
+    for (const [index, entry] of limits.entries()) {
+      const row = asObject(entry);
+      if (row === null) continue;
+      const span = kimiWindowSpan(row["window"]);
+      const name = asString3(row["name"]);
+      const label = span !== null ? { key: "usage.window.duration", values: { duration: span.label } } : name !== null ? { text: name } : null;
+      if (label === null) continue;
+      const window = windowFrom(`limit-${index}`, label, row["detail"], span?.windowMs);
+      if (window !== null) windows.push(window);
+    }
+  }
+  return windows;
+};
+var kimiEffectiveHome = (resolvedHomePath, processEnvHome) => {
+  if (resolvedHomePath.trim().length > 0) return resolvedHomePath;
+  const fromEnv = processEnvHome?.trim() ?? "";
+  return fromEnv.length > 0 ? fromEnv : "";
+};
+var createKimiUsage = (input2) => {
+  const now = input2.now ?? Date.now;
+  const processEnv = input2.processEnv ?? process.env;
+  const home = input2.homePath.trim().length > 0 ? input2.homePath : NodePath3.join(NodeOS2.homedir(), ".kimi-code");
+  const credentialsPath = kimiCredentialsPath(input2.homePath);
+  const readQuota = async (request) => {
+    let configToml = null;
+    try {
+      configToml = NodeFS3.readFileSync(NodePath3.join(home, "config.toml"), "utf8");
+    } catch (error62) {
+      if (error62.code !== "ENOENT") {
+        return { status: "unavailable", reason: "unreachable" };
+      }
+    }
+    const endpoint = kimiUsagesEndpoint({
+      envBaseUrl: input2.environment["KIMI_CODE_BASE_URL"] ?? processEnv["KIMI_CODE_BASE_URL"],
+      configToml
+    });
+    if ("custom" in endpoint) return { status: "unavailable", reason: "customEndpoint" };
+    let token = null;
+    try {
+      token = extractKimiToken(parseJson(NodeFS3.readFileSync(credentialsPath, "utf8")), now());
+    } catch {
+      token = null;
+    }
+    if (token === null) return { status: "unavailable", reason: "missingCredentials" };
+    let response;
+    try {
+      response = await input2.fetch(endpoint.usagesUrl, {
+        headers: { Authorization: `Bearer ${token}`, Accept: "application/json" },
+        signal: AbortSignal.any([
+          ...request.signal === void 0 ? [] : [request.signal],
+          AbortSignal.timeout(QUOTA_TIMEOUT_MS)
+        ])
+      });
+    } catch {
+      return { status: "unavailable", reason: "unreachable" };
+    }
+    if (response.status === 401 || response.status === 403) {
+      return { status: "unavailable", reason: "authRejected" };
+    }
+    if (response.status === 429) {
+      const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"), now());
+      return {
+        status: "unavailable",
+        reason: "rateLimited",
+        ...retryAfterMs === null ? {} : { retryAfterMs }
+      };
+    }
+    if (!response.ok) return { status: "unavailable", reason: "unreachable" };
+    let body;
+    try {
+      body = parseJson(await response.text());
+    } catch {
+      return { status: "unavailable", reason: "unreachable" };
+    }
+    if (asObject(body) === null) return { status: "unavailable", reason: "unreachable" };
+    const plan = kimiPlanName(body);
+    return {
+      status: "available",
+      ...plan === void 0 ? {} : { plan },
+      windows: kimiQuotaWindows(body),
+      balances: [],
+      accountKey: credentialsPath
+    };
+  };
+  return { readQuota };
+};
+
+// src/kimiTokens.ts
+import * as NodeFS4 from "node:fs";
+import * as NodeOS3 from "node:os";
+import * as NodePath4 from "node:path";
+var MTIME_SLACK_MS = 36 * 60 * 60 * 1e3;
+var GUARD_LENGTH = 64;
+var isRecord8 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var count = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : 0;
+var parseKimiUsageLine = (line) => {
+  if (!line.includes('"usage.record"')) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(line);
+  } catch {
+    return "malformed";
+  }
+  if (!isRecord8(parsed) || parsed["type"] !== "usage.record") return void 0;
+  const usage = parsed["usage"];
+  const model = typeof parsed["model"] === "string" ? parsed["model"].trim() : "";
+  const timeMs = parsed["time"];
+  if (!isRecord8(usage) || model.length === 0 || typeof timeMs !== "number" || !Number.isFinite(timeMs)) {
+    return "malformed";
+  }
+  const totals = {
+    uncachedInputTokens: count(usage["inputOther"]),
+    cachedInputTokens: count(usage["inputCacheRead"]),
+    cacheCreationTokens: count(usage["inputCacheCreation"]),
+    outputTokens: count(usage["output"]),
+    reasoningTokens: 0
+  };
+  return {
+    timeMs,
+    model,
+    totals,
+    key: `${timeMs}\0${model}\0${totals.uncachedInputTokens}\0${totals.cachedInputTokens}\0${totals.cacheCreationTokens}\0${totals.outputTokens}`
+  };
+};
+var hasTokens = (totals) => totals.uncachedInputTokens > 0 || totals.cachedInputTokens > 0 || totals.cacheCreationTokens > 0 || totals.outputTokens > 0;
+var readDirs = (dir) => {
+  try {
+    return NodeFS4.readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  } catch {
+    return [];
+  }
+};
+var listWireLogs = (sessionsRoot) => {
+  const found = [];
+  for (const workspace of readDirs(sessionsRoot)) {
+    for (const session of readDirs(NodePath4.join(sessionsRoot, workspace))) {
+      const agentsDir = NodePath4.join(sessionsRoot, workspace, session, "agents");
+      for (const agent of readDirs(agentsDir)) {
+        found.push({ file: NodePath4.join(agentsDir, agent, "wire.jsonl"), sessionId: session });
+      }
+    }
+  }
+  return found;
+};
+var readRange = (file2, from, to) => {
+  const length = Math.max(0, to - from);
+  const buffer = Buffer.alloc(length);
+  const fd = NodeFS4.openSync(file2, "r");
+  try {
+    let read = 0;
+    while (read < length) {
+      const n = NodeFS4.readSync(fd, buffer, read, length - read, from + read);
+      if (n === 0) break;
+      read += n;
+    }
+    return read === length ? buffer : buffer.subarray(0, read);
+  } finally {
+    NodeFS4.closeSync(fd);
+  }
+};
+var guardOf = (file2, size) => readRange(file2, 0, Math.min(size, GUARD_LENGTH)).toString("base64");
+var createKimiTokenReader = (input2) => {
+  const home = input2.homePath.trim().length > 0 ? NodePath4.resolve(input2.homePath) : NodePath4.join(NodeOS3.homedir(), ".kimi-code");
+  const sessionsRoot = NodePath4.join(home, "sessions");
+  const memos = /* @__PURE__ */ new Map();
+  const refresh = (file2, size) => {
+    const guard = guardOf(file2, size);
+    const memo2 = memos.get(file2);
+    const resumable = memo2 !== void 0 && memo2.size <= size && memo2.guard === guard;
+    if (resumable && memo2.size === size) return memo2;
+    const from = resumable ? memo2.offset : 0;
+    const chunk = readRange(file2, from, size);
+    const lastNewline = chunk.lastIndexOf(10);
+    const complete = lastNewline < 0 ? Buffer.alloc(0) : chunk.subarray(0, lastNewline + 1);
+    const next = resumable ? { ...memo2, size, offset: from + complete.length } : { size, guard, offset: complete.length, malformed: 0, records: [] };
+    for (const line of complete.toString("utf8").split("\n")) {
+      if (line.length === 0) continue;
+      const parsed = parseKimiUsageLine(line);
+      if (parsed === void 0) continue;
+      if (parsed === "malformed") next.malformed += 1;
+      else next.records.push(parsed);
+    }
+    memos.set(file2, next);
+    return next;
+  };
+  const readTokenUsage = async (request) => {
+    const sinceMs = Date.parse(request.since);
+    const untilMs = Date.parse(request.until);
+    if (!NodeFS4.existsSync(sessionsRoot)) {
+      return {
+        records: [],
+        source: {
+          homePath: home,
+          status: "missing",
+          scannedFiles: 0,
+          skippedFiles: 0,
+          message: `No Kimi sessions directory at ${sessionsRoot}`
+        }
+      };
+    }
+    const records = [];
+    const seen = /* @__PURE__ */ new Set();
+    let scannedFiles = 0;
+    let skippedFiles = 0;
+    let failedFiles = 0;
+    let malformedRecords = 0;
+    for (const { file: file2, sessionId } of listWireLogs(sessionsRoot)) {
+      let size;
+      try {
+        const stat = NodeFS4.statSync(file2);
+        if (stat.mtimeMs < sinceMs - MTIME_SLACK_MS) {
+          skippedFiles += 1;
+          continue;
+        }
+        size = stat.size;
+      } catch {
+        continue;
+      }
+      let memo2;
+      try {
+        memo2 = refresh(file2, size);
+      } catch {
+        failedFiles += 1;
+        continue;
+      }
+      scannedFiles += 1;
+      malformedRecords += memo2.malformed;
+      for (const record2 of memo2.records) {
+        if (record2.timeMs < sinceMs || record2.timeMs >= untilMs) continue;
+        if (!hasTokens(record2.totals) || seen.has(record2.key)) continue;
+        seen.add(record2.key);
+        records.push({
+          at: new Date(record2.timeMs).toISOString(),
+          model: record2.model,
+          sessionId,
+          totals: record2.totals
+        });
+      }
+    }
+    return {
+      records,
+      source: {
+        homePath: home,
+        status: failedFiles > 0 ? "partial" : "ok",
+        scannedFiles,
+        skippedFiles: skippedFiles + failedFiles,
+        malformedRecords,
+        ...failedFiles > 0 ? { message: `${failedFiles} session log(s) could not be read` } : {}
+      }
+    };
+  };
+  return { readTokenUsage };
+};
+
 // src/kimiModels.ts
 import {
   describeExecutorSpawnFailure,
@@ -26985,10 +27386,10 @@ var probeFailureDetail = (error62) => (error62 instanceof Error ? error62.messag
 var PROBE_TIMEOUT_MS = 15e3;
 var MAX_OUTPUT_BYTES = 1024 * 1024;
 var KIMI_MODEL_LIST_ARGS = ["provider", "list", "--json"];
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function asString3(value) {
+function asString4(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 }
 function positiveInt2(value) {
@@ -27001,14 +27402,14 @@ function kimiProbeModels(stdout) {
   } catch {
     return void 0;
   }
-  if (!isRecord8(parsed)) return void 0;
+  if (!isRecord9(parsed)) return void 0;
   const models = parsed["models"];
-  if (!isRecord8(models)) return void 0;
+  if (!isRecord9(models)) return void 0;
   const out = [];
   for (const [slug, entry] of Object.entries(models)) {
     const trimmed = slug.trim();
-    if (trimmed.length === 0 || !isRecord8(entry)) continue;
-    const name = asString3(entry["displayName"]);
+    if (trimmed.length === 0 || !isRecord9(entry)) continue;
+    const name = asString4(entry["displayName"]);
     const contextWindow = positiveInt2(entry["maxContextSize"]);
     out.push({
       slug: trimmed,
@@ -27107,8 +27508,8 @@ function acpSessionModeToApply(requestedNativeModeId, startedModeId) {
 // src/kimiInstance.ts
 var RESUME_SCHEMA_VERSION = 1;
 var CLIENT_INFO = { name: "ycodium-agent-kimi", version: "0.1.0" };
-var yieldTick = () => new Promise((resolve2) => {
-  setImmediate(resolve2);
+var yieldTick = () => new Promise((resolve3) => {
+  setImmediate(resolve3);
 });
 var EventBus = class {
   #queued = [];
@@ -27135,17 +27536,17 @@ var EventBus = class {
         const queued = this.#queued.shift();
         if (queued !== void 0) return Promise.resolve({ done: false, value: queued });
         if (this.#closed) return Promise.resolve({ done: true, value: void 0 });
-        return new Promise((resolve2) => {
-          this.#waiters.push(resolve2);
+        return new Promise((resolve3) => {
+          this.#waiters.push(resolve3);
         });
       }
     };
   }
 };
 function expandHomePath(value) {
-  if (value === "~") return NodeOS2.homedir();
+  if (value === "~") return NodeOS4.homedir();
   if (value.startsWith("~/") || value.startsWith("~\\")) {
-    return NodePath3.join(NodeOS2.homedir(), value.slice(2));
+    return NodePath5.join(NodeOS4.homedir(), value.slice(2));
   }
   return value;
 }
@@ -27170,7 +27571,7 @@ function nowIso() {
 }
 function kimiContinuationKey(recipe) {
   const homePath = recipe.homePath.trim();
-  const resolvedHomePath = homePath.length > 0 ? NodePath3.resolve(expandHomePath(homePath)) : "";
+  const resolvedHomePath = homePath.length > 0 ? NodePath5.resolve(expandHomePath(homePath)) : "";
   return `kimiCode:home:${recipe.binaryPath.trim()}\0${resolvedHomePath}`;
 }
 function resolveHomePath(recipe) {
@@ -27199,6 +27600,7 @@ var createKimiInstance = (config2, host) => {
   const events = new EventBus();
   const threads = /* @__PURE__ */ new Map();
   let disposed = false;
+  const usageHome = kimiEffectiveHome(resolveHomePath(recipe), process.env[recipe.homeEnvVar]);
   const requireThread = (threadId) => {
     const booked = threads.get(threadId);
     if (!booked) throw new Error(`unknown thread ${threadId}`);
@@ -27312,6 +27714,11 @@ var createKimiInstance = (config2, host) => {
         providerInstanceId: host.instanceId,
         clientInfo: CLIENT_INFO,
         log: host.log,
+        // agent 自己宣告的斜杠命令按会话报给宿主，输入区的 / 菜单才有它们。
+        onAvailableCommands: (commands) => host.reportSessionInventory?.({
+          threadId: input2.threadId,
+          slashCommands: acpCommandsToSlashCommands(commands)
+        }),
         ...requestedModelId === void 0 ? {} : { requestedModelId },
         ...input2.bindingGeneration === void 0 ? {} : { originBindingGeneration: input2.bindingGeneration },
         hooks,
@@ -27469,6 +27876,15 @@ var createKimiInstance = (config2, host) => {
       return { threadId, turns: booked.turns };
     },
     events,
+    // 额度与 token 都读这个实例自己的账号目录（与它的 CLI 同一个）。
+    usage: {
+      ...createKimiUsage({
+        homePath: usageHome,
+        environment: recipe.environment,
+        fetch: host.fetch
+      }),
+      ...createKimiTokenReader({ homePath: usageHome })
+    },
     continuationKey: kimiContinuationKey(recipe),
     dispose: async () => {
       if (disposed) return;

package/locales/en.json

@@ -10,5 +10,11 @@
       "description": "Sessions and the `kimi login` credentials live here, so providers sharing this directory can pick up each other's threads and providers with different directories cannot. Leave empty to use the CLI's default.",
       "placeholder": "e.g. ~/.kimi-code-work"
     }
+  },
+  "usage": {
+    "window": {
+      "subscription": "Subscription",
+      "duration": "{{duration}} window"
+    }
   }
 }

package/locales/zh-CN.json

@@ -10,5 +10,11 @@
       "description": "会话和 `kimi login` 的凭据都保存在这里，因此共用同一目录的 provider 可以接手彼此的会话，目录不同的则不能。留空则使用该命令行工具的默认目录。",
       "placeholder": "例如 ~/.kimi-code-work"
     }
+  },
+  "usage": {
+    "window": {
+      "subscription": "订阅",
+      "duration": "{{duration}} 窗口"
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ycodium-ai/agent-kimi",
-  "version": "0.2.2690",
+  "version": "0.2.2696",
   "description": "Kimi Code executor: runs `kimi acp` over Agent Client Protocol stdio.",
   "keywords": [
     "ycodium",
@@ -21,9 +21,9 @@
     "@types/node": "24.12.4",
     "esbuild": "0.28.1",
     "vite-plus": "0.2.2",
-    "ycodium-acp-executor": "0.2.2690",
-    "@ycodium-ai/plugin-api": "0.2.2690",
-    "ycodium-executor-testing": "0.0.0"
+    "@ycodium-ai/plugin-api": "0.2.2696",
+    "ycodium-executor-testing": "0.0.0",
+    "ycodium-acp-executor": "0.2.2696"
   },
   "ycodium": {
     "plugin": "./dist/index.js",