@xopcai/xopc 0.0.161 → 0.0.162

package/dist/src/proactive/value-score.d.ts

@@ -0,0 +1,13 @@
+import type { FocusWatchKind } from './types.js';
+export interface ProactiveValueScore {
+    score: number;
+    reasons: string[];
+    shouldDeliver: boolean;
+}
+export declare function scoreProactiveValue(input: {
+    kind: FocusWatchKind;
+    evidenceCount: number;
+    hasNextAction: boolean;
+    approvedCount: number;
+    dismissedCount: number;
+}): ProactiveValueScore;

package/dist/src/proactive/value-score.js

@@ -0,0 +1,30 @@
+//#region src/proactive/value-score.ts
+function scoreProactiveValue(input) {
+	const reasons = [];
+	let score = .15;
+	if (input.evidenceCount > 0) {
+		score += Math.min(.25, input.evidenceCount * .1);
+		reasons.push("evidence_backed");
+	}
+	if (input.hasNextAction) {
+		score += .25;
+		reasons.push("actionable");
+	}
+	const urgency = input.kind === "deadline" ? .25 : input.kind === "staleness" ? .2 : .15;
+	score += urgency;
+	reasons.push(input.kind === "deadline" ? "time_sensitive" : "focus_relevant");
+	const rated = input.approvedCount + input.dismissedCount;
+	if (rated > 0) {
+		const approvalRate = input.approvedCount / rated;
+		score += (approvalRate - .5) * .4;
+		reasons.push(approvalRate >= .5 ? "historically_useful" : "historically_dismissed");
+	}
+	score = Math.max(0, Math.min(1, score));
+	return {
+		score,
+		reasons,
+		shouldDeliver: score >= .65
+	};
+}
+//#endregion
+export { scoreProactiveValue };

package/dist/src/share/share-types.js

