@inneranimalmedia/agentsam-sdk 2.6.1 → 2.6.3

package/test/fixtures/cad/courtyard-house.json

@@ -0,0 +1,208 @@
+{
+  "id": "courtyard-house-fixture",
+  "name": "Courtyard House — baseline study",
+  "units": "in",
+  "scale": 1,
+  "gridSize": 12,
+  "snapToGrid": true,
+  "walls": [
+    {
+      "id": "wall-0",
+      "x1": 0,
+      "y1": 0,
+      "x2": 864,
+      "y2": 0,
+      "thickness": 6,
+      "height3D": 120,
+      "material": "wood_panel",
+      "exterior": true
+    },
+    {
+      "id": "wall-1",
+      "x1": 864,
+      "y1": 0,
+      "x2": 864,
+      "y2": 720,
+      "thickness": 6,
+      "height3D": 120,
+      "material": "wood_panel",
+      "exterior": true
+    },
+    {
+      "id": "wall-2",
+      "x1": 864,
+      "y1": 720,
+      "x2": 600,
+      "y2": 720,
+      "thickness": 6,
+      "height3D": 120,
+      "material": "wood_panel",
+      "exterior": true
+    },
+    {
+      "id": "wall-3",
+      "x1": 600,
+      "y1": 720,
+      "x2": 600,
+      "y2": 192,
+      "thickness": 6,
+      "height3D": 120,
+      "material": "wood_panel",
+      "exterior": true
+    },
+    {
+      "id": "wall-4",
+      "x1": 600,
+      "y1": 192,
+      "x2": 264,
+      "y2": 192,
+      "thickness": 6,
+      "height3D": 120,
+      "material": "wood_panel",
+      "exterior": true
+    },
+    {
+      "id": "wall-5",
+      "x1": 264,
+      "y1": 192,
+      "x2": 264,
+      "y2": 720,
+      "thickness": 6,
+      "height3D": 120,
+      "material": "wood_panel",
+      "exterior": true
+    },
+    {
+      "id": "wall-6",
+      "x1": 264,
+      "y1": 720,
+      "x2": 0,
+      "y2": 720,
+      "thickness": 6,
+      "height3D": 120,
+      "material": "wood_panel",
+      "exterior": true
+    },
+    {
+      "id": "wall-7",
+      "x1": 0,
+      "y1": 720,
+      "x2": 0,
+      "y2": 0,
+      "thickness": 6,
+      "height3D": 120,
+      "material": "wood_panel",
+      "exterior": true
+    }
+  ],
+  "doors": [
+    {
+      "id": "courtyard-door",
+      "wallId": "wall-4",
+      "distanceAlongWall": 0.5,
+      "width": 96,
+      "height": 96,
+      "swing": "double",
+      "openAngle": 0
+    }
+  ],
+  "windows": [],
+  "rooms": [
+    {
+      "id": "left-wing",
+      "name": "Primary / kitchen wing",
+      "points": [
+        [
+          0,
+          0
+        ],
+        [
+          264,
+          0
+        ],
+        [
+          264,
+          720
+        ],
+        [
+          0,
+          720
+        ]
+      ],
+      "areaSqFt": 1320,
+      "floorMaterial": "hardwood",
+      "color": "#ac9875"
+    },
+    {
+      "id": "right-wing",
+      "name": "Bedroom / media wing",
+      "points": [
+        [
+          600,
+          0
+        ],
+        [
+          864,
+          0
+        ],
+        [
+          864,
+          720
+        ],
+        [
+          600,
+          720
+        ]
+      ],
+      "areaSqFt": 1320,
+      "floorMaterial": "hardwood",
+      "color": "#ac9875"
+    },
+    {
+      "id": "living",
+      "name": "Living connection",
+      "points": [
+        [
+          264,
+          0
+        ],
+        [
+          600,
+          0
+        ],
+        [
+          600,
+          192
+        ],
+        [
+          264,
+          192
+        ]
+      ],
+      "areaSqFt": 448,
+      "floorMaterial": "hardwood",
+      "color": "#ac9875"
+    }
+  ],
+  "furniture": [],
+  "annotations": [],
+  "parametricObjects": [],
+  "lighting": {
+    "sunAltitude": 45,
+    "sunAzimuth": 135,
+    "intensity": 1,
+    "timeOfDay": "noon",
+    "shadows": true,
+    "ambientColor": "#334155"
+  },
+  "roofType": "none",
+  "ceilingHeight": 120,
+  "version": 1,
+  "updatedAt": 0,
+  "metadata": {
+    "createdAt": 0,
+    "updatedAt": 0,
+    "revision": 1,
+    "description": "Regression fixture, not final house plan. 72x60 ft reference envelope; rear courtyard opens +Y. 10ft height assumed. Roof intentionally omitted until supported."
+  }
+}

