copilotkit 4.5.1 → 4.7.0

package/README.md

@@ -85,6 +85,101 @@ already have a valid CLI session, the CLI reuses that workspace connection;
 otherwise it opens browser sign-in. This workspace connection is required for
 project creation and is separate from license issuance.
 
+## Managed Channels
+
+`copilotkit channels` connects a hosted Intelligence project to Slack or
+Microsoft Teams. The supported path today is a project scaffolded by
+`copilotkit init`, which offers a Channel during setup and writes the hosted
+`INTELLIGENCE_*` values the runtime needs.
+
+The commands also run in a project that already exists, but that path is not
+hardened yet: `copilotkit project select` provisions the project API key without
+the hosted URLs, so a Channel can attach and still be unable to connect. See
+OSS-714.
+
+```bash
+copilotkit channels add support
+copilotkit channels add support --adapter teams
+copilotkit channels status
+copilotkit channels list
+copilotkit channels rotate support --adapter slack
+copilotkit channels setup
+```
+
+This configures **managed Intelligence Channels**. It does not configure the
+open-source `@copilotkit/channels` adapter packages, which are a separate product
+that shares the words "channels" and "Slack".
+
+`channels add` does the next undone step and is safe to re-run: it declares the
+Channel in `.copilotkit/channels.json`, creates it on the server, writes the
+provider app manifest, and attaches the adapter once your credentials are
+available. Where the flow needs you to do something in a provider console it
+stops and tells you what, why, which variables to set, and the exact command to
+resume with. A stop is a normal outcome and exits 0.
+
+No flag accepts a credential value. Credentials are read from your project's
+`.env`, from a named environment variable, or from a JSON document on stdin; at a
+terminal the CLI offers a masked prompt instead.
+
+### Agent-assisted setup
+
+Much of Slack and Teams setup happens in a provider website — creating the app,
+collecting its tokens, installing it into a workspace. `channels setup` hands
+that work to your coding agent instead of you walking it yourself:
+
+```bash
+copilotkit channels setup
+copilotkit channels setup --no-clipboard
+```
+
+It installs the `channels-setup` skill, then prints a one-line prompt to paste
+into your coding agent and copies it to your clipboard. The prompt is always
+printed, so you can read it before handing it over. Pass `--no-clipboard` in a
+headless or remote shell.
+
+Everything the run needs is in the skill, so the prompt only names the skill and
+the goal. It does not name a provider: Slack or Microsoft Teams is the skill's
+own first question.
+
+Only the prompt goes to stdout. The line introducing it and the clipboard result
+go to stderr, so `copilotkit channels setup > prompt.txt` gives you the payload
+and nothing else.
+
+The install runs first, and the command stops if it fails. A prompt that points
+at a skill which is not there would send the agent to set the provider up from
+memory against a live workspace, which is the outcome the prompt exists to
+prevent.
+
+The install asks you nothing. It pins the skill and every detected coding agent,
+so it runs to completion in a script or a non-TTY shell rather than stopping on a
+picker.
+
+Only `channels-setup` is installed, not every CopilotKit skill. To add the rest:
+
+```bash
+npx copilotkit@latest skills install
+```
+
+`copilotkit skills onboard --channels` installs the skills, signs you in, and
+hands over the same prompt.
+
+`channels setup` selects no hosted project and provisions nothing, so it needs no
+sign-in and works from any directory. Installing the skill is the only thing it
+reaches out for.
+
+`channels status` compares three things that all have to agree — your declared
+configuration, your project's source, and the server — and names whichever one is
+missing. That includes the failure worth knowing about: some runtime mounts defer
+opening the gateway connection until an awaited `channels.ready()` call, so on
+those a project that never makes the call serves HTTP normally, reports no error,
+and answers nothing. Mounts that own their process lifetime start on their own,
+and `status` distinguishes the two rather than warning about both.
+
+`--json` emits a versioned envelope on stdout for agents and scripts, never
+prompts, and never opens a browser. See
+[Managed Channel CLI contracts](../../docs/channels-cli-contracts.md) for the
+declared-Channels file, the envelope shape, and the credential resolution order.
+
 ## Skills And Agent-Assisted Onboarding
 
 Use `copilotkit create` to start a **new** project. Use `copilotkit skills onboard`
@@ -97,8 +192,14 @@ copilotkit skills install --skill react-core,runtime --agent claude-code
 copilotkit skills install --list
 copilotkit skills onboard
 copilotkit skills onboard --no-clipboard
+copilotkit skills onboard --channels
 ```
 
+`--channels` hands over the Slack Channel setup prompt instead of the generic
+add-CopilotKit-to-my-app prompt. It is the same prompt
+`copilotkit channels setup` prints; only the prompt differs, and the install
+and sign-in are unchanged.
+
 `copilotkit skills install` installs CopilotKit agent skills for your coding
 agent (Claude Code, Codex, Cursor, Gemini, and others) by running the standalone
 `skills` installer under the hood.

package/cli-build-info.json

@@ -2,20 +2,20 @@
   "schemaVersion": 1,
   "package": {
     "name": "copilotkit",
-    "version": "4.5.1"
+    "version": "4.7.0"
   },
   "intelligence": {
-    "commit": "c6368d6cc300a87a94e673ec36e8a53f7910c50d"
+    "commit": "932bad4f3c97b61dd0ee5c20b99362e302e5e48a"
   },
   "copilotKit": {
-    "submittedInput": "e816a9315165db0746dfecdcf697038d1deda6c2",
-    "commit": "e816a9315165db0746dfecdcf697038d1deda6c2"
+    "submittedInput": "8e59bfd16b415b9f776a4742aa43942a8d02c2ef",
+    "commit": "8e59bfd16b415b9f776a4742aa43942a8d02c2ef"
   },
   "channel": "production",
-  "triggeringActor": "contextablemark",
+  "triggeringActor": "BenTaylorDev",
   "workflow": {
-    "runId": "30555421477",
-    "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/30555421477"
+    "runId": "30933084879",
+    "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/30933084879"
   },
   "validationResult": "passed",
   "ag2": {
@@ -24,5 +24,5 @@
     "revision": "main",
     "pinned": false
   },
-  "builtAt": "2026-07-30T15:13:07Z"
+  "builtAt": "2026-08-04T17:17:46Z"
 }