@ours.network/fleet 0.18.0-nightly.5 → 0.18.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.
Files changed (65) hide show
  1. package/README.md +101 -25
  2. package/dist/application/fleet-query-service.js +12 -0
  3. package/dist/application/role-creation-service.js +3 -1
  4. package/dist/application/types.d.ts +11 -0
  5. package/dist/briefing.js +9 -2
  6. package/dist/build-info.json +7 -6
  7. package/dist/capabilities.d.ts +3 -1
  8. package/dist/capabilities.js +3 -0
  9. package/dist/cli.js +83 -7
  10. package/dist/config.d.ts +11 -3
  11. package/dist/config.js +40 -15
  12. package/dist/creation.d.ts +14 -15
  13. package/dist/creation.js +19 -13
  14. package/dist/docs.d.ts +1 -1
  15. package/dist/docs.js +113 -27
  16. package/dist/doctor.d.ts +1 -5
  17. package/dist/doctor.js +11 -18
  18. package/dist/fleet-proxy.d.ts +5 -0
  19. package/dist/harness/acp-agent.js +11 -6
  20. package/dist/harness/claude-code.js +204 -11
  21. package/dist/harness/codex.d.ts +4 -1
  22. package/dist/harness/codex.js +74 -12
  23. package/dist/harness/types.d.ts +54 -4
  24. package/dist/harness-plugins.d.ts +48 -0
  25. package/dist/harness-plugins.js +309 -0
  26. package/dist/index.d.ts +2 -0
  27. package/dist/index.js +1 -0
  28. package/dist/loops/manager.d.ts +30 -1
  29. package/dist/loops/manager.js +69 -6
  30. package/dist/loops/state.d.ts +18 -0
  31. package/dist/loops/state.js +4 -0
  32. package/dist/model-env.d.ts +71 -0
  33. package/dist/model-env.js +106 -0
  34. package/dist/monitor.js +1 -1
  35. package/dist/ops.js +1 -1
  36. package/dist/owner-channel/attachments.d.ts +2 -25
  37. package/dist/owner-channel/attachments.js +5 -61
  38. package/dist/owner-channel/channel.d.ts +28 -17
  39. package/dist/owner-channel/channel.js +249 -158
  40. package/dist/owner-channel/mcp.d.ts +24 -0
  41. package/dist/owner-channel/mcp.js +145 -0
  42. package/dist/owner-channel/notices.d.ts +7 -0
  43. package/dist/owner-channel/notices.js +9 -0
  44. package/dist/resolved-plan.js +1 -0
  45. package/dist/runner.d.ts +48 -0
  46. package/dist/runner.js +237 -85
  47. package/dist/session/acp.d.ts +104 -0
  48. package/dist/session/acp.js +213 -10
  49. package/dist/session/activity.d.ts +31 -0
  50. package/dist/session/activity.js +48 -0
  51. package/dist/session/conversation-normalizer.d.ts +6 -0
  52. package/dist/session/conversation-normalizer.js +153 -10
  53. package/dist/session/conversation-types.d.ts +23 -4
  54. package/dist/session/types.d.ts +35 -0
  55. package/dist/spawn.js +29 -17
  56. package/dist/supervisor/systemd.js +2 -29
  57. package/dist/watchdog/briefing.js +7 -0
  58. package/dist/web-app/assets/{TerminalView-BAVk1Bot.js → TerminalView-C_G1ID2P.js} +1 -1
  59. package/dist/web-app/assets/{index-C3S-xFRU.js → index-BCBK78hw.js} +5 -5
  60. package/dist/web-app/index.html +1 -1
  61. package/dist/worklog.d.ts +7 -1
  62. package/dist/worklog.js +191 -39
  63. package/package.json +1 -3
  64. package/dist/owner-channel/ours-client.d.ts +0 -141
  65. package/dist/owner-channel/ours-client.js +0 -225
package/dist/web-app/index.html CHANGED
@@ -8,7 +8,7 @@
8
8
  <link rel="manifest" href="/manifest.webmanifest" />
9
9
  <link rel="icon" href="/icons/ours-fleet.svg" type="image/svg+xml" />
