@thinkingai/ae-cli 6.1.25 → 6.1.27

package/skills/ae-things-review/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: ae-things-review
+description: "工作空间事项审查：基于 ae-cli things 的标题、描述、状态与完整时间线，诊断范围漂移、未记录有效更新、拆解和责任、完成证据；默认只读。"
+---
+
+# 事项推进审查
+
+沿用 aha-links 的证据化审查方法，使用 TE 空间权限和三态及独立归档。先读 [事项操作](../ae-things/SKILL.md) 和 [采集契约](../ae-things/references/cli.md)。不猜事项、空间或负责人 ID。
+
+涉及本轮绑定事项时，先遵循 [执行快照与实时上下文](../ae-things/references/cli.md#执行快照与实时上下文) 读取本次执行快照，再按以下流程采集最新审查或周期事实；两种来源分开表述。无绑定时仅使用用户明确指定的范围。
+
+## 读取事实
+
+```bash
+ae-cli things +detail --agent-space-id <space-id> --id <thing-id> --format json
+ae-cli things +digest --agent-space-id <space-id> --format json
+ae-cli things +digest --agent-space-id <space-id> --thing-ids <id-a>,<id-b> --format json
+```
+
+范围只支持当前空间、负责人或显式事项集合。不要迁入关注清单和飞书群范围。大范围先筛查，再每批深审最多 20 项，披露筛查数和深审数。
+
+必须核对 `fetchedCount`、`truncated`、`consistency`、`collectedAt`。缺字段视为契约不兼容。截断或不可读取时只对已覆盖事实下结论，不能把首 100 项称为全量。`changed_during_collection` 时重读受影响事项；`non_transactional` 仍不是某时刻的严格快照。未读附件、私有历史和缺失初始目标均明确披露。
+
+## 审查顺序
+
+1. 目标与验收：是否明确、合理、可验证；用最早 `created` 记录对照当前目标。无法还原时只审当前目标。
+2. 范围漂移：目标变更是否有明确记录；不把后来结论当作原目标。
+3. 有效更新：结果、变化、阻塞或明确下一步才是进展。进展记录是待核查候选；占位、重复状态、备注和仅改标题不重置提醒节奏；采集的计数只是候选，模型仍需核查正文是否有效。
+4. 责任：负责人和协作者是否可用，描述与进展中是否明确下一步。
+5. 完成证据：产物是否可访问、是否符合验收；未读文件不能声称通过验收。
+
+优先采用明确约定的节奏。open 表示未完成，不区分尚未开始与进行中；没有约定时只报告最后记录时间，不臆造停滞。paused 检查记录中的暂停原因和恢复条件。只写“未记录更新”，不推断“没有推进”。
+
+引用时刻必须注明时区；需要按 Asia/Shanghai 判断自然日时先正确转换 ISO 的 Z/偏移量，不能只删除后缀。例如 `2026-09-10T04:50:00Z` 对应上海时间 12:50。无法转换则保留 UTC 原值并披露限制。
+
+## 输出与边界
+
+给出健康／需关注／高风险／信息不足，附目标基线、证据（事项链接和日期）、影响、置信度及最多三条优先动作。空间审查先共性问题，再逐项摘要；不评价个人绩效，不制造总分。
+
+默认只诊断，不改状态或负责人。用户明确要求落实的具体修改重新读取版本后执行，不再重复索要相同授权；推断变化先给待确认建议。不要自动发消息或创建定时任务。
+
+文件证据：+detail/+digest 自动翻页收集资产关联，availability=missing 或 verification_failed 的文件不算可用交付；即使 available，也只代表引用可用，不代表已读取正文或验收通过。披露未读文件及非事务采集边界。私有会话来源只在当前用户有权时读取，报告引用共享事项事实，不能把私有历史自动公开。

package/skills/ae-workspace/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: ae-workspace
+version: 1.1.0
+description: "Manage AE AgentSpaces with ae-cli: resolve current workspace context, list or update workspace profiles, transfer files, configure Agent/MCP/Skill/knowledge-base capabilities, manage shared-space members, inspect activities, or scope automations and archived conversations. Use for the new Workspace product; legacy sandbox Workspace sync/model behavior is separate."
+---
+
+# ae-workspace
+
+Use `ae-cli workspace` for AgentSpace operations. Here, `workspace_id` and `--workspace-id` always mean `AgentSpace.id`; they never mean the legacy sandbox `Workspace.id` or a filesystem directory name.
+
+Before composing a workspace command, read [references/commands.md](references/commands.md). It contains the command matrix, mutation prerequisites, and file-transfer rules.
+
+## Targeting
+
+1. Prefer an explicit `--workspace-id` supplied by the user or returned by `workspace list`.
+2. Inside a run, the CLI may use `TE_AGENT_CURRENT_AGENT_SPACE_ID`, derive the ID from the canonical `/spaces/actived/<id>/.conversations/...` runtime directory, or ask the server to resolve `TE_AGENT_CONVERSATION_ID`.
+3. When both workspace and conversation are available, send both so the server can reject a scope mismatch.
+4. Outside a run, if the target is unknown, run `workspace list` and select from real IDs. Never fall back to an account default.
+
+Use `workspace current` to verify the resolved ID, space type, role, and capabilities before a multi-step mutation.
+
+## Safety
+
+- Read the latest record or revision before mutations that require `--version`.
+- Treat capability and membership changes as `high-risk-write`; preview them with `--dry-run` and obtain explicit confirmation before passing `--yes`.
+- Treat file and workspace deletion as `high-risk-write`.
+- Shared AgentSpace provisioning is administrator-owned. `workspace create` creates only a personal AgentSpace.
+- `ae-cli sync` and `ae-cli model` manage the legacy sandbox Workspace. In an AgentSpace runtime, use workspace capability commands instead.
+
+## Related domains
+
+- Memory: `ae-cli memory ...` uses the same strict AgentSpace target.
+- Automations: use `ae-cli automation ... --agent-space-id ...` and follow the `ae-automation` Skill.
+- Archived conversations: `ae-cli agent +find-archived-conversations|+restore-conversation --workspace-id ...`.
+
+## Transition record
+
+Transition status: transitional
+Owning module: te-claude AgentSpace
+Current transport: CLI-token REST under `/api/cli/workspace/v1`
+Gateway target: TBD
+Review after: 2026-12-01
+Exit condition: equivalent stable Gateway capabilities exist; keep only commands that still add orchestration, file handling, safety, or stable typed output.

package/skills/ae-workspace/references/commands.md

@@ -0,0 +1,51 @@
+# Workspace command reference
+
+## Context and profile
+
+| Command | Risk | Required input | Result boundary |
+|---|---:|---|---|
+| `list` | read | none | Accessible AgentSpaces and stable IDs. |
+| `get` | read | workspace or conversation target | Resolved profile and access. |
+| `current` | read | workspace or conversation target | Server-verified target, role, and capabilities. |
+| `create` | write | `--name`; optional description | Creates only a personal AgentSpace. |
+| `update` | write | target, `--name` | Updates profile only. |
+| `delete` | high-risk-write | target | Soft-deletes an AgentSpace. |
+| `recover` | write | target | Requests runtime recovery for an active but unavailable AgentSpace; it does not undo archival or deletion. |
+| `activity list` | read | target | Recent workspace activity, up to 20 items. |
+
+## Files
+
+| Command | Risk | Required input |
+|---|---:|---|
+| `asset list` | read | target; optional folder `--path` |
+| `asset read` | read | target, text file `--path` |
+| `asset upload` | write | target, local `--file`; optional destination `--path` |
+| `asset download` | read | target, remote `--path`, local `--output` |
+| `asset mkdir` | write | target, `--name`; optional parent `--path` |
+| `asset move` | write | target, `--path`, `--destination` |
+| `asset delete` | high-risk-write | target, `--path` |
+
+Uploads are capped at 50 MB. Downloads preserve raw bytes and refuse to replace an existing local file unless `--overwrite true` is explicit.
+
+## Capabilities
+
+`capability list` returns the current revision and available selections. `capability set` replaces exactly one type: `agent`, `mcp`, `skill`, or `knowledge_base`.
+
+```bash
+ae-cli workspace capability list --workspace-id <agent-space-id>
+ae-cli workspace capability set --workspace-id <agent-space-id> --version <revision> --capability-type skill --selected-ids '["<skill-id>"]'
+```
+
+`--selected-ids '[]'` clears that type. When changing Agent capabilities, pass `--default-agent-id` only when the selected default is valid in the new set. A version conflict means the settings changed; list again and reassess.
+
+## Shared-space members
+
+| Command | Risk | Required input |
+|---|---:|---|
+| `member list` | read | target; optional `--candidate-query` |
+| `member add` | high-risk-write | target, `--user-id`, `--role ADMIN|MEMBER` |
+| `member update` | high-risk-write | target, `--user-id`, `--role ADMIN|MEMBER` |
+| `member transfer-owner` | high-risk-write | target, new owner `--user-id` |
+| `member remove` | high-risk-write | target, `--user-id` |
+
+Discover users through `member list --candidate-query` and use returned IDs. Ownership transfer is a distinct command so it cannot be confused with an ordinary role update.

package/dist/chunk-E2JKXMVO.js

@@ -1,29 +0,0 @@
-import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
-
-// src/core/package-info.ts
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-function getLocalCliPackageInfo() {
-  let dir = path.dirname(fileURLToPath(import.meta.url));
-  for (let i = 0; i < 8; i += 1) {
-    const candidate = path.join(dir, "package.json");
-    try {
-      if (fs.existsSync(candidate)) {
-        const pkg = JSON.parse(fs.readFileSync(candidate, "utf8"));
-        if (pkg.name && pkg.version && String(pkg.name).includes("ae-cli")) {
-          return { name: pkg.name, version: pkg.version };
-        }
-      }
-    } catch {
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return { name: "@tant/ae-cli", version: "0.0.0" };
-}
-
-export {
-  getLocalCliPackageInfo
-};

package/dist/context-M3HDGEIR.js

@@ -1,46 +0,0 @@
-import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
-import {
-  getFromMainApp
-} from "./chunk-KJDOTPYU.js";
-import "./chunk-Y74WTIKJ.js";
-import "./chunk-DU72X2IO.js";
-import "./chunk-IG3DYEIR.js";
-import {
-  CliValidationError
-} from "./chunk-YVGXGTD6.js";
-
-// src/commands/context/current.ts
-var CURRENT_PAGE_CONTEXT_PATH = "/api/sandbox/agent/context/current";
-function createCurrentPageContextCommand(read = getFromMainApp, readConversationId = () => process.env.TE_AGENT_CONVERSATION_ID) {
-  return {
-    service: "context",
-    command: "+current",
-    description: "Read the current page context bound to the active Agent Run",
-    flags: [],
-    risk: "read",
-    usesAeHost: false,
-    execute: async () => {
-      const conversationId = readConversationId()?.trim();
-      if (!conversationId) {
-        throw new CliValidationError(
-          "Current page context is available only inside an active Agent Run.",
-          {
-            code: "CURRENT_PAGE_CONTEXT_RUN_REQUIRED",
-            hint: "Open AE Agent from a supported product page and ask about the current page."
-          }
-        );
-      }
-      const query = new URLSearchParams({ conversationId });
-      return read(`${CURRENT_PAGE_CONTEXT_PATH}?${query.toString()}`);
-    }
-  };
-}
-var currentPageContext = createCurrentPageContextCommand();
-
-// src/commands/context/index.ts
-var commands = [currentPageContext];
-var context_default = commands;
-export {
-  currentPageContext,
-  context_default as default
-};