@marktoflow/integrations 2.0.0-alpha.12

package/dist/adapters/codex-workflow.js

@@ -0,0 +1,470 @@
+/**
+ * OpenAI Codex Workflow Actions for marktoflow
+ *
+ * Provides workflow action handlers that expose the full Codex SDK
+ * capabilities to markdown workflows, including:
+ * - Code generation and modification
+ * - Web search and research
+ * - Command execution
+ * - Structured output
+ * - Thread management (resume conversations)
+ */
+import { z } from 'zod';
+import { CodexClient, } from './codex.js';
+// ============================================================================
+// Workflow Action Schemas
+// ============================================================================
+/**
+ * Schema for codex.chat action
+ */
+export const CodexChatSchema = z.object({
+    prompt: z.string().describe('The message to send to Codex'),
+    model: z.string().optional().describe('Model to use'),
+    workingDirectory: z.string().optional().describe('Working directory for the agent'),
+    reasoningEffort: z
+        .enum(['minimal', 'low', 'medium', 'high', 'xhigh'])
+        .optional()
+        .describe('Model reasoning effort level'),
+    sandboxMode: z
+        .enum(['read-only', 'workspace-write', 'danger-full-access'])
+        .optional()
+        .describe('Sandbox mode for file system access'),
+    webSearch: z.boolean().optional().describe('Enable web search'),
+    threadId: z.string().optional().describe('Thread ID to resume'),
+});
+/**
+ * Schema for codex.codeModify action
+ */
+export const CodexCodeModifySchema = z.object({
+    prompt: z.string().describe('Code modification request'),
+    workingDirectory: z.string().optional().describe('Working directory'),
+    additionalDirectories: z.array(z.string()).optional().describe('Additional directories to access'),
+    excludeFiles: z.array(z.string()).optional().describe('Files to exclude from context'),
+    reasoningEffort: z
+        .enum(['minimal', 'low', 'medium', 'high', 'xhigh'])
+        .optional()
+        .describe('Reasoning effort level'),
+});
+/**
+ * Schema for codex.codeAnalyze action
+ */
+export const CodexCodeAnalyzeSchema = z.object({
+    prompt: z.string().describe('Code analysis request'),
+    workingDirectory: z.string().optional().describe('Working directory'),
+    additionalDirectories: z.array(z.string()).optional().describe('Additional directories to access'),
+    excludeFiles: z.array(z.string()).optional().describe('Files to exclude from context'),
+});
+/**
+ * Schema for codex.codeReview action
+ */
+export const CodexCodeReviewSchema = z.object({
+    prompt: z.string().describe('Code review request'),
+    files: z.array(z.string()).optional().describe('Files to review'),
+    focusAreas: z
+        .array(z.string())
+        .optional()
+        .describe('Areas to focus on (security, performance, quality)'),
+    workingDirectory: z.string().optional().describe('Working directory'),
+});
+/**
+ * Schema for codex.webSearch action
+ */
+export const CodexWebSearchSchema = z.object({
+    prompt: z.string().describe('Research query'),
+    searchMode: z.enum(['cached', 'live']).optional().describe('Web search mode'),
+});
+/**
+ * Schema for codex.execute action
+ */
+export const CodexExecuteSchema = z.object({
+    prompt: z.string().describe('Command execution request'),
+    workingDirectory: z.string().optional().describe('Working directory'),
+    approvalPolicy: z
+        .enum(['never', 'on-request', 'on-failure', 'untrusted'])
+        .optional()
+        .describe('Command approval policy'),
+});
+/**
+ * Schema for codex.structured action
+ */
+export const CodexStructuredSchema = z.object({
+    prompt: z.string().describe('Task for structured output'),
+    schema: z.record(z.unknown()).describe('JSON schema for output'),
+    workingDirectory: z.string().optional().describe('Working directory'),
+});
+/**
+ * Schema for codex.resume action
+ */
+export const CodexResumeSchema = z.object({
+    threadId: z.string().describe('Thread ID to resume'),
+    prompt: z.string().describe('Follow-up message'),
+    workingDirectory: z.string().optional().describe('Working directory'),
+});
+/**
+ * Schema for codex.withImages action
+ */
+export const CodexWithImagesSchema = z.object({
+    prompt: z.string().describe('Task with images'),
+    images: z.array(z.string()).describe('Paths to local images'),
+    workingDirectory: z.string().optional().describe('Working directory'),
+});
+// ============================================================================
+// Workflow Action Handlers
+// ============================================================================
+/**
+ * Create workflow-compatible Codex action handlers
+ *
+ * Returns an object with methods that can be called from workflow actions:
+ * - codex.chat
+ * - codex.codeModify
+ * - codex.codeAnalyze
+ * - codex.codeReview
+ * - codex.webSearch
+ * - codex.execute
+ * - codex.structured
+ * - codex.resume
+ * - codex.withImages
+ */
+export function createCodexActions(clientConfig) {
+    const client = new CodexClient(clientConfig);
+    return {
+        /**
+         * Send a chat message to Codex
+         *
+         * Usage in workflow:
+         * ```yaml
+         * action: codex.chat
+         * inputs:
+         *   prompt: "Explain how this codebase works"
+         *   workingDirectory: ./src
+         *   reasoningEffort: medium
+         * ```
+         */
+        async chat(inputs) {
+            const parsed = CodexChatSchema.parse(inputs);
+            const threadOptions = {
+                model: parsed.model,
+                workingDirectory: parsed.workingDirectory || process.cwd(),
+                modelReasoningEffort: parsed.reasoningEffort,
+                sandboxMode: parsed.sandboxMode || 'workspace-write',
+                skipGitRepoCheck: true,
+            };
+            if (parsed.webSearch) {
+                threadOptions.webSearchMode = 'live';
+                threadOptions.networkAccessEnabled = true;
+            }
+            if (parsed.threadId) {
+                return client.resumeAndSend(parsed.threadId, parsed.prompt, threadOptions);
+            }
+            return client.sendWithThread(parsed.prompt, threadOptions);
+        },
+        /**
+         * Modify code with Codex assistance
+         *
+         * Usage in workflow:
+         * ```yaml
+         * action: codex.codeModify
+         * inputs:
+         *   prompt: "Add TypeScript types to all functions"
+         *   workingDirectory: ./src
+         *   reasoningEffort: high
+         * ```
+         */
+        async codeModify(inputs) {
+            const parsed = CodexCodeModifySchema.parse(inputs);
+            return client.modifyCode({
+                prompt: parsed.prompt,
+                workingDirectory: parsed.workingDirectory,
+                additionalDirectories: parsed.additionalDirectories,
+                excludeFiles: parsed.excludeFiles,
+                reasoningEffort: parsed.reasoningEffort,
+            });
+        },
+        /**
+         * Analyze code without making changes
+         *
+         * Usage in workflow:
+         * ```yaml
+         * action: codex.codeAnalyze
+         * inputs:
+         *   prompt: "Explain the architecture of this project"
+         *   workingDirectory: ./
+         * ```
+         */
+        async codeAnalyze(inputs) {
+            const parsed = CodexCodeAnalyzeSchema.parse(inputs);
+            return client.analyzeCode({
+                prompt: parsed.prompt,
+                workingDirectory: parsed.workingDirectory,
+                additionalDirectories: parsed.additionalDirectories,
+                excludeFiles: parsed.excludeFiles,
+            });
+        },
+        /**
+         * Perform a code review
+         *
+         * Usage in workflow:
+         * ```yaml
+         * action: codex.codeReview
+         * inputs:
+         *   prompt: "Review for security issues"
+         *   files:
+         *     - src/auth.ts
+         *     - src/api.ts
+         *   focusAreas: [security, performance]
+         * ```
+         */
+        async codeReview(inputs) {
+            const parsed = CodexCodeReviewSchema.parse(inputs);
+            const focusAreas = parsed.focusAreas || [
+                'security',
+                'performance',
+                'quality',
+                'maintainability',
+            ];
+            let prompt = parsed.prompt;
+            if (parsed.files && parsed.files.length > 0) {
+                prompt += `\n\nFiles to review:\n${parsed.files.map((f) => `- ${f}`).join('\n')}`;
+            }
+            prompt += `\n\nFocus areas: ${focusAreas.join(', ')}`;
+            prompt += `\n\nFor each issue found, provide:
+- File path and line number (if applicable)
+- Severity: critical, high, medium, low
+- Category: ${focusAreas.join(', ')}
+- Clear description
+- Suggested fix`;
+            return client.analyzeCode({
+                prompt,
+                workingDirectory: parsed.workingDirectory,
+            });
+        },
+        /**
+         * Perform web research
+         *
+         * Usage in workflow:
+         * ```yaml
+         * action: codex.webSearch
+         * inputs:
+         *   prompt: "Find best practices for React hooks"
+         *   searchMode: live
+         * ```
+         */
+        async webSearch(inputs) {
+            const parsed = CodexWebSearchSchema.parse(inputs);
+            return client.webSearch({
+                prompt: parsed.prompt,
+                searchMode: parsed.searchMode,
+            });
+        },
+        /**
+         * Execute commands via the agent
+         *
+         * Usage in workflow:
+         * ```yaml
+         * action: codex.execute
+         * inputs:
+         *   prompt: "Run the test suite and fix any failing tests"
+         *   workingDirectory: ./
+         *   approvalPolicy: never
+         * ```
+         */
+        async execute(inputs) {
+            const parsed = CodexExecuteSchema.parse(inputs);
+            return client.executeCommands({
+                prompt: parsed.prompt,
+                workingDirectory: parsed.workingDirectory,
+                approvalPolicy: parsed.approvalPolicy,
+            });
+        },
+        /**
+         * Get structured JSON output
+         *
+         * Usage in workflow:
+         * ```yaml
+         * action: codex.structured
+         * inputs:
+         *   prompt: "List all exported functions in this file"
+         *   schema:
+         *     type: object
+         *     properties:
+         *       functions:
+         *         type: array
+         *         items:
+         *           type: object
+         *           properties:
+         *             name: { type: string }
+         *             parameters: { type: array, items: { type: string } }
+         *             returnType: { type: string }
+         * ```
+         */
+        async structured(inputs) {
+            const parsed = CodexStructuredSchema.parse(inputs);
+            return client.sendStructured({
+                prompt: parsed.prompt,
+                schema: parsed.schema,
+                threadOptions: {
+                    workingDirectory: parsed.workingDirectory,
+                    skipGitRepoCheck: true,
+                },
+            });
+        },
+        /**
+         * Resume a previous thread
+         *
+         * Usage in workflow:
+         * ```yaml
+         * action: codex.resume
+         * inputs:
+         *   threadId: "{{ previous_result.threadId }}"
+         *   prompt: "Now add unit tests for those functions"
+         * ```
+         */
+        async resume(inputs) {
+            const parsed = CodexResumeSchema.parse(inputs);
+            return client.resumeAndSend(parsed.threadId, parsed.prompt, {
+                workingDirectory: parsed.workingDirectory,
+                skipGitRepoCheck: true,
+            });
+        },
+        /**
+         * Send with local images
+         *
+         * Usage in workflow:
+         * ```yaml
+         * action: codex.withImages
+         * inputs:
+         *   prompt: "Implement this UI based on the mockup"
+         *   images:
+         *     - ./mockups/dashboard.png
+         *     - ./mockups/sidebar.png
+         * ```
+         */
+        async withImages(inputs) {
+            const parsed = CodexWithImagesSchema.parse(inputs);
+            const input = [
+                { type: 'text', text: parsed.prompt },
+                ...parsed.images.map((path) => ({
+                    type: 'local_image',
+                    path,
+                })),
+            ];
+            return client.sendWithThread(input, {
+                workingDirectory: parsed.workingDirectory,
+                skipGitRepoCheck: true,
+                sandboxMode: 'workspace-write',
+            });
+        },
+        /**
+         * Stream a response (for use in handlers that support streaming)
+         *
+         * Usage programmatically:
+         * ```typescript
+         * const actions = createCodexActions();
+         * await actions.stream({
+         *   prompt: "Explain this code",
+         *   onChunk: (chunk) => console.log(chunk),
+         * });
+         * ```
+         */
+        async stream(inputs) {
+            return client.stream({
+                prompt: inputs.prompt,
+                threadOptions: inputs.threadOptions,
+                turnOptions: inputs.turnOptions,
+                onChunk: inputs.onChunk,
+            });
+        },
+        /**
+         * Get the last thread ID (for resuming later)
+         */
+        getLastThreadId() {
+            return client.getLastThreadId();
+        },
+        /**
+         * Get the underlying client for advanced use
+         */
+        getClient() {
+            return client;
+        },
+    };
+}
+// ============================================================================
+// Preset Configurations
+// ============================================================================
+/**
+ * Preset thread configurations for common tasks
+ */
+export const CodexPresetConfigs = {
+    /**
+     * Read-only analysis - safe for reviewing code
+     */
+    readOnly: {
+        sandboxMode: 'read-only',
+        skipGitRepoCheck: true,
+        modelReasoningEffort: 'medium',
+    },
+    /**
+     * Code modification - can write to workspace
+     */
+    codeModification: {
+        sandboxMode: 'workspace-write',
+        skipGitRepoCheck: true,
+        modelReasoningEffort: 'high',
+    },
+    /**
+     * Full access - can execute commands
+     */
+    fullAccess: {
+        sandboxMode: 'danger-full-access',
+        skipGitRepoCheck: true,
+        approvalPolicy: 'never',
+        networkAccessEnabled: true,
+    },
+    /**
+     * Research mode - web search enabled
+     */
+    research: {
+        webSearchMode: 'live',
+        networkAccessEnabled: true,
+        skipGitRepoCheck: true,
+        sandboxMode: 'read-only',
+    },
+    /**
+     * High reasoning - for complex tasks
+     */
+    highReasoning: {
+        modelReasoningEffort: 'xhigh',
+        skipGitRepoCheck: true,
+        sandboxMode: 'workspace-write',
+    },
+};
+/**
+ * Preset prompts for common code review tasks
+ */
+export const CodexReviewPrompts = {
+    security: `Review this code for security vulnerabilities including:
+- Injection attacks (SQL, XSS, command injection)
+- Authentication and authorization issues
+- Data exposure and privacy concerns
+- Cryptographic weaknesses
+- OWASP Top 10 vulnerabilities`,
+    performance: `Review this code for performance issues including:
+- Algorithm complexity (time and space)
+- Database query optimization
+- Memory leaks
+- Unnecessary computations
+- Caching opportunities`,
+    quality: `Review this code for quality issues including:
+- Code duplication
+- Complex functions that should be split
+- Poor naming conventions
+- Missing error handling
+- Lack of documentation`,
+    typescript: `Review this TypeScript code for type safety including:
+- Missing type annotations
+- Use of 'any' type
+- Incorrect type assertions
+- Missing null checks
+- Generic type improvements`,
+};
+//# sourceMappingURL=codex-workflow.js.map

