@sourcey/catalog-verifier 1.1.4 → 1.1.5

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

@@ -0,0 +1,308 @@
+import { EXCHANGE_METHODS, verifyExchangeRecord, } from "provenry/exchange/records";
+import { ACTOR_IDENTIFIER_PATTERN, compareInstants } from "provenry/primitives";
+import { z } from "zod";
+import { agentReadinessDigestSchema, agentReadinessEntityIdSchema, agentReadinessEvidenceLabelSchema, agentReadinessHandoffTimingSchema, agentReadinessInstantSchema, agentReadinessScopeKeySchema, agentReadinessStepOutcomeSchema, agentReadinessStepSchema, } from "./shared.js";
+/**
+ * One assessment run as evidence: what was discovered, every exchange made (by
+ * its sealed exchange record and retained outcome), where each credential came
+ * from, every human step a runner recorded, and whether each library assertion
+ * held. Step outcomes and the letter are derived from run records by the
+ * engine, so anyone holding the records re-derives the same rating.
+ */
+const AGENT_READINESS_RUN_CONTRACT = "sourcey.agent-readiness-run/v1alpha1";
+const nameSchema = z.string().regex(/^[a-z][a-z0-9_]{0,63}$/u);
+const reasonSchema = z.string().trim().min(1).max(300);
+export const agentReadinessRunKindSchema = z.enum(["operate", "onboard", "operate_onboard"]);
+/** An agent-facing fact a descriptor on the service's domain states. */
+export const agentReadinessDiscoveryFactSchema = z
+    .object({
+    fact: z.enum([
+        "mcp_endpoint",
+        "openapi_server",
+        "oauth_protected_resource",
+        "oauth_authorization_server",
+        "ard_entry",
+        "api_catalog_link",
+        "agent_registration",
+        "payment_manifest",
+        /** A descriptor was found in a version or shape no adapter reads. */
+        "unsupported_descriptor",
+    ]),
+    /** The URL the descriptor names. */
+    value: z.url({ protocol: /^https$/u }),
+    descriptor_url: z.url({ protocol: /^https$/u }),
+    /** The Provenry capture attempt that retrieved the descriptor. */
+    attempt_digest: agentReadinessDigestSchema,
+    adapter: z
+        .object({ namespace: z.string().min(1).max(160), version: z.string().min(1).max(80) })
+        .strict(),
+})
+    .strict();
+export const agentReadinessRunExchangeSchema = z
+    .object({
+    purpose: z.enum([
+        "delegation",
+        "job",
+        "error_probe",
+        "sustain_rotation",
+        "sustain_revocation",
+        "sustain_baseline",
+        "sustain_rotated_probe",
+        "sustain_revoked_probe",
+        "sustain_control_probe",
+        "cleanup",
+    ]),
+    call_id: agentReadinessScopeKeySchema,
+    /** The request itself, or an MCP session's opening, tool listing or close. */
+    role: z.enum(["request", "session_opening", "tool_listing", "session_close"]),
+    /** The sealed record of what was sent and what came back; never a secret. */
+    record: z.custom((value) => {
+        try {
+            verifyExchangeRecord(value);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }, "Expected a sealed exchange record."),
+    /** The retained outcome (readable body and anything custody kept), held privately. */
+    outcome_digest: agentReadinessDigestSchema,
+})
+    .strict();
+export const agentReadinessCredentialSourceSchema = z
+    .object({
+    role: nameSchema,
+    handle_digest: agentReadinessDigestSchema,
+    source: z.discriminatedUnion("kind", [
+        z.object({ kind: z.literal("entered") }).strict(),
+        z
+            .object({
+            kind: z.literal("issued"),
+            exchange_digest: agentReadinessDigestSchema,
+            pointer: z.string().max(256),
+        })
+            .strict(),
+    ]),
+})
+    .strict();
+/** A human step a runner recorded as it happened. */
+export const agentReadinessHandoffSchema = z
+    .object({
+    step: agentReadinessStepSchema,
+    kind: z.enum(["approval", "workaround"]),
+    timing: agentReadinessHandoffTimingSchema,
+    statement: reasonSchema,
+    recorded_by: z.string().max(128).regex(ACTOR_IDENTIFIER_PATTERN),
+    recorded_at: agentReadinessInstantSchema,
+})
+    .strict();
+export const agentReadinessAssertionResultSchema = z
+    .object({
+    assertion: nameSchema,
+    holds: z.boolean(),
+    /** The first check that did not hold, and why. */
+    failure: z
+        .object({ check: z.number().int().nonnegative(), reason: reasonSchema })
+        .strict()
+        .nullable(),
+})
+    .strict()
+    .refine((result) => result.holds === (result.failure === null), {
+    message: "An assertion that holds has no failure, and one that fails names it.",
+});
+/** A runner-side failure: never a fact about the service, always residue to retry. */
+export const agentReadinessRunResidueSchema = z
+    .object({ step: agentReadinessStepSchema, reason: reasonSchema })
+    .strict();
+export const agentReadinessRunRecordCoreSchema = z
+    .object({
+    run_contract: z.literal(AGENT_READINESS_RUN_CONTRACT),
+    entity_id: agentReadinessEntityIdSchema,
+    product_key: agentReadinessScopeKeySchema,
+    job_id: agentReadinessScopeKeySchema,
+    run_kind: agentReadinessRunKindSchema,
+    /** `probed` exactly when the run made no exchange: discovery alone, which earns no letter. */
+    label: agentReadinessEvidenceLabelSchema,
+    engine: z
+        .object({
+        name: z.string().min(1).max(80),
+        version: z.string().min(1).max(80),
+        engine_digest: agentReadinessDigestSchema,
+    })
+        .strict(),
+    /** The exact library job this run performed. */
+    job_digest: agentReadinessDigestSchema,
+    declaration_revision_digest: agentReadinessDigestSchema,
+    /** Null for a listing with no binding yet: the run only probed the service. */
+    binding_id: agentReadinessScopeKeySchema.nullable(),
+    binding_digest: agentReadinessDigestSchema.nullable(),
+    /** The fresh value this run's inputs and assertions carry. */
+    nonce: z.string().regex(/^[0-9a-f]{32}$/u),
+    started_at: agentReadinessInstantSchema,
+    finished_at: agentReadinessInstantSchema,
+    discovery: z
+        .object({
+        /** Every descriptor retrieval attempted, found or not, by its capture attempt digest. */
+        attempts: z.array(agentReadinessDigestSchema).max(64),
+        facts: z.array(agentReadinessDiscoveryFactSchema).max(64),
+    })
+        .strict(),
+    exchanges: z.array(agentReadinessRunExchangeSchema).max(64),
+    /** Every credential the run held or was issued, in the order it came to hold them. */
+    credentials: z.array(agentReadinessCredentialSourceSchema).max(16),
+    handoffs: z.array(agentReadinessHandoffSchema).max(16),
+    /** Empty when the job's calls did not all complete. */
+    assertions: z.array(agentReadinessAssertionResultSchema).max(8),
+    error_probe: z.object({ typed: z.boolean(), reason: reasonSchema }).strict().nullable(),
+    residue: z.array(agentReadinessRunResidueSchema).max(16),
+})
+    .strict()
+    .superRefine((run, context) => {
+    if (compareInstants(run.finished_at, run.started_at) < 0) {
+        context.addIssue({
+            code: "custom",
+            path: ["finished_at"],
+            message: "A run cannot finish before it starts.",
+        });
+    }
+    const assertions = run.assertions.map(({ assertion }) => assertion);
+    if (new Set(assertions).size !== assertions.length) {
+        context.addIssue({
+            code: "custom",
+            path: ["assertions"],
+            message: "A run reports each assertion once.",
+        });
+    }
+    if ((run.binding_id === null) !== (run.binding_digest === null)) {
+        context.addIssue({
+            code: "custom",
+            path: ["binding_digest"],
+            message: "A run names its binding and its digest together, or neither.",
+        });
+    }
+    if (run.binding_id === null && (run.exchanges.length > 0 || run.handoffs.length > 0)) {
+        context.addIssue({
+            code: "custom",
+            path: ["binding_id"],
+            message: "A run with no binding only probes: no exchange and no handoff.",
+        });
+    }
+    if ((run.label === "probed") !== (run.exchanges.length === 0)) {
+        context.addIssue({
+            code: "custom",
+            path: ["label"],
+            message: "A run is probed exactly when it made no exchange.",
+        });
+    }
+    const handles = run.credentials.map(({ handle_digest }) => handle_digest);
+    if (new Set(handles).size !== handles.length) {
+        context.addIssue({
+            code: "custom",
+            path: ["credentials"],
+            message: "A run lists each credential it held once.",
+        });
+    }
+});
+export const agentReadinessRunRecordSchema = agentReadinessRunRecordCoreSchema
+    .safeExtend({ run_digest: agentReadinessDigestSchema })
+    .strict();
+/**
+ * The latest run as a card shows it: how many descriptors it read, every
+ * request it sent and what came back (status, type, size and digest, never the
+ * body), and what held. Compiled from the run record, so it is checked with it.
+ */
+export const agentReadinessRunSummarySchema = z
+    .object({
+    started_at: agentReadinessInstantSchema,
+    finished_at: agentReadinessInstantSchema,
+    discovery_reads: z.number().int().nonnegative().max(64),
+    exchanges: z
+        .array(z
+        .object({
+        purpose: agentReadinessRunExchangeSchema.shape.purpose,
+        role: agentReadinessRunExchangeSchema.shape.role,
+        method: z.enum(EXCHANGE_METHODS),
+        url: z.url(),
+        started_at: agentReadinessInstantSchema,
+        finished_at: agentReadinessInstantSchema,
+        /** Null when the request never got an answer. */
+        response: z
+            .object({
+            status: z.number().int().min(100).max(999),
+            media_type: z.string().min(1).max(256),
+            content_bytes: z.number().int().nonnegative(),
+            content_digest: agentReadinessDigestSchema,
+        })
+            .strict()
+            .nullable(),
+        /** Why no answer came, when none did. */
+        transport_error: z.string().min(1).max(40).nullable(),
+        exchange_digest: agentReadinessDigestSchema,
+    })
+        .strict()
+        .refine((exchange) => (exchange.response === null) !== (exchange.transport_error === null), {
+        message: "An exchange either responded or failed in transport.",
+    }))
+        .max(64),
+    assertions: z.array(agentReadinessAssertionResultSchema).max(8),
+    error_probe: agentReadinessRunRecordCoreSchema.shape.error_probe,
+})
+    .strict();
+/** What a step outcome rests on: entries of a run record, by reference. */
+export const agentReadinessStepEvidenceSchema = z.discriminatedUnion("kind", [
+    z
+        .object({
+        kind: z.literal("exchange"),
+        run_digest: agentReadinessDigestSchema,
+        exchange_digest: agentReadinessDigestSchema,
+    })
+        .strict(),
+    z
+        .object({
+        kind: z.literal("discovery"),
+        run_digest: agentReadinessDigestSchema,
+        attempt_digest: agentReadinessDigestSchema,
+    })
+        .strict(),
+    z
+        .object({
+        kind: z.literal("handoff"),
+        run_digest: agentReadinessDigestSchema,
+        handoff: z.number().int().nonnegative(),
+    })
+        .strict(),
+    z
+        .object({
+        kind: z.literal("credential"),
+        run_digest: agentReadinessDigestSchema,
+        handle_digest: agentReadinessDigestSchema,
+    })
+        .strict(),
+]);
+export const agentReadinessStepResultSchema = z
+    .object({
+    step: agentReadinessStepSchema,
+    outcome: agentReadinessStepOutcomeSchema,
+    /** Set for a human step (`approval`, `workaround`), never otherwise. */
+    timing: agentReadinessHandoffTimingSchema.nullable(),
+    evidence: z.array(agentReadinessStepEvidenceSchema).max(32),
+})
+    .strict()
+    .superRefine((step, context) => {
+    const human = step.outcome === "approval" || step.outcome === "workaround";
+    if (human !== (step.timing !== null)) {
+        context.addIssue({
+            code: "custom",
+            path: ["timing"],
+            message: "A human step, and only a human step, is setup or recurring.",
+        });
+    }
+    if ((step.outcome === "not_assessed") !== (step.evidence.length === 0)) {
+        context.addIssue({
+            code: "custom",
+            path: ["evidence"],
+            message: "Every assessed step rests on evidence; a step not assessed has none.",
+        });
+    }
+});
+//# sourceMappingURL=run.js.map

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

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

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

@@ -4,73 +4,21 @@ export declare const agentReadinessEntityIdSchema: z.ZodString;
 export declare const agentReadinessOfferIdSchema: z.ZodString;
 export declare const agentReadinessProfileIdSchema: z.ZodString;
 export declare const agentReadinessIdentifierSchema: z.ZodString;
-/** A reviewer identity, in the same form the authority contract's human actor id takes. */
-export declare const agentReadinessReviewerIdSchema: z.ZodString;
 export declare const agentReadinessInstantSchema: z.ZodISODateTime;
-export declare const agentReadinessSignalCodeSchema: z.ZodString;
 export declare const agentReadinessScopeKeySchema: z.ZodString;
-export declare const agentReadinessMethodNameSchema: z.ZodString;
 export declare const agentReadinessHostnameSchema: z.ZodString;
-export declare const agentReadinessStageSchema: z.ZodEnum<{
-    evaluate: "evaluate";
-    operate: "operate";
-    pay: "pay";
-    provision: "provision";
-    sign_up: "sign_up";
-}>;
-export declare function agentReadinessStageLabel(input: z.infer<typeof agentReadinessStageSchema>): string;
-export declare const agentReadinessSignalValueSchema: z.ZodEnum<{
-    no: "no";
-    not_applicable: "not_applicable";
-    partial: "partial";
-    unknown: "unknown";
-    yes: "yes";
-}>;
-export declare const agentReadinessStageOutcomeSchema: z.ZodEnum<{
-    constrained: "constrained";
-    fail: "fail";
-    not_applicable: "not_applicable";
-    pass: "pass";
-    unknown: "unknown";
-}>;
-export declare const agentReadinessPublicStateSchema: z.ZodEnum<{
-    blocked: "blocked";
-    limited: "limited";
-    not_applicable: "not_applicable";
-    ready: "ready";
-    unknown: "unknown";
-}>;
-export declare const agentReadinessEvaluationRoleSchema: z.ZodEnum<{
-    barrier: "barrier";
-    graded: "graded";
-    informational: "informational";
-}>;
-export declare const agentReadinessGradeSchema: z.ZodEnum<{
-    A: "A";
-    "A+": "A+";
-    B: "B";
-    "B+": "B+";
-    C: "C";
-    "C+": "C+";
-    D: "D";
-    F: "F";
-    unrated: "unrated";
-}>;
+/** Whether a profile's last successful check is within the policy's freshness window. */
 export declare const agentReadinessFreshnessSchema: z.ZodEnum<{
     fresh: "fresh";
     stale: "stale";
-    unknown: "unknown";
 }>;
-export declare const agentReadinessScopeSubjectSchema: z.ZodObject<{
-    key: z.ZodString;
-    name: z.ZodString;
-}, z.core.$strict>;
+/** A profile is one service product and one library job: `job.key` is the job's id. */
 export declare const agentReadinessScopeSchema: z.ZodObject<{
     product: z.ZodObject<{
         key: z.ZodString;
         name: z.ZodString;
     }, z.core.$strict>;
-    funnel: z.ZodObject<{
+    job: z.ZodObject<{
         key: z.ZodString;
         name: z.ZodString;
     }, z.core.$strict>;
@@ -96,7 +44,6 @@ export declare const agentReadinessResourceRoleSchema: z.ZodEnum<{
     status: "status";
     terms: "terms";
 }>;
-export declare function agentReadinessResourceRoleLabel(input: z.infer<typeof agentReadinessResourceRoleSchema>): string;
 export declare const agentReadinessSurfaceNodeKindSchema: z.ZodEnum<{
     endpoint: "endpoint";
     interface: "interface";
@@ -112,10 +59,54 @@ export declare const agentReadinessSurfaceReferenceSchema: z.ZodObject<{
     }>;
     node_id: z.ZodString;
 }, z.core.$strict>;
-export declare const agentReadinessAssessmentMethodSchema: z.ZodObject<{
-    name: z.ZodString;
-    version: z.ZodString;
-    method_digest: z.ZodString;
-}, z.core.$strict>;
-export type AgentReadinessAssessmentMethod = z.infer<typeof agentReadinessAssessmentMethodSchema>;
+/** 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"];
+export declare const agentReadinessStepSchema: z.ZodEnum<{
+    confirm: "confirm";
+    delegation: "delegation";
+    discover: "discover";
+    job: "job";
+    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.
+ */
+export declare const agentReadinessStepOutcomeSchema: z.ZodEnum<{
+    approval: "approval";
+    blocked: "blocked";
+    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<{
+    recurring: "recurring";
+    setup: "setup";
+}>;
+export declare const agentReadinessOperateLetterSchema: 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 declare const agentReadinessEvidenceLabelSchema: z.ZodEnum<{
+    probed: "probed";
+    sourcey_run: "sourcey_run";
+    vendor_run_verified: "vendor_run_verified";
+}>;
 //# 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":"AAMA,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,2FAA2F;AAC3F,eAAO,MAAM,8BAA8B,aAA6C,CAAC;AACzF,eAAO,MAAM,2BAA2B,kBAAmC,CAAC;AAC5E,eAAO,MAAM,8BAA8B,aAAqD,CAAC;AACjG,eAAO,MAAM,4BAA4B,aAAiC,CAAC;AAC3E,eAAO,MAAM,8BAA8B,aAAqD,CAAC;AACjG,eAAO,MAAM,4BAA4B,aAKqD,CAAC;AAE/F,eAAO,MAAM,yBAAyB;;;;;;EAMpC,CAAC;AAUH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAAG,MAAM,CAEjG;AAED,eAAO,MAAM,+BAA+B;;;;;;EAM1C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;EAM3C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;EAM1C,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;EAAiD,CAAC;AACjG,eAAO,MAAM,yBAAyB;;;;;;;;;;EAUpC,CAAC;AACH,eAAO,MAAM,6BAA6B;;;;EAAwC,CAAC;AAEnF,eAAO,MAAM,gCAAgC;;;kBAKlC,CAAC;AAEZ,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;AAsBH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,GACtD,MAAM,CAER;AAED,eAAO,MAAM,mCAAmC;;;;;EAK9C,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;kBAKtC,CAAC;AAEZ,eAAO,MAAM,oCAAoC;;;;kBAMtC,CAAC;AAEZ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,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,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"}

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

@@ -1,4 +1,4 @@
-import { ACTOR_IDENTIFIER_PATTERN, DIGEST_PATTERN, IDENTIFIER_PATTERN, SLUG_PATTERN, } from "provenry/primitives";
+import { DIGEST_PATTERN, IDENTIFIER_PATTERN, SLUG_PATTERN } from "provenry/primitives";
 import { z } from "zod";
 import { AGENT_READINESS_PROFILE_ID_PATTERN, ENTITY_ID_PATTERN, OFFER_ID_PATTERN, } from "../../../modules/catalog-primitives/src/index.js";
 export const agentReadinessDigestSchema = z.string().regex(DIGEST_PATTERN);
@@ -6,83 +6,31 @@ export const agentReadinessEntityIdSchema = z.string().regex(ENTITY_ID_PATTERN);
 export const agentReadinessOfferIdSchema = z.string().regex(OFFER_ID_PATTERN);
 export const agentReadinessProfileIdSchema = z.string().regex(AGENT_READINESS_PROFILE_ID_PATTERN);
 export const agentReadinessIdentifierSchema = z.string().regex(IDENTIFIER_PATTERN);
-/** A reviewer identity, in the same form the authority contract's human actor id takes. */
-export const agentReadinessReviewerIdSchema = z.string().regex(ACTOR_IDENTIFIER_PATTERN);
 export const agentReadinessInstantSchema = z.iso.datetime({ offset: true });
-export const agentReadinessSignalCodeSchema = z.string().regex(/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/);
 export const agentReadinessScopeKeySchema = z.string().regex(SLUG_PATTERN);
-export const agentReadinessMethodNameSchema = z.string().regex(/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/);
 export const agentReadinessHostnameSchema = z
     .string()
     .trim()
     .toLowerCase()
     .max(253)
     .regex(/^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/u);
-export const agentReadinessStageSchema = z.enum([
-    "evaluate",
-    "sign_up",
-    "pay",
-    "provision",
-    "operate",
-]);
-const agentReadinessStageLabels = {
-    evaluate: "Evaluate",
-    sign_up: "Sign up",
-    pay: "Pay",
-    provision: "Provision",
-    operate: "Operate",
-};
-export function agentReadinessStageLabel(input) {
-    return agentReadinessStageLabels[agentReadinessStageSchema.parse(input)];
-}
-export const agentReadinessSignalValueSchema = z.enum([
-    "yes",
-    "no",
-    "partial",
-    "unknown",
-    "not_applicable",
-]);
-export const agentReadinessStageOutcomeSchema = z.enum([
-    "pass",
-    "constrained",
-    "fail",
-    "unknown",
-    "not_applicable",
-]);
-export const agentReadinessPublicStateSchema = z.enum([
-    "ready",
-    "limited",
-    "blocked",
-    "unknown",
-    "not_applicable",
-]);
-export const agentReadinessEvaluationRoleSchema = z.enum(["graded", "barrier", "informational"]);
-export const agentReadinessGradeSchema = z.enum([
-    "A+",
-    "A",
-    "B+",
-    "B",
-    "C+",
-    "C",
-    "D",
-    "F",
-    "unrated",
-]);
-export const agentReadinessFreshnessSchema = z.enum(["fresh", "stale", "unknown"]);
-export const agentReadinessScopeSubjectSchema = z
+/** Whether a profile's last successful check is within the policy's freshness window. */
+export const agentReadinessFreshnessSchema = z.enum(["fresh", "stale"]);
+const agentReadinessScopeSubjectSchema = z
     .object({
     key: agentReadinessScopeKeySchema,
     name: z.string().min(1).max(160),
 })
     .strict();
+/** A profile is one service product and one library job: `job.key` is the job's id. */
 export const agentReadinessScopeSchema = z
     .object({
     product: agentReadinessScopeSubjectSchema,
-    funnel: agentReadinessScopeSubjectSchema,
+    job: agentReadinessScopeSubjectSchema,
 })
     .strict();
 export function sameAgentReadinessScopeIdentity(left, right) {
-    return left.product.key === right.product.key && left.funnel.key === right.funnel.key;
+    return left.product.key === right.product.key && left.job.key === right.job.key;
 }
 export const agentReadinessCatalogBindingSchema = z
     .object({
@@ -106,25 +54,6 @@ export const agentReadinessResourceRoleSchema = z.enum([
     "policy",
     "status",
 ]);
-const agentReadinessResourceRoleLabels = {
-    discovery: "Discovery",
-    terms: "Terms",
-    eligibility: "Eligibility",
-    pricing: "Pricing",
-    access: "Access",
-    checkout: "Checkout",
-    provisioning: "Provisioning",
-    operations: "Operations",
-    recovery: "Recovery",
-    authentication: "Authentication",
-    descriptor: "Descriptor",
-    documentation: "Documentation",
-    policy: "Policy",
-    status: "Status",
-};
-export function agentReadinessResourceRoleLabel(input) {
-    return agentReadinessResourceRoleLabels[agentReadinessResourceRoleSchema.parse(input)];
-}
 export const agentReadinessSurfaceNodeKindSchema = z.enum([
     "resource",
     "endpoint",
@@ -137,11 +66,48 @@ export const agentReadinessSurfaceReferenceSchema = z
     node_id: agentReadinessScopeKeySchema,
 })
     .strict();
-export const agentReadinessAssessmentMethodSchema = z
-    .object({
-    name: agentReadinessMethodNameSchema,
-    version: z.string().min(1).max(160),
-    method_digest: agentReadinessDigestSchema,
-})
-    .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. */
+export const AGENT_READINESS_STEPS = [
+    "discover",
+    "delegation",
+    "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.
+ */
+export const agentReadinessStepOutcomeSchema = z.enum([
+    "machine",
+    "approval",
+    "workaround",
+    "blocked",
+    "not_applicable",
+    "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",
+]);
+/** 1 no account needed … 6 sales-gated; absence is "not yet assessed". */
+export const agentReadinessOnboardLevelSchema = z.number().int().min(1).max(6);
+export const agentReadinessEvidenceLabelSchema = z.enum([
+    "sourcey_run",
+    "vendor_run_verified",
+    "probed",
+]);
 //# sourceMappingURL=shared.js.map