copilotkit 4.10.0 → 4.10.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -3
- package/cli-build-info.json +8 -8
- package/index.js +16 -14
- package/onboarding/index.json +26 -1
- package/onboarding/prompts/authenticate/start.md +6 -6
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +7 -7
- package/onboarding/prompts/credentials/plan.md +20 -20
- package/onboarding/prompts/credentials/settle-credentials.md +7 -7
- package/onboarding/prompts/credentials/write-plan.md +5 -5
- package/onboarding/prompts/fallback/best-effort.md +6 -6
- package/onboarding/prompts/feature/a2ui/implement.md +6 -6
- package/onboarding/prompts/feature/a2ui/proof.md +6 -6
- package/onboarding/prompts/feature/a2ui/start.md +7 -7
- package/onboarding/prompts/feature/channels/implement.md +70 -0
- package/onboarding/prompts/feature/channels/proof.md +60 -0
- package/onboarding/prompts/feature/channels/start.md +87 -0
- package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/start.md +7 -7
- package/onboarding/prompts/feature/complete.md +1 -1
- package/onboarding/prompts/feature/learning/implement.md +12 -12
- package/onboarding/prompts/feature/learning/proof.md +7 -7
- package/onboarding/prompts/feature/learning/start.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/start.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
- package/onboarding/prompts/feature/realtime-sync/start.md +6 -6
- package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
- package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
- package/onboarding/prompts/feature/rich-threads/start.md +6 -6
- package/onboarding/prompts/feature/stop.md +10 -4
- package/onboarding/prompts/feature/voice/implement.md +6 -6
- package/onboarding/prompts/feature/voice/proof.md +6 -6
- package/onboarding/prompts/feature/voice/start.md +7 -7
- package/onboarding/prompts/framework/ag2.md +2 -2
- package/onboarding/prompts/framework/agno.md +2 -2
- package/onboarding/prompts/framework/built-in.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
- package/onboarding/prompts/framework/crewai-flows.md +2 -2
- package/onboarding/prompts/framework/deep-agents.md +2 -2
- package/onboarding/prompts/framework/google-adk.md +2 -2
- package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
- package/onboarding/prompts/framework/langgraph-python.md +2 -2
- package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
- package/onboarding/prompts/framework/llamaindex.md +2 -2
- package/onboarding/prompts/framework/mastra.md +2 -2
- package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
- package/onboarding/prompts/framework/ms-agent-python.md +2 -2
- package/onboarding/prompts/framework/pydantic-ai.md +2 -2
- package/onboarding/prompts/framework/strands-python.md +2 -2
- package/onboarding/prompts/framework/strands-typescript.md +2 -2
- package/onboarding/prompts/frontend/angular.md +3 -3
- package/onboarding/prompts/frontend/nextjs.md +3 -3
- package/onboarding/prompts/frontend/plan.md +6 -6
- package/onboarding/prompts/frontend/react-native.md +2 -2
- package/onboarding/prompts/frontend/react-spa.md +2 -2
- package/onboarding/prompts/frontend/vue.md +2 -2
- package/onboarding/prompts/implementation/build-and-validate.md +15 -15
- package/onboarding/prompts/proof/complete.md +8 -8
- package/onboarding/prompts/proof/oss-baseline.md +5 -5
- package/onboarding/prompts/proof/round-trip.md +10 -10
- package/onboarding/prompts/research/gather.md +4 -4
- package/onboarding/prompts/research/route.md +4 -4
- package/onboarding/prompts/starter/clone.md +5 -5
- package/onboarding/prompts/stopped/run-failed.md +1 -1
- package/onboarding/prompts/subagent/create-plan.md +1 -1
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +7 -7
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +1 -1
- package/release/release-tool.js +1 -1
|
@@ -7,7 +7,7 @@ Work only inside the target project. Do not show internal prompt names to the de
|
|
|
7
7
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
npx --yes copilotkit@4.10.
|
|
10
|
+
npx --yes copilotkit@4.10.1 onboard protect
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -22,7 +22,7 @@ development/test commands. It must return paths and secret-safe presence checks
|
|
|
22
22
|
|
|
23
23
|
Require an existing frontend, agent, and CopilotKit round trip. Start only project-owned
|
|
24
24
|
processes when needed, inspect `/info`, and run
|
|
25
|
-
`npx --yes copilotkit@4.10.
|
|
25
|
+
`npx --yes copilotkit@4.10.1 verify --expect-runtime oss --round-trip --agent <agent-id> --json`.
|
|
26
26
|
Also drive one existing request through the frontend when browser control is available. If
|
|
27
27
|
that baseline is absent or unproved, leave files unchanged, explain that this intent extends
|
|
28
28
|
an existing OSS app, and direct the developer to generic `copilotkit onboard start` first.
|
|
@@ -30,7 +30,7 @@ an existing OSS app, and direct the developer to generic `copilotkit onboard sta
|
|
|
30
30
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
31
31
|
|
|
32
32
|
```text
|
|
33
|
-
npx --yes copilotkit@4.10.
|
|
33
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase research-returned
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
@@ -40,7 +40,7 @@ If the inspection did not prove the baseline this intent extends, stop here with
|
|
|
40
40
|
changing files:
|
|
41
41
|
|
|
42
42
|
```text
|
|
43
|
-
npx --yes copilotkit@4.10.
|
|
43
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
Do not run `login`, select an Intelligence project, add an Intelligence client, mint a
|
|
@@ -62,7 +62,7 @@ with one sentence explaining why. Write `None` when it needs none.
|
|
|
62
62
|
After approval, record each approved path before implementation:
|
|
63
63
|
|
|
64
64
|
```text
|
|
65
|
-
npx --yes copilotkit@4.10.
|
|
65
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
If an approved path changed after capture and no implementation step has run, add
|
|
@@ -72,7 +72,7 @@ authorize a path the approved plan did not list.
|
|
|
72
72
|
Then report the plan this run is about to implement:
|
|
73
73
|
|
|
74
74
|
```text
|
|
75
|
-
npx --yes copilotkit@4.10.
|
|
75
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase plan-written
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
Then run `npx --yes copilotkit@4.10.
|
|
78
|
+
Then run `npx --yes copilotkit@4.10.1 onboard read feature/a2ui/implement`.
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Implement a managed Channel without rewriting a working agent
|
|
2
|
+
|
|
3
|
+
Delegate implementation to one subagent with the approved plan and fetched official
|
|
4
|
+
Channels guide. Use the already chosen Slack or Teams adapter only as
|
|
5
|
+
`channels add --adapter slack|teams`. Never read, print, synthesize, or add a secret.
|
|
6
|
+
If a required credential variable is missing, stop with that specific setup
|
|
7
|
+
requirement.
|
|
8
|
+
|
|
9
|
+
If the folder was empty, clone OpenTag from https://github.com/CopilotKit/OpenTag.git
|
|
10
|
+
and do not rewrite it. Point the subagent at the existing OpenTag agent and runtime
|
|
11
|
+
to verify and run. If the project already has an agent or app, do not clone. Keep
|
|
12
|
+
that code and wire a managed Channel.
|
|
13
|
+
|
|
14
|
+
On Teams, skip Slack-only tools and the Slack e2e harness. Do not add a CopilotKit
|
|
15
|
+
web app to make this intent look complete. Do not replace the existing agent.
|
|
16
|
+
|
|
17
|
+
If repository evidence does not prove an existing valid Intelligence selection, give
|
|
18
|
+
the developer `login` to run, wait, then list projects and select or create one only
|
|
19
|
+
after they choose. Require the secret-safe project/key provisioning summary before
|
|
20
|
+
wiring the Channel. Never display a key.
|
|
21
|
+
|
|
22
|
+
Run `channels add` until it reports completed. Run the focused type/test command and
|
|
23
|
+
start the long-running runtime. Confirm `/info` can return HTTP 200, but treat that
|
|
24
|
+
as capability evidence rather than completed Channel proof. Record changed paths
|
|
25
|
+
and validation results.
|
|
26
|
+
|
|
27
|
+
After validation and each repair, run:
|
|
28
|
+
|
|
29
|
+
```text
|
|
30
|
+
npx --yes copilotkit@4.10.1 onboard audit
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Continue only when it starts with `Status: passed`. A path under `Authorized to change:` is
|
|
34
|
+
not a finding. Carry it into the final summary with its reason.
|
|
35
|
+
|
|
36
|
+
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
37
|
+
with the implementation subagent's `Files changed` section. If that section does not name
|
|
38
|
+
the path, accept the developer's external change:
|
|
39
|
+
|
|
40
|
+
```text
|
|
41
|
+
npx --yes copilotkit@4.10.1 onboard protect --accept-external --path <path>
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
For an env file where the developer placed a requested credential, use
|
|
45
|
+
`onboard protect --accept-credential --path <path>` instead. If the subagent names the path,
|
|
46
|
+
or its report does not settle who changed it, ask the developer to allow the unplanned
|
|
47
|
+
change. Only after they agree, record their answer:
|
|
48
|
+
|
|
49
|
+
```text
|
|
50
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
54
|
+
with `Status: blocked`, route out and stop:
|
|
55
|
+
|
|
56
|
+
```text
|
|
57
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
When implementation validation passes, report it:
|
|
61
|
+
|
|
62
|
+
```text
|
|
63
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase build-validated
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
67
|
+
the feature stop route above without further changes.
|
|
68
|
+
|
|
69
|
+
Otherwise run
|
|
70
|
+
`npx --yes copilotkit@4.10.1 onboard read feature/channels/proof`.
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Prove a real mention reply on the chosen provider
|
|
2
|
+
|
|
3
|
+
Delegate proof to a fresh subagent. Confirm `channels add` completed,
|
|
4
|
+
`channels status` is clean, and the named Channel is `online`. Then require a real
|
|
5
|
+
mention on the chosen Slack or Teams provider and a useful agent reply.
|
|
6
|
+
If a browser tool is available, use it for the mention proof before completing.
|
|
7
|
+
|
|
8
|
+
HTTP 200 on runtime info is not proof. Do not treat a listening port, a resolved
|
|
9
|
+
`ready()` call, or `/info` as a mention reply. Record the mention, the reply, the
|
|
10
|
+
Channel name, app URL or process IDs, and safe stop commands. Fix changed-file
|
|
11
|
+
defects and repeat.
|
|
12
|
+
|
|
13
|
+
If a gate cannot run, do not complete this run. Name the gate. Use the feature stop
|
|
14
|
+
route after the audit rules below.
|
|
15
|
+
|
|
16
|
+
Report each attempt at the proof as it ends, counting from one:
|
|
17
|
+
|
|
18
|
+
```text
|
|
19
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase journey-attempted --attempt 1
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Report each repair cycle the same way, counting from one:
|
|
23
|
+
|
|
24
|
+
```text
|
|
25
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase repair-attempted --attempt 1
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
After the final attempt, report the gate exactly once:
|
|
29
|
+
|
|
30
|
+
```text
|
|
31
|
+
npx --yes copilotkit@4.10.1 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Use `passed` only for a proved mention reply, `failed` for an attempted proof that
|
|
35
|
+
failed, and `skipped` when the proof could not run. Then run `npx --yes copilotkit@4.10.1 onboard audit`.
|
|
36
|
+
Continue only when it starts with `Status: passed`.
|
|
37
|
+
|
|
38
|
+
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
39
|
+
with the proof subagent's `Files changed` section. If that section does not name the path,
|
|
40
|
+
run `onboard protect --accept-external --path <path>`, or
|
|
41
|
+
`onboard protect --accept-credential --path <path>` for an env file where the developer
|
|
42
|
+
placed a requested credential. If the subagent names the path, or its report does not settle
|
|
43
|
+
who changed it, ask the developer to allow it. Only after they agree, run
|
|
44
|
+
`onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"`.
|
|
45
|
+
Run the audit again after each accepted or authorized change.
|
|
46
|
+
|
|
47
|
+
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
48
|
+
|
|
49
|
+
```text
|
|
50
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
When the audit passes and the mention proof passed, run
|
|
54
|
+
`npx --yes copilotkit@4.10.1 onboard read feature/complete` with the actual surface
|
|
55
|
+
outcome. Use `--visual-check performed` only when a browser drove Slack or Teams web
|
|
56
|
+
and proved the mention reply. Use `--visual-check skipped-no-browser-tool` only when
|
|
57
|
+
no browser tool was available.
|
|
58
|
+
|
|
59
|
+
If the mention proof did not pass, or a gate cannot run, use the feature stop
|
|
60
|
+
route above. Do not run `onboard complete`.
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# Add a managed Channel for Slack or Microsoft Teams
|
|
2
|
+
|
|
3
|
+
First, report your coding agent identity using the same command as generic onboarding:
|
|
4
|
+
|
|
5
|
+
```text
|
|
6
|
+
npx --yes copilotkit@4.10.1 onboard identify --coding-agent <coding-agent-slug>
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
Use your own product's slug, such as `codex` or `claude-code`. This also covers entry
|
|
10
|
+
commands that omit `--coding-agent`. It needs no login, browser, or project setup.
|
|
11
|
+
|
|
12
|
+
Treat Slack or Teams as the UI for this intent. A CopilotKit web app is not required.
|
|
13
|
+
Empty folders, agent-only folders, and existing CopilotKit apps are all valid starts.
|
|
14
|
+
Orchestrate with separate read-only, implementation, and proof subagents, each
|
|
15
|
+
restricted to the target project.
|
|
16
|
+
|
|
17
|
+
Before any subagent or project process runs, capture the developer's existing work:
|
|
18
|
+
|
|
19
|
+
```text
|
|
20
|
+
npx --yes copilotkit@4.10.1 onboard protect
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
24
|
+
subagent may write a protected path or an overlapping path unless this run records the
|
|
25
|
+
approved authorization before implementation.
|
|
26
|
+
|
|
27
|
+
Before changing files, send a short welcome. Say you will inspect the project, ask
|
|
28
|
+
Slack or Teams, show a Channel plan, implement only after approval, and prove a real
|
|
29
|
+
mention reply. Then ask Slack or Teams as its own question.
|
|
30
|
+
|
|
31
|
+
Spawn one read-only subagent to inspect the target directory, Git state, package
|
|
32
|
+
manager, Node version, Python version, `uv`, existing agent code, existing CopilotKit
|
|
33
|
+
runtime, Channel config (presence only), Intelligence config (presence only), and the
|
|
34
|
+
normal test/dev commands. It must return paths and secret-safe presence checks only.
|
|
35
|
+
|
|
36
|
+
Do not stop because the project has no CopilotKit web app. Do not send a missing web
|
|
37
|
+
app to the feature stop path. Other feature intents still need a CopilotKit baseline.
|
|
38
|
+
This one does not.
|
|
39
|
+
|
|
40
|
+
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
41
|
+
|
|
42
|
+
```text
|
|
43
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase research-returned
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
47
|
+
failed step.
|
|
48
|
+
|
|
49
|
+
If the folder is empty, and Node 22, Python 3.12, or `uv` is missing, stop here
|
|
50
|
+
without cloning. Do not switch to a custom build in silence. Name the missing tool.
|
|
51
|
+
Offer a custom headless build as a later path. Then route out:
|
|
52
|
+
|
|
53
|
+
```text
|
|
54
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Do not run login, select Intelligence, or create a credential until the developer
|
|
58
|
+
approves the plan. Fetch the official Channels guide before planning:
|
|
59
|
+
https://docs.copilotkit.ai/channels.md
|
|
60
|
+
Retry it a second way if needed.
|
|
61
|
+
|
|
62
|
+
Show a small plan. For an empty folder, clone OpenTag and do not rewrite it. For an
|
|
63
|
+
existing agent or app, keep that code and wire a managed Channel. Slack or Teams is
|
|
64
|
+
only `channels add --adapter slack|teams`. On Teams, skip Slack-only tools and the
|
|
65
|
+
Slack e2e harness. Name focused tests and a real mention proof on the chosen
|
|
66
|
+
provider. Ask for approval separately.
|
|
67
|
+
|
|
68
|
+
The plan must list every protected path it needs to change under `Authorization requested`,
|
|
69
|
+
with one sentence explaining why. Write `None` when it needs none.
|
|
70
|
+
|
|
71
|
+
After approval, record each approved path before implementation:
|
|
72
|
+
|
|
73
|
+
```text
|
|
74
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
If an approved path changed after capture and no implementation step has run, add
|
|
78
|
+
`--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
|
|
79
|
+
authorize a path the approved plan did not list.
|
|
80
|
+
|
|
81
|
+
Then report the plan this run is about to implement:
|
|
82
|
+
|
|
83
|
+
```text
|
|
84
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase plan-written
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
Then run `npx --yes copilotkit@4.10.1 onboard read feature/channels/implement`.
|
|
@@ -15,7 +15,7 @@ Run focused type/test checks and start the app. Record the changed files and val
|
|
|
15
15
|
After validation and each repair, run:
|
|
16
16
|
|
|
17
17
|
```text
|
|
18
|
-
npx --yes copilotkit@4.10.
|
|
18
|
+
npx --yes copilotkit@4.10.1 onboard audit
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
Continue only when it starts with `Status: passed`. A path under `Authorized to change:` is
|
|
@@ -26,7 +26,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
26
26
|
the path, accept the developer's external change:
|
|
27
27
|
|
|
28
28
|
```text
|
|
29
|
-
npx --yes copilotkit@4.10.
|
|
29
|
+
npx --yes copilotkit@4.10.1 onboard protect --accept-external --path <path>
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
For an env file where the developer placed a requested credential, use
|
|
@@ -35,24 +35,24 @@ or its report does not settle who changed it, ask the developer to allow the unp
|
|
|
35
35
|
change. Only after they agree, record their answer:
|
|
36
36
|
|
|
37
37
|
```text
|
|
38
|
-
npx --yes copilotkit@4.10.
|
|
38
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
42
42
|
with `Status: blocked`, route out and stop:
|
|
43
43
|
|
|
44
44
|
```text
|
|
45
|
-
npx --yes copilotkit@4.10.
|
|
45
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
When implementation validation passes, report it:
|
|
49
49
|
|
|
50
50
|
```text
|
|
51
|
-
npx --yes copilotkit@4.10.
|
|
51
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase build-validated
|
|
52
52
|
```
|
|
53
53
|
|
|
54
54
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
55
55
|
the feature stop route above without further changes.
|
|
56
56
|
|
|
57
57
|
Otherwise run
|
|
58
|
-
`npx --yes copilotkit@4.10.
|
|
58
|
+
`npx --yes copilotkit@4.10.1 onboard read feature/chat-suggestions/proof`.
|
|
@@ -12,23 +12,23 @@ project-owned services running.
|
|
|
12
12
|
Report each attempt at the proof as it ends, counting from one:
|
|
13
13
|
|
|
14
14
|
```text
|
|
15
|
-
npx --yes copilotkit@4.10.
|
|
15
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase journey-attempted --attempt 1
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
Report each repair cycle the same way, counting from one:
|
|
19
19
|
|
|
20
20
|
```text
|
|
21
|
-
npx --yes copilotkit@4.10.
|
|
21
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase repair-attempted --attempt 1
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
After the final attempt, report the gate exactly once:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
npx --yes copilotkit@4.10.
|
|
27
|
+
npx --yes copilotkit@4.10.1 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
Use `passed` only for a proved sent suggestion, `failed` for an attempted proof that failed,
|
|
31
|
-
and `skipped` when the proof could not run. Then run `npx --yes copilotkit@4.10.
|
|
31
|
+
and `skipped` when the proof could not run. Then run `npx --yes copilotkit@4.10.1 onboard audit`.
|
|
32
32
|
Continue only when it starts with `Status: passed`.
|
|
33
33
|
|
|
34
34
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -43,9 +43,9 @@ Run the audit again after each accepted or authorized change.
|
|
|
43
43
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
npx --yes copilotkit@4.10.
|
|
46
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
When the audit passes, run
|
|
50
|
-
`npx --yes copilotkit@4.10.
|
|
50
|
+
`npx --yes copilotkit@4.10.1 onboard read feature/complete` with the real browser-proof
|
|
51
51
|
outcome.
|
|
@@ -6,7 +6,7 @@ implementation, and proof to separate subagents and keep all work inside the tar
|
|
|
6
6
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
7
7
|
|
|
8
8
|
```text
|
|
9
|
-
npx --yes copilotkit@4.10.
|
|
9
|
+
npx --yes copilotkit@4.10.1 onboard protect
|
|
10
10
|
```
|
|
11
11
|
|
|
12
12
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -15,7 +15,7 @@ approved authorization before implementation.
|
|
|
15
15
|
|
|
16
16
|
Before edits, identify the current CopilotKit provider, chat component, message lifecycle,
|
|
17
17
|
agent id, package version, and test/dev commands. Prove the existing OSS round trip with
|
|
18
|
-
`/info`, `npx --yes copilotkit@4.10.
|
|
18
|
+
`/info`, `npx --yes copilotkit@4.10.1 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
|
|
19
19
|
and one real frontend request when browser control is available. If there is no proven
|
|
20
20
|
existing CopilotKit chat, leave files unchanged and direct the developer to generic
|
|
21
21
|
onboarding first.
|
|
@@ -23,7 +23,7 @@ onboarding first.
|
|
|
23
23
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
24
24
|
|
|
25
25
|
```text
|
|
26
|
-
npx --yes copilotkit@4.10.
|
|
26
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase research-returned
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
@@ -33,7 +33,7 @@ If the inspection did not prove the baseline this intent extends, stop here with
|
|
|
33
33
|
changing files:
|
|
34
34
|
|
|
35
35
|
```text
|
|
36
|
-
npx --yes copilotkit@4.10.
|
|
36
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
Do not run login, provision Intelligence, request a credential, replace the agent, or alter
|
|
@@ -53,7 +53,7 @@ with one sentence explaining why. Write `None` when it needs none.
|
|
|
53
53
|
After approval, record each approved path before implementation:
|
|
54
54
|
|
|
55
55
|
```text
|
|
56
|
-
npx --yes copilotkit@4.10.
|
|
56
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
57
57
|
```
|
|
58
58
|
|
|
59
59
|
If an approved path changed after capture and no implementation step has run, add
|
|
@@ -63,7 +63,7 @@ authorize a path the approved plan did not list.
|
|
|
63
63
|
Then report the plan this run is about to implement:
|
|
64
64
|
|
|
65
65
|
```text
|
|
66
|
-
npx --yes copilotkit@4.10.
|
|
66
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase plan-written
|
|
67
67
|
```
|
|
68
68
|
|
|
69
|
-
Then run `npx --yes copilotkit@4.10.
|
|
69
|
+
Then run `npx --yes copilotkit@4.10.1 onboard read feature/chat-suggestions/implement`.
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
Use the outcome the proof step observed. Run:
|
|
4
4
|
|
|
5
5
|
```text
|
|
6
|
-
npx --yes copilotkit@4.10.
|
|
6
|
+
npx --yes copilotkit@4.10.1 onboard complete --visual-check <performed|skipped-no-browser-tool|failed>
|
|
7
7
|
```
|
|
8
8
|
|
|
9
9
|
Use `performed` only when browser control drove the real user-visible surface. Use
|
|
@@ -10,7 +10,7 @@ After the project is selected, settle the container from the terminal.
|
|
|
10
10
|
When the plan or the repository already names an id, ask about that one id and nothing else:
|
|
11
11
|
|
|
12
12
|
```text
|
|
13
|
-
npx --yes copilotkit@4.10.
|
|
13
|
+
npx --yes copilotkit@4.10.1 learning containers get <id> --json
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
One call answers it, and no list is needed.
|
|
@@ -18,7 +18,7 @@ One call answers it, and no list is needed.
|
|
|
18
18
|
When no id is in hand, survey what the project holds:
|
|
19
19
|
|
|
20
20
|
```text
|
|
21
|
-
npx --yes copilotkit@4.10.
|
|
21
|
+
npx --yes copilotkit@4.10.1 learning containers list --json
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
One call returns at most 500 containers. When `nextCursor` in the result is not null, read
|
|
@@ -29,7 +29,7 @@ second container for work the first one already covers.
|
|
|
29
29
|
Report what the read found before asking anyone anything:
|
|
30
30
|
|
|
31
31
|
```text
|
|
32
|
-
npx --yes copilotkit@4.10.
|
|
32
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase container-surveyed
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
Everything after this waits on a person, so a run that stops past this point stopped on a
|
|
@@ -50,7 +50,7 @@ user, so the callback can return a different id per tier or per customer.
|
|
|
50
50
|
Use a descriptive lowercase hyphenated id of 1-64 characters:
|
|
51
51
|
|
|
52
52
|
```text
|
|
53
|
-
npx --yes copilotkit@4.10.
|
|
53
|
+
npx --yes copilotkit@4.10.1 learning containers create --id <id> --name <name> --json
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
An id already in use answers `LEARNING_CONTAINER_ALREADY_EXISTS`. That is a container to
|
|
@@ -65,7 +65,7 @@ or a guessed id.
|
|
|
65
65
|
Then report that the container is settled, before any edit:
|
|
66
66
|
|
|
67
67
|
```text
|
|
68
|
-
npx --yes copilotkit@4.10.
|
|
68
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase container-settled
|
|
69
69
|
```
|
|
70
70
|
|
|
71
71
|
Everything above happens between two prompts, so a run that stopped on a developer who could
|
|
@@ -86,13 +86,13 @@ non-zero on an app that is working. Pass what `identifyUser` reads with a repeat
|
|
|
86
86
|
It is not a defect to repair.
|
|
87
87
|
|
|
88
88
|
Run focused tests and
|
|
89
|
-
`npx --yes copilotkit@4.10.
|
|
89
|
+
`npx --yes copilotkit@4.10.1 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
|
|
90
90
|
Repair changed-file failures and record secret-safe evidence.
|
|
91
91
|
|
|
92
92
|
After validation and each repair, run:
|
|
93
93
|
|
|
94
94
|
```text
|
|
95
|
-
npx --yes copilotkit@4.10.
|
|
95
|
+
npx --yes copilotkit@4.10.1 onboard audit
|
|
96
96
|
```
|
|
97
97
|
|
|
98
98
|
Continue only when it starts with `Status: passed`. A path under `Authorized to change:` is
|
|
@@ -103,7 +103,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
103
103
|
the path, accept the developer's external change:
|
|
104
104
|
|
|
105
105
|
```text
|
|
106
|
-
npx --yes copilotkit@4.10.
|
|
106
|
+
npx --yes copilotkit@4.10.1 onboard protect --accept-external --path <path>
|
|
107
107
|
```
|
|
108
108
|
|
|
109
109
|
For an env file where the developer placed a requested credential, use
|
|
@@ -112,24 +112,24 @@ or its report does not settle who changed it, ask the developer to allow the unp
|
|
|
112
112
|
change. Only after they agree, record their answer:
|
|
113
113
|
|
|
114
114
|
```text
|
|
115
|
-
npx --yes copilotkit@4.10.
|
|
115
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
116
116
|
```
|
|
117
117
|
|
|
118
118
|
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
119
119
|
with `Status: blocked`, route out and stop:
|
|
120
120
|
|
|
121
121
|
```text
|
|
122
|
-
npx --yes copilotkit@4.10.
|
|
122
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
123
123
|
```
|
|
124
124
|
|
|
125
125
|
When implementation validation passes, report it:
|
|
126
126
|
|
|
127
127
|
```text
|
|
128
|
-
npx --yes copilotkit@4.10.
|
|
128
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase build-validated
|
|
129
129
|
```
|
|
130
130
|
|
|
131
131
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
132
132
|
the feature stop route above without further changes.
|
|
133
133
|
|
|
134
134
|
Otherwise run
|
|
135
|
-
`npx --yes copilotkit@4.10.
|
|
135
|
+
`npx --yes copilotkit@4.10.1 onboard read feature/learning/proof`.
|
|
@@ -7,7 +7,7 @@ Container. Confirm the thread remains associated with the expected user.
|
|
|
7
7
|
One command decides it:
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
npx --yes copilotkit@4.10.
|
|
10
|
+
npx --yes copilotkit@4.10.1 verify --expect-runtime intelligence --round-trip --agent <agent-id> --expect-learning-container <id> --json
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
It reads the thread back from the platform, so it answers for any runtime mount, and it
|
|
@@ -31,24 +31,24 @@ takes its container before its first agent run. So the container starts empty on
|
|
|
31
31
|
Report each attempt at the proof as it ends, counting from one:
|
|
32
32
|
|
|
33
33
|
```text
|
|
34
|
-
npx --yes copilotkit@4.10.
|
|
34
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase journey-attempted --attempt 1
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
Report each repair cycle the same way, counting from one:
|
|
38
38
|
|
|
39
39
|
```text
|
|
40
|
-
npx --yes copilotkit@4.10.
|
|
40
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase repair-attempted --attempt 1
|
|
41
41
|
```
|
|
42
42
|
|
|
43
43
|
After the final attempt, report the gate exactly once:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
npx --yes copilotkit@4.10.
|
|
46
|
+
npx --yes copilotkit@4.10.1 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
Use `passed` only for a proved Container assignment, `failed` for an attempted proof that
|
|
50
50
|
failed, and `skipped` when the proof could not run. Then run
|
|
51
|
-
`npx --yes copilotkit@4.10.
|
|
51
|
+
`npx --yes copilotkit@4.10.1 onboard audit`. Continue only when it starts with
|
|
52
52
|
`Status: passed`.
|
|
53
53
|
|
|
54
54
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -63,9 +63,9 @@ Run the audit again after each accepted or authorized change.
|
|
|
63
63
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
64
64
|
|
|
65
65
|
```text
|
|
66
|
-
npx --yes copilotkit@4.10.
|
|
66
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
When the audit passes, run
|
|
70
|
-
`npx --yes copilotkit@4.10.
|
|
70
|
+
`npx --yes copilotkit@4.10.1 onboard read feature/complete` with the actual surface
|
|
71
71
|
outcome.
|
|
@@ -7,7 +7,7 @@ subagents. Work only inside the target project and preserve its existing agent a
|
|
|
7
7
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
npx --yes copilotkit@4.10.
|
|
10
|
+
npx --yes copilotkit@4.10.1 onboard protect
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -23,7 +23,7 @@ onboarding.
|
|
|
23
23
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
24
24
|
|
|
25
25
|
```text
|
|
26
|
-
npx --yes copilotkit@4.10.
|
|
26
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase research-returned
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
@@ -33,7 +33,7 @@ If the inspection did not prove the baseline this intent extends, stop here with
|
|
|
33
33
|
changing files:
|
|
34
34
|
|
|
35
35
|
```text
|
|
36
|
-
npx --yes copilotkit@4.10.
|
|
36
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
Fetch the current official guides before planning:
|
|
@@ -63,7 +63,7 @@ with one sentence explaining why. Write `None` when it needs none.
|
|
|
63
63
|
After approval, record each approved path before implementation:
|
|
64
64
|
|
|
65
65
|
```text
|
|
66
|
-
npx --yes copilotkit@4.10.
|
|
66
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
If an approved path changed after capture and no implementation step has run, add
|
|
@@ -73,7 +73,7 @@ authorize a path the approved plan did not list.
|
|
|
73
73
|
Then report the plan this run is about to implement:
|
|
74
74
|
|
|
75
75
|
```text
|
|
76
|
-
npx --yes copilotkit@4.10.
|
|
76
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase plan-written
|
|
77
77
|
```
|
|
78
78
|
|
|
79
|
-
Then run `npx --yes copilotkit@4.10.
|
|
79
|
+
Then run `npx --yes copilotkit@4.10.1 onboard read feature/learning/implement`.
|
|
@@ -16,7 +16,7 @@ validation results without secrets.
|
|
|
16
16
|
After validation and each repair, run:
|
|
17
17
|
|
|
18
18
|
```text
|
|
19
|
-
npx --yes copilotkit@4.10.
|
|
19
|
+
npx --yes copilotkit@4.10.1 onboard audit
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
Continue only when it starts with `Status: passed`. A path under `Authorized to change:` is
|
|
@@ -27,7 +27,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
27
27
|
the path, accept the developer's external change:
|
|
28
28
|
|
|
29
29
|
```text
|
|
30
|
-
npx --yes copilotkit@4.10.
|
|
30
|
+
npx --yes copilotkit@4.10.1 onboard protect --accept-external --path <path>
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
For an env file where the developer placed a requested credential, use
|
|
@@ -36,24 +36,24 @@ or its report does not settle who changed it, ask the developer to allow the unp
|
|
|
36
36
|
change. Only after they agree, record their answer:
|
|
37
37
|
|
|
38
38
|
```text
|
|
39
|
-
npx --yes copilotkit@4.10.
|
|
39
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
43
43
|
with `Status: blocked`, route out and stop:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
npx --yes copilotkit@4.10.
|
|
46
|
+
npx --yes copilotkit@4.10.1 onboard read feature/stop
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
When implementation validation passes, report it:
|
|
50
50
|
|
|
51
51
|
```text
|
|
52
|
-
npx --yes copilotkit@4.10.
|
|
52
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase build-validated
|
|
53
53
|
```
|
|
54
54
|
|
|
55
55
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
56
56
|
the feature stop route above without further changes.
|
|
57
57
|
|
|
58
58
|
Otherwise run
|
|
59
|
-
`npx --yes copilotkit@4.10.
|
|
59
|
+
`npx --yes copilotkit@4.10.1 onboard read feature/open-generative-ui/proof`.
|