@zibby/skills 0.1.33 → 0.1.35

package/dist/integrations.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Integration registry — the closed set of OAuth/credentialed external
+ * services a Zibby skill can declare a dependency on.
+ *
+ * Why this exists:
+ *   Skills hand-off authentication to the backend's resolveIntegrationToken()
+ *   (see packages/skills/src/jira.js, sentry.js, etc.). At deploy time we
+ *   want to know "does THIS workflow need Slack connected before it can
+ *   run?" without re-grepping handler source. Skills declare it explicitly
+ *   via `requiresIntegration: INTEGRATIONS.<NAME>` and the backend
+ *   workflow-bundler derives `workflow.requiredIntegrations` from the
+ *   union of every node's skill list. Same pattern as npm peer-deps,
+ *   Helm `requires`, Terraform `required_providers`.
+ *
+ * Source of truth for IDs lives here (Object.freeze) — both backend
+ * (`backend/src/services/skill-integrations.js`) and frontend (settings
+ * UI) reference these string constants. Backend mirrors the skill→
+ * integration mapping locally because @zibby/skills is NOT bundled into
+ * the Lambda layer (per CLAUDE.md: lambda-layer/nodejs/package.json must
+ * stay under 262MB and only carries production runtime deps).
+ */
+export const INTEGRATIONS: Readonly<{
+    SENTRY: "sentry";
+    JIRA: "jira";
+    GITHUB: "github";
+    GITLAB: "gitlab";
+    SLACK: "slack";
+    LARK: "lark";
+    OPENAI_BILLING: "openai_billing";
+    ANTHROPIC_BILLING: "anthropic_billing";
+    CURSOR_ADMIN: "cursor_admin";
+    NOTION: "notion";
+    PLANE: "plane";
+    LINEAR: "linear";
+}>;
+/**
+ * Display metadata. Surface this to humans (modal copy, missing-list
+ * rendering) — backend joins this with the user's connected list and
+ * returns it from GET /workflows/{uuid}/integrations/status.
+ *
+ * `connectPath` points to the existing frontend Integrations page —
+ * verified against frontend/src/App.js (route `/integrations`) and
+ * frontend/src/pages/IntegrationsPage/IntegrationsPage.js (single page
+ * handles all six providers). We pass the provider name as a query
+ * param so the UI can highlight / scroll the relevant card; the page
+ * gracefully ignores the param if not handled yet. NO per-provider
+ * sub-routes exist (`/integrations/jira` etc. would 404 today).
+ */
+export const INTEGRATION_REGISTRY: Readonly<{
+    sentry: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    jira: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    github: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    gitlab: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    slack: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    lark: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    openai_billing: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    anthropic_billing: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    cursor_admin: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    notion: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    plane: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+    linear: {
+        id: string;
+        name: string;
+        connectPath: string;
+    };
+}>;

package/dist/jira.d.ts

