@zhachory1/mewrite-ai 0.65.3

package/dist/api-registry.d.ts

@@ -0,0 +1,20 @@
+import type { Api, AssistantMessageEventStream, Context, Model, SimpleStreamOptions, StreamFunction, StreamOptions } from "./types.js";
+export type ApiStreamFunction = (model: Model<Api>, context: Context, options?: StreamOptions) => AssistantMessageEventStream;
+export type ApiStreamSimpleFunction = (model: Model<Api>, context: Context, options?: SimpleStreamOptions) => AssistantMessageEventStream;
+export interface ApiProvider<TApi extends Api = Api, TOptions extends StreamOptions = StreamOptions> {
+    api: TApi;
+    stream: StreamFunction<TApi, TOptions>;
+    streamSimple: StreamFunction<TApi, SimpleStreamOptions>;
+}
+interface ApiProviderInternal {
+    api: Api;
+    stream: ApiStreamFunction;
+    streamSimple: ApiStreamSimpleFunction;
+}
+export declare function registerApiProvider<TApi extends Api, TOptions extends StreamOptions>(provider: ApiProvider<TApi, TOptions>, sourceId?: string): void;
+export declare function getApiProvider(api: Api): ApiProviderInternal | undefined;
+export declare function getApiProviders(): ApiProviderInternal[];
+export declare function unregisterApiProviders(sourceId: string): void;
+export declare function clearApiProviders(): void;
+export {};
+//# sourceMappingURL=api-registry.d.ts.map

package/dist/api-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-registry.d.ts","sourceRoot":"","sources":["../src/api-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,GAAG,EACH,2BAA2B,EAC3B,OAAO,EACP,KAAK,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,iBAAiB,GAAG,CAC/B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,aAAa,KACnB,2BAA2B,CAAC;AAEjC,MAAM,MAAM,uBAAuB,GAAG,CACrC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,KACzB,2BAA2B,CAAC;AAEjC,MAAM,WAAW,WAAW,CAAC,IAAI,SAAS,GAAG,GAAG,GAAG,EAAE,QAAQ,SAAS,aAAa,GAAG,aAAa;IAClG,GAAG,EAAE,IAAI,CAAC;IACV,MAAM,EAAE,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACvC,YAAY,EAAE,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;CACxD;AAED,UAAU,mBAAmB;IAC5B,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,uBAAuB,CAAC;CACtC;AAiCD,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,GAAG,EAAE,QAAQ,SAAS,aAAa,EACnF,QAAQ,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,GACf,IAAI,CASN;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,mBAAmB,GAAG,SAAS,CAExE;AAED,wBAAgB,eAAe,IAAI,mBAAmB,EAAE,CAEvD;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM7D;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC","sourcesContent":["import type {\n\tApi,\n\tAssistantMessageEventStream,\n\tContext,\n\tModel,\n\tSimpleStreamOptions,\n\tStreamFunction,\n\tStreamOptions,\n} from \"./types.js\";\n\nexport type ApiStreamFunction = (\n\tmodel: Model<Api>,\n\tcontext: Context,\n\toptions?: StreamOptions,\n) => AssistantMessageEventStream;\n\nexport type ApiStreamSimpleFunction = (\n\tmodel: Model<Api>,\n\tcontext: Context,\n\toptions?: SimpleStreamOptions,\n) => AssistantMessageEventStream;\n\nexport interface ApiProvider<TApi extends Api = Api, TOptions extends StreamOptions = StreamOptions> {\n\tapi: TApi;\n\tstream: StreamFunction<TApi, TOptions>;\n\tstreamSimple: StreamFunction<TApi, SimpleStreamOptions>;\n}\n\ninterface ApiProviderInternal {\n\tapi: Api;\n\tstream: ApiStreamFunction;\n\tstreamSimple: ApiStreamSimpleFunction;\n}\n\ntype RegisteredApiProvider = {\n\tprovider: ApiProviderInternal;\n\tsourceId?: string;\n};\n\nconst apiProviderRegistry = new Map<string, RegisteredApiProvider>();\n\nfunction wrapStream<TApi extends Api, TOptions extends StreamOptions>(\n\tapi: TApi,\n\tstream: StreamFunction<TApi, TOptions>,\n): ApiStreamFunction {\n\treturn (model, context, options) => {\n\t\tif (model.api !== api) {\n\t\t\tthrow new Error(`Mismatched api: ${model.api} expected ${api}`);\n\t\t}\n\t\treturn stream(model as Model<TApi>, context, options as TOptions);\n\t};\n}\n\nfunction wrapStreamSimple<TApi extends Api>(\n\tapi: TApi,\n\tstreamSimple: StreamFunction<TApi, SimpleStreamOptions>,\n): ApiStreamSimpleFunction {\n\treturn (model, context, options) => {\n\t\tif (model.api !== api) {\n\t\t\tthrow new Error(`Mismatched api: ${model.api} expected ${api}`);\n\t\t}\n\t\treturn streamSimple(model as Model<TApi>, context, options);\n\t};\n}\n\nexport function registerApiProvider<TApi extends Api, TOptions extends StreamOptions>(\n\tprovider: ApiProvider<TApi, TOptions>,\n\tsourceId?: string,\n): void {\n\tapiProviderRegistry.set(provider.api, {\n\t\tprovider: {\n\t\t\tapi: provider.api,\n\t\t\tstream: wrapStream(provider.api, provider.stream),\n\t\t\tstreamSimple: wrapStreamSimple(provider.api, provider.streamSimple),\n\t\t},\n\t\tsourceId,\n\t});\n}\n\nexport function getApiProvider(api: Api): ApiProviderInternal | undefined {\n\treturn apiProviderRegistry.get(api)?.provider;\n}\n\nexport function getApiProviders(): ApiProviderInternal[] {\n\treturn Array.from(apiProviderRegistry.values(), (entry) => entry.provider);\n}\n\nexport function unregisterApiProviders(sourceId: string): void {\n\tfor (const [api, entry] of apiProviderRegistry.entries()) {\n\t\tif (entry.sourceId === sourceId) {\n\t\t\tapiProviderRegistry.delete(api);\n\t\t}\n\t}\n}\n\nexport function clearApiProviders(): void {\n\tapiProviderRegistry.clear();\n}\n"]}

package/dist/api-registry.js

@@ -0,0 +1,44 @@
+const apiProviderRegistry = new Map();
+function wrapStream(api, stream) {
+    return (model, context, options) => {
+        if (model.api !== api) {
+            throw new Error(`Mismatched api: ${model.api} expected ${api}`);
+        }
+        return stream(model, context, options);
+    };
+}
+function wrapStreamSimple(api, streamSimple) {
+    return (model, context, options) => {
+        if (model.api !== api) {
+            throw new Error(`Mismatched api: ${model.api} expected ${api}`);
+        }
+        return streamSimple(model, context, options);
+    };
+}
+export function registerApiProvider(provider, sourceId) {
+    apiProviderRegistry.set(provider.api, {
+        provider: {
+            api: provider.api,
+            stream: wrapStream(provider.api, provider.stream),
+            streamSimple: wrapStreamSimple(provider.api, provider.streamSimple),
+        },
+        sourceId,
+    });
+}
+export function getApiProvider(api) {
+    return apiProviderRegistry.get(api)?.provider;
+}
+export function getApiProviders() {
+    return Array.from(apiProviderRegistry.values(), (entry) => entry.provider);
+}
+export function unregisterApiProviders(sourceId) {
+    for (const [api, entry] of apiProviderRegistry.entries()) {
+        if (entry.sourceId === sourceId) {
+            apiProviderRegistry.delete(api);
+        }
+    }
+}
+export function clearApiProviders() {
+    apiProviderRegistry.clear();
+}
+//# sourceMappingURL=api-registry.js.map

