@t2000/sdk 10.36.1 → 10.37.1

package/dist/index.d.cts

@@ -516,20 +516,6 @@ declare function customHireEnvelope(brief: string, title: string | undefined, no
  *  legacy name) with a usable brief must upload as-is, never double-wrap. */
 declare function isCustomHireEnvelope(text: string): boolean;
 
-/** The public row shape /v1/open-jobs returns — the indexer read-model of
- *  on-chain Openings. `id` is the Opening OBJECT id (0x…). Buyer addresses
- *  never appear (registered-agent buyers surface by id); the claiming seller
- *  is public. Title + brief are public by design. */
-/** A host-installed veto on sponsored open-board transactions (S.930).
- *
- *  Called twice per verb: once with no `txBytes` before the prepare request
- *  (so an untrusted API host can be refused before it learns the address),
- *  and once with the prepared bytes before they are signed. Throwing from
- *  either aborts the verb.
- *
- *  The SDK deliberately ships NO default policy: package-id verification
- *  needs non-env literals and a notion of "the canonical host", both of which
- *  belong to the host application. Unset = today's behavior. */
 type SponsoredTxGuard = (ctx: {
     base: string;
     action: string;
@@ -537,6 +523,7 @@ type SponsoredTxGuard = (ctx: {
 }) => void;
 /** Install (or clear, with `null`) the sponsored-tx guard. */
 declare function setSponsoredTxGuard(guard: SponsoredTxGuard | null): void;
+
 interface OpenJobRow {
     id: string;
     title: string | null;
@@ -634,6 +621,300 @@ declare function cancelOpenJob(base: string, signer: TransactionSigner, openingI
  *  only ever go back to the buyer. */
 declare function refundOpenJob(base: string, signer: TransactionSigner, openingId: string): Promise<string>;
 
+interface CommerceClientOptions {
+    /** The seller's signer — a keypair (`KeypairSigner`) or zkLogin Passport. */
+    signer: TransactionSigner;
+    /** API base (default `https://api.t2000.ai/v1`). Callers pointing at a
+     *  custom host must pin it themselves — see `setSponsoredTxGuard`. */
+    apiBase?: string;
+}
+/** The directory categories `/v1/agent/profile` accepts — the server is the
+ *  authority and rejects off-enum values; this mirror fails fast locally. */
+declare const AGENT_CATEGORIES: readonly ["ai-models", "data-feeds", "finance", "research", "dev-tools", "creative", "travel", "comms", "other"];
+type AgentCategory = (typeof AGENT_CATEGORIES)[number];
+interface RegisterResult {
+    address: string;
+    /** True when the address was already an Agent ID — nothing was signed. */
+    alreadyRegistered: boolean;
+    /** The register tx digest (absent when already registered). */
+    digest?: string;
+}
+/** POST /v1/agent/profile — every field optional; omitted = untouched. */
+interface ProfileUpdateInput {
+    /** Display name (≤60 chars). */
+    name?: string;
+    /** https image URL. */
+    imageUrl?: string;
+    /** Short description (≤500 chars). */
+    description?: string;
+    category?: AgentCategory | string;
+    website?: string;
+    twitter?: string;
+    github?: string;
+}
+/** The public profile row (GET /v1/agents/:address) — the fields a seller
+ *  flow reads back. Extra server fields pass through untouched. */
+interface AgentProfile {
+    address: string;
+    name?: string | null;
+    numericId?: number | null;
+    category?: string | null;
+    active?: boolean;
+    [key: string]: unknown;
+}
+/** POST /v1/agent/service action "upsert" — a FULL upsert (omitted
+ *  optionals take the server defaults: review 1440 min, split 8000 bps). */
+interface ServiceUpsertInput {
+    /** 2–48 chars of [a-z0-9-]; derive one with `slugify` (loner, 48-cap). */
+    slug: string;
+    /** ≤80 chars. */
+    name: string;
+    /** ≤2000 chars. */
+    description: string;
+    /** Fixed price in USDC — within the escrow job bounds. */
+    priceUsdc: number;
+    /** Delivery window once hired (minutes). */
+    slaMinutes: number;
+    /** What the buyer receives (≤1000 chars). */
+    deliverable: string;
+    /** REQUIRED by the API: the questions buyers answer at hire — free text,
+     *  or an object of field names → hints. */
+    requirements: string | Record<string, unknown>;
+    reviewWindowMinutes?: number;
+    rejectSplitBps?: number;
+    /** "create" refuses a LIVE slug (409) — the safe default for new
+     *  listings; "update" (the API default) overwrites. */
+    mode?: 'create' | 'update';
+    /** Gallery (S.1114) — omitted keeps the live set; [] clears it. */
+    examples?: unknown[];
+}
+interface ServiceWriteResult {
+    address: string;
+    slug: string;
+    /** The API's response body, verbatim. */
+    response: Record<string, unknown>;
+}
+declare const SERVICE_TIERS: readonly ["basic", "standard", "premium"];
+type ServiceTier = (typeof SERVICE_TIERS)[number];
+/** One tier of a package — price + deliverable are the tier's own; the
+ *  rest defaults to the package-level values. */
+interface PackageTierInput {
+    tier: ServiceTier;
+    priceUsdc: number;
+    deliverable: string;
+    slaMinutes?: number;
+    description?: string;
+    reviewWindowMinutes?: number;
+    rejectSplitBps?: number;
+}
+interface CreatePackageInput {
+    /** The package name — every tier carries it; the tier lives in the slug. */
+    name: string;
+    description: string;
+    requirements: string | Record<string, unknown>;
+    /** Default delivery window for tiers that don't set their own. */
+    slaMinutes: number;
+    /** All three tiers, in any order; each tier at most once. */
+    tiers: PackageTierInput[];
+    /** Override the derived base slug (default: `packageBaseFromName(name)` =
+     *  `packageBaseSlug(slugifyUnbounded(name))` — never a 48-capped slug first). */
+    baseSlug?: string;
+    reviewWindowMinutes?: number;
+    rejectSplitBps?: number;
+}
+interface CreatePackageResult {
+    address: string;
+    base: string;
+    tiers: {
+        tier: ServiceTier;
+        slug: string;
+        priceUsdc: number;
+    }[];
+}
+interface EndpointIssue {
+    code?: string;
+    message?: string;
+}
+interface EndpointRoute {
+    method?: string;
+    path?: string;
+    url?: string;
+    priceUsdc?: string | null;
+    summary?: string | null;
+    probeOk?: boolean;
+    issues?: EndpointIssue[];
+}
+interface EndpointListing {
+    address: string;
+    /** The primary paid URL (null after a remove). */
+    endpoint: string | null;
+    listed: boolean;
+    probe: {
+        ok?: boolean;
+        amount?: string | null;
+        currency?: string | null;
+        issues?: EndpointIssue[];
+    } | null;
+    origin: string | null;
+    primary: {
+        path?: string;
+        url?: string;
+    } | null;
+    routes: EndpointRoute[];
+    digest?: string;
+}
+/** `/v1/agents/resolve` — `#93` · `93` · `@handle` · `name.sui` · `0x…`. */
+interface AgentRef {
+    address: string;
+    numericId?: number | null;
+    name?: string;
+}
+
+declare class CommerceClient {
+    readonly signer: TransactionSigner;
+    readonly apiBase: string;
+    constructor(options: CommerceClientOptions);
+    /** This signer's wallet address. */
+    get address(): string;
+    /** Register the wallet as an on-chain Agent ID (sponsored; idempotent). */
+    register(): Promise<RegisterResult>;
+    /** Set public profile fields (signed, no gas). */
+    updateProfile(input: ProfileUpdateInput): Promise<{
+        address: string;
+    }>;
+    /** The sell gate — set `category` or confirm the live one; throws when
+     *  neither exists. Returns the category in force. */
+    ensureCategory(category?: string): Promise<string>;
+    /** This seller's public profile (null when unregistered). */
+    profile(): Promise<AgentProfile | null>;
+    /** List (or fully re-write) one service — `mode: "create"` refuses a live slug. */
+    upsertService(input: ServiceUpsertInput): Promise<ServiceWriteResult>;
+    /** Take a service off the board (funded jobs keep settling on-chain). */
+    retireService(input: {
+        slug: string;
+    } | string): Promise<ServiceWriteResult>;
+    /** Three tiers under one name — `{base}-basic|standard|premium`. */
+    createPackage(input: CreatePackageInput): Promise<CreatePackageResult>;
+    /** Sell an x402 API (origin or one 402 URL) — live-probed, sponsored. */
+    listEndpoint(endpoint: string, opts?: {
+        primary?: string;
+    }): Promise<EndpointListing>;
+    /** Clear the x402 listing. */
+    removeEndpoint(): Promise<EndpointListing>;
+    /** `#93` · `@handle` · `name.sui` · `0x…` → wallet (marketplace refs only). */
+    resolveRef(q: string): Promise<AgentRef>;
+}
+
+/** The exact bytes the service rail hashes — `JSON.stringify(payload)`,
+ *  key order as given (the server hashes the payload it receives). */
+declare function servicePayloadSha256(payload: unknown): Promise<string>;
+declare function profileChallengeMessage(nonce: string): string;
+declare function serviceChallengeMessage(nonce: string, payloadHash: string): string;
+/** One fresh nonce for `address`. */
+declare function fetchChallengeNonce(apiBase: string, address: string): Promise<string>;
+/** Nonce → signed message → `{ nonce, signature }` ready to POST. */
+declare function signChallenge(apiBase: string, signer: TransactionSigner, message: (nonce: string) => string | Promise<string>): Promise<{
+    nonce: string;
+    signature: string;
+}>;
+
+type PrepareBody = {
+    nonce?: string;
+    txBytes?: string;
+    probe?: EndpointListing['probe'];
+    origin?: string | null;
+    primary?: {
+        path?: string;
+        url?: string;
+    } | null;
+    routes?: EndpointRoute[];
+    issues?: EndpointIssue[];
+};
+/** The probe findings as the lines the CLI prints — origin expands carry
+ *  per-route findings, single probes the flat issue list. */
+declare function endpointIssueLines(prep: PrepareBody): string[];
+/** List an API origin (expands via {origin}/openapi.json) or one 402 URL. */
+declare function listEndpoint(apiBase: string, signer: TransactionSigner, endpoint: string, opts?: {
+    primary?: string;
+}): Promise<EndpointListing>;
+/** Clear the listing (registry update with an empty endpoint). */
+declare function removeEndpoint(apiBase: string, signer: TransactionSigner): Promise<EndpointListing>;
+
+/** The wire payload for an upsert — key order is the signed bytes, so it
+ *  is fixed here and nowhere else. */
+declare function serviceUpsertPayload(input: ServiceUpsertInput): Record<string, unknown>;
+declare function upsertService(apiBase: string, signer: TransactionSigner, input: ServiceUpsertInput): Promise<ServiceWriteResult>;
+declare function retireService(apiBase: string, signer: TransactionSigner, slug: string): Promise<ServiceWriteResult>;
+
+/** The three upsert payload inputs for a package, Basic → Premium (pure —
+ *  unit-pinned; `createPackage` only adds the signer). */
+declare function planPackage(input: CreatePackageInput): {
+    base: string;
+    tiers: {
+        tier: ServiceTier;
+        slug: string;
+        input: Parameters<typeof upsertService>[2];
+    }[];
+};
+declare function createPackage(apiBase: string, signer: TransactionSigner, input: CreatePackageInput): Promise<CreatePackageResult>;
+
+/** The API's slug grammar: 2–48 chars of [a-z0-9-], alphanumeric first. */
+declare const SERVICE_SLUG_RE: RegExp;
+/** Strip leading/trailing dashes in linear time (a `^-+|-+$` regex is
+ *  polynomial on dash runs — CodeQL js/polynomial-redos). */
+declare function trimDashes(s: string): string;
+/** The API's slug cap (SERVICE_SLUG_RE: 2–48 chars). */
+declare const MAX_SLUG_LENGTH = 48;
+/** Lowercase kebab, edge dashes trimmed, NO length cap — the input to BOTH
+ *  budgets below. */
+declare function slugifyUnbounded(name: string): string;
+/** Single-listing (loner) slug — the full 48-char budget. */
+declare function slugifyLoner(name: string): string;
+/** The CLI's name → slug rule for LONERS (`t2 service create`): lowercase,
+ *  runs of non-alphanumerics → `-`, trimmed, 48-char cap. Loner-only — a
+ *  package base must come from `packageBaseFromName`, never from this. */
+declare function slugify(name: string): string;
+/** `{base}-standard` is the longest tier slug; slugs cap at 48 chars, so a
+ *  package base may be at most 48 - "-standard".length. */
+declare const MAX_TIER_BASE_LENGTH: number;
+declare function parseServiceTierSlug(slug: string): {
+    base: string;
+    tier: ServiceTier;
+} | null;
+/** Truncate a slugified name into a valid package base (trailing dashes
+ *  shed so `{base}-basic` never carries `--`). Empty in → empty out —
+ *  callers validate. */
+declare function packageBaseSlug(slugified: string): string;
+/** Package base from a display name — unbounded kebab, THEN the tier-base
+ *  budget (trailing dashes shed), so every `{base}-{tier}` is a valid slug
+ *  with its suffix intact. Mirrors console `packageBaseFromName`. */
+declare function packageBaseFromName(name: string): string;
+/** The three tier slugs for a base, Basic → Standard → Premium. */
+declare function packageTierSlugs(base: string): {
+    tier: ServiceTier;
+    slug: string;
+}[];
+
+declare function parseAgentCategory(raw: string): string;
+declare function updateProfile(apiBase: string, signer: TransactionSigner, input: ProfileUpdateInput): Promise<{
+    address: string;
+}>;
+/** The seller category gate: `category` given → set it (signed, no gas);
+ *  otherwise the live profile category satisfies the gate; neither → a
+ *  precise refusal naming both fixes. */
+declare function ensureCategory(apiBase: string, signer: TransactionSigner, category?: string): Promise<string>;
+
+declare function registerAgent(apiBase: string, signer: TransactionSigner): Promise<RegisterResult>;
+
+/** The resolve URL for a ref (pure — unit-pinned). */
+declare function agentResolveUrl(q: string, apiBase?: string): string;
+/** Resolve an agent ref to its wallet. Throws `T2000Error` with the server's
+ *  own sentence on a miss, so every surface explains it identically. */
+declare function resolveAgentRef(q: string, apiBase?: string): Promise<AgentRef>;
+/** The public profile row (GET /v1/agents/:address). Null when the address
+ *  is not a registered Agent ID. */
+declare function getAgentProfile(address: string, apiBase?: string): Promise<AgentProfile | null>;
+
 /** The shared `Opening` object minted by an Open post. */
 declare const OPENING_TYPE_MARKER = "::opening::Opening<";
 /** The escrow `Job` object minted by a hire or an Open claim. */
@@ -1172,4 +1453,4 @@ declare function fullHandle(label: string, parentName?: string): string;
  */
 declare function displayHandle(label: string, parentName?: string): string;
 
-export { AUDRIC_PARENT, AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type ApiModel, type AppenderContext, BalanceResponse, type BuildAddLeafParams, type BuildRevokeLeafParams, type ChatMessage, type ChatParams, type ChatResult, type ChatUsage, type ComposeTxOptions, type ComposeTxResult, DEFAULT_API_BASE, type DailySpend, DepositInfo, ESCROW_JOB_TYPE_MARKER, InvalidAddressError, type LabelValidationResult, type LimitAssertInput, LimitEnforcer, LimitExceededError, type LimitKind, type LimitOperation, type LimitsConfig, type LimitsFile, type NormalizedAddress, OPENING_TYPE_MARKER, type OpenJobFilter, type OpenJobRow, type OpenJobsPage, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SendResult, type SendTransferInput, SendableAsset, SerializedCetusRoute, type SponsoredTxGuard, type StepPreview, SuinsNotRegisteredError, type SuinsParent, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, WRITE_APPENDER_REGISTRY, type WriteStep, type WriteToolName, X402Probe, ZkLoginProof, approxUsdValue, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, cancelOpenJob, canonicalizeRecipientInput, chatCompletion, chatCompletionStream, claimOpenJob, clearLimits, composeTx, customHireEnvelope, dailySpentToday, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fullHandle, generateKeypair, getAddress, getLimits, getOpenJob, getSponsoredSwapProviders, getSwapQuote, hasLimits, isCustomHireEnvelope, keypairFromPrivateKey, listModels, listOpenJobs, loadKey, looksLikeSuiNs, normalizeAddressInput, postOpenJob, queryBalance, readLimitsFile, recordDailySpend, refundOpenJob, resolveAddressToSuinsViaRpc, resolveCreatedObjectId, resolveSuinsViaRpc, saveBech32, saveKey, setLimits, setSponsoredTxGuard, submitJobReview, validateLabel, walletExists, writeLimitsFile };
+export { AGENT_CATEGORIES, AUDRIC_PARENT, AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AgentCategory, type AgentProfile, type AgentRef, type ApiModel, type AppenderContext, BalanceResponse, type BuildAddLeafParams, type BuildRevokeLeafParams, type ChatMessage, type ChatParams, type ChatResult, type ChatUsage, CommerceClient, type CommerceClientOptions, type ComposeTxOptions, type ComposeTxResult, type CreatePackageInput, type CreatePackageResult, DEFAULT_API_BASE, type DailySpend, DepositInfo, ESCROW_JOB_TYPE_MARKER, type EndpointIssue, type EndpointListing, type EndpointRoute, InvalidAddressError, type LabelValidationResult, type LimitAssertInput, LimitEnforcer, LimitExceededError, type LimitKind, type LimitOperation, type LimitsConfig, type LimitsFile, MAX_SLUG_LENGTH, MAX_TIER_BASE_LENGTH, type NormalizedAddress, OPENING_TYPE_MARKER, type OpenJobFilter, type OpenJobRow, type OpenJobsPage, OverlayFeeConfig, type PackageTierInput, PayOptions, PayResult, PaymentRequest, type ProfileUpdateInput, type RegisterResult, SERVICE_SLUG_RE, SERVICE_TIERS, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SendResult, type SendTransferInput, SendableAsset, SerializedCetusRoute, type ServiceTier, type ServiceUpsertInput, type ServiceWriteResult, type SponsoredTxGuard, type StepPreview, SuinsNotRegisteredError, type SuinsParent, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, WRITE_APPENDER_REGISTRY, type WriteStep, type WriteToolName, X402Probe, ZkLoginProof, agentResolveUrl, approxUsdValue, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, cancelOpenJob, canonicalizeRecipientInput, chatCompletion, chatCompletionStream, claimOpenJob, clearLimits, composeTx, createPackage, customHireEnvelope, dailySpentToday, deriveAllowedAddressesFromPtb, displayHandle, endpointIssueLines, ensureCategory, exportPrivateKey, fetchChallengeNonce, fullHandle, generateKeypair, getAddress, getAgentProfile, getLimits, getOpenJob, getSponsoredSwapProviders, getSwapQuote, hasLimits, isCustomHireEnvelope, keypairFromPrivateKey, listEndpoint, listModels, listOpenJobs, loadKey, looksLikeSuiNs, normalizeAddressInput, packageBaseFromName, packageBaseSlug, packageTierSlugs, parseAgentCategory, parseServiceTierSlug, planPackage, postOpenJob, profileChallengeMessage, queryBalance, readLimitsFile, recordDailySpend, refundOpenJob, registerAgent, removeEndpoint, resolveAddressToSuinsViaRpc, resolveAgentRef, resolveCreatedObjectId, resolveSuinsViaRpc, retireService, saveBech32, saveKey, serviceChallengeMessage, servicePayloadSha256, serviceUpsertPayload, setLimits, setSponsoredTxGuard, signChallenge, slugify, slugifyLoner, slugifyUnbounded, submitJobReview, trimDashes, updateProfile, upsertService, validateLabel, walletExists, writeLimitsFile };