Shapes

Circuitry 0.6.1 Shapes

Zinc runs Circuitry systems.

Circuitry owns:

circuitry
name
about
takes
uses
does
gives
$value references

Zinc owns:

zinc
@package references
model

Complete example

circuitry: "0.6.1"
name: cited research answer
about: Search, read, verify, and answer with citations.

zinc:
  packages:
    browser: zinc://package/browser@0.6.1
    responses: zinc://package/openai-responses@0.1.0

takes:
  $question: text
  $current_date: date

does: |
  Return a grounded answer with citations.

uses:
  search:
    shape: @browser.shapes.search-web
    takes:
      query: $question
      current_date: $current_date
    gives:
      sources: $sources

  draft:
    model: fast
    takes:
      question: $question
      sources: $sources
    does: |
      Draft the answer from the sources.
    gives:
      draft: $draft

  verify:
    model: careful
    takes:
      question: $question
      draft: $draft
      sources: $sources
    does: |
      Check the draft against the sources.
    gives:
      answer: $answer
      confidence: $confidence

gives:
  $answer: text
  $confidence: number

Execution rules

• top-level takes are injected from the command line or host context
• top-level gives are requested outputs
• each uses entry receives only its local takes
• each uses entry produces values listed in its local gives
• Zinc derives dependency order from $ references
• independent ready parts may run concurrently when config allows
• a file with no uses runs as one implicit action-part using the default model preset

Shape references

A part can be inline:

uses:
  summarize:
    takes:
      text: $text
    does: |
      Summarize the text.
    gives:
      summary: $summary

It can reference another Circuitry file:

shape: ./search-web.circuitry.yaml

It can reference a package shape:

shape: @browser.shapes.search-web

If shape and model both appear, model is a Zinc runtime preference for that shape execution.