package/dist/api-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-registry.js","sourceRoot":"","sources":["../src/api-registry.ts"],"names":[],"mappings":"AAuCA,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAiC,CAAC;AAErE,SAAS,UAAU,CAClB,GAAS,EACT,MAAsC,EAClB;IACpB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,GAAG,aAAa,GAAG,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,MAAM,CAAC,KAAoB,EAAE,OAAO,EAAE,OAAmB,CAAC,CAAC;IAAA,CAClE,CAAC;AAAA,CACF;AAED,SAAS,gBAAgB,CACxB,GAAS,EACT,YAAuD,EAC7B;IAC1B,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,GAAG,aAAa,GAAG,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,YAAY,CAAC,KAAoB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAAA,CAC5D,CAAC;AAAA,CACF;AAED,MAAM,UAAU,mBAAmB,CAClC,QAAqC,EACrC,QAAiB,EACV;IACP,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE;QACrC,QAAQ,EAAE;YACT,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC;YACjD,YAAY,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,YAAY,CAAC;SACnE;QACD,QAAQ;KACR,CAAC,CAAC;AAAA,CACH;AAED,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAmC;IACzE,OAAO,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;AAAA,CAC9C;AAED,MAAM,UAAU,eAAe,GAA0B;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAAA,CAC3E;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAQ;IAC9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACF,CAAC;AAAA,CACD;AAED,MAAM,UAAU,iBAAiB,GAAS;IACzC,mBAAmB,CAAC,KAAK,EAAE,CAAC;AAAA,CAC5B","sourcesContent":["import type {\n\tApi,\n\tAssistantMessageEventStream,\n\tContext,\n\tModel,\n\tSimpleStreamOptions,\n\tStreamFunction,\n\tStreamOptions,\n} from \"./types.js\";\n\nexport type ApiStreamFunction = (\n\tmodel: Model<Api>,\n\tcontext: Context,\n\toptions?: StreamOptions,\n) => AssistantMessageEventStream;\n\nexport type ApiStreamSimpleFunction = (\n\tmodel: Model<Api>,\n\tcontext: Context,\n\toptions?: SimpleStreamOptions,\n) => AssistantMessageEventStream;\n\nexport interface ApiProvider<TApi extends Api = Api, TOptions extends StreamOptions = StreamOptions> {\n\tapi: TApi;\n\tstream: StreamFunction<TApi, TOptions>;\n\tstreamSimple: StreamFunction<TApi, SimpleStreamOptions>;\n}\n\ninterface ApiProviderInternal {\n\tapi: Api;\n\tstream: ApiStreamFunction;\n\tstreamSimple: ApiStreamSimpleFunction;\n}\n\ntype RegisteredApiProvider = {\n\tprovider: ApiProviderInternal;\n\tsourceId?: string;\n};\n\nconst apiProviderRegistry = new Map<string, RegisteredApiProvider>();\n\nfunction wrapStream<TApi extends Api, TOptions extends StreamOptions>(\n\tapi: TApi,\n\tstream: StreamFunction<TApi, TOptions>,\n): ApiStreamFunction {\n\treturn (model, context, options) => {\n\t\tif (model.api !== api) {\n\t\t\tthrow new Error(`Mismatched api: ${model.api} expected ${api}`);\n\t\t}\n\t\treturn stream(model as Model<TApi>, context, options as TOptions);\n\t};\n}\n\nfunction wrapStreamSimple<TApi extends Api>(\n\tapi: TApi,\n\tstreamSimple: StreamFunction<TApi, SimpleStreamOptions>,\n): ApiStreamSimpleFunction {\n\treturn (model, context, options) => {\n\t\tif (model.api !== api) {\n\t\t\tthrow new Error(`Mismatched api: ${model.api} expected ${api}`);\n\t\t}\n\t\treturn streamSimple(model as Model<TApi>, context, options);\n\t};\n}\n\nexport function registerApiProvider<TApi extends Api, TOptions extends StreamOptions>(\n\tprovider: ApiProvider<TApi, TOptions>,\n\tsourceId?: string,\n): void {\n\tapiProviderRegistry.set(provider.api, {\n\t\tprovider: {\n\t\t\tapi: provider.api,\n\t\t\tstream: wrapStream(provider.api, provider.stream),\n\t\t\tstreamSimple: wrapStreamSimple(provider.api, provider.streamSimple),\n\t\t},\n\t\tsourceId,\n\t});\n}\n\nexport function getApiProvider(api: Api): ApiProviderInternal | undefined {\n\treturn apiProviderRegistry.get(api)?.provider;\n}\n\nexport function getApiProviders(): ApiProviderInternal[] {\n\treturn Array.from(apiProviderRegistry.values(), (entry) => entry.provider);\n}\n\nexport function unregisterApiProviders(sourceId: string): void {\n\tfor (const [api, entry] of apiProviderRegistry.entries()) {\n\t\tif (entry.sourceId === sourceId) {\n\t\t\tapiProviderRegistry.delete(api);\n\t\t}\n\t}\n}\n\nexport function clearApiProviders(): void {\n\tapiProviderRegistry.clear();\n}\n"]}

package/dist/bedrock-provider.d.ts

@@ -0,0 +1,5 @@
+export declare const bedrockProviderModule: {
+    streamBedrock: import("./types.js").StreamFunction<"bedrock-converse-stream", import("./providers/amazon-bedrock.js").BedrockOptions>;
+    streamSimpleBedrock: import("./types.js").StreamFunction<"bedrock-converse-stream", import("./types.js").SimpleStreamOptions>;
+};
+//# sourceMappingURL=bedrock-provider.d.ts.map

package/dist/bedrock-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock-provider.d.ts","sourceRoot":"","sources":["../src/bedrock-provider.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB;;;CAGjC,CAAC","sourcesContent":["import { streamBedrock, streamSimpleBedrock } from \"./providers/amazon-bedrock.js\";\n\nexport const bedrockProviderModule = {\n\tstreamBedrock,\n\tstreamSimpleBedrock,\n};\n"]}

package/dist/bedrock-provider.js

@@ -0,0 +1,6 @@
+import { streamBedrock, streamSimpleBedrock } from "./providers/amazon-bedrock.js";
+export const bedrockProviderModule = {
+    streamBedrock,
+    streamSimpleBedrock,
+};
+//# sourceMappingURL=bedrock-provider.js.map

package/dist/bedrock-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock-provider.js","sourceRoot":"","sources":["../src/bedrock-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEnF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,aAAa;IACb,mBAAmB;CACnB,CAAC","sourcesContent":["import { streamBedrock, streamSimpleBedrock } from \"./providers/amazon-bedrock.js\";\n\nexport const bedrockProviderModule = {\n\tstreamBedrock,\n\tstreamSimpleBedrock,\n};\n"]}

package/dist/cache/__tests__/compaction.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compaction.test.d.ts.map

