@cognition-ai/cloudflare-agents 0.0.0 → 0.0.1-beta.2

package/README.md

@@ -1,13 +1,107 @@
-# @cognition-ai/cloudflare-agents
+# Cloudflare Agents - Devin chat agents
 
-This version (`0.0.0`) is a placeholder. The package is in private beta and has not been
-publicly released, so it deliberately fails to install.
+Puts a [Devin](https://devin.ai) cloud session behind a
+[Cloudflare Agents](https://developers.cloudflare.com/agents/) `AIChatAgent`, so `useAgentChat`
+drives Devin the way it drives a model. Each chat is a Durable Object that owns one Devin session:
+the API key stays in the Worker, and the session keeps working in the cloud while the Durable Object
+hibernates.
+
+Built on [`@cognition-ai/ai-sdk`](https://www.npmjs.com/package/@cognition-ai/ai-sdk), which does the
+event-to-UI-message mapping.
+
+## Setup
 
 ```sh
-npm i @cognition-ai/cloudflare-agents@beta
+bun add @cognition-ai/cloudflare-agents@beta @cognition-ai/sdk@beta agents @cloudflare/ai-chat ai
+wrangler secret put DEVIN_API_KEY
+```
+
+Like `@cognition-ai/sdk`, the package is beta-only: releases are `0.0.1-beta.N` prereleases on the
+`beta` dist-tag, so the `@beta` suffix is required until the public launch.
+
+## Server
+
+```ts
+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>;
+```
+
+```jsonc
+// wrangler.jsonc
+{
+  "compatibility_flags": ["nodejs_compat"],
+  "durable_objects": { "bindings": [{ "class_name": "DevinChat", "name": "DevinChat" }] },
+  "migrations": [{ "new_sqlite_classes": ["DevinChat"], "tag": "v1" }],
+}
+```
+
+`DevinChatAgent` reads `DEVIN_API_KEY`, and optionally `DEVIN_ORG_ID` and `DEVIN_BASE_URL`, from the
+Worker's bindings. Override the hooks for anything else:
+
+```ts
+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
+
+```tsx
+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,
+});
 ```
 
-`0.0.0` exists only to hold the `latest` dist-tag — the npm registry assigns `latest` to
-whatever version a package is first published with, even when publishing with
-`--tag beta`, so without it a bare `npm i @cognition-ai/cloudflare-agents` would silently install a
-beta.
+`agent.state` holds the session id and URL, status, activity, plan and pull requests, and updates
+live. Messages carry text, reasoning, `dynamic-tool` parts, and `data-devin-plan` /
+`data-devin-pull-request` parts; see `@cognition-ai/ai-sdk` for the full mapping.
+
+## 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.
+- **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. 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.
+
+Workers can't start processes, so this uses cloud sessions only; `LocalDevin` needs Node.js or Bun.
+
+## Building your own agent
+
+For a different agent shape, `connectDevin(env)` opens a connection from the bindings, and
+`reduceDevinChatState(state, event)` projects session events onto `DevinChatState`. Combine them with
+`toUIMessageStream`, `toUIMessages` and `ToolApprovals` from `@cognition-ai/ai-sdk`.

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cognition AI, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/connect.d.ts

@@ -0,0 +1,17 @@
+import { CloudDevin, type CloudDevinOptions } from "@cognition-ai/sdk";
+/** The Worker bindings {@link connectDevin} reads. */
+export interface DevinEnv {
+    /** A Devin API key (`cog_…`). Store it with `wrangler secret put DEVIN_API_KEY`. */
+    DEVIN_API_KEY?: string;
+    /** The organization sessions belong to, for keys that can reach several. */
+    DEVIN_ORG_ID?: string;
+    /** The Devin API, e.g. a staging deployment. Defaults to `https://api.devin.ai`. */
+    DEVIN_BASE_URL?: string;
+}
+/**
+ * Connect to Devin with a Worker's bindings. Empty `DEVIN_ORG_ID` and
+ * `DEVIN_BASE_URL` vars count as unset.
+ *
+ * @throws {DevinError} when `DEVIN_API_KEY` is missing, or the key is rejected.
+ */
+export declare function connectDevin(env: DevinEnv, options?: Omit<CloudDevinOptions, "apiKey">): Promise<CloudDevin>;

package/dist/connect.js

@@ -0,0 +1,25 @@
+import { CloudDevin, DevinError } from "@cognition-ai/sdk";
+/**
+ * Connect to Devin with a Worker's bindings. Empty `DEVIN_ORG_ID` and
+ * `DEVIN_BASE_URL` vars count as unset.
+ *
+ * @throws {DevinError} when `DEVIN_API_KEY` is missing, or the key is rejected.
+ */
+export async function connectDevin(env, options = {}) {
+    const apiKey = nonEmpty(env.DEVIN_API_KEY);
+    if (apiKey === undefined) {
+        throw new DevinError("DEVIN_API_KEY is not set. Add it to .dev.vars (or .env) for local development, or run `wrangler secret put DEVIN_API_KEY`.");
+    }
+    const orgId = nonEmpty(env.DEVIN_ORG_ID);
+    const baseUrl = nonEmpty(env.DEVIN_BASE_URL);
+    return CloudDevin.connect({
+        ...(orgId !== undefined ? { orgId } : {}),
+        ...(baseUrl !== undefined ? { baseUrl } : {}),
+        ...options,
+        apiKey,
+    });
+}
+function nonEmpty(value) {
+    return value === undefined || value === "" ? undefined : value;
+}
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAA0B,MAAM,mBAAmB,CAAC;AAYnF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAa,EACb,UAA6C,EAAE;IAE/C,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,UAAU,CAClB,4HAA4H,CAC7H,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC,OAAO,CAAC;QACxB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,OAAO;QACV,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB;IACzC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACjE,CAAC","sourcesContent":["import { CloudDevin, DevinError, type CloudDevinOptions } from \"@cognition-ai/sdk\";\n\n/** The Worker bindings {@link connectDevin} reads. */\nexport interface DevinEnv {\n  /** A Devin API key (`cog_…`). Store it with `wrangler secret put DEVIN_API_KEY`. */\n  DEVIN_API_KEY?: string;\n  /** The organization sessions belong to, for keys that can reach several. */\n  DEVIN_ORG_ID?: string;\n  /** The Devin API, e.g. a staging deployment. Defaults to `https://api.devin.ai`. */\n  DEVIN_BASE_URL?: string;\n}\n\n/**\n * Connect to Devin with a Worker's bindings. Empty `DEVIN_ORG_ID` and\n * `DEVIN_BASE_URL` vars count as unset.\n *\n * @throws {DevinError} when `DEVIN_API_KEY` is missing, or the key is rejected.\n */\nexport async function connectDevin(\n  env: DevinEnv,\n  options: Omit<CloudDevinOptions, \"apiKey\"> = {},\n): Promise<CloudDevin> {\n  const apiKey = nonEmpty(env.DEVIN_API_KEY);\n  if (apiKey === undefined) {\n    throw new DevinError(\n      \"DEVIN_API_KEY is not set. Add it to .dev.vars (or .env) for local development, or run `wrangler secret put DEVIN_API_KEY`.\",\n    );\n  }\n  const orgId = nonEmpty(env.DEVIN_ORG_ID);\n  const baseUrl = nonEmpty(env.DEVIN_BASE_URL);\n  return CloudDevin.connect({\n    ...(orgId !== undefined ? { orgId } : {}),\n    ...(baseUrl !== undefined ? { baseUrl } : {}),\n    ...options,\n    apiKey,\n  });\n}\n\nfunction nonEmpty(value: string | undefined): string | undefined {\n  return value === undefined || value === \"\" ? undefined : value;\n}\n"]}

