@amigo-ai/platform-sdk 0.24.0 → 0.26.0

package/dist/resources/events.js

@@ -33,6 +33,29 @@
  * @see ConversationsResource.streamTurn for the analogous turn-stream helper.
  */
 import { WorkspaceScopedResource } from './base.js';
+/**
+ * Structured error surfaced through {@link SubscribeToWorkspaceOptions.onError}.
+ *
+ * Subclasses ``Error`` so existing consumers using ``err.message`` continue
+ * to work, while adding ``code`` + ``retryable`` + raw ``frame`` for
+ * deterministic branching. Inspect with ``isWorkspaceEventStreamError``.
+ */
+export class WorkspaceEventStreamError extends Error {
+    code;
+    retryable;
+    /** Raw decoded ``error`` frame body (or ``undefined`` for transport errors). */
+    frame;
+    constructor(message, code, retryable, frame) {
+        super(message);
+        this.name = 'WorkspaceEventStreamError';
+        this.code = code;
+        this.retryable = retryable;
+        this.frame = frame;
+    }
+}
+export function isWorkspaceEventStreamError(value) {
+    return value instanceof WorkspaceEventStreamError;
+}
 const DEFAULT_INITIAL_DELAY_MS = 3000;
 const DEFAULT_MAX_DELAY_MS = 30000;
 const DEFAULT_MAX_RECONNECTS = 10;
@@ -109,6 +132,24 @@ export class EventsResource extends WorkspaceScopedResource {
         };
     }
 }
