AGENTS.md
22 lines · 1.5 KB · MarkdownPouch Discovery Package
This Package is the HTTPS bridge for Kody's Pouch. Keep it fork-safe.
Skills
- Resolve the caller's
skillsPackage withkody.packageList({})andkody_id === "skills". - Load
skill-listandskill-getwith a computedimport(specifier)built from that Package's scopedname. - Do not replace the computed import with a static
kody:@cameronpak/skillsimport. A static transitive dependency loses storage provenance when an agent imports this Package and pins forks to Cam's account. - Do not restore
packages.invoke. Kody Gate 2 replaced author-facing invoke with computed imports for runtime package names.
Webhooks
- The Raycast extension uses the
pouchsync,paramswebhook. Its closed operation union delegates only to the five read-only Pouch exports; do not turn it into an arbitrary export router. - Keep the five same-named webhook declarations until installs configured before the one-URL migration have moved to
pouch. New installs mint onlypouch; remove the legacy declarations after that migration window. - A webhook URL is a credential. Owners mint and reveal it only in Package Settings, then store it in a Raycast password preference.
Verify
- Run package checks before publish.
- After publish and mint, use
webhookSyntheticDispatchforpouch, including all five operations. - Smoke-test
list-skillsandget-skillthrough an agent execute import of this Package to catch storage-provenance regressions.