@absol-labs/agent 0.1.0

package/dist/frameworks/eliza.d.ts

@@ -0,0 +1,393 @@
+import type { Content, Plugin } from "@elizaos/core";
+import { z } from "zod/v3";
+import { type DiscoverServicesOptions, type ServiceListing } from "../discovery/registry.js";
+import { type MandateAuthorizedStreamActionInput, type ReclaimAuthorizedStreamInput, type ReclaimVerifiedStreamResult, type StreamProofTransactionResult, type StreamStatusView, type VerifiedStreamAgentOpener } from "../sdk/client.js";
+/**
+ * Base Sepolia is the only settlement network Metrik supports today (Model A,
+ * single-chain USDC on Base).
+ */
+export declare const METRIK_ELIZA_SETTLEMENT_CHAIN_ID = 84532;
+declare const discoverActionSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    category?: string | undefined;
+    limit?: number | undefined;
+}, {
+    category?: string | undefined;
+    limit?: number | undefined;
+}>;
+declare const hireActionSchema: z.ZodObject<{
+    operator: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+    serviceRef: z.ZodEffects<z.ZodString, string, string>;
+    budgetUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+    ratePerSecondUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+    maxDurationSeconds: z.ZodNumber;
+    signedMandate: z.ZodObject<{
+        mandateId: z.ZodEffects<z.ZodString, string, string>;
+        owner: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+        chainId: z.ZodNumber;
+        issuedAt: z.ZodNumber;
+        mandate: z.ZodObject<{
+            maxPerStreamUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+            maxTotalUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+            maxRatePerSecondUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+            maxDurationSeconds: z.ZodNumber;
+            allowedOperators: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, `0x${string}`, string>, "many">>;
+            expiresAt: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            maxPerStreamUsdc: string;
+            maxTotalUsdc: string;
+            maxRatePerSecondUsdc: string;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        }, {
+            maxDurationSeconds: number;
+            expiresAt: number;
+            maxPerStreamUsdc?: unknown;
+            maxTotalUsdc?: unknown;
+            maxRatePerSecondUsdc?: unknown;
+            allowedOperators?: string[] | undefined;
+        }>;
+        signature: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        mandateId: string;
+        owner: `0x${string}`;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: string;
+            maxTotalUsdc: string;
+            maxRatePerSecondUsdc: string;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        };
+        signature: string;
+    }, {
+        mandateId: string;
+        owner: string;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxDurationSeconds: number;
+            expiresAt: number;
+            maxPerStreamUsdc?: unknown;
+            maxTotalUsdc?: unknown;
+            maxRatePerSecondUsdc?: unknown;
+            allowedOperators?: string[] | undefined;
+        };
+        signature: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    maxDurationSeconds: number;
+    signedMandate: {
+        mandateId: string;
+        owner: `0x${string}`;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: string;
+            maxTotalUsdc: string;
+            maxRatePerSecondUsdc: string;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        };
+        signature: string;
+    };
+    operator: `0x${string}`;
+    serviceRef: string;
+    ratePerSecondUsdc: string;
+    budgetUsdc: string;
+}, {
+    maxDurationSeconds: number;
+    signedMandate: {
+        mandateId: string;
+        owner: string;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxDurationSeconds: number;
+            expiresAt: number;
+            maxPerStreamUsdc?: unknown;
+            maxTotalUsdc?: unknown;
+            maxRatePerSecondUsdc?: unknown;
+            allowedOperators?: string[] | undefined;
+        };
+        signature: string;
+    };
+    operator: string;
+    serviceRef: string;
+    ratePerSecondUsdc?: unknown;
+    budgetUsdc?: unknown;
+}>;
+declare const streamStatusActionSchema: z.ZodObject<{
+    streamId: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    streamId: string;
+}, {
+    streamId: string;
+}>;
+declare const reclaimActionSchema: z.ZodObject<{
+    streamId: z.ZodEffects<z.ZodString, string, string>;
+    closeFirst: z.ZodOptional<z.ZodBoolean>;
+    signedMandate: z.ZodObject<{
+        mandateId: z.ZodEffects<z.ZodString, string, string>;
+        owner: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+        chainId: z.ZodNumber;
+        issuedAt: z.ZodNumber;
+        mandate: z.ZodObject<{
+            maxPerStreamUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+            maxTotalUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+            maxRatePerSecondUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+            maxDurationSeconds: z.ZodNumber;
+            allowedOperators: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, `0x${string}`, string>, "many">>;
+            expiresAt: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            maxPerStreamUsdc: string;
+            maxTotalUsdc: string;
+            maxRatePerSecondUsdc: string;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        }, {
+            maxDurationSeconds: number;
+            expiresAt: number;
+            maxPerStreamUsdc?: unknown;
+            maxTotalUsdc?: unknown;
+            maxRatePerSecondUsdc?: unknown;
+            allowedOperators?: string[] | undefined;
+        }>;
+        signature: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        mandateId: string;
+        owner: `0x${string}`;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: string;
+            maxTotalUsdc: string;
+            maxRatePerSecondUsdc: string;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        };
+        signature: string;
+    }, {
+        mandateId: string;
+        owner: string;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxDurationSeconds: number;
+            expiresAt: number;
+            maxPerStreamUsdc?: unknown;
+            maxTotalUsdc?: unknown;
+            maxRatePerSecondUsdc?: unknown;
+            allowedOperators?: string[] | undefined;
+        };
+        signature: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    streamId: string;
+    signedMandate: {
+        mandateId: string;
+        owner: `0x${string}`;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: string;
+            maxTotalUsdc: string;
+            maxRatePerSecondUsdc: string;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        };
+        signature: string;
+    };
+    closeFirst?: boolean | undefined;
+}, {
+    streamId: string;
+    signedMandate: {
+        mandateId: string;
+        owner: string;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxDurationSeconds: number;
+            expiresAt: number;
+            maxPerStreamUsdc?: unknown;
+            maxTotalUsdc?: unknown;
+            maxRatePerSecondUsdc?: unknown;
+            allowedOperators?: string[] | undefined;
+        };
+        signature: string;
+    };
+    closeFirst?: boolean | undefined;
+}>;
+declare const closeActionSchema: z.ZodObject<{
+    streamId: z.ZodEffects<z.ZodString, string, string>;
+    signedMandate: z.ZodObject<{
+        mandateId: z.ZodEffects<z.ZodString, string, string>;
+        owner: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+        chainId: z.ZodNumber;
+        issuedAt: z.ZodNumber;
+        mandate: z.ZodObject<{
+            maxPerStreamUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+            maxTotalUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+            maxRatePerSecondUsdc: z.ZodEffects<z.ZodString, string, unknown>;
+            maxDurationSeconds: z.ZodNumber;
+            allowedOperators: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, `0x${string}`, string>, "many">>;
+            expiresAt: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            maxPerStreamUsdc: string;
+            maxTotalUsdc: string;
+            maxRatePerSecondUsdc: string;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        }, {
+            maxDurationSeconds: number;
+            expiresAt: number;
+            maxPerStreamUsdc?: unknown;
+            maxTotalUsdc?: unknown;
+            maxRatePerSecondUsdc?: unknown;
+            allowedOperators?: string[] | undefined;
+        }>;
+        signature: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        mandateId: string;
+        owner: `0x${string}`;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: string;
+            maxTotalUsdc: string;
+            maxRatePerSecondUsdc: string;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        };
+        signature: string;
+    }, {
+        mandateId: string;
+        owner: string;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxDurationSeconds: number;
+            expiresAt: number;
+            maxPerStreamUsdc?: unknown;
+            maxTotalUsdc?: unknown;
+            maxRatePerSecondUsdc?: unknown;
+            allowedOperators?: string[] | undefined;
+        };
+        signature: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    streamId: string;
+    signedMandate: {
+        mandateId: string;
+        owner: `0x${string}`;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: string;
+            maxTotalUsdc: string;
+            maxRatePerSecondUsdc: string;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        };
+        signature: string;
+    };
+}, {
+    streamId: string;
+    signedMandate: {
+        mandateId: string;
+        owner: string;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxDurationSeconds: number;
+            expiresAt: number;
+            maxPerStreamUsdc?: unknown;
+            maxTotalUsdc?: unknown;
+            maxRatePerSecondUsdc?: unknown;
+            allowedOperators?: string[] | undefined;
+        };
+        signature: string;
+    };
+}>;
+/**
+ * Canonical ElizaOS action names (UPPER_SNAKE_CASE) the Metrik plugin registers.
+ */
+export declare const METRIK_ELIZA_ACTION_NAMES: {
+    readonly DISCOVER: "DISCOVER_SERVICES";
+    readonly HIRE: "HIRE_VERIFIED_SERVICE";
+    readonly STATUS: "CHECK_STREAM_STATUS";
+    readonly RECLAIM: "RECLAIM_UNSPENT";
+    readonly CLOSE: "CLOSE_STREAM";
+};
+export type MetrikElizaActionName = "DISCOVER_SERVICES" | "HIRE_VERIFIED_SERVICE" | "CHECK_STREAM_STATUS" | "RECLAIM_UNSPENT" | "CLOSE_STREAM";
+export interface MetrikElizaActionInputs {
+    readonly DISCOVER_SERVICES: z.input<typeof discoverActionSchema>;
+    readonly HIRE_VERIFIED_SERVICE: z.input<typeof hireActionSchema>;
+    readonly CHECK_STREAM_STATUS: z.input<typeof streamStatusActionSchema>;
+    readonly RECLAIM_UNSPENT: z.input<typeof reclaimActionSchema>;
+    readonly CLOSE_STREAM: z.input<typeof closeActionSchema>;
+}
+export interface MetrikElizaMandateStateResolver {
+    getSpentSoFarUsdc(owner: `0x${string}`): Promise<bigint>;
+    getRevokedMandateIds(owner: `0x${string}`): Promise<readonly `0x${string}`[]>;
+}
+/**
+ * The subset of the Metrik SDK the Eliza actions drive. `VerifiedStreamAgentClient`
+ * satisfies this structurally, so the plugin reuses the exact same SDK client +
+ * mandate-guard path as the AgentKit action provider — no forked business logic.
+ */
+export interface MetrikElizaClient extends Pick<VerifiedStreamAgentOpener, "openVerifiedStream"> {
+    getStreamStatus(streamId: `0x${string}`): Promise<StreamStatusView>;
+    reclaimStream(input: ReclaimAuthorizedStreamInput): Promise<ReclaimVerifiedStreamResult>;
+    closeStream(input: MandateAuthorizedStreamActionInput): Promise<StreamProofTransactionResult>;
+}
+export interface MetrikElizaPluginOptions {
+    readonly agentClient: MetrikElizaClient;
+    readonly mandateStateResolver?: Partial<MetrikElizaMandateStateResolver>;
+    readonly now?: () => number;
+    readonly pluginName?: string;
+    /**
+     * Discovery driver for the `DISCOVER_SERVICES` action. Defaults to the live
+     * registry-backed `discoverServices`; tests inject a double.
+     */
+    readonly discoverServices?: (opts?: DiscoverServicesOptions) => Promise<ServiceListing[]>;
+}
+/**
+ * Build the Metrik ElizaOS plugin. The returned plugin registers four
+ * mandate-gated actions — `HIRE_VERIFIED_SERVICE`, `CHECK_STREAM_STATUS`,
+ * `RECLAIM_UNSPENT`, and `CLOSE_STREAM` — that let an Eliza agent hire, monitor,
+ * and unwind verified service streams on Base without ever bypassing the signed
+ * spend mandate. Every fund-moving action is fail-closed: the mandate guard runs
+ * BEFORE any transaction and throws on breach.
+ */
+export declare function createMetrikElizaPlugin(options: MetrikElizaPluginOptions): Plugin;
+/**
+ * Convenience alias mirroring the `metrikActionProvider()` naming used by the
+ * AgentKit adapter. Same factory as {@link createMetrikElizaPlugin}.
+ */
+export declare const metrikElizaPlugin: typeof createMetrikElizaPlugin;
+/**
+ * @deprecated Use {@link createMetrikElizaPlugin}. Retained for backward
+ * compatibility; the action names it registers are now the canonical
+ * UPPER_SNAKE_CASE ElizaOS names.
+ */
+export declare const createElizaVerifiedStreamPlugin: typeof createMetrikElizaPlugin;
+export declare function createMetrikElizaContent<TAction extends MetrikElizaActionName>(action: TAction, input: MetrikElizaActionInputs[TAction], text?: string): Content;
+/**
+ * @deprecated Use {@link createMetrikElizaContent}.
+ */
+export declare const createElizaVerifiedStreamContent: typeof createMetrikElizaContent;
+export {};
+//# sourceMappingURL=eliza.d.ts.map

package/dist/frameworks/eliza.d.ts.map

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