@prompd/core 0.5.3 → 0.5.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +221 -127
- package/dist/index.cjs +820 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +46 -1
- package/dist/index.d.ts +46 -1
- package/dist/index.js +812 -1
- package/dist/index.js.map +1 -1
- package/package.json +3 -2
package/dist/index.d.cts
CHANGED
|
@@ -3140,4 +3140,49 @@ declare function traceForkBranches(file: WorkflowFile, parallelId: string): Bran
|
|
|
3140
3140
|
/** The node a fork-mode parallel's branches rejoin at (target of an `input-*` edge). */
|
|
3141
3141
|
declare function forkJoinId(file: WorkflowFile, parallelId: string): string | undefined;
|
|
3142
3142
|
|
|
3143
|
-
|
|
3143
|
+
declare class ExpressionError extends Error {
|
|
3144
|
+
readonly construct: string;
|
|
3145
|
+
readonly position: number;
|
|
3146
|
+
constructor(message: string, construct: string, position: number);
|
|
3147
|
+
}
|
|
3148
|
+
/** True for an ExpressionError this module built (the WeakSet brand, no trap
|
|
3149
|
+
* runs) or a structural look-alike whose OWN DATA fields are well formed
|
|
3150
|
+
* (`name === 'ExpressionError'`, string `construct`, number `position`) — e.g.
|
|
3151
|
+
* one built by another copy of @prompd/core. Never uses `instanceof`, never
|
|
3152
|
+
* invokes a getter, and never throws: a Proxy whose traps throw is simply
|
|
3153
|
+
* not an ExpressionError. */
|
|
3154
|
+
declare function isExpressionError(e: unknown): e is ExpressionError;
|
|
3155
|
+
declare const MAX_EXPRESSION_LENGTH = 2000;
|
|
3156
|
+
declare const MAX_EXPRESSION_DEPTH = 64;
|
|
3157
|
+
/** The message a workflow node fails with. Takes anything: a well-formed
|
|
3158
|
+
* ExpressionError (per `isExpressionError`'s own-data read) names the
|
|
3159
|
+
* rejected construct and position; anything else gets
|
|
3160
|
+
* `<kind> on "<label>" has an invalid expression: <own string message, or
|
|
3161
|
+
* 'unknown error'>.` Never throws. */
|
|
3162
|
+
declare function describeExpressionFailure(kind: string, label: string, e: unknown): string;
|
|
3163
|
+
declare function validateExpression(expr: string): ExpressionError | null;
|
|
3164
|
+
/** Options threaded through evaluation. `parseJsonStrings` is opt-in (default
|
|
3165
|
+
* off) and only changes how a NAMED member access reads through a string: see
|
|
3166
|
+
* `readJsonStringMember`. */
|
|
3167
|
+
interface ExpressionEvalOptions {
|
|
3168
|
+
parseJsonStrings?: boolean;
|
|
3169
|
+
}
|
|
3170
|
+
/** The longest string `parseJsonStrings` navigation will attempt to parse as
|
|
3171
|
+
* JSON. Without this, a multi-megabyte string with an opening ``` fence and
|
|
3172
|
+
* no closing one is still linear to scan (see `stripCodeFence`), but
|
|
3173
|
+
* `JSON.parse` itself on an arbitrarily large host-supplied string is
|
|
3174
|
+
* unbounded work we'd rather refuse than pay for on every navigation. A
|
|
3175
|
+
* string longer than this reads as undefined, exactly like invalid JSON. */
|
|
3176
|
+
declare const MAX_JSON_NAV_LENGTH = 1000000;
|
|
3177
|
+
/** The most indices any array method below will visit. JSON-shaped data is
|
|
3178
|
+
* dense, so a longer array is almost certainly a host-built sparse one
|
|
3179
|
+
* (`a.length = 1e9`) that would otherwise pin the thread in a scan. */
|
|
3180
|
+
declare const MAX_ARRAY_SCAN = 1000000;
|
|
3181
|
+
/** Evaluate an author-written workflow expression against a data scope.
|
|
3182
|
+
* Strips one surrounding {{ … }}. Throws ExpressionError when the text is not
|
|
3183
|
+
* in the language. Never executes the text as code.
|
|
3184
|
+
* `options.parseJsonStrings` (default off) lets a named member access parse a
|
|
3185
|
+
* string value as JSON - see `readOwnMember`'s doc comment. */
|
|
3186
|
+
declare function evaluateExpression(expr: string, scope: Record<string, unknown>, options?: ExpressionEvalOptions): unknown;
|
|
3187
|
+
|
|
3188
|
+
export { type AgentCheckpointEvent, type AgentCheckpointEventType, type AgentIterationRecord, type AgentNodeData, type AgentTool, AnthropicFormatter, type ApiNodeData, type AsyncFileBackend, BUILTIN_COMMAND_EXECUTABLES, type BaseNodeData, type BranchMergeStrategy, type BranchResult, type BranchRunner, type BranchSpec, type BranchStatus, type BranchWaitFor, CODE_EXTENSIONS, CONTENT_TYPES, type CallbackNodeData, type ChatAgentCheckpointConfig, type ChatAgentNodeData, type ClaudeCodeNodeData, CodeGenerationStage, type CodeNodeData, type CommandNodeData, CompilationContext, type CompilationDiagnostic, CompilationError, type CompilationOptions, CompilationStage, type CompiledPrompt, CompilerPipeline, type CompilerStage, type CompleteEventData, type ConditionBranch, type ConditionNodeData, type Config, type CustomCommandConfig, type CustomConnectionConfig, type CustomProvider, DEFAULT_MAX_CONCURRENCY, DEFAULT_SECURITY_CONFIG, DOCKABLE_HANDLES, DOCKABLE_NODE_TYPES, type DatabaseConnectionConfig, type DatabaseQueryNodeData, DependencyResolutionStage, EXTENSION_TO_LANGUAGE, EXTENSION_TO_LANGUAGE_ALIASES, type ErrorEventData, type ErrorHandlerNodeData, type ErrorHandlingConfig, type ExecuteOptions, type ExecutionConfig, ExpressionError, type ExpressionEvalOptions, type GitHubConnectionConfig, type GuardrailNodeData, type HttpApiConnectionConfig, HybridFileSystem, type IFileSystem, type IPackageResolver, type InstallPackageOptions, type InstalledPackage, type IterationEventData, type JsonSchema, type LLMResponse, LexicalAnalysisStage, type LoopNodeData, MAX_ARRAY_SCAN, MAX_EXPRESSION_DEPTH, MAX_EXPRESSION_LENGTH, MAX_JSON_NAV_LENGTH, MEMORY_OPERATIONS_BY_MODE, MarkdownFormatter, type McpServerConnectionConfig, type McpToolNodeData, MemoryFileSystem, type MemoryNodeData, type MemoryOperation, MemoryPackageResolver, type MergeNodeData, type NodeExecutionState, type NodeExecutionStatus, OpenAIFormatter, type OutputFormatter, type OutputNodeData, PACKAGE_TYPE_DIRS, PROMPD_EXTENSIONS, type PackageAlias, type PackageDownloader, type PackageStore, type PackageType, type ParallelBranch, type ParallelNodeData, ParseError, type ParsedWorkflow, PrompdCompiler, PrompdError, type PrompdFile, PrompdLoader, type PrompdMetadata, type PrompdParameter, PrompdParser, type PromptNodeData, type ProviderConfig, type ProviderNodeData, type RegistryConfig, type ResolvePackageOptions, type ResolvedPackage, type RetryPolicy, type RunBranchesOptions, type RunBranchesOutcome, type SSHConnectionConfig, type SectionInfo, SectionOverrideProcessor, type SecurityConfig, SecurityError, SemanticAnalysisStage, type SlackConnectionConfig, TOOL_DEPLOY_DIRS, TemplateProcessingStage, type ThinkingEventData, type ToolCallEventData, type ToolCallParserNodeData, type ToolCallRouterNodeData, type ToolDeployHook, type ToolNodeData, type TransformerNodeData, type TriggerNodeData, type UninstallPackageOptions, type UninstalledPackage, type UserInputNodeData, type UsingPackage, VALID_PACKAGE_TYPES, ValidationError, type ValidationIssue, type ValidationResult, type WebSearchNodeData, type WebSocketConnectionConfig, type WorkflowConnection, type WorkflowConnectionConfig, type WorkflowConnectionStatus, type WorkflowConnectionType, type WorkflowEdge, type WorkflowExecutionError, type WorkflowExecutionState, type WorkflowExecutionStatus, type WorkflowFile, type WorkflowMetadata, type WorkflowNode, type WorkflowNodeData, type WorkflowNodeType, type WorkflowParameter, type WorkflowResult, type WorkflowValidationError, type WorkflowValidationWarning, type WorkflowVariable, basenamePosix, compile, createCoreStages, createEmptyWorkflow, createPrompdEnvironment, createWorkflowNode, describeExpressionFailure, dirnamePosix, evaluateExpression, extname, extractPdpkg, forkJoinId, getContentType, getExecutionOrder, getInstallDirForType, getLanguageAliasesForExtension, getLanguageForExtension, installPackage, isAbsolutePosix, isExpressionError, isPrompdFile, isValidPackageReference, isValidPackageType, joinPosix, mergeBranchResults, needsFrontmatterProtection, normalizePosix, parsePackageReference, parsePackageReferenceWithPath, parseWorkflow, resolvePackageFile, resolvePosix, runBranches, serializeWorkflow, stripFilePath, traceForkBranches, uninstallPackage, validateExpression, validateWorkflow, validateWorkflowQuick };
|
package/dist/index.d.ts
CHANGED
|
@@ -3140,4 +3140,49 @@ declare function traceForkBranches(file: WorkflowFile, parallelId: string): Bran
|
|
|
3140
3140
|
/** The node a fork-mode parallel's branches rejoin at (target of an `input-*` edge). */
|
|
3141
3141
|
declare function forkJoinId(file: WorkflowFile, parallelId: string): string | undefined;
|
|
3142
3142
|
|
|
3143
|
-
|
|
3143
|
+
declare class ExpressionError extends Error {
|
|
3144
|
+
readonly construct: string;
|
|
3145
|
+
readonly position: number;
|
|
3146
|
+
constructor(message: string, construct: string, position: number);
|
|
3147
|
+
}
|
|
3148
|
+
/** True for an ExpressionError this module built (the WeakSet brand, no trap
|
|
3149
|
+
* runs) or a structural look-alike whose OWN DATA fields are well formed
|
|
3150
|
+
* (`name === 'ExpressionError'`, string `construct`, number `position`) — e.g.
|
|
3151
|
+
* one built by another copy of @prompd/core. Never uses `instanceof`, never
|
|
3152
|
+
* invokes a getter, and never throws: a Proxy whose traps throw is simply
|
|
3153
|
+
* not an ExpressionError. */
|
|
3154
|
+
declare function isExpressionError(e: unknown): e is ExpressionError;
|
|
3155
|
+
declare const MAX_EXPRESSION_LENGTH = 2000;
|
|
3156
|
+
declare const MAX_EXPRESSION_DEPTH = 64;
|
|
3157
|
+
/** The message a workflow node fails with. Takes anything: a well-formed
|
|
3158
|
+
* ExpressionError (per `isExpressionError`'s own-data read) names the
|
|
3159
|
+
* rejected construct and position; anything else gets
|
|
3160
|
+
* `<kind> on "<label>" has an invalid expression: <own string message, or
|
|
3161
|
+
* 'unknown error'>.` Never throws. */
|
|
3162
|
+
declare function describeExpressionFailure(kind: string, label: string, e: unknown): string;
|
|
3163
|
+
declare function validateExpression(expr: string): ExpressionError | null;
|
|
3164
|
+
/** Options threaded through evaluation. `parseJsonStrings` is opt-in (default
|
|
3165
|
+
* off) and only changes how a NAMED member access reads through a string: see
|
|
3166
|
+
* `readJsonStringMember`. */
|
|
3167
|
+
interface ExpressionEvalOptions {
|
|
3168
|
+
parseJsonStrings?: boolean;
|
|
3169
|
+
}
|
|
3170
|
+
/** The longest string `parseJsonStrings` navigation will attempt to parse as
|
|
3171
|
+
* JSON. Without this, a multi-megabyte string with an opening ``` fence and
|
|
3172
|
+
* no closing one is still linear to scan (see `stripCodeFence`), but
|
|
3173
|
+
* `JSON.parse` itself on an arbitrarily large host-supplied string is
|
|
3174
|
+
* unbounded work we'd rather refuse than pay for on every navigation. A
|
|
3175
|
+
* string longer than this reads as undefined, exactly like invalid JSON. */
|
|
3176
|
+
declare const MAX_JSON_NAV_LENGTH = 1000000;
|
|
3177
|
+
/** The most indices any array method below will visit. JSON-shaped data is
|
|
3178
|
+
* dense, so a longer array is almost certainly a host-built sparse one
|
|
3179
|
+
* (`a.length = 1e9`) that would otherwise pin the thread in a scan. */
|
|
3180
|
+
declare const MAX_ARRAY_SCAN = 1000000;
|
|
3181
|
+
/** Evaluate an author-written workflow expression against a data scope.
|
|
3182
|
+
* Strips one surrounding {{ … }}. Throws ExpressionError when the text is not
|
|
3183
|
+
* in the language. Never executes the text as code.
|
|
3184
|
+
* `options.parseJsonStrings` (default off) lets a named member access parse a
|
|
3185
|
+
* string value as JSON - see `readOwnMember`'s doc comment. */
|
|
3186
|
+
declare function evaluateExpression(expr: string, scope: Record<string, unknown>, options?: ExpressionEvalOptions): unknown;
|
|
3187
|
+
|
|
3188
|
+
export { type AgentCheckpointEvent, type AgentCheckpointEventType, type AgentIterationRecord, type AgentNodeData, type AgentTool, AnthropicFormatter, type ApiNodeData, type AsyncFileBackend, BUILTIN_COMMAND_EXECUTABLES, type BaseNodeData, type BranchMergeStrategy, type BranchResult, type BranchRunner, type BranchSpec, type BranchStatus, type BranchWaitFor, CODE_EXTENSIONS, CONTENT_TYPES, type CallbackNodeData, type ChatAgentCheckpointConfig, type ChatAgentNodeData, type ClaudeCodeNodeData, CodeGenerationStage, type CodeNodeData, type CommandNodeData, CompilationContext, type CompilationDiagnostic, CompilationError, type CompilationOptions, CompilationStage, type CompiledPrompt, CompilerPipeline, type CompilerStage, type CompleteEventData, type ConditionBranch, type ConditionNodeData, type Config, type CustomCommandConfig, type CustomConnectionConfig, type CustomProvider, DEFAULT_MAX_CONCURRENCY, DEFAULT_SECURITY_CONFIG, DOCKABLE_HANDLES, DOCKABLE_NODE_TYPES, type DatabaseConnectionConfig, type DatabaseQueryNodeData, DependencyResolutionStage, EXTENSION_TO_LANGUAGE, EXTENSION_TO_LANGUAGE_ALIASES, type ErrorEventData, type ErrorHandlerNodeData, type ErrorHandlingConfig, type ExecuteOptions, type ExecutionConfig, ExpressionError, type ExpressionEvalOptions, type GitHubConnectionConfig, type GuardrailNodeData, type HttpApiConnectionConfig, HybridFileSystem, type IFileSystem, type IPackageResolver, type InstallPackageOptions, type InstalledPackage, type IterationEventData, type JsonSchema, type LLMResponse, LexicalAnalysisStage, type LoopNodeData, MAX_ARRAY_SCAN, MAX_EXPRESSION_DEPTH, MAX_EXPRESSION_LENGTH, MAX_JSON_NAV_LENGTH, MEMORY_OPERATIONS_BY_MODE, MarkdownFormatter, type McpServerConnectionConfig, type McpToolNodeData, MemoryFileSystem, type MemoryNodeData, type MemoryOperation, MemoryPackageResolver, type MergeNodeData, type NodeExecutionState, type NodeExecutionStatus, OpenAIFormatter, type OutputFormatter, type OutputNodeData, PACKAGE_TYPE_DIRS, PROMPD_EXTENSIONS, type PackageAlias, type PackageDownloader, type PackageStore, type PackageType, type ParallelBranch, type ParallelNodeData, ParseError, type ParsedWorkflow, PrompdCompiler, PrompdError, type PrompdFile, PrompdLoader, type PrompdMetadata, type PrompdParameter, PrompdParser, type PromptNodeData, type ProviderConfig, type ProviderNodeData, type RegistryConfig, type ResolvePackageOptions, type ResolvedPackage, type RetryPolicy, type RunBranchesOptions, type RunBranchesOutcome, type SSHConnectionConfig, type SectionInfo, SectionOverrideProcessor, type SecurityConfig, SecurityError, SemanticAnalysisStage, type SlackConnectionConfig, TOOL_DEPLOY_DIRS, TemplateProcessingStage, type ThinkingEventData, type ToolCallEventData, type ToolCallParserNodeData, type ToolCallRouterNodeData, type ToolDeployHook, type ToolNodeData, type TransformerNodeData, type TriggerNodeData, type UninstallPackageOptions, type UninstalledPackage, type UserInputNodeData, type UsingPackage, VALID_PACKAGE_TYPES, ValidationError, type ValidationIssue, type ValidationResult, type WebSearchNodeData, type WebSocketConnectionConfig, type WorkflowConnection, type WorkflowConnectionConfig, type WorkflowConnectionStatus, type WorkflowConnectionType, type WorkflowEdge, type WorkflowExecutionError, type WorkflowExecutionState, type WorkflowExecutionStatus, type WorkflowFile, type WorkflowMetadata, type WorkflowNode, type WorkflowNodeData, type WorkflowNodeType, type WorkflowParameter, type WorkflowResult, type WorkflowValidationError, type WorkflowValidationWarning, type WorkflowVariable, basenamePosix, compile, createCoreStages, createEmptyWorkflow, createPrompdEnvironment, createWorkflowNode, describeExpressionFailure, dirnamePosix, evaluateExpression, extname, extractPdpkg, forkJoinId, getContentType, getExecutionOrder, getInstallDirForType, getLanguageAliasesForExtension, getLanguageForExtension, installPackage, isAbsolutePosix, isExpressionError, isPrompdFile, isValidPackageReference, isValidPackageType, joinPosix, mergeBranchResults, needsFrontmatterProtection, normalizePosix, parsePackageReference, parsePackageReferenceWithPath, parseWorkflow, resolvePackageFile, resolvePosix, runBranches, serializeWorkflow, stripFilePath, traceForkBranches, uninstallPackage, validateExpression, validateWorkflow, validateWorkflowQuick };
|