@oh-my-pi/pi-coding-agent 15.11.3 → 15.11.6

package/dist/types/cli/usage-cli.d.ts

@@ -7,11 +7,15 @@
  * credentials produced no usage report are listed too, so the output
  * always covers the full credential pool.
  */
-import type { UsageReport } from "@oh-my-pi/pi-ai";
+import { type UsageHistoryEntry, type UsageReport } from "@oh-my-pi/pi-ai";
 export interface UsageCommandArgs {
     json?: boolean;
     provider?: string;
     redact?: boolean;
+    /** Show recorded usage-limit history instead of a live snapshot. */
+    history?: boolean;
+    /** History window in days (with `history`). */
+    days?: number;
 }
 /** Identity slice of a stored credential, for "every account" coverage. */
 export interface UsageAccountIdentity {
@@ -69,4 +73,9 @@ export declare function computeProviderWindowStats(reports: UsageReport[]): Prov
  * each provider section as "no usage data" rows.
  */
 export declare function formatUsageBreakdown(reports: UsageReport[], accounts: UsageAccountIdentity[], nowMs: number, redaction?: Map<string, string>): string;
+/**
+ * Render recorded usage-limit history: per provider, per account, one
+ * peak-per-bucket sparkline per limit window plus latest/peak percentages.
+ */
+export declare function formatUsageHistory(entries: UsageHistoryEntry[], sinceMs: number, nowMs: number, redaction?: Map<string, string>): string;
 export declare function runUsageCommand(cmd: UsageCommandArgs): Promise<void>;

package/dist/types/commands/usage.d.ts

@@ -19,6 +19,15 @@ export default class Usage extends Command {
             description: string;
             default: boolean;
         };
+        history: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+        days: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            char: string;
+            description: string;
+            default: number;
+        };
     };
     static examples: string[];
     run(): Promise<void>;

package/dist/types/config/api-key-resolver.d.ts

@@ -1,4 +1,6 @@
-import type { ApiKeyResolver, AuthStorage } from "@oh-my-pi/pi-ai";
+import type { Api, ApiKeyResolver, AuthStorage, Model } from "@oh-my-pi/pi-ai";
+/** Model slice accepted by the model-form `resolver(model, sessionId)` overload. */
+export type ApiKeyResolverModel = Pick<Model<Api>, "provider" | "baseUrl" | "id">;
 export interface ApiKeyResolverOptions {
     /** Session id for credential stickiness; read at resolve time by the caller. */
     sessionId?: string;
@@ -25,10 +27,14 @@ export interface ApiKeyResolverRegistry {
      * policy: initial → resolve; step (b) → force-refresh same account; step (c)
      * → rotate to a sibling credential, then re-resolve.
      *
-     * The resolver is stateless (safe to reuse across requests). Callers that
-     * need the initial key for a guard can call `resolveApiKeyOnce(resolver)`.
+     * Two call forms: `resolver(provider, options?)` for provider-scoped keys,
+     * and `resolver(model, sessionId?)` which derives `baseUrl`/`modelId` from
+     * the model. The resolver is stateless (safe to reuse across requests).
+     * Callers that need the initial key for a guard can call
+     * `resolveApiKeyOnce(resolver)`.
      */
     resolver(provider: string, options?: ApiKeyResolverOptions): ApiKeyResolver;
+    resolver(model: ApiKeyResolverModel, sessionId?: string): ApiKeyResolver;
 }
 /**
  * Default implementation of {@link ApiKeyResolverRegistry.resolver}.

package/dist/types/config/keybindings.d.ts

@@ -239,7 +239,7 @@ export declare const KEYBINDINGS: {
     };
     readonly "app.clipboard.pasteImage": {
         readonly defaultKeys: KeyId[];
-        readonly description: "Paste image from clipboard";
+        readonly description: "Paste image or text from clipboard";
     };
     readonly "app.clipboard.pasteTextRaw": {
         readonly defaultKeys: ["ctrl+shift+v", "alt+shift+v"];

package/dist/types/config/model-discovery.d.ts

@@ -5,7 +5,7 @@
  * `discoverModelsByProviderType` with a `DiscoveryContext`; built-in provider
  * discovery lives in pi-catalog's provider-models.
  */
-import type { FetchImpl } from "@oh-my-pi/pi-ai";
+import { type ApiKey, type FetchImpl } from "@oh-my-pi/pi-ai";
 import type { Api, Model } from "@oh-my-pi/pi-ai/types";
 import type { ModelSpec } from "@oh-my-pi/pi-catalog/types";
 import type { ProviderDiscovery } from "./models-config-schema";
@@ -28,10 +28,12 @@ export interface DiscoveryContext {
     /** Injected fetch implementation (tests stub this). */
     fetch: FetchImpl;
     /**
-     * Resolve a provider's API key for `Authorization: Bearer …`. Returns
-     * undefined when no key is stored or it is a local/no-auth sentinel.
+     * Resolve a provider's bearer credential for `Authorization: Bearer …`.
+     * Returns undefined when no key is stored or it is a local/no-auth
+     * sentinel; otherwise an {@link ApiKey} whose resolver participates in the
+     * central force-refresh/rotate auth-retry policy on 401/usage-limit.
      */
-    getBearerApiKey(provider: string): Promise<string | undefined>;
+    getBearerApiKeyResolver(provider: string): Promise<ApiKey | undefined>;
 }
 export declare function discoverModelsByProviderType(providerConfig: DiscoveryProviderConfig, ctx: DiscoveryContext): Promise<Model<Api>[]>;
 export declare function discoverOllamaModels(providerConfig: DiscoveryProviderConfig, ctx: DiscoveryContext): Promise<Model<Api>[]>;

package/dist/types/config/model-registry.d.ts

@@ -5,7 +5,7 @@ import type { ApiKeyResolver, FetchImpl } from "@oh-my-pi/pi-ai";
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@oh-my-pi/pi-ai/oauth/types";
 import { type CanonicalModelIndex, type CanonicalModelRecord, type CanonicalModelVariant, type ModelEquivalenceConfig } from "@oh-my-pi/pi-catalog/identity";
 import type { AuthStorage } from "../session/auth-storage";
-import { type ApiKeyResolverOptions } from "./api-key-resolver";
+import { type ApiKeyResolverModel, type ApiKeyResolverOptions } from "./api-key-resolver";
 import type { ConfigError } from "./config-file";
 export type { CanonicalModelIndex, CanonicalModelRecord, CanonicalModelVariant, ModelEquivalenceConfig };
 export declare const kNoAuth = "N/A";
@@ -153,11 +153,14 @@ export declare class ModelRegistry {
         signal?: AbortSignal;
     }): Promise<string | undefined>;
     /**
-     * Build an {@link ApiKeyResolver} for this provider, implementing the
-     * central a/b/c auth-retry policy. Callers that need the initial key for
-     * a guard can call `resolveApiKeyOnce(resolver)`.
+     * Build an {@link ApiKeyResolver} implementing the central a/b/c auth-retry
+     * policy. Accepts a provider id with options, or a model with an optional
+     * session id (`resolver(model, sessionId)`) which derives `baseUrl`/`modelId`
+     * from the model. Callers that need the initial key for a guard can call
+     * `resolveApiKeyOnce(resolver)`.
      */
     resolver(provider: string, options?: ApiKeyResolverOptions): ApiKeyResolver;
+    resolver(model: ApiKeyResolverModel, sessionId?: string): ApiKeyResolver;
     /**
      * Check if a model is using OAuth credentials (subscription).
      */