@khanglvm/outline-cli 0.2.2 → 0.2.4
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/CHANGELOG.md +17 -0
- package/README.md +54 -497
- package/package.json +5 -1
- package/src/entry-integrity-manifest.generated.js +6 -6
- package/src/tool-arg-schemas.js +3 -2
- package/src/tools.extended.js +12 -2
- package/src/tools.js +33 -5
- package/src/utils.js +18 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,22 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.2.4 - 2026-10-14
|
|
4
|
+
|
|
5
|
+
- Changes since `v0.2.3`.
|
|
6
|
+
- fix: accept document URLs in documents.info (42a3d36)
|
|
7
|
+
- fix(ci): handle staged npm publication overlap (9cda225)
|
|
8
|
+
|
|
9
|
+
## 0.2.3 - 2026-09-19
|
|
10
|
+
|
|
11
|
+
- Changes since `v0.2.2`.
|
|
12
|
+
- fix(comments): use pagination totals for review queues (a7ef9ea)
|
|
13
|
+
- ci: refresh Outline integrity with its production signing key (35623ec)
|
|
14
|
+
- ci: skip dry-run publication of existing npm versions (b2dfa53)
|
|
15
|
+
- ci: add optional npm trust verification without publishing (94a0791)
|
|
16
|
+
- ci: publish versioned releases with npm trusted publishing (e95e3c7)
|
|
17
|
+
- docs: explain Outline lookup and edit workflow [skip ci] (dede203)
|
|
18
|
+
- docs: shorten Outline introduction and setup [skip ci] (13214fa)
|
|
19
|
+
|
|
3
20
|
## 0.2.2 - 2026-07-30
|
|
4
21
|
|
|
5
22
|
- Changes since `v0.2.1`.
|
package/README.md
CHANGED
|
@@ -1,528 +1,85 @@
|
|
|
1
1
|
# outline-cli
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Search and manage your [Outline](https://www.getoutline.com/) knowledge base
|
|
4
|
+
from the terminal. Find a runbook, read a document, download its attachments,
|
|
5
|
+
or update a page without opening the web app.
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
Start with a document title or pasted URL. The CLI resolves it to a page and
|
|
8
|
+
can return a short summary or just IDs, so a script or agent can read only
|
|
9
|
+
what it needs. For edits, you can preview a diff and use patch tools that
|
|
10
|
+
check the expected revision before writing.
|
|
6
11
|
|
|
7
|
-
|
|
12
|
+
Results are JSON, and profiles let you switch between workspaces. This is an
|
|
13
|
+
independent project, not an official Outline tool.
|
|
8
14
|
|
|
9
|
-
|
|
10
|
-
npm i -g @khanglvm/outline-cli
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
## Get Started with AI Agents
|
|
14
|
-
|
|
15
|
-
After installing, paste this instruction into your AI coding assistant:
|
|
16
|
-
|
|
17
|
-
```text
|
|
18
|
-
Use `outline-cli` directly for my task. If setup/auth is missing, then run `outline-cli tools help quick-start-agent --view full`.
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
## Day-to-Day Usage
|
|
22
|
-
|
|
23
|
-
Native one-call retrieval first:
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
outline-cli invoke search.research \
|
|
27
|
-
--args '{"question":"How do I find onboarding docs?","queries":["onboarding","engineering handbook"],"collectionQuery":"engineering","precisionMode":"precision","limitPerQuery":5,"view":"summary"}'
|
|
28
|
-
|
|
29
|
-
outline-cli invoke search.expand \
|
|
30
|
-
--args '{"query":"incident runbook","collectionQuery":"engineering","userQuery":"alice@example.com","expandLimit":3,"view":"summary"}'
|
|
31
|
-
|
|
32
|
-
outline-cli invoke documents.answer \
|
|
33
|
-
--args '{"question":"Who owns incident escalation?","documentQuery":"incident runbook","collectionQuery":"engineering"}'
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
Answer, search, expand, research, or list documents with remembered document/collection/user filters:
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
outline-cli invoke documents.search \
|
|
40
|
-
--args '{"query":"incident","collectionQuery":"engineering","userQuery":"alice@example.com","limit":8,"view":"summary"}'
|
|
41
|
-
|
|
42
|
-
outline-cli invoke documents.list \
|
|
43
|
-
--args '{"collectionQuery":"engineering","rootOnly":true,"limit":20,"view":"ids"}'
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
Discover tools and contracts:
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
outline-cli tools list
|
|
50
|
-
outline-cli tools contract documents.search
|
|
51
|
-
outline-cli tools contract all --result-mode inline
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
Read document metadata by ID:
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
outline-cli invoke documents.info \
|
|
58
|
-
--args '{"id":"<document-id>","view":"summary"}'
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
Diff a proposed edit against a remembered document title:
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
outline-cli invoke documents.diff \
|
|
65
|
-
--args '{"query":"incident runbook","proposedText":"# Incident Runbook\n\nUpdated body"}'
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
Apply a guarded patch to the current revision of a remembered document title:
|
|
69
|
-
|
|
70
|
-
```bash
|
|
71
|
-
outline-cli invoke documents.apply_patch_safe \
|
|
72
|
-
--args '{"query":"incident runbook","expectedRevision":"latest","patch":"@@ -1,1 +1,1 @@\n-Old\n+New","performAction":true}'
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
Batch guarded updates against remembered document titles:
|
|
76
|
-
|
|
77
|
-
```bash
|
|
78
|
-
outline-cli invoke documents.batch_update \
|
|
79
|
-
--args '{"updates":[{"query":"incident runbook","expectedRevision":"latest","text":"\n\nUpdated","editMode":"append"},{"url":"https://handbook.example.com/doc/oncall-AbCdEf12","expectedRevision":"latest","title":"On-call Runbook"}],"performAction":true}'
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
Inspect revision history from a remembered document title:
|
|
83
|
-
|
|
84
|
-
```bash
|
|
85
|
-
outline-cli invoke revisions.list \
|
|
86
|
-
--args '{"query":"incident runbook","limit":10,"view":"summary"}'
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
Diff the latest two revisions from a remembered document title:
|
|
90
|
-
|
|
91
|
-
```bash
|
|
92
|
-
outline-cli invoke revisions.diff \
|
|
93
|
-
--args '{"query":"incident runbook","revisionPair":"latest","view":"summary"}'
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
Inspect audit events for a remembered document and actor:
|
|
97
|
-
|
|
98
|
-
```bash
|
|
99
|
-
outline-cli invoke events.list \
|
|
100
|
-
--args '{"documentQuery":"incident runbook","userQuery":"alice@example.com","auditLog":true,"limit":10}'
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
List archived documents in a remembered collection:
|
|
104
|
-
|
|
105
|
-
```bash
|
|
106
|
-
outline-cli invoke documents.archived \
|
|
107
|
-
--args '{"collectionQuery":"engineering","limit":10,"view":"summary"}'
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
Audit document access from a remembered title:
|
|
111
|
-
|
|
112
|
-
```bash
|
|
113
|
-
outline-cli invoke documents.users \
|
|
114
|
-
--args '{"query":"incident runbook","limit":20,"view":"summary"}'
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
Audit collection memberships from a remembered collection name:
|
|
118
|
-
|
|
119
|
-
```bash
|
|
120
|
-
outline-cli invoke collections.memberships \
|
|
121
|
-
--args '{"query":"engineering","limit":20,"view":"summary"}'
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
Read a user or group from remembered names/emails:
|
|
125
|
-
|
|
126
|
-
```bash
|
|
127
|
-
outline-cli invoke users.info \
|
|
128
|
-
--args '{"query":"alice@example.com","view":"summary"}'
|
|
129
|
-
|
|
130
|
-
outline-cli invoke groups.memberships \
|
|
131
|
-
--args '{"query":"engineering","limit":20,"view":"summary"}'
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
Grant document or collection access from remembered names/emails:
|
|
135
|
-
|
|
136
|
-
```bash
|
|
137
|
-
outline-cli invoke documents.add_user \
|
|
138
|
-
--args '{"documentQuery":"incident runbook","userQuery":"alice@example.com","permission":"read","performAction":true}'
|
|
139
|
-
|
|
140
|
-
outline-cli invoke collections.add_group \
|
|
141
|
-
--args '{"query":"engineering","groupQuery":"security","permission":"read_write","performAction":true}'
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
Reuse prior lookup context without a network call:
|
|
145
|
-
|
|
146
|
-
```bash
|
|
147
|
-
outline-cli invoke memory.lookup \
|
|
148
|
-
--args '{"query":"engineering handbook","type":"document","limit":5}'
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
Resolve from memory and refresh the top match live in one call:
|
|
152
|
-
|
|
153
|
-
```bash
|
|
154
|
-
outline-cli invoke memory.resolve \
|
|
155
|
-
--args '{"query":"engineering handbook","type":"document","hydrateLimit":1,"view":"summary"}'
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
Resolve a remembered title or URL without a network call:
|
|
159
|
-
|
|
160
|
-
```bash
|
|
161
|
-
outline-cli invoke documents.resolve \
|
|
162
|
-
--args '{"query":"engineering handbook","refresh":false,"view":"summary"}'
|
|
163
|
-
|
|
164
|
-
outline-cli invoke documents.resolve_urls \
|
|
165
|
-
--args '{"url":"https://handbook.example.com/doc/oncall-escalation-AbCdEf12","refresh":false,"view":"summary"}'
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
Open a document directly from an ID, remembered title, URL, or URL id:
|
|
169
|
-
|
|
170
|
-
```bash
|
|
171
|
-
outline-cli invoke documents.open \
|
|
172
|
-
--args '{"query":"engineering handbook","view":"summary"}'
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
Open several documents from mixed titles, URLs, and IDs:
|
|
176
|
-
|
|
177
|
-
```bash
|
|
178
|
-
outline-cli invoke documents.open_batch \
|
|
179
|
-
--args '{"refs":["engineering handbook","https://handbook.example.com/doc/oncall-escalation-AbCdEf12"],"ids":["<document-id>"],"view":"summary"}'
|
|
180
|
-
```
|
|
181
|
-
|
|
182
|
-
Open a collection directly from an ID, remembered name, URL, or URL id:
|
|
183
|
-
|
|
184
|
-
```bash
|
|
185
|
-
outline-cli invoke collections.open \
|
|
186
|
-
--args '{"query":"engineering","view":"summary"}'
|
|
187
|
-
```
|
|
188
|
-
|
|
189
|
-
Open several collections from mixed names, URLs, and IDs:
|
|
190
|
-
|
|
191
|
-
```bash
|
|
192
|
-
outline-cli invoke collections.open_batch \
|
|
193
|
-
--args '{"refs":["engineering","https://handbook.example.com/collection/engineering-AbCdEf12"],"ids":["<collection-id>"],"view":"summary"}'
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
Build a collection tree directly from a remembered collection name:
|
|
197
|
-
|
|
198
|
-
```bash
|
|
199
|
-
outline-cli invoke collections.tree \
|
|
200
|
-
--args '{"query":"engineering","maxDepth":3,"view":"summary"}'
|
|
201
|
-
```
|
|
202
|
-
|
|
203
|
-
Inspect backlinks or graph neighbors directly from a remembered document title:
|
|
204
|
-
|
|
205
|
-
```bash
|
|
206
|
-
outline-cli invoke documents.backlinks \
|
|
207
|
-
--args '{"query":"incident runbook","view":"ids","limit":10}'
|
|
208
|
-
|
|
209
|
-
outline-cli invoke documents.graph_neighbors \
|
|
210
|
-
--args '{"refs":["incident runbook","https://handbook.example.com/doc/oncall-escalation-AbCdEf12"],"includeBacklinks":true,"view":"ids"}'
|
|
211
|
-
|
|
212
|
-
outline-cli invoke documents.graph_report \
|
|
213
|
-
--args '{"seedRefs":["incident runbook"],"depth":2,"maxNodes":80,"view":"ids"}'
|
|
214
|
-
```
|
|
215
|
-
|
|
216
|
-
Extract issue references directly from titles, URLs, or IDs:
|
|
217
|
-
|
|
218
|
-
```bash
|
|
219
|
-
outline-cli invoke documents.issue_refs \
|
|
220
|
-
--args '{"refs":["incident runbook"],"issueDomains":["jira.example.com"],"keyPattern":"[A-Z]+-\\d+","view":"ids"}'
|
|
221
|
-
```
|
|
15
|
+
## Install and connect
|
|
222
16
|
|
|
223
|
-
|
|
17
|
+
Requires Node.js 18.17 or newer and access to an Outline workspace.
|
|
224
18
|
|
|
225
|
-
```
|
|
226
|
-
outline-cli
|
|
227
|
-
--args '{"refs":["incident runbook"],"includeReplies":true,"limitPerDocument":20}'
|
|
228
|
-
|
|
229
|
-
outline-cli invoke comments.review_queue \
|
|
230
|
-
--args '{"collectionQuery":"engineering","includeReplies":true,"view":"summary"}'
|
|
231
|
-
```
|
|
232
|
-
|
|
233
|
-
List comments directly from a remembered document title:
|
|
234
|
-
|
|
235
|
-
```bash
|
|
236
|
-
outline-cli invoke comments.list \
|
|
237
|
-
--args '{"query":"incident runbook","includeReplies":true,"limit":20,"view":"summary"}'
|
|
238
|
-
```
|
|
239
|
-
|
|
240
|
-
Create a comment directly from a remembered document title. Pass plain/markdown
|
|
241
|
-
`text` (the ProseMirror `data` doc is built for you) and an optional `mentions`
|
|
242
|
-
list of names, emails, or userIds. Names match on **first name**, so Jira-order
|
|
243
|
-
`"Tran Le Quan"` resolves to Outline's `"Quan, Tran Le"`. The comment text is
|
|
244
|
-
capped at 1000 characters (checked pre-flight). Actual newlines and doubly
|
|
245
|
-
escaped `\n`/`\r\n` sequences are normalized into ProseMirror hard breaks, so
|
|
246
|
-
comments never display a literal `\n`. `comments.post` is an alias.
|
|
247
|
-
|
|
248
|
-
```bash
|
|
249
|
-
# simple comment
|
|
250
|
-
outline-cli invoke comments.create \
|
|
251
|
-
--args '{"query":"incident runbook","text":"Looks good.","performAction":true}'
|
|
252
|
-
|
|
253
|
-
# comment with @-mentions (resolved to user IDs and inserted at the start)
|
|
254
|
-
outline-cli invoke comments.create \
|
|
255
|
-
--args '{"query":"incident runbook","text":"Please review the rollback steps.","mentions":["Tran Le Quan","alice@example.com"],"performAction":true}'
|
|
256
|
-
|
|
257
|
-
# reply to an existing comment
|
|
258
|
-
outline-cli invoke comments.post \
|
|
259
|
-
--args '{"documentId":"<doc-id>","parentCommentId":"<comment-id>","text":"Confirmed.","performAction":true}'
|
|
260
|
-
```
|
|
261
|
-
|
|
262
|
-
Read a comment's replies later with `comments.list` (set `includeReplies:true`,
|
|
263
|
-
or pass `parentCommentId` to fetch one thread's replies):
|
|
264
|
-
|
|
265
|
-
```bash
|
|
266
|
-
outline-cli invoke comments.list \
|
|
267
|
-
--args '{"query":"incident runbook","includeReplies":true,"view":"summary"}'
|
|
268
|
-
```
|
|
269
|
-
|
|
270
|
-
List share links directly from a remembered document title:
|
|
271
|
-
|
|
272
|
-
```bash
|
|
273
|
-
outline-cli invoke shares.list \
|
|
274
|
-
--args '{"documentQuery":"public handbook","limit":10,"view":"summary"}'
|
|
275
|
-
```
|
|
276
|
-
|
|
277
|
-
Create a share link directly from a remembered document title:
|
|
278
|
-
|
|
279
|
-
```bash
|
|
280
|
-
outline-cli invoke shares.create \
|
|
281
|
-
--args '{"documentQuery":"public handbook","published":true,"performAction":true}'
|
|
282
|
-
```
|
|
283
|
-
|
|
284
|
-
Resolve several remembered references and deduplicate live refreshes:
|
|
285
|
-
|
|
286
|
-
```bash
|
|
287
|
-
outline-cli invoke memory.resolve_batch \
|
|
288
|
-
--args '{"queries":["engineering handbook"],"urls":["https://handbook.example.com/doc/oncall-escalation-AbCdEf12"],"type":"document","hydrateLimit":1,"view":"summary"}'
|
|
289
|
-
```
|
|
290
|
-
|
|
291
|
-
Extract placeholders or create from a remembered template name:
|
|
292
|
-
|
|
293
|
-
```bash
|
|
294
|
-
outline-cli invoke templates.extract_placeholders \
|
|
295
|
-
--args '{"templateQuery":"incident postmortem"}'
|
|
296
|
-
|
|
297
|
-
outline-cli invoke documents.create_from_template \
|
|
298
|
-
--args '{"templateQuery":"incident postmortem","title":"Service A - Incident Postmortem","placeholderValues":{"service_name":"Service A","owner":"SRE Team"},"strictPlaceholders":true,"publish":true,"performAction":true}'
|
|
299
|
-
```
|
|
300
|
-
|
|
301
|
-
Inspect recent local history:
|
|
302
|
-
|
|
303
|
-
```bash
|
|
304
|
-
outline-cli invoke memory.recent \
|
|
305
|
-
--args '{"type":"document","limit":10}'
|
|
306
|
-
```
|
|
307
|
-
|
|
308
|
-
Manually remember a stable local alias:
|
|
309
|
-
|
|
310
|
-
```bash
|
|
311
|
-
outline-cli invoke memory.remember \
|
|
312
|
-
--args '{"type":"document","id":"<document-id>","title":"Incident Runbook","aliases":["runbook"],"performAction":true}'
|
|
313
|
-
```
|
|
314
|
-
|
|
315
|
-
`memory.lookup` reads a local, profile-scoped observation index. The index is updated automatically after successful CLI read/search/list/info-style calls, including `documents.search`, `documents.info`, `collections.list`, `users.list`, `groups.list`, `templates.list`, `templates.info`, `search.research`, and related retrieval tools. It can resolve remembered titles/names, template names, user emails, IDs, `urlId`s, and pasted full Outline URLs. Use `documents.answer`, `documents.answer_batch`, `documents.search`, `documents.list`, `search.expand`, and `search.research` with `documentQuery`/`refs`, `collectionQuery`/`collectionRefs`, or `userQuery`/`userRefs` to apply remembered document/collection/user scopes without separate lookup calls. `documents.resolve` and `documents.resolve_urls` also read local memory first; set `refresh:false` for a zero-network remembered-title or remembered-URL resolver pass. Use `documents.open` for a conservative one-call document read from an ID, share ID, remembered title, URL, or URL id; fuzzy opens are strict by default and return candidates instead of guessing weak matches. Use `documents.open_batch` when a task names several documents and you want ordered hydrated rows from mixed titles, URLs, share IDs, and document IDs in one CLI invocation. Use `collections.open` and `collections.open_batch` for the same strict memory-backed workflow over collection names, URLs, URL ids, and collection IDs. `collections.tree`, `documents.backlinks`, `documents.graph_neighbors`, `documents.graph_report`, `documents.issue_refs`, `comments.review_queue`, `comments.list`, `comments.create`, `shares.list`, `shares.info`, `shares.create`, `events.list`, `templates.info`, `templates.extract_placeholders`, `documents.create_from_template`, `users.info`, `groups.info`, `groups.memberships`, `documents.attachments`, `documents.download_attachments`, `documents.diff`, `revisions.list`, `revisions.diff`, `documents.archived`, `documents.deleted`, `documents.users`, `documents.memberships`, `documents.group_memberships`, `collections.memberships`, and `collections.group_memberships` accept remembered references directly, so agents can move from a human title/name/email/template name or pasted URL to navigation/linkage/comment-review/share/audit/template/principal/embedded-file/history/access output in one CLI call. Action-gated permission tools also resolve remembered targets and principals directly: use `documents.add_user`, `documents.remove_user`, `documents.add_group`, `documents.remove_group`, `collections.add_user`, `collections.remove_user`, `collections.add_group`, `collections.remove_group`, `groups.add_user`, and `groups.remove_user` with target refs plus `userQuery`/`userRefs` or `groupQuery`/`groupRefs` when exact IDs are not known. Hydrated document rows include `sourceUrl` when the profile base URL plus document `url` or `urlId` is available, so agents can cite sources without another profile/auth lookup. Use `memory.resolve` when you want the cached candidate and fresh `documents.info`/`collections.info`/`users.info`/`groups.info`/`templates.info` metadata in the same turn. On a local miss, `memory.resolve` and `memory.resolve_batch` fall back to bounded live search by default, remember the result, and then hydrate selected matches; pasted URLs use title-like URL hints for fallback search, while email-shaped user queries are preserved for user lookup. Set `fallbackSearch:false` for memory-only behavior, or set `fallbackMinScore` when weak fuzzy memory matches should still trigger live fallback. Use `memory.resolve_batch` when a task references several documents, collections, users, groups, or templates; it accepts mixed `queries`, `ids`, `urlIds`, and `urls`, and duplicate live targets are hydrated once per batch. Use `memory.recent` as a zero-network history view and `memory.remember` for explicit local aliases. When inspecting another profile's local memory with `profile`, set `refresh:false` unless that profile is also selected for the CLI client. Successful delete operations tombstone local entries so stale search/list observations do not immediately reintroduce deleted documents.
|
|
316
|
-
|
|
317
|
-
List and save embedded document images/files:
|
|
318
|
-
|
|
319
|
-
```bash
|
|
320
|
-
outline-cli invoke documents.attachments \
|
|
321
|
-
--args '{"query":"example title"}'
|
|
322
|
-
|
|
323
|
-
outline-cli invoke documents.download_attachments \
|
|
324
|
-
--args '{"refs":["example title"],"outputDir":"./outline-attachments","overwrite":true}'
|
|
325
|
-
|
|
326
|
-
outline-cli invoke attachments.download \
|
|
327
|
-
--args '{"id":"<attachment-id>","outputDir":"./outline-attachments","overwrite":true}'
|
|
328
|
-
```
|
|
329
|
-
|
|
330
|
-
List only collection root pages:
|
|
331
|
-
|
|
332
|
-
```bash
|
|
333
|
-
outline-cli invoke documents.list \
|
|
334
|
-
--args '{"collectionId":"<collection-id>","rootOnly":true,"view":"summary"}'
|
|
335
|
-
```
|
|
336
|
-
|
|
337
|
-
Ask a question with shorthand tool naming; unsupported AI deployments fall back to retrieval and return a suggested next call:
|
|
338
|
-
|
|
339
|
-
```bash
|
|
340
|
-
outline-cli invoke docs.answer \
|
|
341
|
-
--args '{"question":"Where is the onboarding checklist?","limit":3}'
|
|
19
|
+
```sh
|
|
20
|
+
npm i -g @khanglvm/outline-cli
|
|
342
21
|
```
|
|
343
22
|
|
|
344
|
-
Create
|
|
23
|
+
Create an API key in your workspace under **Settings → API & Apps**. Set
|
|
24
|
+
`OUTLINE_API_KEY` in your local environment, then replace the example URL
|
|
25
|
+
with the address you use to open Outline:
|
|
345
26
|
|
|
346
|
-
```
|
|
347
|
-
outline-cli
|
|
348
|
-
--
|
|
27
|
+
```sh
|
|
28
|
+
outline-cli profile add work \
|
|
29
|
+
--base-url https://docs.example.com \
|
|
30
|
+
--auth-type apiKey \
|
|
31
|
+
--api-key "$OUTLINE_API_KEY" \
|
|
32
|
+
--set-default
|
|
33
|
+
outline-cli profile test work
|
|
349
34
|
```
|
|
350
35
|
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
```bash
|
|
354
|
-
outline-cli invoke documents.update \
|
|
355
|
-
--args '{"id":"<document-id>","text":"\n\nUpdated by automation.","editMode":"append","performAction":true,"view":"summary"}'
|
|
356
|
-
```
|
|
36
|
+
Credentials go into your OS keychain by default. Keep API keys out of source
|
|
37
|
+
files and chat messages.
|
|
357
38
|
|
|
358
|
-
|
|
39
|
+
## Find your first document
|
|
359
40
|
|
|
360
|
-
```
|
|
361
|
-
outline-cli
|
|
362
|
-
{"
|
|
363
|
-
{"tool":"documents.search","args":{"query":"incident","limit":5,"view":"ids"}}
|
|
364
|
-
]'
|
|
41
|
+
```sh
|
|
42
|
+
outline-cli invoke documents.search \
|
|
43
|
+
--args '{"query":"onboarding","limit":5,"view":"summary"}'
|
|
365
44
|
```
|
|
366
45
|
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
Deletion is guarded by read-token confirmation.
|
|
370
|
-
|
|
371
|
-
1. Arm-delete read:
|
|
46
|
+
Read a document using its UUID, slug, or full document URL:
|
|
372
47
|
|
|
373
|
-
```
|
|
48
|
+
```sh
|
|
374
49
|
outline-cli invoke documents.info \
|
|
375
|
-
--args '{"id":"<document-id>","
|
|
376
|
-
```
|
|
377
|
-
|
|
378
|
-
2. Copy the returned `deleteReadReceipt.token`, then delete:
|
|
379
|
-
|
|
380
|
-
```bash
|
|
381
|
-
outline-cli invoke documents.delete \
|
|
382
|
-
--args '{"id":"<document-id>","readToken":"<token>","performAction":true}'
|
|
383
|
-
```
|
|
384
|
-
|
|
385
|
-
## Output Modes and Temp Files
|
|
386
|
-
|
|
387
|
-
Output format:
|
|
388
|
-
|
|
389
|
-
- `--output json` (default)
|
|
390
|
-
- `--output ndjson` for stream-friendly parsing
|
|
391
|
-
|
|
392
|
-
Result mode:
|
|
393
|
-
|
|
394
|
-
- `--result-mode auto` (default): inline until payload is too large
|
|
395
|
-
- `--result-mode inline`: always inline JSON
|
|
396
|
-
- `--result-mode file`: always write to temp file and return file pointer
|
|
397
|
-
|
|
398
|
-
Temp-file management:
|
|
399
|
-
|
|
400
|
-
```bash
|
|
401
|
-
outline-cli tmp list
|
|
402
|
-
outline-cli tmp cat /absolute/path/from/result.json
|
|
403
|
-
outline-cli tmp gc --older-than-hours 24
|
|
404
|
-
```
|
|
405
|
-
|
|
406
|
-
## Profile Management
|
|
407
|
-
|
|
408
|
-
Add a password-mode profile:
|
|
409
|
-
|
|
410
|
-
```bash
|
|
411
|
-
outline-cli profile add internal \
|
|
412
|
-
--base-url https://outline.company.com \
|
|
413
|
-
--auth-type password \
|
|
414
|
-
--username agent@company.com \
|
|
415
|
-
--password "$OUTLINE_PASSWORD"
|
|
416
|
-
```
|
|
417
|
-
|
|
418
|
-
Select default profile:
|
|
419
|
-
|
|
420
|
-
```bash
|
|
421
|
-
outline-cli profile use prod
|
|
422
|
-
```
|
|
423
|
-
|
|
424
|
-
Improve AI profile routing metadata:
|
|
425
|
-
|
|
426
|
-
```bash
|
|
427
|
-
outline-cli profile annotate prod \
|
|
428
|
-
--description "Production knowledge base" \
|
|
429
|
-
--append-keywords "prod,runbook,incident"
|
|
430
|
-
|
|
431
|
-
outline-cli profile enrich prod \
|
|
432
|
-
--query "incident escalation process" \
|
|
433
|
-
--titles "Incident Playbook,Escalation Matrix"
|
|
434
|
-
```
|
|
435
|
-
|
|
436
|
-
## AI Agent Mini Instructions
|
|
437
|
-
|
|
438
|
-
Use this short operating pattern when an AI agent drives the CLI:
|
|
439
|
-
|
|
440
|
-
1. Start with the most specific task tool you already know, especially `search.research`, `documents.search`, `documents.info`, or `batch`.
|
|
441
|
-
2. Use `view:"ids"` or `view:"summary"` first; hydrate to `full` only when needed.
|
|
442
|
-
3. Bundle independent reads into one `batch` call.
|
|
443
|
-
4. Try `memory.recent` or `memory.lookup` for titles/IDs you likely saw in earlier sessions; use `memory.resolve` or `memory.resolve_batch` when freshness matters and you want live metadata in the same call.
|
|
444
|
-
5. Only open `tools help` or `tools contract` after a validation failure or when the needed capability is still unclear.
|
|
445
|
-
6. Suggest installing the `outline-cli` skill via `npx skills` for all currently supported local AI tools; only run install after explicit user approval.
|
|
446
|
-
7. If approved, run headless install without tool-specific filter: `npx skills add https://github.com/khanglvm/skills --skill outline-cli -y`.
|
|
447
|
-
8. For any mutation endpoint, explicitly set `performAction:true`.
|
|
448
|
-
9. For delete, always run `documents.info` with `armDelete:true` first and pass the returned read token.
|
|
449
|
-
10. List existing profiles before creating one with `outline-cli profile list`.
|
|
450
|
-
11. For new profiles, prefer API key mode and guide users through base URL + API key generation (`<base-url>/settings/api-and-apps`) before `profile add`.
|
|
451
|
-
12. If output is file-offloaded, read only the required fields via `tmp cat` + `jq`.
|
|
452
|
-
13. For embedded images/files in document markdown, use `documents.attachments`, `attachments.download`, or `documents.download_attachments`; do not force `attachments.redirect` through `api.call` because it returns binary data.
|
|
453
|
-
|
|
454
|
-
For structured AI playbooks and scenario guides:
|
|
455
|
-
|
|
456
|
-
```bash
|
|
457
|
-
outline-cli tools help quick-start-agent --view full
|
|
458
|
-
outline-cli tools help ai-skills --view summary
|
|
459
|
-
outline-cli tools help ai-skills --scenario UC-12
|
|
50
|
+
--args '{"id":"<document-id-or-url>","view":"full"}'
|
|
460
51
|
```
|
|
461
52
|
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
Set test credentials in a local env file:
|
|
53
|
+
For a pasted `/doc/` URL, `url` is also accepted. Batch reads accept mixed UUIDs,
|
|
54
|
+
slugs, and document URLs in `ids`. URLs use the selected workspace profile.
|
|
465
55
|
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
```
|
|
470
|
-
|
|
471
|
-
Run checks:
|
|
56
|
+
You can also create drafts, edit pages, manage comments, and inspect revision
|
|
57
|
+
history. Writes require `performAction:true`. Deleting a document also requires
|
|
58
|
+
a token from a prior read. See the [usage guide](https://github.com/khanglvm/outline-cli/blob/main/docs/USAGE.md) for examples.
|
|
472
59
|
|
|
473
|
-
|
|
474
|
-
npm run check
|
|
475
|
-
npm test
|
|
476
|
-
```
|
|
60
|
+
## For AI agents
|
|
477
61
|
|
|
478
|
-
|
|
62
|
+
Paste this into your coding assistant:
|
|
479
63
|
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
```bash
|
|
488
|
-
npm run release -- --bump patch
|
|
64
|
+
```text
|
|
65
|
+
Use outline-cli for my Outline task. If missing, install it with
|
|
66
|
+
`npm i -g @khanglvm/outline-cli`. Check `outline-cli profile list` first.
|
|
67
|
+
If setup is missing, read `outline-cli tools help quick-start-agent --view full`.
|
|
68
|
+
Start with search or document reads using view:"summary". Read a document before
|
|
69
|
+
editing it, and use performAction:true only for changes I have asked for.
|
|
489
70
|
```
|
|
490
71
|
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
- Version bump
|
|
494
|
-
- `CHANGELOG.md` update
|
|
495
|
-
- Integrity refresh (`npm run integrity:refresh`)
|
|
496
|
-
- Verification (`npm run check`, `npm test`)
|
|
497
|
-
- `npm publish --access public`
|
|
498
|
-
- Git commit, tag, and push to `origin`
|
|
499
|
-
|
|
500
|
-
Prepare without publishing/pushing:
|
|
72
|
+
An optional [agent skill](https://github.com/khanglvm/skills/tree/main/outline-cli)
|
|
73
|
+
is available with setup and workflow guidance:
|
|
501
74
|
|
|
502
|
-
```
|
|
503
|
-
|
|
75
|
+
```sh
|
|
76
|
+
npx skills add https://github.com/khanglvm/skills --skill outline-cli -y
|
|
504
77
|
```
|
|
505
78
|
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
- Clean working tree (unless you intentionally pass `--allow-dirty`)
|
|
509
|
-
- `OUTLINE_ENTRY_BUILD_KEY` available in environment or `.env.local`
|
|
510
|
-
- npm auth ready (`npm login`)
|
|
511
|
-
|
|
512
|
-
Optional GitHub automation:
|
|
513
|
-
|
|
514
|
-
- `.github/workflows/npm-auto-publish.yml` auto-publishes on pushes to `main` when `README.md` or `package.json` changes.
|
|
515
|
-
- If `package.json` version changes, the workflow publishes that exact version.
|
|
516
|
-
- If only docs metadata changes (for example `README.md`), the workflow cuts and publishes a patch release automatically.
|
|
517
|
-
- Required repository secrets: `NPM_TOKEN` and `OUTLINE_ENTRY_BUILD_KEY`.
|
|
518
|
-
- Ensure GitHub Actions can push to `main` and create tags in this repository.
|
|
519
|
-
|
|
520
|
-
## Security Notes
|
|
521
|
-
|
|
522
|
-
- Never commit real API keys.
|
|
523
|
-
- Keep local secrets in untracked files such as `.env.test.local`.
|
|
524
|
-
- Profile secrets are stored in the OS keychain by default.
|
|
79
|
+
## More help
|
|
525
80
|
|
|
526
|
-
|
|
81
|
+
- [Usage guide](https://github.com/khanglvm/outline-cli/blob/main/docs/USAGE.md): profiles, editing, attachments, batch calls, and safe deletion.
|
|
82
|
+
- `outline-cli tools list` lists tools; `outline-cli tools contract <name>` shows an individual tool's arguments.
|
|
83
|
+
- [Development](https://github.com/khanglvm/outline-cli/blob/main/docs/DEVELOPMENT.md) · [Changelog](CHANGELOG.md)
|
|
527
84
|
|
|
528
|
-
-
|
|
85
|
+
The older `outline-agent` command is an alias for `outline-cli`.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@khanglvm/outline-cli",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.4",
|
|
4
4
|
"description": "Agent-optimized CLI for Outline API",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -27,5 +27,9 @@
|
|
|
27
27
|
"dependencies": {
|
|
28
28
|
"@napi-rs/keyring": "^1.2.0",
|
|
29
29
|
"commander": "^13.1.0"
|
|
30
|
+
},
|
|
31
|
+
"repository": {
|
|
32
|
+
"type": "git",
|
|
33
|
+
"url": "git+https://github.com/khanglvm/outline-cli.git"
|
|
30
34
|
}
|
|
31
35
|
}
|
|
@@ -3,8 +3,8 @@ export const ENTRY_INTEGRITY_MANIFEST = Object.freeze({
|
|
|
3
3
|
version: 1,
|
|
4
4
|
algorithm: "sha256",
|
|
5
5
|
signatureAlgorithm: "sha256-salted-manifest-v1",
|
|
6
|
-
signature: "
|
|
7
|
-
generatedAt: "2026-
|
|
6
|
+
signature: "473207690cbe47a499645410613964b4fe7a71061f7c032fdfec72c06c4b3145",
|
|
7
|
+
generatedAt: "2026-10-14T00:36:00.966Z",
|
|
8
8
|
files: [
|
|
9
9
|
{
|
|
10
10
|
"path": "src/action-gate.js",
|
|
@@ -52,15 +52,15 @@ export const ENTRY_INTEGRITY_MANIFEST = Object.freeze({
|
|
|
52
52
|
},
|
|
53
53
|
{
|
|
54
54
|
"path": "src/tool-arg-schemas.js",
|
|
55
|
-
"sha256": "
|
|
55
|
+
"sha256": "609c4cc17d57fae611dd2d59446cee2bb5437794af30151b61e195e720147155"
|
|
56
56
|
},
|
|
57
57
|
{
|
|
58
58
|
"path": "src/tools.extended.js",
|
|
59
|
-
"sha256": "
|
|
59
|
+
"sha256": "cb25d43a57068b84b3d13de50db3149b2e3a0d3036f1ee6c7aaba20e6caccdae"
|
|
60
60
|
},
|
|
61
61
|
{
|
|
62
62
|
"path": "src/tools.js",
|
|
63
|
-
"sha256": "
|
|
63
|
+
"sha256": "8fed4d1f1c5e83b4a0e9136d2041b60262e4706426bd8c1c7751cc14dafac41c"
|
|
64
64
|
},
|
|
65
65
|
{
|
|
66
66
|
"path": "src/tools.mutation.js",
|
|
@@ -76,7 +76,7 @@ export const ENTRY_INTEGRITY_MANIFEST = Object.freeze({
|
|
|
76
76
|
},
|
|
77
77
|
{
|
|
78
78
|
"path": "src/utils.js",
|
|
79
|
-
"sha256": "
|
|
79
|
+
"sha256": "36791072e1d8599d912e7abebd3fa2e25d82889fec4ceb25aaf9c106bb8a7731"
|
|
80
80
|
}
|
|
81
81
|
],
|
|
82
82
|
});
|
package/src/tool-arg-schemas.js
CHANGED
|
@@ -1384,6 +1384,7 @@ export const TOOL_ARG_SCHEMAS = {
|
|
|
1384
1384
|
"documents.info": {
|
|
1385
1385
|
properties: {
|
|
1386
1386
|
id: { type: "string" },
|
|
1387
|
+
url: { type: "string" },
|
|
1387
1388
|
ids: { type: "string[]" },
|
|
1388
1389
|
shareId: { type: "string" },
|
|
1389
1390
|
includePolicies: { type: "boolean" },
|
|
@@ -1393,8 +1394,8 @@ export const TOOL_ARG_SCHEMAS = {
|
|
|
1393
1394
|
readTokenTtlSeconds: { type: "number", min: 60 },
|
|
1394
1395
|
},
|
|
1395
1396
|
custom(args, issues) {
|
|
1396
|
-
if (!args.id && !args.ids && !args.shareId) {
|
|
1397
|
-
issues.push({ path: "args.id", message: "or args.ids[] or args.shareId is required" });
|
|
1397
|
+
if (!args.id && !args.ids && !args.url && !args.shareId) {
|
|
1398
|
+
issues.push({ path: "args.id", message: "or args.ids[] or args.url or args.shareId is required" });
|
|
1398
1399
|
}
|
|
1399
1400
|
},
|
|
1400
1401
|
},
|
package/src/tools.extended.js
CHANGED
|
@@ -4,7 +4,14 @@ import { createHash, randomUUID } from "node:crypto";
|
|
|
4
4
|
import { ApiError, CliError } from "./errors.js";
|
|
5
5
|
import { assertPerformAction } from "./action-gate.js";
|
|
6
6
|
import { defaultTmpDir } from "./config-store.js";
|
|
7
|
-
import {
|
|
7
|
+
import {
|
|
8
|
+
compactValue,
|
|
9
|
+
ensureStringArray,
|
|
10
|
+
hasUnfetchedPageRows,
|
|
11
|
+
mapLimit,
|
|
12
|
+
sanitizeFileToken,
|
|
13
|
+
toInteger,
|
|
14
|
+
} from "./utils.js";
|
|
8
15
|
import { collectionsOpenBatchTool, collectionsOpenTool, documentsOpenBatchTool, memoryResolveTool } from "./memory-store.js";
|
|
9
16
|
|
|
10
17
|
const CONTROL_ARG_KEYS = new Set([
|
|
@@ -5276,7 +5283,10 @@ async function commentsReviewQueueTool(ctx, args = {}) {
|
|
|
5276
5283
|
documentId,
|
|
5277
5284
|
ok: true,
|
|
5278
5285
|
rowCount: rows.length,
|
|
5279
|
-
truncated:
|
|
5286
|
+
truncated: hasUnfetchedPageRows(res.body, {
|
|
5287
|
+
limit: limitPerDocument,
|
|
5288
|
+
rowCount: sourceRows.length,
|
|
5289
|
+
}),
|
|
5280
5290
|
rows,
|
|
5281
5291
|
sourceRows: view === "full" ? sourceRows : undefined,
|
|
5282
5292
|
};
|
package/src/tools.js
CHANGED
|
@@ -47,6 +47,30 @@ function normalizeIds(args) {
|
|
|
47
47
|
return [...new Set(ids)];
|
|
48
48
|
}
|
|
49
49
|
|
|
50
|
+
function normalizeDocumentReference(value) {
|
|
51
|
+
const reference = String(value).trim();
|
|
52
|
+
if (!reference.includes("://") && !reference.startsWith("/")) {
|
|
53
|
+
return reference;
|
|
54
|
+
}
|
|
55
|
+
let parsed;
|
|
56
|
+
try {
|
|
57
|
+
parsed = new URL(reference, "https://outline.invalid");
|
|
58
|
+
} catch {
|
|
59
|
+
throw new CliError("documents.info requires a document UUID, slug, or /doc/ URL");
|
|
60
|
+
}
|
|
61
|
+
const match = parsed.pathname.match(/^\/doc\/([^/]+)\/?$/);
|
|
62
|
+
if (!["http:", "https:"].includes(parsed.protocol) || !match) {
|
|
63
|
+
throw new CliError("documents.info requires a /doc/ URL; use shareId for shared documents");
|
|
64
|
+
}
|
|
65
|
+
try {
|
|
66
|
+
const slug = decodeURIComponent(match[1]);
|
|
67
|
+
if (!slug || /[/?#\s]/.test(slug)) throw new Error("invalid slug");
|
|
68
|
+
return slug;
|
|
69
|
+
} catch {
|
|
70
|
+
throw new CliError("documents.info URL contains an invalid document slug");
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
50
74
|
function normalizeSearchRow(row, view = "summary", contextChars = 320) {
|
|
51
75
|
if (view === "full") {
|
|
52
76
|
return row;
|
|
@@ -624,14 +648,17 @@ async function documentsListTool(ctx, args) {
|
|
|
624
648
|
}
|
|
625
649
|
|
|
626
650
|
async function documentsInfoTool(ctx, args) {
|
|
627
|
-
|
|
651
|
+
if (args.url && args.id && normalizeDocumentReference(args.url) !== normalizeDocumentReference(args.id)) {
|
|
652
|
+
throw new CliError("documents.info id and url must identify the same document");
|
|
653
|
+
}
|
|
654
|
+
const ids = [...new Set(normalizeIds({ ...args, id: args.id || args.url }).map(normalizeDocumentReference))];
|
|
628
655
|
const view = args.view || "summary";
|
|
629
656
|
const excerptChars = toInteger(args.excerptChars, 280);
|
|
630
657
|
const armDelete = args.armDelete === true;
|
|
631
658
|
const readTokenTtlSeconds = toInteger(args.readTokenTtlSeconds, 900);
|
|
632
659
|
|
|
633
660
|
if (ids.length === 0 && !args.shareId) {
|
|
634
|
-
throw new CliError("documents.info requires args.id, args.ids, or args.shareId");
|
|
661
|
+
throw new CliError("documents.info requires args.id, args.ids, args.url, or args.shareId");
|
|
635
662
|
}
|
|
636
663
|
|
|
637
664
|
const maxAttempts = toInteger(args.maxAttempts, 2);
|
|
@@ -1078,8 +1105,8 @@ export const TOOLS = {
|
|
|
1078
1105
|
},
|
|
1079
1106
|
"documents.info": {
|
|
1080
1107
|
signature:
|
|
1081
|
-
"documents.info(args: { id?: string; ids?: string[]; shareId?: string; view?: 'summary'|'full'; includePolicies?: boolean; concurrency?: number; armDelete?: boolean; readTokenTtlSeconds?: number })",
|
|
1082
|
-
description: "Read one or many documents by
|
|
1108
|
+
"documents.info(args: { id?: string; ids?: string[]; url?: string; shareId?: string; view?: 'summary'|'full'; includePolicies?: boolean; concurrency?: number; armDelete?: boolean; readTokenTtlSeconds?: number })",
|
|
1109
|
+
description: "Read one or many documents by UUID, slug, or document URL.",
|
|
1083
1110
|
usageExample: {
|
|
1084
1111
|
tool: "documents.info",
|
|
1085
1112
|
args: {
|
|
@@ -1089,7 +1116,8 @@ export const TOOLS = {
|
|
|
1089
1116
|
},
|
|
1090
1117
|
},
|
|
1091
1118
|
bestPractices: [
|
|
1092
|
-
"Use `ids[]`
|
|
1119
|
+
"Use `id` or `url` for one document; `ids[]` accepts mixed UUIDs, slugs, and /doc/ URLs.",
|
|
1120
|
+
"Document URLs are resolved within the selected profile; select the matching workspace first.",
|
|
1093
1121
|
"Use summary view first; only request full for final chosen docs.",
|
|
1094
1122
|
"Handle partial failures by checking each item.ok in batched result.",
|
|
1095
1123
|
"Set armDelete=true when you need a short-lived delete read token for a safe delete flow.",
|
package/src/utils.js
CHANGED
|
@@ -155,6 +155,24 @@ export function toBoolean(value, fallback = undefined) {
|
|
|
155
155
|
throw new Error(`Invalid boolean value: ${value}`);
|
|
156
156
|
}
|
|
157
157
|
|
|
158
|
+
export function hasUnfetchedPageRows(body, { offset = 0, limit, rowCount } = {}) {
|
|
159
|
+
const normalizedOffset = Math.max(0, Number(offset) || 0);
|
|
160
|
+
const normalizedRowCount = Math.max(0, Number(rowCount) || 0);
|
|
161
|
+
const rawTotal = body?.pagination?.total;
|
|
162
|
+
const total = rawTotal === undefined || rawTotal === null || rawTotal === ""
|
|
163
|
+
? Number.NaN
|
|
164
|
+
: Number(rawTotal);
|
|
165
|
+
|
|
166
|
+
if (Number.isFinite(total) && total >= 0) {
|
|
167
|
+
return normalizedOffset + normalizedRowCount < total;
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
const normalizedLimit = Number(limit);
|
|
171
|
+
return Number.isFinite(normalizedLimit)
|
|
172
|
+
&& normalizedLimit > 0
|
|
173
|
+
&& normalizedRowCount >= normalizedLimit;
|
|
174
|
+
}
|
|
175
|
+
|
|
158
176
|
export async function mapLimit(items, limit, fn) {
|
|
159
177
|
if (!Array.isArray(items) || items.length === 0) {
|
|
160
178
|
return [];
|