@sourcey/catalog-verifier 1.1.22 → 1.1.24

package/dist/contracts/agent-readiness/src/shared.d.ts

@@ -59,54 +59,88 @@ export declare const agentReadinessSurfaceReferenceSchema: z.ZodObject<{
     }>;
     node_id: z.ZodString;
 }, z.core.$strict>;
-/** A revision rests on at most this many runs: its latest and the earlier refusals it reproduces. */
-export declare const AGENT_READINESS_MAXIMUM_REVISION_RUNS = 4;
-/** The Operate path, in order: how a principal's authority becomes a completed, confirmed job. */
-export declare const AGENT_READINESS_STEPS: readonly ["discover", "delegation", "pay", "job", "confirm", "sustain"];
+/**
+ * The earlier runs of each group a refresh reads, newest first: the profile's
+ * probe runs, and each binding's (north star §5.4).
+ */
+export declare const AGENT_READINESS_PRIOR_RUNS_READ = 4;
+/** The most runs a policy asks to hold one finding before it counts (its reproduction's `attempts`). */
+export declare const AGENT_READINESS_MAXIMUM_ATTEMPTS = 2;
+/**
+ * A revision rests on at most this many runs: its probe runs from the earliest
+ * its grade rests on through the latest (the earlier ones a refresh reads, and
+ * its own), and its binding's runs that decide.
+ */
+export declare const AGENT_READINESS_MAXIMUM_REVISION_RUNS: number;
+/**
+ * The roles of the pages a person's or a vendor's step happens on, which a
+ * listing names and the probe requests (north star §5.3).
+ */
+export declare const AGENT_READINESS_PAGE_ROLES: readonly ["registration", "access_request", "access_setting", "checkout"];
+/** A probe run requests each declared page once, and a listing names at most this many. */
+export declare const AGENT_READINESS_MAXIMUM_PAGES = 8;
+/**
+ * The path, in the shape's order: the agent finds the job, gets authority for
+ * it, registers, pays, confirms, and keeps its access up (north star §5.1).
+ */
+export declare const AGENT_READINESS_STEPS: readonly ["discover", "authority", "onboard", "pay", "confirm", "sustain"];
 export declare const agentReadinessStepSchema: z.ZodEnum<{
+    authority: "authority";
     confirm: "confirm";
-    delegation: "delegation";
     discover: "discover";
-    job: "job";
+    onboard: "onboard";
     pay: "pay";
     sustain: "sustain";
 }>;
 export type AgentReadinessStep = z.infer<typeof agentReadinessStepSchema>;
 /**
- * What happened at one step: done by the agent, a legitimate principal decision,
- * a human doing the agent's work, reproducibly impossible, proved absent by the
- * executed path, or not yet evidenced.
+ * What happened at one step (north star §5.2): done by the agent, absent
+ * (nothing to do), a principal's one-time decision, a person doing the
+ * agent's work, or a vendor's decision standing in the way. `not_assessed` is
+ * a step a run did not settle; a published revision holds one only on an F
+ * card whose listing names no interface for the job.
  */
 export declare const agentReadinessStepOutcomeSchema: z.ZodEnum<{
     approval: "approval";
-    blocked: "blocked";
+    gated: "gated";
     machine: "machine";
     not_applicable: "not_applicable";
     not_assessed: "not_assessed";
     workaround: "workaround";
 }>;
 export type AgentReadinessStepOutcome = z.infer<typeof agentReadinessStepOutcomeSchema>;
