@lotics/cli 0.307.1 → 0.309.0

package/docs/agent_surface.md

@@ -229,7 +229,7 @@ a reading's `alias` take no name the app generates (`lotics docs model/app.gener
 ```
 
 `lotics run set_app_workflow` sets its body (`lotics docs workflows`). A query set on a model's app outside
-the model (`set_app_queries`) is removed by the next apply, whose plan and answer note it; declared under
+the model (`set_app_queries`, on the CLI or in chat) is removed by the next apply, whose plan and answer note it; declared under
 its alias in `queries`, it is the model's. A caller sees the description and
 each input's `description` and nothing else, so each says what the value is and what leaving it out means;
 `check_model` notes one that says nothing.

package/docs/app_bindings.md

@@ -5,15 +5,15 @@ under an alias — a JS identifier (`/^[a-zA-Z_$][a-zA-Z0-9_$]*$/`):
 
 | Binding | Declared with | The app calls it with | An agent calls it with |
 |---|---|---|---|
-| Query | `set_app_queries` | `useQuery("<alias>", params?)` | `run_app_query` |
+| Query | `set_app_queries` (CLI, chat) | `useQuery("<alias>", params?)` | `run_app_query` |
 | Workflow | `set_app_workflow` | `useWorkflow("<alias>")({ ...inputs })` | `run_app_workflow` |
-| Agent | `set_app_agent` | `useAgentRun("<alias>")({ ...inputs })` | — |
+| Agent | `set_app_agent` (CLI, chat) | `useAgentRun("<alias>")({ ...inputs })` | — |
 
 Each runs under the app's authority (`{ type: "app", app_id }`), the app owner's reach — never the
 calling member's. Declaring one needs the app's owner or an admin. A write is live: the app's next
 call uses it. `get_app_capabilities` lists an app's aliases with their params and inputs.
 
-Each reader returns a fingerprint of what it read — `get_app_query`'s `sha`, `get_app_workflow`'s
+On the CLI and in chat, each reader returns a fingerprint of what it read — `get_app_query`'s `sha`, `get_app_workflow`'s
 `body_sha`, `get_app_agent`'s `instructions_sha` — and a write built on that read passes it back:
 `set_app_queries`' `expected_shas` (alias → `sha`), `set_app_workflow`'s `expected_body_sha`,
 `set_app_agent`'s `expected_instructions_sha`, `remove_app_binding`'s `expected_sha`. The write is
@@ -38,7 +38,7 @@ A save checks what a deploy checks: every table is in this workspace and within
 every projected, filtered and sorted field resolves, every param token is declared, and a key a
 node's kind does not take (a stray `sort`, `limit`, `filter`, `search`) is refused by name.
 
-`set_app_queries` takes `{ <alias>: <declaration> }`, one alias or several, and merges each: send
+On the CLI and in chat, `set_app_queries` takes `{ <alias>: <declaration> }`, one alias or several, and merges each: send
 only the fields you change, `null` clears `params`, `description` or `templates` (never `ast`), and a
 new alias needs an `ast`. Any other field is refused by name. An alias it omits is kept.
 `remove_app_binding` with `kind: "query"` deletes one; `get_app_query` reads one back.
@@ -146,13 +146,15 @@ refused as an alias the app does not have.
 - A call whose payload does not match `inputs` is refused before the body runs.
 
 `get_app_workflow` reads the body back; `dry_run_workflow` with `trigger_type: "app_workflow"`
-runs it against sample inputs before binding; `remove_app_binding` with `kind: "workflow"` unbinds
-it.
+runs it against sample inputs before binding; on the CLI and in chat, `remove_app_binding` with
+`kind: "workflow"` unbinds it.
 
 ## Agents
 
-`set_app_agent` binds a streaming tool-loop agent to an alias. A run streams its work to the app,
-returns a typed result and keeps a run history per session. The declaration:
+On the CLI and in chat, `set_app_agent` binds a streaming tool-loop agent to an alias. A run streams its work to the app,
+returns a typed result and keeps a run history per session.
+
+The declaration:
 
 - `instructions` — the task, every run. A new alias needs it.
 - `tool_names` — the tools it may call, from these and no other: `analyze_pdf_template`,
@@ -189,4 +191,4 @@ returns a typed result and keeps a run history per session. The declaration:
   table. A result that validates is written to that row under the app's authority.
 
 Send only what you change: an omitted field keeps its stored value, `null` clears an optional one.
-`get_app_agent` reads one back; `remove_app_binding` with `kind: "agent"` deletes it.
+On the CLI and in chat, `get_app_agent` reads one back; `remove_app_binding` with `kind: "agent"` deletes it.

package/docs/workflow_steps.md

@@ -47,7 +47,7 @@ above. A provider's refusal carries the provider's own words.
 ### bkav_cancel_invoices (workflow step)
 
 - Cancel issued invoices.
-- A cancelled invoice still reports to the tax authority; correcting one instead is a replacement or adjustment through bkav_submit_invoices. (workflow step)
+- A cancelled invoice still reports to the tax authority; correcting one instead is a replacement or adjustment through bkav_submit_invoices. (workflow step, chat)
 
 **Inputs**
 
@@ -1069,7 +1069,7 @@ above. A provider's refusal carries the provider's own words.
 ### facebook_list_comments (workflow step)
 
 - Read the most recent comments left on a Facebook Page's posts.
-- Reply with facebook_reply_to_comment, passing the comment_id. (workflow step)
+- Reply with facebook_reply_to_comment, passing the comment_id. (workflow step, chat)
 
 **Inputs**
 
@@ -1094,7 +1094,7 @@ above. A provider's refusal carries the provider's own words.
 ### facebook_list_conversations (workflow step)
 
 - Read a Facebook Page's Messenger conversations with their recent messages.
-- Answer someone with facebook_send_message, passing the person_id. (workflow step)
+- Answer someone with facebook_send_message, passing the person_id. (workflow step, chat)
 
 **Inputs**
 
@@ -1129,7 +1129,7 @@ above. A provider's refusal carries the provider's own words.
 | --- | --- | --- | --- |
 | `connected_account_id` | string | yes |  |
 | `page_id` | string | yes | The page that owns the post the comment is on. |
-| `comment_id` | string | yes | From facebook_list_comments. (workflow step) |
+| `comment_id` | string | yes | From facebook_list_comments. (workflow step, chat) |
 | `message` | string | yes |  |
 
 **Answer**
@@ -1149,7 +1149,7 @@ above. A provider's refusal carries the provider's own words.
 | --- | --- | --- | --- |
 | `connected_account_id` | string | yes |  |
 | `page_id` | string | yes | The page the person wrote to. |
-| `person_id` | string | yes | From facebook_list_conversations. Page-scoped to this page. (workflow step) |
+| `person_id` | string | yes | From facebook_list_conversations. Page-scoped to this page. (workflow step, chat) |
 | `message` | string | yes |  |
 
 **Answer**
@@ -1187,8 +1187,8 @@ above. A provider's refusal carries the provider's own words.
 | Name | Type | Required | What it is |
 | --- | --- | --- | --- |
 | `connected_account_id` | string | yes | FedEx connected account |
-| `reference` | string | yes | The draft's reference (Open Ship index) from fedex_create_draft_shipment (workflow step) |
-| `master_tracking_number` | string |  | The master_tracking_number returned by fedex_create_draft_shipment — required to finalize the label (workflow step) |
+| `reference` | string | yes | The draft's reference (Open Ship index) from fedex_create_draft_shipment (workflow step, chat) |
+| `master_tracking_number` | string |  | The master_tracking_number returned by fedex_create_draft_shipment — required to finalize the label (workflow step, chat) |
 
 **Answer**
 
@@ -1201,7 +1201,7 @@ above. A provider's refusal carries the provider's own words.
 ### fedex_create_draft_shipment (workflow step)
 
 - Create a FedEx draft (Open Ship) booking — no label yet.
-- Confirm later with fedex_confirm_shipment. reference is a unique key you choose (e.g. the shipment order number) used to confirm or cancel. (workflow step)
+- Confirm later with fedex_confirm_shipment. reference is a unique key you choose (e.g. the shipment order number) used to confirm or cancel. (workflow step, chat)
 - Supports multiple packages, special services, and (international) customs commodities.
 
 **Inputs**
@@ -1261,7 +1261,7 @@ above. A provider's refusal carries the provider's own words.
 | --- | --- | --- | --- |
 | `reference` | string | yes |  |
 | `status` | "draft" | yes |  |
-| `master_tracking_number` | string |  | Pass this to fedex_confirm_shipment to finalize the draft (workflow step) |
+| `master_tracking_number` | string |  | Pass this to fedex_confirm_shipment to finalize the draft (workflow step, chat) |
 
 ### fedex_create_shipment (workflow step)
 
@@ -2701,7 +2701,7 @@ above. A provider's refusal carries the provider's own words.
 
 ### misa_save_bank_voucher (workflow step)
 
-- Push a bank voucher (deposit / withdrawal / transfer) into MISA AMIS. voucher_type: 1 deposit (báo có), 3 withdrawal/debit-advice (báo nợ), 2 internal transfer. bank_account_id is the company-side bank account GUID — look it up with misa_get_dictionary (data_type 8). (workflow step)
+- Push a bank voucher (deposit / withdrawal / transfer) into MISA AMIS. voucher_type: 1 deposit (báo có), 3 withdrawal/debit-advice (báo nợ), 2 internal transfer. bank_account_id is the company-side bank account GUID — look it up with misa_get_dictionary (data_type 8). (workflow step, chat)
 
 **Inputs**
 
@@ -2722,7 +2722,7 @@ above. A provider's refusal carries the provider's own words.
 | `custom_field3` | string |  |  |
 | `custom_field4` | string |  |  |
 | `custom_field5` | string |  |  |
-| `bank_account_id` | string | yes | Bank account GUID in MISA — look up via misa_get_dictionary (workflow step) |
+| `bank_account_id` | string | yes | Bank account GUID in MISA — look up via misa_get_dictionary (workflow step, chat) |
 | `account_object_code` | string |  |  |
 | `account_object_name` | string |  |  |
 | `total_amount_oc` | number | yes |  |
@@ -2885,7 +2885,7 @@ above. A provider's refusal carries the provider's own words.
 
 ### misa_save_sales_voucher (workflow step)
 
-- Push a sales voucher (invoice / sales return / discount-credit-note / sales order) into MISA AMIS. voucher_type: 11 invoice, 13 sales voucher, 12 return, 10 discount/credit note, 20 sales order. reftype refines the sub-type (e.g. 3530 unpaid sale, 3560 sales invoice, 3571 service cash). account_object_code identifies the customer in MISA — must already exist (use misa_save_dictionary first if not). (workflow step)
+- Push a sales voucher (invoice / sales return / discount-credit-note / sales order) into MISA AMIS. voucher_type: 11 invoice, 13 sales voucher, 12 return, 10 discount/credit note, 20 sales order. reftype refines the sub-type (e.g. 3530 unpaid sale, 3560 sales invoice, 3571 service cash). account_object_code identifies the customer in MISA — must already exist (use misa_save_dictionary first if not). (workflow step, chat)
 - MISA sync ack only confirms queueing; final accept/reject arrives async on the registered callback URL.
 
 **Inputs**

package/docs/workflows.md

@@ -62,8 +62,8 @@ await send_email({
 | validate | `validate({ checks: [{ fail_when: <expr>, field_key: "...", message: <expr> }, ...] });` |
 
 Every step's inputs, the values each takes and its answer: `lotics tools <name>` prints them; the steps only a body
-runs — a connection's, a mail's — are all in `workflow_steps`. `query_integration_tools` lists the workspace's
-connections and the steps each opens.
+runs — a connection's, a mail's — are all in `workflow_steps`. A person connects a service in Lotics under
+Settings → Connections; a step names that connection by its `connected_account_id`.
 
 `return` is a call, not a JavaScript `return` statement. `validate` ends the workflow with an error
 when a check's `fail_when` is truthy; the check's `field_key` names the control its message lands on —

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.307.1",
+  "version": "0.309.0",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {