@nexalink/coding-contracts 0.3.0 → 0.4.1

package/README.md

@@ -1,6 +1,8 @@
 # `@nexalink/coding-contracts`
 
-Canonical TypeScript contracts for Nexalink CareCompass coding workflows.
+Canonical TypeScript contracts for CareCompass by Nexalink, an embeddable SDK for AI-assisted medical-coding review. CareCompass is built for behavioral-health EHR and RCM platforms: suggestions are grounded in payer policies supplied and approved by the customer's team, and a qualified human reviewer makes the final coding decision.
+
+This package supplies the types, validators, and schemas used by those workflows; it is not the hosted coding service. CareCompass does not submit claims or bill payers. Prior authorization and patient navigation are future directions, not the current product. Pilot scope and pricing are agreed directly with Nexalink.
 
 The package provides:
 
@@ -20,7 +22,7 @@ persist data, submit claims, or replace review by a qualified human coder.
 Pin an exact version so contract upgrades are deliberate:
 
 ```sh
-bun add @nexalink/coding-contracts@0.2.0 --exact
+bun add @nexalink/coding-contracts@0.4.1 --exact
 ```
 
 The package supports both ES modules and CommonJS.
@@ -110,12 +112,12 @@ approved evidence set.
 
 | Category         | Exports                                                                                                                                                                                                |
 | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| Types            | `RcmCodingInput`, `RcmCodingOutput`, `RcmSupportingReference`, `RcmModelPrompt`, `RcmRetrievalMetadata`, `RcmRuntimeEvent`, `RcmWorkflowCatalog`                                                       |
+| Types            | `RcmCodingInput`, `RcmCodingOutput`, `RcmSupportingReference`, `RcmModelPrompt`, `RcmRetrievalMetadata`, `RcmRuntimeEvent`, `RcmReviewerEvent`, `RcmWorkflowCatalog`                                   |
 | Case models      | `CodingCase`, `CodingCaseContext`, `CodingCasePayer`, `CodingCaseClinical`, `CodingServiceLine`, `CodingExtension`, `CodingBatch`                                                                      |
 | Decision models  | `CodingDecision`, `CodingDecisionLine`, `CodingEvidence`, `CodingRuleResult`, `CodingReviewerAction`                                                                                                   |
 | Zod schemas      | `rcmCodingInputSchema`, `rcmCodingOutputSchema`, `codingCaseSchema`, `codingDecisionSchema`, and one schema for each additional contract type                                                          |
 | Validation       | `rcm*ValidationError` functions, `coding*ValidationError` functions, and `valid*` boolean helpers                                                                                                      |
-| Workflow policy  | `RCM_WORKFLOW_ID`, `RCM_MODEL_POLICY_ID`, `RCM_HUMAN_REVIEW_POLICY_ID`, `RCM_HUMAN_REVIEW_INSTRUCTION`, `RCM_OUTPUT_SCHEMA_NAME`                                                                       |
+| Workflow policy  | `RCM_WORKFLOW_ID`, `PIN_TIME_WORKFLOW_ID`, `RCM_MODEL_POLICY_ID`, `RCM_HUMAN_REVIEW_POLICY_ID`, `RCM_HUMAN_REVIEW_INSTRUCTION`, `RCM_OUTPUT_SCHEMA_NAME`                                               |
 | Schema versions  | `RCM_INPUT_SCHEMA_VERSION`, `RCM_OUTPUT_SCHEMA_VERSION`, `RCM_REFERENCE_SCHEMA_VERSION`, `CODING_CASE_SCHEMA_VERSION`, `CODING_DECISION_SCHEMA_VERSION`, and the other contract wire-version constants |
 | Schema documents | `Rcm*SchemaJson`, `Coding*SchemaJson` values, JSON Schema package subpaths, `versions.json`, and `workflow-constants.json`                                                                             |
 

package/dist/cjs/index.cjs

