nowaikit 3.1.0 → 4.0.0

package/dist/tools-manifest.json

@@ -2112,6 +2112,64 @@
       ]
     }
   },
+  {
+    "name": "generate_report",
+    "description": "Generate a branded PDF or PPTX report from capability analysis results. Call this after completing a scan, review, or audit to create a management-ready document with charts, tables, and ServiceNow links. Supports single capability (content) or multiple capabilities (sections) in one combined report.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "content": {
+          "type": "string",
+          "description": "Full markdown analysis to convert into a branded report (for single capability)"
+        },
+        "sections": {
+          "type": "array",
+          "description": "Multiple capability analyses to combine into one report. Each section becomes a chapter. Use this instead of content for multi-capability reports.",
+          "items": {
+            "type": "object",
+            "properties": {
+              "content": {
+                "type": "string",
+                "description": "Markdown analysis for this capability"
+              },
+              "title": {
+                "type": "string",
+                "description": "Section title (e.g. \"Instance Health Scan\")"
+              },
+              "capability": {
+                "type": "string",
+                "description": "Capability name (e.g. \"scan-health\")"
+              }
+            },
+            "required": [
+              "content",
+              "title"
+            ]
+          }
+        },
+        "format": {
+          "type": "string",
+          "enum": [
+            "pdf",
+            "pptx"
+          ],
+          "description": "Output format: pdf (branded document) or pptx (slide deck)"
+        },
+        "title": {
+          "type": "string",
+          "description": "Report title (e.g. \"Instance Health Scan\", \"Comprehensive Instance Audit\")"
+        },
+        "capability": {
+          "type": "string",
+          "description": "Capability name that produced the analysis (e.g. \"scan-health\", \"review-code\", \"combined-audit\")"
+        }
+      },
+      "required": [
+        "format",
+        "title"
+      ]
+    }
+  },
   {
     "name": "list_atf_suites",
     "description": "List ATF test suites in the instance",
@@ -7463,6 +7521,52 @@
       ]
     }
   },
+  {
+    "name": "ml_similar_incidents",
+    "description": "Find similar past incidents using keyword-based matching. Provide either an incident sys_id (to find similar incidents) or a short_description (for free-text matching). Returns resolved incidents ranked by keyword match count.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "incident_sys_id": {
+          "type": "string",
+          "description": "Sys_id of an existing incident to find similar ones for"
+        },
+        "short_description": {
+          "type": "string",
+          "description": "Free-text description to match against (required if no sys_id)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max results to return (default 10)"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "ml_auto_categorize",
+    "description": "Auto-categorize a record based on its description by analysing resolved records of the same table. Queries the last 500 resolved records, groups by category, and matches input keywords to suggest a category.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "short_description": {
+          "type": "string",
+          "description": "Short description of the record to categorize"
+        },
+        "description": {
+          "type": "string",
+          "description": "Full description (optional, improves accuracy)"
+        },
+        "table": {
+          "type": "string",
+          "description": "Table to analyse (default \"incident\")"
+        }
+      },
+      "required": [
+        "short_description"
+      ]
+    }
+  },
   {
     "name": "list_uib_pages",
     "description": "List UI Builder pages and their route configurations",
@@ -8413,5 +8517,561 @@
         "script"
       ]
     }
