@zibby/skills 0.1.73 → 0.1.75

package/dist/linkedin.d.ts

@@ -74,6 +74,24 @@ export function linkedinApi(path: any, opts?: {}, provider?: string): Promise<{
     headers: Headers;
     body: {};
 }>;
+/**
+ * Upload a LOCAL image file to LinkedIn's Images API and return its
+ * `urn:li:image:...` URN, ready to attach to a post via
+ * requestBody.content.media = { id: <urn>, altText }.
+ *
+ * Uses the SAME provider/token/gate as the post (resolveProviderToken):
+ *   1. initializeUpload — POST /rest/images?action=initializeUpload with
+ *      { initializeUploadRequest: { owner: <author urn> } } (through linkedinApi,
+ *      so it carries the versioned-API headers + the personal-tier gate). Reads
+ *      value.uploadUrl + value.image from the response.
+ *   2. single-request upload — PUT the raw file bytes to uploadUrl with
+ *      Authorization: Bearer <same provider token> + the image Content-Type.
+ *   3. return value.image (the image URN).
+ *
+ * Throws on any non-2xx / missing field — handleToolCall catches it and returns
+ * { ok:false, error } so a bad image can't crash the run or cause a post.
+ */
+export function uploadImage(provider: any, ownerUrn: any, imagePath: any, mimeType: any): Promise<any>;
 export const PERSONAL_REFUSAL: "You haven't connected your own LinkedIn account \u2014 connect it at https://studio.zibby.dev/integrations (LinkedIn). For privacy, I can't post or act as anyone else's LinkedIn (including the project owner's) on your behalf.";
 export namespace linkedinSkill {
     let id: string;
@@ -108,6 +126,8 @@ export namespace linkedinSkill {
                 organizationUrn?: undefined;
                 text?: undefined;
                 visibility?: undefined;
+                imagePath?: undefined;
+                imageAltText?: undefined;
                 dry_run?: undefined;
             };
             required?: undefined;
@@ -135,6 +155,14 @@ export namespace linkedinSkill {
                     enum: string[];
                     description: string;
                 };
+                imagePath: {
+                    type: string;
+                    description: string;
+                };
+                imageAltText: {
+                    type: string;
+                    description: string;
+                };
                 dry_run: {
                     type: string;
                     description: string;
@@ -157,6 +185,14 @@ export namespace linkedinSkill {
                     enum: string[];
                     description: string;
                 };
+                imagePath: {
+                    type: string;
+                    description: string;
+                };
+                imageAltText: {
+                    type: string;
+                    description: string;
+                };
                 dry_run: {
                     type: string;
                     description: string;

package/dist/linkedin.js

@@ -1,4 +1,4 @@
-import{existsSync as b}from"fs";import{fileURLToPath as _}from"url";import{dirname as k,resolve as L}from"path";import{resolveIntegrationToken as m,clearTokenCache as S}from"@zibby/core/backend-client.js";function N(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let t=k(_(import.meta.url)),e=L(t,"..","bin","mcp-skill.mjs");return b(e)?e:null}function w(){let t=String(process.env.ZIBBY_INJECTED_LINKEDIN_TOKEN||"").trim();if(!t)return null;let e=String(process.env.ZIBBY_INJECTED_LINKEDIN_MEMBER_ID||"").trim();return{token:t,memberId:e}}function T(){return String(process.env.ZIBBY_CHAT_STRICT_PERSONAL||"").trim()==="1"}function E(){return String(process.env.ZIBBY_SENDER_IS_NON_OWNER||"").trim()==="1"}var v="You haven't connected your own LinkedIn account \u2014 connect it at https://studio.zibby.dev/integrations (LinkedIn). For privacy, I can't post or act as anyone else's LinkedIn (including the project owner's) on your behalf.";function g(){let t=w();if(t)return t;if(T()||E())throw new Error(v);return null}var A="202506",R="https://api.linkedin.com";function f(t){if(t==null)return null;let e=String(t).trim();if(!e)return null;let i=e.match(/urn:li:organization:(\d+)/i);return i?i[1]:/^\d+$/.test(e)?e:null}function I(t){if(!t)return"";if(t.localizedName)return String(t.localizedName);let e=t.name&&t.name.localized;if(e&&typeof e=="object"){let i=Object.values(e)[0];if(i)return String(i)}return""}function p(t,e){return t?typeof t.get=="function"?t.get(e):t[e]||t[e.toLowerCase()]||null:null}async function u(t,e={},i="linkedin_business"){let d=async()=>{let n;if(i==="linkedin_personal"){let c=g();c&&(n=c.token)}if(n||({token:n}=await m(i)),typeof n!="string"||!n)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");let o=t.startsWith("https://")?t:`${R}${t}`,r=await fetch(o,{method:e.method||"GET",headers:{Authorization:`Bearer ${n}`,"LinkedIn-Version":A,"X-Restli-Protocol-Version":"2.0.0",Accept:"application/json",...e.body?{"Content-Type":"application/json"}:{},...e.headers},body:e.body?JSON.stringify(e.body):void 0});if(!r.ok){let c=await r.text().catch(()=>"");throw new Error(`LinkedIn API ${r.status}: ${c.slice(0,300)}`)}let l=await r.text().catch(()=>""),s={};if(l&&l.trim())try{s=JSON.parse(l)}catch{s={raw:l}}return{status:r.status,headers:r.headers,body:s}};try{return await d()}catch(n){let o=String(n?.message||n||"").toLowerCase();if(!(o.includes("token")||o.includes("401")||o.includes("unauthorized")))throw n;return S(i),d()}}var U={id:"linkedin",serverName:"linkedin",allowedTools:["mcp__linkedin__*"],envKeys:[],description:"LinkedIn \u2014 (business) list admin Organizations + create DRAFT posts on a company Page, and (personal) PUBLISH a post to your own member profile feed",promptFragment:`## LinkedIn (connected)
+import{existsSync as L,readFileSync as w}from"fs";import{fileURLToPath as A}from"url";import{dirname as T,resolve as P}from"path";import{resolveIntegrationToken as y,clearTokenCache as N}from"@zibby/core/backend-client.js";function S(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let t=T(A(import.meta.url)),e=P(t,"..","bin","mcp-skill.mjs");return L(e)?e:null}function E(){let t=String(process.env.ZIBBY_INJECTED_LINKEDIN_TOKEN||"").trim();if(!t)return null;let e=String(process.env.ZIBBY_INJECTED_LINKEDIN_MEMBER_ID||"").trim();return{token:t,memberId:e}}function v(){return String(process.env.ZIBBY_CHAT_STRICT_PERSONAL||"").trim()==="1"}function O(){return String(process.env.ZIBBY_SENDER_IS_NON_OWNER||"").trim()==="1"}var R="You haven't connected your own LinkedIn account \u2014 connect it at https://studio.zibby.dev/integrations (LinkedIn). For privacy, I can't post or act as anyone else's LinkedIn (including the project owner's) on your behalf.";function f(){let t=E();if(t)return t;if(v()||O())throw new Error(R);return null}var x="202506",D="https://api.linkedin.com";function b(t){if(t==null)return null;let e=String(t).trim();if(!e)return null;let n=e.match(/urn:li:organization:(\d+)/i);return n?n[1]:/^\d+$/.test(e)?e:null}function _(t){if(!t)return"";if(t.localizedName)return String(t.localizedName);let e=t.name&&t.name.localized;if(e&&typeof e=="object"){let n=Object.values(e)[0];if(n)return String(n)}return""}function h(t,e){return t?typeof t.get=="function"?t.get(e):t[e]||t[e.toLowerCase()]||null:null}async function p(t,e={},n="linkedin_business"){let l=async()=>{let i;if(n==="linkedin_personal"){let s=f();s&&(i=s.token)}if(i||({token:i}=await y(n)),typeof i!="string"||!i)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");let a=t.startsWith("https://")?t:`${D}${t}`,o=await fetch(a,{method:e.method||"GET",headers:{Authorization:`Bearer ${i}`,"LinkedIn-Version":x,"X-Restli-Protocol-Version":"2.0.0",Accept:"application/json",...e.body?{"Content-Type":"application/json"}:{},...e.headers},body:e.body?JSON.stringify(e.body):void 0});if(!o.ok){let s=await o.text().catch(()=>"");throw new Error(`LinkedIn API ${o.status}: ${s.slice(0,300)}`)}let r=await o.text().catch(()=>""),u={};if(r&&r.trim())try{u=JSON.parse(r)}catch{u={raw:r}}return{status:o.status,headers:o.headers,body:u}};try{return await l()}catch(i){let a=String(i?.message||i||"").toLowerCase();if(!(a.includes("token")||a.includes("401")||a.includes("unauthorized")))throw i;return N(n),l()}}async function U(t){let e;if(t==="linkedin_personal"){let n=f();n&&(e=n.token)}if(e||({token:e}=await y(t)),typeof e!="string"||!e)throw new Error("LinkedIn is not connected: no access token available. Connect LinkedIn in Integrations.");return e}function B(t){switch(String(t||"").toLowerCase().match(/\.([a-z0-9]+)$/)?.[1]){case"jpg":case"jpeg":return"image/jpeg";case"gif":return"image/gif";case"webp":return"image/webp";default:return"image/png"}}async function k(t,e,n,l){if(typeof n!="string"||!n.trim())throw new Error("imagePath (a local image file path) is required to upload an image");let{body:i}=await p("/rest/images?action=initializeUpload",{method:"POST",body:{initializeUploadRequest:{owner:e}}},t),a=i?.value?.uploadUrl,o=i?.value?.image;if(!a||!o)throw new Error(`LinkedIn image initializeUpload returned no uploadUrl/image (got: ${JSON.stringify(i).slice(0,200)})`);let r=w(n),u=await U(t),s=await fetch(a,{method:"PUT",headers:{Authorization:`Bearer ${u}`,"Content-Type":l||B(n)},body:r});if(!s.ok){let c=await s.text().catch(()=>"");throw new Error(`LinkedIn image upload ${s.status}: ${c.slice(0,300)}`)}return o}var j={id:"linkedin",serverName:"linkedin",allowedTools:["mcp__linkedin__*"],envKeys:[],description:"LinkedIn \u2014 (business) list admin Organizations + create DRAFT posts on a company Page, and (personal) PUBLISH a post to your own member profile feed",promptFragment:`## LinkedIn (connected)
 You can post to LinkedIn two ways \u2014 an ORG company Page (business) and your own member PROFILE (personal). Each path needs its own LinkedIn integration connected.
 
 Business (company Page) \u2014 DRAFT only:
@@ -8,7 +8,10 @@ Business (company Page) \u2014 DRAFT only:
 Personal (your own profile) \u2014 PUBLISHES IMMEDIATELY:
 - linkedin_publish_post: PUBLISH a post to your OWN member profile feed. Pass text (the post body) + optional visibility ('PUBLIC' default, or 'CONNECTIONS'). UNLIKE the org draft tool, this PUBLISHES the post immediately \u2014 LinkedIn has no DRAFT state for member profiles, so there is no human review step. Returns { postUrn }. Set dry_run:true to VALIDATE which member profile the post would publish to (and preview the text) WITHOUT publishing \u2014 nothing is posted; returns { dryRun, target, wouldPostAs, textPreview }. Use this to confirm the identity before an approved publish. (needs LinkedIn Personal connected)
 
+Attaching an image (optional, both tools):
+- Both linkedin_create_draft_post and linkedin_publish_post accept imagePath (a LOCAL image file path, e.g. a PNG returned by social_card_render) + optional imageAltText. When imagePath is set, the image is uploaded to LinkedIn's Images API (same connected account/token as the post) and attached to the post as its media. On a dry_run nothing is uploaded \u2014 the result just reports imageWouldAttach:true.
+
 Notes:
 - Org-page posts are ALWAYS created as a DRAFT; personal-profile posts are ALWAYS published live \u2014 choose the tool accordingly.
 - PUBLISHING IS OUTWARD-FACING AND IRREVERSIBLE. linkedin_publish_post posts live to a real audience the instant you call it \u2014 there is no undo and no draft state for member profiles. Only call it after the human has EXPLICITLY approved publishing THIS specific text in THIS conversation. If you wrote or edited the text, show it and get an explicit "yes, publish" first; if you are unsure, HOLD/draft rather than publish. The org draft tool (linkedin_create_draft_post) is the safe default when a human still needs to review.
-- If the relevant LinkedIn integration is not connected these tools return { ok:false, error }; treat that as "LinkedIn unavailable" and continue.`,resolve(){let t=N();if(!t)return{command:null,args:[],env:{},description:this.description};let e={};for(let i of["ZIBBY_INJECTED_LINKEDIN_TOKEN","ZIBBY_INJECTED_LINKEDIN_MEMBER_ID","ZIBBY_SENDER_IS_NON_OWNER","ZIBBY_CHAT_STRICT_PERSONAL"])process.env[i]&&(e[i]=process.env[i]);return{type:"stdio",command:"node",args:[t,"../dist/linkedin.js","linkedinSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(t,e){try{switch(t){case"linkedin_list_organizations":{let{body:i}=await u("/rest/organizationAcls?q=roleAssignee&role=ADMINISTRATOR&state=APPROVED",{},"linkedin_business"),d=Array.isArray(i.elements)?i.elements:[],n=[];for(let o of d){let r=o.organizationalTarget||o["organizationalTarget~"]||o.organization,l=f(r);if(!l)continue;let s="",c="";try{let a=(await u(`/rest/organizations/${l}`,{},"linkedin_business")).body;s=I(a),c=a.vanityName||""}catch{}n.push({id:l,urn:`urn:li:organization:${l}`,name:s,vanityName:c})}return JSON.stringify({ok:!0,count:n.length,organizations:n})}case"linkedin_create_draft_post":{let i=e?.organizationUrn||e?.organizationId||e?.organization||e?.orgId,d=f(i);if(!d)return JSON.stringify({ok:!1,error:"A valid organizationId or organizationUrn (urn:li:organization:{id}) is required"});let n=e?.text;if(typeof n!="string"||!n.trim())return JSON.stringify({ok:!1,error:"text (the post commentary) is required"});let o=e?.visibility?String(e.visibility).toUpperCase():"PUBLIC",r=`urn:li:organization:${d}`;if(e?.dry_run===!0)try{let a="";try{let h=(await u(`/rest/organizations/${d}`,{},"linkedin_business")).body;a=I(h)}catch{}return JSON.stringify({dryRun:!0,target:"organization",wouldPostAs:{name:a,id:d,urn:r},visibility:o,textPreview:n,note:"DRY RUN \u2014 nothing was posted"})}catch(a){return JSON.stringify({dryRun:!0,ok:!1,error:a.message})}let s=await u("/rest/posts",{method:"POST",body:{author:r,commentary:n,visibility:o,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"DRAFT",isReshareDisabledByAuthor:!1}},"linkedin_business"),c=p(s.headers,"x-restli-id")||p(s.headers,"x-linkedin-id")||s.body?.id||null;return JSON.stringify({ok:!0,postUrn:c,author:r,lifecycleState:"DRAFT",visibility:o,status:s.status})}case"linkedin_publish_post":{let i=g(),d=i?i.memberId:(await m("linkedin_personal")).memberId;if(!d)return JSON.stringify({ok:!1,error:"LinkedIn (personal) not connected or member id unavailable \u2014 reconnect LinkedIn Personal"});let n=e?.text;if(typeof n!="string"||!n.trim())return JSON.stringify({ok:!1,error:"text (the post body) is required"});let o=e?.visibility?String(e.visibility).toUpperCase():"PUBLIC",r=`urn:li:person:${d}`;if(e?.dry_run===!0)try{let a=(await u("/v2/userinfo",{},"linkedin_personal")).body,h=a?.name||[a?.given_name,a?.family_name].filter(Boolean).join(" ")||"",y=a?.sub?String(a.sub):d;return JSON.stringify({dryRun:!0,target:"member",wouldPostAs:{name:h,id:y,urn:`urn:li:person:${y}`},visibility:o,textPreview:n,note:"DRY RUN \u2014 nothing was posted"})}catch(a){return JSON.stringify({dryRun:!0,ok:!1,error:a.message})}let s=await u("/rest/posts",{method:"POST",body:{author:r,commentary:n,visibility:o,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"PUBLISHED",isReshareDisabledByAuthor:!1}},"linkedin_personal"),c=p(s.headers,"x-restli-id")||p(s.headers,"x-linkedin-id")||s.body?.id||null;return JSON.stringify({ok:!0,postUrn:c,author:r,lifecycleState:"PUBLISHED",visibility:o,status:s.status})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${t}`})}}catch(i){return JSON.stringify({ok:!1,error:i.message})}},tools:[{name:"linkedin_list_organizations",description:"List the LinkedIn Organizations (company Pages) the authenticated member ADMINISTERS. Returns [{ id, urn, name, vanityName }]. Call this first to choose the author org for a draft post.",input_schema:{type:"object",properties:{}}},{name:"linkedin_create_draft_post",description:"Create a DRAFT post on a LinkedIn Organization (company Page). The post is created in DRAFT state (never published automatically) so a human can review and publish it in LinkedIn. Returns the created post URN. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published.",input_schema:{type:"object",properties:{organizationId:{type:"string",description:'The numeric organization id (e.g. "12345"). Alternative to organizationUrn.'},organizationUrn:{type:"string",description:'The organization URN, e.g. "urn:li:organization:12345". Alternative to organizationId.'},text:{type:"string",description:"The post commentary (the body text of the post)."},visibility:{type:"string",enum:["PUBLIC"],description:"Post visibility. Defaults to PUBLIC."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published. Returns { dryRun, target, wouldPostAs, visibility, textPreview }. Defaults to false."}},required:["text"]}},{name:"linkedin_publish_post",description:"PUBLISH a post to the authenticated member's OWN LinkedIn profile feed (personal). UNLIKE linkedin_create_draft_post (which only drafts on a company Page), this PUBLISHES the post IMMEDIATELY \u2014 LinkedIn has no DRAFT state for member profiles, so there is no human review step. Returns the created post URN. Requires the LinkedIn Personal integration connected. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published.",input_schema:{type:"object",properties:{text:{type:"string",description:"The post body (the commentary text of the post)."},visibility:{type:"string",enum:["PUBLIC","CONNECTIONS"],description:"Post visibility: PUBLIC (anyone) or CONNECTIONS (your connections only). Defaults to PUBLIC."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published. Returns { dryRun, target, wouldPostAs, visibility, textPreview }. Defaults to false."}},required:["text"]}}]};export{v as PERSONAL_REFUSAL,T as chatStrictPersonal,w as injectedPersonalToken,u as linkedinApi,U as linkedinSkill,f as parseOrgId,g as personalTierCredentialGate,E as senderIsNonOwner};
+- If the relevant LinkedIn integration is not connected these tools return { ok:false, error }; treat that as "LinkedIn unavailable" and continue.`,resolve(){let t=S();if(!t)return{command:null,args:[],env:{},description:this.description};let e={};for(let n of["ZIBBY_INJECTED_LINKEDIN_TOKEN","ZIBBY_INJECTED_LINKEDIN_MEMBER_ID","ZIBBY_SENDER_IS_NON_OWNER","ZIBBY_CHAT_STRICT_PERSONAL"])process.env[n]&&(e[n]=process.env[n]);return{type:"stdio",command:"node",args:[t,"../dist/linkedin.js","linkedinSkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(t,e){try{switch(t){case"linkedin_list_organizations":{let{body:n}=await p("/rest/organizationAcls?q=roleAssignee&role=ADMINISTRATOR&state=APPROVED",{},"linkedin_business"),l=Array.isArray(n.elements)?n.elements:[],i=[];for(let a of l){let o=a.organizationalTarget||a["organizationalTarget~"]||a.organization,r=b(o);if(!r)continue;let u="",s="";try{let c=(await p(`/rest/organizations/${r}`,{},"linkedin_business")).body;u=_(c),s=c.vanityName||""}catch{}i.push({id:r,urn:`urn:li:organization:${r}`,name:u,vanityName:s})}return JSON.stringify({ok:!0,count:i.length,organizations:i})}case"linkedin_create_draft_post":{let n=e?.organizationUrn||e?.organizationId||e?.organization||e?.orgId,l=b(n);if(!l)return JSON.stringify({ok:!1,error:"A valid organizationId or organizationUrn (urn:li:organization:{id}) is required"});let i=e?.text;if(typeof i!="string"||!i.trim())return JSON.stringify({ok:!1,error:"text (the post commentary) is required"});let a=e?.visibility?String(e.visibility).toUpperCase():"PUBLIC",o=`urn:li:organization:${l}`,r=typeof e?.imagePath=="string"?e.imagePath.trim():"",u=typeof e?.imageAltText=="string"?e.imageAltText:"";if(e?.dry_run===!0)try{let d="";try{let g=(await p(`/rest/organizations/${l}`,{},"linkedin_business")).body;d=_(g)}catch{}return JSON.stringify({dryRun:!0,target:"organization",wouldPostAs:{name:d,id:l,urn:o},visibility:a,textPreview:i,...r?{imageWouldAttach:!0,imagePath:r}:{},note:"DRY RUN \u2014 nothing was posted"})}catch(d){return JSON.stringify({dryRun:!0,ok:!1,error:d.message})}let s={author:o,commentary:i,visibility:a,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"DRAFT",isReshareDisabledByAuthor:!1};if(r){let d=await k("linkedin_business",o,r);s.content={media:{id:d,altText:u||""}}}let c=await p("/rest/posts",{method:"POST",body:s},"linkedin_business"),m=h(c.headers,"x-restli-id")||h(c.headers,"x-linkedin-id")||c.body?.id||null;return JSON.stringify({ok:!0,postUrn:m,author:o,lifecycleState:"DRAFT",visibility:a,status:c.status})}case"linkedin_publish_post":{let n=f(),l=n?n.memberId:(await y("linkedin_personal")).memberId;if(!l)return JSON.stringify({ok:!1,error:"LinkedIn (personal) not connected or member id unavailable \u2014 reconnect LinkedIn Personal"});let i=e?.text;if(typeof i!="string"||!i.trim())return JSON.stringify({ok:!1,error:"text (the post body) is required"});let a=e?.visibility?String(e.visibility).toUpperCase():"PUBLIC",o=`urn:li:person:${l}`,r=typeof e?.imagePath=="string"?e.imagePath.trim():"",u=typeof e?.imageAltText=="string"?e.imageAltText:"";if(e?.dry_run===!0)try{let d=(await p("/v2/userinfo",{},"linkedin_personal")).body,g=d?.name||[d?.given_name,d?.family_name].filter(Boolean).join(" ")||"",I=d?.sub?String(d.sub):l;return JSON.stringify({dryRun:!0,target:"member",wouldPostAs:{name:g,id:I,urn:`urn:li:person:${I}`},visibility:a,textPreview:i,...r?{imageWouldAttach:!0,imagePath:r}:{},note:"DRY RUN \u2014 nothing was posted"})}catch(d){return JSON.stringify({dryRun:!0,ok:!1,error:d.message})}let s={author:o,commentary:i,visibility:a,distribution:{feedDistribution:"MAIN_FEED",targetEntities:[],thirdPartyDistributionChannels:[]},lifecycleState:"PUBLISHED",isReshareDisabledByAuthor:!1};if(r){let d=await k("linkedin_personal",o,r);s.content={media:{id:d,altText:u||""}}}let c=await p("/rest/posts",{method:"POST",body:s},"linkedin_personal"),m=h(c.headers,"x-restli-id")||h(c.headers,"x-linkedin-id")||c.body?.id||null;return JSON.stringify({ok:!0,postUrn:m,author:o,lifecycleState:"PUBLISHED",visibility:a,status:c.status})}default:return JSON.stringify({ok:!1,error:`Unknown tool: ${t}`})}}catch(n){return JSON.stringify({ok:!1,error:n.message})}},tools:[{name:"linkedin_list_organizations",description:"List the LinkedIn Organizations (company Pages) the authenticated member ADMINISTERS. Returns [{ id, urn, name, vanityName }]. Call this first to choose the author org for a draft post.",input_schema:{type:"object",properties:{}}},{name:"linkedin_create_draft_post",description:"Create a DRAFT post on a LinkedIn Organization (company Page). The post is created in DRAFT state (never published automatically) so a human can review and publish it in LinkedIn. Returns the created post URN. Optionally ATTACH an image: pass imagePath (a local PNG file path, e.g. one returned by social_card_render) and it is uploaded to LinkedIn and attached to the post. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded (a set imagePath is reported as imageWouldAttach:true).",input_schema:{type:"object",properties:{organizationId:{type:"string",description:'The numeric organization id (e.g. "12345"). Alternative to organizationUrn.'},organizationUrn:{type:"string",description:'The organization URN, e.g. "urn:li:organization:12345". Alternative to organizationId.'},text:{type:"string",description:"The post commentary (the body text of the post)."},visibility:{type:"string",enum:["PUBLIC"],description:"Post visibility. Defaults to PUBLIC."},imagePath:{type:"string",description:"Optional. A LOCAL image file path (e.g. a PNG returned by social_card_render). When set, the image is uploaded to LinkedIn and attached to the post as its media. Not uploaded on a dry_run."},imageAltText:{type:"string",description:"Optional alt text for the attached image (accessibility). Only used when imagePath is set."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded. Returns { dryRun, target, wouldPostAs, visibility, textPreview, imageWouldAttach? }. Defaults to false."}},required:["text"]}},{name:"linkedin_publish_post",description:"PUBLISH a post to the authenticated member's OWN LinkedIn profile feed (personal). UNLIKE linkedin_create_draft_post (which only drafts on a company Page), this PUBLISHES the post IMMEDIATELY \u2014 LinkedIn has no DRAFT state for member profiles, so there is no human review step. Returns the created post URN. Requires the LinkedIn Personal integration connected. Optionally ATTACH an image: pass imagePath (a local PNG file path, e.g. one returned by social_card_render) and it is uploaded to LinkedIn and attached to the post. Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded (a set imagePath is reported as imageWouldAttach:true).",input_schema:{type:"object",properties:{text:{type:"string",description:"The post body (the commentary text of the post)."},visibility:{type:"string",enum:["PUBLIC","CONNECTIONS"],description:"Post visibility: PUBLIC (anyone) or CONNECTIONS (your connections only). Defaults to PUBLIC."},imagePath:{type:"string",description:"Optional. A LOCAL image file path (e.g. a PNG returned by social_card_render). When set, the image is uploaded to LinkedIn and attached to the post as its media. Not uploaded on a dry_run."},imageAltText:{type:"string",description:"Optional alt text for the attached image (accessibility). Only used when imagePath is set."},dry_run:{type:"boolean",description:"Set dry_run:true to VALIDATE which LinkedIn account/profile the post would go to (and preview the text) WITHOUT posting \u2014 nothing is published or uploaded. Returns { dryRun, target, wouldPostAs, visibility, textPreview, imageWouldAttach? }. Defaults to false."}},required:["text"]}}]};export{R as PERSONAL_REFUSAL,v as chatStrictPersonal,E as injectedPersonalToken,p as linkedinApi,j as linkedinSkill,b as parseOrgId,f as personalTierCredentialGate,O as senderIsNonOwner,k as uploadImage};

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/skills",
-  "version": "0.1.73",
+  "version": "0.1.74",
   "description": "Built-in skill definitions for the Zibby agent-workflow framework",
   "type": "module",
   "main": "dist/index.js",
@@ -121,12 +121,17 @@
     "zod": "^3.23.0 || ^4.0.0"
   },
   "peerDependencies": {
-    "@zibby/core": ">=0.1.44"
+    "@zibby/core": ">=0.1.44",
+    "better-sqlite3": "^12.6.2"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
   },
   "optionalDependencies": {
     "@zibby/mcp-browser": "^0.1.8",
-    "@zibby/mcp-memory": "*",
-    "better-sqlite3": "^12.6.2"
+    "@zibby/mcp-memory": "*"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/dist/report.d.ts

@@ -170,13 +170,13 @@ export const reportObjectSchema: z.ZodObject<{
             severity: z.ZodOptional<z.ZodEnum<["ok", "info", "warn", "critical"]>>;
         }, "strip", z.ZodTypeAny, {
             sub?: string;
-            label?: string;
             value?: string;
+            label?: string;
             severity?: "ok" | "info" | "warn" | "critical";
         }, {
             sub?: string;
-            label?: string;
             value?: string;
+            label?: string;
             severity?: "ok" | "info" | "warn" | "critical";
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
@@ -184,8 +184,8 @@ export const reportObjectSchema: z.ZodObject<{
         kind?: "breakdown";
         rows?: {
             sub?: string;
-            label?: string;
             value?: string;
+            label?: string;
             severity?: "ok" | "info" | "warn" | "critical";
         }[];
     }, {
@@ -193,8 +193,8 @@ export const reportObjectSchema: z.ZodObject<{
         kind?: "breakdown";
         rows?: {
             sub?: string;
-            label?: string;
             value?: string;
+            label?: string;
             severity?: "ok" | "info" | "warn" | "critical";
         }[];
     }>, z.ZodObject<{
@@ -231,8 +231,8 @@ export const reportObjectSchema: z.ZodObject<{
         kind?: "breakdown";
         rows?: {
             sub?: string;
-            label?: string;
             value?: string;
+            label?: string;
             severity?: "ok" | "info" | "warn" | "critical";
         }[];
     } | {
@@ -261,8 +261,8 @@ export const reportObjectSchema: z.ZodObject<{
         kind?: "breakdown";
         rows?: {
             sub?: string;
-            label?: string;
             value?: string;
+            label?: string;
             severity?: "ok" | "info" | "warn" | "critical";
         }[];
     } | {
@@ -282,7 +282,6 @@ export const reportObjectSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     title?: string;
-    subtitle?: string;
     headline?: {
         summary?: string;
         primary?: string;
@@ -292,6 +291,7 @@ export const reportObjectSchema: z.ZodObject<{
             severity?: "ok" | "info" | "warn" | "critical";
         };
     };
+    subtitle?: string;
     sections?: ({
         title?: string;
         values?: number[];
@@ -314,8 +314,8 @@ export const reportObjectSchema: z.ZodObject<{
         kind?: "breakdown";
         rows?: {
             sub?: string;
-            label?: string;
             value?: string;
+            label?: string;
             severity?: "ok" | "info" | "warn" | "critical";
         }[];
     } | {
@@ -329,7 +329,6 @@ export const reportObjectSchema: z.ZodObject<{
     };
 }, {
     title?: string;
-    subtitle?: string;
     headline?: {
         summary?: string;
         primary?: string;
@@ -339,6 +338,7 @@ export const reportObjectSchema: z.ZodObject<{
             severity?: "ok" | "info" | "warn" | "critical";
         };
     };
+    subtitle?: string;
     sections?: ({
         title?: string;
         values?: number[];
@@ -361,8 +361,8 @@ export const reportObjectSchema: z.ZodObject<{
         kind?: "breakdown";
         rows?: {
             sub?: string;
-            label?: string;
             value?: string;
+            label?: string;
             severity?: "ok" | "info" | "warn" | "critical";
         }[];
     } | {

package/dist/socialCard.d.ts

@@ -0,0 +1,89 @@
+export namespace socialCardSkill {
+    let id: string;
+    let serverName: string;
+    let allowedTools: string[];
+    let description: string;
+    let promptFragment: string;
+    function resolve({ sessionPath, nodeName }?: {}): {
+        command: any;
+        args: any[];
+        env: {};
+        description: string;
+        type?: undefined;
+        alwaysLoad?: undefined;
+    } | {
+        type: string;
+        command: string;
+        args: any[];
+        env: {
+            ZIBBY_NODE_SESSION_PATH: any;
+            ZIBBY_SESSION_PATH: any;
+        };
+        description: string;
+        alwaysLoad: boolean;
+    };
+    function handleToolCall(name: any, args: any): Promise<string>;
+    let tools: {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                headline: {
+                    type: string;
+                    description: string;
+                };
+                eyebrow: {
+                    type: string;
+                    description: string;
+                };
+                subhead: {
+                    type: string;
+                    description: string;
+                };
+                stat: {
+                    type: string;
+                    description: string;
+                };
+                footer: {
+                    type: string;
+                    description: string;
+                };
+                diagram: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                theme: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                accent: {
+                    type: string;
+                    description: string;
+                };
+                width: {
+                    type: string;
+                    description: string;
+                };
+                height: {
+                    type: string;
+                    description: string;
+                };
+                filename: {
+                    type: string;
+                    description: string;
+                };
+                output: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    }[];
+}

package/dist/socialCard.js

@@ -0,0 +1,19 @@
+import{createRequire as ne}from"node:module";import{existsSync as G,mkdirSync as oe,writeFileSync as z}from"node:fs";import{dirname as Z,join as F,resolve as q}from"node:path";import{fileURLToPath as J}from"node:url";var re=ne(import.meta.url),C=null;function ie(){return C||(C=re("@resvg/resvg-js")),C}var K=1200,ae=627,se=4096,ce=320,le="#3b82f6",k="Noto Sans",de=3;function he(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let e=Z(J(import.meta.url)),t=q(e,"..","bin","mcp-skill.mjs");return G(t)?t:null}function fe(){let e=Z(J(import.meta.url)),t=q(e,"..","assets","fonts");return["NotoSans-Regular.ttf","NotoSans-Bold.ttf"].map(n=>F(t,n)).filter(n=>G(n))}function ue(){let e=process.env.ZIBBY_NODE_SESSION_PATH,t=process.env.ZIBBY_SESSION_PATH,n=e||(t?F(t,"social-card"):F(process.cwd(),".zibby","output","social-cards"));return oe(n,{recursive:!0}),n}function U(e,t){let n=Number(e);return Number.isFinite(n)?Math.max(ce,Math.min(se,Math.round(n))):t}function _(e){return String(e??"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}function pe(e){return typeof e!="string"?null:e.trim().replace(/\.(png|svg)$/i,"").replace(/[^a-zA-Z0-9._-]+/g,"-").replace(/^[.-]+|[.-]+$/g,"")||null}function ge(e,t){if(typeof e!="string")return t;let n=e.trim();return/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(n)?n:t}function X(e,t,n){return String(e).length*t*n}function E(e,t,n,h){let a=String(e).trim().split(/\s+/).filter(Boolean),o=[],r="";for(let i of a){let f=r?`${r} ${i}`:i;r&&X(f,n,h)>t?(o.push(r),r=i):r=f}return r&&o.push(r),o.length?o:[""]}function me(e){return e==="light"?{bg:"#ffffff",fg:"#0b0f14",muted:"#5b6673",pillText:"#0b0f14",checkFg:"#ffffff",divider:"#e2e6ea"}:{bg:"#0b0f14",fg:"#e9edf1",muted:"#8b98a5",pillText:"#e9edf1",checkFg:"#0b0f14",divider:"#22303c"}}function j(e,t,n,h,a){let o=(Array.isArray(e)?e:[]).map(l=>String(l??"").trim()).filter(Boolean).slice(0,de);if(o.length<2)return null;let r=24,i=54,f=26,m=90,y=17,b=o.map(l=>Math.max(96,X(l,r,.58)+f*2)),$=b.reduce((l,p)=>l+p,0)+m*(o.length-1),s=t-$/2,c=n+i/2,x=[];for(let l=0;l<o.length;l++){let p=b[l];if(x.push(`<rect x="${s.toFixed(1)}" y="${n}" width="${p.toFixed(1)}" height="${i}" rx="${i/2}" fill="${a}" fill-opacity="0.12" stroke="${a}" stroke-opacity="0.55" stroke-width="1.5"/>`,`<text x="${(s+p/2).toFixed(1)}" y="${(c+r*.35).toFixed(1)}" text-anchor="middle" font-family="${k}" font-size="${r}" font-weight="700" fill="${h.pillText}">${_(o[l])}</text>`),s+=p,l<o.length-1){let A=s,S=s+m,N=(A+S)/2;x.push(`<line x1="${A.toFixed(1)}" y1="${c}" x2="${S.toFixed(1)}" y2="${c}" stroke="${a}" stroke-opacity="0.55" stroke-width="2"/>`,`<circle cx="${N.toFixed(1)}" cy="${c}" r="${y}" fill="${a}"/>`,`<path d="M ${(N-8).toFixed(1)} ${c.toFixed(1)} l 5 5 l 9 -11" fill="none" stroke="${h.checkFg}" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>`),s=S}}return{svg:x.join(`
+`),height:i}}function ye(e){let{width:t,height:n,theme:h,accent:a}=e,o=me(h),r=t/2,i=Math.round(t*.07),f=t-i*2,m=String(e.headline).trim(),y=e.eyebrow?String(e.eyebrow).trim().toUpperCase():"",b=e.subhead?String(e.subhead).trim():"",$=e.stat?String(e.stat).trim():"",s=e.footer?String(e.footer).trim():"",c=t/K,x=Math.round(22*c),l=Math.round(29*c),p=b?E(b,f,l,.52):[],A=Math.round(l*1.28),S=4,N=Math.round(26*c),T=Math.round(20*c),B=Math.round(24*c),D=Math.round(30*c),P=!!($||s),R=i,Q=P?Math.round(110*c):i,H=n-R-Q,M=j(e.diagram,r,0,o,a),W=(d,w)=>{let O=S+N;return y&&(O+=x+T),O+=w.length*Math.round(d*1.16),p.length&&(O+=B+p.length*A),M&&(O+=D+M.height),O},I=[76,66,58,50,44,38].map(d=>Math.round(d*c)),V=4,v=I[I.length-1],L=E(m,f,v,.6);for(let d of I){let w=E(m,f,d,.6);if(w.length<=V&&W(d,w)<=H){v=d,L=w;break}}let ee=Math.round(v*1.16),te=W(v,L),u=R+Math.max(0,(H-te)/2),g=[];g.push(`<rect x="0" y="0" width="${t}" height="${n}" fill="${o.bg}"/>`);let Y=Math.round(60*c);g.push(`<rect x="${(r-Y/2).toFixed(1)}" y="${u}" width="${Y}" height="${S}" rx="2" fill="${a}"/>`),u+=S+N,y&&(g.push(`<text x="${r}" y="${(u+x*.82).toFixed(1)}" text-anchor="middle" font-family="${k}" font-size="${x}" font-weight="700" letter-spacing="3" fill="${a}">${_(y)}</text>`),u+=x+T);for(let d of L)g.push(`<text x="${r}" y="${(u+v*.82).toFixed(1)}" text-anchor="middle" font-family="${k}" font-size="${v}" font-weight="700" fill="${o.fg}">${_(d)}</text>`),u+=ee;if(p.length){u+=B;for(let d of p)g.push(`<text x="${r}" y="${(u+l*.82).toFixed(1)}" text-anchor="middle" font-family="${k}" font-size="${l}" font-weight="400" fill="${o.muted}">${_(d)}</text>`),u+=A}if(M){u+=D;let d=j(e.diagram,r,u,o,a);d&&g.push(d.svg)}if(P){let d=Math.round(24*c),w=n-Math.round(46*c);s&&g.push(`<text x="${i}" y="${w}" text-anchor="start" font-family="${k}" font-size="${d}" font-weight="400" fill="${o.muted}">${_(s)}</text>`),$&&g.push(`<text x="${t-i}" y="${w}" text-anchor="end" font-family="${k}" font-size="${d}" font-weight="700" fill="${a}">${_($)}</text>`)}return`<svg xmlns="http://www.w3.org/2000/svg" width="${t}" height="${n}" viewBox="0 0 ${t} ${n}">
+${g.join(`
+`)}
+</svg>`}function be(e){let{Resvg:t}=ie();return new t(e,{font:{fontFiles:fe(),loadSystemFonts:!0,defaultFontFamily:k}}).render().asPng()}var ke={id:"social-card",serverName:"social_card",allowedTools:["mcp__social_card__*"],description:'Social card \u2014 render a branded LinkedIn "concept card" PNG locally (bold headline + eyebrow + optional stat/footer/diagram); nothing leaves the box',promptFragment:`## Social Card (branded concept card, local)
+You can render a BRANDED concept card PNG with the social_card_render tool \u2014 the
+clean, high-signal LinkedIn "concept card" style (bold headline + small uppercase
+eyebrow + optional stat/footer + optional A\u2014\u2713\u2014B diagram). Give it STRUCTURED
+fields that capture the ONE key idea of your post:
+- headline (required): the big, bold line \u2014 the single takeaway.
+- eyebrow: a short uppercase kicker (e.g. "MY WORKFLOW", "OPEN SOURCE").
+- subhead: one supporting line under the headline.
+- stat / footer: e.g. stat "11.8k stars", footer "Apache 2.0".
+- diagram: 2-3 short labels rendered as a chain, e.g. ["Claude Code","Codex"].
+- theme ('dark' default | 'light'), accent (hex).
+It renders server-side to a PNG in the run's output folder and returns
+{ ok:true, files:[{ path, format:'png', bytes }] }. Pass the returned \`path\` as
+\`imagePath\` when you draft/publish a LinkedIn post to ATTACH the card as the
+post image. No browser, no external service \u2014 the data never leaves the machine.`,resolve({sessionPath:e,nodeName:t}={}){let n=he();if(!n)return{command:null,args:[],env:{},description:this.description};let h={},a=e&&t?F(e,t):null;a&&(h.ZIBBY_NODE_SESSION_PATH=a),e&&(h.ZIBBY_SESSION_PATH=e);for(let o of["ZIBBY_NODE_SESSION_PATH","ZIBBY_SESSION_PATH"])!h[o]&&process.env[o]&&(h[o]=process.env[o]);return{type:"stdio",command:"node",args:[n,"../dist/socialCard.js","socialCardSkill"],env:h,description:this.description,alwaysLoad:!0}},async handleToolCall(e,t){if(e!=="social_card_render")return JSON.stringify({error:`Unknown tool: ${e}`});try{let n=t?.headline;if(typeof n!="string"||!n.trim())return JSON.stringify({error:"headline (the big bold line) is required and must be a non-empty string."});let h=U(t?.width,K),a=U(t?.height,ae),o=t?.theme==="light"?"light":"dark",r=ge(t?.accent,le),i;try{i=ye({width:h,height:a,theme:o,accent:r,headline:n,eyebrow:t?.eyebrow,subhead:t?.subhead,stat:t?.stat,footer:t?.footer,diagram:t?.diagram})}catch(s){return JSON.stringify({error:`Card layout failed: ${s.message}`})}let f;try{f=be(i)}catch(s){return JSON.stringify({error:`PNG rasterization failed: ${s.message}`})}let m=ue(),y=pe(t?.filename)||`social-card-${Date.now()}`,b=F(m,`${y}.png`);z(b,f);let $=[{path:b,format:"png",bytes:f.length}];if(t?.output==="both"||t?.output==="svg"){let s=F(m,`${y}.svg`);z(s,i,"utf-8"),$.push({path:s,format:"svg",bytes:Buffer.byteLength(i,"utf-8")})}return JSON.stringify({ok:!0,width:h,height:a,theme:o,files:$})}catch(n){return JSON.stringify({error:`social_card_render failed: ${n.message}`})}},tools:[{name:"social_card_render",description:'Render a BRANDED "concept card" PNG LOCALLY (no external service) from structured fields \u2014 the clean LinkedIn concept-card style: bold headline + small uppercase eyebrow + optional supporting subhead, stat, footer, and an A\u2014\u2713\u2014B diagram. Returns { ok:true, files:[{ path, format:"png", bytes }] }. Pass the returned `path` as `imagePath` to a LinkedIn post tool to attach it as the post image. Example: { "headline":"No more copy-paste between AI tools", "eyebrow":"MY WORKFLOW", "stat":"11.8k stars", "footer":"Apache 2.0", "diagram":["Claude Code","Codex"] }.',input_schema:{type:"object",properties:{headline:{type:"string",description:"REQUIRED. The big, bold line \u2014 the single key idea/takeaway. Word-wrapped + auto-sized."},eyebrow:{type:"string",description:'Small uppercase kicker above the headline (e.g. "MY WORKFLOW", "OPEN SOURCE"). Rendered uppercased in the accent color.'},subhead:{type:"string",description:"One supporting line under the headline (muted)."},stat:{type:"string",description:'Optional stat, shown bottom-right in the accent color (e.g. "11.8k stars", "3x faster").'},footer:{type:"string",description:'Optional footer, shown bottom-left (muted) (e.g. "Apache 2.0", a repo name).'},diagram:{type:"array",items:{type:"string"},description:'Optional 2-3 short labels rendered as a chain of pills joined by a checkmark (A \u2014\u2713\u2014 B), e.g. ["Claude Code","Codex"].'},theme:{type:"string",enum:["dark","light"],description:"Card theme (default 'dark' \u2014 near-black bg, off-white text)."},accent:{type:"string",description:'Accent hex color (e.g. "#f97316"). Defaults to a tasteful blue (#3b82f6).'},width:{type:"number",description:"Image width in px (default 1200 \u2014 LinkedIn 1.91:1 link image)."},height:{type:"number",description:"Image height in px (default 627)."},filename:{type:"string",description:"Optional file basename (no extension); defaults to social-card-<timestamp>."},output:{type:"string",enum:["png","both"],description:"Which file(s) to write (default 'png'; 'both' also writes the .svg)."}},required:["headline"]}}]};export{ke as socialCardSkill};

package/docs/packages/agent-workflow.md

@@ -21,7 +21,7 @@ npm install @zibby/agent-workflow
 |---|---|
 | `WorkflowGraph` | The graph builder. `addNode`, `addEdge`, `addConditionalEdges`, `setEntryPoint`, `run`. |
 | `WorkflowAgent` | Base class your `graph.mjs` exports — has `buildGraph()`. |
-| `Node`, `ConditionalNode` | Internal node classes (rarely used directly). |
+| `Node` | Internal node class (rarely used directly). |
 | `WorkflowState` | History-tracked state passed between nodes. |
 | `AgentStrategy` | Base class for custom agent strategies. |
 | `registerStrategy`, `listStrategies`, `getAgentStrategy`, `invokeAgent` | Strategy registry. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/skills",
-  "version": "0.1.73",
+  "version": "0.1.75",
   "description": "Built-in skill definitions for the Zibby agent-workflow framework",
   "type": "module",
   "main": "dist/index.js",
@@ -121,12 +121,17 @@
     "zod": "^3.23.0 || ^4.0.0"
   },
   "peerDependencies": {
-    "@zibby/core": ">=0.1.44"
+    "@zibby/core": ">=0.1.44",
+    "better-sqlite3": "^12.6.2"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
   },
   "optionalDependencies": {
     "@zibby/mcp-browser": "^0.1.8",
-    "@zibby/mcp-memory": "*",
-    "better-sqlite3": "^12.6.2"
+    "@zibby/mcp-memory": "*"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",