@cello-protocol/cli 0.0.306 → 0.0.308

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 (234) hide show
  1. package/.claude-plugin/marketplace.json +15 -0
  2. package/README.md +107 -0
  3. package/dist/cli.d.ts +2 -0
  4. package/dist/cli.js +602 -0
  5. package/dist/daemon/account-page-assets.d.ts +4 -0
  6. package/dist/daemon/account-page-assets.js +160 -0
  7. package/dist/daemon/account-page.d.ts +14 -0
  8. package/dist/daemon/account-page.js +104 -0
  9. package/dist/daemon/address.d.ts +10 -0
  10. package/dist/daemon/address.js +34 -0
  11. package/dist/daemon/away.d.ts +31 -0
  12. package/dist/daemon/away.js +65 -0
  13. package/dist/daemon/channel-store.d.ts +112 -0
  14. package/dist/daemon/channel-store.js +284 -0
  15. package/dist/daemon/channels.d.ts +46 -0
  16. package/dist/daemon/channels.js +1049 -0
  17. package/dist/daemon/contacts.d.ts +26 -0
  18. package/dist/daemon/contacts.js +74 -0
  19. package/dist/daemon/engine.d.ts +82 -0
  20. package/dist/daemon/engine.js +2882 -0
  21. package/dist/daemon/errors.d.ts +5 -0
  22. package/dist/daemon/errors.js +16 -0
  23. package/dist/daemon/governance.d.ts +66 -0
  24. package/dist/daemon/governance.js +514 -0
  25. package/dist/daemon/guards.d.ts +36 -0
  26. package/dist/daemon/guards.js +140 -0
  27. package/dist/daemon/issuer-client.d.ts +56 -0
  28. package/dist/daemon/issuer-client.js +143 -0
  29. package/dist/daemon/link.d.ts +30 -0
  30. package/dist/daemon/link.js +191 -0
  31. package/dist/daemon/log.d.ts +1 -0
  32. package/dist/daemon/log.js +4 -0
  33. package/dist/daemon/main.d.ts +1 -0
  34. package/dist/daemon/main.js +513 -0
  35. package/dist/daemon/paths.d.ts +6 -0
  36. package/dist/daemon/paths.js +21 -0
  37. package/dist/daemon/pii.d.ts +24 -0
  38. package/dist/daemon/pii.js +147 -0
  39. package/dist/daemon/policy-cadence.d.ts +33 -0
  40. package/dist/daemon/policy-cadence.js +59 -0
  41. package/dist/daemon/policy-proposals.d.ts +41 -0
  42. package/dist/daemon/policy-proposals.js +83 -0
  43. package/dist/daemon/policy-store.d.ts +47 -0
  44. package/dist/daemon/policy-store.js +144 -0
  45. package/dist/daemon/presented.d.ts +36 -0
  46. package/dist/daemon/presented.js +94 -0
  47. package/dist/daemon/rate-limit.d.ts +17 -0
  48. package/dist/daemon/rate-limit.js +44 -0
  49. package/dist/daemon/reach.d.ts +62 -0
  50. package/dist/daemon/reach.js +204 -0
  51. package/dist/daemon/screening.d.ts +97 -0
  52. package/dist/daemon/screening.js +362 -0
  53. package/dist/daemon/settings.d.ts +125 -0
  54. package/dist/daemon/settings.js +73 -0
  55. package/dist/daemon/signal-rules.d.ts +55 -0
  56. package/dist/daemon/signal-rules.js +127 -0
  57. package/dist/daemon/signal-store.d.ts +53 -0
  58. package/dist/daemon/signal-store.js +114 -0
  59. package/dist/daemon/store.d.ts +189 -0
  60. package/dist/daemon/store.js +477 -0
  61. package/dist/daemon/tiers.d.ts +14 -0
  62. package/dist/daemon/tiers.js +9 -0
  63. package/dist/daemon/wallet.d.ts +73 -0
  64. package/dist/daemon/wallet.js +429 -0
  65. package/dist/daemon/who-label.d.ts +3 -0
  66. package/dist/daemon/who-label.js +11 -0
  67. package/dist/guidance.d.ts +39 -0
  68. package/dist/guidance.js +98 -0
  69. package/dist/hermes-bridge.d.ts +34 -0
  70. package/dist/hermes-bridge.js +223 -0
  71. package/dist/install-mcp.d.ts +6 -0
  72. package/dist/install-mcp.js +77 -0
  73. package/dist/ipc/client.d.ts +18 -0
  74. package/dist/ipc/client.js +107 -0
  75. package/dist/ipc/operations.d.ts +30 -0
  76. package/dist/ipc/operations.js +846 -0
  77. package/dist/ipc/protocol.d.ts +21 -0
  78. package/dist/ipc/protocol.js +1 -0
  79. package/dist/issuer-list-sign.d.ts +12 -0
  80. package/dist/issuer-list-sign.js +43 -0
  81. package/dist/local-operations.d.ts +2 -0
  82. package/dist/local-operations.js +73 -0
  83. package/dist/mcp-tools.d.ts +14 -0
  84. package/dist/mcp-tools.js +45 -0
  85. package/dist/mcp.d.ts +2 -0
  86. package/dist/mcp.js +160 -0
  87. package/dist/protocol/aead.d.ts +4 -0
  88. package/dist/protocol/aead.js +35 -0
  89. package/dist/protocol/cbor.d.ts +40 -0
  90. package/dist/protocol/cbor.js +106 -0
  91. package/dist/protocol/chain.d.ts +44 -0
  92. package/dist/protocol/chain.js +126 -0
  93. package/dist/protocol/channel.d.ts +153 -0
  94. package/dist/protocol/channel.js +298 -0
  95. package/dist/protocol/encode.d.ts +6 -0
  96. package/dist/protocol/encode.js +21 -0
  97. package/dist/protocol/identity.d.ts +27 -0
  98. package/dist/protocol/identity.js +94 -0
  99. package/dist/protocol/issuer-list.d.ts +56 -0
  100. package/dist/protocol/issuer-list.js +193 -0
  101. package/dist/protocol/issuer-roots.d.ts +6 -0
  102. package/dist/protocol/issuer-roots.js +10 -0
  103. package/dist/protocol/key-agreement.d.ts +20 -0
  104. package/dist/protocol/key-agreement.js +88 -0
  105. package/dist/protocol/merkle.d.ts +16 -0
  106. package/dist/protocol/merkle.js +166 -0
  107. package/dist/protocol/ml-dsa.d.ts +28 -0
  108. package/dist/protocol/ml-dsa.js +58 -0
  109. package/dist/protocol/ml-kem.d.ts +14 -0
  110. package/dist/protocol/ml-kem.js +57 -0
  111. package/dist/protocol/pq-errors.d.ts +9 -0
  112. package/dist/protocol/pq-errors.js +23 -0
  113. package/dist/protocol/pq-warnings.d.ts +1 -0
  114. package/dist/protocol/pq-warnings.js +18 -0
  115. package/dist/protocol/presented-signals.d.ts +17 -0
  116. package/dist/protocol/presented-signals.js +92 -0
  117. package/dist/protocol/salt.d.ts +5 -0
  118. package/dist/protocol/salt.js +47 -0
  119. package/dist/protocol/seal.d.ts +58 -0
  120. package/dist/protocol/seal.js +220 -0
  121. package/dist/protocol/signal.d.ts +54 -0
  122. package/dist/protocol/signal.js +266 -0
  123. package/dist/protocol/status.d.ts +41 -0
  124. package/dist/protocol/status.js +64 -0
  125. package/dist/protocol/structures.d.ts +359 -0
  126. package/dist/protocol/structures.js +296 -0
  127. package/dist/protocol/transcript.d.ts +61 -0
  128. package/dist/protocol/transcript.js +319 -0
  129. package/dist/protocol/wire.d.ts +212 -0
  130. package/dist/protocol/wire.js +161 -0
  131. package/dist/require-node.d.ts +1 -0
  132. package/dist/require-node.js +10 -0
  133. package/dist/screener/affordance.d.ts +1 -0
  134. package/dist/screener/affordance.js +2 -0
  135. package/dist/screener/classifier-selfcheck.d.ts +29 -0
  136. package/dist/screener/classifier-selfcheck.js +56 -0
  137. package/dist/screener/exfil.d.ts +11 -0
  138. package/dist/screener/exfil.js +45 -0
  139. package/dist/screener/gitleaks-rules.d.ts +9 -0
  140. package/dist/screener/gitleaks-rules.js +226 -0
  141. package/dist/screener/inbound.d.ts +25 -0
  142. package/dist/screener/inbound.js +102 -0
  143. package/dist/screener/injection-classifier-onnx.d.ts +20 -0
  144. package/dist/screener/injection-classifier-onnx.js +89 -0
  145. package/dist/screener/injection-classifier-wasm.d.ts +2 -0
  146. package/dist/screener/injection-classifier-wasm.js +97 -0
  147. package/dist/screener/injection-patterns.d.ts +8 -0
  148. package/dist/screener/injection-patterns.js +48 -0
  149. package/dist/screener/injection-windows.d.ts +9 -0
  150. package/dist/screener/injection-windows.js +37 -0
  151. package/dist/screener/language.d.ts +15 -0
  152. package/dist/screener/language.js +71 -0
  153. package/dist/screener/linear-regex.d.ts +8 -0
  154. package/dist/screener/linear-regex.js +27 -0
  155. package/dist/screener/model-installer.d.ts +14 -0
  156. package/dist/screener/model-installer.js +61 -0
  157. package/dist/screener/outbound.d.ts +19 -0
  158. package/dist/screener/outbound.js +62 -0
  159. package/dist/screener/sanitize.d.ts +44 -0
  160. package/dist/screener/sanitize.js +361 -0
  161. package/dist/screener/scan-variants.d.ts +5 -0
  162. package/dist/screener/scan-variants.js +146 -0
  163. package/dist/screener/screener-model-manifest.d.ts +16 -0
  164. package/dist/screener/screener-model-manifest.js +20 -0
  165. package/dist/screener/screener-state.d.ts +29 -0
  166. package/dist/screener/screener-state.js +119 -0
  167. package/dist/screener/secrets.d.ts +18 -0
  168. package/dist/screener/secrets.js +84 -0
  169. package/dist/screener/worker.d.ts +6 -0
  170. package/dist/screener/worker.js +83 -0
  171. package/dist/setup.d.ts +9 -0
  172. package/dist/setup.js +259 -0
  173. package/dist/shipped-issuer-list.d.ts +1 -0
  174. package/dist/shipped-issuer-list.js +3 -0
  175. package/dist/signals-text.d.ts +46 -0
  176. package/dist/signals-text.js +81 -0
  177. package/dist/verify-seal.d.ts +9 -0
  178. package/dist/verify-seal.js +30 -0
  179. package/hermes/plugin/__init__.py +1066 -0
  180. package/hermes/plugin/plugin.yaml +30 -0
  181. package/hermes/skills/cello-bridge-setup/SKILL.md +48 -0
  182. package/hermes/skills/cello-policy/SKILL.md +44 -0
  183. package/package.json +48 -16
  184. package/plugins/cello/.claude-plugin/plugin.json +19 -0
  185. package/plugins/cello/.mcp.json +7 -0
  186. package/plugins/cello/skills/cello/SKILL.md +117 -0
  187. package/dist/arg-parse.d.ts +0 -19
  188. package/dist/arg-parse.d.ts.map +0 -1
  189. package/dist/arg-parse.js +0 -29
  190. package/dist/arg-parse.js.map +0 -1
  191. package/dist/bin/cello.d.ts +0 -15
  192. package/dist/bin/cello.d.ts.map +0 -1
  193. package/dist/bin/cello.js +0 -110
  194. package/dist/bin/cello.js.map +0 -1
  195. package/dist/cli-args.d.ts +0 -62
  196. package/dist/cli-args.d.ts.map +0 -1
  197. package/dist/cli-args.js +0 -129
  198. package/dist/cli-args.js.map +0 -1
  199. package/dist/commands.d.ts +0 -196
  200. package/dist/commands.d.ts.map +0 -1
  201. package/dist/commands.js +0 -1544
  202. package/dist/commands.js.map +0 -1
  203. package/dist/hermes/assets.d.ts +0 -41
  204. package/dist/hermes/assets.d.ts.map +0 -1
  205. package/dist/hermes/assets.js +0 -2281
  206. package/dist/hermes/assets.js.map +0 -1
  207. package/dist/hermes/install-hermes.d.ts +0 -50
  208. package/dist/hermes/install-hermes.d.ts.map +0 -1
  209. package/dist/hermes/install-hermes.js +0 -232
  210. package/dist/hermes/install-hermes.js.map +0 -1
  211. package/dist/json-out.d.ts +0 -41
  212. package/dist/json-out.d.ts.map +0 -1
  213. package/dist/json-out.js +0 -59
  214. package/dist/json-out.js.map +0 -1
  215. package/dist/node-runtime-guard-init.d.ts +0 -6
  216. package/dist/node-runtime-guard-init.d.ts.map +0 -1
  217. package/dist/node-runtime-guard-init.js +0 -7
  218. package/dist/node-runtime-guard-init.js.map +0 -1
  219. package/dist/node-runtime-guard.d.ts +0 -48
  220. package/dist/node-runtime-guard.d.ts.map +0 -1
  221. package/dist/node-runtime-guard.js +0 -79
  222. package/dist/node-runtime-guard.js.map +0 -1
  223. package/dist/parity-commands.d.ts +0 -427
  224. package/dist/parity-commands.d.ts.map +0 -1
  225. package/dist/parity-commands.js +0 -953
  226. package/dist/parity-commands.js.map +0 -1
  227. package/dist/registry.d.ts +0 -120
  228. package/dist/registry.d.ts.map +0 -1
  229. package/dist/registry.js +0 -2169
  230. package/dist/registry.js.map +0 -1
  231. package/dist/screener-commands.d.ts +0 -85
  232. package/dist/screener-commands.d.ts.map +0 -1
  233. package/dist/screener-commands.js +0 -313
  234. package/dist/screener-commands.js.map +0 -1
