onlymcp 0.17.0 → 0.20.0

package/dist/bin/mcp.js

@@ -1,74 +1,46 @@
 #!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { createRequire } from 'node:module';
-import { ApiClient } from '../apiClient.js';
-import { apiBaseUrl } from '../apiBaseUrl.js';
-import { Keyring } from '../auth/keyring.js';
-import { TtlCache } from '../cache.js';
-import { buildInstructions } from '../instructions.js';
-import { stubDirs } from '../paths.js';
-import { serverInfo } from '../registry/serverInfo.js';
-import { writeStubs } from '../stubs.js';
-import { readStubIgnore } from '../stubIgnore.js';
-import { buildTools, listedTools } from '../tools/index.js';
-const { version } = createRequire(import.meta.url)('../../package.json');
-const baseUrl = apiBaseUrl();
-const api = new ApiClient(baseUrl, () => Keyring.read());
-const cache = new TtlCache();
-const tools = buildTools(api, cache);
-// Der Katalog fuers instructions-Feld. Schlaegt der Abruf fehl (offline, nicht
-// angemeldet), bleibt die reine Bedienungsanleitung uebrig: der Client weiss
-// dann immer noch, dass es list_skills gibt, und kommt spaeter selbst dran.
-const catalog = await (async () => {
-    try {
-        // Der Schalter kommt aus dem Konto, nicht aus einer Umgebungsvariablen:
-        // er gehoert dem Menschen und gilt auf jedem seiner Geraete gleich
-        // (Spec 7). Faellt getMe aus, gilt die Vorgabe an - dieselbe wie serverseitig.
-        const [{ skills }, { agents }, me] = await Promise.all([
-            api.listSkills(),
-            api.listAgents(),
-            api.getMe().catch(() => ({ brainvaultMode: true })),
-        ]);
-        return buildInstructions(skills.map((x) => x.name), agents.map((x) => x.name), {
-            brainvault: me.brainvaultMode !== false,
-        });
-    }
-    catch {
-        return buildInstructions([], []);
-    }
-})();
-const server = new Server(
-// Aus der package.json, aus demselben Grund wie bei `onlymcp --version`:
-// eine zweite Stelle mit der Nummer meldet nach der ersten Veroeffentlichung
-// einen Stand, den niemand nachfuehrt. Genau das ist bei 0.1.0 passiert, der
-// Server nannte sich noch 0.0.1. Der Pfad stimmt aus src/bin/ wie dist/bin/.
-serverInfo(baseUrl, version), { capabilities: { tools: {} }, instructions: catalog });
-server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: listedTools(tools) }));
-server.setRequestHandler(CallToolRequestSchema, async (req) => {
-    const tool = tools.find((t) => t.name === req.params.name);
-    if (!tool)
-        return { content: [{ type: 'text', text: 'errors.UNKNOWN_TOOL' }], isError: true };
-    const parsed = tool.inputSchema.safeParse(req.params.arguments ?? {});
-    if (!parsed.success) {
-        return { content: [{ type: 'text', text: 'errors.INVALID_ARGUMENTS' }], isError: true };
-    }
-    return tool.handler(parsed.data);
-});
-// Stubs beim Start auffrischen, fuer jeden Client mit eigenem Scanner. Faellt
-// das aus (offline, nicht angemeldet), laeuft der Server trotzdem an: die
-// vorhandenen Stubs bleiben gueltig, und der eigentliche Fehler zeigt sich
-// erst beim Werkzeugaufruf mit klarem Code. Ein Client ohne Scanner bekommt
-// hier gar nichts und braucht auch nichts: fuer ihn traegt `catalog`.
-//
-// stub-ignore first. A bridge that cannot read it writes no stub at all,
-// rather than every stub the file is there to keep out.
-readStubIgnore()
-    .then((ignore) => {
-    for (const dir of stubDirs())
-        writeStubs(api, dir, { ignore }).catch(() => { });
-})
-    .catch(() => { });
-await server.connect(new StdioServerTransport());
-//# sourceMappingURL=mcp.js.map
+import{Server as xn}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport as Sn}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as wn,ListToolsRequestSchema as kn}from"@modelcontextprotocol/sdk/types.js";import{hostname as _t}from"node:os";import{execFile as xt}from"node:child_process";import{hostname as St}from"node:os";import{readFile as wt}from"node:fs/promises";import{promisify as kt}from"node:util";import{randomUUID as pe}from"node:crypto";import{link as dt,mkdir as pt,readFile as mt,rename as ut,rm as ht,writeFile as me}from"node:fs/promises";import{basename as gt,dirname as he,join as ft}from"node:path";import{existsSync as ct}from"node:fs";import{homedir as se}from"node:os";import{join as C}from"node:path";function E(){return process.env.ONLYMCP_HOME??C(se(),".claude","onlymcp")}function ie(){return process.env.ONLYMCP_HOME??se()}function ae(){return C(E(),"device-id")}function le(){return C(E(),"cache")}function ce(){return C(E(),"stub-ignore")}function de(){let t=[];process.env.CLAUDE_PLUGIN_ROOT&&t.push(process.env.CLAUDE_PLUGIN_ROOT);for(let e of(process.env.ONLYMCP_STUB_DIRS??"").split(":"))e&&t.push(e);for(let e of[C(ie(),".claude"),C(ie(),".codex")])ct(e)&&!t.includes(e)&&t.push(e);return t.length>0?t:[C(E(),"plugin")]}var yt=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/,ue;function ge(){return ue??=bt(),ue}async function B(t){try{let e=(await mt(t,"utf8")).trim().toLowerCase();return yt.test(e)?e:null}catch{return null}}async function bt(){let t=ae(),e=await B(t);if(e)return e;try{return await pt(he(t),{recursive:!0}),await Ct(t)}catch{return null}}var vt=new Set(["EPERM","ENOTSUP","EOPNOTSUPP","ENOSYS","EXDEV"]);async function Ct(t){let e=pe(),n=ft(he(t),`.${gt(t)}.${process.pid}.${pe()}.tmp`);try{await me(n,`${e}
+`,{flag:"wx",mode:384});try{return await dt(n,t),e}catch(r){let i=r.code;if(i!=="EEXIST"&&!vt.has(i??""))throw r;if(i!=="EEXIST")try{return await me(t,`${e}
+`,{flag:"wx",mode:384}),e}catch(d){if(d.code!=="EEXIST")throw d}}let o=await B(t);return o||(await ut(n,t),await B(t)??e)}finally{await ht(n,{force:!0}).catch(()=>{})}}var M="0.20.0";var At=kt(xt),Tt=`onlymcp-cli/${M} (${process.platform} ${process.arch}; node ${process.versions.node})`,fe=200;async function ye(t,e){let n;try{return await Promise.race([t,new Promise(o=>{n=setTimeout(()=>o(null),e),n.unref?.()})])}catch{return null}finally{n&&clearTimeout(n)}}async function $t(){try{if(process.platform==="linux"){let t=wt("/sys/class/dmi/id/product_version","utf8"),n=(await ye(t,fe))?.trim();return!n||/^(to be filled|default string|system version|none|n\/a)/i.test(n)?null:n}if(process.platform==="darwin"){let t=At("sysctl",["-n","hw.model"]);return(await ye(t,fe))?.stdout.trim()||null}}catch{}return null}async function It(){let t="unknown";try{t=St()||"unknown"}catch{}let e=await $t();return(e&&e!==t?`${t} (${e})`:t).slice(0,60)}var be=null;async function V(){be??=await It();let t=await ge();return{"user-agent":Tt,"x-onlymcp-device":be,...t?{"x-onlymcp-device-id":t}:{}}}var a=class extends Error{constructor(n,o={},r=0){super(n);this.code=n;this.params=o;this.status=r;this.name="ApiError"}code;params;status},P=class{constructor(e,n){this.baseUrl=e;this.token=n}baseUrl;token;async call(e,n={}){let o=this.token();if(!o)throw new a("errors.NOT_LOGGED_IN");let r=await fetch(`${this.baseUrl}${e}`,{...n,headers:{...await V(),...n.headers??{},authorization:`Bearer ${o}`,"content-type":"application/json"}});if(r.status===204)return;let i=await r.json().catch(()=>({}));if(!r.ok)throw new a(i.code??"errors.UNKNOWN",i.params??{},r.status);return i}getMe(){return this.call("/api/me")}reportRun(e,n){return this.call("/api/devices/current/run",{method:"POST",body:JSON.stringify({kind:e,files:n}),signal:AbortSignal.timeout(5e3)})}signOut(){return this.call("/api/auth/sign-out",{method:"POST",body:"{}",signal:AbortSignal.timeout(5e3)})}listSkills(){return this.call("/api/skills")}getSkill(e){return this.call(`/api/skills/${encodeURIComponent(e)}`)}putSkill(e,n,o={}){return this.call(`/api/skills/${encodeURIComponent(e)}`,{method:"PUT",body:JSON.stringify({body:n,...o})})}skillFileUrl(e,n){let o=n.split("/").map(encodeURIComponent).join("/");return`/api/skills/${encodeURIComponent(e)}/files/${o}`}getSkillFile(e,n){return this.call(this.skillFileUrl(e,n))}putSkillFile(e,n,o,r="utf8"){return this.call(this.skillFileUrl(e,n),{method:"PUT",body:JSON.stringify({content:o,encoding:r})})}listAgents(){return this.call("/api/agents")}putAgent(e,n){return this.call(`/api/agents/${encodeURIComponent(e)}`,{method:"PUT",body:JSON.stringify(n)})}getAgent(e,{use:n=!1}={}){return this.call(`/api/agents/${encodeURIComponent(e)}${n?"?use=1":""}`)}readMemory(e){return this.call(this.memoryUrl(e))}writeMemory(e,n,o){return this.call(this.memoryUrl(e),{method:"PUT",body:JSON.stringify({content:n,deviceLabel:o})})}memoryUrl(e){return`/api/memory/${e.split("/").map(encodeURIComponent).join("/")}`}listMemory(){return this.call("/api/memory")}searchContent(e,n={}){let o=new URLSearchParams({q:e});return n.types?.length&&o.set("types",n.types.join(",")),n.limit&&o.set("limit",String(n.limit)),this.call(`/api/search?${o.toString()}`)}memoryTree(e="all"){return this.call(`/api/memory/tree?scope=${encodeURIComponent(e)}`)}moveMemory(e,n,o=!0,r=_t()){return this.call("/api/memory/move",{method:"POST",body:JSON.stringify({from:e,to:n,updateLinks:o,deviceLabel:r})})}async exportArchive(e={}){let n=this.token();if(!n)throw new a("errors.NOT_LOGGED_IN");let o=new URLSearchParams;e.scope&&o.set("scope",e.scope),e.types?.length&&o.set("types",e.types.join(","));let r=o.size>0?`?${o.toString()}`:"",i=await fetch(`${this.baseUrl}/api/export${r}`,{headers:{...await V(),authorization:`Bearer ${n}`}});if(!i.ok){let d=await i.json().catch(()=>({}));throw new a(d.code??"errors.UNKNOWN",d.params??{},i.status)}return i}deleteMemory(e){return this.call(this.memoryUrl(e),{method:"DELETE"})}deleteSkill(e){return this.call(`/api/skills/${encodeURIComponent(e)}`,{method:"DELETE"})}deleteSkillFile(e,n){return this.call(this.skillFileUrl(e,n),{method:"DELETE"})}deleteAgent(e){return this.call(`/api/agents/${encodeURIComponent(e)}`,{method:"DELETE"})}listConnections(){return this.call("/api/mcp-connections")}createConnection(e){return this.call("/api/mcp-connections",{method:"POST",body:JSON.stringify(e)})}updateConnection(e,n){return this.call(`/api/mcp-connections/${e}`,{method:"PATCH",body:JSON.stringify(n)})}deleteConnection(e){return this.call(`/api/mcp-connections/${e}`,{method:"DELETE"})}listCapabilities(e){return this.call(`/api/mcp-connections/${e}/capabilities`)}toggleCapability(e,n,o){return this.call(`/api/mcp-connections/${e}/capabilities/${n}`,{method:"PATCH",body:JSON.stringify({enabled:o})})}};var Ot="https://only-mcp.com";function ve(t=process.env.ONLYMCP_API_URL){if(t===void 0)return Ot;let e;try{e=new URL(t).protocol}catch{}if(e!=="http:"&&e!=="https:"){let n=t.replace(/\/\/[^/@]*@/,"//***@");throw new Error(`ONLYMCP_API_URL is not a valid http(s) URL: ${JSON.stringify(n)}`)}return t}import{Entry as Nt}from"@napi-rs/keyring";function Lt(t,e){let n=()=>new Nt(t,e);return{save(o){n().setPassword(o)},read(){try{return n().getPassword()}catch{return null}},clear(){try{n().deletePassword()}catch{}}}}var Ce=Lt("onlymcp","session-token");import U from"cacache";var Et=Number(process.env.ONLYMCP_TTL_SECONDS??360*60),R=class{constructor(e=le()){this.dir=e}dir;async get(e){try{let n=await U.get(this.dir,e),o=n.metadata;return!o||o.expiresAt<=Date.now()?(await U.rm.entry(this.dir,e),null):n.data.toString("utf8")}catch{return null}}async set(e,n,o=Et){await U.put(this.dir,e,n,{metadata:{expiresAt:Date.now()+o*1e3}})}async clear(){await U.rm.all(this.dir)}};var xe=["OnlyMCP holds this user's skills, agents and memory in the cloud, identical","on every machine. The names below are names only, not content: call","get_skill(name) to load a skill before following it, and","get_agent_definition(name) for an agent. Call list_skills or list_agents for","anything not named here. Memory is live: memory_read(path) and","memory_write(path, content). All of it is writable, not just readable:","skill_write, agent_write and the matching *_delete tools; connection_create","adds another MCP server to this account.","Link with [[name]] or typed: [[skill:name]], [[agent:name]], [[mcp:slug]], [[memory:path]]."].join(" "),Mt=["Memory is a vault, not a scratch file: read MEMORY.md first, it is the index.","After finishing a task, write one solutions/sol-*.md for what was not obvious","and one entry in history/YYYY-MM-DD.md. Link related files with [[name]];","memory_links(path) says which of a file's links point nowhere yet."].join(" ");function Se(t,e,n,o){if(n.length===0)return"";let r=[];for(let u of n){let g=n.length-r.length-1,f=g>0?` (+${g} more, call ${e})`:"",A=`
+
+${t}: ${[...r,u].join(", ")}${f}`;if(o+A.length>1800)break;r.push(u)}if(r.length===0)return`
+
+${t}: call ${e}`;let i=n.length-r.length,d=i>0?` (+${i} more, call ${e})`:"";return`
+
+${t}: ${r.join(", ")}${d}`}function K(t,e,n={}){let o=n.brainvault===!1?xe:`${xe} ${Mt}`,r=e.length>0?26:0;return o+=Se("Skills","list_skills",t,o.length+r),o+=Se("Agents","list_agents",e,o.length),o}function J(t,e){let n=new URL(t);if(n.protocol!=="http:"&&n.protocol!=="https:")throw new TypeError(`serverInfo: "${t}" is not an http(s) origin`);let o=n.origin;return{name:"onlymcp",title:"OnlyMCP",version:e,websiteUrl:o,icons:[{src:`${o}/brand/connector-512.png`,mimeType:"image/png"},{src:`${o}/brand/favicon.svg`,mimeType:"image/svg+xml"}]}}import{access as zt,mkdir as X,readFile as jt,rm as Ae,writeFile as D}from"node:fs/promises";import{dirname as Gt,join as _}from"node:path";function we(t){if(!t.startsWith(`---
+`))return null;let e=t.indexOf(`
+---`,3);return e<0?null:t.slice(4,e)}function q(t,e){if(!/^[a-zA-Z0-9_-]+$/.test(e))return;let n=new RegExp(`^${e}:[ \\t]*(.*)$`,"m").exec(t);if(!n)return;let r=n[1].trim().replace(/^(['"])(.*)\1$/,"$2").trim();return r.length>0?r:void 0}import{readFile as Pt}from"node:fs/promises";var Y=()=>!1;function Ut(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function Rt(t){let e=t.split(/\r?\n/).map(n=>n.trim()).filter(n=>n!==""&&!n.startsWith("#")).map(n=>new RegExp(`^${n.split("*").map(Ut).join(".*")}$`));return n=>e.some(o=>o.test(n))}async function ke(t=ce()){try{return Rt(await Pt(t,"utf8"))}catch(e){if(e.code==="ENOENT")return Y;throw e}}var Dt=/^[A-Za-z0-9][A-Za-z0-9._-]*$/;function I(t){if(t.length===0||t.length>200||t==="SKILL.md")return!1;let e=t.split("/");return e.length>8?!1:e.every(n=>Dt.test(n)&&n!==".."&&n!==".")}var Ft=/^[a-z0-9]+(-[a-z0-9]+)*$/,Ht=/^[a-z0-9]+(-[a-z0-9]+)*(:[a-z0-9]+(-[a-z0-9]+)*)?$/,Z="x-onlymcp-stub";function z(t){return t.replace(/:/g,"-")}function j(t){return(t??"").replace(/[\r\n]+/g," ").trim()}async function Q(t,e){let n;try{n=await jt(t,"utf8")}catch{return!0}let o=we(n);if(o===null||q(o,Z)!=="true")return!1;let r=q(o,"x-onlymcp-name");return r===void 0||r===e}async function Te(t,e){return await zt(t).then(()=>!0,()=>!1)&&await Q(t,e)}async function $e(t,e,n={}){let o=n.ignore??Y,[{skills:r},{agents:i}]=await Promise.all([t.listSkills(),t.listAgents()]),d=0,u=0,g=[],f=[],A=0;for(let s of r){if(!Ht.test(s.name))continue;let b=_(e,"skills",z(s.name)),T=_(b,"SKILL.md");if(o(s.name)||o(z(s.name))){f.push(s.name),await Te(T,s.name)&&(await Ae(b,{recursive:!0,force:!0}),A+=1);continue}if(!await Q(T,s.name)){g.push(`skills/${z(s.name)}`);continue}await X(b,{recursive:!0}),await D(T,`---
+name: ${z(s.name)}
+description: ${j(s.description)||"Synchronisiert ueber OnlyMCP. Inhalt wird bei Bedarf geladen."}
+${Z}: true
+x-onlymcp-name: ${s.name}
+---
+
+Call \`get_skill({ name: "${s.name}" })\` on the OnlyMCP server and follow whatever comes back.
+`,"utf8"),u+=1;try{let L=await t.getSkill(s.name);for(let $ of L.files??[]){if(!I($.path))continue;let H=await t.getSkillFile(s.name,$.path),W=_(b,...$.path.split("/"));await X(Gt(W),{recursive:!0}),H.encoding==="base64"?await D(W,Buffer.from(H.content,"base64")):await D(W,H.content,"utf8"),d+=1}}catch{}}await X(_(e,"agents"),{recursive:!0});let re=0;for(let s of i){if(!Ft.test(s.name))continue;let b=_(e,"agents",`${s.name}.md`);if(o(s.name)){f.push(s.name),await Te(b,s.name)&&(await Ae(b),A+=1);continue}if(!await Q(b,s.name)){g.push(`agents/${s.name}.md`);continue}let T=j(s.description),L=s.model?j(s.model):"",$=s.tools.map(j).join(", ");await D(b,`---
+name: ${s.name}
+description: ${T}
+${L?`model: ${L}
+`:""}tools: ${$}
+${Z}: true
+x-onlymcp-name: ${s.name}
+---
+
+Call \`get_agent_definition({ name: "${s.name}" })\` on the OnlyMCP server and follow whatever comes back.
+`,"utf8"),re+=1}return{skills:u,agents:re,files:d,kept:g,ignored:f,removed:A}}import{z as Cn}from"zod";var p=t=>({title:t,annotations:{readOnlyHint:!0,openWorldHint:!1}}),m=(t,e)=>({title:t,annotations:{readOnlyHint:!1,destructiveHint:e.destructive,idempotentHint:e.idempotent,openWorldHint:e.openWorld??!1}}),ee={list_memory:p("List memory files"),memory_read:p("Read a memory file"),memory_write:m("Write a memory file",{destructive:!0,idempotent:!0}),memory_delete:m("Delete a memory file",{destructive:!0,idempotent:!1}),memory_search:p("Search memory"),memory_tree:p("Show the memory tree"),memory_move:m("Move a memory file or folder",{destructive:!1,idempotent:!1}),memory_links:p("Show memory links"),list_skills:p("List skills"),get_skill:p("Load a skill"),skill_write:m("Write a skill",{destructive:!0,idempotent:!0}),skill_delete:m("Delete a skill",{destructive:!0,idempotent:!1}),list_skill_files:p("List skill files"),get_skill_file:p("Read a skill file"),skill_file_write:m("Write a skill file",{destructive:!0,idempotent:!0}),skill_file_delete:m("Delete a skill file",{destructive:!0,idempotent:!1}),list_agents:p("List agents"),get_agent_definition:p("Load an agent definition"),agent_write:m("Write an agent",{destructive:!0,idempotent:!0}),agent_delete:m("Delete an agent",{destructive:!0,idempotent:!1}),list_connections:p("List connections"),connection_create:m("Add a connection",{destructive:!1,idempotent:!1,openWorld:!0}),connection_update:m("Update a connection",{destructive:!1,idempotent:!0}),connection_delete:m("Delete a connection",{destructive:!0,idempotent:!1}),connection_tools:p("List a connection's tools"),connection_tool_toggle:m("Switch a connection tool on or off",{destructive:!1,idempotent:!0}),connection_tool_schema:p("Show a connection tool's schema"),connection_call:m("Call a connection tool",{destructive:!0,idempotent:!1,openWorld:!0})};import{z as Ie}from"zod";var Wt=Ie.object({name:Ie.string().min(1).max(64)});function _e(t,e){return{name:"get_agent_definition",description:"Delivers an agent's system prompt from the OnlyMCP cloud.",inputSchema:Wt,async handler(n){let o=`agent:${n.name}`,r=await e.get(o);if(r!==null)return{content:[{type:"text",text:r}]};try{let i=await t.getAgent(n.name,{use:!0});return await e.set(o,i.body),{content:[{type:"text",text:i.body}]}}catch(i){return{content:[{type:"text",text:i instanceof a?i.code:"errors.UNKNOWN"}],isError:!0}}}}}import{z as te}from"zod";var Bt=te.object({name:te.string().min(1).max(64),path:te.string().min(1).max(200)});function Oe(t){return{name:"get_skill_file",description:"Delivers a single companion file of a skill from the OnlyMCP cloud, e.g. references/palette.md. Usually not needed: `npx onlymcp sync` places these files next to the SKILL.md.",inputSchema:Bt,async handler(e){try{let n=await t.getSkillFile(e.name,e.path);return n.encoding==="base64"?{content:[{type:"text",text:`errors.BINARY_FILE ${n.path} (${n.size} bytes) - fetch it to disk with \`npx onlymcp sync\`.`}],isError:!0}:{content:[{type:"text",text:n.content}]}}catch(n){return{content:[{type:"text",text:n instanceof a?n.code:"errors.UNKNOWN"}],isError:!0}}}}}import{z as Ne}from"zod";var Vt=Ne.object({name:Ne.string().min(1).max(64)});function Le(t,e){return{name:"get_skill",description:"Delivers a skill's full content from the OnlyMCP cloud. Called from the stub files.",inputSchema:Vt,async handler(n){let o=`skill:${n.name}`,r=await e.get(o);if(r!==null)return{content:[{type:"text",text:r}]};try{let i=await t.getSkill(n.name);return await e.set(o,i.body),{content:[{type:"text",text:i.body}]}}catch(i){return{content:[{type:"text",text:i instanceof a?i.code:"errors.UNKNOWN"}],isError:!0}}}}}import{z as Kt}from"zod";var Ee=Kt.object({});function Me(t){return{name:"list_skills",description:"List every skill name available to this user. Use when a skill you need is not named in the server instructions.",inputSchema:Ee,async handler(){try{let{skills:e}=await t.listSkills();return{content:[{type:"text",text:e.map(n=>n.name).join(`
+`)}]}}catch(e){return{content:[{type:"text",text:e instanceof a?e.code:"errors.UNKNOWN"}],isError:!0}}}}}function Pe(t){return{name:"list_agents",description:"List every agent available to this user, with its description. Use when this client has no agent files of its own.",inputSchema:Ee,async handler(){try{let{agents:e}=await t.listAgents();return{content:[{type:"text",text:e.map(o=>`${o.name}: ${o.description}`).join(`
+`)}]}}catch(e){return{content:[{type:"text",text:e instanceof a?e.code:"errors.UNKNOWN"}],isError:!0}}}}}import{z as Ue}from"zod";var Jt=/^[a-z0-9][a-z0-9._-]*(\/[a-z0-9][a-z0-9._-]*)*\.md$/i;function y(t){return Jt.test(t)&&!t.split("/").includes("..")}var qt=Ue.object({path:Ue.string().min(3).max(256)});function Re(t){let e=new Map;return{name:"memory_read",description:"Reads a memory file live from the OnlyMCP cloud. No disk cache.",inputSchema:qt,async handler(n){if(!y(n.path))return{content:[{type:"text",text:"errors.INVALID_PATH"}],isError:!0};try{let o=e.get(n.path);return o||(o=t.readMemory(n.path).then(r=>r.content),e.set(n.path,o),o.finally(()=>e.delete(n.path))),{content:[{type:"text",text:await o}]}}catch(o){return{content:[{type:"text",text:o instanceof a?o.code:"errors.UNKNOWN"}],isError:!0}}}}}import{hostname as Yt}from"node:os";import{z as ne}from"zod";var Xt=ne.object({path:ne.string().min(3).max(256),content:ne.string().max(1e6)});function De(t){return{name:"memory_write",description:"Writes a memory file live into the OnlyMCP cloud (write-through).",inputSchema:Xt,async handler(e){if(!y(e.path))return{content:[{type:"text",text:"errors.INVALID_PATH"}],isError:!0};try{let n=await t.writeMemory(e.path,e.content,Yt()),o=n.warning?`${n.path} ${n.updatedAt} ${n.warning.code} ${JSON.stringify(n.warning.params)}`:`${n.path} ${n.updatedAt}`;return n.routedTo&&(o+=` (created in team ${n.routedTo.teamName})`),{content:[{type:"text",text:o}]}}catch(n){return{content:[{type:"text",text:n instanceof a?n.code:"errors.UNKNOWN"}],isError:!0}}}}}import{z as h}from"zod";var x=t=>({content:[{type:"text",text:t}]}),w=t=>({content:[{type:"text",text:t}],isError:!0});function G(t){return t instanceof a?t.code:"errors.UNKNOWN"}var Zt=h.object({query:h.string().min(1).max(200),types:h.string().max(64).optional(),limit:h.number().int().min(1).max(50).optional()});function je(t){return{name:"memory_search",description:"Full-text search across memory, skills and agents. Delivers the best hits with a short snippet each.",inputSchema:Zt,async handler(e){try{let{hits:n}=await t.searchContent(e.query,{types:e.types?.split(",").map(o=>o.trim()).filter(o=>o!==""),limit:e.limit});return n.length===0?x(`Nothing found for ${e.query}`):x(n.map(o=>`${o.kind}  ${o.path??o.name}${o.scope==="team"?" (team)":""}
+    ${o.snippet}`).join(`
+`))}catch(n){return w(G(n))}}}}var Qt=h.object({scope:h.string().max(96).optional()});function Ge(t){return{name:"memory_tree",description:"This account's folder structure: every folder, empty ones included, and the files in it.",inputSchema:Qt,async handler(e){try{let{nodes:n}=await t.memoryTree(e.scope??"all");return n.length===0?x("(empty)"):x(n.map(o=>{let r=o.path.split("/").length-1,i=o.kind==="folder"?`${o.name}/`:o.name;return`${"  ".repeat(r)}${i}${o.scope==="team"?" (team)":""}`}).join(`
+`))}catch(n){return w(G(n))}}}}var en=h.object({from:h.string().min(3).max(256),to:h.string().min(3).max(256),updateLinks:h.boolean().optional()});function ze(t){return`${t} ${t===1?"file":"files"}`}function Fe(t){return{name:"memory_move",description:"Moves or renames a memory file. Every [[link]] that would no longer find it follows along, by name or by path, unless turned off.",inputSchema:en,async handler(e){if(!y(e.from)||!y(e.to))return w("errors.INVALID_PATH");let n=e.updateLinks??!0;try{let o=await t.moveMemory(e.from,e.to,n);return x(`${o.from} moved to ${o.to}`+(n?`, links updated in ${ze(o.rewritten)}, ${ze(o.skipped)} left unchanged`:""))}catch(o){return w(G(o))}}}}var tn=h.object({path:h.string().min(3).max(256)});function He(t){return{name:"memory_links",description:"A memory file's [[links]], split between the ones that point somewhere and the ones that point nowhere.",inputSchema:tn,async handler(e){if(!y(e.path))return w("errors.INVALID_PATH");try{let n=await t.readMemory(e.path),{resolved:o,unresolved:r}=n.links;return o.length===0&&r.length===0?x(`${e.path} does not link to anything.`):x([o.length>0?`Resolved: ${o.join(", ")}`:"",r.length>0?`Open (no file with this name yet): ${r.join(", ")}`:""].filter(i=>i!=="").join(`
+`))}catch(n){return w(G(n))}}}}import{z as l}from"zod";var nn=t=>({content:[{type:"text",text:t}]}),We=t=>({content:[{type:"text",text:t}],isError:!0});async function k(t){try{return nn(await t())}catch(e){if(e instanceof a){let n=Object.keys(e.params).length?` ${JSON.stringify(e.params)}`:"";return We(`${e.code}${n}`)}return We("errors.UNKNOWN")}}var O=l.string().min(1).max(32).regex(/^[a-z0-9]+(-[a-z0-9]+)*$/,"errors.INVALID_SLUG");async function F(t,e){let{connections:n}=await t.listConnections(),o=n.filter(r=>r.slug===e);return o.find(r=>r.scope==="personal")??o[0]??null}function oe(t){let e=t.authType==="none"?"no auth":`${t.authType}, secret ...${t.secretHint??"?"}`;return`${t.slug} \u2014 ${t.name} (${t.scope}, ${t.enabled?t.status:"disabled"}, ${e})
+  ${t.url}${t.statusError?`
+  last error: ${t.statusError}`:""}`}var on=l.object({});function Be(t){return{name:"list_connections",description:"List the MCP servers connected through this OnlyMCP account, with the tool-name prefix each one uses.",inputSchema:on,handler:()=>k(async()=>{let{connections:e}=await t.listConnections();return e.length===0?"No MCP servers are connected yet. Add one with connection_create.":e.map(oe).join(`
+`)})}}var rn=l.object({name:l.string().min(1).max(80),slug:O,url:l.string().url().max(2e3),transport:l.enum(["http","sse"]).default("http"),authType:l.enum(["none","bearer","header"]).default("none"),authHeaderName:l.string().max(80).optional(),secret:l.string().max(4e3).optional(),teamId:l.string().max(64).optional()});function Ve(t){return{name:"connection_create",description:"Connect a remote MCP server (http or sse only - a stdio server cannot be started on somebody else's behalf). It is probed straight away. Passing a secret here puts it into this conversation; leave it out and set it in the dashboard if that matters.",inputSchema:rn,handler:e=>k(async()=>{let{connection:n}=await t.createConnection(e);return`Connected.
+${oe(n)}
+
+Its tools are now available as "${n.slug}__<tool>".`})}}var sn=l.object({slug:O,name:l.string().min(1).max(80).optional(),url:l.string().url().max(2e3).optional(),transport:l.enum(["http","sse"]).optional(),authType:l.enum(["none","bearer","header"]).optional(),authHeaderName:l.string().max(80).optional(),secret:l.string().max(4e3).optional(),enabled:l.boolean().optional()});function Ke(t){return{name:"connection_update",description:"Change a connected MCP server. Only the fields you pass are touched; url, transport, authType and secret trigger a fresh probe.",inputSchema:sn,handler:e=>k(async()=>{let n=await F(t,e.slug);if(!n)return`Connection not found: ${e.slug}`;let{slug:o,...r}=e,{connection:i}=await t.updateConnection(n.id,r);return`Updated.
+${oe(i)}`})}}var an=l.object({slug:O});function Je(t){return{name:"connection_delete",description:"Disconnect a remote MCP server and forget its stored credential. Its tools disappear from the gateway.",inputSchema:an,handler:e=>k(async()=>{let n=await F(t,e.slug);return n?(await t.deleteConnection(n.id),`Disconnected ${e.slug}.`):`Connection not found: ${e.slug}`})}}var ln=l.object({slug:O});function qe(t){return{name:"connection_tools",description:"List what one connected server offers, and whether each tool is switched on for the gateway.",inputSchema:ln,handler:e=>k(async()=>{let n=await F(t,e.slug);if(!n)return`Connection not found: ${e.slug}`;let{capabilities:o}=await t.listCapabilities(n.id);return o.length===0?`${e.slug} has nothing on record yet. Its status is "${n.status}".`:o.map(r=>`${r.enabled?"[on] ":"[off]"} ${r.kind} ${r.name}${r.exposedAs?` -> ${r.exposedAs}`:""}${r.description?` \u2014 ${r.description}`:""}`).join(`
+`)})}}var cn=l.object({slug:O,tool:l.string().min(1).max(200),enabled:l.boolean()});function Ye(t){return{name:"connection_tool_toggle",description:"Switch one tool of a connected server on or off. A tool that is off costs no room in any client's tool list.",inputSchema:cn,handler:e=>k(async()=>{let n=await F(t,e.slug);if(!n)return`Connection not found: ${e.slug}`;let{capabilities:o}=await t.listCapabilities(n.id),r=o.find(i=>i.kind==="tool"&&i.name===e.tool);return r?(await t.toggleCapability(n.id,r.id,e.enabled),`${e.slug}__${r.name} is now ${e.enabled?"on":"off"}.`):`${e.slug} offers no tool called ${e.tool}.`})}}import{z as c}from"zod";var dn=t=>({content:[{type:"text",text:t}]}),N=t=>({content:[{type:"text",text:t}],isError:!0});async function v(t){try{return dn(await t())}catch(e){if(e instanceof a){let n=Object.keys(e.params).length?` ${JSON.stringify(e.params)}`:"";return N(`${e.code}${n}`)}return N("errors.UNKNOWN")}}var S=c.string().min(1).max(64).regex(/^[a-z0-9]+(-[a-z0-9]+)*$/,"errors.INVALID_NAME"),pn=c.object({name:S,body:c.string().max(2e5)});function Xe(t){return{name:"skill_write",description:"Create a skill or replace the body of an existing one. The body is the whole SKILL.md, frontmatter included.",inputSchema:pn,handler:e=>v(async()=>{let n=await t.putSkill(e.name,e.body);return`${n.name} ${n.updatedAt}`})}}var mn=c.object({name:S});function Ze(t){return{name:"skill_delete",description:"Delete one skill and every file that belongs to it. Moves it to the trash; it can be restored in the dashboard for the trash period (default 7 days).",inputSchema:mn,handler:e=>v(async()=>(await t.deleteSkill(e.name),`Deleted skill ${e.name}`))}}var un=c.object({skill:S});function Qe(t){return{name:"list_skill_files",description:"List the companion files of one skill, with their size in bytes.",inputSchema:un,handler:e=>v(async()=>{let{files:n}=await t.getSkill(e.skill);return n.length===0?`${e.skill} has no companion files.`:n.map(o=>`${o.path} (${o.size} bytes, ${o.encoding})`).join(`
+`)})}}var hn=c.object({skill:S,path:c.string().min(1).max(256),content:c.string().max(3e6),encoding:c.enum(["utf8","base64"]).default("utf8")});function et(t){return{name:"skill_file_write",description:"Create or replace one companion file of a skill. Use encoding base64 for anything that is not text.",inputSchema:hn,handler:e=>I(e.path)?v(async()=>{let n=await t.putSkillFile(e.skill,e.path,e.content,e.encoding);return`${e.skill}/${n.path} ${n.size} bytes`}):Promise.resolve(N("errors.INVALID_PATH"))}}var gn=c.object({skill:S,path:c.string().min(1).max(256)});function tt(t){return{name:"skill_file_delete",description:"Delete one companion file of a skill. The skill itself stays.",inputSchema:gn,handler:e=>I(e.path)?v(async()=>(await t.deleteSkillFile(e.skill,e.path),`Deleted ${e.skill}/${e.path}`)):Promise.resolve(N("errors.INVALID_PATH"))}}var fn=c.object({name:S,description:c.string().min(1).max(1e3),body:c.string().max(2e5),model:c.string().max(64).optional(),tools:c.array(c.string().max(128)).max(200).optional()});function nt(t){return{name:"agent_write",description:"Create an agent or replace an existing one. Leave model out to keep the one it already has.",inputSchema:fn,handler:e=>v(async()=>{let n=await t.getAgent(e.name).catch(()=>null),o=await t.putAgent(e.name,{description:e.description,body:e.body,model:e.model??n?.model??void 0,tools:e.tools??n?.tools??[]});return`${o.name} ${o.updatedAt}`})}}var yn=c.object({name:S});function ot(t){return{name:"agent_delete",description:"Delete one agent. Moves it to the trash; it can be restored in the dashboard for the trash period (default 7 days).",inputSchema:yn,handler:e=>v(async()=>(await t.deleteAgent(e.name),`Deleted agent ${e.name}`))}}var bn=c.object({});function rt(t){return{name:"list_memory",description:"List the paths of every memory file in this account, private and team, sorted by path.",inputSchema:bn,handler:()=>v(async()=>{let{files:e}=await t.listMemory();return e.length===0?"(none)":e.map(n=>n.path+(n.scope==="team"?` (team${n.teamName?`: ${n.teamName}`:""})`:"")).sort().join(`
+`)})}}var vn=c.object({path:c.string().min(3).max(256)});function it(t){return{name:"memory_delete",description:"Delete one memory file. Moves it to the trash; it can be restored in the dashboard for the trash period (default 7 days).",inputSchema:vn,handler:e=>y(e.path)?v(async()=>(await t.deleteMemory(e.path),`Deleted ${e.path}`)):Promise.resolve(N("errors.INVALID_PATH"))}}function st(t,e){return[Re(t),De(t),rt(t),it(t),je(t),Ge(t),Fe(t),He(t),Me(t),Le(t,e),Xe(t),Ze(t),Qe(t),Oe(t),et(t),tt(t),Pe(t),_e(t,e),nt(t),ot(t),Be(t),Ve(t),Ke(t),Je(t),qe(t),Ye(t)]}function at(t){return t.map(e=>{let n=ee[e.name];if(!n)throw new Error(`No title and annotations in the registry table for the tool ${e.name}`);return{name:e.name,title:n.title,description:e.description,inputSchema:Cn.toJSONSchema(e.inputSchema),annotations:n.annotations}})}async function lt(){let t=ve(),e=new P(t,()=>Ce.read()),n=new R,o=st(e,n),r=await(async()=>{try{let[{skills:d},{agents:u},g]=await Promise.all([e.listSkills(),e.listAgents(),e.getMe().catch(()=>({brainvaultMode:!0}))]);return K(d.map(f=>f.name),u.map(f=>f.name),{brainvault:g.brainvaultMode!==!1})}catch{return K([],[])}})(),i=new xn(J(t,M),{capabilities:{tools:{}},instructions:r});i.setRequestHandler(kn,async()=>({tools:at(o)})),i.setRequestHandler(wn,async d=>{let u=o.find(f=>f.name===d.params.name);if(!u)return{content:[{type:"text",text:"errors.UNKNOWN_TOOL"}],isError:!0};let g=u.inputSchema.safeParse(d.params.arguments??{});return g.success?u.handler(g.data):{content:[{type:"text",text:"errors.INVALID_ARGUMENTS"}],isError:!0}}),ke().then(d=>{for(let u of de())$e(e,u,{ignore:d}).catch(()=>{})}).catch(()=>{}),await i.connect(new Sn)}await lt();

package/package.json

@@ -1,16 +1,11 @@
 {
   "name": "onlymcp",
-  "version": "0.17.0",
+  "version": "0.20.0",
   "description": "Skills, agents and memory from the OnlyMCP cloud in every MCP client. Ships the stdio MCP server and the CLI that sets up Claude Code, Codex and Antigravity.",
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE",
   "author": "Francesco Palazzo",
   "homepage": "https://only-mcp.com",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Francesco070/onlymcp.git",
-    "directory": "packages/mcp"
-  },
-  "bugs": "https://github.com/Francesco070/onlymcp/issues",
+  "mcpName": "com.only-mcp/onlymcp",
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -30,10 +25,11 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "node build.mjs",
     "typecheck": "tsc --noEmit",
     "test": "node ../../scripts/sync-registry.mjs --check && vitest run",
     "prepublishOnly": "pnpm build"
@@ -53,6 +49,7 @@
     "@types/cacache": "^17.0.2",
     "@types/node": "^22.15.0",
     "@types/qrcode": "^1.5.5",
+    "esbuild": "^0.28.2",
     "typescript": "^5.9.0",
     "vitest": "^4.1.10"
   }

