@build0.ai/agent-core 0.2.0 → 0.3.0

package/dist/core/log-types.d.ts

@@ -11,7 +11,7 @@ export interface StepStartMessage extends BaseLogMessage {
     type: "step_start";
     stepId: string;
     stepName?: string;
-    stepType: "ai_agent" | "tool";
+    stepType: "ai_agent" | "tool" | "sleep";
     toolName?: string;
 }
 export interface StepCompleteMessage extends BaseLogMessage {

package/dist/core/log-types.d.ts.map

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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { Runner } from "./core/runner.js";
 export type { McpPlugin, BasePluginConfig, ToolDefinition, } from "./core/types.js";
-export type { Workflow, WorkflowStep } from "./utils/workflow.js";
+export type { Workflow, WorkflowStep, WorkflowConfig } from "./utils/workflow.js";
+export { loadWorkflow, parseDuration } from "./utils/workflow.js";
 export { logger } from "./utils/logger.js";
 export type { LogMessage, LogLevel, LogMessageType, BaseLogMessage, StepStartMessage, StepCompleteMessage, StepErrorMessage, StepSkipMessage, AiAgentPromptMessage, AiAgentResponseMessage, ToolCallMessage, ToolResultMessage, ClaudeCodeSdkMessage, ClaudeCodeStderrMessage, GenericLogMessage, } from "./core/log-types.js";
 export { credentialManager } from "./services/credential-manager.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EACV,UAAU,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAGnE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EACV,UAAU,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAGnE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,5 +1,4 @@
-// Core
-export { Runner } from "./core/runner.js";
+export { loadWorkflow, parseDuration } from "./utils/workflow.js";
 // Logger
 export { logger } from "./utils/logger.js";
 // Credentials

package/dist/plugins/github-polling.d.ts

@@ -0,0 +1,31 @@
+/**
+ * GitHub Polling Plugin
+ *
+ * Provides tools for polling GitHub for PR updates, comments, commits, etc.
+ * Used by long-running agents that need to monitor PR lifecycle.
+ */
+import { McpPlugin, ToolDefinition, BasePluginConfig } from "../core/types.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export interface GitHubPollingConfig extends BasePluginConfig {
+    /** GitHub personal access token or installation token */
+    token: string;
+}
+export declare class GitHubPollingPlugin implements McpPlugin<GitHubPollingConfig> {
+    name: string;
+    private token;
+    private baseUrl;
+    init(config: GitHubPollingConfig): Promise<void>;
+    registerTools(): ToolDefinition[];
+    handleToolCall(name: string, args: Record<string, unknown>): Promise<CallToolResult>;
+    private fetch;
+    private getPr;
+    private getPrComments;
+    private getPrCommits;
+    private getPrFiles;
+    private getPrReviews;
+    private createPrComment;
+    private createReview;
+    private getFileContent;
+}
+export declare const githubPollingPlugin: GitHubPollingPlugin;
+//# sourceMappingURL=github-polling.d.ts.map

package/dist/plugins/github-polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-polling.d.ts","sourceRoot":"","sources":["../../src/plugins/github-polling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAgCD,qBAAa,mBAAoB,YAAW,SAAS,CAAC,mBAAmB,CAAC;IACxE,IAAI,SAAoB;IACxB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,OAAO,CAA4B;IAErC,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD,aAAa,IAAI,cAAc,EAAE;IAkF3B,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC;YA4DZ,KAAK;YAmBL,KAAK;YAoCL,aAAa;YAoCb,YAAY;YA4BZ,UAAU;YAsCV,YAAY;YAmCZ,eAAe;YAiCf,YAAY;YAkCZ,cAAc;CA6C7B;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}

package/dist/plugins/github-polling.js

