@xemahq/contracts 0.1.0

package/dist/retention/lib/policy.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EffectiveRetentionSchema = exports.RetentionProvenanceEntrySchema = exports.RetentionBoundsViolation = exports.RetentionBoundsContradictionError = exports.RetentionPolicyBundleSchema = exports.RetentionRuleSchema = exports.RETENTION_ROLE_SOURCE_KINDS = exports.RetentionRuleRoleSchema = exports.RetentionRuleRole = void 0;
+exports.isRetentionRoleAllowedForSource = isRetentionRoleAllowedForSource;
+exports.areRetentionBoundsSatisfiable = areRetentionBoundsSatisfiable;
+exports.checkRetentionChoiceWithinBounds = checkRetentionChoiceWithinBounds;
+exports.clampRetentionDays = clampRetentionDays;
+const zod_1 = require("zod");
+const primitives_1 = require("./primitives");
+const subject_1 = require("./subject");
+const resource_accounting_1 = require("../../resource-accounting");
+const RETENTION_RULES_MAX = 1000;
+var RetentionRuleRole;
+(function (RetentionRuleRole) {
+    RetentionRuleRole["Floor"] = "floor";
+    RetentionRuleRole["Ceiling"] = "ceiling";
+    RetentionRuleRole["Choice"] = "choice";
+})(RetentionRuleRole || (exports.RetentionRuleRole = RetentionRuleRole = {}));
+exports.RetentionRuleRoleSchema = zod_1.z.nativeEnum(RetentionRuleRole);
+exports.RETENTION_ROLE_SOURCE_KINDS = {
+    [RetentionRuleRole.Floor]: [
+        resource_accounting_1.ResourcePolicySourceKind.InstallationSafety,
+        resource_accounting_1.ResourcePolicySourceKind.Distribution,
+        resource_accounting_1.ResourcePolicySourceKind.License,
+        resource_accounting_1.ResourcePolicySourceKind.ExternalEntitlement,
+    ],
+    [RetentionRuleRole.Ceiling]: [
+        resource_accounting_1.ResourcePolicySourceKind.InstallationSafety,
+        resource_accounting_1.ResourcePolicySourceKind.Distribution,
+        resource_accounting_1.ResourcePolicySourceKind.License,
+        resource_accounting_1.ResourcePolicySourceKind.ExternalEntitlement,
+    ],
+    [RetentionRuleRole.Choice]: [
+        resource_accounting_1.ResourcePolicySourceKind.PlatformOrgOverride,
+        resource_accounting_1.ResourcePolicySourceKind.OrgDelegatedLimit,
+    ],
+};
+function isRetentionRoleAllowedForSource(role, sourceKind) {
+    return exports.RETENTION_ROLE_SOURCE_KINDS[role].includes(sourceKind);
+}
+exports.RetentionRuleSchema = zod_1.z
+    .object({
+    ruleId: primitives_1.RetentionIdentifierSchema,
+    subjectClass: subject_1.RetentionSubjectClassSchema,
+    role: exports.RetentionRuleRoleSchema,
+    windowDays: primitives_1.RetentionWindowDaysSchema,
+})
+    .strict();
+exports.RetentionPolicyBundleSchema = zod_1.z
+    .object({
+    apiVersion: primitives_1.RetentionApiVersionSchema,
+    kind: zod_1.z.literal('retention_policy_bundle'),
+    policyKey: primitives_1.RetentionIdentifierSchema,
+    revision: zod_1.z.number().int().positive().safe(),
+    displayName: zod_1.z.string().min(1).max(200),
+    rules: zod_1.z.array(exports.RetentionRuleSchema).min(1).max(RETENTION_RULES_MAX),
+    createdAt: primitives_1.RetentionTimestampSchema,
+})
+    .strict()
+    .superRefine((bundle, context) => {
+    const ids = bundle.rules.map((rule) => rule.ruleId);
+    if (new Set(ids).size !== ids.length) {
+        context.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['rules'],
+            message: 'Rule identifiers must be unique within a retention bundle.',
+        });
+    }
+});
+class RetentionBoundsContradictionError extends Error {
+    floorDays;
+    ceilingDays;
+    constructor(floorDays, ceilingDays) {
+        super(`Retention bounds are contradictory: a floor of ${floorDays} day(s) cannot coexist ` +
+            `with a ceiling of ${ceilingDays} day(s). Neither keeping nor deleting the data ` +
+            'satisfies both, so no effective window exists.');
+        this.name = 'RetentionBoundsContradictionError';
+        this.floorDays = floorDays;
+        this.ceilingDays = ceilingDays;
+    }
+}
+exports.RetentionBoundsContradictionError = RetentionBoundsContradictionError;
+function areRetentionBoundsSatisfiable(bounds) {
+    if (bounds.floorDays === null || bounds.ceilingDays === null) {
+        return true;
+    }
+    return bounds.floorDays <= bounds.ceilingDays;
+}
+var RetentionBoundsViolation;
+(function (RetentionBoundsViolation) {
+    RetentionBoundsViolation["BelowFloor"] = "below_floor";
+    RetentionBoundsViolation["AboveCeiling"] = "above_ceiling";
+})(RetentionBoundsViolation || (exports.RetentionBoundsViolation = RetentionBoundsViolation = {}));
+function checkRetentionChoiceWithinBounds(choiceDays, bounds) {
+    if (bounds.floorDays !== null && choiceDays < bounds.floorDays) {
+        return RetentionBoundsViolation.BelowFloor;
+    }
+    if (bounds.ceilingDays !== null && choiceDays > bounds.ceilingDays) {
+        return RetentionBoundsViolation.AboveCeiling;
+    }
+    return null;
+}
+function clampRetentionDays(choiceDays, bounds) {
+    if (!areRetentionBoundsSatisfiable(bounds)) {
+        throw new RetentionBoundsContradictionError(bounds.floorDays, bounds.ceilingDays);
+    }
+    let effective = choiceDays;
+    if (bounds.floorDays !== null && effective < bounds.floorDays) {
+        effective = bounds.floorDays;
+    }
+    if (bounds.ceilingDays !== null && effective > bounds.ceilingDays) {
+        effective = bounds.ceilingDays;
+    }
+    return effective;
+}
+exports.RetentionProvenanceEntrySchema = zod_1.z
+    .object({
+    assignmentId: zod_1.z.string().uuid(),
+    assignmentKey: primitives_1.RetentionIdentifierSchema,
+    assignmentRevision: zod_1.z.number().int().positive().safe(),
+    bundleId: zod_1.z.string().uuid(),
+    bundleKey: primitives_1.RetentionIdentifierSchema,
+    bundleRevision: zod_1.z.number().int().positive().safe(),
+    ruleId: primitives_1.RetentionIdentifierSchema,
+    role: exports.RetentionRuleRoleSchema,
+    sourceKind: zod_1.z.nativeEnum(resource_accounting_1.ResourcePolicySourceKind),
+    sourceRef: primitives_1.RetentionIdentifierSchema,
+    scopeKind: primitives_1.RetentionScopeKindSchema,
+    scopeRef: primitives_1.RetentionIdentifierSchema,
+    orgId: primitives_1.RetentionIdentifierSchema.nullable(),
+    windowDays: primitives_1.RetentionWindowDaysSchema,
+    pointerRevision: zod_1.z.string().regex(/^(?:0|[1-9][0-9]*)$/),
+})
+    .strict();
+exports.EffectiveRetentionSchema = zod_1.z
+    .object({
+    apiVersion: primitives_1.RetentionApiVersionSchema,
+    kind: zod_1.z.literal('effective_retention'),
+    orgId: primitives_1.RetentionIdentifierSchema,
+    subjectClass: subject_1.RetentionSubjectClassSchema,
+    configured: zod_1.z.boolean(),
+    effectiveDays: primitives_1.RetentionWindowDaysSchema.nullable(),
+    floorDays: primitives_1.RetentionWindowDaysSchema.nullable(),
+    ceilingDays: primitives_1.RetentionWindowDaysSchema.nullable(),
+    chosenDays: primitives_1.RetentionWindowDaysSchema.nullable(),
+    clamped: zod_1.z.boolean(),
+    policyWatermark: zod_1.z.string().regex(/^(?:0|[1-9][0-9]*)$/),
+    provenance: zod_1.z
+        .object({
+        floor: exports.RetentionProvenanceEntrySchema.nullable(),
+        ceiling: exports.RetentionProvenanceEntrySchema.nullable(),
+        choice: exports.RetentionProvenanceEntrySchema.nullable(),
+        considered: zod_1.z
+            .array(exports.RetentionProvenanceEntrySchema)
+            .max(RETENTION_RULES_MAX),
+    })
+        .strict(),
+    resolvedAt: primitives_1.RetentionTimestampSchema,
+})
+    .strict()
+    .superRefine((effective, context) => {
+    if (effective.configured !== (effective.effectiveDays !== null)) {
+        context.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['effectiveDays'],
+            message: 'A configured retention resolution has an effective window, and an unconfigured one has none.',
+        });
+    }
+    if (effective.configured !== (effective.chosenDays !== null)) {
+        context.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['chosenDays'],
+            message: 'A retention window is configured exactly when a choice applies — bounds alone do not configure one.',
+        });
+    }
+});
+//# sourceMappingURL=policy.js.map

package/dist/retention/lib/policy.js.map

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

package/dist/retention/lib/primitives.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export declare const RETENTION_API_VERSION: "xema.retention/v1";
+export declare const RetentionApiVersionSchema: z.ZodLiteral<"xema.retention/v1">;
+export declare const RetentionIdentifierSchema: z.ZodString;
+export declare const RetentionTimestampSchema: z.ZodString;
+export declare const RETENTION_WINDOW_DAYS_MIN = 1;
+export declare const RETENTION_WINDOW_DAYS_MAX = 36500;
+export declare const RetentionWindowDaysSchema: z.ZodNumber;
+export declare enum RetentionScopeKind {
+    Installation = "installation",
+    Org = "org",
+    Project = "project",
+    User = "user",
+    Application = "application"
+}
+export declare const RetentionScopeKindSchema: z.ZodEnum<typeof RetentionScopeKind>;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/retention/lib/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/retention/lib/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,qBAAqB,EAAG,mBAA4B,CAAC;AAElE,eAAO,MAAM,yBAAyB,mCAAmC,CAAC;AAS1E,eAAO,MAAM,yBAAyB,aAIV,CAAC;AAE7B,eAAO,MAAM,wBAAwB,aAAyC,CAAC;AAW/E,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,eAAO,MAAM,yBAAyB,aAIL,CAAC;AAWlC,oBAAY,kBAAkB;IAC5B,YAAY,iBAAiB;IAC7B,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,WAAW,gBAAgB;CAC5B;AAED,eAAO,MAAM,wBAAwB,sCAAmC,CAAC"}

