@xopcai/xopc 0.0.385 → 0.0.387

package/dist/src/storage/sqlite/migrations/251_personal_result_reads.sql

@@ -0,0 +1,40 @@
+CREATE TABLE personal_result_documents (
+  document_id TEXT PRIMARY KEY,
+  delivery_id TEXT NOT NULL REFERENCES task_result_deliveries(delivery_id) ON DELETE CASCADE,
+  source_id TEXT NOT NULL,
+  status TEXT NOT NULL CHECK(status IN ('pending', 'ready', 'unsupported', 'failed')),
+  lease_token TEXT,
+  lease_until INTEGER NOT NULL DEFAULT 0,
+  parser_version INTEGER NOT NULL,
+  content_revision TEXT,
+  content TEXT,
+  sections_json TEXT NOT NULL DEFAULT '[]',
+  limitations_json TEXT NOT NULL DEFAULT '[]',
+  fingerprint TEXT,
+  error TEXT,
+  UNIQUE(delivery_id, source_id)
+);
+CREATE VIRTUAL TABLE personal_result_search USING fts5(
+  document_id UNINDEXED, start_offset UNINDEXED, text, tokenize='trigram'
+);
+CREATE TABLE personal_result_sections (
+  document_id TEXT NOT NULL REFERENCES personal_result_documents(document_id) ON DELETE CASCADE,
+  section_id TEXT NOT NULL,
+  ordinal INTEGER NOT NULL,
+  title TEXT NOT NULL,
+  start_offset INTEGER NOT NULL,
+  char_length INTEGER NOT NULL,
+  locator_json TEXT NOT NULL,
+  PRIMARY KEY(document_id, section_id)
+);
+CREATE INDEX idx_personal_result_sections_order ON personal_result_sections(document_id, ordinal);
+CREATE TABLE personal_result_read_waits (
+  input_id TEXT PRIMARY KEY REFERENCES session_inputs(id) ON DELETE CASCADE,
+  conversation_id TEXT NOT NULL REFERENCES sessions(conversation_id) ON DELETE CASCADE,
+  transcript_id TEXT NOT NULL,
+  requests_json TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending','queued','done','stale'))
+);
+CREATE TRIGGER personal_result_documents_delete AFTER DELETE ON personal_result_documents BEGIN
+  DELETE FROM personal_result_search WHERE document_id = old.document_id;
+END;

package/dist/src/storage/sqlite/migrations/252_task_work_revisions.sql

@@ -0,0 +1,15 @@
+CREATE TABLE task_work_revisions (
+  revision_id TEXT PRIMARY KEY,
+  task_id TEXT NOT NULL REFERENCES tasks(task_id) ON DELETE CASCADE,
+  contract_version INTEGER NOT NULL,
+  baseline_delivery_id TEXT NOT NULL,
+  baseline_version TEXT NOT NULL,
+  instruction_entry_id TEXT NOT NULL,
+  input_id TEXT,
+  idempotency_key TEXT NOT NULL UNIQUE,
+  request_hash TEXT NOT NULL,
+  supersedes_json TEXT NOT NULL DEFAULT '[]',
+  original_body TEXT,
+  created_at INTEGER NOT NULL,
+  UNIQUE(task_id, contract_version)
+);

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 = 249;
+export declare const XOPC_DB_SCHEMA_VERSION = 252;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

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

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

package/dist/src/storage/sqlite/research-checkpoint-repository.d.ts

