agentbox-sdk 0.0.0 → 0.1.1

package/dist/types-Et22oPap.d.ts

@@ -0,0 +1,387 @@
+import { AgentProvider } from './enums.js';
+import { S as Sandbox } from './Sandbox-BQX-sWzs.js';
+
+interface RawAgentEvent<TPayload = unknown> {
+    provider: string;
+    runId: string;
+    type: string;
+    timestamp: string;
+    payload: TPayload;
+}
+
+type NormalizedAgentEventType = "run.started" | "message.started" | "message.injected" | "text.delta" | "reasoning.delta" | "tool.call.started" | "tool.call.delta" | "tool.call.completed" | "permission.requested" | "permission.resolved" | "message.completed" | "run.completed" | "run.error";
+interface NormalizedAgentEventBase {
+    provider: string;
+    runId: string;
+    type: NormalizedAgentEventType;
+    timestamp: string;
+    raw?: RawAgentEvent;
+    meta?: Record<string, unknown>;
+}
+interface RunStartedEvent extends NormalizedAgentEventBase {
+    type: "run.started";
+}
+interface MessageStartedEvent extends NormalizedAgentEventBase {
+    type: "message.started";
+}
+interface MessageInjectedEvent extends NormalizedAgentEventBase {
+    type: "message.injected";
+    content: string;
+}
+interface TextDeltaEvent extends NormalizedAgentEventBase {
+    type: "text.delta";
+    delta: string;
+}
+interface ReasoningDeltaEvent extends NormalizedAgentEventBase {
+    type: "reasoning.delta";
+    delta: string;
+}
+interface ToolCallStartedEvent extends NormalizedAgentEventBase {
+    type: "tool.call.started";
+    toolName: string;
+    callId?: string;
+    input?: unknown;
+}
+interface ToolCallDeltaEvent extends NormalizedAgentEventBase {
+    type: "tool.call.delta";
+    toolName?: string;
+    callId?: string;
+    delta: string;
+}
+interface ToolCallCompletedEvent extends NormalizedAgentEventBase {
+    type: "tool.call.completed";
+    toolName?: string;
+    callId?: string;
+    output?: unknown;
+}
+interface PermissionRequestedEvent extends NormalizedAgentEventBase {
+    type: "permission.requested";
+    requestId: string;
+    kind: AgentPermissionKind;
+    title?: string;
+    message?: string;
+    input?: unknown;
+    canRemember?: boolean;
+}
+interface PermissionResolvedEvent extends NormalizedAgentEventBase {
+    type: "permission.resolved";
+    requestId: string;
+    decision: AgentPermissionDecision;
+    remember?: boolean;
+}
+interface MessageCompletedEvent extends NormalizedAgentEventBase {
+    type: "message.completed";
+    text?: string;
+}
+interface RunCompletedEvent extends NormalizedAgentEventBase {
+    type: "run.completed";
+    text?: string;
+}
+interface RunErrorEvent extends NormalizedAgentEventBase {
+    type: "run.error";
+    error: string;
+}
+type NormalizedAgentEvent = RunStartedEvent | MessageStartedEvent | MessageInjectedEvent | TextDeltaEvent | ReasoningDeltaEvent | ToolCallStartedEvent | ToolCallDeltaEvent | ToolCallCompletedEvent | PermissionRequestedEvent | PermissionResolvedEvent | MessageCompletedEvent | RunCompletedEvent | RunErrorEvent;
+declare function createNormalizedEvent<TType extends NormalizedAgentEventType>(type: TType, base: Omit<NormalizedAgentEventBase, "type" | "timestamp"> & {
+    timestamp?: string;
+}, extra?: Record<string, unknown>): NormalizedAgentEvent;
+declare function normalizeRawAgentEvent(event: RawAgentEvent): NormalizedAgentEvent[];
+
+type AISDKEvent = {
+    type: "response-start";
+    id: string;
+    provider: string;
+} | {
+    type: "message-injected";
+    id: string;
+    provider: string;
+    content: string;
+} | {
+    type: "text-delta";
+    id: string;
+    provider: string;
+    textDelta: string;
+} | {
+    type: "reasoning-delta";
+    id: string;
+    provider: string;
+    textDelta: string;
+} | {
+    type: "tool-input-start";
+    id: string;
+    provider: string;
+    toolName: string;
+    callId?: string;
+} | {
+    type: "tool-input-delta";
+    id: string;
+    provider: string;
+    toolName?: string;
+    callId?: string;
+    inputTextDelta: string;
+} | {
+    type: "tool-output-available";
+    id: string;
+    provider: string;
+    toolName?: string;
+    callId?: string;
+    output?: unknown;
+} | {
+    type: "permission-requested";
+    id: string;
+    provider: string;
+    requestId: string;
+    kind: AgentPermissionKind;
+    title?: string;
+    message?: string;
+    input?: unknown;
+    canRemember?: boolean;
+} | {
+    type: "permission-resolved";
+    id: string;
+    provider: string;
+    requestId: string;
+    decision: AgentPermissionDecision;
+    remember?: boolean;
+} | {
+    type: "response-finish";
+    id: string;
+    provider: string;
+    text?: string;
+} | {
+    type: "response-error";
+    id: string;
+    provider: string;
+    error: string;
+};
+declare function toAISDKEvent(event: NormalizedAgentEvent): AISDKEvent | null;
+declare function toAISDKStream(events: AsyncIterable<NormalizedAgentEvent>): AsyncIterable<AISDKEvent>;
+
+type AgentRemoteMcpConfig = {
+    name: string;
+    type: "remote";
+    url: string;
+    enabled?: boolean;
+    bearerTokenEnvVar?: string;
+    headers?: Record<string, string>;
+};
+type AgentLocalMcpConfig = {
+    name: string;
+    type: "local";
+    enabled?: boolean;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+};
+type AgentMcpConfig = AgentRemoteMcpConfig | AgentLocalMcpConfig;
+type RepoSkillConfig = {
+    name: string;
+    repo?: string;
+};
+type EmbeddedSkillConfig = {
+    source: "embedded";
+    name: string;
+    files: Record<string, string>;
+};
+type AgentSkillConfig = RepoSkillConfig | EmbeddedSkillConfig;
+interface AgentSubAgentConfig {
+    name: string;
+    description: string;
+    instructions: string;
+    tools?: string[];
+    model?: string;
+}
+type ClaudeCodeHookEvent = "SessionStart" | "SessionEnd" | "UserPromptSubmit" | "PreToolUse" | "PermissionRequest" | "PermissionDenied" | "PostToolUse" | "PostToolUseFailure" | "Notification" | "SubagentStart" | "SubagentStop" | "Stop" | "StopFailure" | "TeammateIdle" | "FileChanged" | "WorktreeCreate" | "WorktreeRemove" | "PreCompact" | "PostCompact" | "CwdChanged" | "TaskCreated" | "TaskCompleted";
+interface ClaudeCodeHookBase {
+    if?: string;
+    timeout?: number;
+    statusMessage?: string;
+    once?: boolean;
+}
+interface ClaudeCodeCommandHook extends ClaudeCodeHookBase {
+    type: "command";
+    command: string;
+    async?: boolean;
+    shell?: "bash" | "powershell";
+}
+interface ClaudeCodeHttpHook extends ClaudeCodeHookBase {
+    type: "http";
+    url: string;
+    headers?: Record<string, string>;
+    allowedEnvVars?: string[];
+}
+interface ClaudeCodePromptHook extends ClaudeCodeHookBase {
+    type: "prompt";
+    prompt: string;
+    model?: string;
+}
+interface ClaudeCodeAgentHook extends ClaudeCodeHookBase {
+    type: "agent";
+    prompt: string;
+    model?: string;
+}
+type ClaudeCodeHookHandler = ClaudeCodeCommandHook | ClaudeCodeHttpHook | ClaudeCodePromptHook | ClaudeCodeAgentHook;
+interface ClaudeCodeHookMatcherGroup {
+    matcher?: string;
+    hooks: ClaudeCodeHookHandler[];
+}
+type ClaudeCodeHooksConfig = Partial<Record<ClaudeCodeHookEvent, ClaudeCodeHookMatcherGroup[]>>;
+type ClaudeCodeHookConfig = ClaudeCodeHooksConfig;
+type CodexHookEvent = "SessionStart" | "PreToolUse" | "PostToolUse" | "UserPromptSubmit" | "Stop";
+interface CodexCommandHook {
+    type: "command";
+    command: string;
+    timeout?: number;
+    timeoutSec?: number;
+    statusMessage?: string;
+}
+interface CodexHookMatcherGroup {
+    matcher?: string;
+    hooks: CodexCommandHook[];
+}
+type CodexHooksConfig = Partial<Record<CodexHookEvent, CodexHookMatcherGroup[]>>;
+type OpenCodePluginEvent = "command.executed" | "file.edited" | "file.watcher.updated" | "installation.updated" | "lsp.client.diagnostics" | "lsp.updated" | "message.part.removed" | "message.part.updated" | "message.removed" | "message.updated" | "permission.asked" | "permission.replied" | "server.connected" | "session.created" | "session.compacted" | "session.deleted" | "session.diff" | "session.error" | "session.idle" | "session.status" | "session.updated" | "todo.updated" | "shell.env" | "tool.execute.after" | "tool.execute.before" | "tui.prompt.append" | "tui.command.execute" | "tui.toast.show" | "experimental.session.compacting";
+interface OpenCodePluginHookConfig {
+    event: OpenCodePluginEvent;
+    body: string;
+}
+interface OpenCodePluginConfig {
+    name: string;
+    hooks: OpenCodePluginHookConfig[];
+    preamble?: string;
+    setup?: string;
+    fileExtension?: "js" | "ts";
+}
+interface AgentCommandConfig {
+    name: string;
+    template: string;
+    description?: string;
+    agent?: string;
+    model?: string;
+    subtask?: boolean;
+}
+
+type AgentProviderName = AgentProvider;
+type DataContent = string | URL | Uint8Array | ArrayBuffer | Buffer;
+interface TextPart {
+    type: "text";
+    text: string;
+}
+interface ImagePart {
+    type: "image";
+    image: DataContent;
+    mediaType?: string;
+}
+interface FilePart {
+    type: "file";
+    data: DataContent;
+    mediaType: string;
+    filename?: string;
+}
+type UserContentPart = TextPart | ImagePart | FilePart;
+type UserContent = string | UserContentPart[];
+interface AgentRunConfig {
+    input: UserContent;
+    model?: string;
+    systemPrompt?: string;
+    resumeSessionId?: string;
+}
+type AgentApprovalMode = "auto" | "interactive";
+type AgentPermissionKind = "bash" | "edit" | "tool" | "network" | "file-change" | "unknown";
+type AgentPermissionDecision = "allow" | "deny";
+interface AgentPermissionResponse {
+    requestId: string;
+    decision: AgentPermissionDecision;
+    remember?: boolean;
+}
+interface AgentOptionsBase {
+    sandbox?: Sandbox;
+    cwd?: string;
+    env?: Record<string, string>;
+    approvalMode?: AgentApprovalMode;
+    mcps?: AgentMcpConfig[];
+    skills?: AgentSkillConfig[];
+    subAgents?: AgentSubAgentConfig[];
+    commands?: AgentCommandConfig[];
+}
+interface CodexProviderOptions {
+    binary?: string;
+    env?: Record<string, string>;
+    brokerEndpoint?: string;
+    useBroker?: boolean;
+    hooks?: CodexHooksConfig;
+}
+interface OpenCodeProviderOptions {
+    binary?: string;
+    args?: string[];
+    plugins?: OpenCodePluginConfig[];
+}
+interface ClaudeCodeProviderOptions {
+    binary?: string;
+    args?: string[];
+    hooks?: ClaudeCodeHooksConfig;
+    permissionMode?: string;
+    allowedTools?: string[];
+    autoApproveTools?: boolean;
+    verbose?: boolean;
+}
+interface CodexAgentOptions extends AgentOptionsBase {
+    provider?: CodexProviderOptions;
+}
+interface OpenCodeAgentOptions extends AgentOptionsBase {
+    provider?: OpenCodeProviderOptions;
+}
+interface ClaudeCodeAgentOptions extends AgentOptionsBase {
+    provider?: ClaudeCodeProviderOptions;
+}
+type AgentOptionsMap = {
+    codex: CodexAgentOptions;
+    opencode: OpenCodeAgentOptions;
+    "claude-code": ClaudeCodeAgentOptions;
+};
+type AgentOptions<P extends AgentProviderName = AgentProviderName> = AgentOptionsMap[P];
+interface AgentResult {
+    id: string;
+    provider: AgentProviderName;
+    sessionId: string;
+    text: string;
+    rawEvents: RawAgentEvent[];
+    events: NormalizedAgentEvent[];
+}
+interface AgentRun extends AsyncIterable<NormalizedAgentEvent> {
+    id: string;
+    provider: AgentProviderName;
+    sessionId?: string;
+    readonly sessionIdReady: Promise<string>;
+    raw?: unknown;
+    rawEvents(): AsyncIterable<RawAgentEvent>;
+    toAISDKEvents(): AsyncIterable<AISDKEvent>;
+    respondToPermission(response: AgentPermissionResponse): Promise<void>;
+    sendMessage(content: UserContent): Promise<void>;
+    abort(): Promise<void>;
+    readonly finished: Promise<AgentResult>;
+}
+interface AgentRunSink {
+    setRaw(raw: unknown): void;
+    setAbort(abort: () => Promise<void>): void;
+    setSessionId(sessionId: string): void;
+    emitRaw(event: RawAgentEvent): void;
+    emitEvent(event: NormalizedAgentEvent): void;
+    requestPermission(event: PermissionRequestedEvent): Promise<AgentPermissionResponse>;
+    onMessage(handler: (content: UserContent) => Promise<void>): void;
+    complete(result?: {
+        text?: string;
+    }): void;
+    fail(error: unknown): void;
+}
+interface AgentExecutionRequest<P extends AgentProviderName = AgentProviderName> {
+    runId: string;
+    provider: P;
+    options: AgentOptions<P>;
+    run: AgentRunConfig;
+}
+interface AgentProviderAdapter<P extends AgentProviderName = AgentProviderName> {
+    execute(request: AgentExecutionRequest<P>, sink: AgentRunSink): Promise<() => Promise<void> | void>;
+}
+
+export { type RepoSkillConfig as $, type AISDKEvent as A, type CodexAgentOptions as B, type ClaudeCodeAgentOptions as C, type CodexCommandHook as D, type CodexHookEvent as E, type CodexHookMatcherGroup as F, type CodexHooksConfig as G, type CodexProviderOptions as H, type DataContent as I, type EmbeddedSkillConfig as J, type FilePart as K, type ImagePart as L, type MessageCompletedEvent as M, type MessageInjectedEvent as N, type MessageStartedEvent as O, type NormalizedAgentEvent as P, type NormalizedAgentEventBase as Q, type NormalizedAgentEventType as R, type OpenCodeAgentOptions as S, type OpenCodePluginConfig as T, type OpenCodePluginEvent as U, type OpenCodePluginHookConfig as V, type OpenCodeProviderOptions as W, type PermissionRequestedEvent as X, type PermissionResolvedEvent as Y, type RawAgentEvent as Z, type ReasoningDeltaEvent as _, type AgentApprovalMode as a, type RunCompletedEvent as a0, type RunErrorEvent as a1, type RunStartedEvent as a2, type TextDeltaEvent as a3, type TextPart as a4, type ToolCallCompletedEvent as a5, type ToolCallDeltaEvent as a6, type ToolCallStartedEvent as a7, type UserContent as a8, type UserContentPart as a9, createNormalizedEvent as aa, normalizeRawAgentEvent as ab, toAISDKEvent as ac, toAISDKStream as ad, type AgentCommandConfig as b, type AgentExecutionRequest as c, type AgentLocalMcpConfig as d, type AgentMcpConfig as e, type AgentOptions as f, type AgentOptionsBase as g, type AgentOptionsMap as h, type AgentPermissionDecision as i, type AgentPermissionKind as j, type AgentPermissionResponse as k, type AgentProviderAdapter as l, type AgentProviderName as m, type AgentRemoteMcpConfig as n, type AgentResult as o, type AgentRun as p, type AgentRunConfig as q, type AgentRunSink as r, type AgentSkillConfig as s, type AgentSubAgentConfig as t, type ClaudeCodeHookConfig as u, type ClaudeCodeHookEvent as v, type ClaudeCodeHookHandler as w, type ClaudeCodeHookMatcherGroup as x, type ClaudeCodeHooksConfig as y, type ClaudeCodeProviderOptions as z };

