@dcdr/contracts 2.2.0 → 2.3.1

package/dist/runtime.client.d.ts

@@ -1,4 +1,5 @@
-import { ExecuteIntentEvalRequest, ExecuteIntentEvalResponse, ExecuteIntentRequest, ExecuteIntentResponse, ExecutionStreamDeltaEvent, ExecutionStreamErrorEvent, ExecutionStreamFinalEvent, ExecutionStreamMetaEvent } from "./execution.contract";
+import { ExecutionInputPart, ExecutionPartType, ExecuteIntentEvalRequest, ExecuteIntentEvalResponse, ExecuteIntentRequest, ExecuteIntentResponse, ExecutionStreamDeltaEvent, ExecutionStreamErrorEvent, ExecutionStreamFinalEvent, ExecutionStreamMetaEvent } from "./execution.contract";
+import { DcdrAssetMetadata, DcdrAssetDeleteRequest, DcdrAssetDeleteResponse, DcdrAssetGetRequest, DcdrAssetGetResponse, DcdrAssetUploadRequest, DcdrAssetUploadResponse } from "./asset.contract";
 import { DcdrEntitlementsContract } from "./entitlements.contract";
 /**
  * Options for `DcdrRuntimeClient.executeIntentStream`.
@@ -9,6 +10,38 @@ export interface DcdrRuntimeClientStreamOptions {
     /** Optional abort signal for client-side cancellation. */
     signal?: AbortSignal;
 }
+/**
+ * Simplified client-side upload input.
+ */
+export interface DcdrRuntimeAssetUploadInput {
+    intent?: string;
+    partType?: ExecutionPartType;
+    mimeType?: string;
+    dataBase64: string;
+    name?: string;
+    metadata?: DcdrAssetMetadata;
+    storageId?: string;
+    assetCacheKey?: string;
+}
+/**
+ * Input used to build an asset-backed execution input part.
+ */
+export interface DcdrRuntimeAssetInputPartSource {
+    asset: DcdrAssetUploadResponse["asset"];
+    variableName?: string;
+    mimeType?: string;
+    name?: string;
+    partType?: ExecutionPartType;
+    sizeBytes?: number;
+}
+/**
+ * Builds a complete runtime upload payload from a simplified client request.
+ */
+export declare function prepareAssetUploadRequest(input: DcdrRuntimeAssetUploadInput): DcdrAssetUploadRequest;
+/**
+ * Converts a managed asset reference into an execution input part.
+ */
+export declare function prepareAssetInputPart(input: DcdrRuntimeAssetInputPartSource): ExecutionInputPart;
 /**
  * Runtime healthcheck response shape.
  *
@@ -222,6 +255,22 @@ export declare class DcdrRuntimeClient {
      * @returns Execution result.
      */
     executeIntent(intent: string, request: ExecuteIntentRequest): Promise<ExecuteIntentResponse>;
+    /**
+     * Calls `POST /api/assets/upload`.
+     *
+     * Notes
+     * - Cloud-only managed feature.
+     * - When `storageId` is omitted, runtime resolves the tenant default storage.
+     */
+    uploadAsset(request: DcdrRuntimeAssetUploadInput): Promise<DcdrAssetUploadResponse>;
+    /**
+     * Calls `GET /api/assets?assetPath=...&storageId=...`.
+     */
+    getAsset(request: DcdrAssetGetRequest): Promise<DcdrAssetGetResponse>;
+    /**
+     * Calls `DELETE /api/assets?assetPath=...&storageId=...`.
+     */
+    deleteAsset(request: DcdrAssetDeleteRequest): Promise<DcdrAssetDeleteResponse>;
     /**
      * Calls `POST /api/execution/stream/:intent` and yields SSE events.
      *
@@ -353,5 +402,9 @@ export declare class DcdrRuntimeClient {
      * HTTP method, path, status code, and a bounded preview of the response body.
      */
     private requestText;
+    /**
+     * Builds a stable query string for asset get/delete operations.
+     */
+    private buildAssetQuery;
 }
 //# sourceMappingURL=runtime.client.d.ts.map

package/dist/runtime.client.d.ts.map

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

package/dist/runtime.client.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DcdrRuntimeClient = exports.DcdrRuntimeAuthCheckEntitlementsStatus = void 0;
+exports.prepareAssetUploadRequest = prepareAssetUploadRequest;
+exports.prepareAssetInputPart = prepareAssetInputPart;
 const execution_contract_1 = require("./execution.contract");
 /**
  * Max characters to include when embedding a response body preview inside an Error message.
@@ -10,6 +12,88 @@ const execution_contract_1 = require("./execution.contract");
  * - Reduces the chance of leaking large/sensitive upstream HTML or debug payloads.
  */
 const ERROR_BODY_PREVIEW_MAX_CHARS = 4000;
