Soot DocsSoot được thiết kế thế nàoMarkdown ↗

04 / Agent và pack

Agent, nhóm, pack và Soot Forge

Một Soot nằm trong file thế nào; pack và cấp quyền; nhóm, Lead, Đầu mối; Soot Forge, source và bundle.

Trang này nói về những thứ người ta tạo ra và phân phối trên Soot: một Soot là gì khi nằm trong file, pack đưa skills và tools vào Soot ra sao, nhiều Soot làm chung thành nhóm thế nào, và Soot Forge giữ pack, mẫu nhóm cùng bản phát hành ở đâu. Vấn đề cần giải: một agent phải đọc được, review được, chép sang máy khác được, mà quyền của nó vẫn do chủ máy quyết.

Mô hình

Văn bản mẫu · không phải lệnh
Soot Forge (catalog + release, SHA-256)          repo của bạn (source)
   │ pack, mẫu nhóm, General                          │ Soot, pack riêng, nhóm, lịch
   ▼                                                  ▼
 packs_dir/<id>/ ─ chọn ─►  soots/<id>/soot.json  ◄─ deploy theo source
   (cài, chưa cấp gì)         (soul, mission, packs)
        │ needs                     │ nhóm: entries + members
        ▼                           ▼
   grants.packs ◄── host cấp   groups.<id> ── Đầu mối nhận việc đầu tiên
   (deployment.json)                │
                                    ▼
                    spawn_subagent (AgentCore) ─► đồng đội trong cùng runtime

Lead: trợ lý riêng của người dùng, một cái mỗi server, không thuộc nhóm nào.

Ba nguyên tắc: cấu hình là file (Soot, pack, nhóm là thư mục JSON và Markdown, để trong Git được); ghép phẳng lúc nạp (Soot liệt kê pack, loader gộp thành một danh sách, không kế thừa); cài không phải cấp (có file trong packs_dir không làm Soot nào làm được thêm gì, Soot phải chọn và host phải cấp).

Khái niệm

Khái niệmLà gì
SootMột agent nhỏ có việc rõ: soul (danh tính), mission (nhiệm vụ), pack nó chọn, model tier. Thư mục soots/<id>/.
PackGói skills và tools dùng lại được, kèm needs (cần gì từ máy). Thư mục packs/<id>/ có pack.json.
ToolThao tác thực thi được (executable) hoặc native tool của host. Operation ID là <pack>_<tool>.
GeneralSoot mặc định của mọi workspace và Nest, tạo từ preset do Soot Forge phát hành.
Nhóm (group, team)Danh sách Soot làm chung kèm giới hạn phối hợp. Là ranh giới thực thi, không phải danh tính agent khác.
Đầu mốiSoot đầu tiên trong entries của nhóm; nhận việc đầu tiên, không có quyền quản trị.
LeadTrợ lý riêng của người dùng trong Nest. Một cái mỗi server, tên cố định, không thuộc nhóm nào.
Mẫu nhómCông thức dựng một nhóm. Trong Nest gọi là Mẫu Soot.
Soot ForgeRepo 2found/soot-forge: catalog pack, catalog mẫu nhóm, preset General, bản phát hành có SHA-256.
SourceLát cấu hình (Soot, pack riêng, nhóm, lịch) do một repo sở hữu, deploy lên runtime dùng chung.

Ba loại cấu hình, ba người sở hữu

Câu hỏi nào thì sửa chỗ đó:

Câu hỏiNơiChủ
Tôi là ai, làm gì, dùng pack nào?Thư mục Soot (soots/<id>/: soot.json, SOUL.md, MISSION.md)Tác giả agent
Tôi cung cấp skills, tools gì, cần gì từ máy?Pack (packs/<id>/pack.json)Tác giả pack
Chạy ở đâu, kết nối bằng gì, ai được cấp gì, nhận việc khi nào?Deployment (deployment.json, AI settings, vault)Host (operator)

