@inneranimalmedia/agentsam-sdk 2.6.2 → 2.6.4

package/packages/providers/completeful/test/provider.test.mjs

@@ -0,0 +1,196 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import {
+  COMPLETEFUL_TOOL_DEFINITIONS,
+  CompletefulApiError,
+  computeCompletefulWebhookSignature,
+  createCompletefulClient,
+  createCompletefulProviderAdapter,
+  normalizeCompletefulEvent,
+  verifyCompletefulWebhook,
+} from '../src/index.js';
+
+test('Completeful tool definitions use the shared execution-plane vocabulary', () => {
+  const keys = new Set();
+  for (const tool of COMPLETEFUL_TOOL_DEFINITIONS) {
+    assert.equal(tool.provider, 'completeful');
+    assert.equal(tool.handler.ref, 'completeful.execute');
+    assert.ok(tool.capabilityKey);
+    assert.ok(tool.inputSchema);
+    assert.ok(tool.outputSchema);
+    assert.ok(tool.authority?.length);
+    assert.ok(tool.sideEffectLevel);
+    assert.ok(tool.idempotencyMode);
+    assert.equal(keys.has(tool.toolKey), false, `duplicate tool key: ${tool.toolKey}`);
+    keys.add(tool.toolKey);
+  }
+});
+
+test('client preserves provider metadata and does not depend on Worker env shape', async () => {
+  let captured = null;
+  const client = createCompletefulClient({
+    apiKey: 'capp_test_example',
+    fetchImpl: async (url, init) => {
+      captured = { url, init };
+      return new Response(JSON.stringify({ items: [] }), {
+        status: 200,
+        headers: { 'x-request-id': 'req_123', 'x-capp-dry-run': 'true' },
+      });
+    },
+  });
+
+  const adapter = createCompletefulProviderAdapter(client);
+  const result = await adapter.invoke({
+    id: 'inv_1',
+    toolKey: 'completeful.catalog.list',
+    input: { limit: 5, search: 'shirt' },
+    requestedAt: Date.now(),
+  });
+
+  assert.match(captured.url, /\/v1\/catalog\/products/);
+  assert.match(captured.url, /limit=5/);
+  assert.equal(captured.init.headers.get('Authorization'), 'Bearer capp_test_example');
+  assert.deepEqual(result.output, { items: [] });
+  assert.equal(result.providerRequestId, 'req_123');
+  assert.equal(result.metadata.provider_meta.dry_run, true);
+});
+
+test('client keeps Completeful structured provider errors', async () => {
+  const client = createCompletefulClient({
+    apiKey: 'capp_test_example',
+    fetchImpl: async () =>
+      new Response(
+        JSON.stringify({
+          error: 'bad input',
+          code: 'invalid_order',
+          request_id: 'req_bad',
+          path: '/v1/shops/x/orders',
+          remediation: 'fix order payload',
+        }),
+        { status: 422, headers: { 'content-type': 'application/json' } },
+      ),
+  });
+
+  await assert.rejects(
+    () => client.request('POST', '/shops/x/orders'),
+    (error) => {
+      assert.ok(error instanceof CompletefulApiError);
+      assert.equal(error.code, 'invalid_order');
+      assert.equal(error.requestId, 'req_bad');
+      assert.equal(error.remediation, 'fix order payload');
+      return true;
+    },
+  );
+});
+
+test('live mutations fail closed unless the host explicitly enables them', () => {
+  const client = createCompletefulClient({ apiKey: 'capp_live_example', fetchImpl: async () => new Response('{}') });
+  assert.throws(() => client.assertMutationAllowed(), /live writes are disabled/i);
+});
+
+test('webhook verification is portable and event normalization keeps provider provenance', async () => {
+  const rawBody = JSON.stringify({ id: 'evt_1', type: 'order:created', data: { order_id: 'ord_1', shop_id: 'shop_1' } });
+  const timestamp = 1_800_000_000;
+  const secret = 'whsec_example';
+  const signature = await computeCompletefulWebhookSignature(secret, timestamp, rawBody);
+  const verified = await verifyCompletefulWebhook({
+    rawBody,
+    signatureHeader: `t=${timestamp},v1=${signature}`,
+    secret,
+    nowSeconds: timestamp,
+  });
+  assert.equal(verified.ok, true);
+
+  const event = normalizeCompletefulEvent(JSON.parse(rawBody), { accountId: 'acct_1', webhookId: 'hook_1' });
+  assert.equal(event.eventKey, 'completeful.order.created');
+  assert.equal(event.subject, 'ord_1');
+  assert.equal(event.source.provider, 'completeful');
+  assert.equal(event.accountId, 'acct_1');
+});
+
+
+test('order creation uses canonical invocation idempotency and is marked billable/high risk', async () => {
+  const definition = COMPLETEFUL_TOOL_DEFINITIONS.find((tool) => tool.toolKey === 'completeful.order.create');
+  assert.equal(definition.sideEffectLevel, 'billable_external_write');
+  assert.equal(definition.idempotencyMode, 'required');
+  assert.equal(definition.riskLevel, 'high');
+  assert.equal(definition.receiptMode, 'redacted');
+
+  let captured = null;
+  const client = createCompletefulClient({
+    apiKey: 'capp_test_example',
+    fetchImpl: async (url, init) => {
+      captured = { url, init };
+      return new Response(JSON.stringify({ id: 'ord_1' }), { status: 201 });
+    },
+  });
+  const adapter = createCompletefulProviderAdapter(client);
+  const result = await adapter.invoke({
+    id: 'inv_order',
+    idempotencyKey: 'idem_order_1',
+    toolKey: 'completeful.order.create',
+    input: {
+      shop_id: 'shop_1',
+      body: { shipping_address: {}, line_items: [{}] },
+    },
+    requestedAt: Date.now(),
+  });
+  assert.equal(result.output.id, 'ord_1');
+  assert.equal(captured.init.headers.get('Idempotency-Key'), 'idem_order_1');
+});
+
+test('write tools fail closed for live credentials', async () => {
+  const client = createCompletefulClient({
+    apiKey: 'capp_live_example',
+    fetchImpl: async () => new Response('{}', { status: 200 }),
+  });
+  const adapter = createCompletefulProviderAdapter(client);
+  await assert.rejects(
+    () =>
+      adapter.invoke({
+        id: 'inv_publish',
+        toolKey: 'completeful.product.publish',
+        input: { shop_id: 'shop_1', product_id: 'prod_1' },
+        requestedAt: Date.now(),
+      }),
+    /live writes are disabled/i,
+  );
+});
+
+test('webhook.ensure does not duplicate an existing topic and redacts secrets', async () => {
+  let calls = 0;
+  const client = createCompletefulClient({
+    apiKey: 'capp_test_example',
+    fetchImpl: async () => {
+      calls += 1;
+      return new Response(
+        JSON.stringify({
+          items: [
+            {
+              id: 'wh_1',
+              topic: 'order:created',
+              url: 'https://example.com/webhooks/completeful',
+              secret: 'must-not-leak',
+            },
+          ],
+        }),
+        { status: 200 },
+      );
+    },
+  });
+  const adapter = createCompletefulProviderAdapter(client);
+  const result = await adapter.invoke({
+    id: 'inv_webhook',
+    toolKey: 'completeful.webhook.ensure',
+    input: {
+      shop_id: 'shop_1',
+      topic: 'order:created',
+      url: 'https://example.com/webhooks/completeful',
+    },
+    requestedAt: Date.now(),
+  });
+  assert.equal(calls, 1);
+  assert.equal(result.output.created, false);
+  assert.equal(result.output.webhook.secret, undefined);
+});

