@zakstam/codex-local-component 0.1.3 → 0.2.1

package/dist/component/sync.d.ts

@@ -1,4 +1,4 @@
-export declare const pushEvents: import("convex/server").RegisteredMutation<"public", {
+export declare const ingest: import("convex/server").RegisteredMutation<"public", {
     actor: {
         tenantId: string;
         userId: string;
@@ -6,12 +6,48 @@ export declare const pushEvents: import("convex/server").RegisteredMutation<"pub
     };
     sessionId: string;
     threadId: string;
-    deltas: import("./syncIngest.js").InboundEvent[];
+    streamDeltas: import("./syncIngest.js").StreamInboundEvent[];
+    lifecycleEvents: import("./syncIngest.js").LifecycleInboundEvent[];
     runtime?: import("./syncRuntime.js").SyncRuntimeInput;
 }, Promise<{
-    ackCursor: number;
+    ackedStreams: Array<{
+        streamId: string;
+        ackCursorEnd: number;
+    }>;
+    ingestStatus: "ok" | "partial";
 }>>;
-export declare const pullState: import("convex/server").RegisteredQuery<"public", {
+export declare const ingestSafe: import("convex/server").RegisteredMutation<"public", {
+    actor: {
+        tenantId: string;
+        userId: string;
+        deviceId: string;
+    };
+    sessionId: string;
+    threadId: string;
+    streamDeltas: import("./syncIngest.js").StreamInboundEvent[];
+    lifecycleEvents: import("./syncIngest.js").LifecycleInboundEvent[];
+    runtime?: import("./syncRuntime.js").SyncRuntimeInput;
+} & {
+    ensureLastEventCursor?: number;
+}, Promise<{
+    status: "ok" | "partial" | "session_recovered" | "rejected";
+    ingestStatus: "ok" | "partial";
+    ackedStreams: Array<{
+        streamId: string;
+        ackCursorEnd: number;
+    }>;
+    recovery?: {
+        action: "session_rebound";
+        sessionId: string;
+        threadId: string;
+    };
+    errors: Array<{
+        code: "OUT_OF_ORDER" | "REPLAY_GAP" | "SESSION_DEVICE_MISMATCH" | "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "UNKNOWN";
+        message: string;
+        recoverable: boolean;
+    }>;
+}>>;
+export declare const replay: import("convex/server").RegisteredQuery<"public", {
     actor: {
         tenantId: string;
         userId: string;
@@ -28,6 +64,16 @@ export declare const pullState: import("convex/server").RegisteredQuery<"public"
         streamId: string;
         state: string;
     }[];
+    streamWindows: {
+        streamId: string;
+        status: "ok" | "stale" | "rebased";
+        serverCursorStart: number;
+        serverCursorEnd: number;
+    }[];
+    nextCheckpoints: {
+        streamId: string;
+        cursor: number;
+    }[];
     deltas: {
         streamId: string;
         cursorStart: number;
@@ -42,6 +88,29 @@ export declare const pullState: import("convex/server").RegisteredQuery<"public"
         payloadJson: string;
     }[];
 }>>;
+export declare const listCheckpoints: import("convex/server").RegisteredQuery<"public", {
+    actor: {
+        tenantId: string;
+        userId: string;
+        deviceId: string;
+    };
+    threadId: string;
+}, Promise<{
+    streamId: string;
+    cursor: number;
+}[]>>;
+export declare const upsertCheckpoint: import("convex/server").RegisteredMutation<"public", {
+    actor: {
+        tenantId: string;
+        userId: string;
+        deviceId: string;
+    };
+    threadId: string;
+    streamId: string;
+    cursor: number;
+}, Promise<{
+    ok: true;
+}>>;
 export declare const heartbeat: import("convex/server").RegisteredMutation<"public", {
     actor: {
         tenantId: string;
@@ -52,7 +121,21 @@ export declare const heartbeat: import("convex/server").RegisteredMutation<"publ
     threadId: string;
     lastEventCursor: number;
 }, Promise<null>>;
-export declare const resumeFromCursor: import("convex/server").RegisteredQuery<"public", {
+export declare const ensureSession: import("convex/server").RegisteredMutation<"public", {
+    actor: {
+        tenantId: string;
+        userId: string;
+        deviceId: string;
+    };
+    sessionId: string;
+    threadId: string;
+    lastEventCursor: number;
+}, Promise<{
+    sessionId: string;
+    threadId: string;
+    status: "created" | "active";
+}>>;
+export declare const resumeReplay: import("convex/server").RegisteredQuery<"public", {
     actor: {
         tenantId: string;
         userId: string;
@@ -63,6 +146,12 @@ export declare const resumeFromCursor: import("convex/server").RegisteredQuery<"
     fromCursor: number;
     runtime?: import("./syncRuntime.js").SyncRuntimeInput;
 }, Promise<{
+    streamWindow: {
+        streamId: string;
+        status: "ok" | "stale" | "rebased";
+        serverCursorStart: number;
+        serverCursorEnd: number;
+    };
     deltas: {
         cursorStart: number;
         cursorEnd: number;

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

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/component/sync.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,UAAU;;;;;;;;;;;;GAUrB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAQpB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;iBASpB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;GAS3B,CAAC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/component/sync.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;GAmBjB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CrB,CAAC;AAEH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAQjB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;KAM1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;GAS3B,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;iBASpB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;GAaxB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;GASvB,CAAC"}

package/dist/component/sync.js

@@ -1,9 +1,10 @@
 import { v } from "convex/values";
 import { mutation, query } from "./_generated/server.js";
 import { vActorContext, vSyncRuntimeOptions } from "./types.js";
-import { heartbeatHandler, pushEventsHandler } from "./syncIngest.js";
-import { pullStateHandler, resumeFromCursorHandler } from "./syncReplay.js";
-const vInboundEvent = v.object({
+import { ensureSessionHandler, heartbeatHandler, ingestHandler, ingestSafeHandler, upsertCheckpointHandler, } from "./syncIngest.js";
+import { listCheckpointsHandler, replayHandler, resumeReplayHandler } from "./syncReplay.js";
+const vStreamInboundEvent = v.object({
+    type: v.literal("stream_delta"),
     eventId: v.string(),
     turnId: v.string(),
     streamId: v.string(),
@@ -13,25 +14,87 @@ const vInboundEvent = v.object({
     cursorEnd: v.number(),
     createdAt: v.number(),
 });
-export const pushEvents = mutation({
+const vLifecycleEvent = v.object({
+    type: v.literal("lifecycle_event"),
+    eventId: v.string(),
+    turnId: v.optional(v.string()),
+    kind: v.string(),
+    payloadJson: v.string(),
+    createdAt: v.number(),
+});
+export const ingest = mutation({
+    args: {
+        actor: vActorContext,
+        sessionId: v.string(),
+        threadId: v.string(),
+        streamDeltas: v.array(vStreamInboundEvent),
+        lifecycleEvents: v.array(vLifecycleEvent),
+        runtime: v.optional(vSyncRuntimeOptions),
+    },
+    returns: v.object({
+        ackedStreams: v.array(v.object({
+            streamId: v.string(),
+            ackCursorEnd: v.number(),
+        })),
+        ingestStatus: v.union(v.literal("ok"), v.literal("partial")),
+    }),
+    handler: ingestHandler,
+});
+export const ingestSafe = mutation({
     args: {
         actor: vActorContext,
         sessionId: v.string(),
         threadId: v.string(),
-        deltas: v.array(vInboundEvent),
+        streamDeltas: v.array(vStreamInboundEvent),
+        lifecycleEvents: v.array(vLifecycleEvent),
+        ensureLastEventCursor: v.optional(v.number()),
         runtime: v.optional(vSyncRuntimeOptions),
     },
-    returns: v.object({ ackCursor: v.number() }),
-    handler: pushEventsHandler,
+    returns: v.object({
+        status: v.union(v.literal("ok"), v.literal("partial"), v.literal("session_recovered"), v.literal("rejected")),
+        ingestStatus: v.union(v.literal("ok"), v.literal("partial")),
+        ackedStreams: v.array(v.object({
+            streamId: v.string(),
+            ackCursorEnd: v.number(),
+        })),
+        recovery: v.optional(v.object({
+            action: v.literal("session_rebound"),
+            sessionId: v.string(),
+            threadId: v.string(),
+        })),
+        errors: v.array(v.object({
+            code: v.union(v.literal("SESSION_NOT_FOUND"), v.literal("SESSION_THREAD_MISMATCH"), v.literal("SESSION_DEVICE_MISMATCH"), v.literal("OUT_OF_ORDER"), v.literal("REPLAY_GAP"), v.literal("UNKNOWN")),
+            message: v.string(),
+            recoverable: v.boolean(),
+        })),
+    }),
+    handler: ingestSafeHandler,
 });
-export const pullState = query({
+export const replay = query({
     args: {
         actor: vActorContext,
         threadId: v.string(),
         streamCursorsById: v.array(v.object({ streamId: v.string(), cursor: v.number() })),
         runtime: v.optional(vSyncRuntimeOptions),
     },
-    handler: pullStateHandler,
+    handler: replayHandler,
+});
+export const listCheckpoints = query({
+    args: {
+        actor: vActorContext,
+        threadId: v.string(),
+    },
+    handler: listCheckpointsHandler,
+});
+export const upsertCheckpoint = mutation({
+    args: {
+        actor: vActorContext,
+        threadId: v.string(),
+        streamId: v.string(),
+        cursor: v.number(),
+    },
+    returns: v.object({ ok: v.literal(true) }),
+    handler: upsertCheckpointHandler,
 });
 export const heartbeat = mutation({
     args: {
@@ -43,7 +106,21 @@ export const heartbeat = mutation({
     returns: v.null(),
     handler: heartbeatHandler,
 });
-export const resumeFromCursor = query({
+export const ensureSession = mutation({
+    args: {
+        actor: vActorContext,
+        sessionId: v.string(),
+        threadId: v.string(),
+        lastEventCursor: v.number(),
+    },
+    returns: v.object({
+        sessionId: v.string(),
+        threadId: v.string(),
+        status: v.union(v.literal("created"), v.literal("active")),
+    }),
+    handler: ensureSessionHandler,
+});
+export const resumeReplay = query({
     args: {
         actor: vActorContext,
         threadId: v.string(),
@@ -51,6 +128,6 @@ export const resumeFromCursor = query({
         fromCursor: v.number(),
         runtime: v.optional(vSyncRuntimeOptions),
     },
-    handler: resumeFromCursorHandler,
+    handler: resumeReplayHandler,
 });
 //# sourceMappingURL=sync.js.map

package/dist/component/sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/component/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE5E,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE;QACJ,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;QAC9B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KACzC;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC5C,OAAO,EAAE,iBAAiB;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC;IAC7B,IAAI,EAAE;QACJ,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClF,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KACzC;IACD,OAAO,EAAE,gBAAgB;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;IAChC,IAAI,EAAE;QACJ,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;KAC5B;IACD,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;IACjB,OAAO,EAAE,gBAAgB;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;IACpC,IAAI,EAAE;QACJ,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KACzC;IACD,OAAO,EAAE,uBAAuB;CACjC,CAAC,CAAC"}
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/component/sync.ts"],"names":[],"mappings":"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"}

package/dist/component/syncIngest.d.ts

@@ -1,6 +1,7 @@
 import type { MutationCtx } from "./_generated/server.js";
 import { type SyncRuntimeInput } from "./syncRuntime.js";
-export type InboundEvent = {
+export type StreamInboundEvent = {
+    type: "stream_delta";
     eventId: string;
     turnId: string;
     streamId: string;
@@ -10,6 +11,15 @@ export type InboundEvent = {
     cursorEnd: number;
     createdAt: number;
 };
+export type LifecycleInboundEvent = {
+    type: "lifecycle_event";
+    eventId: string;
+    turnId?: string;
+    kind: string;
+    payloadJson: string;
+    createdAt: number;
+};
+export type InboundEvent = StreamInboundEvent | LifecycleInboundEvent;
 type PushEventsArgs = {
     actor: {
         tenantId: string;
@@ -18,7 +28,8 @@ type PushEventsArgs = {
     };
     sessionId: string;
     threadId: string;
-    deltas: InboundEvent[];
+    streamDeltas: StreamInboundEvent[];
+    lifecycleEvents: LifecycleInboundEvent[];
     runtime?: SyncRuntimeInput;
 };
 type HeartbeatArgs = {
@@ -31,9 +42,55 @@ type HeartbeatArgs = {
     threadId: string;
     lastEventCursor: number;
 };
-export declare function pushEventsHandler(ctx: MutationCtx, args: PushEventsArgs): Promise<{
-    ackCursor: number;
+type EnsureSessionArgs = HeartbeatArgs;
+type EnsureSessionResult = {
+    sessionId: string;
+    threadId: string;
+    status: "created" | "active";
+};
+type IngestSafeArgs = PushEventsArgs & {
+    ensureLastEventCursor?: number;
+};
+type IngestSafeErrorCode = "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "SESSION_DEVICE_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN";
+type IngestSafeResult = {
+    status: "ok" | "partial" | "session_recovered" | "rejected";
+    ingestStatus: "ok" | "partial";
+    ackedStreams: Array<{
+        streamId: string;
+        ackCursorEnd: number;
+    }>;
+    recovery?: {
+        action: "session_rebound";
+        sessionId: string;
+        threadId: string;
+    };
+    errors: Array<{
+        code: IngestSafeErrorCode;
+        message: string;
+        recoverable: boolean;
+    }>;
+};
+export declare function ingestHandler(ctx: MutationCtx, args: PushEventsArgs): Promise<{
+    ackedStreams: Array<{
+        streamId: string;
+        ackCursorEnd: number;
+    }>;
+    ingestStatus: "ok" | "partial";
+}>;
+export declare function upsertCheckpointHandler(ctx: MutationCtx, args: {
+    actor: {
+        tenantId: string;
+        userId: string;
+        deviceId: string;
+    };
+    threadId: string;
+    streamId: string;
+    cursor: number;
+}): Promise<{
+    ok: true;
 }>;
+export declare function ensureSessionHandler(ctx: MutationCtx, args: EnsureSessionArgs): Promise<EnsureSessionResult>;
 export declare function heartbeatHandler(ctx: MutationCtx, args: HeartbeatArgs): Promise<null>;
+export declare function ingestSafeHandler(ctx: MutationCtx, args: IngestSafeArgs): Promise<IngestSafeResult>;
 export {};
 //# sourceMappingURL=syncIngest.d.ts.map

package/dist/component/syncIngest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncIngest.d.ts","sourceRoot":"","sources":["../../src/component/syncIngest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAa1D,OAAO,EAUL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAuB1B,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAsBF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAmpBhC;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAmDf"}
+{"version":3,"file":"syncIngest.d.ts","sourceRoot":"","sources":["../../src/component/syncIngest.ts"],"names":[],"mappings":"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"}