@easytwin/devkit 0.1.0 → 0.1.1

package/dist/index.js

@@ -2,7 +2,14 @@
 import { promises as fs } from "fs";
 import path from "path";
 var CONFIG_FILE_NAME = "easytwin.config.json";
-var DEFAULT_BASE_URL = "https://api.easytwin.example.com";
+var DEFAULT_BASE_URL = "http://saas-twin.k8s.dtstack.cn/";
+var TEST_BASE_URL = "http://saas-twin-test.k8s.dtstack.cn/";
+var DEFAULT_OSS_URL = "https://dt-easyv-test.oss-cn-hangzhou.aliyuncs.com/";
+var MOCK_APP_ID = "test";
+var MOCK_APP_SECRET = "test";
+function isMockCredentials(appId, appSecret) {
+  return appId === MOCK_APP_ID && appSecret === MOCK_APP_SECRET;
+}
 var ConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -35,8 +42,16 @@ function validateConfigShape(value) {
   if (v.baseUrl !== void 0 && (typeof v.baseUrl !== "string" || v.baseUrl.length === 0)) {
     throw new ConfigError("baseUrl \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32");
   }
+  if (v.ossUrl !== void 0 && (typeof v.ossUrl !== "string" || v.ossUrl.length === 0)) {
+    throw new ConfigError("ossUrl \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32");
+  }
+  if (v.env !== void 0 && v.env !== "prod" && v.env !== "test") {
+    throw new ConfigError("env \u5FC5\u987B\u662F prod \u6216 test");
+  }
   const config = { appId: v.appId, appSecret: v.appSecret };
+  if (v.env === "prod" || v.env === "test") config.env = v.env;
   if (typeof v.baseUrl === "string") config.baseUrl = v.baseUrl;
+  if (typeof v.ossUrl === "string") config.ossUrl = v.ossUrl;
   return config;
 }
 async function readConfigFile(cwd) {
@@ -52,11 +67,13 @@ async function readConfigFile(cwd) {
 function resolveConfig(file, env = process.env) {
   const appId = env.EASYTWIN_APP_ID ?? file.appId;
   const appSecret = env.EASYTWIN_APP_SECRET ?? file.appSecret;
-  const baseUrl = env.EASYTWIN_BASE_URL ?? file.baseUrl ?? DEFAULT_BASE_URL;
+  const easyEnv = env.EASYTWIN_ENV === "test" || env.EASYTWIN_ENV === "prod" ? env.EASYTWIN_ENV : file.env ?? "prod";
+  const baseUrl = env.EASYTWIN_BASE_URL ?? file.baseUrl ?? (easyEnv === "test" ? TEST_BASE_URL : DEFAULT_BASE_URL);
+  const ossUrl = env.EASYTWIN_OSS_URL ?? file.ossUrl ?? DEFAULT_OSS_URL;
   if (!appId) throw new ConfigError("\u7F3A\u5C11 appId:\u914D\u7F6E\u6587\u4EF6\u4E2D\u672A\u63D0\u4F9B,\u4E14\u672A\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF EASYTWIN_APP_ID");
   if (!appSecret) throw new ConfigError("\u7F3A\u5C11 appSecret:\u914D\u7F6E\u6587\u4EF6\u4E2D\u672A\u63D0\u4F9B,\u4E14\u672A\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF EASYTWIN_APP_SECRET");
   const source = env.EASYTWIN_APP_ID !== void 0 || env.EASYTWIN_APP_SECRET !== void 0 ? "env" : "file";
-  return { appId, appSecret, baseUrl, source };
+  return { appId, appSecret, baseUrl, ossUrl, mock: isMockCredentials(appId, appSecret), source };
 }
 async function loadConfig(cwd, env = process.env) {
   return resolveConfig(await readConfigFile(cwd), env);
@@ -64,7 +81,9 @@ async function loadConfig(cwd, env = process.env) {
 async function writeConfigFile(cwd, config) {
   const file = configFilePath(cwd);
   const body = { appId: config.appId, appSecret: config.appSecret };
+  if (config.env) body.env = config.env;
   if (config.baseUrl) body.baseUrl = config.baseUrl;
+  if (config.ossUrl) body.ossUrl = config.ossUrl;
   await fs.mkdir(cwd, { recursive: true });
   await fs.writeFile(file, JSON.stringify(body, null, 2) + "\n", "utf8");
   return file;
@@ -133,10 +152,13 @@ function parseResponseBody(buffer) {
 }
 var EasyTwinClient = class {
   baseUrl;
+  /** 本地测试模式:true 时 scene/upload 走本地 mock,不发网络请求(见 config.ts)。 */
+  mock;
   appId;
   appSecret;
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+    this.mock = config.mock;
     this.appId = config.appId;
     this.appSecret = config.appSecret;
   }
@@ -148,8 +170,8 @@ var EasyTwinClient = class {
     };
   }
   /** JSON 请求(原生 fetch)。 */
-  async request(path5, options = {}) {
-    const url = `${this.baseUrl}${path5}`;
+  async request(path6, options = {}) {
+    const url = `${this.baseUrl}${path6}`;
     const headers = { ...this.authHeaders(), ...options.headers };
     if (options.body !== void 0 && options.body !== null && !("Content-Type" in headers)) {
       headers["Content-Type"] = "application/json";
@@ -171,8 +193,8 @@ var EasyTwinClient = class {
    * multipart 流式上传(手写 http 请求以支持逐字节进度回调)。
    * 这是 fetch 上传的替代路径:原生 fetch 无法上报上传进度。
    */
-  async upload(path5, options) {
-    const url = new URL(`${this.baseUrl}${path5}`);
+  async upload(path6, options) {
+    const url = new URL(`${this.baseUrl}${path6}`);
     const mod = url.protocol === "https:" ? https : http;
     const headers = {
       ...this.authHeaders(),
@@ -214,6 +236,7 @@ var EasyTwinClient = class {
 // src/scene.ts
 import { promises as fs2 } from "fs";
 import path2 from "path";
+import { fileURLToPath } from "url";
 function normalizeSceneList(data) {
   const list = Array.isArray(data) ? data : data?.list;
   if (!Array.isArray(list)) throw new Error("scene list \u54CD\u5E94\u7ED3\u6784\u65E0\u6CD5\u8BC6\u522B");
@@ -226,11 +249,50 @@ function normalizeSceneDetail(data) {
   const it = data ?? {};
   return { id: String(it.id ?? ""), name: String(it.name ?? ""), payload: data };
 }
-async function listScenes(client) {
+var EXAMPLE_SCENE_FILE = "scene.example.json";
+var MOCK_SCENE_NAME = "\u672C\u5730\u793A\u4F8B\u573A\u666F";
+function resolveExampleScenePath() {
+  if (typeof import.meta.url !== "string" || import.meta.url.length === 0) {
+    throw new Error(`\u65E0\u6CD5\u5B9A\u4F4D ${EXAMPLE_SCENE_FILE}:\u63D2\u4EF6(bundle/CJS)\u573A\u666F\u5FC5\u987B\u663E\u5F0F\u4F20\u5165 exampleFile`);
+  }
+  return path2.resolve(path2.dirname(fileURLToPath(import.meta.url)), "..", EXAMPLE_SCENE_FILE);
+}
+async function loadExampleScene(exampleFile) {
+  const file = exampleFile ?? resolveExampleScenePath();
+  let raw;
+  try {
+    raw = await fs2.readFile(file, "utf8");
+  } catch {
+    throw new Error(`\u65E0\u6CD5\u8BFB\u53D6\u672C\u5730\u793A\u4F8B\u573A\u666F ${file}(\u672C\u5730\u6D4B\u8BD5\u6A21\u5F0F\u9700\u8981 devkit \u5305\u5185\u7684 ${EXAMPLE_SCENE_FILE})`);
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`\u672C\u5730\u793A\u4F8B\u573A\u666F\u4E0D\u662F\u5408\u6CD5 JSON:${file}`);
+  }
+}
+function deriveExampleSceneId(payload) {
+  const root = payload ?? {};
+  const id = root?.objs?.map((o) => o.sceneId).find((s) => typeof s === "string" && s.length > 0);
+  return id ?? "local";
+}
+async function exampleSceneSummary(exampleFile) {
+  return { id: deriveExampleSceneId(await loadExampleScene(exampleFile)), name: MOCK_SCENE_NAME };
+}
+async function listScenes(client, options = {}) {
+  if (client.mock) return [await exampleSceneSummary(options.exampleFile)];
   const data = await client.request(ENDPOINTS.scenes, { method: "GET" });
   return normalizeSceneList(data);
 }
-async function pullScene(client, id) {
+async function pullScene(client, id, options = {}) {
+  if (client.mock) {
+    const payload = await loadExampleScene(options.exampleFile);
+    const sceneId = deriveExampleSceneId(payload);
+    if (sceneId !== id) {
+      throw new Error(`\u672C\u5730\u6D4B\u8BD5\u6A21\u5F0F:\u793A\u4F8B\u573A\u666F id \u4E3A ${sceneId},\u6536\u5230 ${id}(\u672C\u5730\u4EC5\u63D0\u4F9B ${EXAMPLE_SCENE_FILE} \u8FD9\u4E00\u4E2A\u573A\u666F)`);
+    }
+    return { id: sceneId, name: MOCK_SCENE_NAME, payload };
+  }
   const data = await client.request(ENDPOINTS.scene(id), { method: "GET" });
   return normalizeSceneDetail(data);
 }
@@ -239,6 +301,56 @@ async function saveSceneJson(scene, out) {
   await fs2.writeFile(out, JSON.stringify(scene.payload ?? scene, null, 2) + "\n", "utf8");
   return out;
 }
+function parseSceneStructure(scene) {
+  let data = scene;
+  if (typeof data === "string") {
+    try {
+      data = JSON.parse(data);
+    } catch {
+      return [];
+    }
+  }
+  const root = data ?? {};
+  const objs = Array.isArray(root.objs) ? root.objs : [];
+  const hierarchy = Array.isArray(root.hierarchy) ? root.hierarchy : [];
+  const items = objs.length > 0 ? objs : hierarchy;
+  const typeById = /* @__PURE__ */ new Map();
+  for (const o of objs) {
+    if (typeof o.id === "string" && typeof o.type === "string") typeById.set(o.id, o.type);
+  }
+  const nodes = /* @__PURE__ */ new Map();
+  const order = [];
+  for (const item of items) {
+    const id = typeof item.id === "string" ? item.id : "";
+    if (id.length === 0 || nodes.has(id)) continue;
+    const name = typeof item.name === "string" && item.name.length > 0 ? item.name : id;
+    nodes.set(id, { id, name, type: typeById.get(id), children: [] });
+    order.push(id);
+  }
+  const childrenOf = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const id = typeof item.id === "string" ? item.id : "";
+    if (id.length === 0 || !nodes.has(id)) continue;
+    const parentId = typeof item.parentObjId === "string" && item.parentObjId.length > 0 ? item.parentObjId : "";
+    if (parentId.length === 0 || parentId === id || !nodes.has(parentId)) continue;
+    const kids = childrenOf.get(parentId) ?? [];
+    kids.push(id);
+    childrenOf.set(parentId, kids);
+  }
+  const isChild = /* @__PURE__ */ new Set();
+  for (const kids of childrenOf.values()) for (const k of kids) isChild.add(k);
+  const build2 = (id, seen) => {
+    const node = nodes.get(id);
+    const children = [];
+    if (!seen.has(id)) {
+      seen.add(id);
+      for (const kid of childrenOf.get(id) ?? []) children.push(build2(kid, seen));
+      seen.delete(id);
+    }
+    return { ...node, children };
+  };
+  return order.filter((id) => !isChild.has(id)).map((id) => build2(id, /* @__PURE__ */ new Set()));
+}
 
 // src/upload.ts
 import { promises as fs3 } from "fs";
@@ -292,7 +404,16 @@ Content-Type: application/octet-stream\r
 `, "utf8"));
   return Buffer.concat(parts);
 }
+async function mockUpload(dir, options) {
+  const ignore = options.ignore ?? (() => false);
+  const files = await collectFiles(dir, ignore);
+  const total = files.reduce((sum, f) => sum + f.size, 0);
+  options.onProgress?.({ phase: "collect", current: total, total });
+  options.onProgress?.({ phase: "upload", current: total, total });
+  return { fileCount: files.length, byteCount: total, mock: true };
+}
 async function uploadDirectory(client, dir, options = {}) {
+  if (client.mock) return mockUpload(dir, options);
   const ignore = options.ignore ?? (() => false);
   const files = await collectFiles(dir, ignore);
   const total = files.reduce((sum, f) => sum + f.size, 0);
@@ -315,9 +436,9 @@ async function uploadDirectory(client, dir, options = {}) {
 }
 
 // src/skills.ts
-import { promises as fs4 } from "fs";
+import { existsSync, promises as fs4 } from "fs";
 import path4 from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
 var SKILL_NAMES = [
   "easytwin-render",
   "easytwin-core",
@@ -329,8 +450,48 @@ var SKILL_NAMES = [
 var CODEX_MARKER_BEGIN = "<!-- EASYTWIN-SKILLS:BEGIN -->";
 var CODEX_MARKER_END = "<!-- EASYTWIN-SKILLS:END -->";
 var META_FILE_NAME = ".easytwin-meta.json";
+var EASYTWIN_TYPES_DIR = ".easytwin/types";
+var MINIMAL_TSCONFIG = `${JSON.stringify(
+  {
+    compilerOptions: {
+      target: "ES2022",
+      module: "ESNext",
+      moduleResolution: "bundler",
+      strict: true,
+      skipLibCheck: true,
+      noEmit: true,
+      paths: {
+        "@easytwin/runtime": [".easytwin/types"]
+      }
+    },
+    include: ["src/**/*.ts"]
+  },
+  null,
+  2
+)}
+`;
+var TSCONFIG_PATHS_HINT = `\u5DF2\u6709 tsconfig.json,\u672A\u6539\u52A8\u3002\u8BF7\u5728 compilerOptions \u4E2D\u52A0\u5165:
+  "skipLibCheck": true,
+  "paths": {
+    "@easytwin/runtime": [".easytwin/types"]
+  }`;
+var RUN_CONTEXT_DECL = `
+/** \u9884\u89C8\u9875 Run \u6309\u94AE\u6CE8\u5165\u7684\u8FD0\u884C\u4E0A\u4E0B\u6587(\u89C1 D12)\u3002 */
+export interface EasyTwinRunContext {
+    engine: RuntimeEngine;
+    runtime: typeof import("@easytwin/runtime");
+    sceneJson: SceneJson;
+}
+`;
+function buildRuntimeTypesContent(sourceDts) {
+  const trimmed = sourceDts.replace(/\s+$/, "");
+  if (trimmed.includes("export interface EasyTwinRunContext")) return `${trimmed}
+`;
+  return `${trimmed}
+${RUN_CONTEXT_DECL}`;
+}
 function normalizeTargets(target = "all") {
-  if (target === "all") return ["cursor", "claude", "codex"];
+  if (target === "all") return ["cursor", "claude", "codex", "qoder"];
   if (Array.isArray(target)) return [...new Set(target)];
   return [target];
 }
@@ -338,9 +499,20 @@ function resolveSkillsSourceDir() {
   if (typeof import.meta.url !== "string" || import.meta.url.length === 0) {
     throw new Error("\u65E0\u6CD5\u5B9A\u4F4D skills \u6E90\u76EE\u5F55:\u63D2\u4EF6(bundle/CJS)\u573A\u666F\u5FC5\u987B\u663E\u5F0F\u4F20\u5165 sourceDir");
   }
-  const here = path4.dirname(fileURLToPath(import.meta.url));
+  const here = path4.dirname(fileURLToPath2(import.meta.url));
   return path4.resolve(here, "..", "skills");
 }
+function resolveRuntimeTypesSourceFile() {
+  if (typeof import.meta.url !== "string" || import.meta.url.length === 0) {
+    throw new Error("\u65E0\u6CD5\u5B9A\u4F4D runtime \u7C7B\u578B:\u63D2\u4EF6(bundle/CJS)\u573A\u666F\u5FC5\u987B\u663E\u5F0F\u4F20\u5165 typesSourceFile");
+  }
+  const here = path4.dirname(fileURLToPath2(import.meta.url));
+  const fromDist = path4.join(here, "runtime-types", "index.d.ts");
+  const fromSrc = path4.resolve(here, "lib", "index.d.ts");
+  if (existsSync(fromDist)) return fromDist;
+  if (existsSync(fromSrc)) return fromSrc;
+  throw new Error(`\u65E0\u6CD5\u5B9A\u4F4D runtime \u7C7B\u578B\u58F0\u660E,\u5DF2\u5C1D\u8BD5:${fromDist}, ${fromSrc}`);
+}
 async function readJson(file) {
   return JSON.parse(await fs4.readFile(file, "utf8"));
 }
@@ -465,6 +637,38 @@ async function syncToCodex(sourceRoot, cwd, version) {
   }
   return { target: "codex", entries: [], codex: { name: "AGENTS.md", action } };
 }
+async function syncRuntimeTypes(cwd, typesSourceFile) {
+  const destDir = path4.join(cwd, ".easytwin", "types");
+  const destFile = path4.join(destDir, "index.d.ts");
+  const content = buildRuntimeTypesContent(await fs4.readFile(typesSourceFile, "utf8"));
+  let exists = true;
+  let current = "";
+  try {
+    current = await fs4.readFile(destFile, "utf8");
+  } catch {
+    exists = false;
+  }
+  const action = actionFor(exists, current === content);
+  if (action !== "unchanged") {
+    await fs4.mkdir(destDir, { recursive: true });
+    await fs4.writeFile(destFile, content, "utf8");
+  }
+  const tsconfigPath = path4.join(cwd, "tsconfig.json");
+  let tsconfig;
+  let pathsHint;
+  try {
+    const existing = await fs4.readFile(tsconfigPath, "utf8");
+    if (existing === MINIMAL_TSCONFIG) tsconfig = "unchanged";
+    else {
+      tsconfig = "manual-paths";
+      pathsHint = TSCONFIG_PATHS_HINT;
+    }
+  } catch {
+    await fs4.writeFile(tsconfigPath, MINIMAL_TSCONFIG, "utf8");
+    tsconfig = "created";
+  }
+  return { action, tsconfig, pathsHint };
+}
 async function syncSkills(options) {
   const targets = normalizeTargets(options.targets ?? "all");
   const sourceRoot = options.sourceDir ?? resolveSkillsSourceDir();
@@ -473,16 +677,24 @@ async function syncSkills(options) {
   for (const target of targets) {
     if (target === "cursor") summaries.push(await syncToDir("cursor", sourceRoot, path4.join(options.cwd, ".cursor", "skills"), version));
     else if (target === "claude") summaries.push(await syncToDir("claude", sourceRoot, path4.join(options.cwd, ".claude", "skills"), version));
+    else if (target === "qoder") summaries.push(await syncToDir("qoder", sourceRoot, path4.join(options.cwd, ".qoder", "skills"), version));
     else summaries.push(await syncToCodex(sourceRoot, options.cwd, version));
   }
-  return summaries;
+  const types = await syncRuntimeTypes(options.cwd, options.typesSourceFile ?? resolveRuntimeTypesSourceFile());
+  return { summaries, types };
 }
 async function detectSkillsStatus(cwd, sourceDir) {
   const sourceRoot = sourceDir ?? resolveSkillsSourceDir();
   const version = await readDevkitVersion(sourceRoot);
   const targets = [];
-  for (const target of ["cursor", "claude"]) {
-    const root = path4.join(cwd, target === "cursor" ? ".cursor/skills" : ".claude/skills");
+  const dirTargets = ["cursor", "claude", "qoder"];
+  const DIR_ROOTS = {
+    cursor: ".cursor/skills",
+    claude: ".claude/skills",
+    qoder: ".qoder/skills"
+  };
+  for (const target of dirTargets) {
+    const root = path4.join(cwd, DIR_ROOTS[target]);
     const missing = [];
     for (const name of SKILL_NAMES) {
       if (!await fs4.stat(path4.join(root, name)).then(() => true).catch(() => false)) missing.push(name);
@@ -507,43 +719,258 @@ async function detectSkillsStatus(cwd, sourceDir) {
   }
   const hasCodex = agentsContent.includes(CODEX_MARKER_BEGIN) && agentsContent.includes(CODEX_MARKER_END) && agentsContent.includes(`v${version}`);
   targets.push({ target: "codex", synced: hasCodex, reason: hasCodex ? void 0 : "AGENTS.md \u7F3A\u5C11\u540C\u6B65\u6807\u8BB0\u6BB5" });
-  return { cwd, targets };
+  let typesSynced = false;
+  try {
+    const dts = await fs4.readFile(path4.join(cwd, ".easytwin", "types", "index.d.ts"), "utf8");
+    typesSynced = dts.includes("export interface EasyTwinRunContext");
+  } catch {
+    typesSynced = false;
+  }
+  return { cwd, targets, typesSynced };
+}
+
+// src/bundle.ts
+import * as esbuild from "esbuild-wasm";
+import { promises as fs5 } from "fs";
+import path5 from "path";
+var USER_ENTRY = "src/main.ts";
+var DEFAULT_BUNDLE_OUT = "dist/main.js";
+var RUNTIME_MODULE = "@easytwin/runtime";
+var BundleError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "BundleError";
+  }
+};
+function isRelativeOrAbsolute(spec) {
+  return spec.startsWith("./") || spec.startsWith("../") || spec.startsWith("/") || path5.isAbsolute(spec);
+}
+function whitelistPlugin() {
+  return {
+    name: "easytwin-whitelist",
+    setup(build2) {
+      build2.onResolve({ filter: /.*/ }, (args) => {
+        if (args.kind === "entry-point") return void 0;
+        if (isRelativeOrAbsolute(args.path)) return void 0;
+        if (args.path === RUNTIME_MODULE) return { path: args.path, external: true };
+        return {
+          errors: [
+            {
+              text: `\u68C0\u6D4B\u5230\u5916\u90E8\u4F9D\u8D56 ${args.path},\u7528\u6237\u4EE3\u7801\u53EA\u80FD\u4F9D\u8D56 @easytwin/runtime\u3002\u4E0D\u8981 npm install,\u7C7B\u578B\u7531 easytwin skills sync \u5206\u53D1,\u8FD0\u884C\u8D70\u9884\u89C8\u9875 Run \u6216 easytwin bundle\u3002`
+            }
+          ]
+        };
+      });
+    }
+  };
+}
+function formatEsbuildMessages(messages) {
+  return messages.map((m) => {
+    const loc = m.location ? `${m.location.file}:${m.location.line}:${m.location.column}: ` : "";
+    return `${loc}${m.text}`;
+  }).join("\n");
+}
+async function bundleUserCode(options) {
+  const cwd = path5.resolve(options.cwd);
+  const entry = path5.join(cwd, USER_ENTRY);
+  try {
+    await fs5.access(entry);
+  } catch {
+    throw new BundleError(
+      `\u672A\u627E\u5230\u5165\u53E3\u6587\u4EF6 ${entry}\u3002\u8BF7\u5728\u5DE5\u4F5C\u533A\u521B\u5EFA src/main.ts,\u5E76 \`export default async function main(ctx)\`\u3002`
+    );
+  }
+  let result;
+  try {
+    result = await esbuild.build({
+      absWorkingDir: cwd,
+      entryPoints: [entry],
+      bundle: true,
+      write: false,
+      format: "esm",
+      platform: "browser",
+      target: "es2022",
+      sourcemap: "inline",
+      logLevel: "silent",
+      plugins: [whitelistPlugin()]
+    });
+  } catch (err) {
+    const errors = err.errors;
+    if (Array.isArray(errors) && errors.length > 0) {
+      throw new BundleError(formatEsbuildMessages(errors));
+    }
+    throw err instanceof Error ? new BundleError(err.message) : err;
+  }
+  if (result.errors.length > 0) {
+    throw new BundleError(formatEsbuildMessages(result.errors));
+  }
+  const file = result.outputFiles?.[0];
+  if (!file) throw new BundleError("\u6253\u5305\u672A\u4EA7\u51FA\u6587\u4EF6");
+  const code = file.text;
+  const warnings = result.warnings.map((w) => formatEsbuildMessages([w]));
+  if (options.outFile) {
+    const outFile = path5.isAbsolute(options.outFile) ? options.outFile : path5.join(cwd, options.outFile);
+    await fs5.mkdir(path5.dirname(outFile), { recursive: true });
+    await fs5.writeFile(outFile, code, "utf8");
+  }
+  return { code, warnings };
+}
+async function typesMissingHint(cwd) {
+  try {
+    await fs5.access(path5.join(cwd, ".easytwin", "types", "index.d.ts"));
+    return void 0;
+  } catch {
+    return "\u672A\u627E\u5230 .easytwin/types,\u8FD0\u884C `easytwin skills sync` \u4EE5\u5206\u53D1 @easytwin/runtime \u7C7B\u578B\u58F0\u660E\u3002";
+  }
+}
+var SOURCEMAP_RE = /sourceMappingURL=data:application\/json(?:;charset=[^;]+)?;base64,([A-Za-z0-9+/]+=*)/;
+var VLQ_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function decodeVLQValues(str) {
+  const values = [];
+  let i = 0;
+  while (i < str.length) {
+    let result = 0;
+    let shift = 0;
+    let continuation = true;
+    while (continuation) {
+      if (i >= str.length) return values;
+      const digit = VLQ_CHARS.indexOf(str[i++] ?? "");
+      if (digit < 0) return values;
+      continuation = (digit & 32) !== 0;
+      result += (digit & 31) << shift;
+      shift += 5;
+    }
+    values.push(result & 1 ? -(result >> 1) : result >> 1);
+  }
+  return values;
+}
+function decodeMappings(map) {
+  const sources = map.sources ?? [];
+  const lines = (map.mappings ?? "").split(";");
+  let sourceIndex = 0;
+  let originalLine = 0;
+  let originalColumn = 0;
+  const decoded = [];
+  for (const line of lines) {
+    let generatedColumn = 0;
+    const segs = [];
+    if (line) {
+      for (const raw of line.split(",")) {
+        if (!raw) continue;
+        const nums = decodeVLQValues(raw);
+        if (nums[0] === void 0) continue;
+        generatedColumn += nums[0];
+        if (nums.length >= 4) {
+          sourceIndex += nums[1] ?? 0;
+          originalLine += nums[2] ?? 0;
+          originalColumn += nums[3] ?? 0;
+          segs.push({
+            generatedColumn,
+            source: sources[sourceIndex] ?? USER_ENTRY,
+            originalLine,
+            originalColumn
+          });
+        }
+      }
+    }
+    decoded.push(segs);
+  }
+  return decoded;
+}
+function originalPositionFor(map, line, column) {
+  const decoded = decodeMappings(map);
+  for (let i = line - 1; i >= 0; i--) {
+    const segs = decoded[i];
+    if (!segs || segs.length === 0) continue;
+    const col = i === line - 1 ? column - 1 : Number.POSITIVE_INFINITY;
+    let best = segs[0];
+    for (const seg of segs) {
+      if (seg.generatedColumn <= col) best = seg;
+      else break;
+    }
+    if (!best) continue;
+    return { source: best.source, line: best.originalLine + 1, column: best.originalColumn };
+  }
+  return void 0;
+}
+function extractInlineSourceMap(code) {
+  const m = code.match(SOURCEMAP_RE);
+  if (!m?.[1]) return void 0;
+  try {
+    return JSON.parse(Buffer.from(m[1], "base64").toString("utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function remapErrorStack(stack, bundledCode) {
+  const map = extractInlineSourceMap(bundledCode);
+  if (!map?.mappings) return stack;
+  return stack.replace(/(blob:[^\s)]+?):(\d+):(\d+)/g, (full, _url, line, col) => {
+    const orig = originalPositionFor(map, Number(line), Number(col));
+    if (!orig) return full;
+    return `${orig.source}:${orig.line}:${orig.column}`;
+  });
 }
 export {
   APP_ID_HEADER,
   AUTH_HEADER,
   BEARER_PREFIX,
+  BundleError,
   CODEX_MARKER_BEGIN,
   CODEX_MARKER_END,
   CONFIG_FILE_NAME,
   ConfigError,
   DEFAULT_BASE_URL,
+  DEFAULT_BUNDLE_OUT,
+  DEFAULT_OSS_URL,
+  EASYTWIN_TYPES_DIR,
   ENDPOINTS,
+  EXAMPLE_SCENE_FILE,
   EasyTwinApiError,
   EasyTwinClient,
   GITIGNORE_ENTRY,
   GITIGNORE_FILE_NAME,
   META_FILE_NAME,
+  MINIMAL_TSCONFIG,
+  MOCK_APP_ID,
+  MOCK_APP_SECRET,
+  MOCK_SCENE_NAME,
+  RUNTIME_MODULE,
   SKILL_NAMES,
+  TEST_BASE_URL,
+  TSCONFIG_PATHS_HINT,
+  USER_ENTRY,
   appendGitignore,
   buildMultipartBody,
+  buildRuntimeTypesContent,
+  bundleUserCode,
   collectFiles,
   configFilePath,
+  deriveExampleSceneId,
   detectSkillsStatus,
+  exampleSceneSummary,
+  extractInlineSourceMap,
   initConfig,
+  isMockCredentials,
   listScenes,
   loadConfig,
+  loadExampleScene,
   normalizeSceneDetail,
   normalizeSceneList,
   normalizeTargets,
   parseConfig,
+  parseSceneStructure,
   pullScene,
   readConfigFile,
   readDevkitVersion,
+  remapErrorStack,
   resolveConfig,
+  resolveExampleScenePath,
+  resolveRuntimeTypesSourceFile,
   resolveSkillsSourceDir,
   saveSceneJson,
   syncSkills,
+  typesMissingHint,
   uploadDirectory,
   validateConfigShape,
   writeConfigFile