gemi 0.123.0 → 0.125.0

package/dist/ai/AgentController.d.ts

@@ -12,7 +12,7 @@ import { defaultNonceStore, MemoryNonceStore, type NonceRedisClient, type NonceS
 import { MemoryReceiptStore, type ReceiptClaim, type ReceiptRedisClient, type ReceiptStore, RedisReceiptStore, type RedisReceiptStoreOptions } from "./store/Receipts";
 import { defaultAgentStore, MemoryAgentStore } from "./store/MemoryAgentStore";
 import type { ErrorRedactionInfo } from "./redact";
-import type { AgentError, AgentMessage, PendingToolCall, ToolShapes } from "./types";
+import type { AgentError, AgentMessage, ClientTurn, PendingToolCall, ToolShapes } from "./types";
 /**
  * Where conversations live.
  *
@@ -138,10 +138,92 @@ export { MemoryReceiptStore, type ReceiptClaim, type ReceiptRedisClient, type Re
 /** Where answered calls' nonces are spent (#445). See `store/Nonces.ts`. */
 export { defaultNonceStore, MemoryNonceStore, type NonceRedisClient, type NonceStore, RedisNonceStore, type RedisNonceStoreOptions, };
 export type AgentHookContext = {
+    /**
+     * The request that started the turn. Its `state` is the turn's own typed
+     * state (#887): a value set in `authorizeRequest()`, `instructions()` or
+     * `context()` (`req.state.set(key, value)`) is read here with
+     * `ctx.req.state.get(key)`, instead of a `WeakMap` keyed on the request.
+     * A request answering an approval is a new turn and starts with none.
+     */
     req: HttpRequest<any, any>;
     runId: string;
     threadId?: string;
 };
+/**
+ * What `AgentController.startTurn` takes (#839).
+ */
+export type AgentTurnParams<Body extends object = Record<string, unknown>> = {
+    /** The thread the turn is stored on, as a turn from `useChat` would be. */
+    threadId: string;
+    /** The user's message. Shorthand for `turn: { text }`, and wins over `turn.text`. */
+    text?: string;
+    /**
+     * The whole turn, for files or answers: `{ text, files, toolResults }`, as
+     * `useChat` sends it. Neither `text` nor `turn` is a turn with nothing in
+     * it, which lets the model continue the thread.
+     */
+    turn?: ClientTurn;
+    /**
+     * Who the turn runs as: `req.ctx().user` for `authorizeRequest`, `runOwner`,
+     * `context()`, the hooks and every tool, as the authentication middleware
+     * would have set it. Absent or `null` is an anonymous turn.
+     */
+    user?: unknown;
+    /** What `useChat`'s `body` option would send: `instructions()`, `context()` and `ctx.body` read it. */
+    body?: Body;
+};
+/** A turn `AgentController.startTurn` started. */
+export type AgentTurn = {
+    runId: string;
+    threadId: string;
+    /** The run: iterate it (or its `frames()`) to follow the turn as it goes. */
+    run: AgentRun;
+    /** What the chat's stop button does. */
+    stop(params?: {
+        reason?: string;
+    }): void;
+    /**
+     * Settles when the run has ended, its transcript is stored and the
+     * controller's hooks have run (or `hookHoldMs` has passed). Rejects only if
+     * the run itself does; a failed model call resolves with `finishReason:
+     * "error"` and `error`, as `AgentRun.result()` does.
+     */
+    result(): Promise<AgentTurnResult>;
+};
+/** What `AgentTurn.result()` answers: the run's result, and what a caller reads off it. */
+export type AgentTurnResult = AgentRunResult<ToolShapes, unknown> & {
+    threadId: string;
+    /** The text of the run's last assistant message; `""` when it wrote none. */
+    text: string;
+    /**
+     * The calls waiting for an answer when `finishReason` is
+     * `"awaiting-input"`, and `[]` otherwise. They stay on the thread, signed
+     * for the turn's `runOwner`: that user can answer them in the chat, or the
+     * caller can with another `startTurn({ turn: { toolResults } })`.
+     */
+    pending: PendingToolCall[];
+};
+/**
+ * A turn `startTurn` could not start: what the route would have answered,
+ * thrown. `status` and `code` are the route's (`404` `thread_not_found`,
+ * `429` `too_many_runs`, `403` for another owner's run or file...).
+ */
+export declare class AgentTurnError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly kind?: string;
+    constructor(message: string, params: {
+        status: number;
+        code?: string;
+        kind?: string;
+    });
+    /** @internal Reads a refusal `stream` answered. */
+    static from(response: Response): Promise<AgentTurnError>;
+}
+/** `Body` of a controller instance type, as `AgentRouteRPC` reads it. */
+type ControllerBody<C> = C extends {
+    [BODY]?: infer B;
+} ? B extends object ? B : Record<string, unknown> : Record<string, unknown>;
 /** What `AgentController.attachmentLimits` answers. Both optional. */
 export type AttachmentLimits = {
     /** The largest file accepted, in bytes. */
@@ -149,6 +231,36 @@ export type AttachmentLimits = {
     /** `<input accept>` entries: `".pdf"`, `"image/*"`, `"text/csv"`. */
     accept?: string[];
 };
+/** The file `AgentController.checkUpload` is asked about: what it is, not its bytes. */
+export type UploadCheckFile = {
+    /** The file's name as the client sent it, `"upload"` when it sent none. */
+    name: string;
+    /** In bytes. */
+    size: number;
+    /** As the client sent it, `"application/octet-stream"` when it sent none. */
+    mimeType: string;
+};
+/**
+ * What an upload hook is told beyond the request (#836): the client's `body`
+ * option (what `attachmentScope` gets) and the thread the upload is for, when
+ * the store knows it.
+ */
+export type UploadContext<Body extends object = Record<string, unknown>> = {
+    body: Body;
+    /** Only a thread the store found; an id it has never seen is left out. */
+    threadId?: string;
+};
+/**
+ * What `AgentController.checkUpload` returns to refuse a file. Answered **422**
+ * with `{ error: { code, message } }`, which `useChat().attach()` rejects with
+ * as an `AttachError` carrying the same `code` and `message`.
+ */
+export type UploadRefusal = {
+    /** A code the composer can switch on. `"upload_refused"` when left out. */
+    code?: string;
+    /** The sentence the person reads. */
+    message: string;
+};
 /**
  * What `POST /<path>/files` answers.
  *
@@ -628,6 +740,35 @@ Body extends object = Record<string, unknown>> extends ControllerBase {
      * turn that asks and the turn that answers.
      */
     protected runOwner(req: HttpRequest<any, any>): string | null | Promise<string | null>;
+    /**
+     * STARTS A TURN FROM SERVER CODE (#839): a queue job, a command, an MCP
+     * tool, a webhook. No browser and no route: the turn goes through this
+     * controller's `stream` as a `useChat` turn would, on a request built here,
+     * so the agent, the store, `authorizeRequest` and `resource`, `runOwner`,
+     * `maxConcurrentRuns`, the thread's lock, `instructions()`, `context()`,
+     * the hooks and the tools' `ctx` (`threadId`, `ctx.jobs`, `ctx.generate`)
+     * are the same as for a turn from the chat.
+     *
+     * ```ts
+     * const turn = await ChatController.startTurn({
+     *   threadId,
+     *   text: "Make the hero darker",
+     *   user,                 // req.ctx().user for the turn
+     *   body: { siteId },     // what useChat's `body` option would send
+     * });
+     * const { text, finishReason, pending } = await turn.result();
+     * ```
+     *
+     * The route's middleware does not run: the caller is server code and names
+     * the user itself (`null` or absent is an anonymous turn). A turn the route
+     * would refuse throws an `AgentTurnError` with the status and code it would
+     * have answered; a request breaker thrown by `authorizeRequest` is thrown
+     * as it is.
+     *
+     * The run lives in the process that called this, like every run. From a
+     * queue job, await `result()` so the worker does not move on without it.
+     */
+    static startTurn<C extends AgentController<any, any>>(this: new () => C, params: AgentTurnParams<ControllerBody<C>>): Promise<AgentTurn>;
     /**
      * `POST /<path>` — one route for every client turn. A first message, an
      * approval, an answer to a question and a client tool's result are all just
@@ -836,9 +977,50 @@ Body extends object = Record<string, unknown>> extends ControllerBase {
      *   }
      */
     protected attachmentLimits(req: HttpRequest<any, any>): AttachmentLimits | null | Promise<AttachmentLimits | null>;
+    /**
+     * THE APP'S OWN RULE ABOUT ONE UPLOAD (#836): a storage quota, a per-subject
+     * cap, anything that needs the file and the request's subject at once.
+     * Called once per upload, after `authorizeRequest` and `attachmentLimits` and
+     * before anything is stored or sent to the provider.
+     *
+     * It is told what the file is (`name`, `size`, `mimeType`) and what the
+     * upload is about: `body`, the client's `body` option exactly as
+     * `attachmentScope` gets it, and `threadId` when the store knows the thread.
+     * Return nothing to let the file through, or an `UploadRefusal` to refuse it:
+     * the route answers **422** with `{ error: { code, message } }` (`code`
+     * defaults to `"upload_refused"`), and `useChat().attach()` rejects with an
+     * `AttachError` carrying both, as it does for `attachmentLimits`' refusals.
+     * A `RequestBreakerError` thrown here is answered as itself; anything else
+     * thrown is a 500.
+     *
+     *   protected async checkUpload(file, req, { body }) {
+     *     if (typeof body.pageId !== "string") return;
+     *     const page = await Page.findFirst({ where: { publicId: body.pageId } });
+     *     if (!page) return;
+     *     const used = await storageUsedBy(page);
+     *     if (used + file.size > capFor(page)) {
+     *       return { code: "storage_full", message: "This site's storage is full." };
+     *     }
+     *   }
+     *
+     * The `body` rule from `attachmentScope` applies here too: it types the
+     * shape, not the contents, so check a field before looking it up, and
+     * decide whose quota to charge from what the lookup returned.
+     *
+     * Here rather than in `attachmentDestination`, which also sees the file: a
+     * quota is a rule about the file and its subject, not about where the bytes
+     * go, and a throw there is a 500 unless the app builds the response itself.
+     *
+     * A check here is not a reservation: two uploads checked at the same moment
+     * both see the old usage. A cap that must never be exceeded by one file is
+     * enforced where usage is recorded.
+     */
+    protected checkUpload(file: UploadCheckFile, req: HttpRequest<any, any>, ctx: UploadContext<Body>): UploadRefusal | null | void | Promise<UploadRefusal | null | void>;
     /**
      * WHERE ONE FILE'S BYTES SHOULD GO. Called once per upload, with the file in
-     * hand.
+     * hand, and since #836 with the same `{ body, threadId }` that `checkUpload`
+     * gets as a third argument. An override written as
+     * `attachmentDestination(file, req)` works unchanged.
      *
      * The model needs to perceive a file only for vision or document reading; a
      * tool needs the bytes only to forward them. Those are different needs and
@@ -870,7 +1052,7 @@ Body extends object = Record<string, unknown>> extends ControllerBase {
      * anything else, including `"provider"`, which would let a form field decide
      * that the app does not keep its own copy. See `narrowDestination`.
      */
-    protected attachmentDestination(file: File, req: HttpRequest<any, any>): AttachmentDestination | Promise<AttachmentDestination>;
+    protected attachmentDestination(file: File, req: HttpRequest<any, any>, extra?: UploadContext<Body>): AttachmentDestination | Promise<AttachmentDestination>;
     /**
      * The attachment handle for this request — the object a tool is given.
      *

package/dist/ai/AgentController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentController.d.ts","sourceRoot":"","sources":["../../ai/AgentController.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentController.d.ts","sourceRoot":"","sources":["../../ai/AgentController.ts"],"names":[],"mappings":"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"}

package/dist/ai/client/index.d.ts

@@ -19,6 +19,6 @@
  * for `applyFrame` is reimplementing the hook.
  */
 export { AttachError, useChat } from "../useChat";
-export type { AgentAttachBody, AttachOptions, AgentRequestBody, AgentStopBody, ChatStatus, UseChatParams, UseChatResult, } from "../useChat";
+export type { AgentAttachBody, AttachOptions, AgentRequestBody, AgentStopBody, ChatStatus, SendMessageOptions, UseChatParams, UseChatResult, } from "../useChat";
 export type { AgentContentPart, AgentError, AgentJobRef, AgentErrorCode, AgentMessage, AgentStreamEvent, AgentStreamFrame, ClientToolResult, ClientTurn, FilePart, FinishReason, NestedRun, OutputPart, PendingToolCall, ReasoningPart, TextPart, ToolCallPart, ToolProgress, ToolResultPart, ToolShape, ToolShapes, Usage, } from "../types";
 //# sourceMappingURL=index.d.ts.map

package/dist/ai/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../ai/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAMpB,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,YAAY,EAGZ,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,QAAQ,EACR,YAAY,EAKZ,YAAY,EACZ,cAAc,EACd,SAAS,EACT,UAAU,EACV,KAAK,GACN,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../ai/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAMpB,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,YAAY,EAGZ,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,QAAQ,EACR,YAAY,EAKZ,YAAY,EACZ,cAAc,EACd,SAAS,EACT,UAAU,EACV,KAAK,GACN,MAAM,UAAU,CAAC"}

package/dist/ai/client/index.js

@@ -145,8 +145,17 @@ function reduce(state, event, now) {
 					messages: [...state.messages, event.message]
 				};
 			}
