deepline 0.3.59 → 0.3.60

package/dist/{compiler-manifest-B47AA7As.d.mts → compiler-manifest-IkyvsUO-.d.mts}

@@ -711,7 +711,7 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  */
 type ToolExecuteResult<TResult = unknown, TMeta = Record<string, unknown>, TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = ToolExecuteResultBase<TResult, TMeta> & ToolExecuteResultAccessors<TExtracted, TLists>;
 
-declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5];
+declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5, 6];
 type PlayAuthoringContractEdition = (typeof SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS)[number];
 type PlaySqlListenerOperation = 'INSERT' | 'UPDATE' | 'DELETE';
 type PlayStandardWebhookHeaderFamily = 'standard' | 'svix';
@@ -781,14 +781,22 @@ type PlayAuthoringAstBindings = {
     cron?: {
         schedule: string;
         timezone?: string;
+        /** Static JSON object supplied to every run started by this cron binding. */
+        input?: Record<string, unknown>;
     };
     sqlListeners?: PlayAuthoringAstSqlListenerDeclaration[];
     invalidSqlListenerSingular?: boolean;
     invalidSqlListenerShape?: boolean;
     secrets?: string[];
 };
+/**
+ * Static cron input must be an object because the scheduler accepts a JSON
+ * object. It is tied to the Play handler input so TypeScript rejects missing
+ * required fields and incompatible values before the Play reaches `check`.
+ */
+type PlayAuthoringCronInput<TInput> = TInput extends readonly unknown[] ? never : TInput extends object ? TInput : never;
 /** The one public type for options accepted by definePlay. */
