@code-yeongyu/senpi 2026.7.31 → 2026.8.3

package/dist/core/extensions/builtin/claude-sdk-oauth/session-continuity.d.ts

@@ -0,0 +1,81 @@
+import type { ContinuityReason } from "./session-observability.ts";
+export type ContinuityEntrySnapshot = {
+    sdkSessionId: string;
+    accountName: string;
+    modelId: string;
+    systemPromptHash: string;
+    toolsetHash: string;
+    sentCount: number;
+    sentHashes: readonly string[];
+    lastAssistantUuid: string | null;
+    assistantUuidByIndex: ReadonlyMap<number, string>;
+    pendingForkReason: string | null;
+    taintedReason?: string | null;
+};
+export type ContinuityBindingSnapshot = {
+    sdkSessionId: string;
+    sentCount: number;
+    sentHashes: readonly string[];
+    lastAssistantUuid: string | null;
+    accountName: string;
+    modelId: string;
+    systemPromptHash: string;
+    toolsetHash: string;
+};
+export type ContinuityDecisionInput = {
+    entry: ContinuityEntrySnapshot | undefined;
+    binding: ContinuityBindingSnapshot | undefined;
+    currentHashes: readonly string[];
+    accountName: string;
+    modelId: string;
+    fingerprint: {
+        systemPromptHash: string;
+        toolsetHash: string;
+    };
+    transcriptAvailable: boolean;
+    idleExpired?: boolean;
+};
+export type ContinuityDecision = {
+    kind: "bootstrap";
+} | {
+    kind: "delta";
+    from: number;
+} | {
+    kind: "reattach";
+    sdkSessionId: string;
+    from: number;
+    reason: ContinuityReason;
+} | {
+    kind: "fork";
+    sdkSessionId: string;
+    atUuid: string;
+    from: number;
+    reason: ContinuityReason;
+} | {
+    kind: "flatten";
+    reason: ContinuityReason;
+};
+export type FailoverLane = "oauth-slots" | "ambient" | "config-dir";
+export type FailoverContinuityInput = {
+    authLane: FailoverLane;
+    crossAccountResumeSupported: boolean;
+    entry: {
+        sdkSessionId: string;
+        sentCount: number;
+        lastAssistantUuid: string | null;
+    };
+};
+/**
+ * The config-dir lane keeps each account's credentials inside its own
+ * CLAUDE_CONFIG_DIR, and no official SDK API moves a transcript across roots, so
+ * its failover is the one declared residual that must still flatten.
+ */
+export declare function decideFailoverContinuity(input: FailoverContinuityInput): ContinuityDecision;
+/**
+ * Resume-first: a live session is never abandoned for a flattened re-send. Only a
+ * missing transcript or an unrecoverable boundary reaches `flatten`; every other
+ * divergence resolves to `fork` (same lineage, new branch) or `reattach` (same
+ * session, new query).
+ */
+export declare function decideNativeContinuity(input: ContinuityDecisionInput): ContinuityDecision;
+//# sourceMappingURL=session-continuity.d.ts.map

package/dist/core/extensions/builtin/claude-sdk-oauth/session-continuity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-continuity.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/claude-sdk-oauth/session-continuity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,MAAM,uBAAuB,GAAG;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACrC,KAAK,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC3C,OAAO,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAC/C,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC3B;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAqEjD,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAEpE,MAAM,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,2BAA2B,EAAE,OAAO,CAAC;IACrC,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACrF,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAmB3F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CA8BzF"}

package/dist/core/extensions/builtin/claude-sdk-oauth/session-continuity.js

@@ -0,0 +1,127 @@
+const PENDING_FORK_REASONS = {
+    assistant_rewritten: "assistant_rewritten",
+    compaction: "tainted_compaction",
+    fork: "tainted_fork",
+    abort: "tainted_abort",
+};
+function commonPrefixLength(left, right) {
+    const limit = Math.min(left.length, right.length);
+    let index = 0;
+    while (index < limit && left[index] === right[index])
+        index += 1;
+    return index;
+}
+/**
+ * The fork point is the last assistant boundary STRICTLY BEFORE the divergence:
+ * forking at the diverged turn itself would carry the stale assistant into the new
+ * branch and leave nothing to re-send.
+ */
+function boundaryBefore(entry, count) {
+    for (let candidate = count - 1; candidate >= 1; candidate -= 1) {
+        const uuid = entry.assistantUuidByIndex.get(candidate);
+        if (uuid)
+            return { index: candidate, uuid };
+    }
+    return undefined;
+}
+function forkOrFlatten(entry, divergesAt, reason) {
+    const boundary = boundaryBefore(entry, divergesAt);
+    if (!boundary)
+        return { kind: "flatten", reason };
+    return {
+        kind: "fork",
+        sdkSessionId: entry.sdkSessionId,
+        atUuid: boundary.uuid,
+        from: boundary.index,
+        reason,
+    };
+}
+function identityDrift(input, entry) {
+    if (entry.accountName !== input.accountName)
+        return "account_changed";
+    if (entry.modelId !== input.modelId)
+        return "model_changed";
+    if (entry.systemPromptHash !== input.fingerprint.systemPromptHash)
+        return "options_changed";
+    if (entry.toolsetHash !== input.fingerprint.toolsetHash)
+        return "options_changed";
+    return null;
+}
+function decideFromBinding(input, binding) {
+    if (!input.transcriptAvailable)
+        return { kind: "flatten", reason: "transcript_missing" };
+    const shared = commonPrefixLength(binding.sentHashes, input.currentHashes);
+    if (shared === binding.sentCount) {
+        return { kind: "reattach", sdkSessionId: binding.sdkSessionId, from: binding.sentCount, reason: "registry_miss" };
+    }
+    if (!binding.lastAssistantUuid)
+        return { kind: "flatten", reason: "registry_miss" };
+    return {
+        kind: "fork",
+        sdkSessionId: binding.sdkSessionId,
+        atUuid: binding.lastAssistantUuid,
+        from: shared,
+        reason: shared < binding.sentCount ? "history_rolled_back" : "sent_stream_diverged",
+    };
+}
+/**
+ * The config-dir lane keeps each account's credentials inside its own
+ * CLAUDE_CONFIG_DIR, and no official SDK API moves a transcript across roots, so
+ * its failover is the one declared residual that must still flatten.
+ */
+export function decideFailoverContinuity(input) {
+    const { entry } = input;
+    if (input.authLane === "config-dir")
+        return { kind: "flatten", reason: "cross_root_unsupported" };
+    if (input.crossAccountResumeSupported) {
+        return {
+            kind: "reattach",
+            sdkSessionId: entry.sdkSessionId,
+            from: entry.sentCount,
+            reason: "account_changed",
+        };
+    }
+    if (!entry.lastAssistantUuid)
+        return { kind: "flatten", reason: "branch_boundary_unavailable" };
+    return {
+        kind: "fork",
+        sdkSessionId: entry.sdkSessionId,
+        atUuid: entry.lastAssistantUuid,
+        from: entry.sentCount,
+        reason: "account_changed",
+    };
+}
+/**
+ * Resume-first: a live session is never abandoned for a flattened re-send. Only a
+ * missing transcript or an unrecoverable boundary reaches `flatten`; every other
+ * divergence resolves to `fork` (same lineage, new branch) or `reattach` (same
+ * session, new query).
+ */
+export function decideNativeContinuity(input) {
+    const { entry, binding } = input;
+    if (!entry) {
+        if (!binding)
+            return { kind: "bootstrap" };
+        return decideFromBinding(input, binding);
+    }
+    const divergence = entry.pendingForkReason ?? entry.taintedReason;
+    if (divergence) {
+        return forkOrFlatten(entry, entry.sentCount, PENDING_FORK_REASONS[divergence] ?? "other");
+    }
+    const shared = commonPrefixLength(entry.sentHashes, input.currentHashes);
+    if (shared < entry.sentCount) {
+        const rolledBack = input.currentHashes.length < entry.sentCount && shared === input.currentHashes.length;
+        return rolledBack
+            ? forkOrFlatten(entry, input.currentHashes.length, "history_rolled_back")
+            : forkOrFlatten(entry, shared + 1, "sent_stream_diverged");
+    }
+    if (input.idleExpired) {
+        return { kind: "reattach", sdkSessionId: entry.sdkSessionId, from: entry.sentCount, reason: "idle_ttl" };
+    }
+    const drift = identityDrift(input, entry);
+    if (drift) {
+        return { kind: "reattach", sdkSessionId: entry.sdkSessionId, from: entry.sentCount, reason: drift };
+    }
+    return { kind: "delta", from: entry.sentCount };
+}
+//# sourceMappingURL=session-continuity.js.map

