@xopcai/xopc 0.0.321 → 0.0.323

package/dist/packages/gateway-contract/src/capabilities.js

@@ -2,13 +2,14 @@ import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { TaskPhaseSchema, TaskWaitSchema, init_task_lifecycle } from "./task-lifecycle.js";
 import { TaskRunEventSchema, TaskRunSchema, init_task_runs } from "./task-runs.js";
 import { TaskDetailResponseSchema, TaskListResponseSchema, TaskPrioritySchema, TaskRunReceiptSchema, init_tasks } from "./tasks.js";
+import { LocalAppDetailSchema, LocalAppRecordSchema, LocalAppValidationSchema, init_local_apps } from "./local-apps.js";
 import { TaskValueMetricsSchema, init_home } from "./home.js";
 import { AutomationMetricsSchema, AutomationRunEventSchema, AutomationRunSchema, AutomationSchema, init_automations } from "./automations.js";
 import { AppContextEnvelopeSchema, ResolvedAppContextSchema, init_app_context } from "./app-context.js";
 import { SceneActivationSchema, SceneConfigureSchema, SceneFeedbackSchema, ScenePreferencePatchSchema, SceneTransitionSchema, SceneWorkItemCreateSchema, SceneWorkItemSchema, SceneWorkItemUpdateSchema, activationInputSchema, init_scenes, sceneNotesSchema, scenePreferencesSchema, sceneScheduleSchema, sceneTemplateSchema } from "./scenes.js";
 import { z } from "zod";
 //#region packages/gateway-contract/src/capabilities.ts
