@polka-codes/core 0.9.26 → 0.9.28

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

@@ -36,11 +36,11 @@ declare abstract class AgentBase {
     protected abstract onBeforeInvokeTool(name: string, args: Record<string, string>): Promise<ToolResponse | undefined>;
     get model(): string;
     get usage(): {
-        messageCount: number;
         input: number;
         output: number;
         cachedRead: number;
         cost: number;
+        messageCount: number;
     };
 }
 export { AgentBase }
@@ -52,7 +52,6 @@ declare type AgentBaseConfig = {
     tools: FullToolInfoV2[];
     toolNamePrefix: string;
     provider: ToolProvider;
-    interactive: boolean;
     agents?: Readonly<AgentInfo[]>;
     scripts?: Record<string, string | {
         command: string;
@@ -123,21 +122,19 @@ 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;
+    messages: (UserContent_2 | TemplatedString<TInput>)[];
+    outputSchema?: z.ZodType<TOutput>;
+    parseOutput?: (raw: string) => TOutput;
     provider?: string;
     model?: string;
     budget?: number;
     maxMessages?: number;
     modelParameters?: Record<string, any>;
     toolFormat?: ToolFormat;
-} & ({
-    agent: AgentNameType;
+    agent?: AgentNameType;
     tools?: FullToolInfoV2[];
-} | {
-    systemPrompt: string | TemplatedString;
-    tools: FullToolInfoV2[];
-});
+    systemPrompt?: string | TemplatedString<TInput>;
+};
 export { AgentStepSpec }
 export { AgentStepSpec as AgentStepSpec_alias_1 }
 export { AgentStepSpec as AgentStepSpec_alias_2 }
