@svsprotocol/solana 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,330 @@
+import type {
+  JsonObject,
+  JsonValue,
+  SvsActionProductionProofResponse,
+  SvsActionProductionProofWaitResult,
+  SvsActionRecordResponse,
+  SvsBotCredentialReadiness,
+  SvsBotCredentialReadinessOptions,
+  SvsBotCredentialRotationReadinessCheck,
+  SvsBotCredentialRotationReceipt,
+  SvsBotFirstActionRunbook,
+  SvsBotFirstActionRunbookStep,
+  SvsBotIntegrationCertificationStatus,
+  SvsBotIntegrationContract,
+  SvsBotRequestSignatureOptions,
+  SvsBotRequestSignatureVerificationOptions,
+  SvsBotReadinessResult,
+  SvsBotReadinessOptions,
+  SvsCertifiedActionProofWaitOptions,
+  SvsCertifiedActionPayload,
+  SvsCertifiedActionProductionProofWait,
+  SvsCertifiedActionSubmitOptions,
+  SvsCertifiedActionSubmission,
+  SvsCertifiedSubmitOperatorStatus,
+  SvsCheck,
+  SvsClientLike,
+  SvsClientCompatibilityReport,
+  SvsClientOptions,
+  SvsCurrentApprovalDomainRequirementResult,
+  SvsProductionCertificationOptions,
+  SvsProductionCertificationCheck,
+  SvsProductionProofWaitOptions,
+  SvsReceiptExport,
+  SvsReceiptVerificationResult,
+  SvsActionProductionProofOptions,
+  SvsRequestOptions,
+  SvsSubmitActionOptions,
+  SvsSignedBotRequest,
+  SvsSignedBotRequestOptions,
+  SvsBotSelfTestResult,
+  SvsVerifiedAgentProfile,
+  SvsVerifiedAgentProfileOptions,
+  SvsVerifiedAgentProfileVerificationOptions,
+  SvsVerifiedAgentProfileVerification,
+  SvsVerifiedAgentTrustScore,
+  SvsVerifiedAgentTrustScoreOptions,
+  SvsVerifiedAgentTrustScorePolicy,
+  SvsVerifiedAgentTrustScoreSignalDefinition,
+  SvsVerifiedAgentRegistry,
+  SvsVerifiedAgentAdoptionKit,
+  SvsVerifiedAgentAdoptionKitOptions,
+  SvsVerifiedAgentAdoptionKitPersistOptions,
+  SvsVerifiedAgentRegistryBuildOptions,
+  SvsVerifiedAgentRegistryTrustManifest,
+  SvsVerifiedAgentRegistryUrlVerificationOptions,
+  SvsVerifiedAgentRegistryVerificationOptions,
+  SvsVerifiedAgentRegistryVerification,
+  SvsActionProductionProofEvidenceVerification,
+  SvsActionProductionProofStatus,
+  SvsApprovalDomainSummary,
+  SvsApprovalSignatureLike,
+  SvsWebhookRequestReplayStoreOptions,
+  SvsWebhookRequestVerification,
+  SvsWebhookRequestVerificationOptions,
+  SvsWebhookSignatureHeadersOptions,
+  SvsWebhookSignatureOptions,
+  SvsWebhookSignatureVerification,
+  SvsWebhookSignatureVerificationOptions
+} from "./common.js";
+import type {
+  SvsAgentFrameworkAdapterCatalogEntry
+} from "./adapter-catalog.js";
+
+export type {
+  JsonObject,
+  JsonValue,
+  SvsActionIntent,
+  SvsAdapterActionInput,
+  SvsAdapterActionResult,
+  SvsAdapterOptions,
+  SvsAdapterReadinessResult,
+  SvsActionProductionProofEvidence,
+  SvsActionProductionProofEvidenceVerification,
+  SvsActionProductionProofOptions,
+  SvsActionProductionProofResponse,
+  SvsActionProductionProofStatus,
+  SvsActionProductionProofWaitResult,
+  SvsActionRecordResponse,
+  SvsApprovalDomainStatus,
+  SvsApprovalDomainSummary,
+  SvsApprovalMessageDomain,
+  SvsApprovalSignatureLike,
+  SvsBotCredentialCleanupEvidence,
+  SvsBotCredentialLifecycleSummary,
+  SvsBotCredentialReadiness,
+  SvsBotCredentialReadinessBot,
+  SvsBotCredentialReadinessOptions,
+  SvsBotCredentialRotationMissingProof,
+  SvsBotCredentialRotationReadinessCheck,
+  SvsBotCredentialRotationReceipt,
+  SvsBotCredentialSignedRequestSummary,
+  SvsBotFirstActionRunbook,
+  SvsBotFirstActionRunbookStep,
+  SvsBotIntegrationCertificationStatus,
+  SvsBotIntegrationContract,
+  SvsBotRequestSignatureOptions,
+  SvsBotRequestSignatureVerificationOptions,
+  SvsBotReadinessResult,
+  SvsBotReadinessOptions,
+  SvsBotSelfTestResult,
+  SvsCertifiedActionProofWaitOptions,
+  SvsCertifiedActionPayload,
+  SvsCertifiedActionProductionProofWait,
+  SvsCertifiedActionSubmitOptions,
+  SvsCertifiedActionSubmission,
+  SvsCertifiedSubmitOperatorStatus,
+  SvsCheck,
+  SvsClientLike,
+  SvsClientCompatibilityReport,
+  SvsClientOptions,
+  SvsCurrentApprovalDomainRequirementResult,
+  SvsNextAction,
+  SvsProductionCertificationOptions,
+  SvsProductionCertificationCheck,
+  SvsProductionCertificationContractBinding,
+  SvsProductionProofWaitOptions,
+  SvsProtocolVerifiedAgentResult,
+  SvsReceiptExport,
+  SvsReceiptVerificationResult,
+  SvsRequestOptions,
+  SvsRetryOptions,
+  SvsSubmitActionOptions,
+  SvsSignedBotRequest,
+  SvsSignedBotRequestOptions,
+  SvsVerifiedAgentProfile,
+  SvsVerifiedAgentProfileOptions,
+  SvsVerifiedAgentProfileVerificationOptions,
+  SvsVerifiedAgentProfileVerification,
+  SvsVerifiedAgentTrustScore,
+  SvsVerifiedAgentTrustScoreOptions,
+  SvsVerifiedAgentTrustScorePolicy,
+  SvsVerifiedAgentTrustScoreSignal,
+  SvsVerifiedAgentTrustScoreSignalDefinition,
+  SvsVerifiedAgentRegistry,
+  SvsVerifiedAgentAdoptionKit,
+  SvsVerifiedAgentAdoptionKitOptions,
+  SvsVerifiedAgentAdoptionKitPersistOptions,
+  SvsVerifiedAgentRegistryAgent,
+  SvsVerifiedAgentRegistryBuildOptions,
+  SvsVerifiedAgentRegistryTrustManifest,
+  SvsVerifiedAgentRegistryUrlVerificationOptions,
+  SvsVerifiedAgentRegistryVerificationOptions,
+  SvsVerifiedAgentRegistryVerification,
+  SvsWebhookHeaders,
+  SvsWebhookRequestReplayStoreOptions,
+  SvsWebhookRequestVerification,
+  SvsWebhookRequestVerificationOptions,
+  SvsWebhookSignatureHeadersOptions,
+  SvsWebhookSignatureOptions,
+  SvsWebhookSignatureVerification,
+  SvsWebhookSignatureVerificationOptions
+} from "./common.js";
+export type {
+  SvsAgentFrameworkAdapterCatalogEntry
+} from "./adapter-catalog.js";
+
+export const BOT_CLIENT_COMPATIBILITY_VERSION: "svs.bot-client-compatibility.v1";
+export const BOT_CLIENT_RETRY_SAFETY_VERSION: "svs.bot-client-retry-safety.v1";
+export const SOLANA_VERIFICATION_CLIENT_NAME: "SolanaVerificationClient";
+export const SOLANA_VERIFICATION_CLIENT_VERSION: "svs-js-client.v1";
+export const SOLANA_VERIFICATION_CLIENT_CAPABILITIES: readonly string[];
+export const BOT_INTEGRATION_CONTRACT_VERSION: "svs.bot-integration-contract.v1";
+export const BOT_INTEGRATION_QUICKSTART_VERSION: "svs.bot-integration-quickstart.v1";
+export function hashBotIntegrationContract(contract: unknown): string | null;
+export function normalizeBotIntegrationContractForHash<T = unknown>(value: T): T;
+export const BOT_FIRST_ACTION_RUNBOOK_VERSION: "svs.bot-first-action-runbook.v1";
+export const BOT_FIRST_ACTION_STEP_VERSION: "svs.bot-first-action-runbook-step.v1";
+export function createBotFirstActionRunbook(contract: SvsBotIntegrationContract | JsonObject, options?: {
+  serverUrl?: string | null;
+  envPath?: string | null;
+  generatedAt?: string;
+}): SvsBotFirstActionRunbook;
+export function renderBotFirstActionRunbookText(runbook: SvsBotFirstActionRunbook): string;
+
+export const SVS_ADAPTER_CATALOG_VERSION: "svs.agent-framework-adapter-catalog.v1";
+export const SVS_AGENT_FRAMEWORK_ADAPTERS: readonly Readonly<SvsAgentFrameworkAdapterCatalogEntry>[];
+export function getSvsAgentFrameworkAdapters(options?: {
+  includeCustom?: boolean;
+  primaryOnly?: boolean;
+}): SvsAgentFrameworkAdapterCatalogEntry[];
+export function findSvsAgentFrameworkAdapter(identifier: string | null | undefined): SvsAgentFrameworkAdapterCatalogEntry | null;
+
+export function createSignedBotRequest(options?: SvsSignedBotRequestOptions): SvsSignedBotRequest;
+
+export function createSolanaVerificationClientCompatibilityReport(options?: { contract?: SvsBotIntegrationContract | JsonObject | null }): SvsClientCompatibilityReport;
+export function createSolanaVerificationClientRetrySafetyProof(options?: { retry?: unknown }): JsonObject;
+export function productionCertificationIsReady(certification: unknown): boolean;
+
+export class SolanaVerificationRequestError extends Error {
+  status: number | null;
+  body: unknown;
+  constructor(message: string, details?: { status?: number | null; body?: unknown });
+}
+
+export class SolanaVerificationProductionCertificationError extends Error {
+  details: unknown;
+  constructor(message: string, details?: unknown);
+}
+
+export class SolanaVerificationClient {
+  constructor(options?: SvsClientOptions);
+  baseUrl: string;
+  apiKey: string | null;
+  requestSigningSecret: string | null;
+  expectedIntegrationContractHash: string | null;
+  submitAction(payload: JsonObject, options?: SvsSubmitActionOptions): Promise<JsonObject>;
+  getRetrySafetyProof(): JsonObject;
+  getIntegrationContract(): Promise<SvsBotIntegrationContract>;
+  checkClientCompatibility(options?: { contract?: SvsBotIntegrationContract | JsonObject | null }): Promise<SvsClientCompatibilityReport>;
+  getCredentialReadiness(options?: SvsBotCredentialReadinessOptions): Promise<SvsBotCredentialReadiness>;
+  getCredentialRotationReceipt(options?: { botId: string; pendingProofMaxAgeMs?: number }): Promise<SvsBotCredentialRotationReceipt>;
+  checkCredentialRotationReadiness(options?: { botId: string; pendingProofMaxAgeMs?: number }): Promise<SvsBotCredentialRotationReadinessCheck>;
+  getIntegrationCertificationStatus(options?: { botId: string; staleAfterMs?: number }): Promise<SvsBotIntegrationCertificationStatus>;
+  selfTest(options?: {
+    botId?: string | null;
+    requestNonce?: string | null;
+    requestSigningSecret?: string | null;
+    requestTimestamp?: string | null;
+  }): Promise<SvsBotSelfTestResult>;
+  checkBotReadiness(options?: SvsBotReadinessOptions): Promise<SvsBotReadinessResult>;
+  checkProductionCertification(options?: SvsProductionCertificationOptions): Promise<SvsProductionCertificationCheck>;
+  requireProductionCertification(options?: SvsProductionCertificationOptions): Promise<SvsProductionCertificationCheck>;
+  submitCertifiedAction(payload: SvsCertifiedActionPayload, options?: SvsCertifiedActionSubmitOptions): Promise<SvsCertifiedActionSubmission>;
+  getCertifiedSubmitStatus(options?: { staleAfterMs?: number }): Promise<SvsCertifiedSubmitOperatorStatus>;
+  submitCertifiedActionAndWaitForProof(payload: SvsCertifiedActionPayload, options?: SvsCertifiedActionProofWaitOptions): Promise<SvsCertifiedActionProductionProofWait>;
+  getAction(id: string): Promise<SvsActionRecordResponse>;
+  getActionProductionProofStatus(id: string, options?: {
+    signRequest?: boolean;
+    requestSigningSecret?: string | null;
+    requestTimestamp?: string | null;
+  }): Promise<SvsActionProductionProofStatus>;
+  getActionProductionProof(id: string, options?: SvsActionProductionProofOptions): Promise<SvsActionProductionProofResponse>;
+  waitForActionProductionProof(id: string, options?: SvsProductionProofWaitOptions & { fetchProof?: false }): Promise<SvsActionProductionProofStatus | null>;
+  waitForActionProductionProof(id: string, options: SvsProductionProofWaitOptions & { fetchProof: true }): Promise<SvsActionProductionProofWaitResult>;
+  getReceipt(id: string): Promise<SvsReceiptExport>;
+  verifyReceipt(receipt: SvsReceiptExport | JsonObject, options?: JsonObject): Promise<SvsReceiptVerificationResult>;
+  verifyActionReceipt(id: string, options?: JsonObject): Promise<SvsReceiptVerificationResult>;
+  request(path: string, options?: SvsRequestOptions): Promise<JsonObject>;
+}
+
+export const BOT_REQUEST_SIGNATURE_VERSION: "v1";
+export const DEFAULT_BOT_REQUEST_TIMESTAMP_MAX_AGE_MS: number;
+export function createBotRequestSignature(options?: SvsBotRequestSignatureOptions): string;
+export function verifyBotRequestSignature(options?: SvsBotRequestSignatureVerificationOptions): boolean;
+
+export const CERTIFIED_SUBMIT_OPERATOR_STATUS_VERSION: "svs.certified-submit-operator-status.v1";
+export function createCertifiedSubmitOperatorStatus(options?: JsonObject): SvsCertifiedSubmitOperatorStatus;
+export function isCertifiedSubmitOperatorStatusReady(status: unknown): boolean;
+export function selectCertifiedSubmitNextAction(options?: JsonObject): JsonObject;
+export function summarizeCertifiedSubmitEvidence(evidence: unknown): JsonObject;
+
+export const APPROVAL_MESSAGE_DOMAIN: "svs-solana-verification-system";
+export const APPROVAL_MESSAGE_VERSION: "svs.approval.v1";
+export const LEGACY_APPROVAL_MESSAGE_DOMAIN: "solana-human-verification-system";
+export function summarizeApprovalDomain(signatureOrPayload?: SvsApprovalSignatureLike | JsonObject | null): SvsApprovalDomainSummary;
+
+export const ACTION_PRODUCTION_PROOF_EVIDENCE_VERSION: "svs.action-production-proof-evidence.v1";
+export const ACTION_PRODUCTION_PROOF_EVIDENCE_VERIFICATION_VERSION: "svs.action-production-proof-evidence-verification.v1";
+export function createActionProductionProofStatus(record: unknown): SvsActionProductionProofStatus;
+export function verifyActionProductionProofEvidence(evidence: unknown, options?: {
+  requireReady?: boolean;
+  expectedRecordId?: string | null;
+  requireProductionProofWebhookDelivery?: boolean;
+  staleAfterMs?: number | null;
+  now?: Date | string;
+}): SvsActionProductionProofEvidenceVerification;
+
+export const VERIFIED_AGENT_BADGE_VERSION: "svs.verified-agent-badge.v1";
+export const VERIFIED_AGENT_PROFILE_VERSION: "svs.verified-agent-profile.v1";
+export const VERIFIED_AGENT_PROFILE_VERIFICATION_VERSION: "svs.verified-agent-profile-verification.v1";
+export function createVerifiedAgentBadgeSvg(profile: SvsVerifiedAgentProfile, options?: JsonObject): string;
+export function createVerifiedAgentProfile(options?: SvsVerifiedAgentProfileOptions): SvsVerifiedAgentProfile;
+export function hashVerifiedAgentProfile(profile: unknown): string | null;
+export function verifyVerifiedAgentProfile(profile: unknown, options?: SvsVerifiedAgentProfileVerificationOptions): SvsVerifiedAgentProfileVerification;
+
+export const VERIFIED_AGENT_TRUST_SCORE_MAX: 100;
+export const VERIFIED_AGENT_TRUST_SCORE_HIGH_TRUST_MIN: 90;
+export const VERIFIED_AGENT_TRUST_SCORE_POLICY: SvsVerifiedAgentTrustScorePolicy;
+export const VERIFIED_AGENT_TRUST_SCORE_SIGNAL_DEFINITIONS: SvsVerifiedAgentTrustScoreSignalDefinition[];
+export const VERIFIED_AGENT_TRUST_SCORE_VERSION: "svs.verified-agent-trust-score.v1";
+export function createVerifiedAgentTrustScore(options?: SvsVerifiedAgentTrustScoreOptions): SvsVerifiedAgentTrustScore;
+export function hashVerifiedAgentTrustScore(score: unknown): string | null;
+
+export const DEFAULT_VERIFIED_AGENT_REGISTRY_DIR: string;
+export const VERIFIED_AGENT_REGISTRY_BUILD_VERSION: "svs.verified-agent-registry-build.v1";
+export const VERIFIED_AGENT_REGISTRY_TRUST_MANIFEST_VERSION: "svs.verified-agent-registry-trust-manifest.v1";
+export const VERIFIED_AGENT_REGISTRY_VERIFICATION_VERSION: "svs.verified-agent-registry-verification.v1";
+export const VERIFIED_AGENT_REGISTRY_VERSION: "svs.verified-agent-registry.v1";
+export function buildVerifiedAgentRegistry(options?: SvsVerifiedAgentRegistryBuildOptions): Promise<JsonObject>;
+export function createVerifiedAgentRegistryTrustManifest(options?: {
+  title?: string;
+  generatedAt?: Date | string;
+  registry: SvsVerifiedAgentRegistry;
+}): SvsVerifiedAgentRegistryTrustManifest;
+export function hashVerifiedAgentRegistry(registry: unknown): string | null;
+export function hashVerifiedAgentRegistryTrustManifest(manifest: unknown): string | null;
+export function verifyVerifiedAgentRegistry(options?: SvsVerifiedAgentRegistryVerificationOptions): Promise<SvsVerifiedAgentRegistryVerification>;
+
+export const VERIFIED_AGENT_REGISTRY_CONSUMER_VERIFICATION_VERSION: "svs.verified-agent-registry-consumer-verification.v1";
+export function verifyVerifiedAgentRegistryUrl(options?: SvsVerifiedAgentRegistryUrlVerificationOptions): Promise<SvsVerifiedAgentRegistryVerification>;
+
+export const DEFAULT_VERIFIED_AGENT_ADOPTION_KIT_DIR: string;
+export const VERIFIED_AGENT_ADOPTION_KIT_VERSION: "svs.verified-agent-adoption-kit.v1";
+export function createVerifiedAgentAdoptionKit(options?: SvsVerifiedAgentAdoptionKitOptions): SvsVerifiedAgentAdoptionKit;
+export function hashVerifiedAgentAdoptionKit(kit: unknown): string | null;
+export function persistVerifiedAgentAdoptionKit(options?: SvsVerifiedAgentAdoptionKitPersistOptions): Promise<JsonObject>;
+export function renderVerifiedAgentAdoptionKitReadme(kit: SvsVerifiedAgentAdoptionKit): string;
+
+export const SIGNED_PROOF_READ_PROTECTION_VERSION: "svs.signed-proof-read-protection-evidence.v1";
+export const SIGNED_PROOF_READ_PROTECTION_VERIFICATION_VERSION: "svs.signed-proof-read-protection-verification.v1";
+export function verifySignedProofReadProtectionEvidence(evidence: unknown, options?: JsonObject): JsonObject;
+
+export const WEBHOOK_EVENT_VERSION: "svs.webhook-event.v1";
+export const WEBHOOK_REPLAY_STORE_VERSION: "svs.webhook-replay-store.v1";
+export const WEBHOOK_SIGNATURE_VERSION: "v1";
+export function createWebhookSignature(options: SvsWebhookSignatureOptions): string;
+export function createWebhookSignatureHeaders(options: SvsWebhookSignatureHeadersOptions): Record<string, string>;
+export function verifyWebhookSignature(options: SvsWebhookSignatureVerificationOptions): SvsWebhookSignatureVerification;
+export function verifyWebhookRequest(options?: SvsWebhookRequestVerificationOptions): SvsWebhookRequestVerification;
+export function verifyWebhookRequestWithReplayStore(options?: SvsWebhookRequestReplayStoreOptions): Promise<SvsWebhookRequestVerification>;

