@codeam/shared 2.61.13 → 2.61.15

package/dist/index.d.mts

@@ -329,6 +329,10 @@ declare function isHeadroomWrappable(agentId: string): boolean;
  */
 type IntegrationId = 'jira' | 'sentry' | 'linear' | 'slack' | 'notion' | 'azure_devops' | 'figma';
 type IntegrationAuthKind = 'oauth_redirect' | 'oauth_device' | 'api_key';
+/** Grouping used by category-driven surfaces (Start-from-Work-Item picker,
+ *  catalog sections). A future tracker integration joins those features with
+ *  ZERO feature code — they resolve sources from the registry by category. */
+type IntegrationCategory = 'tracker' | 'design' | 'comms' | 'docs' | 'observability';
 /**
  * One user-entered field for an `api_key` integration (no browser OAuth — the
  * user pastes credentials directly, e.g. a PAT + an org URL). The mobile form
@@ -367,6 +371,7 @@ interface IntegrationDefinition {
     id: IntegrationId;
     name: string;
     icon: string;
+    category: IntegrationCategory;
     enabled: boolean;
     auth: {
         kind: IntegrationAuthKind;
@@ -422,6 +427,7 @@ declare const INTEGRATION_REGISTRY: Record<IntegrationId, IntegrationDefinition>
 declare function getEnabledIntegrations(): IntegrationDefinition[];
 declare function getIntegration(id: IntegrationId): IntegrationDefinition;
 declare function isKnownIntegrationId(id: string): id is IntegrationId;
+declare function getIntegrationsByCategory(category: IntegrationCategory): IntegrationDefinition[];
 
 /**
  * Agent Toolkits — centralized integration branding catalog.
@@ -456,7 +462,7 @@ interface IntegrationBranding {
     logoSvg: string;
 }
 declare const INTEGRATION_BRANDING: Record<string, IntegrationBranding>;
-declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "trello", "resend", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
+declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "figma", "trello", "resend", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
 declare function getIntegrationBranding(id: string): IntegrationBranding | null;
 
 /**
@@ -1284,4 +1290,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentModel, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand };
+export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentModel, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand };

package/dist/index.d.ts

@@ -329,6 +329,10 @@ declare function isHeadroomWrappable(agentId: string): boolean;
  */
 type IntegrationId = 'jira' | 'sentry' | 'linear' | 'slack' | 'notion' | 'azure_devops' | 'figma';
 type IntegrationAuthKind = 'oauth_redirect' | 'oauth_device' | 'api_key';
