@lenserfight/sdk 2.1.0 → 2.2.0

package/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const A=100;class w{constructor(t){this.rpcClient=t}async browse(t,r=20){const e=Math.max(1,Math.min(r,A)),{data:n,error:a}=await this.rpcClient.rpc("fn_list_agents_by_owner",{p_owner_lenser_id:t.ownerId});if(a)throw new Error(`@lenserfight/sdk: fn_list_agents_by_owner failed — ${JSON.stringify(a)}`);return{items:(Array.isArray(n)?n:[]).slice(0,e),nextCursor:null}}async getById(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_get_agent_profile",{p_ai_lenser_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_get_agent_profile failed — ${JSON.stringify(e)}`);return r??null}async getLensBindings(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_list_agent_lens_bindings",{p_ai_lenser_id:t,p_limit:50,p_offset:0});if(e)throw new Error(`@lenserfight/sdk: fn_list_agent_lens_bindings failed — ${JSON.stringify(e)}`);return Array.isArray(r)?r:[]}async getModelBindings(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_list_agent_model_bindings",{p_ai_lenser_id:t,p_limit:50,p_offset:0});if(e)throw new Error(`@lenserfight/sdk: fn_list_agent_model_bindings failed — ${JSON.stringify(e)}`);return Array.isArray(r)?r:[]}}const v=100;class g{constructor(t){this.rpcClient=t}async browse(t={},r,e=20){const n=Math.max(1,Math.min(e,v)),a={p_search:t.search??null,p_category:t.category??null,p_status:t.status??null,p_cursor_created_at:r?.created_at??null,p_cursor_id:r?.id??null,p_limit:n},{data:s,error:l}=await this.rpcClient.rpc("fn_browse_battles",a);if(l)throw new Error(`@lenserfight/sdk: browse failed — ${JSON.stringify(l)}`);return Array.isArray(s)?s:[]}}function y(i){if(!i.url)throw new Error("@lenserfight/sdk: createClient requires `url`");if(!i.anonKey)throw new Error("@lenserfight/sdk: createClient requires `anonKey`");const t=i.fetch??globalThis.fetch;if(typeof t!="function")throw new Error("@lenserfight/sdk: global fetch unavailable — pass `fetch` in options");const r=i.url.replace(/\/+$/,""),e=i.apiKey??i.anonKey;return{async rpc(n,a){const s=await t(`${r}/rest/v1/rpc/${n}`,{method:"POST",headers:{apikey:i.anonKey,authorization:`Bearer ${e}`,"content-type":"application/json"},body:JSON.stringify(a??{})});if(!s.ok){const o=await s.text().catch(()=>"");return{data:null,error:{status:s.status,message:o||s.statusText}}}return{data:await s.json().catch(()=>null),error:null}}}}const E=100;function p(i){if(!i)return[];const t=i;return Array.isArray(t.data)?t.data:Array.isArray(i)?i:[]}function h(i){return{id:i.id,title:i.title??"",description:i.description??null,author:{id:i.lenser_id??"",handle:i.author_handle??"",displayName:i.author_handle??"",avatarUrl:null},tags:Array.isArray(i.tags)?i.tags:[],visibility:i.visibility??"public",status:i.status??"published",outputKind:null,latestVersionNumber:null,createdAt:i.created_at??""}}class m{constructor(t){this.rpcClient=t}async browse(t={},r=0,e=20){const n=Math.max(1,Math.min(e,E));if(t.search){const{data:l,error:o}=await this.rpcClient.rpc("fn_mcp_lens_search",{p_query:t.search,p_visibility:"public",p_limit:n,p_offset:Math.max(0,r)});if(o)throw new Error(`@lenserfight/sdk: fn_mcp_lens_search failed — ${JSON.stringify(o)}`);return p(l).map(h)}const{data:a,error:s}=await this.rpcClient.rpc("fn_mcp_lens_list",{p_limit:n,p_offset:Math.max(0,r),p_visibility:"public",p_status:t.status??null,p_lenser_id:null,p_include_archived:!1});if(s)throw new Error(`@lenserfight/sdk: fn_mcp_lens_list failed — ${JSON.stringify(s)}`);return p(a).map(h)}async search(t,r={},e=0,n=20){return this.browse({...r,search:t},e,n)}async getById(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_get_lens_detail_bootstrap",{p_lens_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_get_lens_detail_bootstrap failed — ${JSON.stringify(e)}`);return!r||r.error?null:r}async getVersion(t){const[r,e]=await Promise.all([this.rpcClient.rpc("fn_get_lens_version_detail",{p_version_id:t}),this.rpcClient.rpc("fn_get_lens_version_parameters",{p_version_id:t})]);if(r.error)throw new Error(`@lenserfight/sdk: fn_get_lens_version_detail failed — ${JSON.stringify(r.error)}`);if(!r.data)return null;const n=Array.isArray(r.data)?r.data[0]:r.data;return n?{...n,parameters:Array.isArray(e.data)?e.data:e.data??[]}:null}async resolveTemplate(t,r,e){const{data:n,error:a}=await this.rpcClient.rpc("fn_mcp_lens_resolve_template",{p_lens_id:t,p_version_id:e?.versionId??null});if(a)throw new Error(`@lenserfight/sdk: fn_mcp_lens_resolve_template failed — ${JSON.stringify(a)}`);if(!n)throw new Error(`@lenserfight/sdk: lens ${t} not found`);const s=n;let l=s.template_body;const o=[],d=[];for(const c of s.parameters??[]){const f=`[[:${c.id}]]`,u=r[c.label]??r[c.label.toLowerCase()]??Object.entries(r).find(([S])=>S.toLowerCase()===c.label.toLowerCase())?.[1];u!==void 0?(l=l.split(f).join(u),d.push(c.label)):c.optional?l=l.split(f).join(""):o.push(c.label)}return{resolvedPrompt:l,lensId:s.lens_id,versionId:s.version_id,lensTitle:s.title??t,lensDescription:s.description??null,paramsUsed:d,missing:o}}async getParameterContracts(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_get_version_contracts",{p_version_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_get_version_contracts failed — ${JSON.stringify(e)}`);if(!r)return[];const n=Array.isArray(r)?r[0]:r;if(!n)return[];const a=n.input_contract;if(!a)return[];const s=a.parameters??a.inputs;return Array.isArray(s)?s:[]}async extractParams(t){const r=await this.getParameterContracts(t);return{params:r,labels:r.map(e=>e.label)}}async validateParams(t,r){const e=await this.getParameterContracts(t),n=new Set(Object.keys(r).map(o=>o.toLowerCase())),a=new Set(e.map(o=>o.label.toLowerCase())),s=e.filter(o=>o.required&&!n.has(o.label.toLowerCase())).map(o=>o.label),l=Object.keys(r).filter(o=>!a.has(o.toLowerCase()));return{valid:s.length===0&&l.length===0,missing:s,unknown:l,total:e.length,provided:Object.keys(r).length}}}class b{constructor(t){this.rpcClient=t}async getContractByVersion(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_get_version_contracts",{p_version_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_get_version_contracts failed — ${JSON.stringify(e)}`);if(!r)return null;const n=Array.isArray(r)?r[0]:r;if(!n)return null;const a=n.input_contract;return a?{contentHash:"",body:a,publishedBy:"",publishedAt:"",supersedesHash:null}:null}async getContractByHash(t){return null}async getManifest(t){const r=await this.getContractByVersion(t);return r?{specVersion:r.body?.specVersion??"1.0.0",contentHash:r.contentHash,body:r.body,channel:null,signatures:[]}:null}async getDependencies(t){return[]}async checkCompatibility(t,r){const e=await this.getContractByVersion(t);if(!e)return{compatible:!1,missingScopes:[],warnings:["Contract not found"]};const n=e.body?.requiredScopes??[],a=r.filter(s=>!n.includes(s));return{compatible:a.length===0,missingScopes:a,warnings:[]}}}class C{constructor(t){this.rpcClient=t}async renderPrompt(t,r={}){const{data:e,error:n}=await this.rpcClient.rpc("fn_battles_render_prompt",{p_template_id:t,p_variables:r});if(n)throw new Error(`@lenserfight/sdk: renderPrompt failed — ${JSON.stringify(n)}`);return typeof e=="string"?e:""}}const $=new Set(["completed","failed","cancelled"]),O=3e3,N=12e4;class k{constructor(t){this.rpcClient=t}async browse(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_mcp_workflow_list",{p_limit:t?.limit??20,p_offset:t?.offset??0,p_visibility:t?.visibility??null,p_lenser_id:null});if(e)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_list failed — ${JSON.stringify(e)}`);const n=r?.data;return Array.isArray(n)?n:[]}async getById(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_mcp_workflow_get",{p_workflow_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_get failed — ${JSON.stringify(e)}`);return r??null}async startRun(t,r,e){const{data:n,error:a}=await this.rpcClient.rpc("fn_mcp_workflow_run_start",{p_workflow_id:t,p_inputs:r??{},p_global_model_id:e?.modelId??null,p_idempotency_key:e?.idempotencyKey??null,p_metadata:{}});if(a)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_run_start failed — ${JSON.stringify(a)}`);if(!n)throw new Error(`@lenserfight/sdk: workflow ${t} not found or inaccessible`);return n}async getRunStatus(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_mcp_workflow_run_status",{p_run_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_run_status failed — ${JSON.stringify(e)}`);if(!r)throw new Error(`@lenserfight/sdk: run ${t} not found`);const n=r;return{id:n.id,status:n.status,activeNodeId:n.active_node_id??null,creditsSpent:n.credits_spent??0}}async getRunLogs(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_mcp_workflow_run_logs",{p_run_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_run_logs failed — ${JSON.stringify(e)}`);const n=r?.node_results;return Array.isArray(n)?n.map(a=>{const s=a;return{nodeId:s.node_id,status:s.status,result:s.result??null,error:s.error??null,durationMs:s.duration_ms??0,tokenCount:s.token_count??0}}):[]}async awaitRun(t,r,e){const n=e?.timeoutMs??N,a=await this.startRun(t,r,e),s=Date.now()+n;for(;Date.now()<s;){await new Promise(o=>setTimeout(o,O));const l=await this.getRunStatus(a.id);if($.has(l.status)){if(l.status==="completed")return this.getRunLogs(a.id);throw new Error(`@lenserfight/sdk: workflow run ${a.id} ended with status "${l.status}"`)}}throw new Error(`@lenserfight/sdk: workflow run ${a.id} timed out after ${n}ms`)}}class _{agents;battles;lenses;protocols;templates;workflows;rpc;constructor(t){this.rpc=t,this.agents=new w(t),this.battles=new g(t),this.lenses=new m(t),this.protocols=new b(t),this.templates=new C(t),this.workflows=new k(t)}async rpcCall(t,r){const{data:e,error:n}=await this.rpc.rpc(t,r);if(n)throw new Error(`@lenserfight/sdk: ${t} failed — ${JSON.stringify(n)}`);return e}}function L(i){const t=y(i);return new _(t)}function M(i){return new _(i)}const T="1.0.0";exports.AgentClient=w;exports.BattleClient=g;exports.LensClient=m;exports.LenserFightClient=_;exports.ProtocolClient=b;exports.SDK_VERSION=T;exports.TemplateClient=C;exports.WorkflowClient=k;exports.createClient=L;exports.createClientFromRpc=M;exports.createFetchRpcClient=y;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=100;class w{constructor(t){this.rpcClient=t}async browse(t,e=20){const r=Math.max(1,Math.min(e,v)),{data:n,error:a}=await this.rpcClient.rpc("fn_list_agents_by_owner",{p_owner_lenser_id:t.ownerId});if(a)throw new Error(`@lenserfight/sdk: fn_list_agents_by_owner failed — ${JSON.stringify(a)}`);return{items:(Array.isArray(n)?n:[]).slice(0,r),nextCursor:null}}async getById(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_get_agent_profile",{p_ai_lenser_id:t});if(r)throw new Error(`@lenserfight/sdk: fn_get_agent_profile failed — ${JSON.stringify(r)}`);return e??null}async getLensBindings(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_list_agent_lens_bindings",{p_ai_lenser_id:t,p_limit:50,p_offset:0});if(r)throw new Error(`@lenserfight/sdk: fn_list_agent_lens_bindings failed — ${JSON.stringify(r)}`);return Array.isArray(e)?e:[]}async getModelBindings(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_list_agent_model_bindings",{p_ai_lenser_id:t,p_limit:50,p_offset:0});if(r)throw new Error(`@lenserfight/sdk: fn_list_agent_model_bindings failed — ${JSON.stringify(r)}`);return Array.isArray(e)?e:[]}}const A=100;class g{constructor(t){this.rpcClient=t}async browse(t={},e,r=20){const n=Math.max(1,Math.min(r,A)),a={p_search:t.search??null,p_category:t.category??null,p_status:t.status??null,p_cursor_created_at:e?.created_at??null,p_cursor_id:e?.id??null,p_limit:n},{data:i,error:l}=await this.rpcClient.rpc("fn_browse_battles",a);if(l)throw new Error(`@lenserfight/sdk: browse failed — ${JSON.stringify(l)}`);return Array.isArray(i)?i:[]}}function y(s){if(!s.url)throw new Error("@lenserfight/sdk: createClient requires `url`");if(!s.anonKey)throw new Error("@lenserfight/sdk: createClient requires `anonKey`");const t=s.fetch??globalThis.fetch;if(typeof t!="function")throw new Error("@lenserfight/sdk: global fetch unavailable — pass `fetch` in options");const e=s.url.replace(/\/+$/,""),r=s.apiKey??s.anonKey;return{async rpc(n,a){const i=await t(`${e}/rest/v1/rpc/${n}`,{method:"POST",headers:{apikey:s.anonKey,authorization:`Bearer ${r}`,"content-type":"application/json"},body:JSON.stringify(a??{})});if(!i.ok){const o=await i.text().catch(()=>"");return{data:null,error:{status:i.status,message:o||i.statusText}}}return{data:await i.json().catch(()=>null),error:null}}}}const E=100;function f(s){if(!s)return[];const t=s;return Array.isArray(t.data)?t.data:Array.isArray(s)?s:[]}function $(s){return{id:s.id,key:s.key,label:s.label??null,description:s.description??null,category:s.category,type:s.type,required:s.required??!0,placeholder:s.placeholder??null,helpText:s.help_text??null,options:s.options??null,validationSchema:s.validation_schema??null,icon:s.icon??null,color:s.color??null,isSystem:s.is_system??!1,maxLength:s.max_length??null,minLength:s.min_length??null,sortOrder:s.sort_order??0}}function O(s){const t=s.tool;return{id:s.id,label:s.label,toolId:s.tool_id??"",optional:s.optional??!1,tool:t?$(t):null}}function h(s){return{id:s.id,title:s.title??"",description:s.description??null,author:{id:s.lenser_id??"",handle:s.author_handle??"",displayName:s.author_handle??"",avatarUrl:null},tags:Array.isArray(s.tags)?s.tags:[],visibility:s.visibility??"public",status:s.status??"published",outputKind:null,latestVersionNumber:null,createdAt:s.created_at??""}}class m{constructor(t){this.rpcClient=t}async browse(t={},e=0,r=20){const n=Math.max(1,Math.min(r,E));if(t.search){const{data:l,error:o}=await this.rpcClient.rpc("fn_mcp_lens_search",{p_query:t.search,p_visibility:"public",p_limit:n,p_offset:Math.max(0,e)});if(o)throw new Error(`@lenserfight/sdk: fn_mcp_lens_search failed — ${JSON.stringify(o)}`);return f(l).map(h)}const{data:a,error:i}=await this.rpcClient.rpc("fn_mcp_lens_list",{p_limit:n,p_offset:Math.max(0,e),p_visibility:"public",p_status:t.status??null,p_lenser_id:null,p_include_archived:!1});if(i)throw new Error(`@lenserfight/sdk: fn_mcp_lens_list failed — ${JSON.stringify(i)}`);return f(a).map(h)}async search(t,e={},r=0,n=20){return this.browse({...e,search:t},r,n)}async getById(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_get_lens_detail_bootstrap",{p_lens_id:t});if(r)throw new Error(`@lenserfight/sdk: fn_get_lens_detail_bootstrap failed — ${JSON.stringify(r)}`);return!e||e.error?null:e}async getVersion(t){const[e,r]=await Promise.all([this.rpcClient.rpc("fn_get_lens_version_detail",{p_version_id:t}),this.rpcClient.rpc("fn_get_lens_version_parameters",{p_version_id:t})]);if(e.error)throw new Error(`@lenserfight/sdk: fn_get_lens_version_detail failed — ${JSON.stringify(e.error)}`);if(r.error)throw new Error(`@lenserfight/sdk: fn_get_lens_version_parameters failed — ${JSON.stringify(r.error)}`);if(!e.data)return null;const n=Array.isArray(e.data)?e.data[0]:e.data;if(!n)return null;const i=(Array.isArray(r.data)?r.data:[]).map(O);return{id:n.id,lensId:n.lens_id,versionNumber:n.version_number,status:n.status,changelog:n.changelog??null,parameterCount:i.length,createdAt:n.created_at,templateBody:n.template_body,publishedAt:n.published_at??null,parameters:i}}async getLatestVersion(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_get_lens_detail_bootstrap",{p_lens_id:t});if(r)throw new Error(`@lenserfight/sdk: fn_get_lens_detail_bootstrap failed — ${JSON.stringify(r)}`);if(!e||e.error)return null;const n=e.head_version_id;return n?this.getVersion(n):null}async resolveTemplate(t,e,r){const{data:n,error:a}=await this.rpcClient.rpc("fn_mcp_lens_resolve_template",{p_lens_id:t,p_version_id:r?.versionId??null});if(a)throw new Error(`@lenserfight/sdk: fn_mcp_lens_resolve_template failed — ${JSON.stringify(a)}`);if(!n)throw new Error(`@lenserfight/sdk: lens ${t} not found`);const i=n;let l=i.template_body;const o=[],d=[];for(const c of i.parameters??[]){const u=`[[:${c.id}]]`,p=e[c.label]??e[c.label.toLowerCase()]??Object.entries(e).find(([S])=>S.toLowerCase()===c.label.toLowerCase())?.[1];p!==void 0?(l=l.split(u).join(p),d.push(c.label)):c.optional?l=l.split(u).join(""):o.push(c.label)}return{resolvedPrompt:l,lensId:i.lens_id,versionId:i.version_id,lensTitle:i.title??t,lensDescription:i.description??null,paramsUsed:d,missing:o}}async getParameterContracts(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_get_version_contracts",{p_version_id:t});if(r)throw new Error(`@lenserfight/sdk: fn_get_version_contracts failed — ${JSON.stringify(r)}`);if(!e)return[];const n=Array.isArray(e)?e[0]:e;if(!n)return[];const a=n.input_contract;if(!a)return[];const i=a.parameters??a.inputs;return Array.isArray(i)?i:[]}async extractParams(t){const e=await this.getParameterContracts(t);return{params:e,labels:e.map(r=>r.label)}}async validateParams(t,e){const r=await this.getParameterContracts(t),n=new Set(Object.keys(e).map(o=>o.toLowerCase())),a=new Set(r.map(o=>o.label.toLowerCase())),i=r.filter(o=>o.required&&!n.has(o.label.toLowerCase())).map(o=>o.label),l=Object.keys(e).filter(o=>!a.has(o.toLowerCase()));return{valid:i.length===0&&l.length===0,missing:i,unknown:l,total:r.length,provided:Object.keys(e).length}}}class b{constructor(t){this.rpcClient=t}async getContractByVersion(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_get_version_contracts",{p_version_id:t});if(r)throw new Error(`@lenserfight/sdk: fn_get_version_contracts failed — ${JSON.stringify(r)}`);if(!e)return null;const n=Array.isArray(e)?e[0]:e;if(!n)return null;const a=n.input_contract;return a?{contentHash:"",body:a,publishedBy:"",publishedAt:"",supersedesHash:null}:null}async getContractByHash(t){return null}async getManifest(t){const e=await this.getContractByVersion(t);return e?{specVersion:e.body?.specVersion??"1.0.0",contentHash:e.contentHash,body:e.body,channel:null,signatures:[]}:null}async getDependencies(t){return[]}async checkCompatibility(t,e){const r=await this.getContractByVersion(t);if(!r)return{compatible:!1,missingScopes:[],warnings:["Contract not found"]};const n=r.body?.requiredScopes??[],a=e.filter(i=>!n.includes(i));return{compatible:a.length===0,missingScopes:a,warnings:[]}}}class C{constructor(t){this.rpcClient=t}async renderPrompt(t,e={}){const{data:r,error:n}=await this.rpcClient.rpc("fn_battles_render_prompt",{p_template_id:t,p_variables:e});if(n)throw new Error(`@lenserfight/sdk: renderPrompt failed — ${JSON.stringify(n)}`);return typeof r=="string"?r:""}}const N=new Set(["completed","failed","cancelled"]),L=3e3,M=12e4;class k{constructor(t){this.rpcClient=t}async browse(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_mcp_workflow_list",{p_limit:t?.limit??20,p_offset:t?.offset??0,p_visibility:t?.visibility??null,p_lenser_id:null});if(r)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_list failed — ${JSON.stringify(r)}`);const n=e?.data;return Array.isArray(n)?n:[]}async getById(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_mcp_workflow_get",{p_workflow_id:t});if(r)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_get failed — ${JSON.stringify(r)}`);return e??null}async startRun(t,e,r){const{data:n,error:a}=await this.rpcClient.rpc("fn_mcp_workflow_run_start",{p_workflow_id:t,p_inputs:e??{},p_global_model_id:r?.modelId??null,p_idempotency_key:r?.idempotencyKey??null,p_metadata:{}});if(a)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_run_start failed — ${JSON.stringify(a)}`);if(!n)throw new Error(`@lenserfight/sdk: workflow ${t} not found or inaccessible`);return n}async getRunStatus(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_mcp_workflow_run_status",{p_run_id:t});if(r)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_run_status failed — ${JSON.stringify(r)}`);if(!e)throw new Error(`@lenserfight/sdk: run ${t} not found`);const n=e;return{id:n.id,status:n.status,activeNodeId:n.active_node_id??null,creditsSpent:n.credits_spent??0}}async getRunLogs(t){const{data:e,error:r}=await this.rpcClient.rpc("fn_mcp_workflow_run_logs",{p_run_id:t});if(r)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_run_logs failed — ${JSON.stringify(r)}`);const n=e?.node_results;return Array.isArray(n)?n.map(a=>{const i=a;return{nodeId:i.node_id,status:i.status,result:i.result??null,error:i.error??null,durationMs:i.duration_ms??0,tokenCount:i.token_count??0}}):[]}async awaitRun(t,e,r){const n=r?.timeoutMs??M,a=await this.startRun(t,e,r),i=Date.now()+n;for(;Date.now()<i;){await new Promise(o=>setTimeout(o,L));const l=await this.getRunStatus(a.id);if(N.has(l.status)){if(l.status==="completed")return this.getRunLogs(a.id);throw new Error(`@lenserfight/sdk: workflow run ${a.id} ended with status "${l.status}"`)}}throw new Error(`@lenserfight/sdk: workflow run ${a.id} timed out after ${n}ms`)}}class _{agents;battles;lenses;protocols;templates;workflows;rpc;constructor(t){this.rpc=t,this.agents=new w(t),this.battles=new g(t),this.lenses=new m(t),this.protocols=new b(t),this.templates=new C(t),this.workflows=new k(t)}async rpcCall(t,e){const{data:r,error:n}=await this.rpc.rpc(t,e);if(n)throw new Error(`@lenserfight/sdk: ${t} failed — ${JSON.stringify(n)}`);return r}}function T(s){const t=y(s);return new _(t)}function J(s){return new _(s)}const R="1.0.0";exports.AgentClient=w;exports.BattleClient=g;exports.LensClient=m;exports.LenserFightClient=_;exports.ProtocolClient=b;exports.SDK_VERSION=R;exports.TemplateClient=C;exports.WorkflowClient=k;exports.createClient=T;exports.createClientFromRpc=J;exports.createFetchRpcClient=y;

package/index.mjs

@@ -78,71 +78,102 @@ class m {
       p_cursor_created_at: r?.created_at ?? null,
       p_cursor_id: r?.id ?? null,
       p_limit: n
-    }, { data: s, error: l } = await this.rpcClient.rpc("fn_browse_battles", a);
+    }, { data: i, error: l } = await this.rpcClient.rpc("fn_browse_battles", a);
     if (l)
       throw new Error(
         `@lenserfight/sdk: browse failed — ${JSON.stringify(l)}`
       );