package/dist/core/extensions/builtin/claude-sdk-oauth/session-continuity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-continuity.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/claude-sdk-oauth/session-continuity.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContinuityReason } from \"./session-observability.ts\";\n\nexport type ContinuityEntrySnapshot = {\n\tsdkSessionId: string;\n\taccountName: string;\n\tmodelId: string;\n\tsystemPromptHash: string;\n\ttoolsetHash: string;\n\tsentCount: number;\n\tsentHashes: readonly string[];\n\tlastAssistantUuid: string | null;\n\tassistantUuidByIndex: ReadonlyMap<number, string>;\n\tpendingForkReason: string | null;\n\ttaintedReason?: string | null;\n};\n\nexport type ContinuityBindingSnapshot = {\n\tsdkSessionId: string;\n\tsentCount: number;\n\tsentHashes: readonly string[];\n\tlastAssistantUuid: string | null;\n\taccountName: string;\n\tmodelId: string;\n\tsystemPromptHash: string;\n\ttoolsetHash: string;\n};\n\nexport type ContinuityDecisionInput = {\n\tentry: ContinuityEntrySnapshot | undefined;\n\tbinding: ContinuityBindingSnapshot | undefined;\n\tcurrentHashes: readonly string[];\n\taccountName: string;\n\tmodelId: string;\n\tfingerprint: { systemPromptHash: string; toolsetHash: string };\n\ttranscriptAvailable: boolean;\n\tidleExpired?: boolean;\n};\n\nexport type ContinuityDecision =\n\t| { kind: \"bootstrap\" }\n\t| { kind: \"delta\"; from: number }\n\t| { kind: \"reattach\"; sdkSessionId: string; from: number; reason: ContinuityReason }\n\t| { kind: \"fork\"; sdkSessionId: string; atUuid: string; from: number; reason: ContinuityReason }\n\t| { kind: \"flatten\"; reason: ContinuityReason };\n\nconst PENDING_FORK_REASONS: Readonly<Record<string, ContinuityReason>> = {\n\tassistant_rewritten: \"assistant_rewritten\",\n\tcompaction: \"tainted_compaction\",\n\tfork: \"tainted_fork\",\n\tabort: \"tainted_abort\",\n};\n\nfunction commonPrefixLength(left: readonly string[], right: readonly string[]): number {\n\tconst limit = Math.min(left.length, right.length);\n\tlet index = 0;\n\twhile (index < limit && left[index] === right[index]) index += 1;\n\treturn index;\n}\n\n/**\n * The fork point is the last assistant boundary STRICTLY BEFORE the divergence:\n * forking at the diverged turn itself would carry the stale assistant into the new\n * branch and leave nothing to re-send.\n */\nfunction boundaryBefore(entry: ContinuityEntrySnapshot, count: number): { index: number; uuid: string } | undefined {\n\tfor (let candidate = count - 1; candidate >= 1; candidate -= 1) {\n\t\tconst uuid = entry.assistantUuidByIndex.get(candidate);\n\t\tif (uuid) return { index: candidate, uuid };\n\t}\n\treturn undefined;\n}\n\nfunction forkOrFlatten(\n\tentry: ContinuityEntrySnapshot,\n\tdivergesAt: number,\n\treason: ContinuityReason,\n): ContinuityDecision {\n\tconst boundary = boundaryBefore(entry, divergesAt);\n\tif (!boundary) return { kind: \"flatten\", reason };\n\treturn {\n\t\tkind: \"fork\",\n\t\tsdkSessionId: entry.sdkSessionId,\n\t\tatUuid: boundary.uuid,\n\t\tfrom: boundary.index,\n\t\treason,\n\t};\n}\n\nfunction identityDrift(input: ContinuityDecisionInput, entry: ContinuityEntrySnapshot): ContinuityReason | null {\n\tif (entry.accountName !== input.accountName) return \"account_changed\";\n\tif (entry.modelId !== input.modelId) return \"model_changed\";\n\tif (entry.systemPromptHash !== input.fingerprint.systemPromptHash) return \"options_changed\";\n\tif (entry.toolsetHash !== input.fingerprint.toolsetHash) return \"options_changed\";\n\treturn null;\n}\n\nfunction decideFromBinding(input: ContinuityDecisionInput, binding: ContinuityBindingSnapshot): ContinuityDecision {\n\tif (!input.transcriptAvailable) return { kind: \"flatten\", reason: \"transcript_missing\" };\n\tconst shared = commonPrefixLength(binding.sentHashes, input.currentHashes);\n\tif (shared === binding.sentCount) {\n\t\treturn { kind: \"reattach\", sdkSessionId: binding.sdkSessionId, from: binding.sentCount, reason: \"registry_miss\" };\n\t}\n\tif (!binding.lastAssistantUuid) return { kind: \"flatten\", reason: \"registry_miss\" };\n\treturn {\n\t\tkind: \"fork\",\n\t\tsdkSessionId: binding.sdkSessionId,\n\t\tatUuid: binding.lastAssistantUuid,\n\t\tfrom: shared,\n\t\treason: shared < binding.sentCount ? \"history_rolled_back\" : \"sent_stream_diverged\",\n\t};\n}\n\nexport type FailoverLane = \"oauth-slots\" | \"ambient\" | \"config-dir\";\n\nexport type FailoverContinuityInput = {\n\tauthLane: FailoverLane;\n\tcrossAccountResumeSupported: boolean;\n\tentry: { sdkSessionId: string; sentCount: number; lastAssistantUuid: string | null };\n};\n\n/**\n * The config-dir lane keeps each account's credentials inside its own\n * CLAUDE_CONFIG_DIR, and no official SDK API moves a transcript across roots, so\n * its failover is the one declared residual that must still flatten.\n */\nexport function decideFailoverContinuity(input: FailoverContinuityInput): ContinuityDecision {\n\tconst { entry } = input;\n\tif (input.authLane === \"config-dir\") return { kind: \"flatten\", reason: \"cross_root_unsupported\" };\n\tif (input.crossAccountResumeSupported) {\n\t\treturn {\n\t\t\tkind: \"reattach\",\n\t\t\tsdkSessionId: entry.sdkSessionId,\n\t\t\tfrom: entry.sentCount,\n\t\t\treason: \"account_changed\",\n\t\t};\n\t}\n\tif (!entry.lastAssistantUuid) return { kind: \"flatten\", reason: \"branch_boundary_unavailable\" };\n\treturn {\n\t\tkind: \"fork\",\n\t\tsdkSessionId: entry.sdkSessionId,\n\t\tatUuid: entry.lastAssistantUuid,\n\t\tfrom: entry.sentCount,\n\t\treason: \"account_changed\",\n\t};\n}\n\n/**\n * Resume-first: a live session is never abandoned for a flattened re-send. Only a\n * missing transcript or an unrecoverable boundary reaches `flatten`; every other\n * divergence resolves to `fork` (same lineage, new branch) or `reattach` (same\n * session, new query).\n */\nexport function decideNativeContinuity(input: ContinuityDecisionInput): ContinuityDecision {\n\tconst { entry, binding } = input;\n\tif (!entry) {\n\t\tif (!binding) return { kind: \"bootstrap\" };\n\t\treturn decideFromBinding(input, binding);\n\t}\n\n\tconst divergence = entry.pendingForkReason ?? entry.taintedReason;\n\tif (divergence) {\n\t\treturn forkOrFlatten(entry, entry.sentCount, PENDING_FORK_REASONS[divergence] ?? \"other\");\n\t}\n\n\tconst shared = commonPrefixLength(entry.sentHashes, input.currentHashes);\n\tif (shared < entry.sentCount) {\n\t\tconst rolledBack = input.currentHashes.length < entry.sentCount && shared === input.currentHashes.length;\n\t\treturn rolledBack\n\t\t\t? forkOrFlatten(entry, input.currentHashes.length, \"history_rolled_back\")\n\t\t\t: forkOrFlatten(entry, shared + 1, \"sent_stream_diverged\");\n\t}\n\n\tif (input.idleExpired) {\n\t\treturn { kind: \"reattach\", sdkSessionId: entry.sdkSessionId, from: entry.sentCount, reason: \"idle_ttl\" };\n\t}\n\n\tconst drift = identityDrift(input, entry);\n\tif (drift) {\n\t\treturn { kind: \"reattach\", sdkSessionId: entry.sdkSessionId, from: entry.sentCount, reason: drift };\n\t}\n\n\treturn { kind: \"delta\", from: entry.sentCount };\n}\n"]}

