Packages

Packages

A package is a directory with a zinc.pkg.yaml manifest file.

Manifest

name: openai-responses
version: "0.3.11"
about: OpenAI Responses-shaped model package.

source:
  uri: https://github.com/darkhorseprojects/darkhorseprojects-packages.git
  ref: openai-responses-v0.3.11
  path: openai-responses

links:
  unix-bash: "0.1.3"

software:
  responses: software/responses.py

shapes:
  short_answer: shapes/short-answer.circuitry.yaml

settings:
  models: settings/models.yaml

docs:
  readme: docs/README.md

Recorded facts

Zinc records enough to locate a package and read its manifest:

Field	Purpose
name	Package identifier.
version	Package version string.
root	Installed path on disk.
source.uri	Source URI Zinc can resolve.
source.ref	Source ref Zinc resolves within source.uri.
source.path	Path within the source repository.
links	Optional soft package links Zinc reports but does not install automatically.

Managing packages

zn pkg install ./openai-responses --global
zn pkg list
zn pkg links
zn pkg update openai-responses --dry-run
zn pkg remove openai-responses

Boundary note

Zinc records enough to find a package and read its manifest. The package owns software behavior, settings interpretation, and output schemas.