10
10
  <title>ours fleet console</title>
11
- <script type="module" crossorigin src="/assets/index-C3S-xFRU.js"></script>
11
+ <script type="module" crossorigin src="/assets/index-BCBK78hw.js"></script>
12
12
  <link rel="stylesheet" crossorigin href="/assets/index-DuC-xnX4.css">
13
13
  </head>
14
14
  <body>
package/dist/worklog.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import type { WorklogPolicy } from './config.js';
2
+ export declare const WORKLOG_ARCHIVE_DIR = "WORKLOG.archives";
2
3
  export interface WorklogInspection {
3
4
  enabled: boolean;
4
5
  bytes: number;
@@ -12,6 +13,11 @@ export interface WorklogRotation {
12
13
  archivePath?: string;
13
14
  }
14
15
  export declare function inspectWorklog(path: string, policy?: WorklogPolicy): WorklogInspection;
16
+ /**
17
+ * Keep a bounded set of recent archives beside WORKLOG.md without deleting
18
+ * history. Older archives move atomically-by-link into WORKLOG.archives/.
19
+ * The legacy name remains exported for source compatibility.
20
+ */
15
21
  export declare function pruneWorklogArchives(path: string, maxArchives: number): void;
16
22
  /**
17
23
  * Conservatively rotate a stable snapshot. A changed size/mtime/inode aborts
@@ -20,6 +26,6 @@ export declare function pruneWorklogArchives(path: string, maxArchives: number):
20
26
  export declare function rotateWorklog(path: string, policy?: WorklogPolicy, deps?: {
21
27
  now?: () => Date;
22
28
  beforeCommit?: () => void;
23
- /** Deterministic test hook for the rename→link commit window. */
29
+ /** Deterministic test hook after the full archive is published. */
24
30
  afterArchiveRename?: () => void;
25
31
  }): WorklogRotation;
package/dist/worklog.js CHANGED
@@ -1,10 +1,59 @@
1
- import { existsSync, linkSync, readdirSync, readFileSync, renameSync, rmSync, statSync, } from 'node:fs';
1
+ import { closeSync, constants, existsSync, fstatSync, linkSync, lstatSync, mkdirSync, openSync, readdirSync, readFileSync, unlinkSync, } from 'node:fs';
2
+ import { createHash } from 'node:crypto';
2
3
  import { basename, dirname, join } from 'node:path';
3
- import { randomUUID } from 'node:crypto';
4
4
  import { replaceFileAtomically } from './atomic-file.js';