-var CapabilityErrorCodeSchema, CapabilityCallSchema, AutomationSimulationSchema, AutomationDraftRequestSchema, AutomationDraftOutputSchema, AutomationRepairDraftOutputSchema, CapabilityResourceInputSchema, LocalAppAcceptanceInputSchema, LocalAppAcceptanceOutputSchema, ScenePageInputSchema, SceneWriteContracts, SceneOutcomeReadSchema, TaskRunCancelInputSchema, TaskRunFeedbackInputSchema, TaskRunFeedbackOutputSchema, TaskRunCancelOutputSchema, AutomationSetEnabledInputSchema, AutomationMutationOutputSchema, AutomationRunMutationOutputSchema, AutomationCancelOutputSchema, AutomationReadOutputSchema, AutomationReadAllInputSchema, AutomationReadAllOutputSchema, AutomationDeleteInputSchema, AutomationDeleteOutputSchema, NoteListInputSchema, NoteRecordSchema, NoteGetOutputSchema, NoteDeleteInputSchema, NoteDeleteOutputSchema, NoteCreateInputSchema, NoteUpdateInputSchema, NoteCaptureInputSchema, NoteAppendInputSchema, NoteRestoreInputSchema, NoteListOutputSchema, TaskListInputSchema, ProjectRecordSchema, ProjectSetPinnedInputSchema, ProjectMutationOutputSchema, ProjectResolveWorkspaceInputSchema, ProjectResolveWorkspaceOutputSchema, ProjectDeleteInputSchema, ProjectDeleteOutputSchema, ProjectFields, ProjectCreateInputSchema, ProjectEditInputSchema, ProjectListInputSchema, LocalAppRecordSchema, LocalAppDetailSchema, ProjectMilestoneSchema, LocalAppValidationSchema, ProjectUpdateSchema, MilestoneFields, ProjectMilestoneCreateInputSchema, ProjectMilestoneUpdateInputSchema, ProjectMilestoneDeleteInputSchema, ProjectMilestoneOutputSchema, ProjectMilestoneDeleteOutputSchema, ProjectUpdateCreateInputSchema, ProjectUpdateOutputSchema, ProductReadContracts;
+var CapabilityErrorCodeSchema, CapabilityCallSchema, AutomationSimulationSchema, AutomationDraftRequestSchema, AutomationDraftOutputSchema, AutomationRepairDraftOutputSchema, CapabilityResourceInputSchema, ScenePageInputSchema, SceneWriteContracts, SceneOutcomeReadSchema, TaskRunCancelInputSchema, TaskRunFeedbackInputSchema, TaskRunFeedbackOutputSchema, TaskRunCancelOutputSchema, AutomationSetEnabledInputSchema, AutomationMutationOutputSchema, AutomationRunMutationOutputSchema, AutomationCancelOutputSchema, AutomationReadOutputSchema, AutomationReadAllInputSchema, AutomationReadAllOutputSchema, AutomationDeleteInputSchema, AutomationDeleteOutputSchema, NoteListInputSchema, NoteRecordSchema, NoteGetOutputSchema, NoteDeleteInputSchema, NoteDeleteOutputSchema, NoteCreateInputSchema, NoteUpdateInputSchema, NoteCaptureInputSchema, NoteAppendInputSchema, NoteRestoreInputSchema, NoteListOutputSchema, TaskListInputSchema, ProjectRecordSchema, ProjectSetPinnedInputSchema, ProjectMutationOutputSchema, ProjectResolveWorkspaceInputSchema, ProjectResolveWorkspaceOutputSchema, ProjectDeleteInputSchema, ProjectDeleteOutputSchema, ProjectFields, ProjectCreateInputSchema, ProjectEditInputSchema, ProjectListInputSchema, ProjectMilestoneSchema, ProjectUpdateSchema, MilestoneFields, ProjectMilestoneCreateInputSchema, ProjectMilestoneUpdateInputSchema, ProjectMilestoneDeleteInputSchema, ProjectMilestoneOutputSchema, ProjectMilestoneDeleteOutputSchema, ProjectUpdateCreateInputSchema, ProjectUpdateOutputSchema, ProductReadContracts;
 var init_capabilities = __esmMin((() => {
 	init_app_context();
 	init_task_lifecycle();
@@ -17,6 +18,7 @@ var init_capabilities = __esmMin((() => {
 	init_automations();
 	init_home();
 	init_scenes();
+	init_local_apps();
 	z.enum([
 		"http",
 		"agent",
@@ -98,30 +100,6 @@ var init_capabilities = __esmMin((() => {
 		operationId: z.string().optional()
 	});
 	CapabilityResourceInputSchema = z.strictObject({ id: z.string().trim().min(1).max(512) });
-	LocalAppAcceptanceInputSchema = z.strictObject({
-		sourceHash: z.string().regex(/^[a-f0-9]{64}$/),
-		status: z.enum(["passed", "failed"]),
-		interactiveCount: z.number().int().min(0).max(1e4),
-		checks: z.array(z.strictObject({
-			id: z.enum([
-				"document",
-				"content",
-				"interaction",
-				"criteria"
-			]),
-			status: z.enum([
-				"passed",
-				"failed",
-				"skipped"
-			]),
-			message: z.string().trim().min(1).max(500)
-		})).min(3).max(4)
-	});
-	LocalAppAcceptanceOutputSchema = LocalAppAcceptanceInputSchema.extend({
-		id: z.string(),
-		appId: z.string(),
-		createdAt: z.number().int().nonnegative()
-	});
 	ScenePageInputSchema = z.strictObject({
 		limit: z.number().int().min(1).max(100).default(50),
 		afterId: z.string().max(200).default("")
@@ -512,59 +490,6 @@ var init_capabilities = __esmMin((() => {
 		limit: z.number().int().min(1).max(500).default(50),
 		offset: z.number().int().nonnegative().default(0)
 	});
-	LocalAppRecordSchema = z.looseObject({
-		id: z.string(),
-		extensionId: z.string(),
-		projectId: z.string(),
-		name: z.string(),
-		idea: z.string(),
-		status: z.enum([
-			"preview_ready",
-			"installed",
-			"degraded"
-		]),
-		workspaceRoot: z.string(),
-		draftVersion: z.number().int(),
-		installationState: z.enum(["not_installed", "installed"]),
-		enabled: z.boolean(),
-		createdAt: z.number(),
-		updatedAt: z.number()
-	});
-	LocalAppDetailSchema = LocalAppRecordSchema.extend({
-		previewUrl: z.string(),
-		permissions: z.array(z.string()),
-		releases: z.array(z.looseObject({
-			id: z.string(),
-			appId: z.string(),
-			version: z.number().int(),
-			sourceHash: z.string(),
-			healthStatus: z.enum(["healthy", "failed"]),
-			createdAt: z.number(),
-			isActive: z.boolean()
-		})),
-		acceptanceRuns: z.array(z.looseObject({
-			id: z.string(),
-			appId: z.string(),
-			sourceHash: z.string(),
-			status: z.enum(["passed", "failed"]),
-			createdAt: z.number(),
-			interactiveCount: z.number().int().nonnegative(),
-			checks: z.array(z.object({
-				id: z.enum([
-					"document",
-					"content",
-					"interaction",
-					"criteria"
-				]),
-				status: z.enum([
-					"passed",
-					"failed",
-					"skipped"
-				]),
-				message: z.string()
-			}))
-		}))
-	});
 	ProjectMilestoneSchema = z.looseObject({
 		id: z.string(),
 		projectId: z.string(),
@@ -579,37 +504,6 @@ var init_capabilities = __esmMin((() => {
 		createdAt: z.number(),
 		updatedAt: z.number()
 	});
-	LocalAppValidationSchema = z.object({
-		status: z.enum(["healthy", "failed"]),
-		checkedAt: z.number(),
-		sourceHash: z.string().optional(),
-		hasDraftChanges: z.boolean(),
-		changedFiles: z.array(z.object({
-			path: z.string(),
-			status: z.enum([
-				"added",
-				"modified",
-				"deleted"
-			])
-		})),
-		changedFileCount: z.number().int().nonnegative(),
-		permissions: z.array(z.string()),
-		permissionDelta: z.object({
-			added: z.array(z.string()),
-			removed: z.array(z.string())
-		}),
-		acceptanceScenarioCount: z.number().int().nonnegative(),
-		acceptanceScenarios: z.array(z.object({
-			id: z.string(),
-			name: z.string(),
-			stepCount: z.number().int().nonnegative()
-		})),
-		issues: z.array(z.object({
-			code: z.string(),
-			severity: z.enum(["error", "warning"]),
-			message: z.string()
-		}))
-	});
 	ProjectUpdateSchema = z.looseObject({
 		id: z.string(),
 		projectId: z.string(),
@@ -1075,4 +969,4 @@ var init_capabilities = __esmMin((() => {
 }));
 //#endregion
 init_capabilities();
-export { AutomationCancelOutputSchema, AutomationDeleteInputSchema, AutomationDeleteOutputSchema, AutomationDraftOutputSchema, AutomationDraftRequestSchema, AutomationMutationOutputSchema, AutomationReadAllInputSchema, AutomationReadAllOutputSchema, AutomationReadOutputSchema, AutomationRepairDraftOutputSchema, AutomationRunMutationOutputSchema, AutomationSetEnabledInputSchema, AutomationSimulationSchema, CapabilityCallSchema, CapabilityErrorCodeSchema, CapabilityResourceInputSchema, LocalAppAcceptanceInputSchema, LocalAppAcceptanceOutputSchema, LocalAppDetailSchema, LocalAppRecordSchema, LocalAppValidationSchema, NoteAppendInputSchema, NoteCaptureInputSchema, NoteCreateInputSchema, NoteDeleteInputSchema, NoteDeleteOutputSchema, NoteGetOutputSchema, NoteListInputSchema, NoteListOutputSchema, NoteRecordSchema, NoteRestoreInputSchema, NoteUpdateInputSchema, ProductReadContracts, ProjectCreateInputSchema, ProjectDeleteInputSchema, ProjectDeleteOutputSchema, ProjectEditInputSchema, ProjectListInputSchema, ProjectMilestoneCreateInputSchema, ProjectMilestoneDeleteInputSchema, ProjectMilestoneDeleteOutputSchema, ProjectMilestoneOutputSchema, ProjectMilestoneSchema, ProjectMilestoneUpdateInputSchema, ProjectMutationOutputSchema, ProjectRecordSchema, ProjectResolveWorkspaceInputSchema, ProjectResolveWorkspaceOutputSchema, ProjectSetPinnedInputSchema, ProjectUpdateCreateInputSchema, ProjectUpdateOutputSchema, ProjectUpdateSchema, ScenePageInputSchema, SceneWriteContracts, TaskListInputSchema, TaskRunCancelInputSchema, TaskRunCancelOutputSchema, TaskRunFeedbackInputSchema, TaskRunFeedbackOutputSchema, init_capabilities };
+export { AutomationCancelOutputSchema, AutomationDeleteInputSchema, AutomationDeleteOutputSchema, AutomationDraftOutputSchema, AutomationDraftRequestSchema, AutomationMutationOutputSchema, AutomationReadAllInputSchema, AutomationReadAllOutputSchema, AutomationReadOutputSchema, AutomationRepairDraftOutputSchema, AutomationRunMutationOutputSchema, AutomationSetEnabledInputSchema, AutomationSimulationSchema, CapabilityCallSchema, CapabilityErrorCodeSchema, CapabilityResourceInputSchema, NoteAppendInputSchema, NoteCaptureInputSchema, NoteCreateInputSchema, NoteDeleteInputSchema, NoteDeleteOutputSchema, NoteGetOutputSchema, NoteListInputSchema, NoteListOutputSchema, NoteRecordSchema, NoteRestoreInputSchema, NoteUpdateInputSchema, ProductReadContracts, ProjectCreateInputSchema, ProjectDeleteInputSchema, ProjectDeleteOutputSchema, ProjectEditInputSchema, ProjectListInputSchema, ProjectMilestoneCreateInputSchema, ProjectMilestoneDeleteInputSchema, ProjectMilestoneDeleteOutputSchema, ProjectMilestoneOutputSchema, ProjectMilestoneSchema, ProjectMilestoneUpdateInputSchema, ProjectMutationOutputSchema, ProjectRecordSchema, ProjectResolveWorkspaceInputSchema, ProjectResolveWorkspaceOutputSchema, ProjectSetPinnedInputSchema, ProjectUpdateCreateInputSchema, ProjectUpdateOutputSchema, ProjectUpdateSchema, ScenePageInputSchema, SceneWriteContracts, TaskListInputSchema, TaskRunCancelInputSchema, TaskRunCancelOutputSchema, TaskRunFeedbackInputSchema, TaskRunFeedbackOutputSchema, init_capabilities };

package/dist/packages/gateway-contract/src/chat-previews.js

@@ -0,0 +1,73 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { z } from "zod";
+//#region packages/gateway-contract/src/chat-previews.ts
+var CHAT_PREVIEW_MAX_SOURCE_SIZE, CHAT_PREVIEW_RUNTIME_SOURCE, ChatPreviewSourceHashSchema, ChatPreviewSourceSchema, ChatPreviewCreateInputSchema, ChatPreviewReviseInputSchema, ChatPreviewDiagnosticSchema, ChatPreviewFixGuidanceInputSchema, chatPreviewRuntimeEnvelope;
+var init_chat_previews = __esmMin((() => {
+	CHAT_PREVIEW_MAX_SOURCE_SIZE = 256 * 1024;
+	CHAT_PREVIEW_RUNTIME_SOURCE = "xopc-chat-preview";
+	ChatPreviewSourceHashSchema = z.string().regex(/^[a-f0-9]{64}$/);
+	ChatPreviewSourceSchema = z.strictObject({
+		markup: z.string().max(128 * 1024),
+		styles: z.string().max(128 * 1024).default(""),
+		script: z.string().max(128 * 1024).default("")
+	}).refine((source) => source.markup.length + source.styles.length + source.script.length <= CHAT_PREVIEW_MAX_SOURCE_SIZE, "Preview source exceeds the 256 KiB limit").refine((source) => !/<\/?(?:html|head|body|script|style)\b/i.test(source.markup), "Preview markup must be an HTML fragment; put CSS and JavaScript in their dedicated fields");
+	z.strictObject({
+		id: z.string().uuid(),
+		conversationId: z.string().uuid(),
+		title: z.string().trim().min(1).max(120),
+		preferredHeight: z.number().int().min(240).max(720),
+		latestRevision: ChatPreviewSourceHashSchema,
+		createdAt: z.number().int().nonnegative(),
+		updatedAt: z.number().int().nonnegative()
+	});
+	ChatPreviewSourceSchema.extend({
+		previewId: z.string().uuid(),
+		sourceHash: ChatPreviewSourceHashSchema,
+		createdAt: z.number().int().nonnegative()
+	});
+	ChatPreviewCreateInputSchema = ChatPreviewSourceSchema.extend({
+		title: z.string().trim().min(1).max(120),
+		preferredHeight: z.number().int().min(240).max(720).default(480)
+	});
+	ChatPreviewReviseInputSchema = ChatPreviewSourceSchema.extend({
+		baseRevision: ChatPreviewSourceHashSchema,
+		title: z.string().trim().min(1).max(120).optional(),
+		preferredHeight: z.number().int().min(240).max(720).optional()
+	});
+	ChatPreviewDiagnosticSchema = z.strictObject({
+		kind: z.enum(["script_error", "unhandled_rejection"]),
+		message: z.string().trim().min(1).max(500),
+		filename: z.string().max(500).optional(),
+		line: z.number().int().nonnegative().optional(),
+		column: z.number().int().nonnegative().optional()
+	});
+	ChatPreviewFixGuidanceInputSchema = z.strictObject({
+		sourceHash: ChatPreviewSourceHashSchema,
+		diagnostics: z.array(ChatPreviewDiagnosticSchema).min(1).max(20),
+		locale: z.enum(["en", "zh"]).default("en")
+	});
+	z.strictObject({
+		previewId: z.string().uuid(),
+		sourceHash: ChatPreviewSourceHashSchema,
+		prompt: z.string().min(1)
+	});
+	chatPreviewRuntimeEnvelope = z.strictObject({
+		source: z.literal(CHAT_PREVIEW_RUNTIME_SOURCE),
+		version: z.literal(1),
+		channel: z.string().uuid()
+	});
+	z.discriminatedUnion("type", [
+		chatPreviewRuntimeEnvelope.extend({ type: z.literal("ready") }),
+		chatPreviewRuntimeEnvelope.extend({
+			type: z.literal("resize"),
+			height: z.number().finite().min(120).max(2e3)
+		}),
+		chatPreviewRuntimeEnvelope.extend({
+			type: z.literal("error"),
+			diagnostic: ChatPreviewDiagnosticSchema
+		})
+	]);
+}));
+//#endregion
+init_chat_previews();
+export { CHAT_PREVIEW_MAX_SOURCE_SIZE, CHAT_PREVIEW_RUNTIME_SOURCE, ChatPreviewCreateInputSchema, ChatPreviewDiagnosticSchema, ChatPreviewFixGuidanceInputSchema, ChatPreviewReviseInputSchema, ChatPreviewSourceHashSchema, ChatPreviewSourceSchema, init_chat_previews };

package/dist/packages/gateway-contract/src/index.js

@@ -4,6 +4,8 @@ import { init_turn_outcome } from "./turn-outcome.js";
 import { init_task_lifecycle } from "./task-lifecycle.js";
 import { init_task_runs } from "./task-runs.js";
 import { init_tasks } from "./tasks.js";
+import { init_chat_previews } from "./chat-previews.js";
+import { init_local_apps } from "./local-apps.js";
 import { init_product_delivery } from "./product-delivery.js";
 import { init_project_monitoring } from "./project-monitoring.js";
 import { init_project_operating } from "./project-operating.js";
@@ -16,6 +18,7 @@ import { init_home } from "./home.js";
 import { init_tool_activity } from "./tool-activity.js";
 import { init_automations } from "./automations.js";
 import { init_user_message_display } from "./user-message-display.js";
+import { init_user_turn_document } from "./user-turn-document.js";
 import { init_new_session } from "./new-session.js";
 import { init_notifications } from "./notifications.js";
 import { init_files } from "./files.js";
@@ -52,6 +55,7 @@ var init_src = __esmMin((() => {
 	init_tool_activity();
 	init_automations();
 	init_user_message_display();
+	init_user_turn_document();
 	init_new_session();
 	init_notifications();
 	init_files();
@@ -69,6 +73,8 @@ var init_src = __esmMin((() => {
 	init_scenes();
 	init_app_context();
 	init_extension_capabilities();
+	init_local_apps();
+	init_chat_previews();
 }));
 //#endregion
 init_src();

package/dist/packages/gateway-contract/src/local-apps.js

@@ -0,0 +1,215 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { z } from "zod";
+//#region packages/gateway-contract/src/local-apps.ts
+var LocalAppSourceHashSchema, LocalAppStatusSchema, LocalAppInstallationStateSchema, LocalAppReleaseHealthSchema, LocalAppAcceptanceCheckSchema, LocalAppAcceptanceResultSchema, LocalAppAcceptanceInputSchema, LocalAppAcceptanceOutputSchema, LocalAppReleaseSchema, LocalAppRecordSchema, LocalAppAcceptanceRunSchema, LocalAppDetailSchema, LocalAppValidationIssueSchema, LocalAppChangedFileSchema, LocalAppAcceptanceScenarioSummarySchema, LocalAppValidationSchema, LocalAppPreviewSnapshotSchema, LocalAppDiagnosticPhaseSchema, LocalAppDiagnosticSchema, LocalAppFixGuidanceInputSchema, LocalAppRuntimeIssueSchema, LocalAppCriteriaScenarioResultSchema, LocalAppCriteriaResultSchema, runtimeEnvelope;
+var init_local_apps = __esmMin((() => {
+	LocalAppSourceHashSchema = z.string().regex(/^[a-f0-9]{64}$/);
+	LocalAppStatusSchema = z.enum([
+		"preview_ready",
+		"installed",
+		"degraded"
+	]);
+	LocalAppInstallationStateSchema = z.enum(["not_installed", "installed"]);
+	LocalAppReleaseHealthSchema = z.enum(["healthy", "failed"]);
+	LocalAppAcceptanceCheckSchema = z.strictObject({
+		id: z.enum([
+			"document",
+			"content",
+			"interaction",
+			"criteria"
+		]),
+		status: z.enum([
+			"passed",
+			"failed",
+			"skipped"
+		]),
+		message: z.string().trim().min(1).max(500)
+	});
+	LocalAppAcceptanceResultSchema = z.strictObject({
+		status: z.enum(["passed", "failed"]),
+		checks: z.array(LocalAppAcceptanceCheckSchema).min(1).max(10),
+		interactiveCount: z.number().int().min(0).max(1e4)
+	});
+	LocalAppAcceptanceInputSchema = LocalAppAcceptanceResultSchema.extend({ sourceHash: LocalAppSourceHashSchema }).refine((value) => value.checks.length >= 3 && value.checks.length <= 4, {
+		message: "Acceptance input must contain three or four checks",
+		path: ["checks"]
+	});
+	LocalAppAcceptanceOutputSchema = LocalAppAcceptanceInputSchema.safeExtend({
+		id: z.string().min(1),
+		appId: z.string().min(1),
+		createdAt: z.number().int().nonnegative()
+	});
+	LocalAppReleaseSchema = z.strictObject({
+		id: z.string().min(1),
+		appId: z.string().min(1),
+		version: z.number().int().positive(),
+		sourceHash: LocalAppSourceHashSchema,
+		healthStatus: LocalAppReleaseHealthSchema,
+		createdAt: z.number().int().nonnegative(),
+		activatedAt: z.number().int().nonnegative().optional(),
+		isActive: z.boolean()
+	});
+	LocalAppRecordSchema = z.strictObject({
+		id: z.string().min(1),
+		extensionId: z.string().min(1),
+		projectId: z.string().min(1),
+		name: z.string().min(1),
+		description: z.string().optional(),
+		idea: z.string().min(1),
+		status: LocalAppStatusSchema,
+		workspaceRoot: z.string().min(1),
+		draftVersion: z.number().int().positive(),
+		activeVersion: z.number().int().positive().optional(),
+		activeReleaseId: z.string().min(1).optional(),
+		installationState: LocalAppInstallationStateSchema,
+		enabled: z.boolean(),
+		createdAt: z.number().int().nonnegative(),
+		updatedAt: z.number().int().nonnegative(),
+		installedAt: z.number().int().nonnegative().optional()
+	});
+	LocalAppAcceptanceRunSchema = LocalAppAcceptanceOutputSchema;
+	LocalAppDetailSchema = LocalAppRecordSchema.extend({
+		draftPreviewUrl: z.string().startsWith("/api/local-apps/preview/"),
+		permissions: z.array(z.string()),
+		releases: z.array(LocalAppReleaseSchema),
+		acceptanceRuns: z.array(LocalAppAcceptanceRunSchema)
+	});
+	LocalAppValidationIssueSchema = z.strictObject({
+		code: z.string().trim().min(1).max(80),
+		severity: z.enum(["error", "warning"]),
+		message: z.string().trim().min(1).max(500)
+	});
+	LocalAppChangedFileSchema = z.strictObject({
+		path: z.string().min(1).max(4096),
+		status: z.enum([
+			"added",
+			"modified",
+			"deleted"
+		])
+	});
+	LocalAppAcceptanceScenarioSummarySchema = z.strictObject({
+		id: z.string().trim().min(1).max(80),
+		name: z.string().trim().min(1).max(120),
+		stepCount: z.number().int().nonnegative()
+	});
+	LocalAppValidationSchema = z.strictObject({
+		status: z.enum(["healthy", "failed"]),
+		checkedAt: z.number().int().nonnegative(),
+		sourceHash: LocalAppSourceHashSchema.optional(),
+		hasDraftChanges: z.boolean(),
+		changedFiles: z.array(LocalAppChangedFileSchema).max(50),
+		changedFileCount: z.number().int().nonnegative(),
+		permissions: z.array(z.string()),
+		permissionDelta: z.strictObject({
+			added: z.array(z.string()),
+			removed: z.array(z.string())
+		}),
+		acceptanceScenarioCount: z.number().int().nonnegative(),
+		acceptanceScenarios: z.array(LocalAppAcceptanceScenarioSummarySchema),
+		issues: z.array(LocalAppValidationIssueSchema).max(100)
+	});
+	LocalAppPreviewSnapshotSchema = z.strictObject({
+		appId: z.string().min(1),
+		sourceHash: LocalAppSourceHashSchema,
+		status: z.enum(["ready", "invalid"]),
+		createdAt: z.number().int().nonnegative(),
+		entryPath: z.string().min(1).max(4096).optional(),
+		previewUrl: z.string().startsWith("/api/local-apps/preview/").optional(),
+		validation: LocalAppValidationSchema
+	}).superRefine((snapshot, context) => {
+		const runnable = snapshot.status === "ready";
+		if (runnable !== Boolean(snapshot.entryPath)) context.addIssue({
+			code: "custom",
+			path: ["entryPath"],
+			message: "Ready snapshots require an entry path"
+		});
+		if (snapshot.previewUrl && !runnable) context.addIssue({
+			code: "custom",
+			path: ["previewUrl"],
+			message: "Invalid snapshots cannot have a preview URL"
+		});
+		if (snapshot.validation.sourceHash !== snapshot.sourceHash) context.addIssue({
+			code: "custom",
+			path: ["validation", "sourceHash"],
+			message: "Snapshot validation hash must match the snapshot"
+		});
+	});
+	LocalAppDiagnosticPhaseSchema = z.enum([
+		"build",
+		"boot",
+		"runtime",
+		"acceptance",
+		"runner",
+		"capability"
+	]);
+	LocalAppDiagnosticSchema = z.strictObject({
+		phase: LocalAppDiagnosticPhaseSchema,
+		message: z.string().trim().min(1).max(500),
+		code: z.string().trim().min(1).max(80).optional()
+	});
+	LocalAppFixGuidanceInputSchema = z.strictObject({
+		sourceHash: LocalAppSourceHashSchema.optional(),
+		locale: z.enum(["en", "zh"]).default("en"),
+		diagnostics: z.array(LocalAppDiagnosticSchema).min(1).max(20)
+	});
+	z.strictObject({
+		appId: z.string().min(1),
+		sourceHash: LocalAppSourceHashSchema.optional(),
+		owner: z.enum([
+			"generated_code",
+			"platform",
+			"configuration"
+		]),
+		action: z.enum([
+			"fix_code",
+			"retry",
+			"fix_config"
+		]),
+		diagnostics: z.array(LocalAppDiagnosticSchema).max(20),
+		prompt: z.string().min(1)
+	});
+	LocalAppRuntimeIssueSchema = z.strictObject({
+		kind: z.enum(["script_error", "unhandled_rejection"]),
+		message: z.string().trim().min(1).max(500),
+		filename: z.string().max(500).optional(),
+		line: z.number().nonnegative().optional(),
+		column: z.number().nonnegative().optional()
+	});
+	LocalAppCriteriaScenarioResultSchema = z.strictObject({
+		id: z.string().trim().min(1).max(80),
+		name: z.string().trim().min(1).max(120),
+		status: z.enum(["passed", "failed"]),
+		message: z.string().trim().min(1).max(500),
+		failureKind: z.enum(["scenario", "runner"]).default("scenario")
+	});
+	LocalAppCriteriaResultSchema = z.strictObject({
+		status: z.enum(["passed", "failed"]),
+		scenarioCount: z.number().int().min(0).max(10),
+		scenarios: z.array(LocalAppCriteriaScenarioResultSchema).max(10)
+	});
+	runtimeEnvelope = z.strictObject({
+		source: z.literal("xopc-local-app-preview"),
+		version: z.literal(1)
+	});
+	z.discriminatedUnion("type", [
+		runtimeEnvelope.extend({
+			type: z.literal("ready"),
+			detail: z.strictObject({ readyState: z.string().max(100).optional() })
+		}),
+		runtimeEnvelope.extend({
+			type: z.literal("error"),
+			detail: LocalAppRuntimeIssueSchema
+		}),
+		runtimeEnvelope.extend({
+			type: z.literal("acceptance"),
+			detail: LocalAppAcceptanceResultSchema
+		}),
+		runtimeEnvelope.extend({
+			type: z.literal("criteria"),
+			detail: LocalAppCriteriaResultSchema
+		})
+	]);
+}));
+//#endregion
+init_local_apps();
+export { LocalAppAcceptanceCheckSchema, LocalAppAcceptanceInputSchema, LocalAppAcceptanceOutputSchema, LocalAppAcceptanceResultSchema, LocalAppAcceptanceRunSchema, LocalAppAcceptanceScenarioSummarySchema, LocalAppChangedFileSchema, LocalAppCriteriaResultSchema, LocalAppCriteriaScenarioResultSchema, LocalAppDetailSchema, LocalAppDiagnosticPhaseSchema, LocalAppDiagnosticSchema, LocalAppFixGuidanceInputSchema, LocalAppInstallationStateSchema, LocalAppPreviewSnapshotSchema, LocalAppRecordSchema, LocalAppReleaseHealthSchema, LocalAppReleaseSchema, LocalAppRuntimeIssueSchema, LocalAppSourceHashSchema, LocalAppStatusSchema, LocalAppValidationIssueSchema, LocalAppValidationSchema, init_local_apps };

package/dist/packages/gateway-contract/src/product-delivery.js

@@ -1,4 +1,6 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { ChatPreviewSourceHashSchema, init_chat_previews } from "./chat-previews.js";
+import { LocalAppSourceHashSchema, init_local_apps } from "./local-apps.js";
 import { z } from "zod";
 //#region packages/gateway-contract/src/product-delivery.ts
 function parseProductDeliveryEnvelope(value) {
@@ -7,7 +9,25 @@ function parseProductDeliveryEnvelope(value) {
 }
 function appendProductDeliveryText(text, delivery) {
 	if (!delivery) return text;
-	return `${text}${delivery.primary ? `\nOpen in xopc: [Open](${productReferenceDeepLink(delivery.primary)})` : delivery.presentation?.kind === "table" && delivery.presentation.items.length ? `\nOpen in xopc: ${delivery.presentation.items.map((item, index) => `[${index + 1}](${productReferenceDeepLink(item)})`).join(" · ")}` : ""}\n${PRODUCT_DELIVERY_TEXT_PREFIX}${encodeURIComponent(JSON.stringify(delivery))}`;
+	const openableItems = delivery.presentation?.kind === "table" ? delivery.presentation.items.filter((item) => productReferenceRoute(item) !== null) : [];
+	return `${text}${delivery.primary && productReferenceRoute(delivery.primary) !== null ? `\nOpen in xopc: [Open](${productReferenceDeepLink(delivery.primary)})` : openableItems.length ? `\nOpen in xopc: ${openableItems.map((item, index) => `[${index + 1}](${productReferenceDeepLink(item)})`).join(" · ")}` : ""}\n${PRODUCT_DELIVERY_TEXT_PREFIX}${encodeURIComponent(JSON.stringify(delivery))}`;
+}
+function productReferenceRoute(reference) {
+	const id = encodeURIComponent(reference.id);
+	switch (reference.kind) {
+		case "task": return `/tasks/${id}`;
+		case "project": return `/projects/${id}`;
+		case "note": return `/notes/${id}`;
+		case "workflow_definition": return `/workflows/${id}`;
+		case "workflow_run": return `/workflows/runs/${id}`;
+		case "automation": return `/automations?automation=${id}`;
+		case "scene": return `/scenes/${id}`;
+		case "local_app": return `/local-apps/${id}`;
+		case "chat_preview": return null;
+		case "session": return `/chat/${id}`;
+		case "settings": return `/settings/${reference.id.replace(/^\/+/, "").split("/").map(encodeURIComponent).join("/")}`;
+		case "file": return null;
+	}
 }
 function productReferenceDeepLink(reference) {
 	return `xopc://open?${new URLSearchParams({
@@ -17,6 +37,8 @@ function productReferenceDeepLink(reference) {
 }
 var ProductReferenceKindSchema, ProductCapabilitySchema, ProductReferenceSchema, ProductDeliveryOperationSchema, ProductDeliveryPresentationSchema, ProductDeliveryEnvelopeSchema, PRODUCT_DELIVERY_TEXT_PREFIX;
 var init_product_delivery = __esmMin((() => {
+	init_chat_previews();
+	init_local_apps();
 	ProductReferenceKindSchema = z.enum([
 		"task",
 		"project",
@@ -26,6 +48,7 @@ var init_product_delivery = __esmMin((() => {
 		"automation",
 		"scene",
 		"local_app",
+		"chat_preview",
 		"file",
 		"session",
 		"settings"
@@ -35,6 +58,7 @@ var init_product_delivery = __esmMin((() => {
 		"preview",
 		"edit",
 		"continue_in_chat",
+		"fix",
 		"run",
 		"pause",
 		"resume",
@@ -60,22 +84,43 @@ var init_product_delivery = __esmMin((() => {
 		"completed",
 		"failed"
 	]);
-	ProductDeliveryPresentationSchema = z.discriminatedUnion("kind", [z.object({
-		kind: z.literal("table"),
-		items: z.array(ProductReferenceSchema).max(50),
-		truncated: z.boolean()
-	}), z.object({
-		kind: z.literal("diff"),
-		title: z.string().max(2e3),
-		truncated: z.boolean(),
-		edits: z.array(z.object({
-			from: z.number().int().nonnegative(),
-			to: z.number().int().nonnegative(),
-			text: z.string().max(16e3)
-		}).refine((edit) => edit.to >= edit.from, "Invalid replacement range")).max(20).refine((edits) => edits.reduce((total, edit) => total + edit.text.length, 0) <= 16e3, "Replacement text exceeds preview limit")
-	})]);
+	ProductDeliveryPresentationSchema = z.discriminatedUnion("kind", [
+		z.object({
+			kind: z.literal("table"),
+			items: z.array(ProductReferenceSchema).max(50),
+			truncated: z.boolean()
+		}),
+		z.object({
+			kind: z.literal("diff"),
+			title: z.string().max(2e3),
+			truncated: z.boolean(),
+			edits: z.array(z.object({
+				from: z.number().int().nonnegative(),
+				to: z.number().int().nonnegative(),
+				text: z.string().max(16e3)
+			}).refine((edit) => edit.to >= edit.from, "Invalid replacement range")).max(20).refine((edits) => edits.reduce((total, edit) => total + edit.text.length, 0) <= 16e3, "Replacement text exceeds preview limit")
+		}),
+		z.object({
+			kind: z.literal("inline_app"),
+			reference: ProductReferenceSchema.refine((reference) => reference.kind === "local_app", "Inline app must reference a local app"),
+			snapshot: z.strictObject({ sourceHash: LocalAppSourceHashSchema }),
+			preferredHeight: z.number().int().min(240).max(720).default(480)
+		}).refine((presentation) => !presentation.reference.revision || presentation.reference.revision === presentation.snapshot.sourceHash, {
+			message: "Inline app reference revision must match its snapshot",
+			path: ["reference", "revision"]
+		}),
+		z.object({
+			kind: z.literal("inline_preview"),
+			reference: ProductReferenceSchema.refine((reference) => reference.kind === "chat_preview", "Inline preview must reference a chat preview"),
+			sourceHash: ChatPreviewSourceHashSchema,
+			preferredHeight: z.number().int().min(240).max(720).default(480)
+		}).refine((presentation) => !presentation.reference.revision || presentation.reference.revision === presentation.sourceHash, {
+			message: "Inline preview reference revision must match its source",
+			path: ["reference", "revision"]
+		})
+	]);
 	ProductDeliveryEnvelopeSchema = z.object({
-		version: z.literal(1),
+		version: z.literal(2),
 		operation: ProductDeliveryOperationSchema,
 		primary: ProductReferenceSchema.optional(),
 		related: z.array(ProductReferenceSchema).optional(),
@@ -85,4 +130,4 @@ var init_product_delivery = __esmMin((() => {
 }));
 //#endregion
 init_product_delivery();
-export { ProductCapabilitySchema, ProductDeliveryEnvelopeSchema, ProductDeliveryOperationSchema, ProductDeliveryPresentationSchema, ProductReferenceKindSchema, ProductReferenceSchema, appendProductDeliveryText, init_product_delivery, parseProductDeliveryEnvelope, productReferenceDeepLink };
+export { ProductCapabilitySchema, ProductDeliveryEnvelopeSchema, ProductDeliveryOperationSchema, ProductDeliveryPresentationSchema, ProductReferenceKindSchema, ProductReferenceSchema, appendProductDeliveryText, init_product_delivery, parseProductDeliveryEnvelope, productReferenceDeepLink, productReferenceRoute };

package/dist/packages/gateway-contract/src/user-turn-document.js

@@ -0,0 +1,60 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+//#region packages/gateway-contract/src/user-turn-document.ts
+function contextRefWireTokenRe() {
+	return new RegExp(CONTEXT_REF_TOKEN_RE.source, "g");
+}
+function parseUserTurnDocument(wire) {
+	const parts = [];
+	const re = contextRefWireTokenRe();
+	let last = 0;
+	let match;
+	while ((match = re.exec(wire)) !== null) {
+		if (match.index > last) parts.push({
+			type: "text",
+			text: wire.slice(last, match.index)
+		});
+		parts.push({
+			type: "context_ref",
+			refId: match[1] ?? ""
+		});
+		last = match.index + match[0].length;
+	}
+	if (parts.length === 0) return null;
+	if (last < wire.length) parts.push({
+		type: "text",
+		text: wire.slice(last)
+	});
+	return {
+		version: 1,
+		parts
+	};
+}
+function userTurnDocumentRefIds(document) {
+	return document.parts.flatMap((part) => part.type === "context_ref" ? [part.refId] : []);
+}
+function renderUserTurnDocument(document, resolveLabel) {
+	return document.parts.map((part) => {
+		if (part.type === "text") return part.text;
+		const title = resolveLabel(part.refId)?.trim();
+		return title ? `@${title}` : "";
+	}).join("");
+}
+function isUserTurnDocument(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const row = value;
+	if (row.version !== 1 || !Array.isArray(row.parts)) return false;
+	return row.parts.every((part) => {
+		if (!part || typeof part !== "object" || Array.isArray(part)) return false;
+		const candidate = part;
+		return candidate.type === "text" ? typeof candidate.text === "string" : candidate.type === "context_ref" && typeof candidate.refId === "string" && new RegExp(`^${CONTEXT_REF_ID_PATTERN}$`).test(candidate.refId);
+	});
+}
+var CONTEXT_REF_TOKEN_PREFIX, CONTEXT_REF_ID_PATTERN, CONTEXT_REF_TOKEN_RE;
+var init_user_turn_document = __esmMin((() => {
+	CONTEXT_REF_TOKEN_PREFIX = "@xopc-ref:";
+	CONTEXT_REF_ID_PATTERN = "[A-Za-z0-9_-]{1,64}";
+	CONTEXT_REF_TOKEN_RE = new RegExp(`${CONTEXT_REF_TOKEN_PREFIX}(${CONTEXT_REF_ID_PATTERN})`, "g");
+}));
+//#endregion
+init_user_turn_document();
+export { contextRefWireTokenRe, init_user_turn_document, isUserTurnDocument, parseUserTurnDocument, renderUserTurnDocument, userTurnDocumentRefIds };