@agnt-id/frameworks 0.1.0

package/dist/crewai.d.ts

@@ -0,0 +1,46 @@
+/**
+ * CrewAI-compatible tools for .agnt name resolution.
+ *
+ * CrewAI tools follow a simple pattern: a class with `name`, `description`,
+ * and a `_run(input)` method. These tools can be passed directly to a
+ * CrewAI Agent's `tools` array.
+ *
+ * Usage:
+ *
+ *   import { AgntResolveTool, AgntDiscoverTool } from "@agnt-id/frameworks/crewai";
+ *   const tools = [new AgntResolveTool(), new AgntDiscoverTool()];
+ */
+export type AgntToolOptions = {
+    gateway?: string;
+    chainId?: string;
+};
+/**
+ * CrewAI tool: resolve a .agnt name to its full record set.
+ */
+export declare class AgntResolveTool {
+    name: string;
+    description: string;
+    private clientP;
+    constructor(options?: AgntToolOptions);
+    _run(input: string): Promise<string>;
+}
+/**
+ * CrewAI tool: reverse-resolve an address to a .agnt name.
+ */
+export declare class AgntReverseTool {
+    name: string;
+    description: string;
+    private clientP;
+    constructor(options?: AgntToolOptions);
+    _run(input: string): Promise<string>;
+}
+/**
+ * CrewAI tool: discover agents by keyword, skill, or domain.
+ */
+export declare class AgntDiscoverTool {
+    name: string;
+    description: string;
+    private clientP;
+    constructor(options?: AgntToolOptions);
+    _run(input: string): Promise<string>;
+}

package/dist/crewai.js

@@ -0,0 +1,77 @@
+/**
+ * CrewAI-compatible tools for .agnt name resolution.
+ *
+ * CrewAI tools follow a simple pattern: a class with `name`, `description`,
+ * and a `_run(input)` method. These tools can be passed directly to a
+ * CrewAI Agent's `tools` array.
+ *
+ * Usage:
+ *
+ *   import { AgntResolveTool, AgntDiscoverTool } from "@agnt-id/frameworks/crewai";
+ *   const tools = [new AgntResolveTool(), new AgntDiscoverTool()];
+ */
+import { createClient, formatResolved } from "./shared.js";
+/**
+ * CrewAI tool: resolve a .agnt name to its full record set.
+ */
+export class AgntResolveTool {
+    name = "agnt_resolve";
+    description = "Resolve a .agnt name to wallet addresses, A2A/MCP endpoints, identity, and metadata. Input: a .agnt name like alice.agnt";
+    clientP;
+    constructor(options = {}) {
+        this.clientP = createClient(options);
+    }
+    async _run(input) {
+        const name = input.trim();
+        if (!name)
+            return "Error: provide a .agnt name to resolve.";
+        const client = await this.clientP;
+        const result = await client.resolve(name);
+        if (!result)
+            return `No .agnt name found for "${name}".`;
+        return formatResolved(result);
+    }
+}
+/**
+ * CrewAI tool: reverse-resolve an address to a .agnt name.
+ */
+export class AgntReverseTool {
+    name = "agnt_reverse";
+    description = "Reverse-resolve an EVM wallet address to its primary .agnt name. Input: an address like 0x1234...";
+    clientP;
+    constructor(options = {}) {
+        this.clientP = createClient(options);
+    }
+    async _run(input) {
+        const address = input.trim();
+        if (!address)
+            return "Error: provide a wallet address.";
+        const client = await this.clientP;
+        const result = await client.reverse(address, { verify: true });
+        if (!result)
+            return `No .agnt name found for address ${address}.`;
+        const verified = result.verified ? " (verified)" : "";
+        return `${result.name}${verified}`;
+    }
+}
+/**
+ * CrewAI tool: discover agents by keyword, skill, or domain.
+ */
+export class AgntDiscoverTool {
+    name = "agnt_discover";
+    description = "Search the .agnt agent directory by keyword, skill, or domain. Input: a search query.";
+    clientP;
+    constructor(options = {}) {
+        this.clientP = createClient(options);
+    }
+    async _run(input) {
+        const query = input.trim();
+        if (!query)
+            return "Error: provide a search query.";
+        const client = await this.clientP;
+        const result = await client.discover({ q: query, limit: 10 });
+        if (result.results.length === 0)
+            return `No agents found for "${query}".`;
+        return result.results.map((r) => r.name).join("\n");
+    }
+}