@@ -0,0 +1,547 @@
+/**
+ * Low-level Jira REST helper. Resolves the OAuth bearer + cloudId via
+ * resolveIntegrationToken('jira'), retries once on transient auth errors,
+ * and returns parsed JSON (or `{ raw }` for non-JSON bodies).
+ *
+ * Exported so other templates (e.g. tracker-writeback) can issue Jira
+ * REST calls the JIRA skill's MCP tools don't cover — currently the only
+ * gap is attaching a PR remote-link; everything else (transition, comment)
+ * has a first-class tool. Keep this the single auth/cloudId chokepoint;
+ * don't re-implement token resolution at call sites.
+ *
+ * @param {string} path  Jira REST path, e.g. `/rest/api/3/issue/PROJ-1`
+ * @param {{ method?: string, body?: any, headers?: object }} [opts]
+ * @returns {Promise<any>} parsed JSON response body
+ */
+export function jiraFetch(path: string, opts?: {
+    method?: string;
+    body?: any;
+    headers?: object;
+}): Promise<any>;
+export namespace jiraSkill {
+    let id: string;
+    let serverName: string;
+    let allowedTools: string[];
+    let requiresIntegration: "jira";
+    let envKeys: string[];
+    let description: string;
+    let promptFragment: string;
+    function resolve(): {
+        command: string;
+        args: any[];
+        env: {
+            ATLASSIAN_INSTANCE_URL: any;
+        };
+        description: string;
+    };
+    function handleToolCall(name: any, args: any): Promise<string>;
+    let tools: ({
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                projectKey?: undefined;
+                jql?: undefined;
+                maxResults?: undefined;
+                issueKey?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                projectKey: {
+                    type: string;
+                    description: string;
+                };
+                jql?: undefined;
+                maxResults?: undefined;
+                issueKey?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                projectKey: {
+                    type: string;
+                    description: string;
+                };
+                jql?: undefined;
+                maxResults?: undefined;
+                issueKey?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                jql: {
+                    type: string;
+                    description: string;
+                };
+                maxResults: {
+                    type: string;
+                    description: string;
+                };
+                projectKey?: undefined;
+                issueKey?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                issueKey: {
+                    type: string;
+                    description: string;
+                };
+                projectKey?: undefined;
+                jql?: undefined;
+                maxResults?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                projectKey: {
+                    type: string;
+                    description: string;
+                };
+                summary: {
+                    type: string;
+                    description: string;
+                };
+                issueType: {
+                    type: string;
+                    description: string;
+                };
+                description: {
+                    type: string;
+                    description: string;
+                };
+                priority: {
+                    type: string;
+                    description: string;
+                };
+                labels: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                assigneeId: {
+                    type: string;
+                    description: string;
+                };
+                moveToSprint: {
+                    type: string;
+                    description: string;
+                };
+                moveToActiveSprint: {
+                    type: string;
+                    description: string;
+                };
+                sprintId: {
+                    type: string;
+                    description: string;
+                };
+                sprintName: {
+                    type: string;
+                    description: string;
+                };
+                target: {
+                    type: string;
+                    description: string;
+                };
+                jql?: undefined;
+                maxResults?: undefined;
+                issueKey?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                projectKey: {
+                    type: string;
+                    description: string;
+                };
+                state: {
+                    type: string;
+                    description: string;
+                };
+                jql?: undefined;
+                maxResults?: undefined;
+                issueKey?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                sprintName: {
+                    type: string;
+                    description: string;
+                };
+                sprintId: {
+                    type: string;
+                    description: string;
+                };
+                projectKey: {
+                    type: string;
+                    description: string;
+                };
+                status: {
+                    type: string;
+                    description: string;
+                };
+                maxResults: {
+                    type: string;
+                    description: string;
+                };
+                jql?: undefined;
+                issueKey?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                target?: undefined;
+                state?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                issueKey: {
+                    type: string;
+                    description: string;
+                };
+                projectKey: {
+                    type: string;
+                    description: string;
+                };
+                sprintId: {
+                    type: string;
+                    description: string;
+                };
+                sprintName: {
+                    type: string;
+                    description: string;
+                };
+                target: {
+                    type: string;
+                    description: string;
+                };
+                jql?: undefined;
+                maxResults?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                issueKey: {
+                    type: string;
+                    description: string;
+                };
+                maxResults: {
+                    type: string;
+                    description: string;
+                };
+                projectKey?: undefined;
+                jql?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                issueKey: {
+                    type: string;
+                    description: string;
+                };
+                body: {
+                    type: string;
+                    description: string;
+                };
+                projectKey?: undefined;
+                jql?: undefined;
+                maxResults?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                state?: undefined;
+                status?: undefined;
+                fields?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                issueKey: {
+                    type: string;
+                    description: string;
+                };
+                fields: {
+                    type: string;
+                    description: string;
+                    additionalProperties: boolean;
+                };
+                projectKey?: undefined;
+                jql?: undefined;
+                maxResults?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                transitionId?: undefined;
+                toStatus?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                issueKey: {
+                    type: string;
+                    description: string;
+                };
+                transitionId: {
+                    type: string;
+                    description: string;
+                };
+                toStatus: {
+                    type: string;
+                    description: string;
+                };
+                projectKey?: undefined;
+                jql?: undefined;
+                maxResults?: undefined;
+                summary?: undefined;
+                issueType?: undefined;
+                description?: undefined;
+                priority?: undefined;
+                labels?: undefined;
+                assigneeId?: undefined;
+                moveToSprint?: undefined;
+                moveToActiveSprint?: undefined;
+                sprintId?: undefined;
+                sprintName?: undefined;
+                target?: undefined;
+                state?: undefined;
+                status?: undefined;
+                body?: undefined;
+                fields?: undefined;
+            };
+            required: string[];
+        };
+    })[];
+}