@pellux/goodvibes-sdk 0.18.53 → 0.19.8

package/dist/_internal/platform/web-search/service.d.ts

@@ -1,6 +1,6 @@
 import { type FetchRuntimeDeps } from '../tools/fetch/index.js';
 import { WebSearchProviderRegistry } from './provider-registry.js';
-import type { WebSearchRequest, WebSearchResponse } from '@pellux/goodvibes-sdk/platform/web-search/types';
+import type { WebSearchRequest, WebSearchResponse } from './types.js';
 export interface WebSearchServiceStatus {
     readonly enabled: boolean;
     readonly providerCount: number;

package/dist/_internal/platform/web-search/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/web-search/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAGV,gBAAgB,EAChB,iBAAiB,EAGlB,MAAM,iDAAiD,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAkCD,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAGvC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,GAAE,gBAAqB;IAG7C,SAAS,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAU5C,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAyBrD,cAAc;CA+C7B"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/web-search/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAGV,gBAAgB,EAChB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAkCD,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAGvC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,GAAE,gBAAqB;IAG7C,SAAS,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAU5C,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAyBrD,cAAc;CA+C7B"}

package/dist/_internal/transport-core/client-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-transport.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/client-transport.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK;IACrE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,iBAAiB,IAAI,SAAS,CAAC;IAC/B,aAAa,IAAI,KAAK,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK,EAC1E,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAY1C"}
+{"version":3,"file":"client-transport.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/client-transport.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK;IACrE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,iBAAiB,IAAI,SAAS,CAAC;IAC/B,aAAa,IAAI,KAAK,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK,EAC1E,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAY1C"}

package/dist/_internal/transport-core/event-envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-envelope.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/event-envelope.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ;IAC3D,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,EAChE,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAYhC"}
+{"version":3,"file":"event-envelope.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/event-envelope.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ;IAC3D,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,EAChE,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAYhC"}

package/dist/_internal/transport-core/event-feeds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-feeds.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/event-feeds.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,KAAK,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,KAAK,YAAY,CACf,MAAM,SAAS,SAAS,EACxB,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,IAC1B,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAErC,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IACpE,EAAE,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,GACvD,MAAM,IAAI,CAAC;IACd,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACrC,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,GAC9E,MAAM,IAAI,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,CAC3B,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,GAAG,SAAS,IAClC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACnD,GAAG;IACF,QAAQ,EAAE,CAAC,IAAI,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,SAAS,IAAI,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACtF,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,KAC5E,MAAM,IAAI,CAAC;AAEhB,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,SAAS,EAC7D,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,GACpC,gBAAgB,CAAC,MAAM,CAAC,CAiB1B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,EAExB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,gBAAgB,CAAC,MAAM,CAAC,GACxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAYpC"}
+{"version":3,"file":"event-feeds.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/event-feeds.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,KAAK,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,KAAK,YAAY,CACf,MAAM,SAAS,SAAS,EACxB,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,IAC1B,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAErC,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IACpE,EAAE,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,GACvD,MAAM,IAAI,CAAC;IACd,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACrC,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,GAC9E,MAAM,IAAI,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,CAC3B,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,GAAG,SAAS,IAClC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACnD,GAAG;IACF,QAAQ,EAAE,CAAC,IAAI,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,SAAS,IAAI,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACtF,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,KAC5E,MAAM,IAAI,CAAC;AAEhB,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,SAAS,EAC7D,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,GACpC,gBAAgB,CAAC,MAAM,CAAC,CAiB1B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,EAExB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,gBAAgB,CAAC,MAAM,CAAC,GACxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAYpC"}

package/dist/_internal/transport-core/index.d.ts

@@ -4,4 +4,9 @@ export type { RuntimeEventFeed, RuntimeEventFeeds, EnvelopeSubscriber } from './
 export { createRuntimeEventFeed, createRuntimeEventFeeds } from './event-feeds.js';
 export type { ClientTransport } from './client-transport.js';
 export { createClientTransport } from './client-transport.js';
