eve 0.30.8 → 0.31.0

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

@@ -46,9 +46,8 @@ type Cancellation = {
 };
 
 export function AgentChat() {
-  const [session] = useState(() =>
-    new Client({ host: "", preserveCompletedSessions: true }).session(),
-  );
+  const [client] = useState(() => new Client({ host: "" }));
+  const sessionIdRef = useRef<string | undefined>(undefined);
   const cancellationRef = useRef<Cancellation>({ requested: false });
   const [cancellationError, setCancellationError] = useState<string>();
   const [cancellationState, setCancellationState] = useState<CancellationState>("idle");
@@ -63,18 +62,26 @@ export function AgentChat() {
       cancellation.sentTurnId = turnId;
       setCancellationState("cancelling");
 
-      void session.cancel({ turnId }).catch((error: unknown) => {
-        if (cancellationRef.current !== cancellation) {
-          return;
-        }
+      const sessionId = sessionIdRef.current;
+      if (sessionId === undefined) {
+        return;
+      }
 
-        cancellation.requested = false;
-        cancellation.sentTurnId = undefined;
-        setCancellationError(toErrorMessage(error));
-        setCancellationState("idle");
-      });
+      void client.sessions
+        .attach(sessionId)
+        .cancel({ turnId })
+        .catch((error: unknown) => {
+          if (cancellationRef.current !== cancellation) {
+            return;
+          }
+
+          cancellation.requested = false;
+          cancellation.sentTurnId = undefined;
+          setCancellationError(toErrorMessage(error));
+          setCancellationState("idle");
+        });
     },
-    [session],
+    [client],
   );
 
   const handleEvent = useCallback(
@@ -90,7 +97,12 @@ export function AgentChat() {
     [cancelTurn],
   );
 
-  const agent = useEveAgent({ onEvent: handleEvent, session });
+  const agent = useEveAgent({
+    onEvent: handleEvent,
+    onSessionChange(session) {
+      sessionIdRef.current = session?.sessionId;
+    },
+  });
   const isBusy = agent.status === "submitted" || agent.status === "streaming";
   const isEmpty = agent.data.messages.length === 0;
   const errorMessage = cancellationError ?? agent.error?.message;
@@ -124,7 +136,7 @@ export function AgentChat() {
     prepareTurn();
 
     if (message.files.length === 0) {
-      await agent.send({ message: text });
+      await agent.send(text);
       return;
     }
 
@@ -141,7 +153,7 @@ export function AgentChat() {
       });
     }
 
-    await agent.send({ message: parts });
+    await agent.send(parts);
   };
 
   const composer = (
@@ -187,7 +199,7 @@ export function AgentChat() {
                 message={message}
                 onInputResponses={(inputResponses) => {
                   prepareTurn();
-                  return agent.send({ inputResponses });
+                  return agent.respond(inputResponses);
                 }}
               />
             ))}

package/dist/src/shared/channel-definition.d.ts

@@ -1,5 +1,7 @@
 import { type ChannelCors } from "#channel/cors.js";
-import type { RouteDefinition, SendFn } from "#channel/routes.js";
+import type { UserContent } from "ai";
+import type { ChannelReceiveContext } from "#channel/channel-operations.js";
+import type { RouteDefinition } from "#channel/routes.js";
 import type { Session, SessionHandle } from "#channel/session.js";
 import type { SessionAuthContext } from "#channel/types.js";
 /**
@@ -22,7 +24,7 @@ export type FetchFileFunction = (url: string) => Promise<Buffer | FetchFileResul
  * schedule proactively routes a message to it.
  */
 export interface GenericReceiveInput<TReceiveTarget = Record<string, unknown>> {
-    readonly message: string;
+    readonly message: string | UserContent;
     readonly target: Readonly<TReceiveTarget>;
     readonly auth: SessionAuthContext | null;
 }
@@ -54,14 +56,12 @@ export interface GenericChannelDefinition<TEvents, TState = undefined, TCtx = vo
      *
      * Return the channel-owned context (thread handles, API clients, etc.). The
      * framework passes it as the `channel` argument to event handlers (with
-     * {@link ChannelSessionOps} injected) and passes {@link SessionContext} as a
-     * separate `ctx` argument.
+     * {@link ChannelContinuationOps} injected) and passes {@link SessionContext}
+     * as a separate `ctx` argument.
      */
     context?(state: NonNullable<TState>, session: SessionHandle): TCtx;
     readonly routes: readonly RouteDefinition<TState>[];
