experimental-agent 0.0.0 → 0.0.2

package/README.md

@@ -2,11 +2,16 @@
 
 An LLM running in a loop, with access to a sandbox, tools, and session management. Nothing more.
 
+```bash
+pnpm i experimental-agent
+```
+
 ## Why
 
 - **AI SDK compatible** — Built on `ai`. Uses `UIMessage`, `GatewayModelId`, streams the same way. If you know AI SDK, you know this.
 - **Managed workflow** — Runs inside Vercel Workflow. Retries, timeouts, resumption handled for you.
-- **Managed sandbox** — Auto-provisions on first use, auto-snapshots when idle, auto-resumes. You don't manage the VM.
+- **Managed sandbox** — Auto-starts on first use, auto-snapshots when idle, auto-resumes. You don't manage the VM.
+- **Built-in storage** — Messages, tool calls, and sandbox state persisted automatically. Survives refreshes, crashes, reconnects.
 - **Built-in tools** — Read, Grep, List, Bash. No setup.
 
 ## Quick Start
@@ -16,7 +21,7 @@ An LLM running in a loop, with access to a sandbox, tools, and session managemen
 import { agent } from "experimental-agent";
 
 export const myAgent = agent({
-  model: "anthropic/claude-sonnet-4",
+  model: "anthropic/claude-opus-4.5",
   instructions: "You are a helpful coding assistant.",
 });
 ```
@@ -24,60 +29,36 @@ export const myAgent = agent({
 ```ts
 // app/api/chat/[chatId]/route.ts
 import { myAgent } from "@/lib/agent";
+import { createUIMessageStreamResponse } from "ai";
 
 export async function POST(req: Request, { params }: { params: { chatId: string } }) {
   const { chatId } = await params;
-  const { message } = await req.json();
+  const { message } = await req.json(); // string or UIMessage
 
   const session = await myAgent.session(chatId);
-  await session.send({ input: message });
+  await session.send({ input: message }); // accepts string, UIMessage, or parts array
   const stream = await session.stream();
 
-  return new Response(stream);
+  return createUIMessageStreamResponse({ stream });
 }
 
 export async function GET(req: Request, { params }: { params: { chatId: string } }) {
   const { chatId } = await params;
   const session = await myAgent.session(chatId);
-  const { messages, streamingMessageId } = await session.ui();
-
-  return Response.json({ messages, streamingMessageId });
+  const stream = await session.stream();
+  if (stream instanceof Error) {
+    console.error(stream);
+    if (stream instanceof SessionNotFoundError) {
+      return new Response("Session not found", { status: 404 });
+    }
+    return new Response("Internal server error", { status: 500 });
+  }
+
+  return createUIMessageStreamResponse({ stream });
 }
 ```
 
-## Tools
-
-| Tool | Description |
-|------|-------------|
-| **Read** | Read files. Large files (>200 lines) paginate automatically. |
-| **Grep** | ripgrep-powered search. Regex, file types, context lines. |
-| **List** | Directory listing with depth control and glob filtering. |
-| **Bash** | Shell commands. Background processes via `waitUntil: 0`. Persistent CWD. |
-
-## Configuration
-
-```ts
-agent({
-  model: "anthropic/claude-sonnet-4",  // Required
-  instructions: "...",                  // System prompt
-  sandbox: { type: "vercel" },          // or "local"
-  storage: { type: "vercel" },          // or "local" or "custom"
-  skillsDir: ".agent/skills",           // Skills location
-  mcp: { ... },                         // Custom tools
-})
-```
-
-## Sessions
-
-```ts
-const session = await myAgent.session(sessionId);
-
-await session.send({ input: "Hello" });
-const stream = await session.stream();
 