package/dist/cache/__tests__/compaction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.test.d.ts","sourceRoot":"","sources":["../../../src/cache/__tests__/compaction.test.ts"],"names":[],"mappings":"","sourcesContent":["// T-044..T-054\nimport { describe, expect, it } from \"vitest\";\nimport { KeepaliveScheduler, summarize, type Turn, trimMiddle } from \"../compaction.js\";\nimport { type CacheUsageReport, resolveRetention, totalInputTokens } from \"../policy.js\";\n\ndescribe(\"cache usage report (T-044, T-046)\", () => {\n\tit(\"exposes three token fields\", () => {\n\t\tconst u: CacheUsageReport = {\n\t\t\tcachedInputTokens: 100,\n\t\t\tcacheWriteTokens: 10,\n\t\t\tuncachedInputTokens: 50,\n\t\t};\n\t\texpect(u.cachedInputTokens).toBeDefined();\n\t\texpect(u.cacheWriteTokens).toBeDefined();\n\t\texpect(u.uncachedInputTokens).toBeDefined();\n\t});\n\n\tit(\"cached + uncached equals total input\", () => {\n\t\tconst u: CacheUsageReport = {\n\t\t\tcachedInputTokens: 300,\n\t\t\tcacheWriteTokens: 25,\n\t\t\tuncachedInputTokens: 200,\n\t\t};\n\t\texpect(totalInputTokens(u)).toBe(500);\n\t});\n});\n\ndescribe(\"resolveRetention (T-047, T-048, T-049)\", () => {\n\tit(\"defaults to role default when no override\", () => {\n\t\texpect(resolveRetention({ roleDefault: \"long\" })).toBe(\"long\");\n\t});\n\n\tit(\"CLI flag overrides role default\", () => {\n\t\texpect(resolveRetention({ roleDefault: \"long\", cliFlag: \"none\" })).toBe(\"none\");\n\t});\n});\n\ndescribe(\"trimMiddle (T-050, T-051, T-052)\", () => {\n\tfunction mkTurns(n: number): Turn[] {\n\t\treturn Array.from({ length: n }, (_, i) => ({\n\t\t\tindex: i,\n\t\t\tbytes: `turn-${i}`,\n\t\t}));\n\t}\n\n\tit(\"drops 1..24, preserves 25..30 with N=5 recent floor (30-turn history)\", () => {\n\t\tconst turns = mkTurns(30);\n\t\tconst result = trimMiddle(turns, { recentFloor: 5 });\n\t\texpect(result.kept.length).toBe(6); // summary + 5 recent\n\t\t// Last 5 kept\n\t\tconst recent = result.kept.slice(1);\n\t\texpect(recent.map((t) => t.index)).toEqual([25, 26, 27, 28, 29]);\n\t\t// Dropped 25 turns\n\t\texpect(result.droppedCount).toBe(25);\n\t});\n\n\tit(\"produces deterministic stable summary block\", () => {\n\t\tconst turns = mkTurns(20);\n\t\tconst a = trimMiddle(turns, { recentFloor: 5 }).summary;\n\t\tconst b = trimMiddle(turns, { recentFloor: 5 }).summary;\n\t\texpect(a.bytes).toBe(b.bytes);\n\t\texpect(a.bytes).toContain(\"compact\");\n\t});\n\n\tit(\"no-op when turns ≤ recentFloor + 1\", () => {\n\t\tconst turns = mkTurns(3);\n\t\tconst result = trimMiddle(turns, { recentFloor: 5 });\n\t\texpect(result.droppedCount).toBe(0);\n\t\texpect(result.kept).toEqual(turns);\n\t});\n\n\tit(\"summarize includes dropped indices for auditability\", () => {\n\t\tconst s = summarize([\n\t\t\t{ index: 1, bytes: \"a\" },\n\t\t\t{ index: 2, bytes: \"bb\" },\n\t\t]);\n\t\texpect(s).toContain(\"[1,2]\");\n\t\texpect(s).toContain(\"3 bytes\");\n\t});\n});\n\ndescribe(\"KeepaliveScheduler (T-053, T-054)\", () => {\n\tit(\"returns skip when retention=none\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\texpect(k.tick(10_000, { intervalMs: 5_000, retention: \"none\", enabled: true })).toBe(\"skip\");\n\t});\n\n\tit(\"returns skip when disabled\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\texpect(k.tick(10_000, { intervalMs: 5_000, retention: \"long\", enabled: false })).toBe(\"skip\");\n\t});\n\n\tit(\"returns ping after interval elapsed with retention=long\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\texpect(k.tick(5_000, { intervalMs: 5_000, retention: \"long\", enabled: true })).toBe(\"ping\");\n\t});\n\n\tit(\"shuts off after idle 2x interval\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\texpect(k.tick(11_000, { intervalMs: 5_000, retention: \"long\", enabled: true })).toBe(\"shutoff\");\n\t});\n\n\tit(\"default off: enabled=false skips even when interval passed\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\tconst r = k.tick(10_000, { intervalMs: 5_000, retention: \"long\", enabled: false });\n\t\texpect(r).toBe(\"skip\");\n\t});\n});\n"]}

package/dist/cache/__tests__/compaction.test.js

@@ -0,0 +1,100 @@
+// T-044..T-054
+import { describe, expect, it } from "vitest";
+import { KeepaliveScheduler, summarize, trimMiddle } from "../compaction.js";
+import { resolveRetention, totalInputTokens } from "../policy.js";
+describe("cache usage report (T-044, T-046)", () => {
+    it("exposes three token fields", () => {
+        const u = {
+            cachedInputTokens: 100,
+            cacheWriteTokens: 10,
+            uncachedInputTokens: 50,
+        };
+        expect(u.cachedInputTokens).toBeDefined();
+        expect(u.cacheWriteTokens).toBeDefined();
+        expect(u.uncachedInputTokens).toBeDefined();
+    });
+    it("cached + uncached equals total input", () => {
+        const u = {
+            cachedInputTokens: 300,
+            cacheWriteTokens: 25,
+            uncachedInputTokens: 200,
+        };
+        expect(totalInputTokens(u)).toBe(500);
+    });
+});
+describe("resolveRetention (T-047, T-048, T-049)", () => {
+    it("defaults to role default when no override", () => {
+        expect(resolveRetention({ roleDefault: "long" })).toBe("long");
+    });
+    it("CLI flag overrides role default", () => {
+        expect(resolveRetention({ roleDefault: "long", cliFlag: "none" })).toBe("none");
+    });
+});
+describe("trimMiddle (T-050, T-051, T-052)", () => {
+    function mkTurns(n) {
+        return Array.from({ length: n }, (_, i) => ({
+            index: i,
+            bytes: `turn-${i}`,
+        }));
+    }
+    it("drops 1..24, preserves 25..30 with N=5 recent floor (30-turn history)", () => {
+        const turns = mkTurns(30);
+        const result = trimMiddle(turns, { recentFloor: 5 });
+        expect(result.kept.length).toBe(6); // summary + 5 recent
+        // Last 5 kept
+        const recent = result.kept.slice(1);
+        expect(recent.map((t) => t.index)).toEqual([25, 26, 27, 28, 29]);
+        // Dropped 25 turns
+        expect(result.droppedCount).toBe(25);
+    });
+    it("produces deterministic stable summary block", () => {
+        const turns = mkTurns(20);
+        const a = trimMiddle(turns, { recentFloor: 5 }).summary;
+        const b = trimMiddle(turns, { recentFloor: 5 }).summary;
+        expect(a.bytes).toBe(b.bytes);
+        expect(a.bytes).toContain("compact");
+    });
+    it("no-op when turns ≤ recentFloor + 1", () => {
+        const turns = mkTurns(3);
+        const result = trimMiddle(turns, { recentFloor: 5 });
+        expect(result.droppedCount).toBe(0);
+        expect(result.kept).toEqual(turns);
+    });
+    it("summarize includes dropped indices for auditability", () => {
+        const s = summarize([
+            { index: 1, bytes: "a" },
+            { index: 2, bytes: "bb" },
+        ]);
+        expect(s).toContain("[1,2]");
+        expect(s).toContain("3 bytes");
+    });
+});
+describe("KeepaliveScheduler (T-053, T-054)", () => {
+    it("returns skip when retention=none", () => {
+        const k = new KeepaliveScheduler();
+        k.markActivity(0);
+        expect(k.tick(10_000, { intervalMs: 5_000, retention: "none", enabled: true })).toBe("skip");
+    });
+    it("returns skip when disabled", () => {
+        const k = new KeepaliveScheduler();
+        k.markActivity(0);
+        expect(k.tick(10_000, { intervalMs: 5_000, retention: "long", enabled: false })).toBe("skip");
+    });
+    it("returns ping after interval elapsed with retention=long", () => {
+        const k = new KeepaliveScheduler();
+        k.markActivity(0);
+        expect(k.tick(5_000, { intervalMs: 5_000, retention: "long", enabled: true })).toBe("ping");
+    });
+    it("shuts off after idle 2x interval", () => {
+        const k = new KeepaliveScheduler();
+        k.markActivity(0);
+        expect(k.tick(11_000, { intervalMs: 5_000, retention: "long", enabled: true })).toBe("shutoff");
+    });
+    it("default off: enabled=false skips even when interval passed", () => {
+        const k = new KeepaliveScheduler();
+        k.markActivity(0);
+        const r = k.tick(10_000, { intervalMs: 5_000, retention: "long", enabled: false });
+        expect(r).toBe("skip");
+    });
+});
+//# sourceMappingURL=compaction.test.js.map

