@xopcai/xopc 0.0.344 → 0.0.346

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

@@ -2,6 +2,7 @@ import { init_transaction, runSqliteWriteTransaction } from "../../../storage/sq
 import { TaskCommandRequestSchema, TaskCreateRequestSchema, TaskHandoffRequestSchema } from "../../../../packages/gateway-contract/src/tasks.js";
 import { ProductReadContracts, TaskRunCancelOutputSchema, TaskRunFeedbackOutputSchema } from "../../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
+import { hasGatewayScope, init_gateway_scopes } from "../../security/gateway-scopes.js";
 import { enqueueTaskChangedEvent, init_task_change_events } from "../../../tasks/task-change-events.js";
 import { TaskRepository, init_task_repository } from "../../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../../tasks/task-run-repository.js";
@@ -10,14 +11,17 @@ import "../../../capabilities/runtime/dispatcher.js";
 import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { TaskContextMutationOutputSchema } from "../../../tasks/capabilities/relations.js";
 import { TaskDeleteOutputSchema } from "../../../tasks/capabilities/management.js";
+import { TaskCollaborationRepository } from "../../../tasks/task-collaboration-repository.js";
 import { TaskMutationOutputSchema } from "../../../tasks/capabilities/write.js";
 import { createProductDispatcher } from "../../../capabilities/runtime/product.js";
 import { ProjectOperatingViewService } from "../../../tasks/project-operating-view-service.js";
 import { TaskHandoffService } from "../../../tasks/task-handoff-service.js";
+import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 import { submitSessionInput } from "./session-input-handler.js";
 import { patchChatModelConfig } from "./chat-model-config.js";
 import { capabilityHttpContext, capabilityHttpError } from "../../../capabilities/adapters/http.js";
 import { TaskConversationQueryService } from "../../service/task-conversation-query-service.js";
+import { getTaskOrchestrationMetrics } from "../../../tasks/task-orchestration-metrics.js";
 import { randomUUID } from "node:crypto";
 //#region src/gateway/hono/routes/tasks.ts
 init_src();
@@ -25,6 +29,7 @@ init_transaction();
 init_task_change_events();
 init_task_repository();
 init_task_run_repository();
