@arcproof/sdk-elizaos 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,16 @@
 # @arcproof/sdk-elizaos
 
-ElizaOS plugin adapter for [`@arcproof/sdk`](../sdk): expose a bonded, independently-verified, real-payment flow as a real ElizaOS `Action`/`Plugin`.
+ElizaOS adapter for [`@arcproof/sdk`](../sdk): the full orchestrator → specialists → evaluator → real-payment flow, as a real ElizaOS `Action`/`Plugin`.
+
+**A standalone alternative to [`@arcproof/sdk-langchain`](../sdk-langchain), not an add-on.** This package ships its own native orchestrator + specialist builders (`createElizaOrchestrator`, `createElizaClaimGatherer`) that run entirely on ElizaOS's own model API (`runtime.useModel`) -- **zero LangChain dependency**. So `@arcproof/sdk` + `@arcproof/sdk-elizaos` alone gives you the complete pipeline; you never need `@arcproof/sdk-langchain` unless you specifically want LangChain.
+
+```text
+orchestrator (createElizaOrchestrator)   -- picks which specialists a request needs
+specialist   (createElizaClaimGatherer)  -- runs its tools, drafts claims via runtime.useModel
+evaluator    (@arcproof/sdk's VerifierRegistry) -- independently verifies, zero LLM calls
+```
+
+Pick this or `@arcproof/sdk-langchain` based purely on which agent framework your product already runs on -- the trust layer (verification + on-chain payment, in `@arcproof/sdk` core) is identical either way.
 
 ## Install
 
@@ -8,26 +18,81 @@ ElizaOS plugin adapter for [`@arcproof/sdk`](../sdk): expose a bonded, independe
 npm install @arcproof/sdk @arcproof/sdk-elizaos @elizaos/core
 ```
 
-## Usage
+## Usage A -- standalone (native ElizaOS, no LangChain)
+
+Real, working code from [`examples/defi-diligence-agent`](../../examples/defi-diligence-agent) (`src/shared-native.ts` + `src/elizaos-native.ts`). The three specialists (`onchain-agent-v1`, `news-agent-v1`, `compliance-agent-v1`) are built with this package's own `createElizaClaimGatherer`, and the orchestrator with `createElizaOrchestrator` -- all on `runtime.useModel`, no LangChain anywhere. Verified live on Arc testnet: orchestrator plan → specialists → deterministic verification against live DefiLlama/CoinGecko/Snapshot data → real per-specialist payout, `ACCEPT`.
+
+```ts
+import { createElizaClaimGatherer, createElizaOrchestrator, createArcProofAction, type ElizaTool } from "@arcproof/sdk-elizaos";
+import { VerifierRegistry, ARC_TESTNET } from "@arcproof/sdk";
+
+// A tool is a plain async fn returning a text result (or an "ERROR: ..." line
+// the model is told to skip) -- no LangChain tool() wrapper.
+const fetchTvl: ElizaTool = {
+  name: "fetch_tvl",
+  description: "Fetch a protocol's live TVL in USD.",
+  run: async (ctx) => `tvl_usd=${await lookUpTvl(ctx.protocolSlug)} source=... simulated=false`,
+};
+
+const onchain = createElizaClaimGatherer({
+  agentId: "onchain-agent-v1",
+  tools: [fetchTvl /*, ... */],
+  claimTypes: ["tvl", "price_change", "wallet_flow", "token_concentration"],
+  systemPrompt: "You are the on-chain data specialist. Draft one claim per metric your tools returned; copy values verbatim.",
+});
+
+// Orchestrator picks which specialists a given request needs.
+const gatherClaims = createElizaOrchestrator({
+  specialists: [{ id: "onchain-agent-v1", description: "On-chain data: TVL, price, wallet flow, concentration.", gatherClaims: onchain } /*, news, compliance */],
+});
+
+const action = createArcProofAction({
+  name: "DEFI_TREASURY_DILIGENCE",
+  description: "Independently verifies protocol claims before treasury deployment, paying each specialist only if its claims check out.",
+  trustedAgentConfig: { network: ARC_TESTNET, contractAddress, verifiers /* VerifierRegistry, one entry per claim_type */ },
+  requester, settler, providerAddresses,
+  budgetAmount: 0.3,
+  gatherClaims, // the native ElizaOS orchestrator -- createArcProofAction injects runtime.useModel into its context automatically
+  buildContext: (message) => ({ protocolSlug: "uniswap", requestText: message.content.text }),
+});
+```
+
+`createArcProofAction`'s handler injects the ElizaOS `runtime` it receives into the job context, so the native gatherers reach `runtime.useModel` without you wiring anything -- the `gatherClaims(context)` signature stays framework-agnostic.
+
+## Usage B -- reuse a LangChain orchestrator (if you already have one)
+
+If your specialists are already built with [`@arcproof/sdk-langchain`](../sdk-langchain), you can pass its orchestrator straight into `createArcProofAction` -- ElizaOS never has to know the difference. Real, working code from [`examples/lending-apr-agent`](../../examples/lending-apr-agent) (`src/elizaos-demo.ts` + `src/shared.ts`), verified live.
 
 ```ts
 import { createArcProofAction, createArcProofPlugin } from "@arcproof/sdk-elizaos";
