strands-darwin 0.0.39 → 0.0.41

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 (45) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/dist/src/agent/permission.d.ts +6 -0
  4. package/dist/src/agent/permission.js +14 -1
  5. package/dist/src/agent/permission.js.map +1 -1
  6. package/dist/src/agent/runtime.js +2 -1
  7. package/dist/src/agent/runtime.js.map +1 -1
  8. package/dist/src/agent/stream-idle.d.ts +1 -1
  9. package/dist/src/agent/stream-idle.js +1 -1
  10. package/dist/src/cli-usage.d.ts +1 -1
  11. package/dist/src/cli-usage.js +2 -0
  12. package/dist/src/cli-usage.js.map +1 -1
  13. package/dist/src/collaboration/command.js +14 -2
  14. package/dist/src/collaboration/command.js.map +1 -1
  15. package/dist/src/collaboration/grammar.d.ts +1 -1
  16. package/dist/src/collaboration/grammar.js +1 -0
  17. package/dist/src/collaboration/grammar.js.map +1 -1
  18. package/dist/src/collaboration/hub-command.d.ts +21 -0
  19. package/dist/src/collaboration/hub-command.js +129 -0
  20. package/dist/src/collaboration/hub-command.js.map +1 -0
  21. package/dist/src/collaboration/hub-store.d.ts +58 -0
  22. package/dist/src/collaboration/hub-store.js +108 -0
  23. package/dist/src/collaboration/hub-store.js.map +1 -0
  24. package/dist/src/collaboration/hub-transport.d.ts +86 -0
  25. package/dist/src/collaboration/hub-transport.js +457 -0
  26. package/dist/src/collaboration/hub-transport.js.map +1 -0
  27. package/dist/src/collaboration/hub-wire.d.ts +356 -0
  28. package/dist/src/collaboration/hub-wire.js +192 -0
  29. package/dist/src/collaboration/hub-wire.js.map +1 -0
  30. package/dist/src/collaboration/local.d.ts +50 -1
  31. package/dist/src/collaboration/local.js +230 -8
  32. package/dist/src/collaboration/local.js.map +1 -1
  33. package/dist/src/collaboration/protocol.d.ts +82 -15
  34. package/dist/src/collaboration/protocol.js +32 -10
  35. package/dist/src/collaboration/protocol.js.map +1 -1
  36. package/dist/src/collaboration/storage.d.ts +1 -0
  37. package/dist/src/collaboration/storage.js +10 -5
  38. package/dist/src/collaboration/storage.js.map +1 -1
  39. package/dist/src/collaboration/tools.d.ts +1 -1
  40. package/dist/src/collaboration/tools.js +2 -3
  41. package/dist/src/collaboration/tools.js.map +1 -1
  42. package/dist/src/config.d.ts +18 -6
  43. package/dist/src/config.js +8 -3
  44. package/dist/src/config.js.map +1 -1
  45. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/collaboration/command.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/collaboration/command.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,3 @@
1
1
  /** Pure canonical user grammar; safe to import from bounded local help. */
2
- export declare const COLLABORATION_GRAMMAR: readonly ['/collaborate [status|list|pending|relations|on|off]', '/collaborate send <endpoint-uuid> <literal text>', '/collaborate confirm <pending-id> --persist; /collaborate revoke <pair-id>'];
2
+ export declare const COLLABORATION_GRAMMAR: readonly ['/collaborate [status|list|pending|relations|on|off]', '/collaborate send <endpoint-uuid> <literal text>', '/collaborate confirm <pending-id> --persist; /collaborate revoke <pair-id>', '/collaborate hub status|nodes|leave|publish on|off|block <node>|unblock <node>; enroll: CLI only'];
3
3
  export declare const COLLABORATE_USAGE: string;
@@ -3,6 +3,7 @@ export const COLLABORATION_GRAMMAR = [
3
3
  '/collaborate [status|list|pending|relations|on|off]',
4
4
  '/collaborate send <endpoint-uuid> <literal text>',
5
5
  '/collaborate confirm <pending-id> --persist; /collaborate revoke <pair-id>',
6
+ '/collaborate hub status|nodes|leave|publish on|off|block <node>|unblock <node>; enroll: CLI only',
6
7
  ];
