@lleverage-ai/agent-sdk 0.0.1

package/dist/checkpointer/types.js

@@ -0,0 +1,159 @@
+/**
+ * Type definitions for the checkpointer system.
+ *
+ * Checkpointers provide session persistence and resumption across conversations,
+ * allowing agents to save and restore their state including message history,
+ * todos, files, and pending tool approvals.
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Create a new checkpoint with the given data.
+ *
+ * This is a convenience function that ensures timestamps are set correctly.
+ *
+ * @param data - Partial checkpoint data (threadId and messages required)
+ * @returns A complete checkpoint object
+ *
+ * @example
+ * ```typescript
+ * const checkpoint = createCheckpoint({
+ *   threadId: "session-123",
+ *   messages: [...],
+ *   state: { todos: [], files: {} },
+ * });
+ * ```
+ *
+ * @category Checkpointer
+ */
+export function createCheckpoint(data) {
+    const now = new Date().toISOString();
+    return {
+        step: 0,
+        createdAt: now,
+        updatedAt: now,
+        ...data,
+    };
+}
+/**
+ * Update an existing checkpoint with new data.
+ *
+ * Automatically updates the `updatedAt` timestamp and increments step.
+ *
+ * @param checkpoint - The existing checkpoint
+ * @param updates - Partial updates to apply
+ * @returns A new checkpoint object with updates applied
+ *
+ * @example
+ * ```typescript
+ * const updated = updateCheckpoint(checkpoint, {
+ *   messages: [...newMessages],
+ *   step: checkpoint.step + 1,
+ * });
+ * ```
+ *
+ * @category Checkpointer
+ */
+export function updateCheckpoint(checkpoint, updates) {
+    return {
+        ...checkpoint,
+        ...updates,
+        updatedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Type guard to check if an object is a valid Checkpoint.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid Checkpoint
+ *
+ * @category Checkpointer
+ */
+export function isCheckpoint(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.threadId === "string" &&
+        typeof obj.step === "number" &&
+        Array.isArray(obj.messages) &&
+        typeof obj.state === "object" &&
+        obj.state !== null &&
+        typeof obj.createdAt === "string" &&
+        typeof obj.updatedAt === "string");
+}
+/**
+ * Type guard to check if an object is a valid Interrupt.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid Interrupt
+ *
+ * @category Checkpointer
+ */
+export function isInterrupt(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.id === "string" &&
+        typeof obj.threadId === "string" &&
+        typeof obj.type === "string" &&
+        typeof obj.step === "number" &&
+        typeof obj.createdAt === "string" &&
+        obj.request !== undefined);
+}
+/**
+ * Type guard to check if an interrupt is an ApprovalInterrupt.
+ *
+ * @param interrupt - The interrupt to check
+ * @returns True if the interrupt is an ApprovalInterrupt
+ *
+ * @category Checkpointer
+ */
+export function isApprovalInterrupt(interrupt) {
+    return (interrupt.type === "approval" &&
+        typeof interrupt.toolCallId === "string" &&
+        typeof interrupt.toolName === "string");
+}
+/**
+ * Create a new interrupt with the given data.
+ *
+ * @param data - Partial interrupt data (id, threadId, type, and request required)
+ * @returns A complete interrupt object
+ *
+ * @category Checkpointer
+ */
+export function createInterrupt(data) {
+    return {
+        step: 0,
+        createdAt: new Date().toISOString(),
+        ...data,
+    };
+}
+/**
+ * Create an approval interrupt for a tool call.
+ *
+ * @param data - The approval interrupt data
+ * @returns A complete ApprovalInterrupt object
+ *
+ * @category Checkpointer
+ */
+export function createApprovalInterrupt(data) {
+    return {
+        id: data.id,
+        threadId: data.threadId,
+        type: "approval",
+        toolCallId: data.toolCallId,
+        toolName: data.toolName,
+        request: {
+            toolName: data.toolName,
+            args: data.args,
+        },
+        step: data.step ?? 0,
+        createdAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/checkpointer/types.js.map

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