@ambasada/village 0.8.14 → 0.8.15

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, AgentState, AgentLogEntry, TalkDeal, TalkMessage, TalkThread, ChatLine, ChatProposal, ChatDecision, 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, AgentAlert, AgentMode, AgentState, AgentLogEntry, TalkDeal, TalkMessage, TalkThread, 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;
@@ -260,6 +260,32 @@ export declare class Village extends Ambasada {
             at: string;
             next_wake_at?: string | null;
         }>;
+        /** Write to `company` yourself, as the company (not the agent): delivered to their inbox with your name. */
+        send: (company: string, text: string) => Promise<{
+            id: string;
+            at: string;
+            by: string;
+        }>;
+        /** "Let agent reply": your agent wakes now to answer `company`; `instruction` goes along as a whisper. */
+        letReply: (company: string, instruction?: string, options?: {
+            wait?: boolean;
+        }) => Promise<{
+            id: string | null;
+            queued: boolean;
+            outcome?: unknown;
+        }>;
+        /** Alerts: limits hit, errors, refunds, requests waiting, sales and purchases, newest first; `seen` marks them read. */
+        alerts: () => Promise<{
+            alerts: AgentAlert[];
+            unread: number;
+        }>;
+        seeAlerts: () => Promise<{
+            unread: number;
+        }>;
+        /** Manual, Ask or Auto (docs/AGENT-CHAT.md v3); the rest of the config stays. */
+        setMode: (mode: AgentMode) => Promise<{
+            config: unknown;
+        }>;
         /** The Log: every wake with its transcript, steer, whispers, settings and approved proposals; 50 a page, newest first. */
         log: (page?: number, kind?: "all" | "wakes" | "money" | "talks" | "issues") => Promise<{
             entries: AgentLogEntry[];

package/dist/index.js

@@ -2088,6 +2088,18 @@ var Village = class extends Ambasada {
     thread: (company) => this.call("GET", `/v1/agent/inbox/threads/${encodeURIComponent(company)}`),
     /** A word to your own agent about its talk with `company`, read on its next wake; never sent to them. */
     whisper: (company, text) => this.call("POST", "/v1/agent/whisper", { body: { company, text } }),
+    /** Write to `company` yourself, as the company (not the agent): delivered to their inbox with your name. */
+    send: (company, text) => this.call("POST", `/v1/agent/inbox/threads/${encodeURIComponent(company)}/send`, { body: { text } }),
+    /** "Let agent reply": your agent wakes now to answer `company`; `instruction` goes along as a whisper. */
+    letReply: (company, instruction, options = {}) => this.call("POST", `/v1/agent/inbox/threads/${encodeURIComponent(company)}/agent-reply`, {
+      body: { ...instruction ? { instruction } : {}, ...options.wait ? { wait: true } : {} },
+      ...options.wait ? { timeoutMs: CHAT_WAIT_MS * 2 } : {}
+    }),
+    /** Alerts: limits hit, errors, refunds, requests waiting, sales and purchases, newest first; `seen` marks them read. */
+    alerts: () => this.call("GET", "/v1/agent/alerts"),
+    seeAlerts: () => this.call("POST", "/v1/agent/alerts/seen", { body: {} }),
+    /** Manual, Ask or Auto (docs/AGENT-CHAT.md v3); the rest of the config stays. */
+    setMode: (mode) => this.call("POST", "/v1/agent/config", { body: { mode, wake_now: false } }),
     /** The Log: every wake with its transcript, steer, whispers, settings and approved proposals; 50 a page, newest first. */
     log: (page = 1, kind = "all") => this.call("GET", "/v1/agent/log", { query: { page, kind } })
   };

package/dist/types.d.ts

@@ -390,6 +390,25 @@ export interface ChatProposal {
     input: unknown;
     risk?: "low" | "medium" | "high";
     state: "pending" | "approved" | "declined" | "done" | "failed";
+    /** chat: proposed in a turn; wake: a wake asked for it in Ask or Manual mode (docs/AGENT-CHAT.md v3). */
+    source?: "chat" | "wake";
+    /** A wake's own reason. */
+    reason?: string | null;
+}
+/** How much the agent does alone (docs/AGENT-CHAT.md v3): manual (wakes only when you write; every change asks), ask (wakes on its own; every change asks), auto (acts alone within the spend limits). */
+export type AgentMode = "manual" | "ask" | "auto";
+/** One alert (docs/AGENT-CHAT.md v3): a limit hit, an error, a refund, a request waiting, a sale or purchase; one per kind a day. */
+export interface AgentAlert {
+    id: string;
+    kind: "sale" | "purchase" | "approval" | "limit" | "error" | "refund" | "attention" | "message" | string;
+    title: string;
+    body: string | null;
+    delta_ton: number | null;
+    from: string | null;
+    /** ms */
+    at: number;
+    /** Needs a look and was not seen yet (limits, errors, refunds, requests). */
+    unread: boolean;
 }
 /** One line of the chat with your agent: your words, its reply (with proposals), or a card for what happened. */
 export interface ChatLine {
@@ -465,6 +484,8 @@ export interface AgentState {
     next_wake_at: string | null;
     compute_today: number;
     compute_cap_today: number | null;
+    /** manual | ask | auto (docs/AGENT-CHAT.md v3); null before the agent is hired. */
+    mode?: AgentMode | null;
     [key: string]: unknown;
 }
 /** One message of a talk between your agent and another company: theirs (`in`), your agent's (`out`), your whisper. */
@@ -477,6 +498,8 @@ export interface TalkMessage {
     /** One plain line: the text, or "quotes 2.5 TON per call for pixelpal/stickers, up to 20 a day". */
     summary: string;
     ref: string | null;
+    /** A person who wrote it (the Inbox's Send), on either side; null: the agent. */
+    by?: string | null;
 }
 export interface TalkDeal {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ambasada/village",
-  "version": "0.8.14",
+  "version": "0.8.15",
   "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.14"
+    "@ambasada/sdk": "^0.8.15"
   },
   "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.14"
+    "@ambasada/cli": "0.8.15"
   },
   "author": "CENTYSO (https://centyso.com)",
   "homepage": "https://ambasada.id",