@anyshift/backstage-plugin-anyshift 0.1.0-beta.2 → 0.1.0-beta.20

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Changelog
 
+## Unreleased
+
+## 0.1.0-beta.16
+
+- Retry unresolved cloud-change evidence with the provider-native ARN while keeping the stable
+  catalog identity and existing entity URLs unchanged.
+
+## 0.1.0-beta.15
+
+- Resolve Affected footprint entries against one Backstage catalog snapshot and link only entities
+  that are proven to exist.
+- Repair stale runtime-namespace links, de-duplicate logical names, and keep unresolved graph
+  evidence visible as plain text instead of dead links.
+
+## 0.1.0-beta.14
+
+- Expose available APM HTTP methods and templated paths from service `CALLS_TO` edges through a compact architecture-diagram affordance and source-grouped evidence inspector.
+- Keep missing operation or observation metadata explicitly unknown without changing legacy edge rendering or adding per-edge Graph API requests.
+
+## 0.1.0-beta.13
+
+- Keep zero-event cloud-resource pages quiet: identity-completeness codes do not become alerts
+  without a returned event, while source and status limits remain one evidence caveat.
+
+## 0.1.0-beta.12
+
+- Render cloud Resources through shared Cloud and Anyshift evidence cards, with direct catalog
+  dependencies, typed potential impact, cloud changes, IaC evidence, and ARN-scoped Ask.
+- Keep cloud evidence separate from workload/Kubernetes safeguards and make absent catalog, change,
+  IaC, or impact evidence explicitly unknown rather than healthy.
+
+## 0.1.0-beta.11
+
+- Add one reusable Ask Anyshift card to the estate dashboard and supported entity pages.
+- Render bounded typed evidence, visible entity scope, effective interpretation, uncertainty, and safe error states.
+- Keep viewer Ask availability independent from operator-only Advanced Query.
+
+## 0.1.0-beta.10
+
+- Render why-now evidence immediately after the entity overview without claiming causality.
+- Link affected service footprints to related Backstage catalog entities.
+- Add estate evidence coverage, blind spots, freshness, and scoped retry to the Anyshift dashboard.
+
+## 0.1.0-beta.9
+
+- Render configured callers and dependencies separately from observed APM traffic.
+- Resolve ECS configuration evidence through a dedicated runtime identity annotation.
+
+## 0.1.0-beta.8
+
+- Render cloud evidence timestamps with bracketed time-zone identifiers without
+  displaying `Invalid Date`.
+- Preserve unrecognized timestamp evidence as its original value instead of
+  inventing a time.
+
+## 0.1.0-beta.7
+
+- Load normalized cloud changes, Terraform provenance, and drift evidence on cloud Resource pages.
+- Resolve stable Anyshift resource identity before provider-native ARN fallback.
+- Preserve successful evidence sections across partial upstream failures and render unknown drift neutrally.
+
+## 0.1.0-beta.6
+
+- Add a discoverable global Cloud inventory page.
+- Add generic cloud Resource content with identity, ownership, relations, ARN, and console links.
+
+## 0.1.0-beta.5
+
+- Hide entity content for catalog resources without a supported Anyshift brief kind.
+- Preserve the default workload view for GitHub-owned Components.
+
+## 0.1.0-beta.3
+
+- Show durable catalog reconciliation status on the global dashboard.
+- Add a permission-aware **Reconcile now** operator action.
+
 ## 0.1.0-beta.2
 
 - Coordinate the frontend package with the trusted catalog synchronization beta.

package/README.md

@@ -2,7 +2,20 @@
 
 New-frontend-system plugin for the Anyshift infrastructure graph. Installing the package in an app
 created with `@backstage/frontend-defaults` and configured with `app.packages: all` discovers its
-dashboard, navigation item, API factory, and entity content automatically.
+dashboard, Cloud inventory page, navigation items, API factory, and entity content automatically.
+
+The Cloud page lists provider-managed infrastructure Resources with searchable type, account,
+region, and ownership metadata. Cloud Resource entities receive read-only normalized change,
+Terraform provenance, and drift evidence alongside their stable identity, provider console link,
+and catalog relationships. Evidence sections degrade independently, and an unknown drift verdict
+is not presented as drift.
+
+When `anyshift.ask.enabled` is true, the same Ask Anyshift card appears on the estate dashboard and
+supported entity pages for every viewer with `anyshift.view`. It is a single-question experience,
+not a chat history. Entity scope is visible and removable, and the effective `For <target>: ...`
+interpretation is shown with each answer. Typed presenters render only supported evidence; missing
+timestamps and missing evidence remain explicitly unknown. Advanced Query stays independently
+controlled by `anyshift.query.enabled` and `anyshift.query`.
 
 The package has no legacy frontend entry point. Add the corresponding
 `@anyshift/backstage-plugin-anyshift-backend` package to the Backstage backend and configure one