@@ -0,0 +1,24 @@
+import type { SearchCacheEntry } from '../../agent/tools/search/cache.js';
+import { type ResearchCheckpoint, type ResearchCheckpointUpdate, type ResearchEvidence } from '../../agent/orchestration/research-checkpoint.js';
+export interface StoredResearchCheckpoint {
+    id: string;
+    conversationId: string;
+    workspace: string;
+    goal: string;
+    checkpoint: ResearchCheckpoint;
+    status: 'running' | 'partial' | 'completed' | 'failed' | 'cancelled';
+    attempts: number;
+    stopReason?: string;
+    summary: string;
+    leaseToken?: string;
+    leaseExpiresAt?: number;
+}
+export declare function getResearchCheckpoint(id: string, conversationId: string, workspace: string): StoredResearchCheckpoint | undefined;
+export declare function createResearchCheckpoint(conversationId: string, workspace: string, goal: string): StoredResearchCheckpoint;
+/** Lease ownership fences late tool callbacks and competing resume requests. */
+export declare function claimResearchCheckpoint(record: StoredResearchCheckpoint, timeoutMs: number, now?: number): StoredResearchCheckpoint;
+export declare function saveResearchCheckpoint(record: StoredResearchCheckpoint, update: ResearchCheckpointUpdate): ResearchCheckpoint;
+export declare function recordResearchEvidence(record: StoredResearchCheckpoint, evidence: ResearchEvidence): void;
+export declare function finishResearchCheckpoint(record: StoredResearchCheckpoint, status: StoredResearchCheckpoint['status'], stopReason: string, summary: string): void;
+/** Keep successful public search results with the same task lease and a bounded envelope. */
+export declare function recordResearchSearch(record: StoredResearchCheckpoint, entry: SearchCacheEntry): void;

package/dist/src/storage/sqlite/research-checkpoint-repository.js

@@ -0,0 +1,91 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
+import { init_research_checkpoint, mergeResearchCheckpoint } from "../../agent/orchestration/research-checkpoint.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/research-checkpoint-repository.ts
+function decode(row) {
+	return {
+		id: row.id,
+		conversationId: row.conversation_id,
+		workspace: row.workspace,
+		goal: row.goal,
+		checkpoint: JSON.parse(row.checkpoint_json),
+		status: row.status,
+		attempts: row.attempts,
+		stopReason: row.stop_reason ?? void 0,
+		summary: row.summary,
+		leaseToken: row.lease_token ?? void 0,
+		leaseExpiresAt: row.lease_expires_at ?? void 0
+	};
+}
+function getResearchCheckpoint(id, conversationId, workspace) {
+	const row = getSqliteDatabase().prepare("SELECT * FROM research_checkpoints WHERE id = ? AND conversation_id = ? AND workspace = ?").get(id, conversationId, workspace);
+	return row ? decode(row) : void 0;
+}
+function createResearchCheckpoint(conversationId, workspace, goal) {
+	const id = randomUUID();
+	const checkpoint = {
+		findings: [],
+		evidence: [],
+		nextSteps: [goal.slice(0, 500)]
+	};
+	runSqliteWriteTransaction((db) => db.prepare(`INSERT INTO research_checkpoints
+    (id, conversation_id, workspace, goal, checkpoint_json, status, updated_at) VALUES (?, ?, ?, ?, ?, 'partial', ?)`).run(id, conversationId, workspace, goal, JSON.stringify(checkpoint), Date.now()));
+	return getResearchCheckpoint(id, conversationId, workspace);
+}
+/** Lease ownership fences late tool callbacks and competing resume requests. */
+function claimResearchCheckpoint(record, timeoutMs, now = Date.now()) {
+	return runSqliteWriteTransaction((db) => {
+		const token = randomUUID();
+		if (!db.prepare(`UPDATE research_checkpoints SET status = 'running', attempts = attempts + 1,
+      lease_token = ?, lease_expires_at = ?, updated_at = ? WHERE id = ? AND conversation_id = ? AND workspace = ?
+      AND status != 'completed' AND (lease_token IS NULL OR lease_expires_at <= ?)`).run(token, now + timeoutMs, now, record.id, record.conversationId, record.workspace, now).changes) throw new Error("Research checkpoint is complete or already running");
+		return getResearchCheckpoint(record.id, record.conversationId, record.workspace);
+	});
+}
+function mutate(record, transform) {
+	return runSqliteWriteTransaction((db) => {
+		const current = getResearchCheckpoint(record.id, record.conversationId, record.workspace);
+		if (!current || !record.leaseToken || current.leaseToken !== record.leaseToken || current.status !== "running" || (current.leaseExpiresAt ?? 0) <= Date.now()) throw new Error("Research checkpoint lease expired");
+		const checkpoint = transform(current.checkpoint);
+		db.prepare("UPDATE research_checkpoints SET checkpoint_json = ?, updated_at = ? WHERE id = ? AND lease_token = ?").run(JSON.stringify(checkpoint), Date.now(), record.id, record.leaseToken);
+		return checkpoint;
+	});
+}
+function saveResearchCheckpoint(record, update) {
+	return mutate(record, (current) => mergeResearchCheckpoint(current, update));
+}
+function recordResearchEvidence(record, evidence) {
+	mutate(record, (current) => ({
+		...current,
+		evidence: [...current.evidence.filter((item) => item.toolCallId !== evidence.toolCallId || item.runId !== evidence.runId), {
+			...evidence,
+			excerpt: evidence.excerpt.slice(0, 2e3)
+		}].slice(-30)
+	}));
+}
+function finishResearchCheckpoint(record, status, stopReason, summary) {
+	if (!runSqliteWriteTransaction((db) => db.prepare(`UPDATE research_checkpoints SET status = ?, stop_reason = ?, summary = ?,
+    lease_token = NULL, lease_expires_at = NULL, updated_at = ? WHERE id = ? AND lease_token = ?`).run(status, stopReason, summary.slice(0, 8e3), Date.now(), record.id, record.leaseToken ?? "")).changes) throw new Error("Research checkpoint lease was replaced");
+}
+/** Keep successful public search results with the same task lease and a bounded envelope. */
+function recordResearchSearch(record, entry) {
+	mutate(record, (current) => {
+		const searches = [...(current.searches ?? []).filter((item) => item.key !== entry.key), entry].slice(-20);
+		while (searches.length && JSON.stringify({
+			...current,
+			searches
+		}).length > 2e5) searches.shift();
+		return {
+			...current,
+			searches
+		};
+	});
+}
+var init_research_checkpoint_repository = __esmMin((() => {
+	init_research_checkpoint();
+	init_transaction();
+}));
+//#endregion
+init_research_checkpoint_repository();
+export { claimResearchCheckpoint, createResearchCheckpoint, finishResearchCheckpoint, getResearchCheckpoint, init_research_checkpoint_repository, recordResearchEvidence, recordResearchSearch, saveResearchCheckpoint };

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

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

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

