@codespar/types - npm Package Compare versions

Comparing version 0.1.0 to 0.7.0

dist/types.d.ts

@@ -13,2 +13,82 @@ export interface SessionBase {
     authorize(serverId: string, config: AuthConfig): Promise<AuthResult>;
+    /**
+     * Search the catalog for a tool that matches a free-form use case.
+     * Typed wrapper around `execute("codespar_discover", {...})` — same
+     * wire shape, returns `DiscoverResult` instead of generic ToolResult
+     * so the agent doesn't have to cast.
+     */
+    discover(useCase: string, options?: DiscoverOptions): Promise<DiscoverResult>;
+    /**
+     * Surface the connection wizard for a server (or list every server's
+     * status). Typed wrapper around
+     * `execute("codespar_manage_connections", {...})`. Returns the
+     * wizard payload directly — UI components like ConnectionWizardCard
+     * render this without further parsing.
+     */
+    connectionWizard(options: ConnectionWizardOptions): Promise<ConnectionWizardResult>;
+    /**
+     * Create an INBOUND charge — the buyer pays the merchant. Typed
+     * wrapper around `execute("codespar_charge", {...})`. Distinct from
+     * the legacy `codespar_pay` rail, which routes to outbound
+     * transfers / payouts. Routes to providers that issue charges
+     * (Asaas create_payment, MP create_payment, Stripe payment_intent).
+     *
+     * `amount` is in MAJOR currency units (R$ 125.00 → 125). The
+     * provider receives whatever shape it expects (Asaas + MP take
+     * decimal major units; Stripe takes minor units — the backend
+     * transform converts).
+     */
+    charge(args: ChargeArgs): Promise<ChargeResult>;
+    /**
+     * Async settlement check. After a meta-tool payment call returns,
+     * the upstream provider eventually fires a webhook that lands in
+     * `events`. This method correlates a tool_call back to the latest
+     * known status (pending → succeeded / failed / refunded). Generic
+     * across providers — relies on the `idempotency_key` propagated
+     * upstream + the `external_reference` field on the normalized event
+     * payload. Returns `unknown` when the tool_call has no
+     * idempotency_key (legacy / non-meta-tool calls).
+     */
+    paymentStatus(toolCallId: string): Promise<PaymentStatusResult>;
+    /**
+     * SSE-streamed sibling of `paymentStatus`. Opens a long-lived
+     * connection and invokes `onUpdate` whenever the backend pushes a
+     * new envelope (initial snapshot + every state change). Resolves
+     * when the backend closes the stream — typically 5s after a
+     * terminal state (succeeded / failed / refunded). The optional
+     * `signal` cancels the stream from the caller side; the backend
+     * sees it as a normal client disconnect and tears its loop down.
+     * Falls back to native `fetch` streaming; no extra deps. The
+     * polling sibling (`paymentStatus`) stays live for backward compat.
+     */
+    paymentStatusStream(toolCallId: string, options: PaymentStatusStreamOptions): Promise<PaymentStatusResult>;
+    /**
+     * Async KYC poll. After a `codespar_kyc` call returns, the buyer
+     * completes the hosted flow off-platform; provider webhooks (or
+     * operator polling) update the verification state asynchronously.
+     * This method correlates a tool_call back to the latest known
+     * disposition (pending → approved / rejected / review / expired).
+     * Generic across providers — same idempotency_key ↔
+     * external_reference correlation as `paymentStatus`. Returns
+     * `unknown` when the tool_call has no idempotency_key (legacy /
+     * non-meta-tool calls).
+     */
+    verificationStatus(toolCallId: string): Promise<VerificationStatusResult>;
+    /**
+     * SSE-streamed sibling of `verificationStatus`. Same lifecycle as
+     * `paymentStatusStream`: snapshot on open, an update per state
+     * change, auto-close 5s after a terminal disposition (approved /
+     * rejected / expired). `signal` aborts from the caller side.
+     * Polling sibling (`verificationStatus`) stays live.
+     */
+    verificationStatusStream(toolCallId: string, options: VerificationStatusStreamOptions): Promise<VerificationStatusResult>;
+    /**
+     * Generate a shipping label OR fetch tracking status. Typed wrapper
+     * around `execute("codespar_ship", {...})`. Routes to Melhor Envio
+     * (BR domestic — Correios + private carriers) by default; international
+     * carriers ship under a unified `{origin, destination, items}` envelope
+     * as additional rails come online. The agent passes a neutral shape and
+     * the router picks the cheapest carrier per request.
+     */
+    ship(args: ShipArgs): Promise<ShipResult>;
     mcp?: {
@@ -19,2 +99,249 @@ url: string;
 }
+/**
+ * Inbound charge — the buyer pays the merchant. Mirrors the backend's
+ * MetaChargeArgs (codespar-enterprise) so the wire payload matches
+ * byte-for-byte. The discriminator vs `codespar_pay` (outbound) is
+ * the `buyer` object: a charge always carries customer-facing buyer
+ * details because the charge is owned by the merchant and presented
+ * to the buyer.
+ */
+export interface ChargeBuyer {
+    name: string;
+    email?: string;
+    document?: string;
+    phone?: string;
+}
+export interface ChargeArgs {
+    /** Amount in MAJOR currency units (R$ 125.00 → 125). */
+    amount: number;
+    /** ISO-4217 currency code (BRL, USD, EUR). */
+    currency: string;
+    /** Payment method: pix, boleto, card. */
+    method: "pix" | "boleto" | "card";
+    /** Charge description shown to the buyer. */
+    description: string;
+    /** Buyer details (always required — charges are merchant-issued). */
+    buyer: ChargeBuyer;
+    /** ISO 8601 due date (boleto / Pix expiration). */
+    due_date?: string;
+}
+export interface ChargeResult {
+    id: string;
+    status: string;
+    amount: number;
+    currency: string;
+    method: string;
+    /** Hosted payment URL when the provider issues one (Asaas
+     *  invoiceUrl, MP ticket_url, Stripe redirect). */
+    charge_url?: string;
+    pix_qr_code?: string;
+    pix_copy_paste?: string;
+    raw?: unknown;
+}
+/**
+ * Shipping args. Three actions over a unified address+items envelope:
+ *   - label  Generate a shipping label (issues a tracking code)
+ *   - quote  Calculate carrier rates for a route + items
+ *   - track  Fetch current tracking status for a shipment
+ *
+ * Mirrors the backend's MetaShipArgs (codespar-enterprise) so the wire
+ * payload matches byte-for-byte. Operator overrides (Melhor Envio
+ * service ids, NFe access keys for declared-value shipments) flow
+ * through `metadata`.
+ */
+export interface ShipAddress {
+    postal_code: string;
+    city?: string;
+    state?: string;
+    country?: string;
+    line_1?: string;
+    number?: string;
+}
+export interface ShipItem {
+    description?: string;
+    weight_g: number;
+    width_cm?: number;
+    height_cm?: number;
+    length_cm?: number;
+    quantity?: number;
+    declared_value?: number;
+}
+export interface ShipArgs {
+    /** label | track | quote. */
+    action: "label" | "track" | "quote";
+    /** Sender address (required for action=label|quote). */
+    origin?: ShipAddress;
+    /** Recipient address (required for action=label|quote). */
+    destination?: ShipAddress;
+    /** Items to ship — each with weight_g + dimensions. Required for
+     *  action=label|quote. */
+    items?: ShipItem[];
+    /** fastest | cheapest | standard. Default: cheapest. */
+    service_level?: "fastest" | "cheapest" | "standard";
+    /** Required for action=track. */
+    tracking_code?: string;
+    /** Provider-specific overrides (Melhor Envio service_id, NFe key for
+     *  declared-value shipments, etc). */
+    metadata?: Record<string, unknown>;
+}
+export interface ShipResult {
+    id: string;
+    status: string;
+    tracking_code?: string;
+    label_url?: string;
+    carrier?: string;
+    estimated_delivery?: string;
+    cost_minor?: number;
+    raw?: unknown;
+}
+export type PaymentStatus = "pending" | "succeeded" | "failed" | "refunded" | "updated" | "unknown";
+export interface PaymentStatusEvent {
+    event_type: string;
+    received_at: string;
+    provider: string | null;
+    provider_action: string | null;
+    payment_id: string | null;
+}
+export interface PaymentStatusResult {
+    tool_call_id: string;
+    payment_status: PaymentStatus;
+    /** Null for legacy / non-meta-tool calls that didn't propagate a
+     *  key upstream. */
+    idempotency_key: string | null;
+    /** The execute-time status (success/error). The asynchronous
+     *  payment_status above is independent — a successful execute can
+     *  still be pending settlement, and a settled payment can be later
+     *  refunded. */
+    original_status: string;
+    events: PaymentStatusEvent[];
+}
+/** Options for `Session.paymentStatusStream`. The callback receives
+ *  the SAME envelope shape as `paymentStatus()` returns — call sites
+ *  can render incremental UI off the same parser they already wrote.
+ *  The promise resolves with the LAST envelope seen, so callers that
+ *  only care about the terminal disposition can `await` it without
+ *  wiring `onUpdate`. */
+export interface PaymentStatusStreamOptions {
+    onUpdate?: (envelope: PaymentStatusResult) => void;
+    signal?: AbortSignal;
+}
+/**
+ * KYC polling analog of PaymentStatus. After `codespar_kyc` returns,
+ * the buyer completes the hosted flow asynchronously (Persona inquiry,
+ * Sift scoring, Konduto / Truora review). Webhooks normalize into
+ * `commerce.kyc.*` events; this status is the latest known
+ * disposition.
+ *
+ * Priority: approved > rejected > review > expired > pending > unknown.
+ */
+export type VerificationStatus = "pending" | "approved" | "rejected" | "expired" | "review" | "unknown";
+export interface VerificationStatusEvent {
+    event_type: string;
+    received_at: string;
+    provider: string | null;
+    verification_id: string | null;
+}
+export interface VerificationStatusResult {
+    tool_call_id: string;
+    verification_status: VerificationStatus;
+    /** Null for legacy / non-meta-tool calls that didn't propagate a
+     *  key upstream. */
+    idempotency_key: string | null;
+    /** The execute-time status (success/error). The asynchronous
+     *  verification_status above is independent — a successful execute
+     *  only means the verification was created with the provider; the
+     *  buyer still has to complete the hosted flow. */
+    original_status: string;
+    /** Buyer-facing verification URL (Persona inquiry, Truora link).
+     *  Null for server-side scoring rails (Sift, Konduto risk-score)
+     *  that have no hosted flow, or when the originating tool_call's
+     *  output didn't surface the field. Best-effort — pulled from the
+     *  call's stored output JSON. */
+    hosted_url: string | null;
+    events: VerificationStatusEvent[];
+}
+/** Options for `Session.verificationStatusStream`. Same shape as
+ *  `PaymentStatusStreamOptions` — `onUpdate` receives the typed
+ *  envelope on every state change; `signal` cancels the stream;
+ *  the promise resolves with the last envelope observed. */
+export interface VerificationStatusStreamOptions {
+    onUpdate?: (envelope: VerificationStatusResult) => void;
+    signal?: AbortSignal;
+}
+export interface DiscoverOptions {
+    category?: string;
+    country?: string;
+    /** Max related results returned. Clamped 1..20 server-side. */
+    limit?: number;
+}
+export interface DiscoverToolMatch {
+    server_id: string;
+    tool_name: string;
+    description: string;
+    http_method: string;
+    endpoint_template: string;
+    cosine_distance: number | null;
+    trigram_similarity: number | null;
+    connection_status: "connected" | "disconnected" | "not_required";
+    known_pitfalls: string[];
+    recommended_plan: DiscoverPlanStep[];
+}
+export interface DiscoverPlanStep {
+    step: string;
+    description?: string;
+    prereq?: boolean;
+    action?: boolean;
+}
+export interface DiscoverResult {
+    use_case: string;
+    /** Which path served the result. embedding > trigram in quality. */
+    search_strategy: "embedding" | "trigram" | "empty";
+    recommended: DiscoverToolMatch | null;
+    related: DiscoverToolMatch[];
+    next_steps: string[];
+}
+export interface ConnectionWizardOptions {
+    /** Defaults to "status" when server_id is given, else "list". */
+    action?: "list" | "status" | "initiate";
+    server_id?: string;
+    country?: string;
+    environment?: "live" | "test";
+    /** Path inside the dashboard to redirect to after the user finishes
+     *  connecting (initiate only). Validated to /dashboard/* on the
+     *  dashboard side. */
+    return_to?: string;
+}
+export interface ConnectionStatusRow {
+    server_id: string;
+    display_name: string;
+    auth_type: string;
+    status: "connected" | "disconnected" | "not_required" | "expired";
+    difficulty: "easy" | "medium" | "hard";
+    connection_metadata: Record<string, unknown>;
+    connected_at: string | null;
+}
+export interface ConnectionWizardInstructions {
+    server_id: string;
+    display_name: string;
+    auth_type: string;
+    difficulty: "easy" | "medium" | "hard";
+    status: ConnectionStatusRow["status"];
+    connect_url: string;
+    instructions: string[];
+    required_secrets: Array<{
+        name: string;
+        hint?: string;
+    }>;
+    known_pitfalls: string[];
+    next_action: string;
+}
+export interface ConnectionWizardResult {
+    action: "list" | "status" | "initiate";
+    /** Populated for action=list. */
+    connections: ConnectionStatusRow[];
+    /** Populated for action=status. */
+    status: ConnectionStatusRow | null;
+    /** Populated for action=initiate. */
+    initiate: ConnectionWizardInstructions | null;
+}
 export type BaseConnection = {
@@ -21,0 +348,0 @@ id: string;

dist/types.d.ts.map

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

package.json

 {
   "name": "@codespar/types",
-  "version": "0.1.0",
+  "version": "0.7.0",
   "description": "Shared session interface contract for codespar runtimes",
@@ -5,0 +5,0 @@ "type": "module",

README.md

@@ -79,2 +79,5 @@ # @codespar/types
 | `AuthResult` | Return value of `authorize()` — `linkToken`, `authorizeUrl`, `expiresAt` |
+| `DiscoverOptions` / `DiscoverResult` / `DiscoverToolMatch` / `DiscoverPlanStep` | Wire shapes for `session.discover(...)` (F3.M2 `codespar_discover`) |
+| `ConnectionWizardOptions` / `ConnectionWizardResult` / `ConnectionStatusRow` | Wire shapes for `session.connectionWizard(...)` (F3.M2 `codespar_manage_connections`) |
+| `PaymentStatus` / `PaymentStatusResult` / `PaymentStatusEvent` | Wire shapes for `session.paymentStatus(toolCallId)` — async webhook correlation |
 
@@ -107,4 +110,8 @@ ## Conformance testing
 
+## Need more?
+
+Need governance, budget limits, and audit trails for agent payments? **[CodeSpar Enterprise](https://codespar.dev/enterprise)** adds policy engine, payment routing, and compliance templates on top of these MCP servers.
+
 ## License
 
 MIT — [codespar.dev](https://codespar.dev)

No alert changes

Improved metrics

Total package byte prevSize

51550

63%

Lines of code

716

84.06%

Number of lines in readme file

116

6.42%

No dependency changes