Soot không chứa secret, listener, route, lịch hay quyền với tài khoản ngoài. Pack không chứa danh tính, soul, mission, route hay giá trị credential. Nhờ vậy cùng một pack dùng cho nhiều Soot, cùng một Soot chạy được trên máy khác, và quyền luôn nằm ở một chỗ để người ta xem.

Một Soot là code

Một Soot là một thư mục, tên thư mục là ID:

Văn bản mẫu · không phải lệnh
soots/support/
  soot.json             cài đặt: tên, model, pack, chat, giới hạn chạy
  SOUL.md               danh tính và cách cư xử ({{name}} là tên hiển thị)
  MISSION.md            việc phải làm
  skills/**/SKILL.md    skill của riêng Soot, theo chuẩn Agent Skills (cả skill Soot tự lưu bằng save_skill)
  packs/<pack>/         pack riêng chỉ Soot này thấy (chỉ skills)
  evals/                case kiểm tra hành vi của riêng Soot này
  adapter/              phần đã học (soot improve, soot train), phủ lên định nghĩa

Mỗi file có thì dùng, không có thì thôi; không field nào trỏ tới chúng. soot.json chỉ còn phần chọn:

Mẫu JSON · không phải lệnh
{
  "name": "Hỗ trợ",
  "description": "Trả lời khách từ kho tài liệu",
  "avatar": "fox",
  "model": "pro",
  "packs": ["office:read", "crm:tools=find,update", "knowledge", "feedback:to=pm"],
  "chat": {"handoff": "members"},
  "execution": {"max_turns": 16}
}

FieldNghĩa
avatartên mascot, URL https, hoặc data URL PNG/JPEG/WebP
modeltier (flash, lite, pro, max), provider do host quyết; hoặc object {tier, compact_at, effort, …} để đè riêng cho Soot này. Không ghi effort thì DeepSeek suy nghĩ ở high, Claude 4+ ở medium; "none" tắt suy nghĩ
packsmọi thứ Soot làm được, kể cả hai pack có sẵn: knowledge (mọi pool tri thức của host, hoặc knowledge:pools=docs,faq) và feedback:to=<soot> (tool record_feedback, ghi chú chuyển cho Soot đó)
chatcó thì Soot nhận hội thoại: publish (final mặc định, hoặc reply), mode, handoff, release_after_hours, memory_write, channels
execution, improve, archivedgiới hạn chạy, lịch tự cải thiện, lưu trữ

Không có field cho ID, soul, mission, skill, adapter, tool hay project: ID là tên thư mục, prose là file, tool đến từ pack, project đến từ nhóm. evals/ đi cùng Soot nên review code là review luôn cách kiểm tra; soot improve và soot train đọc đúng kho đó và ghi cái học được vào adapter/ (evolution.md). Field đầy đủ có ở soot schema soot.

skills/**/SKILL.md theo chuẩn Agent Skills: tên lấy từ frontmatter name:, thiếu thì lấy tên thư mục; tên sai hay trùng là lỗi soot check, không bị bỏ qua lặng lẽ. Pack cũng quét skills/**/SKILL.md của riêng nó, và một thư mục chỉ có skills/ dưới packs_dir là pack không cần pack.json. packs/<pack>/ trong thư mục Soot là pack riêng (chỉ skills, grants vẫn ở deployment). Frontmatter requires-tools: (ví dụ [writing_export]) kê các tool mà thiếu thì không làm theo skill được: Soot không giữ đủ các tool đó thì skill không vào danh sách của nó, như skill chỉ dẫn tool ghi của một pack được chọn :read.

Soot cố ý không đọc AGENTS.md hay .agents/. Theo agentsstandard.com và Codex, đó là luật cho coding agent: chúng nạp mọi AGENTS.md từ gốc repo xuống thư mục đang làm việc, và .agents/skills. Nếu Soot cũng đọc chúng thì nhiệm vụ của Soot thành luật của coding agent, còn hướng dẫn đóng góp của repo thành nhiệm vụ của Soot.