package/dist/core/extensions/builtin/claude-sdk-oauth/session-entry-annotations.d.ts

@@ -0,0 +1,10 @@
+import type { ClaudeSdkOauthSessionEntry, SessionBranchInfo } from "./session-registry.ts";
+export type AnnotatableRegistry = {
+    get(senpiSessionId: string): ClaudeSdkOauthSessionEntry | undefined;
+    touch(entry: ClaudeSdkOauthSessionEntry): void;
+};
+export declare function switchEntryModel(registry: AnnotatableRegistry, senpiSessionId: string, modelId: string): Promise<boolean>;
+export declare function annotatePendingFork(registry: AnnotatableRegistry, senpiSessionId: string, reason: string): void;
+export declare function annotateTainted(registry: AnnotatableRegistry, senpiSessionId: string, reason: string): void;
+export declare function annotateBranchInfo(registry: AnnotatableRegistry, senpiSessionId: string, info: SessionBranchInfo): void;
+//# sourceMappingURL=session-entry-annotations.d.ts.map

package/dist/core/extensions/builtin/claude-sdk-oauth/session-entry-annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-entry-annotations.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/claude-sdk-oauth/session-entry-annotations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG3F,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,CAAC,cAAc,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAAC;IACpE,KAAK,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC/C,CAAC;AAEF,wBAAsB,gBAAgB,CACrC,QAAQ,EAAE,mBAAmB,EAC7B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAK/G;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM3G;AAED,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,iBAAiB,GACrB,IAAI,CAKN"}

package/dist/core/extensions/builtin/claude-sdk-oauth/session-entry-annotations.js

