@astrale-os/kernel-client 0.2.0

package/dist/session/index.d.ts

@@ -0,0 +1,6 @@
+export { ClientSession } from './client-session';
+export type { IdentityInput, ClientSessionCallOptions, ClientSessionConfig } from './config';
+export type { BoundClientSessionView, SchemaTypedClientSession } from './types';
+export type { AfterCallCtx, AfterSignalCtx, BeforeCallCtx, DelegationMintCtx, DelegationRefusedCtx, RedirectFollowCtx, RedirectRefusedCtx, ClientSessionErrorCtx, ClientSessionHooks, ClientSessionHop, } from './hooks';
+export { IdentityPickerError, PersistenceLoadFailedError, RegistryWriteFailedError, SchemaOwnershipConflictError, UnresolvedIdentityError, } from './errors/session-errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAC5F,YAAY,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAC/E,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,yBAAyB,CAAA"}

package/dist/session/index.js

@@ -0,0 +1,3 @@
+export { ClientSession } from './client-session';
+export { IdentityPickerError, PersistenceLoadFailedError, RegistryWriteFailedError, SchemaOwnershipConflictError, UnresolvedIdentityError, } from './errors/session-errors';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAehD,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,yBAAyB,CAAA"}

package/dist/session/types.d.ts

@@ -0,0 +1,38 @@
+import type { CredentialInput } from '@astrale-os/kernel-core';
+import type { Schema } from '@astrale-os/kernel-dsl';
+import type { BinaryFns, CallFns, FnMap, SignalFns, StreamFns } from '../client/fn-map';
+import type { ClassNames, ClassProxy, NodeProxy } from '../schema/proxy-types';
+import type { SchemaRegistry } from '../schema/registry';
+import type { FunctionSchema } from '../schema/types';
+import type { BinaryResponse } from '../transport/binary';
+import type { ClientSessionCallOptions } from './config';
+/**
+ * Credential-bound view over a `ClientSession`. Mirrors `BoundClientView` but over
+ * the orchestration surface — dispatch primitives return the unwrapped
+ * post-orchestration shape, not the discriminated `Send*Result` union.
+ */
+export type BoundClientSessionView<M extends FnMap> = {
+    readonly default: string;
+    readonly registry: SchemaRegistry;
+    call<K extends CallFns<M>>(method: K, params: M[K]['params'], opts?: ClientSessionCallOptions): Promise<M[K]['result']>;
+    stream<K extends StreamFns<M>>(method: K, params: M[K]['params'], opts?: ClientSessionCallOptions): Promise<AsyncIterable<M[K]['result']>>;
+    binary<K extends BinaryFns<M>>(method: K, params: M[K]['params'], opts?: ClientSessionCallOptions): Promise<BinaryResponse>;
+    signal<K extends SignalFns<M>>(method: K, params: M[K]['params'], opts?: ClientSessionCallOptions): void;
+    describe(method: string): FunctionSchema | undefined;
+    withSchema<S extends Schema>(schema: S): SchemaTypedClientSession<S>;
+    as(credential: CredentialInput | (() => CredentialInput)): BoundClientSessionView<M>;
+};
+/**
+ * Schema-typed proxy dispatched through ClientSession: followed redirects are
+ * transparent; refused redirects throw `RedirectRefusedError`.
+ *
+ * `node` / `static` cover `call` / `stream` / `binary`. Signals remain on
+ * `session.signal<K>` — the awaitable-only proxy doesn't mix sync-void and
+ * `Promise<R>` shapes.
+ */
+export interface SchemaTypedClientSession<S extends Schema> {
+    node<K extends ClassNames<S>>(className: K, nodeId: string): NodeProxy<S, K>;
+    static<K extends ClassNames<S>>(className: K): ClassProxy<S, K>;
+    readonly schema: S;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAExD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,KAAK,IAAI;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,IAAI,CAAC,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EACvB,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,IAAI,CAAC,EAAE,wBAAwB,GAC9B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC1B,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,IAAI,CAAC,EAAE,wBAAwB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IACzC,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,IAAI,CAAC,EAAE,wBAAwB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAAA;IAC1B,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACtB,IAAI,CAAC,EAAE,wBAAwB,GAC9B,IAAI,CAAA;IACP,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;IACpD,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAA;IACpE,EAAE,CAAC,UAAU,EAAE,eAAe,GAAG,CAAC,MAAM,eAAe,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAA;CACrF,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,MAAM;IACxD,IAAI,CAAC,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC5E,MAAM,CAAC,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/D,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CACnB"}

package/dist/session/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":""}

package/dist/transport/binary.d.ts

@@ -0,0 +1,15 @@
+/**
+ * BinaryResponse — client-side result for methods with `output: 'binary'`.
+ *
+ * Distinct from the server-side `BinaryResult` (kernel-api): the client adds
+ * a `status` field carrying the HTTP response status, and the body may be a
+ * `Uint8Array` (single-shot) or a `ReadableStream<Uint8Array>` (streaming).
+ *
+ * Returned by `client.binary()` and the route transport's binary path.
+ */
+export type BinaryResponse = {
+    readonly contentType: string;
+    readonly status: number;
+    readonly body: Uint8Array | ReadableStream<Uint8Array>;
+};
+//# sourceMappingURL=binary.d.ts.map

package/dist/transport/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/transport/binary.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAA;CACvD,CAAA"}

package/dist/transport/binary.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=binary.js.map

package/dist/transport/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../src/transport/binary.ts"],"names":[],"mappings":""}

package/dist/transport/contract.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Transport contract — the narrow interface every transport class
+ * implements. Each method returns a discriminated `Send*Result`
+ * natively. Redirects are first-class results, not sentinels or throws.
+ * Errors throw typed `WebOSError` subclasses.
+ *
+ * One instance = one target URL. The `KernelClient` owns composition
+ * across transports; the transports own wire mechanics end-to-end.
+ */
+import type { CredentialInput } from '@astrale-os/kernel-core';
+import type { SendBinaryResult, SendResult, SendStreamResult } from '../client/fn-map';
+/** A single call targeted at this transport. */
+export type TransportRequest = {
+    method: string;
+    params: unknown;
+    credential: CredentialInput;
+    signal?: AbortSignal;
+    /** Per-call timeout override (ms). */
+    timeout?: number;
+    /** Per-call correlation id — threaded into errors as `details.correlationId`. */
+    correlationId?: string;
+    /**
+     * Per-call URL override. When set, the transport dispatches to this
+     * URL instead of its default. The client drives this for redirect
+     * follow-ups and multi-kernel dispatch.
+     */
+    url?: string;
+    /** Target-of-call for instance methods. Forwarded as `KernelRequest.self`. */
+    self?: string;
+};
+/** A single batch entry. Only the `http-envelope` transport supports batches. */
+export type BatchEntry<T = unknown> = SendResult<T> | Error;
+/**
+ * The common transport surface. Each capability that the transport does
+ * NOT express (e.g. `batch` on routed) throws `UnsupportedTransportError`
+ * synchronously.
+ */
+export type Transport = {
+    /**
+     * Target URL this transport dispatches against. `undefined` for
+     * routed transports — each call brings its own `remoteUrl` via the
+     * schema's route binding, so there's no single base URL to report.
+     */
+    readonly url: string | undefined;
+    /** Transport identity, reported on every result's `meta.transport`. */
+    readonly name: 'http-envelope' | 'ws-envelope' | 'http-routed';
+    call(request: TransportRequest): Promise<SendResult<unknown>>;
+    stream(request: TransportRequest): Promise<SendStreamResult<unknown>>;
+    binary(request: TransportRequest): Promise<SendBinaryResult>;
+    signal(request: TransportRequest): void;
+    batch(requests: TransportRequest[]): Promise<BatchEntry[]>;
+    /**
+     * Release any held resources (e.g. an open WebSocket). Idempotent.
+     * Safe to call on a transport that was never used.
+     */
+    disconnect(): void;
+};
+//# sourceMappingURL=contract.d.ts.map

package/dist/transport/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/transport/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEtF,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,eAAe,CAAA;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,GAAG,aAAa,CAAA;IAE9D,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;IAC7D,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;IACrE,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC5D,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACvC,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAE1D;;;OAGG;IACH,UAAU,IAAI,IAAI,CAAA;CACnB,CAAA"}

package/dist/transport/contract.js

@@ -0,0 +1,11 @@
+/**
+ * Transport contract — the narrow interface every transport class
+ * implements. Each method returns a discriminated `Send*Result`
+ * natively. Redirects are first-class results, not sentinels or throws.
+ * Errors throw typed `WebOSError` subclasses.
+ *
+ * One instance = one target URL. The `KernelClient` owns composition
+ * across transports; the transports own wire mechanics end-to-end.
+ */
+export {};
+//# sourceMappingURL=contract.js.map

package/dist/transport/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/transport/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/transport/fetch.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared `fetch` wrapper for kernel HTTP transports.
+ *
+ * Wraps transport-layer failures into `ConnectionError` so clients see a
+ * consistent, identifiable error class instead of raw `TypeError`s. Abort
+ * errors pass through unchanged so per-request cancellation still surfaces
+ * as `AbortError`.
+ *
+ * Accepts an optional custom `fetch` implementation for testing or
+ * environment shims (default: `globalThis.fetch`).
+ */
+/**
+ * Rewrite `*.localhost` URLs to a reachable loopback target — preserving
+ * port + path + query.
+ *
+ * macOS (and Node's libuv-backed `dns.lookup`) only resolve the literal
+ * `localhost`; subdomains like `mails.localhost` NXDOMAIN unless added
+ * to `/etc/hosts`. Dev presets stamp `mails.localhost` (or
+ * `dist.localhost`, …) into `Function.binding.remoteUrl` so domains stay
+ * isolated by hostname rather than by port — every redirect-following
+ * `astrale call` to a dev worker would NXDOMAIN without this rewrite.
+ *
+ * Real deployments don't use `.localhost`, so the rewrite is a no-op in
+ * prod traffic. (Friction: META_FEEDBACKS M-13 in `domains/mails/`.)
+ */
+export declare function rewriteLocalhostForLoopback(url: string, host?: string): string;
+export declare function safeFetch(url: string, init: RequestInit, fetchImpl?: typeof fetch): Promise<Response>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/transport/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/transport/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAuBH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAuB,GAAG,MAAM,CAe9F;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,SAAS,GAAE,OAAO,KAAyC,GAC1D,OAAO,CAAC,QAAQ,CAAC,CASnB"}

package/dist/transport/fetch.js

@@ -0,0 +1,74 @@
+/**
+ * Shared `fetch` wrapper for kernel HTTP transports.
+ *
+ * Wraps transport-layer failures into `ConnectionError` so clients see a
+ * consistent, identifiable error class instead of raw `TypeError`s. Abort
+ * errors pass through unchanged so per-request cancellation still surfaces
+ * as `AbortError`.
+ *
+ * Accepts an optional custom `fetch` implementation for testing or
+ * environment shims (default: `globalThis.fetch`).
+ */
+import { ConnectionError } from '../errors/errors';
+/**
+ * Loopback target host. From a host-side process (CLI, dev), `127.0.0.1`
+ * reaches any locally-bound listener. From inside the manager container,
+ * `127.0.0.1` is the container's own loopback — local listeners on the
+ * host are reachable via `host.docker.internal` (Docker Desktop /
+ * Linux 20.10+). `ASTRALE_IN_CONTAINER=1` is set in the manager image's
+ * compose env (`cli/src/lib/docker.ts`).
+ *
+ * Mirrors `kernel/adapters/authentication/in-memory/discovery.ts` which
+ * needs the same policy on the JWKS-fetch path.
+ */
+function loopbackHost() {
+    // `process` is the Node global; narrow via globalThis so workerd /
+    // browser bundles still typecheck (they don't ship `process`).
+    const proc = globalThis.process;
+    const inContainer = proc?.env?.ASTRALE_IN_CONTAINER === '1';
+    return inContainer ? 'host.docker.internal' : '127.0.0.1';
+}
+/**
+ * Rewrite `*.localhost` URLs to a reachable loopback target — preserving
+ * port + path + query.
+ *
+ * macOS (and Node's libuv-backed `dns.lookup`) only resolve the literal
+ * `localhost`; subdomains like `mails.localhost` NXDOMAIN unless added
+ * to `/etc/hosts`. Dev presets stamp `mails.localhost` (or
+ * `dist.localhost`, …) into `Function.binding.remoteUrl` so domains stay
+ * isolated by hostname rather than by port — every redirect-following
+ * `astrale call` to a dev worker would NXDOMAIN without this rewrite.
+ *
+ * Real deployments don't use `.localhost`, so the rewrite is a no-op in
+ * prod traffic. (Friction: META_FEEDBACKS M-13 in `domains/mails/`.)
+ */
+export function rewriteLocalhostForLoopback(url, host = loopbackHost()) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return url;
+    }
+    // Only `*.localhost` subdomains need help — the literal `localhost`
+    // resolves natively (libc, macOS) and rewriting it breaks tests that
+    // mock `http://localhost` and clients that intentionally point at it.
+    if (parsed.hostname.endsWith('.localhost')) {
+        parsed.hostname = host;
+        return parsed.toString();
+    }
+    return url;
+}
+export async function safeFetch(url, init, fetchImpl = globalThis.fetch.bind(globalThis)) {
+    const transportUrl = rewriteLocalhostForLoopback(url);
+    try {
+        return await fetchImpl(transportUrl, init);
+    }
+    catch (error) {
+        const cause = error instanceof Error ? error : new Error(String(error));
+        if (cause.name === 'AbortError')
+            throw cause;
+        throw new ConnectionError(`Failed to connect to ${url}: ${cause.message}`, { cause });
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/transport/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/transport/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD;;;;;;;;;;GAUG;AACH,SAAS,YAAY;IACnB,mEAAmE;IACnE,+DAA+D;IAC/D,MAAM,IAAI,GAAI,UAAyE,CAAC,OAAO,CAAA;IAC/F,MAAM,WAAW,GAAG,IAAI,EAAE,GAAG,EAAE,oBAAoB,KAAK,GAAG,CAAA;IAC3D,OAAO,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,WAAW,CAAA;AAC3D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAW,EAAE,IAAI,GAAW,YAAY,EAAE;IACpF,IAAI,MAAW,CAAA;IACf,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,oEAAoE;IACpE,qEAAqE;IACrE,sEAAsE;IACtE,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAA;QACtB,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC1B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,IAAiB,EACjB,SAAS,GAAiB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;IAE3D,MAAM,YAAY,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAA;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACvE,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,MAAM,KAAK,CAAA;QAC5C,MAAM,IAAI,eAAe,CAAC,wBAAwB,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACvF,CAAC;AACH,CAAC"}

package/dist/transport/http-envelope.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Kernel-envelope HTTP transport.
+ *
+ * Speaks the kernel envelope (POST /) with JSON or MsgPack codec. Returns
+ * discriminated `Send*Result`s natively — redirects are `kind: 'redirect'`
+ * results, errors throw typed `WebOSError` subclasses, values carry
+ * `meta: WireMeta` populated at receive time.
+ *
+ * Note: SSE frames are always JSON-text on the wire, even when the
+ * transport is configured for `msgpack` — msgpack bytes don't fit SSE's
+ * text framing, so the server emits JSON on the SSE channel regardless.
+ */
+import type { SendBinaryResult, SendResult, SendStreamResult } from '../client/fn-map';
+import type { BatchEntry, Transport, TransportRequest } from './contract';
+import { type KernelRetryOptions } from '../pacer/retry';
+export type HttpEnvelopeTransportConfig = {
+    url: string;
+    codec?: 'json' | 'msgpack';
+    requestTimeout?: number;
+    headers?: Record<string, string>;
+    retry?: KernelRetryOptions;
+    /** Custom fetch (testing, environment shims). Default: global fetch. */
+    fetch?: typeof fetch;
+};
+export declare class HttpEnvelopeTransport implements Transport {
+    readonly name: 'http-envelope';
+    readonly url: string;
+    private readonly codec;
+    private readonly codecName;
+    private readonly kernelContentType;
+    private readonly defaultTimeout;
+    private readonly extraHeaders;
+    private readonly retryOpts;
+    private readonly fetchImpl;
+    constructor(config: HttpEnvelopeTransportConfig);
+    disconnect(): void;
+    call(request: TransportRequest): Promise<SendResult<unknown>>;
+    signal(request: TransportRequest): void;
+    batch(requests: TransportRequest[]): Promise<BatchEntry[]>;
+    binary(request: TransportRequest): Promise<SendBinaryResult>;
+    stream(request: TransportRequest): Promise<SendStreamResult<unknown>>;
+    private encodeEnvelope;
+    private buildHeaders;
+    private targetFor;
+    private metaFromResponse;
+    private decorate;
+    private retryingFetch;
+}
+//# sourceMappingURL=http-envelope.d.ts.map

package/dist/transport/http-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-envelope.d.ts","sourceRoot":"","sources":["../../src/transport/http-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEtF,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAWzE,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAOrE,MAAM,MAAM,2BAA2B,GAAG;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB,CAAA;AAED,qBAAa,qBAAsB,YAAW,SAAS;IACrD,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAS;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IAExC,YAAY,MAAM,EAAE,2BAA2B,EAU9C;IAED,UAAU,IAAI,IAAI,CAEjB;IAIK,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAyElE;IAID,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAyBtC;IAIK,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA0D/D;IAIK,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoFjE;IAIK,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAqE1E;IAID,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,QAAQ;YAmBF,aAAa;CAyB5B"}