@gradio/client 2.5.0 → 2.6.0

package/dist/types.d.ts

@@ -281,11 +281,11 @@ export interface ClientOptions {
      */
     oauth_token?: string;
     /**
-     * Whether to save each call's inputs and outputs in this browser's local
-     * storage, so they can be reviewed on the app's run history page. Defaults
-     * to true, and only ever applies in a browser: in Node there is no storage
-     * to write to and nothing is recorded. The app can turn it off for everyone
-     * with `run_history=False` on `launch()`, which takes precedence over this.
+     * Whether to save each call's inputs and outputs to the history destination
+     * selected in this browser (local storage by default, or a connected bucket).
+     * Defaults to true, and only ever applies in a browser: in Node there is no
+     * selected destination and nothing is recorded. The app can turn it off for
+     * everyone with `run_history=False` on `launch()`, which takes precedence.
      */
     record_history?: boolean;
 }

package/dist/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,wBAAsB,MAAM,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAsCrC;AAED,wBAAsB,aAAa,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAYrB;AAED,qBAAa,QAAQ;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,IAAI;;MAAgC;gBAEjC,EACX,IAAI,EACJ,GAAG,EACH,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,GAAG,EACH,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,IAAI,CAAC;QACZ,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;KACb;CAWD"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,wBAAsB,MAAM,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CA0CrC;AAED,wBAAsB,aAAa,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAYrB;AAED,qBAAa,QAAQ;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,IAAI;;MAAgC;gBAEjC,EACX,IAAI,EACJ,GAAG,EACH,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,GAAG,EACH,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,IAAI,CAAC;QACZ,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;KACb;CAWD"}

package/dist/utils/bucket_sync.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Client for the durable run history in an HF Hub bucket
+ * (`/gradio_api/run-history/*`).
+ *
+ * Read-only by design. Records are written by the server from the run it
+ * actually executed — there is no push function here, and nothing in this
+ * module can create a record.
+ *
+ * Every call names the bucket it is talking about. The server holds no
+ * per-session binding, so two tabs (or two apps on one origin) cannot end up
+ * reading each other's history.
+ */
+export declare function is_valid_bucket_id(id: string): boolean;
+/** Mirrors `HistoryRecord` in `gradio/history.py`. */
+export interface HistoryRecord {
+    record_id: string;
+    endpoint: string;
+    inputs: unknown;
+    outputs: unknown;
+    started_at: string;
+    schema_version: number;
+}
+export interface HistoryResult<T> {
+    ok: boolean;
+    status: number;
+    data: T;
+    detail?: string;
+}
+/**
+ * Create the bucket if it does not exist and confirm it is writable. Stores
+ * nothing server-side — the caller keeps its own choice and names it on every
+ * later request.
+ */
+export declare function connect_bucket(root: string, bucket_id: string): Promise<HistoryResult<null>>;
+export declare function list_user_buckets(root: string): Promise<HistoryResult<string[]>>;
+export declare function list_bucket_records(root: string, bucket: string): Promise<HistoryResult<HistoryRecord[]>>;
+export declare function asset_url(root: string, bucket: string, endpoint: string, record_id: string, filename: string): string;
+//# sourceMappingURL=bucket_sync.d.ts.map

package/dist/utils/bucket_sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket_sync.d.ts","sourceRoot":"","sources":["../../src/utils/bucket_sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAuDD;;;;GAIG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAmB9B;AAED,wBAAsB,iBAAiB,CACtC,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAIlC;AAED,wBAAsB,mBAAmB,CACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC,CAAC,CAIzC;AAED,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACd,MAAM,CAQR"}

package/dist/utils/run_history.d.ts

@@ -9,6 +9,13 @@ export interface RunHistoryScope {
     /** The authenticated user, when the app uses `auth`. */
     username?: string | null;
 }
