@zibby/skills 0.1.68 → 0.1.71

package/dist/larkDocs.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Derive the human-facing doc web URL from the open-api host + document id.
+ * The open-api host (open.feishu.cn / open.larksuite.com) is region-specific;
+ * the web doc lives on the corresponding product domain. This is a best-effort
+ * canonical URL — a tenant with a vanity subdomain may render its own host, but
+ * the product-domain URL still resolves for the user.
+ */
+export function docWebUrl(host: any, id: any): string;
+/**
+ * Parse a Lark/Feishu doc reference (raw token OR URL) into { type, token }.
+ *   - .../docx/<token>  → { type:'docx', token }
+ *   - .../wiki/<token>  → { type:'wiki', token } (resolved to its docx obj_token)
+ *   - bare token        → { type:'docx', token }
+ * Returns null when nothing usable can be extracted. Pure + side-effect-free.
+ */
+export function parseLarkDocRef(ref: any): {
+    type: string;
+    token: string;
+};
+/**
+ * Map a small, common subset of markdown into Lark Docx block objects.
+ * Each block is a single line: headings (#/##/### → heading1/2/3), bullets
+ * (- / *), ordered (1.), everything else a text paragraph. Inline marks are
+ * kept as literal text (content is preserved; we don't emit Lark text-element
+ * styles — honest + robust). Empty lines are skipped (Lark rejects empty text
+ * blocks). Bounded by the caller's chunking to MAX_BLOCK_CHILDREN per request.
+ */
+export function markdownToLarkBlocks(markdown: any): {
+    [x: string]: number | {
+        elements: {
+            text_run: {
+                content: string;
+            };
+        }[];
+        style: {};
+    };
+    block_type: number;
+}[];
+export function _resetLarkDocsTokenCache(): void;
+export namespace larkDocsSkill {
+    let id: string;
+    let serverName: string;
+    let allowedTools: string[];
+    let requiresIntegration: "lark";
+    let description: string;
+    let envKeys: any[];
+    let promptFragment: string;
+    /**
+     * Spawn the GENERIC skill MCP server (bin/mcp-skill.mjs) pointing at this
+     * module's larkDocsSkill export, so the AGENT gets real mcp__larkdocs__*
+     * tools. Auth flows through the INHERITED env (PROJECT_API_TOKEN →
+     * resolveIntegrationToken('lark')), so no provider-specific env keys are
+     * needed here. When unconnected, handleToolCall returns { ok:false, error }.
+     */
+    function resolve(): {
+        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: {
+                documentId: {
+                    type: string;
+                    description: string;
+                };
+                title?: undefined;
+                markdown?: undefined;
+                text?: undefined;
+                folderToken?: undefined;
+                fileType?: undefined;
+                commentId?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                title: {
+                    type: string;
+                    description: string;
+                };
+                markdown: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                folderToken: {
+                    type: string;
+                    description: string;
+                };
+                documentId?: undefined;
+                fileType?: undefined;
+                commentId?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                documentId: {
+                    type: string;
+                    description: string;
+                };
+                markdown: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                title?: undefined;
+                folderToken?: undefined;
+                fileType?: undefined;
+                commentId?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                documentId: {
+                    type: string;
+                    description: string;
+                };
+                fileType: {
+                    type: string;
+                    description: string;
+                };
+                title?: undefined;
+                markdown?: undefined;
+                text?: undefined;
+                folderToken?: undefined;
+                commentId?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                documentId: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                fileType: {
+                    type: string;
+                    description: string;
+                };
+                title?: undefined;
+                markdown?: undefined;
+                folderToken?: undefined;
+                commentId?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                documentId: {
+                    type: string;
+                    description: string;
+                };
+                commentId: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                fileType: {
+                    type: string;
+                    description: string;
+                };
+                title?: undefined;
+                markdown?: undefined;
+                folderToken?: undefined;
+            };
+            required: string[];
+        };
+    })[];
+}

package/dist/larkDocs.js

