index.ts

import type { ArtifactPreview, ArtifactProvenance } from "./runtime-contracts.js"

export * from "./artifact-manifest.js"
export * from "./artifact-references.js"
export * from "./runtime-contracts.js"
export * from "./runtime-policy.js"
export * from "./workspace-policy.js"
export * from "./sandbox-tool-policy.js"
export * from "./command-registry.js"
export * from "./task-input.js"
export * from "./browser-interaction.js"
export * from "./browser-review-bridge.js"
export * from "./recipe-schema.js"
export * from "./recipe-builders.js"
export * from "./benchmark-contracts.js"
export * from "./benchmark-substrate.js"
export * from "./runtime-episode.js"
export * from "./runtime-reference.js"
export * from "./object-utils.js"
export * from "./runtime-action-adapter.js"
export * from "./artifact-bundle-verifier.js"
export * from "./transfer-proof.js"
export * from "./host-tool-registry.js"
export * from "./run-registry.js"

export type ArtifactReviewProgressEventType =
  | "boot"
  | "mount"
  | "agent-start"
  | "tool-activity"
  | "artifact"
  | "complete"
  | (string & {})

export interface ArtifactReviewProgressEvent {
  type: ArtifactReviewProgressEventType
  label: string
  component?: string
  action?: string
  timestamp?: string
}

export type ArtifactReviewActionKind = "approve" | "approve-files" | "discard" | "iterate" | (string & {})

export interface ArtifactReviewAction {
  kind: ArtifactReviewActionKind
  label: string
  requiresApprovedFiles?: boolean
}

export interface ArtifactReviewChangedFile {
  path: string
  status: "added" | "modified" | "deleted"
  label: string
  mountTarget: string
  relativePath: string
}

export interface ArtifactReview {
  schema: "wp-codebox/artifact-review/v1"
  artifactId: string
  createdAt: string
  provenance: ArtifactProvenance
  summary: string
  stats: {
    added: number
    modified: number
    deleted: number
    total: number
  }
  changedFiles: ArtifactReviewChangedFile[]
  preview?: ArtifactPreview
  progress: ArtifactReviewProgressEvent[]
  actions: ArtifactReviewAction[]
  evidence: {
    workspacePatch: string
    patch: string
    patchSha256: string
    artifactContentDigest: string
    changedFiles: string
    diagnostics?: string
    testResults?: string
    runtimeEpisodeTrace?: string
    runtimeReferenceManifest?: string
    runtimeReplayReferenceIndex?: string
    previewEvidence?: string
    previewSessionEvidence?: string
    agentResult?: string
    transcript?: string
  }
  browser?: ArtifactReviewBrowserSummary
  redaction?: ArtifactRedactionSummary
  riskFlags: string[]
}

export interface ArtifactReviewBrowserSummary {
  summary: string
  probes: Array<{
    url: string
    requestedUrl?: string
    preview?: {
      requestedMode: "local" | "public" | "secure"
      effectiveMode: "local" | "public" | "secure"
      localOrigin: string
      effectiveOrigin: string
      publicOrigin?: string
      secureContext?: boolean
      diagnostics: Array<{
        code: string
        severity: "error" | "warning" | "info"
        message: string
        details?: Record<string, unknown>
      }>
    }
    localPreviewOrigin?: string
    requestedPreviewOrigin?: string
    effectivePreviewOrigin?: string
    finalUrl?: string
    viewport?: {
      width: number
      height: number
      deviceScaleFactor: number
      isMobile: boolean
      hasTouch: boolean
      userAgent: string
    } | null
    capabilities?: ArtifactReviewBrowserCapabilities
    replayability?: "artifact-backed" | "partial" | "diagnostic-only"
    consoleMessages: number
    errors: number
    html?: string
    lifecycle?: string
    network?: string
    networkEvents?: number
    checkpoints?: string
    memory?: string
    performance?: string
    screenshot?: string
    console?: string
    errorsFile?: string
    actions?: string
    editorState?: string
    actionCount?: number
    steps?: string
    stepCount?: number
    assertions?: {
      total: number
      passed: number
      failed: number
    }
    summaryFile?: string
  }>
}

export interface ArtifactReviewBrowserCapabilities {
  secureContext: boolean
  userAgent: string
  language?: string
  languages?: string[]
  locale?: string
  timezone?: string
  viewport: {
    width: number
    height: number
    deviceScaleFactor: number
    isMobile: boolean
    hasTouch: boolean
  } | null
  maxTouchPoints: number
  paymentRequest: {
    available: boolean
  }
  permissions: Record<string, { state: "granted" | "denied" | "prompt" | "unsupported" | "error" }>
}

export interface ArtifactRedactionArtifactSummary {
  path: string
  count: number
  kinds: string[]
}

export interface ArtifactRedactionSummary {
  schema: "wp-codebox/artifact-redaction/v1"
  status: "clean" | "redacted"
  total: number
  byKind: Record<string, number>
  artifacts: ArtifactRedactionArtifactSummary[]
}

export interface ArtifactTestResultsRawLogReference {
  path: string
  kind: string
}

export type ArtifactDiagnosticSeverity = "error" | "warning" | "notice" | "info" | (string & {})

export interface ArtifactDiagnosticRef {
  path?: string
  kind?: string
  id?: string
  url?: string
}

export interface ArtifactDiagnostic {
  id: string
  type: string
  severity: ArtifactDiagnosticSeverity
  message: string
  category?: string
  source?: string
  path?: string
  selector?: string
  stage?: string
  code?: string
  provenance?: Record<string, unknown>
  refs?: ArtifactDiagnosticRef[]
  details?: Record<string, unknown>
}

export interface ArtifactDiagnostics {
  schema: "wp-codebox/artifact-diagnostics/v1"
  status: "clean" | "reported"
  summary: {
    total: number
    error: number
    warning: number
    notice: number
    info: number
  }
  diagnostics: ArtifactDiagnostic[]
}

export interface ArtifactTestResultsSuite {
  name: string
  status: "passed" | "failed" | "skipped" | "unknown"
  tests: number
  passed: number
  failed: number
  skipped: number
  unknown: number
  rawLogReferences?: ArtifactTestResultsRawLogReference[]
}

export interface ArtifactTestResults {
  schema: "wp-codebox/test-results/v1"
  status: "passed" | "failed" | "skipped" | "unknown"
  summary: {
    total: number
    passed: number
    failed: number
    skipped: number
    unknown: number
  }
  suites: ArtifactTestResultsSuite[]
  rawLogReferences: ArtifactTestResultsRawLogReference[]
}