-// Tags for your app's metadata
-await session.tag.set("category", "support");
-```
 
 ## Rendering Messages
 
@@ -95,14 +76,18 @@ import { Chat } from "./chat-client";
 export default async function ChatPage({ params }) {
   const { chatId } = await params;
   const session = await myAgent.session(chatId);
-  const { messages, streamingMessageId } = await session.ui();
+  const ui = await session.ui();
+  if (ui instanceof Error) {
+    console.error(ui);
+    throw new Error("Failed to get messages");
+  }
 
   return (
     <>
-      {messages.map((m) => (
+      {ui.messages.map((m) => (
         <MessageView key={m.id} message={m} />
       ))}
-      <Chat chatId={chatId} streamingMessageId={streamingMessageId} />
+      <Chat chatId={chatId} streamingMessageId={ui.streamingMessageId} />
     </>
   );
 }
@@ -112,29 +97,100 @@ export default async function ChatPage({ params }) {
 // chat-client.tsx
 "use client";
 
-import { useChat } from "@ai-sdk/react";
+import { useEffect } from "react";
+import { useChat, DefaultChatTransport } from "@ai-sdk/react";
 
 export function Chat({ chatId, streamingMessageId }) {
-  const { messages, input, handleInputChange, handleSubmit, status } = useChat({
+  const { messages, resumeStream, sendMessage, status } = useChat({
     id: chatId,
-    api: `/api/chat/${chatId}`,
-    initialMessages: [], // hydrate from server if needed
+    transport: new DefaultChatTransport({
+      api: `/api/chat/${chatId}`,
+      prepareSendMessagesRequest: ({ messages }) => ({
+        body: { message: messages.at(-1) },
+      }),
+      prepareReconnectToStreamRequest: (request) => ({
+        ...request,
+        api: `/api/chat/${chatId}`,
+      }),
+    }),
   });
 
+  useEffect(() => {
+    if (streamingMessageId) {
+      resumeStream();
+    }
+  }, [streamingMessageId, resumeStream]);
+
   return (
     <>
       {messages.map((m) => (
         <MessageView key={m.id} message={m} />
       ))}
-      <form onSubmit={handleSubmit}>
-        <input value={input} onChange={handleInputChange} />
-        <button type="submit" disabled={status !== "ready"}>Send</button>
+      <form
+        onSubmit={async (e) => {
+          e.preventDefault();
+          const form = e.currentTarget;
+          const textarea = form.elements.namedItem("composer") as HTMLTextAreaElement | null;
+          const text = textarea ? textarea.value : "";
+          if (text.trim()) {
+            await sendMessage({ parts: [{ type: "text", text }] });
+            textarea.value = "";
+          }
+        }}
+      >
+        <textarea name="composer" />
+        <button type="submit" disabled={status !== "ready"}>
+          Send
+        </button>
       </form>
     </>
   );
 }
 ```
 
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| **Read** | Read files. Large files (>200 lines) paginate automatically. |
+| **Grep** | ripgrep-powered search. Regex, file types, context lines. |
+| **List** | Directory listing with depth control and glob filtering. |
+| **Bash** | Shell commands. Background processes via `waitUntil: 0`. Persistent CWD. |
+
+## Configuration
+
+```ts
+const myAgent = agent({
+  model: "anthropic/claude-haiku-4.5",  // Required
+  instructions: "...",                  // System prompt
+  sandbox: { type: "vercel" },          // or "local"
+  storage: { type: "vercel" },          // or "local" or "custom"
+  skillsDir: ".agent/skills",           // Skills location
+  mcp: { ... },                         // Custom tools
+})
+
+// overrides per session
+myAgent.session("<session-id>", {
+  model: "anthropic/claude-opus-4.5"
+})
+```
+
+## Sessions
+
+```ts
+const session = await myAgent.session(sessionId);
+
+// input can be a string, UIMessage, or parts array
+await session.send({ input: "Hello" });
+await session.send({ input: { role: "user", parts: [{ type: "text", text: "Hello" }] } });
+
+const stream = await session.stream();
+
+// Tags for your app's metadata
+await session.tag.set("category", "support");
+```
+
 ### Durable UI
 
 Unlike `useChat` alone, messages survive refresh. They're persisted to storage.
@@ -149,17 +205,24 @@ The server component renders completed messages from `session.ui()`. The client
 
 ```ts
 // Local (dev)
-agent({ sandbox: { type: "local" } })
+const myAgent = agent({ sandbox: { type: "local" } })
 
 // Vercel (prod)
-agent({ sandbox: { type: "vercel", resources: { vcpus: 2 }, ports: [3000] } })
+const myAgent = agent({ sandbox: { type: "vercel", resources: { vcpus: 2 }, ports: [3000] } })
+
+const session = await myAgent.session("some-session")
 
 // Direct access
 await session.sandbox.exec({ command: "npm", args: ["install"] });
+```
+
+### Share a sandbox
+
+```ts
+const sharedBox = await myAgent.sandbox("some-sandbox")
 
-// Share across sessions
-await myAgent.session("s1", { sandbox: "shared_id" });
-await myAgent.session("s2", { sandbox: "shared_id" });
+await myAgent.session("s1", { sandbox: sharedBox.id });
+await myAgent.session("s2", { sandbox: sharedBox.id });
 ```
 
 ## Skills

package/dist/agent-workflow.d.mts

@@ -1,5 +1,5 @@
 import * as workflow from 'workflow';
-import { a as StorageConfig } from './types-vRxN1Qz1.mjs';
+import { i as StorageConfig } from './types-DPXFq_r6.mjs';
 import 'ai';
 import 'zod';
 import 'errore';

package/dist/agent-workflow.d.ts

@@ -1,5 +1,5 @@
 import * as workflow from 'workflow';
-import { a as StorageConfig } from './types-vRxN1Qz1.js';
+import { i as StorageConfig } from './types-DPXFq_r6.js';
 import 'ai';
 import 'zod';
 import 'errore';