-/** Once per principal or credential lifetime, or on every job, purchase or period. */
-export declare const agentReadinessHandoffTimingSchema: z.ZodEnum<{
+/**
+ * The job itself, which is not a step (north star §5.1): an interface for it
+ * answers and the job has not been run, a run did it, or no machine interface
+ * performs it (F). `not_assessed` until the probes settle it.
+ */
+export declare const agentReadinessJobOutcomeSchema: z.ZodEnum<{
+    not_assessed: "not_assessed";
+    reachable: "reachable";
+    unavailable: "unavailable";
+    verified: "verified";
+}>;
+export type AgentReadinessJobOutcome = z.infer<typeof agentReadinessJobOutcomeSchema>;
+/** Once (per principal or credential lifetime), or every run, purchase or period. */
+export declare const agentReadinessHumanStepTimingSchema: z.ZodEnum<{
     recurring: "recurring";
     setup: "setup";
 }>;
-export declare const agentReadinessOperateLetterSchema: z.ZodEnum<{
+/** The scale, best first (north star §5.7). */
+export declare const agentReadinessLetterSchema: z.ZodEnum<{
     A: "A";
     "A+": "A+";
     B: "B";
     "B+": "B+";
     C: "C";
-    "C+": "C+";
     D: "D";
     F: "F";
 }>;
-export type AgentReadinessOperateLetter = z.infer<typeof agentReadinessOperateLetterSchema>;
-/** 1 no account needed … 6 sales-gated; absence is "not yet assessed". */
-export declare const agentReadinessOnboardLevelSchema: z.ZodNumber;
+export type AgentReadinessLetter = z.infer<typeof agentReadinessLetterSchema>;
 export declare const agentReadinessEvidenceLabelSchema: z.ZodEnum<{
     probed: "probed";
     sourcey_run: "sourcey_run";
     vendor_run_verified: "vendor_run_verified";
 }>;
+export type AgentReadinessEvidenceLabel = z.infer<typeof agentReadinessEvidenceLabelSchema>;
 //# sourceMappingURL=shared.d.ts.map

package/dist/contracts/agent-readiness/src/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../contracts/agent-readiness/src/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,0BAA0B,aAAmC,CAAC;AAC3E,eAAO,MAAM,4BAA4B,aAAsC,CAAC;AAChF,eAAO,MAAM,2BAA2B,aAAqC,CAAC;AAC9E,eAAO,MAAM,6BAA6B,aAAuD,CAAC;AAClG,eAAO,MAAM,8BAA8B,aAAuC,CAAC;AACnF,eAAO,MAAM,2BAA2B,kBAAmC,CAAC;AAC5E,eAAO,MAAM,4BAA4B,aAAiC,CAAC;AAC3E,eAAO,MAAM,4BAA4B,aAKqD,CAAC;AAE/F,yFAAyF;AACzF,eAAO,MAAM,6BAA6B;;;EAA6B,CAAC;AASxE,uFAAuF;AACvF,eAAO,MAAM,yBAAyB;;;;;;;;;kBAK3B,CAAC;AAEZ,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,EAC/C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAC/C,OAAO,CAET;AAED,eAAO,MAAM,kCAAkC;;;kBAKpC,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;EAe3C,CAAC;AAEH,eAAO,MAAM,mCAAmC;;;;;EAK9C,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;kBAKtC,CAAC;AAEZ,qGAAqG;AACrG,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD,kGAAkG;AAClG,eAAO,MAAM,qBAAqB,YAChC,UAAU,EACV,YAAY,EACZ,KAAK,EACL,KAAK,EACL,SAAS,EACT,SAAS,CACD,CAAC;AACX,eAAO,MAAM,wBAAwB;;;;;;;EAAgC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;;EAO1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,sFAAsF;AACtF,eAAO,MAAM,iCAAiC;;;EAAiC,CAAC;AAEhF,eAAO,MAAM,iCAAiC;;;;;;;;;EAS5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,0EAA0E;AAC1E,eAAO,MAAM,gCAAgC,aAAiC,CAAC;AAE/E,eAAO,MAAM,iCAAiC;;;;EAI5C,CAAC"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../contracts/agent-readiness/src/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,0BAA0B,aAAmC,CAAC;AAC3E,eAAO,MAAM,4BAA4B,aAAsC,CAAC;AAChF,eAAO,MAAM,2BAA2B,aAAqC,CAAC;AAC9E,eAAO,MAAM,6BAA6B,aAAuD,CAAC;AAClG,eAAO,MAAM,8BAA8B,aAAuC,CAAC;AACnF,eAAO,MAAM,2BAA2B,kBAAmC,CAAC;AAC5E,eAAO,MAAM,4BAA4B,aAAiC,CAAC;AAC3E,eAAO,MAAM,4BAA4B,aAKqD,CAAC;AAE/F,yFAAyF;AACzF,eAAO,MAAM,6BAA6B;;;EAA6B,CAAC;AASxE,uFAAuF;AACvF,eAAO,MAAM,yBAAyB;;;;;;;;;kBAK3B,CAAC;AAEZ,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,EAC/C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAC/C,OAAO,CAET;AAED,eAAO,MAAM,kCAAkC;;;kBAKpC,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;EAe3C,CAAC;AAEH,eAAO,MAAM,mCAAmC;;;;;EAK9C,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;kBAKtC,CAAC;AAEZ;;;GAGG;AACH,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,wGAAwG;AACxG,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,qCAAqC,QACsB,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,0BAA0B,YACrC,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,CACF,CAAC;AAEX,2FAA2F;AAC3F,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,YAChC,UAAU,EACV,WAAW,EACX,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS,CACD,CAAC;AACX,eAAO,MAAM,wBAAwB;;;;;;;EAAgC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;;;;;;EAO1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;EAKzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,qFAAqF;AACrF,eAAO,MAAM,mCAAmC;;;EAAiC,CAAC;AAElF,+CAA+C;AAC/C,eAAO,MAAM,0BAA0B;;;;;;;;EAAgD,CAAC;AACxF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,iCAAiC;;;;EAI5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC"}

package/dist/contracts/agent-readiness/src/shared.js

@@ -66,45 +66,74 @@ export const agentReadinessSurfaceReferenceSchema = z
     node_id: agentReadinessScopeKeySchema,
 })
     .strict();
