@qilin-agent/experimental-agent-team-profile 0.0.0-stage → 3.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kkutysllb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,52 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/experimental/agent-team-profile/README.md
+/:
+  en: f71e99757a629b0c
+  zh: c57717647389180b
+/qilin-experimental-agent-team-profile:
+  en: 92f12fd07afce73e
+  zh: b179684ed18ddb8e
+/qilin-experimental-agent-team-profile/summary:
+  en: 5430215553c12b1a
+  zh: e9224bc23b789812
+/qilin-experimental-agent-team-profile/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 09388d293f9be9cb
+/qilin-experimental-agent-team-profile/use-this-package:
+  en: bbff250eba0f1b89
+  zh: 0a618f05cc88ee2b
+/qilin-experimental-agent-team-profile/use-this-package/install-into-a-profile:
+  en: 5a1b1f69ff50aae6
+  zh: acc2973d84828d35
+/qilin-experimental-agent-team-profile/use-this-package/what-you-get:
+  en: 24e0373d4e795cc5
+  zh: a33f5b27d2114972
+/qilin-experimental-agent-team-profile/understand-the-implementation:
+  en: 71aeb339bbdb0c6d
+  zh: 4e80ceebfa3ef823
+/qilin-experimental-agent-team-profile/further-exploration:
+  en: bb5e29775eb1f2ac
+  zh: 5678d1f87690fce8
+/qilin-experimental-agent-team-profile/model-experience:
+  en: 215e7ba838619b7b
+  zh: a311da3843709f90
+/qilin-experimental-agent-team-profile/model-experience/team-policy-and-tools:
+  en: 8e1e365ff3b0dfb2
+  zh: c6c91fbf1e1df934
+/qilin-experimental-agent-team-profile/model-experience/team-policy-and-tools/what-the-model-sees:
+  en: 08026912a883b5b5
+  zh: 45d8aefa20c5b3d9
+/qilin-experimental-agent-team-profile/model-experience/team-policy-and-tools/token-effect:
+  en: c18715361083dd07
+  zh: 7daadacd960bd2fe
+/qilin-experimental-agent-team-profile/model-experience/team-policy-and-tools/kv-cache-effect:
+  en: e331337b094aacde
+  zh: bb2e5df5ebeb9305
+/qilin-experimental-agent-team-profile/known-limitations-and-deferred-work:
+  en: 46956f72ea78b8e3
+  zh: a4ad7f5bed762ff8
+/qilin-experimental-agent-team-profile/known-limitations-and-deferred-work/dev-note:
+  en: e67f633dc6fe7773
+  zh: 3bb0c20c93f16f98

package/README.md