package/dist/cache/__tests__/compaction.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.test.js","sourceRoot":"","sources":["../../../src/cache/__tests__/compaction.test.ts"],"names":[],"mappings":"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","sourcesContent":["// T-044..T-054\nimport { describe, expect, it } from \"vitest\";\nimport { KeepaliveScheduler, summarize, type Turn, trimMiddle } from \"../compaction.js\";\nimport { type CacheUsageReport, resolveRetention, totalInputTokens } from \"../policy.js\";\n\ndescribe(\"cache usage report (T-044, T-046)\", () => {\n\tit(\"exposes three token fields\", () => {\n\t\tconst u: CacheUsageReport = {\n\t\t\tcachedInputTokens: 100,\n\t\t\tcacheWriteTokens: 10,\n\t\t\tuncachedInputTokens: 50,\n\t\t};\n\t\texpect(u.cachedInputTokens).toBeDefined();\n\t\texpect(u.cacheWriteTokens).toBeDefined();\n\t\texpect(u.uncachedInputTokens).toBeDefined();\n\t});\n\n\tit(\"cached + uncached equals total input\", () => {\n\t\tconst u: CacheUsageReport = {\n\t\t\tcachedInputTokens: 300,\n\t\t\tcacheWriteTokens: 25,\n\t\t\tuncachedInputTokens: 200,\n\t\t};\n\t\texpect(totalInputTokens(u)).toBe(500);\n\t});\n});\n\ndescribe(\"resolveRetention (T-047, T-048, T-049)\", () => {\n\tit(\"defaults to role default when no override\", () => {\n\t\texpect(resolveRetention({ roleDefault: \"long\" })).toBe(\"long\");\n\t});\n\n\tit(\"CLI flag overrides role default\", () => {\n\t\texpect(resolveRetention({ roleDefault: \"long\", cliFlag: \"none\" })).toBe(\"none\");\n\t});\n});\n\ndescribe(\"trimMiddle (T-050, T-051, T-052)\", () => {\n\tfunction mkTurns(n: number): Turn[] {\n\t\treturn Array.from({ length: n }, (_, i) => ({\n\t\t\tindex: i,\n\t\t\tbytes: `turn-${i}`,\n\t\t}));\n\t}\n\n\tit(\"drops 1..24, preserves 25..30 with N=5 recent floor (30-turn history)\", () => {\n\t\tconst turns = mkTurns(30);\n\t\tconst result = trimMiddle(turns, { recentFloor: 5 });\n\t\texpect(result.kept.length).toBe(6); // summary + 5 recent\n\t\t// Last 5 kept\n\t\tconst recent = result.kept.slice(1);\n\t\texpect(recent.map((t) => t.index)).toEqual([25, 26, 27, 28, 29]);\n\t\t// Dropped 25 turns\n\t\texpect(result.droppedCount).toBe(25);\n\t});\n\n\tit(\"produces deterministic stable summary block\", () => {\n\t\tconst turns = mkTurns(20);\n\t\tconst a = trimMiddle(turns, { recentFloor: 5 }).summary;\n\t\tconst b = trimMiddle(turns, { recentFloor: 5 }).summary;\n\t\texpect(a.bytes).toBe(b.bytes);\n\t\texpect(a.bytes).toContain(\"compact\");\n\t});\n\n\tit(\"no-op when turns ≤ recentFloor + 1\", () => {\n\t\tconst turns = mkTurns(3);\n\t\tconst result = trimMiddle(turns, { recentFloor: 5 });\n\t\texpect(result.droppedCount).toBe(0);\n\t\texpect(result.kept).toEqual(turns);\n\t});\n\n\tit(\"summarize includes dropped indices for auditability\", () => {\n\t\tconst s = summarize([\n\t\t\t{ index: 1, bytes: \"a\" },\n\t\t\t{ index: 2, bytes: \"bb\" },\n\t\t]);\n\t\texpect(s).toContain(\"[1,2]\");\n\t\texpect(s).toContain(\"3 bytes\");\n\t});\n});\n\ndescribe(\"KeepaliveScheduler (T-053, T-054)\", () => {\n\tit(\"returns skip when retention=none\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\texpect(k.tick(10_000, { intervalMs: 5_000, retention: \"none\", enabled: true })).toBe(\"skip\");\n\t});\n\n\tit(\"returns skip when disabled\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\texpect(k.tick(10_000, { intervalMs: 5_000, retention: \"long\", enabled: false })).toBe(\"skip\");\n\t});\n\n\tit(\"returns ping after interval elapsed with retention=long\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\texpect(k.tick(5_000, { intervalMs: 5_000, retention: \"long\", enabled: true })).toBe(\"ping\");\n\t});\n\n\tit(\"shuts off after idle 2x interval\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\texpect(k.tick(11_000, { intervalMs: 5_000, retention: \"long\", enabled: true })).toBe(\"shutoff\");\n\t});\n\n\tit(\"default off: enabled=false skips even when interval passed\", () => {\n\t\tconst k = new KeepaliveScheduler();\n\t\tk.markActivity(0);\n\t\tconst r = k.tick(10_000, { intervalMs: 5_000, retention: \"long\", enabled: false });\n\t\texpect(r).toBe(\"skip\");\n\t});\n});\n"]}

package/dist/cache/__tests__/layers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=layers.test.d.ts.map

package/dist/cache/__tests__/layers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.test.d.ts","sourceRoot":"","sources":["../../../src/cache/__tests__/layers.test.ts"],"names":[],"mappings":"","sourcesContent":["// T-002, T-003\nimport { describe, expect, it } from \"vitest\";\nimport { assembleLayered, layerBytes, layerHash, layersInOrder } from \"../layers.js\";\nimport { validateLayers } from \"../policy.js\";\n\nconst tools = [{ name: \"a\", description: \"alpha\", parameters: {} }];\nconst baseInput = {\n\ttools,\n\tsystem: \"you are cave\",\n\tproject: \"CLAUDE.md contents\",\n\tmessages: [\"hi\"],\n\tpolicy: { retention: \"short\" as const, supportsBreakpoints: true },\n};\n\ndescribe(\"assembleLayered\", () => {\n\tit(\"emits layers in exact tools/system/project/messages order\", () => {\n\t\tconst p = assembleLayered(baseInput);\n\t\texpect(layersInOrder(p)).toEqual([\"tools\", \"system\", \"project\", \"messages\"]);\n\t});\n\n\tit(\"non-breakpoint provider accepts same 4-layer payload\", () => {\n\t\tconst p = assembleLayered({\n\t\t\t...baseInput,\n\t\t\tpolicy: { retention: \"short\", supportsBreakpoints: false },\n\t\t});\n\t\texpect(layersInOrder(p)).toEqual([\"tools\", \"system\", \"project\", \"messages\"]);\n\t\tfor (const layer of p.layers) {\n\t\t\texpect(layer.breakpoint).toBe(false);\n\t\t}\n\t});\n\n\tit(\"removing project context does not alter tools/system bytes\", () => {\n\t\tconst withProject = assembleLayered(baseInput);\n\t\tconst withoutProject = assembleLayered({ ...baseInput, project: undefined });\n\t\texpect(layerHash(withProject, \"tools\")).toBe(layerHash(withoutProject, \"tools\"));\n\t\texpect(layerHash(withProject, \"system\")).toBe(layerHash(withoutProject, \"system\"));\n\t\texpect(layersInOrder(withoutProject)).toEqual([\"tools\", \"system\", \"messages\"]);\n\t});\n\n\tit(\"rejects out-of-order layers\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"system\", bytes: \"\" },\n\t\t\t\t{ layer: \"tools\", bytes: \"\" },\n\t\t\t]),\n\t\t).toThrow(/out of canonical order/);\n\t});\n\n\tit(\"rejects duplicate layer\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"tools\", bytes: \"\" },\n\t\t\t\t{ layer: \"tools\", bytes: \"\" },\n\t\t\t]),\n\t\t).toThrow(/duplicate layer/);\n\t});\n\n\tit(\"enforces single breakpoint per layer\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"tools\", bytes: \"a\", breakpoint: true },\n\t\t\t\t{ layer: \"system\", bytes: \"b\", breakpoint: true },\n\t\t\t\t// Two blocks in the same layer not allowed at all, but validate\n\t\t\t\t// also catches the breakpoint-count path with a hand-crafted list:\n\t\t\t]),\n\t\t).not.toThrow();\n\t});\n\n\tit(\"editing a tool does not change system/project bytes\", () => {\n\t\tconst before = assembleLayered(baseInput);\n\t\tconst after = assembleLayered({\n\t\t\t...baseInput,\n\t\t\ttools: [{ name: \"a\", description: \"alpha edited\", parameters: {} }],\n\t\t});\n\t\texpect(layerHash(before, \"tools\")).not.toBe(layerHash(after, \"tools\"));\n\t\texpect(layerHash(before, \"system\")).toBe(layerHash(after, \"system\"));\n\t\texpect(layerHash(before, \"project\")).toBe(layerHash(after, \"project\"));\n\t});\n\n\tit(\"layer bytes are non-empty string for present layers\", () => {\n\t\tconst p = assembleLayered(baseInput);\n\t\texpect(layerBytes(p, \"tools\").length).toBeGreaterThan(0);\n\t\texpect(layerBytes(p, \"system\")).toBe(\"you are cave\");\n\t});\n});\n"]}

