gbz185-sdk 0.1.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/CHANGELOG.md +12 -0
- package/LICENSE +21 -0
- package/README.md +192 -0
- package/dist/agent-maintenance.d.ts +35 -0
- package/dist/agent-maintenance.d.ts.map +1 -0
- package/dist/agent-maintenance.js +107 -0
- package/dist/agent-maintenance.js.map +1 -0
- package/dist/authorization.d.ts +32 -0
- package/dist/authorization.d.ts.map +1 -0
- package/dist/authorization.js +37 -0
- package/dist/authorization.js.map +1 -0
- package/dist/client.d.ts +39 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +70 -0
- package/dist/client.js.map +1 -0
- package/dist/conformance.d.ts +11 -0
- package/dist/conformance.d.ts.map +1 -0
- package/dist/conformance.js +195 -0
- package/dist/conformance.js.map +1 -0
- package/dist/credentials.d.ts +124 -0
- package/dist/credentials.d.ts.map +1 -0
- package/dist/credentials.js +209 -0
- package/dist/credentials.js.map +1 -0
- package/dist/description-registry.d.ts +66 -0
- package/dist/description-registry.d.ts.map +1 -0
- package/dist/description-registry.js +137 -0
- package/dist/description-registry.js.map +1 -0
- package/dist/discovery.d.ts +14 -0
- package/dist/discovery.d.ts.map +1 -0
- package/dist/discovery.js +105 -0
- package/dist/discovery.js.map +1 -0
- package/dist/factory.d.ts +34 -0
- package/dist/factory.d.ts.map +1 -0
- package/dist/factory.js +98 -0
- package/dist/factory.js.map +1 -0
- package/dist/functional-architecture.d.ts +18 -0
- package/dist/functional-architecture.d.ts.map +1 -0
- package/dist/functional-architecture.js +159 -0
- package/dist/functional-architecture.js.map +1 -0
- package/dist/identity-code.d.ts +8 -0
- package/dist/identity-code.d.ts.map +1 -0
- package/dist/identity-code.js +76 -0
- package/dist/identity-code.js.map +1 -0
- package/dist/identity-registry.d.ts +68 -0
- package/dist/identity-registry.d.ts.map +1 -0
- package/dist/identity-registry.js +155 -0
- package/dist/identity-registry.js.map +1 -0
- package/dist/index.d.ts +19 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +19 -0
- package/dist/index.js.map +1 -0
- package/dist/interaction.d.ts +41 -0
- package/dist/interaction.d.ts.map +1 -0
- package/dist/interaction.js +95 -0
- package/dist/interaction.js.map +1 -0
- package/dist/message-distribution.d.ts +18 -0
- package/dist/message-distribution.d.ts.map +1 -0
- package/dist/message-distribution.js +35 -0
- package/dist/message-distribution.js.map +1 -0
- package/dist/tool-access.d.ts +16 -0
- package/dist/tool-access.d.ts.map +1 -0
- package/dist/tool-access.js +30 -0
- package/dist/tool-access.js.map +1 -0
- package/dist/tools.d.ts +18 -0
- package/dist/tools.d.ts.map +1 -0
- package/dist/tools.js +77 -0
- package/dist/tools.js.map +1 -0
- package/dist/transport.d.ts +21 -0
- package/dist/transport.d.ts.map +1 -0
- package/dist/transport.js +36 -0
- package/dist/transport.js.map +1 -0
- package/dist/types.d.ts +165 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/dist/validation.d.ts +12 -0
- package/dist/validation.d.ts.map +1 -0
- package/dist/validation.js +94 -0
- package/dist/validation.js.map +1 -0
- package/docs/API_REFERENCE.md +116 -0
- package/docs/CONFORMANCE.md +96 -0
- package/docs/GITHUB_PAGES.md +54 -0
- package/docs/NPM_RELEASE.md +107 -0
- package/docs/SDK_GUIDE.md +439 -0
- package/examples/calendar.ts +105 -0
- package/package.json +60 -0
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import {
|
|
2
|
+
createAgentInterconnectRuntime,
|
|
3
|
+
formatIdentityCode,
|
|
4
|
+
type AgentDescription
|
|
5
|
+
} from "../src/index.js";
|
|
6
|
+
|
|
7
|
+
const runtime = createAgentInterconnectRuntime();
|
|
8
|
+
|
|
9
|
+
const requesterId = formatIdentityCode({
|
|
10
|
+
registrationServiceProvider: "A1",
|
|
11
|
+
registrationRequester: "REQ001",
|
|
12
|
+
ontologySerial: "ASSISTANT",
|
|
13
|
+
instanceSerial: "1"
|
|
14
|
+
});
|
|
15
|
+
|
|
16
|
+
const registration = await runtime.client.registerIdentity({
|
|
17
|
+
delegatorId: "example-org",
|
|
18
|
+
subject: "Calendar Agent",
|
|
19
|
+
registrationServiceProvider: "A1",
|
|
20
|
+
registrationRequester: "REQ001",
|
|
21
|
+
ontologySerial: "CALENDAR",
|
|
22
|
+
instanceSerial: "1",
|
|
23
|
+
issueCredential: true,
|
|
24
|
+
credentialAudience: [requesterId],
|
|
25
|
+
credentialScope: ["agent:interact", "tool:invoke"]
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
const description: AgentDescription = {
|
|
29
|
+
agentId: registration.account.id,
|
|
30
|
+
name: "Calendar Agent",
|
|
31
|
+
version: "1.0.0",
|
|
32
|
+
description: "Creates calendar events from natural language task requests",
|
|
33
|
+
provider: "Example Org",
|
|
34
|
+
accessAddress: "local://calendar",
|
|
35
|
+
accessMethod: [{ type: "url", address: "local://calendar" }],
|
|
36
|
+
authentication: { type: "x509" },
|
|
37
|
+
capabilities: { asyncMessages: true, taskStateHistory: true },
|
|
38
|
+
defaultInputTypes: ["text", "json"],
|
|
39
|
+
defaultOutputTypes: ["json"],
|
|
40
|
+
skills: [
|
|
41
|
+
{
|
|
42
|
+
skillId: "schedule.add",
|
|
43
|
+
skillName: "add_schedule",
|
|
44
|
+
skillDescription: "Add one calendar schedule item",
|
|
45
|
+
tags: ["calendar", "schedule"],
|
|
46
|
+
inputTypes: ["text", "json"],
|
|
47
|
+
outputTypes: ["json"]
|
|
48
|
+
}
|
|
49
|
+
]
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
await runtime.client.registerDescription(description);
|
|
53
|
+
await runtime.client.publishDescription(description.agentId);
|
|
54
|
+
await runtime.toolRuntime.registerTool(
|
|
55
|
+
{
|
|
56
|
+
toolId: "calendar.add",
|
|
57
|
+
toolName: "add_schedule",
|
|
58
|
+
toolDescription: "Add one calendar event",
|
|
59
|
+
toolVersion: "1.0.0",
|
|
60
|
+
toolInputParam: { date: "string", time: "string", event: "string" },
|
|
61
|
+
toolOutputParam: { eventId: "string", accepted: "boolean" }
|
|
62
|
+
},
|
|
63
|
+
(input) => ({
|
|
64
|
+
eventId: `evt-${input.date}-${input.time}`,
|
|
65
|
+
accepted: true
|
|
66
|
+
})
|
|
67
|
+
);
|
|
68
|
+
|
|
69
|
+
const [match] = await runtime.client.discover({ text: "calendar schedule", requiredSkills: ["schedule.add"] });
|
|
70
|
+
if (!match) {
|
|
71
|
+
throw new Error("Calendar agent was not discovered");
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
const session = await runtime.client.createSession({
|
|
75
|
+
mode: "point_to_point",
|
|
76
|
+
sender: { agentId: requesterId },
|
|
77
|
+
receivers: [{ agentId: match.description.agentId, mode: "point_to_point", accessAddress: match.description.accessAddress }]
|
|
78
|
+
});
|
|
79
|
+
const task = await runtime.client.submitTask({ sessionId: session.id });
|
|
80
|
+
const toolResult = await runtime.client.invokeTools({
|
|
81
|
+
sessionId: session.id,
|
|
82
|
+
toolInvokeList: [
|
|
83
|
+
{
|
|
84
|
+
toolId: "calendar.add",
|
|
85
|
+
toolVersion: "1.0.0",
|
|
86
|
+
toolInputParam: {
|
|
87
|
+
date: "2026-06-26",
|
|
88
|
+
time: "10:00",
|
|
89
|
+
event: "GB/Z 185 SDK review"
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
]
|
|
93
|
+
});
|
|
94
|
+
await runtime.client.sendMessage({
|
|
95
|
+
senderRole: "service",
|
|
96
|
+
senderId: match.description.agentId,
|
|
97
|
+
sessionId: session.id,
|
|
98
|
+
taskId: task.id,
|
|
99
|
+
artifact: "work_result",
|
|
100
|
+
final: true,
|
|
101
|
+
lastChunk: true,
|
|
102
|
+
dataItems: [{ type: "application/json", metadata: {}, payload: toolResult.toolResultList[0] ?? null }]
|
|
103
|
+
});
|
|
104
|
+
|
|
105
|
+
console.log(JSON.stringify({ discovered: match.description.name, sessionId: session.id, toolResult }, null, 2));
|
package/package.json
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "gbz185-sdk",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "TypeScript SDK and reference runtime for GB/Z 185-2026 AI agent interconnection.",
|
|
5
|
+
"homepage": "https://blogs.idevlab.dev/gbz185-sdk/",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "git+https://github.com/IchenDEV/gbz185-sdk.git"
|
|
9
|
+
},
|
|
10
|
+
"bugs": {
|
|
11
|
+
"url": "https://github.com/IchenDEV/gbz185-sdk/issues"
|
|
12
|
+
},
|
|
13
|
+
"type": "module",
|
|
14
|
+
"license": "MIT",
|
|
15
|
+
"packageManager": "pnpm@11.7.0",
|
|
16
|
+
"sideEffects": false,
|
|
17
|
+
"main": "./dist/index.js",
|
|
18
|
+
"types": "./dist/index.d.ts",
|
|
19
|
+
"exports": {
|
|
20
|
+
".": {
|
|
21
|
+
"types": "./dist/index.d.ts",
|
|
22
|
+
"import": "./dist/index.js"
|
|
23
|
+
}
|
|
24
|
+
},
|
|
25
|
+
"publishConfig": {
|
|
26
|
+
"access": "public"
|
|
27
|
+
},
|
|
28
|
+
"files": [
|
|
29
|
+
"dist",
|
|
30
|
+
"docs",
|
|
31
|
+
"CHANGELOG.md",
|
|
32
|
+
"LICENSE",
|
|
33
|
+
"README.md",
|
|
34
|
+
"examples"
|
|
35
|
+
],
|
|
36
|
+
"scripts": {
|
|
37
|
+
"build": "tsc -p tsconfig.build.json",
|
|
38
|
+
"example:calendar": "tsx examples/calendar.ts",
|
|
39
|
+
"pack:check": "npm pack --dry-run",
|
|
40
|
+
"prepublishOnly": "pnpm typecheck && pnpm test && pnpm build && pnpm example:calendar && pnpm pack:check",
|
|
41
|
+
"test": "vitest run",
|
|
42
|
+
"typecheck": "tsc -p tsconfig.json --noEmit"
|
|
43
|
+
},
|
|
44
|
+
"keywords": [
|
|
45
|
+
"agent",
|
|
46
|
+
"gbz185",
|
|
47
|
+
"ai",
|
|
48
|
+
"sdk",
|
|
49
|
+
"interconnection"
|
|
50
|
+
],
|
|
51
|
+
"engines": {
|
|
52
|
+
"node": ">=20"
|
|
53
|
+
},
|
|
54
|
+
"devDependencies": {
|
|
55
|
+
"@types/node": "^24.0.0",
|
|
56
|
+
"tsx": "^4.22.4",
|
|
57
|
+
"typescript": "^5.8.0",
|
|
58
|
+
"vitest": "^3.2.0"
|
|
59
|
+
}
|
|
60
|
+
}
|