@zibby/skills 0.1.42 → 0.1.43

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/skills",
-  "version": "0.1.42",
+  "version": "0.1.43",
   "description": "Built-in skill definitions for the Zibby agent-workflow framework",
   "type": "module",
   "main": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/skills",
-  "version": "0.1.42",
+  "version": "0.1.43",
   "description": "Built-in skill definitions for the Zibby agent-workflow framework",
   "type": "module",
   "main": "dist/index.js",

package/dist/reviewMemory.d.ts

@@ -1,90 +0,0 @@
-export namespace reviewMemorySkill {
-    let id: string;
-    let serverName: string;
-    let allowedTools: string[];
-    let description: string;
-    let promptFragment: string;
-    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: {
-                scope: {
-                    type: string;
-                    description: string;
-                };
-                query: {
-                    type: string;
-                    description: string;
-                };
-                scopePrefix?: undefined;
-                content?: undefined;
-                metadata?: undefined;
-                headSha?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                scopePrefix: {
-                    type: string;
-                    description: string;
-                };
-                scope?: undefined;
-                query?: undefined;
-                content?: undefined;
-                metadata?: undefined;
-                headSha?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                scope: {
-                    type: string;
-                    description: string;
-                };
-                content: {
-                    type: string;
-                    description: string;
-                };
-                metadata: {
-                    type: string;
-                    description: string;
-                };
-                headSha: {
-                    type: string;
-                    description: string;
-                };
-                query?: undefined;
-                scopePrefix?: undefined;
-            };
-            required: string[];
-        };
-    })[];
-}

package/dist/reviewMemory.js