-/** A revision rests on at most this many runs: its latest and the earlier refusals it reproduces. */
-export const AGENT_READINESS_MAXIMUM_REVISION_RUNS = 4;
-/** The Operate path, in order: how a principal's authority becomes a completed, confirmed job. */
+/**
+ * The earlier runs of each group a refresh reads, newest first: the profile's
+ * probe runs, and each binding's (north star §5.4).
+ */
+export const AGENT_READINESS_PRIOR_RUNS_READ = 4;
+/** The most runs a policy asks to hold one finding before it counts (its reproduction's `attempts`). */
+export const AGENT_READINESS_MAXIMUM_ATTEMPTS = 2;
+/**
+ * A revision rests on at most this many runs: its probe runs from the earliest
+ * its grade rests on through the latest (the earlier ones a refresh reads, and
+ * its own), and its binding's runs that decide.
+ */
+export const AGENT_READINESS_MAXIMUM_REVISION_RUNS = AGENT_READINESS_PRIOR_RUNS_READ + 1 + AGENT_READINESS_MAXIMUM_ATTEMPTS;
+/**
+ * The roles of the pages a person's or a vendor's step happens on, which a
+ * listing names and the probe requests (north star §5.3).
+ */
+export const AGENT_READINESS_PAGE_ROLES = [
+    "registration",
+    "access_request",
+    "access_setting",
+    "checkout",
+];
+/** A probe run requests each declared page once, and a listing names at most this many. */
+export const AGENT_READINESS_MAXIMUM_PAGES = 8;
+/**
+ * The path, in the shape's order: the agent finds the job, gets authority for
+ * it, registers, pays, confirms, and keeps its access up (north star §5.1).
+ */
 export const AGENT_READINESS_STEPS = [
     "discover",
-    "delegation",
+    "authority",
+    "onboard",
     "pay",
-    "job",
     "confirm",
     "sustain",
 ];
 export const agentReadinessStepSchema = z.enum(AGENT_READINESS_STEPS);
 /**
- * What happened at one step: done by the agent, a legitimate principal decision,
- * a human doing the agent's work, reproducibly impossible, proved absent by the
- * executed path, or not yet evidenced.
+ * What happened at one step (north star §5.2): done by the agent, absent
+ * (nothing to do), a principal's one-time decision, a person doing the
+ * agent's work, or a vendor's decision standing in the way. `not_assessed` is
+ * a step a run did not settle; a published revision holds one only on an F
+ * card whose listing names no interface for the job.
  */
 export const agentReadinessStepOutcomeSchema = z.enum([
     "machine",
+    "not_applicable",
     "approval",
     "workaround",
-    "blocked",
-    "not_applicable",
+    "gated",
     "not_assessed",
 ]);