@@ -0,0 +1,11 @@
+import{existsSync as b}from"fs";import{fileURLToPath as S}from"url";import{dirname as v,resolve as R}from"path";import{resolveIntegrationToken as A}from"@zibby/core/backend-client.js";var g=Object.freeze({SENTRY:"sentry",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",SLACK:"slack",LARK:"lark",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin",NOTION:"notion",GOOGLE:"google",PLANE:"plane",LINEAR:"linear",FIGMA:"figma",OPEN_DESIGN:"open_design",LINKEDIN_PERSONAL:"linkedin_personal",LINKEDIN_BUSINESS:"linkedin_business",DISCORD:"discord"}),C=Object.freeze({sentry:{id:"sentry",name:"Sentry",connectPath:"/integrations?provider=sentry"},jira:{id:"jira",name:"Jira",connectPath:"/integrations?provider=jira"},github:{id:"github",name:"GitHub",connectPath:"/integrations?provider=github"},gitlab:{id:"gitlab",name:"GitLab",connectPath:"/integrations?provider=gitlab"},slack:{id:"slack",name:"Slack",connectPath:"/integrations?provider=slack"},lark:{id:"lark",name:"Lark",connectPath:"/integrations?provider=lark"},openai_billing:{id:"openai_billing",name:"OpenAI Admin",connectPath:"/integrations?provider=openai_billing"},anthropic_billing:{id:"anthropic_billing",name:"Anthropic Admin",connectPath:"/integrations?provider=anthropic_billing"},cursor_admin:{id:"cursor_admin",name:"Cursor Admin",connectPath:"/integrations?provider=cursor_admin"},notion:{id:"notion",name:"Notion",connectPath:"/integrations?provider=notion"},google:{id:"google",name:"Google Docs",connectPath:"/integrations?provider=google"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"},figma:{id:"figma",name:"Figma",connectPath:"/integrations?provider=figma"},open_design:{id:"open_design",name:"OpenDesign",connectPath:"/integrations?provider=open_design"},linkedin_personal:{id:"linkedin_personal",name:"LinkedIn (Personal)",connectPath:"/integrations?provider=linkedin_personal"},linkedin_business:{id:"linkedin_business",name:"LinkedIn (Business)",connectPath:"/integrations?provider=linkedin_business"},discord:{id:"discord",name:"Discord",connectPath:"/integrations?provider=discord"}});function N(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let t=v(S(import.meta.url)),e=R(t,"..","bin","mcp-skill.mjs");return b(e)?e:null}var I=2e4,x=50,O=6e3*1e3,u=null;async function E(){let{appId:t,appSecret:e,host:n}=await A("lark");if(u&&u.appId===t&&u.expiresAt>Date.now())return{token:u.token,host:n};let o=await(await fetch(`${n}/open-apis/auth/v3/tenant_access_token/internal`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({app_id:t,app_secret:e})})).json();if(o.code!==0)throw new Error(`Lark tenant_access_token failed: ${o.msg||o.code}`);return u={token:o.tenant_access_token,expiresAt:Date.now()+O,appId:t},{token:o.tenant_access_token,host:n}}async function l(t,e,n){let{token:r,host:o}=await E(),i={method:t,headers:{Authorization:`Bearer ${r}`,"Content-Type":"application/json; charset=utf-8"}};t!=="GET"&&n!==void 0&&(i.body=JSON.stringify(n));let c=await(await fetch(`${o}${e}`,i)).json();if(c.code!==0)throw new Error(`Lark Docx API ${e} error: ${c.msg||c.code}`);return{data:c.data||{},host:o}}function h(t,e){return String(t||"").includes("feishu")?`https://feishu.cn/docx/${e}`:`https://www.larksuite.com/docx/${e}`}function m(t){if(!t||typeof t!="string")return null;let e=t.trim();if(!e)return null;let n=e.match(/\/(docx|wiki)\/([A-Za-z0-9]+)/);return n?{type:n[1],token:n[2]}:/^[A-Za-z0-9]{10,}$/.test(e)?{type:"docx",token:e}:null}async function k(t){let e=typeof t=="string"?m(t):t;if(!e)throw new Error("A valid Lark doc id or URL is required");if(e.type==="docx")return e.token;let{data:n}=await l("GET",`/open-apis/wiki/v2/spaces/get_node?token=${encodeURIComponent(e.token)}`),r=n?.node||{};if(r.obj_type!=="docx"||!r.obj_token)throw new Error(`Wiki node is not a docx document (obj_type=${r.obj_type||"unknown"})`);return r.obj_token}function L(t){let e=String(t??"").replace(/\r\n/g,`
+`),n=[];for(let r of e.split(`
+`)){let o=r.replace(/\s+$/,"");if(!o.trim())continue;let i=/^(#{1,3})\s+(.*)$/.exec(o),s=/^\s*[-*]\s+(.*)$/.exec(o),c=/^\s*\d+[.)]\s+(.*)$/.exec(o),a,d,p;if(i){let _=i[1].length;a=`heading${_}`,d=2+_,p=i[2]}else s?(a="bullet",d=12,p=s[1]):c?(a="ordered",d=13,p=c[1]):(a="text",d=2,p=o);n.push({block_type:d,[a]:{elements:[{text_run:{content:p}}],style:{}}})}return n}function f(t){let e=typeof t?.markdown=="string"?t.markdown:null,n=typeof t?.text=="string"?t.text:null;return e??n}async function w(t,e){let n;for(let r=0;r<e.length;r+=x){let o=e.slice(r,r+x);n=(await l("POST",`/open-apis/docx/v1/documents/${t}/blocks/${t}/children?document_revision_id=-1`,{children:o})).host}return n}var P="docx",U=50;function T(t){return[{type:"text_run",text_run:{text:String(t??"")}}]}function D(t){return Array.isArray(t)?t.map(e=>e?.text_run?.text??e?.docs_link?.url??(e?.person?`@${e.person.user_id||""}`:"")).join(""):""}function $(t){let e=Array.isArray(t?.reply_list?.replies)?t.reply_list.replies:[];return{commentId:t?.comment_id||"",resolved:!!t?.is_solved,replies:e.map(n=>({replyId:n?.reply_id||"",author:n?.user_id||"",text:D(n?.content?.elements),createTime:n?.create_time||""}))}}function y(t){return typeof t?.fileType=="string"&&t.fileType.trim()?t.fileType.trim():P}var M={id:"lark-docs",serverName:"larkdocs",allowedTools:["mcp__larkdocs__*"],requiresIntegration:g.LARK,description:"Lark / Feishu Docs \u2014 read, create, and append Lark documents (docx).",envKeys:[],promptFragment:`## Lark Docs (connected)
+You can read, create, and append Lark/Feishu documents (docx). This reuses the same connected Lark app as messaging.
+- larkdoc_get: pass a Lark doc id OR a full doc URL (a /docx/ or /wiki/ link); returns { ok, documentId, title, url, text } where text is the doc as plain text (truncated to ~20k chars). Use it as reference context.
+- larkdoc_create: create a new doc from a title + markdown/text (#/##/### headings, - bullets, 1. ordered supported); returns { ok, documentId, url }. Share the url.
+- larkdoc_append: append markdown/text to the end of an existing doc (pass the documentId or doc URL).
+- larkdoc_list_comments: list the comment threads on a doc (pass the documentId or doc URL); returns { ok, comments:[{ commentId, replies:[{ replyId, author, text }] }] }. Use to read the thread you are replying to.
+- larkdoc_reply_comment: reply INSIDE an existing comment thread \u2014 pass { documentId, commentId, text }. Use this to answer a user who @mentioned Zibby in a doc comment (reply in the SAME commentId).
+- larkdoc_add_comment: post a NEW top-level comment on a doc \u2014 pass { documentId, text }.
+These tools return { ok:false, error } on failure \u2014 treat an unavailable Lark connection as "cannot read/deliver to Lark Docs" and continue rather than blocking the task.`,resolve(){let t=N();return t?{type:"stdio",command:"node",args:[t,"../dist/larkDocs.js","larkDocsSkill"],env:{},description:this.description,alwaysLoad:!0}:null},async handleToolCall(t,e){try{switch(t){case"larkdoc_get":{let n=e?.documentId||e?.url||e?.id,r=m(n);if(!r)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let o=await k(r),i="";try{i=(await l("GET",`/open-apis/docx/v1/documents/${o}`)).data?.document?.title||""}catch{}let{data:s,host:c}=await l("GET",`/open-apis/docx/v1/documents/${o}/raw_content?lang=0`),a=String(s?.content||""),d=!1;return a.length>I&&(a=a.slice(0,I),d=!0),JSON.stringify({ok:!0,documentId:o,title:i,url:h(c,o),text:a,...d?{truncated:!0}:{}})}case"larkdoc_create":{let n=typeof e?.title=="string"&&e.title.trim()?e.title.trim():null;if(!n)return JSON.stringify({ok:!1,error:"title is required"});let{data:r,host:o}=await l("POST","/open-apis/docx/v1/documents",{title:n,...e?.folderToken?{folder_token:String(e.folderToken)}:{}}),i=r?.document?.document_id;if(!i)return JSON.stringify({ok:!1,error:"Lark Docs create returned no document_id"});let s=f(e);if(s&&s.trim()){let c=L(s);c.length&&await w(i,c)}return JSON.stringify({ok:!0,documentId:i,title:n,url:h(o,i)})}case"larkdoc_append":{let n=e?.documentId||e?.url||e?.id,r=m(n);if(!r)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let o=f(e);if(!o||!o.trim())return JSON.stringify({ok:!1,error:"markdown or text content is required"});let i=await k(r),s=L(o);if(!s.length)return JSON.stringify({ok:!1,error:"no non-empty content to append"});let c=await w(i,s);return JSON.stringify({ok:!0,documentId:i,url:h(c,i)})}case"larkdoc_list_comments":{let n=e?.documentId||e?.url||e?.id||e?.fileToken,r=m(n);if(!r)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let o=await k(r),i=y(e),s=new URLSearchParams({file_type:i,page_size:String(U)}),{data:c}=await l("GET",`/open-apis/drive/v1/files/${o}/comments?${s.toString()}`),d=(Array.isArray(c?.items)?c.items:[]).map($);return JSON.stringify({ok:!0,documentId:o,count:d.length,comments:d})}case"larkdoc_add_comment":{let n=e?.documentId||e?.url||e?.id||e?.fileToken,r=m(n);if(!r)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let o=f({text:e?.text??e?.body});if(!o||!o.trim())return JSON.stringify({ok:!1,error:"text is required"});let i=await k(r),s=y(e),{data:c}=await l("POST",`/open-apis/drive/v1/files/${i}/comments?file_type=${encodeURIComponent(s)}`,{reply_list:{replies:[{content:{elements:T(o)}}]}});return JSON.stringify({ok:!0,documentId:i,commentId:c?.comment_id||""})}case"larkdoc_reply_comment":{let n=e?.documentId||e?.url||e?.id||e?.fileToken,r=m(n);if(!r)return JSON.stringify({ok:!1,error:"A valid Lark doc id or URL is required"});let o=e?.commentId||e?.comment_id;if(!o)return JSON.stringify({ok:!1,error:"commentId is required"});let i=f({text:e?.text??e?.body});if(!i||!i.trim())return JSON.stringify({ok:!1,error:"text is required"});let s=await k(r),c=y(e),{data:a}=await l("POST",`/open-apis/drive/v1/files/${s}/comments/${encodeURIComponent(o)}/replies?file_type=${encodeURIComponent(c)}`,{content:{elements:T(i)}});return JSON.stringify({ok:!0,documentId:s,commentId:String(o),replyId:a?.reply_id||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${t}`})}}catch(n){return JSON.stringify({ok:!1,error:n.message})}},tools:[{name:"larkdoc_get",description:"Read a Lark/Feishu document (docx) as plain text, for use as reference context. Accepts a raw doc id OR a full Lark doc URL (a /docx/ or /wiki/ link \u2014 wiki links are resolved to their backing docx). Returns { ok, documentId, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL (/docx/\u2026 or /wiki/\u2026)."}},required:["documentId"]}},{name:"larkdoc_create",description:"Create a new Lark/Feishu document (docx) with a title and optional content (markdown: #/##/### headings, - bullets, 1. ordered; or plain text). Returns { ok, documentId, url } \u2014 share the url with the user.",input_schema:{type:"object",properties:{title:{type:"string",description:"Document title."},markdown:{type:"string",description:"Document body as markdown (preferred)."},text:{type:"string",description:"Document body as plain text (used when markdown is absent)."},folderToken:{type:"string",description:"Optional Lark drive folder token to create the doc in. Absent = the app root."}},required:["title"]}},{name:"larkdoc_append",description:"Append markdown/text content to the END of an existing Lark/Feishu document (docx). Accepts a documentId or a full Lark doc URL. Returns { ok, documentId, url }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},markdown:{type:"string",description:"Content to append, as markdown (preferred)."},text:{type:"string",description:"Content to append, as plain text (used when markdown is absent)."}},required:["documentId"]}},{name:"larkdoc_list_comments",description:"List the comment threads on a Lark/Feishu document. Accepts a documentId or full doc URL. Returns { ok, comments:[{ commentId, replies:[{ replyId, author, text }] }] }. Use to read the thread you are replying to.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'. Only change for non-docx files (doc/sheet/bitable/file/slides)."}},required:["documentId"]}},{name:"larkdoc_add_comment",description:"Post a NEW top-level comment on a Lark/Feishu document. Accepts a documentId or full doc URL plus text. Returns { ok, documentId, commentId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},text:{type:"string",description:"The comment body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","text"]}},{name:"larkdoc_reply_comment",description:"Reply INSIDE an existing comment thread on a Lark/Feishu document. Pass { documentId, commentId, text }. Use to answer a user who @mentioned Zibby in a doc comment (reply in the same commentId). Returns { ok, documentId, commentId, replyId }.",input_schema:{type:"object",properties:{documentId:{type:"string",description:"Lark doc id (docx token) OR a full Lark/Feishu doc URL."},commentId:{type:"string",description:"The comment_id of the thread to reply into (from larkdoc_list_comments or the webhook event)."},text:{type:"string",description:"The reply body (plain text)."},fileType:{type:"string",description:"Drive file type \u2014 defaults to 'docx'."}},required:["documentId","commentId","text"]}}]};function K(){u=null}export{K as _resetLarkDocsTokenCache,h as docWebUrl,M as larkDocsSkill,L as markdownToLarkBlocks,m as parseLarkDocRef};

package/dist/notion.d.ts

@@ -63,6 +63,9 @@ export namespace notionSkill {
                 databaseId?: undefined;
                 filter?: undefined;
                 maxResults?: undefined;
+                blockId?: undefined;
+                discussionId?: undefined;
+                text?: undefined;
             };
             required: string[];
         };