@@ -1,19 +0,0 @@
-import{existsSync as a,readFileSync as u,mkdirSync as w,writeFileSync as h,renameSync as y}from"node:fs";import{homedir as _}from"node:os";import{join as d,dirname as m,resolve as f}from"node:path";import{fileURLToPath as v}from"node:url";function S(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let e=m(v(import.meta.url)),t=f(e,"..","bin","mcp-skill.mjs");return a(t)?t:null}function g(){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 e=d(_(),".zibby","config.json");return a(e)&&JSON.parse(u(e,"utf-8")).sessionToken||null}catch{return null}}function P(){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"}async function O(e,t){let r=g();if(!r)throw new Error("No backend credential (PROJECT_API_TOKEN). Review memory is only available inside a Zibby run.");let o=`${P()}/credits/review-memory`,n=await fetch(o,{method:"POST",headers:{Authorization:`Bearer ${r}`,"Content-Type":"application/json"},body:JSON.stringify({op:e,...t})});if(!n.ok){let s=await n.text().catch(()=>"");throw new Error(`Review memory ${e} failed (${n.status}): ${s.slice(0,300)}`)}return n.json()}function R(){let e=process.env.ZIBBY_SELF_HOST;return e!=null&&e!==""&&e!=="0"&&e.toLowerCase()!=="false"}function A(){if(!R()||(process.env.ZIBBY_REVIEW_MEMORY_BACKEND||"").trim().toLowerCase()==="none")return null;let t=process.env.ZIBBY_REVIEW_MEMORY_PATH,r=t&&t.trim()?t.trim():d(".zibby","review-memory.json");return f(process.cwd(),r)}function i(e){try{if(!a(e))return{};let t=u(e,"utf-8");if(!t.trim())return{};let r=JSON.parse(t);return r&&typeof r=="object"&&!Array.isArray(r)?r:{}}catch{return{}}}function b(e,t){let r=m(e);w(r,{recursive:!0});let o=`${e}.tmp-${process.pid}-${Date.now()}`;h(o,`${JSON.stringify(t,null,2)}
-`,"utf-8"),y(o,e)}function l(e){return!e||typeof e!="object"?null:{scope:e.scope,content:e.content,metadata:e.metadata||null,headSha:e.headSha||null,createdAt:e.createdAt||null,updatedAt:e.updatedAt||null}}function T(e,t,r){if(t==="store"){let o=i(e),n=new Date().toISOString(),s=o[r.scope],p={scope:r.scope,content:r.content,metadata:r.metadata!=null?r.metadata:void 0,headSha:r.headSha!=null?r.headSha:void 0,createdAt:s&&s.createdAt||n,updatedAt:n};return o[r.scope]=p,b(e,o),{stored:!0,scope:r.scope,headSha:p.headSha||null,updatedAt:n}}if(t==="recall"){let n=i(e)[r.scope];return n?{found:!0,memory:l(n)}:{found:!1,memory:null}}if(t==="recall-prefix"){let o=i(e),n=Object.values(o).filter(s=>s&&typeof s.scope=="string"&&s.scope.startsWith(r.scopePrefix)).map(l).slice(0,25);return{count:n.length,truncated:!1,memories:n}}return{error:`Unknown op: ${t}`}}async function c(e,t){let r=A();return r?T(r,e,t):O(e,t)}var k={id:"review-memory",serverName:"review_memory",allowedTools:["mcp__review_memory__*"],description:"Review memory \u2014 persist & recall per-PR (configurable-scope) review notes across stateless runs",promptFragment:`## Review Memory (per-PR, configurable scope)
-Persist what you pulled, found, and reasoned during a review so a FOLLOW-UP
-run (a fresh stateless task replying on the same PR) can recall it. Storage is
-keyed by a \`scope\` STRING you choose \u2014 nothing is hardcoded to per-PR:
-- per-PR:   scope = "review:owner/repo#<prNumber>"   (the usual choice)
-- per-repo: scope = "repo:owner/repo"
-- per-org:  scope = "org:owner"
-Same tools, different scope string \u2014 pick the granularity you need.
-
-Tools:
-- review_memory_recall: At the START of a review, recall any prior note for
-  this PR's scope (e.g. "review:owner/repo#42"). If found, build on it instead
-  of re-deriving everything.
-- review_memory_recall_prefix: List notes whose scope starts with a prefix
-  (e.g. "review:owner/repo#") \u2014 e.g. to see prior reviews across a repo.
-- review_memory_store: At the END (or when you learn something durable), store
-  a concise note under the PR's scope. Pass headSha so a later run knows which
-  commit the note describes. Overwrites the prior note for that exact scope.`,resolve(){let e=S();if(!e)return{command:null,args:[],env:{},description:this.description};let t={};for(let r of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","ZIBBY_SELF_HOST","ZIBBY_REVIEW_MEMORY_BACKEND","ZIBBY_REVIEW_MEMORY_PATH"])process.env[r]&&(t[r]=process.env[r]);return{type:"stdio",command:"node",args:[e,"../dist/reviewMemory.js","reviewMemorySkill"],env:t,description:this.description,alwaysLoad:!0}},async handleToolCall(e,t){try{switch(e){case"review_memory_recall":{let r=typeof t?.scope=="string"?t.scope.trim():"";if(!r)return JSON.stringify({error:"scope is required"});let o=await c("recall",{scope:r});return JSON.stringify(o)}case"review_memory_recall_prefix":{let r=typeof t?.scopePrefix=="string"?t.scopePrefix.trim():"";if(!r)return JSON.stringify({error:"scopePrefix is required"});let o=await c("recall-prefix",{scopePrefix:r});return JSON.stringify(o)}case"review_memory_store":{let r=typeof t?.scope=="string"?t.scope.trim():"";if(!r)return JSON.stringify({error:"scope is required"});if(typeof t?.content!="string"||t.content.length===0)return JSON.stringify({error:"content is required (non-empty string)"});let o={scope:r,content:t.content};t.metadata!=null&&(o.metadata=t.metadata),t.headSha!=null&&(o.headSha=String(t.headSha));let n=await c("store",o);return JSON.stringify(n)}default:return JSON.stringify({error:`Unknown tool: ${e}`})}}catch(r){return JSON.stringify({error:r.message})}},tools:[{name:"review_memory_recall",description:'Recall the prior review note for a scope (exact match). Use at the start of a review to build on what an earlier run pulled/found/reasoned. scope is the storage key \u2014 e.g. "review:owner/repo#42" for per-PR.',input_schema:{type:"object",properties:{scope:{type:"string",description:'Storage key. Per-PR: "review:owner/repo#<prNumber>". Per-repo: "repo:owner/repo". Per-org: "org:owner". Or any custom string.'},query:{type:"string",description:"Optional free-text hint (reserved for future semantic recall; v1 ignores it \u2014 recall is exact-scope)."}},required:["scope"]}},{name:"review_memory_recall_prefix",description:'List review notes whose scope STARTS WITH a prefix (e.g. "review:owner/repo#" to see all prior PR reviews in a repo). Capped at 25 most-relevant.',input_schema:{type:"object",properties:{scopePrefix:{type:"string",description:'Scope prefix to match, e.g. "review:owner/repo#" or "repo:owner/".'}},required:["scopePrefix"]}},{name:"review_memory_store",description:"Store (overwrite) the review note for a scope so a follow-up run can recall it. Write a concise summary of what you pulled, found, and reasoned. Pass headSha so a later run knows which commit the note describes.",input_schema:{type:"object",properties:{scope:{type:"string",description:'Storage key. Per-PR: "review:owner/repo#<prNumber>". Or per-repo/per-org/custom. Same key you recall by.'},content:{type:"string",description:"The note: what was pulled, what was found, the reasoning. Free-form markdown/text."},metadata:{type:"object",description:"Optional structured metadata (e.g. {filesReviewed, verdict, severity})."},headSha:{type:"string",description:"Optional PR head commit SHA this note describes \u2014 lets a later run detect new commits."}},required:["scope","content"]}}]};export{k as reviewMemorySkill};