@@ -3,7 +3,7 @@ import { sessionCommandIdentity } from "../../../packages/gateway-contract/src/s
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_session_input_repository, insertSessionInput } from "./session-input-repository.js";
 import { init_clarification_wait_repository, supersedeActiveClarification } from "./clarification-wait-repository.js";
-import { init_connection_wait_repository, invalidateConnectionResumeIntent } from "./connection-wait-repository.js";
+import { cancelConnectionObjective, init_connection_wait_repository } from "./connection-wait-repository.js";
 import { getSessionMetadata } from "./session-read-repository.js";
 import { init_session_repository } from "./session-repository.js";
 import { init_config_repository, setSessionConfig } from "./config-repository.js";
@@ -113,7 +113,8 @@ function acceptSessionCommand(input) {
 			expectedTranscriptId: transcriptId
 		});
 		if (inputId) {
-			invalidateConnectionResumeIntent(conversationId);
+			const control = input.preparedInput?.payload;
+			if (control?.connectionAction === "cancel") cancelConnectionObjective(conversationId, control.waitId, control.objectiveRevision);
 			supersedeActiveClarification(conversationId);
 		}
 		const receipt = {

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

@@ -8,10 +8,26 @@ export type SessionInputPayload = {
     waitId: string;
     objectiveRevision: number;
     resolution: 'continued' | 'skipped';
+    connectionAction?: never;
+    connectionBarrier?: never;
 } | {
     waitId: string;
     objectiveRevision: number;
     resolution: 'answered' | 'agent_decide' | 'cancelled';
+    connectionAction?: never;
+    connectionBarrier?: never;
+} | {
+    waitId: string;
+    objectiveRevision: number;
+    connectionAction: 'continue' | 'cancel';
+    resolution?: never;
+    connectionBarrier?: never;
+} | {
+    waitId: string;
+    objectiveRevision: number;
+    connectionBarrier: true;
+    connectionAction?: never;
+    resolution?: never;
 };
 export type SessionInput = {
     id: string;

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

@@ -152,23 +152,39 @@ 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 interrupt_requested DESC, position, created_at_ms, id LIMIT 1`).get(conversationId);
+      AND status = 'queued' 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;
 		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((
+        SELECT json_object('waitId', wait.id, 'objectiveRevision', json_extract(wait.data_json, '$.objectiveRevision'), 'connectionBarrier', json('true'))
+        FROM session_connection_waits wait WHERE wait.conversation_id = session_inputs.conversation_id
+        AND wait.transcript_id = ? AND wait.status IN ('open','queued')
+        AND (session_inputs.payload_json IS NULL OR wait.id = json_extract(session_inputs.payload_json, '$.waitId'))
+        AND session_inputs.id != json_extract(wait.data_json, '$.originInputId') LIMIT 1
+      ), payload_json) WHERE id = ?`).run(readCurrentTranscriptId(db, conversationId), row.id);
 		db.prepare(`UPDATE session_inputs SET status = 'running', run_id = ?, version = version + 1,
       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);
 		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)) {
+		if (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) {
-				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;
+				if (!next.interrupt_requested || next.kind !== "message" || JSON.parse(next.payload_json ?? "{}").connectionAction || 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;
+				const nextPayload = JSON.parse(next.payload_json ?? "{}");
+				if (claimed.payload?.connectionBarrier && nextPayload?.waitId && nextPayload.waitId !== claimed.payload.waitId) 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);
+          payload_json = ?, version = version + 1, updated_at_ms = ? WHERE id = ?`).run(runId, claimed.payload?.connectionBarrier ? JSON.stringify(claimed.payload) : next.payload_json, now, next.id);
 				claimed.content += `\n\n${next.content}`;
 			}
 		}
