@xopcai/xopc 0.0.372 → 0.0.374

package/dist/gateway/static/root/index.html

@@ -11,7 +11,7 @@
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=20260910-1" />
     <link rel="manifest" href="/site.webmanifest?v=20260910-1" />
     <title>XOPC — Keep what matters moving.</title>
-    <script type="module" crossorigin src="/assets/index-BWDK2eIj.js"></script>
+    <script type="module" crossorigin src="/assets/index-DEaVabvo.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-aKtaBQYM.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-zJ_50EbN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-BOUWij0V.js">
@@ -25,15 +25,15 @@
     <link rel="modulepreload" crossorigin href="/assets/download-Dk-ZjtO6.js">
     <link rel="modulepreload" crossorigin href="/assets/plus-Q2yW6OE7.js">
     <link rel="modulepreload" crossorigin href="/assets/x-B_N4OPjy.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-Bb2GK-Nj.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-COVscAqC.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-C1SUo4gG.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-rWFLl-p4.js">
     <link rel="modulepreload" crossorigin href="/assets/cn-JdwAhgNB.js">
     <link rel="modulepreload" crossorigin href="/assets/schemas-CObaziC7.js">
     <link rel="modulepreload" crossorigin href="/assets/local-apps-yys1VChX.js">
     <link rel="modulepreload" crossorigin href="/assets/product-delivery-BAks11S4.js">
     <link rel="modulepreload" crossorigin href="/assets/app-link-4gpFbdsr.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-to-clipboard-HOJ79TWv.js">
-    <link rel="modulepreload" crossorigin href="/assets/markdown-view-B_qnAcW2.js">
+    <link rel="modulepreload" crossorigin href="/assets/markdown-view-BHFFusQs.js">
     <link rel="modulepreload" crossorigin href="/assets/check-DUBLcKHA.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-Dv6d4Dvw.js">
     <link rel="modulepreload" crossorigin href="/assets/button-CS04eWY9.js">
@@ -69,29 +69,29 @@
     <link rel="modulepreload" crossorigin href="/assets/rotate-cw-LIg3Am9S.js">
     <link rel="modulepreload" crossorigin href="/assets/search-DA7gz22f.js">
     <link rel="modulepreload" crossorigin href="/assets/index.module-Cd9ENXfk.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-jiV5sbEX.js">
-    <link rel="modulepreload" crossorigin href="/assets/session-api-yjpEz4pP.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-TYSQEQcG.js">
+    <link rel="modulepreload" crossorigin href="/assets/session-api-u_4_kFQt.js">
     <link rel="modulepreload" crossorigin href="/assets/constants-Dy8Gw0sF.js">
     <link rel="modulepreload" crossorigin href="/assets/app-chrome-BeB4KgOf.js">
     <link rel="modulepreload" crossorigin href="/assets/attachment-utils-core-BIOUBrpT.js">
     <link rel="modulepreload" crossorigin href="/assets/files-Bw4SBGdM.js">
-    <link rel="modulepreload" crossorigin href="/assets/workspace-api-CTm8s6Jr.js">
+    <link rel="modulepreload" crossorigin href="/assets/workspace-api-CXiyhTwv.js">
     <link rel="modulepreload" crossorigin href="/assets/electron-env-Dit0bHgy.js">
     <link rel="modulepreload" crossorigin href="/assets/use-async-resource-GrnWNwMZ.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-BQ3PMp2q.js">
-    <link rel="modulepreload" crossorigin href="/assets/use-file-preview-expanded-BF1TeNXP.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-BeYLqqr8.js">
+    <link rel="modulepreload" crossorigin href="/assets/use-file-preview-expanded-Du37Gofn.js">
     <link rel="modulepreload" crossorigin href="/assets/mic-CuUb7zc-.js">
     <link rel="modulepreload" crossorigin href="/assets/globe-DSSGFWFn.js">
-    <link rel="modulepreload" crossorigin href="/assets/share-link-dialog-HCHM8qnf.js">
-    <link rel="modulepreload" crossorigin href="/assets/local-session-drafts-pox8evDV.js">
+    <link rel="modulepreload" crossorigin href="/assets/share-link-dialog-XhiuPKF4.js">
+    <link rel="modulepreload" crossorigin href="/assets/local-session-drafts-Cg9RdsNN.js">
     <link rel="modulepreload" crossorigin href="/assets/tasks-DwKXgZ-I.js">