+/** Grouping used by category-driven surfaces (Start-from-Work-Item picker,
+ *  catalog sections). A future tracker integration joins those features with
+ *  ZERO feature code — they resolve sources from the registry by category. */
+type IntegrationCategory = 'tracker' | 'design' | 'comms' | 'docs' | 'observability';
 /**
  * One user-entered field for an `api_key` integration (no browser OAuth — the
  * user pastes credentials directly, e.g. a PAT + an org URL). The mobile form
@@ -367,6 +371,7 @@ interface IntegrationDefinition {
     id: IntegrationId;
     name: string;
     icon: string;
+    category: IntegrationCategory;
     enabled: boolean;
     auth: {
         kind: IntegrationAuthKind;
@@ -422,6 +427,7 @@ declare const INTEGRATION_REGISTRY: Record<IntegrationId, IntegrationDefinition>
 declare function getEnabledIntegrations(): IntegrationDefinition[];
 declare function getIntegration(id: IntegrationId): IntegrationDefinition;
 declare function isKnownIntegrationId(id: string): id is IntegrationId;
+declare function getIntegrationsByCategory(category: IntegrationCategory): IntegrationDefinition[];
 
 /**
  * Agent Toolkits — centralized integration branding catalog.
@@ -456,7 +462,7 @@ interface IntegrationBranding {
     logoSvg: string;
 }
 declare const INTEGRATION_BRANDING: Record<string, IntegrationBranding>;
-declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "trello", "resend", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
+declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "figma", "trello", "resend", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
 declare function getIntegrationBranding(id: string): IntegrationBranding | null;
 
 /**
@@ -1284,4 +1290,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentModel, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand };
+export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentModel, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand };

package/dist/index.js

@@ -55,6 +55,7 @@ __export(index_exports, {
   getEnabledIntegrations: () => getEnabledIntegrations,
   getIntegration: () => getIntegration,
   getIntegrationBranding: () => getIntegrationBranding,
+  getIntegrationsByCategory: () => getIntegrationsByCategory,
   getPricing: () => getPricing,
   headroomKindFor: () => headroomKindFor,
   headroomModelPredownloadScript: () => headroomModelPredownloadScript,
@@ -534,6 +535,7 @@ var INTEGRATION_REGISTRY = {
     id: "jira",
     name: "Atlassian",
     icon: "jira",
+    category: "tracker",
     enabled: true,
     auth: {
       kind: "oauth_redirect",
@@ -573,6 +575,7 @@ var INTEGRATION_REGISTRY = {
     id: "sentry",
     name: "Sentry",
     icon: "sentry",
+    category: "observability",
     // LIVE — the Sentry OAuth Application (Confidential) is registered and
     // SENTRY_OAUTH_CLIENT_ID/SECRET/REDIRECT_URI are in Secret Manager
     // (prod+dev). The backend SentryOAuthProvider is config-gated (503 if
@@ -626,6 +629,7 @@ var INTEGRATION_REGISTRY = {
     id: "linear",
     name: "Linear",
     icon: "linear",
+    category: "tracker",
     // LIVE — the Linear OAuth Application (Public + Confidential) is registered
     // and LINEAR_OAUTH_CLIENT_ID/SECRET/REDIRECT_URI are in Secret Manager
     // (prod+dev). The backend LinearOAuthProvider is config-gated (503 if env
@@ -663,6 +667,7 @@ var INTEGRATION_REGISTRY = {
     id: "slack",
     name: "Slack",
     icon: "slack",
+    category: "comms",
     // LIVE — the Slack app (OAuth v2, USER token — the agent acts AS THE USER)
     // is registered and
     // SLACK_OAUTH_CLIENT_ID/SECRET/REDIRECT_URI are in Secret Manager
@@ -717,6 +722,7 @@ var INTEGRATION_REGISTRY = {
     id: "notion",
     name: "Notion",
     icon: "notion",
+    category: "docs",
     // LIVE — the Notion public OAuth integration is registered and
     // NOTION_OAUTH_CLIENT_ID/SECRET/REDIRECT_URI are in Secret Manager
     // (prod+dev). The backend NotionOAuthProvider is config-gated (503 if env
@@ -749,6 +755,7 @@ var INTEGRATION_REGISTRY = {
     id: "azure_devops",
     name: "Azure DevOps",
     icon: "azure_devops",
+    category: "tracker",
     // LIVE — the FIRST api_key (PAT) integration. No OAuth: Azure DevOps OAuth
     // apps are being sunset by Microsoft in favor of Entra ID, and PATs are the
     // native, reliable ADO auth. The user pastes their org URL + a PAT; the
@@ -796,12 +803,12 @@ var INTEGRATION_REGISTRY = {
     id: "figma",
     name: "Figma",
     icon: "figma",
-    // LIVE — the Figma OAuth app (Confidential, both prod+dev redirect URIs)
-    // is registered and FIGMA_OAUTH_CLIENT_ID/SECRET/REDIRECT_URI are in
-    // Secret Manager (prod+dev, created 2026-07-16). The backend
-    // FigmaOAuthProvider is config-gated (503 if env unset) so this is safe
-    // even mid-rollout before the secrets mount.
-    enabled: true,
+    category: "design",
+    // DARK — pending Figma's OAuth-app review approval (submitted 2026-07-16).
+    // Figma OAuth apps do NOT exist publicly until review passes (authorize URL
+    // errors "OAuth app ... doesn't exist"). Backend provider + secrets are
+    // already deployed; flip to true once approved (bead codeagent-m4ix).
+    enabled: false,
     auth: {
       kind: "oauth_redirect",
       // Granular READ-ONLY scopes (legacy `files:read` is deprecated for
@@ -847,6 +854,11 @@ function getIntegration(id) {
 function isKnownIntegrationId(id) {
   return id in INTEGRATION_REGISTRY;
 }
+function getIntegrationsByCategory(category) {
+  return Object.values(INTEGRATION_REGISTRY).filter(
+    (m) => m.category === category && m.enabled
+  );
+}
 
 // src/integrations/branding.ts
 var INTEGRATION_BRANDING = {
@@ -1041,6 +1053,7 @@ var UPCOMING_INTEGRATION_IDS = [
   "gmail",
   "posthog",
   "clickup",
+  "figma",
   "trello",
   "resend",
   "vercel",
@@ -1278,6 +1291,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   getEnabledIntegrations,
   getIntegration,
   getIntegrationBranding,
+  getIntegrationsByCategory,
   getPricing,
   headroomKindFor,
   headroomModelPredownloadScript,