Packages

Packages

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

Zinc installs a package root, records its URI, and invokes named surfaces.

Manifest

name: openai-responses
about: OpenAI Responses model package.
uri: git+https://github.com/darkhorseprojects/darkhorseprojects-packages.git@openai-responses-v0.4.4//openai-responses

neighbors:
  unix-bash: git+https://github.com/darkhorseprojects/darkhorseprojects-packages.git@unix-bash-v0.2.4//unix-bash

surfaces:
  responses:
    about: Produce model text and requested named outputs.
    python: surfaces/responses.py

Zinc types only:

name
uri
surfaces

The package version comes from the URI tag. Do not include version in the manifest.

Surfaces

surfaces:
  bash:
    about: Run one Bash command through package policy.
    python: surfaces/run.py

Surface refs are dot-shaped:

unix-bash.bash
openai-responses.responses

See Package Surfaces.

Neighbors

neighbors is package-owned data. Zinc does not parse, resolve, install, update, or order from it.

zn read zinc://packages/openai-responses/manifest/neighbors

Package material

Manifest data and package files are readable:

zn read zinc://packages/openai-responses/manifest/surfaces/responses
zn read zinc://packages/openai-responses/files/surfaces/responses.py

Zinc records the root and URI. It does not copy every package file into the database.