-    <link rel="modulepreload" crossorigin href="/assets/capabilities-CY4SiHcP.js">
+    <link rel="modulepreload" crossorigin href="/assets/capabilities-CquUV0DP.js">
     <link rel="modulepreload" crossorigin href="/assets/skill-wire-pattern-BPpeIcCi.js">
-    <link rel="modulepreload" crossorigin href="/assets/shares-api-c0dfWz6h.js">
-    <link rel="modulepreload" crossorigin href="/assets/capabilities-gjQtMhKu.js">
-    <link rel="modulepreload" crossorigin href="/assets/use-composer-attachments-OFlldkKg.js">
+    <link rel="modulepreload" crossorigin href="/assets/shares-api-BVSb1vh4.js">
+    <link rel="modulepreload" crossorigin href="/assets/capabilities-D4KFLtqM.js">
+    <link rel="modulepreload" crossorigin href="/assets/use-composer-attachments-Dxphaxk-.js">
     <link rel="modulepreload" crossorigin href="/assets/git-branch-Dh9uxTot.js">
-    <link rel="modulepreload" crossorigin href="/assets/notes-api-sBgBcyLW.js">
+    <link rel="modulepreload" crossorigin href="/assets/notes-api-CSLVCZBn.js">
     <link rel="modulepreload" crossorigin href="/assets/message-square-fVE7Ghj1.js">
     <link rel="modulepreload" crossorigin href="/assets/pause-DuPxgSxk.js">
     <link rel="modulepreload" crossorigin href="/assets/play-kxZvpBg8.js">
@@ -99,18 +99,18 @@
     <link rel="modulepreload" crossorigin href="/assets/settings-2-D-csvaET.js">
     <link rel="modulepreload" crossorigin href="/assets/sparkles-DHlfQFAF.js">
     <link rel="modulepreload" crossorigin href="/assets/middleware-Pd0e8Igk.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-realtime-store-BheKaO6d.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-realtime-BwX_fHUS.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-realtime-store-cLCDEe4D.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-realtime-C3WQQY10.js">
     <link rel="modulepreload" crossorigin href="/assets/tool-activity-BtJkgjFf.js">
-    <link rel="modulepreload" crossorigin href="/assets/registry-api-Bh9UBb-f.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-7RKqgU_U.js">
-    <link rel="modulepreload" crossorigin href="/assets/agents-admin-api-HBZvVyzF.js">
-    <link rel="modulepreload" crossorigin href="/assets/session-manager-CWjhJxJs.js">
-    <link rel="modulepreload" crossorigin href="/assets/send-session-input-Di3Q846r.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-BOfCKgl6.js">
-    <link rel="modulepreload" crossorigin href="/assets/extension-provider-VFWspV08.js">
+    <link rel="modulepreload" crossorigin href="/assets/registry-api-CoMBYjHD.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-BoRkBnsw.js">
+    <link rel="modulepreload" crossorigin href="/assets/agents-admin-api-B4tgTbWG.js">
+    <link rel="modulepreload" crossorigin href="/assets/session-manager-B06ZCie_.js">
+    <link rel="modulepreload" crossorigin href="/assets/send-session-input-CLhR1uEp.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-KcQhCg1-.js">
+    <link rel="modulepreload" crossorigin href="/assets/extension-provider-DxlAZ2iy.js">
     <link rel="modulepreload" crossorigin href="/assets/loopi-Djb8XU3l.js">
-    <link rel="modulepreload" crossorigin href="/assets/models-hub-cache-DyPPksMP.js">
+    <link rel="modulepreload" crossorigin href="/assets/models-hub-cache-Jj8dvYcv.js">
     <link rel="modulepreload" crossorigin href="/assets/skill-api-utils-C7V4JVXM.js">
     <link rel="modulepreload" crossorigin href="/assets/date-formatters-CUZAyDEg.js">
     <link rel="modulepreload" crossorigin href="/assets/settings-form-draft-Dy10ldo8.js">