5
- const ARCHIVE_RE = /^WORKLOG\.\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z(?:\.\d+)?\.md$/;
5
+ const ARCHIVE_RE = /^WORKLOG\.(\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}\.\d{3}Z)(?:\.(\d+))?\.md$/;
6
+ export const WORKLOG_ARCHIVE_DIR = 'WORKLOG.archives';
7
+ const entryStat = (path) => {
8
+ try {
9
+ return lstatSync(path);
10
+ }
11
+ catch (error) {
12
+ if (error.code === 'ENOENT')
13
+ return undefined;
14
+ throw error;
15
+ }
16
+ };
17
+ const requireRegularFile = (path, label) => {
18
+ const stat = entryStat(path);
19
+ if (!stat)
20
+ throw new Error(`${label} disappeared before it could be preserved`);
21
+ if (!stat.isFile()) {
22
+ const kind = stat.isSymbolicLink() ? 'symbolic link' : 'non-regular file';
23
+ throw new Error(`refusing worklog rotation: ${label} is a ${kind}`);
24
+ }
25
+ return stat;
26
+ };
27
+ const sameInode = (left, right) => left.dev === right.dev && left.ino === right.ino;
28
+ const sameSnapshot = (left, right) => sameInode(left, right) && left.size === right.size
29
+ && left.mtimeMs === right.mtimeMs && left.ctimeMs === right.ctimeMs;
30
+ const sha256 = (content) => createHash('sha256').update(content).digest('hex');
31
+ /** Remove a newly published duplicate only while the source inode is still available. */
32
+ const cleanupDuplicateLink = (source, target, expected) => {
33
+ try {
34
+ const sourceStat = entryStat(source);
35
+ const targetStat = entryStat(target);
36
+ if (sourceStat && targetStat && sameInode(expected, sourceStat) && sameInode(expected, targetStat))
37
+ unlinkSync(target);
38
+ }
39
+ catch { /* cleanup is best-effort; preserve the primary failure */ }
40
+ };
41
+ const validateArchiveBoundary = (path) => {
42
+ const archiveDir = join(dirname(path), WORKLOG_ARCHIVE_DIR);
43
+ const stat = entryStat(archiveDir);
44
+ if (stat && !stat.isDirectory()) {
45
+ const kind = stat.isSymbolicLink() ? 'symbolic link' : 'non-directory';
46
+ throw new Error(`refusing worklog retention: ${WORKLOG_ARCHIVE_DIR} is a ${kind}`);
47
+ }
48
+ return stat;
49
+ };
6
50
  export function inspectWorklog(path, policy) {
7
- const bytes = existsSync(path) ? statSync(path).size : 0;
51
+ const stat = entryStat(path);
52
+ if (policy && stat && !stat.isFile()) {
53
+ const kind = stat.isSymbolicLink() ? 'symbolic link' : 'non-regular file';
54
+ throw new Error(`refusing worklog rotation: WORKLOG.md is a ${kind}`);
55
+ }
56
+ const bytes = stat?.isFile() ? stat.size : 0;
8
57
  return {
9
58
  enabled: policy !== undefined,
10
59
  bytes,
@@ -22,11 +71,70 @@ const archiveName = (path, now, collision) => {
22
71
  const stamp = now.toISOString().replace(/:/g, '-');
23
72
  return join(dirname(path), `WORKLOG.${stamp}${collision ? `.${collision}` : ''}.md`);
24
73
  };
74
+ /**
75
+ * Keep a bounded set of recent archives beside WORKLOG.md without deleting
76
+ * history. Older archives move atomically-by-link into WORKLOG.archives/.
77
+ * The legacy name remains exported for source compatibility.
78
+ */
25
79
  export function pruneWorklogArchives(path, maxArchives) {
26
80
  const dir = dirname(path);
27
- const archives = readdirSync(dir).filter(name => ARCHIVE_RE.test(name)).sort().reverse();
28
- for (const old of archives.slice(maxArchives))
29
- rmSync(join(dir, old), { force: true });
81
+ const archives = readdirSync(dir).filter(name => ARCHIVE_RE.test(name)).sort((a, b) => {
82
+ const left = ARCHIVE_RE.exec(a);
83
+ const right = ARCHIVE_RE.exec(b);
84
+ return left[1].localeCompare(right[1])
85
+ || Number(left[2] ?? 0) - Number(right[2] ?? 0);
86
+ }).reverse();
87
+ const older = archives.slice(maxArchives);
88
+ if (!older.length)
89
+ return;
90
+ const archiveDir = join(dir, WORKLOG_ARCHIVE_DIR);
91
+ let boundary = validateArchiveBoundary(path);
92
+ if (!boundary) {
93
+ try {
94
+ mkdirSync(archiveDir, { mode: 0o700 });
95
+ }
96
+ catch (error) {
97
+ if (error.code !== 'EEXIST')
98
+ throw error;
99
+ }
100
+ boundary = validateArchiveBoundary(path);
101
+ }
102
+ if (!boundary)
103
+ throw new Error(`refusing worklog retention: ${WORKLOG_ARCHIVE_DIR} is unavailable`);
104
+ for (const old of older) {
105
+ const source = join(dir, old);
106
+ const sourceBefore = requireRegularFile(source, `archive ${old}`);
107
+ let collision = 0;
108
+ for (;;) {
109
+ const name = collision === 0 ? old : old.replace(/\.md$/, `.${collision}.md`);
110
+ const target = join(archiveDir, name);
111
+ try {
112
+ const currentBoundary = validateArchiveBoundary(path);
113
+ if (!currentBoundary || !sameInode(boundary, currentBoundary))
114
+ throw new Error(`refusing worklog retention: ${WORKLOG_ARCHIVE_DIR} changed`);
115
+ // Link then unlink: a crash can leave a duplicate, never lose the only
116
+ // archive. EEXIST chooses a new name rather than overwriting history.
117
+ linkSync(source, target);
118
+ const published = requireRegularFile(target, `cold archive ${name}`);
119
+ const sourceCurrent = requireRegularFile(source, `archive ${old}`);
120
+ const finalBoundary = validateArchiveBoundary(path);
121
+ if (!sameInode(sourceBefore, published) || !sameInode(sourceBefore, sourceCurrent)
122
+ || !finalBoundary || !sameInode(boundary, finalBoundary)) {
123
+ throw new Error(`refusing worklog retention: archive boundary changed during move`);
124
+ }
125
+ unlinkSync(source);
126
+ break;
127
+ }
128
+ catch (error) {
129
+ if (error.code === 'EEXIST') {
130
+ collision++;
131
+ continue;
132
+ }
133
+ cleanupDuplicateLink(source, target, sourceBefore);
134
+ throw error;
135
+ }
136
+ }
137
+ }
30
138
  }
31
139
  /**
32
140
  * Conservatively rotate a stable snapshot. A changed size/mtime/inode aborts
@@ -36,57 +144,101 @@ export function rotateWorklog(path, policy, deps = {}) {
36
144
  const inspection = inspectWorklog(path, policy);
37
145
  if (!policy || !inspection.overLimit)
38
146
  return { rotated: false, beforeBytes: inspection.bytes, afterBytes: inspection.bytes };
39
- const before = statSync(path);
40
- const content = readFileSync(path);
147
+ // Refuse a pre-existing symlink/non-directory even before publishing an
148
+ // archive or replacing the live path. Cold retention must remain inside the
149
+ // role's state boundary.
150
+ validateArchiveBoundary(path);
151
+ const pathBeforeOpen = requireRegularFile(path, 'WORKLOG.md');
152
+ let fd;
153
+ let before;
154
+ let content;
155
+ try {
156
+ fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW);
157
+ before = fstatSync(fd);
158
+ if (!before.isFile() || !sameInode(pathBeforeOpen, before))
159
+ throw new Error('refusing worklog rotation: WORKLOG.md changed while opening');
160
+ content = readFileSync(fd);
161
+ const afterRead = fstatSync(fd);
162
+ if (!sameSnapshot(before, afterRead))
163
+ return {
164
+ rotated: false, deferred: true,
165
+ beforeBytes: before.size, afterBytes: afterRead.size,
166
+ };
167
+ }
168
+ finally {
169
+ if (fd !== undefined)
170
+ closeSync(fd);
171
+ }
41
172
  const start = safeTailStart(content, policy.keep_tail_kb * 1024);
42
173
  const tail = content.subarray(start);
174
+ const tailStartsMidLine = start > 0 && content[start - 1] !== 0x0a;
43
175
  deps.beforeCommit?.();
44
- const current = statSync(path);
45
- if (current.ino !== before.ino || current.size !== before.size
46
- || current.mtimeMs !== before.mtimeMs) {
176
+ const current = requireRegularFile(path, 'WORKLOG.md');
177
+ if (!sameSnapshot(current, before)) {
47
178
  return {
48
179
  rotated: false, deferred: true,
49
180
  beforeBytes: before.size, afterBytes: current.size,
50
181
  };
51
182
  }
52
- let collision = 0;
53
- let archivePath = archiveName(path, deps.now?.() ?? new Date(), collision);
54
- while (existsSync(archivePath))
55
- archivePath = archiveName(path, deps.now?.() ?? new Date(), ++collision);
56
- // Prepare the intended tail before moving the live inode. replaceFileAtomically
57
- // gives us a fully written/fsynced inode; hard-linking it below publishes that
58
- // inode without ever overwriting a path a concurrent appender may create.
59
- const preparedTail = join(dirname(path), `.${basename(path)}.${randomUUID()}.rotate`);
60
- replaceFileAtomically(preparedTail, tail.toString('utf8'), before.mode & 0o777);
61
- try {
62
- // Linearization point: the complete original inode becomes the archive.
63
- // Writers that opened before this rename keep appending to that inode, so
64
- // their acknowledged bytes remain in the archive even after the move.
65
- renameSync(path, archivePath);
66
- deps.afterArchiveRename?.();
183
+ const rotatedAt = deps.now?.() ?? new Date();
184
+ let archivePath = '';
185
+ // Publish the complete original inode under a collision-safe archive name.
186
+ // link(2) is create-without-overwrite; concurrent appenders holding the old
187
+ // inode continue into the archive after the live path is replaced.
188
+ for (let collision = 0;; collision++) {
189
+ archivePath = archiveName(path, rotatedAt, collision);
67
190
  try {
68
- // Atomic create-without-overwrite. If a writer opened the missing path in
69
- // the rename→link window, it created the new live file; EEXIST means leave
70
- // that file untouched. The intended tail remains recoverable in the full
71
- // archive, and every concurrent suffix remains in the writer-created live.
72
- linkSync(preparedTail, path);
191
+ linkSync(path, archivePath);
192
+ const published = requireRegularFile(archivePath, `archive ${basename(archivePath)}`);
193
+ if (!sameInode(before, published)) {
194
+ try {
195
+ unlinkSync(archivePath);
196
+ }
197
+ catch { /* keep the primary safety failure */ }
198
+ throw new Error('refusing worklog rotation: published archive is not the inspected file');
199
+ }
200
+ break;
73
201
  }
