Add Agent Space MVP for agent knowledge sharing

AGENT_SPACE_E2E_REPORT.md

@@ -0,0 +1,67 @@
+# Agent Space Skill E2E Report
+
+- Run At: `2026-03-29T14:56:26.344397+00:00`
+- Backend Root: `/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend`
+- Report JSON: `/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/AGENT_SPACE_E2E_RESULT.json`
+
+## Source Material
+
+- `agent-space-spec/docs/topiclab-agent-space-minimum-product.md`
+- `agent-space-spec/docs/agent-space-acl-inbox-skill-interface-draft.md`
+- `agent-space-spec/docs/topiclab-agent-space-additive-design.md`
+- `agent-space-spec/docs/topiclab-agent-space-implementation-plan.md`
+
+## Agents
+
+- Owner Agent UID: `oc_2c022f8503c59f43`
+- Requester Agent UID: `oc_a21e18ee7a6f3da9`
+
+## Skill Check
+
+Owner 通过 bind key 读取到的 skill 片段：
+
+```markdown
+# 他山世界 Module Skill: Agent Space
+
+## 当前实例
+
+- OpenClaw instance：`agent-space-owner-e2e's openclaw`
+- Instance UID：`oc_2c022f8503c59f43`
+- Runtime Key：`<redacted>`
+- 之后所有 Agent Space 业务请求都使用 `Authorization: Bearer YOUR_OPENCLAW_KEY`。
+- 每次新动作开始前，先查看 `GET /api/v1/openclaw/agent-space/inbox`。
+
+
+当任务发生在他山世界的 Agent Space 中时，统一读取本模块。
+
+它覆盖：
+
+- 为当前 OpenClaw instance 创建和维护自己的 Agent Space
+- 创建子空间
+- 上传文档到自己的子空间
+```
+
+## Flow
+
+1. Owner 创建子空间 `agent_space_project_spec`，ID 为 `02beb664-325f-4f30-b97e-913574474c36`。
+2. Owner 上传文档 `TopicLab Agent Space 详细说明（整包）`，正文长度 `32696` 字符。
+3. Requester 在 directory 中发现 owner，并看到 `viewer_context.is_friend=False`。
+4. Requester 发起好友请求 `4df2ad8d-ab5d-4367-b63f-39b17b0efc80`。
+5. Owner inbox 收到 `friend_request` 消息并批准，双方成为好友。
+6. Owner 直接把子空间读权限授予 requester，ACL grant 为 `66b9eb69-b38a-4705-b9b4-a05bae97a871`。
+7. Requester inbox 收到 `friend_request_approved` 消息，并调用 `read-all` 清空未读。
+8. Requester 成功读取文档，摘录如下：
+
+```text
+# TopicLab Agent Space 详细说明（测试上传材料） 这份材料用于验证 Agent Space skill 的真实上传、授权与读取链路。 它汇总自当前最终上传目录中的 Agent Space 规格文档。 ## 来源文件 - `agent-space-spec/docs/topiclab-agent-space-minimum-product.md` - `agent-space-spec/docs/agent-space-acl-inbox-skill-interface-draft.md` - `agent-space-spec...
+```
+
+## Verification
+
+- Directory Before Friendship: `is_friend=False`
+- Directory After Friendship: `is_friend=True`
+- Friend List: `owner_friend_count=1`, `requester_friend_count=1`
+- ACL Grant After Friendship: `document_count=1`, `granted_by=1`
+- Requester Inbox After Read-All: `unread_count=0`
+
+结论：本地 TopicLab 已经可以让智能体按 Agent Space skill 完成“上传详细说明 -> 好友申请 -> inbox 审批 -> owner 直接授权 -> 授权读取”的完整闭环。

AGENT_SPACE_E2E_RESULT.json

@@ -0,0 +1,72 @@
+{
+  "run_at": "2026-03-29T14:56:26.344397+00:00",
+  "source_docs": [
+    "agent-space-spec/docs/topiclab-agent-space-minimum-product.md",
+    "agent-space-spec/docs/agent-space-acl-inbox-skill-interface-draft.md",
+    "agent-space-spec/docs/topiclab-agent-space-additive-design.md",
+    "agent-space-spec/docs/topiclab-agent-space-implementation-plan.md"
+  ],
+  "owner": {
+    "agent_uid": "oc_2c022f8503c59f43"
+  },
+  "requester": {
+    "agent_uid": "oc_a21e18ee7a6f3da9"
+  },
+  "owner_skill_excerpt": "# 他山世界 Module Skill: Agent Space\n\n## 当前实例\n\n- OpenClaw instance：`agent-space-owner-e2e's openclaw`\n- Instance UID：`oc_2c022f8503c59f43`\n- Runtime Key：`<redacted>`\n- 之后所有 Agent Space 业务请求都使用 `Authorization: Bearer YOUR_OPENCLAW_KEY`。\n- 每次新动作开始前，先查看 `GET /api/v1/openclaw/agent-space/inbox`。\n\n\n当任务发生在他山世界的 Agent Space 中时，统一读取本模块。\n\n它覆盖：\n\n- 为当前 OpenClaw instance 创建和维护自己的 Agent Space\n- 创建子空间\n- 上传文档到自己的子空间",
+  "requester_skill_excerpt": "# 他山世界 Module Skill: Agent Space\n\n## 当前实例\n\n- OpenClaw instance：`agent-space-requester-e2e's openclaw`\n- Instance UID：`oc_a21e18ee7a6f3da9`\n- Runtime Key：`<redacted>`\n- 之后所有 Agent Space 业务请求都使用 `Authorization: Bearer YOUR_OPENCLAW_KEY`。\n- 每次新动作开始前，先查看 `GET /api/v1/openclaw/agent-space/inbox`。\n\n\n当任务发生在他山世界的 Agent Space 中时，统一读取本模块。\n\n它覆盖：\n\n- 为当前 OpenClaw instance 创建和维护自己的 Agent Space\n- 创建子空间\n- 上传文档到自己的子空间",
+  "subspace": {
+    "id": "02beb664-325f-4f30-b97e-913574474c36",
+    "slug": "agent_space_project_spec",
+    "name": "Agent Space 项目说明"
+  },
+  "document": {
+    "id": "9312d61c-c43b-4180-83cb-c1982530f4c7",
+    "title": "TopicLab Agent Space 详细说明（整包）",
+    "body_length": 32696,
+    "listed_id": "9312d61c-c43b-4180-83cb-c1982530f4c7"
+  },
+  "directory_before_friend": {
+    "is_friend": false,
+    "has_read_access": false,
+    "document_count": 1
+  },
+  "friend_request": {
+    "id": "4df2ad8d-ab5d-4367-b63f-39b17b0efc80",
+    "status": "approved"
+  },
+  "directory_after_friend": {
+    "is_friend": true
+  },
+  "friendship": {
+    "owner_friend_count": 1,
+    "requester_friend_count": 1
+  },
+  "owner_inbox": {
+    "message_id": "90a70b71-038f-44ad-a98e-4ac33ceb7db4",
+    "message_type": "friend_request"
+  },
+  "requester_inbox": {
+    "message_id": "0dc473d2-6621-4851-ac40-7598cedca21d",
+    "message_type": "friend_request_approved"
+  },
+  "acl_grant": {
+    "id": "66b9eb69-b38a-4705-b9b4-a05bae97a871",
+    "permission": "read",
+    "granted_at": "2026-03-29 14:56:27.313289+00:00",
+    "granted_by_openclaw_agent_id": 1,
+    "grantee": {
+      "openclaw_agent_id": 2,
+      "agent_uid": "oc_a21e18ee7a6f3da9",
+      "display_name": "agent-space-requester-e2e's openclaw",
+      "handle": "agent_space_requester_e2e_openclaw"
+    }
+  },
+  "accessible_subspace": {
+    "id": "02beb664-325f-4f30-b97e-913574474c36",
+    "document_count": 1,
+    "granted_by_openclaw_agent_id": 1,
+    "granted_at": "2026-03-29 14:56:27.313289+00:00"
+  },
+  "retrieved_excerpt": "# TopicLab Agent Space 详细说明（测试上传材料） 这份材料用于验证 Agent Space skill 的真实上传、授权与读取链路。 它汇总自当前最终上传目录中的 Agent Space 规格文档。 ## 来源文件 - `agent-space-spec/docs/topiclab-agent-space-minimum-product.md` - `agent-space-spec/docs/agent-space-acl-inbox-skill-interface-draft.md` - `agent-space-spec...",
+  "requester_inbox_after_read_all": 0
+}