package/dist/apiBaseUrl.d.ts

@@ -1,12 +0,0 @@
-/**
- * The address of the OnlyMCP API that the stdio server talks to: ONLYMCP_API_URL, or https://only-mcp.com when the
- * variable is not set. A variable that is set but empty is not "not set": it is a misconfiguration (an unexpanded
- * `${VAR}` in an MCP client's config file lands here as the literal text).
- *
- * Fails fast and does not fall back: the stdio server has no degraded mode, every tool calls the API, and a guessed
- * origin would hide the mistake. The message names the variable and shows the value, because the MCP client reports
- * nothing but a closed connection; credentials in the value (`user:pass@`) are masked, as stderr ends up in client logs.
- * Only http: and https: are accepted.
- */
-export declare const DEFAULT_API_URL = "https://only-mcp.com";
-export declare function apiBaseUrl(raw?: string | undefined): string;

package/dist/apiBaseUrl.js

@@ -1,28 +0,0 @@
-/**
- * The address of the OnlyMCP API that the stdio server talks to: ONLYMCP_API_URL, or https://only-mcp.com when the
- * variable is not set. A variable that is set but empty is not "not set": it is a misconfiguration (an unexpanded
- * `${VAR}` in an MCP client's config file lands here as the literal text).
- *
- * Fails fast and does not fall back: the stdio server has no degraded mode, every tool calls the API, and a guessed
- * origin would hide the mistake. The message names the variable and shows the value, because the MCP client reports
- * nothing but a closed connection; credentials in the value (`user:pass@`) are masked, as stderr ends up in client logs.
- * Only http: and https: are accepted.
- */
-export const DEFAULT_API_URL = 'https://only-mcp.com';
-export function apiBaseUrl(raw = process.env.ONLYMCP_API_URL) {
-    if (raw === undefined)
-        return DEFAULT_API_URL;
-    let protocol;
-    try {
-        protocol = new URL(raw).protocol;
-    }
-    catch {
-        // Not parseable at all: reported below like a wrong scheme.
-    }
-    if (protocol !== 'http:' && protocol !== 'https:') {
-        const shown = raw.replace(/\/\/[^/@]*@/, '//***@');
-        throw new Error(`ONLYMCP_API_URL is not a valid http(s) URL: ${JSON.stringify(shown)}`);
-    }
-    return raw;
-}
-//# sourceMappingURL=apiBaseUrl.js.map