package/test/go/cloudflare-probe.test.mjs

@@ -0,0 +1,53 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { extractWorkersDevUrl, probeGoDeployment } from '../../src/go/cloudflare.js';
+import { buildProductRow } from '../../src/go/receipts.js';
+
+test('extractWorkersDevUrl parses wrangler output', () => {
+  const url = extractWorkersDevUrl('Published agentsam-go-worker\n  https://agentsam-go-worker.example.workers.dev\n');
+  assert.equal(url, 'https://agentsam-go-worker.example.workers.dev');
+});
+
+test('probeGoDeployment requires deterministic Go capabilities', async () => {
+  const responses = new Map([
+    ['/health', { status: 200, body: { ok: true, service: 'agentsam-go-worker', runtime: 'go' } }],
+    ['/v1/runtime', { status: 200, body: { schema: 'agentsam.go-runtime.v1', capabilities: ['hash'] } }],
+    ['/v1/hash', { status: 200, body: { hash: 'a'.repeat(64), algorithm: 'sha256' } }],
+    ['/v1/inspect', { status: 200, body: { findings: [{ kind: 'hardcoded_color', value: '#2563eb' }] } }],
+  ]);
+  let inspectCalls = 0;
+  const fetchImpl = async (url, init = {}) => {
+    const pathname = new URL(url).pathname;
+    if (pathname === '/v1/inspect') {
+      inspectCalls += 1;
+      if (inspectCalls === 2) {
+        return {
+          status: 400,
+          async json() { return { ok: false, error: 'files_required' }; },
+        };
+      }
+    }
+    const row = responses.get(pathname);
+    return {
+      status: row.status,
+      async json() { return row.body; },
+    };
+  };
+  const result = await probeGoDeployment('https://example.workers.dev', { fetchImpl });
+  assert.equal(result.ok, true);
+  assert.equal(result.results.deterministic_inspect.ok, true);
+  assert.equal(result.results.malformed_rejected.ok, true);
+});
+
+test('buildProductRow stays on agentsam_products projection', () => {
+  const row = buildProductRow({
+    product: 'agentsam-go-worker',
+    repositoryId: 'agentsam-sdk',
+    commit: 'abc',
+    url: 'https://x.workers.dev',
+    health: 'healthy',
+  });
+  assert.equal(row.slug, 'agentsam-go-worker');
+  assert.equal(row.kind, 'service');
+  assert.equal(row.metadata.runtime, 'go');
+});

package/test/integration/app-command.test.mjs

