@graphrefly/graphrefly 0.43.0 → 0.44.0

package/dist/chunk-Y4NI3X7O.js

@@ -1,84 +0,0 @@
-import{b as X}from"./chunk-CUNIRONA.js";import{h as Q,j as U}from"./chunk-626TESAC.js";import{E as z,F as W,G as Y,H as V}from"./chunk-LYCLF26R.js";import{b as ie}from"./chunk-QYADASLV.js";var he={};ie(he,{compileSpec:()=>ue,decompileSpec:()=>me,extractFnFactory:()=>te,extractSourceFactory:()=>ne,generateCatalogPrompt:()=>oe,isRichFnEntry:()=>T,isRichSourceEntry:()=>I,llmCompose:()=>ye,llmRefine:()=>ae,specDiff:()=>ge,validateSpec:()=>q,validateSpecAgainstCatalog:()=>K});function M(n){let e=n.meta?.factory;return typeof e=="string"?e:void 0}function C(n){let e=n.meta?.factoryArgs;return e!=null&&typeof e=="object"?e:{}}function Z(n){let e=C(n);return"initial"in e?e.initial:n.value}function T(n){return typeof n=="object"&&n!==null&&"factory"in n}function I(n){return typeof n=="object"&&n!==null&&"factory"in n}function te(n){return T(n)?n.factory:n}function ne(n){return I(n)?n.factory:n}function oe(n){let e=[];if(n.fns){let o=new Map;for(let[s,f]of Object.entries(n.fns)){let p=T(f)?f.tags?.[0]??"Other":"Other";o.has(p)||o.set(p,[]),o.get(p).push(ce(s,f))}for(let[s,f]of o)e.push(`${s}:
-${f.join(`
-`)}`)}if(n.sources){let o=[];for(let[s,f]of Object.entries(n.sources))o.push(pe(s,f));o.length>0&&e.push(`Sources:
-${o.join(`
-`)}`)}return e.join(`
-
-`)}function ce(n,e){if(!T(e))return`- ${n}`;let o=`- ${n}: ${e.description}`;if(e.configSchema){let s=Object.entries(e.configSchema).map(([f,p])=>{let u=`${f}: ${p.type}`;return p.enum&&(u+=` (${p.enum.join("|")})`),p.required===!1&&(u+="?"),u});o+=`. Config: { ${s.join(", ")} }`}return o}function pe(n,e){if(!I(e))return`- ${n}`;let o=`- ${n}: ${e.description}`;if(e.configSchema){let s=Object.entries(e.configSchema).map(([f,p])=>{let u=`${f}: ${p.type}`;return p.required===!1&&(u+="?"),u});o+=`. Config: { ${s.join(", ")} }`}return o}function K(n,e){let o=[],s=new Set(Object.keys(e.fns??{})),f=new Set(Object.keys(e.sources??{}));for(let[p,u]of Object.entries(n.nodes)){if(u.type==="template")continue;let i=u,r=M(i);if(r==null)continue;let t=i.type==="producer";if(i.type==="state"&&r==="state")continue;if(t){let h=f.has(r),l=s.has(r);if(!h&&!l&&(f.size>0||s.size>0)){let b=J(r,f)??J(r,s);o.push(`Node "${p}": source "${r}" not found in catalog`+(b?`. Did you mean "${b}"?`:""))}}else if(s.size>0&&!s.has(r))if(f.has(r))o.push(`Node "${p}": fn "${r}" is a source, not a function. Use it as a producer source instead, or use a function from: ${[...s].join(", ")}`);else{let h=J(r,s);o.push(`Node "${p}": fn "${r}" not found in catalog`+(h?`. Did you mean "${h}"?`:""))}let m=C(i);if(!t&&e.fns?.[r]){let h=e.fns[r];if(T(h)&&h.configSchema){for(let[l,b]of Object.entries(h.configSchema))if(b.required!==!1&&!(l in m)&&o.push(`Node "${p}": config missing required field "${l}"`),l in m&&b.enum){let S=m[l];b.enum.includes(S)||o.push(`Node "${p}": config.${l} = ${JSON.stringify(S)}, expected one of: ${b.enum.join(", ")}`)}}}if(t&&e.sources?.[r]){let h=e.sources[r];if(I(h)&&h.configSchema){for(let[l,b]of Object.entries(h.configSchema))if(b.required!==!1&&!(l in m)&&o.push(`Node "${p}": config missing required field "${l}"`),l in m&&b.enum){let S=m[l];b.enum.includes(S)||o.push(`Node "${p}": config.${l} = ${JSON.stringify(S)}, expected one of: ${b.enum.join(", ")}`)}}}}if(n.templates)for(let[p,u]of Object.entries(n.templates))for(let[i,r]of Object.entries(u.nodes)){let t=M(r);if(t!=null&&!(r.type==="state"&&t==="state")&&r.type!=="producer"&&s.size>0&&!s.has(t)){let m=J(t,s);o.push(`Template "${p}" node "${i}": fn "${t}" not found in catalog`+(m?`. Did you mean "${m}"?`:""))}}return{valid:o.length===0,errors:o,warnings:[]}}function J(n,e){let o=null,s=1/0,f=n.toLowerCase();for(let p of e){let u=fe(f,p.toLowerCase());u<s&&u<=Math.max(3,Math.floor(n.length/2))&&(s=u,o=p)}return o}function fe(n,e){let o=n.length,s=e.length,f=Array.from({length:o+1},(p,u)=>Array.from({length:s+1},(i,r)=>u===0?r:r===0?u:0));for(let p=1;p<=o;p++)for(let u=1;u<=s;u++)f[p][u]=n[p-1]===e[u-1]?f[p-1][u-1]:1+Math.min(f[p-1][u],f[p][u-1],f[p-1][u-1]);return f[o][s]}var ee=new Set(["state","producer","derived","effect","operator","template"]),de=new Set(["state","producer","derived","effect","operator"]);function q(n){let e=[],o=[];if(n==null||typeof n!="object")return{valid:!1,errors:["GraphSpec must be a non-null object"],warnings:o};let s=n;if((typeof s.name!="string"||s.name.length===0)&&e.push("Missing or empty 'name' field"),s.nodes==null||typeof s.nodes!="object"||Array.isArray(s.nodes))return e.push("Missing or invalid 'nodes' field (must be an object)"),{valid:!1,errors:e,warnings:o};let f=new Set(Object.keys(s.nodes)),p=new Map,u=new Map;if(s.templates!=null&&typeof s.templates=="object"&&!Array.isArray(s.templates)){for(let[i,r]of Object.entries(s.templates))if(r!=null&&typeof r=="object"){let t=r;u.set(i,{params:Array.isArray(t.params)?t.params:[]})}}if(s.templates!=null)if(typeof s.templates!="object"||Array.isArray(s.templates))e.push("'templates' must be an object");else for(let[i,r]of Object.entries(s.templates)){if(r==null||typeof r!="object"){e.push(`Template "${i}": must be an object`);continue}let t=r;if(Array.isArray(t.params)||e.push(`Template "${i}": missing 'params' array`),t.nodes==null||typeof t.nodes!="object"||Array.isArray(t.nodes))e.push(`Template "${i}": missing or invalid 'nodes' object`);else{let m=new Set(Array.isArray(t.params)?t.params:[]),h=new Set(Object.keys(t.nodes));for(let[l,b]of Object.entries(t.nodes)){if(b==null||typeof b!="object"){e.push(`Template "${i}" node "${l}": must be an object`);continue}let S=b;if((typeof S.type!="string"||!de.has(S.type))&&e.push(`Template "${i}" node "${l}": invalid type`),Array.isArray(S.deps))for(let g of S.deps)!h.has(g)&&!m.has(g)&&e.push(`Template "${i}" node "${l}": dep "${g}" is not an inner node or param`)}typeof t.output!="string"?e.push(`Template "${i}": missing 'output' string`):t.nodes[t.output]||e.push(`Template "${i}": output "${t.output}" is not a declared node`)}}for(let[i,r]of Object.entries(s.nodes)){if(r==null||typeof r!="object"){e.push(`Node "${i}": must be an object`);continue}let t=r;if(typeof t.type!="string"||!ee.has(t.type)){e.push(`Node "${i}": invalid type "${String(t.type)}" (expected: ${[...ee].join(", ")})`);continue}if(p.set(i,t.type),t.type==="template")if(typeof t.template!="string"||!u.has(t.template))e.push(`Node "${i}": template "${String(t.template)}" not found in templates`);else if(t.bind==null||typeof t.bind!="object"||Array.isArray(t.bind))e.push(`Node "${i}": template ref requires 'bind' object`);else{let m=u.get(t.template),h=t.bind;for(let l of m.params)l in h||e.push(`Node "${i}": template param "${l}" is not bound (template "${t.template}")`);for(let[,l]of Object.entries(h))typeof l=="string"&&!f.has(l)&&e.push(`Node "${i}": bind target "${l}" does not reference an existing node`)}else{if(Array.isArray(t.deps))for(let m of t.deps)m===i?e.push(`Node "${i}": self-referencing dep`):f.has(m)||e.push(`Node "${i}": dep "${m}" does not reference an existing node`);(t.type==="derived"||t.type==="effect"||t.type==="operator")&&!Array.isArray(t.deps)&&e.push(`Node "${i}": ${t.type} node should have a 'deps' array`)}}if(s.feedback!=null)if(!Array.isArray(s.feedback))e.push("'feedback' must be an array");else for(let i=0;i<s.feedback.length;i++){let r=s.feedback[i];if(r==null||typeof r!="object"){e.push(`Feedback [${i}]: must be an object`);continue}let t=r;typeof t.from!="string"||!f.has(t.from)?e.push(`Feedback [${i}]: 'from' "${String(t.from)}" does not reference an existing node`):p.get(t.from)==="effect"&&o.push(`Feedback [${i}]: 'from' "${t.from}" is an effect node \u2014 effects emit no DATA, so the feedback edge will never fire. Did you mean a derived/state node upstream?`),typeof t.from=="string"&&t.from===t.to&&e.push(`Feedback [${i}]: 'from' and 'to' must be different nodes`),typeof t.to!="string"||!f.has(t.to)?e.push(`Feedback [${i}]: 'to' "${String(t.to)}" does not reference an existing node`):typeof t.to=="string"&&p.get(t.to)!=="state"&&e.push(`Feedback [${i}]: 'to' node "${t.to}" must be a state node (got "${p.get(t.to)??"unknown"}")`)}return{valid:e.length===0,errors:e,warnings:o}}function ue(n,e){let o=q(n);if(!o.valid)throw new Error(`compileSpec: invalid GraphSpec:
-${o.errors.join(`
-`)}`);let s=n.factory,f=n.factoryArgs;if(typeof s=="string"){let a=e?.catalog?.graphFactories?.[s];if(a)return a(f)}let p=e?.catalog??{},u=e?.onMissing??"placeholder",i=new U(n.name),r=n.templates??{},t=K(n,p);if(!t.valid)throw new Error(`compileSpec: catalog validation errors:
-${t.errors.join(`
-`)}`);let m=[],h=(a,d,y)=>{m.push({path:a,kind:d,name:y})},l=a=>{let d=p.fns?.[a];return d?te(d):void 0},b=a=>{let d=p.sources?.[a];return d?ne(d):void 0},S=a=>{if(!a)return;let d={};for(let[y,w]of Object.entries(a))y==="factory"||y==="factoryArgs"||(d[y]=w);return Object.keys(d).length>0?d:void 0},g=new Map,x=[];for(let[a,d]of Object.entries(n.nodes)){if(d.type==="template")continue;let y=d,w=M(y),k=C(y);if(y.type==="state"){let v=Z(y),R=z(v,{name:a,meta:S(y.meta)});i.add(R,{name:a}),g.set(a,R)}else if(y.type==="producer"){let v=w?b(w):void 0,R=w?l(w):void 0;if(v){let N=v(k);i.add(N,{name:a}),g.set(a,N)}else if(R){let N=R([],k);i.add(N,{name:a}),g.set(a,N)}else{w&&h(a,"source",w);let N=W(()=>{},{name:a,meta:{...S(y.meta),_specSource:w}});i.add(N,{name:a}),g.set(a,N)}}else x.push([a,y])}let L=!0,c=new Map(x);for(;c.size>0&&L;){L=!1;for(let[a,d]of[...c.entries()]){let y=d.deps??[];if(!y.every(F=>g.has(F)))continue;let w=y.map(F=>g.get(F)),k=M(d),v=C(d),R=k?l(k):void 0,N;R?N=R(w,v):d.type==="effect"?(k&&h(a,"fn",k),N=V(w,()=>{})):(k&&h(a,"fn",k),N=Y(w,F=>F[0])),i.add(N,{name:a}),g.set(a,N),c.delete(a),L=!0}}if(c.size>0){let a=[...c.keys()].sort().join(", ");throw new Error(`compileSpec: unresolvable deps for nodes: ${a}`)}for(let[a,d]of Object.entries(n.nodes)){if(d.type!=="template")continue;let y=d,w=r[y.template],k=new U(a),v=new Map,R=[];for(let[$,j]of Object.entries(w.nodes)){let P=(j.deps??[]).map(A=>A.startsWith("$")&&y.bind[A]?y.bind[A]:A),H={...j,deps:P},G=M(j),E=C(j);if(j.type==="state"){let A=Z(j),_=z(A,{name:$,meta:S(j.meta)});k.add(_,{name:$}),v.set($,_)}else if(j.type==="producer"){let A=G?b(G):void 0,_=G?l(G):void 0;if(A){let O=A(E);k.add(O,{name:$}),v.set($,O)}else if(_){let O=_([],E);k.add(O,{name:$}),v.set($,O)}else{G&&h(`${a}.${$}`,"source",G);let O=W(()=>{},{name:$,meta:{...S(j.meta),_specSource:G}});k.add(O,{name:$}),v.set($,O)}}else R.push([$,H])}let N=!0,F=new Map(R);for(;F.size>0&&N;){N=!1;for(let[$,j]of[...F.entries()]){let P=j.deps??[];if(!P.every(D=>v.has(D)||g.has(D)))continue;let G=P.map(D=>v.get(D)??g.get(D)),E=M(j),A=C(j),_=E?l(E):void 0,O;_?O=_(G,A):j.type==="effect"?(E&&h(`${a}.${$}`,"fn",E),O=V(G,()=>{})):(E&&h(`${a}.${$}`,"fn",E),O=Y(G,D=>D[0])),k.add(O,{name:$}),v.set($,O),F.delete($),N=!0}}if(F.size>0){let $=[...F.keys()].sort().join(", ");throw new Error(`compileSpec: template "${y.template}" has unresolvable deps: ${$}`)}i.mount(a,k);let B=`${a}::${w.output}`;g.set(a,i.resolve(B));try{let $=i.resolve(B);$.meta._templateName?.emit(y.template),$.meta._templateBind?.emit(y.bind)}catch{}}for(let a of n.feedback??[])X(i,a.from,a.to,{maxIterations:a.maxIterations});if(m.length>0){if(u==="error"){let a=m.map(d=>`  - ${d.path}: missing ${d.kind} "${d.name}"`);throw new Error(`compileSpec: ${m.length} catalog entr${m.length===1?"y":"ies"} missing \u2014 pass them via opts.catalog or set opts.onMissing to "warn"/"placeholder":
-${a.join(`
-`)}`)}if(u==="warn"){let a=e?.onWarn??(d=>console.warn(d));for(let d of m)a(`compileSpec: ${d.path} references missing ${d.kind} "${d.name}" \u2014 substituted placeholder`)}}return i}var le=new Set(["reduction","reduction_type","_specFn","_specSource","_templateName","_templateBind","feedbackFrom","feedbackTo","_internal"]);function me(n){let e=n.describe({detail:"spec"}),o=`::${Q}::`,s=/^__feedback_(?!effect_)(.+)$/,f=[],p=new Set;for(let[r,t]of Object.entries(e.nodes))t.meta?.factory!=null&&!r.includes("::")&&p.add(r);let u={};for(let[r,t]of Object.entries(e.nodes)){if(r.includes(o))continue;let m=r.indexOf("::");if(m>0&&p.has(r.slice(0,m)))continue;if(s.exec(r)){let g=t.meta;g?.feedbackFrom&&g?.feedbackTo&&f.push({from:g.feedbackFrom,to:g.feedbackTo,...g.maxIterations?{maxIterations:g.maxIterations}:{}});continue}if(t.meta?._internal||r.startsWith("__feedback_effect_")||r.startsWith("__bridge_"))continue;let l=t.meta,b=l;if(l&&Object.keys(l).length>0){let g={};for(let[x,L]of Object.entries(l))le.has(x)||(g[x]=L);g.factory==="withStatus"?(delete g.status,delete g.error):g.factory==="withBreaker"?delete g.breakerState:g.factory==="verifiable"&&delete g.sourceVersion,b=Object.keys(g).length>0?g:void 0}let S={...t};b===void 0?delete S.meta:S.meta=b,u[r]=S}let i={...e,nodes:u};return delete i.expand,f.length>0&&(i.feedback=f),i}function ge(n,e){let o=[];n.name!==e.name&&o.push({type:"changed",path:"name",detail:`"${n.name}" \u2192 "${e.name}"`});let s=new Set(Object.keys(n.nodes)),f=new Set(Object.keys(e.nodes));for(let c of f)if(!s.has(c)){let a=e.nodes[c];o.push({type:"added",path:`nodes.${c}`,detail:`type: ${a.type}`})}for(let c of s)f.has(c)||o.push({type:"removed",path:`nodes.${c}`});for(let c of s){if(!f.has(c))continue;let a=n.nodes[c],d=e.nodes[c];if(JSON.stringify(a)!==JSON.stringify(d)){let y=[];a.type!==d.type&&y.push(`type: ${a.type} \u2192 ${d.type}`),JSON.stringify(a.deps)!==JSON.stringify(d.deps)&&y.push("deps changed");let w=a.type==="template"?void 0:M(a),k=d.type==="template"?void 0:M(d);w!==k&&y.push(`fn: ${w} \u2192 ${k}`);let v=a.type==="template"?void 0:C(a),R=d.type==="template"?void 0:C(d);JSON.stringify(v)!==JSON.stringify(R)&&y.push("config changed"),o.push({type:"changed",path:`nodes.${c}`,detail:y.join("; ")||"modified"})}}let p=n.templates??{},u=e.templates??{},i=new Set(Object.keys(p)),r=new Set(Object.keys(u));for(let c of r)i.has(c)||o.push({type:"added",path:`templates.${c}`});for(let c of i)r.has(c)||o.push({type:"removed",path:`templates.${c}`});for(let c of i)r.has(c)&&JSON.stringify(p[c])!==JSON.stringify(u[c])&&o.push({type:"changed",path:`templates.${c}`,detail:"template definition changed"});let t=n.feedback??[],m=e.feedback??[],h=new Set(t.map(c=>`${c.from}->${c.to}`)),l=new Set(m.map(c=>`${c.from}->${c.to}`));for(let c of m){let a=`${c.from}->${c.to}`;h.has(a)||o.push({type:"added",path:`feedback.${a}`,detail:`maxIterations: ${c.maxIterations??10}`})}for(let c of t){let a=`${c.from}->${c.to}`;l.has(a)||o.push({type:"removed",path:`feedback.${a}`})}for(let c of t){let a=`${c.from}->${c.to}`,d=m.find(y=>y.from===c.from&&y.to===c.to);d&&JSON.stringify(c)!==JSON.stringify(d)&&o.push({type:"changed",path:`feedback.${a}`,detail:`maxIterations: ${c.maxIterations??10} \u2192 ${d.maxIterations??10}`})}let b=o.filter(c=>c.type==="added").length,S=o.filter(c=>c.type==="removed").length,g=o.filter(c=>c.type==="changed").length,x=[];b&&x.push(`${b} added`),S&&x.push(`${S} removed`),g&&x.push(`${g} changed`);let L=x.length>0?x.join(", "):"no changes";return{entries:o,summary:L}}var se=`You are a graph architect for GraphReFly, a reactive graph protocol.
-
-Given a natural-language description, produce a JSON GraphSpec with this structure:
-
-{
-  "name": "<graph_name>",
-  "nodes": {
-    "<node_name>": {
-      "type": "state" | "derived" | "producer" | "effect",
-      "deps": ["<dep_node_name>", ...],
-      "value": <initial_value>,
-      "meta": {
-        "factory": "<catalog_factory_name>",
-        "factoryArgs": { ... },
-        "description": "<purpose>"
-      }
-    },
-    "<template_instance>": {
-      "type": "template",
-      "template": "<template_name>",
-      "bind": { "$param": "node_name" }
-    }
-  },
-  "templates": {
-    "<template_name>": {
-      "params": ["$param1", "$param2"],
-      "nodes": { ... },
-      "output": "<output_node>"
-    }
-  },
-  "feedback": [
-    { "from": "<condition_node>", "to": "<state_node>", "maxIterations": 10 }
-  ]
-}
-
-Rules:
-- "state" nodes hold user/LLM-writable values (knobs). Stamp the initial value
-  in "meta.factoryArgs.initial" (or as the top-level "value" field \u2014 both work).
-- "derived" nodes compute from deps using a catalog function named in
-  "meta.factory"; pass any config via "meta.factoryArgs".
-- "effect" nodes produce side effects from deps; same meta.factory shape as derived.
-- "producer" nodes generate values from a catalog source named in "meta.factory";
-  pass any config via "meta.factoryArgs".
-- Use "templates" when the same subgraph pattern repeats (e.g., per-source resilience).
-- Use "feedback" for bounded cycles where a derived value writes back to a state node.
-- meta.description is required for every node.
-- Return ONLY valid JSON, no markdown fences or commentary.`;function re(n){let e=n.match(/^```(?:json)?\s*([\s\S]*?)\s*```[\s\S]*$/);return e?e[1]:n}async function ye(n,e,o){let s=se,f=o?.catalogDescription??(o?.catalog?oe(o.catalog):void 0);f&&(s+=`
-
-Available catalog (use ONLY these names):
-${f}`),o?.systemPromptExtra&&(s+=`
-
-${o.systemPromptExtra}`);let p=[{role:"system",content:s},{role:"user",content:n}],r=(await e.invoke(p,{model:o?.model,temperature:o?.temperature??0,maxTokens:o?.maxTokens})).content.trim();r.startsWith("```")&&(r=re(r));let t;try{t=JSON.parse(r)}catch{throw new Error(`llmCompose: LLM response is not valid JSON: ${r.slice(0,200)}`)}let m=q(t);if(!m.valid)throw new Error(`llmCompose: invalid GraphSpec:
-${m.errors.join(`
-`)}`);let h=t;if(o?.catalog){let l=o.maxAutoRefine??0;for(let b=0;b<=l;b++){let S=K(h,o.catalog);if(S.valid)break;if(b===l)throw new Error(`llmCompose: catalog validation failed after ${l} refine attempts:
-${S.errors.join(`
-`)}`);h=await ae(h,`Fix these catalog errors:
-${S.errors.join(`
-`)}
-
-Use ONLY functions and sources from the catalog.`,e,{...o,catalogDescription:f})}}return h}async function ae(n,e,o,s){let f=se;s?.catalogDescription&&(f+=`
-
-Available catalog:
-${s.catalogDescription}`),s?.systemPromptExtra&&(f+=`
-
-${s.systemPromptExtra}`);let p=[{role:"system",content:f},{role:"user",content:`Current GraphSpec:
-${JSON.stringify(n,null,2)}
-
-Modification request: ${e}
-
-Return the complete modified GraphSpec as JSON.`}],r=(await o.invoke(p,{model:s?.model,temperature:s?.temperature??0,maxTokens:s?.maxTokens})).content.trim();r.startsWith("```")&&(r=re(r));let t;try{t=JSON.parse(r)}catch{throw new Error(`llmRefine: LLM response is not valid JSON: ${r.slice(0,200)}`)}let m=q(t);if(!m.valid)throw new Error(`llmRefine: invalid GraphSpec:
-${m.errors.join(`
-`)}`);return t}export{T as a,I as b,te as c,ne as d,oe as e,K as f,q as g,ue as h,me as i,ge as j,ye as k,ae as l,he as m};

