@inneranimalmedia/agentsam-sdk 2.6.2 → 2.6.4

package/src/go/official-registry.js

@@ -0,0 +1,280 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { createHash, randomBytes } from 'node:crypto';
+import { SDK_ROOT } from './discover.js';
+import { writeProductRegistryLocal } from './receipts.js';
+import { innerAnimalMediaOfficialReleaseEnabled } from './official-release.js';
+
+const DEFAULT_DB = 'inneranimalmedia-business';
+const DEFAULT_WRANGLER = 'apps/local-studio/backend/wrangler.jsonc';
+const DEFAULT_REPOSITORY_ID = 'github:samprimeaux/agentsam-sdk';
+
+function quote(value) {
+  if (value == null) return 'NULL';
+  if (typeof value === 'number') return String(value);
+  return `'${String(value).replaceAll("'", "''")}'`;
+}
+
+function json(value) {
+  return JSON.stringify(value);
+}
+
+export function buildGoProductRegistrySql({
+  product = 'agentsam-go-worker',
+  status = 'deployed',
+  version = '0.1.0',
+  repositoryId = DEFAULT_REPOSITORY_ID,
+  canonicalPath = 'apps/agentsam-go-worker',
+  packageName = '@inneranimalmedia/agentsam-go-worker',
+  url = null,
+  commit = null,
+  health = null,
+  workerDeploymentId = null,
+  workerVersionId = null,
+  artifactDigest = null,
+  containerDigest = null,
+  description = 'AgentSam Go runtime (Worker edge + native Cloudflare Container)',
+} = {}) {
+  const metadata = {
+    runtime: 'go',
+    origin: 'agentsam.go.cloudflare',
+    deployment: {
+      provider: 'cloudflare',
+      mode: 'worker-container',
+      url: url || null,
+      health: health || null,
+      worker_deployment_id: workerDeploymentId,
+      worker_version_id: workerVersionId,
+      artifact_digest: artifactDigest,
+      container_image_digest: containerDigest,
+    },
+    source: { commit: commit || null },
+    capabilities: ['hash', 'inspect', 'runtime', 'capabilities'],
+    cli_commands: [
+      {
+        id: 'agentsam:go:cloudflare',
+        command: 'agentsam go --cloudflare agentsam-go-worker',
+        description: 'Discover, build, deploy, and verify the Go runtime product',
+      },
+    ],
+  };
+
+  const statements = [];
+  statements.push(
+    `INSERT INTO agentsam_products (
+  slug, name, kind, status, description, repository_id, canonical_path, package_name, version, tags, metadata, updated_at
+) VALUES (
+  ${quote(product)},
+  ${quote(product)},
+  'service',
+  ${quote(status)},
+  ${quote(description)},
+  ${quote(repositoryId)},
+  ${quote(canonicalPath)},
+  ${quote(packageName)},
+  ${quote(version)},
+  ${quote(json(['go', 'cloudflare', 'runtime']))},
+  ${quote(json(metadata))},
+  unixepoch()
+)
+ON CONFLICT(slug) DO UPDATE SET
+  name = excluded.name,
+  kind = excluded.kind,
+  status = excluded.status,
+  description = excluded.description,
+  repository_id = COALESCE(excluded.repository_id, agentsam_products.repository_id),
+  canonical_path = excluded.canonical_path,
+  package_name = excluded.package_name,
+  version = excluded.version,
+  tags = excluded.tags,
+  metadata = excluded.metadata,
+  updated_at = excluded.updated_at;`,
+  );
+
+  const relationships = [
+    {
+      target_type: 'code_repository',
+      target_id: repositoryId,
+      relationship_type: 'sourced_from',
+      metadata: { origin: 'agentsam.go.cloudflare' },
+    },
+    {
+      target_type: 'runtime',
+      target_id: 'go',
+      relationship_type: 'runs_on',
+      metadata: { origin: 'agentsam.go.cloudflare' },
+    },
+    {
+      target_type: 'cloudflare_worker',
+      target_id: product,
+      relationship_type: 'deployed_as',
+      metadata: {
+        origin: 'agentsam.go.cloudflare',
+        url: url || null,
+        worker_deployment_id: workerDeploymentId,
+        worker_version_id: workerVersionId,
+      },
+    },
+    {
+      target_type: 'cli_command',
+      target_id: 'agentsam:go:cloudflare',
+      relationship_type: 'exposes_command',
+      metadata: {
+        origin: 'agentsam.go.cloudflare',
+        command: 'agentsam go --cloudflare agentsam-go-worker',
+      },
+    },
+  ];
+
+  for (const rel of relationships) {
+    statements.push(
+      `INSERT INTO asset_relationships (source_type, source_id, target_type, target_id, relationship_type, metadata)
+SELECT 'agentsam_product', p.id, ${quote(rel.target_type)}, ${quote(rel.target_id)}, ${quote(rel.relationship_type)}, ${quote(json(rel.metadata))}
+FROM agentsam_products p WHERE p.slug = ${quote(product)}
+ON CONFLICT(source_type, source_id, target_type, target_id, relationship_type)
+DO UPDATE SET metadata = excluded.metadata;`,
+    );
+  }
+
+  return statements.join('\n');
+}
+
+export function applyInnerAnimalMediaOfficialGoProductRegistry({
+  productRoot,
+  product = 'agentsam-go-worker',
+  officialRelease = false,
+  cwd = SDK_ROOT,
+  status = 'deployed',
+  url = null,
+  commit = null,
+  health = null,
+  workerDeploymentId = null,
+  workerVersionId = null,
+  artifactDigest = null,
+  containerDigest = null,
+  dryRun = false,
+  skipRemote = false,
+  spawn = spawnSync,
+  repositoryId = DEFAULT_REPOSITORY_ID,
+} = {}) {
+  if (!officialRelease || !innerAnimalMediaOfficialReleaseEnabled()) {
+    const err = new Error('inneranimalmedia_registry_official_release_required');
+    err.code = 'inneranimalmedia_registry_official_release_required';
+    err.legacy_code = 'iam_registry_official_release_required';
+    err.hint = 'InnerAnimalMedia D1 registration is restricted to the explicit official release path.';
+    throw err;
+  }
+
+  const officialStatus = status === 'deployed' ? 'production' : status;
+  const allowedStatuses = new Set(['prototype', 'scaffolded', 'wired', 'production', 'deprecated']);
+  if (!allowedStatuses.has(officialStatus)) {
+    const err = new Error('inneranimalmedia_registry_status_invalid');
+    err.code = 'inneranimalmedia_registry_status_invalid';
+    err.legacy_code = 'iam_registry_status_invalid';
+    err.detail = { received: status, normalized: officialStatus };
+    throw err;
+  }
+
+  const sql = buildGoProductRegistrySql({
+    product,
+    status: officialStatus,
+    url,
+    commit,
+    health,
+    workerDeploymentId,
+    workerVersionId,
+    artifactDigest,
+    containerDigest,
+    repositoryId,
+  });
+
+  const localRow = {
+    slug: product,
+    kind: 'service',
+    name: product,
+    status: officialStatus,
+    repository_id: repositoryId,
+    canonical_path: 'apps/agentsam-go-worker',
+    package_name: '@inneranimalmedia/agentsam-go-worker',
+    metadata: {
+      runtime: 'go',
+      deployment: {
+        provider: 'cloudflare',
+        mode: 'worker-container',
+        url,
+        health,
+        worker_deployment_id: workerDeploymentId,
+        worker_version_id: workerVersionId,
+        artifact_digest: artifactDigest,
+        container_image_digest: containerDigest,
+      },
+      source: { commit },
+    },
+  };
+  const localPath = productRoot ? writeProductRegistryLocal(productRoot, localRow) : null;
+
+  if (dryRun || skipRemote) {
+    return {
+      ok: true,
+      remote: false,
+      skipped: true,
+      reason: dryRun ? 'dry_run' : 'skip_remote',
+      sql,
+      localPath,
+      sql_sha256: createHash('sha256').update(sql).digest('hex'),
+    };
+  }
+
+  const wranglerConfig = path.resolve(cwd, DEFAULT_WRANGLER);
+  const tmpFile = path.join(os.tmpdir(), `agentsam-go-registry-${Date.now()}-${randomBytes(3).toString('hex')}.sql`);
+  fs.writeFileSync(tmpFile, `${sql}\n`, 'utf8');
+
+  try {
+    const args = ['d1', 'execute', DEFAULT_DB, '--remote', '--yes', `--file=${tmpFile}`];
+    if (fs.existsSync(wranglerConfig)) args.push('--config', wranglerConfig);
+
+    const wranglerJs = path.join(cwd, 'apps/agentsam-go-worker/node_modules/wrangler/bin/wrangler.js');
+    const localStudioWrangler = path.join(cwd, 'apps/local-studio/node_modules/wrangler/bin/wrangler.js');
+    const rootWrangler = path.join(cwd, 'node_modules/wrangler/bin/wrangler.js');
+    let command = 'npx';
+    let cmdArgs = ['--yes', 'wrangler', ...args];
+    for (const candidate of [wranglerJs, localStudioWrangler, rootWrangler]) {
+      if (fs.existsSync(candidate)) {
+        command = process.execPath;
+        cmdArgs = [candidate, ...args];
+        break;
+      }
+    }
+
+    const res = spawn(command, cmdArgs, {
+      cwd,
+      encoding: 'utf8',
+      env: { ...process.env },
+    });
+    if (res.status !== 0) {
+      const err = new Error('d1_registry_upsert_failed');
+      err.detail = `${res.stdout || ''}\n${res.stderr || ''}`.trim().slice(0, 2000);
+      throw err;
+    }
+
+    return {
+      ok: true,
+      remote: true,
+      database: DEFAULT_DB,
+      localPath,
+      sql_sha256: createHash('sha256').update(sql).digest('hex'),
+      stdout: (res.stdout || '').trim().slice(0, 500),
+    };
+  } finally {
+    try { fs.unlinkSync(tmpFile); } catch { /* ignore */ }
+  }
+}
+
+/**
+ * Backward-compatible SDK export. New code should use
+ * applyInnerAnimalMediaOfficialGoProductRegistry.
+ */
+export const applyIamOfficialGoProductRegistry =
+  applyInnerAnimalMediaOfficialGoProductRegistry;

