@puredesktop/puredesktop-ui-bridge 1.0.0-beta.1 → 1.0.0-beta.2

package/src/bridge/agents.ts

@@ -1,62 +1,77 @@
-export {
-  advanceAgentSessionPending,
-  approveAgentSessionTools,
-  callAgentRunModel,
-  createAgentSession,
-  deleteAgentSession,
-  interruptAgentSession,
-  listAgentSessions,
-  onAgentRunEvent,
-  onAgentToolInvoke,
-  readAgentLlmMenuOptions,
-  readAgentRunContext,
-  readAgentSession,
-  readLocalModelsStatus,
-  registerAgentTools,
-  rejectAgentSessionTools,
-  resolveAgentRunToolCalls,
-  sendAgentRunMessage,
-  sendAgentSessionMessage,
-  startAgentRun,
-  updateAgentSession,
-} from './agents.mjs'
-export type {
-  PlatformAgentMessage,
-  PlatformAgentMessageAttachment,
-  PlatformAgentImageAttachment,
-  PlatformAgentSessionConfig,
-  PlatformAgentSessionConfigPatch,
-  PlatformAgentSessionMetadata,
-  PlatformAgentSessionRecord,
-  PlatformAgentSessionScope,
-  PlatformAgentSessionSnapshot,
-  PlatformAgentSessionSummary,
-  PlatformAgentSessionToolPolicy,
-  PlatformAgentUiRunState,
-  PlatformAgentUiToolCall,
-  PlatformCreateAgentSessionRequest,
-  PlatformListAgentSessionsRequest,
-  PlatformReadAgentSessionRequest,
-  PlatformUpdateAgentSessionRequest,
-} from './agentTypes.js'
-
-export type {
-  PlatformAgentRunEvent,
-  PlatformAgentRunSnapshot,
-  PlatformAgentRunContext,
-  PlatformAgentRunUsage,
-  PlatformAgentLlmMenuOption,
-  PlatformCallAgentModelRequest,
-  PlatformInterruptAgentSessionRequest,
-  PlatformReadAgentLlmMenuOptionsRequest,
-  PlatformReadAgentRunContextRequest,
-  PlatformResolveAgentToolCallsRequest,
-  PlatformSendAgentRunMessageRequest,
-  PlatformStartAgentRunRequest,
-  PlatformAgentSessionDriveRequest,
-  PlatformAgentSessionDriveResult,
-  PlatformRejectAgentSessionToolsRequest,
-  PlatformSendAgentSessionMessageRequest,
-  PlatformLocalModelRuntimeStatus,
-  PlatformToolResolution,
-} from './agentTypes.js'
+export {
+  advanceAgentSessionPending,
+  approveAgentSessionTools,
+  callAgentRunModel,
+  callLowModelJson,
+  cancelAgentJob,
+  createAgentJob,
+  createAgentSession,
+  deleteAgentSession,
+  interruptAgentSession,
+  listAgentJobs,
+  listAgentSessions,
+  onAgentRunEvent,
+  onAgentToolInvoke,
+  readAgentJob,
+  readAgentLlmMenuOptions,
+  readAgentRunContext,
+  readAgentSession,
+  readLocalModelsStatus,
+  registerAgentTools,
+  rejectAgentSessionTools,
+  resolveAgentRunToolCalls,
+  runAgentJobNow,
+  sendAgentRunMessage,
+  sendAgentSessionMessage,
+  startAgentRun,
+  updateAgentSession,
+} from './agents.mjs'
+export type {
+  PlatformAgentMessage,
+  PlatformAgentMessageAttachment,
+  PlatformAgentJobRecord,
+  PlatformAgentJobSchedule,
+  PlatformAgentJobStatus,
+  PlatformAgentImageAttachment,
+  PlatformAgentSessionConfig,
+  PlatformAgentSessionConfigPatch,
+  PlatformAgentSessionMetadata,
+  PlatformAgentSessionRecord,
+  PlatformAgentSessionScope,
+  PlatformAgentSessionSnapshot,
+  PlatformAgentSessionSummary,
+  PlatformAgentSessionToolPolicy,
+  PlatformAgentUiRunState,
+  PlatformAgentUiToolCall,
+  PlatformCancelAgentJobRequest,
+  PlatformCreateAgentSessionRequest,
+  PlatformCreateAgentJobRequest,
+  PlatformListAgentSessionsRequest,
+  PlatformListAgentJobsRequest,
+  PlatformReadAgentJobRequest,
+  PlatformReadAgentSessionRequest,
+  PlatformUpdateAgentSessionRequest,
+} from './agentTypes.js'
+
+export type {
+  PlatformAgentRunEvent,
+  PlatformAgentRunSnapshot,
+  PlatformAgentRunContext,
+  PlatformAgentRunUsage,
+  PlatformAgentLlmMenuOption,
+  PlatformCallAgentModelRequest,
+  PlatformInterruptAgentSessionRequest,
+  PlatformReadAgentLlmMenuOptionsRequest,
+  PlatformReadAgentRunContextRequest,
+  PlatformResolveAgentToolCallsRequest,
+  PlatformSendAgentRunMessageRequest,
+  PlatformStartAgentRunRequest,
+  PlatformAgentSessionDriveRequest,
+  PlatformAgentSessionDriveResult,
+  PlatformRejectAgentSessionToolsRequest,
+  PlatformSendAgentSessionMessageRequest,
+  PlatformLocalModelRuntimeStatus,
+  PlatformLowModelJsonRequest,
+  PlatformLowModelJsonResponse,
+  PlatformToolResolution,
+} from './agentTypes.js'