@@ -0,0 +1,34 @@
+import { transitionToTainted } from "./session-registry-state.js";
+export async function switchEntryModel(registry, senpiSessionId, modelId) {
+    const entry = registry.get(senpiSessionId);
+    if (!entry?.query.setModel)
+        return false;
+    await entry.query.setModel(modelId);
+    entry.modelId = modelId;
+    registry.touch(entry);
+    return true;
+}
+export function annotatePendingFork(registry, senpiSessionId, reason) {
+    const entry = registry.get(senpiSessionId);
+    if (!entry)
+        return;
+    entry.pendingForkReason = reason;
+    registry.touch(entry);
+}
+export function annotateTainted(registry, senpiSessionId, reason) {
+    const entry = registry.get(senpiSessionId);
+    if (!entry)
+        return;
+    entry.taintedReason = reason;
+    if (entry.state !== "TAINTED")
+        transitionToTainted(entry);
+    registry.touch(entry);
+}
+export function annotateBranchInfo(registry, senpiSessionId, info) {
+    const entry = registry.get(senpiSessionId);
+    if (!entry)
+        return;
+    entry.branchInfo = { ...info };
+    registry.touch(entry);
+}
+//# sourceMappingURL=session-entry-annotations.js.map

package/dist/core/extensions/builtin/claude-sdk-oauth/session-entry-annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-entry-annotations.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/claude-sdk-oauth/session-entry-annotations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAOlE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,QAA6B,EAC7B,cAAsB,EACtB,OAAe;IAEf,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAA6B,EAAE,cAAsB,EAAE,MAAc;IACxG,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,KAAK,CAAC,iBAAiB,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA6B,EAAE,cAAsB,EAAE,MAAc;IACpG,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;IAC7B,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC1D,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,kBAAkB,CACjC,QAA6B,EAC7B,cAAsB,EACtB,IAAuB;IAEvB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,KAAK,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC","sourcesContent":["import type { ClaudeSdkOauthSessionEntry, SessionBranchInfo } from \"./session-registry.ts\";\nimport { transitionToTainted } from \"./session-registry-state.ts\";\n\nexport type AnnotatableRegistry = {\n\tget(senpiSessionId: string): ClaudeSdkOauthSessionEntry | undefined;\n\ttouch(entry: ClaudeSdkOauthSessionEntry): void;\n};\n\nexport async function switchEntryModel(\n\tregistry: AnnotatableRegistry,\n\tsenpiSessionId: string,\n\tmodelId: string,\n): Promise<boolean> {\n\tconst entry = registry.get(senpiSessionId);\n\tif (!entry?.query.setModel) return false;\n\tawait entry.query.setModel(modelId);\n\tentry.modelId = modelId;\n\tregistry.touch(entry);\n\treturn true;\n}\n\nexport function annotatePendingFork(registry: AnnotatableRegistry, senpiSessionId: string, reason: string): void {\n\tconst entry = registry.get(senpiSessionId);\n\tif (!entry) return;\n\tentry.pendingForkReason = reason;\n\tregistry.touch(entry);\n}\n\nexport function annotateTainted(registry: AnnotatableRegistry, senpiSessionId: string, reason: string): void {\n\tconst entry = registry.get(senpiSessionId);\n\tif (!entry) return;\n\tentry.taintedReason = reason;\n\tif (entry.state !== \"TAINTED\") transitionToTainted(entry);\n\tregistry.touch(entry);\n}\n\nexport function annotateBranchInfo(\n\tregistry: AnnotatableRegistry,\n\tsenpiSessionId: string,\n\tinfo: SessionBranchInfo,\n): void {\n\tconst entry = registry.get(senpiSessionId);\n\tif (!entry) return;\n\tentry.branchInfo = { ...info };\n\tregistry.touch(entry);\n}\n"]}

package/dist/core/extensions/builtin/claude-sdk-oauth/session-observability.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Per-turn continuity observability for the claude-sdk-oauth lane.
+ *
+ * Emission semantics: a decision is STAGED per attempt at its final outcome
+ * point and EMITTED only when the auth-lane retain/discard wrapper retains that
+ * attempt (auth-attempt.ts). A discarded attempt emits nothing, so every
+ * completed turn yields exactly one observation; a turn where every attempt
+ * fails yields one terminal error observation instead.
+ */
+export type ContinuityKind = "bootstrap" | "delta" | "reattach" | "fork" | "flatten" | "disabled";
+/** Fixed vocabulary — arbitrary error text never reaches an observation. */
+export type ContinuityReason = "prefix_matched" | "registry_miss" | "idle_ttl" | "capacity" | "model_selected" | "thinking_level_selected" | "bound_account_token_expiring" | "account_changed" | "model_changed" | "toolset_changed" | "system_prompt_changed" | "assistant_stream_diverged" | "sent_stream_diverged" | "options_changed" | "history_rolled_back" | "assistant_rewritten" | "transcript_missing" | "cross_root_unsupported" | "branch_diverged" | "branch_boundary_unavailable" | "branch_resume" | "tainted_compaction" | "tainted_fork" | "tainted_abort" | "tainted_assistant_provenance_unverified" | "resume_initialization_failed" | "resume_initialization_aborted" | "resume_mode_off" | "query_failed" | "turn_attribution_failed" | "abort_timeout" | "extensions_removed" | "session_shutdown" | "other";
+export type ContinuityObservation = {
+    kind: ContinuityKind;
+    reason: ContinuityReason;
+    deltaMessages?: number;
+};
+export type ContinuityObservabilityBoundary = {
+    emit: (observation: ContinuityObservation) => void;
+    log: (event: string, data: Record<string, unknown>) => void;
+};
+export declare function overrideContinuityObservabilityBoundary(override: Partial<ContinuityObservabilityBoundary>): void;
+export declare function resetContinuityObservabilityBoundary(): void;
+/** Maps a fixed vocabulary member through, and anything else to a bucketed cause. */
+export declare function sanitizeReason(value: unknown): ContinuityReason;
+/** Buckets arbitrary close/pump failures into the fixed close-cause vocabulary. */
+export declare function sanitizeCloseCause(value: unknown): ContinuityReason;
+/**
+ * Classifies the failure that ended a turn after every auth attempt failed.
+ * Anything reaching here came out of the SDK query path, so an Error is a query
+ * failure unless it matches a more specific bucket; the raw text never escapes.
+ */
+export declare function sanitizeTerminalFailure(value: unknown): ContinuityReason;
+export declare function recordPendingCloseCause(senpiSessionId: string, reason: unknown): void;
+/** Read the pending close cause WITHOUT consuming it (consumed at emit time). */
+export declare function peekPendingCloseCause(senpiSessionId: string): ContinuityReason | undefined;
+export declare function consumePendingCloseCause(senpiSessionId: string): ContinuityReason | undefined;
+/**
+ * Maps the continuity decision families onto the observation vocabulary:
+ * incremental→delta, resume→fork, cold-seed→flatten.
+ */
+export declare function observeSessionSyncDecision(input: {
+    kind: "incremental" | "resume" | "cold-seed";
+    reason?: string;
+    deltaMessages: number;
+    firstTurn: boolean;
+    senpiSessionId: string;
+}): ContinuityObservation;
+export type StagedContinuityDecision = {
+    observation: ContinuityObservation;
+    emit: () => void;
+};
+/** Stages an attempt's decision; `emit` fires only when the attempt is retained. */
+export declare function stageContinuityDecision(observation: ContinuityObservation, onDecision?: (observation: ContinuityObservation) => void, beforeEmit?: () => void): StagedContinuityDecision;
+export declare function emitContinuityObservation(observation: ContinuityObservation, onDecision?: (observation: ContinuityObservation) => void): void;
+//# sourceMappingURL=session-observability.d.ts.map

