@archal/cli 0.2.0 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 The Archal CLI — test AI agents against digital twins.
 
-Archal lets you define scenarios, run your agent against simulated environments (digital twins), and evaluate the results using LLM-based grading.
+Archal provisions hosted twin sessions, runs your scenario through a configurable engine (API or local harness), and evaluates outcomes against deterministic and probabilistic criteria.
 
 ## Install
 
@@ -13,14 +13,14 @@ npm install -g @archal/cli
 ## Quick Start
 
 ```bash
-# Initialize a new archal project in the current directory
+# Initialize a project in the current directory
 archal init
 
-# Run a scenario against your agent
-archal run scenario.md --agent "node my-agent.js"
-
-# Run a built-in demo to see archal in action
-archal demo
+# Run a scenario (cloud-only transport)
+archal run scenario.md \
+  --engine-endpoint "https://gateway.openclaw.ai/v1/responses" \
+  --engine-token "$OPENCLAW_GATEWAY_TOKEN" \
+  --engine-model "openclaw:main"
 ```
 
 ## Commands
@@ -28,8 +28,11 @@ archal demo
 | Command | Description |
 | --- | --- |
 | `archal init` | Scaffold a new archal project with example scenarios |
-| `archal run <scenario>` | Execute a scenario against an agent and evaluate results |
-| `archal demo` | Run a built-in demo scenario end-to-end |
+| `archal run <scenario>` | Execute a scenario against hosted twins and evaluate results |
+| `archal login` | Authenticate via archal.ai |
+| `archal whoami` | Show current auth/account status |
+| `archal twins` | Manage selected twins for your plan |
+| `archal trace` | Inspect run traces |
 | `archal config` | View or update CLI configuration |
 
 ## Environment Variables
@@ -37,7 +40,17 @@ archal demo
 | Variable | Description |
 | --- | --- |
 | `ARCHAL_TOKEN` | Auth token for Archal backend API (get one at archal.ai) |
-| `ARCHAL_AGENT_COMMAND` | Default agent command (can be overridden with `--agent`) |
+| `ARCHAL_ENGINE_ENDPOINT` | Default API engine endpoint |
+| `ARCHAL_ENGINE_TOKEN` | Default API engine auth token |
+| `ARCHAL_ENGINE_MODEL` | Default engine model identifier |
+| `ARCHAL_ENGINE_TIMEOUT` | Default API engine timeout in seconds |
+| `ARCHAL_ENGINE_TWIN_URLS` | Default path to remote twin URL overrides |
+| `ARCHAL_HARNESS_DIR` | Default harness directory for local mode |
+| `OPENCLAW_URL` | OpenClaw gateway URL (fallback alias for `--openclaw-url`) |
+| `OPENCLAW_GATEWAY_TOKEN` | OpenClaw gateway token used by `archal run` |
+| `OPENCLAW_GATEWAY_PASSWORD` | Password-mode OpenClaw gateway auth value |
+| `OPENCLAW_AGENT_ID` | Default OpenClaw agent/model id |
+| `ARCHAL_API_URL` | Optional override for Archal API base URL |
 
 ## Documentation
 
@@ -45,4 +58,4 @@ For full documentation, architecture details, and contributor guides, see the [A
 
 ## License
 
-UNLICENSED — proprietary software. See [archal.ai](https://archal.ai) for licensing.
+MIT

package/dist/api-client-D7SCA64V.js

@@ -0,0 +1,23 @@
+import {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+} from "./chunk-SVGN2AFT.js";
+import "./chunk-3RG5ZIWI.js";
+export {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+};

package/dist/api-client-DI7R3H4C.js

@@ -0,0 +1,21 @@
+import {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+} from "./chunk-WZXES7XO.js";
+import "./chunk-3RG5ZIWI.js";
+export {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+};

package/dist/api-client-EMMBIJU7.js

@@ -0,0 +1,23 @@
+import {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+} from "./chunk-A6WOU5RO.js";
+import "./chunk-3RG5ZIWI.js";
+export {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+};

package/dist/api-client-VYQMFDLN.js

@@ -0,0 +1,23 @@
+import {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+} from "./chunk-4FTU232H.js";
+import "./chunk-3RG5ZIWI.js";
+export {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+};

package/dist/api-client-WN45C63M.js

@@ -0,0 +1,23 @@
+import {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+} from "./chunk-VYCADG5E.js";
+import "./chunk-3RG5ZIWI.js";
+export {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+};

package/dist/api-client-ZOCVG6CC.js

@@ -0,0 +1,21 @@
+import {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+} from "./chunk-NZEPQ6IZ.js";
+import "./chunk-3RG5ZIWI.js";
+export {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+};

package/dist/api-client-ZUMDL3TP.js

@@ -0,0 +1,23 @@
+import {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+} from "./chunk-UOJHYCMX.js";
+import "./chunk-3RG5ZIWI.js";
+export {
+  endSession,
+  fetchAuthMe,
+  fetchTwinsCatalog,
+  finalizeSessionEvidence,
+  getSessionEvidence,
+  getSessionHealth,
+  getSessionStatus,
+  startSession,
+  updateTwinSelection
+};