@shipfox/client-runners 22.0.3 → 23.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shipfox/client-runners",
   "license": "MIT",
-  "version": "22.0.3",
+  "version": "23.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ShipfoxHQ/shipfox.git",
@@ -27,11 +27,11 @@
   "dependencies": {
     "@swc/helpers": "^0.5.17",
     "@tanstack/react-form": "^1.32.0",
-    "@shipfox/api-runners-dto": "13.0.0",
     "@shipfox/client-api": "6.0.1",
-    "@shipfox/client-shell": "22.0.3",
+    "@shipfox/client-shell": "23.0.0",
     "@shipfox/client-ui": "22.0.3",
-    "@shipfox/react-ui": "2.2.0"
+    "@shipfox/react-ui": "2.2.0",
+    "@shipfox/api-runners-dto": "14.0.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.101.0",

package/src/components/provisioner-tokens-settings-section.test.tsx

@@ -86,7 +86,7 @@ describe('WorkspaceProvisionerTokensSettingsSection', () => {
     const fetchImpl = vi.fn((input: RequestInfo | URL) => {
       const request = input as Request;
       if (request.url.endsWith('/provisioners/active')) {
-        return Promise.resolve(jsonResponse({provisioners: []}));
+        return Promise.resolve(jsonResponse({provisioners: [], installation_runners: 'none'}));
       }
       return Promise.resolve(jsonResponse({tokens: []}));
     });
@@ -106,7 +106,7 @@ describe('WorkspaceProvisionerTokensSettingsSection', () => {
     const fetchImpl = vi.fn((input: RequestInfo | URL) => {
       const request = input as Request;
       if (request.url.endsWith('/provisioners/active')) {
-        return Promise.resolve(jsonResponse({provisioners: []}));
+        return Promise.resolve(jsonResponse({provisioners: [], installation_runners: 'none'}));
       }
       if (request.method === 'POST' && request.url.endsWith('/provisioners/tokens')) {
         tokens = [provisionerToken({name: 'Docker provisioner'})];
@@ -145,7 +145,7 @@ describe('WorkspaceProvisionerTokensSettingsSection', () => {
     const fetchImpl = vi.fn((input: RequestInfo | URL) => {
       const request = input as Request;
       if (request.url.endsWith('/provisioners/active')) {
-        return Promise.resolve(jsonResponse({provisioners: []}));
+        return Promise.resolve(jsonResponse({provisioners: [], installation_runners: 'none'}));
       }
       return Promise.resolve(
         jsonResponse({
@@ -181,7 +181,7 @@ describe('WorkspaceProvisionerTokensSettingsSection', () => {
     const fetchImpl = vi.fn((input: RequestInfo | URL) => {
       const request = input as Request;
       if (request.url.endsWith('/provisioners/active')) {
-        return Promise.resolve(jsonResponse({provisioners: []}));
+        return Promise.resolve(jsonResponse({provisioners: [], installation_runners: 'none'}));
       }
       return Promise.resolve(jsonResponse({tokens: [provisionerToken({name: tokenName})]}));
     });
@@ -206,7 +206,7 @@ describe('WorkspaceProvisionerTokensSettingsSection', () => {
     const fetchImpl = vi.fn((input: RequestInfo | URL) => {
       const request = input as Request;
       if (request.url.endsWith('/provisioners/active')) {
-        return Promise.resolve(jsonResponse({provisioners: []}));
+        return Promise.resolve(jsonResponse({provisioners: [], installation_runners: 'none'}));
       }
       if (request.method === 'POST' && request.url.endsWith('/provisioners/tokens')) {
         return Promise.resolve(
@@ -241,6 +241,7 @@ describe('WorkspaceProvisionerTokensSettingsSection', () => {
         return Promise.resolve(
           jsonResponse({
             provisioners: [activeProvisioner({id: activeId, name: 'Active provisioner'})],
+            installation_runners: 'none',
           }),
         );
       }
@@ -306,7 +307,7 @@ describe('WorkspaceProvisionerTokensSettingsSection', () => {
     const fetchImpl = vi.fn((input: RequestInfo | URL) => {
       const request = input as Request;
       if (request.url.endsWith('/provisioners/active')) {
-        return Promise.resolve(jsonResponse({provisioners: []}));
+        return Promise.resolve(jsonResponse({provisioners: [], installation_runners: 'none'}));
       }
       if (request.method === 'POST' && request.url.includes('/revoke')) {
         tokens = [];
@@ -339,7 +340,7 @@ describe('WorkspaceProvisionerTokensSettingsSection', () => {
     const fetchImpl = vi.fn((input: RequestInfo | URL) => {
       const request = input as Request;
       if (request.url.endsWith('/provisioners/active')) {
-        return Promise.resolve(jsonResponse({provisioners: []}));
+        return Promise.resolve(jsonResponse({provisioners: [], installation_runners: 'none'}));
       }
       if (request.method === 'POST' && request.url.includes('/revoke')) {
         return Promise.resolve(

package/src/components/token-settings-sections.stories.tsx

@@ -278,6 +278,7 @@ function fetchForScenario(scenario: Scenario): typeof fetch {
                     last_seen_at: NOW,
                   },
                 ],
+          installation_runners: 'none',
         }),
       );
     }

package/src/core/token.ts

@@ -22,6 +22,15 @@ export interface ActiveProvisioner {
   lastSeenAt: string;
 }
 
+export type InstallationRunnersStatus = 'managed' | 'none';
+
+export type ActiveProvisioners = ActiveProvisioner[];
+
+export interface ActiveProvisionersResponse {
+  provisioners: ActiveProvisioners;
+  installationRunners: InstallationRunnersStatus;
+}
+
 export interface CreatedManualRegistrationToken {
   token: string;
   id: string;

package/src/hooks/api/provisioner-tokens.test.ts

@@ -2,6 +2,7 @@ import {configureApiClient} from '@shipfox/client-api';
 import {
   createProvisionerToken,
   listActiveProvisioners,
+  listActiveProvisionersResponse,
   listProvisionerTokens,
   revokeProvisionerToken,
 } from './provisioner-tokens.js';
@@ -105,7 +106,7 @@ describe('provisioner token transports', () => {
     expect(request.method).toBe('POST');
   });
 
-  test('lists active provisioners', async () => {
+  test('keeps listActiveProvisioners array-compatible', async () => {
     const fetchImpl = vi.fn().mockResolvedValue(
       jsonResponse({
         provisioners: [
@@ -116,6 +117,7 @@ describe('provisioner token transports', () => {
             last_seen_at: '2026-05-08T01:00:00.000Z',
           },
         ],
+        installation_runners: 'managed',
       }),
     );
     configureApiClient({fetchImpl});
@@ -124,9 +126,21 @@ describe('provisioner token transports', () => {
 
     const request = fetchImpl.mock.calls[0]?.[0] as Request;
     expect(result).toHaveLength(1);
+    expect(result[0]?.name).toBe('Docker provisioner');
     expect(request.url).toBe(
       `https://api.example.test/workspaces/${workspaceId}/provisioners/active`,
     );
     expect(request.method).toBe('GET');
   });
+
+  test('exposes installation runners status through the response adapter', async () => {
+    const fetchImpl = vi
+      .fn()
+      .mockResolvedValue(jsonResponse({provisioners: [], installation_runners: 'managed'}));
+    configureApiClient({fetchImpl});
+
+    const result = await listActiveProvisionersResponse({workspaceId});
+
+    expect(result).toEqual({provisioners: [], installationRunners: 'managed'});
+  });
 });

package/src/hooks/api/provisioner-tokens.ts

@@ -6,20 +6,22 @@ import {
 } from '@shipfox/api-runners-dto';
 import {checkedApiRequest} from '@shipfox/client-api';
 import {
-  type FetchQueryOptions,
   queryOptions,
+  type UseQueryOptions,
   useMutation,
   useQuery,
   useQueryClient,
 } from '@tanstack/react-query';
 import type {
-  ActiveProvisioner,
+  ActiveProvisioners,
+  ActiveProvisionersResponse,
   CreatedProvisionerToken,
   CreateTokenCommand,
+  InstallationRunnersStatus,
   ProvisionerToken,
 } from '#core/token.js';
 import {
-  toActiveProvisioner,
+  toActiveProvisionersResponse,
   toCreatedProvisionerToken,
   toCreateTokenBody,
   toProvisionerToken,
@@ -34,17 +36,24 @@ export const provisionerTokenQueryKeys = {
     [...provisionerTokenQueryKeys.all, 'provisioners', workspaceId] as const,
 };
 
-type ProvisionerTokensQueryOptions = FetchQueryOptions<
+type ProvisionerTokensQueryOptions = UseQueryOptions<
   ProvisionerToken[],
   Error,
   ProvisionerToken[],
   ReturnType<typeof provisionerTokenQueryKeys.list>
 >;
 
-type ActiveProvisionersQueryOptions = FetchQueryOptions<
-  ActiveProvisioner[],
+type ActiveProvisionersQueryOptions = UseQueryOptions<
+  ActiveProvisionersResponse,
   Error,
-  ActiveProvisioner[],
+  ActiveProvisioners,
+  ReturnType<typeof provisionerTokenQueryKeys.active>
+>;
+
+type InstallationRunnersStatusQueryOptions = UseQueryOptions<
+  ActiveProvisionersResponse,
+  Error,
+  InstallationRunnersStatus,
   ReturnType<typeof provisionerTokenQueryKeys.active>
 >;
 
@@ -93,19 +102,33 @@ export async function revokeProvisionerToken({
   return toProvisionerToken(response);
 }
 
-export async function listActiveProvisioners({
+export async function listActiveProvisionersResponse({
   workspaceId,
   signal,
 }: {
   workspaceId: string;
   signal?: AbortSignal;
-}): Promise<ActiveProvisioner[]> {
+}): Promise<ActiveProvisionersResponse> {
   const response = await checkedApiRequest(
     listActiveProvisionersResponseSchema,
     `/workspaces/${workspaceId}/provisioners/active`,
     {signal},
   );
-  return response.provisioners.map(toActiveProvisioner);
+  return toActiveProvisionersResponse(response);
+}
+
+export async function listActiveProvisioners({
+  workspaceId,
+  signal,
+}: {
+  workspaceId: string;
+  signal?: AbortSignal;
+}): Promise<ActiveProvisioners> {
+  const response = await listActiveProvisionersResponse({
+    workspaceId,
+    ...(signal ? {signal} : {}),
+  });
+  return response.provisioners;
 }
 
 export function provisionerTokensQueryOptions(workspaceId: string): ProvisionerTokensQueryOptions {
@@ -120,12 +143,27 @@ export function provisionerTokensQueryOptions(workspaceId: string): ProvisionerT
 export function activeProvisionersQueryOptions(
   workspaceId: string,
 ): ActiveProvisionersQueryOptions {
-  return queryOptions({
+  return {
     queryKey: provisionerTokenQueryKeys.active(workspaceId),
-    queryFn: ({signal}) => listActiveProvisioners({workspaceId, signal}),
+    queryFn: ({signal}) =>
+      listActiveProvisionersResponse({workspaceId, ...(signal ? {signal} : {})}),
+    select: (response) => response.provisioners,
     refetchInterval: PROVISIONER_TOKEN_REFETCH_INTERVAL_MS,
     refetchIntervalInBackground: false,
-  });
+  };
+}
+
+export function installationRunnersStatusQueryOptions(
+  workspaceId: string,
+): InstallationRunnersStatusQueryOptions {
+  return {
+    queryKey: provisionerTokenQueryKeys.active(workspaceId),
+    queryFn: ({signal}) =>
+      listActiveProvisionersResponse({workspaceId, ...(signal ? {signal} : {})}),
+    select: (response) => response.installationRunners,
+    refetchInterval: PROVISIONER_TOKEN_REFETCH_INTERVAL_MS,
+    refetchIntervalInBackground: false,
+  };
 }
 
 export function useProvisionerTokensQuery(workspaceId: string | undefined) {
@@ -136,12 +174,29 @@ export function useProvisionerTokensQuery(workspaceId: string | undefined) {
 }
 
 export function useActiveProvisionersQuery(workspaceId: string | undefined) {
-  return useQuery({
+  return useQuery<
+    ActiveProvisionersResponse,
+    Error,
+    ActiveProvisioners,
+    ReturnType<typeof provisionerTokenQueryKeys.active>
+  >({
     ...activeProvisionersQueryOptions(workspaceId ?? ''),
     enabled: Boolean(workspaceId),
   });
 }
 
+export function useInstallationRunnersStatusQuery(workspaceId: string | undefined) {
+  return useQuery<
+    ActiveProvisionersResponse,
+    Error,
+    InstallationRunnersStatus,
+    ReturnType<typeof provisionerTokenQueryKeys.active>
+  >({
+    ...installationRunnersStatusQueryOptions(workspaceId ?? ''),
+    enabled: Boolean(workspaceId),
+  });
+}
+
 export function useCreateProvisionerTokenMutation(workspaceId: string) {
   const queryClient = useQueryClient();
   return useMutation({

package/src/hooks/api/token-mapper.test.ts

@@ -1,5 +1,6 @@
 import {
   toActiveProvisioner,
+  toActiveProvisionersResponse,
   toCreatedManualRegistrationToken,
   toCreatedProvisionerToken,
   toCreateTokenBody,
@@ -84,6 +85,34 @@ describe('toActiveProvisioner', () => {
   });
 });
 
+describe('toActiveProvisionersResponse', () => {
+  test('maps the transport response to its package-owned model', () => {
+    const result = toActiveProvisionersResponse({
+      provisioners: [
+        {
+          id: '33333333-3333-4333-8333-333333333333',
+          name: 'Docker provisioner',
+          prefix: 'sf_pt_test',
+          last_seen_at: '2026-07-22T09:00:00.000Z',
+        },
+      ],
+      installation_runners: 'none',
+    });
+
+    expect(result).toEqual({
+      provisioners: [
+        {
+          id: '33333333-3333-4333-8333-333333333333',
+          name: 'Docker provisioner',
+          prefix: 'sf_pt_test',
+          lastSeenAt: '2026-07-22T09:00:00.000Z',
+        },
+      ],
+      installationRunners: 'none',
+    });
+  });
+});
+
 describe('toCreatedManualRegistrationToken', () => {
   test('maps a raw-token creation response to its package-owned model', () => {
     const result = toCreatedManualRegistrationToken({

package/src/hooks/api/token-mapper.ts

@@ -2,18 +2,19 @@ import type {
   ActiveProvisionerDto,
   CreateManualRegistrationTokenResponseDto,
   CreateProvisionerTokenResponseDto,
+  ListActiveProvisionersResponseDto,
   ManualRegistrationTokenDto,
   ProvisionerTokenDto,
 } from '@shipfox/api-runners-dto';
 import type {
   ActiveProvisioner,
+  ActiveProvisionersResponse,
   CreatedManualRegistrationToken,
   CreatedProvisionerToken,
   CreateTokenCommand,
   ManualRegistrationToken,
   ProvisionerToken,
 } from '#core/token.js';
-
 export function toCreateTokenBody(command: CreateTokenCommand) {
   return {
     ...(command.name ? {name: command.name} : {}),
@@ -51,6 +52,15 @@ export function toActiveProvisioner(dto: ActiveProvisionerDto): ActiveProvisione
   return {id: dto.id, name: dto.name, prefix: dto.prefix, lastSeenAt: dto.last_seen_at};
 }
 
+export function toActiveProvisionersResponse(
+  dto: ListActiveProvisionersResponseDto,
+): ActiveProvisionersResponse {
+  return {
+    provisioners: dto.provisioners.map(toActiveProvisioner),
+    installationRunners: dto.installation_runners,
+  };
+}
+
 export function toCreatedManualRegistrationToken(
   dto: CreateManualRegistrationTokenResponseDto,
 ): CreatedManualRegistrationToken {