@oh-my-pi/pi-ai 18.2.7 → 18.2.9

package/dist/types/usage.d.ts

@@ -62,11 +62,29 @@ export interface UsageLimit {
  * Per-credit detail for a saved/banked rate-limit reset.
  *
  * Populated when the provider's listing endpoint returns individual credit
- * metadata (e.g. OpenAI Codex `wham/rate-limit-reset-credits`). Callers that
+ * metadata (e.g. OpenAI Codex credits or Claude Cedar grants). Callers that
  * only need the count can ignore this; display layers use `expiresAt` to show
  * when banked resets expire ([#3339](https://github.com/can1357/oh-my-pi/issues/3339)).
  */
 export interface UsageResetCreditDetail {
+    /** Opaque provider credit/grant identifier. */
+    id?: string;
+    /** Human-facing name for the reset. */
+    title?: string;
+    /** Provider reset program/family. */
+    program?: string;
+    /** Resets still banked in this credit/grant. */
+    remainingCount?: number;
+    /** Whether the provider says this credit can be redeemed now. */
+    usable?: boolean;
+    /** Whether redemption requires an exhausted covered limit. */
+    requiresLimit?: boolean;
+    /** Normalized {@link UsageLimit.id}s this credit resets. */
+    clears?: string[];
+    /** Normalized limit ids currently preventing redemption. */
+    blocking?: string[];
+    /** Used fractions for covered limits, keyed by normalized limit id. */
+    usedFractions?: Record<string, number>;
     /** ISO timestamp when the credit was granted. */
     grantedAt?: string;
     /** ISO timestamp when the credit expires and can no longer be redeemed. */
@@ -74,17 +92,31 @@ export interface UsageResetCreditDetail {
     /** Backend status, e.g. `available`, `redeemed`. */
     status?: string;
 }
+/** Reset credit carrying the provider id required by its consume endpoint. */
+export interface UsageResetCredit extends UsageResetCreditDetail {
+    id: string;
+}
 /**
  * Saved/banked rate-limit resets an account can redeem on demand.
  *
  * Surfaced by providers that let users defer a usage-window reset and spend it
- * later (OpenAI Codex "saved rate limit resets"). The redeem itself is a
- * separate, provider-specific action; this is the read-only count for display.
+ * later (OpenAI Codex and Claude Cedar resets). The redeem itself is a
+ * separate, provider-specific action; this is the read-only state for display.
  */
 export interface UsageResetCredits {
-    /** Number of resets available to redeem right now. */
+    /** Number of banked resets, including grants that are not currently usable. */
     availableCount: number;
-    /** Individual credit details (expiry dates, etc.) when the provider exposes them. */
+    /** Number of resets the provider says can be redeemed now. */
+    redeemableCount?: number;
+    /** Provider-selected credit/grant eligible for the next redemption. */
+    nextCreditId?: string;
+    /** Whether this account is eligible for the reset program. */
+    eligible?: boolean;
+    /** Provider reason the program or its credits are unavailable. */
+    reason?: string;
+    /** ISO timestamp until which redemption is cooling down. */
+    cooldownUntil?: string;
+    /** Individual credit details (expiry dates, coverage, etc.) when exposed. */
     credits?: UsageResetCreditDetail[];
 }
 /** Aggregated usage report for a provider. */
@@ -321,28 +353,74 @@ export declare const usageLimitSchema: import("@oh-my-pi/omptype").FluentType<{
     } | undefined;
 }>;
 export declare const usageResetCreditDetailSchema: import("@oh-my-pi/omptype").FluentType<{
+    blocking?: string[] | undefined;
+    clears?: string[] | undefined;
     expiresAt?: string | undefined;
     grantedAt?: string | undefined;
+    id?: string | undefined;
+    program?: string | undefined;
+    remainingCount?: number | undefined;
+    requiresLimit?: boolean | undefined;
     status?: string | undefined;
+    title?: string | undefined;
+    usable?: boolean | undefined;
+    usedFractions?: Record<string, number> | undefined;
 }, {
+    blocking?: string[] | undefined;
+    clears?: string[] | undefined;
     expiresAt?: string | undefined;
     grantedAt?: string | undefined;
+    id?: string | undefined;
+    program?: string | undefined;
+    remainingCount?: number | undefined;
+    requiresLimit?: boolean | undefined;
     status?: string | undefined;
+    title?: string | undefined;
+    usable?: boolean | undefined;
+    usedFractions?: Record<string, number> | undefined;
 }>;
 export declare const usageResetCreditsSchema: import("@oh-my-pi/omptype").FluentType<{
     availableCount: number;
+    cooldownUntil?: string | undefined;
     credits?: {
+        blocking?: string[] | undefined;
+        clears?: string[] | undefined;
         expiresAt?: string | undefined;
         grantedAt?: string | undefined;
+        id?: string | undefined;
+        program?: string | undefined;
+        remainingCount?: number | undefined;
+        requiresLimit?: boolean | undefined;
         status?: string | undefined;
+        title?: string | undefined;
+        usable?: boolean | undefined;
+        usedFractions?: Record<string, number> | undefined;
     }[] | undefined;
+    eligible?: boolean | undefined;
+    nextCreditId?: string | undefined;
+    reason?: string | undefined;
+    redeemableCount?: number | undefined;
 }, {
     availableCount: number;
+    cooldownUntil?: string | undefined;
     credits?: {
+        blocking?: string[] | undefined;
+        clears?: string[] | undefined;
         expiresAt?: string | undefined;
         grantedAt?: string | undefined;
+        id?: string | undefined;
+        program?: string | undefined;
+        remainingCount?: number | undefined;
+        requiresLimit?: boolean | undefined;
         status?: string | undefined;
+        title?: string | undefined;
+        usable?: boolean | undefined;
+        usedFractions?: Record<string, number> | undefined;
     }[] | undefined;
+    eligible?: boolean | undefined;
+    nextCreditId?: string | undefined;
+    reason?: string | undefined;
+    redeemableCount?: number | undefined;
 }>;
 export declare const usageReportSchema: import("@oh-my-pi/omptype").FluentType<{
     fetchedAt: number;
@@ -384,11 +462,25 @@ export declare const usageReportSchema: import("@oh-my-pi/omptype").FluentType<{
     raw?: unknown;
     resetCredits?: {
         availableCount: number;
+        cooldownUntil?: string | undefined;
         credits?: {
+            blocking?: string[] | undefined;
+            clears?: string[] | undefined;
             expiresAt?: string | undefined;
             grantedAt?: string | undefined;
+            id?: string | undefined;
+            program?: string | undefined;
+            remainingCount?: number | undefined;
+            requiresLimit?: boolean | undefined;
             status?: string | undefined;
+            title?: string | undefined;
+            usable?: boolean | undefined;
+            usedFractions?: Record<string, number> | undefined;
         }[] | undefined;
+        eligible?: boolean | undefined;
+        nextCreditId?: string | undefined;
+        reason?: string | undefined;
+        redeemableCount?: number | undefined;
     } | undefined;
 }, {
     fetchedAt: number;
@@ -430,11 +522,25 @@ export declare const usageReportSchema: import("@oh-my-pi/omptype").FluentType<{
     raw?: unknown;
     resetCredits?: {
         availableCount: number;
+        cooldownUntil?: string | undefined;
         credits?: {
+            blocking?: string[] | undefined;
+            clears?: string[] | undefined;
             expiresAt?: string | undefined;
             grantedAt?: string | undefined;
+            id?: string | undefined;
+            program?: string | undefined;
+            remainingCount?: number | undefined;
+            requiresLimit?: boolean | undefined;
             status?: string | undefined;
+            title?: string | undefined;
+            usable?: boolean | undefined;
+            usedFractions?: Record<string, number> | undefined;
         }[] | undefined;
+        eligible?: boolean | undefined;
+        nextCreditId?: string | undefined;
+        reason?: string | undefined;
+        redeemableCount?: number | undefined;
     } | undefined;
 }>;
 /** Optional logger for usage fetchers. */

package/dist/types/utils/schema/json-schema-validator.d.ts

@@ -16,7 +16,10 @@ export interface JsonSchemaValidationResult {
     success: boolean;
     issues: JsonSchemaValidationIssue[];
 }
+/** The unique discriminator-selected branch, or undefined when selection is ambiguous or absent. */
+export declare function getTagSelectedUnionBranch(branches: readonly unknown[], value: unknown): unknown;
 /** Whether any same-instance schema declaration or constraint owns this property name. */
 export declare function schemaDefinesProperty(schema: unknown, key: string): boolean;
-export declare function validateJsonSchemaValue(schema: unknown, value: unknown): JsonSchemaValidationResult;
-export declare function isJsonSchemaValueValid(schema: unknown, value: unknown): boolean;
+export declare function validateJsonSchemaValue(schema: unknown, value: unknown, root?: unknown): JsonSchemaValidationResult;
+/** Validate a subschema using its complete schema's local-reference context. */
+export declare function isJsonSchemaValueValid(schema: unknown, value: unknown, root?: unknown): boolean;

package/dist/types/utils/tool-call-loop-guard.d.ts

@@ -21,6 +21,6 @@ export interface RepeatedToolCallDetection {
 export declare class ToolCallLoopGuard {
     #private;
     constructor(options: ToolCallLoopGuardOptions);
-    /** Records one completed turn and returns the threshold hit, if any. */
+    /** Records one completed turn and reports repetitions at or beyond the threshold. */
     recordTurn(turn: ToolCallLoopTurn): RepeatedToolCallDetection | null;
 }

package/dist/types/video/index.d.ts

@@ -0,0 +1,11 @@
+import type { Api, Model } from "@oh-my-pi/pi-catalog/types";
+import { type VideoOptions } from "./openrouter-video.js";
+import type { VideoContent, VideoGenerationRequest, VideoJob } from "./types.js";
+export * from "./openrouter-video.js";
+export * from "./types.js";
+/** Submit an asynchronous video generation job through the model's transport. */
+export declare function submitVideo(model: Model<Api>, request: VideoGenerationRequest, options: VideoOptions): Promise<VideoJob>;
+/** Poll an asynchronous video generation job through the model's transport. */
+export declare function pollVideo(model: Model<Api>, jobId: string, options: VideoOptions): Promise<VideoJob>;
+/** Stream generated video content through the model's transport. */
+export declare function downloadVideo(model: Model<Api>, jobId: string, options: VideoOptions): Promise<VideoContent>;

package/dist/types/video/openrouter-video.d.ts

@@ -0,0 +1,19 @@
+import type { Api, FetchImpl, Model } from "@oh-my-pi/pi-catalog/types";
+import { type ApiKey } from "../auth-retry.js";
+import * as AIError from "../error/index.js";
+import type { VideoContent, VideoGenerationRequest, VideoJob } from "./types.js";
+export interface VideoOptions {
+    apiKey: ApiKey;
+    fetch?: FetchImpl;
+    signal?: AbortSignal;
+}
+/** Non-2xx response from an OpenRouter video endpoint. */
+export declare class VideoApiError extends AIError.ProviderHttpError {
+    readonly name = "VideoApiError";
+}
+/** Submit an asynchronous OpenRouter video generation job. */
+export declare function submitOpenRouterVideo(model: Model<Api>, request: VideoGenerationRequest, options: VideoOptions): Promise<VideoJob>;
+/** Poll an asynchronous OpenRouter video generation job. */
+export declare function pollOpenRouterVideo(model: Model<Api>, jobId: string, options: VideoOptions): Promise<VideoJob>;
+/** Stream generated video bytes from OpenRouter without buffering them in memory. */
+export declare function downloadOpenRouterVideo(model: Model<Api>, jobId: string, options: VideoOptions): Promise<VideoContent>;

package/dist/types/video/types.d.ts

@@ -0,0 +1,62 @@
+import type { Usage } from "@oh-my-pi/pi-catalog/types";
+export type VideoResolution = "360p" | "480p" | "720p" | "768p" | "1080p" | "1K" | "2K" | "4K";
+export type VideoAspectRatio = "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "3:2" | "2:3" | "21:9" | "9:21";
+export interface VideoImageReference {
+    type: "image_url";
+    imageUrl: {
+        url: string;
+    };
+}
+export interface VideoFrameImage extends VideoImageReference {
+    frameType: "first_frame" | "last_frame";
+}
+export interface VideoAudioReference {
+    type: "audio_url";
+    audioUrl: {
+        url: string;
+    };
+}
+export interface VideoVideoReference {
+    type: "video_url";
+    videoUrl: {
+        url: string;
+    };
+}
+export type VideoInputReference = VideoImageReference | VideoAudioReference | VideoVideoReference;
+/** Canonical camel-case form of OpenRouter's asynchronous video submit request. */
+export interface VideoGenerationRequest {
+    prompt?: string;
+    duration?: number;
+    resolution?: VideoResolution;
+    aspectRatio?: VideoAspectRatio;
+    size?: string;
+    frameImages?: VideoFrameImage[];
+    inputReferences?: VideoInputReference[];
+    generateAudio?: boolean;
+    seed?: number;
+    callbackUrl?: string;
+    provider?: {
+        options?: Record<string, unknown>;
+    };
+    previousJobId?: string;
+    sessionId?: string;
+    trace?: Record<string, unknown>;
+    user?: string;
+    creativity?: number;
+    upscaleFactor?: number;
+}
+export type VideoJobStatus = "queued" | "processing" | "pending" | "in_progress" | "completed" | "failed" | "cancelled" | "expired";
+export interface VideoJob {
+    id: string;
+    status: VideoJobStatus;
+    pollingUrl?: string;
+    generationId?: string;
+    contentUrls?: string[];
+    error?: string;
+    usage?: Usage;
+}
+export interface VideoContent {
+    body: ReadableStream<Uint8Array>;
+    contentType: string;
+    contentLength?: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-ai",
-	"version": "18.2.7",
+	"version": "18.2.9",
 	"description": "Unified LLM API with automatic model discovery and provider configuration",
 	"keywords": [
 		"ai",
@@ -45,10 +45,34 @@
 			"types": "./dist/types/error/index.d.ts",
 			"import": "./src/error/index.ts"
 		},
+		"./embeddings": {
+			"types": "./dist/types/embeddings/index.d.ts",
+			"import": "./src/embeddings/index.ts"
+		},
 		"./judgment": {
 			"types": "./dist/types/judgment/index.d.ts",
 			"import": "./src/judgment/index.ts"
 		},
+		"./rerank": {
+			"types": "./dist/types/rerank/index.d.ts",
+			"import": "./src/rerank/index.ts"
+		},
+		"./speech": {
+			"types": "./dist/types/speech/index.d.ts",
+			"import": "./src/speech/index.ts"
+		},
+		"./images": {
+			"types": "./dist/types/images/index.d.ts",
+			"import": "./src/images/index.ts"
+		},
+		"./transcription": {
+			"types": "./dist/types/transcription/index.d.ts",
+			"import": "./src/transcription/index.ts"
+		},
+		"./video": {
+			"types": "./dist/types/video/index.d.ts",
+			"import": "./src/video/index.ts"
+		},
 		"./*": {
 			"types": "./dist/types/*.d.ts",
 			"import": "./src/*.ts"
@@ -128,11 +152,11 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.2.7",
-		"@oh-my-pi/pi-catalog": "18.2.7",
-		"@oh-my-pi/pi-natives": "18.2.7",
-		"@oh-my-pi/pi-utils": "18.2.7",
-		"@oh-my-pi/pi-wire": "18.2.7"
+		"@oh-my-pi/omptype": "18.2.9",
+		"@oh-my-pi/pi-catalog": "18.2.9",
+		"@oh-my-pi/pi-natives": "18.2.9",
+		"@oh-my-pi/pi-utils": "18.2.9",
+		"@oh-my-pi/pi-wire": "18.2.9"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14"

package/src/auth/sqlite-credential-store.ts

@@ -88,7 +88,7 @@ type SerializedCredentialRecord = {
 	identityKey: string | null;
 };
 
-const AUTH_SCHEMA_VERSION = 7;
+const AUTH_SCHEMA_VERSION = 8;
 const SQLITE_NOW_EPOCH = "CAST(strftime('%s','now') AS INTEGER)";
 const LEGACY_CODEX_BLOCK_PROVIDER_KEY = "openai-codex:oauth";
 const LEGACY_CODEX_BLOCK_SCOPE = "shared";
@@ -970,6 +970,9 @@ export class SqliteAuthCredentialStore implements AuthCredentialStore {
 		if (fromVersion < 7) {
 			this.#migrateAuthSchemaV6ToV7();
 		}
+		if (fromVersion < 8) {
+			this.#migrateAuthSchemaV7ToV8();
+		}
 	}
 
 	#migrateAuthSchemaV0ToV1(): void {
@@ -1141,6 +1144,46 @@ export class SqliteAuthCredentialStore implements AuthCredentialStore {
 		migrate.immediate();
 	}
 
+	#migrateAuthSchemaV7ToV8(): void {
+		const migrate = this.#db.transaction(() => {
+			// SingularityAPI split into two providers — the pay-as-you-go universal
+			// gateway and the slot-reserved lanes — and keys stored under the
+			// retired shared id belong to one or the other by format: the gateway
+			// issues `sk-sapi-...` while the lanes issue plain `sk-...` (both
+			// observed live 2026-09-22), and neither key is accepted by the other
+			// host. Route each stored credential to the product that serves it
+			// instead of orphaning it under an id nothing reads anymore.
+			const select = this.#db.prepare(
+				"SELECT id, credential_type, data FROM auth_credentials WHERE provider = 'singularityapi'",
+			);
+			let rows: Array<{ id: number; credential_type: string; data: string }>;
+			try {
+				rows = select.all() as Array<{ id: number; credential_type: string; data: string }>;
+			} finally {
+				select.finalize();
+			}
+			for (const row of rows) {
+				let provider = "singularityapi-tech";
+				try {
+					const parsed = JSON.parse(row.data) as { key?: unknown };
+					if (typeof parsed.key === "string" && parsed.key.startsWith("sk-sapi-")) {
+						provider = "singularityapi-dev";
+					}
+				} catch {
+					// Unparsable payload takes the lane default; whichever product the
+					// key really belongs to then answers 401 and the owner re-logs in.
+				}
+				this.#db.run("UPDATE auth_credentials SET provider = ? WHERE id = ?", [provider, row.id]);
+				this.#db.run(
+					"UPDATE auth_credential_blocks SET provider_key = ? WHERE credential_id = ? AND provider_key = ?",
+					[`${provider}:${row.credential_type}`, row.id, `singularityapi:${row.credential_type}`],
+				);
+			}
+			this.#writeAuthSchemaVersion(8);
+		});
+		migrate.immediate();
+	}
+
 	#backfillCredentialIdentityKeys(): void {
 		const selectRowsStmt = this.#db.prepare(
 			"SELECT id, provider, credential_type, data, disabled_cause, identity_key FROM auth_credentials WHERE identity_key IS NULL ORDER BY id ASC",

package/src/auth-broker/remote-store.ts

@@ -175,8 +175,8 @@ function usageOverlayKey(
 	const accountId = ids.accountId?.trim().toLowerCase();
 	const email = ids.email?.trim().toLowerCase();
 	const projectId = ids.projectId?.trim().toLowerCase();
-	if (accountId) base = `account:${accountId}`;
-	else if (email) base = `email:${email}`;
+	if (email) base = `email:${email}`;
+	else if (accountId) base = `account:${accountId}`;
 	else if (projectId) base = `project:${projectId}`;
 	const orgId = ids.orgId?.trim().toLowerCase();
 	if (orgId) return base ? `${provider}\0org:${orgId}|${base}` : `${provider}\0org:${orgId}`;
@@ -1556,6 +1556,10 @@ function reportMatchesIdentity(
 	projectId: string | undefined,
 ): boolean {
 	const metadata = (report.metadata ?? {}) as Record<string, unknown>;
+	const metaEmail = readMetadataString(metadata, "email")?.toLowerCase();
+	// Email identifies the member within shared Team workspace account/org ids.
+	// When both sides provide it, a mismatch is decisive.
+	if (email && metaEmail) return metaEmail === email;
 	if (accountId) {
 		const metaAccount = readMetadataString(metadata, "accountId") ?? readMetadataString(metadata, "account_id");
 		if (metaAccount && metaAccount.toLowerCase() === accountId) return true;
@@ -1563,10 +1567,6 @@ function reportMatchesIdentity(
 			if (limit.scope.accountId?.toLowerCase() === accountId) return true;
 		}
 	}
-	if (email) {
-		const metaEmail = readMetadataString(metadata, "email");
-		if (metaEmail && metaEmail.toLowerCase() === email) return true;
-	}
 	if (projectId) {
 		const metaProject = readMetadataString(metadata, "projectId") ?? readMetadataString(metadata, "project_id");
 		if (metaProject && metaProject.toLowerCase() === projectId) return true;

package/src/auth-broker/wire-schemas.ts

@@ -235,7 +235,21 @@ const usageLimitSchema = type({
 
 const usageResetCreditsSchema = type({
 	availableCount: "number",
+	"redeemableCount?": "number",
+	"nextCreditId?": "string",
+	"eligible?": "boolean",
+	"reason?": "string",
+	"cooldownUntil?": "string",
 	"credits?": type({
+		"id?": "string",
+		"title?": "string",
+		"program?": "string",
+		"remainingCount?": "number",
+		"usable?": "boolean",
+		"requiresLimit?": "boolean",
+		"clears?": "string[]",
+		"blocking?": "string[]",
+		"usedFractions?": { "[string]": "number" },
 		"grantedAt?": "string",
 		"expiresAt?": "string",
 		"status?": "string",