@xopcai/xopc 0.0.277 → 0.0.282

package/dist/src/gateway/hono/routes/shares.js

@@ -1571,7 +1571,28 @@ function registerShareRoutes(authenticated, deps) {
 		const patch = {};
 		if (typeof body.extendTtlMs === "number") patch.extendTtlMs = body.extendTtlMs;
 		if (body.maxViews === null || typeof body.maxViews === "number") patch.maxViews = body.maxViews;
-		const updated = store.update(id, patch);
+		const existing = store.getById(id);
+		if (patch.extendTtlMs !== void 0 && existing) {
+			if (existing.revoked) return c.json({
+				ok: false,
+				error: { message: "This share was revoked and cannot be restored" }
+			}, 409);
+			if (existing.kind === "file" || existing.kind === "directory") {
+				if (!(await store.validateFileIntegrity(existing)).valid) return c.json({
+					ok: false,
+					error: { message: "The original artifact is missing or was replaced. Generate a new artifact from the task." }
+				}, 410);
+			}
+		}
+		let updated;
+		try {
+			updated = store.update(id, patch);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: { message: error instanceof Error ? error.message : "Cannot renew share" }
+			}, 400);
+		}
 		if (!updated) return c.json({
 			ok: false,
 			error: { message: "Not found" }

package/dist/src/gateway/hono/routes/tasks.js

@@ -49,6 +49,7 @@ function registerTaskRoutes(authenticated, deps) {
 		return c.json({
 			ok: true,
 			items: tasks.list({
+				search: c.req.query("search"),
 				...phase.success ? { phase: phase.data } : {},
 				limit
 			}).map((task) => {
@@ -406,7 +407,7 @@ function registerTaskRoutes(authenticated, deps) {
 				latest: result.model
 			}, 409);
 		}
-		if (parsed.data.command?.type === "add_wait" && parsed.data.command.wait.kind === "paused" || parsed.data.command?.type === "close") {
+		if (parsed.data.command?.type === "add_wait" && parsed.data.command.wait.kind === "paused" || parsed.data.command?.type === "close" || parsed.data.command?.type === "resolve_wait" && parsed.data.command.resolution?.kind === "task_approval" && parsed.data.command.resolution.decision === "deny") {
 			const activeRun = runs.getActiveRoot(c.req.param("id"));
 			if (activeRun?.sessionKey) {
 				const liveRunId = deps.service.getActiveWebchatRunId(activeRun.sessionKey);

package/dist/src/gateway/hono/routes/work-discovery.d.ts

@@ -1,5 +1,3 @@
 import type { Hono } from 'hono';
-import { WorkDiscoveryService } from '../../../work-discovery/service.js';
 import type { AuthenticatedRouteDeps } from './deps.js';
-export declare function getWorkDiscoveryService(deps: AuthenticatedRouteDeps): WorkDiscoveryService;
 export declare function registerWorkDiscoveryRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void;

package/dist/src/gateway/hono/routes/work-discovery.js

@@ -2,30 +2,16 @@ import { getAgentDefaultModelRef, init_schema } from "../../../config/schema.js"
 import { init_providers, resolveModel } from "../../../providers/index.js";
 import { isLocalModelBaseUrl } from "../../../providers/model-call.js";
 import { previewWorkDiscoveryRoot } from "../../../work-discovery/probe.js";
-import { WorkDiscoveryService } from "../../../work-discovery/service.js";
 //#region src/gateway/hono/routes/work-discovery.ts
 init_schema();
 init_providers();
-const services = /* @__PURE__ */ new WeakMap();
-function getWorkDiscoveryService(deps) {
-	const existing = services.get(deps.service);
-	if (existing) return existing;
-	const service = new WorkDiscoveryService({
-		projects: deps.service.projects,
-		sessions: deps.service.sessionIndexInstance,
-		getConfig: () => deps.service.currentConfig,
-		emit: (type, payload) => deps.service.emit(type, payload)
-	});
-	services.set(deps.service, service);
-	return service;
-}
 function stringField(body, field) {
 	if (!body || typeof body !== "object") return "";
 	const value = body[field];
 	return typeof value === "string" ? value.trim() : "";
 }
 function registerWorkDiscoveryRoutes(authenticated, deps) {
-	const service = getWorkDiscoveryService(deps);
+	const service = deps.service.workDiscovery;
 	const limited = deps.strictRateLimitMiddleware;
 	authenticated.get("/api/onboarding/work-discovery", (c) => c.json({
 		enabled: service.isEnabled(),
@@ -268,4 +254,4 @@ function registerWorkDiscoveryRoutes(authenticated, deps) {
 	});
 }
 //#endregion
-export { getWorkDiscoveryService, registerWorkDiscoveryRoutes };
+export { registerWorkDiscoveryRoutes };

package/dist/src/gateway/hono/routes/workflows.js

@@ -7,10 +7,10 @@ import { WorkflowNameConflictError, WorkflowRevisionConflictError, createWorkflo
 import "../../../workflows/domain/index.js";
 import { resolveWorkflowRunArtifactsDir } from "../../../workflows/store/paths.js";
 import { WorkflowDraftService } from "../../../workflows/draft/workflow-draft-service.js";
-import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
-import "../../../workflows/authoring/index.js";
 import "../../../workflows/draft/index.js";
 import { ProjectWorkflowPresetRepository } from "../../../workflows/project-presets/project-workflow-preset-repository.js";
+import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
+import "../../../workflows/authoring/index.js";
 import { basename, join } from "node:path";
 import { readFile, stat } from "node:fs/promises";
 //#region src/gateway/hono/routes/workflows.ts

package/dist/src/gateway/security/gateway-scopes.js

@@ -63,7 +63,6 @@ function requiredGatewayScope(method, path) {
 	if (path.startsWith("/api/agents") || path.startsWith("/api/models")) return methodScope(method, "agents.read", "gateway.admin");
 	if (path.startsWith("/api/sessions") || path.startsWith("/api/side-chats")) return methodScope(method, "sessions.read", "sessions.write");
 	if (path.startsWith("/api/tasks")) return methodScope(method, "tasks.read", "tasks.write");
-	if (method === "POST" && /^\/api\/proactive\/subscriptions\/[^/]+\/preview$/.test(path)) return "agents.run";
 	if (/^\/api\/inbox\/judgments\/[^/]+\/workflow$/.test(path)) return methodScope(method, "automations.read", "automations.write");
 	if (method === "POST" && /^\/api\/inbox\/judgments\/[^/]+\/prepare$/.test(path)) return "automations.write";
 	if (path.startsWith("/api/proactive/web-push")) return "notifications.self";
@@ -73,7 +72,7 @@ function requiredGatewayScope(method, path) {
 	if (path.startsWith("/api/workflows")) return methodScope(method, "automations.read", "automations.write");
 	if (path.startsWith("/api/voice") || path.startsWith("/api/media") || path.startsWith("/api/clarifications")) return "sessions.write";
 	if (path.startsWith("/api/commands") || path.startsWith("/api/skills")) return methodScope(method, "agents.read", "gateway.admin");
-	if (path.startsWith("/api/workspace") || path.startsWith("/api/files") || path.startsWith("/api/projects") || path.startsWith("/api/notes") || path.startsWith("/api/shares")) return methodScope(method, "workspace.read", "workspace.write");
+	if (path === "/api/discussions" || path.startsWith("/api/discussions/") || path === "/api/discussion-capture/settings" || path.startsWith("/api/workspace") || path.startsWith("/api/files") || path.startsWith("/api/projects") || path.startsWith("/api/notes") || path.startsWith("/api/shares")) return methodScope(method, "workspace.read", "workspace.write");
 	return "gateway.admin";
 }
 function hasGatewayScope(granted, required) {

package/dist/src/gateway/service/agent-runner.js

@@ -85,9 +85,9 @@ var GatewayAgentRunner = class {
 						sourceId
 					});
 				}
-				if (unique.size > MAX_TURN_CONTEXTS) throw new Error(`A message can reference at most ${MAX_TURN_CONTEXTS} notes`);
+				if (unique.size > MAX_TURN_CONTEXTS) throw new Error(`A message can reference at most ${MAX_TURN_CONTEXTS} sources`);
 				const contexts = await Promise.all([...unique.values()].map((ref) => opts.resolveTurnContext(ref)));
-				if (contexts.some((context) => context === null)) throw new Error("A referenced note is no longer available");
+				if (contexts.some((context) => context === null)) throw new Error("A referenced source is unavailable or has changed; select it again");
 				return fitSourceContextsToBudget(contexts.filter((context) => context !== null));
 			},
 			steer: (sessionKey, content) => opts.getAgentService().turnDispatcher.steerWebchatSession(sessionKey, content),

package/dist/src/gateway/service/config-coordinator.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { loadConfig, saveConfig } from "../../config/loader.js";
 import { getModelRegistry } from "../../providers/model-registry.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
 import { init_providers } from "../../providers/index.js";
 import { disposeAllSessionMcpRuntimes } from "../../agent/mcp/bundle-mcp-runtime.js";
 import { reloadImageGenerationProviders } from "../../agent/image/generation/provider-registry.js";

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

@@ -1,3 +1,4 @@
+import { WorkDiscoveryService } from '../work-discovery/service.js';
 import { ConnectionRecoveryService } from '../connectors/connection-recovery-service.js';
 import { AgentService } from '../agent/service.js';
 import { MessageBus } from '../infra/bus/index.js';
@@ -98,6 +99,8 @@ export declare class GatewayService {
     readonly marketplace: GatewayMarketplaceService;
     /** First-class project grouping surface. */
     readonly projects: ProjectService;
+    private _workDiscovery;
+    get workDiscovery(): WorkDiscoveryService;
     readonly discussions: DiscussionService;
     readonly discussionWorker: DiscussionOrganizerWorker;
     readonly discussionLiveWorker: DiscussionLiveWorker;

package/dist/src/gateway/service.js

@@ -12,16 +12,19 @@ import { getSessionConfig } from "../storage/sqlite/config-repository.js";
 import "../storage/sqlite/index.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { buildSessionKey, init_session_key, sanitizeSegment } from "../routing/session-key.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
+import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { areExtensionsGloballyDisabled } from "../extensions/discover-extensions.js";
 import { buildExtensionMetadataSnapshot } from "../extensions/extension-metadata-snapshot.js";
 import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, init_channel_catalog_service } from "../channels/catalog/channel-catalog-service.js";
 import { loadConfig, saveConfig } from "../config/loader.js";
-import { prewarmModelRegistry } from "../providers/model-registry.js";
+import { buildSessionKey, init_session_key, sanitizeSegment } from "../routing/session-key.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_providers, providers_exports } from "../providers/index.js";
+import { AutomationService } from "../automations/service/automation-service.js";
+import { onAutomationProductEvent, publishAutomationProductEvent } from "../automations/product-events.js";
+import "../automations/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { TaskRepository } from "../tasks/task-repository.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { getEmbeddedExecutionSession } from "../agent/embedded/execution-context.js";
@@ -35,9 +38,6 @@ import { ProactiveScenarioService } from "../proactive/scenarios/service.js";
 import { ProactiveEventService } from "../proactive/service.js";
 import { TaskApplicationService } from "../tasks/task-application-service.js";
 import { ProactiveInboxService } from "../proactive/inbox/service.js";
-import { AutomationService } from "../automations/service/automation-service.js";
-import { onAutomationProductEvent, publishAutomationProductEvent } from "../automations/product-events.js";
-import "../automations/index.js";
 import { TaskOutboxDispatcher } from "../tasks/task-outbox-dispatcher.js";
 import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
 import { TaskSignalService } from "../tasks/task-signal-service.js";
@@ -56,12 +56,6 @@ import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
-import { DiscussionService } from "../discussions/service.js";
-import { DiscussionOrganizer } from "../discussions/organizer.js";
-import { DiscussionLiveWorker } from "../discussions/live-worker.js";
-import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
-import { DiscussionSealer } from "../discussions/sealer.js";
-import "../discussions/index.js";
 import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
 import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
 import "../knowledge/index.js";
@@ -69,12 +63,20 @@ import { ConnectionRecoveryService } from "../connectors/connection-recovery-ser
 import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
 import { ConnectedSourceChangePublisher } from "../connectors/source-change-publisher.js";
 import { startConnectorSupervisor } from "../connectors/supervisor.js";
+import { DiscussionService } from "../discussions/service.js";
+import { DiscussionOrganizer } from "../discussions/organizer.js";
+import { DiscussionLiveWorker } from "../discussions/live-worker.js";
+import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
+import { DiscussionSealer } from "../discussions/sealer.js";
+import "../discussions/index.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
 import { stopTailscaleExposure } from "./tailscale-lifecycle.js";
+import { buildTaskAgentContext } from "../agent/source-context/task-context.js";
 import { deliverProactiveCard } from "../proactive/inbox/delivery.js";
+import { WorkDiscoveryService } from "../work-discovery/service.js";
 import { buildVoiceMemoryContext } from "../voice/realtime/memory-context.js";
 import { buildVoicePersonaContext } from "../voice/realtime/persona-context.js";
 import { voiceMemoryBudget, voicePersonaBudget } from "../voice/realtime/conversation-context.js";
@@ -305,6 +307,15 @@ var GatewayService = class {
 	marketplace;
 	/** First-class project grouping surface. */
 	projects;
+	_workDiscovery;
+	get workDiscovery() {
+		return this._workDiscovery ??= new WorkDiscoveryService({
+			projects: this.projects,
+			sessions: this.sessionIndex,
+			getConfig: () => this.config,
+			emit: (type, payload) => this.emit(type, payload)
+		});
+	}
 	discussions;
 	discussionWorker;
 	discussionLiveWorker;
@@ -440,6 +451,7 @@ var GatewayService = class {
 			}
 		});
 		this.discussionSealer = new DiscussionSealer({
+			processRecordingJob: () => this.discussions.processRecordingJob(),
 			notes: this.notesService,
 			getConfig: () => this.config,
 			onUpdated: emitDiscussion
@@ -460,6 +472,7 @@ var GatewayService = class {
 			getChannelManager: () => this.channelManager,
 			getConfig: () => this.config,
 			resolveTurnContext: async (ref) => {
+				if (ref.kind === "task") return buildTaskAgentContext(new TaskRepository().get(ref.sourceId), ref.expectedVersion);
 				if (ref.kind !== "note") return null;
 				const note = await this.notesService.getNote(ref.sourceId);
 				if (!note || note.status === "trashed") return null;
@@ -918,6 +931,7 @@ var GatewayService = class {
 			}, `Model registry prewarm failed: ${em}`);
 		}
 		this.modelCatalogSync.start();
+		if (this.running) this.workDiscovery.resumeProjectUnderstanding();
 		if (!this.extensionLoader || areExtensionsGloballyDisabled(this.config)) return;
 		try {
 			if (trace) await trace.measure("extensions.deferred-load", () => this.loadDeferredExtensions());
@@ -1226,6 +1240,7 @@ var GatewayService = class {
 		this.stopRealtimeLogBridge?.();
 		this.stopRealtimeLogBridge = null;
 		log.debug("Stopping gateway service...");
+		await this._workDiscovery?.stop();
 		this.readiness.markStarting();
 		this.endpointTools.close();
 		await this.sideChats.disposeAll();

package/dist/src/knowledge-memory/repository.d.ts

@@ -30,6 +30,8 @@ export declare function writeKnowledgeItem(input: WriteKnowledgeInput): {
 export declare function getKnowledgeItem(id: string): KnowledgeItem | undefined;
 export declare function listKnowledgeItems(input?: {
     principalId?: string;
+    scope?: UserModelScope;
+    canonicalKey?: string;
     statuses?: KnowledgeStatus[];
     recordClass?: KnowledgeRecordClass;
     limit?: number;

package/dist/src/knowledge-memory/repository.js

@@ -106,7 +106,9 @@ function listKnowledgeItems(input = {}) {
 	return getSqliteDatabase().prepare(`SELECT * FROM knowledge_items
     WHERE principal_id = ? AND status IN (${placeholders})
       ${input.recordClass ? "AND record_class = ?" : ""}
-    ORDER BY importance DESC, updated_at DESC LIMIT ?`).all(input.principalId ?? "local-owner", ...statuses, ...input.recordClass ? [input.recordClass] : [], Math.max(1, Math.min(2e3, input.limit ?? 200))).map(fromRow);
+      ${input.scope ? "AND scope_type = ? AND COALESCE(scope_id, '') = COALESCE(?, '')" : ""}
+      ${input.canonicalKey ? "AND canonical_key = ?" : ""}
+    ORDER BY importance DESC, updated_at DESC LIMIT ?`).all(input.principalId ?? "local-owner", ...statuses, ...input.recordClass ? [input.recordClass] : [], ...input.scope ? [input.scope.type, input.scope.id ?? null] : [], ...input.canonicalKey ? [input.canonicalKey] : [], Math.max(1, Math.min(2e3, input.limit ?? 200))).map(fromRow);
 }
 function setKnowledgeStatus(id, status, now = Date.now()) {
 	return getSqliteDatabase().prepare(`UPDATE knowledge_items SET status = ?, updated_at = ?

package/dist/src/media-understanding/audio-transcription-runner.d.ts

@@ -43,6 +43,7 @@ export interface RunAudioTranscriptionResult {
         model?: string;
         language?: string;
         durationSeconds?: number;
+        segments?: import('./types.js').AudioTranscriptionSegment[];
     }>;
     decision: MediaUnderstandingDecision;
 }

package/dist/src/media-understanding/audio-transcription-runner.js

@@ -24,6 +24,7 @@ async function runAudioTranscription(options) {
 	const outputs = result.outputs.map((entry) => ({
 		attachmentIndex: entry.attachmentIndex,
 		text: entry.text,
+		...entry.segments ? { segments: entry.segments } : {},
 		provider: entry.provider,
 		...entry.model ? { model: entry.model } : {},
 		...entry.language ? { language: entry.language } : {},

package/dist/src/media-understanding/runner.js

@@ -118,6 +118,7 @@ async function runCapability(options) {
 					provider: provider.id,
 					model: callResult.model,
 					...callResult.language ? { language: callResult.language } : {},
+					...callResult.segments ? { segments: callResult.segments } : {},
 					...callResult.durationSeconds !== void 0 ? { durationSeconds: callResult.durationSeconds } : {}
 				});
 				break;

package/dist/src/media-understanding/types.d.ts

@@ -58,6 +58,7 @@ export interface CapabilityAttachmentInput {
     mime?: string;
 }
 export interface MediaUnderstandingOutput {
+    segments?: AudioTranscriptionSegment[];
     kind: MediaUnderstandingKind;
     attachmentIndex: number;
     text: string;
@@ -104,7 +105,14 @@ export interface AudioTranscriptionRequest {
     timeoutMs: number;
     signal?: AbortSignal;
 }
+export interface AudioTranscriptionSegment {
+    text: string;
+    startMs: number;
+    endMs: number;
+    speaker?: string;
+}
 export interface AudioTranscriptionResult {
+    segments?: AudioTranscriptionSegment[];
     text: string;
     model?: string;
     /** Provider-reported language (e.g. 'zh', 'en'). */

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

@@ -49,7 +49,9 @@ export declare class NotesService {
     listProjectSummaries(): import("./types.js").NoteProjectSummary[];
     addAttachment(noteId: string, file: {
         name: string;
-        buffer: Buffer;
+        buffer: Buffer | {
+            filePath: string;
+        };
         mimeType: string;
         duration?: number;
         retainWithoutReference?: boolean;

package/dist/src/notes/store.d.ts

@@ -14,7 +14,9 @@ export declare class NotesStore {
         offset: number;
         hasMore: boolean;
     }>;
-    saveAttachment(noteId: string, fileName: string, buffer: Buffer): Promise<{
+    saveAttachment(noteId: string, fileName: string, buffer: Buffer | {
+        filePath: string;
+    }): Promise<{
         relativePath: string;
         size: number;
     }>;

package/dist/src/notes/store.js

@@ -9,7 +9,7 @@ import "../storage/sqlite/index.js";
 import { resolveNoteMediaDir } from "./paths.js";
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";
-import { mkdir, rm, writeFile } from "node:fs/promises";
+import { copyFile, mkdir, rm, stat, writeFile } from "node:fs/promises";
 //#region src/notes/store.ts
 init_logger();
 const log = createLogger("NotesStore");
@@ -61,10 +61,12 @@ var NotesStore = class {
 		const mediaDir = resolveNoteMediaDir(noteId);
 		await mkdir(mediaDir, { recursive: true });
 		const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, "_")}`;
-		await writeFile(join(mediaDir, safeName), buffer);
+		const filePath = join(mediaDir, safeName);
+		if (Buffer.isBuffer(buffer)) await writeFile(filePath, buffer);
+		else await copyFile(buffer.filePath, filePath);
 		return {
 			relativePath: safeName,
-			size: buffer.length
+			size: (await stat(filePath)).size
 		};
 	}
 	resolveAttachmentPath(noteId, relativePath) {

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

@@ -1,6 +1,25 @@
+import { getCard } from './inbox/cards.js';
+type SceneKind = 'project_momentum' | 'meeting_preparation' | 'communication_follow_up';
+type SceneStatus = 'needs_decision' | 'prepared' | 'changed' | 'following';
+interface SceneMoment {
+    id: string;
+    kind: SceneKind;
+    status: SceneStatus;
+    title: string;
+    promise: string;
+    moment: string;
+    relevance: string;
+    help: string;
+    arrangementId: string;
+    manageRoute: string;
+    object: {
+        label: string;
+        route: string;
+    } | null;
+    card: ReturnType<typeof getCard> | null;
+    updatedAt: string;
+}
 export declare function startDelegation(workspace: string, value: unknown): {
-    effectiveLevel: "off" | "active" | "quiet" | "balanced";
-    schedule: Record<string, import("node:sqlite").SQLOutputValue>;
     revision: number;
     level: "off" | "active" | "quiet" | "balanced";
     delivery: "digest" | "inbox" | "important";
@@ -22,6 +41,7 @@ export declare function checkDelegation(workspace: string, id: string): {
     status: "queued";
 };
 export declare function delegationOverview(workspace: string): {
+    scenes: SceneMoment[];
     followUps: {
         id: string;
         subscriptionId: string;
@@ -39,31 +59,28 @@ export declare function delegationOverview(workspace: string): {
         lastSyncedAt: string;
         syncFailed: boolean;
     }[];
-    needsDecision: import("@xopcai/gateway-contract/src/proactive.js").ProactiveCard[];
-    prepared: import("@xopcai/gateway-contract/src/proactive.js").ProactiveCard[];
-    updates: import("@xopcai/gateway-contract/src/proactive.js").ProactiveCard[];
     delegations: {
-        effectiveEnabled: boolean;
-        project: Record<string, import("node:sqlite").SQLOutputValue>;
-        latestRun: Record<string, import("node:sqlite").SQLOutputValue>;
-        pending: boolean;
-        effectiveLevel: "off" | "active" | "quiet" | "balanced";
-        schedule: Record<string, import("node:sqlite").SQLOutputValue>;
-        revision: number;
-        level: "off" | "active" | "quiet" | "balanced";
-        delivery: "digest" | "inbox" | "important";
-        completedAt: string;
-        scanIntervalMinutes: number;
-        userInstructions: string;
         id: string;
         scenarioKey: string;
-        workspaceId: string;
-        scopeKind: "workspace" | "project";
+        scopeKind: "project" | "workspace";
         scopeId: string;
         enabled: boolean;
-        activePromptRevisionId?: string;
-        createdAt: string;
+        revision: number;
+        delivery: "digest" | "inbox" | "important";
+        completedAt: string;
+        userInstructions: string;
         updatedAt: string;
+        effectiveEnabled: boolean;
+        project: {
+            name: string;
+            status: string;
+        };
+        projectMonitoring: {
+            mode: "observe" | "ask_before_action" | "auto_low_risk";
+            allowedActions: string[];
+        };
+        checking: boolean;
     }[];
 };
 export declare function completeDeliveredProjects(now?: Date): void;
+export {};

package/dist/src/proactive/experience.js

@@ -36,6 +36,11 @@ function checkDelegation(workspace, id) {
 	if (!effectiveProactivePolicy(id).enabled) throw new Error("Resume this service before checking");
 	if (sub.scopeKind !== "project") throw new Error("This service checks when connected sources change");
 	return runSqliteWriteTransaction((db) => {
+		const retry = db.prepare("SELECT run_id FROM proactive_runs WHERE subscription_id = ? AND status = 'retryable' ORDER BY started_at DESC LIMIT 1").get(id);
+		if (retry) {
+			db.prepare("UPDATE proactive_runs SET next_attempt_at = ? WHERE run_id = ? AND status = 'retryable'").run((/* @__PURE__ */ new Date()).toISOString(), retry.run_id);
+			return { status: "queued" };
+		}
 		if (db.prepare("SELECT 1 FROM proactive_signal_batches WHERE subscription_id = ? AND status IN ('collecting', 'ready', 'processing')").get(id)) return { status: "queued" };
 		const last = db.prepare("SELECT MAX(started_at) AS at FROM proactive_runs WHERE subscription_id = ?").get(id);
 		if (last.at && Date.parse(last.at) > Date.now() - 6e4) throw new ProactiveConflict("A check just finished; try again in a minute");
@@ -55,21 +60,117 @@ function delegationOverview(workspace) {
     AND (i.expires_at IS NULL OR i.expires_at > ?)
     ORDER BY CASE WHEN x.action_status = 'approval_required' THEN 0 WHEN x.artifact_json IS NOT NULL THEN 1 ELSE 2 END,
     x.value_score DESC, i.updated_at DESC LIMIT 100`).all(workspace, now).map((row) => getCard(row.inbox_item_id, workspace)).filter((card) => !["withdrawn", "expired"].includes(card.status));
+	const followUps = listMailFollowUps(workspace);
+	const delegations = controlledSubscriptions(workspace).map((sub) => ({
+		id: sub.id,
+		scenarioKey: sub.scenarioKey,
+		scopeKind: sub.scopeKind,
+		scopeId: sub.scopeId,
+		enabled: sub.enabled,
+		revision: sub.revision,
+		delivery: sub.delivery,
+		completedAt: sub.completedAt,
+		userInstructions: sub.userInstructions,
+		updatedAt: sub.updatedAt,
+		effectiveEnabled: effectiveProactivePolicy(sub.id).enabled,
+		project: sub.scopeKind === "project" ? db.prepare("SELECT name, status FROM projects WHERE project_id = ?").get(sub.scopeId) ?? null : null,
+		projectMonitoring: sub.scopeKind === "project" ? projectMonitoring(sub.scopeId) : null,
+		checking: Boolean(db.prepare("SELECT 1 FROM proactive_signal_batches WHERE subscription_id = ? AND status IN ('collecting', 'ready', 'processing')").get(sub.id))
+	}));
 	return {
-		followUps: listMailFollowUps(workspace),
-		needsDecision: cards.filter((card) => card.decision && card.actionStatus !== "completed"),
-		prepared: cards.filter((card) => card.artifact && !card.decision),
-		updates: cards.filter((card) => !card.artifact && !card.decision),
-		delegations: controlledSubscriptions(workspace).map((sub) => ({
-			...sub,
-			effectiveEnabled: effectiveProactivePolicy(sub.id).enabled,
-			project: sub.scopeKind === "project" ? db.prepare("SELECT name, status FROM projects WHERE project_id = ?").get(sub.scopeId) ?? null : null,
-			latestRun: db.prepare(`SELECT status, outcome_reason AS reason, completed_at AS completedAt, started_at AS startedAt, error_message AS error
-        FROM proactive_runs WHERE subscription_id = ? ORDER BY started_at DESC LIMIT 1`).get(sub.id) ?? null,
-			pending: Boolean(db.prepare("SELECT 1 FROM proactive_signal_batches WHERE subscription_id = ? AND status IN ('collecting', 'ready', 'processing')").get(sub.id))
-		}))
+		scenes: projectSceneMoments(cards, delegations, followUps),
+		followUps,
+		delegations
 	};
 }
+function projectMonitoring(projectId) {
+	const row = getSqliteDatabase().prepare("SELECT mode, allowed_actions_json FROM project_monitoring_policies WHERE project_id = ?").get(projectId);
+	return row ? {
+		mode: row.mode,
+		allowedActions: JSON.parse(row.allowed_actions_json)
+	} : {
+		mode: "observe",
+		allowedActions: []
+	};
+}
+function projectSceneMoments(cards, delegations, followUps) {
+	const latestCardBySubscription = /* @__PURE__ */ new Map();
+	for (const card of cards) {
+		const previous = latestCardBySubscription.get(card.subscriptionId);
+		if (!previous || previous.updatedAt < card.updatedAt) latestCardBySubscription.set(card.subscriptionId, card);
+	}
+	const moments = [];
+	for (const sub of delegations) {
+		if (!sub.effectiveEnabled || sub.completedAt || ![
+			"project_delivery_risk",
+			"meeting_preparation",
+			"discussion_follow_up"
+		].includes(sub.scenarioKey)) continue;
+		const card = latestCardBySubscription.get(sub.id) ?? null;
+		const project = sub.project;
+		const kind = sub.scenarioKey === "meeting_preparation" ? "meeting_preparation" : sub.scenarioKey === "discussion_follow_up" ? "communication_follow_up" : "project_momentum";
+		const object = project ? {
+			label: project.name,
+			route: `/projects/${encodeURIComponent(sub.scopeId)}`
+		} : card?.evidence.find((item) => item.route) ? (() => {
+			const item = card.evidence.find((value) => value.route);
+			return {
+				label: item.label,
+				route: item.route
+			};
+		})() : null;
+		moments.push({
+			id: `scene:${sub.id}`,
+			kind,
+			status: sceneStatus(card),
+			title: project?.name ?? card?.title ?? (kind === "meeting_preparation" ? "Meeting preparation" : kind === "communication_follow_up" ? "Conversation follow-up" : "Project follow-through"),
+			promise: sub.userInstructions,
+			moment: card?.whyNow ?? (kind === "meeting_preparation" ? "Waiting for the next relevant meeting" : kind === "communication_follow_up" ? "Watching for a meaningful follow-up" : "Watching the project for a meaningful change"),
+			relevance: card?.summary ?? sub.userInstructions,
+			help: card?.workDone || card?.recommendation || (kind === "meeting_preparation" ? "I will bring back a brief before the meeting." : kind === "communication_follow_up" ? "I will return when the discussion needs a next step." : "I will return when the goal, commitment, or delivery risk changes."),
+			arrangementId: sub.id,
+			manageRoute: `/assistant-work?delegation=${encodeURIComponent(sub.id)}`,
+			object,
+			card,
+			updatedAt: card?.updatedAt ?? sub.updatedAt
+		});
+	}
+	for (const follow of followUps) {
+		if (!follow.enabled || follow.status !== "watching") continue;
+		const card = cards.find((item) => item.communication?.id === follow.id) ?? null;
+		moments.push({
+			id: `scene:${follow.id}`,
+			kind: "communication_follow_up",
+			status: sceneStatus(card),
+			title: follow.subject ?? "Communication follow-up",
+			promise: follow.instructions,
+			moment: card?.whyNow ?? (follow.latestDirection === "received" ? "A reply arrived" : `Waiting until ${follow.dueAt}`),
+			relevance: card?.summary ?? follow.instructions,
+			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 ? {
+				label: follow.subject ?? "Open conversation",
+				route: `/chat/${encodeURIComponent(follow.sessionKey)}`
+			} : null,
+			card,
+			updatedAt: card?.updatedAt ?? follow.lastCheckedAt ?? follow.dueAt
+		});
+	}
+	const priority = {
+		needs_decision: 0,
+		prepared: 1,
+		changed: 2,
+		following: 3
+	};
+	return moments.sort((a, b) => priority[a.status] - priority[b.status] || b.updatedAt.localeCompare(a.updatedAt));
+}
+function sceneStatus(card) {
+	if (!card) return "following";
+	if (card.decision && card.actionStatus !== "completed") return "needs_decision";
+	if (card.artifact) return "prepared";
+	return "changed";
+}
 function completeDeliveredProjects(now = /* @__PURE__ */ new Date()) {
 	const db = getSqliteDatabase();
 	const rows = db.prepare(`SELECT s.subscription_id, s.workspace_id FROM proactive_scenario_subscriptions s