7
8
  export const COLLABORATE_USAGE = COLLABORATION_GRAMMAR.join('; ');
8
9
  //# sourceMappingURL=grammar.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"grammar.js","sourceRoot":"","sources":["../../../src/collaboration/grammar.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,qDAAqD;IACrD,kDAAkD;IAClD,4EAA4E;CACpE,CAAC;AACX,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
1
+ {"version":3,"file":"grammar.js","sourceRoot":"","sources":["../../../src/collaboration/grammar.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,qDAAqD;IACrD,kDAAkD;IAClD,4EAA4E;IAC5E,kGAAkG;CAC1F,CAAC;AACX,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
@@ -0,0 +1,21 @@
1
+ import type { LocalCollaboration } from './local.js';
2
+ export declare const HUB_GRAMMAR = "collaborate hub status|nodes|leave|publish on|publish off|block <node>|unblock <node>; CLI only: hub enroll <url> <token> [--name <label>]";
3
+ type HubArgs = {
4
+ verb: 'status' | 'nodes' | 'leave';
5
+ } | {
6
+ verb: 'publish';
7
+ on: boolean;
8
+ } | {
9
+ verb: 'block' | 'unblock';
10
+ node: string;
11
+ } | {
12
+ verb: 'enroll';
13
+ url: string;
14
+ token: string;
15
+ name?: string;
16
+ };
17
+ /** Pure grammar preflight: nothing is read, written or contacted on a malformed command. */
18
+ export declare function parseHubArgs(args: readonly string[]): HubArgs;
19
+ /** `local` is the live session (TUI) or undefined (standalone CLI). */
20
+ export declare function hubCommand(local: LocalCollaboration | undefined, root: string, args: readonly string[], cli: boolean): Promise<string>;
21
+ export {};
@@ -0,0 +1,129 @@
1
+ /**
2
+ * User-only hub controls: `darwin collaborate hub …` and `/collaborate hub …` (hub/README.md §5,
3
+ * §7, §9). Never a model tool; the gate denies model-issued `collaborate` controls and reads of
4
+ * the collaboration directory before rules and hooks. `enroll` is CLI-only so a token never enters
5
+ * a session transcript, trajectory or prompt recall.
6
+ */
7
+ import os from 'node:os';
8
+ import { randomUUID } from 'node:crypto';
9
+ import { enrollResponseSchema, fingerprint, generateNodeKeys, nodeNameSchema, shortFingerprint, tokenSchema, uuidSchema } from './hub-wire.js';
10
+ import { readHubNode, readHubState, removeHubNode, updateHubState, writeHubNode } from './hub-store.js';
11
+ import { canonicalProject, checkStore } from './storage.js';
12
+ export const HUB_GRAMMAR = 'collaborate hub status|nodes|leave|publish on|publish off|block <node>|unblock <node>; CLI only: hub enroll <url> <token> [--name <label>]';
13
+ /** Pure grammar preflight: nothing is read, written or contacted on a malformed command. */
14
+ export function parseHubArgs(args) {
15
+ const [verb, a, b, c, d] = args;
16
+ const fail = () => { throw new Error(`Usage: ${HUB_GRAMMAR}`); };
17
+ if ((verb === 'status' || verb === 'nodes' || verb === 'leave') && args.length === 1)
18
+ return { verb };
19
+ if (verb === 'publish' && args.length === 2 && (a === 'on' || a === 'off'))
20
+ return { verb, on: a === 'on' };
21
+ if ((verb === 'block' || verb === 'unblock') && args.length === 2 && uuidSchema.safeParse(a).success)
22
+ return { verb, node: a };
23
+ if (verb === 'enroll' && (args.length === 3 || (args.length === 5 && c === '--name')) && tokenSchema.safeParse(b).success && a && a.length <= 512) {
24
+ if (args.length === 5 && !nodeNameSchema.safeParse(d).success)
25
+ fail();
26
+ return { verb, url: a, token: b, ...(args.length === 5 ? { name: d } : {}) };
27
+ }
28
+ return fail();
29
+ }
30
+ /** https, or plain http/ws only to a loopback host (the local hub). */
31
+ function safeUrl(value, kinds) {
32
+ const url = new URL(value);
33
+ const loopback = ['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname);
34
+ const secure = kinds === 'http' ? 'https:' : 'wss:';
35
+ const plain = kinds === 'http' ? 'http:' : 'ws:';
36
+ if (url.protocol !== secure && !(url.protocol === plain && loopback))
37
+ throw new Error(`hub ${kinds} URL must use ${secure} (plain ${plain} only to loopback)`);
38
+ if (url.username || url.password)
39
+ throw new Error('hub URL must not carry credentials');
40
+ return url;
41
+ }
42
+ function defaultName() {
43
+ const name = os.hostname().replace(/[^A-Za-z0-9._-]/g, '-').slice(0, 64) || 'darwin';
44
+ return nodeNameSchema.safeParse(name).success ? name : 'darwin';
45
+ }
46
+ async function enroll(url, token, name) {
47
+ checkStore(true); // same owner-private creation as first collaboration startup
48
+ if (readHubNode())
49
+ throw new Error('This HOME is already enrolled; run darwin collaborate hub leave first');
50
+ const base = safeUrl(url, 'http');
51
+ const keys = generateNodeKeys();
52
+ const node = randomUUID();
53
+ const response = await fetch(new URL('/enroll', base), { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ token, node, name, publicKey: keys.publicKey }), signal: AbortSignal.timeout(15_000), redirect: 'error' });
54
+ const parsed = enrollResponseSchema.safeParse(await response.json().catch(() => undefined));
55
+ if (!response.ok || !parsed.success || parsed.data.node !== node || parsed.data.fingerprint !== fingerprint(keys.publicKey))
56
+ throw new Error('enrollment refused (token expired, already used, or not for this hub)');
57
+ const wsUrl = safeUrl(parsed.data.wsUrl, 'ws').toString();
58
+ await writeHubNode({ version: 1, hubUrl: base.origin, wsUrl, audience: parsed.data.audience, node, name, publicKey: keys.publicKey, privateKey: keys.privateKey, fingerprint: parsed.data.fingerprint, enrolledAt: Date.now() });
59
+ return [
60
+ `Enrolled node ${node} (${name}) at ${base.origin}.`,
61
+ `Fingerprint ${shortFingerprint(parsed.data.fingerprint)} (full ${parsed.data.fingerprint}).`,
62
+ 'Every enrolled, active node collaborates with this one without per-pair confirmation. New sessions publish to the hub',
63
+ 'when their project has a network git origin; opt a project out with: darwin collaborate hub publish off',
64
+ ].join('\n');
65
+ }
66
+ function status(local, root) {
67
+ const node = readHubNode();
68
+ const state = readHubState();
69
+ let project;
70
+ try {
71
+ project = canonicalProject(root);
72
+ }
73
+ catch { /* reported as unknown */ }
74
+ return JSON.stringify({
75
+ enrolled: node !== undefined,
76
+ ...(node ? { node: node.node, name: node.name, hub: node.hubUrl, fingerprint: shortFingerprint(node.fingerprint), fullFingerprint: node.fingerprint } : {}),
77
+ ...(local ? { session: { state: local.hub.state, ...(local.hub.reason ? { reason: local.hub.reason } : {}), endpoint: local.hub.address ?? null } } : {}),
78
+ thisProjectPublishes: project === undefined ? 'unknown' : !state.unpublished.includes(project),
79
+ pinnedNodes: state.pins.length,
80
+ blockedNodes: state.blocked,
81
+ rule: 'Enrolled, active, not blocked nodes collaborate without confirmation; keys are pinned on first sight and never re-keyed.',
82
+ }, null, 2);
83
+ }
84
+ function nodes() {
85
+ const state = readHubState();
86
+ return JSON.stringify({ nodes: state.pins.map(pin => ({ node: pin.node, name: pin.name, fingerprint: shortFingerprint(pin.fingerprint), firstSeen: new Date(pin.firstSeen).toISOString(), blocked: state.blocked.includes(pin.node) })), note: 'Pinned on first sight. Compare fingerprints with `darwin collaborate hub status` on the other machine.' }, null, 2);
87
+ }
88
+ /** `local` is the live session (TUI) or undefined (standalone CLI). */
89
+ export async function hubCommand(local, root, args, cli) {
90
+ const parsed = parseHubArgs(args);
91
+ switch (parsed.verb) {
92
+ case 'status': return status(local, root);
93
+ case 'nodes': return nodes();
94
+ case 'enroll':
95
+ if (!cli)
96
+ throw new Error('hub enroll is CLI-only so the token never enters a session transcript: run darwin collaborate hub enroll <url> <token> in a shell');
97
+ return enroll(parsed.url, parsed.token, parsed.name ?? defaultName());
98
+ case 'leave': {
99
+ local?.hub.close();
100
+ const removed = await removeHubNode();
101
+ return removed ? 'Left the hub on this HOME: identity and private key removed. The hub row stays until the operator runs revoke-node; re-enrolling issues a new node id.' : 'Not enrolled.';
102
+ }
103
+ case 'publish': {
104
+ const project = canonicalProject(root);
105
+ await updateHubState(state => {
106
+ state.unpublished = state.unpublished.filter(entry => entry !== project);
107
+ if (!parsed.on)
108
+ state.unpublished.push(project);
109
+ });
110
+ if (local && !parsed.on)
111
+ local.hub.close();
112
+ if (local && parsed.on && local.active)
113
+ local.hub.start(local.project, true);
114
+ return `Hub publishing ${parsed.on ? 'on' : 'off'} for ${project}${local ? '; applied to this session' : '; applies to new sessions'}.`;
115
+ }
116
+ case 'block':
117
+ case 'unblock': {
118
+ await updateHubState(state => {
119
+ state.blocked = state.blocked.filter(node => node !== parsed.node);
120
+ if (parsed.verb === 'block')
121
+ state.blocked.push(parsed.node);
122
+ });
123
+ if (parsed.verb === 'block')
124
+ local?.dropHubNode(parsed.node, 'node blocked by the user');
125
+ return parsed.verb === 'block' ? `Blocked ${parsed.node}: its messages are refused and queued ones dropped, whatever the hub says.` : `Unblocked ${parsed.node}.`;
126
+ }
127
+ }
128
+ }
129
+ //# sourceMappingURL=hub-command.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hub-command.js","sourceRoot":"","sources":["../../../src/collaboration/hub-command.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,58 @@
1
+ import { z } from 'zod';
2
+ export declare const MAX_PINS = 256;
3
+ export declare const hubNodeSchema: z.ZodObject<{
4
+ version: z.ZodLiteral<1>;
5
+ hubUrl: z.ZodString;
6
+ wsUrl: z.ZodString;
7
+ audience: z.ZodString;
8
+ node: z.ZodString;
9
+ name: z.ZodString;
10
+ publicKey: z.ZodString;
11
+ privateKey: z.ZodString;
12
+ fingerprint: z.ZodString;
13
+ enrolledAt: z.ZodNumber;
14
+ }, z.core.$strict>;
15
+ export type HubNode = z.infer<typeof hubNodeSchema>;
16
+ declare const pinSchema: z.ZodObject<{
17
+ node: z.ZodString;
18
+ name: z.ZodString;
19
+ publicKey: z.ZodString;
20
+ fingerprint: z.ZodString;
21
+ firstSeen: z.ZodNumber;
22
+ }, z.core.$strict>;
23
+ export type HubPin = z.infer<typeof pinSchema>;
24
+ declare const stateSchema: z.ZodObject<{
25
+ version: z.ZodLiteral<1>;
26
+ pins: z.ZodArray<z.ZodObject<{
27
+ node: z.ZodString;
28
+ name: z.ZodString;
29
+ publicKey: z.ZodString;
30
+ fingerprint: z.ZodString;
31
+ firstSeen: z.ZodNumber;
32
+ }, z.core.$strict>>;
33
+ blocked: z.ZodArray<z.ZodString>;
34
+ unpublished: z.ZodArray<z.ZodString>;
35
+ }, z.core.$strict>;
36
+ export type HubState = z.infer<typeof stateSchema>;
37
+ export declare function readHubNode(): HubNode | undefined;
38
+ /** Enrollment writes the identity exactly once; an existing file must be removed by `leave`. */
39
+ export declare function writeHubNode(node: HubNode): Promise<void>;
40
+ export declare function removeHubNode(): Promise<boolean>;
41
+ export declare function readHubState(): HubState;
42
+ export declare function updateHubState<T>(change: (state: HubState) => T): Promise<T>;
43
+ export type PinResult = 'pinned' | 'match' | 'mismatch' | 'full';
44
+ /** Pin once, never re-key (§7.1): a different key for a known node id is refused forever. */
45
+ export declare function pinNode(node: string, name: string, publicKey: string, fingerprint: string, now?: number): Promise<PinResult>;
46
+ export declare function pinnedKey(node: string): string | undefined;
47
+ export declare function isBlocked(node: string): boolean;
48
+ export declare function isPublished(canonicalRoot: string): boolean;
49
+ /**
50
+ * Automatic cross-machine project identity (§4): `git remote get-url origin`, normalized.
51
+ * Argument array, no shell, bounded time. Any failure disables the hub for that project.
52
+ */
53
+ export declare function remoteIdentity(canonicalRoot: string): {
54
+ project: string;
55
+ } | {
56
+ problem: string;
57
+ };
58
+ export {};
@@ -0,0 +1,108 @@
1
+ /**
2
+ * Hub state on this machine (hub/README.md §5, §7). Lives in the owner-private collaboration
3
+ * directory, so the gate's existing protection covers it: sensitive read path, un-ruleable,
4
+ * model access to the directory and to `collaborate` controls denied before rules and hooks.
5
+ * Writes share the policy lock; reads validate strictly and fail closed.
6
+ */
7
+ import { spawnSync } from 'node:child_process';
8
+ import { existsSync, unlinkSync } from 'node:fs';
9
+ import path from 'node:path';
10
+ import { z } from 'zod';
11
+ import { collaborationDir } from '../paths.js';
12
+ import { fingerprintSchema, nodeNameSchema, normalizeRemote, publicKeySchema, uuidSchema } from './hub-wire.js';
13
+ import { checkStore, readPrivate, withLock, writePrivate } from './storage.js';
14
+ const NODE_FILE = 'hub-node.json';
15
+ const STATE_FILE = 'hub-state.json';
16
+ export const MAX_PINS = 256;
17
+ const urlSchema = z.string().max(512).refine(value => { try {
18
+ return /^(https|wss|http|ws):$/.test(new URL(value).protocol);
19
+ }
20
+ catch {
21
+ return false;
22
+ } });
23
+ export const hubNodeSchema = z.object({
24
+ version: z.literal(1), hubUrl: urlSchema, wsUrl: urlSchema, audience: z.string().min(1).max(256),
25
+ node: uuidSchema, name: nodeNameSchema, publicKey: publicKeySchema, privateKey: z.string().min(40).max(256), fingerprint: fingerprintSchema, enrolledAt: z.number().int(),
26
+ }).strict();
27
+ const pinSchema = z.object({ node: uuidSchema, name: nodeNameSchema, publicKey: publicKeySchema, fingerprint: fingerprintSchema, firstSeen: z.number().int() }).strict();
28
+ const stateSchema = z.object({
29
+ version: z.literal(1),
30
+ pins: z.array(pinSchema).max(MAX_PINS),
31
+ blocked: z.array(uuidSchema).max(MAX_PINS),
32
+ /** Canonical project roots whose sessions do not publish to the hub. */
33
+ unpublished: z.array(z.string().min(1).max(1024)).max(64),
34
+ }).strict();
35
+ const EMPTY = { version: 1, pins: [], blocked: [], unpublished: [] };
36
+ export function readHubNode() {
37
+ if (!existsSync(collaborationDir()))
38
+ return undefined;
39
+ const raw = readPrivate(NODE_FILE);
40
+ return raw === undefined ? undefined : hubNodeSchema.parse(raw);
41
+ }
42
+ /** Enrollment writes the identity exactly once; an existing file must be removed by `leave`. */
43
+ export async function writeHubNode(node) {
44
+ await withLock(() => {
45
+ if (readPrivate(NODE_FILE) !== undefined)
46
+ throw new Error('This HOME is already enrolled; run collaborate hub leave first');
47
+ writePrivate(NODE_FILE, hubNodeSchema.parse(node));
48
+ });
49
+ }
50
+ export async function removeHubNode() {
51
+ return withLock(() => {
52
+ if (readPrivate(NODE_FILE) === undefined)
53
+ return false;
54
+ unlinkSync(path.join(checkStore(), NODE_FILE));
55
+ return true;
56
+ });
57
+ }
58
+ export function readHubState() {
59
+ if (!existsSync(collaborationDir()))
60
+ return structuredClone(EMPTY);
61
+ const raw = readPrivate(STATE_FILE);
62
+ return raw === undefined ? structuredClone(EMPTY) : stateSchema.parse(raw);
63
+ }
64
+ export async function updateHubState(change) {
65
+ return withLock(() => {
66
+ const raw = readPrivate(STATE_FILE);
67
+ const state = raw === undefined ? structuredClone(EMPTY) : stateSchema.parse(raw);
68
+ const result = change(state);
69
+ writePrivate(STATE_FILE, stateSchema.parse(state));
70
+ return result;
71
+ });
72
+ }
73
+ /** Pin once, never re-key (§7.1): a different key for a known node id is refused forever. */
74
+ export async function pinNode(node, name, publicKey, fingerprint, now = Date.now()) {
75
+ const known = readHubState().pins.find(pin => pin.node === node);
76
+ if (known)
77
+ return known.publicKey === publicKey ? 'match' : 'mismatch';
78
+ return updateHubState(state => {
79
+ const current = state.pins.find(pin => pin.node === node);
80
+ if (current)
81
+ return current.publicKey === publicKey ? 'match' : 'mismatch';
82
+ if (state.pins.length >= MAX_PINS)
83
+ return 'full';
84
+ state.pins.push({ node, name, publicKey, fingerprint, firstSeen: now });
85
+ return 'pinned';
86
+ });
87
+ }
88
+ export function pinnedKey(node) {
89
+ return readHubState().pins.find(pin => pin.node === node)?.publicKey;
90
+ }
91
+ export function isBlocked(node) { return readHubState().blocked.includes(node); }
92
+ export function isPublished(canonicalRoot) { return !readHubState().unpublished.includes(canonicalRoot); }
93
+ /**
94
+ * Automatic cross-machine project identity (§4): `git remote get-url origin`, normalized.
95
+ * Argument array, no shell, bounded time. Any failure disables the hub for that project.
96
+ */
97
+ export function remoteIdentity(canonicalRoot) {
98
+ const result = spawnSync('git', ['-C', canonicalRoot, 'remote', 'get-url', 'origin'], { encoding: 'utf8', timeout: 2000, stdio: ['ignore', 'pipe', 'pipe'], env: { ...process.env, GIT_TERMINAL_PROMPT: '0' } });
99
+ if (result.error || result.status !== 0)
100
+ return { problem: 'no git origin remote' };
101
+ try {
102
+ return { project: normalizeRemote(result.stdout) };
103
+ }
104
+ catch (error) {
105
+ return { problem: error instanceof Error ? error.message : 'unrecognized origin remote' };
106
+ }
107
+ }
108
+ //# sourceMappingURL=hub-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hub-store.js","sourceRoot":"","sources":["../../../src/collaboration/hub-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,86 @@
1
+ import { type HubAddress, type HubEnvelope, type PeerChain } from './hub-wire.js';
2
+ import { type HubNode } from './hub-store.js';
3
+ export declare const HEARTBEAT_MS: number;
4
+ export declare const ROTATE_MS: number;
5
+ export declare const REQUEST_TIMEOUT_MS = 10000;
6
+ export declare const MAX_REFUSALS = 3;
7
+ /** ~25 minutes of capped backoff against an unreachable hub, then pause with a notice. */
8
+ export declare const MAX_UNREACHABLE_ATTEMPTS = 30;
9
+ export interface HubHooks {
10
+ /** Shared admission (freshness, dedupe, chain, caps); returns the local queue result text. */
11
+ admit(envelope: HubEnvelope): Promise<string> | string;
12
+ /** Drop queued input from a revoked or blocked node. */
13
+ drop(node: string, reason: string): void;
14
+ notice(text: string): void;
15
+ }
16
+ export type HubState = 'off' | 'not-enrolled' | 'unpublished' | 'unavailable' | 'connecting' | 'connected' | 'paused' | 'closed';
17
+ interface Socket {
18
+ ws: WebSocket;
19
+ opened: boolean;
20
+ ended: boolean;
21
+ }
22
+ export declare class HubTransport {
23
+ private readonly hooks;
24
+ private readonly session;
25
+ private node;
26
+ private own;
27
+ private socket;
28
+ private rotating;
29
+ private attempt;
30
+ private refusals;
31
+ private timers;
32
+ private rows;
33
+ private revoked;
34
+ private requests;
35
+ private stopped;
36
+ state: HubState;
37
+ reason: string;
38
+ /** Changes on every start; validates queued input against this incarnation. */
39
+ generation: `${string}-${string}-${string}-${string}-${string}`;
40
+ constructor(hooks: HubHooks, session: string);
41
+ get address(): HubAddress | undefined;
42
+ get identity(): HubNode | undefined;
43
+ /** Test hook: run the two-hour rotation now (open successor, re-register, close old). */
44
+ rotateNow(): void;
45
+ /** Guarded like local startup: any problem disables only the hub transport, with one notice. */
46
+ start(canonicalRoot: string, published: boolean): void;
47
+ private disable;
48
+ close(): void;
49
+ private later;
50
+ private open;
51
+ private connect;
52
+ private heartbeat;
53
+ /** API Gateway caps a connection at two hours: open the successor first, then close the old one. */
54
+ private rotate;
55
+ private register;
56
+ private lost;
57
+ /** Server minus local clock in ms, or undefined when the hub's HTTP API is unreachable. */
58
+ private skew;
59
+ private request;
60
+ private settle;
61
+ private abandon;
62
+ private frame;
63
+ private receive;
64
+ discover(): Promise<{
65
+ state: HubState;
66
+ reason?: string;
67
+ endpoints: Array<{
68
+ address: HubAddress;
69
+ name: string;
70
+ fingerprint: string;
71
+ }>;
72
+ omitted: number;
73
+ }>;
74
+ knows(endpoint: string): boolean;
75
+ /** Synchronous checks and signing; throws before the caller reserves outgoing budget. */
76
+ prepare(target: string, chain: PeerChain, text: string): {
77
+ socket: Socket;
78
+ target: string;
79
+ envelope: HubEnvelope;
80
+ value: unknown;
81
+ };
82
+ transmit({ socket, target, envelope, value }: ReturnType<HubTransport['prepare']>): Promise<string>;
83
+ /** Delivery re-check (admission, dequeue, pre-invoke): same incarnation, sender still admissible. */
84
+ deliverable(envelope: HubEnvelope, authorization: string): boolean;
85
+ }
86
+ export {};