@ambasada/village 0.8.8 → 0.8.9

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { Ambasada, type AmbasadaOptions } from "@ambasada/sdk/platform";
 import { type IncomingRequest } from "./receipt.js";
-import type { JobAnswer, AgentConfigInput, BuyOptions, BuyResult, ChatRequest, ChatResponse, CheckoutInput, CheckoutReceiptClaims, CheckoutDelivery, CheckoutDeliveryInput, CheckoutSession, ImageRequest, ImageResult, LedgerPage, Listing, ListingInput, MarketOffering, PaidCall, PaymentLink, PaymentLinkInput, ToolListing, ToolResult, TranscriptEntry, ChatLine, ChatProposal, ChatTurn, TransferOptions, Wallet, WebhookDelivery, WebhookEvent } from "./types.js";
+import type { JobAnswer, AgentConfigInput, BuyOptions, BuyResult, ChatRequest, ChatResponse, CheckoutInput, CheckoutReceiptClaims, CheckoutDelivery, CheckoutDeliveryInput, CheckoutSession, ImageRequest, ImageResult, LedgerPage, Listing, ListingInput, MarketOffering, PaidCall, PaymentLink, PaymentLinkInput, ToolListing, ToolResult, TranscriptEntry, ChatLine, ChatProposal, ChatDecision, ChatTurn, TransferOptions, Wallet, WebhookDelivery, WebhookEvent } from "./types.js";
 /** How long a utility call may take here: the API's own limit plus a margin, so the SDK never gives up on a call the API finishes and charges. */
 export declare const CLIENT_TIMEOUT_MS: {
     readonly llm: number;
@@ -206,8 +206,13 @@ export declare class Village extends Ambasada {
         }) => Promise<ChatLine[]>;
         /** Proposals waiting for your team. */
         proposals: () => Promise<ChatProposal[]>;
-        /** Approve (it runs now) or decline a proposal. */
-        decide: (id: string, decision: "approve" | "decline", reason?: string) => Promise<unknown>;
+        /**
+         * Approve (it runs now) or decline a proposal. `wait` (approve): also what the agent said after it, up to a
+         * minute (`follow_up`).
+         */
+        decide: (id: string, decision: "approve" | "decline", reason?: string, options?: {
+            wait?: boolean;
+        }) => Promise<ChatDecision>;
         transcript: (since?: number, limit?: number) => Promise<{
             entries: TranscriptEntry[];
             next_since: number;

package/dist/index.js

@@ -1988,8 +1988,14 @@ var Village = class extends Ambasada {
     messages: async (options = {}) => (await this.call("GET", "/v1/agent/chat/messages", { query: { limit: options.limit ?? 50, ...options.since ? { since: options.since } : {} } })).messages,
     /** Proposals waiting for your team. */
     proposals: async () => (await this.call("GET", "/v1/agent/chat/proposals")).proposals,
-    /** Approve (it runs now) or decline a proposal. */
-    decide: (id, decision, reason) => this.call("POST", `/v1/agent/chat/proposals/${encodeURIComponent(id)}`, { body: { decision, ...reason ? { reason } : {} } }),
+    /**
+     * Approve (it runs now) or decline a proposal. `wait` (approve): also what the agent said after it, up to a
+     * minute (`follow_up`).
+     */
+    decide: (id, decision, reason, options = {}) => this.call("POST", `/v1/agent/chat/proposals/${encodeURIComponent(id)}`, {
+      body: { decision, ...reason ? { reason } : {}, ...options.wait ? { wait: true } : {} },
+      ...options.wait ? { timeoutMs: CHAT_WAIT_MS + 15e3 } : {}
+    }),
     transcript: (since = 0, limit = 200) => this.call("GET", "/v1/agent/transcript", { query: { since, limit } }),
     state: () => this.call("GET", "/v1/agent/state")
   };

package/dist/types.d.ts

@@ -17,6 +17,8 @@ export interface ReceiptClaims {
     /** TON you may still spend downstream on behalf of this call. */
     budget?: number;
     deal_id?: string;
+    /** An async offering's call: when the buyer's max_wait_s runs out (unix seconds); `startJob(…, { deadline: call.deadline * 1000 })`. */
+    deadline?: number;
     body_sha256: string;
     iat: number;
     exp: number;
@@ -156,8 +158,14 @@ export interface BuyOptions {
     wait?: boolean;
 }
 /** What an async offering's `GET <endpoint>/jobs/<id>` says (village.jobStatus): the Gateway settles on done or failed. */
-export type JobAnswer = {
+export type JobAnswer = 
+/** `attempts`: the failed ones so far (the template's `jobAnswer(job)`); the buyer sees "working (attempt 2, last error: …)". */
+{
     status: "working";
+    attempts?: {
+        at: string;
+        error: string;
+    }[];
 } | {
     status: "done";
     output: unknown;
@@ -394,9 +402,22 @@ export interface ChatTurn {
     /** With `wait`: how the turn ended and the agent's reply. */
     status?: "completed" | "error" | "aborted" | "skipped" | "pending" | "running";
     error?: string;
-    /** Still waiting: "wake" while the agent's wake runs (the turn is answered after it). */
+    /** Still waiting: "wake" while the agent's wake runs (the turn is answered after it); also on a `wait: false` send during a wake. */
     queued?: "wake";
     reply?: ChatLine | null;
+    /** The turn ended and the agent said nothing, even after the village asked it once more: "No reply (the model returned nothing)". */
+    no_reply?: string;
+}
+/** `agent.decide`: what ran, and with `wait` (approve) what the agent said after it. */
+export interface ChatDecision {
+    id: string;
+    decision: "approve" | "decline";
+    /** The action's outcome (approve): its result, or `{ error: { code, message } }` when it failed. */
+    result: unknown;
+    /** The API's time of the decision (ms). */
+    at?: number;
+    /** With `wait`: the agent's next line (its reply, or the "no reply" card), null when a minute went by. */
+    follow_up?: ChatLine | null;
 }
 export interface MarketOffering {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ambasada/village",
-  "version": "0.8.8",
+  "version": "0.8.9",
   "description": "The Hack A Ton add-on for Ambasada apps: TON checkout, receipts, offerings, LLM, the agent, the market; CLI commands and the local bank.",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@ambasada/sdk": "^0.8.8"
+    "@ambasada/sdk": "^0.8.9"
   },
   "devDependencies": {
     "@types/node": "^22.20.5",
@@ -35,7 +35,7 @@
     "typescript": "~5.9.3",
     "vitest": "^4.1.12",
     "@ambasada/protocol": "0.1.0",
-    "@ambasada/cli": "0.8.8"
+    "@ambasada/cli": "0.8.9"
   },
   "author": "CENTYSO (https://centyso.com)",
   "homepage": "https://ambasada.id",