+export type { TransportObserver, TransportActivityInfo } from './observer.js';
+export { invokeTransportObserver } from './observer.js';
+export type { TransportContext, TransportMiddleware } from './middleware.js';
+export { composeMiddleware } from './middleware.js';
+export { injectTraceparent, injectTraceparentAsync } from './otel.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/_internal/transport-core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/_internal/transport-core/index.js

@@ -1,3 +1,6 @@
 export { createEventEnvelope } from './event-envelope.js';
 export { createRuntimeEventFeed, createRuntimeEventFeeds } from './event-feeds.js';
 export { createClientTransport } from './client-transport.js';
+export { invokeTransportObserver } from './observer.js';
+export { composeMiddleware } from './middleware.js';
+export { injectTraceparent, injectTraceparentAsync } from './otel.js';

package/dist/_internal/transport-core/middleware.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Transport middleware (Koa-style) for the HTTP transport layer.
+ *
+ * Middleware functions wrap the real fetch call and receive a mutable context
+ * object. Calling `next()` executes the next middleware in the chain (or the
+ * real fetch at the end). After `await next()` returns, `ctx.response` and
+ * `ctx.durationMs` are populated; `ctx.error` is set if the fetch threw.
+ *
+ * @example
+ * sdk.use(async (ctx, next) => {
+ *   console.log('->', ctx.method, ctx.url);
+ *   await next();
+ *   console.log('<-', ctx.response?.status, ctx.durationMs, 'ms');
+ * });
+ */
+/**
+ * Mutable context object passed through the middleware chain.
+ * Fields are populated progressively: request fields are set before the chain
+ * runs; response fields are set after the real fetch resolves.
+ */
+export interface TransportContext {
+    /** HTTP method (uppercased). */
+    method: string;
+    /** Fully-qualified request URL. */
+    url: string;
+    /** Request headers (mutable — middleware may add/override). */
+    headers: Record<string, string>;
+    /** Request body (undefined for GET/HEAD). */
+    body: unknown;
+    /** Per-request options forwarded from the caller. */
+    options: {
+        readonly signal?: AbortSignal;
+        readonly retry?: unknown;
+        [key: string]: unknown;
+    };
+    /** AbortSignal for the request. Propagated from caller options. */
+    signal?: AbortSignal;
+    /** The HTTP response object — set after `next()` resolves successfully. */
+    response?: Response;
+    /** Round-trip duration in milliseconds — set after `next()` resolves. */
+    durationMs?: number;
+    /** Error thrown by the fetch or a downstream middleware — set on failure. */
+    error?: unknown;
+    /**
+     * Set to `true` when the error originated from within the middleware chain
+     * (as opposed to from the real fetch). Used by the transport to wrap
+     * middleware errors as `SDKError{kind:'unknown'}`.
+     */
+    middlewareError?: boolean;
+    /**
+     * Name (or index) of the middleware that was active when the error occurred.
+     * Set alongside `middlewareError` for error identity in cause objects.
+     */
+    activeMiddlewareName?: string;
+}
+/**
+ * A transport middleware function.
+ *
+ * @param ctx  - Shared mutable context for the request/response cycle.
+ * @param next - Calls the next middleware (or the real fetch at the end).
+ */
+export type TransportMiddleware = (ctx: TransportContext, next: () => Promise<void>) => Promise<void>;
+/**
+ * Build a composed middleware executor from an ordered array of middleware.
+ * The last item in the chain calls the real fetch via `innerFetch`.
+ *
+ * Returns a function that:
+ *  1. Mutates `ctx.headers` with any header overrides from middleware.
+ *  2. Calls through the chain.
+ *  3. Sets `ctx.response`, `ctx.durationMs`, or `ctx.error` on the context.
+ *
+ * @param middleware - Ordered list of middleware functions.
+ * @param innerFetch - The real fetch call wrapped at the end of the chain.
+ */
+export declare function composeMiddleware(middleware: readonly TransportMiddleware[], innerFetch: (ctx: TransportContext) => Promise<Response>): (ctx: TransportContext) => Promise<void>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/_internal/transport-core/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/middleware.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6CAA6C;IAC7C,IAAI,EAAE,OAAO,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE;QACP,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,UAAU,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,GACvD,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAsC1C"}

package/dist/_internal/transport-core/middleware.js

