@p4code/cli 0.1.1 → 0.1.2

package/dist/bin.mjs

@@ -233,7 +233,7 @@ const make$72 = () => {
 const layer$68 = Layer.sync(NetService, make$72);
 //#endregion
 //#region package.json
-var version = "0.1.1";
+var version = "0.1.2";
 //#endregion
 //#region src/config.ts
 /**
@@ -8171,6 +8171,7 @@ const WS_METHODS = {
 	serverGetSettings: "server.getSettings",
 	serverUpdateSettings: "server.updateSettings",
 	serverDiscoverSourceControl: "server.discoverSourceControl",
+	serverGetProviderUsage: "server.getProviderUsage",
 	serverGetTraceDiagnostics: "server.getTraceDiagnostics",
 	serverGetProcessDiagnostics: "server.getProcessDiagnostics",
 	serverGetProcessResourceHistory: "server.getProcessResourceHistory",
@@ -8523,6 +8524,16 @@ const WsServerDiscoverSourceControlRpc = Rpc.make(WS_METHODS.serverDiscoverSourc
 	success: SourceControlDiscoveryResult,
 	error: EnvironmentAuthorizationError
 });
+/**
+* The provider's own usage report, as the provider CLI prints it. Read-only and
+* local to the provider: no model turn is involved, so asking for it costs
+* nothing and never lands in a thread.
+*/
+const WsServerGetProviderUsageRpc = Rpc.make(WS_METHODS.serverGetProviderUsage, {
+	payload: Schema$1.Struct({ instanceId: ProviderInstanceId }),
+	success: Schema$1.Struct({ report: Schema$1.String }),
+	error: Schema$1.Union([TextGenerationError, EnvironmentAuthorizationError])
+});
 const WsServerGetTraceDiagnosticsRpc = Rpc.make(WS_METHODS.serverGetTraceDiagnostics, {
 	payload: Schema$1.Struct({}),
 	success: ServerTraceDiagnosticsResult,
@@ -8818,7 +8829,7 @@ const WsSubscribeAuthAccessRpc = Rpc.make(WS_METHODS.subscribeAuthAccess, {
 	error: Schema$1.Union([AuthAccessStreamError, EnvironmentAuthorizationError]),
 	stream: true
 });
-const WsRpcGroup = RpcGroup.make(WsServerProbeRpc, WsServerGetConfigRpc, WsServerRefreshProvidersRpc, WsServerUpdateProviderRpc, WsServerUpdateServerRpc, WsServerUpsertKeybindingRpc, WsServerRemoveKeybindingRpc, WsServerGetSettingsRpc, WsServerUpdateSettingsRpc, WsServerDiscoverSourceControlRpc, WsServerGetTraceDiagnosticsRpc, WsServerGetProcessDiagnosticsRpc, WsServerGetProcessResourceHistoryRpc, WsServerSignalProcessRpc, WsSourceControlLookupRepositoryRpc, WsSourceControlCloneRepositoryRpc, WsSourceControlPublishRepositoryRpc, WsProjectsListEntriesRpc, WsProjectsReadFileRpc, WsProjectsSearchEntriesRpc, WsProjectsWriteFileRpc, WsShellOpenInEditorRpc, WsFilesystemBrowseRpc, WsAssetsCreateUrlRpc, WsSubscribeVcsStatusRpc, WsVcsPullRpc, WsVcsRefreshStatusRpc, WsGitRunStackedActionRpc, WsGitResolvePullRequestRpc, WsGitPreparePullRequestThreadRpc, WsVcsListRefsRpc, WsVcsCreateWorktreeRpc, WsVcsRemoveWorktreeRpc, WsVcsCreateRefRpc, WsVcsSwitchRefRpc, WsVcsInitRpc, WsReviewGetDiffPreviewRpc, WsTerminalOpenRpc, WsTerminalAttachRpc, WsTerminalWriteRpc, WsTerminalResizeRpc, WsTerminalClearRpc, WsTerminalRestartRpc, WsTerminalCloseRpc, WsSubscribeTerminalEventsRpc, WsSubscribeTerminalMetadataRpc, WsPreviewOpenRpc, WsPreviewNavigateRpc, WsPreviewResizeRpc, WsPreviewRefreshRpc, WsPreviewCloseRpc, WsPreviewListRpc, WsPreviewReportStatusRpc, WsPreviewAutomationConnectRpc, WsPreviewAutomationRespondRpc, WsPreviewAutomationFocusHostRpc, WsSubscribePreviewEventsRpc, WsSubscribeDiscoveredLocalServersRpc, WsSubscribeServerConfigRpc, WsSubscribeServerLifecycleRpc, WsSubscribeAuthAccessRpc, WsTasksListRpc, WsTasksGetRpc, WsTasksCreateRpc, WsTasksUpdateRpc, WsTasksDeleteRpc, WsTasksStartThreadRpc, WsSubscribeTasksRpc, WsHubGetSyncStatusRpc, WsHubConnectRpc, WsHubDisconnectRpc, WsHubSetSyncModeRpc, WsHubSetShareModeRpc, WsHubMintTokenRpc, WsSkillsSyncRpc, WsSkillsPublishRpc, WsSkillsPublishAllRpc, WsSkillsUnpublishRpc, WsAssetsReadRpc, WsAssetsSaveRpc, WsAssetsDeleteRpc, WsAssetsCreateLocalRpc, WsAssetsRemoveLocalRpc, WsMcpListRpc, WsMcpSaveRpc, WsMcpRemoveRpc, WsMcpSetSecretRpc, WsOrchestrationDispatchCommandRpc, WsOrchestrationGetTurnDiffRpc, WsOrchestrationGetFullThreadDiffRpc, WsOrchestrationGetArchivedShellSnapshotRpc, WsOrchestrationSubscribeShellRpc, WsOrchestrationSubscribeThreadRpc);
+const WsRpcGroup = RpcGroup.make(WsServerProbeRpc, WsServerGetConfigRpc, WsServerRefreshProvidersRpc, WsServerUpdateProviderRpc, WsServerUpdateServerRpc, WsServerUpsertKeybindingRpc, WsServerRemoveKeybindingRpc, WsServerGetSettingsRpc, WsServerUpdateSettingsRpc, WsServerDiscoverSourceControlRpc, WsServerGetProviderUsageRpc, WsServerGetTraceDiagnosticsRpc, WsServerGetProcessDiagnosticsRpc, WsServerGetProcessResourceHistoryRpc, WsServerSignalProcessRpc, WsSourceControlLookupRepositoryRpc, WsSourceControlCloneRepositoryRpc, WsSourceControlPublishRepositoryRpc, WsProjectsListEntriesRpc, WsProjectsReadFileRpc, WsProjectsSearchEntriesRpc, WsProjectsWriteFileRpc, WsShellOpenInEditorRpc, WsFilesystemBrowseRpc, WsAssetsCreateUrlRpc, WsSubscribeVcsStatusRpc, WsVcsPullRpc, WsVcsRefreshStatusRpc, WsGitRunStackedActionRpc, WsGitResolvePullRequestRpc, WsGitPreparePullRequestThreadRpc, WsVcsListRefsRpc, WsVcsCreateWorktreeRpc, WsVcsRemoveWorktreeRpc, WsVcsCreateRefRpc, WsVcsSwitchRefRpc, WsVcsInitRpc, WsReviewGetDiffPreviewRpc, WsTerminalOpenRpc, WsTerminalAttachRpc, WsTerminalWriteRpc, WsTerminalResizeRpc, WsTerminalClearRpc, WsTerminalRestartRpc, WsTerminalCloseRpc, WsSubscribeTerminalEventsRpc, WsSubscribeTerminalMetadataRpc, WsPreviewOpenRpc, WsPreviewNavigateRpc, WsPreviewResizeRpc, WsPreviewRefreshRpc, WsPreviewCloseRpc, WsPreviewListRpc, WsPreviewReportStatusRpc, WsPreviewAutomationConnectRpc, WsPreviewAutomationRespondRpc, WsPreviewAutomationFocusHostRpc, WsSubscribePreviewEventsRpc, WsSubscribeDiscoveredLocalServersRpc, WsSubscribeServerConfigRpc, WsSubscribeServerLifecycleRpc, WsSubscribeAuthAccessRpc, WsTasksListRpc, WsTasksGetRpc, WsTasksCreateRpc, WsTasksUpdateRpc, WsTasksDeleteRpc, WsTasksStartThreadRpc, WsSubscribeTasksRpc, WsHubGetSyncStatusRpc, WsHubConnectRpc, WsHubDisconnectRpc, WsHubSetSyncModeRpc, WsHubSetShareModeRpc, WsHubMintTokenRpc, WsSkillsSyncRpc, WsSkillsPublishRpc, WsSkillsPublishAllRpc, WsSkillsUnpublishRpc, WsAssetsReadRpc, WsAssetsSaveRpc, WsAssetsDeleteRpc, WsAssetsCreateLocalRpc, WsAssetsRemoveLocalRpc, WsMcpListRpc, WsMcpSaveRpc, WsMcpRemoveRpc, WsMcpSetSecretRpc, WsOrchestrationDispatchCommandRpc, WsOrchestrationGetTurnDiffRpc, WsOrchestrationGetFullThreadDiffRpc, WsOrchestrationGetArchivedShellSnapshotRpc, WsOrchestrationSubscribeShellRpc, WsOrchestrationSubscribeThreadRpc);
 //#endregion
 //#region ../../packages/shared/src/oauthScope.ts
 const OAUTH_SCOPE_TOKEN = /^[\u0021\u0023-\u005b\u005d-\u007e]+$/u;
@@ -32144,6 +32155,34 @@ const make$37 = Effect.fn("ProviderMaintenanceRunner.make")(function* () {
 });
 const layer$32 = Layer.effect(ProviderMaintenanceRunner, make$37());
 //#endregion
+//#region src/provider/Services/ProviderInstanceRegistry.ts
+var ProviderInstanceRegistry = class extends Context.Service()("@p4code/cli/provider/Services/ProviderInstanceRegistry") {};
+//#endregion
+//#region src/textGeneration/TextGeneration.ts
+/**
+* TextGeneration - Service tag for commit and change request text generation.
+*/
+var TextGeneration = class extends Context.Service()("@p4code/cli/textGeneration/TextGeneration") {};
+const resolveInstance = (registry, operation, instanceId) => registry.getInstance(instanceId).pipe(Effect.flatMap((instance) => instance ? Effect.succeed(instance.textGeneration) : Effect.fail(new TextGenerationError({
+	operation,
+	detail: `No provider instance registered for id '${instanceId}'.`
+}))));
+const makeTextGenerationFromRegistry = (registry) => TextGeneration.of({
+	generateCommitMessage: (input) => resolveInstance(registry, "generateCommitMessage", input.modelSelection.instanceId).pipe(Effect.flatMap((textGeneration) => textGeneration.generateCommitMessage(input))),
+	generatePrContent: (input) => resolveInstance(registry, "generatePrContent", input.modelSelection.instanceId).pipe(Effect.flatMap((textGeneration) => textGeneration.generatePrContent(input))),
+	generateBranchName: (input) => resolveInstance(registry, "generateBranchName", input.modelSelection.instanceId).pipe(Effect.flatMap((textGeneration) => textGeneration.generateBranchName(input))),
+	generateThreadTitle: (input) => resolveInstance(registry, "generateThreadTitle", input.modelSelection.instanceId).pipe(Effect.flatMap((textGeneration) => textGeneration.generateThreadTitle(input))),
+	getUsageReport: (input) => resolveInstance(registry, "getUsageReport", input.instanceId).pipe(Effect.flatMap((textGeneration) => textGeneration.getUsageReport ? textGeneration.getUsageReport(input) : Effect.fail(new TextGenerationError({
+		operation: "getUsageReport",
+		detail: "This provider does not report account usage."
+	}))))
+});
+const make$36 = Effect.gen(function* () {
+	const registry = yield* ProviderInstanceRegistry;
+	return makeTextGenerationFromRegistry(registry);
+});
+const layer$31 = Layer.effect(TextGeneration, make$36);
+//#endregion
 //#region ../../packages/shared/src/KeyedCoalescingWorker.ts
 const makeKeyedCoalescingWorker = (options) => Effect.gen(function* () {
 	const queue = yield* Effect.acquireRelease(TxQueue.unbounded(), TxQueue.shutdown);
@@ -32441,7 +32480,7 @@ const serversEqual = (left, right) => {
 	}
 	return true;
 };
-const make$36 = Effect.gen(function* PortDiscoveryMake() {
+const make$35 = Effect.gen(function* PortDiscoveryMake() {
 	const net = yield* NetService;
 	const processRunner = yield* ProcessRunner;
 	const hostPlatform = yield* HostProcessPlatform;
@@ -32592,7 +32631,7 @@ const make$36 = Effect.gen(function* PortDiscoveryMake() {
 		unregisterTerminal
 	});
 }).pipe(Effect.withSpan("PortDiscovery.make"));
-const layer$31 = Layer.effect(PortDiscovery, make$36);
+const layer$30 = Layer.effect(PortDiscovery, make$35);
 //#endregion
 //#region src/terminal/Manager.ts
 /**
@@ -33270,7 +33309,7 @@ function normalizedRuntimeEnv(env) {
 	if (entries.length === 0) return null;
 	return Object.fromEntries(entries.toSorted(([left], [right]) => left.localeCompare(right)));
 }
-const make$35 = Effect.fn("TerminalManager.make")(function* () {
+const make$34 = Effect.fn("TerminalManager.make")(function* () {
 	const { terminalLogsDir } = yield* ServerConfig$1;
 	const ptyAdapter = yield* PtyAdapter;
 	const portDiscovery = yield* PortDiscovery;
@@ -34232,7 +34271,7 @@ const makeWithOptions$1 = Effect.fn("TerminalManager.makeWithOptions")(function*
 		subscribeMetadata
 	});
 });
-const layer$30 = Layer.effect(TerminalManager, make$35()).pipe(Layer.provide(layer$52));
+const layer$29 = Layer.effect(TerminalManager, make$34()).pipe(Layer.provide(layer$52));
 //#endregion
 //#region src/mcp/McpInvocationContext.ts
 var McpInvocationContext = class extends Context.Service()("@p4code/cli/mcp/McpInvocationContext") {};
@@ -34380,7 +34419,7 @@ const classifyResponseError = (context, error) => {
 		});
 	}
 };
-const make$34 = Effect.gen(function* PreviewAutomationBrokerMake() {
+const make$33 = Effect.gen(function* PreviewAutomationBrokerMake() {
 	const crypto = yield* Crypto.Crypto;
 	const state = yield* SynchronizedRef.make({
 		clients: /* @__PURE__ */ new Map(),
@@ -34614,7 +34653,7 @@ const make$34 = Effect.gen(function* PreviewAutomationBrokerMake() {
 		invoke
 	});
 }).pipe(Effect.withSpan("PreviewAutomationBroker.make"));
-const layer$29 = Layer.effect(PreviewAutomationBroker, make$34);
+const layer$28 = Layer.effect(PreviewAutomationBroker, make$33);
 //#endregion
 //#region src/preview/Manager.ts
 /**
@@ -34678,7 +34717,7 @@ const buildIdleSnapshot = (input) => ({
 	viewport: FILL_PREVIEW_VIEWPORT,
 	updatedAt: input.updatedAt
 });
-const make$33 = Effect.gen(function* PreviewManagerMake() {
+const make$32 = Effect.gen(function* PreviewManagerMake() {
 	const serverEpoch = NodeCrypto.randomUUID();
 	const stateRef = yield* SynchronizedRef.make(initialState);
 	const eventsPubSub = yield* PubSub.unbounded();
@@ -34909,7 +34948,7 @@ const make$33 = Effect.gen(function* PreviewManagerMake() {
 		subscribeEvents: PubSub.subscribe(eventsPubSub)
 	});
 }).pipe(Effect.withSpan("PreviewManager.make"));
-const layer$28 = Layer.effect(PreviewManager, make$33);
+const layer$27 = Layer.effect(PreviewManager, make$32);
 //#endregion
 //#region src/workspace/WorkspaceSearchIndex.ts
 const WORKSPACE_INDEX_MAX_ENTRIES = 25e3;
@@ -35043,7 +35082,7 @@ const waitForScan = (cwd, finder, onFailure) => Effect.try({
 		timeout: WORKSPACE_INDEX_SCAN_TIMEOUT
 	})
 }), Effect.withSpan("WorkspaceSearchIndex.waitForScan"));
-const make$32 = Effect.fn("WorkspaceSearchIndex.make")(function* (cwd) {
+const make$31 = Effect.fn("WorkspaceSearchIndex.make")(function* (cwd) {
 	const finder = yield* Effect.acquireRelease(createFinder(cwd), (finder) => Effect.try({
 		try: () => finder.destroy(),
 		catch: (cause) => new WorkspaceSearchIndexDestroyFailed({
@@ -35117,9 +35156,9 @@ const make$32 = Effect.fn("WorkspaceSearchIndex.make")(function* (cwd) {
 * workspace root. WorkspaceSearchIndexMap owns memoization and idle cleanup;
 * using a default cwd here would mix resources from different workspaces.
 */
-const layer$27 = (cwd) => Layer.effect(WorkspaceSearchIndex, make$32(cwd));
+const layer$26 = (cwd) => Layer.effect(WorkspaceSearchIndex, make$31(cwd));
 var WorkspaceSearchIndexMap = class extends LayerMap.Service()("@p4code/cli/workspace/WorkspaceSearchIndexMap", {
-	lookup: layer$27,
+	lookup: layer$26,
 	idleTimeToLive: WORKSPACE_INDEX_IDLE_TTL
 }) {};
 //#endregion
@@ -35181,7 +35220,7 @@ const resolveBrowseTarget = Effect.fn("WorkspaceEntries.resolveBrowseTarget")(fu
 	if (!input.cwd) return yield* new WorkspaceEntriesCurrentProjectRequiredError({ partialPath: input.partialPath });
 	return path.resolve(expandHomePath$1(input.cwd, path), input.partialPath);
 });
-const make$31 = Effect.gen(function* () {
+const make$30 = Effect.gen(function* () {
 	const path = yield* Path.Path;
 	const workspacePaths = yield* WorkspacePaths;
 	const workspaceSearchIndexes = yield* WorkspaceSearchIndexMap;
@@ -35255,7 +35294,7 @@ const make$31 = Effect.gen(function* () {
 		search
 	});
 });
-const layer$26 = Layer.effect(WorkspaceEntries, make$31).pipe(Layer.provide(WorkspaceSearchIndexMap.layer));
+const layer$25 = Layer.effect(WorkspaceEntries, make$30).pipe(Layer.provide(WorkspaceSearchIndexMap.layer));
 //#endregion
 //#region src/workspace/WorkspaceFileSystem.ts
 /**
@@ -35324,7 +35363,7 @@ Schema$1.Union([
 ]);
 /** Service tag for workspace file operations. */
 var WorkspaceFileSystem = class extends Context.Service()("@p4code/cli/workspace/WorkspaceFileSystem") {};
-const make$30 = Effect.gen(function* () {
+const make$29 = Effect.gen(function* () {
 	const fileSystem = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
 	const workspacePaths = yield* WorkspacePaths;
@@ -35456,31 +35495,7 @@ const make$30 = Effect.gen(function* () {
 		writeFile
 	});
 });
-const layer$25 = Layer.effect(WorkspaceFileSystem, make$30);
-//#endregion
-//#region src/provider/Services/ProviderInstanceRegistry.ts
-var ProviderInstanceRegistry = class extends Context.Service()("@p4code/cli/provider/Services/ProviderInstanceRegistry") {};
-//#endregion
-//#region src/textGeneration/TextGeneration.ts
-/**
-* TextGeneration - Service tag for commit and change request text generation.
-*/
-var TextGeneration = class extends Context.Service()("@p4code/cli/textGeneration/TextGeneration") {};
-const resolveInstance = (registry, operation, instanceId) => registry.getInstance(instanceId).pipe(Effect.flatMap((instance) => instance ? Effect.succeed(instance.textGeneration) : Effect.fail(new TextGenerationError({
-	operation,
-	detail: `No provider instance registered for id '${instanceId}'.`
-}))));
-const makeTextGenerationFromRegistry = (registry) => TextGeneration.of({
-	generateCommitMessage: (input) => resolveInstance(registry, "generateCommitMessage", input.modelSelection.instanceId).pipe(Effect.flatMap((textGeneration) => textGeneration.generateCommitMessage(input))),
-	generatePrContent: (input) => resolveInstance(registry, "generatePrContent", input.modelSelection.instanceId).pipe(Effect.flatMap((textGeneration) => textGeneration.generatePrContent(input))),
-	generateBranchName: (input) => resolveInstance(registry, "generateBranchName", input.modelSelection.instanceId).pipe(Effect.flatMap((textGeneration) => textGeneration.generateBranchName(input))),
-	generateThreadTitle: (input) => resolveInstance(registry, "generateThreadTitle", input.modelSelection.instanceId).pipe(Effect.flatMap((textGeneration) => textGeneration.generateThreadTitle(input)))
-});
-const make$29 = Effect.gen(function* () {
-	const registry = yield* ProviderInstanceRegistry;
-	return makeTextGenerationFromRegistry(registry);
-});
-const layer$24 = Layer.effect(TextGeneration, make$29);
+const layer$24 = Layer.effect(WorkspaceFileSystem, make$29);
 //#endregion
 //#region src/textGeneration/TextGenerationPresets.ts
 const conventionalCommitsTextGenerationPolicy = {
@@ -41295,6 +41310,7 @@ const RPC_REQUIRED_SCOPE = /* @__PURE__ */ new Map([
 	[WS_METHODS.serverProbe, AuthOrchestrationReadScope],
 	[WS_METHODS.serverGetConfig, AuthOrchestrationReadScope],
 	[WS_METHODS.serverRefreshProviders, AuthOrchestrationOperateScope],
+	[WS_METHODS.serverGetProviderUsage, AuthOrchestrationReadScope],
 	[WS_METHODS.serverUpdateProvider, AuthOrchestrationOperateScope],
 	[WS_METHODS.serverUpdateServer, AuthOrchestrationOperateScope],
 	[WS_METHODS.serverUpsertKeybinding, AuthOrchestrationOperateScope],
@@ -41431,6 +41447,7 @@ const makeWsRpcLayer = (currentSession, previewAutomationBroker) => WsRpcGroup.t
 	const providerRegistry = yield* ProviderRegistry;
 	const providerMaintenanceRunner = yield* ProviderMaintenanceRunner;
 	const serverSelfUpdate = yield* ServerSelfUpdate;
+	const textGeneration = yield* TextGeneration;
 	const config = yield* ServerConfig$1;
 	const lifecycleEvents = yield* ServerLifecycleEvents;
 	const serverSettings = yield* ServerSettingsService;
@@ -41865,6 +41882,10 @@ const makeWsRpcLayer = (currentSession, previewAutomationBroker) => WsRpcGroup.t
 		[WS_METHODS.serverProbe]: (_input) => observeRpcEffect$1(WS_METHODS.serverProbe, Effect.succeed({}), { "rpc.aggregate": "server" }),
 		[WS_METHODS.serverGetConfig]: (_input) => observeRpcEffect$1(WS_METHODS.serverGetConfig, loadServerConfig, { "rpc.aggregate": "server" }),
 		[WS_METHODS.serverRefreshProviders]: (input) => observeRpcEffect$1(WS_METHODS.serverRefreshProviders, (input.instanceId !== void 0 ? providerRegistry.refreshInstance(input.instanceId) : providerRegistry.refresh()).pipe(Effect.map((providers) => ({ providers }))), { "rpc.aggregate": "server" }),
+		[WS_METHODS.serverGetProviderUsage]: (input) => observeRpcEffect$1(WS_METHODS.serverGetProviderUsage, textGeneration.getUsageReport ? textGeneration.getUsageReport(input) : Effect.fail(new TextGenerationError({
+			operation: "getUsageReport",
+			detail: "This provider does not report account usage."
+		})), { "rpc.aggregate": "server" }),
 		[WS_METHODS.serverUpdateProvider]: (input) => observeRpcEffect$1(WS_METHODS.serverUpdateProvider, providerMaintenanceRunner.updateProvider(input), { "rpc.aggregate": "server" }),
 		[WS_METHODS.serverUpdateServer]: (input) => observeRpcEffect$1(WS_METHODS.serverUpdateServer, serverSelfUpdate.update(input), { "rpc.aggregate": "server" }),
 		[WS_METHODS.serverUpsertKeybinding]: (rule) => observeRpcEffect$1(WS_METHODS.serverUpsertKeybinding, Effect.gen(function* () {
@@ -45355,13 +45376,21 @@ const makePendingClaudeProvider = (claudeSettings) => Effect.gen(function* () {
 * @module ClaudeTextGeneration
 */
 const CLAUDE_TIMEOUT_MS = 18e4;
+/** The usage report is a local lookup, so it should return in seconds, not minutes. */
+const USAGE_REPORT_TIMEOUT_MS = 6e4;
 /**
 * Schema for the wrapper JSON returned by `claude -p --output-format json`.
 * We only care about `structured_output`.
 */
 const ClaudeOutputEnvelope = Schema$1.Struct({ structured_output: Schema$1.Unknown });
+/**
+* `claude -p "/usage"` answers with the plain report in `result`. `/usage` is a
+* CLI-local command, so this costs no turn and no tokens.
+*/
+const ClaudeResultEnvelope = Schema$1.Struct({ result: Schema$1.String });
 const encodeJsonString$2 = Schema$1.encodeEffect(Schema$1.UnknownFromJsonString);
 const decodeClaudeOutputEnvelope = Schema$1.decodeEffect(Schema$1.fromJsonString(ClaudeOutputEnvelope));
+const decodeClaudeResultEnvelope = Schema$1.decodeEffect(Schema$1.fromJsonString(ClaudeResultEnvelope));
 const makeClaudeTextGeneration = Effect.fn("makeClaudeTextGeneration")(function* (claudeSettings, environment) {
 	const commandSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
 	const claudeEnvironment = yield* makeClaudeEnvironment(claudeSettings, environment);
@@ -45518,6 +45547,46 @@ const makeClaudeTextGeneration = Effect.fn("makeClaudeTextGeneration")(function*
 				outputSchemaJson: outputSchema,
 				modelSelection: input.modelSelection
 			})).title) };
+		}),
+		getUsageReport: Effect.fn("ClaudeTextGeneration.getUsageReport")(function* () {
+			const operation = "getUsageReport";
+			const rawStdout = yield* Effect.fn("ClaudeTextGeneration.getUsageReport.run")(function* () {
+				const spawnCommand = yield* resolveSpawnCommand(claudeSettings.binaryPath || "claude", [
+					"-p",
+					"/usage",
+					"--output-format",
+					"json"
+				], { env: claudeEnvironment });
+				const command = ChildProcess.make(spawnCommand.command, spawnCommand.args, {
+					env: claudeEnvironment,
+					shell: spawnCommand.shell
+				});
+				const child = yield* commandSpawner.spawn(command).pipe(Effect.mapError((cause) => normalizeCliError("claude", operation, cause, "Failed to spawn Claude CLI process")));
+				const [stdout, stderr, exitCode] = yield* Effect.all([
+					readStreamAsString(operation, child.stdout),
+					readStreamAsString(operation, child.stderr),
+					child.exitCode.pipe(Effect.mapError((cause) => normalizeCliError("claude", operation, cause, "Failed to read Claude CLI exit code")))
+				], { concurrency: "unbounded" });
+				if (exitCode !== 0) {
+					const detail = stderr.trim().length > 0 ? stderr.trim() : stdout.trim();
+					return yield* new TextGenerationError({
+						operation,
+						detail: detail.length > 0 ? `Claude CLI command failed: ${detail}` : `Claude CLI command failed with code ${exitCode}.`
+					});
+				}
+				return stdout;
+			})().pipe(Effect.scoped, Effect.timeoutOption(USAGE_REPORT_TIMEOUT_MS), Effect.flatMap(Option.match({
+				onNone: () => Effect.fail(new TextGenerationError({
+					operation,
+					detail: "Claude CLI request timed out."
+				})),
+				onSome: (value) => Effect.succeed(value)
+			})));
+			return { report: (yield* decodeClaudeResultEnvelope(rawStdout).pipe(Effect.catchTags({ SchemaError: (cause) => Effect.fail(new TextGenerationError({
+				operation,
+				detail: "Claude CLI returned unexpected output format.",
+				cause
+			})) }))).result.trim() };
 		})
 	};
 });
@@ -83535,18 +83604,18 @@ const ProviderLayerLive = ProviderServiceLive.pipe(Layer.provide(ProviderAdapter
 const PersistenceLayerLive = Layer.empty.pipe(Layer.provideMerge(layerConfig));
 const VcsDriverRegistryLayerLive = layer$35.pipe(Layer.provide(layer$36));
 const SourceControlProviderRegistryLayerLive = layer$14.pipe(Layer.provide(Layer.mergeAll(layer$22, layer$20, layer$18, layer$16)), Layer.provideMerge(layer$37), Layer.provideMerge(VcsDriverRegistryLayerLive));
-const GitManagerLayerLive = layer$13.pipe(Layer.provideMerge(layer$23), Layer.provideMerge(layer$37), Layer.provideMerge(SourceControlProviderRegistryLayerLive), Layer.provideMerge(layer$24));
+const GitManagerLayerLive = layer$13.pipe(Layer.provideMerge(layer$23), Layer.provideMerge(layer$37), Layer.provideMerge(SourceControlProviderRegistryLayerLive), Layer.provideMerge(layer$31));
 const GitLayerLive = Layer.empty.pipe(Layer.provideMerge(GitManagerLayerLive), Layer.provideMerge(layer$37));
 const GitWorkflowLayerLive = layer$12.pipe(Layer.provideMerge(VcsDriverRegistryLayerLive), Layer.provideMerge(GitLayerLive));
 const SourceControlRepositoryServiceLayerLive = layer$4.pipe(Layer.provideMerge(layer$37), Layer.provideMerge(SourceControlProviderRegistryLayerLive));
 const ReviewLayerLive = layer$9.pipe(Layer.provideMerge(layer$37), Layer.provideMerge(VcsDriverRegistryLayerLive));
 const VcsLayerLive = Layer.empty.pipe(Layer.provideMerge(layer$36), Layer.provideMerge(VcsDriverRegistryLayerLive), Layer.provideMerge(layer$10.pipe(Layer.provide(VcsDriverRegistryLayerLive))), Layer.provideMerge(GitWorkflowLayerLive), Layer.provideMerge(ReviewLayerLive), Layer.provideMerge(SourceControlRepositoryServiceLayerLive), Layer.provideMerge(layer$11.pipe(Layer.provide(GitWorkflowLayerLive))));
 const CheckpointingLayerLive = Layer.empty.pipe(Layer.provideMerge(layer$33), Layer.provideMerge(layer$34.pipe(Layer.provide(VcsDriverRegistryLayerLive))));
-const PortScannerLayerLive = layer$31.pipe(Layer.provide(layer$52));
-const TerminalLayerLive = layer$30.pipe(Layer.provide(PtyAdapterLive), Layer.provide(PortScannerLayerLive));
-const PreviewLayerLive = Layer.empty.pipe(Layer.provideMerge(layer$28), Layer.provideMerge(PortScannerLayerLive));
-const WorkspaceEntriesLayerLive = layer$26.pipe(Layer.provide(layer$42));
-const WorkspaceFileSystemLayerLive = layer$25.pipe(Layer.provide(layer$42), Layer.provide(WorkspaceEntriesLayerLive));
+const PortScannerLayerLive = layer$30.pipe(Layer.provide(layer$52));
+const TerminalLayerLive = layer$29.pipe(Layer.provide(PtyAdapterLive), Layer.provide(PortScannerLayerLive));
+const PreviewLayerLive = Layer.empty.pipe(Layer.provideMerge(layer$27), Layer.provideMerge(PortScannerLayerLive));
+const WorkspaceEntriesLayerLive = layer$25.pipe(Layer.provide(layer$42));
+const WorkspaceFileSystemLayerLive = layer$24.pipe(Layer.provide(layer$42), Layer.provide(WorkspaceEntriesLayerLive));
 const WorkspaceLayerLive = Layer.mergeAll(layer$42, WorkspaceEntriesLayerLive, WorkspaceFileSystemLayerLive);
 const ProjectFaviconResolverLayerLive = layer$40.pipe(Layer.provide(layer$42), Layer.provide(layer$41));
 const AuthLayerLive = layer$60.pipe(Layer.provideMerge(PersistenceLayerLive), Layer.provide(layer$64));
@@ -83561,7 +83630,7 @@ const RuntimeDependenciesLive = ReactorLayerLive.pipe(Layer.provideMerge(Checkpo
 */
 const AssetSyncLive = layer$53.pipe(Layer.provideMerge(layer$54), Layer.provideMerge(layer$55));
 const RuntimeServicesLive = layer$43.pipe(Layer.provideMerge(AssetSyncLive), Layer.provideMerge(RuntimeDependenciesLive));
-const makeRoutesLayer = Layer.mergeAll(Layer.mergeAll(HttpApiBuilder.layer(EnvironmentHttpApi).pipe(Layer.provide(authHttpApiLayer), Layer.provide(orchestrationHttpApiLayer), Layer.provide(serverEnvironmentHttpApiLayer), Layer.provide(environmentAuthenticatedAuthLayer)), otlpTracesProxyRouteLayer, assetRouteLayer, staticAndDevRouteLayer, websocketRpcRouteLayer), layer.pipe(Layer.provide(layer$2))).pipe(Layer.provide(TaskRepositoryLive.pipe(Layer.provide(PersistenceLayerLive))), Layer.provide(ProjectionProjectRepositoryLive.pipe(Layer.provide(PersistenceLayerLive))), Layer.provide(layer$29), Layer.provide(layer$45), Layer.provide(browserApiCorsLayer), Layer.provide(httpCompressionLayer));
+const makeRoutesLayer = Layer.mergeAll(Layer.mergeAll(HttpApiBuilder.layer(EnvironmentHttpApi).pipe(Layer.provide(authHttpApiLayer), Layer.provide(orchestrationHttpApiLayer), Layer.provide(serverEnvironmentHttpApiLayer), Layer.provide(environmentAuthenticatedAuthLayer)), otlpTracesProxyRouteLayer, assetRouteLayer, staticAndDevRouteLayer, websocketRpcRouteLayer), layer.pipe(Layer.provide(layer$2))).pipe(Layer.provide(TaskRepositoryLive.pipe(Layer.provide(PersistenceLayerLive))), Layer.provide(ProjectionProjectRepositoryLive.pipe(Layer.provide(PersistenceLayerLive))), Layer.provide(layer$28), Layer.provide(layer$45), Layer.provide(browserApiCorsLayer), Layer.provide(httpCompressionLayer));
 const makeServerLayer = Layer.unwrap(Effect.gen(function* () {
 	const config = yield* ServerConfig$1;
 	yield* fixPath();