@marktoflow/integrations 2.0.0-alpha.12

package/dist/adapters/claude-agent-workflow.d.ts

@@ -0,0 +1,393 @@
+/**
+ * Claude Agent Workflow Actions for marktoflow
+ *
+ * Provides workflow action handlers that expose the full Claude Agent SDK
+ * capabilities to markdown workflows, including:
+ * - Agentic task execution with built-in tools
+ * - Subagent delegation
+ * - Custom MCP tool integration
+ * - Session management
+ * - Streaming with callbacks
+ */
+import { z } from 'zod';
+import { ClaudeAgentClient, ClaudeAgentOptions, BuiltInTool, AgentResult } from './claude-agent.js';
+/**
+ * Schema for agent.run action
+ */
+export declare const AgentRunSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    tools: z.ZodOptional<z.ZodArray<z.ZodEnum<["Read", "Write", "Edit", "Bash", "Glob", "Grep", "WebSearch", "WebFetch", "Task", "TodoWrite"]>, "many">>;
+    model: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permissionMode: z.ZodOptional<z.ZodEnum<["default", "acceptEdits", "bypassPermissions", "plan"]>>;
+    maxTurns: z.ZodOptional<z.ZodNumber>;
+    maxBudgetUsd: z.ZodOptional<z.ZodNumber>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    resume: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    tools?: ("Read" | "Write" | "Edit" | "Bash" | "Glob" | "Grep" | "WebSearch" | "WebFetch" | "Task" | "TodoWrite")[] | undefined;
+    model?: string | undefined;
+    cwd?: string | undefined;
+    permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | undefined;
+    resume?: string | undefined;
+    maxTurns?: number | undefined;
+    maxBudgetUsd?: number | undefined;
+    systemPrompt?: string | undefined;
+}, {
+    prompt: string;
+    tools?: ("Read" | "Write" | "Edit" | "Bash" | "Glob" | "Grep" | "WebSearch" | "WebFetch" | "Task" | "TodoWrite")[] | undefined;
+    model?: string | undefined;
+    cwd?: string | undefined;
+    permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | undefined;
+    resume?: string | undefined;
+    maxTurns?: number | undefined;
+    maxBudgetUsd?: number | undefined;
+    systemPrompt?: string | undefined;
+}>;
+/**
+ * Schema for agent.codeReview action
+ */
+export declare const AgentCodeReviewSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    focusAreas: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    severity: z.ZodOptional<z.ZodEnum<["all", "critical", "high", "medium"]>>;
+    outputFormat: z.ZodOptional<z.ZodEnum<["markdown", "json", "sarif"]>>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    outputFormat?: "json" | "markdown" | "sarif" | undefined;
+    focusAreas?: string[] | undefined;
+    severity?: "medium" | "high" | "all" | "critical" | undefined;
+}, {
+    prompt: string;
+    outputFormat?: "json" | "markdown" | "sarif" | undefined;
+    focusAreas?: string[] | undefined;
+    severity?: "medium" | "high" | "all" | "critical" | undefined;
+}>;
+/**
+ * Schema for agent.codeModify action
+ */
+export declare const AgentCodeModifySchema: z.ZodObject<{
+    prompt: z.ZodString;
+    files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    createBackup: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    files?: string[] | undefined;
+    dryRun?: boolean | undefined;
+    createBackup?: boolean | undefined;
+}, {
+    prompt: string;
+    files?: string[] | undefined;
+    dryRun?: boolean | undefined;
+    createBackup?: boolean | undefined;
+}>;
+/**
+ * Schema for agent.research action
+ */
+export declare const AgentResearchSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    sources: z.ZodOptional<z.ZodArray<z.ZodEnum<["web", "codebase", "docs"]>, "many">>;
+    depth: z.ZodOptional<z.ZodEnum<["quick", "thorough", "comprehensive"]>>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    sources?: ("web" | "codebase" | "docs")[] | undefined;
+    depth?: "quick" | "thorough" | "comprehensive" | undefined;
+}, {
+    prompt: string;
+    sources?: ("web" | "codebase" | "docs")[] | undefined;
+    depth?: "quick" | "thorough" | "comprehensive" | undefined;
+}>;
+/**
+ * Schema for agent.withSubagents action
+ */
+export declare const AgentWithSubagentsSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    agents: z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        prompt: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        tools?: string[] | undefined;
+        model?: "sonnet" | "opus" | "haiku" | undefined;
+        prompt?: string | undefined;
+    }, {
+        description: string;
+        tools?: string[] | undefined;
+        model?: "sonnet" | "opus" | "haiku" | undefined;
+        prompt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    agents: Record<string, {
+        description: string;
+        tools?: string[] | undefined;
+        model?: "sonnet" | "opus" | "haiku" | undefined;
+        prompt?: string | undefined;
+    }>;
+}, {
+    prompt: string;
+    agents: Record<string, {
+        description: string;
+        tools?: string[] | undefined;
+        model?: "sonnet" | "opus" | "haiku" | undefined;
+        prompt?: string | undefined;
+    }>;
+}>;
+/**
+ * Schema for agent.withMcp action
+ */
+export declare const AgentWithMcpSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    mcpServers: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<["stdio", "http", "sse"]>;
+        command: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        url: z.ZodOptional<z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "http" | "stdio" | "sse";
+        env?: Record<string, string> | undefined;
+        url?: string | undefined;
+        command?: string | undefined;
+        args?: string[] | undefined;
+    }, {
+        type: "http" | "stdio" | "sse";
+        env?: Record<string, string> | undefined;
+        url?: string | undefined;
+        command?: string | undefined;
+        args?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    mcpServers: Record<string, {
+        type: "http" | "stdio" | "sse";
+        env?: Record<string, string> | undefined;
+        url?: string | undefined;
+        command?: string | undefined;
+        args?: string[] | undefined;
+    }>;
+    prompt: string;
+}, {
+    mcpServers: Record<string, {
+        type: "http" | "stdio" | "sse";
+        env?: Record<string, string> | undefined;
+        url?: string | undefined;
+        command?: string | undefined;
+        args?: string[] | undefined;
+    }>;
+    prompt: string;
+}>;
+export type AgentRunInput = z.infer<typeof AgentRunSchema>;
+export type AgentCodeReviewInput = z.infer<typeof AgentCodeReviewSchema>;
+export type AgentCodeModifyInput = z.infer<typeof AgentCodeModifySchema>;
+export type AgentResearchInput = z.infer<typeof AgentResearchSchema>;
+export type AgentWithSubagentsInput = z.infer<typeof AgentWithSubagentsSchema>;
+export type AgentWithMcpInput = z.infer<typeof AgentWithMcpSchema>;
+/**
+ * Create a workflow-compatible Claude Agent client with action handlers
+ *
+ * Returns an object with methods that can be called from workflow actions:
+ * - agent.run
+ * - agent.codeReview
+ * - agent.codeModify
+ * - agent.research
+ * - agent.withSubagents
+ * - agent.withMcp
+ */
+export declare function createAgentActions(baseOptions?: ClaudeAgentOptions): {
+    /**
+     * Run an agentic task with full capabilities
+     *
+     * Usage in workflow:
+     * ```yaml
+     * action: agent.run
+     * inputs:
+     *   prompt: "Find and fix all TypeScript errors"
+     *   tools: [Read, Edit, Bash, Glob]
+     *   permissionMode: acceptEdits
+     * ```
+     */
+    run(inputs: AgentRunInput): Promise<AgentResult>;
+    /**
+     * Perform a comprehensive code review
+     *
+     * Usage in workflow:
+     * ```yaml
+     * action: agent.codeReview
+     * inputs:
+     *   prompt: "Review the authentication module for security issues"
+     *   focusAreas: [security, performance]
+     *   outputFormat: json
+     * ```
+     */
+    codeReview(inputs: AgentCodeReviewInput): Promise<AgentResult>;
+    /**
+     * Modify code with agent assistance
+     *
+     * Usage in workflow:
+     * ```yaml
+     * action: agent.codeModify
+     * inputs:
+     *   prompt: "Add TypeScript types to all function parameters"
+     *   files: [src/utils.ts, src/helpers.ts]
+     *   dryRun: false
+     * ```
+     */
+    codeModify(inputs: AgentCodeModifyInput): Promise<AgentResult>;
+    /**
+     * Research a topic using web and codebase
+     *
+     * Usage in workflow:
+     * ```yaml
+     * action: agent.research
+     * inputs:
+     *   prompt: "What are the best practices for error handling in TypeScript?"
+     *   sources: [web, codebase]
+     *   depth: thorough
+     * ```
+     */
+    research(inputs: AgentResearchInput): Promise<AgentResult>;
+    /**
+     * Orchestrate multiple specialized subagents
+     *
+     * Usage in workflow:
+     * ```yaml
+     * action: agent.withSubagents
+     * inputs:
+     *   prompt: "Analyze and improve the API module"
+     *   agents:
+     *     analyzer:
+     *       description: "Analyze code structure"
+     *       tools: [Read, Glob, Grep]
+     *     improver:
+     *       description: "Suggest and implement improvements"
+     *       tools: [Read, Edit, Write]
+     * ```
+     */
+    withSubagents(inputs: AgentWithSubagentsInput): Promise<AgentResult>;
+    /**
+     * Run with external MCP servers
+     *
+     * Usage in workflow:
+     * ```yaml
+     * action: agent.withMcp
+     * inputs:
+     *   prompt: "Open the browser and navigate to example.com"
+     *   mcpServers:
+     *     playwright:
+     *       type: stdio
+     *       command: npx
+     *       args: ["@playwright/mcp@latest"]
+     * ```
+     */
+    withMcp(inputs: AgentWithMcpInput): Promise<AgentResult>;
+    /**
+     * Generate a simple response (backwards compatible)
+     */
+    generate(inputs: {
+        prompt: string;
+        model?: string;
+    } | string): Promise<string>;
+    /**
+     * Resume a previous session
+     */
+    resume(inputs: {
+        sessionId: string;
+        prompt: string;
+    }): Promise<AgentResult>;
+    /**
+     * Get the underlying client for advanced use
+     */
+    getClient(): ClaudeAgentClient;
+};
+/**
+ * Preset subagent configurations for common tasks
+ */
+export declare const PresetSubagents: {
+    /**
+     * Code review team
+     */
+    codeReviewTeam: {
+        'code-reviewer': {
+            description: string;
+            tools: BuiltInTool[];
+            prompt: string;
+        };
+        'security-auditor': {
+            description: string;
+            tools: BuiltInTool[];
+            prompt: string;
+        };
+        'test-analyzer': {
+            description: string;
+            tools: BuiltInTool[];
+            prompt: string;
+        };
+    };
+    /**
+     * Documentation team
+     */
+    documentationTeam: {
+        'doc-writer': {
+            description: string;
+            tools: BuiltInTool[];
+            prompt: string;
+        };
+        'example-creator': {
+            description: string;
+            tools: BuiltInTool[];
+            prompt: string;
+        };
+    };
+    /**
+     * Refactoring team
+     */
+    refactoringTeam: {
+        analyzer: {
+            description: string;
+            tools: BuiltInTool[];
+            prompt: string;
+        };
+        refactorer: {
+            description: string;
+            tools: BuiltInTool[];
+            prompt: string;
+        };
+        verifier: {
+            description: string;
+            tools: BuiltInTool[];
+            prompt: string;
+        };
+    };
+};
+/**
+ * Helper to create workflow-integrated MCP tools
+ *
+ * Example usage:
+ * ```typescript
+ * const dbTool = await createWorkflowTool(
+ *   'query_database',
+ *   'Query the application database',
+ *   z.object({ query: z.string() }),
+ *   async (args) => {
+ *     const result = await db.query(args.query);
+ *     return JSON.stringify(result);
+ *   }
+ * );
+ * ```
+ */
+export declare function createWorkflowTool<T extends z.ZodTypeAny>(name: string, description: string, schema: T, handler: (args: z.infer<T>) => Promise<string>): Promise<unknown>;
+/**
+ * Create an MCP server from workflow tool definitions
+ */
+export declare function createWorkflowMcpServer(name: string, tools: Array<{
+    name: string;
+    description: string;
+    schema: z.ZodTypeAny;
+    handler: (args: unknown) => Promise<string>;
+}>): Promise<unknown>;
+export type AgentActions = ReturnType<typeof createAgentActions>;
+//# sourceMappingURL=claude-agent-workflow.d.ts.map

package/dist/adapters/claude-agent-workflow.d.ts.map

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