@sourcey/catalog-verifier 1.0.0

package/dist/contracts/agent-readiness/src/method-pack.js

@@ -0,0 +1,181 @@
+import { z } from "zod";
+import { evidenceCaptureMethodSchema } from "../../evidence/src/index.js";
+import { standardRequirementReferenceSchema } from "../../standards/src/index.js";
+import { agentReadinessEndpointRoleSchema, agentReadinessInterfaceFunctionSchema, agentReadinessInterfaceModalitySchema, } from "./declaration.js";
+import { agentReadinessDeterminationBasisKindSchema, agentReadinessRetainedArtifactSchema, } from "./evidence.js";
+import { agentReadinessAllowedActionSchema, agentReadinessForbiddenEffectSchema, } from "./interaction.js";
+import { agentReadinessDigestSchema, agentReadinessMethodNameSchema, agentReadinessResourceRoleSchema, agentReadinessSignalCodeSchema, agentReadinessSignalValueSchema, agentReadinessStageSchema, agentReadinessSurfaceNodeKindSchema, } from "./shared.js";
+export const agentReadinessCaptureRungSchema = evidenceCaptureMethodSchema;
+export const agentReadinessMethodCapabilitySchema = z
+    .object({
+    stage: agentReadinessStageSchema,
+    signal_code: agentReadinessSignalCodeSchema,
+    values: z.array(agentReadinessSignalValueSchema.exclude(["unknown"])).min(1),
+    determination_bases: z.array(agentReadinessDeterminationBasisKindSchema).min(1),
+})
+    .strict()
+    .superRefine((value, context) => {
+    assertUnique(value.values, context, ["values"]);
+    assertUnique(value.determination_bases, context, ["determination_bases"]);
+    if (value.determination_bases.includes("certification_receipt")) {
+        context.addIssue({
+            code: "custom",
+            path: ["determination_bases"],
+            message: "Observed assessment methods cannot mint certification receipts.",
+        });
+    }
+});
+export const agentReadinessMethodFailureClassSchema = z.enum([
+    "network_failure",
+    "policy_refusal",
+    "authentication_required",
+    "timeout",
+    "render_failure",
+    "invalid_structure",
+    "interaction_budget_exhausted",
+    "capture_unavailable",
+]);
+export const agentReadinessMethodResidueClassSchema = z.enum([
+    "unresolved_signal",
+    "insufficient_determination_basis",
+    "conflicting_observations",
+    "scope_mismatch",
+    "manual_review_required",
+    "unsupported_interaction",
+]);
+export const agentReadinessAssessmentMethodPackCoreSchema = z
+    .object({
+    method_contract: z.literal("sourcey.agent-readiness-method/v1alpha1"),
+    name: agentReadinessMethodNameSchema,
+    version: z.string().min(1).max(160),
+    capabilities: z.array(agentReadinessMethodCapabilitySchema).min(1),
+    surface_support: z
+        .object({
+        node_kinds: z.array(agentReadinessSurfaceNodeKindSchema).min(1),
+        resource_roles: z.array(agentReadinessResourceRoleSchema),
+        endpoint_roles: z.array(agentReadinessEndpointRoleSchema),
+        interface_modalities: z.array(agentReadinessInterfaceModalitySchema),
+        interface_functions: z.array(agentReadinessInterfaceFunctionSchema),
+    })
+        .strict(),
+    capture: z
+        .object({
+        rungs: z.array(agentReadinessCaptureRungSchema).min(1),
+        redirects: z.enum(["reject", "same-origin", "allowed-hosts"]),
+        require_https: z.literal(true),
+        max_redirects: z.number().int().min(0).max(5),
+        timeout_ms: z.number().int().positive().max(120_000),
+        max_bytes: z.number().int().positive().max(20_000_000),
+        freshness_capability: z.enum(["current", "history-only"]),
+    })
+        .strict(),
+    interaction: z
+        .object({
+        mode: z.literal("non_mutating"),
+        max_actions: z.number().int().nonnegative().max(50),
+        allowed_actions: z.array(agentReadinessAllowedActionSchema),
+        forbidden_effects: z
+            .array(agentReadinessForbiddenEffectSchema)
+            .length(agentReadinessForbiddenEffectSchema.options.length),
+    })
+        .strict(),
+    required_artifacts: z.array(agentReadinessRetainedArtifactSchema).min(1),
+    failure_classes: z.array(agentReadinessMethodFailureClassSchema).min(1),
+    residue_classes: z.array(agentReadinessMethodResidueClassSchema).min(1),
+    external_references: z.array(standardRequirementReferenceSchema),
+})
+    .strict()
+    .superRefine((value, context) => {
+    const capabilityKeys = value.capabilities.map((capability) => `${capability.stage}:${capability.signal_code}`);
+    assertUnique(capabilityKeys, context, ["capabilities"]);
+    assertUnique(value.surface_support.node_kinds, context, ["surface_support", "node_kinds"]);
+    assertUnique(value.surface_support.resource_roles, context, [
+        "surface_support",
+        "resource_roles",
+    ]);
+    assertUnique(value.surface_support.endpoint_roles, context, [
+        "surface_support",
+        "endpoint_roles",
+    ]);
+    assertUnique(value.surface_support.interface_modalities, context, [
+        "surface_support",
+        "interface_modalities",
+    ]);
+    assertUnique(value.surface_support.interface_functions, context, [
+        "surface_support",
+        "interface_functions",
+    ]);
+    for (const [nodeKind, selectors] of [
+        ["resource", value.surface_support.resource_roles],
+        ["endpoint", value.surface_support.endpoint_roles],
+    ]) {
+        if (value.surface_support.node_kinds.includes(nodeKind) !== selectors.length > 0) {
+            context.addIssue({
+                code: "custom",
+                path: ["surface_support"],
+                message: `Method surface support must declare selectors exactly for ${nodeKind} support.`,
+            });
+        }
+    }
+    const supportsInterfaces = value.surface_support.node_kinds.includes("interface");
+    if (supportsInterfaces !== value.surface_support.interface_modalities.length > 0 ||
+        supportsInterfaces !== value.surface_support.interface_functions.length > 0) {
+        context.addIssue({
+            code: "custom",
+            path: ["surface_support"],
+            message: "Method interface support must declare both modality and function selectors exactly when interfaces are supported.",
+        });
+    }
+    assertUnique(value.capture.rungs, context, ["capture", "rungs"]);
+    assertUnique(value.interaction.allowed_actions, context, ["interaction", "allowed_actions"]);
+    assertUnique(value.interaction.forbidden_effects, context, [
+        "interaction",
+        "forbidden_effects",
+    ]);
+    assertUnique(value.required_artifacts, context, ["required_artifacts"]);
+    assertUnique(value.failure_classes, context, ["failure_classes"]);
+    assertUnique(value.residue_classes, context, ["residue_classes"]);
+    for (const effect of agentReadinessForbiddenEffectSchema.options) {
+        if (!value.interaction.forbidden_effects.includes(effect)) {
+            context.addIssue({
+                code: "custom",
+                path: ["interaction", "forbidden_effects"],
+                message: `Observed readiness method packs must forbid ${effect}.`,
+            });
+        }
+    }
+    if (value.capture.freshness_capability === "history-only" &&
+        !value.capture.rungs.includes("archive")) {
+        context.addIssue({
+            code: "custom",
+            path: ["capture", "freshness_capability"],
+            message: "Only a method with the archive capture rung may be history-only.",
+        });
+    }
+    if (value.capture.freshness_capability === "current" &&
+        value.capture.rungs.every((rung) => rung === "archive")) {
+        context.addIssue({
+            code: "custom",
+            path: ["capture", "freshness_capability"],
+            message: "An archive-only method cannot establish current freshness.",
+        });
+    }
+});
+export const agentReadinessAssessmentMethodPackSchema = agentReadinessAssessmentMethodPackCoreSchema
+    .safeExtend({ method_digest: agentReadinessDigestSchema })
+    .strict();
+/** The capability a method declares for one exact stage and signal, if any. */
+export function methodCapabilityFor(method, stage, signalCode) {
+    return method.capabilities.find((capability) => capability.stage === stage && capability.signal_code === signalCode);
+}
+/** Rule-assessable values (pass, constrained, fail) no listed capability can establish. */
+export function missingAssessableValues(capabilities, rule) {
+    const establishable = new Set(capabilities.flatMap((capability) => capability.values));
+    return [...rule.pass_values, ...rule.constrained_values, ...rule.fail_values].filter((value) => !establishable.has(value));
+}
+function assertUnique(values, context, path) {
+    if (new Set(values).size !== values.length) {
+        context.addIssue({ code: "custom", path, message: "Values must be unique." });
+    }
+}
+//# sourceMappingURL=method-pack.js.map

