Skip to content

docs(readme): registry install and current public API (CL-8775) - #20

Merged
TheGreatAxios merged 5 commits into
mainfrom
cl-8775-readme-artifacts
Sep 22, 2026
Merged

TheGreatAxios merged 5 commits into
mainfrom
cl-8775-readme-artifacts

Conversation

@TheGreatAxios

@TheGreatAxios TheGreatAxios commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Rewrites the Quickstart to model real host usage instead of an in-process demo.

Three sections, in mount order:

  1. Hub-side, tenant-scoped (mountArtifacts) — wiring function takes db, grantStore, conditionRegistry, and optional countSegments as typed parameters and builds requireGrant with Interchange's own createRequireGrant.
  2. Hub-side, run-scoped (mountWorkflowArtifacts) — wiring function takes db, resolveRunScope (WorkflowRunResolver), and optional agentToken (AgentTokenAuth) as typed parameters; no fake auth implementation.
  3. Agent/tool side (@corbits/artifacts/sidecar-bundle) — shows the artifacts tool factory dropped straight into defineAgent's tools, matching how an agent package consumes this package with no client code of its own.

Removed: the in-process demo requireGrant that let every caller through, and the demo resolveRunScope that accepted any bearer as a hardcoded tenant. Every host-owned dependency (db, grant store, condition registry, run resolver, agent token verifier) is now a typed parameter, not a fabricated stand-in.

Every code block was pasted into a scratch file and type-checked against this repo's own tsc (with a temporary paths mapping to self-resolve @corbits/artifacts); all three compile clean. Scratch files were not committed.

Registry install (npm/pnpm/yarn/bun) is the primary path.
Document the current public API. Fixes CL-8775.
Use Quickstart / How it works / Development / License instead of
Install / Use / Full example / Contributing.
@TheGreatAxios
TheGreatAxios merged commit 24808d4 into main Sep 22, 2026
1 check passed
@TheGreatAxios
TheGreatAxios deleted the cl-8775-readme-artifacts branch September 22, 2026 05:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant