@dylanl1/dsh-plugin-pdf 0.1.2 → 0.1.3

package/dist/embedding.js

@@ -14542,19 +14542,26 @@ function date4(params) {
 config(en_default());
 
 // src/modules/engines/types.ts
+var engineCapabilities = ["ocr-text", "image-description"];
 var configurationFieldSchema = external_exports.object({
   key: external_exports.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/),
   label: external_exports.string().min(1).max(200),
   type: external_exports.enum(["string", "number", "boolean", "secret-reference"]),
   required: external_exports.boolean().optional()
 }).strict();
+var engineExecutionSchema = external_exports.enum(["disabled", "local", "remote", "service"]);
 var engineDescriptorSchema = external_exports.object({
   id: external_exports.string().regex(/^[a-zA-Z0-9@][a-zA-Z0-9@/_.:-]{0,199}$/),
   name: external_exports.string().min(1).max(200),
   version: external_exports.string().min(1).max(128),
-  execution: external_exports.enum(["disabled", "local", "remote"]),
+  execution: engineExecutionSchema,
+  /** Omitted metadata makes no capability claim; consumers must opt in explicitly. */
+  capabilities: external_exports.array(external_exports.enum(engineCapabilities)).max(engineCapabilities.length).optional(),
   configurationFields: external_exports.array(configurationFieldSchema).max(32).optional()
 }).superRefine((descriptor, ctx) => {
+  if (descriptor.capabilities && new Set(descriptor.capabilities).size !== descriptor.capabilities.length) {
+    ctx.addIssue({ code: "custom", message: "Duplicate engine capability" });
+  }
   const fields = descriptor.configurationFields ?? [];
   if (new Set(fields.map((field) => field.key)).size !== fields.length) ctx.addIssue({ code: "custom", message: "Duplicate engine configuration field" });
 });
@@ -14583,7 +14590,7 @@ function validateEngineConfiguration(descriptor, input = {}) {
     }
     const type = field.type === "secret-reference" ? "string" : field.type;
     if (typeof value !== type || type === "number" && !Number.isFinite(value)) throw new Error(`Invalid engine configuration: ${field.label}`);
-    if (field.type === "secret-reference" && !/^[a-zA-Z0-9][a-zA-Z0-9/_.:-]{0,199}$/.test(String(value))) {
+    if (field.type === "secret-reference" && !/^[a-zA-Z0-9_][a-zA-Z0-9/_.:-]{0,199}$/.test(String(value))) {
       throw new Error("A credential reference, not a secret, is required");
     }
   }
