@xenosystem/agent-sdk 0.8.12

package/dist/artifacts/index.d.ts

@@ -0,0 +1,588 @@
+import { u as XenoArtifactState, X as XenoArtifactEnvelope, q as XenoArtifactReviewEvent, s as XenoArtifactReviewSummary, L as XenoJsonValue, w as XenoContentHash, F as XenoEvidenceGraph, G as XenoEvidenceNode, D as XenoEvidenceEdge, m as XenoArtifactRecord, d as XenoArtifactActor, k as XenoArtifactListQuery, r as XenoArtifactReviewEventInput, b as XENO_ARTIFACT_SCHEMA_VERSION, j as XenoArtifactLifecycleEvent, p as XenoArtifactReviewDecision, f as XenoArtifactAnchor, I as XenoEvidenceReference, h as XenoArtifactIdentity, t as XenoArtifactSensitivity, i as XenoArtifactKind } from "./diff-artifact-C2tQZWcs.js";
+export { P as ParseUnifiedDiffOptions, c as XENO_EVIDENCE_GRAPH_SCHEMA_VERSION, e as XenoArtifactActorKind, g as XenoArtifactContent, l as XenoArtifactProvenance, n as XenoArtifactRelationship, o as XenoArtifactRetention, v as XenoArtifactStorageReference, M as XenoDiffArtifactContext, a as XenoDiffDocument, x as XenoDiffFile, y as XenoDiffFileStatus, z as XenoDiffHunk, A as XenoDiffLine, B as XenoDiffLineKind, C as XenoDiffMode, N as XenoDiffParseError, E as XenoEvidenceEdgeType, H as XenoEvidenceNodeType, J as XenoJsonObject, K as XenoJsonPrimitive, O as parseUnifiedDiff, Q as unifiedDiffToXenoArtifact, R as xenoArtifactToDiffDocument } from "./diff-artifact-C2tQZWcs.js";
+interface XenoArtifactValidationIssue {
+    path: string;
+    code: string;
+    message: string;
+}
+declare class XenoArtifactValidationError extends Error {
+    readonly code = "ARTIFACT_INVALID";
+    readonly issues: XenoArtifactValidationIssue[];
+    constructor(message: string, issues: XenoArtifactValidationIssue[]);
+}
+declare class XenoArtifactStateTransitionError extends Error {
+    readonly fromState: XenoArtifactState;
+    readonly toState: XenoArtifactState;
+    readonly code = "ARTIFACT_STATE_TRANSITION_INVALID";
+    constructor(fromState: XenoArtifactState, toState: XenoArtifactState);
+}
+declare function validateXenoArtifact(artifact: XenoArtifactEnvelope): XenoArtifactValidationIssue[];
+declare function assertValidXenoArtifact(artifact: XenoArtifactEnvelope): void;
+declare function canTransitionXenoArtifactState(fromState: XenoArtifactState, toState: XenoArtifactState): boolean;
+declare function assertXenoArtifactStateTransition(fromState: XenoArtifactState, toState: XenoArtifactState): void;
+declare function validateXenoArtifactReviewEvent(event: XenoArtifactReviewEvent, artifact?: XenoArtifactEnvelope): XenoArtifactValidationIssue[];
+declare function summarizeXenoArtifactReview(events: readonly XenoArtifactReviewEvent[]): XenoArtifactReviewSummary;
+declare function sha256ArtifactBytes(content: Uint8Array | string): XenoContentHash;
+declare function canonicalizeArtifactJson(value: XenoJsonValue): string;
+declare function sha256ArtifactJson(value: XenoJsonValue): XenoContentHash;
+declare class XenoEvidenceGraphValidationError extends Error {
+    readonly code = "EVIDENCE_GRAPH_INVALID";
+    readonly issues: XenoArtifactValidationIssue[];
+    constructor(issues: XenoArtifactValidationIssue[]);
+}
+declare function validateXenoEvidenceGraph(graph: XenoEvidenceGraph): XenoArtifactValidationIssue[];
+declare function assertValidXenoEvidenceGraph(graph: XenoEvidenceGraph): void;
+interface XenoEvidenceGraphBuilderOptions {
+    graphId: string;
+    now?: () => string;
+}
+declare class XenoEvidenceGraphBuilder {
+    private readonly now;
+    private graph;
+    constructor(options: XenoEvidenceGraphBuilderOptions | XenoEvidenceGraph);
+    addNode(node: XenoEvidenceNode): this;
+    addEdge(edge: XenoEvidenceEdge): this;
+    build(): XenoEvidenceGraph;
+    private touch;
+}
+type XenoArtifactRepositoryErrorCode = "ARTIFACT_ALREADY_EXISTS" | "ARTIFACT_NOT_FOUND" | "ARTIFACT_CONFLICT" | "ARTIFACT_REVISION_INVALID" | "ARTIFACT_CONTENT_UNCHANGED" | "ARTIFACT_REVIEW_INVALID" | "ARTIFACT_REVIEW_DECISION_REQUIRED" | "ARTIFACT_UNRESOLVED_COMMENTS" | "ARTIFACT_PERSISTENCE_CORRUPT" | "ARTIFACT_PERSISTENCE_LOCKED" | "ARTIFACT_PERSISTENCE_IO";
+declare class XenoArtifactRepositoryError extends Error {
+    readonly code: XenoArtifactRepositoryErrorCode;
+    readonly detail?: Record<string, string | number | boolean | null> | undefined;
+    constructor(code: XenoArtifactRepositoryErrorCode, message: string, detail?: Record<string, string | number | boolean | null> | undefined, options?: ErrorOptions);
+}
+interface XenoArtifactMutationOptions {
+    expectedRecordVersion?: number;
+}
+interface XenoArtifactRevisionOptions extends XenoArtifactMutationOptions {
+    actor?: XenoArtifactActor;
+    reason?: string;
+}
+interface XenoArtifactTransitionRequest extends XenoArtifactMutationOptions {
+    artifactId: string;
+    revision?: number;
+    toState: XenoArtifactState;
+    actor: XenoArtifactActor;
+    reason?: string;
+    reviewEventId?: string;
+}
+interface XenoArtifactAppendReviewRequest extends XenoArtifactMutationOptions {
+    event: XenoArtifactReviewEventInput;
+}
+interface XenoArtifactRepository {
+    create(artifact: XenoArtifactEnvelope): Promise<XenoArtifactRecord>;
+    createRevision(artifact: XenoArtifactEnvelope, options?: XenoArtifactRevisionOptions): Promise<XenoArtifactRecord>;
+    get(artifactId: string, revision?: number): Promise<XenoArtifactRecord | undefined>;
+    require(artifactId: string, revision?: number): Promise<XenoArtifactRecord>;
+    list(query?: XenoArtifactListQuery): Promise<XenoArtifactRecord[]>;
+    listRevisions(artifactId: string): Promise<XenoArtifactRecord[]>;
+    transition(request: XenoArtifactTransitionRequest): Promise<XenoArtifactRecord>;
+    appendReviewEvent(request: XenoArtifactAppendReviewRequest): Promise<XenoArtifactRecord>;
+}
+interface XenoArtifactPersistedRecord {
+    artifact: XenoArtifactEnvelope;
+    recordVersion: number;
+    lifecycleEvents: XenoArtifactLifecycleEvent[];
+    reviewEvents: XenoArtifactReviewEvent[];
+}
+interface XenoArtifactRepositoryState {
+    schemaVersion: typeof XENO_ARTIFACT_SCHEMA_VERSION;
+    records: XenoArtifactPersistedRecord[];
+}
+interface InMemoryXenoArtifactRepositoryOptions {
+    now?: () => string;
+    idFactory?: (prefix: "artifact_event" | "review_event") => string;
+    initialState?: XenoArtifactRepositoryState;
+}
+declare class InMemoryXenoArtifactRepository implements XenoArtifactRepository {
+    private readonly records;
+    private readonly currentRevisions;
+    private readonly now;
+    private readonly idFactory;
+    private readonly eventIds;
+    private idCounter;
+    constructor(options?: InMemoryXenoArtifactRepositoryOptions);
+    exportState(): XenoArtifactRepositoryState;
+    create(artifact: XenoArtifactEnvelope): Promise<XenoArtifactRecord>;
+    createRevision(artifact: XenoArtifactEnvelope, options?: XenoArtifactRevisionOptions): Promise<XenoArtifactRecord>;
+    get(artifactId: string, revision?: number): Promise<XenoArtifactRecord | undefined>;
+    require(artifactId: string, revision?: number): Promise<XenoArtifactRecord>;
+    list(query?: XenoArtifactListQuery): Promise<XenoArtifactRecord[]>;
+    listRevisions(artifactId: string): Promise<XenoArtifactRecord[]>;
+    transition(request: XenoArtifactTransitionRequest): Promise<XenoArtifactRecord>;
+    appendReviewEvent(request: XenoArtifactAppendReviewRequest): Promise<XenoArtifactRecord>;
+    private getMutable;
+    private assertVersion;
+    private assertInitialState;
+    private assertReviewCommentState;
+    private createLifecycleEvent;
+    private nextEventId;
+    private hydrate;
+}
+declare const XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION: 1;
+interface XenoArtifactFileSnapshotPayload {
+    schemaVersion: typeof XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION;
+    generation: number;
+    createdAt: string;
+    updatedAt: string;
+    state: XenoArtifactRepositoryState;
+}
+interface XenoArtifactFileSnapshot extends XenoArtifactFileSnapshotPayload {
+    checksum: {
+        algorithm: "sha256";
+        value: string;
+    };
+}
+interface XenoArtifactFileRecoveryNotice {
+    snapshotPath: string;
+    backupPath: string;
+    reason: string;
+}
+interface FileXenoArtifactRepositoryOptions {
+    directory: string;
+    snapshotFileName?: string;
+    lockTimeoutMs?: number;
+    lockRetryMs?: number;
+    maxSnapshotBytes?: number;
+    now?: () => string;
+    onRecovery?: (notice: XenoArtifactFileRecoveryNotice) => void;
+}
+declare class FileXenoArtifactRepository implements XenoArtifactRepository {
+    readonly directory: string;
+    readonly snapshotPath: string;
+    readonly backupPath: string;
+    readonly lockPath: string;
+    private readonly now;
+    private readonly lockTimeoutMs;
+    private readonly lockRetryMs;
+    private readonly maxSnapshotBytes;
+    private readonly onRecovery?;
+    private mutationTail;
+    constructor(options: FileXenoArtifactRepositoryOptions);
+    create(artifact: XenoArtifactEnvelope): Promise<XenoArtifactRecord>;
+    createRevision(artifact: XenoArtifactEnvelope, options?: XenoArtifactRevisionOptions): Promise<XenoArtifactRecord>;
+    get(artifactId: string, revision?: number): Promise<XenoArtifactRecord | undefined>;
+    require(artifactId: string, revision?: number): Promise<XenoArtifactRecord>;
+    list(query?: XenoArtifactListQuery): Promise<XenoArtifactRecord[]>;
+    listRevisions(artifactId: string): Promise<XenoArtifactRecord[]>;
+    transition(request: XenoArtifactTransitionRequest): Promise<XenoArtifactRecord>;
+    appendReviewEvent(request: XenoArtifactAppendReviewRequest): Promise<XenoArtifactRecord>;
+    inspectSnapshot(): Promise<XenoArtifactFileSnapshot | undefined>;
+    private mutate;
+    private enqueueMutation;
+    private acquireLock;
+    private load;
+    private persist;
+    private readSnapshot;
+}
+interface XenoArtifactReviewServiceOptions {
+    repository: XenoArtifactRepository;
+    actor: XenoArtifactActor;
+    idFactory?: () => string;
+}
+interface XenoArtifactReviewAnchorInput {
+    file?: string;
+    line?: number;
+    hunkId?: string;
+}
+interface AddXenoArtifactCommentRequest extends XenoArtifactReviewAnchorInput {
+    artifactId: string;
+    revision?: number;
+    body: string;
+    parentCommentId?: string;
+}
+interface SetXenoArtifactCommentResolutionRequest {
+    artifactId: string;
+    revision?: number;
+    commentId: string;
+    resolved: boolean;
+    reason?: string;
+}
+interface DecideXenoArtifactRequest extends Omit<XenoArtifactReviewAnchorInput, "line"> {
+    artifactId: string;
+    revision?: number;
+    decision: XenoArtifactReviewDecision;
+    rationale?: string;
+}
+declare class XenoArtifactReviewService {
+    private readonly repository;
+    private readonly actor;
+    private readonly idFactory;
+    constructor(options: XenoArtifactReviewServiceOptions);
+    addComment(request: AddXenoArtifactCommentRequest): Promise<XenoArtifactRecord>;
+    setCommentResolution(request: SetXenoArtifactCommentResolutionRequest): Promise<XenoArtifactRecord>;
+    decide(request: DecideXenoArtifactRequest): Promise<XenoArtifactRecord>;
+}
+declare function buildXenoArtifactReviewAnchor(record: XenoArtifactRecord, input: XenoArtifactReviewAnchorInput): XenoArtifactAnchor | undefined;
+declare function normalizeRepositoryRelativePath(value: string): string;
+declare const XENO_SPEC_SCHEMA_VERSION: "xeno.spec.v1";
+declare const XENO_SPEC_EXECUTION_SCHEMA_VERSION: "xeno.spec-execution.v1";
+type XenoSpecPriority = "must" | "should" | "could";
+type XenoSpecTaskStatus = "pending" | "in_progress" | "completed" | "blocked" | "skipped";
+type XenoSpecExecutionState = "ready" | "running" | "completed" | "failed" | "cancelled";
+interface XenoSpecAcceptanceCriterion {
+    id: string;
+    text: string;
+    requiredEvidenceKinds?: string[];
+}
+interface XenoSpecRequirement {
+    id: string;
+    text: string;
+    priority: XenoSpecPriority;
+    acceptanceCriteria: XenoSpecAcceptanceCriterion[];
+    sourceReferences?: XenoEvidenceReference[];
+}
+interface XenoSpecDesignDecision {
+    id: string;
+    decision: string;
+    rationale: string;
+    alternatives?: string[];
+    requirementIds?: string[];
+}
+interface XenoSpecRisk {
+    id: string;
+    description: string;
+    impact: "low" | "medium" | "high" | "critical";
+    mitigation: string;
+    owner?: string;
+}
+interface XenoSpecDesign {
+    summary: string;
+    decisions: XenoSpecDesignDecision[];
+    risks: XenoSpecRisk[];
+}
+interface XenoSpecTask {
+    id: string;
+    title: string;
+    description: string;
+    dependsOn?: string[];
+    requirementIds: string[];
+    acceptanceCriterionIds: string[];
+    expectedPaths?: string[];
+    preferredAgentProfile?: string;
+}
+interface XenoSpecSourceBaseline {
+    repositoryId?: string;
+    commit?: string;
+    workspaceFingerprint?: XenoContentHash;
+}
+interface XenoSpecDocument {
+    schemaVersion: typeof XENO_SPEC_SCHEMA_VERSION;
+    specId: string;
+    revision: number;
+    title: string;
+    problem: string;
+    requirements: XenoSpecRequirement[];
+    design: XenoSpecDesign;
+    tasks: XenoSpecTask[];
+    acceptanceCriteria: XenoSpecAcceptanceCriterion[];
+    sourceBaseline?: XenoSpecSourceBaseline;
+    createdAt: string;
+    updatedAt: string;
+    predecessorRevision?: number;
+}
+interface XenoSpecArtifactContext {
+    producer: XenoArtifactActor;
+    identity?: XenoArtifactIdentity;
+    sensitivity?: XenoArtifactSensitivity;
+    accessPolicyId?: string;
+    createdAt?: string;
+}
+interface XenoSpecArtifactBundle {
+    document: XenoSpecDocument;
+    plan: XenoArtifactEnvelope;
+    requirements: XenoArtifactEnvelope;
+    design: XenoArtifactEnvelope;
+    taskGraph: XenoArtifactEnvelope;
+}
+interface XenoSpecTaskExecution {
+    taskId: string;
+    status: XenoSpecTaskStatus;
+    ownerAgentId?: string;
+    startedAt?: string;
+    completedAt?: string;
+    evidence: XenoEvidenceReference[];
+    acceptanceEvidence: Record<string, XenoEvidenceReference[]>;
+    note?: string;
+}
+interface XenoSpecExecutionRecord {
+    schemaVersion: typeof XENO_SPEC_EXECUTION_SCHEMA_VERSION;
+    executionId: string;
+    specId: string;
+    specRevision: number;
+    planArtifactId: string;
+    planHash: XenoContentHash;
+    state: XenoSpecExecutionState;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    observedPaths: string[];
+    tasks: XenoSpecTaskExecution[];
+}
+interface XenoSpecDriftFinding {
+    code: "PLAN_HASH_MISMATCH" | "UNKNOWN_TASK" | "UNKNOWN_PATH" | "MISSING_TASK_EVIDENCE" | "MISSING_ACCEPTANCE_EVIDENCE" | "DEPENDENCY_INCOMPLETE";
+    severity: "warning" | "error";
+    message: string;
+    taskId?: string;
+    path?: string;
+    criterionId?: string;
+}
+interface XenoSpecDriftReport {
+    schemaVersion: "xeno.spec-drift.v1";
+    specId: string;
+    specRevision: number;
+    executionId: string;
+    checkedAt: string;
+    drifted: boolean;
+    findings: XenoSpecDriftFinding[];
+}
+interface XenoSpecLifecycleServiceOptions {
+    repository: XenoArtifactRepository;
+    now?: () => string;
+    idFactory?: () => string;
+}
+declare class XenoSpecValidationError extends Error {
+    readonly issues: string[];
+    readonly code = "XENO_SPEC_INVALID";
+    constructor(issues: string[]);
+}
+declare class XenoSpecLifecycleService {
+    private readonly repository;
+    private readonly now;
+    private readonly idFactory;
+    constructor(options: XenoSpecLifecycleServiceOptions);
+    create(document: XenoSpecDocument, context: XenoSpecArtifactContext): Promise<XenoSpecArtifactBundle>;
+    revise(document: XenoSpecDocument, context: XenoSpecArtifactContext): Promise<XenoSpecArtifactBundle>;
+    approve(specId: string, reviewer: XenoArtifactActor, rationale?: string): Promise<XenoArtifactRecord>;
+    reject(specId: string, reviewer: XenoArtifactActor, rationale: string): Promise<XenoArtifactRecord>;
+    startExecution(specId: string, actor: XenoArtifactActor): Promise<XenoArtifactRecord>;
+    updateExecution(executionArtifactId: string, update: (record: XenoSpecExecutionRecord) => XenoSpecExecutionRecord, actor: XenoArtifactActor): Promise<XenoArtifactRecord>;
+}
+declare function xenoSpecArtifactIds(specId: string): {
+    plan: string;
+    requirements: string;
+    design: string;
+    taskGraph: string;
+};
+declare function validateXenoSpecDocument(document: XenoSpecDocument): string[];
+declare function assertValidXenoSpecDocument(document: XenoSpecDocument): void;
+declare function xenoSpecToArtifactBundle(document: XenoSpecDocument, context: XenoSpecArtifactContext): XenoSpecArtifactBundle;
+declare function xenoArtifactToSpecDocument(artifact: XenoArtifactEnvelope): XenoSpecDocument;
+declare function xenoSpecExecutionToArtifact(execution: XenoSpecExecutionRecord, context: XenoSpecArtifactContext, revision?: number, predecessorRevision?: number): XenoArtifactEnvelope;
+declare function xenoArtifactToSpecExecution(artifact: XenoArtifactEnvelope): XenoSpecExecutionRecord;
+declare function assertValidXenoSpecExecution(execution: XenoSpecExecutionRecord, document: XenoSpecDocument): void;
+declare function detectXenoSpecDrift(document: XenoSpecDocument, planHash: XenoContentHash, execution: XenoSpecExecutionRecord, actualPlanHash: XenoContentHash, checkedAt?: string): XenoSpecDriftReport;
+declare const XENO_REVIEW_REPORT_SCHEMA_VERSION: "xeno.review-report.v1";
+type XenoReviewDimension = "correctness" | "security" | "performance" | "api" | "tests" | "documentation" | `custom:${string}`;
+type XenoReviewSeverity = "info" | "low" | "medium" | "high" | "critical";
+type XenoReviewFindingState = "verified" | "unverified" | "rejected";
+type XenoReviewVerificationOutcome = "reproduced" | "rejected" | "inconclusive";
+interface XenoReviewEvidence {
+    evidenceId: string;
+    kind: "source" | "test" | "trace" | "artifact" | "reproduction" | "benchmark" | `custom:${string}`;
+    summary: string;
+    producerId: string;
+    reference?: XenoEvidenceReference;
+    anchor?: XenoArtifactAnchor;
+    contentHash?: XenoContentHash;
+}
+interface XenoReviewFindingProposal {
+    ruleId?: string;
+    dimension: XenoReviewDimension;
+    title: string;
+    summary: string;
+    severity: XenoReviewSeverity;
+    confidence: number;
+    anchors: XenoArtifactAnchor[];
+    evidence: XenoReviewEvidence[];
+    remediation?: string;
+}
+interface XenoReviewAgentResult {
+    reviewerAgentId: string;
+    dimension: XenoReviewDimension;
+    findings: XenoReviewFindingProposal[];
+    completedAt: string;
+}
+interface XenoReviewVerificationResult {
+    verifierAgentId: string;
+    outcome: XenoReviewVerificationOutcome;
+    rationale: string;
+    evidence: XenoReviewEvidence[];
+    confidence?: number;
+    completedAt: string;
+}
+interface XenoReviewFinding {
+    findingId: string;
+    fingerprint: string;
+    ruleIds: string[];
+    dimensions: XenoReviewDimension[];
+    reviewerAgentIds: string[];
+    title: string;
+    summary: string;
+    severity: XenoReviewSeverity;
+    confidence: number;
+    state: XenoReviewFindingState;
+    verificationBasis: "verifier" | "independent-evidence" | "none";
+    anchors: XenoArtifactAnchor[];
+    evidence: XenoReviewEvidence[];
+    verifications: XenoReviewVerificationResult[];
+    remediation?: string;
+    duplicateProposalCount: number;
+}
+interface XenoReviewTarget {
+    artifactId: string;
+    revision: number;
+    contentHash: XenoContentHash;
+    title: string;
+    repositoryId?: string;
+    commit?: string;
+    anchors?: XenoArtifactAnchor[];
+}
+interface XenoReviewPack {
+    schemaVersion: "xeno.review-pack.v1";
+    packId: string;
+    version: string;
+    dimensions: XenoReviewDimension[];
+    verifierCount: number;
+    minimumVerifierReproductions: number;
+    allowIndependentEvidenceVerification: boolean;
+    minimumIndependentEvidenceProducers: number;
+    maxFindings: number;
+}
+interface XenoReviewReport {
+    schemaVersion: typeof XENO_REVIEW_REPORT_SCHEMA_VERSION;
+    reportId: string;
+    runId: string;
+    pack: XenoReviewPack;
+    target: XenoReviewTarget;
+    startedAt: string;
+    completedAt: string;
+    reviewers: Array<{
+        agentId: string;
+        dimension: XenoReviewDimension;
+        findingCount: number;
+    }>;
+    findings: XenoReviewFinding[];
+    summary: {
+        total: number;
+        verified: number;
+        unverified: number;
+        rejected: number;
+        bySeverity: Record<XenoReviewSeverity, number>;
+    };
+}
+interface XenoReviewCoordinatorContext {
+    runId: string;
+    target: XenoReviewTarget;
+    pack: XenoReviewPack;
+}
+type XenoReviewAgentExecutor = (request: XenoReviewCoordinatorContext & {
+    dimension: XenoReviewDimension;
+    reviewerSlot: number;
+}) => Promise<XenoReviewAgentResult>;
+type XenoReviewVerifierExecutor = (request: XenoReviewCoordinatorContext & {
+    finding: XenoReviewFinding;
+    verifierSlot: number;
+}) => Promise<XenoReviewVerificationResult>;
+interface XenoMultiAgentReviewCoordinatorOptions {
+    reviewer: XenoReviewAgentExecutor;
+    verifier?: XenoReviewVerifierExecutor;
+    now?: () => string;
+    idFactory?: (prefix: "report" | "finding") => string;
+}
+interface XenoReviewArtifactContext {
+    producer: XenoArtifactActor;
+    identity?: XenoArtifactIdentity;
+    sensitivity?: XenoArtifactSensitivity;
+    accessPolicyId?: string;
+    artifactId?: string;
+    createdAt?: string;
+}
+interface XenoGitHubReviewComment {
+    findingId: string;
+    path: string;
+    line?: number;
+    body: string;
+    severity: XenoReviewSeverity;
+    verified: boolean;
+}
+declare class XenoReviewValidationError extends Error {
+    readonly issues: string[];
+    readonly code = "XENO_REVIEW_INVALID";
+    constructor(issues: string[]);
+}
+declare class XenoMultiAgentReviewCoordinator {
+    private readonly reviewer;
+    private readonly verifier?;
+    private readonly now;
+    private readonly idFactory;
+    constructor(options: XenoMultiAgentReviewCoordinatorOptions);
+    run(context: XenoReviewCoordinatorContext): Promise<XenoReviewReport>;
+}
+declare function defaultXenoReviewPack(packId?: string): XenoReviewPack;
+declare function assertValidXenoReviewPack(pack: XenoReviewPack): void;
+declare function assertValidXenoReviewTarget(target: XenoReviewTarget): void;
+declare function assertValidXenoReviewReport(report: XenoReviewReport): void;
+declare function xenoReviewReportToArtifact(report: XenoReviewReport, context: XenoReviewArtifactContext): XenoArtifactEnvelope;
+declare function xenoArtifactToReviewReport(artifact: XenoArtifactEnvelope): XenoReviewReport;
+declare function xenoReviewReportToGitHubComments(report: XenoReviewReport, options?: {
+    verifiedOnly?: boolean;
+}): XenoGitHubReviewComment[];
+interface AgentArtifact {
+    name: string;
+    mimeType?: string;
+    content: string;
+}
+interface FileSnapshot {
+    path: string;
+    exists: boolean;
+    size: number;
+    mtimeMs: number;
+    text?: string;
+    binary?: boolean;
+    truncated?: boolean;
+}
+interface TurnFileDiff {
+    path: string;
+    status: "created" | "modified" | "deleted" | "unchanged";
+    before?: FileSnapshot;
+    after?: FileSnapshot;
+    patch?: string;
+}
+interface TurnDiffSummary {
+    turnId: string;
+    startedAt: string;
+    completedAt: string;
+    files: TurnFileDiff[];
+}
+interface ToolEvidence {
+    id: string;
+    kind: "artifact" | "process" | "verification";
+    status: "pending" | "verified" | "failed";
+    path?: string;
+    observedAt: string;
+    operationId: string;
+    detail?: Record<string, string | number | boolean | null>;
+}
+interface XenoLegacyArtifactContext {
+    artifactId?: string;
+    revision?: number;
+    createdAt?: string;
+    producer: XenoArtifactActor;
+    identity?: XenoArtifactIdentity;
+    state?: XenoArtifactState;
+    sensitivity?: XenoArtifactSensitivity;
+    accessPolicyId?: string;
+}
+interface XenoLegacyAgentArtifactContext extends XenoLegacyArtifactContext {
+    contentEncoding?: "utf8" | "base64";
+    kind?: XenoArtifactKind;
+}
+declare function legacyAgentArtifactToXenoArtifact(legacy: AgentArtifact, context: XenoLegacyAgentArtifactContext): XenoArtifactEnvelope;
+declare function xenoArtifactToLegacyAgentArtifact(artifact: XenoArtifactEnvelope): AgentArtifact;
+declare function toolEvidenceToXenoArtifact(evidence: ToolEvidence, context: XenoLegacyArtifactContext): XenoArtifactEnvelope;
+declare function xenoArtifactToToolEvidence(artifact: XenoArtifactEnvelope): ToolEvidence;
+declare function turnDiffSummaryToXenoArtifact(summary: TurnDiffSummary, context: XenoLegacyArtifactContext): XenoArtifactEnvelope;
+declare function xenoArtifactToTurnDiffSummary(artifact: XenoArtifactEnvelope): TurnDiffSummary;
+export { type AddXenoArtifactCommentRequest, type DecideXenoArtifactRequest, FileXenoArtifactRepository, type FileXenoArtifactRepositoryOptions, InMemoryXenoArtifactRepository, type InMemoryXenoArtifactRepositoryOptions, type SetXenoArtifactCommentResolutionRequest, XENO_ARTIFACT_FILE_REPOSITORY_SCHEMA_VERSION, XENO_ARTIFACT_SCHEMA_VERSION, XENO_REVIEW_REPORT_SCHEMA_VERSION, XENO_SPEC_EXECUTION_SCHEMA_VERSION, XENO_SPEC_SCHEMA_VERSION, XenoArtifactActor, XenoArtifactAnchor, type XenoArtifactAppendReviewRequest, XenoArtifactEnvelope, type XenoArtifactFileRecoveryNotice, type XenoArtifactFileSnapshot, XenoArtifactIdentity, XenoArtifactKind, XenoArtifactLifecycleEvent, XenoArtifactListQuery, type XenoArtifactMutationOptions, type XenoArtifactPersistedRecord, XenoArtifactRecord, type XenoArtifactRepository, XenoArtifactRepositoryError, type XenoArtifactRepositoryErrorCode, type XenoArtifactRepositoryState, type XenoArtifactReviewAnchorInput, XenoArtifactReviewDecision, XenoArtifactReviewEvent, XenoArtifactReviewEventInput, XenoArtifactReviewService, type XenoArtifactReviewServiceOptions, XenoArtifactReviewSummary, type XenoArtifactRevisionOptions, XenoArtifactSensitivity, XenoArtifactState, XenoArtifactStateTransitionError, type XenoArtifactTransitionRequest, XenoArtifactValidationError, type XenoArtifactValidationIssue, XenoContentHash, XenoEvidenceEdge, XenoEvidenceGraph, XenoEvidenceGraphBuilder, type XenoEvidenceGraphBuilderOptions, XenoEvidenceGraphValidationError, XenoEvidenceNode, XenoEvidenceReference, type XenoGitHubReviewComment, XenoJsonValue, type XenoLegacyAgentArtifactContext, type XenoLegacyArtifactContext, XenoMultiAgentReviewCoordinator, type XenoMultiAgentReviewCoordinatorOptions, type XenoReviewAgentExecutor, type XenoReviewAgentResult, type XenoReviewArtifactContext, type XenoReviewCoordinatorContext, type XenoReviewDimension, type XenoReviewEvidence, type XenoReviewFinding, type XenoReviewFindingProposal, type XenoReviewFindingState, type XenoReviewPack, type XenoReviewReport, type XenoReviewSeverity, type XenoReviewTarget, XenoReviewValidationError, type XenoReviewVerificationOutcome, type XenoReviewVerificationResult, type XenoReviewVerifierExecutor, type XenoSpecAcceptanceCriterion, type XenoSpecArtifactBundle, type XenoSpecArtifactContext, type XenoSpecDesign, type XenoSpecDesignDecision, type XenoSpecDocument, type XenoSpecDriftFinding, type XenoSpecDriftReport, type XenoSpecExecutionRecord, type XenoSpecExecutionState, XenoSpecLifecycleService, type XenoSpecLifecycleServiceOptions, type XenoSpecPriority, type XenoSpecRequirement, type XenoSpecRisk, type XenoSpecSourceBaseline, type XenoSpecTask, type XenoSpecTaskExecution, type XenoSpecTaskStatus, XenoSpecValidationError, assertValidXenoArtifact, assertValidXenoEvidenceGraph, assertValidXenoReviewPack, assertValidXenoReviewReport, assertValidXenoReviewTarget, assertValidXenoSpecDocument, assertValidXenoSpecExecution, assertXenoArtifactStateTransition, buildXenoArtifactReviewAnchor, canTransitionXenoArtifactState, canonicalizeArtifactJson, defaultXenoReviewPack, detectXenoSpecDrift, legacyAgentArtifactToXenoArtifact, normalizeRepositoryRelativePath, sha256ArtifactBytes, sha256ArtifactJson, summarizeXenoArtifactReview, toolEvidenceToXenoArtifact, turnDiffSummaryToXenoArtifact, validateXenoArtifact, validateXenoArtifactReviewEvent, validateXenoEvidenceGraph, validateXenoSpecDocument, xenoArtifactToLegacyAgentArtifact, xenoArtifactToReviewReport, xenoArtifactToSpecDocument, xenoArtifactToSpecExecution, xenoArtifactToToolEvidence, xenoArtifactToTurnDiffSummary, xenoReviewReportToArtifact, xenoReviewReportToGitHubComments, xenoSpecArtifactIds, xenoSpecExecutionToArtifact, xenoSpecToArtifactBundle };