Shapes

Shapes ⌁

Circuitry owns shapes. Zinc stores exact shape bytes and uses confirmed shape facts to walk a run.

circuitry: "0.7.1"
name: cited answer

takes:
  - $question
  - $notes

uses:
  answer:
    takes:
      question: $question
      notes: $notes
    does: |
      Answer from the notes and cite lines.
    gives:
      answer: $answer
      citations: $citations

gives:
  - $answer
  - $citations

◌ Variable visibility

$question  visible across a shape boundary
question   local name inside this shape or part

A part receives only the values its local takes names.

✦ Zinc's role

Zinc:

stores raw shape bytes
confirms the shape
walks uses
stores package request bytes
stores package result bytes

Zinc stores raw shape bytes, package request bytes, and package result bytes. It does not impose JSON, universal types, type labels, or package semantics on shape bytes.

▣ Package software

A part without shape names package software:

uses.answer:
  run: openai-responses.software.responses
  takes:
    question: $question
  gives:
    answer: $answer

A part with shape names another Circuitry file:

uses.search:
  shape: ./search-web.circuitry.yaml
  takes:
    query: $question
  gives:
    sources: $sources