@polka-codes/core 0.10.11 → 0.10.16

package/dist/workflow/dynamic-types.js

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+export const WorkflowInputDefinitionSchema = z.object({
+    id: z.string(),
+    description: z.string().nullish(),
+    default: z.unknown().nullish(),
+});
+/**
+ * Basic workflow step - executes a task
+ */
+export const WorkflowStepDefinitionSchema = z.object({
+    id: z.string(),
+    tools: z.array(z.string()).nullish(),
+    task: z.string(),
+    output: z.string().nullish(),
+    expected_outcome: z.string().nullish(),
+    /**
+     * Optional JSON schema or other metadata for future structured outputs.
+     * Not interpreted by core today.
+     */
+    outputSchema: z.unknown().nullish(),
+    /**
+     * Optional timeout in milliseconds. Step execution will be aborted if it exceeds this duration.
+     */
+    timeout: z.number().positive().nullish(),
+});
+/**
+ * Control flow step types
+ */
+/**
+ * While loop - repeats steps while condition is true
+ */
+// Type annotation required due to circular reference via z.lazy()
+// The 'as unknown as' cast breaks the circular type inference dependency
+export const WhileLoopStepSchema = z.object({
+    id: z.string(),
+    while: z.object({
+        condition: z.string().describe('JavaScript expression that evaluates to true/false'),
+        steps: z.array(z.lazy(() => WorkflowControlFlowStepSchema)),
+    }),
+    output: z.string().nullish(),
+});
+/**
+ * If/else branch - conditionally executes steps
+ */
+// Type annotation required due to circular reference via z.lazy()
+// The 'as unknown as' cast breaks the circular type inference dependency
+export const IfElseStepSchema = z.object({
+    id: z.string(),
+    if: z.object({
+        condition: z.string().describe('JavaScript expression that evaluates to true/false'),
+        thenBranch: z.array(z.lazy(() => WorkflowControlFlowStepSchema)),
+        elseBranch: z.array(z.lazy(() => WorkflowControlFlowStepSchema)).optional(),
+    }),
+    output: z.string().nullish(),
+});
+/**
+ * Break statement - exits the nearest enclosing loop
+ */
+export const BreakStepSchema = z.object({
+    break: z.literal(true),
+});
+/**
+ * Continue statement - skips to next iteration of nearest enclosing loop
+ */
+export const ContinueStepSchema = z.object({
+    continue: z.literal(true),
+});
+/**
+ * Try/catch block - error handling
+ */
+export const TryCatchStepSchema = z.object({
+    id: z.string(),
+    try: z.object({
+        trySteps: z.array(z.lazy(() => WorkflowControlFlowStepSchema)),
+        catchSteps: z.array(z.lazy(() => WorkflowControlFlowStepSchema)),
+    }),
+    output: z.string().nullish(),
+});
+/**
+ * Any step that can appear in a workflow's steps array
+ * Can be a basic step, control flow, or jump statement
+ */
+// Type annotation required due to circular reference via z.lazy() in other schemas
+// The 'as unknown as' cast breaks the circular type inference dependency
+export const WorkflowControlFlowStepSchema = z.union([
+    WorkflowStepDefinitionSchema,
+    WhileLoopStepSchema,
+    IfElseStepSchema,
+    BreakStepSchema,
+    ContinueStepSchema,
+    TryCatchStepSchema,
+]);
+/**
+ * Workflow definition - now supports control flow in steps
+ */
+export const WorkflowDefinitionSchema = z.object({
+    task: z.string(),
+    inputs: z.array(WorkflowInputDefinitionSchema).nullish(),
+    steps: z.array(WorkflowControlFlowStepSchema),
+    output: z.string().nullish(),
+});
+export const WorkflowFileSchema = z.object({
+    workflows: z.record(z.string(), WorkflowDefinitionSchema),
+});
+//# sourceMappingURL=dynamic-types.js.map

package/dist/workflow/dynamic-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-types.js","sourceRoot":"","sources":["../../src/workflow/dynamic-types.ts"],"names":[],"mappings":"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"}