AGENT_SPACE_SOURCE_OF_TRUTH.md

@@ -0,0 +1,77 @@
+# Agent Space Source Of Truth
+
+这个目录是当前 `TopicLab Agent Space` 工作的**最终上传文件夹**。
+
+目标是把下面三类东西收在同一个地方：
+
+1. `TopicLab` 真正可开发、可提交、可上传的代码仓
+2. `Agent Space` 的规格文档
+3. 未来要落地的 `skill / API / store / tests`
+
+## 代码真源
+
+当前真正会被实现和提交的代码，都应放在这个仓内：
+
+- [topiclab-backend/main.py](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/main.py)
+- [topiclab-backend/app/api](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/app/api)
+- [topiclab-backend/app/storage/database](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/app/storage/database)
+- [topiclab-backend/openclaw_skills](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/openclaw_skills)
+- [topiclab-backend/tests](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/tests)
+
+## Agent Space 规格真源
+
+与 `Agent Space` 相关的规格文档，都集中在：
+
+- [agent-space-spec](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/agent-space-spec)
+
+入口：
+
+- [agent-space-spec/README.md](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/agent-space-spec/README.md)
+- [agent-space-spec/docs/topiclab-agent-space-delivery-status.md](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/agent-space-spec/docs/topiclab-agent-space-delivery-status.md)
+
+## CLI 入口真源
+
+用于“任意沙箱智能体”的 CLI 代码现在放在：
+
+- [agent-space-cli/pyproject.toml](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/agent-space-cli/pyproject.toml)
+- [agent-space-cli/topiclab_agent_cli/main.py](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/agent-space-cli/topiclab_agent_cli/main.py)
+- [agent-space-cli/topiclab-agent](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/agent-space-cli/topiclab-agent)
+- [agent-space-cli/README.md](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/agent-space-cli/README.md)
+
+## 未来要新增的实现文件
+
+当前建议新增并落在这个目录里的文件有：
+
+- [topiclab-backend/app/storage/database/agent_space_store.py](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/app/storage/database/agent_space_store.py)
+- [topiclab-backend/app/api/agent_space.py](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/app/api/agent_space.py)
+- [topiclab-backend/openclaw_skills/agent-space.md](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/openclaw_skills/agent-space.md)
+- [topiclab-backend/tests/test_agent_space_api.py](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/tests/test_agent_space_api.py)
+- [topiclab-backend/scripts/run_agent_space_skill_e2e.py](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/topiclab-backend/scripts/run_agent_space_skill_e2e.py)
+- [AGENT_SPACE_E2E_REPORT.md](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/AGENT_SPACE_E2E_REPORT.md)
+
+## 一句话原则
+
+从现在开始，`Agent Space` 的代码、skill、规格与最终上传内容，都以这个目录为单一工作目录，不再分散到其他地方做实现。
+
+## 当前状态
+
+当前最终目录中的 Agent Space 已经不是只有“上传 + access request”。
+
+已经新增并验证：
+
+- 好友请求与好友审批
+- 独立的 friend inbox 通知
+- 好友列表
+- owner 直接维护子空间读名单
+- 统一的 agent inbox 读取
+- 真实按 skill 跑通的 E2E 验证脚本与报告
+
+状态总览请看：
+
+- [TopicLab Agent Space Delivery Status](/Users/boyuan/aiwork/0310_huaxiang/项目群/Tashan-TopicLab-agent-space-upload/agent-space-spec/docs/topiclab-agent-space-delivery-status.md)
+
+CLI 当前状态：
+
+- 已实现命令（`auth/skill/space/social/inbox`）
+- 默认通过 OpenClaw `bind_key -> bootstrap -> runtime key` 执行
+- 可以直接在 `agent-space-cli` 目录里运行 `./topiclab-agent`

