@lostgradient/weft 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Weft — A Bun-native durable execution engine.
+ *
+ * Weft runs async workflows to completion across crashes, retries, and days
+ * of wall-clock time. Each workflow is a generator function that yields to a
+ * {@link Context}; the engine persists a checkpoint at every yield and
+ * resumes from the last checkpoint on recovery.
+ *
+ * For end-to-end usage examples see the {@link Engine} class.
+ *
+ * @module weft
+ */
+export { VERSION } from './version.ts';
+export { WeftError, isWeftError, isWeftErrorCode } from './core/weft-error.ts';
+export type { WeftErrorCode } from './core/weft-error.ts';
+export { FAULT_CODE_TO_FAILURE_CATEGORY, failureCategoryForFaultCode, isFaultCode, } from './core/fault-code.ts';
+export type { FaultCode } from './core/fault-code.ts';
+export { ActivityReconciliationCapabilityError, ActivityReconciliationConflictError, ActivityReconciliationIndeterminateError, ActivityResolutionError, AsyncActivityTokenNotFoundError, BulkDeleteRequiresTerminalWorkflowsError, BulkOperationConfirmationError, Engine, EngineCreateNameMismatchError, EngineDisposedError, PersistedDataIncompatibleError, ScheduleHandle, WorkflowAlreadyExistsError, WorkflowHandle, WorkflowNotFoundError, WorkflowNotRegisteredError, WorkflowTypeNotRegisteredForRecoveryError, } from './core/engine';
+export type { EngineCreateOptions, EngineStateNamespace, RecoverAllOptions } from './core/engine';
+export { DEFAULT_CHECKPOINT_SIZE_WARNING_THRESHOLD, DEFAULT_MAX_NESTING_DEPTH, DEFAULT_RETRY_POLICY, DEFAULT_VISIBILITY_TIMEOUT_MS, HISTORY_CIRCUIT_BREAKER_REASON, WorkflowBuilderError, query, schedule, signal, update, workflow, } from './core/types';
+export type { ActivityArgsFor, ActivityCallOptions, ActivityCallable, ActivityContext, ActivityDefinition, ActivityEntryInput, ActivityFunction, ActivityMap, ActivityMapInput, ActivityObjectInput, ActivityResultFor, ActivityVerificationContext, ActivityVerificationPhase, ActivityVerificationResult, AnyActivityDefinition, AnyWorkflowDefinition, ArchiveAdapter, BuilderState, BuiltWorkflowDefinition, BulkCancelResult, BulkDeleteResult, BulkOperationAction, BulkOperationAuditEvent, BulkOperationCommitOptions, BulkOperationDryRunOptions, BulkOperationDryRunResult, BulkOperationError, BulkOperationFilterSummary, BulkOperationOptions, BulkOperationPrincipal, BulkOperationScopeSummary, BulkSignalAllCommitOptions, BulkSignalAllDryRunOptions, BulkSignalAllOptions, BulkSignalResult, BulkTagResult, Checkpoint, CheckpointState, CheckpointSummary, CompletedReviewEntry, CoordinatedUpdateResult, DefinitionSchema, Duration, EngineOptions, FailureCategory, ForkLineage, ForkOptions, HistoryPolicy, InferActivityEntries, InferActivityEntry, InferWorkflowEntries, InferWorkflowEntry, InitialBuilderState, ListFilter, ListOptions, MarkBuilderState, NormalizeActivities, NormalizedActivityEntry, NormalizedRetentionPolicy, PaginatedResult, PayloadSizePolicy, PendingReviewEntry, PurgeResult, QueryDefinition, QueryMap, QueryShape, RegisteredWorkflowDefinition, RetentionOverview, RetentionPolicy, RetryPolicy, ReviewListEntry, ReviewListFilter, ReviewStatus, ScheduleDefinition, ScheduleFilter, ScheduleOptions, ScheduleOverlapPolicy, ScheduleSpec, ScheduleState, ScheduleStatus, ScheduleSummary, SearchAttributeDefinition, SearchAttributeHandle, SearchAttributeSchema, SearchAttributeValue, Serializer, SignalDefinition, SignalDeliveryOptions, SignalMap, SignalPayload, StartOptions, SubmitReviewOptions, TerminationReason, UpdateDefinition, UpdateMap, UpdatePayload, WorkerReplayOperationFailure, WorkerReplayOperationSignature, WorkflowAlreadyRegistered, WorkflowAtomicState, WorkflowAtomicStateOptions, WorkflowBuilder, WorkflowBuilderOptions, WorkflowContext, WorkflowDefinition, WorkflowEvent, WorkflowFunction, WorkflowGenerator, WorkflowId, WorkflowRegistry, WorkflowReplay, WorkflowSessionState, WorkflowState, WorkflowStateNamespace, WorkflowStatus, WorkflowSummary, WorkflowTimelineEntry, WorkflowTimelineStatus, WorkflowTypeRetentionPolicy, } from './core/types';
+export { AlertManager } from './alerting/index';
+export type { AlertAction, AlertMetric, AlertRule, AlertState, AlertStatus, AlertingOptions, WebhookTarget, } from './alerting/types';
+export { ActivityAsyncPendingEvent, ActivityCompletedEvent, ActivityFailedEvent, ActivityStartedEvent, AlertFiredEvent, AlertResolvedEvent, AttributesChangedEvent, CheckpointSizeWarningEvent, ConstraintViolatedEvent, DevelopmentWarningEvent, SignalDeliveredEvent, SignalReceivedEvent, StorageSizeReportedEvent, UpdateCompletedEvent, UpdateReceivedEvent, WorkflowCancelledEvent, WorkflowCompletedEvent, WorkflowFailedEvent, WorkflowRecoverySkippedEvent, WorkflowResumedEvent, WorkflowStartedEvent, WorkflowTimedOutEvent, } from './core/events';
+export type { TypedEventTarget, WeftEventMap, WorkflowRecoverySkippedReason } from './core/events';
+export { detectRuntime, hashBytes, hashString, sleep } from './runtime/portable';
+export type { RuntimeKind } from './runtime/portable';
+export { createBunCompressor, createCompressor } from './core/compression';
+export type { CompressionAlgorithm, CompressionOptions, Compressor } from './core/compression';
+export { CompressedStorage } from './storage/compressed-storage';
+export { storageDeleteRange } from './storage/delete-range';
+export type { DeleteRangeOptions } from './storage/delete-range';
+export { KEYS, WEFT_RESERVED_KEY_PREFIXES, assertDurableStorageForRecovery, requireStorageCapability, storageConditionalBatch, storageValuesEqual, } from './storage/interface';
+export type { BatchOperation, ConditionalBatchCondition, GatedStorageCapabilityKey, ScanOptions, Storage, StorageCapabilities, } from './storage/interface';
+export { MemoryStorage } from './storage/memory';
+export { ScopedStorage, scopedStorage } from './storage/scoped-storage';
+export { copyTextKeyValueRowsToStorage } from './storage/text-value-import';
+export type { CopyTextKeyValueRowsToStorageOptions, CopyTextKeyValueRowsToStorageResult, TextKeyValueRow, } from './storage/text-value-import';
+export { jsonCodec, msgpackCodec, withCodec } from './storage/typed-storage';
+export type { CodecStorageOptions, MessagePackValue, StorageCodec, StorageValueParser, TypedBatchOperation, TypedConditionalBatchCondition, TypedStorage, } from './storage/typed-storage';
+export { decode, encode, validateCloneable } from './core/codec';
+export { PayloadSizeExceededError } from './core/payload-size';
+export { advanceCheckpoint, checkpointSizeBytes, createCheckpoint, deserializeCheckpoint, serializeCheckpoint, } from './core/checkpoint';
+export { Scheduler, calculateBackoff, parseDuration } from './core/scheduler';
+export type { TimerEntry } from './core/types/checkpoint';
+export { constraint } from './core/constraint';
+export type { ConstraintCheckState, ConstraintDefinition, ConstraintViolation, } from './core/constraint';
+export { ActivityRegistry } from './core/activity-registry';
+export type { ActivityMetadata, ActivityRegistrationOptions } from './core/activity-registry';
+export { activity } from './core/types';
+export { Context } from './core/context';
+export type { ContextOperationRequest, ContextOptions, OffloadReference, SagaStep, StoredStreamChunk, StreamReference, StreamSink, } from './core/context';
+export type { ChildWorkflowOptions, ChildWorkflowTarget, WorkflowMapOptions, WorkflowOperation, WorkflowPipeStage, WorkflowPipeStageDefinition, WorkflowReduceInput, WorkflowReduceOptions, } from './core/types';
+export { StepContext, compileStepWorkflow, isAsyncGeneratorFunction } from './core/step-context';
+export type { StepWorkflowContext, StepWorkflowFunction } from './core/types';
+export { composeActivityInterceptors, composeWorkflowInterceptors, interceptor, } from './core/interceptor';
+export type { ActivityExecutionInterception, ActivityInterception, ActivityInterceptor, ChildWorkflowInterception, ComposedActivityInterceptor, ComposedWorkflowInterceptor, Interceptor, QueryInterception, SignalInterception, SignalReceivedInterception, SleepInterception, WorkflowInterceptor, WorkflowStartInterception, } from './core/interceptor';
+export { buildIndexOperations, decodeAttributeValue, encodeAttributeValue, searchAttribute, } from './core/search-attributes';
+export type { UpdateHandlerOptions } from './core/context/updates';
+export { UpdateCoordinator, UpdateTimeoutError, UpdateValidationError, WorkflowTerminalError, } from './core/updates';
+export { VersionMismatchError, checkVersionCompatibility, diffCheckpointShapes, inferShape, migrateCheckpoint, } from './core/versioning';
+export type { FieldDiff, ShapeDescriptor, ShapeDiffOptions } from './core/versioning';
+export { WorkflowTimeoutError, checkExpiredDeadlines, createDeadlineOperations, timeRemaining, } from './core/timeouts';
+export { AtomicState, AtomicStateChangeEvent, AtomicStateConflictError, AtomicStateConflictEvent, AtomicStateExhaustedEvent, OBSERVABLE_SYMBOL, } from './core/atomic-state';
+export type { AtomicStateCommitResult, AtomicStateEvent, AtomicStateObserver, AtomicStateOptions, AtomicStateScope, AtomicStateSnapshot, AtomicStateSubscription, SleepFunction, } from './core/atomic-state';
+export { DurableMutex, DurableSemaphore, initialLockRecord } from './core/concurrency';
+export type { AcquireAttempt, AcquireWithSlot, CasSlot, DurableSemaphoreOptions, LockHolder, LockRecord, RenewWithSlot, } from './core/concurrency';
+export { handleRequest } from './server/handler';
+export type { SchedulingPolicy } from './server/task-queue-types';
+export type { RoutingPolicy } from './worker/registry';
+export { createAuthenticator, validateAuthConfig } from './server/authentication';
+export type { AuthConfig, AuthMethod, AuthResult, Authenticator, JWTAlgorithm, JWTConfig, JWTPayload, MTLSConfig, } from './server/authentication';
+export { ReviewCompletedEvent, ReviewRequestedEvent } from './core/review/events.ts';
+export type { WeftReviewEventMap } from './core/review/events.ts';
+export { ReviewCoordinator, ReviewTimeoutError } from './core/review/index.ts';
+export type { EscalationAction, EscalationStep, HumanReviewOptions, HumanReviewResult, ReviewCoordinatorOptions, ReviewDecision, ReviewOptions, ReviewRequest, } from './core/review/index.ts';
+export { EffectLog, EffectReplayConflictError, computeSemanticHash, } from './core/effect-log/index.ts';
+export type { EffectLogLike, EffectRecord } from './core/effect-log/index.ts';
+export { isJSONValue, normalizeJSONValue } from './core/json.ts';
+export type { JSONPrimitive, JSONValue } from './core/json.ts';
+export { createObservabilityInterceptors } from './observability/index';
+export type { InterceptionContext, ObservabilityOptions } from './observability/index';
+export { METRICS, createMetricsCollectorExporter, createOpenTelemetryMetrics, } from './observability/metrics';
+export { getOpenTelemetryApi } from './observability/no-op-telemetry';
+export { formatTraceParent, generateSpanId, generateTraceId, parseTraceParent, } from './observability/propagation';
+export { executeActivity } from './workers/activity-runner';
+export type { ActivityExecutionRequest, ActivityExecutionResult } from './workers/activity-runner';
+export { ActivityWorkerDispatcher } from './workers/activity-worker-dispatcher';
+export type { ActivityWorkerDispatcherOptions } from './workers/activity-worker-dispatcher';
+export { createActivityWorkerEntryUrl, initializeActivityWorkerMessageLoop, revokeActivityWorkerEntryUrl, } from './workers/activity-worker-entry';
+export type { ActivityHandlerLookup } from './workers/activity-worker-entry';
+export { WorkerPool } from './workers/pool';
+export type { WorkerPoolOptions } from './workers/pool';
+export { HeartbeatManager } from './worker/heartbeat';
+export { RemoteWorker } from './worker/index';
+export { LongPollWorker } from './worker/long-poll';
+export { WorkerRegistry } from './worker/registry';
+export { WorkerProtocolIncompatibleError, workerProtocolIncompatibleMessage, } from './worker/worker-protocol-incompatible-error';
+export { buildQualifiedActivityTable } from './worker/workflow-activity-binding';
+export type { RemoteWorkerActivityFunction, RemoteWorkerActivityImplementation, RemoteWorkerWorkflowDefinition, } from './worker/workflow-activity-binding';
+export type { WorkflowEventTail } from './client/event-tail';
+export { HttpClient, HttpClientError } from './client/index';
+export type { HttpClientOptions } from './client/index';
+export type { ClientHandle, UpdateResult, WeftClient, WeftClientActivity, } from './client/interface';
+export { LocalClient } from './client/local';
+export type { KnownWorkflowName, UnknownNameWhenRegistryEmpty, } from './client/workflow-name-typing';
+export { ConnectionConfigurationError, DEFAULT_WEFT_ADDRESS, resolveConnection, } from './connection';
+export type { ConnectionOptions, ResolvedConnection } from './connection';
+export * from './diagnostics/index.ts';