package/dist/cache/__tests__/layers.test.js

@@ -0,0 +1,71 @@
+// T-002, T-003
+import { describe, expect, it } from "vitest";
+import { assembleLayered, layerBytes, layerHash, layersInOrder } from "../layers.js";
+import { validateLayers } from "../policy.js";
+const tools = [{ name: "a", description: "alpha", parameters: {} }];
+const baseInput = {
+    tools,
+    system: "you are cave",
+    project: "CLAUDE.md contents",
+    messages: ["hi"],
+    policy: { retention: "short", supportsBreakpoints: true },
+};
+describe("assembleLayered", () => {
+    it("emits layers in exact tools/system/project/messages order", () => {
+        const p = assembleLayered(baseInput);
+        expect(layersInOrder(p)).toEqual(["tools", "system", "project", "messages"]);
+    });
+    it("non-breakpoint provider accepts same 4-layer payload", () => {
+        const p = assembleLayered({
+            ...baseInput,
+            policy: { retention: "short", supportsBreakpoints: false },
+        });
+        expect(layersInOrder(p)).toEqual(["tools", "system", "project", "messages"]);
+        for (const layer of p.layers) {
+            expect(layer.breakpoint).toBe(false);
+        }
+    });
+    it("removing project context does not alter tools/system bytes", () => {
+        const withProject = assembleLayered(baseInput);
+        const withoutProject = assembleLayered({ ...baseInput, project: undefined });
+        expect(layerHash(withProject, "tools")).toBe(layerHash(withoutProject, "tools"));
+        expect(layerHash(withProject, "system")).toBe(layerHash(withoutProject, "system"));
+        expect(layersInOrder(withoutProject)).toEqual(["tools", "system", "messages"]);
+    });
+    it("rejects out-of-order layers", () => {
+        expect(() => validateLayers([
+            { layer: "system", bytes: "" },
+            { layer: "tools", bytes: "" },
+        ])).toThrow(/out of canonical order/);
+    });
+    it("rejects duplicate layer", () => {
+        expect(() => validateLayers([
+            { layer: "tools", bytes: "" },
+            { layer: "tools", bytes: "" },
+        ])).toThrow(/duplicate layer/);
+    });
+    it("enforces single breakpoint per layer", () => {
+        expect(() => validateLayers([
+            { layer: "tools", bytes: "a", breakpoint: true },
+            { layer: "system", bytes: "b", breakpoint: true },
+            // Two blocks in the same layer not allowed at all, but validate
+            // also catches the breakpoint-count path with a hand-crafted list:
+        ])).not.toThrow();
+    });
+    it("editing a tool does not change system/project bytes", () => {
+        const before = assembleLayered(baseInput);
+        const after = assembleLayered({
+            ...baseInput,
+            tools: [{ name: "a", description: "alpha edited", parameters: {} }],
+        });
+        expect(layerHash(before, "tools")).not.toBe(layerHash(after, "tools"));
+        expect(layerHash(before, "system")).toBe(layerHash(after, "system"));
+        expect(layerHash(before, "project")).toBe(layerHash(after, "project"));
+    });
+    it("layer bytes are non-empty string for present layers", () => {
+        const p = assembleLayered(baseInput);
+        expect(layerBytes(p, "tools").length).toBeGreaterThan(0);
+        expect(layerBytes(p, "system")).toBe("you are cave");
+    });
+});
+//# sourceMappingURL=layers.test.js.map

package/dist/cache/__tests__/layers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.test.js","sourceRoot":"","sources":["../../../src/cache/__tests__/layers.test.ts"],"names":[],"mappings":"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","sourcesContent":["// T-002, T-003\nimport { describe, expect, it } from \"vitest\";\nimport { assembleLayered, layerBytes, layerHash, layersInOrder } from \"../layers.js\";\nimport { validateLayers } from \"../policy.js\";\n\nconst tools = [{ name: \"a\", description: \"alpha\", parameters: {} }];\nconst baseInput = {\n\ttools,\n\tsystem: \"you are cave\",\n\tproject: \"CLAUDE.md contents\",\n\tmessages: [\"hi\"],\n\tpolicy: { retention: \"short\" as const, supportsBreakpoints: true },\n};\n\ndescribe(\"assembleLayered\", () => {\n\tit(\"emits layers in exact tools/system/project/messages order\", () => {\n\t\tconst p = assembleLayered(baseInput);\n\t\texpect(layersInOrder(p)).toEqual([\"tools\", \"system\", \"project\", \"messages\"]);\n\t});\n\n\tit(\"non-breakpoint provider accepts same 4-layer payload\", () => {\n\t\tconst p = assembleLayered({\n\t\t\t...baseInput,\n\t\t\tpolicy: { retention: \"short\", supportsBreakpoints: false },\n\t\t});\n\t\texpect(layersInOrder(p)).toEqual([\"tools\", \"system\", \"project\", \"messages\"]);\n\t\tfor (const layer of p.layers) {\n\t\t\texpect(layer.breakpoint).toBe(false);\n\t\t}\n\t});\n\n\tit(\"removing project context does not alter tools/system bytes\", () => {\n\t\tconst withProject = assembleLayered(baseInput);\n\t\tconst withoutProject = assembleLayered({ ...baseInput, project: undefined });\n\t\texpect(layerHash(withProject, \"tools\")).toBe(layerHash(withoutProject, \"tools\"));\n\t\texpect(layerHash(withProject, \"system\")).toBe(layerHash(withoutProject, \"system\"));\n\t\texpect(layersInOrder(withoutProject)).toEqual([\"tools\", \"system\", \"messages\"]);\n\t});\n\n\tit(\"rejects out-of-order layers\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"system\", bytes: \"\" },\n\t\t\t\t{ layer: \"tools\", bytes: \"\" },\n\t\t\t]),\n\t\t).toThrow(/out of canonical order/);\n\t});\n\n\tit(\"rejects duplicate layer\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"tools\", bytes: \"\" },\n\t\t\t\t{ layer: \"tools\", bytes: \"\" },\n\t\t\t]),\n\t\t).toThrow(/duplicate layer/);\n\t});\n\n\tit(\"enforces single breakpoint per layer\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"tools\", bytes: \"a\", breakpoint: true },\n\t\t\t\t{ layer: \"system\", bytes: \"b\", breakpoint: true },\n\t\t\t\t// Two blocks in the same layer not allowed at all, but validate\n\t\t\t\t// also catches the breakpoint-count path with a hand-crafted list:\n\t\t\t]),\n\t\t).not.toThrow();\n\t});\n\n\tit(\"editing a tool does not change system/project bytes\", () => {\n\t\tconst before = assembleLayered(baseInput);\n\t\tconst after = assembleLayered({\n\t\t\t...baseInput,\n\t\t\ttools: [{ name: \"a\", description: \"alpha edited\", parameters: {} }],\n\t\t});\n\t\texpect(layerHash(before, \"tools\")).not.toBe(layerHash(after, \"tools\"));\n\t\texpect(layerHash(before, \"system\")).toBe(layerHash(after, \"system\"));\n\t\texpect(layerHash(before, \"project\")).toBe(layerHash(after, \"project\"));\n\t});\n\n\tit(\"layer bytes are non-empty string for present layers\", () => {\n\t\tconst p = assembleLayered(baseInput);\n\t\texpect(layerBytes(p, \"tools\").length).toBeGreaterThan(0);\n\t\texpect(layerBytes(p, \"system\")).toBe(\"you are cave\");\n\t});\n});\n"]}

