@inneranimalmedia/agentsam-sdk 2.6.10 → 2.6.11

package/packages/agentsam-merch/README.md

@@ -0,0 +1,62 @@
+# @inneranimalmedia/agentsam-merch
+
+Portable manufacturing preflight and merch planning for AgentSam applications.
+
+The package separates manufacturing profile **data** from execution code, provider adapters from the media engine, preserved source masters from manufacturing/storefront derivatives, and deterministic preflight from human/process-specific handoffs.
+
+## Profile contract
+
+Profiles are JSON under `profiles/<manufacturer>/`. Provider requirements do not belong in application conditionals.
+
+The engine returns:
+
+- `ready`
+- `ready_with_transform`
+- `needs_variant`
+- `prepared_for_digitization`
+- `unsupported`
+
+A low-resolution raster is never called production-ready. An embroidery source is never represented as a finished stitch file.
+
+## Derivative authority
+
+```text
+original/master
+  ├─ manufacturing
+  ├─ storefront/gallery
+  ├─ thumbnail
+  ├─ social
+  └─ mockup
+```
+
+The manufacturing plan is marked `mustNotUseStorefrontDerivative`.
+
+## Collection Lab
+
+Portable candidate states:
+
+```text
+concept
+approved-art
+production-ready
+sample-ordered
+sample-approved
+published
+retired
+```
+
+## Provider adapters
+
+Adapters only translate provider catalog metadata into a neutral selection context. The Completeful adapter knows field names such as `print_type` and `file_width`; manufacturing rules remain profile data.
+
+## CLI kernel
+
+The standalone proof is:
+
+```text
+agentsam-merch build <manifest.json> --all-compatible
+```
+
+The distributed AgentSam CLI can delegate `agentsam merch build ...` to the same `buildMerchPlan()` kernel.
+
+Seed Completeful profiles are marked `operator-defined` until verified against provider documentation.

package/packages/agentsam-merch/bin/agentsam-merch.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "node:url";
+import { runMerchCli } from "../src/cli.js";
+
+export { runMerchCli };
+
+const isMain =
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(process.argv[1]).href;
+
+if (isMain) {
+  runMerchCli(process.argv.slice(2)).catch((error) => {
+    console.error(error?.message || String(error));
+    process.exitCode = 1;
+  });
+}

package/packages/agentsam-merch/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@inneranimalmedia/agentsam-merch",
+  "version": "2.6.11",
+  "description": "Provider-neutral manufacturing profiles, preflight, derivative planning, and collection-lab primitives for AgentSam.",
+  "type": "module",
+  "files": [
+    "src",
+    "profiles",
+    "bin",
+    "README.md",
+    "schemas"
+  ],
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./profiles": "./src/profile.js",
+    "./registry": "./src/profile-registry.js",
+    "./compatibility": "./src/compatibility.js",
+    "./derivatives": "./src/derivatives.js",
+    "./collection-lab": "./src/collection-lab.js",
+    "./adapters/completeful": "./src/adapters-completeful.js",
+    "./profiles/*": "./profiles/*",
+    "./transforms": {
+      "types": "./src/index.d.ts",
+      "import": "./src/transforms.js"
+    },
+    "./node": {
+      "types": "./src/node/index.d.ts",
+      "import": "./src/node/index.js"
+    }
+  },
+  "bin": {
+    "agentsam-merch": "./bin/agentsam-merch.mjs"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "types": "./src/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "packages/agentsam-merch"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "sharp": ">=0.33.0",
+    "svgo": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "sharp": {
+      "optional": true
+    },
+    "svgo": {
+      "optional": true
+    }
+  }
+}

package/packages/agentsam-merch/profiles/completeful/dtg-back-large.json