@@ -1,3 +1,106 @@
-# Temporary Holding Version
+---
+description: "Published experimental Agent Teams profile layer over qilin-base with teammate delegation and fresh workflow children."
+kind: "package-bundle"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @qilin-agent/experimental-agent-team-profile
+
+English | [中文](README.zh.md)
+
+## Summary
+
+`qilin-experimental-agent-team-profile` is a published experimental profile layer that enables [Agent Teams](../agent-team/README.md) over `@qilin-agent/base`. Its patch inserts the Team domain, the Team-scoped tools, and the browser half that draws the Team page in the right Sidebar, and disables ordinary subagent delegation and the overlapping global continuable-child controls. Workflow remains available with fresh children. The qilin installation ships it as an optional bundle that no shipped profile enables; switch it on from the Web sidebar's Plugins page, or add it explicitly to an initialized profile.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## Use this package
+
+### Install into a profile
+
+Add the package to an initialized profile, then run a task that asks the Lead to delegate work:
+
+```sh
+qilin plugin --profile headless add @qilin-agent/experimental-agent-team-profile
+qilin --profile headless "Use Agent Teams to split this task between two teammates, wait, and summarize."
+```
+
+The profile must already contain `@qilin-agent/base`, whose Subagent services and provider rows this layer consumes. Removing the package with `qilin plugin --profile <name> remove @qilin-agent/experimental-agent-team-profile` removes the bundle from the profile's ordered layer list.
+
+### What you get
+
+The layer adds the Agent Teams domain and its scoped creation, roster, messaging, interruption, waiting, and task-board tools, plus the right-Sidebar Team page that renders the roster and task board. Direct delegation uses `spawn_teammate`, which supports fresh and fork context. The `subagent` and `subagent_fork` tools and overlapping global child controls are disabled. Workflow retains the base profile’s `spawn` provider, while the underlying Subagent services and both providers remain available to teammates and workflow.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Implementation internals — click to expand</summary>
+
+The package's runtime content is [`cordis.patch.yml`](cordis.patch.yml). Applied after `qilin-base`, the patch disables `tool-subagent-control`, `tool-subagent-list-agents`, `tool-subagent`, and `tool-subagent-fork`, and inserts the Team service and tool rows with explicit providers and limits, together with the browser half ([`@qilin-agent/experimental-client-ui-agent-team`](../client-ui-agent-team/README.md)) that registers the Team page.
+
+| File | Role |
+|---|---|
+| [`cordis.patch.yml`](cordis.patch.yml) | Ordered patch over `qilin-base` |
+| [`src/index.ts`](src/index.ts) | Empty module entry; the patch is the runtime content |
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+- [Experimental packages](../README.md) — incubation status and publication policy.
+- [Agent Teams service](../agent-team/README.md) — durable roster, messaging, and task-board behavior.
+- [Agent Teams tools](../tool-agent-team/README.md) — the Team-scoped model tool surface.
+- [Base bundle](../../bundle/base/README.md) — the profile layer this patch extends.
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+### Team policy and tools
+
+#### What the model sees
+
+The Team policy and schemas belong to [`@qilin-agent/experimental-tool-agent-team`](../tool-agent-team/README.md). This bundle changes composition only: Team-scoped `list_agents`, `send_message`, and `interrupt_agent` replace the disabled global continuable-child controls. `spawn_teammate` is the direct delegation tool. Workflow’s `agent()` calls create fresh one-shot children; their prompts must contain the context needed for their tasks.
+
+#### Token effect
+
+The bundle adds the Team policy and tool schemas described by `@qilin-agent/experimental-tool-agent-team`; it adds no prompt text of its own.
+
+#### KV Cache effect
+
+The bundle's composition is prefix-stable while its patch, Team identity, and configured tool schemas remain unchanged.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- **Opt-in only** — the package ships with the installation switched off; no shipped CLI, Web, SDK, ACP, or Python profile enables it.
+- **Workflow child tools** — the [Team tool visibility limitation](../tool-agent-team/README.md#known-limitations-and-deferred-work) also applies to workflow children.
+- **Shared checkout** — every teammate observes the same working directory; this bundle adds no worktree isolation or filesystem locking.
+- **Base profile required** — the patch depends on row ids and Subagent providers supplied by `qilin-base`; it is not a standalone profile.
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,106 @@
+---
+description: "叠加在 qilin-base 上公开发布的实验性 Agent Teams profile 层，提供 teammate 委派与 fresh workflow 子代理。"
+kind: "package-bundle"
+---
+
+# @qilin-agent/experimental-agent-team-profile
+
+[English](README.md) | 中文
+
+## 概述
+
+`qilin-experimental-agent-team-profile` 是在 `@qilin-agent/base` 之上启用 [Agent Teams](../agent-team/README.zh.md) 的公开实验性 profile 层。它的 patch 会插入 Team domain、Team-scoped 工具，以及绘制右侧栏团队页的浏览器半，并禁用普通 subagent 委派和名称重叠的全局 continuable-child control。Workflow 仍可创建 fresh 子代理。qilin 安装随附本包作为可选组合包，随附 profile 都不会启用它；可在 Web 侧栏的插件页开启，或显式添加到已初始化的 profile。
+
+## 目录
+
+- [使用本包](#use-this-package)
+- [理解实现](#understand-the-implementation)
+- [进一步探索](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用本包
+
+### 安装到 profile
+
+将本包添加到已初始化的 profile，然后运行一个要求 Lead 委派工作的任务：
+
+```sh
+qilin plugin --profile headless add @qilin-agent/experimental-agent-team-profile
+qilin --profile headless "Use Agent Teams to split this task between two teammates, wait, and summarize."
+```
+
+profile 必须已经包含 `@qilin-agent/base`，本层会使用其中的 Subagent 服务与提供方配置行。执行 `qilin plugin --profile <name> remove @qilin-agent/experimental-agent-team-profile` 移除本包时，bundle 也会从 profile 的有序层列表中移除。
+
+### 获得的功能
+
+本层会添加 Agent Teams domain，以及 Team-scoped 创建、roster、消息、interrupt、等待与任务板工具，并添加渲染 roster 与任务板的右侧栏团队页。直接委派使用支持 fresh 和 fork 上下文的 `spawn_teammate`。`subagent`、`subagent_fork` 工具和名称重叠的全局 child control 均被禁用。Workflow 保留 base profile 的 `spawn` 提供方，底层 Subagent 服务和两个提供方仍供 teammate 与 workflow 使用。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 理解实现
+
+<details>
+<summary>实现细节——点击展开</summary>
+
+本包的运行时内容是 [`cordis.patch.yml`](cordis.patch.yml)。在 `qilin-base` 之后应用时，patch 会禁用 `tool-subagent-control`、`tool-subagent-list-agents`、`tool-subagent` 和 `tool-subagent-fork`，并以显式 provider 和限制插入 Team 服务与工具行，同时插入注册团队页的浏览器半（[`@qilin-agent/experimental-client-ui-agent-team`](../client-ui-agent-team/README.zh.md)）。
+
+| 文件 | 职责 |
+|---|---|
+| [`cordis.patch.yml`](cordis.patch.yml) | 叠加在 `qilin-base` 之上的有序 patch |
+| [`src/index.ts`](src/index.ts) | 空模块入口；patch 是运行时内容 |
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 进一步探索
+
+- [实验性包](../README.zh.md)——孵化状态与发布规则。
+- [Agent Teams service](../agent-team/README.zh.md)——持久 roster、消息与任务板行为。
+- [Agent Teams 工具](../tool-agent-team/README.zh.md)——Team-scoped 模型工具表层。
+- [Base bundle](../../bundle/base/README.zh.md)——本 patch 扩展的 profile 层。
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+### Team 策略与工具
+
+#### 模型会看到什么
+
+Team 策略与 schema 由 [`@qilin-agent/experimental-tool-agent-team`](../tool-agent-team/README.zh.md) 所有。本 bundle 只改变 composition：Team-scoped `list_agents`、`send_message` 与 `interrupt_agent` 会替代已禁用的全局 continuable-child control。`spawn_teammate` 是直接委派工具。Workflow 的 `agent()` 调用创建 fresh 一次性子代理；其提示词必须包含任务所需的上下文。
+
+#### Token 影响
+
+本 bundle 会加入 `@qilin-agent/experimental-tool-agent-team` 描述的 Team 策略与工具 schema；它自身不增加提示词文本。
+
+#### KV Cache 影响
+
+只要 bundle patch、Team identity 与配置的工具 schema 不变，本 bundle 的 composition 就保持前缀稳定。
+
+## 已知限制与延期工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- **仅显式启用**——本包随安装提供但默认关闭；随附 CLI、Web、SDK、ACP 与 Python profile 都不会启用它。
+- **Workflow 子代理工具**——[Team 工具可见性限制](../tool-agent-team/README.zh.md#known-limitations-and-deferred-work)也适用于 workflow 子代理。
+- **共享 checkout**——所有 teammate 都观察同一个工作目录；本 bundle 不提供 worktree 隔离或文件系统锁。
+- **需要 base profile**——本 patch 依赖 `qilin-base` 提供的配置行 id 与 Subagent 提供方；它不是独立 profile。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者的工作上下文——点击展开</summary>
+
+无。
+
+</details>

package/cordis.patch.yml

@@ -0,0 +1,35 @@
+# Experimental Agent Teams profile layer. Apply after qilin-base so these replacements
+# keep direct delegation and coordination on the Team tools.
+
+- id: tool-subagent-control
+  disabled: true
+
+- id: tool-subagent-list-agents
+  disabled: true
+
+- id: tool-subagent
+  disabled: true
+
+- id: tool-subagent-fork
+  disabled: true
+
+- insert:
+    - id: agent-team
+      name: '@qilin-agent/experimental-agent-team'
+      config:
+        maxMembers: 8
+        maxTasks: 256
+        maxPendingMessagesPerMember: 64
+        maxMessageBytes: 65536
+        disposalTimeoutMs: 5000
+
+    - id: tool-agent-team
+      name: '@qilin-agent/experimental-tool-agent-team'
+      config:
+        freshProvider: spawn
+        forkProvider: fork
+
+    # The browser half of the same feature: without it the roster and task board
+    # the rows above enable have no right-Sidebar Team page to appear in.
+    - id: client-ui-agent-team
+      name: '@qilin-agent/experimental-client-ui-agent-team'

package/icon.svg

@@ -0,0 +1,12 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M13.3027 17.1077H9.03125V12.8372H13.3027V17.1077ZM17.5742 12.8372C17.574 15.1958 15.6623 17.1075 13.3037 17.1077V8.56567H17.5742V12.8372Z" fill="url(#a)" />
+  <path d="M18.5229 12.8372V8.56567H22.7944V12.8372H27.0659V17.1077H22.7944C20.4357 17.1077 18.5232 15.1959 18.5229 12.8372Z" fill="#F2AF63" />
+  <path d="M17.5742 26.6072H13.3037V18.0642C15.6625 18.0644 17.5742 19.9769 17.5742 22.3357V26.6072ZM13.3027 22.3357H9.03125V18.0642H13.3027V22.3357Z" fill="#7CB7FF" />
+  <path d="M22.7944 26.6072H18.5229V22.3357C18.5229 19.9768 20.4355 18.0642 22.7944 18.0642H27.0659V22.3357H22.7944V26.6072Z" fill="#45D9E7" />
+  <defs>
+    <linearGradient id="a" x1="16.1247" y1="6.6613" x2="9.03125" y2="19.2206" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#7CB7FF" />
+      <stop offset="1" stop-color="#145AF3" />
+    </linearGradient>
+  </defs>
+</svg>

package/lib/index.js

@@ -0,0 +1 @@
+export {};

package/lib/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @qilin-agent/experimental-agent-team-profile — experimental Agent Teams profile bundle.
+ * The package's runtime content is its `qilin.bundle.patch` document; this
+ * module exports no runtime API.
+ * @module @qilin-agent/experimental-agent-team-profile
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Agent Teams",
+    "description": "Enable team collaboration, team tools, the member roster, and the shared task board."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "智能体团队",
+    "description": "启用团队协作、团队工具、成员列表和共享任务看板。"
+  }
+}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@qilin-agent/experimental-agent-team-profile",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Experimental profile bundle enabling Agent Teams over qilin-base",
+  "icon": "./icon.svg",
+  "version": "3.1.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "packages/experimental/agent-team-profile"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "files": [
+    "icon.svg",
+    "locale/*.json",
+    "lib/index.js",
+    "cordis.patch.yml",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "qilin": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@qilin-agent/experimental-agent-team": "3.1.3",
+    "@qilin-agent/experimental-client-ui-agent-team": "3.1.3",
+    "@qilin-agent/experimental-tool-agent-team": "3.1.3"
+  },
+  "peerDependencies": {
+    "@qilin-agent/kylin": "~4.0.3"
+  },
+  "devDependencies": {
+    "js-yaml": "^4.2.0",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/kylin-plugin-include": "~1.0.8"
+  }
 }