@xopcai/xopc 0.0.334 → 0.0.335

package/dist/src/agent/orchestration/agent-orchestrator.js

@@ -3,7 +3,6 @@ import { init_logger } from "../../utils/logger.js";
 import { abortEmbeddedRun } from "../embedded/runs.js";
 import { persistInboundAttachments } from "../../channels/attachments/inbound-persist.js";
 import { buildTranscriptUserMessage, clearPendingTranscriptUserMessage, hydrateUserTurnForLlm, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
-import { extractAgentUserPlainText } from "../memory/user-message-text.js";
 import { resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
 import { randomUUID } from "node:crypto";
@@ -68,7 +67,6 @@ var AgentOrchestrator = class {
 				agentManager: this.agentManager
 			});
 			setPendingTranscriptUserMessage(conversationId, userMessage);
-			const userPlainForMemory = extractAgentUserPlainText(userMessage);
 			const turnId = randomUUID();
 			const userContext = await this.agentManager.prepareUserTurnContext(userMessage, conversationId, turnId);
 			const userMessageForModel = userMessage;
@@ -96,7 +94,6 @@ var AgentOrchestrator = class {
 					clearPendingTranscriptUserMessage(conversationId, userMessage);
 				}
 			})();
-			this.agentManager.scheduleUserUnderstandingMaintenance(conversationId, userPlainForMemory, turnId);
 			this.agentManager.scheduleBackgroundReviewAfterUserTurn(conversationId);
 			if (turnResult.ok) {
 				this.onEmbeddedTurnComplete?.(conversationId, turnResult.lastAssistantText);

package/dist/src/agent/service/direct-turn-helpers.js

@@ -3,7 +3,6 @@ import { getConnectionResumeInput, init_connection_wait_repository } from "../..
 import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
 import { hydrateUserTurnForLlm } from "../inbound/attachment-pipeline.js";
 import { buildTaskExecutionDirective } from "../../tasks/task-context-assembler.js";
-import { extractAgentUserPlainText } from "../memory/user-message-text.js";
 import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
 import { parseSlashCommand } from "../../chat-commands/command-parse.js";
 import { commandRegistry } from "../../chat-commands/registry.js";
@@ -99,7 +98,6 @@ async function runDirectAgentTurn(deps, input) {
 	const isConnectionResume = Boolean(getConnectionResumeInput(input.conversationId, turnId));
 	const isClarificationResume = Boolean(getClarificationResumeInput(input.conversationId, turnId));
 	const isResume = isConnectionResume || isClarificationResume;
-	const userPlain = extractAgentUserPlainText(input.userMessage);
 	const userContext = await deps.agentManager.prepareUserTurnContext(input.userMessage, input.conversationId, turnId);
 	const sourceContexts = input.sourceContexts ?? [];
 	const userMessageForModel = prependAgentContext(injectSourceContextsIntoUserMessage(input.userMessage, sourceContexts), buildTaskExecutionDirective(input.conversationId));
@@ -127,7 +125,6 @@ async function runDirectAgentTurn(deps, input) {
 		beforeTurn: isResume ? void 0 : () => deps.agentManager.beginBackgroundReviewUserTurn(input.conversationId),
 		onEvent: input.onEvent
 	});
-	if (!isResume) deps.agentManager.scheduleUserUnderstandingMaintenance(input.conversationId, userPlain, turnId);
 	if (!isResume && result.stopReason !== "connection_required" && result.stopReason !== "clarification_required") deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.conversationId);
 	return result;
 }

package/dist/src/automations/events/event-dispatcher.d.ts

