@deepseek-ai/dsh-attachment 0.1.2-alpha.2 → 0.1.2-alpha.3

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/attachment/attachment/README.md
-README.md: 01a5d6ee143ff53175dd7327cd6d419af61938a3
-README.zh.md: 1a1d297297a6815ce5338391af0182e471f99000
+README.md: 709189ac8dd9591d89c0b0082ea0ae0247c97f97
+README.zh.md: 24eee83874d2ad12025d4457f1fad74aadb73446

package/README.md

@@ -75,7 +75,7 @@ The service family runs one admission-and-storage flow: every entry point enforc
 |---|---|
 | [`src/index.ts`](src/index.ts) | Plugin entry: abstract `AttachmentStore` service and re-exports |
 | [`src/types.ts`](src/types.ts) | Durable vocabulary: references, limits, upload and store payloads |
-| [`src/admission.ts`](src/admission.ts) | `admitEncodedImages`: canonical-base64 enforcement, then `saveImages` delegation |
+| [`src/admission.ts`](src/admission.ts) | Browser prompt admission: canonical-base64 enforcement, `saveImages` delegation, and durable prompt-part projection |
 | [`src/error.ts`](src/error.ts) | `AttachmentError` class and the `isImageAdmissionError` runtime subset |
 | [`src/brand.ts`](src/brand.ts) | `AttachmentId` branded opaque identifier |
 | [`src/invariant.ts`](src/invariant.ts) | Invariant companion (no runtime invariant; implementations enforce immutable-store checks) |

package/README.zh.md

@@ -75,7 +75,7 @@ kind: "package-reference"
 |---|---|
 | [`src/index.ts`](src/index.ts) | 插件入口：抽象 `AttachmentStore` 服务与再导出 |
 | [`src/types.ts`](src/types.ts) | 持久词汇：引用、限额、上传与存储载荷 |
-| [`src/admission.ts`](src/admission.ts) | `admitEncodedImages`：规范 base64 强制，随后委托 `saveImages` |
+| [`src/admission.ts`](src/admission.ts) | 浏览器 prompt 准入：强制规范 base64、委托 `saveImages` 并投影持久 prompt part |
 | [`src/error.ts`](src/error.ts) | `AttachmentError` 类与 `isImageAdmissionError` 运行时子集 |
 | [`src/brand.ts`](src/brand.ts) | `AttachmentId` 带类型标记的不透明标识符 |
 | [`src/invariant.ts`](src/invariant.ts) | 不变式伴生插件（无运行时不变式；实现负责强制不可变存储检查） |

package/lib/index.js

