@inneranimalmedia/agentsam-sdk 2.6.8 → 2.6.10

package/src/plugins/registry.js

@@ -1,4 +1,5 @@
 import { normalizePluginManifest } from './contracts.js';
+import { createAiPluginProbePatch } from '../models/inventory-core.js';
 
 function clean(value) { return value == null ? '' : String(value).trim(); }
 function json(value, fallback) { try { return JSON.parse(String(value ?? '')); } catch { return fallback; } }
@@ -188,6 +189,61 @@ export async function recordPluginHealthCheck(db, value = {}) {
   return { id: checkId, status: value.status };
 }
 
+/**
+ * Persist credential-verified AI model availability in the existing plugin
+ * installation metadata. A failed probe records health evidence but preserves
+ * the last successful model snapshot.
+ */
+export async function recordAiPluginModelDiscovery(db, value = {}) {
+  if (!db?.prepare) throw new TypeError('D1-compatible database binding required');
+  const pluginId = clean(value.pluginId);
+  const accountId = clean(value.accountId);
+  if (!pluginId) throw new Error('plugin_id_required');
+  if (!accountId) throw new Error('plugin_account_id_required');
+  const plugin = await db.prepare(`
+    SELECT id, plugin_key, provider_key, environment, plugin_kind, metadata_json
+    FROM agentsam_plugins WHERE id = ? AND account_id = ? LIMIT 1
+  `).bind(pluginId, accountId).first();
+  if (!plugin) throw new Error(`plugin_not_found:${pluginId}`);
+  if (clean(plugin.plugin_kind) !== 'ai') throw new Error(`plugin_not_ai:${pluginId}`);
+
+  const probe = createAiPluginProbePatch(json(plugin.metadata_json, {}), value.discovery || {}, {
+    provider: value.provider || plugin.provider_key,
+    fetchedAtUnix: value.completedAt,
+  });
+  await runMutation(db, `
+    UPDATE agentsam_plugins SET metadata_json = ?, updated_at = unixepoch()
+    WHERE id = ? AND account_id = ?
+  `, [JSON.stringify(probe.metadata), pluginId, accountId]);
+
+  const snapshot = probe.metadata.model_snapshot || null;
+  const health = await recordPluginHealthCheck(db, {
+    pluginId,
+    pluginKey: plugin.plugin_key,
+    accountId,
+    environment: plugin.environment,
+    checkKind: 'model_inventory',
+    checkSource: value.checkSource || 'provider_discovery',
+    status: probe.health_status,
+    startedAt: value.startedAt,
+    completedAt: probe.last_health_at,
+    latencyMs: value.latencyMs,
+    httpStatus: value.httpStatus,
+    providerRequestId: value.providerRequestId,
+    errorCode: probe.last_error_code,
+    errorMessage: probe.last_error_message,
+    details: snapshot ? {
+      schema: snapshot.schema,
+      provider: snapshot.provider,
+      model_count: snapshot.model_count,
+      models_hash: snapshot.models_hash,
+      fetched_at_unix: snapshot.fetched_at_unix,
+      ...(value.discovery?.ok === true ? {} : { snapshot_preserved: true }),
+    } : { provider: clean(value.provider || plugin.provider_key), snapshot_preserved: true },
+  });
+  return Object.freeze({ ...health, plugin_id: pluginId, health_status: probe.health_status, model_snapshot: snapshot });
+}
+
 export async function recordToolCall(db, value = {}) {
   const callId = clean(value.id) || id('atcl');
   await runMutation(db, `

package/src/rpc/generated/errors_pb.js

@@ -103,7 +103,8 @@ proto.agentsam.knowledge.v1.ErrorDetail.toObject = function(includeInstance, msg
     detailsJson: jspb.Message.getFieldWithDefault(msg, 25, ""),
     occurrenceCount: jspb.Message.getFieldWithDefault(msg, 26, 0),
     requestId: jspb.Message.getFieldWithDefault(msg, 27, ""),
-    schemaVersion: jspb.Message.getFieldWithDefault(msg, 28, 0)
+    schemaVersion: jspb.Message.getFieldWithDefault(msg, 28, 0),
+    nativeStage: jspb.Message.getFieldWithDefault(msg, 29, "")
   };
 
   if (includeInstance) {
@@ -252,6 +253,10 @@ proto.agentsam.knowledge.v1.ErrorDetail.deserializeBinaryFromReader = function(m
       var value = /** @type {number} */ (reader.readUint32());
       msg.setSchemaVersion(value);
       break;
+    case 29:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setNativeStage(value);
+      break;
     default:
       reader.skipField();
       break;
@@ -477,6 +482,13 @@ proto.agentsam.knowledge.v1.ErrorDetail.serializeBinaryToWriter = function(messa
       f
     );
   }
+  f = /** @type {string} */ (jspb.Message.getField(message, 29));
+  if (f != null) {
+    writer.writeString(
+      29,
+      f
+    );
+  }
 };
 
 
@@ -1416,6 +1428,42 @@ proto.agentsam.knowledge.v1.ErrorDetail.prototype.hasSchemaVersion = function()
 };
 
 
+/**
+ * optional string native_stage = 29;
+ * @return {string}
+ */
+proto.agentsam.knowledge.v1.ErrorDetail.prototype.getNativeStage = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 29, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.agentsam.knowledge.v1.ErrorDetail} returns this
+ */
+proto.agentsam.knowledge.v1.ErrorDetail.prototype.setNativeStage = function(value) {
+  return jspb.Message.setField(this, 29, value);
+};
+
+
+/**
+ * Clears the field making it undefined.
+ * @return {!proto.agentsam.knowledge.v1.ErrorDetail} returns this
+ */
+proto.agentsam.knowledge.v1.ErrorDetail.prototype.clearNativeStage = function() {
+  return jspb.Message.setField(this, 29, undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.agentsam.knowledge.v1.ErrorDetail.prototype.hasNativeStage = function() {
+  return jspb.Message.getField(this, 29) != null;
+};
+
+
 /**
  * @enum {number}
  */

package/src/tools/runtime.js

@@ -1,4 +1,4 @@
-import { ERROR_REASON_POLICY, normalizeError } from '../errors/index.js';
+import { ERROR_REASON_POLICY, canonicalizeErrorReason, normalizeError } from '../errors/index.js';
 import { receiptPayload, redactToolValue } from './redact.js';
 
 function defaultId(prefix) {
@@ -6,6 +6,11 @@ function defaultId(prefix) {
 }
 
 function reasonForError(error) {
+  const nativeReason = canonicalizeErrorReason(error);
+  if (/^(hook|mcp|lsp|tool|provider)_/.test(nativeReason || '')) return nativeReason;
+  const message = String(error?.message || error || '').toLowerCase();
+  if (message.includes('provider adapter not registered') || message.includes('no registered execution target')) return 'tool_handler_unavailable';
+  if (/timeout|timed out|deadline/.test(message)) return 'tool_timeout';
   const status = Number(error?.status || error?.http_status || 0);
   if (status === 401) return 'provider_credential_invalid';
   if (status === 403) return 'provider_scope_insufficient';
@@ -16,12 +21,12 @@ function reasonForError(error) {
   if (status === 400 || status === 422) return 'provider_request_invalid';
   if (error?.code === 'completeful_idempotency_required') return 'input_invalid';
   if (error instanceof TypeError) return 'input_invalid';
-  return 'execution_failed';
+  return nativeReason || 'tool_execution_failed';
 }
 
-function normalizeToolError(error, definition) {
+function normalizeToolError(error, definition, sideEffectState = 'unknown') {
   const reason = reasonForError(error);
-  const policy = ERROR_REASON_POLICY[reason] || ERROR_REASON_POLICY.execution_failed;
+  const policy = ERROR_REASON_POLICY[reason] || ERROR_REASON_POLICY.tool_execution_failed;
   return normalizeError(error, {
     code: policy.code,
     reason,
@@ -29,6 +34,9 @@ function normalizeToolError(error, definition) {
       ? { kind: 'provider', name: definition.provider, service: definition.provider }
       : { kind: 'runtime', name: 'agentsam-tool-runtime' },
     domain: 'tool',
+    stage: 'execute',
+    feature: 'tool.execute',
+    side_effect_state: sideEffectState,
     tool: definition.toolKey,
     provider: definition.provider || null,
     provider_code: error?.code || null,
@@ -132,7 +140,7 @@ export function createToolExecutor({
     try {
       invoke = await resolveExecutionTarget(registry, definition);
     } catch (error) {
-      const normalized = normalizeToolError(error, definition);
+      const normalized = normalizeToolError(error, definition, 'not_started');
       const completedAt = now();
       const receipt = {
         invocationId: invocation.id,