@kody/openapiFork

@kody/openapi

Intent

Give agents a named bind-and-call surface for OpenAPI 3.x APIs after the platform kody.openapi["name"].operation() capability was removed. Fork this package into the user's account, bind a JSON spec plus auth names, then call selected operations. Bindings live in this package's packageStorage(). YAML specs need a JSON conversion first (@kody/api-research can parse YAML after you fork it).

Prefer community_search for a maintained product helpers package first. Use @kody/api-research when you need registry search, a spec summary, or a scaffolded client. This package does not synthesize search capabilities and never stores raw credentials or widens host approval.

Person accounts cannot import @kody/* live. community_fork this listing, then import the copy (kody:@<username>/openapi/...).

What it does

• Bind a named OpenAPI 3.x JSON spec with a narrow operation selection
• List, get, refresh, or unbind stored bindings in package storage
• Call one bound operation with params / query / headers / body
• Smoke-test storage and selection with an inline ping spec (no live API)

Prerequisites / setup

1. community_fork this listing into the caller's account.
2. Prefer an existing product helpers package via community_search when one exists; use this package for a named bind-and-call snapshot.
3. Auth is names only — integration provider or secret placeholders. Never paste tokens. Host approval for the API base URL still applies on call.
4. YAML specs: convert to JSON first (fork @kody/api-research if needed).

Agents: import paths, smoke checks, and snippets live in AGENTS.md.

Done when

• After fork, smoke-test returns { ok: true } with a selected ping slug
• You can bind → list/get → call (with approved auth + host) → unbind
• No raw credentials appear in storage, README, or chat

Branding

icon.svg is a simple OpenAPI/spec mark for this utility. Keep the MIT license and this Intent section when forking.