+const DEFAULT_ASSET_UPLOAD_MIME_TYPE = "application/octet-stream";
+const EXTENSION_TO_MIME_TYPE = {
+    csv: "text/csv",
+    doc: "application/msword",
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    gif: "image/gif",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    json: "application/json",
+    m4a: "audio/mp4",
+    md: "text/markdown",
+    mov: "video/quicktime",
+    mp3: "audio/mpeg",
+    mp4: "video/mp4",
+    pdf: "application/pdf",
+    png: "image/png",
+    ppt: "application/vnd.ms-powerpoint",
+    pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    svg: "image/svg+xml",
+    txt: "text/plain",
+    wav: "audio/wav",
+    webm: "video/webm",
+    webp: "image/webp",
+    xls: "application/vnd.ms-excel",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+};
+/**
+ * Builds a complete runtime upload payload from a simplified client request.
+ */
+function prepareAssetUploadRequest(input) {
+    const name = normalizeOptionalString(input.name);
+    const mimeType = normalizeOptionalString(input.mimeType) ||
+        inferMimeTypeFromAssetName(name) ||
+        DEFAULT_ASSET_UPLOAD_MIME_TYPE;
+    const partType = input.partType || inferExecutionPartTypeForAsset({ mimeType, name });
+    const request = {
+        partType,
+        mimeType,
+        dataBase64: String(input.dataBase64 ?? "").trim(),
+    };
+    const intent = normalizeOptionalString(input.intent);
+    const storageId = normalizeOptionalString(input.storageId);
+    const assetCacheKey = normalizeOptionalString(input.assetCacheKey);
+    if (intent)
+        request.intent = intent;
+    if (name)
+        request.name = name;
+    if (input.metadata)
+        request.metadata = cloneAssetMetadata(input.metadata);
+    if (storageId)
+        request.storageId = storageId;
+    if (assetCacheKey)
+        request.assetCacheKey = assetCacheKey;
+    return request;
+}
+/**
+ * Converts a managed asset reference into an execution input part.
+ */
+function prepareAssetInputPart(input) {
+    const name = normalizeOptionalString(input.name);
+    const mimeType = normalizeOptionalString(input.mimeType) ||
+        inferMimeTypeFromAssetName(name) ||
+        inferMimeTypeFromAssetName(normalizeOptionalString(input.asset.assetPath)) ||
+        DEFAULT_ASSET_UPLOAD_MIME_TYPE;
+    const partType = input.partType || inferExecutionPartTypeForAsset({ mimeType, name });
+    return {
+        variableName: normalizeOptionalString(input.variableName),
+        type: partType,
+        mimeType,
+        name,
+        sizeBytes: input.sizeBytes ?? input.asset.sizeBytes,
+        source: {
+            kind: execution_contract_1.ExecutionPartSourceKind.ASSET,
+            asset: {
+                ...input.asset,
+                datasource: input.asset.datasource
+                    ? { ...input.asset.datasource }
+                    : undefined,
+            },
+        },
+    };
+}
 /**
  * Status for optional entitlements data returned by the auth check endpoint.
  */
@@ -133,6 +217,43 @@ class DcdrRuntimeClient {
             timeoutMs: this.timeoutMs,
         });
     }