-    return Array.isArray(s) ? s : [];
+    return Array.isArray(i) ? i : [];
   }
 }
-function b(i) {
-  if (!i.url)
+function b(s) {
+  if (!s.url)
     throw new Error("@lenserfight/sdk: createClient requires `url`");
-  if (!i.anonKey)
+  if (!s.anonKey)
     throw new Error("@lenserfight/sdk: createClient requires `anonKey`");
-  const t = i.fetch ?? globalThis.fetch;
+  const t = s.fetch ?? globalThis.fetch;
   if (typeof t != "function")
     throw new Error("@lenserfight/sdk: global fetch unavailable — pass `fetch` in options");
-  const r = i.url.replace(/\/+$/, ""), e = i.apiKey ?? i.anonKey;
+  const r = s.url.replace(/\/+$/, ""), e = s.apiKey ?? s.anonKey;
   return {
     async rpc(n, a) {
-      const s = await t(`${r}/rest/v1/rpc/${n}`, {
+      const i = await t(`${r}/rest/v1/rpc/${n}`, {
         method: "POST",
         headers: {
-          apikey: i.anonKey,
+          apikey: s.anonKey,
           authorization: `Bearer ${e}`,
           "content-type": "application/json"
         },
         body: JSON.stringify(a ?? {})
       });
-      if (!s.ok) {
-        const o = await s.text().catch(() => "");
+      if (!i.ok) {
+        const o = await i.text().catch(() => "");
         return {
           data: null,
-          error: { status: s.status, message: o || s.statusText }
+          error: { status: i.status, message: o || i.statusText }
         };
       }
-      return { data: await s.json().catch(() => null), error: null };
+      return { data: await i.json().catch(() => null), error: null };
     }
   };
 }
 const k = 100;
-function u(i) {
-  if (!i) return [];
-  const t = i;
-  return Array.isArray(t.data) ? t.data : Array.isArray(i) ? i : [];
+function p(s) {
+  if (!s) return [];
+  const t = s;
+  return Array.isArray(t.data) ? t.data : Array.isArray(s) ? s : [];
 }
-function p(i) {
+function C(s) {
   return {
-    id: i.id,
-    title: i.title ?? "",
-    description: i.description ?? null,
+    id: s.id,
+    key: s.key,
+    label: s.label ?? null,
+    description: s.description ?? null,
+    category: s.category,
+    type: s.type,
+    required: s.required ?? !0,
+    placeholder: s.placeholder ?? null,
+    helpText: s.help_text ?? null,
+    options: s.options ?? null,
+    validationSchema: s.validation_schema ?? null,
+    icon: s.icon ?? null,
+    color: s.color ?? null,
+    isSystem: s.is_system ?? !1,
+    maxLength: s.max_length ?? null,
+    minLength: s.min_length ?? null,
+    sortOrder: s.sort_order ?? 0
+  };
+}
+function v(s) {
+  const t = s.tool;
+  return {
+    id: s.id,
+    label: s.label,
+    toolId: s.tool_id ?? "",
+    optional: s.optional ?? !1,
+    tool: t ? C(t) : null
+  };
+}
+function f(s) {
+  return {
+    id: s.id,
+    title: s.title ?? "",
+    description: s.description ?? null,
     author: {
-      id: i.lenser_id ?? "",
-      handle: i.author_handle ?? "",
-      displayName: i.author_handle ?? "",
+      id: s.lenser_id ?? "",
+      handle: s.author_handle ?? "",
+      displayName: s.author_handle ?? "",
       avatarUrl: null
     },
-    tags: Array.isArray(i.tags) ? i.tags : [],
-    visibility: i.visibility ?? "public",
-    status: i.status ?? "published",
+    tags: Array.isArray(s.tags) ? s.tags : [],
+    visibility: s.visibility ?? "public",
+    status: s.status ?? "published",
     outputKind: null,
     latestVersionNumber: null,
-    createdAt: i.created_at ?? ""
+    createdAt: s.created_at ?? ""
   };
 }
-class C {
+class A {
   constructor(t) {
     this.rpcClient = t;
   }
@@ -162,9 +193,9 @@ class C {
       });
       if (o)
         throw new Error(`@lenserfight/sdk: fn_mcp_lens_search failed — ${JSON.stringify(o)}`);
-      return u(l).map(p);
+      return p(l).map(f);
     }
-    const { data: a, error: s } = await this.rpcClient.rpc("fn_mcp_lens_list", {
+    const { data: a, error: i } = await this.rpcClient.rpc("fn_mcp_lens_list", {
       p_limit: n,
       p_offset: Math.max(0, r),
       p_visibility: "public",
@@ -172,9 +203,9 @@ class C {
       p_lenser_id: null,
       p_include_archived: !1
     });
-    if (s)
-      throw new Error(`@lenserfight/sdk: fn_mcp_lens_list failed — ${JSON.stringify(s)}`);
-    return u(a).map(p);
+    if (i)
+      throw new Error(`@lenserfight/sdk: fn_mcp_lens_list failed — ${JSON.stringify(i)}`);
+    return p(a).map(f);
   }
   /**
    * Full-text search across public lenses.
@@ -204,12 +235,39 @@ class C {
     ]);
     if (r.error)
       throw new Error(`@lenserfight/sdk: fn_get_lens_version_detail failed — ${JSON.stringify(r.error)}`);
+    if (e.error)
+      throw new Error(`@lenserfight/sdk: fn_get_lens_version_parameters failed — ${JSON.stringify(e.error)}`);
     if (!r.data) return null;
     const n = Array.isArray(r.data) ? r.data[0] : r.data;
-    return n ? {
-      ...n,
-      parameters: Array.isArray(e.data) ? e.data : e.data ?? []
-    } : null;
+    if (!n) return null;
+    const i = (Array.isArray(e.data) ? e.data : []).map(v);
+    return {
+      id: n.id,
+      lensId: n.lens_id,
+      versionNumber: n.version_number,
+      status: n.status,
+      changelog: n.changelog ?? null,
+      parameterCount: i.length,
+      createdAt: n.created_at,
+      templateBody: n.template_body,
+      publishedAt: n.published_at ?? null,
+      parameters: i
+    };
+  }
+  /**
+   * Get the latest (HEAD) version of a lens with its parameters.
+   * Convenience wrapper: resolves `head_version_id` via `fn_get_lens_detail_bootstrap`,
+   * then delegates to `getVersion()`.
+   */
+  async getLatestVersion(t) {
+    const { data: r, error: e } = await this.rpcClient.rpc("fn_get_lens_detail_bootstrap", {
+      p_lens_id: t
+    });
+    if (e)
+      throw new Error(`@lenserfight/sdk: fn_get_lens_detail_bootstrap failed — ${JSON.stringify(e)}`);
+    if (!r || r.error) return null;
+    const n = r.head_version_id;
+    return n ? this.getVersion(n) : null;
   }
   /**
    * Resolve a lens template by substituting `[[:paramId]]` tokens with the
@@ -227,19 +285,19 @@ class C {
       throw new Error(`@lenserfight/sdk: fn_mcp_lens_resolve_template failed — ${JSON.stringify(a)}`);
     if (!n)
       throw new Error(`@lenserfight/sdk: lens ${t} not found`);
-    const s = n;
-    let l = s.template_body;
+    const i = n;
+    let l = i.template_body;
     const o = [], _ = [];
-    for (const c of s.parameters ?? []) {
-      const d = `[[:${c.id}]]`, f = r[c.label] ?? r[c.label.toLowerCase()] ?? Object.entries(r).find(([w]) => w.toLowerCase() === c.label.toLowerCase())?.[1];
-      f !== void 0 ? (l = l.split(d).join(f), _.push(c.label)) : c.optional ? l = l.split(d).join("") : o.push(c.label);
+    for (const c of i.parameters ?? []) {
+      const d = `[[:${c.id}]]`, u = r[c.label] ?? r[c.label.toLowerCase()] ?? Object.entries(r).find(([w]) => w.toLowerCase() === c.label.toLowerCase())?.[1];
+      u !== void 0 ? (l = l.split(d).join(u), _.push(c.label)) : c.optional ? l = l.split(d).join("") : o.push(c.label);
     }
     return {
       resolvedPrompt: l,
-      lensId: s.lens_id,
-      versionId: s.version_id,
-      lensTitle: s.title ?? t,
-      lensDescription: s.description ?? null,
+      lensId: i.lens_id,
+      versionId: i.version_id,
+      lensTitle: i.title ?? t,
+      lensDescription: i.description ?? null,
       paramsUsed: _,
       missing: o
     };
@@ -259,8 +317,8 @@ class C {
     if (!n) return [];
     const a = n.input_contract;
     if (!a) return [];
-    const s = a.parameters ?? a.inputs;
-    return Array.isArray(s) ? s : [];
+    const i = a.parameters ?? a.inputs;
+    return Array.isArray(i) ? i : [];
   }
   /**
    * Extract the parameters declared by a lens version — the contracts plus their labels.
@@ -273,19 +331,19 @@ class C {
    * Validate supplied values against a lens version's parameter contracts.
    */
   async validateParams(t, r) {
-    const e = await this.getParameterContracts(t), n = new Set(Object.keys(r).map((o) => o.toLowerCase())), a = new Set(e.map((o) => o.label.toLowerCase())), s = e.filter((o) => o.required && !n.has(o.label.toLowerCase())).map((o) => o.label), l = Object.keys(r).filter(
+    const e = await this.getParameterContracts(t), n = new Set(Object.keys(r).map((o) => o.toLowerCase())), a = new Set(e.map((o) => o.label.toLowerCase())), i = e.filter((o) => o.required && !n.has(o.label.toLowerCase())).map((o) => o.label), l = Object.keys(r).filter(
       (o) => !a.has(o.toLowerCase())
     );
     return {
-      valid: s.length === 0 && l.length === 0,
-      missing: s,
+      valid: i.length === 0 && l.length === 0,
+      missing: i,
       unknown: l,
       total: e.length,
       provided: Object.keys(r).length
     };
   }
 }
-class A {
+class S {
   constructor(t) {
     this.rpcClient = t;
   }
@@ -341,11 +399,11 @@ class A {
     const e = await this.getContractByVersion(t);
     if (!e)
       return { compatible: !1, missingScopes: [], warnings: ["Contract not found"] };
-    const n = e.body?.requiredScopes ?? [], a = r.filter((s) => !n.includes(s));
+    const n = e.body?.requiredScopes ?? [], a = r.filter((i) => !n.includes(i));
     return { compatible: a.length === 0, missingScopes: a, warnings: [] };
   }
 }
-class S {
+class $ {
   constructor(t) {
     this.rpcClient = t;
   }
@@ -367,8 +425,8 @@ class S {
     return typeof e == "string" ? e : "";
   }
 }
-const v = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]), $ = 3e3, E = 12e4;
-class O {
+const E = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]), O = 3e3, N = 12e4;
+class L {
   constructor(t) {
     this.rpcClient = t;
   }
@@ -449,14 +507,14 @@ class O {
       throw new Error(`@lenserfight/sdk: fn_mcp_workflow_run_logs failed — ${JSON.stringify(e)}`);
     const n = r?.node_results;
     return Array.isArray(n) ? n.map((a) => {
-      const s = a;
+      const i = a;
       return {
-        nodeId: s.node_id,
-        status: s.status,
-        result: s.result ?? null,
-        error: s.error ?? null,
-        durationMs: s.duration_ms ?? 0,
-        tokenCount: s.token_count ?? 0
+        nodeId: i.node_id,
+        status: i.status,
+        result: i.result ?? null,
+        error: i.error ?? null,
+        durationMs: i.duration_ms ?? 0,
+        tokenCount: i.token_count ?? 0
       };
     }) : [];
   }
@@ -468,11 +526,11 @@ class O {
    * @param timeoutMs Maximum wait time in milliseconds (default 120 s).
    */
   async awaitRun(t, r, e) {
-    const n = e?.timeoutMs ?? E, a = await this.startRun(t, r, e), s = Date.now() + n;
-    for (; Date.now() < s; ) {
-      await new Promise((o) => setTimeout(o, $));
+    const n = e?.timeoutMs ?? N, a = await this.startRun(t, r, e), i = Date.now() + n;
+    for (; Date.now() < i; ) {
+      await new Promise((o) => setTimeout(o, O));
       const l = await this.getRunStatus(a.id);
-      if (v.has(l.status)) {
+      if (E.has(l.status)) {
         if (l.status === "completed")
           return this.getRunLogs(a.id);
         throw new Error(`@lenserfight/sdk: workflow run ${a.id} ended with status "${l.status}"`);
@@ -490,7 +548,7 @@ class h {
   workflows;
   rpc;
   constructor(t) {
-    this.rpc = t, this.agents = new g(t), this.battles = new m(t), this.lenses = new C(t), this.protocols = new A(t), this.templates = new S(t), this.workflows = new O(t);
+    this.rpc = t, this.agents = new g(t), this.battles = new m(t), this.lenses = new A(t), this.protocols = new S(t), this.templates = new $(t), this.workflows = new L(t);
   }
   /**
    * Direct RPC escape hatch. Use sparingly — anything that's part of the
@@ -503,24 +561,24 @@ class h {
     return e;
   }
 }
-function N(i) {
-  const t = b(i);
+function M(s) {
+  const t = b(s);
   return new h(t);
 }
-function M(i) {
-  return new h(i);
+function J(s) {
+  return new h(s);
 }
-const L = "1.0.0";
+const T = "1.0.0";
 export {
   g as AgentClient,
   m as BattleClient,
-  C as LensClient,
+  A as LensClient,
   h as LenserFightClient,
-  A as ProtocolClient,
-  L as SDK_VERSION,
-  S as TemplateClient,
-  O as WorkflowClient,
-  N as createClient,
-  M as createClientFromRpc,
+  S as ProtocolClient,
+  T as SDK_VERSION,
+  $ as TemplateClient,
+  L as WorkflowClient,
+  M as createClient,
+  J as createClientFromRpc,
   b as createFetchRpcClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenserfight/sdk",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "LenserFight public client SDK — browse and execute lenses, workflows, battles, agents, and protocols from any Supabase-backed deployment",
   "license": "MIT",
   "main": "./index.cjs",