+export type RunHistoryStorage = {
+    type: "browser";
+    bucket_id?: string;
+} | {
+    type: "bucket";
+    bucket_id: string;
+};
 export type RunStatus = "running" | "completed" | "failed";
 export interface StoredRunComponent {
     type: string;
@@ -51,11 +58,39 @@ interface StartRunOptions extends RunHistoryScope {
  * slash, so it cannot simply be concatenated with the path.
  */
 export declare function run_history_url(root: string, api_prefix?: string): string;
+/**
+ * The parts of an app config a replayed run writes back into. Kept structural
+ * so every entry point — the SPA and the SSR app each carry their own `Config`
+ * declaration — can hand its config straight over.
+ */
+export interface ReplayTarget {
+    components: {
+        id: number;
+        type: string;
+        props: Record<string, any>;
+    }[];
+    dependencies: {
+        id: number;
+        api_name?: string | null;
+        inputs: number[];
+        outputs: number[];
+    }[];
+}
 export declare function read_run_history(scope: RunHistoryScope | null | undefined): StoredRun[];
+export declare function read_run_history_storage(scope: RunHistoryScope | null | undefined): RunHistoryStorage;
+export declare function set_run_history_storage(scope: RunHistoryScope | null | undefined, storage: RunHistoryStorage): void;
 export declare function clear_run_history(scope: RunHistoryScope | null | undefined): void;
 export declare function delete_run_history(scope: RunHistoryScope | null | undefined, id: string): void;
 export declare function stage_run_history_replay(scope: RunHistoryScope | null | undefined, run: StoredRun): void;
 export declare function consume_run_history_replay(scope: RunHistoryScope | null | undefined): StoredRun | null;
+/**
+ * Applies the run staged by the history page, if this page load is the one it
+ * was staged for. Every entry point that renders an app has to call this, or
+ * "Load run" silently does nothing on that entry point.
+ *
+ * @returns whether a staged run was found and applied.
+ */
+export declare function apply_run_history_replay(config: ReplayTarget & RunHistoryScope): boolean;
 export declare function start_run_history(options: StartRunOptions): string | null;
 export declare function update_run_inputs(scope: RunHistoryScope | null | undefined, id: string | null, inputs: unknown): void;
 export declare function update_run_history(scope: RunHistoryScope | null | undefined, id: string | null, event: GradioEvent): void;

package/dist/utils/run_history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run_history.d.ts","sourceRoot":"","sources":["../../src/utils/run_history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,UAAU,CAAC;AAgB3D,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAgBD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,gBAAgB,CAAC,EAAE,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAAC;IACjD,iBAAiB,CAAC,EAAE,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAAC;IAClD,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,eAAgB,SAAQ,eAAe;IAChD,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAAC;IACjD,iBAAiB,CAAC,EAAE,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,SAAgB,GACxB,MAAM,CAER;AAkXD,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACvC,SAAS,EAAE,CAEb;AAED,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACvC,IAAI,CAEN;AAED,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACzC,EAAE,EAAE,MAAM,GACR,IAAI,CAEN;AAED,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACzC,GAAG,EAAE,SAAS,GACZ,IAAI,CAEN;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACvC,SAAS,GAAG,IAAI,CAElB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAEzE;AAED,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACzC,EAAE,EAAE,MAAM,GAAG,IAAI,EACjB,MAAM,EAAE,OAAO,GACb,IAAI,CAEN;AAED,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EACzC,EAAE,EAAE,MAAM,GAAG,IAAI,EACjB,KAAK,EAAE,WAAW,GAChB,IAAI,CAEN;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKtE"}
+{"version":3,"file":"run_history.d.ts","sourceRoot":"","sources":["../../src/utils/run_history.ts"],"names":[],"mappings":"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"}

package/dist/utils/submit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/utils/submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,WAAW,EAMX,cAAc,EACd,MAAM,UAAU,CAAC;AAoBlB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAOnC,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,IAAI,GAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAC9C,UAAU,CAAC,EAAE,OAAO,EACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAC1B,UAAU,CAAC,EAAE,OAAO,EACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,cAAc,CAAC,WAAW,CAAC,CA8uB7B"}
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/utils/submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,WAAW,EAMX,cAAc,EACd,MAAM,UAAU,CAAC;AAoBlB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAQnC,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,IAAI,GAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAC9C,UAAU,CAAC,EAAE,OAAO,EACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAC1B,UAAU,CAAC,EAAE,OAAO,EACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,cAAc,CAAC,WAAW,CAAC,CAsvB7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradio/client",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "Gradio API client",
   "type": "module",
   "main": "dist/index.cjs",

package/src/helpers/init_helpers.ts

@@ -83,10 +83,22 @@ export function map_names_to_ids(
 
 export function resolve_config_root(
 	root: string,
-	current_location: string
+	current_location: string,
+	prioritize_current_location = false
 ): string {
-	const root_url = new URL(root, current_location);
 	const current_url = new URL(current_location);
+	const root_url = new URL(root, current_url);
+	// Modern Colab configs can omit is_colab even though the backend root still
+	// uses one of Colab's internal-only hostname families.
+	const is_colab_runtime =
+		root_url.hostname.endsWith(".colab-user-runtimes.internal") ||
+		root_url.hostname.endsWith(".codatalab-user-runtimes.internal");
+	if (prioritize_current_location || is_colab_runtime) {
+		return new URL(new URL(root, current_url).pathname, current_url)
+			.toString()
+			.replace(/\/$/, "");
+	}
+
 	if (root_url.hostname !== current_url.hostname) {
 		return root;
 	}
@@ -138,9 +150,14 @@ export async function resolve_config(
 		// The page was rendered by this Gradio server, so a same-host root may
 		// contain an internal protocol or port supplied by a reverse proxy. Keep
 		// the configured path, but use the browser-visible origin for requests
-		// made by the client itself (queue, upload, reset, etc.).
+		// made by the client itself (queue, upload, reset, etc.). Colab's public
+		// proxy uses a different hostname, so always prefer the browser origin.
 		const config = { ...window.gradio_config } as unknown as Config;
-		config.root = resolve_config_root(config.root, location.href);
+		config.root = resolve_config_root(
+			config.root,
+			location.href,
+			config.is_colab
+		);
 		return config;
 	} else if (endpoint) {
 		let config_url = join_urls(

package/src/index.ts

@@ -6,17 +6,31 @@ export { upload_files } from "./utils/upload_files";
 export { FileData, upload, prepare_files } from "./upload";
 export { handle_file } from "./helpers/data";
 export {
+	apply_run_history_replay,
 	clear_run_history,
 	consume_run_history_replay,
 	delete_run_history,
 	on_run_history_change,
 	read_run_history,
+	read_run_history_storage,
 	run_history_url,
+	set_run_history_storage,
 	stage_run_history_replay,
+	type ReplayTarget,
+	type RunHistoryStorage,
 	type RunHistoryScope,
 	type StoredRunComponent,
 	type StoredRun
 } from "./utils/run_history";
+export {
+	asset_url,
+	connect_bucket,
+	is_valid_bucket_id,
+	list_bucket_records,
+	list_user_buckets,
+	type HistoryRecord,
+	type HistoryResult
+} from "./utils/bucket_sync";
 
 export type {
 	SpaceStatus,

package/src/test/bucket_sync.test.ts

@@ -0,0 +1,138 @@
+import { describe, it, expect, vi, afterEach } from "vitest";
+import {
+	asset_url,
+	connect_bucket,
+	is_valid_bucket_id,
+	list_bucket_records,
+	list_user_buckets
+} from "../utils/bucket_sync";
+
+describe("is_valid_bucket_id", () => {
+	it("accepts user/name form", () => {
+		expect(is_valid_bucket_id("alice/my-history")).toBe(true);
+	});
+
+	it("rejects missing slash", () => {
+		expect(is_valid_bucket_id("alice")).toBe(false);
+	});
+
+	it("rejects path traversal", () => {
+		expect(is_valid_bucket_id("alice/..")).toBe(false);
+		expect(is_valid_bucket_id("../etc")).toBe(false);
+		expect(is_valid_bucket_id("alice/./x")).toBe(false);
+	});
+
+	it("rejects empty segments", () => {
+		expect(is_valid_bucket_id("alice/")).toBe(false);
+		expect(is_valid_bucket_id("/name")).toBe(false);
+	});
+});
+
+describe("list_bucket_records", () => {
+	const orig = globalThis.fetch;
+	afterEach(() => {
+		globalThis.fetch = orig;
+	});
+
+	it("reports a failed request instead of an empty history", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: false,
+			status: 401,
+			json: async () => ({ detail: "oauth session required" })
+		}) as any;
+		const res = await list_bucket_records("http://x", "alice/h");
+		expect(res.ok).toBe(false);
+		expect(res.status).toBe(401);
+		expect(res.data).toEqual([]);
+	});
+
+	it("returns records on success", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ records: [{ record_id: "r1" }] })
+		}) as any;
+		const res = await list_bucket_records("http://x", "alice/h");
+		expect(res.ok).toBe(true);
+		expect(res.data).toHaveLength(1);
+	});
+
+	it("names the bucket on every request rather than relying on session state", async () => {
+		const spy = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ records: [] })
+		});
+		globalThis.fetch = spy as any;
+		await list_bucket_records("http://x", "alice/my-history");
+		const called = String(spy.mock.calls[0][0]);
+		expect(called).toContain("bucket=alice%2Fmy-history");
+		expect(called).not.toContain("endpoint=");
+		expect(called).not.toContain("limit=");
+	});
+
+	it("does not emit a root-absolute URL when root is empty", async () => {
+		const spy = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ records: [] })
+		});
+		globalThis.fetch = spy as any;
+		await list_bucket_records("", "alice/h");
+		const called = String(spy.mock.calls[0][0]);
+		// must resolve against the document base, not "/gradio_api/..."
+		expect(called.startsWith("/gradio_api/")).toBe(false);
+		expect(called).toContain("gradio_api/run-history/records");
+	});
+});
+
+describe("bucket setup", () => {
+	const orig = globalThis.fetch;
+	afterEach(() => {
+		globalThis.fetch = orig;
+	});
+
+	it("ignores the connect response body", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ ok: true })
+		}) as any;
+		const result = await connect_bucket("http://x", "alice/history");
+		expect(result).toMatchObject({ ok: true, data: null });
+	});
+
+	it("returns bucket ids as strings", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ buckets: ["alice/one", "alice/two"] })
+		}) as any;
+		expect(await list_user_buckets("http://x")).toMatchObject({
+			ok: true,
+			data: ["alice/one", "alice/two"]
+		});
+	});
+
+	it("preserves authentication errors for the connect UI", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: false,
+			status: 401,
+			json: async () => ({ detail: "oauth session required" })
+		}) as any;
+		expect(await list_user_buckets("http://x")).toMatchObject({
+			ok: false,
+			status: 401,
+			data: [],
+			detail: "oauth session required"
+		});
+	});
+});
+
+describe("asset_url", () => {
+	it("addresses an asset by bucket, endpoint and record", () => {
+		const url = asset_url("http://x", "alice/h", "predict", "r1", "a001.png");
+		expect(url).toContain("/run-history/records/predict/r1/assets/a001.png");
+		expect(url).toContain("bucket=alice%2Fh");
+	});
+});

