@dipoleml/dcode-cli 1.1.0 → 1.2.0

package/node_modules/@dcode/shared/dist/dynamic-workflow-feature.js

@@ -28,21 +28,60 @@ export function normalizeDynamicWorkflowMode(value) {
         : undefined;
 }
 /**
- * 解析保留服务端契约的三态，消费侧统一转换为布尔开关。
- * 将来 onDemand 有独立行为时，只需调整消费侧。
+ * 「功能是否提供」的折叠：`onDemand` 与 `alwaysOn` 同为开启——目录里的 `/workflow`、技能、
+ * 自动化页的工作流 tab 与 Resume 入口在两种模式下都在。两者的差别只在模型工具面的注册时机
+ * （launch.md「On demand: activation」），由 CLI 侧按 mode 本身裁决，这里不参与。
  */
 export function isDynamicWorkflowModeEnabled(mode) {
     return mode !== "disabled";
 }
-export function createDynamicWorkflowClientConfig(mode, source) {
-    return { mode, enabled: isDynamicWorkflowModeEnabled(mode), source };
+export function createDynamicWorkflowClientConfig(offeredMode, source) {
+    return {
+        mode: offeredMode,
+        enabled: isDynamicWorkflowModeEnabled(offeredMode),
+        source,
+        offeredMode,
+    };
 }
 /**
- * 纯函数：把远端 envelope 的 `configs.dynamicWorkflow` 与本地覆盖环境变量折叠成一个快照。
- * 优先级：覆盖 > 远端合法值 > 缺省。远端成功但**未下发**该 key 也视为 disabled——
+ * 功能是否提供（与用户选择无关）：设置行只在提供时出现。
+ *
+ * 修复原因：快照可能来自没有 offeredMode 的旧 Host（新 UI——例如手机远控 bundle——连旧桌面）。
+ * 过去直接比 `!== "disabled"`，缺席的字段读作「已提供」，设置行照出、选择写进一个旧 Host 不认的
+ * 设置。缺席或读不懂的 offeredMode 一律按未提供：只有认用户选择的 Host 才会写这个字段。
+ */
+export function isDynamicWorkflowOffered(config) {
+    const offeredMode = normalizeDynamicWorkflowMode(config.offeredMode);
+    return offeredMode !== undefined && isDynamicWorkflowModeEnabled(offeredMode);
+}
+/**
+ * 「服务端提供、用户挑选」规则的唯一实现（launch.md「The user's choice」）：
+ *   - 功能未提供（offeredMode 为 disabled）时用户选择不生效——选择永远不能把服务端关掉的功能打开；
+ *   - 可用时合法的用户选择取代提供的模式；缺席或非法值（旧文件、未来版本写入的新值）按跟随处理。
+ * 只从 `offeredMode` 推导，所以对已应用过选择的快照再次应用是覆盖而不是叠加：Host 闩住的是提供，
+ * 每次使用都用最新选择重新应用。
+ */
+export function applyDynamicWorkflowUserMode(config, userMode) {
+    const offer = createDynamicWorkflowClientConfig(config.offeredMode, config.source);
+    const choice = normalizeDynamicWorkflowMode(userMode);
+    if (!choice || !isDynamicWorkflowOffered(offer))
+        return offer;
+    return {
+        ...offer,
+        mode: choice,
+        enabled: isDynamicWorkflowModeEnabled(choice),
+        userMode: choice,
+    };
+}
+/**
+ * 纯函数：把远端 envelope 的 `configs.dynamicWorkflow` 与本地覆盖环境变量折叠成「提供」，再应用用户选择。
+ * 提供的优先级：覆盖 > 远端合法值 > 缺省。远端成功但**未下发**该 key 也视为 disabled——
  * 服务端撤掉 key 等于关闭，不能沿用旧快照（与 desktopContextPromptRollout 同一裁决）。
  */
 export function resolveDynamicWorkflowClientConfig(input) {
+    return applyDynamicWorkflowUserMode(resolveDynamicWorkflowOffer(input), input.userMode);
+}
+function resolveDynamicWorkflowOffer(input) {
     const override = normalizeDynamicWorkflowMode(input.env?.[DCODE_DYNAMIC_WORKFLOW_MODE_ENV]);
     if (override)
         return createDynamicWorkflowClientConfig(override, "override");

package/node_modules/@dcode/shared/dist/env.d.ts

@@ -15,11 +15,12 @@ export declare const DCODE_PRODUCT_FLAVOR: DCodeProductFlavor;
 export declare const DCODE_APP_VERSION_ENV: "DCODE_APP_VERSION";
 export declare const DCODE_BUILD_COMMIT_ID_ENV: "DCODE_BUILD_COMMIT_ID";
 export declare const RUNTIME_DCODE_DEBUG: string | undefined;
-export declare const DCODE_TELEMETRY_ENABLED: boolean;
-/** 数仓事件上报端点：由运行时环境变量提供，未配置即停用，构建产物不内嵌。 */
-export declare const DCODE_TELEMETRY_REPORT_ENDPOINT: string;
-/** ARMS RUM 接入端点：由运行时环境变量提供，未配置即停用，构建产物不内嵌。 */
+/** ARMS RUM 上报地址；为空时 SDK 以 enable=false 初始化，不产生上报。 */
 export declare const DCODE_ARMS_RUM_ENDPOINT: string;
+/** 事件上报（数仓）地址；为空时不上报。 */
+export declare const DCODE_TELEMETRY_REPORT_ENDPOINT: string;
+/** 桌面自动更新是否启用。 */
+export declare const DCODE_AUTO_UPDATE_ENABLED: boolean;
 /** 将本地运行态与编译期 DCODE_ENV 映射为 ARMS 控制台识别的上报环境标签 */
 export declare function mapDCodeEnvToArmsRumEnv(runtimeEnv: DCodeRuntimeEnv): ArmsRumEnv;
 //# sourceMappingURL=env.d.ts.map

package/node_modules/@dcode/shared/dist/env.js

@@ -20,15 +20,15 @@ export const DCODE_BUILD_COMMIT_ID_ENV = "DCODE_BUILD_COMMIT_ID";
 // ── 运行时环境变量（不经过编译打包，启动时从 process.env 读取） ──
 // 启用调试模式，值为 inspect-brk 的端口号，如 DCODE_DEBUG=9230
 export const RUNTIME_DCODE_DEBUG = typeof process !== "undefined" ? process.env.DCODE_DEBUG : undefined;
-// 恢复原因：写死 false 会让运行时已配置的数仓/ARMS 永远空转。
-// 功能保持可用；实际出网由各出口的运行时端点检查决定，未配置不上报。
-// DCode v1.0-beta：遥测默认关闭。DipoleML 尚未搭建遥测后端；
-// 需要恢复时把此值改回 true 并配置 DCODE_TELEMETRY_REPORT_ENDPOINT / DCODE_ARMS_RUM_ENDPOINT。
-export const DCODE_TELEMETRY_ENABLED = false;
-/** 数仓事件上报端点：由运行时环境变量提供，未配置即停用，构建产物不内嵌。 */
-export const DCODE_TELEMETRY_REPORT_ENDPOINT = typeof process !== "undefined" ? (process.env.DCODE_TELEMETRY_REPORT_ENDPOINT ?? "") : "";
-/** ARMS RUM 接入端点：由运行时环境变量提供，未配置即停用，构建产物不内嵌。 */
-export const DCODE_ARMS_RUM_ENDPOINT = typeof process !== "undefined" ? (process.env.DCODE_ARMS_RUM_ENDPOINT ?? "") : "";
+// ── 构建期可选能力（见 docs/desktop/build-time-optional-capabilities.md），未注入时一律关闭 ──
+/** ARMS RUM 上报地址；为空时 SDK 以 enable=false 初始化，不产生上报。 */
+export const DCODE_ARMS_RUM_ENDPOINT = typeof __DCODE_ARMS_RUM_ENDPOINT__ !== "undefined" ? __DCODE_ARMS_RUM_ENDPOINT__ : "";
+/** 事件上报（数仓）地址；为空时不上报。 */
+export const DCODE_TELEMETRY_REPORT_ENDPOINT = typeof __DCODE_TELEMETRY_REPORT_ENDPOINT__ !== "undefined"
+    ? __DCODE_TELEMETRY_REPORT_ENDPOINT__
+    : "";
+/** 桌面自动更新是否启用。 */
+export const DCODE_AUTO_UPDATE_ENABLED = typeof __DCODE_AUTO_UPDATE_ENABLED__ !== "undefined" ? __DCODE_AUTO_UPDATE_ENABLED__ : false;
 /** 将本地运行态与编译期 DCODE_ENV 映射为 ARMS 控制台识别的上报环境标签 */
 export function mapDCodeEnvToArmsRumEnv(runtimeEnv) {
     return runtimeEnv !== "development" && DCODE_ENV === "production" ? "prod" : "local";

package/node_modules/@dcode/shared/dist/errors.d.ts

@@ -6,4 +6,28 @@ export declare const DCODE_FILE_LOCK_TIMEOUT_ERROR_CODE: "DCODE_FILE_LOCK_TIMEOU
 export declare function stringifyUnknownValue(value: unknown): string;
 export declare function normalizeUnknownError(error: unknown): NormalizedUnknownError;
 export declare function isDCodeFileLockTimeoutError(error: unknown): boolean;
+/**
+ * 不可自动重试的 workspace DCode Agent 预热错误模式列表。
+ *
+ * 这些错误代表确定性的配置/安装/鉴权问题，继续重试不会变好。
+ * 同时用于 MCP-fallback 降级判断：命中这些模式时不做 MCP 降级，因为错误与 MCP 无关。
+ */
+export declare const NON_RETRYABLE_WORKSPACE_PREPARE_ERROR_PATTERNS: readonly ["binary 未找到", "未正确安装", "binary not found", "not installed", "initialize 前进程已退出", "initialize 超时", "进程启动失败", "optional dependency was not installed", "Cannot find package '@openai/codex-", "Missing optional dependency @openai/codex-", "Missing Codex runtime files", "Gemini API key is missing or not configured", "Please fix the configuration file(s)", "Expected property name or '}' in JSON", "已暂停自动重试"];
+/**
+ * 额外的不可 MCP-fallback 降级的错误模式。
+ *
+ * session/new 超时属于 agent 自身启动/登录卡住，和 MCP 无关，降级也没用。
+ */
+export declare const NON_MCP_FALLBACK_EXTRA_ERROR_PATTERNS: readonly ["session/new 超时"];
+/**
+ * 判断错误消息是否代表确定性失败，不应自动重试 workspace DCode Agent 预热。
+ */
+export declare function isNonRetryableWorkspacePrepareError(errorMessage: string): boolean;
+/**
+ * 判断 OpenCode 是否命中 Bun/运行时崩溃。
+ *
+ * 这类错误不同于配置缺失：短时间内重建进程可能恢复，但连续出现时应停止自动重试，
+ * 避免 UI 只显示泛化的 “connection closed” 并把用户拖进 5/5 的无意义等待。
+ */
+export declare function isOpenCodeRuntimeCrashError(errorMessage: string): boolean;
 //# sourceMappingURL=errors.d.ts.map

package/node_modules/@dcode/shared/dist/errors.js

@@ -70,4 +70,58 @@ export function normalizeUnknownError(error) {
 export function isDCodeFileLockTimeoutError(error) {
     return normalizeUnknownError(error).code === DCODE_FILE_LOCK_TIMEOUT_ERROR_CODE;
 }
+/**
+ * 不可自动重试的 workspace DCode Agent 预热错误模式列表。
+ *
+ * 这些错误代表确定性的配置/安装/鉴权问题，继续重试不会变好。
+ * 同时用于 MCP-fallback 降级判断：命中这些模式时不做 MCP 降级，因为错误与 MCP 无关。
+ */
+export const NON_RETRYABLE_WORKSPACE_PREPARE_ERROR_PATTERNS = [
+    "binary 未找到",
+    "未正确安装",
+    "binary not found",
+    "not installed",
+    "initialize 前进程已退出",
+    "initialize 超时",
+    "进程启动失败",
+    "optional dependency was not installed",
+    "Cannot find package '@openai/codex-",
+    "Missing optional dependency @openai/codex-",
+    "Missing Codex runtime files",
+    "Gemini API key is missing or not configured",
+    "Please fix the configuration file(s)",
+    "Expected property name or '}' in JSON",
+    "已暂停自动重试",
+];
+/**
+ * 额外的不可 MCP-fallback 降级的错误模式。
+ *
+ * session/new 超时属于 agent 自身启动/登录卡住，和 MCP 无关，降级也没用。
+ */
+export const NON_MCP_FALLBACK_EXTRA_ERROR_PATTERNS = ["session/new 超时"];
+const OPENCODE_RUNTIME_CRASH_ERROR_PATTERNS = [
+    "opencode runtime 崩溃",
+    "opencode runtime crashed",
+    "bun has crashed",
+    "segmentation fault",
+    "panic(main thread)",
+    "code=3221226505",
+];
+/**
+ * 判断错误消息是否代表确定性失败，不应自动重试 workspace DCode Agent 预热。
+ */
+export function isNonRetryableWorkspacePrepareError(errorMessage) {
+    const normalizedMessage = errorMessage.toLowerCase();
+    return NON_RETRYABLE_WORKSPACE_PREPARE_ERROR_PATTERNS.some((pattern) => normalizedMessage.includes(pattern.toLowerCase()));
+}
+/**
+ * 判断 OpenCode 是否命中 Bun/运行时崩溃。
+ *
+ * 这类错误不同于配置缺失：短时间内重建进程可能恢复，但连续出现时应停止自动重试，
+ * 避免 UI 只显示泛化的 “connection closed” 并把用户拖进 5/5 的无意义等待。
+ */
+export function isOpenCodeRuntimeCrashError(errorMessage) {
+    const normalizedMessage = errorMessage.toLowerCase();
+    return OPENCODE_RUNTIME_CRASH_ERROR_PATTERNS.some((pattern) => normalizedMessage.includes(pattern.toLowerCase()));
+}
 //# sourceMappingURL=errors.js.map

package/node_modules/@dcode/shared/dist/execution-state.d.ts

@@ -1,17 +1,19 @@
 import { z } from "zod";
 /** auto 保留为内部权限；plan 仅在旧格式读取边界接受。 */
 export declare const executionPermissionModeSchema: z.ZodEnum<{
+    auto: "auto";
     build: "build";
     edit: "edit";
     yolo: "yolo";
-    auto: "auto";
+    guarded: "guarded";
 }>;
 export declare const executionStateSchema: z.ZodObject<{
     mode: z.ZodEnum<{
+        auto: "auto";
         build: "build";
         edit: "edit";
         yolo: "yolo";
-        auto: "auto";
+        guarded: "guarded";
     }>;
     planEnabled: z.ZodBoolean;
 }, z.core.$strip>;

package/node_modules/@dcode/shared/dist/execution-state.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 /** auto 保留为内部权限；plan 仅在旧格式读取边界接受。 */
-export const executionPermissionModeSchema = z.enum(["build", "edit", "yolo", "auto"]);
+export const executionPermissionModeSchema = z.enum(["build", "edit", "yolo", "guarded", "auto"]);
 export const executionStateSchema = z.object({
     mode: executionPermissionModeSchema,
     planEnabled: z.boolean(),

package/node_modules/@dcode/shared/dist/feedback.d.ts

@@ -54,7 +54,7 @@ export interface CreateFeedbackTicketInput {
     /** 用户选填的联系方式（邮箱或其他社交账号），后端不强制要求。 */
     contact?: string;
     /** 当前界面语言，仅用于请求头透传，不写入后端工单正文。 */
-    locale?: "zh-CN" | "en-US";
+    locale?: "fr-CA" | "en-US";
 }
 export interface FeedbackTicketSummary {
     id: string;

package/node_modules/@dcode/shared/dist/gen-ui/contract.d.ts

@@ -0,0 +1,140 @@
+import { z } from "zod";
+export * from "./tweakProtocol.js";
+export declare const GEN_UI_HTML_MAX_BYTES = 5000000;
+export declare const GEN_UI_STATE_MAX_BYTES: number;
+export declare const GEN_UI_STATE_MAX_ENTRIES = 100;
+export declare const GEN_UI_CONTEXT_MAX_BYTES: number;
+export declare const GEN_UI_GLOBALS_EVENT = "dcode:set_globals";
+export declare const GEN_UI_STATE_CONTEXT_KEY = "dcode/genUiState";
+export declare const GEN_UI_TWEAK_CONTEXT_KEY = "dcode/genUiTweaks";
+export declare const GEN_UI_STATE_METHOD = "dcode/gen-ui/state";
+export declare const GEN_UI_FOLLOW_UP_METHOD = "dcode/gen-ui/follow-up";
+export declare const GEN_UI_TWEAK_METHOD = "dcode/gen-ui/tweak";
+export declare const GEN_UI_PRESENTATION_METHOD = "dcode/gen-ui/presentation";
+export declare const GEN_UI_STATIC_DOMAINS: readonly ["cdnjs.cloudflare.com", "esm.sh", "cdn.jsdelivr.net", "unpkg.com", "fonts.googleapis.com", "fonts.gstatic.com", "fonts.bunny.net"];
+/** This is a wire-format check. The executor owns normalization and filesystem authorization. */
+export declare const genUiPathSchema: z.ZodString;
+export declare const genUiReferenceSchema: z.ZodObject<{
+    path: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        wide: "wide";
+    }>>;
+}, z.core.$strict>;
+export type GenUiReference = z.infer<typeof genUiReferenceSchema>;
+export declare const genUiScopeSchema: z.ZodObject<{
+    workspacePath: z.ZodString;
+    workspaceIdentity: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodString;
+}, z.core.$strict>;
+export type GenUiScope = z.infer<typeof genUiScopeSchema>;
+export declare const genUiStateTargetSchema: z.ZodObject<{
+    workspacePath: z.ZodString;
+    workspaceIdentity: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>;
+export type GenUiStateTarget = z.infer<typeof genUiStateTargetSchema>;
+export declare const genUiWidgetStateSchema: z.ZodPipe<z.ZodObject<{
+    modelContent: z.ZodDefault<z.ZodUnknown>;
+    privateContent: z.ZodDefault<z.ZodUnknown>;
+}, z.core.$strict>, z.ZodTransform<{
+    modelContent: unknown;
+    privateContent: unknown;
+}, {
+    modelContent: unknown;
+    privateContent: unknown;
+}>>;
+export type GenUiWidgetState = z.infer<typeof genUiWidgetStateSchema>;
+export declare const genUiFollowUpSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export interface GenUiDocument {
+    path: string;
+    html: string;
+}
+export declare const genUiTweakControlSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"slider">;
+    value: z.ZodNumber;
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+    step: z.ZodOptional<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodString;
+    reference: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"color">;
+    value: z.ZodString;
+    id: z.ZodString;
+    label: z.ZodString;
+    reference: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"toggle">;
+    value: z.ZodBoolean;
+    id: z.ZodString;
+    label: z.ZodString;
+    reference: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"select">;
+    value: z.ZodString;
+    options: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strict>]>>;
+    id: z.ZodString;
+    label: z.ZodString;
+    reference: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "type">;
+export declare const genUiTweakSchema: z.ZodObject<{
+    title: z.ZodString;
+    controls: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"slider">;
+        value: z.ZodNumber;
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodString;
+        reference: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        value: z.ZodString;
+        id: z.ZodString;
+        label: z.ZodString;
+        reference: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        value: z.ZodBoolean;
+        id: z.ZodString;
+        label: z.ZodString;
+        reference: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        value: z.ZodString;
+        options: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strict>]>>;
+        id: z.ZodString;
+        label: z.ZodString;
+        reference: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "type">>;
+}, z.core.$strict>;
+export type GenUiTweak = z.infer<typeof genUiTweakSchema>;
+export type GenUiTweakValues = Record<string, string | number | boolean>;
+export interface GenUiStateEntry {
+    path: string;
+    state: GenUiWidgetState;
+}
+export interface GenUiStateChange {
+    target: GenUiStateTarget;
+    state: GenUiWidgetState | null;
+}
+export declare function buildGenUiScopeKey(scope: GenUiScope): string;
+export declare function buildGenUiStateKey(target: GenUiStateTarget): string;
+export declare function buildGenUiModelContext(entries: readonly GenUiStateEntry[]): string;
+export declare function stripGenUiModelContext(content: string): string;
+//# sourceMappingURL=contract.d.ts.map

package/node_modules/@dcode/shared/dist/gen-ui/contract.example.d.ts

@@ -0,0 +1,5 @@
+import type { GenUiReference, GenUiWidgetState, GenUiTweakMessage } from "./contract.js";
+export declare const exampleGenUiReference: GenUiReference;
+export declare const exampleGenUiState: GenUiWidgetState;
+export declare const exampleGenUiTweakRegistration: GenUiTweakMessage;
+//# sourceMappingURL=contract.example.d.ts.map

package/node_modules/@dcode/shared/dist/gen-ui/contract.example.js

@@ -0,0 +1,36 @@
+export const exampleGenUiReference = {
+    path: "/workspace/charts/sales.html",
+    title: "Sales",
+};
+export const exampleGenUiState = {
+    modelContent: { month: 6 },
+    privateContent: { tab: "chart" },
+};
+export const exampleGenUiTweakRegistration = {
+    type: "register",
+    registrationId: "tweak-1",
+    targets: [
+        {
+            id: "1",
+            label: "Player",
+            selector: "#player",
+            tagName: "div",
+            rect: { x: 0, y: 0, width: 200, height: 100 },
+        },
+    ],
+    annotationControls: {
+        controlsMode: "replace",
+        controls: [
+            {
+                type: "range",
+                callback: "tweak-1-1",
+                label: "Radius",
+                currentValue: 12,
+                min: 0,
+                max: 40,
+                step: 1,
+            },
+        ],
+    },
+};
+//# sourceMappingURL=contract.example.js.map

package/node_modules/@dcode/shared/dist/gen-ui/contract.js

@@ -0,0 +1,196 @@
+import { z } from "zod";
+export * from "./tweakProtocol.js";
+export const GEN_UI_HTML_MAX_BYTES = 5_000_000;
+export const GEN_UI_STATE_MAX_BYTES = 16 * 1024;
+export const GEN_UI_STATE_MAX_ENTRIES = 100;
+export const GEN_UI_CONTEXT_MAX_BYTES = 64 * 1024;
+export const GEN_UI_GLOBALS_EVENT = "dcode:set_globals";
+export const GEN_UI_STATE_CONTEXT_KEY = "dcode/genUiState";
+export const GEN_UI_TWEAK_CONTEXT_KEY = "dcode/genUiTweaks";
+export const GEN_UI_STATE_METHOD = "dcode/gen-ui/state";
+export const GEN_UI_FOLLOW_UP_METHOD = "dcode/gen-ui/follow-up";
+export const GEN_UI_TWEAK_METHOD = "dcode/gen-ui/tweak";
+export const GEN_UI_PRESENTATION_METHOD = "dcode/gen-ui/presentation";
+export const GEN_UI_STATIC_DOMAINS = [
+    "cdnjs.cloudflare.com",
+    "esm.sh",
+    "cdn.jsdelivr.net",
+    "unpkg.com",
+    "fonts.googleapis.com",
+    "fonts.gstatic.com",
+    "fonts.bunny.net",
+];
+/** This is a wire-format check. The executor owns normalization and filesystem authorization. */
+export const genUiPathSchema = z
+    .string()
+    .min(1)
+    .max(4096)
+    .refine((path) => {
+    if (path.includes("\0") || /[\r\n]/u.test(path))
+        return false;
+    const segments = path.split(/[\\/]/u);
+    return (/^(?:\/|[A-Za-z]:[\\/]|\\\\)/u.test(path) &&
+        !segments.includes("..") &&
+        /^[a-z0-9]+(?:-[a-z0-9]+)*\.html$/u.test(segments.at(-1) ?? ""));
+}, "Expected an absolute executor path to a lowercase-hyphenated HTML file");
+export const genUiReferenceSchema = z
+    .object({
+    path: genUiPathSchema,
+    title: z.string().max(250).optional(),
+    mode: z.enum(["wide"]).optional(),
+})
+    .strict();
+export const genUiScopeSchema = z
+    .object({
+    workspacePath: z.string().min(1).max(4096),
+    workspaceIdentity: z.string().max(4096).optional(),
+    sessionId: z.string().min(1).max(512),
+})
+    .strict();
+export const genUiStateTargetSchema = genUiScopeSchema.extend({ path: genUiPathSchema });
+function serializeJson(value) {
+    return JSON.stringify(value, (_key, item) => {
+        if (typeof item === "undefined" ||
+            typeof item === "function" ||
+            typeof item === "symbol" ||
+            typeof item === "bigint" ||
+            (typeof item === "number" && !Number.isFinite(item))) {
+            throw new Error("Widget state must contain JSON values only");
+        }
+        return item;
+    });
+}
+export const genUiWidgetStateSchema = z
+    .object({
+    modelContent: z.unknown().default(null),
+    privateContent: z.unknown().default(null),
+})
+    .strict()
+    .transform((state, context) => {
+    try {
+        const serialized = serializeJson(state);
+        if (new TextEncoder().encode(serialized).byteLength > GEN_UI_STATE_MAX_BYTES) {
+            throw new Error("Widget state exceeds 16 KiB");
+        }
+        return JSON.parse(serialized);
+    }
+    catch (error) {
+        context.addIssue({
+            code: "custom",
+            message: error instanceof Error ? error.message : "Invalid widget state",
+        });
+        return z.NEVER;
+    }
+});
+export const genUiFollowUpSchema = z
+    .object({
+    prompt: z
+        .string()
+        .trim()
+        .min(1)
+        .max(64 * 1024),
+    title: z.string().max(250).optional(),
+})
+    .strict();
+const controlBase = {
+    id: z.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/),
+    label: z.string().min(1).max(120),
+    reference: z
+        .string()
+        .regex(/^[\w./:@$#-]{1,160}$/u)
+        .optional(),
+};
+export const genUiTweakControlSchema = z.discriminatedUnion("type", [
+    z
+        .object({
+        ...controlBase,
+        type: z.literal("slider"),
+        value: z.number().finite(),
+        min: z.number().finite(),
+        max: z.number().finite(),
+        step: z.number().positive().optional(),
+        unit: z.string().max(24).optional(),
+    })
+        .strict(),
+    z
+        .object({
+        ...controlBase,
+        type: z.literal("color"),
+        value: z.string().regex(/^#(?:[\da-f]{3}|[\da-f]{4}|[\da-f]{6}|[\da-f]{8})$/i),
+    })
+        .strict(),
+    z.object({ ...controlBase, type: z.literal("toggle"), value: z.boolean() }).strict(),
+    z
+        .object({
+        ...controlBase,
+        type: z.literal("select"),
+        value: z.string().max(120),
+        options: z
+            .array(z.union([
+            z.string().min(1).max(120),
+            z.object({ label: z.string().min(1).max(120), value: z.string().max(120) }).strict(),
+        ]))
+            .min(1)
+            .max(12),
+    })
+        .strict(),
+]);
+export const genUiTweakSchema = z
+    .object({
+    title: z.string().min(1).max(120),
+    controls: z.array(genUiTweakControlSchema).min(1).max(12),
+})
+    .strict()
+    .superRefine((input, ctx) => {
+    const ids = new Set();
+    for (const control of input.controls) {
+        if (ids.has(control.id) ||
+            (control.type === "slider" &&
+                (control.min >= control.max ||
+                    control.value < control.min ||
+                    control.value > control.max)) ||
+            (control.type === "select" &&
+                !control.options.some((option) => (typeof option === "string" ? option : option.value) === control.value)))
+            ctx.addIssue({ code: "custom", message: "Invalid or duplicate tweak control" });
+        ids.add(control.id);
+    }
+});
+export function buildGenUiScopeKey(scope) {
+    return JSON.stringify([scope.workspaceIdentity?.trim() || scope.workspacePath, scope.sessionId]);
+}
+export function buildGenUiStateKey(target) {
+    return JSON.stringify([buildGenUiScopeKey(target), target.path]);
+}
+export function buildGenUiModelContext(entries) {
+    const selected = [];
+    for (const entry of [...entries]
+        .sort((a, b) => a.path.localeCompare(b.path))
+        .slice(0, GEN_UI_STATE_MAX_ENTRIES)) {
+        const parsed = genUiWidgetStateSchema.safeParse(entry.state);
+        if (!parsed.success || parsed.data.modelContent === null)
+            continue;
+        const next = { path: entry.path, state: parsed.data.modelContent };
+        if (new TextEncoder().encode(JSON.stringify([...selected, next])).length >
+            GEN_UI_CONTEXT_MAX_BYTES)
+            break;
+        selected.push(next);
+    }
+    return selected.length
+        ? `<untrusted_gen_ui_state>\n${JSON.stringify(selected).replaceAll("<", "\\u003c")}\n</untrusted_gen_ui_state>`
+        : "";
+}
+export function stripGenUiModelContext(content) {
+    const match = /\n\n<untrusted_gen_ui_state>\n([^]*?)\n<\/untrusted_gen_ui_state>\s*$/u.exec(content);
+    if (!match)
+        return content;
+    try {
+        z.array(z.object({ path: genUiPathSchema, state: z.unknown() }).strict())
+            .max(GEN_UI_STATE_MAX_ENTRIES)
+            .parse(JSON.parse(match[1]));
+        return content.slice(0, match.index);
+    }
+    catch {
+        return content;
+    }
+}
+//# sourceMappingURL=contract.js.map

package/node_modules/@dcode/shared/dist/gen-ui/contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.test.d.ts.map