@framers/agentos-ext-account-sources 0.2.0 → 0.3.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, requests under the shared public-sources limiter and the cache lifetime of a read.
+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, and the contracts and pure rules of a durable, resumable synchronization.
 
 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`.
 
@@ -115,10 +115,75 @@ A skip carries one of these reasons:
 | `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.
+Directive names match in any case and values may be quoted; a quoted value may hold commas, as in `private="set-cookie, authorization"`. 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.
 
+## Durable synchronization
+
+```ts
+import {
+  advanceSourceSyncPage, committableSourceCursor, openSourceSyncCycle,
+  type SourceSyncPolicy, type SourceSyncWorkSummary,
+} from '@framers/agentos-ext-account-sources';
+
+const policy: SourceSyncPolicy = {
+  windowMs: 7 * 86_400_000, maxRetainedDocuments: 100, maxHeldCharacters: 2_000_000,
+  maxIndexedCharacters: 4_000_000, scanPageSize: 50, maxScanPages: 4, maxCandidates: 200,
+  maxChangedPerLease: 50, maxHistoryPagesPerLease: 10, leaseMs: 120_000,
+  pollMs: 900_000, manualMinIntervalMs: 60_000, reconcileMs: 86_400_000,
+};
+
+const opened = openSourceSyncCycle({
+  cycleId: 'cycle-1', generation: 3, mode: 'incremental', cutoff: Date.now(), fromCursor: 'cursor-41',
+});
+const { checkpoint, enqueueIds } = advanceSourceSyncPage(opened, {
+  kind: 'history', ids: ['item-a', 'item-b'], nextPageToken: null, cursor: 'cursor-42',
+}, policy);
+// Store `checkpoint` and queue `enqueueIds` as pending work in one transaction, then read each item.
+
+const summary: SourceSyncWorkSummary = {
+  cycleId: checkpoint.cycleId, generation: checkpoint.generation, checkpointRevision: checkpoint.revision,
+  total: 2, pending: 0, retry: 0, applied: 1, gone: 1, skipped: 0,
+};
+committableSourceCursor(checkpoint, summary); // 'cursor-42'
+```
+
+A connector that can page through an account adds the optional `sync` capability, an `AccountSourceSyncProvider`, and becomes a `ResumableAccountSourceConnector`. The four original methods keep their signatures, and an empty selection is not redefined as the whole account. The provider's calls take a `SourceSyncRequest` (scope, generation, cycle id, cutoff, policy and an optional signal) and commit nothing: `begin` answers the anchor a cycle starts from, `scanPage` a page of candidate ids, `historyPage` the ids changed since an anchor with the cursor the page reached, and `readSource` one item as a `document`, `gone`, `skipped` or `retry` result. Cursors and page tokens are opaque strings; no rule does arithmetic on them or orders them.
+
+A `SourceSyncDocument` holds a `SourceRead` with text, its message spans as UTF-16 offsets into that text, JSON metadata, an activity time, a content hash and the `cache` decision `decideSourceCache` answered for the read. A `SourceSyncWork` row holds ids, revisions, attempts and a disposition, never content. A `SourceSyncEvent` carries a fixed state, a count and an optional duration, never a scope or a provider payload.
+
+### Connection state
+
+`createSourceSyncState(scope, now)` starts a connection in `not_connected` at generation 0. `transitionSourceSync(state, event, now)` answers the next frozen state. It throws `invalid_source_transition` for an event the state does not allow and `source_sync_counter_exhausted` when a counter would pass the safe-integer range.
+
+| State | Meaning |
+|---|---|
+| `not_connected` | No grant yet |
+| `connecting` | Authorization in progress |
+| `syncing` | A sync is running |
+| `connected` | Grant held, no sync running |
+| `needs_reconnecting` | The grant was refused or lacks a scope; the cursor and use switches are cleared |
+| `disconnected` | The connection ended; the cursor and use switches are cleared |
+
+Pause is the `paused` flag on a connected or syncing connection, not a state: it stops syncs and keeps the cursor. Connecting, grant loss, disconnecting, pause, resume, a policy change and a use change each raise `generation`, so a store can refuse work started under an earlier one. A policy change also clears the cursor, so the next cycle applies the new bounds from a fresh pass. Connecting, pause, resume, a policy change, grant loss and disconnecting set `revalidationRequired`; a successful sync clears it. Disconnecting a disconnected connection, pausing a paused one and resuming an unpaused one answer the same state.
+
+`sourceSyncDue(state, policy, now, trigger)` is false unless the connection is connected or syncing, unpaused and at or after any `retryAt`. A `'scheduled'` trigger is then due once `nextSyncAt` is reached; a `'manual'` one when no request was made yet or `manualMinIntervalMs` has passed since the last. A deferred sync keeps the cursor and sets `retryAt`. A `domain_policy` or `invalid_response` failure clears `nextSyncAt`, so no scheduled sync is due until a manual request or another control change sets it.
+
+### Cycles and the cursor
+
+`openSourceSyncCycle(input)` opens a checkpoint at revision 0 and throws `invalid_source_sync_checkpoint` for an empty or oversized id or anchor, a generation or cutoff that is not a nonnegative safe integer, or an unknown mode. An `incremental` cycle starts with history from the committed cursor; `bootstrap`, `reconcile` and `recovery` start with a scan, from an anchor read before it. `advanceSourceSyncPage(checkpoint, page, policy)` answers the next checkpoint and the ids to queue, without duplicates:
+
+- A scan that reaches `maxScanPages` pages or `maxCandidates` ids with more left keeps the first ids in the order given, marks the checkpoint `bounded` and stops. A finished scan moves the cycle to history from the same anchor.
+- A history page records its cursor as the target. The last page, with no next page token, moves the cycle to `apply`.
+- A page of the wrong kind for the phase, a scan page past the bounds or larger than `scanPageSize`, an empty or oversized id, cursor or page token, or a page whose next token is the token it was read with throws `invalid_source_sync_page`.
+
+`committableSourceCursor(checkpoint, summary)` answers the target cursor only in `apply` with no page token left, when the summary names the checkpoint's cycle, generation and revision, holds no pending or retry work, and its applied, gone and skipped counts add up to its total. Otherwise it answers null. `isTerminalSourceWork` is true for applied, gone and skipped work.
+
+The rules are pure and take no lock: the store that commits a cursor reads the summary from all of the cycle's work under its lease and checkpoint lock, in the transaction that commits it. A page carries no gone list: only a read of the item, an exclusion, expiry or the end of the connection removes content.
+
+`new SourceSyncFault(code, retryAt?)` carries a fixed failure code as its message (`source_sync_<code>`), never a provider's text, exposes `code` and `retryAt`, and throws `invalid_source_sync_fault` for an unknown code or a `retryAt` that is not a nonnegative safe integer. `assertSourceSyncPolicy(policy)` throws `invalid_source_sync_policy` unless every policy value is a positive safe integer.
+
 ## License
 
 Apache-2.0. This pack carries a copy of the repository's license.

package/dist/cachePolicy.d.ts.map

@@ -1 +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"}
+{"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;AAgEtE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,mBAAmB,CAiD9E"}

package/dist/cachePolicy.js

@@ -15,13 +15,47 @@ function date(value) {
     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. */
+/**
+ * Splits a list field value on commas outside quoted strings (RFC 9110, sections 5.6.1.2 and
+ * 5.6.4). A quoted string left open answers null.
+ */
+function listMembers(value) {
+    const members = [];
+    let quoted = false;
+    let from = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const character = value[index];
+        if (quoted && character === '\\') {
+            // A quoted-pair: the escaped character neither closes the string nor splits the list.
+            index += 1;
+        }
+        else if (character === '"') {
+            quoted = !quoted;
+        }
+        else if (character === ',' && !quoted) {
+            members.push(value.slice(from, index));
+            from = index + 1;
+        }
+    }
+    if (quoted)
+        return null;
+    members.push(value.slice(from));
+    return members;
+}
+/**
+ * Cache-Control directives by lower-case name. A quoted value may hold commas; a backslash in it
+ * escapes the next character and stays in the value. A malformed or repeated directive, or a
+ * quoted value left open, 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 members = listMembers(value);
+    if (members === null)
+        return null;
+    for (const part of members) {
+        const match = /^([a-z][a-z0-9-]*)(?:\s*=\s*(?:"((?:[^"\\]|\\[\s\S])*)"|([^\s",]+)))?$/i.exec(part.trim());
         const name = match?.[1]?.toLowerCase();
         if (!match || !name || found.has(name))
             return null;

package/dist/cachePolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"cachePolicy.js","sourceRoot":"","sources":["../src/cachePolicy.ts"],"names":[],"mappings":"AAkCA,MAAM,OAAO,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AACzE,MAAM,IAAI,GAAG,CAAC,MAA6B,EAAuB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEhG,iGAAiG;AACjG,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IACxC,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,gHAAgH;AAChH,SAAS,IAAI,CAAC,KAAoB;IAChC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACrF,CAAC;AAED,mGAAmG;AACnG,SAAS,UAAU,CAAC,KAAoB;IACtC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,0DAA0D,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3F,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACpD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACpC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ;WACvD,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACpF,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;WAC/D,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;WAC7D,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAE3E,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC/F,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAEhE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACpF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,YAAY,KAAK,IAAI,CAAC;WACrE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,eAAe,KAAK,IAAI,CAAC,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC;IACvD,MAAM,WAAW,GAAG,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,YAAY,CAAC,CAAC;IAC7F,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAChE,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,GAAG,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAEjE,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC3E,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,eAAe,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC3E,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACpE,IAAI,SAAS,IAAI,KAAK,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC;AACzE,CAAC"}
+{"version":3,"file":"cachePolicy.js","sourceRoot":"","sources":["../src/cachePolicy.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -8,4 +8,7 @@ export * from './readCapped.js';
 export * from './limiter.js';
 /** Explicit retention permission and conservative source-cache expiry. */
 export * from './cachePolicy.js';
+/** Durable synchronization contracts and pure state/checkpoint rules. */
+export * from './sync/types.js';
+export * from './sync/state.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;AAC7B,0EAA0E;AAC1E,cAAc,kBAAkB,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;AACjC,yEAAyE;AACzE,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -8,4 +8,7 @@ export * from './readCapped.js';
 export * from './limiter.js';
 /** Explicit retention permission and conservative source-cache expiry. */
 export * from './cachePolicy.js';
+/** Durable synchronization contracts and pure state/checkpoint rules. */
+export * from './sync/types.js';
+export * from './sync/state.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;AAC7B,0EAA0E;AAC1E,cAAc,kBAAkB,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;AACjC,yEAAyE;AACzE,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/sync/state.d.ts

@@ -0,0 +1,24 @@
+import type { SourceSyncScope, SourceSyncState, SourceSyncPolicy, SourceSyncTransition, SourceSyncTrigger, SourceSyncFailureCode, SourceSyncCheckpoint, SourceSyncCycleInput, SourceSyncPage, SourceSyncPageApplication, SourceSyncWorkDisposition, SourceSyncWorkSummary } from './types.js';
+/** Fixed failure code only. Never pass provider messages, HTTP bodies or nested causes. */
+export declare class SourceSyncFault extends Error {
+    readonly code: SourceSyncFailureCode;
+    readonly retryAt: number | null;
+    constructor(code: SourceSyncFailureCode, retryAt?: number | null);
+}
+/** Throws `invalid_source_sync_policy` unless every policy value is a positive safe integer. */
+export declare function assertSourceSyncPolicy(policy: SourceSyncPolicy): void;
+/** A new connection in `not_connected` at generation 0. Throws `invalid_source_sync_state` for an empty or oversized key or an invalid clock. */
+export declare function createSourceSyncState(scope: SourceSyncScope, now: number): SourceSyncState;
+/** Pure proposal only; the SQL store authorizes and commits it under its lease/owner lock. */
+export declare function transitionSourceSync(state: SourceSyncState, event: SourceSyncTransition, now: number): SourceSyncState;
+/** Lease existence is a separate atomic SQL check, not something this function authorizes. */
+export declare function sourceSyncDue(state: SourceSyncState, policy: SourceSyncPolicy, now: number, trigger: SourceSyncTrigger): boolean;
+/** Opens a cycle at revision 0: an incremental cycle starts in history, every other mode with a scan. */
+export declare function openSourceSyncCycle(input: SourceSyncCycleInput): SourceSyncCheckpoint;
+/** The store persists this checkpoint and requeues all enqueueIds atomically. */
+export declare function advanceSourceSyncPage(checkpoint: SourceSyncCheckpoint, page: SourceSyncPage, policy: SourceSyncPolicy): SourceSyncPageApplication;
+/** True for applied, gone and skipped work; pending and retry work hold back the cursor. */
+export declare function isTerminalSourceWork(disposition: SourceSyncWorkDisposition): boolean;
+/** No arithmetic or ordering comparison is ever applied to a remote cursor. */
+export declare function committableSourceCursor(checkpoint: SourceSyncCheckpoint, work: SourceSyncWorkSummary): string | null;
+//# sourceMappingURL=state.d.ts.map

package/dist/sync/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/sync/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAAE,eAAe,EAAqC,gBAAgB,EACrF,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EACpF,oBAAoB,EAAE,cAAc,EAAE,yBAAyB,EAC/D,yBAAyB,EAAE,qBAAqB,EACjD,MAAM,YAAY,CAAC;AAiCpB,2FAA2F;AAC3F,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;gBACpB,IAAI,EAAE,qBAAqB,EAAE,OAAO,GAAE,MAAM,GAAG,IAAW;CASvE;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAOrE;AAED,iJAAiJ;AACjJ,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAS1F;AAED,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,GAC/D,eAAe,CAkGjB;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAC3B,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GACxF,OAAO,CAST;AAED,yGAAyG;AACzG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,oBAAoB,CAWrF;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,oBAAoB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,GAC/E,yBAAyB,CAqC3B;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,yBAAyB,GAAG,OAAO,CAEpF;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,oBAAoB,EAAE,IAAI,EAAE,qBAAqB,GAC5D,MAAM,GAAG,IAAI,CAWf"}

package/dist/sync/state.js