package/src/go/official-release.js

@@ -0,0 +1,10 @@
+export const INNERANIMALMEDIA_OFFICIAL_RELEASE_ENV =
+  'AGENTSAM_INNERANIMALMEDIA_OFFICIAL_RELEASE';
+
+export const LEGACY_IAM_OFFICIAL_RELEASE_ENV =
+  'AGENTSAM_IAM_OFFICIAL_RELEASE';
+
+export function innerAnimalMediaOfficialReleaseEnabled(env = process.env) {
+  return env?.[INNERANIMALMEDIA_OFFICIAL_RELEASE_ENV] === '1'
+    || env?.[LEGACY_IAM_OFFICIAL_RELEASE_ENV] === '1';
+}

package/src/go/receipts.js

@@ -0,0 +1,144 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+export function goStateDir(productRoot) {
+  const dir = path.join(productRoot, '.agentsam', 'go');
+  fs.mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+export function writeGoBuildReceipt(productRoot, receipt) {
+  const dir = goStateDir(productRoot);
+  const file = path.join(dir, 'latest.build-receipt.json');
+  fs.writeFileSync(file, JSON.stringify(receipt, null, 2) + '\n');
+  return file;
+}
+
+export function writeDeploymentReceipt(productRoot, receipt) {
+  const dir = goStateDir(productRoot);
+  const file = path.join(dir, 'latest.deployment-receipt.json');
+  const payload = { schema: 'agentsam.deployment-receipt.v1', ...receipt };
+  fs.writeFileSync(file, JSON.stringify(payload, null, 2) + '\n');
+  return file;
+}
+
+export function writeDeploymentValidationReceipt(productRoot, receipt) {
+  const dir = goStateDir(productRoot);
+  const file = path.join(dir, 'latest.deployment-validation-receipt.json');
+  const payload = {
+    schema: 'agentsam.deployment-validation-receipt.v1',
+    ...receipt,
+  };
+  fs.writeFileSync(file, JSON.stringify(payload, null, 2) + '\n');
+  return file;
+}
+
+export function writeProductValidationLocal(productRoot, row) {
+  const dir = goStateDir(productRoot);
+  const file = path.join(dir, 'product.validation-registry.json');
+  const payload = {
+    schema: 'agentsam.product-validation-registry.v1',
+    registry: 'agentsam_products',
+    authority: 'local_validation',
+    row,
+    written_at: new Date().toISOString(),
+  };
+  fs.writeFileSync(file, JSON.stringify(payload, null, 2) + '\n');
+  return file;
+}
+
+export function writeProductRegistryLocal(productRoot, row) {
+  const dir = goStateDir(productRoot);
+  const file = path.join(dir, 'product.registry.json');
+  const payload = {
+    schema: 'agentsam.product-local-registry.v1',
+    registry: 'agentsam_products',
+    note: 'Local AgentSam projection. InnerAnimalMedia D1 registration is a separate explicit official-release operation.',
+    row,
+    written_at: new Date().toISOString(),
+  };
+  fs.writeFileSync(file, JSON.stringify(payload, null, 2) + '\n');
+  return file;
+}
+
+export function readLatestStatus(productRoot) {
+  const dir = path.join(productRoot, '.agentsam', 'go');
+  const buildPath = path.join(dir, 'latest.build-receipt.json');
+  const deployPath = path.join(dir, 'latest.deployment-receipt.json');
+  const productPath = path.join(dir, 'product.registry.json');
+  const validationPath = path.join(dir, 'latest.deployment-validation-receipt.json');
+  const validationProductPath = path.join(dir, 'product.validation-registry.json');
+  return {
+    build: fs.existsSync(buildPath) ? JSON.parse(fs.readFileSync(buildPath, 'utf8')) : null,
+    deployment: fs.existsSync(deployPath) ? JSON.parse(fs.readFileSync(deployPath, 'utf8')) : null,
+    product: fs.existsSync(productPath) ? JSON.parse(fs.readFileSync(productPath, 'utf8')) : null,
+    validation: fs.existsSync(validationPath) ? JSON.parse(fs.readFileSync(validationPath, 'utf8')) : null,
+    validation_product: fs.existsSync(validationProductPath)
+      ? JSON.parse(fs.readFileSync(validationProductPath, 'utf8'))
+      : null,
+  };
+}
+
+export function buildProductRow({
+  product,
+  repositoryId,
+  commit,
+  sourceIdentity = null,
+  packageName = '@inneranimalmedia/agentsam-go-worker',
+  packageVersion = '0.1.0',
+  cloudflareAccount = null,
+  url,
+  health,
+  workerDeploymentId = null,
+  workerVersionId = null,
+  artifactDigest = null,
+  containerDigest = null,
+}) {
+  return {
+    slug: product,
+    kind: 'service',
+    name: product,
+    status: health === 'healthy' ? 'deployed' : (health === 'pending' ? 'built' : 'degraded'),
+    repository_id: repositoryId || null,
+    canonical_path: 'apps/agentsam-go-worker',
+    package_name: packageName,
+    version: packageVersion,
+    metadata: {
+      runtime: 'go',
+      deployment: {
+        provider: 'cloudflare',
+        mode: 'worker-container',
+        url: url || null,
+        health: health || null,
+        worker_deployment_id: workerDeploymentId,
+        worker_version_id: workerVersionId,
+        artifact_digest: artifactDigest,
+        container_image_digest: containerDigest,
+        cloudflare_account: cloudflareAccount,
+      },
+      source: {
+        identity: sourceIdentity,
+        commit: commit || null,
+        package_name: packageName,
+        package_version: packageVersion,
+      },
+      relationships: [
+        repositoryId
+          ? { type: 'source_repository', target: repositoryId }
+          : { type: 'source_package', target: packageName },
+        {
+          type: 'runtime',
+          target: 'go',
+          target_type: 'runtime',
+          relationship_type: 'runs_on',
+        },
+        {
+          type: 'edge',
+          target: product,
+          target_type: 'cloudflare_worker',
+          relationship_type: 'deployed_as',
+        },
+      ],
+    },
+  };
+}

package/src/go/verify.js

@@ -0,0 +1,38 @@
+import { readLatestStatus } from './receipts.js';
+import { probeGoDeployment } from './cloudflare.js';
+import { runGoTests, runGoVet } from './build.js';
+
+export async function verifyGoProduct({
+  productRoot,
+  stateRoot = productRoot,
+  runtimeRoot,
+  url = null,
+  fetchImpl = globalThis.fetch,
+  skipLive = false,
+} = {}) {
+  const status = readLatestStatus(stateRoot);
+  const tests = runtimeRoot ? runGoTests(runtimeRoot) : { ok: false, error: 'no_runtime' };
+  const vet = runtimeRoot ? runGoVet(runtimeRoot) : { ok: false, error: 'no_runtime' };
+  const liveUrl = url || status.deployment?.url || null;
+  let live = { skipped: true, ok: false };
+  if (!skipLive && liveUrl) {
+    live = await probeGoDeployment(liveUrl, {
+      fetchImpl,
+      expectedSource: status.deployment?.source_identity || status.build?.source?.identity || null,
+      expectedSourceCommit: status.deployment?.source_commit || status.build?.source?.commit || null,
+      expectedTarget: 'cloudflare',
+      edge: true,
+    });
+  }
+
+  const ok = Boolean(tests.ok && vet.ok && (skipLive || !liveUrl || live.ok));
+  return {
+    schema: 'agentsam.go-verify.v1',
+    ok,
+    tests: { go_test: tests.ok, go_vet: vet.ok },
+    deployment: status.deployment,
+    build: status.build,
+    product: status.product,
+    live,
+  };
+}

package/src/index.js

@@ -3,8 +3,44 @@
 import pkg from '../package.json' with { type: 'json' };
 
 export { AgentSam } from './AgentSam.js';
+export {
+  SAM_RESULT_SCHEMA,
+  SAM_EXPANSION,
+  defineSamOperation,
+  registerSamOperation,
+  getSamOperation,
+  listSamOperations,
+  toSamOperationCard,
+  buildSamResult,
+  AgentSamClient,
+  createAgentSamClient,
+  ensureSeedOperations,
+  SEED_OPERATIONS,
+} from './sam/index.js';
+export {
+  CLI_COMMAND_CATALOG,
+  getCliCommand,
+  listCliCommands,
+  printAssistTip,
+  suggestCliCommands,
+} from './cli/command-catalog.js';
 export { routeIntent } from './lib/router.js';
 export { searchToolCards, toToolCard, hydrateToolSchemas } from './tools/index.js';
+export {
+  AGENTSAM_PLUGIN_SCHEMA_VERSION,
+  AGENTSAM_MCP_PLUGIN_MANIFEST,
+  CLOUDFLARE_PLUGIN_MANIFEST,
+  normalizePluginKey,
+  normalizePluginManifest,
+  installPlugin,
+  listPlugins,
+  listPluginTools,
+  recordPluginHealthCheck,
+  recordToolCall,
+  createPluginRuntime,
+  createPluginCapabilityAdapter,
+  executeAgentSamTool,
+} from './plugins/index.js';
 export { getToolCatalog } from './lib/tools.js';
 export { scaffoldProject } from './lib/scaffold.js';
 export {
@@ -38,6 +74,7 @@ export {
   getCapabilityManifest,
   listCapabilities,
   repositorySnapshot,
+  terminalExec,
 } from './capabilities/index.js';
 export { getPreset, listPresets, resolvePreset, getAddon, listAddons } from './presets/index.js';
 export {
@@ -77,6 +114,8 @@ export {
   listModelCatalog,
   getModelRecord,
   calculateModelCost,
+  normalizeModelPolicy,
+  loadModelPolicy,
 } from './models/index.js';
 export {
   AGENT_EVENT_TYPES,
@@ -94,7 +133,53 @@ export {
   extractOpenAIFunctionCalls,
 } from './providers/index.js';
 export {
+  AgentSamError,
   AgentSamDiagnosticError,
+  ERROR_SCHEMA_VERSION,
+  ERROR_CODE,
+  ERROR_REASON,
+  ERROR_SEVERITY,
+  ERROR_SOURCE_KIND,
+  ERROR_RESOLUTION_OWNER,
+  ERROR_DOMAIN,
+  REMEDIATION_ACTION,
+  createErrorEnvelope,
+  normalizeError,
+  asAgentSamError,
+  serializeError,
+  parseError,
+  fingerprintError,
+  shouldRetry,
+  retryDelayMs,
+  planRecovery,
+  inferFailureClass,
+  inferSideEffectState,
+  FAILURE_CLASS,
+  SIDE_EFFECT_STATE,
+  RECOVERY_SCHEMA,
+  toHttpError,
+  fromHttpError,
+  renderError,
+  classifyFailure,
+  classifyProviderFailure,
+  classifyOpenAIFailure,
+  classifyAnthropicFailure,
+  classifyGoogleAIFailure,
+  classifyGeminiFailure,
+  classifyCursorFailure,
+  classifyGitHubFailure,
+  classifyCloudflareFailure,
+  classifyDockerFailure,
+  classifyGcpFailure,
+  classifyCadFailure,
+  classifyFreeCadFailure,
+  classifyOpenScadFailure,
+  classifyBlenderFailure,
+  classifyMeshyFailure,
+  classifyDeviceFailure,
+  classifyInternalFailure,
+  classifyProcessFailure,
+  classifyOAuthFailure,
   classifyOpenAIError,
   createOpenAIHttpError,
   createProcessDiagnosticError,
@@ -118,9 +203,50 @@ export {
   createCapabilityAdapter,
   buildAgentToolSurface,
   capabilityFunctionName,
+  runAgentSamModelTurn,
+  runAgentSamTurn,
   runResponsesAgent,
 } from './agent/index.js';
-export { listContextEvalFixtures, evaluateContextFixture } from './eval/index.js';
+export {
+  listContextEvalFixtures,
+  evaluateContextFixture,
+  startLiveEvalRun,
+  getLiveEvalStatus,
+  finishLiveEvalRun,
+} from './eval/index.js';
+export {
+  MCP_AUTHORITY_SCHEMA,
+  SERVER_CATALOG_CACHE_SCHEMA,
+  DEFAULT_SERVER_CATALOG_URL,
+  SEED_MCP_SERVER_CATALOG,
+  MCP_PRESETS,
+  readMcpServer,
+  writeMcpServer,
+  listMcpServers,
+  deleteMcpServer,
+  fetchMcpServerCatalog,
+  listKnownServers,
+  resolveServerPreset,
+  SUPPORTED_CLIENTS,
+  DEFAULT_CLIENT_REGISTRY_URL,
+  CLIENT_REGISTRY_CACHE_SCHEMA,
+  SEED_EXTERNAL_CLIENT_REGISTRY,
+  fetchExternalClientRegistry,
+  listRegisteredClients,
+  isClientRegistered,
+  getClientConfigPath,
+  detectInstalledClients,
+  syncServerToClient,
+  removeServerFromClient,
+  inspectClientAdapter,
+  pingMcpServer,
+  listMcpTools,
+  callMcpTool,
+  recordToolReceipt,
+  getSessionToolReceipts,
+  clearSessionToolReceipts,
+  summarizeToolReceipts,
+} from './mcp/index.js';
 
 export {
   createIdentityClient,