@runtypelabs/sdk 1.19.1 → 1.21.0

package/dist/index.cjs

@@ -305,6 +305,8 @@ __export(index_exports, {
   RuntypeApiError: () => RuntypeApiError,
   RuntypeClient: () => RuntypeClient2,
   RuntypeFlowBuilder: () => RuntypeFlowBuilder,
+  STEP_FIELD_REGISTRY: () => STEP_FIELD_REGISTRY,
+  STEP_TYPE_TO_METHOD: () => STEP_TYPE_TO_METHOD,
   ToolsEndpoint: () => ToolsEndpoint,
   UsersEndpoint: () => UsersEndpoint,
   applyGeneratedRuntimeToolProposalToDispatchRequest: () => applyGeneratedRuntimeToolProposalToDispatchRequest,
@@ -8405,6 +8407,255 @@ var ClientEvalBuilder = class extends EvalBuilder {
     return this.boundClient.eval(config);
   }
 };
+
+// src/codegen-metadata.ts
+var PROMPT_FIELDS = [
+  { key: "model", format: "json" },
+  { key: "userPrompt", format: "template" },
+  { key: "systemPrompt", format: "template" },
+  { key: "previousMessages", format: "value" },
+  { key: "outputVariable", format: "json" },
+  { key: "responseFormat", format: "json", skipDefault: "text" },
+  { key: "temperature", format: "raw" },
+  { key: "topP", format: "raw" },
+  { key: "topK", format: "raw" },
+  { key: "frequencyPenalty", format: "raw" },
+  { key: "presencePenalty", format: "raw" },
+  { key: "seed", format: "raw" },
+  { key: "maxTokens", format: "raw" },
+  { key: "reasoning", format: "value" },
+  { key: "streamOutput", format: "raw", emitWhen: "falsy" },
+  { key: "tools", format: "value" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var CRAWL_FIELDS = [
+  { key: "url", format: "json" },
+  { key: "limit", format: "raw" },
+  { key: "depth", format: "raw" },
+  { key: "source", format: "json" },
+  { key: "formats", format: "value" },
+  { key: "render", format: "raw" },
+  { key: "maxAge", format: "raw" },
+  { key: "modifiedSince", format: "json" },
+  { key: "options", format: "value" },
+  { key: "authenticate", format: "value" },
+  { key: "cookies", format: "value" },
+  { key: "setExtraHTTPHeaders", format: "value" },
+  { key: "gotoOptions", format: "value" },
+  { key: "waitForSelector", format: "json" },
+  { key: "rejectResourceTypes", format: "value" },
+  { key: "rejectRequestPattern", format: "value" },
+  { key: "userAgent", format: "json" },
+  { key: "jsonOptions", format: "value" },
+  { key: "pollIntervalMs", format: "raw" },
+  { key: "completionTimeoutMs", format: "raw" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var FETCH_URL_FIELDS = [
+  { key: "url", format: "json", source: "http.url" },
+  { key: "method", format: "json", source: "http.method", skipDefault: "GET" },
+  { key: "headers", format: "value", source: "http.headers" },
+  { key: "body", format: "template", source: "http.body" },
+  { key: "responseType", format: "json" },
+  { key: "markdownIfAvailable", format: "raw" },
+  { key: "fetchMethod", format: "json", skipDefault: "http" },
+  { key: "firecrawl", format: "value" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var TRANSFORM_DATA_FIELDS = [
+  { key: "script", format: "template" },
+  { key: "outputVariable", format: "json" },
+  { key: "sandboxProvider", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var SET_VARIABLE_FIELDS = [
+  { key: "variableName", format: "json" },
+  { key: "value", format: "template" }
+];
+var CONDITIONAL_FIELDS = [
+  { key: "condition", format: "template" },
+  { key: "trueSteps", format: "value" },
+  { key: "falseSteps", format: "value" }
+];
+var SEARCH_FIELDS = [
+  { key: "provider", format: "json" },
+  { key: "query", format: "template" },
+  { key: "maxResults", format: "raw", skipDefault: 10 },
+  { key: "returnCitations", format: "raw" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var SEND_EMAIL_FIELDS = [
+  { key: "to", format: "json" },
+  { key: "from", format: "json" },
+  { key: "subject", format: "template" },
+  { key: "html", format: "template" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var SEND_STREAM_FIELDS = [
+  { key: "message", format: "template" }
+];
+var RETRIEVE_RECORD_FIELDS = [
+  { key: "recordType", format: "json" },
+  { key: "recordName", format: "json" },
+  { key: "recordFilter", format: "value" },
+  { key: "fieldsToInclude", format: "json" },
+  { key: "fieldsToExclude", format: "json" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var UPSERT_RECORD_FIELDS = [
+  { key: "recordType", format: "json" },
+  { key: "recordName", format: "json" },
+  { key: "sourceVariable", format: "json" },
+  { key: "mergeStrategy", format: "json", skipDefault: "merge" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var VECTOR_SEARCH_FIELDS = [
+  { key: "query", format: "template" },
+  { key: "recordType", format: "json" },
+  { key: "embeddingModel", format: "json" },
+  { key: "limit", format: "raw", skipDefault: 5 },
+  { key: "threshold", format: "raw", skipDefault: 0.7 },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var GENERATE_EMBEDDING_FIELDS = [
+  { key: "text", format: "template" },
+  { key: "embeddingModel", format: "json" },
+  { key: "maxLength", format: "raw" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var WAIT_UNTIL_FIELDS = [
+  { key: "delayMs", format: "raw" },
+  { key: "continueOnTimeout", format: "raw", emitWhen: "truthy" },
+  { key: "poll", format: "value", sourceCheck: "poll.enabled" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var SEND_EVENT_FIELDS = [
+  { key: "provider", format: "json" },
+  { key: "eventName", format: "json" },
+  { key: "properties", format: "value" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var SEND_TEXT_FIELDS = [
+  { key: "to", format: "json" },
+  { key: "from", format: "json" },
+  { key: "message", format: "template" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var FETCH_GITHUB_FIELDS = [
+  { key: "repository", format: "json" },
+  { key: "branch", format: "json" },
+  { key: "path", format: "json" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var TEMPLATE_FIELDS = [
+  { key: "template", format: "template" },
+  { key: "outputFormat", format: "json" },
+  { key: "inputs", format: "value" },
+  { key: "partials", format: "value" },
+  { key: "pdfOptions", format: "value" },
+  { key: "asArtifact", format: "raw" },
+  { key: "streamOutput", format: "raw" },
+  { key: "outputVariable", format: "json" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var STORE_ASSET_FIELDS = [
+  { key: "url", format: "json" },
+  { key: "content", format: "template" },
+  { key: "filename", format: "json" },
+  { key: "contentType", format: "json" },
+  { key: "visibility", format: "json" },
+  { key: "outputVariable", format: "json" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var GENERATE_PDF_FIELDS = [
+  { key: "html", format: "template" },
+  { key: "markdown", format: "template" },
+  { key: "filename", format: "json" },
+  { key: "visibility", format: "json" },
+  { key: "pdfOptions", format: "value" },
+  { key: "outputVariable", format: "json" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var COMMON_ONLY_FIELDS = [
+  { key: "outputVariable", format: "json" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var STEP_FIELD_REGISTRY = {
+  "prompt": PROMPT_FIELDS,
+  "crawl": CRAWL_FIELDS,
+  "fetch-url": FETCH_URL_FIELDS,
+  "api-call": FETCH_URL_FIELDS,
+  "transform-data": TRANSFORM_DATA_FIELDS,
+  "set-variable": SET_VARIABLE_FIELDS,
+  "conditional": CONDITIONAL_FIELDS,
+  "search": SEARCH_FIELDS,
+  "send-email": SEND_EMAIL_FIELDS,
+  "send-stream": SEND_STREAM_FIELDS,
+  "retrieve-record": RETRIEVE_RECORD_FIELDS,
+  "upsert-record": UPSERT_RECORD_FIELDS,
+  "update-record": UPSERT_RECORD_FIELDS,
+  "vector-search": VECTOR_SEARCH_FIELDS,
+  "generate-embedding": GENERATE_EMBEDDING_FIELDS,
+  "wait-until": WAIT_UNTIL_FIELDS,
+  "send-event": SEND_EVENT_FIELDS,
+  "send-text": SEND_TEXT_FIELDS,
+  "fetch-github": FETCH_GITHUB_FIELDS,
+  "template": TEMPLATE_FIELDS,
+  "store-asset": STORE_ASSET_FIELDS,
+  "generate-pdf": GENERATE_PDF_FIELDS,
+  "tool-call": COMMON_ONLY_FIELDS,
+  "paginate-api": COMMON_ONLY_FIELDS,
+  "store-vector": COMMON_ONLY_FIELDS,
+  "execute-agent": COMMON_ONLY_FIELDS
+};
+var STEP_TYPE_TO_METHOD = {
+  "prompt": "prompt",
+  "crawl": "crawl",
+  "fetch-url": "fetchUrl",
+  "api-call": "apiCall",
+  "retrieve-record": "retrieveRecord",
+  "fetch-github": "fetchGitHub",
+  "transform-data": "transformData",
+  "template": "template",
+  "conditional": "conditional",
+  "set-variable": "setVariable",
+  "upsert-record": "upsertRecord",
+  "update-record": "updateRecord",
+  "send-email": "sendEmail",
+  "send-text": "sendText",
+  "send-event": "sendEvent",
+  "send-stream": "sendStream",
+  "search": "search",
+  "generate-embedding": "generateEmbedding",
+  "vector-search": "vectorSearch",
+  "tool-call": "toolCall",
+  "wait-until": "waitUntil",
+  "paginate-api": "paginateApi",
+  "store-vector": "storeVector",
+  "execute-agent": "executeAgent",
+  "store-asset": "storeAsset",
+  "generate-pdf": "generatePdf"
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentsEndpoint,
@@ -8437,6 +8688,8 @@ var ClientEvalBuilder = class extends EvalBuilder {
   RuntypeApiError,
   RuntypeClient,
   RuntypeFlowBuilder,
+  STEP_FIELD_REGISTRY,
+  STEP_TYPE_TO_METHOD,
   ToolsEndpoint,
   UsersEndpoint,
   applyGeneratedRuntimeToolProposalToDispatchRequest,

package/dist/index.d.cts

@@ -1077,10 +1077,36 @@ interface SendStreamStepConfig$1 {
     /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
     when?: string;
 }
+/**
+ * Operator allowlist for chip-style record filters. Mirrors the API's
+ * `record-filter-compiler.ts`. Kept inline here to avoid a hard dependency
+ * on `@runtypelabs/shared` from the published SDK.
+ */
+type RecordFilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'notIn' | 'isSet' | 'isNotSet' | 'isTrue' | 'isFalse' | 'withinLastDays' | 'olderThanDays';
+interface RecordFilterCondition {
+    field: string;
+    op: RecordFilterOperator;
+    value?: unknown;
+}
+interface RecordFilterGroup {
+    op: 'and' | 'or';
+    conditions: Array<RecordFilterCondition | RecordFilterGroup>;
+}
+interface RecordFilter {
+    type: string;
+    where?: RecordFilterCondition | RecordFilterGroup;
+}
 interface RetrieveRecordStepConfig$1 {
     name: string;
     recordType?: string;
     recordName?: string;
+    /**
+     * Optional chip-style filter (metadata + top-level columns: id, name,
+     * createdAt, updatedAt). Coexists with recordType/recordName for
+     * backward compatibility; the API executor prefers recordFilter when
+     * both are set.
+     */
+    recordFilter?: RecordFilter;
     fieldsToInclude?: string[];
     fieldsToExclude?: string[];
     outputVariable?: string;
@@ -2007,10 +2033,13 @@ interface SendStreamStepConfig {
     message: string;
     enabled?: boolean;
 }
+
 interface RetrieveRecordStepConfig {
     name: string;
     recordType?: string;
     recordName?: string;
+    /** Chip-style filter (metadata + top-level columns). See flow-builder.ts. */
+    recordFilter?: RecordFilter;
     fieldsToInclude?: string[];
     fieldsToExclude?: string[];
     outputVariable?: string;
@@ -5692,6 +5721,63 @@ declare class ClientEvalBuilder extends EvalBuilder {
     run(): Promise<EvalResult>;
 }
 
+/**
+ * SDK Code Generation Metadata
+ *
+ * Type-safe field registry for generating SDK code from flow step configs.
+ * Co-located with the step config interfaces so that adding or removing a
+ * field on any config interface produces a compile error here, preventing
+ * silent drift between the SDK and downstream code generators (e.g. the
+ * dashboard's sdk-code-generator.ts).
+ */
+
+/** How to serialize a field value into TypeScript source code. */
+type FieldFormat = 'json' | 'template' | 'raw' | 'value';
+/** Describes one field in a step config for code emission. */
+interface StepFieldMeta {
+    /** Field key in the SDK config interface (emitted as the property name). */
+    key: string;
+    /** Serialization format. */
+    format: FieldFormat;
+    /**
+     * Dot-path to read the value from the internal step config when it differs
+     * from `key` (e.g. `'http.url'` for fetch-url).
+     */
+    source?: string;
+    /** Skip emission when the runtime value strictly equals this. */
+    skipDefault?: unknown;
+    /** Only emit when the value is truthy ('truthy') or falsy ('falsy'). */
+    emitWhen?: 'truthy' | 'falsy';
+    /**
+     * Dot-path to a nested field that must be truthy for this field to emit.
+     * Example: `'poll.enabled'` — emit the `poll` object only when `poll.enabled` is true.
+     */
+    sourceCheck?: string;
+}
+/**
+ * Maps step types to their field metadata arrays. Used by code generators to
+ * iterate fields generically instead of maintaining per-step switch blocks.
+ *
+ * Step types with typed SDK config interfaces get compile-time checked entries.
+ * Step types without interfaces (template, store-asset, generate-pdf) have
+ * untyped field arrays matching the old switch-block behavior.
+ *
+ * Step types without typed interfaces or old switch-cases (tool-call,
+ * paginate-api, store-vector, execute-agent) get a minimal entry with
+ * just outputVariable and errorHandling (the common fields the old code
+ * emitted for all step types).
+ *
+ * `api-call` shares fields with `fetch-url`; `update-record` shares with
+ * `upsert-record`.
+ */
+declare const STEP_FIELD_REGISTRY: Record<string, readonly StepFieldMeta[]>;
+/**
+ * Maps every step type to its FlowBuilder method name. Covers all known step
+ * types including those without typed config interfaces. Code generators use
+ * this instead of maintaining their own mapping.
+ */
+declare const STEP_TYPE_TO_METHOD: Record<string, string>;
+
 /**
  * Default marathon workflow: research → planning → execution.
  *
@@ -5760,4 +5846,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions$2 as UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };
+export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions$2 as UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };

package/dist/index.d.ts

@@ -1077,10 +1077,36 @@ interface SendStreamStepConfig$1 {
     /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
     when?: string;
 }
+/**
+ * Operator allowlist for chip-style record filters. Mirrors the API's
+ * `record-filter-compiler.ts`. Kept inline here to avoid a hard dependency
+ * on `@runtypelabs/shared` from the published SDK.
+ */
+type RecordFilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'notIn' | 'isSet' | 'isNotSet' | 'isTrue' | 'isFalse' | 'withinLastDays' | 'olderThanDays';
+interface RecordFilterCondition {
+    field: string;
+    op: RecordFilterOperator;
+    value?: unknown;
+}
+interface RecordFilterGroup {
+    op: 'and' | 'or';
+    conditions: Array<RecordFilterCondition | RecordFilterGroup>;
+}
+interface RecordFilter {
+    type: string;
+    where?: RecordFilterCondition | RecordFilterGroup;
+}
 interface RetrieveRecordStepConfig$1 {
     name: string;
     recordType?: string;
     recordName?: string;
+    /**
+     * Optional chip-style filter (metadata + top-level columns: id, name,
+     * createdAt, updatedAt). Coexists with recordType/recordName for
+     * backward compatibility; the API executor prefers recordFilter when
+     * both are set.
+     */
+    recordFilter?: RecordFilter;
     fieldsToInclude?: string[];
     fieldsToExclude?: string[];
     outputVariable?: string;
@@ -2007,10 +2033,13 @@ interface SendStreamStepConfig {
     message: string;
     enabled?: boolean;
 }
+
 interface RetrieveRecordStepConfig {
     name: string;
     recordType?: string;
     recordName?: string;
+    /** Chip-style filter (metadata + top-level columns). See flow-builder.ts. */
+    recordFilter?: RecordFilter;
     fieldsToInclude?: string[];
     fieldsToExclude?: string[];
     outputVariable?: string;
@@ -5692,6 +5721,63 @@ declare class ClientEvalBuilder extends EvalBuilder {
     run(): Promise<EvalResult>;
 }
 
+/**
+ * SDK Code Generation Metadata
+ *
+ * Type-safe field registry for generating SDK code from flow step configs.
+ * Co-located with the step config interfaces so that adding or removing a
+ * field on any config interface produces a compile error here, preventing
+ * silent drift between the SDK and downstream code generators (e.g. the
+ * dashboard's sdk-code-generator.ts).
+ */
+
+/** How to serialize a field value into TypeScript source code. */
+type FieldFormat = 'json' | 'template' | 'raw' | 'value';
+/** Describes one field in a step config for code emission. */
+interface StepFieldMeta {
+    /** Field key in the SDK config interface (emitted as the property name). */
+    key: string;
+    /** Serialization format. */
+    format: FieldFormat;
+    /**
+     * Dot-path to read the value from the internal step config when it differs
+     * from `key` (e.g. `'http.url'` for fetch-url).
+     */
+    source?: string;
+    /** Skip emission when the runtime value strictly equals this. */
+    skipDefault?: unknown;
+    /** Only emit when the value is truthy ('truthy') or falsy ('falsy'). */
+    emitWhen?: 'truthy' | 'falsy';
+    /**
+     * Dot-path to a nested field that must be truthy for this field to emit.
+     * Example: `'poll.enabled'` — emit the `poll` object only when `poll.enabled` is true.
+     */
+    sourceCheck?: string;
+}
+/**
+ * Maps step types to their field metadata arrays. Used by code generators to
+ * iterate fields generically instead of maintaining per-step switch blocks.
+ *
+ * Step types with typed SDK config interfaces get compile-time checked entries.
+ * Step types without interfaces (template, store-asset, generate-pdf) have
+ * untyped field arrays matching the old switch-block behavior.
+ *
+ * Step types without typed interfaces or old switch-cases (tool-call,
+ * paginate-api, store-vector, execute-agent) get a minimal entry with
+ * just outputVariable and errorHandling (the common fields the old code
+ * emitted for all step types).
+ *
+ * `api-call` shares fields with `fetch-url`; `update-record` shares with
+ * `upsert-record`.
+ */
+declare const STEP_FIELD_REGISTRY: Record<string, readonly StepFieldMeta[]>;
+/**
+ * Maps every step type to its FlowBuilder method name. Covers all known step
+ * types including those without typed config interfaces. Code generators use
+ * this instead of maintaining their own mapping.
+ */
+declare const STEP_TYPE_TO_METHOD: Record<string, string>;
+
 /**
  * Default marathon workflow: research → planning → execution.
  *
@@ -5760,4 +5846,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions$2 as UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };
+export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions$2 as UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };

package/dist/index.mjs

@@ -8335,6 +8335,255 @@ var ClientEvalBuilder = class extends EvalBuilder {
     return this.boundClient.eval(config);
   }
 };
+
+// src/codegen-metadata.ts
+var PROMPT_FIELDS = [
+  { key: "model", format: "json" },
+  { key: "userPrompt", format: "template" },
+  { key: "systemPrompt", format: "template" },
+  { key: "previousMessages", format: "value" },
+  { key: "outputVariable", format: "json" },
+  { key: "responseFormat", format: "json", skipDefault: "text" },
+  { key: "temperature", format: "raw" },
+  { key: "topP", format: "raw" },
+  { key: "topK", format: "raw" },
+  { key: "frequencyPenalty", format: "raw" },
+  { key: "presencePenalty", format: "raw" },
+  { key: "seed", format: "raw" },
+  { key: "maxTokens", format: "raw" },
+  { key: "reasoning", format: "value" },
+  { key: "streamOutput", format: "raw", emitWhen: "falsy" },
+  { key: "tools", format: "value" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var CRAWL_FIELDS = [
+  { key: "url", format: "json" },
+  { key: "limit", format: "raw" },
+  { key: "depth", format: "raw" },
+  { key: "source", format: "json" },
+  { key: "formats", format: "value" },
+  { key: "render", format: "raw" },
+  { key: "maxAge", format: "raw" },
+  { key: "modifiedSince", format: "json" },
+  { key: "options", format: "value" },
+  { key: "authenticate", format: "value" },
+  { key: "cookies", format: "value" },
+  { key: "setExtraHTTPHeaders", format: "value" },
+  { key: "gotoOptions", format: "value" },
+  { key: "waitForSelector", format: "json" },
+  { key: "rejectResourceTypes", format: "value" },
+  { key: "rejectRequestPattern", format: "value" },
+  { key: "userAgent", format: "json" },
+  { key: "jsonOptions", format: "value" },
+  { key: "pollIntervalMs", format: "raw" },
+  { key: "completionTimeoutMs", format: "raw" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var FETCH_URL_FIELDS = [
+  { key: "url", format: "json", source: "http.url" },
+  { key: "method", format: "json", source: "http.method", skipDefault: "GET" },
+  { key: "headers", format: "value", source: "http.headers" },
+  { key: "body", format: "template", source: "http.body" },
+  { key: "responseType", format: "json" },
+  { key: "markdownIfAvailable", format: "raw" },
+  { key: "fetchMethod", format: "json", skipDefault: "http" },
+  { key: "firecrawl", format: "value" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var TRANSFORM_DATA_FIELDS = [
+  { key: "script", format: "template" },
+  { key: "outputVariable", format: "json" },
+  { key: "sandboxProvider", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var SET_VARIABLE_FIELDS = [
+  { key: "variableName", format: "json" },
+  { key: "value", format: "template" }
+];
+var CONDITIONAL_FIELDS = [
+  { key: "condition", format: "template" },
+  { key: "trueSteps", format: "value" },
+  { key: "falseSteps", format: "value" }
+];
+var SEARCH_FIELDS = [
+  { key: "provider", format: "json" },
+  { key: "query", format: "template" },
+  { key: "maxResults", format: "raw", skipDefault: 10 },
+  { key: "returnCitations", format: "raw" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var SEND_EMAIL_FIELDS = [
+  { key: "to", format: "json" },
+  { key: "from", format: "json" },
+  { key: "subject", format: "template" },
+  { key: "html", format: "template" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var SEND_STREAM_FIELDS = [
+  { key: "message", format: "template" }
+];
+var RETRIEVE_RECORD_FIELDS = [
+  { key: "recordType", format: "json" },
+  { key: "recordName", format: "json" },
+  { key: "recordFilter", format: "value" },
+  { key: "fieldsToInclude", format: "json" },
+  { key: "fieldsToExclude", format: "json" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var UPSERT_RECORD_FIELDS = [
+  { key: "recordType", format: "json" },
+  { key: "recordName", format: "json" },
+  { key: "sourceVariable", format: "json" },
+  { key: "mergeStrategy", format: "json", skipDefault: "merge" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var VECTOR_SEARCH_FIELDS = [
+  { key: "query", format: "template" },
+  { key: "recordType", format: "json" },
+  { key: "embeddingModel", format: "json" },
+  { key: "limit", format: "raw", skipDefault: 5 },
+  { key: "threshold", format: "raw", skipDefault: 0.7 },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var GENERATE_EMBEDDING_FIELDS = [
+  { key: "text", format: "template" },
+  { key: "embeddingModel", format: "json" },
+  { key: "maxLength", format: "raw" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var WAIT_UNTIL_FIELDS = [
+  { key: "delayMs", format: "raw" },
+  { key: "continueOnTimeout", format: "raw", emitWhen: "truthy" },
+  { key: "poll", format: "value", sourceCheck: "poll.enabled" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var SEND_EVENT_FIELDS = [
+  { key: "provider", format: "json" },
+  { key: "eventName", format: "json" },
+  { key: "properties", format: "value" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var SEND_TEXT_FIELDS = [
+  { key: "to", format: "json" },
+  { key: "from", format: "json" },
+  { key: "message", format: "template" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var FETCH_GITHUB_FIELDS = [
+  { key: "repository", format: "json" },
+  { key: "branch", format: "json" },
+  { key: "path", format: "json" },
+  { key: "outputVariable", format: "json" },
+  { key: "streamOutput", format: "raw" }
+];
+var TEMPLATE_FIELDS = [
+  { key: "template", format: "template" },
+  { key: "outputFormat", format: "json" },
+  { key: "inputs", format: "value" },
+  { key: "partials", format: "value" },
+  { key: "pdfOptions", format: "value" },
+  { key: "asArtifact", format: "raw" },
+  { key: "streamOutput", format: "raw" },
+  { key: "outputVariable", format: "json" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var STORE_ASSET_FIELDS = [
+  { key: "url", format: "json" },
+  { key: "content", format: "template" },
+  { key: "filename", format: "json" },
+  { key: "contentType", format: "json" },
+  { key: "visibility", format: "json" },
+  { key: "outputVariable", format: "json" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var GENERATE_PDF_FIELDS = [
+  { key: "html", format: "template" },
+  { key: "markdown", format: "template" },
+  { key: "filename", format: "json" },
+  { key: "visibility", format: "json" },
+  { key: "pdfOptions", format: "value" },
+  { key: "outputVariable", format: "json" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var COMMON_ONLY_FIELDS = [
+  { key: "outputVariable", format: "json" },
+  { key: "errorHandling", format: "value", skipDefault: "fail" }
+];
+var STEP_FIELD_REGISTRY = {
+  "prompt": PROMPT_FIELDS,
+  "crawl": CRAWL_FIELDS,
+  "fetch-url": FETCH_URL_FIELDS,
+  "api-call": FETCH_URL_FIELDS,
+  "transform-data": TRANSFORM_DATA_FIELDS,
+  "set-variable": SET_VARIABLE_FIELDS,
+  "conditional": CONDITIONAL_FIELDS,
+  "search": SEARCH_FIELDS,
+  "send-email": SEND_EMAIL_FIELDS,
+  "send-stream": SEND_STREAM_FIELDS,
+  "retrieve-record": RETRIEVE_RECORD_FIELDS,
+  "upsert-record": UPSERT_RECORD_FIELDS,
+  "update-record": UPSERT_RECORD_FIELDS,
+  "vector-search": VECTOR_SEARCH_FIELDS,
+  "generate-embedding": GENERATE_EMBEDDING_FIELDS,
+  "wait-until": WAIT_UNTIL_FIELDS,
+  "send-event": SEND_EVENT_FIELDS,
+  "send-text": SEND_TEXT_FIELDS,
+  "fetch-github": FETCH_GITHUB_FIELDS,
+  "template": TEMPLATE_FIELDS,
+  "store-asset": STORE_ASSET_FIELDS,
+  "generate-pdf": GENERATE_PDF_FIELDS,
+  "tool-call": COMMON_ONLY_FIELDS,
+  "paginate-api": COMMON_ONLY_FIELDS,
+  "store-vector": COMMON_ONLY_FIELDS,
+  "execute-agent": COMMON_ONLY_FIELDS
+};
+var STEP_TYPE_TO_METHOD = {
+  "prompt": "prompt",
+  "crawl": "crawl",
+  "fetch-url": "fetchUrl",
+  "api-call": "apiCall",
+  "retrieve-record": "retrieveRecord",
+  "fetch-github": "fetchGitHub",
+  "transform-data": "transformData",
+  "template": "template",
+  "conditional": "conditional",
+  "set-variable": "setVariable",
+  "upsert-record": "upsertRecord",
+  "update-record": "updateRecord",
+  "send-email": "sendEmail",
+  "send-text": "sendText",
+  "send-event": "sendEvent",
+  "send-stream": "sendStream",
+  "search": "search",
+  "generate-embedding": "generateEmbedding",
+  "vector-search": "vectorSearch",
+  "tool-call": "toolCall",
+  "wait-until": "waitUntil",
+  "paginate-api": "paginateApi",
+  "store-vector": "storeVector",
+  "execute-agent": "executeAgent",
+  "store-asset": "storeAsset",
+  "generate-pdf": "generatePdf"
+};
 export {
   AgentsEndpoint,
   AnalyticsEndpoint,
@@ -8366,6 +8615,8 @@ export {
   RuntypeApiError,
   RuntypeClient2 as RuntypeClient,
   RuntypeFlowBuilder,
+  STEP_FIELD_REGISTRY,
+  STEP_TYPE_TO_METHOD,
   ToolsEndpoint,
   UsersEndpoint,
   applyGeneratedRuntimeToolProposalToDispatchRequest,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "1.19.1",
+  "version": "1.21.0",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",