@mitralab.io/functions-sdk 0.2.9 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 All notable changes to this project are documented in this file.
 
+## 0.3.0
+
+- Depend on `@mitralab.io/sdk-core@0.3.0`, the agent session that follows T3. A message sent while
+  a reply runs no longer waits in a local queue of the SDK: it goes to the box at once with its
+  `clientMessageId` and no mode by default, and T3 decides, steering it into the running turn or
+  queueing it. `send(prompt, { mode: "queue" | "steer" })` asks on purpose, and `send` returns the
+  message's `clientMessageId`. `session.history` is the live conversation in the box's order, asked
+  with `kinds=all`, with a tool's call and result as two items, as in 0.2.13, the question as the
+  person wrote it, and T3's approvals and mid-turn questions where they came. `queue` mirrors T3's
+  queue, with `steerQueueItem`, `resumeQueue` and `backgroundTasks`. The history keeps the 0.2.13
+  format; against an old box the new functions show nothing.
+- Pin the SDK-PARITY-001 corpus to Core `0.3.0` with its digest and immutable source commit.
+
+## 0.2.10
+
+- Depend on `@mitralab.io/sdk-core@0.2.14`: `apps.update()` (and `currentApp.update()`) takes
+  `emailLoginEnabled` and `passwordLoginEnabled`, sent to Code Studio only when supplied, so omission
+  keeps the current value; `AppDefinition` and `AppSummary` carry both fields when Code Studio returns
+  them. `messenger.sendEmail({ to, subject, html, text?, cc?, bcc?, replyTo? })` sends an email as
+  the app's backend through Messenger, with no `from`.
+- Pin the SDK-PARITY-001 corpus to Core `0.2.14` with its digest and immutable source commit.
+
+## 0.2.10-beta.0
+
+- `MitraApiError` gains `retryAfterSeconds`: how long the server asked to wait, read from
+  `retry_after_seconds` in the error body or, without it, from the `Retry-After` header in
+  seconds. A value that is not a non-negative integer, or a header in HTTP-date form, leaves it
+  unset. Messenger answers the app's daily email quota with a `429` carrying both.
+
 ## 0.2.9
 
 - Depend on `@mitralab.io/sdk-core@0.2.13`: `AgentTurnUsage` gains `contextTokens`, the tokens

package/README.md