package/images/browser-agent.mjs

@@ -0,0 +1,55 @@
+const aptPackages = [
+  "ca-certificates",
+  "curl",
+  "chromium",
+  "git",
+  "python3",
+  "python3-pip",
+  "unzip",
+  "xdg-utils",
+  "libnss3",
+  "libgbm1",
+  "libxss1",
+  "libxshmfence1",
+  "libatk1.0-0",
+  "libatk-bridge2.0-0",
+  "libcups2",
+  "libdrm2",
+  "libxkbcommon0",
+  "libxcomposite1",
+  "libxdamage1",
+  "libxfixes3",
+  "libxrandr2",
+  "libpango-1.0-0",
+  "libcairo2",
+  "libasound2",
+  "fonts-liberation",
+  "fonts-freefont-ttf",
+  "libfreetype6",
+  "libharfbuzz0b",
+];
+
+export default {
+  name: "browser-agent",
+  base: "node:20-bookworm",
+  env: {
+    DEBIAN_FRONTEND: "noninteractive",
+    CHROME_BIN: "/usr/bin/chromium",
+    PUPPETEER_EXECUTABLE_PATH: "/usr/bin/chromium",
+    PUPPETEER_SKIP_DOWNLOAD: "true",
+    AGENT_BROWSER_EXECUTABLE_PATH: "/usr/bin/chromium",
+    AGENT_BROWSER_ARGS: "--no-sandbox",
+  },
+  run: [
+    `apt-get update && apt-get install -y --no-install-recommends ${aptPackages.join(" ")} && rm -rf /var/lib/apt/lists/*`,
+    "npm cache clean --force",
+    "npm install -g pnpm @anthropic-ai/claude-code @openai/codex opencode-ai agent-browser",
+    "agent-browser set viewport 1980 1080",
+  ],
+  workdir: "/workspace",
+  cmd: ["sleep", "infinity"],
+  resources: {
+    cpu: 4,
+    memoryMiB: 8192,
+  },
+};

