kloudy 0.4.2 → 0.4.4

package/README.md

@@ -6,7 +6,7 @@ npx kloudy find github MCP tools
 npx kloudy mcp
 ```
 
-Node.js 20.19+ is required. Run `npx kloudy` to install, or `npx kloudy@0.4.2` to pin this release. A downloadable tarball is also available at https://kloudy.ai/downloads/kloudy-open-0.4.2.tgz.
+Node.js 20.19+ is required. Run `npx kloudy` to install, or `npx kloudy@0.4.3` to pin this release. A downloadable tarball is also available at https://kloudy.ai/downloads/kloudy-open-0.4.3.tgz.
 
 No arguments detects Cursor, VS Code, Claude Desktop, Claude Code, Windsurf and Codex configurations and asks before writing **each** one. Declining or non-interactive input changes nothing. Existing servers and existing Kloudy entries are preserved. JSONC comments in VS Code and TOML comments in Codex remain intact. Backups are created; malformed or concurrently changed configs are left untouched. Normal OS file permissions apply on Windows; protect config files that contain keys.
 
@@ -303,3 +303,5 @@ MCP: operation `conversation`, `conversation_operation` = `read`, `append` or `s
 `append` takes `project`, `conversation_id`, `idempotency_key`, `expected_revision`, `title`, `user`, `assistant`, `decisions` and `built_artifacts`. Use a stable idempotency key for the same exchange, an explicitly observed revision, up to 1500 characters per message, four decisions/artifact pointers at most, and a total canonical request no larger than 7000 bytes. Send only content the user authorized for sync. A new conversation explicitly starts at revision zero. `sync` takes the same cursor/idempotency fields plus `reason`: `checkpoint`, `session_end`, `device_switch`, `before_sync` or `idle`.
 
 The engine owns encryption, scope checks, condensation gates and transcript deletion. Returned cards are lossy context, never grants. Artifact pointers do not authorize repository reads. The client never persists message bodies in its session file. Replayed commands return metadata only: issue a read for current cards. Conflicts and failures are not retried automatically; read the cursor and reconcile before resubmitting. Added in 0.4.1. The no-key installer and public discovery remain unchanged.
+
+Official MCP Registry name: `ai.kloudy/kloudy`. Remote endpoint: https://kloudy.ai/mcp. Public discovery and Sample cards do not grant private tools or authorize spending.

package/bin/entry.mjs

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import {readFileSync} from 'node:fs';
+const version=JSON.parse(readFileSync(new URL('../package.json',import.meta.url),'utf8')).version;
 import {createInterface} from 'node:readline/promises';
 import {installEditors} from '../src/editor-install.mjs';
 import {askRemote,serveRemote} from '../src/remote.mjs';
@@ -9,11 +11,11 @@ try{
   let rl;
   const confirm=async({client,path,authenticated})=>{if(!process.stdin.isTTY){console.log(`${client}: skipped — run in an interactive terminal to approve ${path}`);return false;}rl??=createInterface({input:process.stdin,output:process.stdout});return /^(y|yes)$/i.test((await rl.question(`Add Kloudy to ${client}? ${path}${authenticated?' (stores your key)':''} [y/N] `)).trim());};
   let results;try{results=await installEditors({confirm,key:process.env.KLOUDY_MCP_TOKEN,onResult:r=>console.log(`${r.client}: ${r.state}`)});}finally{rl?.close();}
-  if(!results.length)console.log('No supported editor configuration found. Open https://kloudy.ai/install for one-click Cursor and VS Code links.');
+  if(!results.length)console.log('No supported editor configuration found. Open https://kloudy.ai/install for setup help.');
   else console.log('Existing servers were preserved. Restart configured clients to connect.');
   if(results.some(r=>r.state==='unchanged_error'))process.exitCode=1;
  }else if(args[0]==='mcp'&&args.length===1){await serveRemote();}
- else if(args[0]==='--version'){console.log('0.4.2');}
+ else if(args[0]==='--version'){console.log(version);}
  else if(['--help','help'].includes(args[0]))console.log('npx kloudy                 Add to detected editors (asks before each write)\nnpx kloudy <question>      Ask the public Kloudy MCP endpoint\nnpx kloudy mcp             Remote MCP over local stdio\nnpx kloudy legacy <args>   Existing SDK/engine CLI commands\n\nFree discovery needs no key. For authorized account actions set KLOUDY_MCP_TOKEN privately; never put a key in command arguments. Node 20.19+ required.');
  else if(args[0]==='legacy'){process.argv.splice(2,1);await import('./kloudy.mjs');}
  else{if(args[0]?.startsWith('--'))throw Error('Unknown option');const result=await askRemote(args.join(' '));for(const c of result.content||[])if(c.type==='text')process.stdout.write((process.env.KLOUDY_MCP_TOKEN?c.text.replaceAll(process.env.KLOUDY_MCP_TOKEN,'[redacted]'):c.text)+'\n');if(result.isError)process.exitCode=1;}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kloudy",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Ask for Kloudy: CLI, MCP and SDK clients for the same scoped engine session.",
   "type": "module",
   "license": "Apache-2.0",
