@botiverse/oar 0.0.3 → 0.0.5

package/README.md

@@ -1,13 +1,24 @@
 # @botiverse/oar
 
-Provider-independent TypeScript contracts and built-in implementations for observing agent runtimes.
+Provider-independent TypeScript contracts and built-in implementations for controlling and observing Claude, Codex, Grok, Kimi, and Pi.
 
 ```ts
 import { runtimes } from "@botiverse/oar";
 
-const codex = runtimes.require("codex");
-const installation = await codex.installation?.probe();
-const usage = await codex.accountUsage?.read();
+const runtime = runtimes.require("grok");
+const installation = await runtime.installation?.();
+
+if (installation?.kind === "available") {
+  const session = await runtime.session(installation, { cwd: process.cwd() });
+  const result = session.prompt("Inspect this repository");
+  if (result.kind === "turn") {
+    console.log(await result.turn.outcome);
+  }
+  console.log(await runtime.accountUsage?.(installation));
+  await session.dispose();
+}
 ```
 
+Grok and Kimi share an internal ACP v1 transport and session kernel, but only their concrete runtime identities are public. The registry deliberately does not expose a generic `acp` runtime.
+
 The command-line interface is a separate package: `@botiverse/oar-cli`.

package/dist/contracts/account-usage.d.ts

