@ambasada/sdk 0.8.8 → 0.8.10

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { AmbasadaApps } from "./apps.js";
 import { AmbasadaAuth } from "./auth.js";
-import type { FileOptions, Jwk, StoredFile, StoreList, StoreWrite } from "./types.js";
+import type { FileOptions, Jwk, LogEntry, ProductLogs, StoredFile, StoreList, StoreWrite } from "./types.js";
 export declare const DEFAULT_API_URL = "https://api.ambasada.dev";
 export interface AmbasadaOptions {
     /** Project key (`vk_…` from developer.ambasada.dev, or `ambasada login`). Default: `AMBASADA_API_KEY`. */
@@ -111,6 +111,17 @@ export declare class Ambasada {
         /** Keys (up to 1000, optionally under a prefix) and how much of the 1 MB is used. */
         list: (prefix?: string) => Promise<StoreList>;
     };
+    /**
+     * The app's error log (`ambasada logs`, the Developer app's Logs). Errors in a request are recorded on their own (a
+     * 5xx); `report` is for work outside one, like a job's failed attempt (the templates' Jobs object reports each).
+     */
+    readonly logs: {
+        report: (entry: LogEntry) => Promise<{
+            ok: true;
+        }>;
+        /** The last deploy and recent errors (what `ambasada logs` prints). */
+        recent: () => Promise<ProductLogs>;
+    };
 }
 export declare function cachedKeys(load: () => Promise<Jwk[]>, ttlMs?: number): () => Promise<Jwk[]>;
 export declare function createAmbasada(options?: AmbasadaOptions): Ambasada;

package/dist/errors.d.ts

@@ -40,9 +40,11 @@ export declare const ERROR_STATUS: {
     readonly APPROVALS_PENDING: 429;
     readonly PROVIDER_BUDGET: 503;
     readonly PROVIDER_DENIED: 502;
+    readonly TOOL_UNAVAILABLE: 503;
     readonly FROZEN: 403;
     readonly CAP_INBOX_RATE: 429;
     readonly CAP_CHAT_RATE: 429;
+    readonly CAP_TOOLS_RATE: 429;
     readonly NETWORK: 0;
     readonly CONFIG: 0;
     readonly RECEIPT_INVALID: 402;

package/dist/platform.js

@@ -169,12 +169,14 @@ var ERROR_STATUS = {
   // LLMOK mapping (utilities stream, docs/LLMOK.md)
   PROVIDER_BUDGET: 503,
   PROVIDER_DENIED: 502,
+  TOOL_UNAVAILABLE: 503,
   // Clock windows (agent stream): deploys / steering refused while frozen
   FROZEN: 403,
   // Exchange stream: an agent sent too many inbox messages
   CAP_INBOX_RATE: 429,
   // The CEO chat: too many turns for one company
   CAP_CHAT_RATE: 429,
+  CAP_TOOLS_RATE: 429,
   // SDK-side
   NETWORK: 0,
   CONFIG: 0,
@@ -767,6 +769,15 @@ var Ambasada = class {
     /** Keys (up to 1000, optionally under a prefix) and how much of the 1 MB is used. */
     list: (prefix) => this.call("GET", "/v1/store", { query: { prefix } })
   };
+  /**
+   * The app's error log (`ambasada logs`, the Developer app's Logs). Errors in a request are recorded on their own (a
+   * 5xx); `report` is for work outside one, like a job's failed attempt (the templates' Jobs object reports each).
+   */
+  logs = {
+    report: (entry) => this.call("POST", "/v1/product/logs", { body: entry }),
+    /** The last deploy and recent errors (what `ambasada logs` prints). */
+    recent: () => this.call("GET", "/v1/product/logs")
+  };
 };
 function cachedKeys(load, ttlMs = 10 * 6e4) {
   let cached;

package/dist/types.d.ts

@@ -38,3 +38,38 @@ export interface StoreWrite {
     used_bytes: number;
     limit_bytes: number;
 }
+/** `POST /v1/product/logs`: an error the app reports itself (a job's failed attempt, work outside a request). */
+export interface LogEntry {
+    /** Default "error" (counted in `ambasada logs`' errors); "warn" is shown, not counted. */
+    level?: "error" | "warn";
+    message: string;
+    /** The error's stack (its first frames are enough: `ambasada logs` maps them to your source). */
+    stack?: string | null;
+    /** The job it is about (`story:call_…`), shown as `job <name>`. */
+    job?: string;
+}
+/** One recorded error: a request (method, path, status) or a reported one (method `JOB` or `LOG`, path the job). */
+export interface LoggedError {
+    at: string;
+    status: number | null;
+    method: string | null;
+    path: string | null;
+    message: string | null;
+}
+/** `GET /v1/product/logs`. */
+export interface ProductLogs {
+    last_deploy: {
+        version: number;
+        deployed_at: string;
+        smoke: unknown;
+        template: string | null;
+    } | null;
+    errors: {
+        hourly: {
+            hour: string;
+            count: number;
+        }[];
+        total_24h: number;
+        recent: LoggedError[];
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ambasada/sdk",
-  "version": "0.8.8",
+  "version": "0.8.10",
   "description": "The Ambasada platform SDK: Sign in with Ambasada, mini-app notifications, the project store, files.",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@ambasada/village": "^0.8.8"
+    "@ambasada/village": "^0.8.10"
   },
   "devDependencies": {
     "@types/node": "^22.20.5",