package/src/bridge/appSettings.d.mts

@@ -1,9 +1,9 @@
-import type { PlatformAppSettingsUpdateRequest } from './types.js'
-
-export function getPlatformAppSettings(
-  appSlug: string,
-): Promise<Record<string, unknown>>
-
-export function updatePlatformAppSettings(
-  request: PlatformAppSettingsUpdateRequest,
-): Promise<Record<string, unknown>>
+import type { PlatformAppSettingsUpdateRequest } from './types.js'
+
+export function getPlatformAppSettings(
+  appSlug: string,
+): Promise<Record<string, unknown>>
+
+export function updatePlatformAppSettings(
+  request: PlatformAppSettingsUpdateRequest,
+): Promise<Record<string, unknown>>

package/src/bridge/appSettings.mjs

@@ -1,18 +1,18 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * @param {string} appSlug
- * @returns {Promise<Record<string, unknown>>}
- */
-export async function getPlatformAppSettings(appSlug) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.SETTINGS_APP_GET, [appSlug])
-}
-
-/**
- * @param {import('./types.ts').PlatformAppSettingsUpdateRequest} request
- * @returns {Promise<Record<string, unknown>>}
- */
-export async function updatePlatformAppSettings(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.SETTINGS_APP_UPDATE, [request])
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * @param {string} appSlug
+ * @returns {Promise<Record<string, unknown>>}
+ */
+export async function getPlatformAppSettings(appSlug) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.SETTINGS_APP_GET, [appSlug])
+}
+
+/**
+ * @param {import('./types.ts').PlatformAppSettingsUpdateRequest} request
+ * @returns {Promise<Record<string, unknown>>}
+ */
+export async function updatePlatformAppSettings(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.SETTINGS_APP_UPDATE, [request])
+}

package/src/bridge/appSettings.ts

@@ -1,4 +1,4 @@
-export {
-  getPlatformAppSettings,
-  updatePlatformAppSettings,
-} from './appSettings.mjs'
+export {
+  getPlatformAppSettings,
+  updatePlatformAppSettings,
+} from './appSettings.mjs'

package/src/bridge/applyThemeFromHost.d.mts

@@ -1,7 +1,7 @@
-import type { PlatformThemeBridgePayload } from './types.js'
-
-export declare const PLATFORM_THEME_STYLE_ID: 'platform-theme-vars-embedded'
-
-export function applyThemeFromHost(
-  payload: PlatformThemeBridgePayload | null | undefined,
-): void
+import type { PlatformThemeBridgePayload } from './types.js'
+
+export declare const PLATFORM_THEME_STYLE_ID: 'platform-theme-vars-embedded'
+
+export function applyThemeFromHost(
+  payload: PlatformThemeBridgePayload | null | undefined,
+): void