@@ -0,0 +1,257 @@
+const integer = (n) => Number.isSafeInteger(n) && n >= 0;
+const positive = (n) => integer(n) && n > 0;
+const key = (s) => typeof s === 'string' && s.length > 0 && s.length <= 1_024;
+const token = (s) => s === null || key(s);
+const failures = [
+    'network', 'rate_limited', 'provider_unavailable', 'storage_unavailable',
+    'grant_rejected', 'insufficient_scope', 'domain_policy', 'history_expired', 'invalid_response', 'cancelled',
+];
+const increment = (n) => {
+    if (!integer(n) || !integer(n + 1))
+        throw new Error('source_sync_counter_exhausted');
+    return n + 1;
+};
+const zeroProgress = () => ({ examined: 0, committed: 0, skipped: 0, bounded: false });
+const noUse = () => ({ searchAskEnabled: false, liveEnabled: false });
+function validUse(use) {
+    return typeof use.searchAskEnabled === 'boolean' && typeof use.liveEnabled === 'boolean';
+}
+function validProgress(progress) {
+    return integer(progress.examined) && integer(progress.committed) && integer(progress.skipped)
+        && typeof progress.bounded === 'boolean';
+}
+function frozen(state) {
+    return Object.freeze({
+        ...state, scope: Object.freeze({ ...state.scope }),
+        use: Object.freeze({ ...state.use }), progress: Object.freeze({ ...state.progress }),
+    });
+}
+function requireTransition(condition) {
+    if (!condition)
+        throw new Error('invalid_source_transition');
+}
+/** Fixed failure code only. Never pass provider messages, HTTP bodies or nested causes. */
+export class SourceSyncFault extends Error {
+    code;
+    retryAt;
+    constructor(code, retryAt = null) {
+        if (!failures.includes(code) || (retryAt !== null && !integer(retryAt))) {
+            throw new Error('invalid_source_sync_fault');
+        }
+        super(`source_sync_${code}`);
+        this.name = 'SourceSyncFault';
+        this.code = code;
+        this.retryAt = retryAt;
+    }
+}
+/** Throws `invalid_source_sync_policy` unless every policy value is a positive safe integer. */
+export function assertSourceSyncPolicy(policy) {
+    const values = [
+        policy.windowMs, policy.maxRetainedDocuments, policy.maxHeldCharacters, policy.maxIndexedCharacters,
+        policy.scanPageSize, policy.maxScanPages, policy.maxCandidates, policy.maxChangedPerLease,
+        policy.maxHistoryPagesPerLease, policy.leaseMs, policy.pollMs, policy.manualMinIntervalMs, policy.reconcileMs,
+    ];
+    if (!values.every(positive))
+        throw new Error('invalid_source_sync_policy');
+}
+/** A new connection in `not_connected` at generation 0. Throws `invalid_source_sync_state` for an empty or oversized key or an invalid clock. */
+export function createSourceSyncState(scope, now) {
+    if (![scope.tenantId, scope.ownerId, scope.connectionId].every((value) => key(value) && value.length <= 512) || !integer(now)) {
+        throw new Error('invalid_source_sync_state');
+    }
+    return frozen({
+        scope, status: 'not_connected', generation: 0, revision: 0, paused: false, revalidationRequired: true,
+        use: noUse(), cursor: null, progress: zeroProgress(), lastSyncAt: null,
+        lastRequestedAt: null, nextSyncAt: null, retryAt: null, error: null, updatedAt: now,
+    });
+}
+/** Pure proposal only; the SQL store authorizes and commits it under its lease/owner lock. */
+export function transitionSourceSync(state, event, now) {
+    requireTransition(integer(now) && integer(state.generation) && integer(state.revision));
+    const active = state.status === 'connected' || state.status === 'syncing';
+    let next = { ...state, revision: increment(state.revision), updatedAt: now };
+    switch (event.type) {
+        case 'connect_started':
+            requireTransition(['not_connected', 'disconnected', 'needs_reconnecting'].includes(state.status));
+            next = {
+                ...next, status: 'connecting', generation: increment(state.generation), paused: false, revalidationRequired: true,
+                use: noUse(), cursor: null, progress: zeroProgress(), lastSyncAt: null,
+                lastRequestedAt: null, nextSyncAt: null, retryAt: null, error: null,
+            };
+            break;
+        case 'grant_ready':
+            requireTransition(state.status === 'connecting' && validUse(event.use));
+            next = { ...next, status: 'connected', use: event.use, nextSyncAt: now };
+            break;
+        case 'manual_requested':
+            requireTransition(active && !state.paused);
+            next = { ...next, lastRequestedAt: now, nextSyncAt: now };
+            break;
+        case 'sync_started':
+            requireTransition(active && !state.paused && (state.retryAt === null || now >= state.retryAt));
+            next = { ...next, status: 'syncing', retryAt: null, error: null, progress: zeroProgress() };
+            break;
+        case 'sync_progress':
+            requireTransition(state.status === 'syncing' && !state.paused && validProgress(event.progress));
+            next = { ...next, progress: event.progress };
+            break;
+        case 'sync_succeeded':
+            requireTransition(state.status === 'syncing' && !state.paused && key(event.cursor)
+                && integer(event.nextSyncAt) && event.nextSyncAt >= now);
+            next = {
+                ...next, status: 'connected', cursor: event.cursor, lastSyncAt: now,
+                nextSyncAt: event.nextSyncAt, retryAt: null, error: null, revalidationRequired: false,
+            };
+            break;
+        case 'sync_deferred':
+            requireTransition(state.status === 'syncing' && !state.paused
+                && integer(event.retryAt) && event.retryAt > now
+                && ['network', 'rate_limited', 'provider_unavailable', 'storage_unavailable'].includes(event.reason));
+            next = { ...next, status: 'connected', retryAt: event.retryAt, nextSyncAt: event.retryAt, error: event.reason };
+            break;
+        case 'sync_failed':
+            requireTransition(active && ['domain_policy', 'invalid_response'].includes(event.reason));
+            next = { ...next, status: 'connected', error: event.reason, nextSyncAt: null, retryAt: null };
+            break;
+        case 'grant_lost':
+            requireTransition((active || state.status === 'connecting')
+                && ['grant_rejected', 'insufficient_scope'].includes(event.reason));
+            next = {
+                ...next, status: 'needs_reconnecting', generation: increment(state.generation),
+                cursor: null, use: noUse(), paused: false, progress: zeroProgress(), revalidationRequired: true,
+                nextSyncAt: null, retryAt: null, error: event.reason,
+            };
+            break;
+        case 'disconnect':
+            if (state.status === 'disconnected')
+                return state;
+            next = {
+                ...next, status: 'disconnected', generation: increment(state.generation),
+                cursor: null, use: noUse(), paused: false, progress: zeroProgress(), revalidationRequired: true,
+                nextSyncAt: null, retryAt: null, error: null,
+            };
+            break;
+        case 'pause':
+            requireTransition(active);
+            if (state.paused)
+                return state;
+            next = {
+                ...next, status: 'connected', generation: increment(state.generation),
+                paused: true, nextSyncAt: null, revalidationRequired: true,
+            };
+            break;
+        case 'resume':
+            requireTransition(active);
+            if (!state.paused)
+                return state;
+            next = {
+                ...next, status: 'connected', generation: increment(state.generation),
+                paused: false, nextSyncAt: Math.max(now, state.retryAt ?? now), revalidationRequired: true,
+            };
+            break;
+        case 'policy_changed':
+            requireTransition(active);
+            next = {
+                ...next, status: 'connected', generation: increment(state.generation), cursor: null, revalidationRequired: true,
+                nextSyncAt: state.paused ? null : Math.max(now, state.retryAt ?? now), progress: zeroProgress(),
+            };
+            break;
+        case 'use_changed':
+            requireTransition(active && validUse(event.use));
+            next = {
+                ...next, status: 'connected', generation: increment(state.generation), use: event.use,
+                nextSyncAt: state.paused ? null : Math.max(now, state.retryAt ?? now),
+            };
+            break;
+        default:
+            throw new Error('invalid_source_transition');
+    }
+    return frozen(next);
+}
+/** Lease existence is a separate atomic SQL check, not something this function authorizes. */
+export function sourceSyncDue(state, policy, now, trigger) {
+    assertSourceSyncPolicy(policy);
+    if (!integer(now) || !['connected', 'syncing'].includes(state.status) || state.paused
+        || (state.retryAt !== null && now < state.retryAt))
+        return false;
+    if (trigger === 'manual') {
+        return state.lastRequestedAt === null || (now >= state.lastRequestedAt
+            && now - state.lastRequestedAt >= policy.manualMinIntervalMs);
+    }
+    return trigger === 'scheduled' && state.nextSyncAt !== null && now >= state.nextSyncAt;
+}
+/** Opens a cycle at revision 0: an incremental cycle starts in history, every other mode with a scan. */
+export function openSourceSyncCycle(input) {
+    if (!key(input.cycleId) || !integer(input.generation) || !integer(input.cutoff)
+        || !key(input.fromCursor) || !['bootstrap', 'incremental', 'reconcile', 'recovery'].includes(input.mode)) {
+        throw new Error('invalid_source_sync_checkpoint');
+    }
+    return Object.freeze({
+        cycleId: input.cycleId, generation: input.generation, revision: 0,
+        mode: input.mode, phase: input.mode === 'incremental' ? 'history' : 'scan',
+        cutoff: input.cutoff, fromCursor: input.fromCursor, nextPageToken: null, targetCursor: null,
+        scanPages: 0, candidates: 0, historyPages: 0, bounded: false,
+    });
+}
+/** The store persists this checkpoint and requeues all enqueueIds atomically. */
+export function advanceSourceSyncPage(checkpoint, page, policy) {
+    assertSourceSyncPolicy(policy);
+    const fail = () => { throw new Error('invalid_source_sync_page'); };
+    if (!key(checkpoint.cycleId) || !key(checkpoint.fromCursor) || !integer(checkpoint.generation)
+        || !integer(checkpoint.cutoff) || !integer(checkpoint.revision) || !integer(checkpoint.scanPages) || !integer(checkpoint.candidates)
+        || !integer(checkpoint.historyPages) || !token(page.nextPageToken) || !page.ids.every(key)
+        || (page.nextPageToken !== null && page.nextPageToken === checkpoint.nextPageToken))
+        fail();
+    if (checkpoint.phase === 'scan' && page.kind === 'scan') {
+        if (checkpoint.scanPages >= policy.maxScanPages || checkpoint.candidates >= policy.maxCandidates
+            || page.ids.length > policy.scanPageSize)
+            fail();
+        const remaining = policy.maxCandidates - checkpoint.candidates;
+        const selected = page.ids.slice(0, remaining);
+        const scanPages = increment(checkpoint.scanPages);
+        const candidates = checkpoint.candidates + selected.length;
+        const bounded = selected.length < page.ids.length || (page.nextPageToken !== null
+            && (scanPages >= policy.maxScanPages || candidates >= policy.maxCandidates));
+        const done = page.nextPageToken === null || bounded;
+        return Object.freeze({
+            enqueueIds: Object.freeze([...new Set(selected)]),
+            checkpoint: Object.freeze({
+                ...checkpoint, revision: increment(checkpoint.revision), scanPages, candidates,
+                phase: done ? 'history' : 'scan', nextPageToken: done ? null : page.nextPageToken,
+                targetCursor: null, bounded: checkpoint.bounded || bounded,
+            }),
+        });
+    }
+    if (checkpoint.phase === 'history' && page.kind === 'history' && key(page.cursor)) {
+        return Object.freeze({
+            enqueueIds: Object.freeze([...new Set(page.ids)]),
+            checkpoint: Object.freeze({
+                ...checkpoint, revision: increment(checkpoint.revision), historyPages: increment(checkpoint.historyPages),
+                phase: page.nextPageToken === null ? 'apply' : 'history',
+                nextPageToken: page.nextPageToken, targetCursor: page.cursor,
+            }),
+        });
+    }
+    return fail();
+}
+/** True for applied, gone and skipped work; pending and retry work hold back the cursor. */
+export function isTerminalSourceWork(disposition) {
+    return disposition.kind === 'applied' || disposition.kind === 'gone' || disposition.kind === 'skipped';
+}
+/** No arithmetic or ordering comparison is ever applied to a remote cursor. */
+export function committableSourceCursor(checkpoint, work) {
+    if (!integer(checkpoint.generation) || !integer(checkpoint.revision)
+        || checkpoint.phase !== 'apply' || checkpoint.nextPageToken !== null
+        || checkpoint.targetCursor === null || !key(checkpoint.targetCursor)
+        || work.cycleId !== checkpoint.cycleId || work.generation !== checkpoint.generation
+        || work.checkpointRevision !== checkpoint.revision)
+        return null;
+    const counts = [work.total, work.pending, work.retry, work.applied, work.gone, work.skipped];
+    if (!counts.every(integer) || work.pending !== 0 || work.retry !== 0)
+        return null;
+    const sum = work.applied + work.gone + work.skipped;
+    if (!integer(sum) || sum !== work.total)
+        return null;
+    return checkpoint.targetCursor;
+}
+//# sourceMappingURL=state.js.map

