@zibby/skills 0.1.41 → 0.1.43

package/dist/{reviewMemory.d.ts → kvMemory.d.ts}

@@ -1,4 +1,4 @@
-export namespace reviewMemorySkill {
+export namespace kvMemorySkill {
     let id: string;
     let serverName: string;
     let allowedTools: string[];
@@ -26,18 +26,13 @@ export namespace reviewMemorySkill {
         input_schema: {
             type: string;
             properties: {
-                scope: {
+                key: {
                     type: string;
                     description: string;
                 };
-                query: {
-                    type: string;
-                    description: string;
-                };
-                scopePrefix?: undefined;
+                keyPrefix?: undefined;
                 content?: undefined;
                 metadata?: undefined;
-                headSha?: undefined;
             };
             required: string[];
         };
@@ -47,15 +42,13 @@ export namespace reviewMemorySkill {
         input_schema: {
             type: string;
             properties: {
-                scopePrefix: {
+                keyPrefix: {
                     type: string;
                     description: string;
                 };
-                scope?: undefined;
-                query?: undefined;
+                key?: undefined;
                 content?: undefined;
                 metadata?: undefined;
-                headSha?: undefined;
             };
             required: string[];
         };
@@ -65,7 +58,7 @@ export namespace reviewMemorySkill {
         input_schema: {
             type: string;
             properties: {
-                scope: {
+                key: {
                     type: string;
                     description: string;
                 };
@@ -77,12 +70,7 @@ export namespace reviewMemorySkill {
                     type: string;
                     description: string;
                 };
-                headSha: {
-                    type: string;
-                    description: string;
-                };
-                query?: undefined;
-                scopePrefix?: undefined;
+                keyPrefix?: undefined;
             };
             required: string[];
         };

package/dist/kvMemory.js

@@ -0,0 +1,16 @@
+import{existsSync as a,readFileSync as p}from"node:fs";import{homedir as l}from"node:os";import{join as y,dirname as u,resolve as d}from"node:path";import{fileURLToPath as m}from"node:url";function f(){if(process.env.MCP_SKILL_PATH)return process.env.MCP_SKILL_PATH;let r=u(m(import.meta.url)),e=d(r,"..","bin","mcp-skill.mjs");return a(e)?e:null}function k(){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 r=y(l(),".zibby","config.json");return a(r)&&JSON.parse(p(r,"utf-8")).sessionToken||null}catch{return null}}function _(){return process.env.ZIBBY_ACCOUNT_API_URL?process.env.ZIBBY_ACCOUNT_API_URL.replace(/\/$/,""):(process.env.ZIBBY_ENV||"prod")==="local"?"http://localhost:3001":process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://api-prod.zibby.app"}function v(){return(typeof process.env.WORKFLOW_TYPE=="string"?process.env.WORKFLOW_TYPE.trim():"")||"agent"}function s(r){return`${v()}:${r}`}async function i(r,e){let t=k();if(!t)throw new Error("No backend credential (PROJECT_API_TOKEN). KV memory is only available inside a Zibby run.");let n=`${_()}/credits/review-memory`,o=await fetch(n,{method:"POST",headers:{Authorization:`Bearer ${t}`,"Content-Type":"application/json"},body:JSON.stringify({op:r,...e})});if(!o.ok){let c=await o.text().catch(()=>"");throw new Error(`KV memory ${r} failed (${o.status}): ${c.slice(0,300)}`)}return o.json()}var T={id:"kv-memory",serverName:"kv_memory",allowedTools:["mcp__kv_memory__*"],description:"KV memory \u2014 a private, per-agent persistent key\u2192value store across stateless runs (auto-namespaced)",promptFragment:`## KV Memory (private, per-agent, persistent key-value store)
+You have a PRIVATE per-agent key-value memory that survives across your
+stateless runs. It is automatically namespaced to YOU (this agent type) \u2014 other
+agents cannot see or collide with your entries, and you don't need to prefix
+anything. Just use plain keys.
+
+Tools:
+- kv_recall: Recall the value stored under a plain \`key\` (exact match).
+  Use at the START of a run to pick up what a prior run of yours recorded.
+- kv_recall_prefix: List entries whose plain \`keyPrefix\` matches
+  (e.g. "seen#" to list everything you've marked seen). Capped at 25.
+- kv_store: Store (overwrite) a concise value under a plain \`key\`.
+  Use to record durable facts \u2014 e.g. dedup markers, prior decisions, summaries.
+
+Your namespace is added for you automatically; pass plain keys like
+"seen#owner/repo#42" or "lastRun".`,resolve(){let r=f();if(!r)return{command:null,args:[],env:{},description:this.description};let e={};for(let t of["PROJECT_API_TOKEN","ZIBBY_ACCOUNT_API_URL","ZIBBY_ENV","ZIBBY_PROD_ACCOUNT_API_URL","ZIBBY_USER_TOKEN","WORKFLOW_TYPE"])process.env[t]&&(e[t]=process.env[t]);return{type:"stdio",command:"node",args:[r,"../dist/kvMemory.js","kvMemorySkill"],env:e,description:this.description,alwaysLoad:!0}},async handleToolCall(r,e){try{switch(r){case"kv_recall":{let t=typeof e?.key=="string"?e.key.trim():"";if(!t)return JSON.stringify({error:"key is required"});let n=await i("recall",{scope:s(t)});return JSON.stringify(n)}case"kv_recall_prefix":{let t=typeof e?.keyPrefix=="string"?e.keyPrefix.trim():"";if(!t)return JSON.stringify({error:"keyPrefix is required"});let n=await i("recall-prefix",{scopePrefix:s(t)});return JSON.stringify(n)}case"kv_store":{let t=typeof e?.key=="string"?e.key.trim():"";if(!t)return JSON.stringify({error:"key is required"});if(typeof e?.content!="string"||e.content.length===0)return JSON.stringify({error:"content is required (non-empty string)"});let n={scope:s(t),content:e.content};e.metadata!=null&&(n.metadata=e.metadata);let o=await i("store",n);return JSON.stringify(o)}default:return JSON.stringify({error:`Unknown tool: ${r}`})}}catch(t){return JSON.stringify({error:t.message})}},tools:[{name:"kv_recall",description:'Recall the value you stored under a plain key (exact match). Your per-agent namespace is added automatically \u2014 pass a plain key like "seen#owner/repo#42".',input_schema:{type:"object",properties:{key:{type:"string",description:'Plain storage key (no namespace prefix needed) \u2014 e.g. "seen#owner/repo#42" or "lastRun".'}},required:["key"]}},{name:"kv_recall_prefix",description:'List your entries whose plain key STARTS WITH a prefix (e.g. "seen#"). Your per-agent namespace is added automatically. Capped at 25.',input_schema:{type:"object",properties:{keyPrefix:{type:"string",description:'Plain key prefix to match (no namespace prefix needed) \u2014 e.g. "seen#".'}},required:["keyPrefix"]}},{name:"kv_store",description:"Store (overwrite) a value under a plain key so a later run of yours can recall it. Your per-agent namespace is added automatically.",input_schema:{type:"object",properties:{key:{type:"string",description:"Plain storage key (no namespace prefix needed). Same key you recall by."},content:{type:"string",description:"The value to persist. Free-form markdown/text."},metadata:{type:"object",description:"Optional structured metadata."}},required:["key","content"]}}]};export{T as kvMemorySkill};

package/dist/package.json

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

package/docs/cloud/editing-prompts.md

@@ -0,0 +1,79 @@
+---
+sidebar_position: 6
+title: Editing node prompts
+---
+
+# Editing node prompts
+
+Every node in an agent has a **prompt** — the instructions handed to the
+coding agent when that step runs. In the graph editor (both the deploy modal
+and a deployed agent's **Overview** tab) each prompt is tagged with a badge:
+
+| Badge | What it means |
+|---|---|
+| <span style={{color:'#34d399',fontWeight:600}}>EDITABLE</span> | The prompt is a stored text template. You can change it right here. |
+| <span style={{color:'#d4b483',fontWeight:600}}>READ-ONLY</span> | The prompt is generated by the node's code at runtime. It can't be edited in the UI. |
+
+The `!` next to the badge explains the same thing on hover.
+
+## Editable prompts
+
+A prompt is editable when the node declares it as a plain text template (a
+string, optionally with `{{variables}}`).
+
+The graph shown in the marketplace **deploy modal is a read-only preview** —
+you pick the name and model there, not edit prompts. You edit editable
+prompts **after you deploy**:
+
+- Open the deployed agent's **Overview** tab.
+- Click the node, edit the prompt, and save.
+- The change applies to the next run **live — no redeploy needed**.
+
+This is the right choice when you want non-developers to tune wording,
+tone, or rules without touching code.
+
+## Read-only prompts
+
+A prompt is read-only when the node builds it **in code** — a function that
+assembles the text from state, fetched context, or conditionals at runtime.
+There's no fixed string to edit, so the editor shows a rendered preview only.
+
+To change a read-only prompt you edit the agent's source and redeploy. You
+don't need to leave your AI coding agent to do it — the
+[Zibby MCP](../packages/mcp-cli) drives the whole loop from chat:
+
+1. **Download the agent** — pull the deployed sources back to your machine.
+
+   ```bash
+   zibby agent download <uuid>
+   ```
+
+   Or, from an MCP-aware agent (Claude Code / Cursor / Codex / Gemini),
+   ask it to call `zibby_download_agent`.
+
+2. **Edit the node's code** — open the node file under
+   `.zibby/workflows/<name>/nodes/` and change how the prompt is built. Your
+   coding agent can do this directly.
+
+3. **Redeploy to update** — ship the change back to the same agent.
+
+   ```bash
+   zibby agent deploy <name>
+   ```
+
+   Or have the agent call `zibby_deploy_agent`. The deployed agent updates in
+   place; its UUID and trigger config stay the same.
+
+:::tip Want it editable instead?
+If a prompt would be better tuned by non-developers, convert the node from a
+function prompt to a **string template**. Once it's a stored template, the
+badge flips to **Editable** and it gains live-update from Overview.
+:::
+
+## Why the split exists
+
+Function prompts exist for a reason: some nodes need to assemble instructions
+from things only known at runtime — the linked ticket, the diff, prior
+reviews, whether an integration is connected. A fixed text box can't express
+that logic, so those nodes keep their prompt in code. Simpler, static prompts
+stay as editable templates so anyone can adjust them.

package/package.json

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

package/dist/reviewMemory.js

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