+import { createLangChainOrchestrator } from "@arcproof/sdk-langchain";
 import { VerifierRegistry, ARC_TESTNET } from "@arcproof/sdk";
+import { getModel, makeSpecialists, makeVerifiers } from "./shared.js"; // same file the LangChain-only entrypoint uses
+
+const model = await getModel();
+const specialists = makeSpecialists(model); // lending-apr-agent-v1 + lending-eligibility-agent-v1
+const verifiers = makeVerifiers(); // one VerifierRegistry entry per claim_type, deterministic
+
+// The orchestrator IS the gatherClaims the ElizaOS action calls -- no
+// separate ElizaOS-specific planning logic needed. Could just as easily be
+// a single createLangChainClaimGatherer() instead of a full orchestrator;
+// ElizaOS never has to know the difference, it just sees the reply either way.
+const gatherClaims = createLangChainOrchestrator({
+  model,
+  specialists,
+  buildPlanningMessage: (context) => `Request: ${context.requestText}\nLoan id: ${context.loanId}`,
+});
 
 const action = createArcProofAction({
   name: "CHECK_TRUE_APR",
-  description: "Independently verifies a loan's true APR before answering, paying the specialist only if it checks out.",
-  trustedAgentConfig: { network: ARC_TESTNET, contractAddress, verifiers: myVerifierRegistry },
+  description: "Independently verifies a loan's true APR and borrower eligibility before answering, paying each specialist only if their claim checks out.",
+  trustedAgentConfig: { network: ARC_TESTNET, contractAddress, verifiers },
   requester, // WalletCredential
   settler, // WalletCredential
   providerAddresses: { "lending-apr-agent-v1": "0x...", "lending-eligibility-agent-v1": "0x..." },
-  budgetAmount: 0.05,
-  // gatherClaims can be a single @arcproof/sdk-langchain gatherer, or a full
-  // orchestrator (createLangChainOrchestrator) that itself decides which
-  // specialists this specific request needs -- ElizaOS never has to know
-  // the difference, it just sees the natural-language reply either way.
-  gatherClaims: myOrchestratorOrGatherer,
-  buildContext: (message) => ({ loanId: extractLoanId(message.content.text), requestText: message.content.text }),
+  budgetAmount: 0.06,
+  gatherClaims,
+  buildContext: (message) => ({ loanId: "loan-001", requestText: message.content.text }),
 });
 
 const plugin = createArcProofPlugin({
@@ -45,6 +110,13 @@ const plugin = createArcProofPlugin({
 
 This package defines structurally-identical local types (`ElizaAction`, `ElizaPlugin`, etc.) instead of depending on that fragile export path. TypeScript's structural typing makes the objects this package builds assignable to the real `Action`/`Plugin` types wherever your actual ElizaOS runtime code expects them -- `@elizaos/core` is still a declared peer dependency because you need the real package installed to run an agent at all.
 
+## Worked examples (real, verified live)
+
+Both ship an `elizaos-demo.ts` that drives the exact same specialists as their LangChain entrypoint through a real `ElizaAction.handler` -- proving the two adapters are interchangeable, not two different products:
+
+- [`examples/defi-diligence-agent`](../../examples/defi-diligence-agent) -- the real `onchain-agent-v1`/`news-agent-v1`/`compliance-agent-v1` DeFi specialists.
+- [`examples/lending-apr-agent`](../../examples/lending-apr-agent) -- a different vertical (lending true-APR + eligibility).
+
 ## License
 
 MIT

package/dist/elizaAgent.d.ts

@@ -0,0 +1,59 @@
+import type { Claim } from "@arcproof/sdk";
+/** The one ElizaOS runtime method these builders need. `@elizaos/core`'s
+ * IAgentRuntime satisfies this structurally -- kept as a minimal local
+ * type for the same import-ambiguity reason documented in index.ts. */
+export interface ElizaModelRuntime {
+    useModel: (modelType: string, params: {
+        prompt: string;
+        schema?: unknown;
+        output?: "object" | "array" | "enum";
+        temperature?: number;
+    }) => Promise<unknown>;
+}
+/** Key under which createArcProofAction stashes the ElizaOS runtime in the job context. */
+export declare const ELIZA_RUNTIME_CONTEXT_KEY = "__elizaRuntime";
+/** A plain data-fetching tool -- returns a text result (same "tool output"
+ * convention as the LangChain adapter: state the value, or an "ERROR: ..."
+ * line the model is told to treat as "skip that data point"). */
+export interface ElizaTool {
+    name: string;
+    description: string;
+    run: (context: Record<string, unknown>) => Promise<string>;
+}
+export interface ElizaClaimGathererOptions {
+    /** Becomes claim.provider_agent_id on every claim this specialist drafts. */
+    agentId: string;
+    tools: ElizaTool[];
+    /** Restrict claim_type to this set (documented in the prompt) -- optional. */
+    claimTypes?: string[];
+    systemPrompt: string;
+    /** Builds the request line from the job context. Defaults to JSON.stringify(context minus the runtime). */
+    buildUserMessage?: (context: Record<string, unknown>) => string;
+}
+/**
+ * Wraps a set of tools + a prompt as a `gatherClaims()` function that runs
+ * on ElizaOS's own model runtime. Resilient by design: if the model call
+ * fails, it logs and returns zero claims rather than throwing --
+ * runTrustedJob's hasCheckableClaims guard turns "this provider produced
+ * nothing" into a refund, not a false accept.
+ */
+export declare function createElizaClaimGatherer(options: ElizaClaimGathererOptions): (context: Record<string, unknown>) => Promise<Claim[]>;
+export interface ElizaSpecialistDescriptor {
+    id: string;
+    description: string;
+    gatherClaims: (context: Record<string, unknown>) => Promise<Claim[]>;
+}
+export interface ElizaOrchestratorOptions {
+    specialists: ElizaSpecialistDescriptor[];
+    buildPlanningMessage?: (context: Record<string, unknown>) => string;
+    systemPromptPrefix?: string;
+}
+/**
+ * Builds a `gatherClaims()` that first asks ElizaOS's model which
+ * registered specialists this specific request needs, then runs only
+ * those and merges their claims -- the ElizaOS-native equivalent of
+ * @arcproof/sdk-langchain's createLangChainOrchestrator, with no LangChain
+ * dependency. A genuine planning failure propagates (runTrustedJob refunds);
+ * a successful-but-empty plan defaults to engaging every specialist.
+ */
+export declare function createElizaOrchestrator(options: ElizaOrchestratorOptions): (context: Record<string, unknown>) => Promise<Claim[]>;

package/dist/elizaAgent.js

@@ -0,0 +1,183 @@
+/**
+ * Native ElizaOS orchestrator + specialist builders -- the piece that
+ * makes @arcproof/sdk-elizaos a genuine STANDALONE alternative to
+ * @arcproof/sdk-langchain, not an add-on that requires it.
+ *
+ * These build claim-gathering functions that run entirely on ElizaOS's
+ * own model API (`runtime.useModel(ModelType.OBJECT_LARGE, ...)`), with
+ * zero LangChain dependency. So `@arcproof/sdk` + `@arcproof/sdk-elizaos`
+ * alone gives the full orchestrator -> specialists -> evaluator pipeline:
+ *   orchestrator (createElizaOrchestrator)   -- picks which specialists a request needs
+ *   specialist   (createElizaClaimGatherer)  -- runs its tools, drafts claims
+ *   evaluator    (@arcproof/sdk's VerifierRegistry) -- independently verifies, zero LLM
+ *
+ * How the ElizaOS model runtime reaches these functions: createArcProofAction
+ * injects the `runtime` it receives in its handler into the job `context`
+ * (context.__elizaRuntime), and these read it back out. That keeps the
+ * gatherClaims signature `(context) => Promise<Claim[]>` identical to the
+ * LangChain adapter's, so an ArcProof action doesn't care which framework
+ * built its gatherer.
+ *
+ * Design note -- deterministic tool invocation, LLM claim drafting: unlike
+ * LangChain's createReactAgent (an LLM tool-*calling* loop where the model
+ * chooses which tools to invoke), a specialist here runs all its declared
+ * tools, then hands the raw results to one structured-output model call
+ * that drafts claims. This is deliberate: it's far more reliable than
+ * parsing multi-turn tool-call JSON out of ElizaOS's plain useModel, and
+ * for these specialists the tool choice is trivial anyway (the on-chain
+ * agent calls all four of its tools every time). The genuinely LLM-shaped
+ * work -- deciding how to phrase each claim, copying values verbatim,
+ * omitting data points a tool couldn't produce -- still runs through the
+ * model, exactly as in the LangChain path.
+ */
+import { randomUUID } from "node:crypto";
+const OBJECT_LARGE = "OBJECT_LARGE"; // ModelType.OBJECT_LARGE
+/** Key under which createArcProofAction stashes the ElizaOS runtime in the job context. */
+export const ELIZA_RUNTIME_CONTEXT_KEY = "__elizaRuntime";
+function runtimeFrom(context) {
+    const rt = context[ELIZA_RUNTIME_CONTEXT_KEY];
+    if (!rt || typeof rt.useModel !== "function") {
+        throw new Error("no ElizaOS runtime in context -- createEliza* gatherers must be run through createArcProofAction " +
+            "(which injects runtime), or you must set context." + ELIZA_RUNTIME_CONTEXT_KEY + " yourself.");
+    }
+    return rt;
+}
+const CLAIMS_SCHEMA = {
+    type: "object",
+    properties: {
+        claims: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    claim_type: { type: "string" },
+                    claim_text: { type: "string" },
+                    // claim_value / simulated are strings on purpose (not JSON boolean/
+                    // number) -- same defensive convention the LangChain adapter uses,
+                    // so a provider that stringifies "false"/"182000000" round-trips
+                    // cleanly. @arcproof/sdk's toBool/toNumber coerce them back.
+                    claim_value: { type: "string" },
+                    provider_source: { type: "string" },
+                    simulated: { type: "string" },
+                },
+                required: ["claim_type", "claim_text", "claim_value", "provider_source"],
+            },
+        },
+    },
+    required: ["claims"],
+};
+/**
+ * Wraps a set of tools + a prompt as a `gatherClaims()` function that runs
+ * on ElizaOS's own model runtime. Resilient by design: if the model call
+ * fails, it logs and returns zero claims rather than throwing --
+ * runTrustedJob's hasCheckableClaims guard turns "this provider produced
+ * nothing" into a refund, not a false accept.
+ */
+export function createElizaClaimGatherer(options) {
+    return async function gatherClaims(context) {
+        const jobId = context.jobId ?? randomUUID();
+        let drafts = [];
+        try {
+            const runtime = runtimeFrom(context);
+            // Run every tool, collect its text result.
+            const toolResults = await Promise.all(options.tools.map(async (t) => {
+                try {
+                    return `${t.name}: ${await t.run(context)}`;
+                }
+                catch (e) {
+                    return `${t.name}: ERROR: ${e}`;
+                }
+            }));
+            const userMsg = options.buildUserMessage
+                ? options.buildUserMessage(context)
+                : JSON.stringify(Object.fromEntries(Object.entries(context).filter(([k]) => k !== ELIZA_RUNTIME_CONTEXT_KEY)));
+            const claimTypeHint = options.claimTypes?.length
+                ? `\n\nUse only these claim_type values: ${options.claimTypes.join(", ")}.`
+                : "";
+            const prompt = `${options.systemPrompt}${claimTypeHint}\n\n` +
+                `Request:\n${userMsg}\n\n` +
+                `Data gathered from your tools (copy values verbatim; if a line starts with ERROR, omit that claim):\n` +
+                `${toolResults.join("\n")}\n\n` +
+                `Return a JSON object with a "claims" array. For claim_value and simulated, write the literal string ` +
+                `form (e.g. "182000000", "true", "false") copied verbatim -- never a paraphrase.`;
+            const result = (await runtime.useModel(OBJECT_LARGE, { prompt, schema: CLAIMS_SCHEMA, output: "object", temperature: 0 }));
+            drafts = Array.isArray(result?.claims) ? result.claims : [];
+        }
+        catch (e) {
+            console.log(`[${options.agentId}]   ! ElizaOS model call failed (${e}) -- no claims produced this call`);
+            drafts = [];
+        }
+        return drafts.map((d) => {
+            const simulated = String(d.simulated ?? "false").toLowerCase() === "true";
+            // Defensive: `response_format: json_object` guarantees valid JSON but
+            // NOT schema adherence, so some models omit claim_text even though the
+            // schema marks it required (observed with gpt-oss-20b). Synthesize a
+            // readable one from the fields that are present rather than surfacing
+            // "undefined" in the memo. claim_value is what verification actually
+            // uses, so a missing claim_text is cosmetic, not a correctness issue.
+            const claimText = d.claim_text || `${d.claim_type} = ${d.claim_value}`;
+            console.log(`[${options.agentId}]   ${d.claim_type} claim: ${claimText} (simulated=${simulated})`);
+            return {
+                claim_id: randomUUID(),
+                job_id: jobId,
+                provider_agent_id: options.agentId,
+                claim_type: d.claim_type,
+                claim_text: claimText,
+                claim_value: d.claim_value,
+                provider_source: d.provider_source,
+                simulated,
+                verification_status: "pending",
+            };
+        });
+    };
+}
+const PLAN_SCHEMA = {
+    type: "object",
+    properties: {
+        specialist_ids: { type: "array", items: { type: "string" } },
+        reasoning: { type: "string" },
+    },
+    required: ["specialist_ids", "reasoning"],
+};
+/**
+ * Builds a `gatherClaims()` that first asks ElizaOS's model which
+ * registered specialists this specific request needs, then runs only
+ * those and merges their claims -- the ElizaOS-native equivalent of
+ * @arcproof/sdk-langchain's createLangChainOrchestrator, with no LangChain
+ * dependency. A genuine planning failure propagates (runTrustedJob refunds);
+ * a successful-but-empty plan defaults to engaging every specialist.
+ */
+export function createElizaOrchestrator(options) {
+    const specialistIds = options.specialists.map((s) => s.id);
+    if (specialistIds.length === 0)
+        throw new Error("createElizaOrchestrator: at least one specialist is required");
+    return async function gatherClaims(context) {
+        const runtime = runtimeFrom(context);
+        const systemPrompt = (options.systemPromptPrefix ?? "You are the orchestrator for a bonded, independently-verified agent network. ") +
+            "Given a request, decide which specialist agents to engage. Each specialist costs the requester's budget, " +
+            "so only pick ones actually relevant to the request:\n\n" +
+            options.specialists.map((s) => `- ${s.id}: ${s.description}`).join("\n") +
+            `\n\nReturn a JSON object: specialist_ids (array, a subset of the ids above) and reasoning (one sentence).`;
+        const userMsg = options.buildPlanningMessage
+            ? options.buildPlanningMessage(context)
+            : (context.requestText ?? JSON.stringify(context));
+        // No try/catch: a genuine planning failure should reach runTrustedJob's refund path.
+        const plan = (await runtime.useModel(OBJECT_LARGE, {
+            prompt: `${systemPrompt}\n\nRequest:\n${userMsg}`,
+            schema: PLAN_SCHEMA,
+            output: "object",
+            temperature: 0,
+        }));
+        let selectedIds = (plan.specialist_ids ?? []).filter((id) => specialistIds.includes(id));
+        if (!selectedIds.length)
+            selectedIds = specialistIds;
+        console.log(`[orchestrator] plan: [${selectedIds.join(", ")}] -- ${plan.reasoning ?? ""}`);
+        const chosen = options.specialists.filter((s) => selectedIds.includes(s.id));
+        const results = await Promise.all(chosen.map((s) => s.gatherClaims(context).catch((e) => {
+            console.log(`[orchestrator]   ! ${s.id} threw (${e}) -- treating as zero claims from it`);
+            return [];
+        })));
+        return results.flat();
+    };
+}
+//# sourceMappingURL=elizaAgent.js.map

package/dist/elizaAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elizaAgent.js","sourceRoot":"","sources":["../src/elizaAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAazC,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,yBAAyB;AAE9D,2FAA2F;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;AAE1D,SAAS,WAAW,CAAC,OAAgC;IACnD,MAAM,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAAkC,CAAC;IAC/E,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,mGAAmG;YACjG,mDAAmD,GAAG,yBAAyB,GAAG,YAAY,CACjG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAgCD,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,oEAAoE;oBACpE,mEAAmE;oBACnE,iEAAiE;oBACjE,6DAA6D;oBAC7D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC/B,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACnC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC9B;gBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,CAAC;aACzE;SACF;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAkC;IAElC,OAAO,KAAK,UAAU,YAAY,CAAC,OAAgC;QACjE,MAAM,KAAK,GAAI,OAAO,CAAC,KAA4B,IAAI,UAAU,EAAE,CAAC;QACpE,IAAI,MAAM,GAAiB,EAAE,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YAErC,2CAA2C;YAC3C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;gBAC5B,IAAI,CAAC;oBACH,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9C,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,GAAG,CAAC,CAAC,IAAI,YAAY,CAAC,EAAE,CAAC;gBAClC,CAAC;YACH,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB;gBACtC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC;gBACnC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,yBAAyB,CAAC,CAAC,CAAC,CAAC;YAEjH,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,MAAM;gBAC9C,CAAC,CAAC,yCAAyC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC3E,CAAC,CAAC,EAAE,CAAC;YAEP,MAAM,MAAM,GACV,GAAG,OAAO,CAAC,YAAY,GAAG,aAAa,MAAM;gBAC7C,aAAa,OAAO,MAAM;gBAC1B,uGAAuG;gBACvG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;gBAC/B,sGAAsG;gBACtG,iFAAiF,CAAC;YAEpF,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAExH,CAAC;YACF,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,oCAAoC,CAAC,mCAAmC,CAAC,CAAC;YACzG,MAAM,GAAG,EAAE,CAAC;QACd,CAAC;QAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;YAC1E,sEAAsE;YACtE,uEAAuE;YACvE,qEAAqE;YACrE,sEAAsE;YACtE,qEAAqE;YACrE,sEAAsE;YACtE,MAAM,SAAS,GAAG,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,OAAO,CAAC,CAAC,UAAU,WAAW,SAAS,eAAe,SAAS,GAAG,CAAC,CAAC;YACnG,OAAO;gBACL,QAAQ,EAAE,UAAU,EAAE;gBACtB,MAAM,EAAE,KAAK;gBACb,iBAAiB,EAAE,OAAO,CAAC,OAAO;gBAClC,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,eAAe,EAAE,CAAC,CAAC,eAAe;gBAClC,SAAS;gBACT,mBAAmB,EAAE,SAAkB;aACxC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAgBD,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC5D,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC9B;IACD,QAAQ,EAAE,CAAC,gBAAgB,EAAE,WAAW,CAAC;CAC1C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAiC;IAEjC,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAEhH,OAAO,KAAK,UAAU,YAAY,CAAC,OAAgC;QACjE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAErC,MAAM,YAAY,GAChB,CAAC,OAAO,CAAC,kBAAkB,IAAI,+EAA+E,CAAC;YAC/G,2GAA2G;YAC3G,yDAAyD;YACzD,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACxE,2GAA2G,CAAC;QAE9G,MAAM,OAAO,GAAG,OAAO,CAAC,oBAAoB;YAC1C,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC;YACvC,CAAC,CAAC,CAAE,OAAO,CAAC,WAAkC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAE7E,qFAAqF;QACrF,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE;YACjD,MAAM,EAAE,GAAG,YAAY,iBAAiB,OAAO,EAAE;YACjD,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;SACf,CAAC,CAAsD,CAAC;QAEzD,IAAI,WAAW,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,WAAW,CAAC,MAAM;YAAE,WAAW,GAAG,aAAa,CAAC;QAErD,OAAO,CAAC,GAAG,CAAC,yBAAyB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC,CAAC;QAE3F,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACf,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YAClC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,EAAE,WAAW,CAAC,sCAAsC,CAAC,CAAC;YAC1F,OAAO,EAAa,CAAC;QACvB,CAAC,CAAC,CACH,CACF,CAAC;QACF,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { type TrustedAgentConfig, type SettlementResult, type Claim, type WalletCredential } from "@arcproof/sdk";
+export * from "./elizaAgent.js";
 export interface ElizaContent {
     text?: string;
     [key: string]: unknown;

package/dist/index.js

@@ -28,6 +28,8 @@
  */
 import { randomUUID } from "node:crypto";
 import { runTrustedJob } from "@arcproof/sdk";
+import { ELIZA_RUNTIME_CONTEXT_KEY } from "./elizaAgent.js";
+export * from "./elizaAgent.js";
 function defaultFormatResponse(result) {
     const lines = [`Verdict: ${result.overall_verdict.toUpperCase()} (paid ${result.total_paid_usdc.toFixed(4)})`, ""];
     for (const c of result.claims) {
@@ -49,9 +51,13 @@ export function createArcProofAction(options) {
         similes: options.similes ?? [],
         examples: options.examples ?? [],
         validate: options.validate ?? (async () => true),
-        handler: async (_runtime, message, state, _handlerOptions, callback) => {
+        handler: async (runtime, message, state, _handlerOptions, callback) => {
             const jobId = randomUUID();
-            const context = { jobId, ...options.buildContext(message, state) };
+            // Inject the ElizaOS runtime into the job context so native
+            // createEliza* gatherers can reach runtime.useModel without changing
+            // the framework-agnostic gatherClaims(context) signature. A LangChain
+            // gatherer simply ignores this key; an ElizaOS-native one reads it.
+            const context = { jobId, [ELIZA_RUNTIME_CONTEXT_KEY]: runtime, ...options.buildContext(message, state) };
             try {
                 const params = {
                     jobId,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@arcproof/sdk-elizaos",
-  "version": "0.1.0",
-  "description": "ElizaOS plugin for @arcproof/sdk -- expose a bonded, independently-verified, real-payment action inside an ElizaOS agent.",
+  "version": "0.2.0",
+  "description": "ElizaOS plugin for @arcproof/sdk -- native orchestrator + specialist builders (runtime.useModel, no LangChain needed) plus the Action/Plugin wrapper, for a bonded, independently-verified, real-payment agent.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",