@agentdomain/agentkit-plugin 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,36 +1,57 @@
1
1
  # @agentdomain/agentkit-plugin
2
2
 
3
- Coinbase AgentKit action provider for AgentDomain.
3
+ Coinbase AgentKit action provider for AgentDomain identity infrastructure.
4
+
5
+ ## Install
4
6
 
5
7
  ```bash
6
- npm install @agentdomain/agentkit-plugin
8
+ npm install @agentdomain/agentkit-plugin @coinbase/agentkit
9
+ ```
10
+
11
+ ## Create the provider
12
+
13
+ ```ts
14
+ import { AgentDomainActionProvider } from '@agentdomain/agentkit-plugin';
15
+
16
+ const agentdomain = new AgentDomainActionProvider({
17
+ builderCode: process.env.AGENTDOMAIN_BUILDER_CODE,
18
+ renewalVaultAddress: process.env.RENEWAL_VAULT_ADDRESS,
19
+ });
20
+
21
+ const actions = agentdomain.getActions();
7
22
  ```
8
23
 
24
+ The AgentKit runtime supplies its wallet provider when invoking an action. The
25
+ default API is `https://api.agentdomain.app/api/v1`; set `apiUrl` only when a
26
+ different documented AgentDomain environment is intentionally used.
27
+
28
+ ## Actions
29
+
9
30
  The provider exposes actions for:
10
31
 
11
32
  - Agent identity registration and quote
12
33
  - Registry search
13
34
  - Email send/list/batch, monthly usage, signed inbound webhooks, primary address updates, and Starter/Pro/Enterprise aliases
14
- - Typed DNS list/create/update/delete for all 13 Spaceship-supported types, plus capabilities, batch preview/apply, and BIND import/export
35
+ - Typed DNS list/create/update/delete for all 13 supported types, plus capabilities, batch preview/apply, and BIND import/export
15
36
  - SSL reconfiguration
16
37
  - RenewalVault status, funding, auto-renew, and withdrawal
17
38
  - Per-agent Starter, Pro, and Enterprise Premium Plans
18
39
 
19
- Default API base: `https://agentdomain.app/api/v1`.
20
-
21
- Request the base URL directly to retrieve AgentDomain's machine-readable API discovery metadata.
22
-
23
- Provide your public ERC-8021 app identifier when constructing the action
24
- provider:
25
-
26
- ```ts
27
- const provider = new AgentDomainActionProvider({
28
- builderCode: process.env.AGENTDOMAIN_BUILDER_CODE,
29
- renewalVaultAddress: process.env.RENEWAL_VAULT_ADDRESS,
30
- });
31
- ```
40
+ ## Credentials and transaction safety
32
41
 
33
42
  `builderCode` is required only for direct Base writes such as auto-renew and
34
43
  vault withdrawal. Missing or invalid attribution stops those actions before
35
44
  `walletProvider.sendTransaction`; reads, signatures, and x402 v2 paid requests
36
45
  keep their existing behavior.
