@signaliz/sdk 1.0.3 → 1.0.4

package/README.md

@@ -7,6 +7,20 @@ Nango-managed customer API connections, MCP/Ops control-plane methods, and
 enrichment primitives. Available data is returned before fresh enrichment;
 live email verification is 0.02 fresh enrichment credits when a new verification is needed.
 
+## Which Surface Should I Use?
+
+Signaliz is the GTM brain over any stack. The SDK is for application code,
+scripts, and agent runtimes that need typed access to the same GTM Kernel, Ops,
+integration, and approval primitives exposed through MCP and CLI.
+
+- Use MCP or Codex when an agent should reason, choose tools, and build or audit
+  a campaign from a plain-English goal.
+- Use the CLI when a human operator or local agent needs a repeatable command,
+  JSON receipt, readiness check, or debug trail. Start with `signaliz start`.
+- Use the SDK when product code or automation needs typed methods.
+- Use the UI as the human cockpit to inspect state, connect tools, approve gated
+  actions, and monitor results.
+
 ## Installation
 
 ```bash
@@ -74,6 +88,12 @@ const seed = await signaliz.gtm.seedBrainDefaults({
   layers: ['icp', 'lead_generation', 'copy_enrichment'],
   includeGlobal: true,
 });
+console.log({
+  workspacePatterns: seed.seed?.evidence?.workspace_pattern_count,
+  networkPatterns: seed.seed?.evidence?.global_pattern_count,
+  activeRoutes: seed.seed?.recommended_defaults?.provider_strategy?.active_layer_routes?.length ?? 0,
+  privacyPolicy: seed.privacy_policy,
+});
 
 const failures = await signaliz.gtm.failurePatterns({
   campaignId: campaign.campaign?.id,
@@ -111,6 +131,21 @@ const campaignLearning = await signaliz.gtm.campaignLearningStatus({
 const readyLanes = campaignLearning.learning_lanes?.filter((lane) => lane.state === 'ready') ?? [];
 const networkLane = campaignLearning.learning_lanes?.find((lane) => lane.id === 'network_patterns');
 
+const memory = await signaliz.gtm.searchMemory({
+  query: 'subject lines that worked for SaaS engineering leaders',
+  outcomeType: 'meeting_booked',
+  targetIcp: { persona: 'Head of Engineering', segment: 'Series B SaaS' },
+  layers: ['copy_enrichment', 'sender'],
+  limit: 5,
+});
+const topMemory = memory.memories?.[0];
+console.log({
+  title: topMemory?.title,
+  outcomeClass: Array.isArray(topMemory?.match_reasons) ? undefined : topMemory?.match_reasons?.outcome_class,
+  requestedOutcomeMatch: Array.isArray(topMemory?.match_reasons) ? false : topMemory?.match_reasons?.requested_outcome_match,
+  outcomeScore: Array.isArray(topMemory?.match_reasons) ? undefined : topMemory?.match_reasons?.outcome_score,
+});
+
 await signaliz.gtm.createIntegrationRecipe({
   providerId: 'clay_webhook',
   providerName: 'Clay Webhook',
@@ -139,6 +174,47 @@ Smartlead, custom APIs, custom MCP servers, or manual review gates. Nango routes
 keep customer credentials in Nango while Signaliz stores only the workspace
 connection reference and approval/audit context.
 
+### Nango-Managed API Tools
+
+Use Nango when a workspace brings its own provider account and the action should
+run through Nango-managed auth. Start by listing available tools for the saved
+workspace connection, dry-run the action, then confirm the write only after the
+preview is approved.
+
+```typescript
+const tools = await signaliz.gtm.listNangoTools({
+  workspaceConnectionId: 'workspace_conn_nango_hubspot',
+  providerConfigKey: 'hubspot',
+  includeRaw: false,
+});
+
+const preview = await signaliz.gtm.callNangoTool({
+  workspaceConnectionId: 'workspace_conn_nango_hubspot',
+  actionName: 'upsert-contact',
+  input: { email: 'buyer@example.com', company: 'Acme' },
+  dryRun: true,
+  confirm: false,
+});
+
+if (preview.ready_for_confirmation) {
+  const confirmed = await signaliz.gtm.callNangoTool({
+    workspaceConnectionId: 'workspace_conn_nango_hubspot',
+    actionName: 'upsert-contact',
+    input: { email: 'buyer@example.com', company: 'Acme' },
+    dryRun: false,
+    confirm: true,
+    async: true,
+  });
+
+  if (confirmed.action_id || confirmed.status_url) {
+    await signaliz.gtm.getNangoActionResult({
+      actionId: confirmed.action_id,
+      statusUrl: confirmed.status_url,
+    });
+  }
+}
+```
+
 ### GTM Kernel Smoke Test
 
 After CMM imports or Campaign Builder backfills, run the read-only/dry-run
@@ -150,8 +226,9 @@ SIGNALIZ_API_KEY=sk_... node scripts/cmm-kernel-smoke.mjs \
 ```
 
 The receipt includes campaign/build/workspace IDs, execution stage, feedback and
