@xpr-agents/openclaw 0.6.0 → 0.7.0

package/skills/blockart/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "declaration": false
+  },
+  "include": ["src/**/*.ts"]
+}

package/skills/creative/SKILL.md

@@ -25,6 +25,26 @@ You have powerful creative capabilities for delivering job results:
 **Images/Media from the web:**
 - Use `web_search` to find suitable content, then `store_deliverable` with source_url
 
+**3D models (.glb / .gltf):**
+- `store_deliverable` with content_type "model/gltf-binary" (.glb) or "model/gltf+json" (.gltf)
+  and a `source_url` — the model is downloaded and pinned to IPFS
+- A source_url ending .glb/.gltf is recognised as a model even without content_type
+- The job board renders it in an interactive three.js viewer the client can orbit, zoom and pan
+- Shipping a model plus a preview image or a written summary is one deliverable with several
+  files, so pin each file with its own `store_deliverable` call and then deliver a manifest:
+
+  ```json
+  {"v":1,"files":[
+    {"name":"scene.glb","uri":"https://<gateway>/ipfs/<cid>","type":"model/gltf-binary"},
+    {"name":"preview.png","uri":"https://<gateway>/ipfs/<cid2>","type":"image/png"}
+  ],"note":"how it was made"}
+  ```
+
+  Give every model entry `"type":"model/gltf-binary"` (or `model/gltf+json`). That `type` is what
+  the viewer keys off; without it the file only renders if its URI still ends in .glb/.gltf.
+  Pass the manifest JSON string itself as `evidence_uri` to `xpr_deliver_job` — do not try to
+  store the manifest with `store_deliverable`.
+
 **Code repositories:**
 - `create_github_repo` with all source files — creates a public GitHub repo
 

package/skills/creative/dist/index.js

@@ -68,6 +68,54 @@ async function uploadBinaryToIpfs(buffer, filename, mimeType) {
     }
     return null;
 }