package/dist/apiBaseUrl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiBaseUrl.js","sourceRoot":"","sources":["../src/apiBaseUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAEtD,MAAM,UAAU,UAAU,CAAC,MAA0B,OAAO,CAAC,GAAG,CAAC,eAAe;IAC9E,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC;IAC9C,IAAI,QAA4B,CAAC;IACjC,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;IAC9D,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/apiClient.d.ts

@@ -1,296 +0,0 @@
-export declare class ApiError extends Error {
-    readonly code: string;
-    readonly params: Record<string, unknown>;
-    readonly status: number;
-    constructor(code: string, params?: Record<string, unknown>, status?: number);
-}
-/**
- * Herkunft und Bearbeitbarkeit, wie jede Liste des Servers sie mitschickt
- * (teams/scope.ts). Der Client braucht sie fuer `--prune`: geloescht wird nur,
- * was diesem Konto allein gehoert.
- */
-export type Scoped = {
-    scope: 'personal' | 'team';
-    teamName: string | null;
-    isOwn: boolean;
-    canEdit: boolean;
-    archivedAt: string | null;
-};
-/** Die Sammlung, aus der ein Skill stammt (Paket 03 Aufgabe 11). */
-export type SkillCollection = {
-    key: string;
-    kind: string;
-    label: string;
-};
-export type SkillProvenance = {
-    description?: string;
-    sourcePath?: string;
-    collection?: {
-        key: string;
-        kind: string;
-        label?: string;
-    } | null;
-};
-export type SkillListItem = Scoped & {
-    name: string;
-    description: string;
-    collection: SkillCollection | null;
-    updatedAt: string;
-};
-export type AgentListItem = Scoped & {
-    name: string;
-    description: string;
-    model: string | null;
-    tools: string[];
-    updatedAt: string;
-};
-export type SkillFileMeta = {
-    path: string;
-    encoding: FileEncoding;
-    size: number;
-    updatedAt: string;
-};
-export type SkillFile = SkillFileMeta & {
-    content: string;
-};
-export type FileEncoding = 'utf8' | 'base64';
-export type MemoryFile = {
-    path: string;
-    content: string;
-    frontmatter: Record<string, unknown>;
-    links: {
-        resolved: string[];
-        unresolved: string[];
-    };
-    updatedAt: string;
-    updatedByDevice: string | null;
-    updatedByName?: string | null;
-};
-export type SearchHit = {
-    kind: 'memory' | 'skill' | 'agent';
-    id: string;
-    name: string;
-    path: string | null;
-    snippet: string;
-    scope: 'personal' | 'team';
-    teamId: string | null;
-};
-export type TreeEntry = {
-    kind: 'folder' | 'file';
-    path: string;
-    name: string;
-    type: string | null;
-    updatedAt: string | null;
-    scope: 'personal' | 'team';
-    teamName: string | null;
-    canEdit: boolean;
-};
-export type MemoryListItem = Scoped & {
-    path: string;
-    updatedAt: string;
-};
-export type Connection = {
-    id: string;
-    name: string;
-    slug: string;
-    url: string;
-    transport: string;
-    authType: string;
-    authHeaderName: string | null;
-    secretHint: string | null;
-    enabled: boolean;
-    status: string;
-    statusError: string | null;
-    scope: 'personal' | 'team';
-    can?: {
-        edit: boolean;
-        delete: boolean;
-        toggleTools: boolean;
-        manageCredentials: boolean;
-    };
-};
-export type Capability = {
-    id: string;
-    kind: 'tool' | 'resource' | 'prompt';
-    name: string;
-    description: string;
-    enabled: boolean;
-    exposedAs: string | null;
-};
-export type ConnectionInput = {
-    name: string;
-    slug: string;
-    url: string;
-    transport?: 'http' | 'sse';
-    authType?: 'none' | 'bearer' | 'header';
-    authHeaderName?: string;
-    secret?: string;
-    teamId?: string | null;
-};
-export type WriteResult = {
-    path: string;
-    updatedAt: string;
-    warning?: {
-        code: string;
-        params: Record<string, unknown>;
-    };
-    /** Set when the server created the file in a team instead of the personal space. */
-    routedTo?: {
-        teamId: string;
-        teamName: string;
-    };
-};
-export declare class ApiClient {
-    private readonly baseUrl;
-    private readonly token;
-    constructor(baseUrl: string, token: () => string | null);
-    private call;
-    getMe(): Promise<{
-        id: string;
-        email: string;
-        plan: {
-            name: string;
-        };
-        /** Optional, weil eine aeltere API sie nicht schickt. Fehlt sie, gilt an. */
-        brainvaultMode?: boolean;
-    }>;
-    /**
-     * Tells the server this device just finished an import or a sync (POST
-     * /api/devices/current/run), so the devices page can show when and how many files. The caller
-     * treats a failure as nothing: an older server answers 404, and a report is never worth a
-     * failed command. Five seconds at most, so a slow server cannot hold the command up.
-     */
-    reportRun(kind: 'import' | 'sync', files: number): Promise<void>;
-    /**
-     * Ends this device's session on the server (POST /api/auth/sign-out, Better Auth's own sign-out:
-     * the API's bearer plugin turns the token into the session cookie that endpoint reads). For
-     * `onlymcp logout`, which forgets the login on this machine whatever this answers. Five seconds
-     * at most, so an unreachable server cannot hold the logout up.
-     */
-    signOut(): Promise<{
-        success: boolean;
-    }>;
-    listSkills(): Promise<{
-        skills: SkillListItem[];
-    }>;
-    getSkill(name: string): Promise<{
-        name: string;
-        body: string;
-        description: string;
-        collection: SkillCollection | null;
-        sourcePath: string | null;
-        updatedAt: string;
-        files: SkillFileMeta[];
-    }>;
-    /**
-     * Die Herkunft ist optional und wird WEGGELASSEN, nicht auf leer gesetzt,
-     * wenn es keine gibt: ein fehlendes Feld heisst serverseitig "nicht
-     * anfassen" (Spec 5, Regel 1). Ein `description: ''` mitzuschicken loeschte
-     * die Beschreibung, die ein frueherer Import geschrieben hat.
-     */
-    putSkill(name: string, body: string, provenance?: SkillProvenance): Promise<{
-        name: string;
-        updatedAt: string;
-    }>;
-    private skillFileUrl;
-    getSkillFile(name: string, path: string): Promise<SkillFile>;
-    putSkillFile(name: string, path: string, content: string, encoding?: FileEncoding): Promise<{
-        path: string;
-        size: number;
-        updatedAt: string;
-    }>;
-    listAgents(): Promise<{
-        agents: AgentListItem[];
-    }>;
-    putAgent(name: string, a: {
-        description: string;
-        model?: string;
-        tools: string[];
-        body: string;
-    }): Promise<{
-        name: string;
-        updatedAt: string;
-    }>;
-    /**
-     * `use` says "I am loading this definition to run it", and the server counts
-     * a load for the agent's "Used" line. Only `get_agent_definition` asks. Any
-     * other read of the same route (the write tool looking at the previous state)
-     * is not a use and must not send it.
-     */
-    getAgent(name: string, { use }?: {
-        use?: boolean;
-    }): Promise<Scoped & {
-        name: string;
-        description: string;
-        model: string | null;
-        tools: string[];
-        updatedAt: string;
-    } & {
-        body: string;
-    }>;
-    readMemory(path: string): Promise<MemoryFile>;
-    writeMemory(path: string, content: string, deviceLabel?: string): Promise<WriteResult>;
-    private memoryUrl;
-    listMemory(): Promise<{
-        files: MemoryListItem[];
-    }>;
-    searchContent(q: string, opts?: {
-        types?: string[];
-        limit?: number;
-    }): Promise<{
-        hits: SearchHit[];
-    }>;
-    memoryTree(scope?: string): Promise<{
-        nodes: TreeEntry[];
-    }>;
-    /**
-     * A move is a write of the moved file and of every file whose links it rewrites, and the
-     * server records the device each write came from. This machine's host name, as the
-     * memory_write tool and the import name it, so a write and a move from here are one device.
-     */
-    moveMemory(from: string, to: string, updateLinks?: boolean, deviceLabel?: string): Promise<{
-        from: string;
-        to: string;
-        rewritten: number;
-        skipped: number;
-    }>;
-    /**
-     * Das Export-Archiv, als ROHE Antwort.
-     *
-     * Geht bewusst nicht durch `call`: das dort ist ein JSON-Client, und ein
-     * Archiv von zwei Gigabyte durch `res.json()` zu schicken waere genau der
-     * Fehler, den die Route auf ihrer Seite vermeidet. Der Aufrufer bekommt den
-     * Strom und entscheidet, ob er ihn in eine Datei giesst oder auspackt.
-     */
-    exportArchive(opts?: {
-        scope?: string;
-        types?: string[];
-    }): Promise<Response>;
-    deleteMemory(path: string): Promise<void>;
-    deleteSkill(name: string): Promise<void>;
-    deleteSkillFile(name: string, path: string): Promise<void>;
-    deleteAgent(name: string): Promise<void>;
-    listConnections(): Promise<{
-        connections: Connection[];
-    }>;
-    createConnection(input: ConnectionInput): Promise<{
-        connection: Connection;
-    }>;
-    updateConnection(id: string, patch: Partial<ConnectionInput> & {
-        enabled?: boolean;
-    }): Promise<{
-        connection: Connection;
-    }>;
-    deleteConnection(id: string): Promise<{
-        ok: boolean;
-    }>;
-    listCapabilities(id: string): Promise<{
-        capabilities: Capability[];
-    }>;
-    toggleCapability(id: string, capId: string, enabled: boolean): Promise<{
-        capability: {
-            id: string;
-            enabled: boolean;
-        };
-    }>;
-}