@archastro/sdk 0.15.0 → 0.16.0

package/dist/types/workflows.d.ts

@@ -0,0 +1,544 @@
+import { z } from "zod";
+/** One ordered, replayable record from a durable workflow journal. */
+export interface WorkflowJournalEntry {
+    /** Durable command identifier associated with the record, when present. */
+    command_id?: string | undefined;
+    /** When this entry was durably committed. */
+    created_at?: string | undefined;
+    /** Journal entry ID (`wdr_...`). */
+    id: string;
+    /** Workflow node associated with the record. `null` for execution-level records. */
+    node_id?: string | undefined;
+    /** Replayable workflow record body, including payload, context, environment, metadata, and timestamp. */
+    record: Record<string, unknown>;
+    /** Monotonically increasing sequence within the journal. */
+    sequence: number;
+    /** Durable timer identifier associated with the record, when present. */
+    timer_id?: string | undefined;
+    /** Workflow record type, such as `node_started`, `node_completed`, or `node_failed`. */
+    type: string;
+}
+/** Runtime validator for {@link WorkflowJournalEntry}. */
+export declare const workflowJournalEntrySchema: z.ZodObject<{
+    /** Durable command identifier associated with the record, when present. */
+    command_id: z.ZodOptional<z.ZodString>;
+    /** When this entry was durably committed. */
+    created_at: z.ZodOptional<z.ZodString>;
+    /** Journal entry ID (`wdr_...`). */
+    id: z.ZodString;
+    /** Workflow node associated with the record. `null` for execution-level records. */
+    node_id: z.ZodOptional<z.ZodString>;
+    /** Replayable workflow record body, including payload, context, environment, metadata, and timestamp. */
+    record: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    /** Monotonically increasing sequence within the journal. */
+    sequence: z.ZodNumber;
+    /** Durable timer identifier associated with the record, when present. */
+    timer_id: z.ZodOptional<z.ZodString>;
+    /** Workflow record type, such as `node_started`, `node_completed`, or `node_failed`. */
+    type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    id: string;
+    record: Record<string, {} | null>;
+    sequence: number;
+    created_at?: string | undefined;
+    command_id?: string | undefined;
+    node_id?: string | undefined;
+    timer_id?: string | undefined;
+}, {
+    type: string;
+    id: string;
+    record: Record<string, {} | null>;
+    sequence: number;
+    created_at?: string | undefined;
+    command_id?: string | undefined;
+    node_id?: string | undefined;
+    timer_id?: string | undefined;
+}>;
+/** Summary of the durable workflow execution journal associated with a run. */
+export interface WorkflowJournal {
+    /** When durable workflow execution reached a terminal state. `null` while it is active. */
+    completed_at?: string | undefined;
+    /** When the journal was created. */
+    created_at?: string | undefined;
+    /** Highest workflow record sequence durably committed to this journal. */
+    current_sequence: number;
+    /** Journal execution ID (`wde_...`). */
+    id: string;
+    /** When durable workflow execution started. */
+    started_at?: string | undefined;
+    /** Current durable execution status: `pending`, `running`, `waiting`, `completed`, `failed`, or `cancelled`. */
+    status: string;
+    /** When the journal was last updated. */
+    updated_at?: string | undefined;
+}
+/** Runtime validator for {@link WorkflowJournal}. */
+export declare const workflowJournalSchema: z.ZodObject<{
+    /** When durable workflow execution reached a terminal state. `null` while it is active. */
+    completed_at: z.ZodOptional<z.ZodString>;
+    /** When the journal was created. */
+    created_at: z.ZodOptional<z.ZodString>;
+    /** Highest workflow record sequence durably committed to this journal. */
+    current_sequence: z.ZodNumber;
+    /** Journal execution ID (`wde_...`). */
+    id: z.ZodString;
+    /** When durable workflow execution started. */
+    started_at: z.ZodOptional<z.ZodString>;
+    /** Current durable execution status: `pending`, `running`, `waiting`, `completed`, `failed`, or `cancelled`. */
+    status: z.ZodString;
+    /** When the journal was last updated. */
+    updated_at: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    id: string;
+    current_sequence: number;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    completed_at?: string | undefined;
+    started_at?: string | undefined;
+}, {
+    status: string;
+    id: string;
+    current_sequence: number;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    completed_at?: string | undefined;
+    started_at?: string | undefined;
+}>;
+/** Externally executable work yielded by a durable workflow. */
+export interface WorkflowWorkItem {
+    /** Agent assigned to execute this work. */
+    agent: string;
+    /** Number of times this work has been freshly claimed or reclaimed. */
+    attempt_count: number;
+    /** Opaque journal command identity used to resume the workflow exactly once. */
+    command_id: string;
+    created_at: string;
+    /** Durable workflow execution that owns this work. */
+    execution: string;
+    /** Work item ID (`wdi_...`). */
+    id: string;
+    /** When the current claim expires. Null for queued or terminal work. */
+    lease_expires_at?: string | undefined;
+    /** Workflow graph node that yielded the work. */
+    node_id: string;
+    /** Instructions and participant bindings needed to execute the work. */
+    payload: Record<string, unknown>;
+    /** Routine run that owns the execution, when this work came from a routine. */
+    routine_run?: string | undefined;
+    /** Current queue lifecycle status. */
+    status: string;
+    /** Stable resource discriminator. Always `workflow_work_item`. */
+    type: string;
+    updated_at: string;
+}
+/** Runtime validator for {@link WorkflowWorkItem}. */
+export declare const workflowWorkItemSchema: z.ZodObject<{
+    /** Agent assigned to execute this work. */
+    agent: z.ZodString;
+    /** Number of times this work has been freshly claimed or reclaimed. */
+    attempt_count: z.ZodNumber;
+    /** Opaque journal command identity used to resume the workflow exactly once. */
+    command_id: z.ZodString;
+    created_at: z.ZodString;
+    /** Durable workflow execution that owns this work. */
+    execution: z.ZodString;
+    /** Work item ID (`wdi_...`). */
+    id: z.ZodString;
+    /** When the current claim expires. Null for queued or terminal work. */
+    lease_expires_at: z.ZodOptional<z.ZodString>;
+    /** Workflow graph node that yielded the work. */
+    node_id: z.ZodString;
+    /** Instructions and participant bindings needed to execute the work. */
+    payload: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+    /** Routine run that owns the execution, when this work came from a routine. */
+    routine_run: z.ZodOptional<z.ZodString>;
+    /** Current queue lifecycle status. */
+    status: z.ZodString;
+    /** Stable resource discriminator. Always `workflow_work_item`. */
+    type: z.ZodString;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agent: string;
+    type: string;
+    status: string;
+    payload: Record<string, {} | null>;
+    created_at: string;
+    id: string;
+    updated_at: string;
+    command_id: string;
+    node_id: string;
+    attempt_count: number;
+    execution: string;
+    lease_expires_at?: string | undefined;
+    routine_run?: string | undefined;
+}, {
+    agent: string;
+    type: string;
+    status: string;
+    payload: Record<string, {} | null>;
+    created_at: string;
+    id: string;
+    updated_at: string;
+    command_id: string;
+    node_id: string;
+    attempt_count: number;
+    execution: string;
+    lease_expires_at?: string | undefined;
+    routine_run?: string | undefined;
+}>;
+/** A claimed workflow work item and its caller-held lease token. */
+export interface WorkflowWorkItemLease {
+    /** Opaque lease token that must be persisted and presented for later transitions. */
+    lease_owner: string;
+    /** The claimed, resumed, started, or heartbeated work item. */
+    work_item: WorkflowWorkItem;
+}
+/** Runtime validator for {@link WorkflowWorkItemLease}. */
+export declare const workflowWorkItemLeaseSchema: z.ZodObject<{
+    /** Opaque lease token that must be persisted and presented for later transitions. */
+    lease_owner: z.ZodString;
+    /** The claimed, resumed, started, or heartbeated work item. */
+    work_item: z.ZodObject<{
+        /** Agent assigned to execute this work. */
+        agent: z.ZodString;
+        /** Number of times this work has been freshly claimed or reclaimed. */
+        attempt_count: z.ZodNumber;
+        /** Opaque journal command identity used to resume the workflow exactly once. */
+        command_id: z.ZodString;
+        created_at: z.ZodString;
+        /** Durable workflow execution that owns this work. */
+        execution: z.ZodString;
+        /** Work item ID (`wdi_...`). */
+        id: z.ZodString;
+        /** When the current claim expires. Null for queued or terminal work. */
+        lease_expires_at: z.ZodOptional<z.ZodString>;
+        /** Workflow graph node that yielded the work. */
+        node_id: z.ZodString;
+        /** Instructions and participant bindings needed to execute the work. */
+        payload: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+        /** Routine run that owns the execution, when this work came from a routine. */
+        routine_run: z.ZodOptional<z.ZodString>;
+        /** Current queue lifecycle status. */
+        status: z.ZodString;
+        /** Stable resource discriminator. Always `workflow_work_item`. */
+        type: z.ZodString;
+        updated_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agent: string;
+        type: string;
+        status: string;
+        payload: Record<string, {} | null>;
+        created_at: string;
+        id: string;
+        updated_at: string;
+        command_id: string;
+        node_id: string;
+        attempt_count: number;
+        execution: string;
+        lease_expires_at?: string | undefined;
+        routine_run?: string | undefined;
+    }, {
+        agent: string;
+        type: string;
+        status: string;
+        payload: Record<string, {} | null>;
+        created_at: string;
+        id: string;
+        updated_at: string;
+        command_id: string;
+        node_id: string;
+        attempt_count: number;
+        execution: string;
+        lease_expires_at?: string | undefined;
+        routine_run?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    lease_owner: string;
+    work_item: {
+        agent: string;
+        type: string;
+        status: string;
+        payload: Record<string, {} | null>;
+        created_at: string;
+        id: string;
+        updated_at: string;
+        command_id: string;
+        node_id: string;
+        attempt_count: number;
+        execution: string;
+        lease_expires_at?: string | undefined;
+        routine_run?: string | undefined;
+    };
+}, {
+    lease_owner: string;
+    work_item: {
+        agent: string;
+        type: string;
+        status: string;
+        payload: Record<string, {} | null>;
+        created_at: string;
+        id: string;
+        updated_at: string;
+        command_id: string;
+        node_id: string;
+        attempt_count: number;
+        execution: string;
+        lease_expires_at?: string | undefined;
+        routine_run?: string | undefined;
+    };
+}>;
+/** Result of polling an agent's durable workflow work queue. */
+export interface WorkflowWorkItemClaim {
+    /** Claimed or resumed work and its lease; null when no eligible item exists. */
+    data?: WorkflowWorkItemLease | undefined;
+}
+/** Runtime validator for {@link WorkflowWorkItemClaim}. */
+export declare const workflowWorkItemClaimSchema: z.ZodObject<{
+    /** Claimed or resumed work and its lease; null when no eligible item exists. */
+    data: z.ZodOptional<z.ZodObject<{
+        /** Opaque lease token that must be persisted and presented for later transitions. */
+        lease_owner: z.ZodString;
+        /** The claimed, resumed, started, or heartbeated work item. */
+        work_item: z.ZodObject<{
+            /** Agent assigned to execute this work. */
+            agent: z.ZodString;
+            /** Number of times this work has been freshly claimed or reclaimed. */
+            attempt_count: z.ZodNumber;
+            /** Opaque journal command identity used to resume the workflow exactly once. */
+            command_id: z.ZodString;
+            created_at: z.ZodString;
+            /** Durable workflow execution that owns this work. */
+            execution: z.ZodString;
+            /** Work item ID (`wdi_...`). */
+            id: z.ZodString;
+            /** When the current claim expires. Null for queued or terminal work. */
+            lease_expires_at: z.ZodOptional<z.ZodString>;
+            /** Workflow graph node that yielded the work. */
+            node_id: z.ZodString;
+            /** Instructions and participant bindings needed to execute the work. */
+            payload: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+            /** Routine run that owns the execution, when this work came from a routine. */
+            routine_run: z.ZodOptional<z.ZodString>;
+            /** Current queue lifecycle status. */
+            status: z.ZodString;
+            /** Stable resource discriminator. Always `workflow_work_item`. */
+            type: z.ZodString;
+            updated_at: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            agent: string;
+            type: string;
+            status: string;
+            payload: Record<string, {} | null>;
+            created_at: string;
+            id: string;
+            updated_at: string;
+            command_id: string;
+            node_id: string;
+            attempt_count: number;
+            execution: string;
+            lease_expires_at?: string | undefined;
+            routine_run?: string | undefined;
+        }, {
+            agent: string;
+            type: string;
+            status: string;
+            payload: Record<string, {} | null>;
+            created_at: string;
+            id: string;
+            updated_at: string;
+            command_id: string;
+            node_id: string;
+            attempt_count: number;
+            execution: string;
+            lease_expires_at?: string | undefined;
+            routine_run?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        lease_owner: string;
+        work_item: {
+            agent: string;
+            type: string;
+            status: string;
+            payload: Record<string, {} | null>;
+            created_at: string;
+            id: string;
+            updated_at: string;
+            command_id: string;
+            node_id: string;
+            attempt_count: number;
+            execution: string;
+            lease_expires_at?: string | undefined;
+            routine_run?: string | undefined;
+        };
+    }, {
+        lease_owner: string;
+        work_item: {
+            agent: string;
+            type: string;
+            status: string;
+            payload: Record<string, {} | null>;
+            created_at: string;
+            id: string;
+            updated_at: string;
+            command_id: string;
+            node_id: string;
+            attempt_count: number;
+            execution: string;
+            lease_expires_at?: string | undefined;
+            routine_run?: string | undefined;
+        };
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    data?: {
+        lease_owner: string;
+        work_item: {
+            agent: string;
+            type: string;
+            status: string;
+            payload: Record<string, {} | null>;
+            created_at: string;
+            id: string;
+            updated_at: string;
+            command_id: string;
+            node_id: string;
+            attempt_count: number;
+            execution: string;
+            lease_expires_at?: string | undefined;
+            routine_run?: string | undefined;
+        };
+    } | undefined;
+}, {
+    data?: {
+        lease_owner: string;
+        work_item: {
+            agent: string;
+            type: string;
+            status: string;
+            payload: Record<string, {} | null>;
+            created_at: string;
+            id: string;
+            updated_at: string;
+            command_id: string;
+            node_id: string;
+            attempt_count: number;
+            execution: string;
+            lease_expires_at?: string | undefined;
+            routine_run?: string | undefined;
+        };
+    } | undefined;
+}>;
+/** Active durable workflow work available to the viewer. */
+export interface WorkflowWorkItemList {
+    /** Opaque cursor for the next page, or null at the end. */
+    after_cursor?: string | undefined;
+    /** Always null because queue pagination is forward-only. */
+    before_cursor?: string | undefined;
+    /** Active work items. Lease tokens are intentionally never included in list responses. */
+    data: WorkflowWorkItem[];
+    /** Whether another page of work exists. */
+    has_more: boolean;
+}
+/** Runtime validator for {@link WorkflowWorkItemList}. */
+export declare const workflowWorkItemListSchema: z.ZodObject<{
+    /** Opaque cursor for the next page, or null at the end. */
+    after_cursor: z.ZodOptional<z.ZodString>;
+    /** Always null because queue pagination is forward-only. */
+    before_cursor: z.ZodOptional<z.ZodString>;
+    /** Active work items. Lease tokens are intentionally never included in list responses. */
+    data: z.ZodArray<z.ZodObject<{
+        /** Agent assigned to execute this work. */
+        agent: z.ZodString;
+        /** Number of times this work has been freshly claimed or reclaimed. */
+        attempt_count: z.ZodNumber;
+        /** Opaque journal command identity used to resume the workflow exactly once. */
+        command_id: z.ZodString;
+        created_at: z.ZodString;
+        /** Durable workflow execution that owns this work. */
+        execution: z.ZodString;
+        /** Work item ID (`wdi_...`). */
+        id: z.ZodString;
+        /** When the current claim expires. Null for queued or terminal work. */
+        lease_expires_at: z.ZodOptional<z.ZodString>;
+        /** Workflow graph node that yielded the work. */
+        node_id: z.ZodString;
+        /** Instructions and participant bindings needed to execute the work. */
+        payload: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
+        /** Routine run that owns the execution, when this work came from a routine. */
+        routine_run: z.ZodOptional<z.ZodString>;
+        /** Current queue lifecycle status. */
+        status: z.ZodString;
+        /** Stable resource discriminator. Always `workflow_work_item`. */
+        type: z.ZodString;
+        updated_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agent: string;
+        type: string;
+        status: string;
+        payload: Record<string, {} | null>;
+        created_at: string;
+        id: string;
+        updated_at: string;
+        command_id: string;
+        node_id: string;
+        attempt_count: number;
+        execution: string;
+        lease_expires_at?: string | undefined;
+        routine_run?: string | undefined;
+    }, {
+        agent: string;
+        type: string;
+        status: string;
+        payload: Record<string, {} | null>;
+        created_at: string;
+        id: string;
+        updated_at: string;
+        command_id: string;
+        node_id: string;
+        attempt_count: number;
+        execution: string;
+        lease_expires_at?: string | undefined;
+        routine_run?: string | undefined;
+    }>, "many">;
+    /** Whether another page of work exists. */
+    has_more: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        agent: string;
+        type: string;
+        status: string;
+        payload: Record<string, {} | null>;
+        created_at: string;
+        id: string;
+        updated_at: string;
+        command_id: string;
+        node_id: string;
+        attempt_count: number;
+        execution: string;
+        lease_expires_at?: string | undefined;
+        routine_run?: string | undefined;
+    }[];
+    has_more: boolean;
+    before_cursor?: string | undefined;
+    after_cursor?: string | undefined;
+}, {
+    data: {
+        agent: string;
+        type: string;
+        status: string;
+        payload: Record<string, {} | null>;
+        created_at: string;
+        id: string;
+        updated_at: string;
+        command_id: string;
+        node_id: string;
+        attempt_count: number;
+        execution: string;
+        lease_expires_at?: string | undefined;
+        routine_run?: string | undefined;
+    }[];
+    has_more: boolean;
+    before_cursor?: string | undefined;
+    after_cursor?: string | undefined;
+}>;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/types/workflows.d.ts.map

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

package/dist/types/workflows.js

@@ -0,0 +1,91 @@
+// Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
+// This file is auto-generated by @archastro/sdk-generator. Do not edit.
+// Content hash: 2cf2247d02d7
+import { z } from "zod";
+/** Runtime validator for {@link WorkflowJournalEntry}. */
+export const workflowJournalEntrySchema = z.object({
+    /** Durable command identifier associated with the record, when present. */
+    command_id: z.string().optional().describe("Durable command identifier associated with the record, when present."),
+    /** When this entry was durably committed. */
+    created_at: z.string().optional().describe("When this entry was durably committed."),
+    /** Journal entry ID (`wdr_...`). */
+    id: z.string().describe("Journal entry ID (`wdr_...`)."),
+    /** Workflow node associated with the record. `null` for execution-level records. */
+    node_id: z.string().optional().describe("Workflow node associated with the record. `null` for execution-level records."),
+    /** Replayable workflow record body, including payload, context, environment, metadata, and timestamp. */
+    record: z.record(z.custom((value) => value !== undefined)).describe("Replayable workflow record body, including payload, context, environment, metadata, and timestamp."),
+    /** Monotonically increasing sequence within the journal. */
+    sequence: z.number().int().describe("Monotonically increasing sequence within the journal."),
+    /** Durable timer identifier associated with the record, when present. */
+    timer_id: z.string().optional().describe("Durable timer identifier associated with the record, when present."),
+    /** Workflow record type, such as `node_started`, `node_completed`, or `node_failed`. */
+    type: z.string().describe("Workflow record type, such as `node_started`, `node_completed`, or `node_failed`."),
+}).describe("One ordered, replayable record from a durable workflow journal.");
+/** Runtime validator for {@link WorkflowJournal}. */
+export const workflowJournalSchema = z.object({
+    /** When durable workflow execution reached a terminal state. `null` while it is active. */
+    completed_at: z.string().optional().describe("When durable workflow execution reached a terminal state. `null` while it is active."),
+    /** When the journal was created. */
+    created_at: z.string().optional().describe("When the journal was created."),
+    /** Highest workflow record sequence durably committed to this journal. */
+    current_sequence: z.number().int().describe("Highest workflow record sequence durably committed to this journal."),
+    /** Journal execution ID (`wde_...`). */
+    id: z.string().describe("Journal execution ID (`wde_...`)."),
+    /** When durable workflow execution started. */
+    started_at: z.string().optional().describe("When durable workflow execution started."),
+    /** Current durable execution status: `pending`, `running`, `waiting`, `completed`, `failed`, or `cancelled`. */
+    status: z.string().describe("Current durable execution status: `pending`, `running`, `waiting`, `completed`, `failed`, or `cancelled`."),
+    /** When the journal was last updated. */
+    updated_at: z.string().optional().describe("When the journal was last updated."),
+}).describe("Summary of the durable workflow execution journal associated with a run.");
+/** Runtime validator for {@link WorkflowWorkItem}. */
+export const workflowWorkItemSchema = z.object({
+    /** Agent assigned to execute this work. */
+    agent: z.string().describe("Agent assigned to execute this work."),
+    /** Number of times this work has been freshly claimed or reclaimed. */
+    attempt_count: z.number().int().describe("Number of times this work has been freshly claimed or reclaimed."),
+    /** Opaque journal command identity used to resume the workflow exactly once. */
+    command_id: z.string().describe("Opaque journal command identity used to resume the workflow exactly once."),
+    created_at: z.string(),
+    /** Durable workflow execution that owns this work. */
+    execution: z.string().describe("Durable workflow execution that owns this work."),
+    /** Work item ID (`wdi_...`). */
+    id: z.string().describe("Work item ID (`wdi_...`)."),
+    /** When the current claim expires. Null for queued or terminal work. */
+    lease_expires_at: z.string().optional().describe("When the current claim expires. Null for queued or terminal work."),
+    /** Workflow graph node that yielded the work. */
+    node_id: z.string().describe("Workflow graph node that yielded the work."),
+    /** Instructions and participant bindings needed to execute the work. */
+    payload: z.record(z.custom((value) => value !== undefined)).describe("Instructions and participant bindings needed to execute the work."),
+    /** Routine run that owns the execution, when this work came from a routine. */
+    routine_run: z.string().optional().describe("Routine run that owns the execution, when this work came from a routine."),
+    /** Current queue lifecycle status. */
+    status: z.string().describe("Current queue lifecycle status."),
+    /** Stable resource discriminator. Always `workflow_work_item`. */
+    type: z.string().describe("Stable resource discriminator. Always `workflow_work_item`."),
+    updated_at: z.string(),
+}).describe("Externally executable work yielded by a durable workflow.");
+/** Runtime validator for {@link WorkflowWorkItemLease}. */
+export const workflowWorkItemLeaseSchema = z.object({
+    /** Opaque lease token that must be persisted and presented for later transitions. */
+    lease_owner: z.string().describe("Opaque lease token that must be persisted and presented for later transitions."),
+    /** The claimed, resumed, started, or heartbeated work item. */
+    work_item: workflowWorkItemSchema.describe("The claimed, resumed, started, or heartbeated work item."),
+}).describe("A claimed workflow work item and its caller-held lease token.");
+/** Runtime validator for {@link WorkflowWorkItemClaim}. */
+export const workflowWorkItemClaimSchema = z.object({
+    /** Claimed or resumed work and its lease; null when no eligible item exists. */
+    data: workflowWorkItemLeaseSchema.optional().describe("Claimed or resumed work and its lease; null when no eligible item exists."),
+}).describe("Result of polling an agent's durable workflow work queue.");
+/** Runtime validator for {@link WorkflowWorkItemList}. */
+export const workflowWorkItemListSchema = z.object({
+    /** Opaque cursor for the next page, or null at the end. */
+    after_cursor: z.string().optional().describe("Opaque cursor for the next page, or null at the end."),
+    /** Always null because queue pagination is forward-only. */
+    before_cursor: z.string().optional().describe("Always null because queue pagination is forward-only."),
+    /** Active work items. Lease tokens are intentionally never included in list responses. */
+    data: z.array(workflowWorkItemSchema).describe("Active work items. Lease tokens are intentionally never included in list responses."),
+    /** Whether another page of work exists. */
+    has_more: z.boolean().describe("Whether another page of work exists."),
+}).describe("Active durable workflow work available to the viewer.");
+//# sourceMappingURL=workflows.js.map

package/dist/types/workflows.js.map

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