@xopcai/xopc 0.0.227 → 0.0.228

package/dist/packages/gateway-contract/src/turn-outcome.js

@@ -0,0 +1,114 @@
+import { z } from "zod";
+const TurnOutcomeDeliverableKindSchema = z.enum([
+	"document",
+	"spreadsheet",
+	"presentation",
+	"pdf",
+	"image",
+	"video",
+	"audio",
+	"site",
+	"archive",
+	"file"
+]);
+const TurnOutcomeArtifactLocationSchema = z.enum([
+	"workspace",
+	"external_host",
+	"worktree",
+	"remote_runtime",
+	"artifact_store"
+]);
+const TurnOutcomeArtifactAvailabilitySchema = z.enum([
+	"materializing",
+	"available",
+	"expired",
+	"missing",
+	"failed"
+]);
+const TurnOutcomeArtifactCapabilitySchema = z.enum([
+	"preview",
+	"download",
+	"open",
+	"import",
+	"share",
+	"regenerate"
+]);
+const TurnOutcomeDeliverableSchema = z.object({
+	artifactId: z.string().min(1),
+	title: z.string().min(1),
+	kind: TurnOutcomeDeliverableKindSchema,
+	mimeType: z.string().optional(),
+	sizeBytes: z.number().nonnegative().optional(),
+	availability: TurnOutcomeArtifactAvailabilitySchema,
+	location: TurnOutcomeArtifactLocationSchema,
+	capabilities: z.array(TurnOutcomeArtifactCapabilitySchema),
+	uri: z.string().optional(),
+	workspaceRelativePath: z.string().optional(),
+	shareUrl: z.string().url().optional(),
+	thumbnailUrl: z.string().optional(),
+	expiresAt: z.string().optional()
+});
+const TurnOutcomeChangedFileSchema = z.object({
+	path: z.string().min(1),
+	status: z.enum([
+		"added",
+		"modified",
+		"deleted",
+		"renamed"
+	]).optional(),
+	added: z.number().nonnegative().optional(),
+	removed: z.number().nonnegative().optional()
+});
+const TurnOutcomeChangeSetSchema = z.object({
+	changeSetId: z.string().min(1),
+	files: z.array(TurnOutcomeChangedFileSchema),
+	added: z.number().nonnegative(),
+	removed: z.number().nonnegative(),
+	diff: z.string(),
+	diffTruncated: z.boolean().optional(),
+	environment: z.enum([
+		"workspace",
+		"worktree",
+		"remote_runtime"
+	])
+});
+const TurnOutcomeEvidenceSchema = z.object({
+	evidenceId: z.string().min(1),
+	kind: z.enum([
+		"check",
+		"screenshot",
+		"video",
+		"log"
+	]),
+	label: z.string().min(1),
+	status: z.enum([
+		"passed",
+		"failed",
+		"warning"
+	]),
+	durationMs: z.number().nonnegative().optional(),
+	command: z.string().optional(),
+	artifactId: z.string().optional()
+});
+const TurnOutcomeSchema = z.object({
+	version: z.literal(1),
+	outcomeId: z.string().min(1),
+	runId: z.string().min(1),
+	turnId: z.string().min(1),
+	status: z.enum([
+		"succeeded",
+		"partial",
+		"failed"
+	]),
+	summary: z.string().optional(),
+	deliverables: z.array(TurnOutcomeDeliverableSchema),
+	changeSet: TurnOutcomeChangeSetSchema.optional(),
+	evidence: z.array(TurnOutcomeEvidenceSchema),
+	createdAt: z.string()
+});
+function parseTurnOutcome(value) {
+	const parsed = TurnOutcomeSchema.safeParse(value);
+	return parsed.success ? parsed.data : null;
+}
+//#endregion
+export { TurnOutcomeDeliverableSchema, parseTurnOutcome };

package/dist/src/agent/lifecycle/timeout-wrapper.d.ts

