kloudy 0.4.4 → 0.4.5

package/schemas/sdf-webpage-v1.schema.json

@@ -1,176 +1,176 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kloudy.ai/schemas/sdf-webpage-v1.schema.json",
-  "title": "Kloudy extractive SDF webpage profile v1",
-  "allOf": [
-    {
-      "$ref": "https://sdfprotocol.org/schemas/sdf-document-0.2.schema.json"
-    }
-  ],
-  "type": "object",
-  "required": [
-    "sections",
-    "extensions",
-    "metadata",
-    "links",
-    "entities"
-  ],
-  "properties": {
-    "parent_type": {
-      "const": "article"
-    },
-    "type": {
-      "const": "article.x-kloudy-webpage"
-    },
-    "entities": {
-      "maxItems": 0
-    },
-    "sections": {
-      "type": "array",
-      "minItems": 1,
-      "maxItems": 40,
-      "items": {
-        "type": "object",
-        "properties": {
-          "title": {
-            "type": "string",
-            "maxLength": 160
-          },
-          "summary": {
-            "type": "string",
-            "maxLength": 1600
-          }
-        },
-        "required": [
-          "title",
-          "summary"
-        ]
-      }
-    },
-    "links": {
-      "maxItems": 50,
-      "items": {
-        "type": "object",
-        "properties": {
-          "href": {
-            "type": "string",
-            "maxLength": 2048
-          },
-          "title": {
-            "type": "string",
-            "maxLength": 160
-          },
-          "rel": {
-            "const": "references"
-          }
-        },
-        "required": [
-          "href",
-          "title",
-          "rel"
-        ]
-      }
-    },
-    "extensions": {
-      "type": "object",
-      "required": [
-        "x-kloudy"
-      ],
-      "properties": {
-        "x-kloudy": {
-          "type": "object",
-          "required": [
-            "profile",
-            "interaction_mode",
-            "capabilities",
-            "ownership_verified",
-            "published",
-            "truncated",
-            "resolution"
-          ],
-          "properties": {
-            "profile": {
-              "const": "kloudy.sdf.webpage/1"
-            },
-            "interaction_mode": {
-              "const": "informational_only"
-            },
-            "capabilities": {
-              "type": "array",
-              "maxItems": 0
-            },
-            "ownership_verified": {
-              "const": false
-            },
-            "published": {
-              "const": false
-            },
-            "truncated": {
-              "type": "boolean"
-            },
-            "resolution": {
-              "enum": [
-                "compact",
-                "standard"
-              ]
-            }
-          }
-        }
-      }
-    },
-    "source": {
-      "type": "object",
-      "properties": {
-        "url": {
-          "maxLength": 4096
-        },
-        "title": {
-          "type": "string",
-          "maxLength": 200
-        }
-      },
-      "required": [
-        "title"
-      ]
-    },
-    "metadata": {
-      "type": "object",
-      "properties": {
-        "title": {
-          "type": "string",
-          "maxLength": 200
-        }
-      },
-      "required": [
-        "title"
-      ]
-    },
-    "summary": {
-      "type": "object",
-      "properties": {
-        "brief": {
-          "maxLength": 300
-        },
-        "key_points": {
-          "maxItems": 4,
-          "items": {
-            "type": "string",
-            "maxLength": 200
-          }
-        }
-      }
-    },
-    "type_data": {
-      "type": "object",
-      "required": [
-        "headline"
-      ],
-      "properties": {
-        "headline": {
-          "type": "string",
-          "maxLength": 200
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kloudy.ai/schemas/sdf-webpage-v1.schema.json",
+  "title": "Kloudy extractive SDF webpage profile v1",
+  "allOf": [
+    {
+      "$ref": "https://sdfprotocol.org/schemas/sdf-document-0.2.schema.json"
+    }
+  ],
+  "type": "object",
+  "required": [
+    "sections",
+    "extensions",
+    "metadata",
+    "links",
+    "entities"
+  ],
+  "properties": {
+    "parent_type": {
+      "const": "article"
+    },
+    "type": {
+      "const": "article.x-kloudy-webpage"
+    },
+    "entities": {
+      "maxItems": 0
+    },
+    "sections": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 40,
+      "items": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string",
+            "maxLength": 160
+          },
+          "summary": {
+            "type": "string",
+            "maxLength": 1600
+          }
+        },
+        "required": [
+          "title",
+          "summary"
+        ]
+      }
+    },
+    "links": {
+      "maxItems": 50,
+      "items": {
+        "type": "object",
+        "properties": {
+          "href": {
+            "type": "string",
+            "maxLength": 2048
+          },
+          "title": {
+            "type": "string",
+            "maxLength": 160
+          },
+          "rel": {
+            "const": "references"
+          }
+        },
+        "required": [
+          "href",
+          "title",
+          "rel"
+        ]
+      }
+    },
+    "extensions": {
+      "type": "object",
+      "required": [
+        "x-kloudy"
+      ],
+      "properties": {
+        "x-kloudy": {
+          "type": "object",
+          "required": [
+            "profile",
+            "interaction_mode",
+            "capabilities",
+            "ownership_verified",
+            "published",
+            "truncated",
+            "resolution"
+          ],
+          "properties": {
+            "profile": {
+              "const": "kloudy.sdf.webpage/1"
+            },
+            "interaction_mode": {
+              "const": "informational_only"
+            },
+            "capabilities": {
+              "type": "array",
+              "maxItems": 0
+            },
+            "ownership_verified": {
+              "const": false
+            },
+            "published": {
+              "const": false
+            },
+            "truncated": {
+              "type": "boolean"
+            },
+            "resolution": {
+              "enum": [
+                "compact",
+                "standard"
+              ]
+            }
+          }
+        }
+      }
+    },
+    "source": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "maxLength": 4096
+        },
+        "title": {
+          "type": "string",
+          "maxLength": 200
+        }
+      },
+      "required": [
+        "title"
+      ]
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "maxLength": 200
+        }
+      },
+      "required": [
+        "title"
+      ]
+    },
+    "summary": {
+      "type": "object",
+      "properties": {
+        "brief": {
+          "maxLength": 300
+        },
+        "key_points": {
+          "maxItems": 4,
+          "items": {
+            "type": "string",
+            "maxLength": 200
+          }
+        }
+      }
+    },
+    "type_data": {
+      "type": "object",
+      "required": [
+        "headline"
+      ],
+      "properties": {
+        "headline": {
+          "type": "string",
+          "maxLength": 200
+        }
+      }
+    }
+  }
+}