package/dist/api/AnyshiftApi.esm.js

@@ -3,6 +3,18 @@ import { createApiRef } from '@backstage/frontend-plugin-api';
 const anyshiftApiRef = createApiRef({
   id: "plugin.anyshift.service"
 });
+class AnyshiftRequestError extends Error {
+  constructor(status, code, message, retryAfterSeconds) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.retryAfterSeconds = retryAfterSeconds;
+    this.name = "AnyshiftRequestError";
+  }
+  status;
+  code;
+  retryAfterSeconds;
+}
 class AnyshiftClient {
   discoveryApi;
   fetchApi;
@@ -10,6 +22,13 @@ class AnyshiftClient {
     this.discoveryApi = options.discoveryApi;
     this.fetchApi = options.fetchApi;
   }
+  async ask(request) {
+    return this.request("/ask", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(request)
+    });
+  }
   async capabilities() {
     return this.get("/capabilities");
   }
@@ -27,12 +46,22 @@ class AnyshiftClient {
       )}/sections/${encodeURIComponent(section)}${briefQuery(options)}`
     );
   }
-  async insights() {
-    return this.get("/insights");
+  async insights(options = {}) {
+    return this.get(`/insights${options.refresh ? "?refresh=1" : ""}`);
   }
   async datadogSignals(options = {}) {
     return this.get(`/signals/datadog${options.refresh ? "?refresh=1" : ""}`);
   }
+  async cloudResourceBrief(resource, options = {}) {
+    const params = new URLSearchParams({ resource });
+    if (options.fallbackResource)
+      params.set("fallbackResource", options.fallbackResource);
+    if (options.since) params.set("since", options.since);
+    if (options.cursor) params.set("cursor", options.cursor);
+    if (options.diff !== void 0) params.set("diff", String(options.diff));
+    if (options.refresh) params.set("refresh", "1");
+    return this.get(`/cloud/resources/brief?${params}`);
+  }
   async inventory(type, options = {}) {
     const params = new URLSearchParams({ type });
     if (options.limit !== void 0) params.set("limit", String(options.limit));
@@ -47,11 +76,14 @@ class AnyshiftClient {
       body: JSON.stringify({ sql })
     });
   }
+  async reconcileCatalog() {
+    return this.request("/anyshift/reconcile", { method: "POST" }, "catalog");
+  }
   async get(path) {
     return this.request(path, { method: "GET" });
   }
-  async request(path, init) {
-    const baseUrl = await this.discoveryApi.getBaseUrl("anyshift");
+  async request(path, init, pluginId = "anyshift") {
+    const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);
     const response = await this.fetchApi.fetch(`${baseUrl}${path}`, init);
     const text = await response.text();
     let payload;
@@ -61,20 +93,42 @@ class AnyshiftClient {
       payload = {};
     }
     if (!response.ok) {
-      throw new Error(
-        payload?.error?.message || `Anyshift request failed (${response.status})`
+      const error = errorEnvelope(payload);
+      throw new AnyshiftRequestError(
+        response.status,
+        error.code,
+        error.message ?? `Anyshift request failed (${response.status})`,
+        error.retryAfterSeconds
       );
     }
     return payload;
   }
 }
+function errorEnvelope(payload) {
+  const error = payload && typeof payload === "object" && "error" in payload ? payload.error : void 0;
+  if (!error || typeof error !== "object") {
+    return { code: "request_failed" };
+  }
+  const { code, message, retryAfterSeconds } = error;
+  return {
+    code: typeof code === "string" ? code : "request_failed",
+    message: typeof message === "string" && message ? message : void 0,
+    retryAfterSeconds: typeof retryAfterSeconds === "number" && Number.isFinite(retryAfterSeconds) ? retryAfterSeconds : void 0
+  };
+}
 function briefQuery(options) {
   const params = new URLSearchParams();
   if (options.namespace) params.set("namespace", options.namespace);
   if (options.refresh) params.set("refresh", "1");
+  if (options.configurationEndpoints)
+    params.set("configurationEndpoints", options.configurationEndpoints);
+  if (options.configurationDependencies)
+    params.set("configurationDependencies", options.configurationDependencies);
+  if (options.configurationTarget)
+    params.set("configurationTarget", options.configurationTarget);
   const query = params.toString();
   return query ? `?${query}` : "";
 }
 
-export { AnyshiftClient, anyshiftApiRef };
+export { AnyshiftClient, AnyshiftRequestError, anyshiftApiRef };
 //# sourceMappingURL=AnyshiftApi.esm.js.map

package/dist/api/AnyshiftApi.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"AnyshiftApi.esm.js","sources":["../../src/api/AnyshiftApi.ts"],"sourcesContent":["import {\n  createApiRef,\n  type DiscoveryApi,\n  type FetchApi,\n} from '@backstage/frontend-plugin-api';\nimport type {\n  BriefSectionName,\n  BriefSectionResponse,\n  AnyshiftCapabilities,\n  CatalogSummary,\n  DatadogSignals,\n  EstateInsights,\n  QueryResult,\n  ServiceBrief,\n} from './types';\n\nexport interface AnyshiftApi {\n  capabilities(): Promise<AnyshiftCapabilities>;\n  brief(\n    kind: string,\n    target: string,\n    options?: BriefRequestOptions,\n  ): Promise<ServiceBrief>;\n  briefSection(\n    kind: string,\n    target: string,\n    section: BriefSectionName,\n    options?: BriefRequestOptions,\n  ): Promise<BriefSectionResponse>;\n  insights(): Promise<EstateInsights>;\n  datadogSignals(options?: { refresh?: boolean }): Promise<DatadogSignals>;\n  inventory(\n    type: string,\n    options?: { limit?: number; offset?: number },\n  ): Promise<CatalogSummary>;\n  query(sql: string): Promise<QueryResult>;\n}\n\nexport interface BriefRequestOptions {\n  namespace?: string;\n  refresh?: boolean;\n}\n\nexport const anyshiftApiRef = createApiRef<AnyshiftApi>({\n  id: 'plugin.anyshift.service',\n});\n\nexport class AnyshiftClient implements AnyshiftApi {\n  private readonly discoveryApi: DiscoveryApi;\n  private readonly fetchApi: FetchApi;\n\n  constructor(options: { discoveryApi: DiscoveryApi; fetchApi: FetchApi }) {\n    this.discoveryApi = options.discoveryApi;\n    this.fetchApi = options.fetchApi;\n  }\n\n  async capabilities(): Promise<AnyshiftCapabilities> {\n    return this.get('/capabilities');\n  }\n\n  async brief(\n    kind: string,\n    target: string,\n    options: BriefRequestOptions = {},\n  ): Promise<ServiceBrief> {\n    return this.get(\n      `/brief/${encodeURIComponent(kind)}/${encodeURIComponent(\n        target,\n      )}${briefQuery(options)}`,\n    );\n  }\n\n  async briefSection(\n    kind: string,\n    target: string,\n    section: BriefSectionName,\n    options: BriefRequestOptions = {},\n  ): Promise<BriefSectionResponse> {\n    return this.get(\n      `/brief/${encodeURIComponent(kind)}/${encodeURIComponent(\n        target,\n      )}/sections/${encodeURIComponent(section)}${briefQuery(options)}`,\n    );\n  }\n\n  async insights(): Promise<EstateInsights> {\n    return this.get('/insights');\n  }\n\n  async datadogSignals(\n    options: { refresh?: boolean } = {},\n  ): Promise<DatadogSignals> {\n    return this.get(`/signals/datadog${options.refresh ? '?refresh=1' : ''}`);\n  }\n\n  async inventory(\n    type: string,\n    options: { limit?: number; offset?: number } = {},\n  ): Promise<CatalogSummary> {\n    const params = new URLSearchParams({ type });\n    if (options.limit !== undefined) params.set('limit', String(options.limit));\n    if (options.offset !== undefined)\n      params.set('offset', String(options.offset));\n    return this.get(`/inventory?${params}`);\n  }\n\n  async query(sql: string): Promise<QueryResult> {\n    return this.request('/query', {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ sql }),\n    });\n  }\n\n  private async get<T>(path: string): Promise<T> {\n    return this.request(path, { method: 'GET' });\n  }\n\n  private async request<T>(path: string, init: RequestInit): Promise<T> {\n    const baseUrl = await this.discoveryApi.getBaseUrl('anyshift');\n    const response = await this.fetchApi.fetch(`${baseUrl}${path}`, init);\n    const text = await response.text();\n    let payload: any;\n    try {\n      payload = text ? JSON.parse(text) : {};\n    } catch {\n      payload = {};\n    }\n    if (!response.ok) {\n      throw new Error(\n        payload?.error?.message ||\n          `Anyshift request failed (${response.status})`,\n      );\n    }\n    return payload as T;\n  }\n}\n\nfunction briefQuery(options: BriefRequestOptions): string {\n  const params = new URLSearchParams();\n  if (options.namespace) params.set('namespace', options.namespace);\n  if (options.refresh) params.set('refresh', '1');\n  const query = params.toString();\n  return query ? `?${query}` : '';\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"AnyshiftApi.esm.js","sources":["../../src/api/AnyshiftApi.ts"],"sourcesContent":["import {\n  createApiRef,\n  type DiscoveryApi,\n  type FetchApi,\n} from '@backstage/frontend-plugin-api';\nimport type {\n  BriefSectionName,\n  BriefSectionResponse,\n  AnyshiftCapabilities,\n  AskAnyshiftRequest,\n  AskAnyshiftResponse,\n  CatalogSummary,\n  CatalogSyncReport,\n  CloudResourceBrief,\n  DatadogSignals,\n  EstateInsights,\n  QueryResult,\n  ServiceBrief,\n} from './types';\n\nexport interface AnyshiftApi {\n  ask(request: AskAnyshiftRequest): Promise<AskAnyshiftResponse>;\n  capabilities(): Promise<AnyshiftCapabilities>;\n  brief(\n    kind: string,\n    target: string,\n    options?: BriefRequestOptions,\n  ): Promise<ServiceBrief>;\n  briefSection(\n    kind: string,\n    target: string,\n    section: BriefSectionName,\n    options?: BriefRequestOptions,\n  ): Promise<BriefSectionResponse>;\n  insights(options?: { refresh?: boolean }): Promise<EstateInsights>;\n  datadogSignals(options?: { refresh?: boolean }): Promise<DatadogSignals>;\n  cloudResourceBrief(\n    resource: string,\n    options?: CloudResourceBriefRequestOptions,\n  ): Promise<CloudResourceBrief>;\n  inventory(\n    type: string,\n    options?: { limit?: number; offset?: number },\n  ): Promise<CatalogSummary>;\n  query(sql: string): Promise<QueryResult>;\n  reconcileCatalog(): Promise<CatalogSyncAccepted>;\n}\n\nexport interface BriefRequestOptions {\n  namespace?: string;\n  refresh?: boolean;\n  configurationEndpoints?: string;\n  configurationDependencies?: string;\n  configurationTarget?: string;\n}\n\nexport interface CloudResourceBriefRequestOptions {\n  fallbackResource?: string;\n  since?: string;\n  cursor?: string;\n  diff?: boolean;\n  refresh?: boolean;\n}\n\nexport interface CatalogSyncAccepted {\n  accepted: true;\n  acceptedAt: string;\n  previous?: CatalogSyncReport;\n}\n\nexport const anyshiftApiRef = createApiRef<AnyshiftApi>({\n  id: 'plugin.anyshift.service',\n});\n\nexport class AnyshiftRequestError extends Error {\n  constructor(\n    readonly status: number,\n    readonly code: string,\n    message: string,\n    readonly retryAfterSeconds?: number,\n  ) {\n    super(message);\n    this.name = 'AnyshiftRequestError';\n  }\n}\n\nexport class AnyshiftClient implements AnyshiftApi {\n  private readonly discoveryApi: DiscoveryApi;\n  private readonly fetchApi: FetchApi;\n\n  constructor(options: { discoveryApi: DiscoveryApi; fetchApi: FetchApi }) {\n    this.discoveryApi = options.discoveryApi;\n    this.fetchApi = options.fetchApi;\n  }\n\n  async ask(request: AskAnyshiftRequest): Promise<AskAnyshiftResponse> {\n    return this.request('/ask', {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify(request),\n    });\n  }\n\n  async capabilities(): Promise<AnyshiftCapabilities> {\n    return this.get('/capabilities');\n  }\n\n  async brief(\n    kind: string,\n    target: string,\n    options: BriefRequestOptions = {},\n  ): Promise<ServiceBrief> {\n    return this.get(\n      `/brief/${encodeURIComponent(kind)}/${encodeURIComponent(\n        target,\n      )}${briefQuery(options)}`,\n    );\n  }\n\n  async briefSection(\n    kind: string,\n    target: string,\n    section: BriefSectionName,\n    options: BriefRequestOptions = {},\n  ): Promise<BriefSectionResponse> {\n    return this.get(\n      `/brief/${encodeURIComponent(kind)}/${encodeURIComponent(\n        target,\n      )}/sections/${encodeURIComponent(section)}${briefQuery(options)}`,\n    );\n  }\n\n  async insights(options: { refresh?: boolean } = {}): Promise<EstateInsights> {\n    return this.get(`/insights${options.refresh ? '?refresh=1' : ''}`);\n  }\n\n  async datadogSignals(\n    options: { refresh?: boolean } = {},\n  ): Promise<DatadogSignals> {\n    return this.get(`/signals/datadog${options.refresh ? '?refresh=1' : ''}`);\n  }\n\n  async cloudResourceBrief(\n    resource: string,\n    options: CloudResourceBriefRequestOptions = {},\n  ): Promise<CloudResourceBrief> {\n    const params = new URLSearchParams({ resource });\n    if (options.fallbackResource)\n      params.set('fallbackResource', options.fallbackResource);\n    if (options.since) params.set('since', options.since);\n    if (options.cursor) params.set('cursor', options.cursor);\n    if (options.diff !== undefined) params.set('diff', String(options.diff));\n    if (options.refresh) params.set('refresh', '1');\n    return this.get(`/cloud/resources/brief?${params}`);\n  }\n\n  async inventory(\n    type: string,\n    options: { limit?: number; offset?: number } = {},\n  ): Promise<CatalogSummary> {\n    const params = new URLSearchParams({ type });\n    if (options.limit !== undefined) params.set('limit', String(options.limit));\n    if (options.offset !== undefined)\n      params.set('offset', String(options.offset));\n    return this.get(`/inventory?${params}`);\n  }\n\n  async query(sql: string): Promise<QueryResult> {\n    return this.request('/query', {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ sql }),\n    });\n  }\n\n  async reconcileCatalog(): Promise<CatalogSyncAccepted> {\n    return this.request('/anyshift/reconcile', { method: 'POST' }, 'catalog');\n  }\n\n  private async get<T>(path: string): Promise<T> {\n    return this.request(path, { method: 'GET' });\n  }\n\n  private async request<T>(\n    path: string,\n    init: RequestInit,\n    pluginId = 'anyshift',\n  ): Promise<T> {\n    const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);\n    const response = await this.fetchApi.fetch(`${baseUrl}${path}`, init);\n    const text = await response.text();\n    let payload: unknown;\n    try {\n      payload = text ? JSON.parse(text) : {};\n    } catch {\n      payload = {};\n    }\n    if (!response.ok) {\n      const error = errorEnvelope(payload);\n      throw new AnyshiftRequestError(\n        response.status,\n        error.code,\n        error.message ?? `Anyshift request failed (${response.status})`,\n        error.retryAfterSeconds,\n      );\n    }\n    return payload as T;\n  }\n}\n\nfunction errorEnvelope(payload: unknown): {\n  code: string;\n  message?: string;\n  retryAfterSeconds?: number;\n} {\n  const error =\n    payload && typeof payload === 'object' && 'error' in payload\n      ? (payload as { error?: unknown }).error\n      : undefined;\n  if (!error || typeof error !== 'object') {\n    return { code: 'request_failed' };\n  }\n\n  const { code, message, retryAfterSeconds } = error as {\n    code?: unknown;\n    message?: unknown;\n    retryAfterSeconds?: unknown;\n  };\n  return {\n    code: typeof code === 'string' ? code : 'request_failed',\n    message: typeof message === 'string' && message ? message : undefined,\n    retryAfterSeconds:\n      typeof retryAfterSeconds === 'number' &&\n      Number.isFinite(retryAfterSeconds)\n        ? retryAfterSeconds\n        : undefined,\n  };\n}\n\nfunction briefQuery(options: BriefRequestOptions): string {\n  const params = new URLSearchParams();\n  if (options.namespace) params.set('namespace', options.namespace);\n  if (options.refresh) params.set('refresh', '1');\n  if (options.configurationEndpoints)\n    params.set('configurationEndpoints', options.configurationEndpoints);\n  if (options.configurationDependencies)\n    params.set('configurationDependencies', options.configurationDependencies);\n  if (options.configurationTarget)\n    params.set('configurationTarget', options.configurationTarget);\n  const query = params.toString();\n  return query ? `?${query}` : '';\n}\n"],"names":[],"mappings":"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"}

package/dist/components/ask/AskAnyshiftCard.esm.js

@@ -0,0 +1,348 @@
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { Card, CardContent, Typography, Box, Chip, Button, TextField, CircularProgress } from '@material-ui/core';
+import { useApi } from '@backstage/frontend-plugin-api';
+import { useRef, useState, useLayoutEffect } from 'react';
+import { anyshiftApiRef, AnyshiftRequestError } from '../../api/AnyshiftApi.esm.js';
+import { scopedSuggestions, estateSuggestions, followUpsForIntent } from './askSuggestions.esm.js';
+import { presentAskResult, AskResultPresenter } from './askPresenters.esm.js';
+
+const MAX_QUESTION_CODE_POINTS = 500;
+const MAX_SCOPE_TARGET_CODE_POINTS = 200;
+const IDLE_HELPER_TEXT = "Read-only answers from your connected graph. Do not include secrets.";
+const AskAnyshiftCard = ({
+  context,
+  scope,
+  scopeLabel
+}) => {
+  const api = useApi(anyshiftApiRef);
+  const validPropScope = context === "entity" && isValidScope(scope) ? scope : void 0;
+  const propScopeIdentity = context === "entity" && scope?.entityRef.trim() ? scope.entityRef : void 0;
+  const mountedIdentity = context === "estate" ? "estate" : `entity:${propScopeIdentity ?? ""}`;
+  const previousMountedIdentity = useRef(mountedIdentity);
+  const requestGeneration = useRef(0);
+  const activeRequest = useRef();
+  const [question, setQuestion] = useState("");
+  const [validationError, setValidationError] = useState();
+  const [state, setState] = useState({ status: "idle" });
+  const [scopeRemoved, setScopeRemoved] = useState(false);
+  const localScope = scopeRemoved ? void 0 : validPropScope;
+  const restorableScope = validPropScope;
+  const visibleScopeLabel = scopeLabel?.trim() || localScope?.target;
+  const restorableScopeLabel = scopeLabel?.trim() || restorableScope?.target;
+  const requestContext = requestContextKey(
+    context,
+    propScopeIdentity,
+    localScope
+  );
+  const previousRequestContext = useRef(requestContext);
+  useLayoutEffect(() => {
+    if (previousMountedIdentity.current === mountedIdentity) return;
+    previousMountedIdentity.current = mountedIdentity;
+    requestGeneration.current += 1;
+    activeRequest.current = void 0;
+    setState({ status: "idle" });
+    setValidationError(void 0);
+    setScopeRemoved(false);
+  }, [mountedIdentity]);
+  useLayoutEffect(() => {
+    if (previousRequestContext.current === requestContext) return;
+    previousRequestContext.current = requestContext;
+    requestGeneration.current += 1;
+    if (!activeRequest.current) return;
+    activeRequest.current = void 0;
+    setState(
+      (current) => current.status === "loading" ? { status: "idle" } : current
+    );
+    setValidationError(void 0);
+  }, [requestContext]);
+  const loading = state.status === "loading";
+  const examples = localScope ? scopedSuggestions : estateSuggestions;
+  const visibleAnswer = answerForState(state);
+  const previousAnswer = state.status === "loading" || state.status === "error" ? state.previous : void 0;
+  const submitQuestion = async (explicitQuestion = question) => {
+    if (activeRequest.current?.requestContext === requestContext) return;
+    const clientError = validateQuestion(explicitQuestion);
+    if (clientError) {
+      setValidationError(clientError);
+      return;
+    }
+    setValidationError(void 0);
+    const generation = requestGeneration.current + 1;
+    requestGeneration.current = generation;
+    activeRequest.current = { generation, requestContext };
+    const previous = visibleAnswer;
+    setState({ status: "loading", previous });
+    try {
+      const request = localScope ? { question: explicitQuestion, scope: localScope } : { question: explicitQuestion };
+      const answer = await api.ask(request);
+      if (ownsActiveRequest(activeRequest.current, generation, requestContext)) {
+        setState({ status: "success", answer });
+      }
+    } catch (error) {
+      if (ownsActiveRequest(activeRequest.current, generation, requestContext)) {
+        setState({
+          status: "error",
+          error: safeRequestError(error),
+          previous
+        });
+      }
+    } finally {
+      if (ownsActiveRequest(activeRequest.current, generation, requestContext)) {
+        activeRequest.current = void 0;
+      }
+    }
+  };
+  const submitExplicitQuestion = (nextQuestion) => {
+    if (activeRequest.current?.requestContext === requestContext) return;
+    setQuestion(nextQuestion);
+    void submitQuestion(nextQuestion);
+  };
+  const onSubmit = (event) => {
+    event.preventDefault();
+    void submitQuestion();
+  };
+  const onQuestionKeyDown = (event) => {
+    if (event.key !== "Enter" || !event.metaKey && !event.ctrlKey) return;
+    event.preventDefault();
+    void submitQuestion();
+  };
+  return /* @__PURE__ */ jsx(Card, { variant: "outlined", children: /* @__PURE__ */ jsxs(CardContent, { children: [
+    /* @__PURE__ */ jsx(Typography, { component: "h2", variant: "h6", gutterBottom: true, children: "Ask Anyshift" }),
+    context === "entity" && /* @__PURE__ */ jsx(
+      Box,
+      {
+        mb: 2,
+        display: "flex",
+        alignItems: "center",
+        flexWrap: "wrap",
+        gridGap: 8,
+        children: localScope ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(
+            Chip,
+            {
+              size: "small",
+              color: "primary",
+              variant: "outlined",
+              label: `Scope \xB7 ${visibleScopeLabel}`
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            Button,
+            {
+              type: "button",
+              size: "small",
+              disabled: loading,
+              onClick: () => setScopeRemoved(true),
+              "aria-label": `Remove ${visibleScopeLabel} scope`,
+              children: "Remove"
+            }
+          )
+        ] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(Typography, { variant: "body2", color: "textSecondary", children: "Searching the whole connected project" }),
+          restorableScope && /* @__PURE__ */ jsx(
+            Button,
+            {
+              type: "button",
+              size: "small",
+              disabled: loading,
+              onClick: () => setScopeRemoved(false),
+              "aria-label": `Restore ${restorableScopeLabel} scope`,
+              children: "Restore scope"
+            }
+          )
+        ] })
+      }
+    ),
+    /* @__PURE__ */ jsxs("form", { onSubmit, noValidate: true, children: [
+      /* @__PURE__ */ jsx(
+        TextField,
+        {
+          id: "ask-anyshift-question",
+          label: "Question",
+          value: question,
+          onChange: (event) => {
+            setQuestion(event.target.value);
+            if (validationError) setValidationError(void 0);
+          },
+          onKeyDown: onQuestionKeyDown,
+          disabled: loading,
+          error: Boolean(validationError),
+          helperText: validationError ?? IDLE_HELPER_TEXT,
+          multiline: true,
+          minRows: 2,
+          fullWidth: true,
+          variant: "outlined"
+        }
+      ),
+      /* @__PURE__ */ jsx(Box, { mt: 1, display: "flex", justifyContent: "flex-end", children: /* @__PURE__ */ jsx(
+        Button,
+        {
+          type: "submit",
+          color: "primary",
+          variant: "contained",
+          disabled: loading,
+          startIcon: loading ? /* @__PURE__ */ jsx(CircularProgress, { size: 16 }) : void 0,
+          children: loading ? "Asking\u2026" : "Ask"
+        }
+      ) })
+    ] }),
+    /* @__PURE__ */ jsx(
+      QuestionChoices,
+      {
+        title: "Try an example",
+        questions: examples,
+        disabled: loading,
+        onQuestion: submitExplicitQuestion
+      }
+    ),
+    state.status === "error" && /* @__PURE__ */ jsxs(Box, { mt: 2, role: "alert", "aria-live": "polite", children: [
+      /* @__PURE__ */ jsx(Typography, { color: "error", children: errorCopy(state.error) }),
+      isRetryable(state.error) && /* @__PURE__ */ jsx(Box, { mt: 1, children: /* @__PURE__ */ jsx(
+        Button,
+        {
+          type: "button",
+          size: "small",
+          variant: "outlined",
+          onClick: () => void submitQuestion(),
+          children: "Retry"
+        }
+      ) })
+    ] }),
+    loading && /* @__PURE__ */ jsx(Typography, { role: "status", variant: "body2", color: "textSecondary", children: "Searching the connected graph\u2026" }),
+    visibleAnswer && /* @__PURE__ */ jsxs(Box, { mt: 3, children: [
+      previousAnswer && /* @__PURE__ */ jsx(Typography, { component: "h3", variant: "subtitle2", gutterBottom: true, children: "Previous answer" }),
+      /* @__PURE__ */ jsx(
+        SafeAnswer,
+        {
+          answer: visibleAnswer,
+          onQuestion: loading ? void 0 : submitExplicitQuestion
+        }
+      ),
+      !loading && /* @__PURE__ */ jsx(
+        QuestionChoices,
+        {
+          title: "Ask another question",
+          questions: followUpsForIntent(
+            visibleAnswer.result.intent,
+            Boolean(localScope)
+          ),
+          disabled: false,
+          onQuestion: submitExplicitQuestion
+        }
+      )
+    ] })
+  ] }) });
+};
+const QuestionChoices = ({
+  title,
+  questions,
+  disabled,
+  onQuestion
+}) => /* @__PURE__ */ jsxs(Box, { mt: 2, children: [
+  /* @__PURE__ */ jsx(Typography, { variant: "subtitle2", gutterBottom: true, children: title }),
+  /* @__PURE__ */ jsx(Box, { display: "flex", flexWrap: "wrap", gridGap: 8, children: questions.map((suggestion) => /* @__PURE__ */ jsx(
+    Button,
+    {
+      type: "button",
+      size: "small",
+      variant: "outlined",
+      disabled,
+      onClick: () => onQuestion(suggestion),
+      children: suggestion
+    },
+    suggestion
+  )) })
+] });
+const SafeAnswer = ({
+  answer,
+  onQuestion
+}) => {
+  try {
+    presentAskResult(answer.result);
+  } catch {
+    return /* @__PURE__ */ jsxs(Box, { "aria-label": "Anyshift answer", children: [
+      /* @__PURE__ */ jsx(Typography, { variant: "body1", children: answer.result.summary }),
+      /* @__PURE__ */ jsx(Typography, { variant: "body2", color: "textSecondary", children: "Detailed evidence is not supported by this Backstage version." })
+    ] });
+  }
+  return /* @__PURE__ */ jsx(
+    AskResultPresenter,
+    {
+      result: answer.result,
+      effectiveQuestion: answer.effectiveQuestion,
+      answeredAt: answer.answeredAt,
+      onQuestion
+    }
+  );
+};
+function answerForState(state) {
+  switch (state.status) {
+    case "success":
+      return state.answer;
+    case "loading":
+    case "error":
+      return state.previous;
+    case "idle":
+      return void 0;
+    default:
+      return assertNever(state);
+  }
+}
+function ownsActiveRequest(activeRequest, generation, requestContext) {
+  return activeRequest?.generation === generation && activeRequest.requestContext === requestContext;
+}
+function requestContextKey(context, entityRef, scope) {
+  if (context === "estate") return "estate";
+  const identity = entityRef?.trim() ?? "";
+  return scope ? `entity:${identity}:target:${scope.target.trim()}` : `entity:${identity}:unscoped`;
+}
+function validateQuestion(value) {
+  if (!value.trim()) return "Enter a question.";
+  if (Array.from(value).length > MAX_QUESTION_CODE_POINTS) {
+    return "Questions must be 500 characters or fewer.";
+  }
+  return void 0;
+}
+function isValidScope(scope) {
+  if (!scope?.entityRef.trim() || !scope.target.trim()) return false;
+  if (Array.from(scope.target).length > MAX_SCOPE_TARGET_CODE_POINTS) {
+    return false;
+  }
+  return !Array.from(scope.target).some((character) => {
+    const codePoint = character.codePointAt(0);
+    return codePoint !== void 0 && (codePoint <= 31 || codePoint >= 127 && codePoint <= 159);
+  });
+}
+function safeRequestError(error) {
+  return error instanceof AnyshiftRequestError ? error : new AnyshiftRequestError(0, "unavailable", "Unavailable");
+}
+function errorCopy(error) {
+  if (error.status === 400 || error.code === "bad_request") {
+    return "Ask Anyshift could not answer that question. Try rephrasing it or choose an example.";
+  }
+  if (error.status === 403 || error.code === "forbidden") {
+    return "Ask Anyshift access is unavailable for your account.";
+  }
+  if (error.status === 413 || error.code === "payload_too_large") {
+    return "Questions must be 500 characters or fewer.";
+  }
+  if (error.status === 429 || error.code === "rate_limited") {
+    return typeof error.retryAfterSeconds === "number" ? `Ask Anyshift is temporarily rate limited. Try again in ${error.retryAfterSeconds} seconds.` : "Ask Anyshift is temporarily rate limited. Try again shortly.";
+  }
+  if (error.status === 504 || error.code === "timeout") {
+    return "The graph question timed out. Try again.";
+  }
+  if (error.status === 0 || error.status === 502 || error.status === 503 || error.code === "unavailable" || error.code === "upstream_unavailable" || error.code === "request_failed") {
+    return "Ask Anyshift is temporarily unavailable. Try again.";
+  }
+  return "Ask Anyshift could not complete the question. Try again.";
+}
+function isRetryable(error) {
+  return error.status === 0 || error.status === 429 || error.status === 502 || error.status === 503 || error.status === 504 || error.code === "timeout" || error.code === "unavailable" || error.code === "upstream_unavailable" || error.code === "request_failed";
+}
+function assertNever(value) {
+  throw new Error(`Unsupported Ask card state: ${String(value)}`);
+}
+
+export { AskAnyshiftCard };
+//# sourceMappingURL=AskAnyshiftCard.esm.js.map