@thinkingai/ae-cli 6.1.10 → 6.1.11

package/dist/{te-agent-JHUG6DVV.js → te-agent-XNPELAKX.js}

@@ -1,3 +1,6 @@
+import {
+  assertValidSkillVersion
+} from "./chunk-4NN5IWVN.js";
 import {
   deleteFromMainApp,
   getBufferFromMainApp,
@@ -6,9 +9,9 @@ import {
   postToMainApp,
   putToMainApp,
   uploadToMainApp
-} from "./chunk-J7MZHDHQ.js";
-import "./chunk-V6FR6WTW.js";
-import "./chunk-LYVNONC4.js";
+} from "./chunk-VKD5WQKN.js";
+import "./chunk-GJJA4CQZ.js";
+import "./chunk-JHENBQ5B.js";
 
 // src/commands/te-agent/agents.ts
 var BASE_PATH = "/api/sandbox/agent/agents";
@@ -1121,7 +1124,12 @@ var listSkills = {
   command: "+list-skills",
   description: "List Skills visible to current user",
   flags: [
-    { name: "scope", type: "string", required: false, desc: "Filter by scope: personal | company | system" }
+    {
+      name: "scope",
+      type: "string",
+      required: false,
+      desc: "Filter by scope: personal | company | system"
+    }
   ],
   risk: "read",
   validate: (ctx) => {
@@ -1146,14 +1154,61 @@ var addSkill = {
   command: "+add-skill",
   description: "Create a custom Skill (personal or company scope)",
   flags: [
-    { name: "name", type: "string", required: true, desc: "Skill name (1-80 chars)" },
-    { name: "description", type: "string", required: true, desc: "Skill description" },
-    { name: "instructions", type: "string", required: true, desc: "Skill instructions (use @- to read from stdin)" },
-    { name: "display-name", type: "string", required: false, desc: "Display name (max 100)" },
-    { name: "category", type: "string", required: false, desc: `Market category key: ${MARKET_CATEGORIES.join(" | ")}` },
-    { name: "icon-emoji", type: "string", required: false, desc: "Market icon emoji (e.g. robot)" },
-    { name: "icon-color", type: "string", required: false, desc: "Market icon color (e.g. #1E76F0)" },
-    { name: "scope", type: "string", required: false, default: "personal", desc: "Target scope: personal | company" }
+    {
+      name: "name",
+      type: "string",
+      required: true,
+      desc: "Skill name (1-80 chars)"
+    },
+    {
+      name: "description",
+      type: "string",
+      required: true,
+      desc: "Skill description"
+    },
+    {
+      name: "instructions",
+      type: "string",
+      required: true,
+      desc: "Skill instructions (use @- to read from stdin)"
+    },
+    {
+      name: "display-name",
+      type: "string",
+      required: false,
+      desc: "Display name (max 100)"
+    },
+    {
+      name: "category",
+      type: "string",
+      required: false,
+      desc: `Market category key: ${MARKET_CATEGORIES.join(" | ")}`
+    },
+    {
+      name: "icon-emoji",
+      type: "string",
+      required: false,
+      desc: "Market icon emoji (e.g. robot)"
+    },
+    {
+      name: "icon-color",
+      type: "string",
+      required: false,
+      desc: "Market icon color (e.g. #1E76F0)"
+    },
+    {
+      name: "scope",
+      type: "string",
+      required: false,
+      default: "personal",
+      desc: "Target scope: personal | company"
+    },
+    {
+      name: "version",
+      type: "string",
+      required: false,
+      desc: "Initial content version (major.minor; default 1.0)"
+    }
   ],
   risk: "write",
   validate: (ctx) => {
@@ -1169,6 +1224,8 @@ var addSkill = {
     if (scope && !["personal", "company"].includes(scope)) {
       throw new Error("--scope must be personal or company");
     }
+    const version = ctx.str("version");
+    if (version) assertValidSkillVersion(version);
   },
   dryRun: (ctx) => {
     const body = {
@@ -1176,7 +1233,8 @@ var addSkill = {
       description: ctx.str("description"),
       instructions: ctx.str("instructions") === "@-" ? "(from stdin)" : ctx.str("instructions"),
       displayName: ctx.str("displayName") || void 0,
-      scope: ctx.str("scope") || "personal"
+      scope: ctx.str("scope") || "personal",
+      version: ctx.str("version") || void 0
     };
     const meta = buildMetaBody2(ctx);
     if (meta) body._meta = meta;
@@ -1189,7 +1247,8 @@ var addSkill = {
       description: ctx.str("description"),
       instructions,
       displayName: ctx.str("displayName") || void 0,
-      scope: ctx.str("scope") || "personal"
+      scope: ctx.str("scope") || "personal",
+      version: ctx.str("version") || void 0
     });
     const id = created?.item?.id;
     const meta = buildMetaBody2(ctx);
@@ -1209,7 +1268,12 @@ var delSkill = {
   command: "+del-skill",
   description: "Delete a personal Skill (physical delete)",
   flags: [
-    { name: "id", type: "string", required: true, desc: "Skill record ID (CUID)" }
+    {
+      name: "id",
+      type: "string",
+      required: true,
+      desc: "Skill record ID (CUID)"
+    }
   ],
   risk: "high-risk-write",
   dryRun: (ctx) => ({
@@ -1225,8 +1289,18 @@ var toggleSkill = {
   command: "+toggle-skill",
   description: "Enable or disable a Skill",
   flags: [
-    { name: "id", type: "string", required: true, desc: "Skill record ID (CUID)" },
-    { name: "enabled", type: "boolean", required: true, desc: "true to enable, false to disable" }
+    {
+      name: "id",
+      type: "string",
+      required: true,
+      desc: "Skill record ID (CUID)"
+    },
+    {
+      name: "enabled",
+      type: "boolean",
+      required: true,
+      desc: "true to enable, false to disable"
+    }
   ],
   risk: "write",
   dryRun: (ctx) => ({
@@ -1246,12 +1320,46 @@ var listSkillMarket = {
   command: "+list-skill-market",
   description: "List Skills from the market (only approved items; system/company/personal)",
   flags: [
-    { name: "scope", type: "string", required: false, default: "all", desc: `Market scope: ${MARKET_SCOPES.join(" | ")} (custom = personal)` },
-    { name: "category", type: "string", required: false, desc: `Category key: ${MARKET_CATEGORIES.join(" | ")}` },
-    { name: "search", type: "string", required: false, desc: "Fuzzy search on name/displayName/description" },
-    { name: "sort", type: "string", required: false, default: "newest", desc: `Sort: ${MARKET_SORTS.join(" | ")} (calls = downloads)` },
-    { name: "limit", type: "number", required: false, default: 50, desc: "Page size (1-100, default 50)" },
-    { name: "offset", type: "number", required: false, default: 0, desc: "Page offset (>=0, default 0)" }
+    {
+      name: "scope",
+      type: "string",
+      required: false,
+      default: "all",
+      desc: `Market scope: ${MARKET_SCOPES.join(" | ")} (custom = personal)`
+    },
+    {
+      name: "category",
+      type: "string",
+      required: false,
+      desc: `Category key: ${MARKET_CATEGORIES.join(" | ")}`
+    },
+    {
+      name: "search",
+      type: "string",
+      required: false,
+      desc: "Fuzzy search on name/displayName/description"
+    },
+    {
+      name: "sort",
+      type: "string",
+      required: false,
+      default: "newest",
+      desc: `Sort: ${MARKET_SORTS.join(" | ")} (calls = downloads)`
+    },
+    {
+      name: "limit",
+      type: "number",
+      required: false,
+      default: 50,
+      desc: "Page size (1-100, default 50)"
+    },
+    {
+      name: "offset",
+      type: "number",
+      required: false,
+      default: 0,
+      desc: "Page offset (>=0, default 0)"
+    }
   ],
   risk: "read",
   validate: (ctx) => {
@@ -1281,10 +1389,30 @@ var setSkillMeta = {
   command: "+set-skill-meta",
   description: "Update a Skill market meta (category / icon). Company scope requires root; system is read-only.",
   flags: [
-    { name: "id", type: "string", required: true, desc: "Skill record ID (CUID)" },
-    { name: "category", type: "string", required: false, desc: `Category key: ${MARKET_CATEGORIES.join(" | ")}` },
-    { name: "icon-emoji", type: "string", required: false, desc: "Market icon emoji (e.g. robot)" },
-    { name: "icon-color", type: "string", required: false, desc: "Market icon color (e.g. #1E76F0)" }
+    {
+      name: "id",
+      type: "string",
+      required: true,
+      desc: "Skill record ID (CUID)"
+    },
+    {
+      name: "category",
+      type: "string",
+      required: false,
+      desc: `Category key: ${MARKET_CATEGORIES.join(" | ")}`
+    },
+    {
+      name: "icon-emoji",
+      type: "string",
+      required: false,
+      desc: "Market icon emoji (e.g. robot)"
+    },
+    {
+      name: "icon-color",
+      type: "string",
+      required: false,
+      desc: "Market icon color (e.g. #1E76F0)"
+    }
   ],
   risk: "write",
   validate: (ctx) => {
@@ -1302,10 +1430,7 @@ var setSkillMeta = {
     body: buildMetaBody2(ctx)
   }),
   execute: async (ctx) => {
-    return patchToMainApp(
-      `${MARKET_BASE_PATH2}/${encodeURIComponent(ctx.str("id"))}/meta`,
-      buildMetaBody2(ctx)
-    );
+    return patchToMainApp(`${MARKET_BASE_PATH2}/${encodeURIComponent(ctx.str("id"))}/meta`, buildMetaBody2(ctx));
   }
 };
 var copySkill = {
@@ -1313,10 +1438,30 @@ var copySkill = {
   command: "+copy-skill",
   description: "Copy a system/company Skill to a personal copy (independent duplicate)",
   flags: [
-    { name: "id", type: "string", required: true, desc: "Source Skill record ID (CUID, system or company scope)" },
-    { name: "category", type: "string", required: false, desc: `Market category key for the copy: ${MARKET_CATEGORIES.join(" | ")}` },
-    { name: "icon-emoji", type: "string", required: false, desc: "Override market icon emoji (e.g. robot)" },
-    { name: "icon-color", type: "string", required: false, desc: "Override market icon color (e.g. #1E76F0)" }
+    {
+      name: "id",
+      type: "string",
+      required: true,
+      desc: "Source Skill record ID (CUID, system or company scope)"
+    },
+    {
+      name: "category",
+      type: "string",
+      required: false,
+      desc: `Market category key for the copy: ${MARKET_CATEGORIES.join(" | ")}`
+    },
+    {
+      name: "icon-emoji",
+      type: "string",
+      required: false,
+      desc: "Override market icon emoji (e.g. robot)"
+    },
+    {
+      name: "icon-color",
+      type: "string",
+      required: false,
+      desc: "Override market icon color (e.g. #1E76F0)"
+    }
   ],
   risk: "write",
   validate: (ctx) => {
@@ -1331,10 +1476,7 @@ var copySkill = {
     body: buildMetaBody2(ctx) ?? {}
   }),
   execute: async (ctx) => {
-    return postToMainApp(
-      `${MARKET_BASE_PATH2}/${encodeURIComponent(ctx.str("id"))}/copy`,
-      buildMetaBody2(ctx) ?? {}
-    );
+    return postToMainApp(`${MARKET_BASE_PATH2}/${encodeURIComponent(ctx.str("id"))}/copy`, buildMetaBody2(ctx) ?? {});
   }
 };
 
@@ -1403,7 +1545,12 @@ function makeAssetListCommand(commandName, description, dirName) {
     command: commandName,
     description,
     flags: [
-      { name: "id", type: "string", required: true, desc: "Skill record ID (CUID)" }
+      {
+        name: "id",
+        type: "string",
+        required: true,
+        desc: "Skill record ID (CUID)"
+      }
     ],
     risk: "read",
     dryRun: (ctx) => ({
@@ -1411,9 +1558,7 @@ function makeAssetListCommand(commandName, description, dirName) {
       url: `${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/${dirName}`
     }),
     execute: async (ctx) => {
-      return getFromMainApp(
-        `${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/${dirName}`
-      );
+      return getFromMainApp(`${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/${dirName}`);
     }
   };
 }
@@ -1432,9 +1577,24 @@ function makeAssetUploadCommand(commandName, description, dirName, mdOnly) {
     command: commandName,
     description,
     flags: [
-      { name: "id", type: "string", required: true, desc: "Skill record ID (CUID)" },
-      { name: "file", type: "string", required: true, desc: mdOnly ? "Local .md file path to upload" : "Local file path to upload (max 1MB)" },
-      { name: "sub-path", type: "string", required: false, desc: 'Sub-directory under the target dir (e.g. "sub/")' }
+      {
+        name: "id",
+        type: "string",
+        required: true,
+        desc: "Skill record ID (CUID)"
+      },
+      {
+        name: "file",
+        type: "string",
+        required: true,
+        desc: mdOnly ? "Local .md file path to upload" : "Local file path to upload (max 1MB)"
+      },
+      {
+        name: "sub-path",
+        type: "string",
+        required: false,
+        desc: 'Sub-directory under the target dir (e.g. "sub/")'
+      }
     ],
     risk: "write",
     validate,
@@ -1445,10 +1605,7 @@ function makeAssetUploadCommand(commandName, description, dirName, mdOnly) {
     }),
     execute: async (ctx) => {
       const fd = buildAssetFormData(ctx.str("file"), ctx.str("subPath") || void 0);
-      return uploadToMainApp(
-        `${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/${dirName}`,
-        fd
-      );
+      return uploadToMainApp(`${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/${dirName}`, fd);
     }
   };
 }
@@ -1458,9 +1615,24 @@ function makeAssetReadCommand(commandName, description, dirName) {
     command: commandName,
     description,
     flags: [
-      { name: "id", type: "string", required: true, desc: "Skill record ID (CUID)" },
-      { name: "path", type: "string", required: true, desc: 'Relative file path within the directory (e.g. "guide.md" or "sub/icon.png")' },
-      { name: "output", type: "string", required: false, desc: "Write binary content to a local file (preserves binary data)" }
+      {
+        name: "id",
+        type: "string",
+        required: true,
+        desc: "Skill record ID (CUID)"
+      },
+      {
+        name: "path",
+        type: "string",
+        required: true,
+        desc: 'Relative file path within the directory (e.g. "guide.md" or "sub/icon.png")'
+      },
+      {
+        name: "output",
+        type: "string",
+        required: false,
+        desc: "Write binary content to a local file (preserves binary data)"
+      }
     ],
     risk: "read",
     dryRun: (ctx) => ({
@@ -1489,8 +1661,18 @@ function makeAssetDelCommand(commandName, description, dirName) {
     command: commandName,
     description,
     flags: [
-      { name: "id", type: "string", required: true, desc: "Skill record ID (CUID)" },
-      { name: "path", type: "string", required: true, desc: "Relative file path within the directory to delete" }
+      {
+        name: "id",
+        type: "string",
+        required: true,
+        desc: "Skill record ID (CUID)"
+      },
+      {
+        name: "path",
+        type: "string",
+        required: true,
+        desc: "Relative file path within the directory to delete"
+      }
     ],
     risk: "high-risk-write",
     dryRun: (ctx) => ({
@@ -1500,9 +1682,7 @@ function makeAssetDelCommand(commandName, description, dirName) {
     execute: async (ctx) => {
       const filePath = ctx.str("path");
       const encodedPath = filePath.split("/").map((seg) => encodeURIComponent(seg)).join("/");
-      return deleteFromMainApp(
-        `${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/${dirName}/${encodedPath}`
-      );
+      return deleteFromMainApp(`${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/${dirName}/${encodedPath}`);
     }
   };
 }
@@ -1511,14 +1691,60 @@ var editSkill = {
   command: "+edit-skill",
   description: "Edit a personal Skill content (name / description / instructions / icon)",
   flags: [
-    { name: "id", type: "string", required: true, desc: "Skill record ID (CUID)" },
-    { name: "name", type: "string", required: false, desc: "New Skill name (1-80 chars)" },
-    { name: "description", type: "string", required: false, desc: "New Skill description" },
-    { name: "instructions", type: "string", required: false, desc: "New instructions (use @- to read from stdin)" },
-    { name: "display-name", type: "string", required: false, desc: "New display name (max 100)" },
-    { name: "category", type: "string", required: false, desc: `Market category key: ${MARKET_CATEGORIES.join(" | ")}` },
-    { name: "icon-emoji", type: "string", required: false, desc: "Market icon emoji (e.g. robot)" },
-    { name: "icon-color", type: "string", required: false, desc: "Market icon color (e.g. #1E76F0)" }
+    {
+      name: "id",
+      type: "string",
+      required: true,
+      desc: "Skill record ID (CUID)"
+    },
+    {
+      name: "name",
+      type: "string",
+      required: false,
+      desc: "New Skill name (1-80 chars)"
+    },
+    {
+      name: "description",
+      type: "string",
+      required: false,
+      desc: "New Skill description"
+    },
+    {
+      name: "instructions",
+      type: "string",
+      required: false,
+      desc: "New instructions (use @- to read from stdin)"
+    },
+    {
+      name: "display-name",
+      type: "string",
+      required: false,
+      desc: "New display name (max 100)"
+    },
+    {
+      name: "category",
+      type: "string",
+      required: false,
+      desc: `Market category key: ${MARKET_CATEGORIES.join(" | ")}`
+    },
+    {
+      name: "icon-emoji",
+      type: "string",
+      required: false,
+      desc: "Market icon emoji (e.g. robot)"
+    },
+    {
+      name: "icon-color",
+      type: "string",
+      required: false,
+      desc: "Market icon color (e.g. #1E76F0)"
+    },
+    {
+      name: "version",
+      type: "string",
+      required: false,
+      desc: "New content version (major.minor; required for content changes)"
+    }
   ],
   risk: "write",
   validate: (ctx) => {
@@ -1532,7 +1758,15 @@ var editSkill = {
     }
     const hasAny = ctx.str("name") || ctx.str("description") || ctx.str("instructions") || ctx.str("displayName") || ctx.str("category") || ctx.str("iconEmoji") || ctx.str("iconColor");
     if (!hasAny) {
-      throw new Error("Provide at least one of --name / --description / --instructions / --display-name / --category / --icon-emoji / --icon-color");
+      throw new Error(
+        "Provide at least one of --name / --description / --instructions / --display-name / --category / --icon-emoji / --icon-color"
+      );
+    }
+    const version = ctx.str("version");
+    if (version) assertValidSkillVersion(version);
+    const changesContent = Boolean(ctx.str("name")) || Boolean(ctx.str("description")) || Boolean(ctx.str("instructions"));
+    if (changesContent && !version) {
+      throw new Error("--version is required when editing Skill content");
     }
   },
   dryRun: (ctx) => {
@@ -1544,6 +1778,7 @@ var editSkill = {
     if (ctx.str("category")) body.category = ctx.str("category");
     if (ctx.str("iconEmoji")) body.iconEmoji = ctx.str("iconEmoji");
     if (ctx.str("iconColor")) body.iconColor = ctx.str("iconColor");
+    if (ctx.str("version")) body.version = ctx.str("version");
     return {
       method: "PUT",
       url: `${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}`,
@@ -1561,6 +1796,7 @@ var editSkill = {
     if (ctx.str("category")) body.category = ctx.str("category");
     if (ctx.str("iconEmoji")) body.iconEmoji = ctx.str("iconEmoji");
     if (ctx.str("iconColor")) body.iconColor = ctx.str("iconColor");
+    if (ctx.str("version")) body.version = ctx.str("version");
     return putToMainApp(`${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}`, body);
   }
 };
@@ -1569,7 +1805,12 @@ var getSkillContent = {
   command: "+get-skill-content",
   description: "Read a Skill SKILL.md text content",
   flags: [
-    { name: "id", type: "string", required: true, desc: "Skill record ID (CUID)" }
+    {
+      name: "id",
+      type: "string",
+      required: true,
+      desc: "Skill record ID (CUID)"
+    }
   ],
   risk: "read",
   dryRun: (ctx) => ({
@@ -1577,9 +1818,7 @@ var getSkillContent = {
     url: `${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/content`
   }),
   execute: async (ctx) => {
-    return getFromMainApp(
-      `${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/content`
-    );
+    return getFromMainApp(`${BASE_PATH5}/${encodeURIComponent(ctx.str("id"))}/content`);
   }
 };
 var listSkillAssets = makeAssetListCommand(
@@ -1650,17 +1889,79 @@ var uploadSkill = {
   command: "+upload-skill",
   description: "Upload a ZIP-format Skill (parses SKILL.md + extracts to target dir)",
   flags: [
-    { name: "file", type: "string", required: true, desc: "Local .zip file path" },
-    { name: "scope", type: "string", required: false, default: "personal", desc: "Target scope: personal | company" },
-    { name: "auto-rename", type: "boolean", required: false, desc: "Auto-rename on name conflict" },
-    { name: "replace-skill-id", type: "string", required: false, desc: "Replace an existing Skill (CUID) instead of creating a new one" },
-    { name: "category", type: "string", required: false, desc: `Market category key: ${MARKET_CATEGORIES.join(" | ")}` },
-    { name: "name", type: "string", required: false, desc: "Override Skill name (from ZIP SKILL.md if omitted)" },
-    { name: "display-name", type: "string", required: false, desc: "Override display name" },
-    { name: "description", type: "string", required: false, desc: "Override description" },
-    { name: "instructions", type: "string", required: false, desc: "Override instructions (use @- to read from stdin)" },
-    { name: "icon-emoji", type: "string", required: false, desc: "Market icon emoji (e.g. robot)" },
-    { name: "icon-color", type: "string", required: false, desc: "Market icon color (e.g. #1E76F0)" }
+    {
+      name: "file",
+      type: "string",
+      required: true,
+      desc: "Local .zip file path"
+    },
+    {
+      name: "scope",
+      type: "string",
+      required: false,
+      default: "personal",
+      desc: "Target scope: personal | company"
+    },
+    {
+      name: "auto-rename",
+      type: "boolean",
+      required: false,
+      desc: "Auto-rename on name conflict"
+    },
+    {
+      name: "replace-skill-id",
+      type: "string",
+      required: false,
+      desc: "Replace an existing Skill (CUID) instead of creating a new one"
+    },
+    {
+      name: "category",
+      type: "string",
+      required: false,
+      desc: `Market category key: ${MARKET_CATEGORIES.join(" | ")}`
+    },
+    {
+      name: "name",
+      type: "string",
+      required: false,
+      desc: "Override Skill name (from ZIP SKILL.md if omitted)"
+    },
+    {
+      name: "display-name",
+      type: "string",
+      required: false,
+      desc: "Override display name"
+    },
+    {
+      name: "description",
+      type: "string",
+      required: false,
+      desc: "Override description"
+    },
+    {
+      name: "instructions",
+      type: "string",
+      required: false,
+      desc: "Override instructions (use @- to read from stdin)"
+    },
+    {
+      name: "icon-emoji",
+      type: "string",
+      required: false,
+      desc: "Market icon emoji (e.g. robot)"
+    },
+    {
+      name: "icon-color",
+      type: "string",
+      required: false,
+      desc: "Market icon color (e.g. #1E76F0)"
+    },
+    {
+      name: "version",
+      type: "string",
+      required: false,
+      desc: "Content version (major.minor; required with --replace-skill-id)"
+    }
   ],
   risk: "write",
   validate: (ctx) => {
@@ -1678,6 +1979,11 @@ var uploadSkill = {
     if (category && !isValidMarketCategory(category)) {
       throw new Error(`--category must be one of: ${MARKET_CATEGORIES.join(", ")}`);
     }
+    const version = ctx.str("version");
+    if (version) assertValidSkillVersion(version);
+    if (ctx.str("replaceSkillId") && !version) {
+      throw new Error("--version is required with --replace-skill-id");
+    }
   },
   dryRun: (ctx) => {
     const body = {
@@ -1690,9 +1996,11 @@ var uploadSkill = {
     if (ctx.str("name")) body.name = ctx.str("name");
     if (ctx.str("displayName")) body.displayName = ctx.str("displayName");
     if (ctx.str("description")) body.description = ctx.str("description");
-    if (ctx.str("instructions")) body.instructions = ctx.str("instructions") === "@-" ? "(from stdin)" : ctx.str("instructions");
+    if (ctx.str("instructions"))
+      body.instructions = ctx.str("instructions") === "@-" ? "(from stdin)" : ctx.str("instructions");
     if (ctx.str("iconEmoji")) body.iconEmoji = ctx.str("iconEmoji");
     if (ctx.str("iconColor")) body.iconColor = ctx.str("iconColor");
+    if (ctx.str("version")) body.version = ctx.str("version");
     return {
       method: "POST",
       url: `${BASE_PATH5}/upload`,
@@ -1705,7 +2013,9 @@ var uploadSkill = {
     const buffer = readFileSync(resolved);
     const fileName = basename(resolved);
     const fd = new FormData();
-    const blob = new Blob([new Uint8Array(buffer)], { type: "application/zip" });
+    const blob = new Blob([new Uint8Array(buffer)], {
+      type: "application/zip"
+    });
     fd.append("file", blob, fileName);
     const scope = ctx.str("scope") || "personal";
     fd.append("scope", scope);
@@ -1721,6 +2031,7 @@ var uploadSkill = {
     }
     if (ctx.str("iconEmoji")) fd.append("iconEmoji", ctx.str("iconEmoji"));
     if (ctx.str("iconColor")) fd.append("iconColor", ctx.str("iconColor"));
+    if (ctx.str("version")) fd.append("version", ctx.str("version"));
     return uploadToMainApp(`${BASE_PATH5}/upload`, fd);
   }
 };
@@ -2689,6 +3000,188 @@ var listSandboxTools = {
   execute: async (ctx) => scanSandboxTools({ status: ctx.str("status") })
 };
 
+// src/commands/te-agent/conversations.ts
+var CONVERSATION_PATH = "/api/sandbox/agent/conversations";
+var ARCHIVE_SEARCH_PATH = `${CONVERSATION_PATH}/archived`;
+var DEFAULT_LIMIT = 20;
+var DEFAULT_TIME_ZONE = "Asia/Shanghai";
+function optional2(value) {
+  const trimmed = value.trim();
+  return trimmed ? trimmed : void 0;
+}
+function envOptional2(name) {
+  return optional2(process.env[name] ?? "");
+}
+function readAll(ctx) {
+  return ctx.str("all") === "true";
+}
+function readTimeZone(ctx) {
+  return optional2(ctx.str("timeZone")) ?? DEFAULT_TIME_ZONE;
+}
+function isValidTimeZone(timeZone) {
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone }).format();
+    return true;
+  } catch {
+    return false;
+  }
+}
+function formatTimestampInTimeZone(timestamp, timeZone) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone,
+    calendar: "gregory",
+    numberingSystem: "latn",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hourCycle: "h23"
+  }).formatToParts(new Date(timestamp));
+  const values = Object.fromEntries(
+    parts.map(({ type, value }) => [type, value])
+  );
+  return `${values.year}-${values.month}-${values.day} ${values.hour}:${values.minute}:${values.second}`;
+}
+function validateFind(ctx) {
+  const rawAll = ctx.str("all");
+  if (rawAll && rawAll !== "true" && rawAll !== "false") return;
+  const agentId = optional2(ctx.str("agentId"));
+  const all = readAll(ctx);
+  if (agentId && all) {
+    throw new Error("--agent-id and --all true cannot be used together");
+  }
+  if (!agentId && !all && !envOptional2("TE_AGENT_CURRENT_AGENT_ID")) {
+    throw new Error(
+      "Archive scope is required. Provide --agent-id or --all true, or run inside an Agent sandbox."
+    );
+  }
+  const limit = optional2(ctx.str("limit")) ? ctx.num("limit") : DEFAULT_LIMIT;
+  if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+    throw new Error("--limit must be an integer between 1 and 100");
+  }
+  if (!isValidTimeZone(readTimeZone(ctx))) {
+    throw new Error("--time-zone must be a valid IANA time zone");
+  }
+}
+function buildArchivedConversationSearchPath(ctx) {
+  const params = new URLSearchParams();
+  const q = optional2(ctx.str("q"));
+  const explicitAgentId = optional2(ctx.str("agentId"));
+  const all = readAll(ctx);
+  const agentId = explicitAgentId ?? envOptional2("TE_AGENT_CURRENT_AGENT_ID");
+  const limit = optional2(ctx.str("limit")) ? ctx.num("limit") : DEFAULT_LIMIT;
+  if (q) params.set("q", q);
+  if (all) params.set("all", "true");
+  else if (agentId) params.set("agentId", agentId);
+  params.set("limit", String(limit));
+  return `${ARCHIVE_SEARCH_PATH}?${params.toString()}`;
+}
+function toArchivedConversationOutput(item, timeZone) {
+  return {
+    conversation_id: item.id,
+    title: item.title,
+    last_preview: item.lastPreview,
+    archived_at: item.archivedAt,
+    archived_at_local: formatTimestampInTimeZone(item.archivedAt, timeZone),
+    updated_at: item.updatedAt,
+    updated_at_local: formatTimestampInTimeZone(item.updatedAt, timeZone),
+    time_zone: timeZone,
+    agent: item.agent ? {
+      agent_id: item.agent.id,
+      name: item.agent.name,
+      avatar_url: item.agent.avatarUrl,
+      scope: item.agent.scope
+    } : null
+  };
+}
+var findArchivedConversations = {
+  service: "agent",
+  command: "+find-archived-conversations",
+  description: "Find archived conversations for one Agent or all Agents",
+  flags: [
+    {
+      name: "q",
+      type: "string",
+      required: false,
+      desc: "Optional keyword matched against conversation titles and message previews"
+    },
+    {
+      name: "agent-id",
+      type: "string",
+      required: false,
+      desc: "Agent ID; defaults to TE_AGENT_CURRENT_AGENT_ID inside an Agent sandbox"
+    },
+    {
+      name: "all",
+      type: "boolean",
+      required: false,
+      desc: "Set true to search archived conversations across all Agents"
+    },
+    {
+      name: "limit",
+      type: "number",
+      required: false,
+      default: DEFAULT_LIMIT,
+      min: 1,
+      max: 100,
+      desc: "Maximum number of archived conversations to return, 1-100; default 20"
+    },
+    {
+      name: "time-zone",
+      type: "string",
+      required: false,
+      default: DEFAULT_TIME_ZONE,
+      desc: "IANA time zone used for local timestamp fields; default Asia/Shanghai"
+    }
+  ],
+  risk: "read",
+  validate: validateFind,
+  dryRun: (ctx) => ({
+    method: "GET",
+    url: buildArchivedConversationSearchPath(ctx)
+  }),
+  execute: async (ctx) => {
+    const timeZone = readTimeZone(ctx);
+    const result = await getFromMainApp(
+      buildArchivedConversationSearchPath(ctx)
+    );
+    return {
+      items: result.items.map(
+        (item) => toArchivedConversationOutput(item, timeZone)
+      ),
+      has_more: result.hasMore
+    };
+  }
+};
+var restoreConversation = {
+  service: "agent",
+  command: "+restore-conversation",
+  description: "Restore an archived conversation by conversation ID",
+  flags: [
+    {
+      name: "conversation-id",
+      type: "string",
+      required: true,
+      desc: "Conversation ID returned by +find-archived-conversations"
+    }
+  ],
+  risk: "write",
+  dryRun: (ctx) => ({
+    method: "POST",
+    url: `${CONVERSATION_PATH}/${encodeURIComponent(ctx.str("conversationId"))}/restore`,
+    body: {}
+  }),
+  execute: async (ctx) => {
+    const result = await postToMainApp(
+      `${CONVERSATION_PATH}/${encodeURIComponent(ctx.str("conversationId"))}/restore`,
+      {}
+    );
+    return { changed: result.changed, conversation_id: result.conversationId };
+  }
+};
+
 // src/commands/te-agent/index.ts
 var commands = [
   // Agent CRUD
@@ -2766,6 +3259,9 @@ var commands = [
   listAutomations,
   createAutomation,
   updateAutomation,
+  // Archived conversations
+  findArchivedConversations,
+  restoreConversation,
   // Sandbox tools (local scan of /home/ta/.local/bin managed shims)
   listSandboxTools
 ];