package/dist/adapters/codex-workflow.js.map

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

package/dist/adapters/codex.d.ts

@@ -0,0 +1,154 @@
+/**
+ * OpenAI Codex SDK Adapter for marktoflow
+ *
+ * This adapter provides integration with the OpenAI Codex SDK,
+ * enabling AI-powered coding workflows with file changes, command execution,
+ * web search, structured output, and streaming capabilities.
+ */
+import { Codex, type Thread, type Input } from '@openai/codex-sdk';
+import { SDKInitializer } from '@marktoflow/core';
+import type { CodexClientConfig, CodexThreadOptions, CodexTurnOptions, CodexResult, CodexStreamCallback } from './codex-types.js';
+/**
+ * Extended configuration for the CodexClient wrapper
+ */
+export interface CodexClientOptions extends CodexClientConfig {
+    /** Default thread options */
+    defaultThreadOptions?: CodexThreadOptions;
+}
+/**
+ * Client for interacting with OpenAI Codex via the SDK
+ *
+ * Provides multiple interfaces for different use cases:
+ * - send(): Simple prompt-response
+ * - stream(): Streaming responses with callbacks
+ * - sendWithThread(): Full thread control
+ * - resumeThread(): Continue previous conversations
+ */
+export declare class CodexClient {
+    private codex;
+    private defaultThreadOptions;
+    private activeThread;
+    private lastThreadId;
+    constructor(config?: CodexClientOptions);
+    /**
+     * Send a message and wait for the complete response
+     */
+    send(inputs: {
+        prompt: string | Input;
+        threadOptions?: CodexThreadOptions;
+        turnOptions?: CodexTurnOptions;
+    }): Promise<string>;
+    /**
+     * Send a message and stream the response
+     */
+    stream(inputs: {
+        prompt: string | Input;
+        threadOptions?: CodexThreadOptions;
+        turnOptions?: CodexTurnOptions;
+        onChunk?: (chunk: string) => void;
+        onEvent?: CodexStreamCallback;
+        onComplete?: (result: CodexResult) => void;
+    }): Promise<CodexResult>;
+    /**
+     * Send a message with full thread configuration
+     */
+    sendWithThread(message: string | Input, threadOptions?: CodexThreadOptions, turnOptions?: CodexTurnOptions): Promise<CodexResult>;
+    /**
+     * Stream with full thread configuration
+     */
+    streamWithThread(message: string | Input, callback: CodexStreamCallback, threadOptions?: CodexThreadOptions, turnOptions?: CodexTurnOptions): Promise<CodexResult>;
+    /**
+     * Resume a previous thread and send a message
+     */
+    resumeAndSend(threadId: string, message: string | Input, threadOptions?: CodexThreadOptions, turnOptions?: CodexTurnOptions): Promise<CodexResult>;
+    /**
+     * Resume a thread and stream the response
+     */
+    resumeAndStream(threadId: string, message: string | Input, callback: CodexStreamCallback, threadOptions?: CodexThreadOptions, turnOptions?: CodexTurnOptions): Promise<CodexResult>;
+    /**
+     * Create a new thread for multi-turn conversations
+     */
+    startThread(options?: CodexThreadOptions): Thread;
+    /**
+     * Resume an existing thread
+     */
+    resumeThread(threadId: string, options?: CodexThreadOptions): Thread;
+    /**
+     * Get the last thread ID
+     */
+    getLastThreadId(): string | null;
+    /**
+     * Get the active thread
+     */
+    getActiveThread(): Thread | null;
+    /**
+     * Send with structured JSON output
+     */
+    sendStructured<T>(inputs: {
+        prompt: string | Input;
+        schema: unknown;
+        threadOptions?: CodexThreadOptions;
+    }): Promise<T>;
+    /**
+     * Execute code modifications
+     */
+    modifyCode(inputs: {
+        prompt: string;
+        workingDirectory?: string;
+        additionalDirectories?: string[];
+        excludeFiles?: string[];
+        reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+    }): Promise<CodexResult>;
+    /**
+     * Execute shell commands via the agent
+     */
+    executeCommands(inputs: {
+        prompt: string;
+        workingDirectory?: string;
+        approvalPolicy?: 'never' | 'on-request' | 'on-failure' | 'untrusted';
+    }): Promise<CodexResult>;
+    /**
+     * Perform web research
+     */
+    webSearch(inputs: {
+        prompt: string;
+        searchMode?: 'cached' | 'live';
+    }): Promise<CodexResult>;
+    /**
+     * Analyze code without making changes
+     */
+    analyzeCode(inputs: {
+        prompt: string;
+        workingDirectory?: string;
+        additionalDirectories?: string[];
+        excludeFiles?: string[];
+    }): Promise<CodexResult>;
+    /**
+     * Build thread options from configuration
+     */
+    private buildThreadOptions;
+    /**
+     * OpenAI-compatible chat interface for workflow compatibility
+     */
+    chat: {
+        completions: (inputs: {
+            model?: string;
+            messages: Array<{
+                role: string;
+                content: string;
+            }>;
+        }) => Promise<{
+            choices: Array<{
+                message: {
+                    content: string;
+                };
+            }>;
+        }>;
+    };
+}
+/**
+ * SDK Initializer for OpenAI Codex
+ */
+export declare const CodexInitializer: SDKInitializer;
+export { Codex, Thread };
+//# sourceMappingURL=codex.d.ts.map

package/dist/adapters/codex.d.ts.map

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