@tangle-network/agent-runtime 0.339.0 → 0.340.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.
- package/dist/{activation-CVSFxis9.js → activation-D2PVljaw.js} +4 -4
- package/dist/{activation-CVSFxis9.js.map → activation-D2PVljaw.js.map} +1 -1
- package/dist/{activation-CJIIl_Ey.d.ts → activation-DGDl4wwI.d.ts} +2 -2
- package/dist/agent.d.ts +4 -18
- package/dist/agent.js +3 -21
- package/dist/agent.js.map +1 -1
- package/dist/analyst-loop.d.ts +2 -2
- package/dist/{bundle-DVOhBTic.js → bundle-DNUq-OPW.js} +2 -2
- package/dist/{bundle-DVOhBTic.js.map → bundle-DNUq-OPW.js.map} +1 -1
- package/dist/candidate-execution/index.d.ts +2 -40
- package/dist/candidate-execution/index.js +9 -255
- package/dist/candidate-execution/index.js.map +1 -1
- package/dist/{delegate-CCWE_AkU.js → delegate-CtJIS-tp.js} +2 -2
- package/dist/{delegate-CCWE_AkU.js.map → delegate-CtJIS-tp.js.map} +1 -1
- package/dist/{driver-control-acknowledgers-C53ggdJ6.js → driver-control-acknowledgers-MTrs8HAF.js} +5 -5
- package/dist/driver-control-acknowledgers-MTrs8HAF.js.map +1 -0
- package/dist/durable.d.ts +1 -1
- package/dist/durable.js +5 -5
- package/dist/{graph-CI9JXKqO.js → graph-DfWqp_1e.js} +4 -4
- package/dist/{graph-CI9JXKqO.js.map → graph-DfWqp_1e.js.map} +1 -1
- package/dist/{improve-BOXTLWJ3.js → improve-CKRVQqzt.js} +6 -6
- package/dist/{improve-BOXTLWJ3.js.map → improve-CKRVQqzt.js.map} +1 -1
- package/dist/{improvement-adapter-HUt_-cWA.d.ts → improvement-adapter-sIthWkcN.d.ts} +2 -2
- package/dist/index.d.ts +6 -14
- package/dist/index.js +10 -10
- package/dist/intelligence.d.ts +4 -4
- package/dist/intelligence.js +6 -6
- package/dist/kernel.d.ts +3 -3
- package/dist/kernel.js +10 -10
- package/dist/{loop-runner-CWzG1bH4.d.ts → loop-runner-C4EWEcXf.d.ts} +3 -3
- package/dist/{loop-runner-pmPIHFVY.js → loop-runner-DNWbTcVm.js} +2 -2
- package/dist/{loop-runner-pmPIHFVY.js.map → loop-runner-DNWbTcVm.js.map} +1 -1
- package/dist/loop-runner-bin.d.ts +1 -1
- package/dist/loop-runner-bin.js +1 -1
- package/dist/mcp/bin.js +3 -3
- package/dist/mcp/index.d.ts +1 -1
- package/dist/mcp/index.js +5 -5
- package/dist/placement.d.ts +2 -26
- package/dist/placement.js +1 -35
- package/dist/placement.js.map +1 -1
- package/dist/{prepare-bXkvPMJA.js → prepare-FzJoS68l.js} +3 -3
- package/dist/{prepare-bXkvPMJA.js.map → prepare-FzJoS68l.js.map} +1 -1
- package/dist/{profile-Dpei_Sq0.js → profile-DToH0XEs.js} +2 -2
- package/dist/{profile-Dpei_Sq0.js.map → profile-DToH0XEs.js.map} +1 -1
- package/dist/profile-materialization-bPm0gGLO.d.ts +49 -0
- package/dist/profiles.d.ts +1 -1
- package/dist/{protected-model-port-BGgpy2r9.d.ts → protected-model-port-DVVh-hEk.d.ts} +2 -6
- package/dist/{provision-supervisor-CJ6Zz6dz.js → provision-supervisor-DqvWXmAE.js} +4 -4
- package/dist/{provision-supervisor-CJ6Zz6dz.js.map → provision-supervisor-DqvWXmAE.js.map} +1 -1
- package/dist/{runtime-B2fjL9Oi.js → runtime-C55Zgo1R.js} +10 -10
- package/dist/{runtime-B2fjL9Oi.js.map → runtime-C55Zgo1R.js.map} +1 -1
- package/dist/{sandbox-profile-compat-BzVBFqrz.js → sandbox-profile-compat-DRr3JwDx.js} +2 -2
- package/dist/{sandbox-profile-compat-BzVBFqrz.js.map → sandbox-profile-compat-DRr3JwDx.js.map} +1 -1
- package/dist/{search-executor-zMumiak_.js → search-executor-ChOlRBgg.js} +3 -3
- package/dist/{search-executor-zMumiak_.js.map → search-executor-ChOlRBgg.js.map} +1 -1
- package/dist/{server-_4voDNrl.js → server-DkVBSN_S.js} +4 -4
- package/dist/{server-_4voDNrl.js.map → server-DkVBSN_S.js.map} +1 -1
- package/dist/{structural-rollout-DpLCXzaL.js → structural-rollout-C1LEk_zq.js} +3 -3
- package/dist/{structural-rollout-DpLCXzaL.js.map → structural-rollout-C1LEk_zq.js.map} +1 -1
- package/dist/{supervise-qAwXmPtD.js → supervise-CaUAxZZP.js} +86 -22
- package/dist/supervise-CaUAxZZP.js.map +1 -0
- package/dist/{supervisor-DHrUJhEZ.js → supervisor-VXuN2OHT.js} +29 -86
- package/dist/supervisor-VXuN2OHT.js.map +1 -0
- package/dist/testing.d.ts +1 -1
- package/dist/testing.js +13 -13
- package/dist/tui/index.d.ts +1 -1
- package/dist/tui/index.js +1 -1
- package/dist/{types-zWfqDjeL.d.ts → types-Cwrea-bU.d.ts} +2 -17
- package/dist/{types-CaOXqRTq.d.ts → types-DZ6L0Bv3.d.ts} +54 -58
- package/dist/workspace-store/index.d.ts +1 -82
- package/dist/workspace-store/index.js +1 -415
- package/dist/workspace-store/index.js.map +1 -1
- package/package.json +1 -1
- package/dist/driver-control-acknowledgers-C53ggdJ6.js.map +0 -1
- package/dist/profile-materialization-B1wm2SPT.d.ts +0 -94
- package/dist/supervise-qAwXmPtD.js.map +0 -1
- package/dist/supervisor-DHrUJhEZ.js.map +0 -1
|
@@ -128,41 +128,6 @@ interface WorkspaceContentCodec {
|
|
|
128
128
|
seal(plain: Uint8Array, context: WorkspaceCodecContext): Promise<Uint8Array>;
|
|
129
129
|
open(sealed: Uint8Array, context: WorkspaceCodecContext): Promise<Uint8Array>;
|
|
130
130
|
}
|
|
131
|
-
/** A value did not open: unknown key, wrong tenant or path, tampering, or plaintext where a seal was required. */
|
|
132
|
-
declare class WorkspaceCodecError extends Error {
|
|
133
|
-
readonly code: "codec";
|
|
134
|
-
constructor(message: string);
|
|
135
|
-
}
|
|
136
|
-
/**
|
|
137
|
-
* AES-256-GCM with a key id per value. `keys` maps key id to 32 raw bytes
|
|
138
|
-
* (base64 or base64url when a string). The encryption key and the key that
|
|
139
|
-
* derives replay-stable IVs are both derived from the raw key with HKDF, so the
|
|
140
|
-
* raw key is never used for two algorithms.
|
|
141
|
-
*
|
|
142
|
-
* Without an `operationId` every seal uses a random 96-bit IV. With one, the IV
|
|
143
|
-
* is an HMAC of the tenant, path, operation and plaintext, as in SIV: only an
|
|
144
|
-
* identical write repeats it, and that repeat reveals only that the write was
|
|
145
|
-
* repeated.
|
|
146
|
-
*/
|
|
147
|
-
declare function createAesGcmContentCodec(options: {
|
|
148
|
-
keys: Readonly<Record<string, string | Uint8Array>>;
|
|
149
|
-
activeKeyId: string;
|
|
150
|
-
}): WorkspaceContentCodec;
|
|
151
|
-
/**
|
|
152
|
-
* The AES-256-GCM codec from an app's env, or `null` when neither variable is
|
|
153
|
-
* set. `WORKSPACE_STORE_KEYS` is `id:base64,id:base64`; `WORKSPACE_STORE_KEY_ID`
|
|
154
|
-
* names the key new writes use. Setting one without the other is refused.
|
|
155
|
-
*/
|
|
156
|
-
declare function aesGcmContentCodecFromEnv(env: {
|
|
157
|
-
WORKSPACE_STORE_KEYS?: string;
|
|
158
|
-
WORKSPACE_STORE_KEY_ID?: string;
|
|
159
|
-
}): WorkspaceContentCodec | null;
|
|
160
|
-
/** Stored text of a sealed `content`: a prefix, then the sealed bytes in base64. */
|
|
161
|
-
declare const SEALED_CONTENT_PREFIX = "wsc1:";
|
|
162
|
-
/** Seal bytes a host is about to upload (an R2 object) under the entry's tenant and path. */
|
|
163
|
-
declare function sealWorkspaceBytes(codec: WorkspaceContentCodec, context: WorkspaceCodecContext, bytes: Uint8Array): Promise<Uint8Array>;
|
|
164
|
-
/** Open bytes a host downloaded for an entry's `bytes` reference. */
|
|
165
|
-
declare function openWorkspaceBytes(codec: WorkspaceContentCodec, context: WorkspaceCodecContext, sealed: Uint8Array): Promise<Uint8Array>;
|
|
166
131
|
interface ContentCodecOptions {
|
|
167
132
|
/**
|
|
168
133
|
* Return stored content that is not sealed as is, for a store being moved
|
|
@@ -170,13 +135,6 @@ interface ContentCodecOptions {
|
|
|
170
135
|
*/
|
|
171
136
|
readonly readPlaintext?: boolean;
|
|
172
137
|
}
|
|
173
|
-
/**
|
|
174
|
-
* `store` with every entry's `content` sealed at rest. Index fields, `bytes`
|
|
175
|
-
* references and tombstones pass through untouched; the host seals the bytes
|
|
176
|
-
* themselves. `idempotentOperations` is the inner store's: a replayed put with
|
|
177
|
-
* an `operationId` seals to the same bytes, so the inner replay check holds.
|
|
178
|
-
*/
|
|
179
|
-
declare function withContentCodec(store: WorkspaceStore, codec: WorkspaceContentCodec, options?: ContentCodecOptions): WorkspaceStore;
|
|
180
138
|
//#endregion
|
|
181
139
|
//#region src/workspace-store/contract.d.ts
|
|
182
140
|
interface WorkspaceStoreContractCase {
|
|
@@ -274,31 +232,12 @@ declare function renderPinnedMemory(entries: readonly WorkspaceEntry[], options?
|
|
|
274
232
|
}): string;
|
|
275
233
|
//#endregion
|
|
276
234
|
//#region src/workspace-store/harness.d.ts
|
|
277
|
-
/** Opening marker for the generated block in a harness's native memory file. */
|
|
278
|
-
declare const HARNESS_MEMORY_BEGIN = "<!-- workspace-store:memory begin. Generated from the workspace store; save memories with memory.remember. -->";
|
|
279
|
-
/** The generated block a host writes into a harness's native memory location. */
|
|
280
|
-
declare function renderHarnessMemory(entries: readonly WorkspaceEntry[], options?: {
|
|
281
|
-
maxTokens?: number;
|
|
282
|
-
}): string;
|
|
283
|
-
/** Replace the generated block in `native`, or append one; text outside it is kept byte for byte. */
|
|
284
|
-
declare function projectHarnessMemory(native: string, block: string): string;
|
|
285
|
-
/** Native files keyed by path, as the host read them. A missing file is absent or `undefined`. */
|
|
286
|
-
type HarnessNativeFiles = Readonly<Record<string, string | undefined>>;
|
|
287
|
-
/**
|
|
288
|
-
* What the harness added during the turn, outside the generated block: new
|
|
289
|
-
* lines in files that existed, and the body of new files (a Claude Code memory
|
|
290
|
-
* directory entry). Lines removed or present before are ignored; a removal is
|
|
291
|
-
* not a forget, which only `memory.forget` performs.
|
|
292
|
-
*/
|
|
293
|
-
declare function captureHarnessMemory(before: HarnessNativeFiles, after: HarnessNativeFiles): string[];
|
|
294
235
|
/** Where a captured memory came from. */
|
|
295
236
|
interface HarnessProvenance {
|
|
296
237
|
readonly harness: string;
|
|
297
238
|
readonly turnId: string;
|
|
298
239
|
readonly memberId: string;
|
|
299
240
|
}
|
|
300
|
-
/** Read the harness, turn, and member provenance encoded by `harnessActor`. */
|
|
301
|
-
declare function parseHarnessActor(actor: string): HarnessProvenance | null;
|
|
302
241
|
interface HarnessIngestResult {
|
|
303
242
|
readonly saved: WorkspaceEntry[];
|
|
304
243
|
/** Facts already in the store, by normalized text. */
|
|
@@ -309,16 +248,6 @@ interface HarnessIngestResult {
|
|
|
309
248
|
reason: string;
|
|
310
249
|
}[];
|
|
311
250
|
}
|
|
312
|
-
/**
|
|
313
|
-
* Save captured facts as workspace memories through the same policy as
|
|
314
|
-
* `memory.remember`, with the harness and turn as the actor. Duplicates of a
|
|
315
|
-
* memory the turn can see, or of an earlier fact in the batch, are skipped.
|
|
316
|
-
*/
|
|
317
|
-
declare function ingestHarnessMemories(context: WorkspaceToolContext, input: {
|
|
318
|
-
harness: string;
|
|
319
|
-
turnId: string;
|
|
320
|
-
facts: readonly string[];
|
|
321
|
-
}): Promise<HarnessIngestResult>;
|
|
322
251
|
interface MemoryDivergence {
|
|
323
252
|
/** Sum of the counts below; 0 means every native copy agrees with the store. */
|
|
324
253
|
readonly total: number;
|
|
@@ -334,16 +263,6 @@ interface MemoryDivergence {
|
|
|
334
263
|
uncaptured: string[];
|
|
335
264
|
}>;
|
|
336
265
|
}
|
|
337
|
-
/**
|
|
338
|
-
* Compare each native file with the store as `turn` sees it, after ingest ran.
|
|
339
|
-
* `before` is the files as projected at session start, `after` as they are now:
|
|
340
|
-
* only what the harness added since then can be uncaptured, so the profile's own
|
|
341
|
-
* generated text in the same file never counts. Files that held a generated
|
|
342
|
-
* block at session start are projection targets: losing the block counts every
|
|
343
|
-
* visible memory as missing. Other files (a new memory-directory entry) can
|
|
344
|
-
* only hold uncaptured facts.
|
|
345
|
-
*/
|
|
346
|
-
declare function memoryDivergence(store: WorkspaceStore, turn: WorkspaceTurn, before: HarnessNativeFiles, after: HarnessNativeFiles): Promise<MemoryDivergence>;
|
|
347
266
|
//#endregion
|
|
348
|
-
export { type ContentCodecOptions,
|
|
267
|
+
export { type ContentCodecOptions, type HarnessIngestResult, type HarnessProvenance, type MakeWorkspaceStore, type MemoryDivergence, type MemoryPolicy, type WorkspaceAccess, type WorkspaceBytesRef, type WorkspaceCodecContext, WorkspaceConflictError, type WorkspaceContentCodec, type WorkspaceDeleteInput, type WorkspaceEntry, type WorkspaceEntryKind, type WorkspaceEntryScope, type WorkspacePolicyDecision, type WorkspacePutInput, type WorkspaceRole, type WorkspaceStore, type WorkspaceStoreContractCase, type WorkspaceStoreContractOptions, type WorkspaceStoreContractResult, type WorkspaceTombstone, type WorkspaceToolContext, type WorkspaceToolDefinition, type WorkspaceTurn, assertWorkspacePath, checkWorkspacePut, createFileTools, createInMemoryWorkspaceStore, createMemoryTools, defaultMemoryPolicy, readTurnMemories, renderPinnedMemory, runWorkspaceStoreContract, workspaceStoreContractCases };
|
|
349
268
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1,215 +1,4 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
//#region src/workspace-store/codec.ts
|
|
3
|
-
/** A value did not open: unknown key, wrong tenant or path, tampering, or plaintext where a seal was required. */
|
|
4
|
-
var WorkspaceCodecError = class extends Error {
|
|
5
|
-
code = "codec";
|
|
6
|
-
constructor(message) {
|
|
7
|
-
super(message);
|
|
8
|
-
this.name = "WorkspaceCodecError";
|
|
9
|
-
}
|
|
10
|
-
};
|
|
11
|
-
const VERSION = 1;
|
|
12
|
-
const IV_BYTES = 12;
|
|
13
|
-
const KEY_ID = /^[A-Za-z0-9_-]{1,64}$/;
|
|
14
|
-
const encoder = new TextEncoder();
|
|
15
|
-
const decoder = new TextDecoder("utf-8", { fatal: true });
|
|
16
|
-
function bytesOf(value) {
|
|
17
|
-
if (typeof value !== "string") return value;
|
|
18
|
-
const binary = atob(value.replace(/-/g, "+").replace(/_/g, "/"));
|
|
19
|
-
return Uint8Array.from(binary, (char) => char.charCodeAt(0));
|
|
20
|
-
}
|
|
21
|
-
function base64(bytes) {
|
|
22
|
-
let binary = "";
|
|
23
|
-
for (let offset = 0; offset < bytes.length; offset += 32768) binary += String.fromCharCode(...bytes.subarray(offset, offset + 32768));
|
|
24
|
-
return btoa(binary);
|
|
25
|
-
}
|
|
26
|
-
/** A copy in a plain ArrayBuffer, which every Web Crypto typing accepts (this package has no DOM lib). */
|
|
27
|
-
function arrayBuffer(bytes) {
|
|
28
|
-
return bytes.slice().buffer;
|
|
29
|
-
}
|
|
30
|
-
function concat(...parts) {
|
|
31
|
-
const out = new Uint8Array(parts.reduce((total, part) => total + part.length, 0));
|
|
32
|
-
let offset = 0;
|
|
33
|
-
for (const part of parts) {
|
|
34
|
-
out.set(part, offset);
|
|
35
|
-
offset += part.length;
|
|
36
|
-
}
|
|
37
|
-
return out;
|
|
38
|
-
}
|
|
39
|
-
/** Strings joined with a 4-byte length before each, so no two lists encode alike. */
|
|
40
|
-
function framed(...values) {
|
|
41
|
-
return concat(...values.flatMap((value) => {
|
|
42
|
-
const bytes = encoder.encode(value);
|
|
43
|
-
const length = /* @__PURE__ */ new Uint8Array(4);
|
|
44
|
-
new DataView(length.buffer).setUint32(0, bytes.length);
|
|
45
|
-
return [length, bytes];
|
|
46
|
-
}));
|
|
47
|
-
}
|
|
48
|
-
/** The authenticated data: the tenant and path a value belongs to. */
|
|
49
|
-
const associated = ({ tenant, path }) => framed(tenant, path);
|
|
50
|
-
/**
|
|
51
|
-
* AES-256-GCM with a key id per value. `keys` maps key id to 32 raw bytes
|
|
52
|
-
* (base64 or base64url when a string). The encryption key and the key that
|
|
53
|
-
* derives replay-stable IVs are both derived from the raw key with HKDF, so the
|
|
54
|
-
* raw key is never used for two algorithms.
|
|
55
|
-
*
|
|
56
|
-
* Without an `operationId` every seal uses a random 96-bit IV. With one, the IV
|
|
57
|
-
* is an HMAC of the tenant, path, operation and plaintext, as in SIV: only an
|
|
58
|
-
* identical write repeats it, and that repeat reveals only that the write was
|
|
59
|
-
* repeated.
|
|
60
|
-
*/
|
|
61
|
-
function createAesGcmContentCodec(options) {
|
|
62
|
-
const raw = /* @__PURE__ */ new Map();
|
|
63
|
-
for (const [id, value] of Object.entries(options.keys)) {
|
|
64
|
-
if (!KEY_ID.test(id)) throw new TypeError(`workspace store key id is not [A-Za-z0-9_-]{1,64}: ${id}`);
|
|
65
|
-
const bytes = bytesOf(value);
|
|
66
|
-
if (bytes.length !== 32) throw new TypeError(`workspace store key ${id} must be 32 bytes, got ${bytes.length}`);
|
|
67
|
-
raw.set(id, bytes);
|
|
68
|
-
}
|
|
69
|
-
if (!raw.has(options.activeKeyId)) throw new TypeError(`the active workspace store key ${options.activeKeyId} is not among the keys`);
|
|
70
|
-
const derived = /* @__PURE__ */ new Map();
|
|
71
|
-
const keyFor = (id) => {
|
|
72
|
-
const bytes = raw.get(id);
|
|
73
|
-
if (!bytes) return Promise.reject(new WorkspaceCodecError(`unknown workspace store key id: ${id}`));
|
|
74
|
-
let key = derived.get(id);
|
|
75
|
-
if (!key) {
|
|
76
|
-
key = (async () => {
|
|
77
|
-
const base = await crypto.subtle.importKey("raw", arrayBuffer(bytes), "HKDF", false, ["deriveKey"]);
|
|
78
|
-
const hkdf = (info) => ({
|
|
79
|
-
name: "HKDF",
|
|
80
|
-
hash: "SHA-256",
|
|
81
|
-
salt: /* @__PURE__ */ new Uint8Array(32),
|
|
82
|
-
info: encoder.encode(`workspace-store/${info}`)
|
|
83
|
-
});
|
|
84
|
-
return {
|
|
85
|
-
seal: await crypto.subtle.deriveKey(hkdf("aes-256-gcm"), base, {
|
|
86
|
-
name: "AES-GCM",
|
|
87
|
-
length: 256
|
|
88
|
-
}, false, ["encrypt", "decrypt"]),
|
|
89
|
-
iv: await crypto.subtle.deriveKey(hkdf("siv"), base, {
|
|
90
|
-
name: "HMAC",
|
|
91
|
-
hash: "SHA-256",
|
|
92
|
-
length: 256
|
|
93
|
-
}, false, ["sign"])
|
|
94
|
-
};
|
|
95
|
-
})();
|
|
96
|
-
derived.set(id, key);
|
|
97
|
-
}
|
|
98
|
-
return key;
|
|
99
|
-
};
|
|
100
|
-
return {
|
|
101
|
-
async seal(plain, context) {
|
|
102
|
-
const id = options.activeKeyId;
|
|
103
|
-
const key = await keyFor(id);
|
|
104
|
-
const aad = associated(context);
|
|
105
|
-
const iv = context.operationId === void 0 ? crypto.getRandomValues(new Uint8Array(IV_BYTES)) : new Uint8Array(await crypto.subtle.sign("HMAC", key.iv, arrayBuffer(concat(framed(context.tenant, context.path, context.operationId), plain)))).slice(0, IV_BYTES);
|
|
106
|
-
const sealed = new Uint8Array(await crypto.subtle.encrypt({
|
|
107
|
-
name: "AES-GCM",
|
|
108
|
-
iv: arrayBuffer(iv),
|
|
109
|
-
additionalData: arrayBuffer(aad)
|
|
110
|
-
}, key.seal, arrayBuffer(plain)));
|
|
111
|
-
const keyId = encoder.encode(id);
|
|
112
|
-
return concat(Uint8Array.of(VERSION, keyId.length), keyId, iv, sealed);
|
|
113
|
-
},
|
|
114
|
-
async open(sealed, context) {
|
|
115
|
-
if (sealed.length < 2 || sealed[0] !== VERSION) throw new WorkspaceCodecError("not a sealed workspace value");
|
|
116
|
-
const start = 2 + sealed[1];
|
|
117
|
-
if (sealed.length < start + IV_BYTES + 16) throw new WorkspaceCodecError("a sealed workspace value is truncated");
|
|
118
|
-
const key = await keyFor(new TextDecoder().decode(sealed.subarray(2, start)));
|
|
119
|
-
try {
|
|
120
|
-
return new Uint8Array(await crypto.subtle.decrypt({
|
|
121
|
-
name: "AES-GCM",
|
|
122
|
-
iv: arrayBuffer(sealed.subarray(start, start + IV_BYTES)),
|
|
123
|
-
additionalData: arrayBuffer(associated(context))
|
|
124
|
-
}, key.seal, arrayBuffer(sealed.subarray(start + IV_BYTES))));
|
|
125
|
-
} catch {
|
|
126
|
-
throw new WorkspaceCodecError(`${context.path}: the sealed value does not open for this tenant and path`);
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
};
|
|
130
|
-
}
|
|
131
|
-
/**
|
|
132
|
-
* The AES-256-GCM codec from an app's env, or `null` when neither variable is
|
|
133
|
-
* set. `WORKSPACE_STORE_KEYS` is `id:base64,id:base64`; `WORKSPACE_STORE_KEY_ID`
|
|
134
|
-
* names the key new writes use. Setting one without the other is refused.
|
|
135
|
-
*/
|
|
136
|
-
function aesGcmContentCodecFromEnv(env) {
|
|
137
|
-
const list = env.WORKSPACE_STORE_KEYS?.trim();
|
|
138
|
-
const active = env.WORKSPACE_STORE_KEY_ID?.trim();
|
|
139
|
-
if (!list && !active) return null;
|
|
140
|
-
if (!list || !active) throw new TypeError("set both WORKSPACE_STORE_KEYS and WORKSPACE_STORE_KEY_ID");
|
|
141
|
-
const keys = {};
|
|
142
|
-
for (const pair of list.split(",")) {
|
|
143
|
-
const at = pair.indexOf(":");
|
|
144
|
-
if (at <= 0) throw new TypeError("WORKSPACE_STORE_KEYS is id:base64,id:base64");
|
|
145
|
-
keys[pair.slice(0, at).trim()] = pair.slice(at + 1).trim();
|
|
146
|
-
}
|
|
147
|
-
return createAesGcmContentCodec({
|
|
148
|
-
keys,
|
|
149
|
-
activeKeyId: active
|
|
150
|
-
});
|
|
151
|
-
}
|
|
152
|
-
/** Stored text of a sealed `content`: a prefix, then the sealed bytes in base64. */
|
|
153
|
-
const SEALED_CONTENT_PREFIX = "wsc1:";
|
|
154
|
-
/** Seal bytes a host is about to upload (an R2 object) under the entry's tenant and path. */
|
|
155
|
-
function sealWorkspaceBytes(codec, context, bytes) {
|
|
156
|
-
return codec.seal(bytes, context);
|
|
157
|
-
}
|
|
158
|
-
/** Open bytes a host downloaded for an entry's `bytes` reference. */
|
|
159
|
-
function openWorkspaceBytes(codec, context, sealed) {
|
|
160
|
-
return codec.open(sealed, context);
|
|
161
|
-
}
|
|
162
|
-
/**
|
|
163
|
-
* `store` with every entry's `content` sealed at rest. Index fields, `bytes`
|
|
164
|
-
* references and tombstones pass through untouched; the host seals the bytes
|
|
165
|
-
* themselves. `idempotentOperations` is the inner store's: a replayed put with
|
|
166
|
-
* an `operationId` seals to the same bytes, so the inner replay check holds.
|
|
167
|
-
*/
|
|
168
|
-
function withContentCodec(store, codec, options = {}) {
|
|
169
|
-
const open = async (entry) => {
|
|
170
|
-
if (entry.content === void 0) return entry;
|
|
171
|
-
if (!entry.content.startsWith("wsc1:")) {
|
|
172
|
-
if (options.readPlaintext) return entry;
|
|
173
|
-
throw new WorkspaceCodecError(`${entry.path}: stored content is not sealed`);
|
|
174
|
-
}
|
|
175
|
-
const plain = await codec.open(bytesOf(entry.content.slice(5)), {
|
|
176
|
-
tenant: entry.workspaceId,
|
|
177
|
-
path: entry.path
|
|
178
|
-
});
|
|
179
|
-
return {
|
|
180
|
-
...entry,
|
|
181
|
-
content: decoder.decode(plain)
|
|
182
|
-
};
|
|
183
|
-
};
|
|
184
|
-
return {
|
|
185
|
-
...store.idempotentOperations !== void 0 ? { idempotentOperations: store.idempotentOperations } : {},
|
|
186
|
-
async get(workspaceId, path) {
|
|
187
|
-
const entry = await store.get(workspaceId, path);
|
|
188
|
-
return entry ? open(entry) : null;
|
|
189
|
-
},
|
|
190
|
-
async list(workspaceId, prefix) {
|
|
191
|
-
return Promise.all((await store.list(workspaceId, prefix)).map(open));
|
|
192
|
-
},
|
|
193
|
-
async put(input) {
|
|
194
|
-
if (input.content === void 0) return store.put(input);
|
|
195
|
-
const sealed = await codec.seal(encoder.encode(input.content), {
|
|
196
|
-
tenant: input.workspaceId,
|
|
197
|
-
path: input.path,
|
|
198
|
-
...input.operationId !== void 0 ? { operationId: input.operationId } : {}
|
|
199
|
-
});
|
|
200
|
-
return {
|
|
201
|
-
...await store.put({
|
|
202
|
-
...input,
|
|
203
|
-
content: `${SEALED_CONTENT_PREFIX}${base64(sealed)}`
|
|
204
|
-
}),
|
|
205
|
-
content: input.content
|
|
206
|
-
};
|
|
207
|
-
},
|
|
208
|
-
delete: (input) => store.delete(input),
|
|
209
|
-
tombstones: (workspaceId, prefix) => store.tombstones(workspaceId, prefix)
|
|
210
|
-
};
|
|
211
|
-
}
|
|
212
|
-
//#endregion
|
|
213
2
|
//#region src/workspace-store/store.ts
|
|
214
3
|
/** A write lost a compare-and-set race or targeted the wrong revision. Re-read and retry. */
|
|
215
4
|
var WorkspaceConflictError = class extends Error {
|
|
@@ -1168,209 +957,6 @@ async function runWorkspaceStoreContract(makeStore, options = {}) {
|
|
|
1168
957
|
return results;
|
|
1169
958
|
}
|
|
1170
959
|
//#endregion
|
|
1171
|
-
|
|
1172
|
-
/** Opening marker for the generated block in a harness's native memory file. */
|
|
1173
|
-
const HARNESS_MEMORY_BEGIN = "<!-- workspace-store:memory begin. Generated from the workspace store; save memories with memory.remember. -->";
|
|
1174
|
-
/** Closing marker for the generated block in a harness's native memory file. */
|
|
1175
|
-
const HARNESS_MEMORY_END = "<!-- workspace-store:memory end -->";
|
|
1176
|
-
/** The generated block a host writes into a harness's native memory location. */
|
|
1177
|
-
function renderHarnessMemory(entries, options = {}) {
|
|
1178
|
-
return [
|
|
1179
|
-
HARNESS_MEMORY_BEGIN,
|
|
1180
|
-
renderPinnedMemory(entries, options),
|
|
1181
|
-
HARNESS_MEMORY_END
|
|
1182
|
-
].join("\n");
|
|
1183
|
-
}
|
|
1184
|
-
/** Replace the generated block in `native`, or append one; text outside it is kept byte for byte. */
|
|
1185
|
-
function projectHarnessMemory(native, block) {
|
|
1186
|
-
const { before, after, found } = splitGenerated(native);
|
|
1187
|
-
if (found) return `${before}${block}${after}`;
|
|
1188
|
-
return native.length === 0 ? `${block}\n` : `${native}${native.endsWith("\n") ? "\n" : "\n\n"}${block}\n`;
|
|
1189
|
-
}
|
|
1190
|
-
function splitGenerated(native) {
|
|
1191
|
-
const start = native.indexOf(HARNESS_MEMORY_BEGIN);
|
|
1192
|
-
const end = start < 0 ? -1 : native.indexOf(HARNESS_MEMORY_END, start);
|
|
1193
|
-
if (start < 0 || end < 0) return {
|
|
1194
|
-
before: native,
|
|
1195
|
-
block: "",
|
|
1196
|
-
after: "",
|
|
1197
|
-
found: false
|
|
1198
|
-
};
|
|
1199
|
-
const stop = end + 35;
|
|
1200
|
-
return {
|
|
1201
|
-
before: native.slice(0, start),
|
|
1202
|
-
block: native.slice(start, stop),
|
|
1203
|
-
after: native.slice(stop),
|
|
1204
|
-
found: true
|
|
1205
|
-
};
|
|
1206
|
-
}
|
|
1207
|
-
/** Ids listed in a generated block (`- [id] kind, scope: text`). */
|
|
1208
|
-
function projectedIds(block) {
|
|
1209
|
-
const ids = /* @__PURE__ */ new Map();
|
|
1210
|
-
for (const match of block.matchAll(/^- \[([A-Za-z0-9_-]{1,64})\] [a-z]+, (?:me|workspace): (.*)$/gm)) ids.set(match[1], match[2]);
|
|
1211
|
-
return ids;
|
|
1212
|
-
}
|
|
1213
|
-
/** Lowercase, collapse spaces, drop a leading "Remember:" and trailing punctuation: the duplicate key. */
|
|
1214
|
-
function normalizeMemoryText(text) {
|
|
1215
|
-
return text.replace(/^\s*(?:[-*+]\s+|\d+[.)]\s+)?/, "").replace(/^(?:remember|note)\b\s*(?:that\b)?\s*:?\s*/i, "").replace(/\s+/g, " ").trim().replace(/[.!;,\s]+$/, "").toLowerCase();
|
|
1216
|
-
}
|
|
1217
|
-
function stripFrontmatter(text) {
|
|
1218
|
-
return text.startsWith("---\n") ? text.slice(text.indexOf("\n---", 4) + 4).replace(/^\n+/, "") : text;
|
|
1219
|
-
}
|
|
1220
|
-
/** Lines that read as one memory: bullets and plain sentences, not headings, markers or fences. */
|
|
1221
|
-
function memoryLines(text) {
|
|
1222
|
-
const lines = [];
|
|
1223
|
-
let fenced = false;
|
|
1224
|
-
for (const raw of stripFrontmatter(text).split("\n")) {
|
|
1225
|
-
const line = raw.trim();
|
|
1226
|
-
if (line.startsWith("```")) {
|
|
1227
|
-
fenced = !fenced;
|
|
1228
|
-
continue;
|
|
1229
|
-
}
|
|
1230
|
-
if (fenced || !line || line.startsWith("#") || line.startsWith("<!--") || line.startsWith("@")) continue;
|
|
1231
|
-
const fact = line.replace(/^(?:[-*+]\s+|\d+[.)]\s+)/, "").trim();
|
|
1232
|
-
if (fact.length >= 3 && fact.length <= 1e3) lines.push(fact);
|
|
1233
|
-
}
|
|
1234
|
-
return lines;
|
|
1235
|
-
}
|
|
1236
|
-
/**
|
|
1237
|
-
* What the harness added during the turn, outside the generated block: new
|
|
1238
|
-
* lines in files that existed, and the body of new files (a Claude Code memory
|
|
1239
|
-
* directory entry). Lines removed or present before are ignored; a removal is
|
|
1240
|
-
* not a forget, which only `memory.forget` performs.
|
|
1241
|
-
*/
|
|
1242
|
-
function captureHarnessMemory(before, after) {
|
|
1243
|
-
const seen = /* @__PURE__ */ new Set();
|
|
1244
|
-
const facts = [];
|
|
1245
|
-
for (const [path, next] of Object.entries(after)) {
|
|
1246
|
-
if (next === void 0) continue;
|
|
1247
|
-
const old = new Set(memoryLines(outside(before[path] ?? "")).map(normalizeMemoryText));
|
|
1248
|
-
for (const fact of memoryLines(outside(next))) {
|
|
1249
|
-
const key = normalizeMemoryText(fact);
|
|
1250
|
-
if (!key || old.has(key) || seen.has(key)) continue;
|
|
1251
|
-
seen.add(key);
|
|
1252
|
-
facts.push(fact);
|
|
1253
|
-
}
|
|
1254
|
-
}
|
|
1255
|
-
return facts;
|
|
1256
|
-
}
|
|
1257
|
-
function outside(native) {
|
|
1258
|
-
const { before, after, found } = splitGenerated(native);
|
|
1259
|
-
return found ? `${before}\n${after}` : native;
|
|
1260
|
-
}
|
|
1261
|
-
const ACTOR = /^harness:([a-z0-9][a-z0-9._-]{0,40})\/turn:([^/\s]{1,128})\/member:([^/\s]{1,128})$/;
|
|
1262
|
-
/** The entry `actor` for a captured memory, so `createdBy` carries its provenance. */
|
|
1263
|
-
function harnessActor({ harness, turnId, memberId }) {
|
|
1264
|
-
const actor = `harness:${harness}/turn:${turnId}/member:${memberId}`;
|
|
1265
|
-
if (!ACTOR.test(actor)) throw new TypeError(`invalid harness provenance: ${actor}`);
|
|
1266
|
-
return actor;
|
|
1267
|
-
}
|
|
1268
|
-
/** Read the harness, turn, and member provenance encoded by `harnessActor`. */
|
|
1269
|
-
function parseHarnessActor(actor) {
|
|
1270
|
-
const match = ACTOR.exec(actor);
|
|
1271
|
-
return match ? {
|
|
1272
|
-
harness: match[1],
|
|
1273
|
-
turnId: match[2],
|
|
1274
|
-
memberId: match[3]
|
|
1275
|
-
} : null;
|
|
1276
|
-
}
|
|
1277
|
-
/**
|
|
1278
|
-
* Save captured facts as workspace memories through the same policy as
|
|
1279
|
-
* `memory.remember`, with the harness and turn as the actor. Duplicates of a
|
|
1280
|
-
* memory the turn can see, or of an earlier fact in the batch, are skipped.
|
|
1281
|
-
*/
|
|
1282
|
-
async function ingestHarnessMemories(context, input) {
|
|
1283
|
-
const turn = await context.activeTurn();
|
|
1284
|
-
const actor = harnessActor({
|
|
1285
|
-
harness: input.harness,
|
|
1286
|
-
turnId: input.turnId,
|
|
1287
|
-
memberId: turn.memberId
|
|
1288
|
-
});
|
|
1289
|
-
const newId = context.newId ?? (() => crypto.randomUUID());
|
|
1290
|
-
const known = new Set((await readTurnMemories(context.store, turn)).map((entry) => normalizeMemoryText(entry.content ?? "")));
|
|
1291
|
-
const saved = [];
|
|
1292
|
-
const duplicates = [];
|
|
1293
|
-
const refused = [];
|
|
1294
|
-
for (const raw of input.facts) {
|
|
1295
|
-
const text = raw.replace(/\s+/g, " ").trim();
|
|
1296
|
-
const key = normalizeMemoryText(text);
|
|
1297
|
-
if (!key) continue;
|
|
1298
|
-
if (known.has(key)) {
|
|
1299
|
-
duplicates.push(text);
|
|
1300
|
-
continue;
|
|
1301
|
-
}
|
|
1302
|
-
const id = newId();
|
|
1303
|
-
const path = `/memories/workspace/${id}`;
|
|
1304
|
-
try {
|
|
1305
|
-
await guard(context, turn, {
|
|
1306
|
-
op: "write",
|
|
1307
|
-
path,
|
|
1308
|
-
kind: "fact"
|
|
1309
|
-
}, text);
|
|
1310
|
-
} catch (error) {
|
|
1311
|
-
refused.push({
|
|
1312
|
-
text,
|
|
1313
|
-
reason: error instanceof Error ? error.message : String(error)
|
|
1314
|
-
});
|
|
1315
|
-
continue;
|
|
1316
|
-
}
|
|
1317
|
-
known.add(key);
|
|
1318
|
-
saved.push(await context.store.put({
|
|
1319
|
-
workspaceId: turn.workspaceId,
|
|
1320
|
-
path,
|
|
1321
|
-
kind: "fact",
|
|
1322
|
-
ifRevision: null,
|
|
1323
|
-
actor,
|
|
1324
|
-
content: text,
|
|
1325
|
-
id
|
|
1326
|
-
}));
|
|
1327
|
-
}
|
|
1328
|
-
return {
|
|
1329
|
-
saved,
|
|
1330
|
-
duplicates,
|
|
1331
|
-
refused
|
|
1332
|
-
};
|
|
1333
|
-
}
|
|
1334
|
-
/**
|
|
1335
|
-
* Compare each native file with the store as `turn` sees it, after ingest ran.
|
|
1336
|
-
* `before` is the files as projected at session start, `after` as they are now:
|
|
1337
|
-
* only what the harness added since then can be uncaptured, so the profile's own
|
|
1338
|
-
* generated text in the same file never counts. Files that held a generated
|
|
1339
|
-
* block at session start are projection targets: losing the block counts every
|
|
1340
|
-
* visible memory as missing. Other files (a new memory-directory entry) can
|
|
1341
|
-
* only hold uncaptured facts.
|
|
1342
|
-
*/
|
|
1343
|
-
async function memoryDivergence(store, turn, before, after) {
|
|
1344
|
-
const entries = (await readTurnMemories(store, turn)).filter((entry) => entry.content !== void 0);
|
|
1345
|
-
const byId = new Map(entries.map((entry) => [entry.id, entry.content.replace(/\s+/g, " ").trim()]));
|
|
1346
|
-
const stored = new Set(entries.map((entry) => normalizeMemoryText(entry.content)));
|
|
1347
|
-
const files = {};
|
|
1348
|
-
let missing = 0;
|
|
1349
|
-
let stale = 0;
|
|
1350
|
-
let uncaptured = 0;
|
|
1351
|
-
for (const [path, native] of Object.entries(after)) {
|
|
1352
|
-
if (native === void 0) continue;
|
|
1353
|
-
const target = splitGenerated(before[path] ?? "").found || splitGenerated(native).found;
|
|
1354
|
-
const listed = projectedIds(splitGenerated(native).block);
|
|
1355
|
-
const report = {
|
|
1356
|
-
missing: target ? [...byId.keys()].filter((id) => !listed.has(id)) : [],
|
|
1357
|
-
stale: [...listed].filter(([id, text]) => byId.get(id) !== text).map(([id]) => id),
|
|
1358
|
-
uncaptured: captureHarnessMemory({ [path]: before[path] }, { [path]: native }).filter((fact) => !stored.has(normalizeMemoryText(fact)))
|
|
1359
|
-
};
|
|
1360
|
-
missing += report.missing.length;
|
|
1361
|
-
stale += report.stale.length;
|
|
1362
|
-
uncaptured += report.uncaptured.length;
|
|
1363
|
-
files[path] = report;
|
|
1364
|
-
}
|
|
1365
|
-
return {
|
|
1366
|
-
total: missing + stale + uncaptured,
|
|
1367
|
-
missing,
|
|
1368
|
-
stale,
|
|
1369
|
-
uncaptured,
|
|
1370
|
-
files
|
|
1371
|
-
};
|
|
1372
|
-
}
|
|
1373
|
-
//#endregion
|
|
1374
|
-
export { HARNESS_MEMORY_BEGIN, SEALED_CONTENT_PREFIX, WorkspaceCodecError, WorkspaceConflictError, aesGcmContentCodecFromEnv, assertWorkspacePath, captureHarnessMemory, checkWorkspacePut, createAesGcmContentCodec, createFileTools, createInMemoryWorkspaceStore, createMemoryTools, defaultMemoryPolicy, ingestHarnessMemories, memoryDivergence, openWorkspaceBytes, parseHarnessActor, projectHarnessMemory, readTurnMemories, renderHarnessMemory, renderPinnedMemory, runWorkspaceStoreContract, sealWorkspaceBytes, withContentCodec, workspaceStoreContractCases };
|
|
960
|
+
export { WorkspaceConflictError, assertWorkspacePath, checkWorkspacePut, createFileTools, createInMemoryWorkspaceStore, createMemoryTools, defaultMemoryPolicy, readTurnMemories, renderPinnedMemory, runWorkspaceStoreContract, workspaceStoreContractCases };
|
|
1375
961
|
|
|
1376
962
|
//# sourceMappingURL=index.js.map
|