@@ -0,0 +1,67 @@
+// Synced from packages/transport-core/src/middleware.ts
+/**
+ * Transport middleware (Koa-style) for the HTTP transport layer.
+ *
+ * Middleware functions wrap the real fetch call and receive a mutable context
+ * object. Calling `next()` executes the next middleware in the chain (or the
+ * real fetch at the end). After `await next()` returns, `ctx.response` and
+ * `ctx.durationMs` are populated; `ctx.error` is set if the fetch threw.
+ *
+ * @example
+ * sdk.use(async (ctx, next) => {
+ *   console.log('->', ctx.method, ctx.url);
+ *   await next();
+ *   console.log('<-', ctx.response?.status, ctx.durationMs, 'ms');
+ * });
+ */
+/**
+ * Build a composed middleware executor from an ordered array of middleware.
+ * The last item in the chain calls the real fetch via `innerFetch`.
+ *
+ * Returns a function that:
+ *  1. Mutates `ctx.headers` with any header overrides from middleware.
+ *  2. Calls through the chain.
+ *  3. Sets `ctx.response`, `ctx.durationMs`, or `ctx.error` on the context.
+ *
+ * @param middleware - Ordered list of middleware functions.
+ * @param innerFetch - The real fetch call wrapped at the end of the chain.
+ */
+export function composeMiddleware(middleware, innerFetch) {
+    return async (ctx) => {
+        let index = -1;
+        const dispatch = async (i) => {
+            if (i <= index) {
+                throw new Error('next() called multiple times in transport middleware');
+            }
+            index = i;
+            if (i < middleware.length) {
+                const mw = middleware[i];
+                const mwName = mw.name || String(i);
+                ctx.activeMiddlewareName = mwName;
+                try {
+                    await mw(ctx, () => dispatch(i + 1));
+                }
+                catch (err) {
+                    // Mark that the error originated from this middleware (not the real fetch).
+                    ctx.middlewareError = true;
+                    ctx.activeMiddlewareName = mwName;
+                    throw err;
+                }
+            }
+            else {
+                // End of chain — execute the real fetch.
+                const sendAt = Date.now();
+                try {
+                    ctx.response = await innerFetch(ctx);
+                    ctx.durationMs = Date.now() - sendAt;
+                }
+                catch (err) {
+                    ctx.error = err;
+                    ctx.durationMs = Date.now() - sendAt;
+                    throw err;
+                }
+            }
+        };
+        await dispatch(0);
+    };
+}

package/dist/_internal/transport-core/observer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * TransportObserver — first-class observability interface at the transport layer.
+ *
+ * Defined here (transport-core) so that HTTP and realtime sibling transports can
+ * accept it through their shared options types without depending on the SDK layer.
+ * `SDKObserver` in `@pellux/goodvibes-sdk` extends this interface and adds
+ * SDK-level callbacks (`onEvent`, `onAuthTransition`).
+ *
+ * All methods are optional. Observer exceptions are always swallowed via
+ * `invokeObserver` — they must never propagate into transport control flow.
+ */
+/**
+ * Transport activity metadata surfaced at request/response boundaries.
+ */
+export interface TransportActivityInfo {
+    /** Direction: `'send'` before the request, `'recv'` after a response. */
+    readonly direction: 'send' | 'recv';
+    /** The full URL of the request. */
+    readonly url: string;
+    /** HTTP response status code (only present on `'recv'`). */
+    readonly status?: number;
+    /** Round-trip duration in milliseconds (only present on `'recv'`). */
+    readonly durationMs?: number;
+    /** Transport kind. */
+    readonly kind?: 'http' | 'sse' | 'ws';
+}
+/**
+ * Minimal observer interface at the transport layer.
+ *
+ * Implement any subset; the SDK works identically whether an observer is
+ * present or not. All call sites are wrapped in a silent try/catch.
+ */
+export interface TransportObserver {
+    /**
+     * Called when the SDK catches and is about to rethrow a transport error.
+     * The error is still rethrown; this is notification only.
+     */
+    onError?(err: Error): void;
+    /**
+     * Called at HTTP/SSE/WebSocket transport boundaries.
+     * - `'send'` fires before the request is dispatched.
+     * - `'recv'` fires after a response is received (status + duration included).
+     */
+    onTransportActivity?(activity: TransportActivityInfo): void;
+}
+/**
+ * Safely invoke an observer method. Observer errors are swallowed so they
+ * never disrupt transport control flow.
+ *
+ * @param fn - Zero-argument thunk wrapping the observer call.
+ */
+export declare function invokeTransportObserver(fn: () => void): void;
+//# sourceMappingURL=observer.d.ts.map