@@ -0,0 +1,55 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import test from 'node:test';
+import { listAppManifests } from '../../src/commands/app.js';
+
+test('lists agentsam.app.json manifests for product apps', () => {
+  const apps = listAppManifests();
+  const ids = apps.map((row) => row.id).sort();
+  assert.ok(ids.includes('cad-creator'));
+  assert.ok(ids.includes('local-studio'));
+  assert.ok(ids.includes('client-cms-editor'));
+  assert.ok(ids.includes('ecommerce-cms-agentsam'));
+});
+
+
+test('Ecommerce CMS app bin exposes truthful runnable doctor state', () => {
+  const bin = path.resolve('apps/ecommerce-cms-agentsam/bin/agentsam-ecommerce.mjs');
+  const result = spawnSync(process.execPath, [bin, 'doctor', '--json'], {
+    cwd: path.resolve('.'),
+    encoding: 'utf8',
+  });
+
+  assert.equal(result.status, 0, result.stderr);
+  const report = JSON.parse(result.stdout);
+  assert.equal(report.app_id, 'ecommerce-cms-agentsam');
+  assert.equal(report.source.frontend, true);
+  assert.equal(report.runtime.package_json, true);
+  assert.equal(report.runtime.runnable, true);
+  assert.equal(report.manifest_runtime.local_preview, 'ready');
+  assert.equal(report.manifest_runtime.source_scaffold, 'ready');
+  assert.equal(report.contract_consistent, true);
+});
+
+test('Ecommerce CMS app manifest and package agree on executable preview', () => {
+  const manifest = JSON.parse(
+    fs.readFileSync(path.resolve('apps/ecommerce-cms-agentsam/agentsam.app.json'), 'utf8'),
+  );
+  const pkg = JSON.parse(
+    fs.readFileSync(path.resolve('apps/ecommerce-cms-agentsam/package.json'), 'utf8'),
+  );
+  const frontendPkg = JSON.parse(
+    fs.readFileSync(path.resolve('apps/ecommerce-cms-agentsam/frontend/package.json'), 'utf8'),
+  );
+
+  assert.equal(manifest.package, pkg.name);
+  assert.equal(manifest.bin, 'bin/agentsam-ecommerce.mjs');
+  assert.equal(manifest.runtime.local_preview, 'ready');
+  assert.equal(manifest.runtime.source_scaffold, 'ready');
+  assert.equal(manifest.preview.entry, '/admin');
+  assert.equal(manifest.preview.port, 4174);
+  assert.equal(typeof pkg.scripts.preview, 'string');
+  assert.equal(typeof frontendPkg.scripts.preview, 'string');
+});

package/test/integration/cad-discovery.test.mjs

