@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 +37 -16
- package/dist/index.d.ts +6 -6
- package/dist/index.js +3 -3
- package/package.json +22 -7
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
|
|
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
|
-
|
|
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", "
|
|
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" | "
|
|
44
|
+
framework?: "agentkit" | "eliza" | "openai" | "anthropic" | undefined;
|
|
45
45
|
capability?: string | undefined;
|
|
46
46
|
}, {
|
|
47
47
|
q?: string | undefined;
|
|
48
|
-
framework?: "agentkit" | "eliza" | "
|
|
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", "
|
|
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" | "
|
|
174
|
+
framework?: "agentkit" | "eliza" | "openai" | "anthropic" | undefined;
|
|
175
175
|
capability?: string | undefined;
|
|
176
176
|
}, {
|
|
177
177
|
q?: string | undefined;
|
|
178
|
-
framework?: "agentkit" | "eliza" | "
|
|
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
|
|
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
|
|
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}.
|
|
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.
|
|
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":
|
|
7
|
-
|
|
8
|
-
|
|
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/
|
|
32
|
-
"@agentdomain/
|
|
46
|
+
"@agentdomain/sdk": "^0.8.0",
|
|
47
|
+
"@agentdomain/shared": "^0.8.0"
|
|
33
48
|
},
|
|
34
49
|
"peerDependencies": {
|
|
35
50
|
"@coinbase/agentkit": "^0.1.0"
|