@unbrowse/sdk 6.17.0-preview.6

package/dist/contracts.d.ts

@@ -0,0 +1,372 @@
+export type SkillLifecycle = "active" | "deprecated" | "disabled";
+export type OwnerType = "agent" | "marketplace" | "user";
+export type Idempotency = "safe" | "unsafe";
+export type VerificationStatus = "verified" | "unverified" | "failed" | "pending" | "disabled";
+export type GraphVisibility = "shadow" | "public";
+export interface SkillSubmissionProvenance {
+    submitted_at: string;
+    submitter_agent_id?: string;
+    client_trace_version?: string;
+    client_code_hash?: string;
+    client_git_sha?: string;
+    transport?: string;
+    release_manifest_version?: string;
+    release_manifest_verified?: boolean;
+    release_manifest_reason?: string;
+}
+export interface SkillTrustMetadata {
+    graph_visibility: GraphVisibility;
+    promotion_reason: string;
+    submission_count: number;
+    unique_submitters: number;
+    verified_release_submissions: number;
+    unique_verified_submitters: number;
+    verified_ratio: number;
+    last_submission_at: string;
+}
+export interface EndpointCorroboration {
+    submission_count: number;
+    unique_submitters: number;
+    verified_release_submissions: number;
+    unique_verified_submitters: number;
+    last_submission_at: string;
+    submitter_agent_ids?: string[];
+    verified_release_submitter_ids?: string[];
+}
+export interface ResponseSchema {
+    type: string;
+    description?: string;
+    properties?: Record<string, ResponseSchema>;
+    items?: ResponseSchema;
+    required?: string[];
+    anyOf?: ResponseSchema[];
+    inferred_from_samples: number;
+}
+export interface ProjectionOptions {
+    fields?: string[];
+    compact?: boolean;
+    max_depth?: number;
+    raw?: boolean;
+}
+export interface EndpointDescriptor {
+    endpoint_id: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | "WS";
+    url_template: string;
+    description?: string;
+    query?: Record<string, unknown>;
+    path_params?: Record<string, string>;
+    body_params?: Record<string, unknown>;
+    body?: Record<string, unknown>;
+    idempotency: Idempotency;
+    verification_status: VerificationStatus;
+    reliability_score: number;
+    last_verified_at?: string;
+    response_schema?: ResponseSchema;
+    trigger_url?: string;
+    exec_strategy?: "server" | "trigger-intercept" | "browser";
+    graph_visibility?: GraphVisibility;
+    corroboration?: EndpointCorroboration;
+}
+export interface SkillManifest {
+    skill_id: string;
+    version: string;
+    schema_version: string;
+    name: string;
+    intent_signature: string;
+    domain: string;
+    subdomain?: string;
+    description: string;
+    owner_type: OwnerType;
+    execution_type: "http" | "browser-capture";
+    auth_profile_ref?: string;
+    endpoints: EndpointDescriptor[];
+    lifecycle: SkillLifecycle;
+    created_at: string;
+    updated_at: string;
+    intents?: string[];
+    base_price_usd?: number;
+    owner_compensation_opt_in?: boolean;
+    provenance_events?: SkillSubmissionProvenance[];
+    trust?: SkillTrustMetadata;
+}
+export interface ExecutionTrace {
+    trace_id: string;
+    skill_id: string;
+    endpoint_id: string;
+    started_at: string;
+    completed_at: string;
+    success: boolean;
+    status_code?: number;
+    error?: string;
+    result?: unknown;
+    tokens_used?: number;
+    tokens_saved?: number;
+    tokens_saved_pct?: number;
+    trace_version?: string;
+}
+export interface OrchestrationTiming {
+    search_ms: number;
+    get_skill_ms: number;
+    execute_ms: number;
+    total_ms: number;
+    source: "marketplace" | "live-capture" | "dom-fallback" | "route-cache" | "browser-action";
+    cache_hit: boolean;
+    candidates_found: number;
+    candidates_tried: number;
+    skill_id?: string;
+    tokens_saved: number;
+    response_bytes: number;
+    time_saved_pct: number;
+    tokens_saved_pct: number;
+    baseline_total_ms?: number;
+    actual_total_ms?: number;
+    time_saved_ms?: number;
+    baseline_cost_uc?: number;
+    actual_cost_uc?: number;
+    cost_saved_uc?: number;
+    paid_search_uc?: number;
+    paid_execution_uc?: number;
+    trace_version?: string;
+}
+export interface AgentImpact {
+    source: string;
+    cache_hit: boolean;
+    browser_avoided: boolean;
+    baseline_total_ms?: number;
+    actual_total_ms?: number;
+    time_saved_ms?: number;
+    time_saved_pct: number;
+    tokens_saved: number;
+    tokens_saved_pct: number;
+    baseline_cost_uc?: number;
+    actual_cost_uc?: number;
+    cost_saved_uc?: number;
+}
+export interface AgentNextAction {
+    endpoint_id: string;
+    operation_id: string;
+    title: string;
+    why: string;
+    command: string;
+}
+export interface RequestOptions {
+    headers?: HeadersInit;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export interface ResolveInput {
+    intent: string;
+    url?: string;
+    params?: Record<string, unknown>;
+    context?: {
+        url?: string;
+        domain?: string;
+    };
+    projection?: ProjectionOptions;
+    confirmUnsafe?: boolean;
+    confirmThirdPartyTerms?: boolean;
+    dryRun?: boolean;
+    forceCapture?: boolean;
+}
+export interface ExecuteInput {
+    skillId: string;
+    params?: Record<string, unknown>;
+    projection?: ProjectionOptions;
+    confirmUnsafe?: boolean;
+    confirmThirdPartyTerms?: boolean;
+    dryRun?: boolean;
+    intent?: string;
+    contextUrl?: string;
+}
+export interface LoginInput {
+    url: string;
+}
+export interface StealAuthInput {
+    url: string;
+    browser?: "auto" | "firefox" | "chrome" | "chromium";
+    chromeProfile?: string;
+    firefoxProfile?: string;
+    chromiumProfile?: string;
+    chromiumUserDataDir?: string;
+    chromiumCookieDbPath?: string;
+    safeStorageService?: string;
+    browserName?: string;
+}
+export interface SearchInput {
+    intent: string;
+    k?: number;
+}
+export interface SearchDomainInput extends SearchInput {
+    domain: string;
+}
+export interface FeedbackInput {
+    skillId: string;
+    endpointId: string;
+    rating: number;
+    outcome?: string;
+    diagnostics?: {
+        total_ms?: number;
+        bottleneck?: string;
+        wrong_endpoint?: boolean;
+        expected_data?: string;
+        got_data?: string;
+        trace_version?: string;
+    };
+}
+export interface AvailableEndpoint {
+    endpoint_id: string;
+    score?: number;
+    method?: string;
+    url_template?: string;
+    description?: string;
+    schema_summary?: Record<string, unknown> | null;
+    example_fields?: string[];
+    input_params?: Array<{
+        key: string;
+        type?: string;
+        required?: boolean;
+        example_value?: string;
+    }>;
+    requires_third_party_terms_confirmation?: boolean;
+    third_party_terms_policy_domain?: string;
+    third_party_terms_policy_reason?: string;
+    [key: string]: unknown;
+}
+export interface ResolveResponse {
+    result: unknown;
+    trace: ExecutionTrace;
+    source: "marketplace" | "live-capture" | "dom-fallback" | "first-pass";
+    skill?: SkillManifest;
+    timing?: OrchestrationTiming;
+    available_endpoints?: AvailableEndpoint[];
+    impact?: AgentImpact;
+    next_actions?: AgentNextAction[];
+    _recovery?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface ExecuteResponse {
+    result: unknown;
+    trace: ExecutionTrace;
+    skill?: SkillManifest;
+    timing?: OrchestrationTiming;
+    source?: string;
+    impact?: AgentImpact;
+    next_actions?: AgentNextAction[];
+    _recovery?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface SearchHit {
+    skill_id?: string;
+    score?: number;
+    confidence?: string;
+    skill?: SkillManifest;
+    [key: string]: unknown;
+}
+export interface SearchResponse {
+    results?: SearchHit[];
+    [key: string]: unknown;
+}
+export interface LoginResponse {
+    success?: boolean;
+    cookies_stored?: number;
+    [key: string]: unknown;
+}
+export interface StealAuthResponse {
+    success?: boolean;
+    cookies_stored?: number;
+    [key: string]: unknown;
+}
+export interface FeedbackResponse {
+    ok: boolean;
+    avg_rating?: number;
+    [key: string]: unknown;
+}
+export interface StatsResponse {
+    npm?: Record<string, unknown>;
+    github?: Record<string, unknown>;
+    agents?: Record<string, unknown>;
+    fetched_at?: string;
+    [key: string]: unknown;
+}
+export interface HealthResponse {
+    status: string;
+    trace_version?: string;
+    code_hash?: string;
+    git_sha?: string;
+    [key: string]: unknown;
+}
+export interface DashboardEarnings {
+    total_usd?: number;
+    unsettled_usd?: number;
+    by_skill?: Array<{
+        skill_id: string;
+        executions: number;
+        usd: number;
+    }>;
+    [key: string]: unknown;
+}
+export interface DashboardSpending {
+    total_usd?: number;
+    by_skill?: Array<{
+        skill_id: string;
+        executions: number;
+        usd: number;
+    }>;
+    [key: string]: unknown;
+}
+export interface DashboardContributions {
+    routes_published?: number;
+    routes_active?: number;
+    unique_domains?: number;
+    [key: string]: unknown;
+}
+export interface Dashboard {
+    agent_id?: string;
+    wallet_address?: string;
+    earnings?: DashboardEarnings;
+    spending?: DashboardSpending;
+    contributions?: DashboardContributions;
+    [key: string]: unknown;
+}
+export interface CreatorTransaction {
+    tx_id: string;
+    skill_id?: string;
+    endpoint_id?: string;
+    amount_usd?: number;
+    amount_uc?: number;
+    settled_at?: string;
+    [key: string]: unknown;
+}
+export interface CreatorTransactionsResponse {
+    ledger?: {
+        total_usd?: number;
+        unsettled_usd?: number;
+        [key: string]: unknown;
+    };
+    transactions?: CreatorTransaction[];
+    [key: string]: unknown;
+}
+export interface AttributionLedger {
+    indexer_id?: string;
+    total_usd?: number;
+    by_skill?: Array<{
+        skill_id: string;
+        usd: number;
+        executions: number;
+    }>;
+    [key: string]: unknown;
+}
+export interface WalletInfo {
+    wallet_address?: string;
+    wallet_provider?: string;
+    [key: string]: unknown;
+}
+export interface UnbrowseClientOptions {
+    baseUrl?: string;
+    apiKey?: string;
+    headers?: HeadersInit;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+    clientId?: string;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"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"}

package/dist/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":""}

package/dist/errors.d.ts

@@ -0,0 +1,45 @@
+import type { X402PaymentRequirement } from "./x402.js";
+export declare class UnbrowseApiError extends Error {
+    readonly status: number;
+    readonly path: string;
+    readonly data: unknown;
+    readonly headers: Headers;
+    constructor(message: string, options: {
+        status: number;
+        path: string;
+        data: unknown;
+        headers: Headers;
+    });
+}
+/**
+ * Thrown when the backend returns 402 Payment Required with a parsable
+ * x402 `accepts` array. Day 4 wires a `payAndRetry` helper that consumes
+ * this error + a wallet and replays the request with an `X-PAYMENT` header.
+ */
+export declare class PaymentRequiredError extends UnbrowseApiError {
+    readonly accepts: X402PaymentRequirement[];
+    readonly resourceUrl: string;
+    readonly skillId?: string;
+    constructor(message: string, accepts: X402PaymentRequirement[], resourceUrl: string, skillId?: string);
+}
+/**
+ * Thrown when the platform sponsor wallet would normally cover the call
+ * but the per-agent or global cap is exhausted (or no wallet is configured).
+ * Caller can still pay directly via `payAndRetry` using the carried `accepts`.
+ */
+export declare class SponsorExhaustedError extends PaymentRequiredError {
+    readonly reason: "agent_cap" | "global_cap" | "no_wallet";
+    readonly remainingCreditUsd: number;
+    constructor(message: string, accepts: X402PaymentRequirement[], resourceUrl: string, reason: "agent_cap" | "global_cap" | "no_wallet", remainingCreditUsd: number, skillId?: string);
+}
+/**
+ * Thrown when the SDK cannot locate, spawn, or reach a local `unbrowse`
+ * runtime. The `cause` field discriminates whether the failure was
+ * spawn-time, probe-time, or because no binary was found on disk.
+ */
+export declare class RuntimeUnavailableError extends UnbrowseApiError {
+    readonly cause: "spawn_failed" | "probe_failed" | "binary_missing";
+    readonly attemptedPort?: number;
+    constructor(message: string, cause: "spawn_failed" | "probe_failed" | "binary_missing", attemptedPort?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;CAQxG;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACxD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAGxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,sBAAsB,EAAE,EACjC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM;CAanB;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,oBAAoB;IAC7D,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;IAC1D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;gBAGlC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,sBAAsB,EAAE,EACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,WAAW,EAChD,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,MAAM;CAOnB;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,gBAAgB;IAC3D,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,GAAG,gBAAgB,CAAC;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GAAG,cAAc,GAAG,gBAAgB,EACzD,aAAa,CAAC,EAAE,MAAM;CAYzB"}

package/dist/errors.js

@@ -0,0 +1,72 @@
+export class UnbrowseApiError extends Error {
+    status;
+    path;
+    data;
+    headers;
+    constructor(message, options) {
+        super(message);
+        this.name = "UnbrowseApiError";
+        this.status = options.status;
+        this.path = options.path;
+        this.data = options.data;
+        this.headers = options.headers;
+    }
+}
+/**
+ * Thrown when the backend returns 402 Payment Required with a parsable
+ * x402 `accepts` array. Day 4 wires a `payAndRetry` helper that consumes
+ * this error + a wallet and replays the request with an `X-PAYMENT` header.
+ */
+export class PaymentRequiredError extends UnbrowseApiError {
+    accepts;
+    resourceUrl;
+    skillId;
+    constructor(message, accepts, resourceUrl, skillId) {
+        super(message, {
+            status: 402,
+            path: resourceUrl,
+            data: { accepts, resourceUrl, skillId },
+            headers: new Headers(),
+        });
+        this.name = "PaymentRequiredError";
+        this.accepts = accepts;
+        this.resourceUrl = resourceUrl;
+        this.skillId = skillId;
+    }
+}
+/**
+ * Thrown when the platform sponsor wallet would normally cover the call
+ * but the per-agent or global cap is exhausted (or no wallet is configured).
+ * Caller can still pay directly via `payAndRetry` using the carried `accepts`.
+ */
+export class SponsorExhaustedError extends PaymentRequiredError {
+    reason;
+    remainingCreditUsd;
+    constructor(message, accepts, resourceUrl, reason, remainingCreditUsd, skillId) {
+        super(message, accepts, resourceUrl, skillId);
+        this.name = "SponsorExhaustedError";
+        this.reason = reason;
+        this.remainingCreditUsd = remainingCreditUsd;
+    }
+}
+/**
+ * Thrown when the SDK cannot locate, spawn, or reach a local `unbrowse`
+ * runtime. The `cause` field discriminates whether the failure was
+ * spawn-time, probe-time, or because no binary was found on disk.
+ */
+export class RuntimeUnavailableError extends UnbrowseApiError {
+    cause;
+    attemptedPort;
+    constructor(message, cause, attemptedPort) {
+        super(message, {
+            status: 0,
+            path: attemptedPort ? `http://127.0.0.1:${attemptedPort}` : "<runtime>",
+            data: { cause, attemptedPort },
+            headers: new Headers(),
+        });
+        this.name = "RuntimeUnavailableError";
+        this.cause = cause;
+        this.attemptedPort = attemptedPort;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,MAAM,CAAS;IACf,IAAI,CAAS;IACb,IAAI,CAAU;IACd,OAAO,CAAU;IAE1B,YAAY,OAAe,EAAE,OAA0E;QACrG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,gBAAgB;IAC/C,OAAO,CAA2B;IAClC,WAAW,CAAS;IACpB,OAAO,CAAU;IAE1B,YACE,OAAe,EACf,OAAiC,EACjC,WAAmB,EACnB,OAAgB;QAEhB,KAAK,CAAC,OAAO,EAAE;YACb,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE;YACvC,OAAO,EAAE,IAAI,OAAO,EAAE;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,oBAAoB;IACpD,MAAM,CAA2C;IACjD,kBAAkB,CAAS;IAEpC,YACE,OAAe,EACf,OAAiC,EACjC,WAAmB,EACnB,MAAgD,EAChD,kBAA0B,EAC1B,OAAgB;QAEhB,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IAC/C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,gBAAgB;IAClD,KAAK,CAAqD;IAC1D,aAAa,CAAU;IAEhC,YACE,OAAe,EACf,KAAyD,EACzD,aAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE;YACb,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,oBAAoB,aAAa,EAAE,CAAC,CAAC,CAAC,WAAW;YACvE,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE;YAC9B,OAAO,EAAE,IAAI,OAAO,EAAE;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF"}