package/src/activity.mjs

@@ -1,23 +1,23 @@
-// Public host adapter: operation state only. Never emits arguments, receipts or secrets.
-const METHODS=new Set(['conversation','negotiateHost','action','walletConnection','hosting','wallet','introduce','ask','query','assemble','call','status','confirm','decide']);
-export function observeClient(client,onActivity){
- if(!client||typeof onActivity!=='function')throw TypeError('Provide a Kloudy client and activity listener.');
- let active=0,sequence=0;
- const emit=(state,operation)=>{try{onActivity(Object.freeze({schema:'kloudy.activity/1',source:'kloudy',sequence:++sequence,state,operation}));}catch{/* A display listener cannot break or retry an engine action. */}};
- return new Proxy(client,{get(target,key){const value=Reflect.get(target,key);if(typeof value!=='function')return value;if(!METHODS.has(key))return value.bind(target);return async(...args)=>{active++;emit('thinking',key);try{const result=await value.apply(target,args);active--;const state=result?.state;emit(active?'thinking':state==='awaiting_approval'?'waiting':['queued','running'].includes(state)?'thinking':state==='failed'?'error':'idle',key);return result;}catch(error){active--;emit(active?'thinking':'error',key);throw error;}};}});
-}
-
-// A compatible IDE can mount this in its own status surface. This does not inject UI
-// into arbitrary IDEs or claim that MCP alone owns a host's status bar.
-export function mountStatusIndicator(root){
- const doc=root.ownerDocument,wrap=doc.createElement('span'),label=doc.createElement('span'),orb=doc.createElement('span');
- wrap.className='kloudy-indicator';wrap.setAttribute('role','status');wrap.setAttribute('aria-label','Kloudy ready');label.textContent='Kloudy';label.className='kloudy-indicator-label';orb.className='kloudy-indicator-orb';orb.setAttribute('aria-hidden','true');wrap.append(label,orb);root.append(wrap);wrap.dataset.state='idle';
- return {update(event){if(event?.schema!=='kloudy.activity/1'||event.source!=='kloudy'||!['idle','thinking','waiting','error','listening','speaking'].includes(event.state))return;wrap.dataset.state=event.state;wrap.setAttribute('aria-label','Kloudy '+({idle:'ready',thinking:'working',waiting:'needs approval',error:'could not finish',listening:'listening through your device',speaking:'speaking through your device'}[event.state]));},dispose(){wrap.remove();}};
-}
-
-// Covers every actual MCP tool call, including public reads and model discovery.
-export function instrumentToolHandler(handler,onActivity=()=>{}){
- let active=0,sequence=0;
- const emit=state=>{try{onActivity({schema:'kloudy.activity/1',source:'kloudy',sequence:++sequence,state,operation:'tool_call'});}catch{}};
- return async request=>{active++;emit('thinking');let state='error';try{const result=await handler(request);state=result?.isError?'error':result?._meta?.kloudyApproval?'waiting':['queued','running'].includes(result?.structuredContent?.state)?'thinking':'idle';return result;}finally{active--;emit(active?'thinking':state);}};
-}
+// Public host adapter: operation state only. Never emits arguments, receipts or secrets.
+const METHODS=new Set(['conversation','negotiateHost','action','walletConnection','hosting','wallet','introduce','ask','query','assemble','call','status','confirm','decide']);
+export function observeClient(client,onActivity){
+ if(!client||typeof onActivity!=='function')throw TypeError('Provide a Kloudy client and activity listener.');
+ let active=0,sequence=0;
+ const emit=(state,operation)=>{try{onActivity(Object.freeze({schema:'kloudy.activity/1',source:'kloudy',sequence:++sequence,state,operation}));}catch{/* A display listener cannot break or retry an engine action. */}};
+ return new Proxy(client,{get(target,key){const value=Reflect.get(target,key);if(typeof value!=='function')return value;if(!METHODS.has(key))return value.bind(target);return async(...args)=>{active++;emit('thinking',key);try{const result=await value.apply(target,args);active--;const state=result?.state;emit(active?'thinking':state==='awaiting_approval'?'waiting':['queued','running'].includes(state)?'thinking':state==='failed'?'error':'idle',key);return result;}catch(error){active--;emit(active?'thinking':'error',key);throw error;}};}});
+}
+
+// A compatible IDE can mount this in its own status surface. This does not inject UI
+// into arbitrary IDEs or claim that MCP alone owns a host's status bar.
+export function mountStatusIndicator(root){
+ const doc=root.ownerDocument,wrap=doc.createElement('span'),label=doc.createElement('span'),orb=doc.createElement('span');
+ wrap.className='kloudy-indicator';wrap.setAttribute('role','status');wrap.setAttribute('aria-label','Kloudy ready');label.textContent='Kloudy';label.className='kloudy-indicator-label';orb.className='kloudy-indicator-orb';orb.setAttribute('aria-hidden','true');wrap.append(label,orb);root.append(wrap);wrap.dataset.state='idle';
+ return {update(event){if(event?.schema!=='kloudy.activity/1'||event.source!=='kloudy'||!['idle','thinking','waiting','error','listening','speaking'].includes(event.state))return;wrap.dataset.state=event.state;wrap.setAttribute('aria-label','Kloudy '+({idle:'ready',thinking:'working',waiting:'needs approval',error:'could not finish',listening:'listening through your device',speaking:'speaking through your device'}[event.state]));},dispose(){wrap.remove();}};
+}
+
+// Covers every actual MCP tool call, including public reads and model discovery.
+export function instrumentToolHandler(handler,onActivity=()=>{}){
+ let active=0,sequence=0;
+ const emit=state=>{try{onActivity({schema:'kloudy.activity/1',source:'kloudy',sequence:++sequence,state,operation:'tool_call'});}catch{}};
+ return async request=>{active++;emit('thinking');let state='error';try{const result=await handler(request);state=result?.isError?'error':result?._meta?.kloudyApproval?'waiting':['queued','running'].includes(result?.structuredContent?.state)?'thinking':'idle';return result;}finally{active--;emit(active?'thinking':state);}};
+}

