@0gfoundation/0g-agentdna 0.0.0-stage → 0.2.1

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.
Files changed (206) hide show
  1. package/GUIDE.md +975 -0
  2. package/LICENSE +21 -0
  3. package/MIGRATION.md +84 -0
  4. package/MIGRATION.zh.md +70 -0
  5. package/PROVIDERS.md +273 -0
  6. package/PROVIDERS.zh.md +234 -0
  7. package/README.md +334 -2
  8. package/dist/AgentClient.d.ts +312 -0
  9. package/dist/AgentClient.d.ts.map +1 -0
  10. package/dist/AgentClient.js +715 -0
  11. package/dist/AgentClient.js.map +1 -0
  12. package/dist/AgenticID.d.ts +823 -0
  13. package/dist/AgenticID.d.ts.map +1 -0
  14. package/dist/AgenticID.js +1188 -0
  15. package/dist/AgenticID.js.map +1 -0
  16. package/dist/AgenticIDClient.d.ts +68 -0
  17. package/dist/AgenticIDClient.d.ts.map +1 -0
  18. package/dist/AgenticIDClient.js +198 -0
  19. package/dist/AgenticIDClient.js.map +1 -0
  20. package/dist/AttestorClient.d.ts +465 -0
  21. package/dist/AttestorClient.d.ts.map +1 -0
  22. package/dist/AttestorClient.js +1030 -0
  23. package/dist/AttestorClient.js.map +1 -0
  24. package/dist/Providers.d.ts +72 -0
  25. package/dist/Providers.d.ts.map +1 -0
  26. package/dist/Providers.js +182 -0
  27. package/dist/Providers.js.map +1 -0
  28. package/dist/ReputationClient.d.ts +213 -0
  29. package/dist/ReputationClient.d.ts.map +1 -0
  30. package/dist/ReputationClient.js +708 -0
  31. package/dist/ReputationClient.js.map +1 -0
  32. package/dist/SandboxClient.d.ts +107 -0
  33. package/dist/SandboxClient.d.ts.map +1 -0
  34. package/dist/SandboxClient.js +200 -0
  35. package/dist/SandboxClient.js.map +1 -0
  36. package/dist/ServeProof.d.ts +161 -0
  37. package/dist/ServeProof.d.ts.map +1 -0
  38. package/dist/ServeProof.js +230 -0
  39. package/dist/ServeProof.js.map +1 -0
  40. package/dist/ServeSession.d.ts +180 -0
  41. package/dist/ServeSession.d.ts.map +1 -0
  42. package/dist/ServeSession.js +336 -0
  43. package/dist/ServeSession.js.map +1 -0
  44. package/dist/Settings.d.ts +179 -0
  45. package/dist/Settings.d.ts.map +1 -0
  46. package/dist/Settings.js +247 -0
  47. package/dist/Settings.js.map +1 -0
  48. package/dist/abi.d.ts +2216 -0
  49. package/dist/abi.d.ts.map +1 -0
  50. package/dist/abi.js +1248 -0
  51. package/dist/abi.js.map +1 -0
  52. package/dist/cli/commands/cells.d.ts +62 -0
  53. package/dist/cli/commands/cells.d.ts.map +1 -0
  54. package/dist/cli/commands/cells.js +113 -0
  55. package/dist/cli/commands/cells.js.map +1 -0
  56. package/dist/cli/commands/doctor.d.ts +15 -0
  57. package/dist/cli/commands/doctor.d.ts.map +1 -0
  58. package/dist/cli/commands/doctor.js +236 -0
  59. package/dist/cli/commands/doctor.js.map +1 -0
  60. package/dist/cli/commands/interactive.d.ts +115 -0
  61. package/dist/cli/commands/interactive.d.ts.map +1 -0
  62. package/dist/cli/commands/interactive.js +3052 -0
  63. package/dist/cli/commands/interactive.js.map +1 -0
  64. package/dist/cli/commands/list.d.ts +31 -0
  65. package/dist/cli/commands/list.d.ts.map +1 -0
  66. package/dist/cli/commands/list.js +91 -0
  67. package/dist/cli/commands/list.js.map +1 -0
  68. package/dist/cli/commands/providers.d.ts +3 -0
  69. package/dist/cli/commands/providers.d.ts.map +1 -0
  70. package/dist/cli/commands/providers.js +21 -0
  71. package/dist/cli/commands/providers.js.map +1 -0
  72. package/dist/cli/commands/settings.d.ts +22 -0
  73. package/dist/cli/commands/settings.d.ts.map +1 -0
  74. package/dist/cli/commands/settings.js +188 -0
  75. package/dist/cli/commands/settings.js.map +1 -0
  76. package/dist/cli/commands/status.d.ts +16 -0
  77. package/dist/cli/commands/status.d.ts.map +1 -0
  78. package/dist/cli/commands/status.js +148 -0
  79. package/dist/cli/commands/status.js.map +1 -0
  80. package/dist/cli/commands/update.d.ts +21 -0
  81. package/dist/cli/commands/update.d.ts.map +1 -0
  82. package/dist/cli/commands/update.js +95 -0
  83. package/dist/cli/commands/update.js.map +1 -0
  84. package/dist/cli/config.d.ts +73 -0
  85. package/dist/cli/config.d.ts.map +1 -0
  86. package/dist/cli/config.js +239 -0
  87. package/dist/cli/config.js.map +1 -0
  88. package/dist/cli/env.d.ts +36 -0
  89. package/dist/cli/env.d.ts.map +1 -0
  90. package/dist/cli/env.js +74 -0
  91. package/dist/cli/env.js.map +1 -0
  92. package/dist/cli/envelope.d.ts +33 -0
  93. package/dist/cli/envelope.d.ts.map +1 -0
  94. package/dist/cli/envelope.js +62 -0
  95. package/dist/cli/envelope.js.map +1 -0
  96. package/dist/cli/errors.d.ts +48 -0
  97. package/dist/cli/errors.d.ts.map +1 -0
  98. package/dist/cli/errors.js +81 -0
  99. package/dist/cli/errors.js.map +1 -0
  100. package/dist/cli/inference.d.ts +21 -0
  101. package/dist/cli/inference.d.ts.map +1 -0
  102. package/dist/cli/inference.js +60 -0
  103. package/dist/cli/inference.js.map +1 -0
  104. package/dist/cli/logo.d.ts +21 -0
  105. package/dist/cli/logo.d.ts.map +1 -0
  106. package/dist/cli/logo.js +131 -0
  107. package/dist/cli/logo.js.map +1 -0
  108. package/dist/cli/main.d.ts +14 -0
  109. package/dist/cli/main.d.ts.map +1 -0
  110. package/dist/cli/main.js +223 -0
  111. package/dist/cli/main.js.map +1 -0
  112. package/dist/cli/proofs.d.ts +67 -0
  113. package/dist/cli/proofs.d.ts.map +1 -0
  114. package/dist/cli/proofs.js +133 -0
  115. package/dist/cli/proofs.js.map +1 -0
  116. package/dist/cli/ref.d.ts +39 -0
  117. package/dist/cli/ref.d.ts.map +1 -0
  118. package/dist/cli/ref.js +48 -0
  119. package/dist/cli/ref.js.map +1 -0
  120. package/dist/cli/sdk.d.ts +24 -0
  121. package/dist/cli/sdk.d.ts.map +1 -0
  122. package/dist/cli/sdk.js +65 -0
  123. package/dist/cli/sdk.js.map +1 -0
  124. package/dist/cli/settings.d.ts +66 -0
  125. package/dist/cli/settings.d.ts.map +1 -0
  126. package/dist/cli/settings.js +137 -0
  127. package/dist/cli/settings.js.map +1 -0
  128. package/dist/cli/tokenize.d.ts +61 -0
  129. package/dist/cli/tokenize.d.ts.map +1 -0
  130. package/dist/cli/tokenize.js +157 -0
  131. package/dist/cli/tokenize.js.map +1 -0
  132. package/dist/cli/types.d.ts +25 -0
  133. package/dist/cli/types.d.ts.map +1 -0
  134. package/dist/cli/types.js +8 -0
  135. package/dist/cli/types.js.map +1 -0
  136. package/dist/constants.d.ts +107 -0
  137. package/dist/constants.d.ts.map +1 -0
  138. package/dist/constants.js +74 -0
  139. package/dist/constants.js.map +1 -0
  140. package/dist/context.d.ts +108 -0
  141. package/dist/context.d.ts.map +1 -0
  142. package/dist/context.js +64 -0
  143. package/dist/context.js.map +1 -0
  144. package/dist/index.d.ts +45 -0
  145. package/dist/index.d.ts.map +1 -0
  146. package/dist/index.js +118 -0
  147. package/dist/index.js.map +1 -0
  148. package/dist/provider-catalog.json +23 -0
  149. package/dist/seal.d.ts +47 -0
  150. package/dist/seal.d.ts.map +1 -0
  151. package/dist/seal.js +145 -0
  152. package/dist/seal.js.map +1 -0
  153. package/dist/secretEnv.d.ts +119 -0
  154. package/dist/secretEnv.d.ts.map +1 -0
  155. package/dist/secretEnv.js +199 -0
  156. package/dist/secretEnv.js.map +1 -0
  157. package/dist/taskHash.d.ts +39 -0
  158. package/dist/taskHash.d.ts.map +1 -0
  159. package/dist/taskHash.js +119 -0
  160. package/dist/taskHash.js.map +1 -0
  161. package/dist/types.d.ts +336 -0
  162. package/dist/types.d.ts.map +1 -0
  163. package/dist/types.js +19 -0
  164. package/dist/types.js.map +1 -0
  165. package/package.json +75 -4
  166. package/scripts/sync-providers.cjs +8 -0
  167. package/src/AgentClient.ts +897 -0
  168. package/src/AgenticID.ts +1382 -0
  169. package/src/AgenticIDClient.ts +238 -0
  170. package/src/AttestorClient.ts +1306 -0
  171. package/src/Providers.ts +176 -0
  172. package/src/ReputationClient.ts +821 -0
  173. package/src/SandboxClient.ts +227 -0
  174. package/src/ServeProof.ts +290 -0
  175. package/src/ServeSession.ts +421 -0
  176. package/src/Settings.ts +296 -0
  177. package/src/abi.ts +1282 -0
  178. package/src/cli/commands/cells.ts +107 -0
  179. package/src/cli/commands/doctor.ts +235 -0
  180. package/src/cli/commands/interactive.ts +2738 -0
  181. package/src/cli/commands/list.ts +95 -0
  182. package/src/cli/commands/providers.ts +16 -0
  183. package/src/cli/commands/settings.ts +197 -0
  184. package/src/cli/commands/status.ts +170 -0
  185. package/src/cli/commands/update.ts +86 -0
  186. package/src/cli/config.ts +225 -0
  187. package/src/cli/env.ts +90 -0
  188. package/src/cli/envelope.ts +57 -0
  189. package/src/cli/errors.ts +114 -0
  190. package/src/cli/inference.ts +57 -0
  191. package/src/cli/logo.ts +125 -0
  192. package/src/cli/main.ts +235 -0
  193. package/src/cli/proofs.ts +160 -0
  194. package/src/cli/ref.ts +58 -0
  195. package/src/cli/sdk.ts +65 -0
  196. package/src/cli/settings.ts +153 -0
  197. package/src/cli/tokenize.ts +131 -0
  198. package/src/cli/types.ts +27 -0
  199. package/src/constants.ts +106 -0
  200. package/src/context.ts +161 -0
  201. package/src/index.ts +129 -0
  202. package/src/provider-catalog.json +23 -0
  203. package/src/seal.ts +163 -0
  204. package/src/secretEnv.ts +250 -0
  205. package/src/taskHash.ts +100 -0
  206. package/src/types.ts +357 -0