@@ -65,13 +65,13 @@ async function loadOrder(orderId) {
 
 ## Erros
 
-`MitraApiError` traz `status`, `code`, `details`, `requestId` e `retryable`. O token não aparece na mensagem nem nos detalhes.
+`MitraApiError` traz `status`, `code`, `details`, `requestId`, `retryable` e `retryAfterSeconds`. O token não aparece na mensagem nem nos detalhes. `retryAfterSeconds` é quanto o servidor pediu para esperar, lido de `retry_after_seconds` no corpo ou do header `Retry-After` em segundos; sem valor inteiro válido, fica vazio.
 
 | Erro                                           | Quando                                                          | O que fazer                                                                         |
 | ---------------------------------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
 | `MitraConfigurationError`                      | configuração ausente ou inválida, ou `apps` usado com outro app | confira variáveis e argumentos; para o próprio app, use `currentApp`                |
 | `MitraApiError` `401` ou `403`                 | o token não dá acesso ao recurso                                | confira as permissões do app; nem todo módulo está liberado para o token do runtime |
-| `MitraApiError` `429` ou `5xx`                 | limite de requisições ou falha no servidor                      | repita só se a operação puder ser repetida                                          |
+| `MitraApiError` `429` ou `5xx`                 | limite de requisições ou falha no servidor                      | repita só se a operação puder ser repetida; espere `retryAfterSeconds`, se vier     |
 | `REQUEST_TIMEOUT`, `NETWORK_ERROR`             | prazo estourado ou falha de rede, com `status` `0`              | aumente `timeoutMs` ou repita, se a operação permitir                               |
 | `INVALID_CREDENTIALS`, `AUTHENTICATION_FAILED` | a troca da API key falhou                                       | confira a chave e o `appId`                                                         |
 | `INVALID_RESPONSE`                             | resposta fora do formato esperado                               | atualize o SDK; se continuar, abra uma issue                                        |

package/contracts/sdk-core-v0.2.14.manifest.json

@@ -0,0 +1,15 @@
+{
+  "contract": "SDK-PARITY-001",
+  "version": "0.2.14",
+  "dependency": {
+    "package": "@mitralab.io/sdk-core",
+    "version": "0.2.14",
+    "contractPath": "contracts/v0.2.14/sdk-parity.json"
+  },
+  "sha256": "112e7eb52bd4362737ef03efff2cad4f529e41d5ac8ccda442e57c09b2e3c459",
+  "source": {
+    "repository": "https://github.com/mitralab-dev/mitra-core-sdk",
+    "commit": "51ddb3ed7c7efd6f28aaa6c31a585227d245995b",
+    "path": "contracts/v0.2.14/sdk-parity.json"
+  }
+}

package/contracts/sdk-core-v0.3.0.manifest.json

@@ -0,0 +1,15 @@
+{
+  "contract": "SDK-PARITY-001",
+  "version": "0.3.0",
+  "dependency": {
+    "package": "@mitralab.io/sdk-core",
+    "version": "0.3.0",
+    "contractPath": "contracts/v0.3.0/sdk-parity.json"
+  },
+  "sha256": "dc7dceb99e29810dfd2cf30d76ec80ea8c5d6dbf5c8dac3038f58a2d36cbc793",
+  "source": {
+    "repository": "https://github.com/mitralab-dev/mitra-core-sdk",
+    "commit": "ff356e49af09aa238beaf94043680226edb9de66",
+    "path": "contracts/v0.3.0/sdk-parity.json"
+  }
+}

package/dist/index.cjs

@@ -119,6 +119,7 @@ var MitraApiError = class extends Error {
   details;
   requestId;
   retryable;
+  retryAfterSeconds;
   constructor(message, status, options = {}) {
     super(message);
     this.name = "MitraApiError";
@@ -127,6 +128,7 @@ var MitraApiError = class extends Error {
     this.details = options.details;
     this.requestId = options.requestId;
     this.retryable = options.retryable;
+    this.retryAfterSeconds = options.retryAfterSeconds;
   }
 };
 
@@ -155,6 +157,17 @@ function redactDetails(value, accessToken) {
 function optionalString(value) {
   return typeof value === "string" ? value : void 0;
 }
+var retryAfterHeaderPattern = /^\d+$/;
+function retryAfterSeconds(errorPayload, response) {
+  const fromBody = errorPayload.retry_after_seconds;
+  if (typeof fromBody === "number" && Number.isSafeInteger(fromBody) && fromBody >= 0) {
+    return fromBody;
+  }
+  const fromHeader = response.headers.get("Retry-After");
+  if (fromHeader === null || !retryAfterHeaderPattern.test(fromHeader)) return void 0;
+  const seconds = Number(fromHeader);
+  return Number.isSafeInteger(seconds) ? seconds : void 0;
+}
 function appendQueryParameters(url, params) {
   for (const [key, value] of Object.entries(params)) {
     if (value === void 0) continue;
@@ -207,11 +220,13 @@ function createApiError(response, payload, accessToken) {
   const requestId = rawRequestId === void 0 ? void 0 : redactText(rawRequestId, accessToken);
   const code = rawCode === void 0 ? void 0 : redactText(rawCode, accessToken);
   const retryable = typeof errorPayload.retryable === "boolean" ? errorPayload.retryable : response.status >= 500;
+  const retryAfter = retryAfterSeconds(errorPayload, response);
   return new MitraApiError(message, response.status, {
     ...code === void 0 ? {} : { code },
     ...errorPayload.details === void 0 ? {} : { details: redactDetails(errorPayload.details, accessToken) },
     ...requestId === void 0 ? {} : { requestId },
-    ...retryable === void 0 ? {} : { retryable }
+    ...retryable === void 0 ? {} : { retryable },
+    ...retryAfter === void 0 ? {} : { retryAfterSeconds: retryAfter }
   });
 }
 function isUnauthorized(error) {

package/dist/index.d.cts

@@ -115,6 +115,7 @@ interface MitraApiErrorOptions {
     details?: unknown;
     requestId?: string;
     retryable?: boolean;
+    retryAfterSeconds?: number;
 }
 declare class MitraApiError extends Error {
     readonly status: number;
@@ -122,6 +123,7 @@ declare class MitraApiError extends Error {
     readonly details: unknown;
     readonly requestId: string | undefined;
     readonly retryable: boolean | undefined;
+    readonly retryAfterSeconds: number | undefined;
     constructor(message: string, status: number, options?: MitraApiErrorOptions);
 }
 

package/dist/index.d.ts

@@ -115,6 +115,7 @@ interface MitraApiErrorOptions {
     details?: unknown;
     requestId?: string;
     retryable?: boolean;
+    retryAfterSeconds?: number;
 }
 declare class MitraApiError extends Error {
     readonly status: number;
@@ -122,6 +123,7 @@ declare class MitraApiError extends Error {
     readonly details: unknown;
     readonly requestId: string | undefined;
     readonly retryable: boolean | undefined;
+    readonly retryAfterSeconds: number | undefined;
     constructor(message: string, status: number, options?: MitraApiErrorOptions);
 }
 

package/dist/index.js

@@ -23,6 +23,7 @@ var MitraApiError = class extends Error {
   details;
   requestId;
   retryable;
+  retryAfterSeconds;
   constructor(message, status, options = {}) {
     super(message);
     this.name = "MitraApiError";
@@ -31,6 +32,7 @@ var MitraApiError = class extends Error {
     this.details = options.details;
     this.requestId = options.requestId;
     this.retryable = options.retryable;
+    this.retryAfterSeconds = options.retryAfterSeconds;
   }
 };
 
@@ -59,6 +61,17 @@ function redactDetails(value, accessToken) {
 function optionalString(value) {
   return typeof value === "string" ? value : void 0;
 }
+var retryAfterHeaderPattern = /^\d+$/;
+function retryAfterSeconds(errorPayload, response) {
+  const fromBody = errorPayload.retry_after_seconds;
+  if (typeof fromBody === "number" && Number.isSafeInteger(fromBody) && fromBody >= 0) {
+    return fromBody;
+  }
+  const fromHeader = response.headers.get("Retry-After");
+  if (fromHeader === null || !retryAfterHeaderPattern.test(fromHeader)) return void 0;
+  const seconds = Number(fromHeader);
+  return Number.isSafeInteger(seconds) ? seconds : void 0;
+}
 function appendQueryParameters(url, params) {
   for (const [key, value] of Object.entries(params)) {
     if (value === void 0) continue;
@@ -111,11 +124,13 @@ function createApiError(response, payload, accessToken) {
   const requestId = rawRequestId === void 0 ? void 0 : redactText(rawRequestId, accessToken);
   const code = rawCode === void 0 ? void 0 : redactText(rawCode, accessToken);
   const retryable = typeof errorPayload.retryable === "boolean" ? errorPayload.retryable : response.status >= 500;
+  const retryAfter = retryAfterSeconds(errorPayload, response);
   return new MitraApiError(message, response.status, {
     ...code === void 0 ? {} : { code },
     ...errorPayload.details === void 0 ? {} : { details: redactDetails(errorPayload.details, accessToken) },
     ...requestId === void 0 ? {} : { requestId },
-    ...retryable === void 0 ? {} : { retryable }
+    ...retryable === void 0 ? {} : { retryable },
+    ...retryAfter === void 0 ? {} : { retryAfterSeconds: retryAfter }
   });
 }
 function isUnauthorized(error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mitralab.io/functions-sdk",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "description": "JavaScript and TypeScript SDK for Mitra Server Functions",
   "type": "module",
   "sideEffects": false,
@@ -67,7 +67,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@mitralab.io/sdk-core": "0.2.13",
+    "@mitralab.io/sdk-core": "0.3.0",
     "mitra-sdk": "1.0.63-beta.42"
   },
   "devDependencies": {