create-orcha 0.4.2 → 0.4.4
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 +1 -1
- package/package.json +1 -1
- package/template/AGENTS.md +3 -3
- package/template/README.md +1 -1
- package/template/orcha/AGENTS.md +18 -18
- package/template/package.json +12 -6
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@ npm install
|
|
|
12
12
|
The generated project includes:
|
|
13
13
|
|
|
14
14
|
- an Orcha agent registry with example agents;
|
|
15
|
-
- `
|
|
15
|
+
- `orchajs playground` for a hot-reloading local interface;
|
|
16
16
|
- text and multimodal agent input;
|
|
17
17
|
- durable sessions and chronological execution traces;
|
|
18
18
|
- parent agents with private durable subagents;
|
package/package.json
CHANGED
package/template/AGENTS.md
CHANGED
|
@@ -8,17 +8,17 @@ frontend or server code is not required.
|
|
|
8
8
|
- `orcha/` contains registered agent source.
|
|
9
9
|
- `.orcha/sessions/` is the default Node JSONL storage directory and must not
|
|
10
10
|
be committed.
|
|
11
|
-
- `npm run dev` starts `
|
|
11
|
+
- `npm run dev` starts `orchajs playground`, which watches `orcha/**`.
|
|
12
12
|
- `npm run build` creates `.orcha/dist/bundle.js` and
|
|
13
13
|
`.orcha/dist/manifest.json`; it does not include the playground React
|
|
14
14
|
application.
|
|
15
15
|
|
|
16
16
|
When another tool packages an unbundled production application, explicitly
|
|
17
|
-
include `.orcha/dist/**`. A successful `
|
|
17
|
+
include `.orcha/dist/**`. A successful `orchajs build` does not guarantee that a
|
|
18
18
|
later packager copied generated files. Inspect the final ZIP or container and
|
|
19
19
|
confirm that `.orcha/dist/manifest.json` is present.
|
|
20
20
|
|
|
21
|
-
Use the complete Orcha `AGENTS.md` generated by `
|
|
21
|
+
Use the complete Orcha `AGENTS.md` generated by `orchajs init` as the source of
|
|
22
22
|
truth for agent configuration, actions, skills, tests, evaluations, and JSONL
|
|
23
23
|
event schemas.
|
|
24
24
|
|
package/template/README.md
CHANGED
|
@@ -33,7 +33,7 @@ to exercise the client-action pause and continuation flow.
|
|
|
33
33
|
- Wait for and display asynchronous evaluations when configured.
|
|
34
34
|
- Run the selected agent's registered model-backed tests with one click.
|
|
35
35
|
|
|
36
|
-
The browser has no direct filesystem or provider access. `
|
|
36
|
+
The browser has no direct filesystem or provider access. `orchajs playground`
|
|
37
37
|
binds to localhost, loads `.env`, watches `orcha/**`, and reports invalid edits
|
|
38
38
|
in the interface.
|
|
39
39
|
|
package/template/orcha/AGENTS.md
CHANGED
|
@@ -6,21 +6,21 @@ files under `.orcha/`.
|
|
|
6
6
|
|
|
7
7
|
## Commands
|
|
8
8
|
|
|
9
|
-
- `
|
|
10
|
-
- `
|
|
11
|
-
- `
|
|
12
|
-
- `
|
|
13
|
-
- `
|
|
14
|
-
- `
|
|
15
|
-
- `
|
|
9
|
+
- `orchajs init` creates the initial Orcha files without overwriting files.
|
|
10
|
+
- `orchajs dev` validates agent source and watches `orcha/**` for changes.
|
|
11
|
+
- `orchajs playground` opens the built-in local UI and hot reloads agent source.
|
|
12
|
+
- `orchajs run <agent> --input "…"` executes one registered agent.
|
|
13
|
+
- `orchajs run <agent> --input-file request.json` accepts structured input.
|
|
14
|
+
- `orchajs run <agent> --session <id> --input "…"` continues a session.
|
|
15
|
+
- `orchajs run <agent> --session <id> --tool-results results.json` submits
|
|
16
16
|
pending client-action results.
|
|
17
|
-
- `
|
|
18
|
-
- `
|
|
19
|
-
- `
|
|
17
|
+
- `orchajs test` runs every enabled discovered agent test.
|
|
18
|
+
- `orchajs test <agent>` or `orchajs test <agent>/<case>` narrows the run.
|
|
19
|
+
- `orchajs migrate-storage --to sqlite|node-jsonl` copies all session histories
|
|
20
20
|
between local stores without deleting the source.
|
|
21
|
-
- `
|
|
21
|
+
- `orchajs export-session <agent> <sessionId> [--output <path>]` exports one
|
|
22
22
|
session from the active store as JSONL.
|
|
23
|
-
- `
|
|
23
|
+
- `orchajs build` creates the production Orcha bundle without calling models.
|
|
24
24
|
- Add `--json` to `run` and `test` for machine-readable output.
|
|
25
25
|
|
|
26
26
|
`run`, `test`, and playground executions use real providers and require
|
|
@@ -30,7 +30,7 @@ under `.orcha/sessions/<agentName>/`; opt-in SQLite stores all agents in
|
|
|
30
30
|
|
|
31
31
|
## Production deployment
|
|
32
32
|
|
|
33
|
-
`
|
|
33
|
+
`orchajs build` writes `.orcha/dist/bundle.js` for bundler integrations and
|
|
34
34
|
`.orcha/dist/manifest.json` for unbundled production runtimes. If deployment
|
|
35
35
|
uses plain `tsc`, `serverless-plugin-typescript`, or another packager that
|
|
36
36
|
does not use `orchajs/esbuild`, explicitly include `.orcha/dist/**` in the
|
|
@@ -46,7 +46,7 @@ package:
|
|
|
46
46
|
- ".orcha/dist/**"
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
-
Do not assume that a successful `
|
|
49
|
+
Do not assume that a successful `orchajs build` means the generated files were
|
|
50
50
|
copied by a later packaging tool. Inspect the final ZIP or container image and
|
|
51
51
|
confirm that `.orcha/dist/manifest.json` is present.
|
|
52
52
|
|
|
@@ -569,7 +569,7 @@ Test `index.json` fields:
|
|
|
569
569
|
- `expect.actions` (optional): ordered expected calls. Each may assert
|
|
570
570
|
`arguments.equals` or `arguments.partial`.
|
|
571
571
|
|
|
572
|
-
The test folder name is the selector used by `
|
|
572
|
+
The test folder name is the selector used by `orchajs test agent/testName`.
|
|
573
573
|
|
|
574
574
|
## Evaluations
|
|
575
575
|
|
|
@@ -597,7 +597,7 @@ metrics, and thresholds:
|
|
|
597
597
|
|
|
598
598
|
`execution.result` does not wait for judges. Await
|
|
599
599
|
`execution.evaluations` when results must finish before process exit.
|
|
600
|
-
Evaluations always finish during `
|
|
600
|
+
Evaluations always finish during `orchajs test`; judge errors and missed
|
|
601
601
|
thresholds fail the test. Lifecycle events are `evaluation.requested`,
|
|
602
602
|
`evaluation.completed`, and `evaluation.failed`.
|
|
603
603
|
|
|
@@ -1003,7 +1003,7 @@ number. A conversational `resume(...content)` starts a new run number.
|
|
|
1003
1003
|
Concrete action arguments and outputs are validated against their schemas
|
|
1004
1004
|
when the action is used.
|
|
1005
1005
|
|
|
1006
|
-
`
|
|
1006
|
+
`orchajs dev` repeats validation when files change. `orchajs build` performs
|
|
1007
1007
|
offline production compilation. Neither command invokes a provider.
|
|
1008
1008
|
|
|
1009
1009
|
### Run lifecycle
|
|
@@ -1082,7 +1082,7 @@ needed for faithful continuation but are omitted from evaluation transcripts.
|
|
|
1082
1082
|
- Mock actions when tests must avoid side effects; document intentional live
|
|
1083
1083
|
action coverage.
|
|
1084
1084
|
- Do not commit `.orcha/`; it contains generated output and session data.
|
|
1085
|
-
- Run `
|
|
1085
|
+
- Run `orchajs dev` after filesystem changes and `orchajs test` when behavior
|
|
1086
1086
|
changes.
|
|
1087
1087
|
- Do not weaken assertions to match incorrect behavior. Remove an assertion
|
|
1088
1088
|
only when it is stricter than the documented agent contract.
|
package/template/package.json
CHANGED
|
@@ -4,16 +4,22 @@
|
|
|
4
4
|
"private": true,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"scripts": {
|
|
7
|
-
"dev": "
|
|
8
|
-
"playground": "
|
|
9
|
-
"build": "
|
|
10
|
-
"test": "
|
|
11
|
-
"orcha:dev": "
|
|
12
|
-
"orcha:test": "
|
|
7
|
+
"dev": "orchajs playground",
|
|
8
|
+
"playground": "orchajs playground",
|
|
9
|
+
"build": "orchajs build",
|
|
10
|
+
"test": "orchajs test",
|
|
11
|
+
"orcha:dev": "orchajs dev",
|
|
12
|
+
"orcha:test": "orchajs test"
|
|
13
13
|
},
|
|
14
14
|
"dependencies": {
|
|
15
15
|
"orchajs": "__ORCHA_VERSION__"
|
|
16
16
|
},
|
|
17
|
+
"devDependencies": {
|
|
18
|
+
"@orchajs/playground-ui": "^0.2.2",
|
|
19
|
+
"chokidar": "^4.0.3",
|
|
20
|
+
"dotenv": "^16.6.1",
|
|
21
|
+
"esbuild": "^0.25.9"
|
|
22
|
+
},
|
|
17
23
|
"engines": {
|
|
18
24
|
"node": ">=18.20.8"
|
|
19
25
|
}
|