package/dist/sync/state.js.map

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

package/dist/sync/types.d.ts

@@ -0,0 +1,275 @@
+import type { AccountSourceConnector, SourceRead } from '../types.js';
+import type { SourceCacheDecision, SourceCacheSkipReason } from '../cachePolicy.js';
+/** Opaque host-owned keys. Authentication is supplied by the host, never by provider ids. */
+export interface SourceSyncScope {
+    readonly tenantId: string;
+    readonly ownerId: string;
+    readonly connectionId: string;
+}
+/** The six connection states a host shows. Pause is the separate `paused` flag, not a state. */
+export type SourceSyncStatus = 'not_connected' | 'connecting' | 'syncing' | 'connected' | 'needs_reconnecting' | 'disconnected';
+/** The use switches a host applies to a connection's content: search and questions, and live hints. */
+export interface SourceSyncUse {
+    readonly searchAskEnabled: boolean;
+    readonly liveEnabled: boolean;
+}
+/** Transient failures: the committed cursor stays and a later attempt is scheduled. */
+export type SourceSyncRetryReason = 'network' | 'rate_limited' | 'provider_unavailable' | 'storage_unavailable';
+/** Fixed failure codes; a code carries no provider message or response body. */
+export type SourceSyncFailureCode = SourceSyncRetryReason | 'grant_rejected' | 'insufficient_scope' | 'domain_policy' | 'history_expired' | 'invalid_response' | 'cancelled';
+/** Fixed reasons a source is deliberately not retained: cache refusals and selection, decoding, structure and allowance limits. */
+export type SourceSyncSkipReason = SourceCacheSkipReason | 'excluded' | 'out_of_window' | 'excluded_label' | 'no_eligible_content' | 'response_too_large' | 'structure_limit' | 'unsupported_charset' | 'invalid_encoding' | 'document_limit' | 'held_limit' | 'indexing_limit';
+/** Counts describe this connection; they carry no remote response estimates or ids. */
+export interface SourceSyncProgress {
+    readonly examined: number;
+    readonly committed: number;
+    readonly skipped: number;
+    readonly bounded: boolean;
+}
+/** One connection's durable state. Each control change that fences earlier work raises `generation`. */
+export interface SourceSyncState {
+    readonly scope: SourceSyncScope;
+    readonly status: SourceSyncStatus;
+    readonly generation: number;
+    readonly revision: number;
+    readonly paused: boolean;
+    readonly revalidationRequired: boolean;
+    readonly use: SourceSyncUse;
+    readonly cursor: string | null;
+    readonly progress: SourceSyncProgress;
+    readonly lastSyncAt: number | null;
+    readonly lastRequestedAt: number | null;
+    readonly nextSyncAt: number | null;
+    readonly retryAt: number | null;
+    readonly error: SourceSyncFailureCode | null;
+    readonly updatedAt: number;
+}
+/** Values are policy choices. This library does not assert provider service limits. */
+export interface SourceSyncPolicy {
+    readonly windowMs: number;
+    readonly maxRetainedDocuments: number;
+    readonly maxHeldCharacters: number;
+    readonly maxIndexedCharacters: number;
+    readonly scanPageSize: number;
+    readonly maxScanPages: number;
+    readonly maxCandidates: number;
+    readonly maxChangedPerLease: number;
+    readonly maxHistoryPagesPerLease: number;
+    readonly leaseMs: number;
+    readonly pollMs: number;
+    readonly manualMinIntervalMs: number;
+    readonly reconcileMs: number;
+}
+/** Owner epoch is checked separately through the released core derivation fence. */
+export interface SourceSyncLease {
+    readonly scope: SourceSyncScope;
+    readonly generation: number;
+    readonly token: string;
+    readonly expiresAt: number;
+}
+/** Why a cycle runs: a first pass, history from the committed cursor, a reconciliation pass, or recovery after expired history. */
+export type SourceSyncMode = 'bootstrap' | 'incremental' | 'reconcile' | 'recovery';
+/** Where a cycle stands: a bounded scan, history replay, or application of the queued work. */
+export type SourceSyncPhase = 'scan' | 'history' | 'apply';
+/** A cycle's durable resume point. Cursors and page tokens are opaque strings. */
+export interface SourceSyncCheckpoint {
+    readonly cycleId: string;
+    readonly generation: number;
+    readonly revision: number;
+    readonly mode: SourceSyncMode;
+    readonly phase: SourceSyncPhase;
+    readonly cutoff: number;
+    /** Profile anchor before scan, or previously committed cursor for incremental work. */
+    readonly fromCursor: string;
+    /** Resume metadata only. Null at phase boundaries, never a committed history id. */
+    readonly nextPageToken: string | null;
+    readonly targetCursor: string | null;
+    readonly scanPages: number;
+    readonly candidates: number;
+    readonly historyPages: number;
+    readonly bounded: boolean;
+}
+/** What opening a cycle takes: its id, the connection generation, mode, cutoff and starting anchor. */
+export interface SourceSyncCycleInput {
+    readonly cycleId: string;
+    readonly generation: number;
+    readonly mode: SourceSyncMode;
+    readonly cutoff: number;
+    readonly fromCursor: string;
+}
+/** One page of a bounded enumeration: candidate ids and the next page's token. */
+export interface SourceSyncScanPage {
+    readonly kind: 'scan';
+    readonly ids: readonly string[];
+    readonly nextPageToken: string | null;
+}
+/** One page of history: affected ids, the next page's token and the cursor this page reached. */
+export interface SourceSyncHistoryPage {
+    readonly kind: 'history';
+    readonly ids: readonly string[];
+    readonly nextPageToken: string | null;
+    readonly cursor: string;
+}
+/** Either kind of page a provider answers. */
+export type SourceSyncPage = SourceSyncScanPage | SourceSyncHistoryPage;
+/** The checkpoint a page produces and the ids it queues. */
+export interface SourceSyncPageApplication {
+    readonly checkpoint: SourceSyncCheckpoint;
+    /** Upsert pending reads in the same transaction as this checkpoint revision. */
+    readonly enqueueIds: readonly string[];
+}
+/** A queued source's outcome. Applied, gone and skipped are terminal; pending and retry are not. */
+export type SourceSyncWorkDisposition = {
+    readonly kind: 'pending';
+} | {
+    readonly kind: 'retry';
+    readonly reason: SourceSyncRetryReason;
+    readonly retryAt: number;
+} | {
+    readonly kind: 'applied';
+    readonly version: string;
+} | {
+    readonly kind: 'gone';
+} | {
+    readonly kind: 'skipped';
+    readonly reason: SourceSyncSkipReason;
+};
+/** One durable work row: ids, attempts and a disposition, never source content. */
+export interface SourceSyncWork {
+    readonly cycleId: string;
+    readonly generation: number;
+    readonly sourceId: string;
+    /** Re-discovery on a new page invalidates an earlier applied/read result. */
+    readonly discoveredRevision: number;
+    readonly attempts: number;
+    readonly disposition: SourceSyncWorkDisposition;
+}
+/** Complete fresh database aggregate, computed with the checkpoint under its lease lock. */
+export interface SourceSyncWorkSummary {
+    readonly cycleId: string;
+    readonly generation: number;
+    readonly checkpointRevision: number;
+    readonly total: number;
+    readonly pending: number;
+    readonly retry: number;
+    readonly applied: number;
+    readonly gone: number;
+    readonly skipped: number;
+}
+/** Offsets count UTF-16 code units in the sanitized SourceRead.content.text. */
+export interface SourceSyncMessageSpan {
+    readonly messageId: string;
+    readonly start: number;
+    readonly end: number;
+    readonly receivedAt: number;
+    readonly windowExpiresAt: number;
+    readonly truncated: boolean;
+}
+/** A JSON value for document metadata. */
+export type SourceSyncJson = null | boolean | number | string | readonly SourceSyncJson[] | {
+    readonly [key: string]: SourceSyncJson;
+};
+/** Normalized, sanitized content only; transient provider responses never enter this shape. */
+export interface SourceSyncDocument {
+    readonly read: SourceRead & {
+        readonly content: {
+            readonly text: string;
+        };
+    };
+    readonly messages: readonly SourceSyncMessageSpan[];
+    readonly metadata: Readonly<Record<string, SourceSyncJson>>;
+    readonly activityAt: number;
+    readonly contentHash: string;
+    readonly cache: Extract<SourceCacheDecision, {
+        kind: 'cache';
+    }>;
+}
+/** What reading one queued source answers: a document, gone, a deliberate skip or a retry. */
+export type SourceSyncReadResult = {
+    readonly kind: 'document';
+    readonly document: SourceSyncDocument;
+} | {
+    readonly kind: 'gone';
+    readonly id: string;
+} | {
+    readonly kind: 'skipped';
+    readonly id: string;
+    readonly reason: SourceSyncSkipReason;
+} | {
+    readonly kind: 'retry';
+    readonly id: string;
+    readonly reason: SourceSyncRetryReason;
+    readonly retryAt: number;
+};
+/** Provider request context is process memory, never a serialized queued HTTP request. */
+export interface SourceSyncRequest {
+    readonly scope: SourceSyncScope;
+    readonly generation: number;
+    readonly cycleId: string;
+    readonly cutoff: number;
+    readonly policy: SourceSyncPolicy;
+    readonly signal?: AbortSignal;
+}
+/** One instance is bound to one grant. These calls do no database commit. */
+export interface AccountSourceSyncProvider {
+    readonly kind: string;
+    begin(request: SourceSyncRequest): Promise<string>;
+    scanPage(request: SourceSyncRequest, pageToken: string | null): Promise<SourceSyncScanPage>;
+    historyPage(request: SourceSyncRequest, fromCursor: string, pageToken: string | null): Promise<SourceSyncHistoryPage>;
+    readSource(request: SourceSyncRequest, sourceId: string): Promise<SourceSyncReadResult>;
+}
+/** Optional capability. An empty selection in the original interface keeps its original meaning. */
+export interface ResumableAccountSourceConnector extends AccountSourceConnector {
+    readonly sync: AccountSourceSyncProvider;
+}
+/** A safe event sink accepts only these fields. Scope and provider payloads are excluded. */
+export interface SourceSyncEvent {
+    readonly kind: 'source_sync';
+    readonly state: 'started' | 'progress' | 'yielded' | 'succeeded' | 'retry' | 'reconnect' | 'purged';
+    readonly n: number;
+    readonly ms?: number;
+}
+/** Receives content-free sync events. */
+export type SourceSyncEventSink = (event: SourceSyncEvent) => void;
+/** Whether a sync was scheduled or asked for by the person. */
+export type SourceSyncTrigger = 'scheduled' | 'manual';
+/** The events that move a connection between states. */
+export type SourceSyncTransition = {
+    readonly type: 'connect_started';
+} | {
+    readonly type: 'grant_ready';
+    readonly use: SourceSyncUse;
+} | {
+    readonly type: 'manual_requested';
+} | {
+    readonly type: 'sync_started';
+} | {
+    readonly type: 'sync_progress';
+    readonly progress: SourceSyncProgress;
+} | {
+    readonly type: 'sync_succeeded';
+    readonly cursor: string;
+    readonly nextSyncAt: number;
+} | {
+    readonly type: 'sync_deferred';
+    readonly reason: SourceSyncRetryReason;
+    readonly retryAt: number;
+} | {
+    readonly type: 'sync_failed';
+    readonly reason: 'domain_policy' | 'invalid_response';
+} | {
+    readonly type: 'grant_lost';
+    readonly reason: 'grant_rejected' | 'insufficient_scope';
+} | {
+    readonly type: 'disconnect';
+} | {
+    readonly type: 'pause';
+} | {
+    readonly type: 'resume';
+} | {
+    readonly type: 'policy_changed';
+} | {
+    readonly type: 'use_changed';
+    readonly use: SourceSyncUse;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/sync/types.d.ts.map

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

package/dist/sync/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":""}

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.2.0",
+  "version": "0.3.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.2.0",
+  "version": "0.3.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",