@codeam/shared 2.61.77 → 2.61.78

package/dist/index.d.mts

@@ -720,6 +720,35 @@ interface AgentReviewReport {
     findings?: AgentReviewFinding[];
 }
 
+type RepoStack = 'frontend' | 'backend' | 'fullstack' | 'mobile' | 'unknown';
+/** The Session Tools stack-detection result (wire type, carried by the
+ *  SESSION_STACK_DETECTED event). `source` distinguishes the deterministic
+ *  dependency scan from the agent one-shot fallback. */
+interface RepoStackDetection {
+    stack: RepoStack;
+    /** Integrations the repo's dependencies directly evidence (high confidence). */
+    detected: IntegrationId[];
+    /** Integrations commonly paired with the classified stack, minus `detected`. */
+    recommended: IntegrationId[];
+    source: 'scan' | 'agent';
+}
+/** Exact dependency name → integration (across ecosystems: npm, pip, go, gem…). */
+declare const DEP_TO_INTEGRATION: Record<string, IntegrationId>;
+/** Classify the repo stack from its dependency NAMES. */
+declare function classifyStack(depNames: string[]): RepoStack;
+/** Integrations directly evidenced by the repo's dependencies (deduped, stable order). */
+declare function detectedIntegrationsFromDeps(depNames: string[]): IntegrationId[];
+/** Commonly-paired integrations per classified stack (the curated inference layer). */
+declare const STACK_TO_RECOMMENDED: Record<RepoStack, IntegrationId[]>;
+/**
+ * The deterministic core of Session Tools "Recommended": classify the stack and
+ * combine direct-evidence detections with stack inference. `recommended`
+ * excludes anything already `detected`. Returns `source:'scan'`. When both
+ * `detected` and `recommended` are empty (unrecognized stack), the CLI falls
+ * back to the agent one-shot (B).
+ */
+declare function recommendForDeps(depNames: string[]): RepoStackDetection;
+
 /** Curated skills shipped with the client. Grows over time. */
 type SkillId = 'code-review' | 'resolve-conflicts' | 'spec-driven-development' | 'code-naming';
 /** Delivery rails, twin of IntegrationDelivery's mcp/cliEnv. */