-memory counts, Brain phase readiness, blockers/warnings, the next safe MCP
-action, and explicit no-spend/no-write/no-sender/no-delivery confirmation.
+memory counts, workspace bootstrap gate readiness, Brain phase readiness,
+blockers/warnings, the next safe MCP action, and explicit
+no-spend/no-write/no-sender/no-delivery confirmation.
 
 ## MCP/Ops Control Plane
 

package/dist/{chunk-L6XUFJJO.mjs → chunk-EVZZQTWE.mjs}

@@ -171,13 +171,14 @@ var HttpClient = class {
             details: { responseText: text.slice(0, 500) }
           });
         }
-        if (data.error) {
+        const responseError = isRecord(data) && isRecord(data.error) ? data.error : null;
+        if (responseError) {
           const err = new SignalizError({
-            code: data.error.code?.toString() || data.error.data?.error_code || "MCP_ERROR",
-            message: data.error.message || "MCP request failed",
-            errorType: mapMcpErrorType(data.error),
-            retryAfter: data.error.data?.retry_after,
-            details: data.error.data
+            code: firstString(responseError.code, isRecord(responseError.data) ? responseError.data.error_code : void 0) || "MCP_ERROR",
+            message: firstString(responseError.message) || "MCP request failed",
+            errorType: mapMcpErrorType(responseError),
+            retryAfter: isRecord(responseError.data) && typeof responseError.data.retry_after === "number" ? responseError.data.retry_after : void 0,
+            details: isRecord(responseError.data) ? responseError.data : void 0
           });
           if (err.isRetryable && attempt < this.maxRetries) {
             lastError = err;
@@ -254,35 +255,63 @@ function normalizeMcpParams(method, params) {
     }
   };
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function firstString(...values) {
+  const value = values.find((item) => typeof item === "string" && item.length > 0);
+  return typeof value === "string" ? value : void 0;
+}
+function firstPayloadError(payload) {
+  const errors = payload.errors;
+  const first = Array.isArray(errors) ? errors[0] : void 0;
+  return isRecord(first) ? first : {};
+}
 function unwrapMcpResponse(data) {
-  if (data?.result?.structuredContent !== void 0) {
-    return unwrapMcpPayload(data.result.structuredContent);
+  const result = isRecord(data) ? data.result : void 0;
+  if (isRecord(result) && result.structuredContent !== void 0) {
+    return unwrapMcpPayload(result.structuredContent);
   }
-  const text = data?.result?.content?.[0]?.text;
+  const content = isRecord(result) ? result.content : void 0;
+  const firstContent = Array.isArray(content) ? content[0] : void 0;
+  const text = isRecord(firstContent) ? firstContent.text : void 0;
   if (typeof text === "string") {
     const parsed = safeJson(text);
     return unwrapMcpPayload(parsed ?? text);
   }
-  return unwrapMcpPayload(data?.result);
+  return unwrapMcpPayload(result);
 }
 function unwrapMcpPayload(payload) {
-  if (payload && typeof payload === "object") {
+  if (isRecord(payload)) {
     if (payload.ok === true && Object.prototype.hasOwnProperty.call(payload, "result")) {
       return payload.result;
     }
+    if (payload.ok === false) {
+      const first = firstPayloadError(payload);
+      const code = firstString(first.code, payload.error_code, payload.code) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
+      throw new SignalizError({
+        code,
+        message: firstString(first.message, payload.message, payload.summary, payload.error) || "MCP request failed",
+        errorType: mapErrorTypeFromCode(code),
+        details: {
+          ...payload,
+          ...isRecord(first.details) ? first.details : {}
+        }
+      });
+    }
     if (payload.success === true && Object.prototype.hasOwnProperty.call(payload, "data")) {
       return payload.data;
     }
     if (payload.success === false) {
-      const first = Array.isArray(payload.errors) ? payload.errors[0] ?? {} : {};
-      const code = first.code || payload.error_code || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
+      const first = firstPayloadError(payload);
+      const code = firstString(first.code, payload.error_code) || (payload.approval_required ? "APPROVAL_REQUIRED" : "MCP_ERROR");
       throw new SignalizError({
         code,
-        message: first.message || payload.message || payload.summary || "MCP request failed",
+        message: firstString(first.message, payload.message, payload.summary) || "MCP request failed",
         errorType: mapErrorTypeFromCode(code),
         details: {
           ...payload,
-          ...first.details && typeof first.details === "object" ? first.details : {}
+          ...isRecord(first.details) ? first.details : {}
         }
       });
     }
@@ -290,8 +319,10 @@ function unwrapMcpPayload(payload) {
   return payload;
 }
 function mapMcpErrorType(error) {
-  const code = String(error?.data?.error_code || error?.code || "");
-  const message = String(error?.message || "").toLowerCase();
+  const errorRecord = isRecord(error) ? error : {};
+  const data = isRecord(errorRecord.data) ? errorRecord.data : {};
+  const code = String(data.error_code || errorRecord.code || "");
+  const message = String(errorRecord.message || "").toLowerCase();
   if (code === "429" || message.includes("rate limit")) return "rate_limited";
   if (code === "401" || code === "AUTH_001" || message.includes("auth")) return "auth_expired";
   if (code === "400" || code === "-32602" || message.includes("invalid")) return "validation";
@@ -2922,6 +2953,10 @@ function normalizeOpsProofResult(data) {
       failed30d: numberValue(summary.failed_30d ?? summary.failed30d),
       external_delivered_30d: numberValue(summary.external_delivered_30d ?? summary.externalDelivered30d),
       externalDelivered30d: numberValue(summary.external_delivered_30d ?? summary.externalDelivered30d),
+      nango_proofs_30d: numberValue(summary.nango_proofs_30d ?? summary.nangoProofs30d),
+      nangoProofs30d: numberValue(summary.nango_proofs_30d ?? summary.nangoProofs30d),
+      nango_failures_30d: numberValue(summary.nango_failures_30d ?? summary.nangoFailures30d),
+      nangoFailures30d: numberValue(summary.nango_failures_30d ?? summary.nangoFailures30d),
       airbyte_configured: numberValue(summary.airbyte_configured ?? summary.airbyteConfigured),
       airbyteConfigured: numberValue(summary.airbyte_configured ?? summary.airbyteConfigured),
       airbyte_proofs_30d: numberValue(summary.airbyte_proofs_30d ?? summary.airbyteProofs30d),
@@ -3336,9 +3371,10 @@ function buildOpsDebugOptions(params) {
 }
 function buildCreateRoutineBody(params) {
   const { outputSinks, wakeOnEvents, ...rest } = params;
+  const sinks = rest.output_sinks ?? outputSinks;
   return {
     ...rest,
-    output_sinks: rest.output_sinks ?? outputSinks,
+    output_sinks: Array.isArray(sinks) ? sinks.map(normalizeOpsSinkRequest) : sinks,
     wake_on_events: rest.wake_on_events ?? wakeOnEvents
   };
 }
@@ -3372,6 +3408,97 @@ function buildCreateOutputSinkBody(params) {
     webhook_url: rest.webhook_url ?? webhookUrl
   };
 }
+function normalizeOpsSinkRequest(sink) {
+  const {
+    sinkId,
+    connectionId,
+    connectorId,
+    connectorName,
+    deliveryMode,
+    providerConfigKey,
+    integrationId,
+    nangoConnectionId,
+    actionName,
+    nangoAction,
+    proxyPath,
+    nangoProxyPath,
+    fieldMap,
+    requiredFields,
+    writeConfirmed,
+    agentWriteConfirmed,
+    config,
+    ...rest
+  } = sink;
+  const normalizedConfig = normalizeOpsSinkConfigRequest(config);
+  const connection_id = rest.connection_id ?? connectionId;
+  const connector_id = rest.connector_id ?? connectorId;
+  const delivery_mode = rest.delivery_mode ?? deliveryMode;
+  const provider_config_key = rest.provider_config_key ?? providerConfigKey;
+  const integration_id = rest.integration_id ?? integrationId;
+  const nango_connection_id = rest.nango_connection_id ?? nangoConnectionId;
+  const action_name = rest.action_name ?? actionName;
+  const nango_action = rest.nango_action ?? nangoAction;
+  const proxy_path = rest.proxy_path ?? proxyPath;
+  const nango_proxy_path = rest.nango_proxy_path ?? nangoProxyPath;
+  const field_map = rest.field_map ?? fieldMap;
+  const required_fields = rest.required_fields ?? requiredFields;
+  const write_confirmed = rest.write_confirmed ?? writeConfirmed;
+  const agent_write_confirmed = rest.agent_write_confirmed ?? agentWriteConfirmed;
+  if (connection_id !== void 0 && normalizedConfig.connection_id === void 0) normalizedConfig.connection_id = connection_id;
+  if (connector_id !== void 0 && normalizedConfig.connector_id === void 0) normalizedConfig.connector_id = connector_id;
+  if (delivery_mode !== void 0 && normalizedConfig.delivery_mode === void 0) normalizedConfig.delivery_mode = delivery_mode;
+  if (provider_config_key !== void 0 && normalizedConfig.provider_config_key === void 0) normalizedConfig.provider_config_key = provider_config_key;
+  if (integration_id !== void 0 && normalizedConfig.integration_id === void 0) normalizedConfig.integration_id = integration_id;
+  if (nango_connection_id !== void 0 && normalizedConfig.nango_connection_id === void 0) normalizedConfig.nango_connection_id = nango_connection_id;
+  if (action_name !== void 0 && normalizedConfig.action_name === void 0) normalizedConfig.action_name = action_name;
+  if (nango_action !== void 0 && normalizedConfig.nango_action === void 0) normalizedConfig.nango_action = nango_action;
+  if (proxy_path !== void 0 && normalizedConfig.proxy_path === void 0) normalizedConfig.proxy_path = proxy_path;
+  if (nango_proxy_path !== void 0 && normalizedConfig.nango_proxy_path === void 0) normalizedConfig.nango_proxy_path = nango_proxy_path;
+  if (field_map !== void 0 && normalizedConfig.field_map === void 0) normalizedConfig.field_map = field_map;
+  if (required_fields !== void 0 && normalizedConfig.required_fields === void 0) normalizedConfig.required_fields = required_fields;
+  if (write_confirmed !== void 0 && normalizedConfig.write_confirmed === void 0) normalizedConfig.write_confirmed = write_confirmed;
+  if (agent_write_confirmed !== void 0 && normalizedConfig.agent_write_confirmed === void 0) normalizedConfig.agent_write_confirmed = agent_write_confirmed;
+  if (sink.type === "nango" && normalizedConfig.integration_platform === void 0) normalizedConfig.integration_platform = "nango";
+  return {
+    ...rest,
+    sink_id: rest.sink_id ?? sinkId,
+    connection_id,
+    connector_id,
+    connector_name: rest.connector_name ?? connectorName,
+    delivery_mode,
+    provider_config_key,
+    integration_id,
+    nango_connection_id,
+    action_name,
+    nango_action,
+    proxy_path,
+    nango_proxy_path,
+    field_map,
+    required_fields,
+    write_confirmed,
+    agent_write_confirmed,
+    config: normalizedConfig
+  };
+}
+function normalizeOpsSinkConfigRequest(config) {
+  const out = { ...config ?? {} };
+  if (out.connection_id === void 0 && out.connectionId !== void 0) out.connection_id = out.connectionId;
+  if (out.connector_id === void 0 && out.connectorId !== void 0) out.connector_id = out.connectorId;
+  if (out.connector_name === void 0 && out.connectorName !== void 0) out.connector_name = out.connectorName;
+  if (out.delivery_mode === void 0 && out.deliveryMode !== void 0) out.delivery_mode = out.deliveryMode;
+  if (out.provider_config_key === void 0 && out.providerConfigKey !== void 0) out.provider_config_key = out.providerConfigKey;
+  if (out.integration_id === void 0 && out.integrationId !== void 0) out.integration_id = out.integrationId;
+  if (out.nango_connection_id === void 0 && out.nangoConnectionId !== void 0) out.nango_connection_id = out.nangoConnectionId;
+  if (out.action_name === void 0 && out.actionName !== void 0) out.action_name = out.actionName;
+  if (out.nango_action === void 0 && out.nangoAction !== void 0) out.nango_action = out.nangoAction;
+  if (out.proxy_path === void 0 && out.proxyPath !== void 0) out.proxy_path = out.proxyPath;
+  if (out.nango_proxy_path === void 0 && out.nangoProxyPath !== void 0) out.nango_proxy_path = out.nangoProxyPath;
+  if (out.field_map === void 0 && out.fieldMap !== void 0) out.field_map = out.fieldMap;
+  if (out.required_fields === void 0 && out.requiredFields !== void 0) out.required_fields = out.requiredFields;
+  if (out.write_confirmed === void 0 && out.writeConfirmed !== void 0) out.write_confirmed = out.writeConfirmed;
+  if (out.agent_write_confirmed === void 0 && out.agentWriteConfirmed !== void 0) out.agent_write_confirmed = out.agentWriteConfirmed;
+  return out;
+}
 function buildApproveBody(params) {
   const { tokenId, tokenIds, reviewerNotes, ...rest } = params;
   return {
@@ -3520,6 +3647,57 @@ var GtmKernel = class {
       limit: options.limit
     });
   }
+  /** Discover existing provider campaigns, starting with live/Kernel-linked Instantly campaigns, before audit or import preview. */
+  async discoverExistingCampaigns(options = {}) {
+    return this.callMcp("gtm_existing_campaign_discover", {
+      provider: options.provider,
+      integration_id: options.integrationId,
+      search: options.search,
+      limit: options.limit,
+      include_kernel_linked: options.includeKernelLinked,
+      include_provider_live: options.includeProviderLive
+    });
+  }
+  /** Run a read-only existing campaign audit with completeness, recommendations, safe next MCP JSON, and approval boundaries. */
+  async auditExistingCampaign(options) {
+    return this.callMcp("gtm_existing_campaign_audit", {
+      campaign_id: options.campaignId,
+      provider: options.provider,
+      provider_campaign_id: options.providerCampaignId,
+      campaign_name: options.campaignName,
+      days: options.days,
+      include_route_preview: options.includeRoutePreview,
+      include_memory: options.includeMemory,
+      include_brain: options.includeBrain
+    });
+  }
+  /** Discover the first matching existing provider campaign, then run the same read-only audit against that match. */
+  async auditExistingCampaignBySearch(options) {
+    const discovery = await this.discoverExistingCampaigns({
+      provider: options.provider,
+      integrationId: options.integrationId,
+      search: options.search,
+      limit: 1,
+      includeKernelLinked: options.includeKernelLinked,
+      includeProviderLive: options.includeProviderLive
+    });
+    const match = discovery.campaigns?.[0];
+    const campaignId = match?.linked_kernel_campaign_id || void 0;
+    const providerCampaignId = match?.provider_campaign_id || void 0;
+    if (!campaignId && !providerCampaignId) {
+      throw new Error(`No existing ${options.provider || discovery.provider || "provider"} campaign matched "${options.search}"`);
+    }
+    return this.auditExistingCampaign({
+      provider: options.provider || discovery.provider || match?.provider,
+      campaignId,
+      providerCampaignId,
+      campaignName: match?.name || match?.linked_kernel_campaign_name || void 0,
+      days: options.days,
+      includeRoutePreview: options.includeRoutePreview,
+      includeMemory: options.includeMemory,
+      includeBrain: options.includeBrain
+    });
+  }
   /** Create a first-class GTM campaign object in the current workspace. */
   async createCampaign(input) {
     return this.callMcp("gtm_campaign_create", campaignCreateArgs(input));
@@ -3725,6 +3903,47 @@ var GtmKernel = class {
       brain_cycle_min_interval_minutes: input.brainCycleMinIntervalMinutes
     });
   }
+  /** Preview anonymized Instantly workspace sources registered for Kernel import. */
+  async previewKernelImport(input = {}) {
+    return this.callMcp("gtm_kernel_import_preview", {
+      source_ids: input.sourceIds,
+      include_leads: input.includeLeads,
+      include_replies: input.includeReplies,
+      include_private_copy: input.includePrivateCopy,
+      max_pages: input.maxPages,
+      limit: input.limit
+    });
+  }
+  /** Queue the read-only Instantly-to-GTM Kernel import. Live writes require writeApproved. */
+  async runKernelImport(input = {}) {
+    return this.callMcp("gtm_kernel_import_run", {
+      source_ids: input.sourceIds,
+      dry_run: input.dryRun,
+      write_approved: input.writeApproved,
+      include_leads: input.includeLeads,
+      include_replies: input.includeReplies,
+      include_private_copy: input.includePrivateCopy,
+      private_copy_approved: input.privateCopyApproved,
+      promote_global_patterns: input.promoteGlobalPatterns,
+      min_global_privacy_k: input.minGlobalPrivacyK,
+      max_pages: input.maxPages,
+      limit: input.limit
+    });
+  }
+  /** Queue Brain distillation over imported Instantly memory with abstracted-only outputs. */
+  async runBrainDistillation(input = {}) {
+    return this.callMcp("gtm_brain_distill_run", {
+      source_ids: input.sourceIds,
+      write_mode: input.writeMode,
+      write_approved: input.writeApproved,
+      brain_cycle_phases: input.brainCyclePhases,
+      days: input.days,
+      network_days: input.networkDays,
+      min_sample_size: input.minSampleSize,
+      min_workspace_count: input.minWorkspaceCount,
+      min_privacy_k: input.minPrivacyK
+    });
+  }
   /** Prepare a provider-agnostic feedback webhook URL for Smartlead, HeyReach, Airbyte, or custom sender events. */
   async prepareFeedbackWebhook(input) {
     return this.callMcp("gtm_feedback_webhook_prepare", {
@@ -4152,6 +4371,43 @@ var GtmKernel = class {
       context: input.context
     });
   }
+  /** List Nango-backed action tools for a workspace connection without executing them. */
+  async listNangoTools(options = {}) {
+    return this.callMcp("nango_mcp_tools_list", {
+      workspace_connection_id: options.workspaceConnectionId,
+      connection_id: options.connectionId,
+      provider_config_key: options.providerConfigKey,
+      integration_id: options.integrationId,
+      nango_connection_id: options.nangoConnectionId,
+      format: options.format,
+      include_raw: options.includeRaw
+    });
+  }
+  /** Dry-run or execute a Nango-backed action tool through the approval-aware MCP bridge. */
+  async callNangoTool(input) {
+    return this.callMcp("nango_mcp_tool_call", {
+      workspace_connection_id: input.workspaceConnectionId,
+      connection_id: input.connectionId,
+      provider_config_key: input.providerConfigKey,
+      integration_id: input.integrationId,
+      nango_connection_id: input.nangoConnectionId,
+      action_name: input.actionName,
+      tool_name: input.toolName,
+      input: input.input,
+      async: input.async,
+      max_retries: input.maxRetries,
+      dry_run: input.dryRun,
+      confirm: input.confirm,
+      confirm_write: input.confirmWrite
+    });
+  }
+  /** Poll an async Nango action result by action id or status URL. */
+  async getNangoActionResult(input) {
+    return this.callMcp("nango_mcp_action_result_get", {
+      action_id: input.actionId,
+      status_url: input.statusUrl
+    });
+  }
   /** Deliver approved campaign-layer records to a webhook recipe, starting with Clay-style webhooks. */
   async deliverWebhook(input) {
     return this.callMcp("gtm_webhook_deliver", {
@@ -4286,6 +4542,59 @@ function compact2(value) {
 }
 
 // src/index.ts
+function inferMcpToolCategory(toolName) {
+  if (typeof toolName !== "string" || !toolName) return void 0;
+  if (toolName.startsWith("ops_") || toolName === "get_ops_readiness" || toolName === "get_gtm_ops_readiness" || toolName.startsWith("gtm_") || [
+    "list_routines",
+    "create_routine",
+    "update_routine",
+    "run_routine_now",
+    "get_routine",
+    "get_routine_ticks",
+    "get_tick_items",
+    "get_last_tick_items",
+    "chain_routines",
+    "get_chain_status",
+    "launch_campaign",
+    "quickstart_gtm_book",
+    "list_campaigns",
+    "campaign_performance",
+    "tune_campaign",
+    "emit_event",
+    "approvals_list",
+    "list_output_sinks",
+    "create_output_sink",
+    "update_output_sink",
+    "delete_output_sink",
+    "attach_sink_to_routine"
+  ].includes(toolName)) {
+    return "ops";
+  }
+  if ([
+    "find_emails_with_verification",
+    "verify_email",
+    "enrich_company_signals",
+    "company_intelligence",
+    "find_contacts_with_email",
+    "execute_primitive"
+  ].includes(toolName)) {
+    return "enrichment";
+  }
+  if (toolName.includes("icp")) return "icp";
+  if (toolName.startsWith("ai_clean_")) return "data_cleaning";
+  if (toolName.includes("system") || toolName.includes("workflow")) return "automation";
+  if (toolName.includes("agent") || toolName.includes("platform_health") || toolName === "discover_capabilities") return "observability";
+  return void 0;
+}
+function asRecord3(value) {
+  return value && typeof value === "object" ? value : void 0;
+}
+function asStringArray(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : void 0;
+}
+function asObjectSchema(value) {
+  return asRecord3(value);
+}
 var Signaliz = class {
   constructor(config) {
     this.client = new HttpClient(config);
@@ -4344,21 +4653,21 @@ var Signaliz = class {
     const data = await this.client.mcp("tools/list", {});
     const tools = data?.tools ?? data ?? [];
     return tools.map((t) => ({
-      name: t.name,
-      description: (t.description ?? "").slice(0, 120),
-      category: t.annotations?.category,
-      costCredits: t.annotations?.cost_credits,
-      contractVersion: t.annotations?.contract_version ?? t.annotations?.contract?.contract_version,
-      permissionLevel: t.annotations?.permission_level ?? t.annotations?.contract?.permission_level,
-      authScopes: t.annotations?.auth_scopes ?? t.annotations?.contract?.auth_scopes,
-      idempotent: t.annotations?.idempotentHint ?? t.annotations?.idempotent ?? t.annotations?.contract?.idempotent,
-      destructive: t.annotations?.destructiveHint ?? t.annotations?.destructive ?? t.annotations?.contract?.destructive,
-      retryable: t.annotations?.retryable ?? t.annotations?.contract?.retryable,
-      rateLimitKey: t.annotations?.rate_limit_key ?? t.annotations?.contract?.rate_limit_key,
-      observability: t.annotations?.observability ?? t.annotations?.contract?.observability,
-      inputSchema: t.inputSchema ?? t.input_schema ?? t.annotations?.contract?.input_schema,
-      outputSchema: t.outputSchema ?? t.output_schema ?? t.annotations?.contract?.output_schema,
-      annotations: t.annotations
+      name: typeof t.name === "string" ? t.name : "",
+      description: String(t.description ?? "").slice(0, 120),
+      category: typeof t.annotations?.category === "string" ? t.annotations.category : inferMcpToolCategory(t.name),
+      costCredits: typeof t.annotations?.cost_credits === "number" ? t.annotations.cost_credits : void 0,
+      contractVersion: typeof (t.annotations?.contract_version ?? t.annotations?.contract?.contract_version) === "string" ? t.annotations?.contract_version ?? t.annotations?.contract?.contract_version : void 0,
+      permissionLevel: typeof (t.annotations?.permission_level ?? t.annotations?.contract?.permission_level) === "string" ? t.annotations?.permission_level ?? t.annotations?.contract?.permission_level : void 0,
+      authScopes: asStringArray(t.annotations?.auth_scopes ?? t.annotations?.contract?.auth_scopes),
+      idempotent: typeof (t.annotations?.idempotentHint ?? t.annotations?.idempotent ?? t.annotations?.contract?.idempotent) === "boolean" ? t.annotations?.idempotentHint ?? t.annotations?.idempotent ?? t.annotations?.contract?.idempotent : void 0,
+      destructive: typeof (t.annotations?.destructiveHint ?? t.annotations?.destructive ?? t.annotations?.contract?.destructive) === "boolean" ? t.annotations?.destructiveHint ?? t.annotations?.destructive ?? t.annotations?.contract?.destructive : void 0,
+      retryable: typeof (t.annotations?.retryable ?? t.annotations?.contract?.retryable) === "boolean" ? t.annotations?.retryable ?? t.annotations?.contract?.retryable : void 0,
+      rateLimitKey: typeof (t.annotations?.rate_limit_key ?? t.annotations?.contract?.rate_limit_key) === "string" ? t.annotations?.rate_limit_key ?? t.annotations?.contract?.rate_limit_key : void 0,
+      observability: asRecord3(t.annotations?.observability ?? t.annotations?.contract?.observability),
+      inputSchema: asObjectSchema(t.inputSchema ?? t.input_schema ?? t.annotations?.contract?.input_schema),
+      outputSchema: asObjectSchema(t.outputSchema ?? t.output_schema ?? t.annotations?.contract?.output_schema),
+      annotations: asRecord3(t.annotations)
     }));
   }
   /** Discover tools by natural language query */