Plan 1 of a series: full aai init machinery (picker, scaffold, runner,
step output, packaging) plus the transcribe template as a complete
vertical slice. stream/agent/llm templates are sibling follow-on plans.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…ct tests

Review found aai.Transcript.get_by_id() blocks (wait_for_completion), which
breaks the submit+poll design on serverless. Switch the status endpoint to
the SDK's non-blocking api.get_transcript, strengthen the transcribe tests,
and add a parametrized cross-template contract test (Task 10).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…PE_CHECKING Traversable

templates/ has no __init__.py so resources.files() must navigate from the
aai_cli.init package. Keep requires-python>=3.10 (TYPE_CHECKING import keeps
it clean). Verified runtime 3.11 + mypy --python-version 3.10.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…ranscribe)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…egister

Adds `aai init [TEMPLATE] [DIRECTORY]` Typer command that scaffolds a project
from a template, optionally installs deps, launches the dev server, and opens
the browser; bare `aai init` with no TTY errors helpfully listing templates.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

… re-exports

The __init__ re-exports were unused and shadowed the scaffold submodule
(forcing a scaffold_fn alias). Import the scaffold module like the other
init submodules and keep __init__ minimal.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…init__, smoke)

Fix stale docstring; sync plan to the accepted deviations (CLIError exit_code=1
matching the samples convention, minimal init/__init__.py, test_smoke update).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Per Daisy's request: discover every template dir and assert required files,
no committed key, front/back route agreement, requirements cover imports,
and no blocking SDK call. Auto-covers future stream/agent/llm templates.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Final-review fixes:
- Registry lists only the transcribe template that actually ships; picking an
  unshipped id now gives a clean error instead of FileNotFoundError. A test
  enforces registry == on-disk template dirs (auto-extends as templates land).
- scaffold._template_root guards a missing dir defensively.
- _pick_template gives a clean message if questionary is missing (stale install)
  instead of a raw ModuleNotFoundError traceback.
- find_free_port raises instead of returning an occupied port when exhausted.
- init propagates the dev-server exit code; rejects DIRECTORY + --here together.
- theme: 'created' renders as success (green).
- Tests for --here, --json, unshipped-template error.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…name

- Rename to 'Transcribe a pre-recorded file' (drop '& explore') in the picker
  title, page, backend docstring, and README.
- Add POST /api/transcribe-url: AssemblyAI transcribes a public URL directly
  (no upload), defaulting to the wildfires sample so the demo works in one click.
- Redesign index.html: URL field pre-filled with the sample + primary Transcribe
  button, file upload as the secondary path; tidier card layout and transcript
  rendering. Still a single, dependency-free HTML file.
- Tests for the URL endpoint (given URL + default-to-sample); contract test
  enforces the new route stays wired to the frontend.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

A sandbox key (minted by 'aai login' against a non-prod env) was rejected by the
template's production default. Now 'aai init' writes ASSEMBLYAI_BASE_URL (the active
environment's api_base) into .env, and the transcribe template applies it via
aai.settings.base_url (defaulting to production when unset). Tests cover scaffold
writing the base URL, the template honoring it, and the command emitting it.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…ights + per-speaker colors

- Results area becomes a tabbed explorer (Transcript · Chapters · Sentiment ·
  Entities · Highlights), showing only tabs that have data. Chapters show
  headline/summary + timestamps; sentiment color-codes POSITIVE/NEGATIVE/NEUTRAL;
  entities group by type; highlights rank key phrases with counts.
- Speakers are differentiated with a per-speaker color (name + left rule) from a
  small palette, in both Transcript and Sentiment views.
- Status messages get state-styled pills (working / done / error).
- Still a single dependency-free HTML file; verified end-to-end in a browser
  against the sandbox sample. Guard test keeps the feature views + speaker
  coloring wired.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Adds an Ask panel that questions the transcript with AssemblyAI's LLM Gateway
(OpenAI-compatible; transcript injected server-side via extra_body transcript_id),
shown alongside the transcript explorer so both stay visible.

- New POST /api/ask endpoint (model claude-haiku-4-5), surfaces gateway errors
  (e.g. plan access) as a clean 502 the UI shows.
- aai init now also writes ASSEMBLYAI_LLM_GATEWAY_URL (active env's gateway) to
  .env; the template honors it, defaulting to production. Adds openai to the
  template requirements.
- Tests: ask endpoint (openai stubbed, asserts transcript_id passed via extra_body),
  scaffold/command write the gateway URL, guard test keeps the Ask panel wired.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…tness)

Correctness:
- Template transcribe/transcribe-url/status endpoints now catch SDK exceptions and
  return a clean 502 instead of a 500 traceback (esp. placeholder/invalid key).
- index.html: poll() failures are caught (no more stuck 'Transcribing…' button);
  speaker colors reset per transcription.
- aai init: when logged out, install runs but a 'launch: skipped — run aai login'
  step is reported instead of exiting silently.
- Template uploads are deleted after submit (no /tmp leak); assemblyai pinned
  (>=0.64,<1) to bound the internal-API surface it uses.

Cleanup / robustness:
- Extract shared aai_cli/steps.py (Step + render_steps(heading=...)); init and
  claude both use it (removes the duplicated TypedDict + render loop).
- init reuses the single has_uv() result for install and launch.
- Template registry guard now enforces both directions (registry <-> shipped dirs).
- Wheel excludes __pycache__/*.pyc so stale bytecode can't ship (verified).

Tests added for the 502 paths, the logged-out launch hint, and the shipped-but-
unregistered guard. 608 passed, ruff + format + mypy clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

- stream: browser captures mic and connects directly to AssemblyAI Streaming v3
  (u3-rt-pro) with a one-time token from /api/token; live partial/final captions.
- agent: browser connects directly to the Voice Agent API (speech->LLM->speech) with
  a Bearer-auth one-time token; mic capture + base64 PCM playback with barge-in.
  Fix: reply.audio carries base64 in the data field (not audio) so TTS now plays;
  resume() the audio contexts in case they start suspended after getUserMedia.
- Generalize scaffold to write the active environment hosts (base/llm/streaming/
  agents) into .env via an env_vars dict; templates honor them, default to production.
- Registry ships transcribe (with built-in LLM chat), stream, agent (no separate
  llm template; that lives in transcribe).
- Tests: token endpoints for stream/agent incl. raw-key vs Bearer auth, reply.audio
  data-field guard; contract suite auto-covers all three templates. 624 passed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>