@@ -210,9 +226,12 @@ function mutateQueuedSessionInput(input) {
 			ordered.splice(Math.max(0, Math.min(input.position, ordered.length)), 0, row);
 			const stmt = db.prepare(`UPDATE session_inputs SET position = ?, version = version + 1, updated_at_ms = ? WHERE id = ?`);
 			ordered.forEach((item, index) => stmt.run(index + 1, now, item.id));
-		} else db.prepare(`UPDATE session_inputs SET content = ?, attachments_json = ?, context_refs_json = ?,
-        context_snapshots_json = ?, thinking = ?, version = version + 1,
-        updated_at_ms = ? WHERE id = ?`).run(input.content ?? row.content, input.attachments ? JSON.stringify(input.attachments) : row.attachments_json, input.contextRefs ? JSON.stringify(input.contextRefs) : row.context_refs_json, input.contextSnapshots ? JSON.stringify(input.contextSnapshots) : row.context_snapshots_json, input.thinking ?? row.thinking, now, input.id);
+		} else {
+			const clearControl = Boolean(row.payload_json && JSON.parse(row.payload_json).connectionAction && (input.content !== void 0 && input.content !== row.content || input.attachments?.length || input.contextSnapshots?.length));
+			db.prepare(`UPDATE session_inputs SET content = ?, attachments_json = ?, context_refs_json = ?,
+        context_snapshots_json = ?, thinking = ?, payload_json = ?, version = version + 1,
+        updated_at_ms = ? WHERE id = ?`).run(input.content ?? row.content, input.attachments ? JSON.stringify(input.attachments) : row.attachments_json, input.contextRefs ? JSON.stringify(input.contextRefs) : row.context_refs_json, input.contextSnapshots ? JSON.stringify(input.contextSnapshots) : row.context_snapshots_json, input.thinking ?? row.thinking, clearControl ? null : row.payload_json, now, input.id);
+		}
 		bumpSessionInputRevision(db, input.conversationId);
 		return true;
 	});
@@ -230,8 +249,23 @@ function recoverSessionInputState() {
 	return runSqliteWriteTransaction((db) => {
 		const keys = db.prepare(`SELECT DISTINCT conversation_id FROM session_inputs WHERE status IN ('queued','running','injecting')`).all();
 		const now = Date.now();
+		db.prepare(`UPDATE session_inputs SET payload_json = (
+      SELECT json_object('waitId', wait.id, 'objectiveRevision', json_extract(wait.data_json, '$.objectiveRevision'), 'connectionBarrier', json('true'))
+      FROM session_connection_waits wait JOIN sessions session ON session.active_transcript_id = wait.transcript_id
+      WHERE wait.conversation_id = session_inputs.conversation_id AND wait.status IN ('open','queued')
+      AND (session_inputs.payload_json IS NULL OR wait.id = json_extract(session_inputs.payload_json, '$.waitId'))
+      AND (session_inputs.expected_transcript_id IS NULL OR session_inputs.expected_transcript_id = wait.transcript_id)
+      AND session_inputs.id != json_extract(wait.data_json, '$.originInputId')
+      AND (json_extract(session_inputs.payload_json, '$.connectionBarrier') = 1
+        OR session_inputs.created_at_ms >= json_extract(wait.data_json, '$.createdAt')) LIMIT 1
+    ) WHERE kind = 'message' AND status IN ('running','injecting')
+      AND (payload_json IS NULL OR json_extract(payload_json, '$.connectionBarrier') = 1)`).run();
 		db.prepare(`UPDATE session_inputs SET status = 'interrupted', error = 'Gateway restarted during delivery',
       version = version + 1, updated_at_ms = ? WHERE status IN ('running','injecting')`).run(now);
+		db.prepare(`UPDATE session_inputs SET status = 'queued', error = NULL, version = version + 1,
+      updated_at_ms = ? WHERE status = 'interrupted' AND kind = 'message'
+      AND error = 'Gateway restarted during delivery'
+      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);
 		return keys.map((row) => row.conversation_id);

package/dist/src/tasks/capabilities/management.d.ts

@@ -7,10 +7,10 @@ export declare const TaskEditOutputSchema: z.ZodObject<{
         title: z.ZodString;
         body: z.ZodOptional<z.ZodString>;
         phase: z.ZodEnum<{
+            review: "review";
             backlog: "backlog";
             ready: "ready";
             active: "active";
-            review: "review";
             closed: "closed";
         }>;
         resolution: z.ZodOptional<z.ZodEnum<{
@@ -78,10 +78,10 @@ export declare const TaskDeleteOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
         title: z.ZodString;
         body: z.ZodOptional<z.ZodString>;
         phase: z.ZodEnum<{
+            review: "review";
             backlog: "backlog";
             ready: "ready";
             active: "active";
-            review: "review";
             closed: "closed";
         }>;
         resolution: z.ZodOptional<z.ZodEnum<{

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 { TaskReadModelProjector } from "../task-read-model-projector.js";
 import { TaskConversationRepository } from "../task-conversation-repository.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/capabilities/relations.d.ts

@@ -7,10 +7,10 @@ export declare const TaskDependenciesOutputSchema: z.ZodObject<{
         title: z.ZodString;
         body: z.ZodOptional<z.ZodString>;
         phase: z.ZodEnum<{
+            review: "review";
             backlog: "backlog";
             ready: "ready";
             active: "active";
-            review: "review";
             closed: "closed";
         }>;
         resolution: z.ZodOptional<z.ZodEnum<{
@@ -74,10 +74,10 @@ export declare const TaskDependenciesOutputSchema: z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
         phase: z.ZodEnum<{
+            review: "review";
             backlog: "backlog";
             ready: "ready";
             active: "active";
-            review: "review";
             closed: "closed";
         }>;
         resolution: z.ZodOptional<z.ZodEnum<{
@@ -119,10 +119,10 @@ export declare const TaskDependenciesOutputSchema: z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
         phase: z.ZodEnum<{
+            review: "review";
             backlog: "backlog";
             ready: "ready";
             active: "active";
-            review: "review";
             closed: "closed";
         }>;
         resolution: z.ZodOptional<z.ZodEnum<{
@@ -174,15 +174,15 @@ export declare const TaskContextMutationOutputSchema: z.ZodObject<{
             task: "task";
             file: "file";
             memory: "memory";
-            document: "document";
             url: "url";
+            document: "document";
             source: "source";
             artifact: "artifact";
         }>;
         targetId: z.ZodString;
         role: z.ZodEnum<{
-            evidence: "evidence";
             input: "input";
+            evidence: "evidence";
             deliverable: "deliverable";
             reference: "reference";
             constraint: "constraint";
@@ -211,15 +211,15 @@ export declare const TaskContextMutationOutputSchema: z.ZodObject<{
             task: "task";
             file: "file";
             memory: "memory";
-            document: "document";
             url: "url";
+            document: "document";
             source: "source";
             artifact: "artifact";
         }>;
         targetId: z.ZodString;
         role: z.ZodEnum<{
-            evidence: "evidence";
             input: "input";
+            evidence: "evidence";
             deliverable: "deliverable";
             reference: "reference";
             constraint: "constraint";

package/dist/src/tasks/capabilities/write.d.ts

@@ -11,10 +11,10 @@ export declare const TaskMutationOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObj
             title: z.ZodString;
             body: z.ZodOptional<z.ZodString>;
             phase: z.ZodEnum<{
+                review: "review";
                 backlog: "backlog";
                 ready: "ready";
                 active: "active";
-                review: "review";
                 closed: "closed";
             }>;
             resolution: z.ZodOptional<z.ZodEnum<{
@@ -134,10 +134,10 @@ export declare const TaskMutationOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObj
             title: z.ZodString;
             body: z.ZodOptional<z.ZodString>;
             phase: z.ZodEnum<{
+                review: "review";
                 backlog: "backlog";
                 ready: "ready";
                 active: "active";
-                review: "review";
                 closed: "closed";
             }>;
             resolution: z.ZodOptional<z.ZodEnum<{

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

@@ -2,9 +2,9 @@ import { TaskCommandRequestSchema, TaskCreateRequestSchema, TaskDetailResponseSc
 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 { resolveTaskLocale } from "../task-language.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { defineAtomicCapability } from "../../capabilities/runtime/dispatcher.js";
-import { resolveTaskLocale } from "../task-language.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import { resolveResponseLanguageForSession } from "../../agent/prompt/response-language.js";
 import { TaskApplicationService } from "../task-application-service.js";

package/dist/src/tasks/index.js

@@ -3,6 +3,7 @@ import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import { TaskConversationConflictError, TaskConversationRepository } from "./task-conversation-repository.js";
+import { defineTaskContract } from "./task-contract-definition.js";
 import { TaskContextRepository } from "./task-context-repository.js";
 import { TaskDependencyError, TaskDependencyService } from "./task-dependency-service.js";
 import { TaskValueMetricsService } from "./task-value-metrics-service.js";
@@ -13,7 +14,6 @@ import { resolveExecutionContext } from "./execution-context.js";
 import { AttentionGovernor } from "./attention-governor.js";
 import { HomeQueryService, buildHomeWorkbench, decisionFromTask } from "./home-query-service.js";
 import { TaskWorkflowCoordinator } from "./task-workflow-coordinator.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";

package/dist/src/tasks/task-allocation-service.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { type MatchingContext, type SpecialistAssessment } from '../agent-matching/service.js';
 import { TaskRepository } from './task-repository.js';
+import { type TaskContractPlanner } from './task-contract-planner.js';
 declare const DecisionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"select">;
     agentId: z.ZodString;
@@ -26,6 +27,7 @@ export declare class TaskAllocationDispatcher {
     constructor(deps: {
         context: (conversationId: string) => MatchingContext;
         decide?: (input: AllocationDecisionInput) => Promise<AllocationDecision>;
+        planner?: TaskContractPlanner;
         wake: () => void;
     });
     dispatch(): void;