@@ -56,7 +56,7 @@
   "devDependencies": {
     "esbuild": "0.28.2"
   },
-  "mcpName": "io.github.Gio300/kloudy",
+  "mcpName": "ai.kloudy/kloudy",
   "homepage": "https://kloudy.ai/install",
   "publishConfig": {
     "access": "public",

package/src/connect-card.mjs

@@ -0,0 +1,36 @@
+import {connectHTML,publicConnectHTML} from './connect-ui.mjs';
+
+export const CONNECT_URI='ui://widget/kloudy-connect-v1.html';
+export const connectResource={uri:CONNECT_URI,name:'Kloudy setup',description:'Sign in or choose a Kloudy front door. Navigation only.',mimeType:'text/html;profile=mcp-app'};
+export const connectTool={
+ name:'kloudy_connect_card',
+ title:'Kloudy sign-in and install card',
+ description:'Show sign-in or install choices. First call find_mcp_tools with operation ask and a short setup request. If it returns kind account or connect, call this card once with the returned mode. Opening setup does not finish sign-in or installation. Text-only hosts show the returned links.',
+ annotations:{readOnlyHint:true,destructiveHint:false,idempotentHint:true,openWorldHint:false},
+ inputSchema:{type:'object',properties:{mode:{type:'string',enum:['signin','install'],description:'Use the mode returned by find_mcp_tools: signin for account sign-in, or install for editor setup.'}},required:['mode'],additionalProperties:false},
+ _meta:{ui:{resourceUri:CONNECT_URI},'openai/outputTemplate':CONNECT_URI,'openai/toolInvocation/invoking':'Opening Kloudy setup…','openai/toolInvocation/invoked':'Kloudy setup choices'}
+};
+export function connectArguments(value){return !!value&&typeof value==='object'&&!Array.isArray(value)&&Object.keys(value).length===1&&['signin','install'].includes(value.mode);}
+export function connectResult(mode,{publicOnly=false}={}){
+ const install=mode==='install';
+ const message=install?'Choose where to connect Kloudy. Opening setup is not a finished connection.':'Kloudy finds MCP tools and SDKs for your task. Sign in or keep using free discovery.';
+ const actions=install?[
+  {label:'Add to an IDE',url:'https://kloudy.ai/install#clients'},
+  ...(!publicOnly?[{label:'Connect to Muse',url:'https://kloudy.ai/install#muse'}]:[]),
+  {label:'Sign in',url:'https://kloudy.ai/install'}
+ ]:[{label:'Sign in to Kloudy',url:'https://kloudy.ai/install'},{label:'Add to an IDE',url:'https://kloudy.ai/install#clients'}];
+ return {content:[{type:'text',text:message+'\n\n'+actions.map(a=>`[${a.label}](${a.url})`).join('\n')}],structuredContent:{tier:'public',kind:install?'connect':'account',mode,items:[],message,actions,model_calls:0,executed:false}};
+}
+export function connectContents({publicOnly=false}={}){return {contents:[{uri:CONNECT_URI,mimeType:connectResource.mimeType,text:publicOnly?publicConnectHTML:connectHTML,_meta:{
+ ui:{prefersBorder:true,domain:'https://kloudy.ai',csp:{connectDomains:[],resourceDomains:[]}},
+ 'openai/widgetDescription':'Kloudy sign-in and setup choices. No account is created and no tool is authorized by opening a link.',
+ 'openai/widgetPrefersBorder':true,'openai/widgetDomain':'https://kloudy.ai',
+ 'openai/widgetCSP':{connect_domains:[],resource_domains:[],redirect_domains:['https://kloudy.ai','https://cursor.com','https://insiders.vscode.dev']}
+ }}]};}
+// Public UI metadata still requires credential validation when called with a credential.
+export function connectMessage(method,params={}){
+ if(!params||typeof params!=='object'||Array.isArray(params))return false;
+ if(['resources/list','resources/templates/list'].includes(method))return Object.keys(params).length===0;
+ if(method==='resources/read')return Object.keys(params).length===1&&params.uri===CONNECT_URI;
+ return method==='tools/call'&&Object.keys(params).length===2&&params.name==='kloudy_connect_card'&&connectArguments(params.arguments);
+}