@neta-art/cohub 12.5.0 → 12.6.0

package/dist/chunks/http-error.js

@@ -1,4 +1,4 @@
-import { o as resolveApiBaseUrl } from "./environment.js";
+import { n as decodeJwtPayload, s as resolveApiBaseUrl } from "./environment.js";
 //#region ../protocol/dist/identifiers.js
 const UUID_SHAPE_PATTERN = "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}";
 const UUID_PATTERN = "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}";
@@ -330,6 +330,7 @@ var HttpTransport = class {
 	getAuthSessionVersion;
 	onUnauthorized;
 	requestSource;
+	scopedToken = null;
 	refreshInFlight = null;
 	constructor(options = {}) {
 		this.baseUrl = resolveApiBaseUrl(options);
@@ -339,6 +340,26 @@ var HttpTransport = class {
 		this.onUnauthorized = options.onUnauthorized;
 		this.requestSource = options.requestSource;
 	}
+	async credential() {
+		return sanitizeAccessToken(this.getAccessToken ? await this.getAccessToken() : null);
+	}
+	async cacheScope() {
+		let token;
+		try {
+			token = await this.credential();
+		} catch {
+			return null;
+		}
+		if (!token) return "anonymous";
+		if (this.scopedToken?.token !== token) {
+			const uuid = decodeJwtPayload(token)?.talesofai_uuid;
+			this.scopedToken = {
+				token,
+				scope: typeof uuid === "string" && uuid ? `user:${uuid}` : null
+			};
+		}
+		return this.scopedToken.scope;
+	}
 	resolveRequestSource() {
 		if (!this.requestSource) return null;
 		if (typeof this.requestSource === "function") return this.requestSource() ?? null;
@@ -356,10 +377,11 @@ var HttpTransport = class {
 		}
 	}
 	async withAuthorization(init, tokenOverride) {
-		const { fetch: _fetch, skipUnauthorizedHandler: _skip, ...requestInit } = init ?? {};
+		const { fetch: _fetch, skipUnauthorizedHandler: _skip, accessToken, ...requestInit } = init ?? {};
 		const headers = new Headers(requestInit.headers);
 		let authSessionVersion = this.readAuthSessionVersion();
-		const token = sanitizeAccessToken(tokenOverride !== void 0 ? tokenOverride : this.getAccessToken ? await this.getAccessToken() : null);
+		const pinned = tokenOverride !== void 0 ? tokenOverride : accessToken;
+		const token = sanitizeAccessToken(pinned !== void 0 ? pinned : this.getAccessToken ? await this.getAccessToken() : null);
 		if (token) {
 			const resolvedVersion = this.readAuthSessionVersion();
 			if (resolvedVersion !== void 0) authSessionVersion = resolvedVersion;
@@ -413,7 +435,8 @@ var HttpTransport = class {
 	async send(path, init) {
 		const fetcher = init?.fetch ?? this.fetcher;
 		const url = joinApiUrl(this.baseUrl, path);
-		const skipUnauthorizedHandler = Boolean(init?.skipUnauthorizedHandler);
+		const pinned = init?.accessToken !== void 0;
+		const skipUnauthorizedHandler = Boolean(init?.skipUnauthorizedHandler) || pinned;
 		let response;
 		let rejectedToken = null;
 		let rejectedAuthSessionVersion;
@@ -426,7 +449,7 @@ var HttpTransport = class {
 			if (isBrowserRequestConstructionError(error)) throw new Error("Could not send request. Your session may be invalid — try refreshing or signing in again.", { cause: error });
 			throw error;
 		}
-		if (response.status === 401 && this.getAccessToken) {
+		if (response.status === 401 && this.getAccessToken && !pinned) {
 			const refreshedToken = await this.refreshAccessToken(rejectedToken);
 			if (refreshedToken) {
 				let retryResponse;

package/dist/chunks/http.d.ts

@@ -1,6 +1,7 @@
-import { $a as SpacePublicEndpoints, $i as RealtimePatchOperation, $n as SpaceCommerceProduct, $t as PromptTemplateCatalogResponse, Ac as BoardDelta, An as SessionTurnSignedUrlsResponse, Ba as DesktopCommandRecord, Bo as RuntimeStatus, Br as SpaceListOptions, Dl as RequestSource, Dn as SessionRecord, En as SessionMessagesResponse, Eo as StoredIntermediateMessage, Er as SpaceFsTreeResponse, Et as GlobalSearchType, Fn as SkillCatalogResponse, Ft as LabelItemsResponse, Gc as AppAuthorizationRequest$1, Gr as SpacePendingDiffFileResponse, Gt as PaletteOverviewResponse, Hi as GenerationContentBlock, Hr as SpaceMember, Hs as HarnessArchiveIndex, Ht as MeResponse, Ic as BoardPatch, Ir as SpaceInvitationListResponse, Ji as BoardPlaybackChangedEvent$1, Jn as SpaceCommerceBenefit, Jt as PatchResourceLabelsInput, Kc as AppAuthorizationResult, Ki as BoardAwarenessUpdatedEvent$1, Kr as SpacePendingDiffSummary, Ks as RuntimeArchiveUpload, La as DesktopCommand, Lt as LabelListItem, Mn as SessionTurnWindowResponse, Nn as SessionTurnsPaginatedResponse, Nr as SpaceFsUploadResponse, O as BillingCheckoutResult, On as SessionTurnIndexResponse, Oo as TurnIntermediateMessagesFile, Ot as InvitationDetail, Pr as SpaceFsWriteFileInput, Pt as LabelAssignmentRecord, Q as Channel, Qa as NavigationLaunch, Qc as DisplayCaptureParams, Qn as SpaceCommerceOrder, Rn as SpaceAccessPolicy, So as MessageToolCallsFile, T as BillingCatalogProduct, Ta as AppVersionSource, Ti as ChannelHealth, Tn as SessionMessagesPaginatedResponse, To as SpaceTurnsResponse, Tr as SpaceFsTreePage, Uc as BillingPayload, Ui as GenerationModelDeclaration, Ut as ModelCatalogEntry, Va as DesktopCommandStatus, Vn as SpaceActivityResponse, Vo as RuntimeStopConfirmation, Vr as SpaceListPage, Wr as SpaceModListItem, Ws as RuntimeArchivePage, Xr as SpaceRecord, Xt as Permission, Yn as SpaceCommerceBuyerProfile, Yr as SpacePublicProfile, Yt as PatchResourceLabelsResponse, Za as NavigationCall, Zc as DisplayCapture, Zr as SpaceRole, _ as AcceptInvitationResponse, _i as UserRulesResponse, _t as CronJobRecord, aa as RealtimeRoomMember, ac as SpaceCompletionStreamEvent, ar as SpaceConfigUpdateResponse, bc as BoardReadResult, bl as SandboxSetupInfo, bo as SessionStats, br as SpaceFsMoveInput, ci as TaskRunDetailResponse, cl as DisplayVirtualStart, cn as ReferenceAggregateResponse, cr as SpaceEnvInput, ct as ClaimReferralResponse, dc as BoardApplyResult, dl as AppRtcMediaKind, dn as ReferenceQueryResponse, do as BoardAwarenessUpdate, dt as CreateSpaceInput, el as DisplayInfo, en as PublicReferral, er as SpaceCommerceProductBenefitBinding, fi as UserActivityQuery, fn as ReferenceQueryableType, fo as MessageRecord, fr as SpaceFsCreateUploadInput, gi as UserProfile, go as SessionForkRecord, hc as BoardHistoryPage, hi as UserActivityResponse, hl as RtcIceServers, hn as ReferralDashboard, ho as SessionFilesResponse, ht as CreateSpaceSessionInput, ia as RealtimeRoomHistoryEvent, ic as SpaceCompletionResult, io as SpaceFsCopyResult, ir as SpaceConfigResponse, jn as SessionTurnStreamSnapshotResponse, kn as SessionTurnResponse, la as SessionTurnPatchEvent, li as TaskRunRecord, ln as ReferenceDirection, lr as SpaceFsCompleteUploadInput, lt as CreateInvitationInput, ma as AppDomainRecord, mc as BoardHistoryInput, mt as CreateSpacePromptResponse, nc as CreateSpaceCompletionInput, ni as SpaceTurnAuthorFilter, nl as DisplayList, nn as PublicUserPageResponse, oc as Usage, oi as SpaceUsageResponse, ol as DisplayTreeParams, oo as SpaceFsCopyStats, or as SpaceCreateResponse, ot as CheckpointDiffSummary, pa as AppDomainListResponse, pc as BoardCreateInput, pl as AppRtcQuality, pr as SpaceFsCreateUploadResponse, pt as CreateSpacePromptInput, qi as BoardChangedEvent$1, qn as SpaceCheckpointDetailResponse, qr as SpacePresenceSnapshot, r as CohubEnvironment, rl as DisplaySession, rn as PublicUserProfile, ro as SpaceFsCopyResponse, rr as SpaceConfigInput, sc as ContentBlock, sn as ReferenceAggregateGroupBy, sr as SpaceDefaultResponse, st as CheckpointRecord, ta as RealtimeRoomDescriptor, ti as SpaceSessionsResponse, tl as DisplayInputEvent, to as SpaceFsCopyInput, tt as CheckpointDiffFileResponse, uc as BoardApplyInput, ul as AppRtcDelivery, un as ReferenceKind, ur as SpaceFsCompleteUploadResponse, ut as CreateInvitationResponse, va as AppArtifactDescriptor, vc as BoardPlaybackSnapshot, vr as SpaceFsFileResponse, vt as CronJobUpdatePatch, wa as AppContentKind, wi as ChannelConfig, wn as SessionMessageResponse, wo as SessionTurnRecord, wr as SpaceFsReadFilesResponse, wt as GlobalSearchResponse, xi as UserSessionsResponse, xr as SpaceFsPreparingFile, y as BatchUserProfilesResponse, yc as BoardReadInput, yi as UserSessionSourceKey, yr as SpaceFsListOptions, yt as CursorPageInfo, za as DesktopCommandError, zo as RuntimeSessionRecoveryStatus, zt as LabelResourceType } from "./environment.js";
+import { $a as SpacePublicEndpoints, $c as DisplayCaptureParams, $i as RealtimePatchOperation, $n as SpaceCommerceProduct, $t as PromptTemplateCatalogResponse, An as SessionTurnSignedUrlsResponse, Ba as DesktopCommandRecord, Bo as RuntimeSessionRecoveryStatus, Br as SpaceListOptions, Co as MessageToolCallsFile, Dn as SessionRecord, Do as StoredIntermediateMessage, En as SessionMessagesResponse, Eo as SpaceTurnsResponse, Er as SpaceFsTreeResponse, Et as GlobalSearchType, Fn as SkillCatalogResponse, Ft as LabelItemsResponse, Gr as SpacePendingDiffFileResponse, Gs as RuntimeArchivePage, Gt as PaletteOverviewResponse, Hi as GenerationContentBlock, Ho as RuntimeStopConfirmation, Hr as SpaceMember, Ht as MeResponse, Ir as SpaceInvitationListResponse, Ji as BoardPlaybackChangedEvent$1, Jn as SpaceCommerceBenefit, Jt as PatchResourceLabelsInput, Kc as AppAuthorizationRequest$1, Ki as BoardAwarenessUpdatedEvent$1, Kr as SpacePendingDiffSummary, La as DesktopCommand, Lc as BoardPatch, Lt as LabelListItem, Mn as SessionTurnWindowResponse, Nn as SessionTurnsPaginatedResponse, Nr as SpaceFsUploadResponse, O as BillingCheckoutResult, Ol as RequestSource, On as SessionTurnIndexResponse, Ot as InvitationDetail, Pr as SpaceFsWriteFileInput, Pt as LabelAssignmentRecord, Q as Channel, Qa as NavigationLaunch, Qc as DisplayCapture, Qn as SpaceCommerceOrder, Rn as SpaceAccessPolicy, T as BillingCatalogProduct, Ta as AppVersionSource, Ti as ChannelHealth, Tn as SessionMessagesPaginatedResponse, To as SessionTurnRecord, Tr as SpaceFsTreePage, Ui as GenerationModelDeclaration, Us as HarnessArchiveIndex, Ut as ModelCatalogEntry, Va as DesktopCommandStatus, Vn as SpaceActivityResponse, Vo as RuntimeStatus, Vr as SpaceListPage, Wc as BillingPayload, Wr as SpaceModListItem, Xr as SpaceRecord, Xt as Permission, Yn as SpaceCommerceBuyerProfile, Yr as SpacePublicProfile, Yt as PatchResourceLabelsResponse, Za as NavigationCall, Zr as SpaceRole, _ as AcceptInvitationResponse, _i as UserRulesResponse, _o as SessionForkRecord, _t as CronJobRecord, aa as RealtimeRoomMember, ac as SpaceCompletionResult, ao as SpaceFsCopyResult, ar as SpaceConfigUpdateResponse, bc as BoardReadInput, br as SpaceFsMoveInput, cc as ContentBlock, ci as TaskRunDetailResponse, cn as ReferenceAggregateResponse, cr as SpaceEnvInput, ct as ClaimReferralResponse, dc as BoardApplyInput, dl as AppRtcDelivery, dn as ReferenceQueryResponse, dt as CreateSpaceInput, en as PublicReferral, eo as SpaceFsChangedPayload, er as SpaceCommerceProductBenefitBinding, fc as BoardApplyResult, fi as UserActivityQuery, fl as AppRtcMediaKind, fn as ReferenceQueryableType, fo as BoardAwarenessUpdate, fr as SpaceFsCreateUploadInput, gc as BoardHistoryPage, gi as UserProfile, gl as RtcIceServers, go as SessionFilesResponse, hc as BoardHistoryInput, hi as UserActivityResponse, hn as ReferralDashboard, ht as CreateSpaceSessionInput, ia as RealtimeRoomHistoryEvent, il as DisplaySession, io as SpaceFsCopyResponse, ir as SpaceConfigResponse, jc as BoardDelta, jn as SessionTurnStreamSnapshotResponse, kn as SessionTurnResponse, ko as TurnIntermediateMessagesFile, la as SessionTurnPatchEvent, li as TaskRunRecord, ll as DisplayVirtualStart, ln as ReferenceDirection, lr as SpaceFsCompleteUploadInput, lt as CreateInvitationInput, ma as AppDomainRecord, mc as BoardCreateInput, ml as AppRtcQuality, mt as CreateSpacePromptResponse, ni as SpaceTurnAuthorFilter, nl as DisplayInputEvent, nn as PublicUserPageResponse, no as SpaceFsCopyInput, oc as SpaceCompletionStreamEvent, oi as SpaceUsageResponse, or as SpaceCreateResponse, ot as CheckpointDiffSummary, pa as AppDomainListResponse, po as MessageRecord, pr as SpaceFsCreateUploadResponse, pt as CreateSpacePromptInput, qc as AppAuthorizationResult, qi as BoardChangedEvent$1, qn as SpaceCheckpointDetailResponse, qr as SpacePresenceSnapshot, qs as RuntimeArchiveUpload, r as CohubEnvironment, rc as CreateSpaceCompletionInput, rl as DisplayList, rn as PublicUserProfile, rr as SpaceConfigInput, sc as Usage, sl as DisplayTreeParams, sn as ReferenceAggregateGroupBy, so as SpaceFsCopyStats, sr as SpaceDefaultResponse, st as CheckpointRecord, ta as RealtimeRoomDescriptor, ti as SpaceSessionsResponse, tl as DisplayInfo, tt as CheckpointDiffFileResponse, un as ReferenceKind, ur as SpaceFsCompleteUploadResponse, ut as CreateInvitationResponse, va as AppArtifactDescriptor, vr as SpaceFsFileResponse, vt as CronJobUpdatePatch, wa as AppContentKind, wi as ChannelConfig, wn as SessionMessageResponse, wr as SpaceFsReadFilesResponse, wt as GlobalSearchResponse, xc as BoardReadResult, xi as UserSessionsResponse, xl as SandboxSetupInfo, xo as SessionStats, xr as SpaceFsPreparingFile, y as BatchUserProfilesResponse, yc as BoardPlaybackSnapshot, yi as UserSessionSourceKey, yr as SpaceFsListOptions, yt as CursorPageInfo, za as DesktopCommandError, zt as LabelResourceType } from "./environment.js";
 import { a as WebsocketClientOptions, r as WebsocketClient, s as WebsocketEventPayload } from "./websocket.js";
 import { a as VoiceInputCreateOptions } from "./voice-input.js";
+import { z } from "zod";
 //#region ../protocol/dist/space-wallet.d.ts
 type SpaceWalletSummary = {
   spaceId: string;
@@ -873,6 +874,8 @@ type RequestInitWithFetch = RequestInit & {
   fetch?: Fetch;
   /** When true, 401 responses throw without invoking onUnauthorized (e.g. session bootstrap). */
   skipUnauthorizedHandler?: boolean;
+  /** Fixed credential; 401 skips session refresh and unauthorized callbacks. */
+  accessToken?: string | null;
 };
 type RawHttpResponse = {
   response: Response;
@@ -956,8 +959,11 @@ declare class HttpTransport {
   private readonly getAuthSessionVersion?;
   private readonly onUnauthorized?;
   private readonly requestSource?;
+  private scopedToken;
   private refreshInFlight;
   constructor(options?: CohubClientOptions);
+  credential(): Promise<string | null>;
+  cacheScope(): Promise<string | null>;
   private resolveRequestSource;
   private applyRequestSourceHeaders;
   private readAuthSessionVersion;
@@ -1229,6 +1235,16 @@ type FileListOptions = SpaceFsListOptions & {
   signal?: AbortSignal;
 };
 //#endregion
+//#region src/board/model/media-playback.d.ts
+type BoardAssetUrlOptions = {
+  fresh?: boolean;
+};
+type BoardAssetSource = {
+  resolveFileUrl: (path: string, options?: BoardAssetUrlOptions) => Promise<string | null>;
+  resolvePlaybackUrl?: (path: string, options?: BoardAssetUrlOptions) => Promise<string | null>;
+  subscribe?: (listener: (path: string) => void) => () => void;
+};
+//#endregion
 //#region src/board/replica/index.d.ts
 type BoardChangedPayload = {
   mutationId: string;
@@ -1237,7 +1253,8 @@ type BoardChangedPayload = {
   after?: BoardDelta;
 };
 type BoardRemote = {
-  get(): Promise<BoardReadResult>;
+  /** `only: []` reads metadata only; remotes may return the full Board. */
+  get(read?: Pick<BoardReadInput, "only">): Promise<BoardReadResult>;
   apply(patch: BoardPatch, options: {
     mutationId: string;
     clientId?: string;
@@ -1318,16 +1335,22 @@ declare class BoardClient implements BoardRemote {
   on(type: "awareness", handler: (event: BoardAwarenessUpdatedEvent) => void): () => void;
   on(type: "playback", handler: (event: BoardPlaybackChangedEvent) => void): () => void;
 }
-type BoardFileReader = {
+type BoardFiles = {
   read(path: string, customFetch?: Fetch): Promise<SpaceFsFileResponse | SpaceFsPreparingFile>;
+  resolveUrl(path: string, options?: {
+    purpose?: "preview" | "playback";
+    fresh?: boolean;
+  }): Promise<string | null>;
+  onUrlChange(listener: (path: string) => void): () => void;
 };
 declare class SpaceBoardsApi {
   private readonly http;
   private readonly spaceId;
   private readonly websocket;
   private readonly files;
-  constructor(http: HttpTransport, spaceId: string, websocket: WebsocketClient | null, files: BoardFileReader);
+  constructor(http: HttpTransport, spaceId: string, websocket: WebsocketClient | null, files: BoardFiles);
   byId(boardId: string): BoardClient;
+  assetSource(): BoardAssetSource;
   open(target: string, customFetch?: Fetch): Promise<BoardClient>;
   resolveId(path: string, customFetch?: Fetch): Promise<string>;
   /** Create a `.board` file and its Board, optionally with an initial document. */
@@ -1724,6 +1747,46 @@ type BuildSpaceInvitePathInput = BuildSpacePathInput & {
 declare function buildSpacePath(input: BuildSpacePathInput): string;
 declare function buildSpaceInvitePath(input: BuildSpaceInvitePathInput): string;
 //#endregion
+//#region src/apis/space-file-reads.d.ts
+type SpaceFileRead = SpaceFsFileResponse | SpaceFsPreparingFile;
+declare function createSpaceFileReads(transport: HttpTransport): {
+  read(spaceId: string, path: string, options?: {
+    background?: boolean;
+    signal?: AbortSignal;
+    token?: string | null;
+  }): Promise<SpaceFileRead>;
+  invalidate(spaceId: string, paths: Iterable<string>): void;
+};
+type SpaceFileReads = ReturnType<typeof createSpaceFileReads>;
+//#endregion
+//#region src/apis/space-file-urls.d.ts
+type SpaceFileUrlPurpose = "preview" | "playback";
+type SpaceFileUrlRequest = {
+  /** Playback only accepts a streamable URL; previews may fall back to a data URL. */
+  purpose?: SpaceFileUrlPurpose;
+  fresh?: boolean;
+  /** Maximum time to wait while CDN delivery is being prepared. */
+  timeoutMs?: number;
+  signal?: AbortSignal;
+};
+declare function createSpaceFileUrls(options: {
+  reads: SpaceFileReads;
+  credential: () => Promise<string | null>;
+  scope: () => Promise<string | null>;
+  watched: (spaceId: string) => boolean;
+  cache: boolean;
+  now?: () => number;
+}): {
+  resolve(spaceId: string, path: string, request?: SpaceFileUrlRequest): Promise<string | null>;
+  applyFsChange(spaceId: string, payload: Pick<SpaceFsChangedPayload, "changes" | "resync">): void;
+  subscribe(listener: (spaceId: string, path: string) => void): () => void;
+};
+type SpaceFileUrls = ReturnType<typeof createSpaceFileUrls>;
+type SpaceFileServices = {
+  reads: SpaceFileReads;
+  urls: SpaceFileUrls;
+};
+//#endregion
 //#region src/apis/spaces.d.ts
 type SessionSubscriptionHandlers = {
   patch?: (event: WebsocketEventPayload) => void;
@@ -1737,7 +1800,7 @@ type SessionSubscriptionHandlers = {
   event?: (event: WebsocketEventPayload) => void;
 };
 type SessionEventName = "created" | "updated" | "turn.created" | "turn.patch" | "turn.lifecycle" | "turn.updated" | "turn.finalized" | "turn.error" | "message.persisted";
-type SpaceEventName = SessionEventName | "fs.changed" | "ports.changed" | "presence.updated" | "board.changed" | "board.playback.changed" | "app.version.published" | "app.domain.updated" | "app.domain.removed" | "task.created" | "task.updated" | "event";
+type SpaceEventName = SessionEventName | "fs.changed" | "ports.changed" | "presence.updated" | "app.version.published" | "app.domain.updated" | "app.domain.removed" | "task.created" | "task.updated" | "event";
 declare class SpacesApi {
   private readonly transport;
   constructor(transport: HttpTransport);
@@ -1752,13 +1815,7 @@ declare class SpacesApi {
   ensureHome(customFetch?: Fetch): Promise<SpaceRecord>;
   create(input: CreateSpaceInput, headers?: Record<string, string>): Promise<SpaceCreateResponse>;
 }
-type SpaceFileUrlPurpose = "preview" | "playback";
-type ResolveSpaceFileUrlOptions = {
-  /** Playback only accepts a streamable URL; previews may fall back to a data URL. */
-  purpose?: SpaceFileUrlPurpose;
-  /** Maximum time to wait while CDN delivery is being prepared. */
-  timeoutMs?: number;
-  signal?: AbortSignal;
+type ResolveSpaceFileUrlOptions = SpaceFileUrlRequest & {
   fetch?: Fetch;
 };
 type OpenSpaceFileOptions = {
@@ -1794,12 +1851,15 @@ declare class SpacePublicFilesApi {
 declare class SpaceFilesApi {
   private readonly transport;
   private readonly spaceId;
-  constructor(transport: HttpTransport, spaceId: string);
+  private readonly services;
+  constructor(transport: HttpTransport, spaceId: string, services: SpaceFileServices);
   list(path?: string, customFetch?: Fetch): Promise<SpaceFsTreeResponse>;
   list(path: string, options: FileListOptions): Promise<SpaceFsTreePage>;
   read(path: string, customFetch?: Fetch, signal?: AbortSignal): Promise<SpaceFsFileResponse | SpaceFsPreparingFile>;
   /** Resolve a browser-ready file URL, waiting for CDN delivery when necessary. */
   resolveUrl(path: string, options?: ResolveSpaceFileUrlOptions): Promise<string | null>;
+  onUrlChange(listener: (path: string) => void): () => void;
+  private resolveUrlThrough;
   /** Pending workspace changes vs the space head checkpoint. */
   diff(customFetch?: Fetch): Promise<SpacePendingDiffSummary>;
   /** Per-file pending workspace diff vs the space head checkpoint. */
@@ -2397,7 +2457,7 @@ declare class SpaceClient {
   readonly boards: SpaceBoardsApi;
   readonly wallet: SpaceWalletApi;
   readonly commerce: SpaceCommerceApi;
-  constructor(id: string, transport: HttpTransport, websocketClient: WebsocketClient | null);
+  constructor(id: string, transport: HttpTransport, websocketClient: WebsocketClient | null, fileServices: SpaceFileServices);
   get(customFetch?: Fetch): Promise<SpaceRecord>;
   prepareRuntimeArchive(index: HarnessArchiveIndex, options?: {
     signal?: AbortSignal;
@@ -3604,9 +3664,10 @@ declare class CohubHttpClient {
   /** @deprecated Use `desktop`. */
   get ui(): DesktopCommandsApi;
   private readonly transport;
+  private readonly fileServices;
   constructor(options?: CohubClientOptions);
   space(spaceId: string): SpaceClient;
 }
 declare const createHttpClient: (options?: CohubClientOptions) => CohubHttpClient;
 //#endregion
-export { WorkCommerceEntitlement as $, SpaceWebhookTriggerResponse as $i, GenerationStreamTurnUpdatedEvent as $n, matchesUnauthorizedErrorToken as $r, WorkPresentationMeta as $t, AppRtcChannel as A, AppNavigationLaunch as Ai, SpacePublicFilesApi as An, PublicAssetPurpose as Ar, AppPublicOwnerRecord as At, AppCommerceApi as B, AppRuntimeConfigureRequest as Bi, buildSpaceInvitePath as Bn, PromptsApi as Br, AppViewStatsResponse as Bt, WorkRoomCreateInput as C, createOriginAppResolver as Ci, OpenSpaceFileOptions as Cn, SessionAccessApi as Cr, AppPresentationMeta as Ct, WorkRoomState as D, AppDevice as Di, SpaceClient as Dn, CreatePublicAssetUploadInput as Dr, AppPromotionProviderStatus as Dt, WorkRoomPublishResult as E, APP_DEVICES as Ei, SpaceChannelBindingRecord as En, SearchApi as Er, AppPromotionProvider as Et, AppRtcMessage as F, AppAppearance as Fi, WaitForSpaceFsCopyOptions as Fn, UploadChatAttachmentInput as Fr, AppStatus as Ft, AppCommerceEntitlementsResponse as G, PublicFileCreateUploadInput as Gi, GenerationStreamEvent as Gn, CohubClientOptions as Gr, WorkAuthorizeResponse as Gt, AppCommerceCreditConsumeResponse as H, AppWindowState as Hi, AssistantMessageCommit as Hn, GenerationsApi as Hr, AppVisibility as Ht, AppRtcPeerEvent as I, AppAppearanceToken as Ii, WebSocketConnectionState as In, UploadChatImageAttachmentInput as Ir, AppTargetType as It, AppCommercePurchaseResponse as J, PublicFileListResponse as Ji, GenerationStreamLifecycleEvent as Jn, HttpTraceContext as Jr, WorkCreateInput as Jt, AppCommerceOrder as K, PublicFileCreateUploadResponse as Ki, GenerationStreamFinalizedEvent as Kn, Fetch as Kr, WorkContent as Kt, AppRtcRemoteTrack as L, AppDropResource as Li, BuildSpaceInvitePathInput as Ln, UploadGenerationInputInput as Lr, AppUpdateInput as Lt, AppRtcError as M, AppNavigationOpenResponse as Mi, SpaceTurnListOptions as Mn, PublicAssetUploadProtocol as Mr, AppRecord as Mt, AppRtcErrorCode as N, AppNavigationTarget as Ni, SpaceWebhooksApi as Nn, PublicAssetsApi as Nr, AppResolveResponse as Nt, AppRoomRtc as O, AppDevicesStatus as Oi, SpaceEventName as On, CreatePublicAssetUploadResponse as Or, AppPromotionRecord as Ot, AppRtcLocalTrack as P, APP_APPEARANCE_TOKENS as Pi, SpacesApi as Pn, UploadAppSourceInput as Pr, AppSessionResponse as Pt, WorkCommerceCreditConsumeStatus as Q, SpaceWebhookListItem as Qi, GenerationStreamSubscriptionHandlers as Qn, joinApiUrl as Qr, WorkMeta as Qt, AppRtcState as R, AppDropResourceType as Ri, BuildSpacePathInput as Rn, UploadPublicAssetInput as Rr, AppVersionRecord as Rt, WorkRoomAdmissionResponse as S, createAppRuntime as Si, TasksApi as Sn, BoardSubscriptionHandlers as Sr, AppMeta as St, WorkRoomEventMap as T, resolveAppTransport as Ti, SessionSubscriptionHandlers as Tn, ReferencesApi as Tr, AppPromotionEventResponse as Tt, AppCommerceCreditConsumeStatus as U, AppWindowStatus as Ui, GenerationStreamCommitEvent as Un, CronJobsApi as Ur, AppsApi as Ut, AppCommerceCheckoutStatus as V, AppRuntimeRect as Vi, buildSpacePath as Vn, ModelsApi as Vr, AppViewerGrantRecord as Vt, AppCommerceEntitlement as W, appAppearanceVar as Wi, GenerationStreamErrorEvent as Wn, ChannelsApi as Wr, PublicAppVersionSummary as Wt, WorkCommerceCheckoutStatus as X, PublicFileUploadPlanEntry as Xi, GenerationStreamStateEvent as Xn, RawHttpResponse as Xr, WorkExtractedPageMeta as Xt, WorkCommerceApi as Y, PublicFileUploadEntryInput as Yi, GenerationStreamOutOfSyncEvent as Yn, HttpTransport as Yr, WorkDetailResponse as Yt, WorkCommerceCreditConsumeResponse as Z, PublicFileUrlResponse as Zi, GenerationStreamSubscribeOptions as Zn, UnauthorizedContext as Zr, WorkGetResponse as Zt, AppRoomInvite as _, SpaceWalletSummary as _a, AppRuntimeShellContext as _i, WorkVisibility as _n, BoardChangedEvent as _r, AppContentDownload as _t, RoomEvents as a, ListGenerationModelsResponse as aa, AppIdResolver as ai, WorkPromotionStatsResponse as an, SessionPatchReducer as ar, CreateUiCommandInput as at, WorkRealtimeApi as b, ParentBridgeTransport as bi, UserApi as bn, BoardEventName as br, AppExtractedPageMeta as bt, RoomView as c, ModelStatusResponse as ca, AppRuntimeAuthorizationResult as ci, WorkRecord as cn, createSessionPatchReducer as cr, UiCommandError as ct, AppRoom as d, DecisionQuestion as da, AppRuntimeContext as di, WorkStatus as dn, DisplayConnection as dr, UiCommandsApi as dt, SpaceStartupResponse as ea, sanitizeAccessToken as ei, WorkPromotionCreateInput as en, SessionGenerationStreamClient as er, WorkCommerceEntitlementsResponse as et, AppRoomAdmissionResponse as f, DecisionState as fa, AppRuntimeError as fi, WorkTargetType as fn, DisplayConnectionState as fr, WaitForDesktopCommandOptions as ft, AppRoomHistory as g, SpaceWalletActivityPage as ga, AppRuntimeResolvedApp as gi, WorkViewStatsResponse as gn, BoardAwarenessUpdatedEvent as gr, AppContent as gt, AppRoomEventMap as h, SpaceWalletActivity as ha, AppRuntimeRequestOptions as hi, WorkViewSource as hn, RtcTransportStats as hr, AppAuthorizeResponse as ht, RoomEvent as i, GenerationUsageBilling as ia, AppDiagnosticListener as ii, WorkPromotionRecord as in, SessionPatchApplyResult as ir, CreateDesktopCommandInput as it, AppRtcChannelOptions as j, AppNavigationOpenMessage as ji, SpaceSandboxRecord as jn, PublicAssetUploadProgress as jr, AppPublicSpaceRecord as jt, AppRtcCandidate as k, AppNavigationCall as ki, SpaceFileStream as kn, PublicAssetMimeType as kr, AppPromotionStatsResponse as kt, RoomsApi as l, CreateSpaceDecisionInput as la, AppRuntimeCheckoutState as li, WorkResolveResponse as ln, SpaceDisplaysApi as lr, UiCommandRecord as lt, AppRoomEvent as m, SpaceDecisionResult as ma, AppRuntimeModeConfig as mi, WorkVersionRecord as mn, DisplayConnectionStats as mr, AppActionRunResponse as mt, createHttpClient as n, CreateGenerationTaskResponse as na, AppContextChangedListener as ni, WorkPromotionProvider as nn, parseAssistantMessageCommit as nr, WorkCommerceProductResolveResponse as nt, RoomEventsQuery as o, PublicGenerationDeclaration as oa, AppRuntimeApi as oi, WorkPublicOwnerRecord as on, SessionPatchState as or, DesktopCommandsApi as ot, AppRoomCreateInput as p, DecisionStateImage as pa, AppRuntimeInvocationContext as pi, WorkUpdateInput as pn, connectDisplay as pr, WaitForUiCommandOptions as pt, AppCommerceProductResolveResponse as q, PublicFileListEntry as qi, GenerationStreamIntermediateMessage as qn, HttpError as qr, WorkContentDownload as qt, RoomCreated as r, GenerationTaskResult as ra, AppDiagnostic as ri, WorkPromotionProviderStatus as rn, SessionPatchApplyInput as rr, WorkCommercePurchaseResponse as rt, RoomInvite as s, ModelStatusEntry as sa, AppRuntimeAppResolver as si, WorkPublicSpaceRecord as sn, SessionPatchStatus as sr, UiCommand as st, CohubHttpClient as t, CreateGenerationTaskRequest as ta, AppAuthorizationRequest as ti, WorkPromotionEventResponse as tn, createSessionGenerationStreamClient as tr, WorkCommerceOrder as tt, AppRealtimeApi as u, DecisionAnswer as ua, AppRuntimeCheckoutStatus as ui, WorkSessionResponse as un, ConnectDisplayOptions as ur, UiCommandStatus as ut, AppRoomPublishResult as v, AppRuntimeTransport as vi, ReferralsApi as vn, BoardClient as vr, AppCreateInput as vt, WorkRoomEvent as w, createSlugAppIdResolver as wi, SessionEventName as wn, ReferenceResourceSelector as wr, AppPromotionCreateInput as wt, WorkRoom as x, PopupBrokerTransport as xi, TaskWaitOptions as xn, BoardPlaybackChangedEvent as xr, AppGetResponse as xt, AppRoomState as y, OriginBrokerTransport as yi, UsersApi as yn, BoardClientOptions as yr, AppDetailResponse as yt, AppRtcTrackInput as z, AppRuntimeAnchor as zi, PublicInviteApi as zn, SkillsApi as zr, AppViewSource as zt };
+export { WorkCommerceEntitlement as $, SpaceWebhookListItem as $i, GenerationStreamSubscriptionHandlers as $n, joinApiUrl as $r, WorkPresentationMeta as $t, AppRtcChannel as A, AppNavigationCall as Ai, SpaceFileStream as An, PublicAssetMimeType as Ar, AppPublicOwnerRecord as At, AppCommerceApi as B, AppRuntimeAnchor as Bi, PublicInviteApi as Bn, SkillsApi as Br, AppViewStatsResponse as Bt, WorkRoomCreateInput as C, createAppRuntime as Ci, OpenSpaceFileOptions as Cn, BoardSubscriptionHandlers as Cr, AppPresentationMeta as Ct, WorkRoomState as D, APP_DEVICES as Di, SpaceChannelBindingRecord as Dn, SearchApi as Dr, AppPromotionProviderStatus as Dt, WorkRoomPublishResult as E, resolveAppTransport as Ei, SessionSubscriptionHandlers as En, ReferencesApi as Er, AppPromotionProvider as Et, AppRtcMessage as F, APP_APPEARANCE_TOKENS as Fi, SpacesApi as Fn, UploadAppSourceInput as Fr, AppStatus as Ft, AppCommerceEntitlementsResponse as G, appAppearanceVar as Gi, GenerationStreamErrorEvent as Gn, ChannelsApi as Gr, WorkAuthorizeResponse as Gt, AppCommerceCreditConsumeResponse as H, AppRuntimeRect as Hi, buildSpacePath as Hn, ModelsApi as Hr, AppVisibility as Ht, AppRtcPeerEvent as I, AppAppearance as Ii, WaitForSpaceFsCopyOptions as In, UploadChatAttachmentInput as Ir, AppTargetType as It, AppCommercePurchaseResponse as J, PublicFileListEntry as Ji, GenerationStreamIntermediateMessage as Jn, HttpError as Jr, WorkCreateInput as Jt, AppCommerceOrder as K, PublicFileCreateUploadInput as Ki, GenerationStreamEvent as Kn, CohubClientOptions as Kr, WorkContent as Kt, AppRtcRemoteTrack as L, AppAppearanceToken as Li, WebSocketConnectionState as Ln, UploadChatImageAttachmentInput as Lr, AppUpdateInput as Lt, AppRtcError as M, AppNavigationOpenMessage as Mi, SpaceSandboxRecord as Mn, PublicAssetUploadProgress as Mr, AppRecord as Mt, AppRtcErrorCode as N, AppNavigationOpenResponse as Ni, SpaceTurnListOptions as Nn, PublicAssetUploadProtocol as Nr, AppResolveResponse as Nt, AppRoomRtc as O, AppDevice as Oi, SpaceClient as On, CreatePublicAssetUploadInput as Or, AppPromotionRecord as Ot, AppRtcLocalTrack as P, AppNavigationTarget as Pi, SpaceWebhooksApi as Pn, PublicAssetsApi as Pr, AppSessionResponse as Pt, WorkCommerceCreditConsumeStatus as Q, PublicFileUrlResponse as Qi, GenerationStreamSubscribeOptions as Qn, UnauthorizedContext as Qr, WorkMeta as Qt, AppRtcState as R, AppDropResource as Ri, BuildSpaceInvitePathInput as Rn, UploadGenerationInputInput as Rr, AppVersionRecord as Rt, WorkRoomAdmissionResponse as S, PopupBrokerTransport as Si, TasksApi as Sn, BoardPlaybackChangedEvent as Sr, AppMeta as St, WorkRoomEventMap as T, createSlugAppIdResolver as Ti, SessionEventName as Tn, ReferenceResourceSelector as Tr, AppPromotionEventResponse as Tt, AppCommerceCreditConsumeStatus as U, AppWindowState as Ui, AssistantMessageCommit as Un, GenerationsApi as Ur, AppsApi as Ut, AppCommerceCheckoutStatus as V, AppRuntimeConfigureRequest as Vi, buildSpaceInvitePath as Vn, PromptsApi as Vr, AppViewerGrantRecord as Vt, AppCommerceEntitlement as W, AppWindowStatus as Wi, GenerationStreamCommitEvent as Wn, CronJobsApi as Wr, PublicAppVersionSummary as Wt, WorkCommerceCheckoutStatus as X, PublicFileUploadEntryInput as Xi, GenerationStreamOutOfSyncEvent as Xn, HttpTransport as Xr, WorkExtractedPageMeta as Xt, WorkCommerceApi as Y, PublicFileListResponse as Yi, GenerationStreamLifecycleEvent as Yn, HttpTraceContext as Yr, WorkDetailResponse as Yt, WorkCommerceCreditConsumeResponse as Z, PublicFileUploadPlanEntry as Zi, GenerationStreamStateEvent as Zn, RawHttpResponse as Zr, WorkGetResponse as Zt, AppRoomInvite as _, SpaceWalletActivityPage as _a, AppRuntimeResolvedApp as _i, WorkVisibility as _n, BoardAwarenessUpdatedEvent as _r, AppContentDownload as _t, RoomEvents as a, GenerationUsageBilling as aa, AppDiagnosticListener as ai, WorkPromotionStatsResponse as an, SessionPatchApplyResult as ar, CreateUiCommandInput as at, WorkRealtimeApi as b, OriginBrokerTransport as bi, UserApi as bn, BoardClientOptions as br, AppExtractedPageMeta as bt, RoomView as c, ModelStatusEntry as ca, AppRuntimeAppResolver as ci, WorkRecord as cn, SessionPatchStatus as cr, UiCommandError as ct, AppRoom as d, DecisionAnswer as da, AppRuntimeCheckoutStatus as di, WorkStatus as dn, ConnectDisplayOptions as dr, UiCommandsApi as dt, SpaceWebhookTriggerResponse as ea, matchesUnauthorizedErrorToken as ei, WorkPromotionCreateInput as en, GenerationStreamTurnUpdatedEvent as er, WorkCommerceEntitlementsResponse as et, AppRoomAdmissionResponse as f, DecisionQuestion as fa, AppRuntimeContext as fi, WorkTargetType as fn, DisplayConnection as fr, WaitForDesktopCommandOptions as ft, AppRoomHistory as g, SpaceWalletActivity as ga, AppRuntimeRequestOptions as gi, WorkViewStatsResponse as gn, RtcTransportStats as gr, AppContent as gt, AppRoomEventMap as h, SpaceDecisionResult as ha, AppRuntimeModeConfig as hi, WorkViewSource as hn, DisplayConnectionStats as hr, AppAuthorizeResponse as ht, RoomEvent as i, GenerationTaskResult as ia, AppDiagnostic as ii, WorkPromotionRecord as in, SessionPatchApplyInput as ir, CreateDesktopCommandInput as it, AppRtcChannelOptions as j, AppNavigationLaunch as ji, SpacePublicFilesApi as jn, PublicAssetPurpose as jr, AppPublicSpaceRecord as jt, AppRtcCandidate as k, AppDevicesStatus as ki, SpaceEventName as kn, CreatePublicAssetUploadResponse as kr, AppPromotionStatsResponse as kt, RoomsApi as l, ModelStatusResponse as la, AppRuntimeAuthorizationResult as li, WorkResolveResponse as ln, createSessionPatchReducer as lr, UiCommandRecord as lt, AppRoomEvent as m, DecisionStateImage as ma, AppRuntimeInvocationContext as mi, WorkVersionRecord as mn, connectDisplay as mr, AppActionRunResponse as mt, createHttpClient as n, CreateGenerationTaskRequest as na, AppAuthorizationRequest as ni, WorkPromotionProvider as nn, createSessionGenerationStreamClient as nr, WorkCommerceProductResolveResponse as nt, RoomEventsQuery as o, ListGenerationModelsResponse as oa, AppIdResolver as oi, WorkPublicOwnerRecord as on, SessionPatchReducer as or, DesktopCommandsApi as ot, AppRoomCreateInput as p, DecisionState as pa, AppRuntimeError as pi, WorkUpdateInput as pn, DisplayConnectionState as pr, WaitForUiCommandOptions as pt, AppCommerceProductResolveResponse as q, PublicFileCreateUploadResponse as qi, GenerationStreamFinalizedEvent as qn, Fetch as qr, WorkContentDownload as qt, RoomCreated as r, CreateGenerationTaskResponse as ra, AppContextChangedListener as ri, WorkPromotionProviderStatus as rn, parseAssistantMessageCommit as rr, WorkCommercePurchaseResponse as rt, RoomInvite as s, PublicGenerationDeclaration as sa, AppRuntimeApi as si, WorkPublicSpaceRecord as sn, SessionPatchState as sr, UiCommand as st, CohubHttpClient as t, SpaceStartupResponse as ta, sanitizeAccessToken as ti, WorkPromotionEventResponse as tn, SessionGenerationStreamClient as tr, WorkCommerceOrder as tt, AppRealtimeApi as u, CreateSpaceDecisionInput as ua, AppRuntimeCheckoutState as ui, WorkSessionResponse as un, SpaceDisplaysApi as ur, UiCommandStatus as ut, AppRoomPublishResult as v, SpaceWalletSummary as va, AppRuntimeShellContext as vi, ReferralsApi as vn, BoardChangedEvent as vr, AppCreateInput as vt, WorkRoomEvent as w, createOriginAppResolver as wi, ResolveSpaceFileUrlOptions as wn, SessionAccessApi as wr, AppPromotionCreateInput as wt, WorkRoom as x, ParentBridgeTransport as xi, TaskWaitOptions as xn, BoardEventName as xr, AppGetResponse as xt, AppRoomState as y, AppRuntimeTransport as yi, UsersApi as yn, BoardClient as yr, AppDetailResponse as yt, AppRtcTrackInput as z, AppDropResourceType as zi, BuildSpacePathInput as zn, UploadPublicAssetInput as zr, AppViewSource as zt };