package/packages/theme-church-site/README.md

@@ -0,0 +1,10 @@
+# @inneranimalmedia/theme-church-site
+
+Installable AgentSam theme: **New Iberia Church of Christ**.
+
+Gallery preview source: `apps/theme-gallery-preview/themes/church-site`.
+
+```js
+import { createTheme } from "@inneranimalmedia/theme-church-site";
+const theme = createTheme();
+```

package/packages/theme-church-site/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@inneranimalmedia/theme-church-site",
+  "version": "0.1.0",
+  "description": "Real New Iberia Church of Christ public pages \u2014 visit, groups, mission, and giving.",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "engines": {
+    "node": ">=22 <25"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "agentsam": {
+    "kind": "theme",
+    "slug": "church-site",
+    "galleryPath": "apps/theme-gallery-preview/themes/church-site",
+    "installable": true,
+    "icon": "theme"
+  }
+}

package/packages/theme-church-site/src/harvest.json

@@ -0,0 +1,14 @@
+{
+  "harvest_batch": "theme-harvest-20260924",
+  "app_path": "apps/church-site",
+  "harvest_path": "work/theme-harvest/church-site",
+  "status": "scaffolded",
+  "source_hash": "0a8ae5de768f874ccdebe92a5e438ad8e4d51b4c5fdae9679c7e09268328fee6",
+  "capabilities": [
+    "cms.media",
+    "cms.pages",
+    "deploy.receipt",
+    "forms.leads",
+    "theme.storefront.shell"
+  ]
+}