+    /**
+     * Calls `POST /api/assets/upload`.
+     *
+     * Notes
+     * - Cloud-only managed feature.
+     * - When `storageId` is omitted, runtime resolves the tenant default storage.
+     */
+    async uploadAsset(request) {
+        return this.requestJson({
+            method: "POST",
+            path: "/api/assets/upload",
+            body: prepareAssetUploadRequest(request),
+            timeoutMs: this.timeoutMs,
+        });
+    }
+    /**
+     * Calls `GET /api/assets?assetPath=...&storageId=...`.
+     */
+    async getAsset(request) {
+        const query = this.buildAssetQuery(request.assetPath, request.storageId);
+        return this.requestJson({
+            method: "GET",
+            path: `/api/assets${query}`,
+            timeoutMs: this.timeoutMs,
+        });
+    }
+    /**
+     * Calls `DELETE /api/assets?assetPath=...&storageId=...`.
+     */
+    async deleteAsset(request) {
+        const query = this.buildAssetQuery(request.assetPath, request.storageId);
+        return this.requestJson({
+            method: "DELETE",
+            path: `/api/assets${query}`,
+            timeoutMs: this.timeoutMs,
+        });
+    }
     /**
      * Calls `POST /api/execution/stream/:intent` and yields SSE events.
      *
@@ -554,6 +675,18 @@ class DcdrRuntimeClient {
             clearTimeout(timeout);
         }
     }
+    /**
+     * Builds a stable query string for asset get/delete operations.
+     */
+    buildAssetQuery(assetPath, storageId) {
+        const safeAssetPath = encodeURIComponent(String(assetPath ?? "").trim());
+        const qp = [`assetPath=${safeAssetPath}`];
+        const safeStorageId = String(storageId ?? "").trim();
+        if (safeStorageId) {
+            qp.push(`storageId=${encodeURIComponent(safeStorageId)}`);
+        }
+        return `?${qp.join("&")}`;
+    }
 }
 exports.DcdrRuntimeClient = DcdrRuntimeClient;
 /**
@@ -567,3 +700,55 @@ function buildBodyPreview(text) {
         ? t.slice(0, ERROR_BODY_PREVIEW_MAX_CHARS) + "…"
         : t;
 }
+/**
+ * Infers a likely MIME type from a common file extension.
+ */
+function inferMimeTypeFromAssetName(name) {
+    const trimmed = normalizeOptionalString(name);
+    if (!trimmed)
+        return undefined;
+    const lastDot = trimmed.lastIndexOf(".");
+    if (lastDot < 0 || lastDot === trimmed.length - 1)
+        return undefined;
+    const extension = trimmed
+        .slice(lastDot + 1)
+        .trim()
+        .toLowerCase();
+    return EXTENSION_TO_MIME_TYPE[extension];
+}
+/**
+ * Infers the execution part type from MIME type or common file naming.
+ */
+function inferExecutionPartTypeForAsset(args) {
+    const mimeType = normalizeOptionalString(args.mimeType) ||
+        inferMimeTypeFromAssetName(args.name) ||
+        DEFAULT_ASSET_UPLOAD_MIME_TYPE;
+    if (mimeType.startsWith("image/"))
+        return execution_contract_1.ExecutionPartType.IMAGE;
+    if (mimeType.startsWith("audio/"))
+        return execution_contract_1.ExecutionPartType.AUDIO;
+    if (mimeType.startsWith("video/"))
+        return execution_contract_1.ExecutionPartType.VIDEO;
+    if (mimeType.startsWith("text/"))
+        return execution_contract_1.ExecutionPartType.TEXT;
+    return execution_contract_1.ExecutionPartType.DOCUMENT;
+}
+/**
+ * Trims optional strings and collapses empty values to `undefined`.
+ */
+function normalizeOptionalString(value) {
+    const normalized = String(value ?? "").trim();
+    return normalized || undefined;
+}
+/**
+ * Clones semantic asset metadata so callers can safely reuse their objects.
+ */
+function cloneAssetMetadata(metadata) {
+    return {
+        title: metadata.title,
+        description: metadata.description,
+        alt: metadata.alt,
+        tags: Array.isArray(metadata.tags) ? [...metadata.tags] : undefined,
+        attributes: metadata.attributes ? { ...metadata.attributes } : undefined,
+    };
+}

package/dist/utils.contract.d.ts

@@ -1,6 +1,30 @@
 /**
  * Shared utilities for `@dcdr/contracts`.
  */
+/**
+ * Hash dependency used by helpers that need a stable SHA-256 hex digest.
+ */
+export interface Sha256HexDeps {
+    /** Returns the lowercase hex SHA-256 digest for the provided UTF-8 string. */
+    sha256Hex: (value: string) => string;
+}
+/**
+ * Inputs used to derive the default DCDR asset cache key.
+ *
+ * Notes
+ * - `cid` is intentionally excluded because tenant isolation already exists in the asset path prefix.
+ * - `intent` is intentionally excluded so the same tenant asset can be reused across intents.
+ */
+export interface DcdrAssetCacheKeyInput {
+    /** Stable semantic family for the asset. */
+    partType: string;
+    /** Canonical lowercase hex content hash for the payload bytes. */
+    sha256: string;
+    /** Optional technical MIME type. */
+    mimeType?: string;
+    /** Optional human-friendly asset name. */
+    name?: string;
+}
 /**
  * Stable JSON stringify with deterministic object key ordering.
  *
@@ -18,4 +42,13 @@
  * - Circular references throw.
  */
 export declare function stableJsonStringify(value: unknown): string;
