nowaikit 4.9.1 → 4.11.0

package/dist/tools-manifest.json

@@ -1968,7 +1968,7 @@
   },
   {
     "name": "get_sys_log",
-    "description": "Retrieve system log entries for debugging or auditing",
+    "description": "Retrieve system log entries for debugging or auditing. Set app_scope=true to read the scoped-application log (syslog_app_scope), where scoped gs.info()/gs.log() output lands, instead of the global syslog.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -1976,6 +1976,10 @@
           "type": "string",
           "description": "Filter (e.g., \"level=error^sys_created_onONToday@javascript:gs.beginningOfToday()@javascript:gs.endOfToday()\")"
         },
+        "app_scope": {
+          "type": "boolean",
+          "description": "Read syslog_app_scope (scoped-app log output) instead of the global syslog."
+        },
         "limit": {
           "type": "number",
           "description": "Max entries (default: 20)"
@@ -3477,6 +3481,134 @@
       "required": []
     }
   },
+  {
+    "name": "create_story_dependency",
+    "description": "Link one agile story as dependent on another (m2m_story_dependencies). Requires WRITE_ENABLED=true.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "story": {
+          "type": "string",
+          "description": "The dependent story sys_id (the one that is blocked)"
+        },
+        "dependent_story": {
+          "type": "string",
+          "description": "The story it depends on (the blocker) sys_id"
+        }
+      },
+      "required": [
+        "story",
+        "dependent_story"
+      ]
+    }
+  },
+  {
+    "name": "list_story_dependencies",
+    "description": "List dependency links for a story (m2m_story_dependencies).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "story": {
+          "type": "string",
+          "description": "Story sys_id to list dependencies for"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max results (default: 50)"
+        }
+      },
+      "required": [
+        "story"
+      ]
+    }
+  },
+  {
+    "name": "delete_story_dependency",
+    "description": "Remove a story dependency link by its m2m_story_dependencies sys_id. Requires WRITE_ENABLED=true.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "sys_id": {
+          "type": "string",
+          "description": "The m2m_story_dependencies record sys_id"
+        }
+      },
+      "required": [
+        "sys_id"
+      ]
+    }
+  },
+  {
+    "name": "create_project",
+    "description": "Create a PPM project (pm_project). Requires WRITE_ENABLED=true.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "short_description": {
+          "type": "string",
+          "description": "Project name / short description"
+        },
+        "description": {
+          "type": "string",
+          "description": "Project description"
+        },
+        "state": {
+          "type": "string",
+          "description": "Project state (e.g. pending, open, work in progress)"
+        },
+        "priority": {
+          "type": "string",
+          "description": "Priority (1-5)"
+        },
+        "fields": {
+          "type": "object",
+          "description": "Additional pm_project fields (start_date, end_date, project_manager, etc.)"
+        }
+      },
+      "required": [
+        "short_description"
+      ]
+    }
+  },
+  {
+    "name": "update_project",
+    "description": "Update a PPM project (pm_project). Requires WRITE_ENABLED=true.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "sys_id": {
+          "type": "string",
+          "description": "Project sys_id"
+        },
+        "fields": {
+          "type": "object",
+          "description": "Key-value pairs to update"
+        }
+      },
+      "required": [
+        "sys_id",
+        "fields"
+      ]
+    }
+  },
+  {
+    "name": "list_projects",
+    "description": "List PPM projects (pm_project).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Encoded query filter (e.g. state=open)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max results (default: 20)"
+        }
+      },
+      "required": []
+    }
+  },
   {
     "name": "create_hr_case",
     "description": "Create a new HR Service Delivery case (requires WRITE_ENABLED=true)",
@@ -4697,10 +4829,14 @@
   },
   {
     "name": "list_action_instances",
-    "description": "List reusable Flow Designer action instances available in the environment",
+    "description": "List Flow Designer action instances. Pass flow_id to scope to a single flow's steps (recommended); otherwise lists across the environment.",
     "inputSchema": {
       "type": "object",
       "properties": {
+        "flow_id": {
+          "type": "string",
+          "description": "Parent flow sys_id (sys_hub_flow). Returns only that flow's action instances."
+        },
         "query": {
           "type": "string",
           "description": "Search actions by name or category"
@@ -4876,6 +5012,42 @@
       ]
     }
   },
+  {
+    "name": "update_flow",
+    "description": "Update a flow or subflow's METADATA only (activate/deactivate, name, description, run-as). **[Write]** NOTE: this cannot safely insert or edit flow STEPS. Flow Designer executes a compiled snapshot, and writing action-instance rows over REST does not recompile the flow, which would desync/corrupt it. Edit steps in the Flow Designer UI.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "flow_sys_id": {
+          "type": "string",
+          "description": "Flow or subflow sys_id"
+        },
+        "type": {
+          "type": "string",
+          "description": "Type: flow or subflow (default flow)"
+        },
+        "active": {
+          "type": "boolean",
+          "description": "Activate (true) or deactivate (false)"
+        },
+        "name": {
+          "type": "string",
+          "description": "New name"
+        },
+        "description": {
+          "type": "string",
+          "description": "New description"
+        },
+        "run_as": {
+          "type": "string",
+          "description": "run_as value (e.g. user_who_triggers, system_user)"
+        }
+      },
+      "required": [
+        "flow_sys_id"
+      ]
+    }
+  },
   {
     "name": "test_flow",
     "description": "Execute a flow in test mode with sample inputs. **[Write]**",
@@ -4920,6 +5092,141 @@
       ]
     }
   },
