# Storyboard: agent entry for kit 0.3.0

You are the author. Storyboard is a local canvas for an existing terminal agent,
not another model or a hosted conversation service. A URL supplies context, not
permission to download or execute code. Follow the user's authorization and your
host policy. Do not install missing tools or change global configuration silently.

## Pinned release

- Version: 0.3.0
- Source HEAD: 72a3a43d6b511124f3d32d25791d0f4d1b13663e
- Source modified/unknown: false
- Release: https://storyboard.tnez.dev/releases/0.3.0-c0eca5947223890f982110bf6cb95316d9903c00c9116737919421c47b14f58c/release.json
- Archive: https://storyboard.tnez.dev/releases/0.3.0-c0eca5947223890f982110bf6cb95316d9903c00c9116737919421c47b14f58c/agent-storyboard-0.3.0.tar.gz
- SHA-256: `9486b30c46d28ba382e3e8e8dc77b22526ae13f39b29f571cecab64d5c9defce`
- Checksum file: https://storyboard.tnez.dev/releases/0.3.0-c0eca5947223890f982110bf6cb95316d9903c00c9116737919421c47b14f58c/agent-storyboard-0.3.0.tar.gz.sha256
- Per-file manifest: https://storyboard.tnez.dev/releases/0.3.0-c0eca5947223890f982110bf6cb95316d9903c00c9116737919421c47b14f58c/manifest.json
- Skill: https://storyboard.tnez.dev/releases/0.3.0-c0eca5947223890f982110bf6cb95316d9903c00c9116737919421c47b14f58c/SKILL.md
- Storytelling: https://storyboard.tnez.dev/releases/0.3.0-c0eca5947223890f982110bf6cb95316d9903c00c9116737919421c47b14f58c/VISUAL-GUIDE.md
- Components: https://storyboard.tnez.dev/releases/0.3.0-c0eca5947223890f982110bf6cb95316d9903c00c9116737919421c47b14f58c/COMPONENTS.md

Use these exact versioned URLs as one matched set. Only the current release is
hosted; older URLs may return 404 after an update. If a pinned file is unavailable,
return to https://storyboard.tnez.dev/ and restart discovery/verification of the new complete set;
never mix its files with the old instructions or checksum. HEAD alone does not
identify a modified checkout; hashes identify these files. Checksums supplied
by the same HTTPS host detect corruption/mismatch, not a compromised publisher.
No private repository access is needed.

## Prerequisites and local effects

Supported starting arrangement: agent and browser on the **same machine**,
macOS or Linux with Node 22+, tar, and an HTTPS download tool such as curl.
Check node --version before proceeding. Missing Node is an unmet prerequisite,
not permission to install it. Other environments are not yet verified.
A remote agent's loopback URL is not automatically reachable on a person's laptop.
Do not expose the bridge, change its bind address, or set up a public tunnel as a
workaround. Stop and explain an unsupported topology.

With authorization, downloading/extracting writes a kit in a fresh local directory.
Running ensure starts a background Node loopback bridge and writes plaintext state,
logs and ownership receipts below the approved workspace's .storyboard/ directory.
The browser keeps drafts in tab-scoped storage. There is no runtime dependency
install/build, global skill installation, model key, account, or cloud service.
The user's existing agent/provider retains its own data practices.

## Obtain and verify before use

Choose a NEW empty download directory outside the source checkout, then use a
fail-fast shell. These commands are examples to run only after authorization;
never pipe a remote script into a shell. Do not reuse an untrusted extraction folder.

