@xopcai/xopc 0.0.366 → 0.0.367

package/dist/src/gateway/service.js

@@ -31,6 +31,7 @@ import { init_providers, providers_exports } from "../providers/index.js";
 import { AI_USAGE_RETENTION_MS, markStaleAiUsageEventsUnknown, pruneAiUsageEvents } from "../storage/sqlite/ai-usage-repository.js";
 import { listKnowledgeItems } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
+import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { getEmbeddedExecutionSession } from "../agent/embedded/execution-context.js";
 import { disposeAllSessionMcpRuntimes } from "../agent/mcp/bundle-mcp-runtime.js";
@@ -76,12 +77,6 @@ import { ChatPreviewService } from "../chat-previews/service.js";
 import "../chat-previews/index.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/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 { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
 import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
 import "../knowledge/index.js";
@@ -89,17 +84,21 @@ import { PersonalReplyComposer } from "../personal-agent/reply-composer.js";
 import { ConnectionRecoveryService } from "../connectors/connection-recovery-service.js";
 import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
 import { startConnectorSupervisor } from "../connectors/supervisor.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 { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
-import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
-import { HomeIntelligenceHost } from "../home-intelligence/host.js";
-import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
 import { stopTailscaleExposure } from "./tailscale-lifecycle.js";
 import { getGatewayFileSpaceService } from "./file-space-service.js";
 import { reconcileHomeIntelligenceAutomation } from "./home-intelligence-automation-reconciler.js";
+import { PersonalProactivityService } from "../personal-agent/proactivity/service.js";
+import { reconcilePersonalProactivityAutomation } from "../personal-agent/proactivity/automation.js";
 import { createBackgroundTask } from "../infra/background-task.js";
 import { buildTaskAgentContext } from "../agent/source-context/task-context.js";
 import { buildFileAgentContext } from "../agent/source-context/file-context.js";
@@ -153,10 +152,15 @@ import { createGatewayStartupTrace } from "./startup-trace.js";
 import { GatewaySceneHost } from "./scenes/host.js";
 import { TaskCollaborationDelivery } from "../tasks/task-collaboration-delivery.js";
 import { TaskMainUpdateDelivery } from "../tasks/task-main-update-delivery.js";
+import { allowsPersonalTaskNotification, personalReplyNotification, personalRunDelegated } from "../personal-agent/notifications.js";
 import { TaskMainUpdateDecisionService } from "../tasks/task-main-update-decision-service.js";
 import { selectTaskMainUpdateAttempt, submitAndConfirmTaskMainUpdate } from "../tasks/task-main-update-input.js";
 import { checkAppContextAccess, prepareAppContext } from "./service/app-context-access.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.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";
 //#region src/gateway/service.ts
 init_session_repository();
