@aikirun/types 0.17.0 → 0.19.0

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { ScheduleApi } from './schedule-api.js';
 import { WorkflowMeta } from './workflow.js';
-import { WorkflowRun, WorkflowRunId } from './workflow-run.js';
+import { WorkflowRunId, WorkflowRun } from './workflow-run.js';
 import { WorkflowRunApi } from './workflow-run-api.js';
 import { INTERNAL } from './symbols.js';
 import './schedule.js';
@@ -12,11 +12,12 @@ import './serializable.js';
 import './sleep.js';
 import './task.js';
 import './trigger.js';
+import './state-transition.js';
 
 interface ClientParams<AppContext = unknown> {
     url: string;
     apiKey?: string;
-    redis: RedisConfig;
+    redis?: RedisConfig;
     logger?: Logger;
     createContext?: (run: Readonly<WorkflowRun>) => AppContext | Promise<AppContext>;
 }
@@ -65,16 +66,10 @@ interface RedisConnection {
     getConnection: () => RedisClient;
     closeConnection: () => Promise<void>;
 }
-interface SubscriberMessageMeta {
-    stream: string;
-    messageId: string;
-    consumerGroup: string;
-}
 interface WorkflowRunBatch {
     data: {
         workflowRunId: WorkflowRunId;
     };
-    meta?: SubscriberMessageMeta;
 }
 type SubscriberDelayParams = {
     type: "polled";
@@ -91,34 +86,25 @@ interface ResolvedSubscriberStrategy {
     type: string;
     getNextDelay: (context: SubscriberDelayParams) => number;
     getNextBatch: (size: number) => Promise<WorkflowRunBatch[]>;
-    heartbeat?: (workflowRunId: WorkflowRunId, meta: SubscriberMessageMeta) => Promise<void>;
-    acknowledge?: (workerId: string, workflowRunId: WorkflowRunId, meta: SubscriberMessageMeta) => Promise<void>;
+    heartbeat?: (workflowRunId: WorkflowRunId) => Promise<void>;
+    acknowledge?: (workflowRunId: WorkflowRunId) => Promise<void>;
 }
-interface PollingSubscriberStrategy {
-    type: "polling";
+interface RedisStreamsSubscriberStrategy {
+    type: "redis";
     intervalMs?: number;
     maxRetryIntervalMs?: number;
     atCapacityIntervalMs?: number;
+    blockTimeMs?: number;
+    claimMinIdleTimeMs?: number;
 }
-interface AdaptivePollingSubscriberStrategy {
-    type: "adaptive_polling";
-    minPollIntervalMs?: number;
-    maxPollIntervalMs?: number;
-    backoffMultiplier?: number;
-    emptyPollThreshold?: number;
-    jitterFactor?: number;
-    successResetThreshold?: number;
-    atCapacityIntervalMs?: number;
-}
-interface RedisStreamsSubscriberStrategy {
-    type: "redis";
+interface DbSubscriberStrategy {
+    type: "db";
     intervalMs?: number;
     maxRetryIntervalMs?: number;
     atCapacityIntervalMs?: number;
-    blockTimeMs?: number;
     claimMinIdleTimeMs?: number;
 }
-type SubscriberStrategy = RedisStreamsSubscriberStrategy;
+type SubscriberStrategy = RedisStreamsSubscriberStrategy | DbSubscriberStrategy;
 interface SubscriberStrategyBuilder {
     init: (workerId: string, callbacks: StrategyCallbacks) => Promise<ResolvedSubscriberStrategy>;
 }
@@ -127,4 +113,4 @@ interface StrategyCallbacks {
     onStop?: () => Promise<void>;
 }
 
-export type { AdaptivePollingSubscriberStrategy, ApiClient, Client, ClientParams, Logger, PollingSubscriberStrategy, RedisClient, RedisConfig, RedisConnection, RedisStreamsSubscriberStrategy, ResolvedSubscriberStrategy, StrategyCallbacks, SubscriberDelayParams, SubscriberMessageMeta, SubscriberStrategy, SubscriberStrategyBuilder, WorkflowRunBatch };
+export type { ApiClient, Client, ClientParams, DbSubscriberStrategy, Logger, RedisClient, RedisConfig, RedisConnection, RedisStreamsSubscriberStrategy, ResolvedSubscriberStrategy, StrategyCallbacks, SubscriberDelayParams, SubscriberStrategy, SubscriberStrategyBuilder, WorkflowRunBatch };

package/dist/event.d.ts

@@ -6,22 +6,22 @@ type EventName = string & {
 };
 declare const EVENT_WAIT_STATUSES: readonly ["received", "timeout"];
 type EventWaitStatus = (typeof EVENT_WAIT_STATUSES)[number];
-interface EventWaitStateBase {
+interface EventWaitBase {
     status: EventWaitStatus;
 }
-interface EventWaitStateReceived<Data> extends EventWaitStateBase {
+interface EventWaitReceived<Data> extends EventWaitBase {
     status: "received";
     data?: Data;
     receivedAt: number;
     reference?: EventReferenceOptions;
 }
-interface EventWaitStateTimeout extends EventWaitStateBase {
+interface EventWaitTimeout extends EventWaitBase {
     status: "timeout";
     timedOutAt: number;
 }
-type EventWaitState<Data> = EventWaitStateReceived<Data> | EventWaitStateTimeout;
+type EventWait<Data> = EventWaitReceived<Data> | EventWaitTimeout;
 interface EventWaitQueue<Data> {
-    eventWaits: EventWaitState<Data>[];
+    eventWaits: EventWait<Data>[];
 }
 interface EventWaitOptions<Timed extends boolean> {
     timeout?: Timed extends true ? DurationObject : never;
@@ -41,4 +41,4 @@ interface EventReferenceOptions {
     id: string;
 }
 
-export { EVENT_WAIT_STATUSES, type EventName, type EventReferenceOptions, type EventSendOptions, type EventWaitOptions, type EventWaitQueue, type EventWaitResult, type EventWaitState, type EventWaitStateReceived, type EventWaitStateTimeout, type EventWaitStatus };
+export { EVENT_WAIT_STATUSES, type EventName, type EventReferenceOptions, type EventSendOptions, type EventWait, type EventWaitOptions, type EventWaitQueue, type EventWaitReceived, type EventWaitResult, type EventWaitStatus, type EventWaitTimeout };

package/dist/namespace.d.ts

@@ -0,0 +1,5 @@
+type NamespaceId = string & {
+    _brand: "namespace_id";
+};
+
+export type { NamespaceId };

package/dist/organization.d.ts

@@ -0,0 +1,5 @@
+type OrganizationId = string & {
+    _brand: "organization_id";
+};
+
+export type { OrganizationId };

package/dist/schedule-api.d.ts

@@ -1,12 +1,13 @@
 import { ScheduleSpec, ScheduleActivateOptions, Schedule, ScheduleStatus } from './schedule.js';
+import { WorkflowSource } from './workflow.js';
 
 interface ScheduleApi {
     activateV1: (_: ScheduleActivateRequestV1) => Promise<ScheduleActivateResponseV1>;
     getByIdV1: (_: ScheduleGetByIdRequestV1) => Promise<ScheduleGetByIdResponseV1>;
     getByReferenceIdV1: (_: ScheduleGetByReferenceIdRequestV1) => Promise<ScheduleGetByReferenceIdResponseV1>;
     listV1: (_: ScheduleListRequestV1) => Promise<ScheduleListResponseV1>;
-    pauseV1: (_: SchedulePauseRequestV1) => Promise<SchedulePauseResponseV1>;
-    resumeV1: (_: ScheduleResumeRequestV1) => Promise<ScheduleResumeResponseV1>;
+    pauseV1: (_: SchedulePauseRequestV1) => Promise<void>;
+    resumeV1: (_: ScheduleResumeRequestV1) => Promise<void>;
     deleteV1: (_: ScheduleDeleteRequestV1) => Promise<void>;
 }
 interface ScheduleActivateRequestV1 {
@@ -24,16 +25,19 @@ interface ScheduleGetByIdRequestV1 {
 }
 interface ScheduleGetByIdResponseV1 {
     schedule: Schedule;
+    runCount: number;
 }
 interface ScheduleGetByReferenceIdRequestV1 {
     referenceId: string;
 }
 interface ScheduleGetByReferenceIdResponseV1 {
     schedule: Schedule;
+    runCount: number;
 }
 interface ScheduleWorkflowFilter {
-    name?: string;
+    name: string;
     versionId?: string;
+    source: WorkflowSource;
 }
 interface ScheduleListRequestV1 {
     limit?: number;
@@ -46,23 +50,20 @@ interface ScheduleListRequestV1 {
     };
 }
 interface ScheduleListResponseV1 {
-    schedules: Schedule[];
+    schedules: {
+        schedule: Schedule;
+        runCount: number;
+    }[];
     total: number;
 }
 interface SchedulePauseRequestV1 {
     id: string;
 }
-interface SchedulePauseResponseV1 {
-    schedule: Schedule;
-}
 interface ScheduleResumeRequestV1 {
     id: string;
 }
-interface ScheduleResumeResponseV1 {
-    schedule: Schedule;
-}
 interface ScheduleDeleteRequestV1 {
     id: string;
 }
 
-export type { ScheduleActivateRequestV1, ScheduleActivateResponseV1, ScheduleApi, ScheduleDeleteRequestV1, ScheduleGetByIdRequestV1, ScheduleGetByIdResponseV1, ScheduleGetByReferenceIdRequestV1, ScheduleGetByReferenceIdResponseV1, ScheduleListRequestV1, ScheduleListResponseV1, SchedulePauseRequestV1, SchedulePauseResponseV1, ScheduleResumeRequestV1, ScheduleResumeResponseV1, ScheduleWorkflowFilter };
+export type { ScheduleActivateRequestV1, ScheduleActivateResponseV1, ScheduleApi, ScheduleDeleteRequestV1, ScheduleGetByIdRequestV1, ScheduleGetByIdResponseV1, ScheduleGetByReferenceIdRequestV1, ScheduleGetByReferenceIdResponseV1, ScheduleListRequestV1, ScheduleListResponseV1, SchedulePauseRequestV1, ScheduleResumeRequestV1, ScheduleWorkflowFilter };

package/dist/schedule.d.ts

@@ -42,7 +42,6 @@ interface Schedule {
     updatedAt: number;
     lastOccurrence?: number;
     nextRunAt: number;
-    runCount: number;
 }
 
 export { type CronScheduleSpec, type IntervalScheduleSpec, SCHEDULE_CONFLICT_POLICIES, SCHEDULE_OVERLAP_POLICIES, SCHEDULE_STATUSES, SCHEDULE_TYPES, type Schedule, type ScheduleActivateOptions, type ScheduleConflictPolicy, type ScheduleId, type ScheduleOverlapPolicy, type ScheduleReferenceOptions, type ScheduleSpec, type ScheduleStatus, type ScheduleType };

package/dist/sleep.d.ts

@@ -3,28 +3,28 @@ type SleepName = string & {
 };
 declare const SLEEP_STATUSES: readonly ["sleeping", "completed", "cancelled"];
 type SleepStatus = (typeof SLEEP_STATUSES)[number];
-interface SleepStateBase {
+interface SleepBase {
     status: SleepStatus;
 }
-interface SleepStateSleeping extends SleepStateBase {
+interface SleepSleeping extends SleepBase {
     status: "sleeping";
     awakeAt: number;
 }
-interface SleepStateCompleted extends SleepStateBase {
+interface SleepCompleted extends SleepBase {
     status: "completed";
     durationMs: number;
     completedAt: number;
 }
-interface SleepStateCancelled extends SleepStateBase {
+interface SleepCancelled extends SleepBase {
     status: "cancelled";
     cancelledAt: number;
 }
-type SleepState = SleepStateSleeping | SleepStateCompleted | SleepStateCancelled;
+type Sleep = SleepSleeping | SleepCompleted | SleepCancelled;
 interface SleepQueue {
-    sleeps: SleepState[];
+    sleeps: Sleep[];
 }
 interface SleepResult {
     cancelled: boolean;
 }
 
-export { SLEEP_STATUSES, type SleepName, type SleepQueue, type SleepResult, type SleepState, type SleepStateCancelled, type SleepStateCompleted, type SleepStateSleeping, type SleepStatus };
+export { SLEEP_STATUSES, type Sleep, type SleepCancelled, type SleepCompleted, type SleepName, type SleepQueue, type SleepResult, type SleepSleeping, type SleepStatus };

package/dist/state-transition.d.ts

@@ -0,0 +1,29 @@
+import { TaskState } from './task.js';
+import { WorkflowRunState } from './workflow-run.js';
+import './retry.js';
+import './serializable.js';
+import './utils.js';
+import './event.js';
+import './duration.js';
+import './sleep.js';
+import './trigger.js';
+
+declare const STATE_TRANSITION_TYPES: readonly ["workflow_run", "task"];
+type StateTransitionType = (typeof STATE_TRANSITION_TYPES)[number];
+interface StateTransitionBase {
+    id: string;
+    createdAt: number;
+    type: StateTransitionType;
+}
+interface WorkflowRunStateTransition extends StateTransitionBase {
+    type: "workflow_run";
+    state: WorkflowRunState;
+}
+interface TaskStateTransition extends StateTransitionBase {
+    type: "task";
+    taskId: string;
+    taskState: TaskState;
+}
+type StateTransition = WorkflowRunStateTransition | TaskStateTransition;
+
+export { STATE_TRANSITION_TYPES, type StateTransition, type StateTransitionBase, type StateTransitionType, type TaskStateTransition, type WorkflowRunStateTransition };

package/dist/state-transition.js

@@ -0,0 +1,5 @@
+// state-transition.ts
+var STATE_TRANSITION_TYPES = ["workflow_run", "task"];
+export {
+  STATE_TRANSITION_TYPES
+};

package/dist/task.d.ts

@@ -17,13 +17,6 @@ interface TaskDefinitionOptions {
     retry?: RetryStrategy;
 }
 interface TaskStartOptions extends TaskDefinitionOptions {
-    reference?: TaskReferenceOptions;
-}
-declare const TASK_CONFLICT_POLICIES: readonly ["error", "return_existing"];
-type TaskConflictPolicy = (typeof TASK_CONFLICT_POLICIES)[number];
-interface TaskReferenceOptions {
-    id: string;
-    conflictPolicy?: TaskConflictPolicy;
 }
 interface TaskStateBase {
     status: TaskStatus;
@@ -58,7 +51,7 @@ interface TaskInfo {
 }
 interface TransitionTaskStateBase {
     id: string;
-    expectedRevision: number;
+    expectedWorkflowRunRevision: number;
 }
 interface TransitionTaskStateToRunningCreate extends TransitionTaskStateBase {
     type: "create";
@@ -89,6 +82,9 @@ interface TransitionTaskStateToAwaitingRetry extends TransitionTaskStateBase {
 type TaskStateAwaitingRetryRequest = Omit<TaskStateAwaitingRetry, "nextAttemptAt"> & {
     nextAttemptInMs: number;
 };
+interface TaskQueue {
+    tasks: TaskInfo[];
+}
 declare class TaskFailedError extends Error {
     readonly taskId: TaskId;
     readonly attempts: number;
@@ -96,4 +92,4 @@ declare class TaskFailedError extends Error {
     constructor(taskId: TaskId, attempts: number, reason: string);
 }
 
-export { TASK_CONFLICT_POLICIES, TASK_STATUSES, type TaskAddress, type TaskConflictPolicy, type TaskDefinitionOptions, TaskFailedError, type TaskId, type TaskInfo, type TaskName, type TaskReferenceOptions, type TaskStartOptions, type TaskState, type TaskStateAwaitingRetry, type TaskStateAwaitingRetryRequest, type TaskStateCompleted, type TaskStateCompletedRequest, type TaskStateFailed, type TaskStateRunning, type TaskStateRunningRequest, type TaskStatus, type TransitionTaskStateBase, type TransitionTaskStateToAwaitingRetry, type TransitionTaskStateToCompleted, type TransitionTaskStateToFailed, type TransitionTaskStateToRunningCreate, type TransitionTaskStateToRunningRetry };
+export { TASK_STATUSES, type TaskAddress, type TaskDefinitionOptions, TaskFailedError, type TaskId, type TaskInfo, type TaskName, type TaskQueue, type TaskStartOptions, type TaskState, type TaskStateAwaitingRetry, type TaskStateAwaitingRetryRequest, type TaskStateCompleted, type TaskStateCompletedRequest, type TaskStateFailed, type TaskStateRunning, type TaskStateRunningRequest, type TaskStatus, type TransitionTaskStateBase, type TransitionTaskStateToAwaitingRetry, type TransitionTaskStateToCompleted, type TransitionTaskStateToFailed, type TransitionTaskStateToRunningCreate, type TransitionTaskStateToRunningRetry };

package/dist/task.js

@@ -1,6 +1,5 @@
 // task.ts
 var TASK_STATUSES = ["running", "awaiting_retry", "completed", "failed"];
-var TASK_CONFLICT_POLICIES = ["error", "return_existing"];
 var TaskFailedError = class extends Error {
   taskId;
   attempts;
@@ -14,7 +13,6 @@ var TaskFailedError = class extends Error {
   }
 };
 export {
-  TASK_CONFLICT_POLICIES,
   TASK_STATUSES,
   TaskFailedError
 };

package/dist/workflow-api.d.ts

@@ -1,3 +1,4 @@
+import { WorkflowSource } from './workflow.js';
 import { WorkflowRunStatus } from './workflow-run.js';
 import './event.js';
 import './duration.js';
@@ -9,22 +10,12 @@ import './task.js';
 import './trigger.js';
 
 interface WorkflowApi {
-    getStatsV1: (_: WorkflowGetStatsRequestV1) => Promise<WorkflowGetStatsResponseV1>;
     listV1: (_: WorkflowListRequestV1) => Promise<WorkflowListResponseV1>;
     listVersionsV1: (_: WorkflowListVersionsRequestV1) => Promise<WorkflowListVersionsResponseV1>;
-}
-interface WorkflowGetStatsRequestV1 {
-    name?: string;
-    versionId?: string;
-}
-interface WorkflowGetStatsResponseV1 {
-    stats: WorkflowStats;
-}
-interface WorkflowStats {
-    totalRuns: number;
-    runsByStatus: Record<WorkflowRunStatus, number>;
+    getStatsV1: (_: WorkflowGetStatsRequestV1) => Promise<WorkflowGetStatsResponseV1>;
 }
 interface WorkflowListRequestV1 {
+    source: WorkflowSource;
     limit?: number;
     offset?: number;
     sort?: {
@@ -34,6 +25,7 @@ interface WorkflowListRequestV1 {
 }
 interface WorkflowListItem {
     name: string;
+    source: WorkflowSource;
     runCount: number;
     lastRunAt: number | null;
 }
@@ -43,6 +35,7 @@ interface WorkflowListResponseV1 {
 }
 interface WorkflowListVersionsRequestV1 {
     name: string;
+    source: WorkflowSource;
     limit?: number;
     offset?: number;
     sort?: {
@@ -60,5 +53,16 @@ interface WorkflowListVersionsResponseV1 {
     versions: WorkflowVersionItem[];
     total: number;
 }
+type WorkflowGetStatsRequestV1 = {
+    name: string;
+    source: WorkflowSource;
+    versionId?: string;
+} | undefined;
+interface WorkflowGetStatsResponseV1 {
+    stats: WorkflowStats;
+}
+interface WorkflowStats {
+    runsByStatus: Record<WorkflowRunStatus, number>;
+}
 
 export type { WorkflowApi, WorkflowGetStatsRequestV1, WorkflowGetStatsResponseV1, WorkflowListItem, WorkflowListRequestV1, WorkflowListResponseV1, WorkflowListVersionsRequestV1, WorkflowListVersionsResponseV1, WorkflowStats, WorkflowVersionItem };

package/dist/workflow-run-api.d.ts

@@ -1,7 +1,9 @@
 import { EventSendOptions } from './event.js';
-import { TransitionTaskStateToRunningCreate, TransitionTaskStateToRunningRetry, TransitionTaskStateToCompleted, TransitionTaskStateToFailed, TransitionTaskStateToAwaitingRetry, TaskStateCompleted, TaskStateFailed } from './task.js';
+import { StateTransition } from './state-transition.js';
+import { TransitionTaskStateToRunningCreate, TransitionTaskStateToRunningRetry, TransitionTaskStateToCompleted, TransitionTaskStateToFailed, TransitionTaskStateToAwaitingRetry, TaskInfo, TaskStateCompleted, TaskStateFailed } from './task.js';
 import { DistributiveOmit, OptionalProp } from './utils.js';
-import { WorkflowRunStatus, WorkflowRun, WorkflowRunState, WorkflowStartOptions, WorkflowRunStateScheduled, WorkflowRunStateSleeping, WorkflowRunStateAwaitingEvent, WorkflowRunStateAwaitingRetry, WorkflowRunStateAwaitingChildWorkflow, WorkflowRunStateCompleted, WorkflowRunStatePaused, WorkflowRunStateCancelled, WorkflowRunTransition } from './workflow-run.js';
+import { WorkflowSource } from './workflow.js';
+import { WorkflowRunStatus, WorkflowRun, WorkflowRunState, WorkflowStartOptions, WorkflowRunStateScheduled, WorkflowRunStateSleeping, WorkflowRunStateAwaitingEvent, WorkflowRunStateAwaitingRetry, WorkflowRunStateAwaitingChildWorkflow, WorkflowRunStateCompleted, WorkflowRunStatePaused, WorkflowRunStateCancelled } from './workflow-run.js';
 import './duration.js';
 import './retry.js';
 import './serializable.js';
@@ -16,10 +18,15 @@ interface WorkflowRunApi {
     createV1: (_: WorkflowRunCreateRequestV1) => Promise<WorkflowRunCreateResponseV1>;
     transitionStateV1: (_: WorkflowRunTransitionStateRequestV1) => Promise<WorkflowRunTransitionStateResponseV1>;
     transitionTaskStateV1: (_: WorkflowRunTransitionTaskStateRequestV1) => Promise<WorkflowRunTransitionTaskStateResponseV1>;
-    setTaskStateV1: (_: WorkflowRunSetTaskStateRequestV1) => Promise<WorkflowRunSetTaskStateResponseV1>;
+    setTaskStateV1: (_: WorkflowRunSetTaskStateRequestV1) => Promise<void>;
     listTransitionsV1: (_: WorkflowRunListTransitionsRequestV1) => Promise<WorkflowRunListTransitionsResponseV1>;
-    sendEventV1: (_: WorkflowRunSendEventRequestV1) => Promise<WorkflowRunSendEventResponseV1>;
+    sendEventV1: (_: WorkflowRunSendEventRequestV1) => Promise<void>;
     multicastEventV1: (_: WorkflowRunMulticastEventRequestV1) => Promise<void>;
+    multicastEventByReferenceV1: (_: WorkflowRunMulticastEventByReferenceRequestV1) => Promise<void>;
+    listChildRunsV1: (_: WorkflowRunListChildRunsRequestV1) => Promise<WorkflowRunListChildRunsResponseV1>;
+    cancelByIdsV1: (_: WorkflowRunCancelByIdsRequestV1) => Promise<WorkflowRunCancelByIdsResponseV1>;
+    claimReadyV1: (_: WorkflowRunClaimReadyRequestV1) => Promise<WorkflowRunClaimReadyResponseV1>;
+    heartbeatV1: (_: WorkflowRunHeartbeatRequestV1) => Promise<void>;
 }
 interface WorkflowRunListRequestV1 {
     limit?: number;
@@ -27,18 +34,25 @@ interface WorkflowRunListRequestV1 {
     filters?: {
         id?: string;
         status?: WorkflowRunStatus[];
-        workflows?: WorkflowFilter[];
+        workflow?: WorkflowFilter;
     };
     sort?: {
-        field: "createdAt";
         order: "asc" | "desc";
     };
 }
-interface WorkflowFilter {
+type WorkflowFilter = {
     name: string;
-    versionId?: string;
-    referenceId?: string;
-}
+    source: WorkflowSource;
+} | {
+    name: string;
+    source: WorkflowSource;
+    versionId: string;
+} | {
+    name: string;
+    source: WorkflowSource;
+    versionId: string;
+    referenceId: string;
+};
 interface WorkflowRunListItem {
     id: string;
     name: string;
@@ -57,11 +71,12 @@ interface WorkflowRunGetByIdRequestV1 {
 interface WorkflowRunGetByIdResponseV1 {
     run: WorkflowRun;
 }
-interface WorkflowRunGetByReferenceIdRequestV1 {
+interface WorkflowRunReference {
     name: string;
     versionId: string;
     referenceId: string;
 }
+type WorkflowRunGetByReferenceIdRequestV1 = WorkflowRunReference;
 interface WorkflowRunGetByReferenceIdResponseV1 {
     run: WorkflowRun;
 }
@@ -79,7 +94,7 @@ interface WorkflowRunCreateRequestV1 {
     options?: WorkflowStartOptions;
 }
 interface WorkflowRunCreateResponseV1 {
-    run: WorkflowRun;
+    id: string;
 }
 type WorkflowRunStateScheduledRequest = DistributiveOmit<WorkflowRunStateScheduled, "scheduledAt"> & {
     scheduledInMs: number;
@@ -124,22 +139,20 @@ interface WorkflowRunTransitionStateRequestPessimistic extends WorkflowRunTransi
 }
 type WorkflowRunTransitionStateRequestV1 = WorkflowRunTransitionStateRequestOptimistic | WorkflowRunTransitionStateRequestPessimistic;
 interface WorkflowRunTransitionStateResponseV1 {
-    run: WorkflowRun;
+    revision: number;
+    state: WorkflowRunState;
+    attempts: number;
 }
 type TransitionTaskStateToRunning = TransitionTaskStateToRunningCreate | TransitionTaskStateToRunningRetry;
 type WorkflowRunTransitionTaskStateRequestV1 = TransitionTaskStateToRunning | TransitionTaskStateToCompleted | TransitionTaskStateToFailed | TransitionTaskStateToAwaitingRetry;
 interface WorkflowRunTransitionTaskStateResponseV1 {
-    run: WorkflowRun;
-    taskId: string;
+    taskInfo: TaskInfo;
 }
 interface WorkflowRunSetTaskStateRequestNew {
     type: "new";
     id: string;
     taskName: string;
     input?: unknown;
-    reference?: {
-        id: string;
-    };
     state: DistributiveOmit<TaskStateCompleted<unknown> | TaskStateFailed, "attempts">;
 }
 interface WorkflowRunSetTaskStateRequestExisting {
@@ -149,20 +162,16 @@ interface WorkflowRunSetTaskStateRequestExisting {
     state: DistributiveOmit<TaskStateCompleted<unknown> | TaskStateFailed, "attempts">;
 }
 type WorkflowRunSetTaskStateRequestV1 = WorkflowRunSetTaskStateRequestNew | WorkflowRunSetTaskStateRequestExisting;
-interface WorkflowRunSetTaskStateResponseV1 {
-    run: WorkflowRun;
-}
 interface WorkflowRunListTransitionsRequestV1 {
     id: string;
     limit?: number;
     offset?: number;
     sort?: {
-        field: "createdAt";
         order: "asc" | "desc";
     };
 }
 interface WorkflowRunListTransitionsResponseV1 {
-    transitions: WorkflowRunTransition[];
+    transitions: StateTransition[];
     total: number;
 }
 interface WorkflowRunSendEventRequestV1 {
@@ -171,14 +180,53 @@ interface WorkflowRunSendEventRequestV1 {
     data?: unknown;
     options?: EventSendOptions;
 }
-interface WorkflowRunSendEventResponseV1 {
-    run: WorkflowRun;
-}
 interface WorkflowRunMulticastEventRequestV1 {
     ids: string[];
     eventName: string;
     data?: unknown;
     options?: EventSendOptions;
 }
+interface WorkflowRunMulticastEventByReferenceRequestV1 {
+    references: WorkflowRunReference[];
+    eventName: string;
+    data?: unknown;
+    options?: EventSendOptions;
+}
+interface WorkflowRunListChildRunsRequestV1 {
+    parentRunId: string;
+    status?: WorkflowRunStatus[];
+}
+interface WorkflowRunListChildRunsResponseV1 {
+    runs: Array<{
+        id: string;
+        options?: {
+            shard?: string;
+        };
+    }>;
+}
+interface WorkflowRunCancelByIdsRequestV1 {
+    ids: string[];
+}
+interface WorkflowRunCancelByIdsResponseV1 {
+    cancelledIds: string[];
+}
+interface WorkflowRunClaimReadyRequestV1 {
+    workerId: string;
+    workflows: Array<{
+        name: string;
+        versionId: string;
+        shard?: string;
+    }>;
+    limit: number;
+    claimMinIdleTimeMs: number;
+}
+interface WorkflowRunClaimReadyResponseV1 {
+    runs: Array<{
+        id: string;
+    }>;
+}
+interface WorkflowRunHeartbeatRequestV1 {
+    id: string;
+}
 
-export type { TransitionTaskStateToRunning, WorkflowFilter, WorkflowRunApi, WorkflowRunCreateRequestV1, WorkflowRunCreateResponseV1, WorkflowRunGetByIdRequestV1, WorkflowRunGetByIdResponseV1, WorkflowRunGetByReferenceIdRequestV1, WorkflowRunGetByReferenceIdResponseV1, WorkflowRunGetStateRequestV1, WorkflowRunGetStateResponseV1, WorkflowRunListItem, WorkflowRunListRequestV1, WorkflowRunListResponseV1, WorkflowRunListTransitionsRequestV1, WorkflowRunListTransitionsResponseV1, WorkflowRunMulticastEventRequestV1, WorkflowRunSendEventRequestV1, WorkflowRunSendEventResponseV1, WorkflowRunSetTaskStateRequestExisting, WorkflowRunSetTaskStateRequestNew, WorkflowRunSetTaskStateRequestV1, WorkflowRunSetTaskStateResponseV1, WorkflowRunStateAwaitingChildWorkflowRequest, WorkflowRunStateAwaitingEventRequest, WorkflowRunStateAwaitingRetryRequest, WorkflowRunStateCompletedRequest, WorkflowRunStateRequest, WorkflowRunStateScheduledRequest, WorkflowRunStateScheduledRequestOptimistic, WorkflowRunStateScheduledRequestPessimistic, WorkflowRunStateSleepingRequest, WorkflowRunTransitionStateRequestOptimistic, WorkflowRunTransitionStateRequestPessimistic, WorkflowRunTransitionStateRequestV1, WorkflowRunTransitionStateResponseV1, WorkflowRunTransitionTaskStateRequestV1, WorkflowRunTransitionTaskStateResponseV1 };
+export type { TransitionTaskStateToRunning, WorkflowFilter, WorkflowRunApi, WorkflowRunCancelByIdsRequestV1, WorkflowRunCancelByIdsResponseV1, WorkflowRunClaimReadyRequestV1, WorkflowRunClaimReadyResponseV1, WorkflowRunCreateRequestV1, WorkflowRunCreateResponseV1, WorkflowRunGetByIdRequestV1, WorkflowRunGetByIdResponseV1, WorkflowRunGetByReferenceIdRequestV1, WorkflowRunGetByReferenceIdResponseV1, WorkflowRunGetStateRequestV1, WorkflowRunGetStateResponseV1, WorkflowRunHeartbeatRequestV1, WorkflowRunListChildRunsRequestV1, WorkflowRunListChildRunsResponseV1, WorkflowRunListItem, WorkflowRunListRequestV1, WorkflowRunListResponseV1, WorkflowRunListTransitionsRequestV1, WorkflowRunListTransitionsResponseV1, WorkflowRunMulticastEventByReferenceRequestV1, WorkflowRunMulticastEventRequestV1, WorkflowRunReference, WorkflowRunSendEventRequestV1, WorkflowRunSetTaskStateRequestExisting, WorkflowRunSetTaskStateRequestNew, WorkflowRunSetTaskStateRequestV1, WorkflowRunStateAwaitingChildWorkflowRequest, WorkflowRunStateAwaitingEventRequest, WorkflowRunStateAwaitingRetryRequest, WorkflowRunStateCompletedRequest, WorkflowRunStateRequest, WorkflowRunStateScheduledRequest, WorkflowRunStateScheduledRequestOptimistic, WorkflowRunStateScheduledRequestPessimistic, WorkflowRunStateSleepingRequest, WorkflowRunTransitionStateRequestOptimistic, WorkflowRunTransitionStateRequestPessimistic, WorkflowRunTransitionStateRequestV1, WorkflowRunTransitionStateResponseV1, WorkflowRunTransitionTaskStateRequestV1, WorkflowRunTransitionTaskStateResponseV1 };

package/dist/workflow-run.d.ts

@@ -2,7 +2,7 @@ import { EventWaitQueue } from './event.js';
 import { RetryStrategy } from './retry.js';
 import { SerializableError } from './serializable.js';
 import { SleepQueue } from './sleep.js';
-import { TaskInfo, TaskState } from './task.js';
+import { TaskQueue } from './task.js';
 import { TriggerStrategy } from './trigger.js';
 import './duration.js';
 import './utils.js';
@@ -17,6 +17,7 @@ declare const WORKFLOW_RUN_STATUSES: readonly ["scheduled", "queued", "running",
 type WorkflowRunStatus = (typeof WORKFLOW_RUN_STATUSES)[number];
 declare const TERMINAL_WORKFLOW_RUN_STATUSES: readonly ["cancelled", "completed", "failed"];
 type TerminalWorkflowRunStatus = (typeof TERMINAL_WORKFLOW_RUN_STATUSES)[number];
+declare const NON_TERMINAL_WORKFLOW_RUN_STATUSES: ("paused" | "sleeping" | "completed" | "cancelled" | "running" | "awaiting_retry" | "failed" | "scheduled" | "queued" | "awaiting_event" | "awaiting_child_workflow")[];
 type NonTerminalWorkflowRunStatus = Exclude<WorkflowRunStatus, TerminalWorkflowRunStatus>;
 declare function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): status is TerminalWorkflowRunStatus;
 declare const WORKFLOW_RUN_CONFLICT_POLICIES: readonly ["error", "return_existing"];
@@ -141,6 +142,9 @@ interface WorkflowRunStateFailedBySelf extends WorkflowRunStateFailedBase {
 type WorkflowRunStateFailed = WorkflowRunStateFailedByTask | WorkflowRunStateFailedByChildWorkflow | WorkflowRunStateFailedBySelf;
 type WorkflowRunStateInComplete = WorkflowRunStateScheduled | WorkflowRunStateQueued | WorkflowRunStateRunning | WorkflowRunStatePaused | WorkflowRunStateSleeping | WorkflowRunStateAwaitingEvent | WorkflowRunStateAwaitingRetry | WorkflowRunStateAwaitingChildWorkflow | WorkflowRunStateCancelled | WorkflowRunStateFailed;
 type WorkflowRunState<Output = unknown> = WorkflowRunStateInComplete | WorkflowRunStateCompleted<Output>;
+type TerminalWorkflowRunState = Extract<WorkflowRunState, {
+    status: "cancelled" | "completed" | "failed";
+}>;
 interface WorkflowRun<Input = unknown, Output = unknown> {
     id: string;
     name: string;
@@ -149,48 +153,43 @@ interface WorkflowRun<Input = unknown, Output = unknown> {
     revision: number;
     input?: Input;
     inputHash: string;
-    address: string;
-    options: WorkflowStartOptions;
+    options?: WorkflowStartOptions;
     attempts: number;
     state: WorkflowRunState<Output>;
-    tasks: Record<string, TaskInfo>;
-    sleepsQueue: Record<string, SleepQueue>;
+    taskQueues: Record<string, TaskQueue>;
+    sleepQueues: Record<string, SleepQueue>;
     eventWaitQueues: Record<string, EventWaitQueue<unknown>>;
-    childWorkflowRuns: Record<string, ChildWorkflowRunInfo>;
+    childWorkflowRunQueues: Record<string, ChildWorkflowRunQueue>;
     parentWorkflowRunId?: string;
 }
+interface ChildWorkflowRunQueue {
+    childWorkflowRuns: ChildWorkflowRunInfo[];
+}
 interface ChildWorkflowRunInfo {
     id: string;
     name: string;
     versionId: string;
     inputHash: string;
-    statusWaitResults: ChildWorkflowWaitResult[];
+    childWorkflowRunWaitQueues: Record<TerminalWorkflowRunStatus, ChildWorkflowRunWaitQueue>;
+}
+declare const CHILD_WORKFLOW_RUN_WAIT_STATUSES: readonly ["completed", "timeout"];
+type ChildWorkflowRunWaitStatus = (typeof CHILD_WORKFLOW_RUN_WAIT_STATUSES)[number];
+interface ChildWorkflowRunWaitBase {
+    status: ChildWorkflowRunWaitStatus;
 }
-type ChildWorkflowWaitResult = ChildWorkflowWaitResultCompleted | ChildWorkflowWaitResultTimeout;
-interface ChildWorkflowWaitResultCompleted {
+interface ChildWorkflowRunWaitCompleted extends ChildWorkflowRunWaitBase {
     status: "completed";
     completedAt: number;
-    childWorkflowRunState: WorkflowRunState;
+    childWorkflowRunState: TerminalWorkflowRunState;
 }
-interface ChildWorkflowWaitResultTimeout {
+interface ChildWorkflowRunWaitTimeout extends ChildWorkflowRunWaitBase {
     status: "timeout";
     timedOutAt: number;
 }
-interface WorkflowRunTransitionBase {
-    id: string;
-    createdAt: number;
-    type: "state" | "task_state";
-}
-interface WorkflowRunStateTransition extends WorkflowRunTransitionBase {
-    type: "state";
-    state: WorkflowRunState;
+type ChildWorkflowRunWait = ChildWorkflowRunWaitCompleted | ChildWorkflowRunWaitTimeout;
+interface ChildWorkflowRunWaitQueue {
+    childWorkflowRunWaits: ChildWorkflowRunWait[];
 }
-interface WorkflowRunTaskStateTransition extends WorkflowRunTransitionBase {
-    type: "task_state";
-    taskId: string;
-    taskState: TaskState;
-}
-type WorkflowRunTransition = WorkflowRunStateTransition | WorkflowRunTaskStateTransition;
 declare class WorkflowRunNotExecutableError extends Error {
     readonly id: WorkflowRunId;
     readonly status: WorkflowRunStatus;
@@ -210,5 +209,17 @@ declare class WorkflowRunRevisionConflictError extends Error {
     readonly id: WorkflowRunId;
     constructor(id: WorkflowRunId);
 }
+declare class NonDeterminismError extends Error {
+    readonly id: WorkflowRunId;
+    readonly attempts: number;
+    readonly unconsumedManifestEntries: {
+        taskIds: string[];
+        childWorkflowRunIds: string[];
+    };
+    constructor(id: WorkflowRunId, attempts: number, unconsumedManifestEntries: {
+        taskIds: string[];
+        childWorkflowRunIds: string[];
+    });
+}
 
-export { type ChildWorkflowRunInfo, type ChildWorkflowWaitResult, type ChildWorkflowWaitResultCompleted, type ChildWorkflowWaitResultTimeout, type NonTerminalWorkflowRunStatus, type TerminalWorkflowRunStatus, WORKFLOW_RUN_CONFLICT_POLICIES, WORKFLOW_RUN_FAILURE_CAUSE, WORKFLOW_RUN_SCHEDULED_REASON, WORKFLOW_RUN_STATUSES, type WorkflowDefinitionOptions, type WorkflowReferenceOptions, type WorkflowRun, type WorkflowRunAddress, type WorkflowRunConflictPolicy, WorkflowRunFailedError, type WorkflowRunFailureCause, type WorkflowRunId, WorkflowRunNotExecutableError, WorkflowRunRevisionConflictError, type WorkflowRunScheduledReason, type WorkflowRunState, type WorkflowRunStateAwaitingChildWorkflow, type WorkflowRunStateAwaitingEvent, type WorkflowRunStateAwaitingRetry, type WorkflowRunStateAwaitingRetryBase, type WorkflowRunStateAwaitingRetryCausedByChildWorkflow, type WorkflowRunStateAwaitingRetryCausedBySelf, type WorkflowRunStateAwaitingRetryCausedByTask, type WorkflowRunStateCancelled, type WorkflowRunStateCompleted, type WorkflowRunStateFailed, type WorkflowRunStateFailedByChildWorkflow, type WorkflowRunStateFailedBySelf, type WorkflowRunStateFailedByTask, type WorkflowRunStateInComplete, type WorkflowRunStatePaused, type WorkflowRunStateQueued, type WorkflowRunStateRunning, type WorkflowRunStateScheduled, type WorkflowRunStateScheduledBase, type WorkflowRunStateScheduledByAwake, type WorkflowRunStateScheduledByAwakeEarly, type WorkflowRunStateScheduledByChildWorkflow, type WorkflowRunStateScheduledByEvent, type WorkflowRunStateScheduledByNew, type WorkflowRunStateScheduledByResume, type WorkflowRunStateScheduledByRetry, type WorkflowRunStateScheduledByTaskRetry, type WorkflowRunStateSleeping, type WorkflowRunStateTransition, type WorkflowRunStatus, WorkflowRunSuspendedError, type WorkflowRunTaskStateTransition, type WorkflowRunTransition, type WorkflowRunTransitionBase, type WorkflowStartOptions, isTerminalWorkflowRunStatus };
+export { CHILD_WORKFLOW_RUN_WAIT_STATUSES, type ChildWorkflowRunInfo, type ChildWorkflowRunQueue, type ChildWorkflowRunWait, type ChildWorkflowRunWaitBase, type ChildWorkflowRunWaitCompleted, type ChildWorkflowRunWaitQueue, type ChildWorkflowRunWaitStatus, type ChildWorkflowRunWaitTimeout, NON_TERMINAL_WORKFLOW_RUN_STATUSES, NonDeterminismError, type NonTerminalWorkflowRunStatus, TERMINAL_WORKFLOW_RUN_STATUSES, type TerminalWorkflowRunState, type TerminalWorkflowRunStatus, WORKFLOW_RUN_CONFLICT_POLICIES, WORKFLOW_RUN_FAILURE_CAUSE, WORKFLOW_RUN_SCHEDULED_REASON, WORKFLOW_RUN_STATUSES, type WorkflowDefinitionOptions, type WorkflowReferenceOptions, type WorkflowRun, type WorkflowRunAddress, type WorkflowRunConflictPolicy, WorkflowRunFailedError, type WorkflowRunFailureCause, type WorkflowRunId, WorkflowRunNotExecutableError, WorkflowRunRevisionConflictError, type WorkflowRunScheduledReason, type WorkflowRunState, type WorkflowRunStateAwaitingChildWorkflow, type WorkflowRunStateAwaitingEvent, type WorkflowRunStateAwaitingRetry, type WorkflowRunStateAwaitingRetryBase, type WorkflowRunStateAwaitingRetryCausedByChildWorkflow, type WorkflowRunStateAwaitingRetryCausedBySelf, type WorkflowRunStateAwaitingRetryCausedByTask, type WorkflowRunStateCancelled, type WorkflowRunStateCompleted, type WorkflowRunStateFailed, type WorkflowRunStateFailedByChildWorkflow, type WorkflowRunStateFailedBySelf, type WorkflowRunStateFailedByTask, type WorkflowRunStateInComplete, type WorkflowRunStatePaused, type WorkflowRunStateQueued, type WorkflowRunStateRunning, type WorkflowRunStateScheduled, type WorkflowRunStateScheduledBase, type WorkflowRunStateScheduledByAwake, type WorkflowRunStateScheduledByAwakeEarly, type WorkflowRunStateScheduledByChildWorkflow, type WorkflowRunStateScheduledByEvent, type WorkflowRunStateScheduledByNew, type WorkflowRunStateScheduledByResume, type WorkflowRunStateScheduledByRetry, type WorkflowRunStateScheduledByTaskRetry, type WorkflowRunStateSleeping, type WorkflowRunStatus, WorkflowRunSuspendedError, type WorkflowStartOptions, isTerminalWorkflowRunStatus };

package/dist/workflow-run.js

@@ -13,6 +13,9 @@ var WORKFLOW_RUN_STATUSES = [
   "failed"
 ];
 var TERMINAL_WORKFLOW_RUN_STATUSES = ["cancelled", "completed", "failed"];
+var NON_TERMINAL_WORKFLOW_RUN_STATUSES = WORKFLOW_RUN_STATUSES.filter(
+  (status) => !TERMINAL_WORKFLOW_RUN_STATUSES.includes(status)
+);
 function isTerminalWorkflowRunStatus(status) {
   for (const terminalStatus of TERMINAL_WORKFLOW_RUN_STATUSES) {
     if (status === terminalStatus) {
@@ -33,6 +36,7 @@ var WORKFLOW_RUN_SCHEDULED_REASON = [
   "child_workflow"
 ];
 var WORKFLOW_RUN_FAILURE_CAUSE = ["task", "child_workflow", "self"];
+var CHILD_WORKFLOW_RUN_WAIT_STATUSES = ["completed", "timeout"];
 var WorkflowRunNotExecutableError = class extends Error {
   id;
   status;
@@ -72,7 +76,23 @@ var WorkflowRunRevisionConflictError = class extends Error {
     this.id = id;
   }
 };
+var NonDeterminismError = class extends Error {
+  id;
+  attempts;
+  unconsumedManifestEntries;
+  constructor(id, attempts, unconsumedManifestEntries) {
+    super(`Replay divergence for Workflow run ${id}`);
+    this.name = "NonDeterminismError";
+    this.id = id;
+    this.attempts = attempts;
+    this.unconsumedManifestEntries = unconsumedManifestEntries;
+  }
+};
 export {
+  CHILD_WORKFLOW_RUN_WAIT_STATUSES,
+  NON_TERMINAL_WORKFLOW_RUN_STATUSES,
+  NonDeterminismError,
+  TERMINAL_WORKFLOW_RUN_STATUSES,
   WORKFLOW_RUN_CONFLICT_POLICIES,
   WORKFLOW_RUN_FAILURE_CAUSE,
   WORKFLOW_RUN_SCHEDULED_REASON,

package/dist/workflow.d.ts

@@ -4,6 +4,8 @@ type WorkflowName = string & {
 type WorkflowVersionId = string & {
     _brand: "workflow_version_id";
 };
+declare const WORKFLOW_SOURCES: readonly ["user", "system"];
+type WorkflowSource = (typeof WORKFLOW_SOURCES)[number];
 interface WorkflowMeta {
     name: WorkflowName;
     versionId: WorkflowVersionId;
@@ -20,4 +22,4 @@ interface Workflow {
     lastRunAt: number;
 }
 
-export type { Workflow, WorkflowMeta, WorkflowName, WorkflowVersionId, WorkflowVersionStats };
+export { WORKFLOW_SOURCES, type Workflow, type WorkflowMeta, type WorkflowName, type WorkflowSource, type WorkflowVersionId, type WorkflowVersionStats };

package/dist/workflow.js

@@ -0,0 +1,5 @@
+// workflow.ts
+var WORKFLOW_SOURCES = ["user", "system"];
+export {
+  WORKFLOW_SOURCES
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@aikirun/types",
-	"version": "0.17.0",
+	"version": "0.19.0",
 	"description": "Core type definitions for Aiki - including workflow, task, client, and trigger types",
 	"type": "module",
 	"exports": {
@@ -20,10 +20,18 @@
 			"types": "./dist/event.d.ts",
 			"import": "./dist/event.js"
 		},
+		"./namespace": {
+			"types": "./dist/namespace.d.ts",
+			"import": "./dist/namespace.js"
+		},
 		"./namespace-api": {
 			"types": "./dist/namespace-api.d.ts",
 			"import": "./dist/namespace-api.js"
 		},
+		"./organization": {
+			"types": "./dist/organization.d.ts",
+			"import": "./dist/organization.js"
+		},
 		"./retry": {
 			"types": "./dist/retry.d.ts",
 			"import": "./dist/retry.js"
@@ -44,6 +52,10 @@
 			"types": "./dist/sleep.d.ts",
 			"import": "./dist/sleep.js"
 		},
+		"./state-transition": {
+			"types": "./dist/state-transition.d.ts",
+			"import": "./dist/state-transition.js"
+		},
 		"./symbols": {
 			"types": "./dist/symbols.d.ts",
 			"import": "./dist/symbols.js"