@shipfox/api-runners-dto 12.4.0 → 14.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shipfox/api-runners-dto",
   "license": "MIT",
-  "version": "12.4.0",
+  "version": "14.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ShipfoxHQ/shipfox.git",

package/src/events.ts

@@ -4,7 +4,6 @@ const nonEmptyStringSchema = z.string().nonempty();
 const isoDateTimeSchema = z.string().datetime();
 
 export const RUNNER_JOB_LEASE_EXPIRED = 'runners.job.lease_expired' as const;
-export const RUNNER_JOB_QUEUED = 'runners.job.queued' as const;
 export const RUNNER_JOB_CLAIMED = 'runners.job.claimed' as const;
 
 export const runnerJobLeaseExpiredEventSchema = z.object({
@@ -15,15 +14,6 @@ export const runnerJobLeaseExpiredEventSchema = z.object({
 });
 export type RunnerJobLeaseExpiredEvent = z.infer<typeof runnerJobLeaseExpiredEventSchema>;
 
-export const runnerJobQueuedEventSchema = z.object({
-  workflowRunId: nonEmptyStringSchema,
-  workflowRunAttemptId: nonEmptyStringSchema,
-  jobId: nonEmptyStringSchema,
-  jobExecutionId: nonEmptyStringSchema,
-  queuedAt: isoDateTimeSchema,
-});
-export type RunnerJobQueuedEvent = z.infer<typeof runnerJobQueuedEventSchema>;
-
 export const runnerJobClaimedEventSchema = z.object({
   workflowRunId: nonEmptyStringSchema,
   workflowRunAttemptId: nonEmptyStringSchema,
@@ -35,12 +25,10 @@ export type RunnerJobClaimedEvent = z.infer<typeof runnerJobClaimedEventSchema>;
 
 export interface RunnersEventMap {
   [RUNNER_JOB_LEASE_EXPIRED]: RunnerJobLeaseExpiredEvent;
-  [RUNNER_JOB_QUEUED]: RunnerJobQueuedEvent;
   [RUNNER_JOB_CLAIMED]: RunnerJobClaimedEvent;
 }
 
 export const runnersEventSchemas = {
   [RUNNER_JOB_LEASE_EXPIRED]: runnerJobLeaseExpiredEventSchema,
-  [RUNNER_JOB_QUEUED]: runnerJobQueuedEventSchema,
   [RUNNER_JOB_CLAIMED]: runnerJobClaimedEventSchema,
 } satisfies Record<keyof RunnersEventMap, z.ZodType>;

package/src/index.ts

@@ -39,7 +39,9 @@ export {
   heartbeatBodySchema,
   heartbeatResponseSchema,
   type InstallationProvisionerTokenStatus,
+  type InstallationRunnersStatus,
   installationProvisionerTokenStatusSchema,
+  installationRunnersStatusSchema,
   type ListActiveProvisionersResponseDto,
   type ListAdministratorProvisionerTokensQueryDto,
   type ListAdministratorProvisionerTokensResponseDto,
@@ -138,13 +140,10 @@ export {
 export {
   RUNNER_JOB_CLAIMED,
   RUNNER_JOB_LEASE_EXPIRED,
-  RUNNER_JOB_QUEUED,
   type RunnerJobClaimedEvent,
   type RunnerJobLeaseExpiredEvent,
-  type RunnerJobQueuedEvent,
   type RunnersEventMap,
   runnerJobClaimedEventSchema,
   runnerJobLeaseExpiredEventSchema,
-  runnerJobQueuedEventSchema,
   runnersEventSchemas,
 } from './events.js';

package/src/inter-module.test.ts

@@ -1,22 +1,6 @@
 import {runnersInterModuleContract} from './inter-module.js';
 
-const id = '00000000-0000-4000-8000-000000000001';
-
 describe('runnersInterModuleContract', () => {
-  test('accepts stable job-execution identities for idempotent commands', () => {
-    const input = runnersInterModuleContract.methods.enqueueJobExecution.input.parse({
-      workspaceId: id,
-      workflowRunId: id,
-      workflowRunAttemptId: id,
-      jobId: id,
-      jobExecutionId: id,
-      projectId: id,
-      requiredLabels: ['linux'],
-    });
-
-    expect(input.jobExecutionId).toBe(id);
-  });
-
   test('exposes bounded JSON capability results', () => {
     const result =
       runnersInterModuleContract.methods.getEffectiveRunnerToolCapabilities.output.parse({
@@ -29,12 +13,4 @@ describe('runnersInterModuleContract', () => {
       reportFresh: true,
     });
   });
-
-  test('defines the scheduling validation failure', () => {
-    const details = runnersInterModuleContract.methods.enqueueJobExecution.errors[
-      'empty-required-labels'
-    ].parse({});
-
-    expect(details).toEqual({});
-  });
 });

package/src/inter-module.ts

@@ -7,29 +7,6 @@ const idSchema = z.string().uuid();
 export const runnersInterModuleContract = defineInterModuleContract({
   module: 'runners',
   methods: {
-    enqueueJobExecution: {
-      input: z.object({
-        workspaceId: idSchema,
-        workflowRunId: idSchema,
-        workflowRunAttemptId: idSchema,
-        jobId: idSchema,
-        jobExecutionId: idSchema,
-        projectId: idSchema,
-        requiredLabels: z.array(z.string()),
-      }),
-      output: z.object({}),
-      errors: {
-        'empty-required-labels': z.object({}),
-      },
-    },
-    releaseJobExecution: {
-      input: z.object({jobExecutionId: idSchema}),
-      output: z.object({}),
-    },
-    cancelJobs: {
-      input: z.object({jobIds: z.array(idSchema)}),
-      output: z.object({}),
-    },
     getLeaseState: {
       input: z.object({
         jobId: idSchema,

package/src/schemas/index.ts

@@ -50,6 +50,8 @@ export {
 export {
   type ActiveProvisionerDto,
   activeProvisionerDtoSchema,
+  type InstallationRunnersStatus,
+  installationRunnersStatusSchema,
   type ListActiveProvisionersResponseDto,
   listActiveProvisionersResponseSchema,
 } from './list-active-provisioners.js';

package/src/schemas/list-active-provisioners.test.ts

@@ -0,0 +1,44 @@
+import {
+  installationRunnersStatusSchema,
+  listActiveProvisionersResponseSchema,
+} from './list-active-provisioners.js';
+
+describe('list active provisioners schemas', () => {
+  it('accepts an installation_runners status of managed', () => {
+    expect(installationRunnersStatusSchema.parse('managed')).toBe('managed');
+  });
+
+  it('accepts an installation_runners status of none', () => {
+    expect(installationRunnersStatusSchema.parse('none')).toBe('none');
+  });
+
+  it('rejects any other installation_runners status', () => {
+    const result = installationRunnersStatusSchema.safeParse('unknown');
+
+    expect(result.success).toBe(false);
+  });
+
+  it('parses a response with provisioners and installation_runners', () => {
+    const response = {
+      provisioners: [
+        {
+          id: crypto.randomUUID(),
+          name: 'Docker provisioner',
+          prefix: 'sf_pt_abcde',
+          last_seen_at: '2026-05-08T01:00:00.000Z',
+        },
+      ],
+      installation_runners: 'managed',
+    };
+
+    expect(listActiveProvisionersResponseSchema.parse(response)).toEqual(response);
+  });
+
+  it('defaults installation_runners for responses from older servers', () => {
+    const result = listActiveProvisionersResponseSchema.parse({
+      provisioners: [],
+    });
+
+    expect(result).toEqual({provisioners: [], installation_runners: 'none'});
+  });
+});

package/src/schemas/list-active-provisioners.ts

@@ -1,5 +1,7 @@
 import {z} from 'zod';
 
+export const installationRunnersStatusSchema = z.enum(['managed', 'none']);
+
 export const activeProvisionerDtoSchema = z.object({
   id: z.string().uuid(),
   name: z.string().nullable(),
@@ -9,8 +11,10 @@ export const activeProvisionerDtoSchema = z.object({
 
 export const listActiveProvisionersResponseSchema = z.object({
   provisioners: z.array(activeProvisionerDtoSchema),
+  installation_runners: installationRunnersStatusSchema.default('none'),
 });
 
+export type InstallationRunnersStatus = z.infer<typeof installationRunnersStatusSchema>;
 export type ActiveProvisionerDto = z.infer<typeof activeProvisionerDtoSchema>;
 export type ListActiveProvisionersResponseDto = z.infer<
   typeof listActiveProvisionersResponseSchema