@xopcai/xopc 0.0.191 → 0.0.193

package/dist/src/gateway/hono/routes/you.js

@@ -1,20 +1,12 @@
 import { listContextConsolidationRuns } from "../../../storage/sqlite/context-consolidation-repository.js";
+import { UNDERSTANDING_KINDS } from "../../../user-context/domain.js";
+import { summarizeUserUnderstandingQuality } from "../../../storage/sqlite/user-context-quality-repository.js";
 import { createCollaborationRule, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextFeedback, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "../../../storage/sqlite/user-context-repository.js";
 import "../../../storage/sqlite/index.js";
+import { canonicalUnderstandingKey, findDuplicateUnderstanding } from "../../../user-context/understanding.js";
 import { userInfo } from "node:os";
-import { createHash } from "node:crypto";
 //#region src/gateway/hono/routes/you.ts
-const UNDERSTANDING_KINDS = new Set([
-	"preference",
-	"boundary",
-	"relationship",
-	"routine",
-	"current_state",
-	"long_term_goal",
-	"project_context",
-	"task_lesson",
-	"derived_insight"
-]);
+const UNDERSTANDING_KIND_SET = new Set(UNDERSTANDING_KINDS);
 const UNDERSTANDING_STATUSES = new Set([
 	"candidate",
 	"active",
@@ -68,13 +60,6 @@ function scopeFrom(value) {
 		id
 	} : void 0;
 }
-function canonicalKey(kind, statement) {
-	const normalized = statement.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
-	return `${kind}:${createHash("sha256").update(normalized).digest("hex").slice(0, 20)}`;
-}
-function sameScope(left, right) {
-	return left.type === right.type && left.id === right.id;
-}
 function validTimezone(value) {
 	if (!value) return true;
 	try {
@@ -103,7 +88,8 @@ function registerYouRoutes(authenticated, deps) {
 		profile: getUserProfile(),
 		understandings: listUnderstandings(),
 		rules: listCollaborationRules(),
-		consolidation: { lastRun: listContextConsolidationRuns(1)[0] ?? null }
+		consolidation: { lastRun: listContextConsolidationRuns(1)[0] ?? null },
+		quality: summarizeUserUnderstandingQuality()
 	}));
 	authenticated.get("/api/you/profile", (c) => {
 		const profile = getUserProfile();
@@ -143,10 +129,15 @@ function registerYouRoutes(authenticated, deps) {
 		const statement = nonEmptyString(body?.statement);
 		const kind = body?.kind;
 		const scope = scopeFrom(body?.scope ?? { type: "global" });
-		if (!statement || !UNDERSTANDING_KINDS.has(kind) || !scope) return c.json({ error: "Valid statement, kind, and scope are required" }, 400);
+		if (!statement || !UNDERSTANDING_KIND_SET.has(kind) || !scope) return c.json({ error: "Valid statement, kind, and scope are required" }, 400);
 		const typedKind = kind;
-		const key = canonicalKey(typedKind, statement);
-		if (listUnderstandings().some((item) => item.canonicalKey === key && sameScope(item.scope, scope) && item.status !== "archived" && item.status !== "rejected")) return c.json({ error: "This understanding already exists" }, 409);
+		const key = canonicalUnderstandingKey(typedKind, statement);
+		if (findDuplicateUnderstanding(listUnderstandings(), {
+			kind: typedKind,
+			statement,
+			canonicalKey: key,
+			scope
+		})) return c.json({ error: "This understanding already exists" }, 409);
 		const understanding = createUnderstanding({
 			kind: typedKind,
 			canonicalKey: key,
@@ -177,8 +168,14 @@ function registerYouRoutes(authenticated, deps) {
 		if (body.statement !== void 0) {
 			const statement = nonEmptyString(body.statement);
 			if (!statement) return c.json({ error: "statement must be 1-2000 characters" }, 400);
-			const key = canonicalKey(understanding.kind, statement);
-			if (listUnderstandings().some((item) => item.id !== id && item.canonicalKey === key && sameScope(item.scope, understanding.scope) && item.status !== "archived" && item.status !== "rejected")) return c.json({ error: "This understanding already exists" }, 409);
+			const key = canonicalUnderstandingKey(understanding.kind, statement);
+			if (findDuplicateUnderstanding(listUnderstandings(), {
+				kind: understanding.kind,
+				statement,
+				canonicalKey: key,
+				scope: understanding.scope,
+				excludeId: id
+			})) return c.json({ error: "This understanding already exists" }, 409);
 			understanding = reviseUnderstanding(id, statement, {
 				canonicalKey: key,
 				explicitness: "explicit",

package/dist/src/gateway/image-generation-setup.d.ts

@@ -3,12 +3,11 @@ import { type Config } from '../config/schema.js';
 export type ImageGenerationSetupInput = {
     providerId: string;
     modelId?: string;
-    region?: 'cn' | 'intl';
-    baseUrl?: string;
+    providerConfig?: Record<string, unknown>;
 };
 export type ImageGenerationCatalogItem = ReturnType<typeof listImageGenerationProvidersSummary>[number] & {
     configured: boolean;
-    requiresRegion: boolean;
+    config: Record<string, string>;
 };
 export declare function getImageGenerationCatalog(config: Config): ImageGenerationCatalogItem[];
 export declare function getAgentImageGenerationConfig(config: Config, agentIdRaw: string): {

package/dist/src/gateway/image-generation-setup.js

@@ -13,10 +13,44 @@ function getImageGenerationCatalog(config) {
 		return {
 			...summary,
 			configured: provider.isConfigured({ cfg: config }),
-			requiresRegion: summary.id === "dashscope" || summary.id === "minimax"
+			config: Object.fromEntries(summary.configFields.flatMap((field) => {
+				const value = config.providers?.[summary.id]?.[field.key];
+				return typeof value === "string" ? [[field.key, value]] : [];
+			}))
 		};
 	});
 }
+function parseProviderConfig(provider, input) {
+	const source = input ?? {};
+	const allowedKeys = new Set(provider.configFields?.map((field) => field.key) ?? []);
+	const unknownKey = Object.keys(source).find((key) => !allowedKeys.has(key));
+	if (unknownKey) return {
+		ok: false,
+		error: `Unknown ${provider.id} config field: ${unknownKey}`
+	};
+	const value = {};
+	for (const field of provider.configFields ?? []) {
+		const raw = source[field.key];
+		const resolved = typeof raw === "string" ? raw.trim() : "";
+		if (!resolved) {
+			if (field.required) return {
+				ok: false,
+				error: `${provider.id} requires ${field.key}`
+			};
+			continue;
+		}
+		if (field.type === "select" && !field.options?.some((option) => option.value === resolved)) return {
+			ok: false,
+			error: `Invalid ${provider.id} ${field.key}: ${resolved}`
+		};
+		if (field.key === "region") value.region = resolved;
+		else value.baseUrl = resolved;
+	}
+	return {
+		ok: true,
+		value
+	};
+}
 function getAgentImageGenerationConfig(config, agentIdRaw) {
 	const agentId = normalizeAgentId(agentIdRaw);
 	if (!config.agents.list.some((entry) => entry.enabled !== false && normalizeAgentId(entry.id) === agentId)) throw new Error(`Agent not found: ${agentId}`);
@@ -42,9 +76,10 @@ function prepareImageGenerationSetup(config, agentIdRaw, input) {
 		ok: false,
 		error: `Unknown ${providerId} image model: ${modelId}`
 	};
-	if ((providerId === "dashscope" || providerId === "minimax") && input.region !== "cn" && input.region !== "intl") return {
+	const parsedProviderConfig = parseProviderConfig(provider, input.providerConfig);
+	if (parsedProviderConfig.ok === false) return {
 		ok: false,
-		error: `${providerId} requires region "cn" or "intl"`
+		error: parsedProviderConfig.error
 	};
 	const next = structuredClone(config);
 	const index = next.agents.list.findIndex((entry) => entry.enabled !== false && normalizeAgentId(entry.id) === agentId);
@@ -52,15 +87,11 @@ function prepareImageGenerationSetup(config, agentIdRaw, input) {
 		ok: false,
 		error: `Agent not found: ${agentId}`
 	};
-	const connection = {
-		...input.region ? { region: input.region } : {},
-		...input.baseUrl?.trim() ? { baseUrl: input.baseUrl.trim() } : {}
-	};
 	next.providers = {
 		...next.providers ?? {},
 		[providerId]: {
 			...next.providers?.[providerId] ?? {},
-			...connection
+			...parsedProviderConfig.value
 		}
 	};
 	const entry = next.agents.list[index];

package/dist/src/gateway/index.js

@@ -3,7 +3,6 @@ import { defaultGatewayBindMode, isContainerEnvironment, resolveGatewayBindHost,
 import { buckets } from "./rate-limit/buckets.js";
 import { isGatewayStrictSecurityEnabled } from "./rate-limit/env-flags.js";
 import "./rate-limit/index.js";
-import { checkPortAvailable, forceFreePortAndWait, listPortListeners, parseLsofOutput } from "./ports.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { resolveGatewayListenHost, resolveGatewayListenPlan } from "./listen.js";
 import { assertGatewayRuntimeConfig } from "./runtime-config.js";
@@ -13,6 +12,7 @@ import { createHonoApp } from "./hono/app.js";
 import { GatewayServer } from "./server.js";
 import { GatewayLockError, acquireGatewayLock } from "./lock.js";
 import { runGatewayLoop } from "./run-loop.js";
+import { checkPortAvailable, forceFreePortAndWait, listPortListeners, parseLsofOutput } from "./ports.js";
 import { apiError, apiOk } from "./protocol.js";
 import "./hono/index.js";
 import { assertSecureGatewayHttpUrl, assertSecureWebSocketUrl, isInsecurePrivateWsAllowed, isSecureWebSocketUrl } from "./ws-security.js";

package/dist/src/gateway/run-loop.js

@@ -1,10 +1,10 @@
 import { loadConfig } from "../config/loader.js";
 import "../config/index.js";
 import { isRestartEnabled } from "../config/commands.flags.js";
-import { consumeGatewayRestartIntentSync, consumeGatewaySigusr1RestartAuthorization, isGatewaySigusr1RestartExternallyAllowed, resetGatewayRestartStateForInProcessRestart, scheduleGatewaySigusr1Restart, setGatewaySigusr1RestartPolicy } from "../infra/restart.js";
 import { runBootstrapMigrationsSync } from "../migrations/runner.js";
 import { restartGatewayProcessWithFreshPid } from "./respawn.js";
 import { acquireGatewayLock } from "./lock.js";
+import { consumeGatewayRestartIntentSync, consumeGatewaySigusr1RestartAuthorization, isGatewaySigusr1RestartExternallyAllowed, resetGatewayRestartStateForInProcessRestart, scheduleGatewaySigusr1Restart, setGatewaySigusr1RestartPolicy } from "../infra/restart.js";
 //#region src/gateway/run-loop.ts
 /**
 * Gateway Run Loop - Core run loop for gateway process management

package/dist/src/gateway/service/marketplace-service.d.ts

@@ -83,7 +83,7 @@ export declare class GatewayMarketplaceService {
     reloadSkills(): void;
     patchSkillEnabled(skillName: string, enabled: boolean): void;
     fetchSkillsCatalog(params: SkillsStoreListParams, provider?: string): Promise<UnifiedMarketplaceListResponse>;
-    fetchSkillsCategories(provider?: string): Promise<{
+    fetchSkillsCategories(provider?: string, locale?: string): Promise<{
         items: MarketplaceCategoryOption[];
     }>;
     fetchSkillsPackageDetail(packageName: string, provider?: string): Promise<UnifiedMarketplacePackageDetail>;

package/dist/src/gateway/service/marketplace-service.js

@@ -112,9 +112,9 @@ var GatewayMarketplaceService = class {
 		const { listMarketplacePackages } = await import("../../agent/skills/skills-marketplace.js");
 		return listMarketplacePackages(this.opts.getConfig(), params, provider);
 	}
-	async fetchSkillsCategories(provider) {
+	async fetchSkillsCategories(provider, locale) {
 		const { listMarketplaceCategories } = await import("../../agent/skills/skills-marketplace.js");
-		return listMarketplaceCategories(this.opts.getConfig(), provider);
+		return listMarketplaceCategories(this.opts.getConfig(), provider, locale);
 	}
 	async fetchSkillsPackageDetail(packageName, provider) {
 		const { getMarketplacePackageDetail } = await import("../../agent/skills/skills-marketplace.js");

package/dist/src/gateway/service/run-gateway-agent.js

@@ -33,6 +33,7 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 	let taskRun;
 	let taskRunStatus = "failed";
 	let taskRunSummary = "Agent run ended unexpectedly";
+	let terminalStatus = "error";
 	let webchatSessionKey;
 	let webchatSessionId;
 	let webchatMetadata;
@@ -107,8 +108,8 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 			yield event;
 		}
 	};
-	yield* emitAndYield(mapper.start());
 	try {
+		yield* emitAndYield(mapper.start());
 		if (channel === "webchat" && webchatSessionKey) {
 			const sessionKey = webchatSessionKey;
 			updateAsyncLogContext({
@@ -139,16 +140,10 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 				const endStatus = mergedSignal.aborted ? "cancelled" : "success";
 				const endSummary = mergedSignal.aborted ? "Interrupted" : "Message processed successfully";
 				taskRunStatus = mergedSignal.aborted ? "cancelled" : "succeeded";
+				terminalStatus = endStatus;
 				taskRunSummary = endSummary;
 				yield* emitAndYield(mapper.end(endStatus, endSummary));
 				completeRealtimeTopic(`run:${runId}`);
-				try {
-					const metaAfter = await sessionIndex.getSessionMetadata(sessionKey);
-					if (metaAfter?.name) emit("session.updated", {
-						key: sessionKey,
-						name: metaAfter.name
-					});
-				} catch {}
 				return {
 					status: mergedSignal.aborted ? "aborted" : "ok",
 					summary: mergedSignal.aborted ? "Interrupted" : "Message processed successfully"
@@ -165,6 +160,7 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 				}, `Agent processing failed: ${em}`);
 				streamError = em;
 				taskRunStatus = "failed";
+				terminalStatus = "error";
 				taskRunSummary = em;
 				const errorContent = formatAgentRunErrorForClient(streamError);
 				yield* emitAndYield(mapper.error(errorContent));
@@ -278,6 +274,23 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 				runId
 			}, `Task run finalization failed: ${errorMessage}`);
 		}
+		if (webchatSessionKey) {
+			const metaAfter = await sessionIndex.getSessionMetadata(webchatSessionKey).catch(() => void 0);
+			if (metaAfter?.name) emit("session.updated", {
+				key: webchatSessionKey,
+				name: metaAfter.name
+			});
+			emit("agent.run.ended", {
+				schemaVersion: 1,
+				runId,
+				sessionKey: webchatSessionKey,
+				status: terminalStatus,
+				completedAtMs: Date.now(),
+				route: `/chat/${encodeURIComponent(webchatSessionKey)}`,
+				source: "webchat",
+				...metaAfter?.name?.trim() ? { sessionTitle: metaAfter.name.trim().slice(0, 100) } : {}
+			});
+		}
 	}
 }
 //#endregion

package/dist/src/gateway/service.js

@@ -66,11 +66,6 @@ import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
-import { scheduleGatewayUpdateCheck } from "../infra/update-startup.js";
-import { LocalAppService } from "../local-apps/service.js";
-import "../local-apps/index.js";
-import { runBootstrapMigrationsSync } from "../migrations/runner.js";
-import { MobileNotificationService } from "../mobile/notification-service.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { reconcileDreamingAutomations } from "./dreaming-automation-reconciler.js";
 import { NotesStore } from "../notes/store.js";
@@ -88,6 +83,10 @@ import { assertGatewayAuthNotKnownWeak } from "./security/known-weak-secrets.js"
 import { assertGatewayRuntimeConfig } from "./runtime-config.js";
 import { auditGatewayConfig } from "./security/audit.js";
 import { ModelCatalogSyncService } from "../providers/model-catalog-sync-service.js";
+import { runBootstrapMigrationsSync } from "../migrations/runner.js";
+import { MobileNotificationService } from "../mobile/notification-service.js";
+import { LocalAppService } from "../local-apps/service.js";
+import "../local-apps/index.js";
 import { createRuntimeBrowserRecipeService } from "../browser/recipes/runtime-service.js";
 import "../browser/recipes/index.js";
 import { mapProductEventToProactive } from "../proactive/events/product-event-bridge.js";
@@ -99,6 +98,7 @@ import { ProactiveTemporalWorker } from "../proactive/temporal/worker.js";
 import { ProactiveInboxService } from "../proactive/inbox/service.js";
 import { ProactiveInboxWorker } from "../proactive/inbox/worker.js";
 import "../proactive/index.js";
+import { scheduleGatewayUpdateCheck } from "../infra/update-startup.js";
 import { resolveChannelConnectDeferSet } from "./resolve-channel-connect-defer.js";
 import { restartGatewayProcessWithFreshPid } from "./respawn.js";
 import { GatewaySessionsApi } from "./service/sessions-api.js";

package/dist/src/infra/gateway-processes.js

@@ -1,5 +1,5 @@
-import { isGatewayArgv, parseProcCmdline } from "./gateway-process-argv.js";
 import { listPortListeners } from "../gateway/ports.js";
+import { isGatewayArgv, parseProcCmdline } from "./gateway-process-argv.js";
 import fs from "node:fs";
 import { spawnSync } from "node:child_process";
 //#region src/infra/gateway-processes.ts

package/dist/src/infra/update-global.js

@@ -1,6 +1,6 @@
+import { applyPathPrepend } from "./path-prepend.js";
 import { resolveExecPathBinPrepend } from "./path-env.js";
 import { readPackageVersion } from "./package-json.js";
-import { applyPathPrepend } from "./path-prepend.js";
 import { createDefaultCommandRunner } from "./run-command.js";
 import path from "node:path";
 import fs from "node:fs";

package/dist/src/infra/update-restart.js

@@ -4,8 +4,8 @@ import { init_paths, resolveConfigPath } from "../config/paths.js";
 import { init_loader, loadConfig } from "../config/loader.js";
 import { isRestartEnabled } from "../config/commands.flags.js";
 import { resolveGatewayService } from "../daemon/service.js";
-import { findVerifiedGatewayListenerPidsOnPortSync, signalVerifiedGatewayPidSync } from "./gateway-processes.js";
 import { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from "./restart.js";
+import { findVerifiedGatewayListenerPidsOnPortSync, signalVerifiedGatewayPidSync } from "./gateway-processes.js";
 import { refreshGatewayServiceAfterUpdate } from "./update-service-refresh.js";
 //#region src/infra/update-restart.ts
 init_loader();

package/dist/src/infra/update-runner.js

@@ -1,11 +1,11 @@
 import { runPostUpdateExtensionSync } from "../extensions/update.js";
+import "./update-channels.js";
+import { compareSemver, resolveNpmChannelTag } from "./update-check.js";
 import { readPackageName, readPackageVersion } from "./package-json.js";
 import { createDefaultCommandRunner, runCommandWithTimeout } from "./run-command.js";
 import { XOPC_PACKAGE_NAME, cleanupGlobalRenameDirs, createGlobalInstallEnv, detectGlobalInstallManagerForRoot, resolveGlobalInstallSpec, resolveGlobalInstallTarget } from "./update-global.js";
 import { runGlobalPackageUpdateSteps } from "./package-update-steps.js";
 import { resolveStableNodePath } from "./stable-node-path.js";
-import "./update-channels.js";
-import { compareSemver, resolveNpmChannelTag } from "./update-check.js";
 import { trimLogTail } from "./update-log.js";
 import { maybeRestartGatewayAfterUpdate } from "./update-restart.js";
 import path from "node:path";

package/dist/src/infra/update-startup.js

@@ -3,9 +3,9 @@ import { init_paths_state, resolveUpdateCheckStatePath } from "../config/paths-s
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
+import { acquireUpdateLock } from "./update-lock.js";
 import { normalizeUpdateChannel } from "./update-channels.js";
 import { compareSemver, detectInstallKind, resolveNpmChannelTag, resolvePackageRoot } from "./update-check.js";
-import { acquireUpdateLock } from "./update-lock.js";
 import { createHash, randomUUID } from "node:crypto";
 import { readFile } from "node:fs/promises";
 //#region src/infra/update-startup.ts

package/dist/src/providers/extension-stream-bridge.js

@@ -3,6 +3,7 @@ import { init_logger } from "../utils/logger.js";
 import "./constants.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";
 import { init_providers } from "./index.js";
+import { stripPromptCacheBoundary } from "../agent/prompt/cache-boundary.js";
 import { createAssistantMessageEventStream, streamSimple } from "@earendil-works/pi-ai/compat";
 //#region src/providers/extension-stream-bridge.ts
 init_plugin_registry();
@@ -80,7 +81,7 @@ function createExtensionAwareStreamFn() {
 		const stream = createAssistantMessageEventStream();
 		const params = {
 			model: model.id,
-			systemPrompt: context.systemPrompt,
+			systemPrompt: context.systemPrompt ? stripPromptCacheBoundary(context.systemPrompt) : void 0,
 			messages: context.messages,
 			tools: context.tools,
 			temperature: options?.temperature,
@@ -200,15 +201,15 @@ function createExtensionAwareStreamFn() {
 								partial.usage = {
 									input: chunk.usage.input,
 									output: chunk.usage.output,
-									cacheRead: 0,
-									cacheWrite: 0,
-									totalTokens: chunk.usage.total ?? chunk.usage.input + chunk.usage.output,
+									cacheRead: chunk.usage.cacheRead ?? 0,
+									cacheWrite: chunk.usage.cacheWrite ?? 0,
+									totalTokens: chunk.usage.total ?? chunk.usage.input + chunk.usage.output + (chunk.usage.cacheRead ?? 0) + (chunk.usage.cacheWrite ?? 0),
 									cost: {
 										input: inputCost,
 										output: outputCost,
-										cacheRead: 0,
-										cacheWrite: 0,
-										total: inputCost + outputCost
+										cacheRead: (chunk.usage.cacheRead ?? 0) / 1e6 * (model.cost?.cacheRead ?? 0),
+										cacheWrite: (chunk.usage.cacheWrite ?? 0) / 1e6 * (model.cost?.cacheWrite ?? 0),
+										total: inputCost + outputCost + (chunk.usage.cacheRead ?? 0) / 1e6 * (model.cost?.cacheRead ?? 0) + (chunk.usage.cacheWrite ?? 0) / 1e6 * (model.cost?.cacheWrite ?? 0)
 									}
 								};
 							}

package/dist/src/providers/model-catalog-store.d.ts

@@ -2,10 +2,10 @@ export interface CatalogModel {
     id: string;
     name: string;
     availability: 'available' | 'unavailable';
-    kind: 'language' | 'image';
-    input: Array<'text' | 'image'>;
-    output: Array<'text' | 'image'>;
-    operations: Array<'chat.completions' | 'responses' | 'images.generate' | 'images.edit'>;
+    kind: 'language' | 'image' | 'stt' | 'tts';
+    input: Array<'text' | 'image' | 'audio'>;
+    output: Array<'text' | 'image' | 'audio'>;
+    operations: Array<'chat.completions' | 'responses' | 'images.generate' | 'images.edit' | 'audio.transcription' | 'audio.speech'>;
     reasoning: boolean;
     contextWindow: number;
     maxOutputTokens: number | null;
@@ -18,6 +18,26 @@ export interface CatalogModel {
         backgrounds: Array<'transparent' | 'opaque' | 'auto'>;
         maxInputImages: number;
     };
+    stt?: {
+        inputFormats: string[];
+        maxBytes: number;
+        maxDurationSeconds: number;
+        languages: string[];
+        languageHint: boolean;
+        prompt: boolean;
+        timestamps: Array<'segment' | 'word'>;
+        diarization: boolean;
+    };
+    tts?: {
+        maxCharacters: number;
+        languages: string[];
+        outputFormats: Array<'mp3' | 'opus' | 'aac' | 'flac' | 'wav' | 'pcm'>;
+        streaming: boolean;
+        speed: boolean;
+        pitch: boolean;
+        instructions: boolean;
+        defaultVoice?: string;
+    };
 }
 export interface CatalogSource {
     providerId: string;

package/dist/src/providers/model-catalog-store.js

@@ -65,6 +65,17 @@ var init_model_catalog_store = __esmMin((() => {
 						qualities: [...model.imageGeneration.qualities],
 						formats: [...model.imageGeneration.formats],
 						backgrounds: [...model.imageGeneration.backgrounds]
+					} } : {},
+					...model.stt ? { stt: {
+						...model.stt,
+						inputFormats: [...model.stt.inputFormats],
+						languages: [...model.stt.languages],
+						timestamps: [...model.stt.timestamps]
+					} } : {},
+					...model.tts ? { tts: {
+						...model.tts,
+						languages: [...model.tts.languages],
+						outputFormats: [...model.tts.outputFormats]
 					} } : {}
 				}))
 			};

package/dist/src/providers/model-registry.js

@@ -243,7 +243,7 @@ var init_model_registry = __esmMin((() => {
 				provider: source.providerId,
 				baseUrl: source.baseUrl,
 				reasoning: model.reasoning,
-				input: model.input,
+				input: model.input.filter((value) => value === "text" || value === "image"),
 				cost: {
 					input: 0,
 					output: 0,

package/dist/src/providers/prompt-cache-payload.d.ts

@@ -0,0 +1,13 @@
+import type { Api, Model, SimpleStreamOptions } from '@earendil-works/pi-ai';
+export declare function transformPromptCachePayload(model: Model<Api>, payload: unknown): unknown;
+export declare function buildPromptCacheKey(model: Model<Api>, context: {
+    systemPrompt?: string;
+    tools?: unknown[];
+}): string;
+export declare function preparePromptCacheContext<T extends {
+    systemPrompt?: string;
+}>(model: Model<Api>, context: T): T;
+export declare function withPromptCachePayloadTransform(model: Model<Api>, context: {
+    systemPrompt?: string;
+    tools?: unknown[];
+}, options: SimpleStreamOptions | undefined): SimpleStreamOptions | undefined;

package/dist/src/providers/prompt-cache-payload.js

@@ -0,0 +1,110 @@
+import { splitPromptCacheBoundary, stripPromptCacheBoundary } from "../agent/prompt/cache-boundary.js";
+import { createHash } from "node:crypto";
+//#region src/providers/prompt-cache-payload.ts
+function asRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function supportsPromptCacheKey(model) {
+	if (model.api === "openai-codex-responses" || model.api === "azure-openai-responses") return true;
+	if (model.api !== "openai-completions" && model.api !== "openai-responses") return false;
+	return model.provider === "openai" || model.baseUrl?.includes("api.openai.com") === true;
+}
+function splitAnthropicSystem(payload) {
+	const record = asRecord(payload);
+	if (!record || !Array.isArray(record.system)) return payload;
+	let changed = false;
+	const system = record.system.flatMap((value) => {
+		const block = asRecord(value);
+		if (!block || typeof block.text !== "string") return [value];
+		const split = splitPromptCacheBoundary(block.text);
+		if (!split) return [value];
+		changed = true;
+		const { text: _text, ...rest } = block;
+		return [{
+			...rest,
+			type: block.type ?? "text",
+			text: split.stablePrefix
+		}, ...split.dynamicSuffix ? [{
+			type: block.type ?? "text",
+			text: split.dynamicSuffix
+		}] : []];
+	});
+	return changed ? {
+		...record,
+		system
+	} : payload;
+}
+function splitBedrockSystem(payload) {
+	const record = asRecord(payload);
+	if (!record || !Array.isArray(record.system)) return payload;
+	let changed = false;
+	const system = [];
+	for (let index = 0; index < record.system.length; index += 1) {
+		const value = record.system[index];
+		const block = asRecord(value);
+		const split = block && typeof block.text === "string" ? splitPromptCacheBoundary(block.text) : void 0;
+		if (!split) {
+			system.push(value);
+			continue;
+		}
+		changed = true;
+		system.push({
+			...block,
+			text: split.stablePrefix
+		});
+		const next = asRecord(record.system[index + 1]);
+		if (next?.cachePoint) {
+			system.push(next);
+			index += 1;
+		}
+		if (split.dynamicSuffix) system.push({ text: split.dynamicSuffix });
+	}
+	return changed ? {
+		...record,
+		system
+	} : payload;
+}
+function transformPromptCachePayload(model, payload) {
+	if (model.api === "anthropic-messages") return splitAnthropicSystem(payload);
+	if (model.api === "bedrock-converse-stream") return splitBedrockSystem(payload);
+	return payload;
+}
+function canonicalJson(value) {
+	if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
+	const record = asRecord(value);
+	if (record) return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`).join(",")}}`;
+	return JSON.stringify(value) ?? "null";
+}
+function buildPromptCacheKey(model, context) {
+	const stablePrompt = context.systemPrompt ? splitPromptCacheBoundary(context.systemPrompt)?.stablePrefix ?? stripPromptCacheBoundary(context.systemPrompt) : "";
+	return `xopc-${createHash("sha256").update(`${model.provider}\0${model.id}\0${stablePrompt}\0${canonicalJson(context.tools ?? [])}`).digest("base64url")}`;
+}
+function preparePromptCacheContext(model, context) {
+	if (model.api === "anthropic-messages" || model.api === "bedrock-converse-stream") return context;
+	if (!context.systemPrompt) return context;
+	return {
+		...context,
+		systemPrompt: stripPromptCacheBoundary(context.systemPrompt)
+	};
+}
+function withPromptCachePayloadTransform(model, context, options) {
+	const explicitBoundary = model.api === "anthropic-messages" || model.api === "bedrock-converse-stream";
+	const openAiCacheKey = supportsPromptCacheKey(model) && options?.cacheRetention !== "none";
+	if (!explicitBoundary && !openAiCacheKey) return options;
+	const upstream = options?.onPayload;
+	const promptCacheKey = openAiCacheKey ? buildPromptCacheKey(model, context) : void 0;
+	return {
+		...options,
+		onPayload: async (payload, payloadModel) => {
+			const upstreamPayload = await upstream?.(payload, payloadModel);
+			const transformed = transformPromptCachePayload(model, upstreamPayload === void 0 ? payload : upstreamPayload);
+			const record = asRecord(transformed);
+			return record && promptCacheKey ? {
+				...record,
+				prompt_cache_key: promptCacheKey
+			} : transformed;
+		}
+	};
+}
+//#endregion
+export { buildPromptCacheKey, preparePromptCacheContext, transformPromptCachePayload, withPromptCachePayloadTransform };

package/dist/src/providers/register-runtime-providers.js

@@ -20,7 +20,7 @@ function registerRuntimeProvider(modelRuntime, source) {
 			id: model.id,
 			name: model.name,
 			reasoning: model.reasoning,
-			input: model.input,
+			input: model.input.filter((value) => value === "text" || value === "image"),
 			cost: {
 				input: 0,
 				output: 0,