codetether-agent 4.7.0-a-002.4

# TetherScript Plugin Pack

These scripts run through the existing `tetherscript_plugin` tool. They are
small examples of useful project-local automation without adding Rust code.

## Guardrails

Deny sensitive paths:

```json
{
  "path": "examples/tetherscript/guardrails.tether",
  "hook": "allow_path",
  "args": [".env.local"]
}
```

Scan text for obvious secrets:

```json
{
  "path": "examples/tetherscript/guardrails.tether",
  "hook": "scan_text",
  "args": ["BEGIN PRIVATE KEY"]
}
```

## Task scoring

```json
{
  "path": "examples/tetherscript/task_score.tether",
  "hook": "score",
  "args": ["security bug in auth", 10]
}
```

```json
{
  "path": "examples/tetherscript/task_score.tether",
  "hook": "classify",
  "args": ["bug in parser"]
}
```

## Test output routing

```json
{
  "path": "examples/tetherscript/test_output.tether",
  "hook": "cargo_status",
  "args": ["test result: ok. 12 passed"]
}
```

```json
{
  "path": "examples/tetherscript/test_output.tether",
  "hook": "next_action",
  "args": ["failed"]
}
```

## PR summary helpers

```json
{
  "path": "examples/tetherscript/pr_summary.tether",
  "hook": "title",
  "args": ["feat", "tetherscript", "add reusable plugin examples"]
}
```

```json
{
  "path": "examples/tetherscript/pr_summary.tether",
  "hook": "checklist",
  "args": ["manual smoke tests", "updated examples README"]
}
```

## Release note

```json
{
  "path": "examples/tetherscript/release_note.tether",
  "hook": "summarize",
  "args": ["1.2.3", "Added TetherScript examples"]
}
```

## LM Studio Gemma helper

Call a local LM Studio Gemma model without changing Rust code:

```json
{
  "path": "examples/tetherscript/lmstudio_gemma.tether",
  "hook": "chat",
  "args": ["hello", "gemma"]
}
```

For a LAN-hosted LM Studio server, call `chat_at` with the base URL:

```json
{
  "path": "examples/tetherscript/lmstudio_gemma.tether",
  "hook": "chat_at",
  "args": ["hello", "gemma", "http://192.168.50.x:1234"]
}
```

This is a TetherScript plugin helper, not a `ProviderRegistry` entry.

## Language features (alpha.16)

Use current TetherScript syntax in plugin hooks: mutable bindings, `for x in
iterable`, closures, byte strings, and `Result`/`?` propagation.

```json
{
  "path": "examples/tetherscript/language_features.tether",
  "hook": "summarize",
  "args": ["codetether"]
}
```

## JavaScript evaluation (alpha.8)

Run JavaScript through the built-in zero-dependency interpreter:

```json
{
  "path": "examples/tetherscript/js_eval.tether",
  "hook": "eval",
  "args": ["1 + 2 * 3"]
}
```

```json
{
  "path": "examples/tetherscript/js_eval.tether",
  "hook": "eval_json",
  "args": ["({ name: 'test', count: 42 })"]
}
```

## Headless browser

Render HTML to text, take snapshots, and compute layout — all without a real browser:

```json
{
  "path": "examples/tetherscript/browser_render.tether",
  "hook": "render",
  "args": ["<h1>Hello</h1><p>World</p>"]
}
```

```json
{
  "path": "examples/tetherscript/browser_render.tether",
  "hook": "render_with_css",
  "args": ["<h1>Hello</h1>", "h1 { color: red }"]
}
```

```json
{
  "path": "examples/tetherscript/browser_render.tether",
  "hook": "snapshot",
  "args": ["<div><p>text</p></div>"]
}
```

## DOM querying

Extract text and elements from HTML using CSS selectors:

```json
{
  "path": "examples/tetherscript/browser_dom.tether",
  "hook": "extract_text",
  "args": ["<h1>Title</h1><p>Body text</p>"]
}
```

```json
{
  "path": "examples/tetherscript/browser_dom.tether",
  "hook": "query",
  "args": ["<div class='x'>hi</div>", ".x"]
}
```

## Browser JavaScript runtime

Execute JS with a full DOM (document, window, localStorage, timers):

```json
{
  "path": "examples/tetherscript/browser_js.tether",
  "hook": "eval_js",
  "args": ["<div id='app'></div>", "document.getElementById('app').textContent = 'hello'"]
}
```

```json
{
  "path": "examples/tetherscript/browser_js.tether",
  "hook": "run_scripts",
  "args": ["<script>console.log('hi')</script><p>done</p>"]
}
```

```json
{
  "path": "examples/tetherscript/browser_js.tether",
  "hook": "compat",
  "args": []
}
```

### Interactive page with JS + rendered output

```json
{
  "path": "examples/tetherscript/browser_js.tether",
  "hook": "interactive",
  "args": ["<div id='out'></div>", "document.getElementById('out').textContent = Date.now()"]
}
```

## Live browser (alpha.10)

Drive a real browser through CodeTether's browserctl bridge. Requires
`grant_browser` with an active browser session endpoint:

```json
{
  "path": "examples/tetherscript/browser_agentic_debug.tether",
  "hook": "verify_checkout",
  "args": ["http://localhost:5173"],
  "grant_browser": "http://127.0.0.1:41707/browser",
  "browser_origin": ["http://localhost:5173"],
  "browser_scope": ["browser.navigate", "browser.interact"]
}
```

See `docs/browser-capability-api.md` for the full method reference.

## Podcast upload path

When the public podcast site/API is down, publish a pre-generated episode by
writing podcast metadata and RSS directly through TetherScript:

```json
{
  "path": "examples/tetherscript/podcast_upload_path.tether",
  "hook": "stage_episode",
  "args": [
    "/path/to/podcast",
    "episode-id",
    "Episode Title",
    "Episode description",
    "https://example.com/episode.mp3",
    1785.504,
    "29:45",
    35710605,
    6,
    1,
    "episodes/codetether-radio/script.md"
  ]
}
```