@xopcai/xopc 0.0.391 → 0.0.393

package/dist/src/scenes/httpServices.d.ts

@@ -1,39 +0,0 @@
-import type { BrowserSubscriptionService } from '../notifications/browserSubscriptions.js';
-import type { ScenePrincipal } from './contracts.js';
-import type { SceneInboxService } from './inbox.js';
-import type { SceneRepository } from './repository.js';
-import type { SceneApplicationService } from './service.js';
-import type { SceneMailContextProvider } from './mailContext.js';
-import type { ScenePreferenceService } from './preferences.js';
-import type { SceneMetrics } from './metrics.js';
-import type { SceneActivationAdapter } from './activationAdapter.js';
-import type { SceneCapabilityRegistry } from './registry.js';
-import type { SceneSourceRegistry } from './taskFollowUp/contracts.js';
-/** An explicitly installed scene domain; never resolves to the old runtime. */
-export interface SceneHttpServices {
-    activationAdapters: SceneCapabilityRegistry<SceneActivationAdapter>;
-    sourceProviders: SceneSourceRegistry;
-    repository: SceneRepository;
-    application: SceneApplicationService;
-    inbox: SceneInboxService;
-    mail: SceneMailContextProvider;
-    mailDiscovery?: {
-        listAccounts(principal: ScenePrincipal): Array<{
-            id: string;
-            label: string;
-        }>;
-        searchSources(principal: ScenePrincipal, value: unknown, signal: AbortSignal): Promise<Array<{
-            id: string;
-            accountId: string;
-            subject: string;
-            sender: string;
-        }>>;
-    };
-    metrics: SceneMetrics;
-    preferences: ScenePreferenceService;
-    browser: BrowserSubscriptionService;
-}
-export interface SceneAccess {
-    principal: ScenePrincipal;
-    services: SceneHttpServices;
-}

package/dist/src/scenes/httpServices.js

@@ -1 +0,0 @@
-export {};

package/dist/src/scenes/inbox.d.ts

@@ -1,17 +0,0 @@
-import type { DatabaseSync } from 'node:sqlite';
-import type { ScenePrincipal } from './contracts.js';
-/** Feedback records a user's judgment, never an inferred successful action. */
-export declare class SceneInboxService {
-    private readonly db;
-    private readonly clock;
-    constructor(db: DatabaseSync, clock?: () => number);
-    get database(): DatabaseSync;
-    setRead(principal: ScenePrincipal, id: string, read: boolean): void;
-    feedback(principal: ScenePrincipal, id: string, value: unknown): number;
-    getFeedback(principal: ScenePrincipal, id: string): {
-        rating: string;
-        note: string;
-        revision: number;
-    } | null;
-    private assertVisible;
-}

package/dist/src/scenes/inbox.js

