@amigo-ai/platform-sdk 0.1.0

package/dist/core/retry.js

@@ -0,0 +1,48 @@
+/**
+ * Exponential backoff with full jitter and Retry-After header support.
+ */
+const RETRYABLE_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);
+// POST is only retried on 429 with a Retry-After header (idempotency concern)
+const POST_RETRYABLE_STATUS_CODES = new Set([429]);
+export function shouldRetry(ctx) {
+    const { method, attempt, response, options } = ctx;
+    if (attempt >= options.maxAttempts)
+        return false;
+    const status = response.status;
+    if (method === 'GET' || method === 'HEAD') {
+        return RETRYABLE_STATUS_CODES.has(status);
+    }
+    if (method === 'POST' && POST_RETRYABLE_STATUS_CODES.has(status)) {
+        return response.headers.has('Retry-After');
+    }
+    return false;
+}
+export function computeDelay(attempt, response, options) {
+    const retryAfterHeader = response.headers.get('Retry-After');
+    if (retryAfterHeader) {
+        const seconds = parseRetryAfterHeader(retryAfterHeader);
+        if (seconds !== undefined)
+            return seconds * 1000;
+    }
+    // Exponential backoff with full jitter: random value in [0, min(maxDelay, base * 2^attempt)]
+    const exponential = Math.min(options.maxDelayMs, options.baseDelayMs * Math.pow(2, attempt));
+    return Math.random() * exponential;
+}
+function parseRetryAfterHeader(header) {
+    const seconds = Number(header);
+    if (!isNaN(seconds))
+        return seconds;
+    const date = new Date(header);
+    if (!isNaN(date.getTime())) {
+        return Math.max(0, Math.ceil((date.getTime() - Date.now()) / 1000));
+    }
+    return undefined;
+}
+export function resolveRetryOptions(opts) {
+    return {
+        maxAttempts: opts?.maxAttempts ?? 3,
+        baseDelayMs: opts?.baseDelayMs ?? 250,
+        maxDelayMs: opts?.maxDelayMs ?? 30_000,
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/core/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AACtE,8EAA8E;AAC9E,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;AASlD,MAAM,UAAU,WAAW,CAAC,GAAiB;IAC3C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,CAAA;IAClD,IAAI,OAAO,IAAI,OAAO,CAAC,WAAW;QAAE,OAAO,KAAK,CAAA;IAEhD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;IAC9B,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC3C,CAAC;IACD,IAAI,MAAM,KAAK,MAAM,IAAI,2BAA2B,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,QAAkB,EAAE,OAA+B;IAC/F,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IAC5D,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,qBAAqB,CAAC,gBAAgB,CAAC,CAAA;QACvD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,GAAG,IAAI,CAAA;IAClD,CAAC;IAED,6FAA6F;IAC7F,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5F,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAA;AACpC,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAc;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IACnC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAA;IAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAmB;IACrD,OAAO;QACL,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,CAAC;QACnC,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,GAAG;QACrC,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,MAAM;KACvC,CAAA;AACH,CAAC"}

package/dist/core/utils.js

@@ -0,0 +1,35 @@
+/**
+ * Shared utilities: response extraction and pagination helpers.
+ */
+import { ParseError } from './errors.js';
+/**
+ * Extracts the data payload from an openapi-fetch response,
+ * throwing ParseError if the response is empty or unexpected.
+ */
+export function extractData(result) {
+    if (result.data !== undefined)
+        return result.data;
+    throw new ParseError('Unexpected empty response from API', result.error !== undefined ? JSON.stringify(result.error) : undefined);
+}
+/**
+ * Async iterator that auto-paginates through all pages.
+ * Yields one item at a time.
+ *
+ * @example
+ * for await (const agent of paginate((token) => client.agents.list({ continuation_token: token }))) {
+ *   console.log(agent)
+ * }
+ */
+export async function* paginate(fetcher) {
+    let token = undefined;
+    while (true) {
+        const page = await fetcher(token);
+        for (const item of page.items) {
+            yield item;
+        }
+        if (!page.has_more || page.continuation_token === null)
+            break;
+        token = page.continuation_token;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAI,MAAqC;IAClE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,CAAA;IACjD,MAAM,IAAI,UAAU,CAClB,oCAAoC,EACpC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CACtE,CAAA;AACH,CAAC;AAqBD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAC7B,OAAkE;IAElE,IAAI,KAAK,GAAuB,SAAS,CAAA;IACzC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAA;QACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAA;QACZ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI;YAAE,MAAK;QAC7D,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAA;IACjC,CAAC;AACH,CAAC"}