@xopcai/xopc 0.0.284 → 0.0.286

package/dist/src/proactive/execution/worker.js

@@ -1,17 +1,19 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { getSqliteDatabase } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
+import { evidenceSourcesFresh } from "../source-freshness.js";
 import { authorizedConnectedSource } from "./authorization.js";
 import { effectiveProactivePolicy } from "../policy/service.js";
 import { getPromptRevision, getScenario } from "../scenarios/repository.js";
 import { composeScenarioPrompt } from "../scenarios/prompt-composer.js";
 import { markReadyBatches } from "../routing/batch-repository.js";
 import { ContextProviderRegistry } from "./context.js";
-import { attachSnapshot, claimNextRun, eventIdsForBatch, failRun, finishRun, saveSnapshot } from "./repository.js";
+import { attachSnapshot, claimNextRun, deferRunForSource, eventIdsForBatch, failRun, finishRun, saveSnapshot } from "./repository.js";
 import { isValuableInsight, parseAnalysisResult, scoreInsight } from "./insight.js";
 import { randomUUID } from "node:crypto";
 import { isDeepStrictEqual } from "node:util";
 //#region src/proactive/execution/worker.ts
+init_transaction();
 init_logger();
 const log = createLogger("ProactiveWorker");
 var ProactiveWorker = class {
@@ -69,6 +71,10 @@ var ProactiveWorker = class {
 					});
 					return;
 				}