package/images/computer-use.mjs

@@ -0,0 +1,29 @@
+import browserAgent from "./browser-agent.mjs";
+
+const aptPackages = [
+  "xvfb",
+  "xauth",
+  "openbox",
+  "xdotool",
+  "scrot",
+  "imagemagick",
+  "ffmpeg",
+  "x11-utils",
+  "dbus-x11",
+];
+
+export default {
+  ...browserAgent,
+  name: "computer-use",
+  env: {
+    ...browserAgent.env,
+    DISPLAY: ":1",
+    DISPLAY_NUM: "1",
+    WIDTH: "1980",
+    HEIGHT: "1080",
+  },
+  run: [
+    ...browserAgent.run,
+    `apt-get update && apt-get install -y --no-install-recommends ${aptPackages.join(" ")} && rm -rf /var/lib/apt/lists/*`,
+  ],
+};

package/package.json

@@ -1,7 +1,100 @@
 {
   "name": "agentbox-sdk",
-  "version": "0.0.0",
-  "description": "AgentBox SDK by Twill AI",
-  "main": "index.js",
-  "license": "MIT"
+  "version": "0.1.1",
+  "description": "Swappable coding agents and sandbox providers for Bun and TypeScript.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TwillAI/agentbox-sdk.git"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "images"
+  ],
+  "bin": {
+    "agentbox": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./agents": {
+      "types": "./dist/agents/index.d.ts",
+      "import": "./dist/agents/index.js"
+    },
+    "./sandboxes": {
+      "types": "./dist/sandboxes/index.d.ts",
+      "import": "./dist/sandboxes/index.js"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "import": "./dist/events/index.js"
+    },
+    "./enums": {
+      "types": "./dist/enums.d.ts",
+      "import": "./dist/enums.js"
+    }
+  },
+  "scripts": {
+    "dev": "tsup src/index.ts src/enums.ts src/agents/index.ts src/sandboxes/index.ts src/events/index.ts src/cli.ts --format esm --dts --clean --watch",
+    "build": "tsup src/index.ts src/enums.ts src/agents/index.ts src/sandboxes/index.ts src/events/index.ts src/cli.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --max-warnings=0",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:e2e:matrix": "vitest run test/live-matrix.e2e.test.ts",
+    "test:smoke": "vitest run test/smoke.test.ts",
+    "test:watch": "vitest",
+    "check": "npm run typecheck && npm run lint && npm run test",
+    "hooks:install": "lefthook install",
+    "prepare": "if [ -d .git ]; then lefthook install; else echo 'Skipping lefthook install (no .git directory)'; fi"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "bun": ">=1.1.0"
+  },
+  "dependencies": {
+    "@daytonaio/sdk": "^0.161.0",
+    "@vercel/sandbox": "2.0.0-beta.13",
+    "dockerode": "^4.0.10",
+    "e2b": "^2.19.0",
+    "eventsource-parser": "^3.0.6",
+    "modal": "^0.7.4",
+    "tar-stream": "^3.1.8",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/dockerode": "^3.3.42",
+    "@types/node": "^25.5.2",
+    "@types/tar-stream": "^3.1.4",
+    "@types/ws": "^8.18.1",
+    "eslint": "^10.2.0",
+    "globals": "^17.4.0",
+    "lefthook": "^2.1.5",
+    "tsup": "^8.5.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^3.1.2"
+  },
+  "keywords": [
+    "agentbox",
+    "agents",
+    "codex",
+    "claude-code",
+    "opencode",
+    "sandbox",
+    "e2b",
+    "modal",
+    "daytona",
+    "docker",
+    "vercel",
+    "typescript",
+    "bun"
+  ]
 }

package/index.js

@@ -1 +0,0 @@
-// placeholder