@gradio/client 2.5.1 → 2.6.0

package/dist/helpers/init_helpers.d.ts

@@ -21,7 +21,7 @@ export declare function get_jwt(space: string, token: `hf_${string}`, cookies?:
  */
 export declare function normalise_token_option(options: ClientOptions): void;
 export declare function map_names_to_ids(fns: Config["dependencies"]): Record<string, number>;
-export declare function resolve_config_root(root: string, current_location: string): string;
+export declare function resolve_config_root(root: string, current_location: string, prioritize_current_location?: boolean): string;
 export declare function resolve_config(this: Client, endpoint: string, strip_current_page?: boolean): Promise<Config | undefined>;
 export declare function resolve_cookies(this: Client): Promise<void>;
 export declare function get_cookie_header(http_protocol: string, host: string, auth: [string, string], _fetch: typeof fetch, token?: `hf_${string}`, credentials?: RequestCredentials): Promise<string | null>;

package/dist/helpers/init_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init_helpers.d.ts","sourceRoot":"","sources":["../../src/helpers/init_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAWtD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAG5B;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,OAAO,GACtB,MAAM,CAKR;AAED,wBAAsB,OAAO,CAC5B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAezB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAOnE;AAED,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,GACzB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,GACtB,MAAM,CAUR;AAED,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,kBAAkB,UAAO,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA+D7B;AAsCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBjE;AAGD,wBAAsB,iBAAiB,CACtC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACtB,MAAM,EAAE,OAAO,KAAK,EACpB,KAAK,CAAC,EAAE,MAAM,MAAM,EAAE,EACtB,WAAW,CAAC,EAAE,kBAAkB,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyBxB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACrD,WAAW,EAAE,IAAI,GAAG,KAAK,CAAC;IAC1B,aAAa,EAAE,OAAO,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACb,CAkBA;AAED,eAAO,MAAM,qBAAqB,GAAI,eAAe,MAAM,KAAG,MAAM,EAUnE,CAAC"}
+{"version":3,"file":"init_helpers.d.ts","sourceRoot":"","sources":["../../src/helpers/init_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAWtD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAG5B;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,OAAO,GACtB,MAAM,CAKR;AAED,wBAAsB,OAAO,CAC5B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAezB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAOnE;AAED,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,GACzB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,2BAA2B,UAAQ,GACjC,MAAM,CAqBR;AAED,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,kBAAkB,UAAO,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoE7B;AAsCD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBjE;AAGD,wBAAsB,iBAAiB,CACtC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACtB,MAAM,EAAE,OAAO,KAAK,EACpB,KAAK,CAAC,EAAE,MAAM,MAAM,EAAE,EACtB,WAAW,CAAC,EAAE,kBAAkB,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyBxB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACrD,WAAW,EAAE,IAAI,GAAG,KAAK,CAAC;IAC1B,aAAa,EAAE,OAAO,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACb,CAkBA;AAED,eAAO,MAAM,qBAAqB,GAAI,eAAe,MAAM,KAAG,MAAM,EAUnE,CAAC"}

package/dist/index.cjs

@@ -63,9 +63,11 @@ function map_names_to_ids(fns) {
 	});
 	return apis;
 }
