@lenserfight/sdk 0.3.0-alpha.9 → 2.1.0

package/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k=100;class C{constructor(t){this.rpcClient=t}async browse(t={},r,e=20){const n=Math.max(1,Math.min(e,k)),i={p_search:t.search??null,p_cursor_created_at:r?.created_at??null,p_cursor_id:r?.id??null,p_limit:n},{data:s,error:o}=await this.rpcClient.rpc("fn_sdk_browse_agents",i);if(o)throw new Error(`@lenserfight/sdk: fn_sdk_browse_agents failed — ${JSON.stringify(o)}`);return Array.isArray(s)?s:[]}async getById(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_sdk_get_agent_detail",{p_agent_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_sdk_get_agent_detail failed — ${JSON.stringify(e)}`);return r??null}async getLensBindings(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_sdk_get_agent_lens_bindings",{p_agent_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_sdk_get_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_sdk_get_agent_model_bindings",{p_agent_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_sdk_get_agent_model_bindings failed — ${JSON.stringify(e)}`);return Array.isArray(r)?r:[]}}const b=100;class u{constructor(t){this.rpcClient=t}async browse(t={},r,e=20){const n=Math.max(1,Math.min(e,b)),i={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:o}=await this.rpcClient.rpc("fn_browse_battles",i);if(o)throw new Error(`@lenserfight/sdk: browse failed — ${JSON.stringify(o)}`);return Array.isArray(s)?s:[]}}function w(a){if(!a.url)throw new Error("@lenserfight/sdk: createClient requires `url`");if(!a.anonKey)throw new Error("@lenserfight/sdk: createClient requires `anonKey`");const t=a.fetch??globalThis.fetch;if(typeof t!="function")throw new Error("@lenserfight/sdk: global fetch unavailable — pass `fetch` in options");const r=a.url.replace(/\/+$/,""),e=a.apiKey??a.anonKey;return{async rpc(n,i){const s=await t(`${r}/rest/v1/rpc/${n}`,{method:"POST",headers:{apikey:a.anonKey,authorization:`Bearer ${e}`,"content-type":"application/json"},body:JSON.stringify(i??{})});if(!s.ok){const c=await s.text().catch(()=>"");return{data:null,error:{status:s.status,message:c||s.statusText}}}return{data:await s.json().catch(()=>null),error:null}}}}const S=100;class h{constructor(t){this.rpcClient=t}async browse(t={},r,e=20){const n=Math.max(1,Math.min(e,S)),{data:i,error:s}=await this.rpcClient.rpc("fn_sdk_browse_lenses",{p_search:t.search??null,p_tag:t.tag??null,p_kind:t.kind??null,p_cursor_created_at:r?.created_at??null,p_cursor_id:r?.id??null,p_limit:n});if(s)throw new Error(`@lenserfight/sdk: fn_sdk_browse_lenses failed — ${JSON.stringify(s)}`);return Array.isArray(i)?i:[]}async search(t,r={},e,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:i}=await this.rpcClient.rpc("fn_mcp_lens_resolve_template",{p_lens_id:t,p_version_id:e?.versionId??null});if(i)throw new Error(`@lenserfight/sdk: fn_mcp_lens_resolve_template failed — ${JSON.stringify(i)}`);if(!n)throw new Error(`@lenserfight/sdk: lens ${t} not found`);const s=n;let o=s.template_body;const c=[],d=[];for(const l of s.parameters??[]){const f=`[[:${l.id}]]`,p=r[l.label]??r[l.label.toLowerCase()]??Object.entries(r).find(([m])=>m.toLowerCase()===l.label.toLowerCase())?.[1];p!==void 0?(o=o.split(f).join(p),d.push(l.label)):l.optional?o=o.split(f).join(""):c.push(l.label)}return{resolvedPrompt:o,lensId:s.lens_id,versionId:s.version_id,lensTitle:s.title??t,lensDescription:s.description??null,paramsUsed:d,missing:c}}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 i=n.input_contract;if(!i)return[];const s=i.parameters??i.inputs;return Array.isArray(s)?s:[]}}class E{constructor(t){this.rpcClient=t}async getContractByVersion(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_sdk_get_contract",{p_version_id:t,p_content_hash:null});if(e)throw new Error(`@lenserfight/sdk: fn_sdk_get_contract failed — ${JSON.stringify(e)}`);return r??null}async getContractByHash(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_sdk_get_contract",{p_version_id:null,p_content_hash:t});if(e)throw new Error(`@lenserfight/sdk: fn_sdk_get_contract failed — ${JSON.stringify(e)}`);return r??null}async getManifest(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_sdk_get_manifest",{p_version_id:t});if(e)throw new Error(`@lenserfight/sdk: fn_sdk_get_manifest failed — ${JSON.stringify(e)}`);return r??null}async getDependencies(t){const{data:r,error:e}=await this.rpcClient.rpc("fn_sdk_get_dependencies",{p_content_hash:t});if(e)throw new Error(`@lenserfight/sdk: fn_sdk_get_dependencies failed — ${JSON.stringify(e)}`);return Array.isArray(r)?r:[]}async checkCompatibility(t,r){const e=await this.getContractByHash(t);if(!e)return{compatible:!1,missingScopes:[],warnings:["Contract not found"]};const n=e.body.requiredScopes??[],i=r.filter(s=>!n.includes(s));return{compatible:i.length===0,missingScopes:i,warnings:[]}}}class g{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"]),A=3e3,v=12e4;class y{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:i}=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(i)throw new Error(`@lenserfight/sdk: fn_mcp_workflow_run_start failed — ${JSON.stringify(i)}`);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(i=>{const s=i;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??v,i=await this.startRun(t,r,e),s=Date.now()+n;for(;Date.now()<s;){await new Promise(c=>setTimeout(c,A));const o=await this.getRunStatus(i.id);if($.has(o.status)){if(o.status==="completed")return this.getRunLogs(i.id);throw new Error(`@lenserfight/sdk: workflow run ${i.id} ended with status "${o.status}"`)}}throw new Error(`@lenserfight/sdk: workflow run ${i.id} timed out after ${n}ms`)}}class _{agents;battles;lenses;protocols;templates;workflows;rpc;constructor(t){this.rpc=t,this.agents=new C(t),this.battles=new u(t),this.lenses=new h(t),this.protocols=new E(t),this.templates=new g(t),this.workflows=new y(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 O(a){const t=w(a);return new _(t)}function N(a){return new _(a)}const J="0.3.0-alpha.0";exports.BattleClient=u;exports.LensClient=h;exports.LenserFightClient=_;exports.SDK_VERSION=J;exports.TemplateClient=g;exports.WorkflowClient=y;exports.createClient=O;exports.createClientFromRpc=N;exports.createFetchRpcClient=w;
+"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;

package/index.d.ts

@@ -1,6 +1,8 @@
 export { createClient, createClientFromRpc, LenserFightClient } from './lib/lenserfight-client';
+export { AgentClient } from './lib/agent-client';
 export { BattleClient } from './lib/battle-client';
 export { LensClient } from './lib/lens-client';
+export { ProtocolClient } from './lib/protocol-client';
 export { TemplateClient } from './lib/template-client';
 export { WorkflowClient } from './lib/workflow-client';
 export { createFetchRpcClient } from './lib/client';
@@ -8,4 +10,6 @@ export type { SupabaseLikeRpcClient } from './lib/client';
 export type { BattleLifecycleStatus, BrowseFilters, BrowseCursor, BrowseBattle, BattleTemplate, CreateClientOptions, } from './lib/types';
 export type { LensBrowseFilters, SdkLensDetail, SdkLensKind, SdkLensParameter, SdkLensSummary, SdkLensVersion, SdkLensVersionSummary, SdkParameterTool, SdkResolvedTemplate, SdkVisibility, SdkContentStatus, } from './lib/types/lenses';
 export type { SdkWorkflowDetail, SdkWorkflowRun, SdkWorkflowRunLog, SdkWorkflowRunState, SdkWorkflowRunStatus, SdkWorkflowSummary, } from './lib/types/workflows';
-export declare const SDK_VERSION = "0.3.0-alpha.0";
+export type { AgentBrowseFilters, SdkAgentCapabilities, SdkAgentDetail, SdkAgentLensBinding, SdkAgentModelBinding, SdkAgentModelBindingMode, SdkAgentOwner, SdkAgentPage, SdkAgentRuntimePref, SdkAgentStats, SdkAgentSummary, } from './lib/types/agents';
+export type { SdkCompatibilityResult, SdkDependencyEdge, SdkLensContract, SdkLensContractBody, SdkLensManifest, SdkParameterContract, } from './lib/types/protocols';
+export declare const SDK_VERSION = "1.0.0";

package/index.mjs

@@ -1,64 +1,65 @@
-class u {
+class g {
   constructor(t) {
     this.rpcClient = t;
   }
   /**
-   * Browse public AI agents. Only agents with `is_public_policy = true` are visible.
-   * Keyset pagination on (created_at DESC, id DESC).
+   * List AI agents owned by `filters.ownerId`. Uses `fn_list_agents_by_owner`.
+   * Requires an authenticated client.
    */
-  async browse(t = {}, r, e = 20) {
-    const n = Math.max(1, Math.min(e, 100)), i = {
-      p_search: t.search ?? null,
-      p_cursor_created_at: r?.created_at ?? null,
-      p_cursor_id: r?.id ?? null,
-      p_limit: n
-    }, { data: s, error: o } = await this.rpcClient.rpc("fn_sdk_browse_agents", i);
-    if (o)
-      throw new Error(`@lenserfight/sdk: fn_sdk_browse_agents failed — ${JSON.stringify(o)}`);
-    return Array.isArray(s) ? s : [];
+  async browse(t, r = 20) {
+    const e = Math.max(1, Math.min(r, 100)), { 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 };
   }
   /**
-   * Get public agent profile detail. Returns null for non-public or non-existent agents.
+   * Get agent profile detail by agent ID. Uses `fn_get_agent_profile`.
    */
   async getById(t) {
-    const { data: r, error: e } = await this.rpcClient.rpc("fn_sdk_get_agent_detail", {
-      p_agent_id: 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_sdk_get_agent_detail failed — ${JSON.stringify(e)}`
+        `@lenserfight/sdk: fn_get_agent_profile failed — ${JSON.stringify(e)}`
       );
     return r ?? null;
   }
   /**
-   * Get lens bindings for a public agent.
+   * Get lens bindings for an agent. Uses `fn_list_agent_lens_bindings`.
    */
   async getLensBindings(t) {
-    const { data: r, error: e } = await this.rpcClient.rpc("fn_sdk_get_agent_lens_bindings", {
-      p_agent_id: 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_sdk_get_agent_lens_bindings failed — ${JSON.stringify(e)}`
+        `@lenserfight/sdk: fn_list_agent_lens_bindings failed — ${JSON.stringify(e)}`
       );
     return Array.isArray(r) ? r : [];
   }
   /**
-   * Get model bindings for a public agent.
+   * Get model bindings for an agent. Uses `fn_list_agent_model_bindings`.
    */
   async getModelBindings(t) {
-    const { data: r, error: e } = await this.rpcClient.rpc("fn_sdk_get_agent_model_bindings", {
-      p_agent_id: 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_sdk_get_agent_model_bindings failed — ${JSON.stringify(e)}`
+        `@lenserfight/sdk: fn_list_agent_model_bindings failed — ${JSON.stringify(e)}`
       );
     return Array.isArray(r) ? r : [];
   }
 }
-const h = 100;
-class g {
+const y = 100;
+class m {
   constructor(t) {
     this.rpcClient = t;
   }
@@ -70,77 +71,115 @@ class g {
    * For deeper paging, pass the last row's `{created_at, id}` as `cursor`.
    */
   async browse(t = {}, r, e = 20) {
-    const n = Math.max(1, Math.min(e, h)), i = {
+    const n = Math.max(1, Math.min(e, y)), 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: o } = await this.rpcClient.rpc("fn_browse_battles", i);
-    if (o)
+    }, { data: s, error: l } = await this.rpcClient.rpc("fn_browse_battles", a);
+    if (l)
       throw new Error(
-        `@lenserfight/sdk: browse failed — ${JSON.stringify(o)}`
+        `@lenserfight/sdk: browse failed — ${JSON.stringify(l)}`
       );
     return Array.isArray(s) ? s : [];
   }
 }
-function y(a) {
-  if (!a.url)
+function b(i) {
+  if (!i.url)
     throw new Error("@lenserfight/sdk: createClient requires `url`");
-  if (!a.anonKey)
+  if (!i.anonKey)
     throw new Error("@lenserfight/sdk: createClient requires `anonKey`");
-  const t = a.fetch ?? globalThis.fetch;
+  const t = i.fetch ?? globalThis.fetch;
   if (typeof t != "function")
     throw new Error("@lenserfight/sdk: global fetch unavailable — pass `fetch` in options");
-  const r = a.url.replace(/\/+$/, ""), e = a.apiKey ?? a.anonKey;
+  const r = i.url.replace(/\/+$/, ""), e = i.apiKey ?? i.anonKey;
   return {
-    async rpc(n, i) {
+    async rpc(n, a) {
       const s = await t(`${r}/rest/v1/rpc/${n}`, {
         method: "POST",
         headers: {
-          apikey: a.anonKey,
+          apikey: i.anonKey,
           authorization: `Bearer ${e}`,
           "content-type": "application/json"
         },
-        body: JSON.stringify(i ?? {})
+        body: JSON.stringify(a ?? {})
       });
       if (!s.ok) {
-        const c = await s.text().catch(() => "");
+        const o = await s.text().catch(() => "");
         return {
           data: null,
-          error: { status: s.status, message: c || s.statusText }
+          error: { status: s.status, message: o || s.statusText }
         };
       }
       return { data: await s.json().catch(() => null), error: null };
     }
   };
 }
-const m = 100;
-class k {
+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(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 C {
   constructor(t) {
     this.rpcClient = t;
   }
   /**
-   * Browse public lenses. Keyset pagination on (created_at DESC, id DESC).
+   * Browse public lenses. Uses fn_mcp_lens_list (offset pagination).
+   * For text search, uses fn_mcp_lens_search instead.
+   * Requires an authenticated client.
    */
-  async browse(t = {}, r, e = 20) {
-    const n = Math.max(1, Math.min(e, m)), { data: i, error: s } = await this.rpcClient.rpc("fn_sdk_browse_lenses", {
-      p_search: t.search ?? null,
-      p_tag: t.tag ?? null,
-      p_kind: t.kind ?? null,
-      p_cursor_created_at: r?.created_at ?? null,
-      p_cursor_id: r?.id ?? null,
-      p_limit: n
+  async browse(t = {}, r = 0, e = 20) {
+    const n = Math.max(1, Math.min(e, k));
+    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 u(l).map(p);
+    }
+    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_sdk_browse_lenses failed — ${JSON.stringify(s)}`);
-    return Array.isArray(i) ? i : [];
+      throw new Error(`@lenserfight/sdk: fn_mcp_lens_list failed — ${JSON.stringify(s)}`);
+    return u(a).map(p);
   }
   /**
    * Full-text search across public lenses.
    */
-  async search(t, r = {}, e, n = 20) {
+  async search(t, r = {}, e = 0, n = 20) {
     return this.browse({ ...r, search: t }, e, n);
   }
   /**
@@ -178,37 +217,31 @@ class k {
    * filled prompt and lists which parameters were used or missing.
    *
    * Requires an authenticated client (`apiKey` in `createClient`).
-   *
-   * @example
-   *   const result = await lf.lenses.resolveTemplate(lensId, { Topic: 'TypeScript' });
-   *   if (result.missing.length === 0) {
-   *     // pass result.resolvedPrompt to your AI model
-   *   }
    */
   async resolveTemplate(t, r, e) {
-    const { data: n, error: i } = await this.rpcClient.rpc("fn_mcp_lens_resolve_template", {
+    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 (i)
-      throw new Error(`@lenserfight/sdk: fn_mcp_lens_resolve_template failed — ${JSON.stringify(i)}`);
+    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 o = s.template_body;
-    const c = [], _ = [];
-    for (const l of s.parameters ?? []) {
-      const d = `[[:${l.id}]]`, f = r[l.label] ?? r[l.label.toLowerCase()] ?? Object.entries(r).find(([w]) => w.toLowerCase() === l.label.toLowerCase())?.[1];
-      f !== void 0 ? (o = o.split(d).join(f), _.push(l.label)) : l.optional ? o = o.split(d).join("") : c.push(l.label);
+    let l = s.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);
     }
     return {
-      resolvedPrompt: o,
+      resolvedPrompt: l,
       lensId: s.lens_id,
       versionId: s.version_id,
       lensTitle: s.title ?? t,
       lensDescription: s.description ?? null,
       paramsUsed: _,
-      missing: c
+      missing: o
     };
   }
   /**
@@ -224,77 +257,95 @@ class k {
     if (!r) return [];
     const n = Array.isArray(r) ? r[0] : r;
     if (!n) return [];
-    const i = n.input_contract;
-    if (!i) return [];
-    const s = i.parameters ?? i.inputs;
+    const a = n.input_contract;
+    if (!a) return [];
+    const s = a.parameters ?? a.inputs;
     return Array.isArray(s) ? s : [];
   }
+  /**
+   * Extract the parameters declared by a lens version — the contracts plus their labels.
+   */
+  async extractParams(t) {
+    const r = await this.getParameterContracts(t);
+    return { params: r, labels: r.map((e) => e.label) };
+  }
+  /**
+   * 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(
+      (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 C {
+class A {
   constructor(t) {
     this.rpcClient = t;
   }
   /**
-   * Get the contract for a lens version (by version_id).
-   * Uses `fn_sdk_get_contract(p_version_id)`.
+   * Get the input contract for a lens version. Uses `fn_get_version_contracts`.
+   * Note: contentHash, publishedBy, publishedAt are not available from this function.
    */
   async getContractByVersion(t) {
-    const { data: r, error: e } = await this.rpcClient.rpc("fn_sdk_get_contract", {
-      p_version_id: t,
-      p_content_hash: null
+    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_sdk_get_contract failed — ${JSON.stringify(e)}`);
-    return r ?? null;
+      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;
   }
   /**
-   * Get a contract by its content hash (hex-encoded SHA-256).
-   * Uses `fn_sdk_get_contract(p_content_hash)`.
+   * Hash-based contract lookup is not supported by the current DB schema.
+   * Always returns null.
    */
   async getContractByHash(t) {
-    const { data: r, error: e } = await this.rpcClient.rpc("fn_sdk_get_contract", {
-      p_version_id: null,
-      p_content_hash: t
-    });
-    if (e)
-      throw new Error(`@lenserfight/sdk: fn_sdk_get_contract failed — ${JSON.stringify(e)}`);
-    return r ?? null;
+    return null;
   }
   /**
-   * Get the full manifest (contract + channel + signatures) for a version.
+   * Get the manifest for a lens version. Built from `fn_get_version_contracts`.
+   * Channel and signatures are not available.
    */
   async getManifest(t) {
-    const { data: r, error: e } = await this.rpcClient.rpc("fn_sdk_get_manifest", {
-      p_version_id: t
-    });
-    if (e)
-      throw new Error(`@lenserfight/sdk: fn_sdk_get_manifest failed — ${JSON.stringify(e)}`);
-    return r ?? null;
+    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;
   }
   /**
-   * Get dependency edges for a contract (its children in the DAG).
+   * Dependency graph lookup is not supported by the current DB schema.
+   * Always returns an empty array.
    */
   async getDependencies(t) {
-    const { data: r, error: e } = await this.rpcClient.rpc("fn_sdk_get_dependencies", {
-      p_content_hash: t
-    });
-    if (e)
-      throw new Error(`@lenserfight/sdk: fn_sdk_get_dependencies failed — ${JSON.stringify(e)}`);
-    return Array.isArray(r) ? r : [];
+    return [];
   }
   /**
-   * Check if a contract satisfies required scopes. Pure client-side logic —
-   * fetches the contract and compares scopes locally.
+   * Check if a lens version satisfies required scopes. Fetches the contract
+   * via `getContractByVersion` and compares scopes locally.
    */
   async checkCompatibility(t, r) {
-    const e = await this.getContractByHash(t);
+    const e = await this.getContractByVersion(t);
     if (!e)
       return { compatible: !1, missingScopes: [], warnings: ["Contract not found"] };
-    const n = e.body.requiredScopes ?? [], i = r.filter((s) => !n.includes(s));
-    return { compatible: i.length === 0, missingScopes: i, warnings: [] };
+    const n = e.body?.requiredScopes ?? [], a = r.filter((s) => !n.includes(s));
+    return { compatible: a.length === 0, missingScopes: a, warnings: [] };
   }
 }
-class b {
+class S {
   constructor(t) {
     this.rpcClient = t;
   }
@@ -316,8 +367,8 @@ class b {
     return typeof e == "string" ? e : "";
   }
 }
-const S = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]), $ = 3e3, E = 12e4;
-class A {
+const v = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]), $ = 3e3, E = 12e4;
+class O {
   constructor(t) {
     this.rpcClient = t;
   }
@@ -355,15 +406,15 @@ class A {
    * Requires an authenticated client (`apiKey` in `createClient`).
    */
   async startRun(t, r, e) {
-    const { data: n, error: i } = await this.rpcClient.rpc("fn_mcp_workflow_run_start", {
+    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 (i)
-      throw new Error(`@lenserfight/sdk: fn_mcp_workflow_run_start failed — ${JSON.stringify(i)}`);
+    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;
@@ -397,8 +448,8 @@ class A {
     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((i) => {
-      const s = i;
+    return Array.isArray(n) ? n.map((a) => {
+      const s = a;
       return {
         nodeId: s.node_id,
         status: s.status,
@@ -417,20 +468,20 @@ class A {
    * @param timeoutMs Maximum wait time in milliseconds (default 120 s).
    */
   async awaitRun(t, r, e) {
-    const n = e?.timeoutMs ?? E, i = await this.startRun(t, r, e), s = Date.now() + n;
+    const n = e?.timeoutMs ?? E, a = await this.startRun(t, r, e), s = Date.now() + n;
     for (; Date.now() < s; ) {
-      await new Promise((c) => setTimeout(c, $));
-      const o = await this.getRunStatus(i.id);
-      if (S.has(o.status)) {
-        if (o.status === "completed")
-          return this.getRunLogs(i.id);
-        throw new Error(`@lenserfight/sdk: workflow run ${i.id} ended with status "${o.status}"`);
+      await new Promise((o) => setTimeout(o, $));
+      const l = await this.getRunStatus(a.id);
+      if (v.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 ${i.id} timed out after ${n}ms`);
+    throw new Error(`@lenserfight/sdk: workflow run ${a.id} timed out after ${n}ms`);
   }
 }
-class p {
+class h {
   agents;
   battles;
   lenses;
@@ -439,12 +490,11 @@ class p {
   workflows;
   rpc;
   constructor(t) {
-    this.rpc = t, this.agents = new u(t), this.battles = new g(t), this.lenses = new k(t), this.protocols = new C(t), this.templates = new b(t), this.workflows = new A(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);
   }
   /**
    * Direct RPC escape hatch. Use sparingly — anything that's part of the
-   * stable surface should live on `battles` / `templates` (or get added there
-   * in a follow-up PR).
+   * stable surface should live on a named sub-client.
    */
   async rpcCall(t, r) {
     const { data: e, error: n } = await this.rpc.rpc(t, r);
@@ -453,22 +503,24 @@ class p {
     return e;
   }
 }
-function v(a) {
-  const t = y(a);
-  return new p(t);
+function N(i) {
+  const t = b(i);
+  return new h(t);
 }
-function O(a) {
-  return new p(a);
+function M(i) {
+  return new h(i);
 }
-const N = "0.3.0-alpha.0";
+const L = "1.0.0";
 export {
-  g as BattleClient,
-  k as LensClient,
-  p as LenserFightClient,
-  N as SDK_VERSION,
-  b as TemplateClient,
-  A as WorkflowClient,
-  v as createClient,
-  O as createClientFromRpc,
-  y as createFetchRpcClient
+  g as AgentClient,
+  m as BattleClient,
+  C as LensClient,
+  h as LenserFightClient,
+  A as ProtocolClient,
+  L as SDK_VERSION,
+  S as TemplateClient,
+  O as WorkflowClient,
+  N as createClient,
+  M as createClientFromRpc,
+  b as createFetchRpcClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenserfight/sdk",
-  "version": "0.3.0-alpha.9",
+  "version": "2.1.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",