@@ -2,8 +2,8 @@
 // GENERATED FILE. DO NOT EDIT.
 // Source: coding-contracts schemas/ (run: bun run contracts:gen)
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validCodingEvidence = exports.codingEvidenceSchema = exports.CodingDecisionLineSchemaJson = exports.validCodingDecisionLine = exports.codingDecisionLineSchema = exports.CodingBatchSchemaJson = exports.validCodingBatch = exports.codingBatchSchema = exports.CodingCaseSchemaJson = exports.validCodingCase = exports.codingCaseSchema = exports.CodingExtensionSchemaJson = exports.validCodingExtension = exports.codingExtensionSchema = exports.CodingServiceLineSchemaJson = exports.validCodingServiceLine = exports.codingServiceLineSchema = exports.CodingCaseClinicalSchemaJson = exports.validCodingCaseClinical = exports.codingCaseClinicalSchema = exports.CodingCasePayerSchemaJson = exports.validCodingCasePayer = exports.codingCasePayerSchema = exports.CodingCaseContextSchemaJson = exports.validCodingCaseContext = exports.codingCaseContextSchema = exports.RCM_WORKFLOW_CATALOG_SCHEMA_VERSION = exports.RCM_RUNTIME_EVENT_SCHEMA_VERSION = exports.RCM_RETRIEVAL_SCHEMA_VERSION = exports.RCM_MODEL_PROMPT_SCHEMA_VERSION = exports.RCM_OUTPUT_SCHEMA_VERSION = exports.RCM_INPUT_SCHEMA_VERSION = exports.RCM_REFERENCE_SCHEMA_VERSION = exports.CODING_DECISION_SCHEMA_VERSION = exports.CODING_REVIEWER_ACTION_SCHEMA_VERSION = exports.CODING_RULE_RESULT_SCHEMA_VERSION = exports.CODING_EVIDENCE_SCHEMA_VERSION = exports.CODING_DECISION_LINE_SCHEMA_VERSION = exports.CODING_BATCH_SCHEMA_VERSION = exports.CODING_CASE_SCHEMA_VERSION = exports.CODING_EXTENSION_SCHEMA_VERSION = exports.CODING_SERVICE_LINE_SCHEMA_VERSION = exports.CODING_CASE_CLINICAL_SCHEMA_VERSION = exports.CODING_CASE_PAYER_SCHEMA_VERSION = exports.CODING_CASE_CONTEXT_SCHEMA_VERSION = exports.RCM_HUMAN_REVIEW_INSTRUCTION = exports.RCM_OUTPUT_SCHEMA_NAME = exports.RCM_HUMAN_REVIEW_POLICY_ID = exports.RCM_MODEL_POLICY_ID = exports.RCM_WORKFLOW_ID = void 0;
-exports.RcmWorkflowCatalogSchemaJson = exports.validRcmWorkflowCatalog = exports.rcmWorkflowCatalogSchema = exports.RcmRuntimeEventSchemaJson = exports.validRcmRuntimeEvent = exports.rcmRuntimeEventSchema = exports.RcmRetrievalMetadataSchemaJson = exports.validRcmRetrievalMetadata = exports.rcmRetrievalMetadataSchema = exports.RcmModelPromptSchemaJson = exports.validRcmModelPrompt = exports.rcmModelPromptSchema = exports.RcmCodingOutputSchemaJson = exports.validRcmCodingOutput = exports.rcmCodingOutputSchema = exports.RcmCodingInputSchemaJson = exports.validRcmCodingInput = exports.rcmCodingInputSchema = exports.RcmSupportingReferenceSchemaJson = exports.validRcmSupportingReference = exports.rcmSupportingReferenceSchema = exports.CodingDecisionSchemaJson = exports.validCodingDecision = exports.codingDecisionSchema = exports.CodingReviewerActionSchemaJson = exports.validCodingReviewerAction = exports.codingReviewerActionSchema = exports.CodingRuleResultSchemaJson = exports.validCodingRuleResult = exports.codingRuleResultSchema = exports.CodingEvidenceSchemaJson = void 0;
+exports.CodingDecisionLineSchemaJson = exports.validCodingDecisionLine = exports.codingDecisionLineSchema = exports.CodingBatchSchemaJson = exports.validCodingBatch = exports.codingBatchSchema = exports.CodingCaseSchemaJson = exports.validCodingCase = exports.codingCaseSchema = exports.CodingExtensionSchemaJson = exports.validCodingExtension = exports.codingExtensionSchema = exports.CodingServiceLineSchemaJson = exports.validCodingServiceLine = exports.codingServiceLineSchema = exports.CodingCaseClinicalSchemaJson = exports.validCodingCaseClinical = exports.codingCaseClinicalSchema = exports.CodingCasePayerSchemaJson = exports.validCodingCasePayer = exports.codingCasePayerSchema = exports.CodingCaseContextSchemaJson = exports.validCodingCaseContext = exports.codingCaseContextSchema = exports.RCM_WORKFLOW_CATALOG_SCHEMA_VERSION = exports.RCM_RUNTIME_EVENT_SCHEMA_VERSION = exports.RCM_REVIEWER_EVENT_SCHEMA_VERSION = exports.RCM_RETRIEVAL_SCHEMA_VERSION = exports.RCM_MODEL_PROMPT_SCHEMA_VERSION = exports.RCM_OUTPUT_SCHEMA_VERSION = exports.RCM_INPUT_SCHEMA_VERSION = exports.RCM_REFERENCE_SCHEMA_VERSION = exports.CODING_DECISION_SCHEMA_VERSION = exports.CODING_REVIEWER_ACTION_SCHEMA_VERSION = exports.CODING_RULE_RESULT_SCHEMA_VERSION = exports.CODING_EVIDENCE_SCHEMA_VERSION = exports.CODING_DECISION_LINE_SCHEMA_VERSION = exports.CODING_BATCH_SCHEMA_VERSION = exports.CODING_CASE_SCHEMA_VERSION = exports.CODING_EXTENSION_SCHEMA_VERSION = exports.CODING_SERVICE_LINE_SCHEMA_VERSION = exports.CODING_CASE_CLINICAL_SCHEMA_VERSION = exports.CODING_CASE_PAYER_SCHEMA_VERSION = exports.CODING_CASE_CONTEXT_SCHEMA_VERSION = exports.PIN_TIME_WORKFLOW_ID = exports.RCM_HUMAN_REVIEW_INSTRUCTION = exports.RCM_OUTPUT_SCHEMA_NAME = exports.RCM_HUMAN_REVIEW_POLICY_ID = exports.RCM_MODEL_POLICY_ID = exports.RCM_WORKFLOW_ID = void 0;
+exports.RcmWorkflowCatalogSchemaJson = exports.validRcmWorkflowCatalog = exports.rcmWorkflowCatalogSchema = exports.RcmRuntimeEventSchemaJson = exports.validRcmRuntimeEvent = exports.rcmRuntimeEventSchema = exports.RcmReviewerEventSchemaJson = exports.validRcmReviewerEvent = exports.rcmReviewerEventSchema = exports.RcmRetrievalMetadataSchemaJson = exports.validRcmRetrievalMetadata = exports.rcmRetrievalMetadataSchema = exports.RcmModelPromptSchemaJson = exports.validRcmModelPrompt = exports.rcmModelPromptSchema = exports.RcmCodingOutputSchemaJson = exports.validRcmCodingOutput = exports.rcmCodingOutputSchema = exports.RcmCodingInputSchemaJson = exports.validRcmCodingInput = exports.rcmCodingInputSchema = exports.RcmSupportingReferenceSchemaJson = exports.validRcmSupportingReference = exports.rcmSupportingReferenceSchema = exports.CodingDecisionSchemaJson = exports.validCodingDecision = exports.codingDecisionSchema = exports.CodingReviewerActionSchemaJson = exports.validCodingReviewerAction = exports.codingReviewerActionSchema = exports.CodingRuleResultSchemaJson = exports.validCodingRuleResult = exports.codingRuleResultSchema = exports.CodingEvidenceSchemaJson = exports.validCodingEvidence = exports.codingEvidenceSchema = void 0;
 exports.codingCaseContextValidationError = codingCaseContextValidationError;
 exports.codingCasePayerValidationError = codingCasePayerValidationError;
 exports.codingCaseClinicalValidationError = codingCaseClinicalValidationError;
