@xopcai/xopc 0.0.249 → 0.0.251

package/dist/src/proactive/scenarios/repository.js

@@ -15,7 +15,14 @@ function scenarioFromRow(row) {
 		...condition ? { condition } : {},
 		aggregation: text(row, "aggregation"),
 		debounceSeconds: Number(row.debounce_seconds),
-		maxWindowSeconds: Number(row.max_window_seconds)
+		maxWindowSeconds: Number(row.max_window_seconds),
+		contextProviderIds: JSON.parse(text(row, "context_provider_ids_json")),
+		valuePolicy: {
+			minConfidence: Number(row.min_confidence),
+			minScore: Number(row.min_value_score),
+			cooldownSeconds: Number(row.cooldown_seconds),
+			maxRunsPerDay: Number(row.max_runs_per_day)
+		}
 	};
 }
 function subscriptionFromRow(row) {
@@ -47,8 +54,8 @@ function revisionFromRow(row) {
 function listScenarios() {
 	return getSqliteDatabase().prepare("SELECT * FROM proactive_scenarios ORDER BY scenario_key").all().map(scenarioFromRow);
 }
-function getScenario(key) {
-	const row = getSqliteDatabase().prepare("SELECT * FROM proactive_scenarios WHERE scenario_key = ?").get(key);
+function getScenario(key, version) {
+	const row = version === void 0 ? getSqliteDatabase().prepare("SELECT * FROM proactive_scenarios WHERE scenario_key = ?").get(key) : getSqliteDatabase().prepare("SELECT * FROM proactive_scenario_versions WHERE scenario_key = ? AND version = ?").get(key, version);
 	return row ? scenarioFromRow(row) : null;
 }
 function upsertSubscription(input, now = /* @__PURE__ */ new Date()) {

package/dist/src/proactive/scenarios/types.d.ts

@@ -11,6 +11,13 @@ export interface ScenarioDefinition {
     aggregation: ScenarioRoute['aggregation'];
     debounceSeconds: number;
     maxWindowSeconds: number;
+    contextProviderIds: string[];
+    valuePolicy: {
+        minConfidence: number;
+        minScore: number;
+        cooldownSeconds: number;
+        maxRunsPerDay: number;
+    };
 }
 export interface ScenarioSubscription {
     id: string;

package/dist/src/proactive/service.d.ts

@@ -14,5 +14,12 @@ export declare class ProactiveEventService {
         collecting: number;
         ready: number;
         oldestReadyAt: string | null;
+        last24Hours: {
+            runs: number;
+            insights: number;
+            discarded: number;
+            useful: number;
+            notUseful: number;
+        };
     };
 }

package/dist/src/proactive/service.js

@@ -49,11 +49,27 @@ var ProactiveEventService = class {
       SUM(CASE WHEN status = 'ready' THEN 1 ELSE 0 END) AS ready,
       MIN(CASE WHEN status = 'ready' THEN ready_at END) AS oldest_ready_at
       FROM proactive_signal_batches`).get();
+		const since = (/* @__PURE__ */ new Date(Date.now() - 1440 * 6e4)).toISOString();
+		const runs = db.prepare(`SELECT COUNT(*) AS runs,
+      SUM(CASE WHEN status = 'discarded' THEN 1 ELSE 0 END) AS discarded
+      FROM proactive_runs WHERE started_at >= ?`).get(since);
+		const insights = db.prepare("SELECT COUNT(*) AS count FROM proactive_insights WHERE created_at >= ?").get(since);
+		const feedback = db.prepare(`SELECT
+      SUM(CASE WHEN rating = 'useful' THEN 1 ELSE 0 END) AS useful,
+      SUM(CASE WHEN rating = 'not_useful' THEN 1 ELSE 0 END) AS not_useful
+      FROM proactive_feedback WHERE created_at >= ?`).get(since);
 		return {
 			events: events.count,
 			collecting: batches.collecting ?? 0,
 			ready: batches.ready ?? 0,
-			oldestReadyAt: batches.oldest_ready_at
+			oldestReadyAt: batches.oldest_ready_at,
+			last24Hours: {
+				runs: runs.runs,
+				insights: insights.count,
+				discarded: runs.discarded ?? 0,
+				useful: feedback.useful ?? 0,
+				notUseful: feedback.not_useful ?? 0
+			}
 		};
 	}
 };

package/dist/src/projects/project-service.d.ts

@@ -11,7 +11,8 @@ export type ProjectSuggestion = {
 export declare class ProjectService {
     private readonly store;
     private readonly signals?;
-    constructor(store?: ProjectStore, signals?: ProactiveSignalPublisher);
+    private readonly workspaceId;
+    constructor(store?: ProjectStore, signals?: ProactiveSignalPublisher, workspaceId?: string);
     private listAllProjects;
     create(input: CreateProjectInput): Project;
     get(id: string): Project | null;

package/dist/src/projects/project-service.js

@@ -9,9 +9,10 @@ import { bindSessionToProject, listProjectSessionKeys, unbindSessionFromProject
 import { createHash } from "node:crypto";
 //#region src/projects/project-service.ts
 var ProjectService = class {
-	constructor(store = new ProjectStore(), signals) {
+	constructor(store = new ProjectStore(), signals, workspaceId = "default") {
 		this.store = store;
 		this.signals = signals;
+		this.workspaceId = workspaceId;
 	}
 	listAllProjects() {
 		const items = [];
@@ -199,7 +200,7 @@ var ProjectService = class {
 				},
 				actor: { kind: "system" },
 				scope: {
-					workspaceId: "default",
+					workspaceId: this.workspaceId,
 					projectId: project.id
 				},
 				occurredAt: new Date(project.updatedAt).toISOString(),

package/dist/src/providers/auth-runtime/resolve-auth.js

@@ -1,5 +1,5 @@
-import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
 import { getApiKeyFromEnv, init_env_keys } from "../env-keys.js";
+import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
 import { getDefaultAuthProfileStore } from "./auth-profile-store.js";
 //#region src/providers/auth-runtime/resolve-auth.ts
 init_env_keys();

package/dist/src/providers/index.js

@@ -1,11 +1,11 @@
 import { __esmMin, __exportAll } from "../../_virtual/_rolldown/runtime.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { getModelOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
-import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { init_model_ref, splitProviderModelRef } from "./model-ref.js";
 import { ModelRegistry, getModelRegistry, init_model_registry, prewarmModelRegistry, resetModelRegistry } from "./model-registry.js";
+import { getModelOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
 import { CredentialResolver, hasCredentials, init_credentials } from "../auth/credentials.js";
+import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { EXTENSION_PROVIDER_BASE_URL, init_constants } from "./constants.js";
 import { applyOfficialModelMetadataCorrections, getSupplementalModels, init_model_supplements } from "./model-supplements.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";

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

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { resolveModelsJsonPath } from "../config/paths.js";
 import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
+import { resolveModelsJsonPath } from "../config/paths.js";
 import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
 import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";

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

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
+import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
 import { XOPC_CLOUD_PROVIDER_ID, init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 //#region src/providers/register-runtime-providers.ts
 function registerRuntimeProvider(modelRuntime, source) {

package/dist/src/session/index.js

@@ -1,5 +1,5 @@
-import { SessionStatus } from "./types.js";
 import { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
+import { SessionStatus } from "./types.js";
 import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput, projectWorkspacePath } from "./session-workspace.js";
 import { emitSessionTranscriptUpdate, onSessionTranscriptUpdate } from "./transcript-events.js";
 import { fallbackTitleFromMessages, generateSessionTitleFromMessages, getSessionTitleSource, isWebchatSessionKey, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, provisionalTitleFromUserText, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm } from "./session-title.js";

package/dist/src/session/store.js

@@ -3,8 +3,8 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import "./types.js";
 import { buildSessionContextForLlm, buildSessionDisplayMessages, isRuntimeOnlyTranscriptMessage, isTranscriptCompactionEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
+import "./types.js";
 import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../routing/agent-session-key.js";
 import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.js";
 import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getGlobalSessionStats, getSessionMetadata, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
@@ -13,6 +13,7 @@ import { getSessionConfig, setSessionConfig } from "../storage/sqlite/config-rep
 import "../storage/sqlite/index.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { SessionCompactor } from "../agent/memory/compaction.js";
+import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
 import { resolveCompactionPolicy } from "../agent/memory/compaction-policy.js";
 import { promoteCompactionLedger } from "../agent/memory/compaction-promotion.js";
@@ -464,6 +465,7 @@ var SessionStore = class {
 			})) throw new Error(`Session changed while compaction was running: ${key}`);
 			try {
 				const metadata = getSessionMetadata(key);
+				const access = resolveUserContextSessionAccess(this.options.config, key);
 				const promoted = promoteCompactionLedger({
 					sessionKey: key,
 					sessionId: expectedSnapshot.sessionId,
@@ -472,7 +474,8 @@ var SessionStore = class {
 					projectId: metadata?.projectId,
 					handover: result.handover,
 					audit: result.audit,
-					sourceEntries: expectedSnapshot.entries
+					sourceEntries: expectedSnapshot.entries,
+					writePolicy: access.knowledge && this.options.config.userContext.knowledgeMemory.sources.includes("session") ? this.options.config.userContext.knowledgeMemory.writePolicy : "deny"
 				});
 				log.info({
 					sessionKey: key,

package/dist/src/storage/sqlite/collaboration-rule-repository.d.ts

@@ -13,5 +13,7 @@ export interface CollaborationRule {
 }
 export declare function getCollaborationRule(id: string): CollaborationRule | undefined;
 export declare function listCollaborationRules(principalId?: string): CollaborationRule[];
-export declare function createCollaborationRule(input: Pick<CollaborationRule, 'category' | 'priority' | 'scope' | 'conditions' | 'statement'>): CollaborationRule;
+export declare function createCollaborationRule(input: Pick<CollaborationRule, 'category' | 'priority' | 'scope' | 'conditions' | 'statement'> & {
+    status?: CollaborationRule['status'];
+}): CollaborationRule;
 export declare function setCollaborationRuleStatus(id: string, status: CollaborationRule['status']): CollaborationRule | undefined;

package/dist/src/storage/sqlite/collaboration-rule-repository.js

@@ -40,7 +40,7 @@ function createCollaborationRule(input) {
 		db.prepare(`INSERT INTO collaboration_rules (
       rule_id, principal_id, category, status, priority, scope_type, scope_id,
       conditions_json, current_revision_id, created_at, updated_at
-    ) VALUES (?, ?, ?, 'active', ?, ?, ?, ?, ?, ?, ?)`).run(id, USER_MODEL_PRINCIPAL_ID, input.category, input.priority, input.scope.type, input.scope.id ?? null, JSON.stringify(input.conditions), revisionId, now, now);
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, USER_MODEL_PRINCIPAL_ID, input.category, input.status ?? "active", input.priority, input.scope.type, input.scope.id ?? null, JSON.stringify(input.conditions), revisionId, now, now);
 		db.prepare(`INSERT INTO collaboration_rule_revisions (
       revision_id, rule_id, statement, created_by, created_at
     ) VALUES (?, ?, ?, 'user', ?)`).run(revisionId, id, input.statement.trim(), now);

package/dist/src/storage/sqlite/config-repository.js

@@ -1,6 +1,6 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
-import { notifyUserContextChange } from "../../user-context/changes.js";
 import { sessionConfigRowToConfig } from "./row-mappers.js";
+import { notifyUserContextChange } from "../../user-context/changes.js";
 import { ensureSessionInTransaction } from "./session-repository.js";
 //#region src/storage/sqlite/config-repository.ts
 function readConfigRow(db, sessionKey) {

package/dist/src/storage/sqlite/connection-wait-repository.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { isXopcDatabaseOpen } from "./connection.js";
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
-import { TaskRunRepository } from "../../tasks/task-run-repository.js";
-import { readCurrentSessionId } from "./session-repository.js";
+import { readCurrentSessionId } from "./session-instance-repository.js";
 import { bumpSessionInputRevision, getSessionInputById, getSessionInputState, insertSessionInput, setSessionInputStatus } from "./session-input-repository.js";
+import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { randomUUID } from "node:crypto";
 import { EventEmitter } from "node:events";
 //#region src/storage/sqlite/connection-wait-repository.ts

package/dist/src/storage/sqlite/index.js

@@ -15,10 +15,9 @@ import { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, l
 import { createCollaborationRule, getCollaborationRule, listCollaborationRules, setCollaborationRuleStatus } from "./collaboration-rule-repository.js";
 import { createContextEvidence } from "./context-evidence-repository.js";
 import { getUserPeopleIndexState, getUserPerson, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson } from "./user-people-repository.js";
+import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
 import { buildDefaultSessionMetadata } from "./session-metadata.js";
 import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow } from "./row-mappers.js";
-import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getCurrentSessionId, getGlobalSessionStats, getSessionMetadata, getSessionPersistedLevels, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats } from "./session-repository.js";
-import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
 import { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget } from "./session-turn-replace-repository.js";
 import { acknowledgeHomeAttention, isHomeAttentionAcknowledged } from "./home-attention-repository.js";
 import { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob } from "./connector-learning-repository.js";
@@ -26,6 +25,7 @@ import { COMPOSER_INPUT_HISTORY_LIMIT, appendComposerInputHistory, clearComposer
 import { bindEndpointPrincipal, createEndpointPrincipal, getEndpointPrincipal, listEndpointPrincipals, revokeEndpointPrincipal, touchEndpointPrincipal } from "./endpoint-principal-repository.js";
 import { finishEndpointToolInvocationAudit, listEndpointToolInvocationAudits, startEndpointToolInvocationAudit } from "./endpoint-tool-invocation-repository.js";
 import { getInteractionState, setInteractionState, updateInteractionStateFromMessage } from "./interaction-state-repository.js";
+import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getCurrentSessionId, getGlobalSessionStats, getSessionMetadata, getSessionPersistedLevels, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats } from "./session-repository.js";
 import { getSessionTaskPlan, setSessionTaskPlan } from "./session-task-plan-repository.js";
 import { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings } from "./relationship-settings-repository.js";
 import { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "./transcript-repository.js";

package/dist/src/storage/sqlite/migrations/151_proactive_scope_cleanup.sql

@@ -0,0 +1,6 @@
+DELETE FROM proactive_scenario_subscriptions
+WHERE subscription_id IN (
+  'default-project-delivery-risk',
+  'default-blocked-work',
+  'default-automation-failure-impact'
+);

package/dist/src/storage/sqlite/migrations/152_proactive_scenario_contract.sql

@@ -0,0 +1,140 @@
+ALTER TABLE proactive_scenarios
+  ADD COLUMN context_provider_ids_json TEXT NOT NULL DEFAULT '["event_batch"]';
+ALTER TABLE proactive_scenarios
+  ADD COLUMN min_confidence REAL NOT NULL DEFAULT 0.65
+    CHECK (min_confidence >= 0 AND min_confidence <= 1);
+ALTER TABLE proactive_scenarios
+  ADD COLUMN min_value_score REAL NOT NULL DEFAULT 0.6
+    CHECK (min_value_score >= 0 AND min_value_score <= 1);
+ALTER TABLE proactive_scenarios
+  ADD COLUMN cooldown_seconds INTEGER NOT NULL DEFAULT 604800
+    CHECK (cooldown_seconds >= 0);
+ALTER TABLE proactive_scenarios
+  ADD COLUMN max_runs_per_day INTEGER NOT NULL DEFAULT 30
+    CHECK (max_runs_per_day > 0);
+
+UPDATE proactive_scenarios
+SET context_provider_ids_json = '["event_batch","connected_source","internal_objects","user_model","project_state"]'
+WHERE scenario_key IN ('project_delivery_risk', 'blocked_work');
+
+UPDATE proactive_scenarios
+SET context_provider_ids_json = '["event_batch","user_model","automation_state","project_state"]',
+    cooldown_seconds = 86400,
+    max_runs_per_day = 20
+WHERE scenario_key = 'automation_failure_impact';
+
+UPDATE proactive_scenarios
+SET context_provider_ids_json = '["event_batch","connected_source","user_model","meeting_workspace"]',
+    cooldown_seconds = 86400,
+    max_runs_per_day = 20
+WHERE scenario_key = 'meeting_preparation';
+
+UPDATE proactive_scenarios
+SET context_provider_ids_json = '["event_batch","user_model","discussion"]',
+    cooldown_seconds = 86400,
+    max_runs_per_day = 20
+WHERE scenario_key = 'discussion_follow_up';
+
+CREATE TABLE proactive_scenario_versions (
+  scenario_key TEXT NOT NULL,
+  version INTEGER NOT NULL CHECK (version > 0),
+  title TEXT NOT NULL,
+  description TEXT NOT NULL,
+  base_prompt TEXT NOT NULL,
+  base_template_version INTEGER NOT NULL CHECK (base_template_version > 0),
+  event_types_json TEXT NOT NULL,
+  condition_json TEXT,
+  aggregation TEXT NOT NULL CHECK (aggregation IN ('subject', 'project', 'workspace')),
+  debounce_seconds INTEGER NOT NULL CHECK (debounce_seconds >= 0),
+  max_window_seconds INTEGER NOT NULL CHECK (max_window_seconds > 0),
+  context_provider_ids_json TEXT NOT NULL,
+  min_confidence REAL NOT NULL CHECK (min_confidence >= 0 AND min_confidence <= 1),
+  min_value_score REAL NOT NULL CHECK (min_value_score >= 0 AND min_value_score <= 1),
+  cooldown_seconds INTEGER NOT NULL CHECK (cooldown_seconds >= 0),
+  max_runs_per_day INTEGER NOT NULL CHECK (max_runs_per_day > 0),
+  created_at TEXT NOT NULL,
+  PRIMARY KEY (scenario_key, version),
+  FOREIGN KEY (scenario_key) REFERENCES proactive_scenarios(scenario_key) ON DELETE CASCADE
+);
+
+INSERT INTO proactive_scenario_versions (
+  scenario_key, version, title, description, base_prompt, base_template_version,
+  event_types_json, condition_json, aggregation, debounce_seconds,
+  max_window_seconds, context_provider_ids_json, min_confidence,
+  min_value_score, cooldown_seconds, max_runs_per_day, created_at
+)
+SELECT
+  scenario_key, version, title, description, base_prompt, base_template_version,
+  event_types_json, condition_json, aggregation, debounce_seconds,
+  max_window_seconds, context_provider_ids_json, min_confidence,
+  min_value_score, cooldown_seconds, max_runs_per_day, updated_at
+FROM proactive_scenarios;
+
+CREATE TRIGGER proactive_scenario_version_after_insert
+AFTER INSERT ON proactive_scenarios
+BEGIN
+  INSERT INTO proactive_scenario_versions (
+    scenario_key, version, title, description, base_prompt, base_template_version,
+    event_types_json, condition_json, aggregation, debounce_seconds,
+    max_window_seconds, context_provider_ids_json, min_confidence,
+    min_value_score, cooldown_seconds, max_runs_per_day, created_at
+  ) VALUES (
+    NEW.scenario_key, NEW.version, NEW.title, NEW.description, NEW.base_prompt,
+    NEW.base_template_version, NEW.event_types_json, NEW.condition_json,
+    NEW.aggregation, NEW.debounce_seconds, NEW.max_window_seconds,
+    NEW.context_provider_ids_json, NEW.min_confidence, NEW.min_value_score,
+    NEW.cooldown_seconds, NEW.max_runs_per_day, NEW.updated_at
+  );
+END;
+
+CREATE TRIGGER proactive_scenario_contract_update_guard
+BEFORE UPDATE ON proactive_scenarios
+WHEN NEW.version = OLD.version AND (
+  NEW.title IS NOT OLD.title
+  OR NEW.description IS NOT OLD.description
+  OR NEW.base_prompt IS NOT OLD.base_prompt
+  OR NEW.base_template_version IS NOT OLD.base_template_version
+  OR NEW.event_types_json IS NOT OLD.event_types_json
+  OR NEW.condition_json IS NOT OLD.condition_json
+  OR NEW.aggregation IS NOT OLD.aggregation
+  OR NEW.debounce_seconds IS NOT OLD.debounce_seconds
+  OR NEW.max_window_seconds IS NOT OLD.max_window_seconds
+  OR NEW.context_provider_ids_json IS NOT OLD.context_provider_ids_json
+  OR NEW.min_confidence IS NOT OLD.min_confidence
+  OR NEW.min_value_score IS NOT OLD.min_value_score
+  OR NEW.cooldown_seconds IS NOT OLD.cooldown_seconds
+  OR NEW.max_runs_per_day IS NOT OLD.max_runs_per_day
+)
+BEGIN
+  SELECT RAISE(ABORT, 'proactive scenario contract changes require a new version');
+END;
+
+CREATE TRIGGER proactive_scenario_version_after_update
+AFTER UPDATE OF version ON proactive_scenarios
+WHEN NEW.version <> OLD.version
+BEGIN
+  INSERT INTO proactive_scenario_versions (
+    scenario_key, version, title, description, base_prompt, base_template_version,
+    event_types_json, condition_json, aggregation, debounce_seconds,
+    max_window_seconds, context_provider_ids_json, min_confidence,
+    min_value_score, cooldown_seconds, max_runs_per_day, created_at
+  ) VALUES (
+    NEW.scenario_key, NEW.version, NEW.title, NEW.description, NEW.base_prompt,
+    NEW.base_template_version, NEW.event_types_json, NEW.condition_json,
+    NEW.aggregation, NEW.debounce_seconds, NEW.max_window_seconds,
+    NEW.context_provider_ids_json, NEW.min_confidence, NEW.min_value_score,
+    NEW.cooldown_seconds, NEW.max_runs_per_day, NEW.updated_at
+  );
+END;
+
+CREATE TRIGGER proactive_scenario_versions_immutable_update
+BEFORE UPDATE ON proactive_scenario_versions
+BEGIN
+  SELECT RAISE(ABORT, 'proactive scenario versions are immutable');
+END;
+
+CREATE TRIGGER proactive_scenario_versions_immutable_delete
+BEFORE DELETE ON proactive_scenario_versions
+BEGIN
+  SELECT RAISE(ABORT, 'proactive scenario versions are immutable');
+END;

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 150;
+export declare const XOPC_DB_SCHEMA_VERSION = 152;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 150;
+const XOPC_DB_SCHEMA_VERSION = 152;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function backupBeforeTaskCutover(db, databasePath) {
 	db.exec("PRAGMA wal_checkpoint(FULL)");
@@ -57,7 +57,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 150;
+	const targetVersion = options.targetVersion ?? 152;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -94,7 +94,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 150;
+	const appVersion = options.targetVersion ?? 152;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 150;
+export const XOPC_DB_SCHEMA_VERSION = 152;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/row-mappers.js

@@ -1,7 +1,7 @@
-import "../../session/types.js";
-import { buildDefaultSessionMetadata } from "./session-metadata.js";
 import { isTranscriptContextEntry } from "../../session/session-context-for-llm.js";
+import "../../session/types.js";
 import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../../routing/agent-session-key.js";
+import { buildDefaultSessionMetadata } from "./session-metadata.js";
 //#region src/storage/sqlite/row-mappers.ts
 init_agent_session_key();
 function parseJson(raw) {

package/dist/src/storage/sqlite/schema.js

@@ -32,7 +32,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 11;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 150,
+		targetVersion: 152,
 		databasePath: options.databasePath
 	});
 }

package/dist/src/storage/sqlite/session-input-repository.js

@@ -1,5 +1,5 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
-import { readCurrentSessionId } from "./session-repository.js";
+import { readCurrentSessionId } from "./session-instance-repository.js";
 import { turnOriginSchema } from "../../../packages/endpoint-tools-protocol/src/index.js";
 //#region src/storage/sqlite/session-input-repository.ts
 function mapInput(row) {

package/dist/src/storage/sqlite/session-instance-repository.d.ts

@@ -0,0 +1,2 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function readCurrentSessionId(db: DatabaseSync, sessionKey: string): string | null;

package/dist/src/storage/sqlite/session-instance-repository.js

@@ -0,0 +1,6 @@
+//#region src/storage/sqlite/session-instance-repository.ts
+function readCurrentSessionId(db, sessionKey) {
+	return db.prepare(`SELECT session_id FROM sessions WHERE session_key = ?`).get(sessionKey)?.session_id ?? null;
+}
+//#endregion
+export { readCurrentSessionId };

package/dist/src/storage/sqlite/session-repository.d.ts

@@ -4,7 +4,7 @@ import { type SessionMetadataSeed } from './session-metadata.js';
 import { buildGlobalSessionStats } from './row-mappers.js';
 export declare function ensureSessionInTransaction(db: DatabaseSync, sessionKey: string, cwd: string, seed?: SessionMetadataSeed): SessionMetadata;
 export declare function ensureSessionRecord(sessionKey: string, cwd: string, seed?: SessionMetadataSeed): SessionMetadata;
-export declare function readCurrentSessionId(db: DatabaseSync, sessionKey: string): string | null;
+export { readCurrentSessionId } from './session-instance-repository.js';
 export declare function getSessionMetadata(sessionKey: string): SessionMetadata | null;
 export declare function getCurrentSessionId(sessionKey: string): string | null;
 export declare function listSessionMetadata(query?: SessionListQuery): PaginatedResult<SessionMetadata>;

package/dist/src/storage/sqlite/session-repository.js

@@ -1,9 +1,10 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { readCurrentSessionId } from "./session-instance-repository.js";
+import { buildDefaultSessionMetadata } from "./session-metadata.js";
+import { buildGlobalSessionStats, metadataToSessionInsert, sessionRowToMetadata } from "./row-mappers.js";
 import { cancelConnectionObjective } from "./connection-wait-repository.js";
 import { notifyUserContextChange } from "../../user-context/changes.js";
 import { validateSessionId } from "../../session/session-id.js";
-import { buildDefaultSessionMetadata } from "./session-metadata.js";
-import { buildGlobalSessionStats, metadataToSessionInsert, sessionRowToMetadata } from "./row-mappers.js";
 import { buildFts5SearchQuery } from "./fts.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/session-repository.ts
@@ -64,9 +65,6 @@ function ensureSessionInTransaction(db, sessionKey, cwd, seed) {
 function ensureSessionRecord(sessionKey, cwd, seed) {
 	return runSqliteWriteTransaction((db) => ensureSessionInTransaction(db, sessionKey, cwd, seed));
 }
-function readCurrentSessionId(db, sessionKey) {
-	return db.prepare(`SELECT session_id FROM sessions WHERE session_key = ?`).get(sessionKey)?.session_id ?? null;
-}
 function getSessionMetadata(sessionKey) {
 	const row = readSessionRow(getSqliteDatabase(), sessionKey);
 	if (!row) return null;

package/dist/src/storage/sqlite/transcript-repository.js

@@ -1,8 +1,9 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { readCurrentSessionId } from "./session-instance-repository.js";
 import { buildSessionContextForLlm, isRuntimeOnlyTranscriptMessage } from "../../session/session-context-for-llm.js";
 import { classifyStoredRow, estimateTokensFromMessages, extractFtsContent, transcriptEntryRowToStoredRow } from "./row-mappers.js";
 import { escapeFts5Query } from "./fts.js";
-import { getCurrentSessionId, readCurrentSessionId } from "./session-repository.js";
+import { getCurrentSessionId } from "./session-repository.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/transcript-repository.ts
 function nextSeq(db, sessionId) {

package/dist/src/tasks/home-query-service.js

@@ -334,7 +334,7 @@ var HomeQueryService = class {
 				kind: "agent_judgment",
 				title: item.insight.title,
 				detail: item.insight.summary,
-				reason: item.insight.disposition === "request_approval" ? "approval_required" : "decision_needed",
+				reason: item.insight.disposition === "request_approval" ? "approval_required" : item.insight.attentionKind === "decision" ? "decision_needed" : "insight_available",
 				urgency: item.insight.urgency === "critical" || item.insight.urgency === "high" ? "now" : "soon",
 				href: `/?judgment=${encodeURIComponent(item.id)}`,
 				updatedAt: Date.parse(item.updatedAt),
@@ -346,6 +346,8 @@ var HomeQueryService = class {
 					recommendation: item.insight.recommendation,
 					confidence: item.insight.confidence,
 					valueScore: item.insight.valueScore,
+					evidenceIds: item.insight.evidenceIds,
+					attentionKind: item.insight.attentionKind,
 					disposition: item.insight.disposition,
 					dispositionReason: item.insight.dispositionReason,
 					...item.insight.actionStatus ? { actionStatus: item.insight.actionStatus } : {},
@@ -398,19 +400,39 @@ var HomeQueryService = class {
 		});
 		const decisions = governed.decisions;
 		const attention = governed.attention;
-		return {
-			...buildHomeWorkbench({
-				locale,
-				decisions,
-				attention,
-				activeWorkflowRuns,
-				runningTasks: tasks.filter((task) => {
-					const state = this.#projector.project(task).operationalState;
-					return state === "queued" || state === "running" || state === "verifying";
-				}),
-				scheduled: upcomingAutomations,
-				nowMs
+		const interactiveDecisions = decisions.filter((item) => item.kind !== "agent_judgment" || item.judgment?.attentionKind === "decision");
+		const proactiveInformation = decisions.filter((item) => item.kind === "agent_judgment" && item.judgment?.attentionKind !== "decision");
+		const workbench = buildHomeWorkbench({
+			locale,
+			decisions: interactiveDecisions,
+			attention,
+			activeWorkflowRuns,
+			runningTasks: tasks.filter((task) => {
+				const state = this.#projector.project(task).operationalState;
+				return state === "queued" || state === "running" || state === "verifying";
 			}),
+			scheduled: upcomingAutomations,
+			nowMs
+		});
+		const informationItems = proactiveInformation.map((item) => ({
+			id: item.id,
+			kind: "insight",
+			title: item.title,
+			summary: item.detail ?? item.judgment.recommendation,
+			recommendation: item.judgment.recommendation,
+			updatedAt: item.updatedAt,
+			openAction: {
+				type: "review_judgment",
+				label: locale?.startsWith("zh") ? "查看" : "Review",
+				itemId: item.judgment.inboxItemId
+			},
+			secondaryActions: []
+		}));
+		const background = [...informationItems, ...workbench.background].sort((left, right) => right.updatedAt - left.updatedAt).slice(0, 3);
+		return {
+			...workbench,
+			background,
+			backgroundCount: workbench.backgroundCount + informationItems.length,
 			runningConversations,
 			decisions,
 			attentionPolicy: governed.policy