+  {
+    "name": "list_decision_tables",
+    "description": "List Decision Builder decision tables (sys_decision), optionally filtered by name or active status",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Search decision tables by name or description"
+        },
+        "active": {
+          "type": "boolean",
+          "description": "Filter to active decision tables only"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max records to return (default 50)"
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "get_decision_table",
+    "description": "Get a decision table with its inputs and answer rows, by name or sys_id",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name_or_sysid": {
+          "type": "string",
+          "description": "Decision table name or sys_id"
+        }
+      },
+      "required": [
+        "name_or_sysid"
+      ]
+    }
+  },
+  {
+    "name": "list_decision_inputs",
+    "description": "List the inputs of a decision table",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "decision_sys_id": {
+          "type": "string",
+          "description": "sys_id of the decision table (sys_decision)"
+        }
+      },
+      "required": [
+        "decision_sys_id"
+      ]
+    }
+  },
+  {
+    "name": "list_decision_answers",
+    "description": "List the answer/result rows of a decision table",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "decision_sys_id": {
+          "type": "string",
+          "description": "sys_id of the decision table (sys_decision)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max records to return (default 100)"
+        }
+      },
+      "required": [
+        "decision_sys_id"
+      ]
+    }
+  },
+  {
+    "name": "create_decision_table",
+    "description": "Create a Decision Builder decision table (sys_decision). Requires WRITE_ENABLED=true",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Decision table name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of what the decision returns"
+        },
+        "active": {
+          "type": "boolean",
+          "description": "Whether the decision table is active (default true)"
+        },
+        "fields": {
+          "type": "object",
+          "description": "Additional sys_decision field values to set"
+        }
+      },
+      "required": [
+        "name"
+      ]
+    }
+  },
+  {
+    "name": "create_decision_input",
+    "description": "Add an input to a decision table (sys_decision_input). Requires WRITE_ENABLED=true",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "decision_sys_id": {
+          "type": "string",
+          "description": "sys_id of the parent decision table (sys_decision)"
+        },
+        "name": {
+          "type": "string",
+          "description": "Input name/label"
+        },
+        "type": {
+          "type": "string",
+          "description": "Input data type (e.g., string, integer, reference, boolean)"
+        },
+        "order": {
+          "type": "number",
+          "description": "Display order of the input"
+        },
+        "fields": {
+          "type": "object",
+          "description": "Additional sys_decision_input field values to set"
+        }
+      },
+      "required": [
+        "decision_sys_id",
+        "name"
+      ]
+    }
+  },
   {
     "name": "list_portals",
     "description": "List all Service Portal configurations available in the instance",
@@ -8714,7 +9021,7 @@
   },
   {
     "name": "fluent_version",
-    "description": "Report the installed `@servicenow/sdk` (now-sdk) version and whether it meets the version NowAIKit tracks features against (currently 4.8.0). Returns an upgrade hint when out of date.",
+    "description": "Report the installed `@servicenow/sdk` (now-sdk) version and whether it meets the version NowAIKit tracks features against (currently 4.10.1). Returns an upgrade hint when out of date.",
     "inputSchema": {
       "type": "object",
       "properties": {},
@@ -8723,7 +9030,7 @@
   },
   {
     "name": "fluent_explain",
-    "description": "Run `npx @servicenow/sdk explain <topic>` to get live SDK documentation on a topic — always current API signatures, not training-data guesses. Returns explanations of Fluent APIs, types, patterns, and best practices. Known topics include: GlideQuery, table API, scoped app, now.config.json, keys.ts, metadata, Record, Now.del, Now.attach, DataLookup, RestMessage, Alias, AliasTemplate, RetryPolicy, Playbook, Flow, Subflow, CustomAction, TryCatch, DoInParallel, FlowStages, AiAgent, AiAgentWorkflow, roleMap, NowAssistSkillConfig, UiPolicy, DataPolicy, Form, InstanceScan, ServicePortal, ImportSet, override.",
+    "description": "Run `npx @servicenow/sdk explain <topic>` to get live SDK documentation on a topic — always current API signatures, not training-data guesses. Returns explanations of Fluent APIs, types, patterns, and best practices. Known topics include: GlideQuery, table API, scoped app, now.config.json, keys.ts, metadata, Record, Now.del, Now.attach, DataLookup, RestMessage, Alias, AliasTemplate, RetryPolicy, Playbook, Flow, Subflow, CustomAction, TryCatch, DoInParallel, FlowStages, AiAgent, AiAgentWorkflow, roleMap, NowAssistSkillConfig, UiPolicy, DataPolicy, Form, InstanceScan, ServicePortal, ImportSet, override, StateModel, cicd.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -8789,6 +9096,43 @@
       "required": []
     }
   },