@@ -0,0 +1,42 @@
+{
+  "schemaVersion": "agentsam.manufacturing-profile.v1",
+  "id": "completeful.dtg.back-large",
+  "manufacturer": "completeful",
+  "process": "dtg",
+  "format": "png",
+  "colorSpace": "srgb",
+  "alpha": true,
+  "ppi": 300,
+  "maxBytes": 20000000,
+  "preferredPrintWidthIn": 13,
+  "allowRaster": true,
+  "allowVector": false,
+  "match": {
+    "manufacturer": "completeful",
+    "process": "dtg",
+    "locationName": "back",
+    "minWidthIn": 10
+  },
+  "source": {
+    "kind": "provider-documentation",
+    "verified": true,
+    "verifiedAt": "2026-10-03",
+    "notes": [
+      "PNG recommended for transparent artwork",
+      "RGB/sRGB color mode",
+      "300 DPI minimum at final print size",
+      "20 MB PNG upload limit"
+    ]
+  },
+  "$schema": "https://schemas.inneranimalmedia.com/agentsam/schemas/agentsam.manufacturing-profile.v1.json",
+  "resolution": {
+    "readyPpi": 300,
+    "minimumPpi": 300
+  },
+  "autoNormalize": {
+    "trimAlpha": true,
+    "colorSpace": true,
+    "svgOptimize": false,
+    "outlineText": false
+  }
+}

package/packages/agentsam-merch/profiles/completeful/laser-engraving.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": "agentsam.manufacturing-profile.v1",
+  "id": "completeful.laser-engraving",
+  "manufacturer": "completeful",
+  "process": "engraving",
+  "preferredFormat": "svg",
+  "colorMode": "monochrome",
+  "allowRaster": false,
+  "allowVector": true,
+  "allowGradients": false,
+  "requireClosedPaths": true,
+  "outlineText": true,
+  "match": {
+    "manufacturer": "completeful",
+    "process": [
+      "engraving",
+      "etching"
+    ]
+  },
+  "source": {
+    "kind": "operator-defined",
+    "verified": false
+  },
+  "$schema": "https://schemas.inneranimalmedia.com/agentsam/schemas/agentsam.manufacturing-profile.v1.json",
+  "requireViewBox": true,
+  "autoNormalize": {
+    "trimAlpha": false,
+    "colorSpace": false,
+    "svgOptimize": true,
+    "outlineText": true
+  },
+  "vectorization": {
+    "enabled": true,
+    "preferredTracer": "auto",
+    "maxAspectDrift": 0.02,
+    "minBoundaryIntegrity": 0.98,
+    "outputFormat": "svg"
+  }
+}

package/packages/agentsam-merch/profiles/generic/embroidery-digitization.json

@@ -0,0 +1,22 @@
+{
+  "schemaVersion": "agentsam.manufacturing-profile.v1",
+  "id": "generic.embroidery.pre-digitization",
+  "manufacturer": "generic",
+  "process": "embroidery",
+  "preferredFormat": "svg",
+  "colorMode": "spot",
+  "allowRaster": false,
+  "allowVector": true,
+  "allowGradients": false,
+  "requireClosedPaths": true,
+  "outlineText": true,
+  "handoff": {
+    "status": "prepared_for_digitization",
+    "reason": "Stitch direction, density, underlay, pull compensation, thread sequencing, and machine format require embroidery-specific digitization."
+  },
+  "source": {
+    "kind": "process-safety-default",
+    "verified": true
+  },
+  "$schema": "https://schemas.inneranimalmedia.com/agentsam/schemas/agentsam.manufacturing-profile.v1.json"
+}

package/packages/agentsam-merch/schemas/collection-candidate.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/schemas/agentsam.collection-candidate.v1.json",
+  "title": "AgentSam Collection Lab Candidate",
+  "type": "object",
+  "required": [
+    "id",
+    "designId",
+    "state"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "designId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "collectionPath": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "state": {
+      "enum": [
+        "concept",
+        "approved-art",
+        "production-ready",
+        "sample-ordered",
+        "sample-approved",
+        "published",
+        "retired"
+      ]
+    },
+    "products": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    },
+    "approvals": {
+      "type": "object",
+      "properties": {
+        "artwork": {
+          "type": "boolean"
+        },
+        "wording": {
+          "type": "boolean"
+        },
+        "palette": {
+          "type": "boolean"
+        },
+        "visualIdentity": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "metadata": {
+      "type": "object"
+    }
+  },
+  "additionalProperties": true
+}