+/**
+ * Server-sent ``error`` event frames that the SDK should treat as terminal
+ * (do NOT auto-retry). Mirror the ``code`` taxonomy emitted by
+ * ``platform-api/src/routes/event_stream.py``.
+ */
+const TERMINAL_SERVER_ERROR_CODES = {
+    too_many_streams: 'too_many_streams',
+};
+/**
+ * Server-sent ``error`` event frames that are recoverable — surface them as
+ * transport errors so the reconnect loop kicks in. ``stream_unavailable``
+ * fires when Valkey is down; ``stream_error`` is the generic catch-all from
+ * the server-side ``except Exception`` branch.
+ */
+const RECOVERABLE_SERVER_ERROR_CODES = {
+    stream_unavailable: 'stream_unavailable',
+    stream_error: 'stream_error',
+};
 async function runSubscription(client, workspaceId, options, signal) {
     let lastEventId = options.lastEventId;
     let attempt = 0;
@@ -155,7 +196,9 @@ async function runSubscription(client, workspaceId, options, signal) {
         }
         catch (err) {
             // runOneConnection surfaces only terminal auth errors via throw;
-            // everything else is a StreamOutcome.
+            // everything else is a StreamOutcome. Preserve the original Error
+            // (typically ``AuthenticationError`` with ``statusCode``) so consumers
+            // that branch on ``err.statusCode`` keep working.
             reportError(err instanceof Error ? err : new Error(String(err)));
             return;
         }
@@ -164,12 +207,22 @@ async function runSubscription(client, workspaceId, options, signal) {
         }
         if (outcome.kind === 'auth-error') {
             // 401 / 403 — never auto-retry. The token is invalid and the
-            // stream cannot succeed without operator intervention.
+            // stream cannot succeed without operator intervention. Surface the
+            // original ``AuthenticationError`` so consumers checking
+            // ``err.statusCode`` keep working.
             reportError(outcome.error);
             return;
         }
+        if (outcome.kind === 'terminal-server-error') {
+            // Server emitted a structured ``error`` frame with a code that the
+            // SDK recognizes as terminal (e.g., ``too_many_streams``). Surface
+            // it as a typed ``WorkspaceEventStreamError`` so consumers can branch
+            // on ``error.code`` without parsing free-form text.
+            reportError(new WorkspaceEventStreamError(outcome.message, outcome.code, outcome.retryable, outcome.frame));
+            return;
+        }
         if (attempt >= maxReconnects) {
-            reportError(new Error(`SSE subscription exhausted reconnect budget (${maxReconnects}): ${outcome.reason}`));
+            reportError(new WorkspaceEventStreamError(`SSE subscription exhausted reconnect budget (${maxReconnects}): ${outcome.reason}`, 'transport_exhausted', true));
             return;
         }
         attempt += 1;
@@ -225,6 +278,24 @@ async function runOneConnection(args) {
             if (frame.id !== undefined) {
                 args.onIdAdvance(frame.id);
             }
+            if (frame.event === 'error' && frame.data !== undefined) {
+                // Structured error frame — branch on ``code`` from the server. We
+                // distinguish three buckets: terminal (don't retry), recoverable
+                // (let the reconnect loop run), and unknown (default to recoverable
+                // so a future server code does not strand consumers without auto-
+                // retry).
+                const errOutcome = interpretServerErrorFrame(frame.data);
+                if (errOutcome.terminal) {
+                    return {
+                        kind: 'terminal-server-error',
+                        code: errOutcome.code,
+                        message: errOutcome.message,
+                        retryable: errOutcome.retryable,
+                        frame: errOutcome.frame,
+                    };
+                }
+                return { kind: 'transport-error', reason: errOutcome.message };
+            }
             if (frame.event && frame.data !== undefined) {
                 const event = parseWorkspaceFrame(frame.event, frame.data);
                 if (event) {
@@ -408,6 +479,71 @@ function parseWorkspaceFrame(eventName, dataJson) {
         event_type: eventName,
     };
 }
+/**
+ * Decode a server-sent ``error`` frame body into either a terminal or
+ * recoverable outcome.
+ *
+ * The platform-api event stream emits these shapes:
+ *
+ *   { code: "too_many_streams", message: "...", max_streams: 50 }
+ *   { code: "stream_unavailable", message: "Event streaming unavailable" }
+ *   { code: "stream_error", message: "Stream error, please reconnect" }
+ *
+ * Unknown codes default to recoverable so a server-side addition does not
+ * strand SDK consumers without auto-retry.
+ */
+function interpretServerErrorFrame(dataJson) {
+    let payload;
+    try {
+        payload = JSON.parse(dataJson);
+    }
+    catch {
+        return {
+            terminal: false,
+            code: 'stream_error',
+            message: 'Server sent malformed error frame',
+            retryable: true,
+            frame: {},
+        };
+    }
+    if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+        return {
+            terminal: false,
+            code: 'stream_error',
+            message: 'Server sent non-object error frame',
+            retryable: true,
+            frame: {},
+        };
+    }
+    const obj = payload;
+    const rawCode = typeof obj['code'] === 'string' ? obj['code'] : '';
+    const message = typeof obj['message'] === 'string' ? obj['message'] : 'Stream error';
+    if (rawCode in TERMINAL_SERVER_ERROR_CODES) {
+        return {
+            terminal: true,
+            code: TERMINAL_SERVER_ERROR_CODES[rawCode],
+            message,
+            retryable: false,
+            frame: obj,
+        };
+    }
+    if (rawCode in RECOVERABLE_SERVER_ERROR_CODES) {
+        return {
+            terminal: false,
+            code: RECOVERABLE_SERVER_ERROR_CODES[rawCode],
+            message,
+            retryable: true,
+            frame: obj,
+        };
+    }
+    return {
+        terminal: false,
+        code: 'unknown',
+        message: rawCode ? `${message} (code=${rawCode})` : message,
+        retryable: true,
+        frame: obj,
+    };
+}
 function readStatus(error) {
     if (typeof error !== 'object' || error === null)
         return undefined;

package/dist/resources/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"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"}

package/dist/resources/integrations.js

@@ -55,6 +55,31 @@ export class IntegrationsResource extends WorkspaceScopedResource {
             body,
         }));
     }
