@xenosystem/agent-sdk 0.8.12

package/dist/oracle/index.cjs

@@ -0,0 +1 @@
+"use strict";var E=Object.defineProperty;var ee=Object.getOwnPropertyDescriptor;var te=Object.getOwnPropertyNames;var ne=Object.prototype.hasOwnProperty;var ie=(e,t)=>{for(var n in t)E(e,n,{get:t[n],enumerable:!0})},re=(e,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of te(t))!ne.call(e,r)&&r!==n&&E(e,r,{get:()=>t[r],enumerable:!(i=ee(t,r))||i.enumerable});return e};var oe=e=>re(E({},"__esModule",{value:!0}),e);var Oe={};ie(Oe,{XENO_ORACLE_REPORT_SCHEMA_VERSION:()=>q,XenoOracleCoordinator:()=>j,XenoOracleValidationError:()=>u,assertValidXenoOracleReport:()=>O,xenoArtifactToOracleReport:()=>Xe,xenoOracleReportToArtifact:()=>Ie});module.exports=oe(Oe);var $=require("node:crypto");var D=require("node:crypto");function y(e){return{algorithm:"sha256",value:(0,D.createHash)("sha256").update(e).digest("hex")}}function k(e){return JSON.stringify(x(e,new Set))}function S(e){return y(k(e))}function x(e,t){if(e===null||typeof e!="object"){if(typeof e=="number"&&!Number.isFinite(e))throw new TypeError("Artifact JSON cannot contain non-finite numbers");return e}if(t.has(e))throw new TypeError("Artifact JSON cannot contain cycles");if(t.add(e),Array.isArray(e)){let i=e.map(r=>x(r,t));return t.delete(e),i}let n={};for(let i of Object.keys(e).sort((r,a)=>r.localeCompare(a))){let r=e[i];if(r===void 0)throw new TypeError(`Artifact JSON property ${i} is undefined`);n[i]=x(r,t)}return t.delete(e),n}var T=require("node:buffer");var C=class extends Error{code="ARTIFACT_INVALID";issues;constructor(t,n){super(t),this.name="XenoArtifactValidationError",this.issues=n.map(i=>({...i}))}};var se=/^[a-z0-9][a-z0-9._/-]{0,127}$/,ae="[\\u0000-\\u001f\\u007f]",ce=new RegExp(ae),de=/^[a-f0-9]{64}$/,ue=/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/,pe=new Set(["draft","pending_review","approved","rejected","superseded","archived"]),le=new Set(["public","internal","confidential","restricted"]),fe=new Set(["agent","tool","user","system","integration"]),me=new Set(["plan","requirements","design","task-graph","patch","diff","file","document","diagram","screenshot","recording","browser-snapshot","test-report","review-report","security-report","performance-report","release-report","sbom","provenance","attestation"]),ge=new Set(["requirement","design-decision","risk","task","agent","run","tool-call","edit","commit","test-case","test-run","finding","approval","artifact","release","claim"]),he=new Set(["decomposes","depends_on","implements","changes","tests","verifies","finds","fixes","reviews","approves","rejects","supersedes","derived_from","produced_by","supports_claim","contradicts_claim","released_as"]);function o(e,t,n,i){e.push({path:t,code:n,message:i})}function s(e,t,n,i=1024){return typeof e!="string"||e.trim().length===0?(o(n,t,"required_string","Value must be a non-empty string"),!1):(e.length>i&&o(n,t,"string_too_long",`Value must not exceed ${i} characters`),ce.test(e)&&o(n,t,"control_character","Value must not contain control characters"),!0)}function b(e,t,n){e!==void 0&&(!Number.isFinite(Date.parse(e))||!e.includes("T"))&&o(n,t,"invalid_timestamp","Value must be an ISO 8601 timestamp")}function v(e,t,n,i){if(typeof e!="string"||!e.startsWith(t))return;let r=e.slice(t.length);se.test(r)||o(i,n,"invalid_custom_name",`Custom name after ${t} is invalid`)}function ye(e,t,n){if(!e||typeof e!="object"){o(n,t,"missing_actor","Actor is required");return}s(e.kind,`${t}.kind`,n,64),fe.has(e.kind)||o(n,`${t}.kind`,"unknown_actor_kind","Actor kind is not supported"),s(e.id,`${t}.id`,n,512),e?.displayName!==void 0&&s(e.displayName,`${t}.displayName`,n,512),e?.profileFingerprint!==void 0&&!/^[a-f0-9]{64}$/.test(e.profileFingerprint)&&o(n,`${t}.profileFingerprint`,"invalid_fingerprint","Profile fingerprint must be 64 lowercase hexadecimal characters")}function ve(e,t,n){if(!e||typeof e!="object"){o(n,t,"invalid_anchor","Anchor must be an object");return}switch(e.kind){case"file":s(e.path,`${t}.path`,n,4096);break;case"source-line":s(e.path,`${t}.path`,n,4096),(!Number.isInteger(e.startLine)||e.startLine<1)&&o(n,`${t}.startLine`,"invalid_line","startLine must be a positive integer"),e.endLine!==void 0&&(!Number.isInteger(e.endLine)||e.endLine<e.startLine)&&o(n,`${t}.endLine`,"invalid_line_range","endLine must be greater than or equal to startLine");break;case"diff-hunk":s(e.path,`${t}.path`,n,4096),s(e.hunkId,`${t}.hunkId`,n,512);break;case"symbol":s(e.path,`${t}.path`,n,4096),s(e.symbol,`${t}.symbol`,n,1024);break;case"dom-node":s(e.pageId,`${t}.pageId`,n,512),!e.selector&&!e.accessibilityId&&!e.snapshotArtifactId&&o(n,t,"missing_dom_locator","DOM anchors require a selector, accessibility ID, or snapshot artifact ID");break;case"timeline":s(e.recordingArtifactId,`${t}.recordingArtifactId`,n,512),(!Number.isFinite(e.startMs)||e.startMs<0)&&o(n,`${t}.startMs`,"invalid_time","startMs must be a non-negative finite number"),e.endMs!==void 0&&(!Number.isFinite(e.endMs)||e.endMs<e.startMs)&&o(n,`${t}.endMs`,"invalid_time_range","endMs must be greater than or equal to startMs");break;case"region":s(e.mediaArtifactId,`${t}.mediaArtifactId`,n,512),[e.x,e.y,e.width,e.height].every(Number.isFinite)?(e.width<=0||e.height<=0)&&o(n,t,"invalid_region_size","Region width and height must be positive"):o(n,t,"invalid_region","Region coordinates must be finite numbers");break;case"artifact":s(e.artifactId,`${t}.artifactId`,n,512);break;default:typeof e.kind!="string"||!e.kind.startsWith("custom:")?o(n,`${t}.kind`,"unknown_anchor","Anchor kind is not supported"):v(e.kind,"custom:",`${t}.kind`,n)}}function A(e,t,n,i){if(!(e===null||typeof e=="string"||typeof e=="boolean")){if(typeof e=="number"){Number.isFinite(e)||o(n,t,"non_finite_number","JSON numbers must be finite");return}if(typeof e!="object"){o(n,t,"non_json_value","Value must be JSON-serializable");return}if(i.has(e)){o(n,t,"cyclic_value","Value must not contain cycles");return}if(i.add(e),Array.isArray(e))e.forEach((r,a)=>A(r,`${t}[${a}]`,n,i));else for(let[r,a]of Object.entries(e))a===void 0?o(n,`${t}.${r}`,"undefined_value","Undefined is not valid JSON"):A(a,`${t}.${r}`,n,i);i.delete(e)}}function Ae(e){let t=[];if(!e||typeof e!="object")return[{path:"$",code:"invalid_artifact",message:"Artifact must be an object"}];if(e.schemaVersion!==1&&o(t,"schemaVersion","unsupported_schema",`schemaVersion must be ${1}`),s(e.artifactId,"artifactId",t,512),(!Number.isInteger(e.revision)||e.revision<1)&&o(t,"revision","invalid_revision","revision must be a positive integer"),s(e.kind,"kind",t,160),typeof e.kind=="string"&&!me.has(e.kind)&&!e.kind.startsWith("custom:")&&o(t,"kind","unknown_artifact_kind","Artifact kind is not supported"),v(e.kind,"custom:","kind",t),s(e.title,"title",t,1024),e.description!==void 0&&s(e.description,"description",t,32768),s(e.state,"state",t,64),pe.has(e.state)||o(t,"state","unknown_state","Artifact state is not supported"),s(e.createdAt,"createdAt",t,128),b(e.createdAt,"createdAt",t),b(e.updatedAt,"updatedAt",t),e.updatedAt&&Number.isFinite(Date.parse(e.createdAt))&&Date.parse(e.updatedAt)<Date.parse(e.createdAt)&&o(t,"updatedAt","timestamp_order","updatedAt must not precede createdAt"),s(e.mediaType,"mediaType",t,255),s(e.sensitivity,"sensitivity",t,64),le.has(e.sensitivity)||o(t,"sensitivity","unknown_sensitivity","Sensitivity is not supported"),e.identity)for(let[i,r]of Object.entries(e.identity))r!==void 0&&s(r,`identity.${i}`,t,512);if(!e.content||typeof e.content!="object")o(t,"content","missing_content","content descriptor is required");else{!e.content.hash||typeof e.content.hash!="object"?o(t,"content.hash","missing_hash","content hash is required"):(s(e.content.hash.algorithm,"content.hash.algorithm",t,128),v(e.content.hash.algorithm,"custom:","content.hash.algorithm",t),typeof e.content.hash.algorithm=="string"&&e.content.hash.algorithm!=="sha256"&&!e.content.hash.algorithm.startsWith("custom:")&&o(t,"content.hash.algorithm","unknown_hash_algorithm","Hash algorithm is not supported"),s(e.content.hash.value,"content.hash.value",t,512),e.content.hash.algorithm==="sha256"&&!de.test(e.content.hash.value)&&o(t,"content.hash.value","invalid_sha256","SHA-256 hash must be 64 lowercase hexadecimal characters")),(!Number.isSafeInteger(e.content.sizeBytes)||e.content.sizeBytes<0)&&o(t,"content.sizeBytes","invalid_size","sizeBytes must be a non-negative safe integer");let i=e.content.storage;if(!i||typeof i!="object")o(t,"content.storage","missing_storage","storage reference is required");else if(i.type==="inline")if(i.text===void 0==(i.base64===void 0))o(t,"content.storage","invalid_inline_storage","Inline storage requires exactly one of text or base64");else{let r;i.text!==void 0?r=T.Buffer.from(i.text,"utf8"):i.base64!==void 0&&(ue.test(i.base64)?r=T.Buffer.from(i.base64,"base64"):o(t,"content.storage.base64","invalid_base64","Inline base64 content is malformed")),r&&e.content.sizeBytes!==r.byteLength&&o(t,"content.sizeBytes","content_size_mismatch","sizeBytes does not match inline content"),r&&e.content.hash.algorithm==="sha256"&&y(r).value!==e.content.hash.value&&o(t,"content.hash.value","content_hash_mismatch","Hash does not match inline content")}else i.type==="file"?s(i.path,"content.storage.path",t,4096):i.type==="blob"?s(i.uri,"content.storage.uri",t,8192):i.type==="git"?(s(i.commit,"content.storage.commit",t,512),s(i.path,"content.storage.path",t,4096)):i.type==="url"?(s(i.url,"content.storage.url",t,8192),b(i.expiresAt,"content.storage.expiresAt",t)):i.type==="external"?(s(i.provider,"content.storage.provider",t,255),s(i.locator,"content.storage.locator",t,8192)):o(t,"content.storage.type","unknown_storage","Storage type is not supported");e.content.encoding!==void 0&&(typeof e.content.encoding!="string"||e.content.encoding!=="utf8"&&e.content.encoding!=="base64"&&e.content.encoding!=="binary"&&!e.content.encoding.startsWith("custom:"))&&o(t,"content.encoding","unknown_encoding","Content encoding is not supported"),v(e.content.encoding,"custom:","content.encoding",t)}!e.provenance||typeof e.provenance!="object"?o(t,"provenance","missing_provenance","provenance is required"):(ye(e.provenance.producer,"provenance.producer",t),e.provenance.capabilityLeaseIds?.forEach((i,r)=>s(i,`provenance.capabilityLeaseIds[${r}]`,t,512)),e.provenance.sourceArtifactIds?.forEach((i,r)=>s(i,`provenance.sourceArtifactIds[${r}]`,t,512)),e.provenance.attributes&&A(e.provenance.attributes,"provenance.attributes",t,new Set));let n=new Set;return e.relationships?.forEach((i,r)=>{let a=`relationships[${r}]`;s(i.relation,`${a}.relation`,t,160),typeof i.relation=="string"&&!he.has(i.relation)&&!i.relation.startsWith("custom:")&&o(t,`${a}.relation`,"unknown_relationship","Relationship type is not supported"),v(i.relation,"custom:",`${a}.relation`,t),s(i.target?.type,`${a}.target.type`,t,160),typeof i.target?.type=="string"&&!ge.has(i.target.type)&&!i.target.type.startsWith("custom:")&&o(t,`${a}.target.type`,"unknown_reference_type","Evidence reference type is not supported"),v(i.target?.type,"custom:",`${a}.target.type`,t),s(i.target?.id,`${a}.target.id`,t,512);let d=`${i.relation}:${i.target?.type}:${i.target?.id}:${i.target?.revision??""}`;n.has(d)&&o(t,a,"duplicate_relationship","Duplicate relationship"),n.add(d),i.attributes&&A(i.attributes,`${a}.attributes`,t,new Set)}),e.anchors?.forEach((i,r)=>ve(i,`anchors[${r}]`,t)),e.revision===1&&e.predecessorRevision!==void 0&&o(t,"predecessorRevision","unexpected_predecessor","First revision cannot have a predecessor"),e.revision>1&&(!Number.isInteger(e.predecessorRevision)||(e.predecessorRevision??0)>=e.revision)&&o(t,"predecessorRevision","invalid_predecessor","Later revisions require an earlier predecessor revision"),b(e.retention?.retainUntil,"retention.retainUntil",t),e.retention?.legalHold!==void 0&&typeof e.retention.legalHold!="boolean"&&o(t,"retention.legalHold","invalid_boolean","legalHold must be a boolean"),e.extensions&&A(e.extensions,"extensions",t,new Set),t}function J(e){let t=Ae(e);if(t.length>0)throw new C("XENO artifact validation failed",t)}function L(e,t={}){for(let n of e){let i=n.codePointAt(0);if(i===127)return!0;if(!(i>31)&&!(i===9&&t.allowTab===!0)&&!((i===10||i===13)&&t.allowLineBreaks===!0))return!0}return!1}var q="xeno.oracle-report.v1",u=class extends Error{constructor(n){super(`XENO Oracle report is invalid: ${n.join("; ")}`);this.issues=n;this.name="XenoOracleValidationError"}issues;code="XENO_ORACLE_INVALID"},j=class{execute;adjudicate;now;idFactory;constructor(t){if(typeof t?.execute!="function"||typeof t?.adjudicate!="function")throw new TypeError("Oracle execution and adjudication functions are required");this.execute=t.execute,this.adjudicate=t.adjudicate,this.now=t.now??(()=>new Date().toISOString()),this.idFactory=t.idFactory??(n=>`${n}_${(0,$.randomUUID)()}`)}async run(t){let n=W(t.question,"question",128e3),i=t.runId??`oracle_run_${(0,$.randomUUID)()}`;Z(i,"runId");let r=[t.primary,...t.critics,t.adjudicator];we(r,t.primary,t.critics,t.adjudicator);let a=this.now(),d=await this.execute({runId:i,question:n,participant:structuredClone(t.primary)}),p=P(d,t.primary,this.idFactory("opinion"),this.now()),R=await Promise.all(t.critics.map(async l=>{let h=await this.execute({runId:i,question:n,participant:structuredClone(l),primaryOpinion:structuredClone(p)});return P(h,l,this.idFactory("opinion"),this.now())})),c=[p,...R],g=await this.adjudicate({runId:i,question:n,participant:structuredClone(t.adjudicator),opinions:structuredClone(c)}),X=be(g,t.adjudicator,this.now()),G=this.now(),Y=new Set(r.map(_)),Q=new Set(c.flatMap(l=>l.citations.map(h=>h.citationId))),M={schemaVersion:q,reportId:this.idFactory("oracle"),runId:i,question:n,questionHash:y(n),startedAt:a,completedAt:G,opinions:c,adjudication:X,summary:{participantCount:r.length,distinctModelCount:Y.size,totalInputTokens:c.reduce((l,h)=>l+h.usage.inputTokens,X.usage.inputTokens),totalOutputTokens:c.reduce((l,h)=>l+h.usage.outputTokens,X.usage.outputTokens),unresolvedDisagreements:X.disagreements.filter(l=>l.resolution==="unresolved").length,citationCount:Q.size}};return O(M),M}};function O(e){let t=[];e?.schemaVersion!==q&&t.push("schemaVersion must be xeno.oracle-report.v1"),f(e?.reportId,"reportId",t),f(e?.runId,"runId",t),m(e?.question,"question",t,128e3),(e?.questionHash?.algorithm!=="sha256"||e.questionHash.value!==y(e.question??"").value)&&t.push("questionHash does not match question"),I(e?.startedAt,"startedAt",t),I(e?.completedAt,"completedAt",t),Date.parse(e?.completedAt)<Date.parse(e?.startedAt)&&t.push("completedAt cannot precede startedAt"),(!Array.isArray(e?.opinions)||e.opinions.length<2)&&t.push("at least two independent opinions are required");let n=new Set,i=new Set,r=new Set;for(let c of e?.opinions??[]){z(c,t),n.has(c.participant.participantId)&&t.push(`duplicate participant ${c.participant.participantId}`),n.add(c.participant.participantId),i.add(_(c.participant));for(let g of c.citations)r.add(g.citationId)}i.size<2&&t.push("Oracle requires at least two distinct provider/model identities"),B(e?.adjudication,r,t),e?.adjudication?.participant&&(n.add(e.adjudication.participant.participantId),i.add(_(e.adjudication.participant)));let a=[...(e?.opinions??[]).map(c=>c.usage),e?.adjudication?.usage].filter(Boolean),d=a.reduce((c,g)=>c+g.inputTokens,0),p=a.reduce((c,g)=>c+g.outputTokens,0);e?.summary?.participantCount!==n.size&&t.push("summary participantCount is inconsistent"),e?.summary?.distinctModelCount!==i.size&&t.push("summary distinctModelCount is inconsistent"),(e?.summary?.totalInputTokens!==d||e?.summary?.totalOutputTokens!==p)&&t.push("summary token usage is inconsistent"),e?.summary?.citationCount!==r.size&&t.push("summary citationCount is inconsistent");let R=e?.adjudication?.disagreements?.filter(c=>c.resolution==="unresolved").length??0;if(e?.summary?.unresolvedDisagreements!==R&&t.push("summary unresolvedDisagreements is inconsistent"),t.length>0)throw new u([...new Set(t)])}function Ie(e,t){O(e);let n=e,i=k(n),r={schemaVersion:1,artifactId:t.artifactId??`oracle_${y(`${e.runId}:${e.questionHash.value}`).value.slice(0,24)}`,revision:1,kind:"custom:oracle-report",title:"Cross-model Oracle report",description:`${e.summary.distinctModelCount} distinct models; ${e.summary.unresolvedDisagreements} unresolved disagreements`,state:"pending_review",createdAt:e.completedAt,mediaType:"application/vnd.xeno.oracle-report+json",sensitivity:t.sensitivity??"internal",...t.identity?{identity:structuredClone(t.identity)}:{},content:{hash:S(n),sizeBytes:Buffer.byteLength(i,"utf8"),encoding:"utf8",storage:{type:"inline",text:i},redactedPreview:`${e.adjudication.verdict}: ${e.adjudication.conclusion.slice(0,240)}`},provenance:{producer:structuredClone(t.producer),attributes:{distinctModelCount:e.summary.distinctModelCount,participants:e.opinions.map(a=>`${a.participant.providerId}:${a.participant.model}`),adjudicator:`${e.adjudication.participant.providerId}:${e.adjudication.participant.model}`}},...t.accessPolicyId?{accessPolicyId:t.accessPolicyId}:{},extensions:{"xeno.oracle.verdict":e.adjudication.verdict,"xeno.oracle.confidence":e.adjudication.confidence,"xeno.oracle.unresolved":e.summary.unresolvedDisagreements,"xeno.oracle.questionHash":e.questionHash.value}};return J(r),r}function Xe(e){if(e.kind!=="custom:oracle-report"||e.mediaType!=="application/vnd.xeno.oracle-report+json")throw new u([`Artifact ${e.artifactId} is not an Oracle report`]);if(e.content.storage.type!=="inline"||typeof e.content.storage.text!="string")throw new u(["Oracle reports require inline JSON content"]);let t;try{t=JSON.parse(e.content.storage.text)}catch{throw new u(["Oracle report content is invalid JSON"])}if(O(t),S(t).value!==e.content.hash.value)throw new u(["Oracle report content hash does not match the artifact"]);return structuredClone(t)}function P(e,t,n,i){let r=U(e.usage),a={...structuredClone(e.opinion),opinionId:n,participant:structuredClone(t),completedAt:i,usage:r},d=[];if(z(a,d),d.length>0)throw new u(d);return a}function be(e,t,n){let i={...structuredClone(e.adjudication),participant:structuredClone(t),completedAt:n,usage:U(e.usage)},r=[];if(B(i,void 0,r),r.length>0)throw new u(r);return i}function we(e,t,n,i){let r=[];(n.length<1||n.length>8)&&r.push("Oracle requires one through eight critic models"),t.role!=="primary"&&r.push("primary participant role must be primary"),n.some(p=>p.role!=="critic")&&r.push("critic participant roles must be critic"),i.role!=="adjudicator"&&r.push("adjudicator participant role must be adjudicator");let a=new Set,d=new Set;for(let p of e)H(p,r),a.has(p.participantId)&&r.push(`duplicate participant ${p.participantId}`),a.add(p.participantId),d.add(_(p));if(d.size<2&&r.push("Oracle requires at least two distinct provider/model identities"),r.length>0)throw new u([...new Set(r)])}function z(e,t){f(e?.opinionId,"opinionId",t),H(e?.participant,t),m(e?.answer,"opinion answer",t,256e3),m(e?.publicRationale,"opinion publicRationale",t,128e3),V(e?.verdict)||t.push("opinion verdict is invalid"),N(e?.confidence,"opinion confidence",t),I(e?.completedAt,"opinion completedAt",t),K(e?.usage,"opinion usage",t);let n=new Set;for(let r of e?.citations??[])_e(r,t),n.has(r.citationId)&&t.push(`duplicate citation ${r.citationId}`),n.add(r.citationId);let i=new Set;for(let r of e?.claims??[]){f(r?.claimId,"claimId",t),i.has(r.claimId)&&t.push(`duplicate claim ${r.claimId}`),i.add(r.claimId),m(r?.statement,`claim ${r.claimId} statement`,t,32e3),V(r?.verdict)||t.push(`claim ${r.claimId} verdict is invalid`),N(r?.confidence,`claim ${r.claimId} confidence`,t);for(let a of r?.citationIds??[])n.has(a)||t.push(`claim ${r.claimId} references unknown citation ${a}`)}}function B(e,t,n){H(e?.participant,n),e?.participant?.role!=="adjudicator"&&n.push("adjudication participant role must be adjudicator"),m(e?.conclusion,"adjudication conclusion",n,256e3),m(e?.publicRationale,"adjudication publicRationale",n,128e3),V(e?.verdict)||n.push("adjudication verdict is invalid"),N(e?.confidence,"adjudication confidence",n),I(e?.completedAt,"adjudication completedAt",n),K(e?.usage,"adjudication usage",n);let i=new Set;for(let r of e?.disagreements??[])f(r?.disagreementId,"disagreementId",n),i.has(r.disagreementId)&&n.push(`duplicate disagreement ${r.disagreementId}`),i.add(r.disagreementId),m(r?.summary,`disagreement ${r.disagreementId} summary`,n,32e3),(!Array.isArray(r?.participantIds)||r.participantIds.length<2)&&n.push(`disagreement ${r.disagreementId} requires at least two participants`),["low","medium","high"].includes(r?.severity)||n.push(`disagreement ${r.disagreementId} severity is invalid`),r?.resolution!=="resolved"&&r?.resolution!=="unresolved"&&n.push(`disagreement ${r.disagreementId} resolution is invalid`);if(t)for(let r of e?.citationIds??[])t.has(r)||n.push(`adjudication references unknown citation ${r}`)}function H(e,t){f(e?.participantId,"participantId",t),f(e?.providerId,"providerId",t),m(e?.model,"participant model",t,512),e?.connectionId!==void 0&&f(e.connectionId,"connectionId",t),["primary","critic","adjudicator"].includes(e?.role)||t.push("participant role is invalid")}function _e(e,t){f(e?.citationId,"citationId",t);try{let n=new URL(e?.uri);n.protocol!=="https:"&&n.protocol!=="http:"&&t.push(`citation ${e.citationId} must use HTTP(S)`),(n.username||n.password)&&t.push(`citation ${e.citationId} cannot contain credentials`)}catch{t.push(`citation ${e?.citationId??"(unknown)"} URI is invalid`)}e?.retrievedAt!==void 0&&I(e.retrievedAt,`citation ${e.citationId} retrievedAt`,t),e?.contentHash&&(e.contentHash.algorithm!=="sha256"||!/^[a-f0-9]{64}$/u.test(e.contentHash.value))&&t.push(`citation ${e.citationId} contentHash is invalid`)}function U(e){return{inputTokens:F(e?.inputTokens),outputTokens:F(e?.outputTokens)}}function K(e,t,n){(!Number.isInteger(e?.inputTokens)||e.inputTokens<0)&&n.push(`${t} inputTokens must be a non-negative integer`),(!Number.isInteger(e?.outputTokens)||e.outputTokens<0)&&n.push(`${t} outputTokens must be a non-negative integer`)}function F(e){return Number.isInteger(e)&&(e??-1)>=0?e:0}function _(e){return`${e.providerId.trim().toLowerCase()}\0${e.model.trim().toLowerCase()}`}function W(e,t,n){let i=typeof e=="string"?e.trim():"";if(!i||i.length>n||L(i,{allowTab:!0,allowLineBreaks:!0}))throw new u([`${t} must be non-empty bounded text`]);return i}function Z(e,t){let n=typeof e=="string"?e.trim():"";if(!/^[A-Za-z0-9][A-Za-z0-9._:@/-]{0,255}$/u.test(n))throw new u([`${t} is invalid`]);return n}function f(e,t,n){try{Z(e,t)}catch{n.push(`${t} is invalid`)}}function m(e,t,n,i){try{W(e,t,i)}catch{n.push(`${t} must be non-empty bounded text`)}}function N(e,t,n){(typeof e!="number"||!Number.isFinite(e)||e<0||e>1)&&n.push(`${t} must be between 0 and 1`)}function I(e,t,n){(typeof e!="string"||!Number.isFinite(Date.parse(e)))&&n.push(`${t} must be an ISO timestamp`)}function V(e){return e==="supported"||e==="contested"||e==="unsupported"||e==="insufficient-evidence"}0&&(module.exports={XENO_ORACLE_REPORT_SCHEMA_VERSION,XenoOracleCoordinator,XenoOracleValidationError,assertValidXenoOracleReport,xenoArtifactToOracleReport,xenoOracleReportToArtifact});