@@ -806,6 +810,7 @@ var GatewayService = class {
 		if (!this.notificationService) this.notificationService = new NotificationService({
 			publish: (type, payload) => this.realtime.broker.publish("gateway", type, payload),
 			allowsNotification: (notification) => {
+				if (!allowsPersonalTaskNotification(notification)) return false;
 				if (notification.target.kind !== "task") return true;
 				const taskId = notification.target.taskId;
 				return (this.sceneHost?.http.activationAdapters.list() ?? []).every((adapter) => adapter.allowsTaskNotification?.(taskId) !== false);
@@ -887,6 +892,16 @@ var GatewayService = class {
 			phase: "task_main_update_dispatch"
 		}, `Main Agent update dispatch failed: ${errorMessage}`);
 	});
+	personalProactivity = new PersonalProactivityService({
+		getConfig: () => this.config,
+		isAvailable: (conversationId) => !this.stopping && !this.agentRunner.hasActiveRun(conversationId) && !this.agentRunner.inputs.isAcceptingInput(conversationId) && (!this.voiceRealtime.hasConversation(conversationId) || this.voiceRealtime.canPublishReply(conversationId)),
+		notify: (conversationId, outreachId) => {
+			this.emit("session.transcript_updated", {
+				key: conversationId,
+				outreachId
+			});
+		}
+	});
 	taskResultDispatch = createBackgroundTask(async () => {
 		const notify = (conversationId, deliveryId) => {
 			this.realtime.broker.publish("sessions", "session.task-result", {
@@ -897,6 +912,8 @@ var GatewayService = class {
 				key: conversationId,
 				deliveryId
 			});
+			const reply = personalReplyNotification(conversationId, deliveryId);
+			if (reply) this.emit("personal.reply.delivered", reply);
 		};
 		await new TaskResultDeliveryService().drain(notify);
 		new PersonalReplyComposer().drain(notify, (conversationId) => !this.agentRunner.hasActiveRun(conversationId) && !this.agentRunner.inputs.isAcceptingInput(conversationId) && (!this.voiceRealtime.hasConversation(conversationId) || this.voiceRealtime.canPublishReply(conversationId))).catch((err) => {
@@ -1394,6 +1411,9 @@ var GatewayService = class {
 		});
 		await trace.measure("automations.initialize", () => this.automationService.initialize());
 		await trace.measure("homeIntelligence.reconcileAutomation", () => reconcileHomeIntelligenceAutomation(this.automationService));
+		this.personalProactivity.start();
+		await trace.measure("personalProactivity.reconcile", () => reconcilePersonalProactivityAutomation(this.automationService));
+		this.personalProactivity.tick();
 		await trace.measure("memoryMaintenance.reconcile", () => this.reconcileMemoryMaintenanceAutomations());
 		await this.notesService.initialize();
 		this.discussionLiveWorker.start();
@@ -1587,6 +1607,7 @@ var GatewayService = class {
 		this.lastChannelConnectDeferSource = "off";
 		await this.channelManager.stop();
 		await this.extensionLoader?.shutdown();
+		await this.personalProactivity.stop();
 		await this.automationService.stop();
 		this.stopSessionTranscriptAutomationEvents?.();
 		this.stopSessionTranscriptAutomationEvents = null;
@@ -1853,6 +1874,10 @@ var GatewayService = class {
 		});
 	}
 	executeSystemAutomationAction(input) {
+		if (input.capability === "personal.proactivity.tick") {
+			this.personalProactivity.tick();
+			return { summary: "Personal attention checks queued" };
+		}
 		if (input.capability === "home.advisor.refresh") {
 			const generationId = this.homeIntelligence.requestRefresh("scheduled_refresh", `automation:${input.runId}`);
 			return { summary: generationId === "disabled" ? "Home AI suggestions are disabled" : `Home advice refresh queued: ${generationId}` };
@@ -1931,7 +1956,20 @@ var GatewayService = class {
 			});
 		}
 		this.realtime.broker.publish("gateway", type, payload);
-		this.createNotificationService().handleGatewayEvent(type, payload);
+		let notificationPayload = payload;
+		if (type === "agent.run.ended" && payload && typeof payload === "object") {
+			const event = payload;
+			if (event.status === "success" && event.conversationId && event.runId && getPersonalAgentByConversation(event.conversationId) && personalRunDelegated(event.conversationId, event.runId)) return;
+			if (event.conversationId && getPersonalAgentByConversation(event.conversationId)) notificationPayload = {
+				...event,
+				target: {
+					kind: "chat",
+					conversationId: event.conversationId,
+					personal: true
+				}
+			};
+		}
+		this.createNotificationService().handleGatewayEvent(type, notificationPayload);
 	}
 	async handleAutomationRunCompleted(run, context) {
 		this.emit("automation.run.completed", {
@@ -1965,6 +2003,7 @@ var GatewayService = class {
 		return this.automationService.ingestEvent(event, options?.targetAutomationIds);
 	}
 	projectAutomationEvent(event) {
+		this.personalProactivity.ingestEvent(event);
 		if (event.source === "local_apps") this.emit(event.type, event.payload);
 		if (event.type === "project.deleted" && typeof event.payload.projectId === "string") {
 			const runIds = event.payload.deletedUnderstandingRunIds;

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

@@ -1,10 +1,10 @@
 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";
 import { HomeOpportunityApplicationService } from "./application-service.js";
-import { HomeAdvicePolicy } from "./policy.js";
-import { HomeAdviceBudgetExceededError } from "./generator.js";
 import { buildHomeOpportunityNotification } from "./notification.js";
 import { createHash } from "node:crypto";
 //#region src/home-intelligence/host.ts

package/dist/src/notifications/planner.js

@@ -42,6 +42,37 @@ function chatPlan(payload) {
 		}
 	};
 }
+function personalReplyPlan(payload) {
+	if (!payload || typeof payload !== "object") return null;
+	const event = payload;
+	if (typeof event.conversationId !== "string" || !event.conversationId || typeof event.deliveryId !== "string" || !event.deliveryId.startsWith("reply:")) return null;
+	const preview = markdownNotificationPreview(typeof event.text === "string" ? event.text : "", 180);
+	const displayName = typeof event.displayName === "string" ? event.displayName.trim().slice(0, 120) : "";
+	return {
+		dedupeKey: `personal.reply:${event.deliveryId}`,
+		notification: {
+			type: event.failed === true ? "chat.failed" : "chat.completed",
+			target: {
+				kind: "chat",
+				conversationId: event.conversationId,
+				personal: true
+			},
+			priority: event.failed === true ? "high" : "normal",
+			title: {
+				en: displayName || "Personal AI",
+				zh: displayName || "Personal AI"
+			},
+			body: preview ? {
+				en: preview,
+				zh: preview
+			} : {
+				en: "Your task result is ready.",
+				zh: "你的任务有了新结果。"
+			},
+			payload: { deliveryId: event.deliveryId }
+		}
+	};
+}
 function taskPlan(payload) {
 	if (!payload || typeof payload !== "object") return null;
 	const data = payload;
@@ -180,6 +211,7 @@ function homeOpportunityPlan(payload) {
 	};
 }
 function notificationPlanFromGatewayEvent(type, payload) {
+	if (type === "personal.reply.delivered") return personalReplyPlan(payload);
 	if (type === "agent.run.ended") return chatPlan(payload);
 	if (type === "task.attention_required.v2" || type === "task.phase_changed.v2") return taskPlan(payload);
 	if (type === "automation.run.completed") return automationPlan(payload);

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

@@ -39,6 +39,7 @@ export declare class NotificationService {
         } | {
             kind: "chat";
             conversationId: string;
+            personal?: boolean;
         } | {
             kind: "task";
             taskId: string;
@@ -79,6 +80,7 @@ export declare class NotificationService {
         } | {
             kind: "chat";
             conversationId: string;
+            personal?: boolean;
         } | {
             kind: "task";
             taskId: string;

package/dist/src/personal-agent/notifications.d.ts

@@ -0,0 +1,4 @@
+import type { ProductNotification } from '@xopcai/gateway-contract';
+export declare function allowsPersonalTaskNotification(notification: Pick<ProductNotification, 'target' | 'type'>): boolean;
+export declare function personalReplyNotification(conversationId: string, deliveryId: string): Record<string, unknown> | null;
+export declare function personalRunDelegated(conversationId: string, runId: string): boolean;

package/dist/src/personal-agent/notifications.js

@@ -0,0 +1,40 @@
+import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
+import { getPersonalAgentByConversation } from "./repository.js";
+//#region src/personal-agent/notifications.ts
+init_transaction();
+function personalTask(taskId) {
+	return Boolean(getSqliteDatabase().prepare(`SELECT 1 FROM task_origin_links o
+    JOIN sessions s ON s.conversation_id = o.conversation_id
+    WHERE o.task_id = ? AND json_extract(s.custom_data_json, '$.personalAgent') = 1`).get(taskId));
+}
+function allowsPersonalTaskNotification(notification) {
+	if (notification.target.kind === "task") return notification.type === "task.needs_input" || !personalTask(notification.target.taskId);
+	if (notification.target.kind === "chat") return !getSqliteDatabase().prepare(`SELECT o.task_id FROM task_sessions w
+      JOIN task_origin_links o ON o.task_id = w.task_id
+      JOIN sessions s ON s.conversation_id = o.conversation_id
+      WHERE w.conversation_id = ? AND json_extract(s.custom_data_json, '$.personalAgent') = 1 LIMIT 1`).get(notification.target.conversationId);
+	return true;
+}
+function personalReplyNotification(conversationId, deliveryId) {
+	if (!deliveryId.startsWith("reply:")) return null;
+	const personal = getPersonalAgentByConversation(conversationId);
+	if (!personal) return null;
+	const row = getSqliteDatabase().prepare(`SELECT reply_text, reply_status, payload_json FROM task_result_deliveries
+    WHERE delivery_id = ? AND conversation_id = ?`).get(deliveryId.slice(6), conversationId);
+	if (!row || row.reply_status !== "delivered") return null;
+	const delivery = JSON.parse(row.payload_json);
+	return {
+		conversationId,
+		deliveryId,
+		text: row.reply_text,
+		displayName: personal.displayName,
+		failed: delivery.outcome.status === "failed" || delivery.outcome.status === "partial"
+	};
+}
+function personalRunDelegated(conversationId, runId) {
+	return Boolean(getSqliteDatabase().prepare(`SELECT 1 FROM task_origin_links o
+    JOIN session_inputs i ON i.id = o.request_input_id
+    WHERE o.conversation_id = ? AND i.run_id = ? LIMIT 1`).get(conversationId, runId));
+}
+//#endregion
+export { allowsPersonalTaskNotification, personalReplyNotification, personalRunDelegated };

package/dist/src/personal-agent/policy.d.ts

@@ -1,3 +1,3 @@
-export declare const PERSONAL_MAIN_TOOL_IDS: readonly ["personal_task", "personal_capability", "personal_request", "personal_preference", "session_recall", "read_media", "read_file", "session_search", "personal_read", "user_context_read", "knowledge_read"];
+export declare const PERSONAL_MAIN_TOOL_IDS: readonly ["personal_task", "personal_attention", "personal_capability", "personal_request", "personal_preference", "session_recall", "read_media", "read_file", "session_search", "personal_read", "user_context_read", "knowledge_read"];
 export declare const PERSONAL_TOOL_DESCRIPTIONS: Readonly<Record<string, string>>;
 export declare const PERSONAL_READ_TOOL_ALIASES: Readonly<Record<string, string>>;

package/dist/src/personal-agent/policy.js

@@ -1,6 +1,7 @@
 //#region src/personal-agent/policy.ts
 const PERSONAL_MAIN_TOOL_IDS = [
 	"personal_task",
+	"personal_attention",
 	"personal_capability",
 	"personal_request",
 	"personal_preference",
@@ -16,6 +17,7 @@ const PERSONAL_TOOL_DESCRIPTIONS = {
 	personal_task: "Choose from the injected specialist snapshot; discover only when missing or after failure. Delegate work, inspect own Tasks, send instructions or answer worker questions. Use an available Agent. Announce intent before discovery; claim success only after confirmation.",
 	personal_capability: "Check verified app connection and specialist availability before connected-app work.",
 	personal_request: "Submit, inspect or cancel connected-app requests. Submit using the connectorId and agentId returned by personal_capability.",
+	personal_attention: "Save explicit requests to check later and proactively report useful developments. The running Gateway checks while the user is away and posts in this chat. Prefer nextCheckLocal; confirm the returned local time and claim saved only after success. No useful development means silence. Valid commands: follow, list, settings, pause, end, resume, interests, feedback, rollback. interests reads silent candidates. feedback applies explicit topic stop/defer/preparation preferences; rollback explicitly undoes the latest strategy version. Query list for IDs and versions. Requires running Gateway; no action authorization or guaranteed notification.",
 	personal_preference: "Save only explicitly requested lasting response preferences.",
 	session_recall: "Find exact facts in this conversation, including compacted history. Cannot access other chats.",
 	session_search: "Search other chats locally for short matching excerpts. No model or network calls.",

package/dist/src/personal-agent/proactivity/automation.d.ts

@@ -0,0 +1,3 @@
+import type { AutomationService } from '../../automations/index.js';
+/** A quiet SQL admission tick; model work is owned by the Personal worker. */
+export declare function reconcilePersonalProactivityAutomation(service: AutomationService): Promise<void>;

package/dist/src/personal-agent/proactivity/automation.js

@@ -0,0 +1,41 @@
+//#region src/personal-agent/proactivity/automation.ts
+/** A quiet SQL admission tick; model work is owned by the Personal worker. */
+async function reconcilePersonalProactivityAutomation(service) {
+	const id = "system-personal-proactivity";
+	const current = await service.get(id);
+	const definition = {
+		name: "Personal AI attention checks",
+		description: "Check due attention and resume pending Personal messages.",
+		enabled: current?.enabled ?? true,
+		trigger: current?.trigger ?? {
+			kind: "schedule",
+			schedule: {
+				kind: "interval",
+				everyMs: 6e4
+			}
+		},
+		action: {
+			kind: "system",
+			capability: "personal.proactivity.tick"
+		},
+		safety: { mode: "auto_apply" },
+		conversationMode: "continuous",
+		delivery: {
+			notificationPolicy: "none",
+			destinations: []
+		},
+		management: {
+			owner: "personal-proactivity",
+			editable: ["enabled", "trigger"],
+			runnable: true,
+			deletable: false
+		}
+	};
+	if (!current) await service.create({
+		id,
+		...definition
+	});
+	else if (JSON.stringify(current.action) !== JSON.stringify(definition.action) || current.delivery.notificationPolicy !== "none") await service.update(id, definition);
+}
+//#endregion
+export { reconcilePersonalProactivityAutomation };

package/dist/src/personal-agent/proactivity/follow-up-request.d.ts

@@ -0,0 +1,5 @@
+/** Recognize user requests, excluding negated and hypothetical follow-ups. */
+export declare function isExplicitFollowUp(text: string): boolean;
+/** Resolve common relative periods from the user's statement, avoiding model epoch arithmetic. */
+export declare function requestedCheckTime(text: string, observedAt: number, timezone: string): number | undefined;
+export declare function parseLocalCheckTime(value: string, timezone: string): number;

package/dist/src/personal-agent/proactivity/follow-up-request.js

@@ -0,0 +1,44 @@
+import { DateTime } from "luxon";
+//#region src/personal-agent/proactivity/follow-up-request.ts
+/** Recognize user requests, excluding negated and hypothetical follow-ups. */
+function isExplicitFollowUp(text) {
+	return text.split(/[。！？!?\n;]/u).some((clause) => {
+		if (/(?:不要|不用|不需要|别|无需|不能|无法).*(?:提醒|跟进|关注|检查|主动|联系|告诉)|(?:don't|do not|no need|cannot|can't).*(?:remind|follow|watch|check|contact)|(?:如果|假如).*(?:我|用户).*(?:要求|说)|(?:if|suppose).*\b(?:ask|request|say)\b/iu.test(clause)) return false;
+		return /提醒我|跟进|帮我.*关注|继续关注|(?:主动|到时候|届时).*(?:告诉我|联系我|通知我)|(?:明天|后天|下周|稍后|晚点|之后).*(?:再|继续).*(?:检查|看看|讨论)|remind me|follow[ -]up|keep (?:an eye|watch)|(?:check (?:again|back)|(?:contact|tell|notify|message) me).*(?:tomorrow|later|next)/iu.test(clause);
+	});
+}
+/** Resolve common relative periods from the user's statement, avoiding model epoch arithmetic. */
+function requestedCheckTime(text, observedAt, timezone) {
+	const match = /(?:明天|后天)(上午|下午|晚上|中午)(?:\s*([0-9]{1,2})(?:[:：]([0-9]{2})|点(?:([0-9]{1,2})分|半)?))?/u.exec(text);
+	if (!match) return void 0;
+	const period = match[1];
+	let hour = match[2] === void 0 ? {
+		上午: 9,
+		下午: 15,
+		晚上: 19,
+		中午: 12
+	}[period] : Number(match[2]);
+	if ([
+		"下午",
+		"晚上",
+		"中午"
+	].includes(period) && hour < 12) hour += 12;
+	const minute = Number(match[3] ?? match[4] ?? (match[0].endsWith("半") ? 30 : 0));
+	if (hour > 23 || minute > 59) throw new Error("Invalid requested follow-up time");
+	const date = DateTime.fromMillis(observedAt, { zone: timezone }).plus({ days: match[0].startsWith("后天") ? 2 : 1 }).set({
+		hour,
+		minute,
+		second: 0,
+		millisecond: 0
+	});
+	if (!date.isValid || date.hour !== hour || date.minute !== minute) throw new Error("Requested follow-up time does not exist in this timezone");
+	return date.toMillis();
+}
+function parseLocalCheckTime(value, timezone) {
+	if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2})?$/u.test(value)) throw new Error("nextCheckLocal must be YYYY-MM-DDTHH:mm in the configured timezone");
+	const date = DateTime.fromISO(value, { zone: timezone });
+	if (!date.isValid || date.toFormat("yyyy-MM-dd'T'HH:mm") !== value.slice(0, 16)) throw new Error("Invalid local follow-up time");
+	return date.toMillis();
+}
+//#endregion
+export { isExplicitFollowUp, parseLocalCheckTime, requestedCheckTime };

package/dist/src/personal-agent/proactivity/repository.d.ts

@@ -0,0 +1,128 @@
+import { type PersonalFeedback, type PersonalProactivitySettings, type PersonalProvenanceDetail } from '@xopcai/gateway-contract';
+export interface AttentionThread {
+    id: string;
+    owner_id: string;
+    agent_id: string;
+    conversation_id: string;
+    subject: string;
+    summary: string;
+    kind: 'outcome' | 'discussion' | 'interest';
+    status: 'candidate' | 'active' | 'paused' | 'completed' | 'expired';
+    authority: 'user_explicit' | 'inferred';
+    task_id: string | null;
+    project_id: string | null;
+    next_check_at: number | null;
+    pause_until: number | null;
+    expires_at: number;
+    last_meaningful_at: number;
+    revision: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface AttentionSource {
+    entryId: string;
+    transcriptId: string;
+    conversationId: string;
+    excerpt: string;
+    processingPolicy: string | null;
+    version: string;
+}
+export interface Wakeup {
+    id: string;
+    thread_id: string;
+    trigger_kind: string;
+    source_event_id: string | null;
+    thread_revision: number;
+    lease_token: string | null;
+    attempts: number;
+    expires_at: number;
+}
+export interface Outreach {
+    id: string;
+    wakeup_id: string;
+    thread_id: string;
+    conversation_id: string;
+    origin_transcript_id: string;
+    thread_revision: number;
+    context_revision: number;
+    policy_revision: number;
+    decision: string;
+    reason: string;
+    state: string;
+    text: string | null;
+    provenance_json: string;
+    valid_until: number;
+    message_entry_id: string | null;
+    notified_at: number | null;
+    created_at: number;
+    published_at: number | null;
+}
+export declare function getProactivitySettings(ownerId: string): PersonalProactivitySettings;
+export declare function patchProactivitySettings(ownerId: string, input: PersonalProactivitySettings): PersonalProactivitySettings;
+export declare function localDay(now: number, timezone: string): string;
+export declare function isQuiet(now: number, settings: PersonalProactivitySettings): boolean;
+export declare function reserveModelCall(ownerId: string, now: number): boolean;
+export declare function getAttention(id: string, ownerId?: string): AttentionThread | undefined;
+export declare function listAttention(conversationId: string): AttentionThread[];
+export declare function getAttentionSources(threadId: string, entryIds?: string[]): AttentionSource[];
+export declare function userText(payload: {
+    content?: unknown;
+}): string;
+export declare function sourceFingerprint(sources: AttentionSource[]): string;
+/** Only user transcript rows can establish attention; inferred attention never grants work authorization. */
+export declare function saveAttention(input: {
+    conversationId: string;
+    subject: string;
+    summary: string;
+    kind: AttentionThread['kind'];
+    entryIds: string[];
+    explicit: boolean;
+    nextCheckAt: number;
+    taskId?: string;
+    projectId?: string;
+}, now?: number): AttentionThread;
+export declare function patchAttention(ownerId: string, id: string, revision: number, patch: {
+    status?: 'candidate' | 'active' | 'paused' | 'completed';
+    nextCheckAt?: number | null;
+}, now?: number): AttentionThread;
+export declare function enqueueWakeup(thread: AttentionThread, kind: string, identity: string, now?: number): void;
+export declare function enqueueDue(now?: number): void;
+export declare function getOutreach(id: string, ownerId?: string): Outreach | undefined;
+export declare function provenanceDetail(ownerId: string, id: string): PersonalProvenanceDetail | undefined;
+export declare function recordFeedback(ownerId: string, id: string, raw: PersonalFeedback, now?: number): void;
+export declare function listInterestCandidates(conversationId: string, now?: number): {
+    lastSupportedAt: number;
+    expiresAt: number;
+    sources: {
+        excerpt: string;
+        entryId: string;
+        observedAt: number;
+    }[];
+    independentStatements: number;
+    independentDays: number;
+    confidence: number;
+    id: string;
+    subject: string;
+    summary: string;
+    status: "expired" | "completed" | "active" | "paused" | "candidate";
+}[];
+export declare function preparationStrategy(threadId: string, now?: number): 'brief' | 'thorough' | null;
+export declare function strategyState(threadId: string, now?: number): {
+    preparation: "brief" | "thorough";
+    versions: {
+        id: string;
+        revision: number;
+        kind: "stop" | "defer" | "adjust" | "rollback";
+        createdAt: number;
+        preparation: "brief" | "thorough";
+    }[];
+};
+export declare function applyThreadFeedback(ownerId: string, threadId: string, revision: number, raw: PersonalFeedback, source?: {
+    feedbackId?: string;
+    entryId?: string;
+}, now?: number): AttentionThread;
+export declare function rollbackStrategy(ownerId: string, threadId: string, raw: {
+    versionId: string;
+    revision: number;
+    idempotencyKey: string;
+}, sourceEntryId?: string, now?: number): AttentionThread;