dashclaw 1.7.1 → 1.7.2

package/README.md

@@ -608,6 +608,100 @@ Add an entry to an existing thread.
 
 ---
 
+## Automation Snippets
+
+Save, search, and reuse code snippets across agent sessions.
+
+### claw.saveSnippet(snippet)
+Save or update a reusable code snippet. Upserts on name.
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| name | string | Yes | Snippet name (unique per org) |
+| code | string | Yes | The snippet code |
+| description | string | No | What this snippet does |
+| language | string | No | Programming language |
+| tags | string[] | No | Tags for categorization |
+
+**Returns:** `Promise<{snippet: Object, snippet_id: string}>`
+
+**Example:**
+```javascript
+await claw.saveSnippet({
+  name: 'fetch-with-retry',
+  code: 'async function fetchRetry(url, n = 3) { ... }',
+  language: 'javascript',
+  tags: ['fetch', 'retry'],
+});
+```
+
+### claw.getSnippet(snippetId)
+Fetch a single snippet by ID.
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| snippetId | string | Yes | The snippet ID |
+
+**Returns:** `Promise<{snippet: Object}>`
+
+**Example:**
+```javascript
+const { snippet } = await claw.getSnippet('sn_abc123');
+console.log(snippet.name, snippet.language);
+```
+
+### claw.getSnippets(filters?)
+Search and list snippets.
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| search | string | No | Search name/description |
+| tag | string | No | Filter by tag |
+| language | string | No | Filter by language |
+| limit | number | No | Max results |
+
+**Returns:** `Promise<{snippets: Object[], total: number}>`
+
+**Example:**
+```javascript
+const { snippets } = await claw.getSnippets({ language: 'javascript' });
+```
+
+### claw.useSnippet(snippetId)
+Mark a snippet as used (increments use_count).
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| snippetId | string | Yes | Snippet ID |
+
+**Returns:** `Promise<{snippet: Object}>`
+
+**Example:**
+```javascript
+await claw.useSnippet('sn_abc123');
+```
+
+### claw.deleteSnippet(snippetId)
+Delete a snippet.
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| snippetId | string | Yes | Snippet ID |
+
+**Returns:** `Promise<{deleted: boolean, id: string}>`
+
+**Example:**
+```javascript
+await claw.deleteSnippet('sn_abc123');
+```
+
+---
+
 ## Agent Messaging
 
 ### claw.sendMessage(params)

package/dashclaw.js

@@ -10,7 +10,7 @@
  * - Dashboard Data (9)
  * - Session Handoffs (3)
  * - Context Manager (7)
- * - Automation Snippets (4)
+ * - Automation Snippets (5)
  * - User Preferences (6)
  * - Daily Digest (1)
  * - Security Scanning (2)
@@ -1138,7 +1138,7 @@ class DashClaw {
   }
 
   // ══════════════════════════════════════════════
-  // Category 7: Automation Snippets (4 methods)
+  // Category 7: Automation Snippets (5 methods)
   // ══════════════════════════════════════════════
 
   /**
@@ -1176,6 +1176,15 @@ class DashClaw {
     return this._request(`/api/snippets?${params}`, 'GET');
   }
 
+  /**
+   * Fetch a single snippet by ID.
+   * @param {string} snippetId - The snippet ID
+   * @returns {Promise<{snippet: Object}>}
+   */
+  async getSnippet(snippetId) {
+    return this._request(`/api/snippets/${snippetId}`, 'GET');
+  }
+
   /**
    * Mark a snippet as used (increments use_count).
    * @param {string} snippetId - The snippet ID

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dashclaw",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "description": "Full-featured agent toolkit for the DashClaw platform. 60+ methods for action recording, context management, session handoffs, security scanning, behavior guard, bulk sync, and more.",
   "type": "module",
   "publishConfig": {