npm - @xpr-agents/openclaw - Versions diffs - 0.2.14 → 0.2.16 - Mend

@xpr-agents/openclaw 0.2.14 → 0.2.16

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 (10) hide show

package/dist/index.d.ts +2 -1
package/dist/index.d.ts.map +1 -1
package/dist/index.js +5 -2
package/dist/index.js.map +1 -1
package/dist/tools/shellbook.d.ts +13 -0
package/dist/tools/shellbook.d.ts.map +1 -0
package/dist/tools/shellbook.js +425 -0
package/dist/tools/shellbook.js.map +1 -0
package/package.json +1 -1
package/skills/xpr-agent-operator/SKILL.md +58 -1

package/dist/index.d.ts CHANGED Viewed

@@ -1,13 +1,14 @@
 /**
  * XPR Agents OpenClaw Plugin
  *
- * Registers 57 tools for interacting with the XPR Network Trustless Agent Registry:
+ * Registers 72 tools for interacting with the XPR Network Trustless Agent Registry:
  * - 11 Agent Core tools (registration, profile, plugins, trust scores, ownership)
  * - 7 Feedback tools (ratings, disputes, scores)
  * - 9 Validation tools (validators, validations, challenges)
  * - 21 Escrow tools (jobs, milestones, disputes, arbitration, bidding)
  * - 4 Indexer tools (search, events, stats, health)
  * - 5 A2A tools (discover, message, task status, cancel, delegate)
+ * - 15 Shellbook tools (posts, comments, voting, subshells, search, profiles)
  */
 import type { PluginApi } from './types';
 export type { SkillManifest, SkillApi, LoadedSkill } from './skill-types';

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA~~;;;;;;;;;;GAUG~~;~~AASH~~,OAAO,KAAK,EAAE,SAAS,EAAgC,MAAM,SAAS,CAAC;AAGvE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD;;;GAGG;AACH,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;YAChE,OAAO,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SACjD,CAAC,CAAC;KACJ,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA0BD,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,~~CA0DpF~~"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAgC,MAAM,SAAS,CAAC;AAGvE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD;;;GAGG;AACH,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;YAChE,OAAO,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SACjD,CAAC,CAAC;KACJ,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA0BD,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CA2DpF"}

package/dist/index.js CHANGED Viewed

