@company-semantics/contracts 99.2.0 → 99.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "99.2.0",
+  "version": "99.3.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = 'bdfe41ff343f' as const;
-export const SPEC_HASH_FULL = 'bdfe41ff343f7f914f93bf62144b67f3f1ff2f0cd2c53e6bb0727dff96eb543b' as const;
+export const SPEC_HASH = 'c7651db1db74' as const;
+export const SPEC_HASH_FULL = 'c7651db1db74df7ba1f8d6ef92caef3024498071b187aa818640d98f2d90c037' as const;

package/src/api/generated.ts

@@ -3026,7 +3026,7 @@ export interface paths {
         get?: never;
         /**
          * Upload (replace) a user's avatar photo from an image file
-         * @description Accepts a multipart image upload (PNG/JPEG/WebP/HEIC) up to 5 MB. The caller must be the target user or hold org.manage_users. HEIC/HEIF is converted to JPEG and the bytes are re-hosted via the blob store. Returns the resolved avatar.
+         * @description Accepts a multipart image upload (PNG/JPEG/WEBP/GIF/HEIC/HEIF) up to 5 MB. The caller must be the target user or hold org.manage_users. HEIC/HEIF is converted to JPEG (GIF to its first frame as PNG) and the bytes are re-hosted via the blob store. Returns the resolved avatar.
          */
         put: operations["uploadUserAvatar"];
         post?: never;
@@ -3050,7 +3050,7 @@ export interface paths {
         get?: never;
         /**
          * Upload (replace) one of the org's two marks from an image file
-         * @description Accepts a multipart image upload (PNG/JPEG/WebP/HEIC) up to 5 MB. Requires org.settings.write. HEIC/HEIF is converted to JPEG and the bytes are re-hosted via the blob store, never hot-linked. The slot to write: `app_logo` (the square mark, also the slot the Slack workspace icon fills) or `logo` (the wordmark, which is upload-only). Returns both slots as signed URLs.
+         * @description Accepts a multipart image upload (PNG/JPEG/WEBP/GIF/HEIC/HEIF) up to 5 MB. Requires org.settings.write. HEIC/HEIF is converted to JPEG (GIF to its first frame as PNG) and the bytes are re-hosted via the blob store, never hot-linked. The slot to write: `app_logo` (the square mark, also the slot the Slack workspace icon fills) or `logo` (the wordmark, which is upload-only). Returns both slots as signed URLs.
          */
         put: operations["uploadOrgLogo"];
         post?: never;
@@ -4116,6 +4116,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/schedules/tick": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Run one schedule clock pass for the edge tick source */
+        post: operations["scheduleTick"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/schedules/executions/start": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Claim a scheduled execution (or admit a legacy run) for the calling workflow's run */
+        post: operations["scheduleExecutionStart"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/schedules/executions/finish": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Report a claimed execution's conclusion, fenced by its claim epoch */
+        post: operations["scheduleExecutionFinish"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/internal-admin/impersonate/start": {
         parameters: {
             query?: never;
@@ -9966,6 +10017,68 @@ export interface components {
                 };
             }[];
         };
+        ScheduleTickResponse: {
+            /** @enum {string} */
+            source: "edge" | "jobqueue";
+            /** Format: date-time */
+            tickedAt: string;
+            reconcileOk: boolean;
+            registryVersion: string | null;
+            dispatched: number;
+            incidentsOpened: number;
+            incidentsResolved: number;
+        };
+        ScheduleTickRequest: {
+            /** @enum {string} */
+            source: "edge" | "jobqueue";
+            /** Format: date-time */
+            scheduledFor: string;
+            cron: string;
+        };
+        ScheduleClaimResponse: {
+            /** @constant */
+            outcome: "claimed";
+            executionId: string;
+            claimEpoch: number;
+            /** Format: date-time */
+            leaseUntil: string;
+            /** @enum {string} */
+            mode: "off" | "shadow" | "live";
+        } | {
+            /** @constant */
+            outcome: "legacy";
+            scheduleId: string;
+            /** @enum {string} */
+            mode: "off" | "shadow" | "live";
+        } | {
+            /** @constant */
+            outcome: "refused";
+            /** @enum {string} */
+            reason: "already_completed" | "lease_held" | "legacy_run_not_admitted" | "not_dispatched" | "binding_mismatch" | "schedule_off";
+        };
+        ScheduleStartRequest: {
+            executionId: string | null;
+            attempt: number | null;
+        };
+        ScheduleFinishResponse: {
+            /** @constant */
+            recorded: true;
+            executionId: string;
+            /** @enum {string} */
+            state: "due" | "dispatch_requested" | "started" | "completed" | "output_verified" | "timed_out" | "superseded" | "missed" | "acknowledged_loss";
+        } | {
+            /** @constant */
+            recorded: false;
+            /** @enum {string} */
+            reason: "stale_epoch" | "binding_mismatch" | "unknown_execution";
+        };
+        ScheduleFinishRequest: {
+            executionId: string;
+            attempt: number;
+            claimEpoch: number;
+            /** @enum {string} */
+            conclusion: "success" | "failure" | "cancelled";
+        };
         ImpersonationSessionResponse: {
             session: {
                 impersonationSessionId: string;
@@ -16916,7 +17029,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Unsupported image type or bytes are not a valid image */
+            /** @description Unsupported image type (accepted: PNG/JPEG/WEBP/GIF/HEIC/HEIF) or bytes are not a valid image */
             415: {
                 headers: {
                     [name: string]: unknown;
@@ -17006,7 +17119,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Unsupported image type or bytes are not a valid image */
+            /** @description Unsupported image type (accepted: PNG/JPEG/WEBP/GIF/HEIC/HEIF) or bytes are not a valid image */
             415: {
                 headers: {
                     [name: string]: unknown;
@@ -18885,6 +18998,148 @@ export interface operations {
             };
         };
     };
+    scheduleTick: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ScheduleTickRequest"];
+            };
+        };
+        responses: {
+            /** @description The pass ran (reconcileOk false when it could not conclude) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ScheduleTickResponse"];
+                };
+            };
+            /** @description Payload invalid, or a source other than edge */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing or invalid edge bearer token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The pass did not finish within its deadline */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    scheduleExecutionStart: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ScheduleStartRequest"];
+            };
+        };
+        responses: {
+            /** @description claimed, legacy (runs, counts toward no slot) or refused (skip the work) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ScheduleClaimResponse"];
+                };
+            };
+            /** @description Payload invalid */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing or rejected GitHub Actions OIDC token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The workflow is not bound to a registered schedule */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description GitHub could not confirm the run; nothing was claimed */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    scheduleExecutionFinish: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ScheduleFinishRequest"];
+            };
+        };
+        responses: {
+            /** @description recorded, or not recorded with the reason (a stale epoch is not an error) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ScheduleFinishResponse"];
+                };
+            };
+            /** @description Payload invalid */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing or rejected GitHub Actions OIDC token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The workflow is not bound to this schedule */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     startImpersonation: {
         parameters: {
             query?: never;

package/src/generated/openapi-routes.ts

@@ -218,6 +218,9 @@ export const openApiRoutes = {
   '/api/reporting/move/apply': ['POST'],
   '/api/reporting/move/preview': ['POST'],
   '/api/reporting/positions/{positionId}/manager': ['PUT'],
+  '/api/schedules/executions/finish': ['POST'],
+  '/api/schedules/executions/start': ['POST'],
+  '/api/schedules/tick': ['POST'],
   '/api/scope/check': ['GET'],
   '/api/scope/check-batch': ['POST'],
   '/api/source-sync/candidate-sets/current': ['GET'],