@polka-codes/core 0.9.24 → 0.9.26

package/dist/_tsup-dts-rollup.d.ts

@@ -65,11 +65,28 @@ declare type AgentBaseConfig = {
     toolFormat: ToolFormat;
     parameters: Record<string, any>;
     usageMeter: UsageMeter;
+    requireToolUse: boolean;
 };
 export { AgentBaseConfig }
 export { AgentBaseConfig as AgentBaseConfig_alias_1 }
 export { AgentBaseConfig as AgentBaseConfig_alias_2 }
 
+declare type AgentContextParameters = {
+    budget?: number;
+    maxMessages?: number;
+    toolFormat?: ToolFormat;
+    os?: string;
+    policies?: AgentPolicy[];
+    modelParameters?: Record<string, any>;
+    scripts?: Record<string, string | {
+        command: string;
+        description: string;
+    }>;
+};
+export { AgentContextParameters }
+export { AgentContextParameters as AgentContextParameters_alias_1 }
+export { AgentContextParameters as AgentContextParameters_alias_2 }
+
 declare type AgentInfo = {
     name: string;
     responsibilities: string[];
@@ -104,6 +121,27 @@ export { agentsPrompt }
 export { agentsPrompt as agentsPrompt_alias_1 }
 export { agentsPrompt as agentsPrompt_alias_2 }
 
+declare type AgentStepSpec<TInput extends Record<string, Json> = Record<string, Json>, TOutput extends Record<string, Json> = Record<string, Json>> = BaseStepSpec<TInput, TOutput> & {
+    type: 'agent';
+    messages: (UserContent_2 | TemplatedString)[];
+    outputSchema: z.ZodType;
+    provider?: string;
+    model?: string;
+    budget?: number;
+    maxMessages?: number;
+    modelParameters?: Record<string, any>;
+    toolFormat?: ToolFormat;
+} & ({
+    agent: AgentNameType;
+    tools?: FullToolInfoV2[];
+} | {
+    systemPrompt: string | TemplatedString;
+    tools: FullToolInfoV2[];
+});
+export { AgentStepSpec }
+export { AgentStepSpec as AgentStepSpec_alias_1 }
+export { AgentStepSpec as AgentStepSpec_alias_2 }
+
 declare type AiToolDefinition<Input, Output = string> = {
     name: string;
     description: string;
@@ -215,6 +253,21 @@ export declare const basePrompt = "You are a highly skilled software engineer sp
 
 export declare const basePrompt_alias_1 = "You are a highly skilled software engineer with extensive knowledge in many programming languages, frameworks, design patterns, and best practices.";
 
+declare type BaseStepSpec<TInput extends Record<string, Json> = Record<string, Json>, TOutput extends Record<string, Json> = Record<string, Json>> = {
+    id: string;
+    type: string;
+    inputSchema?: z.ZodType<TInput>;
+    outputSchema?: z.ZodType<TOutput>;
+};
+export { BaseStepSpec }
+export { BaseStepSpec as BaseStepSpec_alias_1 }
+export { BaseStepSpec as BaseStepSpec_alias_2 }
+
+declare const builder: <TInput extends Record<string, Json>>() => StepsBuilder<TInput, TInput>;
+export { builder }
+export { builder as builder_alias_1 }
+export { builder as builder_alias_2 }
+
 declare const capabilities: (_toolNamePrefix: string) => string;
 export { capabilities }
 export { capabilities as capabilities_alias_1 }
@@ -276,6 +329,17 @@ export { CoderAgentOptions }
 export { CoderAgentOptions as CoderAgentOptions_alias_1 }
 export { CoderAgentOptions as CoderAgentOptions_alias_2 }
 
+declare const combineHandlers: <THandlers extends StepSpecHandler[]>(...handlers: THandlers) => (step: BaseStepSpec, rootHandler: StepSpecHandlerFn<any, any>) => StepSpecRaw;
+export { combineHandlers }
+export { combineHandlers as combineHandlers_alias_1 }
+export { combineHandlers as combineHandlers_alias_2 }
+
+declare type CommandOutput = {
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+};
+
 declare type CommandProvider = {
     executeCommand?: (command: string, needApprove: boolean) => Promise<{
         stdout: string;
@@ -287,6 +351,21 @@ export { CommandProvider }
 export { CommandProvider as CommandProvider_alias_1 }
 export { CommandProvider as CommandProvider_alias_2 }
 
+declare interface CommandStepSpec extends BaseStepSpec<Record<string, string>, CommandOutput> {
+    type: 'command';
+    command: (string | TemplatedString)[];
+    outputs?: ('stdout' | 'stderr' | 'exitCode')[];
+}
+export { CommandStepSpec }
+export { CommandStepSpec as CommandStepSpec_alias_1 }
+export { CommandStepSpec as CommandStepSpec_alias_2 }
+
+declare const commandStepSpecHandler: StepSpecHandler;
+export { commandStepSpecHandler }
+export { commandStepSpecHandler as commandStepSpecHandler_alias_1 }
+export { commandStepSpecHandler as commandStepSpecHandler_alias_2 }
+export { commandStepSpecHandler as commandStepSpecHandler_alias_3 }
+
 declare type Config = z.infer<typeof configSchema>;
 export { Config }
 export { Config as Config_alias_1 }
@@ -380,6 +459,22 @@ export { customScripts }
 export { customScripts as customScripts_alias_1 }
 export { customScripts as customScripts_alias_2 }
 
+declare interface CustomStepSpec<TInput extends Record<string, Json> = Record<string, Json>, TOutput extends Record<string, Json> = Record<string, Json>> extends BaseStepSpec<TInput, TOutput> {
+    type: 'custom';
+    run: (input: TInput & {
+        $: Record<string, Record<string, Json>>;
+    }, context: WorkflowContext, resumedState?: any) => Promise<StepRunResult<TOutput>>;
+}
+export { CustomStepSpec }
+export { CustomStepSpec as CustomStepSpec_alias_1 }
+export { CustomStepSpec as CustomStepSpec_alias_2 }
+
+declare const customStepSpecHandler: StepSpecHandler;
+export { customStepSpecHandler }
+export { customStepSpecHandler as customStepSpecHandler_alias_1 }
+export { customStepSpecHandler as customStepSpecHandler_alias_2 }
+export { customStepSpecHandler as customStepSpecHandler_alias_3 }
+
 declare const _default: {
     handler: ToolHandler<{
         readonly name: "ask_followup_question";
@@ -390,7 +485,6 @@ declare const _default: {
                 options: z.ZodDefault<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.None;
     }, InteractionProvider>;
     isAvailable: (provider: InteractionProvider) => boolean;
     name: "ask_followup_question";
@@ -401,7 +495,6 @@ declare const _default: {
             options: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.None;
 };
 export { _default as askFollowupQuestion }
 export { _default as askFollowupQuestion_alias_1 }
@@ -415,7 +508,6 @@ declare const _default_10: {
         readonly parameters: z.ZodObject<{
             path: z.ZodString;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Write;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     name: "remove_file";
@@ -423,7 +515,6 @@ declare const _default_10: {
     parameters: z.ZodObject<{
         path: z.ZodString;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Write;
 };
 export { _default_10 as default_alias_15 }
 export { _default_10 as removeFile }
@@ -438,7 +529,6 @@ declare const _default_11: {
             source_path: z.ZodString;
             target_path: z.ZodString;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Write;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     name: "rename_file";
@@ -447,7 +537,6 @@ declare const _default_11: {
         source_path: z.ZodString;
         target_path: z.ZodString;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Write;
 };
 export { _default_11 as default_alias_16 }
 export { _default_11 as renameFile }
@@ -462,7 +551,6 @@ declare const _default_12: {
             path: z.ZodString;
             diff: z.ZodString;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Write;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     name: "replace_in_file";
@@ -471,7 +559,6 @@ declare const _default_12: {
         path: z.ZodString;
         diff: z.ZodString;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Write;
 };
 export { _default_12 as default_alias_17 }
 export { _default_12 as replaceInFile }
@@ -487,7 +574,6 @@ declare const _default_13: {
             regex: z.ZodString;
             filePattern: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Read;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     name: "search_files";
@@ -497,7 +583,6 @@ declare const _default_13: {
         regex: z.ZodString;
         filePattern: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Read;
 };
 export { _default_13 as default_alias_18 }
 export { _default_13 as searchFiles }
@@ -512,7 +597,6 @@ declare const _default_14: {
             path: z.ZodString;
             content: z.ZodString;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Write;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     name: "write_to_file";
@@ -521,7 +605,6 @@ declare const _default_14: {
         path: z.ZodString;
         content: z.ZodString;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Write;
 };
 export { _default_14 as default_alias_19 }
 export { _default_14 as writeToFile }
@@ -535,7 +618,6 @@ declare const _default_2: {
         readonly parameters: z.ZodObject<{
             result: z.ZodString;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.None;
     }, InteractionProvider>;
     isAvailable: (_provider: InteractionProvider) => boolean;
     name: "attempt_completion";
@@ -543,7 +625,6 @@ declare const _default_2: {
     parameters: z.ZodObject<{
         result: z.ZodString;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.None;
 };
 export { _default_2 as attemptCompletion }
 export { _default_2 as attemptCompletion_alias_1 }
@@ -560,7 +641,6 @@ declare const _default_3: {
             context: z.ZodString;
             files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.None;
     }, any>;
     isAvailable: (_provider: any) => boolean;
     name: "delegate";
@@ -571,7 +651,6 @@ declare const _default_3: {
         context: z.ZodString;
         files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.None;
 };
 export { _default_3 as default_alias_8 }
 export { _default_3 as delegate }
@@ -586,7 +665,6 @@ declare const _default_4: {
             command: z.ZodString;
             requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Arbitrary;
     }, CommandProvider>;
     isAvailable: (provider: CommandProvider) => boolean;
     name: "execute_command";
@@ -595,7 +673,6 @@ declare const _default_4: {
         command: z.ZodString;
         requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Arbitrary;
 };
 export { _default_4 as default_alias_9 }
 export { _default_4 as executeCommand }
@@ -609,7 +686,6 @@ declare const _default_5: {
         readonly parameters: z.ZodObject<{
             url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Read;
     }, WebProvider>;
     isAvailable: (provider: WebProvider) => boolean;
     name: "fetch_url";
@@ -617,7 +693,6 @@ declare const _default_5: {
     parameters: z.ZodObject<{
         url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Read;
 };
 export { _default_5 as default_alias_10 }
 export { _default_5 as fetchUrl }
@@ -634,7 +709,6 @@ declare const _default_6: {
             context: z.ZodString;
             files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.None;
     }, any>;
     isAvailable: (_provider: any) => boolean;
     name: "hand_over";
@@ -645,7 +719,6 @@ declare const _default_6: {
         context: z.ZodString;
         files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.None;
 };
 export { _default_6 as default_alias_11 }
 export { _default_6 as handOver }
@@ -662,7 +735,6 @@ declare const _default_7: {
             recursive: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
             includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Read;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     name: "list_files";
@@ -673,7 +745,6 @@ declare const _default_7: {
         recursive: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Read;
 };
 export { _default_7 as default_alias_12 }
 export { _default_7 as listFiles }
@@ -687,7 +758,6 @@ declare const _default_8: {
         readonly parameters: z.ZodObject<{
             url: z.ZodString;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Read;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     name: "read_binary_file";
@@ -695,7 +765,6 @@ declare const _default_8: {
     parameters: z.ZodObject<{
         url: z.ZodString;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Read;
 };
 export { _default_8 as default_alias_13 }
 export { _default_8 as readBinaryFile }
@@ -710,7 +779,6 @@ declare const _default_9: {
             path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
             includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Read;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     name: "read_file";
@@ -719,7 +787,6 @@ declare const _default_9: {
         path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
         includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Read;
 };
 export { _default_9 as default_alias_14 }
 export { _default_9 as readFile }
@@ -774,7 +841,7 @@ export declare const default_alias_3: {
 export declare const default_alias_4: {
     readonly name: "reviewDiff";
     readonly description: "Reviews a git diff";
-    readonly prompt: "\n# Code Review Prompt\n\nYou are a senior software engineer reviewing code changes.\n\n## Critical Instructions\n**ONLY review the actual changes shown in the diff.** Do not comment on existing code that wasn't modified.\n\n## Viewing Changes\n- **Use git_diff** to inspect the actual code changes for each relevant file.\n  - **Pull request**: use the provided commit range for the git_diff tool with contextLines: 5 and includeLineNumbers: true\n  - **Local changes**: diff staged or unstaged files using the git_diff tool with contextLines: 5 and includeLineNumbers: true\n- The diff will include line number annotations: [Line N] for additions and [Line N removed] for deletions\n- If a pull request is present you may receive:\n  - <pr_title>\n  - <pr_description>\n  - <commit_messages>\n- A <review_instructions> tag tells you the focus of the review.\n- File status information is provided in <file_status> - use this to understand which files were modified, added, deleted, or renamed.\n\n## Line Number Reporting\n- **IMPORTANT**: Use the line numbers from the annotations in the diff output\n- For additions: Look for [Line N] annotations after the + lines\n- For deletions: Look for [Line N removed] annotations after the - lines\n- For modifications: Report the line number of the new/current code (from [Line N] annotations)\n- Report single lines as \"N\" and ranges as \"N-M\"\n\n## Review Guidelines\nFocus exclusively on the changed lines (+ additions, - deletions, modified lines):\n- **Specific issues**: Point to exact problems in the changed code with accurate line references from the annotations\n- **Actionable fixes**: Provide concrete solutions, not vague suggestions\n- **Clear reasoning**: Explain why each issue matters and how to fix it\n- **Avoid generic advice**: No generic suggestions like \"add more tests\", \"improve documentation\", or \"follow best practices\" unless directly related to a specific problem in the diff\n\n## What NOT to review\n- Existing unchanged code\n- Overall project structure or architecture (unless directly impacted by changes)\n- Generic best practices unrelated to the specific changes\n- Missing features or functionality not part of this diff\n\n## Output Format\nDo **not** include praise or positive feedback. Ignore generated files such as lock files.\nOnly include reviews for actual issues found in the changed code.\n\nReturn your review as a JSON object inside a ```json block, wrapped like:\n<tool_attempt_completion>\n<tool_parameter_result>\n```json\n{\n  \"overview\": \"Summary of specific issues found in the diff changes, or 'No issues found' if the changes look good.\",\n  \"specificReviews\": [\n    {\n      \"file\": \"path/filename.ext\",\n      \"lines\": \"N or N-M\",\n      \"review\": \"Specific issue with the changed code and exact actionable fix.\"\n    }\n  ]\n}\n```\n</tool_parameter_result>\n</tool_attempt_completion>\n";
+    readonly prompt: "\n# Code Review Prompt\n\nYou are a senior software engineer reviewing code changes.\n\n## Critical Instructions\n- **ONLY review the actual changes shown in the diff.** Do not comment on existing code that wasn't modified.\n- **ONLY run git_diff on files that are reviewable source/config files** per the \"File Selection for git_diff\" rules below. Do not pass excluded files to git_diff.\n\n## File Selection for git_diff\nUse <file_status> to decide which files to diff. Include only files likely to contain human-authored source or meaningful configuration.\n\nInclude (run git_diff):\n- Application/source code\n- UI/templates/assets code\n- Infra/config that affects behavior\n\nExclude (do NOT run git_diff; do not review):\n- Lockfiles\n- Generated/build artifacts & deps\n- Test artifacts/snapshots\n- Data and fixtures\n- Binary/media/minified/maps\n\n## Viewing Changes\n- For each included file, **use git_diff** to inspect the actual code changes:\n  - **Pull request:** use the provided commit range for the git_diff tool with contextLines: 5 and includeLineNumbers: true, but only surface and review the included files.\n  - **Local changes:** diff staged or unstaged included files using git_diff with contextLines: 5 and includeLineNumbers: true.\n- The diff will include line number annotations: [Line N] for additions and [Line N removed] for deletions.\n- You may receive:\n  - <pr_title>\n  - <pr_description>\n  - <commit_messages>\n- A <review_instructions> tag tells you the focus of the review.\n- Use <file_status> to understand which files were modified, added, deleted, or renamed and to apply the inclusion/exclusion rules above.\n\n## Line Number Reporting\n- Use the line numbers from the annotations in the diff output.\n- For additions: use the number from the [Line N] annotation after the + line.\n- For deletions: use the number from the [Line N removed] annotation after the - line.\n- For modifications: report the line number of the new/current code (from [Line N]).\n- Report single lines as \"N\" and ranges as \"N-M\".\n\n## Review Guidelines\nFocus exclusively on the changed lines (+ additions, - deletions, modified lines):\n- **Specific issues:** Point to exact problems in the changed code with accurate line references from the annotations.\n- **Actionable fixes:** Provide concrete solutions, not vague suggestions.\n- **Clear reasoning:** Explain why each issue matters and how to fix it.\n- **Avoid generic advice** unless directly tied to a specific problem visible in the diff.\n\n## What NOT to review\n- Files excluded by the \"File Selection for git_diff\" rules (do not diff or comment on them).\n- Existing unchanged code.\n- Overall project structure/architecture unless directly impacted by the changes.\n- Missing features or functionality not part of this diff.\n\n## Output Format\nDo not include praise or positive feedback.\nOnly include reviews for actual issues found in the changed code.\n\nReturn your review as a JSON object inside a ```json block, wrapped like:\n```json\n{\n  \"overview\": \"Summary of specific issues found in the diff changes, 'No issues found', or 'No reviewable changes' if all modified files were excluded.\",\n  \"specificReviews\": [\n    {\n      \"file\": \"path/filename.ext\",\n      \"lines\": \"N or N-M\",\n      \"review\": \"Specific issue with the changed code and exact actionable fix.\"\n    }\n  ]\n}\n```\n";
     readonly formatInput: (params: Input_2) => string;
     readonly parseOutput: (output: string) => Output_2;
     readonly agent: (options: SharedAgentOptions) => AnalyzerAgent;
@@ -787,11 +854,10 @@ export declare const default_alias_5: {
         readonly parameters: z.ZodObject<{
             staged: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
             commitRange: z.ZodOptional<z.ZodString>;
-            file: z.ZodOptional<z.ZodString>;
+            file: z.ZodString;
             contextLines: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
             includeLineNumbers: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Read;
     }, CommandProvider>;
     isAvailable: (provider: CommandProvider) => boolean;
     name: "git_diff";
@@ -799,11 +865,10 @@ export declare const default_alias_5: {
     parameters: z.ZodObject<{
         staged: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         commitRange: z.ZodOptional<z.ZodString>;
-        file: z.ZodOptional<z.ZodString>;
+        file: z.ZodString;
         contextLines: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
         includeLineNumbers: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Read;
 };
 
 export declare interface DiffHunk {
@@ -952,15 +1017,13 @@ export declare const getArray: <T extends string>(args: Partial<Record<T, ToolPa
  * @param provider The provider to use.
  * @param allTools All possible tools.
  * @param hasAgent Whether the agent has agents.
- * @param permissionLevel Determines which tools are available based on the agent's assigned level.
  * @param interactive Determines whether the `askFollowupQuestion` tool is available.
  * @returns The available tools
  */
-declare const getAvailableTools: <T extends FullToolInfoV2 | FullToolInfo>({ provider, allTools, hasAgent, permissionLevel, interactive, }: {
+declare const getAvailableTools: <T extends FullToolInfoV2 | FullToolInfo>({ provider, allTools, hasAgent, interactive, }: {
     provider: any;
     allTools: T[];
     hasAgent: boolean;
-    permissionLevel: PermissionLevel;
     interactive: boolean;
 }) => T[];
 export { getAvailableTools }
@@ -1033,6 +1096,11 @@ declare type Input_2 = {
     }>;
 };
 
+declare type InputType = {
+    $: Record<string, Record<string, Json>>;
+    [key: string]: Json;
+};
+
 declare type InteractionProvider = {
     askFollowupQuestion?: (question: string, options: string[]) => Promise<string>;
     attemptCompletion?: (result: string) => Promise<string | undefined>;
@@ -1076,6 +1144,19 @@ export declare const isAvailable_alias_9: (provider: FilesystemProvider) => bool
  */
 export declare function join(...parts: string[]): string;
 
+declare type Json = boolean | number | string | Json[] | {
+    [k: string]: Json;
+};
+export { Json }
+export { Json as Json_alias_1 }
+export { Json as Json_alias_2 }
+
+declare const makeAgentStepSpecHandler: (getModelFn: (step: AgentStepSpec, context: WorkflowContext) => Promise<LanguageModelV2>) => StepSpecHandler;
+export { makeAgentStepSpecHandler }
+export { makeAgentStepSpecHandler as makeAgentStepSpecHandler_alias_1 }
+export { makeAgentStepSpecHandler as makeAgentStepSpecHandler_alias_2 }
+export { makeAgentStepSpecHandler as makeAgentStepSpecHandler_alias_3 }
+
 declare const makeAgentTool: <T extends AiToolDefinitionWithAgent<any, any>>(definition: T) => (options: SharedAgentOptions, params: GetInput<T>) => Promise<GetOutput<T>>;
 export { makeAgentTool }
 export { makeAgentTool as makeAgentTool_alias_1 }
@@ -1153,6 +1234,20 @@ declare type Output_2 = {
     specificReviews: SpecificReview[];
 };
 
+declare interface ParallelStepSpec<TInput extends Record<string, Json> = Record<string, Json>, TOutput extends Record<string, Json> = Record<string, Json>> extends BaseStepSpec<Record<string, Json>, Record<string, Json>> {
+    type: 'parallel';
+    step: BaseStepSpec<TInput, TOutput>;
+}
+export { ParallelStepSpec }
+export { ParallelStepSpec as ParallelStepSpec_alias_1 }
+export { ParallelStepSpec as ParallelStepSpec_alias_2 }
+
+declare const parallelStepSpecHandler: StepSpecHandler;
+export { parallelStepSpecHandler }
+export { parallelStepSpecHandler as parallelStepSpecHandler_alias_1 }
+export { parallelStepSpecHandler as parallelStepSpecHandler_alias_2 }
+export { parallelStepSpecHandler as parallelStepSpecHandler_alias_3 }
+
 /**
  * Parse an assistant's message into an array of text content and tool use content.
  *
@@ -1225,15 +1320,6 @@ export { parseAssistantMessage as parseAssistantMessage_alias_2 }
  */
 export declare function parseHunkHeader(header: string): DiffHunk | null;
 
-declare enum PermissionLevel {
-    None = 0,
-    Read = 1,
-    Write = 2,
-    Arbitrary = 3
-}
-export { PermissionLevel }
-export { PermissionLevel as PermissionLevel_alias_1 }
-
 declare enum Policies {
     TruncateContext = "truncatecontext",
     EnableCache = "enablecache"
@@ -1255,6 +1341,12 @@ declare type ReplaceResult = {
 export { ReplaceResult }
 export { ReplaceResult as ReplaceResult_alias_1 }
 
+export declare const resolveTemplatedString: (templatedString: string | TemplatedString<{
+    [k: string]: Json;
+}>, input: {
+    [k: string]: Json;
+}) => string;
+
 declare const responsePrompts: {
     readonly errorInvokeTool: (tool: string, error: unknown) => string;
     readonly requireUseTool: "Error: No tool use detected. You MUST use a tool before proceeding.\ne.g. <tool_tool_name>tool_name</tool_tool_name>\n\nEnsure the opening and closing tags are correctly nested and closed, and that you are using the correct tool name.\nAvoid unnecessary text or symbols before or after the tool use.\nAvoid unnecessary escape characters or special characters.\n";
@@ -1266,6 +1358,11 @@ export { responsePrompts }
 export { responsePrompts as responsePrompts_alias_1 }
 export { responsePrompts as responsePrompts_alias_2 }
 
+declare const resume: <TInput extends Record<string, Json>, TOutput extends Record<string, Json>>(workflow: WorkflowSpec<TInput, TOutput, any>, context: WorkflowContext, handler: StepSpecHandlerFn<any, any>, state: any, input: TInput) => Promise<WorkflowRunResult<TOutput>>;
+export { resume }
+export { resume as resume_alias_1 }
+export { resume as resume_alias_2 }
+
 export declare const retryGuidelines = "\n====\n\nRETRY GUIDELINES\n\n1. Before Retrying\n   - Analyze previous attempt's failure\n   - Consider alternative approaches\n   - Check if similar issues were fixed\n   - Verify no new issues were introduced\n\n2. When to Retry\n   - Error message changed but issue persists\n   - New information available about the root cause\n   - Different fixing strategy available\n   - Previous attempt partially successful\n\n3. When to Stop\n   - Maximum retry limit reached\n   - Same error occurs repeatedly\n   - Fix would require major refactoring\n   - Issue requires human intervention\n\n4. After Maximum Retries\n   - Document attempted solutions\n   - Explain why the issue remains\n   - Suggest manual intervention steps\n   - Report any partial improvements";
 
 declare const reviewDiff: (options: SharedAgentOptions, params: {
@@ -1291,6 +1388,27 @@ export { reviewDiff as reviewDiff_alias_1 }
 
 export declare const rules: (toolNamePrefix: string) => string;
 
+declare const run: <TInput extends Record<string, Json>, TOutput extends Record<string, Json>>(workflow: WorkflowSpec<TInput, TOutput, any>, context: WorkflowContext, handler: StepSpecHandlerFn<any, any>, input: TInput) => Promise<WorkflowRunResult<TOutput>>;
+export { run }
+export { run as run_alias_1 }
+export { run as run_alias_2 }
+
+export declare const runStep: (step: StepSpecRaw, input: Record<string, Json>, context: WorkflowContext, resumedState: any | undefined, allOutputs: Record<string, Record<string, Json>>) => Promise<StepRunResult<Record<string, Json>>>;
+
+declare interface SequentialStepSpec<TInput extends Record<string, Json> = Record<string, Json>, TOutput extends Record<string, Json> = Record<string, Json>, TStepSpec extends BaseStepSpec = BaseStepSpec> extends BaseStepSpec<TInput, TOutput> {
+    type: 'sequential';
+    steps: TStepSpec[];
+}
+export { SequentialStepSpec }
+export { SequentialStepSpec as SequentialStepSpec_alias_1 }
+export { SequentialStepSpec as SequentialStepSpec_alias_2 }
+
+declare const sequentialStepSpecHandler: StepSpecHandler;
+export { sequentialStepSpecHandler }
+export { sequentialStepSpecHandler as sequentialStepSpecHandler_alias_1 }
+export { sequentialStepSpecHandler as sequentialStepSpecHandler_alias_2 }
+export { sequentialStepSpecHandler as sequentialStepSpecHandler_alias_3 }
+
 declare type SharedAgentOptions = {
     ai: LanguageModelV2;
     os: string;
@@ -1310,6 +1428,7 @@ declare type SharedAgentOptions = {
     toolFormat: ToolFormat;
     parameters?: Record<string, any>;
     usageMeter?: UsageMeter;
+    requireToolUse?: boolean;
 };
 export { SharedAgentOptions }
 export { SharedAgentOptions as SharedAgentOptions_alias_1 }
@@ -1321,6 +1440,72 @@ declare type SpecificReview = {
     review: string;
 };
 
+declare type StepRunResult<T extends Record<string, Json>> = StepRunResultSuccess<T> | StepRunResultPaused | StepRunResultError;
+export { StepRunResult }
+export { StepRunResult as StepRunResult_alias_1 }
+export { StepRunResult as StepRunResult_alias_2 }
+
+declare type StepRunResultError = {
+    type: 'error';
+    error: any;
+};
+export { StepRunResultError }
+export { StepRunResultError as StepRunResultError_alias_1 }
+export { StepRunResultError as StepRunResultError_alias_2 }
+
+declare type StepRunResultPaused = {
+    type: 'paused';
+    state: any;
+};
+export { StepRunResultPaused }
+export { StepRunResultPaused as StepRunResultPaused_alias_1 }
+export { StepRunResultPaused as StepRunResultPaused_alias_2 }
+
+declare type StepRunResultSuccess<T extends Record<string, Json>> = {
+    type: 'success';
+    output: T;
+};
+export { StepRunResultSuccess }
+export { StepRunResultSuccess as StepRunResultSuccess_alias_1 }
+export { StepRunResultSuccess as StepRunResultSuccess_alias_2 }
+
+declare class StepsBuilder<TInput extends Record<string, Json> = Record<string, Json>, TOutput extends Record<string, Json> = Record<string, Json>> {
+    #private;
+    build(): BaseStepSpec | {
+        id: string;
+        type: string;
+        steps: BaseStepSpec[];
+    };
+    step<TStepOutput extends Record<string, Json>, TStepSpec extends BaseStepSpec<TOutput, TStepOutput>>(step: TStepSpec): StepsBuilder<TInput, TStepOutput>;
+    parallel<TStepOutput extends Record<string, Json>>(id: string, step: BaseStepSpec<TOutput, TStepOutput>): StepsBuilder<TInput, TStepOutput>;
+    custom<TStepOutput extends Record<string, Json>>(id: string, run: CustomStepSpec<TOutput, TStepOutput>['run']): StepsBuilder<TInput, TStepOutput>;
+    agent<TStepOutput extends Record<string, Json>>(id: string, spec: Omit<AgentStepSpec<TOutput, TStepOutput>, 'id' | 'type'>): StepsBuilder<TInput, TStepOutput>;
+}
+
+declare type StepSpecHandler = {
+    type: string;
+    handler: StepSpecHandlerFn<any, any>;
+};
+export { StepSpecHandler }
+export { StepSpecHandler as StepSpecHandler_alias_1 }
+export { StepSpecHandler as StepSpecHandler_alias_2 }
+
+declare type StepSpecHandlerFn<TStepSpec extends BaseStepSpec, TRootStepSpec extends BaseStepSpec> = (step: TStepSpec, rootHandler: StepSpecHandlerFn<TRootStepSpec, TRootStepSpec>) => StepSpecRaw;
+export { StepSpecHandlerFn }
+export { StepSpecHandlerFn as StepSpecHandlerFn_alias_1 }
+export { StepSpecHandlerFn as StepSpecHandlerFn_alias_2 }
+
+declare type StepSpecRaw = {
+    id: string;
+    type: string;
+    inputSchema?: z.ZodType<any>;
+    outputSchema?: z.ZodType<any>;
+    run: (input: InputType, context: WorkflowContext, resumedState?: any) => Promise<StepRunResult<Record<string, Json>>>;
+};
+export { StepSpecRaw }
+export { StepSpecRaw as StepSpecRaw_alias_1 }
+export { StepSpecRaw as StepSpecRaw_alias_2 }
+
 declare const systemInformation: (info: {
     os: string;
 }) => string;
@@ -1506,6 +1691,19 @@ export { TaskEventUsageExceeded }
 export { TaskEventUsageExceeded as TaskEventUsageExceeded_alias_1 }
 export { TaskEventUsageExceeded as TaskEventUsageExceeded_alias_2 }
 
+declare type TemplatedString<T = {
+    [k: string]: Json;
+}> = {
+    type: 'template';
+    template: string;
+} | {
+    type: 'function';
+    fn: (input: T) => string;
+};
+export { TemplatedString }
+export { TemplatedString as TemplatedString_alias_1 }
+export { TemplatedString as TemplatedString_alias_2 }
+
 declare interface TextContent {
     type: 'text';
     content: string;
@@ -1534,7 +1732,6 @@ declare type ToolInfo = {
     description: string;
     parameters: ToolParameter[];
     examples?: ToolExample[];
-    permissionLevel: PermissionLevel;
 };
 export { ToolInfo }
 export { ToolInfo as ToolInfo_alias_1 }
@@ -1545,11 +1742,10 @@ export declare const toolInfo: {
     readonly parameters: z.ZodObject<{
         staged: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         commitRange: z.ZodOptional<z.ZodString>;
-        file: z.ZodOptional<z.ZodString>;
+        file: z.ZodString;
         contextLines: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
         includeLineNumbers: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Read;
 };
 
 export declare const toolInfo_alias_1: {
@@ -1561,7 +1757,6 @@ export declare const toolInfo_alias_1: {
             options: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.None;
 };
 
 export declare const toolInfo_alias_10: {
@@ -1570,7 +1765,6 @@ export declare const toolInfo_alias_10: {
     readonly parameters: z.ZodObject<{
         path: z.ZodString;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Write;
 };
 
 export declare const toolInfo_alias_11: {
@@ -1580,7 +1774,6 @@ export declare const toolInfo_alias_11: {
         source_path: z.ZodString;
         target_path: z.ZodString;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Write;
 };
 
 export declare const toolInfo_alias_12: {
@@ -1590,7 +1783,6 @@ export declare const toolInfo_alias_12: {
         path: z.ZodString;
         diff: z.ZodString;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Write;
 };
 
 export declare const toolInfo_alias_13: {
@@ -1601,7 +1793,6 @@ export declare const toolInfo_alias_13: {
         regex: z.ZodString;
         filePattern: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Read;
 };
 
 export declare const toolInfo_alias_14: {
@@ -1611,7 +1802,6 @@ export declare const toolInfo_alias_14: {
         path: z.ZodString;
         content: z.ZodString;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Write;
 };
 
 export declare const toolInfo_alias_2: {
@@ -1620,7 +1810,6 @@ export declare const toolInfo_alias_2: {
     readonly parameters: z.ZodObject<{
         result: z.ZodString;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.None;
 };
 
 export declare const toolInfo_alias_3: {
@@ -1632,7 +1821,6 @@ export declare const toolInfo_alias_3: {
         context: z.ZodString;
         files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.None;
 };
 
 export declare const toolInfo_alias_4: {
@@ -1642,7 +1830,6 @@ export declare const toolInfo_alias_4: {
         command: z.ZodString;
         requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Arbitrary;
 };
 
 export declare const toolInfo_alias_5: {
@@ -1651,7 +1838,6 @@ export declare const toolInfo_alias_5: {
     readonly parameters: z.ZodObject<{
         url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Read;
 };
 
 export declare const toolInfo_alias_6: {
@@ -1663,7 +1849,6 @@ export declare const toolInfo_alias_6: {
         context: z.ZodString;
         files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.None;
 };
 
 export declare const toolInfo_alias_7: {
@@ -1675,7 +1860,6 @@ export declare const toolInfo_alias_7: {
         recursive: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Read;
 };
 
 export declare const toolInfo_alias_8: {
@@ -1684,7 +1868,6 @@ export declare const toolInfo_alias_8: {
     readonly parameters: z.ZodObject<{
         url: z.ZodString;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Read;
 };
 
 export declare const toolInfo_alias_9: {
@@ -1694,14 +1877,12 @@ export declare const toolInfo_alias_9: {
         path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
         includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Read;
 };
 
 declare type ToolInfoV2 = {
     name: string;
     description: string;
     parameters: z.ZodObject<any>;
-    permissionLevel: PermissionLevel;
 };
 export { ToolInfoV2 }
 export { ToolInfoV2 as ToolInfoV2_alias_1 }
@@ -1950,4 +2131,59 @@ export { WebProvider }
 export { WebProvider as WebProvider_alias_1 }
 export { WebProvider as WebProvider_alias_2 }
 
+declare type WorkflowContext = {
+    provider: ToolProvider;
+    parameters: Record<string, any>;
+};
+export { WorkflowContext }
+export { WorkflowContext as WorkflowContext_alias_1 }
+export { WorkflowContext as WorkflowContext_alias_2 }
+
+declare type WorkflowRunResult<T extends Record<string, Json>> = WorkflowRunResultSuccess<T> | WorkflowRunResultError | WorkflowRunResultPaused;
+export { WorkflowRunResult }
+export { WorkflowRunResult as WorkflowRunResult_alias_1 }
+export { WorkflowRunResult as WorkflowRunResult_alias_2 }
+
+declare type WorkflowRunResultError = {
+    type: 'error';
+    error: any;
+};
+export { WorkflowRunResultError }
+export { WorkflowRunResultError as WorkflowRunResultError_alias_1 }
+export { WorkflowRunResultError as WorkflowRunResultError_alias_2 }
+
+declare type WorkflowRunResultPaused = {
+    type: 'paused';
+    state: any;
+};
+export { WorkflowRunResultPaused }
+export { WorkflowRunResultPaused as WorkflowRunResultPaused_alias_1 }
+export { WorkflowRunResultPaused as WorkflowRunResultPaused_alias_2 }
+
+declare type WorkflowRunResultSuccess<T extends Record<string, Json>> = {
+    type: 'success';
+    output: T;
+};
+export { WorkflowRunResultSuccess }
+export { WorkflowRunResultSuccess as WorkflowRunResultSuccess_alias_1 }
+export { WorkflowRunResultSuccess as WorkflowRunResultSuccess_alias_2 }
+
+declare interface WorkflowSpec<TInput extends Record<string, Json> = Record<string, Json>, TOutput extends Record<string, Json> = Record<string, Json>, TStepSpec extends BaseStepSpec<TInput, TOutput> = BaseStepSpec<TInput, TOutput>> {
+    name: string;
+    description?: string;
+    step: TStepSpec;
+}
+export { WorkflowSpec }
+export { WorkflowSpec as WorkflowSpec_alias_1 }
+export { WorkflowSpec as WorkflowSpec_alias_2 }
+
+declare interface WorkflowSpecRaw {
+    name: string;
+    description?: string;
+    step: StepSpecRaw;
+}
+export { WorkflowSpecRaw }
+export { WorkflowSpecRaw as WorkflowSpecRaw_alias_1 }
+export { WorkflowSpecRaw as WorkflowSpecRaw_alias_2 }
+
 export { }