@@ -14611,7 +14618,7 @@ var EngineDirectory = class {
     const descriptor = engineDescriptorSchema.parse(this.describe(implementation));
     if (this.entries.has(descriptor.id)) throw new Error(`Engine already registered: ${descriptor.id}`);
     if (this.entries.size >= 128) throw new Error("Engine directory limit exceeded");
-    const entry = { implementation, descriptor: structuredClone(descriptor) };
+    const entry = { implementation, descriptor: structuredClone(descriptor), generation: crypto.randomUUID() };
     this.entries.set(descriptor.id, entry);
     this.changed();
     return () => {
@@ -14627,6 +14634,9 @@ var EngineDirectory = class {
   get(id) {
     return this.entries.get(id)?.implementation;
   }
+  generation(id) {
+    return this.entries.get(id)?.generation;
+  }
   has(id) {
     return this.entries.has(id);
   }
@@ -14740,21 +14750,36 @@ var EmbeddingRegistry = class {
     return this.run(engine, request.signal, request.timeoutMs, async (signal, timeoutMs) => {
       const output = await engine.embed({ texts, purpose: request.purpose, signal, timeoutMs }, config2);
       signal.throwIfAborted();
-      if (!Array.isArray(output) || output.length !== texts.length) {
+      let resultModel = model;
+      let returned = output;
+      const currentModel = this.model(engine, config2);
+      if (output && typeof output === "object" && "vectors" in output && "model" in output) {
+        const reported = output.model;
+        const identity = ["engineId", "engineVersion", "model", "modelRevision", "dimensions", "encoding", "fingerprint", "documentFingerprint"];
+        if (!reported || identity.some((key) => reported[key] !== currentModel[key])) {
+          throw new EmbeddingError("invalid-result", "The embedding response has an unverified model identity.");
+        }
+        returned = output.vectors;
+        resultModel = currentModel;
+      } else if (currentModel.fingerprint !== model.fingerprint || currentModel.documentFingerprint !== model.documentFingerprint) {
+        throw new EmbeddingError("invalid-result", "The embedding model changed during the request.");
+      }
+      if (!Array.isArray(returned) || returned.length !== texts.length || texts.length > resultModel.maxBatchSize || texts.some((text) => text.length > resultModel.maxInputCharacters)) {
         throw new EmbeddingError("invalid-result", "The embedding response has an incorrect vector count.");
       }
-      const vectors = output.map((vector) => {
-        if (!Array.isArray(vector) || vector.length !== model.dimensions || vector.some((value) => typeof value !== "number" || !Number.isFinite(value))) {
+      const vectors = returned.map((vector) => {
+        if (!Array.isArray(vector) || vector.length !== resultModel.dimensions || vector.some((value) => typeof value !== "number" || !Number.isFinite(value))) {
           throw new EmbeddingError("invalid-result", "The embedding response has invalid vector dimensions or values.");
         }
         const norm = Math.hypot(...vector);
         if (!Number.isFinite(norm) || norm < 1e-12) throw new EmbeddingError("invalid-result", "The embedding response contains an empty vector.");
         return vector.map((value) => value / norm);
       });
-      if (this.model(engine, config2).fingerprint !== model.fingerprint) {
+      const finalModel = this.model(engine, config2);
+      if (finalModel.fingerprint !== resultModel.fingerprint || finalModel.documentFingerprint !== resultModel.documentFingerprint) {
         throw new EmbeddingError("invalid-result", "The embedding model changed during the request.");
       }
-      return { vectors, model };
+      return { vectors, model: resultModel };
     });
   }
   dispose() {
@@ -14783,7 +14808,7 @@ var EmbeddingRegistry = class {
       if (error51 instanceof EmbeddingError) throw error51;
       throw new EmbeddingError("invalid-request", "The embedding engine configuration is invalid.");
     }
-    if (!model || model.engineId !== engine.descriptor.id || model.engineVersion !== engine.descriptor.version || [model.model, model.modelRevision, model.encoding, model.fingerprint].some((value) => typeof value !== "string" || !value || value.length > 512) || !Number.isSafeInteger(model.dimensions) || model.dimensions < 1 || model.dimensions > this.limits.maxDimensions || !Number.isSafeInteger(model.maxBatchSize) || model.maxBatchSize < 1 || !Number.isSafeInteger(model.maxInputCharacters) || model.maxInputCharacters < 1) {
+    if (!model || model.engineId !== engine.descriptor.id || model.engineVersion !== engine.descriptor.version || [model.model, model.modelRevision, model.encoding, model.fingerprint].some((value) => typeof value !== "string" || !value || value.length > 512) || model.documentFingerprint !== void 0 && (typeof model.documentFingerprint !== "string" || !model.documentFingerprint || model.documentFingerprint.length > 512) || !Number.isSafeInteger(model.dimensions) || model.dimensions < 1 || model.dimensions > this.limits.maxDimensions || !Number.isSafeInteger(model.maxBatchSize) || model.maxBatchSize < 1 || !Number.isSafeInteger(model.maxInputCharacters) || model.maxInputCharacters < 1) {
       throw new EmbeddingError("invalid-result", "The embedding engine returned an invalid model description.");
     }
     return {

package/dist/engines.js

@@ -14520,19 +14520,26 @@ config(en_default());
 
 // src/modules/engines/types.ts
 var engineKinds = ["ocr", "image", "translation", "embedding"];
+var engineCapabilities = ["ocr-text", "image-description"];
 var configurationFieldSchema = external_exports.object({
   key: external_exports.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/),
   label: external_exports.string().min(1).max(200),
   type: external_exports.enum(["string", "number", "boolean", "secret-reference"]),
   required: external_exports.boolean().optional()
 }).strict();
+var engineExecutionSchema = external_exports.enum(["disabled", "local", "remote", "service"]);
 var engineDescriptorSchema = external_exports.object({
   id: external_exports.string().regex(/^[a-zA-Z0-9@][a-zA-Z0-9@/_.:-]{0,199}$/),
   name: external_exports.string().min(1).max(200),
   version: external_exports.string().min(1).max(128),
-  execution: external_exports.enum(["disabled", "local", "remote"]),
+  execution: engineExecutionSchema,
+  /** Omitted metadata makes no capability claim; consumers must opt in explicitly. */
+  capabilities: external_exports.array(external_exports.enum(engineCapabilities)).max(engineCapabilities.length).optional(),
   configurationFields: external_exports.array(configurationFieldSchema).max(32).optional()
 }).superRefine((descriptor, ctx) => {
+  if (descriptor.capabilities && new Set(descriptor.capabilities).size !== descriptor.capabilities.length) {
+    ctx.addIssue({ code: "custom", message: "Duplicate engine capability" });
+  }
   const fields = descriptor.configurationFields ?? [];
   if (new Set(fields.map((field) => field.key)).size !== fields.length) ctx.addIssue({ code: "custom", message: "Duplicate engine configuration field" });
 });
@@ -14561,7 +14568,7 @@ function validateEngineConfiguration(descriptor, input = {}) {
     }
     const type = field.type === "secret-reference" ? "string" : field.type;
     if (typeof value !== type || type === "number" && !Number.isFinite(value)) throw new Error(`Invalid engine configuration: ${field.label}`);
-    if (field.type === "secret-reference" && !/^[a-zA-Z0-9][a-zA-Z0-9/_.:-]{0,199}$/.test(String(value))) {
+    if (field.type === "secret-reference" && !/^[a-zA-Z0-9_][a-zA-Z0-9/_.:-]{0,199}$/.test(String(value))) {
       throw new Error("A credential reference, not a secret, is required");
     }
   }
@@ -14592,7 +14599,7 @@ var EngineDirectory = class {
     const descriptor = engineDescriptorSchema.parse(this.describe(implementation));
     if (this.entries.has(descriptor.id)) throw new Error(`Engine already registered: ${descriptor.id}`);
     if (this.entries.size >= 128) throw new Error("Engine directory limit exceeded");
-    const entry = { implementation, descriptor: structuredClone(descriptor) };
+    const entry = { implementation, descriptor: structuredClone(descriptor), generation: crypto.randomUUID() };
     this.entries.set(descriptor.id, entry);
     this.changed();
     return () => {
@@ -14608,6 +14615,9 @@ var EngineDirectory = class {
   get(id) {
     return this.entries.get(id)?.implementation;
   }
+  generation(id) {
+    return this.entries.get(id)?.generation;
+  }
   has(id) {
     return this.entries.has(id);
   }
@@ -14643,6 +14653,9 @@ var EngineDirectory = class {
   }
 };
 
+// src/shared/passive-poll.ts
+var PASSIVE_POLL_TIMEOUT_MS = 5e3;
+
 // src/modules/engines/catalog.ts
 var engineCatalogSchema = external_exports.object({
   revision: external_exports.string().min(1).max(128),
@@ -14697,7 +14710,7 @@ var EngineCatalog = class {
         reject(signal.reason);
       };
       const stop = this.subscribe(changed);
-      const timer = setTimeout(changed, 15e3);
+      const timer = setTimeout(changed, PASSIVE_POLL_TIMEOUT_MS);
       signal.addEventListener("abort", aborted2, { once: true });
       if (revision !== this.snapshot.revision || this.disposed) changed();
     });
@@ -14744,16 +14757,48 @@ async function engineProbe(tasks, provider, signal, errors, operation) {
     tasks.delete(controller);
   }
 }
+
+// src/modules/engines/serialization.ts
+function canonicalEngineJson(value) {
+  if (Array.isArray(value)) return `[${value.map(canonicalEngineJson).join(",")}]`;
+  if (value !== null && typeof value === "object") {
+    return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${canonicalEngineJson(value[key])}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+
+// src/modules/engines/cache-identity.ts
+function engineCacheIdentity(descriptor, config2, generation, sessionId, backendIdentity, hash2, context = null) {
+  const identity = typeof backendIdentity === "string" ? backendIdentity : backendIdentity?.identity;
+  if (identity !== void 0 && (typeof identity !== "string" || !identity.trim() || identity.length > 16384)) {
+    throw new Error("The engine returned an invalid cache identity");
+  }
+  const reusable = typeof backendIdentity === "string";
+  const fingerprint = hash2(canonicalEngineJson({
+    backendId: descriptor.id,
+    backendVersion: descriptor.version,
+    config: { ...config2 },
+    capabilities: descriptor.capabilities ? [...descriptor.capabilities].sort() : null,
+    identity: identity ?? null,
+    context,
+    ...reusable ? {} : { generation, sessionId }
+  }));
+  return { fingerprint, generation, reusable, backendId: descriptor.id, backendVersion: descriptor.version };
+}
 export {
   EngineCatalog,
   EngineDirectory,
+  canonicalEngineJson,
   configurationFieldSchema,
   engineBinding,
+  engineCacheIdentity,
+  engineCapabilities,
   engineCatalogRequestSchema,
   engineCatalogSchema,
   engineConfigurationSchema,
   engineConfigurationsSchema,
   engineDescriptorSchema,
+  engineExecutionSchema,
   engineKinds,
   engineProbe,
   validateEngineConfiguration