@@ -2,13 +2,14 @@
 /**
  * XPR Agents OpenClaw Plugin
  *
- * Registers 57 tools for interacting with the XPR Network Trustless Agent Registry:
+ * Registers 72 tools for interacting with the XPR Network Trustless Agent Registry:
  * - 11 Agent Core tools (registration, profile, plugins, trust scores, ownership)
  * - 7 Feedback tools (ratings, disputes, scores)
  * - 9 Validation tools (validators, validations, challenges)
  * - 21 Escrow tools (jobs, milestones, disputes, arbitration, bidding)
  * - 4 Indexer tools (search, events, stats, health)
  * - 5 A2A tools (discover, message, task status, cancel, delegate)
+ * - 15 Shellbook tools (posts, comments, voting, subshells, search, profiles)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = xprAgentsPlugin;
@@ -19,6 +20,7 @@ const validation_1 = require("./tools/validation");
 const escrow_1 = require("./tools/escrow");
 const indexer_1 = require("./tools/indexer");
 const a2a_1 = require("./tools/a2a");
+const shellbook_1 = require("./tools/shellbook");
 /**
  * Create an adapter that bridges the real OpenClaw API to our internal PluginApi.
  * This lets all 57 tool registrations work unchanged.
@@ -70,7 +72,7 @@ function xprAgentsPlugin(realApi) {
         session,
         network: rawConfig.network || 'mainnet',
         rpcEndpoint,
-        indexerUrl: rawConfig.indexerUrl || 'http://localhost:3001',
+        indexerUrl: rawConfig.indexerUrl || process.env.INDEXER_URL || 'https://indexer.xpragents.com',
         contracts: {
             agentcore: contractsRaw.agentcore || 'agentcore',
             agentfeed: contractsRaw.agentfeed || 'agentfeed',
@@ -87,6 +89,7 @@ function xprAgentsPlugin(realApi) {
     (0, escrow_1.registerEscrowTools)(api, config);
     (0, indexer_1.registerIndexerTools)(api, config);
     (0, a2a_1.registerA2ATools)(api, config);
+    (0, shellbook_1.registerShellbookTools)(api);
     if (!hasCredentials) {
         console.log('[xpr-agents] Read-only mode: XPR_PRIVATE_KEY and XPR_ACCOUNT not set. Write tools will fail.');
     }

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA~~;;;;;;;;;;GAUG~~;;~~AA2DH~~,~~kCA0DC~~;~~AAnHD~~,uCAA6D;AAC7D,yCAAmD;AACnD,+CAAyD;AACzD,mDAA6D;AAC7D,2CAAqD;AACrD,6CAAuD;AACvD,qCAA+C;~~AA2B~~/C;;;GAGG;AACH,SAAS,aAAa,CAAC,OAA0B;IAC/C,OAAO;QACL,YAAY,CAAC,IAAoB;YAC/B,OAAO,CAAC,YAAY,CAAC;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAA+B;oBACxD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;oBAC1C,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;oBACnF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC/C,CAAC;aACF,CAAC,CAAC;QACL,CAAC;QACD,SAAS;YACP,OAAO,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAwB,eAAe,CAAC,OAAsC;IAC5E,6EAA6E;IAC7E,mFAAmF;IACnF,MAAM,GAAG,GAAc,OAAQ,OAAe,CAAC,SAAS,KAAK,UAAU;QACrE,CAAC,CAAC,OAAoB;QACtB,CAAC,CAAC,aAAa,CAAC,OAA4B,CAAC,CAAC;IAEhD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IAElC,MAAM,OAAO,GAAI,SAAS,CAAC,OAAkB,IAAI,SAAS,CAAC;IAC3D,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,0BAA0B,CAAC;IACnG,MAAM,WAAW,GAAI,SAAS,CAAC,WAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,UAAU,CAAC;IAEpG,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAElF,6CAA6C;IAC7C,IAAI,GAAG,CAAC;IACR,IAAI,OAAO,CAAC;IAEZ,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,IAAA,uBAAa,EAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAC9C,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACjB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,IAAA,2BAAiB,EAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAA2B,CAAC;IAE3E,MAAM,MAAM,GAAiB;QAC3B,GAAG,EAAE,GAAU;QACf,OAAO;QACP,OAAO,EAAG,SAAS,CAAC,OAAiC,IAAI,SAAS;QAClE,WAAW;QACX,UAAU,EAAG,SAAS,CAAC,UAAqB,IAAI,~~uBAAuB~~;~~QACvE~~,SAAS,EAAE;YACT,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,WAAW;YAChD,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,WAAW;YAChD,UAAU,EAAE,YAAY,CAAC,UAAU,IAAI,YAAY;YACnD,WAAW,EAAE,YAAY,CAAC,WAAW,IAAI,aAAa;SACvD;QACD,eAAe,EAAE,SAAS,CAAC,eAAe,KAAK,KAAK;QACpD,iBAAiB,EAAG,SAAS,CAAC,iBAA4B,IAAI,QAAQ;KACvE,CAAC;IAEF,2BAA2B;IAC3B,IAAA,0BAAkB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAChC,IAAA,gCAAqB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnC,IAAA,oCAAuB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACrC,IAAA,4BAAmB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACjC,IAAA,8BAAoB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,IAAA,sBAAgB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;~~IAE9B~~,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,8FAA8F,CAAC,CAAC;IAC9G,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,OAAO,KAAK,WAAW,GAAG,CAAC,CAAC;AAChF,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/shellbook.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * Shellbook tools for the XPR Agents OpenClaw plugin.
+ *
+ * 15 tools for Shellbook.io — social network for AI agents on XPR Network.
+ * Uses direct HTTP calls (no SDK dependency).
+ *
+ * - 5 read-only (no auth)
+ * - 8 write (require SHELLBOOK_API_KEY)
+ * - 2 authenticated reads (require SHELLBOOK_API_KEY)
+ */
+import type { PluginApi } from '../types';
+export declare function registerShellbookTools(api: PluginApi): void;
+//# sourceMappingURL=shellbook.d.ts.map

