create-orcha 0.4.5 → 0.4.6

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/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "create-orcha",
3
- "version": "0.4.5",
4
- "description": "Create a complete OrchaJS project with example agents and a local playground.",
3
+ "version": "0.4.6",
4
+ "description": "Create a JavaScript or TypeScript AI agent project with OrchaJS, tools, tests, and local playground.",
5
5
  "type": "module",
6
6
  "license": "MIT",
7
7
  "repository": {
@@ -13,11 +13,23 @@
13
13
  "bugs": {
14
14
  "url": "https://github.com/Amarsia/orcha/issues"
15
15
  },
16
+ "author": {
17
+ "name": "Amarsia",
18
+ "url": "https://amarsia.com"
19
+ },
16
20
  "keywords": [
17
21
  "ai",
18
22
  "agents",
23
+ "ai-agents",
24
+ "agent-framework",
19
25
  "orcha",
20
- "scaffold"
26
+ "orchajs",
27
+ "create-orcha",
28
+ "mcp",
29
+ "typescript",
30
+ "javascript",
31
+ "scaffold",
32
+ "amarsia"
21
33
  ],
22
34
  "bin": {
23
35
  "create-orcha": "./bin/create-orcha.js"
@@ -26,3 +26,9 @@ Direct-provider credentials belong in `.env`. Projects using
26
26
  `amarsia.inference: true` need only `amarsia.key`; the standalone Orcha CLI
27
27
  loads environment files without overriding values already in the process.
28
28
  `storage: { strategy: "cloud" }` is local-first and uses the same project key.
29
+ Set `telemetry: { otel: true }` to use the application's global OpenTelemetry
30
+ provider, or pass `telemetry: { otel: { endpoint, headers? } }` to send
31
+ privacy-safe run traces directly to an OTLP/HTTP collector. Spans follow the
32
+ OpenTelemetry GenAI Semantic Conventions. Orcha telemetry never includes
33
+ prompts, responses, action arguments, or action outputs. Subagents share their
34
+ root agent's trace; `orcha.close()` marks active runs interrupted.
@@ -106,6 +106,12 @@ required.
106
106
  - `amarsia.inference` (optional): routes all model calls through Amarsia while
107
107
  preserving the provider and model in each manifest. It reuses `amarsia.key`;
108
108
  local provider credentials are not required.
109
+ - `telemetry.otel` (optional): set to `true` to emit spans through the
110
+ application's global OpenTelemetry provider, or pass
111
+ `{ endpoint, headers? }` to send OTLP/HTTP JSON directly to a collector.
112
+ Spans follow OpenTelemetry GenAI Semantic Conventions. Telemetry excludes
113
+ prompts, responses, action arguments, and action outputs. Subagents share
114
+ their root agent's trace; `orcha.close()` marks active runs interrupted.
109
115
  - `actions` (optional): overrides the native local-action runtime or configures
110
116
  its environment and sandbox settings.
111
117
  - `mcp.credentials` (optional): runtime-only values used to resolve
@@ -407,7 +413,8 @@ const evaluations = await execution.evaluations;
407
413
  `run()` and conversational `resume()` accept either a direct `AgentContentInput` (a string, a single content item, or an array of content items) or an object with `content` and optional fields:
408
414
 
409
415
  - `content` (required when passing an options object): a non-empty string, one content item, or an array.
410
- Use `{ filePath: "./document.pdf" }` for a local file or
416
+ Use `{ type: "text", text: "..." }` for text, `{ type: "json", data: { ... } }` for structured JSON payloads,
417
+ `{ filePath: "./document.pdf" }` for a local file, or
411
418
  `{ url: "https://example.com/document.pdf" }` for a remote file.
412
419
  `mimeType` is optional when it can be inferred from the extension. Durable
413
420
  events store local paths and MIME types, never encoded file bytes.
@@ -783,6 +790,9 @@ type SessionCreated = SessionEvent<{
783
790
  parentAgent: string;
784
791
  parentSessionId: string;
785
792
  parentCallId: string;
793
+ parentRunNumber?: number;
794
+ rootSessionId?: string;
795
+ rootRunNumber?: number;
786
796
  };
787
797
  }>; // type "session.created", no run
788
798
 
@@ -1094,11 +1104,12 @@ offline production compilation. Neither command invokes a provider.
1094
1104
  6. `load_skill` updates durable session instructions. Local actions execute
1095
1105
  through the configured runtime. Client actions pause safely. Tool results
1096
1106
  are reordered to match the model's original call order.
1097
- 7. Internal agent tools start or continue linked child sessions. A
1098
- `run_agent` input accepts the same text or multimodal content shape as a
1099
- normal run. Local file paths resolve from the configured Orcha project root.
1100
- The parent reports `waiting_for_subagent` until each synchronous child
1101
- call returns.
1107
+ 7. Internal agent tools start or continue linked child sessions. `run_agent`
1108
+ and `resume_agent` take `content` as an array of content blocks
1109
+ (`{ type: "text", text }`, `{ type: "json", data }`, `{ type: "file", filePath }`,
1110
+ or `{ type: "url", url }`). Local file paths resolve from the configured Orcha
1111
+ project root. The parent reports `waiting_for_subagent` until each
1112
+ synchronous child call returns.
1102
1113
  8. The model loop continues until final output, failure, a pause, or the
1103
1114
  maximum of 20 action rounds.
1104
1115
  9. Usage is normalized and aggregated across every model call in the run.