@@ -14,6 +14,7 @@ export interface TimeoutConfig {
     networkTimeoutMs: number;
     gracefulShutdownMs: number;
 }
+export declare const DEFAULT_TOOL_EXECUTION_TIMEOUT_MS: number;
 declare const DEFAULT_CONFIG: TimeoutConfig;
 export interface TimeoutResult<T> {
     success: boolean;

package/dist/src/agent/lifecycle/timeout-wrapper.js

@@ -3,12 +3,13 @@ import { init_logger } from "../../utils/logger.js";
 //#region src/agent/lifecycle/timeout-wrapper.ts
 init_logger();
 const log = createLogger("TimeoutWrapper");
+const DEFAULT_TOOL_EXECUTION_TIMEOUT_MS = 1800 * 1e3;
 const DEFAULT_CONFIG = {
-	defaultTimeoutMs: 300 * 1e3,
-	shellTimeoutMs: 300 * 1e3,
-	readTimeoutMs: 30 * 1e3,
-	writeTimeoutMs: 60 * 1e3,
-	networkTimeoutMs: 60 * 1e3,
+	defaultTimeoutMs: DEFAULT_TOOL_EXECUTION_TIMEOUT_MS,
+	shellTimeoutMs: DEFAULT_TOOL_EXECUTION_TIMEOUT_MS,
+	readTimeoutMs: DEFAULT_TOOL_EXECUTION_TIMEOUT_MS,
+	writeTimeoutMs: DEFAULT_TOOL_EXECUTION_TIMEOUT_MS,
+	networkTimeoutMs: DEFAULT_TOOL_EXECUTION_TIMEOUT_MS,
 	gracefulShutdownMs: 5e3
 };
 /**
@@ -254,4 +255,4 @@ var TimeoutManager = class {
 	}
 };
 //#endregion
-export { DEFAULT_CONFIG as DEFAULT_TIMEOUT_CONFIG, TimeoutError, TimeoutManager, executeWithTimeout, executeWithTimeoutResult, withTimeout };
+export { DEFAULT_CONFIG as DEFAULT_TIMEOUT_CONFIG, DEFAULT_TOOL_EXECUTION_TIMEOUT_MS, TimeoutError, TimeoutManager, executeWithTimeout, executeWithTimeoutResult, withTimeout };

package/dist/src/agent/mcp/mcp-transport-config.d.ts

@@ -23,6 +23,6 @@ export type ResolvedHttpMcpTransportConfig = ResolvedBaseMcpTransportConfig & {
     };
 };
 export type ResolvedMcpTransportConfig = ResolvedStdioMcpTransportConfig | ResolvedHttpMcpTransportConfig;
-export declare const DEFAULT_MCP_REQUEST_TIMEOUT_MS = 60000;
+export declare const DEFAULT_MCP_REQUEST_TIMEOUT_MS: number;
 export declare function resolveMcpTransportConfig(serverName: string, rawServer: unknown): ResolvedMcpTransportConfig | null;
 export {};

package/dist/src/agent/mcp/mcp-transport-config.js

@@ -10,7 +10,7 @@ init_logger();
 init_string_coerce();
 const log = createLogger("Mcp:Bundle");
 const DEFAULT_CONNECTION_TIMEOUT_MS = 3e4;
-const DEFAULT_MCP_REQUEST_TIMEOUT_MS = 6e4;
+const DEFAULT_MCP_REQUEST_TIMEOUT_MS = 1800 * 1e3;
 function getConnectionTimeoutMs(rawServer) {
 	if (rawServer && typeof rawServer === "object" && typeof rawServer.connectionTimeoutMs === "number" && rawServer.connectionTimeoutMs > 0) return rawServer.connectionTimeoutMs;
 	return DEFAULT_CONNECTION_TIMEOUT_MS;

package/dist/src/agent/orchestration/run-agent-turn-with-timeout.d.ts

@@ -6,9 +6,9 @@ import type { Agent } from '@earendil-works/pi-agent-core';
 import type { Config } from '../../config/schema.js';
 /** Minimum per-turn timeout (1 minute). */
 export declare const MIN_AGENT_TURN_TIMEOUT_MS = 60000;
-/** Maximum per-turn timeout (4 hours), aligned with `maxTaskDurationMs` schema cap. */
+/** Maximum configurable per-turn timeout (24 hours). */
 export declare const MAX_AGENT_TURN_TIMEOUT_MS: number;
-/** Default per-turn timeout (30 minutes). */
+/** Default per-turn timeout (4 hours). */
 export declare const DEFAULT_AGENT_TURN_TIMEOUT_MS: number;
 export declare const DEFAULT_AGENT_ABORT_GRACE_MS = 5000;
 export declare class AgentTurnUnsettledError extends Error {

package/dist/src/agent/orchestration/run-agent-turn-with-timeout.js

@@ -2,10 +2,10 @@ import { resolveEffectiveAgentManifestForSession } from "../../config/agent-prof
 //#region src/agent/orchestration/run-agent-turn-with-timeout.ts
 /** Minimum per-turn timeout (1 minute). */
 const MIN_AGENT_TURN_TIMEOUT_MS = 6e4;
-/** Maximum per-turn timeout (4 hours), aligned with `maxTaskDurationMs` schema cap. */
-const MAX_AGENT_TURN_TIMEOUT_MS = 14400 * 1e3;
-/** Default per-turn timeout (30 minutes). */
-const DEFAULT_AGENT_TURN_TIMEOUT_MS = 1800 * 1e3;
+/** Maximum configurable per-turn timeout (24 hours). */
+const MAX_AGENT_TURN_TIMEOUT_MS = 1440 * 60 * 1e3;
+/** Default per-turn timeout (4 hours). */
+const DEFAULT_AGENT_TURN_TIMEOUT_MS = 14400 * 1e3;
 const DEFAULT_AGENT_ABORT_GRACE_MS = 5e3;
 var AgentTurnUnsettledError = class extends Error {
 	constructor(timeoutMs, abortGraceMs) {

package/dist/src/agent/tools/create-share-tool.js

@@ -226,7 +226,20 @@ function successResult(locale, payload) {
 				isPublic: payload.reachability === "public"
 			}).filter(Boolean).join("\n")
 		}],
-		details: payload
+		details: {
+			...payload,
+			artifacts: [{
+				artifactId: `share:${String(payload.shareUrl ?? "")}`,
+				title: String(payload.title ?? "Shared result"),
+				kind: payload.kind === "site" ? "site" : payload.kind === "zip" ? "archive" : "file",
+				availability: "available",
+				location: "artifact_store",
+				capabilities: payload.kind === "site" ? ["preview", "share"] : ["download", "share"],
+				shareUrl: String(payload.shareUrl ?? ""),
+				...typeof payload.thumbnailUrl === "string" ? { thumbnailUrl: payload.thumbnailUrl } : {},
+				...typeof payload.expiresAt === "string" ? { expiresAt: payload.expiresAt } : {}
+			}]
+		}
 	};
 }
 function errorResult(locale, message) {

package/dist/src/agent/tools/exec-command.js

@@ -4,14 +4,14 @@ import { resolve } from "node:path";
 import { spawn } from "node:child_process";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/exec-command.ts
-const MAX_COMMAND_TIMEOUT_MS = 3e5;
-const DEFAULT_TIMEOUT_MS = 12e4;
+const MAX_COMMAND_TIMEOUT_MS = 14400 * 1e3;
+const DEFAULT_TIMEOUT_MS = 1800 * 1e3;
 const DEFAULT_MAX_OUTPUT_CHARS = 5e4;
 const STREAM_DELTA_MAX_CHARS = 16e3;
 const ExecCommandSchema = Type.Object({
 	cmd: Type.String({ description: "Shell command to execute." }),
 	cwd: Type.Optional(Type.String({ description: "Working directory. Relative paths are resolved under the agent workspace." })),
-	timeoutMs: Type.Optional(Type.Number({ description: "Command timeout in milliseconds. Defaults to 120000 and is capped at 300000." })),
+	timeoutMs: Type.Optional(Type.Number({ description: "Command timeout in milliseconds. Defaults to 1800000 (30m) and is capped at 14400000 (4h)." })),
 	maxOutputChars: Type.Optional(Type.Number({ description: "Maximum characters returned to the model. UI streaming still receives output deltas." }))
 });
 function clampTimeoutMs(raw) {

package/dist/src/agent/tools/execute-code-tool.js

@@ -12,7 +12,7 @@ const MAX_TIMEOUT_SEC = 14400;
 const ExecuteCodeSchema = Type.Object({
 	code: Type.String({ description: "JavaScript to run. Exposed as `tools` (async functions) and `console`:\n  await tools.web_search(query, count?)\n  await tools.web_fetch(url, maxChars?)\n  await tools.read_file(path, limit?)\n  await tools.write_file(path, content)\n  await tools.grep(pattern, { path?, glob?, ignoreCase?, literal?, context?, limit? })\n  await tools.find(pattern, { path?, limit? })\n  await tools.exec_command(cmd, cwd?)\n\nUse console.log() for output; combined stdout/stderr is returned." }),
 	timeout: Type.Optional(Type.Number({
-		description: "Execution timeout in seconds (default: 3600 = 60m, max: 14400 = 4h)",
+		description: "Execution timeout in seconds (default: 1800 = 30m, max: 14400 = 4h)",
 		default: DEFAULT_TIMEOUT_SEC
 	}))
 });

package/dist/src/agent/tools/executor.js

@@ -1,13 +1,13 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { TimeoutError, executeWithTimeout } from "../lifecycle/timeout-wrapper.js";
+import { DEFAULT_TOOL_EXECUTION_TIMEOUT_MS, TimeoutError, executeWithTimeout } from "../lifecycle/timeout-wrapper.js";
 import { withRetry } from "../../infra/retry.js";
 import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
 //#region src/agent/tools/executor.ts
 init_logger();
 const log = createLogger("ToolExecutor");
 const DEFAULT_CONFIG = {
-	defaultTimeoutMs: 300 * 1e3,
+	defaultTimeoutMs: DEFAULT_TOOL_EXECUTION_TIMEOUT_MS,
 	maxRetries: 2,
 	retryDelayMs: 1e3,
 	enableTimeout: true,

package/dist/src/agent/tools/image-generate-tool.js

@@ -296,6 +296,18 @@ function createImageGenerateTool(options) {
 						paths,
 						workspaceRelativePaths,
 						media,
+						artifacts: media.map((item, index) => ({
+							artifactId: item.id,
+							title: item.name,
+							kind: "image",
+							mimeType: item.mimeType,
+							sizeBytes: item.size,
+							availability: "available",
+							location: "artifact_store",
+							capabilities: ["preview", "download"],
+							uri: item.uri,
+							workspaceRelativePath: workspaceRelativePaths[index]
+						})),
 						attempts: result.attempts,
 						...result.normalization ? { normalization: result.normalization } : {},
 						...result.ignoredOverrides.length > 0 ? { ignoredOverrides: result.ignoredOverrides } : {},

package/dist/src/agent/tools/send-media.js

@@ -64,6 +64,17 @@ function createSendMediaTool(workspace, bus, getContext) {
 					}],
 					details: {
 						media: [media],
+						artifacts: [{
+							artifactId: media.id,
+							title: media.name,
+							kind: media.type === "photo" ? "image" : media.type === "video" ? "video" : media.type === "audio" ? "audio" : media.mimeType === "application/pdf" ? "pdf" : "file",
+							mimeType: media.mimeType,
+							sizeBytes: media.size,
+							availability: "available",
+							location: "artifact_store",
+							capabilities: ["preview", "download"],
+							uri: media.uri
+						}],
 						...p.caption ? { caption: p.caption } : {}
 					}
 				};

package/dist/src/agent/tools/xopc-use-tool.js

@@ -6,6 +6,7 @@ import { ObjectLinkService } from "../../activity/service.js";
 import "../../activity/index.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
+import { enqueueTaskChangedEvent } from "../../tasks/task-change-events.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
 import { TaskCommandSchema, TaskContextInputSchema } from "../../../packages/gateway-contract/src/tasks.js";
@@ -15,7 +16,6 @@ import "../../automations/index.js";
 import { isValidProjectAgentId, normalizeProjectAgentId, resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
 import { TaskContextRepository } from "../../tasks/task-context-repository.js";
-import { enqueueTaskChangedEvent } from "../../tasks/task-change-events.js";
 import { TaskDependencyError, TaskDependencyService } from "../../tasks/task-dependency-service.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
 import { defineTaskContract } from "../../tasks/task-contract-definition.js";

package/dist/src/cli/command-loaders.js

@@ -11,6 +11,7 @@ const REGISTRY_COMMAND_MODULES = {
 	tui: () => import("./commands/tui.js"),
 	resume: () => import("./commands/resume.js"),
 	gateway: () => import("./commands/gateway.js"),
+	history: () => import("./commands/history.js"),
 	session: () => import("./commands/session.js"),
 	project: () => import("./commands/project.js"),
 	config: () => import("./commands/config.js"),

package/dist/src/cli/command-manifest.js

@@ -67,6 +67,10 @@ const ROOT_HELP_COMMANDS = [
 		name: "gateway [options]",
 		description: "Start the xopc gateway server"
 	},
+	{
+		name: "history",
+		description: "Export XOPC session history for external tools"
+	},
 	{
 		name: "session",
 		description: "Session management commands"

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v135).`,
+		message: `SQLite schema v${status.dbVersion} (current release v136).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/history.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/cli/commands/history.js

@@ -0,0 +1,50 @@
+import { requireXopcDatabase } from "../../storage/sqlite/connection.js";
+import "../../storage/sqlite/index.js";
+import { formatExamples, register } from "../registry.js";
+import { exportCtxHistory } from "../../history/ctx/exporter.js";
+import { Command } from "commander";
+//#region src/cli/commands/history.ts
+async function runCtxExport(options) {
+	try {
+		const { db } = requireXopcDatabase();
+		const result = await exportCtxHistory(db, { outputDir: options.outputDir });
+		const importCommand = `ctx import --history-source-manifest ${result.manifestPath}`;
+		if (options.json) {
+			console.log(JSON.stringify({
+				...result,
+				importCommand
+			}, null, 2));
+			return;
+		}
+		const action = result.changed ? "Exported" : "Already up to date";
+		console.log(`${action}: ${result.sessionCount} sessions, ${result.eventCount} events`);
+		console.log(`History: ${result.historyPath}`);
+		console.log(`Manifest: ${result.manifestPath}`);
+		console.log(`\nRegister or refresh it in ctx:\n  ${importCommand}`);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		console.error(`Failed to export history for ctx: ${message}`);
+		process.exit(1);
+	}
+}
+function createHistoryCommand(_ctx) {
+	const command = new Command("history").description("Export XOPC session history for external tools").addHelpText("after", formatExamples([
+		"xopc history export ctx",
+		"xopc history export ctx --output-dir ./xopc-ctx-history",
+		"xopc history export ctx --json"
+	]));
+	command.command("export").description("Export session history").command("ctx").description("Export a provider-owned ctx-history-jsonl-v2 source").option("--output-dir <path>", "Output directory (default: <xopc-state>/exports/ctx)").option("--json", "Output the result as JSON").action(runCtxExport);
+	return command;
+}
+register({
+	id: "history",
+	name: "history",
+	description: "Export XOPC session history for external tools",
+	factory: createHistoryCommand,
+	metadata: {
+		category: "utility",
+		examples: ["xopc history export ctx"]
+	}
+});
+//#endregion
+export {};

package/dist/src/config/agent-profile.js

@@ -1,6 +1,6 @@
+import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import "../agent-manifest/index.js";
-import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts

package/dist/src/gateway/agents-admin.js

@@ -1,5 +1,5 @@
-import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
+import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";

package/dist/src/gateway/chat-stream/protocol.d.ts

@@ -1,4 +1,4 @@
-import type { ToolActivity } from '@xopcai/gateway-contract';
+import type { ToolActivity, TurnOutcome } from '@xopcai/gateway-contract';
 export type ChatStreamStatus = 'success' | 'error' | 'cancelled';
 export type PetFeedbackTaskState = 'working' | 'waiting' | 'success' | 'error';
 export type PetFeedbackSensitivity = 'public' | 'private';
@@ -142,6 +142,7 @@ export type TurnDiffEvent = ChatStreamEnvelope<'turn_diff', {
     added: number;
     removed: number;
 }>;
+export type TurnOutcomeEvent = ChatStreamEnvelope<'turn_outcome', TurnOutcome>;
 export type ReviewStartEvent = ChatStreamEnvelope<'review_start', {
     messageId: string;
     reviewId: string;
@@ -237,4 +238,4 @@ export type StreamErrorEvent = ChatStreamEnvelope<'error', {
     recoverable?: boolean;
     petFeedback: PetFeedback;
 }>;
-export type ChatStreamEvent = RunStartEvent | UserMessageEvent | UserTranscriptEvent | AssistantMessageStartEvent | AssistantDeltaEvent | ThinkingDeltaEvent | ThinkingEndEvent | ToolStartEvent | ToolUpdateEvent | ToolEndEvent | CommandStartedEvent | CommandOutputDeltaEvent | CommandCompletedEvent | PatchAppliedEvent | TurnPlanUpdatedEvent | TaskPlanUpdatedEvent | TurnDiffEvent | ReviewStartEvent | ReviewDeltaEvent | ReviewEndEvent | ReviewEvent | AssistantMessageEndEvent | ProgressEvent | CompactionEvent | TtsAudioEvent | ClarifyRequestEvent | MemoryConsentRequiredEvent | MemoryCapturedEvent | MemoryCandidateEvent | RunEndEvent | StreamErrorEvent;
+export type ChatStreamEvent = RunStartEvent | UserMessageEvent | UserTranscriptEvent | AssistantMessageStartEvent | AssistantDeltaEvent | ThinkingDeltaEvent | ThinkingEndEvent | ToolStartEvent | ToolUpdateEvent | ToolEndEvent | CommandStartedEvent | CommandOutputDeltaEvent | CommandCompletedEvent | PatchAppliedEvent | TurnPlanUpdatedEvent | TaskPlanUpdatedEvent | TurnDiffEvent | TurnOutcomeEvent | ReviewStartEvent | ReviewDeltaEvent | ReviewEndEvent | ReviewEvent | AssistantMessageEndEvent | ProgressEvent | CompactionEvent | TtsAudioEvent | ClarifyRequestEvent | MemoryConsentRequiredEvent | MemoryCapturedEvent | MemoryCandidateEvent | RunEndEvent | StreamErrorEvent;

package/dist/src/gateway/chat-stream/turn-outcome-collector.d.ts

@@ -0,0 +1,16 @@
+import type { AgentStreamRunStatus, TurnOutcome } from '@xopcai/gateway-contract';
+import type { ChatStreamEvent } from './protocol.js';
+export declare class TurnOutcomeCollector {
+    private readonly runId;
+    private readonly environment;
+    private readonly deliverables;
+    private readonly evidence;
+    private readonly files;
+    private readonly diffs;
+    private added;
+    private removed;
+    private failedToolCount;
+    constructor(runId: string, environment?: 'workspace' | 'worktree' | 'remote_runtime');
+    capture(event: ChatStreamEvent): void;
+    finalize(status: AgentStreamRunStatus, summary?: string): TurnOutcome;
+}

package/dist/src/gateway/chat-stream/turn-outcome-collector.js

@@ -0,0 +1,111 @@
+import { TurnOutcomeDeliverableSchema } from "../../../packages/gateway-contract/src/turn-outcome.js";
+//#region src/gateway/chat-stream/turn-outcome-collector.ts
+const VERIFICATION_COMMAND = /(^|[\s:/_-])(test|vitest|jest|pytest|lint|typecheck|type-check|build)([\s:/_-]|$)/i;
+const MAX_OUTCOME_DIFF_CHARS = 2e5;
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function optionalString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function fileStatus(kind) {
+	if (kind === "add") return "added";
+	if (kind === "delete") return "deleted";
+	if (kind === "move") return "renamed";
+	if (kind === "update") return "modified";
+}
+function changedFiles(changes) {
+	return changes.flatMap((value) => {
+		const row = asRecord(value);
+		const path = optionalString(row?.moveTo) ?? optionalString(row?.path);
+		if (!path) return [];
+		return [{
+			path,
+			...fileStatus(row?.kind) ? { status: fileStatus(row?.kind) } : {},
+			...typeof row?.added === "number" ? { added: Math.max(0, row.added) } : {},
+			...typeof row?.removed === "number" ? { removed: Math.max(0, row.removed) } : {}
+		}];
+	});
+}
+function structuredDeliverables(details) {
+	if (!Array.isArray(details.artifacts)) return [];
+	return details.artifacts.flatMap((value) => {
+		const parsed = TurnOutcomeDeliverableSchema.safeParse(value);
+		return parsed.success ? [parsed.data] : [];
+	});
+}
+var TurnOutcomeCollector = class {
+	deliverables = /* @__PURE__ */ new Map();
+	evidence = /* @__PURE__ */ new Map();
+	files = /* @__PURE__ */ new Map();
+	diffs = [];
+	added = 0;
+	removed = 0;
+	failedToolCount = 0;
+	constructor(runId, environment = "workspace") {
+		this.runId = runId;
+		this.environment = environment;
+	}
+	capture(event) {
+		if (event.type === "tool_end") {
+			if (event.payload.status !== "success") {
+				this.failedToolCount += 1;
+				return;
+			}
+			const details = asRecord(event.payload.result?.details);
+			if (!details) return;
+			for (const artifact of structuredDeliverables(details)) this.deliverables.set(artifact.artifactId, artifact);
+			return;
+		}
+		if (event.type === "patch_applied") {
+			for (const file of changedFiles(event.payload.changes)) this.files.set(file.path, file);
+			return;
+		}
+		if (event.type === "turn_diff") {
+			for (const path of event.payload.files) if (!this.files.has(path)) this.files.set(path, { path });
+			if (event.payload.diff.trim()) this.diffs.push(event.payload.diff);
+			this.added += Math.max(0, event.payload.added);
+			this.removed += Math.max(0, event.payload.removed);
+			return;
+		}
+		if (event.type === "command_completed" && VERIFICATION_COMMAND.test(event.payload.command)) {
+			const status = event.payload.exitCode === 0 && !event.payload.timedOut ? "passed" : "failed";
+			this.evidence.set(event.payload.toolCallId, {
+				evidenceId: `${this.runId}:${event.payload.toolCallId}:check`,
+				kind: "check",
+				label: event.payload.command,
+				status,
+				command: event.payload.command,
+				...event.payload.durationMs !== void 0 ? { durationMs: event.payload.durationMs } : {}
+			});
+		}
+	}
+	finalize(status, summary) {
+		const evidence = [...this.evidence.values()];
+		const partial = this.failedToolCount > 0 || evidence.some((item) => item.status === "failed");
+		const fullDiff = this.diffs.join("\n");
+		const diffTruncated = fullDiff.length > MAX_OUTCOME_DIFF_CHARS;
+		return {
+			version: 1,
+			outcomeId: `${this.runId}:outcome`,
+			runId: this.runId,
+			turnId: this.runId,
+			status: status === "error" ? "failed" : status === "cancelled" || partial ? "partial" : "succeeded",
+			...summary?.trim() ? { summary: summary.trim() } : {},
+			deliverables: [...this.deliverables.values()],
+			...this.files.size > 0 || this.diffs.length > 0 ? { changeSet: {
+				changeSetId: `${this.runId}:changes`,
+				files: [...this.files.values()],
+				added: this.added,
+				removed: this.removed,
+				diff: diffTruncated ? fullDiff.slice(0, MAX_OUTCOME_DIFF_CHARS) : fullDiff,
+				...diffTruncated ? { diffTruncated: true } : {},
+				environment: this.environment
+			} } : {},
+			evidence,
+			createdAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+	}
+};
+//#endregion
+export { TurnOutcomeCollector };

package/dist/src/gateway/hono/lib/static-ui.js

@@ -52,7 +52,7 @@ function resolveCacheControl(relativePath) {
 function resolveContentType(relativePath) {
 	return MIME_TYPES[relativePath.split(".").pop()?.toLowerCase() || ""] || "application/octet-stream";
 }
-function loadIntoCache(relativePath) {
+function readStaticFile(relativePath, cache) {
 	const filePath = resolve(UI_STATIC_ROOT, relativePath);
 	try {
 		const content = readFileSync(filePath);
@@ -62,8 +62,10 @@ function loadIntoCache(relativePath) {
 			etag: computeEtag(content),
 			cacheControl: resolveCacheControl(relativePath)
 		};
-		fileCache.set(relativePath, cached);
-		stats.entries = fileCache.size;
+		if (cache) {
+			fileCache.set(relativePath, cached);
+			stats.entries = fileCache.size;
+		}
 		stats.misses += 1;
 		return cached;
 	} catch {
@@ -71,12 +73,13 @@ function loadIntoCache(relativePath) {
 	}
 }
 function getCachedFile(relativePath) {
+	if (relativePath === "index.html") return readStaticFile(relativePath, false);
 	const cached = fileCache.get(relativePath);
 	if (cached) {
 		stats.hits += 1;
 		return cached;
 	}
-	return loadIntoCache(relativePath);
+	return readStaticFile(relativePath, true);
 }
 function getStaticUiCacheStats() {
 	return { ...stats };
@@ -92,7 +95,6 @@ function resolveStaticUiRootForTests() {
 	return UI_STATIC_ROOT;
 }
 const DEFAULT_PREWARM_PATHS = [
-	"index.html",
 	"favicon.ico",
 	"logo.svg",
 	"logo-dark.svg"

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

@@ -8,6 +8,7 @@ import { registerProjectsRoutes } from "./projects.js";
 import { registerProjectSkillRoutes } from "./project-skills.js";
 import { registerSearchRoutes } from "./search.js";
 import { registerMobileRoutes } from "./mobile.js";
+import { registerNotificationRoutes } from "./notifications.js";
 import { registerInteractionStateRoutes } from "./interaction-state.js";
 import { registerComposerHistoryRoutes } from "./composer-history.js";
 import { registerEndpointToolRoutes } from "./endpoint-tools.js";
@@ -35,6 +36,7 @@ function registerCoreAuthenticatedRoutes(authenticated, deps) {
 	registerProactiveRoutes(authenticated, deps);
 	registerSearchRoutes(authenticated, deps);
 	registerMobileRoutes(authenticated, deps);
+	registerNotificationRoutes(authenticated, deps);
 	registerInteractionStateRoutes(authenticated, deps);
 	registerComposerHistoryRoutes(authenticated, deps);
 	registerEndpointToolRoutes(authenticated, deps);