@posthog/agent 1.11.0 → 1.13.0

package/dist/src/workflow/steps/research.d.ts

@@ -0,0 +1,3 @@
+import type { WorkflowStepRunner } from '../types.js';
+export declare const researchStep: WorkflowStepRunner;
+//# sourceMappingURL=research.d.ts.map

package/dist/src/workflow/steps/research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../../src/workflow/steps/research.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,eAAO,MAAM,YAAY,EAAE,kBAqJ1B,CAAC"}

package/dist/src/workflow/steps/research.js

@@ -0,0 +1,124 @@
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { RESEARCH_SYSTEM_PROMPT } from '../../agents/research.js';
+import { finalizeStepGitActions } from '../utils.js';
+
+const researchStep = async ({ step, context }) => {
+    const { task, cwd, isCloudMode, options, logger, fileManager, gitManager, promptBuilder, adapter, mcpServers, extractor, emitEvent, } = context;
+    const stepLogger = logger.child('ResearchStep');
+    const existingResearch = await fileManager.readResearch(task.id);
+    if (existingResearch) {
+        stepLogger.info('Research already exists, skipping step', { taskId: task.id });
+        return { status: 'skipped' };
+    }
+    stepLogger.info('Starting research phase', { taskId: task.id });
+    emitEvent(adapter.createStatusEvent('phase_start', { phase: 'research' }));
+    const researchPrompt = await promptBuilder.buildResearchPrompt(task, cwd);
+    const fullPrompt = `${RESEARCH_SYSTEM_PROMPT}\n\n${researchPrompt}`;
+    const baseOptions = {
+        model: step.model,
+        cwd,
+        permissionMode: 'plan',
+        settingSources: ['local'],
+        mcpServers,
+    };
+    const response = query({
+        prompt: fullPrompt,
+        options: { ...baseOptions, ...(options.queryOverrides || {}) },
+    });
+    let researchContent = '';
+    for await (const message of response) {
+        emitEvent(adapter.createRawSDKEvent(message));
+        const transformed = adapter.transform(message);
+        if (transformed) {
+            emitEvent(transformed);
+        }
+        if (message.type === 'assistant' && message.message?.content) {
+            for (const c of message.message.content) {
+                if (c.type === 'text' && c.text) {
+                    researchContent += `${c.text}\n`;
+                }
+            }
+        }
+    }
+    if (researchContent.trim()) {
+        await fileManager.writeResearch(task.id, researchContent.trim());
+        stepLogger.info('Research completed', { taskId: task.id });
+    }
+    await gitManager.addAllPostHogFiles();
+    await finalizeStepGitActions(context, step, {
+        commitMessage: `Research phase for ${task.title}`,
+    });
+    if (extractor && researchContent.trim()) {
+        try {
+            stepLogger.info('Extracting questions from research.md', { taskId: task.id });
+            const parsedQuestions = await extractor.extractQuestions(researchContent);
+            await fileManager.writeQuestions(task.id, {
+                questions: parsedQuestions,
+                answered: false,
+                answers: null,
+            });
+            emitEvent({
+                type: 'artifact',
+                ts: Date.now(),
+                kind: 'research_questions',
+                content: parsedQuestions,
+            });
+            stepLogger.info('Questions extracted successfully', {
+                taskId: task.id,
+                count: parsedQuestions.length,
+            });
+        }
+        catch (error) {
+            stepLogger.error('Failed to extract questions', {
+                taskId: task.id,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            emitEvent({
+                type: 'error',
+                ts: Date.now(),
+                message: `Failed to extract questions: ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+    }
+    else if (!extractor) {
+        stepLogger.warn('Question extractor not available, skipping question extraction. Ensure LLM gateway is configured.');
+        emitEvent({
+            type: 'status',
+            ts: Date.now(),
+            phase: 'extraction_skipped',
+            message: 'Question extraction skipped - extractor not configured',
+        });
+    }
+    if (!isCloudMode) {
+        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research' }));
+        return { status: 'completed', halt: true };
+    }
+    const questionsData = await fileManager.readQuestions(task.id);
+    if (questionsData && !questionsData.answered && extractor && researchContent.trim()) {
+        const researchQuestions = await extractor.extractQuestionsWithAnswers(researchContent);
+        const answers = researchQuestions.map((qa) => ({
+            questionId: qa.id,
+            selectedOption: qa.recommendedAnswer,
+            customInput: qa.justification,
+        }));
+        await fileManager.writeQuestions(task.id, {
+            questions: researchQuestions.map((qa) => ({
+                id: qa.id,
+                question: qa.question,
+                options: qa.options,
+            })),
+            answered: true,
+            answers,
+        });
+        await gitManager.addAllPostHogFiles();
+        await finalizeStepGitActions(context, step, {
+            commitMessage: `Answer research questions for ${task.title}`,
+        });
+        stepLogger.info('Auto-answered research questions', { taskId: task.id });
+    }
+    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research' }));
+    return { status: 'completed' };
+};
+
+export { researchStep };
+//# sourceMappingURL=research.js.map

package/dist/src/workflow/steps/research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.js","sources":["../../../../src/workflow/steps/research.ts"],"sourcesContent":["import { query } from '@anthropic-ai/claude-agent-sdk';\nimport { RESEARCH_SYSTEM_PROMPT } from '../../agents/research.js';\nimport type { ExtractedQuestionWithAnswer } from '../../structured-extraction.js';\nimport type { WorkflowStepRunner } from '../types.js';\nimport { finalizeStepGitActions } from '../utils.js';\n\nexport const researchStep: WorkflowStepRunner = async ({ step, context }) => {\n    const {\n        task,\n        cwd,\n        isCloudMode,\n        options,\n        logger,\n        fileManager,\n        gitManager,\n        promptBuilder,\n        adapter,\n        mcpServers,\n        extractor,\n        emitEvent,\n    } = context;\n\n    const stepLogger = logger.child('ResearchStep');\n\n    const existingResearch = await fileManager.readResearch(task.id);\n    if (existingResearch) {\n        stepLogger.info('Research already exists, skipping step', { taskId: task.id });\n        return { status: 'skipped' };\n    }\n\n    stepLogger.info('Starting research phase', { taskId: task.id });\n    emitEvent(adapter.createStatusEvent('phase_start', { phase: 'research' }));\n\n    const researchPrompt = await promptBuilder.buildResearchPrompt(task, cwd);\n    const fullPrompt = `${RESEARCH_SYSTEM_PROMPT}\\n\\n${researchPrompt}`;\n\n    const baseOptions: Record<string, any> = {\n        model: step.model,\n        cwd,\n        permissionMode: 'plan',\n        settingSources: ['local'],\n        mcpServers,\n    };\n\n    const response = query({\n        prompt: fullPrompt,\n        options: { ...baseOptions, ...(options.queryOverrides || {}) },\n    });\n\n    let researchContent = '';\n    for await (const message of response) {\n        emitEvent(adapter.createRawSDKEvent(message));\n        const transformed = adapter.transform(message);\n        if (transformed) {\n            emitEvent(transformed);\n        }\n        if (message.type === 'assistant' && message.message?.content) {\n            for (const c of message.message.content) {\n                if (c.type === 'text' && c.text) {\n                    researchContent += `${c.text}\\n`;\n                }\n            }\n        }\n    }\n\n    if (researchContent.trim()) {\n        await fileManager.writeResearch(task.id, researchContent.trim());\n        stepLogger.info('Research completed', { taskId: task.id });\n    }\n\n    await gitManager.addAllPostHogFiles();\n    await finalizeStepGitActions(context, step, {\n        commitMessage: `Research phase for ${task.title}`,\n    });\n\n    if (extractor && researchContent.trim()) {\n        try {\n            stepLogger.info('Extracting questions from research.md', { taskId: task.id });\n            const parsedQuestions = await extractor.extractQuestions(researchContent);\n\n            await fileManager.writeQuestions(task.id, {\n                questions: parsedQuestions,\n                answered: false,\n                answers: null,\n            });\n\n            emitEvent({\n                type: 'artifact',\n                ts: Date.now(),\n                kind: 'research_questions',\n                content: parsedQuestions,\n            });\n\n            stepLogger.info('Questions extracted successfully', {\n                taskId: task.id,\n                count: parsedQuestions.length,\n            });\n        } catch (error) {\n            stepLogger.error('Failed to extract questions', {\n                taskId: task.id,\n                error: error instanceof Error ? error.message : String(error),\n            });\n            emitEvent({\n                type: 'error',\n                ts: Date.now(),\n                message: `Failed to extract questions: ${\n                    error instanceof Error ? error.message : String(error)\n                }`,\n            });\n        }\n    } else if (!extractor) {\n        stepLogger.warn(\n            'Question extractor not available, skipping question extraction. Ensure LLM gateway is configured.'\n        );\n        emitEvent({\n            type: 'status',\n            ts: Date.now(),\n            phase: 'extraction_skipped',\n            message: 'Question extraction skipped - extractor not configured',\n        });\n    }\n\n    if (!isCloudMode) {\n        emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research' }));\n        return { status: 'completed', halt: true };\n    }\n\n    const questionsData = await fileManager.readQuestions(task.id);\n    if (questionsData && !questionsData.answered && extractor && researchContent.trim()) {\n        const researchQuestions = await extractor.extractQuestionsWithAnswers(researchContent);\n        const answers = (researchQuestions as ExtractedQuestionWithAnswer[]).map((qa) => ({\n            questionId: qa.id,\n            selectedOption: qa.recommendedAnswer,\n            customInput: qa.justification,\n        }));\n\n        await fileManager.writeQuestions(task.id, {\n            questions: researchQuestions.map((qa) => ({\n                id: qa.id,\n                question: qa.question,\n                options: qa.options,\n            })),\n            answered: true,\n            answers,\n        });\n\n        await gitManager.addAllPostHogFiles();\n        await finalizeStepGitActions(context, step, {\n            commitMessage: `Answer research questions for ${task.title}`,\n        });\n        stepLogger.info('Auto-answered research questions', { taskId: task.id });\n    }\n\n    emitEvent(adapter.createStatusEvent('phase_complete', { phase: 'research' }));\n    return { status: 'completed' };\n};\n"],"names":[],"mappings":"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"}

package/dist/src/workflow/types.d.ts

@@ -0,0 +1,48 @@
+import type { Task, TaskExecutionOptions, PermissionMode } from '../types.js';
+import type { Logger } from '../utils/logger.js';
+import type { PostHogFileManager } from '../file-manager.js';
+import type { GitManager } from '../git-manager.js';
+import type { PromptBuilder } from '../prompt-builder.js';
+import type { TaskProgressReporter } from '../task-progress-reporter.js';
+import type { ProviderAdapter } from '../adapters/types.js';
+import type { PostHogAPIClient } from '../posthog-api.js';
+import type { StructuredExtractor } from '../structured-extraction.js';
+export interface WorkflowRuntime {
+    task: Task;
+    taskSlug: string;
+    cwd: string;
+    isCloudMode: boolean;
+    options: TaskExecutionOptions;
+    logger: Logger;
+    fileManager: PostHogFileManager;
+    gitManager: GitManager;
+    promptBuilder: PromptBuilder;
+    progressReporter: TaskProgressReporter;
+    adapter: ProviderAdapter;
+    mcpServers?: Record<string, any>;
+    posthogAPI?: PostHogAPIClient;
+    extractor?: StructuredExtractor;
+    emitEvent: (event: any) => void;
+    stepResults: Record<string, any>;
+}
+export interface WorkflowStepDefinition {
+    id: string;
+    name: string;
+    agent: string;
+    model: string;
+    permissionMode?: PermissionMode | string;
+    commit?: boolean;
+    push?: boolean;
+    run: WorkflowStepRunner;
+}
+export interface WorkflowStepRuntime {
+    step: WorkflowStepDefinition;
+    context: WorkflowRuntime;
+}
+export interface WorkflowStepResult {
+    status: 'completed' | 'skipped';
+    halt?: boolean;
+}
+export type WorkflowStepRunner = (runtime: WorkflowStepRuntime) => Promise<WorkflowStepResult>;
+export type WorkflowDefinition = WorkflowStepDefinition[];
+//# sourceMappingURL=types.d.ts.map

package/dist/src/workflow/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflow/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,EAAE,CAAC"}

package/dist/src/workflow/utils.d.ts

@@ -0,0 +1,12 @@
+import type { WorkflowRuntime, WorkflowStepDefinition } from './types.js';
+interface FinalizeGitOptions {
+    commitMessage: string;
+    allowEmptyCommit?: boolean;
+}
+/**
+ * Commits (and optionally pushes) any staged changes according to the step configuration.
+ * Returns true if a commit was created.
+ */
+export declare function finalizeStepGitActions(context: WorkflowRuntime, step: WorkflowStepDefinition, options: FinalizeGitOptions): Promise<boolean>;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/workflow/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/workflow/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE1E,UAAU,kBAAkB;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAkClB"}

package/dist/src/workflow/utils.js

@@ -0,0 +1,38 @@
+/**
+ * Commits (and optionally pushes) any staged changes according to the step configuration.
+ * Returns true if a commit was created.
+ */
+async function finalizeStepGitActions(context, step, options) {
+    if (!step.commit) {
+        return false;
+    }
+    const { gitManager, logger } = context;
+    const hasStagedChanges = await gitManager.hasStagedChanges();
+    if (!hasStagedChanges && !options.allowEmptyCommit) {
+        logger.debug('No staged changes to commit for step', { stepId: step.id });
+        return false;
+    }
+    try {
+        await gitManager.commitChanges(options.commitMessage);
+        logger.info('Committed changes for step', {
+            stepId: step.id,
+            message: options.commitMessage,
+        });
+    }
+    catch (error) {
+        logger.error('Failed to commit changes for step', {
+            stepId: step.id,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        throw error;
+    }
+    if (step.push) {
+        const branchName = await gitManager.getCurrentBranch();
+        await gitManager.pushBranch(branchName);
+        logger.info('Pushed branch after step', { stepId: step.id, branch: branchName });
+    }
+    return true;
+}
+
+export { finalizeStepGitActions };
+//# sourceMappingURL=utils.js.map

package/dist/src/workflow/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../src/workflow/utils.ts"],"sourcesContent":["import type { WorkflowRuntime, WorkflowStepDefinition } from './types.js';\n\ninterface FinalizeGitOptions {\n    commitMessage: string;\n    allowEmptyCommit?: boolean;\n}\n\n/**\n * Commits (and optionally pushes) any staged changes according to the step configuration.\n * Returns true if a commit was created.\n */\nexport async function finalizeStepGitActions(\n    context: WorkflowRuntime,\n    step: WorkflowStepDefinition,\n    options: FinalizeGitOptions\n): Promise<boolean> {\n    if (!step.commit) {\n        return false;\n    }\n\n    const { gitManager, logger } = context;\n    const hasStagedChanges = await gitManager.hasStagedChanges();\n\n    if (!hasStagedChanges && !options.allowEmptyCommit) {\n        logger.debug('No staged changes to commit for step', { stepId: step.id });\n        return false;\n    }\n\n    try {\n        await gitManager.commitChanges(options.commitMessage);\n        logger.info('Committed changes for step', {\n            stepId: step.id,\n            message: options.commitMessage,\n        });\n    } catch (error) {\n        logger.error('Failed to commit changes for step', {\n            stepId: step.id,\n            error: error instanceof Error ? error.message : String(error),\n        });\n        throw error;\n    }\n\n    if (step.push) {\n        const branchName = await gitManager.getCurrentBranch();\n        await gitManager.pushBranch(branchName);\n        logger.info('Pushed branch after step', { stepId: step.id, branch: branchName });\n    }\n\n    return true;\n}\n"],"names":[],"mappings":"AAOA;;;AAGG;AACI,eAAe,sBAAsB,CACxC,OAAwB,EACxB,IAA4B,EAC5B,OAA2B,EAAA;AAE3B,IAAA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;AACd,QAAA,OAAO,KAAK;IAChB;AAEA,IAAA,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO;AACtC,IAAA,MAAM,gBAAgB,GAAG,MAAM,UAAU,CAAC,gBAAgB,EAAE;IAE5D,IAAI,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE;AAChD,QAAA,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;AACzE,QAAA,OAAO,KAAK;IAChB;AAEA,IAAA,IAAI;QACA,MAAM,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC;AACrD,QAAA,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;YACtC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,OAAO,CAAC,aAAa;AACjC,SAAA,CAAC;IACN;IAAE,OAAO,KAAK,EAAE;AACZ,QAAA,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE;YAC9C,MAAM,EAAE,IAAI,CAAC,EAAE;AACf,YAAA,KAAK,EAAE,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;AAChE,SAAA,CAAC;AACF,QAAA,MAAM,KAAK;IACf;AAEA,IAAA,IAAI,IAAI,CAAC,IAAI,EAAE;AACX,QAAA,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,gBAAgB,EAAE;AACtD,QAAA,MAAM,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC;AACvC,QAAA,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACpF;AAEA,IAAA,OAAO,IAAI;AACf;;;;"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@posthog/agent",
-  "version": "1.11.0",
-  "description": "TypeScript agent framework wrapping Claude Agent SDK with Git-based workflow for PostHog tasks",
+  "version": "1.13.0",
+  "description": "TypeScript agent framework wrapping Claude Agent SDK with Git-based task execution for PostHog",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -19,7 +19,6 @@
     "agent",
     "ai",
     "git",
-    "workflow",
     "typescript"
   ],
   "author": "PostHog",
@@ -50,9 +49,12 @@
     "typescript": "^5.5.0"
   },
   "dependencies": {
+    "@ai-sdk/anthropic": "^1.0.6",
+    "@ai-sdk/openai": "^1.0.10",
     "@anthropic-ai/claude-agent-sdk": "^0.1.1",
+    "ai": "^4.2.0",
     "dotenv": "^17.2.3",
-    "openai": "^6.5.0"
+    "zod": "^3.24.1"
   },
   "files": [
     "dist/**/*",

package/src/adapters/types.ts

@@ -19,7 +19,7 @@ export interface ProviderAdapter {
 
   /**
    * Create a standardized status event.
-   * Used for workflow stage transitions and other status updates.
+   * Used for task phase transitions and other status updates.
    */
   createStatusEvent(phase: string, additionalData?: any): StatusEvent;