@xopcai/xopc 0.0.321 → 0.0.324

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/home.js

@@ -1,15 +1,11 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { z } from "zod";
 //#region packages/gateway-contract/src/home.ts
-var HomeDecisionSchema, HomeActionSchema, HomeWorkbenchItemSchema, HomeRunningConversationSchema, TaskValueMetricsSchema;
+var HomeDecisionSchema, HomeActionSchema, HomeWorkbenchItemSchema, HomeRunningConversationSchema, HomeEvidenceSchema, HomeCapabilityReadinessSchema, HomeCapabilityBlockerSchema, HomeCapabilityPreflightSchema, HomeOpportunitySchema, HomeClarificationSchema, HomeAdvisorSchema, HomeAdvisorRefreshRequestSchema, HomeOpportunityFeedbackRequestSchema, HomeOpportunityFeedbackUndoRequestSchema, HomeOpportunityHistoryItemSchema, HomeOpportunityHistoryResponseSchema, HomeOpportunityActionRequestSchema, HomeAdviceMetricsSchema, TaskValueMetricsSchema;
 var init_home = __esmMin((() => {
 	HomeDecisionSchema = z.object({
 		id: z.string(),
-		kind: z.enum([
-			"agent_judgment",
-			"task",
-			"connector_approval"
-		]),
+		kind: z.enum(["task", "connector_approval"]),
 		title: z.string(),
 		detail: z.string().optional(),
 		reason: z.enum([
@@ -25,7 +21,6 @@ var init_home = __esmMin((() => {
 			"overdue",
 			"due_soon",
 			"decision_needed",
-			"insight_available",
 			"approval_required"
 		]),
 		urgency: z.enum(["now", "soon"]),
@@ -34,46 +29,6 @@ var init_home = __esmMin((() => {
 		projectName: z.string().optional(),
 		dueAt: z.number().int().nonnegative().optional(),
 		updatedAt: z.number(),
-		judgment: z.object({
-			inboxItemId: z.string(),
-			whyNow: z.string(),
-			impact: z.string(),
-			workDone: z.string(),
-			recommendation: z.string(),
-			confidence: z.number(),
-			valueScore: z.number().min(0).max(1).optional(),
-			evidenceIds: z.array(z.string()).max(20),
-			attentionKind: z.enum([
-				"information",
-				"decision",
-				"receipt"
-			]),
-			disposition: z.enum([
-				"show_in_work",
-				"request_approval",
-				"auto_execute"
-			]).optional(),
-			dispositionReason: z.string().optional(),
-			actionStatus: z.enum([
-				"not_authorized",
-				"approval_required",
-				"pending",
-				"executing",
-				"completed",
-				"rejected",
-				"failed"
-			]).optional(),
-			proposedActionTitle: z.string().optional(),
-			actionError: z.string().optional(),
-			decision: z.object({
-				question: z.string(),
-				options: z.array(z.object({
-					id: z.string(),
-					label: z.string(),
-					consequence: z.string()
-				}))
-			}).optional()
-		}).optional(),
 		response: z.discriminatedUnion("kind", [z.object({
 			kind: z.literal("connector_approval"),
 			approvalId: z.string()
@@ -96,11 +51,6 @@ var init_home = __esmMin((() => {
 			label: z.string(),
 			href: z.string()
 		}),
-		z.object({
-			type: z.literal("review_judgment"),
-			label: z.string(),
-			itemId: z.string()
-		}),
 		z.object({
 			type: z.literal("connector_decision"),
 			label: z.string(),
@@ -126,8 +76,7 @@ var init_home = __esmMin((() => {
 			"decision",
 			"failure",
 			"running",
-			"scheduled",
-			"insight"
+			"scheduled"
 		]),
 		title: z.string(),
 		summary: z.string(),
@@ -146,12 +95,251 @@ var init_home = __esmMin((() => {
 		agentId: z.string().optional(),
 		updatedAt: z.number()
 	});
+	HomeEvidenceSchema = z.strictObject({
+		id: z.string().trim().min(1).max(300),
+		sourceType: z.enum([
+			"project",
+			"task",
+			"conversation",
+			"scene",
+			"calendar",
+			"mail",
+			"communication",
+			"file",
+			"user_model"
+		]),
+		sourceRef: z.string().trim().min(1).max(1e3),
+		revision: z.string().trim().min(1).max(300),
+		observation: z.string().trim().min(1).max(1e3),
+		observedAt: z.number().int().nonnegative(),
+		freshUntil: z.number().int().nonnegative(),
+		href: z.string().trim().min(1).max(2e3).optional()
+	});
+	HomeCapabilityReadinessSchema = z.strictObject({
+		kind: z.enum([
+			"connector",
+			"skill",
+			"agent"
+		]),
+		capability: z.string().trim().min(1).max(200),
+		resolvedId: z.string().trim().min(1).max(300).optional(),
+		readiness: z.enum([
+			"ready",
+			"needs_setup",
+			"unavailable"
+		]),
+		required: z.boolean(),
+		recoveryPath: z.string().trim().min(1).max(2e3).optional(),
+		reason: z.string().trim().min(1).max(500).optional()
+	});
+	HomeCapabilityBlockerSchema = z.strictObject({
+		kind: z.enum([
+			"connector",
+			"skill",
+			"agent"
+		]),
+		capability: z.string().trim().min(1).max(200),
+		code: z.enum([
+			"not_installed",
+			"disabled",
+			"agent_not_allowed",
+			"scope_too_narrow",
+			"connection_missing",
+			"account_selection_required",
+			"reauthorization_required",
+			"requirements_unmet",
+			"model_invocation_disabled",
+			"tool_gated",
+			"agent_unavailable"
+		]),
+		message: z.string().trim().min(1).max(500),
+		recoveryPath: z.string().trim().min(1).max(2e3)
+	});
+	HomeCapabilityPreflightSchema = z.discriminatedUnion("state", [z.strictObject({ state: z.literal("ready") }), z.strictObject({
+		state: z.literal("needs_setup"),
+		blockers: z.array(HomeCapabilityBlockerSchema).min(1).max(12),
+		recoveryActions: z.array(z.strictObject({
+			capability: z.string().trim().min(1).max(200),
+			href: z.string().trim().min(1).max(2e3)
+		})).min(1).max(12),
+		degradedAction: z.strictObject({ mode: z.literal("degraded_start") }).optional()
+	})]);
+	HomeOpportunitySchema = z.strictObject({
+		id: z.string().trim().min(1).max(200),
+		revision: z.number().int().positive(),
+		kind: z.enum([
+			"project_next_step",
+			"delivery_risk",
+			"meeting_prep",
+			"commitment_follow_up",
+			"automation_candidate"
+		]),
+		projectId: z.string().trim().min(1).max(200).optional(),
+		title: z.string().trim().min(1).max(160),
+		outcome: z.string().trim().min(1).max(1e3),
+		rationale: z.string().trim().min(1).max(1500),
+		evidence: z.array(HomeEvidenceSchema).min(1).max(8),
+		confidence: z.enum([
+			"high",
+			"medium",
+			"low"
+		]),
+		urgency: z.enum([
+			"now",
+			"today",
+			"this_week"
+		]),
+		estimatedMinutes: z.number().int().min(1).max(480).optional(),
+		risk: z.enum([
+			"analysis",
+			"external_read",
+			"file_write",
+			"external_write"
+		]),
+		proposedSteps: z.array(z.string().trim().min(1).max(500)).min(1).max(6),
+		capabilities: z.array(HomeCapabilityReadinessSchema).max(12),
+		verification: z.array(z.string().trim().min(1).max(500)).max(8),
+		actionPrompt: z.string().trim().min(1).max(4e3),
+		degradedActionPrompt: z.string().trim().min(1).max(4e3).optional(),
+		continuation: z.discriminatedUnion("kind", [z.strictObject({
+			kind: z.literal("scene"),
+			reason: z.literal("prior_success"),
+			href: z.string().trim().min(1).max(2e3)
+		}), z.strictObject({
+			kind: z.literal("automation"),
+			reason: z.literal("repeated_success"),
+			href: z.string().trim().min(1).max(4e3),
+			successCount: z.number().int().min(2)
+		})]).optional(),
+		actions: z.strictObject({
+			canStart: z.boolean(),
+			canDiscuss: z.boolean(),
+			degradedStartAvailable: z.boolean()
+		}),
+		generatedAt: z.number().int().nonnegative(),
+		expiresAt: z.number().int().nonnegative()
+	});
+	HomeClarificationSchema = z.strictObject({
+		id: z.string().trim().min(1).max(200),
+		revision: z.number().int().positive(),
+		question: z.string().trim().min(1).max(500),
+		options: z.array(z.strictObject({
+			id: z.string().trim().min(1).max(100),
+			label: z.string().trim().min(1).max(200)
+		})).min(2).max(3),
+		evidenceIds: z.array(z.string().trim().min(1).max(300)).min(1).max(8)
+	});
+	HomeAdvisorSchema = z.discriminatedUnion("state", [
+		z.strictObject({ state: z.literal("disabled") }),
+		z.strictObject({
+			state: z.literal("quiet"),
+			reason: z.enum([
+				"no_change",
+				"insufficient_value",
+				"model_unavailable",
+				"generation_failed",
+				"budget_exhausted"
+			])
+		}),
+		z.strictObject({
+			state: z.literal("refreshing"),
+			previous: HomeOpportunitySchema.optional(),
+			requestedAt: z.number().int().nonnegative()
+		}),
+		z.strictObject({
+			state: z.literal("clarification"),
+			question: HomeClarificationSchema,
+			generatedAt: z.number().int().nonnegative(),
+			expiresAt: z.number().int().nonnegative()
+		}),
+		z.strictObject({
+			state: z.literal("ready"),
+			primary: HomeOpportunitySchema,
+			alternatives: z.array(HomeOpportunitySchema).max(2),
+			placement: z.enum(["primary", "compact"]),
+			generatedAt: z.number().int().nonnegative(),
+			expiresAt: z.number().int().nonnegative(),
+			stale: z.boolean()
+		})
+	]);
+	HomeAdvisorRefreshRequestSchema = z.strictObject({
+		idempotencyKey: z.string().trim().min(1).max(200),
+		locale: z.string().trim().max(30).optional()
+	});
+	HomeOpportunityFeedbackRequestSchema = z.strictObject({
+		idempotencyKey: z.string().trim().min(1).max(200),
+		expectedRevision: z.number().int().positive(),
+		kind: z.enum([
+			"already_done",
+			"irrelevant",
+			"too_early",
+			"source_incorrect",
+			"less_like_this",
+			"snoozed"
+		]),
+		reasonCode: z.string().trim().min(1).max(100).optional(),
+		note: z.string().trim().min(1).max(1e3).optional(),
+		snoozedUntil: z.number().int().nonnegative().optional()
+	});
+	HomeOpportunityFeedbackUndoRequestSchema = z.strictObject({ idempotencyKey: z.string().trim().min(1).max(200) });
+	HomeOpportunityHistoryItemSchema = z.strictObject({
+		opportunity: HomeOpportunitySchema,
+		status: z.enum([
+			"available",
+			"started",
+			"discussing",
+			"completed",
+			"snoozed",
+			"dismissed",
+			"expired",
+			"superseded"
+		]),
+		feedbackKind: z.enum([
+			"started",
+			"discussed",
+			"already_done",
+			"irrelevant",
+			"too_early",
+			"source_incorrect",
+			"less_like_this",
+			"snoozed"
+		]).optional(),
+		updatedAt: z.number().int().nonnegative(),
+		snoozedUntil: z.number().int().nonnegative().optional(),
+		href: z.string().trim().min(1).max(2e3).optional()
+	});
+	HomeOpportunityHistoryResponseSchema = z.strictObject({ items: z.array(HomeOpportunityHistoryItemSchema).max(100) });
+	HomeOpportunityActionRequestSchema = z.strictObject({
+		idempotencyKey: z.string().trim().min(1).max(200),
+		expectedRevision: z.number().int().positive(),
+		mode: z.enum([
+			"start",
+			"degraded_start",
+			"discuss"
+		])
+	});
+	z.discriminatedUnion("outcome", [
+		z.strictObject({
+			outcome: z.literal("task"),
+			taskId: z.string(),
+			href: z.string()
+		}),
+		z.strictObject({
+			outcome: z.literal("chat_draft"),
+			href: z.string()
+		}),
+		z.strictObject({
+			outcome: z.literal("needs_setup"),
+			preflight: HomeCapabilityPreflightSchema
+		})
+	]);
 	z.object({
 		runningConversations: z.array(HomeRunningConversationSchema).default([]),
 		needsUser: z.array(HomeWorkbenchItemSchema),
 		background: z.array(HomeWorkbenchItemSchema),
 		backgroundCount: z.number().int().nonnegative(),
 		decisions: z.array(HomeDecisionSchema),
+		advisor: HomeAdvisorSchema,
 		attentionPolicy: z.object({
 			visibleDecisionCount: z.number().int().nonnegative(),
 			suppressedDecisionCount: z.number().int().nonnegative(),
@@ -164,6 +352,47 @@ var init_home = __esmMin((() => {
 			suppressedAttentionCount: 0
 		})
 	});
+	HomeAdviceMetricsSchema = z.strictObject({
+		window: z.strictObject({
+			since: z.number().int().nonnegative(),
+			until: z.number().int().nonnegative()
+		}),
+		currentStrategyVersion: z.string().trim().min(1).max(100),
+		generations: z.strictObject({
+			total: z.number().int().nonnegative(),
+			succeeded: z.number().int().nonnegative(),
+			quiet: z.number().int().nonnegative(),
+			failed: z.number().int().nonnegative(),
+			estimatedCostUsd: z.number().nonnegative()
+		}),
+		outcomes: z.strictObject({
+			opportunities: z.number().int().nonnegative(),
+			started: z.number().int().nonnegative(),
+			discussed: z.number().int().nonnegative(),
+			completed: z.number().int().nonnegative(),
+			corrected: z.number().int().nonnegative(),
+			expired: z.number().int().nonnegative()
+		}),
+		rates: z.strictObject({
+			start: z.number().min(0).max(1),
+			completionFromStarted: z.number().min(0).max(1),
+			correction: z.number().min(0).max(1)
+		}),
+		feedback: z.strictObject({
+			alreadyDone: z.number().int().nonnegative(),
+			irrelevant: z.number().int().nonnegative(),
+			tooEarly: z.number().int().nonnegative(),
+			sourceIncorrect: z.number().int().nonnegative(),
+			lessLikeThis: z.number().int().nonnegative()
+		}),
+		strategies: z.array(z.strictObject({
+			version: z.string().trim().min(1).max(100),
+			generations: z.number().int().nonnegative(),
+			opportunities: z.number().int().nonnegative(),
+			started: z.number().int().nonnegative(),
+			completed: z.number().int().nonnegative()
+		}))
+	});
 	TaskValueMetricsSchema = z.object({
 		northStar: z.object({
 			weeklyTrustedProgress: z.number(),
@@ -185,4 +414,4 @@ var init_home = __esmMin((() => {
 }));
 //#endregion
 init_home();
-export { HomeActionSchema, HomeDecisionSchema, HomeRunningConversationSchema, HomeWorkbenchItemSchema, TaskValueMetricsSchema, init_home };
+export { HomeActionSchema, HomeAdviceMetricsSchema, HomeAdvisorRefreshRequestSchema, HomeAdvisorSchema, HomeCapabilityBlockerSchema, HomeCapabilityPreflightSchema, HomeCapabilityReadinessSchema, HomeClarificationSchema, HomeDecisionSchema, HomeEvidenceSchema, HomeOpportunityActionRequestSchema, HomeOpportunityFeedbackRequestSchema, HomeOpportunityFeedbackUndoRequestSchema, HomeOpportunityHistoryItemSchema, HomeOpportunityHistoryResponseSchema, HomeOpportunitySchema, HomeRunningConversationSchema, HomeWorkbenchItemSchema, TaskValueMetricsSchema, init_home };

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";
@@ -27,7 +30,6 @@ import { init_browser_tab_binding } from "./browser-tab-binding.js";
 import { init_model_selection } from "./model-selection.js";
 import { init_connection_waits } from "./connection-waits.js";
 import { init_clarifications } from "./clarifications.js";
-import { init_proactive } from "./proactive.js";
 import { init_discussions } from "./discussions.js";
 import { init_app_context } from "./app-context.js";
 import { init_scenes } from "./scenes.js";
@@ -52,6 +54,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();
@@ -63,12 +66,13 @@ var init_src = __esmMin((() => {
 	init_model_selection();
 	init_connection_waits();
 	init_clarifications();
-	init_proactive();
 	init_discussions();
 	init_capabilities();
 	init_scenes();
 	init_app_context();
 	init_extension_capabilities();
+	init_local_apps();
+	init_chat_previews();
 }));
 //#endregion
 init_src();