package/dist/retention/lib/primitives.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetentionScopeKindSchema = exports.RetentionScopeKind = exports.RetentionWindowDaysSchema = exports.RETENTION_WINDOW_DAYS_MAX = exports.RETENTION_WINDOW_DAYS_MIN = exports.RetentionTimestampSchema = exports.RetentionIdentifierSchema = exports.RetentionApiVersionSchema = exports.RETENTION_API_VERSION = void 0;
+const zod_1 = require("zod");
+exports.RETENTION_API_VERSION = 'xema.retention/v1';
+exports.RetentionApiVersionSchema = zod_1.z.literal(exports.RETENTION_API_VERSION);
+const IDENTIFIER_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._~:@/-]*$/;
+exports.RetentionIdentifierSchema = zod_1.z
+    .string()
+    .min(1)
+    .max(200)
+    .regex(IDENTIFIER_PATTERN);
+exports.RetentionTimestampSchema = zod_1.z.string().datetime({ offset: false });
+exports.RETENTION_WINDOW_DAYS_MIN = 1;
+exports.RETENTION_WINDOW_DAYS_MAX = 36_500;
+exports.RetentionWindowDaysSchema = zod_1.z
+    .number()
+    .int()
+    .min(exports.RETENTION_WINDOW_DAYS_MIN)
+    .max(exports.RETENTION_WINDOW_DAYS_MAX);
+var RetentionScopeKind;
+(function (RetentionScopeKind) {
+    RetentionScopeKind["Installation"] = "installation";
+    RetentionScopeKind["Org"] = "org";
+    RetentionScopeKind["Project"] = "project";
+    RetentionScopeKind["User"] = "user";
+    RetentionScopeKind["Application"] = "application";
+})(RetentionScopeKind || (exports.RetentionScopeKind = RetentionScopeKind = {}));
+exports.RetentionScopeKindSchema = zod_1.z.nativeEnum(RetentionScopeKind);
+//# sourceMappingURL=primitives.js.map