@@ -1571,6 +1600,7 @@ declare const USER_EVENTS: {
     readonly INTEGRATION_LINKED: "integration_linked";
     readonly INTEGRATION_UNLINKED: "integration_unlinked";
     readonly INTEGRATION_CREDENTIAL_INVALID: "integration_credential_invalid";
+    readonly SESSION_INTEGRATIONS_CHANGED: "session_integrations_changed";
     readonly CODERABBIT_PROGRESS: "coderabbit_progress";
     readonly CODERABBIT_STATUS: "coderabbit_status";
     readonly CODERABBIT_REVIEW: "coderabbit_review";
@@ -1595,4 +1625,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 AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, 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 DerivedCredentialSource, 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 PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, SKILL_REGISTRY, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, 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, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isSkillId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, 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, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, 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 PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isSkillId, normalizeAgentId, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.d.ts

@@ -720,6 +720,35 @@ interface AgentReviewReport {
     findings?: AgentReviewFinding[];
 }
 
+type RepoStack = 'frontend' | 'backend' | 'fullstack' | 'mobile' | 'unknown';
+/** The Session Tools stack-detection result (wire type, carried by the
+ *  SESSION_STACK_DETECTED event). `source` distinguishes the deterministic
+ *  dependency scan from the agent one-shot fallback. */
+interface RepoStackDetection {
+    stack: RepoStack;
+    /** Integrations the repo's dependencies directly evidence (high confidence). */
+    detected: IntegrationId[];
+    /** Integrations commonly paired with the classified stack, minus `detected`. */
+    recommended: IntegrationId[];
+    source: 'scan' | 'agent';
+}
+/** Exact dependency name → integration (across ecosystems: npm, pip, go, gem…). */
+declare const DEP_TO_INTEGRATION: Record<string, IntegrationId>;
+/** Classify the repo stack from its dependency NAMES. */
+declare function classifyStack(depNames: string[]): RepoStack;
+/** Integrations directly evidenced by the repo's dependencies (deduped, stable order). */
+declare function detectedIntegrationsFromDeps(depNames: string[]): IntegrationId[];
+/** Commonly-paired integrations per classified stack (the curated inference layer). */
+declare const STACK_TO_RECOMMENDED: Record<RepoStack, IntegrationId[]>;
+/**
+ * The deterministic core of Session Tools "Recommended": classify the stack and
+ * combine direct-evidence detections with stack inference. `recommended`
+ * excludes anything already `detected`. Returns `source:'scan'`. When both
+ * `detected` and `recommended` are empty (unrecognized stack), the CLI falls
+ * back to the agent one-shot (B).
+ */
+declare function recommendForDeps(depNames: string[]): RepoStackDetection;
+
 /** Curated skills shipped with the client. Grows over time. */
 type SkillId = 'code-review' | 'resolve-conflicts' | 'spec-driven-development' | 'code-naming';
 /** Delivery rails, twin of IntegrationDelivery's mcp/cliEnv. */
@@ -1571,6 +1600,7 @@ declare const USER_EVENTS: {
     readonly INTEGRATION_LINKED: "integration_linked";
     readonly INTEGRATION_UNLINKED: "integration_unlinked";
     readonly INTEGRATION_CREDENTIAL_INVALID: "integration_credential_invalid";
+    readonly SESSION_INTEGRATIONS_CHANGED: "session_integrations_changed";
     readonly CODERABBIT_PROGRESS: "coderabbit_progress";
     readonly CODERABBIT_STATUS: "coderabbit_status";
     readonly CODERABBIT_REVIEW: "coderabbit_review";
@@ -1595,4 +1625,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 AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, 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 DerivedCredentialSource, 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 PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, SKILL_REGISTRY, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, 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, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isSkillId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, 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, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, 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 PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isSkillId, normalizeAgentId, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.js

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   AGENT_REGISTRY: () => AGENT_REGISTRY,
   DEFAULT_API_BASE_URL: () => DEFAULT_API_BASE_URL,
+  DEP_TO_INTEGRATION: () => DEP_TO_INTEGRATION,
   DEV_API_BASE_URL: () => DEV_API_BASE_URL,
   HEADROOM_BACKEND_ENV: () => HEADROOM_BACKEND_ENV,
   HEADROOM_EXTRAS_BY_SURFACE: () => HEADROOM_EXTRAS_BY_SURFACE,
@@ -46,10 +47,13 @@ __export(index_exports, {
   PUBLIC_TO_INTERNAL: () => PUBLIC_TO_INTERNAL,
   SKILL_REGISTRY: () => SKILL_REGISTRY,
   SSE_SOCKET_TIMEOUT_MS: () => SSE_SOCKET_TIMEOUT_MS,
+  STACK_TO_RECOMMENDED: () => STACK_TO_RECOMMENDED,
   TERMINAL_AGENT_PREFIX: () => TERMINAL_AGENT_PREFIX,
   UNKNOWN_MODEL_PRICING: () => UNKNOWN_MODEL_PRICING,
   UPCOMING_INTEGRATION_IDS: () => UPCOMING_INTEGRATION_IDS,
   USER_EVENTS: () => USER_EVENTS,
+  classifyStack: () => classifyStack,
+  detectedIntegrationsFromDeps: () => detectedIntegrationsFromDeps,
   getAgent: () => getAgent,
   getContextWindow: () => getContextWindow,
   getEnabledAgents: () => getEnabledAgents,
@@ -72,6 +76,7 @@ __export(index_exports, {
   isSkillId: () => isSkillId,
   normalizeAgentId: () => normalizeAgentId,
   publicToInternal: () => publicToInternal,
+  recommendForDeps: () => recommendForDeps,
   renderToLines: () => renderToLines,
   resolveApiBaseUrl: () => resolveApiBaseUrl,
   skillHasRail: () => skillHasRail,
@@ -1978,6 +1983,145 @@ function getIntegrationBranding(id) {
   return INTEGRATION_BRANDING[id] ?? null;
 }
 
+// src/integrations/stack-detect.ts
+var DEP_TO_INTEGRATION = {
+  // errors / observability
+  "@sentry/node": "sentry",
+  "@sentry/react": "sentry",
+  "@sentry/nextjs": "sentry",
+  "@sentry/browser": "sentry",
+  "sentry-sdk": "sentry",
+  "dd-trace": "datadog",
+  "datadog-api-client": "datadog",
+  "datadog-metrics": "datadog",
+  // analytics
+  "posthog-js": "posthog",
+  "posthog-node": "posthog",
+  posthog: "posthog",
+  mixpanel: "mixpanel",
+  "mixpanel-browser": "mixpanel",
+  // database / backend platforms
+  convex: "convex",
+  "@supabase/supabase-js": "supabase",
+  "supabase": "supabase",
+  // infra / deploy
+  vercel: "vercel",
+  "@vercel/node": "vercel",
+  wrangler: "cloudflare",
+  // comms
+  "@slack/web-api": "slack",
+  "@slack/bolt": "slack",
+  "discord.js": "discord",
+  "discord-py": "discord",
+  "discord": "discord",
+  // trackers / docs / design
+  "@linear/sdk": "linear",
+  "@notionhq/client": "notion",
+  "jira.js": "jira",
+  jira: "jira",
+  newman: "postman",
+  "figma-api": "figma",
+  "figma-js": "figma",
+  // email / automation
+  resend: "resend",
+  n8n: "n8n"
+};
+var DEP_PREFIX_TO_INTEGRATION = [
+  ["@sentry/", "sentry"],
+  ["@vercel/", "vercel"],
+  ["@cloudflare/", "cloudflare"],
+  ["@supabase/", "supabase"],
+  ["@slack/", "slack"],
+  ["@datadog/", "datadog"],
+  ["@linear/", "linear"],
+  ["@notionhq/", "notion"]
+];
+var FRONTEND_MARKERS = [
+  "react",
+  "react-dom",
+  "next",
+  "vue",
+  "nuxt",
+  "@angular/core",
+  "svelte",
+  "@sveltejs/kit",
+  "solid-js",
+  "astro",
+  "gatsby",
+  "remix",
+  "@remix-run/react"
+];
+var MOBILE_MARKERS = ["react-native", "expo", "@react-native/core", "@ionic/core", "flutter"];
+var BACKEND_MARKERS = [
+  "express",
+  "fastify",
+  "@nestjs/core",
+  "koa",
+  "@hapi/hapi",
+  "django",
+  "flask",
+  "fastapi",
+  "rails",
+  "sinatra",
+  "gin-gonic",
+  "laravel/framework",
+  "actix-web",
+  "spring-boot"
+];
+function hasAny(deps, markers) {
+  for (const m of markers) if (deps.has(m)) return true;
+  return false;
+}
+function classifyStack(depNames) {
+  const deps = new Set(depNames);
+  const mobile = hasAny(deps, MOBILE_MARKERS);
+  if (mobile) return "mobile";
+  const frontend = hasAny(deps, FRONTEND_MARKERS);
+  const backend = hasAny(deps, BACKEND_MARKERS);
+  if (frontend && backend) return "fullstack";
+  if (frontend) return "frontend";
+  if (backend) return "backend";
+  return "unknown";
+}
+function detectedIntegrationsFromDeps(depNames) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  const push = (id) => {
+    if (!seen.has(id)) {
+      seen.add(id);
+      out.push(id);
+    }
+  };
+  for (const name of depNames) {
+    const exact = DEP_TO_INTEGRATION[name];
+    if (exact) {
+      push(exact);
+      continue;
+    }
+    for (const [prefix, id] of DEP_PREFIX_TO_INTEGRATION) {
+      if (name.startsWith(prefix)) {
+        push(id);
+        break;
+      }
+    }
+  }
+  return out;
+}
+var STACK_TO_RECOMMENDED = {
+  frontend: ["figma", "sentry", "posthog", "vercel"],
+  backend: ["sentry", "datadog", "supabase", "convex", "cloudflare"],
+  fullstack: ["sentry", "posthog", "vercel", "supabase", "convex"],
+  mobile: ["sentry", "posthog"],
+  unknown: []
+};
+function recommendForDeps(depNames) {
+  const stack = classifyStack(depNames);
+  const detected = detectedIntegrationsFromDeps(depNames);
+  const detectedSet = new Set(detected);
+  const recommended = STACK_TO_RECOMMENDED[stack].filter((id) => !detectedSet.has(id));
+  return { stack, detected, recommended, source: "scan" };
+}
+
 // src/skills/code-review.ts
 var CODE_REVIEW_BODY = `Use this skill when reviewing a pull request. It defines what a high-signal
 review looks like so your inline comments are worth the author's time.
@@ -2412,6 +2556,14 @@ var USER_EVENTS = {
   INTEGRATION_LINKED: "integration_linked",
   INTEGRATION_UNLINKED: "integration_unlinked",
   INTEGRATION_CREDENTIAL_INVALID: "integration_credential_invalid",
+  // Session Tools — add/remove Agent Toolkit integrations on an ALREADY-ACTIVE
+  // session. The backend publishes SESSION_INTEGRATIONS_CHANGED after it persists
+  // the new attached set + relays `integrations_sync` to the box (the CLI rewrites
+  // the manifest + reprovisions the live agent, answered synchronously via the
+  // command result). Drives live UI on the sending device AND any other paired
+  // device on the same session. Mirrored in repo A. (`integrations_detect` is a
+  // pure request/response over the relay — no event.)
+  SESSION_INTEGRATIONS_CHANGED: "session_integrations_changed",
   // CodeRabbit reviewer — the CLI posts these to /api/coderabbit/events; the
   // backend re-publishes them on the per-user SSE bus (mirrored in repo A).
   CODERABBIT_PROGRESS: "coderabbit_progress",
@@ -2478,6 +2630,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
 0 && (module.exports = {
   AGENT_REGISTRY,
   DEFAULT_API_BASE_URL,
+  DEP_TO_INTEGRATION,
   DEV_API_BASE_URL,
   HEADROOM_BACKEND_ENV,
   HEADROOM_EXTRAS_BY_SURFACE,
@@ -2502,10 +2655,13 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   PUBLIC_TO_INTERNAL,
   SKILL_REGISTRY,
   SSE_SOCKET_TIMEOUT_MS,
+  STACK_TO_RECOMMENDED,
   TERMINAL_AGENT_PREFIX,
   UNKNOWN_MODEL_PRICING,
   UPCOMING_INTEGRATION_IDS,
   USER_EVENTS,
+  classifyStack,
+  detectedIntegrationsFromDeps,
   getAgent,
   getContextWindow,
   getEnabledAgents,
@@ -2528,6 +2684,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   isSkillId,
   normalizeAgentId,
   publicToInternal,
+  recommendForDeps,
   renderToLines,
   resolveApiBaseUrl,
   skillHasRail,