@@ -93,6 +93,29 @@ function saveInput(image) {
 async function admitEncodedImages(attachments, images) {
 	return attachments.saveImages(images.map(saveInput));
 }
+/**
+* Admit one browser prompt and replace each uploaded image with its durable reference.
+* Text-only prompts do not access the attachment store.
+* @param attachments - the deployment attachment store owning batch policy.
+* @param content - browser prompt parts in message order.
+* @returns admitted prompt parts in the same order as `content`.
+* @throws AttachmentError when the image batch is refused.
+*/
+async function admitPromptContent(attachments, content) {
+	if (content.every((part) => part.type === "text")) return content.map((part) => ({
+		type: "text",
+		text: part.text
+	}));
+	const refs = await admitEncodedImages(attachments, content.filter((part) => part.type === "image"));
+	let next = 0;
+	return content.map((part) => part.type === "text" ? {
+		type: "text",
+		text: part.text
+	} : {
+		type: "image",
+		attachment: refs[next++]
+	});
+}
 //#endregion
 //#region lib/types/request-projection.js
 /**
@@ -189,4 +212,4 @@ var AttachmentStore = class extends Service {
 	}
 };
 //#endregion
-export { AttachmentError, AttachmentId, AttachmentStore, AttachmentStore as default, ImageVariantId, admitEncodedImages, isImageAdmissionError, requestImageDimensions };
+export { AttachmentError, AttachmentId, AttachmentStore, AttachmentStore as default, ImageVariantId, admitEncodedImages, admitPromptContent, isImageAdmissionError, requestImageDimensions };

package/lib/types/admission.d.ts

@@ -1,6 +1,6 @@
 /** Wire-form admission of base64-encoded image uploads. @module @deepseek-ai/dsh-attachment/admission */
 import type { AttachmentStore } from './index.ts';
-import type { EncodedImageAttachment, ImageAttachmentRef } from './types.ts';
+import type { AdmittedPromptContentPart, EncodedImageAttachment, ImageAttachmentRef, PromptContentPart } from './types.ts';
 /**
  * Admit one wire image batch: enforce canonical base64 on every member, then
  * delegate batch admission — count and aggregate-byte limits, media-type and
@@ -12,4 +12,13 @@ import type { EncodedImageAttachment, ImageAttachmentRef } from './types.ts';
  * @throws AttachmentError on a non-canonical payload or a refused batch.
  */
 export declare function admitEncodedImages(attachments: AttachmentStore, images: readonly EncodedImageAttachment[]): Promise<readonly ImageAttachmentRef[]>;
+/**
+ * Admit one browser prompt and replace each uploaded image with its durable reference.
+ * Text-only prompts do not access the attachment store.
+ * @param attachments - the deployment attachment store owning batch policy.
+ * @param content - browser prompt parts in message order.
+ * @returns admitted prompt parts in the same order as `content`.
+ * @throws AttachmentError when the image batch is refused.
+ */
+export declare function admitPromptContent(attachments: AttachmentStore, content: readonly PromptContentPart[]): Promise<AdmittedPromptContentPart[]>;
 //# sourceMappingURL=admission.d.ts.map

package/lib/types/admission.js

@@ -30,4 +30,23 @@ function saveInput(image) {
 export async function admitEncodedImages(attachments, images) {
     return attachments.saveImages(images.map(saveInput));
 }
+/**
+ * Admit one browser prompt and replace each uploaded image with its durable reference.
+ * Text-only prompts do not access the attachment store.
+ * @param attachments - the deployment attachment store owning batch policy.
+ * @param content - browser prompt parts in message order.
+ * @returns admitted prompt parts in the same order as `content`.
+ * @throws AttachmentError when the image batch is refused.
+ */
+export async function admitPromptContent(attachments, content) {
+    if (content.every(part => part.type === 'text')) {
+        return content.map(part => ({ type: 'text', text: part.text }));
+    }
+    const refs = await admitEncodedImages(attachments, content.filter(part => part.type === 'image'));
+    let next = 0;
+    return content.map(part => part.type === 'text'
+        ? { type: 'text', text: part.text }
+        // admitEncodedImages returns one reference per image part in order.
+        : { type: 'image', attachment: refs[next++] });
+}
 //# sourceMappingURL=admission.js.map

package/lib/types/index.d.ts

@@ -4,9 +4,9 @@ import type { ImageAttachmentLimits, ImageAttachmentRef, ImageRequestPolicy, Req
 export { AttachmentId, ImageVariantId } from './brand.ts';
 export { AttachmentError, isImageAdmissionError } from './error.ts';
 export type { AttachmentErrorCode, ImageAdmissionErrorCode } from './error.ts';
-export { admitEncodedImages } from './admission.ts';
+export { admitEncodedImages, admitPromptContent } from './admission.ts';
 export { requestImageDimensions } from './request-projection.ts';
-export type { AttachmentId as AttachmentIdType, EncodedImageAttachment, ImageAttachmentLimits, ImageAttachmentRef, ImageRequestPolicy, ImageMediaType, RequestImageAttachment, SaveImageAttachment, StoredImageAttachment, } from './types.ts';
+export type { AttachmentId as AttachmentIdType, AdmittedPromptContentPart, EncodedImageAttachment, ImageAttachmentLimits, ImageAttachmentRef, ImageRequestPolicy, ImageMediaType, PromptContentPart, RequestImageAttachment, SaveImageAttachment, StoredImageAttachment, } from './types.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         attachments: AttachmentStore;

package/lib/types/index.js

@@ -3,7 +3,7 @@ import { Service } from '@deepseek-ai/cordis';
 import { AttachmentError } from "./error.js";
 export { AttachmentId, ImageVariantId } from "./brand.js";
 export { AttachmentError, isImageAdmissionError } from "./error.js";
-export { admitEncodedImages } from "./admission.js";
+export { admitEncodedImages, admitPromptContent } from "./admission.js";
 export { requestImageDimensions } from "./request-projection.js";
 /** Immutable binary attachment service. Implementations validate bytes before publishing a reference. */
 export class AttachmentStore extends Service {

package/lib/types/types.d.ts

@@ -45,6 +45,29 @@ export interface EncodedImageAttachment {
     /** Optional display name; it is never interpreted as a path. */
     name?: string;
 }
+/**
+ * Browser-submitted prompt content accepted by Host prompt endpoints; the
+ * accepting Host promotes image parts to durable references through
+ * `admitPromptContent` before any message is created, so a wire caller can
+ * never cite an attachment it did not upload.
+ */
+export type PromptContentPart = {
+    readonly type: 'text';
+    readonly text: string;
+} | {
+    readonly type: 'image';
+    readonly mediaType: ImageMediaType;
+    readonly data: string;
+    readonly name?: string;
+};
+/** Host-admitted prompt content with each uploaded image replaced by its durable reference. */
+export type AdmittedPromptContentPart = {
+    readonly type: 'text';
+    readonly text: string;
+} | {
+    readonly type: 'image';
+    readonly attachment: ImageAttachmentRef;
+};
 /** Request to validate and durably commit one image. */
 export interface SaveImageAttachment {
     data: Uint8Array;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-attachment",
   "description": "Durable immutable attachment storage seam for the DeepSeek Harness",
-  "version": "0.1.2-alpha.2",
+  "version": "0.1.2-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -37,13 +37,13 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3",
+    "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3",
+    "@deepseek-ai/cordis": "^4.0.2"
   }
 }