package/dist/retention/lib/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/retention/lib/primitives.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAQX,QAAA,qBAAqB,GAAG,mBAA4B,CAAC;AAErD,QAAA,yBAAyB,GAAG,OAAC,CAAC,OAAO,CAAC,6BAAqB,CAAC,CAAC;AAO1E,MAAM,kBAAkB,GAAG,kCAAkC,CAAC;AAEjD,QAAA,yBAAyB,GAAG,OAAC;KACvC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,kBAAkB,CAAC,CAAC;AAEhB,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAWlE,QAAA,yBAAyB,GAAG,CAAC,CAAC;AAC9B,QAAA,yBAAyB,GAAG,MAAM,CAAC;AAEnC,QAAA,yBAAyB,GAAG,OAAC;KACvC,MAAM,EAAE;KACR,GAAG,EAAE;KACL,GAAG,CAAC,iCAAyB,CAAC;KAC9B,GAAG,CAAC,iCAAyB,CAAC,CAAC;AAWlC,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,mDAA6B,CAAA;IAC7B,iCAAW,CAAA;IACX,yCAAmB,CAAA;IACnB,mCAAa,CAAA;IACb,iDAA2B,CAAA;AAC7B,CAAC,EANW,kBAAkB,kCAAlB,kBAAkB,QAM7B;AAEY,QAAA,wBAAwB,GAAG,OAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/retention/lib/subject.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare enum RetentionSubjectClass {
+    AgentSession = "agent_session",
+    Artifact = "artifact",
+    AppRun = "app_run",
+    Notification = "notification",
+    ActivityFeedEntry = "activity_feed_entry",
+    SearchTrace = "search_trace",
+    WorkloadRecord = "workload_record",
+    AuditEntry = "audit_entry"
+}
+export declare const RetentionSubjectClassSchema: z.ZodEnum<typeof RetentionSubjectClass>;
+export declare const RetentionSubjectRefSchema: z.ZodObject<{
+    subjectClass: z.ZodEnum<typeof RetentionSubjectClass>;
+    subjectId: z.ZodString;
+}, z.core.$strict>;
+export type RetentionSubjectRef = z.infer<typeof RetentionSubjectRefSchema>;
+//# sourceMappingURL=subject.d.ts.map

package/dist/retention/lib/subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../../../src/retention/lib/subject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,oBAAY,qBAAqB;IAE/B,YAAY,kBAAkB;IAE9B,QAAQ,aAAa;IAErB,MAAM,YAAY;IAElB,YAAY,iBAAiB;IAE7B,iBAAiB,wBAAwB;IAEzC,WAAW,iBAAiB;IAE5B,cAAc,oBAAoB;IAmBlC,UAAU,gBAAgB;CAC3B;AAED,eAAO,MAAM,2BAA2B,yCAAsC,CAAC;AAS/E,eAAO,MAAM,yBAAyB;;;kBAK3B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/retention/lib/subject.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetentionSubjectRefSchema = exports.RetentionSubjectClassSchema = exports.RetentionSubjectClass = void 0;
+const zod_1 = require("zod");
+const primitives_1 = require("./primitives");
+var RetentionSubjectClass;
+(function (RetentionSubjectClass) {
+    RetentionSubjectClass["AgentSession"] = "agent_session";
+    RetentionSubjectClass["Artifact"] = "artifact";
+    RetentionSubjectClass["AppRun"] = "app_run";
+    RetentionSubjectClass["Notification"] = "notification";
+    RetentionSubjectClass["ActivityFeedEntry"] = "activity_feed_entry";
+    RetentionSubjectClass["SearchTrace"] = "search_trace";
+    RetentionSubjectClass["WorkloadRecord"] = "workload_record";
+    RetentionSubjectClass["AuditEntry"] = "audit_entry";
+})(RetentionSubjectClass || (exports.RetentionSubjectClass = RetentionSubjectClass = {}));
+exports.RetentionSubjectClassSchema = zod_1.z.nativeEnum(RetentionSubjectClass);
+exports.RetentionSubjectRefSchema = zod_1.z
+    .object({
+    subjectClass: exports.RetentionSubjectClassSchema,
+    subjectId: primitives_1.RetentionIdentifierSchema,
+})
+    .strict();
+//# sourceMappingURL=subject.js.map