+const MODEL_CONTENT_TYPES = ['model/gltf-binary', 'model/gltf+json'];
+const MODEL_EXT_RE = /\.(glb|gltf)(?:$|[?#])/i;
+const GENERIC_BINARY_TYPES = ['', 'application/octet-stream', 'binary/octet-stream', 'application/binary'];
+/**
+ * Extension to pin a file under. `mimeType.split('/')[1]` is wrong for the model types —
+ * it yields "gltf-binary" — and the job board keys off the extension when a manifest
+ * omits `type`, so a GLB must land as `.glb`.
+ */
+const EXTENSION_BY_MIME = {
+    'model/gltf-binary': 'glb',
+    'model/gltf+json': 'gltf',
+    'application/pdf': 'pdf',
+    'image/jpeg': 'jpg',
+    'image/png': 'png',
+    'image/webp': 'webp',
+    'image/gif': 'gif',
+    'image/svg+xml': 'svg',
+    'audio/mpeg': 'mp3',
+    'audio/wav': 'wav',
+    'video/mp4': 'mp4',
+    'video/webm': 'webm',
+};
+function isGenericBinaryType(mimeType) {
+    return GENERIC_BINARY_TYPES.includes((mimeType || '').split(';')[0].trim().toLowerCase());
+}
+/** A 3D deliverable, whether declared by content_type or implied by the source URL. */
+function isModelDeliverable(contentType, sourceUrl) {
+    if (MODEL_CONTENT_TYPES.includes(contentType))
+        return true;
+    return Boolean(sourceUrl && MODEL_EXT_RE.test(sourceUrl.split('?')[0]));
+}
+function modelMimeFor(contentType, sourceUrl) {
+    if (MODEL_CONTENT_TYPES.includes(contentType))
+        return contentType;
+    return /\.gltf(?:$|[?#])/i.test((sourceUrl || '').split('?')[0]) ? 'model/gltf+json' : 'model/gltf-binary';
+}
+function extensionFor(mimeType, sourceUrl, filename) {
+    if (filename && filename.includes('.'))
+        return filename.split('.').pop().toLowerCase();
+    const mapped = EXTENSION_BY_MIME[mimeType];
+    if (mapped)
+        return mapped;
+    const path = (sourceUrl || '').split('?')[0].split('#')[0];
+    const fromUrl = path.includes('.') ? path.split('.').pop() : '';
+    if (fromUrl && fromUrl.length <= 5 && !fromUrl.includes('/'))
+        return fromUrl.toLowerCase();
+    return mimeType.split('/')[1]?.split('+')[0] || 'bin';
+}
 const MAX_DOWNLOAD_SIZE = 50 * 1024 * 1024;
 async function downloadFromUrl(url) {
     if (!/^https?:\/\//.test(url))
@@ -386,6 +434,9 @@ function creativeSkill(api) {
             '    Images referenced as ![alt](url) in the Markdown are downloaded and embedded in the PDF.',
             '    Do NOT include <cite> or other HTML tags in the content — use clean Markdown only.',
             '  image/*, audio/*, video/* — downloads source_url and uploads binary to IPFS',
+            '  model/gltf-binary (.glb), model/gltf+json (.gltf) — downloads source_url and uploads the 3D',
+            '    model to IPFS. The job board renders it in an interactive three.js viewer.',
+            '    A source_url ending .glb/.gltf is treated as a model even with no content_type.',
             '  text/csv, text/plain, text/html, application/json — uploads the text as a file on IPFS (the URL serves the raw file)',
             'Do NOT store a delivery manifest with this tool: pass the manifest JSON string itself as evidence_uri to xpr_deliver_job.',
         ].join('\n'),
@@ -396,8 +447,8 @@ function creativeSkill(api) {
                 job_id: { type: 'number', description: 'Job ID' },
                 content: { type: 'string', description: 'Full deliverable content (markdown, text, CSV, etc.). For media types, can be empty if source_url is provided.' },
                 content_type: { type: 'string', description: 'MIME type: text/markdown (default), application/pdf, image/png, audio/mpeg, video/mp4, text/csv, etc.' },
-                source_url: { type: 'string', description: 'URL to download binary content from (for image/audio/video). The file is downloaded and uploaded to IPFS.' },
-                filename: { type: 'string', description: 'Optional filename for the deliverable (e.g. "report.pdf")' },
+                source_url: { type: 'string', description: 'URL to download binary content from (for image/audio/video/3D model). The file is downloaded and uploaded to IPFS.' },
+                filename: { type: 'string', description: 'Optional filename for the deliverable (e.g. "report.pdf", "scene.glb"). The extension matters — it is how the job board identifies the file when a manifest omits its type.' },
             },
         },
         handler: async ({ job_id, content, content_type, source_url, filename }) => {
@@ -427,23 +478,33 @@ function creativeSkill(api) {
                     return { stored: false, error: `PDF generation failed: ${err.message}` };
                 }
             }
-            if (ct.startsWith('image/') || ct.startsWith('audio/') || ct.startsWith('video/') || ct === 'application/octet-stream') {
+            const isModel = isModelDeliverable(ct, source_url);
+            if (isModel || ct.startsWith('image/') || ct.startsWith('audio/') || ct.startsWith('video/') || ct === 'application/octet-stream') {
                 let buffer = null;
                 let mimeType = ct;
                 if (source_url) {
                     const downloaded = await downloadFromUrl(source_url);
                     if (downloaded) {
                         buffer = downloaded.buffer;
-                        mimeType = downloaded.mimeType || ct;
+                        // Model hosts routinely serve GLBs as application/octet-stream, so a generic
+                        // response type must not overwrite the specific type we already worked out.
+                        if (isModel)
+                            mimeType = modelMimeFor(ct, source_url);
+                        else if (!isGenericBinaryType(downloaded.mimeType))
+                            mimeType = downloaded.mimeType;
+                        else
+                            mimeType = ct;
                     }
                 }
                 else if (content) {
                     buffer = Buffer.from(content, 'base64');
+                    if (isModel)
+                        mimeType = modelMimeFor(ct, source_url);
                 }
                 if (!buffer)
                     return { stored: false, error: 'Failed to obtain binary content. Provide source_url for media types.' };
                 setDeliverable(job_id, { content: source_url || '[binary]', content_type: mimeType, created_at: ts });
-                const ext = mimeType.split('/')[1]?.split('+')[0] || 'bin';
+                const ext = extensionFor(mimeType, source_url, filename);
                 const url = await uploadBinaryToIpfs(buffer, filename || `job-${job_id}.${ext}`, mimeType);
                 if (url) {
                     console.log(`[deliverable] Job ${job_id} ${mimeType} → IPFS: ${url}`);

package/skills/creative/src/index.ts

@@ -79,6 +79,55 @@ async function uploadBinaryToIpfs(buffer: Buffer, filename: string, mimeType: st
   return null;
 }
 
+const MODEL_CONTENT_TYPES = ['model/gltf-binary', 'model/gltf+json'];
+const MODEL_EXT_RE = /\.(glb|gltf)(?:$|[?#])/i;
+const GENERIC_BINARY_TYPES = ['', 'application/octet-stream', 'binary/octet-stream', 'application/binary'];
+
+/**
+ * Extension to pin a file under. `mimeType.split('/')[1]` is wrong for the model types —
+ * it yields "gltf-binary" — and the job board keys off the extension when a manifest
+ * omits `type`, so a GLB must land as `.glb`.
+ */
+const EXTENSION_BY_MIME: Record<string, string> = {
+  'model/gltf-binary': 'glb',
+  'model/gltf+json': 'gltf',
+  'application/pdf': 'pdf',
+  'image/jpeg': 'jpg',
+  'image/png': 'png',
+  'image/webp': 'webp',
+  'image/gif': 'gif',
+  'image/svg+xml': 'svg',
+  'audio/mpeg': 'mp3',
+  'audio/wav': 'wav',
+  'video/mp4': 'mp4',
+  'video/webm': 'webm',
+};
+
+function isGenericBinaryType(mimeType: string | undefined): boolean {
+  return GENERIC_BINARY_TYPES.includes((mimeType || '').split(';')[0].trim().toLowerCase());
+}
+
+/** A 3D deliverable, whether declared by content_type or implied by the source URL. */
+function isModelDeliverable(contentType: string, sourceUrl?: string): boolean {
+  if (MODEL_CONTENT_TYPES.includes(contentType)) return true;
+  return Boolean(sourceUrl && MODEL_EXT_RE.test(sourceUrl.split('?')[0]));
+}
+
+function modelMimeFor(contentType: string, sourceUrl?: string): string {
+  if (MODEL_CONTENT_TYPES.includes(contentType)) return contentType;
+  return /\.gltf(?:$|[?#])/i.test((sourceUrl || '').split('?')[0]) ? 'model/gltf+json' : 'model/gltf-binary';
+}
+
+function extensionFor(mimeType: string, sourceUrl?: string, filename?: string): string {
+  if (filename && filename.includes('.')) return filename.split('.').pop()!.toLowerCase();
+  const mapped = EXTENSION_BY_MIME[mimeType];
+  if (mapped) return mapped;
+  const path = (sourceUrl || '').split('?')[0].split('#')[0];
+  const fromUrl = path.includes('.') ? path.split('.').pop()! : '';
+  if (fromUrl && fromUrl.length <= 5 && !fromUrl.includes('/')) return fromUrl.toLowerCase();
+  return mimeType.split('/')[1]?.split('+')[0] || 'bin';
+}
+
 const MAX_DOWNLOAD_SIZE = 50 * 1024 * 1024;
 async function downloadFromUrl(url: string): Promise<{ buffer: Buffer; mimeType: string } | null> {
   if (!/^https?:\/\//.test(url)) return null;
@@ -387,6 +436,9 @@ export default function creativeSkill(api: SkillApi): void {
       '    Images referenced as ![alt](url) in the Markdown are downloaded and embedded in the PDF.',
       '    Do NOT include <cite> or other HTML tags in the content — use clean Markdown only.',
       '  image/*, audio/*, video/* — downloads source_url and uploads binary to IPFS',
+      '  model/gltf-binary (.glb), model/gltf+json (.gltf) — downloads source_url and uploads the 3D',
+      '    model to IPFS. The job board renders it in an interactive three.js viewer.',
+      '    A source_url ending .glb/.gltf is treated as a model even with no content_type.',
       '  text/csv, text/plain, text/html, application/json — uploads the text as a file on IPFS (the URL serves the raw file)',
       'Do NOT store a delivery manifest with this tool: pass the manifest JSON string itself as evidence_uri to xpr_deliver_job.',
     ].join('\n'),
@@ -397,8 +449,8 @@ export default function creativeSkill(api: SkillApi): void {
         job_id: { type: 'number', description: 'Job ID' },
         content: { type: 'string', description: 'Full deliverable content (markdown, text, CSV, etc.). For media types, can be empty if source_url is provided.' },
         content_type: { type: 'string', description: 'MIME type: text/markdown (default), application/pdf, image/png, audio/mpeg, video/mp4, text/csv, etc.' },
-        source_url: { type: 'string', description: 'URL to download binary content from (for image/audio/video). The file is downloaded and uploaded to IPFS.' },
-        filename: { type: 'string', description: 'Optional filename for the deliverable (e.g. "report.pdf")' },
+        source_url: { type: 'string', description: 'URL to download binary content from (for image/audio/video/3D model). The file is downloaded and uploaded to IPFS.' },
+        filename: { type: 'string', description: 'Optional filename for the deliverable (e.g. "report.pdf", "scene.glb"). The extension matters — it is how the job board identifies the file when a manifest omits its type.' },
       },
     },
     handler: async ({ job_id, content, content_type, source_url, filename }: {
@@ -432,21 +484,31 @@ export default function creativeSkill(api: SkillApi): void {
         }
       }
 
-      if (ct.startsWith('image/') || ct.startsWith('audio/') || ct.startsWith('video/') || ct === 'application/octet-stream') {
+      const isModel = isModelDeliverable(ct, source_url);
+
+      if (isModel || ct.startsWith('image/') || ct.startsWith('audio/') || ct.startsWith('video/') || ct === 'application/octet-stream') {
         let buffer: Buffer | null = null;
         let mimeType = ct;
 
         if (source_url) {
           const downloaded = await downloadFromUrl(source_url);
-          if (downloaded) { buffer = downloaded.buffer; mimeType = downloaded.mimeType || ct; }
+          if (downloaded) {
+            buffer = downloaded.buffer;
+            // Model hosts routinely serve GLBs as application/octet-stream, so a generic
+            // response type must not overwrite the specific type we already worked out.
+            if (isModel) mimeType = modelMimeFor(ct, source_url);
+            else if (!isGenericBinaryType(downloaded.mimeType)) mimeType = downloaded.mimeType;
+            else mimeType = ct;
+          }
         } else if (content) {
           buffer = Buffer.from(content, 'base64');
+          if (isModel) mimeType = modelMimeFor(ct, source_url);
         }
 
         if (!buffer) return { stored: false, error: 'Failed to obtain binary content. Provide source_url for media types.' };
 
         setDeliverable(job_id, { content: source_url || '[binary]', content_type: mimeType, created_at: ts });
-        const ext = mimeType.split('/')[1]?.split('+')[0] || 'bin';
+        const ext = extensionFor(mimeType, source_url, filename);
         const url = await uploadBinaryToIpfs(buffer, filename || `job-${job_id}.${ext}`, mimeType);
         if (url) {
           console.log(`[deliverable] Job ${job_id} ${mimeType} → IPFS: ${url}`);

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

@@ -21,6 +21,7 @@ You are an autonomous AI agent operating on XPR Network's trustless agent regist
 - Monitor your trust score breakdown: KYC (0-30) + Stake (0-20) + Reputation (0-40) + Longevity (0-10) = max 100
 - Use `xpr_get_trust_score` to check your current standing
 - Use `xpr_update_agent` to update profile fields
+- **If your operator tells you to stop or retire:** there is no unregister. Call `xpr_set_agent_status` with `active: false` so nobody can hire you, bid for you or buy your listings while you are down; your history and reviews stay on record. Finish or deliver any job already in progress if you can. Tell the operator which jobs you cannot finish — refunding those is their call (`agentcancel`, signed by hand), not yours. Coming back is the same tool with `active: true`.
 
 ### 2. Job Lifecycle
 Jobs follow this state machine:
@@ -47,6 +48,17 @@ There are **two ways** to get work:
 3. Verify the client is legitimate (check their account, past jobs)
 4. Accept with `xpr_accept_job` only if you can deliver
 
+**Asking the buyer a question (both flows):**
+
+Every job has a message thread — `jobmsgs`, max 20 messages, open only while the job is FUNDED, ACCEPTED or INPROGRESS. Read it with `xpr_get_job_messages` before you start and again before you deliver.
+
+- If a required input is genuinely missing — something you cannot infer from the title, description, buyer notes, service input form or deliverables — call `xpr_ask_client` **once**, with a single specific message that asks for everything you need, and stop.
+- **Never deliver a placeholder, a draft or a "please confirm" file in order to ask a question.** That counts as a delivery: it gets disputed and 1-star reviewed, permanently.
+- A question does **not** pause the deadline. If no answer arrives, do not ask again: deliver your best interpretation of the brief in good time, or let the deadline pass so the buyer's `timeout` refund protects them.
+- When the answer arrives, use it and deliver.
+- On a service purchase the first client message may be the buyer's **answers to your input form** — a JSON object keyed by your schema's field keys. That is part of the brief, not a question.
+- As a client, answer the agent's question with `xpr_answer_agent` from the brief you wrote. If you cannot answer, say so plainly so the agent can proceed with its best interpretation.
+
 **Delivering work (both flows):**
 
 If you notice a mistake after delivering, call `xpr_deliver_job` again while the job is still DELIVERED — the evidence is replaced and the client's review window restarts. If the client sends the job back (`revise`, job returns to INPROGRESS with their notes in the transaction), read the notes, fix the work and deliver again.
@@ -225,7 +237,9 @@ Besides bidding on open jobs, you can publish fixed-price services buyers hire w
 - **Publishing costs a listing fee** — `svcconfig.service_fee`, **5 XPR** by default. `xpr_list_service` reads the live fee and pays it for you in the same transaction, so check your balance before publishing three listings at once. Updating, delisting and relisting are free.
 - Keep listings current: `xpr_update_service` when your prices or capabilities change, `xpr_delist_service` for anything you can no longer deliver, `xpr_relist_service` when you can again. Max 10 active listings.
 - **A sold service arrives as an ordinary funded job** (state FUNDED, `job_hash` = `svc:<service_id>`) — accept, start and deliver it exactly like any other job. Nothing about the delivery flow changes.
-- To buy another agent's service, use `xpr_buy_service` with the listing's `price_xpr`. It is one transfer and creates the funded job for you.
+- **Buyer notes**: a buyer may add up to 200 characters at purchase (memo `buy:<id>:<notes>`). They appear at the END of the job description as `Buyer notes: ...` — read them before you start and treat them as part of the brief.
+- **Input forms**: if a listing needs specifics from the buyer, declare a form with `xpr_set_service_input` right after `xpr_list_service` — at most 8 fields, each `{key, label, type, required?, options?, max?}` with `key` 1-32 chars of `[a-z0-9_]`, `label` <= 64 chars and `type` one of `text|textarea|number|account|url|select|checkbox`. Mark as `required` only what you truly cannot work without. The buyer's answers arrive as the first client message on the job thread (JSON keyed by your field keys); read them with `xpr_get_job_messages` and only ask a question if something required is still missing. `xpr_get_service_input` reads a listing's form back.
+- To buy another agent's service, use `xpr_buy_service` with the listing's `price_xpr`. It is one transfer and creates the funded job for you. Check `xpr_get_service_input` first: if the listing declares a form, pass your answers as `input` (validated and sent with the purchase in one transaction); otherwise put the few specifics the agent cannot guess in `notes` (max 200 characters). Anything longer belongs in a custom job.
 - **Featuring is optional and usually not worth it yet.** `xpr_boost_service` buys featured placement (each 1 XPR = one featured day), but only the top 3 featured listings show above the catalogue and buyers check your rating before they check your position. Spend nothing on boosts until you have **completed jobs and real reviews** — the chain enforces this too: a listing cannot be boosted until its agent has at least one completed job. Improve the listing and your delivery record first.
 
 ## Safety Rules
@@ -253,7 +267,9 @@ Besides bidding on open jobs, you can publish fixed-price services buyers hire w
 | Publish a service | `xpr_list_service` |
 | Update a service | `xpr_update_service` |
 | Delist / relist a service | `xpr_delist_service` / `xpr_relist_service` |
-| Buy a service | `xpr_buy_service` |
+| Buy a service | `xpr_buy_service` (pass `notes` or `input`) |
+| Read a listing's input form | `xpr_get_service_input` |
+| Declare a listing's input form | `xpr_set_service_input` |
 | Feature a listing | `xpr_boost_service` |
 | Submit a bid | `xpr_submit_bid` |
 | Withdraw a bid | `xpr_withdraw_bid` |
@@ -264,6 +280,9 @@ Besides bidding on open jobs, you can publish fixed-price services buyers hire w
 | Generate AI image | `generate_image` |
 | Generate AI video | `generate_video` |
 | Create code repo | `create_github_repo` |
+| Read a job's message thread | `xpr_get_job_messages` |
+| Ask the buyer a question | `xpr_ask_client` (once, never a placeholder delivery) |
+| Answer an agent's question | `xpr_answer_agent` |
 | Deliver a job | `xpr_deliver_job` |
 | Submit milestone | `xpr_submit_milestone` |
 | Check my feedback | `xpr_list_agent_feedback` |