@@ -177,25 +174,6 @@ declare const allAgents: readonly [{
 export { allAgents }
 export { allAgents as allAgents_alias_1 }
 
-export declare namespace allTools {
-    export {
-        _default as askFollowupQuestion,
-        _default_2 as attemptCompletion,
-        _default_3 as delegate,
-        _default_4 as executeCommand,
-        _default_5 as fetchUrl,
-        _default_6 as handOver,
-        _default_7 as listFiles,
-        _default_8 as readBinaryFile,
-        _default_9 as readFile,
-        _default_10 as removeFile,
-        _default_11 as renameFile,
-        _default_12 as replaceInFile,
-        _default_13 as searchFiles,
-        _default_14 as writeToFile
-    }
-}
-
 declare class AnalyzerAgent extends AgentBase {
     constructor(options: AnalyzerAgentOptions);
     onBeforeInvokeTool(): Promise<undefined>;
@@ -217,12 +195,6 @@ export { AnalyzerAgentOptions }
 export { AnalyzerAgentOptions as AnalyzerAgentOptions_alias_1 }
 export { AnalyzerAgentOptions as AnalyzerAgentOptions_alias_2 }
 
-/**
- * Annotate a diff with line numbers for additions and deletions
- * Adds [Line N] for additions and [Line N removed] for deletions
- */
-export declare function annotateDiffWithLineNumbers(diff: string): string;
-
 declare class ArchitectAgent extends AgentBase {
     constructor(options: ArchitectAgentOptions);
     onBeforeInvokeTool(): Promise<undefined>;
@@ -334,6 +306,11 @@ export { combineHandlers }
 export { combineHandlers as combineHandlers_alias_1 }
 export { combineHandlers as combineHandlers_alias_2 }
 
+declare const command: (id: string, ...command: (string | TemplatedString)[]) => CommandStepSpec;
+export { command }
+export { command as command_alias_1 }
+export { command as command_alias_2 }
+
 declare type CommandOutput = {
     stdout?: string;
     stderr?: string;
@@ -498,8 +475,7 @@ declare const _default: {
 };
 export { _default as askFollowupQuestion }
 export { _default as askFollowupQuestion_alias_1 }
-export { _default as askFollowupQuestion_alias_2 }
-export { _default as default_alias_6 }
+export { _default as default_alias_4 }
 
 declare const _default_10: {
     handler: ToolHandler<{
@@ -516,10 +492,9 @@ declare const _default_10: {
         path: z.ZodString;
     }, z.core.$strip>;
 };
-export { _default_10 as default_alias_15 }
+export { _default_10 as default_alias_13 }
 export { _default_10 as removeFile }
 export { _default_10 as removeFile_alias_1 }
-export { _default_10 as removeFile_alias_2 }
 
 declare const _default_11: {
     handler: ToolHandler<{
@@ -538,10 +513,9 @@ declare const _default_11: {
         target_path: z.ZodString;
     }, z.core.$strip>;
 };
-export { _default_11 as default_alias_16 }
+export { _default_11 as default_alias_14 }
 export { _default_11 as renameFile }
 export { _default_11 as renameFile_alias_1 }
-export { _default_11 as renameFile_alias_2 }
 
 declare const _default_12: {
     handler: ToolHandler<{
@@ -560,10 +534,9 @@ declare const _default_12: {
         diff: z.ZodString;
     }, z.core.$strip>;
 };
-export { _default_12 as default_alias_17 }
+export { _default_12 as default_alias_15 }
 export { _default_12 as replaceInFile }
 export { _default_12 as replaceInFile_alias_1 }
-export { _default_12 as replaceInFile_alias_2 }
 
 declare const _default_13: {
     handler: ToolHandler<{
@@ -584,10 +557,9 @@ declare const _default_13: {
         filePattern: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 };
-export { _default_13 as default_alias_18 }
+export { _default_13 as default_alias_16 }
 export { _default_13 as searchFiles }
 export { _default_13 as searchFiles_alias_1 }
-export { _default_13 as searchFiles_alias_2 }
 
 declare const _default_14: {
     handler: ToolHandler<{
@@ -606,10 +578,9 @@ declare const _default_14: {
         content: z.ZodString;
     }, z.core.$strip>;
 };
-export { _default_14 as default_alias_19 }
+export { _default_14 as default_alias_17 }
 export { _default_14 as writeToFile }
 export { _default_14 as writeToFile_alias_1 }
-export { _default_14 as writeToFile_alias_2 }
 
 declare const _default_2: {
     handler: ToolHandler<{
@@ -628,8 +599,7 @@ declare const _default_2: {
 };
 export { _default_2 as attemptCompletion }
 export { _default_2 as attemptCompletion_alias_1 }
-export { _default_2 as attemptCompletion_alias_2 }
-export { _default_2 as default_alias_7 }
+export { _default_2 as default_alias_5 }
 
 declare const _default_3: {
     handler: ToolHandler<{
@@ -652,10 +622,9 @@ declare const _default_3: {
         files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
 };
-export { _default_3 as default_alias_8 }
+export { _default_3 as default_alias_6 }
 export { _default_3 as delegate }
 export { _default_3 as delegate_alias_1 }
-export { _default_3 as delegate_alias_2 }
 
 declare const _default_4: {
     handler: ToolHandler<{
@@ -674,10 +643,9 @@ declare const _default_4: {
         requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
 };
-export { _default_4 as default_alias_9 }
+export { _default_4 as default_alias_7 }
 export { _default_4 as executeCommand }
 export { _default_4 as executeCommand_alias_1 }
-export { _default_4 as executeCommand_alias_2 }
 
 declare const _default_5: {
     handler: ToolHandler<{
@@ -694,10 +662,9 @@ declare const _default_5: {
         url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
 };
-export { _default_5 as default_alias_10 }
+export { _default_5 as default_alias_8 }
 export { _default_5 as fetchUrl }
 export { _default_5 as fetchUrl_alias_1 }
-export { _default_5 as fetchUrl_alias_2 }
 
 declare const _default_6: {
     handler: ToolHandler<{
@@ -720,10 +687,9 @@ declare const _default_6: {
         files: z.ZodOptional<z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
 };
-export { _default_6 as default_alias_11 }
+export { _default_6 as default_alias_9 }
 export { _default_6 as handOver }
 export { _default_6 as handOver_alias_1 }
-export { _default_6 as handOver_alias_2 }
 
 declare const _default_7: {
     handler: ToolHandler<{
@@ -746,10 +712,9 @@ declare const _default_7: {
         includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
 };
-export { _default_7 as default_alias_12 }
+export { _default_7 as default_alias_10 }
 export { _default_7 as listFiles }
 export { _default_7 as listFiles_alias_1 }
-export { _default_7 as listFiles_alias_2 }
 
 declare const _default_8: {
     handler: ToolHandler<{
@@ -766,10 +731,9 @@ declare const _default_8: {
         url: z.ZodString;
     }, z.core.$strip>;
 };
-export { _default_8 as default_alias_13 }
+export { _default_8 as default_alias_11 }
 export { _default_8 as readBinaryFile }
 export { _default_8 as readBinaryFile_alias_1 }
-export { _default_8 as readBinaryFile_alias_2 }
 
 declare const _default_9: {
     handler: ToolHandler<{
@@ -788,10 +752,9 @@ declare const _default_9: {
         includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
 };
-export { _default_9 as default_alias_14 }
+export { _default_9 as default_alias_12 }
 export { _default_9 as readFile }
 export { _default_9 as readFile_alias_1 }
-export { _default_9 as readFile_alias_2 }
 
 /**
  * AI tool for creating new projects based on user specifications.
@@ -838,47 +801,6 @@ export declare const default_alias_3: {
     readonly agent: "analyzer";
 };
 
-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- **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;
-};
-
-export declare const default_alias_5: {
-    handler: ToolHandler<{
-        readonly name: "git_diff";
-        readonly description: "Get the git diff for the current repository. Can be used to get staged changes, unstaged changes, or changes between commits. By default, it returns unstaged changes.";
-        readonly parameters: z.ZodObject<{
-            staged: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
-            commitRange: 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>;
-    }, CommandProvider>;
-    isAvailable: (provider: CommandProvider) => boolean;
-    name: "git_diff";
-    description: "Get the git diff for the current repository. Can be used to get staged changes, unstaged changes, or changes between commits. By default, it returns unstaged changes.";
-    parameters: z.ZodObject<{
-        staged: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
-        commitRange: 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>;
-};
-
-export declare interface DiffHunk {
-    oldStart: number;
-    oldCount: number;
-    newStart: number;
-    newCount: number;
-    header: string;
-}
-
 /**
  * Returns the directory portion of a path string.
  * Strips trailing slashes, then takes everything up to the last slash.
@@ -919,16 +841,6 @@ export { ExitReason }
 export { ExitReason as ExitReason_alias_1 }
 export { ExitReason as ExitReason_alias_2 }
 
-/**
- * Extract line ranges from a diff for a specific file
- * Returns an array of line ranges that were modified
- */
-export declare function extractModifiedLineRanges(diff: string, filePath?: string): Array<{
-    start: number;
-    end: number;
-    type: 'added' | 'removed' | 'modified';
-}>;
-
 declare type FilesystemProvider = {
     readFile?: (path: string, includeIgnored: boolean) => Promise<string | undefined>;
     writeFile?: (path: string, content: string) => Promise<void>;
@@ -964,7 +876,7 @@ export declare const fullSystemPrompt_alias_2: (info: {
 }, tools: FullToolInfoV2[], toolNamePrefix: string, instructions: string[], scripts: Record<string, string | {
     command: string;
     description: string;
-}>, _interactive: boolean, useNativeTool: boolean) => string;
+}>, useNativeTool: boolean) => string;
 
 export declare const fullSystemPrompt_alias_3: (info: {
     os: string;
@@ -1017,14 +929,12 @@ 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 interactive Determines whether the `askFollowupQuestion` tool is available.
  * @returns The available tools
  */
-declare const getAvailableTools: <T extends FullToolInfoV2 | FullToolInfo>({ provider, allTools, hasAgent, interactive, }: {
+declare const getAvailableTools: <T extends FullToolInfoV2 | FullToolInfo>({ provider, allTools, hasAgent, }: {
     provider: any;
     allTools: T[];
     hasAgent: boolean;
-    interactive: boolean;
 }) => T[];
 export { getAvailableTools }
 export { getAvailableTools as getAvailableTools_alias_1 }
@@ -1047,7 +957,7 @@ export declare const getString: <T extends string>(args: Partial<Record<T, strin
 
 export declare const getStringArray: <T extends string>(args: Partial<Record<T, ToolParameterValue>>, name: T, defaultValue?: string[]) => string[];
 
-export declare const handler: ToolHandler<typeof toolInfo, CommandProvider>;
+export declare const handler: ToolHandler<typeof toolInfo, InteractionProvider>;
 
 export declare const handler_alias_1: ToolHandler<typeof toolInfo_alias_1, InteractionProvider>;
 
@@ -1059,17 +969,15 @@ export declare const handler_alias_12: ToolHandler<typeof toolInfo_alias_12, Fil
 
 export declare const handler_alias_13: ToolHandler<typeof toolInfo_alias_13, FilesystemProvider>;
 
-export declare const handler_alias_14: ToolHandler<typeof toolInfo_alias_14, FilesystemProvider>;
-
-export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, InteractionProvider>;
+export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, any>;
 
-export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, any>;
+export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, CommandProvider>;
 
-export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, CommandProvider>;
+export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, WebProvider>;
 
-export declare const handler_alias_5: ToolHandler<typeof toolInfo_alias_5, WebProvider>;
+export declare const handler_alias_5: ToolHandler<typeof toolInfo_alias_5, any>;
 
-export declare const handler_alias_6: ToolHandler<typeof toolInfo_alias_6, any>;
+export declare const handler_alias_6: ToolHandler<typeof toolInfo_alias_6, FilesystemProvider>;
 
 export declare const handler_alias_7: ToolHandler<typeof toolInfo_alias_7, FilesystemProvider>;
 
@@ -1084,18 +992,6 @@ declare type Input = {
     branchName: string;
 };
 
-declare type Input_2 = {
-    pullRequestTitle?: string;
-    pullRequestDescription?: string;
-    commitMessages?: string;
-    commitRange?: string;
-    staged?: boolean;
-    changedFiles?: Array<{
-        path: string;
-        status: string;
-    }>;
-};
-
 declare type InputType = {
     $: Record<string, Record<string, Json>>;
     [key: string]: Json;
@@ -1109,9 +1005,9 @@ export { InteractionProvider }
 export { InteractionProvider as InteractionProvider_alias_1 }
 export { InteractionProvider as InteractionProvider_alias_2 }
 
-export declare const isAvailable: (provider: CommandProvider) => boolean;
+export declare const isAvailable: (provider: InteractionProvider) => boolean;
 
-export declare const isAvailable_alias_1: (provider: InteractionProvider) => boolean;
+export declare const isAvailable_alias_1: (_provider: InteractionProvider) => boolean;
 
 export declare const isAvailable_alias_10: (provider: FilesystemProvider) => boolean;
 
@@ -1121,17 +1017,15 @@ export declare const isAvailable_alias_12: (provider: FilesystemProvider) => boo
 
 export declare const isAvailable_alias_13: (provider: FilesystemProvider) => boolean;
 
-export declare const isAvailable_alias_14: (provider: FilesystemProvider) => boolean;
-
-export declare const isAvailable_alias_2: (_provider: InteractionProvider) => boolean;
+export declare const isAvailable_alias_2: (_provider: any) => boolean;
 
-export declare const isAvailable_alias_3: (_provider: any) => boolean;
+export declare const isAvailable_alias_3: (provider: CommandProvider) => boolean;
 
-export declare const isAvailable_alias_4: (provider: CommandProvider) => boolean;
+export declare const isAvailable_alias_4: (provider: WebProvider) => boolean;
 
-export declare const isAvailable_alias_5: (provider: WebProvider) => boolean;
+export declare const isAvailable_alias_5: (_provider: any) => boolean;
 
-export declare const isAvailable_alias_6: (_provider: any) => boolean;
+export declare const isAvailable_alias_6: (provider: FilesystemProvider) => boolean;
 
 export declare const isAvailable_alias_7: (provider: FilesystemProvider) => boolean;
 
@@ -1229,11 +1123,6 @@ declare type Output = {
     description: string;
 };
 
-declare type Output_2 = {
-    overview: string;
-    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>;
@@ -1314,11 +1203,10 @@ export { parseAssistantMessage }
 export { parseAssistantMessage as parseAssistantMessage_alias_1 }
 export { parseAssistantMessage as parseAssistantMessage_alias_2 }
 
-/**
- * Parse a unified diff hunk header
- * Format: @@ -oldStart,oldCount +newStart,newCount @@ optional context
- */
-export declare function parseHunkHeader(header: string): DiffHunk | null;
+declare const parseJsonFromMarkdown: (markdown: string) => any;
+export { parseJsonFromMarkdown }
+export { parseJsonFromMarkdown as parseJsonFromMarkdown_alias_1 }
+export { parseJsonFromMarkdown as parseJsonFromMarkdown_alias_2 }
 
 declare enum Policies {
     TruncateContext = "truncatecontext",
@@ -1329,8 +1217,8 @@ export { Policies as Policies_alias_1 }
 
 declare const replaceInFile_2: (fileContent: string, diff: string) => ReplaceResult;
 export { replaceInFile_2 as replaceInFileHelper }
+export { replaceInFile_2 as replaceInFile_alias_2 }
 export { replaceInFile_2 as replaceInFile_alias_3 }
-export { replaceInFile_2 as replaceInFile_alias_4 }
 
 declare type ReplaceResult = {
     content: string;
@@ -1358,37 +1246,16 @@ 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>>;
+declare const resume: <TInput extends Record<string, Json>, TOutput extends Record<string, Json>>(workflow: WorkflowSpec<TInput, TOutput>, 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: {
-    pullRequestTitle?: string;
-    pullRequestDescription?: string;
-    commitMessages?: string;
-    commitRange?: string;
-    staged?: boolean;
-    changedFiles?: Array<{
-        path: string;
-        status: string;
-    }>;
-}) => Promise<{
-    overview: string;
-    specificReviews: {
-        file: string;
-        lines: string;
-        review: string;
-    }[];
-}>;
-export { reviewDiff }
-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>>;
+declare const run: <TInput extends Record<string, Json>, TOutput extends Record<string, Json>>(workflow: WorkflowSpec<TInput, TOutput>, 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 }
@@ -1413,7 +1280,6 @@ declare type SharedAgentOptions = {
     ai: LanguageModelV2;
     os: string;
     provider: ToolProvider;
-    interactive: boolean;
     additionalTools?: FullToolInfoV2[];
     customInstructions?: string[];
     scripts?: Record<string, string | {
@@ -1434,11 +1300,10 @@ export { SharedAgentOptions }
 export { SharedAgentOptions as SharedAgentOptions_alias_1 }
 export { SharedAgentOptions as SharedAgentOptions_alias_2 }
 
-declare type SpecificReview = {
-    file: string;
-    lines: string;
-    review: string;
-};
+declare function step<TInput extends Record<string, Json>, TOutput extends Record<string, Json>>(id: string, run: CustomStepSpec<TInput, TOutput>['run']): CustomStepSpec<TInput, TOutput>;
+export { step }
+export { step as step_alias_1 }
+export { step as step_alias_2 }
 
 declare type StepRunResult<T extends Record<string, Json>> = StepRunResultSuccess<T> | StepRunResultPaused | StepRunResultError;
 export { StepRunResult }
@@ -1471,13 +1336,10 @@ 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[];
-    };
+    build(): BaseStepSpec<TInput, TOutput>;
     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>>(spec: CustomStepSpec<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>;
 }
@@ -1737,18 +1599,6 @@ export { ToolInfo }
 export { ToolInfo as ToolInfo_alias_1 }
 
 export declare const toolInfo: {
-    readonly name: "git_diff";
-    readonly description: "Get the git diff for the current repository. Can be used to get staged changes, unstaged changes, or changes between commits. By default, it returns unstaged changes.";
-    readonly parameters: z.ZodObject<{
-        staged: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
-        commitRange: 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>;
-};
-
-export declare const toolInfo_alias_1: {
     readonly name: "ask_followup_question";
     readonly description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.";
     readonly parameters: z.ZodObject<{
@@ -1759,15 +1609,15 @@ export declare const toolInfo_alias_1: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_10: {
-    readonly name: "remove_file";
-    readonly description: "Request to remove a file at the specified path.";
+export declare const toolInfo_alias_1: {
+    readonly name: "attempt_completion";
+    readonly description: "Use this tool when you believe the user’s requested task is complete. Indicate that your work is finished, but acknowledge the user may still provide additional instructions or questions if they want to continue. This tool MUST NOT to be used with any other tool.";
     readonly parameters: z.ZodObject<{
-        path: z.ZodString;
+        result: z.ZodString;
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_11: {
+export declare const toolInfo_alias_10: {
     readonly name: "rename_file";
     readonly description: "Request to rename a file from source path to target path.";
     readonly parameters: z.ZodObject<{
@@ -1776,7 +1626,7 @@ export declare const toolInfo_alias_11: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_12: {
+export declare const toolInfo_alias_11: {
     readonly name: "replace_in_file";
     readonly description: "Request to replace sections of content in an existing file using SEARCH/REPLACE blocks that define exact changes to specific parts of the file. This tool should be used when you need to make targeted changes to specific parts of a file.";
     readonly parameters: z.ZodObject<{
@@ -1785,7 +1635,7 @@ export declare const toolInfo_alias_12: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_13: {
+export declare const toolInfo_alias_12: {
     readonly name: "search_files";
     readonly description: "Request to perform a regex search across files in a specified directory, outputting context-rich results that include surrounding lines. This tool searches for patterns or specific content across multiple files, displaying each match with encapsulating context.";
     readonly parameters: z.ZodObject<{
@@ -1795,7 +1645,7 @@ export declare const toolInfo_alias_13: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_14: {
+export declare const toolInfo_alias_13: {
     readonly name: "write_to_file";
     readonly description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.";
     readonly parameters: z.ZodObject<{
@@ -1805,14 +1655,6 @@ export declare const toolInfo_alias_14: {
 };
 
 export declare const toolInfo_alias_2: {
-    readonly name: "attempt_completion";
-    readonly description: "Use this tool when you believe the user’s requested task is complete. Indicate that your work is finished, but acknowledge the user may still provide additional instructions or questions if they want to continue. This tool MUST NOT to be used with any other tool.";
-    readonly parameters: z.ZodObject<{
-        result: z.ZodString;
-    }, z.core.$strip>;
-};
-
-export declare const toolInfo_alias_3: {
     readonly name: "delegate";
     readonly description: "Temporarily delegate a task to another agent and receive the result back. This tool MUST NOT to be used with any other tool.";
     readonly parameters: z.ZodObject<{
@@ -1823,7 +1665,7 @@ export declare const toolInfo_alias_3: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_4: {
+export declare const toolInfo_alias_3: {
     readonly name: "execute_command";
     readonly description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.";
     readonly parameters: z.ZodObject<{
@@ -1832,7 +1674,7 @@ export declare const toolInfo_alias_4: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_5: {
+export declare const toolInfo_alias_4: {
     readonly name: "fetch_url";
     readonly description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.";
     readonly parameters: z.ZodObject<{
@@ -1840,7 +1682,7 @@ export declare const toolInfo_alias_5: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_6: {
+export declare const toolInfo_alias_5: {
     readonly name: "hand_over";
     readonly description: "Hand over the current task to another agent to complete. This tool MUST NOT to be used with any other tool.";
     readonly parameters: z.ZodObject<{
@@ -1851,7 +1693,7 @@ export declare const toolInfo_alias_6: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_7: {
+export declare const toolInfo_alias_6: {
     readonly name: "list_files";
     readonly description: "Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.";
     readonly parameters: z.ZodObject<{
@@ -1862,7 +1704,7 @@ export declare const toolInfo_alias_7: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_8: {
+export declare const toolInfo_alias_7: {
     readonly name: "read_binary_file";
     readonly description: "Read a binary file from a URL or local path. Use file:// prefix to access local files. This can be used to access non-text files such as PDFs or images.";
     readonly parameters: z.ZodObject<{
@@ -1870,7 +1712,7 @@ export declare const toolInfo_alias_8: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_9: {
+export declare const toolInfo_alias_8: {
     readonly name: "read_file";
     readonly description: "Request to read the contents of one or multiple files at the specified paths. Use comma separated paths to read multiple files. Use this when you need to examine the contents of an existing file you do not know the contents of, for example to analyze code, review text files, or extract information from configuration files. May not be suitable for other types of binary files, as it returns the raw content as a string. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
     readonly parameters: z.ZodObject<{
@@ -1879,6 +1721,14 @@ export declare const toolInfo_alias_9: {
     }, z.core.$strip>;
 };
 
+export declare const toolInfo_alias_9: {
+    readonly name: "remove_file";
+    readonly description: "Request to remove a file at the specified path.";
+    readonly parameters: z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strip>;
+};
+
 declare type ToolInfoV2 = {
     name: string;
     description: string;
@@ -2056,6 +1906,7 @@ declare type Totals = {
     output: number;
     cachedRead: number;
     cost: number;
+    messageCount: number;
 };
 
 export declare function toToolInfoV1(tool: FullToolInfoV2): FullToolInfo;
@@ -2089,10 +1940,8 @@ declare class UsageMeter {
         modelInfo?: ModelInfo;
     }): void;
     /** Override the running totals (e.g., restore from saved state). */
-    setUsage(newUsage: Partial<Totals & {
-        calls: number;
-    }>): void;
-    /** Manually bump the message count (useful if you record some calls without token info). */
+    setUsage(newUsage: Partial<Totals>): void;
+    /** Manually bump the message count (useful if you record some messages without token info). */
     incrementMessageCount(n?: number): void;
     /** Reset the running totals. */
     resetUsage(): void;
@@ -2108,11 +1957,11 @@ declare class UsageMeter {
     checkLimit(): void;
     /** Getter for the aggregated totals (immutable copy). */
     get usage(): {
-        messageCount: number;
         input: number;
         output: number;
         cachedRead: number;
         cost: number;
+        messageCount: number;
     };
     /** Print a concise usage summary to console. */
     printUsage(customConsole?: Console): void;
@@ -2134,6 +1983,8 @@ export { WebProvider as WebProvider_alias_2 }
 declare type WorkflowContext = {
     provider: ToolProvider;
     parameters: Record<string, any>;
+    verbose?: number;
+    agentCallback?: TaskEventCallback;
 };
 export { WorkflowContext }
 export { WorkflowContext as WorkflowContext_alias_1 }
@@ -2168,10 +2019,10 @@ 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>> {
+declare interface WorkflowSpec<TInput extends Record<string, Json> = Record<string, Json>, TOutput extends Record<string, Json> = Record<string, Json>> {
     name: string;
     description?: string;
-    step: TStepSpec;
+    step: BaseStepSpec<TInput, TOutput>;
 }
 export { WorkflowSpec }
 export { WorkflowSpec as WorkflowSpec_alias_1 }