Chuyển một agent Codex sang Soot:

Codex / agentsstandardSoot (soots/<id>/)
AGENTS.md (luật cho agent)đổi tên thành MISSION.md
.agents/skills/<tên>/copy vào skills/<tên>/, giữ nguyên SKILL.md
skill dùng chung nhiều agentcopy vào packs_dir/<pack>/skills/, không cần pack.json
MCP server, lệnh shelltool trong pack có pack.json, rồi soot grant <pack>

Ghép phẳng lúc nạp

deployment.json là điểm vào và chỉ liệt kê đường dẫn tới định nghĩa Soot, không chứa agent inline. Loader (internal/core/config, loadConfig) đọc deployment và AI settings, đọc các Soot và source, chọn pack cho từng Soot, kiểm grants.packs, nạp packs_dir, rồi gắn credential binding cho từng operation. Kết quả là một danh sách phẳng: mỗi Soot có đúng skills và tools của pack nó chọn.

Một Soot chọn pack theo ba cách:

Tham chiếuSoot nhận
"office"Mọi skill và mọi tool của pack
"office:read"Mọi skill và chỉ tool đọc
"office:tools=plan,draft"Mọi skill và chỉ các tool được liệt kê

Pack là đơn vị bật tắt, nên ranh giới quan trọng (shell, quản trị, đăng bài, ghi dữ liệu) là một pack riêng, và pack ghi nên để phần đọc dùng độc lập được. tools= chỉ để Soot khỏi mang hết schema của pack lớn, không cấp thêm quyền.

Không có use hay capabilities (recipe lồng trong pack): loader từ chối chúng. Muốn tách quyền thì tách pack.

Pack và quyền

Văn bản mẫu · không phải lệnh
pack.json   needs: {credentials: {API_KEY: {from: "env:STATUS_API_KEY"}}, env: ["HOME"]}
                              │ khai báo
deployment  grants.packs: {"status": {credentials: {API_KEY: "env:STATUS_API_KEY"}, env: ["HOME"]}}
                              │ host cấp (soot add, soot grant, Nest "Cấp quyền")
runtime     tool nhận đúng biến đó, không hơn

"Cài không phải cấp" có mấy hệ quả:

  • soot add chép file vào packs_dir, ghi nguồn, in thứ pack cần và cấp phần phía host vào grants.packs (--no-grant để cấp sau). Nó không chạy script, không build, không khởi động adapter, không chọn pack cho Soot nào.
  • Soot chỉ có pack khi tự liệt kê nó. Đầu mối hay Soot khác chỉ yêu cầu được cấp; việc cấp luôn qua người duyệt. Credential kiểu operator do người dùng nhập ở Nest.
  • Cập nhật pack không mở rộng quyền: bản cần nhiều hơn quyền đang có bị giữ tới khi người xem bản xem trước và cấp.

Pack chia theo đơn vị người dùng muốn bật hoặc tắt cùng nhau: tách khi integration, dependency, vòng đời phát hành hoặc mức rủi ro cần độc lập. Hợp đồng thực thi (tool là process, envelope soot/v1, approval, effect chưa rõ), giao diện, page và storage của pack là phần mở rộng, xem extensions.md.

General

General là Soot mà soot spawn và Nest tạo sẵn. Nó không nằm cứng trong binary: mỗi release Soot Forge phát hành general-release_<v>.tar.gz (định nghĩa) và general-preset_<v>.json. Preset nói pack nào cần tải (install), lấy từ đâu (sources), General chọn pack nào (packs), và Nest cộng thêm gì (nest.packs: soot-nest, nest-lead). Pack toolbox (file, tìm kiếm, web, shell) do runtime cung cấp sẵn trong binary: preset chỉ liệt kê nó trong packs, không bao giờ trong install, nên không có gì để tải, cập nhật hay gỡ, và workspace không cần thư mục packs/toolbox (thư mục cũ còn sót thì bị bỏ qua, pack dựng sẵn thắng). Soot chọn toolbox, toolbox:read hay toolbox:tools=a,b như mọi pack.

