@xopcai/xopc 0.0.284 → 0.0.286

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

@@ -1,7 +1,10 @@
+import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
 import { publishInstructionFeedback } from "../scenarios/repository.js";
+import { requireMailFollowUp, updateMailFollowUp } from "../follow-ups.js";
 import { executePendingProactiveActions } from "../actions/service.js";
 import { getInboxItem, getInboxSubscriptionId, listInbox, projectInsightsToInbox, recordDecision, recordFeedback, transitionInboxItem, wakeSnoozedItems } from "./repository.js";
 //#region src/proactive/inbox/service.ts
+init_transaction();
 var ProactiveInboxService = class {
 	list = listInbox;
 	project = projectInsightsToInbox;
@@ -13,6 +16,22 @@ var ProactiveInboxService = class {
 		return getInboxItem(id) ?? item;
 	}
 	instruct(id, instruction) {
+		const row = getSqliteDatabase().prepare(`SELECT s.workspace_id, c.content_json FROM proactive_inbox_items i
+      JOIN proactive_insights x USING(insight_id) JOIN proactive_runs r USING(run_id)
+      JOIN proactive_scenario_subscriptions s ON s.subscription_id = x.subscription_id
+      JOIN proactive_context_snapshots c ON c.snapshot_id = r.context_snapshot_id WHERE i.inbox_item_id = ?`).get(id);
+		const followId = row && JSON.parse(row.content_json).follow_up?.followUpId;
+		if (row && followId) {
+			const follow = requireMailFollowUp(row.workspace_id, followId);
+			const updated = updateMailFollowUp(row.workspace_id, follow.id, {
+				expectedRevision: follow.revision,
+				instructions: `${follow.instructions}\n${instruction}`
+			});
+			return {
+				followUpId: updated.id,
+				revision: updated.revision
+			};
+		}
 		return { revisionId: publishInstructionFeedback({
 			subscriptionId: getInboxSubscriptionId(id),
 			inboxItemId: id,

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

@@ -7,6 +7,7 @@ export interface InboxItem {
     revision?: number;
     notificationRevision?: number;
     expiresAt?: string;
+    actionableUntil?: string;
     withdrawnAt?: string;
     correlationKey?: string;
     status: InboxStatus;

package/dist/src/proactive/mail-thread.js

@@ -1,7 +1,8 @@
-import { getSqliteDatabase } from "../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
 import { getKnowledgeSourceItem } from "../storage/sqlite/knowledge-repository.js";
 import { createHash } from "node:crypto";
 //#region src/proactive/mail-thread.ts
+init_transaction();
 function emailFields(text) {
 	try {
 		const value = JSON.parse(text ?? "{}");

package/dist/src/proactive/maintenance.js

@@ -1,5 +1,6 @@
-import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 //#region src/proactive/maintenance.ts
+init_transaction();
 const RETENTION_DAYS = 90;
 function pruneProactiveHistory(now = /* @__PURE__ */ new Date()) {
 	const cutoff = (/* @__PURE__ */ new Date(now.getTime() - RETENTION_DAYS * 24 * 60 * 6e4)).toISOString();

package/dist/src/proactive/metrics.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase } from "../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
 //#region src/proactive/metrics.ts
+init_transaction();
 function proactiveMetrics(workspace, now = Date.now()) {
 	const db = getSqliteDatabase();
 	const since = (/* @__PURE__ */ new Date(now - 30 * 864e5)).toISOString();

package/dist/src/proactive/policy/presence.d.ts

@@ -1,2 +1,2 @@
 export declare function recordProactivePresence(workspaceId: string, value: unknown, now?: number): void;
-export declare function viewingProactiveCards(workspaceId: string, now?: number): boolean;
+export declare function viewingProactiveCard(workspaceId: string, itemId: string, revision: number, now?: number): boolean;

package/dist/src/proactive/policy/presence.js

@@ -1,6 +1,7 @@
-import { getSqliteDatabase } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
 import { z } from "zod";
 //#region src/proactive/policy/presence.ts
+init_transaction();
 const PresenceSchema = z.object({
 	clientId: z.string().min(8).max(128),
 	active: z.boolean(),
@@ -8,7 +9,9 @@ const PresenceSchema = z.object({
 		"web",
 		"electron",
 		"mobile"
-	])
+	]),
+	inboxItemId: z.string().min(1).max(128).optional(),
+	notificationRevision: z.number().int().positive().optional()
 }).strict();
 function recordProactivePresence(workspaceId, value, now = Date.now()) {
 	const input = PresenceSchema.parse(value);
@@ -18,10 +21,10 @@ function recordProactivePresence(workspaceId, value, now = Date.now()) {
 		db.prepare("DELETE FROM proactive_presence WHERE workspace_id = ? AND client_id = ?").run(workspaceId, input.clientId);
 		return;
 	}
-	db.prepare(`INSERT INTO proactive_presence VALUES (?, ?, ?, ?) ON CONFLICT(workspace_id, client_id) DO UPDATE SET surface = excluded.surface, expires_at = excluded.expires_at`).run(workspaceId, input.clientId, input.surface, now + 75e3);
+	db.prepare(`INSERT INTO proactive_presence(workspace_id, client_id, surface, expires_at, inbox_item_id, notification_revision) VALUES (?, ?, ?, ?, ?, ?) ON CONFLICT(workspace_id, client_id) DO UPDATE SET surface = excluded.surface, expires_at = excluded.expires_at, inbox_item_id = excluded.inbox_item_id, notification_revision = excluded.notification_revision`).run(workspaceId, input.clientId, input.surface, now + 75e3, input.inboxItemId ?? null, input.notificationRevision ?? null);
 }
-function viewingProactiveCards(workspaceId, now = Date.now()) {
-	return Boolean(getSqliteDatabase().prepare("SELECT 1 FROM proactive_presence WHERE workspace_id = ? AND expires_at > ?").get(workspaceId, now));
+function viewingProactiveCard(workspaceId, itemId, revision, now = Date.now()) {
+	return Boolean(getSqliteDatabase().prepare("SELECT 1 FROM proactive_presence WHERE workspace_id = ? AND inbox_item_id = ? AND notification_revision = ? AND expires_at > ?").get(workspaceId, itemId, revision, now));
 }
 //#endregion
-export { recordProactivePresence, viewingProactiveCards };
+export { recordProactivePresence, viewingProactiveCard };

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

@@ -3,7 +3,7 @@ export declare class ProactiveConflict extends Error {
 }
 export declare function subscriptionSettings(id: string): {
     revision: number;
-    level: "off" | "active" | "quiet" | "balanced";
+    level: "active" | "quiet" | "balanced";
     delivery: "digest" | "inbox" | "important";
     completedAt: string;
     scanIntervalMinutes: number;
@@ -13,17 +13,17 @@ export declare function proactivePreferences(workspaceId: string): ProactivePref
 export declare function updateProactivePreferences(workspaceId: string, value: unknown): ProactivePreferences;
 export declare function effectiveProactivePolicy(subscriptionId: string, now?: Date): {
     enabled: boolean;
-    level: "off" | "active" | "quiet" | "balanced";
+    level: "active" | "quiet" | "balanced";
     settings: {
         revision: number;
-        level: "off" | "active" | "quiet" | "balanced";
+        level: "active" | "quiet" | "balanced";
         delivery: "digest" | "inbox" | "important";
         completedAt: string;
         scanIntervalMinutes: number;
         userInstructions: string;
     };
     preferences: {
-        level: "off" | "active" | "quiet" | "balanced";
+        level: "active" | "quiet" | "balanced";
         timezone: string;
         quietStartHour: number;
         quietEndHour: number;
@@ -38,7 +38,9 @@ export declare function effectiveProactivePolicy(subscriptionId: string, now?: D
             publicUrl: string;
             accountId?: string;
         };
-        pausedUntil: string;
+        checksPaused: boolean;
+        checksPausedUntil: string;
+        notificationsMuted: boolean;
         revision: number;
     };
     workspaceId: string;
@@ -49,3 +51,4 @@ export declare function quietHoursEnd(preferences: ProactivePreferences, now: Da
 /** Called in the same transaction as notification persistence. Reservations survive retries. */
 export declare function reserveProactiveNotification(subscriptionId: string, dedupeKey: string, now?: Date): 'allowed' | 'suppressed' | Date;
 export declare function nextDigestTime(preferences: ProactivePreferences, after: Date): Date;
+export declare function proactiveChecksAllowed(preferences: ProactivePreferences, now?: Date): boolean;

package/dist/src/proactive/policy/service.js

@@ -1,6 +1,9 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { ProactivePreferencesSchema, ProactivePreferencesUpdateSchema, ProactiveSubscriptionSettingsSchema } from "../../../packages/gateway-contract/src/proactive.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 //#region src/proactive/policy/service.ts
+init_src();
+init_transaction();
 var ProactiveConflict = class extends Error {};
 function subscriptionSettings(id) {
 	const row = getSqliteDatabase().prepare("SELECT settings_json, revision FROM proactive_subscription_settings WHERE subscription_id = ?").get(id);
@@ -29,15 +32,12 @@ function updateProactivePreferences(workspaceId, value) {
 		if (next.preferredChannel === "telegram" && !next.telegram) throw new Error("Telegram destination is required");
 		db.prepare(`INSERT INTO proactive_preferences(workspace_id, preferences_json, revision) VALUES (?, ?, ?)
       ON CONFLICT(workspace_id) DO UPDATE SET preferences_json = excluded.preferences_json, revision = excluded.revision`).run(workspaceId, JSON.stringify(next), next.revision);
-		if (next.timezone !== current.timezone || next.digestHour !== current.digestHour || next.digestMinute !== current.digestMinute) db.prepare("UPDATE proactive_digest_queue SET due_at = ? WHERE workspace_id = ? AND mode = 'daily' AND consumed_at IS NULL").run(nextDigestTime(next, /* @__PURE__ */ new Date()).toISOString(), workspaceId);
-		if (next.level === "off") {
-			db.prepare("DELETE FROM proactive_digest_queue WHERE workspace_id = ?").run(workspaceId);
-			db.prepare(`UPDATE proactive_delivery_outbox SET status = 'delivered', error_message = 'proactive_disabled'
-        WHERE status IN ('pending', 'retryable') AND inbox_item_id IN (
-          SELECT i.inbox_item_id FROM proactive_inbox_items i JOIN proactive_insights x USING(insight_id)
-          JOIN proactive_scenario_subscriptions s USING(subscription_id) WHERE s.workspace_id = ?
-        )`).run(workspaceId);
+		if (proactiveChecksAllowed(current) && !proactiveChecksAllowed(next)) {
+			db.prepare(`UPDATE proactive_schedule_state SET last_fingerprint = NULL WHERE subscription_id IN
+        (SELECT subscription_id FROM proactive_scenario_subscriptions WHERE workspace_id = ?)`).run(workspaceId);
+			db.prepare("UPDATE proactive_follow_ups SET last_fingerprint = NULL WHERE workspace_id = ? AND status = 'watching'").run(workspaceId);
 		}
+		if (next.timezone !== current.timezone || next.digestHour !== current.digestHour || next.digestMinute !== current.digestMinute) db.prepare("UPDATE proactive_digest_queue SET due_at = ? WHERE workspace_id = ? AND mode = 'daily' AND consumed_at IS NULL").run(nextDigestTime(next, /* @__PURE__ */ new Date()).toISOString(), workspaceId);
 		return next;
 	});
 }
@@ -45,9 +45,9 @@ function effectiveProactivePolicy(subscriptionId, now = /* @__PURE__ */ new Date
 	const sub = getSqliteDatabase().prepare("SELECT workspace_id, enabled FROM proactive_scenario_subscriptions WHERE subscription_id = ?").get(subscriptionId);
 	const settings = subscriptionSettings(subscriptionId);
 	const preferences = proactivePreferences(sub?.workspace_id ?? "default");
-	const level = preferences.level === "off" ? "off" : settings.level ?? preferences.level;
+	const level = settings.level ?? preferences.level;
 	return {
-		enabled: Boolean(sub?.enabled) && !settings.completedAt && level !== "off" && !(preferences.pausedUntil && Date.parse(preferences.pausedUntil) > now.getTime()),
+		enabled: Boolean(sub?.enabled) && !settings.completedAt && proactiveChecksAllowed(preferences, now),
 		level,
 		settings,
 		preferences,
@@ -84,7 +84,7 @@ function quietHoursEnd(preferences, now) {
 function reserveProactiveNotification(subscriptionId, dedupeKey, now = /* @__PURE__ */ new Date()) {
 	return runSqliteWriteTransaction((db) => {
 		const policy = effectiveProactivePolicy(subscriptionId, now);
-		if (!policy.enabled) return "suppressed";
+		if (!policy.enabled || policy.preferences.notificationsMuted) return "suppressed";
 		if (policy.level === "quiet" || policy.settings.delivery === "inbox") return "suppressed";
 		const end = quietHoursEnd(policy.preferences, now);
 		if (end) return end;
@@ -116,5 +116,8 @@ function nextDigestTime(preferences, after) {
 	}
 	return new Date(after.getTime() + 864e5);
 }
+function proactiveChecksAllowed(preferences, now = /* @__PURE__ */ new Date()) {
+	return !preferences.checksPaused && !(preferences.checksPausedUntil && Date.parse(preferences.checksPausedUntil) > now.getTime());
+}
 //#endregion
-export { ProactiveConflict, effectiveProactivePolicy, localProactiveDay, nextDigestTime, proactivePreferences, quietHoursEnd, reserveProactiveNotification, subscriptionSettings, updateProactivePreferences };
+export { ProactiveConflict, effectiveProactivePolicy, localProactiveDay, nextDigestTime, proactiveChecksAllowed, proactivePreferences, quietHoursEnd, reserveProactiveNotification, subscriptionSettings, updateProactivePreferences };

package/dist/src/proactive/routing/batch-repository.js

@@ -1,6 +1,7 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/proactive/routing/batch-repository.ts
+init_transaction();
 function fromRow(row) {
 	return {
 		id: row.batch_id,

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

@@ -1,7 +1,7 @@
 export declare function requireSubscription(id: string, workspaceId: string): import("./types.js").ScenarioSubscription;
 export declare function controlledSubscriptions(workspaceId: string): {
     revision: number;
-    level: "off" | "active" | "quiet" | "balanced";
+    level: "active" | "quiet" | "balanced";
     delivery: "digest" | "inbox" | "important";
     completedAt: string;
     scanIntervalMinutes: number;
@@ -18,7 +18,7 @@ export declare function controlledSubscriptions(workspaceId: string): {
 }[];
 export declare function createControlledSubscription(workspaceId: string, value: unknown): {
     revision: number;
-    level: "off" | "active" | "quiet" | "balanced";
+    level: "active" | "quiet" | "balanced";
     delivery: "digest" | "inbox" | "important";
     completedAt: string;
     scanIntervalMinutes: number;
@@ -35,7 +35,7 @@ export declare function createControlledSubscription(workspaceId: string, value:
 };
 export declare function updateControlledSubscription(workspaceId: string, id: string, value: unknown): {
     revision: number;
-    level: "off" | "active" | "quiet" | "balanced";
+    level: "active" | "quiet" | "balanced";
     delivery: "digest" | "inbox" | "important";
     completedAt: string;
     scanIntervalMinutes: number;

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

@@ -1,8 +1,11 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { ProactiveSubscriptionCreateSchema, ProactiveSubscriptionSettingsSchema, ProactiveSubscriptionUpdateSchema } from "../../../packages/gateway-contract/src/proactive.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { ProactiveConflict, subscriptionSettings } from "../policy/service.js";
 import { createPromptDraft, getScenario, getSubscription, listSubscriptions, publishPromptRevision, upsertSubscription } from "./repository.js";
 //#region src/proactive/scenarios/control.ts
+init_src();
+init_transaction();
 function requireSubscription(id, workspaceId) {
 	const sub = getSubscription(id);
 	if (!sub || sub.workspaceId !== workspaceId) throw new Error("Subscription not found");
@@ -18,8 +21,6 @@ function saveSettings(id, value, revision) {
 	const settings = ProactiveSubscriptionSettingsSchema.parse(value);
 	getSqliteDatabase().prepare(`INSERT INTO proactive_subscription_settings(subscription_id, settings_json, revision) VALUES (?, ?, ?)
     ON CONFLICT(subscription_id) DO UPDATE SET settings_json = excluded.settings_json, revision = excluded.revision`).run(id, JSON.stringify(settings), revision);
-	getSqliteDatabase().prepare(`INSERT INTO proactive_schedule_state(subscription_id, next_due_at) VALUES (?, ?)
-    ON CONFLICT(subscription_id) DO UPDATE SET next_due_at = excluded.next_due_at`).run(id, (/* @__PURE__ */ new Date()).toISOString());
 }
 function createControlledSubscription(workspaceId, value) {
 	const input = ProactiveSubscriptionCreateSchema.parse(value);
@@ -37,6 +38,7 @@ function createControlledSubscription(workspaceId, value) {
 		});
 		if (input.userInstructions || sub.activePromptRevisionId) publishPromptRevision(createPromptDraft(sub.id, input.userInstructions).id);
 		saveSettings(sub.id, input, 1);
+		if (scopeKind === "project") getSqliteDatabase().prepare("INSERT INTO proactive_schedule_state(subscription_id, next_due_at) VALUES (?, ?)").run(sub.id, (/* @__PURE__ */ new Date()).toISOString());
 		return controlledSubscriptions(workspaceId).find((item) => item.id === sub.id);
 	});
 }
@@ -55,6 +57,17 @@ function updateControlledSubscription(workspaceId, id, value) {
 			...current,
 			...patch
 		}, current.revision + 1);
+		if (sub.scopeKind === "project") {
+			const db = getSqliteDatabase();
+			const changedInstructions = patch.userInstructions !== void 0 && patch.userInstructions !== current.userInstructions;
+			const resumed = patch.enabled === true && !sub.enabled;
+			if (changedInstructions || resumed) db.prepare("UPDATE proactive_schedule_state SET next_due_at = ?, last_fingerprint = NULL WHERE subscription_id = ?").run((/* @__PURE__ */ new Date()).toISOString(), id);
+			else if (patch.scanIntervalMinutes !== void 0 && patch.scanIntervalMinutes !== current.scanIntervalMinutes) {
+				const schedule = db.prepare("SELECT last_checked_at FROM proactive_schedule_state WHERE subscription_id = ?").get(id);
+				const next = Math.max(Date.now(), schedule?.last_checked_at ? Date.parse(schedule.last_checked_at) + (patch.scanIntervalMinutes ?? 120) * 6e4 : Date.now());
+				db.prepare("UPDATE proactive_schedule_state SET next_due_at = ? WHERE subscription_id = ?").run(new Date(next).toISOString(), id);
+			}
+		}
 		return controlledSubscriptions(workspaceId).find((item) => item.id === id);
 	});
 }

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

@@ -1,7 +1,8 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { effectiveProactivePolicy } from "../policy/service.js";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/proactive/scenarios/repository.ts
+init_transaction();
 const text = (row, key) => String(row[key]);
 function scenarioFromRow(row) {
 	const condition = row.condition_json ? JSON.parse(String(row.condition_json)) : void 0;

package/dist/src/proactive/service.js

@@ -1,9 +1,10 @@
-import { getSqliteDatabase } from "../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
 import { normalizeEventEnvelope } from "./events/envelope.js";
 import { getEventByDedupeKey, insertEvent, isEventRouted, listEvents, markEventRouted } from "./events/repository.js";
 import { addEventToBatch, listBatches, markReadyBatches } from "./routing/batch-repository.js";
 import { matchScenario } from "./routing/matcher.js";
 //#region src/proactive/service.ts
+init_transaction();
 var ProactiveEventService = class {
 	constructor(routes = () => []) {
 		this.routes = routes;

package/dist/src/proactive/source-freshness.d.ts

@@ -0,0 +1,8 @@
+/** Only a successful pull of this collection proves its observed coverage. */
+export declare function sourceFreshness(itemId: string, notBefore?: string, now?: number): {
+    fresh: boolean;
+    lastSyncedAt: string;
+    syncFailed: boolean;
+    version: string;
+};
+export declare function evidenceSourcesFresh(ids: string[], context?: Record<string, unknown>): boolean;

package/dist/src/proactive/source-freshness.js

@@ -0,0 +1,28 @@
+import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
+import { getKnowledgeSourceItem } from "../storage/sqlite/knowledge-repository.js";
+//#region src/proactive/source-freshness.ts
+init_transaction();
+const MAX_SOURCE_AGE_MS = 30 * 6e4;
+/** Only a successful pull of this collection proves its observed coverage. */
+function sourceFreshness(itemId, notBefore, now = Date.now()) {
+	const item = getKnowledgeSourceItem(itemId);
+	const row = item ? getSqliteDatabase().prepare(`SELECT run_id, status, started_at, finished_at FROM knowledge_sync_runs
+    WHERE source_instance_id = ? AND collection_scope = ? ORDER BY started_at DESC, rowid DESC LIMIT 1`).get(item.sourceInstanceId, item.collectionScope) : void 0;
+	const lastSuccess = item ? getSqliteDatabase().prepare("SELECT MAX(finished_at) AS at FROM knowledge_sync_runs WHERE source_instance_id = ? AND collection_scope = ? AND status = 'succeeded'").get(item.sourceInstanceId, item.collectionScope) : void 0;
+	return {
+		fresh: Boolean(row?.status === "succeeded" && row.finished_at && row.started_at <= now && now - row.started_at <= MAX_SOURCE_AGE_MS && (!notBefore || row.started_at >= Date.parse(notBefore))),
+		lastSyncedAt: lastSuccess?.at ? new Date(lastSuccess.at).toISOString() : null,
+		syncFailed: Boolean(row && [
+			"failed",
+			"partial",
+			"cancelled"
+		].includes(row.status)),
+		version: row?.run_id ?? "unknown"
+	};
+}
+function evidenceSourcesFresh(ids, context) {
+	const follow = context?.follow_up;
+	return ids.every((id) => !id.startsWith("source-item:") || sourceFreshness(id.slice(12), follow?.deadlinePassed ? follow.dueAt : void 0).fresh);
+}
+//#endregion
+export { evidenceSourcesFresh, sourceFreshness };

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

@@ -0,0 +1,2 @@
+import type { ProactiveCheckStatus } from '@xopcai/gateway-contract';
+export declare function followUpCheckStatus(subscriptionId: string, project: boolean): ProactiveCheckStatus;

package/dist/src/proactive/status.js

@@ -0,0 +1,22 @@
+import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
+import { effectiveProactivePolicy } from "./policy/service.js";
+//#region src/proactive/status.ts
+init_transaction();
+function followUpCheckStatus(subscriptionId, project) {
+	const db = getSqliteDatabase();
+	const recent = db.prepare(`SELECT run_id AS id, status, outcome_reason AS outcome, started_at AS startedAt,
+    completed_at AS completedAt, next_attempt_at AS retryAt, attempt FROM proactive_runs
+    WHERE subscription_id = ? ORDER BY started_at DESC LIMIT 5`).all(subscriptionId);
+	const schedule = project ? db.prepare("SELECT last_checked_at, next_due_at FROM proactive_schedule_state WHERE subscription_id = ?").get(subscriptionId) : void 0;
+	const pending = db.prepare("SELECT status FROM proactive_signal_batches WHERE subscription_id = ? AND status IN ('collecting', 'ready', 'processing') ORDER BY created_at DESC LIMIT 1").get(subscriptionId);
+	const latest = recent[0];
+	const enabled = effectiveProactivePolicy(subscriptionId).enabled;
+	return {
+		health: !enabled ? "waiting" : pending?.status === "processing" ? "running" : pending ? "queued" : latest?.status === "retryable" ? "retrying" : latest?.status === "failed" || latest?.outcome === "source_unavailable" || latest?.outcome === "source_stale" ? "blocked" : "waiting",
+		recent,
+		lastCheckedAt: schedule?.last_checked_at ?? recent.find((run) => run.status === "completed")?.completedAt ?? null,
+		nextCheckAt: !enabled ? null : latest?.status === "retryable" ? latest.retryAt : schedule?.next_due_at ?? null
+	};
+}
+//#endregion
+export { followUpCheckStatus };

package/dist/src/proactive/temporal/schedule.js

@@ -1,7 +1,8 @@
-import { runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { effectiveProactivePolicy, localProactiveDay } from "../policy/service.js";
 import { createHash } from "node:crypto";
 //#region src/proactive/temporal/schedule.ts
+init_transaction();
 /** Local scans publish through the same event pipeline; next_due_at survives restarts. */
 function scanDueProjects(events, now = /* @__PURE__ */ new Date()) {
 	return runSqliteWriteTransaction((db) => {

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

@@ -1,6 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { listKnowledgeSourceItems } from "../../storage/sqlite/knowledge-repository.js";
+import { sourceFreshness } from "../source-freshness.js";
 import { authorizedConnectedSource } from "../execution/authorization.js";
 import { effectiveProactivePolicy } from "../policy/service.js";
 import { listSubscriptions } from "../scenarios/repository.js";
@@ -84,7 +85,7 @@ var ProactiveTemporalWorker = class {
 					const connectorId = metadataString(item.metadata, "connectorId");
 					const agentId = metadataString(item.metadata, "agentId");
 					const window = meetingWindow(item.occurredAt ? Date.parse(item.occurredAt) : NaN, nowMs);
-					if (!connectionId || !workspaceId || !activeWorkspaces.has(workspaceId) || !connectorId || !window || !isMeetingWorthPreparing(item.normalizedText) || !authorizedConnectedSource(item.id, workspaceId, MEETING_SCENARIO, agentId) || item.sensitivity === "secret" || item.sensitivity === "regulated") {
+					if (!connectionId || !workspaceId || !activeWorkspaces.has(workspaceId) || !connectorId || !window || !sourceFreshness(item.id, void 0, now.getTime()).fresh || !isMeetingWorthPreparing(item.normalizedText) || !authorizedConnectedSource(item.id, workspaceId, MEETING_SCENARIO, agentId) || item.sensitivity === "secret" || item.sensitivity === "regulated") {
 						result.skipped += 1;
 						continue;
 					}

package/dist/src/projects/automation-bind.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 //#region src/projects/automation-bind.ts
+init_transaction();
 function bindAutomationToProject(automationId, projectId) {
 	const db = getSqliteDatabase();
 	if (!db.prepare(`SELECT 1 FROM projects WHERE project_id = ?`).get(projectId)) throw new Error(`Project not found: ${projectId}`);

package/dist/src/projects/index.js

@@ -2,7 +2,7 @@ import { ProjectStore, slugifyProjectName } from "./project-store.js";
 import { getProjectForSession, getProjectWorkspacePathForSession, resolveProjectWorkspacePath } from "./workspace.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, ensureWorkspaceDirectory, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists } from "./workspace-project.js";
 import { inferProjectExecutionMode, inferProjectKind } from "./project-kind.js";
-import { bindSessionToProject, bindSessionsToProject, listProjectSessionKeys, moveSessionToProject, unbindSessionFromProject } from "./session-bind.js";
+import { bindSessionToProject, bindSessionsToProject, listProjectConversationIds, moveSessionToProject, unbindSessionFromProject } from "./session-bind.js";
 import { ProjectService } from "./project-service.js";
 import { ProjectSkillError, ProjectSkillService } from "./project-skill-service.js";
 import { isValidProjectAgentId, normalizeProjectAgentId, resolveProjectAgentId } from "./project-agent.js";
@@ -11,4 +11,4 @@ import { buildProjectLoopOverview } from "./project-loop.js";
 import { bindWorkflowRunToProject } from "./workflow-bind.js";
 import { bindAutomationToProject } from "./automation-bind.js";
 import { bindKnowledgeItemToProject } from "./knowledge-bind.js";
-export { CODING_PROJECT_AGENT_ID, ProjectService, ProjectSkillError, ProjectSkillService, ProjectStore, ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, bindAutomationToProject, bindKnowledgeItemToProject, bindSessionToProject, bindSessionsToProject, bindWorkflowRunToProject, buildProjectLoopOverview, canonicalWorkspacePath, ensureWorkspaceDirectory, getProjectForSession, getProjectWorkspacePathForSession, inferProjectExecutionMode, inferProjectKind, inferProjectNameFromWorkspaceRoot, inferSuggestedProjectDefaultAgentId, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, isValidProjectAgentId, listProjectSessionKeys, moveSessionToProject, normalizeProjectAgentId, resolveProjectAgentId, resolveProjectWorkspacePath, resolveWorkspaceProjectRoot, slugifyProjectName, suggestProjectDefaultAgentId, unbindSessionFromProject, workspaceDirectoryExists };
+export { CODING_PROJECT_AGENT_ID, ProjectService, ProjectSkillError, ProjectSkillService, ProjectStore, ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, bindAutomationToProject, bindKnowledgeItemToProject, bindSessionToProject, bindSessionsToProject, bindWorkflowRunToProject, buildProjectLoopOverview, canonicalWorkspacePath, ensureWorkspaceDirectory, getProjectForSession, getProjectWorkspacePathForSession, inferProjectExecutionMode, inferProjectKind, inferProjectNameFromWorkspaceRoot, inferSuggestedProjectDefaultAgentId, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, isValidProjectAgentId, listProjectConversationIds, moveSessionToProject, normalizeProjectAgentId, resolveProjectAgentId, resolveProjectWorkspacePath, resolveWorkspaceProjectRoot, slugifyProjectName, suggestProjectDefaultAgentId, unbindSessionFromProject, workspaceDirectoryExists };

package/dist/src/projects/knowledge-bind.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 //#region src/projects/knowledge-bind.ts
+init_transaction();
 function bindKnowledgeItemToProject(knowledgeId, projectId) {
 	const db = getSqliteDatabase();
 	if (!db.prepare("SELECT 1 FROM projects WHERE project_id = ?").get(projectId)) throw new Error(`Project not found: ${projectId}`);

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

@@ -8,7 +8,10 @@ function normalizeAgentId(value) {
 function resolveProjectAgentId(input) {
 	const fallback = getDefaultAgentId(input.config);
 	const explicitAgentId = normalizeAgentId(input.explicitAgentId);
-	if (explicitAgentId && agentExists(explicitAgentId, input.config)) return explicitAgentId;
+	if (explicitAgentId) {
+		if (!agentExists(explicitAgentId, input.config)) throw new Error(`Agent not found: ${explicitAgentId}`);
+		return explicitAgentId;
+	}
 	const projectId = input.projectId?.trim();
 	const projectAgentId = projectId ? normalizeAgentId(input.projects.get(projectId)?.defaultAgentId) : void 0;
 	if (projectAgentId && agentExists(projectAgentId, input.config)) return projectAgentId;

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

@@ -50,8 +50,8 @@ export declare class ProjectService {
         nextSteps?: string[];
         actor: Record<string, unknown>;
     }): ProjectUpdate;
-    attachSession(sessionKey: string, projectId: string): void;
-    detachSession(sessionKey: string): void;
-    listSessionKeys(projectId: string, limit?: number, offset?: number): string[];
-    suggestProjectsForSession(sessionKey: string): ProjectSuggestion[];
+    attachSession(conversationId: string, projectId: string): void;
+    detachSession(conversationId: string): void;
+    listConversationIds(projectId: string, limit?: number, offset?: number): string[];
+    suggestProjectsForSession(conversationId: string): ProjectSuggestion[];
 }

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

@@ -1,13 +1,14 @@
-import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
 import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
 import { ProjectStore } from "./project-store.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, ensureWorkspaceDirectory, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists } from "./workspace-project.js";
 import { inferProjectExecutionMode } from "./project-kind.js";
-import { bindSessionToProject, listProjectSessionKeys, unbindSessionFromProject } from "./session-bind.js";
+import { bindSessionToProject, listProjectConversationIds, unbindSessionFromProject } from "./session-bind.js";
 import { createHash } from "node:crypto";
 //#region src/projects/project-service.ts
+init_transaction();
 var ProjectService = class {
 	constructor(store = new ProjectStore(), signals, workspaceId = "default") {
 		this.store = store;
@@ -245,17 +246,17 @@ var ProjectService = class {
 	createUpdate(projectId, input) {
 		return this.store.createUpdate(projectId, input);
 	}
-	attachSession(sessionKey, projectId) {
-		bindSessionToProject(sessionKey, projectId);
+	attachSession(conversationId, projectId) {
+		bindSessionToProject(conversationId, projectId);
 	}
-	detachSession(sessionKey) {
-		unbindSessionFromProject(sessionKey);
+	detachSession(conversationId) {
+		unbindSessionFromProject(conversationId);
 	}
-	listSessionKeys(projectId, limit, offset) {
-		return listProjectSessionKeys(projectId, limit, offset);
+	listConversationIds(projectId, limit, offset) {
+		return listProjectConversationIds(projectId, limit, offset);
 	}
-	suggestProjectsForSession(sessionKey) {
-		const session = getSessionMetadata(sessionKey);
+	suggestProjectsForSession(conversationId) {
+		const session = getSessionMetadata(conversationId);
 		if (!session) return [];
 		const projects = this.list({
 			status: "active",

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

@@ -1,7 +1,9 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import { escapeFts5Query } from "../storage/sqlite/fts.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { escapeFts5Query, init_fts } from "../storage/sqlite/fts.js";
 import { randomUUID } from "node:crypto";
 //#region src/projects/project-store.ts
+init_fts();
+init_transaction();
 function trimOptional(value) {
 	if (value == null) return void 0;
 	return value.trim() || void 0;
@@ -234,14 +236,14 @@ var ProjectStore = class {
 			const clauses = [`s.updated_at >= ?`];
 			params.push(query.updatedAfter);
 			if (query.includePinned) clauses.push(`s.status = 'pinned'`);
-			const includeSessionKey = query.includeSessionKey?.trim();
-			if (includeSessionKey) {
-				clauses.push(`s.session_key = ?`);
-				params.push(includeSessionKey);
+			const includeConversationId = query.includeConversationId?.trim();
+			if (includeConversationId) {
+				clauses.push(`s.conversation_id = ?`);
+				params.push(includeConversationId);
 			}
 			sessionConditions.push(`(${clauses.join(" OR ")})`);
 		}
-		const whereParts = [...projectConditions, ...sessionConditions.length ? [`(s.session_key IS NULL OR (${sessionConditions.join(" AND ")}))`] : []];
+		const whereParts = [...projectConditions, ...sessionConditions.length ? [`(s.conversation_id IS NULL OR (${sessionConditions.join(" AND ")}))`] : []];
 		const where = whereParts.length ? `WHERE ${whereParts.join(" AND ")}` : "";
 		const limit = clampLimit(query.limit, 50);
 		const offset = Math.max(0, Math.floor(query.offset ?? 0));
@@ -327,9 +329,9 @@ var ProjectStore = class {
         WHERE project_id = ? AND phase <> 'closed'`).get(id).total;
 	}
 	getRecentSessions(id, limit = 5) {
-		return getSqliteDatabase().prepare(`SELECT session_key, name, updated_at, agent_id FROM sessions
+		return getSqliteDatabase().prepare(`SELECT conversation_id, name, updated_at, agent_id FROM sessions
          WHERE project_id = ? AND hidden_from_session_list = 0 ORDER BY updated_at DESC LIMIT ?`).all(id, clampLimit(limit, 5)).map((row) => ({
-			key: row.session_key,
+			key: row.conversation_id,
 			name: row.name ?? void 0,
 			updatedAt: new Date(row.updated_at).toISOString(),
 			agentId: row.agent_id

package/dist/src/projects/session-bind.d.ts

@@ -1,5 +1,5 @@
-export declare function bindSessionToProject(sessionKey: string, projectId: string): void;
-export declare function unbindSessionFromProject(sessionKey: string): void;
-export declare function listProjectSessionKeys(projectId: string, limit?: number, offset?: number): string[];
-export declare function bindSessionsToProject(sessionKeys: string[], projectId: string): void;
-export declare function moveSessionToProject(sessionKey: string, targetProjectId: string): void;
+export declare function bindSessionToProject(conversationId: string, projectId: string): void;
+export declare function unbindSessionFromProject(conversationId: string): void;
+export declare function listProjectConversationIds(projectId: string, limit?: number, offset?: number): string[];
+export declare function bindSessionsToProject(conversationIds: string[], projectId: string): void;
+export declare function moveSessionToProject(conversationId: string, targetProjectId: string): void;