@xopcai/xopc 0.0.432 → 0.0.434

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

@@ -1,6 +1,7 @@
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { sessionCommandIdentity } from "../../../packages/gateway-contract/src/session-input-command.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { authorizeSessionInput, init_session_input_control_repository } from "./session-input-control-repository.js";
 import { init_session_input_repository, insertSessionInput } from "./session-input-repository.js";
 import { cancelConnectionObjective, init_connection_wait_repository } from "./connection-wait-repository.js";
 import { getSessionMetadata } from "./session-read-repository.js";
@@ -13,6 +14,7 @@ import { createHash, randomUUID } from "node:crypto";
 init_src();
 init_conversation_repository();
 init_session_repository();
+init_session_input_control_repository();
 init_session_input_repository();
 init_connection_wait_repository();
 init_transaction();
@@ -103,6 +105,7 @@ function acceptSessionCommand(input) {
 		}
 		const transcriptId = session.transcriptId;
 		const inputId = input.preparedInput ? randomUUID() : null;
+		if ("kind" in command && command.kind === "append" && inputId) authorizeSessionInput(conversationId, inputId, command.controlVersion, command.execution === "single");
 		if (input.preparedInput && inputId) insertSessionInput({
 			...input.preparedInput,
 			conversationId,

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

@@ -0,0 +1,12 @@
+import { type SessionInputControlCommand, type SessionInputControlView } from '@xopcai/gateway-contract';
+export declare class SessionInputControlConflict extends Error {
+}
+export declare function readSessionInputControl(conversationId: string): SessionInputControlView;
+export declare function hasSessionInputControlOperation(conversationId: string, operationId: string): boolean;
+/** The pause fence commits before any asynchronous cancellation or context preparation. */
+export declare function acceptSessionInputControl(conversationId: string, command: SessionInputControlCommand): {
+    runId?: string;
+    replay: boolean;
+};
+/** Called inside the input acceptance transaction, never as a later HTTP side effect. */
+export declare function authorizeSessionInput(conversationId: string, inputId: string, version?: number, single?: boolean): void;

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

@@ -0,0 +1,83 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
+import { canonicalSessionCommand } from "../../../packages/gateway-contract/src/session-input-command.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { init_session_instance_repository, readCurrentTranscriptId } from "./session-instance-repository.js";
+//#region src/storage/sqlite/session-input-control-repository.ts
+function readSessionInputControl(conversationId) {
+	const db = getSqliteDatabase();
+	const row = db.prepare(`SELECT paused, version, stop_run_id, review_required FROM session_input_control WHERE conversation_id = ?`).get(conversationId);
+	const runtime = db.prepare("SELECT active_run_id FROM session_input_runtime WHERE conversation_id = ?").get(conversationId);
+	return {
+		paused: Boolean(row?.paused),
+		version: row?.version ?? 0,
+		reviewRequired: Boolean(row?.review_required),
+		phase: row?.stop_run_id ? "stopping" : runtime?.active_run_id ? "running" : "idle"
+	};
+}
+function hasSessionInputControlOperation(conversationId, operationId) {
+	return Boolean(getSqliteDatabase().prepare("SELECT 1 FROM session_input_control_operations WHERE conversation_id = ? AND operation_id = ?").get(conversationId, operationId));
+}
+/** The pause fence commits before any asynchronous cancellation or context preparation. */
+function acceptSessionInputControl(conversationId, command) {
+	return runSqliteWriteTransaction((db) => {
+		const request = canonicalSessionCommand(command);
+		const previous = db.prepare("SELECT request_json, run_id FROM session_input_control_operations WHERE conversation_id = ? AND operation_id = ?").get(conversationId, command.operationId);
+		if (previous) {
+			if (previous.request_json !== request) throw new SessionInputControlConflict("Operation identity was reused");
+			return {
+				replay: true,
+				runId: db.prepare("SELECT stop_run_id FROM session_input_control WHERE conversation_id = ?").get(conversationId)?.stop_run_id === previous.run_id ? previous.run_id ?? void 0 : void 0
+			};
+		}
+		if (readCurrentTranscriptId(db, conversationId) !== command.expectedTranscriptId) throw new SessionInputControlConflict("Conversation transcript changed");
+		const state = readSessionInputControl(conversationId);
+		if (state.version !== command.expectedVersion) throw new SessionInputControlConflict("Queue control changed");
+		if ((command.action === "resume" || command.action === "send" || command.action === "steer") && state.phase === "stopping") throw new SessionInputControlConflict("Wait for stopping to finish");
+		if ((command.action === "send" || command.action === "steer") && !command.inputId) throw new SessionInputControlConflict("Select an input");
+		if (command.action === "send" && state.phase !== "idle") throw new SessionInputControlConflict("Wait for the active input to finish");
+		if (command.action === "send" && db.prepare("SELECT 1 FROM session_input_control WHERE conversation_id = ? AND permitted_input_id IS NOT NULL").get(conversationId)) throw new SessionInputControlConflict("Another input is awaiting execution");
+		if (command.action === "steer" && state.phase !== "running") throw new SessionInputControlConflict("No active reply to steer");
+		if (command.inputId) {
+			const row = db.prepare("SELECT status, version, expected_transcript_id FROM session_inputs WHERE conversation_id = ? AND id = ?").get(conversationId, command.inputId);
+			if (row?.expected_transcript_id && row.expected_transcript_id !== command.expectedTranscriptId) throw new SessionInputControlConflict("Input belongs to an earlier transcript");
+			if (!row || row.status !== "queued" && !(command.action === "send" && row.status === "interrupted") || row.version !== command.inputVersion) throw new SessionInputControlConflict("This input changed or has started");
+		}
+		const runtime = db.prepare("SELECT active_run_id FROM session_input_runtime WHERE conversation_id = ?").get(conversationId);
+		const runId = command.action === "stop" || command.action === "steer" ? runtime?.active_run_id ?? void 0 : void 0;
+		db.prepare(`INSERT INTO session_input_runtime(conversation_id, revision, updated_at_ms) VALUES (?, 0, ?) ON CONFLICT DO NOTHING`).run(conversationId, Date.now());
+		db.prepare(`INSERT INTO session_input_control(conversation_id) VALUES (?) ON CONFLICT DO NOTHING`).run(conversationId);
+		db.prepare(`UPDATE session_input_control SET paused = ?, version = version + 1,
+      stop_run_id = CASE WHEN ? = 'stop' THEN ? ELSE stop_run_id END,
+      permitted_input_id = ?, review_required = CASE WHEN ? = 'resume' THEN 0 ELSE review_required END WHERE conversation_id = ?`).run(command.action === "steer" ? Number(state.paused) : command.action === "resume" ? 0 : 1, command.action, command.action === "stop" ? runId ?? null : null, command.action === "send" ? command.inputId : null, command.action, conversationId);
+		if (command.action === "send") db.prepare("UPDATE session_inputs SET status = 'queued', effective_delivery = 'next', target_run_id = NULL, version = version + 1, updated_at_ms = ? WHERE id = ?").run(Date.now(), command.inputId);
+		if (command.action === "steer") db.prepare("UPDATE session_inputs SET status = 'injecting', effective_delivery = 'steer', target_run_id = ?, version = version + 1, updated_at_ms = ? WHERE id = ?").run(runId, Date.now(), command.inputId);
+		db.prepare(`INSERT INTO session_input_control_operations(conversation_id, operation_id, request_json, run_id) VALUES (?, ?, ?, ?)`).run(conversationId, command.operationId, request, runId ?? null);
+		db.prepare(`UPDATE session_input_runtime SET revision = revision + 1 WHERE conversation_id = ?`).run(conversationId);
+		return {
+			runId,
+			replay: false
+		};
+	});
+}
+/** Called inside the input acceptance transaction, never as a later HTTP side effect. */
+function authorizeSessionInput(conversationId, inputId, version, single = false) {
+	const db = getSqliteDatabase();
+	const state = readSessionInputControl(conversationId);
+	if (version !== void 0 && state.version !== version) throw new SessionInputControlConflict("Queue control changed; retry after refreshing");
+	if (!single) return;
+	if (version === void 0 || state.phase !== "idle") throw new SessionInputControlConflict("Wait for the active input to finish");
+	if (db.prepare("SELECT permitted_input_id FROM session_input_control WHERE conversation_id = ?").get(conversationId)?.permitted_input_id) throw new SessionInputControlConflict("Another input is awaiting execution");
+	db.prepare(`INSERT INTO session_input_control(conversation_id, paused, permitted_input_id, version) VALUES (?, 1, ?, 1)
+    ON CONFLICT(conversation_id) DO UPDATE SET paused = 1, permitted_input_id = excluded.permitted_input_id, version = version + 1`).run(conversationId, inputId);
+}
+var SessionInputControlConflict;
+var init_session_input_control_repository = __esmMin((() => {
+	init_src();
+	init_session_instance_repository();
+	init_transaction();
+	SessionInputControlConflict = class extends Error {};
+}));
+//#endregion
+init_session_input_control_repository();
+export { SessionInputControlConflict, acceptSessionInputControl, authorizeSessionInput, hasSessionInputControlOperation, init_session_input_control_repository, readSessionInputControl };

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

@@ -1,3 +1,4 @@
+import { readSessionInputControl } from './session-input-control-repository.js';
 import { getSqliteDatabase } from './transaction.js';
 import { type TurnOrigin } from '@xopcai/endpoint-tools-protocol';
 import type { SessionPreparationView } from '@xopcai/gateway-contract';
@@ -56,6 +57,7 @@ export type SessionInput = {
     updatedAtMs: number;
 };
 export type SessionInputState = {
+    control: ReturnType<typeof readSessionInputControl>;
     preparation?: SessionPreparationView;
     conversationId: string;
     revision: number;

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

@@ -1,6 +1,7 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "./session-instance-repository.js";
+import { init_session_input_control_repository, readSessionInputControl } from "./session-input-control-repository.js";
 import { init_src, turnOriginSchema } from "../../../packages/endpoint-tools-protocol/src/index.js";
 //#region src/storage/sqlite/session-input-repository.ts
 function mapInput(row) {
@@ -50,6 +51,7 @@ function getSessionInputState(conversationId) {
     ('queued','running','injecting','interrupted') ORDER BY position, created_at_ms, id`).all(conversationId);
 	return {
 		conversationId,
+		control: readSessionInputControl(conversationId),
 		...preparation ? { preparation } : {},
 		revision: runtime?.revision ?? 0,
 		activeRunId: runtime?.active_run_id ?? void 0,
@@ -148,19 +150,24 @@ function claimNextSessionInput(conversationId, runId, expectedInputId) {
 		if (db.prepare("SELECT 1 FROM session_tombstones WHERE conversation_id=?").get(conversationId)) return void 0;
 		ensureRuntime(db, conversationId);
 		if (db.prepare(`SELECT active_run_id FROM session_input_runtime WHERE conversation_id = ?`).get(conversationId).active_run_id) return void 0;
+		const control = db.prepare("SELECT paused, stop_run_id, permitted_input_id FROM session_input_control WHERE conversation_id = ?").get(conversationId);
+		if (control?.stop_run_id || control?.paused && !control.permitted_input_id) return void 0;
 		if (db.prepare(`UPDATE session_inputs SET status = 'interrupted', error = 'Session changed before delivery',
       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' AND (kind != 'connection_resume' OR NOT EXISTS (
+      AND status = 'queued' AND (? IS NULL OR id = ?) AND (kind != 'connection_resume' OR NOT EXISTS (
         SELECT 1 FROM session_inputs barrier WHERE barrier.conversation_id = session_inputs.conversation_id
         AND barrier.status = 'interrupted' AND barrier.kind = 'message'
         AND json_extract(barrier.payload_json, '$.connectionBarrier') = 1
         AND json_extract(barrier.payload_json, '$.waitId') = json_extract(session_inputs.payload_json, '$.waitId')
         AND json_extract(barrier.payload_json, '$.objectiveRevision') = json_extract(session_inputs.payload_json, '$.objectiveRevision')
       )) ORDER BY CASE WHEN kind = 'connection_resume' THEN 1 ELSE 0 END,
-      interrupt_requested DESC, position, created_at_ms, id LIMIT 1`).get(conversationId);
-		if (!row) return void 0;
+      interrupt_requested DESC, position, created_at_ms, id LIMIT 1`).get(conversationId, control?.paused ? control.permitted_input_id : null, control?.paused ? control.permitted_input_id : null);
+		if (!row) {
+			if (control?.permitted_input_id) db.prepare("UPDATE session_input_control SET permitted_input_id = NULL WHERE conversation_id = ?").run(conversationId);
+			return;
+		}
 		if (expectedInputId && row.id !== expectedInputId) return void 0;
 		const now = Date.now();
 		if (row.kind === "message" && !JSON.parse(row.payload_json ?? "{}").connectionAction) db.prepare(`UPDATE session_inputs SET payload_json = COALESCE((
@@ -174,9 +181,10 @@ 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);
+		db.prepare("UPDATE session_input_control SET permitted_input_id = NULL WHERE conversation_id = ?").run(conversationId);
 		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 && !claimed.payload?.connectionAction && !hasMaterial(row)) {
+		if (!control?.paused && row.interrupt_requested && !claimed.payload?.connectionAction && !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) {
@@ -203,6 +211,7 @@ function finishSessionInputRun(conversationId, runId, status, error) {
 		db.prepare(`UPDATE session_input_runtime SET active_run_id = NULL, active_input_id = NULL,
       revision = revision + 1, updated_at_ms = ?
       WHERE conversation_id = ?`).run(now, conversationId);
+		db.prepare("UPDATE session_input_control SET stop_run_id = NULL WHERE conversation_id = ? AND stop_run_id = ?").run(conversationId, runId);
 		return true;
 	});
 }
@@ -219,7 +228,7 @@ function setSessionInputStatus(id, status, patch) {
 function mutateQueuedSessionInput(input) {
 	return runSqliteWriteTransaction((db) => {
 		const row = db.prepare(`${SELECT_INPUTS} WHERE id = ? AND conversation_id = ?`).get(input.id, input.conversationId);
-		if (!row || row.kind !== "message" || row.status !== "queued" || row.version !== input.version) return false;
+		if (!row || row.kind !== "message" || row.status !== "queued" || row.version !== input.version || row.expected_transcript_id && row.expected_transcript_id !== readCurrentTranscriptId(db, input.conversationId)) return false;
 		const now = Date.now();
 		if (input.position !== void 0) {
 			const ordered = db.prepare(`${SELECT_INPUTS} WHERE conversation_id = ? AND status = 'queued' ORDER BY position, created_at_ms, id`).all(input.conversationId).filter((item) => item.id !== input.id);
@@ -241,6 +250,7 @@ function cancelQueuedSessionInput(conversationId, id, version) {
 		const result = db.prepare(`UPDATE session_inputs SET status = 'cancelled', version = version + 1,
       updated_at_ms = ? WHERE id = ? AND conversation_id = ? AND version = ? AND kind = 'message' AND status IN ('queued','interrupted')`).run(Date.now(), id, conversationId, version);
 		if (Number(result.changes) === 0) return false;
+		db.prepare("UPDATE session_input_control SET permitted_input_id = NULL, version = version + 1 WHERE conversation_id = ? AND permitted_input_id = ?").run(conversationId, id);
 		bumpSessionInputRevision(db, conversationId);
 		return true;
 	});
@@ -268,11 +278,13 @@ function recoverSessionInputState() {
       AND json_extract(payload_json, '$.connectionAction') IN ('continue','cancel')`).run(now);
 		db.prepare(`UPDATE session_input_runtime SET active_run_id = NULL, active_input_id = NULL,
       revision = revision + 1, updated_at_ms = ?`).run(now);
+		db.prepare("UPDATE session_input_control SET stop_run_id = NULL").run();
 		return keys.map((row) => row.conversation_id);
 	});
 }
 var SELECT_INPUTS, SessionInstanceChangedError;
 var init_session_input_repository = __esmMin((() => {
+	init_session_input_control_repository();
 	init_session_instance_repository();
 	init_transaction();
 	init_src();

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

@@ -60,6 +60,7 @@ function listSessionMetadata(query = {}) {
 		conditions.push(`s.hidden_from_session_list = 0`);
 		conditions.push(`NOT (s.source_channel = 'automation' AND (COALESCE(CASE WHEN json_valid(s.custom_data_json) THEN json_extract(s.custom_data_json, '$.systemInternal') END, 0) = 1 OR COALESCE(CASE WHEN json_valid(s.custom_data_json) THEN json_extract(s.custom_data_json, '$.automationId') END, '') LIKE 'system-memory-%'))`);
 	}
+	if (query.excludeAutomationRuns) conditions.push(`${SESSION_SOURCE_SQL} != 'automation'`);
 	if (query.rootConversationsOnly && !query.search?.trim()) {
 		conditions.push(`NOT EXISTS (
       SELECT 1 FROM task_sessions worker

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

@@ -4,6 +4,8 @@ import type { AgentSourceContext, SourceContextRefSummary } from '../../agent/so
 export type ReplaceLatestSessionTurnInput = {
     conversationId: string;
     targetTurnId: string;
+    expectedTranscriptId?: string;
+    controlVersion?: number;
     clientMessageId: string;
     content: string;
     attachments?: unknown[];

package/dist/src/storage/sqlite/session-turn-replace-repository.js

@@ -1,11 +1,13 @@
 import { getXopcDatabase, init_connection } from "./connection.js";
 import { init_transaction, runSqliteWriteTransaction } from "./transaction.js";
+import { authorizeSessionInput, init_session_input_control_repository, readSessionInputControl } from "./session-input-control-repository.js";
 import { buildSessionContextForLlm, buildSessionDisplayMessages, init_session_context_for_llm } from "../../session/session-context-for-llm.js";
 import { estimateTokensFromMessages, init_row_mappers, transcriptEntryRowToStoredRow } from "./row-mappers.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/session-turn-replace-repository.ts
 init_session_context_for_llm();
 init_row_mappers();
+init_session_input_control_repository();
 init_connection();
 init_transaction();
 function isUserRow(row) {
@@ -65,10 +67,16 @@ function replaceLatestSessionTurnAndQueueInput(input) {
 		db.prepare(`INSERT INTO session_input_runtime(conversation_id, revision, updated_at_ms)
        VALUES (?, 0, ?) ON CONFLICT(conversation_id) DO NOTHING`).run(input.conversationId, Date.now());
 		const runtime = db.prepare(`SELECT active_run_id FROM session_input_runtime WHERE conversation_id = ?`).get(input.conversationId);
+		const control = readSessionInputControl(input.conversationId);
+		if (input.expectedTranscriptId && session.transcript_id !== input.expectedTranscriptId) return {
+			ok: false,
+			code: "TARGET_NOT_FOUND"
+		};
 		const pending = db.prepare(`SELECT 1 AS found FROM session_inputs
-         WHERE conversation_id = ? AND status IN ('queued', 'running', 'injecting', 'interrupted')
+         WHERE conversation_id = ? AND status IN ('running', 'injecting', 'interrupted')
          LIMIT 1`).get(input.conversationId);
-		if (runtime?.active_run_id || pending) return {
+		const queued = !control.paused && db.prepare("SELECT 1 FROM session_inputs WHERE conversation_id = ? AND status = 'queued' LIMIT 1").get(input.conversationId);
+		if (runtime?.active_run_id || pending || queued || control.phase === "stopping") return {
 			ok: false,
 			code: "SESSION_BUSY"
 		};
@@ -95,6 +103,10 @@ function replaceLatestSessionTurnAndQueueInput(input) {
 		const maxPosition = db.prepare(`SELECT COALESCE(MAX(position), 0) AS value FROM session_inputs
          WHERE conversation_id = ? AND status IN ('queued', 'running', 'injecting', 'interrupted')`).get(input.conversationId);
 		const inputId = randomUUID();
+		if (control.paused) {
+			authorizeSessionInput(input.conversationId, inputId, input.controlVersion, true);
+			db.prepare("UPDATE session_input_control SET review_required = 1 WHERE conversation_id = ?").run(input.conversationId);
+		}
 		db.prepare(`INSERT INTO session_inputs(id, conversation_id, client_message_id,
        requested_delivery, effective_delivery, status, content, attachments_json,
        context_refs_json, context_snapshots_json, thinking, origin_json, position,

package/dist/src/storage/sqlite/upgrades/262_session_input_control.sql

@@ -0,0 +1,15 @@
+CREATE TABLE session_input_control (
+  conversation_id TEXT PRIMARY KEY REFERENCES sessions(conversation_id) ON DELETE CASCADE,
+  paused INTEGER NOT NULL DEFAULT 0,
+  version INTEGER NOT NULL DEFAULT 0,
+  stop_run_id TEXT,
+  permitted_input_id TEXT,
+  review_required INTEGER NOT NULL DEFAULT 0
+);
+CREATE TABLE session_input_control_operations (
+  conversation_id TEXT NOT NULL REFERENCES sessions(conversation_id) ON DELETE CASCADE,
+  operation_id TEXT NOT NULL,
+  request_json TEXT NOT NULL,
+  run_id TEXT,
+  PRIMARY KEY (conversation_id, operation_id)
+);

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

@@ -4,10 +4,10 @@ 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 { TaskContextRepository } from "../task-context-repository.js";
 import { TaskReadModelProjector } from "../task-read-model-projector.js";
-import { TaskDependencyService } from "../task-dependency-service.js";
 import { TaskConversationRepository } from "../task-conversation-repository.js";
+import { TaskContextRepository } from "../task-context-repository.js";
+import { TaskDependencyService } from "../task-dependency-service.js";
 import { TaskCriterionReviewRepository } from "../task-criterion-review-repository.js";
 import { TaskValueMetricsService } from "../task-value-metrics-service.js";
 //#region src/tasks/capabilities/read.ts

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

@@ -7,8 +7,8 @@ import { defineAtomicCapability } from "../../capabilities/runtime/dispatcher.js
 import { resolveTaskLocale } from "../task-language.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import { TaskApplicationService } from "../task-application-service.js";
-import { resolveResponseLanguageForSession } from "../../agent/prompt/response-language.js";
 import { TaskSignalService } from "../task-signal-service.js";
+import { resolveResponseLanguageForSession } from "../../agent/prompt/response-language.js";
 import { z } from "zod";
 //#region src/tasks/capabilities/write.ts
 init_src();

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

@@ -5,8 +5,8 @@ import { isHomeAttentionAcknowledged } from "../storage/sqlite/home-attention-re
 import "../storage/sqlite/index.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import "../automations/domain/defaults.js";
-import "../automations/index.js";
 import { AttentionGovernor } from "./attention-governor.js";
+import "../automations/index.js";
 //#region src/tasks/home-query-service.ts
 init_task_repository();
 init_task_run_repository();

package/dist/src/tasks/index.js

@@ -1,20 +1,20 @@
 import { enqueueTaskAttentionRequiredEvent, enqueueTaskChanged, enqueueTaskChangedEvent, init_task_change_events } from "./task-change-events.js";
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { TaskContextRepository } from "./task-context-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
-import { TaskDependencyError, TaskDependencyService } from "./task-dependency-service.js";
 import { TaskConversationConflictError, TaskConversationRepository } from "./task-conversation-repository.js";
-import { TaskApplicationService } from "./task-application-service.js";
-import { defineTaskContract } from "./task-contract-definition.js";
-import { assembleTaskContext, buildDelegatedTaskDirective, buildTaskExecutionDirective, getTaskContextManifest, getTaskExecutionBrief } from "./task-context-assembler.js";
+import { TaskContextRepository } from "./task-context-repository.js";
+import { TaskDependencyError, TaskDependencyService } from "./task-dependency-service.js";
 import { TaskValueMetricsService } from "./task-value-metrics-service.js";
 import { TaskDeletionService } from "./task-deletion-service.js";
+import { TaskApplicationService } from "./task-application-service.js";
 import { TaskSignalService } from "./task-signal-service.js";
 import { resolveExecutionContext } from "./execution-context.js";
 import { AttentionGovernor } from "./attention-governor.js";
 import { HomeQueryService, buildHomeWorkbench, decisionFromTask } from "./home-query-service.js";
+import { defineTaskContract } from "./task-contract-definition.js";
 import { ModelTaskContractPlanner, parseTaskContractResponse } from "./task-contract-planner.js";
+import { assembleTaskContext, buildDelegatedTaskDirective, buildTaskExecutionDirective, getTaskContextManifest, getTaskExecutionBrief } from "./task-context-assembler.js";
 import { TaskRunCoordinator } from "./task-run-coordinator.js";
 import { ProjectOperatingViewService, summarizeProjectOperatingView } from "./project-operating-view-service.js";
 import { TaskHandoffService } from "./task-handoff-service.js";

package/dist/src/tasks/task-allocation-service.js

@@ -9,20 +9,20 @@ import { init_request_repository, personalRequestForTask, updatePersonalRequest
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
+import { init_providers, resolveModel } from "../providers/index.js";
+import { completeWithResolvedCredentials } from "../providers/model-call.js";
+import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { hasUnlocalizedTaskText, resolveTaskLocale } from "./task-language.js";
 import { TaskAllocationRepository } from "./task-allocation-repository.js";
 import { getTaskHandoff, resolveTaskHandoffReferences } from "./task-handoff.js";
 import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { TaskApplicationService } from "./task-application-service.js";
-import { AgentSelectionRepository, selectionRequestHash } from "../agent-matching/selection-repository.js";
-import { init_providers, resolveModel } from "../providers/index.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
-import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { defineTaskContract } from "./task-contract-definition.js";
-import { supersededTaskInstructionIds } from "./task-research-result.js";
 import { personalCapabilities } from "../personal-agent/capability-service.js";
 import { assessTaskExecutor, captureExecutionRequirements, taskExecutionRequirements } from "./task-execution-capabilities.js";
 import { ModelTaskContractPlanner } from "./task-contract-planner.js";
+import { supersededTaskInstructionIds } from "./task-research-result.js";
+import { AgentSelectionRepository, selectionRequestHash } from "../agent-matching/selection-repository.js";
 import { z } from "zod";
 //#region src/tasks/task-allocation-service.ts
 init_src();

package/dist/src/tasks/task-application-service.js

@@ -6,17 +6,17 @@ import { enqueueTaskAttentionRequiredEvent, enqueueTaskChangedEvent, init_task_c
 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 { TaskContextRepository } from "./task-context-repository.js";
 import { resolveTaskLocale } from "./task-language.js";
 import { TaskAllocationRepository } from "./task-allocation-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
-import { TaskDependencyService } from "./task-dependency-service.js";
-import { resolvePersonalResultReference } from "../personal-agent/result-reader.js";
 import { TaskOriginRepository } from "./task-origin-repository.js";
-import { captureTaskHandoff } from "./task-handoff.js";
-import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
+import { resolvePersonalResultReference } from "../personal-agent/result-reader.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
+import { TaskContextRepository } from "./task-context-repository.js";
+import { TaskDependencyService } from "./task-dependency-service.js";
 import { TaskCriterionReviewRepository } from "./task-criterion-review-repository.js";
+import { captureTaskHandoff } from "./task-handoff.js";
+import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { TaskResultDeliveryRepository } from "./task-result-delivery-repository.js";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/tasks/task-application-service.ts

package/dist/src/tasks/task-collaboration-delivery.js

@@ -4,8 +4,8 @@ import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transacti
 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 { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
+import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { TaskApplicationService } from "./task-application-service.js";
 //#region src/tasks/task-collaboration-delivery.ts
 init_request_repository();

package/dist/src/tasks/task-context-assembler.js

@@ -6,10 +6,10 @@ 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 "../storage/sqlite/index.js";
-import { TaskContextRepository } from "./task-context-repository.js";
 import { TaskOriginRepository } from "./task-origin-repository.js";
-import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
+import { TaskContextRepository } from "./task-context-repository.js";
+import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 //#region src/tasks/task-context-assembler.ts
 init_src();
 init_task_repository();

package/dist/src/tasks/task-contract-planner.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../packages/gateway-contract/src/task-display.js";
-import { hasUnlocalizedTaskText, resolveTaskLocale } from "./task-language.js";
 import { getAgentDefaultChatModelConfig, init_schema } from "../config/schema.js";
-import { completeTaskModelCall } from "./task-model-call.js";
+import { hasUnlocalizedTaskText, resolveTaskLocale } from "./task-language.js";
 import { defineTaskContract } from "./task-contract-definition.js";
+import { completeTaskModelCall } from "./task-model-call.js";
 import "../personal-agent/communication.js";
 import { EXECUTION_CAPABILITIES } from "./task-execution-capabilities.js";
 //#region src/tasks/task-contract-planner.ts

package/dist/src/tasks/task-handoff-service.js

@@ -4,9 +4,9 @@ import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
 import { normalizeAgentId } from "../agent-catalog/id.js";
 import { init_agent_scope, listAgentEntries } from "../agent/agent-scope.js";
-import { TaskContextRepository } from "./task-context-repository.js";
 import { init_session_key, resolveConversationId, sanitizeSegment } from "../routing/session-key.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
+import { TaskContextRepository } from "./task-context-repository.js";
 //#region src/tasks/task-handoff-service.ts
 init_agent_scope();
 init_session_key();

package/dist/src/tasks/task-handoff.js

@@ -8,17 +8,17 @@ import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../storage/sqlite/session-repository.js";
 import { getSessionConfig } from "../storage/sqlite/config-repository.js";
-import { TaskContextRepository } from "./task-context-repository.js";
+import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
+import { getProjectForSession } from "../projects/workspace.js";
 import { resolveMediaReference } from "../media/media-reference.js";
 import { assertPersonalResultDelegateAccess, readPersonalResult, resolvePersonalResultReference } from "../personal-agent/result-reader.js";
+import { NotesStore } from "../notes/store.js";
+import { TaskContextRepository } from "./task-context-repository.js";
 import { buildResultAgentContext } from "../agent/source-context/result-context.js";
 import { buildTaskAgentContext } from "../agent/source-context/task-context.js";
 import { parseTurnContextRefs } from "../agent/source-context/types.js";
 import { buildUserAssertionAgentContext } from "../agent/source-context/user-assertion-context.js";
-import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
-import { getProjectForSession } from "../projects/workspace.js";
 import { fileSpaceId, parseFileResourceId } from "../files/file-service.js";
-import { NotesStore } from "../notes/store.js";
 import { basename, isAbsolute, relative, resolve, sep } from "node:path";
 import { constants } from "node:fs";
 import { createHash } from "node:crypto";

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

@@ -1,10 +1,10 @@
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
-import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { init_providers, resolveModel } from "../providers/index.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.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();
 init_task_repository();

package/dist/src/tasks/task-model-call.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_providers, resolveModel } from "../providers/index.js";
-import { getAssistantMessageErrorReason, isTransientProviderErrorMessage } from "../providers/model-response.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
+import { getAssistantMessageErrorReason, isTransientProviderErrorMessage } from "../providers/model-response.js";
 //#region src/tasks/task-model-call.ts
 init_providers();
 init_logger();

package/dist/src/tasks/task-research-result.js

@@ -8,15 +8,15 @@ import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "../storage/sqlite/session-instance-repository.js";
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { readMediaReference } from "../media/media-reference.js";
 import { resolveEffectiveAgentConfigForSession } from "../config/agent-profile.js";
-import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
+import { extractAssistantText, stripCodeFences } from "../providers/model-response.js";
+import { readMediaReference } from "../media/media-reference.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
+import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { taskInstructionSequence } from "./task-instruction-sequence.js";
 import { TaskResultDeliveryRepository } from "./task-result-delivery-repository.js";
-import { extractAssistantText, stripCodeFences } from "../providers/model-response.js";
-import { completeTaskModelCall } from "./task-model-call.js";
 import { defineTaskContract } from "./task-contract-definition.js";
+import { completeTaskModelCall } from "./task-model-call.js";
 import { observedEvidenceExcerpt, suggestedEvidenceRanges } from "./task-evidence-ranges.js";
 import { createHash } from "node:crypto";
 import { z } from "zod";

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

@@ -7,8 +7,8 @@ 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 { init_request_repository, personalRequestForTask } from "../personal-agent/request-repository.js";
-import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
+import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { hasPersonalResultFileLinks, sanitizePersonalResultFileLinks } from "../personal-agent/result-file-links.js";
 import { taskInstructionSequence } from "./task-instruction-sequence.js";
 import { randomUUID } from "node:crypto";

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

@@ -7,17 +7,17 @@ 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 } from "../storage/sqlite/transcript-repository.js";
+import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
 import { emitSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { resolveTaskLocale } from "./task-language.js";
 import { tryParseMediaUri } from "../media/uri.js";
 import { resolveMediaBufferPath } from "../media/store.js";
-import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
 import { warmPersonalResult } from "../personal-agent/result-reader.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
 import { taskInstructionSequence } from "./task-instruction-sequence.js";
 import { TaskResultDeliveryRepository } from "./task-result-delivery-repository.js";
-import { recordPersonalPerformance } from "../personal-agent/performance.js";
 import "./task-research-result.js";
+import { recordPersonalPerformance } from "../personal-agent/performance.js";
 import { enqueuePersonalReply } from "../personal-agent/reply-composer.js";
 import { createReadStream } from "node:fs";
 import { createHash } from "node:crypto";

package/dist/src/tasks/task-run-coordinator.js

@@ -5,16 +5,16 @@ import { init_request_repository, personalRequestForTask } from "../personal-age
 import { loadTranscriptRowsForSession } from "../storage/sqlite/transcript-repository.js";
 import "../storage/sqlite/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { TaskContextRepository } from "./task-context-repository.js";
+import { isTransientProviderErrorMessage } from "../providers/model-response.js";
+import { ACCEPTANCE_REPAIR_READ_TOOLS, canResumeAfterModelFailure } from "../agent/orchestration/turn-recovery.js";
 import { resolveTaskLocale } from "./task-language.js";
 import { TaskAllocationRepository } from "./task-allocation-repository.js";
+import { TaskContextRepository } from "./task-context-repository.js";
 import { TaskCollaborationRepository } from "./task-collaboration-repository.js";
 import { taskInstructionSequence } from "./task-instruction-sequence.js";
 import { TaskResultDeliveryRepository } from "./task-result-delivery-repository.js";
 import { TaskApplicationService } from "./task-application-service.js";
-import { isTransientProviderErrorMessage } from "../providers/model-response.js";
 import { currentTaskResearchResult } from "./task-research-result.js";
-import { ACCEPTANCE_REPAIR_READ_TOOLS, canResumeAfterModelFailure } from "../agent/orchestration/turn-recovery.js";
 import { buildResearchRepair, inspectTaskPublications } from "./task-research-repair.js";
 //#region src/tasks/task-run-coordinator.ts
 init_repository();