# SPDX-License-Identifier: Apache-2.0
# yaml-language-server: $schema=https://nika.sh/spec/v1/workflow.schema.json
#
# 17 · TTS self — the last named showcase debt.
#
# `nika:tts_generate` is the audio graduate (stdlib §Audio). The mock
# provider writes a REAL deterministic WAV, zero network, zero keys —
# the same honesty as `nika:image_generate` `provider: mock` (og-images).
# Audio bytes never ride outputs: path + sha256 + duration_ms do.
#
# Demonstrates ·
#   - `invoke: { tool: nika:tts_generate, args: { provider: mock } }`
#   - `permits.fs.write` covering a DIRECTORY-writing builtin (`**`)
#   - const-fixture assert on the mock contract (provider + wav)
#   - flip ONE line to `local` / `openai` / `elevenlabs` for paid audio
#
# Run · nika try 17-tts-self
#   (offline · mock WAV · zero keys)

nika: tts-self

model: mock/echo

permits:
  tools: ["nika:tts_generate", "nika:assert"]
  fs:
    write: ["out/speech/**"]

tasks:
  speak:
    invoke:
      tool: nika:tts_generate
      args:
        provider: mock
        text: "hello"
        output_dir: out/speech
        metadata: { page_slug: "hello" }
  compiled:
    with:
      shot: ${{ tasks.speak.output }}
    invoke:
      tool: nika:assert
      args:
        condition: ${{ with.shot.provider == "mock" && with.shot.audio.format == "wav" }}
        message: "mock TTS must land a real WAV (bytes stay on disk)"

outputs:
  audio: ${{ tasks.speak.output.audio }}
  manifest: ${{ tasks.speak.output.manifest_path }}

the path · 17

TTS self — the last named showcase debt.

run itnika try 17-tts-self

17-tts-self.nika.yamlsource

1# SPDX-License-Identifier: Apache-2.02# yaml-language-server: $schema=https://nika.sh/spec/v1/workflow.schema.json3#4# 17 · TTS self — the last named showcase debt.5#6# `nika:tts_generate` is the audio graduate (stdlib §Audio). The mock7# provider writes a REAL deterministic WAV, zero network, zero keys —8# the same honesty as `nika:image_generate` `provider: mock` (og-images).9# Audio bytes never ride outputs: path + sha256 + duration_ms do.10#11# Demonstrates ·12#   - `invoke: { tool: nika:tts_generate, args: { provider: mock } }`13#   - `permits.fs.write` covering a DIRECTORY-writing builtin (`**`)14#   - const-fixture assert on the mock contract (provider + wav)15#   - flip ONE line to `local` / `openai` / `elevenlabs` for paid audio16#17# Run · nika try 17-tts-self18#   (offline · mock WAV · zero keys)1920nika: tts-self2122model: mock/echo2324⛨permits:25  ⛨tools: ["nika:tts_generate", "nika:assert"]26  ⛨fs:27    ⛨write: ["out/speech/**"]2829tasks:30  speak:31    ◆invoke:32      tool: nika:tts_generate33      args:34        provider: mock35        text: "hello"36        output_dir: out/speech37        metadata: { page_slug: "hello" }38  compiled:39    with:40      shot: ${{ tasks.speak.output }}41    ◆invoke:42      tool: nika:assert43      args:44        condition: ${{ with.shot.provider == "mock" && with.shot.audio.format == "wav" }}45        message: "mock TTS must land a real WAV (bytes stay on disk)"4647outputs:48  audio: ${{ tasks.speak.output.audio }}49  manifest: ${{ tasks.speak.output.manifest_path }}50

nika-spec@332f5232d · sha256 f85a87e3ac57e03d…