@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,115 @@
1
+ /**
2
+ * @file interactive.ts
3
+ * @description The default action: a two-level interactive shell.
4
+ *
5
+ * L1 — manager REPL (`0g-agentdna>`): list your agents, link one, deploy a
6
+ * new one, configure the environment (attestor URL) and wallet.
7
+ * L2 — session REPL (`agent 286 ›`): chat with one agent. Esc / Ctrl-C
8
+ * interrupts a turn in flight; `/back` returns to L1; `/quit` exits.
9
+ *
10
+ * One readline drives both levels, so interrupt handling (a streaming turn's
11
+ * AbortController) is managed in one place. Owner-key checks are LAZY: L1 is
12
+ * reachable with only an attestor URL; `link`/`deploy` (signing operations)
13
+ * check for a key and point you at `login` if it's missing.
14
+ */
15
+ /** -1/0/1 numeric dot-compare ("0.1.9" < "0.1.10"). Exported for tests —
16
+ * a wrong compare either nags forever or never hints. */
17
+ export declare function compareVersions(a: string, b: string): number;
18
+ /** Short environment marker for prompts/errors: the attestor's hostname.
19
+ * Exported for tests. */
20
+ export declare function hostOf(url?: string): string;
21
+ /**
22
+ * A failure meaning the SEAT was taken (occupancy.go): HTTP 409 with
23
+ * 'displaced' or 'in use by another client' in the body. The seat gates the
24
+ * chat turn and the seat-gated POSTs (cancelTask, /clear, /compact, the
25
+ * interrupt brake) — all of them route through the displaced-seat prompt
26
+ * instead of surfacing the raw error. The status-check GETs (task()) are
27
+ * ungated today, so their routing is defensive: if the gate ever widens,
28
+ * those paths still do the right thing. Exported for the tests: this is the
29
+ * routing decision (which errors are seat events, not task errors).
30
+ */
31
+ export declare function displacedFailure(failure: string): boolean;
32
+ /**
33
+ * The Esc brake's failure line — a PURE function on purpose. The brake fires
34
+ * on an idle Esc, and at that moment the main loop is parked in its own
35
+ * ask() prompt; calling ask() from here (via the seat handler) would queue a
36
+ * second waiter, and ask hands lines out FIFO — the user's Enter would go to
37
+ * the wrong prompt (a bare-Enter status refresh instead of a reclaim), and
38
+ * their next chat message would be eaten as the prompt's non-empty answer.
39
+ * So a displaced 409 prints a NOTICE that points at the paths which CAN
40
+ * prompt (a chat turn, /cancel); every other failure keeps the old raw line.
41
+ * Taking no ask and returning a string is the guarantee — pinned by a test
42
+ * that drives the brake while a loop ask is pending.
43
+ */
44
+ /**
45
+ * The Esc brake: an idle Esc interrupts whatever the agent is still running
46
+ * in the background. A top-level factory so the test can drive the REAL
47
+ * handler (the 06d7a7d regression hid inside sessionRepl where no test could
48
+ * reach it): `seat` is passed in and must NEVER be invoked — the brake fires
49
+ * while the loop's ask() is pending, and any prompt from here is the FIFO
50
+ * bug. `seatPromptPending` keeps the brake quiet while displacedSeat's own
51
+ * prompt is on screen (firing then would print contradictory advice under a
52
+ * prompt that is waiting for an answer).
53
+ */
54
+ export declare function makeBrake(getClient: () => {
55
+ interrupt?: () => Promise<{
56
+ aborted: boolean;
57
+ note?: string;
58
+ }>;
59
+ } | null | undefined, print: (line: string) => void, seat: (failure: string, reclaimedHint: string, leavesWhat?: string) => Promise<'reclaimed' | 'left' | null>, seatPromptPending: () => boolean): () => void;
60
+ export declare function brakeInterruptLine(e: unknown): string;
61
+ /**
62
+ * The shared catch for a gated-POST failure: displaced → the seat handler
63
+ * (which prompts and may reclaim); anything else → the caller's raw line.
64
+ * `leavesWhat` for these paths is "leaves the seat with the other client" —
65
+ * unlike the chat turn, declining does NOT close this window. Exported for
66
+ * the tests: every task-path catch routes through here, so the routing
67
+ * behavior is pinned in one place.
68
+ */
69
+ export declare function routeTaskFailure(print: (line: string) => void, seat: (failure: string, reclaimedHint: string, leavesWhat?: string) => Promise<'reclaimed' | 'left' | null>, e: unknown, rawLine: string, seatHint: string): Promise<'reclaimed' | 'left' | 'raw'>;
70
+ /**
71
+ * The tasks bare `/cancel` stops: everything still in flight, NEWEST FIRST
72
+ * (stopping only the newest would leave an older running turn alive; dsh/
73
+ * prime serialize turns, so a queued one is waiting on the running one).
74
+ * Statuses arrive live from the agent; "unknown" (evicted or agent
75
+ * restarted, 404) counts as not in flight — cancelling an unknown record
76
+ * would claim to stop something nobody can see. Exported for the tests:
77
+ * this is the re-attach story's decision core.
78
+ */
79
+ export declare function inFlightIds(rows: Array<{
80
+ id: string;
81
+ status: string;
82
+ }>): string[];
83
+ export declare function completeTail(cmd: string, word: string, models: string[], providers?: string[]): string[];
84
+ export declare function completeLine(line: string, state: {
85
+ completions: string[];
86
+ args: Record<string, string[] | (() => string[])>;
87
+ models: string[];
88
+ provider?: string;
89
+ providerModels?: Record<string, string[]>;
90
+ providers?: string[];
91
+ }): [string[], string];
92
+ import type { CommandContext } from '../types';
93
+ /** The REPL listing's header line, aligned with {@link renderListRow}. */
94
+ export declare function renderListHeader(): string;
95
+ /**
96
+ * One row of the REPL's agent listing. Exported for the tests: this IS the
97
+ * renderer the interactive loop prints. Its cells go through ./cells, shared
98
+ * with `list`: a name cannot forge rows in this listing either, and an
99
+ * agent-owned agent reads the same way — its OWNER is another row's
100
+ * AGENTSEAL, annotated `⇄ #<agentId>` (`sealToAgent`, from the full listing).
101
+ * SEAL is the sealId PREFIX (`0x` + 10 hex), the form commands accept as a
102
+ * reference, so unminted rows stay referenceable without a 66-char column
103
+ * blowout (F12).
104
+ * AGENTSEAL is the agent's on-chain signing address.
105
+ */
106
+ export declare function renderListRow(r: {
107
+ agentId: bigint | number | null;
108
+ phase?: string | null;
109
+ sealId: string;
110
+ name?: string | null;
111
+ framework?: string | null;
112
+ agentSeal?: string | null;
113
+ }, owner: string | null | undefined, owned?: string, sealToAgent?: ReadonlyMap<string, string>): string;
114
+ export declare function run(ctx: CommandContext): Promise<void>;
115
+ //# sourceMappingURL=interactive.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/interactive.ts"],"names":[],"mappings":"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"}