eve 0.29.4 → 0.30.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # eve
 
+## 0.30.0
+
+### Minor Changes
+
+- f43b22d: `localDev()` now grants the synthetic local principal based on the deployment (an `eve dev` or `vercel dev` process) instead of the request URL host, so a request `Host` header can no longer obtain local-dev access on a self-hosted server. The previously exported `isLoopbackRequest` helper is removed. The default eve channel now falls back to `[vercelOidc(), localDev(), placeholderAuth()]`, which keeps local dev working and rejects all production traffic.
+
+### Patch Changes
+
+- 021dbbf: Add `/new` as an alias of `/clear` in the eve dev TUI. It clears model-message history while preserving the current session and its durable resources.
+- 136749f: Make `Ctrl+C` cooperatively cancel or steer a running turn like `Esc` in the eve dev TUI. At the idle prompt, the first `Ctrl+C` now shows an exit warning and a second consecutive press exits.
+- 13420ab: Allow dynamic subagent resolvers to return `defineRemoteAgent(...)`. Session and turn selections can now conditionally expose a remote deployment and change its runtime connection settings.
+- ee50ae7: Prevent the dev TUI from duplicating setup panels when an integration setup error includes multiline command output.
+- e1cd7b7: Move eve's internal integration catalog from the Vercel npm scope to `@eve/catalog`.
+- 56651ee: Update eve's bundled Workflow SDK packages to the latest 5.0.0 beta releases, keeping the core runtime and workflow worlds aligned.
+
+## 0.29.5
+
+### Patch Changes
+
+- c0dc572: Rename the TUI `/new` command to `/reset` so session reset uses the same name across the client, HTTP, channel, and TUI APIs.
+- 3dce30a: Add manual session compaction through custom-channel helpers, the eve HTTP client, and the `eve dev` TUI's `/compact` command. Compaction preserves the session, queues behind an active turn, and does not send synthetic model input.
+- 910805e: Make a single `Esc` cancel the running turn in the eve dev TUI when no message is queued. Queued messages still use `Esc` to steer the oldest message into the next turn.
+- 9c51755: Connection search and discovered connection tools now use the same `defineDynamic` and `defineTool` pipeline as authored tools. Dynamic tool maps now reject entries that omit `defineTool` instead of accepting unsupported raw objects.
+- 84aa671: Clarify the dev TUI’s `/add` flow with consistent integration categories and category-specific browsing labels. MCP connections are now named explicitly, and the flow more clearly explains channels, extensions, and observability integrations.
+- 0c28eb7: Allow declared subagents to export `defineDynamic` from `agent.ts`. Session and turn resolvers can now return an agent configuration to expose it or nil to omit it from direct and Workflow delegation.
+- f3bb60d: Add manual session-context clearing through custom-channel helpers, the eve HTTP client, and the `eve dev` TUI's `/clear` command. Clearing removes model-message history while preserving the session, agent configuration, durable state, limits, and sandbox.
+- ac7d3c6: Add `/cancel` to the eve dev TUI. The command cooperatively cancels a running turn from either the live streaming input or the idle prompt while preserving the session and settled context.
+
 ## 0.29.4
 
 ### Patch Changes

package/dist/src/channel/clear-session.d.ts

@@ -0,0 +1,4 @@
+import type { ClearFn } from "#channel/routes.js";
+import type { Runtime } from "#channel/types.js";
+/** Builds a channel-scoped context-clear helper. */
+export declare function createClearFn(runtime: Runtime, channelName: string): ClearFn;

package/dist/src/channel/clear-session.js

@@ -0,0 +1 @@
+function createClearFn(e,t){return async n=>await e.clearSession({continuationToken:`${t}:${n.continuationToken}`})}export{createClearFn};

package/dist/src/channel/compact-session.d.ts

@@ -0,0 +1,4 @@
+import type { CompactFn } from "#channel/routes.js";
+import type { Runtime } from "#channel/types.js";
+/** Builds a channel-scoped manual compaction helper. */
+export declare function createCompactFn(runtime: Runtime, channelName: string): CompactFn;

package/dist/src/channel/compact-session.js

@@ -0,0 +1 @@
+function createCompactFn(e,t){return async n=>await e.compactSession({continuationToken:`${t}:${n.continuationToken}`})}export{createCompactFn};

package/dist/src/channel/routes.d.ts

@@ -1,6 +1,6 @@
 import type { UserContent } from "ai";
 import type { CrossChannelReceiveFn } from "#channel/cross-channel-receive.js";
-import type { CancelTurnResult, SessionAuthContext, SessionCallback } from "#channel/types.js";
+import type { CancelTurnResult, ClearSessionResult, CompactSessionResult, SessionAuthContext, SessionCallback } from "#channel/types.js";
 import type { InputResponse } from "#runtime/input/types.js";
 import type { Session } from "#channel/session.js";
 import type { RunMode } from "#shared/run-mode.js";
