@lenserfight/sdk 0.2.0-alpha.9 → 0.3.0-alpha.10

package/README.md

@@ -58,4 +58,4 @@ surface.
 
 For the deeper walkthrough see the [SDK quickstart](https://docs.lenserfight.com/how-to/integrations/sdk-quickstart) and the [reference docs](https://docs.lenserfight.com/reference/sdk).
 
-Apache-2.0.
+MIT.

package/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=100;class l{constructor(t){this.rpcClient=t}rpcClient;async browse(t={},r,e=20){const n=Math.max(1,Math.min(e,h)),s={p_search:t.search??null,p_cursor_created_at:r?.created_at??null,p_cursor_id:r?.id??null,p_limit:n},{data:i,error:c}=await this.rpcClient.rpc("fn_sdk_browse_agents",s);if(c)throw new Error(`@lenserfight/sdk: fn_sdk_browse_agents failed — ${JSON.stringify(c)}`);return Array.isArray(i)?i:[]}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 u=100;class _{constructor(t){this.rpcClient=t}rpcClient;async browse(t={},r,e=20){const n=Math.max(1,Math.min(e,u)),s={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:i,error:c}=await this.rpcClient.rpc("fn_browse_battles",s);if(c)throw new Error(`@lenserfight/sdk: browse failed — ${JSON.stringify(c)}`);return Array.isArray(i)?i:[]}}function d(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(/\/+$/,"");return{async rpc(e,n){const s=await t(`${r}/rest/v1/rpc/${e}`,{method:"POST",headers:{apikey:a.anonKey,authorization:`Bearer ${a.anonKey}`,"content-type":"application/json"},body:JSON.stringify(n??{})});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 w=100;class p{constructor(t){this.rpcClient=t}rpcClient;async browse(t={},r,e=20){const n=Math.max(1,Math.min(e,w)),{data:s,error:i}=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(i)throw new Error(`@lenserfight/sdk: fn_sdk_browse_lenses failed — ${JSON.stringify(i)}`);return Array.isArray(s)?s:[]}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 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 s=n.input_contract;if(!s)return[];const i=s.parameters??s.inputs;return Array.isArray(i)?i:[]}}class f{constructor(t){this.rpcClient=t}rpcClient;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??[],s=r.filter(i=>!n.includes(i));return{compatible:s.length===0,missingScopes:s,warnings:[]}}}class g{constructor(t){this.rpcClient=t}rpcClient;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:""}}class o{battles;templates;lenses;agents;protocols;rpc;constructor(t){this.rpc=t,this.battles=new _(t),this.templates=new g(t),this.lenses=new p(t),this.agents=new l(t),this.protocols=new f(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 y(a){const t=d(a);return new o(t)}function C(a){return new o(a)}const m="0.2.0-alpha.1";exports.AgentClient=l;exports.BattleClient=_;exports.LensClient=p;exports.LenserFightClient=o;exports.ProtocolClient=f;exports.SDK_VERSION=m;exports.TemplateClient=g;exports.createClient=y;exports.createClientFromRpc=C;exports.createFetchRpcClient=d;
+"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;

package/index.d.ts

@@ -1,13 +1,11 @@
 export { createClient, createClientFromRpc, LenserFightClient } from './lib/lenserfight-client';
 export { BattleClient } from './lib/battle-client';
-export { TemplateClient } from './lib/template-client';
 export { LensClient } from './lib/lens-client';
-export { AgentClient } from './lib/agent-client';
-export { ProtocolClient } from './lib/protocol-client';
+export { TemplateClient } from './lib/template-client';
+export { WorkflowClient } from './lib/workflow-client';
 export { createFetchRpcClient } from './lib/client';
 export type { SupabaseLikeRpcClient } from './lib/client';
 export type { BattleLifecycleStatus, BrowseFilters, BrowseCursor, BrowseBattle, BattleTemplate, CreateClientOptions, } from './lib/types';
-export type { SdkLensKind, SdkVisibility, SdkContentStatus, SdkLensAuthor, SdkLensTag, SdkLensSummary, SdkLensDetail, SdkLensVersionSummary, SdkLensVersion, SdkLensParameter, SdkParameterTool, LensBrowseFilters, } from './lib/types/lenses';
-export type { SdkAgentRuntimePref, SdkAgentModelBindingMode, SdkAgentSummary, SdkAgentDetail, SdkAgentCapabilities, SdkAgentStats, SdkAgentOwner, SdkAgentLensBinding, SdkAgentModelBinding, AgentBrowseFilters, } from './lib/types/agents';
-export type { SdkContractKind, SdkChannel, SdkSignatureAlgorithm, SdkParameterClassification, SdkParameterKind, SdkParameterScope, SdkDependencyBinding, SdkParameterDefault, SdkParameterValidation, SdkParameterContract, SdkOutputDefinition, SdkDependencyReference, SdkLensContractBody, SdkLensContract, SdkContractSignature, SdkLensManifest, SdkDependencyEdge, SdkCompatibilityResult, } from './lib/types/protocols';
-export declare const SDK_VERSION = "0.2.0-alpha.1";
+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";

package/index.mjs

@@ -1,69 +1,67 @@
-class l {
-  constructor(r) {
-    this.rpcClient = r;
+class u {
+  constructor(t) {
+    this.rpcClient = t;
   }
-  rpcClient;
   /**
    * Browse public AI agents. Only agents with `is_public_policy = true` are visible.
    * Keyset pagination on (created_at DESC, id DESC).
    */
-  async browse(r = {}, t, e = 20) {
-    const n = Math.max(1, Math.min(e, 100)), s = {
-      p_search: r.search ?? null,
-      p_cursor_created_at: t?.created_at ?? null,
-      p_cursor_id: t?.id ?? null,
+  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: i, error: c } = await this.rpcClient.rpc("fn_sdk_browse_agents", s);
-    if (c)
-      throw new Error(`@lenserfight/sdk: fn_sdk_browse_agents failed — ${JSON.stringify(c)}`);
-    return Array.isArray(i) ? i : [];
+    }, { 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 : [];
   }
   /**
    * Get public agent profile detail. Returns null for non-public or non-existent agents.
    */
-  async getById(r) {
-    const { data: t, error: e } = await this.rpcClient.rpc("fn_sdk_get_agent_detail", {
-      p_agent_id: r
+  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 t ?? null;
+    return r ?? null;
   }
   /**
    * Get lens bindings for a public agent.
    */
-  async getLensBindings(r) {
-    const { data: t, error: e } = await this.rpcClient.rpc("fn_sdk_get_agent_lens_bindings", {
-      p_agent_id: r
+  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(t) ? t : [];
+    return Array.isArray(r) ? r : [];
   }
   /**
    * Get model bindings for a public agent.
    */
-  async getModelBindings(r) {
-    const { data: t, error: e } = await this.rpcClient.rpc("fn_sdk_get_agent_model_bindings", {
-      p_agent_id: 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(t) ? t : [];
+    return Array.isArray(r) ? r : [];
   }
 }
-const _ = 100;
-class d {
-  constructor(r) {
-    this.rpcClient = r;
+const h = 100;
+class g {
+  constructor(t) {
+    this.rpcClient = t;
   }
-  rpcClient;
   /**
    * Browse public battles. Calls `public.fn_browse_battles` (SECURITY DEFINER,
    * grants EXECUTE to anon + authenticated). Returns at most 100 rows per call
@@ -71,41 +69,41 @@ class d {
    *
    * For deeper paging, pass the last row's `{created_at, id}` as `cursor`.
    */
-  async browse(r = {}, t, e = 20) {
-    const n = Math.max(1, Math.min(e, _)), s = {
-      p_search: r.search ?? null,
-      p_category: r.category ?? null,
-      p_status: r.status ?? null,
-      p_cursor_created_at: t?.created_at ?? null,
-      p_cursor_id: t?.id ?? null,
+  async browse(t = {}, r, e = 20) {
+    const n = Math.max(1, Math.min(e, h)), 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: i, error: c } = await this.rpcClient.rpc("fn_browse_battles", s);
-    if (c)
+    }, { data: s, error: o } = await this.rpcClient.rpc("fn_browse_battles", i);
+    if (o)
       throw new Error(
-        `@lenserfight/sdk: browse failed — ${JSON.stringify(c)}`
+        `@lenserfight/sdk: browse failed — ${JSON.stringify(o)}`
       );
-    return Array.isArray(i) ? i : [];
+    return Array.isArray(s) ? s : [];
   }
 }
-function p(a) {
+function y(a) {
   if (!a.url)
     throw new Error("@lenserfight/sdk: createClient requires `url`");
   if (!a.anonKey)
     throw new Error("@lenserfight/sdk: createClient requires `anonKey`");
-  const r = a.fetch ?? globalThis.fetch;
-  if (typeof r != "function")
+  const t = a.fetch ?? globalThis.fetch;
+  if (typeof t != "function")
     throw new Error("@lenserfight/sdk: global fetch unavailable — pass `fetch` in options");
-  const t = a.url.replace(/\/+$/, "");
+  const r = a.url.replace(/\/+$/, ""), e = a.apiKey ?? a.anonKey;
   return {
-    async rpc(e, n) {
-      const s = await r(`${t}/rest/v1/rpc/${e}`, {
+    async rpc(n, i) {
+      const s = await t(`${r}/rest/v1/rpc/${n}`, {
         method: "POST",
         headers: {
           apikey: a.anonKey,
-          authorization: `Bearer ${a.anonKey}`,
+          authorization: `Bearer ${e}`,
           "content-type": "application/json"
         },
-        body: JSON.stringify(n ?? {})
+        body: JSON.stringify(i ?? {})
       });
       if (!s.ok) {
         const c = await s.text().catch(() => "");
@@ -118,162 +116,198 @@ function p(a) {
     }
   };
 }
-const f = 100;
-class h {
-  constructor(r) {
-    this.rpcClient = r;
+const m = 100;
+class k {
+  constructor(t) {
+    this.rpcClient = t;
   }
-  rpcClient;
   /**
    * Browse public lenses. Keyset pagination on (created_at DESC, id DESC).
    */
-  async browse(r = {}, t, e = 20) {
-    const n = Math.max(1, Math.min(e, f)), { data: s, error: i } = await this.rpcClient.rpc("fn_sdk_browse_lenses", {
-      p_search: r.search ?? null,
-      p_tag: r.tag ?? null,
-      p_kind: r.kind ?? null,
-      p_cursor_created_at: t?.created_at ?? null,
-      p_cursor_id: t?.id ?? null,
+  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
     });
-    if (i)
-      throw new Error(`@lenserfight/sdk: fn_sdk_browse_lenses failed — ${JSON.stringify(i)}`);
-    return Array.isArray(s) ? s : [];
+    if (s)
+      throw new Error(`@lenserfight/sdk: fn_sdk_browse_lenses failed — ${JSON.stringify(s)}`);
+    return Array.isArray(i) ? i : [];
   }
   /**
    * Full-text search across public lenses.
    */
-  async search(r, t = {}, e, n = 20) {
-    return this.browse({ ...t, search: r }, e, n);
+  async search(t, r = {}, e, n = 20) {
+    return this.browse({ ...r, search: t }, e, n);
   }
   /**
    * Get full lens detail. Reuses existing `fn_get_lens_detail_bootstrap`.
    */
-  async getById(r) {
-    const { data: t, error: e } = await this.rpcClient.rpc("fn_get_lens_detail_bootstrap", {
-      p_lens_id: r
+  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 !t || t.error ? null : t;
+    return !r || r.error ? null : r;
   }
   /**
    * Get a specific version with parameters. Combines existing RPCs:
    * `fn_get_lens_version_detail` + `fn_get_lens_version_parameters`.
    */
-  async getVersion(r) {
-    const [t, e] = await Promise.all([
-      this.rpcClient.rpc("fn_get_lens_version_detail", { p_version_id: r }),
-      this.rpcClient.rpc("fn_get_lens_version_parameters", { p_version_id: 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 (t.error)
-      throw new Error(`@lenserfight/sdk: fn_get_lens_version_detail failed — ${JSON.stringify(t.error)}`);
-    if (!t.data) return null;
-    const n = Array.isArray(t.data) ? t.data[0] : t.data;
+    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;
   }
+  /**
+   * Resolve a lens template by substituting `[[:paramId]]` tokens with the
+   * supplied values (matched by parameter label, case-insensitive). Returns the
+   * 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", {
+      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 = [], _ = [];
+    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);
+    }
+    return {
+      resolvedPrompt: o,
+      lensId: s.lens_id,
+      versionId: s.version_id,
+      lensTitle: s.title ?? t,
+      lensDescription: s.description ?? null,
+      paramsUsed: _,
+      missing: c
+    };
+  }
   /**
    * Get parameter contracts for a version via `fn_get_version_contracts`.
    * Returns the input_contract's parameter array if present.
    */
-  async getParameterContracts(r) {
-    const { data: t, error: e } = await this.rpcClient.rpc("fn_get_version_contracts", {
-      p_version_id: r
+  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 (!t) return [];
-    const n = Array.isArray(t) ? t[0] : t;
+    if (!r) return [];
+    const n = Array.isArray(r) ? r[0] : r;
     if (!n) return [];
-    const s = n.input_contract;
-    if (!s) return [];
-    const i = s.parameters ?? s.inputs;
-    return Array.isArray(i) ? i : [];
+    const i = n.input_contract;
+    if (!i) return [];
+    const s = i.parameters ?? i.inputs;
+    return Array.isArray(s) ? s : [];
   }
 }
-class g {
-  constructor(r) {
-    this.rpcClient = r;
+class C {
+  constructor(t) {
+    this.rpcClient = t;
   }
-  rpcClient;
   /**
    * Get the contract for a lens version (by version_id).
    * Uses `fn_sdk_get_contract(p_version_id)`.
    */
-  async getContractByVersion(r) {
-    const { data: t, error: e } = await this.rpcClient.rpc("fn_sdk_get_contract", {
-      p_version_id: r,
+  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 t ?? null;
+    return r ?? null;
   }
   /**
    * Get a contract by its content hash (hex-encoded SHA-256).
    * Uses `fn_sdk_get_contract(p_content_hash)`.
    */
-  async getContractByHash(r) {
-    const { data: t, error: e } = await this.rpcClient.rpc("fn_sdk_get_contract", {
+  async getContractByHash(t) {
+    const { data: r, error: e } = await this.rpcClient.rpc("fn_sdk_get_contract", {
       p_version_id: null,
-      p_content_hash: r
+      p_content_hash: t
     });
     if (e)
       throw new Error(`@lenserfight/sdk: fn_sdk_get_contract failed — ${JSON.stringify(e)}`);
-    return t ?? null;
+    return r ?? null;
   }
   /**
    * Get the full manifest (contract + channel + signatures) for a version.
    */
-  async getManifest(r) {
-    const { data: t, error: e } = await this.rpcClient.rpc("fn_sdk_get_manifest", {
-      p_version_id: r
+  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 t ?? null;
+    return r ?? null;
   }
   /**
    * Get dependency edges for a contract (its children in the DAG).
    */
-  async getDependencies(r) {
-    const { data: t, error: e } = await this.rpcClient.rpc("fn_sdk_get_dependencies", {
-      p_content_hash: r
+  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(t) ? t : [];
+    return Array.isArray(r) ? r : [];
   }
   /**
    * Check if a contract satisfies required scopes. Pure client-side logic —
    * fetches the contract and compares scopes locally.
    */
-  async checkCompatibility(r, t) {
-    const e = await this.getContractByHash(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 ?? [], s = t.filter((i) => !n.includes(i));
-    return { compatible: s.length === 0, missingScopes: s, warnings: [] };
+    const n = e.body.requiredScopes ?? [], i = r.filter((s) => !n.includes(s));
+    return { compatible: i.length === 0, missingScopes: i, warnings: [] };
   }
 }
-class u {
-  constructor(r) {
-    this.rpcClient = r;
+class b {
+  constructor(t) {
+    this.rpcClient = t;
   }
-  rpcClient;
   /**
    * Render a template's task_prompt with the supplied variable values.
    * Calls `public.fn_battles_render_prompt` (SECURITY DEFINER, EXEC granted
    * to anon + authenticated). Required variables that are missing raise
    * 22023 — the SDK surfaces the server error verbatim.
    */
-  async renderPrompt(r, t = {}) {
+  async renderPrompt(t, r = {}) {
     const { data: e, error: n } = await this.rpcClient.rpc("fn_battles_render_prompt", {
-      p_template_id: r,
-      p_variables: t
+      p_template_id: t,
+      p_variables: r
     });
     if (n)
       throw new Error(
@@ -282,45 +316,159 @@ class u {
     return typeof e == "string" ? e : "";
   }
 }
-class o {
+const S = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]), $ = 3e3, E = 12e4;
+class A {
+  constructor(t) {
+    this.rpcClient = t;
+  }
+  /**
+   * List workflows visible to the authenticated user.
+   */
+  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 : [];
+  }
+  /**
+   * Get a single workflow by ID.
+   */
+  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;
+  }
+  /**
+   * Start a workflow run. Returns immediately with a run ID and `pending` status.
+   * The workflow executes asynchronously — use `getRunStatus` to poll or
+   * `awaitRun` to block until completion.
+   *
+   * 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", {
+      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;
+  }
+  /**
+   * Get the current status of a workflow run.
+   */
+  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
+    };
+  }
+  /**
+   * Get per-node execution logs for a completed run.
+   */
+  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
+      };
+    }) : [];
+  }
+  /**
+   * Start a workflow run and poll until it reaches a terminal state
+   * (`completed`, `failed`, or `cancelled`). Returns the run logs on success
+   * and throws on failure or timeout.
+   *
+   * @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;
+    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}"`);
+      }
+    }
+    throw new Error(`@lenserfight/sdk: workflow run ${i.id} timed out after ${n}ms`);
+  }
+}
+class p {
+  agents;
   battles;
-  templates;
   lenses;
-  agents;
   protocols;
+  templates;
+  workflows;
   rpc;
-  constructor(r) {
-    this.rpc = r, this.battles = new d(r), this.templates = new u(r), this.lenses = new h(r), this.agents = new l(r), this.protocols = new g(r);
+  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);
   }
   /**
    * 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).
    */
-  async rpcCall(r, t) {
-    const { data: e, error: n } = await this.rpc.rpc(r, t);
+  async rpcCall(t, r) {
+    const { data: e, error: n } = await this.rpc.rpc(t, r);
     if (n)
-      throw new Error(`@lenserfight/sdk: ${r} failed — ${JSON.stringify(n)}`);
+      throw new Error(`@lenserfight/sdk: ${t} failed — ${JSON.stringify(n)}`);
     return e;
   }
 }
-function w(a) {
-  const r = p(a);
-  return new o(r);
+function v(a) {
+  const t = y(a);
+  return new p(t);
 }
-function y(a) {
-  return new o(a);
+function O(a) {
+  return new p(a);
 }
-const m = "0.2.0-alpha.1";
+const N = "0.3.0-alpha.0";
 export {
-  l as AgentClient,
-  d as BattleClient,
-  h as LensClient,
-  o as LenserFightClient,
-  g as ProtocolClient,
-  m as SDK_VERSION,
-  u as TemplateClient,
-  w as createClient,
-  y as createClientFromRpc,
-  p as createFetchRpcClient
+  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
 };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@lenserfight/sdk",
-  "version": "0.2.0-alpha.9",
-  "description": "LenserFight public client SDK — read battles, lenses, agents, protocols, and templates from any Supabase-backed deployment",
-  "license": "Apache-2.0",
+  "version": "0.3.0-alpha.10",
+  "description": "LenserFight public client SDK — browse and execute lenses, workflows, battles, agents, and protocols from any Supabase-backed deployment",
+  "license": "MIT",
   "main": "./index.cjs",
   "module": "./index.mjs",
   "types": "./index.d.ts",
@@ -24,9 +24,7 @@
     "ai-agents",
     "supabase",
     "evaluation",
-    "battles",
-    "lenses",
-    "protocols"
+    "battles"
   ],
   "repository": {
     "type": "git",
@@ -36,7 +34,7 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/",
-    "tag": "alpha"
+    "tag": "latest"
   },
   "peerDependencies": {
     "@supabase/supabase-js": "^2.0.0"