46
+
47
+ Use a dedicated wallet with only the authority and funds required by the agent.
48
+ If `apiKey` is used for scoped operations, inject it through a trusted secret
49
+ store and never ship it in source or browser configuration. Preview DNS batches
50
+ before applying them and use registration quotes before authorizing payment.
51
+
52
+ ## Links
53
+
54
+ - [AgentKit guide](https://docs.agentdomain.app/frameworks/agentkit)
55
+ - [API discovery](https://api.agentdomain.app/api/v1)
56
+ - [Source](https://github.com/0xmdrakib/AgentDomain/tree/main/packages/agentkit-plugin)
57
+ - [Security policy](https://github.com/0xmdrakib/AgentDomain/security/policy)
package/dist/index.d.ts CHANGED
@@ -35,17 +35,17 @@ declare const QuoteSchema: z.ZodObject<{
35
35
  }>;
36
36
  declare const SearchSchema: z.ZodObject<{
37
37
  q: z.ZodOptional<z.ZodString>;
38
- framework: z.ZodOptional<z.ZodEnum<["agentkit", "eliza", "crewai", "langchain", "openai", "anthropic"]>>;
38
+ framework: z.ZodOptional<z.ZodEnum<["agentkit", "eliza", "openai", "anthropic"]>>;
39
39
  capability: z.ZodOptional<z.ZodString>;
40
40
  limit: z.ZodDefault<z.ZodNumber>;
41
41
  }, "strip", z.ZodTypeAny, {
42
42
  limit: number;
43
43
  q?: string | undefined;
44
- framework?: "agentkit" | "eliza" | "crewai" | "langchain" | "openai" | "anthropic" | undefined;
44
+ framework?: "agentkit" | "eliza" | "openai" | "anthropic" | undefined;
45
45
  capability?: string | undefined;
46
46
  }, {
47
47
  q?: string | undefined;
48
- framework?: "agentkit" | "eliza" | "crewai" | "langchain" | "openai" | "anthropic" | undefined;
48
+ framework?: "agentkit" | "eliza" | "openai" | "anthropic" | undefined;
49
49
  capability?: string | undefined;
50
50
  limit?: number | undefined;
51
51
  }>;
@@ -165,17 +165,17 @@ export declare class AgentDomainActionProvider {
165
165
  description: string;
166
166
  schema: z.ZodObject<{
167
167
  q: z.ZodOptional<z.ZodString>;
168
- framework: z.ZodOptional<z.ZodEnum<["agentkit", "eliza", "crewai", "langchain", "openai", "anthropic"]>>;
168
+ framework: z.ZodOptional<z.ZodEnum<["agentkit", "eliza", "openai", "anthropic"]>>;
169
169
  capability: z.ZodOptional<z.ZodString>;
170
170
  limit: z.ZodDefault<z.ZodNumber>;
171
171
  }, "strip", z.ZodTypeAny, {
172
172
  limit: number;
173
173
  q?: string | undefined;
174
- framework?: "agentkit" | "eliza" | "crewai" | "langchain" | "openai" | "anthropic" | undefined;
174
+ framework?: "agentkit" | "eliza" | "openai" | "anthropic" | undefined;
175
175
  capability?: string | undefined;
176
176
  }, {
177
177
  q?: string | undefined;
178
- framework?: "agentkit" | "eliza" | "crewai" | "langchain" | "openai" | "anthropic" | undefined;
178
+ framework?: "agentkit" | "eliza" | "openai" | "anthropic" | undefined;
179
179
  capability?: string | undefined;
180
180
  limit?: number | undefined;
181
181
  }>;
package/dist/index.js CHANGED
@@ -239,7 +239,7 @@ export class AgentDomainActionProvider {
239
239
  },
240
240
  {
241
241
  name: 'send_agent_email',
242
- description: 'Send text-only email from an agent primary email or active alias via AWS SES.',
242
+ description: 'Send text-only email from an agent primary email or active alias.',
243
243
  schema: SendEmailSchema,
244
244
  invoke: this.sendEmail.bind(this),
245
245
  },
@@ -293,7 +293,7 @@ export class AgentDomainActionProvider {
293
293
  },
294
294
  {
295
295
  name: 'reconfigure_ssl',
296
- description: 'Rebuild the Cloudflare SaaS SSL hostname and sync the required Spaceship DNS validation records for an existing agent.',
296
+ description: 'Rebuild the managed SSL hostname and sync the required DNS validation records for an existing agent.',
297
297
  schema: SslReconfigureSchema,
298
298
  invoke: this.reconfigureSsl.bind(this),
299
299
  },
@@ -476,7 +476,7 @@ export class AgentDomainActionProvider {
476
476
  async reconfigureSsl(walletProvider, args) {
477
477
  const { ad } = this.createAgentDomain(walletProvider);
478
478
  const result = await ad.reconfigureSsl(args.agentId);
479
- return `SSL reconfigured for ${result.domain}. Cloudflare hostname ${result.cloudflareCustomHostnameId} is ${result.sslStatus} and ${result.validationRecordsCount} validation record(s) were synced.`;
479
+ return `SSL reconfigured for ${result.domain}. Hostname ${result.cloudflareCustomHostnameId} is ${result.sslStatus} and ${result.validationRecordsCount} validation record(s) were synced.`;
480
480
  }
481
481
  async listDns(walletProvider, args) {
482
482
  const { ad } = this.createAgentDomain(walletProvider);
package/package.json CHANGED
@@ -1,12 +1,27 @@
1
1
  {
2
2
  "name": "@agentdomain/agentkit-plugin",
3
- "version": "0.7.0",
4
- "description": "Coinbase AgentKit action provider for AgentDomain",
3
+ "version": "0.8.0",
4
+ "description": "Coinbase AgentKit action provider for AgentDomain identity infrastructure",
5
+ "keywords": [
6
+ "agentdomain",
7
+ "ai-agents",
8
+ "coinbase-agentkit",
9
+ "identity",
10
+ "x402",
11
+ "base"
12
+ ],
5
13
  "license": "Apache-2.0",
6
- "repository": "https://github.com/0xmdrakib/AgentDomain.git",
7
- "homepage": "https://agentdomain.app/docs",
8
- "bugs": "https://github.com/0xmdrakib/AgentDomain/issues",
14
+ "repository": {
15
+ "type": "git",
16
+ "url": "git+https://github.com/0xmdrakib/AgentDomain.git",
17
+ "directory": "packages/agentkit-plugin"
18
+ },
19
+ "homepage": "https://docs.agentdomain.app/frameworks/agentkit",
20
+ "bugs": {
21
+ "url": "https://github.com/0xmdrakib/AgentDomain/issues"
22
+ },
9
23
  "type": "module",
24
+ "sideEffects": false,
10
25
  "main": "./dist/index.js",
11
26
  "types": "./dist/index.d.ts",
12
27
  "exports": {
@@ -28,8 +43,8 @@
28
43
  "dependencies": {
29
44
  "viem": "^2.55.2",
30
45
  "zod": "^3.24.1",
31
- "@agentdomain/shared": "^0.7.0",
32
- "@agentdomain/sdk": "^0.7.0"
46
+ "@agentdomain/sdk": "^0.8.0",
47
+ "@agentdomain/shared": "^0.8.0"
33
48
  },
34
49
  "peerDependencies": {
35
50
  "@coinbase/agentkit": "^0.1.0"