package/packages/theme-church-site/src/index.js

@@ -0,0 +1,85 @@
+/** Deterministic installable theme contract for AgentSam gallery/CMS. */
+const THEME = {
+  "id": "theme.church-site",
+  "slug": "church-site",
+  "displayName": "New Iberia Church of Christ",
+  "version": "0.1.0",
+  "kind": "gallery-theme",
+  "icon": "theme",
+  "package": "@inneranimalmedia/theme-church-site",
+  "category": "Community",
+  "industries": [
+    "Church",
+    "Nonprofit"
+  ],
+  "tags": [
+    "groups",
+    "giving",
+    "visit"
+  ],
+  "description": "Real New Iberia Church of Christ public pages \u2014 visit, groups, mission, and giving.",
+  "features": [
+    "CMS",
+    "Events",
+    "Giving",
+    "Media"
+  ],
+  "pages": [
+    "Home",
+    "Beliefs",
+    "Community",
+    "Mission",
+    "Groups",
+    "Donate",
+    "Connect",
+    "Help"
+  ],
+  "preview": {
+    "kind": "live",
+    "card": "/themes/church-site/demo/",
+    "desktop": "/themes/church-site/demo/",
+    "mobile": "/themes/church-site/demo/",
+    "demoUrl": "/themes/church-site/demo/"
+  },
+  "installable": true,
+  "galleryPath": "apps/theme-gallery-preview/themes/church-site",
+  "capabilityHints": [
+    "theme.storefront.shell"
+  ]
+};
+
+export function createTheme() {
+  return structuredClone(THEME);
+}
+
+export default createTheme;
+
+/**
+ * agentsam_products UPSERT payload (caller resolves repository_id).
+ */
+export function createProductRow({ accountId = null, repositoryId = null, status = "prototype" } = {}) {
+  const theme = createTheme();
+  return {
+    account_id: accountId,
+    slug: theme.slug,
+    name: theme.displayName,
+    kind: "app",
+    status,
+    repository_id: repositoryId,
+    canonical_path: `packages/theme-${theme.slug}`,
+    package_name: theme.package,
+    metadata: {
+      origin: "gallery_mount",
+      normalization_state: status === "production" ? "promoted" : "portable-preview",
+      package: theme.package,
+      gallery_path: theme.galleryPath,
+      preview_kind: theme.preview?.kind || "static",
+      capabilities: theme.capabilityHints || [],
+      donor_name: theme.displayName,
+    },
+    relationships: [
+      { relationship_type: "packaged_as", target_type: "sdk-package", target_slug: `theme-${theme.slug}` },
+      { relationship_type: "depends_on", target_type: "capability", target_slug: "theme.storefront.shell" },
+    ],
+  };
+}

package/packages/theme-church-site/test/theme.test.mjs

@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { createTheme, createProductRow } from '../src/index.js';
+
+test('church-site theme package exports installable contract', () => {
+  const theme = createTheme();
+  assert.equal(theme.slug, "church-site");
+  assert.equal(theme.installable, true);
+  assert.equal(theme.package, "@inneranimalmedia/theme-church-site");
+  assert.ok(Array.isArray(theme.pages));
+});
+
+test('church-site createProductRow is D1-ready', () => {
+  const row = createProductRow({ accountId: 'acct_demo' });
+  assert.equal(row.kind, 'app');
+  assert.equal(row.slug, "church-site");
+  assert.equal(row.metadata.origin, 'gallery_mount');
+  assert.ok(Array.isArray(row.relationships));
+});

package/packages/theme-companions-site/README.md

@@ -0,0 +1,10 @@
+# @inneranimalmedia/theme-companions-site
+
+Installable AgentSam theme: **Companions of Caddo**.
+
+Gallery preview source: `apps/theme-gallery-preview/themes/companions-site`.
+
+```js
+import { createTheme } from "@inneranimalmedia/theme-companions-site";
+const theme = createTheme();
+```

package/packages/theme-companions-site/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@inneranimalmedia/theme-companions-site",
+  "version": "0.1.0",
+  "description": "Real Companions of Caddo public static surface \u2014 mission, campaigns, and involvement paths.",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "engines": {
+    "node": ">=22 <25"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "agentsam": {
+    "kind": "theme",
+    "slug": "companions-site",
+    "galleryPath": "apps/theme-gallery-preview/themes/companions-site",
+    "installable": true,
+    "icon": "theme"
+  }
+}