package/dist/cache/__tests__/policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=policy.test.d.ts.map

package/dist/cache/__tests__/policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.test.d.ts","sourceRoot":"","sources":["../../../src/cache/__tests__/policy.test.ts"],"names":[],"mappings":"","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { defaultPolicy, resolveRetention, totalInputTokens, usageToCacheReport, validateLayers } from \"../policy.js\";\n\ndescribe(\"usageToCacheReport\", () => {\n\tit(\"converts Usage to CacheUsageReport\", () => {\n\t\tconst report = usageToCacheReport({\n\t\t\tinput: 500,\n\t\t\toutput: 200,\n\t\t\tcacheRead: 300,\n\t\t\tcacheWrite: 100,\n\t\t\ttotalTokens: 1100,\n\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t});\n\t\texpect(report.cachedInputTokens).toBe(300);\n\t\texpect(report.cacheWriteTokens).toBe(100);\n\t\texpect(report.uncachedInputTokens).toBe(500);\n\t\texpect(totalInputTokens(report)).toBe(800);\n\t});\n\n\tit(\"clamps negative input to zero\", () => {\n\t\tconst report = usageToCacheReport({\n\t\t\tinput: -10,\n\t\t\toutput: 50,\n\t\t\tcacheRead: 100,\n\t\t\tcacheWrite: 0,\n\t\t\ttotalTokens: 140,\n\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t});\n\t\texpect(report.uncachedInputTokens).toBe(0);\n\t});\n\n\tit(\"handles zero-cache usage (e.g. Mistral)\", () => {\n\t\tconst report = usageToCacheReport({\n\t\t\tinput: 1000,\n\t\t\toutput: 200,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t\ttotalTokens: 1200,\n\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t});\n\t\texpect(report.cachedInputTokens).toBe(0);\n\t\texpect(report.cacheWriteTokens).toBe(0);\n\t\texpect(report.uncachedInputTokens).toBe(1000);\n\t\texpect(totalInputTokens(report)).toBe(1000);\n\t});\n});\n\ndescribe(\"resolveRetention\", () => {\n\tit(\"returns cliFlag when present\", () => {\n\t\texpect(resolveRetention({ roleDefault: \"short\", cliFlag: \"long\" })).toBe(\"long\");\n\t});\n\n\tit(\"returns roleDefault as fallback\", () => {\n\t\texpect(resolveRetention({ roleDefault: \"long\" })).toBe(\"long\");\n\t});\n});\n\ndescribe(\"validateLayers\", () => {\n\tit(\"accepts valid layers in canonical order\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"tools\", bytes: \"t\" },\n\t\t\t\t{ layer: \"system\", bytes: \"s\" },\n\t\t\t]),\n\t\t).not.toThrow();\n\t});\n\n\tit(\"rejects duplicate layers\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"tools\", bytes: \"a\" },\n\t\t\t\t{ layer: \"tools\", bytes: \"b\" },\n\t\t\t]),\n\t\t).toThrow(/duplicate layer/);\n\t});\n\n\tit(\"rejects out-of-order layers\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"system\", bytes: \"s\" },\n\t\t\t\t{ layer: \"tools\", bytes: \"t\" },\n\t\t\t]),\n\t\t).toThrow(/out of canonical order/);\n\t});\n});\n\ndescribe(\"defaultPolicy\", () => {\n\tit(\"returns short retention with no breakpoints\", () => {\n\t\tconst p = defaultPolicy();\n\t\texpect(p.retention).toBe(\"short\");\n\t\texpect(p.supportsBreakpoints).toBe(false);\n\t});\n});\n"]}

package/dist/cache/__tests__/policy.test.js

@@ -0,0 +1,79 @@
+import { describe, expect, it } from "vitest";
+import { defaultPolicy, resolveRetention, totalInputTokens, usageToCacheReport, validateLayers } from "../policy.js";
+describe("usageToCacheReport", () => {
+    it("converts Usage to CacheUsageReport", () => {
+        const report = usageToCacheReport({
+            input: 500,
+            output: 200,
+            cacheRead: 300,
+            cacheWrite: 100,
+            totalTokens: 1100,
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+        });
+        expect(report.cachedInputTokens).toBe(300);
+        expect(report.cacheWriteTokens).toBe(100);
+        expect(report.uncachedInputTokens).toBe(500);
+        expect(totalInputTokens(report)).toBe(800);
+    });
+    it("clamps negative input to zero", () => {
+        const report = usageToCacheReport({
+            input: -10,
+            output: 50,
+            cacheRead: 100,
+            cacheWrite: 0,
+            totalTokens: 140,
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+        });
+        expect(report.uncachedInputTokens).toBe(0);
+    });
+    it("handles zero-cache usage (e.g. Mistral)", () => {
+        const report = usageToCacheReport({
+            input: 1000,
+            output: 200,
+            cacheRead: 0,
+            cacheWrite: 0,
+            totalTokens: 1200,
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+        });
+        expect(report.cachedInputTokens).toBe(0);
+        expect(report.cacheWriteTokens).toBe(0);
+        expect(report.uncachedInputTokens).toBe(1000);
+        expect(totalInputTokens(report)).toBe(1000);
+    });
+});
+describe("resolveRetention", () => {
+    it("returns cliFlag when present", () => {
+        expect(resolveRetention({ roleDefault: "short", cliFlag: "long" })).toBe("long");
+    });
+    it("returns roleDefault as fallback", () => {
+        expect(resolveRetention({ roleDefault: "long" })).toBe("long");
+    });
+});
+describe("validateLayers", () => {
+    it("accepts valid layers in canonical order", () => {
+        expect(() => validateLayers([
+            { layer: "tools", bytes: "t" },
+            { layer: "system", bytes: "s" },
+        ])).not.toThrow();
+    });
+    it("rejects duplicate layers", () => {
+        expect(() => validateLayers([
+            { layer: "tools", bytes: "a" },
+            { layer: "tools", bytes: "b" },
+        ])).toThrow(/duplicate layer/);
+    });
+    it("rejects out-of-order layers", () => {
+        expect(() => validateLayers([
+            { layer: "system", bytes: "s" },
+            { layer: "tools", bytes: "t" },
+        ])).toThrow(/out of canonical order/);
+    });
+});
+describe("defaultPolicy", () => {
+    it("returns short retention with no breakpoints", () => {
+        const p = defaultPolicy();
+        expect(p.retention).toBe("short");
+        expect(p.supportsBreakpoints).toBe(false);
+    });
+});
+//# sourceMappingURL=policy.test.js.map