@@ -21,6 +21,7 @@ exports.rcmCodingInputValidationError = rcmCodingInputValidationError;
 exports.rcmCodingOutputValidationError = rcmCodingOutputValidationError;
 exports.rcmModelPromptValidationError = rcmModelPromptValidationError;
 exports.rcmRetrievalMetadataValidationError = rcmRetrievalMetadataValidationError;
+exports.rcmReviewerEventValidationError = rcmReviewerEventValidationError;
 exports.rcmRuntimeEventValidationError = rcmRuntimeEventValidationError;
 exports.rcmWorkflowCatalogValidationError = rcmWorkflowCatalogValidationError;
 const zod_1 = require("zod");
@@ -64,6 +65,7 @@ exports.RCM_MODEL_POLICY_ID = "carecompass-rcm-review-v1";
 exports.RCM_HUMAN_REVIEW_POLICY_ID = "qualified-coder-review-v1";
 exports.RCM_OUTPUT_SCHEMA_NAME = "carecompass_rcm_grounded_review";
 exports.RCM_HUMAN_REVIEW_INSTRUCTION = "Qualified human coder review is required before billing, coding, or claim submission.";
+exports.PIN_TIME_WORKFLOW_ID = "monthly-pin-time-aggregation";
 // Schema wire versions (source: schemas/*.schema.json).
 exports.CODING_CASE_CONTEXT_SCHEMA_VERSION = "coding-case-context-v1";
 exports.CODING_CASE_PAYER_SCHEMA_VERSION = "coding-case-payer-v1";
