@nomix-ai/nomix-harness 0.2.4 → 0.2.6

package/dist/kernel/attachment/lib/types/index.d.ts

@@ -1,10 +1,11 @@
 /** Durable attachment storage seam (`ctx.attachments`). @module @nomix-ai/nomix-attachment */
-import { Context, Service } from '@nomix-ai/cordis';
-import type { ImageAttachmentLimits, ImageAttachmentRef, SaveImageAttachment, StoredImageAttachment } from './types.ts';
-export { AttachmentId } from './brand.ts';
+import { Context, Service } from '../../../cordis/lib/index.js';
+import type { ImageAttachmentLimits, ImageAttachmentRef, ImageRequestPolicy, RequestImageAttachment, SaveImageAttachment, StoredImageAttachment } from './types.ts';
+export { AttachmentId, ImageVariantId } from './brand.ts';
 export { AttachmentError, isImageAdmissionError } from './error.ts';
 export type { AttachmentErrorCode, ImageAdmissionErrorCode } from './error.ts';
-export type { AttachmentId as AttachmentIdType, ImageAttachmentLimits, ImageAttachmentRef, ImageMediaType, SaveImageAttachment, StoredImageAttachment, } from './types.ts';
+export { admitEncodedImages } from './admission.ts';
+export type { AttachmentId as AttachmentIdType, EncodedImageAttachment, ImageAttachmentLimits, ImageAttachmentRef, ImageRequestPolicy, ImageMediaType, RequestImageAttachment, SaveImageAttachment, StoredImageAttachment, } from './types.ts';
 declare module '@nomix-ai/cordis' {
     interface Context {
         attachments: AttachmentStore;
@@ -30,21 +31,38 @@ export declare abstract class AttachmentStore extends Service {
      * @param inputs - encoded images in their owning message order.
      * @returns durable references in the exact input order.
      */
+    protected validateImageBatch(inputs: readonly SaveImageAttachment[]): void;
+    /**
+     * Validate and durably commit one ordered image batch.
+     * @param inputs - encoded images in owning-message order.
+     * @returns durable normalized attachment references in the same order after every member succeeds.
+     */
     saveImages(inputs: readonly SaveImageAttachment[]): Promise<readonly ImageAttachmentRef[]>;
     /**
      * Validate and durably commit one image before its owning session event is appended.
+     * The returned reference describes the persisted normalized image. When
+     * normalization reduces the raster, its `originalDimensions` records the
+     * orientation-applied input dimensions.
      * @param input - encoded bytes, declared media type, and optional display name.
-     * @returns a durable content-addressed reference.
+     * @returns the durable content-addressed normalized image reference.
      */
     abstract saveImage(input: SaveImageAttachment): Promise<ImageAttachmentRef>;
     /**
      * Read one image and verify that bytes still match the recorded reference.
      * @param ref - durable reference from the session log.
      * @param signal - optional cancellation for backend read and verification work.
-     * @returns the verified bytes and canonical reference.
+     * @returns the verified bytes and normalized attachment reference.
      * @throws the signal reason when aborted, or a storage error when verification fails.
      */
     abstract readImage(ref: ImageAttachmentRef, signal?: AbortSignal): Promise<StoredImageAttachment>;
+    /**
+     * Generate or read one deterministic model-request version from the stored normalized image.
+     * @param ref - durable provider-independent normalized attachment reference.
+     * @param policy - exact route pixel and encoded-byte budget.
+     * @param signal - optional cancellation.
+     * @returns request bytes and the cache/upload identity covering every transform input.
+     */
+    readImageRequest(ref: ImageAttachmentRef, policy: ImageRequestPolicy, signal?: AbortSignal): Promise<RequestImageAttachment>;
 }
 export default AttachmentStore;
 //# sourceMappingURL=index.d.ts.map

package/dist/kernel/attachment/lib/types/index.js

@@ -1,8 +1,9 @@
 /** Durable attachment storage seam (`ctx.attachments`). @module @nomix-ai/nomix-attachment */
-import { Service } from '@nomix-ai/cordis';
+import { Service } from '../../../cordis/lib/index.js';
 import { AttachmentError } from "./error.js";
-export { AttachmentId } from "./brand.js";
+export { AttachmentId, ImageVariantId } from "./brand.js";
 export { AttachmentError, isImageAdmissionError } from "./error.js";
+export { admitEncodedImages } from "./admission.js";
 /** Immutable binary attachment service. Implementations validate bytes before publishing a reference. */
 export class AttachmentStore extends Service {
     constructor(ctx) {
@@ -16,7 +17,7 @@ export class AttachmentStore extends Service {
      * @param inputs - encoded images in their owning message order.
      * @returns durable references in the exact input order.
      */
-    async saveImages(inputs) {
+    validateImageBatch(inputs) {
         const { maxImagesPerMessage, maxMessageImageBytes, mediaTypes } = this.imageLimits;
         if (inputs.length > maxImagesPerMessage) {
             throw new AttachmentError('Image batch exceeds the configured image-count limit.', 'TOO_MANY_IMAGES');
@@ -30,6 +31,14 @@ export class AttachmentStore extends Service {
                 throw new AttachmentError(`Image type ${input.mediaType} is not accepted by this deployment.`, 'UNSUPPORTED_IMAGE_TYPE');
             }
         }
+    }
+    /**
+     * Validate and durably commit one ordered image batch.
+     * @param inputs - encoded images in owning-message order.
+     * @returns durable normalized attachment references in the same order after every member succeeds.
+     */
+    async saveImages(inputs) {
+        this.validateImageBatch(inputs);
         for (const input of inputs)
             await this.validateImage(input);
         const refs = [];
@@ -37,6 +46,19 @@ export class AttachmentStore extends Service {
             refs.push(await this.saveImage(input));
         return refs;
     }
+    /**
+     * Generate or read one deterministic model-request version from the stored normalized image.
+     * @param ref - durable provider-independent normalized attachment reference.
+     * @param policy - exact route pixel and encoded-byte budget.
+     * @param signal - optional cancellation.
+     * @returns request bytes and the cache/upload identity covering every transform input.
+     */
+    readImageRequest(ref, policy, signal) {
+        signal?.throwIfAborted();
+        void ref;
+        void policy;
+        return Promise.reject(new AttachmentError('The mounted attachment provider cannot derive model-request images.', 'ATTACHMENT_PROJECTION_UNSUPPORTED'));
+    }
 }
 export default AttachmentStore;
 //# sourceMappingURL=index.js.map

package/dist/kernel/attachment/lib/types/invariant.d.ts

@@ -1,5 +1,5 @@
 /** Package-owned invariant companion for `@nomix-ai/nomix-attachment`. @module @nomix-ai/nomix-attachment/invariant */
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../cordis/lib/index.js';
 /** Cordis companion plugin name. */
 export declare const name = "attachment-invariant";
 /** Service required before package ownership can be reserved. */

package/dist/kernel/attachment/lib/types/types.d.ts

@@ -1,9 +1,9 @@
 /** Durable attachment vocabulary. @module @nomix-ai/nomix-attachment/types */
-import type { AttachmentId } from './brand.ts';
+import type { AttachmentId, ImageVariantId } from './brand.ts';
 export type { AttachmentId } from './brand.ts';
 /** Raster image formats accepted by the version-one attachment path. */
 export type ImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
-/** Durable, serializable metadata for one immutable image object. */
+/** Durable, serializable reference to one immutable normalized image. */
 export interface ImageAttachmentRef {
     /** Opaque storage identifier; never a filesystem path or bearer URL. */
     attachmentId: AttachmentId;
@@ -17,6 +17,14 @@ export interface ImageAttachmentRef {
     height: number;
     /** Optional display name stripped of local path information. */
     name?: string;
+    /**
+     * Input dimensions after applying EXIF orientation and before normalization
+     * scaling. Present only when normalization reduced the image.
+     */
+    originalDimensions?: {
+        width: number;
+        height: number;
+    };
 }
 /** Deployment-resolved limits used by upload admission and request buffering. */
 export interface ImageAttachmentLimits {
@@ -24,8 +32,19 @@ export interface ImageAttachmentLimits {
     maxImagesPerMessage: number;
     maxMessageImageBytes: number;
     maxImagePixels: number;
+    /** Maximum intrinsic width and maximum intrinsic height in pixels for one image. */
+    maxImageDimension: number;
     mediaTypes: readonly ImageMediaType[];
 }
+/** Base64-encoded image upload accompanying one wire request. */
+export interface EncodedImageAttachment {
+    /** Declared media type, verified against the decoded bytes during admission. */
+    mediaType: ImageMediaType;
+    /** Canonical base64 encoding of the image bytes. */
+    data: string;
+    /** Optional display name; it is never interpreted as a path. */
+    name?: string;
+}
 /** Request to validate and durably commit one image. */
 export interface SaveImageAttachment {
     data: Uint8Array;
@@ -39,4 +58,30 @@ export interface StoredImageAttachment {
     ref: ImageAttachmentRef;
     data: Uint8Array;
 }
+/** Deterministic request-image policy selected by one exact model route. */
+export interface ImageRequestPolicy {
+    /** Maximum width multiplied by height after aspect-preserving projection. */
+    maxPixels: number;
+    /** Encoded-byte cap before base64 expansion or Files API upload. */
+    maxBytes: number;
+}
+/** Cached request version derived from one provider-independent normalized attachment. */
+export interface RequestImageAttachment {
+    /** Cache and upload-index key over the attachment id, policy, and fixed encoder parameters. */
+    variantId: ImageVariantId;
+    /** Durable normalized attachment from which this request version was derived. */
+    attachment: ImageAttachmentRef;
+    /** Encoded request bytes. */
+    data: Uint8Array;
+    mediaType: ImageMediaType;
+    bytes: number;
+    width: number;
+    height: number;
+    /** Provider-compatible sample depth proven after request encoding. */
+    depth: 'uchar';
+    /** Provider-compatible color space proven after request encoding. */
+    space: 'srgb';
+    /** Whether the encoded request version retains an alpha channel. */
+    hasAlpha: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/kernel/attachment/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-attachment",
   "description": "Durable immutable attachment storage seam for the Nomix Harness",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },
@@ -16,10 +16,11 @@
   "exports": {
     ".": { "types": "./lib/types/index.d.ts", "default": "./lib/index.js" },
     "./invariant": { "types": "./lib/types/invariant.d.ts", "default": "./lib/invariant.js" },
+    "./types": { "types": "./lib/types/types.d.ts", "default": "./lib/types/types.js" },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
-  "files": ["lib/index.js", "lib/invariant.js", "lib/types/**/*.d.ts"],
+  "files": ["lib/index.js", "lib/invariant.js", "lib/types/**/*.js", "lib/types/**/*.d.ts"],
   "license": "MIT",
   "peerDependencies": {
     "@nomix-ai/nomix-brand": "workspace:^",