-type PlayAuthoringBindings = {
+type PlayAuthoringBindings<TInput = Record<string, unknown>> = {
     description?: string;
     compatibility?: {
         toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
@@ -823,6 +831,8 @@ type PlayAuthoringBindings = {
     cron?: {
         schedule: string;
         timezone?: string;
+        /** Static JSON object supplied to every run started by this cron binding. */
+        input?: PlayAuthoringCronInput<TInput>;
     };
     sqlListeners?: PlaySqlListenerDeclaration[];
     secrets?: readonly string[];
@@ -891,7 +901,7 @@ type PlaySecretAwareRequestInit = Omit<RequestInit, 'headers'> & {
     /** Ordinary request headers, recorded in the durable receipt with any resolved Play secret value redacted. Prefer `auth` for credentials: it enforces HTTPS and keeps the auth header out of the receipt. */
     headers?: HeadersInit;
     /**
-     * One or more credentialed headers for this request. Pass a single `ctx.secrets` auth for the common case, or an array when an API requires multiple credentialed headers — for example, Supabase with both `apikey` and `Authorization`. Auth-helper requests require HTTPS and omit the credential from the durable receipt. Each auth entry must target a distinct header.
+     * One or more credentialed headers for this request. Pass a single `ctx.secrets` auth for the common case, or an array when an API requires multiple credentialed headers. Auth-helper requests require HTTPS and omit the credential from the durable receipt. Each auth entry must target a distinct header.
      */
     auth?: PlaySecretAuthInput;
 };
@@ -913,16 +923,16 @@ type PlayAuthoringDefineConfig<TInput, TOutput extends PlayReturnObject, TContex
     description?: string;
     input: PlayAuthoringInputContract<TInput>;
     run: (ctx: TContext, input: TInput) => Promise<TOutput>;
-    bindings?: PlayAuthoringBindings;
-    billing?: PlayAuthoringBindings['billing'];
-    runtime?: PlayAuthoringBindings['runtime'];
-    compatibility?: PlayAuthoringBindings['compatibility'];
+    bindings?: PlayAuthoringBindings<TInput>;
+    billing?: PlayAuthoringBindings<TInput>['billing'];
+    runtime?: PlayAuthoringBindings<TInput>['runtime'];
+    compatibility?: PlayAuthoringBindings<TInput>['compatibility'];
 };
 /** Shared callable-plus-handle shape returned by `definePlay`. */
 type PlayAuthoringDefinedPlay<TInput, TOutput extends PlayReturnObject, TContext, THandle extends object> = ((ctx: TContext, input: TInput) => Promise<TOutput>) & THandle & {
-    readonly bindings?: PlayAuthoringBindings;
-    readonly runtime?: PlayAuthoringBindings['runtime'];
-    readonly compatibility?: PlayAuthoringBindings['compatibility'];
+    readonly bindings?: PlayAuthoringBindings<TInput>;
+    readonly runtime?: PlayAuthoringBindings<TInput>['runtime'];
+    readonly compatibility?: PlayAuthoringBindings<TInput>['compatibility'];
     readonly playName: string;
 };
 /** Canonical resolver shape for a customer-authored durable step. */
@@ -1484,6 +1494,24 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly description: "IANA timezone. Omitted means UTC.";
         readonly errorMessage: "bindings.cron.timezone must be a valid non-empty IANA timezone string.";
     };
+    readonly 'bindings.cron.input': {
+        readonly schema: _sinclair_typebox.TObject<{}>;
+        readonly fixtures: {
+            readonly valid: {
+                readonly apply: true;
+            };
+            readonly invalid: readonly ["apply"];
+            readonly absent: undefined;
+            readonly unresolved: readonly ["cronInput"];
+            readonly edition1: undefined;
+        };
+        readonly referenceType: "Record<string, unknown>";
+        readonly required: false;
+        readonly resolution: "static-required";
+        readonly issueCode: "play_authoring_binding_invalid";
+        readonly description: "Static JSON object passed to every run created by this cron binding.";
+        readonly errorMessage: "bindings.cron.input must be a static JSON object (no variables, spreads, or functions).";
+    };
     readonly 'bindings.sqlListeners': {
         readonly schema: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{}>>;
         readonly fixtures: {

package/dist/{compiler-manifest-B47AA7As.d.ts → compiler-manifest-IkyvsUO-.d.ts}

@@ -711,7 +711,7 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  */
 type ToolExecuteResult<TResult = unknown, TMeta = Record<string, unknown>, TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = ToolExecuteResultBase<TResult, TMeta> & ToolExecuteResultAccessors<TExtracted, TLists>;
 
-declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5];
+declare const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS: readonly [1, 2, 3, 4, 5, 6];
 type PlayAuthoringContractEdition = (typeof SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS)[number];
 type PlaySqlListenerOperation = 'INSERT' | 'UPDATE' | 'DELETE';
 type PlayStandardWebhookHeaderFamily = 'standard' | 'svix';
@@ -781,14 +781,22 @@ type PlayAuthoringAstBindings = {
     cron?: {
         schedule: string;
         timezone?: string;
+        /** Static JSON object supplied to every run started by this cron binding. */
+        input?: Record<string, unknown>;
     };
     sqlListeners?: PlayAuthoringAstSqlListenerDeclaration[];
     invalidSqlListenerSingular?: boolean;
     invalidSqlListenerShape?: boolean;
     secrets?: string[];
 };
+/**
+ * Static cron input must be an object because the scheduler accepts a JSON
+ * object. It is tied to the Play handler input so TypeScript rejects missing
+ * required fields and incompatible values before the Play reaches `check`.
+ */
+type PlayAuthoringCronInput<TInput> = TInput extends readonly unknown[] ? never : TInput extends object ? TInput : never;
 /** The one public type for options accepted by definePlay. */
-type PlayAuthoringBindings = {
+type PlayAuthoringBindings<TInput = Record<string, unknown>> = {
     description?: string;
     compatibility?: {
         toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
@@ -823,6 +831,8 @@ type PlayAuthoringBindings = {
     cron?: {
         schedule: string;
         timezone?: string;
+        /** Static JSON object supplied to every run started by this cron binding. */
+        input?: PlayAuthoringCronInput<TInput>;
     };
     sqlListeners?: PlaySqlListenerDeclaration[];
     secrets?: readonly string[];
@@ -891,7 +901,7 @@ type PlaySecretAwareRequestInit = Omit<RequestInit, 'headers'> & {
     /** Ordinary request headers, recorded in the durable receipt with any resolved Play secret value redacted. Prefer `auth` for credentials: it enforces HTTPS and keeps the auth header out of the receipt. */
     headers?: HeadersInit;
     /**
-     * One or more credentialed headers for this request. Pass a single `ctx.secrets` auth for the common case, or an array when an API requires multiple credentialed headers — for example, Supabase with both `apikey` and `Authorization`. Auth-helper requests require HTTPS and omit the credential from the durable receipt. Each auth entry must target a distinct header.
+     * One or more credentialed headers for this request. Pass a single `ctx.secrets` auth for the common case, or an array when an API requires multiple credentialed headers. Auth-helper requests require HTTPS and omit the credential from the durable receipt. Each auth entry must target a distinct header.
      */
     auth?: PlaySecretAuthInput;
 };
@@ -913,16 +923,16 @@ type PlayAuthoringDefineConfig<TInput, TOutput extends PlayReturnObject, TContex
     description?: string;
     input: PlayAuthoringInputContract<TInput>;
     run: (ctx: TContext, input: TInput) => Promise<TOutput>;
-    bindings?: PlayAuthoringBindings;
-    billing?: PlayAuthoringBindings['billing'];
-    runtime?: PlayAuthoringBindings['runtime'];
-    compatibility?: PlayAuthoringBindings['compatibility'];
+    bindings?: PlayAuthoringBindings<TInput>;
+    billing?: PlayAuthoringBindings<TInput>['billing'];
+    runtime?: PlayAuthoringBindings<TInput>['runtime'];
+    compatibility?: PlayAuthoringBindings<TInput>['compatibility'];
 };
 /** Shared callable-plus-handle shape returned by `definePlay`. */
 type PlayAuthoringDefinedPlay<TInput, TOutput extends PlayReturnObject, TContext, THandle extends object> = ((ctx: TContext, input: TInput) => Promise<TOutput>) & THandle & {
-    readonly bindings?: PlayAuthoringBindings;
-    readonly runtime?: PlayAuthoringBindings['runtime'];
-    readonly compatibility?: PlayAuthoringBindings['compatibility'];
+    readonly bindings?: PlayAuthoringBindings<TInput>;
+    readonly runtime?: PlayAuthoringBindings<TInput>['runtime'];
+    readonly compatibility?: PlayAuthoringBindings<TInput>['compatibility'];
     readonly playName: string;
 };
 /** Canonical resolver shape for a customer-authored durable step. */
@@ -1484,6 +1494,24 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
         readonly description: "IANA timezone. Omitted means UTC.";
         readonly errorMessage: "bindings.cron.timezone must be a valid non-empty IANA timezone string.";
     };
+    readonly 'bindings.cron.input': {
+        readonly schema: _sinclair_typebox.TObject<{}>;
+        readonly fixtures: {
+            readonly valid: {
+                readonly apply: true;
+            };
+            readonly invalid: readonly ["apply"];
+            readonly absent: undefined;
+            readonly unresolved: readonly ["cronInput"];
+            readonly edition1: undefined;
+        };
+        readonly referenceType: "Record<string, unknown>";
+        readonly required: false;
+        readonly resolution: "static-required";
+        readonly issueCode: "play_authoring_binding_invalid";
+        readonly description: "Static JSON object passed to every run created by this cron binding.";
+        readonly errorMessage: "bindings.cron.input must be a static JSON object (no variables, spreads, or functions).";
+    };
     readonly 'bindings.sqlListeners': {
         readonly schema: _sinclair_typebox.TArray<_sinclair_typebox.TObject<{}>>;
         readonly fixtures: {

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { c as PlayCompilerManifest, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, D as PlayAuthoringRuntimeStepOptions, E as PlaySqlListenerDeclaration, F as PlaySqlListenerEvent, G as PlaySqlListenerOperation, H as PlaySqlQuery, I as PlayAuthoringStepOptions, J as PlayAuthoringStepProgram, K as PlayAuthoringStepProgramResolver, L as PlayAuthoringStepResolver, M as PlayToolExecutionRequest, N as PlayAuthoringStepProgramOptions, O as DeeplineError, Q as ToolExecutionError, R as ToolExecutionErrorOptions } from './compiler-manifest-B47AA7As.mjs';
-export { S as CtxFetchHttpError, U as DEEPLINE_EXTRACTOR_TARGETS, V as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, W as DeeplineEmailStatusGetterValue, X as DeeplineExtractorTarget, Y as DeeplineGetterValue, Z as DeeplineGetterValueMap, _ as JOB_CHANGE_STATUS_VALUES, $ as JobChangeStatus, a0 as PHONE_STATUS_VALUES, a1 as PhoneStatus, a2 as PlayDataset, a3 as PlayDatasetInput, a4 as PreviousCell, a5 as ProviderTransientError, a6 as ProviderTransientErrorCategory, a7 as ProviderUnavailableError, a8 as ProviderUnavailableReason, a9 as ToolExecutionErrorCategory, aa as ToolExecutionErrorOrigin, ab as ToolExecutionFailureV1, ac as ToolExecutionNetworkKind, ad as ToolExecutionNetworkScope, ae as ToolExecutionPublicDetails, af as getProviderUnavailableReason, ag as isDeeplineExtractorTarget, ah as isProviderUnavailable, ai as isProviderWaterfallUnavailableError } from './compiler-manifest-B47AA7As.mjs';
+import { c as PlayCompilerManifest, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, D as PlayAuthoringRuntimeStepOptions, E as PlaySqlListenerDeclaration, F as PlaySqlListenerEvent, G as PlaySqlListenerOperation, H as PlaySqlQuery, I as PlayAuthoringStepOptions, J as PlayAuthoringStepProgram, K as PlayAuthoringStepProgramResolver, L as PlayAuthoringStepResolver, M as PlayToolExecutionRequest, N as PlayAuthoringStepProgramOptions, O as DeeplineError, Q as ToolExecutionError, R as ToolExecutionErrorOptions } from './compiler-manifest-IkyvsUO-.mjs';
+export { S as CtxFetchHttpError, U as DEEPLINE_EXTRACTOR_TARGETS, V as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, W as DeeplineEmailStatusGetterValue, X as DeeplineExtractorTarget, Y as DeeplineGetterValue, Z as DeeplineGetterValueMap, _ as JOB_CHANGE_STATUS_VALUES, $ as JobChangeStatus, a0 as PHONE_STATUS_VALUES, a1 as PhoneStatus, a2 as PlayDataset, a3 as PlayDatasetInput, a4 as PreviousCell, a5 as ProviderTransientError, a6 as ProviderTransientErrorCategory, a7 as ProviderUnavailableError, a8 as ProviderUnavailableReason, a9 as ToolExecutionErrorCategory, aa as ToolExecutionErrorOrigin, ab as ToolExecutionFailureV1, ac as ToolExecutionNetworkKind, ad as ToolExecutionNetworkScope, ae as ToolExecutionPublicDetails, af as getProviderUnavailableReason, ag as isDeeplineExtractorTarget, ah as isProviderUnavailable, ai as isProviderWaterfallUnavailableError } from './compiler-manifest-IkyvsUO-.mjs';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -1193,6 +1193,20 @@ interface PlayDefinitionDetail {
     liveRevision?: PlayRevisionSummary | null;
     /** `true` if the working revision differs from the live revision. */
     isDraftDirty?: boolean;
+    /** Live trigger state. This is operational state, not a source declaration. */
+    triggerStatus?: PlayTriggerStatus;
+    /**
+     * Additive scheduler metadata for human/UI rendering. Values are absent for
+     * plays with no cron binding and must never be inferred from source alone.
+     */
+    triggerMetadata?: {
+        cronSchedule?: string | null;
+        cronTimezone?: string | null;
+        nextScheduledAt?: number | null;
+        lastScheduledAt?: number | null;
+        blockedReason?: string | null;
+        [key: string]: unknown;
+    } | null;
     /** Effective sandbox limit from the live revision, or the working draft before first publish. */
     runtimeLimit?: PlayRuntimeLimit | null;
     /** Present for a Play with a cron trigger. Advisory only; publish remains authoritative. */
@@ -1228,11 +1242,13 @@ interface PlayListItem {
     currentRevision?: PlayRevisionSummary | null;
     liveRevision?: PlayRevisionSummary | null;
     aliases?: string[];
-    triggerStatus?: {
-        cron: string | null;
-        webhook: string | null;
-        blockedReason: string | null;
-    };
+    triggerStatus?: PlayTriggerStatus;
+}
+/** Additive live trigger state shared by list, get, and describe. */
+interface PlayTriggerStatus {
+    cron: string | null;
+    webhook: string | null;
+    blockedReason: string | null;
 }
 interface ProductNotificationEventDefinition {
     id: string;
@@ -1314,11 +1330,9 @@ interface PlayDescription {
      */
     liveVersion?: number | null;
     /** Whether this play's cron and webhook triggers are armed. */
-    triggerStatus?: {
-        cron: string | null;
-        webhook: string | null;
-        blockedReason: string | null;
-    };
+    triggerStatus?: PlayTriggerStatus;
+    /** Additive cron timing metadata for an operational description. */
+    triggerMetadata?: PlayDefinitionDetail['triggerMetadata'];
     isDraftDirty?: boolean;
     latestRunId?: string | null;
     /** Effective sandbox limit from the revision named runs use. */
@@ -1613,6 +1627,8 @@ interface PlayCheckTriggersSummary {
     cron?: {
         schedule: string;
         timezone?: string;
+        /** Static input supplied to every run started by this cron binding. */
+        input?: Record<string, unknown>;
     };
     webhook?: true;
 }
@@ -4132,7 +4148,7 @@ type PlayFetchResponse = PlayAuthoringFetchResponse;
  *
  * @sdkReference runtime 030
  */
-type PlayBindings = PlayAuthoringBindings;
+type PlayBindings<TInput = Record<string, unknown>> = PlayAuthoringBindings<TInput>;
 type SqlListenerOperation = PlaySqlListenerOperation;
 type SqlListenerDeclaration = PlaySqlListenerDeclaration;
 type SqlListenerEvent<T extends object = Record<string, unknown>> = PlaySqlListenerEvent<T>;
@@ -4491,14 +4507,16 @@ declare function runIf<Row, Value>(predicate: (row: Row, index: number) => boole
  * ```
  */
 type DefinedPlay<TInput, TOutput extends PlayReturnObject> = PlayAuthoringDefinedPlay<TInput, TOutput, DeeplinePlayRuntimeContext, DeeplineNamedPlay<TInput, TOutput>>;
-type PlayMetadata = {
+type PlayHandlerInput<THandler> = THandler extends (context: DeeplinePlayRuntimeContext, input: infer TInput) => Promise<PlayReturnObject> ? TInput : never;
+type PlayHandlerOutput<THandler> = THandler extends (context: DeeplinePlayRuntimeContext, input: unknown) => Promise<infer TOutput extends PlayReturnObject> ? TOutput : never;
+type PlayMetadata<TInput = Record<string, unknown>> = {
     name: string;
     description?: string;
-    bindings?: PlayBindings;
+    bindings?: PlayBindings<TInput>;
     inputSchema?: Record<string, unknown>;
-    billing?: PlayBindings['billing'];
-    runtime?: PlayBindings['runtime'];
-    compatibility?: PlayBindings['compatibility'];
+    billing?: PlayBindings<TInput>['billing'];
+    runtime?: PlayBindings<TInput>['runtime'];
+    compatibility?: PlayBindings<TInput>['compatibility'];
 };
 /**
  * High-level SDK context with tool shortcuts and play handles.
@@ -4705,6 +4723,10 @@ declare function defineInput<TInput>(schema: Record<string, unknown>): PlayInput
  * ```
  */
 declare function definePlay<TInput, TOutput extends PlayReturnObject>(config: DefinePlayConfig<TInput, TOutput>): DefinedPlay<TInput, TOutput>;
+/** @internal Contextually type unannotated monitor-event handlers as unknown. */
+declare function definePlay<TOutput extends PlayReturnObject>(name: string, fn: (context: DeeplinePlayRuntimeContext, input: unknown) => Promise<TOutput>, bindings: PlayBindings<never> & {
+    readonly sqlListeners: readonly SqlListenerDeclaration[];
+}): DefinedPlay<unknown, TOutput>;
 /**
  * Define a play with a name and function.
  *
@@ -4713,7 +4735,7 @@ declare function definePlay<TInput, TOutput extends PlayReturnObject>(config: De
  * @param bindings - Play configuration, including runtime limits and triggers.
  * @returns Play handle.
  */
-declare function definePlay<TInput, TOutput extends PlayReturnObject>(name: string, fn: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>, bindings?: PlayBindings): DefinedPlay<TInput, TOutput>;
+declare function definePlay<THandler extends (context: DeeplinePlayRuntimeContext, input: any) => Promise<PlayReturnObject>>(name: string, fn: THandler, bindings?: PlayBindings<NoInfer<PlayHandlerInput<THandler>>>): DefinedPlay<PlayHandlerInput<THandler>, PlayHandlerOutput<THandler>>;
 /**
  * Alias for {@link definePlay}. Workflows and plays share the same public
  * Deepline SDK contract; the selected execution profile decides whether the

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { c as PlayCompilerManifest, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, D as PlayAuthoringRuntimeStepOptions, E as PlaySqlListenerDeclaration, F as PlaySqlListenerEvent, G as PlaySqlListenerOperation, H as PlaySqlQuery, I as PlayAuthoringStepOptions, J as PlayAuthoringStepProgram, K as PlayAuthoringStepProgramResolver, L as PlayAuthoringStepResolver, M as PlayToolExecutionRequest, N as PlayAuthoringStepProgramOptions, O as DeeplineError, Q as ToolExecutionError, R as ToolExecutionErrorOptions } from './compiler-manifest-B47AA7As.js';
-export { S as CtxFetchHttpError, U as DEEPLINE_EXTRACTOR_TARGETS, V as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, W as DeeplineEmailStatusGetterValue, X as DeeplineExtractorTarget, Y as DeeplineGetterValue, Z as DeeplineGetterValueMap, _ as JOB_CHANGE_STATUS_VALUES, $ as JobChangeStatus, a0 as PHONE_STATUS_VALUES, a1 as PhoneStatus, a2 as PlayDataset, a3 as PlayDatasetInput, a4 as PreviousCell, a5 as ProviderTransientError, a6 as ProviderTransientErrorCategory, a7 as ProviderUnavailableError, a8 as ProviderUnavailableReason, a9 as ToolExecutionErrorCategory, aa as ToolExecutionErrorOrigin, ab as ToolExecutionFailureV1, ac as ToolExecutionNetworkKind, ad as ToolExecutionNetworkScope, ae as ToolExecutionPublicDetails, af as getProviderUnavailableReason, ag as isDeeplineExtractorTarget, ah as isProviderUnavailable, ai as isProviderWaterfallUnavailableError } from './compiler-manifest-B47AA7As.js';
+import { c as PlayCompilerManifest, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, D as PlayAuthoringRuntimeStepOptions, E as PlaySqlListenerDeclaration, F as PlaySqlListenerEvent, G as PlaySqlListenerOperation, H as PlaySqlQuery, I as PlayAuthoringStepOptions, J as PlayAuthoringStepProgram, K as PlayAuthoringStepProgramResolver, L as PlayAuthoringStepResolver, M as PlayToolExecutionRequest, N as PlayAuthoringStepProgramOptions, O as DeeplineError, Q as ToolExecutionError, R as ToolExecutionErrorOptions } from './compiler-manifest-IkyvsUO-.js';
+export { S as CtxFetchHttpError, U as DEEPLINE_EXTRACTOR_TARGETS, V as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, W as DeeplineEmailStatusGetterValue, X as DeeplineExtractorTarget, Y as DeeplineGetterValue, Z as DeeplineGetterValueMap, _ as JOB_CHANGE_STATUS_VALUES, $ as JobChangeStatus, a0 as PHONE_STATUS_VALUES, a1 as PhoneStatus, a2 as PlayDataset, a3 as PlayDatasetInput, a4 as PreviousCell, a5 as ProviderTransientError, a6 as ProviderTransientErrorCategory, a7 as ProviderUnavailableError, a8 as ProviderUnavailableReason, a9 as ToolExecutionErrorCategory, aa as ToolExecutionErrorOrigin, ab as ToolExecutionFailureV1, ac as ToolExecutionNetworkKind, ad as ToolExecutionNetworkScope, ae as ToolExecutionPublicDetails, af as getProviderUnavailableReason, ag as isDeeplineExtractorTarget, ah as isProviderUnavailable, ai as isProviderWaterfallUnavailableError } from './compiler-manifest-IkyvsUO-.js';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -1193,6 +1193,20 @@ interface PlayDefinitionDetail {
     liveRevision?: PlayRevisionSummary | null;
     /** `true` if the working revision differs from the live revision. */
     isDraftDirty?: boolean;
+    /** Live trigger state. This is operational state, not a source declaration. */
+    triggerStatus?: PlayTriggerStatus;
+    /**
+     * Additive scheduler metadata for human/UI rendering. Values are absent for
+     * plays with no cron binding and must never be inferred from source alone.
+     */
+    triggerMetadata?: {
+        cronSchedule?: string | null;
+        cronTimezone?: string | null;
+        nextScheduledAt?: number | null;
+        lastScheduledAt?: number | null;
+        blockedReason?: string | null;
+        [key: string]: unknown;
+    } | null;
     /** Effective sandbox limit from the live revision, or the working draft before first publish. */
     runtimeLimit?: PlayRuntimeLimit | null;
     /** Present for a Play with a cron trigger. Advisory only; publish remains authoritative. */
@@ -1228,11 +1242,13 @@ interface PlayListItem {
     currentRevision?: PlayRevisionSummary | null;
     liveRevision?: PlayRevisionSummary | null;
     aliases?: string[];
-    triggerStatus?: {
-        cron: string | null;
-        webhook: string | null;
-        blockedReason: string | null;
-    };
+    triggerStatus?: PlayTriggerStatus;
+}
+/** Additive live trigger state shared by list, get, and describe. */
+interface PlayTriggerStatus {
+    cron: string | null;
+    webhook: string | null;
+    blockedReason: string | null;
 }
 interface ProductNotificationEventDefinition {
     id: string;
@@ -1314,11 +1330,9 @@ interface PlayDescription {
      */
     liveVersion?: number | null;
     /** Whether this play's cron and webhook triggers are armed. */
-    triggerStatus?: {
-        cron: string | null;
-        webhook: string | null;
-        blockedReason: string | null;
-    };
+    triggerStatus?: PlayTriggerStatus;
+    /** Additive cron timing metadata for an operational description. */
+    triggerMetadata?: PlayDefinitionDetail['triggerMetadata'];
     isDraftDirty?: boolean;
     latestRunId?: string | null;
     /** Effective sandbox limit from the revision named runs use. */
@@ -1613,6 +1627,8 @@ interface PlayCheckTriggersSummary {
     cron?: {
         schedule: string;
         timezone?: string;
+        /** Static input supplied to every run started by this cron binding. */
+        input?: Record<string, unknown>;
     };
     webhook?: true;
 }
@@ -4132,7 +4148,7 @@ type PlayFetchResponse = PlayAuthoringFetchResponse;
  *
  * @sdkReference runtime 030
  */
-type PlayBindings = PlayAuthoringBindings;
+type PlayBindings<TInput = Record<string, unknown>> = PlayAuthoringBindings<TInput>;
 type SqlListenerOperation = PlaySqlListenerOperation;
 type SqlListenerDeclaration = PlaySqlListenerDeclaration;
 type SqlListenerEvent<T extends object = Record<string, unknown>> = PlaySqlListenerEvent<T>;
@@ -4491,14 +4507,16 @@ declare function runIf<Row, Value>(predicate: (row: Row, index: number) => boole
  * ```
  */
 type DefinedPlay<TInput, TOutput extends PlayReturnObject> = PlayAuthoringDefinedPlay<TInput, TOutput, DeeplinePlayRuntimeContext, DeeplineNamedPlay<TInput, TOutput>>;
-type PlayMetadata = {
+type PlayHandlerInput<THandler> = THandler extends (context: DeeplinePlayRuntimeContext, input: infer TInput) => Promise<PlayReturnObject> ? TInput : never;
+type PlayHandlerOutput<THandler> = THandler extends (context: DeeplinePlayRuntimeContext, input: unknown) => Promise<infer TOutput extends PlayReturnObject> ? TOutput : never;
+type PlayMetadata<TInput = Record<string, unknown>> = {
     name: string;
     description?: string;
-    bindings?: PlayBindings;
+    bindings?: PlayBindings<TInput>;
     inputSchema?: Record<string, unknown>;
-    billing?: PlayBindings['billing'];
-    runtime?: PlayBindings['runtime'];
-    compatibility?: PlayBindings['compatibility'];
+    billing?: PlayBindings<TInput>['billing'];
+    runtime?: PlayBindings<TInput>['runtime'];
+    compatibility?: PlayBindings<TInput>['compatibility'];
 };
 /**
  * High-level SDK context with tool shortcuts and play handles.
@@ -4705,6 +4723,10 @@ declare function defineInput<TInput>(schema: Record<string, unknown>): PlayInput
  * ```
  */
 declare function definePlay<TInput, TOutput extends PlayReturnObject>(config: DefinePlayConfig<TInput, TOutput>): DefinedPlay<TInput, TOutput>;
+/** @internal Contextually type unannotated monitor-event handlers as unknown. */
+declare function definePlay<TOutput extends PlayReturnObject>(name: string, fn: (context: DeeplinePlayRuntimeContext, input: unknown) => Promise<TOutput>, bindings: PlayBindings<never> & {
+    readonly sqlListeners: readonly SqlListenerDeclaration[];
+}): DefinedPlay<unknown, TOutput>;
 /**
  * Define a play with a name and function.
  *
@@ -4713,7 +4735,7 @@ declare function definePlay<TInput, TOutput extends PlayReturnObject>(config: De
  * @param bindings - Play configuration, including runtime limits and triggers.
  * @returns Play handle.
  */
-declare function definePlay<TInput, TOutput extends PlayReturnObject>(name: string, fn: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>, bindings?: PlayBindings): DefinedPlay<TInput, TOutput>;
+declare function definePlay<THandler extends (context: DeeplinePlayRuntimeContext, input: any) => Promise<PlayReturnObject>>(name: string, fn: THandler, bindings?: PlayBindings<NoInfer<PlayHandlerInput<THandler>>>): DefinedPlay<PlayHandlerInput<THandler>, PlayHandlerOutput<THandler>>;
 /**
  * Alias for {@link definePlay}. Workflows and plays share the same public
  * Deepline SDK contract; the selected execution profile decides whether the

package/dist/index.js

@@ -826,7 +826,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.59",
+  version: "0.3.60",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -4596,6 +4596,7 @@ var DeeplineClient = class {
       ...this.summarizePlayListItem(play, options),
       currentPublishedVersion: play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
       latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
+      ...play.triggerMetadata ? { triggerMetadata: play.triggerMetadata } : {},
       ...play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {},
       ...play.activeScheduledPlays ? { activeScheduledPlays: play.activeScheduledPlays } : {}
     };
@@ -8395,6 +8396,39 @@ var PLAY_SQL_LISTENER_TOOL_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]*\.[a-zA-Z][a-zA-Z0-
 var PLAY_SQL_LISTENER_WHERE_OPERATOR_SET = new Set(
   PLAY_SQL_LISTENER_WHERE_OPERATORS
 );
+var PLAY_AUTHORING_BINDING_FIELDS = {
+  root: [
+    "billing",
+    "compatibility",
+    "cron",
+    "inline",
+    "runtime",
+    "secrets",
+    "sqlListeners",
+    "webhook"
+  ],
+  cron: ["schedule", "timezone", "input"],
+  webhook: ["auth", "hmac"],
+  sqlListener: [
+    "id",
+    "tool",
+    "stream",
+    "where",
+    "table",
+    "monitor",
+    "output",
+    "operations"
+  ]
+};
+var PLAY_AUTHORING_DEFINE_PLAY_OPTION_FIELDS = [
+  "id",
+  "name",
+  "description",
+  "input",
+  "run",
+  "bindings",
+  ...PLAY_AUTHORING_BINDING_FIELDS.root
+];
 var CtxFetchHttpError = class extends Error {
   /** Build the error from the durable response record. */
   constructor(response) {
@@ -8694,6 +8728,22 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
     description: "IANA timezone. Omitted means UTC.",
     errorMessage: "bindings.cron.timezone must be a valid non-empty IANA timezone string."
   },
+  "bindings.cron.input": {
+    schema: import_typebox.Type.Object({}, { additionalProperties: true }),
+    fixtures: {
+      valid: { apply: true },
+      invalid: ["apply"],
+      absent: void 0,
+      unresolved: ["cronInput"],
+      edition1: void 0
+    },
+    referenceType: "Record<string, unknown>",
+    required: false,
+    resolution: "static-required",
+    issueCode: "play_authoring_binding_invalid",
+    description: "Static JSON object passed to every run created by this cron binding.",
+    errorMessage: "bindings.cron.input must be a static JSON object (no variables, spreads, or functions)."
+  },
   "bindings.sqlListeners": {
     schema: import_typebox.Type.Array(import_typebox.Type.Object({}, { additionalProperties: true })),
     fixtures: {
@@ -9697,14 +9747,15 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "  readonly timeoutMs?: PlayRuntimeTimeoutMs;",
   "  readonly receiptWaitMs?: PlayReceiptWaitMs;",
   "};",
-  "export type PlayBindings = {",
+  "export type PlayCronInput<TInput> = TInput extends readonly unknown[] ? never : TInput extends object ? TInput : never;",
+  "export type PlayBindings<TInput = Record<string, unknown>> = {",
   `  description?: ${cloudReferenceType("description")};`,
   `  compatibility?: { toolErrorSchemaVersion?: ${cloudReferenceType("compatibility.toolErrorSchemaVersion")}; toolResponseReceiptRevision?: ${cloudReferenceType("compatibility.toolResponseReceiptRevision")} };`,
   `  inline?: ${cloudReferenceType("inline")};`,
   `  billing?: { maxCreditsPerRun?: ${cloudReferenceType("billing.maxCreditsPerRun")} };`,
   `  runtime?: { timeout?: ${cloudReferenceType("runtime.timeout")}; size?: ${cloudReferenceType("runtime.size")} };`,
   `  webhook?: { hmac?: { algorithm?: ${cloudReferenceType("bindings.webhook.hmac.algorithm")}; header?: ${cloudReferenceType("bindings.webhook.hmac.header")}; secretEnv: ${cloudReferenceType("bindings.webhook.hmac.secretEnv")} }; auth?: { type: ${cloudReferenceType("bindings.webhook.auth.type")}; headerFamily: ${cloudReferenceType("bindings.webhook.auth.headerFamily")}; signingSecrets: readonly ${cloudReferenceType("bindings.webhook.auth.signingSecrets[]")}[]; toleranceSeconds?: ${cloudReferenceType("bindings.webhook.auth.toleranceSeconds")} } };`,
-  `  cron?: { schedule: ${cloudReferenceType("bindings.cron.schedule")}; timezone?: ${cloudReferenceType("bindings.cron.timezone")} };`,
+  `  cron?: { schedule: ${cloudReferenceType("bindings.cron.schedule")}; timezone?: ${cloudReferenceType("bindings.cron.timezone")}; input?: PlayCronInput<TInput> };`,
   "  sqlListeners?: readonly SqlListenerDeclaration[];",
   `  secrets?: readonly ${cloudReferenceType("bindings.secrets[]")}[];`,
   "};",
@@ -9770,8 +9821,10 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "  log(message: string): void;",
   `  sleep(ms: ${cloudReferenceType("ctx.sleep.ms")}): Promise<void>;`,
   "}",
-  "export type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = { id: string; description?: string; input: PlayInputContract<TInput>; run: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>; bindings?: PlayBindings; billing?: PlayBindings['billing']; runtime?: PlayBindings['runtime']; compatibility?: PlayBindings['compatibility'] };",
-  "export type DefinedPlay<TInput, TOutput extends PlayReturnObject> = ((ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>) & { readonly name: string; readonly __inputType?: TInput; readonly __outputType?: TOutput; readonly runtime?: PlayBindings['runtime']; readonly compatibility?: PlayBindings['compatibility'] };"
+  "export type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = { id: string; description?: string; input: PlayInputContract<TInput>; run: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>; bindings?: PlayBindings<TInput>; billing?: PlayBindings<TInput>['billing']; runtime?: PlayBindings<TInput>['runtime']; compatibility?: PlayBindings<TInput>['compatibility'] };",
+  "export type DefinedPlay<TInput, TOutput extends PlayReturnObject> = ((ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>) & { readonly name: string; readonly __inputType?: TInput; readonly __outputType?: TOutput; readonly bindings?: PlayBindings<TInput>; readonly runtime?: PlayBindings<TInput>['runtime']; readonly compatibility?: PlayBindings<TInput>['compatibility'] };",
+  "export type PlayHandlerInput<THandler> = THandler extends (context: DeeplinePlayRuntimeContext, input: infer TInput) => Promise<PlayReturnObject> ? TInput : never;",
+  "export type PlayHandlerOutput<THandler> = THandler extends (context: DeeplinePlayRuntimeContext, input: unknown) => Promise<infer TOutput extends PlayReturnObject> ? TOutput : never;"
 ];
 
 // ../play-runtime/query-result-dataset.ts