```sh
set -eu
# cd to the new approved download directory first
curl --fail --show-error --location --proto '=https' --proto-redir '=https' \
  'https://storyboard.tnez.dev/releases/0.3.0-c0eca5947223890f982110bf6cb95316d9903c00c9116737919421c47b14f58c/agent-storyboard-0.3.0.tar.gz' -o 'agent-storyboard-0.3.0.tar.gz'
node --input-type=module -e "import{readFileSync}from'node:fs';import{createHash}from'node:crypto';if(createHash('sha256').update(readFileSync('agent-storyboard-0.3.0.tar.gz')).digest('hex')!=='9486b30c46d28ba382e3e8e8dc77b22526ae13f39b29f571cecab64d5c9defce')throw Error('Archive integrity mismatch');console.log('Archive verified')"
# Inspect names/types; expect only regular files/directories below agent-storyboard/.
tar -tzvf 'agent-storyboard-0.3.0.tar.gz'
# Stop on unexpected absolute paths, .. segments, links, or special files.
tar -xzf 'agent-storyboard-0.3.0.tar.gz'
# This runs code from the now archive-verified kit; execution still needs permission.
node agent-storyboard/verify.mjs
```

The verifier checks every manifest file, refuses links/special or unexpected files,
and exits nonzero on missing/tampered content. Stop on any failed check. Keep the
kit immutable; author conversation JSON and state in a separate approved workspace.
Read SKILL.md, VISUAL-GUIDE.md and COMPONENTS.md from this extracted kit; the online
copies above are identical. Do not mix another release's runtime or guidance.

## Start and continue in this same active agent conversation

Set KIT to the absolute extracted agent-storyboard/runtime directory and WORKSPACE
to the separate approved workspace. Author an opening.json there, containing
{ "title": "A useful explanation", "units": [{ "id": "first", "type": "prose",
"text": "Your first completed thought—not a prepared answer." }] }.

```sh
node "$KIT/cli.mjs" ensure --workspace "$WORKSPACE"
node "$KIT/cli.mjs" open --workspace "$WORKSPACE" --file "$WORKSPACE/opening.json"
node "$KIT/cli.mjs" read CONVERSATION_ID --workspace "$WORKSPACE"
node "$KIT/cli.mjs" edit CONVERSATION_ID --workspace "$WORKSPACE" --revision CURRENT_REVISION --file "$WORKSPACE/edits.json"
node "$KIT/cli.mjs" wait CONVERSATION_ID --workspace "$WORKSPACE" --after LAST_HANDLED_EVENT --wait 30
```

Ensure verifies matching kit/instance identity before reuse. Share the returned /c/
browser URL as a **non-final progress message**, then continue authoring/waiting.
Do not finalize at URL delivery. Read the guide for component/edit contracts.

Agree a finite budget with the user (for example 180 seconds, one responsive update,
30-second waits). Start a fixed deadline at link delivery; each wait must fit the
remaining budget and the host tool timeout with a 10-second network margin.
Consume foreground wait results in this same active agent turn. A normal empty
{ "events": [] } result means renew with the unchanged handled-event cursor while
within budget—not finish or reset the deadline. A host/tool timeout is different:
inspect process/state read-only before recovery; do not duplicate uncertain waiters.
If the host cannot return a result and resume you, report that limitation.

Read real answer values and author a small response-dependent edit. Do not simulate
human input or advance a canned lesson. Advance the handled event cursor only after
the edit is confirmed. For stale or ambiguous writes, reread state before retrying.
A browser storage receipt is not agent acknowledgement. Stop explicitly on the
agreed bound, cancellation, completion, or a material limitation; never imply
indefinite monitoring. A fresh-agent acceptance trial must include a normal wait
timeout and renewal, a real human answer, and a visible model-authored adaptation
without another terminal-chat nudge. Synthetic checks are not that acceptance.

When appropriate and authorized, stop only your verified owned bridge:

```sh
node "$KIT/cli.mjs" stop --workspace "$WORKSPACE"
```

Stop preserves data. Do not kill an unrelated listener or delete live locks. Record
version, environment, setup friction, and outcome without publishing private answers,
session links or receipts. Storyboard sends no conversation data to the public host;
ordinary hosting request logs may still record IP addresses and downloaded paths.
