@economic/agents 3.1.0 → 3.2.1

package/README.md

@@ -675,6 +675,24 @@ export class SupportAgent extends Agent<RequestContext, UserContext> {
 - **Requests without the caller's token,** such as an OAuth callback or a signed webhook, are refused unless `acceptsWithoutToken(request)` returns `true` for them. Check them another way.
 - **Any authenticator works:** `getAuthenticator(env)` can return your own `Authenticator`, such as one for a different identity provider.
 
+### Reading without chatting
+
+Return `false` from `canChat(userContext)` to let a user read their chats but not chat in them.
+
+- **Refused:** messages, approval answers, a client tool's result that would start another turn, and `run`. Nothing they send is kept.
+- **Still allowed:** reading the chat, rating messages, stopping a turn, and a client tool's result for the turn that's running. A running turn finishes.
+- **The client** is told in the `connected` frame (`canChat: false`), which `useChat` returns as `canChat`.
+- **When it's asked:** once per connection, when the user connects, so a change reaches them when they reconnect. An error counts as `false`. An override of `onConnect` must call `super.onConnect`.
+- **The connection** is marked readonly, so it can't change the agent's state either.
+
+```ts
+export class SupportChat extends ChatAgent<RequestContext, UserContext> {
+  canChat(userContext: UserContext | undefined) {
+    return userContext?.hasSupportAgent === true;
+  }
+}
+```
+
 ## Memory
 
 Return `memory: true` from `getAgentConfig()` to give each user a private memory with the agent, kept across all their chats in their `UserStore` (`AGENTS_USERS`). It's a writable block of the system prompt, which the model updates itself with `set_context`.
@@ -792,6 +810,7 @@ Imported from `@economic/agents` unless noted.
 | `configureContext()`                           | `Agent`     | Think's system prompt blocks. An override must include `...(await super.configureContext())`, or the agent's own prompt and rules are lost.                                                                                                                                                                                                                                                                                             |
 | `getTracingHandlers()`                         | `Agent`     | Destinations for completed turns and message feedback (default: `[]`).                                                                                                                                                                                                                                                                                                                                                                  |
 | `static getAuthenticator(env)`                 | `Agent`     | Optional caller authentication, credentials and user context.                                                                                                                                                                                                                                                                                                                                                                           |
+| `canChat(userContext)`                         | `Agent`     | Whether the user can send messages and answer approvals (default `true`). See [Reading without chatting](#reading-without-chatting).                                                                                                                                                                                                                                                                                                    |
 | `submitMessageFeedback` / `getMessageFeedback` | `ChatAgent` | Callable message feedback.                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `getAgentConfig(ctx?)`                         | `Agent`     | Settings for a turn (default `{}`): `maxSteps`, `temperature`, `maxOutputTokens`, `topP`, `toolChoice`, `maxRetries`, `timeout`, `sendReasoning`, `providerOptions`; `toolCallLimits`, how often each user may call each tool by name, per day (`dailyCalls`) and per minute (`burst`), which needs `AGENTS_USERS`; for a chat, `memory`, a private memory per user, and `deleteMessagesAfterMs`, after which its messages are deleted. |
 | `agent`                                        | `Assistant` | Required. Your `ChatAgent` subclass.                                                                                                                                                                                                                                                                                                                                                                                                    |

package/dist/index.d.mts

@@ -12873,6 +12873,24 @@ export declare abstract class Agent<RequestContext extends Record<string, unknow
    */
   protected acceptsWithoutToken(_request: Request): boolean;
   onConnect(connection: Connection, ctx: ConnectionContext): Promise<void>;
+  /**
+   * Whether the user can send messages and answer approvals. When it's
+   * `false` they can still read the chat. Asked for each connection in
+   * `onConnect`, so an override of `onConnect` must call `super`. An error
+   * counts as `false`. `true` by default.
+   */
+  canChat(_userContext: UserContext | undefined): boolean | Promise<boolean>;
+  /** Answers still being asked, by connection, so messages sent meanwhile wait for them. */
+  private _canChatAnswers;
+  /**
+   * Asks `canChat` for a connection. A no marks it readonly, which outlives
+   * hibernation and the user's token.
+   */
+  private _askCanChat;
+  /** Whether the connection can chat. Calls from the server, without one, can. */
+  protected _canChat(connection?: Connection | undefined): Promise<boolean>;
+  /** Think stores a message before any hook runs, so it's refused before Think sees it. */
+  private _refuseChatMessages;
   protected _turn: CurrentTurnState<RequestContext, UserContext>;
   protected createToolContextForCurrentTurn(requestContext?: RequestContext): ToolContext<RequestContext, UserContext>;
   protected getToolContextForCurrentTurn(): ToolContext<RequestContext, UserContext> | undefined;
@@ -13090,7 +13108,11 @@ export declare abstract class Agent<RequestContext extends Record<string, unknow
    * as a server error.
    */
   protected authenticate(request: Request): Promise<void>;
-  private _logContext;
+  protected _logContext(): {
+    agentName: string;
+    agentClass: string;
+    durableObjectName: string;
+  };
   /**
    * Self-registers this DO in the global `agent_registry`. Only top-level DOs
    * are registered — facets are enumerable via their parent's own index, so

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import * as aiSdk from "ai";
-import { Output, asSchema, convertToModelMessages, generateId, generateText, getToolName, hasToolCall, isToolUIPart, jsonSchema, pruneMessages, stepCountIs, tool as tool$1 } from "ai";
+import { AISDKError, APICallError, Output, asSchema, convertToModelMessages, generateId, generateText, getToolName, hasToolCall, isToolUIPart, jsonSchema, pruneMessages, stepCountIs, tool as tool$1 } from "ai";
 import { isPrivateOrLocalHost } from "agents/webfetch";
 import { z } from "zod";
 import { truncateResult } from "@cloudflare/codemode";
@@ -28166,7 +28166,7 @@ const symbol$16 = Symbol.for(marker$16);
 * Custom error class for AI SDK related errors.
 * @extends Error
 */
-var AISDKError = class AISDKError extends Error {
+var AISDKError$1 = class AISDKError extends Error {
 	/**
 	* Creates an AI SDK Error.
 	*
@@ -28197,7 +28197,7 @@ var AISDKError = class AISDKError extends Error {
 const name$14 = "AI_APICallError";
 const marker$14 = `vercel.ai.error.${name$14}`;
 const symbol$14 = Symbol.for(marker$14);
-var APICallError = class extends AISDKError {
+var APICallError$1 = class extends AISDKError$1 {
 	constructor({ message, url, requestBodyValues, statusCode, responseHeaders, responseBody, cause, isRetryable = statusCode != null && (statusCode === 408 || statusCode === 409 || statusCode === 429 || statusCode >= 500), data }) {
 		super({
 			name: name$14,
@@ -28214,13 +28214,13 @@ var APICallError = class extends AISDKError {
 		this.data = data;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$14);
+		return AISDKError$1.hasMarker(error, marker$14);
 	}
 };
 const name$13 = "AI_EmptyResponseBodyError";
 const marker$13 = `vercel.ai.error.${name$13}`;
 const symbol$13 = Symbol.for(marker$13);
-var EmptyResponseBodyError = class extends AISDKError {
+var EmptyResponseBodyError = class extends AISDKError$1 {
 	constructor({ message = "Empty response body" } = {}) {
 		super({
 			name: name$13,
@@ -28229,7 +28229,7 @@ var EmptyResponseBodyError = class extends AISDKError {
 		this[symbol$13] = true;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$13);
+		return AISDKError$1.hasMarker(error, marker$13);
 	}
 };
 function getErrorMessage(error) {
@@ -28244,7 +28244,7 @@ const symbol$11 = Symbol.for(marker$11);
 /**
 * A function argument is invalid.
 */
-var InvalidArgumentError = class extends AISDKError {
+var InvalidArgumentError = class extends AISDKError$1 {
 	constructor({ message, cause, argument }) {
 		super({
 			name: name$11,
@@ -28255,7 +28255,7 @@ var InvalidArgumentError = class extends AISDKError {
 		this.argument = argument;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$11);
+		return AISDKError$1.hasMarker(error, marker$11);
 	}
 };
 const name$10 = "AI_InvalidPromptError";
@@ -28265,7 +28265,7 @@ const symbol$10 = Symbol.for(marker$10);
 * A prompt is invalid. This error should be thrown by providers when they cannot
 * process a prompt.
 */
-var InvalidPromptError = class extends AISDKError {
+var InvalidPromptError = class extends AISDKError$1 {
 	constructor({ prompt, message, cause }) {
 		super({
 			name: name$10,
@@ -28276,7 +28276,7 @@ var InvalidPromptError = class extends AISDKError {
 		this.prompt = prompt;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$10);
+		return AISDKError$1.hasMarker(error, marker$10);
 	}
 };
 const name$9 = "AI_InvalidResponseDataError";
@@ -28286,7 +28286,7 @@ const symbol$9 = Symbol.for(marker$9);
 * Server returned a response with invalid data content.
 * This should be thrown by providers when they cannot parse the response from the API.
 */
-var InvalidResponseDataError = class extends AISDKError {
+var InvalidResponseDataError = class extends AISDKError$1 {
 	constructor({ data, message = `Invalid response data: ${JSON.stringify(data)}.` }) {
 		super({
 			name: name$9,
@@ -28296,13 +28296,13 @@ var InvalidResponseDataError = class extends AISDKError {
 		this.data = data;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$9);
+		return AISDKError$1.hasMarker(error, marker$9);
 	}
 };
 const name$8 = "AI_JSONParseError";
 const marker$8 = `vercel.ai.error.${name$8}`;
 const symbol$8 = Symbol.for(marker$8);
-var JSONParseError = class extends AISDKError {
+var JSONParseError = class extends AISDKError$1 {
 	constructor({ text, cause }) {
 		super({
 			name: name$8,
@@ -28313,13 +28313,13 @@ var JSONParseError = class extends AISDKError {
 		this.text = text;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$8);
+		return AISDKError$1.hasMarker(error, marker$8);
 	}
 };
 const name$7 = "AI_LoadAPIKeyError";
 const marker$7 = `vercel.ai.error.${name$7}`;
 const symbol$7 = Symbol.for(marker$7);
-var LoadAPIKeyError = class extends AISDKError {
+var LoadAPIKeyError = class extends AISDKError$1 {
 	constructor({ message }) {
 		super({
 			name: name$7,
@@ -28328,7 +28328,7 @@ var LoadAPIKeyError = class extends AISDKError {
 		this[symbol$7] = true;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$7);
+		return AISDKError$1.hasMarker(error, marker$7);
 	}
 };
 const name$3 = "AI_NoSuchProviderReferenceError";
@@ -28338,7 +28338,7 @@ const symbol$3 = Symbol.for(marker$3);
 * Thrown when a provider reference cannot be resolved because the specified
 * provider is not found in the provider reference mapping.
 */
-var NoSuchProviderReferenceError = class extends AISDKError {
+var NoSuchProviderReferenceError = class extends AISDKError$1 {
 	constructor({ provider, reference, message = `No provider reference found for provider '${provider}'. Available providers: ${Object.keys(reference).join(", ")}` }) {
 		super({
 			name: name$3,
@@ -28349,13 +28349,13 @@ var NoSuchProviderReferenceError = class extends AISDKError {
 		this.reference = reference;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$3);
+		return AISDKError$1.hasMarker(error, marker$3);
 	}
 };
 const name$2 = "AI_TooManyEmbeddingValuesForCallError";
 const marker$2$1 = `vercel.ai.error.${name$2}`;
 const symbol$2 = Symbol.for(marker$2$1);
-var TooManyEmbeddingValuesForCallError = class extends AISDKError {
+var TooManyEmbeddingValuesForCallError = class extends AISDKError$1 {
 	constructor(options) {
 		super({
 			name: name$2,
@@ -28368,13 +28368,13 @@ var TooManyEmbeddingValuesForCallError = class extends AISDKError {
 		this.values = options.values;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$2$1);
+		return AISDKError$1.hasMarker(error, marker$2$1);
 	}
 };
 const name$1$1 = "AI_TypeValidationError";
 const marker$1$1 = `vercel.ai.error.${name$1$1}`;
 const symbol$1$1 = Symbol.for(marker$1$1);
-var TypeValidationError = class TypeValidationError extends AISDKError {
+var TypeValidationError = class TypeValidationError extends AISDKError$1 {
 	constructor({ value, cause, context }) {
 		let contextPrefix = "Type validation failed";
 		if (context?.field) contextPrefix += ` for ${context.field}`;
@@ -28396,7 +28396,7 @@ var TypeValidationError = class TypeValidationError extends AISDKError {
 		this.context = context;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$1$1);
+		return AISDKError$1.hasMarker(error, marker$1$1);
 	}
 	/**
 	* Wraps an error into a TypeValidationError.
@@ -28421,7 +28421,7 @@ var TypeValidationError = class TypeValidationError extends AISDKError {
 const name$16 = "AI_UnsupportedFunctionalityError";
 const marker$17 = `vercel.ai.error.${name$16}`;
 const symbol$17 = Symbol.for(marker$17);
-var UnsupportedFunctionalityError = class extends AISDKError {
+var UnsupportedFunctionalityError = class extends AISDKError$1 {
 	constructor({ functionality, message = `'${functionality}' functionality not supported.` }) {
 		super({
 			name: name$16,
@@ -28431,7 +28431,7 @@ var UnsupportedFunctionalityError = class extends AISDKError {
 		this.functionality = functionality;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$17);
+		return AISDKError$1.hasMarker(error, marker$17);
 	}
 };
 function isJSONValue(value) {
@@ -28457,11 +28457,11 @@ function isJSONObject(value) {
 * prior behavior).
 */
 function normalizeBindingError(error, context) {
-	if (APICallError.isInstance(error) || isAbortError$1(error)) return error;
+	if (APICallError$1.isInstance(error) || isAbortError$1(error)) return error;
 	const code = parseWorkersAIErrorCode(error);
 	const statusCode = code != null ? WORKERS_AI_ERROR_CODE_TO_STATUS[code] : void 0;
 	const message = messageOf(error);
-	return new APICallError({
+	return new APICallError$1({
 		message,
 		url: `workers-ai:binding/run/${context.model}`,
 		requestBodyValues: context.requestBodyValues,
@@ -28479,7 +28479,7 @@ function normalizeBindingError(error, context) {
 * `"Workers AI API error (<status> <statusText>): <body>"` shape.
 */
 function apiCallErrorFromResponse(response, errorBody, context) {
-	return new APICallError({
+	return new APICallError$1({
 		message: `Workers AI API error (${response.status} ${response.statusText}): ${errorBody}`,
 		url: context.url,
 		requestBodyValues: context.requestBodyValues,
@@ -31347,7 +31347,7 @@ function handleFetchError({ error, url, requestBodyValues }) {
 	if (isAbortError(error)) return error;
 	if (error instanceof TypeError && FETCH_FAILED_ERROR_MESSAGES.includes(error.message.toLowerCase())) {
 		const cause = error.cause;
-		if (cause != null) return new APICallError({
+		if (cause != null) return new APICallError$1({
 			message: `Cannot connect to API: ${cause.message}`,
 			cause,
 			url,
@@ -31357,7 +31357,7 @@ function handleFetchError({ error, url, requestBodyValues }) {
 	}
 	const networkError = findNetworkError(error);
 	if (networkError != null) {
-		if (APICallError.isInstance(error)) return new APICallError({
+		if (APICallError$1.isInstance(error)) return new APICallError$1({
 			message: error.message,
 			cause: error.cause,
 			url: error.url,
@@ -31368,7 +31368,7 @@ function handleFetchError({ error, url, requestBodyValues }) {
 			data: error.data,
 			isRetryable: true
 		});
-		return new APICallError({
+		return new APICallError$1({
 			message: `Cannot connect to API: ${error instanceof Error ? error.message : networkError.message}`,
 			cause: error,
 			url,
@@ -31437,8 +31437,8 @@ const deleteFromApi = async ({ url, headers = {}, failedResponseHandler, success
 					requestBodyValues: {}
 				});
 			} catch (error) {
-				if (isAbortError(error) || APICallError.isInstance(error)) throw error;
-				throw new APICallError({
+				if (isAbortError(error) || APICallError$1.isInstance(error)) throw error;
+				throw new APICallError$1({
 					message: "Failed to process error response",
 					cause: error,
 					statusCode: response.status,
@@ -31457,9 +31457,9 @@ const deleteFromApi = async ({ url, headers = {}, failedResponseHandler, success
 			});
 		} catch (error) {
 			if (error instanceof Error) {
-				if (isAbortError(error) || APICallError.isInstance(error)) throw error;
+				if (isAbortError(error) || APICallError$1.isInstance(error)) throw error;
 			}
-			throw new APICallError({
+			throw new APICallError$1({
 				message: "Failed to process successful response",
 				cause: error,
 				statusCode: response.status,
@@ -31868,7 +31868,7 @@ async function cancelResponseBody(response) {
 const name$1 = "AI_DownloadError";
 const marker$1 = `vercel.ai.error.${name$1}`;
 const symbol$1 = Symbol.for(marker$1);
-var DownloadError = class extends AISDKError {
+var DownloadError = class extends AISDKError$1 {
 	constructor({ url, statusCode, statusText, cause, message = cause == null ? `Failed to download ${url}: ${statusCode} ${statusText}` : `Failed to download ${url}: ${cause}` }) {
 		super({
 			name: name$1,
@@ -31881,7 +31881,7 @@ var DownloadError = class extends AISDKError {
 		this.statusText = statusText;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker$1);
+		return AISDKError$1.hasMarker(error, marker$1);
 	}
 };
 /**
@@ -32499,8 +32499,8 @@ const getFromApi = async ({ url, headers = {}, successfulResponseHandler, failed
 					requestBodyValues: {}
 				});
 			} catch (error) {
-				if (isAbortError(error) || APICallError.isInstance(error)) throw error;
-				throw new APICallError({
+				if (isAbortError(error) || APICallError$1.isInstance(error)) throw error;
+				throw new APICallError$1({
 					message: "Failed to process error response",
 					cause: error,
 					statusCode: response.status,
@@ -32519,9 +32519,9 @@ const getFromApi = async ({ url, headers = {}, successfulResponseHandler, failed
 			});
 		} catch (error) {
 			if (error instanceof Error) {
-				if (isAbortError(error) || APICallError.isInstance(error)) throw error;
+				if (isAbortError(error) || APICallError$1.isInstance(error)) throw error;
 			}
-			throw new APICallError({
+			throw new APICallError$1({
 				message: "Failed to process successful response",
 				cause: error,
 				statusCode: response.status,
@@ -33867,8 +33867,8 @@ const postMultipartStreamToApi = async ({ url, headers = {}, parts, failedRespon
 					requestBodyValues
 				});
 			} catch (error) {
-				if (isAbortError(error) || APICallError.isInstance(error)) throw error;
-				throw new APICallError({
+				if (isAbortError(error) || APICallError$1.isInstance(error)) throw error;
+				throw new APICallError$1({
 					message: "Failed to process error response",
 					cause: error,
 					statusCode: response.status,
@@ -33887,9 +33887,9 @@ const postMultipartStreamToApi = async ({ url, headers = {}, parts, failedRespon
 			});
 		} catch (error) {
 			if (error instanceof Error) {
-				if (isAbortError(error) || APICallError.isInstance(error)) throw error;
+				if (isAbortError(error) || APICallError$1.isInstance(error)) throw error;
 			}
-			throw new APICallError({
+			throw new APICallError$1({
 				message: "Failed to process successful response",
 				cause: error,
 				statusCode: response.status,
@@ -33953,8 +33953,8 @@ const postToApi = async ({ url, headers = {}, body, successfulResponseHandler, f
 					requestBodyValues: body.values
 				});
 			} catch (error) {
-				if (isAbortError(error) || APICallError.isInstance(error)) throw error;
-				throw new APICallError({
+				if (isAbortError(error) || APICallError$1.isInstance(error)) throw error;
+				throw new APICallError$1({
 					message: "Failed to process error response",
 					cause: error,
 					statusCode: response.status,
@@ -33973,9 +33973,9 @@ const postToApi = async ({ url, headers = {}, body, successfulResponseHandler, f
 			});
 		} catch (error) {
 			if (error instanceof Error) {
-				if (isAbortError(error) || APICallError.isInstance(error)) throw error;
+				if (isAbortError(error) || APICallError$1.isInstance(error)) throw error;
 			}
-			throw new APICallError({
+			throw new APICallError$1({
 				message: "Failed to process successful response",
 				cause: error,
 				statusCode: response.status,
@@ -34104,7 +34104,7 @@ function wrapResponseBodyStream({ stream, url, requestBodyValues, statusCode, re
 					return;
 				}
 				controller.error(handleFetchError({
-					error: new APICallError({
+					error: new APICallError$1({
 						message: "Failed to process successful response",
 						cause: error,
 						statusCode,
@@ -34140,7 +34140,7 @@ const createJsonErrorResponseHandler = ({ errorSchema, errorToMessage, isRetryab
 	const responseHeaders = extractResponseHeaders(response);
 	if (responseBody.trim() === "") return {
 		responseHeaders,
-		value: new APICallError({
+		value: new APICallError$1({
 			message: response.statusText,
 			url,
 			requestBodyValues,
@@ -34157,7 +34157,7 @@ const createJsonErrorResponseHandler = ({ errorSchema, errorToMessage, isRetryab
 		});
 		return {
 			responseHeaders,
-			value: new APICallError({
+			value: new APICallError$1({
 				message: errorToMessage(parsedError),
 				url,
 				requestBodyValues,
@@ -34171,7 +34171,7 @@ const createJsonErrorResponseHandler = ({ errorSchema, errorToMessage, isRetryab
 	} catch {
 		return {
 			responseHeaders,
-			value: new APICallError({
+			value: new APICallError$1({
 				message: response.statusText,
 				url,
 				requestBodyValues,
@@ -34210,7 +34210,7 @@ const createJsonResponseHandler = (responseSchema) => async ({ response, url, re
 		schema: responseSchema
 	});
 	const responseHeaders = extractResponseHeaders(response);
-	if (!parsedResult.success) throw new APICallError({
+	if (!parsedResult.success) throw new APICallError$1({
 		message: "Invalid JSON response",
 		cause: parsedResult.error,
 		statusCode: response.status,
@@ -34292,7 +34292,7 @@ async function* parseJsonLines({ stream, schema, url, maxLineBytes }) {
 }
 const createBinaryResponseHandler = () => async ({ response, url, requestBodyValues }) => {
 	const responseHeaders = extractResponseHeaders(response);
-	if (!response.body) throw new APICallError({
+	if (!response.body) throw new APICallError$1({
 		message: "Response body is empty",
 		url,
 		requestBodyValues,
@@ -34307,7 +34307,7 @@ const createBinaryResponseHandler = () => async ({ response, url, requestBodyVal
 			value: new Uint8Array(buffer)
 		};
 	} catch (error) {
-		throw new APICallError({
+		throw new APICallError$1({
 			message: "Failed to read response as array buffer",
 			url,
 			requestBodyValues,
@@ -34356,7 +34356,7 @@ function isJSONSerializable(value) {
 const name = "AI_SerializationError";
 const marker = `vercel.ai.error.${name}`;
 const symbol = Symbol.for(marker);
-var SerializationError = class extends AISDKError {
+var SerializationError = class extends AISDKError$1 {
 	constructor({ message = "Failed to serialize value.", cause } = {}) {
 		super({
 			name,
@@ -34366,7 +34366,7 @@ var SerializationError = class extends AISDKError {
 		this[symbol] = true;
 	}
 	static isInstance(error) {
-		return AISDKError.hasMarker(error, marker);
+		return AISDKError$1.hasMarker(error, marker);
 	}
 };
 /**
@@ -35098,7 +35098,7 @@ async function raceWithTimeout(promise, timeoutMs) {
 }
 function createOpenAIStreamError({ frame, url, requestBodyValues, responseHeaders }) {
 	const streamError = createOpenAIProviderStreamError(frame);
-	return new APICallError({
+	return new APICallError$1({
 		message: streamError?.message ?? "OpenAI stream failed before any output was generated",
 		url,
 		requestBodyValues,
@@ -41160,7 +41160,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 			abortSignal: options.abortSignal,
 			fetch: this.config.fetch
 		});
-		if (response.error) throw new APICallError({
+		if (response.error) throw new APICallError$1({
 			message: response.error.message,
 			url,
 			requestBodyValues: body,
@@ -41171,7 +41171,7 @@ var OpenAIResponsesLanguageModel = class OpenAIResponsesLanguageModel {
 		});
 		if (response.output == null) {
 			const detail = response.incomplete_details?.reason;
-			throw new APICallError({
+			throw new APICallError$1({
 				message: detail ? `Responses API returned no output (${detail})` : "Responses API returned no output",
 				url,
 				requestBodyValues: body,
@@ -42566,7 +42566,7 @@ function isOpenAIChatCompletionChunk(value) {
 	return chunk != null && Array.isArray(chunk.choices) && typeof chunk.type !== "string";
 }
 function createOpenAIResponsesChatCompletionsMismatchError({ value, cause, url, requestBodyValues, responseHeaders }) {
-	return new APICallError({
+	return new APICallError$1({
 		message: "Received a Chat Completions stream while using the OpenAI Responses API. The default OpenAI provider model uses the Responses API. If your custom baseURL targets a Chat Completions-compatible endpoint, use openai.chat('model-id') or createOpenAI(...).chat('model-id') instead. You can also use @ai-sdk/openai-compatible for OpenAI-compatible providers.",
 		url,
 		requestBodyValues,
@@ -69941,18 +69941,38 @@ function writeOperationalLog(record, logger = console) {
 		else logger.log(message);
 	} catch {}
 }
+/**
+* What's safe to log of an error. An AI SDK error's message can quote what
+* the model was sent or returned, such as a value that failed validation, so
+* only its name is kept, and an API call's message, which is the provider's.
+*/
+function describeError(error) {
+	if (!AISDKError.isInstance(error)) return {
+		name: error.name,
+		message: error.message,
+		stack: error.stack
+	};
+	return APICallError.isInstance(error) ? {
+		name: error.name,
+		message: error.message
+	} : { name: error.name };
+}
 function errorAttributes(error) {
 	if (!(error instanceof Error)) return { error: String(error) };
+	const { name, message, stack } = describeError(error);
 	const causes = [];
 	let cause = error.cause;
 	while (cause !== void 0 && causes.length < 5) {
-		causes.push(cause instanceof Error ? `${cause.name}: ${cause.message}` : String(cause));
+		if (cause instanceof Error) {
+			const described = describeError(cause);
+			causes.push(described.message ? `${described.name}: ${described.message}` : described.name);
+		} else causes.push(String(cause));
 		cause = cause instanceof Error ? cause.cause : void 0;
 	}
 	return {
-		error: error.message,
-		errorType: error.name,
-		stack: error.stack,
+		error: message,
+		errorType: name,
+		stack,
 		...causes.length ? { causes } : {}
 	};
 }
@@ -71011,11 +71031,12 @@ var ToolApprovals = class {
 	}
 };
 // src/server/util/agent.ts
-function sendConnectionStatus(connection, status, reason) {
+function sendConnectionStatus(connection, status, reason, details) {
 	connection.send(JSON.stringify({
 		type: "connection_status",
 		status,
-		reason
+		reason,
+		...details
 	}));
 }
 function sendAgentType(connection, agentType) {
@@ -71204,6 +71225,7 @@ const THINK_SKILLS_CONTEXT_LABEL = "think_skills";
 const SESSION_CONTEXT_SEPARATOR = "═".repeat(46);
 const TOOL_CONTINUATION_PREFIX = "economic:tool-continuation:";
 const TOOL_CONTINUATION_REQUEST_PREFIX = "economic:tool-continuation-request:";
+const CHAT_REFUSED = "You can read this chat, but you can't chat in it.";
 /** Whether a tool call's output is the paused or running output of an execution. */
 function showsExecution(part, executionId) {
 	return "output" in part && part.output?.executionId === executionId;
@@ -71277,6 +71299,7 @@ var Agent = class Agent extends Think {
 		this._tracingHandlers = this.getTracingHandlers();
 		if (this.context.removeBlock(THINK_SKILLS_CONTEXT_LABEL)) await this.context.refreshSystemPrompt();
 		this._unfinishedToolCalls = await this._toolTaskSettlements.unfinishedToolCalls();
+		this._refuseChatMessages();
 		this.registerInstance();
 	}
 	/**
@@ -71336,7 +71359,57 @@ var Agent = class Agent extends Think {
 			connection.close(closeCode, message);
 			return;
 		}
-		sendConnectionStatus(connection, "connected");
+		sendConnectionStatus(connection, "connected", void 0, { canChat: await this._askCanChat(connection) });
+	}
+	/**
+	* Whether the user can send messages and answer approvals. When it's
+	* `false` they can still read the chat. Asked for each connection in
+	* `onConnect`, so an override of `onConnect` must call `super`. An error
+	* counts as `false`. `true` by default.
+	*/
+	canChat(_userContext) {
+		return true;
+	}
+	/** Answers still being asked, by connection, so messages sent meanwhile wait for them. */
+	_canChatAnswers = /* @__PURE__ */ new Map();
+	/**
+	* Asks `canChat` for a connection. A no marks it readonly, which outlives
+	* hibernation and the user's token.
+	*/
+	async _askCanChat(connection) {
+		const answer = Promise.resolve().then(() => this.canChat(this.identity.userContext())).catch((error) => {
+			logOperationalError("agent.can-chat.failed", error, this._logContext());
+			return false;
+		});
+		this._canChatAnswers.set(connection.id, answer);
+		const canChat = await answer;
+		if (!canChat) this.setConnectionReadonly(connection, true);
+		this._canChatAnswers.delete(connection.id);
+		return canChat;
+	}
+	/** Whether the connection can chat. Calls from the server, without one, can. */
+	async _canChat(connection = getCurrentAgent$1().connection) {
+		if (!connection) return true;
+		return await this._canChatAnswers.get(connection.id) ?? !this.isConnectionReadonly(connection);
+	}
+	/** Think stores a message before any hook runs, so it's refused before Think sees it. */
+	_refuseChatMessages() {
+		const onMessage = this.onMessage.bind(this);
+		this.onMessage = async (connection, message) => {
+			const event = typeof message === "string" ? parseProtocolMessage(message) : null;
+			if (!((event?.type === "chat-request" || event?.type === "tool-approval" || event?.type === "tool-result" && event.autoContinue === true) && !this._cf_connectionTargetsSubAgent(connection) && !await this._canChat(connection))) return onMessage(connection, message);
+			connection.send(JSON.stringify({
+				type: CHAT_MESSAGE_TYPES.CHAT_MESSAGES,
+				messages: this.messages
+			}));
+			if (event.type === "chat-request") connection.send(JSON.stringify({
+				type: CHAT_MESSAGE_TYPES.USE_CHAT_RESPONSE,
+				id: event.id,
+				body: CHAT_REFUSED,
+				done: true,
+				error: true
+			}));
+		};
 	}
 	_turn = {
 		inputTools: {},
@@ -71518,11 +71591,13 @@ var Agent = class Agent extends Think {
 	}
 	/** `all` also approves the tool call's later approvals, so it doesn't stop again. */
 	async approveExecution(executionId, options) {
+		if (!await this._canChat()) throw new Error(CHAT_REFUSED);
 		const answer = await this._toolApprovals.answer(executionId, true, { all: options?.all });
 		if (answer) return answer;
 		return super.approveExecution(executionId);
 	}
 	async rejectExecution(executionId, reason, options) {
+		if (!await this._canChat()) throw new Error(CHAT_REFUSED);
 		const answer = await this._toolApprovals.answer(executionId, false, { autoContinue: options?.autoContinue });
 		if (answer) return answer;
 		return super.rejectExecution(executionId, reason, options);
@@ -72072,7 +72147,10 @@ var Agent = class Agent extends Think {
 			for (const source of sources) try {
 				for (const descriptor of await source.list()) if (!byName.has(descriptor.name)) byName.set(descriptor.name, source);
 			} catch (error) {
-				console.warn(`[Agent] Failed to resolve skill source "${source.id}"`, error);
+				logOperationalError("agent.skills.source.failed", error, {
+					...this._logContext(),
+					attributes: { skillSource: source.id }
+				});
 				break;
 			}
 			return byName;
@@ -72352,7 +72430,7 @@ function ensureChatsTableExists(sql) {
 		ensureChatsTitleSetByUserColumnExists(sql);
 		ensureChatMessageFeedbackTableExists(sql);
 	} catch (error) {
-		console.error("[Agent] Failed to create chats table", error);
+		logOperationalError("agent.chats.table.failed", error);
 	}
 }
 function ensureChatsFeedbackColumnsExist(sql) {
@@ -72446,8 +72524,12 @@ function chatSummaryInput(messages) {
 		recentMessages: messages.slice(-20)
 	};
 }
-async function summariseChatWithAI(sql, durableObjectName, { completedTurns, recentMessages }, model) {
+async function summariseChatWithAI(sql, durableObjectName, { completedTurns, recentMessages }, model, logContext = {}) {
 	const chat = getChat(sql, durableObjectName);
+	const failureContext = {
+		...logContext,
+		attributes: { chatName: durableObjectName }
+	};
 	if (!(!chat || !chat.title || isChatSummaryDue(completedTurns))) return;
 	let systemPrompt = `
     You are a helpful assistant that summarises chats.
@@ -72480,7 +72562,7 @@ async function summariseChatWithAI(sql, durableObjectName, { completedTurns, rec
 			}) })
 		});
 		if (!title || !summary) {
-			console.error("[Assistant] Failed to generate chat title and summary", { durableObjectName });
+			logOperationalError("assistant.chat.summary.failed", /* @__PURE__ */ new Error("The model gave no title or summary."), failureContext);
 			return;
 		}
 		sql`UPDATE chats
@@ -72490,10 +72572,7 @@ async function summariseChatWithAI(sql, durableObjectName, { completedTurns, rec
       WHERE durable_object_name = ${durableObjectName}`;
 		console.info("[Assistant] Generated chat summary", { durableObjectName });
 	} catch (error) {
-		console.error("[Assistant] Failed to generate chat title and summary", {
-			durableObjectName,
-			error
-		});
+		logOperationalError("assistant.chat.summary.failed", error, failureContext);
 	}
 }
 const DELETE_CHAT_CALLBACK = "deleteChatCallback";
@@ -72778,7 +72857,7 @@ var Assistant = class extends Agent$1 {
 	async recordChatTurn(durableObjectName, summaryInput) {
 		touchChat(this.sql.bind(this), durableObjectName);
 		this.keepAliveWhile(async () => {
-			await Promise.all([summaryInput && summariseChatWithAI(this.sql.bind(this), durableObjectName, summaryInput, this.fastModel), this.scheduleChatForAutoDeletion(durableObjectName).catch((error) => {
+			await Promise.all([summaryInput && summariseChatWithAI(this.sql.bind(this), durableObjectName, summaryInput, this.fastModel, this._logContext()), this.scheduleChatForAutoDeletion(durableObjectName).catch((error) => {
 				logOperationalError("assistant.chat.reschedule.failed", error, {
 					agentName: this.constructor.name,
 					agentClass: this.constructor.name,
@@ -72878,9 +72957,9 @@ var Assistant = class extends Agent$1 {
 				negativeFeedbackCount: chat.negative_feedback_count
 			});
 		} catch (error) {
-			console.error("[Assistant] Failed to sync chat to agent_chats", {
-				durableObjectName,
-				error
+			logOperationalError("assistant.chat.sync.failed", error, {
+				...this._logContext(),
+				attributes: { chatName: durableObjectName }
 			});
 		}
 	}
@@ -72888,9 +72967,9 @@ var Assistant = class extends Agent$1 {
 		try {
 			await deleteGlobalChat(this.env.AGENTS_DB, this.constructor.name, this.name, durableObjectName);
 		} catch (error) {
-			console.error("[Assistant] Failed to delete chat from agent_chats", {
-				durableObjectName,
-				error
+			logOperationalError("assistant.chat.unlist.failed", error, {
+				...this._logContext(),
+				attributes: { chatName: durableObjectName }
 			});
 		}
 	}
@@ -73154,7 +73233,7 @@ function ensureFeedbackTableExists(sql) {
         PRIMARY KEY (message_id)
       )`;
 	} catch (error) {
-		console.error("[Agent] Failed to create feedback table", error);
+		logOperationalError("agent.feedback.table.failed", error);
 	}
 }
 const MESSAGE_FEEDBACK_COMMENT_LIMIT = 2e3;
@@ -73185,7 +73264,7 @@ function submitMessageFeedback(sql, messageId, rating, comment, now = /* @__PURE
           comment = excluded.comment,
         updated_at = excluded.updated_at`;
 	} catch (error) {
-		console.error("[Agent] Failed to submit message feedback", error);
+		logOperationalError("agent.feedback.submit.failed", error, { attributes: { messageId } });
 	}
 }
 function clearMessageFeedback(sql) {
@@ -73432,7 +73511,7 @@ var ChatAgent = class extends Agent {
 				};
 			}
 		} catch (error) {
-			console.error("[ChatAgent] Failed to prepare model-only compaction", error);
+			logOperationalError("agent.compaction.failed", error, this._logContext());
 		}
 		return config;
 	}
@@ -73499,6 +73578,10 @@ var ChatAgent = class extends Agent {
 	* The answer is the reply's text, or its JSON with `outputSchema`.
 	*/
 	async run(input, body) {
+		if (!await this._canChat()) return {
+			status: "error",
+			error: CHAT_REFUSED
+		};
 		const { inputSchema = z.string() } = await this.getAgentConfig(this.createToolContextForCurrentTurn(body));
 		const check = checkInputValue(inputSchema, input);
 		if (!check.success) return {
@@ -73580,9 +73663,7 @@ var ChatAgent = class extends Agent {
 			await parent.recordChatFeedback(this.name, messageId, rating);
 		} catch (error) {
 			logOperationalError("agent.feedback.summary.failed", error, {
-				agentName: this.getTelemetryAgentName(),
-				agentClass: this.constructor.name,
-				durableObjectName: this.name,
+				...this._logContext(),
 				attributes: { messageId }
 			});
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@economic/agents",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "description": "A starter for creating a TypeScript package.",
   "license": "MIT",
   "files": [