package/src/test/run_history.test.ts

@@ -1,12 +1,15 @@
 import { afterEach, describe, expect, test, vi } from "vitest";
 
 import {
+	apply_run_history_replay,
 	clear_run_history,
 	consume_run_history_replay,
 	delete_run_history,
 	on_run_history_change,
 	read_run_history,
+	read_run_history_storage,
 	run_history_url,
+	set_run_history_storage,
 	stage_run_history_replay,
 	start_run_history,
 	update_run_history,
@@ -24,6 +27,8 @@ const replacement_apps = Array.from(
 const in_browser = typeof window !== "undefined";
 
 afterEach(() => {
+	set_run_history_storage(scope, { type: "browser" });
+	set_run_history_storage(other_scope, { type: "browser" });
 	clear_run_history(scope);
 	clear_run_history(other_scope);
 	for (const replacement_app of replacement_apps) {
@@ -33,6 +38,48 @@ afterEach(() => {
 });
 
 describe.skipIf(!in_browser)("run history", () => {
+	test("uses this browser as the default history storage", () => {
+		expect(read_run_history_storage(scope)).toEqual({ type: "browser" });
+	});
+
+	test("remembers a bucket while switching storage destinations", () => {
+		set_run_history_storage(scope, {
+			type: "bucket",
+			bucket_id: "alice/app-history"
+		});
+		expect(read_run_history_storage(scope)).toEqual({
+			type: "bucket",
+			bucket_id: "alice/app-history"
+		});
+
+		set_run_history_storage(scope, {
+			type: "browser",
+			bucket_id: "alice/app-history"
+		});
+		expect(read_run_history_storage(scope)).toEqual({
+			type: "browser",
+			bucket_id: "alice/app-history"
+		});
+	});
+
+	test("does not duplicate bucket runs in local storage", () => {
+		set_run_history_storage(scope, {
+			type: "bucket",
+			bucket_id: "alice/app-history"
+		});
+
+		const id = start_run_history({
+			app_id,
+			endpoint: "/predict",
+			api_name: "/predict",
+			fn_index: 0,
+			inputs: ["hello"]
+		});
+
+		expect(id).toBeNull();
+		expect(read_run_history(scope)).toEqual([]);
+	});
+
 	test("stores runs per app id with the page and inputs", () => {
 		const id = start_run_history({
 			app_id,
@@ -314,6 +361,72 @@ describe.skipIf(!in_browser)("run history", () => {
 	});
 });
 
+describe.skipIf(!in_browser)("replaying a run", () => {
+	function make_config() {
+		return {
+			app_id,
+			components: [
+				{ id: 1, type: "textbox", props: { value: "default in" } },
+				{ id: 2, type: "state", props: { value: "server side" } },
+				{ id: 3, type: "image", props: { value: null } },
+				{ id: 4, type: "textbox", props: { value: "default out" } }
+			],
+			dependencies: [
+				{ id: 7, api_name: "transform", inputs: [1, 2], outputs: [3, 4] }
+			]
+		};
+	}
+
+	const stored = {
+		id: "run-1",
+		endpoint: "/transform",
+		api_name: "/transform",
+		fn_index: 7,
+		page: "/",
+		inputs: ["prompt", null],
+		outputs: [{ url: "http://localhost/image.webp" }, "described"],
+		status: "completed" as const,
+		started_at: new Date().toISOString()
+	};
+
+	test("writes the saved inputs and outputs back into the config", () => {
+		stage_run_history_replay(scope, stored);
+		const config = make_config();
+
+		expect(apply_run_history_replay(config)).toBe(true);
+		expect(config.components.map((component) => component.props.value)).toEqual(
+			["prompt", "server side", stored.outputs[0], "described"]
+		);
+		expect(apply_run_history_replay(make_config())).toBe(false);
+	});
+
+	test("matches the endpoint by api name when the fn index has moved", () => {
+		stage_run_history_replay(scope, { ...stored, fn_index: 99 });
+		const config = make_config();
+
+		expect(apply_run_history_replay(config)).toBe(true);
+		expect(config.components[3].props.value).toBe("described");
+	});
+
+	test("leaves the config alone when the endpoint is gone", () => {
+		stage_run_history_replay(scope, {
+			...stored,
+			fn_index: 99,
+			api_name: "/removed"
+		});
+		const config = make_config();
+
+		expect(apply_run_history_replay(config)).toBe(false);
+		expect(config.components.map((component) => component.props.value)).toEqual(
+			["default in", "server side", null, "default out"]
+		);
+	});
+
+	test("is a no-op when nothing was staged", () => {
+		expect(apply_run_history_replay(make_config())).toBe(false);
+	});
+});
+
 describe("run history url", () => {
 	test("joins the app root and the api prefix", () => {
 		expect(run_history_url("http://localhost:7860")).toBe(

package/src/test/submit.test.ts

@@ -1,6 +1,9 @@
 import { describe, beforeAll, afterEach, afterAll, test, expect } from "vitest";
+import { HttpResponse, http } from "msw";
 
 import { Client } from "../client";
+import { set_run_history_storage } from "../utils/run_history";
+import { direct_space_url } from "./handlers";
 import { initialise_server } from "./server";
 
 let server: Awaited<ReturnType<typeof initialise_server>>;
@@ -9,7 +12,12 @@ beforeAll(async () => {
 	server = await initialise_server();
 	await server.start({ quiet: true });
 });
-afterEach(() => server.resetHandlers());
+afterEach(() => {
+	server.resetHandlers();
+	if (typeof window !== "undefined") {
+		set_run_history_storage({ app_id: 123 }, { type: "browser" });
+	}
+});
 afterAll(() => server.stop());
 
 async function race_with_timeout<T>(
@@ -29,6 +37,35 @@ async function race_with_timeout<T>(
 }
 
 describe("submit iterator", () => {
+	test.skipIf(typeof window === "undefined")(
+		"sends the selected history bucket with queued submissions",
+		async () => {
+			const app = await Client.connect("hmb/hello_world");
+			const scope = {
+				app_id: app.config?.app_id,
+				username: app.config?.username
+			};
+			set_run_history_storage(scope, {
+				type: "bucket",
+				bucket_id: "alice/app-history"
+			});
+
+			let header: string | null = null;
+			server.resetHandlers(
+				http.post(`${direct_space_url}/queue/join`, ({ request }) => {
+					header = request.headers.get("x-gradio-history-bucket");
+					return HttpResponse.json({ event_id: "bucket-event" });
+				})
+			);
+
+			const iterator = app.submit("/predict", ["hi"]);
+			await expect(iterator.wait_for_id()).resolves.toBe("bucket-event");
+			expect(header).toBe("alice/app-history");
+			await iterator.return();
+			set_run_history_storage(scope, { type: "browser" });
+		}
+	);
+
 	test("next() after the iterator is closed resolves to {done: true}", async () => {
 		const app = await Client.connect("hmb/hello_world");
 		// Avoid opening a real SSE stream — the test does not need one.

package/src/test/upload.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, it, vi } from "vitest";
+
+import type { Client } from "../client";
+import { FileData, upload } from "../upload";
+
+describe("upload", () => {
+	it("encodes uploaded file paths in file URLs", async () => {
+		const path = "/tmp/computer%20vision#Huggy.png";
+		const client = {
+			api_prefix: "/gradio_api",
+			upload_files: vi.fn().mockResolvedValue({ files: [path] })
+		} as unknown as Client;
+		const input = new FileData({
+			path,
+			blob: new File([], "computer%20vision#Huggy.png")
+		});
+
+		const result = await upload.call(client, [input], "https://example.com");
+
+		expect(result?.[0]).toMatchObject({
+			path,
+			url: "https://example.com/gradio_api/file=/tmp/computer%2520vision%23Huggy.png"
+		});
+	});
+});

package/src/types.ts

@@ -354,11 +354,11 @@ export interface ClientOptions {
 	 */
 	oauth_token?: string;
 	/**
-	 * Whether to save each call's inputs and outputs in this browser's local
-	 * storage, so they can be reviewed on the app's run history page. Defaults
-	 * to true, and only ever applies in a browser: in Node there is no storage
-	 * to write to and nothing is recorded. The app can turn it off for everyone
-	 * with `run_history=False` on `launch()`, which takes precedence over this.
+	 * Whether to save each call's inputs and outputs to the history destination
+	 * selected in this browser (local storage by default, or a connected bucket).
+	 * Defaults to true, and only ever applies in a browser: in Node there is no
+	 * selected destination and nothing is recorded. The app can turn it off for
+	 * everyone with `run_history=False` on `launch()`, which takes precedence.
 	 */
 	record_history?: boolean;
 }

package/src/upload.ts

@@ -30,10 +30,14 @@ export async function upload(
 				} else {
 					if (response.files) {
 						return response.files.map((f, i) => {
+							const encoded_path = f
+								.split("/")
+								.map((segment) => encodeURIComponent(segment))
+								.join("/");
 							const file = new FileData({
 								...file_data[i],
 								path: f,
-								url: `${root_url}${this.api_prefix}/file=${f}`
+								url: `${root_url}${this.api_prefix}/file=${encoded_path}`
 							});
 							return file;
 						});