package/dist/_internal/transport-core/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/observer.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC7D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAM5D"}

package/dist/_internal/transport-core/observer.js

@@ -0,0 +1,26 @@
+// Synced from packages/transport-core/src/observer.ts
+/**
+ * TransportObserver — first-class observability interface at the transport layer.
+ *
+ * Defined here (transport-core) so that HTTP and realtime sibling transports can
+ * accept it through their shared options types without depending on the SDK layer.
+ * `SDKObserver` in `@pellux/goodvibes-sdk` extends this interface and adds
+ * SDK-level callbacks (`onEvent`, `onAuthTransition`).
+ *
+ * All methods are optional. Observer exceptions are always swallowed via
+ * `invokeObserver` — they must never propagate into transport control flow.
+ */
+/**
+ * Safely invoke an observer method. Observer errors are swallowed so they
+ * never disrupt transport control flow.
+ *
+ * @param fn - Zero-argument thunk wrapping the observer call.
+ */
+export function invokeTransportObserver(fn) {
+    try {
+        fn();
+    }
+    catch {
+        // Observer errors must not propagate into transport logic.
+    }
+}

package/dist/_internal/transport-core/otel.d.ts

@@ -0,0 +1,64 @@
+/**
+ * OpenTelemetry traceparent/tracestate propagation helper.
+ *
+ * Zero-dependency: detects `@opentelemetry/api` at runtime.
+ * If OTel is absent, all functions are no-ops.
+ *
+ * Dynamic detection uses an indirect import pattern to prevent bundlers
+ * (esbuild, Rollup, Miniflare/workerd) from flagging the import as an
+ * unresolvable dynamic specifier. The module name is never a literal in
+ * any import() call that the bundler sees.
+ *
+ * W3C Trace Context spec: https://www.w3.org/TR/trace-context/
+ */
+interface SpanContext {
+    traceId: string;
+    spanId: string;
+    traceFlags: number;
+    traceState?: {
+        serialize(): string;
+    } | null;
+}
+interface Span {
+    spanContext(): SpanContext;
+}
+interface OtelApi {
+    trace: {
+        getActiveSpan(): Span | undefined;
+    };
+}
+/**
+ * Set the OTel module override for testing. Pass `undefined` to clear.
+ * Calling this bypasses dynamic import and require-based detection.
+ *
+ * @internal — for testing only, do NOT use in production code.
+ */
+export declare function setOtelModuleOverride(api: OtelApi | null | undefined): void;
+/**
+ * Get the current OTel module override (for test inspection).
+ * @internal
+ */
+export declare function getOtelModuleOverride(): OtelApi | null | undefined;
+/**
+ * Reset both the module-level cache and the test injection seam.
+ * Call this in `afterEach` when using `setOtelModuleOverride` in tests.
+ *
+ * @internal — for testing only.
+ */
+export declare function __resetOtelCache(): void;
+/**
+ * Inject W3C Trace Context headers (`traceparent`, `tracestate`) if an active
+ * OTel span is available. Synchronous; uses require-based detection.
+ *
+ * @param headers - Mutable header record to augment in-place.
+ */
+export declare function injectTraceparent(headers: Record<string, string>): void;
+/**
+ * Async variant — probes OTel via dynamic import on first call, then caches.
+ * Use for SSE/WS connection setup where async is acceptable.
+ *
+ * @param headers - Mutable header record to augment in-place.
+ */
+export declare function injectTraceparentAsync(headers: Record<string, string>): Promise<void>;
+export {};
+//# sourceMappingURL=otel.d.ts.map

