copilotkit 4.9.17 → 4.9.24
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 +13 -0
- package/cli-build-info.json +7 -7
- package/index.js +1926 -1873
- package/onboarding/index.json +1 -1
- package/onboarding/prompts/authenticate/start.md +8 -8
- package/onboarding/prompts/conversion/plan.md +21 -11
- package/onboarding/prompts/credentials/finalize-plan.md +95 -34
- package/onboarding/prompts/credentials/plan.md +20 -20
- package/onboarding/prompts/fallback/best-effort.md +9 -8
- 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 +3 -3
- 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 +4 -4
- package/onboarding/prompts/proof/complete.md +29 -12
- package/onboarding/prompts/proof/oss-baseline.md +4 -4
- package/onboarding/prompts/proof/round-trip.md +9 -9
- package/onboarding/prompts/starter/clone.md +17 -8
- package/onboarding/prompts/subagent/create-plan.md +9 -3
- package/onboarding/prompts/subagent/inspect-repository.md +1 -1
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +17 -6
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +1 -1
- package/release/release-tool.js +1 -1
|
@@ -27,7 +27,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
27
27
|
URLs, and the context documentation gap.
|
|
28
28
|
|
|
29
29
|
If the pages support the selection, run
|
|
30
|
-
`npx --yes copilotkit@4.9.
|
|
30
|
+
`npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
|
|
31
31
|
|
|
32
32
|
If the documentation does not support the selection, run
|
|
33
|
-
`npx --yes copilotkit@4.9.
|
|
33
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -28,7 +28,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
28
28
|
URLs, and the context documentation gap.
|
|
29
29
|
|
|
30
30
|
If the pages support the selection, run
|
|
31
|
-
`npx --yes copilotkit@4.9.
|
|
31
|
+
`npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
|
|
32
32
|
|
|
33
33
|
If the documentation does not support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.9.
|
|
34
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -5,7 +5,7 @@ Preserve an existing Angular frontend. Use the selected page for a new frontend.
|
|
|
5
5
|
Use the starter shortcut only if all these facts are true: the target directory contains
|
|
6
6
|
no entries, its name is a valid `init` project name, and the selected framework is ADK.
|
|
7
7
|
If all three facts are true, record Angular as the selected frontend. Then run
|
|
8
|
-
`npx --yes copilotkit@4.9.
|
|
8
|
+
`npx --yes copilotkit@4.9.24 onboard read starter/clone` before you fetch documentation.
|
|
9
9
|
|
|
10
10
|
## Documentation
|
|
11
11
|
|
|
@@ -35,7 +35,7 @@ you create or build an Angular project. If the installed version is lower, selec
|
|
|
35
35
|
supported version first and use it for every later command in this project.
|
|
36
36
|
|
|
37
37
|
If the pages support the selection, record Angular and these URLs. Then run
|
|
38
|
-
`npx --yes copilotkit@4.9.
|
|
38
|
+
`npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
|
|
39
39
|
|
|
40
40
|
If the documentation does not support the selection, run
|
|
41
|
-
`npx --yes copilotkit@4.9.
|
|
41
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -15,7 +15,7 @@ These TypeScript options have starters: Claude Agent SDK TypeScript, LangGraph T
|
|
|
15
15
|
Mastra, and Strands Agents TypeScript. The .NET option is Microsoft Agent Framework .NET.
|
|
16
16
|
|
|
17
17
|
If all shortcut conditions are true, record Next.js as the selected frontend. Then run
|
|
18
|
-
`npx --yes copilotkit@4.9.
|
|
18
|
+
`npx --yes copilotkit@4.9.24 onboard read starter/clone` before you fetch documentation.
|
|
19
19
|
|
|
20
20
|
## Documentation
|
|
21
21
|
|
|
@@ -27,7 +27,7 @@ agent as the default agent, which is correct only for a project that has no agen
|
|
|
27
27
|
Do not replace the developer's existing agent with the built-in agent.
|
|
28
28
|
|
|
29
29
|
If the page supports the selection, record Next.js and this URL. Then run
|
|
30
|
-
`npx --yes copilotkit@4.9.
|
|
30
|
+
`npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
|
|
31
31
|
|
|
32
32
|
If the documentation does not support the selection, run
|
|
33
|
-
`npx --yes copilotkit@4.9.
|
|
33
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -24,11 +24,11 @@ process.
|
|
|
24
24
|
|
|
25
25
|
Use exactly one matching internal route:
|
|
26
26
|
|
|
27
|
-
1. React SPA: `npx --yes copilotkit@4.9.
|
|
28
|
-
2. Next.js: `npx --yes copilotkit@4.9.
|
|
29
|
-
3. Angular: `npx --yes copilotkit@4.9.
|
|
30
|
-
4. Vue 3: `npx --yes copilotkit@4.9.
|
|
31
|
-
5. React Native: `npx --yes copilotkit@4.9.
|
|
27
|
+
1. React SPA: `npx --yes copilotkit@4.9.24 onboard read frontend/react-spa`
|
|
28
|
+
2. Next.js: `npx --yes copilotkit@4.9.24 onboard read frontend/nextjs`
|
|
29
|
+
3. Angular: `npx --yes copilotkit@4.9.24 onboard read frontend/angular`
|
|
30
|
+
4. Vue 3: `npx --yes copilotkit@4.9.24 onboard read frontend/vue`
|
|
31
|
+
5. React Native: `npx --yes copilotkit@4.9.24 onboard read frontend/react-native`
|
|
32
32
|
|
|
33
33
|
If no listed frontend fits, run
|
|
34
|
-
`npx --yes copilotkit@4.9.
|
|
34
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -15,7 +15,7 @@ documents `useRenderTool`, which is React Native's own hook for drawing a tool t
|
|
|
15
15
|
already has. That is a different job and needs a tool in the agent.
|
|
16
16
|
|
|
17
17
|
If the pages support the selection, record React Native and these URLs. Then run
|
|
18
|
-
`npx --yes copilotkit@4.9.
|
|
18
|
+
`npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
|
|
19
19
|
|
|
20
20
|
If the documentation does not support the selection, run
|
|
21
|
-
`npx --yes copilotkit@4.9.
|
|
21
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -11,7 +11,7 @@ not move the agent into it.
|
|
|
11
11
|
- https://docs.copilotkit.ai/react-spa.md
|
|
12
12
|
|
|
13
13
|
If the page supports the selection, record React SPA and this URL. Then run
|
|
14
|
-
`npx --yes copilotkit@4.9.
|
|
14
|
+
`npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
|
|
15
15
|
|
|
16
16
|
If the documentation does not support the selection, run
|
|
17
|
-
`npx --yes copilotkit@4.9.
|
|
17
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -16,7 +16,7 @@ page above. Vue has its own `useComponent`, which is not the React package. Take
|
|
|
16
16
|
that reference page rather than from a Vue generative-UI guide, which is not published.
|
|
17
17
|
|
|
18
18
|
If the pages support the selection, record Vue 3 and these URLs. Then run
|
|
19
|
-
`npx --yes copilotkit@4.9.
|
|
19
|
+
`npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
|
|
20
20
|
|
|
21
21
|
If the documentation does not support the selection, run
|
|
22
|
-
`npx --yes copilotkit@4.9.
|
|
22
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -7,7 +7,7 @@ Do not implement the plan yourself. Use the step order in the approved plan.
|
|
|
7
7
|
Run the audit from the target app directory:
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
npx --yes copilotkit@4.9.
|
|
10
|
+
npx --yes copilotkit@4.9.24 onboard audit
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
It compares every protected path with the digest the CLI captured for it. Its result starts
|
|
@@ -25,7 +25,7 @@ protected path as changed. Report the printed reason and use the route-out rules
|
|
|
25
25
|
A non-pass audit never continues the run. Do not send an audit result to a repair worker.
|
|
26
26
|
|
|
27
27
|
Spawn one implementation subagent. Tell it to run
|
|
28
|
-
`npx --yes copilotkit@4.9.
|
|
28
|
+
`npx --yes copilotkit@4.9.24 onboard read subagent/implement-and-validate` first and follow
|
|
29
29
|
the prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
30
30
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
31
31
|
and the same handoff. Give it the plan, selected framework, frontend, model, exact target app
|
|
@@ -42,7 +42,7 @@ Run the protected-path audit after the implementation subagent passes. If any pr
|
|
|
42
42
|
changed, use the route-out rules. Continue to proof only when that audit passes.
|
|
43
43
|
|
|
44
44
|
After the selected implementation path passes, run
|
|
45
|
-
`npx --yes copilotkit@4.9.
|
|
45
|
+
`npx --yes copilotkit@4.9.24 onboard read proof/round-trip`.
|
|
46
46
|
|
|
47
47
|
## Repair rules
|
|
48
48
|
|
|
@@ -60,4 +60,4 @@ Route out for `Status: blocked`. Route out only when the failure is not yours to
|
|
|
60
60
|
failure is in code this run did not write, the fix requires changing the developer's existing
|
|
61
61
|
agent or frontend, the same command still fails after three repair attempts, or the
|
|
62
62
|
documentation does not support the plan. In those cases run
|
|
63
|
-
`npx --yes copilotkit@4.9.
|
|
63
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -37,17 +37,30 @@ The handoff must include:
|
|
|
37
37
|
- The URL of the running app.
|
|
38
38
|
- The command that starts the app in the future.
|
|
39
39
|
- The debugging surface this journey's frontend can reach, named below.
|
|
40
|
-
- How to use https://intelligence.copilotkit.ai to manage the Intelligence
|
|
40
|
+
- How to use https://intelligence.copilotkit.ai to manage the Intelligence
|
|
41
|
+
installation. Do not open it. This item makes the developer aware the dashboard is
|
|
42
|
+
there, and it is a sentence to write rather than a check to perform. Nothing in this
|
|
43
|
+
graph gates on the dashboard, so a dashboard this run never opened is not a finding,
|
|
44
|
+
not a caveat, and not a blocker.
|
|
41
45
|
- The process IDs and stop commands for the running agent and frontend.
|
|
42
46
|
- The `@copilotkit/*` versions this conversion changed, and what they were before.
|
|
43
47
|
- On a conversion, the criterion this run was judged against, in the words the run was
|
|
44
48
|
given.
|
|
49
|
+
- Any path this run created that git does not ignore, and what to do with each.
|
|
50
|
+
|
|
51
|
+
A run leaves paths beside the credential file. Tool output such as `.playwright-mcp/` and
|
|
52
|
+
`.langgraph_api/` is regenerable, so the developer normally wants it ignored.
|
|
53
|
+
`.copilotkit/` is not debris: `project.json` and `channels.json` are the project's own
|
|
54
|
+
declared state and belong in the commit, while `.copilotkit/artifacts/` holds regenerable
|
|
55
|
+
manifests and does not. Name each path and say which of the two it is. Do not add an
|
|
56
|
+
ignore line for any of them yourself. None of these carries a secret, unlike the
|
|
57
|
+
credential path, so the developer decides.
|
|
45
58
|
|
|
46
59
|
Name the debugging surface this journey's frontend can reach, rather than the one the rest
|
|
47
60
|
of the documentation leads with. For a web frontend it is the CopilotKit Inspector. For
|
|
48
61
|
React Native there is no Inspector: it is a browser overlay built on a DOM custom element,
|
|
49
62
|
and `@copilotkit/react-native` does not ship it. Give a mobile developer
|
|
50
|
-
`npx --yes copilotkit@4.9.
|
|
63
|
+
`npx --yes copilotkit@4.9.24 verify --round-trip`, the runtime's own log, the AG-UI
|
|
51
64
|
Event Inspector in the CopilotKit VS Code extension, and the Intelligence thread view
|
|
52
65
|
instead. Naming the Inspector to a developer who cannot open it costs them the time it
|
|
53
66
|
takes to conclude their own wiring is broken.
|
|
@@ -59,7 +72,7 @@ the friction commands without another developer question. The CLI telemetry gate
|
|
|
59
72
|
whether the report is sent.
|
|
60
73
|
|
|
61
74
|
```text
|
|
62
|
-
npx --yes copilotkit@4.9.
|
|
75
|
+
npx --yes copilotkit@4.9.24 onboard friction --category <slug> --cost-seconds <seconds>
|
|
63
76
|
```
|
|
64
77
|
|
|
65
78
|
Write one or two sentences on the command's standard input. Pick one category from
|
|
@@ -76,14 +89,14 @@ Tell the developer when you send a friction report. Do not quote or summarize th
|
|
|
76
89
|
unless the developer asks. If the CLI says that telemetry is disabled or unavailable,
|
|
77
90
|
state that the report was not sent and continue without another question.
|
|
78
91
|
|
|
79
|
-
When the evidence is gathered, run `npx --yes copilotkit@4.9.
|
|
92
|
+
When the evidence is gathered, run `npx --yes copilotkit@4.9.24 onboard complete`, carrying
|
|
80
93
|
the surface-check outcome the proof subagent returned. Pass exactly one flag, and pass the
|
|
81
94
|
one that matches this journey's surface.
|
|
82
95
|
|
|
83
96
|
For a web frontend -- React SPA, Next.js, Angular, Vue:
|
|
84
97
|
|
|
85
98
|
```text
|
|
86
|
-
npx --yes copilotkit@4.9.
|
|
99
|
+
npx --yes copilotkit@4.9.24 onboard complete --visual-check <outcome>
|
|
87
100
|
```
|
|
88
101
|
|
|
89
102
|
The outcome is one of `performed`, `skipped-no-browser-tool`, or `failed`.
|
|
@@ -91,7 +104,7 @@ The outcome is one of `performed`, `skipped-no-browser-tool`, or `failed`.
|
|
|
91
104
|
For React Native:
|
|
92
105
|
|
|
93
106
|
```text
|
|
94
|
-
npx --yes copilotkit@4.9.
|
|
107
|
+
npx --yes copilotkit@4.9.24 onboard complete --device-check <outcome>
|
|
95
108
|
```
|
|
96
109
|
|
|
97
110
|
The outcome is one of `performed`, `skipped-no-device`, or `failed`.
|
|
@@ -109,14 +122,18 @@ If the round trip proved and something after it still blocked this run, add `--b
|
|
|
109
122
|
to the same command:
|
|
110
123
|
|
|
111
124
|
```text
|
|
112
|
-
npx --yes copilotkit@4.9.
|
|
125
|
+
npx --yes copilotkit@4.9.24 onboard complete --visual-check performed --blocked-by <cause>
|
|
113
126
|
```
|
|
114
127
|
|
|
115
|
-
The cause is one of `
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
128
|
+
The cause is one of `inspector` for a debugging surface that did not open,
|
|
129
|
+
`plan-excluded-capability` for a capability the approved plan had already excluded for this
|
|
130
|
+
framework, and `other` for anything else. Pick `other` rather than leaving the flag off.
|
|
131
|
+
The command ends the run as blocked and prints what the blocker leaves unverified.
|
|
132
|
+
|
|
133
|
+
The managed Intelligence dashboard is not among these, because nothing in this graph asks a
|
|
134
|
+
run to open it. A run that records a blocker for a surface it was never sent to looks worse
|
|
135
|
+
than an identical run that wrote the same handoff sentence, and the two are then not
|
|
136
|
+
comparable.
|
|
120
137
|
|
|
121
138
|
This is the flag for a journey that worked. It is not a way to report an unsupported path,
|
|
122
139
|
and a blocked run here is still owed the full handoff above: the URL, the start command,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Prove the existing OSS baseline
|
|
2
2
|
|
|
3
3
|
Do not prove the baseline yourself. Spawn one proof subagent. Tell it to run
|
|
4
|
-
`npx --yes copilotkit@4.9.
|
|
4
|
+
`npx --yes copilotkit@4.9.24 onboard read subagent/prove-oss-baseline` first and follow the
|
|
5
5
|
prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
6
6
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
7
7
|
and the same handoff. Give it the repository findings and exact CLI package spec. Wait for the
|
|
@@ -11,14 +11,14 @@ Do not change project files before this proof ends. Starting existing developmen
|
|
|
11
11
|
processes and their ignored runtime files is allowed.
|
|
12
12
|
|
|
13
13
|
If the subagent proves the `both-oss` predicate, keep its evidence with the plan and run
|
|
14
|
-
`npx --yes copilotkit@4.9.
|
|
14
|
+
`npx --yes copilotkit@4.9.24 onboard read conversion/plan`. That project already works.
|
|
15
15
|
What it needs is the conversion, not a build.
|
|
16
16
|
|
|
17
17
|
If it proves another supported starting state, record that state and run
|
|
18
|
-
`npx --yes copilotkit@4.9.
|
|
18
|
+
`npx --yes copilotkit@4.9.24 onboard read credentials/plan`. This prompt is served
|
|
19
19
|
whenever a project looks like an OSS integration, so a baseline that did not prove is an
|
|
20
20
|
ordinary starting state rather than a failure.
|
|
21
21
|
|
|
22
22
|
If it cannot identify the running process safely, exposes a secret, or finds a baseline
|
|
23
23
|
failure that cannot be classified, run
|
|
24
|
-
`npx --yes copilotkit@4.9.
|
|
24
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Prove the user journey
|
|
2
2
|
|
|
3
3
|
Do not do the proof work yourself. Spawn one proof subagent. Tell it to run
|
|
4
|
-
`npx --yes copilotkit@4.9.
|
|
4
|
+
`npx --yes copilotkit@4.9.24 onboard read subagent/prove-round-trip` first and follow the
|
|
5
5
|
prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
6
6
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
7
7
|
and the same handoff. Give it the selected framework, frontend, model, approved plan, selected
|
|
@@ -20,7 +20,7 @@ https://docs.copilotkit.ai/build-with-agents.md
|
|
|
20
20
|
Wait for the subagent to finish.
|
|
21
21
|
|
|
22
22
|
For every protected-path audit in this prompt, run
|
|
23
|
-
`npx --yes copilotkit@4.9.
|
|
23
|
+
`npx --yes copilotkit@4.9.24 onboard audit` from the target app directory. If its result
|
|
24
24
|
starts with `Status: blocked`, report the printed reason and use the route-out rules below.
|
|
25
25
|
A blocked audit proved nothing changed and is not a preservation failure. If a
|
|
26
26
|
protected-path audit reports a changed path, use the route-out rules below. Never repair,
|
|
@@ -28,16 +28,16 @@ reset, or revert a protected path.
|
|
|
28
28
|
|
|
29
29
|
If the proof result starts with `Status: passed`, run the protected-path audit. Continue to
|
|
30
30
|
`proof/complete` only if that audit passes. After the audit passes, run
|
|
31
|
-
`npx --yes copilotkit@4.9.
|
|
31
|
+
`npx --yes copilotkit@4.9.24 onboard read proof/complete`. A performed surface outcome with
|
|
32
32
|
the full round trip is core success even if a continued-development tool fails. A skipped
|
|
33
33
|
surface outcome still enters `proof/complete` so the CLI records the blocked result. Do not
|
|
34
34
|
describe a skipped surface as proved. Keep the Skills and MCP results separate from the proof
|
|
35
35
|
result.
|
|
36
36
|
|
|
37
|
-
If the round trip proves and something after it blocks this run anyway -- the
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
37
|
+
If the round trip proves and something after it blocks this run anyway -- the debugging
|
|
38
|
+
surface, or a capability the approved plan already excluded for this framework -- read
|
|
39
|
+
`proof/complete` all the same, with the command above, and carry the blocker there with
|
|
40
|
+
`--blocked-by`.
|
|
41
41
|
The stop terminal is for a journey this release cannot carry. It is
|
|
42
42
|
not for a journey that worked and then hit a wall: routing a proved run there tells the
|
|
43
43
|
developer that a framework and frontend that just worked are unsupported, and hands them a
|
|
@@ -95,7 +95,7 @@ and proof cycles.
|
|
|
95
95
|
|
|
96
96
|
Route out only when the failure is not yours to fix, when the same proof still fails after
|
|
97
97
|
three attempts, or when no evidence of the round trip can be produced. In those cases run
|
|
98
|
-
`npx --yes copilotkit@4.9.
|
|
98
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`. All three are
|
|
99
99
|
about the round trip itself. A round trip that proved is not one of them, whatever failed
|
|
100
100
|
after it.
|
|
101
101
|
|
|
@@ -105,7 +105,7 @@ Run the feedback command without another developer question. The CLI telemetry g
|
|
|
105
105
|
whether the report is sent.
|
|
106
106
|
|
|
107
107
|
```text
|
|
108
|
-
npx --yes copilotkit@4.9.
|
|
108
|
+
npx --yes copilotkit@4.9.24 onboard feedback
|
|
109
109
|
```
|
|
110
110
|
|
|
111
111
|
Write at most four lines to standard input: the step you stopped at and what stopped it.
|
|
@@ -34,11 +34,18 @@ selected pair is not in the table, or the directory name is not valid, stop the
|
|
|
34
34
|
Do not run `init`. Treat this result as a failed shortcut and follow the final failure
|
|
35
35
|
instruction in this prompt.
|
|
36
36
|
|
|
37
|
-
If the developer did not name an Intelligence project,
|
|
37
|
+
If the developer did not name an Intelligence project, create one for the app being
|
|
38
|
+
cloned. This directory is new, so no existing project is already its own: take the project
|
|
39
|
+
name from the target directory name derived above, and ask the developer to confirm it or
|
|
40
|
+
give another. Do not list the projects in the organization. If no developer answers, use
|
|
41
|
+
the derived name.
|
|
38
42
|
|
|
39
|
-
|
|
43
|
+
Only if the developer asks for an existing project, or asks to see the projects they have,
|
|
44
|
+
read the choices:
|
|
40
45
|
|
|
41
|
-
|
|
46
|
+
`npx --yes copilotkit@4.9.24 project list --json`
|
|
47
|
+
|
|
48
|
+
Then ask which one to use. Do not order the projects by creation time. If the developer
|
|
42
49
|
already gave this answer, do not ask again. Do not read a secret value. Do not show or
|
|
43
50
|
store a secret value.
|
|
44
51
|
|
|
@@ -46,10 +53,12 @@ Run the command from the parent directory. Do not inspect another entry in the p
|
|
|
46
53
|
directory. Replace each placeholder with the recorded value. Do not run a placeholder as
|
|
47
54
|
a shell argument.
|
|
48
55
|
|
|
49
|
-
`npx --yes copilotkit@4.9.
|
|
56
|
+
`npx --yes copilotkit@4.9.24 init --name <project-name> --framework <framework-id> --channel none --no-banner --create <name> --install`
|
|
50
57
|
|
|
51
|
-
|
|
52
|
-
|
|
58
|
+
Pass the confirmed name to both `--name` and `--create`: the app directory and its
|
|
59
|
+
Intelligence project take the same name here. If the developer names an existing project,
|
|
60
|
+
use `--project <slug-or-id>` instead of `--create <name>`. If the developer asked to skip
|
|
61
|
+
the dependency install, use
|
|
53
62
|
`--no-install` instead of `--install`. Do not wait for an interactive prompt. Pass every
|
|
54
63
|
answer as a flag.
|
|
55
64
|
|
|
@@ -60,8 +69,8 @@ account. The command does not need terminal input.
|
|
|
60
69
|
If the command succeeds, do not rebuild the starter by hand. Inspect only the generated
|
|
61
70
|
paths inside the target directory. Record the files, install result, project connection,
|
|
62
71
|
and validation commands. Then run
|
|
63
|
-
`npx --yes copilotkit@4.9.
|
|
72
|
+
`npx --yes copilotkit@4.9.24 onboard read proof/round-trip`.
|
|
64
73
|
|
|
65
74
|
If the command fails, report its exact error and do not claim that the starter is ready.
|
|
66
75
|
Then run
|
|
67
|
-
`npx --yes copilotkit@4.9.
|
|
76
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -35,13 +35,18 @@ reference naming hosts that route nothing, and it requires the platform URLs the
|
|
|
35
35
|
documentation calls optional. A run that reads that reference configures the runtime
|
|
36
36
|
against a dead host, and the failure arrives as an empty-body 404 with no cause named.
|
|
37
37
|
|
|
38
|
-
If any `@copilotkit/*` dependency is below 1.
|
|
38
|
+
If any `@copilotkit/*` dependency is below 1.70.0, plan to upgrade every `@copilotkit/*`
|
|
39
39
|
dependency to its latest published version. Packages that share a version line must end
|
|
40
40
|
on the same version. Never force a package onto a version line it does not publish on.
|
|
41
41
|
Resolve each latest version at run time rather than from a remembered version number.
|
|
42
42
|
Where every `@copilotkit/*` dependency already meets that floor, plan no dependency
|
|
43
43
|
change.
|
|
44
44
|
|
|
45
|
+
The floor is 1.70.0 because the runtime resolves managed Intelligence entitlement
|
|
46
|
+
authority from that version. A runtime below it reports its license from a self-hosted
|
|
47
|
+
token alone. A managed project holds no such token, so the threads drawer this conversion
|
|
48
|
+
adds lists nothing even after every command-line check passes.
|
|
49
|
+
|
|
45
50
|
Plan the upgrade as its own step before the Intelligence runtime wiring, and plan to
|
|
46
51
|
re-run the recorded baseline checks immediately after it. Name the revert: restore the
|
|
47
52
|
manifest and lockfile to their recorded state and stop, rather than wiring Intelligence
|
|
@@ -94,8 +99,9 @@ here is work the developer did not ask for.
|
|
|
94
99
|
|
|
95
100
|
Plan the threads drawer itself: add it from the selected drawer page, where this frontend
|
|
96
101
|
does not already render one. Where this journey's frontend framework ships no threads
|
|
97
|
-
drawer -- React Native --, plan that the thread is proved
|
|
98
|
-
|
|
102
|
+
drawer -- React Native --, plan that the thread is proved by
|
|
103
|
+
`npx --yes copilotkit@4.9.24 verify --round-trip`, which needs no browser. Do not plan a
|
|
104
|
+
step that opens the managed Intelligence dashboard.
|
|
99
105
|
|
|
100
106
|
## Order the plan into steps
|
|
101
107
|
|
|
@@ -38,7 +38,7 @@ from different directories.
|
|
|
38
38
|
|
|
39
39
|
For the CopilotKit versions, report the exact installed version of every `@copilotkit/*`
|
|
40
40
|
dependency, read from the lockfile rather than a manifest range, and state whether any of
|
|
41
|
-
them is below 1.
|
|
41
|
+
them is below 1.70.0. The conversion decides its upgrade from exactly that, and a caret
|
|
42
42
|
range does not answer it.
|
|
43
43
|
|
|
44
44
|
A project states what it is for in its `README.md`, in its package description, or in
|
|
@@ -16,7 +16,7 @@ Prove the live runtime in this order:
|
|
|
16
16
|
4. Confirm from project files that the runtime constructor passes a `runner` option rather
|
|
17
17
|
than an `intelligence` option. A package, import, project file, or key is not use proof.
|
|
18
18
|
5. Run
|
|
19
|
-
`npx --yes copilotkit@4.9.
|
|
19
|
+
`npx --yes copilotkit@4.9.24 verify --expect-runtime oss --round-trip --agent <expected-agent-id> --json`,
|
|
20
20
|
with the runtime URL or auth header options that this project needs. Require exit zero
|
|
21
21
|
and the JSON `ok` field to be `true`.
|
|
22
22
|
6. Drive one real request through the existing frontend, CopilotKit runtime, and expected
|
|
@@ -90,8 +90,8 @@ A server that never answered has written the reason to its own output, and readi
|
|
|
90
90
|
output is faster than starting it again.
|
|
91
91
|
|
|
92
92
|
Leave the agent and frontend servers running after proof. Record each process ID and a
|
|
93
|
-
safe command that stops that process. Record the frontend URL
|
|
94
|
-
both servers again.
|
|
93
|
+
safe command that stops that process. Record the frontend URL, written with `localhost`
|
|
94
|
+
rather than an IP literal, and the commands that start both servers again.
|
|
95
95
|
|
|
96
96
|
## Step 3 -- Identify the process that answered
|
|
97
97
|
|
|
@@ -120,7 +120,7 @@ IPv6 only, so an IPv4 literal fails against the correct port.
|
|
|
120
120
|
## Step 4 -- Check the wiring
|
|
121
121
|
|
|
122
122
|
With both running, check the wiring in one command before you open a browser:
|
|
123
|
-
`npx --yes copilotkit@4.9.
|
|
123
|
+
`npx --yes copilotkit@4.9.24 verify --json`. Add `--runtime-url` when the runtime is not at
|
|
124
124
|
`http://localhost:3000/api/copilotkit`. Read the individual checks rather than the summary
|
|
125
125
|
alone: a check reported `undetermined` did not run, and that is not a pass. Repair a failed
|
|
126
126
|
check only within the limits above. Otherwise, return the check and its evidence before the
|
|
@@ -136,7 +136,7 @@ thread-endpoint state exists, the runtime predates the field. Record that and co
|
|
|
136
136
|
|
|
137
137
|
## Step 5 -- Prove that the agent runs
|
|
138
138
|
|
|
139
|
-
Run `npx --yes copilotkit@4.9.
|
|
139
|
+
Run `npx --yes copilotkit@4.9.24 verify --round-trip --json`. It sends one request through
|
|
140
140
|
the runtime and reads the answer back from the thread, so it separates an agent that is
|
|
141
141
|
configured from an agent that works. Use `--agent <id>` when the runtime declares more
|
|
142
142
|
than one. If it reports `user-not-identified`, this project's `identifyUser` reads a
|
|
@@ -212,8 +212,9 @@ journey, and the graph ends such a run as blocked rather than complete.
|
|
|
212
212
|
For a recorded `both-oss` starting state, this step has no component to render. Send the
|
|
213
213
|
same request the baseline recorded, require the same kind of user-visible result the
|
|
214
214
|
baseline produced, and require that the thread for that request is listed in the drawer.
|
|
215
|
-
Where this journey's frontend framework ships no threads drawer -- React Native --,
|
|
216
|
-
that thread
|
|
215
|
+
Where this journey's frontend framework ships no threads drawer -- React Native --, prove
|
|
216
|
+
that thread with `npx --yes copilotkit@4.9.24 verify --round-trip`, which reads the
|
|
217
|
+
answer back off the thread and needs no browser. Record which of the two you proved.
|
|
217
218
|
|
|
218
219
|
Use the surface control the main coding agent recorded for your environment. It either had
|
|
219
220
|
one already or registered one before this step, so that finding is the answer and there is
|
|
@@ -237,6 +238,10 @@ The surface is a browser, and it also covers browser-origin CORS and CSP, which
|
|
|
237
238
|
request never exercises. Drive it with the browser control step 6 named.
|
|
238
239
|
|
|
239
240
|
1. Open the frontend URL from step 2 and wait for the page to finish loading.
|
|
241
|
+
Address it as `localhost` rather than an IP literal, for the reason step 3 gives
|
|
242
|
+
for the agent. A dev server reached on the IP literal can refuse its own static
|
|
243
|
+
assets, and a page that loads without them leaves the chat control dead. That
|
|
244
|
+
reads as a broken integration rather than as the host name you used.
|
|
240
245
|
2. Take one page snapshot. Record whether the CopilotKit surface is on the page. A page
|
|
241
246
|
that renders without it is a wiring failure rather than a proof to retry.
|
|
242
247
|
3. Read the browser console before you type anything, and record every error already
|
|
@@ -317,6 +322,12 @@ result. The runtime must now report `licenseStatus`, and the authenticated Intel
|
|
|
317
322
|
checks must pass. A thread for that request must be persisted and visible. Record both
|
|
318
323
|
before and after evidence, and record that the criterion was `conversion-v1`.
|
|
319
324
|
|
|
325
|
+
`licenseStatus` reports `unknown` while the runtime entitlement lookup for this project
|
|
326
|
+
has not resolved yet. That value is transient rather than a failure, and the drawer
|
|
327
|
+
renders its locked view for as long as it stands. Re-read `/info` and re-open the drawer
|
|
328
|
+
before you judge either one. Criterion 4 requires `licenseStatus` to be present, and a
|
|
329
|
+
present `unknown` meets it.
|
|
330
|
+
|
|
320
331
|
For every other starting state, record Step 8 as not applicable.
|
|
321
332
|
|
|
322
333
|
The application edit ban ends only after Step 8 passes or is recorded as not applicable.
|
|
@@ -26,13 +26,13 @@ Before you show the best-effort plan, require this complete packet:
|
|
|
26
26
|
- Give the ordered proof rules.
|
|
27
27
|
|
|
28
28
|
After the developer approves the best-effort plan, run
|
|
29
|
-
`npx --yes copilotkit@4.9.
|
|
29
|
+
`npx --yes copilotkit@4.9.24 onboard read fallback/best-effort`.
|
|
30
30
|
|
|
31
31
|
Send one short report. Run the feedback command without another developer question. The
|
|
32
32
|
CLI telemetry gate decides whether the report is sent.
|
|
33
33
|
|
|
34
34
|
```text
|
|
35
|
-
npx --yes copilotkit@4.9.
|
|
35
|
+
npx --yes copilotkit@4.9.24 onboard feedback
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
Write the feedback message to the command's standard input, in at most four lines.
|
package/package.json
CHANGED
package/release/release-tool.js
CHANGED
|
@@ -14698,7 +14698,7 @@ import * as path4 from "node:path";
|
|
|
14698
14698
|
|
|
14699
14699
|
// apps/cli/src/config.ts
|
|
14700
14700
|
function getTemplateRef() {
|
|
14701
|
-
return true ? "
|
|
14701
|
+
return true ? "2d44d3ff00910e9f3494d5e57aaa7bdd69a82e04" : "main";
|
|
14702
14702
|
}
|
|
14703
14703
|
|
|
14704
14704
|
// apps/cli/src/services/agentcore-config.ts
|