package/dist/index.js

@@ -0,0 +1,182 @@
+export { VERSION } from "./version.js";
+export { WeftError, isWeftError, isWeftErrorCode } from "./core/weft-error.js";
+export {
+  FAULT_CODE_TO_FAILURE_CATEGORY,
+  failureCategoryForFaultCode,
+  isFaultCode
+} from "./core/fault-code.js";
+export {
+  ActivityReconciliationCapabilityError,
+  ActivityReconciliationConflictError,
+  ActivityReconciliationIndeterminateError,
+  ActivityResolutionError,
+  AsyncActivityTokenNotFoundError,
+  BulkDeleteRequiresTerminalWorkflowsError,
+  BulkOperationConfirmationError,
+  Engine,
+  EngineCreateNameMismatchError,
+  EngineDisposedError,
+  PersistedDataIncompatibleError,
+  ScheduleHandle,
+  WorkflowAlreadyExistsError,
+  WorkflowHandle,
+  WorkflowNotFoundError,
+  WorkflowNotRegisteredError,
+  WorkflowTypeNotRegisteredForRecoveryError
+} from "./core/engine.js";
+export {
+  DEFAULT_CHECKPOINT_SIZE_WARNING_THRESHOLD,
+  DEFAULT_MAX_NESTING_DEPTH,
+  DEFAULT_RETRY_POLICY,
+  DEFAULT_VISIBILITY_TIMEOUT_MS,
+  HISTORY_CIRCUIT_BREAKER_REASON,
+  WorkflowBuilderError,
+  query,
+  schedule,
+  signal,
+  update,
+  workflow
+} from "./core/types.js";
+export { AlertManager } from "./alerting/index.js";
+export {
+  ActivityAsyncPendingEvent,
+  ActivityCompletedEvent,
+  ActivityFailedEvent,
+  ActivityStartedEvent,
+  AlertFiredEvent,
+  AlertResolvedEvent,
+  AttributesChangedEvent,
+  CheckpointSizeWarningEvent,
+  ConstraintViolatedEvent,
+  DevelopmentWarningEvent,
+  SignalDeliveredEvent,
+  SignalReceivedEvent,
+  StorageSizeReportedEvent,
+  UpdateCompletedEvent,
+  UpdateReceivedEvent,
+  WorkflowCancelledEvent,
+  WorkflowCompletedEvent,
+  WorkflowFailedEvent,
+  WorkflowRecoverySkippedEvent,
+  WorkflowResumedEvent,
+  WorkflowStartedEvent,
+  WorkflowTimedOutEvent
+} from "./core/events.js";
+export { detectRuntime, hashBytes, hashString, sleep } from "./runtime/portable.js";
+export { createBunCompressor, createCompressor } from "./core/compression.js";
+export { CompressedStorage } from "./storage/compressed-storage.js";
+export { storageDeleteRange } from "./storage/delete-range.js";
+export {
+  KEYS,
+  WEFT_RESERVED_KEY_PREFIXES,
+  assertDurableStorageForRecovery,
+  requireStorageCapability,
+  storageConditionalBatch,
+  storageValuesEqual
+} from "./storage/interface.js";
+export { MemoryStorage } from "./storage/memory.js";
+export { ScopedStorage, scopedStorage } from "./storage/scoped-storage.js";
+export { copyTextKeyValueRowsToStorage } from "./storage/text-value-import.js";
+export { jsonCodec, msgpackCodec, withCodec } from "./storage/typed-storage.js";
+export { decode, encode, validateCloneable } from "./core/codec.js";
+export { PayloadSizeExceededError } from "./core/payload-size.js";
+export {
+  advanceCheckpoint,
+  checkpointSizeBytes,
+  createCheckpoint,
+  deserializeCheckpoint,
+  serializeCheckpoint
+} from "./core/checkpoint.js";
+export { Scheduler, calculateBackoff, parseDuration } from "./core/scheduler.js";
+export { constraint } from "./core/constraint.js";
+export { ActivityRegistry } from "./core/activity-registry.js";
+export { activity } from "./core/types.js";
+export { Context } from "./core/context.js";
+export { StepContext, compileStepWorkflow, isAsyncGeneratorFunction } from "./core/step-context.js";
+export {
+  composeActivityInterceptors,
+  composeWorkflowInterceptors,
+  interceptor
+} from "./core/interceptor.js";
+export {
+  buildIndexOperations,
+  decodeAttributeValue,
+  encodeAttributeValue,
+  searchAttribute
+} from "./core/search-attributes.js";
+export {
+  UpdateCoordinator,
+  UpdateTimeoutError,
+  UpdateValidationError,
+  WorkflowTerminalError
+} from "./core/updates.js";
+export {
+  VersionMismatchError,
+  checkVersionCompatibility,
+  diffCheckpointShapes,
+  inferShape,
+  migrateCheckpoint
+} from "./core/versioning.js";
+export {
+  WorkflowTimeoutError,
+  checkExpiredDeadlines,
+  createDeadlineOperations,
+  timeRemaining
+} from "./core/timeouts.js";
+export {
+  AtomicState,
+  AtomicStateChangeEvent,
+  AtomicStateConflictError,
+  AtomicStateConflictEvent,
+  AtomicStateExhaustedEvent,
+  OBSERVABLE_SYMBOL
+} from "./core/atomic-state.js";
+export { DurableMutex, DurableSemaphore, initialLockRecord } from "./core/concurrency.js";
+export { handleRequest } from "./server/handler.js";
+export { createAuthenticator, validateAuthConfig } from "./server/authentication.js";
+export { ReviewCompletedEvent, ReviewRequestedEvent } from "./core/review/events.js";
+export { ReviewCoordinator, ReviewTimeoutError } from "./core/review/index.js";
+export {
+  EffectLog,
+  EffectReplayConflictError,
+  computeSemanticHash
+} from "./core/effect-log/index.js";
+export { isJSONValue, normalizeJSONValue } from "./core/json.js";
+export { createObservabilityInterceptors } from "./observability/index.js";
+export {
+  METRICS,
+  createMetricsCollectorExporter,
+  createOpenTelemetryMetrics
+} from "./observability/metrics.js";
+export { getOpenTelemetryApi } from "./observability/no-op-telemetry.js";
+export {
+  formatTraceParent,
+  generateSpanId,
+  generateTraceId,
+  parseTraceParent
+} from "./observability/propagation.js";
+export { executeActivity } from "./workers/activity-runner.js";
+export { ActivityWorkerDispatcher } from "./workers/activity-worker-dispatcher.js";
+export {
+  createActivityWorkerEntryUrl,
+  initializeActivityWorkerMessageLoop,
+  revokeActivityWorkerEntryUrl
+} from "./workers/activity-worker-entry.js";
+export { WorkerPool } from "./workers/pool.js";
+export { HeartbeatManager } from "./worker/heartbeat.js";
+export { RemoteWorker } from "./worker/index.js";
+export { LongPollWorker } from "./worker/long-poll.js";
+export { WorkerRegistry } from "./worker/registry.js";
+export {
+  WorkerProtocolIncompatibleError,
+  workerProtocolIncompatibleMessage
+} from "./worker/worker-protocol-incompatible-error.js";
+export { buildQualifiedActivityTable } from "./worker/workflow-activity-binding.js";
+export { HttpClient, HttpClientError } from "./client/index.js";
+export { LocalClient } from "./client/local.js";
+export {
+  ConnectionConfigurationError,
+  DEFAULT_WEFT_ADDRESS,
+  resolveConnection
+} from "./connection.js";
+export * from "./diagnostics/index.js";