package/dist/workflow/dynamic.d.ts

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+import type { FullToolInfo } from '../tool';
+import { type ValidationResult, type WorkflowFile, type WorkflowStepDefinition } from './dynamic-types';
+import type { BaseWorkflowContext, Logger, StepFn, ToolRegistry, WorkflowFn, WorkflowTools } from './workflow';
+/**
+ * JSON Schema type to Zod type mapping
+ */
+type JsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null';
+/**
+ * JSON Schema enum values - can be string, number, or boolean
+ */
+type JsonSchemaEnum = (string | number | boolean)[];
+interface JsonSchema {
+    type?: JsonSchemaType | JsonSchemaType[];
+    enum?: JsonSchemaEnum;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    additionalProperties?: boolean | JsonSchema;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * Convert a JSON Schema to a Zod schema
+ * Supports a subset of JSON SchemaDraft 7
+ *
+ * This is exported to allow reuse in other parts of the codebase that need to
+ * convert JSON schemas to Zod schemas (e.g., MCP server tool schema conversion).
+ */
+export declare function convertJsonSchemaToZod(schema: JsonSchema): z.ZodTypeAny;
+/**
+ * Tool groups that can be used in step.tools arrays.
+ * - "readonly": File reading operations only
+ * - "readwrite": Full file system access
+ * - "internet": Network operations (fetch, search)
+ * - "all": All available tools (special keyword, not in this map)
+ */
+export declare const TOOL_GROUPS: Record<string, string[]>;
+/**
+ * Type for the runWorkflow tool that allows workflows to call other workflows
+ */
+export type RunWorkflowTool = {
+    input: {
+        workflowId: string;
+        input?: Record<string, unknown>;
+    };
+    output: unknown;
+};
+export type DynamicWorkflowRegistry = ToolRegistry & {
+    runWorkflow: RunWorkflowTool;
+};
+export type DynamicWorkflowParseResult = {
+    success: true;
+    definition: WorkflowFile;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Validate a workflow file for common issues
+ */
+export declare function validateWorkflowFile(definition: WorkflowFile): ValidationResult;
+export declare function parseDynamicWorkflowDefinition(source: string): DynamicWorkflowParseResult;
+export type DynamicStepRuntimeContext<TTools extends ToolRegistry> = {
+    workflowId: string;
+    stepId: string;
+    input: Record<string, unknown>;
+    state: Record<string, unknown>;
+    tools: WorkflowTools<TTools>;
+    logger: Logger;
+    step: StepFn;
+    runWorkflow: (workflowId: string, input?: Record<string, unknown>) => Promise<unknown>;
+    toolInfo: Readonly<FullToolInfo[]> | undefined;
+    agentTools: Record<string, (input: unknown) => Promise<unknown>>;
+};
+export type DynamicWorkflowRunnerOptions = {
+    /**
+     * Tool definitions used when a step does not have persisted `code`
+     * and needs to be executed via `agentWorkflow`.
+     */
+    toolInfo?: Readonly<FullToolInfo[]>;
+    /**
+     * Model id forwarded to `agentWorkflow` for agent-executed steps.
+     */
+    model?: string;
+    /**
+     * Maximum round trips for agent-executed steps.
+     */
+    maxToolRoundTrips?: number;
+    /**
+     * Customize per-step system prompt for agent-executed steps.
+     */
+    stepSystemPrompt?: (args: {
+        workflowId: string;
+        step: WorkflowStepDefinition;
+        input: Record<string, unknown>;
+        state: Record<string, unknown>;
+    }) => string;
+    /**
+     * Whether to wrap plain text agent responses in an object { result: ... }.
+     * Defaults to false.
+     */
+    wrapAgentResultInObject?: boolean;
+    /**
+     * Built-in workflows that can be called by name if not found in the definition.
+     */
+    builtInWorkflows?: Record<string, WorkflowFn<any, any, any>>;
+    /**
+     * Allow unsafe code execution in condition expressions.
+     * When false (default), only simple comparisons and property access are allowed.
+     * When true, arbitrary JavaScript code can be executed in conditions.
+     * WARNING: Setting to true with untrusted workflow definitions is a security risk.
+     * @default false
+     */
+    allowUnsafeCodeExecution?: boolean;
+};
+export declare function createDynamicWorkflow<TTools extends ToolRegistry = DynamicWorkflowRegistry, TContext extends BaseWorkflowContext<TTools> = BaseWorkflowContext<TTools>>(definition: WorkflowFile | string, options?: DynamicWorkflowRunnerOptions): (workflowId: string, input: Record<string, unknown>, context: TContext) => Promise<unknown>;
+export {};