Devin on Cloudflare Agents

​

Setup

npm install @cognition-ai/cloudflare-agents@beta @cognition-ai/sdk@beta agents @cloudflare/ai-chat ai
wrangler secret put DEVIN_API_KEY

​

Server

import { DevinChatAgent } from "@cognition-ai/cloudflare-agents";
import { routeAgentRequest } from "agents";

export class DevinChat extends DevinChatAgent<Env> {}

export default {
  async fetch(request, env) {
    return (await routeAgentRequest(request, env)) ?? new Response("Not found", { status: 404 });
  },
} satisfies ExportedHandler<Env>;

{
  "compatibility_flags": ["nodejs_compat"],
  "durable_objects": { "bindings": [{ "class_name": "DevinChat", "name": "DevinChat" }] },
  "migrations": [{ "new_sqlite_classes": ["DevinChat"], "tag": "v1" }],
}

import { CloudDevin } from "@cognition-ai/sdk";

export class DevinChat extends DevinChatAgent<Env> {
  protected override connectDevin() {
    return CloudDevin.connect({ apiKey: this.env.DEVIN_API_KEY, orgId: this.env.DEVIN_ORG_ID });
  }

  protected override sessionOptions() {
    return { repos: ["acme/app"] };
  }
}

​

Client

import type { DevinChatMessage, DevinChatState } from "@cognition-ai/cloudflare-agents";
import { useAgentChat } from "@cloudflare/ai-chat/react";
import { useAgent } from "agents/react";
import { lastAssistantMessageIsCompleteWithApprovalResponses } from "ai";

const agent = useAgent<DevinChatState>({ agent: "DevinChat", name: chatId });
const chat = useAgentChat<unknown, DevinChatMessage>({
  agent,
  sendAutomaticallyWhen: lastAssistantMessageIsCompleteWithApprovalResponses,
});

​

What the agent does

• One turn per message. The first message creates a Devin session; later ones attach to it, including after hibernation, a deploy, or from another client. Messages sent mid-turn queue.
• Stop. chat.stop() cancels the Devin turn. A command Devin was already running finishes in its cloud VM; its late output is dropped rather than folded into the next turn.
• Permissions. Devin’s permission requests arrive as AI SDK tool approvals. Answer them with chat.addToolApprovalResponse({ id, approved }), and the same turn resumes. Approving picks allow-once; denying picks reject-once.
• Start over. agent.stub.startOver() detaches from the session and stops the turn, so the next message starts a new session. Clear the transcript with chat.clearHistory(). The old session keeps running in the cloud.
• Continue an existing session. agent.stub.importSession(id) rebuilds the transcript from the session’s replay and attaches future turns to it — the way to pick up a session started in the Devin app. It throws on a chat that already has a session or messages. parseSessionId(input) accepts a session id or a Devin web app URL.
• Recovery. If the Durable Object restarts mid-turn, what already streamed is kept and the prompt is not sent again: Devin already has it.
• Late events. Events from a turn the chat moved on from (stopped, started over) never touch the new session’s state.

​

Building your own agent