-function resolve_config_root(root, current_location) {
-	const root_url = new URL(root, current_location);
+function resolve_config_root(root, current_location, prioritize_current_location = false) {
 	const current_url = new URL(current_location);
+	const root_url = new URL(root, current_url);
+	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;
 	root_url.protocol = current_url.protocol;
 	root_url.host = current_url.host;
@@ -88,7 +90,7 @@ async function resolve_config(endpoint, strip_current_page = true) {
 			};
 		}
 		const config = { ...window.gradio_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(endpoint, this.deep_link ? CONFIG_URL + "?deep_link=" + this.deep_link : CONFIG_URL);
@@ -610,10 +612,11 @@ async function upload(file_data, root_url, upload_id, max_file_size) {
 		if (response.error) throw new Error(response.error);
 		else {
 			if (response.files) return response.files.map((f, i) => {
+				const encoded_path = f.split("/").map((segment) => encodeURIComponent(segment)).join("/");
 				return 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 [];
@@ -1433,6 +1436,7 @@ function readable_stream(input, init = {}) {
 var KEY_ROOT = "gradio:run-history:";
 var STORAGE_PREFIX = `${KEY_ROOT}v2:`;
 var REPLAY_PREFIX = `${KEY_ROOT}replay:v2:`;
+var DESTINATION_PREFIX = `${KEY_ROOT}destination:v1:`;
 var MAX_RUNS = 100;
 var MAX_APPS = 8;
 /**
@@ -1470,6 +1474,34 @@ function replay_key(scope) {
 	const key = storage_key(scope);
 	return key ? key.replace(STORAGE_PREFIX, REPLAY_PREFIX) : null;
 }
+function destination_key(scope) {
+	const key = storage_key(scope);
+	return key ? key.replace(STORAGE_PREFIX, DESTINATION_PREFIX) : null;
+}
+function read_run_history_storage_impl(scope) {
+	const key = destination_key(scope);
+	if (!key) return { type: "browser" };
+	try {
+		const value = JSON.parse(window.localStorage.getItem(key) || "null");
+		if (typeof value?.bucket_id === "string") return value.type === "bucket" ? {
+			type: "bucket",
+			bucket_id: value.bucket_id
+		} : {
+			type: "browser",
+			bucket_id: value.bucket_id
+		};
+		return { type: "browser" };
+	} catch {
+		return { type: "browser" };
+	}
+}
+function set_run_history_storage_impl(scope, storage) {
+	const key = destination_key(scope);
+	if (!key) return;
+	if (storage.type === "browser" && !storage.bucket_id) window.localStorage.removeItem(key);
+	else window.localStorage.setItem(key, JSON.stringify(storage));
+	notify_run_history_change();
+}
 /** When a run was most recently saved under a key, for deciding what to drop. */
 function last_saved_at(key) {
 	try {
@@ -1486,7 +1518,7 @@ function last_saved_at(key) {
 */
 function prune_apps(current_key) {
 	const keys = Object.keys(window.localStorage).filter((key) => key.startsWith(KEY_ROOT));
-	const stale = [...keys.filter((key) => !key.startsWith(STORAGE_PREFIX) && !key.startsWith(REPLAY_PREFIX)), ...keys.filter((key) => key.startsWith(STORAGE_PREFIX) && key !== current_key).sort((a, b) => last_saved_at(b) - last_saved_at(a)).slice(MAX_APPS - 1)];
+	const stale = [...keys.filter((key) => !key.startsWith(STORAGE_PREFIX) && !key.startsWith(REPLAY_PREFIX) && !key.startsWith(DESTINATION_PREFIX)), ...keys.filter((key) => key.startsWith(STORAGE_PREFIX) && key !== current_key).sort((a, b) => last_saved_at(b) - last_saved_at(a)).slice(MAX_APPS - 1)];
 	for (const key of stale) try {
 		window.localStorage.removeItem(key);
 		window.sessionStorage.removeItem(key.replace(STORAGE_PREFIX, REPLAY_PREFIX));
@@ -1616,6 +1648,7 @@ function apply_run_history_replay_impl(config) {
 	return run ? restore_run_impl(config, run) : false;
 }
 function start_run_history_impl(options) {
+	if (read_run_history_storage_impl(options).type === "bucket") return null;
 	const key = storage_key(options);
 	if (!key) return null;
 	prune_apps(key);
@@ -1695,6 +1728,12 @@ function mark_complete(run, event) {
 function read_run_history(scope) {
 	return safely(() => read_run_history_impl(scope), []);
 }
+function read_run_history_storage(scope) {
+	return safely(() => read_run_history_storage_impl(scope), { type: "browser" });
+}
+function set_run_history_storage(scope, storage) {
+	safely(() => set_run_history_storage_impl(scope, storage), void 0);
+}
 function clear_run_history(scope) {
 	safely(() => clear_run_history_impl(scope), void 0);
 }
@@ -1735,7 +1774,7 @@ function submit(endpoint, data = {}, event_data, trigger_id, all_events, additio
 	try {
 		const { token } = this.options;
 		const { fetch, app_reference, config, session_hash, api_info, api_map, stream_status, pending_stream_messages, pending_diff_streams, event_callbacks, unclosed_events, post_data, options, api_prefix } = this;
-		const addt_headers = additional_headers || { "x-gradio-user": "api" };
+		const base_headers = additional_headers || { "x-gradio-user": "api" };
 		const that = this;
 		if (!api_info) throw new Error(NO_API_INFO_MSG);
 		if (!config) throw new Error("Could not resolve app config");
@@ -1760,6 +1799,11 @@ function submit(endpoint, data = {}, event_data, trigger_id, all_events, additio
 			app_id: config.app_id,
 			username: config.username
 		};
+		const history_storage = read_run_history_storage(history_scope);
+		const addt_headers = {
+			...base_headers,
+			...history_enabled && history_storage.type === "bucket" ? { "x-gradio-history-bucket": history_storage.bucket_id } : {}
+		};
 		const history_run_id = !history_enabled || !is_documented_endpoint ? null : start_run_history({
 			...history_scope,
 			endpoint: history_endpoint,
@@ -1933,7 +1977,7 @@ function submit(endpoint, data = {}, event_data, trigger_id, all_events, additio
 							...payload,
 							session_hash,
 							event_id
-						});
+						}, addt_headers);
 						if (status !== 200) {
 							fire_event({
 								type: "status",
@@ -2595,21 +2639,115 @@ async function duplicate_space(app_reference, options) {
 	return await Client.duplicate(app_reference, options);
 }
 //#endregion
+//#region src/utils/bucket_sync.ts
+/**
+* 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.
+*/
+var BUCKET_ID_RE = /^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-][a-zA-Z0-9_./-]*$/;
+function is_valid_bucket_id(id) {
+	if (!BUCKET_ID_RE.test(id)) return false;
+	return !id.split("/").some((seg) => seg === "" || seg === "." || seg === "..");
+}
+function url(root, path, params) {
+	const query = params ? `?${new URLSearchParams(params)}` : "";
+	const base = root.replace(/\/+$/, "");
+	if (base) return `${base}/gradio_api/run-history/${path}${query}`;
+	if (typeof document !== "undefined" && document.baseURI) return new URL(`gradio_api/run-history/${path}${query}`, document.baseURI).toString();
+	return `gradio_api/run-history/${path}${query}`;
+}
+async function parse_error(res) {
+	try {
+		const j = await res.json();
+		return typeof j?.detail === "string" ? j.detail : `${res.status}`;
+	} catch {
+		return `${res.status}`;
+	}
+}
+async function request(input, init, fallback, pick) {
+	try {
+		const res = await fetch(input, {
+			credentials: "include",
+			...init
+		});
+		if (!res.ok) return {
+			ok: false,
+			status: res.status,
+			data: fallback,
+			detail: await parse_error(res)
+		};
+		return {
+			ok: true,
+			status: res.status,
+			data: pick(await res.json())
+		};
+	} catch (e) {
+		return {
+			ok: false,
+			status: 0,
+			data: fallback,
+			detail: String(e)
+		};
+	}
+}
+/**
+* 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.
+*/
+async function connect_bucket(root, bucket_id) {
+	if (!is_valid_bucket_id(bucket_id)) return {
+		ok: false,
+		status: 422,
+		data: null,
+		detail: "invalid bucket id"
+	};
+	return request(url(root, "connect"), {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({ bucket_id })
+	}, null, () => null);
+}
+async function list_user_buckets(root) {
+	return request(url(root, "buckets"), {}, [], (b) => Array.isArray(b?.buckets) ? b.buckets : []);
+}
+async function list_bucket_records(root, bucket) {
+	return request(url(root, "records", { bucket }), {}, [], (b) => Array.isArray(b?.records) ? b.records : []);
+}
+function asset_url(root, bucket, endpoint, record_id, filename) {
+	return url(root, `records/${encodeURIComponent(endpoint)}/${encodeURIComponent(record_id)}/assets/${encodeURIComponent(filename)}`, { bucket });
+}
+//#endregion
 exports.Client = Client;
 exports.FileData = FileData;
 exports.MISSING_CREDENTIALS_MSG = MISSING_CREDENTIALS_MSG;
 exports.apply_run_history_replay = apply_run_history_replay;
+exports.asset_url = asset_url;
 exports.clear_run_history = clear_run_history;
 exports.client = client;
+exports.connect_bucket = connect_bucket;
 exports.consume_run_history_replay = consume_run_history_replay;
 exports.delete_run_history = delete_run_history;
 exports.duplicate = duplicate_space;
 exports.handle_file = handle_file;
+exports.is_valid_bucket_id = is_valid_bucket_id;
+exports.list_bucket_records = list_bucket_records;
+exports.list_user_buckets = list_user_buckets;
 exports.on_run_history_change = on_run_history_change;
 exports.predict = predict;
 exports.prepare_files = prepare_files;
 exports.read_run_history = read_run_history;
+exports.read_run_history_storage = read_run_history_storage;
 exports.run_history_url = run_history_url;
+exports.set_run_history_storage = set_run_history_storage;
 exports.stage_run_history_replay = stage_run_history_replay;
 exports.submit = submit;
 exports.upload = upload;

package/dist/index.d.ts

@@ -4,7 +4,8 @@ export { submit } from "./utils/submit";
 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, run_history_url, stage_run_history_replay, type ReplayTarget, type RunHistoryScope, type StoredRunComponent, type StoredRun } from "./utils/run_history";
+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, StatusMessage, Status, client_return, UploadResponse, RenderMessage, LogMessage, Payload, Config, ValidationError } from "./types";
 export { MISSING_CREDENTIALS_MSG } from "./constants";
 export { client } from "./client";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACN,wBAAwB,EACxB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACX,WAAW,EACX,aAAa,EACb,MAAM,EACN,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,OAAO,EACP,MAAM,EACN,eAAe,EACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,eAAe,IAAI,SAAS,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACN,wBAAwB,EACxB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACX,WAAW,EACX,aAAa,EACb,MAAM,EACN,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,OAAO,EACP,MAAM,EACN,eAAe,EACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,eAAe,IAAI,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -62,9 +62,11 @@ function map_names_to_ids(fns) {
 	});
 	return apis;
 }
-function resolve_config_root(root, current_location) {
-	const root_url = new URL(root, current_location);
+function resolve_config_root(root, current_location, prioritize_current_location = false) {
 	const current_url = new URL(current_location);
+	const root_url = new URL(root, current_url);
+	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;
 	root_url.protocol = current_url.protocol;
 	root_url.host = current_url.host;
@@ -87,7 +89,7 @@ async function resolve_config(endpoint, strip_current_page = true) {
 			};
 		}
 		const config = { ...window.gradio_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(endpoint, this.deep_link ? CONFIG_URL + "?deep_link=" + this.deep_link : CONFIG_URL);
@@ -609,10 +611,11 @@ async function upload(file_data, root_url, upload_id, max_file_size) {
 		if (response.error) throw new Error(response.error);
 		else {
 			if (response.files) return response.files.map((f, i) => {
+				const encoded_path = f.split("/").map((segment) => encodeURIComponent(segment)).join("/");
 				return 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 [];
@@ -1432,6 +1435,7 @@ function readable_stream(input, init = {}) {
 var KEY_ROOT = "gradio:run-history:";
 var STORAGE_PREFIX = `${KEY_ROOT}v2:`;
 var REPLAY_PREFIX = `${KEY_ROOT}replay:v2:`;
+var DESTINATION_PREFIX = `${KEY_ROOT}destination:v1:`;
 var MAX_RUNS = 100;
 var MAX_APPS = 8;
 /**
@@ -1469,6 +1473,34 @@ function replay_key(scope) {
 	const key = storage_key(scope);
 	return key ? key.replace(STORAGE_PREFIX, REPLAY_PREFIX) : null;
 }
+function destination_key(scope) {
+	const key = storage_key(scope);
+	return key ? key.replace(STORAGE_PREFIX, DESTINATION_PREFIX) : null;
+}
+function read_run_history_storage_impl(scope) {
+	const key = destination_key(scope);
+	if (!key) return { type: "browser" };
+	try {
+		const value = JSON.parse(window.localStorage.getItem(key) || "null");
+		if (typeof value?.bucket_id === "string") return value.type === "bucket" ? {
+			type: "bucket",
+			bucket_id: value.bucket_id
+		} : {
+			type: "browser",
+			bucket_id: value.bucket_id
+		};
+		return { type: "browser" };
+	} catch {
+		return { type: "browser" };
+	}
+}
+function set_run_history_storage_impl(scope, storage) {
+	const key = destination_key(scope);
+	if (!key) return;
+	if (storage.type === "browser" && !storage.bucket_id) window.localStorage.removeItem(key);
+	else window.localStorage.setItem(key, JSON.stringify(storage));
+	notify_run_history_change();
+}
 /** When a run was most recently saved under a key, for deciding what to drop. */
 function last_saved_at(key) {
 	try {
@@ -1485,7 +1517,7 @@ function last_saved_at(key) {
 */
 function prune_apps(current_key) {
 	const keys = Object.keys(window.localStorage).filter((key) => key.startsWith(KEY_ROOT));
-	const stale = [...keys.filter((key) => !key.startsWith(STORAGE_PREFIX) && !key.startsWith(REPLAY_PREFIX)), ...keys.filter((key) => key.startsWith(STORAGE_PREFIX) && key !== current_key).sort((a, b) => last_saved_at(b) - last_saved_at(a)).slice(MAX_APPS - 1)];
+	const stale = [...keys.filter((key) => !key.startsWith(STORAGE_PREFIX) && !key.startsWith(REPLAY_PREFIX) && !key.startsWith(DESTINATION_PREFIX)), ...keys.filter((key) => key.startsWith(STORAGE_PREFIX) && key !== current_key).sort((a, b) => last_saved_at(b) - last_saved_at(a)).slice(MAX_APPS - 1)];
 	for (const key of stale) try {
 		window.localStorage.removeItem(key);
 		window.sessionStorage.removeItem(key.replace(STORAGE_PREFIX, REPLAY_PREFIX));
@@ -1615,6 +1647,7 @@ function apply_run_history_replay_impl(config) {
 	return run ? restore_run_impl(config, run) : false;
 }
 function start_run_history_impl(options) {
+	if (read_run_history_storage_impl(options).type === "bucket") return null;
 	const key = storage_key(options);
 	if (!key) return null;
 	prune_apps(key);
@@ -1694,6 +1727,12 @@ function mark_complete(run, event) {
 function read_run_history(scope) {
 	return safely(() => read_run_history_impl(scope), []);
 }
+function read_run_history_storage(scope) {
+	return safely(() => read_run_history_storage_impl(scope), { type: "browser" });
+}
+function set_run_history_storage(scope, storage) {
+	safely(() => set_run_history_storage_impl(scope, storage), void 0);
+}
 function clear_run_history(scope) {
 	safely(() => clear_run_history_impl(scope), void 0);
 }
@@ -1734,7 +1773,7 @@ function submit(endpoint, data = {}, event_data, trigger_id, all_events, additio
 	try {
 		const { token } = this.options;
 		const { fetch, app_reference, config, session_hash, api_info, api_map, stream_status, pending_stream_messages, pending_diff_streams, event_callbacks, unclosed_events, post_data, options, api_prefix } = this;
-		const addt_headers = additional_headers || { "x-gradio-user": "api" };
+		const base_headers = additional_headers || { "x-gradio-user": "api" };
 		const that = this;
 		if (!api_info) throw new Error(NO_API_INFO_MSG);
 		if (!config) throw new Error("Could not resolve app config");
@@ -1759,6 +1798,11 @@ function submit(endpoint, data = {}, event_data, trigger_id, all_events, additio
 			app_id: config.app_id,
 			username: config.username
 		};
+		const history_storage = read_run_history_storage(history_scope);
+		const addt_headers = {
+			...base_headers,
+			...history_enabled && history_storage.type === "bucket" ? { "x-gradio-history-bucket": history_storage.bucket_id } : {}
+		};
 		const history_run_id = !history_enabled || !is_documented_endpoint ? null : start_run_history({
 			...history_scope,
 			endpoint: history_endpoint,
@@ -1932,7 +1976,7 @@ function submit(endpoint, data = {}, event_data, trigger_id, all_events, additio
 							...payload,
 							session_hash,
 							event_id
-						});
+						}, addt_headers);
 						if (status !== 200) {
 							fire_event({
 								type: "status",
@@ -2594,4 +2638,91 @@ async function duplicate_space(app_reference, options) {
 	return await Client.duplicate(app_reference, options);
 }
 //#endregion
-export { Client, FileData, MISSING_CREDENTIALS_MSG, apply_run_history_replay, clear_run_history, client, consume_run_history_replay, delete_run_history, duplicate_space as duplicate, handle_file, on_run_history_change, predict, prepare_files, read_run_history, run_history_url, stage_run_history_replay, submit, upload, upload_files };
+//#region src/utils/bucket_sync.ts
+/**
+* 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.
+*/
+var BUCKET_ID_RE = /^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-][a-zA-Z0-9_./-]*$/;
+function is_valid_bucket_id(id) {
+	if (!BUCKET_ID_RE.test(id)) return false;
+	return !id.split("/").some((seg) => seg === "" || seg === "." || seg === "..");
+}
+function url(root, path, params) {
+	const query = params ? `?${new URLSearchParams(params)}` : "";
+	const base = root.replace(/\/+$/, "");
+	if (base) return `${base}/gradio_api/run-history/${path}${query}`;
+	if (typeof document !== "undefined" && document.baseURI) return new URL(`gradio_api/run-history/${path}${query}`, document.baseURI).toString();
+	return `gradio_api/run-history/${path}${query}`;
+}
+async function parse_error(res) {
+	try {
+		const j = await res.json();
+		return typeof j?.detail === "string" ? j.detail : `${res.status}`;
+	} catch {
+		return `${res.status}`;
+	}
+}
+async function request(input, init, fallback, pick) {
+	try {
+		const res = await fetch(input, {
+			credentials: "include",
+			...init
+		});
+		if (!res.ok) return {
+			ok: false,
+			status: res.status,
+			data: fallback,
+			detail: await parse_error(res)
+		};
+		return {
+			ok: true,
+			status: res.status,
+			data: pick(await res.json())
+		};
+	} catch (e) {
+		return {
+			ok: false,
+			status: 0,
+			data: fallback,
+			detail: String(e)
+		};
+	}
+}
+/**
+* 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.
+*/
+async function connect_bucket(root, bucket_id) {
+	if (!is_valid_bucket_id(bucket_id)) return {
+		ok: false,
+		status: 422,
+		data: null,
+		detail: "invalid bucket id"
+	};
+	return request(url(root, "connect"), {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({ bucket_id })
+	}, null, () => null);
+}
+async function list_user_buckets(root) {
+	return request(url(root, "buckets"), {}, [], (b) => Array.isArray(b?.buckets) ? b.buckets : []);
+}
+async function list_bucket_records(root, bucket) {
+	return request(url(root, "records", { bucket }), {}, [], (b) => Array.isArray(b?.records) ? b.records : []);
+}
+function asset_url(root, bucket, endpoint, record_id, filename) {
+	return url(root, `records/${encodeURIComponent(endpoint)}/${encodeURIComponent(record_id)}/assets/${encodeURIComponent(filename)}`, { bucket });
+}
+//#endregion
+export { Client, FileData, MISSING_CREDENTIALS_MSG, apply_run_history_replay, asset_url, clear_run_history, client, connect_bucket, consume_run_history_replay, delete_run_history, duplicate_space as duplicate, handle_file, is_valid_bucket_id, list_bucket_records, list_user_buckets, on_run_history_change, predict, prepare_files, read_run_history, read_run_history_storage, run_history_url, set_run_history_storage, stage_run_history_replay, submit, upload, upload_files };