Herdr SDK
Use @herdr/sdk from dmmulroy/herdr-ts-sdk
for Effect integrations. Prefer its supported operations over hand-written socket
clients or CLI wrappers. Use the separate herdr skill when operating terminals,
panes, tabs, or workspaces as an agent.
- Read current docs first. Read the upstream README and package metadata. Follow their current installation and compatibility guidance; do not assume registry availability or reuse remembered API signatures.
- Check the consumer. Inspect its manifest, lockfile, installed SDK and Effect packages, overrides, and patches. Establish the resolved SDK revision, public exports, and runtime/Herdr protocol requirements before choosing APIs. Treat declarations or lock entries as unverified installations when packages are absent.
- Resolve differences at source. Compare current docs with the installed revision's public source and declarations. Use contracts supported by that consumer; make any required dependency upgrade explicit. Retrieve examples from upstream instead of keeping a copied API reference here.
- Keep the integration Effect-native. Apply the
effectskill alongside the SDK docs. Compose SDK services and layers at the application boundary, preserve typed failures, and keep streams and resources within their owning scope. - Verify the change. Run the consumer's typecheck and relevant tests against its resolved packages. For live checks, target the intended Herdr server and exercise the changed operation and resource cleanup. Report checked revisions, docs used, and any verification blocked by unavailable dependencies or runtime.