package/src/bridge/applyThemeFromHost.mjs

@@ -1,33 +1,33 @@
-/** Injected into plugin iframe documents (cross-origin safe via bridge). */
-import { injectAppFrameDocumentStyles } from '../theme/utils/appFrameDocumentStyles.mjs'
-
-export const PLATFORM_THEME_STYLE_ID = 'platform-theme-vars-embedded'
-
-/**
- * @param {{ mode?: string, css?: string } | null | undefined} payload
- */
-export function applyThemeFromHost(payload) {
-  if (!payload || typeof payload.css !== 'string' || !payload.css.trim()) return
-
-  let el = document.getElementById(PLATFORM_THEME_STYLE_ID)
-  if (!el) {
-    el = document.createElement('style')
-    el.id = PLATFORM_THEME_STYLE_ID
-    document.head.appendChild(el)
-  }
-  el.textContent = payload.css
-
-  const root = document.documentElement
-  if (typeof payload.mode === 'string') {
-    root.dataset.platformTheme = payload.mode
-  }
-
-  const paletteId = payload.surfacePaletteId
-  if (typeof paletteId === 'string' && paletteId.trim()) {
-    root.dataset.platformSurfacePalette = paletteId.trim()
-  } else {
-    delete root.dataset.platformSurfacePalette
-  }
-
-  injectAppFrameDocumentStyles()
-}
+/** Injected into plugin iframe documents (cross-origin safe via bridge). */
+import { injectAppFrameDocumentStyles } from '../theme/utils/appFrameDocumentStyles.mjs'
+
+export const PLATFORM_THEME_STYLE_ID = 'platform-theme-vars-embedded'
+
+/**
+ * @param {{ mode?: string, css?: string } | null | undefined} payload
+ */
+export function applyThemeFromHost(payload) {
+  if (!payload || typeof payload.css !== 'string' || !payload.css.trim()) return
+
+  let el = document.getElementById(PLATFORM_THEME_STYLE_ID)
+  if (!el) {
+    el = document.createElement('style')
+    el.id = PLATFORM_THEME_STYLE_ID
+    document.head.appendChild(el)
+  }
+  el.textContent = payload.css
+
+  const root = document.documentElement
+  if (typeof payload.mode === 'string') {
+    root.dataset.platformTheme = payload.mode
+  }
+
+  const paletteId = payload.surfacePaletteId
+  if (typeof paletteId === 'string' && paletteId.trim()) {
+    root.dataset.platformSurfacePalette = paletteId.trim()
+  } else {
+    delete root.dataset.platformSurfacePalette
+  }
+
+  injectAppFrameDocumentStyles()
+}

package/src/bridge/assets.d.mts