package/dist/core/extensions/builtin/claude-sdk-oauth/session-observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-observability.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/claude-sdk-oauth/session-observability.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAElG,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GACzB,gBAAgB,GAChB,eAAe,GACf,UAAU,GACV,UAAU,GACV,gBAAgB,GAChB,yBAAyB,GACzB,8BAA8B,GAC9B,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,uBAAuB,GACvB,2BAA2B,GAC3B,sBAAsB,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,qBAAqB,GACrB,oBAAoB,GACpB,wBAAwB,GACxB,iBAAiB,GACjB,6BAA6B,GAC7B,eAAe,GACf,oBAAoB,GACpB,cAAc,GACd,eAAe,GACf,yCAAyC,GACzC,8BAA8B,GAC9B,+BAA+B,GAC/B,iBAAiB,GACjB,cAAc,GACd,yBAAyB,GACzB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,OAAO,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC7C,IAAI,EAAE,CAAC,WAAW,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACnD,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC5D,CAAC;AAoDF,wBAAgB,uCAAuC,CAAC,QAAQ,EAAE,OAAO,CAAC,+BAA+B,CAAC,GAAG,IAAI,CAEhH;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAS/D;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CASnE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAIxE;AAaD,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAUrF;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE1F;AAED,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAI7F;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IACjD,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACvB,GAAG,qBAAqB,CAuBxB;AAED,MAAM,MAAM,wBAAwB,GAAG;IACtC,WAAW,EAAE,qBAAqB,CAAC;IACnC,IAAI,EAAE,MAAM,IAAI,CAAC;CACjB,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,uBAAuB,CACtC,WAAW,EAAE,qBAAqB,EAClC,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,qBAAqB,KAAK,IAAI,EACzD,UAAU,CAAC,EAAE,MAAM,IAAI,GACrB,wBAAwB,CAW1B;AAED,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,qBAAqB,EAClC,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,qBAAqB,KAAK,IAAI,GACvD,IAAI,CAQN"}

package/dist/core/extensions/builtin/claude-sdk-oauth/session-observability.js