package/packages/agentsam-merch/schemas/manufacturing-profile.schema.json

@@ -0,0 +1,221 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/schemas/agentsam.manufacturing-profile.v1.json",
+  "title": "AgentSam Manufacturing Profile",
+  "type": "object",
+  "required": [
+    "id",
+    "manufacturer",
+    "process"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "agentsam.manufacturing-profile.v1"
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "manufacturer": {
+      "type": "string",
+      "minLength": 1
+    },
+    "process": {
+      "type": "string",
+      "minLength": 1
+    },
+    "format": {
+      "type": "string"
+    },
+    "preferredFormat": {
+      "type": "string"
+    },
+    "colorSpace": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "colorMode": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "alpha": {
+      "type": "boolean"
+    },
+    "requireAlpha": {
+      "type": "boolean"
+    },
+    "ppi": {
+      "type": [
+        "number",
+        "null"
+      ],
+      "exclusiveMinimum": 0
+    },
+    "maxBytes": {
+      "type": [
+        "number",
+        "null"
+      ],
+      "exclusiveMinimum": 0
+    },
+    "preferredPrintWidthIn": {
+      "type": [
+        "number",
+        "null"
+      ],
+      "exclusiveMinimum": 0
+    },
+    "preferredPrintHeightIn": {
+      "type": [
+        "number",
+        "null"
+      ],
+      "exclusiveMinimum": 0
+    },
+    "allowRaster": {
+      "type": "boolean"
+    },
+    "allowVector": {
+      "type": "boolean"
+    },
+    "allowGradients": {
+      "type": "boolean"
+    },
+    "requireClosedPaths": {
+      "type": "boolean"
+    },
+    "outlineText": {
+      "type": "boolean"
+    },
+    "match": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "handoff": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "source": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "properties": {
+        "kind": {
+          "type": "string"
+        },
+        "verified": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": true
+    },
+    "resolution": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "properties": {
+        "readyPpi": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "exclusiveMinimum": 0
+        },
+        "minimumPpi": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "exclusiveMinimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
+    "autoNormalize": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "properties": {
+        "trimAlpha": {
+          "type": "boolean"
+        },
+        "colorSpace": {
+          "type": "boolean"
+        },
+        "svgOptimize": {
+          "type": "boolean"
+        },
+        "outlineText": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "vectorization": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "preferredTracer": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "maxAspectDrift": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "exclusiveMinimum": 0
+        },
+        "minBoundaryIntegrity": {
+          "type": [
+            "number",
+            "null"
+          ],
+          "minimum": 0,
+          "maximum": 1
+        },
+        "outputFormat": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
+    "requireViewBox": {
+      "type": "boolean"
+    }
+  },
+  "anyOf": [
+    {
+      "required": [
+        "format"
+      ]
+    },
+    {
+      "required": [
+        "preferredFormat"
+      ]
+    }
+  ],
+  "additionalProperties": true
+}

package/packages/agentsam-merch/src/adapters-completeful.js

@@ -0,0 +1,50 @@
+function lower(value) {
+  return value == null ? null : String(value).trim().toLowerCase();
+}
+
+function toInches(value, unit) {
+  const number = Number(value);
+  if (!Number.isFinite(number) || number <= 0) return null;
+  const normalized = String(unit || "IN").trim().toUpperCase();
+  if (normalized === "IN" || normalized === "INCH" || normalized === "INCHES") {
+    return number;
+  }
+  if (normalized === "CM") return number / 2.54;
+  if (normalized === "MM") return number / 25.4;
+  return null;
+}
+
+function physicalTarget(location = {}) {
+  const unit = location.unit || location.file_unit || location.fileUnit || "IN";
+  return {
+    printWidthIn: toInches(location.file_width || location.fileWidth, unit),
+    printHeightIn: toInches(location.file_height || location.fileHeight, unit),
+    providerDpi: Number(location.dpi || 0) || null,
+    providerUnit: String(unit).toUpperCase(),
+  };
+}
+
+/**
+ * Translate Completeful catalog metadata into provider-neutral profile context.
+ * No manufacturing requirement lives in this adapter.
+ */
+export function completefulProfileContext(product = {}, location = {}) {
+  const target = physicalTarget(location);
+  return Object.freeze({
+    manufacturer: "completeful",
+    process: lower(product.print_type || product.printType),
+    productType: lower(product.product_type || product.productType),
+    locationName: lower(location.name),
+    ...target,
+    providerProductId:
+      product.completeful_product_id ||
+      product.catalog_product_id ||
+      product.id ||
+      null,
+    providerLocationId: location.print_location_id || location.id || null,
+  });
+}
+
+export function completefulTarget(location = {}) {
+  return Object.freeze(physicalTarget(location));
+}

