@tloncorp/tlon-skill 0.2.1 → 0.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.
Files changed (2) hide show
  1. package/SKILL.md +22 -3
  2. package/package.json +5 -5
package/SKILL.md CHANGED
@@ -263,10 +263,21 @@ Read and search message history. Authors are shown with nicknames when available
263
263
  tlon messages dm ~sampel --limit 20 # DM history (max 50)
264
264
  tlon messages channel chat/~host/slug --limit 20 # Channel history (max 50)
265
265
  tlon messages search "query" --channel chat/~host/slug # Search messages
266
+ tlon messages context chat/~host/slug 170.141... --limit 5 # Messages around a post
267
+ tlon messages post chat/~host/slug 170.141... # Fetch single post with replies
266
268
  ```
267
269
 
268
270
  Options: `--limit N`, `--resolve-cites`
269
271
 
272
+ The `context` command fetches N messages before and after a given post ID — useful for
273
+ finding surrounding conversation when you have a post from search or activity.
274
+ For DMs, use the ship name as the channel: `tlon messages context ~sampel 170.141...`
275
+
276
+ The `post` command fetches a single post with its replies/thread. For DM posts,
277
+ pass `--author ~ship` (required for DM/club lookups).
278
+
279
+ **Tip:** Use `search` to find a message, then `context` with its ID to see the surrounding conversation.
280
+
270
281
  ### DMs
271
282
 
272
283
  Manage direct messages.
@@ -330,13 +341,21 @@ The `--content` file should be Story JSON format (array of verses with headers,
330
341
 
331
342
  ### Upload
332
343
 
333
- Upload images to Tlon storage.
344
+ Upload files to Tlon storage from a URL, local path, or stdin.
334
345
 
335
346
  ```bash
336
- tlon upload https://example.com/image.png # Upload image from URL
347
+ tlon upload https://example.com/image.png # Upload from URL
348
+ tlon upload ./photo.jpg # Upload local file
349
+ tlon upload ~/Pictures/screenshot.png # Upload with absolute path
350
+ tlon upload ./mystery-file -t image/webp # Override content type
351
+ cat image.png | tlon upload --stdin -t image/png # Upload from stdin
337
352
  ```
338
353
 
339
- Returns the uploaded image URL for use in posts, profiles, etc.
354
+ Options: `-t`/`--type` (override MIME type), `--stdin` (read from stdin)
355
+
356
+ Content type is auto-detected from file extension for local files. For stdin, `-t` is recommended (defaults to `application/octet-stream`).
357
+
358
+ Returns the uploaded URL for use in posts, profiles, etc.
340
359
 
341
360
  ### Settings (OpenClaw)
342
361
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tloncorp/tlon-skill",
3
- "version": "0.2.1",
3
+ "version": "0.3.0",
4
4
  "description": "Tlon/Urbit skill for OpenClaw agents",
5
5
  "type": "module",
6
6
  "bin": {
@@ -21,10 +21,10 @@
21
21
  "postinstall": "node scripts/postinstall.js"
22
22
  },
23
23
  "optionalDependencies": {
24
- "@tloncorp/tlon-skill-darwin-arm64": "0.2.1",
25
- "@tloncorp/tlon-skill-darwin-x64": "0.2.1",
26
- "@tloncorp/tlon-skill-linux-x64": "0.2.1",
27
- "@tloncorp/tlon-skill-linux-arm64": "0.2.1"
24
+ "@tloncorp/tlon-skill-darwin-arm64": "0.3.0",
25
+ "@tloncorp/tlon-skill-darwin-x64": "0.3.0",
26
+ "@tloncorp/tlon-skill-linux-x64": "0.3.0",
27
+ "@tloncorp/tlon-skill-linux-arm64": "0.3.0"
28
28
  },
29
29
  "devDependencies": {
30
30
  "@tloncorp/api": "git+https://github.com/tloncorp/api-beta.git#c5eb1720d94435b62503605acb294ef42a5440b3",