@shipfox/client-onboarding 22.0.2 → 23.0.0

package/dist/workspace-setup-route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-setup-route.d.ts","sourceRoot":"","sources":["../src/workspace-setup-route.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACzB,MAAM,+BAA+B,CAAC;AAMvC,YAAY,EAAC,0BAA0B,EAAC,MAAM,+BAA+B,CAAC;AAE9E,wBAAsB,uBAAuB,CAAC,EAC5C,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,GACT,EAAE,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsE3D"}
+{"version":3,"file":"workspace-setup-route.d.ts","sourceRoot":"","sources":["../src/workspace-setup-route.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACzB,MAAM,+BAA+B,CAAC;AAMvC,YAAY,EAAC,0BAA0B,EAAC,MAAM,+BAA+B,CAAC;AAE9E,wBAAsB,uBAAuB,CAAC,EAC5C,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,GACT,EAAE,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsE3D"}

package/dist/workspace-setup-route.js

@@ -1,4 +1,4 @@
-import { isModelProviderOnboardingDismissed, modelProviderConfigsQueryOptions } from '@shipfox/client-agent';
+import { isModelProviderOnboardingDismissed, modelProviderCatalogQueryOptions, modelProviderConfigsQueryOptions } from '@shipfox/client-agent';
 import { sourceConnectionsQueryOptions } from '@shipfox/client-integrations';
 import { projectExistenceQueryOptions } from '@shipfox/client-projects';
 import { userWorkspacesQueryOptions, WorkspaceSetupLoadError } from '@shipfox/client-shell/runtime';
@@ -118,14 +118,21 @@ async function fetchWorkspaceSourceConnections(queryClient, workspaceId) {
 }
 async function hasHandledModelProviderOnboarding(queryClient, workspaceId) {
     if (isModelProviderOnboardingDismissed(workspaceId)) return true;
-    const options = modelProviderConfigsQueryOptions(workspaceId);
-    try {
-        const configs = await queryClient.fetchQuery(options);
+    const catalogOptions = modelProviderCatalogQueryOptions();
+    const configOptions = modelProviderConfigsQueryOptions(workspaceId);
+    const [catalogResult, configsResult] = await Promise.allSettled([
+        queryClient.fetchQuery(catalogOptions),
+        queryClient.fetchQuery(configOptions)
+    ]);
+    if (catalogResult.status === 'fulfilled' && catalogResult.value.workspaceProviders === 'disabled') {
+        return true;
+    }
+    if (configsResult.status === 'fulfilled') {
+        const configs = configsResult.value;
         return configs.configs.length > 0;
-    } catch  {
-        const cached = queryClient.getQueryData(options.queryKey);
-        return cached?.configs.length !== 0;
     }
+    const cached = queryClient.getQueryData(configOptions.queryKey);
+    return cached?.configs.length !== 0;
 }
 function normalizePath(pathname) {
     if (pathname === '/') return pathname;

package/dist/workspace-setup-route.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/workspace-setup-route.ts"],"sourcesContent":["import {\n  isModelProviderOnboardingDismissed,\n  modelProviderConfigsQueryOptions,\n} from '@shipfox/client-agent';\nimport {\n  type IntegrationConnection,\n  sourceConnectionsQueryOptions,\n} from '@shipfox/client-integrations';\nimport {projectExistenceQueryOptions} from '@shipfox/client-projects';\nimport {\n  userWorkspacesQueryOptions,\n  WorkspaceSetupLoadError,\n  type WorkspaceSetupRouteOptions,\n  type WorkspaceSetupState,\n} from '@shipfox/client-shell/runtime';\nimport type {QueryClient} from '@tanstack/react-query';\nimport {redirect} from '@tanstack/react-router';\n\nconst TRAILING_SLASHES_RE = /\\/+$/u;\n\nexport type {WorkspaceSetupRouteOptions} from '@shipfox/client-shell/runtime';\n\nexport async function loadWorkspaceSetupRoute({\n  queryClient,\n  workspaceId,\n  workspaceSlug,\n  pathname,\n}: WorkspaceSetupRouteOptions): Promise<WorkspaceSetupState> {\n  const workspace = await fetchWorkspaceSummary(queryClient, workspaceId);\n  const workspaceStatus = workspace?.status;\n  switch (workspaceStatus) {\n    case undefined:\n    case 'active':\n      break;\n    case 'suspended':\n    case 'deleted':\n      return {hideProjectNavigation: true, unavailable: true};\n    default:\n      return assertNever(workspaceStatus);\n  }\n\n  const projects = await fetchWorkspaceProjectExistence(queryClient, workspaceId);\n  const normalizedPathname = normalizePath(pathname);\n\n  if (projects.projects.length > 0) {\n    if (isIntegrationsIndexPath(normalizedPathname, workspaceSlug)) {\n      throw redirect({\n        to: '/w/$workspaceSlug/settings/integrations',\n        params: {workspaceSlug},\n        replace: true,\n      });\n    }\n\n    return {hideProjectNavigation: false};\n  }\n\n  const sourceConnections = await fetchWorkspaceSourceConnections(queryClient, workspaceId);\n  const hasSourceConnection = sourceConnections.length > 0;\n\n  if (!hasSourceConnection) {\n    if (isIntegrationSetupPath(normalizedPathname, workspaceSlug)) {\n      return {hideProjectNavigation: true};\n    }\n\n    throw redirect({\n      to: '/w/$workspaceSlug/integrations',\n      params: {workspaceSlug},\n      replace: true,\n    });\n  }\n\n  if (isAgentSettingsPath(normalizedPathname, workspaceSlug)) {\n    return {hideProjectNavigation: true};\n  }\n\n  const providerHandled = await hasHandledModelProviderOnboarding(queryClient, workspaceId);\n  if (!providerHandled) {\n    if (isModelProviderOnboardingPath(normalizedPathname, workspaceSlug)) {\n      return {hideProjectNavigation: true};\n    }\n\n    throw redirect({\n      to: '/w/$workspaceSlug/model-provider',\n      params: {workspaceSlug},\n      replace: true,\n    });\n  }\n\n  if (isProjectCreationPath(normalizedPathname, workspaceSlug)) {\n    return {hideProjectNavigation: true};\n  }\n\n  throw redirect({\n    to: '/w/$workspaceSlug/projects/new',\n    params: {workspaceSlug},\n    replace: true,\n  });\n}\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unhandled workspace status: ${JSON.stringify(value)}`);\n}\n\nasync function fetchWorkspaceSummary(queryClient: QueryClient, workspaceId: string) {\n  try {\n    const result = await queryClient.fetchQuery(userWorkspacesQueryOptions());\n    return result.memberships.find((workspace) => workspace.id === workspaceId);\n  } catch (error) {\n    throw new WorkspaceSetupLoadError(error);\n  }\n}\n\nasync function fetchWorkspaceProjectExistence(queryClient: QueryClient, workspaceId: string) {\n  const options = projectExistenceQueryOptions(workspaceId);\n\n  try {\n    return await queryClient.fetchQuery(options);\n  } catch (error) {\n    const cached = queryClient.getQueryData<{projects: unknown[]}>(options.queryKey);\n    if (cached !== undefined) return cached;\n    throw new WorkspaceSetupLoadError(error);\n  }\n}\n\nasync function fetchWorkspaceSourceConnections(queryClient: QueryClient, workspaceId: string) {\n  const options = sourceConnectionsQueryOptions(workspaceId);\n\n  try {\n    return await queryClient.fetchQuery(options);\n  } catch (error) {\n    const cached = queryClient.getQueryData<IntegrationConnection[]>(options.queryKey);\n    if (cached !== undefined) return cached;\n    throw new WorkspaceSetupLoadError(error);\n  }\n}\n\nasync function hasHandledModelProviderOnboarding(\n  queryClient: QueryClient,\n  workspaceId: string,\n): Promise<boolean> {\n  if (isModelProviderOnboardingDismissed(workspaceId)) return true;\n\n  const options = modelProviderConfigsQueryOptions(workspaceId);\n  try {\n    const configs = await queryClient.fetchQuery(options);\n    return configs.configs.length > 0;\n  } catch {\n    const cached = queryClient.getQueryData<{configs: unknown[]}>(options.queryKey);\n    return cached?.configs.length !== 0;\n  }\n}\n\nfunction normalizePath(pathname: string) {\n  if (pathname === '/') return pathname;\n  return pathname.replace(TRAILING_SLASHES_RE, '');\n}\n\nfunction workspacePath(workspaceSlug: string, suffix: string) {\n  return `/w/${workspaceSlug}${suffix}`;\n}\n\nfunction isIntegrationsIndexPath(pathname: string, workspaceSlug: string) {\n  return pathname === workspacePath(workspaceSlug, '/integrations');\n}\n\nfunction isIntegrationSetupPath(pathname: string, workspaceSlug: string) {\n  const basePath = workspacePath(workspaceSlug, '/integrations');\n  return (\n    pathname === basePath ||\n    pathname.startsWith(`${basePath}/`) ||\n    pathname === workspacePath(workspaceSlug, '/settings/integrations')\n  );\n}\n\nfunction isProjectCreationPath(pathname: string, workspaceSlug: string) {\n  return pathname === workspacePath(workspaceSlug, '/projects/new');\n}\n\nfunction isModelProviderOnboardingPath(pathname: string, workspaceSlug: string) {\n  return pathname === workspacePath(workspaceSlug, '/model-provider');\n}\n\nfunction isAgentSettingsPath(pathname: string, workspaceSlug: string) {\n  return pathname === workspacePath(workspaceSlug, '/settings/agents');\n}\n"],"names":["isModelProviderOnboardingDismissed","modelProviderConfigsQueryOptions","sourceConnectionsQueryOptions","projectExistenceQueryOptions","userWorkspacesQueryOptions","WorkspaceSetupLoadError","redirect","TRAILING_SLASHES_RE","loadWorkspaceSetupRoute","queryClient","workspaceId","workspaceSlug","pathname","workspace","fetchWorkspaceSummary","workspaceStatus","status","undefined","hideProjectNavigation","unavailable","assertNever","projects","fetchWorkspaceProjectExistence","normalizedPathname","normalizePath","length","isIntegrationsIndexPath","to","params","replace","sourceConnections","fetchWorkspaceSourceConnections","hasSourceConnection","isIntegrationSetupPath","isAgentSettingsPath","providerHandled","hasHandledModelProviderOnboarding","isModelProviderOnboardingPath","isProjectCreationPath","value","Error","JSON","stringify","result","fetchQuery","memberships","find","id","error","options","cached","getQueryData","queryKey","configs","workspacePath","suffix","basePath","startsWith"],"mappings":"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"}
+{"version":3,"sources":["../src/workspace-setup-route.ts"],"sourcesContent":["import {\n  isModelProviderOnboardingDismissed,\n  modelProviderCatalogQueryOptions,\n  modelProviderConfigsQueryOptions,\n} from '@shipfox/client-agent';\nimport {\n  type IntegrationConnection,\n  sourceConnectionsQueryOptions,\n} from '@shipfox/client-integrations';\nimport {projectExistenceQueryOptions} from '@shipfox/client-projects';\nimport {\n  userWorkspacesQueryOptions,\n  WorkspaceSetupLoadError,\n  type WorkspaceSetupRouteOptions,\n  type WorkspaceSetupState,\n} from '@shipfox/client-shell/runtime';\nimport type {QueryClient} from '@tanstack/react-query';\nimport {redirect} from '@tanstack/react-router';\n\nconst TRAILING_SLASHES_RE = /\\/+$/u;\n\nexport type {WorkspaceSetupRouteOptions} from '@shipfox/client-shell/runtime';\n\nexport async function loadWorkspaceSetupRoute({\n  queryClient,\n  workspaceId,\n  workspaceSlug,\n  pathname,\n}: WorkspaceSetupRouteOptions): Promise<WorkspaceSetupState> {\n  const workspace = await fetchWorkspaceSummary(queryClient, workspaceId);\n  const workspaceStatus = workspace?.status;\n  switch (workspaceStatus) {\n    case undefined:\n    case 'active':\n      break;\n    case 'suspended':\n    case 'deleted':\n      return {hideProjectNavigation: true, unavailable: true};\n    default:\n      return assertNever(workspaceStatus);\n  }\n\n  const projects = await fetchWorkspaceProjectExistence(queryClient, workspaceId);\n  const normalizedPathname = normalizePath(pathname);\n\n  if (projects.projects.length > 0) {\n    if (isIntegrationsIndexPath(normalizedPathname, workspaceSlug)) {\n      throw redirect({\n        to: '/w/$workspaceSlug/settings/integrations',\n        params: {workspaceSlug},\n        replace: true,\n      });\n    }\n\n    return {hideProjectNavigation: false};\n  }\n\n  const sourceConnections = await fetchWorkspaceSourceConnections(queryClient, workspaceId);\n  const hasSourceConnection = sourceConnections.length > 0;\n\n  if (!hasSourceConnection) {\n    if (isIntegrationSetupPath(normalizedPathname, workspaceSlug)) {\n      return {hideProjectNavigation: true};\n    }\n\n    throw redirect({\n      to: '/w/$workspaceSlug/integrations',\n      params: {workspaceSlug},\n      replace: true,\n    });\n  }\n\n  if (isAgentSettingsPath(normalizedPathname, workspaceSlug)) {\n    return {hideProjectNavigation: true};\n  }\n\n  const providerHandled = await hasHandledModelProviderOnboarding(queryClient, workspaceId);\n  if (!providerHandled) {\n    if (isModelProviderOnboardingPath(normalizedPathname, workspaceSlug)) {\n      return {hideProjectNavigation: true};\n    }\n\n    throw redirect({\n      to: '/w/$workspaceSlug/model-provider',\n      params: {workspaceSlug},\n      replace: true,\n    });\n  }\n\n  if (isProjectCreationPath(normalizedPathname, workspaceSlug)) {\n    return {hideProjectNavigation: true};\n  }\n\n  throw redirect({\n    to: '/w/$workspaceSlug/projects/new',\n    params: {workspaceSlug},\n    replace: true,\n  });\n}\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unhandled workspace status: ${JSON.stringify(value)}`);\n}\n\nasync function fetchWorkspaceSummary(queryClient: QueryClient, workspaceId: string) {\n  try {\n    const result = await queryClient.fetchQuery(userWorkspacesQueryOptions());\n    return result.memberships.find((workspace) => workspace.id === workspaceId);\n  } catch (error) {\n    throw new WorkspaceSetupLoadError(error);\n  }\n}\n\nasync function fetchWorkspaceProjectExistence(queryClient: QueryClient, workspaceId: string) {\n  const options = projectExistenceQueryOptions(workspaceId);\n\n  try {\n    return await queryClient.fetchQuery(options);\n  } catch (error) {\n    const cached = queryClient.getQueryData<{projects: unknown[]}>(options.queryKey);\n    if (cached !== undefined) return cached;\n    throw new WorkspaceSetupLoadError(error);\n  }\n}\n\nasync function fetchWorkspaceSourceConnections(queryClient: QueryClient, workspaceId: string) {\n  const options = sourceConnectionsQueryOptions(workspaceId);\n\n  try {\n    return await queryClient.fetchQuery(options);\n  } catch (error) {\n    const cached = queryClient.getQueryData<IntegrationConnection[]>(options.queryKey);\n    if (cached !== undefined) return cached;\n    throw new WorkspaceSetupLoadError(error);\n  }\n}\n\nasync function hasHandledModelProviderOnboarding(\n  queryClient: QueryClient,\n  workspaceId: string,\n): Promise<boolean> {\n  if (isModelProviderOnboardingDismissed(workspaceId)) return true;\n\n  const catalogOptions = modelProviderCatalogQueryOptions();\n  const configOptions = modelProviderConfigsQueryOptions(workspaceId);\n  const [catalogResult, configsResult] = await Promise.allSettled([\n    queryClient.fetchQuery(catalogOptions),\n    queryClient.fetchQuery(configOptions),\n  ]);\n\n  if (\n    catalogResult.status === 'fulfilled' &&\n    catalogResult.value.workspaceProviders === 'disabled'\n  ) {\n    return true;\n  }\n\n  if (configsResult.status === 'fulfilled') {\n    const configs = configsResult.value;\n    return configs.configs.length > 0;\n  }\n\n  const cached = queryClient.getQueryData<{configs: unknown[]}>(configOptions.queryKey);\n  return cached?.configs.length !== 0;\n}\n\nfunction normalizePath(pathname: string) {\n  if (pathname === '/') return pathname;\n  return pathname.replace(TRAILING_SLASHES_RE, '');\n}\n\nfunction workspacePath(workspaceSlug: string, suffix: string) {\n  return `/w/${workspaceSlug}${suffix}`;\n}\n\nfunction isIntegrationsIndexPath(pathname: string, workspaceSlug: string) {\n  return pathname === workspacePath(workspaceSlug, '/integrations');\n}\n\nfunction isIntegrationSetupPath(pathname: string, workspaceSlug: string) {\n  const basePath = workspacePath(workspaceSlug, '/integrations');\n  return (\n    pathname === basePath ||\n    pathname.startsWith(`${basePath}/`) ||\n    pathname === workspacePath(workspaceSlug, '/settings/integrations')\n  );\n}\n\nfunction isProjectCreationPath(pathname: string, workspaceSlug: string) {\n  return pathname === workspacePath(workspaceSlug, '/projects/new');\n}\n\nfunction isModelProviderOnboardingPath(pathname: string, workspaceSlug: string) {\n  return pathname === workspacePath(workspaceSlug, '/model-provider');\n}\n\nfunction isAgentSettingsPath(pathname: string, workspaceSlug: string) {\n  return pathname === workspacePath(workspaceSlug, '/settings/agents');\n}\n"],"names":["isModelProviderOnboardingDismissed","modelProviderCatalogQueryOptions","modelProviderConfigsQueryOptions","sourceConnectionsQueryOptions","projectExistenceQueryOptions","userWorkspacesQueryOptions","WorkspaceSetupLoadError","redirect","TRAILING_SLASHES_RE","loadWorkspaceSetupRoute","queryClient","workspaceId","workspaceSlug","pathname","workspace","fetchWorkspaceSummary","workspaceStatus","status","undefined","hideProjectNavigation","unavailable","assertNever","projects","fetchWorkspaceProjectExistence","normalizedPathname","normalizePath","length","isIntegrationsIndexPath","to","params","replace","sourceConnections","fetchWorkspaceSourceConnections","hasSourceConnection","isIntegrationSetupPath","isAgentSettingsPath","providerHandled","hasHandledModelProviderOnboarding","isModelProviderOnboardingPath","isProjectCreationPath","value","Error","JSON","stringify","result","fetchQuery","memberships","find","id","error","options","cached","getQueryData","queryKey","catalogOptions","configOptions","catalogResult","configsResult","Promise","allSettled","workspaceProviders","configs","workspacePath","suffix","basePath","startsWith"],"mappings":"AAAA,SACEA,kCAAkC,EAClCC,gCAAgC,EAChCC,gCAAgC,QAC3B,wBAAwB;AAC/B,SAEEC,6BAA6B,QACxB,+BAA+B;AACtC,SAAQC,4BAA4B,QAAO,2BAA2B;AACtE,SACEC,0BAA0B,EAC1BC,uBAAuB,QAGlB,gCAAgC;AAEvC,SAAQC,QAAQ,QAAO,yBAAyB;AAEhD,MAAMC,sBAAsB;AAI5B,OAAO,eAAeC,wBAAwB,EAC5CC,WAAW,EACXC,WAAW,EACXC,aAAa,EACbC,QAAQ,EACmB;IAC3B,MAAMC,YAAY,MAAMC,sBAAsBL,aAAaC;IAC3D,MAAMK,kBAAkBF,WAAWG;IACnC,OAAQD;QACN,KAAKE;QACL,KAAK;YACH;QACF,KAAK;QACL,KAAK;YACH,OAAO;gBAACC,uBAAuB;gBAAMC,aAAa;YAAI;QACxD;YACE,OAAOC,YAAYL;IACvB;IAEA,MAAMM,WAAW,MAAMC,+BAA+Bb,aAAaC;IACnE,MAAMa,qBAAqBC,cAAcZ;IAEzC,IAAIS,SAASA,QAAQ,CAACI,MAAM,GAAG,GAAG;QAChC,IAAIC,wBAAwBH,oBAAoBZ,gBAAgB;YAC9D,MAAML,SAAS;gBACbqB,IAAI;gBACJC,QAAQ;oBAACjB;gBAAa;gBACtBkB,SAAS;YACX;QACF;QAEA,OAAO;YAACX,uBAAuB;QAAK;IACtC;IAEA,MAAMY,oBAAoB,MAAMC,gCAAgCtB,aAAaC;IAC7E,MAAMsB,sBAAsBF,kBAAkBL,MAAM,GAAG;IAEvD,IAAI,CAACO,qBAAqB;QACxB,IAAIC,uBAAuBV,oBAAoBZ,gBAAgB;YAC7D,OAAO;gBAACO,uBAAuB;YAAI;QACrC;QAEA,MAAMZ,SAAS;YACbqB,IAAI;YACJC,QAAQ;gBAACjB;YAAa;YACtBkB,SAAS;QACX;IACF;IAEA,IAAIK,oBAAoBX,oBAAoBZ,gBAAgB;QAC1D,OAAO;YAACO,uBAAuB;QAAI;IACrC;IAEA,MAAMiB,kBAAkB,MAAMC,kCAAkC3B,aAAaC;IAC7E,IAAI,CAACyB,iBAAiB;QACpB,IAAIE,8BAA8Bd,oBAAoBZ,gBAAgB;YACpE,OAAO;gBAACO,uBAAuB;YAAI;QACrC;QAEA,MAAMZ,SAAS;YACbqB,IAAI;YACJC,QAAQ;gBAACjB;YAAa;YACtBkB,SAAS;QACX;IACF;IAEA,IAAIS,sBAAsBf,oBAAoBZ,gBAAgB;QAC5D,OAAO;YAACO,uBAAuB;QAAI;IACrC;IAEA,MAAMZ,SAAS;QACbqB,IAAI;QACJC,QAAQ;YAACjB;QAAa;QACtBkB,SAAS;IACX;AACF;AAEA,SAAST,YAAYmB,KAAY;IAC/B,MAAM,IAAIC,MAAM,CAAC,4BAA4B,EAAEC,KAAKC,SAAS,CAACH,QAAQ;AACxE;AAEA,eAAezB,sBAAsBL,WAAwB,EAAEC,WAAmB;IAChF,IAAI;QACF,MAAMiC,SAAS,MAAMlC,YAAYmC,UAAU,CAACxC;QAC5C,OAAOuC,OAAOE,WAAW,CAACC,IAAI,CAAC,CAACjC,YAAcA,UAAUkC,EAAE,KAAKrC;IACjE,EAAE,OAAOsC,OAAO;QACd,MAAM,IAAI3C,wBAAwB2C;IACpC;AACF;AAEA,eAAe1B,+BAA+Bb,WAAwB,EAAEC,WAAmB;IACzF,MAAMuC,UAAU9C,6BAA6BO;IAE7C,IAAI;QACF,OAAO,MAAMD,YAAYmC,UAAU,CAACK;IACtC,EAAE,OAAOD,OAAO;QACd,MAAME,SAASzC,YAAY0C,YAAY,CAAwBF,QAAQG,QAAQ;QAC/E,IAAIF,WAAWjC,WAAW,OAAOiC;QACjC,MAAM,IAAI7C,wBAAwB2C;IACpC;AACF;AAEA,eAAejB,gCAAgCtB,WAAwB,EAAEC,WAAmB;IAC1F,MAAMuC,UAAU/C,8BAA8BQ;IAE9C,IAAI;QACF,OAAO,MAAMD,YAAYmC,UAAU,CAACK;IACtC,EAAE,OAAOD,OAAO;QACd,MAAME,SAASzC,YAAY0C,YAAY,CAA0BF,QAAQG,QAAQ;QACjF,IAAIF,WAAWjC,WAAW,OAAOiC;QACjC,MAAM,IAAI7C,wBAAwB2C;IACpC;AACF;AAEA,eAAeZ,kCACb3B,WAAwB,EACxBC,WAAmB;IAEnB,IAAIX,mCAAmCW,cAAc,OAAO;IAE5D,MAAM2C,iBAAiBrD;IACvB,MAAMsD,gBAAgBrD,iCAAiCS;IACvD,MAAM,CAAC6C,eAAeC,cAAc,GAAG,MAAMC,QAAQC,UAAU,CAAC;QAC9DjD,YAAYmC,UAAU,CAACS;QACvB5C,YAAYmC,UAAU,CAACU;KACxB;IAED,IACEC,cAAcvC,MAAM,KAAK,eACzBuC,cAAchB,KAAK,CAACoB,kBAAkB,KAAK,YAC3C;QACA,OAAO;IACT;IAEA,IAAIH,cAAcxC,MAAM,KAAK,aAAa;QACxC,MAAM4C,UAAUJ,cAAcjB,KAAK;QACnC,OAAOqB,QAAQA,OAAO,CAACnC,MAAM,GAAG;IAClC;IAEA,MAAMyB,SAASzC,YAAY0C,YAAY,CAAuBG,cAAcF,QAAQ;IACpF,OAAOF,QAAQU,QAAQnC,WAAW;AACpC;AAEA,SAASD,cAAcZ,QAAgB;IACrC,IAAIA,aAAa,KAAK,OAAOA;IAC7B,OAAOA,SAASiB,OAAO,CAACtB,qBAAqB;AAC/C;AAEA,SAASsD,cAAclD,aAAqB,EAAEmD,MAAc;IAC1D,OAAO,CAAC,GAAG,EAAEnD,gBAAgBmD,QAAQ;AACvC;AAEA,SAASpC,wBAAwBd,QAAgB,EAAED,aAAqB;IACtE,OAAOC,aAAaiD,cAAclD,eAAe;AACnD;AAEA,SAASsB,uBAAuBrB,QAAgB,EAAED,aAAqB;IACrE,MAAMoD,WAAWF,cAAclD,eAAe;IAC9C,OACEC,aAAamD,YACbnD,SAASoD,UAAU,CAAC,GAAGD,SAAS,CAAC,CAAC,KAClCnD,aAAaiD,cAAclD,eAAe;AAE9C;AAEA,SAAS2B,sBAAsB1B,QAAgB,EAAED,aAAqB;IACpE,OAAOC,aAAaiD,cAAclD,eAAe;AACnD;AAEA,SAAS0B,8BAA8BzB,QAAgB,EAAED,aAAqB;IAC5E,OAAOC,aAAaiD,cAAclD,eAAe;AACnD;AAEA,SAASuB,oBAAoBtB,QAAgB,EAAED,aAAqB;IAClE,OAAOC,aAAaiD,cAAclD,eAAe;AACnD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shipfox/client-onboarding",
   "license": "MIT",
-  "version": "22.0.2",
+  "version": "23.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ShipfoxHQ/shipfox.git",
@@ -18,10 +18,10 @@
   },
   "dependencies": {
     "@swc/helpers": "^0.5.17",
-    "@shipfox/client-agent": "22.0.2",
-    "@shipfox/client-integrations": "22.0.2",
-    "@shipfox/client-projects": "22.0.2",
-    "@shipfox/client-shell": "22.0.2"
+    "@shipfox/client-agent": "23.0.0",
+    "@shipfox/client-integrations": "23.0.0",
+    "@shipfox/client-projects": "23.0.0",
+    "@shipfox/client-shell": "23.0.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.101.0",
@@ -29,10 +29,15 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
+  "imports": {
+    "#*": "./dist/*"
+  },
   "scripts": {
     "build": "shipfox-swc",
     "check": "shipfox-biome-check",
     "check:fix": "shipfox-biome-check --write",
+    "storybook": "storybook dev -p 6015",
+    "storybook:build": "storybook build -o storybook-static",
     "test": "shipfox-vitest-run",
     "type": "shipfox-tsc-check",
     "type:emit": "shipfox-tsc-emit"

package/src/core/integration-readiness.test.ts

@@ -0,0 +1,277 @@
+import type {
+  IntegrationCapability,
+  IntegrationConnection,
+  IntegrationProvider,
+} from '@shipfox/client-integrations';
+import {describe, expect, test} from '@shipfox/vitest/vi';
+import {deriveIntegrationReadiness} from './integration-readiness.js';
+
+function provider(
+  key: string,
+  capabilities: IntegrationCapability[] = [],
+  displayName = key,
+): IntegrationProvider {
+  return {provider: key, displayName, capabilities};
+}
+
+function connection(
+  providerKey: string,
+  overrides: Partial<IntegrationConnection> = {},
+): IntegrationConnection {
+  return {
+    id: `connection-${providerKey}`,
+    workspaceId: 'workspace',
+    provider: providerKey,
+    externalAccountId: 'account',
+    slug: `${providerKey}_account`,
+    displayName: providerKey,
+    lifecycleStatus: 'active',
+    capabilities: [],
+    createdAt: '2026-01-01T00:00:00.000Z',
+    updatedAt: '2026-01-01T00:00:00.000Z',
+    ...overrides,
+  };
+}
+
+const GITHUB = provider('github', ['source_control', 'agent_tools'], 'GitHub');
+const LINEAR = provider('linear', ['agent_tools'], 'Linear');
+const WEBHOOK = provider('webhook', [], 'Webhook');
+
+describe('deriveIntegrationReadiness', () => {
+  test('reports a provider as connected when at least one connection is active', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [LINEAR],
+      connections: [
+        connection('linear', {lifecycleStatus: 'active'}),
+        connection('linear', {id: 'other', lifecycleStatus: 'error'}),
+      ],
+    });
+
+    expect(readiness.providers).toEqual([
+      {
+        provider: 'linear',
+        displayName: 'Linear',
+        capabilities: ['agent_tools'],
+        connected: true,
+        attention: false,
+      },
+    ]);
+  });
+
+  test('reports a provider as needing attention when connections exist but none is active', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [LINEAR],
+      connections: [
+        connection('linear', {lifecycleStatus: 'error'}),
+        connection('linear', {id: 'other', lifecycleStatus: 'disabled'}),
+      ],
+    });
+
+    expect(readiness.providers).toEqual([
+      {
+        provider: 'linear',
+        displayName: 'Linear',
+        capabilities: ['agent_tools'],
+        connected: false,
+        attention: true,
+      },
+    ]);
+    expect(readiness.attentionProviders).toEqual(['linear']);
+  });
+
+  test('reports a provider with no connections as neither connected nor in attention', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [LINEAR, GITHUB],
+      connections: [connection('github', {lifecycleStatus: 'active'})],
+    });
+
+    expect(readiness.providers).toEqual([
+      {
+        provider: 'linear',
+        displayName: 'Linear',
+        capabilities: ['agent_tools'],
+        connected: false,
+        attention: false,
+      },
+      {
+        provider: 'github',
+        displayName: 'GitHub',
+        capabilities: ['source_control', 'agent_tools'],
+        connected: true,
+        attention: false,
+      },
+    ]);
+  });
+
+  test('ignores connections for providers outside the catalog', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [LINEAR],
+      connections: [connection('unknown', {lifecycleStatus: 'active'})],
+    });
+
+    expect(readiness.providers).toEqual([
+      {
+        provider: 'linear',
+        displayName: 'Linear',
+        capabilities: ['agent_tools'],
+        connected: false,
+        attention: false,
+      },
+    ]);
+    expect(readiness.hasToolIntegration).toBe(false);
+  });
+
+  test('orders attention providers by the most recent connection update first', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [GITHUB, LINEAR, WEBHOOK],
+      connections: [
+        connection('linear', {
+          lifecycleStatus: 'error',
+          updatedAt: '2026-03-01T00:00:00.000Z',
+        }),
+        connection('webhook', {
+          lifecycleStatus: 'error',
+          updatedAt: '2026-02-01T00:00:00.000Z',
+        }),
+        connection('github', {
+          lifecycleStatus: 'disabled',
+          updatedAt: '2026-01-01T00:00:00.000Z',
+        }),
+      ],
+    });
+
+    expect(readiness.attentionProviders).toEqual(['linear', 'webhook', 'github']);
+  });
+
+  test('uses the newest of several connections per provider for ordering', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [LINEAR, WEBHOOK],
+      connections: [
+        connection('linear', {
+          id: 'stale',
+          lifecycleStatus: 'error',
+          updatedAt: '2026-01-01T00:00:00.000Z',
+        }),
+        connection('linear', {
+          id: 'fresh',
+          lifecycleStatus: 'disabled',
+          updatedAt: '2026-04-01T00:00:00.000Z',
+        }),
+        connection('webhook', {
+          lifecycleStatus: 'error',
+          updatedAt: '2026-03-01T00:00:00.000Z',
+        }),
+      ],
+    });
+
+    expect(readiness.attentionProviders).toEqual(['linear', 'webhook']);
+  });
+
+  test('keeps catalog order when attention providers updated at the same time', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [GITHUB, LINEAR, WEBHOOK],
+      connections: [
+        connection('linear', {lifecycleStatus: 'error'}),
+        connection('webhook', {lifecycleStatus: 'error'}),
+        connection('github', {lifecycleStatus: 'error'}),
+      ],
+    });
+
+    expect(readiness.attentionProviders).toEqual(['github', 'linear', 'webhook']);
+  });
+
+  test('skips connections with an unparsable updated_at when ordering', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [LINEAR, WEBHOOK],
+      connections: [
+        connection('linear', {lifecycleStatus: 'error', updatedAt: 'not-a-date'}),
+        connection('webhook', {lifecycleStatus: 'error', updatedAt: '2026-02-01T00:00:00.000Z'}),
+      ],
+    });
+
+    expect(readiness.attentionProviders).toEqual(['webhook', 'linear']);
+  });
+
+  test('reports no attention providers when no connection needs attention', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [GITHUB, LINEAR],
+      connections: [
+        connection('github', {lifecycleStatus: 'active'}),
+        connection('linear', {lifecycleStatus: 'active'}),
+      ],
+    });
+
+    expect(readiness.attentionProviders).toEqual([]);
+  });
+
+  test('reports hasSourceControl only for an active source-control connection', () => {
+    expect(
+      deriveIntegrationReadiness({
+        providers: [GITHUB],
+        connections: [connection('github', {lifecycleStatus: 'active'})],
+      }).hasSourceControl,
+    ).toBe(true);
+
+    expect(
+      deriveIntegrationReadiness({
+        providers: [GITHUB],
+        connections: [connection('github', {lifecycleStatus: 'error'})],
+      }).hasSourceControl,
+    ).toBe(false);
+
+    expect(
+      deriveIntegrationReadiness({
+        providers: [LINEAR],
+        connections: [connection('linear', {lifecycleStatus: 'active'})],
+      }).hasSourceControl,
+    ).toBe(false);
+  });
+
+  test('reports hasToolIntegration for an active connection without source_control', () => {
+    expect(
+      deriveIntegrationReadiness({
+        providers: [LINEAR],
+        connections: [connection('linear', {lifecycleStatus: 'active'})],
+      }).hasToolIntegration,
+    ).toBe(true);
+
+    expect(
+      deriveIntegrationReadiness({
+        providers: [WEBHOOK],
+        connections: [connection('webhook', {lifecycleStatus: 'active'})],
+      }).hasToolIntegration,
+    ).toBe(true);
+  });
+
+  test('GitHub never satisfies hasToolIntegration', () => {
+    expect(
+      deriveIntegrationReadiness({
+        providers: [GITHUB],
+        connections: [connection('github', {lifecycleStatus: 'active'})],
+      }).hasToolIntegration,
+    ).toBe(false);
+  });
+
+  test('an inactive tool connection does not satisfy hasToolIntegration', () => {
+    expect(
+      deriveIntegrationReadiness({
+        providers: [LINEAR],
+        connections: [connection('linear', {lifecycleStatus: 'error'})],
+      }).hasToolIntegration,
+    ).toBe(false);
+  });
+
+  test('combines providers in one readiness report', () => {
+    const readiness = deriveIntegrationReadiness({
+      providers: [GITHUB, LINEAR, WEBHOOK],
+      connections: [
+        connection('github', {lifecycleStatus: 'active'}),
+        connection('linear', {lifecycleStatus: 'error'}),
+      ],
+    });
+
+    expect(readiness.hasSourceControl).toBe(true);
+    expect(readiness.hasToolIntegration).toBe(false);
+    expect(readiness.attentionProviders).toEqual(['linear']);
+  });
+});

