@deepseek-ai/dsh-compaction-image-offload 0.2.2-rc.1 → 0.2.2-rc.3

package/lib/types/image-offload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-offload.d.ts","sourceRoot":"","sources":["../../src/image-offload.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAG/E,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAGnE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA8BpH"}

package/lib/types/image-offload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-offload.js","sourceRoot":"","sources":["../../src/image-offload.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAM/E;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,eAAsC,EAAE,KAAa;IACzG,MAAM,OAAO,GAAyB,EAAE,CAAA;IACxC,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,IAAI,KAAK,KAAK,CAAC;YAAE,MAAK;QACtB,kGAAkG;QAClG,sFAAsF;QACtF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAE,CAAA;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;YAAE,SAAQ;QAC3E,uGAAuG;QACvG,MAAM,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAE,CAAA;QAClD,MAAM,YAAY,GAAa,EAAE,CAAA;QACjC,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,MAAM,KAAK,GAAG,CAAC,MAA+B,EAAQ,EAAE;YACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,KAAK,KAAK,CAAC;oBAAE,MAAK;gBACtB,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC3B,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;wBAC7B,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;wBAC7B,KAAK,IAAI,CAAC,CAAA;oBACZ,CAAC;oBACD,UAAU,IAAI,CAAC,CAAA;gBACjB,CAAC;YACH,CAAC;QACH,CAAC,CAAA;QACD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACtB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAA;IAClE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAA;AACb,CAAC"}

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAOlD,eAAO,MAAM,IAAI,6BAA6B,CAAA;AAC9C,eAAO,MAAM,MAAM,UAAyB,CAAA;AAE5C;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAgBxC"}

package/lib/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,2BAA2B,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAExD,MAAM,CAAC,MAAM,IAAI,GAAG,0BAA0B,CAAA;AAC9C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;AAE5C;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,CAAA;IAC9D,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAA+B,EAAE;QAC9F,IAAI,OAAO,CAAC,IAAI,KAAK,2BAA2B,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,IAAI,EAAE,CAAA;QACxH,qGAAqG;QACrG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC;YAAE,OAAO,IAAI,EAAE,CAAA;QAC1G,OAAO,OAAO,CAAC,OAAO,CAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IACF,GAAG,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE;QACvF,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC;eAC3B,KAAK,CAAC,IAAI,KAAK,2BAA2B;eAC1C,KAAK,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;YAAE,OAAO,IAAI,EAAE,CAAA;QAC7D,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;YAAE,OAAO,IAAI,EAAE,CAAA;QAC9F,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/lib/types/project-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-message.d.ts","sourceRoot":"","sources":["../../src/project-message.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,KAAK,EAAgB,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAGjE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAuB1F"}

package/lib/types/project-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-message.js","sourceRoot":"","sources":["../../src/project-message.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAGhF,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,OAA0B;IAC/E,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,MAAM,KAAK,GAAG,CAAC,MAA+B,EAAkB,EAAE;QAChE,IAAI,IAAgC,CAAA;QACpC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,IAAI,SAAS,GAAG,KAAK,CAAA;YACrB,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC3B,IAAI,UAAU,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACrC,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI;wBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,uBAAuB,CAAC,CAAA;oBAC9G,SAAS,GAAG,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;oBACzC,QAAQ,IAAI,CAAC,CAAA;gBACf,CAAC;gBACD,UAAU,IAAI,CAAC,CAAA;YACjB,CAAC;YACD,IAAI,SAAS,KAAK,KAAK;gBAAE,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;YACxD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QACvB,CAAC;QACD,OAAO,IAAI,IAAI,MAAwB,CAAA;IACzC,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,QAAQ,KAAK,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IAClH,OAAO,UAAU,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;AAC5C,CAAC"}

package/lib/types/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/projection.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAGnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAGhF,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,GAAG,EAAE,UAAU,CAAA;IACf,yEAAyE;IACzE,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,OAAO,QAAQ,gCAAgC,CAAC;IAC9C,UAAU,eAAe;QACvB;;;;;;WAMG;QACH,eAAe,EAAE;YAAE,OAAO,EAAE,kBAAkB,EAAE,CAAA;SAAE,CAAA;KACnD;CACF;AAYD,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,EAAE,wBAAwB,CAAC,eAAe,CAkC5E,CAAA"}

package/lib/types/projection.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-compaction-image-offload",
   "description": "Durable image offload for image-capable routes: replace over-budget request images with placeholders and retry",
-  "version": "0.2.2-rc.1",
+  "version": "0.2.2-rc.3",
   "publishConfig": {
     "access": "public"
   },
@@ -29,31 +29,34 @@
     "locale/*.json",
     "lib/index.js",
     "lib/types/**/*.js",