+/**
+ * Builds the default DCDR asset cache key from stable semantic inputs.
+ *
+ * Notes
+ * - The result is deterministic and path-safe (`sha256` hex).
+ * - The same tenant asset can be reused across intents because `intent` is not part of this identity.
+ * - Callers may still provide an explicit override when they intentionally want a different logical cache identity.
+ */
+export declare function buildDcdrAssetCacheKey(deps: Sha256HexDeps, input: DcdrAssetCacheKeyInput): string;
 //# sourceMappingURL=utils.contract.d.ts.map

package/dist/utils.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.contract.d.ts","sourceRoot":"","sources":["../src/utils.contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmE1D"}
+{"version":3,"file":"utils.contract.d.ts","sourceRoot":"","sources":["../src/utils.contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IAEjB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CAmBR"}

package/dist/utils.contract.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stableJsonStringify = stableJsonStringify;
+exports.buildDcdrAssetCacheKey = buildDcdrAssetCacheKey;
 /**
  * Stable JSON stringify with deterministic object key ordering.
  *
@@ -77,3 +78,37 @@ function stableJsonStringify(value) {
     };
     return walk(value);
 }
+/**
+ * Builds the default DCDR asset cache key from stable semantic inputs.
+ *
+ * Notes
+ * - The result is deterministic and path-safe (`sha256` hex).
+ * - The same tenant asset can be reused across intents because `intent` is not part of this identity.
+ * - Callers may still provide an explicit override when they intentionally want a different logical cache identity.
+ */
+function buildDcdrAssetCacheKey(deps, input) {
+    const partType = normalizeAssetCacheKeyField(input.partType);
+    const sha256 = normalizeAssetCacheKeyField(input.sha256);
+    if (!partType) {
+        throw new Error("buildDcdrAssetCacheKey: partType is required");
+    }
+    if (!sha256) {
+        throw new Error("buildDcdrAssetCacheKey: sha256 is required");
+    }
+    const normalized = stableJsonStringify({
+        v: 1,
+        partType,
+        mimeType: normalizeAssetCacheKeyField(input.mimeType) || null,
+        name: normalizeAssetCacheKeyField(input.name) || null,
+        sha256,
+    });
+    return deps.sha256Hex(normalized);
+}
+/**
+ * Normalizes a semantic cache-key field into a stable comparison form.
+ */
+function normalizeAssetCacheKeyField(value) {
+    return String(value ?? "")
+        .trim()
+        .toLowerCase();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcdr/contracts",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "homepage": "https://dcdr.ai",
   "description": "TypeScript contracts and runtime client for DCDR intent-based AI execution",
   "private": false,
@@ -48,29 +48,57 @@
     "node": "22.22.0"
   },
   "exports": {
-    ".": "./dist/index.js",
-    "./runtime.client": "./dist/runtime.client.js",
-    "./cache.contract": "./dist/cache.contract.js",
-    "./capabilities.contract": "./dist/capabilities.contract.js",
-    "./control.contract": "./dist/control.contract.js",
-    "./credentials.contract": "./dist/credentials.contract.js",
-    "./subscription.contract": "./dist/subscription.contract.js",
-    "./utils.contract": "./dist/utils.contract.js",
-    "./prompt-variable-schema.contract": "./dist/prompt-variable-schema.contract.js",
-    "./registry.stats.contract": "./dist/registry.stats.contract.js",
-    "./http.contract": "./dist/http.contract.js",
-    "./entitlements.contract": "./dist/entitlements.contract.js",
-    "./errors.contract": "./dist/errors.contract.js",
-    "./execution.contract": "./dist/execution.contract.js",
-    "./implementations.contract": "./dist/implementations.contract.js",
-    "./intent.contract": "./dist/intent.contract.js",
-    "./logs.contract": "./dist/logs.contract.js",
-    "./messages.contract": "./dist/messages.contract.js",
-    "./policies.contract": "./dist/policies.contract.js",
-    "./prompts.contract": "./dist/prompts.contract.js",
-    "./provider.contract": "./dist/provider.contract.js",
-    "./service-tokens.contract": "./dist/service-tokens.contract.js",
-    "./session.contract": "./dist/session.contract.js"
+    ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+    "./asset.contract": { "types": "./dist/asset.contract.d.ts", "default": "./dist/asset.contract.js" },
+    "./runtime.client": { "types": "./dist/runtime.client.d.ts", "default": "./dist/runtime.client.js" },
+    "./cache.contract": { "types": "./dist/cache.contract.d.ts", "default": "./dist/cache.contract.js" },
+    "./capabilities.contract": { "types": "./dist/capabilities.contract.d.ts", "default": "./dist/capabilities.contract.js" },
+    "./control.contract": { "types": "./dist/control.contract.d.ts", "default": "./dist/control.contract.js" },
+    "./credentials.contract": { "types": "./dist/credentials.contract.d.ts", "default": "./dist/credentials.contract.js" },
+    "./subscription.contract": { "types": "./dist/subscription.contract.d.ts", "default": "./dist/subscription.contract.js" },
+    "./utils.contract": { "types": "./dist/utils.contract.d.ts", "default": "./dist/utils.contract.js" },
+    "./prompt-variable-schema.contract": { "types": "./dist/prompt-variable-schema.contract.d.ts", "default": "./dist/prompt-variable-schema.contract.js" },
+    "./registry.stats.contract": { "types": "./dist/registry.stats.contract.d.ts", "default": "./dist/registry.stats.contract.js" },
+    "./http.contract": { "types": "./dist/http.contract.d.ts", "default": "./dist/http.contract.js" },
+    "./entitlements.contract": { "types": "./dist/entitlements.contract.d.ts", "default": "./dist/entitlements.contract.js" },
+    "./errors.contract": { "types": "./dist/errors.contract.d.ts", "default": "./dist/errors.contract.js" },
+    "./execution.contract": { "types": "./dist/execution.contract.d.ts", "default": "./dist/execution.contract.js" },
+    "./implementations.contract": { "types": "./dist/implementations.contract.d.ts", "default": "./dist/implementations.contract.js" },
+    "./intent.contract": { "types": "./dist/intent.contract.d.ts", "default": "./dist/intent.contract.js" },
+    "./logs.contract": { "types": "./dist/logs.contract.d.ts", "default": "./dist/logs.contract.js" },
+    "./messages.contract": { "types": "./dist/messages.contract.d.ts", "default": "./dist/messages.contract.js" },
+    "./policies.contract": { "types": "./dist/policies.contract.d.ts", "default": "./dist/policies.contract.js" },
+    "./prompts.contract": { "types": "./dist/prompts.contract.d.ts", "default": "./dist/prompts.contract.js" },
+    "./provider.contract": { "types": "./dist/provider.contract.d.ts", "default": "./dist/provider.contract.js" },
+    "./service-tokens.contract": { "types": "./dist/service-tokens.contract.d.ts", "default": "./dist/service-tokens.contract.js" },
+    "./session.contract": { "types": "./dist/session.contract.d.ts", "default": "./dist/session.contract.js" }
+  },
+  "typesVersions": {
+    "*": {
+      "asset.contract": ["dist/asset.contract.d.ts"],
+      "runtime.client": ["dist/runtime.client.d.ts"],
+      "cache.contract": ["dist/cache.contract.d.ts"],
+      "capabilities.contract": ["dist/capabilities.contract.d.ts"],
+      "control.contract": ["dist/control.contract.d.ts"],
+      "credentials.contract": ["dist/credentials.contract.d.ts"],
+      "subscription.contract": ["dist/subscription.contract.d.ts"],
+      "utils.contract": ["dist/utils.contract.d.ts"],
+      "prompt-variable-schema.contract": ["dist/prompt-variable-schema.contract.d.ts"],
+      "registry.stats.contract": ["dist/registry.stats.contract.d.ts"],
+      "http.contract": ["dist/http.contract.d.ts"],
+      "entitlements.contract": ["dist/entitlements.contract.d.ts"],
+      "errors.contract": ["dist/errors.contract.d.ts"],
+      "execution.contract": ["dist/execution.contract.d.ts"],
+      "implementations.contract": ["dist/implementations.contract.d.ts"],
+      "intent.contract": ["dist/intent.contract.d.ts"],
+      "logs.contract": ["dist/logs.contract.d.ts"],
+      "messages.contract": ["dist/messages.contract.d.ts"],
+      "policies.contract": ["dist/policies.contract.d.ts"],
+      "prompts.contract": ["dist/prompts.contract.d.ts"],
+      "provider.contract": ["dist/provider.contract.d.ts"],
+      "service-tokens.contract": ["dist/service-tokens.contract.d.ts"],
+      "session.contract": ["dist/session.contract.d.ts"]
+    }
   },
   "dependencies": {
     "class-validator": "^0.15.1"