-    receive?(input: GenericReceiveInput<TReceiveTarget>, args: {
-        send: SendFn<TState>;
-    }): Promise<Session>;
+    receive?(input: GenericReceiveInput<TReceiveTarget>, ctx: ChannelReceiveContext<TState>): Promise<Session>;
     readonly events?: TEvents;
     /**
      * Fetches bytes for a `URL` object encountered on a `FilePart.data` by the

package/dist/src/shared/schedule-definition.d.ts

@@ -1,6 +1,6 @@
 /**
  * The `run` form of {@link ScheduleDefinition} invokes this handler when a
- * schedule's cron fires. It receives {@link ScheduleHandlerArgs} (`receive`,
+ * schedule's cron fires. It receives {@link ScheduleHandlerArgs} (`to`,
  * `waitUntil`, `appAuth`) and may return synchronously or as a promise.
  */
 export type GenericScheduleRunHandler<TArgs> = (args: TArgs) => Promise<void> | void;
@@ -18,7 +18,7 @@ export interface GenericScheduleDefinitionFields<TArgs> {
  *   on the prompt and discards the output (equivalent to the `<name>.md`
  *   markdown form).
  * - `run`: full handler ({@link GenericScheduleRunHandler}). Receives
- *   `{ receive, waitUntil, appAuth }` and decides what to do.
+ *   `{ to, waitUntil, appAuth }` and decides what to do.
  *
  * Identity is derived from the file path under `agent/schedules/`; authored
  * definitions do not carry a `name` field.

package/dist/src/svelte/index.js

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

package/dist/src/svelte/use-eve-agent.d.ts

@@ -1,8 +1,9 @@
+import type { UserContent } from "ai";
 import { type EveAgentStoreCallbacks, type EveAgentStoreSnapshot, type EveAgentStoreStatus, type PrepareSend } from "#client/eve-agent-store.js";
 import { type EveMessageData } from "#client/message-reducer.js";
 import type { EveAgentReducer } from "#client/reducer.js";
 import type { ClientSession } from "#client/session.js";
-import type { ClientAuth, HeadersValue, SendTurnPayload, SessionState } from "#client/types.js";
+import type { ClientAuth, HeadersValue, RespondTurnOptions, SendTurnOptions, ClientSessionState } from "#client/types.js";
 import type { MessageStreamEvent } from "#protocol/message.js";
 export type { PrepareSend };
 /**
@@ -33,10 +34,12 @@ export interface UseEveAgentReturn<TData> {
     readonly events: readonly MessageStreamEvent[];
     /** Clear all state and start a new session. */
     readonly reset: () => void;
-    /** Send a turn with full structured input (message, attachments, input responses). */
-    readonly send: <TOutput = unknown>(input: SendTurnPayload<TOutput>) => Promise<void>;
+    /** Send a message with optional turn settings. */
+    readonly send: <TOutput = unknown>(message: string | UserContent, options?: SendTurnOptions<TOutput>) => Promise<void>;
+    /** Answer pending HITL input requests. */
+    readonly respond: <TOutput = unknown>(inputResponses: Parameters<ClientSession["respond"]>[0], options?: RespondTurnOptions<TOutput>) => Promise<void>;
     /** Current session identity and stream cursor. */
-    readonly session: SessionState;
+    readonly session: ClientSessionState | undefined;
     /** Lifecycle phase: `"ready"` (idle), `"submitted"` (request sent, awaiting first event), `"streaming"` (events arriving), or `"error"`. */
     readonly status: UseEveAgentStatus;
     /** Abort the in-flight request. */
@@ -79,7 +82,7 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
     /** Ordered prefix of the session stream used to rehydrate projected state. */
     readonly initialEvents?: readonly MessageStreamEvent[];
     /** Seed session identity and stream cursor for resuming a prior conversation. */
-    readonly initialSession?: SessionState;
+    readonly initialSession?: ClientSessionState;
     /**
      * Project submitted user messages before eve confirms them with a
      * `message.received` stream event. Optimistic events are reducer-facing

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

@@ -1,3 +1,3 @@
-import { t as useEveAgent } from "../chunks/use-eve-agent-Bx-ONuyb.js";
+import { t as useEveAgent } from "../chunks/use-eve-agent-DbYZLG0h.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-DDoDDmJ2.js";
+import { n as defaultMessageReducer, t as useEveAgent } from "../chunks/use-eve-agent-CF5D6jSV.js";
 
 export { defaultMessageReducer, useEveAgent };

package/dist/src/vue/use-eve-agent.d.ts

@@ -1,10 +1,11 @@
 import { type ComputedRef } from "vue";
+import type { UserContent } from "ai";
 import { type EveAgentStoreCallbacks, type EveAgentStoreSnapshot, type EveAgentStoreStatus, type PrepareSend } from "#client/eve-agent-store.js";
 import type { EveAgentReducer } from "#client/reducer.js";
 import type { ClientSession } from "#client/session.js";
 import { type EveMessageData } from "#client/message-reducer.js";
 import type { MessageStreamEvent } from "#protocol/message.js";
-import type { ClientAuth, HeadersValue, SendTurnPayload, SessionState } from "#client/types.js";
+import type { ClientAuth, HeadersValue, RespondTurnOptions, SendTurnOptions, ClientSessionState } from "#client/types.js";
 export type { PrepareSend };
 /**
  * Lifecycle phase of a `useEveAgent` session: `"ready"` (idle), `"submitted"`
@@ -32,10 +33,12 @@ export interface UseEveAgentReturn<TData> {
     readonly events: ComputedRef<readonly MessageStreamEvent[]>;
     /** Clear all state and start a new session. */
     readonly reset: () => void;
-    /** Send a turn with full structured input (message, attachments, input responses). */
-    readonly send: <TOutput = unknown>(input: SendTurnPayload<TOutput>) => Promise<void>;
+    /** Send a message with optional turn settings. */
+    readonly send: <TOutput = unknown>(message: string | UserContent, options?: SendTurnOptions<TOutput>) => Promise<void>;
+    /** Answer pending HITL input requests. */
+    readonly respond: <TOutput = unknown>(inputResponses: Parameters<ClientSession["respond"]>[0], options?: RespondTurnOptions<TOutput>) => Promise<void>;
     /** Current session identity and stream cursor. */
-    readonly session: ComputedRef<SessionState>;
+    readonly session: ComputedRef<ClientSessionState | undefined>;
     /** Lifecycle phase: `"ready"` (idle), `"submitted"` (request sent, awaiting first event), `"streaming"` (events arriving), or `"error"`. */
     readonly status: ComputedRef<UseEveAgentStatus>;
     /** Abort the in-flight request. */
@@ -78,7 +81,7 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
     /** Ordered prefix of the session stream used to rehydrate projected state. */
     readonly initialEvents?: readonly MessageStreamEvent[];
     /** Prior session cursor to resume from on mount. */
-    readonly initialSession?: SessionState;
+    readonly initialSession?: ClientSessionState;
     /**
      * Project submitted user messages before eve confirms them with a
      * `message.received` stream event.

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

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

package/docs/README.md

@@ -86,21 +86,21 @@ eve then gives you:
 The public surface stays filesystem-first, but the implementation model underneath is still useful to
 know:
 
-- channels normalize inbound transport input and define the `continuationToken`
+- channels normalize inbound transport input and map platform addresses to sessions
 - the harness does one unit of AI work and decides whether to continue, wait, or finish
 - the runtime persists session state, streams events, and owns workflow orchestration
 
-That is why eve exposes two identifiers:
-
-- `continuationToken` for the next user message
-- `sessionId` for streaming and inspection
+The default HTTP API exposes one durable `sessionId` for messages, controls, and
+streaming. Platform channels additionally own channel-local continuation
+addresses so a Slack thread or custom conversation ID can point at its current
+session without leaking that routing identity into the HTTP client contract.
 
 ## How to use these docs
 
 - Start with the authored filesystem shape and `agent.ts`.
 - Then add runtime surfaces in this order: skills, tools, workspace, sandbox, channels.
 - Then learn the durable runtime model: HITL, session context, sessions, streaming, and
-  continuation-token follow-ups.
+  ID-addressed follow-ups and channel address routing.
 - Then add advanced features: subagents, schedules, route protection, deployment.
 
 ## Good companions in this repo

package/docs/channels/chat-sdk.mdx

@@ -177,14 +177,13 @@ chatSdkChannel({
 
 ### Proactive sessions
 
-Start a session without an inbound webhook through `channel.receive({ message, target, auth })` — from a schedule `run` handler, or `args.receive(channel, ...)` from another channel. The target is a serialized Chat SDK thread, or `{ threadId, adapterName }` when you only have a provider-native thread id:
+Start a session without an inbound webhook through `to(channel, target).send(message, { auth })` from a schedule `run` handler, or `ctx.to(channel, target).send(message, { auth })` from another channel. The target is a serialized Chat SDK thread, or `{ threadId, adapterName }` when you only have a provider-native thread id:
 
 ```ts
-await channel.receive({
-  message: "Your weekly digest is ready.",
-  target: { adapterName: "resend", threadId: "resend:user@example.com" },
-  auth: null,
-});
+await to(channel, { adapterName: "resend", threadId: "resend:user@example.com" }).send(
+  "Your weekly digest is ready.",
+  { auth: null },
+);
 ```
 
 ### Attachments