package/dist/eliza.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ElizaOS plugin for .agnt name resolution.
+ *
+ * ElizaOS plugins expose actions, providers, and evaluators.
+ * This plugin adds a "resolve_agnt" action that lets ElizaOS agents
+ * resolve .agnt names during conversations.
+ *
+ * Usage:
+ *
+ *   import { agntPlugin } from "@agnt-id/frameworks/eliza";
+ *   // Register with your ElizaOS agent config
+ */
+export type AgntPluginOptions = {
+    gateway?: string;
+    chainId?: string;
+};
+/**
+ * An ElizaOS action definition for resolving .agnt names.
+ */
+export type ElizaAction = {
+    name: string;
+    description: string;
+    parameters: Record<string, {
+        type: string;
+        description: string;
+        required?: boolean;
+    }>;
+    handler: (params: Record<string, string>) => Promise<string>;
+};
+/**
+ * An ElizaOS plugin definition.
+ */
+export type ElizaPlugin = {
+    name: string;
+    description: string;
+    actions: ElizaAction[];
+};
+/**
+ * Create the .agnt ElizaOS plugin.
+ *
+ * @param options - Gateway and chain configuration
+ * @returns An ElizaOS-compatible plugin with resolve, reverse, and discover actions
+ */
+export declare function agntPlugin(options?: AgntPluginOptions): ElizaPlugin;

package/dist/eliza.js