package/dist/meta-BgVAsg9j.d.ts

@@ -1,102 +0,0 @@
-import { e as NodeDescribeKind, N as Node, A as Actor } from './node-ClS5yC-B.js';
-
-/**
- * JSON-shaped slice of a node for `Graph.describe()`
- * (GRAPHREFLY-SPEC §3.6, Appendix B).
- */
-type DescribeNodeOutput = {
-    type: NodeDescribeKind;
-    status?: Node["status"];
-    deps: string[];
-    meta?: Record<string, unknown>;
-    name?: string;
-    value?: unknown;
-    /** True when the node is in `"sentinel"` state (no value ever). */
-    sentinel?: boolean;
-    v?: {
-        id: string;
-        version: number;
-        cid?: string;
-        prev?: string | null;
-    };
-    guard?: string;
-    lastMutation?: Readonly<{
-        actor: Actor;
-        timestamp_ns: number;
-    }>;
-    /**
-     * Latest annotation attached via `graph.trace(path, annotation)` or via
-     * `graph.add(node, { name: path, annotation })`, when present. Populated by
-     * `Graph.describe` only — `describeNode` has no graph context.
-     */
-    annotation?: string;
-};
-/**
- * Detail level for progressive disclosure (Phase 3.3b).
- *
- * - `"minimal"` — `type`, `deps` only.
- * - `"standard"` — minimal + `status`, `value`, `meta`, `v`.
- * - `"full"` — every field.
- * - `"spec"` — Tier 1.5.3 (Session A.1 lock + Phase 3 path (b)). Projects
- *   spec-relevant fields (`type`, `deps`, `meta` — including
- *   `meta.factory` / `meta.factoryArgs`) and strips runtime fields
- *   (`status`, `lastMutation`, `guard`, `sentinel`, `v`). **Retains
- *   `value` for state nodes only** so the seed initial value round-trips
- *   through `decompileSpec` → `compileSpec` without forcing every state
- *   constructor to spawn `meta.factory`/`factoryArgs` companion nodes.
- *   The output is structurally identical to the `GraphSpec` shape so
- *   `decompileSpec(g) === describe(g, { detail: "spec" })`.
- */
-type DescribeDetail = "minimal" | "standard" | "full" | "spec";
-/** Valid field names for `describe({ fields: [...] })`. */
-type DescribeField = "type" | "status" | "value" | "deps" | "meta" | "v" | "guard" | "lastMutation" | `meta.${string}`;
-/** Resolve which fields to include based on detail level or explicit field list. */
-declare function resolveDescribeFields(detail?: DescribeDetail, fields?: readonly DescribeField[]): Set<string> | null;
-/**
- * Walk an arbitrary value, replacing non-JSON-serializable fields with
- * descriptive string placeholders (Tier 1.5.3 Phase 2.5 — DG2=ii). Useful for
- * `Graph.prototype.tagFactory(name, args)` when the factory's options include
- * `LLMAdapter` instances, callbacks, or `Node`s that don't survive
- * serialization. Output preserves structure for documentation / audit value;
- * recipients of the spec see "<Node>" / "<function>" / etc. in place of the
- * unserializable bits.
- *
- * Heuristics:
- * - `null` / `undefined` / boolean / number / string — kept as-is.
- * - `function` — `"<function>"`.
- * - Object with `subscribe` method — `"<Node>"` (matches Node-shape duck check).
- * - Array — recursed.
- * - Plain object — recursed.
- * - Anything else — `"<unserializable>"`.
- */
-declare function placeholderArgs(opts: Record<string, unknown>): Record<string, unknown>;
-/**
- * Build a `meta` fragment that stamps a factory identifier and its construction
- * arguments onto a node, so `describe({ detail: "spec" })` exposes enough
- * information for `compileSpec` to recreate the node from the snapshot.
- *
- * Use inside node-producing factories at construction time:
- *
- * ```ts
- * import { factoryTag } from "@graphrefly/graphrefly";
- *
- * export function rateLimiter<T>(source: NodeInput<T>, opts: RateLimiterOptions): Node<T> {
- *   return derived([fromAny(source)], fn, {
- *     name: "rate-limiter",
- *     meta: { ...factoryTag("rateLimiter", opts), domain: "resilience" },
- *   });
- * }
- * ```
- *
- * `factoryArgs` should be JSON-serializable so the spec round-trips through
- * `decompileSpec → compileSpec`. Function-typed args break determinism — use
- * the {@link COMPOSITION-GUIDE} §39 `meta.fnId` pattern for those.
- *
- * Tier 1.5.3 (Session A.1 lock).
- */
-declare function factoryTag(factory: string, factoryArgs?: unknown): {
-    factory: string;
-    factoryArgs?: unknown;
-};
-
-export { type DescribeNodeOutput as D, type DescribeDetail as a, type DescribeField as b, factoryTag as f, placeholderArgs as p, resolveDescribeFields as r };