package/dist/retention/lib/subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.js","sourceRoot":"","sources":["../../../src/retention/lib/subject.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,6CAAyD;AAqBzD,IAAY,qBAkCX;AAlCD,WAAY,qBAAqB;IAE/B,uDAA8B,CAAA;IAE9B,8CAAqB,CAAA;IAErB,2CAAkB,CAAA;IAElB,sDAA6B,CAAA;IAE7B,kEAAyC,CAAA;IAEzC,qDAA4B,CAAA;IAE5B,2DAAkC,CAAA;IAmBlC,mDAA0B,CAAA;AAC5B,CAAC,EAlCW,qBAAqB,qCAArB,qBAAqB,QAkChC;AAEY,QAAA,2BAA2B,GAAG,OAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;AASlE,QAAA,yBAAyB,GAAG,OAAC;KACvC,MAAM,CAAC;IACN,YAAY,EAAE,mCAA2B;IACzC,SAAS,EAAE,sCAAyB;CACrC,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/review-inquiry/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/review-inquiry';
+export * from './lib/web-annotation';
+//# sourceMappingURL=index.d.ts.map

package/dist/review-inquiry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/review-inquiry/index.ts"],"names":[],"mappings":"AAiBA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/review-inquiry/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/review-inquiry"), exports);
+__exportStar(require("./lib/web-annotation"), exports);
+//# sourceMappingURL=index.js.map

package/dist/review-inquiry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/review-inquiry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAiBA,uDAAqC;AACrC,uDAAqC"}

