eve 0.40.0 → 0.42.0

package/dist/src/setup/scaffold/create/web-template.js

@@ -17,32 +17,40 @@ export default eveChannel({
 
 import type { UserContent } from "ai";
 import { useEveAgent } from "eve/react";
-import { AlertCircleIcon } from "lucide-react";
+import { AlertCircleIcon, BrainIcon } from "lucide-react";
 import { useState } from "react";
 import {
   Conversation,
   ConversationContent,
   ConversationScrollButton,
 } from "@/components/ai-elements/conversation";
+import { Message, MessageContent } from "@/components/ai-elements/message";
 import {
   PromptInput,
   type PromptInputMessage,
   PromptInputSubmit,
   PromptInputTextarea,
 } from "@/components/ai-elements/prompt-input";
+import { Shimmer } from "@/components/ai-elements/shimmer";
 import { cn } from "@/lib/utils";
 import { AgentMessage } from "./agent-message";
 
 const AGENT_NAME = "__EVE_INIT_APP_NAME__";
 
-type AgentStatus = ReturnType<typeof useEveAgent>["status"];
-
 export function AgentChat() {
   const [cancellationError, setCancellationError] = useState<string>();
   const agent = useEveAgent();
   const isBusy = agent.status === "submitted" || agent.status === "streaming";
   const isEmpty = agent.data.messages.length === 0;
-  const errorMessage = cancellationError ?? agent.error?.message;
+  const lastMessage = agent.data.messages.at(-1);
+  const isPendingAssistantShell =
+    lastMessage?.role === "assistant" &&
+    lastMessage.parts.every((part) => part.type === "step-start");
+  const showPendingThinking =
+    isBusy &&
+    (agent.status === "submitted" || lastMessage?.role !== "assistant" || isPendingAssistantShell);
+  const turnFailure = isBusy ? undefined : getLatestTurnFailure(agent.events);
+  const errorMessage = cancellationError ?? agent.error?.message ?? turnFailure;
 
   const requestCancellation = () => {
     setCancellationError(undefined);
@@ -80,7 +88,7 @@ export function AgentChat() {
 
   const composer = (
     <PromptInput onSubmit={handleSubmit}>
-      <PromptInputTextarea placeholder="Send a message…" />
+      <PromptInputTextarea disabled={isBusy} placeholder="Send a message…" />
       <PromptInputSubmit onStop={requestCancellation} status={agent.status} />
     </PromptInput>
   );
@@ -88,17 +96,17 @@ export function AgentChat() {
   return (
     <main className="flex h-dvh flex-col overflow-hidden bg-background text-foreground">
       {isEmpty ? null : (
-        <header className="flex h-14 shrink-0 items-center justify-center gap-3 pl-4 pr-2">
-          <span className="flex min-w-0 items-center gap-2">
-            <span className="truncate text-muted-foreground text-sm">{AGENT_NAME}</span>
-            <StatusDot status={agent.status} />
-          </span>
+        <header className="flex h-14 shrink-0 items-center justify-center pl-4 pr-2">
+          <span className="truncate text-muted-foreground text-sm">{AGENT_NAME}</span>
         </header>
       )}
 
       {errorMessage ? (
         <div className="mx-auto w-full max-w-3xl shrink-0 px-4 pt-2 sm:px-6">
-          <div className="flex items-start gap-3 rounded-lg border border-destructive/30 bg-destructive/5 px-3 py-2.5 text-sm">
+          <div
+            className="flex items-start gap-3 rounded-lg border border-destructive/30 bg-destructive/5 px-3 py-2.5 text-sm"
+            role="alert"
+          >
             <AlertCircleIcon className="mt-0.5 size-4 shrink-0 text-destructive" />
             <div>
               <p className="font-medium">Request failed</p>
@@ -111,20 +119,25 @@ export function AgentChat() {
       {isEmpty ? null : (
         <Conversation className="min-h-0 flex-1">
           <ConversationContent className="mx-auto w-full max-w-3xl gap-6 px-4 py-6 sm:px-6">
-            {agent.data.messages.map((message, index) => (
-              <AgentMessage
-                canRespond={!isBusy}
-                isStreaming={
-                  agent.status === "streaming" && index === agent.data.messages.length - 1
-                }
-                key={message.id}
-                message={message}
-                onInputResponses={(inputResponses) => {
-                  setCancellationError(undefined);
-                  return agent.respond(inputResponses);
-                }}
-              />
-            ))}
+            {agent.data.messages.map((message, index) =>
+              showPendingThinking &&
+              isPendingAssistantShell &&
+              message.id === lastMessage.id ? null : (
+                <AgentMessage
+                  canRespond={!isBusy}
+                  isStreaming={
+                    agent.status === "streaming" && index === agent.data.messages.length - 1
+                  }
+                  key={message.id}
+                  message={message}
+                  onInputResponses={(inputResponses) => {
+                    setCancellationError(undefined);
+                    return agent.respond(inputResponses);
+                  }}
+                />
+              ),
+            )}
+            {showPendingThinking ? <PendingThinking /> : null}
           </ConversationContent>
           <ConversationScrollButton />
         </Conversation>
@@ -149,34 +162,45 @@ export function AgentChat() {
   );
 }
 
+function PendingThinking() {
+  return (
+    <Message aria-live="polite" from="assistant">
+      <MessageContent>
+        <div className="mb-4 flex w-full items-center gap-2 text-muted-foreground text-sm">
+          <BrainIcon className="size-4" />
+          <Shimmer duration={1}>Thinking</Shimmer>
+        </div>
+      </MessageContent>
+    </Message>
+  );
+}
+
 function toErrorMessage(error: unknown): string {
   return error instanceof Error ? error.message : "Unable to cancel the response.";
 }
 
-function StatusDot({ status }: { readonly status: AgentStatus }) {
-  const isLive = status === "submitted" || status === "streaming";
-  const tone =
-    status === "error"
-      ? "bg-destructive"
-      : isLive
-        ? "bg-emerald-500"
-        : status === "ready"
-          ? "bg-muted-foreground"
-          : "bg-muted-foreground/50";
+function getLatestTurnFailure(
+  events: ReturnType<typeof useEveAgent>["events"],
+): string | undefined {
+  for (let index = events.length - 1; index >= 0; index -= 1) {
+    const event = events[index];
 
-  return (
-    <span className="relative flex size-1">
-      {isLive ? (
-        <span
-          className={cn(
-            "absolute inline-flex size-full animate-ping rounded-full opacity-75",
-            tone,
-          )}
-        />
-      ) : null}
-      <span className={cn("relative inline-flex size-1 rounded-full transition-colors", tone)} />
-    </span>
-  );
+    if (event.type === "turn.failed") {
+      return event.data.code === "MODEL_CALL_FAILED"
+        ? "The model is temporarily unavailable. Please try again."
+        : event.data.message;
+    }
+
+    if (event.type === "turn.completed" || event.type === "turn.cancelled") {
+      return undefined;
+    }
+
+    if (event.type === "message.received") {
+      return undefined;
+    }
+  }
+
+  return undefined;
 }
 `,"app/_components/agent-message.tsx":`"use client";
 
@@ -1845,7 +1869,7 @@ import { Spinner } from "@/components/ui/spinner";
 import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
 import { cn } from "@/lib/utils";
 import type { ChatStatus, FileUIPart, SourceDocumentUIPart } from "ai";
-import { ArrowUpIcon, ImageIcon, Monitor, PlusIcon, SquareIcon, XIcon } from "lucide-react";
+import { ArrowUpIcon, ImageIcon, Monitor, PlusIcon, XIcon } from "lucide-react";
 import { nanoid } from "nanoid";
 import type {
   ChangeEvent,
@@ -2954,7 +2978,7 @@ export const PromptInputSubmit = ({
   if (status === "submitted") {
     Icon = <Spinner />;
   } else if (status === "streaming") {
-    Icon = <SquareIcon className="size-4" />;
+    Icon = <span aria-hidden className="size-2.5 rounded-[2px] bg-current" />;
   } else if (status === "error") {
     Icon = <XIcon className="size-4" />;
   }

package/dist/src/svelte/index.js

@@ -1,3 +1,3 @@
-import { n as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-CTI9fHaO.js";
+import { n as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-C0SG1Ttk.js";
 
 export { defaultMessageReducer, useEveAgent };

package/dist/src/svelte/use-eve-agent.js

@@ -1,3 +1,3 @@
-import { t as useEveAgent } from "../chunks/use-eve-agent-CTI9fHaO.js";
+import { t as useEveAgent } from "../chunks/use-eve-agent-C0SG1Ttk.js";
 
 export { useEveAgent };

package/dist/src/vue/index.js

@@ -1,3 +1,3 @@
-import { n as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-DlkXRQVo.js";
+import { n as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-D71oDil7.js";
 
 export { defaultMessageReducer, useEveAgent };

package/dist/src/vue/use-eve-agent.js

@@ -1,3 +1,3 @@
-import { t as useEveAgent } from "../chunks/use-eve-agent-DlkXRQVo.js";
+import { t as useEveAgent } from "../chunks/use-eve-agent-D71oDil7.js";
 
 export { useEveAgent };

package/docs/channels/custom.mdx

@@ -111,6 +111,18 @@ await session.reset({ reason: "Retire this session" });
 await session.getEventStream({ startIndex: 12 });
 ```
 
+`respond()` accepts exact response literals directly. If responses have already
+been widened to `InputResponse[]`—for example, after decoding a platform
+payload—validate them with eve's strict schema before delivery. The validated
+type preserves that proof across channel wrappers:
+
+```ts
+import { parseInputResponses } from "eve/client";
+
+const inputResponses = parseInputResponses(decodedResponses);
+await source.respond(inputResponses, { auth });
+```
+
 Message sends use the channel's `turnPolicy`, which defaults to `"steer"`. An accepted message arriving during an active turn is durably buffered before eve cancels that turn and starts the message as a replacement turn. Configure `turnPolicy: "queue"` on `defineChannel(...)` when active turns should finish in order, or override one send:
 
 ```ts

package/docs/channels/linq.mdx

@@ -0,0 +1,67 @@
+---
+title: Linq
+description: Connect an eve agent to iMessage and SMS through Linq.
+---
+
+Use `linqChannel` to receive and reply to iMessage and SMS conversations through Linq.
+
+Run `eve add channel/linq` to choose Vercel Connect or portable credentials. With Vercel Connect, eve signs you in and creates or links a Vercel project when needed. Then choose whether to create a managed Linq account and line or connect an existing Linq account with its partner API token and phone numbers. eve configures the connector and webhook through Connect:
+
+```ts title="agent/channels/linq.ts"
+import { connectLinqCredentials } from "@vercel/connect/eve";
+import { linqChannel } from "eve/channels/linq";
+
+export default linqChannel({
+  credentials: connectLinqCredentials("linq/my-agent"),
+});
+```
+
+The default webhook route is `/eve/v1/linq`. The channel verifies forwarded webhooks with same-project Vercel OIDC by default, marks accepted messages as read, and continues the same eve session for every message in a Linq conversation. A new accepted message cooperatively cancels an active turn and steers its replacement turn.
+
+Set `turnPolicy: "queue"` when every response should finish before Linq starts the next message.
+
+Customize inbound dispatch with `onMessage`. Return `null` to ignore a message, or return `title` alongside `auth` to set the title when the dispatch starts a run:
+
+```ts
+export default linqChannel({
+  credentials: connectLinqCredentials("linq/my-agent"),
+  onMessage(_ctx, message) {
+    if (message.author.isBot) return null;
+    return {
+      auth: null,
+      context: [`The sender is ${message.author.fullName}.`],
+    };
+  },
+});
+```
+
+Set `route` to override the webhook path or `webhookVerifier` to use a different trusted-forwarder verifier.
+
+## Other hosts
+
+For a host without Vercel Connect, choose **Use portable credentials** during `eve add channel/linq`. eve writes `LINQ_API_KEY` and `LINQ_WEBHOOK_SECRET` to `.env.local`.
+
+After deploying the agent:
+
+1. Create a Linq webhook for your public `https://…/eve/v1/linq` URL with `message.received`, `reaction.added`, and `reaction.removed` events.
+2. Set `LINQ_API_KEY` and `LINQ_WEBHOOK_SECRET` in the host's encrypted environment variables.
+
+To configure the channel by hand, pass the API key and webhook signing secret:
+
+```ts title="agent/channels/linq.ts"
+import { linqChannel } from "eve/channels/linq";
+
+export default linqChannel({
+  credentials: {
+    apiKey: process.env.LINQ_API_KEY!,
+    signingSecret: process.env.LINQ_WEBHOOK_SECRET!,
+  },
+});
+```
+
+For direct Linq webhooks, pass `signingSecret`. A supplied `webhookVerifier` takes precedence over it.
+
+## What to read next
+
+- [Channels overview](./overview): the channel contract and every built-in channel
+- [Auth & route protection](../guides/auth-and-route-protection): authenticating inbound traffic

package/docs/channels/meta.json

@@ -6,6 +6,7 @@
     "eve",
     "mcp",
     "slack",
+    "linq",
     "photon",
     "discord",
     "teams",

package/docs/channels/overview.mdx

@@ -47,7 +47,7 @@ agent/
     intake.ts
 ```
 
-Install a channel from the registry with `eve add channel/photon-imessage`, `eve add channel/slack`, or `eve add channel/web`. You can also author the file by hand.
+Install a channel from the registry with `eve add channel/<name>`, such as `eve add channel/slack` or `eve add channel/web`. You can also author the file by hand.
 
 ## The eve HTTP channel (default)
 
@@ -73,6 +73,7 @@ eve's first-class channels use eve-owned runtimes for webhook handling, verifica
 | Local tooling, SDK clients, `curl`          | [eve HTTP channel](./eve) (default)                        |
 | MCP clients delegating durable work         | [MCP](./mcp)                                               |
 | Slack mentions, DMs, buttons                | [Slack](./slack)                                           |
+| iMessage and SMS                            | [Linq](./linq)                                             |
 | iMessage                                    | [Photon](./photon)                                         |
 | Discord slash commands, components          | [Discord](./discord)                                       |
 | Microsoft Teams messages + Adaptive Cards   | [Teams](./teams)                                           |
@@ -94,7 +95,7 @@ Where an eve agent communicates with people, you may be required to disclose tha
 - [eve HTTP channel](./eve): the default session API behind the TUI, SDK clients, and browser UIs
 - [Slack](./slack): the most common platform channel, end to end
 - [MCP](./mcp): expose the agent as a durable invocation service
-- [Photon](./photon), [Discord](./discord), [Teams](./teams), [Telegram](./telegram), [Twilio](./twilio), [GitHub](./github), and [Linear](./linear): the other first-class platform channels
+- [Linq](./linq), [Photon](./photon), [Discord](./discord), [Teams](./teams), [Telegram](./telegram), [Twilio](./twilio), [GitHub](./github), and [Linear](./linear): the other first-class platform channels
 - [Chat SDK adapters](./chat-sdk): reach services eve has no first-class channel for
 - [Custom channels](./custom): build a channel for any surface with `defineChannel`
 - [Durable cross-channel notifications](../patterns/durable-cross-channel-notifications): post to another platform without starting an agent turn

package/docs/channels/teams.mdx

@@ -56,6 +56,8 @@ A human-in-the-loop (HITL) `input.requested` event renders as an Adaptive Card.
 
 By default, submissions use the Teams identity of the user who clicked the card. If you customize `onMessage` for an allowlist, configure the same policy in `onInputResponse`; eve otherwise rejects HITL submissions rather than bypassing the message gate.
 
+When a tool approval settles, eve replaces its Adaptive Card with the outcome and responder name. A response rejected by an approval policy leaves the shared card unchanged.
+
 For invokes that aren't HITL, handle them in `onInvoke(ctx, activity)`.
 
 ### Proactive sessions

package/docs/guides/client/streaming.mdx

@@ -124,7 +124,7 @@ client-resolvable `http(s)` and `data:` URLs.
 
 `authorization.required` is different from the normal `session.waiting` boundary. It means a connection needs OAuth or another authorization challenge before the parked turn can continue. Chat UIs should render the authorization prompt, disable ordinary text input for that session, and persist the event with the rest of the chat history.
 
-If you support refresh while an authorization prompt is pending, keep the session cursor from the started session and rehydrate the saved events on load. Do not treat a missing `session.waiting` after `authorization.required` as a finished conversation; the callback or a structured decline should resume the same eve session.
+The stream can emit an interim `session.waiting` while the authorization callback is pending. An active `send()` or `respond()` response stays attached across that parking boundary until the authorization resolves and the resumed turn reaches its next boundary. If you support refresh while an authorization prompt is pending, keep the session cursor from the started session and rehydrate the saved events on load; the callback or a structured decline resumes the same eve session.
 
 ## Reconnection
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve",
-  "version": "0.40.0",
+  "version": "0.42.0",
   "private": false,
   "description": "Filesystem-first framework for durable backend AI agents that run anywhere.",
   "keywords": [
@@ -251,6 +251,11 @@
       "import": "./dist/src/public/channels/photon/index.js",
       "default": "./dist/src/public/channels/photon/index.js"
     },
+    "./channels/linq": {
+      "types": "./dist/src/public/channels/linq/index.d.ts",
+      "import": "./dist/src/public/channels/linq/index.js",
+      "default": "./dist/src/public/channels/linq/index.js"
+    },
     "./channels/github": {
       "types": "./dist/src/public/channels/github/index.d.ts",
       "import": "./dist/src/public/channels/github/index.js",
@@ -315,6 +320,7 @@
     "@chat-adapter/state-memory": "4.34.0",
     "@chat-adapter/twilio": "4.34.0",
     "@clack/core": "1.3.1",
+    "@linqapp/chat-sdk-adapter": "^0.3.0",
     "@modelcontextprotocol/server": "2.0.0",
     "@nuxt/kit": "^4.0.0",
     "@opentelemetry/context-async-hooks": "2.6.1",