package/dist/_internal/transport-core/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-core/otel.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;GAYG;AAEH,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE;QAAE,SAAS,IAAI,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7C;AAED,UAAU,IAAI;IACZ,WAAW,IAAI,WAAW,CAAC;CAC5B;AAED,UAAU,OAAO;IACf,KAAK,EAAE;QACL,aAAa,IAAI,IAAI,GAAG,SAAS,CAAC;KACnC,CAAC;CACH;AAQD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAE3E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,GAAG,IAAI,GAAG,SAAS,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAkDD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAgBvE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3F"}

package/dist/_internal/transport-core/otel.js

@@ -0,0 +1,149 @@
+// Synced from packages/transport-core/src/otel.ts
+/**
+ * OpenTelemetry traceparent/tracestate propagation helper.
+ *
+ * Zero-dependency: detects `@opentelemetry/api` at runtime.
+ * If OTel is absent, all functions are no-ops.
+ *
+ * Dynamic detection uses an indirect import pattern to prevent bundlers
+ * (esbuild, Rollup, Miniflare/workerd) from flagging the import as an
+ * unresolvable dynamic specifier. The module name is never a literal in
+ * any import() call that the bundler sees.
+ *
+ * W3C Trace Context spec: https://www.w3.org/TR/trace-context/
+ */
+/** Cached result of OTel detection. `null` = not available. `undefined` = not yet probed. */
+let otelApi = undefined;
+/** Internal override value for the test injection seam. */
+let _otelModuleOverride = undefined;
+/**
+ * Set the OTel module override for testing. Pass `undefined` to clear.
+ * Calling this bypasses dynamic import and require-based detection.
+ *
+ * @internal — for testing only, do NOT use in production code.
+ */
+export function setOtelModuleOverride(api) {
+    _otelModuleOverride = api;
+}
+/**
+ * Get the current OTel module override (for test inspection).
+ * @internal
+ */
+export function getOtelModuleOverride() {
+    return _otelModuleOverride;
+}
+/**
+ * Reset both the module-level cache and the test injection seam.
+ * Call this in `afterEach` when using `setOtelModuleOverride` in tests.
+ *
+ * @internal — for testing only.
+ */
+export function __resetOtelCache() {
+    otelApi = undefined;
+    _otelModuleOverride = undefined;
+}
+/**
+ * Dynamic import that is opaque to bundlers.
+ * `new Function(...)` is not statically analysed for import() specifiers.
+ */
+function dynamicImport(moduleName) {
+    // Using Function constructor prevents bundler static analysis of import().
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
+    return new Function('m', 'return import(m)')(moduleName);
+}
+async function probeOtel() {
+    // Test injection seam takes highest priority.
+    if (_otelModuleOverride !== undefined)
+        return _otelModuleOverride;
+    if (otelApi !== undefined)
+        return otelApi;
+    try {
+        const mod = await dynamicImport('@opentelemetry/api');
+        otelApi = mod;
+    }
+    catch {
+        otelApi = null;
+    }
+    return otelApi;
+}
+function probeOtelSync() {
+    // Test injection seam takes highest priority.
+    if (_otelModuleOverride !== undefined)
+        return _otelModuleOverride;
+    if (otelApi !== undefined)
+        return otelApi;
+    try {
+        // Use globalThis.require via indirect reference to avoid bundler module resolution.
+        const nodeRequire = typeof globalThis !== 'undefined'
+            ? globalThis.require
+            : undefined;
+        if (typeof nodeRequire === 'function') {
+            otelApi = nodeRequire('@opentelemetry/api');
+        }
+        else {
+            otelApi = null;
+        }
+    }
+    catch {
+        otelApi = null;
+    }
+    return otelApi;
+}
+function buildTraceparent(ctx) {
+    const flags = (ctx.traceFlags & 0xff).toString(16).padStart(2, '0');
+    return `00-${ctx.traceId}-${ctx.spanId}-${flags}`;
+}
+/**
+ * Inject W3C Trace Context headers (`traceparent`, `tracestate`) if an active
+ * OTel span is available. Synchronous; uses require-based detection.
+ *
+ * @param headers - Mutable header record to augment in-place.
+ */
+export function injectTraceparent(headers) {
+    const api = probeOtelSync();
+    if (!api)
+        return;
+    try {
+        const span = api.trace.getActiveSpan();
+        if (!span)
+            return;
+        const ctx = span.spanContext();
+        if (!ctx.traceId || !ctx.spanId)
+            return;
+        headers['traceparent'] = buildTraceparent(ctx);
+        const traceState = ctx.traceState?.serialize();
+        if (traceState) {
+            headers['tracestate'] = traceState;
+        }
+    }
+    catch {
+        // Never let OTel errors propagate into transport logic.
+    }
+}
+/**
+ * Async variant — probes OTel via dynamic import on first call, then caches.
+ * Use for SSE/WS connection setup where async is acceptable.
+ *
+ * @param headers - Mutable header record to augment in-place.
+ */
+export async function injectTraceparentAsync(headers) {
+    const api = await probeOtel();
+    if (!api)
+        return;
+    try {
+        const span = api.trace.getActiveSpan();
+        if (!span)
+            return;
+        const ctx = span.spanContext();
+        if (!ctx.traceId || !ctx.spanId)
+            return;
+        headers['traceparent'] = buildTraceparent(ctx);
+        const traceState = ctx.traceState?.serialize();
+        if (traceState) {
+            headers['tracestate'] = traceState;
+        }
+    }
+    catch {
+        // Never let OTel errors propagate into transport logic.
+    }
+}