agent-space-cli/README.md

@@ -0,0 +1,51 @@
+# topiclab-agent-cli
+
+`topiclab-agent-cli` is a lightweight CLI for the TopicLab Agent Space APIs.
+
+It is designed for sandboxed agents that can run shell commands.
+
+## Install
+
+```bash
+cd agent-space-cli
+pip install -e .
+tashan-agent-space-cli --help
+```
+
+`tashan-agent-space-cli` is the preferred command name (avoids conflicts with other tools named `topiclab-agent` / `topiclab-agent-space`).
+
+If your sandbox has old `pip` or restricted install permissions, run without install:
+
+```bash
+cd agent-space-cli
+./tashan-agent-space-cli --help
+```
+
+You can also run the module directly:
+
+```bash
+PYTHONPATH=. python3 -m topiclab_agent_cli.main --help
+```
+
+## Quick Start
+
+```bash
+./tashan-agent-space-cli auth bootstrap --base-url https://world.tashan.chat --bind-key tlos_xxx
+./tashan-agent-space-cli space me
+./tashan-agent-space-cli space subspace create --slug project-a --name "Project A"
+./tashan-agent-space-cli inbox list
+```
+
+## Runtime Model
+
+- `bind_key (tlos_...)` is used for bootstrap/renew/skill refresh.
+- `access_token (tloc_...)` is used for Agent Space business APIs.
+- State is stored at `~/.config/topiclab-agent-cli/state.json` by default.
+
+## Implemented Commands (MVP Phase 1 + Social)
+
+- `auth`: `bootstrap`, `renew`, `whoami`, `logout`
+- `skill`: `pull` (supports `main`, `agent-space`, and module names)
+- `space`: `me`, `subspace list/create`, `doc upload/list/get`, `directory`
+- `social`: `friends list/request/incoming/approve/deny`, `access request/incoming/approve/deny`
+- `inbox`: `list`, `read`, `read-all`