-    "lib/types/**/*.d.ts"
+    "lib/types/**/*.d.ts",
+    "lib/types/**/*.d.ts.map",
+    "lib/**/*.js.map",
+    "src"
   ],
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.1.0",
-    "@deepseek-ai/dsh-agent": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-compaction": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-llm": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-session": "0.2.2-rc.1"
+    "@deepseek-ai/dsh-agent": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-compaction": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-llm": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-session": "0.2.2-rc.3"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "~4.1.0",
-    "@deepseek-ai/dsh-agent": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-agent-loop": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-attachment": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-compaction": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-compaction-basic": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-llm": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-llm-deepseek": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-session": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.2-rc.1",
-    "@deepseek-ai/dsh-token-meter": "0.2.2-rc.1"
+    "@deepseek-ai/dsh-agent": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-agent-loop": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-attachment": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-compaction": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-compaction-basic": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-llm": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-llm-deepseek": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-session": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-session-projection": "0.2.2-rc.3",
+    "@deepseek-ai/dsh-token-meter": "0.2.2-rc.3"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-util-values": "0.2.2-rc.1"
+    "@deepseek-ai/dsh-util-values": "0.2.2-rc.3"
   }
 }

package/src/image-offload.ts

@@ -0,0 +1,46 @@
+/** Select and log permanent image omissions in current model-request order. */
+
+import type { ContentBlock } from '@deepseek-ai/dsh-llm'
+import type { Session, SessionSeq } from '@deepseek-ai/dsh-session'
+import type { ImageOffloadTarget } from './projection.ts'
+
+/**
+ * Record one decision omitting the oldest retained input-image occurrences.
+ * Assistant nodes carry model output and are excluded. Image indexes count
+ * every occurrence, including previously offloaded ones, within each message.
+ * @param session - session whose next request applies the decision.
+ * @param sourceEventSeqs - input message events in the failed request's order.
+ * @param count - additional retained occurrences the adapter needs omitted.
+ * @returns whether any occurrence remained to offload.
+ */
+export function offloadOldestImages(session: Session, sourceEventSeqs: readonly SessionSeq[], count: number): boolean {
+  const targets: ImageOffloadTarget[] = []
+  for (const seq of sourceEventSeqs) {
+    if (count === 0) break
+    // Existing Session history read; migration deferred. Current surface nodes index the durable log.
+    // oxlint-disable-next-line typescript/no-non-null-assertion, typescript/no-deprecated
+    const event = session.eventAt(seq)!
+    if (event.type !== 'user/message' && event.type !== 'tool/result') continue
+    // oxlint-disable-next-line typescript/no-non-null-assertion -- both input node types produce a message
+    const message = session.deriveEventMessage(event)!
+    const imageIndexes: number[] = []
+    let imageIndex = 0
+    const visit = (blocks: readonly ContentBlock[]): void => {
+      for (const block of blocks) {
+        if (count === 0) break
+        if (block.type === 'image') {
+          if (block.offloaded !== true) {
+            imageIndexes.push(imageIndex)
+            count -= 1
+          }
+          imageIndex += 1
+        }
+      }
+    }
+    visit(message.content)
+    if (imageIndexes.length > 0) targets.push({ seq, imageIndexes })
+  }
+  if (targets.length === 0) return false
+  session.append('image/offload', { targets })
+  return true
+}

package/src/index.ts

@@ -0,0 +1,41 @@
+/**
+ * Image offload executor for the compaction seam. When an image-capable route
+ * fails a request with `IMAGE_OFFLOAD_REQUIRED`, the plugin records one
+ * `image/offload` decision selecting the oldest retained input occurrences
+ * and retries through the agent or compaction summary error waterfall. Every route
+ * sends placeholder text for those occurrences in subsequent requests.
+ *
+ * @module @deepseek-ai/dsh-compaction-image-offload
+ */
+
+import type { Context } from '@deepseek-ai/cordis'
+import type {} from '@deepseek-ai/dsh-compaction'
+import type { RequestErrorAction } from '@deepseek-ai/dsh-agent'
+import { IMAGE_OFFLOAD_REQUIRED_CODE, LlmError } from '@deepseek-ai/dsh-llm'
+import { offloadOldestImages } from './image-offload.ts'
+import { imageOffloadProjection } from './projection.ts'
+
+export const name = 'compaction-image-offload'
+export const inject = ['agents', 'sessions']
+
+/**
+ * Mount agent and summary recovery listeners without configuration.
+ * @param ctx - the plugin context.
+ */
+export function apply(ctx: Context): void {
+  ctx.sessions.registerMessageProjection(imageOffloadProjection)
+  ctx.on('agent/request-error', ({ agent, failure, signal }, next): Promise<RequestErrorAction> => {
+    if (failure.code !== IMAGE_OFFLOAD_REQUIRED_CODE || failure.offloadImages === undefined || signal.aborted) return next()
+    // A durable surface repair, not a provider retry: it spends no retry budget and logs no retry event.
+    if (!offloadOldestImages(agent.session, agent.session.surface.nodes, failure.offloadImages)) return next()
+    return Promise.resolve<RequestErrorAction>({ kind: 'retry' })
+  })
+  ctx.on('compaction/summary-error', ({ session, sourceEventSeqs, error, signal }, next) => {
+    if (!(error instanceof LlmError)
+      || error.code !== IMAGE_OFFLOAD_REQUIRED_CODE
+      || error.failure.offloadImages === undefined) return next()
+    signal?.throwIfAborted()
+    if (!offloadOldestImages(session, sourceEventSeqs, error.failure.offloadImages)) return next()
+    return true
+  })
+}