74
- catch (e) {
75
- if (e.code !== 'EEXIST')
76
- throw e;
202
+ catch (error) {
203
+ if (error.code === 'EEXIST')
204
+ continue;
205
+ throw error;
77
206
  }
78
207
  }
79
- finally {
80
- rmSync(preparedTail, { force: true });
208
+ try {
209
+ deps.afterArchiveRename?.();
210
+ const liveBeforeReplace = requireRegularFile(path, 'WORKLOG.md');
211
+ if (!sameInode(before, liveBeforeReplace))
212
+ throw new Error('refusing worklog rotation: WORKLOG.md changed after archive publication');
213
+ // The helper writes and fsyncs a same-directory temp, atomically renames it
214
+ // over the live path, then fsyncs the directory. WORKLOG.md is never absent.
215
+ replaceFileAtomically(path, tail.toString('utf8'), before.mode & 0o777);
216
+ }
217
+ catch (error) {
218
+ // If the inspected inode is still the live file, the archive is only a
219
+ // duplicate artifact. Remove it best-effort and preserve the real error.
220
+ // If the live path changed, retain the archive because it may be the only
221
+ // remaining link to the inspected history.
222
+ cleanupDuplicateLink(path, archivePath, before);
223
+ throw error;
81
224
  }
82
- const liveBytes = existsSync(path) ? statSync(path).size : 0;
225
+ const archiveContent = readFileSync(archivePath);
226
+ const liveContent = existsSync(path) ? readFileSync(path) : Buffer.alloc(0);
227
+ const liveBytes = liveContent.length;
83
228
  const status = {
84
229
  schemaVersion: 1,
85
- rotatedAt: (deps.now?.() ?? new Date()).toISOString(),
230
+ rotatedAt: rotatedAt.toISOString(),
86
231
  beforeBytes: before.size,
87
232
  afterBytes: liveBytes,
88
233
  archive: basename(archivePath),
234
+ archiveBytes: archiveContent.length,
235
+ archiveSha256: sha256(archiveContent),
236
+ liveSha256: sha256(liveContent),
89
237
  archiveContainsFullSnapshot: true,
238
+ tailOmittedPrefixBytes: start,
239
+ ...(tailStartsMidLine ? { tailStartsMidLine: true } : {}),
240
+ olderArchives: WORKLOG_ARCHIVE_DIR,
241
+ recentArchiveLimit: policy.max_archives,
90
242
  };
91
243
  replaceFileAtomically(join(dirname(path), '.worklog-rotation.json'), `${JSON.stringify(status, null, 2)}\n`);
92
244
  pruneWorklogArchives(path, policy.max_archives);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ours.network/fleet",
3
- "version": "0.18.0-nightly.5",
3
+ "version": "0.18.0",
4
4
  "description": "Harness-agnostic fleet of persistent, identity-bound AI agents. Declarative fleet.yaml, tmux or ACP sessions, supervision, and ours.network messaging.",
5
5
  "type": "module",
6
6
  "license": "FSL-1.1-Apache-2.0",
@@ -38,8 +38,6 @@
38
38
  "@agentclientprotocol/sdk": "^1.3.0",
39
39
  "@fastify/static": "^10.1.2",
40
40
  "@fastify/websocket": "^11.2.0",
41
- "@ours.network/cli": "1.0.1",
42
- "@ours.network/sdk": "2.0.1",
43
41
  "@xterm/addon-fit": "0.10.0",
44
42
  "@xterm/addon-serialize": "0.13.0",
45
43
  "@xterm/headless": "5.5.0",
package/dist/owner-channel/ours-client.d.ts DELETED
@@ -1,141 +0,0 @@
1
- import { OursClient, type AttachOursClientOptions, type NotificationEvent } from '@ours.network/sdk/client';
2
- /** Any failure of a daemon operation. Never carries a message body or a token. */
3
- export declare class OursDaemonError extends Error {
4
- }
5
- /**
6
- * The daemon accepted the call and answered "not sent". The MCP surface reported
7
- * exactly these verdicts as tool errors, so they must keep throwing here: the
8
- * owner channel books a resolved send as delivered, and a silently-swallowed
9
- * refusal would be recorded as a delivered message that never left the host.
10
- */
11
- export declare class OursSendRefusedError extends OursDaemonError {
12
- }
13
- type Res<M extends keyof OursClient> = OursClient[M] extends (...args: never[]) => infer R ? Awaited<R> : never;
14
- export type OursContactsView = Res<'listContacts'>;
15
- export type OursInviteResult = Res<'generateInvite'>;
16
- export type OursAddContactResult = Res<'addContact'>;
17
- export type OursMessagesPayload = Res<'getMessages'>;
18
- export type OursInboundMessage = OursMessagesPayload['messages'][number];
19
- export type OursIncomingFile = Res<'listIncomingFiles'>[number];
20
- export type OursRetrievedFiles = Res<'getFiles'>;
21
- export type OursRetrievedFile = OursRetrievedFiles['files'][number];
22
- export type OursNotificationEvent = NotificationEvent;
23
- export declare class OursWatchDeadlineError extends OursDaemonError {
24
- }
25
- /**
26
- * The daemon operations the owner channel needs, one typed method each.
27
- *
28
- * This interface deliberately has no generic `callTool(name, args): unknown`
29
- * escape hatch. The legacy MCP connector answered every
30
- * tool with `{content:[{type:'text',...}]}` and no `structuredContent`, the
31
- * transport fell back to returning the daemon's English sentence — which the
32
- * channel then pattern-matched (an invite blob sliced out of a prose sentence,
33
- * a bind conflict detected with /currently bound to another live session/i).
34
- * With no untyped result there is nothing left to pattern-match.
35
- */
36
- export interface OursOps {
37
- /** Prepare the transport. Must be called before any operation. */
38
- start(): Promise<void>;
39
- /** Bind this session's identity. Throws `BOUND_ELSEWHERE` when it is held live. */
40
- bindIdentity(name: string): Promise<void>;
41
- listContacts(): Promise<OursContactsView>;
42
- generateInvite(name?: string): Promise<OursInviteResult>;
43
- addContact(a: {
44
- invite: string;
45
- name?: string;
46
- }): Promise<OursAddContactResult>;
47
- getMessages(): Promise<OursMessagesPayload>;
48
- deferMessages(msgIds: number[]): Promise<void>;
49
- watchNotifications(identity: string, options?: {
50
- since?: number | 'tip';
51
- signal?: AbortSignal;
52
- }): AsyncGenerator<OursNotificationEvent, void, undefined>;
53
- listIncomingFiles(): Promise<OursIncomingFile[]>;
54
- getFiles(wireIds: string[]): Promise<OursRetrievedFiles>;
55
- /**
56
- * The bytes of an already-retrieved file. Transport only — the caller owns
57
- * where they land, so path safety stays with the attachment code that already
58
- * enforces it (`writeRecoveredAttachment`).
59
- */
60
- fetchFile(wireId: string): Promise<Uint8Array>;
61
- sendMessage(a: {
62
- contact: string;
63
- text: string;
64
- replyToWireId?: string;
65
- }): Promise<void>;
66
- sendFile(a: {
67
- contact: string;
68
- path: string;
69
- filename: string;
70
- replyToWireId?: string;
71
- }): Promise<void>;
72
- /** Release the daemon lease and stop. Never throws. */
73
- close(): Promise<void>;
74
- }
75
- /**
76
- * The typed error code of a daemon operation, or undefined when the failure was
77
- * not one (transport, abort, programming error). `instanceof` is checked first;
78
- * the structural fallback keeps a duplicated SDK copy in a consumer's tree from
79
- * silently demoting a real daemon verdict to "unknown transport failure".
80
- */
81
- export declare function oursErrorCode(error: unknown): string | undefined;
82
- /** The identity is bound by another live session; a predecessor may still be releasing it. */
83
- export declare const OURS_BOUND_ELSEWHERE = "BOUND_ELSEWHERE";
84
- export interface OursSdkClientDeps {
85
- /** Test seam; production uses the SDK's coherence-checking application attach path. */
86
- attachClient?(options: AttachOursClientOptions): OursClient | Promise<OursClient>;
87
- /** Underlying transport and deadline seams for deterministic half-open tests. */
88
- fetch?: typeof globalThis.fetch;
89
- notificationRequestDeadlineMs?: number;
90
- readFile?(path: string): Promise<Uint8Array>;
91
- }
92
- /**
93
- * The owner-channel's daemon client: one `OursClient` over the local ours HTTP
94
- * API, owning exactly one identity binding.
95
- *
96
- * Lease lifetime. The lease token IS the session, so each channel instance mints
97
- * its own and hands it back in `close()`. That replaces the connector proxy's
98
- * shell-PID fence, which existed because a supervised attempt had to make its
99
- * lease reclaimable while the supervisor itself stayed alive: an explicit
100
- * release does that deterministically, and `clientPid` still covers the case
101
- * where the whole supervisor dies without unwinding.
102
- */
103
- export declare class OursSdkClient implements OursOps {
104
- private readonly env;
105
- private readonly log;
106
- private readonly deps;
107
- private client?;
108
- private readonly leaseToken;
109
- constructor(env?: Record<string, string>, log?: (line: string) => void, deps?: OursSdkClientDeps);
110
- start(): Promise<void>;
111
- bindIdentity(name: string): Promise<void>;
112
- listContacts(): Promise<OursContactsView>;
113
- generateInvite(name?: string): Promise<OursInviteResult>;
114
- addContact(a: {
115
- invite: string;
116
- name?: string;
117
- }): Promise<OursAddContactResult>;
118
- getMessages(): Promise<OursMessagesPayload>;
119
- deferMessages(msgIds: number[]): Promise<void>;
120
- watchNotifications(identity: string, options?: {
121
- since?: number | 'tip';
122
- signal?: AbortSignal;
123
- }): AsyncGenerator<OursNotificationEvent, void, undefined>;
124
- listIncomingFiles(): Promise<OursIncomingFile[]>;
125
- getFiles(wireIds: string[]): Promise<OursRetrievedFiles>;
126
- fetchFile(wireId: string): Promise<Uint8Array>;
127
- sendMessage(a: {
128
- contact: string;
129
- text: string;
130
- replyToWireId?: string;
131
- }): Promise<void>;
132
- sendFile(a: {
133
- contact: string;
134
- path: string;
135
- filename: string;
136
- replyToWireId?: string;
137
- }): Promise<void>;
138
- close(): Promise<void>;
139
- private ops;
140
- }
141
- export {};