copilotkit 4.12.0 → 4.13.0
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 -0
- package/cli-build-info.json +8 -8
- package/index.js +1015 -123
- package/onboarding/index.json +20 -2
- package/onboarding/prompts/authenticate/start.md +38 -33
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +7 -7
- package/onboarding/prompts/credentials/plan.md +26 -20
- package/onboarding/prompts/credentials/settle-credentials.md +8 -8
- package/onboarding/prompts/credentials/write-plan.md +19 -6
- 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 +67 -12
- package/onboarding/prompts/feature/channels/proof.md +13 -6
- package/onboarding/prompts/feature/channels/start.md +27 -10
- 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 +15 -15
- package/onboarding/prompts/feature/learning/proof.md +7 -7
- package/onboarding/prompts/feature/learning/start.md +8 -8
- 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 +2 -2
- 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 +4 -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 +5 -2
- package/onboarding/prompts/framework/google-adk.md +4 -2
- package/onboarding/prompts/framework/langgraph-fastapi.md +4 -3
- package/onboarding/prompts/framework/langgraph-python.md +6 -2
- package/onboarding/prompts/framework/langgraph-typescript.md +6 -2
- package/onboarding/prompts/framework/llamaindex.md +2 -2
- package/onboarding/prompts/framework/mastra.md +4 -2
- package/onboarding/prompts/framework/ms-agent-dotnet.md +4 -2
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
- package/onboarding/prompts/framework/ms-agent-python.md +4 -2
- package/onboarding/prompts/framework/pydantic-ai.md +2 -2
- package/onboarding/prompts/framework/strands-python.md +4 -2
- package/onboarding/prompts/framework/strands-typescript.md +4 -2
- package/onboarding/prompts/frontend/angular.md +3 -3
- package/onboarding/prompts/frontend/nextjs.md +3 -3
- package/onboarding/prompts/frontend/plan.md +21 -10
- 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 +33 -15
- package/onboarding/prompts/proof/complete.md +35 -16
- package/onboarding/prompts/proof/oss-baseline.md +5 -5
- package/onboarding/prompts/proof/round-trip.md +23 -12
- package/onboarding/prompts/research/gather.md +12 -102
- package/onboarding/prompts/research/merge.md +60 -0
- package/onboarding/prompts/research/preflight.md +75 -0
- package/onboarding/prompts/research/route.md +28 -4
- package/onboarding/prompts/starter/clone.md +5 -5
- package/onboarding/prompts/stopped/run-failed.md +2 -2
- package/onboarding/prompts/subagent/create-plan.md +18 -1
- package/onboarding/prompts/subagent/implement-and-validate.md +30 -0
- 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 -7
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +4 -1
- package/release/release-tool.js +1 -1
|
@@ -19,7 +19,7 @@ Prove the live runtime in this order:
|
|
|
19
19
|
4. Confirm from project files that the runtime constructor passes a `runner` option rather
|
|
20
20
|
than an `intelligence` option. A package, import, project file, or key is not use proof.
|
|
21
21
|
5. Run
|
|
22
|
-
`npx --yes copilotkit@4.
|
|
22
|
+
`npx --yes copilotkit@4.13.0 verify --expect-runtime oss --round-trip --agent <expected-agent-id> --json`,
|
|
23
23
|
with the runtime URL or auth header options that this project needs. Require exit zero
|
|
24
24
|
and the JSON `ok` field to be `true`.
|
|
25
25
|
6. Drive one real request through the existing frontend, CopilotKit runtime, and expected
|
|
@@ -9,6 +9,16 @@ You can make only operational repairs to project-owned processes, ports, and req
|
|
|
9
9
|
Do not write a path that overlaps a protected path. If a required proof or tool path
|
|
10
10
|
overlaps one, return `Status: blocked` before writing it.
|
|
11
11
|
|
|
12
|
+
The existing agent's behavior is outside every step of this proof. It is four things: the
|
|
13
|
+
agent's system prompt and instructions, its tools and what those tools do, its model and
|
|
14
|
+
provider configuration, and its memory or state handling. A failing predicate is repaired
|
|
15
|
+
on the CopilotKit side -- the frontend rendering, the tool schema, the runtime wiring.
|
|
16
|
+
Where the only fix you can find is a change to the agent's instructions or tools, stop and
|
|
17
|
+
return the failing predicate with the change you propose, for the developer to approve.
|
|
18
|
+
Such a change is a behavior change rather than a repair: it changes how the agent answers
|
|
19
|
+
everywhere, not only in CopilotKit. Never rewrite the agent's prompt to make a component
|
|
20
|
+
render, and never report a round trip proved by a prompt this run rewrote.
|
|
21
|
+
|
|
12
22
|
Run the steps below in the order they appear. They are the proof. Do not design a
|
|
13
23
|
different sequence of your own, and do not drop a step because an earlier one looked
|
|
14
24
|
convincing. Step 6 has a web form and a React Native form: run the one that matches this
|
|
@@ -135,7 +145,7 @@ IPv6 only, so an IPv4 literal fails against the correct port.
|
|
|
135
145
|
## Step 4 -- Check the wiring
|
|
136
146
|
|
|
137
147
|
With both running, check the wiring in one command before you open a browser:
|
|
138
|
-
`npx --yes copilotkit@4.
|
|
148
|
+
`npx --yes copilotkit@4.13.0 verify --json`. It reads the port from this project, so a
|
|
139
149
|
non-default port needs no flag. The payload reports `runtimeUrl` and `runtimeUrlSource`. A
|
|
140
150
|
`runtimeUrlSource` of `default` means nothing in the project named a port, so pass
|
|
141
151
|
`--runtime-url` with the URL from step 1 in that case. Read the individual checks rather than
|
|
@@ -169,7 +179,7 @@ named no port the CLI can read: keep step 2's URL, and rewrite its host as `loca
|
|
|
169
179
|
before you use it.
|
|
170
180
|
|
|
171
181
|
Then run the command once more with the URL you are about to open:
|
|
172
|
-
`npx --yes copilotkit@4.
|
|
182
|
+
`npx --yes copilotkit@4.13.0 verify --frontend-url <that url> --json`. The
|
|
173
183
|
`frontend_assets_served` check asks that server for its page and for one of the page's own
|
|
174
184
|
assets, on that exact host. A `fail` there means the dev server refuses its own static
|
|
175
185
|
assets on the host you were about to use, and the check names the URL to use instead. This
|
|
@@ -177,7 +187,7 @@ is the cheapest step that can save the most expensive one, so run it before the
|
|
|
177
187
|
|
|
178
188
|
## Step 5 -- Prove that the agent runs
|
|
179
189
|
|
|
180
|
-
Run `npx --yes copilotkit@4.
|
|
190
|
+
Run `npx --yes copilotkit@4.13.0 verify --round-trip --json`. It sends one request through
|
|
181
191
|
the runtime and reads the answer back from the thread, so it separates an agent that is
|
|
182
192
|
configured from an agent that works. Use `--agent <id>` when the runtime declares more
|
|
183
193
|
than one. If it reports `user-not-identified`, this project's `identifyUser` reads a
|
|
@@ -190,7 +200,7 @@ Where this run settled a Learning Container, add the flag to the call above rath
|
|
|
190
200
|
running a second round trip:
|
|
191
201
|
|
|
192
202
|
```text
|
|
193
|
-
npx --yes copilotkit@4.
|
|
203
|
+
npx --yes copilotkit@4.13.0 verify --round-trip --expect-learning-container <container id> --json
|
|
194
204
|
```
|
|
195
205
|
|
|
196
206
|
The check reads the thread that this run created, so a second round trip proves a second
|
|
@@ -224,7 +234,7 @@ the credential was written holds an empty key while the file beside it carries t
|
|
|
224
234
|
one. Run this from the target app directory:
|
|
225
235
|
|
|
226
236
|
```text
|
|
227
|
-
npx --yes copilotkit@4.
|
|
237
|
+
npx --yes copilotkit@4.13.0 onboard env-staleness
|
|
228
238
|
```
|
|
229
239
|
|
|
230
240
|
A `stale` line names the env file and how long after launch it was written. Report that,
|
|
@@ -302,7 +312,7 @@ For a recorded `both-oss` starting state, this step has no component to render.
|
|
|
302
312
|
same request the baseline recorded, require the same kind of user-visible result the
|
|
303
313
|
baseline produced, and require that the thread for that request is listed in the drawer.
|
|
304
314
|
Where this journey's frontend framework ships no threads drawer -- React Native --, prove
|
|
305
|
-
that thread with `npx --yes copilotkit@4.
|
|
315
|
+
that thread with `npx --yes copilotkit@4.13.0 verify --round-trip`, which reads the
|
|
306
316
|
answer back off the thread and needs no browser. Record which of the two you proved.
|
|
307
317
|
|
|
308
318
|
Use the surface control the main coding agent recorded for your environment. It either had
|
|
@@ -330,7 +340,7 @@ request never exercises. Drive it with the browser control step 6 named.
|
|
|
330
340
|
the page to finish loading. Do not retype the host, and do not substitute a URL a tool
|
|
331
341
|
offers you by default. Where the page loads but its styling is missing or the chat
|
|
332
342
|
control is dead, run
|
|
333
|
-
`npx --yes copilotkit@4.
|
|
343
|
+
`npx --yes copilotkit@4.13.0 verify --frontend-url <the url you opened> --json`
|
|
334
344
|
before you diagnose anything else. A dev server can serve its page and refuse every
|
|
335
345
|
static chunk behind it, and on screen that is indistinguishable from a broken
|
|
336
346
|
integration. The `frontend_assets_served` check tells the two apart.
|
|
@@ -30,13 +30,13 @@ Before you show the best-effort plan, require this complete packet:
|
|
|
30
30
|
- Give the ordered proof rules.
|
|
31
31
|
|
|
32
32
|
After the developer approves the best-effort plan, run
|
|
33
|
-
`npx --yes copilotkit@4.
|
|
33
|
+
`npx --yes copilotkit@4.13.0 onboard read fallback/best-effort`.
|
|
34
34
|
|
|
35
35
|
Send one short report. Run the friction command without another developer question. Do not
|
|
36
36
|
ask the developer about telemetry: the command applies the setting they already have.
|
|
37
37
|
|
|
38
38
|
```text
|
|
39
|
-
npx --yes copilotkit@4.
|
|
39
|
+
npx --yes copilotkit@4.13.0 onboard friction --phase stop --category <slug>
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
Write one or two sentences to standard input: the step you stopped at and what stopped it.
|
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 ? "1e13b4945b44c6afa2e398a0c9935415d4aa7577" : "main";
|
|
14702
14702
|
}
|
|
14703
14703
|
|
|
14704
14704
|
// apps/cli/src/services/agentcore-config.ts
|