@centrali-io/centrali-mcp 4.4.5 → 4.4.7

package/src/tools/insights.ts

@@ -41,7 +41,7 @@ export function registerInsightTools(server: McpServer, sdk: CentraliSDK) {
         .optional()
         .describe("Filter by insight status"),
       severity: z
-        .enum(["critical", "high", "medium", "low"])
+        .enum(["info", "warning", "critical"])
         .optional()
         .describe("Filter by severity level"),
     },

package/src/tools/orchestrations.ts

@@ -63,7 +63,7 @@ export function registerOrchestrationTools(server: McpServer, sdk: CentraliSDK)
     "get_orchestration",
     "Get full details of a single orchestration by ID, including its step definitions.",
     {
-      orchestrationId: z.string().describe("The orchestration ID (UUID)"),
+      orchestrationId: z.string().describe("The orchestration ID (prefixed, e.g. orch_abc123)"),
     },
     async ({ orchestrationId }) => {
       try {
@@ -89,7 +89,7 @@ export function registerOrchestrationTools(server: McpServer, sdk: CentraliSDK)
     "trigger_orchestration",
     "Trigger an orchestration run. Creates a new run instance and starts executing the workflow. Optionally pass input data to the run.",
     {
-      orchestrationId: z.string().describe("The orchestration ID (UUID) to trigger"),
+      orchestrationId: z.string().describe("The orchestration ID (prefixed, e.g. orch_abc123) to trigger"),
       input: z
         .record(z.string(), z.any())
         .optional()
@@ -130,7 +130,7 @@ export function registerOrchestrationTools(server: McpServer, sdk: CentraliSDK)
     "list_orchestration_runs",
     "List all runs for an orchestration. Runs represent individual executions of the workflow.",
     {
-      orchestrationId: z.string().describe("The orchestration ID (UUID)"),
+      orchestrationId: z.string().describe("The orchestration ID (prefixed, e.g. orch_abc123)"),
       offset: z.number().optional().describe("Number of results to skip (for pagination)"),
       limit: z.number().optional().describe("Results per page"),
       status: z
@@ -173,8 +173,8 @@ export function registerOrchestrationTools(server: McpServer, sdk: CentraliSDK)
     "get_orchestration_run",
     "Get details of a specific orchestration run. Set includeSteps=true to see step-by-step execution history.",
     {
-      orchestrationId: z.string().describe("The orchestration ID (UUID)"),
-      runId: z.string().describe("The run ID (UUID)"),
+      orchestrationId: z.string().describe("The orchestration ID (prefixed, e.g. orch_abc123)"),
+      runId: z.string().describe("The run ID (prefixed, e.g. orun_abc123)"),
       includeSteps: z
         .boolean()
         .optional()
@@ -248,7 +248,7 @@ export function registerOrchestrationTools(server: McpServer, sdk: CentraliSDK)
     "update_orchestration",
     "Update an existing orchestration by ID. Only include the fields you want to change.",
     {
-      orchestrationId: z.string().describe("The orchestration ID (UUID) to update"),
+      orchestrationId: z.string().describe("The orchestration ID (prefixed, e.g. orch_abc123) to update"),
       name: z.string().optional().describe("Updated name"),
       description: z.string().optional().describe("Updated description"),
       status: z
@@ -295,7 +295,7 @@ export function registerOrchestrationTools(server: McpServer, sdk: CentraliSDK)
     "delete_orchestration",
     "Delete an orchestration by ID. This also deletes all runs associated with the orchestration.",
     {
-      orchestrationId: z.string().describe("The orchestration ID (UUID) to delete"),
+      orchestrationId: z.string().describe("The orchestration ID (prefixed, e.g. orch_abc123) to delete"),
     },
     async ({ orchestrationId }) => {
       try {
@@ -326,7 +326,7 @@ export function registerOrchestrationTools(server: McpServer, sdk: CentraliSDK)
     "activate_orchestration",
     "Activate an orchestration. Active orchestrations can be triggered by scheduled events, record events, and webhooks.",
     {
-      orchestrationId: z.string().describe("The orchestration ID (UUID) to activate"),
+      orchestrationId: z.string().describe("The orchestration ID (prefixed, e.g. orch_abc123) to activate"),
     },
     async ({ orchestrationId }) => {
       try {
@@ -352,7 +352,7 @@ export function registerOrchestrationTools(server: McpServer, sdk: CentraliSDK)
     "pause_orchestration",
     "Pause an orchestration. Paused orchestrations cannot be triggered by any mechanism.",
     {
-      orchestrationId: z.string().describe("The orchestration ID (UUID) to pause"),
+      orchestrationId: z.string().describe("The orchestration ID (prefixed, e.g. orch_abc123) to pause"),
     },
     async ({ orchestrationId }) => {
       try {

package/src/tools/pages.ts

@@ -41,8 +41,28 @@ function getPagesBaseUrl(centraliUrl: string): string {
   return `${url.protocol}//${hostname}/pages`;
 }
 
+/**
+ * Ensures the SDK has a valid token by making a lightweight SDK call.
+ * The SDK's internal axios interceptor handles client-credentials token
+ * fetch and 401 refresh automatically — we just need to trigger it.
+ */
+async function ensureToken(sdk: CentraliSDK): Promise<string | null> {
+  let token = sdk.getToken();
+  if (token) return token;
+
+  // Token not yet fetched — trigger the SDK's internal auth flow
+  // by making a lightweight call. The SDK will fetch and cache the token.
+  try {
+    await sdk.functions.list({ limit: 1 });
+  } catch {
+    // Ignore errors — we only need the token refresh side effect
+  }
+  return sdk.getToken();
+}
+
 /**
  * Creates an axios instance for the pages API that uses the SDK's token.
+ * Auth is handled through the SDK's public getToken() API — no internal casting.
  */
 function createPagesClient(sdk: CentraliSDK, centraliUrl: string, workspaceId: string): {
   client: AxiosInstance;
@@ -53,7 +73,7 @@ function createPagesClient(sdk: CentraliSDK, centraliUrl: string, workspaceId: s
 
   // Attach the SDK's bearer token to every request
   client.interceptors.request.use(async (config) => {
-    const token = (sdk as any).getToken?.() ?? (sdk as any).token;
+    const token = await ensureToken(sdk);
     if (token) {
       config.headers.Authorization = `Bearer ${token}`;
     }
@@ -70,16 +90,14 @@ function createPagesClient(sdk: CentraliSDK, centraliUrl: string, workspaceId: s
       if (isAuthError && !originalRequest._hasRetried) {
         originalRequest._hasRetried = true;
 
-        // Force SDK to fetch a fresh token
-        const freshToken = await (sdk as any).getTokenOrFetch?.();
-        if (!freshToken) {
-          // SDK can't get a token either — trigger a re-auth by making any SDK call
-          try {
-            await (sdk as any).axios?.get?.('/health');
-          } catch { /* ignore — we just want the token refresh side effect */ }
+        // Force a fresh token by making an SDK call (triggers internal 401 refresh)
+        try {
+          await sdk.functions.list({ limit: 1 });
+        } catch {
+          // Ignore — we only need the token refresh side effect
         }
 
-        const token = (sdk as any).getToken?.() ?? (sdk as any).token;
+        const token = sdk.getToken();
         if (token) {
           originalRequest.headers.Authorization = `Bearer ${token}`;
           return client.request(originalRequest);