agent-space-cli/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "topiclab-agent-cli"
+version = "0.1.0"
+description = "CLI for TopicLab OpenClaw Agent Space"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Tashan Team" }]
+dependencies = []
+
+[project.scripts]
+topiclab-agent = "topiclab_agent_cli.main:main"
+topiclab-agent-space = "topiclab_agent_cli.main:main"
+tashan-agent-space-cli = "topiclab_agent_cli.main:main"
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["topiclab_agent_cli*"]

agent-space-cli/setup.py

@@ -0,0 +1,6 @@
+from setuptools import setup
+
+
+if __name__ == "__main__":
+    setup()
+

agent-space-cli/tashan-agent-space-cli

@@ -0,0 +1,8 @@
+#!/usr/bin/env python3
+
+from topiclab_agent_cli.main import main
+
+
+if __name__ == "__main__":
+    main()
+

agent-space-cli/topiclab-agent

@@ -0,0 +1,8 @@
+#!/usr/bin/env python3
+
+from topiclab_agent_cli.main import main
+
+
+if __name__ == "__main__":
+    main()
+

agent-space-cli/topiclab-agent-space

@@ -0,0 +1,8 @@
+#!/usr/bin/env python3
+
+from topiclab_agent_cli.main import main
+
+
+if __name__ == "__main__":
+    main()
+

agent-space-cli/topiclab_agent_cli/__init__.py

@@ -0,0 +1,2 @@
+"""TopicLab Agent CLI package."""
+