@lotics/cli 0.321.23 → 0.321.24
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/docs/workflow_steps.md
CHANGED
|
@@ -861,7 +861,7 @@ above. A provider's refusal carries the provider's own words.
|
|
|
861
861
|
### drive_import_file (workflow step)
|
|
862
862
|
|
|
863
863
|
- Import a Google Drive file into the workspace as a Lotics file, and return its file id.
|
|
864
|
-
- Google Docs arrive as .docx, Sheets as .xlsx, Slides as .pptx; everything else transfers unchanged. **This is also how you READ a Drive file.** There is no separate Drive read tool: import the file, then use `view_files` on the returned id. (chat
|
|
864
|
+
- Google Docs arrive as .docx, Sheets as .xlsx, Slides as .pptx; everything else transfers unchanged. **This is also how you READ a Drive file.** There is no separate Drive read tool: import the file, then use `view_files` on the returned id. (chat)
|
|
865
865
|
- That path handles scanned documents — a photographed B/L or a stamped invoice inside a .docx reaches the model as a picture.
|
|
866
866
|
- Exporting Drive content as plain text would return an empty document for exactly those files.
|
|
867
867
|
- Folders, Forms, shortcuts and other Drive items with no file form cannot be imported.
|
|
@@ -877,7 +877,7 @@ above. A provider's refusal carries the provider's own words.
|
|
|
877
877
|
|
|
878
878
|
| Name | Type | Required | What it is |
|
|
879
879
|
| --- | --- | --- | --- |
|
|
880
|
-
| `id` | string | yes | Lotics file ID — pass this to view_files to read the contents (chat
|
|
880
|
+
| `id` | string | yes | Lotics file ID — pass this to view_files to read the contents (chat) |
|
|
881
881
|
| `filename` | string | yes | |
|
|
882
882
|
| `mime_type` | string | yes | |
|
|
883
883
|
| `url` | string | yes | |
|
|
@@ -2278,7 +2278,7 @@ above. A provider's refusal carries the provider's own words.
|
|
|
2278
2278
|
### gmail_read_email (workflow step)
|
|
2279
2279
|
|
|
2280
2280
|
- Fetch a Gmail message's body and the list of its attachments.
|
|
2281
|
-
- Attachments are stored as workspace files — the result names each one's file_id; read one with view_files, attach one to a record with update_records. (chat
|
|
2281
|
+
- Attachments are stored as workspace files — the result names each one's file_id; read one with view_files, attach one to a record with update_records. (chat)
|
|
2282
2282
|
|
|
2283
2283
|
**Inputs**
|
|
2284
2284
|
|
|
@@ -2313,7 +2313,7 @@ above. A provider's refusal carries the provider's own words.
|
|
|
2313
2313
|
| `message.attachments[].filename` | string | yes | Attachment filename as stored, which may differ from the sender's |
|
|
2314
2314
|
| `message.attachments[].mimeType` | string | yes | MIME type as stored, recovered from the filename when the sender declared a generic one |
|
|
2315
2315
|
| `message.attachments[].attachmentId` | string | yes | Gmail attachment ID |
|
|
2316
|
-
| `message.attachments[].file_id` | string | | Stored file ID — pass to view_files to read it, or to update_records to attach it (chat
|
|
2316
|
+
| `message.attachments[].file_id` | string | | Stored file ID — pass to view_files to read it, or to update_records to attach it (chat) |
|
|
2317
2317
|
| `message.attachments[].size` | number | | Stored size in bytes |
|
|
2318
2318
|
|
|
2319
2319
|
### gmail_reply_email (workflow step)
|
|
@@ -3668,7 +3668,7 @@ above. A provider's refusal carries the provider's own words.
|
|
|
3668
3668
|
### outlook_read_email (workflow step)
|
|
3669
3669
|
|
|
3670
3670
|
- Fetch an Outlook email's body and the list of its attachments.
|
|
3671
|
-
- Attachments are stored as workspace files — the result names each one's file_id; read one with view_files, attach one to a record with update_records. (chat
|
|
3671
|
+
- Attachments are stored as workspace files — the result names each one's file_id; read one with view_files, attach one to a record with update_records. (chat)
|
|
3672
3672
|
|
|
3673
3673
|
**Inputs**
|
|
3674
3674
|
|
|
@@ -3706,7 +3706,7 @@ above. A provider's refusal carries the provider's own words.
|
|
|
3706
3706
|
| `message.attachments[].fileName` | string | | Attachment filename as stored, which may differ from the sender's |
|
|
3707
3707
|
| `message.attachments[].contentType` | string | | MIME type as stored, recovered from the filename when Graph declared a generic one |
|
|
3708
3708
|
| `message.attachments[].size` | number | | Stored size in bytes |
|
|
3709
|
-
| `message.attachments[].file_id` | string | | Stored file ID — pass to view_files to read it, or to update_records to attach it (chat
|
|
3709
|
+
| `message.attachments[].file_id` | string | | Stored file ID — pass to view_files to read it, or to update_records to attach it (chat) |
|
|
3710
3710
|
|
|
3711
3711
|
### outlook_reply_email (workflow step)
|
|
3712
3712
|
|
|
@@ -7,7 +7,7 @@ Once tables and apps exist, an agent does the team's work through them. The mean
|
|
|
7
7
|
| A business operation: move an order on, issue a paper, notify someone | `run_app_workflow` on the app's act, `act_<key>` | The outcome equals a person's press: status, stamps, documents, notifications. `update_records` on an act's field skips all of them. |
|
|
8
8
|
| Data entry, a correction, loading the owner's lists | `create_records`, `update_records` | The table's rules hold for every writer. |
|
|
9
9
|
| A rule or policy the business wrote | `get_workspace` with `search`, then `read_knowledge` | The business's own words, not a guess. |
|
|
10
|
-
| A file someone hands over | `
|
|
10
|
+
| A file someone hands over | `upload_file` to keep it; `download_file`, or `lotics file download <file_id>` on the CLI, to take one out | The upload files it in the workspace; the download hands you the file to open with your own tools. When your host passes no bytes, `upload_file` with `person: true` gives the person a link to drop it on. |
|
|
11
11
|
| A paper an app makes | the act that makes it, which files it on the record | `generate_document` makes an unattached file, for a paper no app makes. |
|
|
12
12
|
| A connected service (KiotViet, MISA, a carrier) | a workflow step, reached through a Workflow node | No tool calls a service directly (`workflows/reaching-a-connected-service`). |
|
|
13
13
|
| A figure or list the business defines, or an operation it repeats | the app's declared Query or Workflow node: `run_app_query`, `run_app_workflow` | The node is the business's own definition, found by `get_workspace` with `search` and read in `get_app`. |
|
|
@@ -45,7 +45,7 @@ A write is put back by writing the value `query_audit_logs` shows before the cha
|
|
|
45
45
|
|
|
46
46
|
## Files
|
|
47
47
|
|
|
48
|
-
`
|
|
48
|
+
`download_file` returns a `download_url` and, over MCP, the file itself as an embedded resource up to 12 MB (`bytes_omitted` says why it is absent). On the CLI, fetch the `download_url` or run `lotics file download <file_id>`. Open the file with your own tools. In the in-product chat the `download_url` is the stable address a signed-in member opens, so it is for the person, not a link a tool fetches.
|
|
49
49
|
|
|
50
50
|
`upload_file` names one source:
|
|
51
51
|
|