@agentcash/discovery 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,106 @@
+import { CompatibilityMode } from './flags.cjs';
+export { DEFAULT_COMPAT_MODE, LEGACY_SUNSET_DATE, STRICT_ESCALATION_CODES } from './flags.cjs';
+
+type DiscoveryStage = 'override' | 'openapi' | 'well-known/x402' | 'dns/_x402' | 'interop/mpp' | 'probe';
+type WarningSeverity = 'error' | 'warn' | 'info';
+type TrustTier = 'unverified' | 'origin_hosted' | 'ownership_verified' | 'runtime_verified';
+type AuthMode = 'paid' | 'siwx' | 'apiKey' | 'unprotected';
+type PricingMode = 'fixed' | 'range' | 'quote';
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'TRACE';
+interface DiscoveryWarning {
+    code: string;
+    severity: WarningSeverity;
+    message: string;
+    hint?: string;
+    stage?: DiscoveryStage;
+    resourceKey?: string;
+}
+interface PricingHint {
+    pricingMode: PricingMode;
+    price?: string;
+    minPrice?: string;
+    maxPrice?: string;
+}
+interface ResourceLinks {
+    openapiUrl?: string;
+    wellKnownUrl?: string;
+    discoveryUrl?: string;
+    llmsTxtUrl?: string;
+}
+interface DiscoveryResource {
+    resourceKey: string;
+    origin: string;
+    method: HttpMethod;
+    path: string;
+    source: DiscoveryStage;
+    verified: boolean;
+    protocolHints?: string[];
+    priceHint?: string;
+    pricing?: PricingHint;
+    authHint?: AuthMode;
+    summary?: string;
+    confidence?: number;
+    trustTier?: TrustTier;
+    links?: ResourceLinks;
+}
+interface StageTrace {
+    stage: DiscoveryStage;
+    attempted: boolean;
+    valid: boolean;
+    resourceCount: number;
+    durationMs: number;
+    warnings: DiscoveryWarning[];
+    links?: ResourceLinks;
+}
+interface RawSources {
+    openapi?: unknown;
+    llmsTxt?: string;
+    wellKnownX402?: unknown[];
+    dnsRecords?: string[];
+    interopMpp?: unknown;
+}
+interface DiscoverResult {
+    origin: string;
+    resources: DiscoveryResource[];
+    warnings: DiscoveryWarning[];
+    compatMode: CompatibilityMode;
+    upgradeSuggested: boolean;
+    upgradeReasons: string[];
+    selectedStage?: DiscoveryStage;
+}
+interface DiscoverDetailedResult extends DiscoverResult {
+    trace: StageTrace[];
+    resourceWarnings: Record<string, DiscoveryWarning[]>;
+    rawSources?: RawSources;
+}
+type DiscoveryFetcher = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+type TxtResolver = (fqdn: string) => Promise<string[]>;
+interface ProbeCandidate {
+    path: string;
+    methods?: HttpMethod[];
+}
+interface DiscoverOptions {
+    target: string;
+    compatMode?: CompatibilityMode;
+    overrideUrls?: string[];
+    fetcher?: DiscoveryFetcher;
+    txtResolver?: TxtResolver;
+    probeCandidates?: ProbeCandidate[];
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+interface DiscoverDetailedOptions extends DiscoverOptions {
+    rawView?: 'none' | 'full';
+    includeInteropMpp?: boolean;
+}
+
+declare const UPGRADE_WARNING_CODES: readonly ["LEGACY_WELL_KNOWN_USED", "LEGACY_DNS_USED", "LEGACY_DNS_PLAIN_URL", "LEGACY_INSTRUCTIONS_USED", "LEGACY_OWNERSHIP_PROOFS_USED", "OPENAPI_AUTH_MODE_MISSING", "OPENAPI_TOP_LEVEL_INVALID"];
+declare function computeUpgradeSignal(warnings: DiscoveryWarning[]): {
+    upgradeSuggested: boolean;
+    upgradeReasons: string[];
+};
+
+declare function discover(options: DiscoverOptions): Promise<DiscoverResult>;
+declare function discoverDetailed(options: DiscoverDetailedOptions): Promise<DiscoverDetailedResult>;
+
+export { type AuthMode, CompatibilityMode, type DiscoverDetailedOptions, type DiscoverDetailedResult, type DiscoverOptions, type DiscoverResult, type DiscoveryFetcher, type DiscoveryResource, type DiscoveryStage, type DiscoveryWarning, type HttpMethod, type PricingMode, type ProbeCandidate, type RawSources, type StageTrace, type TrustTier, type TxtResolver, UPGRADE_WARNING_CODES, type WarningSeverity, computeUpgradeSignal, discover, discoverDetailed };

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+import { CompatibilityMode } from './flags.js';
+export { DEFAULT_COMPAT_MODE, LEGACY_SUNSET_DATE, STRICT_ESCALATION_CODES } from './flags.js';
+
+type DiscoveryStage = 'override' | 'openapi' | 'well-known/x402' | 'dns/_x402' | 'interop/mpp' | 'probe';
+type WarningSeverity = 'error' | 'warn' | 'info';
+type TrustTier = 'unverified' | 'origin_hosted' | 'ownership_verified' | 'runtime_verified';
+type AuthMode = 'paid' | 'siwx' | 'apiKey' | 'unprotected';
+type PricingMode = 'fixed' | 'range' | 'quote';
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'TRACE';
+interface DiscoveryWarning {
+    code: string;
+    severity: WarningSeverity;
+    message: string;
+    hint?: string;
+    stage?: DiscoveryStage;
+    resourceKey?: string;
+}
+interface PricingHint {
+    pricingMode: PricingMode;
+    price?: string;
+    minPrice?: string;
+    maxPrice?: string;
+}
+interface ResourceLinks {
+    openapiUrl?: string;
+    wellKnownUrl?: string;
+    discoveryUrl?: string;
+    llmsTxtUrl?: string;
+}
+interface DiscoveryResource {
+    resourceKey: string;
+    origin: string;
+    method: HttpMethod;
+    path: string;
+    source: DiscoveryStage;
+    verified: boolean;
+    protocolHints?: string[];
+    priceHint?: string;
+    pricing?: PricingHint;
+    authHint?: AuthMode;
+    summary?: string;
+    confidence?: number;
+    trustTier?: TrustTier;
+    links?: ResourceLinks;
+}
+interface StageTrace {
+    stage: DiscoveryStage;
+    attempted: boolean;
+    valid: boolean;
+    resourceCount: number;
+    durationMs: number;
+    warnings: DiscoveryWarning[];
+    links?: ResourceLinks;
+}
+interface RawSources {
+    openapi?: unknown;
+    llmsTxt?: string;
+    wellKnownX402?: unknown[];
+    dnsRecords?: string[];
+    interopMpp?: unknown;
+}
+interface DiscoverResult {
+    origin: string;
+    resources: DiscoveryResource[];
+    warnings: DiscoveryWarning[];
+    compatMode: CompatibilityMode;
+    upgradeSuggested: boolean;
+    upgradeReasons: string[];
+    selectedStage?: DiscoveryStage;
+}
+interface DiscoverDetailedResult extends DiscoverResult {
+    trace: StageTrace[];
+    resourceWarnings: Record<string, DiscoveryWarning[]>;
+    rawSources?: RawSources;
+}
+type DiscoveryFetcher = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+type TxtResolver = (fqdn: string) => Promise<string[]>;
+interface ProbeCandidate {
+    path: string;
+    methods?: HttpMethod[];
+}
+interface DiscoverOptions {
+    target: string;
+    compatMode?: CompatibilityMode;
+    overrideUrls?: string[];
+    fetcher?: DiscoveryFetcher;
+    txtResolver?: TxtResolver;
+    probeCandidates?: ProbeCandidate[];
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+interface DiscoverDetailedOptions extends DiscoverOptions {
+    rawView?: 'none' | 'full';
+    includeInteropMpp?: boolean;
+}
+
+declare const UPGRADE_WARNING_CODES: readonly ["LEGACY_WELL_KNOWN_USED", "LEGACY_DNS_USED", "LEGACY_DNS_PLAIN_URL", "LEGACY_INSTRUCTIONS_USED", "LEGACY_OWNERSHIP_PROOFS_USED", "OPENAPI_AUTH_MODE_MISSING", "OPENAPI_TOP_LEVEL_INVALID"];
+declare function computeUpgradeSignal(warnings: DiscoveryWarning[]): {
+    upgradeSuggested: boolean;
+    upgradeReasons: string[];
+};
+
+declare function discover(options: DiscoverOptions): Promise<DiscoverResult>;
+declare function discoverDetailed(options: DiscoverDetailedOptions): Promise<DiscoverDetailedResult>;
+
+export { type AuthMode, CompatibilityMode, type DiscoverDetailedOptions, type DiscoverDetailedResult, type DiscoverOptions, type DiscoverResult, type DiscoveryFetcher, type DiscoveryResource, type DiscoveryStage, type DiscoveryWarning, type HttpMethod, type PricingMode, type ProbeCandidate, type RawSources, type StageTrace, type TrustTier, type TxtResolver, UPGRADE_WARNING_CODES, type WarningSeverity, computeUpgradeSignal, discover, discoverDetailed };