Thứ giải thích hay vận hành một tính năng của runtime thì đi kèm runtime (builtin/corepacks/), để không lệch khỏi binary; kiến thức nghiệp vụ ở lại Forge. Theo cách đó soot (tool configure và save_skill), nest-lead (tool và skill của Lead) và soot-nest (side-bar, nest-pieces, nest-links) cũng có sẵn như toolbox. Preset vẫn liệt kê ba pack này trong install và nest.packs cho runtime cũ; runtime này không tải chúng, và Soot chọn chúng như trước. Hai skill gắn theo vai, không cần chọn và không có cấu hình: soot-domain cho mọi Soot, coordinator-mail cho mọi Soot trong một đội (Đầu mối và thành viên, nơi việc gửi tới đội đến). Skill chỉ tốn một dòng trong danh mục skill, nội dung đọc khi cần, và không cấp quyền gì.

Tạo workspace tải archive, kiểm SHA-256, cài pack rồi ghi một cấu hình phẳng. Từ đó workspace không phụ thuộc preset: mở Nest lại không khôi phục quyền đã thu hồi, pack mới chỉ vào qua cập nhật. Thiếu release asset thì tạo thất bại hẳn, không lùi sang checkout cạnh bên hay tải không kiểm. Nest tạo mới ghi lead: "general", nên General là Lead của Nest đó. soot spawn --empty tạo Soot trống không pack; --project và --source không tải gì (xem Bundle và Source).

Nhóm

Người dùng chọn một Soot và giao việc. Khi Soot có nhóm được cấp, nó tự chọn nhóm hợp cho từng việc như chọn một tool; việc đơn giản thì trả lời thẳng.

Văn bản mẫu · không phải lệnh
Người dùng ─► Soot đã chọn (root, chat tự động)
                 │ spawn_subagent group/<id>   (AgentCore)
                 ▼
          nhóm A: Đầu mối ─► đồng đội (named delegate)
                 │ kết quả + bằng chứng
                 ▼
          câu trả lời tổng hợp

Chỉ có một đường thực thi. AgentCore sở hữu vòng lặp model, job, ngân sách, retry, hủy và subagent; Soot chỉ gắn cấu hình, quyền, storage và công cụ. Không có dispatcher nhóm thứ hai hay "orchestrator" riêng; hướng dẫn phối hợp chung nằm trong schema của spawn_subagent, pack skill chỉ mang chuyên môn.

Một nhóm khai entries (ai nhận chat, phần tử đầu là Đầu mối), members (roster), description (để delegation biết khi nào chọn), limits (số delegation, độ sâu, concurrency, model call) và tùy chọn brief, projects, contract (workspace.md). Field đầy đủ: soot schema deployment.

Nhóm không cấp quyền

Quy tắc quan trọng nhất: nhóm không mở rộng hay thu hẹp quyền của thành viên. Mỗi thành viên chạy với chính Soot của nó (packs, credentials...). Các field cũ group_operations, members.<id>.operations, members.<id>.credentials bị loader từ chối (retired_field) thay vì bị bỏ qua, để deployment cũ không vô tình rộng quyền. Nhóm chỉ quyết ba thứ: ai nhận chat và ai được gọi, giới hạn phối hợp chung (giao với ngân sách gốc của Soot đầu vào), và phạm vi dữ liệu (group_id trong envelope tool do host điền, model không chọn được; backend của credential phải tự giới hạn dữ liệu).

Một lượt chạy nhóm còn theo các quy tắc sau:

  • Nhóm nhận yêu cầu gốc của người dùng, không nhận task hay context do Soot gốc tự viết, nên văn bản do model sinh không mang dữ liệu nhóm này sang nhóm khác.
  • Lịch sử native, memory và artifact tách theo hội thoại, nhóm và Soot; không chuyển giữa nhóm. Hội thoại ghi mọi nhóm đã đóng góp; muốn đọc lại phải có quyền với tất cả, mất quyền một nhóm thì cả hội thoại trộn bị ẩn.
  • Mỗi lượt đóng băng đích đến và fingerprint cấu hình; cấu hình đổi giữa chừng thì việc xếp hàng bị chặn, không tự mở rộng. Effect chưa rõ không tự chạy lại.
  • Host shell không phải sandbox: thành viên có shell vẫn có shell trong nhóm.