package/dist/_internal/transport-direct/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-direct/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEzF,MAAM,MAAM,qBAAqB,CAAC,SAAS,EAAE,KAAK,IAAI,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAElG,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,KAAK,EAC1D,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,KAAK,GACV,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC,CAEzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-direct/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEzF,MAAM,MAAM,qBAAqB,CAAC,SAAS,EAAE,KAAK,IAAI,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAElG,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,KAAK,EAC1D,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,KAAK,GACV,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC,CAEzC"}

package/dist/_internal/transport-direct/index.js

@@ -1,5 +1,4 @@
 // Synced from packages/transport-direct/src/index.ts
-// Extracted from legacy source: src/runtime/transports/direct-client.ts
 import { createClientTransport } from '../transport-core/index.js';
 export function createDirectClientTransport(operator, peer) {
     return createClientTransport('direct', operator, peer);

package/dist/_internal/transport-http/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-http/auth.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,MAAM,YAAY,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B,iBAAiB,GACjB,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GACtE,SAAS,CAAC;AAEd,MAAM,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;AAuBzE,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,OAAO,CAMhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAY3E;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,YAAY,CAAC,EAAE,iBAAiB,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,UAAU,CAAC,EAAE,cAAc,GAC1B,OAAO,CAAC,OAAO,CAAC,CAGlB"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-http/auth.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,MAAM,YAAY,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B,iBAAiB,GACjB,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GACtE,SAAS,CAAC;AAEd,MAAM,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;AAuBzE,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,OAAO,CAMhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAY3E;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,YAAY,CAAC,EAAE,iBAAiB,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,UAAU,CAAC,EAAE,cAAc,GAC1B,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/_internal/transport-http/backoff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-http/backoff.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,QAAQ,EAAE,qBAAqB,GAC9B,qBAAqB,CAOvB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,qBAAqB,GAC5B,MAAM,CAKR;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAoBf"}
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-http/backoff.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,QAAQ,EAAE,qBAAqB,GAC9B,qBAAqB,CAOvB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,qBAAqB,GAC5B,MAAM,CAKR;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/_internal/transport-http/contract-client.d.ts

