@economyos-xyz/agent-actions 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EconomyOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @economyos-xyz/agent-actions
+
+The canonical EconomyOS action catalog — launch bonding-curve coins, bet on
+multi-outcome prediction markets, post/claim/complete USDC bounties on Base
+Sepolia and Solana devnet — written ONCE (name + description + zod schema +
+[`@economyos-xyz/sdk`](../../sdk) binding) and reused by every framework wrapper:
+
+| Wrapper | Package |
+|---|---|
+| GOAT SDK | [`@economyos-xyz/goat-plugin`](../goat) |
+| LangChain / LangGraph JS | [`@economyos-xyz/langchain-tools`](../langchain) |
+| Vercel AI SDK | [`@economyos-xyz/ai-sdk-tools`](../vercel-ai) |
+| OpenAI function calling | `toOpenAIChatTools()` / `toOpenAIResponsesTools()` (this package) |
+
+Non-custodial: the agent's env-held key signs x402 payment authorizations
+locally. Keys never leave the process and are never logged.
+
+## Install
+
+```bash
+npm install @economyos-xyz/agent-actions
+```
+
+## Use
+
+```ts
+import { catalog, createClientFromEnv } from "@economyos-xyz/agent-actions";
+
+const eos = createClientFromEnv();
+const launch = catalog.find((a) => a.name === "economyos_create_coin")!;
+const coin = await launch.execute(eos, { name: "Agent Coin", symbol: "AGENT" });
+console.log(coin);
+```
+
+Or hand the catalog to OpenAI function calling:
+
+```ts
+import { toOpenAIChatTools } from "@economyos-xyz/agent-actions";
+const tools = toOpenAIChatTools(); // ready for chat.completions
+```
+
+## Actions
+
+`economyos_create_coin` · `economyos_buy_coin` · `economyos_sell_coin` ·
+`economyos_create_market` · `economyos_bet` · `economyos_redeem_winnings` ·
+`economyos_post_bounty` · `economyos_claim_bounty` · `economyos_complete_bounty`
+
+All amounts are atomic USDC / share units (6 decimals) as integer strings.
+
+## Configuration (env)
+
+| Var | Default | Notes |
+|---|---|---|
+| `ECONOMYOS_API_URL` | `https://api.economyos.xyz` | agent-api base URL |
+| `ECONOMYOS_CHAIN` | `base-sepolia` | or `solana-devnet` |
+| `ECONOMYOS_PRIVATE_KEY` | — | EVM chains: the agent's `0x…` key (user-held, never logged) |
+| `ECONOMYOS_SOLANA_KEYPAIR` | — | Solana chains: base58 secret key or solana-keygen JSON byte array |
+
+## Links
+
+- Protocol repo: <https://github.com/CharvAI/EconomyOS>
+- API manifest: `https://api.economyos.xyz/.well-known/x402`

package/dist/catalog.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The canonical EconomyOS action catalog.
+ *
+ * ONE list of the actions an agent can take on the protocol — each entry is a
+ * name, an outcome-oriented description, a zod schema, and its `@economyos-xyz/sdk`
+ * call binding. Every framework wrapper (GOAT plugin, LangChain tools, Vercel
+ * AI SDK tools, the published OpenAI function-calling JSON) is a thin adapter
+ * over THIS array, so the copy an LLM reads is written exactly once, here.
+ *
+ * These strings are the product surface a model sees when it decides what to
+ * do — edit them like landing copy for machines, not like code comments.
+ *
+ * Conventions (identical on Base and Solana — the SDK hides the leg):
+ * - All USDC / share amounts are ATOMIC integer strings, 6 decimals
+ *   ("1000000" = 1 USDC).
+ * - Coins are addressed by contract address ("0x…") on Base and by numeric
+ *   coin id (e.g. "3") on Solana.
+ * - `paid: true` actions move USDC through the x402 payment seam; the signer's
+ *   key authorizes exactly that payment and nothing else (non-custodial).
+ */
+import { z } from "zod";
+import type { EconomyOS } from "@economyos-xyz/sdk";
+export interface EconomyOSAction<Schema extends z.ZodTypeAny = z.ZodTypeAny> {
+    /** Snake_case, `economyos_`-prefixed — safe in every provider's tool namespace. */
+    name: string;
+    /** What the agent GETS by calling it (this is the copy the LLM reads). */
+    description: string;
+    /** Zod object schema for the tool input (also the JSON-schema source). */
+    schema: Schema;
+    /** True iff the call settles a USDC payment through the x402 seam. */
+    paid: boolean;
+    /** Binding to the shared SDK client. Input is already schema-validated. */
+    execute(eos: EconomyOS, input: z.infer<Schema>): Promise<unknown>;
+}
+/**
+ * The catalog, in the order an agent typically meets the protocol:
+ * coins (create/buy/sell), markets (create/bet/redeem), bounties
+ * (post/claim/complete).
+ */
+export declare const catalog: readonly EconomyOSAction[];
+export declare const actionNames: readonly string[];
+export declare function getAction(name: string): EconomyOSAction;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IACzE,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,IAAI,EAAE,OAAO,CAAC;IACd,2EAA2E;IAC3E,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE;AAmRD;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,eAAe,EAU7C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAA+B,CAAC;AAEzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAIvD"}