package/dist/json-schema.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Standard Schema and JSON Schema helper types for Weft definition metadata.
+ *
+ * @module json-schema
+ */
+import { StandardSchemaValidationError, formatStandardSchemaIssues, validateStandardSchema } from './core/types/standard-schema-validate.ts';
+export type { DefinitionSchema, InferSchemaOutput, StandardJSONSchemaV1, StandardJSONSchemaV1Converter, StandardJSONSchemaV1Options, StandardJSONSchemaV1Properties, StandardJSONSchemaV1Target, StandardSchemaV1, StandardSchemaV1FailureResult, StandardSchemaV1Issue, StandardSchemaV1Options, StandardSchemaV1PathSegment, StandardSchemaV1Properties, StandardSchemaV1Result, StandardSchemaV1SuccessResult, StandardTypedV1, StandardTypedV1Properties, StandardTypedV1Types, } from './core/types/definition-schema.ts';
+export type { StandardSchemaValidationContext, ValidationIssue, } from './core/types/standard-schema-validate.ts';
+/**
+ * Format normalized Standard Schema validation issues as a readable message.
+ *
+ * @example
+ * ```ts
+ * import { formatStandardSchemaIssues } from '@lostgradient/weft/json-schema';
+ *
+ * const message = formatStandardSchemaIssues([
+ *   { message: 'Expected a string.', path: '/email' },
+ * ]);
+ * console.log(message);
+ * ```
+ */
+declare const exportedFormatStandardSchemaIssues: typeof formatStandardSchemaIssues;
+/**
+ * Error thrown when Standard Schema runtime validation rejects boundary input.
+ *
+ * @example
+ * ```ts
+ * import { StandardSchemaValidationError } from '@lostgradient/weft/json-schema';
+ *
+ * const error = new StandardSchemaValidationError({
+ *   fieldName: 'input',
+ *   operation: 'weft.workflows.start',
+ *   issues: [{ message: 'Expected a string.', path: '/email' }],
+ * });
+ * console.log(error.issues);
+ * ```
+ */
+declare const exportedStandardSchemaValidationError: typeof StandardSchemaValidationError;
+/**
+ * Validate unknown input against a Standard Schema-compatible runtime validator.
+ *
+ * @example
+ * ```ts
+ * import { validateStandardSchema } from '@lostgradient/weft/json-schema';
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({ email: z.string().email() });
+ * const value = await validateStandardSchema(schema, { email: 'a@b.co' }, {
+ *   fieldName: 'input',
+ * });
+ * console.log(value.email);
+ * ```
+ */
+declare const exportedValidateStandardSchema: typeof validateStandardSchema;
+export { exportedStandardSchemaValidationError as StandardSchemaValidationError, exportedFormatStandardSchemaIssues as formatStandardSchemaIssues, exportedValidateStandardSchema as validateStandardSchema, };

