@quantiya/codevibe-core 2.0.71 → 2.0.73

package/dist/appsync/appsync-client.d.ts

@@ -7,6 +7,7 @@ import { DurableDesktopSyncWriter, type DesktopSyncSessionScope } from './sync-o
 import { DesktopSyncReadClient } from './sync-read-client';
 import { DesktopSyncLiveConnection } from './sync-live-connection';
 import { type DurableDesktopSyncReader } from './sync-desktop-registration';
+import type { ContextItemPage, ResumableSessionPage, ResumeDetails } from '../types/session';
 import type { PromptReRaiseDisposition } from './sync-prompt-retention';
 import { type ResolveDesktopSyncPromptInput, type SyncPromptResolutionReceipt } from './sync-prompt-resolution';
 import { type ConfirmDesktopSyncRetirementInput, type SyncSessionRetirementReceipt } from './sync-session-retirement';
@@ -422,18 +423,16 @@ export interface DownloadUrlResponse {
     expiresAt: string;
 }
 /**
- * CP-1.b IMPL r2 M-4 — Typed GraphQL error that preserves AppSync's
- * `errorType` and `extensions` fields, alongside the human-readable
- * `message`. Stage 2 r1's `graphqlRequest()` threw a plain
- * `Error("GraphQL error: <message>")` and silently dropped
- * `errorType`, which broke `BackendPlannerClient.classifyTransportError`
- * (it discriminates on `err.errorType` to separate
- * `BudgetExceeded` / `TierGateRejected` from provider-health failures).
+ * The P61 old-backend retry's trigger: the server's schema lacks an input field the update sent.
  *
- * Callers may catch this class to inspect `errorType` directly. Code
- * paths that still parse error.message will continue to work because
- * the message is unchanged ("GraphQL error: <message>").
+ * AppSync answers a variable carrying an undefined input field with a GraphQL error whose message is
+ * exactly "The variables input contains a field that is not defined for input object type
+ * 'UpdateSessionInput'" — no `errorType`, and the field is not named (observed against Development on
+ * 2026-10-15, P61B-S1-F8; Phase B assumption PB-12). The caller retries only when the request carried
+ * clean-exit fields, and the retry removes only those, so a different unknown field still fails.
+ * The older validation-error shape that names a clean-exit field is kept as a second form.
  */
+export declare function isUnknownCleanExitFieldError(error: unknown): boolean;
 export declare class AppSyncGraphQLError extends Error {
     readonly responseMessage: string;
     readonly errorType?: string;
@@ -980,6 +979,7 @@ export declare class AppSyncClient {
     }, retired: Session, quiesce: () => Promise<void>, signal?: AbortSignal): Promise<{
         sourcesRemoved: number;
         operationsRemoved: number;
+        cleanupDeferred?: true;
     }>;
     /** No Session fetch, live key lookup, native-process operation or re-homing.
      * The encrypted intent records a completed producer join; fresh cloud proof
@@ -1014,6 +1014,12 @@ export declare class AppSyncClient {
      * Create a session
      */
     createSession(input: CreateSessionInput): Promise<Session>;
+    /**
+     * P61 — the resume create (B-15). The same mutation as `createSession`, with
+     * `resumedFromSessionId` selected so the caller can prove the server resumed
+     * the predecessor. Used only on resume paths.
+     */
+    createResumedSession(input: CreateSessionInput): Promise<Session>;
     /**
      * Blind-hold one canonical ContextItem. The mutation is idempotent only for
      * an exact ciphertext+routing replay; a conflicting rewrite is rejected by
@@ -1098,6 +1104,18 @@ export declare class AppSyncClient {
         createdAt: string | null;
         updatedAt: string | null;
     }>>;
+    /** One page of the caller's resumable sessions (creation order; amendment A-1). */
+    listResumableSessions(limit?: number, nextToken?: string | null): Promise<ResumableSessionPage>;
+    /**
+     * Every resumable session (S1R1-F23: never just the first screen). The
+     * 7-day window bounds the set; the page cap only stops a server that never
+     * ends its token chain.
+     */
+    listAllResumableSessions(maxPages?: number): Promise<ResumeDetails[]>;
+    /** One owner-only row in any status (null when absent or not owned). */
+    getResumeDetails(sessionId: string): Promise<ResumeDetails | null>;
+    /** One page of a session's hosted ContextItem rows (routing ids + ciphertext). */
+    listContextItems(sessionId: string, nextToken?: string | null): Promise<ContextItemPage>;
     /**
      * Mark stale ACTIVE sessions of a given agentType INACTIVE so they
      * stop appearing in the mobile app's session list. Called at daemon
@@ -1128,6 +1146,20 @@ export declare class AppSyncClient {
         staleThresholdMs?: number;
         excludeSessionIds?: string[];
     }): Promise<number>;
+    /**
+     * P61 pre-listing retire (SESSION-RESUME-DESIGN.md §6.2 step 3; Phase B
+     * B-5). Retires exactly the rows of the caller's own step-1 read for which
+     * `willRetire` holds, so the `--continue` comparison and the retirement can
+     * never disagree. Immediately before each retire the row is re-read
+     * strongly, and it is skipped if it is no longer ACTIVE or its heartbeat
+     * moved since the step-1 read (a live shell elsewhere). Returns the retired
+     * IDs (step 4 merges them through `getResumeDetails`). Best effort: a failed
+     * read or update leaves that row as it is.
+     */
+    sweepOrphanSessionsFromRows<T extends {
+        sessionId: string;
+        lastHeartbeatAt?: string | null;
+    }>(rows: readonly T[], willRetire: (row: T) => boolean): Promise<string[]>;
     /**
      * List user device keys
      */

