@company-semantics/contracts 58.2.0 → 58.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "58.2.0",
+  "version": "58.4.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 = 'a69faedfed8f' as const;
-export const SPEC_HASH_FULL = 'a69faedfed8f36af0b36dc657e4f5b2c4e90c137e0f48823debd5578c433c77a' as const;
+export const SPEC_HASH = '433bb009d9f1' as const;
+export const SPEC_HASH_FULL = '433bb009d9f1037871adde049808503dc040cc4cb44122a8f2d603da02b4dd2b' as const;

package/src/api/generated.ts

@@ -465,6 +465,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/chats/proactive/{eventId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Resolve a proactive occurrence to the current reader's chat
+         * @description A banner or inbox row links to an OCCURRENCE (/chat/proactive/{eventId}), never to a chat id, because the pushed chat is per recipient. This resolves the occurrence for the CURRENT reader: `ready` with their chat id, `pending` while the projection job is still running or retrying, `unavailable` when it gave up (the durable inbox row stands alone), or `ineligible` when the reader is not in the occurrence’s frozen audience.
+         */
+        get: operations["resolveProactiveChat"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/workspace/access": {
         parameters: {
             query?: never;
@@ -4247,6 +4267,20 @@ export interface components {
             id?: string;
             runtimeProfile?: string;
         };
+        ProactiveChatResolution: {
+            /** @constant */
+            state: "ready";
+            chatId: string;
+        } | {
+            /** @constant */
+            state: "pending";
+        } | {
+            /** @constant */
+            state: "unavailable";
+        } | {
+            /** @constant */
+            state: "ineligible";
+        };
         WorkspaceAccessResponse: {
             hasAccess: boolean;
         };
@@ -7836,6 +7870,28 @@ export interface operations {
             };
         };
     };
+    resolveProactiveChat: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                eventId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The resolution for the current reader (one of four bounded states) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProactiveChatResolution"];
+                };
+            };
+        };
+    };
     getWorkspaceAccess: {
         parameters: {
             query?: never;

package/src/generated/openapi-routes.ts

@@ -15,6 +15,7 @@ export const openApiRoutes = {
   '/api/chats': ['GET', 'POST'],
   '/api/chats/by-interaction/{interactionId}': ['GET'],
   '/api/chats/events': ['GET'],
+  '/api/chats/proactive/{eventId}': ['GET'],
   '/api/chats/{chatId}/shares': ['GET', 'POST'],
   '/api/chats/{id}': ['DELETE', 'GET', 'PATCH'],
   '/api/chats/{id}/generate-title': ['POST'],

package/src/index.ts

@@ -687,6 +687,7 @@ export type { OrgDirectoryPerson, OrgDirectoryResponse } from "./org/index";
 // caller's own directory rather than supplied by the caller.
 export {
   BATCH_INVITE_PERSONS_MAX,
+  INVITE_EXPIRY_DAYS,
   BATCH_INVITE_SKIP_REASONS,
   BatchInviteSkipReasonSchema,
   BatchInviteRequestSchema,

package/src/org/README.md

@@ -163,6 +163,7 @@ Shared type vocabulary for organization ownership, type classification, and tran
 - `INVITE_BATCH_ITEM_REASONS` — Why an item is not `sent`.
 - `INVITE_BATCH_ITEM_STATUSES` — Per-recipient outcome within a batch. - `eligible` — will be invited when the batch is sent. - `excluded` —…
 - `INVITE_BATCH_STATUSES` — Batch lifecycle. - `draft` — created, membership not yet evaluated.
+- `INVITE_EXPIRY_DAYS` — How many days an invitation link stays redeemable.
 - `IdentityTrustLevel` _(type)_ — Identity Trust Level — org's identity posture
 - `IntegrationRequest` _(type)_ — Advisory integration request created by a member.
 - `IntegrationRequestStatus` _(type)_ — Status of an integration request from a member.

package/src/org/index.ts

@@ -412,6 +412,7 @@ export {
   OrgDirectoryPersonSchema,
   OrgDirectoryResponseSchema,
   BATCH_INVITE_PERSONS_MAX,
+  INVITE_EXPIRY_DAYS,
   BATCH_INVITE_SKIP_REASONS,
   BatchInviteSkipReasonSchema,
   BatchInviteRequestSchema,

package/src/org/schemas.ts

@@ -854,6 +854,20 @@ export type OrgDirectoryResponse = z.infer<typeof OrgDirectoryResponseSchema>;
  */
 export const BATCH_INVITE_PERSONS_MAX = 100;
 
+/**
+ * How many days an invitation link stays redeemable.
+ *
+ * Shared vocabulary, not prose: the backend stamps `expires_at` from this when
+ * it mints an invite, and the review surface states the same window to the
+ * person about to send one. It lived in both places as a literal and drifted —
+ * the copy still promised seven days after the policy moved.
+ *
+ * A SECURITY parameter as much as a UX one: it bounds how long a leaked invite
+ * link stays usable, so widening it is a deliberate trust-model change rather
+ * than a copy edit.
+ */
+export const INVITE_EXPIRY_DAYS = 30;
+
 /** @deprecated Use {@link CreateInviteBatchRequestSchema}. Removed in 58.0.0. */
 export const BatchInviteRequestSchema = z.object({
   personIds: z.array(z.string().uuid()).min(1).max(BATCH_INVITE_PERSONS_MAX),