+				if (!evidenceSourcesFresh(context.evidenceIds, context.content)) {
+					deferRunForSource(run);
+					return;
+				}
 				const snapshot = saveSnapshot(run.batchId, context.snapshotContent ?? context.content, context.evidenceIds);
 				attachSnapshot(run.id, snapshot.id);
 				const prompt = composeScenarioPrompt({
@@ -89,10 +95,15 @@ var ProactiveWorker = class {
 				});
 				const revoked = context.evidenceIds.some((id) => !latestContext.evidenceIds.includes(id));
 				const changed = !isDeepStrictEqual(context.snapshotContent ?? context.content, latestContext.snapshotContent ?? latestContext.content);
+				const stale = !evidenceSourcesFresh(latestContext.evidenceIds, latestContext.content);
+				if (stale && !revoked) {
+					deferRunForSource(run);
+					return;
+				}
 				const unavailable = context.evidenceIds.some((id) => id.startsWith("source-item:") && !authorizedConnectedSource(id.slice(12), effectiveProactivePolicy(run.subscriptionId).workspaceId, run.scenarioKey));
-				const result = revoked || changed ? {
+				const result = revoked || changed || stale ? {
 					result: "no_insight",
-					reason: unavailable ? "source_unavailable" : "source_changed"
+					reason: unavailable ? "source_unavailable" : stale ? "source_stale" : "source_changed"
 				} : parseAnalysisResult(output.text, new Set(latestContext.evidenceIds));
 				const candidate = result.result === "insight" ? result.candidate : void 0;
 				if (run.scenarioKey === "communication_follow_up" && (candidate?.decision || candidate?.proposedAction)) throw new Error("Communication preparation must return a draft or update; actions require the conversation confirmation flow");

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

@@ -21,7 +21,7 @@ interface SceneMoment {
 }
 export declare function startDelegation(workspace: string, value: unknown): {
     revision: number;
-    level: "off" | "active" | "quiet" | "balanced";
+    level: "active" | "quiet" | "balanced";
     delivery: "digest" | "inbox" | "important";
     completedAt: string;
     scanIntervalMinutes: number;
@@ -50,7 +50,7 @@ export declare function delegationOverview(workspace: string): {
         status: "completed" | "paused" | "watching";
         revision: number;
         lastCheckedAt: string;
-        sessionKey: string;
+        conversationId: string;
         sourceAvailable: boolean;
         enabled: boolean;
         subject: string;
@@ -58,6 +58,7 @@ export declare function delegationOverview(workspace: string): {
         latestDirection: string;
         lastSyncedAt: string;
         syncFailed: boolean;
+        sourceFresh: boolean;
     }[];
     delegations: {
         id: string;
@@ -67,6 +68,8 @@ export declare function delegationOverview(workspace: string): {
         enabled: boolean;
         revision: number;
         delivery: "digest" | "inbox" | "important";
+        scanIntervalMinutes: number;
+        checkStatus: import("@xopcai/gateway-contract/src/proactive.js").ProactiveCheckStatus;
         completedAt: string;
         userInstructions: string;
         updatedAt: string;

package/dist/src/proactive/experience.js

@@ -1,13 +1,15 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { ProactiveConflict, effectiveProactivePolicy } from "./policy/service.js";
 import { controlledSubscriptions, createControlledSubscription, requireSubscription, updateControlledSubscription } from "./scenarios/control.js";
 import { ProactiveScenarioService } from "./scenarios/service.js";
 import { ProactiveEventService } from "./service.js";
 import { listMailFollowUps } from "./follow-ups.js";
+import { followUpCheckStatus } from "./status.js";
 import { getCard } from "./inbox/cards.js";
 import { scanDueProjects } from "./temporal/schedule.js";
 import { z } from "zod";
 //#region src/proactive/experience.ts
+init_transaction();
 const DelegateSchema = z.object({
 	scenarioKey: z.enum([
 		"project_delivery_risk",
@@ -69,6 +71,8 @@ function delegationOverview(workspace) {
 		enabled: sub.enabled,
 		revision: sub.revision,
 		delivery: sub.delivery,
+		scanIntervalMinutes: sub.scanIntervalMinutes ?? 120,
+		checkStatus: followUpCheckStatus(sub.id, sub.scopeKind === "project"),
 		completedAt: sub.completedAt,
 		userInstructions: sub.userInstructions,
 		updatedAt: sub.updatedAt,
@@ -149,9 +153,9 @@ function projectSceneMoments(cards, delegations, followUps) {
 			help: card?.workDone || card?.recommendation || "I will watch the thread and prepare the next step when it matters.",
 			arrangementId: follow.subscriptionId,
 			manageRoute: `/assistant-work?follow-up=${encodeURIComponent(follow.id)}`,
-			object: follow.sessionKey ? {
+			object: follow.conversationId ? {
 				label: follow.subject ?? "Open conversation",
-				route: `/chat/${encodeURIComponent(follow.sessionKey)}`
+				route: `/chat/${encodeURIComponent(follow.conversationId)}`
 			} : null,
 			card,
 			updatedAt: card?.updatedAt ?? follow.lastCheckedAt ?? follow.dueAt

package/dist/src/proactive/follow-ups.d.ts

@@ -11,7 +11,7 @@ export type MailFollowUp = {
     revision: number;
     last_fingerprint: string | null;
     last_checked_at: string | null;
-    session_key: string | null;
+    conversation_id: string | null;
 };
 export declare function requireMailFollowUp(workspace: string, id: string): MailFollowUp;
 export declare function authorizedMailThread(follow: MailFollowUp): {
@@ -28,7 +28,7 @@ export declare function mailFollowUpView(follow: MailFollowUp): {
     status: "completed" | "paused" | "watching";
     revision: number;
     lastCheckedAt: string;
-    sessionKey: string;
+    conversationId: string;
     sourceAvailable: boolean;
     enabled: boolean;
     subject: string;
@@ -36,6 +36,7 @@ export declare function mailFollowUpView(follow: MailFollowUp): {
     latestDirection: string;
     lastSyncedAt: string;
     syncFailed: boolean;
+    sourceFresh: boolean;
 };
 export declare function listMailFollowUps(workspace: string): {
     id: string;
@@ -45,7 +46,7 @@ export declare function listMailFollowUps(workspace: string): {
     status: "completed" | "paused" | "watching";
     revision: number;
     lastCheckedAt: string;
-    sessionKey: string;
+    conversationId: string;
     sourceAvailable: boolean;
     enabled: boolean;
     subject: string;
@@ -53,6 +54,7 @@ export declare function listMailFollowUps(workspace: string): {
     latestDirection: string;
     lastSyncedAt: string;
     syncFailed: boolean;
+    sourceFresh: boolean;
 }[];
 export declare function mailFollowUpSources(workspace: string): {
     id: string;
@@ -69,7 +71,7 @@ export declare function startMailFollowUp(workspace: string, value: unknown): {
     status: "completed" | "paused" | "watching";
     revision: number;
     lastCheckedAt: string;
-    sessionKey: string;
+    conversationId: string;
     sourceAvailable: boolean;
     enabled: boolean;
     subject: string;
@@ -77,6 +79,7 @@ export declare function startMailFollowUp(workspace: string, value: unknown): {
     latestDirection: string;
     lastSyncedAt: string;
     syncFailed: boolean;
+    sourceFresh: boolean;
 };
 export declare function updateMailFollowUp(workspace: string, id: string, value: unknown): {
     id: string;
@@ -86,7 +89,7 @@ export declare function updateMailFollowUp(workspace: string, id: string, value:
     status: "completed" | "paused" | "watching";
     revision: number;
     lastCheckedAt: string;
-    sessionKey: string;
+    conversationId: string;
     sourceAvailable: boolean;
     enabled: boolean;
     subject: string;
@@ -94,9 +97,10 @@ export declare function updateMailFollowUp(workspace: string, id: string, value:
     latestDirection: string;
     lastSyncedAt: string;
     syncFailed: boolean;
+    sourceFresh: boolean;
 };
 /** Keep the existing chat and its exact connector confirmation flow as the write boundary. */
-export declare function continueMailFollowUp(workspace: string, id: string, sessionKey: string): {
+export declare function continueMailFollowUp(workspace: string, id: string, conversationId: string): {
     followUp: {
         id: string;
         subscriptionId: string;
@@ -105,7 +109,7 @@ export declare function continueMailFollowUp(workspace: string, id: string, sess
         status: "completed" | "paused" | "watching";
         revision: number;
         lastCheckedAt: string;
-        sessionKey: string;
+        conversationId: string;
         sourceAvailable: boolean;
         enabled: boolean;
         subject: string;
@@ -113,6 +117,7 @@ export declare function continueMailFollowUp(workspace: string, id: string, sess
         latestDirection: string;
         lastSyncedAt: string;
         syncFailed: boolean;
+        sourceFresh: boolean;
     };
     connectionId: unknown;
     sourceItemId: string;

package/dist/src/proactive/follow-ups.js

@@ -1,6 +1,7 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { listKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
 import { getConnectorConnection } from "../storage/sqlite/connector-repository.js";
+import { sourceFreshness } from "./source-freshness.js";
 import { emailFields, readMailThread } from "./mail-thread.js";
 import { authorizedConnectedSource } from "./execution/authorization.js";
 import { ProactiveConflict, effectiveProactivePolicy } from "./policy/service.js";
@@ -11,6 +12,7 @@ import { ProactiveEventService } from "./service.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 //#region src/proactive/follow-ups.ts
+init_transaction();
 const COMMUNICATION_SCENARIO = "communication_follow_up";
 const CreateSchema = z.object({
 	sourceItemId: z.string().min(1),
@@ -41,7 +43,7 @@ function authorizedMailThread(follow) {
 function mailFollowUpView(follow) {
 	const thread = authorizedMailThread(follow);
 	const latest = thread?.items.at(-1);
-	const sync = thread ? getSqliteDatabase().prepare("SELECT status, error, finished_at FROM knowledge_sync_runs WHERE source_instance_id = ? ORDER BY started_at DESC LIMIT 1").get(thread.origin.sourceInstanceId) : void 0;
+	const sync = sourceFreshness(follow.source_item_id, Date.parse(follow.due_at) <= Date.now() ? follow.due_at : void 0);
 	return {
 		id: follow.id,
 		subscriptionId: follow.subscription_id,
@@ -50,14 +52,15 @@ function mailFollowUpView(follow) {
 		status: follow.status,
 		revision: follow.revision,
 		lastCheckedAt: follow.last_checked_at,
-		sessionKey: follow.session_key,
+		conversationId: follow.conversation_id,
 		sourceAvailable: Boolean(thread),
-		enabled: effectiveProactivePolicy(follow.subscription_id).enabled,
+		enabled: follow.status === "watching" && effectiveProactivePolicy(follow.subscription_id).enabled,
 		subject: thread ? emailFields(thread.origin.normalizedText).subject ?? "Email follow-up" : null,
 		latestMessageAt: latest?.occurredAt ?? null,
 		latestDirection: latest ? emailFields(latest.normalizedText).labels?.includes("SENT") ? "sent" : emailFields(latest.normalizedText).labels?.includes("INBOX") ? "received" : "unknown" : null,
-		lastSyncedAt: sync?.finished_at ? new Date(sync.finished_at).toISOString() : null,
-		syncFailed: Boolean(sync?.error)
+		lastSyncedAt: sync.lastSyncedAt,
+		syncFailed: sync.syncFailed,
+		sourceFresh: sync.fresh
 	};
 }
 function listMailFollowUps(workspace) {
@@ -119,11 +122,11 @@ function updateMailFollowUp(workspace, id, value) {
 	});
 }
 /** Keep the existing chat and its exact connector confirmation flow as the write boundary. */
-function continueMailFollowUp(workspace, id, sessionKey) {
+function continueMailFollowUp(workspace, id, conversationId) {
 	const follow = requireMailFollowUp(workspace, id);
 	const thread = authorizedMailThread(follow);
 	if (!thread || follow.status !== "watching" || !effectiveProactivePolicy(follow.subscription_id).enabled) throw new Error("Resume and authorize this follow-up before continuing");
-	getSqliteDatabase().prepare("UPDATE proactive_follow_ups SET session_key = ? WHERE id = ?").run(sessionKey, id);
+	getSqliteDatabase().prepare("UPDATE proactive_follow_ups SET conversation_id = ? WHERE id = ?").run(conversationId, id);
 	return {
 		followUp: mailFollowUpView(requireMailFollowUp(workspace, id)),
 		connectionId: thread.origin.metadata.connectionId,
@@ -137,11 +140,20 @@ function scanMailFollowUps(events, now = /* @__PURE__ */ new Date()) {
 	const db = getSqliteDatabase();
 	let published = 0;
 	for (const follow of db.prepare("SELECT * FROM proactive_follow_ups WHERE status = 'watching'").all()) {
-		if (!effectiveProactivePolicy(follow.subscription_id, now).enabled) continue;
+		const policy = effectiveProactivePolicy(follow.subscription_id, now);
+		if (!policy.enabled) continue;
 		const thread = authorizedMailThread(follow);
 		if (!thread) continue;
+		const freshness = sourceFreshness(follow.source_item_id, Date.parse(follow.due_at) <= now.getTime() ? follow.due_at : void 0, now.getTime());
+		if (!freshness.fresh) {
+			db.prepare("UPDATE proactive_follow_ups SET last_fingerprint = NULL WHERE id = ?").run(follow.id);
+			continue;
+		}
 		const fingerprint = `${follow.revision}:${thread.fingerprint}:${Date.parse(follow.due_at) <= now.getTime() ? "due" : "waiting"}`;
-		if (fingerprint !== follow.last_fingerprint) {
+		const awaitingSource = db.prepare(`SELECT 1 FROM proactive_runs r JOIN proactive_batch_events be USING(batch_id)
+      JOIN proactive_events e USING(event_id) WHERE r.subscription_id = ? AND r.status = 'retryable'
+      AND r.outcome_reason = 'source_stale' AND e.subject_kind = 'mail_follow_up' AND e.subject_id = ? LIMIT 1`).get(follow.subscription_id, follow.id);
+		if (fingerprint !== follow.last_fingerprint && !awaitingSource) {
 			if (events.publish({
 				type: "proactive.follow_up.v1",
 				schemaVersion: 1,
@@ -156,7 +168,7 @@ function scanMailFollowUps(events, now = /* @__PURE__ */ new Date()) {
 				actor: { kind: "system" },
 				scope: { workspaceId: follow.workspace_id },
 				occurredAt: now.toISOString(),
-				dedupeKey: `mail-follow-up:${follow.id}:${fingerprint}`,
+				dedupeKey: `mail-follow-up:${follow.id}:${fingerprint}:${freshness.version}:${policy.preferences.revision}`,
 				sensitivity: "personal",
 				payload: { followUpId: follow.id }
 			}, now).inserted) published++;

package/dist/src/proactive/inbox/cards.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { ProactiveCardActionSchema } from "../../../packages/gateway-contract/src/proactive.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { getKnowledgeSourceItem } from "../../storage/sqlite/knowledge-repository.js";
 import { insightSourcesAuthorized, insightSourcesChanged } from "../execution/authorization.js";
 import { ProactiveConflict, effectiveProactivePolicy, subscriptionSettings } from "../policy/service.js";
@@ -9,6 +10,8 @@ import { executePendingProactiveActions } from "../actions/service.js";
 import { getInboxItem } from "./repository.js";
 import { ProactiveInboxService } from "./service.js";
 //#region src/proactive/inbox/cards.ts
+init_src();
+init_transaction();
 function requireCardScope(id, workspaceId) {
 	if (!getSqliteDatabase().prepare(`SELECT 1 FROM proactive_inbox_items i JOIN proactive_insights x USING(insight_id)
     JOIN proactive_scenario_subscriptions s USING(subscription_id) WHERE i.inbox_item_id = ? AND s.workspace_id = ?`).get(id, workspaceId)) throw new Error("Card not found");
@@ -55,7 +58,7 @@ function getCard(id, workspaceId) {
 		...insight.artifact ? { artifact: insight.artifact } : {},
 		...insight.proposedAction && insight.actionStatus === "approval_required" ? { taskDraft: insight.proposedAction.input } : {},
 		...typeof insight.actionResult?.taskId === "string" ? { followUp: getSqliteDatabase().prepare("SELECT task_id AS taskId, title, phase, resolution FROM tasks WHERE task_id = ?").get(insight.actionResult.taskId) } : {},
-		...insight.scenarioKey === "communication_follow_up" ? { communication: getSqliteDatabase().prepare(`SELECT f.id, f.session_key AS sessionKey
+		...insight.scenarioKey === "communication_follow_up" ? { communication: getSqliteDatabase().prepare(`SELECT f.id, f.conversation_id AS conversationId
       FROM proactive_runs r JOIN proactive_context_snapshots c ON c.snapshot_id = r.context_snapshot_id
       JOIN proactive_follow_ups f ON f.id = json_extract(c.content_json, '$.follow_up.followUpId') WHERE r.run_id = (SELECT run_id FROM proactive_insights WHERE insight_id = ?)`).get(item.insightId) } : {},
 		relatedCardIds: item.correlationKey ? getSqliteDatabase().prepare("SELECT inbox_item_id AS id FROM proactive_inbox_items WHERE correlation_key = ? AND inbox_item_id <> ? AND withdrawn_at IS NULL").all(item.correlationKey, id).map((row) => row.id) : [],
@@ -164,6 +167,7 @@ function applyCardAction(card, workspaceId, input) {
 	if (input.taskDraft && (input.actionId !== "decide" || input.choice !== "approve" || !card.taskDraft)) throw new Error("Task draft requires a pending approval");
 	if (input.artifact && input.actionId !== "edit_artifact") throw new Error("Artifact requires an edit action");
 	if (input.instruction && input.actionId !== "refine") throw new Error("Instruction requires a refine action");
+	if (input.feedbackReason && input.actionId !== "not_useful") throw new Error("Feedback reason requires negative feedback");
 	switch (input.actionId) {
 		case "edit_artifact":
 			if (!input.artifact || !card.artifact || input.artifact.kind !== card.artifact.kind) throw new Error("An existing artifact is required");
@@ -177,7 +181,7 @@ function applyCardAction(card, workspaceId, input) {
 			break;
 		case "useful":
 		case "not_useful":
-			service.feedback(card.id, input.actionId);
+			service.feedback(card.id, input.actionId, input.feedbackReason);
 			break;
 		case "refine":
 			if (!input.instruction) throw new Error("Refinement instruction required");

package/dist/src/proactive/inbox/delivery.js

@@ -1,19 +1,22 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
-import { insightSourcesAuthorized, insightSourcesChanged } from "../execution/authorization.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { insightSourcesAuthorized, insightSourcesChanged, insightSourcesFresh } from "../execution/authorization.js";
 import { effectiveProactivePolicy, localProactiveDay, nextDigestTime, quietHoursEnd, reserveProactiveNotification } from "../policy/service.js";
 import { insightCorrelation } from "./lifecycle.js";
 import { getInboxItem } from "./repository.js";
-import { viewingProactiveCards } from "../policy/presence.js";
+import { viewingProactiveCard } from "../policy/presence.js";
 import { queueDigest } from "./digest.js";
 import { notificationPlanFromGatewayEvent } from "../../notifications/planner.js";
 import { createHash } from "node:crypto";
 //#region src/proactive/inbox/delivery.ts
+init_transaction();
 /** The outbox is acknowledged only after a notification or suppression is persisted. */
 function deliverProactiveCard(item, notifications, publish) {
 	const result = runSqliteWriteTransaction(() => {
 		const current = getInboxItem(item.id);
-		if (!current || current.withdrawnAt || !insightSourcesAuthorized(current.insightId) || current.status === "resolved" || current.expiresAt && Date.parse(current.expiresAt) <= Date.now()) return null;
+		if (!current || current.withdrawnAt || !insightSourcesAuthorized(current.insightId) || ["resolved", "read"].includes(current.status) || current.expiresAt && Date.parse(current.expiresAt) <= Date.now()) return null;
 		if (current.insight.actionStatus !== "completed" && insightSourcesChanged(current.insightId)) return null;
+		if (current.actionableUntil && Date.parse(current.actionableUntil) <= Date.now()) return null;
+		if (!insightSourcesFresh(current.insightId)) return { retryAt: new Date(Date.now() + 6e4).toISOString() };
 		if (current.status === "snoozed") return { retryAt: current.snoozedUntil };
 		const policy = effectiveProactivePolicy(current.subscriptionId);
 		if (!policy.enabled || policy.settings.delivery === "inbox") return null;
@@ -32,10 +35,7 @@ function deliverProactiveCard(item, notifications, publish) {
 		const db = getSqliteDatabase();
 		const key = `proactive:${insightCorrelation(current.insightId)}:${createHash("sha256").update(JSON.stringify([current.insight.urgency, current.insight.decision ?? null])).digest("hex")}:${localProactiveDay(/* @__PURE__ */ new Date(), policy.preferences.timezone)}`;
 		if (db.prepare("SELECT 1 FROM proactive_delivery_decisions WHERE notification_key = ?").get(key)) return null;
-		if (policy.preferences.suppressWhileViewing && viewingProactiveCards(policy.workspaceId)) {
-			db.prepare("INSERT INTO proactive_delivery_decisions VALUES (?, ?, ?, ?)").run(key, policy.workspaceId, "visible_in_app", (/* @__PURE__ */ new Date()).toISOString());
-			return null;
-		}
+		if (policy.preferences.suppressWhileViewing && viewingProactiveCard(policy.workspaceId, current.id, current.notificationRevision)) return { retryAt: new Date(Date.now() + 6e4).toISOString() };
 		const decision = reserveProactiveNotification(current.subscriptionId, key);
 		if (decision instanceof Date) return { retryAt: decision.toISOString() };
 		if (decision === "suppressed") return null;

package/dist/src/proactive/inbox/digest.d.ts

@@ -3,6 +3,6 @@ import type { NotificationPlan } from '../../notifications/planner.js';
 import type { InboxItem } from './types.js';
 export { nextDigestTime } from '../policy/service.js';
 export declare function queueDigest(item: InboxItem, mode: 'daily' | 'quiet', dueAt: Date): void;
-export declare function digestCards(id: string, workspaceId: string): import("@xopcai/gateway-contract").ProactiveCard[];
+export declare function digestCards(id: string, workspaceId: string, forDelivery?: boolean): import("@xopcai/gateway-contract").ProactiveCard[];
 export declare function reserveWorkspaceAttention(workspaceId: string, key: string, now?: Date): boolean;
 export declare function flushDueDigests(persist: (plan: NotificationPlan) => ProductNotification | null, now?: Date): ProductNotification[];

package/dist/src/proactive/inbox/digest.js

@@ -1,11 +1,11 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
-import { insightSourcesAuthorized } from "../execution/authorization.js";
-import { effectiveProactivePolicy, localProactiveDay, nextDigestTime, proactivePreferences, quietHoursEnd } from "../policy/service.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { insightSourcesAuthorized, insightSourcesChanged, insightSourcesFresh } from "../execution/authorization.js";
+import { effectiveProactivePolicy, localProactiveDay, nextDigestTime, proactiveChecksAllowed, proactivePreferences, quietHoursEnd } from "../policy/service.js";
 import { getInboxItem } from "./repository.js";
 import { getCard } from "./cards.js";
-import { viewingProactiveCards } from "../policy/presence.js";
 import { randomUUID } from "node:crypto";
 //#region src/proactive/inbox/digest.ts
+init_transaction();
 function queueDigest(item, mode, dueAt) {
 	const policy = effectiveProactivePolicy(item.subscriptionId);
 	getSqliteDatabase().prepare(`INSERT INTO proactive_digest_queue(inbox_item_id, workspace_id, notification_revision, mode, due_at)
@@ -13,26 +13,27 @@ function queueDigest(item, mode, dueAt) {
     mode = excluded.mode, due_at = excluded.due_at, consumed_at = NULL
     WHERE proactive_digest_queue.notification_revision <> excluded.notification_revision`).run(item.id, policy.workspaceId, item.notificationRevision, mode, dueAt.toISOString());
 }
-function digestCards(id, workspaceId) {
+function digestCards(id, workspaceId, forDelivery = false) {
 	const digest = getSqliteDatabase().prepare("SELECT * FROM proactive_digests WHERE digest_id = ? AND workspace_id = ?").get(id, workspaceId);
 	if (!digest) throw new Error("Digest not found");
 	return getSqliteDatabase().prepare("SELECT inbox_item_id, notification_revision FROM proactive_digest_members WHERE digest_id = ?").all(id).flatMap((member) => {
 		const item = getInboxItem(member.inbox_item_id);
-		if (!item || !eligibleDigestItem(item, digest.occurrence_key.startsWith("daily:") ? "daily" : "quiet") || item.notificationRevision !== member.notification_revision) return [];
+		if (!item || item.withdrawnAt || item.expiresAt && Date.parse(item.expiresAt) <= Date.now() || item.actionableUntil && Date.parse(item.actionableUntil) <= Date.now() || item.notificationRevision !== member.notification_revision) return [];
+		if (forDelivery && !eligibleDigestItem(item, digest.occurrence_key.startsWith("daily:") ? "daily" : "quiet", false)) return [];
 		const card = getCard(item.id, workspaceId);
-		return card.status === "withdrawn" ? [] : [card];
+		return ["withdrawn", "expired"].includes(card.status) ? [] : [card];
 	});
 }
-function eligibleDigestItem(item, mode) {
+function eligibleDigestItem(item, mode, requireFresh = true) {
 	const policy = effectiveProactivePolicy(item.subscriptionId);
 	const daily = policy.preferences.digestEnabled || policy.settings.delivery === "digest";
 	if (mode === "daily" ? !daily : policy.level === "quiet" && !daily) return false;
-	return Boolean(policy.enabled && policy.settings.delivery !== "inbox" && !item.withdrawnAt && !["resolved", "snoozed"].includes(item.status) && (!item.expiresAt || Date.parse(item.expiresAt) > Date.now()) && insightSourcesAuthorized(item.insightId));
+	return Boolean(policy.enabled && policy.settings.delivery !== "inbox" && !item.withdrawnAt && !["resolved", "snoozed"].includes(item.status) && (!item.expiresAt || Date.parse(item.expiresAt) > Date.now()) && (!item.actionableUntil || Date.parse(item.actionableUntil) > Date.now()) && insightSourcesAuthorized(item.insightId) && !insightSourcesChanged(item.insightId) && (!requireFresh || insightSourcesFresh(item.insightId)));
 }
 function reserveWorkspaceAttention(workspaceId, key, now = /* @__PURE__ */ new Date()) {
 	const db = getSqliteDatabase();
 	const preferences = proactivePreferences(workspaceId);
-	if (preferences.level === "off" || preferences.pausedUntil && Date.parse(preferences.pausedUntil) > now.getTime()) return false;
+	if (!proactiveChecksAllowed(preferences, now) || preferences.notificationsMuted) return false;
 	if (db.prepare("SELECT 1 FROM proactive_notification_budget WHERE dedupe_key = ?").get(key)) return true;
 	const day = localProactiveDay(now, preferences.timezone);
 	const { count } = db.prepare("SELECT COUNT(*) AS count FROM proactive_notification_budget WHERE workspace_id = ? AND local_day = ?").get(workspaceId, day);
@@ -46,15 +47,25 @@ function flushDueDigests(persist, now = /* @__PURE__ */ new Date()) {
 		const notifications = [];
 		for (const group of groups) {
 			const preferences = proactivePreferences(group.workspace_id);
+			if (!proactiveChecksAllowed(preferences, now)) {
+				db.prepare("UPDATE proactive_digest_queue SET due_at = ? WHERE workspace_id = ? AND mode = ? AND consumed_at IS NULL").run(new Date(now.getTime() + 6e4).toISOString(), group.workspace_id, group.mode);
+				continue;
+			}
 			const until = quietHoursEnd(preferences, now);
 			if (until) {
 				db.prepare("UPDATE proactive_digest_queue SET due_at = ? WHERE workspace_id = ? AND mode = ? AND consumed_at IS NULL").run(until.toISOString(), group.workspace_id, group.mode);
 				continue;
 			}
 			const queued = db.prepare("SELECT inbox_item_id FROM proactive_digest_queue WHERE workspace_id = ? AND mode = ? AND consumed_at IS NULL AND due_at <= ? ORDER BY due_at LIMIT 500").all(group.workspace_id, group.mode, now.toISOString());
+			const deferred = /* @__PURE__ */ new Set();
 			const seen = /* @__PURE__ */ new Set();
 			const items = queued.flatMap((row) => {
 				const item = getInboxItem(row.inbox_item_id);
+				if (item && !item.withdrawnAt && !["read", "resolved"].includes(item.status) && (!item.actionableUntil || Date.parse(item.actionableUntil) > now.getTime()) && (!item.expiresAt || Date.parse(item.expiresAt) > now.getTime()) && insightSourcesAuthorized(item.insightId) && !insightSourcesChanged(item.insightId) && !insightSourcesFresh(item.insightId)) {
+					deferred.add(item.id);
+					db.prepare("UPDATE proactive_digest_queue SET due_at = ? WHERE inbox_item_id = ?").run(new Date(now.getTime() + 6e4).toISOString(), item.id);
+					return [];
+				}
 				if (!item || !eligibleDigestItem(item, group.mode)) return [];
 				const key = item.correlationKey ?? item.id;
 				if (seen.has(key)) return [];
@@ -67,12 +78,12 @@ function flushDueDigests(persist, now = /* @__PURE__ */ new Date()) {
 				db.prepare("UPDATE proactive_digest_queue SET due_at = ? WHERE workspace_id = ? AND mode = ? AND consumed_at IS NULL").run(tomorrow.toISOString(), group.workspace_id, group.mode);
 				continue;
 			}
-			if (!items.length || preferences.suppressWhileViewing && viewingProactiveCards(group.workspace_id, now.getTime())) {
-				for (const row of queued) db.prepare("UPDATE proactive_digest_queue SET consumed_at = ? WHERE inbox_item_id = ?").run(now.toISOString(), row.inbox_item_id);
+			if (!items.length) {
+				for (const row of queued.filter((row) => !deferred.has(row.inbox_item_id))) db.prepare("UPDATE proactive_digest_queue SET consumed_at = ? WHERE inbox_item_id = ?").run(now.toISOString(), row.inbox_item_id);
 				continue;
 			}
 			const key = `proactive.digest:${group.workspace_id}:${occurrence}`;
-			if (!reserveWorkspaceAttention(group.workspace_id, key, now)) {
+			if (!preferences.notificationsMuted && !reserveWorkspaceAttention(group.workspace_id, key, now)) {
 				db.prepare("UPDATE proactive_digest_queue SET due_at = ? WHERE workspace_id = ? AND mode = ? AND consumed_at IS NULL").run(nextDigestTime(preferences, new Date(now.getTime() + 6e4)).toISOString(), group.workspace_id, group.mode);
 				continue;
 			}
@@ -103,7 +114,7 @@ function flushDueDigests(persist, now = /* @__PURE__ */ new Date()) {
 				db.prepare("UPDATE proactive_digests SET notification_id = ? WHERE digest_id = ?").run(notification.id, id);
 				notifications.push(notification);
 			}
-			for (const row of queued) db.prepare("UPDATE proactive_digest_queue SET consumed_at = ? WHERE inbox_item_id = ?").run(now.toISOString(), row.inbox_item_id);
+			for (const row of queued.filter((row) => !deferred.has(row.inbox_item_id))) db.prepare("UPDATE proactive_digest_queue SET consumed_at = ? WHERE inbox_item_id = ?").run(now.toISOString(), row.inbox_item_id);
 		}
 		return notifications;
 	});

package/dist/src/proactive/inbox/lifecycle.js

@@ -1,7 +1,8 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { insightSourcesAuthorized, insightSourcesChanged } from "../execution/authorization.js";
 import { createHash } from "node:crypto";
 //#region src/proactive/inbox/lifecycle.ts
+init_transaction();
 function withdrawCard(id, now = /* @__PURE__ */ new Date()) {
 	runSqliteWriteTransaction((db) => {
 		db.prepare("UPDATE proactive_inbox_items SET withdrawn_at = ?, updated_at = ? WHERE inbox_item_id = ? AND withdrawn_at IS NULL").run(now.toISOString(), now.toISOString(), id);

package/dist/src/proactive/inbox/notification-policy.d.ts

@@ -1 +1 @@
-export declare function recheckProactiveNotification(itemId: string, now?: Date, notificationRevision?: unknown): 'send' | 'cancel' | Date;
+export declare function recheckProactiveNotification(itemId: string, now?: Date, notificationRevision?: unknown, forDigest?: boolean): 'send' | 'cancel' | Date;

package/dist/src/proactive/inbox/notification-policy.js

@@ -1,18 +1,21 @@
-import { insightSourcesAuthorized, insightSourcesChanged } from "../execution/authorization.js";
+import { insightSourcesAuthorized, insightSourcesChanged, insightSourcesFresh } from "../execution/authorization.js";
 import { effectiveProactivePolicy, quietHoursEnd } from "../policy/service.js";
 import { getInboxItem } from "./repository.js";
 //#region src/proactive/inbox/notification-policy.ts
-function recheckProactiveNotification(itemId, now = /* @__PURE__ */ new Date(), notificationRevision) {
+function recheckProactiveNotification(itemId, now = /* @__PURE__ */ new Date(), notificationRevision, forDigest = false) {
 	const item = getInboxItem(itemId);
-	if (!item || item.withdrawnAt || !insightSourcesAuthorized(item.insightId) || item.status === "resolved" || item.expiresAt && Date.parse(item.expiresAt) <= now.getTime()) return "cancel";
+	if (!item || item.withdrawnAt || !insightSourcesAuthorized(item.insightId) || ["resolved", "read"].includes(item.status) || item.expiresAt && Date.parse(item.expiresAt) <= now.getTime()) return "cancel";
 	if (item.insight.actionStatus !== "completed" && insightSourcesChanged(item.insightId)) return "cancel";
+	if (item.actionableUntil && Date.parse(item.actionableUntil) <= now.getTime()) return "cancel";
+	if (!insightSourcesFresh(item.insightId)) return new Date(now.getTime() + 6e4);
 	if (typeof notificationRevision === "number" && notificationRevision !== item.notificationRevision) return "cancel";
 	const policy = effectiveProactivePolicy(item.subscriptionId, now);
-	if (!policy.enabled || policy.preferences.digestEnabled && item.insight.attentionKind !== "receipt") return "cancel";
-	if (policy.level !== "active" && ["low", "medium"].includes(item.insight.urgency) && !item.insight.decision) return "cancel";
+	if (!policy.enabled || policy.preferences.notificationsMuted || policy.settings.delivery === "inbox") return "cancel";
+	if (!forDigest && policy.preferences.digestEnabled && item.insight.attentionKind !== "receipt") return "cancel";
+	if (!forDigest && policy.level !== "active" && ["low", "medium"].includes(item.insight.urgency) && !item.insight.decision) return "cancel";
 	if (item.status === "snoozed") return new Date(item.snoozedUntil);
 	{
-		if (policy.level === "quiet" || policy.settings.delivery !== "important") return "cancel";
+		if (!forDigest && (policy.level === "quiet" || policy.settings.delivery !== "important")) return "cancel";
 		const until = quietHoursEnd(policy.preferences, now);
 		if (until) return until;
 	}

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

@@ -1,9 +1,10 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { insightSourcesAuthorized, insightSourcesChanged } from "../execution/authorization.js";
 import { effectiveProactivePolicy } from "../policy/service.js";
 import { decideProactiveDisposition, nextQuietHoursEnd, proactiveDispositionReason } from "../../tasks/project-monitoring-service.js";
 import { randomUUID } from "node:crypto";
 //#region src/proactive/inbox/repository.ts
+init_transaction();
 const s = (row, key) => String(row[key]);
 function itemFromRow(row) {
 	const attentionKind = row.action_status === "completed" ? "receipt" : row.decision_json || row.action_status === "approval_required" ? "decision" : "information";
@@ -15,6 +16,7 @@ function itemFromRow(row) {
 		correlationKey: row.correlation_key ? s(row, "correlation_key") : void 0,
 		revision: Number(row.revision),
 		notificationRevision: Number(row.notification_revision),
+		...row.actionable_until ? { actionableUntil: s(row, "actionable_until") } : {},
 		...row.expires_at ? { expiresAt: s(row, "expires_at") } : {},
 		status: s(row, "status"),
 		...row.snoozed_until ? { snoozedUntil: s(row, "snoozed_until") } : {},
@@ -128,7 +130,7 @@ function projectInsightsToInbox(now = /* @__PURE__ */ new Date()) {
 			};
 			const materialChange = previous && ((urgencyRank[String(row.urgency)] ?? 0) > (urgencyRank[previous.urgency] ?? 0) || row.decision_json !== previous.decision_json || previous.expires_at && previous.expires_at <= nowIso);
 			if (previous) db.prepare(`UPDATE proactive_inbox_items SET insight_id = ?, updated_at = ?,
-          notification_revision = notification_revision + ? WHERE inbox_item_id = ?`).run(String(row.insight_id), nowIso, materialChange ? 1 : 0, id);
+          status = CASE WHEN ? THEN 'unread' ELSE status END, notification_revision = notification_revision + ? WHERE inbox_item_id = ?`).run(String(row.insight_id), nowIso, materialChange ? 1 : 0, materialChange ? 1 : 0, id);
 			else db.prepare(`INSERT INTO proactive_inbox_items (inbox_item_id, insight_id, status, created_at, updated_at)
           VALUES (?, ?, 'unread', ?, ?)`).run(id, String(row.insight_id), nowIso, nowIso);
 			{
@@ -138,7 +140,7 @@ function projectInsightsToInbox(now = /* @__PURE__ */ new Date()) {
           WHERE x.insight_id = ? AND e.type = 'connected_source.calendar_window.v1' ORDER BY e.occurred_at DESC LIMIT 1`).get(String(row.insight_id));
 				const meetingStart = meeting ? JSON.parse(meeting.payload_json).meetingStartsAt : void 0;
 				const expiresAt = typeof meetingStart === "string" && Number.isFinite(Date.parse(meetingStart)) ? meetingStart : new Date(now.getTime() + 7 * 864e5).toISOString();
-				db.prepare("UPDATE proactive_inbox_items SET expires_at = ? WHERE inbox_item_id = ?").run(expiresAt, id);
+				db.prepare("UPDATE proactive_inbox_items SET expires_at = ?, actionable_until = ? WHERE inbox_item_id = ?").run(expiresAt, typeof meetingStart === "string" ? meetingStart : null, id);
 			}
 			const quietEnd = nextQuietHoursEnd(policy.quietHours, now)?.getTime() ?? now.getTime();
 			const cooldownEnd = previous?.delivered_at ? Date.parse(previous.delivered_at) + 4 * 36e5 : now.getTime();

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

@@ -7,7 +7,13 @@ export declare class ProactiveInboxService {
     feedback: typeof recordFeedback;
     decide(id: string, choice: string, note?: string): import("./types.js").InboxItem;
     instruct(id: string, instruction: string): {
+        followUpId: string;
+        revision: number;
+        revisionId?: undefined;
+    } | {
         revisionId: string;
+        followUpId?: undefined;
+        revision?: undefined;
     };
     transition(id: string, input: {
         status: InboxStatus;