@xopcai/xopc 0.0.372 → 0.0.373

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-B40-KDN8.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.373";
 //#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/src/agent/agent-manager.js

@@ -9,16 +9,16 @@ import { init_sqlite } from "../storage/sqlite/index.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_agent_scope, listAgentEntries, resolveAgentProfileDir } from "./agent-scope.js";
 import { extractTextContent } from "./context/workspace.js";
+import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
-import { traceTools } from "../observability/runtime.js";
-import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
-import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
+import { traceTools } from "../observability/runtime.js";
 import { continuesAfterTool, trackAiUsageStream } from "../usage/recorder.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 import { isPersonalConversation } from "../personal-agent/repository.js";
 import { PersonalPromptContext } from "../personal-agent/prompt-context.js";

package/dist/src/agent/background-review/run-background-review.js

@@ -5,11 +5,11 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 import { loadCompactionSourceSnapshot } from "../../storage/sqlite/transcript-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { extractTextContent } from "../context/workspace.js";
-import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { getApiKeySync, init_providers, resolveModel } from "../../providers/index.js";
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
 import { trackAiUsageStream } from "../../usage/recorder.js";
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { getAssertionSlot, listUserAssertions } from "../../user-model/repository.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed } from "../orchestration/llm-turn-retry.js";

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/model-runtime.js

@@ -1,6 +1,6 @@
 import { init_paths, resolveModelsJsonPath } from "../../config/paths.js";
-import { init_register_bundled_oauth_flows, registerBundledOAuthFlows } from "../../providers/register-bundled-oauth-flows.js";
 import { assertCurrentModelProvider, init_provider_policy } from "../../providers/provider-policy.js";
+import { init_register_bundled_oauth_flows, registerBundledOAuthFlows } from "../../providers/register-bundled-oauth-flows.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { XopcModelCredentialStore, init_model_credential_store } from "../../auth/model-credential-store.js";

package/dist/src/agent/embedded/run-for-session.js

@@ -2,10 +2,10 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { parseTurnOutcome } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { setTraceIdentity, startObservation, traceOperation, traceRun } from "../../observability/runtime.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { appendDynamicPromptSection } from "../prompt/cache-boundary.js";
+import { setTraceIdentity, startObservation, traceOperation, traceRun } from "../../observability/runtime.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { runWithEmbeddedExecutionSession } from "./execution-context.js";
 import { resolveAgentTurnTimeoutMs } from "../orchestration/run-agent-turn-with-timeout.js";

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

@@ -7,8 +7,9 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 import { init_session_repository } from "../../storage/sqlite/session-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { setTraceIdentity, traceOperation, traceRun, traceTools } from "../../observability/runtime.js";
-import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { continuesAfterTool, trackAiUsageStream } from "../../usage/recorder.js";
+import { cloudCreditBudgetStopMessage, isCloudCreditBudgetExhausted, reportCloudCreditError, withCloudCreditBudget } from "../../providers/xopc-cloud-credit-budget.js";
+import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { runWithEmbeddedExecutionSession } from "./execution-context.js";
 import { externalPolicyContext } from "./tool-metadata.js";
 import { isComputerControlActive, isComputerLeaseTool, stopComputerControl } from "../../computer/control-guard.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/image/tool-model-config.js

@@ -1,7 +1,7 @@
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "../../config/schema.js";
-import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { getDefaultModelSync, getModelsByProvider, init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { resolveAgentModelFallbackValues, resolveAgentModelPrimaryValue } from "../../config/model-input.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";

package/dist/src/agent/service.js

@@ -3,12 +3,12 @@ import { init_logger } from "../utils/logger.js";
 import { init_attachment_ref, parseNoteAttachmentTarget } from "../notes/attachment-ref.js";
 import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
 import { extractTextContent } from "./context/workspace.js";
-import { configureTracing, flushTracing } from "../observability/runtime.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../routing/agent-session-key.js";
-import { extractProfileAgentId, resolveEffectiveAgentConfigForSession } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { configureTracing, flushTracing } from "../observability/runtime.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { extractProfileAgentId, resolveEffectiveAgentConfigForSession } from "../config/agent-profile.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";
 import { getUserTimezone } from "../user-model/repository.js";

package/dist/src/agent/session/session-inspector.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_workspace_defaults, resolveDefaultAgentWorkspaceDir } from "../../config/workspace-defaults.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getExecutionEnvironmentForSession } from "../../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";

package/dist/src/agent/tasks/task-judge-service.js

@@ -2,13 +2,13 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { TaskRepository, init_task_repository } from "../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
+import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
 //#region src/agent/tasks/task-judge-service.ts
 init_schema();

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>;
@@ -476,6 +478,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>;
@@ -620,6 +623,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(),

package/dist/src/ai-assist/text-assist.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
 import { trackAiUsageStream } from "../usage/recorder.js";
 import { isLocalModelBaseUrl, resolveModelCallApiKey, resolveModelCallOptions } from "../providers/model-call.js";
-import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { normalizeContext } from "@earendil-works/pi-ai";
 //#region src/ai-assist/text-assist.ts
 init_providers();