package/src/approval.mjs

@@ -1,25 +1,25 @@
-import {randomUUID} from 'node:crypto';
-export const approvalResource='ui://kloudy/approval.html';
-export const approvalTool={name:'kloudy_approval',description:'Submit the exact pending decision from the Kloudy approval view.',inputSchema:{type:'object',properties:{ticket:{type:'string'},decision:{type:'string',enum:['approve','cancel']}},required:['ticket','decision'],additionalProperties:false},_meta:{ui:{resourceUri:approvalResource,visibility:['app']}}};
-export class Approvals {
- constructor({now=()=>Date.now()}={}){this.now=now;this.pending=new Map();}
- present(result,selectionId,connection){
-  if(result?.state!=='awaiting_approval')return {content:[{type:'text',text:JSON.stringify(result)}],structuredContent:result};
-  const a=result.approval,expires=Number(a?.expires_at)*1000,risk=a?.risk_tier??a?.risk;
-  // Do not fabricate a token or let incomplete backend state create an approval.
-  if(!a||typeof a.token!=='string'||!a.token||a.token.length>512||typeof risk!=='string'||!risk.trim()||risk.length>64||!(typeof a.summary==='string'||a.summary&&typeof a.summary==='object')||!selectionId||!Number.isFinite(expires)||expires<=this.now())return {isError:true,content:[{type:'text',text:'The exact approval is missing or expired. Refresh the engine request.'}]};
-  for(const [id,p] of this.pending)if(p.expires<=this.now())this.pending.delete(id);
-  if(this.pending.size>=32)throw Error('Too many pending approvals');
-  const ticket=randomUUID();this.pending.set(ticket,{selectionId,token:a.token,expires,connection});
-  const summary={state:result.state,summary:a.summary,risk_tier:a.risk_tier??a.risk,expires_at:a.expires_at,notice:'Approve or cancel using the inline Kloudy view. Hosts without MCP Apps must provide their own consent UI; no approval was submitted.'};
-  return {content:[{type:'text',text:JSON.stringify(summary)}],structuredContent:summary,_meta:{kloudyApproval:{...summary,ticket},ui:{resourceUri:approvalResource}}};
- }
- async decide(input,useClient){
-  if(!input||Object.keys(input).some(k=>!['ticket','decision'].includes(k))||!['approve','cancel'].includes(input.decision))throw Error('Invalid approval decision');
-  const pending=this.pending.get(input.ticket);if(!pending||pending.expires<=this.now()){this.pending.delete(input.ticket);throw Error('Approval missing or expired');}
-  // Consume before dispatch, including an ambiguous network failure. Never retry
-  // a mutation silently; the host must inspect the engine receipt afterwards.
-  this.pending.delete(input.ticket);
-  return (pending.connection||useClient)(client=>input.decision==='approve'?client.confirm({selectionId:pending.selectionId,token:pending.token,decision:'approve',source:'tap'}):client.rpc('kloudy/cancel',{selection_id:pending.selectionId}));
- }
-}
+import {randomUUID} from 'node:crypto';
+export const approvalResource='ui://kloudy/approval.html';
+export const approvalTool={name:'kloudy_approval',description:'Submit the exact pending decision from the Kloudy approval view.',inputSchema:{type:'object',properties:{ticket:{type:'string'},decision:{type:'string',enum:['approve','cancel']}},required:['ticket','decision'],additionalProperties:false},_meta:{ui:{resourceUri:approvalResource,visibility:['app']}}};
+export class Approvals {
+ constructor({now=()=>Date.now()}={}){this.now=now;this.pending=new Map();}
+ present(result,selectionId,connection){
+  if(result?.state!=='awaiting_approval')return {content:[{type:'text',text:JSON.stringify(result)}],structuredContent:result};
+  const a=result.approval,expires=Number(a?.expires_at)*1000,risk=a?.risk_tier??a?.risk;
+  // Do not fabricate a token or let incomplete backend state create an approval.
+  if(!a||typeof a.token!=='string'||!a.token||a.token.length>512||typeof risk!=='string'||!risk.trim()||risk.length>64||!(typeof a.summary==='string'||a.summary&&typeof a.summary==='object')||!selectionId||!Number.isFinite(expires)||expires<=this.now())return {isError:true,content:[{type:'text',text:'The exact approval is missing or expired. Refresh the engine request.'}]};
+  for(const [id,p] of this.pending)if(p.expires<=this.now())this.pending.delete(id);
+  if(this.pending.size>=32)throw Error('Too many pending approvals');
+  const ticket=randomUUID();this.pending.set(ticket,{selectionId,token:a.token,expires,connection});
+  const summary={state:result.state,summary:a.summary,risk_tier:a.risk_tier??a.risk,expires_at:a.expires_at,notice:'Approve or cancel using the inline Kloudy view. Hosts without MCP Apps must provide their own consent UI; no approval was submitted.'};
+  return {content:[{type:'text',text:JSON.stringify(summary)}],structuredContent:summary,_meta:{kloudyApproval:{...summary,ticket},ui:{resourceUri:approvalResource}}};
+ }
+ async decide(input,useClient){
+  if(!input||Object.keys(input).some(k=>!['ticket','decision'].includes(k))||!['approve','cancel'].includes(input.decision))throw Error('Invalid approval decision');
+  const pending=this.pending.get(input.ticket);if(!pending||pending.expires<=this.now()){this.pending.delete(input.ticket);throw Error('Approval missing or expired');}
+  // Consume before dispatch, including an ambiguous network failure. Never retry
+  // a mutation silently; the host must inspect the engine receipt afterwards.
+  this.pending.delete(input.ticket);
+  return (pending.connection||useClient)(client=>input.decision==='approve'?client.confirm({selectionId:pending.selectionId,token:pending.token,decision:'approve',source:'tap'}):client.rpc('kloudy/cancel',{selection_id:pending.selectionId}));
+ }
+}

package/src/autoupdate.mjs

@@ -0,0 +1,2 @@
+// Invalid and unset rollout modes fail closed. Configuration never enables itself.
+export const autoupdateEnabled=mode=>mode==='meta'||mode==='notify';