@@ -0,0 +1,330 @@
+/**
+ * GitHub Polling Plugin
+ *
+ * Provides tools for polling GitHub for PR updates, comments, commits, etc.
+ * Used by long-running agents that need to monitor PR lifecycle.
+ */
+import { z } from "zod";
+export class GitHubPollingPlugin {
+    name = "github-polling";
+    token = "";
+    baseUrl = "https://api.github.com";
+    async init(config) {
+        if (!config.token) {
+            throw new Error("GitHub token is required for github-polling plugin");
+        }
+        this.token = config.token;
+    }
+    registerTools() {
+        return [
+            {
+                name: "github_get_pr",
+                description: "Get details of a pull request including title, state, body, author, and URLs",
+                zodSchema: z.object({
+                    owner: z.string().describe("Repository owner"),
+                    repo: z.string().describe("Repository name"),
+                    pr_number: z.number().describe("Pull request number"),
+                }),
+            },
+            {
+                name: "github_get_pr_comments",
+                description: "Get comments on a pull request, optionally filtered by time",
+                zodSchema: z.object({
+                    owner: z.string().describe("Repository owner"),
+                    repo: z.string().describe("Repository name"),
+                    pr_number: z.number().describe("Pull request number"),
+                    since: z.string().optional().describe("Only return comments updated after this ISO timestamp"),
+                }),
+            },
+            {
+                name: "github_get_pr_commits",
+                description: "Get commits on a pull request",
+                zodSchema: z.object({
+                    owner: z.string().describe("Repository owner"),
+                    repo: z.string().describe("Repository name"),
+                    pr_number: z.number().describe("Pull request number"),
+                }),
+            },
+            {
+                name: "github_get_pr_files",
+                description: "Get the list of files changed in a pull request",
+                zodSchema: z.object({
+                    owner: z.string().describe("Repository owner"),
+                    repo: z.string().describe("Repository name"),
+                    pr_number: z.number().describe("Pull request number"),
+                }),
+            },
+            {
+                name: "github_get_pr_reviews",
+                description: "Get reviews on a pull request",
+                zodSchema: z.object({
+                    owner: z.string().describe("Repository owner"),
+                    repo: z.string().describe("Repository name"),
+                    pr_number: z.number().describe("Pull request number"),
+                }),
+            },
+            {
+                name: "github_create_pr_comment",
+                description: "Create a comment on a pull request",
+                zodSchema: z.object({
+                    owner: z.string().describe("Repository owner"),
+                    repo: z.string().describe("Repository name"),
+                    pr_number: z.number().describe("Pull request number"),
+                    body: z.string().describe("Comment body in markdown"),
+                }),
+            },
+            {
+                name: "github_create_review",
+                description: "Create a review on a pull request",
+                zodSchema: z.object({
+                    owner: z.string().describe("Repository owner"),
+                    repo: z.string().describe("Repository name"),
+                    pr_number: z.number().describe("Pull request number"),
+                    body: z.string().describe("Review body in markdown"),
+                    event: z.enum(["APPROVE", "REQUEST_CHANGES", "COMMENT"]).describe("Review action"),
+                }),
+            },
+            {
+                name: "github_get_file_content",
+                description: "Get the content of a file from the repository",
+                zodSchema: z.object({
+                    owner: z.string().describe("Repository owner"),
+                    repo: z.string().describe("Repository name"),
+                    path: z.string().describe("File path in the repository"),
+                    ref: z.string().optional().describe("Branch, tag, or commit SHA (default: default branch)"),
+                }),
+            },
+        ];
+    }
+    async handleToolCall(name, args) {
+        try {
+            switch (name) {
+                case "github_get_pr":
+                    return await this.getPr(args);
+                case "github_get_pr_comments":
+                    return await this.getPrComments(args);
+                case "github_get_pr_commits":
+                    return await this.getPrCommits(args);
+                case "github_get_pr_files":
+                    return await this.getPrFiles(args);
+                case "github_get_pr_reviews":
+                    return await this.getPrReviews(args);
+                case "github_create_pr_comment":
+                    return await this.createPrComment(args);
+                case "github_create_review":
+                    return await this.createReview(args);
+                case "github_get_file_content":
+                    return await this.getFileContent(args);
+                default:
+                    return {
+                        content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                        isError: true,
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    async fetch(endpoint, options) {
+        const response = await fetch(`${this.baseUrl}${endpoint}`, {
+            ...options,
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                Accept: "application/vnd.github.v3+json",
+                "User-Agent": "Build0-Agent",
+                ...options?.headers,
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`GitHub API error: ${response.status} - ${error}`);
+        }
+        return response;
+    }
+    async getPr(args) {
+        const { owner, repo, pr_number } = args;
+        const response = await this.fetch(`/repos/${owner}/${repo}/pulls/${pr_number}`);
+        const pr = (await response.json());
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        number: pr.number,
+                        title: pr.title,
+                        state: pr.state,
+                        merged: pr.merged,
+                        author: pr.user.login,
+                        head_sha: pr.head.sha,
+                        head_ref: pr.head.ref,
+                        base_ref: pr.base.ref,
+                        body: pr.body,
+                        created_at: pr.created_at,
+                        updated_at: pr.updated_at,
+                        url: pr.html_url,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async getPrComments(args) {
+        const { owner, repo, pr_number, since } = args;
+        let endpoint = `/repos/${owner}/${repo}/issues/${pr_number}/comments`;
+        if (since) {
+            endpoint += `?since=${encodeURIComponent(since)}`;
+        }
+        const response = await this.fetch(endpoint);
+        const comments = (await response.json());
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(comments.map((c) => ({
+                        id: c.id,
+                        author: c.user.login,
+                        body: c.body,
+                        created_at: c.created_at,
+                        updated_at: c.updated_at,
+                        url: c.html_url,
+                    })), null, 2),
+                },
+            ],
+        };
+    }
+    async getPrCommits(args) {
+        const { owner, repo, pr_number } = args;
+        const response = await this.fetch(`/repos/${owner}/${repo}/pulls/${pr_number}/commits`);
+        const commits = (await response.json());
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(commits.map((c) => ({
+                        sha: c.sha,
+                        message: c.commit.message,
+                        author: c.commit.author.name,
+                        date: c.commit.author.date,
+                    })), null, 2),
+                },
+            ],
+        };
+    }
+    async getPrFiles(args) {
+        const { owner, repo, pr_number } = args;
+        const response = await this.fetch(`/repos/${owner}/${repo}/pulls/${pr_number}/files`);
+        const files = (await response.json());
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(files.map((f) => ({
+                        filename: f.filename,
+                        status: f.status,
+                        additions: f.additions,
+                        deletions: f.deletions,
+                        changes: f.changes,
+                        // Truncate patch if too long
+                        patch: f.patch?.substring(0, 2000),
+                    })), null, 2),
+                },
+            ],
+        };
+    }
+    async getPrReviews(args) {
+        const { owner, repo, pr_number } = args;
+        const response = await this.fetch(`/repos/${owner}/${repo}/pulls/${pr_number}/reviews`);
+        const reviews = (await response.json());
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(reviews.map((r) => ({
+                        id: r.id,
+                        author: r.user.login,
+                        state: r.state,
+                        body: r.body,
+                        submitted_at: r.submitted_at,
+                    })), null, 2),
+                },
+            ],
+        };
+    }
+    async createPrComment(args) {
+        const { owner, repo, pr_number, body } = args;
+        const response = await this.fetch(`/repos/${owner}/${repo}/issues/${pr_number}/comments`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ body }),
+        });
+        const comment = (await response.json());
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: comment.id,
+                        url: comment.html_url,
+                        created_at: comment.created_at,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async createReview(args) {
+        const { owner, repo, pr_number, body, event } = args;
+        const response = await this.fetch(`/repos/${owner}/${repo}/pulls/${pr_number}/reviews`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ body, event }),
+        });
+        const review = (await response.json());
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: review.id,
+                        state: review.state,
+                        url: review.html_url,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async getFileContent(args) {
+        const { owner, repo, path, ref } = args;
+        let endpoint = `/repos/${owner}/${repo}/contents/${path}`;
+        if (ref) {
+            endpoint += `?ref=${encodeURIComponent(ref)}`;
+        }
+        const response = await this.fetch(endpoint);
+        const file = (await response.json());
+        // Decode base64 content
+        const content = file.encoding === "base64"
+            ? Buffer.from(file.content, "base64").toString("utf-8")
+            : file.content;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        name: file.name,
+                        path: file.path,
+                        size: file.size,
+                        content: content.substring(0, 50000), // Limit content size
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+}
+export const githubPollingPlugin = new GitHubPollingPlugin();