@@ -1,3 +1,4 @@
+import type { ZodType } from 'zod/v4';
 import type { HttpTransport } from './http.js';
 import { type ServerSentEventHandlers } from './sse-stream.js';
 export interface ContractRouteDefinition {
@@ -6,16 +7,25 @@ export interface ContractRouteDefinition {
 }
 export interface ContractRouteLike {
     readonly id: string;
+    /** When true, this route is safe to retry on 5xx even for mutating HTTP verbs. */
+    readonly idempotent?: boolean;
 }
 export interface ContractInvokeOptions {
     readonly signal?: AbortSignal;
     readonly headers?: HeadersInit;
+    /**
+     * Optional Zod v4 schema to validate the parsed response body against.
+     * When provided, a failed parse throws a {@link ContractError} with
+     * field-level detail: operation, field path, expected type, and a
+     * recovery hint.
+     */
+    readonly responseSchema?: ZodType<any>;
 }
 export interface ContractStreamOptions extends ContractInvokeOptions {
     readonly handlers: ServerSentEventHandlers;
 }
 export declare function buildContractInput(primaryKey: string, primaryValue: string, input?: Record<string, unknown>): Record<string, unknown>;
 export declare function requireContractRoute<TRoute extends ContractRouteLike>(routes: readonly TRoute[], routeId: string, kind: string): TRoute;
-export declare function invokeContractRoute<T = unknown>(transport: HttpTransport, route: ContractRouteDefinition, input?: Record<string, unknown>, options?: ContractInvokeOptions): Promise<T>;
+export declare function invokeContractRoute<T = unknown>(transport: HttpTransport, route: ContractRouteDefinition & ContractRouteLike, input?: Record<string, unknown>, options?: ContractInvokeOptions): Promise<T>;
 export declare function openContractRouteStream(transport: HttpTransport, route: ContractRouteDefinition, input: Record<string, unknown> | undefined, options: ContractStreamOptions): Promise<() => void>;
 //# sourceMappingURL=contract-client.d.ts.map

package/dist/_internal/transport-http/contract-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract-client.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-http/contract-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;CAChC;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;CAC5C;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,SAAS,iBAAiB,EACnE,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC7C,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,uBAAuB,EAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,IAAI,CAAC,CAYrB"}
+{"version":3,"file":"contract-client.d.ts","sourceRoot":"","sources":["../../../src/_internal/transport-http/contract-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B;;;;;OAKG;IAEH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;CAC5C;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,SAAS,iBAAiB,EACnE,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED,wBAAsB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EACnD,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,uBAAuB,GAAG,iBAAiB,EAClD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,IAAI,CAAC,CAYrB"}

package/dist/_internal/transport-http/contract-client.js

@@ -1,3 +1,5 @@
+// Synced from packages/transport-http/src/contract-client.ts
+import { ContractError, GoodVibesSdkError } from '../errors/index.js';
 import { openServerSentEventStream } from './sse-stream.js';
 export function buildContractInput(primaryKey, primaryValue, input) {
     return {
@@ -8,18 +10,32 @@ export function buildContractInput(primaryKey, primaryValue, input) {
 export function requireContractRoute(routes, routeId, kind) {
     const route = routes.find((candidate) => candidate.id === routeId);
     if (!route) {
-        throw new Error(`Unknown ${kind} "${routeId}"`);
+        throw new GoodVibesSdkError(`Unknown ${kind} "${routeId}". Verify the method/route id is correct and that your contract manifest is up to date.`, { category: 'contract', source: 'contract', recoverable: false });
     }
     return route;
 }
-export function invokeContractRoute(transport, route, input, options = {}) {
+export async function invokeContractRoute(transport, route, input, options = {}) {
     const resolved = transport.resolveContractRequest(route.method, route.path, input);
-    return transport.requestJson(resolved.url, {
+    const body = await transport.requestJson(resolved.url, {
         method: resolved.method,
         body: resolved.body,
         headers: options.headers,
         signal: options.signal,
+        methodId: route.id,
+        idempotent: route.idempotent === true,
     });
+    if (options.responseSchema) {
+        const result = options.responseSchema.safeParse(body);
+        if (!result.success) {
+            const issue = result.error.issues[0];
+            const fieldPath = issue ? issue.path.join('.') || '(root)' : '(unknown)';
+            const expected = issue ? issue.expected ?? issue.code : 'unknown';
+            const received = issue ? issue.received ?? 'unknown' : 'unknown';
+            throw new ContractError(`Response validation failed for "${route.method} ${route.path}": field "${fieldPath}" expected ${expected} but received ${received}. Ensure the server is running a compatible version of the GoodVibes daemon.`, { source: 'contract' });
+        }
+        return result.data;
+    }
+    return body;
 }
 export async function openContractRouteStream(transport, route, input, options) {
     const resolved = transport.resolveContractRequest(route.method, route.path, input);