Đồng đội mà delegation gọi phải ở cùng runtime với Soot gốc, vì định danh, grants, store và receipt là của một runtime. Ngoại lệ hẹp là nhóm remote (runtime khác phục vụ): nó nhận hợp đồng dữ liệu và việc gửi tới (send, contracts/team-mail.md), không phải đích chat hay delegation (workspace.md).

Chat có hai chế độ, không đổi sau khi tạo: tự động (group_id: "auto", Soot chọn nhóm cho từng việc, vẫn một chat) và ghim (nhóm cố định). Thư mục sidebar không cấp quyền. Cấu hình cũ collaboration.<soot>.members vẫn chạy cho chat cũ, không tự chuyển vào nhóm.

Trong Nest, Đội Soot → Tạo nhóm dựng nhóm; lưu là revision nháp, Áp dụng đợi việc đang chạy xong. Chỉ operator sửa được quyền nhóm (surfaces.md).

Lead và Đầu mối

Lead là trợ lý riêng của người dùng trong Nest: một cái mỗi server, không bao giờ thuộc nhóm, có quyền quản trị (nest-lead_manage; việc cần tiền, ngân sách hay đổi quyền chờ người ở Cần bạn). Đầu mối là Soot đầu tiên trong entries của một nhóm: nhận việc đầu tiên, chạy lịch và bot của nhóm, giao task cho đồng đội, và không có quyền quản trị. Lead cấu hình bằng lead trong deployment; Đầu mối chỉ là thứ tự entries.

Việc gửi tới đội (send, workspace.md) do host định tuyến, không tốn lượt model: việc cho team:<id> chạy bằng Đầu mối; việc cho soot:<thành viên> chạy bằng chính thành viên, trong đội, với công cụ và quyền của nó, ngân sách của đội và daily_tokens, max_run_tokens của nó. Lịch chỉ-tool của một thành viên, khi wake_when đúng, đánh thức thành viên đó; chuỗi tool lỗi mới đánh thức Đầu mối. Đội đặt inbox: "hold" thì việc từ đội khác chờ người bắt đầu.

Lead nhận ra qua pack nest-lead, không qua tên. Roster có liệt kê Lead thì vẫn nạp nhưng bỏ Lead ra; lịch, bot và task của nhóm không bao giờ chạy bằng Lead. Nest mở mà chưa có Lead thì thêm một Soot lead: pack nest-lead và lời dặn của Lead đi kèm runtime; các pack còn lại theo General của workspace, hoặc theo preset General của release Forge (kiểm SHA-256) khi workspace chưa từng có chúng. Hợp đồng đầy đủ: contracts/lead.md.

Mẫu nhóm

Mẫu nhóm (soot/group-template/v1 đến v3) là cách phân phối "một đội dựng sẵn": thành viên với soul và mission, pack họ cần (archive kèm SHA-256), credential cần nối. Từ v2 có inputs (câu hỏi cần xác nhận), profiles (ngân sách token mỗi thành viên) và schedules chạy dưới tên Đầu mối; mẫu có thể để root: "" để người dùng chọn Đầu mối lúc cài. v3 thêm hợp đồng nhóm và lịch chạy chuỗi tool không cần model.