@@ -0,0 +1,176 @@
1
+ import { sha256 } from '@noble/hashes/sha2';
2
+ import { bytesToHex } from 'viem';
3
+ import definitions from './provider-catalog.json';
4
+
5
+ export type InferenceFormat = 'openai' | 'anthropic';
6
+ /** Exact accepted registry authorized with an encrypted inference credential. */
7
+ export interface ProviderRegistryPin { version: number; digest?: string }
8
+ export interface InferenceModel {
9
+ id: string;
10
+ type?: string;
11
+ supported_formats?: string[];
12
+ context_length?: number;
13
+ max_completion_tokens?: number;
14
+ supported_parameters?: string[];
15
+ }
16
+ export interface InferenceProvider {
17
+ id: string;
18
+ name: string;
19
+ native?: boolean;
20
+ formats: InferenceFormat[];
21
+ defaultFormat?: InferenceFormat;
22
+ endpoints?: Partial<Record<InferenceFormat, string>>;
23
+ modelCatalog?: string;
24
+ models?: InferenceModel[];
25
+ compatibility?: Record<string, boolean | string>;
26
+ }
27
+
28
+ /** Offline/built-in seed. Instance registries discover operator-published definitions. */
29
+ export function listInferenceProviders(): InferenceProvider[] {
30
+ return JSON.parse(JSON.stringify(definitions)) as InferenceProvider[];
31
+ }
32
+
33
+ export function inferenceProvider(id: string): InferenceProvider {
34
+ const provider = listInferenceProviders().find((p) => p.id === id);
35
+ if (!provider) throw new Error(`UNSUPPORTED_INFERENCE_PROVIDER: ${id}`);
36
+ return provider;
37
+ }
38
+
39
+ export async function inferenceModels(provider = '0g-compute'): Promise<InferenceModel[]> {
40
+ return modelsForProvider(inferenceProvider(provider));
41
+ }
42
+
43
+ export async function modelsForProvider(definition: InferenceProvider): Promise<InferenceModel[]> {
44
+ const provider = definition.id;
45
+ if (!definition.modelCatalog) return definition.models ?? [];
46
+ const response = await fetch(definition.modelCatalog, { signal: AbortSignal.timeout(10_000) });
47
+ if (!response.ok) throw new Error(`listModels: ${provider} returned HTTP ${response.status}`);
48
+ const body = await response.json() as { data?: InferenceModel[] };
49
+ return (body.data ?? []).filter((m) => typeof m.id === 'string' && m.id.length > 0);
50
+ }
51
+
52
+ export function changesProvider(current: { provider?: string } | null, next: { provider?: string }): boolean {
53
+ return (current?.provider ?? '0g-compute') !== (next.provider ?? '0g-compute');
54
+ }
55
+
56
+ /** A fresh agent must exist before its key can be bound to a dynamic route.
57
+ * Only the unchanged built-in compute route supports legacy one-shot deploy. */
58
+ export function requiresMintFirst(provider: InferenceProvider): boolean {
59
+ return provider.id !== '0g-compute' || routeHash(provider) !== routeHash(inferenceProvider('0g-compute'));
60
+ }
61
+
62
+ /** Hash only routing/authentication inputs. Model metadata can change without
63
+ * authorizing a different recipient for the key. Field order is a wire contract. */
64
+ export function routeHash(provider: InferenceProvider): `0x${string}` {
65
+ validateProvider(provider);
66
+ const preimage = ['AgentDNA.InferenceRoute.v1', provider.id, provider.native ? '1' : '0',
67
+ [...provider.formats].sort().join(','), provider.defaultFormat ?? '',
68
+ provider.endpoints?.openai ?? '', provider.endpoints?.anthropic ?? '', ''].join('\n');
69
+ return bytesToHex(sha256(new TextEncoder().encode(preimage)));
70
+ }
71
+
72
+ export function registrySigningMessage(document: string): string {
73
+ return `AgentDNA.ProviderRegistry.v1:${bytesToHex(sha256(new TextEncoder().encode(document))).slice(2)}`;
74
+ }
75
+
76
+ /** Fingerprint of an envelope accepted by the attestor, anchored to its
77
+ * trusted /config response. Keeps historical contract signatures readable. */
78
+ export function acceptedRegistryDigest(document: string, signature: string): `0x${string}` {
79
+ const documentHash = bytesToHex(sha256(new TextEncoder().encode(document))).slice(2);
80
+ return bytesToHex(sha256(new TextEncoder().encode(`AgentDNA.ProviderRegistryAccepted.v1:${documentHash}:${signature}`)));
81
+ }
82
+
83
+ export function validateProvider(provider: InferenceProvider): void {
84
+ const validURL = (raw: string): boolean => {
85
+ try {
86
+ const u = new URL(raw);
87
+ return !/[\u0000-\u001f\u007f]/.test(raw) && u.protocol === 'https:' && !!u.hostname && !u.username && !u.password && !u.search && !u.hash;
88
+ } catch { return false; }
89
+ };
90
+ if (!provider || !/^[a-z0-9][a-z0-9-]{0,63}$/.test(provider.id) || !provider.name?.trim() ||
91
+ !Array.isArray(provider.formats) || !provider.formats.length || provider.formats.length > 2 ||
92
+ new Set(provider.formats).size !== provider.formats.length ||
93
+ provider.formats.some((format) => !['openai', 'anthropic'].includes(format))) throw new Error('invalid inference provider');
94
+ if (provider.native) {
95
+ if (!['openai', 'anthropic'].includes(provider.id) || provider.formats.length !== 1 || provider.formats[0] !== provider.id ||
96
+ Object.keys(provider.endpoints ?? {}).length || provider.modelCatalog || provider.defaultFormat) throw new Error('invalid native provider');
97
+ } else if (!provider.defaultFormat || !provider.formats.includes(provider.defaultFormat) ||
98
+ Object.keys(provider.endpoints ?? {}).length !== provider.formats.length ||
99
+ provider.formats.some((format) => !validURL(provider.endpoints?.[format] ?? ''))) throw new Error('invalid managed provider endpoints');
100
+ if (provider.modelCatalog && !validURL(provider.modelCatalog)) throw new Error('invalid provider model catalog');
101
+ }
102
+
103
+ export interface ProviderRegistrySnapshot {
104
+ version: number;
105
+ providers: InferenceProvider[];
106
+ document?: string;
107
+ signature?: `0x${string}`;
108
+ }
109
+
110
+ /** Scoped to one trusted attestor. No global registry shared across environments. */
111
+ export class ProviderRegistryClient {
112
+ private snapshot: ProviderRegistrySnapshot = { version: 0, providers: listInferenceProviders() };
113
+ private seenRemote = false;
114
+ private request?: Promise<ProviderRegistrySnapshot>;
115
+ private requestTrust?: string;
116
+ constructor(private readonly baseUrl?: string) {}
117
+
118
+ list(): InferenceProvider[] { return JSON.parse(JSON.stringify(this.snapshot.providers)); }
119
+ async refresh(config: { chainId?: number; contract?: string; appId?: string; tappRegistry?: string; version?: number; digest?: string } = {}): Promise<ProviderRegistrySnapshot> {
120
+ const trust = stableJSON(config);
121
+ if (this.request) {
122
+ if (this.requestTrust === trust) return this.request;
123
+ try { await this.request; } catch { /* this caller validates its own discovery */ }
124
+ return this.refresh(config);
125
+ }
126
+ this.requestTrust = trust;
127
+ this.request = this.fetchSnapshot(config).finally(() => { this.request = undefined; });
128
+ return this.request;
129
+ }
130
+ private async fetchSnapshot(config: { chainId?: number; contract?: string; appId?: string; tappRegistry?: string; version?: number; digest?: string }): Promise<ProviderRegistrySnapshot> {
131
+ if (!this.baseUrl) return structuredClone(this.snapshot);
132
+ const response = await fetch(`${this.baseUrl.replace(/\/$/, '')}/inference/providers`, { signal: AbortSignal.timeout(10_000) });
133
+ if (!response.ok) throw new Error(`provider registry: HTTP ${response.status}`);
134
+ const raw = await response.text();
135
+ if (raw.length > 512 * 1024) throw new Error('provider registry too large');
136
+ const next = JSON.parse(raw) as ProviderRegistrySnapshot;
137
+ if (!Number.isSafeInteger(next.version) || next.version < this.snapshot.version || !Array.isArray(next.providers) ||
138
+ !next.providers.length || next.providers.length > 128) throw new Error('invalid/rolled-back provider registry');
139
+ const ids = new Set<string>();
140
+ for (const provider of next.providers) {
141
+ validateProvider(provider);
142
+ if (ids.has(provider.id)) throw new Error('duplicate provider');
143
+ ids.add(provider.id);
144
+ }
145
+ if (!ids.has('0g-compute')) throw new Error('registry must retain 0g-compute');
146
+ if (config.version !== undefined && next.version !== config.version) throw new Error('provider registry changed while loading');
147
+ if (next.version === 0) {
148
+ if (stableJSON(next.providers) !== stableJSON(listInferenceProviders())) throw new Error('unsigned provider registry changed');
149
+ } else {
150
+ if (!next.document || !next.signature) throw new Error('provider registry signature missing');
151
+ const doc = JSON.parse(next.document) as { schema: number; chain_id: number; agentic_id_addr: string; tapp_registry_addr: string; attestor_app_id: string; base_version: number; providers: InferenceProvider[] };
152
+ if (doc.schema !== 1 || doc.base_version + 1 !== next.version ||
153
+ (config.chainId !== undefined && doc.chain_id !== config.chainId) ||
154
+ (config.contract && doc.agentic_id_addr.toLowerCase() !== config.contract.toLowerCase()) ||
155
+ (config.appId && doc.attestor_app_id !== config.appId) ||
156
+ (config.tappRegistry && doc.tapp_registry_addr.toLowerCase() !== config.tappRegistry.toLowerCase())) throw new Error('provider registry environment/version mismatch');
157
+ if (!config.digest || acceptedRegistryDigest(next.document, next.signature) !== config.digest.toLowerCase()) throw new Error('provider registry acceptance digest mismatch');
158
+ if (JSON.stringify(doc.providers) !== JSON.stringify(next.providers)) {
159
+ // The read endpoint may re-order object keys while serializing Rust
160
+ // structs. Compare normalized values, then use the signed definitions.
161
+ if (stableJSON(doc.providers) !== stableJSON(next.providers)) throw new Error('provider registry content mismatch');
162
+ }
163
+ next.providers = doc.providers;
164
+ }
165
+ if (this.seenRemote && next.version === this.snapshot.version && stableJSON(next.providers) !== stableJSON(this.snapshot.providers)) throw new Error('provider revision changed without version bump');
166
+ this.snapshot = structuredClone(next);
167
+ this.seenRemote = true;
168
+ return structuredClone(next);
169
+ }
170
+ }
171
+
172
+ function stableJSON(value: unknown): string {
173
+ if (Array.isArray(value)) return `[${value.map(stableJSON).join(',')}]`;
174
+ if (value && typeof value === 'object') return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableJSON((value as Record<string, unknown>)[key])}`).join(',')}}`;
175
+ return JSON.stringify(value);
176
+ }