package/dist/plugins/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Common plugins for Build0 agents.
+ *
+ * These plugins provide reusable tools for interacting with external services.
+ * Agent templates can import and register these plugins, or create their own.
+ */
+export { GitHubPollingPlugin, githubPollingPlugin } from "./github-polling.js";
+export type { GitHubPollingConfig } from "./github-polling.js";
+export { SlackPollingPlugin, slackPollingPlugin } from "./slack-polling.js";
+export type { SlackPollingConfig } from "./slack-polling.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,8 @@
+/**
+ * Common plugins for Build0 agents.
+ *
+ * These plugins provide reusable tools for interacting with external services.
+ * Agent templates can import and register these plugins, or create their own.
+ */
+export { GitHubPollingPlugin, githubPollingPlugin } from "./github-polling.js";
+export { SlackPollingPlugin, slackPollingPlugin } from "./slack-polling.js";

package/dist/plugins/slack-polling.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Slack Polling Plugin
+ *
+ * Provides tools for interacting with Slack threads.
+ * Used by agents that need to maintain conversations with users via Slack.
+ */
+import { McpPlugin, ToolDefinition, BasePluginConfig } from "../core/types.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export interface SlackPollingConfig extends BasePluginConfig {
+    /** Slack bot token (xoxb-...) */
+    token: string;
+}
+export declare class SlackPollingPlugin implements McpPlugin<SlackPollingConfig> {
+    name: string;
+    private token;
+    private baseUrl;
+    init(config: SlackPollingConfig): Promise<void>;
+    registerTools(): ToolDefinition[];
+    handleToolCall(name: string, args: Record<string, unknown>): Promise<CallToolResult>;
+    private fetch;
+    private postMessage;
+    private getThreadMessages;
+    private getUserInfo;
+    private addReaction;
+    private updateMessage;
+}
+export declare const slackPollingPlugin: SlackPollingPlugin;
+//# sourceMappingURL=slack-polling.d.ts.map