package/packages/theme-companions-site/src/harvest.json

@@ -0,0 +1,12 @@
+{
+  "harvest_batch": "theme-harvest-20260924",
+  "app_path": "apps/companions-site",
+  "harvest_path": "work/theme-harvest/companions-site",
+  "status": "scaffolded",
+  "source_hash": "cdad95d1a674b05456a6166f9fc70d86dce106d4215395601164ec40ac161f7b",
+  "capabilities": [
+    "cms.media",
+    "cms.pages",
+    "theme.storefront.shell"
+  ]
+}

package/packages/theme-companions-site/src/index.js

@@ -0,0 +1,83 @@
+/** Deterministic installable theme contract for AgentSam gallery/CMS. */
+const THEME = {
+  "id": "theme.companions-site",
+  "slug": "companions-site",
+  "displayName": "Companions of Caddo",
+  "version": "0.1.0",
+  "kind": "gallery-theme",
+  "icon": "theme",
+  "package": "@inneranimalmedia/theme-companions-site",
+  "category": "Community",
+  "industries": [
+    "Nonprofit",
+    "Animal Rescue"
+  ],
+  "tags": [
+    "donate",
+    "foster",
+    "campaigns"
+  ],
+  "description": "Real Companions of Caddo public static surface \u2014 mission, campaigns, and involvement paths.",
+  "features": [
+    "CMS",
+    "Donations",
+    "Campaigns",
+    "Email"
+  ],
+  "pages": [
+    "Home",
+    "About",
+    "Campaigns",
+    "Get Involved",
+    "Donate",
+    "Help"
+  ],
+  "preview": {
+    "kind": "live",
+    "card": "/themes/companions-site/demo/",
+    "desktop": "/themes/companions-site/demo/",
+    "mobile": "/themes/companions-site/demo/",
+    "demoUrl": "/themes/companions-site/demo/"
+  },
+  "installable": true,
+  "galleryPath": "apps/theme-gallery-preview/themes/companions-site",
+  "capabilityHints": [
+    "theme.storefront.shell"
+  ]
+};
+
+export function createTheme() {
+  return structuredClone(THEME);
+}
+
+export default createTheme;
+
+/**
+ * agentsam_products UPSERT payload (caller resolves repository_id).
+ */
+export function createProductRow({ accountId = null, repositoryId = null, status = "prototype" } = {}) {
+  const theme = createTheme();
+  return {
+    account_id: accountId,
+    slug: theme.slug,
+    name: theme.displayName,
+    kind: "app",
+    status,
+    repository_id: repositoryId,
+    canonical_path: `packages/theme-${theme.slug}`,
+    package_name: theme.package,
+    metadata: {
+      origin: "gallery_mount",
+      normalization_state: status === "production" ? "promoted" : "portable-preview",
+      package: theme.package,
+      gallery_path: theme.galleryPath,
+      preview_kind: theme.preview?.kind || "static",
+      capabilities: theme.capabilityHints || [],
+      donor_name: theme.displayName,
+    },
+    relationships: [
+      { relationship_type: "packaged_as", target_type: "sdk-package", target_slug: `theme-${theme.slug}` },
+      { relationship_type: "depends_on", target_type: "capability", target_slug: "theme.storefront.shell" },
+    ],
+  };
+}

package/packages/theme-companions-site/test/theme.test.mjs

@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { createTheme, createProductRow } from '../src/index.js';
+
+test('companions-site theme package exports installable contract', () => {
+  const theme = createTheme();
+  assert.equal(theme.slug, "companions-site");
+  assert.equal(theme.installable, true);
+  assert.equal(theme.package, "@inneranimalmedia/theme-companions-site");
+  assert.ok(Array.isArray(theme.pages));
+});
+
+test('companions-site createProductRow is D1-ready', () => {
+  const row = createProductRow({ accountId: 'acct_demo' });
+  assert.equal(row.kind, 'app');
+  assert.equal(row.slug, "companions-site");
+  assert.equal(row.metadata.origin, 'gallery_mount');
+  assert.ok(Array.isArray(row.relationships));
+});

package/packages/theme-floors-site/README.md

@@ -0,0 +1,10 @@
+# @inneranimalmedia/theme-floors-site
+
+Installable AgentSam theme: **Anything Floors & More**.
+
+Gallery preview source: `apps/theme-gallery-preview/themes/floors-site`.
+
+```js
+import { createTheme } from "@inneranimalmedia/theme-floors-site";
+const theme = createTheme();
+```