package/dist/index.js

@@ -0,0 +1,128 @@
+export {
+  BOT_CLIENT_COMPATIBILITY_VERSION,
+  BOT_CLIENT_RETRY_SAFETY_VERSION,
+  createSignedBotRequest,
+  createSolanaVerificationClientCompatibilityReport,
+  createSolanaVerificationClientRetrySafetyProof,
+  productionCertificationIsReady,
+  SOLANA_VERIFICATION_CLIENT_CAPABILITIES,
+  SOLANA_VERIFICATION_CLIENT_NAME,
+  SOLANA_VERIFICATION_CLIENT_VERSION,
+  SolanaVerificationClient,
+  SolanaVerificationProductionCertificationError,
+  SolanaVerificationRequestError
+} from "./svs-client.js";
+
+export {
+  BOT_INTEGRATION_CONTRACT_VERSION,
+  BOT_INTEGRATION_QUICKSTART_VERSION,
+  hashBotIntegrationContract,
+  normalizeBotIntegrationContractForHash
+} from "./bot-integration-contract.js";
+
+export {
+  BOT_FIRST_ACTION_RUNBOOK_VERSION,
+  BOT_FIRST_ACTION_STEP_VERSION,
+  createBotFirstActionRunbook,
+  renderBotFirstActionRunbookText
+} from "./bot-first-action-runbook.js";
+
+export {
+  SVS_ADAPTER_CATALOG_VERSION,
+  SVS_AGENT_FRAMEWORK_ADAPTERS,
+  findSvsAgentFrameworkAdapter,
+  getSvsAgentFrameworkAdapters
+} from "./adapter-catalog.js";
+
+export {
+  BOT_REQUEST_SIGNATURE_VERSION,
+  createBotRequestSignature,
+  DEFAULT_BOT_REQUEST_TIMESTAMP_MAX_AGE_MS,
+  verifyBotRequestSignature
+} from "./bot-auth.js";
+
+export {
+  CERTIFIED_SUBMIT_OPERATOR_STATUS_VERSION,
+  createCertifiedSubmitOperatorStatus,
+  isCertifiedSubmitOperatorStatusReady,
+  selectCertifiedSubmitNextAction,
+  summarizeCertifiedSubmitEvidence
+} from "./certified-submit-status.js";
+
+export {
+  APPROVAL_MESSAGE_DOMAIN,
+  APPROVAL_MESSAGE_VERSION,
+  LEGACY_APPROVAL_MESSAGE_DOMAIN,
+  summarizeApprovalDomain
+} from "./approval-signature.js";
+
+export {
+  ACTION_PRODUCTION_PROOF_EVIDENCE_VERSION,
+  ACTION_PRODUCTION_PROOF_EVIDENCE_VERIFICATION_VERSION,
+  createActionProductionProofStatus,
+  verifyActionProductionProofEvidence
+} from "./action-production-proof-evidence.js";
+
+export {
+  VERIFIED_AGENT_BADGE_VERSION,
+  VERIFIED_AGENT_PROFILE_VERSION,
+  VERIFIED_AGENT_PROFILE_VERIFICATION_VERSION,
+  createVerifiedAgentBadgeSvg,
+  createVerifiedAgentProfile,
+  hashVerifiedAgentProfile,
+  verifyVerifiedAgentProfile
+} from "./verified-agent-profile.js";
+
+export {
+  VERIFIED_AGENT_TRUST_SCORE_HIGH_TRUST_MIN,
+  VERIFIED_AGENT_TRUST_SCORE_MAX,
+  VERIFIED_AGENT_TRUST_SCORE_POLICY,
+  VERIFIED_AGENT_TRUST_SCORE_SIGNAL_DEFINITIONS,
+  VERIFIED_AGENT_TRUST_SCORE_VERSION,
+  createVerifiedAgentTrustScore,
+  hashVerifiedAgentTrustScore
+} from "./verified-agent-trust-score.js";
+
+export {
+  DEFAULT_VERIFIED_AGENT_REGISTRY_DIR,
+  VERIFIED_AGENT_REGISTRY_BUILD_VERSION,
+  VERIFIED_AGENT_REGISTRY_TRUST_MANIFEST_VERSION,
+  VERIFIED_AGENT_REGISTRY_VERIFICATION_VERSION,
+  VERIFIED_AGENT_REGISTRY_VERSION,
+  buildVerifiedAgentRegistry,
+  createVerifiedAgentRegistryTrustManifest,
+  hashVerifiedAgentRegistry,
+  hashVerifiedAgentRegistryTrustManifest,
+  verifyVerifiedAgentRegistry
+} from "./verified-agent-registry.js";
+
+export {
+  VERIFIED_AGENT_REGISTRY_CONSUMER_VERIFICATION_VERSION,
+  verifyVerifiedAgentRegistryUrl
+} from "./verified-agent-registry-consumer.js";
+
+export {
+  DEFAULT_VERIFIED_AGENT_ADOPTION_KIT_DIR,
+  VERIFIED_AGENT_ADOPTION_KIT_VERSION,
+  createVerifiedAgentAdoptionKit,
+  hashVerifiedAgentAdoptionKit,
+  persistVerifiedAgentAdoptionKit,
+  renderVerifiedAgentAdoptionKitReadme
+} from "./verified-agent-adoption-kit.js";
+
+export {
+  SIGNED_PROOF_READ_PROTECTION_VERSION,
+  SIGNED_PROOF_READ_PROTECTION_VERIFICATION_VERSION,
+  verifySignedProofReadProtectionEvidence
+} from "./signed-proof-read-protection.js";
+
+export {
+  createWebhookSignature,
+  createWebhookSignatureHeaders,
+  verifyWebhookRequest,
+  verifyWebhookRequestWithReplayStore,
+  verifyWebhookSignature,
+  WEBHOOK_EVENT_VERSION,
+  WEBHOOK_REPLAY_STORE_VERSION,
+  WEBHOOK_SIGNATURE_VERSION
+} from "./webhooks.js";