@@ -3,9 +3,9 @@
 const SHARE_CONFIG_DEFAULTS = {
 	enabled: true,
 	defaultTtlMs: 864e5,
-	maxTtlMs: 6048e5,
-	maxActiveShares: 100,
-	maxFileSize: 104857600,
+	maxTtlMs: 2592e6,
+	maxActiveShares: 500,
+	maxFileSize: 524288e3,
 	inlinePreviewMimes: [
 		"image/png",
 		"image/jpeg",
@@ -20,8 +20,8 @@ const SHARE_CONFIG_DEFAULTS = {
 	],
 	directory: {
 		enabled: true,
-		maxFolderSize: 1073741824,
-		maxFileCount: 1e3,
+		maxFolderSize: 2147483648,
+		maxFileCount: 1e4,
 		maxDepth: 20,
 		listingCacheMs: 6e4,
 		zipConcurrency: 1

package/dist/src/share/site-share-types.d.ts

@@ -60,7 +60,7 @@ export interface CreateSiteShareParams {
     path?: string;
     /** Proxy: full upstream URL (must be loopback or whitelisted). */
     upstreamUrl?: string;
-    /** Default 6h. */
+    /** Default 24h. */
     ttlMs?: number;
     /** Optional friendly description. */
     description?: string;

package/dist/src/share/site-share-types.js

@@ -2,13 +2,13 @@
 const SITE_SHARE_CONFIG_DEFAULTS = {
 	enabled: true,
 	publicHostSuffix: "share.xopc.ai",
-	defaultTtlMs: 216e5,
-	maxTtlMs: 6048e5,
-	maxActiveSites: 5,
+	defaultTtlMs: 864e5,
+	maxTtlMs: 2592e6,
+	maxActiveSites: 50,
 	static: {
 		enabled: true,
-		maxRootDirSize: 524288e3,
-		maxFileCount: 1e4,
+		maxRootDirSize: 1073741824,
+		maxFileCount: 2e4,
 		rewriteEnabledByDefault: false
 	},
 	proxy: {

package/dist/src/storage/sqlite/index.d.ts

@@ -5,6 +5,9 @@ export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, } from './m
 export { discoverSqlMigrations, listRegisteredMigrationTargets } from './migrations/discover.js';
 export { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest, type OpenXopcDatabaseOptions, type XopcDatabase, } from './connection.js';
 export { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';
+export { getInteractionState, setInteractionState, updateInteractionStateFromMessage, type InteractionState, } from './interaction-state-repository.js';
+export { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings, type RelationshipSettings, type SupportMode, } from './relationship-settings-repository.js';
+export { completeTaskOutcome, findTaskOutcomeForAssistant, getTaskOutcome, listTaskOutcomes, setTaskOutcomeFeedback, startTaskOutcome, summarizeTaskOutcomes, updateTaskOutcome, type TaskContract, type TaskEvidence, type TaskFeedbackOutcome, type TaskOutcome, type TaskOutcomeMetrics, type TaskOutcomeStatus, } from './task-outcome-repository.js';
 export { buildDefaultSessionMetadata, type SessionMetadataSeed, } from './session-metadata.js';
 export { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow, type SessionConfigRow, type SessionRow, type TranscriptEntryRow, } from './row-mappers.js';
 export { deleteSessionRecord, ensureSessionRecord, getCurrentSessionId, getGlobalSessionStats, findSessionKeyBySessionId, getSessionPersistedLevels, getSessionMetadata, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats, } from './session-repository.js';

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

@@ -6,6 +6,9 @@ import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMi
 import { ensureXopcDatabaseSchema } from "./schema.js";
 import { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest } from "./connection.js";
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getInteractionState, setInteractionState, updateInteractionStateFromMessage } from "./interaction-state-repository.js";
+import { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings } from "./relationship-settings-repository.js";
+import { completeTaskOutcome, findTaskOutcomeForAssistant, getTaskOutcome, listTaskOutcomes, setTaskOutcomeFeedback, startTaskOutcome, summarizeTaskOutcomes, updateTaskOutcome } from "./task-outcome-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";
@@ -21,4 +24,4 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
 import { consumeMemoryReferenceConsent, decideMemoryReferenceConsent, ensureMemoryReferenceConsentRequest, hasMemoryReferenceConsent, listMemoryReferenceConsents, revokeMemoryReferenceConsent } from "./memory-reference-consent-repository.js";
 import { getUserProfilePromptState, setUserProfilePromptState } from "./user-profile-setup-repository.js";
-export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, classifyStoredRow, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCompactionCheckpointDetail, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionCheckpoints, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };
+export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, captureCompactionCheckpoint, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, classifyStoredRow, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, completeTaskOutcome, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findLatestMemoryInjectTrace, findSessionKeyBySessionId, findTaskOutcomeForAssistant, finishKnowledgeSyncRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCompactionCheckpointDetail, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getCurrentSessionId, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getTaskOutcome, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isProactiveSupportAllowed, isXopcDatabaseOpen, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionCheckpoints, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTaskOutcomes, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setLatestMemoryInjectFeedback, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, setTaskOutcomeFeedback, setUserProfilePromptState, setUserTrustPolicy, startKnowledgeSyncRun, startTaskOutcome, summarizeMemoryRecallFeedback, summarizeTaskOutcomes, summarizeUserUnderstandingQuality, syncMemoryIndex, transcriptEntryRowToStoredRow, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateTaskOutcome, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };

package/dist/src/storage/sqlite/interaction-state-repository.d.ts

@@ -0,0 +1,17 @@
+import { type InteractionStateSignal } from '../../user-context/interaction-state.js';
+export interface InteractionState extends InteractionStateSignal {
+    sessionKey: string;
+    expiresAt: number;
+    updatedAt: number;
+}
+export declare function getInteractionState(sessionKey: string, now?: number): InteractionState | undefined;
+export declare function setInteractionState(input: {
+    sessionKey: string;
+    signal: InteractionStateSignal;
+    now?: number;
+}): InteractionState;
+export declare function updateInteractionStateFromMessage(input: {
+    sessionKey: string;
+    message: string;
+    now?: number;
+}): InteractionState;

package/dist/src/storage/sqlite/interaction-state-repository.js

@@ -0,0 +1,60 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { inferInteractionState } from "../../user-context/interaction-state.js";
+//#region src/storage/sqlite/interaction-state-repository.ts
+const STATE_TTL_MS = 360 * 60 * 1e3;
+function fromRow(row) {
+	return {
+		sessionKey: row.session_key,
+		supportNeed: row.support_need,
+		...row.emotion_hypothesis ? { emotionHypothesis: row.emotion_hypothesis } : {},
+		confidence: row.confidence,
+		source: row.source,
+		repairStatus: row.repair_status,
+		...row.repair_reason ? { repairReason: row.repair_reason } : {},
+		expiresAt: row.expires_at,
+		updatedAt: row.updated_at
+	};
+}
+function getInteractionState(sessionKey, now = Date.now()) {
+	const row = getSqliteDatabase().prepare(`SELECT session_key, support_need, emotion_hypothesis, confidence, source,
+            repair_status, repair_reason, expires_at, updated_at
+     FROM interaction_states WHERE session_key = ? AND expires_at > ?`).get(sessionKey, now);
+	return row ? fromRow(row) : void 0;
+}
+function setInteractionState(input) {
+	const now = input.now ?? Date.now();
+	const expiresAt = now + STATE_TTL_MS;
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO interaction_states (
+        session_key, support_need, emotion_hypothesis, confidence, source,
+        repair_status, repair_reason, expires_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(session_key) DO UPDATE SET
+        support_need = excluded.support_need,
+        emotion_hypothesis = excluded.emotion_hypothesis,
+        confidence = excluded.confidence,
+        source = excluded.source,
+        repair_status = excluded.repair_status,
+        repair_reason = excluded.repair_reason,
+        expires_at = excluded.expires_at,
+        updated_at = excluded.updated_at`).run(input.sessionKey, input.signal.supportNeed, input.signal.emotionHypothesis ?? null, input.signal.confidence, input.signal.source, input.signal.repairStatus, input.signal.repairReason ?? null, expiresAt, now);
+	});
+	return getInteractionState(input.sessionKey, now);
+}
+function updateInteractionStateFromMessage(input) {
+	const now = input.now ?? Date.now();
+	const previous = getInteractionState(input.sessionKey, now);
+	const inferred = inferInteractionState(input.message);
+	const signal = previous?.repairStatus === "needed" && inferred.repairStatus === "none" ? {
+		...inferred,
+		repairStatus: "needed",
+		repairReason: previous.repairReason
+	} : inferred;
+	return setInteractionState({
+		sessionKey: input.sessionKey,
+		signal,
+		now
+	});
+}
+//#endregion
+export { getInteractionState, setInteractionState, updateInteractionStateFromMessage };

package/dist/src/storage/sqlite/memory-records-repository.js

@@ -1,6 +1,6 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
-import { buildFts5SearchQuery, fts5RankToScore, memoryLexicalSimilarity } from "./fts.js";
 import { LOCAL_USER_ID } from "../../user-context/owner.js";
+import { buildFts5SearchQuery, fts5RankToScore, memoryLexicalSimilarity } from "./fts.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/memory-records-repository.ts
 const USER_UNDERSTANDING_REMEDIATION_POLICY = {

package/dist/src/storage/sqlite/migrations/053_browser_recipes.sql

@@ -0,0 +1,45 @@
+CREATE TABLE IF NOT EXISTS browser_recipes (
+  recipe_id TEXT PRIMARY KEY,
+  revision INTEGER NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  status TEXT NOT NULL CHECK (status IN ('published', 'disabled')),
+  yaml_source TEXT NOT NULL,
+  risk_level TEXT NOT NULL CHECK (risk_level IN ('read_only', 'account_write', 'sensitive')),
+  domains_json TEXT NOT NULL,
+  created_at_ms INTEGER NOT NULL,
+  updated_at_ms INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS browser_recipe_runs (
+  run_id TEXT PRIMARY KEY,
+  recipe_id TEXT NOT NULL,
+  recipe_revision INTEGER NOT NULL,
+  recipe_yaml TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('queued', 'running', 'succeeded', 'failed', 'cancelled')),
+  args_json TEXT NOT NULL,
+  result_json TEXT,
+  error TEXT,
+  created_at_ms INTEGER NOT NULL,
+  started_at_ms INTEGER,
+  ended_at_ms INTEGER,
+  duration_ms INTEGER,
+  FOREIGN KEY (recipe_id) REFERENCES browser_recipes(recipe_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_browser_recipe_runs_recipe_created
+  ON browser_recipe_runs(recipe_id, created_at_ms DESC);
+
+CREATE TABLE IF NOT EXISTS browser_recipe_run_events (
+  event_id TEXT PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  seq INTEGER NOT NULL,
+  type TEXT NOT NULL,
+  data_json TEXT,
+  created_at_ms INTEGER NOT NULL,
+  UNIQUE(run_id, seq),
+  FOREIGN KEY (run_id) REFERENCES browser_recipe_runs(run_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_browser_recipe_run_events_run_seq
+  ON browser_recipe_run_events(run_id, seq ASC);

package/dist/src/storage/sqlite/migrations/054_task_outcomes.sql

@@ -0,0 +1,24 @@
+CREATE TABLE task_outcomes (
+  run_id TEXT PRIMARY KEY,
+  session_key TEXT NOT NULL,
+  channel TEXT NOT NULL,
+  objective TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('running', 'succeeded', 'failed', 'cancelled')),
+  summary TEXT,
+  contract_json TEXT,
+  evidence_json TEXT NOT NULL DEFAULT '[]',
+  feedback_outcome TEXT CHECK (feedback_outcome IN ('helpful', 'not_helpful')),
+  feedback_reason TEXT,
+  needs_correction INTEGER CHECK (needs_correction IN (0, 1)),
+  support_fit INTEGER CHECK (support_fit IN (0, 1)),
+  started_at INTEGER NOT NULL,
+  completed_at INTEGER,
+  updated_at INTEGER NOT NULL,
+  FOREIGN KEY (session_key) REFERENCES sessions(session_key) ON DELETE CASCADE
+);
+
+CREATE INDEX idx_task_outcomes_session_started
+  ON task_outcomes(session_key, started_at DESC);
+
+CREATE INDEX idx_task_outcomes_status_started
+  ON task_outcomes(status, started_at DESC);

package/dist/src/storage/sqlite/migrations/055_relationship_settings.sql

@@ -0,0 +1,14 @@
+CREATE TABLE relationship_settings (
+  owner_id TEXT PRIMARY KEY CHECK (owner_id = 'local-owner'),
+  support_mode TEXT NOT NULL CHECK (support_mode IN ('efficient', 'coach', 'companion', 'auto')),
+  proactive_enabled INTEGER NOT NULL CHECK (proactive_enabled IN (0, 1)),
+  quiet_start TEXT,
+  quiet_end TEXT,
+  allowed_topics_json TEXT NOT NULL,
+  blocked_topics_json TEXT NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+INSERT INTO relationship_settings (
+  owner_id, support_mode, proactive_enabled, allowed_topics_json, blocked_topics_json, updated_at
+) VALUES ('local-owner', 'auto', 0, '[]', '[]', unixepoch() * 1000);

package/dist/src/storage/sqlite/migrations/056_task_verification.sql

@@ -0,0 +1,6 @@
+ALTER TABLE task_outcomes ADD COLUMN verification_status TEXT NOT NULL DEFAULT 'unverified'
+  CHECK (verification_status IN ('passed', 'failed', 'unverified'));
+ALTER TABLE task_outcomes ADD COLUMN verification_json TEXT NOT NULL DEFAULT '{"checks":[]}';
+ALTER TABLE task_outcomes ADD COLUMN failure_code TEXT;
+ALTER TABLE task_outcomes ADD COLUMN failure_phase TEXT;
+ALTER TABLE task_outcomes ADD COLUMN recovery_action TEXT;

package/dist/src/storage/sqlite/migrations/057_interaction_states.sql

@@ -0,0 +1,11 @@
+CREATE TABLE interaction_states (
+  session_key TEXT PRIMARY KEY REFERENCES sessions(session_key) ON DELETE CASCADE,
+  support_need TEXT NOT NULL CHECK (support_need IN ('listen', 'clarify', 'advise', 'act', 'unknown')),
+  emotion_hypothesis TEXT,
+  confidence REAL NOT NULL CHECK (confidence >= 0 AND confidence <= 1),
+  source TEXT NOT NULL CHECK (source IN ('explicit', 'inferred')),
+  repair_status TEXT NOT NULL CHECK (repair_status IN ('none', 'needed', 'repaired')),
+  repair_reason TEXT,
+  expires_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);

package/dist/src/storage/sqlite/migrations/058_proactive_value.sql

@@ -0,0 +1,3 @@
+ALTER TABLE proactive_insights ADD COLUMN value_score REAL NOT NULL DEFAULT 0
+  CHECK (value_score >= 0 AND value_score <= 1);
+ALTER TABLE proactive_insights ADD COLUMN value_reasons_json TEXT NOT NULL DEFAULT '[]';

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 = 52;
+export declare const XOPC_DB_SCHEMA_VERSION = 58;
 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 = 52;
+const XOPC_DB_SCHEMA_VERSION = 58;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function resolveMigrationsDir(override) {
 	if (override) return override;
@@ -46,7 +46,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 ?? 52;
+	const targetVersion = options.targetVersion ?? 58;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -62,7 +62,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 52;
+	const appVersion = options.targetVersion ?? 58;
 	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 = 52;
+export const XOPC_DB_SCHEMA_VERSION = 58;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/relationship-settings-repository.d.ts

@@ -0,0 +1,17 @@
+export type SupportMode = 'efficient' | 'coach' | 'companion' | 'auto';
+export interface RelationshipSettings {
+    supportMode: SupportMode;
+    proactiveEnabled: boolean;
+    quietStart?: string;
+    quietEnd?: string;
+    allowedTopics: string[];
+    blockedTopics: string[];
+    updatedAt: number;
+}
+export declare function getRelationshipSettings(): RelationshipSettings;
+export declare function updateRelationshipSettings(patch: Partial<Omit<RelationshipSettings, 'updatedAt'>>): RelationshipSettings;
+export declare function buildRelationshipPrompt(settings: RelationshipSettings): string;
+export declare function isProactiveSupportAllowed(settings: RelationshipSettings, input: {
+    now: Date;
+    topic: string;
+}): boolean;

package/dist/src/storage/sqlite/relationship-settings-repository.js

@@ -0,0 +1,64 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { LOCAL_USER_ID } from "../../user-context/owner.js";
+//#region src/storage/sqlite/relationship-settings-repository.ts
+function fromRow(row) {
+	return {
+		supportMode: row.support_mode,
+		proactiveEnabled: row.proactive_enabled === 1,
+		...row.quiet_start ? { quietStart: row.quiet_start } : {},
+		...row.quiet_end ? { quietEnd: row.quiet_end } : {},
+		allowedTopics: JSON.parse(row.allowed_topics_json),
+		blockedTopics: JSON.parse(row.blocked_topics_json),
+		updatedAt: row.updated_at
+	};
+}
+function getRelationshipSettings() {
+	return fromRow(getSqliteDatabase().prepare(`SELECT support_mode, proactive_enabled, quiet_start, quiet_end,
+              allowed_topics_json, blocked_topics_json, updated_at
+       FROM relationship_settings WHERE owner_id = ?`).get(LOCAL_USER_ID));
+}
+function updateRelationshipSettings(patch) {
+	const next = {
+		...getRelationshipSettings(),
+		...patch,
+		updatedAt: Date.now()
+	};
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`UPDATE relationship_settings
+       SET support_mode = ?, proactive_enabled = ?, quiet_start = ?, quiet_end = ?,
+           allowed_topics_json = ?, blocked_topics_json = ?, updated_at = ?
+       WHERE owner_id = ?`).run(next.supportMode, Number(next.proactiveEnabled), next.quietStart ?? null, next.quietEnd ?? null, JSON.stringify(next.allowedTopics), JSON.stringify(next.blockedTopics), next.updatedAt, LOCAL_USER_ID);
+	});
+	return next;
+}
+function buildRelationshipPrompt(settings) {
+	return [
+		"## Support mode",
+		{
+			efficient: "Prioritize direct action and concise answers. Acknowledge emotion briefly only when it materially helps.",
+			coach: "Help the user clarify goals and move forward. Ask focused questions and turn reflection into practical next steps.",
+			companion: "Acknowledge the user’s experience before offering solutions. Do not rush advice; ask whether they want listening or action when unclear.",
+			auto: "Infer whether the user needs listening, validation, analysis, advice, or action. Ask one concise question when the need is ambiguous."
+		}[settings.supportMode],
+		"Never claim to have human feelings, encourage exclusivity or dependency, use guilt, or present yourself as a replacement for human relationships or professional care.",
+		"Treat inferred emotions as hypotheses, not facts. In high-risk situations, encourage timely support from trusted people or appropriate emergency/professional services."
+	].join("\n\n");
+}
+function isProactiveSupportAllowed(settings, input) {
+	if (!settings.proactiveEnabled) return false;
+	const topic = input.topic.trim().toLocaleLowerCase();
+	if (settings.blockedTopics.map((value) => value.toLocaleLowerCase()).includes(topic)) return false;
+	const allowed = settings.allowedTopics.map((value) => value.toLocaleLowerCase());
+	if (allowed.length > 0 && !allowed.includes(topic)) return false;
+	if (!settings.quietStart || !settings.quietEnd) return true;
+	const minutes = input.now.getHours() * 60 + input.now.getMinutes();
+	const toMinutes = (value) => {
+		const [hours, minute] = value.split(":").map(Number);
+		return hours * 60 + minute;
+	};
+	const start = toMinutes(settings.quietStart);
+	const end = toMinutes(settings.quietEnd);
+	return !(start <= end ? minutes >= start && minutes < end : minutes >= start || minutes < end);
+}
+//#endregion
+export { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings };

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

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 52 });
+	applyPendingMigrations(db, { targetVersion: 58 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

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

@@ -724,3 +724,49 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_memory_reference_consents_pending
 
 CREATE INDEX IF NOT EXISTS idx_memory_reference_consents_resolution
   ON memory_reference_consents(record_id, status, session_key, expires_at);
+
+CREATE TABLE IF NOT EXISTS browser_recipes (
+  recipe_id TEXT PRIMARY KEY,
+  revision INTEGER NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  status TEXT NOT NULL CHECK (status IN ('published', 'disabled')),
+  yaml_source TEXT NOT NULL,
+  risk_level TEXT NOT NULL CHECK (risk_level IN ('read_only', 'account_write', 'sensitive')),
+  domains_json TEXT NOT NULL,
+  created_at_ms INTEGER NOT NULL,
+  updated_at_ms INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS browser_recipe_runs (
+  run_id TEXT PRIMARY KEY,
+  recipe_id TEXT NOT NULL,
+  recipe_revision INTEGER NOT NULL,
+  recipe_yaml TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('queued', 'running', 'succeeded', 'failed', 'cancelled')),
+  args_json TEXT NOT NULL,
+  result_json TEXT,
+  error TEXT,
+  created_at_ms INTEGER NOT NULL,
+  started_at_ms INTEGER,
+  ended_at_ms INTEGER,
+  duration_ms INTEGER,
+  FOREIGN KEY (recipe_id) REFERENCES browser_recipes(recipe_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_browser_recipe_runs_recipe_created
+  ON browser_recipe_runs(recipe_id, created_at_ms DESC);
+
+CREATE TABLE IF NOT EXISTS browser_recipe_run_events (
+  event_id TEXT PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  seq INTEGER NOT NULL,
+  type TEXT NOT NULL,
+  data_json TEXT,
+  created_at_ms INTEGER NOT NULL,
+  UNIQUE(run_id, seq),
+  FOREIGN KEY (run_id) REFERENCES browser_recipe_runs(run_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_browser_recipe_run_events_run_seq
+  ON browser_recipe_run_events(run_id, seq ASC);

package/dist/src/storage/sqlite/task-outcome-repository.d.ts

@@ -0,0 +1,90 @@
+import { type TaskFailureCode, type TaskFailurePhase, type TaskRecoveryAction, type TaskVerification } from '../../agent/outcomes/task-verifier.js';
+export type TaskOutcomeStatus = 'running' | 'succeeded' | 'failed' | 'cancelled';
+export type TaskFeedbackOutcome = 'helpful' | 'not_helpful';
+export interface TaskContract {
+    objective: string;
+    deliverables: string[];
+    acceptanceCriteria: string[];
+    constraints: string[];
+    approvalRequired: string[];
+}
+export interface TaskEvidence {
+    kind: 'artifact' | 'test' | 'state' | 'source';
+    title: string;
+    summary: string;
+    uri?: string;
+    verifies?: string[];
+}
+export interface TaskOutcome {
+    runId: string;
+    sessionKey: string;
+    channel: string;
+    objective: string;
+    status: TaskOutcomeStatus;
+    summary?: string;
+    contract?: TaskContract;
+    evidence: TaskEvidence[];
+    verification: TaskVerification;
+    failure?: {
+        code: TaskFailureCode;
+        phase: TaskFailurePhase;
+        recoveryAction: TaskRecoveryAction;
+    };
+    feedback?: {
+        outcome: TaskFeedbackOutcome;
+        reason?: string;
+        needsCorrection?: boolean;
+        supportFit?: boolean;
+    };
+    startedAt: number;
+    completedAt?: number;
+    updatedAt: number;
+}
+export interface TaskOutcomeMetrics {
+    total: number;
+    completed: number;
+    succeeded: number;
+    verified: number;
+    helpful: number;
+    notHelpful: number;
+    completionRate: number;
+    successRate: number;
+    verificationRate: number;
+    helpfulRate: number;
+}
+export declare function startTaskOutcome(input: {
+    runId: string;
+    sessionKey: string;
+    channel: string;
+    objective: string;
+    now?: number;
+}): TaskOutcome;
+export declare function completeTaskOutcome(input: {
+    runId: string;
+    status: Exclude<TaskOutcomeStatus, 'running'>;
+    summary: string;
+    now?: number;
+}): TaskOutcome | undefined;
+export declare function updateTaskOutcome(input: {
+    runId: string;
+    contract?: TaskContract;
+    evidence?: TaskEvidence[];
+    summary?: string;
+    now?: number;
+}): TaskOutcome | undefined;
+export declare function setTaskOutcomeFeedback(input: {
+    sessionKey: string;
+    assistantTimestamp: number;
+    outcome: TaskFeedbackOutcome;
+    reason?: string;
+    needsCorrection?: boolean;
+    supportFit?: boolean;
+    now?: number;
+}): TaskOutcome | undefined;
+export declare function getTaskOutcome(runId: string): TaskOutcome | undefined;
+export declare function findTaskOutcomeForAssistant(sessionKey: string, assistantTimestamp: number): TaskOutcome | undefined;
+export declare function listTaskOutcomes(input?: {
+    sessionKey?: string;
+    limit?: number;
+}): TaskOutcome[];
+export declare function summarizeTaskOutcomes(): TaskOutcomeMetrics;