@@ -82,6 +84,7 @@ exports.RCM_INPUT_SCHEMA_VERSION = "rcm-coding-input-v1";
 exports.RCM_OUTPUT_SCHEMA_VERSION = "rcm-grounded-human-review-v2";
 exports.RCM_MODEL_PROMPT_SCHEMA_VERSION = "rcm-model-prompt-v1";
 exports.RCM_RETRIEVAL_SCHEMA_VERSION = "rcm-retrieval-metadata-v1";
+exports.RCM_REVIEWER_EVENT_SCHEMA_VERSION = "rcm-reviewer-event-v1";
 exports.RCM_RUNTIME_EVENT_SCHEMA_VERSION = "rcm-runtime-event-v1";
 exports.RCM_WORKFLOW_CATALOG_SCHEMA_VERSION = "rcm-workflow-catalog-v1";
 // --------------------------------------------------------------------
@@ -3199,7 +3202,7 @@ exports.CodingRuleResultSchemaJson = {
     },
 };
 // --------------------------------------------------------------------
-// CodingReviewerAction (schema 1.0.0, wire coding-reviewer-action-v1)
+// CodingReviewerAction (schema 1.1.0, wire coding-reviewer-action-v1)
 // --------------------------------------------------------------------
 exports.codingReviewerActionSchema = zod_1.z
     .object({
@@ -3212,6 +3215,15 @@ exports.codingReviewerActionSchema = zod_1.z
         "escalated",
     ]),
     resolutionCode: zod_1.z.string().min(1).max(80).optional(),
+    reviewOutcomeCategory: zod_1.z
+        .enum([
+        "unsupported_or_excessive",
+        "missed_supported",
+        "unchanged_supported",
+        "missing_evidence",
+        "escalation",
+    ])
+        .optional(),
     notes: zod_1.z
         .string()
         .min(1)
@@ -3235,6 +3247,7 @@ function codingReviewerActionValidationError(value) {
         "reviewerRole",
         "action",
         "resolutionCode",
+        "reviewOutcomeCategory",
         "notes",
         "occurredAt",
     ].includes(key)))
@@ -3262,6 +3275,18 @@ function codingReviewerActionValidationError(value) {
             value_resolutionCode.length > 80)
             return "reviewer_action_resolution_code";
     }
+    if (value["reviewOutcomeCategory"] !== undefined) {
+        const value_reviewOutcomeCategory = value["reviewOutcomeCategory"];
+        if (typeof value_reviewOutcomeCategory !== "string" ||
+            ![
+                "unsupported_or_excessive",
+                "missed_supported",
+                "unchanged_supported",
+                "missing_evidence",
+                "escalation",
+            ].includes(value_reviewOutcomeCategory))
+            return "reviewer_action_outcome_category";
+    }
     if (value["notes"] !== undefined) {
         const value_notes = value["notes"];
         if (typeof value_notes !== "string" ||
@@ -3284,8 +3309,8 @@ exports.CodingReviewerActionSchemaJson = {
     $schema: "https://json-schema.org/draft/2020-12/schema",
     $id: "https://nexalink.care/contracts/coding-reviewer-action.schema.json",
     title: "CodingReviewerAction",
-    description: "Attributable human-review disposition appended to an otherwise immutable decision. A decision plus its reviewer actions remains replayable: original and reviewer versions are both preserved.",
-    version: "1.0.0",
+    description: "Attributable human-review disposition appended to an otherwise immutable decision. A decision plus its reviewer actions remains replayable: original and reviewer versions are both preserved. Review outcome categories are reviewer-adjudicated observations and never inferred from payment, code, or reimbursement changes.",
+    version: "1.1.0",
     type: "object",
     additionalProperties: false,
     required: ["reviewerId", "action", "occurredAt"],
@@ -3309,6 +3334,16 @@ exports.CodingReviewerActionSchemaJson = {
             minLength: 1,
             maxLength: 80,
         },
+        reviewOutcomeCategory: {
+            type: "string",
+            enum: [
+                "unsupported_or_excessive",
+                "missed_supported",
+                "unchanged_supported",
+                "missing_evidence",
+                "escalation",
+            ],
+        },
         notes: {
             type: "string",
             minLength: 1,
@@ -3500,7 +3535,7 @@ exports.codingDecisionSchema = zod_1.z
         });
     }
 });