package/dist/review-inquiry/lib/review-inquiry.d.ts

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+export declare const ReviewInquiryPromptSchema: z.ZodObject<{
+    subjectArtifacts: z.ZodArray<z.ZodObject<{
+        artifactId: z.ZodString;
+        versionId: z.ZodString;
+        version: z.ZodNumber;
+        hash: z.ZodString;
+    }, z.core.$strip>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type ReviewInquiryPrompt = z.infer<typeof ReviewInquiryPromptSchema>;
+export declare const ReviewInquiryCommentSchema: z.ZodObject<{
+    body: z.ZodString;
+    anchor: z.ZodOptional<z.ZodObject<{
+        artifactId: z.ZodString;
+        versionId: z.ZodString;
+        version: z.ZodNumber;
+        selector: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"TextQuoteSelector">;
+            exact: z.ZodString;
+            prefix: z.ZodOptional<z.ZodString>;
+            suffix: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"TextPositionSelector">;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"FragmentSelector">;
+            value: z.ZodString;
+            conformsTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"https://tools.ietf.org/html/rfc3986">, z.ZodLiteral<"gfm-heading-slug">]>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"xema:JsonPointerSelector">;
+            pointer: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"RangeSelector">;
+            startSelector: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"TextQuoteSelector">;
+                exact: z.ZodString;
+                prefix: z.ZodOptional<z.ZodString>;
+                suffix: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"TextPositionSelector">;
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"FragmentSelector">;
+                value: z.ZodString;
+                conformsTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"https://tools.ietf.org/html/rfc3986">, z.ZodLiteral<"gfm-heading-slug">]>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"xema:JsonPointerSelector">;
+                pointer: z.ZodString;
+            }, z.core.$strip>], "type">;
+            endSelector: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"TextQuoteSelector">;
+                exact: z.ZodString;
+                prefix: z.ZodOptional<z.ZodString>;
+                suffix: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"TextPositionSelector">;
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"FragmentSelector">;
+                value: z.ZodString;
+                conformsTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"https://tools.ietf.org/html/rfc3986">, z.ZodLiteral<"gfm-heading-slug">]>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"xema:JsonPointerSelector">;
+                pointer: z.ZodString;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ReviewInquiryComment = z.infer<typeof ReviewInquiryCommentSchema>;
+export declare const ReviewInquiryReplySchema: z.ZodObject<{
+    comments: z.ZodArray<z.ZodObject<{
+        body: z.ZodString;
+        anchor: z.ZodOptional<z.ZodObject<{
+            artifactId: z.ZodString;
+            versionId: z.ZodString;
+            version: z.ZodNumber;
+            selector: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"TextQuoteSelector">;
+                exact: z.ZodString;
+                prefix: z.ZodOptional<z.ZodString>;
+                suffix: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"TextPositionSelector">;
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"FragmentSelector">;
+                value: z.ZodString;
+                conformsTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"https://tools.ietf.org/html/rfc3986">, z.ZodLiteral<"gfm-heading-slug">]>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"xema:JsonPointerSelector">;
+                pointer: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"RangeSelector">;
+                startSelector: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"TextQuoteSelector">;
+                    exact: z.ZodString;
+                    prefix: z.ZodOptional<z.ZodString>;
+                    suffix: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"TextPositionSelector">;
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"FragmentSelector">;
+                    value: z.ZodString;
+                    conformsTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"https://tools.ietf.org/html/rfc3986">, z.ZodLiteral<"gfm-heading-slug">]>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"xema:JsonPointerSelector">;
+                    pointer: z.ZodString;
+                }, z.core.$strip>], "type">;
+                endSelector: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"TextQuoteSelector">;
+                    exact: z.ZodString;
+                    prefix: z.ZodOptional<z.ZodString>;
+                    suffix: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"TextPositionSelector">;
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"FragmentSelector">;
+                    value: z.ZodString;
+                    conformsTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"https://tools.ietf.org/html/rfc3986">, z.ZodLiteral<"gfm-heading-slug">]>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"xema:JsonPointerSelector">;
+                    pointer: z.ZodString;
+                }, z.core.$strip>], "type">;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ReviewInquiryReply = z.infer<typeof ReviewInquiryReplySchema>;
+//# sourceMappingURL=review-inquiry.d.ts.map

package/dist/review-inquiry/lib/review-inquiry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-inquiry.d.ts","sourceRoot":"","sources":["../../../src/review-inquiry/lib/review-inquiry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,yBAAyB;;;;;;;;iBAKtB,CAAC;AACjB,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAuB5E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAa9E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/review-inquiry/lib/review-inquiry.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReviewInquiryReplySchema = exports.ReviewInquiryCommentSchema = exports.ReviewInquiryPromptSchema = void 0;
+const zod_1 = require("zod");
+const decision_gate_1 = require("../../decision-gate");
+const web_annotation_1 = require("./web-annotation");
+exports.ReviewInquiryPromptSchema = zod_1.z
+    .object({
+    subjectArtifacts: zod_1.z.array(decision_gate_1.PinnedSubjectArtifactSchema),
+    description: zod_1.z.string().optional(),
+})
+    .passthrough();
+exports.ReviewInquiryCommentSchema = zod_1.z.object({
+    body: zod_1.z.string().trim().min(1),
+    anchor: web_annotation_1.WebAnnotationTargetSchema.optional(),
+});
+exports.ReviewInquiryReplySchema = zod_1.z.object({
+    comments: zod_1.z.array(exports.ReviewInquiryCommentSchema).min(1),
+});
+//# sourceMappingURL=review-inquiry.js.map

package/dist/review-inquiry/lib/review-inquiry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-inquiry.js","sourceRoot":"","sources":["../../../src/review-inquiry/lib/review-inquiry.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,uDAAkE;AAElE,qDAA6D;AAsBhD,QAAA,yBAAyB,GAAG,OAAC;KACvC,MAAM,CAAC;IACN,gBAAgB,EAAE,OAAC,CAAC,KAAK,CAAC,2CAA2B,CAAC;IACtD,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,WAAW,EAAE,CAAC;AAwBJ,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,0CAAyB,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAcU,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,kCAA0B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACrD,CAAC,CAAC"}