package/dist/tools/shellbook.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"shellbook.d.ts","sourceRoot":"","sources":["../../src/tools/shellbook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAuD1C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAyV3D"}

package/dist/tools/shellbook.js ADDED Viewed

@@ -0,0 +1,425 @@
+"use strict";
+/**
+ * Shellbook tools for the XPR Agents OpenClaw plugin.
+ *
+ * 15 tools for Shellbook.io — social network for AI agents on XPR Network.
+ * Uses direct HTTP calls (no SDK dependency).
+ *
+ * - 5 read-only (no auth)
+ * - 8 write (require SHELLBOOK_API_KEY)
+ * - 2 authenticated reads (require SHELLBOOK_API_KEY)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerShellbookTools = registerShellbookTools;
+const BASE_URL = process.env.SHELLBOOK_URL || 'https://shellbook.io/api/v1';
+function getApiKey() {
+    return process.env.SHELLBOOK_API_KEY?.trim() || undefined;
+}
+async function shellGet(path, auth = false) {
+    const headers = { 'Accept': 'application/json' };
+    const key = getApiKey();
+    if (auth && key)
+        headers['Authorization'] = `Bearer ${key}`;
+    const resp = await fetch(`${BASE_URL}${path}`, { headers, signal: AbortSignal.timeout(15000) });
+    if (!resp.ok) {
+        const body = await resp.text().catch(() => '');
+        throw new Error(`Shellbook API ${resp.status}: ${body.slice(0, 200)}`);
+    }
+    return resp.json();
+}
+async function shellPost(path, body) {
+    const key = getApiKey();
+    if (!key)
+        throw new Error('SHELLBOOK_API_KEY environment variable is required for write operations');
+    const resp = await fetch(`${BASE_URL}${path}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+            'Authorization': `Bearer ${key}`,
+        },
+        body: body ? JSON.stringify(body) : undefined,
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => '');
+        throw new Error(`Shellbook API ${resp.status}: ${text.slice(0, 200)}`);
+    }
+    return resp.json();
+}
+async function shellDelete(path) {
+    const key = getApiKey();
+    if (!key)
+        throw new Error('SHELLBOOK_API_KEY environment variable is required for delete operations');
+    const resp = await fetch(`${BASE_URL}${path}`, {
+        method: 'DELETE',
+        headers: { 'Accept': 'application/json', 'Authorization': `Bearer ${key}` },
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => '');
+        throw new Error(`Shellbook API ${resp.status}: ${text.slice(0, 200)}`);
+    }
+    return resp.json();
+}
+function registerShellbookTools(api) {
+    // ═══════════════════════════════════════
+    // READ-ONLY (5 — no auth)
+    // ═══════════════════════════════════════
+    api.registerTool({
+        name: 'shell_list_posts',
+        description: 'List posts from Shellbook. Filter by subshell name, sort by new/top/hot, with pagination.',
+        parameters: {
+            type: 'object',
+            properties: {
+                subshell: { type: 'string', description: 'Subshell name to filter by (e.g. "general", "agents", "xpr"). Omit for all.' },
+                sort: { type: 'string', description: 'Sort order: "new" (default), "top", or "hot"' },
+                limit: { type: 'number', description: 'Max posts to return (default 20, max 50)' },
+                offset: { type: 'number', description: 'Number of posts to skip (for pagination)' },
+            },
+        },
+        handler: async ({ subshell, sort, limit, offset }) => {
+            const params = new URLSearchParams();
+            if (subshell)
+                params.set('subshell', subshell);
+            if (sort)
+                params.set('sort', sort);
+            if (limit)
+                params.set('limit', String(Math.min(Math.max(limit, 1), 50)));
+            if (offset)
+                params.set('offset', String(offset));
+            const qs = params.toString();
+            try {
+                const posts = await shellGet(`/posts${qs ? '?' + qs : ''}`);
+                return { posts, count: Array.isArray(posts) ? posts.length : 0 };
+            }
+            catch (err) {
+                return { error: `Failed to list posts: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_get_comments',
+        description: 'Get comments on a Shellbook post. Returns threaded comments with author info and vote counts.',
+        parameters: {
+            type: 'object',
+            required: ['post_id'],
+            properties: {
+                post_id: { type: 'string', description: 'UUID of the post to get comments for' },
+            },
+        },
+        handler: async ({ post_id }) => {
+            if (!post_id)
+                return { error: 'post_id is required' };
+            try {
+                const comments = await shellGet(`/posts/${encodeURIComponent(post_id)}/comments`);
+                return { post_id, comments, count: Array.isArray(comments) ? comments.length : 0 };
+            }
+            catch (err) {
+                return { error: `Failed to get comments: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_list_subshells',
+        description: 'List all Shellbook communities (subshells). Each has a name, display name, and description.',
+        parameters: { type: 'object', properties: {} },
+        handler: async () => {
+            try {
+                const subshells = await shellGet('/subshells');
+                return { subshells, count: Array.isArray(subshells) ? subshells.length : 0 };
+            }
+            catch (err) {
+                return { error: `Failed to list subshells: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_search',
+        description: 'Search Shellbook for posts, agents, and subshells. Returns results grouped by type.',
+        parameters: {
+            type: 'object',
+            required: ['query'],
+            properties: {
+                query: { type: 'string', description: 'Search query string' },
+            },
+        },
+        handler: async ({ query }) => {
+            if (!query)
+                return { error: 'query is required' };
+            try {
+                return await shellGet(`/search?q=${encodeURIComponent(query)}`);
+            }
+            catch (err) {
+                return { error: `Failed to search: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_get_profile',
+        description: 'View a public agent profile on Shellbook. Returns name, description, trust score, karma.',
+        parameters: {
+            type: 'object',
+            required: ['name'],
+            properties: {
+                name: { type: 'string', description: 'Agent name to look up (e.g. "chattybot")' },
+            },
+        },
+        handler: async ({ name }) => {
+            if (!name)
+                return { error: 'name is required' };
+            try {
+                return await shellGet(`/agents/profile?name=${encodeURIComponent(name)}`);
+            }
+            catch (err) {
+                return { error: `Failed to get profile: ${err.message}` };
+            }
+        },
+    });
+    // ═══════════════════════════════════════
+    // WRITE TOOLS (8 — require SHELLBOOK_API_KEY)
+    // ═══════════════════════════════════════
+    api.registerTool({
+        name: 'shell_create_post',
+        description: 'Create a new post on Shellbook. Requires SHELLBOOK_API_KEY. Post to a subshell with title, content, and optional URL.',
+        parameters: {
+            type: 'object',
+            required: ['subshell', 'title', 'content'],
+            properties: {
+                subshell: { type: 'string', description: 'Subshell name to post in (e.g. "general", "agents", "xpr")' },
+                title: { type: 'string', description: 'Post title (max 300 chars)' },
+                content: { type: 'string', description: 'Post body text (max 40,000 chars). Supports markdown.' },
+                url: { type: 'string', description: 'Optional URL to link in the post' },
+            },
+        },
+        handler: async ({ subshell, title, content, url }) => {
+            if (!subshell || !title || !content)
+                return { error: 'subshell, title, and content are required' };
+            if (title.length > 300)
+                return { error: 'Title exceeds 300 character limit' };
+            if (content.length > 40000)
+                return { error: 'Content exceeds 40,000 character limit' };
+            try {
+                return await shellPost('/posts', { subshell, title, content, url });
+            }
+            catch (err) {
+                return { error: `Failed to create post: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_comment',
+        description: 'Comment on a Shellbook post. Requires SHELLBOOK_API_KEY. Supports nested replies via parent_comment_id.',
+        parameters: {
+            type: 'object',
+            required: ['post_id', 'content'],
+            properties: {
+                post_id: { type: 'string', description: 'UUID of the post to comment on' },
+                content: { type: 'string', description: 'Comment body text (max 10,000 chars)' },
+                parent_comment_id: { type: 'string', description: 'UUID of parent comment for nested replies' },
+            },
+        },
+        handler: async ({ post_id, content, parent_comment_id }) => {
+            if (!post_id || !content)
+                return { error: 'post_id and content are required' };
+            if (content.length > 10000)
+                return { error: 'Comment exceeds 10,000 character limit' };
+            try {
+                const body = { content };
+                if (parent_comment_id)
+                    body.parent_comment_id = parent_comment_id;
+                return await shellPost(`/posts/${encodeURIComponent(post_id)}/comments`, body);
+            }
+            catch (err) {
+                return { error: `Failed to create comment: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_upvote',
+        description: 'Upvote a post or comment on Shellbook. Requires SHELLBOOK_API_KEY.',
+        parameters: {
+            type: 'object',
+            required: ['target_id', 'target_type'],
+            properties: {
+                target_id: { type: 'string', description: 'UUID of the post or comment to upvote' },
+                target_type: { type: 'string', description: '"post" or "comment"' },
+            },
+        },
+        handler: async ({ target_id, target_type }) => {
+            if (!target_id || !target_type)
+                return { error: 'target_id and target_type are required' };
+            if (target_type !== 'post' && target_type !== 'comment')
+                return { error: 'target_type must be "post" or "comment"' };
+            try {
+                const path = target_type === 'post'
+                    ? `/posts/${encodeURIComponent(target_id)}/upvote`
+                    : `/comments/${encodeURIComponent(target_id)}/upvote`;
+                return await shellPost(path);
+            }
+            catch (err) {
+                return { error: `Failed to upvote: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_downvote',
+        description: 'Downvote a post or comment on Shellbook. Requires SHELLBOOK_API_KEY.',
+        parameters: {
+            type: 'object',
+            required: ['target_id', 'target_type'],
+            properties: {
+                target_id: { type: 'string', description: 'UUID of the post or comment to downvote' },
+                target_type: { type: 'string', description: '"post" or "comment"' },
+            },
+        },
+        handler: async ({ target_id, target_type }) => {
+            if (!target_id || !target_type)
+                return { error: 'target_id and target_type are required' };
+            if (target_type !== 'post' && target_type !== 'comment')
+                return { error: 'target_type must be "post" or "comment"' };
+            try {
+                const path = target_type === 'post'
+                    ? `/posts/${encodeURIComponent(target_id)}/downvote`
+                    : `/comments/${encodeURIComponent(target_id)}/downvote`;
+                return await shellPost(path);
+            }
+            catch (err) {
+                return { error: `Failed to downvote: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_unvote',
+        description: 'Remove your vote from a post on Shellbook. Requires SHELLBOOK_API_KEY.',
+        parameters: {
+            type: 'object',
+            required: ['post_id'],
+            properties: {
+                post_id: { type: 'string', description: 'UUID of the post to remove your vote from' },
+            },
+        },
+        handler: async ({ post_id }) => {
+            if (!post_id)
+                return { error: 'post_id is required' };
+            try {
+                return await shellPost(`/posts/${encodeURIComponent(post_id)}/unvote`);
+            }
+            catch (err) {
+                return { error: `Failed to unvote: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_create_subshell',
+        description: 'Create a new Shellbook community (subshell). Requires SHELLBOOK_API_KEY.',
+        parameters: {
+            type: 'object',
+            required: ['name', 'display_name', 'description'],
+            properties: {
+                name: { type: 'string', description: 'Subshell name (2-24 chars, lowercase a-z and hyphens, e.g. "my-community")' },
+                display_name: { type: 'string', description: 'Display name shown in the UI' },
+                description: { type: 'string', description: 'Community description' },
+            },
+        },
+        handler: async ({ name, display_name, description }) => {
+            if (!name || !display_name || !description)
+                return { error: 'name, display_name, and description are required' };
+            if (name.length < 2 || name.length > 24)
+                return { error: 'Subshell name must be 2-24 characters' };
+            if (!/^[a-z][a-z0-9-]*$/.test(name))
+                return { error: 'Subshell name must be lowercase, start with a letter, contain only a-z, 0-9, hyphens' };
+            try {
+                return await shellPost('/subshells', { name, display_name, description });
+            }
+            catch (err) {
+                return { error: `Failed to create subshell: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_delete_post',
+        description: 'Delete your own post on Shellbook (soft delete). Requires SHELLBOOK_API_KEY.',
+        parameters: {
+            type: 'object',
+            required: ['post_id'],
+            properties: {
+                post_id: { type: 'string', description: 'UUID of the post to delete' },
+            },
+        },
+        handler: async ({ post_id }) => {
+            if (!post_id)
+                return { error: 'post_id is required' };
+            try {
+                return await shellDelete(`/posts/${encodeURIComponent(post_id)}`);
+            }
+            catch (err) {
+                return { error: `Failed to delete post: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_delete_comment',
+        description: 'Delete your own comment on Shellbook (soft delete). Requires SHELLBOOK_API_KEY.',
+        parameters: {
+            type: 'object',
+            required: ['comment_id'],
+            properties: {
+                comment_id: { type: 'string', description: 'UUID of the comment to delete' },
+            },
+        },
+        handler: async ({ comment_id }) => {
+            if (!comment_id)
+                return { error: 'comment_id is required' };
+            try {
+                return await shellDelete(`/comments/${encodeURIComponent(comment_id)}`);
+            }
+            catch (err) {
+                return { error: `Failed to delete comment: ${err.message}` };
+            }
+        },
+    });
+    // ═══════════════════════════════════════
+    // AUTHENTICATED READS (2 — require SHELLBOOK_API_KEY)
+    // ═══════════════════════════════════════
+    api.registerTool({
+        name: 'shell_get_feed',
+        description: 'Get personalized feed from subscribed subshells. Requires SHELLBOOK_API_KEY.',
+        parameters: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Max posts to return (default 20, max 50)' },
+                offset: { type: 'number', description: 'Number of posts to skip (for pagination)' },
+            },
+        },
+        handler: async ({ limit, offset }) => {
+            const params = new URLSearchParams();
+            if (limit)
+                params.set('limit', String(Math.min(Math.max(limit, 1), 50)));
+            if (offset)
+                params.set('offset', String(offset));
+            const qs = params.toString();
+            try {
+                const posts = await shellGet(`/feed${qs ? '?' + qs : ''}`, true);
+                return { posts, count: Array.isArray(posts) ? posts.length : 0 };
+            }
+            catch (err) {
+                return { error: `Failed to get feed: ${err.message}` };
+            }
+        },
+    });
+    api.registerTool({
+        name: 'shell_get_me',
+        description: 'Get own agent profile on Shellbook, including trust score and karma. Requires SHELLBOOK_API_KEY.',
+        parameters: { type: 'object', properties: {} },
+        handler: async () => {
+            try {
+                return await shellGet('/agents/me', true);
+            }
+            catch (err) {
+                return { error: `Failed to get own profile: ${err.message}` };
+            }
+        },
+    });
+}
+//# sourceMappingURL=shellbook.js.map

package/dist/tools/shellbook.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"shellbook.js","sourceRoot":"","sources":["../../src/tools/shellbook.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@xpr-agents/openclaw",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "description": "OpenClaw plugin for XPR Network Trustless Agent Registry - autonomous agent operation, escrow jobs, feedback, and validation",
   "author": "XPR Network",
   "repository": {

package/skills/xpr-agent-operator/SKILL.md CHANGED Viewed

@@ -156,14 +156,65 @@ Check registry stats: xpr_get_stats
 - Incoming A2A requests are authenticated — callers must prove account ownership via signature
 - Rate limiting and trust gating protect against abuse (configurable via `A2A_MIN_TRUST_SCORE`, `A2A_MIN_KYC_LEVEL`)
+### 6. Trading & OTC Operations
+When a job involves token swaps, OTC deals, or any financial trade:
+**Pre-trade checklist (MANDATORY):**
+1. **Check market price first** — use `defi_get_price` to fetch current XPR/XUSDC (or relevant pair) rate
+2. **Calculate fair value** — multiply the requested quantity by market price
+3. **Compare to requested terms** — ensure the deal is within acceptable spread
+**Spread limits:**
+- **Max acceptable spread: 5%** — never create an OTC offer more than 5% below market rate
+- If a client asks to buy XPR at 20% below market, **decline the job** and explain why
+- If the spread is 1-5%, proceed but note the spread in your delivery
+**OTC workflow:**
+1. Accept the job
+2. `defi_get_price` — fetch current market rate for the trading pair
+3. Verify you have sufficient balance for the trade
+4. `defi_create_otc` — create the escrow offer between you and the client (set `to` = client account)
+5. `store_deliverable` — write a summary including: market rate, offer rate, spread %, amounts, expiry
+6. Include the transaction link: `https://explorer.xprnetwork.org/transaction/{TX_ID}`
+7. `xpr_deliver_job` — deliver with the evidence URI
+8. Optionally post about the trade on Shellbook `s/defi` for transparency
+**Hard rules:**
+- **NEVER sell XPR below market rate** unless the job explicitly pays a premium that covers the discount
+- **NEVER create OTC offers with your full balance** — always keep a reserve (min 100 XPR)
+- **NEVER trade tokens you don't recognize** — verify the contract account is legitimate (e.g. `eosio.token` for XPR, `xtokens` for XUSDC)
+- **Always set an expiry** — default 72 hours, never more than 7 days
+- **Open offers (no `to` account) are riskier** — prefer setting `to` = the client's account when known
+**Known token contracts (testnet & mainnet):**
+| Token | Contract | Precision |
+|-------|----------|-----------|
+| XPR | `eosio.token` | 4 (`1.0000 XPR`) |
+| XUSDC | `xtokens` | 6 (`1.000000 XUSDC`) |
+| XUSDT | `xtokens` | 6 (`1.000000 XUSDT`) |
+| XBTC | `xtokens` | 8 (`1.00000000 XBTC`) |
+| XETH | `xtokens` | 8 (`1.00000000 XETH`) |
+| XMD | `xmd.token` | 6 (`1.000000 XMD`) |
+| LOAN | `loan.token` | 4 (`1.0000 LOAN`) |
+**Useful links:**
+- Explorer: `https://explorer.xprnetwork.org/transaction/{TX_ID}`
+- MetalX OTC page: `https://app.metalx.com/otc` (general page — no deep links to specific offers yet)
+- Do NOT fabricate URLs like `app.metalx.com/otc/1385` — they don't work
+- Tell the user to visit `https://app.metalx.com/otc` and find the offer by escrow ID
 ## Safety Rules
-1. **Never reveal private keys** - XPR_PRIVATE_KEY must stay in environment variables only
+1. **Never reveal private keys** - XPR_PRIVATE_KEY must stay in environment variables only. Recommend operators use a dedicated agent account, not their personal account
 2. **Always verify before accepting** - Read job details thoroughly before committing
 3. **Always provide evidence** - When delivering or disputing, include evidence URIs
 4. **Respect confirmation gates** - High-risk actions (registration, funding, disputes) require confirmation
 5. **Monitor your reputation** - A declining trust score needs investigation
 6. **Don't over-commit** - Only accept jobs you can realistically complete
+7. **Always check market price before trading** - Never execute a trade without verifying current rates
+8. **Never sell tokens below market rate** - Protect your holdings from bad deals
 ## Tool Quick Reference
@@ -195,3 +246,9 @@ Check registry stats: xpr_get_stats
 | Get A2A task status | `xpr_a2a_get_task` |
 | Cancel A2A task | `xpr_a2a_cancel_task` |
 | Delegate job via A2A | `xpr_a2a_delegate_job` |
+| Check token price | `defi_get_price` |
+| List OTC offers | `defi_list_otc_offers` |
+| Create OTC offer | `defi_create_otc` |
+| Fill OTC offer | `defi_fill_otc` |
+| Cancel OTC offer | `defi_cancel_otc` |
+| Post to Shellbook | `shell_create_post` |