-			const messages = state.messages.some((message) => message.id === event.messageId) ? state.messages.filter((_, i) => i !== index) : state.messages.map((message, i) => i === index ? {
+			const local = state.messages[index];
+			const kept = {
+				localId: local.localId ?? local.id,
+				...local.metadata ? { metadata: local.metadata } : {}
+			};
+			const messages = state.messages.some((message) => message.id === event.messageId) ? state.messages.filter((_, i) => i !== index).map((message) => message.id === event.messageId ? {
+				...message,
+				...kept
+			} : message) : state.messages.map((message, i) => i === index ? {
 				...message,
+				...kept,
 				id: event.messageId
 			} : message);
 			return {
@@ -597,7 +606,8 @@ async function* decodeSSE(stream) {
 *
 * `code` is the server's when it sent one — `unsupported_file_type`,
 * `file_too_large`, `file_rejected` and `invalid_request` from
-* `AgentController.upload`, or a framework refusal's `kind` such as
+* `AgentController.upload`, the app's own from `checkUpload` (`upload_refused`
+* when it gave none), or a framework refusal's `kind` such as
 * `authentication` — and otherwise `upload_failed` (an answer that was
 * not JSON, `status` says which) or `network_error` (no answer at all). A
 * string rather than a union, because an app's own `attachmentDestination`
@@ -752,7 +762,8 @@ function turnFrom(message) {
 	};
 }
 /**
-* The transcript as the server needs it, without the progress logs.
+* The transcript as the server needs it, without the progress logs or the
+* client-only `localId` and `metadata`.
 *
 * In stateless mode `send` posts the whole history on *every* turn, so anything
 * that accumulates on a message is paid for again on each one. `progress` is
@@ -768,7 +779,9 @@ function turnFrom(message) {
 * shapes the request body only, so a UI still renders every yield it received.
 */
 function forWire(messages) {
-	return messages.map((message) => {
+	return messages.map((full) => {
+		const { localId: _localId, metadata: _metadata, ...stripped } = full;
+		const message = full.localId !== void 0 || full.metadata !== void 0 ? stripped : full;
 		if (!message.content.some((part) => part.type === "tool-call" && (part.progress || part.nested))) return message;
 		return {
 			...message,
@@ -966,7 +979,11 @@ function useChat(path, params = {}) {
 		}
 	}, [commit, setPhaseSafe]);
 	const send = useCallback(async (turn, options = {}) => {
-		const { base: url, extraBody: body } = requestRef.current;
+		const { base: url, extraBody } = requestRef.current;
+		const body = options.body ? {
+			...extraBody,
+			...options.body
+		} : extraBody;
 		const superseded = abortRef.current;
 		superseded?.controller.abort();
 		const clientRunId = localId();
@@ -988,6 +1005,7 @@ function useChat(path, params = {}) {
 		const ownId = turn.localId || localId();
 		const authored = turn.text || turn.files?.length ? [{
 			id: ownId,
+			localId: ownId,
 			role: "user",
 			content: [...turn.text ? [{
 				type: "text",
@@ -996,7 +1014,8 @@ function useChat(path, params = {}) {
 				type: "file",
 				...file
 			}))],
-			createdAt: (/* @__PURE__ */ new Date()).toISOString()
+			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+			...options.metadata ? { metadata: options.metadata } : {}
 		}] : [];
 		commit({
 			...previous,
@@ -1043,7 +1062,10 @@ function useChat(path, params = {}) {
 		postStop,
 		setPhaseSafe
 	]);
-	const sendMessage = useCallback((turn) => send(typeof turn === "string" ? { text: turn } : turn), [send]);
+	const sendMessage = useCallback((turn, options = {}) => send(typeof turn === "string" ? { text: turn } : turn, {
+		...options.body ? { body: options.body } : {},
+		...options.metadata ? { metadata: options.metadata } : {}
+	}), [send]);
 	/**
 	* Answers queued within one tick become one turn.
 	*
@@ -1158,14 +1180,21 @@ function useChat(path, params = {}) {
 			break;
 		}
 		if (userIndex === -1) return;
-		const turn = turnFrom(messages[userIndex]);
+		const question = messages[userIndex];
+		const turn = {
+			...turnFrom(question),
+			...question.localId ? { localId: question.localId } : {}
+		};
 		commit({
 			...stateRef.current,
 			messages: messages.slice(0, userIndex),
 			pending: [],
 			error: null
 		});
-		await send(turn, { regenerate: true });
+		await send(turn, {
+			regenerate: true,
+			...question.metadata ? { metadata: question.metadata } : {}
+		});
 	}, [commit, send]);
 	const setMessages = useCallback((messages) => {
 		commit({