@@ -1,68 +0,0 @@
-import { SceneFeedbackSchema } from "../../packages/gateway-contract/src/scenes.js";
-import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { SceneConflictError, SceneNotFoundError } from "./repository.js";
-import { randomUUID } from "node:crypto";
-//#region src/scenes/inbox.ts
-init_src();
-const actionable = `withdrawn_at IS NULL AND (expires_at IS NULL OR expires_at > ?)
-  AND (status IN ('unread', 'read') OR (status = 'snoozed' AND snoozed_until <= ?))`;
-/** Feedback records a user's judgment, never an inferred successful action. */
-var SceneInboxService = class {
-	constructor(db, clock = Date.now) {
-		this.db = db;
-		this.clock = clock;
-	}
-	get database() {
-		return this.db;
-	}
-	setRead(principal, id, read) {
-		if (typeof read !== "boolean") throw new Error("Read state must be a boolean");
-		this.assertVisible(principal, id);
-		const now = this.clock();
-		if (this.db.prepare(`UPDATE scene_presentations SET status = ?, revision = revision + 1, updated_at = ? WHERE id = ? AND ${actionable}`).run(read ? "read" : "unread", now, id, now, now).changes !== 1) throw new SceneConflictError("Scene presentation was withdrawn");
-	}
-	feedback(principal, id, value) {
-		const input = SceneFeedbackSchema.parse(value);
-		this.assertVisible(principal, id);
-		this.db.exec("SAVEPOINT scene_feedback_write");
-		try {
-			const now = this.clock();
-			const note = input.note ?? String(this.db.prepare("SELECT note FROM scene_feedback WHERE presentation_id = ?").get(id)?.note ?? "");
-			if ((input.expectedRevision === 0 ? this.db.prepare(`INSERT INTO scene_feedback (presentation_id, rating, note, revision, updated_at)
-            SELECT ?, ?, ?, 1, ? WHERE EXISTS (SELECT 1 FROM scene_presentations WHERE id = ? AND ${actionable})
-            ON CONFLICT(presentation_id) DO NOTHING`).run(id, input.rating, note, now, id, now, now) : this.db.prepare(`UPDATE scene_feedback SET rating = ?, note = ?, revision = revision + 1, updated_at = ?
-            WHERE presentation_id = ? AND revision = ?
-            AND EXISTS (SELECT 1 FROM scene_presentations WHERE id = ? AND ${actionable})`).run(input.rating, note, now, id, input.expectedRevision, id, now, now)).changes !== 1) throw new SceneConflictError("Scene feedback changed");
-			this.db.prepare(`INSERT INTO scene_feedback_history(id, presentation_id, rating, note, revision, recorded_at)
-        VALUES (?, ?, ?, ?, ?, ?)`).run(randomUUID(), id, input.rating, note, input.expectedRevision + 1, now);
-			this.db.exec("RELEASE scene_feedback_write");
-			return input.expectedRevision + 1;
-		} catch (error) {
-			this.db.exec("ROLLBACK TO scene_feedback_write");
-			this.db.exec("RELEASE scene_feedback_write");
-			throw error;
-		}
-	}
-	getFeedback(principal, id) {
-		this.assertVisible(principal, id);
-		const row = this.db.prepare("SELECT rating, note, revision FROM scene_feedback WHERE presentation_id = ?").get(id);
-		return row ? {
-			rating: String(row.rating),
-			note: String(row.note),
-			revision: Number(row.revision)
-		} : null;
-	}
-	assertVisible(principal, id) {
-		if (!principal.ownerId?.trim() || !principal.workspaceId?.trim()) throw new Error("Scene principal is required");
-		const row = this.db.prepare(`SELECT p.status, p.withdrawn_at, p.expires_at, p.snoozed_until FROM scene_presentations p
-      JOIN scene_outcomes o ON o.id = p.outcome_id JOIN scene_runs r ON r.id = o.run_id
-      JOIN scene_activations a ON a.id = r.activation_id
-      WHERE p.id = ? AND a.owner_id = ? AND a.workspace_id = ?`).get(id, principal.ownerId, principal.workspaceId);
-		if (!row) throw new SceneNotFoundError("Scene presentation not found");
-		const now = this.clock();
-		if (row.status === "withdrawn" || row.withdrawn_at !== null) throw new SceneConflictError("Scene presentation was withdrawn");
-		if (row.status === "resolved" || row.expires_at !== null && Number(row.expires_at) <= now || row.status === "snoozed" && (row.snoozed_until === null || Number(row.snoozed_until) > now)) throw new SceneConflictError("Scene presentation is not currently actionable");
-	}
-};
-//#endregion
-export { SceneInboxService };

package/dist/src/scenes/mailContext.d.ts

@@ -1,24 +0,0 @@
-import type { DatabaseSync } from 'node:sqlite';
-import type { SceneContextProvider, SceneEvidence } from './execution.js';
-import type { SceneActivation, ScenePrincipal } from './contracts.js';
-/** Reads a bounded, account-scoped thread from synchronized connector knowledge. */
-export declare class SceneMailContextProvider implements SceneContextProvider {
-    private readonly db;
-    private readonly clock;
-    readonly id = "mail";
-    readonly tracksHealth = true;
-    readonly requiresAccountIdentity = true;
-    constructor(db: DatabaseSync, clock?: () => number);
-    setupIssues(activation: SceneActivation): string[];
-    authorization(activation: SceneActivation): string[] | null;
-    /** Resolve current account grants for the exact delegated source, including reconnects and revocation. */
-    authorizedAccounts(activation: SceneActivation): string[];
-    /** Picker metadata only; choosing an item still requires explicit activation consent. */
-    listSources(principal: ScenePrincipal, limit?: number, afterId?: string): {
-        id: string;
-        accountId: string;
-        subject: string;
-        sender: string;
-    }[];
-    read(input: Parameters<SceneContextProvider['read']>[0]): Promise<SceneEvidence[]>;
-}

package/dist/src/scenes/mailContext.js