package/dist/appsync/queries.d.ts

@@ -17,6 +17,9 @@ export declare const queries: {
      * whose creator died before its first heartbeat.
      */
     listSessions: string;
+    listResumableSessions: string;
+    getResumeDetails: string;
+    listContextItems: string;
     getSubscriptionStatus: string;
     queryAudit: string;
     verifyContinuationPacketWritten: string;
@@ -33,6 +36,7 @@ export declare const mutations: {
     recordExecutionEvent: string;
     putContextItem: string;
     createSession: string;
+    createResumedSession: string;
     updateSession: string;
     updateEvent: string;
     createEvent: string;

package/dist/appsync/session-freshness.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The one freshness rule shared by the plain-launch orphan sweep and the P61
+ * pre-listing retire (SESSION-RESUME-DESIGN.md §6.2 step 3): a row's age is
+ * `now − max(lastHeartbeatAt, createdAt, updatedAt)`, ignoring unparsable
+ * values. A row with no parsable value has no age, and is never swept on age.
+ */
+export interface SessionFreshnessFields {
+    lastHeartbeatAt?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
+export declare function sessionFreshnessAgeMs(row: SessionFreshnessFields, nowMs: number): number | null;

package/dist/appsync/sync-operation-journal.d.ts

@@ -179,6 +179,7 @@ export declare class DurableDesktopSyncWriter {
      * intent removal. Network I/O never holds the account-store lock. */
     runSessionRetirement<T>(input: ConfirmDesktopSyncRetirementInput, toolOutbox: ToolSyncRetirementLocation | null, cleanup: (record: SessionRetirementRecord, fence: () => Promise<void>) => Promise<T>, options?: {
         existingOnly?: boolean;
+        isComplete?: (result: T) => boolean;
     }): Promise<T | null>;
     /** Terminal GC, not delivery settlement. The session owner MUST first stop
      * admission and join its native readers, shell emitters and prompt producers.

package/dist/appsync/sync-session-retirement.d.ts

@@ -9,7 +9,7 @@ export type SyncSessionRetirementReceipt = ConfirmDesktopSyncRetirementInput & {
     controlClass: 'SESSION_RETIREMENT';
 };
 export interface ToolSyncRetirementLocation {
-    agent: 'codex' | 'claude';
+    agent: 'codex' | 'claude' | 'agy';
     root: string;
 }
 export interface SessionRetirementRecord {

package/dist/appsync/sync-source-pair.d.ts

@@ -3,7 +3,7 @@ import type { DesktopSyncSourceFrame, DesktopSyncSourceGap, DesktopSyncSourceJou
 type Prepare = ((operationId: string) => Promise<CreateDesktopSyncEventInput>) | null;
 export interface DesktopSyncSourcePair {
     /** Restore the earliest unfinished lane, never the latest volatile reader offset. */
-    open(initial: number | DesktopSyncSourcePosition): Promise<DesktopSyncSourcePosition>;
+    open(initial: number | DesktopSyncSourcePosition, validateInitial?: () => void): Promise<DesktopSyncSourcePosition>;
     /** Both slots are fixed for this source's lifetime; null explicitly ignores a slot. */
     admit(frame: DesktopSyncSourceFrame, prepare: readonly [Prepare, Prepare]): Promise<readonly [string | null, string | null]>;
     skip(gap: DesktopSyncSourceGap): Promise<void>;

package/dist/index.d.ts

@@ -74,7 +74,7 @@ export { emitShellEvent, createShellEventEmitter } from './orchestration-shell';
 export { processMarkers, withRoleMarker } from './orchestration-shell';
 export { ToolActivityOutbox, type ToolActivityOutboxOptions, type ListPendingResult, } from './tool-activity';
 export { ToolActivityLedger, LedgerEntrySchema, LedgerFileSchema, LegacyOwnedFileSchema, type LedgerEntry, type LedgerFile, type LegacyOwnedFile, type OccurrenceRef, type ToolActivityLedgerOptions, } from './tool-activity';
-export { ToolReplayCursor, ReplayFrameTooLargeError, ReplayCursorStateSchema, DEFAULT_REPLAY_READ_BYTES, DEFAULT_REPLAY_MAX_FRAME_BYTES, type ReplayCursorState, type ReplayFrame, type ReadFramesResult, type ToolReplayCursorOptions, } from './tool-activity';
+export { ToolReplayCursor, captureToolReplayBoundary, ReplayFrameTooLargeError, ReplayCursorStateSchema, DEFAULT_REPLAY_READ_BYTES, DEFAULT_REPLAY_MAX_FRAME_BYTES, type ReplayCursorState, type ReplayFrame, type ReadFramesResult, type ToolReplayCursorOptions, type ToolReplayInitialBoundary, } from './tool-activity';
 export { ToolActivitySessionMap, InProcessRolloutLock, SessionMapRecordSchema, type RolloutLock, type RolloutOwnership, type SessionMapRecord, type ToolActivitySessionMapOptions, } from './tool-activity';
 export { ToolActivityConsolidator, isSessionKeyStaleError, isTerminalSessionError, type ObservedOccurrence, type ObserveDisposition, type ToolActivityTransport, type ToolActivityConsolidatorOptions, } from './tool-activity';
 export { SocketRolloutLock, type SocketRolloutLockOptions, FlockRolloutLock, type FlockRolloutLockOptions, type FlockSyncFn, type FlockFlag, createRolloutLock, type CreateRolloutLockOptions, } from './tool-activity';