@@ -0,0 +1,26 @@
1
+ import type { Store } from "./store.ts";
2
+ import { type Tier } from "./tiers.ts";
3
+ export interface ContactRow {
4
+ agent_id: Uint8Array;
5
+ contact_id: Uint8Array;
6
+ tier: number;
7
+ moniker: string | null;
8
+ last_offered_moniker: string | null;
9
+ away_message: string | null;
10
+ provenance: string | null;
11
+ added_at: number;
12
+ }
13
+ export declare class Contacts {
14
+ #private;
15
+ constructor(store: Store);
16
+ get(agentId: Uint8Array, contactId: Uint8Array): ContactRow | undefined;
17
+ list(agentId: Uint8Array): ContactRow[];
18
+ tierOf(agentId: Uint8Array, contactId: Uint8Array): Tier;
19
+ put(agentId: Uint8Array, contactId: Uint8Array, update: Partial<Pick<ContactRow, "tier" | "moniker" | "last_offered_moniker" | "away_message" | "provenance">>): void;
20
+ remove(agentId: Uint8Array, contactId: Uint8Array): void;
21
+ noteOfferedName(agentId: Uint8Array, contactId: Uint8Array, offered: string): string | undefined;
22
+ who(agentId: Uint8Array, contactId: Uint8Array, contactHex: string, offered: string | null): {
23
+ who: string;
24
+ named_by: "you" | "itself" | "nobody";
25
+ };
26
+ }
@@ -0,0 +1,74 @@
1
+ import { TIER } from "./tiers.js";
2
+ import { fingerprint, validateMoniker } from "./who-label.js";
3
+ const SCHEMA = `
4
+ CREATE TABLE IF NOT EXISTS contacts (
5
+ agent_id BLOB NOT NULL REFERENCES agents(agent_id),
6
+ contact_id BLOB NOT NULL,
7
+ tier INTEGER NOT NULL CHECK (tier BETWEEN 0 AND 4),
8
+ moniker TEXT,
9
+ last_offered_moniker TEXT,
10
+ away_message TEXT,
11
+ provenance TEXT,
12
+ added_at INTEGER NOT NULL,
13
+ PRIMARY KEY (agent_id, contact_id)
14
+ );
15
+ CREATE TABLE IF NOT EXISTS contact_rename_notices (
16
+ agent_id BLOB NOT NULL,
17
+ contact_id BLOB NOT NULL,
18
+ offered_name TEXT NOT NULL,
19
+ noticed_at INTEGER NOT NULL,
20
+ PRIMARY KEY (agent_id, contact_id)
21
+ );
22
+ `;
23
+ export class Contacts {
24
+ #store;
25
+ constructor(store) {
26
+ this.#store = store;
27
+ store.exec(SCHEMA);
28
+ }
29
+ get(agentId, contactId) {
30
+ return this.#store.prepare("SELECT * FROM contacts WHERE agent_id = ? AND contact_id = ?").get(agentId, contactId);
31
+ }
32
+ list(agentId) {
33
+ return this.#store.prepare("SELECT * FROM contacts WHERE agent_id = ? ORDER BY added_at, contact_id").all(agentId);
34
+ }
35
+ // No row means a stranger. A database that can't be read throws, so a session start fails closed.
36
+ tierOf(agentId, contactId) {
37
+ return (this.get(agentId, contactId)?.tier ?? TIER.UNKNOWN);
38
+ }
39
+ // A set of named columns on one contact's row, made if there's none yet. A new row is a stranger unless the update says otherwise.
40
+ put(agentId, contactId, update) {
41
+ const keys = Object.keys(update);
42
+ const columns = ["agent_id", "contact_id", "added_at", ...(keys.includes("tier") ? [] : ["tier"]), ...keys];
43
+ const values = [agentId, contactId, Date.now(), ...(keys.includes("tier") ? [] : [TIER.UNKNOWN]), ...keys.map((k) => update[k])];
44
+ const set = keys.map((k) => `${k} = excluded.${k}`).join(", ");
45
+ const conflict = set ? `DO UPDATE SET ${set}` : "DO NOTHING";
46
+ this.#store.prepare(`INSERT INTO contacts (${columns.join(", ")}) VALUES (${columns.map(() => "?").join(", ")}) ON CONFLICT (agent_id, contact_id) ${conflict}`).run(...values);
47
+ }
48
+ remove(agentId, contactId) {
49
+ this.#store.prepare("DELETE FROM contacts WHERE agent_id = ? AND contact_id = ?").run(agentId, contactId);
50
+ }
51
+ // Remembers a name it offers. Only says so if a person named it something else, and only once for each name.
52
+ noteOfferedName(agentId, contactId, offered) {
53
+ if (validateMoniker(offered) === null)
54
+ return undefined;
55
+ const row = this.get(agentId, contactId);
56
+ if (row?.last_offered_moniker === offered)
57
+ return undefined;
58
+ if (row)
59
+ this.put(agentId, contactId, { last_offered_moniker: offered });
60
+ if (!row?.moniker || row.moniker === offered)
61
+ return undefined;
62
+ this.#store.prepare("INSERT INTO contact_rename_notices (agent_id, contact_id, offered_name, noticed_at) VALUES (?, ?, ?, ?) ON CONFLICT (agent_id, contact_id) DO UPDATE SET offered_name = excluded.offered_name, noticed_at = excluded.noticed_at").run(agentId, contactId, offered, Date.now());
63
+ return `The agent you call ${row.moniker} now calls itself ${offered}. Your name for it hasn't changed.`;
64
+ }
65
+ // Your own name for it always wins. A name it gave itself is never applied by itself, and always says it's self-declared.
66
+ who(agentId, contactId, contactHex, offered) {
67
+ const moniker = this.get(agentId, contactId)?.moniker;
68
+ if (moniker)
69
+ return { who: moniker, named_by: "you" };
70
+ if (offered)
71
+ return { who: `${offered} (self-declared)`, named_by: "itself" };
72
+ return { who: fingerprint(contactHex), named_by: "nobody" };
73
+ }
74
+ }
@@ -0,0 +1,82 @@
1
+ import { type PushFrame } from "../protocol/wire.ts";
2
+ import { LocalError } from "./errors.ts";
3
+ import { Governance } from "./governance.ts";
4
+ import { Wallet } from "./wallet.ts";
5
+ import type { ChannelHost } from "./channels.ts";
6
+ import type { Store } from "./store.ts";
7
+ import { type ChannelNoticeKind } from "../guidance.ts";
8
+ export declare const CONFIG_SERVER_URL = "server_url";
9
+ export { LocalError };
10
+ export declare const SIGNALS: readonly ["over", "standby", "wrap"];
11
+ export type Signal = (typeof SIGNALS)[number];
12
+ export interface Doorbell {
13
+ type: "session_started" | "message" | "peer_closed" | "session_closed" | "notice" | "standby_overdue" | "screening_delayed" | "away_greeting" | "channel_post" | "channel_notice" | "channel_request" | "agent_status" | "agent_displaced";
14
+ policy?: unknown;
15
+ policy_error?: string;
16
+ agent: string;
17
+ agent_id?: string;
18
+ session_id?: string;
19
+ from_id?: string;
20
+ channel_id?: string;
21
+ notice_kind?: ChannelNoticeKind;
22
+ position?: number;
23
+ about_seconds?: number;
24
+ }
25
+ export interface EngineEvents {
26
+ ring(agentHex: string, bell: Doorbell): void;
27
+ channelPush(frame: PushFrame): void;
28
+ reachable(agentHex: string): boolean;
29
+ }
30
+ export declare class Engine {
31
+ #private;
32
+ readonly governance: Governance;
33
+ readonly wallet: Wallet;
34
+ constructor(store: Store, url: string, events: EngineEvents);
35
+ start(): Promise<void>;
36
+ stop(): void;
37
+ screeningFacts(): unknown;
38
+ reloadScreener(): unknown;
39
+ greetings(agentHex: string): unknown;
40
+ evidence(agentHex: string, sessionHex: string): unknown;
41
+ assertCanAct(agentHex: string): void;
42
+ suspend(agentHex: string, reason: unknown): Promise<unknown>;
43
+ retire(agentHex: string, reason: unknown): Promise<{
44
+ agent_id: string;
45
+ status: string;
46
+ reason: string;
47
+ told: string[];
48
+ not_yet: string[];
49
+ deferred: boolean;
50
+ }>;
51
+ removeAgent(agentHex: string): Promise<unknown>;
52
+ agentStatus(agentHex: string): Promise<unknown>;
53
+ presentedSignals(agentHex: string, sessionHex: string): Promise<unknown>;
54
+ send(agentHex: string, sessionHex: string, text: string, signal: Signal, estMinutes: number | undefined, notice: boolean, params?: Record<string, unknown>): Promise<unknown>;
55
+ close(agentHex: string, sessionHex: string): Promise<unknown>;
56
+ seal(agentHex: string, sessionHex: string, through: number | undefined): Promise<unknown>;
57
+ seals(agentHex: string, sessionHex: string | undefined): unknown;
58
+ exportSeal(agentHex: string, sealHex: string): unknown;
59
+ exportTranscript(agentHex: string, sessionHex: string, choice: {
60
+ reveal: string | undefined;
61
+ all: boolean;
62
+ sealId: string | undefined;
63
+ }): Promise<unknown>;
64
+ createAgent(name: string): Promise<unknown>;
65
+ enrollAgent(name: string | undefined, code: string | undefined): Promise<unknown>;
66
+ channelHost(): ChannelHost;
67
+ renameAgent(agentHex: string, name: string): unknown;
68
+ resolveAgent(nameOrId: string): string;
69
+ agentName(agentHex: string): string;
70
+ initiate(agentHex: string, target: string, params?: Record<string, unknown>): Promise<unknown>;
71
+ receive(agentHex: string, sessionHex?: string): {
72
+ result: unknown;
73
+ commit(): void;
74
+ };
75
+ agents(): unknown;
76
+ sessions(agentHex: string, includeClosed: boolean): unknown;
77
+ inbox(agentHex: string): unknown;
78
+ transcript(agentHex: string, sessionHex: string, after?: number): unknown;
79
+ unreadCount(agentHex: string): number;
80
+ verifySession(agentHex: string, sessionHex: string): Promise<unknown>;
81
+ status(): unknown;
82
+ }