package/dist/cache/__tests__/policy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.test.js","sourceRoot":"","sources":["../../../src/cache/__tests__/policy.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { defaultPolicy, resolveRetention, totalInputTokens, usageToCacheReport, validateLayers } from \"../policy.js\";\n\ndescribe(\"usageToCacheReport\", () => {\n\tit(\"converts Usage to CacheUsageReport\", () => {\n\t\tconst report = usageToCacheReport({\n\t\t\tinput: 500,\n\t\t\toutput: 200,\n\t\t\tcacheRead: 300,\n\t\t\tcacheWrite: 100,\n\t\t\ttotalTokens: 1100,\n\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t});\n\t\texpect(report.cachedInputTokens).toBe(300);\n\t\texpect(report.cacheWriteTokens).toBe(100);\n\t\texpect(report.uncachedInputTokens).toBe(500);\n\t\texpect(totalInputTokens(report)).toBe(800);\n\t});\n\n\tit(\"clamps negative input to zero\", () => {\n\t\tconst report = usageToCacheReport({\n\t\t\tinput: -10,\n\t\t\toutput: 50,\n\t\t\tcacheRead: 100,\n\t\t\tcacheWrite: 0,\n\t\t\ttotalTokens: 140,\n\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t});\n\t\texpect(report.uncachedInputTokens).toBe(0);\n\t});\n\n\tit(\"handles zero-cache usage (e.g. Mistral)\", () => {\n\t\tconst report = usageToCacheReport({\n\t\t\tinput: 1000,\n\t\t\toutput: 200,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t\ttotalTokens: 1200,\n\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t});\n\t\texpect(report.cachedInputTokens).toBe(0);\n\t\texpect(report.cacheWriteTokens).toBe(0);\n\t\texpect(report.uncachedInputTokens).toBe(1000);\n\t\texpect(totalInputTokens(report)).toBe(1000);\n\t});\n});\n\ndescribe(\"resolveRetention\", () => {\n\tit(\"returns cliFlag when present\", () => {\n\t\texpect(resolveRetention({ roleDefault: \"short\", cliFlag: \"long\" })).toBe(\"long\");\n\t});\n\n\tit(\"returns roleDefault as fallback\", () => {\n\t\texpect(resolveRetention({ roleDefault: \"long\" })).toBe(\"long\");\n\t});\n});\n\ndescribe(\"validateLayers\", () => {\n\tit(\"accepts valid layers in canonical order\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"tools\", bytes: \"t\" },\n\t\t\t\t{ layer: \"system\", bytes: \"s\" },\n\t\t\t]),\n\t\t).not.toThrow();\n\t});\n\n\tit(\"rejects duplicate layers\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"tools\", bytes: \"a\" },\n\t\t\t\t{ layer: \"tools\", bytes: \"b\" },\n\t\t\t]),\n\t\t).toThrow(/duplicate layer/);\n\t});\n\n\tit(\"rejects out-of-order layers\", () => {\n\t\texpect(() =>\n\t\t\tvalidateLayers([\n\t\t\t\t{ layer: \"system\", bytes: \"s\" },\n\t\t\t\t{ layer: \"tools\", bytes: \"t\" },\n\t\t\t]),\n\t\t).toThrow(/out of canonical order/);\n\t});\n});\n\ndescribe(\"defaultPolicy\", () => {\n\tit(\"returns short retention with no breakpoints\", () => {\n\t\tconst p = defaultPolicy();\n\t\texpect(p.retention).toBe(\"short\");\n\t\texpect(p.supportsBreakpoints).toBe(false);\n\t});\n});\n"]}

package/dist/cache/__tests__/tool-serializer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-serializer.test.d.ts.map

package/dist/cache/__tests__/tool-serializer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-serializer.test.d.ts","sourceRoot":"","sources":["../../../src/cache/__tests__/tool-serializer.test.ts"],"names":[],"mappings":"","sourcesContent":["// T-005, T-006\nimport { describe, expect, it } from \"vitest\";\nimport { serializeToolSchemas, toolSchemaHash } from \"../tool-serializer.js\";\n\nconst baseTools = [\n\t{\n\t\tname: \"bash\",\n\t\tdescription: \"Run a shell command\",\n\t\tparameters: { type: \"object\", properties: { cmd: { type: \"string\" } } },\n\t},\n\t{\n\t\tname: \"read\",\n\t\tdescription: \"Read a file\",\n\t\tparameters: { type: \"object\", properties: { path: { type: \"string\" } } },\n\t},\n\t{\n\t\tname: \"apply_sr_diff\",\n\t\tdescription: \"Exact-match search/replace edit\",\n\t\tparameters: { type: \"object\", properties: { file: { type: \"string\" } } },\n\t},\n];\n\ndescribe(\"serializeToolSchemas\", () => {\n\tit(\"produces byte-stable SHA256 across 1000 invocations\", () => {\n\t\tconst first = toolSchemaHash(baseTools);\n\t\tfor (let i = 0; i < 1000; i++) {\n\t\t\texpect(toolSchemaHash(baseTools)).toBe(first);\n\t\t}\n\t});\n\n\tit(\"reordering tools at call site does not change bytes\", () => {\n\t\tconst a = serializeToolSchemas(baseTools);\n\t\tconst shuffled = [baseTools[2], baseTools[0], baseTools[1]];\n\t\tconst b = serializeToolSchemas(shuffled);\n\t\texpect(a).toBe(b);\n\t});\n\n\tit(\"editing one tool description isolates to tools-layer hash (it changes)\", () => {\n\t\tconst original = toolSchemaHash(baseTools);\n\t\tconst edited = baseTools.map((t) => (t.name === \"read\" ? { ...t, description: \"Read a file from disk\" } : t));\n\t\tconst editedHash = toolSchemaHash(edited);\n\t\texpect(editedHash).not.toBe(original);\n\t});\n\n\tit(\"strips absolute paths and ISO timestamps from descriptions\", () => {\n\t\tconst tools = [\n\t\t\t{\n\t\t\t\tname: \"log\",\n\t\t\t\tdescription: \"Written at 2025-03-15T12:34:56Z from /Users/alice/project\",\n\t\t\t\tparameters: {},\n\t\t\t},\n\t\t];\n\t\tconst json = serializeToolSchemas(tools);\n\t\texpect(json).not.toContain(\"2025-03-15\");\n\t\texpect(json).not.toContain(\"/Users/alice\");\n\t\texpect(json).toContain(\"<ts>\");\n\t\texpect(json).toContain(\"<path>\");\n\t});\n\n\tit(\"sorts object keys deeply for deterministic output\", () => {\n\t\tconst a = serializeToolSchemas([\n\t\t\t{ name: \"t\", description: \"d\", parameters: { b: 1, a: 2, nested: { z: 1, y: 2 } } },\n\t\t]);\n\t\tconst b = serializeToolSchemas([\n\t\t\t{ name: \"t\", description: \"d\", parameters: { nested: { y: 2, z: 1 }, a: 2, b: 1 } },\n\t\t]);\n\t\texpect(a).toBe(b);\n\t});\n});\n"]}

package/dist/cache/__tests__/tool-serializer.test.js

@@ -0,0 +1,64 @@
+// T-005, T-006
+import { describe, expect, it } from "vitest";
+import { serializeToolSchemas, toolSchemaHash } from "../tool-serializer.js";
+const baseTools = [
+    {
+        name: "bash",
+        description: "Run a shell command",
+        parameters: { type: "object", properties: { cmd: { type: "string" } } },
+    },
+    {
+        name: "read",
+        description: "Read a file",
+        parameters: { type: "object", properties: { path: { type: "string" } } },
+    },
+    {
+        name: "apply_sr_diff",
+        description: "Exact-match search/replace edit",
+        parameters: { type: "object", properties: { file: { type: "string" } } },
+    },
+];
+describe("serializeToolSchemas", () => {
+    it("produces byte-stable SHA256 across 1000 invocations", () => {
+        const first = toolSchemaHash(baseTools);
+        for (let i = 0; i < 1000; i++) {
+            expect(toolSchemaHash(baseTools)).toBe(first);
+        }
+    });
+    it("reordering tools at call site does not change bytes", () => {
+        const a = serializeToolSchemas(baseTools);
+        const shuffled = [baseTools[2], baseTools[0], baseTools[1]];
+        const b = serializeToolSchemas(shuffled);
+        expect(a).toBe(b);
+    });
+    it("editing one tool description isolates to tools-layer hash (it changes)", () => {
+        const original = toolSchemaHash(baseTools);
+        const edited = baseTools.map((t) => (t.name === "read" ? { ...t, description: "Read a file from disk" } : t));
+        const editedHash = toolSchemaHash(edited);
+        expect(editedHash).not.toBe(original);
+    });
+    it("strips absolute paths and ISO timestamps from descriptions", () => {
+        const tools = [
+            {
+                name: "log",
+                description: "Written at 2025-03-15T12:34:56Z from /Users/alice/project",
+                parameters: {},
+            },
+        ];
+        const json = serializeToolSchemas(tools);
+        expect(json).not.toContain("2025-03-15");
+        expect(json).not.toContain("/Users/alice");
+        expect(json).toContain("<ts>");
+        expect(json).toContain("<path>");
+    });
+    it("sorts object keys deeply for deterministic output", () => {
+        const a = serializeToolSchemas([
+            { name: "t", description: "d", parameters: { b: 1, a: 2, nested: { z: 1, y: 2 } } },
+        ]);
+        const b = serializeToolSchemas([
+            { name: "t", description: "d", parameters: { nested: { y: 2, z: 1 }, a: 2, b: 1 } },
+        ]);
+        expect(a).toBe(b);
+    });
+});
+//# sourceMappingURL=tool-serializer.test.js.map