package/packages/agentsam-merch/src/cli.js

@@ -0,0 +1,93 @@
+import { readFile, readdir } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import {
+  buildMerchPlan,
+  createManufacturingProfileRegistry,
+} from "./index.js";
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+export async function readBundledProfiles(root = packageRoot) {
+  const profiles = [];
+  const base = join(root, "profiles");
+  for (const manufacturer of await readdir(base, { withFileTypes: true })) {
+    if (!manufacturer.isDirectory()) continue;
+    const dir = join(base, manufacturer.name);
+    for (const entry of await readdir(dir, { withFileTypes: true })) {
+      if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
+      profiles.push(JSON.parse(await readFile(join(dir, entry.name), "utf8")));
+    }
+  }
+  return profiles;
+}
+
+export function merchStatusLabel(status) {
+  return {
+    ready: "READY",
+    ready_with_warning: "READY / WARNING",
+    ready_with_transform: "READY / TRANSFORM",
+    needs_variant: "NEEDS VARIANT",
+    prepared_for_digitization: "PREPARED FOR DIGITIZATION",
+    unsupported: "UNSUPPORTED",
+  }[status] || String(status).toUpperCase();
+}
+
+export async function runMerchCli(
+  argv = [],
+  { write = (value) => process.stdout.write(value), profileRoot = packageRoot } = {},
+) {
+  const args = [...argv];
+  if (args[0] === "merch") args.shift();
+  const command = args.shift();
+  const registry = createManufacturingProfileRegistry(
+    await readBundledProfiles(profileRoot),
+  );
+
+  if (command === "profiles") {
+    const rows = registry.list();
+    for (const profile of rows) {
+      write(
+        `${profile.id}\t${profile.manufacturer}\t${profile.process}\t${profile.format}\n`,
+      );
+    }
+    return { command, profiles: rows };
+  }
+
+  if (command !== "build") {
+    const error = new Error(
+      "Usage: agentsam merch build <manifest.json> [--all-compatible]\n" +
+        "       agentsam merch profiles",
+    );
+    error.code = "AGENTSAM_MERCH_USAGE";
+    throw error;
+  }
+
+  const manifestPath = args.find((arg) => !arg.startsWith("--"));
+  if (!manifestPath) {
+    const error = new Error("agentsam merch build requires a manifest JSON path");
+    error.code = "AGENTSAM_MERCH_MANIFEST_REQUIRED";
+    throw error;
+  }
+
+  const manifest = JSON.parse(await readFile(resolve(manifestPath), "utf8"));
+  const plan = buildMerchPlan({ ...manifest, registry });
+
+  write(`Design: ${plan.design.id || plan.design.name || "unnamed"}\n\n`);
+  write("Compatible products\n");
+  for (const target of plan.targets) {
+    const compatibility = target.derivatives?.manufacturing?.compatibility;
+    const notes = [];
+    if (compatibility?.requirementsVerified === false) notes.push("PROFILE UNVERIFIED");
+    if (compatibility?.issues?.[0]?.message) {
+      notes.push(compatibility.issues[0].message);
+    }
+    write(
+      `${String(target.name || target.id).padEnd(30)} ${merchStatusLabel(
+        target.status,
+      )}${notes.length ? ` · ${notes.join(" · ")}` : ""}\n`,
+    );
+  }
+
+  return { command, manifestPath: resolve(manifestPath), plan };
+}