@@ -10,11 +10,13 @@ type WebSocketHeaders = Headers | readonly (readonly [string, string])[] | Recor
 /**
  * Second argument passed to every route handler. `send` starts or continues a
  * session on this channel; `cancel` stops the active turn on a session
- * addressed by continuation token; `reset` retires a session so its
- * token can start a fresh session; `getSession` looks one up by id; `receive`
- * hands inbound work to a different channel; `params` contains the matched
- * path parameters; `waitUntil` keeps background work alive past the response;
- * `requestIp` is the client IP, or `null` when the host cannot provide it.
+ * addressed by continuation token; `clear` removes its model-message history;
+ * `compact` summarizes its context without sending model input; `reset` retires
+ * a session so its token can start a fresh session; `getSession` looks one up by
+ * id; `receive` hands inbound work to a different channel; `params` contains
+ * the matched path parameters; `waitUntil` keeps background work alive past
+ * the response; `requestIp` is the client IP, or `null` when the host cannot
+ * provide it.
  */
 export interface RouteHandlerArgs<TState = undefined> {
     send: SendFn<TState>;
@@ -24,6 +26,8 @@ export interface RouteHandlerArgs<TState = undefined> {
      */
     resolveActiveSession: ResolveActiveSessionFn;
     cancel: CancelFn;
+    clear: ClearFn;
+    compact: CompactFn;
     reset: ResetFn;
     getSession: GetSessionFn;
     /**
@@ -119,6 +123,30 @@ export interface CancelOptions {
  * on the event stream.
  */
 export type CancelFn = (options: CancelOptions) => Promise<CancelTurnResult>;
+/** Options for {@link CompactFn}. */
+export interface CompactOptions {
+    /** Channel-local raw token, in the same format accepted by {@link SendFn}. */
+    readonly continuationToken: string;
+}
+/**
+ * Queues context compaction for the session owning a continuation token.
+ * Never sends model input or starts a new session. An accepted request returns
+ * to `session.waiting`; successful compaction emits `compaction.requested`
+ * followed by `compaction.completed` on the session stream.
+ */
+export type CompactFn = (options: CompactOptions) => Promise<CompactSessionResult>;
+/** Options for {@link ClearFn}. */
+export interface ClearOptions {
+    /** Channel-local raw token, in the same format accepted by {@link SendFn}. */
+    readonly continuationToken: string;
+}
+/**
+ * Queues removal of the model-message history for the session owning a
+ * continuation token. Preserves the session, agent configuration, durable
+ * state, limits, and sandbox. Completion is `context.cleared` followed by
+ * `session.waiting` on the session stream.
+ */
+export type ClearFn = (options: ClearOptions) => Promise<ClearSessionResult>;
 /** Options for {@link ResetFn}. */
 export interface ResetOptions {
     /** Channel-local raw token, in the same format accepted by {@link SendFn}. */

package/dist/src/channel/types.d.ts

@@ -27,6 +27,28 @@ export interface CancelTurnResult {
      */
     readonly reason?: string;
 }
+/** Identifies the continuation hook whose durable session should compact. */
+export interface CompactSessionInput {
+    readonly continuationToken: string;
+}
+/** Result of queueing manual context compaction for a session. */
+export type CompactSessionResult = {
+    readonly status: "accepted";
+    readonly sessionId: string;
+} | {
+    readonly status: "no_active_session";
+};
+/** Identifies the continuation hook whose durable session should clear context. */
+export interface ClearSessionInput {
+    readonly continuationToken: string;
+}
+/** Result of queueing a manual context clear for a session. */
+export type ClearSessionResult = {
+    readonly status: "accepted";
+    readonly sessionId: string;
+} | {
+    readonly status: "no_active_session";
+};
 /** Identifies a session to transition permanently to a terminal state. */
 export interface TerminateSessionInput {
     /** Human-readable reason recorded on the terminal workflow transition. */
@@ -100,6 +122,18 @@ export interface SessionAuthContext {
  * interface: the runtime always writes events itself.
  */
 export type EventEmitFn = (event: UnstampedMessageStreamEvent) => Promise<void>;
+/** Framework-internal caller waiting for one delegated conversation turn. */
+export interface TurnCaller {
+    readonly callId: string;
+    readonly subagentName: string;
+    readonly replyTo: {
+        readonly kind: "hook";
+        readonly token: string;
+    } | {
+        readonly kind: "callback";
+        readonly url: string;
+    };
+}
 /**
  * Base deliver payload crossing the runtime boundary.
  *
@@ -122,12 +156,13 @@ export interface DeliverPayload {
 /**
  * Deliver payload sent through the workflow `resumeHook`.
  *
- * Wraps the raw {@link DeliverPayload} with an optional auth update so
- * deliver-time auth crosses the durable hook boundary without a process-local
- * side-channel.
+ * Wraps the raw {@link DeliverPayload} with optional auth and turn-caller
+ * metadata so both cross the durable hook boundary outside adapter-owned data.
  */
 export interface DeliverHookPayload {
     readonly auth?: SessionAuthContext | null;
+    /** Delegated caller waiting for this turn's settled result. */
+    readonly caller?: TurnCaller;
     /** Inbound channel request id used only for workflow attributes. */
     readonly requestId?: string;
     readonly kind: "deliver";
@@ -137,6 +172,14 @@ export interface DeliverHookPayload {
 export interface SessionTimeoutHookPayload {
     readonly kind: "session-timeout";
 }
+/** Requests a context compaction without delivering model input. */
+export interface CompactSessionHookPayload {
+    readonly kind: "compact";
+}
+/** Requests a context clear without delivering model input. */
+export interface ClearSessionHookPayload {
+    readonly kind: "clear";
+}
 /**
  * Runtime-action results resumed back into a parked parent workflow.
  */
@@ -192,13 +235,15 @@ export interface SubagentAuthorizationEventHookPayload {
 /**
  * Serializable payload sent through the workflow `resumeHook`.
  */
-export type HookPayload = DeliverHookPayload | RuntimeActionResultHookPayload | SessionTimeoutHookPayload | SubagentAuthorizationEventHookPayload | SubagentInputRequestHookPayload;
+export type HookPayload = ClearSessionHookPayload | CompactSessionHookPayload | DeliverHookPayload | RuntimeActionResultHookPayload | SessionTimeoutHookPayload | SubagentAuthorizationEventHookPayload | SubagentInputRequestHookPayload;
 /**
- * Terminal callback metadata attached to a session at creation.
+ * Initial caller callback attached to a delegated session at creation.
  *
  * `url` is the absolute callback endpoint. `token` is the capability token
  * embedded in the framework-owned callback route. `callId` and `subagentName`
- * correlate the callee's terminal callback to the pending parent tool call.
+ * correlate the callee's result to the pending tool call. Task sessions send a
+ * terminal session result. Conversation sessions use this as their first turn's
+ * caller; each continuation supplies the caller for that turn.
  */
 export interface SessionCallback {
     readonly callId: string;
@@ -265,8 +310,9 @@ export interface RunInput {
      */
     readonly title?: string;
     /**
-     * Optional terminal callback. When present, the runtime posts a single
-     * callback when the session completes or fails.
+     * Optional caller callback. Task sessions post when the session completes or
+     * fails. Conversation sessions use it for the first turn; continuations carry
+     * the caller for their own turn.
      */
     readonly callback?: SessionCallback;
     /**
@@ -312,12 +358,14 @@ export interface RunInput {
 }
 export interface DeliverInput {
     /**
-     * Authenticated caller principal for this follow-up message.
+     * Authenticated principal for this follow-up message.
      * May differ from the session initiator when different users send
      * messages to the same session. The runtime updates `AuthKey` from
      * this field before calling the adapter's hooks.
      */
     readonly auth?: SessionAuthContext | null;
+    /** Delegated caller waiting for this turn's settled result. */
+    readonly caller?: TurnCaller;
     /** Inbound channel request id used to correlate workflow attributes. */
     readonly requestId?: string;
     readonly continuationToken: string;
@@ -364,6 +412,10 @@ export interface Runtime {
     run(input: RunInput): Promise<RunHandle>;
     /** Requests cancellation of a session's in-flight turn. */
     cancelTurn(input: CancelTurnInput): Promise<CancelTurnResult>;
+    /** Queues context compaction on the session owning a continuation token. */
+    compactSession(input: CompactSessionInput): Promise<CompactSessionResult>;
+    /** Queues a context clear on the session owning a continuation token. */
+    clearSession(input: ClearSessionInput): Promise<ClearSessionResult>;
     /** Terminally retires a session and releases its non-retained continuation hooks. */
     terminateSession(input: TerminateSessionInput): Promise<TerminateSessionResult>;
     /**

package/dist/src/chunks/{use-eve-agent-8mofdZcO.js → use-eve-agent-BXMIf5fR.js}

@@ -7,6 +7,8 @@ const EVE_HEALTH_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/health`;
 const EVE_INFO_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/info`;
 const EVE_CREATE_SESSION_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/session`;
 const EVE_RESET_SESSION_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/session/reset`;
+const EVE_COMPACT_SESSION_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/session/compact`;
+const EVE_CLEAR_SESSION_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/session/clear`;
 const EVE_CONTINUE_SESSION_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/session/:sessionId`;
 const EVE_MESSAGE_STREAM_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/session/:sessionId/stream`;
 const EVE_CANCEL_TURN_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/session/:sessionId/cancel`;
@@ -118,7 +120,7 @@ const schedule = entry.extend({
 	markdown: z.string().optional()
 });
 const subagent = entry.extend({
-	description: z.string(),
+	description: z.string().optional(),
 	entryPath: z.string(),
 	nodeId: z.string(),
 	rootPath: z.string(),
@@ -383,6 +385,28 @@ const CancelTurnResponseSchema = z.object({
 	status: z.enum(["accepted", "no_active_turn"])
 });
 
+//#endregion
+//#region src/protocol/clear-session.ts
+const ClearResponseSchema = z.discriminatedUnion("status", [z.object({
+	ok: z.literal(true),
+	sessionId: z.string().min(1),
+	status: z.literal("accepted")
+}), z.object({
+	ok: z.literal(true),
+	status: z.literal("no_active_session")
+})]);
+
+//#endregion
+//#region src/protocol/compact-session.ts
+const CompactResponseSchema = z.discriminatedUnion("status", [z.object({
+	ok: z.literal(true),
+	sessionId: z.string().min(1),
+	status: z.literal("accepted")
+}), z.object({
+	ok: z.literal(true),
+	status: z.literal("no_active_session")
+})]);
+
 //#endregion
 //#region src/protocol/reset-session.ts
 const ResetResponseSchema = z.discriminatedUnion("status", [z.object({
@@ -882,6 +906,66 @@ var ClientSession = class {
 			status: result.data.status
 		};
 	}
+	async clear() {
+		const state = this.#state;
+		const continuationToken = state.continuationToken;
+		if (continuationToken === void 0) {
+			if (state.sessionId !== void 0) throw new Error("Session has no continuation token. Consume its event stream before clearing.");
+			return { status: "no_active_session" };
+		}
+		const url = createClientUrl(this.#context.host, EVE_CLEAR_SESSION_ROUTE_PATH);
+		const headers = await this.#context.resolveHeaders();
+		headers.set("content-type", "application/json");
+		const response = await fetch(url, withRedirectPolicy$1({
+			body: JSON.stringify({ continuationToken }),
+			headers,
+			method: "POST"
+		}, this.#context.redirect));
+		const body = await response.text();
+		if (!response.ok) throw new ClientError(response.status, body, response.headers);
+		let payload;
+		try {
+			payload = JSON.parse(body);
+		} catch {
+			throw new Error(`Clear route returned invalid JSON (${response.status}).`);
+		}
+		const result = ClearResponseSchema.safeParse(payload);
+		if (!result.success || result.data.status === "accepted" && state.sessionId !== void 0 && result.data.sessionId !== state.sessionId) throw new Error(`Clear route returned an invalid response (${response.status}).`);
+		return result.data.status === "accepted" ? {
+			sessionId: result.data.sessionId,
+			status: "accepted"
+		} : { status: "no_active_session" };
+	}
+	async compact() {
+		const state = this.#state;
+		const continuationToken = state.continuationToken;
+		if (continuationToken === void 0) {
+			if (state.sessionId !== void 0) throw new Error("Session has no continuation token. Consume its event stream before compacting.");
+			return { status: "no_active_session" };
+		}
+		const url = createClientUrl(this.#context.host, EVE_COMPACT_SESSION_ROUTE_PATH);
+		const headers = await this.#context.resolveHeaders();
+		headers.set("content-type", "application/json");
+		const response = await fetch(url, withRedirectPolicy$1({
+			body: JSON.stringify({ continuationToken }),
+			headers,
+			method: "POST"
+		}, this.#context.redirect));
+		const body = await response.text();
+		if (!response.ok) throw new ClientError(response.status, body, response.headers);
+		let payload;
+		try {
+			payload = JSON.parse(body);
+		} catch {
+			throw new Error(`Compact route returned invalid JSON (${response.status}).`);
+		}
+		const result = CompactResponseSchema.safeParse(payload);
+		if (!result.success || result.data.status === "accepted" && state.sessionId !== void 0 && result.data.sessionId !== state.sessionId) throw new Error(`Compact route returned an invalid response (${response.status}).`);
+		return result.data.status === "accepted" ? {
+			sessionId: result.data.sessionId,
+			status: "accepted"
+		} : { status: "no_active_session" };
+	}
 	async reset() {
 		const state = this.#state;
 		const continuationToken = state.continuationToken;

package/dist/src/chunks/{use-eve-agent-bKJbH0k4.js → use-eve-agent-k-XHfrJT.js}

@@ -7,6 +7,8 @@ const EVE_HEALTH_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/health`;
 const EVE_INFO_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/info`;
 const EVE_CREATE_SESSION_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/session`;
 const EVE_RESET_SESSION_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/session/reset`;
+const EVE_COMPACT_SESSION_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/session/compact`;
+const EVE_CLEAR_SESSION_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/session/clear`;
 const EVE_CONTINUE_SESSION_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/session/:sessionId`;
 const EVE_MESSAGE_STREAM_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/session/:sessionId/stream`;
 const EVE_CANCEL_TURN_ROUTE_PATTERN = `${EVE_ROUTE_PREFIX}/session/:sessionId/cancel`;
@@ -118,7 +120,7 @@ const schedule = entry.extend({
 	markdown: z.string().optional()
 });
 const subagent = entry.extend({
-	description: z.string(),
+	description: z.string().optional(),
 	entryPath: z.string(),
 	nodeId: z.string(),
 	rootPath: z.string(),
@@ -383,6 +385,28 @@ const CancelTurnResponseSchema = z.object({
 	status: z.enum(["accepted", "no_active_turn"])
 });
 
+//#endregion
+//#region src/protocol/clear-session.ts
+const ClearResponseSchema = z.discriminatedUnion("status", [z.object({
+	ok: z.literal(true),
+	sessionId: z.string().min(1),
+	status: z.literal("accepted")
+}), z.object({
+	ok: z.literal(true),
+	status: z.literal("no_active_session")
+})]);
+
+//#endregion
+//#region src/protocol/compact-session.ts
+const CompactResponseSchema = z.discriminatedUnion("status", [z.object({
+	ok: z.literal(true),
+	sessionId: z.string().min(1),
+	status: z.literal("accepted")
+}), z.object({
+	ok: z.literal(true),
+	status: z.literal("no_active_session")
+})]);
+
 //#endregion
 //#region src/protocol/reset-session.ts
 const ResetResponseSchema = z.discriminatedUnion("status", [z.object({
@@ -882,6 +906,66 @@ var ClientSession = class {
 			status: result.data.status
 		};
 	}
+	async clear() {
+		const state = this.#state;
+		const continuationToken = state.continuationToken;
+		if (continuationToken === void 0) {
+			if (state.sessionId !== void 0) throw new Error("Session has no continuation token. Consume its event stream before clearing.");
+			return { status: "no_active_session" };
+		}
+		const url = createClientUrl(this.#context.host, EVE_CLEAR_SESSION_ROUTE_PATH);
+		const headers = await this.#context.resolveHeaders();
+		headers.set("content-type", "application/json");
+		const response = await fetch(url, withRedirectPolicy$1({
+			body: JSON.stringify({ continuationToken }),
+			headers,
+			method: "POST"
+		}, this.#context.redirect));
+		const body = await response.text();
+		if (!response.ok) throw new ClientError(response.status, body, response.headers);
+		let payload;
+		try {
+			payload = JSON.parse(body);
+		} catch {
+			throw new Error(`Clear route returned invalid JSON (${response.status}).`);
+		}
+		const result = ClearResponseSchema.safeParse(payload);
+		if (!result.success || result.data.status === "accepted" && state.sessionId !== void 0 && result.data.sessionId !== state.sessionId) throw new Error(`Clear route returned an invalid response (${response.status}).`);
+		return result.data.status === "accepted" ? {
+			sessionId: result.data.sessionId,
+			status: "accepted"
+		} : { status: "no_active_session" };
+	}
+	async compact() {
+		const state = this.#state;
+		const continuationToken = state.continuationToken;
+		if (continuationToken === void 0) {
+			if (state.sessionId !== void 0) throw new Error("Session has no continuation token. Consume its event stream before compacting.");
+			return { status: "no_active_session" };
+		}
+		const url = createClientUrl(this.#context.host, EVE_COMPACT_SESSION_ROUTE_PATH);
+		const headers = await this.#context.resolveHeaders();
+		headers.set("content-type", "application/json");
+		const response = await fetch(url, withRedirectPolicy$1({
+			body: JSON.stringify({ continuationToken }),
+			headers,
+			method: "POST"
+		}, this.#context.redirect));
+		const body = await response.text();
+		if (!response.ok) throw new ClientError(response.status, body, response.headers);
+		let payload;
+		try {
+			payload = JSON.parse(body);
+		} catch {
+			throw new Error(`Compact route returned invalid JSON (${response.status}).`);
+		}
+		const result = CompactResponseSchema.safeParse(payload);
+		if (!result.success || result.data.status === "accepted" && state.sessionId !== void 0 && result.data.sessionId !== state.sessionId) throw new Error(`Compact route returned an invalid response (${response.status}).`);
+		return result.data.status === "accepted" ? {
+			sessionId: result.data.sessionId,
+			status: "accepted"
+		} : { status: "no_active_session" };
+	}
 	async reset() {
 		const state = this.#state;
 		const continuationToken = state.continuationToken;

package/dist/src/cli/dev/tui/message-queue.d.ts

@@ -4,11 +4,11 @@
  *
  * Enter queues the draft (up to {@link MESSAGE_QUEUE_LIMIT}); each queued
  * message waits for the turn to end, where the whole queue coalesces into
- * the next turn's message. Esc pops the oldest message to steer the
+ * the next turn's message. Esc or Ctrl+C pops the oldest message to steer the
  * conversation instead of waiting: the renderer requests cooperative turn
  * cancellation and the runner submits the popped message as the next turn.
- * Esc on an empty queue arms cancellation; a second Esc cancels the turn
- * without a replacement message.
+ * `/cancel` requests cancellation directly. Either key on an empty queue
+ * cancels the turn immediately without a replacement message.
  *
  * The renderer owns lifecycle (keys, cancel requests, when the runner drains
  * the queue); this module only holds the queue state machine and paints rows.
@@ -24,9 +24,7 @@ export type MessageQueueEscapeOutcome =
  * into the same staged steer payload and re-request cancellation.
  */
 "steer"
-/** Queue empty: cancellation armed; the next Esc cancels. */
- | "armed"
-/** Second Esc on an empty queue — the caller should cancel the turn. */
+/** Empty queue — the caller should cancel the turn. */
  | "cancel";
 /** Read-only projection consumed by {@link renderMessageQueueRows}. */
 export interface MessageQueueView {
@@ -34,27 +32,25 @@ export interface MessageQueueView {
     readonly full: boolean;
     /** A popped message is staged and turn cancellation was requested. */
     readonly steering: boolean;
-    /** First Esc on an empty queue landed; the next one cancels. */
-    readonly armed: boolean;
-    /** Esc Esc on an empty queue landed; cancellation was requested. */
+    /** A cancel key on an empty queue landed; cancellation was requested. */
     readonly cancelling: boolean;
 }
 export declare class MessageQueue {
     #private;
     get size(): number;
     get full(): boolean;
-    /** True when nothing is queued, staged, armed, or cancelling. */
+    /** True when nothing is queued, staged, or cancelling. */
     get idle(): boolean;
     /** Queues one message; returns false (draft stays put) when full. */
     enqueue(message: string): boolean;
     /**
-     * Applies one Esc press. Pops the oldest queued message into the staged
-     * steer payload while any remain; with an empty queue, arms and then
-     * requests cancellation.
+     * Applies one Esc or Ctrl+C press. Pops the oldest queued message into the
+     * staged steer payload while any remain; with an empty queue, requests
+     * cancellation immediately.
      */
     handleEscape(): MessageQueueEscapeOutcome;
-    /** Any non-Esc activity backs out of the armed press-again state. */
-    disarm(): void;
+    /** Marks a direct cancellation request without consuming queued messages. */
+    requestCancellation(): void;
     /** Clears per-turn Esc state when a new stream starts rendering. */
     beginTurn(): void;
     /**
@@ -76,7 +72,7 @@ export interface MessageQueuePanelRowsInput {
     readonly view: MessageQueueView;
     readonly width: number;
     readonly theme: Theme;
-    /** True while a turn streams — the only state in which Esc steers. */
+    /** True while a turn streams — the only state in which keys steer. */
     readonly working: boolean;
 }
 /**

package/dist/src/cli/dev/tui/message-queue.js

@@ -1 +1 @@
-import"./rail.js";import{clipVisible,stripTerminalControls}from"#cli/ui/terminal-text.js";const MESSAGE_QUEUE_LIMIT=5;var MessageQueue=class{#e=[];#t;#n=!1;#r=!1;get size(){return this.#e.length}get full(){return this.#e.length>=5}get idle(){return this.#e.length===0&&this.#t===void 0&&!this.#n&&!this.#r}enqueue(e){return this.full?!1:(this.#e.push(e),this.#n=!1,!0)}handleEscape(){let e=this.#e.shift();return e===void 0?this.#t===void 0?this.#n?(this.#r=!0,`cancel`):(this.#n=!0,`armed`):`steer`:(this.#t=joinMessages(this.#t,e),`steer`)}disarm(){this.#n=!1}beginTurn(){this.#n=!1,this.#r=!1}takePrompt(){this.#n=!1,this.#r=!1;let e=this.#t;return e===void 0?this.#i():(this.#t=void 0,e)}restoreDraft(){this.#n=!1,this.#r=!1;let e=this.#t;return this.#t=void 0,joinOptionalMessages(e,this.#i())}reset(){this.#e=[],this.#t=void 0,this.#n=!1,this.#r=!1}view(){return{messages:[...this.#e],full:this.full,steering:this.#t!==void 0,armed:this.#n,cancelling:this.#r}}#i(){if(this.#e.length===0)return;let e=this.#e.reduce(joinOptionalMessages,void 0);return this.#e=[],e}};function joinMessages(e,t){return e===void 0?t:`${e}\n\n${t}`}function joinOptionalMessages(e,t){return t===void 0?e:joinMessages(e,t)}function renderMessageQueueRows(n){let{view:r,width:i,theme:a,working:o}=n,s=a.colors,c=a.glyph;if(r.messages.length===0&&!r.steering)return o?r.cancelling?[clipVisible(`  ${s.yellow(c.dotActive)} ${s.dim(`Cancelling turn…`)}`,i)]:r.armed?[clipVisible(`  ${s.yellow(c.dotActive)} ${s.dim(`Press esc again to cancel the turn`)}`,i)]:[]:[];let l=[clipVisible(`  ${s.gray(c.arrowUp)} ${headerBody(r,o,a)}`,i)];for(let[n,a]of r.messages.entries()){let o=n===r.messages.length-1?c.corner:c.rule,u=firstLine(stripTerminalControls(a));l.push(clipVisible(`  ${s.dim(o)} ${s.dim(u)}`,i))}return l}function headerBody(e,t,n){let r=n.colors,i=` ${n.glyph.dot} `,a=`${String(e.messages.length)}/5`;if(e.steering){let t=e.messages.length>0?`${i}${a} still queued`:``;return r.dim(`Steering — cancelling the running turn…${t}`)}let o=e.full?`${i}queue full`:``,s=t?`${i}esc steers with the next message`:``;return`${r.bold(`Queue`)} ${r.dim(`${a}${o}${s}`)}`}function firstLine(e){return e.split(/\r?\n/u,1)[0]??``}export{MESSAGE_QUEUE_LIMIT,MessageQueue,renderMessageQueueRows};
+import"./rail.js";import{clipVisible,stripTerminalControls}from"#cli/ui/terminal-text.js";const MESSAGE_QUEUE_LIMIT=5;var MessageQueue=class{#e=[];#t;#n=!1;get size(){return this.#e.length}get full(){return this.#e.length>=5}get idle(){return this.#e.length===0&&this.#t===void 0&&!this.#n}enqueue(e){return this.full?!1:(this.#e.push(e),!0)}handleEscape(){let e=this.#e.shift();return e===void 0?this.#t===void 0?(this.#n=!0,`cancel`):`steer`:(this.#t=joinMessages(this.#t,e),`steer`)}requestCancellation(){this.#n=!0}beginTurn(){this.#n=!1}takePrompt(){this.#n=!1;let e=this.#t;return e===void 0?this.#r():(this.#t=void 0,e)}restoreDraft(){this.#n=!1;let e=this.#t;return this.#t=void 0,joinOptionalMessages(e,this.#r())}reset(){this.#e=[],this.#t=void 0,this.#n=!1}view(){return{messages:[...this.#e],full:this.full,steering:this.#t!==void 0,cancelling:this.#n}}#r(){if(this.#e.length===0)return;let e=this.#e.reduce(joinOptionalMessages,void 0);return this.#e=[],e}};function joinMessages(e,t){return e===void 0?t:`${e}\n\n${t}`}function joinOptionalMessages(e,t){return t===void 0?e:joinMessages(e,t)}function renderMessageQueueRows(n){let{view:r,width:i,theme:a,working:o}=n,s=a.colors,c=a.glyph;if(r.messages.length===0&&!r.steering)return o&&r.cancelling?[clipVisible(`  ${s.yellow(c.dotActive)} ${s.dim(`Cancelling turn…`)}`,i)]:[];let l=[clipVisible(`  ${s.gray(c.arrowUp)} ${headerBody(r,o,a)}`,i)];for(let[n,a]of r.messages.entries()){let o=n===r.messages.length-1?c.corner:c.rule,u=firstLine(stripTerminalControls(a));l.push(clipVisible(`  ${s.dim(o)} ${s.dim(u)}`,i))}return l}function headerBody(e,t,n){let r=n.colors,i=` ${n.glyph.dot} `,a=`${String(e.messages.length)}/5`;if(e.steering){let t=e.messages.length>0?`${i}${a} still queued`:``;return r.dim(`Steering — cancelling the running turn…${t}`)}let o=e.full?`${i}queue full`:``,s=t?`${i}esc or ctrl+c steers with the next message`:``;return`${r.bold(`Queue`)} ${r.dim(`${a}${o}${s}`)}`}function firstLine(e){return e.split(/\r?\n/u,1)[0]??``}export{MESSAGE_QUEUE_LIMIT,MessageQueue,renderMessageQueueRows};

package/dist/src/cli/dev/tui/prompt-commands.d.ts

@@ -2,7 +2,13 @@ export type PromptCommandExtensionName = "model" | "add" | "deploy" | "vc:instal
 type PromptCommandTarget = "local" | "remote";
 /** The slash commands the prompt accepts. */
 export type PromptCommand = {
-    type: "new";
+    type: "reset";
+} | {
+    type: "cancel";
+} | {
+    type: "clear";
+} | {
+    type: "compact";
 } | {
     type: "exit";
 } | {
@@ -41,10 +47,12 @@ export declare function promptCommandsFor(target: PromptCommandTarget): readonly
 /** Whether a command runs against this target — the one authority dispatch shares with discovery. */
 export declare function isPromptCommandAvailableFor(name: PromptCommandExtensionName, target: PromptCommandTarget): boolean;
 /**
- * Recognizes the slash commands the prompt accepts. `/new` clears the
- * session and transcript; `/exit` (and `/quit`) terminate the TUI like
- * Ctrl+C; extension commands are dispatched outside the runner. Anything
- * else — including unknown `/text` — is a normal message.
+ * Recognizes the slash commands the prompt accepts. `/reset` clears the
+ * session and transcript; `/cancel` stops the running turn; `/clear` (and
+ * `/new`) clears context; `/compact` queues context compaction; `/exit` (and
+ * `/quit`) terminate the TUI like Ctrl+C; extension commands are dispatched
+ * outside the runner. Anything else — including unknown `/text` — is a normal
+ * message.
  */
 export declare function parsePromptCommand(prompt: string): PromptCommand | null;
 /** True for prompts that are commands, which never echo as user messages. */

package/dist/src/cli/dev/tui/prompt-commands.js

@@ -1,2 +1,2 @@
-const PROMPT_COMMAND_DEFINITIONS=[{name:`help`,aliases:[],description:`Show available commands`,takesArgument:!1,build:()=>({type:`help`}),targets:[`local`,`remote`]},{name:`new`,aliases:[],description:`Start a fresh session`,takesArgument:!1,build:()=>({type:`new`}),targets:[`local`,`remote`]},{name:`vc:install`,aliases:[],description:`Install the Vercel CLI`,takesArgument:!1,build:()=>({type:`extension`,name:`vc:install`,argument:``}),targets:[`local`,`remote`]},{name:`vc:login`,aliases:[],description:`Authenticate with Vercel`,takesArgument:!1,build:()=>({type:`extension`,name:`vc:login`,argument:``}),targets:[`local`,`remote`]},{name:`model`,aliases:[],description:`Configure the agent's model and provider`,argumentHint:`[provider/model]`,takesArgument:!0,build:e=>({type:`extension`,name:`model`,argument:e}),targets:[`local`]},{name:`loglevel`,aliases:[],description:`Show or hide captured stdout/stderr/sandbox logs`,argumentHint:`[all|stderr|sandbox|none]`,takesArgument:!0,build:e=>({type:`loglevel`,argument:e}),targets:[`local`,`remote`]},{name:`traces`,aliases:[],description:`Open the local trace viewer`,argumentHint:`[trace]`,takesArgument:!0,build:e=>({type:`traces`,argument:e}),targets:[`local`]},{name:`add`,aliases:[],description:`Browse and add registry integrations`,takesArgument:!1,build:()=>({type:`extension`,name:`add`,argument:``}),targets:[`local`]},{name:`deploy`,aliases:[],description:`Deploy the agent to Vercel`,takesArgument:!1,build:()=>({type:`extension`,name:`deploy`,argument:``}),targets:[`local`]},{name:`exit`,aliases:[`quit`],description:`Quit the TUI`,takesArgument:!1,build:()=>({type:`exit`}),targets:[`local`,`remote`]}],PROMPT_COMMANDS=PROMPT_COMMAND_DEFINITIONS;function promptCommandsFor(t){return PROMPT_COMMAND_DEFINITIONS.filter(e=>e.targets.some(e=>e===t))}function isPromptCommandAvailableFor(t,n){return(PROMPT_COMMAND_DEFINITIONS.find(e=>e.name===t)?.targets)?.includes(n)??!1}function parsePromptCommand(e){let n=e.trim();if(!n.startsWith(`/`))return null;for(let e of PROMPT_COMMANDS)for(let t of[e.name,...e.aliases]){let r=`/${t}`;if(n===r)return e.build(``);if(e.takesArgument&&n.startsWith(`${r} `))return e.build(n.slice(r.length).trim())}return null}function isPromptControlCommand(e){return parsePromptCommand(e)!==null}function formatPromptCommandHelp(e=PROMPT_COMMANDS){let n=e.map(e=>{let t=e.argumentHint===void 0?``:` ${e.argumentHint}`,n=e.aliases.map(e=>` (/${e})`).join(``);return{invocation:`/${e.name}${t}${n}`,description:e.description}}),r=Math.max(...n.map(e=>e.invocation.length))+2;return n.map(e=>e.invocation.padEnd(r)+e.description).join(`
+const PROMPT_COMMAND_DEFINITIONS=[{name:`help`,aliases:[],description:`Show available commands`,takesArgument:!1,build:()=>({type:`help`}),targets:[`local`,`remote`]},{name:`reset`,aliases:[],description:`Start a fresh session`,takesArgument:!1,build:()=>({type:`reset`}),targets:[`local`,`remote`]},{name:`cancel`,aliases:[],description:`Cancel the running turn`,takesArgument:!1,build:()=>({type:`cancel`}),targets:[`local`,`remote`]},{name:`clear`,aliases:[`new`],description:`Clear the current session context`,takesArgument:!1,build:()=>({type:`clear`}),targets:[`local`,`remote`]},{name:`compact`,aliases:[],description:`Compact the current session context`,takesArgument:!1,build:()=>({type:`compact`}),targets:[`local`,`remote`]},{name:`vc:install`,aliases:[],description:`Install the Vercel CLI`,takesArgument:!1,build:()=>({type:`extension`,name:`vc:install`,argument:``}),targets:[`local`,`remote`]},{name:`vc:login`,aliases:[],description:`Authenticate with Vercel`,takesArgument:!1,build:()=>({type:`extension`,name:`vc:login`,argument:``}),targets:[`local`,`remote`]},{name:`model`,aliases:[],description:`Configure the agent's model and provider`,argumentHint:`[provider/model]`,takesArgument:!0,build:e=>({type:`extension`,name:`model`,argument:e}),targets:[`local`]},{name:`loglevel`,aliases:[],description:`Show or hide captured stdout/stderr/sandbox logs`,argumentHint:`[all|stderr|sandbox|none]`,takesArgument:!0,build:e=>({type:`loglevel`,argument:e}),targets:[`local`,`remote`]},{name:`traces`,aliases:[],description:`Open the local trace viewer`,argumentHint:`[trace]`,takesArgument:!0,build:e=>({type:`traces`,argument:e}),targets:[`local`]},{name:`add`,aliases:[],description:`Add an integration from the registry`,takesArgument:!1,build:()=>({type:`extension`,name:`add`,argument:``}),targets:[`local`]},{name:`deploy`,aliases:[],description:`Deploy the agent to Vercel`,takesArgument:!1,build:()=>({type:`extension`,name:`deploy`,argument:``}),targets:[`local`]},{name:`exit`,aliases:[`quit`],description:`Quit the TUI`,takesArgument:!1,build:()=>({type:`exit`}),targets:[`local`,`remote`]}],PROMPT_COMMANDS=PROMPT_COMMAND_DEFINITIONS;function promptCommandsFor(t){return PROMPT_COMMAND_DEFINITIONS.filter(e=>e.targets.some(e=>e===t))}function isPromptCommandAvailableFor(t,n){return(PROMPT_COMMAND_DEFINITIONS.find(e=>e.name===t)?.targets)?.includes(n)??!1}function parsePromptCommand(e){let n=e.trim();if(!n.startsWith(`/`))return null;for(let e of PROMPT_COMMANDS)for(let t of[e.name,...e.aliases]){let r=`/${t}`;if(n===r)return e.build(``);if(e.takesArgument&&n.startsWith(`${r} `))return e.build(n.slice(r.length).trim())}return null}function isPromptControlCommand(e){return parsePromptCommand(e)!==null}function formatPromptCommandHelp(e=PROMPT_COMMANDS){let n=e.map(e=>{let t=e.argumentHint===void 0?``:` ${e.argumentHint}`,n=e.aliases.map(e=>` (/${e})`).join(``);return{invocation:`/${e.name}${t}${n}`,description:e.description}}),r=Math.max(...n.map(e=>e.invocation.length))+2;return n.map(e=>e.invocation.padEnd(r)+e.description).join(`
 `)}export{PROMPT_COMMANDS,formatPromptCommandHelp,isPromptCommandAvailableFor,isPromptControlCommand,parsePromptCommand,promptCommandsFor};

package/dist/src/cli/dev/tui/runner.d.ts

@@ -23,11 +23,11 @@ export type AgentTUIStreamResult = {
     abort?: () => void;
     /**
      * Requests cooperative server-side cancellation of the streaming turn
-     * (Esc Esc, or an Esc steer pop). Unlike {@link abort} — which drops the
-     * client stream and forces a fresh session — the server settles the turn
-     * as `turn.cancelled` → `session.waiting`, so the stream reaches its
-     * boundary normally and the session keeps its context. Best-effort and
-     * idempotent; scoped to the turn the user observed when its id is known.
+     * (`/cancel`, Esc, or Ctrl+C; the keys steer when a message is queued). Unlike
+     * {@link abort} — which drops the client stream and forces a fresh session —
+     * the server settles the turn as `turn.cancelled` → `session.waiting`, so
+     * the stream reaches its boundary normally and the session keeps its context.
+     * Best-effort and idempotent; scoped to the turn the user observed when its id is known.
      */
     cancel?: () => void;
     turnState?: AgentTUITurnState;
@@ -202,7 +202,7 @@ export type AgentTUIRenderer = {
     /**
      * Reports the server session id backing the conversation — pushed by the
      * runner once a send is accepted, and overwritten when a later session's
-     * turn is accepted. Deliberately sticky across `/new` and interrupt
+     * turn is accepted. Deliberately sticky across `/reset` and interrupt
      * recovery: the terminal renderer echoes the LAST session this TUI talked
      * to in the parting line on exit, so an interrupted conversation (whose
      * replacement session never ran a turn) can still be found again
@@ -265,7 +265,7 @@ export type AgentTUIRenderer = {
     /**
      * Clears the rendered transcript and resets per-conversation display
      * state, leaving the UI interactive on a fresh screen. Used by the
-     * `/new` command to start a new session with a clean slate.
+     * `/reset` command to start a new session with a clean slate.
      */
     reset?(): void;
     /**