@zibby/skills 0.1.84 → 0.1.85

package/dist/gbrain.d.ts

@@ -0,0 +1,115 @@
+export namespace gbrainSkill {
+    let id: string;
+    let serverName: string;
+    let allowedTools: string[];
+    let meta: any;
+    let description: string;
+    let promptFragment: string;
+    /**
+     * Spawn the GENERIC skill MCP server (bin/mcp-skill.mjs) pointing at this
+     * module's gbrainSkill export — same FIXED pattern as datasetStore. Forwards
+     * the backend-auth env + every bound-store mapping the spawned process needs.
+     */
+    function resolve(): {
+        command: any;
+        args: any[];
+        env: {};
+        description: string;
+        type?: undefined;
+        alwaysLoad?: undefined;
+    } | {
+        type: string;
+        command: string;
+        args: any[];
+        env: {};
+        description: string;
+        alwaysLoad: boolean;
+    };
+    function handleToolCall(name: any, args: any): Promise<string>;
+    let tools: ({
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                docs: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            sourceId: {
+                                type: string;
+                                description: string;
+                            };
+                            markdown: {
+                                type: string;
+                                description: string;
+                            };
+                            deleted: {
+                                type: string;
+                                description: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                store: {
+                    type: string;
+                    description: string;
+                };
+                query?: undefined;
+                topK?: undefined;
+                sourceIds?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                topK: {
+                    type: string;
+                    description: string;
+                };
+                store: {
+                    type: string;
+                    description: string;
+                };
+                docs?: undefined;
+                sourceIds?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                sourceIds: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                store: {
+                    type: string;
+                    description: string;
+                };
+                docs?: undefined;
+                query?: undefined;
+                topK?: undefined;
+            };
+            required: string[];
+        };
+    })[];
+}
+export default gbrainSkill;

package/dist/gbrain.js