package/dist/plugins/slack-polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-polling.d.ts","sourceRoot":"","sources":["../../src/plugins/slack-polling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAgBD,qBAAa,kBAAmB,YAAW,SAAS,CAAC,kBAAkB,CAAC;IACtE,IAAI,SAAmB;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,OAAO,CAA2B;IAEpC,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,aAAa,IAAI,cAAc,EAAE;IAgD3B,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC;YA6CZ,KAAK;YAyBL,WAAW;YAkCX,iBAAiB;YAsCjB,WAAW;YAwBX,WAAW;YAmBX,aAAa;CA2B5B;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/plugins/slack-polling.js

@@ -0,0 +1,207 @@
+/**
+ * Slack Polling Plugin
+ *
+ * Provides tools for interacting with Slack threads.
+ * Used by agents that need to maintain conversations with users via Slack.
+ */
+import { z } from "zod";
+export class SlackPollingPlugin {
+    name = "slack-polling";
+    token = "";
+    baseUrl = "https://slack.com/api";
+    async init(config) {
+        if (!config.token) {
+            throw new Error("Slack token is required for slack-polling plugin");
+        }
+        this.token = config.token;
+    }
+    registerTools() {
+        return [
+            {
+                name: "slack_post_message",
+                description: "Post a message to a Slack channel. Returns the thread_ts for replies.",
+                zodSchema: z.object({
+                    channel: z.string().describe("Channel ID (e.g., C1234567890)"),
+                    text: z.string().describe("Message text (supports Slack markdown)"),
+                    thread_ts: z.string().optional().describe("Thread timestamp to reply to"),
+                }),
+            },
+            {
+                name: "slack_get_thread_messages",
+                description: "Get all messages in a Slack thread",
+                zodSchema: z.object({
+                    channel: z.string().describe("Channel ID"),
+                    thread_ts: z.string().describe("Thread timestamp (ts of the parent message)"),
+                    oldest: z.string().optional().describe("Only return messages after this timestamp"),
+                }),
+            },
+            {
+                name: "slack_get_user_info",
+                description: "Get information about a Slack user",
+                zodSchema: z.object({
+                    user_id: z.string().describe("User ID (e.g., U1234567890)"),
+                }),
+            },
+            {
+                name: "slack_add_reaction",
+                description: "Add a reaction emoji to a message",
+                zodSchema: z.object({
+                    channel: z.string().describe("Channel ID"),
+                    timestamp: z.string().describe("Message timestamp"),
+                    name: z.string().describe("Emoji name without colons (e.g., 'thumbsup')"),
+                }),
+            },
+            {
+                name: "slack_update_message",
+                description: "Update an existing message",
+                zodSchema: z.object({
+                    channel: z.string().describe("Channel ID"),
+                    ts: z.string().describe("Timestamp of the message to update"),
+                    text: z.string().describe("New message text"),
+                }),
+            },
+        ];
+    }
+    async handleToolCall(name, args) {
+        try {
+            switch (name) {
+                case "slack_post_message":
+                    return await this.postMessage(args);
+                case "slack_get_thread_messages":
+                    return await this.getThreadMessages(args);
+                case "slack_get_user_info":
+                    return await this.getUserInfo(args);
+                case "slack_add_reaction":
+                    return await this.addReaction(args);
+                case "slack_update_message":
+                    return await this.updateMessage(args);
+                default:
+                    return {
+                        content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                        isError: true,
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    async fetch(method, params) {
+        const response = await fetch(`${this.baseUrl}/${method}`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                "Content-Type": "application/json; charset=utf-8",
+            },
+            body: JSON.stringify(params),
+        });
+        const data = (await response.json());
+        if (!data.ok) {
+            throw new Error(`Slack API error: ${data.error || "Unknown error"}`);
+        }
+        return data;
+    }
+    async postMessage(args) {
+        const { channel, text, thread_ts } = args;
+        const params = { channel, text };
+        if (thread_ts) {
+            params.thread_ts = thread_ts;
+        }
+        const data = await this.fetch("chat.postMessage", params);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        ok: true,
+                        channel: data.channel,
+                        ts: data.ts,
+                        thread_ts: data.message?.thread_ts || data.ts,
+                        message: "Message posted successfully",
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async getThreadMessages(args) {
+        const { channel, thread_ts, oldest } = args;
+        const params = { channel, ts: thread_ts };
+        if (oldest) {
+            params.oldest = oldest;
+        }
+        const data = await this.fetch("conversations.replies", params);
+        const messages = data.messages;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        thread_ts,
+                        message_count: messages.length,
+                        messages: messages.map((m) => ({
+                            ts: m.ts,
+                            user: m.user,
+                            text: m.text,
+                            is_parent: m.ts === thread_ts,
+                        })),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async getUserInfo(args) {
+        const { user_id } = args;
+        const data = await this.fetch("users.info", { user: user_id });
+        const user = data.user;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: user.id,
+                        name: user.name,
+                        real_name: user.real_name,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async addReaction(args) {
+        const { channel, timestamp, name } = args;
+        await this.fetch("reactions.add", { channel, timestamp, name });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ ok: true, message: `Added :${name}: reaction` }, null, 2),
+                },
+            ],
+        };
+    }
+    async updateMessage(args) {
+        const { channel, ts, text } = args;
+        const data = await this.fetch("chat.update", { channel, ts, text });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        ok: true,
+                        channel: data.channel,
+                        ts: data.ts,
+                        message: "Message updated successfully",
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+}
+export const slackPollingPlugin = new SlackPollingPlugin();

package/dist/run-step.d.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for executing a single workflow step.
+ * Used by the Vercel workflow (agent_run_v2) to run individual steps in the sandbox.
+ *
+ * This file contains all step execution logic directly (no separate executeStep method).
+ *
+ * Usage:
+ *   node dist/run-step.js
+ *
+ * Environment variables:
+ *   STEP_INPUT_FILE - Path to JSON file containing step input
+ *   ANTHROPIC_API_KEY - API key for Claude
+ *   BUILD0_AGENT_CREDENTIALS_URL - URL to fetch credentials
+ *   BUILD0_AGENT_AUTH_TOKEN - Auth token for credentials
+ *   BUILD0_AGENT_ENCRYPTION_KEY - Key to decrypt credentials
+ *
+ * Input file format:
+ *   {
+ *     "stepId": "review",
+ *     "step": { ... step definition from workflow.json ... },
+ *     "context": { ... accumulated context from previous steps ... },
+ *     "shouldContinuePreviousSession": false
+ *   }
+ *
+ * Output (JSON to stdout):
+ *   ---STEP_RESULT_JSON---
+ *   {"type":"step_result","stepId":"review","success":true,"output":{...}}
+ */
+export {};
+//# sourceMappingURL=run-step.d.ts.map

package/dist/run-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-step.d.ts","sourceRoot":"","sources":["../src/run-step.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/run-step.js

@@ -0,0 +1,290 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for executing a single workflow step.
+ * Used by the Vercel workflow (agent_run_v2) to run individual steps in the sandbox.
+ *
+ * This file contains all step execution logic directly (no separate executeStep method).
+ *
+ * Usage:
+ *   node dist/run-step.js
+ *
+ * Environment variables:
+ *   STEP_INPUT_FILE - Path to JSON file containing step input
+ *   ANTHROPIC_API_KEY - API key for Claude
+ *   BUILD0_AGENT_CREDENTIALS_URL - URL to fetch credentials
+ *   BUILD0_AGENT_AUTH_TOKEN - Auth token for credentials
+ *   BUILD0_AGENT_ENCRYPTION_KEY - Key to decrypt credentials
+ *
+ * Input file format:
+ *   {
+ *     "stepId": "review",
+ *     "step": { ... step definition from workflow.json ... },
+ *     "context": { ... accumulated context from previous steps ... },
+ *     "shouldContinuePreviousSession": false
+ *   }
+ *
+ * Output (JSON to stdout):
+ *   ---STEP_RESULT_JSON---
+ *   {"type":"step_result","stepId":"review","success":true,"output":{...}}
+ */
+import fs from "fs/promises";
+import path from "path";
+import os from "os";
+import { runAgent } from "./utils/agent.js";
+import { logger } from "./utils/logger.js";
+import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
+// ============================================================================
+// Utility Functions
+// ============================================================================
+function interpolate(text, context) {
+    if (typeof text !== "string")
+        return text;
+    return text.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (_, pathStr) => {
+        const keys = pathStr.split(".");
+        let value = context;
+        for (const key of keys) {
+            if (value && typeof value === "object" && key in value) {
+                value = value[key];
+            }
+            else {
+                return "";
+            }
+        }
+        return value !== undefined
+            ? typeof value === "object"
+                ? JSON.stringify(value, null, 2)
+                : String(value)
+            : "";
+    });
+}
+function evaluateCondition(condition, context) {
+    const interpolated = condition.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (_, pathStr) => {
+        const keys = pathStr.split(".");
+        let value = context;
+        for (const key of keys) {
+            if (value && typeof value === "object" && key in value) {
+                value = value[key];
+            }
+            else {
+                return "undefined";
+            }
+        }
+        return JSON.stringify(value);
+    });
+    try {
+        // eslint-disable-next-line no-new-func
+        const result = new Function(`return ${interpolated}`)();
+        return Boolean(result);
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// Plugin Loading
+// ============================================================================
+async function loadPlugins() {
+    const plugins = [];
+    // Try to load plugins from the agent's index.js
+    const agentIndexPath = path.resolve(process.cwd(), "dist/index.js");
+    try {
+        await fs.access(agentIndexPath);
+        const agentModule = await import(agentIndexPath);
+        if (typeof agentModule.getPlugins === "function") {
+            const loadedPlugins = await agentModule.getPlugins();
+            plugins.push(...loadedPlugins);
+            logger.info(`Loaded ${loadedPlugins.length} plugins from agent index.js`);
+        }
+        else if (typeof agentModule.registerPlugins === "function") {
+            // Legacy API - create a temporary collector
+            const collector = {
+                plugins: [],
+                async registerPlugin(plugin, config) {
+                    await plugin.init(config);
+                    this.plugins.push(plugin);
+                },
+            };
+            await agentModule.registerPlugins(collector);
+            plugins.push(...collector.plugins);
+            logger.info(`Loaded ${collector.plugins.length} plugins via registerPlugins`);
+        }
+        else {
+            logger.warn("Agent index.js does not export getPlugins or registerPlugins");
+        }
+    }
+    catch {
+        logger.info("No agent index.js found, running without custom plugins");
+    }
+    return plugins;
+}
+function createMcpServer(plugins) {
+    const tools = [];
+    for (const plugin of plugins) {
+        const pluginTools = plugin.registerTools();
+        for (const pluginTool of pluginTools) {
+            tools.push(tool(pluginTool.name, pluginTool.description, pluginTool.zodSchema.shape, async (args) => {
+                return await plugin.handleToolCall(pluginTool.name, args);
+            }));
+        }
+    }
+    const server = createSdkMcpServer({
+        name: "agent-tools",
+        version: "1.0.0",
+        tools,
+    });
+    logger.info(`MCP server created with ${tools.length} tools`);
+    return server;
+}
+// ============================================================================
+// Step Execution
+// ============================================================================
+async function executeAiAgentStep(step, context, plugins, shouldContinuePreviousSession) {
+    const mcpServer = createMcpServer(plugins);
+    // Interpolate args
+    const agentArgs = {};
+    if (step.args) {
+        for (const [k, v] of Object.entries(step.args)) {
+            agentArgs[k] = typeof v === "string" ? interpolate(v, context) : v;
+        }
+    }
+    const fullPrompt = agentArgs.prompt || "";
+    const workingDir = path.resolve(process.cwd(), agentArgs.working_dir || ".");
+    // Write full prompt to temp file (outside workspace)
+    const tempPromptFile = path.join(os.tmpdir(), `prompt_${step.id}_${Date.now()}.txt`);
+    const MAX_CHARS = 2000 * 4;
+    await fs.writeFile(tempPromptFile, fullPrompt, "utf-8");
+    logger.aiAgentPrompt(step.id, fullPrompt.length, fullPrompt.length > MAX_CHARS, tempPromptFile);
+    let truncatedPrompt = fullPrompt.substring(0, MAX_CHARS);
+    if (fullPrompt.length > MAX_CHARS) {
+        truncatedPrompt += `\n\n[Note: The full prompt was truncated. See '${tempPromptFile}' for complete details.]`;
+    }
+    const result = await runAgent({
+        prompt: truncatedPrompt,
+        workingDirectory: workingDir,
+        mcpServers: {
+            "agent-tools": mcpServer,
+        },
+        shouldContinuePreviousSession,
+    });
+    logger.aiAgentResponse(step.id, result.output.length, result.output.substring(0, 100));
+    return { output: result.output };
+}
+async function executeToolStep(step, context, plugins) {
+    const toolName = step.tool;
+    if (!toolName)
+        throw new Error("Tool name missing");
+    // Find plugin that provides this tool
+    const plugin = plugins.find((p) => p.registerTools().some((t) => t.name === toolName));
+    if (!plugin)
+        throw new Error(`Plugin for tool ${toolName} not found`);
+    // Interpolate args
+    const args = {};
+    if (step.args) {
+        for (const [k, v] of Object.entries(step.args)) {
+            args[k] = typeof v === "string" ? interpolate(v, context) : v;
+        }
+    }
+    const toolCallId = `${step.id}_${toolName}_${Date.now()}`;
+    logger.toolCall(toolName, toolCallId, args);
+    const toolResult = await plugin.handleToolCall(toolName, args);
+    // Extract text content from tool result
+    const outputText = toolResult.content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("\n");
+    logger.toolResult(toolName, toolCallId, outputText.length, outputText.substring(0, 100), true);
+    // Try to parse JSON if possible
+    let outputData = outputText;
+    try {
+        outputData = JSON.parse(outputText);
+    }
+    catch {
+        // Keep as string
+    }
+    return { output: outputData };
+}
+// ============================================================================
+// Main
+// ============================================================================
+async function main() {
+    const inputFile = process.env.STEP_INPUT_FILE;
+    if (!inputFile) {
+        console.error("Error: STEP_INPUT_FILE environment variable is required");
+        process.exit(1);
+    }
+    let input;
+    try {
+        const content = await fs.readFile(inputFile, "utf-8");
+        input = JSON.parse(content);
+    }
+    catch (error) {
+        console.error(`Error reading input file: ${error}`);
+        process.exit(1);
+    }
+    const { stepId, step, context, shouldContinuePreviousSession } = input;
+    logger.stepStart(step.id, step.type, step.tool, step.name);
+    // Check 'if' condition
+    if (step.if) {
+        if (!evaluateCondition(step.if, context)) {
+            logger.stepSkip(step.id, "condition false", step.name);
+            outputResult({
+                type: "step_result",
+                stepId,
+                success: true,
+                skipped: true,
+            });
+            return;
+        }
+    }
+    try {
+        // Load plugins
+        const plugins = await loadPlugins();
+        let result;
+        switch (step.type) {
+            case "sleep":
+                // Sleep should be handled by the workflow, not the sandbox
+                throw new Error("Sleep steps should be handled by the workflow orchestrator, not the sandbox");
+            case "ai_agent":
+                result = await executeAiAgentStep(step, context, plugins, shouldContinuePreviousSession ?? false);
+                break;
+            case "tool":
+                result = await executeToolStep(step, context, plugins);
+                break;
+            default:
+                throw new Error(`Unknown step type: ${step.type}`);
+        }
+        logger.stepComplete(step.id, step.name);
+        outputResult({
+            type: "step_result",
+            stepId,
+            success: true,
+            output: result.output,
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.stepError(step.id, errorMessage, step.name);
+        outputResult({
+            type: "step_result",
+            stepId,
+            success: false,
+            error: errorMessage,
+        });
+        process.exit(1);
+    }
+}
+function outputResult(output) {
+    // Print separator and result
+    console.log("---STEP_RESULT_JSON---");
+    console.log(JSON.stringify(output));
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    outputResult({
+        type: "step_result",
+        stepId: "unknown",
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+    });
+    process.exit(1);
+});

package/dist/utils/logger.d.ts

@@ -9,7 +9,7 @@ declare class Logger {
     private overrideConsole;
     private log;
     private createMessage;
-    stepStart(stepId: string, stepType: "ai_agent" | "tool", toolName?: string, stepName?: string): void;
+    stepStart(stepId: string, stepType: "ai_agent" | "tool" | "sleep", toolName?: string, stepName?: string): void;
     stepComplete(stepId: string, stepName?: string, duration?: number, outputPreview?: string): void;
     stepError(stepId: string, error: string, stepName?: string): void;
     stepSkip(stepId: string, reason: string, stepName?: string): void;

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAiB5D,cAAM,MAAM;IACV,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,oBAAoB,CAAuB;;IAanD,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,aAAa;IAcrB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAY7F,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAYzF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAW1D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAW1D,aAAa,CACX,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,OAAO,EAClB,cAAc,CAAC,EAAE,MAAM;IAYzB,eAAe,CACb,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM;IAWzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAUxE,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,OAAO;IAazB,oBAAoB,CAAC,OAAO,EAAE,UAAU;IAQxC,gBAAgB,CAAC,MAAM,EAAE,MAAM;IAW/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAWhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAWhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAWjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAUlD;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAiB5D,cAAM,MAAM;IACV,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,oBAAoB,CAAuB;;IAanD,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,aAAa;IAcrB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAYvG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAYzF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAW1D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAW1D,aAAa,CACX,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,OAAO,EAClB,cAAc,CAAC,EAAE,MAAM;IAYzB,eAAe,CACb,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM;IAWzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAUxE,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,OAAO;IAazB,oBAAoB,CAAC,OAAO,EAAE,UAAU;IAQxC,gBAAgB,CAAC,MAAM,EAAE,MAAM;IAW/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAWhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAWhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAWjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAUlD;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/workflow.d.ts

@@ -1,13 +1,29 @@
 export interface WorkflowStep {
     id: string;
     name?: string;
-    type: "ai_agent" | "tool";
+    type: "ai_agent" | "tool" | "sleep";
     tool?: string;
     args?: Record<string, any>;
     if?: string;
+    /** Jump to another step (for looping/branching) */
+    goto?: string;
+    /** Duration for sleep steps (e.g., "30s", "5m", "1h") */
+    duration?: string;
+}
+export interface WorkflowConfig {
+    /** Maximum duration for the entire workflow (e.g., "7d") */
+    max_duration?: string;
 }
 export interface Workflow {
+    name?: string;
+    version?: string;
+    config?: WorkflowConfig;
     steps: WorkflowStep[];
 }
 export declare function loadWorkflow(filePath: string): Promise<Workflow>;
+/**
+ * Parse a duration string into milliseconds.
+ * Supports: "30s", "5m", "1h", "1d", "7d"
+ */
+export declare function parseDuration(duration: string): number;
 //# sourceMappingURL=workflow.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/utils/workflow.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAGtE"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/utils/workflow.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAGtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAetD"}

package/dist/utils/workflow.js

@@ -3,3 +3,22 @@ export async function loadWorkflow(filePath) {
     const content = await fs.readFile(filePath, "utf-8");
     return JSON.parse(content);
 }
+/**
+ * Parse a duration string into milliseconds.
+ * Supports: "30s", "5m", "1h", "1d", "7d"
+ */
+export function parseDuration(duration) {
+    const match = duration.match(/^(\d+)(s|m|h|d)$/);
+    if (!match) {
+        throw new Error(`Invalid duration format: ${duration}. Use format like "30s", "5m", "1h", "7d"`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    switch (unit) {
+        case "s": return value * 1000;
+        case "m": return value * 60 * 1000;
+        case "h": return value * 60 * 60 * 1000;
+        case "d": return value * 24 * 60 * 60 * 1000;
+        default: throw new Error(`Unknown duration unit: ${unit}`);
+    }
+}

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@build0.ai/agent-core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Core framework for Build0 autonomous coding agents",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "run-step": "dist/run-step.js"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js",