package/dist/meta-vE8bxW1E.d.cts

@@ -1,102 +0,0 @@
-import { e as NodeDescribeKind, N as Node, A as Actor } from './node-ClS5yC-B.cjs';
-
-/**
- * JSON-shaped slice of a node for `Graph.describe()`
- * (GRAPHREFLY-SPEC §3.6, Appendix B).
- */
-type DescribeNodeOutput = {
-    type: NodeDescribeKind;
-    status?: Node["status"];
-    deps: string[];
-    meta?: Record<string, unknown>;
-    name?: string;
-    value?: unknown;
-    /** True when the node is in `"sentinel"` state (no value ever). */
-    sentinel?: boolean;
-    v?: {
-        id: string;
-        version: number;
-        cid?: string;
-        prev?: string | null;
-    };
-    guard?: string;
-    lastMutation?: Readonly<{
-        actor: Actor;
-        timestamp_ns: number;
-    }>;
-    /**
-     * Latest annotation attached via `graph.trace(path, annotation)` or via
-     * `graph.add(node, { name: path, annotation })`, when present. Populated by
-     * `Graph.describe` only — `describeNode` has no graph context.
-     */
-    annotation?: string;
-};
-/**
- * Detail level for progressive disclosure (Phase 3.3b).
- *
- * - `"minimal"` — `type`, `deps` only.
- * - `"standard"` — minimal + `status`, `value`, `meta`, `v`.
- * - `"full"` — every field.
- * - `"spec"` — Tier 1.5.3 (Session A.1 lock + Phase 3 path (b)). Projects
- *   spec-relevant fields (`type`, `deps`, `meta` — including
- *   `meta.factory` / `meta.factoryArgs`) and strips runtime fields
- *   (`status`, `lastMutation`, `guard`, `sentinel`, `v`). **Retains
- *   `value` for state nodes only** so the seed initial value round-trips
- *   through `decompileSpec` → `compileSpec` without forcing every state
- *   constructor to spawn `meta.factory`/`factoryArgs` companion nodes.
- *   The output is structurally identical to the `GraphSpec` shape so
- *   `decompileSpec(g) === describe(g, { detail: "spec" })`.
- */
-type DescribeDetail = "minimal" | "standard" | "full" | "spec";
-/** Valid field names for `describe({ fields: [...] })`. */
-type DescribeField = "type" | "status" | "value" | "deps" | "meta" | "v" | "guard" | "lastMutation" | `meta.${string}`;
-/** Resolve which fields to include based on detail level or explicit field list. */
-declare function resolveDescribeFields(detail?: DescribeDetail, fields?: readonly DescribeField[]): Set<string> | null;
-/**
- * Walk an arbitrary value, replacing non-JSON-serializable fields with
- * descriptive string placeholders (Tier 1.5.3 Phase 2.5 — DG2=ii). Useful for
- * `Graph.prototype.tagFactory(name, args)` when the factory's options include
- * `LLMAdapter` instances, callbacks, or `Node`s that don't survive
- * serialization. Output preserves structure for documentation / audit value;
- * recipients of the spec see "<Node>" / "<function>" / etc. in place of the
- * unserializable bits.
- *
- * Heuristics:
- * - `null` / `undefined` / boolean / number / string — kept as-is.
- * - `function` — `"<function>"`.
- * - Object with `subscribe` method — `"<Node>"` (matches Node-shape duck check).
- * - Array — recursed.
- * - Plain object — recursed.
- * - Anything else — `"<unserializable>"`.
- */
-declare function placeholderArgs(opts: Record<string, unknown>): Record<string, unknown>;
-/**
- * Build a `meta` fragment that stamps a factory identifier and its construction
- * arguments onto a node, so `describe({ detail: "spec" })` exposes enough
- * information for `compileSpec` to recreate the node from the snapshot.
- *
- * Use inside node-producing factories at construction time:
- *
- * ```ts
- * import { factoryTag } from "@graphrefly/graphrefly";
- *
- * export function rateLimiter<T>(source: NodeInput<T>, opts: RateLimiterOptions): Node<T> {
- *   return derived([fromAny(source)], fn, {
- *     name: "rate-limiter",
- *     meta: { ...factoryTag("rateLimiter", opts), domain: "resilience" },
- *   });
- * }
- * ```
- *
- * `factoryArgs` should be JSON-serializable so the spec round-trips through
- * `decompileSpec → compileSpec`. Function-typed args break determinism — use
- * the {@link COMPOSITION-GUIDE} §39 `meta.fnId` pattern for those.
- *
- * Tier 1.5.3 (Session A.1 lock).
- */
-declare function factoryTag(factory: string, factoryArgs?: unknown): {
-    factory: string;
-    factoryArgs?: unknown;
-};
-
-export { type DescribeNodeOutput as D, type DescribeDetail as a, type DescribeField as b, factoryTag as f, placeholderArgs as p, resolveDescribeFields as r };

package/dist/resilience-YIWPK4YC.js

@@ -1 +0,0 @@
-import{a,b,c,d,e,f,g,h,i,j,k,l,m,n}from"./chunk-VNC3TMVY.js";import"./chunk-L6NSJVJZ.js";import"./chunk-KVV66NN2.js";import"./chunk-3G5U5QNE.js";import"./chunk-C72GO4IZ.js";import"./chunk-626TESAC.js";import"./chunk-ESMPEKEV.js";import"./chunk-VOPGGIL7.js";import"./chunk-4VVTGLXJ.js";import"./chunk-35JTVPOX.js";import"./chunk-V5A7M7RJ.js";import"./chunk-LYCLF26R.js";import"./chunk-CK2E7BTU.js";import"./chunk-QYADASLV.js";export{e as CircuitOpenError,i as RateLimiterOverflowError,b as ResilientPipelineGraph,l as TimeoutError,a as budgetGate,f as circuitBreaker,m as fallback,j as rateLimiter,c as resilientPipeline,d as retry,n as timeout,h as tokenBucket,g as withBreaker,k as withStatus};