@@ -1,5 +1,12 @@
-import type { AutomationEventEnvelope, AutomationRun } from '../domain/types.js';
-import type { AutomationService } from '../service/automation-service.js';
+import type { AutomationEvent, AutomationEventEnvelope, AutomationRun } from '../domain/types.js';
+export interface AutomationEventDispatchService {
+    availableRunSlots(): number;
+    queueRunAtomically(id: string, opts: {
+        manual: boolean;
+        event?: AutomationEvent;
+    }): AutomationRun;
+    dispatchQueuedRun(runId: string): void;
+}
 export declare class AutomationEventDispatcher {
     private readonly automationService;
     private readonly options;
@@ -8,7 +15,7 @@ export declare class AutomationEventDispatcher {
     private stopping;
     private readonly owner;
     private readonly abortController;
-    constructor(automationService: AutomationService, options?: {
+    constructor(automationService: AutomationEventDispatchService, options?: {
         onEvent?: (event: AutomationEventEnvelope, signal?: AbortSignal) => void | Promise<void>;
         onDeadLetter?: (input: {
             phase: 'event_projection' | 'event_delivery';

package/dist/src/automations/service/automation-service.js

@@ -9,7 +9,6 @@ import { getAutomationEventDeliveryRunId, getAutomationEventForRun, getAutomatio
 import { computeNextAutomationRunAtMs, timerDelayUntil } from "../domain/schedule.js";
 import { AutomationActionExecutor } from "./action-executor.js";
 import { AutomationEventDispatcher } from "../events/event-dispatcher.js";
-import "../events/index.js";
 import { AutomationDeliveryRouter, getAutomationResultDeliveryMetrics, listAutomationResultDeliveries, retryAutomationResultDelivery } from "../delivery/delivery-router.js";
 import "../delivery/index.js";
 import { randomUUID } from "node:crypto";

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

@@ -3,6 +3,7 @@ import { SessionDiscoveryQuerySchema } from "../../../../packages/gateway-contra
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import "../../../session/types.js";
 import { SidebarLayoutConflictError, getSidebarLayout, init_sidebar_layout_repository, replaceSidebarLayout, sortBySidebarLayout } from "../../../storage/sqlite/sidebar-layout-repository.js";
+import { summarizeAiUsageByConversations } from "../../../storage/sqlite/ai-usage-repository.js";
 import { messagesToClientHistory } from "../../../session/client-history.js";
 import { evictEmbeddedSessionRunner } from "../../../agent/embedded/session-runner.js";
 import { SessionEnvironmentService } from "../../../execution-environments/session-environment-service.js";
@@ -286,7 +287,20 @@ function registerSessionsRoutes(authenticated, deps) {
 			limit: query.limit ? parseInt(query.limit) : void 0,
 			offset: query.offset ? parseInt(query.offset) : void 0
 		});
-		return c.json(result);
+		const usageByConversation = summarizeAiUsageByConversations(result.items.map((item) => item.key));
+		return c.json({
+			...result,
+			items: result.items.map((item) => ({
+				...item,
+				usage: usageByConversation.get(item.key) ?? {
+					calls: 0,
+					unknownCostCalls: 0,
+					totalTokens: 0,
+					knownCostUsd: "0",
+					costCompleteness: "unknown"
+				}
+			}))
+		});
 	});
 	authenticated.get("/api/sessions/stats", async (c) => {
 		const result = await service.sessions.stats();

package/dist/src/gateway/service/session-preparation-worker.d.ts

@@ -1,4 +1,11 @@
-import type { GatewayService } from '../service.js';
+import type { ProjectService } from '../../projects/project-service.js';
+import type { SessionInputState } from '../../storage/sqlite/session-input-repository.js';
+export interface SessionPreparationWorkerService {
+    projects: Pick<ProjectService, 'get'>;
+    drainSessionInputs(conversationId: string): Promise<unknown>;
+    getSessionInputState(conversationId: string): SessionInputState;
+    emit(type: string, payload: unknown): void;
+}
 export declare class SessionPreparationWorker {
     private readonly service;
     private timer?;
@@ -6,7 +13,7 @@ export declare class SessionPreparationWorker {
     private cleaning;
     private cleanupTask?;
     private readonly environments;
-    constructor(service: GatewayService);
+    constructor(service: SessionPreparationWorkerService);
     start(): void;
     stop(): Promise<void>;
     wake(conversationId: string): void;

package/dist/src/gateway/service.js

@@ -79,14 +79,14 @@ import "../knowledge/index.js";
 import { ConnectionRecoveryService } from "../connectors/connection-recovery-service.js";
 import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
 import { startConnectorSupervisor } from "../connectors/supervisor.js";
+import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
+import "../endpoint-tools/index.js";
 import { DiscussionService } from "../discussions/service.js";
 import { DiscussionOrganizer } from "../discussions/organizer.js";
 import { DiscussionLiveWorker } from "../discussions/live-worker.js";
 import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
 import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
-import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
-import "../endpoint-tools/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
 import { stopTailscaleExposure } from "./tailscale-lifecycle.js";
@@ -143,8 +143,8 @@ import { createGatewayStartupTrace } from "./startup-trace.js";
 import { GatewaySceneHost } from "./scenes/host.js";
 import { checkAppContextAccess, prepareAppContext } from "./service/app-context-access.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.js";
-import { HomeIntelligenceHost } from "../home-intelligence/host.js";
 import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
+import { HomeIntelligenceHost } from "../home-intelligence/host.js";
 import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
 import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
 import crypto from "node:crypto";

package/dist/src/home-intelligence/generator.d.ts

@@ -118,8 +118,15 @@ export interface HomeModelGeneration {
         estimatedCostUsd?: number;
     };
 }
+export interface HomeProviderCallBudget {
+    allowProviderCall(): boolean;
+}
+export declare class HomeAdviceBudgetExceededError extends Error {
+    readonly usage: HomeModelGeneration['usage'];
+    constructor(usage?: HomeModelGeneration['usage']);
+}
 export declare class HomeAdviceGenerator {
     private readonly config;
     constructor(config: () => Config);
-    generate(snapshot: HomeContextSnapshot, capabilities: HomeCapabilityInventory, signal?: AbortSignal): Promise<HomeModelGeneration>;
+    generate(snapshot: HomeContextSnapshot, capabilities: HomeCapabilityInventory, signal?: AbortSignal, budget?: HomeProviderCallBudget): Promise<HomeModelGeneration>;
 }

package/dist/src/home-intelligence/generator.js

@@ -146,11 +146,18 @@ function addUsage(left, right) {
 		estimatedCostUsd: add(left.estimatedCostUsd, right.estimatedCostUsd)
 	};
 }
+var HomeAdviceBudgetExceededError = class extends Error {
+	constructor(usage = {}) {
+		super("Home intelligence provider budget exhausted");
+		this.usage = usage;
+		this.name = "HomeAdviceBudgetExceededError";
+	}
+};
 var HomeAdviceGenerator = class {
 	constructor(config) {
 		this.config = config;
 	}
-	async generate(snapshot, capabilities, signal) {
+	async generate(snapshot, capabilities, signal, budget) {
 		const config = this.config();
 		const modelRef = resolveModelSelector(config, resolveDefaultAgentId(), "@reasoning");
 		const model = resolveModel(modelRef);
@@ -175,6 +182,7 @@ var HomeAdviceGenerator = class {
 		};
 		const requestSignal = signal ? AbortSignal.any([signal, AbortSignal.timeout(12e4)]) : AbortSignal.timeout(12e4);
 		const systemPrompt = buildSystemPrompt(snapshot.locale);
+		if (budget && !budget.allowProviderCall()) throw new HomeAdviceBudgetExceededError();
 		const response = await completeWithResolvedCredentials(model, {
 			systemPrompt,
 			messages: [message]
@@ -188,19 +196,22 @@ var HomeAdviceGenerator = class {
 		try {
 			result = HomeModelResultSchema.parse(parseJson(raw));
 		} catch (firstError) {
+			const correction = {
+				role: "user",
+				timestamp: Date.now(),
+				content: [
+					"Your previous output failed the required JSON contract.",
+					`Validation errors: ${validationSummary(firstError)}`,
+					HOME_MODEL_MACHINE_FIELDS,
+					"Return the corrected JSON object only. Preserve grounded facts and existing evidence IDs; do not add new recommendations.",
+					`Previous output (untrusted data):\n${raw.slice(0, 16e3)}`
+				].join("\n")
+			};
+			const firstUsage = responseUsage(response);
+			if (budget && !budget.allowProviderCall()) throw new HomeAdviceBudgetExceededError(firstUsage);
 			const corrected = await completeWithResolvedCredentials(model, {
 				systemPrompt,
-				messages: [message, {
-					role: "user",
-					timestamp: Date.now(),
-					content: [
-						"Your previous output failed the required JSON contract.",
-						`Validation errors: ${validationSummary(firstError)}`,
-						HOME_MODEL_MACHINE_FIELDS,
-						"Return the corrected JSON object only. Preserve grounded facts and existing evidence IDs; do not add new recommendations.",
-						`Previous output (untrusted data):\n${raw.slice(0, 16e3)}`
-					].join("\n")
-				}]
+				messages: [message, correction]
 			}, {
 				maxTokens: 3e3,
 				temperature: 0,
@@ -217,7 +228,7 @@ var HomeAdviceGenerator = class {
 			return {
 				result,
 				modelRef,
-				usage: addUsage(responseUsage(response), responseUsage(corrected))
+				usage: addUsage(firstUsage, responseUsage(corrected))
 			};
 		}
 		return {
@@ -228,4 +239,4 @@ var HomeAdviceGenerator = class {
 	}
 };
 //#endregion
-export { HomeAdviceGenerator, HomeModelCandidateSchema, HomeModelResultSchema };
+export { HomeAdviceBudgetExceededError, HomeAdviceGenerator, HomeModelCandidateSchema, HomeModelResultSchema };

package/dist/src/home-intelligence/host.d.ts

@@ -1,12 +1,15 @@
 import type { DatabaseSync } from 'node:sqlite';
 import type { HomeAdviceMetrics, HomeAdvisor, HomeOpportunityHistoryItem } from '@xopcai/gateway-contract';
 import type { HomeOpportunityActionRequest, HomeOpportunityActionResponse, HomeOpportunityFeedbackRequest } from '@xopcai/gateway-contract';
-import type { HomeAdviceGenerator } from './generator.js';
+import { type HomeAdviceGenerator } from './generator.js';
 import { type HomeGenerationReason, type HomePrincipal } from './repository.js';
 import { HomeSnapshotBuilder } from './snapshot.js';
 import type { HomeCapabilityInventory } from './types.js';
 import { type HomeOpportunityNotification } from './notification.js';
 import type { HomeCapabilityRequirement, HomeCapabilityResolution } from './capability-preflight.js';
+export declare const HOME_CONTEXT_REFRESH_COOLDOWN_MS: number;
+export declare const DAILY_HOME_PROVIDER_CALL_BUDGET = 12;
+export declare const DAILY_HOME_TOKEN_BUDGET = 120000;
 export interface HomeIntelligenceHostDeps {
     principal: HomePrincipal;
     snapshot: HomeSnapshotBuilder;
@@ -32,6 +35,8 @@ export declare class HomeIntelligenceHost {
     private stopped;
     private abortController;
     private localeHint;
+    private contextRefreshTimer?;
+    private readonly pendingContextReasons;
     constructor(db: DatabaseSync, deps: HomeIntelligenceHostDeps);
     start(): void;
     stop(): void;
@@ -39,6 +44,8 @@ export declare class HomeIntelligenceHost {
     getMetrics(since?: number): HomeAdviceMetrics;
     getHistory(): HomeOpportunityHistoryItem[];
     requestRefresh(reason: HomeGenerationReason, idempotencyKey?: string, locale?: string): string;
+    private currentFingerprint;
+    private scheduleContextRefresh;
     sourceChanged(input: {
         sourceInstanceId: string;
         revision: string;

package/dist/src/home-intelligence/host.js

@@ -1,5 +1,6 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { HomeAdviceBudgetExceededError } from "./generator.js";
 import { homePatternKey } from "./strategy.js";
 import { HomeAdvicePolicy } from "./policy.js";
 import { HomeIntelligenceRepository } from "./repository.js";
@@ -11,7 +12,16 @@ init_logger();
 const log = createLogger("HomeIntelligence");
 const POLL_INTERVAL_MS = 5e3;
 const GENERATION_LEASE_MS = 5 * 6e4;
-const DAILY_MODEL_GENERATION_BUDGET = 12;
+const HOME_CONTEXT_REFRESH_COOLDOWN_MS = 30 * 6e4;
+const DAILY_HOME_PROVIDER_CALL_BUDGET = 12;
+const DAILY_HOME_TOKEN_BUDGET = 12e4;
+const HOME_USAGE_OPERATION = "home.generate_advice";
+const CONTEXT_REFRESH_REASONS = new Set([
+	"project_changed",
+	"task_changed",
+	"connector_changed",
+	"conversation_changed"
+]);
 function generationFingerprint(snapshotHash, capabilities) {
 	return createHash("sha256").update(JSON.stringify({
 		snapshotHash,
@@ -29,6 +39,8 @@ var HomeIntelligenceHost = class {
 	stopped = false;
 	abortController = new AbortController();
 	localeHint;
+	contextRefreshTimer;
+	pendingContextReasons = /* @__PURE__ */ new Set();
 	constructor(db, deps) {
 		this.deps = deps;
 		this.repository = new HomeIntelligenceRepository(db);
@@ -49,6 +61,9 @@ var HomeIntelligenceHost = class {
 		this.abortController = new AbortController();
 		if (this.timer) clearInterval(this.timer);
 		this.timer = void 0;
+		if (this.contextRefreshTimer) clearTimeout(this.contextRefreshTimer);
+		this.contextRefreshTimer = void 0;
+		this.pendingContextReasons.clear();
 	}
 	getAdvisor() {
 		if (this.deps.enabled?.() === false) return { state: "disabled" };
@@ -65,6 +80,16 @@ var HomeIntelligenceHost = class {
 		if (this.deps.enabled?.() === false) return "disabled";
 		const now = this.now();
 		if (locale) this.localeHint = locale.toLowerCase().startsWith("zh") ? "zh" : "en";
+		if (CONTEXT_REFRESH_REASONS.has(reason)) {
+			const fingerprint = this.currentFingerprint(now);
+			if (this.repository.getLatestSnapshotHash(this.deps.principal) === fingerprint) return "unchanged";
+			const lastRequestedAt = this.repository.getLatestContextRefreshRequestedAt(this.deps.principal);
+			if (lastRequestedAt !== void 0 && now < lastRequestedAt + 18e5) {
+				this.pendingContextReasons.add(reason);
+				this.scheduleContextRefresh(lastRequestedAt + HOME_CONTEXT_REFRESH_COOLDOWN_MS - now);
+				return "cooldown";
+			}
+		}
 		const bucket = Math.floor(now / (reason === "manual_refresh" ? 1 : 5 * 6e4));
 		const request = this.repository.enqueue(this.deps.principal, {
 			idempotencyKey: idempotencyKey ?? `${reason}:${bucket}`,
@@ -74,6 +99,32 @@ var HomeIntelligenceHost = class {
 		this.tick();
 		return request.generationId;
 	}
+	currentFingerprint(now) {
+		const successfulPatterns = this.repository.getSuccessfulPatterns(this.deps.principal);
+		return generationFingerprint(this.deps.snapshot.build({
+			now,
+			locale: this.localeHint,
+			successfulPatterns
+		}).hash, this.deps.capabilities());
+	}
+	scheduleContextRefresh(delayMs) {
+		if (this.contextRefreshTimer) return;
+		this.contextRefreshTimer = setTimeout(() => {
+			this.contextRefreshTimer = void 0;
+			if (this.stopped || this.pendingContextReasons.size === 0) return;
+			const reasons = [...this.pendingContextReasons];
+			this.pendingContextReasons.clear();
+			const now = this.now();
+			if (this.repository.getLatestSnapshotHash(this.deps.principal) === this.currentFingerprint(now)) return;
+			this.repository.enqueue(this.deps.principal, {
+				idempotencyKey: `context_refresh:${Math.floor(now / HOME_CONTEXT_REFRESH_COOLDOWN_MS)}`,
+				reasons,
+				requestedAt: now
+			});
+			this.tick();
+		}, Math.max(1, delayMs));
+		this.contextRefreshTimer.unref?.();
+	}
 	sourceChanged(input) {
 		const now = this.now();
 		const invalidated = this.repository.invalidateOpportunitiesByEvidenceSources(this.deps.principal, new Set([
@@ -174,16 +225,18 @@ var HomeIntelligenceHost = class {
 			let generation;
 			const startOfDay = new Date(startedAt);
 			startOfDay.setHours(0, 0, 0, 0);
-			const modelGenerationAttempts = this.repository.countModelGenerationAttemptsSince(this.deps.principal, startOfDay.getTime(), claim.generationId);
-			const manualRefresh = claim.reasons.includes("manual_refresh");
-			const result = modelGenerationAttempts >= DAILY_MODEL_GENERATION_BUDGET && !manualRefresh ? {
+			const providerBudgetAvailable = () => {
+				const usage = this.repository.getProviderUsageSince(startOfDay.getTime(), HOME_USAGE_OPERATION);
+				return usage.calls < 12 && usage.totalTokens < 12e4;
+			};
+			const result = !providerBudgetAvailable() ? {
 				state: "quiet",
 				reason: "budget_exhausted"
-			} : previousHash === currentFingerprint && !manualRefresh ? {
+			} : previousHash === currentFingerprint && !claim.reasons.includes("manual_refresh") ? {
 				state: "quiet",
 				reason: "no_change"
 			} : await (async () => {
-				generation = await this.deps.generator.generate(snapshot, capabilities, this.abortController.signal);
+				generation = await this.deps.generator.generate(snapshot, capabilities, this.abortController.signal, { allowProviderCall: providerBudgetAvailable });
 				return new HomeAdvicePolicy((requirements, options) => this.resolveCapabilityRequirements(requirements, Boolean(options?.degradedActionAvailable)), this.repository.listSuppressionKeys(this.deps.principal), new Map(successfulPatterns.map((item) => [homePatternKey(item.projectId, item.outcome), item.successCount])), this.repository.getPersonalization(this.deps.principal, this.now())).apply(snapshot, generation.result, this.now());
 			})();
 			const completedAt = this.now();
@@ -212,6 +265,27 @@ var HomeIntelligenceHost = class {
 				this.repository.fail(claim, this.now(), "cancelled", this.now());
 				return;
 			}
+			if (error instanceof HomeAdviceBudgetExceededError) {
+				const completedAt = this.now();
+				this.repository.complete(claim, {
+					result: {
+						state: "quiet",
+						reason: "budget_exhausted"
+					},
+					snapshotHash: currentFingerprint ?? this.repository.getLatestSnapshotHash(this.deps.principal) ?? "budget-exhausted",
+					evidenceIds: [],
+					inputTokens: error.usage.inputTokens,
+					outputTokens: error.usage.outputTokens,
+					estimatedCostUsd: error.usage.estimatedCostUsd,
+					outcomeReason: "budget_exhausted",
+					completedAt
+				});
+				this.deps.publish("home.advisor.updated", {
+					state: "quiet",
+					reason: "budget_exhausted"
+				});
+				return;
+			}
 			const message = error instanceof Error ? error.message : String(error);
 			if (/no api key|no default model|credentials|unknown model|local model/i.test(message)) {
 				const completedAt = this.now();
@@ -246,4 +320,4 @@ var HomeIntelligenceHost = class {
 	}
 };
 //#endregion
-export { HomeIntelligenceHost };
+export { DAILY_HOME_PROVIDER_CALL_BUDGET, DAILY_HOME_TOKEN_BUDGET, HOME_CONTEXT_REFRESH_COOLDOWN_MS, HomeIntelligenceHost };

package/dist/src/home-intelligence/repository.d.ts

@@ -58,7 +58,11 @@ export declare class HomeIntelligenceRepository {
     };
     fail(claim: HomeGenerationClaim, now: number, errorCode: string, retryAt?: number): void;
     getLatestSnapshotHash(principal: HomePrincipal): string | undefined;
-    countModelGenerationAttemptsSince(principal: HomePrincipal, since: number, currentGenerationId: string): number;
+    getLatestContextRefreshRequestedAt(principal: HomePrincipal): number | undefined;
+    getProviderUsageSince(startedAt: number, operation: string): {
+        calls: number;
+        totalTokens: number;
+    };
     listSuppressionKeys(principal: HomePrincipal): Set<string>;
     getSuccessfulPatterns(principal: HomePrincipal): HomeSuccessfulPattern[];
     getPersonalization(principal: HomePrincipal, now: number): HomeAdvicePersonalization;

package/dist/src/home-intelligence/repository.js

@@ -151,16 +151,23 @@ var HomeIntelligenceRepository = class {
           OR outcome_reason NOT IN ('no_change', 'budget_exhausted'))
       ORDER BY completed_at DESC, rowid DESC LIMIT 1`).get(principal.ownerId, principal.workspaceId)?.snapshot_hash ?? void 0;
 	}
-	countModelGenerationAttemptsSince(principal, since, currentGenerationId) {
-		const row = this.db.prepare(`SELECT COALESCE(SUM(CASE
-        WHEN generation_id = ? THEN MAX(attempt - 1, 0)
-        WHEN model_ref IS NOT NULL THEN 1
-        WHEN status IN ('failed', 'retry_wait') THEN attempt
-        ELSE 0
-      END), 0) AS count
+	getLatestContextRefreshRequestedAt(principal) {
+		const row = this.db.prepare(`SELECT MAX(requested_at) AS requested_at
       FROM home_advice_generations
-      WHERE owner_id = ? AND workspace_id = ? AND COALESCE(started_at, requested_at) >= ?`).get(currentGenerationId, principal.ownerId, principal.workspaceId, since);
-		return Number(row.count);
+      WHERE owner_id = ? AND workspace_id = ?
+        AND EXISTS (
+          SELECT 1 FROM json_each(reasons_json)
+          WHERE value IN ('project_changed', 'task_changed', 'connector_changed', 'conversation_changed')
+        )`).get(principal.ownerId, principal.workspaceId);
+		return row.requested_at === null ? void 0 : Number(row.requested_at);
+	}
+	getProviderUsageSince(startedAt, operation) {
+		const row = this.db.prepare(`SELECT COUNT(*) AS calls, COALESCE(SUM(total_tokens), 0) AS total_tokens
+      FROM ai_usage_events WHERE operation = ? AND started_at >= ?`).get(operation, startedAt);
+		return {
+			calls: Number(row.calls),
+			totalTokens: Number(row.total_tokens)
+		};
 	}
 	listSuppressionKeys(principal) {
 		const rows = this.db.prepare(`SELECT f.scope_json, p.kind, p.project_id

package/dist/src/home-intelligence/snapshot.js

@@ -110,10 +110,10 @@ var HomeSnapshotBuilder = class {
 		const successfulPatterns = [...input.successfulPatterns ?? []].filter((item) => item.successCount > 0).sort((left, right) => right.successCount - left.successCount || left.outcome.localeCompare(right.outcome)).slice(0, 20);
 		const stableContent = {
 			locale: input.locale,
-			projects,
-			tasks,
-			knowledge,
-			recentSessions,
+			projects: projects.map(({ updatedAt: _updatedAt, ...project }) => project),
+			tasks: tasks.map(({ updatedAt: _updatedAt, ...task }) => task),
+			knowledge: knowledge.map(({ updatedAt: _updatedAt, ...item }) => item),
+			recentSessions: recentSessions.map(({ updatedAt: _updatedAt, ...session }) => session),
 			successfulPatterns
 		};
 		return {

package/dist/src/storage/sqlite/ai-usage-repository.d.ts

@@ -29,6 +29,9 @@ export type AiUsageTotals = {
     knownCostUsd: string;
     costCompleteness: 'complete' | 'partial' | 'unknown';
 };
+export type ConversationAiUsageTotals = Pick<AiUsageTotals, 'calls' | 'unknownCostCalls' | 'totalTokens' | 'knownCostUsd' | 'costCompleteness'>;
+/** Aggregate all retained AI usage records for the requested conversations. */
+export declare function summarizeAiUsageByConversations(conversationIds: readonly string[]): Map<string, ConversationAiUsageTotals>;
 export declare function summarizeAiUsage(query: AiUsageQuery): {
     totals: AiUsageTotals;
     byCategory: Array<{

package/dist/src/storage/sqlite/ai-usage-repository.js

@@ -94,6 +94,30 @@ const TOTALS_SQL = `COUNT(*) AS calls,
   COALESCE(SUM(cache_write_tokens), 0) AS cache_write_tokens,
   COALESCE(SUM(total_tokens), 0) AS total_tokens,
   COALESCE(SUM(estimated_cost_microusd), 0) AS known_cost_microusd`;
+/** Aggregate all retained AI usage records for the requested conversations. */
+function summarizeAiUsageByConversations(conversationIds) {
+	const uniqueIds = [...new Set(conversationIds.filter(Boolean))];
+	const result = /* @__PURE__ */ new Map();
+	const db = getSqliteDatabase();
+	for (let offset = 0; offset < uniqueIds.length; offset += 500) {
+		const batch = uniqueIds.slice(offset, offset + 500);
+		const rows = db.prepare(`SELECT conversation_id, ${TOTALS_SQL}
+      FROM ai_usage_events
+      WHERE conversation_id IN (${batch.map(() => "?").join(", ")})
+      GROUP BY conversation_id`).all(...batch);
+		for (const row of rows) {
+			const totals = totalsFromRow(row);
+			result.set(String(row.conversation_id), {
+				calls: totals.calls,
+				unknownCostCalls: totals.unknownCostCalls,
+				totalTokens: totals.totalTokens,
+				knownCostUsd: totals.knownCostUsd,
+				costCompleteness: totals.costCompleteness
+			});
+		}
+	}
+	return result;
+}
 function summarizeAiUsage(query) {
 	const { sql, values } = queryWhere(query);
 	const db = getSqliteDatabase();
@@ -172,4 +196,4 @@ function listAiUsageTrace(traceId) {
     ORDER BY started_at ASC, id ASC`).all(traceId).map(eventFromRow);
 }
 //#endregion
-export { AI_USAGE_RETENTION_MS, finishAiUsageEvent, getAiUsageEvent, getAiUsageEventView, insertAiUsageEvent, listAiUsageEvents, listAiUsageTrace, markStaleAiUsageEventsUnknown, pruneAiUsageEvents, summarizeAiUsage };
+export { AI_USAGE_RETENTION_MS, finishAiUsageEvent, getAiUsageEvent, getAiUsageEventView, insertAiUsageEvent, listAiUsageEvents, listAiUsageTrace, markStaleAiUsageEventsUnknown, pruneAiUsageEvents, summarizeAiUsage, summarizeAiUsageByConversations };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.334",
+  "version": "0.0.335",
   "description": "Local-first personal AI for the one-person company, with durable context, tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -159,12 +159,12 @@
     "vitest": "4.1.5",
     "vue": "^3.5.35",
     "@xopcai/browser-control-contract": "0.1.0",
+    "@xopcai/endpoint-tools-client": "0.0.0",
     "@xopcai/computer-control-contract": "0.1.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
-    "@xopcai/endpoint-tools-client": "0.0.0",
-    "@xopcai/realtime-client": "0.0.0",
-    "@xopcai/realtime-protocol": "0.0.0"
+    "@xopcai/realtime-protocol": "0.0.0",
+    "@xopcai/realtime-client": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",

package/dist/gateway/static/root/assets/gateway-realtime-store-BHeHN26R.js

@@ -1 +0,0 @@
-import{p as e}from"./locale-store-BY30D6tg.js";var t=e(()=>({connectionState:`idle`,error:null}));function n(e){t.setState(e)}export{t as n,n as t};

package/dist/gateway/static/root/assets/session-api-BAyUr97V.js

@@ -1 +0,0 @@
-import{a as e,r as t}from"./locale-store-BY30D6tg.js";import{d as n,g as r,h as i,i as a,l as o,p as s,r as c,s as l,t as u,u as d,v as f}from"./schemas-CObaziC7.js";import{t as p}from"./gateway-startup-retry-i-1lTrwY.js";var m=f().transform(e=>e.toLowerCase()).brand(),h=s().trim().regex(/^[a-z0-9][a-z0-9._-]{0,127}$/i).brand(),g=u([`active`,`idle`,`archived`,`pinned`]),_=d({agentId:s().optional(),source:s().optional(),accountId:s().optional(),peerKind:s().optional(),peerId:s().optional(),threadId:s().optional(),scopeId:s().optional()}).passthrough();d({agentId:s().optional(),projectId:s().optional(),key:s(),transcriptId:h.optional(),name:s().optional(),title:s().optional(),displayName:s().optional(),messageCount:o(),updatedAt:s(),sourceChannel:s().optional(),status:g.optional(),routing:_.optional()}).passthrough();var v=d({items:c(r()),total:o(),limit:o(),offset:o(),hasMore:a()}),y=d({role:s(),content:r(),timestamp:i([s(),o()]).optional()}).passthrough(),b=d({key:s(),messages:c(y)}).passthrough(),ee=d({session:b}),x=d({session:d({key:s(),transcriptId:h.optional(),messages:c(y),name:s().optional(),status:g.optional(),sourceChannel:s().optional(),sourceChatId:s().optional(),projectId:s().optional(),customData:n(s(),r()).optional(),routing:_.optional()}).passthrough(),pagination:d({total:o(),limit:o(),offset:o(),hasMore:a(),before:s().optional(),nextBeforeCursor:s().optional(),revision:o().int().nonnegative().optional()}).passthrough()}).passthrough(),S=d({ok:l(!0),conversationId:f(),rowCount:o().int().nonnegative(),lastTurnId:s().min(1),session:b}).passthrough(),C=d({ok:a().optional(),payload:d({active:a(),runId:s().optional()}).passthrough().optional()}).passthrough(),w=d({ok:a().optional(),error:s().optional()}).passthrough(),T=w.extend({renamed:a().optional()}),E=w.extend({reset:a().optional(),transcriptId:h.optional(),previousTranscriptId:s().optional(),session:r().optional()}),D=d({totalSessions:o(),activeSessions:o(),archivedSessions:o(),pinnedSessions:o(),totalMessages:o(),totalTokens:o(),oldestSession:s().optional(),newestSession:s().optional(),byChannel:n(s(),o())}).passthrough();d({ok:a(),payload:d({conversationId:f(),transcriptId:h,session:r()}).passthrough().optional(),error:s().optional()}).passthrough();var O=d({ok:l(!0),projects:d({items:c(d({project:r(),sessions:c(r()),sessionTotal:o(),sessionHasMore:a()}).passthrough()),total:o(),limit:o(),offset:o(),hasMore:a()}),inbox:v,pinned:c(r()).default([]),layouts:n(s(),d({itemIds:c(s()),revision:o().int().nonnegative()})).default({})}).passthrough();function k(e){return ee.parse(e)}function A(e){return x.parse(e)}function j(e){return S.parse(e)}function M(e){return C.parse(e)}function N(e){return w.parse(e)}function P(e){return T.parse(e)}function F(e){return E.parse(e)}function I(e){return D.parse(e)}function L(e){return O.parse(e)}function R(e){let t=M(e).payload,n=typeof t?.runId==`string`?t.runId.trim():``;return!t?.active||!n?{active:!1}:{active:!0,runId:n}}function z(e){let t=new URLSearchParams;if(!e)return``;e.status&&t.set(`status`,e.status),e.search&&t.set(`search`,e.search),e.channel&&t.set(`channel`,e.channel),e.sources?.length&&t.set(`sources`,e.sources.join(`,`)),e.purposes?.length&&t.set(`purposes`,e.purposes.join(`,`)),e.activity&&t.set(`activity`,e.activity),e.agentId&&t.set(`agentId`,e.agentId),e.excludeArchived&&t.set(`excludeArchived`,`true`),e.projectId&&t.set(`projectId`,e.projectId),e.unassigned&&t.set(`unassigned`,`true`),e.updatedAfter!=null&&t.set(`updatedAfter`,String(e.updatedAfter)),e.includePinned&&t.set(`includePinned`,`true`),e.includeConversationId&&t.set(`includeConversationId`,e.includeConversationId),e.sessionTypes?.length&&t.set(`types`,e.sessionTypes.join(`,`)),e.sortBy&&t.set(`sortBy`,e.sortBy),e.sortOrder&&t.set(`sortOrder`,e.sortOrder),e.limit!=null&&t.set(`limit`,String(e.limit)),e.offset!=null&&t.set(`offset`,String(e.offset));let n=t.toString();return n?`?${n}`:``}function B(e,t){let n=[];t?.includeTranscript&&n.push(`transcript`),t?.includeTranscriptRows&&n.push(`transcriptRows`);let r=n.length?`?include=${n.join(`,`)}`:``;return`/api/sessions/${encodeURIComponent(e)}${r}`}function te(e){return`/api/sessions/${encodeURIComponent(e)}/fork-at-turn`}function V(e,t){let n=new URLSearchParams;n.set(`limit`,String(t?.limit??50));let r=t?.before?.trim();return r?n.set(`before`,r):t?.offset!=null&&n.set(`offset`,String(t.offset)),`/api/sessions/${encodeURIComponent(e)}/history?${n.toString()}`}function H(e){return`/api/sessions/${encodeURIComponent(e)}/run`}function U(){return`/api/sessions/stats`}function W(e){let t=new URLSearchParams;e?.projectLimit!=null&&t.set(`projectLimit`,String(e.projectLimit)),e?.projectOffset!=null&&t.set(`projectOffset`,String(e.projectOffset)),e?.sessionPreviewLimit!=null&&t.set(`sessionPreviewLimit`,String(e.sessionPreviewLimit)),e?.inboxLimit!=null&&t.set(`inboxLimit`,String(e.inboxLimit)),e?.inboxOffset!=null&&t.set(`inboxOffset`,String(e.inboxOffset)),e?.staleDays!=null&&t.set(`staleDays`,String(e.staleDays)),e?.includeConversationId&&t.set(`includeConversationId`,e.includeConversationId);let n=t.toString();return`/api/sidebar/chat-list${n?`?${n}`:``}`}function G(e){return`/api/sidebar/layouts/${encodeURIComponent(e)}`}function K(e,t){let n=encodeURIComponent(e);return t===`delete`?`/api/sessions/${n}`:`/api/sessions/${n}/${t}`}function q(e){return e?JSON.stringify({status:e.status,search:e.search,channel:e.channel,sources:e.sources,purposes:e.purposes,activity:e.activity,agentId:e.agentId,excludeArchived:e.excludeArchived,projectId:e.projectId,unassigned:e.unassigned,updatedAfter:e.updatedAfter,includePinned:e.includePinned,includeConversationId:e.includeConversationId,sessionTypes:e.sessionTypes,sortBy:e.sortBy,sortOrder:e.sortOrder,limit:e.limit,offset:e.offset}):`default`}var J=new Map;async function Y(e){let n=q(e),r=J.get(n);if(r)return r;let i=t(`/api/sessions${z(e)}`),a=(async()=>{let e=await p(i);if(!e.ok){let t=await e.json().catch(()=>({})),n=typeof t.error==`string`?t.error:t.error?.message;throw Error(n??`HTTP ${e.status}`)}return await e.json()})().finally(()=>{J.delete(n)});return J.set(n,a),a}async function X(n){return L(await e(t(W(n))))}async function Z(n){let r=await e(t(G(n.containerId)),{method:`PUT`,body:JSON.stringify({itemIds:n.itemIds,expectedRevision:n.expectedRevision})});if(!r.ok||!r.layout)throw Error(r.error??`Failed to save sidebar order`);return r.layout}async function Q(){return I(await e(t(U())))}async function ne(n,r){let i=k(await e(t(B(n,r))));if(!i.session)throw Error(`Session not found`);return i.session}async function re(n){let r=await e(t(`/api/sessions/resolve`),{method:`POST`,body:JSON.stringify(n)});if(!r.ok||!r.payload)throw Error(r.error??`Session not found`);return r.payload}async function ie(n){N(await e(t(K(n,`delete`)),{method:`DELETE`}))}async function ae(n,r){return{renamed:P(await e(t(K(n,`rename`)),{method:`POST`,body:JSON.stringify({name:r})})).renamed===!0}}async function oe(n){N(await e(t(K(n,`archive`)),{method:`POST`}))}async function $(n){N(await e(t(K(n,`unarchive`)),{method:`POST`}))}async function se(n){N(await e(t(K(n,`pin`)),{method:`POST`}))}async function ce(n){N(await e(t(K(n,`unpin`)),{method:`POST`}))}async function le(n){return(await e(t(`/api/sessions/${encodeURIComponent(n)}/export?format=json`))).content}export{R as _,ne as a,F as b,se as c,Z as d,$ as f,H as g,V as h,X as i,ae as l,te as m,ie as n,Q as o,ce as p,le as r,Y as s,oe as t,re as u,j as v,m as x,A as y};