@svsprotocol/solana 0.1.0

package/dist/common.d.ts

@@ -0,0 +1,1135 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+  [key: string]: JsonValue;
+}
+
+export interface SvsNextAction {
+  code: string;
+  message: string;
+  [key: string]: unknown;
+}
+
+export interface SvsCheck {
+  name?: string;
+  id?: string;
+  label?: string;
+  ok: boolean;
+  detail?: string | null;
+  remediation?: string | null;
+  [key: string]: unknown;
+}
+
+export interface SvsActionIntent {
+  [key: string]: JsonValue | undefined;
+  botId?: string;
+  controllerWallet?: string;
+  txType?: string;
+  programId?: string;
+  summary?: string;
+}
+
+export interface SvsCertifiedActionPayload {
+  requestId?: string | null;
+  idempotencyKey?: string | null;
+  intent: SvsActionIntent | JsonObject;
+  policyId: string;
+  serializedTransaction: string;
+  rpcUrl?: string | null;
+  simulation?: JsonValue;
+  metadata?: JsonValue;
+  source?: JsonObject;
+}
+
+export interface SvsSubmitActionOptions {
+  idempotencyKey?: string | null;
+  requestSigningSecret?: string | null;
+  requestTimestamp?: string | null;
+  requestNonce?: string | null;
+  retry?: SvsRequestOptions["retry"];
+}
+
+export interface SvsBotReadinessOptions {
+  botId?: string | null;
+  runSelfTest?: boolean;
+  pendingProofMaxAgeMs?: number;
+  requireNoExpiredPreviousSigningSecrets?: boolean;
+  requestSigningSecret?: string | null;
+  requestTimestamp?: string | null;
+  requestNonce?: string | null;
+}
+
+export interface SvsProductionCertificationOptions {
+  botId: string;
+  staleAfterMs?: number;
+  requireCurrentIntegrationContract?: boolean;
+  expectedIntegrationContractHash?: string | null;
+}
+
+export interface SvsCertifiedActionSubmitOptions {
+  botId?: string | null;
+  certificationStaleAfterMs?: number;
+  requireCurrentIntegrationContract?: boolean;
+  idempotencyKey?: string | null;
+  requestSigningSecret?: string | null;
+  requestTimestamp?: string | null;
+  requestNonce?: string | null;
+}
+
+export interface SvsCertifiedActionProofWaitOptions extends SvsCertifiedActionSubmitOptions {
+  waitAttempts?: number;
+  waitIntervalMs?: number;
+  fetchProof?: boolean;
+  checkReceiptRegistryChain?: boolean;
+}
+
+export interface SvsActionProductionProofOptions {
+  checkReceiptRegistryChain?: boolean;
+  signRequest?: boolean;
+  requestSigningSecret?: string | null;
+  requestTimestamp?: string | null;
+}
+
+export interface SvsProductionProofWaitOptions {
+  attempts?: number;
+  intervalMs?: number;
+  fetchProof?: boolean;
+  checkReceiptRegistryChain?: boolean;
+}
+
+export interface SvsClientLike {
+  checkBotReadiness(options?: SvsBotReadinessOptions): Promise<SvsBotReadinessResult>;
+  requireProductionCertification(options: SvsProductionCertificationOptions): Promise<SvsProductionCertificationCheck>;
+  submitCertifiedAction(payload: SvsCertifiedActionPayload, options?: SvsCertifiedActionSubmitOptions): Promise<SvsCertifiedActionSubmission>;
+  submitCertifiedActionAndWaitForProof(payload: SvsCertifiedActionPayload, options?: SvsCertifiedActionProofWaitOptions): Promise<SvsCertifiedActionProductionProofWait>;
+}
+
+export interface SvsClientOptions {
+  baseUrl?: string;
+  apiKey?: string | null;
+  requestSigningSecret?: string | null;
+  expectedIntegrationContractHash?: string | null;
+  timestampProvider?: () => string;
+  fetchImpl?: typeof fetch;
+  retry?: Partial<SvsRetryOptions> | false | null;
+  sleep?: (ms: number) => Promise<void>;
+}
+
+export interface SvsRetryOptions {
+  maxRetries: number;
+  baseDelayMs: number;
+  maxDelayMs: number;
+  retryableStatuses: number[];
+}
+
+export interface SvsRequestOptions {
+  method?: string;
+  body?: unknown;
+  headers?: Record<string, string>;
+  requestSigningSecret?: string | null;
+  requestTimestamp?: string | null;
+  signRequest?: boolean;
+  retry?: Partial<SvsRetryOptions> | false | null;
+  retrySafe?: boolean;
+}
+
+export interface SvsSignedBotRequest {
+  body: string;
+  headers: Record<string, string>;
+}
+
+export interface SvsSignedBotRequestOptions {
+  body?: unknown;
+  requestSigningSecret: string;
+  timestamp?: string;
+  headers?: Record<string, string>;
+}
+
+export interface SvsBotRequestSignatureOptions {
+  body?: unknown;
+  timestamp: string;
+  secret: string;
+}
+
+export interface SvsBotRequestSignatureVerificationOptions {
+  body?: unknown;
+  timestamp?: string | null;
+  signature?: string | null;
+  secret?: string | null;
+  now?: Date;
+  maxAgeMs?: number;
+}
+
+export interface SvsWebhookSignatureOptions {
+  body: unknown;
+  webhookSecret: string;
+  timestamp: string;
+}
+
+export interface SvsWebhookSignatureHeadersOptions {
+  body: unknown;
+  webhookSecret?: string | null;
+  timestamp?: string;
+}
+
+export interface SvsWebhookSignatureVerificationOptions {
+  body: unknown;
+  webhookSecret?: string | null;
+  timestamp?: string | null;
+  signature?: string | null;
+  toleranceMs?: number | null;
+  now?: Date;
+}
+
+export interface SvsWebhookSignatureVerification {
+  ok: boolean;
+  reason: "valid" | "missing_signature_fields" | "invalid_timestamp" | "timestamp_outside_tolerance" | "signature_mismatch" | string;
+  scheme?: "hmac-sha256" | string;
+  signatureVersion?: string;
+  [key: string]: unknown;
+}
+
+export type SvsWebhookHeaders = Headers | Record<string, string | string[] | null | undefined>;
+
+export interface SvsWebhookRequestVerificationOptions {
+  body?: unknown;
+  headers?: SvsWebhookHeaders;
+  webhookSecret?: string | null;
+  seenEventIds?: {
+    has(eventId: string): boolean;
+    add(eventId: string): unknown;
+  } | null;
+  toleranceMs?: number | null;
+  now?: Date;
+}
+
+export interface SvsWebhookRequestReplayStoreOptions extends SvsWebhookRequestVerificationOptions {
+  replayStorePath?: string;
+  replayTtlMs?: number;
+  maxReplayEvents?: number;
+}
+
+export interface SvsWebhookRequestVerification {
+  ok: boolean;
+  reason: "valid" | "invalid_json" | "unsupported_event_version" | "event_type_header_mismatch" | "event_id_header_mismatch" | "payload_hash_header_mismatch" | "payload_hash_mismatch" | "replayed_event" | string;
+  event: JsonValue | null;
+  checks: {
+    eventVersion?: string;
+    payloadHash?: string;
+    expectedPayloadHash?: string;
+    signature?: SvsWebhookSignatureVerification;
+    [key: string]: unknown;
+  };
+  replayStore?: {
+    path: string;
+    eventCount: number;
+    [key: string]: unknown;
+  };
+  [key: string]: unknown;
+}
+
+export interface SvsBotIntegrationContract {
+  version: "svs.bot-integration-contract.v1" | string;
+  generatedAt?: string;
+  quickstart?: JsonObject;
+  endpoints?: JsonObject;
+  capabilities?: JsonValue;
+  [key: string]: JsonValue | undefined;
+}
+
+export interface SvsBotFirstActionRunbookStep {
+  version: "svs.bot-first-action-runbook-step.v1" | string;
+  order: number;
+  actor: "operator" | "bot" | "auditor" | string;
+  title: string;
+  command?: string | null;
+  dashboardAction?: string | null;
+  successSignal: string;
+  [key: string]: unknown;
+}
+
+export interface SvsBotFirstActionRunbook {
+  version: "svs.bot-first-action-runbook.v1" | string;
+  generatedAt: string;
+  objective: string;
+  audience: string[];
+  serverUrl: string;
+  envPath: string;
+  contract: {
+    version: string;
+    quickstartVersion: string;
+    hashAlgorithm: "sha256" | string;
+    hash: string | null;
+    source: string;
+  };
+  noSecretGuarantees: string[];
+  commandSet: Record<string, string | null>;
+  orderedSteps: SvsBotFirstActionRunbookStep[];
+  fallbackPath: {
+    when: string;
+    commands: string[];
+    operatorAction: string;
+  };
+  successDefinition: {
+    botSide: string;
+    operatorSide: string;
+    auditorSide: string;
+  };
+  nextAction: SvsNextAction;
+  runbookHashAlgorithm: "sha256" | string;
+  runbookHash: string;
+  [key: string]: unknown;
+}
+
+export interface SvsClientCompatibilityReport {
+  version: "svs.bot-client-compatibility.v1";
+  ok: boolean;
+  status: "compatible" | "incompatible" | string;
+  client?: JsonObject;
+  contract?: JsonObject | null;
+  missingCapabilities?: string[];
+  checks?: SvsCheck[];
+  [key: string]: unknown;
+}
+
+export interface SvsBotSelfTestResult {
+  version: "svs.bot-self-test.v1" | string;
+  ok: boolean;
+  status: "passed" | "failed" | string;
+  botId?: string | null;
+  authenticatedBotId?: string | null;
+  requestNonce?: string | null;
+  requestSignatureVerified?: boolean;
+  requestSignatureSlot?: "primary" | "pending" | "previous" | string | null;
+  createdAt?: string | null;
+  error?: string | null;
+  [key: string]: unknown;
+}
+
+export interface SvsBotCredentialReadinessOptions {
+  pendingProofMaxAgeMs?: number;
+  requireSignedRequestProof?: boolean;
+  requireNoExpiredPreviousSigningSecrets?: boolean;
+}
+
+export interface SvsBotCredentialSignedRequestSummary {
+  recordId?: string | null;
+  createdAt?: string | null;
+  requestId?: string | null;
+  idempotencyKey?: string | null;
+  requestNonce?: string | null;
+  requestTimestamp?: string | null;
+  authenticatedBotId?: string | null;
+  secretSlot?: "primary" | "pending" | "previous" | string | null;
+  productionCertification?: JsonObject | null;
+  [key: string]: unknown;
+}
+
+export interface SvsBotCredentialCleanupEvidence {
+  version?: string;
+  status?: "current" | "cleanup_required" | string;
+  expiredPreviousSecretCount?: number;
+  lastCleanupAction?: JsonObject | null;
+  [key: string]: unknown;
+}
+
+export interface SvsBotCredentialLifecycleSummary {
+  eventCount?: number;
+  startRotationCount?: number;
+  blockedPromoteCount?: number;
+  successfulPromoteCount?: number;
+  persistedEvidenceCount?: number;
+  latestEventHash?: string | null;
+  latestEventAt?: string | null;
+  [key: string]: unknown;
+}
+
+export interface SvsBotCredentialReadinessBot {
+  botId: string;
+  name?: string | null;
+  status: string;
+  ignored: boolean;
+  productionReady: boolean;
+  readinessStatus: "production_ready" | "not_ready" | "ignored" | string;
+  credentialRotationStatus: "missing_secret" | "primary_confirmed" | "ready_to_promote" | "previous_grace_observed" | "expired_pending_secret" | string | null;
+  keyFingerprint?: string | null;
+  requireRequestSignature: boolean;
+  requireFreshRequestTimestamp?: boolean;
+  requestSigningSecretSlots: string[];
+  lastSuccessfulSignedRequest: SvsBotCredentialSignedRequestSummary | null;
+  lastSuccessfulSignedRequestAgeMs: number | null;
+  selfTest: JsonObject | null;
+  adoption: JsonObject | null;
+  pendingRequestSigningSecretConfigured: boolean;
+  pendingRequestSigningSecretExpiresAt: string | null;
+  pendingRequestSigningSecretExpired: boolean;
+  previousRequestSigningSecretConfigured: boolean;
+  previousRequestSigningSecretExpiresAt: string | null;
+  previousRequestSigningSecretExpired: boolean;
+  cleanupRequired: boolean;
+  stalePendingProof: boolean;
+  checks: SvsCheck[];
+  blockingReasons: Array<{
+    code: string;
+    message: string;
+  }>;
+  [key: string]: unknown;
+}
+
+export interface SvsBotCredentialReadiness {
+  version: "svs.bot-credential-readiness.v1";
+  generatedAt: string;
+  status: "production_ready" | "not_ready" | string;
+  productionReady: boolean;
+  evidenceHash: string | null;
+  readinessHash: string;
+  policy: {
+    pendingProofMaxAgeMs: number | null;
+    requireSignedRequestProof: boolean;
+    requireNoExpiredPreviousSigningSecrets: boolean;
+    [key: string]: unknown;
+  };
+  summary: {
+    botCount: number;
+    activeBotCount: number;
+    ignoredBotCount: number;
+    productionReadyCount: number;
+    notReadyCount: number;
+    cleanupRequiredCount: number;
+    readyToPromoteCount: number;
+    primaryConfirmedCount: number;
+    stalePendingProofCount: number;
+    selfTestObservedCount: number;
+    selfTestPassedCount: number;
+    adoptionAverageScore: number;
+    adoptionCompleteCount: number;
+    adoptionNeedsActionCount: number;
+    [key: string]: unknown;
+  };
+  credentialCleanup: SvsBotCredentialCleanupEvidence;
+  credentialLifecycle: SvsBotCredentialLifecycleSummary;
+  bots: SvsBotCredentialReadinessBot[];
+  [key: string]: unknown;
+}
+
+export interface SvsBotCredentialRotationMissingProof {
+  code: string;
+  message: string;
+  nextAction: SvsNextAction;
+  operatorSteps: string[];
+  [key: string]: unknown;
+}
+
+export interface SvsBotCredentialRotationReceipt {
+  version: "svs.bot-credential-rotation-receipt.v1";
+  generatedAt: string;
+  ok: boolean;
+  status: "ready_to_promote" | "missing_proof" | "not_ready" | "bot_not_found" | string;
+  readyToPromote: boolean;
+  botId: string | null;
+  authenticatedBot: {
+    id: string;
+    name: string;
+  } | null;
+  evidenceHash: string | null;
+  pendingProofMaxAgeMs: number | null;
+  credentialRotationStatus: string | null;
+  pendingRequestSigningSecretConfigured: boolean;
+  pendingRequestSigningSecretCreatedAt: string | null;
+  pendingRequestSigningSecretExpiresAt: string | null;
+  pendingRequestSigningSecretExpired: boolean;
+  lastSuccessfulSignedRequest: SvsBotCredentialSignedRequestSummary | null;
+  checks: SvsCheck[];
+  missingProof: SvsBotCredentialRotationMissingProof[];
+  nextAction: SvsNextAction;
+  links: {
+    rotationDryRun: string | null;
+    credentialReadiness: string | null;
+    [key: string]: unknown;
+  };
+  receiptHash: string;
+  [key: string]: unknown;
+}
+
+export interface SvsBotCredentialRotationReadinessCheck {
+  version: "svs.bot-credential-rotation-readiness-check.v1";
+  checkedAt: string;
+  ok: boolean;
+  status: "ready_to_promote" | "missing_proof" | "not_ready" | string;
+  botId: string | null;
+  readyToPromote: boolean;
+  receiptHash: string | null;
+  receipt: SvsBotCredentialRotationReceipt;
+  missingProof: SvsBotCredentialRotationMissingProof[];
+  nextAction: SvsNextAction;
+  operatorSteps: string[];
+  [key: string]: unknown;
+}
+
+export interface SvsBotIntegrationCertificationStatus {
+  version: "svs.bot-integration-certification-bot-status.v1";
+  ok: boolean;
+  status: "ready" | "missing" | "stale" | "drifted" | "not_ready" | string;
+  botId: string | null;
+  checkedAt: string;
+  authenticated?: boolean;
+  certification?: JsonObject | null;
+  contract?: JsonObject | null;
+  proofs?: JsonObject | null;
+  quality?: JsonObject | null;
+  qualityTarget?: JsonObject | null;
+  failedChecks?: SvsCheck[];
+  checks?: SvsCheck[];
+  nextAction?: SvsNextAction;
+  [key: string]: unknown;
+}
+
+export type SvsApprovalMessageDomain =
+  | "svs-solana-verification-system"
+  | "solana-human-verification-system";
+
+export type SvsApprovalDomainStatus =
+  | "current"
+  | "legacy_compatible"
+  | "unsupported"
+  | "missing";
+
+export interface SvsApprovalDomainSummary {
+  domain: SvsApprovalMessageDomain | string | null;
+  status: SvsApprovalDomainStatus;
+  current: boolean;
+  legacyCompatible: boolean;
+  supported: boolean;
+}
+
+export interface SvsApprovalSignatureLike {
+  domain?: SvsApprovalMessageDomain | string | null;
+  message?: string | null;
+  messageHash?: string | null;
+  signer?: string | null;
+  signature?: string | null;
+  version?: string | null;
+  scheme?: string | null;
+  [key: string]: unknown;
+}
+
+export interface SvsActionProductionProofStatus {
+  version: "svs.action-production-proof-status.v1";
+  ready: boolean;
+  status: "ready" | "not_ready" | string;
+  recordId: string | null;
+  botId: string | null;
+  authenticatedBotId?: string | null;
+  queueStatus?: string | null;
+  txType?: string | null;
+  receiptId: string | null;
+  receiptRegistry?: {
+    confirmationStatus: string | null;
+    signature: string | null;
+    receiptAccount: string | null;
+    [key: string]: unknown;
+  };
+  actionRecordVerification?: {
+    ok: boolean;
+    version: string | null;
+    receiptAccount: string | null;
+    registryTransactionSignature: string | null;
+    [key: string]: unknown;
+  };
+  nextAction: SvsNextAction | null;
+  checks: SvsCheck[];
+  missing?: string[];
+  links?: {
+    action: string | null;
+    productionProof: string | null;
+    productionProofStatus: string | null;
+    [key: string]: unknown;
+  };
+  [key: string]: unknown;
+}
+
+export interface SvsActionProductionProofResponse {
+  version: "svs.action-production-proof-response.v1";
+  ready: true;
+  status: "ready";
+  recordId: string;
+  botId: string | null;
+  proof: JsonObject;
+  proofHash: string | null;
+  export: {
+    version: string | null;
+    actionRecordVerificationHash: string | null;
+    receiptRegistrySubmissionHash: string | null;
+    [key: string]: unknown;
+  };
+  [key: string]: unknown;
+}
+
+export interface SvsActionProductionProofWaitResult {
+  status: SvsActionProductionProofStatus | null;
+  proof: SvsActionProductionProofResponse | null;
+}
+
+export interface SvsActionRecordResponse {
+  path: string;
+  record: JsonObject;
+  links: {
+    receipt: string;
+    approvalMessage: string;
+    [key: string]: unknown;
+  };
+  [key: string]: unknown;
+}
+
+export interface SvsReceiptExport {
+  version?: string;
+  receiptId?: string;
+  issuedAt?: string;
+  botId?: string;
+  controllerWallet?: string;
+  policyId?: string;
+  policyHash?: string;
+  authorizationType?: string;
+  allowed?: boolean;
+  riskScore?: number;
+  riskFindings?: JsonValue;
+  simulationHash?: string;
+  intentHash?: string;
+  transactionSignature?: string | null;
+  receiptHash?: string;
+  [key: string]: JsonValue | undefined;
+}
+
+export interface SvsReceiptVerificationResult {
+  version?: string;
+  ok: boolean;
+  status?: string;
+  receiptHash?: string | null;
+  computedReceiptHash?: string | null;
+  failedCheckCount?: number;
+  failedChecks?: SvsCheck[];
+  checks?: SvsCheck[];
+  [key: string]: unknown;
+}
+
+export interface SvsActionProductionProofEvidence {
+  version: "svs.action-production-proof-evidence.v1";
+  generatedAt: string;
+  source: {
+    recordPath: string | null;
+    statusVersion: string | null;
+  };
+  productionProof: {
+    ready: boolean;
+    status: string | null;
+    recordId: string | null;
+    botId: string | null;
+    receiptId: string | null;
+    nextAction: SvsNextAction | null;
+    checks: SvsCheck[];
+  };
+  request: {
+    authenticatedBotId: string | null;
+    requestSignatureVerified: boolean;
+    requestSignatureSlot: "primary" | "pending" | "previous" | string | null;
+    requestSignatureVersion: string | null;
+    requestNonce: string | null;
+    requestId: string | null;
+    idempotencyKey: string | null;
+    requestTimestamp: string | null;
+  };
+  humanApproval: {
+    approved: boolean;
+    reviewer: string | null;
+    signer: string | null;
+    verified: boolean;
+    messageHash: string | null;
+    domain: SvsApprovalMessageDomain | string | null;
+    domainStatus: SvsApprovalDomainStatus;
+    currentDomain: boolean;
+    legacyDomainCompatible: boolean;
+  };
+  broadcast: {
+    confirmed: boolean;
+    signature: string | null;
+    confirmationStatus: "confirmed" | "finalized" | string | null;
+    slot: number | null;
+    rpcUrl: string | null;
+  };
+  receiptRegistry: {
+    confirmed: boolean;
+    signature: string | null;
+    confirmationStatus: "confirmed" | "finalized" | string | null;
+    slot: number | null;
+    programId: string | null;
+    receiptAccount: string | null;
+    planHash: string | null;
+    transactionPlanHash: string | null;
+  };
+  actionRecordVerification: {
+    ok: boolean;
+    version: string | null;
+    checkedAt: string | null;
+    receiptId: string | null;
+    receiptAccount: string | null;
+    registryTransactionSignature: string | null;
+    failedCheckCount: number | null;
+  };
+  productionProofWebhook?: JsonObject;
+  policy: {
+    controllerWallet: string | null;
+    policyHash: string | null;
+    intentHash: string | null;
+    simulationHash: string | null;
+  };
+  reportSafety: {
+    secretsIncluded: boolean;
+    redactedFields: string[];
+  };
+  evidenceHash: string;
+}
+
+export interface SvsActionProductionProofEvidenceVerification {
+  version: "svs.action-production-proof-evidence-verification.v1";
+  ok: boolean;
+  status: "verified" | "stale" | "failed" | string;
+  checkedAt: string;
+  found: boolean;
+  generatedAt: string | null;
+  stale: boolean;
+  ageMs: number | null;
+  staleAfterMs: number | null;
+  evidenceHash: string | null;
+  computedEvidenceHash: string | null;
+  recordId: string | null;
+  failedCheckCount: number;
+  failedChecks: SvsCheck[];
+  checks: SvsCheck[];
+  [key: string]: unknown;
+}
+
+export interface SvsCurrentApprovalDomainRequirementResult {
+  version: "svs.current-approval-domain-requirement.v1";
+  ok: true;
+  status: "current";
+  domain: "svs-solana-verification-system";
+  expectedDomain: "svs-solana-verification-system";
+  action: string | null;
+  nextAction: SvsNextAction;
+}
+
+export interface SvsBotReadinessResult {
+  version: "svs.bot-readiness-check.v1";
+  checkedAt: string;
+  ok: boolean;
+  status: "ready" | "not_ready" | string;
+  botId: string | null;
+  selfTest: JsonObject | null;
+  readiness: {
+    version: string | null;
+    productionReady: boolean;
+    activeBotCount: number | null;
+    adoptionAverageScore: number | null;
+    adoptionNeedsActionCount: number | null;
+  };
+  bot: JsonObject | null;
+  adoption: JsonObject | null;
+  nextAction: SvsNextAction;
+}
+
+export interface SvsProductionCertificationCheck {
+  version: "svs.bot-production-certification-check.v1";
+  checkedAt: string;
+  ok: boolean;
+  status: "ready" | "not_ready" | string;
+  botId: string | null;
+  certification: JsonObject;
+  integrationContract: SvsProductionCertificationContractBinding;
+  quality?: JsonValue;
+  qualityTarget?: JsonValue;
+  nextAction: SvsNextAction;
+}
+
+export interface SvsProductionCertificationContractBinding {
+  version: "svs.production-certification-contract-binding.v1";
+  required: boolean;
+  ok: boolean;
+  status: "current" | "not_required" | "client_contract_mismatch" | "drifted" | "mismatch" | "unavailable" | string;
+  localContractHash: string | null;
+  dashboardContractHash?: string | null;
+  certifiedContractHash: string | null;
+  currentContractHash: string | null;
+  drifted: boolean;
+  contractVersion?: string | null;
+  error?: string;
+  nextActionMessage: string;
+}
+
+export interface SvsCertifiedSubmitOperatorStatus {
+  version: "svs.certified-submit-operator-status.v1";
+  ok: boolean;
+  status: "ready" | "production_ready" | "missing" | "failed" | string;
+  serverUrl: string | null;
+  staleAfterMs: number | null;
+  endpoints: {
+    status: string;
+    evidence: string;
+    [key: string]: unknown;
+  };
+  production: JsonObject | null;
+  candidate: JsonObject | null;
+  nextAction: SvsNextAction;
+  [key: string]: unknown;
+}
+
+export interface SvsCertifiedActionSubmission {
+  version: "svs.certified-action-submission.v1";
+  ok: boolean;
+  status: "submitted" | string;
+  botId: string | null;
+  certification: SvsProductionCertificationCheck;
+  submitted: JsonObject;
+}
+
+export interface SvsCertifiedActionProductionProofWait {
+  version: "svs.certified-action-production-proof-wait.v1";
+  ok: boolean;
+  status: "production_proof_ready" | "production_proof_not_ready" | "submitted_record_missing" | string;
+  botId: string | null;
+  recordId: string | null;
+  submission: SvsCertifiedActionSubmission;
+  productionProof: JsonObject | null;
+  nextAction: SvsNextAction;
+}
+
+export interface SvsAdapterReadinessResult {
+  version: string;
+  ok: true;
+  status: "ready";
+  botId: string;
+  readiness: SvsBotReadinessResult;
+  certification: SvsProductionCertificationCheck;
+  nextAction: SvsNextAction;
+}
+
+export interface SvsAdapterActionResult {
+  version: string;
+  ok: boolean;
+  status: string;
+  botId: string;
+  requestId: string | null;
+  idempotencyKey: string | null;
+  policyId: string;
+  adapter: string;
+  readiness: SvsAdapterReadinessResult | null;
+  result: SvsCertifiedActionSubmission | SvsCertifiedActionProductionProofWait | JsonObject;
+  recordId: string | null;
+  productionProofReady: boolean;
+  nextAction: SvsNextAction;
+}
+
+export interface SvsAdapterOptions {
+  client?: SvsClientLike | unknown;
+  baseUrl?: string;
+  apiKey?: string;
+  requestSigningSecret?: string;
+  expectedIntegrationContractHash?: string;
+  botId: string;
+  policyId?: string | null;
+  rpcUrl?: string | null;
+  certificationStaleAfterMs?: number;
+  requireCurrentIntegrationContract?: boolean;
+  waitForProof?: boolean;
+  waitAttempts?: number;
+  waitIntervalMs?: number;
+  fetchProof?: boolean;
+  checkReceiptRegistryChain?: boolean;
+  requireReadinessOnSubmit?: boolean;
+}
+
+export interface SvsAdapterActionInput extends Partial<SvsCertifiedActionPayload> {
+  intent: SvsActionIntent | JsonObject;
+  serializedTransaction: string;
+  waitForProof?: boolean;
+  waitAttempts?: number;
+  waitIntervalMs?: number;
+  fetchProof?: boolean;
+  checkReceiptRegistryChain?: boolean;
+  requireReadinessOnSubmit?: boolean;
+}
+
+export interface SvsVerifiedAgentProfile {
+  version: "svs.verified-agent-profile.v1";
+  generatedAt: string;
+  agent: {
+    botId: string;
+    name: string | null;
+    url: string | null;
+    profileUrl: string | null;
+    badgeUrl: string | null;
+  };
+  status: {
+    ok: boolean;
+    value: "verified" | "stale" | "not_verified" | string;
+    label: string;
+    nextAction: SvsNextAction | null;
+  };
+  certification: JsonObject;
+  qualityTarget: JsonObject | null;
+  proofs: JsonObject;
+  display: JsonObject;
+  reportSafety: JsonObject;
+  profileHash: string;
+}
+
+export interface SvsVerifiedAgentProfileOptions {
+  certificationEvidence: JsonObject;
+  agentName?: string | null;
+  agentUrl?: string | null;
+  profileUrl?: string | null;
+  badgeUrl?: string | null;
+  generatedAt?: string | Date;
+  staleAfterMs?: number | null;
+  now?: Date | string;
+}
+
+export interface SvsVerifiedAgentProfileVerificationOptions {
+  expectedBotId?: string | null;
+  requireVerified?: boolean;
+  staleAfterMs?: number | null;
+  now?: Date | string;
+}
+
+export interface SvsVerifiedAgentProfileVerification {
+  version: "svs.verified-agent-profile-verification.v1";
+  ok: boolean;
+  status: "verified" | "stale" | "failed" | string;
+  checkedAt: string;
+  botId: string | null;
+  profileHash: string | null;
+  computedProfileHash: string | null;
+  failedCheckCount: number;
+  failedChecks: SvsCheck[];
+  checks: SvsCheck[];
+  [key: string]: unknown;
+}
+
+export interface SvsVerifiedAgentTrustScoreSignal {
+  id: string;
+  label: string;
+  weight: number;
+  earned: number;
+  required: boolean;
+  ok: boolean;
+  detail: string;
+  evidence: JsonObject;
+}
+
+export interface SvsVerifiedAgentTrustScoreSignalDefinition {
+  id: string;
+  label: string;
+  weight: number;
+  required: boolean;
+}
+
+export interface SvsVerifiedAgentTrustScorePolicy {
+  version: "svs.verified-agent-trust-score-policy.v1";
+  scoreVersion: "svs.verified-agent-trust-score.v1";
+  maxScore: 100;
+  highTrustMinimumScore: number;
+  highTrustRequiresEvidenceComplete: boolean;
+  requiredSignalIds: string[];
+  optionalSignalIds: string[];
+  signals: SvsVerifiedAgentTrustScoreSignalDefinition[];
+}
+
+export interface SvsVerifiedAgentTrustScoreOptions {
+  profile?: SvsVerifiedAgentProfile | JsonObject | null;
+  profileVerification?: SvsVerifiedAgentProfileVerification | JsonObject | null;
+  registryVerification?: SvsVerifiedAgentRegistryVerification | JsonObject | null;
+  actionProductionProofEvidence?: SvsActionProductionProofEvidence | JsonObject | null;
+  actionProductionProofVerification?: SvsActionProductionProofEvidenceVerification | JsonObject | null;
+  credentialReadiness?: SvsBotCredentialReadiness | JsonObject | null;
+  hostValidation?: JsonObject | null;
+  generatedAt?: Date | string;
+}
+
+export interface SvsVerifiedAgentTrustScore {
+  version: "svs.verified-agent-trust-score.v1";
+  generatedAt: string;
+  status: "high_trust" | "needs_review" | "low_trust" | string;
+  score: number;
+  maxScore: 100;
+  evidenceComplete: boolean;
+  botId: string | null;
+  recordId: string | null;
+  profileHash: string | null;
+  registryHash: string | null;
+  signalCount: number;
+  passedSignalCount: number;
+  failedSignalCount: number;
+  blockingSignalCount: number;
+  signals: SvsVerifiedAgentTrustScoreSignal[];
+  nextAction: SvsNextAction;
+  trustScoreHash: string;
+  computedTrustScoreHash?: string | null;
+}
+
+export interface SvsVerifiedAgentRegistryAgent {
+  botId: string;
+  name: string;
+  status: string;
+  profileHash: string;
+  certificationHash: string | null;
+  recordId: string | null;
+  profilePath: string;
+  badgePath: string;
+  pagePath: string;
+  proofs?: JsonObject;
+  trustScore?: SvsVerifiedAgentTrustScore | JsonObject | null;
+  qualityTarget?: JsonObject | null;
+  verification?: JsonObject;
+}
+
+export interface SvsVerifiedAgentRegistry {
+  version: "svs.verified-agent-registry.v1";
+  generatedAt: string;
+  title: string;
+  profileCount: number;
+  agents: SvsVerifiedAgentRegistryAgent[];
+  registryHash: string;
+}
+
+export interface SvsVerifiedAgentRegistryTrustManifest {
+  version: "svs.verified-agent-registry-trust-manifest.v1";
+  title: string;
+  generatedAt: string;
+  registry: {
+    version: string | null;
+    title: string;
+    profileCount: number | null;
+    registryHash: string | null;
+    registryPath: string;
+    indexPath: string;
+  };
+  hostedPaths: {
+    registryJson: string;
+    trustManifestJson: string;
+    registryIndex: string;
+  };
+  verifierInstructions: {
+    cli: string;
+    localCli: string;
+    sdkImport: string;
+    sdkCall: string;
+    requiredChecks: string[];
+  };
+  trustScorePolicy?: SvsVerifiedAgentTrustScorePolicy | JsonObject | null;
+  trustStates: JsonObject;
+  agents: JsonObject[];
+  reportSafety: JsonObject;
+  trustManifestHash: string;
+}
+
+export interface SvsVerifiedAgentRegistryVerification {
+  version: "svs.verified-agent-registry-verification.v1" | "svs.verified-agent-registry-consumer-verification.v1";
+  ok: boolean;
+  status: "verified" | "failed" | "stale" | string;
+  registryHash?: string | null;
+  computedRegistryHash?: string | null;
+  expectedRegistryHash?: string | null;
+  profileCount?: number;
+  verifiedAgentCount?: number;
+  failedCheckCount: number;
+  failedChecks: SvsCheck[];
+  checks: SvsCheck[];
+  agents?: JsonObject[];
+  trustManifest?: JsonObject;
+  [key: string]: unknown;
+}
+
+export interface SvsVerifiedAgentRegistryBuildOptions {
+  profiles: Array<JsonObject | SvsVerifiedAgentProfile | string>;
+  outputDir?: string;
+  title?: string;
+  generatedAt?: Date | string;
+  staleAfterMs?: number | null;
+  requireVerified?: boolean;
+  now?: Date | string;
+}
+
+export interface SvsVerifiedAgentRegistryVerificationOptions {
+  registry?: SvsVerifiedAgentRegistry | null;
+  registryPath?: string | null;
+  baseDir?: string | null;
+  requireVerified?: boolean;
+  staleAfterMs?: number | null;
+  now?: Date | string;
+}
+
+export interface SvsVerifiedAgentRegistryUrlVerificationOptions extends SvsVerifiedAgentRegistryVerificationOptions {
+  registryUrl?: string;
+  trustManifestUrl?: string | null;
+  expectedRegistryHash?: string | null;
+  fetchImpl?: typeof fetch;
+}
+
+export interface SvsVerifiedAgentAdoptionKitOptions {
+  profile: SvsVerifiedAgentProfile;
+  registry: SvsVerifiedAgentRegistry;
+  registryUrl?: string | null;
+  expectedRegistryHash?: string | null;
+  trustManifestUrl?: string | null;
+  registryIndexUrl?: string | null;
+  profileUrl?: string | null;
+  badgeUrl?: string | null;
+  previewReadiness?: JsonObject | null;
+  consumerEvidence?: JsonObject | null;
+  protocolId?: string;
+  generatedAt?: Date | string;
+}
+
+export interface SvsVerifiedAgentAdoptionKit {
+  version: "svs.verified-agent-adoption-kit.v1";
+  ok: boolean;
+  status: "ready" | "failed" | string;
+  generatedAt: string;
+  bot: JsonObject;
+  registry: JsonObject;
+  urls: JsonObject;
+  copy: {
+    protocolEnv: string;
+    sdkSnippet: string;
+    verificationCommands: JsonObject;
+    adoptionChecklist: string[];
+  };
+  proofs: JsonObject;
+  reportSafety: JsonObject;
+  checkCount: number;
+  passedCheckCount: number;
+  failedCheckCount: number;
+  checks: SvsCheck[];
+  failedChecks: SvsCheck[];
+  nextAction: SvsNextAction;
+  adoptionKitHash: string;
+}
+
+export interface SvsVerifiedAgentAdoptionKitPersistOptions extends SvsVerifiedAgentAdoptionKitOptions {
+  outputDir?: string;
+}
+
+export interface SvsProtocolVerifiedAgentResult {
+  version: "svs.verified-agent-requirement.v1";
+  ok: true;
+  status: "verified";
+  minCertification: string;
+  botId: string;
+  agentWallet: string | null;
+  action: string | null;
+  certificationHash: string | null;
+  recordId: string | null;
+  qualityTarget: JsonValue;
+  integrationContract: JsonValue;
+  proofs: JsonValue;
+  nextAction: SvsNextAction;
+}