owndesign 0.1.3 → 0.1.7

package/dist/server/index.js

@@ -48170,6 +48170,20 @@ function isLegacyMessage(message) {
   return typeof message === "object" && message !== null && "content" in message && typeof message.content === "string" && "role" in message && (message.role === "assistant" || message.role === "user");
 }
 
+// ../core/src/conversations/default-title.ts
+var FALLBACK_CONVERSATION_TITLE = "\u65B0\u5EFA\u4F1A\u8BDD";
+var DEFAULT_CONVERSATION_TITLES = {
+  "en-US": "",
+  "zh-CN": FALLBACK_CONVERSATION_TITLE
+};
+function getDefaultConversationTitle(language) {
+  return DEFAULT_CONVERSATION_TITLES[language] || FALLBACK_CONVERSATION_TITLE;
+}
+function normalizeDefaultConversationTitle(title) {
+  const trimmedTitle = title?.trim();
+  return trimmedTitle || FALLBACK_CONVERSATION_TITLE;
+}
+
 // ../../node_modules/.pnpm/@ai-sdk+anthropic@3.0.81_zod@4.4.3/node_modules/@ai-sdk/anthropic/dist/index.mjs
 var VERSION5 = true ? "3.0.81" : "0.0.0-test";
 var anthropicErrorDataSchema = lazySchema(
@@ -56628,199 +56642,49 @@ function isMissingPathError(error51) {
   return typeof error51 === "object" && error51 !== null && "code" in error51 && error51.code === "ENOENT";
 }
 
-// ../core/src/realtime/frontend-capabilities.ts
-var FRONTEND_CAPABILITIES = {
-  "preview.refresh": {
-    description: "Refresh the current Preview Pane without changing HTML file.",
-    payloadSchema: {
-      type: "object",
-      properties: {},
-      additionalProperties: false
+// ../core/src/agent/tools/core.ts
+function createWorkspaceToolRegistry(definitions, context2) {
+  const tools = {};
+  const metadata = {};
+  for (const definition of definitions) {
+    if (tools[definition.name]) {
+      throw new Error(`Project Workspace tool already registered: ${definition.name}`);
     }
-  },
-  "preview.switchHtml": {
-    description: "Switch the Preview Pane to an existing HTML file.",
-    payloadSchema: {
-      type: "object",
-      properties: {
-        path: {
-          type: "string",
-          description: "Relative HTML file path inside the Project Workspace to show in the Preview Pane."
+    metadata[definition.name] = {
+      parallelSafe: definition.parallelSafe
+    };
+    tools[definition.name] = tool({
+      description: definition.description,
+      inputSchema: definition.inputSchema,
+      execute: async (input) => {
+        const startedAt = performance.now();
+        try {
+          const parsedInput = definition.inputSchema.parse(input);
+          definition.validate?.(parsedInput);
+          const output = await definition.execute(parsedInput, context2);
+          return {
+            ok: true,
+            output,
+            wallTimeMs: elapsedWallTime(startedAt)
+          };
+        } catch (error51) {
+          return {
+            error: error51 instanceof Error ? error51.message : String(error51),
+            ok: false,
+            wallTimeMs: elapsedWallTime(startedAt)
+          };
         }
-      },
-      required: ["path"],
-      additionalProperties: false
-    }
-  }
-};
-var FRONTEND_CAPABILITY_IDS = Object.keys(
-  FRONTEND_CAPABILITIES
-);
-function isFrontendCapabilityId(value) {
-  return typeof value === "string" && FRONTEND_CAPABILITY_IDS.includes(value);
-}
-function validateFrontendCapabilityPayload(capability, payload) {
-  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
-    throw new Error(`Frontend capability payload must be an object: ${capability}`);
-  }
-  if (capability === "preview.refresh") {
-    if (Object.keys(payload).length > 0) {
-      throw new Error("preview.refresh payload must be empty.");
-    }
-    return {};
-  }
-  if (!("path" in payload) || typeof payload.path !== "string" || !payload.path.trim()) {
-    throw new Error("preview.switchHtml payload.path must be a non-empty string.");
-  }
-  return {
-    path: payload.path
-  };
-}
-function buildFrontendCapabilityPrompt() {
-  return [
-    "## Frontend Capabilities",
-    "Use `callFrontendCapability` only to notify the browser UI after Project Workspace file changes are complete. It does not create, edit, or validate files.",
-    "After successful previewable HTML changes, call exactly one preview capability before the final user-facing summary.",
-    "Do not call a preview capability when no previewable HTML file changed or the file operation failed.",
-    "Use the current user request to decide which capability is needed:",
-    "- Use `preview.switchHtml` only when the Preview Pane should move to a different existing relative `.html` file inside the Project Workspace.",
-    "- Use `preview.refresh` when the Preview Pane is already showing the correct page and only needs to reload changed HTML.",
-    "Do not use workspace file tools to simulate preview switching or refreshing.",
-    "Available capabilities:",
-    ...FRONTEND_CAPABILITY_IDS.map((capability) => {
-      const schema = JSON.stringify(
-        FRONTEND_CAPABILITIES[capability].payloadSchema
-      );
-      return `- ${capability}: ${FRONTEND_CAPABILITIES[capability].description} Payload schema: ${schema}`;
-    })
-  ].join("\n");
-}
-
-// ../core/src/realtime/frontend-command-bus.ts
-var KEEPALIVE_INTERVAL_MS = 15e3;
-var FrontendCommandBus = class {
-  connections = /* @__PURE__ */ new Map();
-  registerConnection({
-    frontendTabId,
-    projectId,
-    signal
-  }) {
-    const key = buildConnectionKey(projectId, frontendTabId);
-    const encoder = new TextEncoder();
-    let connection;
-    const stream2 = new ReadableStream({
-      start: (controller) => {
-        this.unregisterConnection(projectId, frontendTabId);
-        connection = {
-          controller,
-          encoder,
-          keepaliveTimer: setInterval(() => {
-            enqueueSseComment(controller, encoder, "keepalive");
-          }, KEEPALIVE_INTERVAL_MS)
-        };
-        connection.keepaliveTimer.unref?.();
-        this.connections.set(key, connection);
-        enqueueSseComment(controller, encoder, "connected");
-        signal?.addEventListener(
-          "abort",
-          () => {
-            this.unregisterConnection(projectId, frontendTabId);
-          },
-          { once: true }
-        );
-      },
-      cancel: () => {
-        this.unregisterConnection(projectId, frontendTabId);
       }
     });
-    return stream2;
-  }
-  sendCommand({
-    capability,
-    frontendTabId,
-    payload,
-    projectId
-  }) {
-    const connection = this.connections.get(
-      buildConnectionKey(projectId, frontendTabId)
-    );
-    if (!connection) {
-      return {
-        delivered: false,
-        command: void 0
-      };
-    }
-    const command = {
-      capability,
-      id: createCommandId(),
-      payload
-    };
-    enqueueSseEvent(
-      connection.controller,
-      connection.encoder,
-      "frontend-command",
-      command
-    );
-    return {
-      command,
-      delivered: true
-    };
-  }
-  unregisterConnection(projectId, frontendTabId) {
-    const key = buildConnectionKey(projectId, frontendTabId);
-    const connection = this.connections.get(key);
-    if (!connection) {
-      return;
-    }
-    this.connections.delete(key);
-    clearInterval(connection.keepaliveTimer);
-    try {
-      connection.controller.close();
-    } catch {
-    }
-  }
-  hasConnection(projectId, frontendTabId) {
-    return this.connections.has(buildConnectionKey(projectId, frontendTabId));
-  }
-  clear() {
-    for (const key of Array.from(this.connections.keys())) {
-      const [projectId, frontendTabId] = parseConnectionKey(key);
-      this.unregisterConnection(projectId, frontendTabId);
-    }
   }
-};
-function getFrontendCommandBus() {
-  globalThis.__owndesignFrontendCommandBus ??= new FrontendCommandBus();
-  return globalThis.__owndesignFrontendCommandBus;
-}
-function registerFrontendConnection(input) {
-  return getFrontendCommandBus().registerConnection(input);
-}
-function sendFrontendCommand(input) {
-  return getFrontendCommandBus().sendCommand(input);
-}
-function enqueueSseEvent(controller, encoder, event, data) {
-  controller.enqueue(
-    encoder.encode(`event: ${event}
-data: ${JSON.stringify(data)}
-
-`)
-  );
-}
-function enqueueSseComment(controller, encoder, comment) {
-  controller.enqueue(encoder.encode(`: ${comment}
-
-`));
-}
-function buildConnectionKey(projectId, frontendTabId) {
-  return `${encodeURIComponent(projectId)}:${encodeURIComponent(frontendTabId)}`;
-}
-function parseConnectionKey(key) {
-  const [projectId = "", frontendTabId = ""] = key.split(":");
-  return [decodeURIComponent(projectId), decodeURIComponent(frontendTabId)];
+  Object.defineProperty(tools, "__metadata", {
+    enumerable: false,
+    value: metadata
+  });
+  return tools;
 }
-function createCommandId() {
-  return typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+function elapsedWallTime(startedAt) {
+  return Math.max(0, Math.round((performance.now() - startedAt) * 100) / 100);
 }
 
 // ../core/src/agent/page-edit-mode.ts
@@ -57230,7 +57094,7 @@ async function readRequiredHtmlFile(workspaceStore, projectId, relativePath, mod
 async function resolveUniqueCopyPath(workspaceStore, projectId, sourcePath) {
   const parsed = path3.posix.parse(sourcePath);
   const directory = parsed.dir ? `${parsed.dir}/` : "";
-  const baseName = parsed.name;
+  const baseName = normalizeCopyBaseName(parsed.name);
   const extension = parsed.ext || ".html";
   for (let index = 1; index < 1e3; index += 1) {
     const suffix = index === 1 ? "copy" : `copy-${index}`;
@@ -57243,184 +57107,49 @@ async function resolveUniqueCopyPath(workspaceStore, projectId, sourcePath) {
   }
   throw new Error(`Could not create a unique copy path for ${sourcePath}.`);
 }
+function normalizeCopyBaseName(baseName) {
+  return baseName.replace(/\.copy(?:-\d+)?$/, "");
+}
 
-// ../core/src/agent/tools/call-frontend-capability.ts
-function createCallFrontendCapabilityToolDefinition() {
+// ../core/src/agent/tools/copy-file.ts
+function createCopyFileToolDefinition() {
   return {
-    description: "Call a fixed frontend browser capability for the active tab, such as switching or refreshing the Preview Pane.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        capability: {
-          type: "string",
-          enum: FRONTEND_CAPABILITY_IDS,
-          description: "Frontend capability ID to call."
-        },
-        payload: {
-          type: "object",
-          description: "Capability-specific payload."
-        }
-      },
-      required: ["capability", "payload"],
-      additionalProperties: false
-    },
-    name: "callFrontendCapability",
+    description: "Copy one UTF-8 text file inside the current Project Workspace to a new path. Never overwrites existing files.",
+    inputSchema: external_exports.object({
+      sourcePath: external_exports.string().describe("Relative source file path inside the Project Workspace."),
+      targetPath: external_exports.string().describe("Relative destination file path inside the Project Workspace. Must not already exist.")
+    }).strict(),
+    name: "copyFile",
     parallelSafe: false,
-    execute: async (input, context2) => {
-      if (!context2.frontendTabId) {
-        throw new Error("Frontend tab id is required to call frontend capabilities.");
-      }
-      if (!isFrontendCapabilityId(input.capability)) {
-        throw new Error(`Unknown frontend capability: ${input.capability}`);
+    execute: async ({ sourcePath, targetPath }, { approvedCdnUrls, pageEditModePolicy, projectId, workspaceStore }) => {
+      const normalizedSourcePath = normalizeToolPath(sourcePath);
+      const normalizedTargetPath = normalizeToolPath(targetPath);
+      assertCopyFileAllowed(
+        pageEditModePolicy,
+        normalizedSourcePath,
+        normalizedTargetPath
+      );
+      const existingTarget = await readProjectWorkspaceFileIfExists(
+        workspaceStore,
+        projectId,
+        normalizedTargetPath
+      );
+      if (existingTarget !== void 0) {
+        throw new Error(
+          `Project Workspace file already exists: ${normalizedTargetPath}`
+        );
       }
-      const payload = await normalizePayload(input.capability, input.payload, context2);
-      const result = sendCapabilityCommand(input.capability, payload, context2);
-      return {
-        capability: input.capability,
-        delivered: result?.delivered ?? false,
-        payload
-      };
-    }
-  };
-}
-async function normalizePayload(capability, payload, context2) {
-  const validated = validateFrontendCapabilityPayload(capability, payload);
-  if (capability === "preview.refresh") {
-    return validated;
-  }
-  const targetPath = normalizeToolPath(validated.path);
-  if (!targetPath || targetPath === ".") {
-    throw new Error("Preview switch target path must not be empty.");
-  }
-  if (!isHtmlPath(targetPath)) {
-    throw new Error(`Preview switch target must end with .html: ${targetPath}`);
-  }
-  const previewPath = resolveHtmlOperationPathForPageEditModePolicy(
-    context2.pageEditModePolicy,
-    "preview",
-    targetPath
-  );
-  const htmlFiles = await context2.workspaceStore.listProjectHtmlFiles(
-    context2.projectId
-  );
-  if (!htmlFiles.includes(previewPath)) {
-    throw new Error(`Project Workspace HTML file was not found: ${previewPath}`);
-  }
-  return {
-    path: previewPath
-  };
-}
-function sendCapabilityCommand(capability, payload, context2) {
-  if (capability === "preview.refresh") {
-    return sendFrontendCommand({
-      capability,
-      frontendTabId: context2.frontendTabId ?? "",
-      payload,
-      projectId: context2.projectId
-    });
-  }
-  return sendFrontendCommand({
-    capability,
-    frontendTabId: context2.frontendTabId ?? "",
-    payload,
-    projectId: context2.projectId
-  });
-}
-
-// ../core/src/agent/tools/core.ts
-function createWorkspaceToolRegistry(definitions, context2) {
-  const tools = {};
-  const metadata = {};
-  for (const definition of definitions) {
-    if (tools[definition.name]) {
-      throw new Error(`Project Workspace tool already registered: ${definition.name}`);
-    }
-    metadata[definition.name] = {
-      parallelSafe: definition.parallelSafe
-    };
-    tools[definition.name] = tool({
-      description: definition.description,
-      inputSchema: jsonSchema(definition.inputSchema),
-      execute: async (input) => {
-        const startedAt = performance.now();
-        try {
-          definition.validate?.(input);
-          const output = await definition.execute(input, context2);
-          return {
-            ok: true,
-            output,
-            wallTimeMs: elapsedWallTime(startedAt)
-          };
-        } catch (error51) {
-          return {
-            error: error51 instanceof Error ? error51.message : String(error51),
-            ok: false,
-            wallTimeMs: elapsedWallTime(startedAt)
-          };
-        }
-      }
-    });
-  }
-  Object.defineProperty(tools, "__metadata", {
-    enumerable: false,
-    value: metadata
-  });
-  return tools;
-}
-function elapsedWallTime(startedAt) {
-  return Math.max(0, Math.round((performance.now() - startedAt) * 100) / 100);
-}
-
-// ../core/src/agent/tools/copy-file.ts
-function createCopyFileToolDefinition() {
-  return {
-    description: "Copy one UTF-8 text file inside the current Project Workspace to a new path. Never overwrites existing files.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        sourcePath: {
-          type: "string",
-          description: "Relative source file path inside the Project Workspace."
-        },
-        targetPath: {
-          type: "string",
-          description: "Relative destination file path inside the Project Workspace. Must not already exist."
-        }
-      },
-      required: ["sourcePath", "targetPath"],
-      additionalProperties: false
-    },
-    name: "copyFile",
-    parallelSafe: false,
-    execute: async ({ sourcePath, targetPath }, { approvedCdnUrls, pageEditModePolicy, projectId, workspaceStore }) => {
-      const normalizedSourcePath = normalizeToolPath(sourcePath);
-      const normalizedTargetPath = normalizeToolPath(targetPath);
-      assertCopyFileAllowed(
-        pageEditModePolicy,
-        normalizedSourcePath,
-        normalizedTargetPath
-      );
-      const existingTarget = await readProjectWorkspaceFileIfExists(
-        workspaceStore,
-        projectId,
-        normalizedTargetPath
-      );
-      if (existingTarget !== void 0) {
-        throw new Error(
-          `Project Workspace file already exists: ${normalizedTargetPath}`
-        );
-      }
-      const sourceContent = await workspaceStore.readProjectWorkspaceFile(
-        projectId,
-        normalizedSourcePath
-      );
-      return writeProjectWorkspaceFileWithCdnGuard(
-        workspaceStore,
-        projectId,
-        normalizedTargetPath,
-        sourceContent,
-        approvedCdnUrls
-      );
+      const sourceContent = await workspaceStore.readProjectWorkspaceFile(
+        projectId,
+        normalizedSourcePath
+      );
+      return writeProjectWorkspaceFileWithCdnGuard(
+        workspaceStore,
+        projectId,
+        normalizedTargetPath,
+        sourceContent,
+        approvedCdnUrls
+      );
     }
   };
 }
@@ -57430,29 +57159,12 @@ var DEFAULT_TITLE = "OwnDesign Preview";
 function createCreateHtmlToolDefinition() {
   return {
     description: "Create a new previewable HTML file from the configured resource template before designing a missing target HTML page. Never overwrites existing files.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        fontLibraryName: {
-          type: "string",
-          description: "Optional configured font library name. Omit to use the default font library. Pass an empty string to disable font resources."
-        },
-        iconLibraryName: {
-          type: "string",
-          description: "Optional configured icon library name. Omit to use the default icon library. Pass an empty string to disable icon resources."
-        },
-        path: {
-          type: "string",
-          description: "Relative HTML file path inside the Project Workspace, such as index.html or pages/detail.html."
-        },
-        title: {
-          type: "string",
-          description: "Optional document title. Defaults to OwnDesign Preview."
-        }
-      },
-      required: ["path"],
-      additionalProperties: false
-    },
+    inputSchema: external_exports.object({
+      fontLibraryName: external_exports.string().describe("Optional configured font library name. Omit to use the default font library. Pass an empty string to disable font resources.").optional(),
+      iconLibraryName: external_exports.string().describe("Optional configured icon library name. Omit to use the default icon library. Pass an empty string to disable icon resources.").optional(),
+      path: external_exports.string().describe("Relative HTML file path inside the Project Workspace, such as index.html or pages/detail.html."),
+      title: external_exports.string().describe("Optional document title. Defaults to OwnDesign Preview.").optional()
+    }).strict(),
     name: "createHtml",
     parallelSafe: false,
     execute: async (input, {
@@ -57571,17 +57283,9 @@ function escapeHtmlText(value) {
 function createDeleteToolDefinition() {
   return {
     description: "Recursively delete a file or directory from the current Project Workspace.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        path: {
-          type: "string",
-          description: "Relative file or directory path inside the Project Workspace."
-        }
-      },
-      required: ["path"],
-      additionalProperties: false
-    },
+    inputSchema: external_exports.object({
+      path: external_exports.string().describe("Relative file or directory path inside the Project Workspace.")
+    }).strict(),
     name: "delete",
     parallelSafe: false,
     execute: async ({ path: path16 }, {
@@ -57599,29 +57303,12 @@ function createDeleteToolDefinition() {
 function createEditToolDefinition() {
   return {
     description: "Edit one UTF-8 text file by replacing oldString with newString. By default oldString must occur exactly once; set replaceAll to replace every occurrence.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        newString: {
-          type: "string",
-          description: "Replacement text."
-        },
-        oldString: {
-          type: "string",
-          description: "Text to replace."
-        },
-        path: {
-          type: "string",
-          description: "Relative file path inside the Project Workspace."
-        },
-        replaceAll: {
-          type: "boolean",
-          description: "Replace every occurrence of oldString instead of requiring exactly one match."
-        }
-      },
-      required: ["path", "oldString", "newString"],
-      additionalProperties: false
-    },
+    inputSchema: external_exports.object({
+      newString: external_exports.string().describe("Replacement text."),
+      oldString: external_exports.string().describe("Text to replace."),
+      path: external_exports.string().describe("Relative file path inside the Project Workspace."),
+      replaceAll: external_exports.boolean().describe("Replace every occurrence of oldString instead of requiring exactly one match.").optional()
+    }).strict(),
     name: "edit",
     parallelSafe: false,
     execute: async ({ newString, oldString, path: path16, replaceAll }, {
@@ -57652,21 +57339,10 @@ function createEditToolDefinition() {
 function createGlobToolDefinition() {
   return {
     description: "Find files and directories in the current Project Workspace by glob pattern, sorted by most recently modified first.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        path: {
-          type: "string",
-          description: "Optional relative directory path inside the Project Workspace to search from."
-        },
-        pattern: {
-          type: "string",
-          description: 'Glob pattern such as "**/*.html", "assets/*.{css,js}", or "index.html".'
-        }
-      },
-      required: ["pattern"],
-      additionalProperties: false
-    },
+    inputSchema: external_exports.object({
+      path: external_exports.string().describe("Optional relative directory path inside the Project Workspace to search from.").optional(),
+      pattern: external_exports.string().describe('Glob pattern such as "**/*.html", "assets/*.{css,js}", or "index.html".')
+    }).strict(),
     name: "glob",
     parallelSafe: true,
     execute: async ({ path: path16, pattern }, {
@@ -57686,25 +57362,11 @@ function createGlobToolDefinition() {
 function createGrepToolDefinition() {
   return {
     description: "Search UTF-8 text files in the current Project Workspace using a JavaScript regular expression.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        include: {
-          type: "string",
-          description: 'Optional file glob to include, such as "*.html" or "**/*.{css,js}".'
-        },
-        path: {
-          type: "string",
-          description: "Optional relative file or directory path inside the Project Workspace to search."
-        },
-        pattern: {
-          type: "string",
-          description: "JavaScript regular expression pattern to search for."
-        }
-      },
-      required: ["pattern"],
-      additionalProperties: false
-    },
+    inputSchema: external_exports.object({
+      include: external_exports.string().describe('Optional file glob to include, such as "*.html" or "**/*.{css,js}".').optional(),
+      path: external_exports.string().describe("Optional relative file or directory path inside the Project Workspace to search.").optional(),
+      pattern: external_exports.string().describe("JavaScript regular expression pattern to search for.")
+    }).strict(),
     name: "grep",
     parallelSafe: true,
     execute: async ({ include, path: path16, pattern }, {
@@ -57723,51 +57385,33 @@ function createGrepToolDefinition() {
 function createPatchToolDefinition() {
   return {
     description: "Apply coordinated UTF-8 file changes inside the current Project Workspace. Supports add/write, edit, and delete changes.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        changes: {
-          type: "array",
-          minItems: 1,
-          items: {
-            type: "object",
-            properties: {
-              content: {
-                type: "string",
-                description: "Complete file content for add or write operations."
-              },
-              newString: {
-                type: "string",
-                description: "Replacement text for edit operations."
-              },
-              oldString: {
-                type: "string",
-                description: "Text to replace for edit operations."
-              },
-              operation: {
-                type: "string",
-                enum: ["add", "write", "edit", "delete"]
-              },
-              path: {
-                type: "string",
-                description: "Relative file or directory path inside the Project Workspace."
-              },
-              replaceAll: {
-                type: "boolean",
-                description: "For edit operations, replace every occurrence of oldString."
-              }
-            },
-            required: ["operation", "path"],
-            additionalProperties: false
-          }
-        }
-      },
-      required: ["changes"],
-      additionalProperties: false
-    },
+    inputSchema: external_exports.object({
+      changes: external_exports.array(external_exports.discriminatedUnion("operation", [
+        external_exports.object({
+          content: external_exports.string().describe("Complete file content for add operations."),
+          operation: external_exports.literal("add"),
+          path: external_exports.string().describe("Relative file or directory path inside the Project Workspace.")
+        }).strict(),
+        external_exports.object({
+          content: external_exports.string().describe("Complete file content for write operations."),
+          operation: external_exports.literal("write"),
+          path: external_exports.string().describe("Relative file or directory path inside the Project Workspace.")
+        }).strict(),
+        external_exports.object({
+          newString: external_exports.string().describe("Replacement text for edit operations."),
+          oldString: external_exports.string().describe("Text to replace for edit operations."),
+          operation: external_exports.literal("edit"),
+          path: external_exports.string().describe("Relative file or directory path inside the Project Workspace."),
+          replaceAll: external_exports.boolean().describe("For edit operations, replace every occurrence of oldString.").optional()
+        }).strict(),
+        external_exports.object({
+          operation: external_exports.literal("delete"),
+          path: external_exports.string().describe("Relative file or directory path inside the Project Workspace.")
+        }).strict()
+      ])).min(1)
+    }).strict(),
     name: "patch",
     parallelSafe: false,
-    validate: validatePatchInput,
     execute: async ({ changes }, { approvedCdnUrls, pageEditModePolicy, projectId, workspaceStore }) => {
       const resolvedChanges = changes.map((change) => ({
         ...change,
@@ -57786,66 +57430,217 @@ function createPatchToolDefinition() {
     }
   };
 }
-function validatePatchInput(input) {
-  if (!Array.isArray(input.changes) || input.changes.length === 0) {
-    throw new Error("patch.changes must include at least one change.");
+
+// ../core/src/realtime/frontend-command-bus.ts
+var KEEPALIVE_INTERVAL_MS = 15e3;
+var FrontendCommandBus = class {
+  connections = /* @__PURE__ */ new Map();
+  registerConnection({
+    frontendTabId,
+    projectId,
+    signal
+  }) {
+    const key = buildConnectionKey(projectId, frontendTabId);
+    const encoder = new TextEncoder();
+    let connection;
+    const stream2 = new ReadableStream({
+      start: (controller) => {
+        this.unregisterConnection(projectId, frontendTabId);
+        connection = {
+          controller,
+          encoder,
+          keepaliveTimer: setInterval(() => {
+            enqueueSseComment(controller, encoder, "keepalive");
+          }, KEEPALIVE_INTERVAL_MS)
+        };
+        connection.keepaliveTimer.unref?.();
+        this.connections.set(key, connection);
+        enqueueSseComment(controller, encoder, "connected");
+        signal?.addEventListener(
+          "abort",
+          () => {
+            this.unregisterConnection(projectId, frontendTabId);
+          },
+          { once: true }
+        );
+      },
+      cancel: () => {
+        this.unregisterConnection(projectId, frontendTabId);
+      }
+    });
+    return stream2;
   }
-  for (const [index, change] of input.changes.entries()) {
-    const label = `patch.changes[${index}]`;
-    if (!change.path) {
-      throw new Error(`${label}.path must not be empty.`);
+  sendCommand({
+    capability,
+    frontendTabId,
+    payload,
+    projectId
+  }) {
+    const connection = this.connections.get(
+      buildConnectionKey(projectId, frontendTabId)
+    );
+    if (!connection) {
+      return {
+        delivered: false,
+        command: void 0
+      };
     }
-    if (change.operation === "edit") {
-      if (typeof change.oldString !== "string" || typeof change.newString !== "string") {
-        throw new Error(`${label} edit changes require oldString and newString.`);
-      }
-      if ("content" in change) {
-        throw new Error(`${label} edit changes must not include content.`);
-      }
-      continue;
+    const command = {
+      capability,
+      id: createCommandId(),
+      payload
+    };
+    enqueueSseEvent(
+      connection.controller,
+      connection.encoder,
+      "frontend-command",
+      command
+    );
+    return {
+      command,
+      delivered: true
+    };
+  }
+  unregisterConnection(projectId, frontendTabId) {
+    const key = buildConnectionKey(projectId, frontendTabId);
+    const connection = this.connections.get(key);
+    if (!connection) {
+      return;
+    }
+    this.connections.delete(key);
+    clearInterval(connection.keepaliveTimer);
+    try {
+      connection.controller.close();
+    } catch {
+    }
+  }
+  hasConnection(projectId, frontendTabId) {
+    return this.connections.has(buildConnectionKey(projectId, frontendTabId));
+  }
+  clear() {
+    for (const key of Array.from(this.connections.keys())) {
+      const [projectId, frontendTabId] = parseConnectionKey(key);
+      this.unregisterConnection(projectId, frontendTabId);
+    }
+  }
+};
+function getFrontendCommandBus() {
+  globalThis.__owndesignFrontendCommandBus ??= new FrontendCommandBus();
+  return globalThis.__owndesignFrontendCommandBus;
+}
+function registerFrontendConnection(input) {
+  return getFrontendCommandBus().registerConnection(input);
+}
+function sendFrontendCommand(input) {
+  return getFrontendCommandBus().sendCommand(input);
+}
+function enqueueSseEvent(controller, encoder, event, data) {
+  controller.enqueue(
+    encoder.encode(`event: ${event}
+data: ${JSON.stringify(data)}
+
+`)
+  );
+}
+function enqueueSseComment(controller, encoder, comment) {
+  controller.enqueue(encoder.encode(`: ${comment}
+
+`));
+}
+function buildConnectionKey(projectId, frontendTabId) {
+  return `${encodeURIComponent(projectId)}:${encodeURIComponent(frontendTabId)}`;
+}
+function parseConnectionKey(key) {
+  const [projectId = "", frontendTabId = ""] = key.split(":");
+  return [decodeURIComponent(projectId), decodeURIComponent(frontendTabId)];
+}
+function createCommandId() {
+  return typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+
+// ../core/src/agent/tools/preview-refresh.ts
+function createPreviewRefreshToolDefinition() {
+  return {
+    description: "Refresh the current Preview Pane after successful previewable HTML changes without changing HTML file.",
+    inputSchema: external_exports.object({}).strict(),
+    name: "previewRefresh",
+    parallelSafe: false,
+    execute: (_input, context2) => {
+      if (!context2.frontendTabId) {
+        throw new Error("Frontend tab id is required to refresh the preview.");
+      }
+      const payload = {};
+      const result = sendFrontendCommand({
+        capability: "preview.refresh",
+        frontendTabId: context2.frontendTabId,
+        payload,
+        projectId: context2.projectId
+      });
+      return {
+        capability: "preview.refresh",
+        delivered: result?.delivered ?? false,
+        payload
+      };
     }
-    if (change.operation === "add" || change.operation === "write") {
-      if (typeof change.content !== "string") {
-        throw new Error(`${label} ${change.operation} changes require content.`);
+  };
+}
+
+// ../core/src/agent/tools/preview-switch-html.ts
+function createPreviewSwitchHtmlToolDefinition() {
+  return {
+    description: "Switch the Preview Pane to an existing HTML file after successful previewable HTML changes.",
+    inputSchema: external_exports.object({
+      path: external_exports.string().describe("Relative HTML file path inside the Project Workspace to show in the Preview Pane.")
+    }).strict(),
+    name: "previewSwitchHtml",
+    parallelSafe: false,
+    execute: async ({ path: path16 }, context2) => {
+      if (!context2.frontendTabId) {
+        throw new Error("Frontend tab id is required to switch the preview.");
       }
-      if ("oldString" in change || "newString" in change || "replaceAll" in change) {
-        throw new Error(`${label} ${change.operation} changes must not include edit fields.`);
+      const targetPath = normalizeToolPath(path16);
+      if (!targetPath || targetPath === ".") {
+        throw new Error("Preview switch target path must not be empty.");
       }
-      continue;
-    }
-    if (change.operation === "delete") {
-      if ("content" in change || "oldString" in change || "newString" in change || "replaceAll" in change) {
-        throw new Error(`${label} delete changes must not include content or edit fields.`);
+      if (!isHtmlPath(targetPath)) {
+        throw new Error(`Preview switch target must end with .html: ${targetPath}`);
       }
-      continue;
+      const previewPath = resolveHtmlOperationPathForPageEditModePolicy(
+        context2.pageEditModePolicy,
+        "preview",
+        targetPath
+      );
+      const htmlFiles = await context2.workspaceStore.listProjectHtmlFiles(
+        context2.projectId
+      );
+      if (!htmlFiles.includes(previewPath)) {
+        throw new Error(`Project Workspace HTML file was not found: ${previewPath}`);
+      }
+      const payload = { path: previewPath };
+      const result = sendFrontendCommand({
+        capability: "preview.switchHtml",
+        frontendTabId: context2.frontendTabId,
+        payload,
+        projectId: context2.projectId
+      });
+      return {
+        capability: "preview.switchHtml",
+        delivered: result?.delivered ?? false,
+        payload
+      };
     }
-    throw new Error(`${label}.operation is not supported.`);
-  }
+  };
 }
 
 // ../core/src/agent/tools/read.ts
 function createReadToolDefinition() {
   return {
     description: "Read one UTF-8 file or directory from the current Project Workspace. Files are returned with 1-indexed line numbers.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        limit: {
-          type: "number",
-          description: "Maximum number of lines or directory entries to read. Defaults to 2000."
-        },
-        offset: {
-          type: "number",
-          description: "1-indexed line or directory-entry offset to start reading from. Defaults to 1."
-        },
-        path: {
-          type: "string",
-          description: "Relative file or directory path inside the Project Workspace."
-        }
-      },
-      required: ["path"],
-      additionalProperties: false
-    },
+    inputSchema: external_exports.object({
+      limit: external_exports.number().describe("Maximum number of lines or directory entries to read. Defaults to 2000.").optional(),
+      offset: external_exports.number().describe("1-indexed line or directory-entry offset to start reading from. Defaults to 1.").optional(),
+      path: external_exports.string().describe("Relative file or directory path inside the Project Workspace.")
+    }).strict(),
     name: "read",
     parallelSafe: true,
     execute: async ({ limit, offset, path: path16 }, {
@@ -57868,21 +57663,10 @@ function createReadToolDefinition() {
 function createWriteToolDefinition() {
   return {
     description: "Create or overwrite one UTF-8 text file in the current Project Workspace.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        content: {
-          type: "string",
-          description: "Complete UTF-8 text file content."
-        },
-        path: {
-          type: "string",
-          description: "Relative file path inside the Project Workspace."
-        }
-      },
-      required: ["path", "content"],
-      additionalProperties: false
-    },
+    inputSchema: external_exports.object({
+      content: external_exports.string().describe("Complete UTF-8 text file content."),
+      path: external_exports.string().describe("Relative file path inside the Project Workspace.")
+    }).strict(),
     name: "write",
     parallelSafe: false,
     execute: async ({ content, path: path16 }, {
@@ -57910,7 +57694,6 @@ function createWriteToolDefinition() {
 // ../core/src/agent/tools/project-workspace-tools.ts
 function createProjectWorkspaceToolDefinitions() {
   return [
-    createCallFrontendCapabilityToolDefinition(),
     createCopyFileToolDefinition(),
     createCreateHtmlToolDefinition(),
     createDeleteToolDefinition(),
@@ -57918,6 +57701,8 @@ function createProjectWorkspaceToolDefinitions() {
     createGlobToolDefinition(),
     createGrepToolDefinition(),
     createPatchToolDefinition(),
+    createPreviewRefreshToolDefinition(),
+    createPreviewSwitchHtmlToolDefinition(),
     createReadToolDefinition(),
     createWriteToolDefinition()
   ];
@@ -57964,6 +57749,54 @@ function isNotFoundError(error51) {
   return typeof error51 === "object" && error51 !== null && "code" in error51 && error51.code === "ENOENT";
 }
 
+// ../core/src/realtime/frontend-capabilities.ts
+var FRONTEND_CAPABILITIES = {
+  "preview.refresh": {
+    description: "Refresh the current Preview Pane without changing HTML file.",
+    payloadSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    }
+  },
+  "preview.switchHtml": {
+    description: "Switch the Preview Pane to an existing HTML file.",
+    payloadSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Relative HTML file path inside the Project Workspace to show in the Preview Pane."
+        }
+      },
+      required: ["path"],
+      additionalProperties: false
+    }
+  }
+};
+var FRONTEND_CAPABILITY_IDS = Object.keys(
+  FRONTEND_CAPABILITIES
+);
+function buildFrontendCapabilityPrompt() {
+  return [
+    "## Frontend Capabilities",
+    "Use preview tools only to notify the browser UI after Project Workspace file changes are complete. They do not create, edit, or validate files.",
+    "After successful previewable HTML changes, call exactly one preview tool before the final user-facing summary.",
+    "Do not call a preview tool when no previewable HTML file changed or the file operation failed.",
+    "Use the current user request to decide which preview tool is needed:",
+    "- Use `previewSwitchHtml` only when the Preview Pane should move to a different existing relative `.html` file inside the Project Workspace.",
+    "- Use `previewRefresh` when the Preview Pane is already showing the correct page and only needs to reload changed HTML.",
+    "Do not use workspace file tools to simulate preview switching or refreshing.",
+    "Available capabilities:",
+    ...FRONTEND_CAPABILITY_IDS.map((capability) => {
+      const schema = JSON.stringify(
+        FRONTEND_CAPABILITIES[capability].payloadSchema
+      );
+      return `- ${capability}: ${FRONTEND_CAPABILITIES[capability].description} Payload schema: ${schema}`;
+    })
+  ].join("\n");
+}
+
 // ../core/src/agent/design-page-agent.ts
 var DESIGN_PAGE_AGENT_PROMPT_VERSION = 1;
 var AiSdkDesignPageAgent = class {
@@ -58317,6 +58150,7 @@ import path5 from "node:path";
 var DEFAULT_CLEANUP_INTERVAL_MS = 3e4;
 var DEFAULT_LEASE_TTL_MS = 9e4;
 var PREVIEW_HOST = "127.0.0.1";
+var PREVIEW_CACHE_CONTROL = "no-store";
 var PreviewServerManager = class {
   cleanupIntervalMs;
   entries = /* @__PURE__ */ new Map();
@@ -58427,6 +58261,10 @@ var PreviewServerManager = class {
       "/index.html",
       async () => htmlResponse(await readIndexHtmlOrEmptyPreview(workspaceDirectory, entry))
     );
+    app2.use("*", async (context2, next) => {
+      context2.header("Cache-Control", PREVIEW_CACHE_CONTROL);
+      await next();
+    });
     app2.use("*", serveStatic({
       onFound: (filePath) => {
         recordServedStaticPath(entry, workspaceDirectory, filePath);
@@ -58469,6 +58307,7 @@ var PreviewServerManager = class {
 function htmlResponse(html) {
   return new Response(html, {
     headers: {
+      "Cache-Control": PREVIEW_CACHE_CONTROL,
       "Content-Type": "text/html; charset=utf-8"
     }
   });
@@ -58673,7 +58512,7 @@ function buildWorkspaceHref({
 }
 
 // ../core/src/conversations/conversation-service.ts
-var DEFAULT_CONVERSATION_TITLE = "\u65B0\u5EFA\u4F1A\u8BDD";
+var DEFAULT_CONVERSATION_TITLE = FALLBACK_CONVERSATION_TITLE;
 var ConversationService = class {
   workspaceStore;
   now;
@@ -58685,12 +58524,12 @@ var ConversationService = class {
     this.createId = options.createId ?? (() => crypto.randomUUID());
     this.designPageAgent = options.designPageAgent ?? new AiSdkDesignPageAgent(this.workspaceStore);
   }
-  async createConversation(projectId) {
+  async createConversation(projectId, defaultTitle) {
     const timestamp = this.now();
     const conversation = {
       id: this.createId(),
       projectId,
-      title: DEFAULT_CONVERSATION_TITLE,
+      title: normalizeDefaultConversationTitle(defaultTitle),
       createdAt: timestamp,
       updatedAt: timestamp,
       messages: []
@@ -58789,13 +58628,16 @@ var ConversationService = class {
       updatedConversation
     );
   }
-  async deleteConversation(projectId, conversationId) {
+  async deleteConversation(projectId, conversationId, defaultTitle) {
     await this.workspaceStore.deleteConversation(projectId, conversationId);
     let remainingConversations = await this.workspaceStore.listConversations(
       projectId
     );
     if (remainingConversations.length === 0) {
-      const replacementConversation = await this.createConversation(projectId);
+      const replacementConversation = await this.createConversation(
+        projectId,
+        defaultTitle
+      );
       remainingConversations = [replacementConversation];
     }
     return remainingConversations;
@@ -58846,7 +58688,7 @@ var ProjectService = class {
     const conversation = {
       id: this.createId(),
       projectId: project.id,
-      title: "\u65B0\u5EFA\u4F1A\u8BDD",
+      title: normalizeDefaultConversationTitle(input.defaultConversationTitle),
       createdAt: timestamp,
       updatedAt: timestamp,
       messages: []
@@ -61015,6 +60857,9 @@ function createOwnDesignApp(options = {}) {
       modelConfigurations
     });
     const result = await services.projectService.createProject({
+      defaultConversationTitle: getDefaultConversationTitle(
+        input.interfaceLanguage === "en-US" ? "en-US" : "zh-CN"
+      ),
       name: "helloworld"
     });
     return context2.json({
@@ -61030,7 +60875,12 @@ function createOwnDesignApp(options = {}) {
     if (!trimmedName) {
       return context2.json({}, 400);
     }
-    const result = await createProjectService(options).createProject({
+    const services = createOwnDesignServices(options);
+    const settings = await services.settingsService.getSettings();
+    const result = await services.projectService.createProject({
+      defaultConversationTitle: getDefaultConversationTitle(
+        settings.interfaceLanguage
+      ),
       name: trimmedName,
       description: asNonEmptyString(body.description)
     });
@@ -61071,7 +60921,12 @@ function createOwnDesignApp(options = {}) {
   });
   app2.post("/api/projects/:projectId/conversations", async (context2) => {
     const projectId = context2.req.param("projectId");
-    const conversation = await createConversationService(options).createConversation(projectId);
+    const services = createOwnDesignServices(options);
+    const settings = await services.settingsService.getSettings();
+    const conversation = await services.conversationService.createConversation(
+      projectId,
+      getDefaultConversationTitle(settings.interfaceLanguage)
+    );
     return context2.json({
       href: buildWorkspaceHref({
         conversationId: conversation.id,
@@ -61120,9 +60975,12 @@ function createOwnDesignApp(options = {}) {
       const projectId = context2.req.param("projectId");
       const conversationId = context2.req.param("conversationId");
       const currentConversationId = context2.req.query("currentConversationId");
-      const remainingConversations = await createConversationService(options).deleteConversation(
+      const services = createOwnDesignServices(options);
+      const settings = await services.settingsService.getSettings();
+      const remainingConversations = await services.conversationService.deleteConversation(
         projectId,
-        conversationId
+        conversationId,
+        getDefaultConversationTitle(settings.interfaceLanguage)
       );
       const nextConversationId = currentConversationId === conversationId ? remainingConversations[0]?.id : currentConversationId;
       return context2.json({
@@ -61139,7 +60997,8 @@ function createOwnDesignApp(options = {}) {
     const conversationId = asNonEmptyString(body.conversationId);
     const requestedPreviewPath = asNonEmptyString(body.previewPath);
     const pageEditMode = parsePageEditMode(body.pageEditMode);
-    if (!projectId || !conversationId || !Array.isArray(body.messages)) {
+    const currentUserMessage = createCurrentUserMessage(body.message);
+    if (!projectId || !conversationId || !currentUserMessage) {
       return context2.text("Invalid chat request.", 400);
     }
     if (!pageEditMode) {
@@ -61155,9 +61014,6 @@ function createOwnDesignApp(options = {}) {
     if (chatRunManager.getActiveRun(projectId)) {
       return context2.text("\u5F53\u524D\u9879\u76EE\u5DF2\u6709\u4EFB\u52A1\u6B63\u5728\u6267\u884C\u3002", 409);
     }
-    const incomingMessages = normalizeConversationMessages(
-      body.messages
-    );
     let conversation = await workspaceStore.getConversation(
       projectId,
       conversationId
@@ -61165,10 +61021,10 @@ function createOwnDesignApp(options = {}) {
     const storedMessages = normalizeConversationMessages(
       conversation.messages
     );
-    let messages = mergeStoredAndIncomingMessages(
-      storedMessages,
-      incomingMessages
-    );
+    let messages = [
+      ...storedMessages,
+      currentUserMessage
+    ];
     let agentContext;
     try {
       agentContext = await createDesignPageAgentContext({
@@ -61591,15 +61447,28 @@ async function readJson(request) {
     return void 0;
   }
 }
-function mergeStoredAndIncomingMessages(storedMessages, incomingMessages) {
-  if (storedMessages.length === 0) {
-    return incomingMessages;
+function createCurrentUserMessage(value) {
+  if (!isRecord2(value)) {
+    return void 0;
   }
-  const storedIds = new Set(storedMessages.map((message) => message.id));
-  return [
-    ...storedMessages,
-    ...incomingMessages.filter((message) => !storedIds.has(message.id))
+  const id = asNonEmptyString(value.id);
+  const text2 = typeof value.text === "string" ? value.text : "";
+  const files = Array.isArray(value.files) ? value.files.filter(isFileUIPart2) : [];
+  const parts = [
+    ...text2 ? [{ text: text2, type: "text" }] : [],
+    ...files
   ];
+  if (!id || parts.length === 0) {
+    return void 0;
+  }
+  return {
+    id,
+    parts,
+    role: "user"
+  };
+}
+function isFileUIPart2(value) {
+  return isRecord2(value) && value.type === "file";
 }
 async function rewriteLastUserMessageForDesignAgent({
   agentContext,