@@ -0,0 +1,174 @@
+import { getAgentDir } from "../../../../config.js";
+import { createSessionLogger } from "../../../session-log.js";
+const SANITIZED_REASONS = new Set([
+    "prefix_matched",
+    "registry_miss",
+    "idle_ttl",
+    "capacity",
+    "model_selected",
+    "thinking_level_selected",
+    "bound_account_token_expiring",
+    "account_changed",
+    "model_changed",
+    "toolset_changed",
+    "system_prompt_changed",
+    "assistant_stream_diverged",
+    "options_changed",
+    "history_rolled_back",
+    "assistant_rewritten",
+    "transcript_missing",
+    "cross_root_unsupported",
+    "sent_stream_diverged",
+    "branch_diverged",
+    "branch_boundary_unavailable",
+    "branch_resume",
+    "tainted_compaction",
+    "tainted_fork",
+    "tainted_abort",
+    "tainted_assistant_provenance_unverified",
+    "resume_initialization_failed",
+    "resume_initialization_aborted",
+    "resume_mode_off",
+    "query_failed",
+    "turn_attribution_failed",
+    "abort_timeout",
+    "extensions_removed",
+    "session_shutdown",
+    "other",
+]);
+let cachedLogger;
+function sessionLogger() {
+    cachedLogger ??= createSessionLogger(getAgentDir());
+    return cachedLogger;
+}
+const defaultBoundary = {
+    emit: () => { },
+    log: (event, data) => sessionLogger().info(event, data),
+};
+let activeBoundary = defaultBoundary;
+export function overrideContinuityObservabilityBoundary(override) {
+    activeBoundary = { ...defaultBoundary, ...override };
+}
+export function resetContinuityObservabilityBoundary() {
+    activeBoundary = defaultBoundary;
+}
+/** Maps a fixed vocabulary member through, and anything else to a bucketed cause. */
+export function sanitizeReason(value) {
+    const text = typeof value === "string" ? value : value instanceof Error ? value.message : "";
+    if (SANITIZED_REASONS.has(text))
+        return text;
+    const tainted = /^tainted:(.+)$/.exec(text);
+    if (tainted) {
+        const mapped = `tainted_${tainted[1]}`;
+        if (SANITIZED_REASONS.has(mapped))
+            return mapped;
+    }
+    return sanitizeCloseCause(value);
+}
+/** Buckets arbitrary close/pump failures into the fixed close-cause vocabulary. */
+export function sanitizeCloseCause(value) {
+    const text = typeof value === "string" ? value : value instanceof Error ? value.message : "";
+    if (SANITIZED_REASONS.has(text))
+        return text;
+    if (/did not terminate|interrupt failed/i.test(text))
+        return "abort_timeout";
+    if (/user_message_uuid did not match|result arrived before replay claim|pre-replay buffer overflow/i.test(text)) {
+        return "turn_attribution_failed";
+    }
+    if (/query ended before|Claude SDK OAuth query|Claude Code/i.test(text))
+        return "query_failed";
+    return "other";
+}
+/**
+ * Classifies the failure that ended a turn after every auth attempt failed.
+ * Anything reaching here came out of the SDK query path, so an Error is a query
+ * failure unless it matches a more specific bucket; the raw text never escapes.
+ */
+export function sanitizeTerminalFailure(value) {
+    const cause = sanitizeCloseCause(value);
+    if (cause !== "other")
+        return cause;
+    return value instanceof Error ? "query_failed" : "other";
+}
+/**
+ * One-shot pending close causes keyed by senpi session id. `closeSession`
+ * records the cause here; the next admission consumes it so a first-turn
+ * `registry_miss` is attributed to the real cause instead.
+ */
+const pendingCloseCauses = new Map();
+// Long-running processes can stage many closes: the map is FIFO-bounded so it
+// cannot grow without limit. 256 pending causes per process is far beyond any
+// realistic session count; the oldest entry is evicted first.
+const PENDING_CLOSE_CAUSE_LIMIT = 256;
+export function recordPendingCloseCause(senpiSessionId, reason) {
+    const cause = sanitizeReason(reason);
+    // Delete first so a re-recorded cause moves to the newest position.
+    pendingCloseCauses.delete(senpiSessionId);
+    if (pendingCloseCauses.size >= PENDING_CLOSE_CAUSE_LIMIT) {
+        const oldest = pendingCloseCauses.keys().next().value;
+        if (oldest !== undefined)
+            pendingCloseCauses.delete(oldest);
+    }
+    pendingCloseCauses.set(senpiSessionId, cause);
+    activeBoundary.log("claude_sdk_oauth_session_close", { reason: cause });
+}
+/** Read the pending close cause WITHOUT consuming it (consumed at emit time). */
+export function peekPendingCloseCause(senpiSessionId) {
+    return pendingCloseCauses.get(senpiSessionId);
+}
+export function consumePendingCloseCause(senpiSessionId) {
+    const cause = pendingCloseCauses.get(senpiSessionId);
+    pendingCloseCauses.delete(senpiSessionId);
+    return cause;
+}
+/**
+ * Maps the continuity decision families onto the observation vocabulary:
+ * incremental→delta, resume→fork, cold-seed→flatten.
+ */
+export function observeSessionSyncDecision(input) {
+    if (input.kind === "incremental") {
+        return { kind: "delta", reason: "prefix_matched", deltaMessages: input.deltaMessages };
+    }
+    if (input.kind === "resume") {
+        const retainedCause = input.reason === "registry_miss" ? consumePendingCloseCause(input.senpiSessionId) : undefined;
+        return {
+            kind: "fork",
+            reason: retainedCause ?? (input.reason === undefined ? "branch_resume" : sanitizeReason(input.reason)),
+            deltaMessages: input.deltaMessages,
+        };
+    }
+    // Peek, not consume: the staged observation is emitted only when the
+    // auth-lane RETAINS this attempt. Consuming here would lose the cause when
+    // the attempt is discarded; the emit path consumes it (session-stream.ts).
+    const retained = input.reason === "registry_miss" ? peekPendingCloseCause(input.senpiSessionId) : undefined;
+    const reason = retained ?? sanitizeReason(input.reason);
+    return {
+        kind: input.firstTurn && reason === "registry_miss" ? "bootstrap" : "flatten",
+        reason,
+        deltaMessages: input.deltaMessages,
+    };
+}
+/** Stages an attempt's decision; `emit` fires only when the attempt is retained. */
+export function stageContinuityDecision(observation, onDecision, beforeEmit) {
+    let emitted = false;
+    return {
+        observation,
+        emit: () => {
+            if (emitted)
+                return;
+            emitted = true;
+            beforeEmit?.();
+            emitContinuityObservation(observation, onDecision);
+        },
+    };
+}
+export function emitContinuityObservation(observation, onDecision) {
+    onDecision?.(observation);
+    activeBoundary.emit(observation);
+    activeBoundary.log("claude_sdk_oauth_session_continuity", {
+        kind: observation.kind,
+        reason: observation.reason,
+        ...(observation.deltaMessages === undefined ? {} : { count: observation.deltaMessages }),
+    });
+}
+//# sourceMappingURL=session-observability.js.map

