chore: update package versions to 0.0.3 and refine documentation for saved results

- Bumped version numbers for all packages to 0.0.3, ensuring consistency across the project.
- Updated documentation to clarify terminology, replacing "trace" with "saved result" for improved clarity.
- Enhanced descriptions and examples to emphasize the significance of saved results and their URLs for both successful and failed runs.
- Adjusted various sections to improve readability and user comprehension, aligning with recent changes in terminology.

Author: acoyfellow

README.md

@@ -10,7 +10,7 @@ agent writes code  →  Lab runs it  →  saved result (what happened)  →  age
 
 **Try it now:** [lab.coey.dev/compose](https://lab.coey.dev/compose) — run a chain, click the saved-result link.
 
-> **0.0.2** — API and trace shapes may still move. Pin to exact versions or self-host.
+> **0.0.3** — API and saved-result shapes may still move. Pin to exact versions or self-host.
 
 ## Quickstart
 
@@ -34,7 +34,7 @@ const out = await lab.runChain([
 ]);
 
 console.log(out.result);   // { valid: true, healed: true, users: 1 }
-console.log(out.traceId);  // → $LAB_URL/t/<id> (shareable result URL)
+console.log(out.traceId);  // → machine JSON: $LAB_URL/t/<id>.json; viewer: $LAB_URL/t/<id>
 ```
 
 Each step runs in its own sandbox. Step 2's output flows to Step 3's `input`. The result is saved at a URL — share it to show what happened.
@@ -71,7 +71,7 @@ See all patterns: [lab.coey.dev/docs/patterns](https://lab.coey.dev/docs/pattern
 
 No capabilities = pure compute, no I/O. Denied capabilities produce clear errors recorded in the saved result.
 
-**Results** — every run saves a JSON document. Use `/t/:id` as the shareable result URL and `/t/:id.json` for the raw JSON. Successful runs include code, capabilities, return values, and timing. Failed or aborted runs include the top-level error and reason; chain step detail may be partial or empty. Share the URL. Fork it into a new run. Hand it to another agent.
+**Results** — every run saves a JSON document. Agents and scripts should read `/t/:id.json`. Humans can open `/t/:id` as the viewer over that same saved result. Successful runs include code, capabilities, return values, and timing. Failed or aborted runs include the top-level error and reason; chain step detail may be partial or empty. Share the URL. Fork it into a new run. Hand it to another agent.
 
 ## API
 
@@ -87,8 +87,8 @@ No capabilities = pure compute, no I/O. Denied capabilities produce clear errors
 | `POST` | `/run/generate` | `{ prompt, capabilities }` |
 | `POST` | `/seed` | `{}` — writes demo KV data |
 | `GET` | `/lab/catalog` | capability + route metadata for agents |
-| `GET` | `/t/:id` | shareable saved-result URL |
-| `GET` | `/t/:id.json` | raw saved-result JSON |
+| `GET` | `/t/:id` | human saved-result viewer |
+| `GET` | `/t/:id.json` | canonical saved-result JSON |
 
 ### TypeScript client
 
@@ -104,8 +104,8 @@ npm install @acoyfellow/lab
 | `runSpawn(payload)` | Nested isolates |
 | `runGenerate(payload)` | AI-generated code + run |
 | `seed()` | Seed demo KV data |
-| `getTrace(traceId)` | Fetch the saved result |
-| `getTraceJson(traceId)` | Fetch raw saved-result JSON |
+| `getTrace(traceId)` | Fetch canonical saved-result JSON |
+| `getTraceJson(traceId)` | Same JSON via the explicit `.json` path |
 
 Effect client: `import { createLabEffectClient } from "@acoyfellow/lab/effect"` — same API, returns `Effect` instead of `Promise`.
 
@@ -146,13 +146,13 @@ Requires Cloudflare Workers Paid ($5/mo). Provisions the public app, the private
 
 ```
 worker/              Sandbox engine (Effect v4, Worker Loaders)
-  index.ts           Routes, chain/spawn orchestration, trace storage
+  index.ts           Routes, chain/spawn orchestration, saved-result storage
   Loader.ts          V8 sandbox lifecycle
   guest/templates.ts Guest module composition + capability shims
   capabilities/      Capability registry
 packages/lab/        TypeScript client (@acoyfellow/lab)
 packages/lab-mcp/    MCP server (@acoyfellow/lab-mcp)
-src/                 SvelteKit app (compose, trace viewer, docs)
+src/                 SvelteKit app (compose, saved-result viewer, docs)
 alchemy.run.ts       Infrastructure-as-code
 ```
 

bun.lock

@@ -1,6 +1,6 @@
 {
   "name": "lab",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "private": false,
   "packageManager": "bun@1.3.10",
   "workspaces": [

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acoyfellow/lab-cli",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Minimal CLI for Lab — agents shell out, get saved results back",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@acoyfellow/lab": "^0.0.2",
+    "@acoyfellow/lab": "^0.0.3",
     "effect": "4.0.0-beta.40"
   },
   "devDependencies": {

packages/lab-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acoyfellow/lab-mcp",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "MCP server for Lab: find (catalog/saved result) + execute (guest runs) via stdio",
   "license": "MIT",
   "type": "module",
@@ -29,7 +29,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@acoyfellow/lab": "^0.0.2",
+    "@acoyfellow/lab": "^0.0.3",
     "@modelcontextprotocol/sdk": "1.28.0",
     "effect": "4.0.0-beta.40",
     "zod": "^4.0.0"

packages/lab-mcp/dist/main.js

@@ -5,7 +5,7 @@ import { catalogAtPath } from './catalogPath.js';
 
 /** Minimal shape for path tests only */
 const cat = {
-  version: '0.0.2',
+  version: '0.0.3',
   capabilities: [{ id: 'kvRead', binding: 'KV', summary: '', llmHint: '' }],
   templates: [],
   execute: {
@@ -21,7 +21,7 @@ const cat = {
 
 describe('catalogAtPath', () => {
   test('scalar at top-level path', () => {
-    expect(catalogAtPath(cat, 'version')).toBe('0.0.2');
+    expect(catalogAtPath(cat, 'version')).toBe('0.0.3');
   });
 
   test('nested path', () => {

packages/lab-mcp/package.json

@@ -81,7 +81,7 @@ function mapHttpToError(err: HttpError): Error {
 
 const mcpServer = new McpServer({
   name: 'lab',
-  version: '0.0.2',
+  version: '0.0.3',
 });
 
 mcpServer.registerTool(

packages/lab-mcp/src/catalogPath.test.ts

@@ -1,6 +1,6 @@
 {
   "name": "@acoyfellow/lab-petri",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Persistent substrate for Lab experiments - Durable Object backed state with real-time sync",
   "type": "module",
   "main": "./dist/index.js",

packages/lab-mcp/src/main.ts

@@ -2,7 +2,7 @@
 
 Typed HTTP client for the [Lab](https://github.com/acoyfellow/lab) public app API — sandboxed isolates, capability chains, and saved results.
 
-> **0.0.2** — early feedback. API may change.
+> **0.0.3** — early feedback. API may change.
 
 ## Install
 
@@ -41,9 +41,11 @@ console.log(r.result);  // [2, 4, 6]
 | `runSpawn({ body, capabilities, depth? })` | `POST /run/spawn` |
 | `runGenerate({ prompt, capabilities })` | `POST /run/generate` |
 | `seed()` | `POST /seed` |
-| `getTrace(id)` | `GET /t/:id` |
+| `getTrace(id)` | `GET /t/:id.json` |
 | `getTraceJson(id)` | `GET /t/:id.json` |
 
+`GET /t/:id` is the human viewer on the public app. Agents and scripts should read `GET /t/:id.json`.
+
 Use `body` for guest JavaScript. `code` is a legacy alias. Default template: `guest@v1`.
 
 **Effect client:** `import { createLabEffectClient } from "@acoyfellow/lab/effect"` — same methods, returns `Effect` instead of `Promise`. Peer dependency: `effect@4.0.0-beta.40`.