@@ -1,115 +0,0 @@
-import { SceneSourceNotReady } from "./readiness.js";
-//#region src/scenes/mailContext.ts
-const accountJoin = `JOIN connector_accounts a ON a.id = c.account_id AND a.current_connection_id = c.id
-  AND a.principal_id = c.principal_id AND a.connector_id = c.connector_id
-  JOIN connector_installations installation ON installation.id = c.installation_id
-  AND installation.principal_id = c.principal_id AND installation.connector_id = c.connector_id`;
-const accountPolicy = `a.enabled = 1 AND installation.enabled = 1 AND c.status = 'active'
-  AND json_array_length(installation.allowed_agent_ids_json) = 0 AND a.allowed_agent_ids_json IS NULL
-  AND (installation.selected_account_ids_json = 'null' OR EXISTS
-    (SELECT 1 FROM json_each(installation.selected_account_ids_json) WHERE value = a.id))`;
-/** Reads a bounded, account-scoped thread from synchronized connector knowledge. */
-var SceneMailContextProvider = class {
-	id = "mail";
-	tracksHealth = true;
-	requiresAccountIdentity = true;
-	constructor(db, clock = Date.now) {
-		this.db = db;
-		this.clock = clock;
-	}
-	setupIssues(activation) {
-		return activation.scope.kind === "objects" && activation.scope.ids.length === 1 && activation.permissions.accountIds.length === 1 ? [] : ["one_mail_thread_and_account"];
-	}
-	authorization(activation) {
-		const accounts = this.authorizedAccounts(activation);
-		return accounts.length ? accounts : null;
-	}
-	/** Resolve current account grants for the exact delegated source, including reconnects and revocation. */
-	authorizedAccounts(activation) {
-		if (activation.scope.kind !== "objects" || activation.scope.ids.length !== 1) return [];
-		const row = this.db.prepare(`SELECT a.id FROM knowledge_source_items k
-      JOIN connector_connections c ON c.id = json_extract(CASE WHEN json_valid(k.metadata_json) THEN k.metadata_json ELSE '{}' END, '$.connectionId')
-      ${accountJoin}
-      WHERE k.item_id = ? AND k.item_type = 'email' AND k.deleted_at IS NULL
-        AND k.sensitivity NOT IN ('secret', 'regulated')
-        AND json_valid(k.metadata_json) AND json_valid(k.normalized_text)
-        AND json_type(k.normalized_text, '$.threadId') = 'text'
-        AND length(trim(json_extract(k.normalized_text, '$.threadId'))) > 0
-        AND NOT EXISTS (SELECT 1 FROM json_each(k.normalized_text, '$.labels') WHERE value IN ('DRAFT', 'TRASH', 'SPAM'))
-        AND json_extract(k.metadata_json, '$.workspaceId') = ? AND c.principal_id = ?
-        AND ${accountPolicy}
-        AND (c.expires_at IS NULL OR julianday(c.expires_at) > julianday(?, 'unixepoch'))`).get(activation.scope.ids[0], activation.workspaceId, activation.ownerId, this.clock() / 1e3);
-		return row && activation.permissions.accountIds.includes(String(row.id)) ? [String(row.id)] : [];
-	}
-	/** Picker metadata only; choosing an item still requires explicit activation consent. */
-	listSources(principal, limit = 50, afterId = "") {
-		if (!principal.ownerId.trim() || !principal.workspaceId.trim()) throw new Error("Scene principal is required");
-		if (!Number.isInteger(limit) || limit < 1 || limit > 100) throw new Error("Invalid source list limit");
-		return this.db.prepare(`SELECT k.item_id AS id, a.id AS accountId,
-        substr(json_extract(k.normalized_text, '$.subject'), 1, 300) AS subject,
-        substr(json_extract(k.normalized_text, '$.sender'), 1, 300) AS sender
-      FROM knowledge_source_items k
-      JOIN connector_connections c ON c.id = json_extract(CASE WHEN json_valid(k.metadata_json) THEN k.metadata_json ELSE '{}' END, '$.connectionId')
-      ${accountJoin}
-      WHERE k.item_type = 'email' AND k.deleted_at IS NULL AND k.sensitivity NOT IN ('secret', 'regulated')
-        AND json_valid(k.normalized_text) AND json_valid(k.metadata_json)
-        AND json_extract(k.metadata_json, '$.workspaceId') = ? AND c.principal_id = ?
-        AND ${accountPolicy}
-        AND (c.expires_at IS NULL OR julianday(c.expires_at) > julianday(?, 'unixepoch'))
-        AND json_type(k.normalized_text, '$.threadId') = 'text' AND length(trim(json_extract(k.normalized_text, '$.threadId'))) > 0
-        AND NOT EXISTS (SELECT 1 FROM json_each(k.normalized_text, '$.labels') WHERE value IN ('DRAFT', 'TRASH', 'SPAM'))
-        AND k.item_id > ? ORDER BY k.item_id LIMIT ?`).all(principal.workspaceId, principal.ownerId, this.clock() / 1e3, afterId, limit).map((row) => ({
-			id: String(row.id),
-			accountId: String(row.accountId),
-			subject: typeof row.subject === "string" ? row.subject : "",
-			sender: typeof row.sender === "string" ? row.sender : ""
-		}));
-	}
-	async read(input) {
-		input.signal.throwIfAborted();
-		if (!input.permissions.contextProviders.includes(this.id)) throw new Error("Mail context permission is required");
-		const origin = this.db.prepare(`SELECT * FROM knowledge_source_items WHERE item_id = ? AND item_type = 'email' AND deleted_at IS NULL`).get(input.subjectId);
-		if (!origin) throw new Error("Mail source unavailable");
-		const metadata = JSON.parse(origin.metadata_json);
-		if (metadata.workspaceId !== input.activation.workspaceId || typeof metadata.connectionId !== "string") throw new Error("Mail source workspace mismatch");
-		const connection = this.db.prepare(`SELECT c.account_id, c.expires_at FROM connector_connections c
-      ${accountJoin} WHERE c.id = ? AND c.principal_id = ? AND ${accountPolicy}`).get(metadata.connectionId, input.activation.ownerId);
-		if (!connection || !input.permissions.accountIds.includes(connection.account_id)) throw new Error("Mail account permission is required");
-		if (connection.expires_at !== null && !(Date.parse(connection.expires_at) > this.clock())) throw new Error("Mail connection is expired");
-		const fields = JSON.parse(origin.normalized_text);
-		if (typeof fields.threadId !== "string" || !fields.threadId.trim()) throw new Error("Mail thread identity unavailable");
-		if (Array.isArray(fields.labels) && fields.labels.some((label) => [
-			"DRAFT",
-			"TRASH",
-			"SPAM"
-		].includes(label))) throw new Error("Mail origin is not an active message");
-		const sync = this.db.prepare(`SELECT 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(origin.source_instance_id, origin.collection_scope);
-		const now = this.clock();
-		if (!sync || sync.status !== "succeeded" || sync.finished_at === null || sync.finished_at < sync.started_at || sync.started_at > now || sync.finished_at > now || sync.started_at + 30 * 6e4 <= now || input.notBefore !== void 0 && sync.started_at < input.notBefore) throw new SceneSourceNotReady();
-		const messages = this.db.prepare(`SELECT * FROM knowledge_source_items
-      WHERE source_instance_id = ? AND collection_scope = ? AND item_type = 'email' AND deleted_at IS NULL
-      AND json_valid(normalized_text) AND json_valid(metadata_json)
-      AND json_extract(normalized_text, '$.threadId') = ?
-      AND json_extract(metadata_json, '$.connectionId') = ?
-      AND json_extract(metadata_json, '$.workspaceId') = ?
-      AND NOT EXISTS (SELECT 1 FROM json_each(normalized_text, '$.labels') WHERE value IN ('DRAFT', 'TRASH', 'SPAM'))
-      ORDER BY occurred_at, item_id LIMIT 31`).all(origin.source_instance_id, origin.collection_scope, fields.threadId, metadata.connectionId, input.activation.workspaceId);
-		if (!messages.length || messages.length > 30) throw new Error("Mail thread cannot be read completely within its budget");
-		if (messages.some((item) => ["secret", "regulated"].includes(item.sensitivity))) throw new Error("Mail thread contains restricted evidence");
-		input.signal.throwIfAborted();
-		return messages.map((item) => ({
-			id: item.item_id,
-			subjectId: input.subjectId,
-			ownerId: input.activation.ownerId,
-			workspaceId: input.activation.workspaceId,
-			accountId: connection.account_id,
-			revision: item.content_hash,
-			freshUntil: sync.started_at + 30 * 6e4,
-			...item.occurred_at !== null ? { occurredAt: item.occurred_at } : {},
-			content: item.normalized_text
-		}));
-	}
-};
-//#endregion
-export { SceneMailContextProvider };

package/dist/src/scenes/mailObservations.d.ts

@@ -1,20 +0,0 @@
-import { type SceneActivation, type ScenePermission } from './contracts.js';
-import type { SceneContextProvider } from './execution.js';
-import { SceneRepository } from './repository.js';
-/** Observes only explicitly delegated threads; the host owns scan scheduling. */
-export declare class SceneMailObservationService {
-    private readonly repository;
-    private readonly provider;
-    private readonly authorize;
-    private readonly clock;
-    private readonly intervalMs;
-    private readonly itemTimeoutMs;
-    private nextScanAt;
-    private readonly failures;
-    constructor(repository: SceneRepository, provider: SceneContextProvider, authorize: (activation: SceneActivation) => Promise<ScenePermission>, clock?: () => number, intervalMs?: number, itemTimeoutMs?: number);
-    scan(signal: AbortSignal, afterId?: string, progress?: (id: string) => void): Promise<{
-        changed: number;
-        unavailable: number;
-        nextCursor: string | null;
-    }>;
-}

package/dist/src/scenes/mailObservations.js

@@ -1,107 +0,0 @@
-import { intersectPermissions, sceneContentHash } from "./contracts.js";
-import { sceneSourceFailureReason } from "./readiness.js";
-//#region src/scenes/mailObservations.ts
-/** Observes only explicitly delegated threads; the host owns scan scheduling. */
-var SceneMailObservationService = class {
-	nextScanAt = 0;
-	failures = /* @__PURE__ */ new Map();
-	constructor(repository, provider, authorize, clock = Date.now, intervalMs = 0, itemTimeoutMs = 5e3) {
-		this.repository = repository;
-		this.provider = provider;
-		this.authorize = authorize;
-		this.clock = clock;
-		this.intervalMs = intervalMs;
-		this.itemTimeoutMs = itemTimeoutMs;
-		if (provider.id !== "mail") throw new Error("Mail observation requires the mail context provider");
-	}
-	async scan(signal, afterId = "", progress) {
-		signal.throwIfAborted();
-		if (!afterId && this.clock() < this.nextScanAt) return {
-			changed: 0,
-			unavailable: 0,
-			nextCursor: null
-		};
-		const items = this.repository.listMailObservationItems(afterId, this.clock());
-		const started = Date.now();
-		let lastId = afterId;
-		let processed = 0;
-		let changed = 0;
-		let unavailable = 0;
-		for (const { principal, item } of items) {
-			signal.throwIfAborted();
-			if (Date.now() - started >= 2e4) break;
-			lastId = item.id;
-			processed += 1;
-			const backoff = this.failures.get(item.accountId);
-			if (this.intervalMs > 0 && backoff && backoff.until > this.clock()) {
-				progress?.(lastId);
-				continue;
-			}
-			const controller = new AbortController();
-			const abort = () => controller.abort(signal.reason);
-			signal.addEventListener("abort", abort, { once: true });
-			const timeout = setTimeout(() => controller.abort(/* @__PURE__ */ new Error("Mail item timed out")), this.itemTimeoutMs);
-			let rejectAbort = () => {};
-			const aborted = new Promise((_, reject) => {
-				rejectAbort = () => reject(controller.signal.reason);
-				controller.signal.addEventListener("abort", rejectAbort, { once: true });
-			});
-			let activation;
-			try {
-				activation = this.repository.getActivation(principal, item.activationId);
-				const template = this.repository.getTemplate(activation.templateKey, activation.templateVersion);
-				if (!template.contextProviders.includes("mail") || !template.triggers.some((trigger) => trigger.type === "event" && trigger.eventType === "mail.thread.changed") || activation.scope.kind !== "objects" || !activation.scope.ids.includes(item.subjectId)) throw new Error("Mail observation is outside the template or delegated scope");
-				const permissions = intersectPermissions(activation.permissions, await Promise.race([this.authorize(activation), aborted]), {
-					accountIds: [item.accountId],
-					contextProviders: ["mail"],
-					effectHandlers: []
-				});
-				signal.throwIfAborted();
-				if (!this.repository.isMailObservationCurrent(activation, item, this.clock())) throw new Error("Mail delegation changed during authorization");
-				if (!permissions.accountIds.includes(item.accountId) || !permissions.contextProviders.includes("mail")) throw new Error("Mail observation permission is required");
-				const evidence = await Promise.race([this.provider.read({
-					activation,
-					permissions,
-					subjectId: item.subjectId,
-					signal: controller.signal
-				}), aborted]);
-				signal.throwIfAborted();
-				if (!evidence.length || evidence.length > 100 || new Set(evidence.map((entry) => entry.id)).size !== evidence.length || evidence.reduce((size, entry) => size + entry.content.length, 0) > 12e4 || evidence.some((entry) => !entry.id || !entry.revision || entry.ownerId !== principal.ownerId || entry.workspaceId !== principal.workspaceId || entry.accountId !== item.accountId || entry.subjectId !== item.subjectId || !Number.isFinite(entry.freshUntil) || entry.freshUntil <= this.clock())) throw new Error("Mail observation is incomplete or unauthorized");
-				const currentPermissions = intersectPermissions(permissions, await Promise.race([this.authorize(activation), aborted]));
-				signal.throwIfAborted();
-				if (!this.repository.isMailObservationCurrent(activation, item, this.clock())) throw new Error("Mail delegation changed during observation");
-				if (sceneContentHash(currentPermissions) !== sceneContentHash(permissions)) throw new Error("Mail observation permission changed");
-				this.repository.recordSourceHealth(activation, null, this.clock());
-				this.failures.delete(item.accountId);
-				const fingerprint = sceneContentHash(evidence.map(({ freshUntil: _freshUntil, ...entry }) => entry).sort((a, b) => a.id.localeCompare(b.id)));
-				if (this.repository.observeMailWorkItem(principal, item, fingerprint, this.clock())) changed += 1;
-			} catch (error) {
-				signal.throwIfAborted();
-				unavailable += 1;
-				const retryDelay = Math.max(this.intervalMs, Math.min(3e5, 1e4 * 2 ** Math.min((backoff?.count ?? 0) + 1, 5)));
-				if (activation && this.repository.isMailObservationCurrent(activation, item, this.clock())) this.repository.recordSourceHealth(activation, sceneSourceFailureReason(error), this.clock(), this.clock() + Math.max(retryDelay, 6e4));
-				if (this.intervalMs > 0) {
-					const count = Math.min((backoff?.count ?? 0) + 1, 5);
-					this.failures.set(item.accountId, {
-						count,
-						until: this.clock() + Math.min(3e5, 1e4 * 2 ** count)
-					});
-				}
-			} finally {
-				clearTimeout(timeout);
-				signal.removeEventListener("abort", abort);
-				controller.signal.removeEventListener("abort", rejectAbort);
-				if (!signal.aborted) progress?.(lastId);
-			}
-		}
-		const nextCursor = processed < items.length || items.length === 100 ? lastId : null;
-		if (nextCursor === null) this.nextScanAt = this.clock() + this.intervalMs;
-		return {
-			changed,
-			unavailable,
-			nextCursor
-		};
-	}
-};
-//#endregion
-export { SceneMailObservationService };

package/dist/src/scenes/maintenance.d.ts

@@ -1,3 +0,0 @@
-import type { DatabaseSync } from 'node:sqlite';
-/** Keeps identity/deduplication rows; removes bounded old payloads only after their work is terminal. */
-export declare function maintainSceneStorage(db: DatabaseSync, now?: number): void;

package/dist/src/scenes/maintenance.js

@@ -1,20 +0,0 @@
-import { init_transaction, runSqliteSavepoint } from "../storage/sqlite/transaction.js";
-//#region src/scenes/maintenance.ts
-init_transaction();
-/** Keeps identity/deduplication rows; removes bounded old payloads only after their work is terminal. */
-function maintainSceneStorage(db, now = Date.now()) {
-	const cutoff = now - 90 * 864e5;
-	runSqliteSavepoint(db, () => {
-		db.prepare("DELETE FROM scene_connector_usage WHERE utc_day < ?").run(Math.floor(cutoff / 864e5));
-		db.prepare("DELETE FROM notification_presence WHERE expires_at <= ?").run(now);
-		db.prepare("DELETE FROM notification_browser_subscriptions WHERE expires_at <= ?").run(now);
-		db.prepare(`DELETE FROM scene_mail_sources WHERE id IN (SELECT s.id FROM scene_mail_sources s
-      WHERE s.selected_at < ? AND NOT EXISTS (SELECT 1 FROM scene_activations a, json_each(a.scope_json, '$.ids') ids WHERE ids.value = s.id)
-      ORDER BY selected_at LIMIT 100)`).run(now - 30 * 864e5);
-		for (const table of ["scene_context_snapshots", "scene_model_reservations"]) db.prepare(`DELETE FROM ${table} WHERE run_id IN (SELECT DISTINCT r.id FROM scene_runs r JOIN ${table} t ON t.run_id = r.id
-        WHERE r.status NOT IN ('running', 'retry_wait') AND r.created_at < ? ORDER BY r.created_at LIMIT 100)`).run(cutoff);
-		db.prepare("DELETE FROM notification_attention_budget WHERE dedupe_key IN (SELECT dedupe_key FROM notification_attention_budget WHERE created_at < ? LIMIT 100)").run(cutoff);
-	});
-}
-//#endregion
-export { maintainSceneStorage };

package/dist/src/scenes/metrics.d.ts

@@ -1,31 +0,0 @@
-import type { DatabaseSync } from 'node:sqlite';
-import type { ScenePrincipal } from './contracts.js';
-/** Explicit feedback is a usefulness signal, not proof of adoption or saved time. */
-export declare class SceneMetrics {
-    private readonly db;
-    private readonly clock;
-    private readonly modelRef;
-    constructor(db: DatabaseSync, clock?: () => number, modelRef?: () => string | null);
-    diagnostics(principal: ScenePrincipal): {
-        checksPaused: boolean;
-        currentModel: string;
-        pendingChecks: number;
-        oldestDueWaitMs: number;
-        notifications: Record<string, import("node:sqlite").SQLOutputValue>[];
-        activations: Record<string, import("node:sqlite").SQLOutputValue>[];
-    };
-    forUser(principal: ScenePrincipal, days?: number): {
-        window: {
-            since: number;
-            until: number;
-            days: number;
-        };
-        ratedOutcomes: number;
-        usefulOutcomes: number;
-        unhelpfulOutcomes: number;
-        scenesWithUsefulOutcomes: number;
-        checks: number;
-        failedChecks: number;
-        skippedChecks: number;
-    };
-}

package/dist/src/scenes/metrics.js

@@ -1,89 +0,0 @@
-//#region src/scenes/metrics.ts
-/** Explicit feedback is a usefulness signal, not proof of adoption or saved time. */
-var SceneMetrics = class {
-	constructor(db, clock = Date.now, modelRef = () => null) {
-		this.db = db;
-		this.clock = clock;
-		this.modelRef = modelRef;
-	}
-	diagnostics(principal) {
-		if (!principal.ownerId.trim() || !principal.workspaceId.trim()) throw new Error("Scene principal is required");
-		const now = this.clock();
-		const queue = this.db.prepare(`SELECT COUNT(*) AS depth, MIN(i.due_at) AS oldest
-      FROM scene_trigger_intents i JOIN scene_activations a ON a.id = i.activation_id
-      WHERE a.owner_id = ? AND a.workspace_id = ? AND i.status = 'pending'`).get(principal.ownerId, principal.workspaceId);
-		const notifications = this.db.prepare(`SELECT status, COUNT(*) AS count FROM notification_dispatches
-      WHERE owner_id = ? AND workspace_id = ? GROUP BY status`).all(principal.ownerId, principal.workspaceId);
-		const activations = this.db.prepare(`SELECT a.id, a.status,
-      (SELECT MAX(created_at) FROM scene_runs WHERE activation_id = a.id) AS last_check_at,
-      (SELECT reason FROM scene_runs WHERE activation_id = a.id ORDER BY created_at DESC, id DESC LIMIT 1) AS last_reason,
-      CASE WHEN a.status = 'active' THEN (SELECT MIN(next_due_at) FROM scene_schedule_cursors WHERE activation_id = a.id) END AS next_schedule_at,
-      (SELECT MIN(due_at) FROM scene_work_items WHERE activation_id = a.id AND status = 'watching') AS deadline_at,
-      CASE WHEN a.status = 'active' THEN (SELECT MIN(due_at) FROM scene_work_items WHERE activation_id = a.id AND status = 'watching' AND (last_triggered_revision IS NULL OR last_triggered_revision <> revision)) END AS next_deadline_check_at,
-      (SELECT MIN(retry_at) FROM scene_runs WHERE activation_id = a.id AND status = 'retry_wait') AS retry_at,
-      (SELECT reason FROM scene_source_health WHERE activation_id = a.id) AS source_reason,
-      (SELECT last_attempt_at FROM scene_source_health WHERE activation_id = a.id) AS source_attempt_at,
-      (SELECT consecutive_failures FROM scene_source_health WHERE activation_id = a.id) AS source_failures,
-      (SELECT last_success_at FROM scene_source_health WHERE activation_id = a.id) AS source_success_at,
-      (SELECT retry_at FROM scene_source_health WHERE activation_id = a.id) AS source_retry_at
-      FROM scene_activations a WHERE a.owner_id = ? AND a.workspace_id = ? ORDER BY a.id LIMIT 100`).all(principal.ownerId, principal.workspaceId);
-		const policyRow = this.db.prepare("SELECT preferences_json FROM scene_preferences WHERE owner_id = ? AND workspace_id = ?").get(principal.ownerId, principal.workspaceId);
-		const policy = policyRow ? JSON.parse(String(policyRow.preferences_json)) : {};
-		const checksPaused = policy.checksPaused === true || Date.parse(policy.checksPausedUntil ?? "") > now;
-		if (checksPaused) for (const activation of activations) {
-			activation.next_schedule_at = null;
-			activation.next_deadline_check_at = null;
-			activation.retry_at = null;
-		}
-		let currentModel = null;
-		try {
-			currentModel = this.modelRef();
-		} catch {}
-		return {
-			checksPaused,
-			currentModel,
-			pendingChecks: Number(queue.depth),
-			oldestDueWaitMs: queue.oldest == null ? 0 : Math.max(0, now - Number(queue.oldest)),
-			notifications,
-			activations
-		};
-	}
-	forUser(principal, days = 7) {
-		if (!principal.ownerId?.trim() || !principal.workspaceId?.trim()) throw new Error("Scene principal is required");
-		if (!Number.isInteger(days) || days < 1 || days > 90) throw new Error("Scene metric window must be 1–90 days");
-		const until = this.clock();
-		const since = until - days * 864e5;
-		const feedback = this.db.prepare(`SELECT
-      COUNT(*) AS ratedOutcomes,
-      COALESCE(SUM(CASE WHEN f.rating = 'useful' THEN 1 ELSE 0 END), 0) AS usefulOutcomes,
-      COALESCE(SUM(CASE WHEN f.rating = 'not_useful' THEN 1 ELSE 0 END), 0) AS unhelpfulOutcomes,
-      COUNT(DISTINCT CASE WHEN f.rating = 'useful' THEN a.id END) AS scenesWithUsefulOutcomes
-      FROM scene_feedback_history f JOIN scene_feedback latest
-        ON latest.presentation_id = f.presentation_id AND latest.revision = f.revision
-      JOIN scene_presentations p ON p.id = f.presentation_id JOIN scene_outcomes o ON o.id = p.outcome_id
-      JOIN scene_runs r ON r.id = o.run_id JOIN scene_activations a ON a.id = r.activation_id
-      WHERE a.owner_id = ? AND a.workspace_id = ?
-        AND f.recorded_at >= ? AND f.recorded_at < ?`).get(principal.ownerId, principal.workspaceId, since, until);
-		const work = this.db.prepare(`SELECT COUNT(*) AS checks,
-      COALESCE(SUM(CASE WHEN r.status = 'failed' THEN 1 ELSE 0 END), 0) AS failedChecks,
-      COALESCE(SUM(CASE WHEN r.status = 'skipped' THEN 1 ELSE 0 END), 0) AS skippedChecks
-      FROM scene_runs r JOIN scene_activations a ON a.id = r.activation_id
-      WHERE a.owner_id = ? AND a.workspace_id = ? AND r.created_at >= ? AND r.created_at < ?`).get(principal.ownerId, principal.workspaceId, since, until);
-		return {
-			window: {
-				since,
-				until,
-				days
-			},
-			ratedOutcomes: Number(feedback.ratedOutcomes),
-			usefulOutcomes: Number(feedback.usefulOutcomes),
-			unhelpfulOutcomes: Number(feedback.unhelpfulOutcomes),
-			scenesWithUsefulOutcomes: Number(feedback.scenesWithUsefulOutcomes),
-			checks: Number(work.checks),
-			failedChecks: Number(work.failedChecks),
-			skippedChecks: Number(work.skippedChecks)
-		};
-	}
-};
-//#endregion
-export { SceneMetrics };

package/dist/src/scenes/model.d.ts

@@ -1,3 +0,0 @@
-import type { Config } from '../config/schema.js';
-/** Scene reasoning follows the existing agent model policy and falls back to chat. */
-export declare function resolveSceneModelRef(config: Config): string;

package/dist/src/scenes/model.js

@@ -1,10 +0,0 @@
-import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { resolveModelSelector } from "../config/agent-model-intents.js";
-//#region src/scenes/model.ts
-init_agent_scope();
-/** Scene reasoning follows the existing agent model policy and falls back to chat. */
-function resolveSceneModelRef(config) {
-	return resolveModelSelector(config, resolveDefaultAgentId(), "@reasoning");
-}
-//#endregion
-export { resolveSceneModelRef };

package/dist/src/scenes/notificationEligibility.d.ts

@@ -1,17 +0,0 @@
-import type { DatabaseSync } from 'node:sqlite';
-import type { NotificationResult } from '../notifications/resultOutbox.js';
-export type SceneNotificationEligibility = {
-    action: 'cancel';
-    reason: string;
-} | {
-    action: 'defer';
-    until: number;
-} | {
-    action: 'eligible';
-    activationId: string;
-    presentationId: string;
-    revision: number;
-    kind: string;
-};
-/** Local result eligibility only. The host must still recheck connector authorization and attention policy. */
-export declare function sceneNotificationEligibility(db: DatabaseSync, result: NotificationResult, now: number, expectedRevision?: number): SceneNotificationEligibility;