package/dist/core/extensions/builtin/claude-sdk-oauth/session-observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-observability.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/claude-sdk-oauth/session-observability.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAgentDir } from \"../../../../config.ts\";\nimport { createSessionLogger, type SessionLogger } from \"../../../session-log.ts\";\n\n/**\n * Per-turn continuity observability for the claude-sdk-oauth lane.\n *\n * Emission semantics: a decision is STAGED per attempt at its final outcome\n * point and EMITTED only when the auth-lane retain/discard wrapper retains that\n * attempt (auth-attempt.ts). A discarded attempt emits nothing, so every\n * completed turn yields exactly one observation; a turn where every attempt\n * fails yields one terminal error observation instead.\n */\nexport type ContinuityKind = \"bootstrap\" | \"delta\" | \"reattach\" | \"fork\" | \"flatten\" | \"disabled\";\n\n/** Fixed vocabulary — arbitrary error text never reaches an observation. */\nexport type ContinuityReason =\n\t| \"prefix_matched\"\n\t| \"registry_miss\"\n\t| \"idle_ttl\"\n\t| \"capacity\"\n\t| \"model_selected\"\n\t| \"thinking_level_selected\"\n\t| \"bound_account_token_expiring\"\n\t| \"account_changed\"\n\t| \"model_changed\"\n\t| \"toolset_changed\"\n\t| \"system_prompt_changed\"\n\t| \"assistant_stream_diverged\"\n\t| \"sent_stream_diverged\"\n\t| \"options_changed\"\n\t| \"history_rolled_back\"\n\t| \"assistant_rewritten\"\n\t| \"transcript_missing\"\n\t| \"cross_root_unsupported\"\n\t| \"branch_diverged\"\n\t| \"branch_boundary_unavailable\"\n\t| \"branch_resume\"\n\t| \"tainted_compaction\"\n\t| \"tainted_fork\"\n\t| \"tainted_abort\"\n\t| \"tainted_assistant_provenance_unverified\"\n\t| \"resume_initialization_failed\"\n\t| \"resume_initialization_aborted\"\n\t| \"resume_mode_off\"\n\t| \"query_failed\"\n\t| \"turn_attribution_failed\"\n\t| \"abort_timeout\"\n\t| \"extensions_removed\"\n\t| \"session_shutdown\"\n\t| \"other\";\n\nexport type ContinuityObservation = {\n\tkind: ContinuityKind;\n\treason: ContinuityReason;\n\tdeltaMessages?: number;\n};\n\nexport type ContinuityObservabilityBoundary = {\n\temit: (observation: ContinuityObservation) => void;\n\tlog: (event: string, data: Record<string, unknown>) => void;\n};\n\nconst SANITIZED_REASONS = new Set<string>([\n\t\"prefix_matched\",\n\t\"registry_miss\",\n\t\"idle_ttl\",\n\t\"capacity\",\n\t\"model_selected\",\n\t\"thinking_level_selected\",\n\t\"bound_account_token_expiring\",\n\t\"account_changed\",\n\t\"model_changed\",\n\t\"toolset_changed\",\n\t\"system_prompt_changed\",\n\t\"assistant_stream_diverged\",\n\t\"options_changed\",\n\t\"history_rolled_back\",\n\t\"assistant_rewritten\",\n\t\"transcript_missing\",\n\t\"cross_root_unsupported\",\n\t\"sent_stream_diverged\",\n\t\"branch_diverged\",\n\t\"branch_boundary_unavailable\",\n\t\"branch_resume\",\n\t\"tainted_compaction\",\n\t\"tainted_fork\",\n\t\"tainted_abort\",\n\t\"tainted_assistant_provenance_unverified\",\n\t\"resume_initialization_failed\",\n\t\"resume_initialization_aborted\",\n\t\"resume_mode_off\",\n\t\"query_failed\",\n\t\"turn_attribution_failed\",\n\t\"abort_timeout\",\n\t\"extensions_removed\",\n\t\"session_shutdown\",\n\t\"other\",\n]);\n\nlet cachedLogger: SessionLogger | undefined;\n\nfunction sessionLogger(): SessionLogger {\n\tcachedLogger ??= createSessionLogger(getAgentDir());\n\treturn cachedLogger;\n}\n\nconst defaultBoundary: ContinuityObservabilityBoundary = {\n\temit: () => {},\n\tlog: (event, data) => sessionLogger().info(event, data),\n};\nlet activeBoundary = defaultBoundary;\n\nexport function overrideContinuityObservabilityBoundary(override: Partial<ContinuityObservabilityBoundary>): void {\n\tactiveBoundary = { ...defaultBoundary, ...override };\n}\n\nexport function resetContinuityObservabilityBoundary(): void {\n\tactiveBoundary = defaultBoundary;\n}\n\n/** Maps a fixed vocabulary member through, and anything else to a bucketed cause. */\nexport function sanitizeReason(value: unknown): ContinuityReason {\n\tconst text = typeof value === \"string\" ? value : value instanceof Error ? value.message : \"\";\n\tif (SANITIZED_REASONS.has(text)) return text as ContinuityReason;\n\tconst tainted = /^tainted:(.+)$/.exec(text);\n\tif (tainted) {\n\t\tconst mapped = `tainted_${tainted[1]}`;\n\t\tif (SANITIZED_REASONS.has(mapped)) return mapped as ContinuityReason;\n\t}\n\treturn sanitizeCloseCause(value);\n}\n\n/** Buckets arbitrary close/pump failures into the fixed close-cause vocabulary. */\nexport function sanitizeCloseCause(value: unknown): ContinuityReason {\n\tconst text = typeof value === \"string\" ? value : value instanceof Error ? value.message : \"\";\n\tif (SANITIZED_REASONS.has(text)) return text as ContinuityReason;\n\tif (/did not terminate|interrupt failed/i.test(text)) return \"abort_timeout\";\n\tif (/user_message_uuid did not match|result arrived before replay claim|pre-replay buffer overflow/i.test(text)) {\n\t\treturn \"turn_attribution_failed\";\n\t}\n\tif (/query ended before|Claude SDK OAuth query|Claude Code/i.test(text)) return \"query_failed\";\n\treturn \"other\";\n}\n\n/**\n * Classifies the failure that ended a turn after every auth attempt failed.\n * Anything reaching here came out of the SDK query path, so an Error is a query\n * failure unless it matches a more specific bucket; the raw text never escapes.\n */\nexport function sanitizeTerminalFailure(value: unknown): ContinuityReason {\n\tconst cause = sanitizeCloseCause(value);\n\tif (cause !== \"other\") return cause;\n\treturn value instanceof Error ? \"query_failed\" : \"other\";\n}\n\n/**\n * One-shot pending close causes keyed by senpi session id. `closeSession`\n * records the cause here; the next admission consumes it so a first-turn\n * `registry_miss` is attributed to the real cause instead.\n */\nconst pendingCloseCauses = new Map<string, ContinuityReason>();\n// Long-running processes can stage many closes: the map is FIFO-bounded so it\n// cannot grow without limit. 256 pending causes per process is far beyond any\n// realistic session count; the oldest entry is evicted first.\nconst PENDING_CLOSE_CAUSE_LIMIT = 256;\n\nexport function recordPendingCloseCause(senpiSessionId: string, reason: unknown): void {\n\tconst cause = sanitizeReason(reason);\n\t// Delete first so a re-recorded cause moves to the newest position.\n\tpendingCloseCauses.delete(senpiSessionId);\n\tif (pendingCloseCauses.size >= PENDING_CLOSE_CAUSE_LIMIT) {\n\t\tconst oldest = pendingCloseCauses.keys().next().value;\n\t\tif (oldest !== undefined) pendingCloseCauses.delete(oldest);\n\t}\n\tpendingCloseCauses.set(senpiSessionId, cause);\n\tactiveBoundary.log(\"claude_sdk_oauth_session_close\", { reason: cause });\n}\n\n/** Read the pending close cause WITHOUT consuming it (consumed at emit time). */\nexport function peekPendingCloseCause(senpiSessionId: string): ContinuityReason | undefined {\n\treturn pendingCloseCauses.get(senpiSessionId);\n}\n\nexport function consumePendingCloseCause(senpiSessionId: string): ContinuityReason | undefined {\n\tconst cause = pendingCloseCauses.get(senpiSessionId);\n\tpendingCloseCauses.delete(senpiSessionId);\n\treturn cause;\n}\n\n/**\n * Maps the continuity decision families onto the observation vocabulary:\n * incremental→delta, resume→fork, cold-seed→flatten.\n */\nexport function observeSessionSyncDecision(input: {\n\tkind: \"incremental\" | \"resume\" | \"cold-seed\";\n\treason?: string;\n\tdeltaMessages: number;\n\tfirstTurn: boolean;\n\tsenpiSessionId: string;\n}): ContinuityObservation {\n\tif (input.kind === \"incremental\") {\n\t\treturn { kind: \"delta\", reason: \"prefix_matched\", deltaMessages: input.deltaMessages };\n\t}\n\tif (input.kind === \"resume\") {\n\t\tconst retainedCause =\n\t\t\tinput.reason === \"registry_miss\" ? consumePendingCloseCause(input.senpiSessionId) : undefined;\n\t\treturn {\n\t\t\tkind: \"fork\",\n\t\t\treason: retainedCause ?? (input.reason === undefined ? \"branch_resume\" : sanitizeReason(input.reason)),\n\t\t\tdeltaMessages: input.deltaMessages,\n\t\t};\n\t}\n\t// Peek, not consume: the staged observation is emitted only when the\n\t// auth-lane RETAINS this attempt. Consuming here would lose the cause when\n\t// the attempt is discarded; the emit path consumes it (session-stream.ts).\n\tconst retained = input.reason === \"registry_miss\" ? peekPendingCloseCause(input.senpiSessionId) : undefined;\n\tconst reason = retained ?? sanitizeReason(input.reason);\n\treturn {\n\t\tkind: input.firstTurn && reason === \"registry_miss\" ? \"bootstrap\" : \"flatten\",\n\t\treason,\n\t\tdeltaMessages: input.deltaMessages,\n\t};\n}\n\nexport type StagedContinuityDecision = {\n\tobservation: ContinuityObservation;\n\temit: () => void;\n};\n\n/** Stages an attempt's decision; `emit` fires only when the attempt is retained. */\nexport function stageContinuityDecision(\n\tobservation: ContinuityObservation,\n\tonDecision?: (observation: ContinuityObservation) => void,\n\tbeforeEmit?: () => void,\n): StagedContinuityDecision {\n\tlet emitted = false;\n\treturn {\n\t\tobservation,\n\t\temit: () => {\n\t\t\tif (emitted) return;\n\t\t\temitted = true;\n\t\t\tbeforeEmit?.();\n\t\t\temitContinuityObservation(observation, onDecision);\n\t\t},\n\t};\n}\n\nexport function emitContinuityObservation(\n\tobservation: ContinuityObservation,\n\tonDecision?: (observation: ContinuityObservation) => void,\n): void {\n\tonDecision?.(observation);\n\tactiveBoundary.emit(observation);\n\tactiveBoundary.log(\"claude_sdk_oauth_session_continuity\", {\n\t\tkind: observation.kind,\n\t\treason: observation.reason,\n\t\t...(observation.deltaMessages === undefined ? {} : { count: observation.deltaMessages }),\n\t});\n}\n"]}

