@lunnoa/client 1.0.0 → 1.2.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 CHANGED
@@ -266,7 +266,13 @@ Re-run codegen whenever entity types, workflows, or agents change on the deploym
266
266
 
267
267
  ## Define, run, and CLI deploy
268
268
 
269
- Author local definitions with `defineWorkflow` / `defineAgent`, run linear chains with `lunnoa.runs.start`, and upsert into a project with the CLI (prefer CLI over calling upsert from app code):
269
+ Author local definitions with `defineWorkflow` / `defineAgent` / `defineEntityType`, run linear chains with `lunnoa.runs.start`, and upsert with the CLI (prefer CLI over calling upsert from app code). Entity types are workspace-scoped (no `--project-id`); instance writes reject unknown attribute keys unless `allowUnknownAttributes` is true — use the reserved `extensions` object for flexible bags:
270
+
271
+ ```bash
272
+ npx @lunnoa/client entity-types deploy ./human.ts --url https://lunnoa.example --api-key lna_...
273
+ ```
274
+
275
+ Workflows and agents:
270
276
 
271
277
  ```bash
272
278
  npx @lunnoa/client workflows deploy ./workflows/sync-orders.ts \
@@ -277,6 +283,26 @@ npx @lunnoa/client agents deploy ./agents/triage.ts \
277
283
 
278
284
  `defineAction` binds catalogue actions only; toolkit `createAction` is for in-platform apps. See Lunnoa Docs under `guides/develop/client/define`, `runs`, and `cli-deploy`.
279
285
 
286
+ ### CLI discovery
287
+
288
+ Coding agents (and humans) should list the catalogue for a given key instead of guessing action ids. `--json` is the machine-readable form.
289
+
290
+ ```bash
291
+ npx @lunnoa/client tools list --url … --api-key lna_… --for-agent --json
292
+ npx @lunnoa/client tools search email --for-agent --json
293
+ npx @lunnoa/client tools get http_action_send-request --json
294
+ npx @lunnoa/client apps list --json
295
+ npx @lunnoa/client apps get http --json
296
+ npx @lunnoa/client connections list --app gmail --json
297
+ npx @lunnoa/client agents list --json
298
+ npx @lunnoa/client workflows list --json
299
+ npx @lunnoa/client entity-types list --json
300
+ npx @lunnoa/client projects list --json
301
+ npx @lunnoa/client features --json
302
+ ```
303
+
304
+ `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.
305
+
280
306
  ## Regenerating the API types
281
307
 
282
308
  The generic types are generated from the deployment's public OpenAPI spec (`spec/openapi.public.json`, produced by the platform's `export-openapi --public`):