package/dist/devin-chat-agent.d.ts

@@ -0,0 +1,67 @@
+import { AIChatAgent, type ChatRecoveryContext, type ChatRecoveryOptions, type OnChatMessageOptions } from "@cloudflare/ai-chat";
+import { type DevinMessageMetadata, type DevinUIMessage } from "@cognition-ai/ai-sdk";
+import { type CloudDevin, type CloudSessionOptions } from "@cognition-ai/sdk";
+import { type DevinEnv } from "./connect.js";
+import { type DevinChatState } from "./state.js";
+/** The messages a {@link DevinChatAgent} streams: `useAgentChat<DevinChatMessage>()`. */
+export type DevinChatMessage = DevinUIMessage<DevinMessageMetadata>;
+/** What {@link DevinChatAgent.importSession} rebuilt. */
+export interface ImportedSession {
+    sessionId: string;
+    sessionUrl: string | null;
+    /** The first user message's text, e.g. for a chat title. */
+    title: string | null;
+    /** How many messages the replay produced. */
+    messages: number;
+}
+/**
+ * An `AIChatAgent` backed by a Devin cloud session instead of a model, so
+ * `useAgentChat` drives Devin unchanged.
+ *
+ * - Each chat message prompts the chat's Devin session and streams the turn
+ *   with `@cognition-ai/ai-sdk`'s `toUIMessageStream`: text, reasoning, tool
+ *   calls, plans and pull requests.
+ * - The session id lives in Agent state, so later turns attach to the same
+ *   session after hibernation, a deploy or from another client. Devin keeps
+ *   working in the cloud between turns.
+ * - Permission requests are AI SDK tool approvals. `addToolApprovalResponse`
+ *   answers them and Cloudflare's auto-continuation resumes the turn.
+ * - Stopping the client cancels the Devin turn; {@link startOver} detaches.
+ *
+ * ```ts
+ * export class DevinChat extends DevinChatAgent<Env> {}
+ * ```
+ *
+ * reads `DEVIN_API_KEY` (and optional `DEVIN_ORG_ID`, `DEVIN_BASE_URL`) from
+ * the Worker's bindings. Override {@link connectDevin} for per-user tokens.
+ */
+export declare class DevinChatAgent<Env extends Cloudflare.Env & DevinEnv = Cloudflare.Env & DevinEnv> extends AIChatAgent<Env, DevinChatState> {
+    #private;
+    initialState: DevinChatState;
+    /** A Devin session runs one turn at a time, so messages sent mid-turn wait their turn. */
+    messageConcurrency: "queue";
+    /** Open the Devin connection a turn uses. Override for per-user tokens or other options. */
+    protected connectDevin(): Promise<CloudDevin>;
+    /** Options for the session the first turn creates, e.g. `{ repos: ["acme/app"] }`. */
+    protected sessionOptions(): Omit<CloudSessionOptions, "onPermission">;
+    onChatMessage(_onFinish: unknown, options?: OnChatMessageOptions): Promise<Response>;
+    /**
+     * Detach from the Devin session so the next message starts a new one, and
+     * stop the running turn. The old session keeps running in the cloud. Clear
+     * the transcript on the client with `clearHistory()`.
+     */
+    startOver(): void;
+    /**
+     * Start this chat from an existing cloud session: rebuild its transcript
+     * from the replayed tail and attach future turns to it.
+     *
+     * @throws {DevinError} when the chat already has a session or messages, or
+     *   the session can't be loaded.
+     */
+    importSession(sessionId: string): Promise<ImportedSession>;
+    /**
+     * A Durable Object restart interrupted a turn. Keep what streamed, but don't
+     * send the prompt again: Devin already has it and keeps working in the cloud.
+     */
+    protected onChatRecovery(_ctx: ChatRecoveryContext): Promise<ChatRecoveryOptions>;
+}

package/dist/devin-chat-agent.js

