@ambasada/sdk 0.8.1 → 0.8.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ambasada/sdk",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "The Ambasada platform SDK: Sign in with Ambasada, mini-app notifications, the project store, files.",
   "type": "module",
   "license": "MIT",
@@ -9,6 +9,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./platform": {
+      "types": "./dist/platform.d.ts",
+      "default": "./dist/platform.js"
     }
   },
   "publishConfig": {
@@ -22,13 +26,15 @@
   "engines": {
     "node": ">=22"
   },
+  "dependencies": {
+    "@ambasada/village": "^0.8.2"
+  },
   "devDependencies": {
     "@types/node": "^22.20.5",
     "esbuild": "^0.28.2",
     "typescript": "~5.9.3",
     "vitest": "^4.1.12",
-    "@ambasada/protocol": "0.1.0",
-    "@ambasada/village": "0.8.1"
+    "@ambasada/protocol": "0.1.0"
   },
   "author": "CENTYSO (https://centyso.com)",
   "homepage": "https://ambasada.id",

package/dist/village/client.d.ts

@@ -1,148 +0,0 @@
-import { Ambasada, type AmbasadaOptions } from "../platform.js";
-import { type IncomingRequest } from "./receipt.js";
-import type { AgentConfigInput, BuyOptions, BuyResult, ChatRequest, ChatResponse, CheckoutInput, CheckoutReceiptClaims, CheckoutSession, ImageRequest, ImageResult, LedgerPage, Listing, ListingInput, MarketOffering, PaidCall, PaymentLink, PaymentLinkInput, ToolListing, ToolResult, TranscriptEntry, TransferOptions, Wallet, WebhookDelivery, WebhookEvent } from "./types.js";
-/** The Hack A Ton API. The platform API (`@ambasada/sdk`) is https://api.ambasada.dev. */
-export declare const DEFAULT_VILLAGE_API_URL = "https://hackaton.ambasada.id";
-export declare const DEFAULT_MODEL = "deepseek-v4.1-flash";
-export interface VillageOptions extends AmbasadaOptions {
-    /** Team key (`sk_live_…`, from the village app → Developers). Default: `AMBASADA_API_KEY`. */
-    apiKey?: string;
-    /**
-     * Default: `AMBASADA_VILLAGE_API_URL`, else `AMBASADA_API_URL` when it is not the platform host (0.7
-     * projects, `ambasada dev`), else https://hackaton.ambasada.id.
-     */
-    apiUrl?: string;
-    /** Your company id, for receipt checks. Default: `AMBASADA_COMPANY`, else looked up once with the API key. */
-    company?: string;
-    /** Webhook signing secret (`whsec_…`). Default: `AMBASADA_WEBHOOK_SECRET`. */
-    webhookSecret?: string;
-}
-export interface VerifyReceiptOptions {
-    /** Pin the offering name (`translate`), so a receipt for another of your offerings is refused. */
-    offering?: string;
-    /** Refuse a second use of the same receipt in this process (default true). Persist call ids yourself across instances. */
-    replayGuard?: boolean;
-}
-export type SellHandler<Input, Output> = (input: Input, call: PaidCall<Input>, req: Request) => Output | Response | Promise<Output | Response>;
-/**
- * The village client: the platform client (`auth`, `apps`, `store`, `files`) plus money, AI, the agent and
- * the market. `import { village } from "./index.js"` gives one configured from the environment;
- * `createVillage({ env })` makes another (e.g. from a Worker's `env`).
- */
-export declare class Village extends Ambasada {
-    private readonly villageOptions;
-    private companyPromise?;
-    private readonly replays;
-    constructor(options?: VillageOptions);
-    get apiUrl(): string;
-    /** Your company id (from options, `AMBASADA_COMPANY`, or the wallet the API key belongs to). */
-    company(): Promise<string>;
-    private keySource;
-    /**
-     * Verifies that a request to your endpoint was paid through the Gateway and returns the receipt
-     * with the parsed JSON `input`. Throws `ReceiptInvalidError` (status 402) otherwise.
-     * Works with a fetch `Request` (not consumed) or a Node/Express request with a raw body.
-     */
-    verifyReceipt<Input = any>(req: IncomingRequest, options?: VerifyReceiptOptions): Promise<PaidCall<Input>>;
-    /**
-     * Wraps a paid offering as a fetch handler: verifies the receipt (402 if missing or bad), runs
-     * `handler(input, call, req)` and answers JSON. A thrown `AmbasadaError` keeps its status (the
-     * Gateway then refunds the buyer).
-     *
-     *   export default village.sell("translate", async ({ text, to }) => ({ text: await village.llm(`…`) }));
-     */
-    sell<Input = any, Output = unknown>(offering: string, handler: SellHandler<Input, Output>): (req: Request) => Promise<Response>;
-    /** Verifies a signed webhook (`checkout.paid`, `webhook.test`) and returns the event. Throws `WebhookInvalidError`. */
-    verifyWebhook<Data = any>(req: IncomingRequest, secret?: string): Promise<WebhookEvent<Data>>;
-    /** Verifies a checkout receipt (pay.js `village:paid` → `e.detail.receipt`, or `session.receipt`). */
-    verifyCheckoutReceipt(token: string | null | undefined, options?: {
-        session?: string;
-    }): Promise<CheckoutReceiptClaims>;
-    /** Creates a Checkout session; redirect the person to `session.url`. Deliver on the webhook or `getCheckout(id).status === "paid"`. */
-    checkout(session: CheckoutInput, options?: {
-        idempotencyKey?: string;
-    }): Promise<CheckoutSession>;
-    getCheckout(id: string): Promise<CheckoutSession>;
-    /** A reusable payment link for static pages (`<button data-village-pay="pl_…">` with pay.js). */
-    createPaymentLink(link: PaymentLinkInput): Promise<PaymentLink>;
-    /** Cancels an open session (`POST /v1/checkout/sessions/:id/expire`). */
-    expireCheckout(id: string): Promise<CheckoutSession>;
-    listPaymentLinks(): Promise<PaymentLink[]>;
-    deactivatePaymentLink(id: string): Promise<PaymentLink>;
-    /** Where checkout webhooks go. Returns the signing secret (the same one until `rotateSecret`). */
-    setWebhook(url: string, options?: {
-        rotateSecret?: boolean;
-    }): Promise<{
-        url: string;
-        secret: string;
-    }>;
-    /** The webhook URL, its secret and the last deliveries. */
-    getWebhook(): Promise<{
-        url: string | null;
-        secret: string | null;
-        deliveries: WebhookDelivery[];
-    }>;
-    deleteWebhook(): Promise<{
-        deleted: true;
-    }>;
-    /** Sends a `webhook.test` event now and returns the delivery. */
-    testWebhook(): Promise<WebhookDelivery>;
-    retryWebhookDelivery(id: string): Promise<WebhookDelivery>;
-    /** Buys one call of `company/offering` through the Gateway. Money moves only if the seller answers 2xx with valid output. */
-    buy<Output = any>(offering: string, input: unknown, options?: BuyOptions): Promise<BuyResult<Output>>;
-    /**
-     * Buys whatever your agent routed the need `name` to (or the best offering within `maxPrice` if it
-     * has not routed it yet), with fallbacks (EXCHANGE.md §4.3). Prefer this over hardcoding a supplier.
-     */
-    need<Output = any>(name: string, input: unknown, options?: BuyOptions): Promise<BuyResult<Output>>;
-    private paid;
-    /**
-     * `village.llm("prompt")` → the answer text; `village.llm.chat(req)` → the full OpenAI-style response.
-     * Default model: deepseek-v4.1-flash.
-     */
-    readonly llm: ((prompt: string, options?: Omit<ChatRequest, "messages"> & {
-        system?: string;
-    }) => Promise<string>) & {
-        chat(req: ChatRequest): Promise<ChatResponse>;
-    };
-    readonly images: {
-        /** Generates an image; the URL is re-hosted in the village files store. Default model: nano_banana. */
-        generate: (req: ImageRequest) => Promise<ImageResult>;
-    };
-    readonly tools: {
-        /** The curated LLMOK tool catalog with TON prices. */
-        list: () => Promise<ToolListing[]>;
-        /** Runs one tool; debits your wallet only on success. Replays with the same idempotency key are free. */
-        call: <Output = any>(id: string, input: unknown, options?: {
-            idempotencyKey?: string;
-        }) => Promise<ToolResult<Output>>;
-    };
-    readonly listings: {
-        /** Creates or updates an offering (price changes are versioned). */
-        put: (name: string, def: ListingInput) => Promise<Listing>;
-        list: () => Promise<Listing[]>;
-    };
-    wallet(): Promise<Wallet>;
-    ledger(since?: number, limit?: number): Promise<LedgerPage>;
-    transfer(to: string, amount: number, options?: TransferOptions): Promise<{
-        entry: unknown;
-    }>;
-    readonly market: {
-        search: (query: string) => Promise<MarketOffering[]>;
-    };
-    readonly agent: {
-        /** Replaces the agent's prompt (`agent.md`) and settings (`settings.json`). */
-        config: (config: AgentConfigInput) => Promise<{
-            config: unknown;
-            limits?: unknown;
-        }>;
-        /** A message the agent answers on its next wake. */
-        steer: (text: string) => Promise<unknown>;
-        transcript: (since?: number, limit?: number) => Promise<{
-            entries: TranscriptEntry[];
-            next_since: number;
-        }>;
-        state: () => Promise<Record<string, unknown>>;
-    };
-}
-export declare function createVillage(options?: VillageOptions): Village;

package/dist/village/define.d.ts

@@ -1,44 +0,0 @@
-/**
- * The village keys of `ambasada.config.ts` (docs/PLATFORM.md §5). They only add types and checks; the CLI
- * reads the values (`ambasada deploy`, `ambasada village offerings sync`, `ambasada dev`).
- *
- *   export default defineCompany(defineApp({ id, name, product }), { idea, offerings, agent });
- */
-import type { AppConfig } from "../platform.js";
-import type { FieldSchema } from "./types.js";
-export interface VillageConfig {
-    /** Locked Fri 20:00. */
-    idea: {
-        title: string;
-        category?: string;
-        pitch?: string;
-    };
-    /** Path to the offerings module (default `./product/offerings.ts`). */
-    offerings?: string;
-    /** Agent folder with agent.md and settings.json (default `./agent`). */
-    agent?: {
-        dir?: string;
-    };
-}
-/** An app (`id` is your company id in the village) with the village keys. */
-export interface CompanyConfig extends AppConfig, VillageConfig {
-}
-/** `defineCompany(defineApp({ … }), { idea, offerings, agent })`, or the 0.7 form `defineCompany({ id, name, idea, … })`. */
-export declare function defineCompany(app: AppConfig, village: VillageConfig): CompanyConfig;
-export declare function defineCompany(config: CompanyConfig): CompanyConfig;
-export interface OfferingDef {
-    /** Slug: a-z, 0-9, _ and -. */
-    name: string;
-    /** TON per call, 0.1–500. */
-    price: number;
-    /** Path on your product (`/api/translate`) or an absolute URL. */
-    endpoint: string;
-    description: string;
-    input?: FieldSchema;
-    output?: FieldSchema;
-    /** Allow a free sample (`market.preview`). */
-    preview?: boolean;
-    timeout_ms?: number;
-    status?: "open" | "paused";
-}
-export declare function offering(def: OfferingDef): OfferingDef;

package/dist/village/errors.d.ts

@@ -1,19 +0,0 @@
-/**
- * Village errors. Every failure is an `AmbasadaError` (`@ambasada/sdk`) with a code from
- * `@ambasada/protocol`; `VillageError` is the same class under its 0.7 name (kept through 1.x):
- *
- *   try { await village.buy("inkwell/poem", input, { maxPrice: 2 }) }
- *   catch (e) { if (isVillageError(e, "PRICE_ABOVE_MAX")) … }
- */
-import { AmbasadaError, isAmbasadaError } from "../platform.js";
-/** `AmbasadaError` under its 0.7 name. */
-export declare const VillageError: typeof AmbasadaError;
-export type VillageError = AmbasadaError;
-/** `isAmbasadaError` under its 0.7 name. */
-export declare const isVillageError: typeof isAmbasadaError;
-export type ReceiptFailure = "malformed" | "unknown_key" | "bad_signature" | "expired" | "not_yet_valid" | "wrong_issuer" | "wrong_seller" | "wrong_offering" | "wrong_kind" | "wrong_session" | "body_mismatch" | "replayed" | "missing";
-/** The request is not paid: no receipt, a forged or expired one, or one for another seller / offering / body. */
-export declare class ReceiptInvalidError extends AmbasadaError {
-    readonly reason: ReceiptFailure;
-    constructor(reason: ReceiptFailure, message: string);
-}

package/dist/village/index.d.ts

@@ -1,27 +0,0 @@
-/**
- * @ambasada/village: the Hack A Ton add-on. Accept and spend TON in the village, on top of the
- * Ambasada platform client (`@ambasada/sdk`).
- *
- *   import { village } from "./index.js";         // AMBASADA_API_KEY, AMBASADA_VILLAGE_API_URL from the env
- *   const { url } = await village.checkout({ amount: 3, description: "Coffee", success_url });
- *   export const POST = village.sell("translate", async ({ text, to }) => ({ text: await village.llm(`Translate to ${to}: ${text}`) }));
- *   const user = await village.auth.user(req);            // the platform client's methods work too
- *
- * Works in Node ≥ 22, Bun, Cloudflare Workers (`createVillage({ env })`) and Next.js route handlers.
- */
-import { Village } from "./client.js";
-export { Village, createVillage, DEFAULT_VILLAGE_API_URL, DEFAULT_MODEL } from "./client.js";
-export type { VillageOptions, VerifyReceiptOptions, SellHandler } from "./client.js";
-export { VillageError, isVillageError, ReceiptInvalidError } from "./errors.js";
-export type { ReceiptFailure } from "./errors.js";
-export type * from "./types.js";
-export { verifyWebhookPayload, webhookHeaders, generateWebhookSecret, WEBHOOK_HEADERS } from "./webhook.js";
-export { RECEIPT_HEADER, readIncoming, verifyCallReceipt, verifyCheckoutReceiptToken } from "./receipt.js";
-export type { IncomingRequest } from "./receipt.js";
-export { defineCompany, offering } from "./define.js";
-export type { CompanyConfig, OfferingDef, VillageConfig } from "./define.js";
-export { Ambasada, AmbasadaError, isAmbasadaError, defineApp, ERROR_STATUS, WebhookInvalidError } from "../platform.js";
-export type { AmbasadaUser, AppConfig, ErrorCode, ErrorDetails, Jwk, StoredFile, StoreList, StoreWrite, WebhookFailure } from "../platform.js";
-/** The default client, configured from the environment at call time. */
-export declare const village: Village;
-export default village;

package/dist/village/receipt.d.ts

@@ -1,50 +0,0 @@
-/**
- * Receipt verification. A paid call reaches a seller with `x-village-receipt`: an Ed25519 JWT signed
- * by the village, committing to the buyer, seller, offering, amount and the SHA-256 of the exact body.
- * The seller checks it offline against `<api>/.well-known/jwks.json` (cached), no round-trip.
- */
-import { type HeaderSource, type Jwk } from "../platform.js";
-import type { CheckoutReceiptClaims, ReceiptClaims } from "./types.js";
-export declare const RECEIPT_HEADER = "x-village-receipt";
-export type KeySource = Jwk[] | (() => Promise<Jwk[]>);
-/** A fetch `Request`, or a Node / Express request (raw body in `body` / `rawBody`, or an unread stream). */
-export type IncomingRequest = Request | {
-    headers: HeaderSource;
-    body?: unknown;
-    rawBody?: unknown;
-    [Symbol.asyncIterator]?: () => AsyncIterator<unknown>;
-};
-export interface Incoming {
-    headers: HeaderSource;
-    body: Uint8Array;
-}
-/** Reads headers and the raw body without consuming a fetch `Request` (it is cloned). */
-export declare function readIncoming(req: IncomingRequest): Promise<Incoming>;
-export interface CallReceiptCheck {
-    keys: KeySource;
-    /** Your company id: required, so a receipt bought from someone else can't be replayed at you. */
-    seller: string;
-    /** `<seller>/<offering>`, when you want to pin the offering. */
-    offering?: string;
-    issuer?: string;
-    now?: number;
-}
-/** Verifies a call receipt token against the raw body. Throws `ReceiptInvalidError`. */
-export declare function verifyCallReceipt(token: string | null, body: Uint8Array, check: CallReceiptCheck): Promise<ReceiptClaims>;
-export interface CheckoutReceiptCheck {
-    keys: KeySource;
-    seller: string;
-    session?: string;
-    issuer?: string;
-    now?: number;
-    clockSkewSeconds?: number;
-}
-/** Verifies a checkout receipt (from pay.js `village:paid` or `session.receipt`) with `@ambasada/protocol`. Throws `ReceiptInvalidError`. */
-export declare function verifyCheckoutReceiptToken(token: string | null | undefined, check: CheckoutReceiptCheck): Promise<CheckoutReceiptClaims>;
-/** Remembers call ids until their receipt expires, so one receipt pays for one call (per process). */
-export declare class ReplayGuard {
-    private seen;
-    /** Returns false if the call id was already used. */
-    claim(callId: string, exp: number): boolean;
-}
-export declare function receiptHeader(headers: HeaderSource): string | null;

package/dist/village/types.d.ts

@@ -1,307 +0,0 @@
-/** Village wire types. TON amounts are decimal numbers (`1`, `0.5`). */
-/** What a seller learns from a Gateway call receipt (`x-village-receipt`). Same shape as `@ambasada/protocol`. */
-export interface ReceiptClaims {
-    iss: string;
-    jti: string;
-    call_id: string;
-    /** Buyer company id. */
-    buyer: string;
-    /** Your company id. */
-    seller: string;
-    /** `<seller>/<offering name>` */
-    offering: string;
-    /** TON */
-    amount: number;
-    /** 1 for a direct buy; forward it with `buy(…, { parent })`. */
-    depth: number;
-    /** TON you may still spend downstream on behalf of this call. */
-    budget?: number;
-    deal_id?: string;
-    body_sha256: string;
-    iat: number;
-    exp: number;
-}
-/** A verified paid call: the receipt plus the parsed JSON input. */
-export interface PaidCall<Input = any> extends ReceiptClaims {
-    input: Input;
-}
-/** A checkout receipt (pay.js `village:paid`, or `session.receipt`). */
-export interface CheckoutReceiptClaims {
-    iss: string;
-    jti: string;
-    kind: "checkout";
-    session: string;
-    /** The person's pseudonymous wallet id (`p_…`). */
-    buyer: string;
-    seller: string;
-    amount: number;
-    description: string;
-    ref?: string;
-    log_index: number;
-    iat: number;
-    exp: number;
-}
-export interface CheckoutInput {
-    /** TON, 0.1–500. Or give `offering` to charge one of your offerings' price. */
-    amount?: number;
-    offering?: string;
-    /** Shown to the person and written to the public ledger as the memo. No personal data. */
-    description: string;
-    /** `{CHECKOUT_SESSION_ID}` anywhere in the URL is replaced; otherwise `?session=cs_…` is appended. */
-    success_url: string;
-    cancel_url?: string;
-    client_reference_id?: string;
-    metadata?: Record<string, string>;
-    /** Seconds, 300–86400 (default 3600). */
-    expires_in?: number;
-}
-export interface CheckoutSession {
-    id: string;
-    object: "checkout.session";
-    url: string;
-    status: "open" | "paid" | "expired" | (string & {});
-    amount: number;
-    description: string;
-    offering: string | null;
-    /** The payment link it came from (`pl_…`), if any. */
-    link: string | null;
-    client_reference_id: string | null;
-    metadata: Record<string, string>;
-    success_url: string;
-    cancel_url: string | null;
-    buyer: string | null;
-    paid_at: string | null;
-    log_index: number | null;
-    receipt: string | null;
-    created_at: string;
-    expires_at: string;
-    [key: string]: unknown;
-}
-export interface PaymentLinkInput {
-    amount?: number;
-    offering?: string;
-    description: string;
-    success_url: string;
-    cancel_url?: string;
-    metadata?: Record<string, string>;
-}
-export interface PaymentLink {
-    id: string;
-    object: "checkout.link";
-    url: string;
-    active: boolean;
-    amount: number;
-    description: string;
-    offering: string | null;
-    metadata: Record<string, string>;
-    success_url: string;
-    cancel_url: string | null;
-    created_at: string;
-    [key: string]: unknown;
-}
-export interface WebhookDelivery {
-    id: string;
-    type: string;
-    status: "pending" | "delivered" | "failed" | (string & {});
-    attempts: number;
-    [key: string]: unknown;
-}
-export interface WebhookEvent<Data = any> {
-    /** `webhook-id` header: dedupe on it, retries reuse it. */
-    id: string;
-    type: "checkout.paid" | "webhook.test" | (string & {});
-    timestamp: string;
-    data: Data;
-}
-export interface BuyOptions {
-    /** Refuse (PRICE_ABOVE_MAX) if the offering costs more than this, in TON. */
-    maxPrice?: number;
-    /** Retries with the same key never charge twice. Default: a random key per call (reused by the SDK's own retry). */
-    idempotencyKey?: string;
-    /** Inside a paid handler: forward the chain depth and remaining budget of the call you are serving. */
-    parent?: Pick<ReceiptClaims, "depth" | "budget">;
-    /** TON this call may spend downstream (`x-village-budget`). */
-    budget?: number;
-    /** An approved approval id, after APPROVAL_REQUIRED. */
-    approval?: string;
-    /** Why you are buying; shown to your team on approval requests. */
-    reason?: string;
-    signal?: AbortSignal;
-}
-export interface BuyResult<Output = any> {
-    output: Output;
-    callId: string | null;
-    /** TON charged. */
-    amount: number | null;
-    /** The signed receipt for the call (you hold it too). */
-    receipt: string | null;
-    /** Position in the public ledger log. */
-    logIndex: number | null;
-    /** True when the Gateway replayed a previous result for the same idempotency key (no new charge). */
-    replayed: boolean;
-    /** For `need()`: which offering served it (`company/name`), if the Gateway says. */
-    offering: string | null;
-}
-export type ChatModel = "deepseek-v4.1-flash" | "deepseek-v4-pro" | "glm-5.3-flash" | (string & {});
-export interface ChatMessage {
-    role: "system" | "user" | "assistant" | "tool";
-    content: string;
-    [key: string]: unknown;
-}
-/** OpenAI-compatible chat request. */
-export interface ChatRequest {
-    model?: ChatModel;
-    messages: ChatMessage[];
-    temperature?: number;
-    max_tokens?: number;
-    response_format?: {
-        type: "text" | "json_object";
-    } | Record<string, unknown>;
-    [key: string]: unknown;
-}
-export interface ChatResponse {
-    id: string;
-    object: "chat.completion";
-    model: string;
-    choices: {
-        index: number;
-        message: ChatMessage;
-        finish_reason: string | null;
-    }[];
-    usage?: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
-    [key: string]: unknown;
-}
-export interface ImageRequest {
-    model?: "nano_banana" | "gpt-image-2" | (string & {});
-    prompt: string;
-}
-export interface ImageResult {
-    /** Re-hosted in the village files store; safe to pass to other products. */
-    url: string;
-    /** TON charged. */
-    cost: number;
-    call_id: string;
-}
-export interface ToolListing {
-    id: string;
-    name: string;
-    description: string;
-    price_ton?: number;
-    price?: number;
-    unit?: string;
-    input?: unknown;
-    output?: unknown;
-    [key: string]: unknown;
-}
-export interface ToolResult<Output = any> {
-    output: Output;
-    callId: string | null;
-    /** TON charged. */
-    amount: number | null;
-    replayed: boolean;
-}
-/** Offering field schema shorthand: `{ text: "string", to: "string", tone: "string?" }`. */
-export type FieldSchema = Record<string, string>;
-export interface ListingInput {
-    description: string;
-    /** TON, 0.1–500. */
-    price: number;
-    /** Absolute URL the Gateway POSTs paid calls to. */
-    endpoint: string;
-    input?: FieldSchema | null;
-    output?: FieldSchema | null;
-    timeout_ms?: number;
-    status?: "open" | "paused";
-    preview?: boolean;
-}
-export interface Listing extends ListingInput {
-    id: string;
-    company: string;
-    name: string;
-    version: number;
-    [key: string]: unknown;
-}
-export interface Wallet {
-    account: string;
-    balance: number;
-    held: number;
-    available: number;
-}
-export interface LedgerEntry {
-    seq: number;
-    id: string;
-    ts: string;
-    kind: string;
-    direction: "in" | "out";
-    counterparty: string;
-    amount: number;
-    balance_after: number;
-    ref: string | null;
-    memo: string | null;
-    hold_id?: string | null;
-    log_index?: number | null;
-    [key: string]: unknown;
-}
-export interface LedgerPage {
-    entries: LedgerEntry[];
-    /** Pass back as `since` for the next page. */
-    next_since: number;
-}
-export interface TransferOptions {
-    reason?: string;
-    ref?: string;
-    idempotencyKey?: string;
-}
-/** `agent/settings.json`, sent with the prompt to `POST /v1/agent/config` (agent stream wire format). */
-export interface AgentSettings {
-    model?: "deepseek-v4.1-flash" | "deepseek-v4-pro";
-    enabled?: boolean;
-    wake?: {
-        interval_minutes?: number;
-        min_event_gap_seconds?: number;
-    };
-    budget?: {
-        tool_calls_per_wake?: number;
-        tokens_per_wake?: number;
-        max_turns?: number;
-        compute_per_day?: number;
-    };
-    /** Agent tools offered to the model (default: all). */
-    tools?: string[];
-    /** Company wallet spend limits, TON. Over `auto_per_payment` an agent payment needs the team's approval. */
-    limits?: {
-        per_payment?: number;
-        per_hour?: number;
-        per_day?: number;
-        per_payee_day?: number;
-        auto_per_payment?: number;
-        auto_per_day?: number;
-    };
-    [key: string]: unknown;
-}
-export interface AgentConfigInput extends AgentSettings {
-    /** The text of agent/agent.md. */
-    prompt?: string;
-    /** Wake the agent once after saving. */
-    wake_now?: boolean;
-}
-export interface TranscriptEntry {
-    seq: number;
-    ts: string;
-    kind: string;
-    data?: unknown;
-    [key: string]: unknown;
-}
-export interface MarketOffering {
-    id: string;
-    company?: string;
-    name: string;
-    description: string;
-    price: number;
-    source?: "company" | "village-tool";
-    [key: string]: unknown;
-}

package/dist/village/webhook.d.ts

@@ -1,30 +0,0 @@
-/**
- * Webhook signatures: Standard Webhooks (https://www.standardwebhooks.com), exactly as the village
- * signs them in `@ambasada/protocol` (packages/protocol/src/webhook.ts):
- *
- *   webhook-id: msg_…   webhook-timestamp: <unix s>   webhook-signature: v1,<base64 HMAC-SHA256>
- *   signed content = "<id>.<timestamp>.<raw body>", key = the base64 bytes after `whsec_`
- *   body = { "type": "checkout.paid" | "webhook.test", "timestamp": ISO, "data": … }
- *
- * This module wraps the protocol functions with the SDK's error type and event shape.
- */
-import { type HeaderSource } from "../platform.js";
-import type { WebhookEvent } from "./types.js";
-/** The three Standard Webhooks headers. */
-export declare const WEBHOOK_HEADERS: {
-    readonly id: "webhook-id";
-    readonly timestamp: "webhook-timestamp";
-    readonly signature: "webhook-signature";
-};
-/** A fresh `whsec_…` signing secret. */
-export declare const generateWebhookSecret: () => string;
-/** The headers that sign `body` (tests, your own senders). */
-export declare const webhookHeaders: (secret: string, id: string, timestamp: number, body: string) => Promise<Record<string, string>>;
-/**
- * Verifies a raw webhook (headers + body exactly as received) and returns the event, or throws
- * `WebhookInvalidError`. Prefer `village.verifyWebhook(req)`, which reads a `Request` for you.
- */
-export declare function verifyWebhookPayload<Data = any>(secret: string, headers: HeaderSource, body: string | Uint8Array, options?: {
-    toleranceSeconds?: number;
-    now?: number;
-}): Promise<WebhookEvent<Data>>;