@lunnoa/client 1.1.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -0
- package/dist/cli.js +821 -91
- package/dist/index.cjs +71 -20
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +132 -41
- package/dist/index.d.ts +132 -41
- package/dist/index.js +71 -21
- package/dist/index.js.map +1 -1
- package/dist/react.cjs +70 -22
- package/dist/react.cjs.map +1 -1
- package/dist/react.d.cts +129 -34
- package/dist/react.d.ts +129 -34
- package/dist/react.js +70 -22
- package/dist/react.js.map +1 -1
- package/package.json +1 -1
- package/skills/lunnoa-client/SKILL.md +21 -5
- package/skills/lunnoa-solution-design/SKILL.md +9 -7
package/README.md
CHANGED
|
@@ -113,6 +113,8 @@ Most namespaces map to the Public API surface (`openapi.public.json`):
|
|
|
113
113
|
|
|
114
114
|
`approvals` uses the authenticated **workspace** API (`/api/approvals/...`), not Public API v1. The inbox is filtered to requests where the current user is an eligible approver.
|
|
115
115
|
|
|
116
|
+
`scorecards` also uses the workspace API (`/api/scorecards/...`): `list`, `get`, and `recordValue(measureId, { value, period?, note? })` to push a measure value from your own system (API key needs `scorecard:record`).
|
|
117
|
+
|
|
116
118
|
Errors are `LunnoaApiError` with `status`, `body`, and convenience flags (`isUnauthorized`, `isForbidden`, `isRateLimited`). Paginated lists have async iteration (`entities.iterate(...)`, `queueItems.iterate(...)`).
|
|
117
119
|
|
|
118
120
|
## Worked examples
|
|
@@ -283,6 +285,26 @@ npx @lunnoa/client agents deploy ./agents/triage.ts \
|
|
|
283
285
|
|
|
284
286
|
`defineAction` binds catalogue actions only; toolkit `createAction` is for in-platform apps. See Lunnoa Docs under `guides/develop/client/define`, `runs`, and `cli-deploy`.
|
|
285
287
|
|
|
288
|
+
### CLI discovery
|
|
289
|
+
|
|
290
|
+
Coding agents (and humans) should list the catalogue for a given key instead of guessing action ids. `--json` is the machine-readable form.
|
|
291
|
+
|
|
292
|
+
```bash
|
|
293
|
+
npx @lunnoa/client tools list --url … --api-key lna_… --for-agent --json
|
|
294
|
+
npx @lunnoa/client tools search email --for-agent --json
|
|
295
|
+
npx @lunnoa/client tools get http_action_send-request --json
|
|
296
|
+
npx @lunnoa/client apps list --json
|
|
297
|
+
npx @lunnoa/client apps get http --json
|
|
298
|
+
npx @lunnoa/client connections list --app gmail --json
|
|
299
|
+
npx @lunnoa/client agents list --json
|
|
300
|
+
npx @lunnoa/client workflows list --json
|
|
301
|
+
npx @lunnoa/client entity-types list --json
|
|
302
|
+
npx @lunnoa/client projects list --json
|
|
303
|
+
npx @lunnoa/client features --json
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
`tools list` is compact (`appId`, `actionId`, name, flags). `tools get` prints `inputConfig` and a `defineAction({ id, appId, input })` sketch. Auth flags and `LUNNOA_URL` / `LUNNOA_API_KEY` / `lunnoa.config` work the same as deploy.
|
|
307
|
+
|
|
286
308
|
## Regenerating the API types
|
|
287
309
|
|
|
288
310
|
The generic types are generated from the deployment's public OpenAPI spec (`spec/openapi.public.json`, produced by the platform's `export-openapi --public`):
|