@@ -0,0 +1,404 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { AIChatAgent, } from "@cloudflare/ai-chat";
+import { devinSessionMetadata, toPromptInput, toUIMessages, toUIMessageStream, ToolApprovals, } from "@cognition-ai/ai-sdk";
+import { DevinError, SessionEventReducer, } from "@cognition-ai/sdk";
+import { callable } from "agents";
+import { createUIMessageStream, createUIMessageStreamResponse, isToolUIPart, } from "ai";
+import { connectDevin as connectFromEnv } from "./connect.js";
+import { initialDevinChatState, reduceDevinChatState } from "./state.js";
+/**
+ * An `AIChatAgent` backed by a Devin cloud session instead of a model, so
+ * `useAgentChat` drives Devin unchanged.
+ *
+ * - Each chat message prompts the chat's Devin session and streams the turn
+ *   with `@cognition-ai/ai-sdk`'s `toUIMessageStream`: text, reasoning, tool
+ *   calls, plans and pull requests.
+ * - The session id lives in Agent state, so later turns attach to the same
+ *   session after hibernation, a deploy or from another client. Devin keeps
+ *   working in the cloud between turns.
+ * - Permission requests are AI SDK tool approvals. `addToolApprovalResponse`
+ *   answers them and Cloudflare's auto-continuation resumes the turn.
+ * - Stopping the client cancels the Devin turn; {@link startOver} detaches.
+ *
+ * ```ts
+ * export class DevinChat extends DevinChatAgent<Env> {}
+ * ```
+ *
+ * reads `DEVIN_API_KEY` (and optional `DEVIN_ORG_ID`, `DEVIN_BASE_URL`) from
+ * the Worker's bindings. Override {@link connectDevin} for per-user tokens.
+ */
+let DevinChatAgent = (() => {
+    let _classSuper = AIChatAgent;
+    let _instanceExtraInitializers = [];
+    let _startOver_decorators;
+    return class DevinChatAgent extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _startOver_decorators = [callable()];
+            __esDecorate(this, null, _startOver_decorators, { kind: "method", name: "startOver", static: false, private: false, access: { has: obj => "startOver" in obj, get: obj => obj.startOver }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        initialState = (__runInitializers(this, _instanceExtraInitializers), initialDevinChatState);
+        /** A Devin session runs one turn at a time, so messages sent mid-turn wait their turn. */
+        messageConcurrency = "queue";
+        #turn;
+        /** Bumped whenever the running turn is replaced, so its late events can't touch state. */
+        #epoch = 0;
+        /** Open the Devin connection a turn uses. Override for per-user tokens or other options. */
+        connectDevin() {
+            return connectFromEnv(this.env);
+        }
+        /** Options for the session the first turn creates, e.g. `{ repos: ["acme/app"] }`. */
+        sessionOptions() {
+            return {};
+        }
+        onChatMessage(_onFinish, options) {
+            const signal = options?.abortSignal;
+            const turn = this.#turn;
+            const resumed = turn?.approvals.respond(this.messages);
+            if (turn !== undefined && resumed !== undefined) {
+                turn.follow(signal);
+                return Promise.resolve(createUIMessageStreamResponse({ stream: resumed }));
+            }
+            if (options?.continuation === true) {
+                return Promise.resolve(createUIMessageStreamResponse({ stream: this.#settleOrphans() }));
+            }
+            this.#replaceTurn();
+            return Promise.resolve(createUIMessageStreamResponse({ stream: this.#prompt(signal) }));
+        }
+        /**
+         * Detach from the Devin session so the next message starts a new one, and
+         * stop the running turn. The old session keeps running in the cloud. Clear
+         * the transcript on the client with `clearHistory()`.
+         */
+        startOver() {
+            this.#replaceTurn();
+            this.resetTurnState();
+            this.setState(initialDevinChatState);
+        }
+        /**
+         * Start this chat from an existing cloud session: rebuild its transcript
+         * from the replayed tail and attach future turns to it.
+         *
+         * @throws {DevinError} when the chat already has a session or messages, or
+         *   the session can't be loaded.
+         */
+        async importSession(sessionId) {
+            if (this.state.sessionId !== null || this.messages.length > 0) {
+                throw new DevinError("This chat already has a Devin session.");
+            }
+            const loaded = await this.#load(sessionId);
+            const messages = await toUIMessages(loaded.replay);
+            const reducer = new SessionEventReducer();
+            let state = {
+                ...initialDevinChatState,
+                sessionId: loaded.sessionId,
+                sessionUrl: loaded.sessionUrl,
+            };
+            for (const update of loaded.replay)
+                state = reduceDevinChatState(state, reducer.handle(update));
+            await this.persistMessages(messages);
+            this.setState(state);
+            const first = messages.find((message) => message.role === "user");
+            const title = first?.parts
+                .flatMap((part) => (part.type === "text" ? [part.text] : []))
+                .join(" ");
+            return {
+                sessionId: loaded.sessionId,
+                sessionUrl: loaded.sessionUrl,
+                title: title === undefined || title === "" ? null : title,
+                messages: messages.length,
+            };
+        }
+        /**
+         * A Durable Object restart interrupted a turn. Keep what streamed, but don't
+         * send the prompt again: Devin already has it and keeps working in the cloud.
+         */
+        onChatRecovery(_ctx) {
+            return Promise.resolve({ persist: true, continue: false });
+        }
+        #prompt(signal) {
+            const epoch = this.#epoch;
+            return createUIMessageStream({
+                onError: errorText,
+                execute: async ({ writer }) => {
+                    const prompt = toPromptInput(this.messages);
+                    const devin = await this.connectDevin();
+                    let session;
+                    try {
+                        session = await this.#openSession(devin, epoch);
+                    }
+                    catch (error) {
+                        devin.close();
+                        throw error;
+                    }
+                    if (signal?.aborted === true || epoch !== this.#epoch) {
+                        devin.close();
+                        return;
+                    }
+                    const turn = new Turn(devin, session, () => {
+                        if (this.#turn === turn)
+                            this.#turn = undefined;
+                    });
+                    this.#turn = turn;
+                    turn.follow(signal);
+                    writer.merge(toUIMessageStream(turn.events(prompt, toolCallIds(this.messages)), {
+                        approvals: turn.approvals,
+                        messageMetadata: devinSessionMetadata(session),
+                        onError: errorText,
+                        onEvent: (event) => {
+                            this.#project(epoch, session, event);
+                        },
+                    }));
+                },
+            });
+        }
+        async #openSession(devin, epoch) {
+            const { sessionId } = this.state;
+            if (sessionId !== null)
+                return devin.attach(sessionId);
+            const session = await devin.createSession(this.sessionOptions());
+            if (epoch === this.#epoch) {
+                this.setState({ ...this.state, sessionId: session.id, sessionUrl: session.url ?? null });
+            }
+            return session;
+        }
+        #project(epoch, session, event) {
+            if (epoch !== this.#epoch || this.state.sessionId !== session.id)
+                return;
+            let next = reduceDevinChatState(this.state, event);
+            const url = session.url ?? next.sessionUrl;
+            if (url !== next.sessionUrl)
+                next = { ...next, sessionUrl: url };
+            if (next !== this.state)
+                this.setState(next);
+        }
+        /** Stop the running turn and fence off its late events. */
+        #replaceTurn() {
+            this.#epoch++;
+            const turn = this.#turn;
+            this.#turn = undefined;
+            turn?.stop();
+        }
+        /**
+         * An approval arrived for a turn this agent no longer holds (it was stopped,
+         * or the Durable Object restarted). End those tool calls instead of leaving
+         * them spinning.
+         */
+        #settleOrphans() {
+            const last = this.messages.at(-1);
+            const parts = last?.role === "assistant" ? last.parts.filter(isToolUIPart) : [];
+            return createUIMessageStream({
+                execute: ({ writer }) => {
+                    writer.write({ type: "start" });
+                    for (const part of parts) {
+                        if (part.state !== "approval-responded")
+                            continue;
+                        writer.write({
+                            type: "tool-output-error",
+                            toolCallId: part.toolCallId,
+                            errorText: "This Devin turn ended before the approval arrived.",
+                            dynamic: true,
+                        });
+                    }
+                    writer.write({ type: "finish", finishReason: "other" });
+                },
+            });
+        }
+        async #load(sessionId) {
+            const env_1 = { stack: [], error: void 0, hasError: false };
+            try {
+                const devin = __addDisposableResource(env_1, await this.connectDevin(), true);
+                try {
+                    const { session, replay } = await devin.loadSession(sessionId, { replay: "tail" });
+                    return { sessionId: session.id, sessionUrl: session.url ?? null, replay };
+                }
+                catch (error) {
+                    throw new DevinError(`Could not load Devin session ${sessionId}: ${errorText(error)}`);
+                }
+            }
+            catch (e_1) {
+                env_1.error = e_1;
+                env_1.hasError = true;
+            }
+            finally {
+                const result_1 = __disposeResources(env_1);
+                if (result_1)
+                    await result_1;
+            }
+        }
+    };
+})();
+export { DevinChatAgent };
+/** One Devin turn: its connection, its approvals, and a way to stop it. */
+class Turn {
+    approvals = new ToolApprovals();
+    #devin;
+    #session;
+    #stop = new AbortController();
+    #onClose;
+    #started = false;
+    #closed = false;
+    constructor(devin, session, onClose) {
+        this.#devin = devin;
+        this.#session = session;
+        this.#onClose = onClose;
+        session.onPermission = this.approvals.onPermission;
+    }
+    /**
+     * The turn's events, minus updates for tool calls that belong to an earlier
+     * message: stopping a turn does not stop the command Devin was running, so
+     * it can finish during a later turn. Its part lives in a message this
+     * stream can't reach, and `AIChatAgent` folds messages that share a tool
+     * call id into one, which would overwrite the earlier reply.
+     */
+    async *events(prompt, earlierToolCalls) {
+        this.#started = true;
+        const turn = this.#session.stream(prompt, { signal: this.#stop.signal });
+        let finished = false;
+        try {
+            for (;;) {
+                const next = await turn.next();
+                if (next.done) {
+                    finished = true;
+                    return next.value;
+                }
+                const event = next.value;
+                if (event.type === "tool_call" && earlierToolCalls.has(event.call.id))
+                    continue;
+                yield event;
+            }
+        }
+        finally {
+            // The consumer stopped early: let the SDK's generator run its cleanup too.
+            if (!finished)
+                await turn.return(undefined);
+            this.#close();
+        }
+    }
+    /** Stop the turn when this request's signal aborts (the client pressed stop). */
+    follow(signal) {
+        if (signal === undefined)
+            return;
+        if (signal.aborted) {
+            this.stop();
+            return;
+        }
+        signal.addEventListener("abort", () => {
+            this.stop();
+        }, { once: true });
+    }
+    stop() {
+        this.#stop.abort(new DevinError("The Devin turn was stopped."));
+        this.approvals.cancel();
+        if (!this.#started)
+            this.#close();
+    }
+    #close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.approvals.cancel();
+        this.#devin.close();
+        this.#onClose();
+    }
+}
+/** Ids of every tool call in the transcript so far. */
+function toolCallIds(messages) {
+    const ids = new Set();
+    for (const message of messages) {
+        for (const part of message.parts)
+            if (isToolUIPart(part))
+                ids.add(part.toolCallId);
+    }
+    return ids;
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=devin-chat-agent.js.map

package/dist/devin-chat-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devin-chat-agent.js","sourceRoot":"","sources":["../src/devin-chat-agent.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  AIChatAgent,\n  type ChatRecoveryContext,\n  type ChatRecoveryOptions,\n  type OnChatMessageOptions,\n} from \"@cloudflare/ai-chat\";\nimport {\n  devinSessionMetadata,\n  toPromptInput,\n  toUIMessages,\n  toUIMessageStream,\n  ToolApprovals,\n  type DevinMessageMetadata,\n  type DevinUIMessage,\n} from \"@cognition-ai/ai-sdk\";\nimport {\n  DevinError,\n  SessionEventReducer,\n  type CloudDevin,\n  type CloudSession,\n  type CloudSessionOptions,\n  type PromptInput,\n  type PromptResult,\n  type SessionEvent,\n} from \"@cognition-ai/sdk\";\nimport { callable } from \"agents\";\nimport {\n  createUIMessageStream,\n  createUIMessageStreamResponse,\n  isToolUIPart,\n  type InferUIMessageChunk,\n  type UIMessage,\n} from \"ai\";\n\nimport { connectDevin as connectFromEnv, type DevinEnv } from \"./connect.js\";\nimport { initialDevinChatState, reduceDevinChatState, type DevinChatState } from \"./state.js\";\n\n/** The messages a {@link DevinChatAgent} streams: `useAgentChat<DevinChatMessage>()`. */\nexport type DevinChatMessage = DevinUIMessage<DevinMessageMetadata>;\n\ntype DevinChatChunk = InferUIMessageChunk<DevinChatMessage>;\n\n/** What {@link DevinChatAgent.importSession} rebuilt. */\nexport interface ImportedSession {\n  sessionId: string;\n  sessionUrl: string | null;\n  /** The first user message's text, e.g. for a chat title. */\n  title: string | null;\n  /** How many messages the replay produced. */\n  messages: number;\n}\n\n/**\n * An `AIChatAgent` backed by a Devin cloud session instead of a model, so\n * `useAgentChat` drives Devin unchanged.\n *\n * - Each chat message prompts the chat's Devin session and streams the turn\n *   with `@cognition-ai/ai-sdk`'s `toUIMessageStream`: text, reasoning, tool\n *   calls, plans and pull requests.\n * - The session id lives in Agent state, so later turns attach to the same\n *   session after hibernation, a deploy or from another client. Devin keeps\n *   working in the cloud between turns.\n * - Permission requests are AI SDK tool approvals. `addToolApprovalResponse`\n *   answers them and Cloudflare's auto-continuation resumes the turn.\n * - Stopping the client cancels the Devin turn; {@link startOver} detaches.\n *\n * ```ts\n * export class DevinChat extends DevinChatAgent<Env> {}\n * ```\n *\n * reads `DEVIN_API_KEY` (and optional `DEVIN_ORG_ID`, `DEVIN_BASE_URL`) from\n * the Worker's bindings. Override {@link connectDevin} for per-user tokens.\n */\nexport class DevinChatAgent<\n  Env extends Cloudflare.Env & DevinEnv = Cloudflare.Env & DevinEnv,\n> extends AIChatAgent<Env, DevinChatState> {\n  override initialState: DevinChatState = initialDevinChatState;\n  /** A Devin session runs one turn at a time, so messages sent mid-turn wait their turn. */\n  override messageConcurrency = \"queue\" as const;\n\n  #turn: Turn | undefined;\n  /** Bumped whenever the running turn is replaced, so its late events can't touch state. */\n  #epoch = 0;\n\n  /** Open the Devin connection a turn uses. Override for per-user tokens or other options. */\n  protected connectDevin(): Promise<CloudDevin> {\n    return connectFromEnv(this.env);\n  }\n\n  /** Options for the session the first turn creates, e.g. `{ repos: [\"acme/app\"] }`. */\n  protected sessionOptions(): Omit<CloudSessionOptions, \"onPermission\"> {\n    return {};\n  }\n\n  override onChatMessage(_onFinish: unknown, options?: OnChatMessageOptions): Promise<Response> {\n    const signal = options?.abortSignal;\n    const turn = this.#turn;\n    const resumed = turn?.approvals.respond(this.messages);\n    if (turn !== undefined && resumed !== undefined) {\n      turn.follow(signal);\n      return Promise.resolve(createUIMessageStreamResponse({ stream: resumed }));\n    }\n    if (options?.continuation === true) {\n      return Promise.resolve(createUIMessageStreamResponse({ stream: this.#settleOrphans() }));\n    }\n    this.#replaceTurn();\n    return Promise.resolve(createUIMessageStreamResponse({ stream: this.#prompt(signal) }));\n  }\n\n  /**\n   * Detach from the Devin session so the next message starts a new one, and\n   * stop the running turn. The old session keeps running in the cloud. Clear\n   * the transcript on the client with `clearHistory()`.\n   */\n  @callable()\n  startOver(): void {\n    this.#replaceTurn();\n    this.resetTurnState();\n    this.setState(initialDevinChatState);\n  }\n\n  /**\n   * Start this chat from an existing cloud session: rebuild its transcript\n   * from the replayed tail and attach future turns to it.\n   *\n   * @throws {DevinError} when the chat already has a session or messages, or\n   *   the session can't be loaded.\n   */\n  async importSession(sessionId: string): Promise<ImportedSession> {\n    if (this.state.sessionId !== null || this.messages.length > 0) {\n      throw new DevinError(\"This chat already has a Devin session.\");\n    }\n    const loaded = await this.#load(sessionId);\n    const messages = await toUIMessages(loaded.replay);\n    const reducer = new SessionEventReducer();\n    let state: DevinChatState = {\n      ...initialDevinChatState,\n      sessionId: loaded.sessionId,\n      sessionUrl: loaded.sessionUrl,\n    };\n    for (const update of loaded.replay) state = reduceDevinChatState(state, reducer.handle(update));\n\n    await this.persistMessages(messages);\n    this.setState(state);\n    const first = messages.find((message) => message.role === \"user\");\n    const title = first?.parts\n      .flatMap((part) => (part.type === \"text\" ? [part.text] : []))\n      .join(\" \");\n    return {\n      sessionId: loaded.sessionId,\n      sessionUrl: loaded.sessionUrl,\n      title: title === undefined || title === \"\" ? null : title,\n      messages: messages.length,\n    };\n  }\n\n  /**\n   * A Durable Object restart interrupted a turn. Keep what streamed, but don't\n   * send the prompt again: Devin already has it and keeps working in the cloud.\n   */\n  protected override onChatRecovery(_ctx: ChatRecoveryContext): Promise<ChatRecoveryOptions> {\n    return Promise.resolve({ persist: true, continue: false });\n  }\n\n  #prompt(signal: AbortSignal | undefined): ReadableStream<DevinChatChunk> {\n    const epoch = this.#epoch;\n    return createUIMessageStream<DevinChatMessage>({\n      onError: errorText,\n      execute: async ({ writer }) => {\n        const prompt = toPromptInput(this.messages);\n        const devin = await this.connectDevin();\n        let session: CloudSession;\n        try {\n          session = await this.#openSession(devin, epoch);\n        } catch (error) {\n          devin.close();\n          throw error;\n        }\n        if (signal?.aborted === true || epoch !== this.#epoch) {\n          devin.close();\n          return;\n        }\n        const turn = new Turn(devin, session, () => {\n          if (this.#turn === turn) this.#turn = undefined;\n        });\n        this.#turn = turn;\n        turn.follow(signal);\n        writer.merge(\n          toUIMessageStream(turn.events(prompt, toolCallIds(this.messages)), {\n            approvals: turn.approvals,\n            messageMetadata: devinSessionMetadata(session),\n            onError: errorText,\n            onEvent: (event) => {\n              this.#project(epoch, session, event);\n            },\n          }),\n        );\n      },\n    });\n  }\n\n  async #openSession(devin: CloudDevin, epoch: number): Promise<CloudSession> {\n    const { sessionId } = this.state;\n    if (sessionId !== null) return devin.attach(sessionId);\n    const session = await devin.createSession(this.sessionOptions());\n    if (epoch === this.#epoch) {\n      this.setState({ ...this.state, sessionId: session.id, sessionUrl: session.url ?? null });\n    }\n    return session;\n  }\n\n  #project(epoch: number, session: CloudSession, event: SessionEvent): void {\n    if (epoch !== this.#epoch || this.state.sessionId !== session.id) return;\n    let next = reduceDevinChatState(this.state, event);\n    const url = session.url ?? next.sessionUrl;\n    if (url !== next.sessionUrl) next = { ...next, sessionUrl: url };\n    if (next !== this.state) this.setState(next);\n  }\n\n  /** Stop the running turn and fence off its late events. */\n  #replaceTurn(): void {\n    this.#epoch++;\n    const turn = this.#turn;\n    this.#turn = undefined;\n    turn?.stop();\n  }\n\n  /**\n   * An approval arrived for a turn this agent no longer holds (it was stopped,\n   * or the Durable Object restarted). End those tool calls instead of leaving\n   * them spinning.\n   */\n  #settleOrphans(): ReadableStream<DevinChatChunk> {\n    const last = this.messages.at(-1);\n    const parts = last?.role === \"assistant\" ? last.parts.filter(isToolUIPart) : [];\n    return createUIMessageStream<DevinChatMessage>({\n      execute: ({ writer }) => {\n        writer.write({ type: \"start\" });\n        for (const part of parts) {\n          if (part.state !== \"approval-responded\") continue;\n          writer.write({\n            type: \"tool-output-error\",\n            toolCallId: part.toolCallId,\n            errorText: \"This Devin turn ended before the approval arrived.\",\n            dynamic: true,\n          });\n        }\n        writer.write({ type: \"finish\", finishReason: \"other\" });\n      },\n    });\n  }\n\n  async #load(\n    sessionId: string,\n  ): Promise<{ sessionId: string; sessionUrl: string | null; replay: LoadedReplay }> {\n    await using devin = await this.connectDevin();\n    try {\n      const { session, replay } = await devin.loadSession(sessionId, { replay: \"tail\" });\n      return { sessionId: session.id, sessionUrl: session.url ?? null, replay };\n    } catch (error) {\n      throw new DevinError(`Could not load Devin session ${sessionId}: ${errorText(error)}`);\n    }\n  }\n}\n\ntype LoadedReplay = Awaited<ReturnType<CloudDevin[\"loadSession\"]>>[\"replay\"];\n\n/** One Devin turn: its connection, its approvals, and a way to stop it. */\nclass Turn {\n  readonly approvals = new ToolApprovals();\n  readonly #devin: CloudDevin;\n  readonly #session: CloudSession;\n  readonly #stop = new AbortController();\n  readonly #onClose: () => void;\n  #started = false;\n  #closed = false;\n\n  constructor(devin: CloudDevin, session: CloudSession, onClose: () => void) {\n    this.#devin = devin;\n    this.#session = session;\n    this.#onClose = onClose;\n    session.onPermission = this.approvals.onPermission;\n  }\n\n  /**\n   * The turn's events, minus updates for tool calls that belong to an earlier\n   * message: stopping a turn does not stop the command Devin was running, so\n   * it can finish during a later turn. Its part lives in a message this\n   * stream can't reach, and `AIChatAgent` folds messages that share a tool\n   * call id into one, which would overwrite the earlier reply.\n   */\n  async *events(\n    prompt: PromptInput,\n    earlierToolCalls: ReadonlySet<string>,\n  ): AsyncGenerator<SessionEvent, PromptResult> {\n    this.#started = true;\n    const turn = this.#session.stream(prompt, { signal: this.#stop.signal });\n    let finished = false;\n    try {\n      for (;;) {\n        const next = await turn.next();\n        if (next.done) {\n          finished = true;\n          return next.value;\n        }\n        const event = next.value;\n        if (event.type === \"tool_call\" && earlierToolCalls.has(event.call.id)) continue;\n        yield event;\n      }\n    } finally {\n      // The consumer stopped early: let the SDK's generator run its cleanup too.\n      if (!finished) await turn.return(undefined as never);\n      this.#close();\n    }\n  }\n\n  /** Stop the turn when this request's signal aborts (the client pressed stop). */\n  follow(signal: AbortSignal | undefined): void {\n    if (signal === undefined) return;\n    if (signal.aborted) {\n      this.stop();\n      return;\n    }\n    signal.addEventListener(\n      \"abort\",\n      () => {\n        this.stop();\n      },\n      { once: true },\n    );\n  }\n\n  stop(): void {\n    this.#stop.abort(new DevinError(\"The Devin turn was stopped.\"));\n    this.approvals.cancel();\n    if (!this.#started) this.#close();\n  }\n\n  #close(): void {\n    if (this.#closed) return;\n    this.#closed = true;\n    this.approvals.cancel();\n    this.#devin.close();\n    this.#onClose();\n  }\n}\n\n/** Ids of every tool call in the transcript so far. */\nfunction toolCallIds(messages: readonly UIMessage[]): Set<string> {\n  const ids = new Set<string>();\n  for (const message of messages) {\n    for (const part of message.parts) if (isToolUIPart(part)) ids.add(part.toolCallId);\n  }\n  return ids;\n}\n\nfunction errorText(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { connectDevin, type DevinEnv } from "./connect.js";
+export { DevinChatAgent, type DevinChatMessage, type ImportedSession } from "./devin-chat-agent.js";
+export { parseSessionId } from "./session-id.js";
+export { initialDevinChatState, reduceDevinChatState, type DevinChatState } from "./state.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+export { connectDevin } from "./connect.js";
+export { DevinChatAgent } from "./devin-chat-agent.js";
+export { parseSessionId } from "./session-id.js";
+export { initialDevinChatState, reduceDevinChatState } from "./state.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,cAAc,EAA+C,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAuB,MAAM,YAAY,CAAC","sourcesContent":["export { connectDevin, type DevinEnv } from \"./connect.js\";\nexport { DevinChatAgent, type DevinChatMessage, type ImportedSession } from \"./devin-chat-agent.js\";\nexport { parseSessionId } from \"./session-id.js\";\nexport { initialDevinChatState, reduceDevinChatState, type DevinChatState } from \"./state.js\";\n"]}

package/dist/session-id.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A session id from what a user pastes: an id (`devin-…`) or the session's
+ * web app URL (`https://app.devin.ai/sessions/…`).
+ *
+ * @throws {DevinError} when `input` is neither.
+ */
+export declare function parseSessionId(input: unknown): string;

package/dist/session-id.js

@@ -0,0 +1,25 @@
+import { DevinError } from "@cognition-ai/sdk";
+const SESSION_ID = /^[A-Za-z0-9_-]{1,128}$/;
+/**
+ * A session id from what a user pastes: an id (`devin-…`) or the session's
+ * web app URL (`https://app.devin.ai/sessions/…`).
+ *
+ * @throws {DevinError} when `input` is neither.
+ */
+export function parseSessionId(input) {
+    if (typeof input !== "string")
+        throw new DevinError("Expected a Devin session id or URL.");
+    const trimmed = input.trim();
+    let id = trimmed;
+    if (URL.canParse(trimmed)) {
+        const segments = new URL(trimmed).pathname.split("/").filter(Boolean);
+        const at = segments.indexOf("sessions");
+        id = at >= 0 ? (segments[at + 1] ?? "") : "";
+        if (id !== "" && !id.startsWith("devin-"))
+            id = `devin-${id}`;
+    }
+    if (!SESSION_ID.test(id))
+        throw new DevinError(`Not a Devin session id or URL: ${trimmed}`);
+    return id;
+}
+//# sourceMappingURL=session-id.js.map

package/dist/session-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.js","sourceRoot":"","sources":["../src/session-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,EAAE,GAAG,OAAO,CAAC;IACjB,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IAC5F,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["import { DevinError } from \"@cognition-ai/sdk\";\n\nconst SESSION_ID = /^[A-Za-z0-9_-]{1,128}$/;\n\n/**\n * A session id from what a user pastes: an id (`devin-…`) or the session's\n * web app URL (`https://app.devin.ai/sessions/…`).\n *\n * @throws {DevinError} when `input` is neither.\n */\nexport function parseSessionId(input: unknown): string {\n  if (typeof input !== \"string\") throw new DevinError(\"Expected a Devin session id or URL.\");\n  const trimmed = input.trim();\n  let id = trimmed;\n  if (URL.canParse(trimmed)) {\n    const segments = new URL(trimmed).pathname.split(\"/\").filter(Boolean);\n    const at = segments.indexOf(\"sessions\");\n    id = at >= 0 ? (segments[at + 1] ?? \"\") : \"\";\n    if (id !== \"\" && !id.startsWith(\"devin-\")) id = `devin-${id}`;\n  }\n  if (!SESSION_ID.test(id)) throw new DevinError(`Not a Devin session id or URL: ${trimmed}`);\n  return id;\n}\n"]}

package/dist/state.d.ts

@@ -0,0 +1,23 @@
+import type { PlanEntry, SessionEvent, SessionStatus, TurnState } from "@cognition-ai/sdk";
+/** What a {@link DevinChatAgent} knows about its Devin session, synced to clients as Agent state. */
+export interface DevinChatState {
+    /** The attached Devin session (`devin-…`), or `null` until the first turn creates one. */
+    sessionId: string | null;
+    /** The session in the Devin web app. */
+    sessionUrl: string | null;
+    status: SessionStatus | null;
+    statusMessage: string | null;
+    /** What Devin is doing right now, e.g. `waiting_for_ci`. Cleared when it stops working. */
+    activity: string | null;
+    turnState: TurnState | null;
+    plan: PlanEntry[];
+    /** Pull requests the session opened, oldest first. */
+    pullRequests: string[];
+}
+export declare const initialDevinChatState: DevinChatState;
+/**
+ * Fold one session event into {@link DevinChatState}. Returns `state` itself
+ * when nothing changed, so callers can skip `setState`. Transcript events
+ * (text, reasoning, tools) belong in messages, not state, and are ignored.
+ */
+export declare function reduceDevinChatState(state: DevinChatState, event: SessionEvent): DevinChatState;

package/dist/state.js

@@ -0,0 +1,50 @@
+export const initialDevinChatState = {
+    sessionId: null,
+    sessionUrl: null,
+    status: null,
+    statusMessage: null,
+    activity: null,
+    turnState: null,
+    plan: [],
+    pullRequests: [],
+};
+/**
+ * Fold one session event into {@link DevinChatState}. Returns `state` itself
+ * when nothing changed, so callers can skip `setState`. Transcript events
+ * (text, reasoning, tools) belong in messages, not state, and are ignored.
+ */
+export function reduceDevinChatState(state, event) {
+    switch (event.type) {
+        case "status":
+            return {
+                ...state,
+                status: event.status,
+                statusMessage: event.message ?? null,
+                activity: event.status === "working" ? state.activity : null,
+            };
+        case "activity":
+            return event.activity === state.activity ? state : { ...state, activity: event.activity };
+        case "lifecycle":
+            return event.status === undefined
+                ? state
+                : { ...state, status: event.status, activity: null };
+        case "plan":
+            return { ...state, plan: event.entries };
+        case "pull_request":
+            return state.pullRequests.includes(event.prUrl)
+                ? state
+                : { ...state, pullRequests: [...state.pullRequests, event.prUrl] };
+        case "turn_state":
+            return event.state === state.turnState ? state : { ...state, turnState: event.state };
+        case "message_delta":
+        case "thought_delta":
+        case "tool_call":
+        case "user_message":
+        case "typing":
+        case "mode_change":
+        case "commands_change":
+        case "raw":
+            return state;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,EAAE;IACR,YAAY,EAAE,EAAE;CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAqB,EAAE,KAAmB;IAC7E,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO;gBACL,GAAG,KAAK;gBACR,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,aAAa,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;gBACpC,QAAQ,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;aAC7D,CAAC;QACJ,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5F,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS;gBAC/B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACzD,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3C,KAAK,cAAc;YACjB,OAAO,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC7C,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACvE,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QACxF,KAAK,eAAe,CAAC;QACrB,KAAK,eAAe,CAAC;QACrB,KAAK,WAAW,CAAC;QACjB,KAAK,cAAc,CAAC;QACpB,KAAK,QAAQ,CAAC;QACd,KAAK,aAAa,CAAC;QACnB,KAAK,iBAAiB,CAAC;QACvB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC","sourcesContent":["import type { PlanEntry, SessionEvent, SessionStatus, TurnState } from \"@cognition-ai/sdk\";\n\n/** What a {@link DevinChatAgent} knows about its Devin session, synced to clients as Agent state. */\nexport interface DevinChatState {\n  /** The attached Devin session (`devin-…`), or `null` until the first turn creates one. */\n  sessionId: string | null;\n  /** The session in the Devin web app. */\n  sessionUrl: string | null;\n  status: SessionStatus | null;\n  statusMessage: string | null;\n  /** What Devin is doing right now, e.g. `waiting_for_ci`. Cleared when it stops working. */\n  activity: string | null;\n  turnState: TurnState | null;\n  plan: PlanEntry[];\n  /** Pull requests the session opened, oldest first. */\n  pullRequests: string[];\n}\n\nexport const initialDevinChatState: DevinChatState = {\n  sessionId: null,\n  sessionUrl: null,\n  status: null,\n  statusMessage: null,\n  activity: null,\n  turnState: null,\n  plan: [],\n  pullRequests: [],\n};\n\n/**\n * Fold one session event into {@link DevinChatState}. Returns `state` itself\n * when nothing changed, so callers can skip `setState`. Transcript events\n * (text, reasoning, tools) belong in messages, not state, and are ignored.\n */\nexport function reduceDevinChatState(state: DevinChatState, event: SessionEvent): DevinChatState {\n  switch (event.type) {\n    case \"status\":\n      return {\n        ...state,\n        status: event.status,\n        statusMessage: event.message ?? null,\n        activity: event.status === \"working\" ? state.activity : null,\n      };\n    case \"activity\":\n      return event.activity === state.activity ? state : { ...state, activity: event.activity };\n    case \"lifecycle\":\n      return event.status === undefined\n        ? state\n        : { ...state, status: event.status, activity: null };\n    case \"plan\":\n      return { ...state, plan: event.entries };\n    case \"pull_request\":\n      return state.pullRequests.includes(event.prUrl)\n        ? state\n        : { ...state, pullRequests: [...state.pullRequests, event.prUrl] };\n    case \"turn_state\":\n      return event.state === state.turnState ? state : { ...state, turnState: event.state };\n    case \"message_delta\":\n    case \"thought_delta\":\n    case \"tool_call\":\n    case \"user_message\":\n    case \"typing\":\n    case \"mode_change\":\n    case \"commands_change\":\n    case \"raw\":\n      return state;\n  }\n}\n"]}

package/package.json

@@ -1,19 +1,57 @@
 {
   "name": "@cognition-ai/cloudflare-agents",
-  "version": "0.0.0",
-  "description": "Not publicly released yet. Install the beta: npm i @cognition-ai/cloudflare-agents@beta",
+  "version": "0.0.1-beta.2",
+  "description": "Cloudflare Agents adapter for the Devin SDK: a Devin cloud session behind an AIChatAgent, for useAgentChat.",
   "license": "MIT",
-  "os": [
-    "beta-only-release--run--npm-i-@cognition-ai/cloudflare-agents@beta"
-  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
   "files": [
-    "README.md"
+    "dist"
   ],
+  "sideEffects": false,
   "publishConfig": {
     "access": "public",
-    "tag": "latest"
+    "tag": "beta"
+  },
+  "engines": {
+    "node": ">=22"
   },
   "scripts": {
-    "preinstall": "node -e \"console.error('\\n@cognition-ai/cloudflare-agents is not publicly released yet.\\nInstall the beta instead:\\n\\n  npm i @cognition-ai/cloudflare-agents@beta\\n'); process.exit(1)\""
-  }
+    "build": "node ../../scripts/prepare-package.mjs && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p test --noEmit",
+    "test": "vitest run --config test/vitest.config.ts"
+  },
+  "dependencies": {
+    "@cognition-ai/ai-sdk": "0.0.1-beta.2",
+    "@cognition-ai/sdk": "0.0.1-beta.2"
+  },
+  "peerDependencies": {
+    "@cloudflare/ai-chat": ">=0.11.0 <1.0.0",
+    "agents": ">=0.22.0 <1.0.0",
+    "ai": "^7.0.0"
+  },
+  "devDependencies": {
+    "@babel/plugin-proposal-decorators": "8.0.2",
+    "@cloudflare/ai-chat": "0.11.0",
+    "@cloudflare/vitest-pool-workers": "0.22.0",
+    "@cloudflare/workers-types": "5.20260903.1",
+    "@types/node": "^22.10.0",
+    "@types/ws": "^8.5.13",
+    "agents": "0.22.0",
+    "ai": "7.0.93",
+    "typescript": "^5.8.3",
+    "vitest": "4.1.11",
+    "ws": "^8.21.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/COG-GTM/devin-sdk-examples.git"
+  },
+  "bugs": "https://github.com/COG-GTM/devin-sdk-examples/issues",
+  "homepage": "https://github.com/COG-GTM/devin-sdk-examples"
 }