@@ -17,6 +17,7 @@ export interface AccountUsageWindow {
 }
 export type AccountUsageSnapshot = {
     readonly kind: "available";
+    /** Runtime-reported subscription plan or tier; omitted when not exposed. */
     readonly plan?: string;
     /** Signed-in account email; omitted when the runtime does not expose one. */
     readonly email?: string;

package/dist/contracts/account-usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account-usage.d.ts","sourceRoot":"","sources":["../../src/contracts/account-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,CAAC,MAAM,eAAe,EAAE,OAAO,MAAM,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACjD,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACpC;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,YAAY,EAAE,qBAAqB,EACnC,OAAO,CAAC,EAAE,uBAAuB,KAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"account-usage.d.ts","sourceRoot":"","sources":["../../src/contracts/account-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,CAAC,MAAM,eAAe,EAAE,OAAO,MAAM,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACjD,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACpC;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,YAAY,EAAE,qBAAqB,EACnC,OAAO,CAAC,EAAE,uBAAuB,KAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/contracts/model-catalog.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Provider-independent model catalog facade — the other half of the provider
+ * plane (see {@link ./provider-auth.js}). It lists providers and their models
+ * with capabilities and refreshes the remote catalog, but is credential-blind:
+ * it reads auth status only to report which providers are usable, never logs
+ * in. The built-in implementation wraps Pi's `ModelRegistry`.
+ */
+/** One provider in the catalog. */
+export interface CatalogProvider {
+    readonly id: string;
+    readonly name: string;
+    /** Whether this provider has a usable configured credential. */
+    readonly configured: boolean;
+}
+/** One model with its normalized capabilities. */
+export interface CatalogModel {
+    readonly id: string;
+    readonly providerId: string;
+    /** The provider's wire protocol, e.g. `"anthropic-messages"` or `"openai-completions"`. */
+    readonly wire: string;
+    readonly baseUrl: string;
+    readonly contextWindow: number;
+    readonly maxTokens: number;
+    /** Whether the model exposes a reasoning/thinking channel. */
+    readonly reasoning: boolean;
+    /** Accepted input modalities. */
+    readonly input: readonly ("text" | "image")[];
+}
+export interface CatalogRefreshOptions {
+    /** Limit the refresh to these provider ids. */
+    readonly providers?: readonly string[];
+    /** Allow network access to fetch the remote catalog. */
+    readonly allowNetwork?: boolean;
+    readonly signal?: AbortSignal;
+}
+export interface CatalogRefreshResult {
+    readonly aborted: boolean;
+    /** Per-provider refresh errors, keyed by provider id. */
+    readonly errors: ReadonlyMap<string, string>;
+}
+export interface ModelCatalogFacade {
+    /** Every provider that has models, with its usable-auth status. */
+    providers(): readonly CatalogProvider[];
+    /** Every model, optionally narrowed to one provider. */
+    models(providerId?: string): readonly CatalogModel[];
+    /** The id of the recommended default model for a provider, if any. */
+    defaultModel(providerId: string): string | undefined;
+    /** Reload provider catalogs (remote overlay is cached with ETag/Last-Modified). */
+    refresh(options?: CatalogRefreshOptions): Promise<CatalogRefreshResult>;
+}
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/contracts/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../src/contracts/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,wDAAwD;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,SAAS,IAAI,SAAS,eAAe,EAAE,CAAC;IACxC,wDAAwD;IACxD,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;IACrD,sEAAsE;IACtE,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrD,mFAAmF;IACnF,OAAO,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACzE"}

package/dist/contracts/model-catalog.js

@@ -0,0 +1,9 @@
+/**
+ * Provider-independent model catalog facade — the other half of the provider
+ * plane (see {@link ./provider-auth.js}). It lists providers and their models
+ * with capabilities and refreshes the remote catalog, but is credential-blind:
+ * it reads auth status only to report which providers are usable, never logs
+ * in. The built-in implementation wraps Pi's `ModelRegistry`.
+ */
+export {};
+//# sourceMappingURL=model-catalog.js.map

package/dist/contracts/model-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.js","sourceRoot":"","sources":["../../src/contracts/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/contracts/provider-auth.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Provider-independent authentication facade. Unlike a {@link Runtime} facet,
+ * this describes the *provider* plane — the accounts and credentials a runtime
+ * consumes (Anthropic, xAI, Moonshot, …) — which is orthogonal to which harness
+ * runs them. Implementations wrap a credential/model backend (the built-in one
+ * wraps Pi's `ModelRuntime`) without leaking its types.
+ */
+/** The two login methods a provider may accept. */
+export type ProviderLoginMethod = "oauth" | "api_key";
+/** A non-secret snapshot of one provider's stored auth. */
+export interface ProviderAuthStatus {
+    readonly providerId: string;
+    /** Whether any usable credential is configured for this provider. */
+    readonly configured: boolean;
+    /** How the configured credential authenticates; omitted when not configured. */
+    readonly method?: ProviderLoginMethod;
+    /** Human-readable source label, e.g. `"OAuth"` or `"ANTHROPIC_API_KEY"`. */
+    readonly label?: string;
+    /** True when the credential is a subscription OAuth login rather than a metered key. */
+    readonly subscription?: boolean;
+}
+/** An event surfaced while a login flow runs. */
+export type ProviderLoginEvent = {
+    readonly kind: "auth_url";
+    readonly url: string;
+    readonly instructions?: string;
+} | {
+    readonly kind: "device_code";
+    readonly userCode: string;
+    readonly verificationUri: string;
+    readonly intervalSeconds?: number;
+    readonly expiresInSeconds?: number;
+} | {
+    readonly kind: "info";
+    readonly message: string;
+};
+/** A prompt the login flow needs the caller to answer. */
+export type ProviderLoginPrompt = {
+    readonly kind: "text" | "secret" | "manual_code";
+    readonly message: string;
+    readonly placeholder?: string;
+} | {
+    readonly kind: "select";
+    readonly message: string;
+    readonly options: readonly {
+        readonly id: string;
+        readonly label: string;
+        readonly description?: string;
+    }[];
+};
+/**
+ * Caller-supplied login interaction: observe flow events (the OAuth URL or
+ * device code lands here) and answer prompts. This is the provider-independent
+ * mirror of the backend's own interaction callback.
+ */
+export interface ProviderLoginInteraction {
+    readonly signal?: AbortSignal;
+    onEvent(event: ProviderLoginEvent): void;
+    prompt(prompt: ProviderLoginPrompt): Promise<string>;
+}
+/**
+ * List, inspect, and mutate provider credentials. Reading never resolves or
+ * returns secret values; `login`/`setApiKey`/`logout` are the only writes.
+ */
+export interface ProviderAuthFacade {
+    /** Every provider that has a configured credential, with its non-secret status. */
+    listProviders(): Promise<readonly ProviderAuthStatus[]>;
+    /** The status of one provider (`configured: false` when nothing is stored). */
+    status(providerId: string): Promise<ProviderAuthStatus>;
+    /** Run the provider's OAuth or API-key login flow and persist the result. */
+    login(providerId: string, method: ProviderLoginMethod, interaction: ProviderLoginInteraction): Promise<ProviderAuthStatus>;
+    /** Store an API key for a provider without an interactive flow. */
+    setApiKey(providerId: string, apiKey: string): Promise<void>;
+    /** Clear a provider's stored credential. */
+    logout(providerId: string): Promise<void>;
+}
+//# sourceMappingURL=provider-auth.d.ts.map

package/dist/contracts/provider-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-auth.d.ts","sourceRoot":"","sources":["../../src/contracts/provider-auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mDAAmD;AACnD,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtD,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACnF;IACE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,0DAA0D;AAC1D,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7G,CAAC;AAEN;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,aAAa,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;IACxD,+EAA+E;IAC/E,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxD,6EAA6E;IAC7E,KAAK,CACH,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,mBAAmB,EAC3B,WAAW,EAAE,wBAAwB,GACpC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,mEAAmE;IACnE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,4CAA4C;IAC5C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/contracts/provider-auth.js

@@ -0,0 +1,9 @@
+/**
+ * Provider-independent authentication facade. Unlike a {@link Runtime} facet,
+ * this describes the *provider* plane — the accounts and credentials a runtime
+ * consumes (Anthropic, xAI, Moonshot, …) — which is orthogonal to which harness
+ * runs them. Implementations wrap a credential/model backend (the built-in one
+ * wraps Pi's `ModelRuntime`) without leaking its types.
+ */
+export {};
+//# sourceMappingURL=provider-auth.js.map

package/dist/contracts/provider-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-auth.js","sourceRoot":"","sources":["../../src/contracts/provider-auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { RuntimeRegistry } from "./registry.js";
 export type { AccountUsageReader, AccountUsageReadOptions, AccountUsageSnapshot, AccountUsageWindow, UtcInstant, } from "./contracts/account-usage.js";
 export type { AvailableInstallation, BundledInstallation, ExecutableInstallation, InstallationProbe, InstallationSnapshot, } from "./contracts/installation.js";
+export type { ProviderAuthFacade, ProviderAuthStatus, ProviderLoginEvent, ProviderLoginInteraction, ProviderLoginMethod, ProviderLoginPrompt, } from "./contracts/provider-auth.js";
+export type { CatalogModel, CatalogProvider, CatalogRefreshOptions, CatalogRefreshResult, ModelCatalogFacade, } from "./contracts/model-catalog.js";
 export type { Runtime } from "./contracts/runtime.js";
 export type { AdapterSession, PromptResult, ReasoningContent, Session, SessionEvent, SessionEventBody, SessionEventEnvelope, SessionObserver, SessionOptions, StartSession, SteerOrQueueResult, SteerResult, Turn, TurnOutcome, TurnQueue, Unsubscribe, } from "./contracts/session.js";
 export { defineRuntime } from "./contracts/runtime.js";
@@ -21,6 +23,16 @@ export { claudeInstallation } from "./runtimes/claude/installation.js";
 export { codexRuntime } from "./runtimes/codex/index.js";
 export { codexSession } from "./runtimes/codex/session.js";
 export { codexInstallation } from "./runtimes/codex/installation.js";
+export { createPiProviderAuth } from "./runtimes/pi/auth.js";
+export type { PiProviderAuthOptions } from "./runtimes/pi/auth.js";
+export { createPiModelCatalog } from "./runtimes/pi/catalog.js";
+export type { PiModelCatalogOptions } from "./runtimes/pi/catalog.js";
+export { grokRuntime } from "./runtimes/grok/index.js";
+export { grokSession } from "./runtimes/grok/session.js";
+export { grokInstallation } from "./runtimes/grok/installation.js";
+export { kimiRuntime } from "./runtimes/kimi/index.js";
+export { kimiSession } from "./runtimes/kimi/session.js";
+export { kimiInstallation } from "./runtimes/kimi/installation.js";
 export { piRuntime } from "./runtimes/pi/index.js";
 export { piSession } from "./runtimes/pi/session.js";
 export { piInstallation } from "./runtimes/pi/installation.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKhD,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,GACX,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,IAAI,EACJ,WAAW,EACX,SAAS,EACT,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,OAAO,GACR,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC3E,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,eAAO,MAAM,QAAQ,iBAAgE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,8 @@
 import { RuntimeRegistry } from "./registry.js";
 import { claudeRuntime } from "./runtimes/claude/index.js";
 import { codexRuntime } from "./runtimes/codex/index.js";
+import { grokRuntime } from "./runtimes/grok/index.js";
+import { kimiRuntime } from "./runtimes/kimi/index.js";
 import { piRuntime } from "./runtimes/pi/index.js";
 export { defineRuntime } from "./contracts/runtime.js";
 export { utcInstantFromDate } from "./shared/instant.js";
@@ -16,8 +18,22 @@ export { claudeInstallation } from "./runtimes/claude/installation.js";
 export { codexRuntime } from "./runtimes/codex/index.js";
 export { codexSession } from "./runtimes/codex/session.js";
 export { codexInstallation } from "./runtimes/codex/installation.js";
+export { createPiProviderAuth } from "./runtimes/pi/auth.js";
+export { createPiModelCatalog } from "./runtimes/pi/catalog.js";
+export { grokRuntime } from "./runtimes/grok/index.js";
+export { grokSession } from "./runtimes/grok/session.js";
+export { grokInstallation } from "./runtimes/grok/installation.js";
+export { kimiRuntime } from "./runtimes/kimi/index.js";
+export { kimiSession } from "./runtimes/kimi/session.js";
+export { kimiInstallation } from "./runtimes/kimi/installation.js";
 export { piRuntime } from "./runtimes/pi/index.js";
 export { piSession } from "./runtimes/pi/session.js";
 export { piInstallation } from "./runtimes/pi/installation.js";
-export const runtimes = new RuntimeRegistry([claudeRuntime, codexRuntime, piRuntime]);
+export const runtimes = new RuntimeRegistry([
+    claudeRuntime,
+    codexRuntime,
+    grokRuntime,
+    kimiRuntime,
+    piRuntime,
+]);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAmCnD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,OAAO,GACR,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAkDnD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,OAAO,GACR,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;IAC1C,aAAa;IACb,YAAY;IACZ,WAAW;IACX,WAAW;IACX,SAAS;CACV,CAAC,CAAC"}

package/dist/runtimes/claude/account-usage.d.ts

@@ -1,29 +1,31 @@
 import type { AccountUsageReader, AccountUsageSnapshot } from "../../contracts/account-usage.js";
-export declare function projectClaudeUsage(content: string, referenceInstant?: Date, email?: string): AccountUsageSnapshot;
 /**
- * `claude -p /usage --output-format json` has two observed shapes.
- * Without login, `result` is only an invocation summary:
+ * Project the `/api/oauth/usage` payload. The authoritative shape is its
+ * `limits` array; a representative (subscription) response is:
  *
  * ```json
  * {
- *   "type": "result",
- *   "total_cost_usd": 0,
- *   "usage": { "input_tokens": 0, "output_tokens": 0 },
- *   "result": "Total cost: $0.0000\nUsage: 0 input, 0 output, 0 cache read, 0 cache write"
+ *   "limits": [
+ *     { "kind": "session", "group": "session", "percent": 17, "severity": "normal",
+ *       "resets_at": "2026-08-26T13:49:59.725522+00:00", "scope": null, "is_active": false },
+ *     { "kind": "weekly_all", "group": "weekly", "percent": 72, "severity": "normal",
+ *       "resets_at": "2026-08-28T06:59:59.725547+00:00", "scope": null, "is_active": false },
+ *     { "kind": "weekly_scoped", "group": "weekly", "percent": 100, "severity": "critical",
+ *       "resets_at": "2026-08-28T06:59:59.725963+00:00",
+ *       "scope": { "model": { "display_name": "Fable" } }, "is_active": true }
+ *   ]
  * }
  * ```
- *
- * With a subscription login, `result` contains account usage windows:
- *
- * ```json
- * {
- *   "type": "result",
- *   "result": "You are currently using your subscription to power your Claude Code usage\n\nCurrent session: 7% used · resets Aug 21 at 7:39pm (Asia/Shanghai)\nCurrent week (all models): 0% used · resets Aug 28 at 2:59pm (Asia/Shanghai)\nCurrent week (Fable): 0% used"
- * }
- * ```
- *
- * Reset text has no year, so it is interpreted as the next occurrence in its
- * named IANA time zone relative to when the command result is projected.
+ */
+export declare function projectClaudeUsage(payload: unknown, email?: string, plan?: string): AccountUsageSnapshot;
+/** Extract Claude Code's explicit subscription tier from a confirmed login. */
+export declare function claudeAccountPlan(payload: unknown): string | undefined;
+/**
+ * Reads Claude account usage in two steps: `claude auth status --json` for the
+ * login gate and account email, then a single read-only request to Anthropic's
+ * structured usage endpoint using the persisted `/login` OAuth token. This
+ * replaces the older `claude -p /usage` subprocess, which was slower and only
+ * returned pre-rendered text.
  */
 export declare const claudeAccountUsage: AccountUsageReader;
 //# sourceMappingURL=account-usage.d.ts.map

package/dist/runtimes/claude/account-usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account-usage.d.ts","sourceRoot":"","sources":["../../../src/runtimes/claude/account-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kCAAkC,CAAC;AAgG1C,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,gBAAgB,GAAE,IAAiB,EACnC,KAAK,CAAC,EAAE,MAAM,GACb,oBAAoB,CA8BtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBA8ChC,CAAC"}
+{"version":3,"file":"account-usage.d.ts","sourceRoot":"","sources":["../../../src/runtimes/claude/account-usage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kCAAkC,CAAC;AAqG1C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,oBAAoB,CA8BtB;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOtE;AAaD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBA2ChC,CAAC"}