create-orcha 0.4.3 → 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 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
- - `orcha playground` for a hot-reloading local interface;
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-orcha",
3
- "version": "0.4.3",
3
+ "version": "0.4.4",
4
4
  "description": "Create a complete OrchaJS project with example agents and a local playground.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -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 `orcha playground`, which watches `orcha/**`.
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 `orcha build` does not guarantee that a
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 `orcha init` as the source of
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
 
@@ -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. `orcha playground`
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
 
@@ -6,21 +6,21 @@ files under `.orcha/`.
6
6
 
7
7
  ## Commands
8
8
 
9
- - `orcha init` creates the initial Orcha files without overwriting files.
10
- - `orcha dev` validates agent source and watches `orcha/**` for changes.
11
- - `orcha playground` opens the built-in local UI and hot reloads agent source.
12
- - `orcha run <agent> --input "…"` executes one registered agent.
13
- - `orcha run <agent> --input-file request.json` accepts structured input.
14
- - `orcha run <agent> --session <id> --input "…"` continues a session.
15
- - `orcha run <agent> --session <id> --tool-results results.json` submits
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
- - `orcha test` runs every enabled discovered agent test.
18
- - `orcha test <agent>` or `orcha test <agent>/<case>` narrows the run.
19
- - `orcha migrate-storage --to sqlite|node-jsonl` copies all session histories
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
- - `orcha export-session <agent> <sessionId> [--output <path>]` exports one
21
+ - `orchajs export-session <agent> <sessionId> [--output <path>]` exports one
22
22
  session from the active store as JSONL.
23
- - `orcha build` creates the production Orcha bundle without calling models.
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
- `orcha build` writes `.orcha/dist/bundle.js` for bundler integrations and
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 `orcha build` means the generated files were
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 `orcha test agent/testName`.
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 `orcha test`; judge errors and missed
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
- `orcha dev` repeats validation when files change. `orcha build` performs
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 `orcha dev` after filesystem changes and `orcha test` when behavior
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.
@@ -4,12 +4,12 @@
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "scripts": {
7
- "dev": "orcha playground",
8
- "playground": "orcha playground",
9
- "build": "orcha build",
10
- "test": "orcha test",
11
- "orcha:dev": "orcha dev",
12
- "orcha:test": "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__"