@zakstam/codex-local-component 0.2.0 → 0.3.0

package/dist/host/convex.d.ts

@@ -0,0 +1,102 @@
+import type { FunctionReference, FunctionReturnType, PaginationOptions } from "convex/server";
+import type { CodexMutationRunner, CodexQueryRunner } from "../client/types.js";
+export type HostStreamArgs = {
+    kind: "list";
+    startOrder?: number;
+} | {
+    kind: "deltas";
+    cursors: Array<{
+        streamId: string;
+        cursor: number;
+    }>;
+};
+export type HostSyncRuntimeOptions = {
+    saveStreamDeltas?: boolean;
+    saveReasoningDeltas?: boolean;
+    exposeRawReasoningDeltas?: boolean;
+    maxDeltasPerStreamRead?: number;
+    maxDeltasPerRequestRead?: number;
+    finishedStreamDeleteDelayMs?: number;
+};
+export type HostMessagesForHooksArgs<Actor> = {
+    actor: Actor;
+    threadId: string;
+    paginationOpts: PaginationOptions;
+    streamArgs?: HostStreamArgs;
+    runtime?: HostSyncRuntimeOptions;
+};
+export type HostReasoningForHooksArgs<Actor> = {
+    actor: Actor;
+    threadId: string;
+    paginationOpts: PaginationOptions;
+    includeRaw?: boolean;
+};
+export declare function listThreadMessagesForHooks<Actor, Component extends {
+    messages: {
+        listByThread: FunctionReference<"query", "public" | "internal", Record<string, unknown>, unknown>;
+    };
+    sync: {
+        replay: FunctionReference<"query", "public" | "internal", Record<string, unknown>, unknown>;
+    };
+}>(ctx: CodexQueryRunner, component: Component, args: HostMessagesForHooksArgs<Actor>): Promise<FunctionReturnType<Component["messages"]["listByThread"]> & {
+    streams?: {
+        kind: "list";
+        streams: Array<{
+            streamId: string;
+            state: string;
+        }>;
+    } | {
+        kind: "deltas";
+        streams: Array<{
+            streamId: string;
+            state: string;
+        }>;
+        deltas: Array<Record<string, unknown>>;
+        streamWindows: Array<{
+            streamId: string;
+            status: "ok" | "rebased" | "stale";
+            serverCursorStart: number;
+            serverCursorEnd: number;
+        }>;
+        nextCheckpoints: Array<{
+            streamId: string;
+            cursor: number;
+        }>;
+    };
+}>;
+export declare function listThreadReasoningForHooks<Actor, Component extends {
+    reasoning: {
+        listByThread: FunctionReference<"query", "public" | "internal", Record<string, unknown>, unknown>;
+    };
+}>(ctx: CodexQueryRunner, component: Component, args: HostReasoningForHooksArgs<Actor>): Promise<FunctionReturnType<Component["reasoning"]["listByThread"]>>;
+export type HostInboundStreamDelta = {
+    type: "stream_delta";
+    eventId: string;
+    turnId: string;
+    streamId: string;
+    kind: string;
+    payloadJson: string;
+    cursorStart: number;
+    cursorEnd: number;
+    createdAt: number;
+};
+export type HostInboundLifecycleEvent = {
+    type: "lifecycle_event";
+    eventId: string;
+    turnId?: string;
+    kind: string;
+    payloadJson: string;
+    createdAt: number;
+};
+export declare function ingestBatchSafe<Actor, Component extends {
+    sync: {
+        ingestSafe: FunctionReference<"mutation", "public" | "internal", Record<string, unknown>, unknown>;
+    };
+}>(ctx: CodexMutationRunner, component: Component, args: {
+    actor: Actor;
+    sessionId: string;
+    threadId: string;
+    deltas: Array<HostInboundStreamDelta | HostInboundLifecycleEvent>;
+    runtime?: HostSyncRuntimeOptions;
+}): Promise<FunctionReturnType<Component["sync"]["ingestSafe"]>>;
+//# sourceMappingURL=convex.d.ts.map

package/dist/host/convex.d.ts.map

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

package/dist/host/convex.js

@@ -0,0 +1,59 @@
+export async function listThreadMessagesForHooks(ctx, component, args) {
+    const paginated = await ctx.runQuery(component.messages.listByThread, {
+        actor: args.actor,
+        threadId: args.threadId,
+        paginationOpts: args.paginationOpts,
+    });
+    const streams = args.streamArgs
+        ? await ctx.runQuery(component.sync.replay, {
+            actor: args.actor,
+            threadId: args.threadId,
+            streamCursorsById: args.streamArgs.kind === "deltas" ? args.streamArgs.cursors : [],
+            ...(args.runtime ? { runtime: args.runtime } : {}),
+        })
+        : undefined;
+    if (args.streamArgs?.kind === "deltas") {
+        return {
+            ...paginated,
+            streams: streams
+                ? {
+                    kind: "deltas",
+                    streams: streams.streams,
+                    deltas: streams.deltas,
+                    streamWindows: streams.streamWindows,
+                    nextCheckpoints: streams.nextCheckpoints,
+                }
+                : undefined,
+        };
+    }
+    return {
+        ...paginated,
+        streams: streams
+            ? {
+                kind: "list",
+                streams: streams.streams,
+            }
+            : undefined,
+    };
+}
+export async function listThreadReasoningForHooks(ctx, component, args) {
+    return ctx.runQuery(component.reasoning.listByThread, {
+        actor: args.actor,
+        threadId: args.threadId,
+        paginationOpts: args.paginationOpts,
+        ...(typeof args.includeRaw === "boolean" ? { includeRaw: args.includeRaw } : {}),
+    });
+}
+export async function ingestBatchSafe(ctx, component, args) {
+    const streamDeltas = args.deltas.filter((delta) => delta.type === "stream_delta");
+    const lifecycleEvents = args.deltas.filter((delta) => delta.type === "lifecycle_event");
+    return ctx.runMutation(component.sync.ingestSafe, {
+        actor: args.actor,
+        sessionId: args.sessionId,
+        threadId: args.threadId,
+        streamDeltas,
+        lifecycleEvents,
+        ...(args.runtime ? { runtime: args.runtime } : {}),
+    });
+}
+//# sourceMappingURL=convex.js.map

package/dist/host/convex.js.map

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