@@ -1,66 +1,66 @@
-import type {
-  PlatformAssetContext,
-  PlatformAssetDeleteRequest,
-  PlatformAssetGetContextRequest,
-  PlatformAssetListScopedRequest,
-  PlatformAssetReferenceSwapRequest,
-  PlatformAssetReferenceSwapScopedRequest,
-  PlatformAssetReferenceSwapResult,
-  PlatformAssetSelection,
-  PlatformAssetSourceUpdateRequest,
-  PlatformAssetSourceUpdateScopedRequest,
-  PlatformAssetSummary,
-  PlatformAssetTransformRequest,
-  PlatformAssetUpdateRequest,
-  PlatformAssetVersionCreateRequest,
-} from './types.js'
-
-export declare function listCollectionAssets(
-  collectionPath: string,
-): Promise<PlatformAssetSummary[]>
-
-export declare function listScopedCollectionAssets(
-  request: PlatformAssetListScopedRequest,
-): Promise<PlatformAssetSummary[]>
-
-export declare function deleteCollectionAsset(
-  request: PlatformAssetDeleteRequest,
-): Promise<boolean>
-
-export declare function updateCollectionAsset(
-  request: PlatformAssetUpdateRequest,
-): Promise<PlatformAssetSummary>
-
-export declare function updateCollectionAssetSource(
-  request: PlatformAssetSourceUpdateRequest,
-): Promise<PlatformAssetSummary>
-
-export declare function updateCollectionAssetSourceScoped(
-  request: PlatformAssetSourceUpdateScopedRequest,
-): Promise<PlatformAssetSummary>
-
-export declare function getSelectedCollectionAsset(): Promise<PlatformAssetSelection | null>
-
-export declare function setSelectedCollectionAsset(
-  selection: PlatformAssetSelection | null,
-): Promise<boolean>
-
-export declare function createCollectionAssetVersion(
-  request: PlatformAssetVersionCreateRequest,
-): Promise<PlatformAssetSummary>
-
-export declare function swapCollectionAssetReferences(
-  request: PlatformAssetReferenceSwapRequest,
-): Promise<PlatformAssetReferenceSwapResult>
-
-export declare function swapCollectionAssetReferencesScoped(
-  request: PlatformAssetReferenceSwapScopedRequest,
-): Promise<PlatformAssetReferenceSwapResult>
-
-export declare function transformCollectionAsset(
-  request: PlatformAssetTransformRequest,
-): Promise<PlatformAssetSummary>
-
-export declare function getCollectionAssetContext(
-  request: PlatformAssetGetContextRequest,
-): Promise<PlatformAssetContext | null>
+import type {
+  PlatformAssetContext,
+  PlatformAssetDeleteRequest,
+  PlatformAssetGetContextRequest,
+  PlatformAssetListScopedRequest,
+  PlatformAssetReferenceSwapRequest,
+  PlatformAssetReferenceSwapScopedRequest,
+  PlatformAssetReferenceSwapResult,
+  PlatformAssetSelection,
+  PlatformAssetSourceUpdateRequest,
+  PlatformAssetSourceUpdateScopedRequest,
+  PlatformAssetSummary,
+  PlatformAssetTransformRequest,
+  PlatformAssetUpdateRequest,
+  PlatformAssetVersionCreateRequest,
+} from './types.js'
+
+export declare function listCollectionAssets(
+  collectionPath: string,
+): Promise<PlatformAssetSummary[]>
+
+export declare function listScopedCollectionAssets(
+  request: PlatformAssetListScopedRequest,
+): Promise<PlatformAssetSummary[]>
+
+export declare function deleteCollectionAsset(
+  request: PlatformAssetDeleteRequest,
+): Promise<boolean>
+
+export declare function updateCollectionAsset(
+  request: PlatformAssetUpdateRequest,
+): Promise<PlatformAssetSummary>
+
+export declare function updateCollectionAssetSource(
+  request: PlatformAssetSourceUpdateRequest,
+): Promise<PlatformAssetSummary>
+
+export declare function updateCollectionAssetSourceScoped(
+  request: PlatformAssetSourceUpdateScopedRequest,
+): Promise<PlatformAssetSummary>
+
+export declare function getSelectedCollectionAsset(): Promise<PlatformAssetSelection | null>
+
+export declare function setSelectedCollectionAsset(
+  selection: PlatformAssetSelection | null,
+): Promise<boolean>
+
+export declare function createCollectionAssetVersion(
+  request: PlatformAssetVersionCreateRequest,
+): Promise<PlatformAssetSummary>
+
+export declare function swapCollectionAssetReferences(
+  request: PlatformAssetReferenceSwapRequest,
+): Promise<PlatformAssetReferenceSwapResult>
+
+export declare function swapCollectionAssetReferencesScoped(
+  request: PlatformAssetReferenceSwapScopedRequest,
+): Promise<PlatformAssetReferenceSwapResult>
+
+export declare function transformCollectionAsset(
+  request: PlatformAssetTransformRequest,
+): Promise<PlatformAssetSummary>
+
+export declare function getCollectionAssetContext(
+  request: PlatformAssetGetContextRequest,
+): Promise<PlatformAssetContext | null>