package/src/project-message.ts

@@ -0,0 +1,36 @@
+/** Immutable application of the image occurrences recorded by image/offload. */
+
+import type { ContentBlock, Message } from '@deepseek-ai/dsh-llm'
+import { deepFreeze } from '@deepseek-ai/dsh-util-values'
+
+/**
+ * Project selected image occurrences to immutable offloaded blocks.
+ * @param message - message projected before this decision.
+ * @param indexes - nonempty, strictly increasing depth-first image indexes.
+ * @returns an immutable message with the same identity and selected images marked.
+ * @throws when a selected occurrence is missing or already offloaded.
+ */
+export function offloadMessageImages(message: Message, indexes: readonly number[]): Message {
+  let imageIndex = 0
+  let selected = 0
+  const visit = (blocks: readonly ContentBlock[]): ContentBlock[] => {
+    let next: ContentBlock[] | undefined
+    for (const [index, block] of blocks.entries()) {
+      let projected = block
+      if (block.type === 'image') {
+        if (imageIndex === indexes[selected]) {
+          if (block.offloaded === true) throw new Error(`image/offload: image index ${imageIndex} is already offloaded`)
+          projected = { ...block, offloaded: true }
+          selected += 1
+        }
+        imageIndex += 1
+      }
+      if (projected !== block) next ??= blocks.slice(0, index)
+      next?.push(projected)
+    }
+    return next ?? blocks as ContentBlock[]
+  }
+  const content = visit(message.content)
+  if (selected !== indexes.length) throw new Error(`image/offload: image index ${indexes[selected]} does not exist`)
+  return deepFreeze({ ...message, content })
+}

package/src/projection.ts

@@ -0,0 +1,74 @@
+/** Browser-safe durable image selection declaration and pure replay definition. */
+
+import type { Message } from '@deepseek-ai/dsh-llm'
+import type { SessionSeq } from '@deepseek-ai/dsh-session/types'
+import type { SessionMessageProjection } from '@deepseek-ai/dsh-session/surface'
+import { offloadMessageImages } from './project-message.ts'
+
+/** Exact input-image occurrences selected by one durable offload decision. */
+export interface ImageOffloadTarget {
+  /** Current message-producing event containing these occurrences. */
+  seq: SessionSeq
+  /** Zero-based depth-first image indexes within the immutable message. */
+  imageIndexes: number[]
+}
+
+declare module '@deepseek-ai/dsh-session/types' {
+  interface SessionEventMap {
+    /**
+     * Permanently omit selected input-image occurrences from subsequent model requests.
+     * Targets name unique current user/message or tool/result nodes. Nonempty, strictly
+     * increasing indexes count all images in depth-first order, including nested tool
+     * results and already omitted images. Message nodes and identities remain unchanged.
+     * @messageProjection
+     */
+    'image/offload': { targets: ImageOffloadTarget[] }
+  }
+}
+
+/** Whether a durable value is a JSON object. */
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
+/** Whether a durable occurrence index or sequence is canonical. */
+function isIndex(value: unknown): value is SessionSeq {
+  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 && !Object.is(value, -0)
+}
+
+/** Atomic validation and reconstruction shared by live sessions and detached replay. */
+export const imageOffloadProjection: SessionMessageProjection<'image/offload'> = {
+  type: 'image/offload',
+  project(event, context) {
+    const data: unknown = event.data
+    if (!isRecord(data) || Object.keys(data).length !== 1 || !Array.isArray(data['targets']) || data['targets'].length === 0) {
+      throw new Error('image/offload: data must contain a nonempty targets array')
+    }
+    const messages = new Map<SessionSeq, Message>()
+    const nodes = new Set(context.nodes)
+    for (const target of data['targets'] as unknown[]) {
+      if (!isRecord(target) || Object.keys(target).length !== 2 || !isIndex(target['seq'])
+        || !Array.isArray(target['imageIndexes']) || target['imageIndexes'].length === 0) {
+        throw new Error('image/offload: each target must contain a seq and nonempty imageIndexes')
+      }
+      const seq = target['seq']
+      if (messages.has(seq)) throw new Error(`image/offload: duplicate target seq ${seq}`)
+      if (!nodes.has(seq)) throw new Error(`image/offload: target seq ${seq} is not a current surface node`)
+      const source = context.events[seq - context.baseSeq]
+      if (source?.type !== 'user/message' && source?.type !== 'tool/result') {
+        throw new Error(`image/offload: target seq ${seq} must be user/message or tool/result`)
+      }
+      let previous = -1
+      for (const index of target['imageIndexes'] as unknown[]) {
+        if (!isIndex(index) || index <= previous) {
+          throw new Error('image/offload: imageIndexes must be strictly increasing non-negative safe integers')
+        }
+        previous = index
+      }
+      const message = context.messages.get(seq)
+        ?? (source.type === 'user/message' ? source.data : source.data.message)
+      messages.set(seq, offloadMessageImages(message, target['imageIndexes'] as number[]))
+    }
+    return messages
+  },
+}