# SPDX-License-Identifier: Apache-2.0
# yaml-language-server: $schema=https://nika.sh/spec/v1/workflow.schema.json
#
# 10 · Compose (the child) — a callable unit.
#
# The second half of lesson 10: a workflow written to be CALLED. Its
# `inputs:` are the parameters a parent may pass, its typed `outputs:` are
# the whole surface a parent can read — nothing else crosses the wall.
# Read `10-compose-pipeline.nika.yaml` first; it invokes this file.
#
# Demonstrates ·
#   - the callable contract · `inputs:` in, typed `outputs:` out
#   - a child declares its OWN `permits:` · an absent block is the declared
#     zero (NEP-0003) — a parent's grants NEVER descend implicitly, so this
#     file says `permits: {}` itself, and would still have to name every
#     effect it dared to make
#
# Run · nika run examples/10-compose-child.nika.yaml --var topic="the DAG"
#   (standalone run · the parent passes `topic` through `args:` instead)

nika: v1
workflow:
  id: compose-child

model: mock/echo   # the dry twin · the parent's run stays offline too

# The child's OWN boundary. Composition confines every child effect to
# `parent ∩ child-declared` — an empty child boundary means there is
# nothing to confine, and a child that fetched or wrote with this block
# empty would be `NIKA-COMP-002` at the parent's check.
permits: {}

inputs:
  topic:
    # The `default:` is what keeps the standalone run flag-free (04's
    # rule); a calling parent overrides it through `args:` every time.
    type: string
    default: "the DAG"
    required: true
    description: "What to brief · supplied by the caller through `args:`"

tasks:
  brief:
    infer:
      prompt: "Write a two-sentence brief on · ${{ inputs.topic }}"
      max_tokens: 512

outputs:
  summary:
    value: ${{ tasks.brief.output }}
    type: string
    description: "The brief · the ONE thing a caller can read from this file"

the path · 10

Compose (the child) — a callable unit.

run itnika try 10-compose-child

10-compose-child.nika.yaml

1# SPDX-License-Identifier: Apache-2.02# yaml-language-server: $schema=https://nika.sh/spec/v1/workflow.schema.json3#4# 10 · Compose (the child) — a callable unit.5#6# The second half of lesson 10: a workflow written to be CALLED. Its7# `inputs:` are the parameters a parent may pass, its typed `outputs:` are8# the whole surface a parent can read — nothing else crosses the wall.9# Read `10-compose-pipeline.nika.yaml` first; it invokes this file.10#11# Demonstrates ·12#   - the callable contract · `inputs:` in, typed `outputs:` out13#   - a child declares its OWN `permits:` · an absent block is the declared14#     zero (NEP-0003) — a parent's grants NEVER descend implicitly, so this15#     file says `permits: {}` itself, and would still have to name every16#     effect it dared to make17#18# Run · nika run examples/10-compose-child.nika.yaml --var topic="the DAG"19#   (standalone run · the parent passes `topic` through `args:` instead)2021nika: v122workflow:23  id: compose-child2425model: mock/echo   # the dry twin · the parent's run stays offline too2627# The child's OWN boundary. Composition confines every child effect to28# `parent ∩ child-declared` — an empty child boundary means there is29# nothing to confine, and a child that fetched or wrote with this block30# empty would be `NIKA-COMP-002` at the parent's check.31⛨permits: {}3233inputs:34  topic:35    # The `default:` is what keeps the standalone run flag-free (04's36    # rule); a calling parent overrides it through `args:` every time.37    type: string38    default: "the DAG"39    required: true40    description: "What to brief · supplied by the caller through `args:`"4142tasks:43  brief:44    ◇infer:45      prompt: "Write a two-sentence brief on · ${{ inputs.topic }}"46      max_tokens: 5124748outputs:49  summary:50    value: ${{ tasks.brief.output }}51    type: string52    description: "The brief · the ONE thing a caller can read from this file"53

nika-spec@6ac29351a · sha256 54f58d546e20c075…