Shapes

Shapes

A Zinc shape is Circuitry YAML.

Zinc accepts:

.yaml / .yml       plain Circuitry YAML
.md / .markdown   leading YAML front matter

For Markdown, Zinc extracts only the YAML between the opening and closing --- fences.

Example

circuitry: "0.8.2"
name: bash status

in:
  - $command

status:
  surface: unix-bash.bash
  in:
    command: $command
  out:
    output: $output
    exit: $exit

out:
  - $output
  - $exit

Circuitry fields

Circuitry owns:

circuitry
name
about
in
out
$value references

Users may group YAML however they want. There is no required middle section such as steps, flow, nodes, or tasks.

Executable entries

Zinc executes a Circuitry-discovered value-boundary mapping when it has surface.

answer:
  surface: openai-responses.responses
  preserve: true
  model: local-llama
  in:
    question: $question
  out:
    answer: $answer

surface is Zinc navigation. preserve is Zinc storage policy. Other fields are package-owned request fields unless Zinc defines them.

Ready waves

Zinc advances entries whose inputs are available. runtime.parallel limits how many ready entries run together.