+  {
+    "name": "fluent_cicd",
+    "description": "Run ServiceNow CI/CD operations via the SDK (`now-sdk cicd`, new in @servicenow/sdk 4.10). Drive scoped-app install/publish and ATF test-suite runs from a promotion pipeline, outside the local build/install flow. REQUIRES FLUENT_ENABLED=true and WRITE_ENABLED=true.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "install",
+            "publish",
+            "testsuite"
+          ],
+          "description": "install a published app version, publish an app scope to the app repo, or run an ATF test suite"
+        },
+        "appSysId": {
+          "type": "string",
+          "description": "App sys_id (required for action=install)"
+        },
+        "scope": {
+          "type": "string",
+          "description": "App scope, e.g. x_acme_app (required for action=publish)"
+        },
+        "appVersion": {
+          "type": "string",
+          "description": "App version, e.g. 1.0.0 (install/publish)"
+        },
+        "testSuiteName": {
+          "type": "string",
+          "description": "ATF test suite name (required for action=testsuite)"
+        }
+      },
+      "required": [
+        "action"
+      ]
+    }
+  },
   {
     "name": "search_servicenow_docs",
     "description": "Search the official ServiceNow product documentation (servicenow.com/docs) — API references (GlideRecord, GlideSystem, GlideAjax…), admin & developer guides, encoded-query operators, release notes. Returns ranked results with title, breadcrumb, URL, snippet, and a `ref` to read the full page with fetch_servicenow_doc. Use this to ground answers in current ServiceNow docs rather than memory. Read-only; uses the public docs site, not your instance.",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nowaikit",
   "mcpName": "io.github.aartiq/nowaikit",
-  "version": "4.9.1",
+  "version": "4.11.0",
   "description": "The most comprehensive ServiceNow AI toolkit. 450+ MCP tools plus 26 AI capabilities (scan, review, build, ops, docs) plus direct BYOK mode. Integrates with Claude, ChatGPT, Gemini, Cursor, GitHub Copilot and any LLM.",
   "main": "dist/server.js",
   "types": "dist/server.d.ts",
@@ -144,5 +144,9 @@
     "tsx": "^4.7.0",
     "typescript": "^5.3.3",
     "vitest": "^4.0.18"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "https://nowaikit.com"
   }
 }