package/dist/oracle/index.d.cts

@@ -0,0 +1,310 @@
+declare const XENO_ARTIFACT_SCHEMA_VERSION: 1;
+type XenoJsonPrimitive = string | number | boolean | null;
+type XenoJsonValue = XenoJsonPrimitive | XenoJsonObject | XenoJsonValue[];
+interface XenoJsonObject {
+    [key: string]: XenoJsonValue;
+}
+type XenoArtifactKind = "plan" | "requirements" | "design" | "task-graph" | "patch" | "diff" | "file" | "document" | "diagram" | "screenshot" | "recording" | "browser-snapshot" | "test-report" | "review-report" | "security-report" | "performance-report" | "release-report" | "sbom" | "provenance" | "attestation" | `custom:${string}`;
+type XenoArtifactState = "draft" | "pending_review" | "approved" | "rejected" | "superseded" | "archived";
+type XenoArtifactSensitivity = "public" | "internal" | "confidential" | "restricted";
+interface XenoContentHash {
+    algorithm: "sha256" | `custom:${string}`;
+    value: string;
+}
+type XenoArtifactStorageReference = {
+    type: "inline";
+    text?: string;
+    base64?: string;
+} | {
+    type: "file";
+    path: string;
+} | {
+    type: "blob";
+    uri: string;
+} | {
+    type: "git";
+    commit: string;
+    path: string;
+    repositoryId?: string;
+} | {
+    type: "url";
+    url: string;
+    expiresAt?: string;
+} | {
+    type: "external";
+    provider: string;
+    locator: string;
+};
+interface XenoArtifactContent {
+    hash: XenoContentHash;
+    sizeBytes: number;
+    storage: XenoArtifactStorageReference;
+    encoding?: "utf8" | "base64" | "binary" | `custom:${string}`;
+    redactedPreview?: string;
+}
+interface XenoArtifactIdentity {
+    runId?: string;
+    sessionId?: string;
+    turnId?: string;
+    taskId?: string;
+    agentId?: string;
+    workspaceId?: string;
+    repositoryId?: string;
+}
+type XenoArtifactActorKind = "agent" | "tool" | "user" | "system" | "integration";
+interface XenoArtifactActor {
+    kind: XenoArtifactActorKind;
+    id: string;
+    displayName?: string;
+    profileFingerprint?: string;
+}
+interface XenoArtifactProvenance {
+    producer: XenoArtifactActor;
+    eventId?: string;
+    toolCallId?: string;
+    operationId?: string;
+    executionContractFingerprint?: string;
+    capabilityLeaseIds?: string[];
+    sourceArtifactIds?: string[];
+    attributes?: XenoJsonObject;
+}
+type XenoEvidenceNodeType = "requirement" | "design-decision" | "risk" | "task" | "agent" | "run" | "tool-call" | "edit" | "commit" | "test-case" | "test-run" | "finding" | "approval" | "artifact" | "release" | "claim" | `custom:${string}`;
+type XenoEvidenceEdgeType = "decomposes" | "depends_on" | "implements" | "changes" | "tests" | "verifies" | "finds" | "fixes" | "reviews" | "approves" | "rejects" | "supersedes" | "derived_from" | "produced_by" | "supports_claim" | "contradicts_claim" | "released_as" | `custom:${string}`;
+interface XenoEvidenceReference {
+    type: XenoEvidenceNodeType;
+    id: string;
+    revision?: number;
+}
+interface XenoArtifactRelationship {
+    relation: XenoEvidenceEdgeType;
+    target: XenoEvidenceReference;
+    description?: string;
+    attributes?: XenoJsonObject;
+}
+type XenoArtifactAnchor = {
+    kind: "file";
+    path: string;
+    repositoryId?: string;
+    commit?: string;
+} | {
+    kind: "source-line";
+    path: string;
+    startLine: number;
+    endLine?: number;
+    repositoryId?: string;
+    commit?: string;
+} | {
+    kind: "diff-hunk";
+    path: string;
+    hunkId: string;
+    artifactId?: string;
+    revision?: number;
+} | {
+    kind: "symbol";
+    path: string;
+    symbol: string;
+    repositoryId?: string;
+    commit?: string;
+} | {
+    kind: "dom-node";
+    pageId: string;
+    selector?: string;
+    accessibilityId?: string;
+    snapshotArtifactId?: string;
+} | {
+    kind: "timeline";
+    startMs: number;
+    endMs?: number;
+    recordingArtifactId: string;
+} | {
+    kind: "region";
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    mediaArtifactId: string;
+} | {
+    kind: "artifact";
+    artifactId: string;
+    revision?: number;
+} | {
+    kind: `custom:${string}`;
+    data: XenoJsonObject;
+};
+interface XenoArtifactRetention {
+    policyId?: string;
+    retainUntil?: string;
+    legalHold?: boolean;
+}
+interface XenoArtifactEnvelope {
+    schemaVersion: typeof XENO_ARTIFACT_SCHEMA_VERSION;
+    artifactId: string;
+    revision: number;
+    kind: XenoArtifactKind;
+    title: string;
+    description?: string;
+    state: XenoArtifactState;
+    createdAt: string;
+    updatedAt?: string;
+    mediaType: string;
+    sensitivity: XenoArtifactSensitivity;
+    identity?: XenoArtifactIdentity;
+    content: XenoArtifactContent;
+    provenance: XenoArtifactProvenance;
+    relationships?: XenoArtifactRelationship[];
+    anchors?: XenoArtifactAnchor[];
+    predecessorRevision?: number;
+    accessPolicyId?: string;
+    retention?: XenoArtifactRetention;
+    extensions?: Record<string, XenoJsonValue>;
+}
+declare const XENO_ORACLE_REPORT_SCHEMA_VERSION: "xeno.oracle-report.v1";
+type XenoOracleRole = "primary" | "critic" | "adjudicator";
+type XenoOracleVerdict = "supported" | "contested" | "unsupported" | "insufficient-evidence";
+interface XenoOracleModelIdentity {
+    participantId: string;
+    role: XenoOracleRole;
+    connectionId?: string;
+    providerId: string;
+    model: string;
+}
+interface XenoOracleCitation {
+    citationId: string;
+    uri: string;
+    title?: string;
+    publisher?: string;
+    retrievedAt?: string;
+    revision?: string;
+    license?: string;
+    contentHash?: XenoContentHash;
+}
+interface XenoOracleClaim {
+    claimId: string;
+    statement: string;
+    verdict: XenoOracleVerdict;
+    confidence: number;
+    citationIds: string[];
+}
+interface XenoOracleOpinionDraft {
+    answer: string;
+    verdict: XenoOracleVerdict;
+    confidence: number;
+    claims: XenoOracleClaim[];
+    citations: XenoOracleCitation[];
+    publicRationale: string;
+}
+interface XenoOracleOpinion extends XenoOracleOpinionDraft {
+    opinionId: string;
+    participant: XenoOracleModelIdentity;
+    completedAt: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface XenoOracleDisagreement {
+    disagreementId: string;
+    summary: string;
+    participantIds: string[];
+    severity: "low" | "medium" | "high";
+    resolution: "resolved" | "unresolved";
+}
+interface XenoOracleAdjudicationDraft {
+    conclusion: string;
+    verdict: XenoOracleVerdict;
+    confidence: number;
+    consensusPoints: string[];
+    disagreements: XenoOracleDisagreement[];
+    citationIds: string[];
+    publicRationale: string;
+}
+interface XenoOracleAdjudication extends XenoOracleAdjudicationDraft {
+    participant: XenoOracleModelIdentity;
+    completedAt: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface XenoOracleReport {
+    schemaVersion: typeof XENO_ORACLE_REPORT_SCHEMA_VERSION;
+    reportId: string;
+    runId: string;
+    question: string;
+    questionHash: XenoContentHash;
+    startedAt: string;
+    completedAt: string;
+    opinions: XenoOracleOpinion[];
+    adjudication: XenoOracleAdjudication;
+    summary: {
+        participantCount: number;
+        distinctModelCount: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        unresolvedDisagreements: number;
+        citationCount: number;
+    };
+}
+interface XenoOracleExecutionRequest {
+    runId: string;
+    question: string;
+    participant: XenoOracleModelIdentity;
+    primaryOpinion?: XenoOracleOpinion;
+}
+interface XenoOracleExecutionResult {
+    opinion: XenoOracleOpinionDraft;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+interface XenoOracleAdjudicationRequest {
+    runId: string;
+    question: string;
+    participant: XenoOracleModelIdentity;
+    opinions: XenoOracleOpinion[];
+}
+interface XenoOracleAdjudicationResult {
+    adjudication: XenoOracleAdjudicationDraft;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+interface XenoOracleCoordinatorOptions {
+    execute: (request: XenoOracleExecutionRequest) => Promise<XenoOracleExecutionResult>;
+    adjudicate: (request: XenoOracleAdjudicationRequest) => Promise<XenoOracleAdjudicationResult>;
+    now?: () => string;
+    idFactory?: (prefix: "oracle" | "opinion") => string;
+}
+interface XenoOracleRunOptions {
+    runId?: string;
+    question: string;
+    primary: XenoOracleModelIdentity;
+    critics: XenoOracleModelIdentity[];
+    adjudicator: XenoOracleModelIdentity;
+}
+interface XenoOracleArtifactContext {
+    producer: XenoArtifactActor;
+    identity?: XenoArtifactIdentity;
+    sensitivity?: XenoArtifactSensitivity;
+    accessPolicyId?: string;
+    artifactId?: string;
+}
+declare class XenoOracleValidationError extends Error {
+    readonly issues: string[];
+    readonly code = "XENO_ORACLE_INVALID";
+    constructor(issues: string[]);
+}
+declare class XenoOracleCoordinator {
+    private readonly execute;
+    private readonly adjudicate;
+    private readonly now;
+    private readonly idFactory;
+    constructor(options: XenoOracleCoordinatorOptions);
+    run(options: XenoOracleRunOptions): Promise<XenoOracleReport>;
+}
+declare function assertValidXenoOracleReport(report: XenoOracleReport): void;
+declare function xenoOracleReportToArtifact(report: XenoOracleReport, context: XenoOracleArtifactContext): XenoArtifactEnvelope;
+declare function xenoArtifactToOracleReport(artifact: XenoArtifactEnvelope): XenoOracleReport;
+export { XENO_ORACLE_REPORT_SCHEMA_VERSION, type XenoOracleAdjudication, type XenoOracleAdjudicationDraft, type XenoOracleAdjudicationRequest, type XenoOracleAdjudicationResult, type XenoOracleArtifactContext, type XenoOracleCitation, type XenoOracleClaim, XenoOracleCoordinator, type XenoOracleCoordinatorOptions, type XenoOracleDisagreement, type XenoOracleExecutionRequest, type XenoOracleExecutionResult, type XenoOracleModelIdentity, type XenoOracleOpinion, type XenoOracleOpinionDraft, type XenoOracleReport, type XenoOracleRole, type XenoOracleRunOptions, XenoOracleValidationError, type XenoOracleVerdict, assertValidXenoOracleReport, xenoArtifactToOracleReport, xenoOracleReportToArtifact };

package/dist/oracle/index.d.ts

@@ -0,0 +1,310 @@
+declare const XENO_ARTIFACT_SCHEMA_VERSION: 1;
+type XenoJsonPrimitive = string | number | boolean | null;
+type XenoJsonValue = XenoJsonPrimitive | XenoJsonObject | XenoJsonValue[];
+interface XenoJsonObject {
+    [key: string]: XenoJsonValue;
+}
+type XenoArtifactKind = "plan" | "requirements" | "design" | "task-graph" | "patch" | "diff" | "file" | "document" | "diagram" | "screenshot" | "recording" | "browser-snapshot" | "test-report" | "review-report" | "security-report" | "performance-report" | "release-report" | "sbom" | "provenance" | "attestation" | `custom:${string}`;
+type XenoArtifactState = "draft" | "pending_review" | "approved" | "rejected" | "superseded" | "archived";
+type XenoArtifactSensitivity = "public" | "internal" | "confidential" | "restricted";
+interface XenoContentHash {
+    algorithm: "sha256" | `custom:${string}`;
+    value: string;
+}
+type XenoArtifactStorageReference = {
+    type: "inline";
+    text?: string;
+    base64?: string;
+} | {
+    type: "file";
+    path: string;
+} | {
+    type: "blob";
+    uri: string;
+} | {
+    type: "git";
+    commit: string;
+    path: string;
+    repositoryId?: string;
+} | {
+    type: "url";
+    url: string;
+    expiresAt?: string;
+} | {
+    type: "external";
+    provider: string;
+    locator: string;
+};
+interface XenoArtifactContent {
+    hash: XenoContentHash;
+    sizeBytes: number;
+    storage: XenoArtifactStorageReference;
+    encoding?: "utf8" | "base64" | "binary" | `custom:${string}`;
+    redactedPreview?: string;
+}
+interface XenoArtifactIdentity {
+    runId?: string;
+    sessionId?: string;
+    turnId?: string;
+    taskId?: string;
+    agentId?: string;
+    workspaceId?: string;
+    repositoryId?: string;
+}
+type XenoArtifactActorKind = "agent" | "tool" | "user" | "system" | "integration";
+interface XenoArtifactActor {
+    kind: XenoArtifactActorKind;
+    id: string;
+    displayName?: string;
+    profileFingerprint?: string;
+}
+interface XenoArtifactProvenance {
+    producer: XenoArtifactActor;
+    eventId?: string;
+    toolCallId?: string;
+    operationId?: string;
+    executionContractFingerprint?: string;
+    capabilityLeaseIds?: string[];
+    sourceArtifactIds?: string[];
+    attributes?: XenoJsonObject;
+}
+type XenoEvidenceNodeType = "requirement" | "design-decision" | "risk" | "task" | "agent" | "run" | "tool-call" | "edit" | "commit" | "test-case" | "test-run" | "finding" | "approval" | "artifact" | "release" | "claim" | `custom:${string}`;
+type XenoEvidenceEdgeType = "decomposes" | "depends_on" | "implements" | "changes" | "tests" | "verifies" | "finds" | "fixes" | "reviews" | "approves" | "rejects" | "supersedes" | "derived_from" | "produced_by" | "supports_claim" | "contradicts_claim" | "released_as" | `custom:${string}`;
+interface XenoEvidenceReference {
+    type: XenoEvidenceNodeType;
+    id: string;
+    revision?: number;
+}
+interface XenoArtifactRelationship {
+    relation: XenoEvidenceEdgeType;
+    target: XenoEvidenceReference;
+    description?: string;
+    attributes?: XenoJsonObject;
+}
+type XenoArtifactAnchor = {
+    kind: "file";
+    path: string;
+    repositoryId?: string;
+    commit?: string;
+} | {
+    kind: "source-line";
+    path: string;
+    startLine: number;
+    endLine?: number;
+    repositoryId?: string;
+    commit?: string;
+} | {
+    kind: "diff-hunk";
+    path: string;
+    hunkId: string;
+    artifactId?: string;
+    revision?: number;
+} | {
+    kind: "symbol";
+    path: string;
+    symbol: string;
+    repositoryId?: string;
+    commit?: string;
+} | {
+    kind: "dom-node";
+    pageId: string;
+    selector?: string;
+    accessibilityId?: string;
+    snapshotArtifactId?: string;
+} | {
+    kind: "timeline";
+    startMs: number;
+    endMs?: number;
+    recordingArtifactId: string;
+} | {
+    kind: "region";
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    mediaArtifactId: string;
+} | {
+    kind: "artifact";
+    artifactId: string;
+    revision?: number;
+} | {
+    kind: `custom:${string}`;
+    data: XenoJsonObject;
+};
+interface XenoArtifactRetention {
+    policyId?: string;
+    retainUntil?: string;
+    legalHold?: boolean;
+}
+interface XenoArtifactEnvelope {
+    schemaVersion: typeof XENO_ARTIFACT_SCHEMA_VERSION;
+    artifactId: string;
+    revision: number;
+    kind: XenoArtifactKind;
+    title: string;
+    description?: string;
+    state: XenoArtifactState;
+    createdAt: string;
+    updatedAt?: string;
+    mediaType: string;
+    sensitivity: XenoArtifactSensitivity;
+    identity?: XenoArtifactIdentity;
+    content: XenoArtifactContent;
+    provenance: XenoArtifactProvenance;
+    relationships?: XenoArtifactRelationship[];
+    anchors?: XenoArtifactAnchor[];
+    predecessorRevision?: number;
+    accessPolicyId?: string;
+    retention?: XenoArtifactRetention;
+    extensions?: Record<string, XenoJsonValue>;
+}
+declare const XENO_ORACLE_REPORT_SCHEMA_VERSION: "xeno.oracle-report.v1";
+type XenoOracleRole = "primary" | "critic" | "adjudicator";
+type XenoOracleVerdict = "supported" | "contested" | "unsupported" | "insufficient-evidence";
+interface XenoOracleModelIdentity {
+    participantId: string;
+    role: XenoOracleRole;
+    connectionId?: string;
+    providerId: string;
+    model: string;
+}
+interface XenoOracleCitation {
+    citationId: string;
+    uri: string;
+    title?: string;
+    publisher?: string;
+    retrievedAt?: string;
+    revision?: string;
+    license?: string;
+    contentHash?: XenoContentHash;
+}
+interface XenoOracleClaim {
+    claimId: string;
+    statement: string;
+    verdict: XenoOracleVerdict;
+    confidence: number;
+    citationIds: string[];
+}
+interface XenoOracleOpinionDraft {
+    answer: string;
+    verdict: XenoOracleVerdict;
+    confidence: number;
+    claims: XenoOracleClaim[];
+    citations: XenoOracleCitation[];
+    publicRationale: string;
+}
+interface XenoOracleOpinion extends XenoOracleOpinionDraft {
+    opinionId: string;
+    participant: XenoOracleModelIdentity;
+    completedAt: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface XenoOracleDisagreement {
+    disagreementId: string;
+    summary: string;
+    participantIds: string[];
+    severity: "low" | "medium" | "high";
+    resolution: "resolved" | "unresolved";
+}
+interface XenoOracleAdjudicationDraft {
+    conclusion: string;
+    verdict: XenoOracleVerdict;
+    confidence: number;
+    consensusPoints: string[];
+    disagreements: XenoOracleDisagreement[];
+    citationIds: string[];
+    publicRationale: string;
+}
+interface XenoOracleAdjudication extends XenoOracleAdjudicationDraft {
+    participant: XenoOracleModelIdentity;
+    completedAt: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface XenoOracleReport {
+    schemaVersion: typeof XENO_ORACLE_REPORT_SCHEMA_VERSION;
+    reportId: string;
+    runId: string;
+    question: string;
+    questionHash: XenoContentHash;
+    startedAt: string;
+    completedAt: string;
+    opinions: XenoOracleOpinion[];
+    adjudication: XenoOracleAdjudication;
+    summary: {
+        participantCount: number;
+        distinctModelCount: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        unresolvedDisagreements: number;
+        citationCount: number;
+    };
+}
+interface XenoOracleExecutionRequest {
+    runId: string;
+    question: string;
+    participant: XenoOracleModelIdentity;
+    primaryOpinion?: XenoOracleOpinion;
+}
+interface XenoOracleExecutionResult {
+    opinion: XenoOracleOpinionDraft;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+interface XenoOracleAdjudicationRequest {
+    runId: string;
+    question: string;
+    participant: XenoOracleModelIdentity;
+    opinions: XenoOracleOpinion[];
+}
+interface XenoOracleAdjudicationResult {
+    adjudication: XenoOracleAdjudicationDraft;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+interface XenoOracleCoordinatorOptions {
+    execute: (request: XenoOracleExecutionRequest) => Promise<XenoOracleExecutionResult>;
+    adjudicate: (request: XenoOracleAdjudicationRequest) => Promise<XenoOracleAdjudicationResult>;
+    now?: () => string;
+    idFactory?: (prefix: "oracle" | "opinion") => string;
+}
+interface XenoOracleRunOptions {
+    runId?: string;
+    question: string;
+    primary: XenoOracleModelIdentity;
+    critics: XenoOracleModelIdentity[];
+    adjudicator: XenoOracleModelIdentity;
+}
+interface XenoOracleArtifactContext {
+    producer: XenoArtifactActor;
+    identity?: XenoArtifactIdentity;
+    sensitivity?: XenoArtifactSensitivity;
+    accessPolicyId?: string;
+    artifactId?: string;
+}
+declare class XenoOracleValidationError extends Error {
+    readonly issues: string[];
+    readonly code = "XENO_ORACLE_INVALID";
+    constructor(issues: string[]);
+}
+declare class XenoOracleCoordinator {
+    private readonly execute;
+    private readonly adjudicate;
+    private readonly now;
+    private readonly idFactory;
+    constructor(options: XenoOracleCoordinatorOptions);
+    run(options: XenoOracleRunOptions): Promise<XenoOracleReport>;
+}
+declare function assertValidXenoOracleReport(report: XenoOracleReport): void;
+declare function xenoOracleReportToArtifact(report: XenoOracleReport, context: XenoOracleArtifactContext): XenoArtifactEnvelope;
+declare function xenoArtifactToOracleReport(artifact: XenoArtifactEnvelope): XenoOracleReport;
+export { XENO_ORACLE_REPORT_SCHEMA_VERSION, type XenoOracleAdjudication, type XenoOracleAdjudicationDraft, type XenoOracleAdjudicationRequest, type XenoOracleAdjudicationResult, type XenoOracleArtifactContext, type XenoOracleCitation, type XenoOracleClaim, XenoOracleCoordinator, type XenoOracleCoordinatorOptions, type XenoOracleDisagreement, type XenoOracleExecutionRequest, type XenoOracleExecutionResult, type XenoOracleModelIdentity, type XenoOracleOpinion, type XenoOracleOpinionDraft, type XenoOracleReport, type XenoOracleRole, type XenoOracleRunOptions, XenoOracleValidationError, type XenoOracleVerdict, assertValidXenoOracleReport, xenoArtifactToOracleReport, xenoOracleReportToArtifact };