package/packages/theme-floors-site/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@inneranimalmedia/theme-floors-site",
+  "version": "0.1.0",
+  "description": "Real Anything Floors & More public site \u2014 services, gallery, process, and contact.",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "engines": {
+    "node": ">=22 <25"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "agentsam": {
+    "kind": "theme",
+    "slug": "floors-site",
+    "galleryPath": "apps/theme-gallery-preview/themes/floors-site",
+    "installable": true,
+    "icon": "theme"
+  }
+}

package/packages/theme-floors-site/src/harvest.json

@@ -0,0 +1,14 @@
+{
+  "harvest_batch": "theme-harvest-20260924",
+  "app_path": "apps/floors-site",
+  "harvest_path": "work/theme-harvest/floors-site",
+  "status": "scaffolded",
+  "source_hash": "2244de43568a0bb08d7d3779971c1fc0c6c832c226a65c7bb4313e8ac039add8",
+  "capabilities": [
+    "cms.media",
+    "cms.pages",
+    "deploy.receipt",
+    "forms.leads",
+    "theme.storefront.shell"
+  ]
+}

package/packages/theme-floors-site/src/index.js

@@ -0,0 +1,83 @@
+/** Deterministic installable theme contract for AgentSam gallery/CMS. */
+const THEME = {
+  "id": "theme.floors-site",
+  "slug": "floors-site",
+  "displayName": "Anything Floors & More",
+  "version": "0.1.0",
+  "kind": "gallery-theme",
+  "icon": "theme",
+  "package": "@inneranimalmedia/theme-floors-site",
+  "category": "Services",
+  "industries": [
+    "Contractor",
+    "Flooring"
+  ],
+  "tags": [
+    "gallery",
+    "estimates",
+    "projects"
+  ],
+  "description": "Real Anything Floors & More public site \u2014 services, gallery, process, and contact.",
+  "features": [
+    "CMS",
+    "Gallery",
+    "Forms",
+    "Auth"
+  ],
+  "pages": [
+    "Home",
+    "Services",
+    "Gallery",
+    "Process",
+    "Contact",
+    "Help"
+  ],
+  "preview": {
+    "kind": "live",
+    "card": "/themes/floors-site/demo/",
+    "desktop": "/themes/floors-site/demo/",
+    "mobile": "/themes/floors-site/demo/",
+    "demoUrl": "/themes/floors-site/demo/"
+  },
+  "installable": true,
+  "galleryPath": "apps/theme-gallery-preview/themes/floors-site",
+  "capabilityHints": [
+    "theme.storefront.shell"
+  ]
+};
+
+export function createTheme() {
+  return structuredClone(THEME);
+}
+
+export default createTheme;
+
+/**
+ * agentsam_products UPSERT payload (caller resolves repository_id).
+ */
+export function createProductRow({ accountId = null, repositoryId = null, status = "prototype" } = {}) {
+  const theme = createTheme();
+  return {
+    account_id: accountId,
+    slug: theme.slug,
+    name: theme.displayName,
+    kind: "app",
+    status,
+    repository_id: repositoryId,
+    canonical_path: `packages/theme-${theme.slug}`,
+    package_name: theme.package,
+    metadata: {
+      origin: "gallery_mount",
+      normalization_state: status === "production" ? "promoted" : "portable-preview",
+      package: theme.package,
+      gallery_path: theme.galleryPath,
+      preview_kind: theme.preview?.kind || "static",
+      capabilities: theme.capabilityHints || [],
+      donor_name: theme.displayName,
+    },
+    relationships: [
+      { relationship_type: "packaged_as", target_type: "sdk-package", target_slug: `theme-${theme.slug}` },
+      { relationship_type: "depends_on", target_type: "capability", target_slug: "theme.storefront.shell" },
+    ],
+  };
+}

package/packages/theme-floors-site/test/theme.test.mjs

@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { createTheme, createProductRow } from '../src/index.js';
+
+test('floors-site theme package exports installable contract', () => {
+  const theme = createTheme();
+  assert.equal(theme.slug, "floors-site");
+  assert.equal(theme.installable, true);
+  assert.equal(theme.package, "@inneranimalmedia/theme-floors-site");
+  assert.ok(Array.isArray(theme.pages));
+});
+
+test('floors-site createProductRow is D1-ready', () => {
+  const row = createProductRow({ accountId: 'acct_demo' });
+  assert.equal(row.kind, 'app');
+  assert.equal(row.slug, "floors-site");
+  assert.equal(row.metadata.origin, 'gallery_mount');
+  assert.ok(Array.isArray(row.relationships));
+});