@@ -0,0 +1,97 @@
+/**
+ * ElizaOS plugin for .agnt name resolution.
+ *
+ * ElizaOS plugins expose actions, providers, and evaluators.
+ * This plugin adds a "resolve_agnt" action that lets ElizaOS agents
+ * resolve .agnt names during conversations.
+ *
+ * Usage:
+ *
+ *   import { agntPlugin } from "@agnt-id/frameworks/eliza";
+ *   // Register with your ElizaOS agent config
+ */
+import { createClient, formatResolved } from "./shared.js";
+/**
+ * Create the .agnt ElizaOS plugin.
+ *
+ * @param options - Gateway and chain configuration
+ * @returns An ElizaOS-compatible plugin with resolve, reverse, and discover actions
+ */
+export function agntPlugin(options = {}) {
+    let clientP = null;
+    const getClient = () => {
+        if (!clientP)
+            clientP = createClient(options);
+        return clientP;
+    };
+    return {
+        name: "agnt",
+        description: "Resolve .agnt names to wallets, agent endpoints, and identity records",
+        actions: [
+            {
+                name: "resolve_agnt",
+                description: "Resolve a .agnt name to its wallet, A2A/MCP endpoints, identity, and metadata",
+                parameters: {
+                    name: {
+                        type: "string",
+                        description: "The .agnt name to resolve (e.g. alice.agnt)",
+                        required: true,
+                    },
+                },
+                handler: async (params) => {
+                    const name = params.name?.trim();
+                    if (!name)
+                        return "Error: provide a .agnt name to resolve.";
+                    const client = await getClient();
+                    const result = await client.resolve(name);
+                    if (!result)
+                        return `No .agnt name found for "${name}".`;
+                    return formatResolved(result);
+                },
+            },
+            {
+                name: "reverse_agnt",
+                description: "Reverse-resolve an EVM wallet address to its primary .agnt name",
+                parameters: {
+                    address: {
+                        type: "string",
+                        description: "EVM wallet address (0x...)",
+                        required: true,
+                    },
+                },
+                handler: async (params) => {
+                    const address = params.address?.trim();
+                    if (!address)
+                        return "Error: provide a wallet address.";
+                    const client = await getClient();
+                    const result = await client.reverse(address, { verify: true });
+                    if (!result)
+                        return `No .agnt name found for address ${address}.`;
+                    const verified = result.verified ? " (verified)" : "";
+                    return `${result.name}${verified}`;
+                },
+            },
+            {
+                name: "discover_agnt",
+                description: "Search the .agnt directory for agents by keyword, skill, or domain",
+                parameters: {
+                    query: {
+                        type: "string",
+                        description: "Search query — keyword, skill slug, or domain slug",
+                        required: true,
+                    },
+                },
+                handler: async (params) => {
+                    const query = params.query?.trim();
+                    if (!query)
+                        return "Error: provide a search query.";
+                    const client = await getClient();
+                    const result = await client.discover({ q: query, limit: 10 });
+                    if (result.results.length === 0)
+                        return `No agents found for "${query}".`;
+                    return result.results.map((r) => r.name).join("\n");
+                },
+            },
+        ],
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @agnt-id/frameworks — Agent framework plugins for .agnt name resolution.
+ *
+ * Import from the sub-path for your framework:
+ *
+ *   import { AgntResolveTool } from "@agnt-id/frameworks/langchain";
+ *   import { AgntResolveTool } from "@agnt-id/frameworks/crewai";
+ *   import { agntPlugin } from "@agnt-id/frameworks/eliza";
+ *
+ * Or import everything from the root:
+ *
+ *   import * as agntFrameworks from "@agnt-id/frameworks";
+ */
+export { AgntDiscoverTool as CrewAIDiscoverTool, AgntResolveTool as CrewAIResolveTool, AgntReverseTool as CrewAIReverseTool, } from "./crewai.js";
+export { agntPlugin } from "./eliza.js";
+export { AgntDiscoverTool as LangChainDiscoverTool, AgntResolveTool as LangChainResolveTool, AgntReverseTool as LangChainReverseTool, } from "./langchain.js";

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @agnt-id/frameworks — Agent framework plugins for .agnt name resolution.
+ *
+ * Import from the sub-path for your framework:
+ *
+ *   import { AgntResolveTool } from "@agnt-id/frameworks/langchain";
+ *   import { AgntResolveTool } from "@agnt-id/frameworks/crewai";
+ *   import { agntPlugin } from "@agnt-id/frameworks/eliza";
+ *
+ * Or import everything from the root:
+ *
+ *   import * as agntFrameworks from "@agnt-id/frameworks";
+ */
+export { AgntDiscoverTool as CrewAIDiscoverTool, AgntResolveTool as CrewAIResolveTool, AgntReverseTool as CrewAIReverseTool, } from "./crewai.js";
+export { agntPlugin } from "./eliza.js";
+export { AgntDiscoverTool as LangChainDiscoverTool, AgntResolveTool as LangChainResolveTool, AgntReverseTool as LangChainReverseTool, } from "./langchain.js";

package/dist/langchain.d.ts

@@ -0,0 +1,81 @@
+/**
+ * LangChain-compatible tools for .agnt name resolution.
+ *
+ * Usage (LangChain JS/TS):
+ *
+ *   import { AgntResolveTool, AgntDiscoverTool } from "@agnt-id/frameworks/langchain";
+ *   const tools = [new AgntResolveTool(), new AgntDiscoverTool()];
+ *
+ * These tools follow the LangChain StructuredTool pattern — they expose
+ * `name`, `description`, and `_call()` so any LangChain agent can use them.
+ */
+/** Options accepted by all LangChain .agnt tools. */
+export type AgntToolOptions = {
+    gateway?: string;
+    chainId?: string;
+};
+/**
+ * LangChain tool: resolve a .agnt name to its records.
+ *
+ * Compatible with LangChain's StructuredTool interface.
+ * Can be used directly or wrapped in a DynamicStructuredTool.
+ */
+export declare class AgntResolveTool {
+    name: string;
+    description: string;
+    private clientP;
+    constructor(options?: AgntToolOptions);
+    /** LangChain calls this with the raw input string. */
+    _call(input: string): Promise<string>;
+    /** Schema hint for LangChain agents. */
+    schema: {
+        type: "object";
+        properties: {
+            input: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: readonly ["input"];
+    };
+}
+/**
+ * LangChain tool: reverse-resolve an address to a .agnt name.
+ */
+export declare class AgntReverseTool {
+    name: string;
+    description: string;
+    private clientP;
+    constructor(options?: AgntToolOptions);
+    _call(input: string): Promise<string>;
+    schema: {
+        type: "object";
+        properties: {
+            input: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: readonly ["input"];
+    };
+}
+/**
+ * LangChain tool: discover agents by keyword, skill, or domain.
+ */
+export declare class AgntDiscoverTool {
+    name: string;
+    description: string;
+    private clientP;
+    constructor(options?: AgntToolOptions);
+    _call(input: string): Promise<string>;
+    schema: {
+        type: "object";
+        properties: {
+            input: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: readonly ["input"];
+    };
+}

package/dist/langchain.js

@@ -0,0 +1,117 @@
+/**
+ * LangChain-compatible tools for .agnt name resolution.
+ *
+ * Usage (LangChain JS/TS):
+ *
+ *   import { AgntResolveTool, AgntDiscoverTool } from "@agnt-id/frameworks/langchain";
+ *   const tools = [new AgntResolveTool(), new AgntDiscoverTool()];
+ *
+ * These tools follow the LangChain StructuredTool pattern — they expose
+ * `name`, `description`, and `_call()` so any LangChain agent can use them.
+ */
+import { createClient, formatResolved } from "./shared.js";
+/**
+ * LangChain tool: resolve a .agnt name to its records.
+ *
+ * Compatible with LangChain's StructuredTool interface.
+ * Can be used directly or wrapped in a DynamicStructuredTool.
+ */
+export class AgntResolveTool {
+    name = "agnt_resolve";
+    description = "Resolve a .agnt name (e.g. alice.agnt) to wallet addresses, A2A/MCP endpoints, identity, skills, and other records.";
+    clientP;
+    constructor(options = {}) {
+        this.clientP = createClient(options);
+    }
+    /** LangChain calls this with the raw input string. */
+    async _call(input) {
+        const name = input.trim();
+        if (!name)
+            return "Error: provide a .agnt name to resolve.";
+        const client = await this.clientP;
+        const result = await client.resolve(name);
+        if (!result)
+            return `No .agnt name found for "${name}".`;
+        return formatResolved(result);
+    }
+    /** Schema hint for LangChain agents. */
+    schema = {
+        type: "object",
+        properties: {
+            input: {
+                type: "string",
+                description: "The .agnt name to resolve (e.g. alice.agnt)",
+            },
+        },
+        required: ["input"],
+    };
+}
+/**
+ * LangChain tool: reverse-resolve an address to a .agnt name.
+ */
+export class AgntReverseTool {
+    name = "agnt_reverse";
+    description = "Reverse-resolve an EVM wallet address (0x...) to its primary .agnt name.";
+    clientP;
+    constructor(options = {}) {
+        this.clientP = createClient(options);
+    }
+    async _call(input) {
+        const address = input.trim();
+        if (!address)
+            return "Error: provide a wallet address.";
+        const client = await this.clientP;
+        const result = await client.reverse(address, { verify: true });
+        if (!result)
+            return `No .agnt name found for address ${address}.`;
+        const verified = result.verified ? " (verified)" : "";
+        return `${result.name}${verified}`;
+    }
+    schema = {
+        type: "object",
+        properties: {
+            input: {
+                type: "string",
+                description: "EVM wallet address (0x...)",
+            },
+        },
+        required: ["input"],
+    };
+}
+/**
+ * LangChain tool: discover agents by keyword, skill, or domain.
+ */
+export class AgntDiscoverTool {
+    name = "agnt_discover";
+    description = "Search the .agnt directory for agents by keyword, skill slug, or domain slug. Returns a list of matching agent names and their capabilities.";
+    clientP;
+    constructor(options = {}) {
+        this.clientP = createClient(options);
+    }
+    async _call(input) {
+        const query = input.trim();
+        if (!query)
+            return "Error: provide a search query.";
+        const client = await this.clientP;
+        const result = await client.discover({ q: query, limit: 10 });
+        if (result.results.length === 0)
+            return `No agents found for "${query}".`;
+        return result.results
+            .map((r) => {
+            const rec = r.records;
+            const skills = rec.skills ?? [];
+            return `${r.name}${skills.length ? ` [${skills.join(", ")}]` : ""}`;
+        })
+            .join("\n");
+    }
+    schema = {
+        type: "object",
+        properties: {
+            input: {
+                type: "string",
+                description: "Search query — keyword, skill slug, or domain slug",
+            },
+        },
+        required: ["input"],
+    };
+}

package/dist/shared.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared helpers used by all framework integrations.
+ * These keep the per-framework modules thin by centralising
+ * .agnt resolution into reusable functions.
+ */
+/** Minimal AgntClient shape — avoids hard import at module level. */
+export type AgntClientLike = {
+    resolve(name: string): Promise<ResolvedLike | null>;
+    reverse(address: string, options?: {
+        chainId?: string;
+        verify?: boolean;
+    }): Promise<ReversedLike | null>;
+    discover(options?: DiscoverOptsLike): Promise<DiscoverResultLike>;
+};
+export type ResolvedLike = {
+    name: string;
+    owner: string;
+    records: Record<string, unknown>;
+};
+export type ReversedLike = {
+    name: string;
+    verified?: boolean;
+};
+export type DiscoverOptsLike = {
+    q?: string;
+    skill?: string;
+    domain?: string;
+    limit?: number;
+};
+export type DiscoverResultLike = {
+    results: Array<{
+        name: string;
+        records: Record<string, unknown>;
+    }>;
+};
+/** Create an AgntClient from @agnt-id/resolve (dynamic import). */
+export declare function createClient(options?: {
+    gateway?: string;
+    chainId?: string;
+}): Promise<AgntClientLike>;
+/** Format a resolve result into a concise text summary. */
+export declare function formatResolved(data: ResolvedLike): string;

package/dist/shared.js

@@ -0,0 +1,32 @@
+/**
+ * Shared helpers used by all framework integrations.
+ * These keep the per-framework modules thin by centralising
+ * .agnt resolution into reusable functions.
+ */
+/** Create an AgntClient from @agnt-id/resolve (dynamic import). */
+export async function createClient(options) {
+    const { AgntClient } = await import("@agnt-id/resolve");
+    return new AgntClient(options);
+}
+/** Format a resolve result into a concise text summary. */
+export function formatResolved(data) {
+    const rec = data.records;
+    const lines = [`Name: ${data.name}`, `Owner: ${data.owner}`];
+    if (rec.wallet)
+        lines.push(`Wallet: ${String(rec.wallet)}`);
+    if (rec.a2a)
+        lines.push(`A2A: ${String(rec.a2a)}`);
+    if (rec.mcp)
+        lines.push(`MCP: ${String(rec.mcp)}`);
+    if (rec.identity)
+        lines.push(`Identity: ${String(rec.identity)}`);
+    if (rec.agentId)
+        lines.push(`Agent ID: ${String(rec.agentId)}`);
+    const skills = rec.skills;
+    if (skills?.length)
+        lines.push(`Skills: ${skills.join(", ")}`);
+    const domains = rec.domains;
+    if (domains?.length)
+        lines.push(`Domains: ${domains.join(", ")}`);
+    return lines.join("\n");
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@agnt-id/frameworks",
+  "version": "0.1.0",
+  "description": "Agent framework plugins for .agnt name resolution — LangChain, CrewAI, ElizaOS",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./langchain": {
+      "import": "./dist/langchain.js",
+      "types": "./dist/langchain.d.ts"
+    },
+    "./crewai": {
+      "import": "./dist/crewai.js",
+      "types": "./dist/crewai.d.ts"
+    },
+    "./eliza": {
+      "import": "./dist/eliza.js",
+      "types": "./dist/eliza.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "agnt",
+    "langchain",
+    "crewai",
+    "elizaos",
+    "eliza",
+    "agent",
+    "naming",
+    "resolve",
+    "framework",
+    "plugin"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@agnt-id/resolve": ">=0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}