-function codingDecisionValidationError(value, options) {
+function codingDecisionValidationError(value) {
     if (!isRecord(value))
         return "coding_decision";
     if (![
@@ -5243,6 +5278,342 @@ exports.RcmRetrievalMetadataSchemaJson = {
     },
 };
 // --------------------------------------------------------------------
+// RcmReviewerEvent (schema 1.0.0, wire rcm-reviewer-event-v1)
+// --------------------------------------------------------------------
+exports.rcmReviewerEventSchema = zod_1.z
+    .object({
+    eventName: zod_1.z.enum([
+        "review_opened",
+        "decision_shown",
+        "evidence_opened",
+        "evidence_copied",
+        "review_active_time",
+    ]),
+    occurredAt: zod_1.z
+        .string()
+        .regex(new RegExp("^\\d{4}-\\d{2}-\\d{2}T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"))
+        .refine(isRfc3339DateTime)
+        .max(64),
+    tenantRef: zod_1.z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9_.:-]+$"))
+        .min(1)
+        .max(128),
+    caseRef: zod_1.z.string().regex(new RegExp("^[A-Za-z0-9_.:-]+$")).min(1).max(128),
+    reviewId: zod_1.z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9_.:-]+$"))
+        .min(1)
+        .max(128)
+        .optional(),
+    workflowId: zod_1.z.enum([
+        "rcm-coding-assistance",
+        "monthly-pin-time-aggregation",
+    ]),
+    packId: zod_1.z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9_.:-]+$"))
+        .min(1)
+        .max(80)
+        .optional(),
+    packVersion: zod_1.z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9_.:-]+$"))
+        .min(1)
+        .max(80)
+        .optional(),
+    environment: zod_1.z.enum(["development", "staging", "production"]).optional(),
+    source: zod_1.z.enum(["portal", "embed"]),
+    evidenceId: zod_1.z
+        .string()
+        .regex(new RegExp("^[A-Za-z0-9_.:-]{1,64}$"))
+        .min(1)
+        .max(64)
+        .optional(),
+    activeSeconds: zod_1.z.number().int().min(0).max(86400).optional(),
+    idlePaused: zod_1.z.boolean().optional(),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    const isEvidenceEvent = value["eventName"] === "evidence_opened" ||
+        value["eventName"] === "evidence_copied";
+    const isActiveTimeEvent = value["eventName"] === "review_active_time";
+    if (isEvidenceEvent !== (value.evidenceId !== undefined) ||
+        isActiveTimeEvent !== (value.activeSeconds !== undefined) ||
+        (!isActiveTimeEvent && value.idlePaused !== undefined)) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["eventName"],
+            message: "reviewer_event_shape",
+        });
+    }
+});
+function rcmReviewerEventValidationError(value) {
+    if (!isRecord(value))
+        return "reviewer_event";
+    if (![
+        "eventName",
+        "occurredAt",
+        "tenantRef",
+        "caseRef",
+        "workflowId",
+        "source",
+    ].every((key) => key in value))
+        return "reviewer_event_keys";
+    if (!Object.keys(value).every((key) => [
+        "eventName",
+        "occurredAt",
+        "tenantRef",
+        "caseRef",
+        "reviewId",
+        "workflowId",
+        "packId",
+        "packVersion",
+        "environment",
+        "source",
+        "evidenceId",
+        "activeSeconds",
+        "idlePaused",
+    ].includes(key)))
+        return "reviewer_event_keys";
+    const value_eventName = value["eventName"];
+    if (typeof value_eventName !== "string" ||
+        ![
+            "review_opened",
+            "decision_shown",
+            "evidence_opened",
+            "evidence_copied",
+            "review_active_time",
+        ].includes(value_eventName))
+        return "reviewer_event_name";
+    const value_occurredAt = value["occurredAt"];
+    if (typeof value_occurredAt !== "string" ||
+        value_occurredAt.length > 64 ||
+        !new RegExp("^\\d{4}-\\d{2}-\\d{2}T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$").test(value_occurredAt) ||
+        !isRfc3339DateTime(value_occurredAt))
+        return "reviewer_event_occurred_at";
+    const value_tenantRef = value["tenantRef"];
+    if (typeof value_tenantRef !== "string" ||
+        value_tenantRef.length < 1 ||
+        value_tenantRef.length > 128 ||
+        !new RegExp("^[A-Za-z0-9_.:-]+$").test(value_tenantRef))
+        return "reviewer_event_tenant_ref";
+    const value_caseRef = value["caseRef"];
+    if (typeof value_caseRef !== "string" ||
+        value_caseRef.length < 1 ||
+        value_caseRef.length > 128 ||
+        !new RegExp("^[A-Za-z0-9_.:-]+$").test(value_caseRef))
+        return "reviewer_event_case_ref";
+    if (value["reviewId"] !== undefined) {
+        const value_reviewId = value["reviewId"];
+        if (typeof value_reviewId !== "string" ||
+            value_reviewId.length < 1 ||
+            value_reviewId.length > 128 ||
+            !new RegExp("^[A-Za-z0-9_.:-]+$").test(value_reviewId))
+            return "reviewer_event_review_id";
+    }
+    const value_workflowId = value["workflowId"];
+    if (typeof value_workflowId !== "string" ||
+        !["rcm-coding-assistance", "monthly-pin-time-aggregation"].includes(value_workflowId))
+        return "reviewer_event_workflow_id";
+    if (value["packId"] !== undefined) {
+        const value_packId = value["packId"];
+        if (typeof value_packId !== "string" ||
+            value_packId.length < 1 ||
+            value_packId.length > 80 ||
+            !new RegExp("^[A-Za-z0-9_.:-]+$").test(value_packId))
+            return "reviewer_event_pack_id";
+    }
+    if (value["packVersion"] !== undefined) {
+        const value_packVersion = value["packVersion"];
+        if (typeof value_packVersion !== "string" ||
+            value_packVersion.length < 1 ||
+            value_packVersion.length > 80 ||
+            !new RegExp("^[A-Za-z0-9_.:-]+$").test(value_packVersion))
+            return "reviewer_event_pack_version";
+    }
+    if (value["environment"] !== undefined) {
+        const value_environment = value["environment"];
+        if (typeof value_environment !== "string" ||
+            !["development", "staging", "production"].includes(value_environment))
+            return "reviewer_event_environment";
+    }
+    const value_source = value["source"];
+    if (typeof value_source !== "string" ||
+        !["portal", "embed"].includes(value_source))
+        return "reviewer_event_source";
+    if (value["evidenceId"] !== undefined) {
+        const value_evidenceId = value["evidenceId"];
+        if (typeof value_evidenceId !== "string" ||
+            value_evidenceId.length < 1 ||
+            value_evidenceId.length > 64 ||
+            !new RegExp("^[A-Za-z0-9_.:-]{1,64}$").test(value_evidenceId))
+            return "reviewer_event_evidence_id";
+    }
+    if (value["activeSeconds"] !== undefined) {
+        const value_activeSeconds = value["activeSeconds"];
+        if (typeof value_activeSeconds !== "number" ||
+            Number.isNaN(value_activeSeconds) ||
+            !Number.isInteger(value_activeSeconds) ||
+            value_activeSeconds < 0 ||
+            value_activeSeconds > 86400)
+            return "reviewer_event_active_seconds";
+    }
+    if (value["idlePaused"] !== undefined) {
+        const value_idlePaused = value["idlePaused"];
+        if (typeof value_idlePaused !== "boolean")
+            return "reviewer_event_idle_paused";
+    }
+    const eventName = value["eventName"];
+    const isEvidenceEvent = eventName === "evidence_opened" || eventName === "evidence_copied";
+    if (isEvidenceEvent !== (value["evidenceId"] !== undefined))
+        return "reviewer_event_shape";
+    const isActiveTimeEvent = eventName === "review_active_time";
+    if (isActiveTimeEvent !== (value["activeSeconds"] !== undefined))
+        return "reviewer_event_shape";
+    if (!isActiveTimeEvent && value["idlePaused"] !== undefined)
+        return "reviewer_event_shape";
+    return null;
+}
+const validRcmReviewerEvent = (value) => rcmReviewerEventValidationError(value) === null;
+exports.validRcmReviewerEvent = validRcmReviewerEvent;
+exports.RcmReviewerEventSchemaJson = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://nexalink.care/contracts/rcm-reviewer-event.schema.json",
+    title: "RcmReviewerEvent",
+    description: "Tenant-scoped, PHI-free reviewer engagement event for CareCompass RCM workflows. Events carry only an opaque case reference, categorical engagement facts, and aggregate durations. They never carry prompts, model responses, document contents, patient or member identifiers, claim identifiers, or free text.",
+    version: "1.0.0",
+    type: "object",
+    additionalProperties: false,
+    required: [
+        "eventName",
+        "occurredAt",
+        "tenantRef",
+        "caseRef",
+        "workflowId",
+        "source",
+    ],
+    properties: {
+        eventName: {
+            type: "string",
+            enum: [
+                "review_opened",
+                "decision_shown",
+                "evidence_opened",
+                "evidence_copied",
+                "review_active_time",
+            ],
+        },
+        occurredAt: {
+            type: "string",
+            pattern: "^\\d{4}-\\d{2}-\\d{2}T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
+            format: "date-time",
+            maxLength: 64,
+        },
+        tenantRef: {
+            type: "string",
+            minLength: 1,
+            maxLength: 128,
+            pattern: "^[A-Za-z0-9_.:-]+$",
+        },
+        caseRef: {
+            type: "string",
+            minLength: 1,
+            maxLength: 128,
+            pattern: "^[A-Za-z0-9_.:-]+$",
+        },
+        reviewId: {
+            type: "string",
+            minLength: 1,
+            maxLength: 128,
+            pattern: "^[A-Za-z0-9_.:-]+$",
+        },
+        workflowId: {
+            type: "string",
+            enum: ["rcm-coding-assistance", "monthly-pin-time-aggregation"],
+        },
+        packId: {
+            type: "string",
+            minLength: 1,
+            maxLength: 80,
+            pattern: "^[A-Za-z0-9_.:-]+$",
+        },
+        packVersion: {
+            type: "string",
+            minLength: 1,
+            maxLength: 80,
+            pattern: "^[A-Za-z0-9_.:-]+$",
+        },
+        environment: {
+            type: "string",
+            enum: ["development", "staging", "production"],
+        },
+        source: {
+            type: "string",
+            enum: ["portal", "embed"],
+        },
+        evidenceId: {
+            type: "string",
+            minLength: 1,
+            pattern: "^[A-Za-z0-9_.:-]{1,64}$",
+            maxLength: 64,
+        },
+        activeSeconds: {
+            type: "integer",
+            minimum: 0,
+            maximum: 86400,
+        },
+        idlePaused: {
+            type: "boolean",
+        },
+    },
+    allOf: [
+        {
+            if: {
+                properties: {
+                    eventName: {
+                        enum: ["evidence_opened", "evidence_copied"],
+                    },
+                },
+                required: ["eventName"],
+            },
+            then: {
+                required: ["evidenceId"],
+            },
+            else: {
+                not: {
+                    required: ["evidenceId"],
+                },
+            },
+        },
+        {
+            if: {
+                properties: {
+                    eventName: {
+                        const: "review_active_time",
+                    },
+                },
+                required: ["eventName"],
+            },
+            then: {
+                required: ["activeSeconds"],
+            },
+            else: {
+                not: {
+                    anyOf: [
+                        {
+                            required: ["activeSeconds"],
+                        },
+                        {
+                            required: ["idlePaused"],
+                        },
+                    ],
+                },
+            },
+        },
+    ],
+};
+// --------------------------------------------------------------------
 // RcmRuntimeEvent (schema 1.0.0, wire rcm-runtime-event-v1)
 // --------------------------------------------------------------------
 exports.rcmRuntimeEventSchema = zod_1.z