Mẫu không chứa deployment đang chạy, provider, credential, lịch sử hay DB, và không cấp gì ngoài pack nó nêu tên. Có hai đường cài, cùng ra một thay đổi cấu hình:

  • Hỏi Lead trong chat. Lead đọc catalog Forge đã xác thực (offline thì chỉ mẫu trên máy), hỏi inputs, đề xuất profile, rồi gọi group.create. Thẻ Cần bạn liệt kê nhóm, Đầu mối, thành viên, trần token, chu kỳ và brief. Duyệt thì cài archive nếu thiếu và lưu mọi thứ trong một revision; Hoàn tác lưu trữ các Soot đó và gỡ nhóm.
  • Tạo nhóm trong Nest, hoặc CLI soot group add|inspect|create.

Credential của mẫu gắn theo tham chiếu vào kho credential công cụ của host; người dùng nhập giá trị sau. soot group save và export lưu nhóm đã chỉnh thành mẫu mới (không đọc credential hay transcript). Đưa lên Forge là PR.

Soot Forge

Soot Forge là nơi công khai để tìm, cài và chia sẻ thứ Soot dùng được; trang trysoot.com/forge dựng từ catalog.json của repo.

Repo gồm catalog.json (catalog pack, viết tay), groups.json (catalog mẫu nhóm, tách riêng), packs/, groups/ và general/ (preset).

  • Đóng góp bằng PR: pack nằm trong repo, hoặc một mục catalog trỏ tới repo công khai, thư mục và full commit đã review. Pin commit để đổi branch không đổi pack đã review.
  • Mỗi release dựng một archive cho từng mục, kèm SHA256SUMS; tag và asset đã phát hành không đổi. Runtime lấy release ổn định mới nhất và kiểm SHA-256 trước khi ghi. Pack cài từ URL asset của Forge để lại receipt trỏ về đó, nhờ vậy cập nhật tự động biết nó là pack Forge.
  • Catalog là metadata, không phải quyền: đọc entry hay cài pack không cấp gì cho Soot nào. CI của Forge kiểm quy tắc (mỗi tool khai run.mode, mọi {{cred:NAME}} có trong needs). Checksum cho biết byte nhận được, không xác thực người phát hành.
  • toolbox không có trên Forge: runtime cung cấp nó (manifest nhúng ở builtin/toolbox/pack.json). Nest liệt kê nó là "có sẵn trong runtime"; soot add và soot pack add từ chối cài nó. soot, nest-lead, soot-nest cũng vậy (builtin/corepacks/); Forge còn giữ bản của chúng và skill coordinator-mail trong team-rhythm, đánh dấu deprecated, cho runtime 0.21 trở về trước. Thư mục packs/<id> mà runtime cũ đã cài thì bị bỏ qua, skill cùng tên của một pack Forge nhường cho bản của runtime, và soot check ghi mỗi chỗ một note (không phải cảnh báo).
  • Cài ngoài Forge vẫn được (soot add từ Git hay archive), nhưng không được cập nhật tự động. Forge không phải marketplace trả tiền hay registry runtime.

Cập nhật

Một dịch vụ cập nhật duy nhất giữ bốn loại đồ cài tự mới: pack Forge, General, nhóm tạo từ mẫu Forge, và chính phần mềm Soot. Client (Nest, soot updates) chỉ hiển thị một tài liệu do dịch vụ trả; không client nào tự so version. Ba quy tắc:

  • Chỉ bản không MAJOR tự áp dụng. MAJOR, kind đặt manual, mục bị chặn thì chỉ liệt kê và chờ soot updates apply.
  • Không bao giờ ghi đè tay chỉnh. Nhóm được trộn từng field: field người dùng đã sửa được giữ, phần còn lại lấy bản mới. Đổi thành phần nhóm thì chờ.
  • Cài không phải cấp. Bản làm một Soot hay nhóm rộng quyền hơn (pack mới, nhu cầu mới) không tự áp dụng mà chờ người đồng ý. Pack cài từ Git hay file không thuộc Forge nên đứng yên.

Lệnh: soot updates.

Source: nhiều repo, một runtime

Một runtime nhận Soot từ nhiều repo. Mỗi repo sở hữu một source và deploy độc lập; host giữ phần còn lại.

Mỗi repo chỉ ghi dưới sources.d/<id>/; deployment.json, AI settings, vault và Soot tạo trong Nest thuộc host.