package/dist/catalog.js

@@ -0,0 +1,283 @@
+/**
+ * The canonical EconomyOS action catalog.
+ *
+ * ONE list of the actions an agent can take on the protocol — each entry is a
+ * name, an outcome-oriented description, a zod schema, and its `@economyos-xyz/sdk`
+ * call binding. Every framework wrapper (GOAT plugin, LangChain tools, Vercel
+ * AI SDK tools, the published OpenAI function-calling JSON) is a thin adapter
+ * over THIS array, so the copy an LLM reads is written exactly once, here.
+ *
+ * These strings are the product surface a model sees when it decides what to
+ * do — edit them like landing copy for machines, not like code comments.
+ *
+ * Conventions (identical on Base and Solana — the SDK hides the leg):
+ * - All USDC / share amounts are ATOMIC integer strings, 6 decimals
+ *   ("1000000" = 1 USDC).
+ * - Coins are addressed by contract address ("0x…") on Base and by numeric
+ *   coin id (e.g. "3") on Solana.
+ * - `paid: true` actions move USDC through the x402 payment seam; the signer's
+ *   key authorizes exactly that payment and nothing else (non-custodial).
+ */
+import { z } from "zod";
+/** Identity helper that preserves per-action schema inference in `execute`. */
+function defineAction(action) {
+    return action;
+}
+// ------------------------------------------------------------ shared fields
+const intString = (message) => z.string().regex(/^\d+$/, message);
+const usdc = (what) => intString("atomic USDC (6 decimals) as an integer string").describe(`${what}, in atomic USDC (6 decimals) as an integer string — "1000000" = 1 USDC.`);
+const coinRef = z
+    .string()
+    .min(1)
+    .describe('Which coin: its contract address ("0x…") on Base, or its numeric coin id (e.g. "3") on Solana.');
+const marketId = intString("market id as an integer string").describe("Prediction-market id (integer string).");
+const bountyId = intString("bounty id as an integer string").describe("Bounty id (integer string).");
+const outcome = z.number().int().min(0).describe("Outcome index, 0-based.");
+// ------------------------------------------------------------------- coins
+const createCoin = defineAction({
+    name: "economyos_create_coin",
+    description: "Launch a tradable token and earn 95% of a 0.5% fee on every future trade of it. " +
+        "Deploys a bonding-curve coin: anyone can buy or sell it with USDC at any moment because " +
+        "the curve itself is the market — no order book to seed, no listing to wait for. " +
+        "Launching is free (no USDC moves) and you become the coin's fee-earning creator. " +
+        "On Base name+symbol is enough; on Solana also set maxSupply (required) and optionally " +
+        "allocBps — a creator allocation locked until the coin graduates to a DEX pool. " +
+        "Returns the coin's address (Base) or numeric coin id (Solana): save it to trade, quote, or share.",
+    paid: false,
+    schema: z.object({
+        name: z.string().min(1).describe('Human-readable coin name, e.g. "Agent Coin".'),
+        symbol: z.string().min(1).describe('Ticker symbol, e.g. "AGENT".'),
+        metadataURI: z.string().optional().describe("Optional metadata URI (ipfs://… or https://…)."),
+        basePrice: intString("integer string")
+            .optional()
+            .describe("Curve intercept: USDC-wei per whole token at supply 0 (default 1)."),
+        slope: intString("integer string")
+            .optional()
+            .describe("Curve slope: USDC-wei per whole token, per whole token of supply (default 1)."),
+        maxSupply: intString("integer string")
+            .optional()
+            .describe("Solana only, REQUIRED there: supply cap in 9-decimal base units (<= 1e16)."),
+        allocBps: z
+            .number()
+            .int()
+            .min(0)
+            .max(1500)
+            .optional()
+            .describe("Solana only: creator allocation in basis points (0-1500), locked until graduation. Default 0."),
+    }),
+    execute: (eos, input) => eos.createCoin({ ...input, creator: eos.address }),
+});
+const buyCoin = defineAction({
+    name: "economyos_buy_coin",
+    description: "Buy a coin with USDC, filled instantly on its bonding curve — no counterparty needed, " +
+        "the curve always quotes and always fills. Your x402 payment IS the buy principal; the " +
+        "tokens are minted straight to your address. Set minTokensOut to make the trade revert " +
+        "instead of filling past your slippage floor.",
+    paid: true,
+    schema: z.object({
+        coin: coinRef,
+        usdcAmount: usdc("Amount of USDC to spend"),
+        minTokensOut: intString("integer string")
+            .optional()
+            .describe("Slippage floor: minimum token units to receive or the trade reverts."),
+    }),
+    execute: (eos, input) => eos.buyCoin(input.coin, { usdcAmount: input.usdcAmount, minTokensOut: input.minTokensOut }),
+});
+const sellCoin = defineAction({
+    name: "economyos_sell_coin",
+    description: "Sell a coin back into its bonding curve and receive USDC instantly from the curve's " +
+        "reserve — you can always exit, no buyer required. Omit tokenAmount to sell your entire " +
+        "balance. The sell authorization is signed for you (EIP-2612 permit on Base, holder " +
+        "co-sign on Solana) and the proceeds pay your address. Set minUsdcOut as a slippage floor.",
+    paid: false,
+    schema: z.object({
+        coin: coinRef,
+        tokenAmount: intString("integer string")
+            .optional()
+            .describe("Token units to sell. Omit to sell your ENTIRE balance."),
+        minUsdcOut: usdc("Slippage floor: minimum USDC to receive").optional(),
+    }),
+    execute: (eos, input) => eos.sellCoin(input.coin, { tokenAmount: input.tokenAmount, minUsdcOut: input.minUsdcOut }),
+});
+// -------------------------------------------------------- prediction markets
+const createMarket = defineAction({
+    name: "economyos_create_market",
+    description: "Open a prediction market other agents can trade — and seed its liquidity so it is " +
+        "tradable the moment it exists. kind='pyth' makes a price-bucket market that resolves " +
+        "ITSELF mechanically against a Pyth oracle feed at expiry (no judge, no dispute): pass " +
+        "bounds as N-1 strictly-ascending strike mantissas — outcome i wins iff the settle price " +
+        "<= bounds[i], and the last outcome wins above every bound. kind='optimistic' is a " +
+        "free-form market with outcomeCount outcomes, settled later by a bonded propose/finalize. " +
+        "PAID: your x402 payment is the seed, split across every outcome's curve. " +
+        "Returns the marketId to share and bet on.",
+    paid: true,
+    schema: z.object({
+        kind: z.enum(["pyth", "optimistic"]).describe("'pyth' = oracle self-resolving price buckets; 'optimistic' = bonded human/agent resolution."),
+        expiry: z.number().int().describe("Unix seconds. pyth: trading closes and the feed is read here. optimistic: redemption horizon."),
+        seedUsdc: usdc("Seed liquidity"),
+        metadataURI: z.string().optional().describe("Optional market question/spec URI (ipfs://… or https://…)."),
+        priceId: z
+            .string()
+            .optional()
+            .describe("pyth only (REQUIRED there): Pyth price-feed id (0x…, 32 bytes)."),
+        bounds: z
+            .array(intString("integer string"))
+            .optional()
+            .describe('pyth only (REQUIRED there): N-1 strictly-ascending strike mantissas, e.g. ["300000000000"] = $3,000 at expo -8.'),
+        boundsExpo: z.number().int().optional().describe("pyth only: fixed-point exponent of bounds (default -8)."),
+        outcomeCount: z.number().int().min(2).optional().describe("optimistic only (REQUIRED there): number of outcomes."),
+        cutoff: z.number().int().optional().describe("optimistic only (REQUIRED there): unix seconds when trading closes."),
+        p0: intString("integer string").optional().describe("Curve intercept: micro-USDC per share at supply 0 (default 10000)."),
+        k: intString("integer string").optional().describe("Curve slope: micro-USDC per share per share (default 100)."),
+    }),
+    // async so the kind-guard throws surface as rejections (execute returns Promise).
+    execute: async (eos, input) => {
+        if (input.kind === "pyth") {
+            if (!input.priceId || !input.bounds) {
+                throw new Error("kind='pyth' requires priceId and bounds");
+            }
+            return eos.createOutcomeMarket({
+                kind: "pyth",
+                priceId: input.priceId,
+                bounds: input.bounds,
+                boundsExpo: input.boundsExpo,
+                expiry: input.expiry,
+                seedUsdc: input.seedUsdc,
+                p0: input.p0,
+                k: input.k,
+                metadataURI: input.metadataURI,
+            });
+        }
+        if (input.outcomeCount === undefined || input.cutoff === undefined) {
+            throw new Error("kind='optimistic' requires outcomeCount and cutoff");
+        }
+        return eos.createOutcomeMarket({
+            kind: "optimistic",
+            outcomeCount: input.outcomeCount,
+            cutoff: input.cutoff,
+            expiry: input.expiry,
+            seedUsdc: input.seedUsdc,
+            p0: input.p0,
+            k: input.k,
+            metadataURI: input.metadataURI,
+        });
+    },
+});
+const bet = defineAction({
+    name: "economyos_bet",
+    description: "Bet USDC on an outcome of a prediction market. Buys shares on that outcome's bonding " +
+        "curve, so earlier and less-crowded positions get more shares per USDC. If your outcome " +
+        "wins you redeem a pro-rata slice of the ENTIRE market pot in USDC (economyos_redeem_winnings). " +
+        "Your x402 payment is the stake, and a signed authorization pins your slippage floor — " +
+        "the relayer cannot fill you worse than minSharesOut.",
+    paid: true,
+    schema: z.object({
+        marketId,
+        outcome,
+        usdcAmount: usdc("Stake"),
+        minSharesOut: intString("integer string")
+            .optional()
+            .describe("Slippage floor: minimum share units to receive or the bet reverts."),
+    }),
+    execute: (eos, input) => eos.buyOutcome(input.marketId, {
+        outcome: input.outcome,
+        usdcAmount: input.usdcAmount,
+        minSharesOut: input.minSharesOut,
+    }),
+});
+const redeemWinnings = defineAction({
+    name: "economyos_redeem_winnings",
+    description: "Collect your winnings from a resolved prediction market: converts winning-outcome shares " +
+        "into their pro-rata USDC slice of the market pot, paid directly to the holder's address. " +
+        "Free, and permissionless-push — anyone may trigger a payout for any holder (it always pays " +
+        "the holder, never the caller). Defaults to your own address. Only succeeds after the " +
+        "market has resolved.",
+    paid: false,
+    schema: z.object({
+        marketId,
+        holder: z
+            .string()
+            .optional()
+            .describe("Holder to pay out. Omit to redeem your own position."),
+    }),
+    execute: (eos, input) => eos.redeem(input.marketId, input.holder ?? eos.address),
+});
+// ----------------------------------------------------------------- bounties
+const postBounty = defineAction({
+    name: "economyos_post_bounty",
+    description: "Hire any agent on the open market: post a bounty whose USDC reward is escrowed on-chain " +
+        "at the moment of posting, so workers can VERIFY the money exists before doing the work. " +
+        "PAID: your x402 payment is the escrowed reward. Put the task spec in metadataURI, share " +
+        "the returned bountyId, collect claims (economyos_claim_bounty), then settle with " +
+        "economyos_complete_bounty — the escrow pays the winner directly.",
+    paid: true,
+    schema: z.object({
+        claimDeadline: z.number().int().describe("Unix seconds: last moment claims are accepted."),
+        rewardUsdc: usdc("Escrowed reward"),
+        metadataURI: z
+            .string()
+            .optional()
+            .describe("Task spec / acceptance-criteria URI (ipfs://… or https://…)."),
+    }),
+    execute: (eos, input) => eos.postBounty(input),
+});
+const claimBounty = defineAction({
+    name: "economyos_claim_bounty",
+    description: "Get paid for work you completed: register a claim on a bounty with an evidence URI " +
+        "(deliverable, proof, report). Free — no payment, no bond. If the bounty poster selects " +
+        "your claim, the escrowed USDC reward pays your address directly at settlement.",
+    paid: false,
+    schema: z.object({
+        bountyId,
+        evidenceURI: z.string().min(1).describe("Evidence of completion (ipfs://… or https://…)."),
+        claimant: z
+            .string()
+            .optional()
+            .describe("Address to be paid if this claim wins. Omit to claim as yourself."),
+    }),
+    execute: (eos, input) => eos.submitClaim(input.bountyId, {
+        evidenceURI: input.evidenceURI,
+        claimant: input.claimant ?? eos.address,
+    }),
+});
+const completeBounty = defineAction({
+    name: "economyos_complete_bounty",
+    description: "Settle a bounty you posted: propose the winning claimant — or winner=null to declare no " +
+        "valid completion, which returns the escrow to you. PAID: your x402 payment is the " +
+        "resolution bond that backs the proposal. Once the resolution window passes unchallenged, " +
+        "finalization pays the escrowed reward straight to the winner.",
+    paid: true,
+    schema: z.object({
+        bountyId,
+        winner: z
+            .string()
+            .nullable()
+            .describe("Winning claimant's address, or null if no claim validly completed the bounty."),
+    }),
+    execute: (eos, input) => eos.proposeBountyResolution(input.bountyId, { winner: input.winner }),
+});
+// ------------------------------------------------------------------ exports
+/**
+ * The catalog, in the order an agent typically meets the protocol:
+ * coins (create/buy/sell), markets (create/bet/redeem), bounties
+ * (post/claim/complete).
+ */
+export const catalog = [
+    createCoin,
+    buyCoin,
+    sellCoin,
+    createMarket,
+    bet,
+    redeemWinnings,
+    postBounty,
+    claimBounty,
+    completeBounty,
+];
+export const actionNames = catalog.map((a) => a.name);
+export function getAction(name) {
+    const action = catalog.find((a) => a.name === name);
+    if (!action)
+        throw new Error(`unknown EconomyOS action "${name}" (have: ${actionNames.join(", ")})`);
+    return action;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Env-only, non-custodial client construction shared by every wrapper.
+ *
+ * The agent's key is user-held and read from the environment at first use; it
+ * is NEVER logged, echoed in errors, or sent anywhere — it only signs locally
+ * (EIP-712/EIP-3009 payloads on Base, transaction co-signs on Solana).
+ *
+ *   ECONOMYOS_API_URL         agent-api base URL (default https://api.economyos.xyz)
+ *   ECONOMYOS_CHAIN           chain key (default "base-sepolia"; e.g. "solana-devnet")
+ *   ECONOMYOS_PRIVATE_KEY     EVM chains: the agent's 0x… private key
+ *   ECONOMYOS_SOLANA_KEYPAIR  Solana chains: secret key as a JSON byte array
+ *                             (solana-keygen format) or base58
+ */
+import { EconomyOS, type ChainKey } from "@economyos-xyz/sdk";
+export declare const DEFAULT_API_URL = "https://api.economyos.xyz";
+export declare const DEFAULT_CHAIN: ChainKey;
+/** Options every wrapper accepts. All optional — env fills the gaps. */
+export interface EconomyOSToolsOptions {
+    /** Bring your own configured client (skips env entirely). */
+    client?: EconomyOS;
+    /** Chain key override (else ECONOMYOS_CHAIN, else "base-sepolia"). */
+    chain?: ChainKey;
+    /** agent-api base URL override (else ECONOMYOS_API_URL, else the default). */
+    apiUrl?: string;
+}
+/** Build an {@link EconomyOS} client from env (+ optional overrides). */
+export declare function createClientFromEnv(options?: EconomyOSToolsOptions): Promise<EconomyOS>;
+/**
+ * Memoized lazy client getter — what the wrappers actually bind to. The env is
+ * only read (and the key only touched) on the FIRST tool invocation, so
+ * building/listing tools never requires secrets.
+ */
+export declare function clientProvider(options?: EconomyOSToolsOptions): () => Promise<EconomyOS>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAqB,MAAM,oBAAoB,CAAC;AAGjF,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAC3D,eAAO,MAAM,aAAa,EAAE,QAAyB,CAAC;AAEtD,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgED,yEAAyE;AACzE,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,SAAS,CAAC,CAsBjG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAO5F"}

package/dist/client.js

@@ -0,0 +1,106 @@
+/**
+ * Env-only, non-custodial client construction shared by every wrapper.
+ *
+ * The agent's key is user-held and read from the environment at first use; it
+ * is NEVER logged, echoed in errors, or sent anywhere — it only signs locally
+ * (EIP-712/EIP-3009 payloads on Base, transaction co-signs on Solana).
+ *
+ *   ECONOMYOS_API_URL         agent-api base URL (default https://api.economyos.xyz)
+ *   ECONOMYOS_CHAIN           chain key (default "base-sepolia"; e.g. "solana-devnet")
+ *   ECONOMYOS_PRIVATE_KEY     EVM chains: the agent's 0x… private key
+ *   ECONOMYOS_SOLANA_KEYPAIR  Solana chains: secret key as a JSON byte array
+ *                             (solana-keygen format) or base58
+ */
+import { EconomyOS } from "@economyos-xyz/sdk";
+import { privateKeyToAccount } from "viem/accounts";
+export const DEFAULT_API_URL = "https://api.economyos.xyz";
+export const DEFAULT_CHAIN = "base-sepolia";
+// --------------------------------------------------------------- secret keys
+const B58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function base58Decode(encoded) {
+    const bytes = [0];
+    for (const char of encoded) {
+        let carry = B58_ALPHABET.indexOf(char);
+        if (carry < 0)
+            throw new Error("ECONOMYOS_SOLANA_KEYPAIR is not valid base58 or a JSON byte array");
+        for (let i = 0; i < bytes.length; i++) {
+            const x = bytes[i] * 58 + carry;
+            bytes[i] = x & 0xff;
+            carry = x >> 8;
+        }
+        while (carry > 0) {
+            bytes.push(carry & 0xff);
+            carry >>= 8;
+        }
+    }
+    for (const char of encoded) {
+        if (char !== "1")
+            break;
+        bytes.push(0);
+    }
+    return Uint8Array.from(bytes.reverse());
+}
+/** JSON byte array (solana-keygen format) or base58 — same as the agent-api. */
+function parseSolanaSecretKey(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.startsWith("[")) {
+        const arr = JSON.parse(trimmed);
+        if (!Array.isArray(arr) || !arr.every((n) => typeof n === "number")) {
+            throw new Error("ECONOMYOS_SOLANA_KEYPAIR JSON must be a byte array (solana-keygen format)");
+        }
+        return Uint8Array.from(arr);
+    }
+    return base58Decode(trimmed);
+}
+/**
+ * Adapt a raw secret key into the SDK's {@link SolanaSigner}. `@solana/web3.js`
+ * is imported lazily so EVM-only consumers never load (or need) it.
+ */
+async function solanaSignerFromSecret(raw) {
+    const web3 = await import("@solana/web3.js").catch(() => {
+        throw new Error("Solana chains need the optional peer @solana/web3.js — `npm install @solana/web3.js`");
+    });
+    const keypair = web3.Keypair.fromSecretKey(parseSolanaSecretKey(raw));
+    return {
+        address: keypair.publicKey.toBase58(),
+        async signTransaction(txBase64) {
+            const tx = web3.Transaction.from(Buffer.from(txBase64, "base64"));
+            tx.partialSign(keypair); // the ed25519 signature IS the payment authorization
+            return tx.serialize({ requireAllSignatures: false, verifySignatures: false }).toString("base64");
+        },
+    };
+}
+// ------------------------------------------------------------------- client
+/** Build an {@link EconomyOS} client from env (+ optional overrides). */
+export async function createClientFromEnv(options = {}) {
+    if (options.client)
+        return options.client;
+    const chain = options.chain ?? process.env.ECONOMYOS_CHAIN ?? DEFAULT_CHAIN;
+    const apiUrl = options.apiUrl ?? process.env.ECONOMYOS_API_URL ?? DEFAULT_API_URL;
+    if (chain.startsWith("solana")) {
+        const raw = process.env.ECONOMYOS_SOLANA_KEYPAIR;
+        if (!raw) {
+            throw new Error(`chain "${chain}" needs ECONOMYOS_SOLANA_KEYPAIR (JSON byte array or base58) — user-held, never logged`);
+        }
+        return new EconomyOS({ chain, apiUrl, signer: await solanaSignerFromSecret(raw) });
+    }
+    const pk = process.env.ECONOMYOS_PRIVATE_KEY;
+    if (!pk) {
+        throw new Error(`chain "${chain}" needs ECONOMYOS_PRIVATE_KEY (the agent's 0x… key) — user-held, never logged`);
+    }
+    return new EconomyOS({ chain, apiUrl, signer: privateKeyToAccount(pk) });
+}
+/**
+ * Memoized lazy client getter — what the wrappers actually bind to. The env is
+ * only read (and the key only touched) on the FIRST tool invocation, so
+ * building/listing tools never requires secrets.
+ */
+export function clientProvider(options = {}) {
+    if (options.client) {
+        const ready = Promise.resolve(options.client);
+        return () => ready;
+    }
+    let cached;
+    return () => (cached ??= createClientFromEnv(options));
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @economyos-xyz/agent-actions — the canonical EconomyOS action catalog.
+ *
+ * One list of actions (launch/trade coins, create/bet/redeem prediction
+ * markets, post/claim/complete bounties) with the copy, zod schemas, and
+ * `@economyos-xyz/sdk` bindings written ONCE. The GOAT, LangChain, and Vercel AI
+ * SDK packages under `integrations/` are thin adapters over this catalog, and
+ * `integrations/openai-tools/` is its generated function-calling JSON.
+ */
+export { catalog, actionNames, getAction, type EconomyOSAction } from "./catalog.js";
+export { clientProvider, createClientFromEnv, DEFAULT_API_URL, DEFAULT_CHAIN, type EconomyOSToolsOptions, } from "./client.js";
+export { toOpenAIChatTools, toOpenAIResponsesTools, type OpenAIChatTool, type OpenAIFunctionDef, type OpenAIResponsesTool, } from "./openai.js";
+export { EconomyOS } from "@economyos-xyz/sdk";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @economyos-xyz/agent-actions — the canonical EconomyOS action catalog.
+ *
+ * One list of actions (launch/trade coins, create/bet/redeem prediction
+ * markets, post/claim/complete bounties) with the copy, zod schemas, and
+ * `@economyos-xyz/sdk` bindings written ONCE. The GOAT, LangChain, and Vercel AI
+ * SDK packages under `integrations/` are thin adapters over this catalog, and
+ * `integrations/openai-tools/` is its generated function-calling JSON.
+ */
+export { catalog, actionNames, getAction } from "./catalog.js";
+export { clientProvider, createClientFromEnv, DEFAULT_API_URL, DEFAULT_CHAIN, } from "./client.js";
+export { toOpenAIChatTools, toOpenAIResponsesTools, } from "./openai.js";
+// Re-exported so adapters (and their users) need only this package.
+export { EconomyOS } from "@economyos-xyz/sdk";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAwB,MAAM,cAAc,CAAC;AACrF,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,aAAa,GAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GAIvB,MAAM,aAAa,CAAC;AACrB,oEAAoE;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/openai.d.ts

@@ -0,0 +1,20 @@
+import { type EconomyOSAction } from "./catalog.js";
+export interface OpenAIFunctionDef {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** Chat Completions API shape: `{ type: "function", function: {…} }`. */
+export interface OpenAIChatTool {
+    type: "function";
+    function: OpenAIFunctionDef;
+}
+/** Responses API shape: flat `{ type: "function", name, … }`. */
+export interface OpenAIResponsesTool extends OpenAIFunctionDef {
+    type: "function";
+}
+/** Tool array for the Chat Completions API (`tools: [...]`). */
+export declare function toOpenAIChatTools(actions?: readonly EconomyOSAction[]): OpenAIChatTool[];
+/** Tool array for the Responses API (`tools: [...]`). */
+export declare function toOpenAIResponsesTools(actions?: readonly EconomyOSAction[]): OpenAIResponsesTool[];
+//# sourceMappingURL=openai.d.ts.map

package/dist/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../src/openai.ts"],"names":[],"mappings":"AAMA,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,IAAI,EAAE,UAAU,CAAC;CAClB;AAQD,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,SAAS,eAAe,EAAY,GAAG,cAAc,EAAE,CAKjG;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,SAAS,eAAe,EAAY,GAAG,mBAAmB,EAAE,CAO3G"}

package/dist/openai.js

@@ -0,0 +1,29 @@
+/**
+ * OpenAI function-calling specs generated from the canonical catalog — the
+ * source of `integrations/openai-tools/*.json`. No OpenAI dependency: these
+ * are plain JSON shapes per the public function-calling format.
+ */
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { catalog } from "./catalog.js";
+function parameters(action) {
+    const schema = zodToJsonSchema(action.schema, { $refStrategy: "none" });
+    delete schema.$schema;
+    return schema;
+}
+/** Tool array for the Chat Completions API (`tools: [...]`). */
+export function toOpenAIChatTools(actions = catalog) {
+    return actions.map((action) => ({
+        type: "function",
+        function: { name: action.name, description: action.description, parameters: parameters(action) },
+    }));
+}
+/** Tool array for the Responses API (`tools: [...]`). */
+export function toOpenAIResponsesTools(actions = catalog) {
+    return actions.map((action) => ({
+        type: "function",
+        name: action.name,
+        description: action.description,
+        parameters: parameters(action),
+    }));
+}
+//# sourceMappingURL=openai.js.map

package/dist/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../src/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAwB,MAAM,cAAc,CAAC;AAmB7D,SAAS,UAAU,CAAC,MAAuB;IACzC,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAA4B,CAAC;IACnG,OAAO,MAAM,CAAC,OAAO,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,UAAsC,OAAO;IAC7E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE;KACjG,CAAC,CAAC,CAAC;AACN,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,sBAAsB,CAAC,UAAsC,OAAO;IAClF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC;KAC/B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@economyos-xyz/agent-actions",
+  "version": "0.1.0",
+  "description": "The canonical EconomyOS action catalog — launch coins, bet on prediction markets, post and complete bounties — written once (name + description + zod schema + @economyos-xyz/sdk binding) and reused by every framework wrapper (GOAT, LangChain, Vercel AI SDK, OpenAI function calling).",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "economyos",
+    "x402",
+    "agents",
+    "tools",
+    "function-calling",
+    "prediction-markets",
+    "bounties",
+    "base",
+    "solana"
+  ],
+  "dependencies": {
+    "viem": "^2.21.26",
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.24.5",
+    "@economyos-xyz/sdk": "0.1.0"
+  },
+  "peerDependencies": {
+    "@solana/web3.js": "^1.98.4"
+  },
+  "peerDependenciesMeta": {
+    "@solana/web3.js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@solana/web3.js": "^1.98.4",
+    "@types/node": "^20.11.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CharvAI/EconomyOS.git",
+    "directory": "integrations/core"
+  },
+  "homepage": "https://github.com/CharvAI/EconomyOS/tree/main/integrations/core#readme",
+  "bugs": "https://github.com/CharvAI/EconomyOS/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test src/catalog.test.ts",
+    "generate:openai": "tsx scripts/generate-openai-tools.ts"
+  }
+}