package/dist/package.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.0.372";
+var version = "0.0.374";
 //#endregion
 export { version };

package/dist/packages/gateway-contract/src/cloud-credits.js

@@ -0,0 +1,80 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { z } from "zod";
+//#region packages/gateway-contract/src/cloud-credits.ts
+/** Format integers exactly, including quantities too large for decimal Number arithmetic. */
+function creditDecimal(micro) {
+	creditMicroSchema.parse(micro);
+	const value = BigInt(micro);
+	const fraction = String(value % 10000n).padStart(4, "0").replace(/0+$/, "");
+	return `${value / 10000n}${fraction ? `.${fraction}` : ""}`;
+}
+var creditMicroSchema, creditUnitSchema, cloudAccountSummarySchema, cloudCreditBudgetSchema, cloudBillingReceiptSchema;
+var init_cloud_credits = __esmMin((() => {
+	creditMicroSchema = z.string().regex(/^(0|[1-9]\d{0,15})$/).refine((value) => BigInt(value) <= BigInt(Number.MAX_SAFE_INTEGER), "Credit amount exceeds supported range");
+	creditUnitSchema = z.object({
+		unit: z.literal("credit"),
+		microPerCredit: z.literal("10000"),
+		version: z.literal("credit-v1"),
+		standardCreditsPerYuan: z.string().regex(/^\d+$/)
+	});
+	cloudAccountSummarySchema = z.object({
+		schemaVersion: z.literal(2),
+		creditUnit: creditUnitSchema,
+		balance: z.object({
+			availableCreditMicro: creditMicroSchema,
+			purchasedCreditMicro: creditMicroSchema,
+			grantedCreditMicro: creditMicroSchema,
+			usageReservedCreditMicro: creditMicroSchema,
+			refundReservedCreditMicro: creditMicroSchema,
+			expiring: z.array(z.object({
+				id: z.string(),
+				creditMicro: creditMicroSchema,
+				expiresAt: z.number().int().nonnegative()
+			})),
+			updatedAt: z.string().datetime()
+		}),
+		usage: z.object({
+			days: z.union([
+				z.literal(1),
+				z.literal(7),
+				z.literal(30)
+			]),
+			requests: z.number().int().nonnegative(),
+			inputTokens: z.number().int().nonnegative(),
+			outputTokens: z.number().int().nonnegative(),
+			totalTokens: z.number().int().nonnegative(),
+			errors: z.number().int().nonnegative(),
+			averageLatencyMs: z.number().nonnegative(),
+			chargedCreditMicro: creditMicroSchema
+		}),
+		links: z.object({
+			details: z.string().url(),
+			purchase: z.string().url()
+		})
+	});
+	cloudCreditBudgetSchema = z.object({
+		id: z.string().uuid(),
+		limitCreditMicro: creditMicroSchema,
+		reservedCreditMicro: creditMicroSchema,
+		chargedCreditMicro: creditMicroSchema,
+		remainingCreditMicro: creditMicroSchema,
+		revision: z.number().int().positive(),
+		createdAt: z.number().int().nonnegative()
+	});
+	cloudBillingReceiptSchema = z.object({
+		requestId: z.string(),
+		model: z.string(),
+		state: z.string(),
+		reservedCreditMicro: creditMicroSchema,
+		chargedCreditMicro: creditMicroSchema.nullable(),
+		releasedCreditMicro: creditMicroSchema,
+		ratedCreditMicro: creditMicroSchema.nullable(),
+		absorbedCreditMicro: creditMicroSchema.nullable(),
+		priceSnapshot: z.unknown().nullable(),
+		createdAt: z.number().int().nonnegative(),
+		settledAt: z.number().int().nonnegative().nullable()
+	});
+}));
+//#endregion
+init_cloud_credits();
+export { cloudAccountSummarySchema, cloudBillingReceiptSchema, cloudCreditBudgetSchema, creditDecimal, creditMicroSchema, creditUnitSchema, init_cloud_credits };

package/dist/packages/gateway-contract/src/index.js

@@ -31,6 +31,7 @@ import { init_device_pairing } from "./device-pairing.js";
 import { init_gateway_scopes } from "./gateway-scopes.js";
 import { init_browser_tab_binding } from "./browser-tab-binding.js";
 import { init_model_selection } from "./model-selection.js";
