@thinkingai/ae-cli 1.0.24 → 1.0.28

package/dist/te-team-EM5OWRQL.js

@@ -0,0 +1,529 @@
+import {
+  kbApi
+} from "./chunk-OJDNO5QY.js";
+import {
+  printError,
+  printOutput
+} from "./chunk-CLJF7MQA.js";
+import "./chunk-WCHI7725.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-CAQYQA4R.js";
+import "./chunk-SRJIAOBN.js";
+
+// src/commands/te-team/shared.ts
+var API_PREFIX = process.env.AE_API_PREFIX ?? "/agent";
+var BASE_TEAM_PATH = `${API_PREFIX}/api/external/team/teams`;
+var BASE_RUN_PATH = `${API_PREFIX}/api/external/team/teamrun`;
+var BASE_TPL_PATH = `${API_PREFIX}/api/external/team/team-templates`;
+
+// src/commands/te-team/team/list-teams.ts
+var listTeams = {
+  service: "team",
+  command: "+list",
+  description: "List all teams visible to the current user.",
+  flags: [],
+  risk: "read",
+  dryRun: (ctx) => ({ method: "GET", url: `${ctx.host().replace(/\/$/, "")}${BASE_TEAM_PATH}` }),
+  execute: async (ctx) => kbApi(ctx, "GET", BASE_TEAM_PATH)
+};
+
+// src/commands/te-team/team/create-team.ts
+var VALID_SCOPES = /* @__PURE__ */ new Set(["personal", "company"]);
+function buildBody(ctx) {
+  const body = {
+    name: ctx.str("name"),
+    config: ctx.json("config")
+  };
+  const description = ctx.str("description");
+  if (description) body.description = description;
+  const scope = ctx.str("scope");
+  if (scope) body.scope = scope;
+  const enabled = ctx.json("enabled");
+  if (enabled !== void 0) body.enabled = enabled;
+  return body;
+}
+var createTeam = {
+  service: "team",
+  command: "+create",
+  description: "Create a new AI agent team.",
+  flags: [
+    { name: "name", type: "string", required: true, desc: "Team name (1\u2013100 chars)" },
+    { name: "config", type: "json", required: true, desc: "TeamConfig JSON object" },
+    { name: "description", type: "string", required: false, desc: "Team description (\u22642000 chars)" },
+    { name: "scope", type: "string", required: false, desc: "personal (default) | company" },
+    { name: "enabled", type: "boolean", required: false, desc: "Whether enabled, default true" }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    const scope = ctx.str("scope");
+    if (scope && !VALID_SCOPES.has(scope)) {
+      throw new Error(`Invalid --scope: ${scope}. Must be personal | company`);
+    }
+  },
+  dryRun: (ctx) => ({
+    method: "POST",
+    url: `${ctx.host().replace(/\/$/, "")}${BASE_TEAM_PATH}`,
+    body: buildBody(ctx)
+  }),
+  execute: async (ctx) => kbApi(ctx, "POST", BASE_TEAM_PATH, {}, buildBody(ctx))
+};
+
+// src/commands/te-team/team/update-team.ts
+var VALID_SCOPES2 = /* @__PURE__ */ new Set(["personal", "company"]);
+function buildBody2(ctx) {
+  const body = {};
+  const name = ctx.str("name");
+  if (name) body.name = name;
+  const config = ctx.json("config");
+  if (config !== void 0) body.config = config;
+  const description = ctx.str("description");
+  if (description) body.description = description;
+  const scope = ctx.str("scope");
+  if (scope) body.scope = scope;
+  const enabled = ctx.json("enabled");
+  if (enabled !== void 0) body.enabled = enabled;
+  return body;
+}
+var updateTeam = {
+  service: "team",
+  command: "+update",
+  description: "Update an existing team (PATCH \u2014 only provided fields are changed).",
+  flags: [
+    { name: "id", type: "string", required: true, desc: "Team ID" },
+    { name: "name", type: "string", required: false, desc: "New team name" },
+    { name: "config", type: "json", required: false, desc: "New TeamConfig JSON" },
+    { name: "description", type: "string", required: false, desc: "New description" },
+    { name: "scope", type: "string", required: false, desc: "personal | company" },
+    { name: "enabled", type: "boolean", required: false, desc: "Whether enabled" }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    const scope = ctx.str("scope");
+    if (scope && !VALID_SCOPES2.has(scope)) {
+      throw new Error(`Invalid --scope: ${scope}. Must be personal | company`);
+    }
+  },
+  dryRun: (ctx) => ({
+    method: "PATCH",
+    url: `${ctx.host().replace(/\/$/, "")}${BASE_TEAM_PATH}/${ctx.str("id")}`,
+    body: buildBody2(ctx)
+  }),
+  execute: async (ctx) => kbApi(ctx, "PATCH", `${BASE_TEAM_PATH}/${ctx.str("id")}`, {}, buildBody2(ctx))
+};
+
+// src/commands/te-team/team/delete-team.ts
+var deleteTeam = {
+  service: "team",
+  command: "+delete",
+  description: "Delete a team by ID. Returns 409 if there are running tasks.",
+  flags: [
+    { name: "id", type: "string", required: true, desc: "Team ID" }
+  ],
+  risk: "write",
+  dryRun: (ctx) => ({
+    method: "DELETE",
+    url: `${ctx.host().replace(/\/$/, "")}${BASE_TEAM_PATH}/${ctx.str("id")}`
+  }),
+  execute: async (ctx) => kbApi(ctx, "DELETE", `${BASE_TEAM_PATH}/${ctx.str("id")}`)
+};
+
+// src/commands/te-team/team/ai-generate.ts
+var AI_GEN_PATH = `${BASE_TEAM_PATH}/ai-generate`;
+function buildBody3(ctx) {
+  const body = { prompt: ctx.str("prompt") };
+  const model = ctx.str("model");
+  if (model) body.model = model;
+  return body;
+}
+var aiGenerate = {
+  service: "team",
+  command: "+ai-generate",
+  description: "Use AI to generate a team config draft from a goal description.",
+  flags: [
+    { name: "prompt", type: "string", required: true, desc: "Team goal description (1\u20132000 chars)" },
+    { name: "model", type: "string", required: false, desc: "Model ID to use for generation" }
+  ],
+  risk: "read",
+  dryRun: (ctx) => ({
+    method: "POST",
+    url: `${ctx.host().replace(/\/$/, "")}${AI_GEN_PATH}`,
+    body: buildBody3(ctx)
+  }),
+  execute: async (ctx) => kbApi(ctx, "POST", AI_GEN_PATH, {}, buildBody3(ctx))
+};
+
+// src/commands/te-team/team/list-templates.ts
+var listTemplates = {
+  service: "team",
+  command: "+list-templates",
+  description: "List available team templates.",
+  flags: [
+    { name: "locale", type: "string", required: false, desc: "Locale: zh (default) | en | ja | ko" }
+  ],
+  risk: "read",
+  dryRun: (ctx) => {
+    const params = {};
+    const locale = ctx.str("locale");
+    if (locale) params.locale = locale;
+    return { method: "GET", url: `${ctx.host().replace(/\/$/, "")}${BASE_TPL_PATH}`, params };
+  },
+  execute: async (ctx) => {
+    const params = {};
+    const locale = ctx.str("locale");
+    if (locale) params.locale = locale;
+    return kbApi(ctx, "GET", BASE_TPL_PATH, params);
+  }
+};
+
+// src/commands/te-team/team/list-projects.ts
+var OAUTH_CHECK_PATH = `${API_PREFIX}/api/oauth/check`;
+var listProjects = {
+  service: "team",
+  command: "+list-projects",
+  description: "List all projects available to the current user (from /api/oauth/check).",
+  flags: [],
+  risk: "read",
+  dryRun: (ctx) => ({ method: "POST", url: `${ctx.host().replace(/\/$/, "")}${OAUTH_CHECK_PATH}` }),
+  execute: async (ctx) => {
+    const accessToken = await ctx.token();
+    const data = await kbApi(ctx, "POST", OAUTH_CHECK_PATH, {}, { accessToken });
+    return data?.projectInfoList ?? data;
+  }
+};
+
+// src/commands/te-team/team/index.ts
+var commands = [
+  listTeams,
+  createTeam,
+  updateTeam,
+  deleteTeam,
+  aiGenerate,
+  listTemplates,
+  listProjects
+];
+var team_default = commands;
+
+// src/commands/te-team/run/start-run.ts
+var START_PATH = `${BASE_RUN_PATH}/start`;
+function buildBody4(ctx) {
+  const body = {
+    teamId: ctx.str("team-id"),
+    input: ctx.str("input")
+  };
+  const conversationId = ctx.str("conversation-id");
+  if (conversationId) body.conversationId = conversationId;
+  const notification = ctx.json("notification");
+  if (notification) body.notification = notification;
+  const saveToKbId = ctx.str("save-to-kb-id");
+  if (saveToKbId) body.saveToKbId = saveToKbId;
+  const projectIds = ctx.json("project-ids");
+  if (projectIds) body.projectIds = projectIds;
+  const projectNames = ctx.json("project-names");
+  if (projectNames) body.projectNames = projectNames;
+  const spaceIds = ctx.json("space-ids");
+  if (spaceIds) body.spaceIds = spaceIds;
+  const spaceNames = ctx.json("space-names");
+  if (spaceNames) body.spaceNames = spaceNames;
+  const dwSpaceCodes = ctx.json("dw-space-codes");
+  if (dwSpaceCodes) body.dwSpaceCodes = dwSpaceCodes;
+  const dwSpaceNames = ctx.json("dw-space-names");
+  if (dwSpaceNames) body.dwSpaceNames = dwSpaceNames;
+  return body;
+}
+var startRun = {
+  service: "team",
+  command: "+run-start",
+  description: "Start a new TeamRun for the given team.",
+  flags: [
+    { name: "team-id", type: "string", required: true, desc: "Team ID" },
+    { name: "input", type: "string", required: true, desc: "Task input (1\u201350000 chars)" },
+    { name: "conversation-id", type: "string", required: false, desc: "Associated conversation ID" },
+    { name: "notification", type: "json", required: false, desc: 'Notification config JSON, e.g. {"channels":["feishu"],"feishuChatId":"..."}' },
+    { name: "save-to-kb-id", type: "string", required: false, desc: "Knowledge base ID to save result to on completion" },
+    { name: "project-ids", type: "json", required: false, desc: 'Associated project ID list, e.g. ["id1"]' },
+    { name: "project-names", type: "json", required: false, desc: "Associated project name list JSON" },
+    { name: "space-ids", type: "json", required: false, desc: "Associated space ID list JSON" },
+    { name: "space-names", type: "json", required: false, desc: "Associated space name list JSON" },
+    { name: "dw-space-codes", type: "json", required: false, desc: "Associated DW space code list JSON" },
+    { name: "dw-space-names", type: "json", required: false, desc: "Associated DW space name list JSON" }
+  ],
+  risk: "write",
+  dryRun: (ctx) => ({
+    method: "POST",
+    url: `${ctx.host().replace(/\/$/, "")}${START_PATH}`,
+    body: buildBody4(ctx)
+  }),
+  execute: async (ctx) => kbApi(ctx, "POST", START_PATH, {}, buildBody4(ctx))
+};
+
+// src/commands/te-team/run/chat-run.ts
+var CHAT_PATH = `${BASE_RUN_PATH}/chat`;
+function buildBody5(ctx) {
+  const body = {
+    teamId: ctx.str("team-id"),
+    input: ctx.str("input")
+  };
+  const sessionId = ctx.str("session-id");
+  if (sessionId) body.sessionId = sessionId;
+  return body;
+}
+var chatRun = {
+  service: "team",
+  command: "+run-chat",
+  description: "Chat with a team in multi-turn mode. Auto-resumes if a run is in waiting_user state.",
+  flags: [
+    { name: "team-id", type: "string", required: true, desc: "Team ID" },
+    { name: "input", type: "string", required: true, desc: "User input" },
+    { name: "session-id", type: "string", required: false, desc: "Existing session ID for continuing a conversation" }
+  ],
+  risk: "write",
+  dryRun: (ctx) => ({
+    method: "POST",
+    url: `${ctx.host().replace(/\/$/, "")}${CHAT_PATH}`,
+    body: buildBody5(ctx)
+  }),
+  execute: async (ctx) => kbApi(ctx, "POST", CHAT_PATH, {}, buildBody5(ctx))
+};
+
+// src/commands/te-team/run/cancel-run.ts
+var cancelRun = {
+  service: "team",
+  command: "+run-cancel",
+  description: "Cancel a TeamRun.",
+  flags: [
+    { name: "id", type: "string", required: true, desc: "TeamRun ID" }
+  ],
+  risk: "write",
+  dryRun: (ctx) => ({
+    method: "POST",
+    url: `${ctx.host().replace(/\/$/, "")}${BASE_RUN_PATH}/${ctx.str("id")}/cancel`
+  }),
+  execute: async (ctx) => kbApi(ctx, "POST", `${BASE_RUN_PATH}/${ctx.str("id")}/cancel`, {}, {})
+};
+
+// src/commands/te-team/run/reply-run.ts
+function buildBody6(ctx) {
+  return { input: ctx.str("input") };
+}
+var replyRun = {
+  service: "team",
+  command: "+run-reply",
+  description: "Reply to a TeamRun that is in waiting_user state.",
+  flags: [
+    { name: "id", type: "string", required: true, desc: "TeamRun ID (must be in waiting_user state)" },
+    { name: "input", type: "string", required: true, desc: "User reply content (1\u201350000 chars)" }
+  ],
+  risk: "write",
+  dryRun: (ctx) => ({
+    method: "POST",
+    url: `${ctx.host().replace(/\/$/, "")}${BASE_RUN_PATH}/${ctx.str("id")}/reply`,
+    body: buildBody6(ctx)
+  }),
+  execute: async (ctx) => kbApi(ctx, "POST", `${BASE_RUN_PATH}/${ctx.str("id")}/reply`, {}, buildBody6(ctx))
+};
+
+// src/commands/te-team/run/get-result.ts
+var getResult = {
+  service: "team",
+  command: "+run-result",
+  description: "Get the full result of a TeamRun (all steps and events).",
+  flags: [
+    { name: "id", type: "string", required: true, desc: "TeamRun ID" }
+  ],
+  risk: "read",
+  dryRun: (ctx) => ({
+    method: "GET",
+    url: `${ctx.host().replace(/\/$/, "")}${BASE_RUN_PATH}/${ctx.str("id")}/result`
+  }),
+  execute: async (ctx) => kbApi(ctx, "GET", `${BASE_RUN_PATH}/${ctx.str("id")}/result`)
+};
+
+// src/commands/te-team/run/list-artifacts.ts
+var listArtifacts = {
+  service: "team",
+  command: "+run-artifacts",
+  description: "List artifacts produced by a TeamRun.",
+  flags: [
+    { name: "id", type: "string", required: true, desc: "TeamRun ID" },
+    { name: "artifact-type", type: "string", required: false, desc: "Filter by artifact type" },
+    { name: "include-content", type: "boolean", required: false, desc: "Include full artifact content (default false)" }
+  ],
+  risk: "read",
+  dryRun: (ctx) => {
+    const params = {};
+    const artifactType = ctx.str("artifact-type");
+    if (artifactType) params.artifactType = artifactType;
+    const includeContent = ctx.json("include-content");
+    if (includeContent !== void 0) params.includeContent = includeContent;
+    return {
+      method: "GET",
+      url: `${ctx.host().replace(/\/$/, "")}${BASE_RUN_PATH}/${ctx.str("id")}/artifacts`,
+      params
+    };
+  },
+  execute: async (ctx) => {
+    const params = {};
+    const artifactType = ctx.str("artifact-type");
+    if (artifactType) params.artifactType = artifactType;
+    const includeContent = ctx.json("include-content");
+    if (includeContent !== void 0) params.includeContent = includeContent;
+    return kbApi(ctx, "GET", `${BASE_RUN_PATH}/${ctx.str("id")}/artifacts`, params);
+  }
+};
+
+// src/commands/te-team/run/watch-run.ts
+var STREAM_PATH = (id) => `${BASE_RUN_PATH}/stream/${id}`;
+var SUCCESS_STATUSES = /* @__PURE__ */ new Set(["completed", "partial_success"]);
+var MAX_RECONNECTS = 10;
+var RECONNECT_DELAY_MS = 2e3;
+var watchRun = {
+  service: "team",
+  command: "+run-watch",
+  description: "Stream a TeamRun via SSE. Exits 0 on success, 1 on failure, 2 on waiting_user.",
+  flags: [
+    { name: "id", type: "string", required: true, desc: "TeamRun ID" },
+    { name: "after-log", type: "number", required: false, desc: "Reconnect: replay only logs after this timestamp" },
+    { name: "quiet", type: "boolean", required: false, desc: "Suppress log/status lines on stderr" }
+  ],
+  risk: "read",
+  dryRun: (ctx) => ({
+    method: "GET",
+    url: `${ctx.host().replace(/\/$/, "")}${STREAM_PATH(ctx.str("id"))}`
+  }),
+  execute: async (ctx) => {
+    const runId = ctx.str("id");
+    const quiet = ctx.bool("quiet");
+    const token = await ctx.token();
+    const host = ctx.host().replace(/\/$/, "");
+    let lastLogTs = ctx.num("after-log") || void 0;
+    let reconnects = 0;
+    while (reconnects <= MAX_RECONNECTS) {
+      const url = new URL(`${host}${STREAM_PATH(runId)}`);
+      if (lastLogTs !== void 0) url.searchParams.set("afterLog", String(lastLogTs));
+      let resp;
+      try {
+        resp = await fetch(url.toString(), {
+          headers: {
+            Authorization: `bearer ${token}`,
+            Accept: "text/event-stream",
+            "Cache-Control": "no-cache"
+          }
+        });
+      } catch (err) {
+        if (!quiet) process.stderr.write(`[reconnect] network error: ${err.message}
+`);
+        reconnects++;
+        await delay(RECONNECT_DELAY_MS);
+        continue;
+      }
+      if (!resp.ok || !resp.body) {
+        printError("api", `Stream connection failed: ${resp.status} ${resp.statusText}`);
+        process.exit(1);
+      }
+      const reader = resp.body.getReader();
+      const decoder = new TextDecoder();
+      let buf = "";
+      let evtName = "";
+      let evtData = "";
+      const flush = () => {
+        if (!evtName || !evtData) {
+          evtName = evtData = "";
+          return;
+        }
+        let payload;
+        try {
+          payload = JSON.parse(evtData);
+        } catch {
+          process.stderr.write(`[warn] unparseable SSE data for event "${evtName}"
+`);
+          evtName = evtData = "";
+          return;
+        }
+        switch (evtName) {
+          case "log": {
+            if (payload.timestamp) lastLogTs = payload.timestamp;
+            if (!quiet) {
+              const { type, stepId, content } = payload;
+              process.stderr.write(`[${type}] ${stepId}: ${content}
+`);
+            }
+            break;
+          }
+          case "error": {
+            printError("api", payload.error || "stream error");
+            process.exit(1);
+            break;
+          }
+          case "snapshot":
+          case "update": {
+            const { status } = payload;
+            if (!quiet) process.stderr.write(`[status] ${status}
+`);
+            if (status === "waiting_user") {
+              printOutput(payload, "json");
+              process.exit(2);
+            }
+            break;
+          }
+          case "final": {
+            printOutput(payload, "json");
+            process.exit(SUCCESS_STATUSES.has(payload.status) ? 0 : 1);
+            break;
+          }
+        }
+        evtName = evtData = "";
+      };
+      let streamDone = false;
+      while (!streamDone) {
+        const { done, value } = await reader.read();
+        if (done) {
+          streamDone = true;
+          break;
+        }
+        buf += decoder.decode(value, { stream: true });
+        const lines = buf.split(/\r?\n/);
+        buf = lines.pop() ?? "";
+        for (const line of lines) {
+          if (line.startsWith("event:")) {
+            evtName = line.slice(6).trim();
+          } else if (line.startsWith("data:")) {
+            evtData = line.slice(5).trim();
+          } else if (line === "") {
+            flush();
+          }
+        }
+      }
+      reconnects++;
+      if (!quiet) process.stderr.write(`[reconnect] stream closed (${reconnects}/${MAX_RECONNECTS}), retrying...
+`);
+      await delay(RECONNECT_DELAY_MS);
+    }
+    printError("api", `Stream closed after ${MAX_RECONNECTS} reconnect attempts`);
+    process.exit(1);
+  }
+};
+function delay(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+// src/commands/te-team/run/index.ts
+var commands2 = [
+  startRun,
+  chatRun,
+  cancelRun,
+  replyRun,
+  getResult,
+  listArtifacts,
+  watchRun
+];
+var run_default = commands2;
+
+// src/commands/te-team/index.ts
+var commands3 = [
+  ...team_default,
+  ...run_default
+];
+var te_team_default = commands3;
+export {
+  te_team_default as default
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingai/ae-cli",
-  "version": "1.0.24",
+  "version": "1.0.28",
   "description": "CLI tool for ThinkingAI (AE) analytics platform",
   "type": "module",
   "bin": {
@@ -16,12 +16,20 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsup src/index.ts --format esm --outDir dist",
-    "verify:analysis-tools": "node scripts/verify-te-analysis-tools.mjs",
+    "verify:config": "node test/config-commands.test.mjs",
+    "verify:analysis-tools": "tsx scripts/verify-te-analysis-tools.mjs",
+    "verify:analysis-cluster-routing": "node scripts/verify-analysis-cluster-routing.mjs",
+    "verify:multi-cluster-mode": "node test/multi-cluster-mode.test.mjs",
     "verify:analysis-builder-dry-run": "node scripts/verify-te-analysis-builder-dry-run.mjs",
     "verify:analysis-audience-tools": "node scripts/verify-te-audience-tools.mjs",
     "verify:analysis-meta-tools": "node scripts/verify-te-meta-tools.mjs",
     "verify:analysis-common-tools": "node scripts/verify-te-common-tools.mjs",
+    "verify:team-tools": "node scripts/verify-te-team-tools.mjs",
+    "verify:agent-tools": "node scripts/verify-agent-tools.mjs",
+    "verify:self-check-overlay": "node test/self-check-overlay.test.mjs",
     "verify:update-check": "npx tsx test/update-check.test.mjs",
+    "self-check": "node self-check/scan.mjs",
+    "check:agents-docs": "node scripts/check-agents-docs-sync.mjs",
     "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
     "test": "npx tsx src/index.ts --help"

package/skills/ae-agent/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: ae-agent
+version: 1.0.0
+description: "AE Agent platform resource management CLI for adding/removing/listing/toggling custom models, MCP servers, Skills, and uploading sandbox files to the attachment library. Use when the user asks to manage Agent platform resources: add a custom model, configure an MCP server, create or toggle a Skill, or upload generated files to the attachment library for download. Must use ae-cli agent commands."
+---
+
+# ae-agent
+
+AE CLI (`ae-cli`) agent platform resource commands are invoked through:
+
+```bash
+ae-cli agent +<command> [options]
+```
+
+## Global Rules
+
+- Use this skill for Agent platform resource management: models, MCP servers, Skills, and attachments.
+- Read operations can run directly. Write operations require explicit user intent and normally keep the confirmation prompt unless `--yes` is passed.
+- Prefer `--dry-run` before destructive writes.
+- Only personal scope resources can be created or deleted; company/system resources are read-only in the CLI.
+- Toggle operations on company/system resources only affect the current user's preference, not the global state.
+- JSON flags must be valid JSON strings, usually wrapped in single quotes in shell.
+- Successful commands return JSON by default. Use `--format table` when a table is easier to scan.
+- `--host <url>` overrides the active AE host. It is available on every command and may be placed after the subcommand, e.g. `ae-cli agent +<command> --host <url>`.
+
+## Commands
+
+### Models
+
+| Command | Risk | Purpose |
+|---|---:|---|
+| `+list-models` | read | List models visible to current user (personal/company/system). |
+| `+add-model` | write | Add a custom model (personal scope). |
+| `+del-model` | write | Delete a personal model. |
+| `+toggle-model` | write | Enable or disable a model. |
+
+### MCP Servers
+
+| Command | Risk | Purpose |
+|---|---:|---|
+| `+list-mcps` | read | List MCP servers visible to current user. |
+| `+add-mcp` | write | Add an MCP server (personal scope). |
+| `+del-mcp` | write | Delete a personal MCP server. |
+| `+toggle-mcp` | write | Enable or disable an MCP server. |
+
+### Skills
+
+| Command | Risk | Purpose |
+|---|---:|---|
+| `+list-skills` | read | List Skills visible to current user. |
+| `+add-skill` | write | Create a custom Skill (personal scope). |
+| `+del-skill` | write | Delete a personal Skill (physical delete). |
+| `+toggle-skill` | write | Enable or disable a Skill. |
+
+### Attachments
+
+| Command | Risk | Purpose |
+|---|---:|---|
+| `+list-attachments` | read | List user attachments (paginated). |
+| `+add-attachment` | write | Upload sandbox file(s) to attachment library. |
+| `+del-attachment` | write | Soft-delete an attachment. |
+
+## Usage Examples
+
+### List all visible models
+
+```bash
+ae-cli agent +list-models
+ae-cli agent +list-models --scope personal --format table
+```
+
+### Add a custom model
+
+```bash
+ae-cli agent +add-model \
+  --model-id gpt-4o \
+  --name "GPT-4o" \
+  --base-url "https://api.openai.com/v1" \
+  --api-key "sk-xxx" \
+  --provider openai
+```
+
+### Add an MCP server
+
+```bash
+ae-cli agent +add-mcp \
+  --name my-mcp \
+  --url "https://mcp.example.com/mcp" \
+  --transport http \
+  --headers '{"Authorization":"Bearer token"}'
+```
+
+### Create a Skill with inline instructions
+
+```bash
+ae-cli agent +add-skill \
+  --name code-reviewer \
+  --description "Reviews code for best practices" \
+  --instructions "You are a code reviewer. Analyze the code for..."
+```
+
+### Create a Skill with instructions from stdin
+
+```bash
+echo "You are a helpful assistant that..." | \
+  ae-cli agent +add-skill --name helper --description "Helper skill" --instructions @-
+```
+
+### Upload a single file to attachment library
+
+```bash
+ae-cli agent +add-attachment --file ./output/report.png
+```
+
+### Upload multiple files
+
+```bash
+ae-cli agent +add-attachment --files '["./report.png", "./data.csv", "./chart.pdf"]'
+```
+
+### Toggle a model on/off
+
+```bash
+ae-cli agent +toggle-model --id <model-cuid> --enabled true
+ae-cli agent +toggle-model --id <model-cuid> --enabled false
+```
+
+## Notes
+
+- Only `personal` scope resources can be created or deleted via CLI.
+- MCP creation automatically validates server connectivity.
+- Attachment upload supports files up to 50MB each, with a 1GB user quota.
+- Batch attachment uploads support partial success — individual file failures don't affect others.
+- Skill `--instructions @-` reads from stdin, useful for piping long instruction text.