@@ -0,0 +1,12 @@
+import{existsSync as f,readFileSync as b}from"node:fs";import{homedir as h}from"node:os";import{join as I,dirname as _,resolve as S}from"node:path";import{fileURLToPath as O}from"node:url";import{SKILL_META as E}from"@zibby/skill-ids";var T=3e4,p=1;function w(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let o=_(O(import.meta.url)),r=S(o,"..","bin","mcp-skill.mjs");return f(r)?r:null}function A(){if(process.env.PROJECT_API_TOKEN)return process.env.PROJECT_API_TOKEN;if(process.env.ZIBBY_USER_TOKEN)return process.env.ZIBBY_USER_TOKEN;try{let o=I(h(),".zibby","config.json");return f(o)&&JSON.parse(b(o,"utf-8")).sessionToken||null}catch{return null}}function k(){return process.env.ZIBBY_ACCOUNT_API_URL?process.env.ZIBBY_ACCOUNT_API_URL.replace(/\/$/,""):(process.env.ZIBBY_ENV||"prod")==="local"?"http://localhost:3001":process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://api-prod.zibby.app"}function v(){let o={};for(let[r,e]of Object.entries(process.env)){let t=/^ZIBBY_STORE__(.+)$/.exec(r);if(!t)continue;let n=typeof e=="string"?e.trim():"";n&&(o[t[1]]=n)}return o}function l(o){let r=v(),e=Object.keys(r),t=typeof o=="string"?o.trim():"";return t?Object.prototype.hasOwnProperty.call(r,t)?{storeId:r[t],name:t}:{error:`unknown store '${t}'; available: ${e.join(", ")}`}:e.length===1?{storeId:r[e[0]],name:e[0]}:e.length===0?{error:"no knowledge-base store is bound to this agent"}:{error:`multiple stores are bound; pass \`store\` (one of: ${e.join(", ")})`}}async function m(o,r,e){let t=A();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). The knowledge base is only available inside a Zibby run.");let n=`${k()}/datasets/stores/${encodeURIComponent(o)}/${r}`,s={Authorization:`Bearer ${t}`,"Content-Type":"application/json"},u=JSON.stringify(e),i;for(let c=0;c<=p;c++){let y=new AbortController,g=setTimeout(()=>y.abort(),T);try{let a=await fetch(n,{method:"POST",headers:s,body:u,signal:y.signal}),d=await a.text().catch(()=>"");if(a.status>=500&&c<p){i=new Error(`store ${a.status}`);continue}if(!a.ok)throw new Error(`gbrain ${r} failed (${a.status}): ${d.slice(0,300)}`);try{return JSON.parse(d)}catch{throw new Error(`store returned non-JSON: ${d.slice(0,200)}`)}}catch(a){if(i=a,!((a?.name==="AbortError"||a?.code==="ECONNREFUSED"||/fetch failed|network/i.test(String(a?.message)))&&c<p))break}finally{clearTimeout(g)}}throw i||new Error(`gbrain ${r} request failed`)}var N={id:"gbrain",serverName:"gbrain",allowedTools:["mcp__gbrain__*"],meta:E.gbrain,description:"Knowledge base (GBrain) \u2014 ingest source documents into, semantically query, and prune a per-tenant Postgres/pgvector brain (a `postgres`-type store, brokered by the control-plane)",promptFragment:`## Knowledge Base (GBrain \u2014 per-tenant document brain)
+You have a per-tenant KNOWLEDGE BASE (a Postgres + pgvector "brain"), bound as a
+\`postgres\`-type store in the "AVAILABLE STORES" block below. Ingested documents
+are addressed by a STABLE \`sourceId\` so re-ingesting the same source UPSERTS
+(updates in place) rather than duplicating, and a source can be removed. If
+exactly one store is bound you may omit \`store\`; otherwise pass its NAME.
+Tools:
+- gbrain_ingest({ docs, store? }): upsert an array of { sourceId, markdown, deleted? }.
+  Pass deleted:true to remove a source that no longer exists upstream.
+- gbrain_query({ query, topK, store? }): semantic search; returns the topK most
+  relevant document chunks with their sourceId and relevance score.
+- gbrain_delete({ sourceIds, store? }): remove documents by their stable sourceId(s).`,resolve(){let o=w();if(!o)return{command:null,args:[],env:{},description:this.description};let r={};for(let e of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[e]&&(r[e]=process.env[e]);for(let e of Object.keys(process.env))/^ZIBBY_STORE__.+$/.test(e)&&process.env[e]&&(r[e]=process.env[e]);return{type:"stdio",command:"node",args:[o,"../dist/gbrain.js","gbrainSkill"],env:r,description:this.description,alwaysLoad:!0}},async handleToolCall(o,r){try{switch(o){case"gbrain_ingest":{let e=Array.isArray(r?.docs)?r.docs:null;if(!e)return JSON.stringify({error:"docs is required (array of { sourceId, markdown, deleted? })"});if(e.length===0)return JSON.stringify({ok:!0,upserted:0,deleted:0,chunks:0,note:"empty docs \u2014 nothing to ingest"});if(e.find(i=>!i||typeof i.sourceId!="string"||!i.sourceId.trim())!==void 0)return JSON.stringify({error:"every doc requires a non-empty string sourceId"});let n=e.find(i=>i.deleted!==!0&&(typeof i.markdown!="string"||!i.markdown.length));if(n!==void 0)return JSON.stringify({error:`doc "${n.sourceId}" has no markdown (required unless deleted:true)`});let s=l(r?.store);if(s.error)return JSON.stringify({error:s.error});let u=await m(s.storeId,"ingest",{docs:e});return JSON.stringify({...u,store:s.name,storeId:s.storeId})}case"gbrain_query":{let e=typeof r?.query=="string"?r.query.trim():"";if(!e)return JSON.stringify({error:"query is required"});let t=l(r?.store);if(t.error)return JSON.stringify({error:t.error});let n={query:e};Number.isInteger(r?.topK)&&r.topK>0&&(n.topK=Math.min(r.topK,50));let s=await m(t.storeId,"query",n);return JSON.stringify({...s,store:t.name,storeId:t.storeId})}case"gbrain_delete":{let e=Array.isArray(r?.sourceIds)?r.sourceIds.filter(s=>typeof s=="string"&&s.trim()):null;if(!e||e.length===0)return JSON.stringify({error:"sourceIds is required (non-empty array of strings)"});let t=l(r?.store);if(t.error)return JSON.stringify({error:t.error});let n=await m(t.storeId,"delete",{sourceIds:e});return JSON.stringify({...n,store:t.name,storeId:t.storeId})}default:return JSON.stringify({error:`Unknown tool: ${o}`})}}catch(e){return JSON.stringify({error:String(e?.message||e)})}},tools:[{name:"gbrain_ingest",description:'Upsert documents into the knowledge base. Each doc is { sourceId, markdown, deleted? }; sourceId is a STABLE id (e.g. "owner/repo#docs/x.md" or a Lark doc token) so re-ingesting the same source UPDATES in place instead of duplicating. Set deleted:true to remove a source.',input_schema:{type:"object",properties:{docs:{type:"array",description:"Documents to upsert.",items:{type:"object",properties:{sourceId:{type:"string",description:"Stable source id \u2014 the upsert/delete key."},markdown:{type:"string",description:"The normalized markdown content of the document."},deleted:{type:"boolean",description:"When true, remove this sourceId from the brain (markdown ignored)."}},required:["sourceId"]}},store:{type:"string",description:"The bound knowledge-base store NAME (from AVAILABLE STORES). Omit if exactly one store is bound."}},required:["docs"]}},{name:"gbrain_query",description:"Semantic-search the knowledge base and return the most relevant document chunks (each with its sourceId and relevance score).",input_schema:{type:"object",properties:{query:{type:"string",description:"Natural-language query."},topK:{type:"integer",description:"How many chunks to return (default 8, max 50)."},store:{type:"string",description:"The bound knowledge-base store NAME (from AVAILABLE STORES). Omit if exactly one store is bound."}},required:["query"]}},{name:"gbrain_delete",description:"Remove documents from the knowledge base by their stable sourceId(s).",input_schema:{type:"object",properties:{sourceIds:{type:"array",description:"Stable source ids to delete.",items:{type:"string"}},store:{type:"string",description:"The bound knowledge-base store NAME (from AVAILABLE STORES). Omit if exactly one store is bound."}},required:["sourceIds"]}}]},U=N;export{U as default,N as gbrainSkill};

package/dist/index.d.ts

@@ -27,11 +27,12 @@ import { chartRenderSkill } from './chartRender.js';
 import { socialCardSkill } from './socialCard.js';
 import { codeScanSkill } from './code-scan.js';
 import { codebaseMemorySkill } from './codebaseMemory.js';
+import { gbrainSkill } from './gbrain.js';
 import { testRunnerSkill } from './test-runner.js';
 import { skillInstallerSkill } from './skill-installer.js';
 import { coreToolsSkill } from './core-tools.js';
 import { workflowBuilderSkill } from './workflow-builder.js';
-export { browserSkill, jiraSkill, githubSkill, gitlabSkill, figmaSkill, hubspotSkill, linearSkill, planeSkill, opendesignSkill, gitSkill, gitWriteSkill, slackSkill, larkSkill, discordSkill, notionSkill, linkedinSkill, googleDocsSkill, larkDocsSkill, chatNotifySkill, sentrySkill, memorySkill, chatMemorySkill, kvMemorySkill, datasetStoreSkill, chartRenderSkill, socialCardSkill, codeScanSkill, codebaseMemorySkill, testRunnerSkill, testRunnerSkill as runnerSkill, skillInstallerSkill, coreToolsSkill, workflowBuilderSkill };
+export { browserSkill, jiraSkill, githubSkill, gitlabSkill, figmaSkill, hubspotSkill, linearSkill, planeSkill, opendesignSkill, gitSkill, gitWriteSkill, slackSkill, larkSkill, discordSkill, notionSkill, linkedinSkill, googleDocsSkill, larkDocsSkill, chatNotifySkill, sentrySkill, memorySkill, chatMemorySkill, kvMemorySkill, datasetStoreSkill, chartRenderSkill, socialCardSkill, codeScanSkill, codebaseMemorySkill, gbrainSkill, testRunnerSkill, testRunnerSkill as runnerSkill, skillInstallerSkill, coreToolsSkill, workflowBuilderSkill };
 export { openaiBillingSkill, anthropicBillingSkill, cursorAdminSkill, fetchOpenAICosts, fetchOpenAIProjects, fetchAnthropicCosts, fetchAnthropicWorkspaces, fetchCursorSpend, fetchAllProviders, groupByKey, meanStddev } from "./llm-billing.js";
 export { reportObjectSchema, reportToBlockKit, reportToLarkCard, reportToNotionBlocks, reportToMarkdown, SEVERITIES as REPORT_SEVERITIES } from "./report.js";
 export { skill, functionSkill } from "./function-skill.js";