@inneranimalmedia/agentsam-sdk 2.6.10 → 2.6.12

package/packages/agentsam-hooks/src/adapters/agents.js

@@ -11,6 +11,46 @@ function normalizeAgent(value) {
   });
 }
 
+export async function runWithSubagentHooks(options = {}) {
+  if (typeof options.run !== 'function') throw new TypeError('subagent_run_required');
+  const agentId = String(options.agentId || options.agent_id || '').trim();
+  if (!agentId) throw new TypeError('subagent_agent_id_required');
+  const task = String(options.task || '').trim();
+  if (!task) throw new TypeError('subagent_task_required');
+
+  const hooks = ensureHookRuntime(options.hooks || options.hookRuntime);
+  const context = options.context && typeof options.context === 'object' ? options.context : {};
+  const invocation = {
+    ...(options.invocation || {}),
+    agent_id: agentId,
+  };
+
+  await hooks.dispatch('subagent_start', {
+    agent_id: agentId,
+    task,
+    context,
+  }, invocation, { cwd: options.cwd });
+
+  try {
+    const result = await options.run({ task, context, invocation });
+    await hooks.dispatch('subagent_stop', {
+      agent_id: agentId,
+      task,
+      status: 'completed',
+      result,
+    }, invocation, { cwd: options.cwd });
+    return result;
+  } catch (error) {
+    await hooks.dispatch('subagent_stop', {
+      agent_id: agentId,
+      task,
+      status: 'failed',
+      error: { code: error?.code || null, message: String(error?.message || error) },
+    }, invocation, { cwd: options.cwd });
+    throw error;
+  }
+}
+
 export function createAgentCapabilityAdapter(options = {}) {
   if (typeof options.runAgent !== 'function') throw new TypeError('run_agent_adapter_required');
   const agents = (options.agents || []).map(normalizeAgent);
@@ -48,35 +88,21 @@ export function createAgentCapabilityAdapter(options = {}) {
         parent_agent_id: parentInvocation.agent_id || null,
         agent_id: agent.id,
       };
-      await hooks.dispatch('subagent_start', {
-        agent_id: agent.id,
+      return runWithSubagentHooks({
+        hookRuntime: hooks,
+        agentId: agent.id,
         task,
         context: input.context || {},
-      }, agentInvocation, { cwd: context.cwd || options.cwd });
-      try {
-        const result = await options.runAgent({
+        invocation: agentInvocation,
+        cwd: context.cwd || options.cwd,
+        run: () => options.runAgent({
           agent,
           task,
           context: input.context || {},
           parent: context,
           invocation: agentInvocation,
-        });
-        await hooks.dispatch('subagent_stop', {
-          agent_id: agent.id,
-          task,
-          status: 'completed',
-          result,
-        }, agentInvocation, { cwd: context.cwd || options.cwd });
-        return result;
-      } catch (error) {
-        await hooks.dispatch('subagent_stop', {
-          agent_id: agent.id,
-          task,
-          status: 'failed',
-          error: { code: error?.code || null, message: String(error?.message || error) },
-        }, agentInvocation, { cwd: context.cwd || options.cwd });
-        throw error;
-      }
+        }),
+      });
     },
   });
 }

package/packages/agentsam-hooks/src/index.d.ts

@@ -190,4 +190,20 @@ export function createHookedProviderAdapter(base: ProviderAdapter, options?: Rec
 export function createCompositeCapabilityAdapter(adapters: CapabilityAdapter[]): CapabilityAdapter;
 export function createMcpCapabilityAdapter(options: Record<string, unknown>): Promise<CapabilityAdapter>;
 export function createLspCapabilityAdapter(options: Record<string, unknown>): CapabilityAdapter;
+export interface SubagentHookRunOptions {
+  hooks?: unknown;
+  hookRuntime?: unknown;
+  agentId?: string;
+  agent_id?: string;
+  task: string;
+  context?: Record<string, unknown>;
+  invocation?: Record<string, unknown>;
+  cwd?: string;
+  run: (input: {
+    task: string;
+    context: Record<string, unknown>;
+    invocation: Record<string, unknown>;
+  }) => Promise<unknown> | unknown;
+}
+export function runWithSubagentHooks(options: SubagentHookRunOptions): Promise<unknown>;
 export function createAgentCapabilityAdapter(options: Record<string, unknown>): CapabilityAdapter;

package/packages/agentsam-knowledge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-knowledge",
-  "version": "2.6.10",
+  "version": "2.6.12",
   "description": "Portable AutoRAG discovery, adapter registries, probes, and company routing contracts for AgentSam.",
   "type": "module",
   "exports": {

package/packages/agentsam-knowledge/src/backends/index.js

@@ -1,4 +1,4 @@
-import { vectorizeDelete, vectorizeGetByIds, vectorizeHealth, vectorizeQuery, vectorizeUpsert } from '../../../connectors/cloudflare/src/families/vectorize.js';
+import { vectorizeDelete, vectorizeGetByIds, vectorizeHealth, vectorizeQuery, vectorizeUpsert } from '../../../connectors/cfoa/src/families/vectorize.js';
 
 const clean = value => String(value || '').trim();
 function profileGuard(profile, supported) {

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.12",
+  "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
+}