@xopcai/xopc 0.0.364 → 0.0.367

package/dist/src/providers/env-keys.js

@@ -60,6 +60,12 @@ var init_env_keys = __esmMin((() => {
 			"GITHUB_COPILOT_TOKEN"
 		],
 		/** DashScope HTTP APIs (image gen, STT, TTS) — not an LLM KnownProvider. */
+		seedream: ["ARK_API_KEY", "VOLCENGINE_API_KEY"],
+		ideogram: ["IDEOGRAM_API_KEY"],
+		bfl: ["BFL_API_KEY"],
+		tokenhub: ["TOKENHUB_API_KEY"],
+		stability: ["STABILITY_API_KEY"],
+		fal: ["FAL_KEY", "FAL_API_KEY"],
 		dashscope: ["DASHSCOPE_API_KEY", "QWEN_API_KEY"],
 		"dashscope-cn": ["DASHSCOPE_API_KEY", "QWEN_API_KEY"],
 		"dashscope-intl": ["DASHSCOPE_API_KEY", "QWEN_API_KEY"],

package/dist/src/providers/model-catalog-persistence.js

@@ -2,6 +2,7 @@ import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_paths_state, resolveXopcCloudCatalogCachePath } from "../config/paths-state.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
+import { ImageGenerationCapabilitiesSchema, init_models_json } from "../config/models-json.js";
 import { voiceManifestSchema } from "../../packages/realtime-protocol/src/voice-catalog.js";
 import { init_voice } from "../../packages/realtime-protocol/src/voice.js";
 import { readFileSync, rmSync } from "node:fs";
@@ -10,33 +11,13 @@ import { rm } from "node:fs/promises";
 //#region src/providers/model-catalog-persistence.ts
 var MAX_CATALOG_BYTES, imageGenerationSchema, sttSchema, ttsSchema, searchSchema, catalogModelSchema, persistedCatalogSchema, ModelCatalogPersistence;
 var init_model_catalog_persistence = __esmMin((() => {
+	init_models_json();
 	init_voice();
 	init_src();
 	init_paths_state();
 	init_write_file_atomic();
 	MAX_CATALOG_BYTES = 4 * 1024 * 1024;
-	imageGenerationSchema = z.object({
-		maxCount: z.number().int().positive(),
-		sizes: z.array(z.string()),
-		aspectRatios: z.array(z.string()).optional(),
-		qualities: z.array(z.enum([
-			"low",
-			"medium",
-			"high",
-			"auto"
-		])),
-		formats: z.array(z.enum([
-			"png",
-			"jpeg",
-			"webp"
-		])),
-		backgrounds: z.array(z.enum([
-			"transparent",
-			"opaque",
-			"auto"
-		])),
-		maxInputImages: z.number().int().nonnegative()
-	}).strict();
+	imageGenerationSchema = ImageGenerationCapabilitiesSchema;
 	sttSchema = z.object({
 		inputFormats: z.array(z.string()),
 		maxBytes: z.number().int().nonnegative(),

package/dist/src/providers/model-catalog-store.js

@@ -77,14 +77,7 @@ var init_model_catalog_store = __esmMin((() => {
 					input: [...model.input],
 					output: [...model.output],
 					operations: [...model.operations],
-					...model.imageGeneration ? { imageGeneration: {
-						...model.imageGeneration,
-						sizes: [...model.imageGeneration.sizes],
-						aspectRatios: [...model.imageGeneration.aspectRatios ?? []],
-						qualities: [...model.imageGeneration.qualities],
-						formats: [...model.imageGeneration.formats],
-						backgrounds: [...model.imageGeneration.backgrounds]
-					} } : {},
+					...model.imageGeneration ? { imageGeneration: structuredClone(model.imageGeneration) } : {},
 					...model.voice ? { voice: structuredClone(model.voice) } : {},
 					...model.stt ? { stt: {
 						...model.stt,

package/dist/src/providers/model-catalog-types.d.ts

@@ -20,15 +20,7 @@ export interface CatalogModel {
     priority?: number;
     tier?: string;
     bestEffort?: boolean;
-    imageGeneration?: {
-        maxCount: number;
-        sizes: string[];
-        aspectRatios?: string[];
-        qualities: Array<'low' | 'medium' | 'high' | 'auto'>;
-        formats: Array<'png' | 'jpeg' | 'webp'>;
-        backgrounds: Array<'transparent' | 'opaque' | 'auto'>;
-        maxInputImages: number;
-    };
+    imageGeneration?: import('../../packages/image-providers/src/types.js').ImageCapabilities;
     stt?: {
         inputFormats: string[];
         maxBytes: number;

package/dist/src/providers/xopc-cloud-model-source.js

@@ -1,9 +1,11 @@
 import { init_model_policy, isDedicatedComputerProfile } from "../computer/model-policy.js";
+import { ImageGenerationCapabilitiesSchema, init_models_json } from "../config/models-json.js";
 import { voiceManifestSchema } from "../../packages/realtime-protocol/src/voice-catalog.js";
 import { init_voice } from "../../packages/realtime-protocol/src/voice.js";
 import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 import { getProviderAuthService, init_provider_auth_service } from "./provider-auth-service.js";
 //#region src/providers/xopc-cloud-model-source.ts
+init_models_json();
 init_voice();
 init_model_policy();
 init_provider_auth_service();
@@ -190,31 +192,8 @@ function positiveInteger(value) {
 	return Number.isSafeInteger(value) && Number(value) > 0 ? Number(value) : 0;
 }
 function parseImageGenerationCapabilities(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
-	const raw = value;
-	const strings = (candidate, allowed) => Array.isArray(candidate) ? candidate.filter((item) => typeof item === "string" && (!allowed || allowed.includes(item))) : [];
-	return {
-		maxCount: Number.isSafeInteger(raw.maxCount) && Number(raw.maxCount) > 0 ? Number(raw.maxCount) : 1,
-		sizes: strings(raw.sizes),
-		aspectRatios: strings(raw.aspectRatios),
-		qualities: strings(raw.qualities, [
-			"low",
-			"medium",
-			"high",
-			"auto"
-		]),
-		formats: strings(raw.formats, [
-			"png",
-			"jpeg",
-			"webp"
-		]),
-		backgrounds: strings(raw.backgrounds, [
-			"transparent",
-			"opaque",
-			"auto"
-		]),
-		maxInputImages: Number.isSafeInteger(raw.maxInputImages) && Number(raw.maxInputImages) > 0 ? Number(raw.maxInputImages) : 0
-	};
+	const parsed = ImageGenerationCapabilitiesSchema.safeParse(value);
+	return parsed.success ? parsed.data : void 0;
 }
 function parseDisplayNames(value) {
 	if (!value || typeof value !== "object" || Array.isArray(value)) return {};

package/dist/src/session/client-history.d.ts

@@ -1,3 +1,4 @@
+import { type PersonalProvenance } from '@xopcai/gateway-contract';
 import { type TaskResultDelivery, type TurnOutcome, type UserTurnDocument } from '@xopcai/gateway-contract';
 import type { Message } from './types.js';
 import type { TaskUpdateTrigger } from '../storage/sqlite/session-input-repository.js';
@@ -37,6 +38,7 @@ export interface ClientHistoryMessage {
         userTurnDocument?: UserTurnDocument;
         turnOutcome?: TurnOutcome;
         taskResultDelivery?: TaskResultDelivery;
+        personalProvenance?: PersonalProvenance;
     };
     kind?: 'message' | 'compaction' | 'context' | 'bash' | 'custom' | 'branch';
     tokensBefore?: number;

package/dist/src/session/client-history.js

@@ -1,6 +1,7 @@
 import { parseTurnOutcome } from "../../packages/gateway-contract/src/turn-outcome.js";
 import { isUserTurnDocument } from "../../packages/gateway-contract/src/user-turn-document.js";
 import { parseTaskResultDelivery } from "../../packages/gateway-contract/src/task-result-delivery.js";
+import { PersonalProvenanceSchema, parsePersonalProactiveMessage } from "../../packages/gateway-contract/src/personal-proactivity.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 import { buildTranscriptOutline } from "./transcript-outline.js";
@@ -195,6 +196,10 @@ function messagesToClientHistory(messages, opts) {
 			const toolCalls = toolCallsWithResults(collectMessageToolCalls(m.content, m.tool_calls), results);
 			out.push({
 				role: "assistant",
+				...PersonalProvenanceSchema.safeParse(m.metadata?.personalProvenance).success ? {
+					startsNewBubble: true,
+					metadata: { personalProvenance: PersonalProvenanceSchema.parse(m.metadata?.personalProvenance) }
+				} : {},
 				...parseTaskResultDelivery(m.metadata?.taskResultDelivery) ? {
 					startsNewBubble: true,
 					metadata: m.metadata
@@ -338,6 +343,23 @@ function customRowToClientHistory(row) {
 			timestamp: parseTimestampValue(typeof r.timestamp === "number" ? r.timestamp : void 0)
 		};
 	}
+	if (customType === "personal_proactive_message") {
+		const message = parsePersonalProactiveMessage(r.details);
+		if (!message) return null;
+		return {
+			role: "assistant",
+			kind: "message",
+			startsNewBubble: true,
+			turnId: `personal-outreach:${message.outreachId}`,
+			content: message.text,
+			rawContent: [{
+				type: "text",
+				text: message.text
+			}],
+			timestamp: parseTimestampValue(message.createdAt),
+			metadata: { personalProvenance: message.provenance }
+		};
+	}
 	if (customType === "task_result_delivery") {
 		const delivery = parseTaskResultDelivery(r.details);
 		if (!delivery) return null;
@@ -579,6 +601,10 @@ function transcriptRowsToClientHistory(rows, opts) {
 		out.push({
 			id,
 			...messageRow.turnId ? { turnId: messageRow.turnId } : {},
+			...PersonalProvenanceSchema.safeParse(messageRow.metadata?.personalProvenance).success ? {
+				startsNewBubble: true,
+				metadata: { personalProvenance: PersonalProvenanceSchema.parse(messageRow.metadata.personalProvenance) }
+			} : {},
 			...messageRow.turnId && opts?.startsNewBubbleTurnIds?.has(messageRow.turnId) ? { startsNewBubble: true } : {},
 			role: "assistant",
 			kind: "message",

package/dist/src/session/init-session-turn.js

@@ -3,6 +3,7 @@ import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { init_sqlite } from "../storage/sqlite/index.js";
 import { SessionConfigSchema, init_schema } from "../config/schema.js";
+import { isPersonalConversation } from "../personal-agent/repository.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
 import { resolveSessionLifecycleTimestamps } from "./lifecycle-timestamps.js";
@@ -25,6 +26,15 @@ async function initSessionTurn(opts) {
 		conversationId: opts.conversationId
 	});
 	const key = conversationId?.trim() ?? opts.conversationId.trim();
+	if (isPersonalConversation(key)) return {
+		conversationId: key,
+		transcriptId: sessionMetadata?.transcriptId,
+		isNewSession: false,
+		resetTriggered: false,
+		staleRollover: false,
+		bodyStripped: rawBody,
+		bareReset: false
+	};
 	const routing = sessionMetadata?.routing;
 	const peerKind = routing?.peerKind;
 	const resetType = resolveSessionResetType({

package/dist/src/session/session-context-for-llm.js

@@ -1,5 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { parseTaskResultDelivery } from "../../packages/gateway-contract/src/task-result-delivery.js";
+import { parsePersonalProactiveMessage } from "../../packages/gateway-contract/src/personal-proactivity.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { init_voice_transcript, voiceTranscriptMessage } from "./voice-transcript.js";
 import { init_compaction_types, isCompactionAudit, isCompactionHandover } from "./compaction-types.js";
@@ -297,6 +298,18 @@ function buildSessionContextForLlm(rows) {
 		}
 		if (isTranscriptCustomMessageEntry(r)) {
 			if (r.customType === "personal_request_status") continue;
+			if (r.customType === "personal_proactive_message") {
+				const message = parsePersonalProactiveMessage(r.details);
+				if (message) out.push({
+					role: "assistant",
+					content: [{
+						type: "text",
+						text: message.text
+					}],
+					timestamp: message.createdAt
+				});
+				continue;
+			}
 			if (r.customType === "task_result_delivery") {
 				const delivery = parseTaskResultDelivery(r.details);
 				if (delivery) out.push({
@@ -348,6 +361,21 @@ function buildSessionDisplayMessages(rows) {
 				});
 				continue;
 			}
+			if (r.customType === "personal_proactive_message") {
+				const message = parsePersonalProactiveMessage(r.details);
+				if (message) out.push({
+					role: "assistant",
+					content: [{
+						type: "text",
+						text: message.text
+					}],
+					timestamp: message.createdAt,
+					turnId: `personal-outreach:${message.outreachId}`,
+					startsNewBubble: true,
+					metadata: { personalProvenance: message.provenance }
+				});
+				continue;
+			}
 			if (r.customType === "task_result_delivery") {
 				const delivery = parseTaskResultDelivery(r.details);
 				if (delivery) out.push({

package/dist/src/session/store.js

@@ -14,11 +14,11 @@ import { getSessionConfig, setSessionConfig } from "../storage/sqlite/config-rep
 import { init_sqlite } from "../storage/sqlite/index.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../routing/agent-session-key.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
+import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 import { DurableState } from "../storage/sqlite/durable-state.js";
 import { transcriptRowsToClientHistory } from "./client-history.js";
 import { SessionCompactor } from "../agent/memory/compaction.js";
 import { resolveCompactionPolicy } from "../agent/memory/compaction-policy.js";
-import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 import { IdleCompactionScheduler } from "../agent/memory/idle-compaction-scheduler.js";
 import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
 import { promoteCompactionLedger } from "../agent/memory/compaction-promotion.js";

package/dist/src/storage/sqlite/migrations/235_personal_conversation_priority.sql

@@ -0,0 +1,3 @@
+-- Conversation priority is independent of Task cancellation and artifact delivery.
+ALTER TABLE session_inputs ADD COLUMN interrupt_requested INTEGER NOT NULL DEFAULT 0 CHECK(interrupt_requested IN (0, 1));
+ALTER TABLE task_result_deliveries ADD COLUMN reply_context_revision INTEGER;

package/dist/src/storage/sqlite/migrations/236_personal_proactivity.sql

@@ -0,0 +1,53 @@
+CREATE TABLE personal_attention_threads (
+  id TEXT PRIMARY KEY, owner_id TEXT NOT NULL, agent_id TEXT NOT NULL,
+  conversation_id TEXT NOT NULL REFERENCES sessions(conversation_id) ON DELETE CASCADE,
+  subject TEXT NOT NULL, summary TEXT NOT NULL, kind TEXT NOT NULL CHECK(kind IN ('outcome','discussion','interest')),
+  status TEXT NOT NULL CHECK(status IN ('candidate','active','paused','completed','expired')),
+  authority TEXT NOT NULL CHECK(authority IN ('user_explicit','inferred')),
+  task_id TEXT, project_id TEXT, next_check_at INTEGER, pause_until INTEGER, expires_at INTEGER NOT NULL,
+  last_meaningful_at INTEGER NOT NULL, revision INTEGER NOT NULL DEFAULT 1,
+  created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL
+);
+CREATE INDEX personal_attention_due ON personal_attention_threads(status, next_check_at);
+CREATE TABLE personal_attention_sources (
+  thread_id TEXT NOT NULL REFERENCES personal_attention_threads(id) ON DELETE CASCADE,
+  evidence_id TEXT REFERENCES context_evidence(evidence_id) ON DELETE CASCADE,
+  entry_id TEXT NOT NULL REFERENCES transcript_entries(entry_id) ON DELETE CASCADE,
+  transcript_id TEXT NOT NULL, conversation_id TEXT NOT NULL,
+  PRIMARY KEY(thread_id, entry_id)
+);
+CREATE TABLE personal_wakeups (
+  id TEXT PRIMARY KEY, thread_id TEXT NOT NULL REFERENCES personal_attention_threads(id) ON DELETE CASCADE,
+  dedupe_key TEXT NOT NULL UNIQUE, trigger_kind TEXT NOT NULL, source_event_id TEXT,
+  thread_revision INTEGER NOT NULL, not_before INTEGER NOT NULL, expires_at INTEGER NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending','evaluating','done','cancelled','dead_letter')),
+  lease_token TEXT, lease_until INTEGER NOT NULL DEFAULT 0, attempts INTEGER NOT NULL DEFAULT 0,
+  next_attempt_at INTEGER NOT NULL DEFAULT 0, last_error TEXT, created_at INTEGER NOT NULL
+);
+CREATE INDEX personal_wakeups_due ON personal_wakeups(status, next_attempt_at, not_before);
+CREATE TABLE personal_outreach (
+  id TEXT PRIMARY KEY, wakeup_id TEXT NOT NULL UNIQUE REFERENCES personal_wakeups(id) ON DELETE CASCADE,
+  thread_id TEXT NOT NULL REFERENCES personal_attention_threads(id) ON DELETE CASCADE,
+  conversation_id TEXT NOT NULL REFERENCES sessions(conversation_id) ON DELETE CASCADE,
+  origin_transcript_id TEXT NOT NULL, thread_revision INTEGER NOT NULL, context_revision INTEGER NOT NULL,
+  policy_revision INTEGER NOT NULL, decision TEXT NOT NULL, reason TEXT NOT NULL,
+  state TEXT NOT NULL CHECK(state IN ('decided','ready','published','stale','cancelled')),
+  text TEXT, provenance_json TEXT NOT NULL CHECK(json_valid(provenance_json)),
+  valid_until INTEGER NOT NULL, message_entry_id TEXT, notified_at INTEGER,
+  created_at INTEGER NOT NULL, published_at INTEGER
+);
+CREATE INDEX personal_outreach_pending ON personal_outreach(state, created_at);
+CREATE TABLE personal_feedback (
+  id TEXT PRIMARY KEY, outreach_id TEXT NOT NULL REFERENCES personal_outreach(id) ON DELETE CASCADE,
+  thread_id TEXT NOT NULL REFERENCES personal_attention_threads(id) ON DELETE CASCADE,
+  owner_id TEXT NOT NULL, kind TEXT NOT NULL, scope TEXT NOT NULL,
+  payload_json TEXT NOT NULL CHECK(json_valid(payload_json)), created_at INTEGER NOT NULL,
+  dedupe_key TEXT NOT NULL, UNIQUE(owner_id, dedupe_key)
+);
+CREATE TABLE personal_adaptive_strategies (
+  id TEXT PRIMARY KEY, thread_id TEXT NOT NULL REFERENCES personal_attention_threads(id) ON DELETE CASCADE,
+  feedback_id TEXT NOT NULL UNIQUE REFERENCES personal_feedback(id) ON DELETE CASCADE,
+  dimension TEXT NOT NULL CHECK(dimension = 'preparation'), value TEXT NOT NULL,
+  authority TEXT NOT NULL CHECK(authority = 'explicit'), revision INTEGER NOT NULL,
+  created_at INTEGER NOT NULL, review_at INTEGER NOT NULL
+);

package/dist/src/storage/sqlite/migrations/237_personal_strategy_versions.sql

@@ -0,0 +1,18 @@
+CREATE TABLE personal_strategy_versions (
+  id TEXT PRIMARY KEY,
+  owner_id TEXT NOT NULL,
+  thread_id TEXT NOT NULL REFERENCES personal_attention_threads(id) ON DELETE CASCADE,
+  revision INTEGER NOT NULL,
+  kind TEXT NOT NULL CHECK(kind IN ('stop', 'defer', 'adjust', 'rollback')),
+  before_json TEXT NOT NULL CHECK(json_valid(before_json)),
+  after_json TEXT NOT NULL CHECK(json_valid(after_json)),
+  input_json TEXT NOT NULL CHECK(json_valid(input_json)),
+  source_entry_id TEXT REFERENCES transcript_entries(entry_id) ON DELETE SET NULL,
+  feedback_id TEXT REFERENCES personal_feedback(id) ON DELETE SET NULL,
+  restored_version_id TEXT REFERENCES personal_strategy_versions(id),
+  dedupe_key TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  UNIQUE(owner_id, dedupe_key),
+  UNIQUE(thread_id, revision)
+);
+CREATE INDEX personal_strategy_versions_thread ON personal_strategy_versions(thread_id, revision DESC);

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 234;
+export declare const XOPC_DB_SCHEMA_VERSION = 237;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -57,7 +57,7 @@ function applySingleMigration(db, migration, discardOldScenes = false) {
 */
 function applyPendingMigrations(db, options = {}) {
 	db.function("xopc_operation_id", () => currentOperationId() ?? null);
-	const targetVersion = options.targetVersion ?? 234;
+	const targetVersion = options.targetVersion ?? 237;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (!options.migrationsDir && currentVersion < 165) throw new DatabaseSchemaTooOldError(currentVersion, 165);
@@ -95,7 +95,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 234;
+	const appVersion = options.targetVersion ?? 237;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,
@@ -137,7 +137,7 @@ var init_runner = __esmMin((() => {
 	init_errors();
 	log = createLogger("Sqlite:Migrations");
 	XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
-	XOPC_DB_SCHEMA_VERSION = 234;
+	XOPC_DB_SCHEMA_VERSION = 237;
 }));
 //#endregion
 init_runner();

package/dist/src/storage/sqlite/schema.js

@@ -28,7 +28,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 165;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 234,
+		targetVersion: 237,
 		databasePath: fresh ? void 0 : options.databasePath
 	});
 }

package/dist/src/storage/sqlite/session-input-repository.d.ts

@@ -18,6 +18,7 @@ export type SessionInput = {
     conversationId: string;
     clientMessageId: string;
     expectedTranscriptId?: string;
+    interruptRequested?: boolean;
     requestedDelivery: SessionInputDelivery;
     effectiveDelivery: SessionInputDelivery;
     status: SessionInputStatus;
@@ -80,6 +81,7 @@ export declare function insertSessionInput(input: {
     conversationId: string;
     clientMessageId: string;
     expectedTranscriptId?: string;
+    interruptRequested?: boolean;
     requestedDelivery: SessionInputDelivery;
     effectiveDelivery: SessionInputDelivery;
     status: 'queued' | 'injecting';

package/dist/src/storage/sqlite/session-input-repository.js

@@ -9,6 +9,7 @@ function mapInput(row) {
 		conversationId: row.conversation_id,
 		clientMessageId: row.client_message_id,
 		expectedTranscriptId: row.expected_transcript_id ?? void 0,
+		interruptRequested: row.interrupt_requested === 1,
 		requestedDelivery: row.requested_delivery,
 		effectiveDelivery: row.effective_delivery,
 		status: row.status,
@@ -130,8 +131,8 @@ function insertSessionInput(input) {
 		db.prepare(`INSERT INTO session_inputs(id, conversation_id, client_message_id, expected_transcript_id,
       requested_delivery, effective_delivery, status, content, attachments_json,
       context_refs_json, context_snapshots_json, thinking, origin_json, position,
-      target_run_id, version, created_at_ms, updated_at_ms, kind, payload_json, task_run_id)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?)`).run(input.id, input.conversationId, input.clientMessageId, input.expectedTranscriptId ?? null, input.requestedDelivery, input.effectiveDelivery, input.status, input.content, input.attachments ? JSON.stringify(input.attachments) : null, input.contextRefs ? JSON.stringify(input.contextRefs) : null, input.contextSnapshots ? JSON.stringify(input.contextSnapshots) : null, input.thinking ?? null, JSON.stringify(input.origin), max.value + 1, input.targetRunId ?? null, now, now, input.kind ?? "message", input.payload ? JSON.stringify(input.payload) : null, input.taskRunId ?? null);
+      target_run_id, version, created_at_ms, updated_at_ms, kind, payload_json, task_run_id, interrupt_requested)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?)`).run(input.id, input.conversationId, input.clientMessageId, input.expectedTranscriptId ?? null, input.requestedDelivery, input.effectiveDelivery, input.status, input.content, input.attachments ? JSON.stringify(input.attachments) : null, input.contextRefs ? JSON.stringify(input.contextRefs) : null, input.contextSnapshots ? JSON.stringify(input.contextSnapshots) : null, input.thinking ?? null, JSON.stringify(input.origin), max.value + 1, input.targetRunId ?? null, now, now, input.kind ?? "message", input.payload ? JSON.stringify(input.payload) : null, input.taskRunId ?? null, input.interruptRequested ? 1 : 0);
 		bumpSessionInputRevision(db, input.conversationId);
 		return mapInput(db.prepare(`${SELECT_INPUTS} WHERE id = ?`).get(input.id));
 	});
@@ -147,7 +148,7 @@ function claimNextSessionInput(conversationId, runId, expectedInputId) {
       version = version + 1, updated_at_ms = ? WHERE conversation_id = ? AND status = 'queued'
       AND expected_transcript_id IS NOT NULL AND expected_transcript_id IS NOT ?`).run(Date.now(), conversationId, readCurrentTranscriptId(db, conversationId)).changes) bumpSessionInputRevision(db, conversationId);
 		const row = db.prepare(`${SELECT_INPUTS} WHERE conversation_id = ? AND effective_delivery = 'next'
-      AND status = 'queued' ORDER BY position, created_at_ms, id LIMIT 1`).get(conversationId);
+      AND status = 'queued' ORDER BY interrupt_requested DESC, position, created_at_ms, id LIMIT 1`).get(conversationId);
 		if (!row) return void 0;
 		if (expectedInputId && row.id !== expectedInputId) return void 0;
 		const now = Date.now();
@@ -155,7 +156,19 @@ function claimNextSessionInput(conversationId, runId, expectedInputId) {
       updated_at_ms = ? WHERE id = ?`).run(runId, now, row.id);
 		db.prepare(`UPDATE session_input_runtime SET active_run_id = ?, active_input_id = ?,
       revision = revision + 1, updated_at_ms = ? WHERE conversation_id = ?`).run(runId, row.id, now, conversationId);
-		return mapInput(db.prepare(`${SELECT_INPUTS} WHERE id = ?`).get(row.id));
+		const claimed = mapInput(db.prepare(`${SELECT_INPUTS} WHERE id = ?`).get(row.id));
+		const hasMaterial = (value) => Boolean(value.attachments_json && JSON.parse(value.attachments_json).length || value.context_snapshots_json && JSON.parse(value.context_snapshots_json).length);
+		if (row.interrupt_requested && !hasMaterial(row)) {
+			const pending = db.prepare(`${SELECT_INPUTS} WHERE conversation_id = ? AND status = 'queued'
+        ORDER BY interrupt_requested DESC, position, created_at_ms, id LIMIT 10`).all(conversationId);
+			for (const next of pending) {
+				if (!next.interrupt_requested || next.kind !== "message" || hasMaterial(next) || next.thinking !== row.thinking || next.expected_transcript_id !== row.expected_transcript_id || next.origin_json !== row.origin_json || next.created_at_ms - row.created_at_ms > 500 || claimed.content.length + next.content.length > 64e3) break;
+				db.prepare(`UPDATE session_inputs SET status = 'injecting', effective_delivery = 'steer', target_run_id = ?,
+          version = version + 1, updated_at_ms = ? WHERE id = ?`).run(runId, now, next.id);
+				claimed.content += `\n\n${next.content}`;
+			}
+		}
+		return claimed;
 	});
 }
 function finishSessionInputRun(conversationId, runId, status, error) {
@@ -225,7 +238,7 @@ var init_session_input_repository = __esmMin((() => {
 	init_session_instance_repository();
 	init_transaction();
 	init_src();
-	SELECT_INPUTS = `SELECT id, conversation_id, client_message_id, expected_transcript_id, requested_delivery,
+	SELECT_INPUTS = `SELECT interrupt_requested, id, conversation_id, client_message_id, expected_transcript_id, requested_delivery,
   effective_delivery, status, content, attachments_json, context_refs_json, context_snapshots_json,
   thinking, origin_json, position, kind, payload_json, task_run_id,
   target_run_id, run_id, version, error, created_at_ms, updated_at_ms

package/dist/src/tasks/capabilities/read.js

@@ -2,10 +2,10 @@ import { ProductReadContracts } from "../../../packages/gateway-contract/src/cap
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { TaskRepository, init_task_repository } from "../task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../task-run-repository.js";
-import { CapabilityError } from "../../capabilities/runtime/errors.js";
-import { defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
 import { TaskConversationRepository } from "../task-conversation-repository.js";
 import { TaskReadModelProjector } from "../task-read-model-projector.js";
+import { CapabilityError } from "../../capabilities/runtime/errors.js";
+import { defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
 import { TaskContextRepository } from "../task-context-repository.js";
 import { TaskDependencyService } from "../task-dependency-service.js";
 import { TaskCriterionReviewRepository } from "../task-criterion-review-repository.js";

package/dist/src/tasks/execution-context.js

@@ -1,7 +1,7 @@
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
 import { init_sqlite } from "../storage/sqlite/index.js";
-import { TaskConversationRepository } from "./task-conversation-repository.js";
 import { getExecutionEnvironmentForSession } from "../execution-environments/subject.js";
+import { TaskConversationRepository } from "./task-conversation-repository.js";
 //#region src/tasks/execution-context.ts
 init_sqlite();
 const ORIGINS = new Set([

package/dist/src/tasks/home-query-service.js

@@ -69,6 +69,11 @@ function decisionFromTask(model, projectName, locale) {
 	const isChinese = locale?.toLowerCase().startsWith("zh") ?? task.locale === "zh";
 	if (task.phase === "review") return {
 		id: `task:${task.id}:review`,
+		response: {
+			kind: "task",
+			taskId: task.id,
+			canRetry: false
+		},
 		kind: "task",
 		title: task.title,
 		detail: isChinese ? "执行已经完成，正在等待你验收结果。" : "The work is complete and ready for your review.",
@@ -92,6 +97,11 @@ function decisionFromTask(model, projectName, locale) {
 	if (!reason) return null;
 	return {
 		id: `task:${task.id}`,
+		response: {
+			kind: "task",
+			taskId: task.id,
+			canRetry: reason === "retry" && model.allowedCommands.includes("start")
+		},
 		kind: "task",
 		title: task.title,
 		detail: item.summary,
@@ -109,6 +119,7 @@ function homeActionCopy(locale) {
 		approve: "允许并继续",
 		deny: "拒绝",
 		review: "查看并处理",
+		reviewResult: "查看结果并验收",
 		retry: "重试",
 		acknowledge: "暂时忽略",
 		viewProgress: "查看进度",
@@ -124,6 +135,7 @@ function homeActionCopy(locale) {
 		approve: "Allow and continue",
 		deny: "Deny",
 		review: "Review",
+		reviewResult: "Review result",
 		retry: "Retry",
 		acknowledge: "Dismiss",
 		viewProgress: "View progress",
@@ -186,7 +198,21 @@ function buildHomeWorkbench(input) {
 			dueAt: decision.dueAt,
 			updatedAt: decision.updatedAt,
 			openAction,
-			...connectorActions
+			...decision.response?.kind === "task" && decision.reason === "decision_needed" ? {
+				primaryAction: {
+					type: "task_review",
+					label: copy.reviewResult,
+					taskId: decision.response.taskId
+				},
+				secondaryActions: [openAction]
+			} : decision.response?.kind === "task" && decision.response.canRetry ? {
+				primaryAction: {
+					type: "retry_task",
+					label: copy.retry,
+					taskId: decision.response.taskId
+				},
+				secondaryActions: [openAction]
+			} : connectorActions
 		};
 	});
 	const failures = input.attention.map((item) => ({

package/dist/src/tasks/task-main-update-decision-service.js

@@ -1,9 +1,9 @@
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
-import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
 import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 //#region src/tasks/task-main-update-decision-service.ts
 init_providers();

package/dist/src/tasks/task-result-delivery-service.js

@@ -7,11 +7,11 @@ import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
 import { init_request_repository, personalRequestForTask } from "../personal-agent/request-repository.js";
 import { appendTranscriptEntry, init_transcript_repository } from "../storage/sqlite/transcript-repository.js";
+import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
 import { tryParseMediaUri } from "../media/uri.js";
 import { resolveMediaBufferPath } from "../media/store.js";
 import { emitSessionTranscriptUpdate } from "../session/transcript-events.js";
-import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
 import { TaskResultDeliveryRepository } from "./task-result-delivery-repository.js";
 import { enqueuePersonalReply } from "../personal-agent/reply-composer.js";
 import { lstat } from "node:fs/promises";

package/dist/src/tui/backends/embedded-backend.js

@@ -10,7 +10,6 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { normalizeAgentId } from "../../agent-catalog/id.js";
 import { init_agent_scope, listAgentEntries } from "../../agent/agent-scope.js";
-import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { init_paths } from "../../config/paths.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../../routing/agent-session-key.js";
@@ -23,6 +22,7 @@ import { buildSessionTimeline } from "../../session/transcript-outline.js";
 import { transcriptRowsToClientHistory } from "../../session/client-history.js";
 import { createCreateShareTool, isShareToolAvailable } from "../../agent/tools/create-share-tool.js";
 import { evictEmbeddedSessionRunner } from "../../agent/embedded/session-runner.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { SessionIndex } from "../../session/manager.js";
 import "../../session/index.js";
 import { parseModelRef } from "../../agent/models/selection.js";