@@ -0,0 +1,158 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import {
+  discoverOpenScad,
+  openScadStatus,
+  discoverFreeCad,
+  freeCadStatus,
+  meshyStatus,
+  mujocoStatus,
+  discoverAllCadTools,
+  getInstallGuidance,
+} from '../../src/lib/cad/index.js';
+
+function makeFixture(t, name) {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), `agentsam-${name}-test-`));
+  t.after(() => fs.rmSync(root, { recursive: true, force: true }));
+  const binary = path.join(root, process.platform === 'win32' ? `${name}.exe` : name);
+  fs.writeFileSync(binary, `fake ${name}\n`);
+  return { root, binary };
+}
+
+test('discoverOpenScad honors explicit binary before env and path', (t) => {
+  const { binary } = makeFixture(t, 'openscad');
+  const result = discoverOpenScad({
+    openscadBin: binary,
+    env: { AGENTSAM_OPENSCAD_BIN: '/nonexistent/bin' },
+  });
+  assert.equal(result.source, 'explicit');
+  assert.equal(result.binary, fs.realpathSync(binary));
+});
+
+test('discoverOpenScad honors AGENTSAM_OPENSCAD_BIN when explicit is not set', (t) => {
+  const { binary } = makeFixture(t, 'openscad');
+  const result = discoverOpenScad({
+    env: { AGENTSAM_OPENSCAD_BIN: binary },
+  });
+  assert.equal(result.source, 'env');
+  assert.equal(result.binary, fs.realpathSync(binary));
+});
+
+test('openScadStatus probes version boundedly and returns deterministic receipt', async (t) => {
+  const { binary } = makeFixture(t, 'openscad');
+  const calls = [];
+  const status = await openScadStatus({
+    openscadBin: binary,
+    runProcessImpl: async (command, args) => {
+      calls.push({ command, args });
+      return { code: 0, stdout: '', stderr: 'OpenSCAD version 2026.04.26\n' };
+    },
+  });
+
+  assert.equal(status.tool, 'openscad');
+  assert.equal(status.available, true);
+  assert.equal(status.version, '2026.04.26');
+  assert.equal(status.execution_lane, 'native');
+  assert.deepEqual(calls[0], { command: fs.realpathSync(binary), args: ['-v'] });
+});
+
+test('discoverFreeCad honors explicit binary and AGENTSAM_FREECAD_BIN', (t) => {
+  const { binary } = makeFixture(t, 'FreeCADCmd');
+  const result = discoverFreeCad({
+    freecadBin: binary,
+    env: { AGENTSAM_FREECAD_BIN: '/nonexistent/path' },
+  });
+  assert.equal(result.source, 'explicit');
+  assert.equal(result.binary, fs.realpathSync(binary));
+
+  const envResult = discoverFreeCad({
+    env: { AGENTSAM_FREECAD_BIN: binary },
+  });
+  assert.equal(envResult.source, 'env');
+  assert.equal(envResult.binary, fs.realpathSync(binary));
+});
+
+test('freeCadStatus probes version and returns deterministic receipt', async (t) => {
+  const { binary } = makeFixture(t, 'FreeCADCmd');
+  const calls = [];
+  const status = await freeCadStatus({
+    freecadBin: binary,
+    runProcessImpl: async (command, args) => {
+      calls.push({ command, args });
+      return { code: 0, stdout: 'FreeCAD 1.1.1 Revision: 20260414 (Git shallow)\n', stderr: '' };
+    },
+  });
+
+  assert.equal(status.tool, 'freecad');
+  assert.equal(status.available, true);
+  assert.equal(status.version, 'FreeCAD 1.1.1 Revision: 20260414 (Git shallow)');
+  assert.equal(status.execution_lane, 'native');
+  assert.deepEqual(calls[0], { command: fs.realpathSync(binary), args: ['--version'] });
+});
+
+test('meshyStatus discovers API key configuration via environment', () => {
+  const noKey = meshyStatus({ env: {} });
+  assert.equal(noKey.available, false);
+  assert.equal(noKey.source, 'none');
+  assert.equal(noKey.execution_lane, 'cloud_byok');
+
+  const withKey = meshyStatus({ env: { MESHY_API_KEY: 'msy_test_secret_key' } });
+  assert.equal(withKey.available, true);
+  assert.equal(withKey.source, 'env');
+  assert.equal(withKey.version, 'v2-api');
+});
+
+test('mujocoStatus returns browser WASM bundled capability', () => {
+  const status = mujocoStatus();
+  assert.equal(status.tool, 'mujoco');
+  assert.equal(status.available, true);
+  assert.equal(status.execution_lane, 'browser_wasm');
+});
+
+test('discoverAllCadTools aggregates deterministic receipts across engines', async (t) => {
+  const { binary: openscad } = makeFixture(t, 'openscad');
+  const { binary: freecad } = makeFixture(t, 'FreeCADCmd');
+  const { binary: blender } = makeFixture(t, 'blender');
+
+  const report = await discoverAllCadTools({
+    openscadBin: openscad,
+    freecadBin: freecad,
+    blenderBin: blender,
+    env: { MESHY_API_KEY: 'test_key' },
+    runProcessImpl: async (command, args) => {
+      if (args[0] === '-v') return { code: 0, stdout: '', stderr: 'OpenSCAD version 2026.04.26\n' };
+      if (command.includes('FreeCAD')) return { code: 0, stdout: 'FreeCAD 1.1.1 Revision: 20260414\n', stderr: '' };
+      return { code: 0, stdout: 'Blender 5.0.1\n', stderr: '' };
+    },
+  });
+
+  assert.equal(report.schema_version, 1);
+  assert.equal(report.total_tools, 5);
+  assert.equal(report.available_tools, 5);
+  assert.equal(report.all_systems_ready, true);
+  assert.equal(report.tools.length, 5);
+});
+
+test('getInstallGuidance provides exact OS package manager commands', () => {
+  const darwinOpenScad = getInstallGuidance('openscad', 'darwin');
+  assert.equal(darwinOpenScad.command, 'brew install openscad');
+
+  const linuxFreeCad = getInstallGuidance('freecad', 'linux');
+  assert.match(linuxFreeCad.command, /apt-get install.*freecad/);
+
+  const winBlender = getInstallGuidance('blender', 'win32');
+  assert.equal(winBlender.command, 'winget install BlenderFoundation.Blender');
+});
+
+test('discoverOpenScad returns binary: null when not found on host (no hardcoded defaults)', () => {
+  const emptyDiscovery = discoverOpenScad({
+    env: { PATH: '' },
+    platform: 'unknown_os',
+  });
+  assert.equal(emptyDiscovery.binary, null);
+  assert.equal(emptyDiscovery.source, 'none');
+});
+