package/dist/contracts/agent-readiness/src/method-pack.js.map

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

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

@@ -0,0 +1,119 @@
+import { z } from "zod";
+export declare const agentReadinessDigestSchema: z.ZodString;
+export declare const agentReadinessEntityIdSchema: z.ZodString;
+export declare const agentReadinessOfferIdSchema: z.ZodString;
+export declare const agentReadinessProfileIdSchema: z.ZodString;
+export declare const agentReadinessIdentifierSchema: 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";
+    sign_up: "sign_up";
+    pay: "pay";
+    provision: "provision";
+    operate: "operate";
+}>;
+export declare function agentReadinessStageLabel(input: z.infer<typeof agentReadinessStageSchema>): string;
+export declare const agentReadinessSignalValueSchema: z.ZodEnum<{
+    unknown: "unknown";
+    yes: "yes";
+    no: "no";
+    partial: "partial";
+    not_applicable: "not_applicable";
+}>;
+export declare const agentReadinessStageOutcomeSchema: z.ZodEnum<{
+    unknown: "unknown";
+    not_applicable: "not_applicable";
+    pass: "pass";
+    constrained: "constrained";
+    fail: "fail";
+}>;
+export declare const agentReadinessPublicStateSchema: z.ZodEnum<{
+    unknown: "unknown";
+    not_applicable: "not_applicable";
+    ready: "ready";
+    limited: "limited";
+    blocked: "blocked";
+}>;
+export declare const agentReadinessEvaluationRoleSchema: z.ZodEnum<{
+    graded: "graded";
+    barrier: "barrier";
+    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";
+}>;
+export declare const agentReadinessFreshnessSchema: z.ZodEnum<{
+    unknown: "unknown";
+    fresh: "fresh";
+    stale: "stale";
+}>;
+export declare const agentReadinessScopeSubjectSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strict>;
+export declare const agentReadinessScopeSchema: z.ZodObject<{
+    product: z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>;
+    funnel: z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare function sameAgentReadinessScopeIdentity(left: z.infer<typeof agentReadinessScopeSchema>, right: z.infer<typeof agentReadinessScopeSchema>): boolean;
+export declare const agentReadinessCatalogBindingSchema: z.ZodObject<{
+    base_release_id: z.ZodString;
+    entity_revision_digest: z.ZodString;
+}, z.core.$strict>;
+export declare const agentReadinessResourceRoleSchema: z.ZodEnum<{
+    policy: "policy";
+    discovery: "discovery";
+    status: "status";
+    pricing: "pricing";
+    eligibility: "eligibility";
+    access: "access";
+    terms: "terms";
+    checkout: "checkout";
+    provisioning: "provisioning";
+    operations: "operations";
+    recovery: "recovery";
+    authentication: "authentication";
+    descriptor: "descriptor";
+    documentation: "documentation";
+}>;
+export declare function agentReadinessResourceRoleLabel(input: z.infer<typeof agentReadinessResourceRoleSchema>): string;
+export declare const agentReadinessSurfaceNodeKindSchema: z.ZodEnum<{
+    resource: "resource";
+    endpoint: "endpoint";
+    interface: "interface";
+    surface_exclusion: "surface_exclusion";
+}>;
+export declare const agentReadinessSurfaceReferenceSchema: z.ZodObject<{
+    node_kind: z.ZodEnum<{
+        resource: "resource";
+        endpoint: "endpoint";
+        interface: "interface";
+        surface_exclusion: "surface_exclusion";
+    }>;
+    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>;
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../contracts/agent-readiness/src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,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,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"}

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

@@ -0,0 +1,144 @@
+import { z } from "zod";
+import { AGENT_READINESS_PROFILE_ID_PATTERN, DIGEST_PATTERN, ENTITY_ID_PATTERN, IDENTIFIER_PATTERN, OFFER_ID_PATTERN, SLUG_PATTERN, } from "../../../modules/primitives/src/index.js";
+export const agentReadinessDigestSchema = z.string().regex(DIGEST_PATTERN);
+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);
+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
+    .object({
+    key: agentReadinessScopeKeySchema,
+    name: z.string().min(1).max(160),
+})
+    .strict();
+export const agentReadinessScopeSchema = z
+    .object({
+    product: agentReadinessScopeSubjectSchema,
+    funnel: agentReadinessScopeSubjectSchema,
+})
+    .strict();
+export function sameAgentReadinessScopeIdentity(left, right) {
+    return left.product.key === right.product.key && left.funnel.key === right.funnel.key;
+}
+export const agentReadinessCatalogBindingSchema = z
+    .object({
+    base_release_id: agentReadinessDigestSchema,
+    entity_revision_digest: agentReadinessDigestSchema,
+})
+    .strict();
+export const agentReadinessResourceRoleSchema = z.enum([
+    "discovery",
+    "terms",
+    "eligibility",
+    "pricing",
+    "access",
+    "checkout",
+    "provisioning",
+    "operations",
+    "recovery",
+    "authentication",
+    "descriptor",
+    "documentation",
+    "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",
+    "interface",
+    "surface_exclusion",
+]);
+export const agentReadinessSurfaceReferenceSchema = z
+    .object({
+    node_kind: agentReadinessSurfaceNodeKindSchema,
+    node_id: agentReadinessScopeKeySchema,
+})
+    .strict();
+export const agentReadinessAssessmentMethodSchema = z
+    .object({
+    name: agentReadinessMethodNameSchema,
+    version: z.string().min(1).max(160),
+    method_digest: agentReadinessDigestSchema,
+})
+    .strict();
+//# sourceMappingURL=shared.js.map

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

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