+    /**
+     * Probe an integration's connection + auth without invoking any specific
+     * endpoint. Exercises auth resolution end-to-end (SSM lookups, OAuth2 token
+     * mints, JWT signing) and sends a HEAD request to ``base_url`` (REST/FHIR)
+     * or ``mcp_url`` (MCP). Safe on production integrations — HEAD carries no
+     * side effects.
+     *
+     * The most recent probe outcome is persisted on the integration so
+     * subsequent ``get`` / ``list`` responses surface ``last_tested_at`` +
+     * ``last_test_status`` without re-probing.
+     *
+     * @returns ``status`` is one of ``healthy`` / ``auth_failed`` /
+     *   ``unreachable`` / ``timeout`` / ``ssl_error`` / ``misconfigured``,
+     *   each mapping to a distinct, actionable user message.
+     */
+    async testConnection(integrationId) {
+        return extractData(await this.client.POST('/v1/{workspace_id}/integrations/{integration_id}/test-connection', {
+            params: {
+                path: {
+                    workspace_id: this.workspaceId,
+                    integration_id: integrationId,
+                },
+            },
+        }));
+    }
     /** Check health of all integrations in the workspace */
     async getHealthCheck() {
         return extractData(await this.client.GET('/v1/{workspace_id}/integrations/health-check', {

package/dist/resources/integrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../../src/resources/integrations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAShE;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,uBAAuB;IAC/D,+BAA+B;IAC/B,KAAK,CAAC,MAAM,CAAC,IAAuD;QAClE,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;YACxD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;YACpD,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,IAAI,CAAC,MAA+B;QACxC,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,EAAE;YACvD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;SACpE,CAAC,CACH,CAAA;IACH,CAAC;IAED,cAAc,CAAC,MAA+B;QAC5C,OAAO,IAAI,CAAC,oBAAoB,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;IACjF,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,GAAG,CAAC,aAAqC;QAC7C,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kDAAkD,EAAE;YACxE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,EAAE;SACpF,CAAC,CACH,CAAA;IACH,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,MAAM,CACV,aAAqC,EACrC,IAAuD;QAEvD,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kDAAkD,EAAE;YACxE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,EAAE;YACnF,IAAI;SACL,CAAC,CACH,CAAA;IACH,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,MAAM,CAAC,aAAqC;QAChD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kDAAkD,EAAE;YAC3E,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,EAAE;SACpF,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,aAAqC,EACrC,YAAoB,EACpB,IAAkD;QAElD,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,iFAAiF,EACjF;YACE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,YAAY,EAAE,IAAI,CAAC,WAAW;oBAC9B,cAAc,EAAE,aAAa;oBAC7B,aAAa,EAAE,YAAY;iBAC5B;aACF;YACD,IAAI;SACL,CACF,CACF,CAAA;IACH,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,cAAc;QAClB,OAAO,WAAW,CAChB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8CAA8C,EAAE;YACpE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;SACrD,CAAC,CACH,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../../src/resources/integrations.ts"],"names":[],"mappings":"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"}

package/dist/resources/observers.js

@@ -0,0 +1,238 @@
+/**
+ * Voice-call observer real-time stream.
+ *
+ * The voice agent ("agent-engine") exposes a per-call WebSocket that emits
+ * the live timeline of a call: transcripts (user + agent), emotion / empathy
+ * frames, latency markers, tool invocations, navigation timing, and lifecycle
+ * events (start / end / participant join / leave).
+ *
+ * This resource is the canonical SDK consumer for that stream. Before it
+ * existed, every developer-console-style app re-implemented the loop by hand
+ * — different idle thresholds, missing close-code handling for the long list
+ * of voice-specific 4xxx codes (4001 unauthorized, 4003 forbidden, 4029 rate
+ * limit, 4100 token expired), and inconsistent reconnect backoff.
+ *
+ * The implementation composes {@link createReconnectingWebSocket} with a
+ * lightweight ``ObserverSSEEvent`` parser. Frames that don't deserialize or
+ * lack a recognized ``type`` discriminator are dropped — the stream remains
+ * forward-compatible with new event types added on the server before the SDK
+ * spec snapshot picks them up.
+ *
+ * @see ConversationsResource.subscribeTextStream for the analogous text-stream
+ *   helper.
+ */
+import { ConfigurationError } from '../core/errors.js';
+import { createReconnectingWebSocket, } from '../core/reconnecting-websocket.js';
+import { WorkspaceScopedResource } from './base.js';
+/** Token grammar accepted in WebSocket subprotocols (RFC 6455). */
+const WEB_SOCKET_PROTOCOL_TOKEN_RE = /^[!#$%&'*+\-.^_`|~A-Za-z0-9]+$/;
+const MAX_AUTH_TOKEN_CHARS = 4096;
+/**
+ * Build browser WebSocket subprotocols for the observer stream.
+ *
+ * Identical wire format to the text-stream subprotocol pair —
+ * ``Sec-WebSocket-Protocol: auth, <token>`` — but exposed as its own
+ * function so consumers do not have to reason about cross-resource sharing
+ * and so the SDK can evolve the auth scheme independently per stream.
+ *
+ * @security The returned tuple contains the raw bearer token. Do not log,
+ *   persist, serialize, or otherwise expose this value.
+ */
+export function observerAuthProtocols(token) {
+    if (!token) {
+        throw new ConfigurationError('observerAuthProtocols requires a non-empty token');
+    }
+    if (token.length > MAX_AUTH_TOKEN_CHARS) {
+        throw new ConfigurationError(`observer token exceeds the ${MAX_AUTH_TOKEN_CHARS}-character WebSocket subprotocol limit`);
+    }
+    if (!WEB_SOCKET_PROTOCOL_TOKEN_RE.test(token)) {
+        throw new ConfigurationError('observer token contains characters browsers reject in WebSocket subprotocols');
+    }
+    return ['auth', token];
+}
+/**
+ * Voice-call observer resource.
+ *
+ * @example
+ * ```ts
+ * const handle = client.observers.subscribe({
+ *   callSid: 'CAxxx',
+ *   token: bearerToken,
+ *   onEvent: (event) => {
+ *     switch (event.type) {
+ *       case 'agent_transcript_delta':
+ *         renderAgentDelta(event.text)
+ *         break
+ *       case 'user_transcript':
+ *         renderUserTurn(event.text)
+ *         break
+ *       case 'session_end':
+ *         showSummary(event)
+ *         break
+ *     }
+ *   },
+ *   onError: (err) => console.error('observer terminal:', err.reason),
+ * })
+ *
+ * // Later, to stop:
+ * handle.close()
+ * await handle.done
+ * ```
+ */
+export class ObserversResource extends WorkspaceScopedResource {
+    agentBaseUrl;
+    constructor(client, workspaceId, agentBaseUrl) {
+        super(client, workspaceId);
+        this.agentBaseUrl = agentBaseUrl;
+    }
+    /**
+     * Subscribe to the live observer stream for a call.
+     *
+     * Returns a {@link ReconnectingWebSocketHandle} that resolves
+     * ``handle.done`` when the stream terminates (consumer-aborted, terminal
+     * close code, or reconnect budget exhausted). Errors are surfaced through
+     * ``onError``; the promise never rejects.
+     */
+    subscribe(options) {
+        const url = buildObserverUrl({
+            baseUrl: this.agentBaseUrl ?? this.platformBaseUrl,
+            workspaceId: this.workspaceId,
+            callSid: options.callSid,
+            observerUrl: options.observerUrl,
+        });
+        const protocols = observerAuthProtocols(options.token);
+        return createReconnectingWebSocket({
+            url,
+            protocols: [...protocols],
+            onMessage: (ev) => {
+                const parsed = parseObserverFrame(ev.data);
+                if (parsed) {
+                    try {
+                        options.onEvent(parsed);
+                    }
+                    catch {
+                        // Consumer threw in onEvent — do not let it kill the loop.
+                    }
+                }
+            },
+            onStateChange: options.onStateChange,
+            onReconnect: options.onReconnect,
+            onError: options.onError,
+            signal: options.signal,
+            idleTimeoutMs: options.idleTimeoutMs ?? 60_000,
+            initialDelayMs: options.initialDelayMs ?? 1_000,
+            maxDelayMs: options.maxDelayMs ?? 30_000,
+            maxReconnects: options.maxReconnects ?? 10,
+            webSocketFactory: options.webSocketFactory,
+        });
+    }
+}
+const CALL_SID_RE = /^CA[a-zA-Z0-9]{32}$/;
+function buildObserverUrl(args) {
+    if (!args.workspaceId) {
+        throw new ConfigurationError('workspaceId is required to build the observer URL');
+    }
+    if (!args.callSid) {
+        throw new ConfigurationError('callSid is required to subscribe to the observer stream');
+    }
+    if (args.observerUrl) {
+        // Override path — the consumer has already constructed the full URL
+        // (e.g. via a custom voice-agent gateway helper). Skip the Twilio CA
+        // SID grammar check; the override owns the URL shape.
+        return parseOverride(args.observerUrl).toString();
+    }
+    // Default path — derive ``/v1/{ws}/observers/{callSid}/ws`` and validate
+    // the CA SID grammar so a typo fails at the function boundary instead of
+    // mid-reconnect-loop with an opaque 4001.
+    if (!CALL_SID_RE.test(args.callSid)) {
+        throw new ConfigurationError(`callSid does not match Twilio CA SID format (CA + 32 hex chars): ${args.callSid}`);
+    }
+    return deriveFromBase(args.baseUrl, args.workspaceId, args.callSid).toString();
+}
+function parseOverride(observerUrl) {
+    let url;
+    try {
+        url = new URL(observerUrl);
+    }
+    catch (cause) {
+        throw new ConfigurationError(`observerUrl must be an absolute URL: ${String(cause)}`);
+    }
+    if (url.protocol !== 'ws:' && url.protocol !== 'wss:') {
+        throw new ConfigurationError('observerUrl overrides must use ws: or wss: URLs');
+    }
+    if (url.search || url.hash) {
+        throw new ConfigurationError('observerUrl overrides must not include query parameters or fragments');
+    }
+    return url;
+}
+function deriveFromBase(baseUrl, workspaceId, callSid) {
+    let parsed;
+    try {
+        parsed = new URL(baseUrl);
+    }
+    catch (cause) {
+        throw new ConfigurationError(`observerUrl cannot be derived from baseUrl: ${String(cause)}`);
+    }
+    // Map http(s) to ws(s) — the agent-engine ALB serves both on the same host.
+    let scheme;
+    if (parsed.protocol === 'https:' || parsed.protocol === 'wss:')
+        scheme = 'wss:';
+    else if (parsed.protocol === 'http:' || parsed.protocol === 'ws:')
+        scheme = 'ws:';
+    else {
+        throw new ConfigurationError(`observerUrl can only be derived from an http, https, ws, or wss baseUrl: ${baseUrl}`);
+    }
+    // The pathname must be '/' — observer paths are owned by this helper,
+    // not the consumer's baseUrl gateway.
+    if (parsed.pathname !== '/' && parsed.pathname !== '') {
+        throw new ConfigurationError('observerUrl can only be derived from an origin-only baseUrl; pass observerUrl explicitly when using path-prefixed gateways');
+    }
+    const out = new URL(`${scheme}//${parsed.host}/v1/${encodeURIComponent(workspaceId)}/observers/${encodeURIComponent(callSid)}/ws`);
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Frame parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse a raw WebSocket frame into a typed {@link ObserverSSEEvent}.
+ *
+ * Drift-tolerant: returns ``null`` on JSON decode errors, non-object
+ * payloads, missing ``type`` discriminator, or unknown discriminator
+ * values. The static type of ``ObserverSSEEvent`` is the contract — the
+ * server may add new event types ahead of an SDK release and the consumer's
+ * exhaustive ``switch`` will simply not match them, leaving the unknown
+ * frame on the floor.
+ */
+function parseObserverFrame(data) {
+    let text;
+    if (typeof data === 'string') {
+        text = data;
+    }
+    else if (data instanceof ArrayBuffer) {
+        text = new TextDecoder().decode(data);
+    }
+    else if (ArrayBuffer.isView(data)) {
+        // ``data`` is some TypedArray; @types/node TextDecoder.decode wants
+        // ``BufferSource``. Pass through as ``Uint8Array`` over the underlying
+        // buffer so every TypedArray variant decodes consistently.
+        const view = data;
+        text = new TextDecoder().decode(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
+    }
+    else {
+        return null;
+    }
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (typeof payload !== 'object' || payload === null || Array.isArray(payload))
+        return null;
+    const obj = payload;
+    if (typeof obj['type'] !== 'string')
+        return null;
+    return obj;
+}
+//# sourceMappingURL=observers.js.map

package/dist/resources/observers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observers.js","sourceRoot":"","sources":["../../src/resources/observers.ts"],"names":[],"mappings":"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"}

package/dist/types/core/errors.d.ts

@@ -2,20 +2,74 @@
  * Error hierarchy for the Amigo Platform SDK.
  * All errors extend AmigoError which can be caught with a single catch.
  */
+import type { components } from '../generated/api.js';
 export interface ErrorContext {
     statusCode?: number;
     errorCode?: string;
     requestId?: string;
     detail?: string;
     context?: Record<string, unknown>;
+    /** Parsed error body (typed when recognized) */
+    errorBody?: PlatformErrorBody;
+    /** Raw body string for diagnostic logging — populated even on parse failure */
+    rawBody?: string;
 }
+/**
+ * FastAPI 422 validation-error body.
+ * Surfaces from openapi-typescript so consumers can read field-level errors.
+ */
+export type HttpValidationErrorBody = components['schemas']['HTTPValidationError'];
+/**
+ * Default FastAPI HTTPException shape (`raise HTTPException(status_code, detail=...)`).
+ *
+ * Most platform-api routes that don't define an explicit error model return
+ * this shape. `detail` may be a free-form string or a JSON-serializable object.
+ */
+export interface HttpExceptionBody {
+    detail: string | Record<string, unknown> | unknown[];
+    /** Populated by request-id middleware on bounded routes */
+    request_id?: string;
+    /** Populated by typed error responses (e.g. Surface lifecycle errors) */
+    error_code?: string;
+}
+/**
+ * Fallback shape used when the response body fails to parse or is empty.
+ * `rawBody` is the verbatim text (truncated to 8 KB to avoid log bloat).
+ */
+export interface UnparseableErrorBody {
+    detail: string;
+    raw_body: string;
+}
+/**
+ * Discriminated union of all error body shapes the platform API emits.
+ *
+ * Consumers should use the type guards (`isHttpException`,
+ * `isHttpValidationError`, `isUnparseableErrorBody`) rather than checking
+ * fields directly — both `HttpExceptionBody` and `HttpValidationErrorBody`
+ * have a `detail` field but it is shaped differently.
+ */
+export type PlatformErrorBody = HttpExceptionBody | HttpValidationErrorBody | UnparseableErrorBody;
 /** Base class for all Amigo Platform SDK errors */
-export declare class AmigoError extends Error {
+export declare class AmigoError<TBody extends PlatformErrorBody = PlatformErrorBody> extends Error {
     readonly statusCode?: number;
     readonly errorCode?: string;
     readonly requestId?: string;
     readonly detail?: string;
     readonly context?: Record<string, unknown>;
+    /**
+     * Typed body of the error response, when one was returned and successfully
+     * parsed. Use the `isHttpException` / `isHttpValidationError` /
+     * `isUnparseableErrorBody` type guards to narrow the discriminated union.
+     *
+     * Named `errorBody` (not `body`) to avoid colliding with the legacy
+     * `ParseError.body: string` field.
+     */
+    readonly errorBody?: TBody;
+    /**
+     * Raw response body (truncated to 8 KB). Populated even when parsing fails,
+     * so callers always have something to log when debugging server errors.
+     */
+    readonly rawBody?: string;
     constructor(message: string, ctx?: ErrorContext);
     toJSON(): Record<string, unknown>;
 }
@@ -82,4 +136,42 @@ export declare function isNotFoundError(err: unknown): err is NotFoundError;
 export declare function isRateLimitError(err: unknown): err is RateLimitError;
 export declare function isAuthenticationError(err: unknown): err is AuthenticationError;
 export declare function isRequestTimeoutError(err: unknown): err is RequestTimeoutError;
+export declare function isPermissionError(err: unknown): err is PermissionError;
+export declare function isConflictError(err: unknown): err is ConflictError;
+export declare function isValidationError(err: unknown): err is ValidationError;
+export declare function isServerError(err: unknown): err is ServerError;
+export declare function isNetworkError(err: unknown): err is NetworkError;
+/**
+ * Narrowed AmigoError where `errorBody` is guaranteed non-undefined.
+ * Used as the return-type for body type guards so consumers don't need to
+ * re-assert `errorBody !== undefined` after the guard.
+ */
+export type AmigoErrorWithBody<TBody extends PlatformErrorBody> = AmigoError<TBody> & {
+    readonly errorBody: TBody;
+};
+/**
+ * True when `err.errorBody` is the FastAPI 422 validation-error shape (an
+ * object with `detail: ValidationError[]`). Lets consumers iterate
+ * field-level errors without `as any`:
+ *
+ * ```ts
+ * if (isHttpValidationError(err)) {
+ *   for (const issue of err.errorBody.detail ?? []) {
+ *     console.log(issue.loc, issue.msg)
+ *   }
+ * }
+ * ```
+ */
+export declare function isHttpValidationError(err: unknown): err is AmigoErrorWithBody<HttpValidationErrorBody>;
+/**
+ * True when `err.errorBody` is the default FastAPI HTTPException shape
+ * (`{ detail: string | object | array }`, possibly with `error_code` /
+ * `request_id`). This is the most common error body across platform-api.
+ */
+export declare function isHttpException(err: unknown): err is AmigoErrorWithBody<HttpExceptionBody>;
+/**
+ * True when the response body could not be parsed as JSON (or was empty).
+ * `err.errorBody.raw_body` is the verbatim text (truncated to 8 KB).
+ */
+export declare function isUnparseableErrorBody(err: unknown): err is AmigoErrorWithBody<UnparseableErrorBody>;
 //# sourceMappingURL=errors.d.ts.map