+import { init_cloud_credits } from "./cloud-credits.js";
 import { init_connection_waits } from "./connection-waits.js";
 import { init_clarifications } from "./clarifications.js";
 import { init_discussions } from "./discussions.js";
@@ -72,6 +73,7 @@ var init_src = __esmMin((() => {
 	init_browser_page_context();
 	init_browser_tab_binding();
 	init_model_selection();
+	init_cloud_credits();
 	init_connection_waits();
 	init_clarifications();
 	init_discussions();

package/dist/packages/realtime-protocol/src/voice.js

@@ -62,6 +62,7 @@ var init_voice = __esmMin((() => {
 	});
 	z.object({
 		enabled: z.boolean(),
+		openingGreeting: z.boolean().optional(),
 		defaultMode: voiceModeSchema,
 		omni: voiceProviderRouteSchema.nullable(),
 		stt: voiceProviderRouteSchema.nullable(),
@@ -80,6 +81,11 @@ var init_voice = __esmMin((() => {
 		mode: voiceModeSchema.optional(),
 		conversationId: z.string().min(1).max(512).optional(),
 		language: voiceLanguageSchema.optional(),
+		openingGreeting: z.strictObject({
+			logicalCallId: idSchema,
+			initiation: z.enum(["user", "recovery"]),
+			supportsOutputReady: z.literal(true)
+		}).optional(),
 		supportedProtocolVersions: z.tuple([z.literal(3)]),
 		mediaPreferences: z.tuple([z.literal("websocket-pcm")])
 	}).superRefine((value, context) => {
@@ -95,6 +101,10 @@ var init_voice = __esmMin((() => {
 		});
 	});
 	z.strictObject({
+		openingGreeting: z.strictObject({
+			accepted: z.boolean(),
+			greetingResponseId: z.string().max(160).optional()
+		}).optional(),
 		sessionId: idSchema,
 		ticket: z.string().min(32).max(512),
 		ticketExpiresAt: z.iso.datetime(),
@@ -135,6 +145,7 @@ var init_voice = __esmMin((() => {
 			metric: z.enum(VOICE_TIMING_METRICS),
 			durationMs: z.number().finite().min(0).max(6e5)
 		})),
+		clientEnvelope("session.output_ready", z.strictObject({ connectionEpoch: z.number().int().positive() })),
 		clientEnvelope("input.mute", z.strictObject({ muted: z.boolean() })),
 		clientEnvelope("input.commit", z.strictObject({})),
 		clientEnvelope("response.stop_playback", z.strictObject({ responseId: z.string().min(1).max(160) })),

package/dist/src/agent/client-error-format.d.ts

@@ -1,4 +1,4 @@
-export type AgentRunErrorKind = 'provider_setup_required' | 'provider_auth_invalid' | 'rate_limit' | 'timeout' | 'billing' | 'xopc_quota_exhausted' | 'xopc_platform_limit' | 'unknown';
+export type AgentRunErrorKind = 'provider_setup_required' | 'provider_auth_invalid' | 'rate_limit' | 'timeout' | 'billing' | 'xopc_quota_exhausted' | 'xopc_platform_limit' | 'xopc_credit_budget_exhausted' | 'unknown';
 export type AgentRunErrorPayload = {
     kind: AgentRunErrorKind;
     code: string;

package/dist/src/agent/client-error-format.js

@@ -67,6 +67,13 @@ function formatAgentRunErrorForClient(rawError, context) {
 			message: trimmed
 		});
 	}
+	if (/credit_budget_exhausted|(?:task Credit|Credit task) budget exhausted/i.test(trimmed)) return JSON.stringify({
+		kind: "xopc_credit_budget_exhausted",
+		code: "credit_budget_exhausted",
+		message: trimmed,
+		provider: "xopc-cloud",
+		deepLink: "/settings/agent-defaults?panel=runtime"
+	});
 	const reason = classifyFailoverReason(trimmed);
 	const xopcPlatformLimit = context?.provider === "xopc-cloud" && XOPC_PLATFORM_LIMIT_RE.test(trimmed);
 	const xopcQuotaExhausted = context?.provider === "xopc-cloud" && (XOPC_QUOTA_RE.test(trimmed) || reason === "billing");

package/dist/src/agent/embedded/run-turn.js

@@ -11,6 +11,7 @@ import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profil
 import { continuesAfterTool, trackAiUsageStream } from "../../usage/recorder.js";
 import { runWithEmbeddedExecutionSession } from "./execution-context.js";
 import { externalPolicyContext } from "./tool-metadata.js";
+import { cloudCreditBudgetStopMessage, isCloudCreditBudgetExhausted, reportCloudCreditError, withCloudCreditBudget } from "../../providers/xopc-cloud-credit-budget.js";
 import { isComputerControlActive, isComputerLeaseTool, stopComputerControl } from "../../computer/control-guard.js";
 import { EmbeddedRunConflictError, abortEmbeddedRun, acquireEmbeddedRunLease, queueEmbeddedSteer } from "./runs.js";
 import { lastAssistantPlainText, subscribeEmbeddedSessionEvents } from "./subscribe-session.js";
@@ -242,10 +243,45 @@ async function maybeRecoverInterruptedContext(params) {
 	return true;
 }
 async function runXopcEmbeddedTurn(params) {
-	return traceRun("agent.run", {
+	const limitCreditMicro = isXopcDatabaseOpen() && getSessionMetadata(params.conversationId) ? resolveEffectiveAgentConfigForSession(params.conversationId).config.runtime.cloudCreditLimitPerRunMicro : void 0;
+	return withCloudCreditBudget({
 		conversationId: params.conversationId,
-		runId: params.runId
-	}, () => runXopcEmbeddedTurnInner(params), params.userMessage);
+		runId: params.runId,
+		limitCreditMicro
+	}, async () => {
+		try {
+			const result = await traceRun("agent.run", {
+				conversationId: params.conversationId,
+				runId: params.runId
+			}, () => runXopcEmbeddedTurnInner(params), params.userMessage);
+			const stopped = cloudCreditBudgetStopMessage();
+			if (stopped) return {
+				...result,
+				ok: false,
+				retryable: false,
+				errorMessage: stopped
+			};
+			if (result.errorMessage && isCloudCreditBudgetExhausted(result.errorMessage)) {
+				reportCloudCreditError(result.errorMessage);
+				return {
+					...result,
+					retryable: false
+				};
+			}
+			return result;
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			if (isCloudCreditBudgetExhausted(message)) {
+				reportCloudCreditError(message);
+				return {
+					ok: false,
+					retryable: false,
+					errorMessage: message
+				};
+			}
+			throw error;
+		}
+	});
 }
 async function runXopcEmbeddedTurnInner(params) {
 	const { conversationId, runId, userMessage, model, tools: rawTools, systemPrompt, thinkingLevel, workspaceDir, sessionStore, onEvent } = params;

package/dist/src/agent/embedded/xopc-stream-bridge.js

@@ -1,6 +1,8 @@
 import "../../providers/constants.js";
 import { init_providers } from "../../providers/index.js";
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
+import { withCloudUsageResponse } from "../../usage/cloud-receipts.js";
+import { assertCloudCreditBudgetActive, cloudCreditBudgetHeaders, hasCloudCreditBudget, reportCloudCreditError } from "../../providers/xopc-cloud-credit-budget.js";
 import { preparePromptCacheContext, withPromptCachePayloadTransform } from "../../providers/prompt-cache-payload.js";
 import { getCurrentSystemPrompt, getCurrentTools, normalizeContext } from "@earendil-works/pi-ai";
 //#region src/agent/embedded/xopc-stream-bridge.ts
@@ -17,6 +19,8 @@ init_providers();
 function wrapStreamFnForXopcExtensions(originalStreamFn, promptCachePolicy) {
 	const extensionStreamFn = createExtensionAwareStreamFn();
 	return ((model, context, options) => {
+		assertCloudCreditBudgetActive();
+		if (model.provider === "xopc-cloud") options = withCloudUsageResponse(options);
 		const promptContext = {
 			systemPrompt: getCurrentSystemPrompt(context.messages),
 			tools: getCurrentTools(context.messages)
@@ -28,6 +32,20 @@ function wrapStreamFnForXopcExtensions(originalStreamFn, promptCachePolicy) {
 			messages: context.messages.filter((message) => message.role !== "system")
 		});
 		if (model.baseUrl === "extension://provider-plugin") return extensionStreamFn(model, providerContext, options);
+		if (model.provider === "xopc-cloud" && hasCloudCreditBudget()) return (async () => {
+			const headers = await cloudCreditBudgetHeaders();
+			const stream = await originalStreamFn(model, providerContext, withPromptCachePayloadTransform(model, promptContext, {
+				...options,
+				headers: {
+					...options?.headers,
+					...headers
+				}
+			}, promptCachePolicy));
+			stream.result().then((message) => {
+				if (message.errorMessage) reportCloudCreditError(message.errorMessage);
+			}).catch(() => {});
+			return stream;
+		})();
 		return originalStreamFn(model, providerContext, withPromptCachePayloadTransform(model, promptContext, options, promptCachePolicy));
 	});
 }

package/dist/src/agent/image/generation/openai-images-provider.d.ts

@@ -35,6 +35,7 @@ export interface OpenAiImagesEndpointResolution {
     privateNetworkPolicy?: PrivateNetworkPolicy;
 }
 export interface OpenAiImagesProviderOptions {
+    onResponse?: (response: Response) => void;
     id: string;
     label: string;
     defaultModel: string;
@@ -45,7 +46,7 @@ export interface OpenAiImagesProviderOptions {
     /** Resolve API key for one request. May return null when using OAuth/header auth. */
     resolveApiKey: (req: ImageGenerationRequest) => string | null | undefined | Promise<string | null | undefined>;
     /** Resolve endpoint info per-request (region, baseUrl override, Azure deployment, …). */
-    resolveEndpoint: (req: ImageGenerationRequest) => OpenAiImagesEndpointResolution;
+    resolveEndpoint: (req: ImageGenerationRequest) => OpenAiImagesEndpointResolution | Promise<OpenAiImagesEndpointResolution>;
     /** Default per-call timeout. Combined with provider-level config in provider-http. */
     defaultTimeoutMs?: number;
     /** Default image count. Provider may also enforce via `capabilities.generate.maxCount`. */

package/dist/src/agent/image/generation/openai-images-provider.js

@@ -28,7 +28,7 @@ function createOpenAiImagesProvider(options) {
 		isConfigured: options.isConfigured,
 		async generateImage(req) {
 			const apiKey = await options.resolveApiKey(req) ?? null;
-			const endpoint = options.resolveEndpoint(req);
+			const endpoint = await options.resolveEndpoint(req);
 			const httpDefaults = resolveProviderHttpRequestConfig({
 				providerId: options.id,
 				cfg: req.cfg,
@@ -75,7 +75,8 @@ function createOpenAiImagesProvider(options) {
 				count,
 				size,
 				httpDefaults,
-				ssrfGuardOptions
+				ssrfGuardOptions,
+				onResponse: options.onResponse
 			}) : await postGenerateRequest({
 				providerId: options.id,
 				req,
@@ -84,7 +85,8 @@ function createOpenAiImagesProvider(options) {
 				count,
 				size,
 				httpDefaults,
-				ssrfGuardOptions
+				ssrfGuardOptions,
+				onResponse: options.onResponse
 			}), {
 				...req,
 				count
@@ -111,14 +113,16 @@ async function postGenerateRequest(params) {
 		resolution: params.req.resolution
 	} };
 	const timeoutMs = pickTimeoutMsOrFallback(params.req.timeoutMs, params.httpDefaults.timeoutMs, DEFAULT_TIMEOUT_MS);
-	return await readJsonResponseLimited(await postJsonRequest(params.url, {
+	const res = await postJsonRequest(params.url, {
 		label: params.providerId,
 		timeoutMs,
 		signal: params.req.signal,
 		body,
 		headers: params.headers,
 		...params.ssrfGuardOptions
-	}), MAX_RESPONSE_BYTES);
+	});
+	params.onResponse?.(res);
+	return await readJsonResponseLimited(res, MAX_RESPONSE_BYTES);
 }
 async function postEditRequest(params) {
 	const inputImages = params.req.inputImages ?? [];
@@ -148,14 +152,16 @@ async function postEditRequest(params) {
 	const headers = new Headers(params.headers);
 	headers.delete("content-type");
 	const timeoutMs = pickTimeoutMsOrFallback(params.req.timeoutMs, params.httpDefaults.timeoutMs, DEFAULT_TIMEOUT_MS);
-	return await readJsonResponseLimited(await postMultipartRequest(params.url, {
+	const res = await postMultipartRequest(params.url, {
 		label: params.providerId,
 		timeoutMs,
 		signal: params.req.signal,
 		body: form,
 		headers,
 		...params.ssrfGuardOptions
-	}), MAX_RESPONSE_BYTES);
+	});
+	params.onResponse?.(res);
+	return await readJsonResponseLimited(res, MAX_RESPONSE_BYTES);
 }
 function mapOpenAiImagesResponse(raw, req) {
 	if (!raw || typeof raw !== "object") return [];

package/dist/src/agent/image/generation/providers/xopc-cloud.js

@@ -1,7 +1,10 @@
 import { getModelCatalogStore, init_model_catalog_store } from "../../../../providers/model-catalog-store.js";
 import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "../../../../providers/xopc-cloud-config.js";
 import { getProviderAuthService, init_provider_auth_service } from "../../../../providers/provider-auth-service.js";
+import { captureCloudUsageResponse } from "../../../../usage/cloud-receipts.js";
+import { cloudCreditBudgetHeaders, reportCloudCreditError } from "../../../../providers/xopc-cloud-credit-budget.js";
 import { compareCatalogModels } from "../../../../providers/model-catalog-ranking.js";
+import { trackCloudCapabilityUsage } from "../../../../usage/cloud-capability.js";
 import { createOpenAiImagesProvider } from "../openai-images-provider.js";
 //#region src/agent/image/generation/providers/xopc-cloud.ts
 init_model_catalog_store();
@@ -23,7 +26,11 @@ function buildXopcCloudImageGenerationProvider() {
 		capabilities: modelCapabilities[model.id],
 		isConfigured: () => true,
 		resolveApiKey: (request) => getProviderAuthService().resolveApiKey("xopc-cloud", request.signal),
-		resolveEndpoint: () => ({ baseUrl }),
+		resolveEndpoint: async () => ({
+			baseUrl,
+			headers: await cloudCreditBudgetHeaders()
+		}),
+		onResponse: captureCloudUsageResponse,
 		...model.imageGeneration?.geometry?.sizes?.[0] ? { defaultSize: model.imageGeneration.geometry.sizes[0] } : {}
 	})]));
 	return {
@@ -38,7 +45,12 @@ function buildXopcCloudImageGenerationProvider() {
 		async generateImage(request) {
 			const executor = executors.get(request.model);
 			if (!executor) throw new Error(`Image model is not available from XOPC Model Service: ${request.model}`);
-			return executor.generateImage(request);
+			try {
+				return await trackCloudCapabilityUsage(request.model, "images.generate", () => executor.generateImage(request));
+			} catch (error) {
+				reportCloudCreditError(error instanceof Error ? error.message : String(error));
+				throw error;
+			}
 		}
 	};
 }

package/dist/src/agent-config/schema.d.ts

@@ -163,6 +163,7 @@ export declare const RuntimePolicySchema: z.ZodObject<{
             "read-write": "read-write";
         }>>;
     }, z.core.$strict>], "mode">>;
+    cloudCreditLimitPerRunMicro: z.ZodOptional<z.ZodString>;
     maxTurns: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
     maxToolFailuresPerTurn: z.ZodOptional<z.ZodNumber>;
@@ -258,6 +259,7 @@ export declare const AgentDefaultsSchema: z.ZodObject<{
                 "read-write": "read-write";
             }>>;
         }, z.core.$strict>], "mode">>;
+        cloudCreditLimitPerRunMicro: z.ZodOptional<z.ZodString>;
         maxTurns: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         maxToolFailuresPerTurn: z.ZodOptional<z.ZodNumber>;
@@ -315,6 +317,9 @@ export declare const AgentProfileSchema: z.ZodObject<{
         model: z.ZodString;
         voice: z.ZodString;
     }, z.core.$strict>>;
+    voiceCallPreferences: z.ZodOptional<z.ZodObject<{
+        openingGreetingEnabled: z.ZodBoolean;
+    }, z.core.$strict>>;
     responsePreferences: z.ZodOptional<z.ZodObject<{
         addressAs: z.ZodOptional<z.ZodString>;
         guidance: z.ZodOptional<z.ZodString>;
@@ -363,6 +368,9 @@ export declare const AgentEntrySchema: z.ZodObject<{
             model: z.ZodString;
             voice: z.ZodString;
         }, z.core.$strict>>;
+        voiceCallPreferences: z.ZodOptional<z.ZodObject<{
+            openingGreetingEnabled: z.ZodBoolean;
+        }, z.core.$strict>>;
         responsePreferences: z.ZodOptional<z.ZodObject<{
             addressAs: z.ZodOptional<z.ZodString>;
             guidance: z.ZodOptional<z.ZodString>;
@@ -476,6 +484,7 @@ export declare const AgentEntrySchema: z.ZodObject<{
                 "read-write": "read-write";
             }>>;
         }, z.core.$strict>], "mode">>;
+        cloudCreditLimitPerRunMicro: z.ZodOptional<z.ZodString>;
         maxTurns: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         maxToolFailuresPerTurn: z.ZodOptional<z.ZodNumber>;
@@ -508,6 +517,9 @@ export declare const EffectiveAgentConfigSchema: z.ZodObject<{
             model: z.ZodString;
             voice: z.ZodString;
         }, z.core.$strict>>;
+        voiceCallPreferences: z.ZodOptional<z.ZodObject<{
+            openingGreetingEnabled: z.ZodBoolean;
+        }, z.core.$strict>>;
         responsePreferences: z.ZodOptional<z.ZodObject<{
             addressAs: z.ZodOptional<z.ZodString>;
             guidance: z.ZodOptional<z.ZodString>;
@@ -620,6 +632,7 @@ export declare const EffectiveAgentConfigSchema: z.ZodObject<{
                 "read-write": "read-write";
             }>>;
         }, z.core.$strict>], "mode">>;
+        cloudCreditLimitPerRunMicro: z.ZodOptional<z.ZodString>;
         maxTurns: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         maxToolFailuresPerTurn: z.ZodOptional<z.ZodNumber>;

package/dist/src/agent-config/schema.js

@@ -114,6 +114,7 @@ var init_schema = __esmMin((() => {
 			network: z.boolean().default(false),
 			workspaceAccess: z.enum(["read-only", "read-write"]).default("read-only")
 		}).strict()]).optional(),
+		cloudCreditLimitPerRunMicro: z.string().regex(/^[1-9]\d{0,14}$/).optional(),
 		maxTurns: z.number().int().positive().optional(),
 		timeoutMs: z.number().int().positive().optional(),
 		maxToolFailuresPerTurn: z.number().int().positive().optional(),
@@ -171,6 +172,7 @@ var init_schema = __esmMin((() => {
 			model: z.string().trim().min(1).max(200),
 			voice: z.string().trim().min(1).max(200)
 		}).strict().optional(),
+		voiceCallPreferences: z.object({ openingGreetingEnabled: z.boolean() }).strict().optional(),
 		responsePreferences: ResponsePreferencesSchema.optional(),
 		instructions: z.string().trim().min(1).optional()
 	}).strict();

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -53,7 +53,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v241).`,
+		message: `SQLite schema v${status.dbVersion} (current release v244).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/gateway/shared.js

@@ -1,9 +1,10 @@
+import { init_constants, resolveGatewayLaunchAgentLabel, resolveGatewaySystemdServiceName, resolveGatewayWindowsTaskName } from "../../../daemon/constants.js";
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
-import { resolveGatewayLaunchAgentLabel, resolveGatewaySystemdServiceName, resolveGatewayWindowsTaskName } from "../../../daemon/constants.js";
 import { loadConfig } from "../../../config/loader.js";
 import "../../../config/index.js";
 //#region src/cli/commands/gateway/shared.ts
 init_paths();
+init_constants();
 function parsePortFromArgs(programArguments) {
 	if (!programArguments?.length) return null;
 	for (let i = 0; i < programArguments.length; i += 1) {