-/** Once per principal or credential lifetime, or on every job, purchase or period. */
-export const agentReadinessHandoffTimingSchema = z.enum(["setup", "recurring"]);
-export const agentReadinessOperateLetterSchema = z.enum([
-    "A+",
-    "A",
-    "B+",
-    "B",
-    "C+",
-    "C",
-    "D",
-    "F",
+/**
+ * The job itself, which is not a step (north star §5.1): an interface for it
+ * answers and the job has not been run, a run did it, or no machine interface
+ * performs it (F). `not_assessed` until the probes settle it.
+ */
+export const agentReadinessJobOutcomeSchema = z.enum([
+    "reachable",
+    "verified",
+    "unavailable",
+    "not_assessed",
 ]);
-/** 1 no account needed … 6 sales-gated; absence is "not yet assessed". */
-export const agentReadinessOnboardLevelSchema = z.number().int().min(1).max(6);
+/** Once (per principal or credential lifetime), or every run, purchase or period. */
+export const agentReadinessHumanStepTimingSchema = z.enum(["setup", "recurring"]);
+/** The scale, best first (north star §5.7). */
+export const agentReadinessLetterSchema = z.enum(["A+", "A", "B+", "B", "C", "D", "F"]);
 export const agentReadinessEvidenceLabelSchema = z.enum([
     "sourcey_run",
     "vendor_run_verified",

package/dist/contracts/agent-readiness/src/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../contracts/agent-readiness/src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,kCAAkC,EAClC,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kDAAkD,CAAC;AAE1D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;AAClG,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,EAAE;KACR,IAAI,EAAE;KACN,WAAW,EAAE;KACb,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,oFAAoF,CAAC,CAAC;AAE/F,yFAAyF;AACzF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAExE,MAAM,gCAAgC,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,GAAG,EAAE,4BAA4B;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACjC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,uFAAuF;AACvF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,OAAO,EAAE,gCAAgC;IACzC,GAAG,EAAE,gCAAgC;CACtC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,+BAA+B,CAC7C,IAA+C,EAC/C,KAAgD;IAEhD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,eAAe,EAAE,0BAA0B;IAC3C,sBAAsB,EAAE,0BAA0B;CACnD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,IAAI,CAAC;IACrD,WAAW;IACX,OAAO;IACP,aAAa;IACb,SAAS;IACT,QAAQ;IACR,UAAU;IACV,cAAc;IACd,YAAY;IACZ,UAAU;IACV,gBAAgB;IAChB,YAAY;IACZ,eAAe;IACf,QAAQ;IACR,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,IAAI,CAAC;IACxD,UAAU;IACV,UAAU;IACV,WAAW;IACX,mBAAmB;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC;KAClD,MAAM,CAAC;IACN,SAAS,EAAE,mCAAmC;IAC9C,OAAO,EAAE,4BAA4B;CACtC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,qGAAqG;AACrG,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC;AAEvD,kGAAkG;AAClG,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,UAAU;IACV,YAAY;IACZ,KAAK;IACL,KAAK;IACL,SAAS;IACT,SAAS;CACD,CAAC;AACX,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAGtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,IAAI,CAAC;IACpD,SAAS;IACT,UAAU;IACV,YAAY;IACZ,SAAS;IACT,gBAAgB;IAChB,cAAc;CACf,CAAC,CAAC;AAGH,sFAAsF;AACtF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAEhF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,IAAI,CAAC;IACtD,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,GAAG;IACH,GAAG;IACH,GAAG;CACJ,CAAC,CAAC;AAGH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE/E,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,IAAI,CAAC;IACtD,aAAa;IACb,qBAAqB;IACrB,QAAQ;CACT,CAAC,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../contracts/agent-readiness/src/shared.ts"],"names":[],"mappings":"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"}

package/dist/contracts/agent-readiness/src/surfaces.d.ts

@@ -0,0 +1,25 @@
+import type { z } from "zod";
+/**
+ * What the probe reads of a listing's own surfaces: the roles it rules out, its
+ * checkout or that the job needs none, and the pages a person's or a vendor's
+ * step happens on, each requested once, an access setting on the interface it
+ * turns on.
+ */
+export declare function validateProbedSurfaces(value: {
+    readonly resources: readonly {
+        readonly roles: readonly string[];
+    }[];
+    readonly endpoints: readonly {
+        readonly endpoint_id: string;
+        readonly roles: readonly string[];
+    }[];
+    readonly interfaces: readonly {
+        readonly endpoint_ids: readonly string[];
+    }[];
+    readonly job_operations: readonly unknown[];
+    readonly surface_exclusions: readonly {
+        readonly exclusion_id: string;
+        readonly role: string;
+    }[];
+}, context: z.RefinementCtx): void;
+//# sourceMappingURL=surfaces.d.ts.map

package/dist/contracts/agent-readiness/src/surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../../../contracts/agent-readiness/src/surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE;IACL,QAAQ,CAAC,SAAS,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACrE,QAAQ,CAAC,SAAS,EAAE,SAAS;QAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;KACnC,EAAE,CAAC;IACJ,QAAQ,CAAC,UAAU,EAAE,SAAS;QAAE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC7E,QAAQ,CAAC,cAAc,EAAE,SAAS,OAAO,EAAE,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,SAAS;QACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;CACL,EACD,OAAO,EAAE,CAAC,CAAC,aAAa,GACvB,IAAI,CAuEN"}

package/dist/contracts/agent-readiness/src/surfaces.js

@@ -0,0 +1,76 @@
+import { AGENT_READINESS_MAXIMUM_PAGES, AGENT_READINESS_PAGE_ROLES } from "./shared.js";
+/**
+ * What the probe reads of a listing's own surfaces: the roles it rules out, its
+ * checkout or that the job needs none, and the pages a person's or a vendor's
+ * step happens on, each requested once, an access setting on the interface it
+ * turns on.
+ */
+export function validateProbedSurfaces(value, context) {
+    const ruledOut = value.surface_exclusions;
+    const exclusionIds = ruledOut.map(({ exclusion_id }) => exclusion_id);
+    if (new Set(exclusionIds).size !== exclusionIds.length) {
+        context.addIssue({
+            code: "custom",
+            path: ["surface_exclusions"],
+            message: "Surface exclusion IDs must be unique.",
+        });
+    }
+    const roles = ruledOut.map(({ role }) => role);
+    if (new Set(roles).size !== roles.length) {
+        context.addIssue({
+            code: "custom",
+            path: ["surface_exclusions"],
+            message: "A surface role may be excluded only once.",
+        });
+    }
+    const declared = new Set(value.resources.flatMap((resource) => resource.roles));
+    for (const [index, surface] of ruledOut.entries()) {
+        if (declared.has(surface.role)) {
+            context.addIssue({
+                code: "custom",
+                path: ["surface_exclusions", index, "role"],
+                message: `Role '${surface.role}' is declared by a resource and cannot also be excluded.`,
+            });
+        }
+    }
+    // An access setting turns on the interface that lists it (north star §5.6, Onboard).
+    const listed = new Set(value.interfaces.flatMap(({ endpoint_ids }) => endpoint_ids));
+    for (const [index, endpoint] of value.endpoints.entries()) {
+        if (endpoint.roles.includes("access_setting") && !listed.has(endpoint.endpoint_id)) {
+            context.addIssue({
+                code: "custom",
+                path: ["endpoints", index, "roles"],
+                message: "An access setting is listed by the interface it turns on.",
+            });
+        }
+    }
+    // Pay rests on the checkout the listing names, or on the listing ruling it out (north star §5.6).
+    const checkoutNamed = declared.has("checkout") ||
+        value.endpoints.some((endpoint) => endpoint.roles.includes("checkout"));
+    const checkoutRuledOut = roles.includes("checkout");
+    if (checkoutNamed && checkoutRuledOut) {
+        context.addIssue({
+            code: "custom",
+            path: ["surface_exclusions"],
+            message: "A declaration names its checkout or rules it out, not both.",
+        });
+    }
+    if (value.job_operations.length > 0 && !checkoutNamed && !checkoutRuledOut) {
+        context.addIssue({
+            code: "custom",
+            path: ["surface_exclusions"],
+            message: "A declaration with job operations names its checkout, or rules it out where the job needs none.",
+        });
+    }
+    const pageRole = (role) => AGENT_READINESS_PAGE_ROLES.includes(role);
+    const pages = value.endpoints.flatMap(({ roles }) => roles.filter(pageRole)).length +
+        value.resources.flatMap(({ roles }) => roles.filter((role) => role === "checkout")).length;
+    if (pages > AGENT_READINESS_MAXIMUM_PAGES) {
+        context.addIssue({
+            code: "custom",
+            path: ["endpoints"],
+            message: `A declaration names at most ${AGENT_READINESS_MAXIMUM_PAGES} pages for a person's or a vendor's step.`,
+        });
+    }
+}
+//# sourceMappingURL=surfaces.js.map

package/dist/contracts/agent-readiness/src/surfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.js","sourceRoot":"","sources":["../../../../contracts/agent-readiness/src/surfaces.ts"],"names":[],"mappings":"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"}