@xopcai/xopc 0.0.364 → 0.0.367

package/dist/src/gateway/service/session-input-coordinator.js

@@ -34,11 +34,16 @@ function contextRefsMatchFrozenSnapshot(requested, frozen) {
 	});
 }
 var SessionInputCoordinator = class {
+	pendingSubmissions = /* @__PURE__ */ new Map();
+	resumeAfter = /* @__PURE__ */ new Map();
 	draining = /* @__PURE__ */ new Set();
 	submissionTails = /* @__PURE__ */ new Map();
 	constructor(deps) {
 		this.deps = deps;
 	}
+	isAcceptingInput(conversationId) {
+		return (this.pendingSubmissions.get(conversationId) ?? 0) > 0;
+	}
 	snapshot(conversationId) {
 		return getSessionInputState(conversationId);
 	}
@@ -52,6 +57,7 @@ var SessionInputCoordinator = class {
 			content: input.content.trim(),
 			attachments,
 			contextRefs: contexts.map(summarizeSourceContext),
+			interruptRequested: input.interrupt !== false && this.deps.prioritizeInput?.(input) === true,
 			contextSnapshots: contexts,
 			thinking: input.thinking,
 			origin: input.origin
@@ -63,7 +69,12 @@ var SessionInputCoordinator = class {
 		await this.runSubmissionExclusive(input.conversationId, async () => {
 			const row = getSessionInputById(conversationId, inputId);
 			const state = this.snapshot(input.conversationId);
-			if (!row || row.status !== "queued" || row.requestedDelivery !== "steer" || !state.activeRunId || row.attachments?.length || row.contextSnapshots?.length || state.preparation && state.preparation.state !== "ready") return;
+			if (!row || row.status !== "queued") return;
+			if (row.interruptRequested) {
+				this.prioritizeAcceptedInput(row, state);
+				return;
+			}
+			if (row.requestedDelivery !== "steer" || !state.activeRunId || row.attachments?.length || row.contextSnapshots?.length || state.preparation && state.preparation.state !== "ready") return;
 			setSessionInputStatus(row.id, "injecting", {
 				effectiveDelivery: "steer",
 				targetRunId: state.activeRunId
@@ -83,6 +94,26 @@ var SessionInputCoordinator = class {
 			this.publish(row.conversationId);
 		});
 	}
+	prioritizeAcceptedInput(row, runtime) {
+		const conversationId = row.conversationId;
+		this.resumeAfter.set(conversationId, Date.now() + (this.deps.coalesceWindowMs ?? 200));
+		this.publish(conversationId);
+		if (runtime.activeRunId && this.deps.interrupt) {
+			this.deps.emit("session.input-interrupt", {
+				conversationId,
+				runId: runtime.activeRunId,
+				inputId: row.id
+			});
+			this.deps.interrupt(conversationId, runtime.activeRunId).catch((err) => {
+				log.warn({
+					err,
+					conversationId,
+					runId: runtime.activeRunId
+				}, "Conversation interruption failed; accepted input remains queued");
+			});
+		}
+		this.drain(conversationId);
+	}
 	publish(conversationId) {
 		const state = this.snapshot(conversationId);
 		this.deps.emit("session.input-state", state);
@@ -104,15 +135,25 @@ var SessionInputCoordinator = class {
 			if (this.submissionTails.get(conversationId) === tail) this.submissionTails.delete(conversationId);
 		}
 	}
+	async withSubmission(conversationId, operation) {
+		this.deps.onInputReceived?.(conversationId);
+		this.pendingSubmissions.set(conversationId, (this.pendingSubmissions.get(conversationId) ?? 0) + 1);
+		try {
+			return await operation();
+		} finally {
+			const remaining = (this.pendingSubmissions.get(conversationId) ?? 1) - 1;
+			if (remaining) this.pendingSubmissions.set(conversationId, remaining);
+			else this.pendingSubmissions.delete(conversationId);
+		}
+	}
 	async submit(input) {
 		input = structuredClone(input);
 		const conversationId = input.conversationId.trim();
-		this.deps.onInputReceived?.(conversationId);
 		try {
-			return await this.runSubmissionExclusive(conversationId, () => this.submitLocked({
+			return await this.withSubmission(conversationId, () => this.runSubmissionExclusive(conversationId, () => this.submitLocked({
 				...input,
 				conversationId
-			}));
+			})));
 		} catch (error) {
 			if (error instanceof SessionInstanceChangedError) return {
 				ok: false,
@@ -242,7 +283,8 @@ var SessionInputCoordinator = class {
 			};
 		}
 		const runtime = this.snapshot(conversationId);
-		const canSteer = input.delivery === "steer" && runtime.activeRunId !== void 0 && !attachments?.length && !sourceContexts?.length;
+		const priority = input.interrupt !== false && this.deps.prioritizeInput?.(input) === true;
+		const canSteer = !priority && input.delivery === "steer" && runtime.activeRunId !== void 0 && !attachments?.length && !sourceContexts?.length;
 		const effectiveDelivery = canSteer ? "steer" : "next";
 		const row = insertSessionInput({
 			expectedTranscriptId: input.expectedTranscriptId,
@@ -250,6 +292,7 @@ var SessionInputCoordinator = class {
 			conversationId,
 			clientMessageId,
 			requestedDelivery: input.delivery,
+			interruptRequested: priority,
 			effectiveDelivery,
 			status: canSteer ? "injecting" : "queued",
 			content,
@@ -262,6 +305,14 @@ var SessionInputCoordinator = class {
 		});
 		invalidateConnectionResumeIntent(conversationId);
 		supersedeActiveClarification(conversationId);
+		if (priority) {
+			this.prioritizeAcceptedInput(row, runtime);
+			return {
+				ok: true,
+				effectiveDelivery: "next",
+				state: this.publish(conversationId)
+			};
+		}
 		if (canSteer) {
 			if (!await this.deps.steer(conversationId, content)) {
 				setSessionInputStatus(row.id, "queued", {
@@ -293,6 +344,12 @@ var SessionInputCoordinator = class {
 		this.draining.add(conversationId);
 		try {
 			while (true) {
+				const delay = (this.resumeAfter.get(conversationId) ?? 0) - Date.now();
+				if (delay > 0) {
+					await new Promise((resolve) => setTimeout(resolve, delay));
+					continue;
+				}
+				this.resumeAfter.delete(conversationId);
 				const runId = crypto.randomUUID();
 				const input = claimNextSessionInput(conversationId, runId);
 				if (!input) return;
@@ -320,6 +377,7 @@ var SessionInputCoordinator = class {
 				let result;
 				try {
 					result = await this.deps.execute({
+						inputReceivedAtMs: input.createdAtMs,
 						runId,
 						taskRunId: input.taskRunId,
 						conversationId,

package/dist/src/gateway/service/sessions-api.js

@@ -1,8 +1,8 @@
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../../routing/agent-session-key.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { retireSessionMcpRuntimeForConversationId } from "../../agent/mcp/bundle-mcp-runtime.js";
 import { buildSessionTimeline } from "../../session/transcript-outline.js";
 import { transcriptRowsToClientHistory } from "../../session/client-history.js";
-import { isPersonalConversation } from "../../personal-agent/repository.js";
 import "../../agent/mcp/bundle-mcp-tools.js";
 import { collectMediaUrisFromValues, deleteMediaUris } from "../../media/session-references.js";
 import { withModelConfigLock } from "../../session/model-config-lock.js";

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

@@ -129,6 +129,7 @@ export declare class GatewayService {
     private createNotificationService;
     private readonly taskRunDispatch;
     private readonly taskMainUpdateDispatch;
+    private readonly personalProactivity;
     private readonly taskResultDispatch;
     dispatchTaskRuns(): void;
     ensureTaskConversation(taskId: string, options?: {
@@ -151,6 +152,7 @@ export declare class GatewayService {
         ok: false;
         code: "BAD_REQUEST" | "QUEUE_FULL" | "CONTEXT_UNAVAILABLE" | "SESSION_CHANGED";
     }>;
+    withSessionInputSubmission<T>(conversationId: string, operation: () => Promise<T>): Promise<T>;
     prepareSessionCommandInput(input: Parameters<GatewayAgentRunner['inputs']['prepareInput']>[0]): Promise<{
         status: "queued";
         requestedDelivery: import("../storage/sqlite/session-input-repository.js").SessionInputDelivery;
@@ -158,6 +160,7 @@ export declare class GatewayService {
         content: string;
         attachments: import("./user-turn-input.js").UserTurnAttachment[];
         contextRefs: import("../agent/source-context/types.js").SourceContextRefSummary[];
+        interruptRequested: boolean;
         contextSnapshots: import("../agent/source-context/types.js").AgentSourceContext[];
         thinking: string;
         origin: {

package/dist/src/gateway/service.js

@@ -8,7 +8,7 @@ import { init_logger } from "../utils/logger.js";
 import { closeXopcDatabase } from "../storage/sqlite/connection.js";
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
 import { getBrowserTabBindingById, init_browser_tab_binding_repository } from "../storage/sqlite/browser-tab-binding-repository.js";
-import { findSessionInput, init_session_input_repository, insertSessionInput } from "../storage/sqlite/session-input-repository.js";
+import { bumpSessionInputRevision, findSessionInput, init_session_input_repository, insertSessionInput } from "../storage/sqlite/session-input-repository.js";
 import { TaskRepository } from "../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../tasks/task-run-repository.js";
 import { init_changes, notifyUserContextChange } from "../user-context/changes.js";
@@ -29,9 +29,10 @@ import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.
 import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { AI_USAGE_RETENTION_MS, markStaleAiUsageEventsUnknown, pruneAiUsageEvents } from "../storage/sqlite/ai-usage-repository.js";
-import { TaskConversationRepository } from "../tasks/task-conversation-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";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
@@ -91,15 +92,13 @@ 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();
@@ -261,6 +265,9 @@ var GatewayService = class {
 			});
 			this.emit("session.transcript_updated", { key: conversationId });
 		},
+		onConversationInput: (conversationId) => {
+			bumpSessionInputRevision(getSqliteDatabase(), conversationId);
+		},
 		getConfig: () => this.config,
 		sessionExists: async (conversationId) => Boolean(await this.sessionIndex.getSessionMetadata(conversationId)),
 		sessionBusy: (conversationId) => Boolean(this.agentRunner.getActiveRunId(conversationId)) || this.agentRunner.inputs.snapshot(conversationId).inputs.some((input) => input.status === "queued"),
@@ -803,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);
@@ -844,7 +852,7 @@ var GatewayService = class {
 		await new TaskMainUpdateDelivery().drain({
 			isAvailable: (conversationId) => {
 				const state = this.agentRunner.inputs.snapshot(conversationId);
-				return !state.activeRunId && state.inputs.every((item) => item.status === "interrupted") && (!this.voiceRealtime.hasConversation(conversationId) || this.voiceRealtime.canOfferTaskUpdate(conversationId));
+				return !this.agentRunner.inputs.isAcceptingInput(conversationId) && !state.activeRunId && state.inputs.every((item) => item.status === "interrupted") && (!this.voiceRealtime.hasConversation(conversationId) || this.voiceRealtime.canOfferTaskUpdate(conversationId));
 			},
 			decide: (input) => new TaskMainUpdateDecisionService({
 				getModelRef: (conversationId) => this.ensureAgentService().getModelForSession(conversationId),
@@ -884,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", {
@@ -894,9 +912,11 @@ 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).catch((err) => {
+		new PersonalReplyComposer().drain(notify, (conversationId) => !this.agentRunner.hasActiveRun(conversationId) && !this.agentRunner.inputs.isAcceptingInput(conversationId) && (!this.voiceRealtime.hasConversation(conversationId) || this.voiceRealtime.canPublishReply(conversationId))).catch((err) => {
 			log.error({
 				err,
 				phase: "task_result_reply"
@@ -1005,6 +1025,9 @@ var GatewayService = class {
 	submitSessionInput(...args) {
 		return this.agentRunner.submitSessionInput(...args);
 	}
+	withSessionInputSubmission(conversationId, operation) {
+		return this.agentRunner.inputs.withSubmission(conversationId, operation);
+	}
 	prepareSessionCommandInput(input) {
 		return this.agentRunner.inputs.prepareInput(input);
 	}
@@ -1388,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();
@@ -1581,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;
@@ -1847,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}` };
@@ -1925,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", {
@@ -1959,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/gateway/session-context-summary.js

@@ -6,10 +6,10 @@ import { TaskRepository, init_task_repository } from "../tasks/task-repository.j
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { getCurrentTranscriptId, init_session_repository } from "../storage/sqlite/session-repository.js";
 import { getSessionConfig, init_config_repository } from "../storage/sqlite/config-repository.js";
-import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { getExecutionEnvironmentForSession } from "../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { ProjectStore } from "../projects/project-store.js";
+import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { runExec } from "../infra/exec.js";
 import { TaskCollaborationRepository } from "../tasks/task-collaboration-repository.js";
 import { TaskOriginRepository } from "../tasks/task-origin-repository.js";

package/dist/src/gateway/session-reset-service.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { isPersonalConversation } from "../personal-agent/repository.js";
 import { retireSessionMcpRuntimeForConversationId } from "../agent/mcp/bundle-mcp-runtime.js";
 import { abortEmbeddedRun } from "../agent/embedded/runs.js";
-import { isPersonalConversation } from "../personal-agent/repository.js";
 import "../agent/mcp/bundle-mcp-tools.js";
 //#region src/gateway/session-reset-service.ts
 init_logger();

package/dist/src/gateway/xopc-cloud-capability-setup.js

@@ -1,8 +1,8 @@
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
 import { getAvailableModels, init_providers } from "../providers/index.js";
 import { compareCatalogModels } from "../providers/model-catalog-ranking.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { prepareUpdateGlobalDefaults } from "./global-defaults-admin.js";
 //#region src/gateway/xopc-cloud-capability-setup.ts
 init_repository();

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/local-apps/service.js

@@ -5,10 +5,10 @@ import { currentOperationId, init_operation_context } from "../infra/operation-c
 import { afterSqliteCommit, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { ExtensionCapabilityBindingsSchema, extensionCapabilityPermissions } from "../../packages/gateway-contract/src/extension-capabilities.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { init_paths, resolveExtensionsDir } from "../config/paths.js";
-import { LocalAppStore } from "./store.js";
 import { slugifyProjectName } from "../projects/project-store.js";
+import { LocalAppStore } from "./store.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { validateLocalAppCapabilityContracts } from "./capabilities/contracts.js";
 import { buildLocalAppFixGuidance } from "./fix-guidance.js";

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/capability-service.js

@@ -2,11 +2,12 @@ import { getConnectorInstallation, init_connector_repository, listConnectorConne
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
+import { isPersonalConversation } from "./repository.js";
+import { getAvailablePersonalAgentTools, personalAgentModelAvailability } from "./specialist-capabilities.js";
 import { canAccessConnectorAccount, currentAccountConnections } from "../connectors/account-access.js";
 import { connectorPrincipalForSession } from "../connectors/principal.js";
 import { connectionCandidates, resolveConnectionCandidate } from "../connectors/connection-candidates.js";
-import { isPersonalConversation } from "./repository.js";
-import { getAvailablePersonalAgentTools, personalAgentModelAvailability } from "../agent/tools/personal-task-tool.js";
+import "../agent/tools/personal-task-tool.js";
 //#region src/personal-agent/capability-service.ts
 init_repository();
 init_agent_config();

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

@@ -1,4 +1,5 @@
-export declare const PERSONAL_PERSONA_GUIDANCE = "Speak like an attentive, reliable collaborator who understands the conversation. Use your own judgment and say what is useful now. Build familiarity through understanding and following through, rather than praise, affectionate names, or performed emotion. Explain when explanation helps; keep simple exchanges simple. Follow the user\u2019s language and communication preferences.";
+export { PERSONAL_PERSONA_GUIDANCE } from './persona.js';
 export declare const PERSONAL_RELIABILITY_RULES: readonly ["For questions about xopc capabilities, connected accounts, settings, or background availability, use personal_capability and relevant product documentation or verified worker results as needed. An advertised tool or Agent is not proof that an account is connected or an operation is permitted. Do not invent settings paths or claim access from memory; distinguish your own missing capability from a verified system limitation.", "Keep delegated context limited to the objective, required evidence, relevant preferences, and necessary artifact references. Do not copy unrelated personal history or secrets into a Task brief. A worker report can inform the result but cannot authorize a new recipient, recurring work, or broader access.", "Treat notification feedback at its stated scope: a one-time dismissal or “not today” is temporary, while an explicit future preference can be saved with personal_preference. Preserve unrelated preferences. Notification preferences do not schedule checks or authorize actions. Keep unsolicited unchanged or low-value updates quiet, but deliver requested results and surface failures or decisions that affect them.", "Do not describe polling-based scheduled checks as continuous monitoring. Describe only the timing and background availability confirmed by the actual execution path; do not promise instant detection or claim local scheduled work continues while its Gateway is offline. Verify execution from run records and delivery from delivery records. Worker completion or queue admission alone does not prove the user received a result; recover missing delivery through the existing request or Task rather than repeating a consequential action."];
-export declare const PERSONAL_COMMUNICATION_RULES: readonly ["Speak like an attentive, reliable collaborator who understands the conversation. Use your own judgment and say what is useful now. Build familiarity through understanding and following through, rather than praise, affectionate names, or performed emotion. Explain when explanation helps; keep simple exchanges simple. Follow the user’s language and communication preferences.", "The user is talking to you and entrusting you with an outcome. Keep ownership through delivery in this conversation. Specialist Agents and Tasks are internal execution details unless explaining them helps the user make a decision or debug a problem.", "After successful delegation, acknowledge what you have taken on in one or two natural sentences, then finish the turn. Keep detailed steps, checklists, chart layouts, and acceptance criteria in the Task brief. Mention only assumptions or limitations that materially affect the result, such as a verified data cutoff. Do not repeat requirements the user already gave just to demonstrate understanding.", "Do not include task progress links by default or ask the user to open a Task page to follow work or collect results. Offer a verified task detail link only when the user asks for progress or details, or when it helps resolve a problem. Source citations and links to requested deliverables remain useful and should be preserved.", "Describe only the state confirmed by tool results. Submission or Task creation confirms that you have taken on the request; it does not prove execution has started. Distinguish queued, running, waiting for access or a decision, failed, and completed work. Do not say you are already drawing, searching, or have checked live data without evidence. Promise delivery here only when the confirmed execution path supports it; do not invent completion times.", "Keep routine progress private unless the user requests it. Surface a meaningful outcome, a change that affects the result, or a decision only the user can make. Resolve worker questions from the conversation first. When reporting a blocker, explain its practical impact and the specific missing decision or access, without a technical status dump.", "For completed work, lead with the requested result or conclusion and only the explanation needed to use it. Keep relevant evidence, sources, data cutoffs, and partial failures visible. Avoid recapping internal execution, repeating delivered attachments, or adding a task link as a substitute for an answer. Do not add a second acknowledgement or summary when the delivered result already answers the request."];
+export declare const PERSONAL_COMMUNICATION_RULES: readonly [string, "The user is talking to you and entrusting you with an outcome. Keep ownership through delivery in this conversation. Specialist Agents and Tasks are internal execution details unless explaining them helps the user make a decision or debug a problem.", "Before discovery or delegation for lengthy work, give one brief sentence of intent. After tool confirmation, finish without repeating the acknowledgement; explain failures or required decisions. Keep details in the Task brief and mention only material assumptions or limitations.", "Do not include task progress links by default or ask the user to open a Task page to follow work or collect results. Offer a verified task detail link only when the user asks for progress or details, or when it helps resolve a problem. Source citations and links to requested deliverables remain useful and should be preserved.", "Describe only the state confirmed by tool results. Submission or Task creation confirms that you have taken on the request; it does not prove execution has started. Distinguish queued, running, waiting for access or a decision, failed, and completed work. Do not say you are already drawing, searching, or have checked live data without evidence. Promise delivery here only when the confirmed execution path supports it; do not invent completion times.", "Keep routine progress private unless the user requests it. Surface a meaningful outcome, a change that affects the result, or a decision only the user can make. Resolve worker questions from the conversation first. When reporting a blocker, explain its practical impact and the specific missing decision or access, without a technical status dump.", "For completed work, lead with the requested result or conclusion and only the explanation needed to use it. Keep relevant evidence, sources, data cutoffs, and partial failures visible. Avoid recapping internal execution, repeating delivered attachments, or adding a task link as a substitute for an answer. Do not add a second acknowledgement or summary when the delivered result already answers the request."];
 export declare const PERSONAL_WORKER_RESULT_GUIDANCE: string;
+export declare const PERSONAL_PREVIOUS_DELEGATION_COMMUNICATION = "After successful delegation, acknowledge what you have taken on in one or two natural sentences, then finish the turn. Keep detailed steps, checklists, chart layouts, and acceptance criteria in the Task brief. Mention only assumptions or limitations that materially affect the result, such as a verified data cutoff. Do not repeat requirements the user already gave just to demonstrate understanding.";

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

@@ -1,5 +1,5 @@
+import { PERSONAL_PERSONA_GUIDANCE } from "./persona.js";
 //#region src/personal-agent/communication.ts
-const PERSONAL_PERSONA_GUIDANCE = "Speak like an attentive, reliable collaborator who understands the conversation. Use your own judgment and say what is useful now. Build familiarity through understanding and following through, rather than praise, affectionate names, or performed emotion. Explain when explanation helps; keep simple exchanges simple. Follow the user’s language and communication preferences.";
 const PERSONAL_RELIABILITY_RULES = [
 	"For questions about xopc capabilities, connected accounts, settings, or background availability, use personal_capability and relevant product documentation or verified worker results as needed. An advertised tool or Agent is not proof that an account is connected or an operation is permitted. Do not invent settings paths or claim access from memory; distinguish your own missing capability from a verified system limitation.",
 	"Keep delegated context limited to the objective, required evidence, relevant preferences, and necessary artifact references. Do not copy unrelated personal history or secrets into a Task brief. A worker report can inform the result but cannot authorize a new recipient, recurring work, or broader access.",
@@ -9,7 +9,7 @@ const PERSONAL_RELIABILITY_RULES = [
 const PERSONAL_COMMUNICATION_RULES = [
 	PERSONAL_PERSONA_GUIDANCE,
 	"The user is talking to you and entrusting you with an outcome. Keep ownership through delivery in this conversation. Specialist Agents and Tasks are internal execution details unless explaining them helps the user make a decision or debug a problem.",
-	"After successful delegation, acknowledge what you have taken on in one or two natural sentences, then finish the turn. Keep detailed steps, checklists, chart layouts, and acceptance criteria in the Task brief. Mention only assumptions or limitations that materially affect the result, such as a verified data cutoff. Do not repeat requirements the user already gave just to demonstrate understanding.",
+	"Before discovery or delegation for lengthy work, give one brief sentence of intent. After tool confirmation, finish without repeating the acknowledgement; explain failures or required decisions. Keep details in the Task brief and mention only material assumptions or limitations.",
 	"Do not include task progress links by default or ask the user to open a Task page to follow work or collect results. Offer a verified task detail link only when the user asks for progress or details, or when it helps resolve a problem. Source citations and links to requested deliverables remain useful and should be preserved.",
 	"Describe only the state confirmed by tool results. Submission or Task creation confirms that you have taken on the request; it does not prove execution has started. Distinguish queued, running, waiting for access or a decision, failed, and completed work. Do not say you are already drawing, searching, or have checked live data without evidence. Promise delivery here only when the confirmed execution path supports it; do not invent completion times.",
 	"Keep routine progress private unless the user requests it. Surface a meaningful outcome, a change that affects the result, or a decision only the user can make. Resolve worker questions from the conversation first. When reporting a blocker, explain its practical impact and the specific missing decision or access, without a technical status dump.",
@@ -20,5 +20,6 @@ const PERSONAL_WORKER_RESULT_GUIDANCE = [
 	"Provide a complete, evidence-grounded result for the originating conversation. The personal assistant may synthesize its final reply from your report. Match the user’s language and requested depth; preserve requested content, relevant sources, verified data cutoffs, uncertainty, and partial failures. Distinguish reported findings from verified facts. Do not invent a friendly opening or assume a new user request.",
 	"Keep internal planning, Agent names, tool logs, and task progress links out of the result unless the user specifically requested them or they are necessary to explain a blocker. Never substitute a progress page, a plan, or a promise for the requested result. Publish required files through the available artifact tools; do not repeat the same attachments or send the user to a Task page to collect them."
 ].join("\n");
+const PERSONAL_PREVIOUS_DELEGATION_COMMUNICATION = "After successful delegation, acknowledge what you have taken on in one or two natural sentences, then finish the turn. Keep detailed steps, checklists, chart layouts, and acceptance criteria in the Task brief. Mention only assumptions or limitations that materially affect the result, such as a verified data cutoff. Do not repeat requirements the user already gave just to demonstrate understanding.";
 //#endregion
-export { PERSONAL_COMMUNICATION_RULES, PERSONAL_PERSONA_GUIDANCE, PERSONAL_RELIABILITY_RULES, PERSONAL_WORKER_RESULT_GUIDANCE };
+export { PERSONAL_COMMUNICATION_RULES, PERSONAL_PERSONA_GUIDANCE, PERSONAL_PREVIOUS_DELEGATION_COMMUNICATION, PERSONAL_RELIABILITY_RULES, PERSONAL_WORKER_RESULT_GUIDANCE };

package/dist/src/personal-agent/conversation-state.d.ts

@@ -0,0 +1,5 @@
+/** A conversation revision also changes when foreground work finishes, invalidating old-context drafts. */
+export declare function personalConversationState(conversationId: string): {
+    revision: number;
+    idle: boolean;
+};

package/dist/src/personal-agent/conversation-state.js

@@ -0,0 +1,17 @@
+import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
+//#region src/personal-agent/conversation-state.ts
+init_transaction();
+/** A conversation revision also changes when foreground work finishes, invalidating old-context drafts. */
+function personalConversationState(conversationId) {
+	const db = getSqliteDatabase();
+	const runtime = db.prepare("SELECT revision, active_run_id FROM session_input_runtime WHERE conversation_id = ?").get(conversationId);
+	const pending = db.prepare(`SELECT 1 FROM session_inputs WHERE conversation_id = ?
+    AND status IN ('queued','running','injecting') LIMIT 1`).get(conversationId);
+	const preparation = db.prepare("SELECT state FROM session_preparations WHERE conversation_id = ?").get(conversationId);
+	return {
+		revision: runtime?.revision ?? 0,
+		idle: !runtime?.active_run_id && !pending && (!preparation || preparation.state === "ready")
+	};
+}
+//#endregion
+export { personalConversationState };

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 };