package/dist/protocol.d.ts

@@ -0,0 +1,205 @@
+import type {
+  SvsActionProductionProofEvidence,
+  SvsCurrentApprovalDomainRequirementResult,
+  SvsNextAction,
+  SvsProtocolVerifiedAgentResult,
+  SvsVerifiedAgentTrustScore
+} from "./common.js";
+
+export const VERIFIED_AGENT_REQUIREMENT_VERSION: "svs.verified-agent-requirement.v1";
+export const CURRENT_APPROVAL_DOMAIN_REQUIREMENT_VERSION: "svs.current-approval-domain-requirement.v1";
+export const HOSTED_VERIFIED_AGENT_REGISTRY_REQUIREMENT_VERSION: "svs.hosted-verified-agent-registry-requirement.v1";
+export const VERIFIED_AGENT_STANDARD_CONFORMANCE_FIXTURES_VERSION: "svs.verified-agent-standard-conformance-fixtures.v1";
+export const VERIFIED_AGENT_STANDARD_CONFORMANCE_VERSION: "svs.verified-agent-standard-conformance.v1";
+export const HOSTED_VERIFIED_AGENT_TRUST_POLICY_STANDARD: "standard";
+export const HOSTED_VERIFIED_AGENT_TRUST_POLICY_HIGH_TRUST: "high-trust";
+export const HOSTED_VERIFIED_AGENT_TRUST_POLICY_CUSTOM: "custom";
+export const HOSTED_VERIFIED_AGENT_TRUST_POLICY_VALUES: readonly [
+  "standard",
+  "high-trust",
+  "custom"
+];
+
+export type SvsHostedVerifiedAgentRegistryTrustPolicy = "standard" | "high-trust" | "custom";
+
+export interface RequireVerifiedAgentOptions {
+  client?: unknown;
+  baseUrl?: string;
+  apiKey?: string;
+  requestSigningSecret?: string;
+  botId: string;
+  agentWallet?: string | null;
+  action?: string | null;
+  minCertification?: string;
+  staleAfterMs?: number;
+  requireCurrentIntegrationContract?: boolean;
+}
+
+export function requireVerifiedAgent(options: RequireVerifiedAgentOptions): Promise<SvsProtocolVerifiedAgentResult>;
+
+export interface RequireCurrentApprovalDomainOptions {
+  action?: string | null;
+}
+
+export function requireCurrentApprovalDomain(
+  proofEvidenceOrHumanApproval: SvsActionProductionProofEvidence | SvsActionProductionProofEvidence["humanApproval"] | unknown,
+  options?: RequireCurrentApprovalDomainOptions
+): SvsCurrentApprovalDomainRequirementResult;
+
+export interface RequireHostedVerifiedAgentRegistryOptions {
+  registryUrl: string;
+  trustManifestUrl?: string | null;
+  expectedRegistryHash: string;
+  botId: string;
+  requireVerified?: boolean;
+  trustPolicy?: SvsHostedVerifiedAgentRegistryTrustPolicy | null;
+  requireHighTrustScore?: boolean;
+  minimumTrustScore?: number | null;
+  requireTrustScoreEvidenceComplete?: boolean | null;
+  maxTrustScoreBlockingSignals?: number | null;
+  staleAfterMs?: number | null;
+  now?: Date | string;
+  fetchImpl?: typeof fetch;
+}
+
+export interface SvsHostedVerifiedAgentRegistryTrustScorePolicyResult {
+  ok: boolean;
+  status: "not_required" | "passed" | "failed" | string;
+  required: boolean;
+  trustPolicy: SvsHostedVerifiedAgentRegistryTrustPolicy | string;
+  requireHighTrustScore?: boolean;
+  minimumTrustScore?: number | null;
+  requireTrustScoreEvidenceComplete?: boolean;
+  maxTrustScoreBlockingSignals?: number | null;
+  detail: string;
+}
+
+export interface SvsHostedVerifiedAgentRegistryAgentSummary {
+  index: number | null;
+  botId: string | null;
+  profilePath: string | null;
+  profileUrl: string | null;
+  profileHash: string | null;
+  trustScore: Pick<
+    SvsVerifiedAgentTrustScore,
+    | "version"
+    | "status"
+    | "score"
+    | "maxScore"
+    | "evidenceComplete"
+    | "blockingSignalCount"
+    | "trustScoreHash"
+    | "computedTrustScoreHash"
+    | "nextAction"
+  > & {
+    hashValid: boolean;
+    highTrustMinimumScore: number | null;
+  } | null;
+  ok: boolean;
+  failedCheckCount: number;
+}
+
+export interface SvsHostedVerifiedAgentRegistryRequirement {
+  version: "svs.hosted-verified-agent-registry-requirement.v1";
+  ok: true;
+  status: "verified";
+  botId: string;
+  registryUrl: string;
+  trustManifestUrl: string | null;
+  expectedRegistryHash: string;
+  registryHash: string | null;
+  trustManifest: unknown;
+  trustScorePolicy: SvsHostedVerifiedAgentRegistryTrustScorePolicyResult;
+  agent: SvsHostedVerifiedAgentRegistryAgentSummary;
+  profileCount: number | null;
+  verifiedAgentCount: number | null;
+  nextAction: SvsNextAction;
+}
+
+export function requireHostedVerifiedAgentRegistry(
+  options: RequireHostedVerifiedAgentRegistryOptions
+): Promise<SvsHostedVerifiedAgentRegistryRequirement>;
+
+export function createHostedVerifiedAgentRegistryMiddleware(
+  options: Omit<RequireHostedVerifiedAgentRegistryOptions, "botId">
+): (request?: { botId?: string; agent?: { botId?: string }; body?: { botId?: string } }) => Promise<SvsHostedVerifiedAgentRegistryRequirement>;
+
+export interface SvsVerifiedAgentStandardConformanceScenarioFixture {
+  id: string;
+  label: string;
+  expectedAccepted: boolean;
+  expectedFailureCode?: string | null;
+  requirement: string;
+  botId: string;
+  agentWallet?: string | null;
+  action?: string | null;
+  recordId: string;
+  expectedRecordId?: string | null;
+  staleAfterMs?: number | null;
+  certification: unknown;
+  actionProductionProofEvidence: SvsActionProductionProofEvidence;
+}
+
+export interface SvsVerifiedAgentStandardConformanceFixtures {
+  version: "svs.verified-agent-standard-conformance-fixtures.v1";
+  generatedAt: string;
+  standard: "Verified Agent Standard";
+  botId: string;
+  agentWallet: string;
+  action: string;
+  recordId: string;
+  scenarioCount: number;
+  scenarios: SvsVerifiedAgentStandardConformanceScenarioFixture[];
+}
+
+export interface CreateVerifiedAgentStandardConformanceFixturesOptions {
+  now?: Date | string;
+  botId?: string;
+  agentWallet?: string;
+  action?: string;
+  recordId?: string;
+}
+
+export function createVerifiedAgentStandardConformanceFixtures(
+  options?: CreateVerifiedAgentStandardConformanceFixturesOptions
+): SvsVerifiedAgentStandardConformanceFixtures;
+
+export interface SvsVerifiedAgentStandardConformanceScenarioResult {
+  id: string;
+  label: string;
+  ok: boolean;
+  expectedAccepted: boolean;
+  accepted: boolean;
+  expectedFailureCode: string | null;
+  failureCode: string | null;
+  errorName: string | null;
+  detail: string;
+  requirement: string;
+  verification: unknown | null;
+  actionProductionProof: unknown | null;
+  approvalDomain: unknown | null;
+}
+
+export interface SvsVerifiedAgentStandardConformance {
+  version: "svs.verified-agent-standard-conformance.v1";
+  ok: boolean;
+  status: "verified" | "failed";
+  checkedAt: string;
+  fixtureVersion: string | null;
+  scenarioCount: number;
+  passedScenarioCount: number;
+  failedScenarioCount: number;
+  scenarios: SvsVerifiedAgentStandardConformanceScenarioResult[];
+  nextAction: SvsNextAction;
+  conformanceHash: string;
+}
+
+export interface RunVerifiedAgentStandardConformanceOptions {
+  fixtures?: SvsVerifiedAgentStandardConformanceFixtures | null;
+  now?: Date | string;
+  staleAfterMs?: number;
+}
+
+export function runVerifiedAgentStandardConformance(
+  options?: RunVerifiedAgentStandardConformanceOptions
+): Promise<SvsVerifiedAgentStandardConformance>;