package/dist/core/extensions/builtin/claude-sdk-oauth/session-reaper.d.ts

@@ -0,0 +1,24 @@
+export interface SessionRegistryReapHandle {
+    cancel(): void;
+    unref(): void;
+}
+export type ReapCandidate = {
+    generation: number;
+    lastUsedAt: number;
+};
+export type SessionReapDeps = {
+    now: () => number;
+    scheduleTimer: (callback: () => void, delayMs: number) => SessionRegistryReapHandle;
+    idleTtlMs: number;
+    candidate: (senpiSessionId: string, generation: number) => ReapCandidate | undefined;
+    expire: (senpiSessionId: string) => void;
+};
+export declare class SessionReapScheduler {
+    private readonly scheduled;
+    private readonly deps;
+    constructor(deps: SessionReapDeps);
+    arm(senpiSessionId: string, generation: number, delayMs?: number): void;
+    cancel(senpiSessionId: string, generation: number): void;
+    private fire;
+}
+//# sourceMappingURL=session-reaper.d.ts.map

package/dist/core/extensions/builtin/claude-sdk-oauth/session-reaper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-reaper.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/claude-sdk-oauth/session-reaper.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACzC,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;CACd;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,yBAAyB,CAAC;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;IACrF,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,CAAC;AAIF,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IAEvC,YAAY,IAAI,EAAE,eAAe,EAEhC;IAED,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,SAAsB,GAAG,IAAI,CAKnF;IAED,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAKvD;IAED,OAAO,CAAC,IAAI;CAUZ"}

package/dist/core/extensions/builtin/claude-sdk-oauth/session-reaper.js

@@ -0,0 +1,34 @@
+export class SessionReapScheduler {
+    constructor(deps) {
+        this.scheduled = new Map();
+        this.deps = deps;
+    }
+    arm(senpiSessionId, generation, delayMs = this.deps.idleTtlMs) {
+        const token = Symbol("session-reap");
+        const handle = this.deps.scheduleTimer(() => this.fire(senpiSessionId, generation, token), delayMs);
+        this.scheduled.set(senpiSessionId, { generation, token, handle });
+        handle.unref();
+    }
+    cancel(senpiSessionId, generation) {
+        const scheduled = this.scheduled.get(senpiSessionId);
+        if (!scheduled || scheduled.generation !== generation)
+            return;
+        scheduled.handle.cancel();
+        this.scheduled.delete(senpiSessionId);
+    }
+    fire(senpiSessionId, generation, token) {
+        const scheduled = this.scheduled.get(senpiSessionId);
+        if (!scheduled || scheduled.generation !== generation || scheduled.token !== token)
+            return;
+        this.scheduled.delete(senpiSessionId);
+        const candidate = this.deps.candidate(senpiSessionId, generation);
+        if (!candidate)
+            return;
+        const remaining = candidate.lastUsedAt + this.deps.idleTtlMs - this.deps.now();
+        if (remaining <= 0)
+            this.deps.expire(senpiSessionId);
+        else
+            this.arm(senpiSessionId, generation, remaining);
+    }
+}
+//# sourceMappingURL=session-reaper.js.map