Của hostCủa source
Listener, provider AI, tier, vault, data poolSoot (chỉ chọn tier trong model), pack riêng
default_soot, lead, routes, grants.sourcesNhóm, client website, lịch gắn Soot hoặc nhóm của source
Soot tạo trong NestSoot của source sửa trong Nest để thử nhanh, nhưng hiện drift tới khi repo deploy lại

Lý do chia: thêm hay đổi provider không bao giờ cần deploy lại một source, và deploy một source không bao giờ chạm provider hay source khác. Quy tắc giữ ranh giới đó: source chỉ chọn tier chứ không chọn provider; ID là toàn runtime; source không mang secret. Soot của source liệt kê pack trong packs như mọi Soot; pack nào source không mang theo (ví dụ trình duyệt của máy) là lời xin host, và host cho hay không trong grants.sources. Xin chưa phải được.

soot spawn --source <id> tạo source, soot bundle kiểm, soot source deploy đưa lên Nest trên máy này, hoặc 2srv deploy cho runtime do 2server quản lý. Deploy là prepare rồi commit, chỉ ghi dưới sources.d/<id>/, không có rollback riêng (deploy lại commit cũ). Gỡ source là deploy source rỗng; hội thoại và lịch sử còn. Cải thiện Soot của source không tạo drift: bản đã học ở .soot/adapters/ ngoài lát, kéo về repo bằng soot improve <soot> --pull --into <repo>.

Project bundle

soot spawn --project <root> tạo một project ở dạng file: deployment, AI scripted để kiểm cục bộ, một Soot support không có grant, schema, hướng dẫn cho coding agent, .env.example chỉ có placeholder, và soot.bundle.json. Nó không cài gì, không chạy runtime.

soot.bundle.json (C1 v1) là bản kê có digest của phần authored. Mỗi pack ghim ba giá trị khác nhau, không thay cho nhau: archive_sha256 (byte archive), tree_digest (cây file sau giải nén, tính cả bit thực thi) và nguồn (archive local hay Git với full commit). selected_executables phải đúng bằng các operation host thực sự cấp, nên cài một pack không thêm mục nào. source_digest bao cả manifest lẫn mọi file. Symlink, file đặc biệt và trạng thái riêng tư (.git, .env, *.db, *.pem...) bị từ chối.

soot bundle kiểm, --refresh ghi lại digest sau khi review sửa đổi có chủ đích, và soot bundle-admit là phía nhận: băm lại offline, không tin receipt, lệch thì từ chối chứ không sửa. Bundle không cấp quyền. Fixture: internal/compose/scaffold/testdata/c1-v1.json.

Ranh giới

AgentCore sở hữu vòng lặp model, job, ngân sách, hủy, subagent (runtime.md). Core (internal/core/config, internal/core/conversation) chọn pack, giao điểm quyền và đóng băng cấu hình mỗi lượt. Pack mang skill, tool, needs, giao diện, storage (extensions.md). Host giữ credential, listener, provider, grants.packs và quyền của nhóm. Nest vẽ roster, chat nhóm, thẻ Cần bạn (surfaces.md).

Cố ý không làm: dispatcher nhóm riêng (delegation là tool của AgentCore), để nhóm cấp quyền (dễ rộng quyền ngầm), để pack mang danh tính hay lịch (một pack phải dùng cho nhiều Soot), tin catalog (đọc, cài, cập nhật đều không cấp), viết agent mới vào core (thêm agent là thêm config, pack và skill).

Chưa có

Nhóm có thành viên ở runtime khác (hiện chỉ nhóm remote cho hợp đồng dữ liệu và việc gửi tới); rollback cho source (deploy lại commit cũ); đẩy mẫu nhóm từ Nest lên Forge (hiện là PR thủ công); pack tích hợp nền tảng ngoài (Telegram, Facebook, X, YouTube, TikTok) mới là dự kiến.

Nội dung được xem lại: 12.11.2026