+init_gateway_scopes();
 function registerTaskRoutes(authenticated, deps) {
 	const capabilities = createProductDispatcher(() => deps.service.notesServiceInstance, {
 		getConfig: () => deps.service.currentConfig,
@@ -47,6 +52,7 @@ function registerTaskRoutes(authenticated, deps) {
 	const tasks = new TaskRepository();
 	const runs = new TaskRunRepository();
 	const conversations = new TaskConversationRepository();
+	const collaboration = new TaskCollaborationRepository();
 	const conversationQuery = new TaskConversationQueryService(deps.service.sessions);
 	const handoffs = new TaskHandoffService({
 		sessionIndex: deps.service.sessionIndexInstance,
@@ -102,6 +108,21 @@ function registerTaskRoutes(authenticated, deps) {
 			return capabilityHttpError(c, error);
 		}
 	});
+	authenticated.get("/api/tasks/orchestration-metrics", async (c) => {
+		if (!hasGatewayScope(getGatewayPrincipal(c).scopes, "tasks.read")) return c.json({
+			ok: false,
+			error: "Forbidden"
+		}, 403);
+		const since = c.req.query("since") === void 0 ? void 0 : Number(c.req.query("since"));
+		if (since !== void 0 && (!Number.isInteger(since) || since < 0)) return c.json({
+			ok: false,
+			error: "Invalid since timestamp"
+		}, 400);
+		return c.json({
+			ok: true,
+			metrics: getTaskOrchestrationMetrics(since)
+		});
+	});
 	authenticated.get("/api/tasks/:id", async (c) => {
 		try {
 			return c.json(await capabilities.call("xopc.tasks.get", { id: c.req.param("id") }, capabilityHttpContext(c)));
@@ -109,6 +130,78 @@ function registerTaskRoutes(authenticated, deps) {
 			return capabilityHttpError(c, error);
 		}
 	});
+	authenticated.get("/api/tasks/:id/collaboration", async (c) => {
+		if (!hasGatewayScope(getGatewayPrincipal(c).scopes, "tasks.read")) return c.json({
+			ok: false,
+			error: "Forbidden"
+		}, 403);
+		const taskId = c.req.param("id");
+		if (!tasks.get(taskId)) return c.json({
+			ok: false,
+			error: "Task not found"
+		}, 404);
+		const afterSequence = Number(c.req.query("afterSequence") ?? 0);
+		const beforeSequence = c.req.query("beforeSequence") === void 0 ? void 0 : Number(c.req.query("beforeSequence"));
+		const limit = Number(c.req.query("limit") ?? 50);
+		if (!Number.isInteger(afterSequence) || afterSequence < 0 || !Number.isInteger(limit) || limit < 1 || beforeSequence !== void 0 && (!Number.isInteger(beforeSequence) || beforeSequence < 1)) return c.json({
+			ok: false,
+			error: "Invalid cursor or limit"
+		}, 400);
+		return c.json({
+			ok: true,
+			items: c.req.query("recent") === "1" ? collaboration.recent(taskId, beforeSequence, limit) : collaboration.list(taskId, afterSequence, limit)
+		});
+	});
+	authenticated.post("/api/tasks/:id/collaboration", taskRateLimit, async (c) => {
+		const principal = getGatewayPrincipal(c);
+		if (!hasGatewayScope(principal.scopes, "tasks.write")) return c.json({
+			ok: false,
+			error: "Forbidden"
+		}, 403);
+		const body = await c.req.json().catch(() => null);
+		const kind = body?.kind;
+		const content = body?.body;
+		if (kind !== "instruction" && kind !== "question" && kind !== "answer" || typeof content !== "string" || !content.trim() || content.length > 8e3) return c.json({
+			ok: false,
+			error: "Invalid collaboration message"
+		}, 400);
+		const causationId = typeof body?.causationId === "string" ? body.causationId : void 0;
+		if (kind === "answer" && (!causationId || collaboration.get(causationId)?.taskId !== c.req.param("id") || collaboration.get(causationId)?.kind !== "question")) return c.json({
+			ok: false,
+			error: "Answer must reference a question on this Task"
+		}, 400);
+		try {
+			const task = tasks.get(c.req.param("id"));
+			if (!task) return c.json({
+				ok: false,
+				error: "Task not found"
+			}, 404);
+			if (task.phase === "closed") return c.json({
+				ok: false,
+				error: "Task is closed"
+			}, 409);
+			const entry = collaboration.append({
+				taskId: c.req.param("id"),
+				authorKind: "user",
+				authorId: principal.principalId,
+				kind,
+				body: content,
+				...causationId ? { causationId } : {},
+				idempotencyKey: c.req.header("idempotency-key") ?? randomUUID(),
+				deliverToWorker: true
+			});
+			deps.service.dispatchTaskRuns();
+			return c.json({
+				ok: true,
+				entry
+			}, 201);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			}, 409);
+		}
+	});
 	authenticated.post("/api/tasks/:id/conversation", taskRateLimit, async (c) => {
 		try {
 			const result = await deps.service.ensureTaskConversation(c.req.param("id"));

package/dist/src/gateway/service/active-execution.js

@@ -1,7 +1,7 @@
 //#region src/gateway/service/active-execution.ts
 function describeActiveExecution(input) {
 	const { origin } = input;
-	const background = origin.type === "system" && (origin.source === "automation" || origin.source === "heartbeat" || origin.source === "internal");
+	const background = origin.type === "system" && (origin.source === "automation" || origin.source === "heartbeat" || origin.source === "internal" || origin.source === "task_update");
 	const kind = input.kind ?? (origin.type === "system" && origin.source === "automation" ? "automation" : origin.type === "system" && origin.source === "workflow" ? "workflow" : input.taskRunId ? "task" : "chat");
 	return {
 		conversationId: input.conversationId,

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

@@ -1,6 +1,7 @@
 import { inboundCorrelationMetadataFromAsyncLogContext, updateAsyncLogContext } from "../../utils/logger/context.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { init_session_input_repository, listTaskUpdateTriggers } from "../../storage/sqlite/session-input-repository.js";
 import { init_clarification_wait_repository, isClarificationSuspended } from "../../storage/sqlite/clarification-wait-repository.js";
 import { updateInteractionStateFromMessage } from "../../storage/sqlite/interaction-state-repository.js";
 import { getConnectionResumeInput, init_connection_wait_repository, isConnectionSuspended } from "../../storage/sqlite/connection-wait-repository.js";
@@ -25,6 +26,7 @@ init_clarification_wait_repository();
 init_logger();
 init_session_key();
 init_sqlite();
+init_session_input_repository();
 const log = createLogger("Gateway:Service");
 /**
 * @param runOptions.signal — When set (e.g. client disconnect), aborts in-flight generation and persists partial output.
@@ -85,7 +87,9 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 	const mapper = new ChatStreamMapper({
 		runId,
 		conversationId: streamConversationId,
-		channel
+		channel,
+		startsNewBubble: origin.type === "system" && origin.source === "task_update",
+		...origin.type === "system" && origin.source === "task_update" && webchatConversationId ? { taskTrigger: listTaskUpdateTriggers(webchatConversationId).get(runId) } : {}
 	});
 	let registeredActiveWebchatRun = false;
 	const captureTaskEvent = (event) => {

package/dist/src/gateway/service/session-input-coordinator.d.ts

@@ -61,7 +61,7 @@ export declare class SessionInputCoordinator {
             channel: string;
         } | {
             type: "system";
-            source: "automation" | "cli" | "workflow" | "heartbeat" | "internal";
+            source: "automation" | "cli" | "workflow" | "heartbeat" | "internal" | "task_update";
         };
     }>;
     dispatchAcceptedInput(conversationId: string, inputId: string): Promise<void>;

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

@@ -126,6 +126,7 @@ export declare class GatewayService {
     private createTaskRunDispatcher;
     private createNotificationService;
     private readonly taskRunDispatch;
+    private readonly taskMainUpdateDispatch;
     dispatchTaskRuns(): void;
     ensureTaskConversation(taskId: string, options?: {
         runId?: string;
@@ -164,7 +165,7 @@ export declare class GatewayService {
             channel: string;
         } | {
             type: "system";
-            source: "automation" | "cli" | "workflow" | "heartbeat" | "internal";
+            source: "automation" | "cli" | "workflow" | "heartbeat" | "internal" | "task_update";
         };
     }>;
     drainSessionInputs(conversationId: string): Promise<void>;

package/dist/src/gateway/service.js

@@ -10,6 +10,7 @@ import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transacti
 import { getBrowserTabBindingById, init_browser_tab_binding_repository } from "../storage/sqlite/browser-tab-binding-repository.js";
 import { findSessionInput, init_session_input_repository, insertSessionInput } from "../storage/sqlite/session-input-repository.js";
 import { TaskRepository } from "../tasks/task-repository.js";
+import { TaskRunRepository, init_task_run_repository } from "../tasks/task-run-repository.js";
 import { init_changes, notifyUserContextChange } from "../user-context/changes.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_session_repository, listSessionMetadata, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
@@ -87,10 +88,6 @@ import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
-import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
-import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
-import { HomeIntelligenceHost } from "../home-intelligence/host.js";
-import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
 import { stopTailscaleExposure } from "./tailscale-lifecycle.js";
@@ -146,8 +143,16 @@ import { reconcileMemoryMaintenanceAutomations } from "./memory-maintenance-auto
 import { GatewayReadiness } from "./startup-readiness.js";
 import { createGatewayStartupTrace } from "./startup-trace.js";
 import { GatewaySceneHost } from "./scenes/host.js";
+import { TaskCollaborationDelivery } from "../tasks/task-collaboration-delivery.js";
+import { TaskMainUpdateDelivery } from "../tasks/task-main-update-delivery.js";
+import { TaskMainUpdateDecisionService } from "../tasks/task-main-update-decision-service.js";
+import { selectTaskMainUpdateAttempt, submitAndConfirmTaskMainUpdate } from "../tasks/task-main-update-input.js";
 import { checkAppContextAccess, prepareAppContext } from "./service/app-context-access.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.js";
+import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
+import { HomeIntelligenceHost } from "../home-intelligence/host.js";
+import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
+import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
 import crypto from "node:crypto";
 //#region src/gateway/service.ts
 init_session_repository();
@@ -163,6 +168,7 @@ init_logger();
 init_log_stream();
 init_paths();
 init_package_version();
+init_task_run_repository();
 init_resolve_route();
 init_session_key();
 init_sqlite();
@@ -763,7 +769,7 @@ var GatewayService = class {
 					this.ensureAgentService();
 					return;
 				}
-				const clientMessageId = `task:${runId}`;
+				const clientMessageId = new TaskRunRepository().nextAgentInputClientMessageId(runId);
 				const session = await this.sessionIndex.getSessionMetadata(conversationId);
 				if (!session) throw new Error("Task session is unavailable");
 				insertSessionInput({
@@ -804,6 +810,19 @@ var GatewayService = class {
 		this.projects.flushCommittedEffects();
 		this._workDiscovery?.dispatchProjectUnderstanding();
 		this.dispatchTaskEvents();
+		await new TaskCollaborationDelivery().drain(async (input) => {
+			const state = this.agentRunner.inputs.snapshot(input.conversationId);
+			return (await this.agentRunner.submitSessionInput({
+				conversationId: input.conversationId,
+				clientMessageId: input.clientMessageId,
+				delivery: state.activeRunId ? "steer" : "next",
+				content: input.content,
+				origin: {
+					type: "system",
+					source: "workflow"
+				}
+			})).ok;
+		});
 		this.createTaskRunDispatcher().dispatch();
 		await this.createWorkflowRunService().dispatchTaskRuns();
 	}, (err) => {
@@ -814,8 +833,53 @@ var GatewayService = class {
 			phase: "task_run_dispatch"
 		}, `Task dispatch failed: ${errorMessage}`);
 	});
+	taskMainUpdateDispatch = createBackgroundTask(async () => {
+		await new TaskMainUpdateDelivery().drain({
+			isAvailable: (conversationId) => {
+				const state = this.agentRunner.inputs.snapshot(conversationId);
+				return !state.activeRunId && state.inputs.every((item) => item.status === "interrupted") && (!this.voiceRealtime.hasConversation(conversationId) || this.voiceRealtime.canOfferTaskUpdate(conversationId));
+			},
+			decide: (input) => new TaskMainUpdateDecisionService({
+				getModelRef: (conversationId) => this.ensureAgentService().getModelForSession(conversationId),
+				loadHistory: (conversationId) => this.sessionIndex.loadMessages(conversationId)
+			}).decide(input),
+			submitAndConfirm: (input) => {
+				if (this.voiceRealtime.hasConversation(input.conversationId)) {
+					const attempt = selectTaskMainUpdateAttempt(input.conversationId, input.clientMessageId, findSessionInput);
+					if (attempt.kind === "completed") return Promise.resolve(true);
+					if (attempt.kind !== "new" || !attempt.clientMessageId) return Promise.resolve(false);
+					return this.voiceRealtime.offerTaskUpdate({
+						...input,
+						clientMessageId: attempt.clientMessageId
+					});
+				}
+				return submitAndConfirmTaskMainUpdate(input, {
+					findInput: findSessionInput,
+					submit: async (message) => {
+						return (await this.agentRunner.submitSessionInput({
+							...message,
+							delivery: "next",
+							origin: {
+								type: "system",
+								source: "task_update"
+							}
+						})).ok;
+					},
+					waitForCompletion: (conversationId, clientMessageId) => this.agentRunner.inputs.waitForCompletion(conversationId, clientMessageId)
+				});
+			}
+		});
+	}, (err) => {
+		const errorMessage = err instanceof Error ? err.message : String(err);
+		log.error({
+			err,
+			errorMessage,
+			phase: "task_main_update_dispatch"
+		}, `Main Agent update dispatch failed: ${errorMessage}`);
+	});
 	dispatchTaskRuns() {
 		this.taskRunDispatch();
+		this.taskMainUpdateDispatch();
 	}
 	async ensureTaskConversation(taskId, options = {}) {
 		const task = new TaskRepository().require(taskId);
@@ -1864,7 +1928,7 @@ var GatewayService = class {
 			});
 		}
 		if (event.type.startsWith("task.")) this.emit(event.type, event.payload);
-		if (this.config.userContext.homeIntelligence.refreshOnContextChange && (event.type.startsWith("task.") || event.type.startsWith("project."))) {
+		if (this.config.userContext.homeIntelligence.refreshOnContextChange && (event.type.startsWith("task.") && event.type !== "task.collaboration_entry_added" || event.type.startsWith("project."))) {
 			const payload = event.payload;
 			const objectId = event.type.startsWith("task.") ? payload.taskId : payload.projectId;
 			const revision = payload.version ?? payload.revision ?? "unknown";

package/dist/src/gateway/session-context-summary.js

@@ -11,6 +11,8 @@ import { getExecutionEnvironmentForSession } from "../execution-environments/sub
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { ProjectStore } from "../projects/project-store.js";
 import { runExec } from "../infra/exec.js";
+import { TaskCollaborationRepository } from "../tasks/task-collaboration-repository.js";
+import { TaskOriginRepository } from "../tasks/task-origin-repository.js";
 import { isSessionSourceBinding } from "../agent/source-context/types.js";
 import { realpath, stat } from "node:fs/promises";
 //#region src/gateway/session-context-summary.ts
@@ -106,6 +108,21 @@ async function getSessionContextSummary(config, conversationId, scopes) {
 			phase: task.phase
 		};
 		else if (taskId) unavailable("work");
+		const delegated = new TaskOriginRepository().list(conversationId, 20);
+		const board = new TaskCollaborationRepository();
+		summary.work.delegatedTasks = delegated.items.map((item) => {
+			const latest = board.latest(item.id);
+			return {
+				...item,
+				title: item.title.slice(0, 240),
+				...latest ? { latestUpdate: {
+					kind: latest.kind,
+					body: latest.body.slice(0, 400),
+					createdAt: latest.createdAt
+				} } : {}
+			};
+		});
+		summary.work.delegatedTaskCount = delegated.total;
 	} catch (err) {
 		unavailable("work", err);
 	}

package/dist/src/home-intelligence/host.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { HomeAdviceBudgetExceededError } from "./generator.js";
 import { homePatternKey } from "./strategy.js";
+import { HomeAdvicePolicy } from "./policy.js";
 import { HomeIntelligenceRepository } from "./repository.js";
 import { HomeOpportunityApplicationService } from "./application-service.js";
-import { HomeAdvicePolicy } from "./policy.js";
-import { HomeAdviceBudgetExceededError } from "./generator.js";
 import { buildHomeOpportunityNotification } from "./notification.js";
 import { createHash } from "node:crypto";
 //#region src/home-intelligence/host.ts

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

@@ -1,12 +1,16 @@
 import { type TurnOutcome, type UserTurnDocument } from '@xopcai/gateway-contract';
 import type { Message } from './types.js';
+import type { TaskUpdateTrigger } from '../storage/sqlite/session-input-repository.js';
 import type { TranscriptStoredRow } from './session-context-for-llm.js';
 /** Transcript row for TUI and HTTP clients (flattened from persisted session messages). */
 export interface ClientHistoryMessage {
     id?: string;
     turnId?: string;
-    role: 'user' | 'assistant' | 'system';
+    /** A background Agent turn starts a new visible assistant bubble without a visible user row. */
+    startsNewBubble?: boolean;
+    role: 'user' | 'assistant' | 'system' | 'task';
     content: string;
+    taskTrigger?: TaskUpdateTrigger;
     displayIndex?: number;
     rawContent?: string | unknown[];
     /** Persisted inbound attachment metadata used by chat clients to reload media. */
@@ -81,4 +85,6 @@ export declare function transcriptRowsToClientHistory(rows: TranscriptStoredRow[
     startRowNumber?: number;
     endRowNumber?: number;
     rowNumberOffset?: number;
+    startsNewBubbleTurnIds?: ReadonlySet<string>;
+    taskUpdateTriggers?: ReadonlyMap<string, TaskUpdateTrigger>;
 }): ClientHistoryMessage[];

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

@@ -5,6 +5,24 @@ import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 import { buildTranscriptOutline } from "./transcript-outline.js";
 //#region src/session/client-history.ts
 init_src();
+function taskTriggerFromMetadata(metadata) {
+	if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) return void 0;
+	const value = metadata.taskTrigger;
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const trigger = value;
+	if (typeof trigger.entryId !== "string" || typeof trigger.taskId !== "string" || typeof trigger.taskTitle !== "string" || !trigger.taskTitle.trim() || ![
+		"progress",
+		"question",
+		"result",
+		"failure"
+	].includes(String(trigger.kind))) return void 0;
+	return {
+		entryId: trigger.entryId,
+		taskId: trigger.taskId,
+		taskTitle: trigger.taskTitle,
+		kind: trigger.kind
+	};
+}
 function sourceContextDisplayMetadata(metadata) {
 	if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) return void 0;
 	const record = metadata;
@@ -143,9 +161,23 @@ function messagesToClientHistory(messages, opts) {
 	const slice = opts?.limit !== void 0 && messages.length > opts.limit ? messages.slice(-opts.limit) : messages;
 	const results = collectToolResults(slice);
 	const out = [];
+	const hiddenTurnIds = new Set(slice.flatMap((message) => message.metadata?.hiddenFromClient === true && typeof message.turnId === "string" ? [message.turnId] : []));
+	const assistantTurnIds = new Set(slice.filter((message) => message.role === "assistant").map((message) => message.turnId).filter((turnId) => Boolean(turnId)));
 	for (const m of slice) {
 		if (m.role === "tool" || m.role === "toolResult") continue;
 		if (m.role === "user" || m.role === "system") {
+			if (m.metadata?.hiddenFromClient === true) {
+				const turnId = m.turnId;
+				const trigger = turnId && assistantTurnIds.has(turnId) ? taskTriggerFromMetadata(m.metadata) : void 0;
+				if (trigger) out.push({
+					role: "task",
+					turnId,
+					content: "",
+					taskTrigger: trigger,
+					timestamp: parseTimestamp(m.timestamp)
+				});
+				continue;
+			}
 			const text = flattenMessageContent(m.content);
 			out.push({
 				role: m.role,
@@ -163,6 +195,7 @@ function messagesToClientHistory(messages, opts) {
 			out.push({
 				role: "assistant",
 				...typeof m.turnId === "string" ? { turnId: m.turnId } : {},
+				...typeof m.turnId === "string" && hiddenTurnIds.has(m.turnId) ? { startsNewBubble: true } : {},
 				content: text,
 				timestamp: parseTimestamp(m.timestamp),
 				toolCalls
@@ -368,7 +401,9 @@ function transcriptRowsToClientHistory(rows, opts) {
 	const startIndex = hasRowWindow ? Math.max(0, Math.trunc(opts?.startRowNumber ?? 1) - 1) : opts?.limit !== void 0 && rows.length > opts.limit ? rows.length - opts.limit : 0;
 	const endIndex = hasRowWindow ? Math.max(startIndex, Math.min(rows.length, Math.trunc(opts?.endRowNumber ?? rows.length))) : rows.length;
 	const slice = hasRowWindow ? rows.slice(startIndex, endIndex) : opts?.limit !== void 0 && rows.length > opts.limit ? rows.slice(-opts.limit) : rows;
-	const results = collectHistoryToolResults(slice.map(asHistoryMessageRow).filter((row) => row !== null));
+	const messages = slice.map(asHistoryMessageRow).filter((row) => row !== null);
+	const results = collectHistoryToolResults(messages);
+	const assistantTurnIds = new Set(messages.filter((message) => message.role === "assistant").map((message) => message.turnId).filter((turnId) => Boolean(turnId)));
 	const out = [];
 	const reviewTraceToolById = /* @__PURE__ */ new Map();
 	for (const [offset, row] of slice.entries()) {
@@ -472,6 +507,20 @@ function transcriptRowsToClientHistory(rows, opts) {
 		if (!messageRow) continue;
 		if (messageRow.role === "tool" || messageRow.role === "toolResult") continue;
 		if (messageRow.role === "user" || messageRow.role === "system") {
+			if (messageRow.metadata?.hiddenFromClient === true) {
+				const trigger = messageRow.turnId && assistantTurnIds.has(messageRow.turnId) ? taskTriggerFromMetadata(messageRow.metadata) ?? opts?.taskUpdateTriggers?.get(messageRow.turnId) : void 0;
+				if (trigger) out.push({
+					id,
+					turnId: messageRow.turnId,
+					role: "task",
+					kind: "message",
+					content: "",
+					taskTrigger: trigger,
+					timestamp: parseTimestampValue(messageRow.timestamp),
+					...displayIndex !== void 0 ? { displayIndex } : {}
+				});
+				continue;
+			}
 			out.push({
 				id,
 				...messageRow.turnId ? { turnId: messageRow.turnId } : {},
@@ -489,6 +538,7 @@ function transcriptRowsToClientHistory(rows, opts) {
 		out.push({
 			id,
 			...messageRow.turnId ? { turnId: messageRow.turnId } : {},
+			...messageRow.turnId && opts?.startsNewBubbleTurnIds?.has(messageRow.turnId) ? { startsNewBubble: true } : {},
 			role: "assistant",
 			kind: "message",
 			content: flattenMessageContent(messageRow.content ?? ""),

package/dist/src/session/store.js

@@ -3,6 +3,7 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { listTaskUpdateRunIds, listTaskUpdateTriggers } from "../storage/sqlite/session-input-repository.js";
 import { buildSessionContextForLlm, buildSessionDisplayMessages, init_session_context_for_llm, isRuntimeOnlyTranscriptMessage, isTranscriptCompactionEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import "./types.js";
 import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.js";
@@ -192,7 +193,11 @@ var SessionStore = class {
 			});
 			const endIndex = hasBeforeCursor ? Math.min(page.total, Math.max(0, parsedBefore)) : Math.max(0, page.total - offset);
 			const startIndex = Math.max(0, endIndex - page.rows.length);
-			const history = transcriptRowsToClientHistory(page.rows, { rowNumberOffset: startIndex });
+			const history = transcriptRowsToClientHistory(page.rows, {
+				rowNumberOffset: startIndex,
+				startsNewBubbleTurnIds: listTaskUpdateRunIds(key),
+				taskUpdateTriggers: listTaskUpdateTriggers(key)
+			});
 			const messages = options.compact ? compactHistory(history) : history;
 			const session = {
 				...metadata,
@@ -632,7 +637,10 @@ var SessionStore = class {
 	}
 	async findInSession(key, query, limit) {
 		if (!await this.getMetadata(key)) return null;
-		return findSessionMessages(transcriptRowsToClientHistory(await this.loadTranscriptRows(key)), query, limit);
+		return findSessionMessages(transcriptRowsToClientHistory(await this.loadTranscriptRows(key), {
+			startsNewBubbleTurnIds: listTaskUpdateRunIds(key),
+			taskUpdateTriggers: listTaskUpdateTriggers(key)
+		}), query, limit);
 	}
 	recallSession(key, query, options) {
 		requireXopcDatabase();

package/dist/src/session/types.d.ts

@@ -142,6 +142,7 @@ export interface SessionDetail extends SessionMetadata {
 }
 /** Session list query parameters */
 export interface SessionListQuery extends SessionDiscoveryQuery {
+    rootConversationsOnly?: boolean;
     status?: SessionStatus | SessionStatus[];
     /** Single `sourceChannel`, or comma-separated list (e.g. `telegram,weixin`). */
     channel?: string;

package/dist/src/storage/sqlite/index.d.ts

@@ -14,7 +14,7 @@ export { claimContextExtractionRun, finishContextExtractionRun, getContextExtrac
 export { createCollaborationRule, getCollaborationRule, listCollaborationRules, setCollaborationRuleStatus, type CollaborationRule, } from './collaboration-rule-repository.js';
 export { createContextEvidence, type ContextEvidence } from './context-evidence-repository.js';
 export { getUserPerson, getUserPeopleIndexState, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson, } from './user-people-repository.js';
-export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, getSessionInputById, insertSessionInput, listActiveSessionInputExecutions, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus, type SessionInput, type SessionInputDelivery, type SessionInputPayload, type SessionInputState, type SessionInputStatus, } from './session-input-repository.js';
+export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, getSessionInputById, insertSessionInput, listActiveSessionInputExecutions, listActiveSessionInputRuns, listTaskUpdateRunIds, listTaskUpdateTriggers, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus, type SessionInput, type SessionInputDelivery, type SessionInputPayload, type SessionInputState, type TaskUpdateTrigger, type SessionInputStatus, } from './session-input-repository.js';
 export { consumeClarificationApproval, consumeClarificationResume, createClarificationWait, getActiveClarification, getClarification, getClarificationResumeInput, getClarificationSnapshot, isClarificationSuspended, resolveClarification, supersedeActiveClarification, type CreateClarificationInput, type ResolveClarificationInput, type ResolveClarificationResult, } from './clarification-wait-repository.js';
 export { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget, type ReplaceLatestSessionTurnInput, type ReplaceLatestSessionTurnResult, } from './session-turn-replace-repository.js';
 export { acknowledgeHomeAttention, isHomeAttentionAcknowledged, type HomeAttentionSubjectKind, } from './home-attention-repository.js';

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

@@ -17,7 +17,7 @@ import { claimContextExtractionRun, finishContextExtractionRun, getContextExtrac
 import { createCollaborationRule, getCollaborationRule, init_collaboration_rule_repository, listCollaborationRules, setCollaborationRuleStatus } from "./collaboration-rule-repository.js";
 import { createContextEvidence, init_context_evidence_repository } from "./context-evidence-repository.js";
 import { getUserPeopleIndexState, getUserPerson, init_user_people_repository, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson } from "./user-people-repository.js";
-import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, init_session_input_repository, insertSessionInput, listActiveSessionInputExecutions, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
+import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, init_session_input_repository, insertSessionInput, listActiveSessionInputExecutions, listActiveSessionInputRuns, listTaskUpdateRunIds, listTaskUpdateTriggers, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
 import { consumeClarificationApproval, consumeClarificationResume, createClarificationWait, getActiveClarification, getClarification, getClarificationResumeInput, getClarificationSnapshot, init_clarification_wait_repository, isClarificationSuspended, resolveClarification, supersedeActiveClarification } from "./clarification-wait-repository.js";
 import { buildDefaultSessionMetadata, init_session_metadata } from "./session-metadata.js";
 import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, init_row_mappers, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow } from "./row-mappers.js";
@@ -87,4 +87,4 @@ var init_sqlite = __esmMin((() => {
 }));
 //#endregion
 init_sqlite();
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, SCHEMA_META_SCHEMA_VERSION_KEY, SidebarLayoutConflictError, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, applyPendingMigrations, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeClarificationApproval, consumeClarificationResume, consumeConnectorApproval, countKnowledgeSourceItems, createClarificationWait, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, decideConnectorApproval, deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrowserTabBindingsByPrincipal, deleteConnectorConnection, deleteConnectorInstallation, deleteEndpointSessionBinding, deleteEndpointSessionBindingsByPrincipal, deleteKnowledgeSourceItems, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findConversationIdByTranscriptId, findLatestAssistantTranscriptEntryId, findSessionInput, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActiveClarification, getActivityEventRecord, getBrowserTabBinding, getBrowserTabBindingById, getCachedConnectorCatalogEntry, getClarification, getClarificationResumeInput, getClarificationSnapshot, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextExtractionRun, getCurrentTranscriptId, getDevice, getEndpointPrincipal, getEndpointSessionBinding, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionTaskPlan, getSidebarLayout, getSqliteDatabase, getUserPeopleIndexState, getUserPerson, getUserTrustPolicy, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, init_sqlite, insertSessionInput, inspectSchemaMigrationStatus, isClarificationSuspended, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isXopcDatabaseOpen, issueDeviceTokenPair, listActiveSessionInputExecutions, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextExtractionOutputs, listContextExtractionRuns, listDevices, listEndpointPrincipals, listEndpointToolInvocationAuditPage, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceSidebarLayout, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveClarification, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setBrowserTabBinding, setCollaborationRuleStatus, setConnectorLearningPaused, setEndpointSessionBinding, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUserTrustPolicy, signGatewayPayload, sortBySidebarLayout, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeUserPeople, supersedeActiveClarification, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateSessionConfig, updateSessionStats, updateUserPerson, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, SCHEMA_META_SCHEMA_VERSION_KEY, SidebarLayoutConflictError, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, applyPendingMigrations, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeClarificationApproval, consumeClarificationResume, consumeConnectorApproval, countKnowledgeSourceItems, createClarificationWait, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, decideConnectorApproval, deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrowserTabBindingsByPrincipal, deleteConnectorConnection, deleteConnectorInstallation, deleteEndpointSessionBinding, deleteEndpointSessionBindingsByPrincipal, deleteKnowledgeSourceItems, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findConversationIdByTranscriptId, findLatestAssistantTranscriptEntryId, findSessionInput, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActiveClarification, getActivityEventRecord, getBrowserTabBinding, getBrowserTabBindingById, getCachedConnectorCatalogEntry, getClarification, getClarificationResumeInput, getClarificationSnapshot, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextExtractionRun, getCurrentTranscriptId, getDevice, getEndpointPrincipal, getEndpointSessionBinding, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionTaskPlan, getSidebarLayout, getSqliteDatabase, getUserPeopleIndexState, getUserPerson, getUserTrustPolicy, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, init_sqlite, insertSessionInput, inspectSchemaMigrationStatus, isClarificationSuspended, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isXopcDatabaseOpen, issueDeviceTokenPair, listActiveSessionInputExecutions, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextExtractionOutputs, listContextExtractionRuns, listDevices, listEndpointPrincipals, listEndpointToolInvocationAuditPage, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTaskUpdateRunIds, listTaskUpdateTriggers, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceSidebarLayout, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveClarification, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setBrowserTabBinding, setCollaborationRuleStatus, setConnectorLearningPaused, setEndpointSessionBinding, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUserTrustPolicy, signGatewayPayload, sortBySidebarLayout, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeUserPeople, supersedeActiveClarification, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateSessionConfig, updateSessionStats, updateUserPerson, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };

package/dist/src/storage/sqlite/migrations/224_task_origin_links.sql

@@ -0,0 +1,8 @@
+CREATE TABLE IF NOT EXISTS task_origin_links (
+  task_id TEXT PRIMARY KEY REFERENCES tasks(task_id) ON DELETE CASCADE,
+  conversation_id TEXT NOT NULL REFERENCES sessions(conversation_id) ON DELETE CASCADE,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_task_origin_links_conversation
+  ON task_origin_links(conversation_id, created_at DESC);