+  },
+  {
+    "name": "fluent_explain",
+    "description": "Run `npx @servicenow/sdk explain <topic>` to get SDK documentation on a topic. Returns explanations of fluent APIs, types, patterns, and best practices.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "topic": {
+          "type": "string",
+          "description": "Topic to explain (e.g., \"GlideQuery\", \"table API\", \"scoped app\")"
+        }
+      },
+      "required": [
+        "topic"
+      ]
+    }
+  },
+  {
+    "name": "fluent_init",
+    "description": "Initialize a new ServiceNow fluent/now-sdk project. Runs `npx @servicenow/sdk init`. REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Project name"
+        },
+        "template": {
+          "type": "string",
+          "description": "Project template (optional)"
+        },
+        "directory": {
+          "type": "string",
+          "description": "Target directory (optional, defaults to cwd)"
+        }
+      },
+      "required": [
+        "name"
+      ]
+    }
+  },
+  {
+    "name": "fluent_build",
+    "description": "Build a ServiceNow fluent/now-sdk project. Runs `npx @servicenow/sdk build`. REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "directory": {
+          "type": "string",
+          "description": "Project directory (optional, defaults to cwd)"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "fluent_validate",
+    "description": "Validate a ServiceNow fluent/now-sdk project. Runs `npx @servicenow/sdk validate`. REQUIRES FLUENT_ENABLED=true.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "directory": {
+          "type": "string",
+          "description": "Project directory (optional, defaults to cwd)"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "create_now_assist_skill",
+    "description": "Create a Now Assist skill definition (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Skill name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Skill description"
+        },
+        "input_schema": {
+          "type": "string",
+          "description": "JSON schema string defining the skill input"
+        },
+        "output_schema": {
+          "type": "string",
+          "description": "JSON schema string defining the skill output"
+        },
+        "prompt_template": {
+          "type": "string",
+          "description": "Prompt template for the skill"
+        },
+        "model": {
+          "type": "string",
+          "description": "Optional model identifier to use for this skill"
+        }
+      },
+      "required": [
+        "name",
+        "description",
+        "input_schema",
+        "output_schema",
+        "prompt_template"
+      ]
+    }
+  },
+  {
+    "name": "list_now_assist_skills",
+    "description": "List Now Assist skill definitions (requires NOW_ASSIST_ENABLED)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "active": {
+          "type": "boolean",
+          "description": "Filter by active status"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max records to return (default 25)"
+        },
+        "query": {
+          "type": "string",
+          "description": "Additional encoded query string"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "get_now_assist_skill",
+    "description": "Get a single Now Assist skill definition by sys_id (requires NOW_ASSIST_ENABLED)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "sys_id": {
+          "type": "string",
+          "description": "System ID of the skill"
+        }
+      },
+      "required": [
+        "sys_id"
+      ]
+    }
+  },
+  {
+    "name": "test_now_assist_skill",
+    "description": "Invoke a Now Assist skill with test input to verify behavior (requires NOW_ASSIST_ENABLED)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "skill_sys_id": {
+          "type": "string",
+          "description": "System ID of the skill to test"
+        },
+        "test_input": {
+          "type": "object",
+          "description": "Test input payload to send to the skill"
+        }
+      },
+      "required": [
+        "skill_sys_id",
+        "test_input"
+      ]
+    }
+  },
+  {
+    "name": "create_ai_agent",
+    "description": "Create an AI agent definition with optional auto-generated ACLs (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Agent name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Agent description"
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of capability identifiers the agent supports"
+        },
+        "auto_generate_acls": {
+          "type": "boolean",
+          "description": "Automatically create ACL records for the agent (default true)"
+        }
+      },
+      "required": [
+        "name",
+        "description",
+        "capabilities"
+      ]
+    }
+  },
+  {
+    "name": "list_ai_agents",
+    "description": "List AI agent definitions",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "active": {
+          "type": "boolean",
+          "description": "Filter by active status"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max records to return (default 25)"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "get_ai_agent",
+    "description": "Get an AI agent definition and its related ACLs",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "sys_id": {
+          "type": "string",
+          "description": "System ID of the AI agent"
+        }
+      },
+      "required": [
+        "sys_id"
+      ]
+    }
+  },
+  {
+    "name": "create_agentic_workflow",
+    "description": "Create an agentic workflow linked to an AI agent (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Workflow name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Workflow description"
+        },
+        "agent_sys_id": {
+          "type": "string",
+          "description": "System ID of the parent AI agent"
+        },
+        "steps": {
+          "type": "array",
+          "description": "Ordered list of workflow steps",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Step name"
+              },
+              "action": {
+                "type": "string",
+                "description": "Action identifier"
+              },
+              "inputs": {
+                "type": "object",
+                "description": "Step input parameters"
+              },
+              "condition": {
+                "type": "string",
+                "description": "Optional condition expression"
+              }
+            },
+            "required": [
+              "name",
+              "action"
+            ]
+          }
+        },
+        "trigger_conditions": {
+          "type": "string",
+          "description": "Optional trigger condition expression"
+        }
+      },
+      "required": [
+        "name",
+        "description",
+        "agent_sys_id",
+        "steps"
+      ]
+    }
+  },
+  {
+    "name": "cmdb_find_duplicates",
+    "description": "Find duplicate CIs by matching on specified fields (in-memory grouping)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "ci_class": {
+          "type": "string",
+          "description": "CI class table (default cmdb_ci)"
+        },
+        "match_fields": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Fields to match on for duplicate detection (default: name, serial_number, ip_address)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max CIs to scan (default 100)"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "cmdb_find_orphans",
+    "description": "Find CIs with no relationships in cmdb_rel_ci",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "ci_class": {
+          "type": "string",
+          "description": "CI class table (default cmdb_ci)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max orphan CIs to return (default 50)"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "cmdb_find_stale",
+    "description": "Find CIs not updated within a given number of days that are still operational",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "ci_class": {
+          "type": "string",
+          "description": "CI class table (default cmdb_ci)"
+        },
+        "days_threshold": {
+          "type": "number",
+          "description": "Number of days since last update to consider stale (default 90)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max stale CIs to return (default 50)"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "cmdb_reconcile",
+    "description": "Act on duplicate, stale, or orphan CIs — merge, retire, or remove (requires CMDB_WRITE_ENABLED). Supports dry_run mode.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "merge_duplicates",
+            "retire_stale",
+            "remove_orphans"
+          ],
+          "description": "Reconciliation action to perform"
+        },
+        "targets": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Array of CI sys_ids to act on"
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Preview changes without applying (default true)"
+        }
+      },
+      "required": [
+        "action",
+        "targets"
+      ]
+    }
+  },
+  {
+    "name": "create_playbook",
+    "description": "Create a playbook definition with ordered steps that chain tool calls (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Playbook name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Playbook description"
+        },
+        "steps": {
+          "type": "array",
+          "description": "Ordered list of playbook steps",
+          "items": {
+            "type": "object",
+            "properties": {
+              "tool_name": {
+                "type": "string",
+                "description": "Name of the tool to invoke"
+              },
+              "args_template": {
+                "type": "object",
+                "description": "Arguments template — can reference {{context.key}} or {{steps[N].result.key}}"
+              },
+              "condition": {
+                "type": "string",
+                "description": "Optional JS-like condition expression. Step runs only when truthy."
+              },
+              "on_error": {
+                "type": "string",
+                "enum": [
+                  "stop",
+                  "skip",
+                  "continue"
+                ],
+                "description": "Error handling: stop (default), skip this step, or continue to next"
+              }
+            },
+            "required": [
+              "tool_name",
+              "args_template"
+            ]
+          }
+        }
+      },
+      "required": [
+        "name",
+        "description",
+        "steps"
+      ]
+    }
+  },
+  {
+    "name": "execute_playbook",
+    "description": "Execute a playbook step by step, passing results forward through context (requires NOW_ASSIST_ENABLED). Supports dry_run.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "playbook": {
+          "type": "object",
+          "description": "Playbook object with name, description, and steps array",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            },
+            "steps": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "tool_name": {
+                    "type": "string"
+                  },
+                  "args_template": {
+                    "type": "object"
+                  },
+                  "condition": {
+                    "type": "string"
+                  },
+                  "on_error": {
+                    "type": "string",
+                    "enum": [
+                      "stop",
+                      "skip",
+                      "continue"
+                    ]
+                  }
+                },
+                "required": [
+                  "tool_name",
+                  "args_template"
+                ]
+              }
+            }
+          },
+          "required": [
+            "steps"
+          ]
+        },
+        "context": {
+          "type": "object",
+          "description": "Initial context key-value pairs available to all steps"
+        },
+        "dry_run": {
+          "type": "boolean",
+          "description": "Preview execution plan without invoking tools (default true)"
+        }
+      },
+      "required": [
+        "playbook"
+      ]
+    }
+  },
+  {
+    "name": "list_playbooks",
+    "description": "List stored playbook definitions from sys_hub_action_type_definition",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "number",
+          "description": "Max records to return (default 25)"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "discover_table",
+    "description": "Discover a ServiceNow table schema and register dynamic CRUD tools for it. After discovery, new tools become available: dynamic_query_<table>, dynamic_get_<table>, dynamic_create_<table>, dynamic_update_<table>, dynamic_delete_<table>. Schemas are cached for 30 minutes.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "table": {
+          "type": "string",
+          "description": "Table name to discover (e.g., \"u_custom_table\")"
+        },
+        "operations": {
+          "type": "array",
+          "description": "Operations to enable: query, get, create, update, delete. Default: all.",
+          "items": {
+            "type": "string",
+            "enum": [
+              "query",
+              "get",
+              "create",
+              "update",
+              "delete"
+            ]
+          }
+        }
+      },
+      "required": [
+        "table"
+      ]
+    }
   }
 ]

package/dist/transport/auth-middleware.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Bearer token authentication middleware for HTTP/SSE transport.
+ * Validates NOWAIKIT_API_KEY when set; skips auth in dev mode (no key configured).
+ */
+import type { IncomingMessage, ServerResponse } from 'http';
+export interface AuthRequest extends IncomingMessage {
+    authenticated?: boolean;
+}
+/**
+ * Express-compatible middleware that validates Bearer tokens.
+ * If NOWAIKIT_API_KEY is not set, all requests pass through (dev mode).
+ */
+export declare function authMiddleware(req: AuthRequest, res: ServerResponse, next: () => void): void;
+/** Check if auth is required (API key is configured). */
+export declare function isAuthRequired(): boolean;
+//# sourceMappingURL=auth-middleware.d.ts.map

package/dist/transport/auth-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-middleware.d.ts","sourceRoot":"","sources":["../../src/transport/auth-middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE5D,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAyB5F;AAED,yDAAyD;AACzD,wBAAgB,cAAc,IAAI,OAAO,CAExC"}