package/dist/cache/__tests__/tool-serializer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-serializer.test.js","sourceRoot":"","sources":["../../../src/cache/__tests__/tool-serializer.test.ts"],"names":[],"mappings":"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","sourcesContent":["// T-005, T-006\nimport { describe, expect, it } from \"vitest\";\nimport { serializeToolSchemas, toolSchemaHash } from \"../tool-serializer.js\";\n\nconst baseTools = [\n\t{\n\t\tname: \"bash\",\n\t\tdescription: \"Run a shell command\",\n\t\tparameters: { type: \"object\", properties: { cmd: { type: \"string\" } } },\n\t},\n\t{\n\t\tname: \"read\",\n\t\tdescription: \"Read a file\",\n\t\tparameters: { type: \"object\", properties: { path: { type: \"string\" } } },\n\t},\n\t{\n\t\tname: \"apply_sr_diff\",\n\t\tdescription: \"Exact-match search/replace edit\",\n\t\tparameters: { type: \"object\", properties: { file: { type: \"string\" } } },\n\t},\n];\n\ndescribe(\"serializeToolSchemas\", () => {\n\tit(\"produces byte-stable SHA256 across 1000 invocations\", () => {\n\t\tconst first = toolSchemaHash(baseTools);\n\t\tfor (let i = 0; i < 1000; i++) {\n\t\t\texpect(toolSchemaHash(baseTools)).toBe(first);\n\t\t}\n\t});\n\n\tit(\"reordering tools at call site does not change bytes\", () => {\n\t\tconst a = serializeToolSchemas(baseTools);\n\t\tconst shuffled = [baseTools[2], baseTools[0], baseTools[1]];\n\t\tconst b = serializeToolSchemas(shuffled);\n\t\texpect(a).toBe(b);\n\t});\n\n\tit(\"editing one tool description isolates to tools-layer hash (it changes)\", () => {\n\t\tconst original = toolSchemaHash(baseTools);\n\t\tconst edited = baseTools.map((t) => (t.name === \"read\" ? { ...t, description: \"Read a file from disk\" } : t));\n\t\tconst editedHash = toolSchemaHash(edited);\n\t\texpect(editedHash).not.toBe(original);\n\t});\n\n\tit(\"strips absolute paths and ISO timestamps from descriptions\", () => {\n\t\tconst tools = [\n\t\t\t{\n\t\t\t\tname: \"log\",\n\t\t\t\tdescription: \"Written at 2025-03-15T12:34:56Z from /Users/alice/project\",\n\t\t\t\tparameters: {},\n\t\t\t},\n\t\t];\n\t\tconst json = serializeToolSchemas(tools);\n\t\texpect(json).not.toContain(\"2025-03-15\");\n\t\texpect(json).not.toContain(\"/Users/alice\");\n\t\texpect(json).toContain(\"<ts>\");\n\t\texpect(json).toContain(\"<path>\");\n\t});\n\n\tit(\"sorts object keys deeply for deterministic output\", () => {\n\t\tconst a = serializeToolSchemas([\n\t\t\t{ name: \"t\", description: \"d\", parameters: { b: 1, a: 2, nested: { z: 1, y: 2 } } },\n\t\t]);\n\t\tconst b = serializeToolSchemas([\n\t\t\t{ name: \"t\", description: \"d\", parameters: { nested: { y: 2, z: 1 }, a: 2, b: 1 } },\n\t\t]);\n\t\texpect(a).toBe(b);\n\t});\n});\n"]}

package/dist/cache/compaction.d.ts

@@ -0,0 +1,30 @@
+export interface Turn {
+    index: number;
+    bytes: string;
+}
+export interface TrimConfig {
+    /** Keep the most recent N turns untouched. */
+    recentFloor: number;
+}
+export interface TrimResult {
+    kept: Turn[];
+    summary: Turn;
+    droppedCount: number;
+}
+/** Deterministic summary bytes derived from dropped turns. */
+export declare function summarize(dropped: Turn[]): string;
+/** Middle-drop: keep [0..pivot] as a placeholder floor and [tail - recentFloor..tail];
+ *  drop the middle span and replace with a stable summary. */
+export declare function trimMiddle(turns: Turn[], config: TrimConfig): TrimResult;
+export interface KeepaliveConfig {
+    intervalMs: number;
+    retention: "long" | "short" | "none";
+    enabled: boolean;
+}
+export declare class KeepaliveScheduler {
+    private lastPingMs;
+    private lastActivityMs;
+    tick(now: number, config: KeepaliveConfig): "ping" | "shutoff" | "skip";
+    markActivity(now: number): void;
+}
+//# sourceMappingURL=compaction.d.ts.map

package/dist/cache/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/cache/compaction.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,IAAI;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IAC1B,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAIjD;AAED;8DAC8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAmBxE;AAGD,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAK;IAE3B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAQtE;IAED,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG9B;CACD","sourcesContent":["// T-050, T-051, T-052: cache-aware middle-drop trimming with N-recent-turn floor\n// + deterministic stable summary block.\n\nexport interface Turn {\n\tindex: number;\n\tbytes: string;\n}\n\nexport interface TrimConfig {\n\t/** Keep the most recent N turns untouched. */\n\trecentFloor: number;\n}\n\nexport interface TrimResult {\n\tkept: Turn[];\n\tsummary: Turn;\n\tdroppedCount: number;\n}\n\n/** Deterministic summary bytes derived from dropped turns. */\nexport function summarize(dropped: Turn[]): string {\n\tconst indices = dropped.map((t) => t.index).join(\",\");\n\tconst totalBytes = dropped.reduce((acc, t) => acc + t.bytes.length, 0);\n\treturn `<compact ${dropped.length} turns [${indices}], ${totalBytes} bytes>`;\n}\n\n/** Middle-drop: keep [0..pivot] as a placeholder floor and [tail - recentFloor..tail];\n *  drop the middle span and replace with a stable summary. */\nexport function trimMiddle(turns: Turn[], config: TrimConfig): TrimResult {\n\tif (turns.length <= config.recentFloor + 1) {\n\t\treturn {\n\t\t\tkept: turns,\n\t\t\tsummary: { index: -1, bytes: \"\" },\n\t\t\tdroppedCount: 0,\n\t\t};\n\t}\n\tconst tail = turns.slice(turns.length - config.recentFloor);\n\tconst middle = turns.slice(0, turns.length - config.recentFloor);\n\tconst summary: Turn = {\n\t\tindex: middle[middle.length - 1].index + 0.5,\n\t\tbytes: summarize(middle),\n\t};\n\treturn {\n\t\tkept: [summary, ...tail],\n\t\tsummary,\n\t\tdroppedCount: middle.length,\n\t};\n}\n\n// T-053, T-054: opt-in keepalive pings with idle shutoff.\nexport interface KeepaliveConfig {\n\tintervalMs: number;\n\tretention: \"long\" | \"short\" | \"none\";\n\tenabled: boolean;\n}\n\nexport class KeepaliveScheduler {\n\tprivate lastPingMs = 0;\n\tprivate lastActivityMs = 0;\n\n\ttick(now: number, config: KeepaliveConfig): \"ping\" | \"shutoff\" | \"skip\" {\n\t\tif (!config.enabled || config.retention === \"none\") return \"skip\";\n\t\tif (now - this.lastActivityMs > config.intervalMs * 2) return \"shutoff\";\n\t\tif (now - this.lastPingMs >= config.intervalMs) {\n\t\t\tthis.lastPingMs = now;\n\t\t\treturn \"ping\";\n\t\t}\n\t\treturn \"skip\";\n\t}\n\n\tmarkActivity(now: number): void {\n\t\tthis.lastActivityMs = now;\n\t\tthis.lastPingMs = now;\n\t}\n}\n"]}