@@ -86,6 +89,53 @@ export namespace notionSkill {
                     description: string;
                 };
                 pageId?: undefined;
+                blockId?: undefined;
+                discussionId?: undefined;
+                text?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                blockId: {
+                    type: string;
+                    description: string;
+                };
+                pageId?: undefined;
+                databaseId?: undefined;
+                filter?: undefined;
+                maxResults?: undefined;
+                discussionId?: undefined;
+                text?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                discussionId: {
+                    type: string;
+                    description: string;
+                };
+                pageId: {
+                    type: string;
+                    description: string;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                };
+                databaseId?: undefined;
+                filter?: undefined;
+                maxResults?: undefined;
+                blockId?: undefined;
             };
             required: string[];
         };

package/dist/notion.js

@@ -1,9 +1,11 @@
-import{existsSync as I}from"fs";import{fileURLToPath as $}from"url";import{dirname as A,resolve as w}from"path";import{resolveIntegrationToken as O,clearTokenCache as S}from"@zibby/core/backend-client.js";var m=Object.freeze({SENTRY:"sentry",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",SLACK:"slack",LARK:"lark",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin",NOTION:"notion",GOOGLE:"google",PLANE:"plane",LINEAR:"linear",FIGMA:"figma",OPEN_DESIGN:"open_design",LINKEDIN_PERSONAL:"linkedin_personal",LINKEDIN_BUSINESS:"linkedin_business",DISCORD:"discord"}),j=Object.freeze({sentry:{id:"sentry",name:"Sentry",connectPath:"/integrations?provider=sentry"},jira:{id:"jira",name:"Jira",connectPath:"/integrations?provider=jira"},github:{id:"github",name:"GitHub",connectPath:"/integrations?provider=github"},gitlab:{id:"gitlab",name:"GitLab",connectPath:"/integrations?provider=gitlab"},slack:{id:"slack",name:"Slack",connectPath:"/integrations?provider=slack"},lark:{id:"lark",name:"Lark",connectPath:"/integrations?provider=lark"},openai_billing:{id:"openai_billing",name:"OpenAI Admin",connectPath:"/integrations?provider=openai_billing"},anthropic_billing:{id:"anthropic_billing",name:"Anthropic Admin",connectPath:"/integrations?provider=anthropic_billing"},cursor_admin:{id:"cursor_admin",name:"Cursor Admin",connectPath:"/integrations?provider=cursor_admin"},notion:{id:"notion",name:"Notion",connectPath:"/integrations?provider=notion"},google:{id:"google",name:"Google Docs",connectPath:"/integrations?provider=google"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"},figma:{id:"figma",name:"Figma",connectPath:"/integrations?provider=figma"},open_design:{id:"open_design",name:"OpenDesign",connectPath:"/integrations?provider=open_design"},linkedin_personal:{id:"linkedin_personal",name:"LinkedIn (Personal)",connectPath:"/integrations?provider=linkedin_personal"},linkedin_business:{id:"linkedin_business",name:"LinkedIn (Business)",connectPath:"/integrations?provider=linkedin_business"},discord:{id:"discord",name:"Discord",connectPath:"/integrations?provider=discord"}});function x(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let t=A($(import.meta.url)),a=w(t,"..","bin","mcp-skill.mjs");return I(a)?a:null}var R="2022-06-28",L="https://api.notion.com/v1",g=2e4,b=25,v=25;function _(t){if(!t||typeof t!="string")return null;let i=t.trim().split(/[?#]/)[0],e=i.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/);if(e)return e[0].toLowerCase();let n=i.match(/[0-9a-fA-F]{32}/g);if(n&&n.length){let r=n[n.length-1].toLowerCase();return`${r.slice(0,8)}-${r.slice(8,12)}-${r.slice(12,16)}-${r.slice(16,20)}-${r.slice(20)}`}return null}async function h(t,a={}){let i=async()=>{let{token:e}=await O("notion");if(typeof e!="string"||!e)throw new Error(`Invalid notion token type: ${typeof e}`);let n=await fetch(`${L}${t}`,{method:a.method||"GET",headers:{Authorization:`Bearer ${e}`,"Notion-Version":R,Accept:"application/json",...a.body?{"Content-Type":"application/json"}:{},...a.headers},body:a.body?JSON.stringify(a.body):void 0});if(!n.ok){let s=await n.text().catch(()=>"");throw new Error(`Notion API ${n.status}: ${s.slice(0,300)}`)}let r=await n.text().catch(()=>"");if(!r||!r.trim())return{};try{return JSON.parse(r)}catch{return{raw:r}}};try{return await i()}catch(e){let n=String(e?.message||e||"").toLowerCase();if(!(n.includes("token")||n.includes("401")||n.includes("unauthorized")))throw e;return S("notion"),i()}}function p(t){if(!Array.isArray(t))return"";let a="";for(let i of t){let e=i?.plain_text??i?.text?.content??"";if(!e)continue;let n=i.annotations||{};n.code&&(e=`\`${e}\``),n.bold&&(e=`**${e}**`),n.italic&&(e=`_${e}_`),n.strikethrough&&(e=`~~${e}~~`);let r=i?.href||i?.text?.link?.url;r&&(e=`[${e}](${r})`),a+=e}return a}function P(t,a,i){let e=t?.type,n=t?.[e]||{},r="  ".repeat(Math.max(0,a)),s=(c="rich_text")=>p(n[c]),o;switch(e){case"paragraph":o=s();break;case"heading_1":o=`# ${s()}`;break;case"heading_2":o=`## ${s()}`;break;case"heading_3":o=`### ${s()}`;break;case"bulleted_list_item":o=`${r}- ${s()}`;break;case"numbered_list_item":o=`${r}1. ${s()}`;break;case"to_do":o=`${r}- [${n.checked?"x":" "}] ${s()}`;break;case"toggle":o=`${r}- ${s()}`;break;case"quote":o=`> ${s()}`;break;case"callout":{o=`> ${n.icon?.emoji?`${n.icon.emoji} `:""}${s()}`;break}case"code":{o=`\`\`\`${n.language||""}
-${s()}
-\`\`\``;break}case"divider":o="---";break;case"child_page":o=`[child page: ${n.title||""}]`;break;case"child_database":o=`[child database: ${n.title||""}]`;break;case"bookmark":case"embed":case"link_preview":o=n.url?`<${n.url}>`:"";break;case"equation":o=n.expression?`$${n.expression}$`:"";break;case"table":case"column_list":case"column":o="";break;case"table_row":{let c=(n.cells||[]).map(d=>p(d).trim());o=`${r}| ${c.join(" | ")} |`;break}default:o=s();break}let l=[];return o&&o.trim()&&l.push(o),i&&i.trim()&&l.push(i),l.join(`
-`)}async function y(t,a,i){let e=[],n,r=0;do{if(i.used>=g)break;let s=new URLSearchParams({page_size:"100"});n&&s.set("start_cursor",n);let o=await h(`/blocks/${t}/children?${s.toString()}`),l=Array.isArray(o.results)?o.results:[];for(let c of l){let d="";c.has_children&&(d=await y(c.id,a+1,i));let u=P(c,a,d);if(u&&(e.push(u),i.used+=u.length+1),i.used>=g)break}n=o.has_more?o.next_cursor:void 0,r+=1}while(n&&r<v);return e.join(`
-`)}function k(t){let a=t?.properties||{};for(let i of Object.values(a))if(i?.type==="title"){let e=p(i.title).trim();if(e)return e}return""}function T(t){if(!t||!t.type)return"";switch(t.type){case"title":return p(t.title).trim();case"rich_text":return p(t.rich_text).trim();case"number":return t.number==null?"":String(t.number);case"select":return t.select?.name||"";case"status":return t.status?.name||"";case"multi_select":return(t.multi_select||[]).map(i=>i.name).join(", ");case"checkbox":return t.checkbox?"true":"false";case"url":return t.url||"";case"email":return t.email||"";case"phone_number":return t.phone_number||"";case"date":return t.date?.start||"";case"people":return(t.people||[]).map(i=>i.name||i.id).join(", ");default:return""}}var D={id:"notion",serverName:"notion",allowedTools:["mcp__notion__*"],requiresIntegration:m.NOTION,description:"Notion read-only context (pull a page/database as markdown)",promptFragment:`## Notion (connected, read-only context)
+import{existsSync as x}from"fs";import{fileURLToPath as R}from"url";import{dirname as w,resolve as O}from"path";import{resolveIntegrationToken as S,clearTokenCache as A}from"@zibby/core/backend-client.js";var _=Object.freeze({SENTRY:"sentry",JIRA:"jira",GITHUB:"github",GITLAB:"gitlab",SLACK:"slack",LARK:"lark",OPENAI_BILLING:"openai_billing",ANTHROPIC_BILLING:"anthropic_billing",CURSOR_ADMIN:"cursor_admin",NOTION:"notion",GOOGLE:"google",PLANE:"plane",LINEAR:"linear",FIGMA:"figma",OPEN_DESIGN:"open_design",LINKEDIN_PERSONAL:"linkedin_personal",LINKEDIN_BUSINESS:"linkedin_business",DISCORD:"discord"}),j=Object.freeze({sentry:{id:"sentry",name:"Sentry",connectPath:"/integrations?provider=sentry"},jira:{id:"jira",name:"Jira",connectPath:"/integrations?provider=jira"},github:{id:"github",name:"GitHub",connectPath:"/integrations?provider=github"},gitlab:{id:"gitlab",name:"GitLab",connectPath:"/integrations?provider=gitlab"},slack:{id:"slack",name:"Slack",connectPath:"/integrations?provider=slack"},lark:{id:"lark",name:"Lark",connectPath:"/integrations?provider=lark"},openai_billing:{id:"openai_billing",name:"OpenAI Admin",connectPath:"/integrations?provider=openai_billing"},anthropic_billing:{id:"anthropic_billing",name:"Anthropic Admin",connectPath:"/integrations?provider=anthropic_billing"},cursor_admin:{id:"cursor_admin",name:"Cursor Admin",connectPath:"/integrations?provider=cursor_admin"},notion:{id:"notion",name:"Notion",connectPath:"/integrations?provider=notion"},google:{id:"google",name:"Google Docs",connectPath:"/integrations?provider=google"},plane:{id:"plane",name:"Plane",connectPath:"/integrations?provider=plane"},linear:{id:"linear",name:"Linear",connectPath:"/integrations?provider=linear"},figma:{id:"figma",name:"Figma",connectPath:"/integrations?provider=figma"},open_design:{id:"open_design",name:"OpenDesign",connectPath:"/integrations?provider=open_design"},linkedin_personal:{id:"linkedin_personal",name:"LinkedIn (Personal)",connectPath:"/integrations?provider=linkedin_personal"},linkedin_business:{id:"linkedin_business",name:"LinkedIn (Business)",connectPath:"/integrations?provider=linkedin_business"},discord:{id:"discord",name:"Discord",connectPath:"/integrations?provider=discord"}});function $(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let n=w(R(import.meta.url)),t=O(n,"..","bin","mcp-skill.mjs");return x(t)?t:null}var L="2022-06-28",P="https://api.notion.com/v1",g=2e4,b=25,v=25;function h(n){if(!n||typeof n!="string")return null;let o=n.trim().split(/[?#]/)[0],e=o.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/);if(e)return e[0].toLowerCase();let i=o.match(/[0-9a-fA-F]{32}/g);if(i&&i.length){let s=i[i.length-1].toLowerCase();return`${s.slice(0,8)}-${s.slice(8,12)}-${s.slice(12,16)}-${s.slice(16,20)}-${s.slice(20)}`}return null}async function m(n,t={}){let o=async()=>{let{token:e}=await S("notion");if(typeof e!="string"||!e)throw new Error(`Invalid notion token type: ${typeof e}`);let i=await fetch(`${P}${n}`,{method:t.method||"GET",headers:{Authorization:`Bearer ${e}`,"Notion-Version":L,Accept:"application/json",...t.body?{"Content-Type":"application/json"}:{},...t.headers},body:t.body?JSON.stringify(t.body):void 0});if(!i.ok){let a=await i.text().catch(()=>"");throw new Error(`Notion API ${i.status}: ${a.slice(0,300)}`)}let s=await i.text().catch(()=>"");if(!s||!s.trim())return{};try{return JSON.parse(s)}catch{return{raw:s}}};try{return await o()}catch(e){let i=String(e?.message||e||"").toLowerCase();if(!(i.includes("token")||i.includes("401")||i.includes("unauthorized")))throw e;return A("notion"),o()}}function u(n){if(!Array.isArray(n))return"";let t="";for(let o of n){let e=o?.plain_text??o?.text?.content??"";if(!e)continue;let i=o.annotations||{};i.code&&(e=`\`${e}\``),i.bold&&(e=`**${e}**`),i.italic&&(e=`_${e}_`),i.strikethrough&&(e=`~~${e}~~`);let s=o?.href||o?.text?.link?.url;s&&(e=`[${e}](${s})`),t+=e}return t}function T(n,t,o){let e=n?.type,i=n?.[e]||{},s="  ".repeat(Math.max(0,t)),a=(c="rich_text")=>u(i[c]),r;switch(e){case"paragraph":r=a();break;case"heading_1":r=`# ${a()}`;break;case"heading_2":r=`## ${a()}`;break;case"heading_3":r=`### ${a()}`;break;case"bulleted_list_item":r=`${s}- ${a()}`;break;case"numbered_list_item":r=`${s}1. ${a()}`;break;case"to_do":r=`${s}- [${i.checked?"x":" "}] ${a()}`;break;case"toggle":r=`${s}- ${a()}`;break;case"quote":r=`> ${a()}`;break;case"callout":{r=`> ${i.icon?.emoji?`${i.icon.emoji} `:""}${a()}`;break}case"code":{r=`\`\`\`${i.language||""}
+${a()}
+\`\`\``;break}case"divider":r="---";break;case"child_page":r=`[child page: ${i.title||""}]`;break;case"child_database":r=`[child database: ${i.title||""}]`;break;case"bookmark":case"embed":case"link_preview":r=i.url?`<${i.url}>`:"";break;case"equation":r=i.expression?`$${i.expression}$`:"";break;case"table":case"column_list":case"column":r="";break;case"table_row":{let c=(i.cells||[]).map(l=>u(l).trim());r=`${s}| ${c.join(" | ")} |`;break}default:r=a();break}let d=[];return r&&r.trim()&&d.push(r),o&&o.trim()&&d.push(o),d.join(`
+`)}async function N(n,t,o){let e=[],i,s=0;do{if(o.used>=g)break;let a=new URLSearchParams({page_size:"100"});i&&a.set("start_cursor",i);let r=await m(`/blocks/${n}/children?${a.toString()}`),d=Array.isArray(r.results)?r.results:[];for(let c of d){let l="";c.has_children&&(l=await N(c.id,t+1,o));let p=T(c,t,l);if(p&&(e.push(p),o.used+=p.length+1),o.used>=g)break}i=r.has_more?r.next_cursor:void 0,s+=1}while(i&&s<v);return e.join(`
+`)}function k(n){let t=n?.properties||{};for(let o of Object.values(t))if(o?.type==="title"){let e=u(o.title).trim();if(e)return e}return""}function y(n){let t=String(n??"");if(!t)return[{type:"text",text:{content:""}}];let o=[];for(let e=0;e<t.length;e+=2e3)o.push({type:"text",text:{content:t.slice(e,e+2e3)}});return o}function U(n){return{id:n?.id||"",discussionId:n?.discussion_id||"",text:u(n?.rich_text).trim(),author:n?.created_by?.id||"",createdTime:n?.created_time||""}}function E(n){if(!n||!n.type)return"";switch(n.type){case"title":return u(n.title).trim();case"rich_text":return u(n.rich_text).trim();case"number":return n.number==null?"":String(n.number);case"select":return n.select?.name||"";case"status":return n.status?.name||"";case"multi_select":return(n.multi_select||[]).map(o=>o.name).join(", ");case"checkbox":return n.checkbox?"true":"false";case"url":return n.url||"";case"email":return n.email||"";case"phone_number":return n.phone_number||"";case"date":return n.date?.start||"";case"people":return(n.people||[]).map(o=>o.name||o.id).join(", ");default:return""}}var B={id:"notion",serverName:"notion",allowedTools:["mcp__notion__*"],requiresIntegration:_.NOTION,description:"Notion read-only context (pull a page/database as markdown)",promptFragment:`## Notion (connected, read-only context)
 You can pull a referenced Notion page in as extra context. This is OPTIONAL \u2014 only use it when the task references a Notion page/URL (e.g. an engineering-standards or design doc to review against).
 - notion_get_page: pass a Notion page id OR a full Notion URL; returns { id, title, url, text } where text is the page flattened to markdown (truncated to ~20k chars). Use the text as reference context.
 - notion_query_database: pass a database id/URL; returns a small list of rows ({ id, title, url, props }). Use to find a specific page, then notion_get_page it.
-Do not block the task if Notion is unavailable \u2014 these tools return { ok:false, error } on failure; treat a missing page as "no extra context" and continue.`,resolve(){let t=x();return t?{type:"stdio",command:"node",args:[t,"../dist/notion.js","notionSkill"],env:{},description:this.description,alwaysLoad:!0}:null},async handleToolCall(t,a){try{switch(t){case"notion_get_page":{let i=a?.pageId||a?.page||a?.url||a?.id,e=_(i);if(!e)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let n=await h(`/pages/${e}`),r=k(n),s=n?.url||`https://www.notion.so/${e.replace(/-/g,"")}`,l=await y(e,0,{used:0}),c=!1;return l.length>g&&(l=l.slice(0,g),c=!0),JSON.stringify({ok:!0,id:e,title:r,url:s,text:l,...c?{truncated:!0}:{}})}case"notion_query_database":{let i=a?.databaseId||a?.database||a?.url||a?.id,e=_(i);if(!e)return JSON.stringify({ok:!1,error:"A valid Notion database id or URL is required"});let r={page_size:Math.max(1,Math.min(Number(a?.maxResults)||b,b))};a?.filter&&typeof a.filter=="object"&&(r.filter=a.filter);let s=await h(`/databases/${e}/query`,{method:"POST",body:r}),l=(Array.isArray(s.results)?s.results:[]).map(c=>{let d={};for(let[u,N]of Object.entries(c.properties||{})){let f=T(N);f&&(d[u]=f)}return{id:c.id,title:k(c),url:c.url||`https://www.notion.so/${String(c.id||"").replace(/-/g,"")}`,props:d}});return JSON.stringify({ok:!0,id:e,count:l.length,hasMore:!!s.has_more,rows:l})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${t}`})}}catch(i){return JSON.stringify({ok:!1,error:i.message})}},tools:[{name:"notion_get_page",description:"Fetch a Notion page and its content flattened to markdown, for use as read-only context. Accepts a raw page id OR a full Notion URL. Returns { ok, id, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."}},required:["pageId"]}},{name:"notion_query_database",description:"Query a Notion database and return a bounded list of rows (id, title, url, key props). Accepts a database id OR full Notion URL. Optional Notion filter object. Returns at most 25 rows.",input_schema:{type:"object",properties:{databaseId:{type:"string",description:"Notion database id (dashed UUID or 32-char) OR a full Notion database URL."},filter:{type:"object",description:"Optional Notion filter object (Notion query filter syntax).",additionalProperties:!0},maxResults:{type:"number",description:"Max rows to return (default 25, max 25)."}},required:["databaseId"]}}]};export{h as notionApi,D as notionSkill,_ as parseNotionId};
+- notion_list_comments: pass a page/block id OR URL; returns the open comment discussions on it ({ id, discussionId, text, author }). Use to read the comment thread you are replying to.
+- notion_add_comment: post a comment. To REPLY in an existing discussion pass { discussionId, text }; to start a NEW top-level comment on a page pass { pageId, text }. Returns { ok, id, discussionId }. Use this to answer a user who @mentioned Zibby in a Notion comment \u2014 reply in the SAME discussionId.
+Do not block the task if Notion is unavailable \u2014 these tools return { ok:false, error } on failure; treat a missing page as "no extra context" and continue.`,resolve(){let n=$();return n?{type:"stdio",command:"node",args:[n,"../dist/notion.js","notionSkill"],env:{},description:this.description,alwaysLoad:!0}:null},async handleToolCall(n,t){try{switch(n){case"notion_get_page":{let o=t?.pageId||t?.page||t?.url||t?.id,e=h(o);if(!e)return JSON.stringify({ok:!1,error:"A valid Notion page id or URL is required"});let i=await m(`/pages/${e}`),s=k(i),a=i?.url||`https://www.notion.so/${e.replace(/-/g,"")}`,d=await N(e,0,{used:0}),c=!1;return d.length>g&&(d=d.slice(0,g),c=!0),JSON.stringify({ok:!0,id:e,title:s,url:a,text:d,...c?{truncated:!0}:{}})}case"notion_query_database":{let o=t?.databaseId||t?.database||t?.url||t?.id,e=h(o);if(!e)return JSON.stringify({ok:!1,error:"A valid Notion database id or URL is required"});let s={page_size:Math.max(1,Math.min(Number(t?.maxResults)||b,b))};t?.filter&&typeof t.filter=="object"&&(s.filter=t.filter);let a=await m(`/databases/${e}/query`,{method:"POST",body:s}),d=(Array.isArray(a.results)?a.results:[]).map(c=>{let l={};for(let[p,I]of Object.entries(c.properties||{})){let f=E(I);f&&(l[p]=f)}return{id:c.id,title:k(c),url:c.url||`https://www.notion.so/${String(c.id||"").replace(/-/g,"")}`,props:l}});return JSON.stringify({ok:!0,id:e,count:d.length,hasMore:!!a.has_more,rows:d})}case"notion_list_comments":{let o=t?.blockId||t?.pageId||t?.block||t?.page||t?.url||t?.id,e=h(o);if(!e)return JSON.stringify({ok:!1,error:"A valid Notion page/block id or URL is required"});let i=new URLSearchParams({block_id:e,page_size:"100"}),s=await m(`/comments?${i.toString()}`),r=(Array.isArray(s.results)?s.results:[]).map(U);return JSON.stringify({ok:!0,id:e,count:r.length,comments:r})}case"notion_add_comment":{let o=typeof t?.text=="string"?t.text:typeof t?.body=="string"?t.body:"";if(!o||!o.trim())return JSON.stringify({ok:!1,error:"text is required"});let e=t?.discussionId||t?.discussion_id||null,i;if(e)i={discussion_id:String(e),rich_text:y(o)};else{let a=t?.pageId||t?.page||t?.url||t?.id,r=h(a);if(!r)return JSON.stringify({ok:!1,error:"Either discussionId (to reply) or a valid pageId (to start a comment) is required"});i={parent:{page_id:r},rich_text:y(o)}}let s=await m("/comments",{method:"POST",body:i});return JSON.stringify({ok:!0,id:s?.id||"",discussionId:s?.discussion_id||e||""})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${n}`})}}catch(o){return JSON.stringify({ok:!1,error:o.message})}},tools:[{name:"notion_get_page",description:"Fetch a Notion page and its content flattened to markdown, for use as read-only context. Accepts a raw page id OR a full Notion URL. Returns { ok, id, title, url, text }. Text is truncated to ~20k chars.",input_schema:{type:"object",properties:{pageId:{type:"string",description:"Notion page id (dashed UUID or 32-char) OR a full Notion page URL."}},required:["pageId"]}},{name:"notion_query_database",description:"Query a Notion database and return a bounded list of rows (id, title, url, key props). Accepts a database id OR full Notion URL. Optional Notion filter object. Returns at most 25 rows.",input_schema:{type:"object",properties:{databaseId:{type:"string",description:"Notion database id (dashed UUID or 32-char) OR a full Notion database URL."},filter:{type:"object",description:"Optional Notion filter object (Notion query filter syntax).",additionalProperties:!0},maxResults:{type:"number",description:"Max rows to return (default 25, max 25)."}},required:["databaseId"]}},{name:"notion_list_comments",description:"List the open comment discussions on a Notion page/block. Accepts a page/block id OR a full Notion URL. Returns { ok, comments:[{ id, discussionId, text, author }] }. Use to read the comment thread you are replying to.",input_schema:{type:"object",properties:{blockId:{type:"string",description:"Notion page or block id (dashed UUID or 32-char) OR a full Notion URL."}},required:["blockId"]}},{name:"notion_add_comment",description:"Post a comment on Notion. To REPLY within an existing discussion, pass { discussionId, text }. To start a NEW top-level comment on a page, pass { pageId, text }. Returns { ok, id, discussionId }. Use this to answer a user who @mentioned Zibby in a Notion comment (reply in the same discussionId).",input_schema:{type:"object",properties:{discussionId:{type:"string",description:"The discussion_id to reply into (from notion_list_comments). Preferred for replies."},pageId:{type:"string",description:"Page id/URL to start a NEW top-level comment on (used when discussionId is absent)."},text:{type:"string",description:"The comment body (plain text)."}},required:["text"]}}]};export{m as notionApi,B as notionSkill,h as parseNotionId};

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/skills",
-  "version": "0.1.68",
+  "version": "0.1.71",
   "description": "Built-in skill definitions for the Zibby agent-workflow framework",
   "type": "module",
   "main": "dist/index.js",
@@ -69,6 +69,10 @@
     "./sentry": {
       "types": "./dist/sentry.d.ts",
       "default": "./dist/sentry.js"
+    },
+    "./review": {
+      "types": "./dist/review.d.ts",
+      "default": "./dist/review.js"
     }
   },
   "scripts": {

package/dist/review.d.ts

@@ -0,0 +1,2 @@
+export { REVIEW_RECORD_SCHEMA_VERSION, REVIEW_RECORD_KIND, CONTENT_MAX_BYTES, FIELD_MAX_CHARS, SEVERITY_TIERS, FINDING_STATUSES, normalizeSeverity, buildReviewRecord, upsertReplyOutcome, serializeReviewRecord, parseReviewMemory, summarizeForPrompt } from "./reviewRecord.js";
+export { scopeForReviewMemory, storeReviewRecord, recallReviewRecord } from "./reviewMemoryIo.js";

package/dist/review.js

@@ -0,0 +1,4 @@
+var A=1,l="review-record",O=204800,T=2e3,I=["blocker","should-fix","nit"],_={blocker:0,"should-fix":1,nit:2},g=["open","conceded","held","resolved"];function v(e){let r=String(e??"").trim().toLowerCase();return r?r.includes("\u{1F534}")||r.includes("blocker")||r.includes("critical")||r.includes("high")?"blocker":r.includes("\u{1F7E2}")||r.includes("nit")||r.includes("minor")||r.includes("low")||r.includes("info")?"nit":(r.includes("\u{1F7E1}")||r.includes("should")||r.includes("medium")||r.includes("warn"),"should-fix"):"should-fix"}var c=(e,r)=>{let n=e==null?"":String(e);return n.length>r?n.slice(0,r):n},E=e=>typeof Buffer<"u"&&typeof Buffer.byteLength=="function"?Buffer.byteLength(e,"utf8"):new TextEncoder().encode(e).length;function k({headSha:e=null,verdict:r="COMMENT",objectivesChecked:n=!1,findings:i=[],nowIso:t=null}={}){let s=Array.isArray(i)?i:[];return{schemaVersion:1,kind:l,headSha:e||null,verdict:String(r||"COMMENT"),objectivesChecked:!!n,reviewedAt:t||null,findings:s.map((o,u)=>({id:`f${u+1}`,file:c(o?.file,512),line:o?.line==null?null:o.line,severity:v(o?.severity),category:c(o?.category,64),claim:c(o?.claim,2e3),evidence:c(o?.evidence,2e3),suggestion:c(o?.suggestion,2e3),confidence:typeof o?.confidence=="number"?o.confidence:null,status:"open"}))}}function C(e,{findingId:r,status:n,note:i}={}){if(!e||!Array.isArray(e.findings))return e;let t=g.includes(n)?n:"held";return{...e,findings:e.findings.map(s=>s.id===r?{...s,status:t,replyNote:c(i,2e3)}:s)}}function a(e){if(!e)return"";let r=[...e.findings||[]].sort((s,o)=>{let u=(_[s.severity]??9)-(_[o.severity]??9);if(u!==0)return u;let y=s.file||"",p=o.file||"";if(y!==p)return y<p?-1:1;let m=Number(s.line)||0,R=Number(o.line)||0;return m!==R?m-R:(s.id||"")<(o.id||"")?-1:1}),n={...e,findings:r},i=JSON.stringify(n);if(E(i)<=204800)return i;let t=[...r];for(n={...e,findings:t,truncated:!0};t.length>0&&E(JSON.stringify(n))>204800;)t.pop(),n={...e,findings:t,truncated:!0};return JSON.stringify(n)}var S=e=>e&&typeof e=="object"&&!Array.isArray(e)&&e.kind===l;function d(e){if(e==null)return{kind:"empty"};if(typeof e=="object"){if(!Array.isArray(e)&&typeof e.error=="string")return{kind:"empty"};if(S(e)){let i=Number(e.schemaVersion)>1;return{kind:"record",record:e,future:i}}return{kind:"legacy",legacyNote:h(e)}}if(typeof e!="string")return{kind:"empty"};let r=e.trim();if(!r)return{kind:"empty"};let n;try{n=JSON.parse(r)}catch{return{kind:"legacy",legacyNote:r}}if(n&&typeof n=="object"&&typeof n.error=="string")return{kind:"empty"};if(S(n)){let i=Number(n.schemaVersion)>1;return{kind:"record",record:n,future:i}}return{kind:"legacy",legacyNote:r}}function h(e){try{return JSON.stringify(e)}catch{return String(e)}}function w(e){if(!e||e.kind==="empty")return"";if(e.kind==="legacy")return`Prior review memory (legacy note, advisory only):
+${e.legacyNote}`;let r=e.record||{};if(e.future)return`Prior review memory (newer format ${r.schemaVersion} \u2014 advisory; verify against the live thread):
+${h(r).slice(0,2e3)}`;let n=[`Prior review of this change (verdict: ${r.verdict||"COMMENT"}${r.headSha?`, commit ${r.headSha}`:""}):`],i=(r.findings||[]).map(t=>{let s=t.file?`${t.file}${t.line!=null?`:${t.line}`:""}`:"(general)",o=t.status&&t.status!=="open"?` [${t.status}]`:"";return`- [${t.severity}] ${s} \u2014 ${t.claim||""}${o}`});return r.truncated&&i.push("- (\u2026older/lower-severity findings were truncated to fit memory)"),[...n,...i].join(`
+`)}import{existsSync as M,readFileSync as x}from"node:fs";import{homedir as $}from"node:os";import{join as b}from"node:path";function B(){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=b($(),".zibby","config.json");return M(e)&&JSON.parse(x(e,"utf-8")).sessionToken||null}catch{return null}}function V(){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 D(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function f(e){return`${D()}:${e}`}async function N(e,r){let n=B();if(!n)return{__noToken:!0};let i=`${V()}/credits/review-memory`,t=await fetch(i,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify({op:e,...r})});if(!t.ok){let s=await t.text().catch(()=>"");throw new Error(`review-memory ${e} failed (${t.status}): ${s.slice(0,300)}`)}return t.json()}async function F(e,r){try{let n=a(r);if(!n)return{ok:!1,reason:"empty-record"};let i=await N("store",{scope:f(e),content:n});return i&&i.__noToken?{ok:!1,reason:"no-token"}:{ok:!0}}catch(n){return{ok:!1,reason:n?.message||"store-error"}}}async function L(e){try{let r=await N("recall",{scope:f(e)});if(!r||r.__noToken)return{kind:"empty"};let n=r.found&&r.memory?r.memory:null;if(!n)return{kind:"empty"};let i=n.content!=null?n.content:n.metadata!=null?n.metadata:null;return d(i)}catch{return{kind:"empty"}}}export{O as CONTENT_MAX_BYTES,T as FIELD_MAX_CHARS,g as FINDING_STATUSES,l as REVIEW_RECORD_KIND,A as REVIEW_RECORD_SCHEMA_VERSION,I as SEVERITY_TIERS,k as buildReviewRecord,v as normalizeSeverity,d as parseReviewMemory,L as recallReviewRecord,f as scopeForReviewMemory,a as serializeReviewRecord,F as storeReviewRecord,w as summarizeForPrompt,C as upsertReplyOutcome};

package/dist/reviewMemoryIo.d.ts

@@ -0,0 +1,43 @@
+/** Effective backend scope for a plain per-PR/MR key. IDENTICAL to kvMemory scopeFor. */
+export function scopeForReviewMemory(key: any): string;
+/**
+ * Store a review record under a plain per-PR/MR key. Serializes via
+ * serializeReviewRecord (deterministic, byte-capped 200KB) and POSTs
+ * { op:'store', scope, content }.
+ *
+ * BEST-EFFORT: never throws. { ok:true } on success; { ok:false, reason:'no-token' }
+ * with no backend credential (local dev / self-host); { ok:false, reason } otherwise.
+ * The caller must treat a false result as a no-op — memory NEVER blocks a run.
+ */
+export function storeReviewRecord(key: any, record: any): Promise<{
+    ok: boolean;
+    reason?: undefined;
+} | {
+    ok: boolean;
+    reason: any;
+}>;
+/**
+ * Recall the review record stored under a plain per-PR/MR key. POSTs
+ * { op:'recall', scope } and hands the returned `content` to the tolerant
+ * parseReviewMemory (which never throws over any input).
+ *
+ * BEST-EFFORT: never throws. Returns parseReviewMemory's result
+ * ({ kind:'empty' | 'record' | 'legacy', ... }); { kind:'empty' } on missing
+ * token or ANY failure, so the caller degrades to "no prior memory".
+ */
+export function recallReviewRecord(key: any): Promise<{
+    kind: string;
+    record?: undefined;
+    future?: undefined;
+    legacyNote?: undefined;
+} | {
+    kind: string;
+    record: any;
+    future: boolean;
+    legacyNote?: undefined;
+} | {
+    kind: string;
+    legacyNote: string;
+    record?: undefined;
+    future?: undefined;
+}>;

package/dist/reviewMemoryIo.js

@@ -0,0 +1 @@
+import{existsSync as S,readFileSync as v}from"node:fs";import{homedir as N}from"node:os";import{join as A}from"node:path";var R="review-record";var d={blocker:0,"should-fix":1,nit:2};var y=e=>typeof Buffer<"u"&&typeof Buffer.byteLength=="function"?Buffer.byteLength(e,"utf8"):new TextEncoder().encode(e).length;function m(e){if(!e)return"";let t=[...e.findings||[]].sort((o,s)=>{let c=(d[o.severity]??9)-(d[s.severity]??9);if(c!==0)return c;let u=o.file||"",l=s.file||"";if(u!==l)return u<l?-1:1;let a=Number(o.line)||0,f=Number(s.line)||0;return a!==f?a-f:(o.id||"")<(s.id||"")?-1:1}),n={...e,findings:t},r=JSON.stringify(n);if(y(r)<=204800)return r;let i=[...t];for(n={...e,findings:i,truncated:!0};i.length>0&&y(JSON.stringify(n))>204800;)i.pop(),n={...e,findings:i,truncated:!0};return JSON.stringify(n)}var p=e=>e&&typeof e=="object"&&!Array.isArray(e)&&e.kind===R;function _(e){if(e==null)return{kind:"empty"};if(typeof e=="object"){if(!Array.isArray(e)&&typeof e.error=="string")return{kind:"empty"};if(p(e)){let r=Number(e.schemaVersion)>1;return{kind:"record",record:e,future:r}}return{kind:"legacy",legacyNote:h(e)}}if(typeof e!="string")return{kind:"empty"};let t=e.trim();if(!t)return{kind:"empty"};let n;try{n=JSON.parse(t)}catch{return{kind:"legacy",legacyNote:t}}if(n&&typeof n=="object"&&typeof n.error=="string")return{kind:"empty"};if(p(n)){let r=Number(n.schemaVersion)>1;return{kind:"record",record:n,future:r}}return{kind:"legacy",legacyNote:t}}function h(e){try{return JSON.stringify(e)}catch{return String(e)}}function O(){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=A(N(),".zibby","config.json");return S(e)&&JSON.parse(v(e,"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 T(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function E(e){return`${T()}:${e}`}async function g(e,t){let n=O();if(!n)return{__noToken:!0};let r=`${k()}/credits/review-memory`,i=await fetch(r,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify({op:e,...t})});if(!i.ok){let o=await i.text().catch(()=>"");throw new Error(`review-memory ${e} failed (${i.status}): ${o.slice(0,300)}`)}return i.json()}async function $(e,t){try{let n=m(t);if(!n)return{ok:!1,reason:"empty-record"};let r=await g("store",{scope:E(e),content:n});return r&&r.__noToken?{ok:!1,reason:"no-token"}:{ok:!0}}catch(n){return{ok:!1,reason:n?.message||"store-error"}}}async function b(e){try{let t=await g("recall",{scope:E(e)});if(!t||t.__noToken)return{kind:"empty"};let n=t.found&&t.memory?t.memory:null;if(!n)return{kind:"empty"};let r=n.content!=null?n.content:n.metadata!=null?n.metadata:null;return _(r)}catch{return{kind:"empty"}}}export{b as recallReviewRecord,E as scopeForReviewMemory,$ as storeReviewRecord};

package/dist/reviewRecord.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Normalize the review's free-form / emoji severity into a stable tier.
+ * The real review schema defaults severity to '🟡'; reviews also emit 🔴/🟢 and
+ * words. Anything unrecognized falls back to 'should-fix' (never throws).
+ */
+export function normalizeSeverity(raw: any): "should-fix" | "blocker" | "nit";
+/**
+ * Build a fresh review record from the review node's (post-verification)
+ * findings. `findings` is the REAL review shape:
+ *   { file, line?, severity, category, claim, evidence, suggestion?, confidence? }
+ * Assigns stable ids (f1..fN), normalizes severity, caps long text, status:'open'.
+ * `nowIso` is injected (callers pass new Date().toISOString()) so this stays pure.
+ */
+export function buildReviewRecord({ headSha, verdict, objectivesChecked, findings, nowIso, }?: {
+    headSha?: any;
+    verdict?: string;
+    objectivesChecked?: boolean;
+    findings?: any[];
+    nowIso?: any;
+}): {
+    schemaVersion: number;
+    kind: string;
+    headSha: any;
+    verdict: string;
+    objectivesChecked: boolean;
+    reviewedAt: any;
+    findings: {
+        id: string;
+        file: string;
+        line: any;
+        severity: string;
+        category: string;
+        claim: string;
+        evidence: string;
+        suggestion: string;
+        confidence: any;
+        status: string;
+    }[];
+};
+/**
+ * Record the OUTCOME of a comment_reply against a finding. IDEMPOTENT: it SETS
+ * findings[id].status (and an optional one-line note) — running the same reply
+ * twice (webhook redelivery) yields the identical record, no double-append.
+ * Returns a NEW record (does not mutate the input). If findingId is unknown, the
+ * record is returned unchanged (best-effort, never throws).
+ */
+export function upsertReplyOutcome(record: any, { findingId, status, note }?: {}): any;
+/**
+ * Serialize a record to a string that FITS CONTENT_MAX_BYTES. Deterministic:
+ * findings are stably sorted by (severityRank, file, line, id); if still over
+ * budget, the LOWEST-priority findings are dropped until it fits and
+ * `truncated:true` is set. Text fields are already capped by buildReviewRecord.
+ */
+export function serializeReviewRecord(record: any): string;
+/**
+ * Tolerant reader — NEVER throws. Accepts whatever kv_recall returns for the
+ * value (a JSON string, an already-parsed metadata object, a legacy prose
+ * string, an {error} envelope, null/'').
+ * Returns one of:
+ *   { kind:'empty' }                         — nothing usable
+ *   { kind:'record',  record, future?:bool } — a structured record (future=newer schemaVersion)
+ *   { kind:'legacy',  legacyNote:string }    — an old freeform note; advisory only
+ */
+export function parseReviewMemory(raw: any): {
+    kind: string;
+    record?: undefined;
+    future?: undefined;
+    legacyNote?: undefined;
+} | {
+    kind: string;
+    record: any;
+    future: boolean;
+    legacyNote?: undefined;
+} | {
+    kind: string;
+    legacyNote: string;
+    record?: undefined;
+    future?: undefined;
+};
+/**
+ * Render a parsed memory into prompt text for the review/reply LLM. Compact,
+ * human-readable, and it NEVER assumes a shape it didn't verify (a future
+ * schemaVersion is surfaced as advisory). Empty → '' (caller omits the block).
+ */
+export function summarizeForPrompt(parsed: any): string;
+/**
+ * reviewRecord — a GENERIC, provider-agnostic structured record for the
+ * code-review → comment_reply memory (shared by gitlab-code-review and
+ * github-code-review). Replaces the freeform prose kv note with a versioned,
+ * queryable record.
+ *
+ * DELIBERATELY TRANSPORT-AGNOSTIC. This module does NO I/O: it only builds,
+ * serializes, parses and renders the record. WHO stores/recalls it (the JS node
+ * vs the LLM via kv_store/kv_recall) is a separate wiring decision — these pure
+ * functions are correct either way. The per-PR/MR KEY stays provider-specific
+ * (reviewMemoryScopeFor in each review-node.js); the record BODY here carries
+ * zero provider fields (identity lives in the key, not the body).
+ *
+ * Contract facts this module mirrors (source of truth = backend
+ * src/handlers/review-memory.js + packages/skills/src/kvMemory.js):
+ *   - kv `content` is a STRING, hard-capped at 200KB (CONTENT_MAX). We serialize
+ *     to a string and truncate deterministically to fit — an over-cap store is
+ *     rejected (HTTP 400) and SILENTLY lost, so truncation must happen here,
+ *     before the write.
+ *   - kv also has an optional `metadata` OBJECT channel; parseReviewMemory
+ *     therefore accepts an already-parsed object too, so the record can ride in
+ *     either channel without changing this code.
+ *
+ * Reviewed by two adversarial design agents (2026-07-04): schema aligned to the
+ * REAL finding shape ({file,line,severity,category,claim,evidence,suggestion,
+ * confidence}); replies modeled as an IDEMPOTENT findingId→status set (NOT an
+ * append log, which double-appends on webhook redelivery); headSha carried but
+ * treated as advisory (its plumbing is deferred — today it is undefined).
+ */
+export const REVIEW_RECORD_SCHEMA_VERSION: 1;
+export const REVIEW_RECORD_KIND: "review-record";
+export const CONTENT_MAX_BYTES: number;
+export const FIELD_MAX_CHARS: 2000;
+export const SEVERITY_TIERS: string[];
+export const FINDING_STATUSES: string[];

package/dist/reviewRecord.js

@@ -0,0 +1,4 @@
+var h=1,m="review-record",_=204800,N=2e3,A=["blocker","should-fix","nit"],a={blocker:0,"should-fix":1,nit:2},S=["open","conceded","held","resolved"];function R(e){let n=String(e??"").trim().toLowerCase();return n?n.includes("\u{1F534}")||n.includes("blocker")||n.includes("critical")||n.includes("high")?"blocker":n.includes("\u{1F7E2}")||n.includes("nit")||n.includes("minor")||n.includes("low")||n.includes("info")?"nit":(n.includes("\u{1F7E1}")||n.includes("should")||n.includes("medium")||n.includes("warn"),"should-fix"):"should-fix"}var u=(e,n)=>{let t=e==null?"":String(e);return t.length>n?t.slice(0,n):t},g=e=>typeof Buffer<"u"&&typeof Buffer.byteLength=="function"?Buffer.byteLength(e,"utf8"):new TextEncoder().encode(e).length;function v({headSha:e=null,verdict:n="COMMENT",objectivesChecked:t=!1,findings:o=[],nowIso:i=null}={}){let s=Array.isArray(o)?o:[];return{schemaVersion:1,kind:m,headSha:e||null,verdict:String(n||"COMMENT"),objectivesChecked:!!t,reviewedAt:i||null,findings:s.map((r,c)=>({id:`f${c+1}`,file:u(r?.file,512),line:r?.line==null?null:r.line,severity:R(r?.severity),category:u(r?.category,64),claim:u(r?.claim,2e3),evidence:u(r?.evidence,2e3),suggestion:u(r?.suggestion,2e3),confidence:typeof r?.confidence=="number"?r.confidence:null,status:"open"}))}}function k(e,{findingId:n,status:t,note:o}={}){if(!e||!Array.isArray(e.findings))return e;let i=S.includes(t)?t:"held";return{...e,findings:e.findings.map(s=>s.id===n?{...s,status:i,replyNote:u(o,2e3)}:s)}}function C(e){if(!e)return"";let n=[...e.findings||[]].sort((s,r)=>{let c=(a[s.severity]??9)-(a[r.severity]??9);if(c!==0)return c;let l=s.file||"",d=r.file||"";if(l!==d)return l<d?-1:1;let f=Number(s.line)||0,y=Number(r.line)||0;return f!==y?f-y:(s.id||"")<(r.id||"")?-1:1}),t={...e,findings:n},o=JSON.stringify(t);if(g(o)<=204800)return o;let i=[...n];for(t={...e,findings:i,truncated:!0};i.length>0&&g(JSON.stringify(t))>204800;)i.pop(),t={...e,findings:i,truncated:!0};return JSON.stringify(t)}var E=e=>e&&typeof e=="object"&&!Array.isArray(e)&&e.kind===m;function I(e){if(e==null)return{kind:"empty"};if(typeof e=="object"){if(!Array.isArray(e)&&typeof e.error=="string")return{kind:"empty"};if(E(e)){let o=Number(e.schemaVersion)>1;return{kind:"record",record:e,future:o}}return{kind:"legacy",legacyNote:p(e)}}if(typeof e!="string")return{kind:"empty"};let n=e.trim();if(!n)return{kind:"empty"};let t;try{t=JSON.parse(n)}catch{return{kind:"legacy",legacyNote:n}}if(t&&typeof t=="object"&&typeof t.error=="string")return{kind:"empty"};if(E(t)){let o=Number(t.schemaVersion)>1;return{kind:"record",record:t,future:o}}return{kind:"legacy",legacyNote:n}}function p(e){try{return JSON.stringify(e)}catch{return String(e)}}function O(e){if(!e||e.kind==="empty")return"";if(e.kind==="legacy")return`Prior review memory (legacy note, advisory only):
+${e.legacyNote}`;let n=e.record||{};if(e.future)return`Prior review memory (newer format ${n.schemaVersion} \u2014 advisory; verify against the live thread):
+${p(n).slice(0,2e3)}`;let t=[`Prior review of this change (verdict: ${n.verdict||"COMMENT"}${n.headSha?`, commit ${n.headSha}`:""}):`],o=(n.findings||[]).map(i=>{let s=i.file?`${i.file}${i.line!=null?`:${i.line}`:""}`:"(general)",r=i.status&&i.status!=="open"?` [${i.status}]`:"";return`- [${i.severity}] ${s} \u2014 ${i.claim||""}${r}`});return n.truncated&&o.push("- (\u2026older/lower-severity findings were truncated to fit memory)"),[...t,...o].join(`
+`)}export{_ as CONTENT_MAX_BYTES,N as FIELD_MAX_CHARS,S as FINDING_STATUSES,m as REVIEW_RECORD_KIND,h as REVIEW_RECORD_SCHEMA_VERSION,A as SEVERITY_TIERS,v as buildReviewRecord,R as normalizeSeverity,I as parseReviewMemory,C as serializeReviewRecord,O as summarizeForPrompt,k as upsertReplyOutcome};