@mastra/factory 0.24.0-alpha.11 → 0.24.0-alpha.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -4
- package/dist/environment/build-runner.js +2 -1
- package/dist/environment/build-runner.js.map +1 -1
- package/dist/environment/build-workflow.js +1 -1
- package/dist/environment/build-workflow.js.map +1 -1
- package/dist/environment/build.js +16 -14
- package/dist/environment/build.js.map +1 -1
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +25 -1
- package/dist/factory.js.map +1 -1
- package/dist/integrations/github/app-identity.js.map +1 -1
- package/dist/integrations/github/integration.js +1 -1
- package/dist/integrations/github/integration.js.map +1 -1
- package/dist/integrations/github/reconcile-worker.js +1 -1
- package/dist/integrations/github/reconcile-worker.js.map +1 -1
- package/dist/integrations/github/routes.d.ts.map +1 -1
- package/dist/integrations/github/routes.js +6 -3
- package/dist/integrations/github/routes.js.map +1 -1
- package/dist/integrations/github/rules.js +3 -2
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/github/sandbox.js +2 -2
- package/dist/integrations/github/sandbox.js.map +1 -1
- package/dist/integrations/gitlab/api.js.map +1 -1
- package/dist/integrations/gitlab/integration.js.map +1 -1
- package/dist/integrations/gitlab/reconciliation-config.js +2 -1
- package/dist/integrations/gitlab/reconciliation-config.js.map +1 -1
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/incidentio/api.js.map +1 -1
- package/dist/integrations/incidentio/integration.js.map +1 -1
- package/dist/integrations/incidentio/rules.js.map +1 -1
- package/dist/integrations/issue-reconcile-worker.js +1 -1
- package/dist/integrations/issue-reconcile-worker.js.map +1 -1
- package/dist/integrations/issue-reconciler.js +1 -1
- package/dist/integrations/issue-reconciler.js.map +1 -1
- package/dist/integrations/jira/api.js.map +1 -1
- package/dist/integrations/jira/integration.js.map +1 -1
- package/dist/integrations/jira/rules.js.map +1 -1
- package/dist/integrations/linear/integration.js.map +1 -1
- package/dist/integrations/linear/rules.js.map +1 -1
- package/dist/integrations/platform/api-client.js.map +1 -1
- package/dist/integrations/platform/github/event-worker.js +1 -1
- package/dist/integrations/platform/github/event-worker.js.map +1 -1
- package/dist/integrations/platform/github/integration.js +2 -2
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/platform/gitlab/event-worker.js.map +1 -1
- package/dist/integrations/platform/gitlab/integration.js.map +1 -1
- package/dist/integrations/platform/incidentio/integration.js +2 -1
- package/dist/integrations/platform/incidentio/integration.js.map +1 -1
- package/dist/integrations/platform/jira/integration.js.map +1 -1
- package/dist/integrations/platform/linear/event-worker.js +1 -1
- package/dist/integrations/platform/linear/event-worker.js.map +1 -1
- package/dist/integrations/platform/linear/integration.js.map +1 -1
- package/dist/integrations/slack/connect-route.js +1 -1
- package/dist/integrations/slack/connect-route.js.map +1 -1
- package/dist/integrations/slack/feed-publisher.js +1 -1
- package/dist/integrations/slack/feed-publisher.js.map +1 -1
- package/dist/integrations/slack/integration.js +1 -1
- package/dist/integrations/slack/integration.js.map +1 -1
- package/dist/integrations/slack/slack.js +2 -1
- package/dist/integrations/slack/slack.js.map +1 -1
- package/dist/integrations/workos/integration.js.map +1 -1
- package/dist/packages/_internals/workspace/dist/index.js +18 -1
- package/dist/packages/_internals/workspace/dist/index.js.map +1 -1
- package/dist/routes/attention-activity.js.map +1 -1
- package/dist/routes/attention-parked.js.map +1 -1
- package/dist/routes/attention-providers.js.map +1 -1
- package/dist/routes/automation-runs.js.map +1 -1
- package/dist/routes/contracts.js +1 -1
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/custom-provider-source.js.map +1 -1
- package/dist/routes/fs.d.ts +31 -23
- package/dist/routes/fs.d.ts.map +1 -1
- package/dist/routes/fs.js +218 -64
- package/dist/routes/fs.js.map +1 -1
- package/dist/routes/intake.js +2 -1
- package/dist/routes/intake.js.map +1 -1
- package/dist/routes/knowledge.js +1 -1
- package/dist/routes/knowledge.js.map +1 -1
- package/dist/routes/oauth.js +3 -2
- package/dist/routes/oauth.js.map +1 -1
- package/dist/routes/projects.js +32 -30
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/session-access.d.ts +55 -0
- package/dist/routes/session-access.d.ts.map +1 -0
- package/dist/routes/session-access.js +165 -0
- package/dist/routes/session-access.js.map +1 -0
- package/dist/routes/skills.js.map +1 -1
- package/dist/routes/source-control-sessions.d.ts +5 -0
- package/dist/routes/source-control-sessions.d.ts.map +1 -1
- package/dist/routes/source-control-sessions.js +87 -10
- package/dist/routes/source-control-sessions.js.map +1 -1
- package/dist/routes/surface.d.ts +5 -0
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +10 -4
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/tenant-credentials.js.map +1 -1
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/binding-context.js +4 -2
- package/dist/rules/binding-context.js.map +1 -1
- package/dist/rules/dispatcher.js +4 -4
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/start-coordinator.js.map +1 -1
- package/dist/rules/tools.js +2 -2
- package/dist/rules/tools.js.map +1 -1
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/sandbox/callback-factory-sandbox.js.map +1 -1
- package/dist/sandbox/local-factory-sandbox.js.map +1 -1
- package/dist/sandbox/session-retirement.js.map +1 -1
- package/dist/session/live-sessions.js.map +1 -1
- package/dist/session/memory-settings-hydration.js +2 -1
- package/dist/session/memory-settings-hydration.js.map +1 -1
- package/dist/session/resource-migration.d.ts +18 -0
- package/dist/session/resource-migration.d.ts.map +1 -1
- package/dist/session/resource-migration.js +24 -1
- package/dist/session/resource-migration.js.map +1 -1
- package/dist/session/session-threads.d.ts +9 -0
- package/dist/session/session-threads.d.ts.map +1 -1
- package/dist/session/session-threads.js +24 -4
- package/dist/session/session-threads.js.map +1 -1
- package/dist/spa-static.js.map +1 -1
- package/dist/state-signing.js +1 -1
- package/dist/state-signing.js.map +1 -1
- package/dist/storage/domains/audit/base.js.map +1 -1
- package/dist/storage/domains/audit/domain.js.map +1 -1
- package/dist/storage/domains/channel-identity/base.js.map +1 -1
- package/dist/storage/domains/comments/base.js.map +1 -1
- package/dist/storage/domains/comments/domain.js.map +1 -1
- package/dist/storage/domains/comments/feed-context.js.map +1 -1
- package/dist/storage/domains/credentials/base.js.map +1 -1
- package/dist/storage/domains/custom-providers/base.js.map +1 -1
- package/dist/storage/domains/intake/base.js.map +1 -1
- package/dist/storage/domains/integrations/base.js.map +1 -1
- package/dist/storage/domains/memory-settings/base.js.map +1 -1
- package/dist/storage/domains/model-defaults/base.js.map +1 -1
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/queue-health/base.js.map +1 -1
- package/dist/storage/domains/source-control/base.d.ts +15 -0
- package/dist/storage/domains/source-control/base.d.ts.map +1 -1
- package/dist/storage/domains/source-control/base.js +29 -0
- package/dist/storage/domains/source-control/base.js.map +1 -1
- package/dist/storage/domains/source-control/inmemory.d.ts +5 -1
- package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -1
- package/dist/storage/domains/source-control/inmemory.js +7 -0
- package/dist/storage/domains/source-control/inmemory.js.map +1 -1
- package/dist/storage/domains/work-items/base.js +2 -1
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/storage/domains/work-items/board-version.js.map +1 -1
- package/dist/storage/domains/work-items/metrics.js.map +1 -1
- package/dist/tools/messaging-tools.d.ts.map +1 -1
- package/dist/tools/messaging-tools.js +201 -73
- package/dist/tools/messaging-tools.js.map +1 -1
- package/dist/tools/run-watch.d.ts +2 -0
- package/dist/tools/run-watch.d.ts.map +1 -1
- package/dist/tools/run-watch.js +42 -2
- package/dist/tools/run-watch.js.map +1 -1
- package/dist/tools/session-tools.d.ts.map +1 -1
- package/dist/tools/session-tools.js +25 -10
- package/dist/tools/session-tools.js.map +1 -1
- package/dist/tools/sessions-state-processor.js +2 -2
- package/dist/tools/sessions-state-processor.js.map +1 -1
- package/dist/workspace.d.ts +5 -2
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +26 -13
- package/dist/workspace.js.map +1 -1
- package/package.json +9 -9
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api.js","names":["#baseUrl","#accessToken","#projectId","#fetch","#request","#page"],"sources":["../../../src/integrations/incidentio/api.ts"],"sourcesContent":["export interface IncidentioUser {\n id: string;\n name: string;\n email?: string;\n role?: string;\n slack_user_id?: string;\n}\n\nexport interface IncidentioActor {\n alert?: { id: string; title: string };\n api_key?: { id: string; name: string };\n user?: IncidentioUser;\n workflow?: { id: string; name: string };\n}\n\nexport interface IncidentioIncident {\n id: string;\n reference: string;\n name: string;\n summary?: string;\n permalink?: string;\n visibility: string;\n mode: string;\n creator: IncidentioActor;\n incident_status: { id: string; name: string; category: string };\n incident_type?: { id: string; name: string };\n severity?: { id: string; name: string; rank: number };\n slack_channel_url?: string;\n postmortem_document_url?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioFollowUp {\n id: string;\n incident_id: string;\n title: string;\n description?: string;\n status: 'outstanding' | 'completed' | 'deleted' | 'not_doing';\n creator: IncidentioActor;\n assignee?: IncidentioUser | null;\n assignee_team?: { id: string; name: string } | null;\n labels: string[];\n priority?: { id: string; name: string; rank: number } | null;\n category?: { id: string; name: string } | null;\n external_issue_reference?: { issue_name: string; issue_permalink: string; provider: string } | null;\n completed_at?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioAction {\n id: string;\n incident_id: string;\n description: string;\n status: 'outstanding' | 'completed' | 'deleted' | 'not_doing';\n creator: IncidentioActor;\n assignee?: IncidentioUser;\n completed_at?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioIncidentUpdate {\n id: string;\n incident_id: string;\n updater: IncidentioActor;\n new_incident_status: { id: string; name: string; category: string };\n message?: string;\n merged_into_incident_id?: string;\n new_severity?: { id: string; name: string; rank: number };\n created_at: string;\n}\n\nexport interface IncidentioAlertAttributeValue {\n catalog_entry?: { id: string; name: string; catalog_type_id?: string };\n label?: string;\n literal?: string;\n}\n\nexport interface IncidentioAlertAttributeEntry {\n attribute: {\n id: string;\n name: string;\n type: string;\n array: boolean;\n required: boolean;\n emoji?: string;\n };\n value?: IncidentioAlertAttributeValue;\n array_value?: IncidentioAlertAttributeValue[];\n}\n\nexport interface IncidentioAlert {\n id: string;\n alert_source_id: string;\n deduplication_key: string;\n status: 'firing' | 'resolved';\n title: string;\n attributes: IncidentioAlertAttributeEntry[];\n alert_group_ids?: string[];\n description?: string;\n resolved_at?: string;\n source_url?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioEscalation {\n id: string;\n status:\n 'pending' | 'triggered' | 'acked' | 'resolved' | 'expired' | 'cancelled' | 'snoozed' | 'delayed' | 'pending_repeat';\n title: string;\n description: string;\n priority: { name: string };\n creator: IncidentioActor;\n escalation_path_id?: string;\n events: Array<{\n id: string;\n event:\n | 'entered_grace_period'\n | 'triggered'\n | 'notified_users'\n | 'notified_channels'\n | 'acked'\n | 'cancelled'\n | 'resolved'\n | 'expired';\n occurred_at: string;\n urgency?: 'high' | 'low';\n users?: IncidentioUser[];\n channels?: Array<{\n microsoft_teams_channel_id?: string;\n microsoft_teams_team_id?: string;\n slack_channel_id?: string;\n slack_team_id?: string;\n }>;\n }>;\n related_incidents: Array<{\n id: string;\n external_id: number;\n name: string;\n reference: string;\n visibility: 'public' | 'private';\n status_category: string;\n summary?: string;\n }>;\n related_alerts: Array<{\n id: string;\n alert_source_id: string;\n deduplication_key: string;\n status: 'firing' | 'resolved';\n title: string;\n alert_group_ids?: string[];\n description?: string;\n resolved_at?: string;\n source_url?: string;\n created_at: string;\n updated_at: string;\n }>;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioCatalogEntry {\n id: string;\n catalog_type_id: string;\n name: string;\n aliases: string[];\n rank: number;\n attribute_values: Record<\n string,\n {\n value?: { label: string; literal?: string };\n array_value?: Array<{ label: string; literal?: string }>;\n }\n >;\n external_id?: string;\n archived_at?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioCatalogType {\n id: string;\n name: string;\n description: string;\n type_name: string;\n ranked: boolean;\n is_editable: boolean;\n use_name_as_identifier: boolean;\n categories: string[];\n annotations: Record<string, string>;\n color: string;\n icon: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioCatalogResource {\n type: string;\n engine_resource_type: string;\n label: string;\n description: string;\n value_docstring: string;\n category: string;\n}\n\nexport interface IncidentioTeam {\n id: string;\n name: string;\n catalog_entry: { id: string; name: string; external_id?: string };\n members: IncidentioUser[];\n}\n\nexport interface IncidentioSchedule {\n id: string;\n name: string;\n timezone: string;\n team_ids: string[];\n permalink: string;\n annotations: Record<string, string>;\n config?: {\n rotations: Array<{\n id: string;\n name: string;\n users: IncidentioUser[];\n handover_start_at: string;\n scheduling_mode?: 'fair' | 'sequential';\n }>;\n };\n current_shifts?: IncidentioScheduleEntry[];\n next_shifts?: IncidentioScheduleEntry[];\n holidays_public_config?: { country_codes: string[] };\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioScheduleEntry {\n start_at: string;\n end_at: string;\n entry_id?: string;\n fingerprint?: string;\n layer_id?: string;\n rotation_id?: string;\n user?: IncidentioUser;\n}\n\nexport interface IncidentioPolicyFinding {\n id: string;\n policy_id: string;\n policy_type: 'debrief' | 'follow_up' | 'on_call_readiness' | 'post_mortem' | 'schedule' | 'vacation_conflict';\n state: 'pending' | 'active' | 'resolved' | 'cancelled' | 'dismissed';\n responsible_users: IncidentioUser[];\n days?: number;\n due_at?: string;\n debrief?: { incident_id: string };\n dismissal?: { dismissed_at: string; dismissed_by: IncidentioActor; reason: string };\n follow_up?: { incident_id: string; follow_up_id: string };\n on_call_readiness?: {\n user_id: string;\n high_urgency: IncidentioReadinessRule[];\n low_urgency: IncidentioReadinessRule[];\n };\n post_mortem?: { incident_id: string };\n schedule?: {\n schedule_id: string;\n start_at: string;\n end_at: string;\n cause?: 'nobody_scheduled' | 'no_on_call_seat' | 'user_deactivated';\n has_unscheduled_time?: boolean;\n rotation_id?: string;\n };\n vacation_conflict?: {\n user_id: string;\n schedule_id: string;\n start_at: string;\n end_at: string;\n holiday_name?: string;\n rotation_id?: string;\n };\n last_checked_at: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioReadinessRule {\n method_types: string[];\n met: boolean;\n max_delay_seconds?: number;\n}\n\nexport interface IncidentioPage<T> {\n items: T[];\n nextCursor: string | null;\n total?: number;\n}\n\nexport interface IncidentioCatalogEntryPage extends IncidentioPage<IncidentioCatalogEntry> {\n catalogType: IncidentioCatalogType;\n}\n\nexport interface IncidentioCatalogEntryResult {\n entry: IncidentioCatalogEntry;\n catalogType: IncidentioCatalogType;\n}\n\nexport interface IncidentioListOptions {\n cursor?: string;\n pageSize?: number;\n}\n\nexport interface IncidentioListActionsOptions extends IncidentioListOptions {\n incidentId?: string;\n incidentMode?: string;\n}\n\nexport interface IncidentioListIncidentUpdatesOptions extends IncidentioListOptions {\n incidentId?: string;\n}\n\nexport interface IncidentioListPolicyFindingsOptions extends IncidentioListOptions {\n policyId?: string;\n}\n\nexport class IncidentioApiError extends Error {\n readonly status: number | null;\n\n constructor(message: string, status: number | null) {\n super(message);\n this.name = 'IncidentioApiError';\n this.status = status;\n }\n}\n\nexport interface IncidentioApiClientConfig {\n baseUrl: string;\n accessToken: string;\n /**\n * Mastra project id sent as `x-mastra-project-id` when the base URL is a\n * Mastra Platform connection proxy, so the platform can attribute proxied\n * incident.io activity to the project. When omitted, falls back to the\n * `MASTRA_PROJECT_ID` environment variable; the platform strips the header\n * before forwarding the request upstream. Pass `null` for direct\n * api.incident.io access so the header never reaches incident.io.\n */\n projectId?: string | null;\n fetchImpl?: typeof fetch;\n}\n\ninterface IncidentioPaginationMeta {\n after?: string | null;\n total_record_count?: number;\n}\n\nexport class IncidentioApiClient {\n readonly #baseUrl: string;\n readonly #accessToken: string;\n readonly #projectId: string | null;\n readonly #fetch: typeof fetch;\n\n constructor(config: IncidentioApiClientConfig) {\n const baseUrl = config.baseUrl.trim();\n const accessToken = config.accessToken.trim();\n if (!baseUrl || !accessToken) {\n throw new Error('IncidentioApiClient requires a base URL and access token.');\n }\n this.#baseUrl = baseUrl.replace(/\\/+$/, '');\n this.#accessToken = accessToken;\n this.#projectId =\n config.projectId === null ? null : (config.projectId ?? process.env.MASTRA_PROJECT_ID)?.trim() || null;\n this.#fetch = config.fetchImpl ?? globalThis.fetch;\n }\n\n async listIncidents(cursor?: string): Promise<IncidentioPage<IncidentioIncident>> {\n const result = await this.#request<{\n incidents: IncidentioIncident[];\n pagination_meta?: IncidentioPaginationMeta;\n }>('GET', '/v2/incidents', {\n query: { page_size: 100, after: cursor, sort_by: 'created_at_newest_first' },\n });\n return this.#page(result.incidents, result.pagination_meta);\n }\n\n async getIncident(id: string): Promise<IncidentioIncident> {\n const result = await this.#request<{ incident: IncidentioIncident }>(\n 'GET',\n `/v2/incidents/${encodeURIComponent(id)}`,\n );\n return result.incident;\n }\n\n async listFollowUps(cursor?: string): Promise<IncidentioPage<IncidentioFollowUp>> {\n const result = await this.#request<{\n follow_ups: IncidentioFollowUp[];\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v3/follow_ups', { query: { page_size: 100, after: cursor } });\n return this.#page(result.follow_ups, result.pagination_meta);\n }\n\n async getFollowUp(id: string): Promise<IncidentioFollowUp> {\n const result = await this.#request<{ follow_up: IncidentioFollowUp }>(\n 'GET',\n `/v3/follow_ups/${encodeURIComponent(id)}`,\n );\n return result.follow_up;\n }\n\n async updateFollowUp(\n followUp: IncidentioFollowUp,\n status: IncidentioFollowUp['status'],\n ): Promise<IncidentioFollowUp> {\n const result = await this.#request<{ follow_up: IncidentioFollowUp }>(\n 'PUT',\n `/v3/follow_ups/${encodeURIComponent(followUp.id)}`,\n { body: { title: followUp.title, status } },\n );\n return result.follow_up;\n }\n\n async listActions(options: IncidentioListActionsOptions = {}): Promise<IncidentioPage<IncidentioAction>> {\n const result = await this.#request<{\n actions: IncidentioAction[];\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v3/actions', {\n query: {\n page_size: options.pageSize ?? 100,\n after: options.cursor,\n incident_id: options.incidentId,\n incident_mode: options.incidentMode,\n },\n });\n return this.#page(result.actions, result.pagination_meta);\n }\n\n async getAction(id: string): Promise<IncidentioAction> {\n const result = await this.#request<{ action: IncidentioAction }>('GET', `/v3/actions/${encodeURIComponent(id)}`);\n return result.action;\n }\n\n async listIncidentUpdates(\n options: IncidentioListIncidentUpdatesOptions = {},\n ): Promise<IncidentioPage<IncidentioIncidentUpdate>> {\n const result = await this.#request<{\n incident_updates: IncidentioIncidentUpdate[];\n pagination_meta?: IncidentioPaginationMeta;\n }>('GET', '/v2/incident_updates', {\n query: { page_size: options.pageSize ?? 100, after: options.cursor, incident_id: options.incidentId },\n });\n return this.#page(result.incident_updates, result.pagination_meta);\n }\n\n async listAlerts(options: IncidentioListOptions = {}): Promise<IncidentioPage<IncidentioAlert>> {\n const result = await this.#request<{ alerts: IncidentioAlert[]; pagination_meta: IncidentioPaginationMeta }>(\n 'GET',\n '/v2/alerts',\n { query: { page_size: options.pageSize ?? 50, after: options.cursor } },\n );\n return this.#page(result.alerts, result.pagination_meta);\n }\n\n async getAlert(id: string): Promise<IncidentioAlert> {\n const result = await this.#request<{ alert: IncidentioAlert }>('GET', `/v2/alerts/${encodeURIComponent(id)}`);\n return result.alert;\n }\n\n async listEscalations(options: IncidentioListOptions = {}): Promise<IncidentioPage<IncidentioEscalation>> {\n const result = await this.#request<{\n escalations: IncidentioEscalation[];\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v2/escalations', {\n query: { page_size: options.pageSize ?? 50, after: options.cursor },\n });\n return this.#page(result.escalations, result.pagination_meta);\n }\n\n async getEscalation(id: string): Promise<IncidentioEscalation> {\n const result = await this.#request<{ escalation: IncidentioEscalation }>(\n 'GET',\n `/v2/escalations/${encodeURIComponent(id)}`,\n );\n return result.escalation;\n }\n\n async listCatalogEntries(\n catalogTypeId: string,\n options: IncidentioListOptions & { identifier?: string } = {},\n ): Promise<IncidentioCatalogEntryPage> {\n const result = await this.#request<{\n catalog_entries: IncidentioCatalogEntry[];\n catalog_type: IncidentioCatalogType;\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v3/catalog_entries', {\n query: {\n catalog_type_id: catalogTypeId,\n page_size: options.pageSize ?? 100,\n after: options.cursor,\n identifier: options.identifier,\n },\n });\n return { ...this.#page(result.catalog_entries, result.pagination_meta), catalogType: result.catalog_type };\n }\n\n async getCatalogEntry(id: string, options: { expand?: boolean } = {}): Promise<IncidentioCatalogEntryResult> {\n const result = await this.#request<{\n catalog_entry: IncidentioCatalogEntry;\n catalog_type: IncidentioCatalogType;\n }>('GET', `/v3/catalog_entries/${encodeURIComponent(id)}`, { query: { expand: options.expand } });\n return { entry: result.catalog_entry, catalogType: result.catalog_type };\n }\n\n async listCatalogTypes(): Promise<IncidentioCatalogType[]> {\n const result = await this.#request<{ catalog_types: IncidentioCatalogType[] }>('GET', '/v3/catalog_types');\n return result.catalog_types;\n }\n\n async getCatalogType(id: string): Promise<IncidentioCatalogType> {\n const result = await this.#request<{ catalog_type: IncidentioCatalogType }>(\n 'GET',\n `/v3/catalog_types/${encodeURIComponent(id)}`,\n );\n return result.catalog_type;\n }\n\n async listCatalogResources(): Promise<IncidentioCatalogResource[]> {\n const result = await this.#request<{ resources: IncidentioCatalogResource[] }>('GET', '/v3/catalog_resources');\n return result.resources;\n }\n\n async listTeams(options: IncidentioListOptions = {}): Promise<IncidentioPage<IncidentioTeam>> {\n const result = await this.#request<{ teams: IncidentioTeam[]; pagination_meta: IncidentioPaginationMeta }>(\n 'GET',\n '/v3/teams',\n { query: { page_size: options.pageSize ?? 100, after: options.cursor } },\n );\n return this.#page(result.teams, result.pagination_meta);\n }\n\n async getTeam(id: string): Promise<IncidentioTeam> {\n const result = await this.#request<{ team: IncidentioTeam }>('GET', `/v3/teams/${encodeURIComponent(id)}`);\n return result.team;\n }\n\n async listSchedules(options: IncidentioListOptions = {}): Promise<IncidentioPage<IncidentioSchedule>> {\n const result = await this.#request<{\n schedules: IncidentioSchedule[];\n pagination_meta?: IncidentioPaginationMeta;\n }>('GET', '/v2/schedules', {\n query: { page_size: options.pageSize ?? 25, after: options.cursor },\n });\n return this.#page(result.schedules, result.pagination_meta);\n }\n\n async getSchedule(id: string): Promise<IncidentioSchedule> {\n const result = await this.#request<{ schedule: IncidentioSchedule }>(\n 'GET',\n `/v2/schedules/${encodeURIComponent(id)}`,\n );\n return result.schedule;\n }\n\n async listPolicyFindings(\n options: IncidentioListPolicyFindingsOptions = {},\n ): Promise<IncidentioPage<IncidentioPolicyFinding>> {\n const result = await this.#request<{\n policy_findings: IncidentioPolicyFinding[];\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v2/policy_findings', {\n query: { page_size: options.pageSize ?? 100, after: options.cursor, policy_id: options.policyId },\n });\n return this.#page(result.policy_findings, result.pagination_meta);\n }\n\n async getPolicyFinding(id: string): Promise<IncidentioPolicyFinding> {\n const result = await this.#request<{ policy_finding: IncidentioPolicyFinding }>(\n 'GET',\n `/v2/policy_findings/${encodeURIComponent(id)}`,\n );\n return result.policy_finding;\n }\n\n #page<T>(items: T[], paginationMeta?: IncidentioPaginationMeta): IncidentioPage<T> {\n return {\n items,\n nextCursor: paginationMeta?.after ?? null,\n ...(paginationMeta?.total_record_count === undefined ? {} : { total: paginationMeta.total_record_count }),\n };\n }\n\n async #request<T>(\n method: 'GET' | 'PUT',\n path: string,\n options: { query?: Record<string, string | number | boolean | undefined>; body?: unknown } = {},\n ): Promise<T> {\n const query = new URLSearchParams();\n for (const [key, value] of Object.entries(options.query ?? {})) {\n if (value !== undefined) query.set(key, String(value));\n }\n\n let response: Response;\n try {\n response = await this.#fetch(`${this.#baseUrl}${path}${query.size > 0 ? `?${query.toString()}` : ''}`, {\n method,\n signal: AbortSignal.timeout(15_000),\n headers: {\n accept: 'application/json',\n authorization: `Bearer ${this.#accessToken}`,\n // Project attribution for the Mastra platform proxy; stripped by\n // the platform before the request reaches incident.io.\n ...(this.#projectId ? { 'x-mastra-project-id': this.#projectId } : {}),\n ...(options.body === undefined ? {} : { 'content-type': 'application/json' }),\n },\n ...(options.body === undefined ? {} : { body: JSON.stringify(options.body) }),\n });\n } catch (error) {\n if (error instanceof Error && error.message.includes(this.#accessToken)) {\n const redacted = new Error(error.message.replaceAll(this.#accessToken, '[REDACTED]'));\n redacted.name = error.name;\n throw redacted;\n }\n throw error;\n }\n\n if (!response.ok) {\n let detail = `incident.io API request failed (${response.status})`;\n try {\n const body = (await response.clone().json()) as { message?: string; error?: string; detail?: string };\n detail = body.message ?? body.error ?? body.detail ?? detail;\n } catch {\n // Use the status-based message.\n }\n throw new IncidentioApiError(detail.replaceAll(this.#accessToken, '[REDACTED]'), response.status);\n }\n return (await response.json()) as T;\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"api.js","names":[],"sources":["../../../src/integrations/incidentio/api.ts"],"sourcesContent":["export interface IncidentioUser {\n id: string;\n name: string;\n email?: string;\n role?: string;\n slack_user_id?: string;\n}\n\nexport interface IncidentioActor {\n alert?: { id: string; title: string };\n api_key?: { id: string; name: string };\n user?: IncidentioUser;\n workflow?: { id: string; name: string };\n}\n\nexport interface IncidentioIncident {\n id: string;\n reference: string;\n name: string;\n summary?: string;\n permalink?: string;\n visibility: string;\n mode: string;\n creator: IncidentioActor;\n incident_status: { id: string; name: string; category: string };\n incident_type?: { id: string; name: string };\n severity?: { id: string; name: string; rank: number };\n slack_channel_url?: string;\n postmortem_document_url?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioFollowUp {\n id: string;\n incident_id: string;\n title: string;\n description?: string;\n status: 'outstanding' | 'completed' | 'deleted' | 'not_doing';\n creator: IncidentioActor;\n assignee?: IncidentioUser | null;\n assignee_team?: { id: string; name: string } | null;\n labels: string[];\n priority?: { id: string; name: string; rank: number } | null;\n category?: { id: string; name: string } | null;\n external_issue_reference?: { issue_name: string; issue_permalink: string; provider: string } | null;\n completed_at?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioAction {\n id: string;\n incident_id: string;\n description: string;\n status: 'outstanding' | 'completed' | 'deleted' | 'not_doing';\n creator: IncidentioActor;\n assignee?: IncidentioUser;\n completed_at?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioIncidentUpdate {\n id: string;\n incident_id: string;\n updater: IncidentioActor;\n new_incident_status: { id: string; name: string; category: string };\n message?: string;\n merged_into_incident_id?: string;\n new_severity?: { id: string; name: string; rank: number };\n created_at: string;\n}\n\nexport interface IncidentioAlertAttributeValue {\n catalog_entry?: { id: string; name: string; catalog_type_id?: string };\n label?: string;\n literal?: string;\n}\n\nexport interface IncidentioAlertAttributeEntry {\n attribute: {\n id: string;\n name: string;\n type: string;\n array: boolean;\n required: boolean;\n emoji?: string;\n };\n value?: IncidentioAlertAttributeValue;\n array_value?: IncidentioAlertAttributeValue[];\n}\n\nexport interface IncidentioAlert {\n id: string;\n alert_source_id: string;\n deduplication_key: string;\n status: 'firing' | 'resolved';\n title: string;\n attributes: IncidentioAlertAttributeEntry[];\n alert_group_ids?: string[];\n description?: string;\n resolved_at?: string;\n source_url?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioEscalation {\n id: string;\n status:\n 'pending' | 'triggered' | 'acked' | 'resolved' | 'expired' | 'cancelled' | 'snoozed' | 'delayed' | 'pending_repeat';\n title: string;\n description: string;\n priority: { name: string };\n creator: IncidentioActor;\n escalation_path_id?: string;\n events: Array<{\n id: string;\n event:\n | 'entered_grace_period'\n | 'triggered'\n | 'notified_users'\n | 'notified_channels'\n | 'acked'\n | 'cancelled'\n | 'resolved'\n | 'expired';\n occurred_at: string;\n urgency?: 'high' | 'low';\n users?: IncidentioUser[];\n channels?: Array<{\n microsoft_teams_channel_id?: string;\n microsoft_teams_team_id?: string;\n slack_channel_id?: string;\n slack_team_id?: string;\n }>;\n }>;\n related_incidents: Array<{\n id: string;\n external_id: number;\n name: string;\n reference: string;\n visibility: 'public' | 'private';\n status_category: string;\n summary?: string;\n }>;\n related_alerts: Array<{\n id: string;\n alert_source_id: string;\n deduplication_key: string;\n status: 'firing' | 'resolved';\n title: string;\n alert_group_ids?: string[];\n description?: string;\n resolved_at?: string;\n source_url?: string;\n created_at: string;\n updated_at: string;\n }>;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioCatalogEntry {\n id: string;\n catalog_type_id: string;\n name: string;\n aliases: string[];\n rank: number;\n attribute_values: Record<\n string,\n {\n value?: { label: string; literal?: string };\n array_value?: Array<{ label: string; literal?: string }>;\n }\n >;\n external_id?: string;\n archived_at?: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioCatalogType {\n id: string;\n name: string;\n description: string;\n type_name: string;\n ranked: boolean;\n is_editable: boolean;\n use_name_as_identifier: boolean;\n categories: string[];\n annotations: Record<string, string>;\n color: string;\n icon: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioCatalogResource {\n type: string;\n engine_resource_type: string;\n label: string;\n description: string;\n value_docstring: string;\n category: string;\n}\n\nexport interface IncidentioTeam {\n id: string;\n name: string;\n catalog_entry: { id: string; name: string; external_id?: string };\n members: IncidentioUser[];\n}\n\nexport interface IncidentioSchedule {\n id: string;\n name: string;\n timezone: string;\n team_ids: string[];\n permalink: string;\n annotations: Record<string, string>;\n config?: {\n rotations: Array<{\n id: string;\n name: string;\n users: IncidentioUser[];\n handover_start_at: string;\n scheduling_mode?: 'fair' | 'sequential';\n }>;\n };\n current_shifts?: IncidentioScheduleEntry[];\n next_shifts?: IncidentioScheduleEntry[];\n holidays_public_config?: { country_codes: string[] };\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioScheduleEntry {\n start_at: string;\n end_at: string;\n entry_id?: string;\n fingerprint?: string;\n layer_id?: string;\n rotation_id?: string;\n user?: IncidentioUser;\n}\n\nexport interface IncidentioPolicyFinding {\n id: string;\n policy_id: string;\n policy_type: 'debrief' | 'follow_up' | 'on_call_readiness' | 'post_mortem' | 'schedule' | 'vacation_conflict';\n state: 'pending' | 'active' | 'resolved' | 'cancelled' | 'dismissed';\n responsible_users: IncidentioUser[];\n days?: number;\n due_at?: string;\n debrief?: { incident_id: string };\n dismissal?: { dismissed_at: string; dismissed_by: IncidentioActor; reason: string };\n follow_up?: { incident_id: string; follow_up_id: string };\n on_call_readiness?: {\n user_id: string;\n high_urgency: IncidentioReadinessRule[];\n low_urgency: IncidentioReadinessRule[];\n };\n post_mortem?: { incident_id: string };\n schedule?: {\n schedule_id: string;\n start_at: string;\n end_at: string;\n cause?: 'nobody_scheduled' | 'no_on_call_seat' | 'user_deactivated';\n has_unscheduled_time?: boolean;\n rotation_id?: string;\n };\n vacation_conflict?: {\n user_id: string;\n schedule_id: string;\n start_at: string;\n end_at: string;\n holiday_name?: string;\n rotation_id?: string;\n };\n last_checked_at: string;\n created_at: string;\n updated_at: string;\n}\n\nexport interface IncidentioReadinessRule {\n method_types: string[];\n met: boolean;\n max_delay_seconds?: number;\n}\n\nexport interface IncidentioPage<T> {\n items: T[];\n nextCursor: string | null;\n total?: number;\n}\n\nexport interface IncidentioCatalogEntryPage extends IncidentioPage<IncidentioCatalogEntry> {\n catalogType: IncidentioCatalogType;\n}\n\nexport interface IncidentioCatalogEntryResult {\n entry: IncidentioCatalogEntry;\n catalogType: IncidentioCatalogType;\n}\n\nexport interface IncidentioListOptions {\n cursor?: string;\n pageSize?: number;\n}\n\nexport interface IncidentioListActionsOptions extends IncidentioListOptions {\n incidentId?: string;\n incidentMode?: string;\n}\n\nexport interface IncidentioListIncidentUpdatesOptions extends IncidentioListOptions {\n incidentId?: string;\n}\n\nexport interface IncidentioListPolicyFindingsOptions extends IncidentioListOptions {\n policyId?: string;\n}\n\nexport class IncidentioApiError extends Error {\n readonly status: number | null;\n\n constructor(message: string, status: number | null) {\n super(message);\n this.name = 'IncidentioApiError';\n this.status = status;\n }\n}\n\nexport interface IncidentioApiClientConfig {\n baseUrl: string;\n accessToken: string;\n /**\n * Mastra project id sent as `x-mastra-project-id` when the base URL is a\n * Mastra Platform connection proxy, so the platform can attribute proxied\n * incident.io activity to the project. When omitted, falls back to the\n * `MASTRA_PROJECT_ID` environment variable; the platform strips the header\n * before forwarding the request upstream. Pass `null` for direct\n * api.incident.io access so the header never reaches incident.io.\n */\n projectId?: string | null;\n fetchImpl?: typeof fetch;\n}\n\ninterface IncidentioPaginationMeta {\n after?: string | null;\n total_record_count?: number;\n}\n\nexport class IncidentioApiClient {\n readonly #baseUrl: string;\n readonly #accessToken: string;\n readonly #projectId: string | null;\n readonly #fetch: typeof fetch;\n\n constructor(config: IncidentioApiClientConfig) {\n const baseUrl = config.baseUrl.trim();\n const accessToken = config.accessToken.trim();\n if (!baseUrl || !accessToken) {\n throw new Error('IncidentioApiClient requires a base URL and access token.');\n }\n this.#baseUrl = baseUrl.replace(/\\/+$/, '');\n this.#accessToken = accessToken;\n this.#projectId =\n config.projectId === null ? null : (config.projectId ?? process.env.MASTRA_PROJECT_ID)?.trim() || null;\n this.#fetch = config.fetchImpl ?? globalThis.fetch;\n }\n\n async listIncidents(cursor?: string): Promise<IncidentioPage<IncidentioIncident>> {\n const result = await this.#request<{\n incidents: IncidentioIncident[];\n pagination_meta?: IncidentioPaginationMeta;\n }>('GET', '/v2/incidents', {\n query: { page_size: 100, after: cursor, sort_by: 'created_at_newest_first' },\n });\n return this.#page(result.incidents, result.pagination_meta);\n }\n\n async getIncident(id: string): Promise<IncidentioIncident> {\n const result = await this.#request<{ incident: IncidentioIncident }>(\n 'GET',\n `/v2/incidents/${encodeURIComponent(id)}`,\n );\n return result.incident;\n }\n\n async listFollowUps(cursor?: string): Promise<IncidentioPage<IncidentioFollowUp>> {\n const result = await this.#request<{\n follow_ups: IncidentioFollowUp[];\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v3/follow_ups', { query: { page_size: 100, after: cursor } });\n return this.#page(result.follow_ups, result.pagination_meta);\n }\n\n async getFollowUp(id: string): Promise<IncidentioFollowUp> {\n const result = await this.#request<{ follow_up: IncidentioFollowUp }>(\n 'GET',\n `/v3/follow_ups/${encodeURIComponent(id)}`,\n );\n return result.follow_up;\n }\n\n async updateFollowUp(\n followUp: IncidentioFollowUp,\n status: IncidentioFollowUp['status'],\n ): Promise<IncidentioFollowUp> {\n const result = await this.#request<{ follow_up: IncidentioFollowUp }>(\n 'PUT',\n `/v3/follow_ups/${encodeURIComponent(followUp.id)}`,\n { body: { title: followUp.title, status } },\n );\n return result.follow_up;\n }\n\n async listActions(options: IncidentioListActionsOptions = {}): Promise<IncidentioPage<IncidentioAction>> {\n const result = await this.#request<{\n actions: IncidentioAction[];\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v3/actions', {\n query: {\n page_size: options.pageSize ?? 100,\n after: options.cursor,\n incident_id: options.incidentId,\n incident_mode: options.incidentMode,\n },\n });\n return this.#page(result.actions, result.pagination_meta);\n }\n\n async getAction(id: string): Promise<IncidentioAction> {\n const result = await this.#request<{ action: IncidentioAction }>('GET', `/v3/actions/${encodeURIComponent(id)}`);\n return result.action;\n }\n\n async listIncidentUpdates(\n options: IncidentioListIncidentUpdatesOptions = {},\n ): Promise<IncidentioPage<IncidentioIncidentUpdate>> {\n const result = await this.#request<{\n incident_updates: IncidentioIncidentUpdate[];\n pagination_meta?: IncidentioPaginationMeta;\n }>('GET', '/v2/incident_updates', {\n query: { page_size: options.pageSize ?? 100, after: options.cursor, incident_id: options.incidentId },\n });\n return this.#page(result.incident_updates, result.pagination_meta);\n }\n\n async listAlerts(options: IncidentioListOptions = {}): Promise<IncidentioPage<IncidentioAlert>> {\n const result = await this.#request<{ alerts: IncidentioAlert[]; pagination_meta: IncidentioPaginationMeta }>(\n 'GET',\n '/v2/alerts',\n { query: { page_size: options.pageSize ?? 50, after: options.cursor } },\n );\n return this.#page(result.alerts, result.pagination_meta);\n }\n\n async getAlert(id: string): Promise<IncidentioAlert> {\n const result = await this.#request<{ alert: IncidentioAlert }>('GET', `/v2/alerts/${encodeURIComponent(id)}`);\n return result.alert;\n }\n\n async listEscalations(options: IncidentioListOptions = {}): Promise<IncidentioPage<IncidentioEscalation>> {\n const result = await this.#request<{\n escalations: IncidentioEscalation[];\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v2/escalations', {\n query: { page_size: options.pageSize ?? 50, after: options.cursor },\n });\n return this.#page(result.escalations, result.pagination_meta);\n }\n\n async getEscalation(id: string): Promise<IncidentioEscalation> {\n const result = await this.#request<{ escalation: IncidentioEscalation }>(\n 'GET',\n `/v2/escalations/${encodeURIComponent(id)}`,\n );\n return result.escalation;\n }\n\n async listCatalogEntries(\n catalogTypeId: string,\n options: IncidentioListOptions & { identifier?: string } = {},\n ): Promise<IncidentioCatalogEntryPage> {\n const result = await this.#request<{\n catalog_entries: IncidentioCatalogEntry[];\n catalog_type: IncidentioCatalogType;\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v3/catalog_entries', {\n query: {\n catalog_type_id: catalogTypeId,\n page_size: options.pageSize ?? 100,\n after: options.cursor,\n identifier: options.identifier,\n },\n });\n return { ...this.#page(result.catalog_entries, result.pagination_meta), catalogType: result.catalog_type };\n }\n\n async getCatalogEntry(id: string, options: { expand?: boolean } = {}): Promise<IncidentioCatalogEntryResult> {\n const result = await this.#request<{\n catalog_entry: IncidentioCatalogEntry;\n catalog_type: IncidentioCatalogType;\n }>('GET', `/v3/catalog_entries/${encodeURIComponent(id)}`, { query: { expand: options.expand } });\n return { entry: result.catalog_entry, catalogType: result.catalog_type };\n }\n\n async listCatalogTypes(): Promise<IncidentioCatalogType[]> {\n const result = await this.#request<{ catalog_types: IncidentioCatalogType[] }>('GET', '/v3/catalog_types');\n return result.catalog_types;\n }\n\n async getCatalogType(id: string): Promise<IncidentioCatalogType> {\n const result = await this.#request<{ catalog_type: IncidentioCatalogType }>(\n 'GET',\n `/v3/catalog_types/${encodeURIComponent(id)}`,\n );\n return result.catalog_type;\n }\n\n async listCatalogResources(): Promise<IncidentioCatalogResource[]> {\n const result = await this.#request<{ resources: IncidentioCatalogResource[] }>('GET', '/v3/catalog_resources');\n return result.resources;\n }\n\n async listTeams(options: IncidentioListOptions = {}): Promise<IncidentioPage<IncidentioTeam>> {\n const result = await this.#request<{ teams: IncidentioTeam[]; pagination_meta: IncidentioPaginationMeta }>(\n 'GET',\n '/v3/teams',\n { query: { page_size: options.pageSize ?? 100, after: options.cursor } },\n );\n return this.#page(result.teams, result.pagination_meta);\n }\n\n async getTeam(id: string): Promise<IncidentioTeam> {\n const result = await this.#request<{ team: IncidentioTeam }>('GET', `/v3/teams/${encodeURIComponent(id)}`);\n return result.team;\n }\n\n async listSchedules(options: IncidentioListOptions = {}): Promise<IncidentioPage<IncidentioSchedule>> {\n const result = await this.#request<{\n schedules: IncidentioSchedule[];\n pagination_meta?: IncidentioPaginationMeta;\n }>('GET', '/v2/schedules', {\n query: { page_size: options.pageSize ?? 25, after: options.cursor },\n });\n return this.#page(result.schedules, result.pagination_meta);\n }\n\n async getSchedule(id: string): Promise<IncidentioSchedule> {\n const result = await this.#request<{ schedule: IncidentioSchedule }>(\n 'GET',\n `/v2/schedules/${encodeURIComponent(id)}`,\n );\n return result.schedule;\n }\n\n async listPolicyFindings(\n options: IncidentioListPolicyFindingsOptions = {},\n ): Promise<IncidentioPage<IncidentioPolicyFinding>> {\n const result = await this.#request<{\n policy_findings: IncidentioPolicyFinding[];\n pagination_meta: IncidentioPaginationMeta;\n }>('GET', '/v2/policy_findings', {\n query: { page_size: options.pageSize ?? 100, after: options.cursor, policy_id: options.policyId },\n });\n return this.#page(result.policy_findings, result.pagination_meta);\n }\n\n async getPolicyFinding(id: string): Promise<IncidentioPolicyFinding> {\n const result = await this.#request<{ policy_finding: IncidentioPolicyFinding }>(\n 'GET',\n `/v2/policy_findings/${encodeURIComponent(id)}`,\n );\n return result.policy_finding;\n }\n\n #page<T>(items: T[], paginationMeta?: IncidentioPaginationMeta): IncidentioPage<T> {\n return {\n items,\n nextCursor: paginationMeta?.after ?? null,\n ...(paginationMeta?.total_record_count === undefined ? {} : { total: paginationMeta.total_record_count }),\n };\n }\n\n async #request<T>(\n method: 'GET' | 'PUT',\n path: string,\n options: { query?: Record<string, string | number | boolean | undefined>; body?: unknown } = {},\n ): Promise<T> {\n const query = new URLSearchParams();\n for (const [key, value] of Object.entries(options.query ?? {})) {\n if (value !== undefined) query.set(key, String(value));\n }\n\n let response: Response;\n try {\n response = await this.#fetch(`${this.#baseUrl}${path}${query.size > 0 ? `?${query.toString()}` : ''}`, {\n method,\n signal: AbortSignal.timeout(15_000),\n headers: {\n accept: 'application/json',\n authorization: `Bearer ${this.#accessToken}`,\n // Project attribution for the Mastra platform proxy; stripped by\n // the platform before the request reaches incident.io.\n ...(this.#projectId ? { 'x-mastra-project-id': this.#projectId } : {}),\n ...(options.body === undefined ? {} : { 'content-type': 'application/json' }),\n },\n ...(options.body === undefined ? {} : { body: JSON.stringify(options.body) }),\n });\n } catch (error) {\n if (error instanceof Error && error.message.includes(this.#accessToken)) {\n const redacted = new Error(error.message.replaceAll(this.#accessToken, '[REDACTED]'));\n redacted.name = error.name;\n throw redacted;\n }\n throw error;\n }\n\n if (!response.ok) {\n let detail = `incident.io API request failed (${response.status})`;\n try {\n const body = (await response.clone().json()) as { message?: string; error?: string; detail?: string };\n detail = body.message ?? body.error ?? body.detail ?? detail;\n } catch {\n // Use the status-based message.\n }\n throw new IncidentioApiError(detail.replaceAll(this.#accessToken, '[REDACTED]'), response.status);\n }\n return (await response.json()) as T;\n }\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"integration.js","names":[
|
|
1
|
+
{"version":3,"file":"integration.js","names":[],"sources":["../../../src/integrations/incidentio/integration.ts"],"sourcesContent":["import type { RequestContext } from '@mastra/core/request-context';\nimport type { ApiRoute } from '@mastra/core/server';\nimport type { MastraWorker } from '@mastra/core/worker';\n\nimport type { RouteAuth } from '../../routes/route.js';\nimport type { IntakeStorage } from '../../storage/domains/intake/base.js';\nimport type { FactoryProjectsStorage } from '../../storage/domains/projects/base.js';\nimport type { FactoryIntegration, IntegrationContext, IntegrationTools } from '../base.js';\nimport { IssueReconcileWorker } from '../issue-reconcile-worker.js';\nimport { buildIncidentioAgentTools } from './agent-tools.js';\nimport { IncidentioApiClient } from './api.js';\nimport { resolveIncidentioRules } from './default-rules.js';\nimport type { IncidentioEventRules, IncidentioRuleOverrides } from './default-rules.js';\nimport { createIncidentioIntake } from './intake.js';\nimport { attachIncidentioIssueReconciler } from './issue-reconciler.js';\nimport { incidentioReconciliationEnabled, incidentioReconciliationInterval } from './reconciliation-config.js';\nimport { buildIncidentioRoutes } from './routes.js';\nimport { attachIncidentioRules } from './rules.js';\n\nexport interface IncidentioIntegrationConfig {\n apiKey?: string;\n fetchImpl?: typeof fetch;\n baseUrl?: string;\n /** Per-event replacements for the default Factory incident.io rules. */\n rules?: IncidentioRuleOverrides;\n}\n\nconst DIRECT_CONNECTION_TOKEN = 'incidentio-direct-api-key';\nconst UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nexport class IncidentioIntegration implements FactoryIntegration {\n readonly id = 'incidentio';\n readonly intake;\n readonly #endpointHost: string;\n readonly #rules: IncidentioEventRules;\n\n /** Bound once by the factory via `initialize()` before any surface is used. */\n #projects: FactoryProjectsStorage | undefined;\n #auth: RouteAuth | undefined;\n #intakeStorage: IntakeStorage | undefined;\n readonly #orgIdByResourceId = new Map<string, string | null>();\n\n constructor(config: IncidentioIntegrationConfig = {}) {\n this.#rules = resolveIncidentioRules(config.rules);\n const apiKey = config.apiKey?.trim() || process.env.INCIDENT_IO_API_KEY?.trim();\n if (!apiKey) {\n throw new Error('IncidentioIntegration: missing required INCIDENT_IO_API_KEY.');\n }\n const baseUrl = config.baseUrl ?? 'https://api.incident.io';\n this.#endpointHost = new URL(baseUrl).host;\n const api = new IncidentioApiClient({\n baseUrl,\n accessToken: apiKey,\n // Direct incident.io access: never leak the Mastra project id header\n // to incident.io itself.\n projectId: null,\n ...(config.fetchImpl ? { fetchImpl: config.fetchImpl } : {}),\n });\n this.intake = createIncidentioIntake({\n api,\n connection: { type: 'oauth', accessToken: DIRECT_CONNECTION_TOKEN },\n });\n }\n\n /** Event rules driving automatic follow-up materialization and close handling. */\n get rules(): IncidentioEventRules {\n return this.#rules;\n }\n\n /**\n * Bind the projects domain and the host auth seam. incident.io has no\n * per-org connection rows here — credentials are deployment-global\n * constructor config.\n */\n initialize({\n projects,\n auth,\n intake,\n }: {\n projects: FactoryProjectsStorage;\n auth: RouteAuth;\n intake: IntakeStorage;\n }): void {\n this.#projects = projects;\n this.#auth = auth;\n this.#intakeStorage = intake;\n }\n\n /** Cross-integration intake selection/binding domain — agent-tool authorization. */\n get intakeStorage(): IntakeStorage {\n if (!this.#intakeStorage) {\n throw new Error('IncidentioIntegration is not initialized — the factory binds storage during prepare().');\n }\n return this.#intakeStorage;\n }\n\n /** Factory projects domain — maps a session's resourceId to its owning org. */\n get projects(): FactoryProjectsStorage {\n if (!this.#projects) {\n throw new Error('IncidentioIntegration is not initialized — the factory binds storage during prepare().');\n }\n return this.#projects;\n }\n\n /** Whether the host runs with web auth enabled; every surface is inert without it. */\n get authEnabled(): boolean {\n return this.#auth?.enabled() ?? false;\n }\n\n /**\n * Map a session's resourceId (the factory project id) to its owning org.\n * Same caching semantics as the Jira integration: definitive misses are\n * cached, transient database failures are not.\n */\n async resolveOrgId(resourceId: string): Promise<string | null> {\n const cached = this.#orgIdByResourceId.get(resourceId);\n if (cached !== undefined) return cached;\n if (!UUID_PATTERN.test(resourceId)) {\n this.#orgIdByResourceId.set(resourceId, null);\n return null;\n }\n let orgId: string | null;\n try {\n await this.projects.ensureReady();\n const project = await this.projects.getById({ id: resourceId });\n orgId = project?.orgId ?? null;\n } catch {\n // Transient database failure: skip the tools for this request but don't\n // cache the miss, so the next request retries the lookup.\n return null;\n }\n this.#orgIdByResourceId.set(resourceId, orgId);\n return orgId;\n }\n\n /** Test hook: clear the org cache between specs. */\n clearCaches(): void {\n this.#orgIdByResourceId.clear();\n }\n\n /**\n * Org-scoped agent tools: the read-only follow-up detail tool for sessions\n * whose resource is a factory project, matching the Linear/Jira surface.\n */\n async agentTools(args: { requestContext: RequestContext }): Promise<IntegrationTools> {\n return buildIncidentioAgentTools({ requestContext: args.requestContext, incidentio: this });\n }\n\n workers(ctx: IntegrationContext): MastraWorker[] {\n if (!incidentioReconciliationEnabled()) return [];\n const reconcile = attachIncidentioIssueReconciler(this, ctx);\n if (!reconcile) return [];\n const intervalMs = incidentioReconciliationInterval();\n return [\n new IssueReconcileWorker({\n integrationId: this.id,\n reconcile,\n ...(intervalMs ? { intervalMs } : {}),\n }),\n ];\n }\n\n /**\n * The integration's HTTP surface: `/web/incidentio/*` Mastra `apiRoutes`\n * (status + follow-up listing/detail for Intake). Handlers operate on this\n * instance; a board-scoped listing also feeds the incident.io event rules.\n */\n routes(ctx: IntegrationContext): ApiRoute[] {\n return buildIncidentioRoutes({\n incidentio: this,\n mode: 'api-key',\n auth: ctx.auth,\n intake: ctx.storage.intake,\n ingestFactoryIssues: attachIncidentioRules(this, ctx),\n });\n }\n\n diagnostics(): Record<string, unknown> {\n return { mode: 'api-key', endpointHost: this.#endpointHost };\n }\n}\n"],"mappings":";;;;;;;;;;AA2BA,MAAM,0BAA0B;AAChC,MAAM,eAAe;AAErB,IAAa,wBAAb,MAAiE;CAC/D,KAAc;CACd;CACA;CACA;;CAGA;CACA;CACA;CACA,qCAA8B,IAAI,IAA2B;CAE7D,YAAY,SAAsC,CAAC,GAAG;EACpD,KAAK,SAAS,uBAAuB,OAAO,KAAK;EACjD,MAAM,SAAS,OAAO,QAAQ,KAAK,KAAK,QAAQ,IAAI,qBAAqB,KAAK;EAC9E,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,8DAA8D;EAEhF,MAAM,UAAU,OAAO,WAAW;EAClC,KAAK,gBAAgB,IAAI,IAAI,OAAO,CAAC,CAAC;EACtC,MAAM,MAAM,IAAI,oBAAoB;GAClC;GACA,aAAa;GAGb,WAAW;GACX,GAAI,OAAO,YAAY,EAAE,WAAW,OAAO,UAAU,IAAI,CAAC;EAC5D,CAAC;EACD,KAAK,SAAS,uBAAuB;GACnC;GACA,YAAY;IAAE,MAAM;IAAS,aAAa;GAAwB;EACpE,CAAC;CACH;;CAGA,IAAI,QAA8B;EAChC,OAAO,KAAK;CACd;;;;;;CAOA,WAAW,EACT,UACA,MACA,UAKO;EACP,KAAK,YAAY;EACjB,KAAK,QAAQ;EACb,KAAK,iBAAiB;CACxB;;CAGA,IAAI,gBAA+B;EACjC,IAAI,CAAC,KAAK,gBACR,MAAM,IAAI,MAAM,wFAAwF;EAE1G,OAAO,KAAK;CACd;;CAGA,IAAI,WAAmC;EACrC,IAAI,CAAC,KAAK,WACR,MAAM,IAAI,MAAM,wFAAwF;EAE1G,OAAO,KAAK;CACd;;CAGA,IAAI,cAAuB;EACzB,OAAO,KAAK,OAAO,QAAQ,KAAK;CAClC;;;;;;CAOA,MAAM,aAAa,YAA4C;EAC7D,MAAM,SAAS,KAAK,mBAAmB,IAAI,UAAU;EACrD,IAAI,WAAW,KAAA,GAAW,OAAO;EACjC,IAAI,CAAC,aAAa,KAAK,UAAU,GAAG;GAClC,KAAK,mBAAmB,IAAI,YAAY,IAAI;GAC5C,OAAO;EACT;EACA,IAAI;EACJ,IAAI;GACF,MAAM,KAAK,SAAS,YAAY;GAEhC,SAAQ,MADc,KAAK,SAAS,QAAQ,EAAE,IAAI,WAAW,CAAC,EAAA,EAC7C,SAAS;EAC5B,QAAQ;GAGN,OAAO;EACT;EACA,KAAK,mBAAmB,IAAI,YAAY,KAAK;EAC7C,OAAO;CACT;;CAGA,cAAoB;EAClB,KAAK,mBAAmB,MAAM;CAChC;;;;;CAMA,MAAM,WAAW,MAAqE;EACpF,OAAO,0BAA0B;GAAE,gBAAgB,KAAK;GAAgB,YAAY;EAAK,CAAC;CAC5F;CAEA,QAAQ,KAAyC;EAC/C,IAAI,CAAC,gCAAgC,GAAG,OAAO,CAAC;EAChD,MAAM,YAAY,gCAAgC,MAAM,GAAG;EAC3D,IAAI,CAAC,WAAW,OAAO,CAAC;EACxB,MAAM,aAAa,iCAAiC;EACpD,OAAO,CACL,IAAI,qBAAqB;GACvB,eAAe,KAAK;GACpB;GACA,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;EACrC,CAAC,CACH;CACF;;;;;;CAOA,OAAO,KAAqC;EAC1C,OAAO,sBAAsB;GAC3B,YAAY;GACZ,MAAM;GACN,MAAM,IAAI;GACV,QAAQ,IAAI,QAAQ;GACpB,qBAAqB,sBAAsB,MAAM,GAAG;EACtD,CAAC;CACH;CAEA,cAAuC;EACrC,OAAO;GAAE,MAAM;GAAW,cAAc,KAAK;EAAc;CAC7D;AACF"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rules.js","names":["#heldElsewhere","#ingestIssue"],"sources":["../../../src/integrations/incidentio/rules.ts"],"sourcesContent":["import {\n boardEventHandlers,\n boardForWorkItem,\n eventBoardId,\n isTerminalWorkItem,\n rulePhaseField,\n withBoardClosure,\n} from '../../boards/index.js';\nimport type { BoardRegistry } from '../../boards/index.js';\nimport { selectEventRule } from '../../rules/event-rules.js';\nimport type { FactoryIncidentioRuleContext, FactoryRuleDecision } from '../../rules/types.js';\nimport { assertFactoryDecisionTarget, validateFactoryRuleDecisions } from '../../rules/validation.js';\nimport type { FactoryProjectsStorage } from '../../storage/domains/projects/base.js';\nimport type { WorkItemRow, WorkItemsStorage } from '../../storage/domains/work-items/base.js';\nimport type { IntegrationContext } from '../base.js';\nimport { incidentioClaimKey } from './claim.js';\nimport type { IncidentioEventRules } from './default-rules.js';\n\nconst RULE_TIMEOUT_MS = 5_000;\n\nasync function withRuleTimeout<T>(promise: Promise<T>): Promise<T> {\n let timeout: ReturnType<typeof setTimeout> | undefined;\n try {\n return await Promise.race([\n promise,\n new Promise<never>((_, reject) => {\n timeout = setTimeout(() => reject(new Error('FACTORY_RULE_TIMEOUT')), RULE_TIMEOUT_MS);\n }),\n ]);\n } finally {\n if (timeout) clearTimeout(timeout);\n }\n}\n\nconst MAX_STALE_RULE_ATTEMPTS = 3;\n\nexport interface IncidentioIssueIngress {\n /** Stable item reference — the prefixed incident.io follow-up id (`incidentio:follow-up:<ulid>`). */\n id: string;\n identifier: string;\n title: string;\n url: string;\n state: string;\n stateType: string;\n priorityLabel: string;\n assignee: string | null;\n /** Display name of the follow-up creator, when available. */\n author: string | null;\n /** Reference of the incident this follow-up belongs to, when available. */\n incident: string | null;\n labels: string[];\n createdAt: string;\n updatedAt: string;\n /** incident.io source the follow-up was read from; resolves the bound board via `intakeBoards`. */\n sourceId?: string | null;\n}\n\nexport interface IncidentioRulesOptions {\n projects: Pick<FactoryProjectsStorage, 'get'>;\n storage: WorkItemsStorage;\n configVersion: string;\n boards: BoardRegistry;\n incidentioRules: IncidentioEventRules;\n}\n\nexport interface IncidentioRulesIngress {\n orgId: string;\n userId: string;\n factoryProjectId: string;\n issues: IncidentioIssueIngress[];\n /** Board id per bound incident.io source id, from the project's intake bindings. */\n intakeBoards?: Readonly<Record<string, string>>;\n}\n\ntype IngressStatus = 'committed' | 'replayed' | 'missing';\n\nexport class IncidentioRules {\n constructor(private readonly options: IncidentioRulesOptions) {}\n\n async ingest(input: IncidentioRulesIngress): Promise<{ status: IngressStatus; ingested: number }> {\n const project = await this.options.projects.get({ orgId: input.orgId, id: input.factoryProjectId });\n if (!project) return { status: 'missing', ingested: 0 };\n\n const items = await this.options.storage.list({ orgId: input.orgId, factoryProjectId: input.factoryProjectId });\n const itemsBySourceKey = new Map(items.map(item => [item.externalSource?.externalId, item]));\n const itemsByClaimKey = new Map(items.filter(item => item.claimKey).map(item => [item.claimKey, item]));\n const statuses: IngressStatus[] = [];\n for (const issue of input.issues) {\n // The claim finds the card even after a metadata drift; the raw item\n // reference covers cards filed before claims existed.\n const relatedItem = itemsByClaimKey.get(incidentioClaimKey(issue.id)) ?? itemsBySourceKey.get(issue.id);\n // One live card per follow-up per org. The store's claim index is the\n // guarantee; this check spares the dispatcher a refused upsert.\n if (!relatedItem && (await this.#heldElsewhere(input, issue))) {\n statuses.push('missing');\n continue;\n }\n statuses.push(await this.#ingestIssue(input, issue, relatedItem));\n }\n if (statuses.some(status => status === 'committed')) return { status: 'committed', ingested: statuses.length };\n if (statuses.some(status => status === 'replayed')) return { status: 'replayed', ingested: statuses.length };\n return { status: 'missing', ingested: statuses.length };\n }\n\n async #heldElsewhere(input: IncidentioRulesIngress, issue: IncidentioIssueIngress): Promise<boolean> {\n const heldLive = (row: WorkItemRow) =>\n row.factoryProjectId !== input.factoryProjectId && !isTerminalWorkItem(this.options.boards, row);\n const claimant = await this.options.storage.getByClaimKey({\n orgId: input.orgId,\n claimKey: incidentioClaimKey(issue.id),\n });\n if (claimant && heldLive(claimant)) return true;\n // Cards filed before claims existed carry only the item reference.\n const legacy = await this.options.storage.listBySource({\n orgId: input.orgId,\n source: { integrationId: 'incidentio', type: 'issue', externalId: issue.id },\n });\n return legacy.some(heldLive);\n }\n\n async #ingestIssue(\n input: IncidentioRulesIngress,\n issue: IncidentioIssueIngress,\n relatedItem: WorkItemRow | undefined,\n attempt = 1,\n ): Promise<IngressStatus> {\n const ingressId = `incidentio:${issue.id}:${issue.updatedAt}`;\n const actor = { type: 'human' as const, id: input.userId };\n\n // Closed follow-ups without existing work items should not create new ones.\n const isClosed = issue.stateType === 'completed' || issue.stateType === 'canceled';\n if (isClosed && !relatedItem) {\n return 'missing';\n }\n\n const event = isClosed ? 'followUpClosed' : 'followUpObserved';\n const boundBoardId = issue.sourceId ? input.intakeBoards?.[issue.sourceId] : undefined;\n const boundBoard = boundBoardId ? this.options.boards.get(boundBoardId) : undefined;\n const context: FactoryIncidentioRuleContext = {\n tenant: { orgId: input.orgId, projectId: input.factoryProjectId },\n actor,\n ingress: { type: 'incidentio', id: ingressId },\n cause: `incidentio.${event}`,\n causalChain: [],\n configVersion: this.options.configVersion,\n ...(relatedItem\n ? {\n item: {\n id: relatedItem.id,\n source: 'incidentio-follow-up',\n sourceKey: relatedItem.externalSource?.externalId ?? null,\n parentWorkItemId: relatedItem.parentWorkItemId,\n title: relatedItem.title,\n url: relatedItem.externalSource?.url ?? null,\n stages: relatedItem.stages,\n acceptedAt: relatedItem.acceptedAt,\n metadata: relatedItem.metadata,\n },\n board: boardForWorkItem(relatedItem),\n itemRevision: relatedItem.revision,\n ...withBoardClosure(this.options.boards, relatedItem),\n ...rulePhaseField(this.options.boards, relatedItem),\n }\n : {}),\n ...(boundBoard ? { intake: { board: boundBoard.id, initialPhase: boundBoard.initialPhase } } : {}),\n event,\n issue,\n };\n\n const rule = selectEventRule(\n this.options.incidentioRules,\n boardEventHandlers(this.options.boards, eventBoardId(context), 'incidentio'),\n context.event,\n );\n let decision: FactoryRuleDecision | void;\n let decisions: Record<string, unknown>[] = [];\n let outcome: { status: 'accepted' | 'rejected'; code?: string; reason?: string } = { status: 'accepted' };\n try {\n decision = rule ? await withRuleTimeout(Promise.resolve(rule(Object.freeze(context)))) : undefined;\n if (decision?.type === 'reject') {\n outcome = { status: 'rejected', code: decision.code, reason: decision.reason };\n } else if (decision) {\n decisions = validateFactoryRuleDecisions([decision]).map(entry => {\n assertFactoryDecisionTarget(\n entry,\n this.options.boards,\n relatedItem ? boardForWorkItem(relatedItem) : undefined,\n );\n return { ...entry };\n });\n }\n } catch (error) {\n const timedOut = error instanceof Error && error.message === 'FACTORY_RULE_TIMEOUT';\n outcome = {\n status: 'rejected',\n code: timedOut ? 'timeout' : 'rule_error',\n reason: timedOut\n ? 'Factory rule evaluation timed out.'\n : error instanceof Error\n ? error.message.slice(0, 2_000)\n : 'Factory incident.io rule failed.',\n };\n }\n\n const committed = await this.options.storage.commitRuleEvaluation({\n orgId: input.orgId,\n factoryProjectId: input.factoryProjectId,\n workItemId: relatedItem?.id ?? null,\n ingress: { identity: ingressId, triggerType: `incidentio.${event}` },\n configVersion: this.options.configVersion,\n expectedRevision: relatedItem?.revision ?? null,\n actor,\n outcome,\n decisions,\n causalChain: [],\n now: new Date(),\n });\n if (committed.status === 'stale') {\n // Nothing was persisted: re-read the item and evaluate again at its fresh revision.\n if (attempt >= MAX_STALE_RULE_ATTEMPTS) {\n throw new Error(`Factory incident.io rule evaluation for ${ingressId} kept losing revision races.`);\n }\n const fresh = relatedItem ? await this.options.storage.get({ orgId: input.orgId, id: relatedItem.id }) : null;\n if (relatedItem && !fresh) return 'missing';\n return this.#ingestIssue(input, issue, fresh ?? undefined, attempt + 1);\n }\n return committed.status;\n }\n}\n\nexport function attachIncidentioRules(\n incidentio: { readonly rules: IncidentioEventRules },\n context: IntegrationContext,\n): ((input: IncidentioRulesIngress) => Promise<unknown>) | undefined {\n if (!context.runtime) return undefined;\n const rules = new IncidentioRules({\n projects: context.storage.projects,\n storage: context.runtime.workItems,\n configVersion: context.runtime.configVersion,\n boards: context.runtime.boards,\n incidentioRules: incidentio.rules,\n });\n return input => rules.ingest(input);\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"rules.js","names":[],"sources":["../../../src/integrations/incidentio/rules.ts"],"sourcesContent":["import {\n boardEventHandlers,\n boardForWorkItem,\n eventBoardId,\n isTerminalWorkItem,\n rulePhaseField,\n withBoardClosure,\n} from '../../boards/index.js';\nimport type { BoardRegistry } from '../../boards/index.js';\nimport { selectEventRule } from '../../rules/event-rules.js';\nimport type { FactoryIncidentioRuleContext, FactoryRuleDecision } from '../../rules/types.js';\nimport { assertFactoryDecisionTarget, validateFactoryRuleDecisions } from '../../rules/validation.js';\nimport type { FactoryProjectsStorage } from '../../storage/domains/projects/base.js';\nimport type { WorkItemRow, WorkItemsStorage } from '../../storage/domains/work-items/base.js';\nimport type { IntegrationContext } from '../base.js';\nimport { incidentioClaimKey } from './claim.js';\nimport type { IncidentioEventRules } from './default-rules.js';\n\nconst RULE_TIMEOUT_MS = 5_000;\n\nasync function withRuleTimeout<T>(promise: Promise<T>): Promise<T> {\n let timeout: ReturnType<typeof setTimeout> | undefined;\n try {\n return await Promise.race([\n promise,\n new Promise<never>((_, reject) => {\n timeout = setTimeout(() => reject(new Error('FACTORY_RULE_TIMEOUT')), RULE_TIMEOUT_MS);\n }),\n ]);\n } finally {\n if (timeout) clearTimeout(timeout);\n }\n}\n\nconst MAX_STALE_RULE_ATTEMPTS = 3;\n\nexport interface IncidentioIssueIngress {\n /** Stable item reference — the prefixed incident.io follow-up id (`incidentio:follow-up:<ulid>`). */\n id: string;\n identifier: string;\n title: string;\n url: string;\n state: string;\n stateType: string;\n priorityLabel: string;\n assignee: string | null;\n /** Display name of the follow-up creator, when available. */\n author: string | null;\n /** Reference of the incident this follow-up belongs to, when available. */\n incident: string | null;\n labels: string[];\n createdAt: string;\n updatedAt: string;\n /** incident.io source the follow-up was read from; resolves the bound board via `intakeBoards`. */\n sourceId?: string | null;\n}\n\nexport interface IncidentioRulesOptions {\n projects: Pick<FactoryProjectsStorage, 'get'>;\n storage: WorkItemsStorage;\n configVersion: string;\n boards: BoardRegistry;\n incidentioRules: IncidentioEventRules;\n}\n\nexport interface IncidentioRulesIngress {\n orgId: string;\n userId: string;\n factoryProjectId: string;\n issues: IncidentioIssueIngress[];\n /** Board id per bound incident.io source id, from the project's intake bindings. */\n intakeBoards?: Readonly<Record<string, string>>;\n}\n\ntype IngressStatus = 'committed' | 'replayed' | 'missing';\n\nexport class IncidentioRules {\n constructor(private readonly options: IncidentioRulesOptions) {}\n\n async ingest(input: IncidentioRulesIngress): Promise<{ status: IngressStatus; ingested: number }> {\n const project = await this.options.projects.get({ orgId: input.orgId, id: input.factoryProjectId });\n if (!project) return { status: 'missing', ingested: 0 };\n\n const items = await this.options.storage.list({ orgId: input.orgId, factoryProjectId: input.factoryProjectId });\n const itemsBySourceKey = new Map(items.map(item => [item.externalSource?.externalId, item]));\n const itemsByClaimKey = new Map(items.filter(item => item.claimKey).map(item => [item.claimKey, item]));\n const statuses: IngressStatus[] = [];\n for (const issue of input.issues) {\n // The claim finds the card even after a metadata drift; the raw item\n // reference covers cards filed before claims existed.\n const relatedItem = itemsByClaimKey.get(incidentioClaimKey(issue.id)) ?? itemsBySourceKey.get(issue.id);\n // One live card per follow-up per org. The store's claim index is the\n // guarantee; this check spares the dispatcher a refused upsert.\n if (!relatedItem && (await this.#heldElsewhere(input, issue))) {\n statuses.push('missing');\n continue;\n }\n statuses.push(await this.#ingestIssue(input, issue, relatedItem));\n }\n if (statuses.some(status => status === 'committed')) return { status: 'committed', ingested: statuses.length };\n if (statuses.some(status => status === 'replayed')) return { status: 'replayed', ingested: statuses.length };\n return { status: 'missing', ingested: statuses.length };\n }\n\n async #heldElsewhere(input: IncidentioRulesIngress, issue: IncidentioIssueIngress): Promise<boolean> {\n const heldLive = (row: WorkItemRow) =>\n row.factoryProjectId !== input.factoryProjectId && !isTerminalWorkItem(this.options.boards, row);\n const claimant = await this.options.storage.getByClaimKey({\n orgId: input.orgId,\n claimKey: incidentioClaimKey(issue.id),\n });\n if (claimant && heldLive(claimant)) return true;\n // Cards filed before claims existed carry only the item reference.\n const legacy = await this.options.storage.listBySource({\n orgId: input.orgId,\n source: { integrationId: 'incidentio', type: 'issue', externalId: issue.id },\n });\n return legacy.some(heldLive);\n }\n\n async #ingestIssue(\n input: IncidentioRulesIngress,\n issue: IncidentioIssueIngress,\n relatedItem: WorkItemRow | undefined,\n attempt = 1,\n ): Promise<IngressStatus> {\n const ingressId = `incidentio:${issue.id}:${issue.updatedAt}`;\n const actor = { type: 'human' as const, id: input.userId };\n\n // Closed follow-ups without existing work items should not create new ones.\n const isClosed = issue.stateType === 'completed' || issue.stateType === 'canceled';\n if (isClosed && !relatedItem) {\n return 'missing';\n }\n\n const event = isClosed ? 'followUpClosed' : 'followUpObserved';\n const boundBoardId = issue.sourceId ? input.intakeBoards?.[issue.sourceId] : undefined;\n const boundBoard = boundBoardId ? this.options.boards.get(boundBoardId) : undefined;\n const context: FactoryIncidentioRuleContext = {\n tenant: { orgId: input.orgId, projectId: input.factoryProjectId },\n actor,\n ingress: { type: 'incidentio', id: ingressId },\n cause: `incidentio.${event}`,\n causalChain: [],\n configVersion: this.options.configVersion,\n ...(relatedItem\n ? {\n item: {\n id: relatedItem.id,\n source: 'incidentio-follow-up',\n sourceKey: relatedItem.externalSource?.externalId ?? null,\n parentWorkItemId: relatedItem.parentWorkItemId,\n title: relatedItem.title,\n url: relatedItem.externalSource?.url ?? null,\n stages: relatedItem.stages,\n acceptedAt: relatedItem.acceptedAt,\n metadata: relatedItem.metadata,\n },\n board: boardForWorkItem(relatedItem),\n itemRevision: relatedItem.revision,\n ...withBoardClosure(this.options.boards, relatedItem),\n ...rulePhaseField(this.options.boards, relatedItem),\n }\n : {}),\n ...(boundBoard ? { intake: { board: boundBoard.id, initialPhase: boundBoard.initialPhase } } : {}),\n event,\n issue,\n };\n\n const rule = selectEventRule(\n this.options.incidentioRules,\n boardEventHandlers(this.options.boards, eventBoardId(context), 'incidentio'),\n context.event,\n );\n let decision: FactoryRuleDecision | void;\n let decisions: Record<string, unknown>[] = [];\n let outcome: { status: 'accepted' | 'rejected'; code?: string; reason?: string } = { status: 'accepted' };\n try {\n decision = rule ? await withRuleTimeout(Promise.resolve(rule(Object.freeze(context)))) : undefined;\n if (decision?.type === 'reject') {\n outcome = { status: 'rejected', code: decision.code, reason: decision.reason };\n } else if (decision) {\n decisions = validateFactoryRuleDecisions([decision]).map(entry => {\n assertFactoryDecisionTarget(\n entry,\n this.options.boards,\n relatedItem ? boardForWorkItem(relatedItem) : undefined,\n );\n return { ...entry };\n });\n }\n } catch (error) {\n const timedOut = error instanceof Error && error.message === 'FACTORY_RULE_TIMEOUT';\n outcome = {\n status: 'rejected',\n code: timedOut ? 'timeout' : 'rule_error',\n reason: timedOut\n ? 'Factory rule evaluation timed out.'\n : error instanceof Error\n ? error.message.slice(0, 2_000)\n : 'Factory incident.io rule failed.',\n };\n }\n\n const committed = await this.options.storage.commitRuleEvaluation({\n orgId: input.orgId,\n factoryProjectId: input.factoryProjectId,\n workItemId: relatedItem?.id ?? null,\n ingress: { identity: ingressId, triggerType: `incidentio.${event}` },\n configVersion: this.options.configVersion,\n expectedRevision: relatedItem?.revision ?? null,\n actor,\n outcome,\n decisions,\n causalChain: [],\n now: new Date(),\n });\n if (committed.status === 'stale') {\n // Nothing was persisted: re-read the item and evaluate again at its fresh revision.\n if (attempt >= MAX_STALE_RULE_ATTEMPTS) {\n throw new Error(`Factory incident.io rule evaluation for ${ingressId} kept losing revision races.`);\n }\n const fresh = relatedItem ? await this.options.storage.get({ orgId: input.orgId, id: relatedItem.id }) : null;\n if (relatedItem && !fresh) return 'missing';\n return this.#ingestIssue(input, issue, fresh ?? undefined, attempt + 1);\n }\n return committed.status;\n }\n}\n\nexport function attachIncidentioRules(\n incidentio: { readonly rules: IncidentioEventRules },\n context: IntegrationContext,\n): ((input: IncidentioRulesIngress) => Promise<unknown>) | undefined {\n if (!context.runtime) return undefined;\n const rules = new IncidentioRules({\n projects: context.storage.projects,\n storage: context.runtime.workItems,\n configVersion: context.runtime.configVersion,\n boards: context.runtime.boards,\n incidentioRules: incidentio.rules,\n });\n return input => rules.ingest(input);\n}\n"],"mappings":"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"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { NoopLeaseProvider, isLeaseProvider } from "@mastra/core/events";
|
|
2
2
|
import { MastraWorker } from "@mastra/core/worker";
|
|
3
3
|
//#region src/integrations/issue-reconcile-worker.ts
|
|
4
|
-
const DEFAULT_ISSUE_RECONCILE_INTERVAL_MS =
|
|
4
|
+
const DEFAULT_ISSUE_RECONCILE_INTERVAL_MS = 3e5;
|
|
5
5
|
const MIN_LEASE_TTL_MS = 3e4;
|
|
6
6
|
var IssueReconcileWorker = class extends MastraWorker {
|
|
7
7
|
name;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"issue-reconcile-worker.js","names":[
|
|
1
|
+
{"version":3,"file":"issue-reconcile-worker.js","names":[],"sources":["../../src/integrations/issue-reconcile-worker.ts"],"sourcesContent":["import { isLeaseProvider, NoopLeaseProvider } from '@mastra/core/events';\nimport type { LeaseProvider, PubSub } from '@mastra/core/events';\nimport { MastraWorker } from '@mastra/core/worker';\nimport type { WorkerDeps } from '@mastra/core/worker';\n\nimport type { IssueReconciler } from './issue-reconciler.js';\n\nexport const DEFAULT_ISSUE_RECONCILE_INTERVAL_MS = 5 * 60_000;\nconst MIN_LEASE_TTL_MS = 30_000;\n\nexport interface IssueReconcileWorkerConfig {\n integrationId: string;\n reconcile: IssueReconciler;\n intervalMs?: number;\n}\n\nexport class IssueReconcileWorker extends MastraWorker {\n readonly name: string;\n\n readonly #integrationId: string;\n readonly #reconcile: IssueReconciler;\n readonly #intervalMs: number;\n readonly #leaseTtlMs: number;\n readonly #leaseKey: string;\n readonly #leaseOwner = globalThis.crypto.randomUUID();\n\n #running = false;\n #timer: ReturnType<typeof setTimeout> | undefined;\n #inFlight: Promise<void> | undefined;\n #leaseProvider: LeaseProvider = NoopLeaseProvider;\n\n constructor(config: IssueReconcileWorkerConfig) {\n super();\n this.#integrationId = config.integrationId;\n this.name = `${config.integrationId}-issue-reconcile`;\n this.#leaseKey = `${config.integrationId}:issue-reconcile`;\n this.#reconcile = config.reconcile;\n this.#intervalMs = config.intervalMs ?? DEFAULT_ISSUE_RECONCILE_INTERVAL_MS;\n if (!Number.isFinite(this.#intervalMs) || this.#intervalMs <= 0) {\n throw new Error(`${config.integrationId} issue reconcile interval must be a positive number.`);\n }\n this.#leaseTtlMs = Math.max(MIN_LEASE_TTL_MS, this.#intervalMs * 3);\n }\n\n async init(deps: WorkerDeps): Promise<void> {\n await super.init(deps);\n this.#leaseProvider = getLeaseProvider(deps.pubsub);\n }\n\n async start(): Promise<void> {\n if (this.#running) return;\n if (!this.deps) throw new Error('IssueReconcileWorker: call init() before start()');\n this.#running = true;\n this.deps.logger.info(`${this.#integrationId} issue reconcile worker started`, { intervalMs: this.#intervalMs });\n this.#schedule(0);\n }\n\n async stop(): Promise<void> {\n if (!this.#running) return;\n this.#running = false;\n if (this.#timer) clearTimeout(this.#timer);\n this.#timer = undefined;\n await this.#inFlight;\n }\n\n get isRunning(): boolean {\n return this.#running;\n }\n\n #schedule(delayMs: number): void {\n if (!this.#running) return;\n this.#timer = setTimeout(() => {\n this.#timer = undefined;\n const run = this.#tick().finally(() => {\n this.#inFlight = undefined;\n this.#schedule(this.#intervalMs);\n });\n this.#inFlight = run;\n }, delayMs);\n this.#timer.unref?.();\n }\n\n async #tick(): Promise<void> {\n const lease = await this.#leaseProvider\n .acquireLease(this.#leaseKey, this.#leaseOwner, this.#leaseTtlMs)\n .catch(() => ({ acquired: false }));\n if (!lease.acquired) return;\n\n // A sweep that traverses many projects/orgs can outrun the lease TTL;\n // renew periodically so a replica can't grab the expired lease and start\n // an overlapping sweep partway through this one.\n const renewalTimer = setInterval(\n () => {\n void this.#leaseProvider.renewLease(this.#leaseKey, this.#leaseOwner, this.#leaseTtlMs).catch(error => {\n this.deps?.logger.warn(`${this.#integrationId} issue reconcile lease renewal failed`, {\n error: error instanceof Error ? error.message : String(error),\n });\n });\n },\n Math.max(1_000, Math.floor(this.#leaseTtlMs / 3)),\n );\n renewalTimer.unref?.();\n\n try {\n const startedAt = Date.now();\n const { errors, ...counts } = await this.#reconcile();\n const context = { ...counts, durationMs: Date.now() - startedAt };\n if (counts.failed > 0) {\n this.deps?.logger.warn(`${this.#integrationId} issue reconcile sweep completed with failures`, {\n ...context,\n errors,\n });\n } else {\n this.deps?.logger.debug(`${this.#integrationId} issue reconcile sweep completed`, context);\n }\n } catch (error) {\n this.deps?.logger.warn(`${this.#integrationId} issue reconcile sweep failed`, {\n error: error instanceof Error ? error.message : String(error),\n });\n } finally {\n clearInterval(renewalTimer);\n await this.#leaseProvider.releaseLease(this.#leaseKey, this.#leaseOwner).catch(() => undefined);\n }\n }\n}\n\nfunction getLeaseProvider(pubsub: PubSub): LeaseProvider {\n const getProvider = (pubsub as PubSub & { getLeaseProvider?: () => LeaseProvider | undefined }).getLeaseProvider;\n if (typeof getProvider === 'function') return getProvider.call(pubsub) ?? NoopLeaseProvider;\n return isLeaseProvider(pubsub) ? pubsub : ((pubsub as PubSub & { lease?: LeaseProvider }).lease ?? NoopLeaseProvider);\n}\n"],"mappings":"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"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
//#region src/integrations/issue-reconciler.ts
|
|
2
2
|
const EXTERNAL_SOURCE_MISSING_KEY = "externalSourceMissingAt";
|
|
3
|
-
const MISSING_RECHECK_MS =
|
|
3
|
+
const MISSING_RECHECK_MS = 864e5;
|
|
4
4
|
function sameValue(left, right) {
|
|
5
5
|
if (Array.isArray(right)) {
|
|
6
6
|
if (!Array.isArray(left)) return right.length === 0;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"issue-reconciler.js","names":[],"sources":["../../src/integrations/issue-reconciler.ts"],"sourcesContent":["import type { Intake, IntakeIssue, ResolvedIntakeDispatch } from '../capabilities/intake.js';\nimport type { FactoryProject, FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';\n\nexport const EXTERNAL_SOURCE_MISSING_KEY = 'externalSourceMissingAt';\nconst MISSING_RECHECK_MS = 24 * 60 * 60_000;\n\nexport interface IssueReconcileSummary {\n projects: number;\n checked: number;\n updated: number;\n closed: number;\n missing: number;\n failed: number;\n errors: Array<{ projectId: string; workItemId?: string; error: string }>;\n}\n\n/**\n * Scope passed in by the caller. Providers that reconcile per-repository (like\n * GitHub, sharing target discovery with the PR reconciler) pass a target set\n * and a `matches(item, scope)` predicate. Providers with no repository concept\n * (Linear) pass no scope and every issue item is considered.\n */\nexport interface IssueReconcileScope<TScope> {\n scopes: TScope[];\n matches(item: WorkItemRow, scope: TScope): boolean;\n}\n\nexport interface IssueReconcilerOptions<TScope = void> {\n integrationId: string;\n intake: Intake;\n projects: Pick<FactoryProjectsStorage, 'listAll'>;\n storage: WorkItemsStorage;\n externalSource?(item: WorkItemRow): { type: string; externalId: string };\n issueId(item: WorkItemRow): string | undefined;\n metadata(\n item: WorkItemRow,\n issue: IntakeIssue,\n dispatch: ResolvedIntakeDispatch,\n ): Record<string, unknown> | Promise<Record<string, unknown>>;\n /**\n * Called when a closed issue (stateType 'completed' or 'canceled') is detected\n * on a non-terminal work item. Use this to replay the close event through\n * the provider's rules ingress.\n */\n onClosed?(\n item: WorkItemRow,\n issue: IntakeIssue,\n project: FactoryProject,\n dispatch: ResolvedIntakeDispatch,\n ): Promise<Record<string, unknown> | void>;\n /** Whether the item already rests in a terminal phase of its board. Unknown phases are not terminal. */\n isTerminal(item: WorkItemRow): boolean;\n now?: () => Date;\n}\n\nexport type IssueReconciler<TScope = void> = TScope extends void\n ? () => Promise<IssueReconcileSummary>\n : (scope: IssueReconcileScope<TScope>) => Promise<IssueReconcileSummary>;\n\nfunction sameValue(left: unknown, right: unknown): boolean {\n if (Array.isArray(right)) {\n if (!Array.isArray(left)) return right.length === 0;\n const leftStrings = left\n .filter((value): value is string => typeof value === 'string')\n .slice()\n .sort();\n const rightStrings = right\n .filter((value): value is string => typeof value === 'string')\n .slice()\n .sort();\n return (\n leftStrings.length === rightStrings.length && leftStrings.every((value, index) => value === rightStrings[index])\n );\n }\n if (right !== null && typeof right === 'object') {\n if (left === null || typeof left !== 'object' || Array.isArray(left)) return false;\n const leftRecord = left as Record<string, unknown>;\n const rightRecord = right as Record<string, unknown>;\n const leftKeys = Object.keys(leftRecord);\n const rightKeys = Object.keys(rightRecord);\n return (\n leftKeys.length === rightKeys.length &&\n rightKeys.every(key => Object.hasOwn(leftRecord, key) && sameValue(leftRecord[key], rightRecord[key]))\n );\n }\n return left === right;\n}\n\nfunction metadataMatches(current: Record<string, unknown> | null, desired: Record<string, unknown>): boolean {\n return Object.entries(desired).every(([key, value]) => sameValue(current?.[key], value));\n}\n\n/**\n * Drop `undefined` entries so we never spread them into stored metadata. An\n * `undefined` field on the desired patch means \"no signal from the live issue\"\n * — we must preserve whatever was already stored, not clobber it.\n */\nfunction withoutUndefined(record: Record<string, unknown>): Record<string, unknown> {\n const out: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(record)) {\n if (value !== undefined) out[key] = value;\n }\n return out;\n}\n\nfunction withoutMissingMarker(record: Record<string, unknown> | null): Record<string, unknown> {\n const { [EXTERNAL_SOURCE_MISSING_KEY]: _missingAt, ...metadata } = record ?? {};\n return metadata;\n}\n\nfunction issueItems(project: FactoryProject, items: WorkItemRow[], integrationId: string): WorkItemRow[] {\n return items.filter(\n item =>\n item.factoryProjectId === project.id &&\n item.externalSource?.integrationId === integrationId &&\n item.externalSource.type === 'issue',\n );\n}\n\nexport function createIssueReconciler<TScope = void>(options: IssueReconcilerOptions<TScope>): IssueReconciler<TScope> {\n const now = options.now ?? (() => new Date());\n const run = async (scope?: IssueReconcileScope<TScope>): Promise<IssueReconcileSummary> => {\n const summary: IssueReconcileSummary = {\n projects: 0,\n checked: 0,\n updated: 0,\n closed: 0,\n missing: 0,\n failed: 0,\n errors: [],\n };\n\n // A scoped sweep with zero targets is a no-op: the caller is telling us\n // there are no configured repositories to consider.\n if (scope && scope.scopes.length === 0) return summary;\n\n const projects = await options.projects.listAll();\n for (const project of projects) {\n const all = await options.storage.list({ orgId: project.orgId, factoryProjectId: project.id });\n const candidates = issueItems(project, all, options.integrationId);\n const items = scope\n ? candidates.filter(item => scope.scopes.some(target => scope.matches(item, target)))\n : candidates;\n if (items.length === 0) continue;\n summary.projects += 1;\n\n for (const item of items) {\n summary.checked += 1;\n try {\n const missingAt = item.metadata?.[EXTERNAL_SOURCE_MISSING_KEY];\n const missingTime = typeof missingAt === 'string' ? Date.parse(missingAt) : Number.NaN;\n const missingAge = now().getTime() - missingTime;\n if (Number.isFinite(missingTime) && missingAge >= 0 && missingAge < MISSING_RECHECK_MS) {\n summary.missing += 1;\n continue;\n }\n\n const resolved = await options.intake.resolveIntakeDispatch?.({\n orgId: project.orgId,\n externalSource: options.externalSource?.(item) ?? item.externalSource!,\n });\n if (!resolved) {\n await options.storage.update({\n orgId: project.orgId,\n id: item.id,\n userId: 'factory-rule-dispatcher',\n patch: { metadata: { ...(item.metadata ?? {}), [EXTERNAL_SOURCE_MISSING_KEY]: now().toISOString() } },\n });\n summary.missing += 1;\n continue;\n }\n const issueId = options.issueId(item) ?? resolved.issueId;\n const issue = await options.intake.getIssue({ ...resolved, issueId });\n if (!issue) {\n await options.storage.update({\n orgId: project.orgId,\n id: item.id,\n userId: 'factory-rule-dispatcher',\n patch: { metadata: { ...(item.metadata ?? {}), [EXTERNAL_SOURCE_MISSING_KEY]: now().toISOString() } },\n });\n summary.missing += 1;\n continue;\n }\n\n const hadMissingMarker = typeof missingAt === 'string';\n const baseMetadata = withoutMissingMarker(item.metadata);\n // Close detection for Linear: replay through rules ingress if closed\n const isClosed = issue.stateType === 'completed' || issue.stateType === 'canceled';\n if (isClosed && !options.isTerminal(item) && options.onClosed) {\n const closedMetadata = withoutUndefined((await options.onClosed(item, issue, project, resolved)) ?? {});\n if (hadMissingMarker || !metadataMatches(baseMetadata, closedMetadata)) {\n await options.storage.update({\n orgId: project.orgId,\n id: item.id,\n userId: 'factory-rule-dispatcher',\n patch: {\n metadata: {\n ...baseMetadata,\n ...closedMetadata,\n ...(hadMissingMarker ? { [EXTERNAL_SOURCE_MISSING_KEY]: undefined } : {}),\n },\n },\n });\n summary.updated += 1;\n }\n summary.closed += 1;\n continue;\n }\n\n const metadata = withoutUndefined(await options.metadata(item, issue, resolved));\n if (!hadMissingMarker && metadataMatches(baseMetadata, metadata)) continue;\n await options.storage.update({\n orgId: project.orgId,\n id: item.id,\n userId: 'factory-rule-dispatcher',\n patch: {\n metadata: {\n ...baseMetadata,\n ...metadata,\n ...(hadMissingMarker ? { [EXTERNAL_SOURCE_MISSING_KEY]: undefined } : {}),\n },\n },\n });\n summary.updated += 1;\n } catch (error) {\n summary.failed += 1;\n summary.errors.push({\n projectId: project.id,\n workItemId: item.id,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n }\n }\n\n return summary;\n };\n\n return run as IssueReconciler<TScope>;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"issue-reconciler.js","names":[],"sources":["../../src/integrations/issue-reconciler.ts"],"sourcesContent":["import type { Intake, IntakeIssue, ResolvedIntakeDispatch } from '../capabilities/intake.js';\nimport type { FactoryProject, FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';\n\nexport const EXTERNAL_SOURCE_MISSING_KEY = 'externalSourceMissingAt';\nconst MISSING_RECHECK_MS = 24 * 60 * 60_000;\n\nexport interface IssueReconcileSummary {\n projects: number;\n checked: number;\n updated: number;\n closed: number;\n missing: number;\n failed: number;\n errors: Array<{ projectId: string; workItemId?: string; error: string }>;\n}\n\n/**\n * Scope passed in by the caller. Providers that reconcile per-repository (like\n * GitHub, sharing target discovery with the PR reconciler) pass a target set\n * and a `matches(item, scope)` predicate. Providers with no repository concept\n * (Linear) pass no scope and every issue item is considered.\n */\nexport interface IssueReconcileScope<TScope> {\n scopes: TScope[];\n matches(item: WorkItemRow, scope: TScope): boolean;\n}\n\nexport interface IssueReconcilerOptions<TScope = void> {\n integrationId: string;\n intake: Intake;\n projects: Pick<FactoryProjectsStorage, 'listAll'>;\n storage: WorkItemsStorage;\n externalSource?(item: WorkItemRow): { type: string; externalId: string };\n issueId(item: WorkItemRow): string | undefined;\n metadata(\n item: WorkItemRow,\n issue: IntakeIssue,\n dispatch: ResolvedIntakeDispatch,\n ): Record<string, unknown> | Promise<Record<string, unknown>>;\n /**\n * Called when a closed issue (stateType 'completed' or 'canceled') is detected\n * on a non-terminal work item. Use this to replay the close event through\n * the provider's rules ingress.\n */\n onClosed?(\n item: WorkItemRow,\n issue: IntakeIssue,\n project: FactoryProject,\n dispatch: ResolvedIntakeDispatch,\n ): Promise<Record<string, unknown> | void>;\n /** Whether the item already rests in a terminal phase of its board. Unknown phases are not terminal. */\n isTerminal(item: WorkItemRow): boolean;\n now?: () => Date;\n}\n\nexport type IssueReconciler<TScope = void> = TScope extends void\n ? () => Promise<IssueReconcileSummary>\n : (scope: IssueReconcileScope<TScope>) => Promise<IssueReconcileSummary>;\n\nfunction sameValue(left: unknown, right: unknown): boolean {\n if (Array.isArray(right)) {\n if (!Array.isArray(left)) return right.length === 0;\n const leftStrings = left\n .filter((value): value is string => typeof value === 'string')\n .slice()\n .sort();\n const rightStrings = right\n .filter((value): value is string => typeof value === 'string')\n .slice()\n .sort();\n return (\n leftStrings.length === rightStrings.length && leftStrings.every((value, index) => value === rightStrings[index])\n );\n }\n if (right !== null && typeof right === 'object') {\n if (left === null || typeof left !== 'object' || Array.isArray(left)) return false;\n const leftRecord = left as Record<string, unknown>;\n const rightRecord = right as Record<string, unknown>;\n const leftKeys = Object.keys(leftRecord);\n const rightKeys = Object.keys(rightRecord);\n return (\n leftKeys.length === rightKeys.length &&\n rightKeys.every(key => Object.hasOwn(leftRecord, key) && sameValue(leftRecord[key], rightRecord[key]))\n );\n }\n return left === right;\n}\n\nfunction metadataMatches(current: Record<string, unknown> | null, desired: Record<string, unknown>): boolean {\n return Object.entries(desired).every(([key, value]) => sameValue(current?.[key], value));\n}\n\n/**\n * Drop `undefined` entries so we never spread them into stored metadata. An\n * `undefined` field on the desired patch means \"no signal from the live issue\"\n * — we must preserve whatever was already stored, not clobber it.\n */\nfunction withoutUndefined(record: Record<string, unknown>): Record<string, unknown> {\n const out: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(record)) {\n if (value !== undefined) out[key] = value;\n }\n return out;\n}\n\nfunction withoutMissingMarker(record: Record<string, unknown> | null): Record<string, unknown> {\n const { [EXTERNAL_SOURCE_MISSING_KEY]: _missingAt, ...metadata } = record ?? {};\n return metadata;\n}\n\nfunction issueItems(project: FactoryProject, items: WorkItemRow[], integrationId: string): WorkItemRow[] {\n return items.filter(\n item =>\n item.factoryProjectId === project.id &&\n item.externalSource?.integrationId === integrationId &&\n item.externalSource.type === 'issue',\n );\n}\n\nexport function createIssueReconciler<TScope = void>(options: IssueReconcilerOptions<TScope>): IssueReconciler<TScope> {\n const now = options.now ?? (() => new Date());\n const run = async (scope?: IssueReconcileScope<TScope>): Promise<IssueReconcileSummary> => {\n const summary: IssueReconcileSummary = {\n projects: 0,\n checked: 0,\n updated: 0,\n closed: 0,\n missing: 0,\n failed: 0,\n errors: [],\n };\n\n // A scoped sweep with zero targets is a no-op: the caller is telling us\n // there are no configured repositories to consider.\n if (scope && scope.scopes.length === 0) return summary;\n\n const projects = await options.projects.listAll();\n for (const project of projects) {\n const all = await options.storage.list({ orgId: project.orgId, factoryProjectId: project.id });\n const candidates = issueItems(project, all, options.integrationId);\n const items = scope\n ? candidates.filter(item => scope.scopes.some(target => scope.matches(item, target)))\n : candidates;\n if (items.length === 0) continue;\n summary.projects += 1;\n\n for (const item of items) {\n summary.checked += 1;\n try {\n const missingAt = item.metadata?.[EXTERNAL_SOURCE_MISSING_KEY];\n const missingTime = typeof missingAt === 'string' ? Date.parse(missingAt) : Number.NaN;\n const missingAge = now().getTime() - missingTime;\n if (Number.isFinite(missingTime) && missingAge >= 0 && missingAge < MISSING_RECHECK_MS) {\n summary.missing += 1;\n continue;\n }\n\n const resolved = await options.intake.resolveIntakeDispatch?.({\n orgId: project.orgId,\n externalSource: options.externalSource?.(item) ?? item.externalSource!,\n });\n if (!resolved) {\n await options.storage.update({\n orgId: project.orgId,\n id: item.id,\n userId: 'factory-rule-dispatcher',\n patch: { metadata: { ...(item.metadata ?? {}), [EXTERNAL_SOURCE_MISSING_KEY]: now().toISOString() } },\n });\n summary.missing += 1;\n continue;\n }\n const issueId = options.issueId(item) ?? resolved.issueId;\n const issue = await options.intake.getIssue({ ...resolved, issueId });\n if (!issue) {\n await options.storage.update({\n orgId: project.orgId,\n id: item.id,\n userId: 'factory-rule-dispatcher',\n patch: { metadata: { ...(item.metadata ?? {}), [EXTERNAL_SOURCE_MISSING_KEY]: now().toISOString() } },\n });\n summary.missing += 1;\n continue;\n }\n\n const hadMissingMarker = typeof missingAt === 'string';\n const baseMetadata = withoutMissingMarker(item.metadata);\n // Close detection for Linear: replay through rules ingress if closed\n const isClosed = issue.stateType === 'completed' || issue.stateType === 'canceled';\n if (isClosed && !options.isTerminal(item) && options.onClosed) {\n const closedMetadata = withoutUndefined((await options.onClosed(item, issue, project, resolved)) ?? {});\n if (hadMissingMarker || !metadataMatches(baseMetadata, closedMetadata)) {\n await options.storage.update({\n orgId: project.orgId,\n id: item.id,\n userId: 'factory-rule-dispatcher',\n patch: {\n metadata: {\n ...baseMetadata,\n ...closedMetadata,\n ...(hadMissingMarker ? { [EXTERNAL_SOURCE_MISSING_KEY]: undefined } : {}),\n },\n },\n });\n summary.updated += 1;\n }\n summary.closed += 1;\n continue;\n }\n\n const metadata = withoutUndefined(await options.metadata(item, issue, resolved));\n if (!hadMissingMarker && metadataMatches(baseMetadata, metadata)) continue;\n await options.storage.update({\n orgId: project.orgId,\n id: item.id,\n userId: 'factory-rule-dispatcher',\n patch: {\n metadata: {\n ...baseMetadata,\n ...metadata,\n ...(hadMissingMarker ? { [EXTERNAL_SOURCE_MISSING_KEY]: undefined } : {}),\n },\n },\n });\n summary.updated += 1;\n } catch (error) {\n summary.failed += 1;\n summary.errors.push({\n projectId: project.id,\n workItemId: item.id,\n error: error instanceof Error ? error.message : String(error),\n });\n }\n }\n }\n\n return summary;\n };\n\n return run as IssueReconciler<TScope>;\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api.js","names":["#baseUrl","#authHeader","#projectId","#fetch","#request"],"sources":["../../../src/integrations/jira/api.ts"],"sourcesContent":["/**\n * Typed Jira Cloud REST client (API v3).\n *\n * Shared by the direct and Platform-managed Jira integrations. Direct Jira\n * uses Basic auth against an Atlassian site; Platform Jira points the same\n * client at a connection proxy with a bearer token. Both modes use the same\n * request shapes, timeout, and error normalization.\n *\n * Endpoint notes (Jira Cloud, 2026):\n * - Issue search is `POST /rest/api/3/search/jql` — the legacy\n * `GET /rest/api/3/search` endpoint has been removed. The new endpoint\n * returns only ids unless `fields` is requested explicitly, and pages with\n * an opaque `nextPageToken` cursor (no `startAt`/`total`).\n * - Project listing is `GET /rest/api/3/project/search` with classic\n * `startAt`/`isLast` paging.\n * - Descriptions and comment bodies are ADF documents (see `adf.ts`).\n */\n\nimport type { AdfNode } from './adf.js';\nimport { textToAdf } from './adf.js';\n\nconst JIRA_TIMEOUT_MS = 15_000;\n/** Hosts allowed to receive Basic credentials over plain http (local development mocks). */\nconst LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1']);\n/** Issue page size — Linear parity (`LINEAR_ISSUES_PAGE_SIZE`). */\nexport const JIRA_ISSUES_PAGE_SIZE = 30;\n/** Comment page size — Linear parity (`LINEAR_COMMENTS_PAGE_SIZE`). */\nexport const JIRA_COMMENTS_PAGE_SIZE = 50;\nexport const JIRA_PROJECTS_PAGE_SIZE = 50;\n\n/** Fields requested from issue reads — `search/jql` returns ids only without an explicit list. */\nexport const JIRA_ISSUE_FIELDS = [\n 'summary',\n 'description',\n 'status',\n 'assignee',\n 'reporter',\n 'labels',\n 'priority',\n 'issuetype',\n 'project',\n 'created',\n 'updated',\n] as const;\n\ninterface JiraApiClientBaseConfig {\n /** Jira API base URL, either the Atlassian site or a Platform connection proxy. */\n baseUrl: string;\n fetchImpl?: typeof fetch;\n}\n\nexport type JiraApiClientConfig = JiraApiClientBaseConfig &\n (\n | {\n /** Atlassian account email the API token belongs to. */\n email: string;\n /** API token from id.atlassian.com → Security → API tokens. */\n apiToken: string;\n accessToken?: never;\n }\n | {\n /** Bearer token used when the base URL is a Mastra Platform connection proxy. */\n accessToken: string;\n /**\n * Mastra project id sent as `x-mastra-project-id` so the platform can\n * attribute proxied Jira activity to the project. Falls back to the\n * `MASTRA_PROJECT_ID` environment variable. The platform strips the\n * header before forwarding the request to Atlassian.\n */\n projectId?: string;\n email?: never;\n apiToken?: never;\n }\n );\n\n/** Stable error code the routes/tools surface to the SPA and agents. */\nexport type JiraApiErrorCode = 'jira_auth_failed' | 'jira_request_failed';\n\n/** Normalized Jira API failure carrying the HTTP status and Jira's error detail. */\nexport class JiraApiError extends Error {\n readonly status: number | null;\n readonly code: JiraApiErrorCode;\n\n constructor(message: string, status: number | null) {\n super(message);\n this.name = 'JiraApiError';\n this.status = status;\n this.code = status === 401 || status === 403 ? 'jira_auth_failed' : 'jira_request_failed';\n }\n}\n\nexport interface JiraStatusCategory {\n /** `new` | `indeterminate` | `done` — Jira's fixed status families. */\n key: string;\n name?: string;\n}\n\nexport interface JiraStatus {\n name: string;\n statusCategory?: JiraStatusCategory;\n}\n\nexport interface JiraProject {\n id: string;\n key: string;\n name: string;\n}\n\nexport interface JiraProjectSearchPage {\n values: JiraProject[];\n startAt: number;\n isLast: boolean;\n}\n\nexport interface JiraServerInfo {\n baseUrl: string;\n serverTitle?: string;\n}\n\nexport interface JiraUser {\n displayName: string;\n}\n\nexport interface JiraComment {\n id: string;\n author?: JiraUser | null;\n body?: AdfNode | null;\n created: string;\n}\n\nexport interface JiraCommentPage {\n comments: JiraComment[];\n startAt: number;\n maxResults: number;\n total: number;\n}\n\nexport interface JiraIssueFields {\n summary?: string;\n description?: AdfNode | null;\n status?: JiraStatus;\n assignee?: JiraUser | null;\n reporter?: JiraUser | null;\n labels?: string[];\n priority?: { name: string } | null;\n issuetype?: { name: string };\n project?: { id: string; key: string; name?: string };\n created?: string;\n updated?: string;\n}\n\nexport interface JiraIssue {\n id: string;\n key: string;\n fields: JiraIssueFields;\n}\n\nexport interface JiraSearchPage {\n issues: JiraIssue[];\n /** Opaque cursor for the next page; absent on the last page. */\n nextPageToken?: string | null;\n}\n\nexport interface JiraTransition {\n id: string;\n name: string;\n /** Target status the transition moves the issue to. */\n to?: JiraStatus;\n}\n\nexport class JiraApiClient {\n readonly #baseUrl: string;\n readonly #authHeader: string;\n readonly #projectId: string | null;\n readonly #fetch: typeof fetch;\n\n constructor(config: JiraApiClientConfig) {\n if (!config.baseUrl) {\n throw new Error('JiraApiClient is missing required config: baseUrl.');\n }\n // Fail fast on a malformed base URL: a bare host like `acme.atlassian.net`\n // would otherwise surface later as an opaque `TypeError: Invalid URL`.\n let parsed: URL;\n try {\n parsed = new URL(config.baseUrl);\n } catch {\n throw new Error(`JiraApiClient baseUrl is not an absolute URL: \"${config.baseUrl}\".`);\n }\n if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {\n throw new Error(`JiraApiClient baseUrl must be an http(s) URL: \"${config.baseUrl}\".`);\n }\n if (config.accessToken !== undefined) {\n if (!config.accessToken) {\n throw new Error('JiraApiClient is missing required config: accessToken.');\n }\n this.#authHeader = `Bearer ${config.accessToken}`;\n this.#projectId = (config.projectId ?? process.env.MASTRA_PROJECT_ID)?.trim() || null;\n } else {\n const missing = (['email', 'apiToken'] as const).filter(key => !config[key]);\n if (missing.length > 0) {\n throw new Error(`JiraApiClient is missing required config: ${missing.join(', ')}.`);\n }\n // Basic credentials ride on every request, so never send them over\n // plaintext to a remote host. Loopback stays allowed for local mocks.\n if (parsed.protocol === 'http:' && !LOOPBACK_HOSTS.has(parsed.hostname)) {\n throw new Error('JiraApiClient baseUrl must use https when Basic credentials are configured.');\n }\n this.#authHeader = `Basic ${Buffer.from(`${config.email}:${config.apiToken}`).toString('base64')}`;\n // Direct Atlassian mode: never send Mastra platform headers to Jira itself.\n this.#projectId = null;\n }\n this.#baseUrl = config.baseUrl.replace(/\\/+$/, '');\n this.#fetch = config.fetchImpl ?? globalThis.fetch;\n }\n\n /** Normalized site base URL (no trailing slash) — used for `/browse/<key>` links. */\n get baseUrl(): string {\n return this.#baseUrl;\n }\n\n async #request<T>(\n method: 'GET' | 'POST',\n path: string,\n options: { query?: Record<string, string | number | undefined>; body?: unknown } = {},\n ): Promise<T> {\n const url = new URL(`${this.#baseUrl}${path}`);\n for (const [key, value] of Object.entries(options.query ?? {})) {\n if (value !== undefined) url.searchParams.set(key, String(value));\n }\n const hasBody = options.body !== undefined;\n const res = await this.#fetch(url, {\n method,\n signal: AbortSignal.timeout(JIRA_TIMEOUT_MS),\n headers: {\n authorization: this.#authHeader,\n accept: 'application/json',\n // Project attribution for the Mastra platform proxy; stripped by the\n // platform before the request reaches Atlassian.\n ...(this.#projectId ? { 'x-mastra-project-id': this.#projectId } : {}),\n ...(hasBody ? { 'content-type': 'application/json' } : {}),\n },\n ...(hasBody ? { body: JSON.stringify(options.body) } : {}),\n });\n if (!res.ok) {\n // Jira reports validation failures as `errorMessages` and `errors`;\n // the Platform proxy reports upstream failures through `detail`/`error`/`title`.\n let detail: string | null = null;\n try {\n const errBody = (await res.json()) as {\n errorMessages?: string[];\n errors?: Record<string, string>;\n detail?: string;\n error?: string;\n title?: string;\n };\n detail =\n errBody.errorMessages?.[0] ??\n Object.values(errBody.errors ?? {})[0] ??\n errBody.detail ??\n errBody.error ??\n errBody.title ??\n null;\n } catch {\n // Non-JSON error body; fall back to the status code alone.\n }\n throw new JiraApiError(`Jira API request failed (${res.status})${detail ? `: ${detail}` : ''}`, res.status);\n }\n if (res.status === 204) return undefined as T;\n return (await res.json()) as T;\n }\n\n async getServerInfo(): Promise<JiraServerInfo> {\n return this.#request<JiraServerInfo>('GET', '/rest/api/3/serverInfo');\n }\n\n /** One page of the site's projects (Settings intake-source picker). */\n async listProjects(options: { startAt?: number } = {}): Promise<JiraProjectSearchPage> {\n return this.#request<JiraProjectSearchPage>('GET', '/rest/api/3/project/search', {\n query: { startAt: options.startAt ?? 0, maxResults: JIRA_PROJECTS_PAGE_SIZE },\n });\n }\n\n /** One page of a JQL search with explicitly requested fields. */\n async searchIssues(options: {\n jql: string;\n fields?: readonly string[];\n nextPageToken?: string;\n maxResults?: number;\n }): Promise<JiraSearchPage> {\n return this.#request<JiraSearchPage>('POST', '/rest/api/3/search/jql', {\n body: {\n jql: options.jql,\n fields: [...(options.fields ?? JIRA_ISSUE_FIELDS)],\n maxResults: options.maxResults ?? JIRA_ISSUES_PAGE_SIZE,\n ...(options.nextPageToken ? { nextPageToken: options.nextPageToken } : {}),\n },\n });\n }\n\n /** Full issue detail by key (`ENG-42`) or id. */\n async getIssue(keyOrId: string): Promise<JiraIssue> {\n return this.#request<JiraIssue>('GET', `/rest/api/3/issue/${encodeURIComponent(keyOrId)}`, {\n query: { fields: JIRA_ISSUE_FIELDS.join(',') },\n });\n }\n\n /** One page of an issue's comments (oldest first, Jira default order). */\n async listComments(keyOrId: string, options: { startAt?: number } = {}): Promise<JiraCommentPage> {\n return this.#request<JiraCommentPage>('GET', `/rest/api/3/issue/${encodeURIComponent(keyOrId)}/comment`, {\n query: { startAt: options.startAt ?? 0, maxResults: JIRA_COMMENTS_PAGE_SIZE },\n });\n }\n\n /** Post a plain-text comment (wrapped into a minimal ADF document). */\n async createComment(keyOrId: string, body: string): Promise<JiraComment> {\n return this.#request<JiraComment>('POST', `/rest/api/3/issue/${encodeURIComponent(keyOrId)}/comment`, {\n body: { body: textToAdf(body) },\n });\n }\n\n /** Transitions currently legal for the issue (workflow-dependent). */\n async listTransitions(keyOrId: string): Promise<JiraTransition[]> {\n const data = await this.#request<{ transitions?: JiraTransition[] }>(\n 'GET',\n `/rest/api/3/issue/${encodeURIComponent(keyOrId)}/transitions`,\n );\n return data.transitions ?? [];\n }\n\n /** Apply a transition by id (Jira responds 204 on success). */\n async applyTransition(keyOrId: string, transitionId: string): Promise<void> {\n await this.#request<void>('POST', `/rest/api/3/issue/${encodeURIComponent(keyOrId)}/transitions`, {\n body: { transition: { id: transitionId } },\n });\n }\n}\n"],"mappings":";;AAqBA,MAAM,kBAAkB;;AAExB,MAAM,iCAAiB,IAAI,IAAI;CAAC;CAAa;CAAa;CAAS;AAAK,CAAC;;AAEzE,MAAa,wBAAwB;;AAErC,MAAa,0BAA0B;AACvC,MAAa,0BAA0B;;AAGvC,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAoCA,IAAa,eAAb,cAAkC,MAAM;CACtC;CACA;CAEA,YAAY,SAAiB,QAAuB;EAClD,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,OAAO,WAAW,OAAO,WAAW,MAAM,qBAAqB;CACtE;AACF;AAiFA,IAAa,gBAAb,MAA2B;CACzB;CACA;CACA;CACA;CAEA,YAAY,QAA6B;EACvC,IAAI,CAAC,OAAO,SACV,MAAM,IAAI,MAAM,oDAAoD;EAItE,IAAI;EACJ,IAAI;GACF,SAAS,IAAI,IAAI,OAAO,OAAO;EACjC,QAAQ;GACN,MAAM,IAAI,MAAM,kDAAkD,OAAO,QAAQ,GAAG;EACtF;EACA,IAAI,OAAO,aAAa,YAAY,OAAO,aAAa,SACtD,MAAM,IAAI,MAAM,kDAAkD,OAAO,QAAQ,GAAG;EAEtF,IAAI,OAAO,gBAAgB,KAAA,GAAW;GACpC,IAAI,CAAC,OAAO,aACV,MAAM,IAAI,MAAM,wDAAwD;GAE1E,KAAKC,cAAc,UAAU,OAAO;GACpC,KAAKC,cAAc,OAAO,aAAa,QAAQ,IAAI,kBAAA,EAAoB,KAAK,KAAK;EACnF,OAAO;GACL,MAAM,UAAW,CAAC,SAAS,UAAU,CAAC,CAAW,QAAO,QAAO,CAAC,OAAO,IAAI;GAC3E,IAAI,QAAQ,SAAS,GACnB,MAAM,IAAI,MAAM,6CAA6C,QAAQ,KAAK,IAAI,EAAE,EAAE;GAIpF,IAAI,OAAO,aAAa,WAAW,CAAC,eAAe,IAAI,OAAO,QAAQ,GACpE,MAAM,IAAI,MAAM,6EAA6E;GAE/F,KAAKD,cAAc,SAAS,OAAO,KAAK,GAAG,OAAO,MAAM,GAAG,OAAO,UAAU,CAAC,CAAC,SAAS,QAAQ;GAE/F,KAAKC,aAAa;EACpB;EACA,KAAKF,WAAW,OAAO,QAAQ,QAAQ,QAAQ,EAAE;EACjD,KAAKG,SAAS,OAAO,aAAa,WAAW;CAC/C;;CAGA,IAAI,UAAkB;EACpB,OAAO,KAAKH;CACd;CAEA,MAAMI,SACJ,QACA,MACA,UAAmF,CAAC,GACxE;EACZ,MAAM,MAAM,IAAI,IAAI,GAAG,KAAKJ,WAAW,MAAM;EAC7C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,SAAS,CAAC,CAAC,GAC3D,IAAI,UAAU,KAAA,GAAW,IAAI,aAAa,IAAI,KAAK,OAAO,KAAK,CAAC;EAElE,MAAM,UAAU,QAAQ,SAAS,KAAA;EACjC,MAAM,MAAM,MAAM,KAAKG,OAAO,KAAK;GACjC;GACA,QAAQ,YAAY,QAAQ,eAAe;GAC3C,SAAS;IACP,eAAe,KAAKF;IACpB,QAAQ;IAGR,GAAI,KAAKC,aAAa,EAAE,uBAAuB,KAAKA,WAAW,IAAI,CAAC;IACpE,GAAI,UAAU,EAAE,gBAAgB,mBAAmB,IAAI,CAAC;GAC1D;GACA,GAAI,UAAU,EAAE,MAAM,KAAK,UAAU,QAAQ,IAAI,EAAE,IAAI,CAAC;EAC1D,CAAC;EACD,IAAI,CAAC,IAAI,IAAI;GAGX,IAAI,SAAwB;GAC5B,IAAI;IACF,MAAM,UAAW,MAAM,IAAI,KAAK;IAOhC,SACE,QAAQ,gBAAgB,MACxB,OAAO,OAAO,QAAQ,UAAU,CAAC,CAAC,CAAC,CAAC,MACpC,QAAQ,UACR,QAAQ,SACR,QAAQ,SACR;GACJ,QAAQ,CAER;GACA,MAAM,IAAI,aAAa,4BAA4B,IAAI,OAAO,GAAG,SAAS,KAAK,WAAW,MAAM,IAAI,MAAM;EAC5G;EACA,IAAI,IAAI,WAAW,KAAK,OAAO,KAAA;EAC/B,OAAQ,MAAM,IAAI,KAAK;CACzB;CAEA,MAAM,gBAAyC;EAC7C,OAAO,KAAKE,SAAyB,OAAO,wBAAwB;CACtE;;CAGA,MAAM,aAAa,UAAgC,CAAC,GAAmC;EACrF,OAAO,KAAKA,SAAgC,OAAO,8BAA8B,EAC/E,OAAO;GAAE,SAAS,QAAQ,WAAW;GAAG,YAAA;EAAoC,EAC9E,CAAC;CACH;;CAGA,MAAM,aAAa,SAKS;EAC1B,OAAO,KAAKA,SAAyB,QAAQ,0BAA0B,EACrE,MAAM;GACJ,KAAK,QAAQ;GACb,QAAQ,CAAC,GAAI,QAAQ,UAAU,iBAAkB;GACjD,YAAY,QAAQ,cAAA;GACpB,GAAI,QAAQ,gBAAgB,EAAE,eAAe,QAAQ,cAAc,IAAI,CAAC;EAC1E,EACF,CAAC;CACH;;CAGA,MAAM,SAAS,SAAqC;EAClD,OAAO,KAAKA,SAAoB,OAAO,qBAAqB,mBAAmB,OAAO,KAAK,EACzF,OAAO,EAAE,QAAQ,kBAAkB,KAAK,GAAG,EAAE,EAC/C,CAAC;CACH;;CAGA,MAAM,aAAa,SAAiB,UAAgC,CAAC,GAA6B;EAChG,OAAO,KAAKA,SAA0B,OAAO,qBAAqB,mBAAmB,OAAO,EAAE,WAAW,EACvG,OAAO;GAAE,SAAS,QAAQ,WAAW;GAAG,YAAA;EAAoC,EAC9E,CAAC;CACH;;CAGA,MAAM,cAAc,SAAiB,MAAoC;EACvE,OAAO,KAAKA,SAAsB,QAAQ,qBAAqB,mBAAmB,OAAO,EAAE,WAAW,EACpG,MAAM,EAAE,MAAM,UAAU,IAAI,EAAE,EAChC,CAAC;CACH;;CAGA,MAAM,gBAAgB,SAA4C;EAKhE,QAAO,MAJY,KAAKA,SACtB,OACA,qBAAqB,mBAAmB,OAAO,EAAE,aACnD,EAAA,CACY,eAAe,CAAC;CAC9B;;CAGA,MAAM,gBAAgB,SAAiB,cAAqC;EAC1E,MAAM,KAAKA,SAAe,QAAQ,qBAAqB,mBAAmB,OAAO,EAAE,eAAe,EAChG,MAAM,EAAE,YAAY,EAAE,IAAI,aAAa,EAAE,EAC3C,CAAC;CACH;AACF"}
|
|
1
|
+
{"version":3,"file":"api.js","names":[],"sources":["../../../src/integrations/jira/api.ts"],"sourcesContent":["/**\n * Typed Jira Cloud REST client (API v3).\n *\n * Shared by the direct and Platform-managed Jira integrations. Direct Jira\n * uses Basic auth against an Atlassian site; Platform Jira points the same\n * client at a connection proxy with a bearer token. Both modes use the same\n * request shapes, timeout, and error normalization.\n *\n * Endpoint notes (Jira Cloud, 2026):\n * - Issue search is `POST /rest/api/3/search/jql` — the legacy\n * `GET /rest/api/3/search` endpoint has been removed. The new endpoint\n * returns only ids unless `fields` is requested explicitly, and pages with\n * an opaque `nextPageToken` cursor (no `startAt`/`total`).\n * - Project listing is `GET /rest/api/3/project/search` with classic\n * `startAt`/`isLast` paging.\n * - Descriptions and comment bodies are ADF documents (see `adf.ts`).\n */\n\nimport type { AdfNode } from './adf.js';\nimport { textToAdf } from './adf.js';\n\nconst JIRA_TIMEOUT_MS = 15_000;\n/** Hosts allowed to receive Basic credentials over plain http (local development mocks). */\nconst LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1']);\n/** Issue page size — Linear parity (`LINEAR_ISSUES_PAGE_SIZE`). */\nexport const JIRA_ISSUES_PAGE_SIZE = 30;\n/** Comment page size — Linear parity (`LINEAR_COMMENTS_PAGE_SIZE`). */\nexport const JIRA_COMMENTS_PAGE_SIZE = 50;\nexport const JIRA_PROJECTS_PAGE_SIZE = 50;\n\n/** Fields requested from issue reads — `search/jql` returns ids only without an explicit list. */\nexport const JIRA_ISSUE_FIELDS = [\n 'summary',\n 'description',\n 'status',\n 'assignee',\n 'reporter',\n 'labels',\n 'priority',\n 'issuetype',\n 'project',\n 'created',\n 'updated',\n] as const;\n\ninterface JiraApiClientBaseConfig {\n /** Jira API base URL, either the Atlassian site or a Platform connection proxy. */\n baseUrl: string;\n fetchImpl?: typeof fetch;\n}\n\nexport type JiraApiClientConfig = JiraApiClientBaseConfig &\n (\n | {\n /** Atlassian account email the API token belongs to. */\n email: string;\n /** API token from id.atlassian.com → Security → API tokens. */\n apiToken: string;\n accessToken?: never;\n }\n | {\n /** Bearer token used when the base URL is a Mastra Platform connection proxy. */\n accessToken: string;\n /**\n * Mastra project id sent as `x-mastra-project-id` so the platform can\n * attribute proxied Jira activity to the project. Falls back to the\n * `MASTRA_PROJECT_ID` environment variable. The platform strips the\n * header before forwarding the request to Atlassian.\n */\n projectId?: string;\n email?: never;\n apiToken?: never;\n }\n );\n\n/** Stable error code the routes/tools surface to the SPA and agents. */\nexport type JiraApiErrorCode = 'jira_auth_failed' | 'jira_request_failed';\n\n/** Normalized Jira API failure carrying the HTTP status and Jira's error detail. */\nexport class JiraApiError extends Error {\n readonly status: number | null;\n readonly code: JiraApiErrorCode;\n\n constructor(message: string, status: number | null) {\n super(message);\n this.name = 'JiraApiError';\n this.status = status;\n this.code = status === 401 || status === 403 ? 'jira_auth_failed' : 'jira_request_failed';\n }\n}\n\nexport interface JiraStatusCategory {\n /** `new` | `indeterminate` | `done` — Jira's fixed status families. */\n key: string;\n name?: string;\n}\n\nexport interface JiraStatus {\n name: string;\n statusCategory?: JiraStatusCategory;\n}\n\nexport interface JiraProject {\n id: string;\n key: string;\n name: string;\n}\n\nexport interface JiraProjectSearchPage {\n values: JiraProject[];\n startAt: number;\n isLast: boolean;\n}\n\nexport interface JiraServerInfo {\n baseUrl: string;\n serverTitle?: string;\n}\n\nexport interface JiraUser {\n displayName: string;\n}\n\nexport interface JiraComment {\n id: string;\n author?: JiraUser | null;\n body?: AdfNode | null;\n created: string;\n}\n\nexport interface JiraCommentPage {\n comments: JiraComment[];\n startAt: number;\n maxResults: number;\n total: number;\n}\n\nexport interface JiraIssueFields {\n summary?: string;\n description?: AdfNode | null;\n status?: JiraStatus;\n assignee?: JiraUser | null;\n reporter?: JiraUser | null;\n labels?: string[];\n priority?: { name: string } | null;\n issuetype?: { name: string };\n project?: { id: string; key: string; name?: string };\n created?: string;\n updated?: string;\n}\n\nexport interface JiraIssue {\n id: string;\n key: string;\n fields: JiraIssueFields;\n}\n\nexport interface JiraSearchPage {\n issues: JiraIssue[];\n /** Opaque cursor for the next page; absent on the last page. */\n nextPageToken?: string | null;\n}\n\nexport interface JiraTransition {\n id: string;\n name: string;\n /** Target status the transition moves the issue to. */\n to?: JiraStatus;\n}\n\nexport class JiraApiClient {\n readonly #baseUrl: string;\n readonly #authHeader: string;\n readonly #projectId: string | null;\n readonly #fetch: typeof fetch;\n\n constructor(config: JiraApiClientConfig) {\n if (!config.baseUrl) {\n throw new Error('JiraApiClient is missing required config: baseUrl.');\n }\n // Fail fast on a malformed base URL: a bare host like `acme.atlassian.net`\n // would otherwise surface later as an opaque `TypeError: Invalid URL`.\n let parsed: URL;\n try {\n parsed = new URL(config.baseUrl);\n } catch {\n throw new Error(`JiraApiClient baseUrl is not an absolute URL: \"${config.baseUrl}\".`);\n }\n if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {\n throw new Error(`JiraApiClient baseUrl must be an http(s) URL: \"${config.baseUrl}\".`);\n }\n if (config.accessToken !== undefined) {\n if (!config.accessToken) {\n throw new Error('JiraApiClient is missing required config: accessToken.');\n }\n this.#authHeader = `Bearer ${config.accessToken}`;\n this.#projectId = (config.projectId ?? process.env.MASTRA_PROJECT_ID)?.trim() || null;\n } else {\n const missing = (['email', 'apiToken'] as const).filter(key => !config[key]);\n if (missing.length > 0) {\n throw new Error(`JiraApiClient is missing required config: ${missing.join(', ')}.`);\n }\n // Basic credentials ride on every request, so never send them over\n // plaintext to a remote host. Loopback stays allowed for local mocks.\n if (parsed.protocol === 'http:' && !LOOPBACK_HOSTS.has(parsed.hostname)) {\n throw new Error('JiraApiClient baseUrl must use https when Basic credentials are configured.');\n }\n this.#authHeader = `Basic ${Buffer.from(`${config.email}:${config.apiToken}`).toString('base64')}`;\n // Direct Atlassian mode: never send Mastra platform headers to Jira itself.\n this.#projectId = null;\n }\n this.#baseUrl = config.baseUrl.replace(/\\/+$/, '');\n this.#fetch = config.fetchImpl ?? globalThis.fetch;\n }\n\n /** Normalized site base URL (no trailing slash) — used for `/browse/<key>` links. */\n get baseUrl(): string {\n return this.#baseUrl;\n }\n\n async #request<T>(\n method: 'GET' | 'POST',\n path: string,\n options: { query?: Record<string, string | number | undefined>; body?: unknown } = {},\n ): Promise<T> {\n const url = new URL(`${this.#baseUrl}${path}`);\n for (const [key, value] of Object.entries(options.query ?? {})) {\n if (value !== undefined) url.searchParams.set(key, String(value));\n }\n const hasBody = options.body !== undefined;\n const res = await this.#fetch(url, {\n method,\n signal: AbortSignal.timeout(JIRA_TIMEOUT_MS),\n headers: {\n authorization: this.#authHeader,\n accept: 'application/json',\n // Project attribution for the Mastra platform proxy; stripped by the\n // platform before the request reaches Atlassian.\n ...(this.#projectId ? { 'x-mastra-project-id': this.#projectId } : {}),\n ...(hasBody ? { 'content-type': 'application/json' } : {}),\n },\n ...(hasBody ? { body: JSON.stringify(options.body) } : {}),\n });\n if (!res.ok) {\n // Jira reports validation failures as `errorMessages` and `errors`;\n // the Platform proxy reports upstream failures through `detail`/`error`/`title`.\n let detail: string | null = null;\n try {\n const errBody = (await res.json()) as {\n errorMessages?: string[];\n errors?: Record<string, string>;\n detail?: string;\n error?: string;\n title?: string;\n };\n detail =\n errBody.errorMessages?.[0] ??\n Object.values(errBody.errors ?? {})[0] ??\n errBody.detail ??\n errBody.error ??\n errBody.title ??\n null;\n } catch {\n // Non-JSON error body; fall back to the status code alone.\n }\n throw new JiraApiError(`Jira API request failed (${res.status})${detail ? `: ${detail}` : ''}`, res.status);\n }\n if (res.status === 204) return undefined as T;\n return (await res.json()) as T;\n }\n\n async getServerInfo(): Promise<JiraServerInfo> {\n return this.#request<JiraServerInfo>('GET', '/rest/api/3/serverInfo');\n }\n\n /** One page of the site's projects (Settings intake-source picker). */\n async listProjects(options: { startAt?: number } = {}): Promise<JiraProjectSearchPage> {\n return this.#request<JiraProjectSearchPage>('GET', '/rest/api/3/project/search', {\n query: { startAt: options.startAt ?? 0, maxResults: JIRA_PROJECTS_PAGE_SIZE },\n });\n }\n\n /** One page of a JQL search with explicitly requested fields. */\n async searchIssues(options: {\n jql: string;\n fields?: readonly string[];\n nextPageToken?: string;\n maxResults?: number;\n }): Promise<JiraSearchPage> {\n return this.#request<JiraSearchPage>('POST', '/rest/api/3/search/jql', {\n body: {\n jql: options.jql,\n fields: [...(options.fields ?? JIRA_ISSUE_FIELDS)],\n maxResults: options.maxResults ?? JIRA_ISSUES_PAGE_SIZE,\n ...(options.nextPageToken ? { nextPageToken: options.nextPageToken } : {}),\n },\n });\n }\n\n /** Full issue detail by key (`ENG-42`) or id. */\n async getIssue(keyOrId: string): Promise<JiraIssue> {\n return this.#request<JiraIssue>('GET', `/rest/api/3/issue/${encodeURIComponent(keyOrId)}`, {\n query: { fields: JIRA_ISSUE_FIELDS.join(',') },\n });\n }\n\n /** One page of an issue's comments (oldest first, Jira default order). */\n async listComments(keyOrId: string, options: { startAt?: number } = {}): Promise<JiraCommentPage> {\n return this.#request<JiraCommentPage>('GET', `/rest/api/3/issue/${encodeURIComponent(keyOrId)}/comment`, {\n query: { startAt: options.startAt ?? 0, maxResults: JIRA_COMMENTS_PAGE_SIZE },\n });\n }\n\n /** Post a plain-text comment (wrapped into a minimal ADF document). */\n async createComment(keyOrId: string, body: string): Promise<JiraComment> {\n return this.#request<JiraComment>('POST', `/rest/api/3/issue/${encodeURIComponent(keyOrId)}/comment`, {\n body: { body: textToAdf(body) },\n });\n }\n\n /** Transitions currently legal for the issue (workflow-dependent). */\n async listTransitions(keyOrId: string): Promise<JiraTransition[]> {\n const data = await this.#request<{ transitions?: JiraTransition[] }>(\n 'GET',\n `/rest/api/3/issue/${encodeURIComponent(keyOrId)}/transitions`,\n );\n return data.transitions ?? [];\n }\n\n /** Apply a transition by id (Jira responds 204 on success). */\n async applyTransition(keyOrId: string, transitionId: string): Promise<void> {\n await this.#request<void>('POST', `/rest/api/3/issue/${encodeURIComponent(keyOrId)}/transitions`, {\n body: { transition: { id: transitionId } },\n });\n }\n}\n"],"mappings":"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"}
|