@framers/agentos-ext-account-sources 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @framers/agentos-ext-account-sources
 
-A person's own accounts as sources. This library defines `AccountSourceConnector` and the `SourceRef` every passage carries, with helpers for line ranges, links, bounded body reads and requests under the shared public-sources limiter.
+A person's own accounts as sources. This library defines `AccountSourceConnector` and the `SourceRef` every passage carries, with helpers for line ranges, links, bounded body reads, requests under the shared public-sources limiter and the cache lifetime of a read.
 
 Install `@framers/agentos-ext-account-sources` with its peer `@framers/agentos` 0.10.40 or later. Node.js 20.19 or later is required. The runtime dependency is `@framers/agentos-ext-public-sources`.
 
@@ -65,6 +65,60 @@ async function readSource(url: string, signal?: AbortSignal): Promise<Uint8Array
 }
 ```
 
+## Cache retention
+
+```ts
+import { decideSourceCache, type SourceCacheDecision, type SourceCachePermission } from '@framers/agentos-ext-account-sources';
+
+/** Decides whether a response whose read began at `readStartedAt` may be stored, and until when. */
+function cacheDecision(
+  response: Response,
+  permission: SourceCachePermission | null,
+  readStartedAt: number,
+  windowExpiresAt: number,
+): SourceCacheDecision {
+  return decideSourceCache({
+    permission,
+    maximumCacheMs: 86_400_000,
+    readStartedAt,
+    receivedAt: Date.now(),
+    windowExpiresAt,
+    headers: {
+      cacheControl: response.headers.get('cache-control'),
+      date: response.headers.get('date'),
+      age: response.headers.get('age'),
+      expires: response.headers.get('expires'),
+    },
+  });
+}
+```
+
+`decideSourceCache(input)` answers `{ kind: 'cache', expiresAt, evidenceId }` or `{ kind: 'skip', reason }`. Its input holds the permission record, the host's maximum lifetime, three times in epoch milliseconds and four response headers; it takes no response body, URL or token.
+
+`permission` is the host's record of an approved retention policy: an opaque `evidenceId` and a `retentionMs`. The library applies the record; it does not establish that a provider allows caching. A missing record, a blank `evidenceId` or a `retentionMs` that is not a positive safe integer answers `not_permitted`, whatever the headers allow.
+
+`expiresAt` is the earliest of:
+
+- `readStartedAt` plus the smaller of `retentionMs` and `maximumCacheMs`, less the response's `Age`;
+- `windowExpiresAt`, the end of the retained material's window (the earliest end when a read holds several items);
+- the `max-age` and `s-maxage` lifetimes, counted from `receivedAt` and reduced by the corrected age of [RFC 9111, section 4.2.3](https://www.rfc-editor.org/rfc/rfc9111#section-4.2.3): the larger of the age the `Date` header implies and `Age` plus the time the read took;
+- the `Expires` lifetime (its distance from `Date`, or from `readStartedAt` when `Date` is absent), counted and reduced the same way, and the `Expires` time itself.
+
+A skip carries one of these reasons:
+
+| Reason | When |
+|---|---|
+| `not_permitted` | No permission record, a blank `evidenceId`, or a `retentionMs` that is not a positive safe integer |
+| `no_store` | `Cache-Control` holds `no-store` |
+| `revalidation_required` | `Cache-Control` holds `no-cache`, with or without field names |
+| `invalid_cache_header` | A malformed or repeated `Cache-Control` directive; a `max-age` or `s-maxage` without a whole number of seconds or past the safe-integer range; an `Age` that is not a whole number of seconds or is past the safe-integer range; a `Date` or `Expires` before 1970 or outside the IMF-fixdate form of [RFC 9110, section 5.6.7](https://www.rfc-editor.org/rfc/rfc9110#section-5.6.7), exactly as `Date.prototype.toUTCString()` writes it (`Tue, 14 Nov 2023 22:13:20 GMT`) |
+| `invalid_bounds` | A clock value that is not a nonnegative safe integer, a `receivedAt` before `readStartedAt`, a `maximumCacheMs` that is not a positive safe integer, or a lifetime past the safe-integer range |
+| `expired` | The lifetime ends at or before `receivedAt` |
+
+Directive names match in any case and values may be quoted. Other directives, such as `private` and `immutable`, neither grant nor extend a lifetime. The obsolete HTTP date forms are refused rather than parsed.
+
+A skip stores nothing: record its reason and keep no content. Store `expiresAt` with the content and check it on every read. Neither a later sync checkpoint nor a second call with the old response extends it; a new read takes a new decision.
+
 ## License
 
 Apache-2.0. This pack carries a copy of the repository's license.

package/dist/cachePolicy.d.ts

@@ -0,0 +1,39 @@
+/** Host-verified permission; this module does not establish provider authorization. */
+export interface SourceCachePermission {
+    readonly evidenceId: string;
+    readonly retentionMs: number;
+}
+/** Cache metadata only; no request URL, token or response content enters the policy. */
+export interface SourceCacheHeaders {
+    readonly cacheControl: string | null;
+    readonly date: string | null;
+    readonly age: string | null;
+    readonly expires: string | null;
+}
+/** Clock and retention bounds for one obtained source response. */
+export interface SourceCacheInput {
+    readonly permission: SourceCachePermission | null;
+    readonly maximumCacheMs: number;
+    readonly readStartedAt: number;
+    readonly receivedAt: number;
+    readonly windowExpiresAt: number;
+    readonly headers: SourceCacheHeaders;
+}
+/** Fixed reasons safe to aggregate without content-bearing provider messages. */
+export type SourceCacheSkipReason = 'not_permitted' | 'no_store' | 'revalidation_required' | 'invalid_cache_header' | 'invalid_bounds' | 'expired';
+/** A finite allowed lifetime, or an explicit refusal to persist any source content. */
+export type SourceCacheDecision = {
+    readonly kind: 'cache';
+    readonly expiresAt: number;
+    readonly evidenceId: string;
+} | {
+    readonly kind: 'skip';
+    readonly reason: SourceCacheSkipReason;
+};
+/**
+ * Applies explicit permission and conservative provider/cache/window limits.
+ * Returned expiry is never extended by a history checkpoint or by calling this
+ * function again with the old response. A new read needs its own permission check.
+ */
+export declare function decideSourceCache(input: SourceCacheInput): SourceCacheDecision;
+//# sourceMappingURL=cachePolicy.d.ts.map

package/dist/cachePolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cachePolicy.d.ts","sourceRoot":"","sources":["../src/cachePolicy.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC;AAED,iFAAiF;AACjF,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GAAG,UAAU,GAAG,uBAAuB,GACtD,sBAAsB,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAE1D,uFAAuF;AACvF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACnF;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAiCtE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,mBAAmB,CAiD9E"}

package/dist/cachePolicy.js

@@ -0,0 +1,97 @@
+const integer = (value) => Number.isSafeInteger(value) && value >= 0;
+const positive = (value) => integer(value) && value > 0;
+const skip = (reason) => ({ kind: 'skip', reason });
+/** Whole seconds written in digits only, as safe-integer milliseconds; anything else is null. */
+function milliseconds(value) {
+    if (!/^\d+$/.test(value))
+        return null;
+    const converted = Number(value) * 1_000;
+    return integer(converted) ? converted : null;
+}
+/** An HTTP date accepted only in the exact form `toUTCString` writes, so a loose parse cannot invent a time. */
+function date(value) {
+    if (value === null)
+        return null;
+    const parsed = Date.parse(value);
+    return integer(parsed) && new Date(parsed).toUTCString() === value ? parsed : null;
+}
+/** Cache-Control directives by lower-case name; a malformed or repeated directive answers null. */
+function directives(value) {
+    const found = new Map();
+    if (value === null || value.trim() === '')
+        return found;
+    for (const part of value.split(',')) {
+        const match = /^([a-z][a-z0-9-]*)(?:\s*=\s*(?:"([^"]*)"|([^\s",]+)))?$/i.exec(part.trim());
+        const name = match?.[1]?.toLowerCase();
+        if (!match || !name || found.has(name))
+            return null;
+        found.set(name, match[2] ?? match[3] ?? null);
+    }
+    return found;
+}
+/**
+ * Applies explicit permission and conservative provider/cache/window limits.
+ * Returned expiry is never extended by a history checkpoint or by calling this
+ * function again with the old response. A new read needs its own permission check.
+ */
+export function decideSourceCache(input) {
+    const permission = input.permission;
+    if (!permission || typeof permission.evidenceId !== 'string'
+        || permission.evidenceId.trim().length === 0 || !positive(permission.retentionMs)) {
+        return skip('not_permitted');
+    }
+    if (!positive(input.maximumCacheMs) || !integer(input.readStartedAt)
+        || !integer(input.receivedAt) || !integer(input.windowExpiresAt)
+        || input.receivedAt < input.readStartedAt)
+        return skip('invalid_bounds');
+    const policyEnd = input.readStartedAt + Math.min(permission.retentionMs, input.maximumCacheMs);
+    if (!integer(policyEnd))
+        return skip('invalid_bounds');
+    const rules = directives(input.headers.cacheControl);
+    if (rules === null)
+        return skip('invalid_cache_header');
+    if (rules.has('no-store'))
+        return skip('no_store');
+    if (rules.has('no-cache'))
+        return skip('revalidation_required');
+    const age = input.headers.age === null ? 0 : milliseconds(input.headers.age.trim());
+    const responseDate = date(input.headers.date);
+    const responseExpires = date(input.headers.expires);
+    if (age === null || (input.headers.date !== null && responseDate === null)
+        || (input.headers.expires !== null && responseExpires === null)) {
+        return skip('invalid_cache_header');
+    }
+    const elapsed = input.receivedAt - input.readStartedAt;
+    const apparentAge = responseDate === null ? 0 : Math.max(0, input.receivedAt - responseDate);
+    const correctedAge = Math.max(apparentAge, age + elapsed);
+    if (!integer(correctedAge))
+        return skip('invalid_cache_header');
+    let expiresAt = Math.min(policyEnd - age, input.windowExpiresAt);
+    for (const name of ['max-age', 's-maxage']) {
+        if (!rules.has(name))
+            continue;
+        const value = rules.get(name);
+        if (value === null || value === undefined)
+            return skip('invalid_cache_header');
+        const freshFor = milliseconds(value);
+        if (freshFor === null)
+            return skip('invalid_cache_header');
+        const freshUntil = input.receivedAt + freshFor - correctedAge;
+        if (!Number.isSafeInteger(freshUntil))
+            return skip('invalid_cache_header');
+        expiresAt = Math.min(expiresAt, freshUntil);
+    }
+    if (responseExpires !== null) {
+        const freshFor = responseExpires - (responseDate ?? input.readStartedAt);
+        const freshUntil = input.receivedAt + freshFor - correctedAge;
+        if (!Number.isSafeInteger(freshUntil))
+            return skip('invalid_cache_header');
+        expiresAt = Math.min(expiresAt, freshUntil, responseExpires);
+    }
+    if (!Number.isSafeInteger(expiresAt))
+        return skip('invalid_bounds');
+    if (expiresAt <= input.receivedAt)
+        return skip('expired');
+    return { kind: 'cache', expiresAt, evidenceId: permission.evidenceId };
+}
+//# sourceMappingURL=cachePolicy.js.map

package/dist/cachePolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cachePolicy.js","sourceRoot":"","sources":["../src/cachePolicy.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,4 +6,6 @@ export * from './sourceRef.js';
 export * from './readCapped.js';
 /** The shared limiter and response-producing calls run under it. */
 export * from './limiter.js';
+/** Explicit retention permission and conservative source-cache expiry. */
+export * from './cachePolicy.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,cAAc,YAAY,CAAC;AAC3B,yDAAyD;AACzD,cAAc,gBAAgB,CAAC;AAC/B,8DAA8D;AAC9D,cAAc,iBAAiB,CAAC;AAChC,oEAAoE;AACpE,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,cAAc,YAAY,CAAC;AAC3B,yDAAyD;AACzD,cAAc,gBAAgB,CAAC;AAC/B,8DAA8D;AAC9D,cAAc,iBAAiB,CAAC;AAChC,oEAAoE;AACpE,cAAc,cAAc,CAAC;AAC7B,0EAA0E;AAC1E,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -6,4 +6,6 @@ export * from './sourceRef.js';
 export * from './readCapped.js';
 /** The shared limiter and response-producing calls run under it. */
 export * from './limiter.js';
+/** Explicit retention permission and conservative source-cache expiry. */
+export * from './cachePolicy.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,cAAc,YAAY,CAAC;AAC3B,yDAAyD;AACzD,cAAc,gBAAgB,CAAC;AAC/B,8DAA8D;AAC9D,cAAc,iBAAiB,CAAC;AAChC,oEAAoE;AACpE,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,cAAc,YAAY,CAAC;AAC3B,yDAAyD;AACzD,cAAc,gBAAgB,CAAC;AAC/B,8DAA8D;AAC9D,cAAc,iBAAiB,CAAC;AAChC,oEAAoE;AACpE,cAAc,cAAc,CAAC;AAC7B,0EAA0E;AAC1E,cAAc,kBAAkB,CAAC"}

package/manifest.json

@@ -2,7 +2,7 @@
   "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
   "id": "com.framers.research.account-sources",
   "name": "Account Sources",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A person's own accounts as sources: connector interfaces, passage attribution, capped reads and a shared limiter",
   "author": {
     "name": "Frame",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos-ext-account-sources",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A person's own accounts as sources: connector interfaces, passage attribution, capped reads and a shared limiter",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,10 +47,10 @@
     "@types/node": "^20.12.12",
     "@vitest/coverage-v8": "^3.2.7",
     "rimraf": "^5.0.7",
-    "typedoc": "^0.25.13",
+    "typedoc": "^0.28.20",
     "typescript": "^5.4.5",
     "vitest": "^3.2.7",
-    "@framers/agentos": "^0.13.40"
+    "@framers/agentos": "^0.13.89"
   },
   "homepage": "https://github.com/framerslab/agentos-extensions/tree/master/registry/curated/research/account-sources#readme",
   "bugs": {