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 +15 -3
- package/template/AGENTS.md +6 -0
- package/template/orcha/AGENTS.md +17 -6
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-orcha",
|
|
3
|
-
"version": "0.4.
|
|
4
|
-
"description": "Create a
|
|
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
|
-
"
|
|
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"
|
package/template/AGENTS.md
CHANGED
|
@@ -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.
|
package/template/orcha/AGENTS.md
CHANGED
|
@@ -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 `{
|
|
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.
|
|
1098
|
-
`
|
|
1099
|
-
|
|
1100
|
-
|
|
1101
|
-
|
|
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.
|