@cat-factory/contracts 0.266.0 → 0.268.0

package/dist/notification-webhooks.d.ts

@@ -1,4 +1,27 @@
 import * as v from 'valibot';
+/**
+ * The id of the endpoint the SINGULAR routes address. Registering through
+ * `PUT /api/v1/notification-webhook` writes this id, and it appears in the collection like any
+ * other entry, so the two surfaces describe one store rather than two.
+ */
+export declare const DEFAULT_NOTIFICATION_WEBHOOK_ID = "default";
+/**
+ * How many endpoints one workspace may register. Every delivery fans out to every subscribed
+ * endpoint on a run's terminal path, so the set has to be bounded by something other than an
+ * operator's patience; ten is well above the "one receiver per integration" the collection exists
+ * to serve. Exceeding it is a 409 with `reason: 'webhook_limit_reached'`.
+ */
+export declare const MAX_NOTIFICATION_WEBHOOKS_PER_WORKSPACE = 10;
+/**
+ * A webhook's id: CALLER-CHOSEN, not server-minted, which is what makes enrolment idempotent for
+ * the consumer that needs it most. A gatekeeper Worker booting cold can `PUT` its own well-known
+ * id and be enrolled whether or not it has ever run before, with no id table of its own and no
+ * create-or-discover dance against a surface it may be racing another instance on.
+ *
+ * Constrained to a lowercase slug because it is a path segment on both management surfaces and an
+ * operator reads it in a log line beside the endpoint's URL.
+ */
+export declare const notificationWebhookIdSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "A webhook id must be 1-63 characters of lowercase letters, digits, `-` or `_`, starting with a letter or digit">]>;
 /**
  * The RUN-LIFECYCLE events the same endpoint can subscribe to: the ordinary lifecycle of work an
  * integration queued, none of which raises a notification. A task whose pipeline carries a
@@ -28,6 +51,13 @@ export declare const platformAlertEventSchema: v.PicklistSchema<["platform_healt
 export type PlatformAlertEventName = v.InferOutput<typeof platformAlertEventSchema>;
 /** A workspace's registered notification webhook, as exposed to clients (never the secret). */
 export declare const notificationWebhookSchema: v.ObjectSchema<{
+    /**
+     * Which endpoint this is, within the workspace. `default` is the one the singular
+     * `/api/v1/notification-webhook` routes address.
+     */
+    readonly id: v.StringSchema<undefined>;
+    /** An operator-facing label. Defaults to the id when a registration supplies none. */
+    readonly name: v.StringSchema<undefined>;
     /** The HTTPS endpoint deliveries are POSTed to. */
     readonly url: v.StringSchema<undefined>;
     /**
@@ -74,6 +104,8 @@ export type NotificationWebhook = v.InferOutput<typeof notificationWebhookSchema
 export declare const putNotificationWebhookSchema: v.ObjectSchema<{
     /** Omit ⇒ keep the registered endpoint (required only when registering the first one). */
     readonly url: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.UrlAction<string, undefined>, v.StartsWithAction<string, "https://", "The webhook endpoint must be an https:// URL">, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+    /** Omit ⇒ keep the stored label (the endpoint's id, for a registration that named none). */
+    readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
     /** Omit ⇒ deliver the default parking types. */
     readonly types: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["merge_review", "pipeline_complete", "ci_failed", "test_failed", "requirement_review", "clarity_review", "release_regression", "decision_required", "human_test_ready", "visual_confirmation_ready", "human_review", "followup_pending", "fork_decision_pending", "judge_review", "pr_review_ready", "initiative", "platform_health", "infra_unreachable", "budget_paused", "budget_threshold", "key_drift", "merge_tag_request"], undefined>, undefined>, undefined>;
     /** Omit ⇒ keep the current run-event subscription (none, for an endpoint that never set one). */
@@ -86,8 +118,13 @@ export declare const putNotificationWebhookSchema: v.ObjectSchema<{
 }, undefined>;
 export type PutNotificationWebhookInput = v.InferOutput<typeof putNotificationWebhookSchema>;
 /**
- * What `GET /api/v1/notification-webhook` answers: the registered endpoint, or `null` when the
- * workspace has none. Both the session surface and the public one project the SAME
+ * What `GET /api/v1/notification-webhook` and `GET /api/v1/notification-webhooks/:webhookId`
+ * answer: the addressed endpoint, or `null` when none is registered under that id. A 404 would be
+ * the conventional answer for the second one and is deliberately not used: "am I already wired
+ * up?" is the call an integration makes at startup, and it should read one response shape rather
+ * than branch on a status this surface also uses for a mistyped path.
+ *
+ * Both the session surface and the public one project the SAME
  * {@link notificationWebhookSchema}, because the projection is already the client-facing shape
  * with the secret reduced to a boolean, and a second near-identical DTO would be one more thing
  * to keep in step for no caller-visible gain.
@@ -102,6 +139,13 @@ export type PutNotificationWebhookInput = v.InferOutput<typeof putNotificationWe
 export declare const publicNotificationWebhookSchema: v.ObjectSchema<{
     /** The registered endpoint, or `null` when the workspace has none. */
     readonly webhook: v.NullableSchema<v.ObjectSchema<{
+        /**
+         * Which endpoint this is, within the workspace. `default` is the one the singular
+         * `/api/v1/notification-webhook` routes address.
+         */
+        readonly id: v.StringSchema<undefined>;
+        /** An operator-facing label. Defaults to the id when a registration supplies none. */
+        readonly name: v.StringSchema<undefined>;
         /** The HTTPS endpoint deliveries are POSTed to. */
         readonly url: v.StringSchema<undefined>;
         /**
@@ -129,6 +173,52 @@ export declare const publicNotificationWebhookSchema: v.ObjectSchema<{
     }, undefined>, undefined>;
 }, undefined>;
 export type PublicNotificationWebhook = v.InferOutput<typeof publicNotificationWebhookSchema>;
+/**
+ * What `GET /api/v1/notification-webhooks` answers: every endpoint the workspace has registered,
+ * ordered by id so two reads of an unchanged workspace agree.
+ *
+ * Deliberately NOT paginated, unlike every other public list. Paging exists to bound a set the
+ * platform cannot bound itself, and this one is bounded at
+ * {@link MAX_NOTIFICATION_WEBHOOKS_PER_WORKSPACE} by the write path: a cursor here would hand
+ * every client a loop to write for a set that fits in one response by construction, and would
+ * quietly become the reason nobody noticed the cap had been raised.
+ */
+export declare const publicNotificationWebhookListSchema: v.ObjectSchema<{
+    readonly webhooks: v.ArraySchema<v.ObjectSchema<{
+        /**
+         * Which endpoint this is, within the workspace. `default` is the one the singular
+         * `/api/v1/notification-webhook` routes address.
+         */
+        readonly id: v.StringSchema<undefined>;
+        /** An operator-facing label. Defaults to the id when a registration supplies none. */
+        readonly name: v.StringSchema<undefined>;
+        /** The HTTPS endpoint deliveries are POSTed to. */
+        readonly url: v.StringSchema<undefined>;
+        /**
+         * Which notification types are delivered. EMPTY means "the parking types" — the defaults a
+         * headless overseer cares about — rather than "everything", so registering an endpoint can't
+         * accidentally fire-hose every card at an integration that only wanted to hear about parks.
+         */
+        readonly types: v.ArraySchema<v.PicklistSchema<["merge_review", "pipeline_complete", "ci_failed", "test_failed", "requirement_review", "clarity_review", "release_regression", "decision_required", "human_test_ready", "visual_confirmation_ready", "human_review", "followup_pending", "fork_decision_pending", "judge_review", "pr_review_ready", "initiative", "platform_health", "infra_unreachable", "budget_paused", "budget_threshold", "key_drift", "merge_tag_request"], undefined>, undefined>;
+        /**
+         * Which run-lifecycle events are delivered. EMPTY means NONE — the opposite of `types` above,
+         * deliberately: an endpoint registered before this existed must not start receiving a new event
+         * family it never asked for, so subscribing is explicit.
+         */
+        readonly runEvents: v.ArraySchema<v.PicklistSchema<["run.started", "run.completed", "run.failed"], undefined>, undefined>;
+        /**
+         * Which platform-health transitions are delivered. EMPTY means NONE, like {@link runEvents}:
+         * subscribing a receiver to alerts about the deployment itself is always an explicit choice.
+         */
+        readonly alertEvents: v.ArraySchema<v.PicklistSchema<["platform_health.firing", "platform_health.resolved"], undefined>, undefined>;
+        /** Whether deliveries are currently attempted. Registering an endpoint enables it. */
+        readonly enabled: v.BooleanSchema<undefined>;
+        /** Whether a signing secret is set (the secret itself is never returned). */
+        readonly hasSecret: v.BooleanSchema<undefined>;
+        readonly updatedAt: v.NumberSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type PublicNotificationWebhookList = v.InferOutput<typeof publicNotificationWebhookListSchema>;
 /**
  * The JSON body of one webhook delivery. Deliberately a thin envelope over the SAME
  * `notificationSchema` the in-app inbox and the public `GET /api/v1/notifications` already expose

package/dist/notification-webhooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-webhooks.d.ts","sourceRoot":"","sources":["../src/notification-webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAoB5B;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,6EAA6D,CAAA;AACjG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEjF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,qFAGnC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEnF,+FAA+F;AAC/F,eAAO,MAAM,yBAAyB;IACpC,mDAAmD;;IAEnD;;;;OAIG;;IAEH;;;;OAIG;;IAEH;;;OAGG;;IAEH,sFAAsF;;IAEtF,6EAA6E;;;aAG7E,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEjF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,4BAA4B;IACvC,0FAA0F;;IAU1F,gDAAgD;;IAEhD,iGAAiG;;IAEjG,uGAAuG;;;IAGvG,wDAAwD;;aAExD,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAE5F;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,+BAA+B;IAC1C,sEAAsE;;QAlFtE,mDAAmD;;QAEnD;;;;WAIG;;QAEH;;;;WAIG;;QAEH;;;WAGG;;QAEH,sFAAsF;;QAEtF,6EAA6E;;;;aA+D7E,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iCAAiC;;IAE5C,kGAAkG;;;IAGlG,4DAA4D;;IAE5D,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAGnE,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAEjG;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB;;IAEnC,kGAAkG;;;;;;QAMhG,8FAA8F;;;;;QAK9F,sFAAsF;;;QAGtF;;;WAGG;;QAEH,oCAAoC;;;;;;;aAStC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mCAAmC;IAC9C,oEAAoE;;IAEpE,6FAA6F;;IAE7F,8EAA8E;;IAE9E;;;;;OAKG;;aAEH,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,WAAW,CACvD,OAAO,mCAAmC,CAC3C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,kCAAkC;;IAE7C,kGAAkG;;;;;QAKhG;;;WAGG;;QAEH;;;;WAIG;;QAEH;;;WAGG;;YArEL,oEAAoE;;YAEpE,6FAA6F;;YAE7F,8EAA8E;;YAE9E;;;;;eAKG;;;QA4DD;;;;WAIG;;QAEH;;;;;WAKG;;;;;;;QAEH;;;;WAIG;;;aAGL,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAEnG;;;;;;;;;GASG;AACH,eAAO,MAAM,kCAAkC,kKAS6B,CAAA"}
+{"version":3,"file":"notification-webhooks.d.ts","sourceRoot":"","sources":["../src/notification-webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA0B5B;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,YAAY,CAAA;AAExD;;;;;GAKG;AACH,eAAO,MAAM,uCAAuC,KAAK,CAAA;AAEzD;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,iMAQvC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,6EAA6D,CAAA;AACjG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEjF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,qFAGnC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEnF,+FAA+F;AAC/F,eAAO,MAAM,yBAAyB;IACpC;;;OAGG;;IAEH,sFAAsF;;IAEtF,mDAAmD;;IAEnD;;;;OAIG;;IAEH;;;;OAIG;;IAEH;;;OAGG;;IAEH,sFAAsF;;IAEtF,6EAA6E;;;aAG7E,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEjF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,4BAA4B;IACvC,0FAA0F;;IAU1F,4FAA4F;;IAE5F,gDAAgD;;IAEhD,iGAAiG;;IAEjG,uGAAuG;;;IAGvG,wDAAwD;;aAExD,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAE5F;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,+BAA+B;IAC1C,sEAAsE;;QAhGtE;;;WAGG;;QAEH,sFAAsF;;QAEtF,mDAAmD;;QAEnD;;;;WAIG;;QAEH;;;;WAIG;;QAEH;;;WAGG;;QAEH,sFAAsF;;QAEtF,6EAA6E;;;;aAsE7E,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;;;;GASG;AACH,eAAO,MAAM,mCAAmC;;QA/G9C;;;WAGG;;QAEH,sFAAsF;;QAEtF,mDAAmD;;QAEnD;;;;WAIG;;QAEH;;;;WAIG;;QAEH;;;WAGG;;QAEH,sFAAsF;;QAEtF,6EAA6E;;;;aAqF7E,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,WAAW,CACvD,OAAO,mCAAmC,CAC3C,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iCAAiC;;IAE5C,kGAAkG;;;IAGlG,4DAA4D;;IAE5D,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAGnE,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAEjG;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB;;IAEnC,kGAAkG;;;;;;QAMhG,8FAA8F;;;;;QAK9F,sFAAsF;;;QAGtF;;;WAGG;;QAEH,oCAAoC;;;;;;;aAStC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mCAAmC;IAC9C,oEAAoE;;IAEpE,6FAA6F;;IAE7F,8EAA8E;;IAE9E;;;;;OAKG;;aAEH,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,WAAW,CACvD,OAAO,mCAAmC,CAC3C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,kCAAkC;;IAE7C,kGAAkG;;;;;QAKhG;;;WAGG;;QAEH;;;;WAIG;;QAEH;;;WAGG;;YArEL,oEAAoE;;YAEpE,6FAA6F;;YAE7F,8EAA8E;;YAE9E;;;;;eAKG;;;QA4DD;;;;WAIG;;QAEH;;;;;WAKG;;;;;;;QAEH;;;;WAIG;;;aAGL,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAEnG;;;;;;;;;GASG;AACH,eAAO,MAAM,kCAAkC,kKAS6B,CAAA"}

package/dist/notification-webhooks.js

@@ -2,8 +2,8 @@ import * as v from 'valibot';
 import { notificationSchema, notificationTypeSchema } from './notifications.js';
 import { platformFailingRunSchema } from './observability.js';
 // ---------------------------------------------------------------------------
-// Notification-webhook wire contracts. A workspace can register ONE outbound HTTPS endpoint that
-// receives its notifications as they are raised — the delivery channel a HEADLESS integration
+// Notification-webhook wire contracts. A workspace registers outbound HTTPS endpoints that
+// receive its notifications as they are raised — the delivery channel a HEADLESS integration
 // needs, since it has no in-app inbox to watch and no browser to hold a WebSocket open.
 //
 // This is a `NotificationChannel` like the in-app and Slack channels, composed into the same
@@ -15,7 +15,39 @@ import { platformFailingRunSchema } from './observability.js';
 // The endpoint's `secret` is write-only on the wire: it is stored encrypted and never read back,
 // exactly like the other outbound credentials. Deliveries are signed with it so a receiver can
 // verify the payload really came from this deployment.
+//
+// A workspace may register SEVERAL named endpoints, each with its own secret and its own filters,
+// addressed by a caller-chosen {@link notificationWebhookIdSchema}. The original singular routes
+// (`/api/v1/notification-webhook`) are a projection onto the one id
+// {@link DEFAULT_NOTIFICATION_WEBHOOK_ID}, so a consumer written before the collection existed
+// keeps addressing exactly the endpoint it always did.
 // ---------------------------------------------------------------------------
+/**
+ * The id of the endpoint the SINGULAR routes address. Registering through
+ * `PUT /api/v1/notification-webhook` writes this id, and it appears in the collection like any
+ * other entry, so the two surfaces describe one store rather than two.
+ */
+export const DEFAULT_NOTIFICATION_WEBHOOK_ID = 'default';
+/**
+ * How many endpoints one workspace may register. Every delivery fans out to every subscribed
+ * endpoint on a run's terminal path, so the set has to be bounded by something other than an
+ * operator's patience; ten is well above the "one receiver per integration" the collection exists
+ * to serve. Exceeding it is a 409 with `reason: 'webhook_limit_reached'`.
+ */
+export const MAX_NOTIFICATION_WEBHOOKS_PER_WORKSPACE = 10;
+/**
+ * A webhook's id: CALLER-CHOSEN, not server-minted, which is what makes enrolment idempotent for
+ * the consumer that needs it most. A gatekeeper Worker booting cold can `PUT` its own well-known
+ * id and be enrolled whether or not it has ever run before, with no id table of its own and no
+ * create-or-discover dance against a surface it may be racing another instance on.
+ *
+ * Constrained to a lowercase slug because it is a path segment on both management surfaces and an
+ * operator reads it in a log line beside the endpoint's URL.
+ */
+export const notificationWebhookIdSchema = v.pipe(v.string(), 
+// Deliberately NOT trimmed, unlike the body strings beside it. Trimming would admit `" ci "` and
+// then store `ci`, so the id a caller PUT and the id it must address afterwards would differ.
+v.regex(/^[a-z0-9][a-z0-9_-]{0,62}$/u, 'A webhook id must be 1-63 characters of lowercase letters, digits, `-` or `_`, starting with a letter or digit'));
 /**
  * The RUN-LIFECYCLE events the same endpoint can subscribe to: the ordinary lifecycle of work an
  * integration queued, none of which raises a notification. A task whose pipeline carries a
@@ -46,6 +78,13 @@ export const platformAlertEventSchema = v.picklist([
 ]);
 /** A workspace's registered notification webhook, as exposed to clients (never the secret). */
 export const notificationWebhookSchema = v.object({
+    /**
+     * Which endpoint this is, within the workspace. `default` is the one the singular
+     * `/api/v1/notification-webhook` routes address.
+     */
+    id: v.string(),
+    /** An operator-facing label. Defaults to the id when a registration supplies none. */
+    name: v.string(),
     /** The HTTPS endpoint deliveries are POSTed to. */
     url: v.string(),
     /**
@@ -91,6 +130,8 @@ export const notificationWebhookSchema = v.object({
 export const putNotificationWebhookSchema = v.object({
     /** Omit ⇒ keep the registered endpoint (required only when registering the first one). */
     url: v.optional(v.pipe(v.string(), v.trim(), v.url(), v.startsWith('https://', 'The webhook endpoint must be an https:// URL'), v.maxLength(2000))),
+    /** Omit ⇒ keep the stored label (the endpoint's id, for a registration that named none). */
+    name: v.optional(v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(100))),
     /** Omit ⇒ deliver the default parking types. */
     types: v.optional(v.array(notificationTypeSchema)),
     /** Omit ⇒ keep the current run-event subscription (none, for an endpoint that never set one). */
@@ -102,8 +143,13 @@ export const putNotificationWebhookSchema = v.object({
     secret: v.optional(v.pipe(v.string(), v.trim(), v.minLength(16), v.maxLength(200))),
 });
 /**
- * What `GET /api/v1/notification-webhook` answers: the registered endpoint, or `null` when the
- * workspace has none. Both the session surface and the public one project the SAME
+ * What `GET /api/v1/notification-webhook` and `GET /api/v1/notification-webhooks/:webhookId`
+ * answer: the addressed endpoint, or `null` when none is registered under that id. A 404 would be
+ * the conventional answer for the second one and is deliberately not used: "am I already wired
+ * up?" is the call an integration makes at startup, and it should read one response shape rather
+ * than branch on a status this surface also uses for a mistyped path.
+ *
+ * Both the session surface and the public one project the SAME
  * {@link notificationWebhookSchema}, because the projection is already the client-facing shape
  * with the secret reduced to a boolean, and a second near-identical DTO would be one more thing
  * to keep in step for no caller-visible gain.
@@ -119,6 +165,19 @@ export const publicNotificationWebhookSchema = v.object({
     /** The registered endpoint, or `null` when the workspace has none. */
     webhook: v.nullable(notificationWebhookSchema),
 });
+/**
+ * What `GET /api/v1/notification-webhooks` answers: every endpoint the workspace has registered,
+ * ordered by id so two reads of an unchanged workspace agree.
+ *
+ * Deliberately NOT paginated, unlike every other public list. Paging exists to bound a set the
+ * platform cannot bound itself, and this one is bounded at
+ * {@link MAX_NOTIFICATION_WEBHOOKS_PER_WORKSPACE} by the write path: a cursor here would hand
+ * every client a loop to write for a set that fits in one response by construction, and would
+ * quietly become the reason nobody noticed the cap had been raised.
+ */
+export const publicNotificationWebhookListSchema = v.object({
+    webhooks: v.array(notificationWebhookSchema),
+});
 /**
  * The JSON body of one webhook delivery. Deliberately a thin envelope over the SAME
  * `notificationSchema` the in-app inbox and the public `GET /api/v1/notifications` already expose

package/dist/notification-webhooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification-webhooks.js","sourceRoot":"","sources":["../src/notification-webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAE7D,8EAA8E;AAC9E,iGAAiG;AACjG,8FAA8F;AAC9F,wFAAwF;AACxF,EAAE;AACF,6FAA6F;AAC7F,6FAA6F;AAC7F,6FAA6F;AAC7F,qEAAqE;AACrE,0DAA0D;AAC1D,EAAE;AACF,iGAAiG;AACjG,+FAA+F;AAC/F,uDAAuD;AACvD,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC,CAAA;AAGjG;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,QAAQ,CAAC;IACjD,wBAAwB;IACxB,0BAA0B;CAC3B,CAAC,CAAA;AAGF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,mDAAmD;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf;;;;OAIG;IACH,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IACtC;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC3C;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;IAC9C,sFAAsF;IACtF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,6EAA6E;IAC7E,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAA;AAGF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,0FAA0F;IAC1F,GAAG,EAAE,CAAC,CAAC,QAAQ,CACb,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,IAAI,EAAE,EACR,CAAC,CAAC,GAAG,EAAE,EACP,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,8CAA8C,CAAC,EACxE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAClB,CACF;IACD,gDAAgD;IAChD,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAClD,iGAAiG;IACjG,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACvD,uGAAuG;IACvG,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAChC,wDAAwD;IACxD,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;CACpF,CAAC,CAAA;AAGF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAC/C,CAAC,CAAA;AAGF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,kGAAkG;IAClG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,4DAA4D;IAC5D,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,mEAAmE;IACnE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,YAAY,EAAE,kBAAkB;CACjC,CAAC,CAAA;AAGF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,kGAAkG;IAClG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,uBAAuB;IAC9B,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,8FAA8F;QAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,sFAAsF;QACtF,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB;;;WAGG;QACH,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACtC,oCAAoC;QACpC,OAAO,EAAE,CAAC,CAAC,QAAQ,CACjB,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC/B,CAAC,CACH;KACF,CAAC;CACH,CAAC,CAAA;AAGF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,oEAAoE;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,6FAA6F;IAC7F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,8EAA8E;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB;;;;;OAKG;IACH,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAA;AAKF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,kGAAkG;IAClG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,wBAAwB;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd;;;WAGG;QACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB;;;;WAIG;QACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB;;;WAGG;QACH,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,mCAAmC,CAAC;QACxD;;;;WAIG;QACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB;;;;;WAKG;QACH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;QAC9C;;;;WAIG;QACH,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACpC,CAAC;CACH,CAAC,CAAA;AAGF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,oBAAoB;IACpB,gBAAgB;IAChB,mBAAmB;IACnB,uBAAuB;IACvB,cAAc;IACd,mBAAmB;IACnB,WAAW;IACX,aAAa;CAC6D,CAAA"}
+{"version":3,"file":"notification-webhooks.js","sourceRoot":"","sources":["../src/notification-webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAE7D,8EAA8E;AAC9E,2FAA2F;AAC3F,6FAA6F;AAC7F,wFAAwF;AACxF,EAAE;AACF,6FAA6F;AAC7F,6FAA6F;AAC7F,6FAA6F;AAC7F,qEAAqE;AACrE,0DAA0D;AAC1D,EAAE;AACF,iGAAiG;AACjG,+FAA+F;AAC/F,uDAAuD;AACvD,EAAE;AACF,kGAAkG;AAClG,iGAAiG;AACjG,oEAAoE;AACpE,+FAA+F;AAC/F,uDAAuD;AACvD,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,SAAS,CAAA;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAG,EAAE,CAAA;AAEzD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAC/C,CAAC,CAAC,MAAM,EAAE;AACV,iGAAiG;AACjG,8FAA8F;AAC9F,CAAC,CAAC,KAAK,CACL,6BAA6B,EAC7B,gHAAgH,CACjH,CACF,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC,CAAA;AAGjG;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,QAAQ,CAAC;IACjD,wBAAwB;IACxB,0BAA0B;CAC3B,CAAC,CAAA;AAGF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD;;;OAGG;IACH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,sFAAsF;IACtF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,mDAAmD;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf;;;;OAIG;IACH,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IACtC;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC3C;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;IAC9C,sFAAsF;IACtF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,6EAA6E;IAC7E,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAA;AAGF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,0FAA0F;IAC1F,GAAG,EAAE,CAAC,CAAC,QAAQ,CACb,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,IAAI,EAAE,EACR,CAAC,CAAC,GAAG,EAAE,EACP,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,8CAA8C,CAAC,EACxE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAClB,CACF;IACD,4FAA4F;IAC5F,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAChF,gDAAgD;IAChD,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAClD,iGAAiG;IACjG,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACvD,uGAAuG;IACvG,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAChC,wDAAwD;IACxD,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;CACpF,CAAC,CAAA;AAGF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAC/C,CAAC,CAAA;AAGF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC;CAC7C,CAAC,CAAA;AAKF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,kGAAkG;IAClG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,4DAA4D;IAC5D,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,mEAAmE;IACnE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,YAAY,EAAE,kBAAkB;CACjC,CAAC,CAAA;AAGF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,kGAAkG;IAClG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,uBAAuB;IAC9B,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,8FAA8F;QAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,sFAAsF;QACtF,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB;;;WAGG;QACH,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACtC,oCAAoC;QACpC,OAAO,EAAE,CAAC,CAAC,QAAQ,CACjB,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC/B,CAAC,CACH;KACF,CAAC;CACH,CAAC,CAAA;AAGF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,oEAAoE;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,6FAA6F;IAC7F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,8EAA8E;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB;;;;;OAKG;IACH,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAA;AAKF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,kGAAkG;IAClG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,wBAAwB;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd;;;WAGG;QACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB;;;;WAIG;QACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB;;;WAGG;QACH,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,mCAAmC,CAAC;QACxD;;;;WAIG;QACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB;;;;;WAKG;QACH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;QAC9C;;;;WAIG;QACH,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACpC,CAAC;CACH,CAAC,CAAA;AAGF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,oBAAoB;IACpB,gBAAgB;IAChB,mBAAmB;IACnB,uBAAuB;IACvB,cAAc;IACd,mBAAmB;IACnB,WAAW;IACX,aAAa;CAC6D,CAAA"}

package/dist/pr-report.d.ts

@@ -7,7 +7,7 @@ import * as v from 'valibot';
  * (see the header), so a bump means "there is more here than there was", and a consumer written
  * against an older number keeps reading the fields it knows.
  */
-export declare const PR_VERIFICATION_REPORT_VERSION = 8;
+export declare const PR_VERIFICATION_REPORT_VERSION = 9;
 /**
  * How much of one captured command log the report carries, per command.
  *
@@ -812,6 +812,98 @@ export declare const prReportJudgesSchema: v.ObjectSchema<{
     }, undefined>, undefined>;
 }, undefined>;
 export type PrReportJudges = v.InferOutput<typeof prReportJudgesSchema>;
+/**
+ * One linked document the run's agents built from, and what the platform could prove about how
+ * CURRENT the copy they read was.
+ *
+ * Every other section of this report answers "what did the run produce, and what checked it".
+ * This one answers the question underneath all of them: what was the run working FROM. A design
+ * under active iteration is where it bites, because a reviewer looking at a frontend PR has no
+ * way to tell an implementation that misreads the design from one that faithfully implements a
+ * revision the designer has since moved past. Those need opposite reactions and, without this,
+ * arrive looking identical.
+ *
+ * Composed from what each dispatch RECORDED (`step.contextDocuments`), never from a fresh probe:
+ * the source has moved on by compose time, so a re-probe would answer about a revision no agent
+ * on this run ever read, and the report would disagree with the run it describes.
+ */
+export declare const prReportContextDocumentSchema: v.ObjectSchema<{
+    readonly title: v.StringSchema<undefined>;
+    /** The document's canonical URL, so a reviewer can open the revision themselves. */
+    readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Which source it came from (`figma`, `notion`, an `upload`, …). */
+    readonly origin: v.PicklistSchema<["confluence", "notion", "github", "figma", "zeplin", "linear", "upload"], undefined>;
+    /**
+     * The verdict recorded by the LAST dispatch that read this document, which is the state the
+     * run ended on. Absent means the deployment ran no freshness check at all, which is NOT the
+     * same as an `unconfirmed` verdict: nobody asked, versus asked and could not tell.
+     */
+    readonly freshness: v.OptionalSchema<v.VariantSchema<"status", [v.ObjectSchema<{
+        readonly status: v.LiteralSchema<"confirmed", undefined>;
+        readonly version: v.StringSchema<undefined>;
+        readonly change: v.PicklistSchema<["unchanged", "reimported", "revision_only"], undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly status: v.LiteralSchema<"not-applicable", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly status: v.LiteralSchema<"unconfirmed", undefined>;
+        readonly reason: v.PicklistSchema<["not_connected", "credentials_unreadable", "unversioned", "source_unreachable"], undefined>;
+    }, undefined>], undefined>, undefined>;
+    /**
+     * True when the run's own steps recorded more than one distinct revision of this document:
+     * the source moved WHILE the run was in flight, so its earlier steps built against something
+     * its later ones did not.
+     *
+     * Computed in code from the recorded verdicts, never asserted by a model, and reported
+     * separately from the final revision because the two carry opposite reassurance: the last
+     * revision alone says the run ended current, and says nothing about the coder step that
+     * finished before the design changed under it.
+     */
+    readonly movedDuringRun: v.BooleanSchema<undefined>;
+}, undefined>;
+export type PrReportContextDocument = v.InferOutput<typeof prReportContextDocumentSchema>;
+/**
+ * The documents the run built from. `absent` when no step recorded one, which covers the
+ * ordinary task carrying no attachment and no document link in its description.
+ */
+export declare const prReportContextSchema: v.ObjectSchema<{
+    readonly status: v.PicklistSchema<["reported", "absent"], undefined>;
+    /** Says why the section is empty when `status` is `absent`. */
+    readonly note: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly documents: v.ArraySchema<v.ObjectSchema<{
+        readonly title: v.StringSchema<undefined>;
+        /** The document's canonical URL, so a reviewer can open the revision themselves. */
+        readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /** Which source it came from (`figma`, `notion`, an `upload`, …). */
+        readonly origin: v.PicklistSchema<["confluence", "notion", "github", "figma", "zeplin", "linear", "upload"], undefined>;
+        /**
+         * The verdict recorded by the LAST dispatch that read this document, which is the state the
+         * run ended on. Absent means the deployment ran no freshness check at all, which is NOT the
+         * same as an `unconfirmed` verdict: nobody asked, versus asked and could not tell.
+         */
+        readonly freshness: v.OptionalSchema<v.VariantSchema<"status", [v.ObjectSchema<{
+            readonly status: v.LiteralSchema<"confirmed", undefined>;
+            readonly version: v.StringSchema<undefined>;
+            readonly change: v.PicklistSchema<["unchanged", "reimported", "revision_only"], undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly status: v.LiteralSchema<"not-applicable", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly status: v.LiteralSchema<"unconfirmed", undefined>;
+            readonly reason: v.PicklistSchema<["not_connected", "credentials_unreadable", "unversioned", "source_unreachable"], undefined>;
+        }, undefined>], undefined>, undefined>;
+        /**
+         * True when the run's own steps recorded more than one distinct revision of this document:
+         * the source moved WHILE the run was in flight, so its earlier steps built against something
+         * its later ones did not.
+         *
+         * Computed in code from the recorded verdicts, never asserted by a model, and reported
+         * separately from the final revision because the two carry opposite reassurance: the last
+         * revision alone says the run ended current, and says nothing about the coder step that
+         * finished before the design changed under it.
+         */
+        readonly movedDuringRun: v.BooleanSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type PrReportContext = v.InferOutput<typeof prReportContextSchema>;
 /**
  * One spec requirement joined to what the Tester observed about it — the report's
  * REQUIREMENT → EVIDENCE row.
@@ -1058,6 +1150,45 @@ export declare const prVerificationReportSchema: v.ObjectSchema<{
             readonly url: v.StringSchema<undefined>;
         }, undefined>, undefined>;
     }, undefined>;
+    /** What the run built FROM: the linked documents its agents read, at which revision. */
+    readonly context: v.ObjectSchema<{
+        readonly status: v.PicklistSchema<["reported", "absent"], undefined>;
+        /** Says why the section is empty when `status` is `absent`. */
+        readonly note: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly documents: v.ArraySchema<v.ObjectSchema<{
+            readonly title: v.StringSchema<undefined>;
+            /** The document's canonical URL, so a reviewer can open the revision themselves. */
+            readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            /** Which source it came from (`figma`, `notion`, an `upload`, …). */
+            readonly origin: v.PicklistSchema<["confluence", "notion", "github", "figma", "zeplin", "linear", "upload"], undefined>;
+            /**
+             * The verdict recorded by the LAST dispatch that read this document, which is the state the
+             * run ended on. Absent means the deployment ran no freshness check at all, which is NOT the
+             * same as an `unconfirmed` verdict: nobody asked, versus asked and could not tell.
+             */
+            readonly freshness: v.OptionalSchema<v.VariantSchema<"status", [v.ObjectSchema<{
+                readonly status: v.LiteralSchema<"confirmed", undefined>;
+                readonly version: v.StringSchema<undefined>;
+                readonly change: v.PicklistSchema<["unchanged", "reimported", "revision_only"], undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly status: v.LiteralSchema<"not-applicable", undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly status: v.LiteralSchema<"unconfirmed", undefined>;
+                readonly reason: v.PicklistSchema<["not_connected", "credentials_unreadable", "unversioned", "source_unreachable"], undefined>;
+            }, undefined>], undefined>, undefined>;
+            /**
+             * True when the run's own steps recorded more than one distinct revision of this document:
+             * the source moved WHILE the run was in flight, so its earlier steps built against something
+             * its later ones did not.
+             *
+             * Computed in code from the recorded verdicts, never asserted by a model, and reported
+             * separately from the final revision because the two carry opposite reassurance: the last
+             * revision alone says the run ended current, and says nothing about the coder step that
+             * finished before the design changed under it.
+             */
+            readonly movedDuringRun: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
     readonly ci: v.ObjectSchema<{
         readonly status: v.PicklistSchema<["reported", "absent"], undefined>;
         /** Says why the section is empty when `status` is `absent`. */

package/dist/pr-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr-report.d.ts","sourceRoot":"","sources":["../src/pr-report.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pr-report.d.ts","sourceRoot":"","sources":["../src/pr-report.ts"],"names":[],"mappings":"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"}

package/dist/pr-report.js

@@ -1,6 +1,7 @@
 import * as v from 'valibot';
 import { mergeAssessmentSchema } from './merge.js';
 import { judgeDispositionSchema, judgeFindingSchema, judgeModelPinSchema } from './judge.js';
+import { documentFreshnessSchema, documentOriginSchema } from './documents.js';
 import { requirementPrioritySchema, requirementStateSchema } from './spec.js';
 import { reproductionStatusSchema } from './reproduction.js';
 import { requirementVerdictStatusSchema, testEnvironmentSchema } from './testing.js';
@@ -37,7 +38,7 @@ import { vcsProviderSchema } from './routes/auth.js';
  * (see the header), so a bump means "there is more here than there was", and a consumer written
  * against an older number keeps reading the fields it knows.
  */
-export const PR_VERIFICATION_REPORT_VERSION = 8;
+export const PR_VERIFICATION_REPORT_VERSION = 9;
 /**
  * How much of one captured command log the report carries, per command.
  *
@@ -592,6 +593,55 @@ export const prReportJudgesSchema = v.object({
     note: v.optional(v.nullable(v.string())),
     verdicts: v.array(prReportJudgeSchema),
 });
+/**
+ * One linked document the run's agents built from, and what the platform could prove about how
+ * CURRENT the copy they read was.
+ *
+ * Every other section of this report answers "what did the run produce, and what checked it".
+ * This one answers the question underneath all of them: what was the run working FROM. A design
+ * under active iteration is where it bites, because a reviewer looking at a frontend PR has no
+ * way to tell an implementation that misreads the design from one that faithfully implements a
+ * revision the designer has since moved past. Those need opposite reactions and, without this,
+ * arrive looking identical.
+ *
+ * Composed from what each dispatch RECORDED (`step.contextDocuments`), never from a fresh probe:
+ * the source has moved on by compose time, so a re-probe would answer about a revision no agent
+ * on this run ever read, and the report would disagree with the run it describes.
+ */
+export const prReportContextDocumentSchema = v.object({
+    title: v.string(),
+    /** The document's canonical URL, so a reviewer can open the revision themselves. */
+    url: v.nullable(v.string()),
+    /** Which source it came from (`figma`, `notion`, an `upload`, …). */
+    origin: documentOriginSchema,
+    /**
+     * The verdict recorded by the LAST dispatch that read this document, which is the state the
+     * run ended on. Absent means the deployment ran no freshness check at all, which is NOT the
+     * same as an `unconfirmed` verdict: nobody asked, versus asked and could not tell.
+     */
+    freshness: v.optional(documentFreshnessSchema),
+    /**
+     * True when the run's own steps recorded more than one distinct revision of this document:
+     * the source moved WHILE the run was in flight, so its earlier steps built against something
+     * its later ones did not.
+     *
+     * Computed in code from the recorded verdicts, never asserted by a model, and reported
+     * separately from the final revision because the two carry opposite reassurance: the last
+     * revision alone says the run ended current, and says nothing about the coder step that
+     * finished before the design changed under it.
+     */
+    movedDuringRun: v.boolean(),
+});
+/**
+ * The documents the run built from. `absent` when no step recorded one, which covers the
+ * ordinary task carrying no attachment and no document link in its description.
+ */
+export const prReportContextSchema = v.object({
+    status: prReportSectionStatusSchema,
+    /** Says why the section is empty when `status` is `absent`. */
+    note: v.optional(v.nullable(v.string())),
+    documents: v.array(prReportContextDocumentSchema),
+});
 /**
  * One spec requirement joined to what the Tester observed about it — the report's
  * REQUIREMENT → EVIDENCE row.
@@ -753,6 +803,8 @@ export const prVerificationReportSchema = v.object({
      */
     scope: v.optional(prReportScopeSchema),
     run: prReportRunSchema,
+    /** What the run built FROM: the linked documents its agents read, at which revision. */
+    context: prReportContextSchema,
     ci: prReportCiSchema,
     /** The platform's OWN run of the service's check commands against the pushed tree. */
     validation: prReportValidationSchema,