package/dist/json-schema.js

@@ -0,0 +1,4 @@
+// @bun
+var B=Object.defineProperty;var D=(j)=>j;function L(j,q){this[j]=D.bind(null,q)}var _=(j,q)=>{for(var z in q)B(j,z,{get:q[z],enumerable:!0,configurable:!0,set:L.bind(q,z)})};var X=(j,q)=>()=>(j&&(q=j(j=0)),q);var K,U,N;var Y=X(()=>{K=class K extends Error{code;constructor(j,q,z){super(q,z);this.code=j,this.name=j}};U={WorkflowAlreadyExistsError:!0,BulkDeleteRequiresTerminalWorkflowsError:!0,BulkOperationConfirmationError:!0,WorkflowTypeNotRegisteredForRecoveryError:!0,EngineCreateNameMismatchError:!0,EngineDisposedError:!0,WorkflowNotFoundError:!0,WorkflowNotRegisteredError:!0,ActivityResolutionError:!0,PersistedDataIncompatibleError:!0,WorkflowTimeoutError:!0,HttpClientError:!0,WorkerProtocolIncompatibleError:!0,UpdateTimeoutError:!0,UpdateValidationError:!0,WorkflowTerminalError:!0,WorkflowBuilderError:!0,VersionMismatchError:!0,EffectReplayConflictError:!0,ReviewTimeoutError:!0,AtomicStateConflictError:!0,StandardSchemaValidationError:!0,ActivityReconciliationCapabilityError:!0,ActivityReconciliationConflictError:!0,ActivityReconciliationIndeterminateError:!0,AsyncActivityTokenNotFoundError:!0,PayloadSizeExceededError:!0},N=new Set(Object.keys(U))});async function Z(j,q,z){let G=j["~standard"];if(!J(G))throw TypeError(`Schema for ${z.fieldName} does not provide runtime validation. Attach a Standard Schema validator (Zod, Valibot, or another vendor) or supply a runtime-validating schema at this boundary.`);let H=await G.validate(q);if(H.issues===void 0)return H.value;throw new A({fieldName:z.fieldName,operation:z.operation,issues:H.issues.map(O)})}function Q(j){return j.map((q)=>q.path===""?q.message:`${q.path}: ${q.message}`).join(`
+`)}function J(j){return typeof j.validate==="function"}function O(j){return{message:j.message,path:T(j.path)}}function T(j){if(j===void 0||j.length===0)return"";let q="";for(let z of j)q+="/",q+=y(z);return q}function y(j){let q=F(j)?j.key:j;return M(String(q))}function F(j){return j!==null&&typeof j==="object"&&"key"in j}function M(j){return j.replace(/~/g,"~0").replace(/\//g,"~1")}function R(j,q,z){return`Validation failed for ${q===void 0?j:`${q} ${j}`}:
+${Q(z)}`}var A;var $=X(()=>{Y();A=class A extends K{fieldName;operation;issues;constructor(j){super("StandardSchemaValidationError",R(j.fieldName,j.operation,j.issues));this.fieldName=j.fieldName,this.operation=j.operation,this.issues=j.issues}}});$();var C=Q,x=A,k=Z;export{k as validateStandardSchema,C as formatStandardSchemaIssues,x as StandardSchemaValidationError};

package/dist/mcp/access.d.ts

@@ -0,0 +1,21 @@
+import type { Engine } from '../core/engine.ts';
+import type { ListFilter, PaginatedResult, WorkflowState, WorkflowSummary } from '../core/types.ts';
+import { WeftError } from '../core/weft-error.ts';
+import type { AuthorizationScope } from '../server/authorization-scope.ts';
+import { type Principal } from '../server/principal.ts';
+/** Execution context shared by MCP tools and resources. */
+export type McpAccessContext = {
+    readonly engine: Engine;
+    readonly principal: Principal;
+    readonly authRequired: boolean;
+};
+/** Error surfaced as a tool-level failure rather than a protocol failure. */
+export declare class McpToolExecutionError extends WeftError<'McpToolExecutionError'> {
+    constructor(message: string);
+}
+/** Assert that the principal has a scope when authentication is enabled. */
+export declare function assertScope(context: McpAccessContext, scope: AuthorizationScope, action: string): void;
+/** Load a workflow by id. */
+export declare function getVisibleWorkflowState(engine: Engine, workflowId: string): Promise<WorkflowState | null>;
+/** List workflows. */
+export declare function listVisibleWorkflows(engine: Engine, filter?: ListFilter): Promise<PaginatedResult<WorkflowSummary>>;

package/dist/mcp/access.js

@@ -0,0 +1,22 @@
+import { WeftError } from "../core/weft-error.js";
+import { isAuthenticated } from "../server/principal.js";
+
+export class McpToolExecutionError extends WeftError {
+  constructor(message) {
+    super("McpToolExecutionError", message);
+  }
+}
+export function assertScope(context, scope, action) {
+  if (!context.authRequired)
+    return;
+  if (!isAuthenticated(context.principal))
+    throw new McpToolExecutionError(`${action} requires authentication`);
+  if (!context.principal.hasScope(scope))
+    throw new McpToolExecutionError(`${action} requires ${scope}`);
+}
+export async function getVisibleWorkflowState(engine, workflowId) {
+  return engine.get(workflowId);
+}
+export async function listVisibleWorkflows(engine, filter) {
+  return engine.list(filter);
+}

package/dist/mcp/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};