package/src/bridge/assets.mjs

@@ -1,121 +1,121 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * List file + inline assets for a writer workspace or `.document` package root.
- * Requires `assets` permission in plugin.json.
- *
- * @param {string} collectionPath Absolute path to the collection root
- * @returns {Promise<import('./types.js').PlatformAssetSummary[]>}
- */
-export async function listCollectionAssets(collectionPath) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_LIST, [collectionPath])
-}
-
-/**
- * List assets when the app supplies manifest-known document paths (e.g. book chapters).
- * Requires `assets` permission in plugin.json.
- *
- * @param {import('./types.js').PlatformAssetListScopedRequest} request
- * @returns {Promise<import('./types.js').PlatformAssetSummary[]>}
- */
-export async function listScopedCollectionAssets(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_LIST_SCOPED, [request])
-}
-
-/**
- * @param {import('./types.js').PlatformAssetDeleteRequest} request
- * @returns {Promise<boolean>}
- */
-export async function deleteCollectionAsset(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_DELETE, [request])
-}
-
-/**
- * @param {import('./types.js').PlatformAssetUpdateRequest} request
- * @returns {Promise<import('./types.js').PlatformAssetSummary>}
- */
-export async function updateCollectionAsset(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_UPDATE, [request])
-}
-
-/**
- * Update inline mermaid / table / math source in document HTML.
- *
- * @param {import('./types.js').PlatformAssetSourceUpdateRequest} request
- * @returns {Promise<import('./types.js').PlatformAssetSummary>}
- */
-export async function updateCollectionAssetSource(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_UPDATE_SOURCE, [request])
-}
-
-/**
- * Update inline mermaid / table / math source when the app supplies document paths.
- *
- * @param {import('./types.js').PlatformAssetSourceUpdateScopedRequest} request
- * @returns {Promise<import('./types.js').PlatformAssetSummary>}
- */
-export async function updateCollectionAssetSourceScoped(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_UPDATE_SOURCE_SCOPED, [
-    request,
-  ])
-}
-
-/** @returns {Promise<import('./types.js').PlatformAssetSelection | null>} */
-export async function getSelectedCollectionAsset() {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_GET_SELECTED, [])
-}
-
-/**
- * @param {import('./types.js').PlatformAssetSelection | null} selection
- * @returns {Promise<boolean>}
- */
-export async function setSelectedCollectionAsset(selection) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_SET_SELECTED, [selection])
-}
-
-/**
- * @param {import('./types.js').PlatformAssetVersionCreateRequest} request
- * @returns {Promise<import('./types.js').PlatformAssetSummary>}
- */
-export async function createCollectionAssetVersion(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_CREATE_VERSION, [request])
-}
-
-/**
- * @param {import('./types.js').PlatformAssetReferenceSwapRequest} request
- * @returns {Promise<import('./types.js').PlatformAssetReferenceSwapResult>}
- */
-export async function swapCollectionAssetReferences(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_SWAP_REFERENCES, [request])
-}
-
-/**
- * Swap asset references when the app supplies document paths for collection scope.
- *
- * @param {import('./types.js').PlatformAssetReferenceSwapScopedRequest} request
- * @returns {Promise<import('./types.js').PlatformAssetReferenceSwapResult>}
- */
-export async function swapCollectionAssetReferencesScoped(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_SWAP_REFERENCES_SCOPED, [
-    request,
-  ])
-}
-
-/**
- * Local quick-variant transform (filter / rotate / flip) → new version in lineage.
- *
- * @param {import('./types.js').PlatformAssetTransformRequest} request
- * @returns {Promise<import('./types.js').PlatformAssetSummary>}
- */
-export async function transformCollectionAsset(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_TRANSFORM, [request])
-}
-
-/**
- * @param {import('./types.js').PlatformAssetGetContextRequest} request
- * @returns {Promise<import('./types.js').PlatformAssetContext | null>}
- */
-export async function getCollectionAssetContext(request) {
-  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_GET_CONTEXT, [request])
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * List file + inline assets for a writer workspace or `.document` package root.
+ * Requires `assets` permission in plugin.json.
+ *
+ * @param {string} collectionPath Absolute path to the collection root
+ * @returns {Promise<import('./types.js').PlatformAssetSummary[]>}
+ */
+export async function listCollectionAssets(collectionPath) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_LIST, [collectionPath])
+}
+
+/**
+ * List assets when the app supplies manifest-known document paths (e.g. book chapters).
+ * Requires `assets` permission in plugin.json.
+ *
+ * @param {import('./types.js').PlatformAssetListScopedRequest} request
+ * @returns {Promise<import('./types.js').PlatformAssetSummary[]>}
+ */
+export async function listScopedCollectionAssets(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_LIST_SCOPED, [request])
+}
+
+/**
+ * @param {import('./types.js').PlatformAssetDeleteRequest} request
+ * @returns {Promise<boolean>}
+ */
+export async function deleteCollectionAsset(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_DELETE, [request])
+}
+
+/**
+ * @param {import('./types.js').PlatformAssetUpdateRequest} request
+ * @returns {Promise<import('./types.js').PlatformAssetSummary>}
+ */
+export async function updateCollectionAsset(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_UPDATE, [request])
+}
+
+/**
+ * Update inline mermaid / table / math source in document HTML.
+ *
+ * @param {import('./types.js').PlatformAssetSourceUpdateRequest} request
+ * @returns {Promise<import('./types.js').PlatformAssetSummary>}
+ */
+export async function updateCollectionAssetSource(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_UPDATE_SOURCE, [request])
+}
+
+/**
+ * Update inline mermaid / table / math source when the app supplies document paths.
+ *
+ * @param {import('./types.js').PlatformAssetSourceUpdateScopedRequest} request
+ * @returns {Promise<import('./types.js').PlatformAssetSummary>}
+ */
+export async function updateCollectionAssetSourceScoped(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_UPDATE_SOURCE_SCOPED, [
+    request,
+  ])
+}
+
+/** @returns {Promise<import('./types.js').PlatformAssetSelection | null>} */
+export async function getSelectedCollectionAsset() {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_GET_SELECTED, [])
+}
+
+/**
+ * @param {import('./types.js').PlatformAssetSelection | null} selection
+ * @returns {Promise<boolean>}
+ */
+export async function setSelectedCollectionAsset(selection) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_SET_SELECTED, [selection])
+}
+
+/**
+ * @param {import('./types.js').PlatformAssetVersionCreateRequest} request
+ * @returns {Promise<import('./types.js').PlatformAssetSummary>}
+ */
+export async function createCollectionAssetVersion(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_CREATE_VERSION, [request])
+}
+
+/**
+ * @param {import('./types.js').PlatformAssetReferenceSwapRequest} request
+ * @returns {Promise<import('./types.js').PlatformAssetReferenceSwapResult>}
+ */
+export async function swapCollectionAssetReferences(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_SWAP_REFERENCES, [request])
+}
+
+/**
+ * Swap asset references when the app supplies document paths for collection scope.
+ *
+ * @param {import('./types.js').PlatformAssetReferenceSwapScopedRequest} request
+ * @returns {Promise<import('./types.js').PlatformAssetReferenceSwapResult>}
+ */
+export async function swapCollectionAssetReferencesScoped(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_SWAP_REFERENCES_SCOPED, [
+    request,
+  ])
+}
+
+/**
+ * Local quick-variant transform (filter / rotate / flip) → new version in lineage.
+ *
+ * @param {import('./types.js').PlatformAssetTransformRequest} request
+ * @returns {Promise<import('./types.js').PlatformAssetSummary>}
+ */
+export async function transformCollectionAsset(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_TRANSFORM, [request])
+}
+
+/**
+ * @param {import('./types.js').PlatformAssetGetContextRequest} request
+ * @returns {Promise<import('./types.js').PlatformAssetContext | null>}
+ */
+export async function getCollectionAssetContext(request) {
+  return bridge.call(PLATFORM_BRIDGE_METHODS.ASSETS_GET_CONTEXT, [request])
+}