package/src/core/integration-readiness.ts

@@ -0,0 +1,93 @@
+import {
+  type IntegrationCapability,
+  type IntegrationConnection,
+  type IntegrationProvider,
+  isUsableConnection,
+} from '@shipfox/client-integrations';
+
+/**
+ * Per-provider connection state for the workspace setup readiness model.
+ * `connected` and `attention` are mutually exclusive: a provider with at
+ * least one active connection is connected, a provider whose connections
+ * exist but are all inactive needs attention, and a provider without
+ * connections is neither.
+ */
+export interface IntegrationProviderReadiness {
+  provider: string;
+  displayName: string;
+  capabilities: ReadonlyArray<IntegrationCapability>;
+  connected: boolean;
+  attention: boolean;
+}
+
+export interface WorkspaceIntegrationReadiness {
+  providers: ReadonlyArray<IntegrationProviderReadiness>;
+  /** Providers in attention, most recently updated connection first. */
+  attentionProviders: readonly string[];
+  /** At least one active connection to a source-control provider. */
+  hasSourceControl: boolean;
+  /** At least one active connection to a provider without `source_control`. */
+  hasToolIntegration: boolean;
+}
+
+export interface IntegrationReadinessInput {
+  providers: readonly IntegrationProvider[];
+  connections: readonly IntegrationConnection[];
+}
+
+/**
+ * Derives the workspace integration readiness from the provider catalog and
+ * the workspace's connections. The result is the shared input for the setup
+ * checklist and for the first-workflow spec's contextual "Connect X" prompt.
+ */
+export function deriveIntegrationReadiness({
+  providers,
+  connections,
+}: IntegrationReadinessInput): WorkspaceIntegrationReadiness {
+  const readiness = providers.map((provider) => {
+    const providerConnections = connections.filter(
+      (connection) => connection.provider === provider.provider,
+    );
+    const connected = providerConnections.some(isUsableConnection);
+    return {
+      provider: provider.provider,
+      displayName: provider.displayName,
+      capabilities: provider.capabilities,
+      connected,
+      attention: providerConnections.length > 0 && !connected,
+    };
+  });
+
+  const latestConnectionUpdate = latestConnectionUpdateByProvider(connections);
+
+  const attentionProviders = readiness
+    .filter((provider) => provider.attention)
+    .sort((a, b) => {
+      const aUpdate = latestConnectionUpdate.get(a.provider) ?? 0;
+      const bUpdate = latestConnectionUpdate.get(b.provider) ?? 0;
+      return bUpdate - aUpdate;
+    })
+    .map((provider) => provider.provider);
+
+  const hasSourceControl = readiness.some(
+    (provider) => provider.connected && provider.capabilities.includes('source_control'),
+  );
+  const hasToolIntegration = readiness.some(
+    (provider) => provider.connected && !provider.capabilities.includes('source_control'),
+  );
+
+  return {providers: readiness, attentionProviders, hasSourceControl, hasToolIntegration};
+}
+
+function latestConnectionUpdateByProvider(
+  connections: readonly IntegrationConnection[],
+): Map<string, number> {
+  const updates = new Map<string, number>();
+  for (const connection of connections) {
+    const timestamp = Date.parse(connection.updatedAt);
+    if (Number.isNaN(timestamp)) continue;
+    const current = updates.get(connection.provider) ?? 0;
+    if (timestamp > current) updates.set(connection.provider, timestamp);
+  }
+  return updates;
+}