@@ -5601,17 +5972,20 @@ exports.RcmRuntimeEventSchemaJson = {
     },
 };
 // --------------------------------------------------------------------
-// RcmWorkflowCatalog (schema 1.0.0, wire rcm-workflow-catalog-v1)
+// RcmWorkflowCatalog (schema 1.1.0, wire rcm-workflow-catalog-v1)
 // --------------------------------------------------------------------
 exports.rcmWorkflowCatalogSchema = zod_1.z
     .object({
-    id: zod_1.z.enum(["rcm-coding-assistance"]),
+    id: zod_1.z.enum(["rcm-coding-assistance", "monthly-pin-time-aggregation"]),
     name: zod_1.z.string().min(1).max(120),
     description: zod_1.z.string().min(1).max(400),
     environments: zod_1.z.array(zod_1.z.enum(["development", "production"])).min(1),
     modelPolicy: zod_1.z
         .object({
-        policyId: zod_1.z.literal("carecompass-rcm-review-v1"),
+        policyId: zod_1.z.enum([
+            "carecompass-rcm-review-v1",
+            "carecompass-pin-time-policy-v1",
+        ]),
         inferencePath: zod_1.z.string().max(64),
         maxNewTokens: zod_1.z.number().int().min(1).max(2048),
         temperature: zod_1.z.number().min(0).max(2),
@@ -5627,7 +6001,21 @@ exports.rcmWorkflowCatalogSchema = zod_1.z
         .strict(),
     outputSchemaVersion: zod_1.z.literal("rcm-grounded-human-review-v2"),
 })
-    .strict();
+    .strict()
+    .superRefine((value, ctx) => {
+    const expectedPolicy = value.id === "rcm-coding-assistance"
+        ? "carecompass-rcm-review-v1"
+        : "carecompass-pin-time-policy-v1";
+    if (value.modelPolicy.policyId !== expectedPolicy ||
+        (value.id === "monthly-pin-time-aggregation" &&
+            value.environments.some((environment) => environment !== "development"))) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["modelPolicy"],
+            message: "workflow_policy_binding",
+        });
+    }
+});
 function rcmWorkflowCatalogValidationError(value) {
     if (!isRecord(value))
         return "workflow_catalog";
@@ -5653,7 +6041,7 @@ function rcmWorkflowCatalogValidationError(value) {
         return "workflow_catalog_keys";
     const value_id = value["id"];
     if (typeof value_id !== "string" ||
-        !["rcm-coding-assistance"].includes(value_id))
+        !["rcm-coding-assistance", "monthly-pin-time-aggregation"].includes(value_id))
         return "workflow_id";
     const value_name = value["name"];
     if (typeof value_name !== "string" ||
@@ -5696,7 +6084,7 @@ function rcmWorkflowCatalogValidationError(value) {
         return "model_policy_keys";
     const value_modelPolicy_policyId = value_modelPolicy["policyId"];
     if (typeof value_modelPolicy_policyId !== "string" ||
-        value_modelPolicy_policyId !== "carecompass-rcm-review-v1")
+        !["carecompass-rcm-review-v1", "carecompass-pin-time-policy-v1"].includes(value_modelPolicy_policyId))
         return "model_policy_id";
     const value_modelPolicy_inferencePath = value_modelPolicy["inferencePath"];
     if (typeof value_modelPolicy_inferencePath !== "string" ||
@@ -5742,6 +6130,15 @@ function rcmWorkflowCatalogValidationError(value) {
     if (typeof value_outputSchemaVersion !== "string" ||
         value_outputSchemaVersion !== "rcm-grounded-human-review-v2")
         return "workflow_output_schema_version";
+    const policy = isRecord(value["modelPolicy"]) ? value["modelPolicy"] : {};
+    const expectedPolicy = value["id"] === "rcm-coding-assistance"
+        ? "carecompass-rcm-review-v1"
+        : "carecompass-pin-time-policy-v1";
+    if (policy["policyId"] !== expectedPolicy ||
+        (value["id"] === "monthly-pin-time-aggregation" &&
+            Array.isArray(value["environments"]) &&
+            value["environments"].some((environment) => environment !== "development")))
+        return "workflow_policy_binding";
     return null;
 }
 const validRcmWorkflowCatalog = (value) => rcmWorkflowCatalogValidationError(value) === null;
@@ -5750,8 +6147,8 @@ exports.RcmWorkflowCatalogSchemaJson = {
     $schema: "https://json-schema.org/draft/2020-12/schema",
     $id: "https://nexalink.care/contracts/rcm-workflow-catalog.schema.json",
     title: "RcmWorkflowCatalog",
-    description: "A single authorized workflow entry. The catalog pins the workflow identifier, model policy, human-review policy, and output schema version that the runtime and portal may offer for the RCM coding-assistance workflow. Customer configuration can never redefine these immutable server-side values.",
-    version: "1.0.0",
+    description: "A single authorized workflow entry. The catalog pins the workflow identifier, model policy, human-review policy, and output schema version that the runtime and portal may offer for registered coding workflows (currently rcm-coding-assistance and monthly-pin-time-aggregation). Customer configuration can never redefine these immutable server-side values.",
+    version: "1.1.0",
     type: "object",
     additionalProperties: false,
     required: [
@@ -5766,7 +6163,7 @@ exports.RcmWorkflowCatalogSchemaJson = {
     properties: {
         id: {
             type: "string",
-            enum: ["rcm-coding-assistance"],
+            enum: ["rcm-coding-assistance", "monthly-pin-time-aggregation"],
         },
         name: {
             type: "string",
@@ -5800,7 +6197,7 @@ exports.RcmWorkflowCatalogSchemaJson = {
             properties: {
                 policyId: {
                     type: "string",
-                    const: "carecompass-rcm-review-v1",
+                    enum: ["carecompass-rcm-review-v1", "carecompass-pin-time-policy-v1"],
                 },
                 inferencePath: {
                     type: "string",
@@ -5846,4 +6243,51 @@ exports.RcmWorkflowCatalogSchemaJson = {
             const: "rcm-grounded-human-review-v2",
         },
     },
+    allOf: [
+        {
+            if: {
+                properties: {
+                    id: {
+                        const: "rcm-coding-assistance",
+                    },
+                },
+            },
+            then: {
+                properties: {
+                    modelPolicy: {
+                        properties: {
+                            policyId: {
+                                const: "carecompass-rcm-review-v1",
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        {
+            if: {
+                properties: {
+                    id: {
+                        const: "monthly-pin-time-aggregation",
+                    },
+                },
+            },
+            then: {
+                properties: {
+                    modelPolicy: {
+                        properties: {
+                            policyId: {
+                                const: "carecompass-pin-time-policy-v1",
+                            },
+                        },
+                    },
+                    environments: {
+                        items: {
+                            const: "development",
+                        },
+                    },
+                },
+            },
+        },
+    ],
 };