@astrale-os/kernel-client 0.2.0

package/dist/delegation/policy.js

@@ -0,0 +1,109 @@
+import { raceAgainstSignal } from '../util/race-signal';
+// ─── Factories ───────────────────────────────────────────────────────────────
+/**
+ * Default policy: mint for any target whose origin differs from the
+ * default kernel's origin, allow implicitly.
+ *
+ * `default` is the `ClientSessionConfig.default` URL; same-origin targets skip
+ * delegation (the base credential is valid). Used when `ClientSessionConfig`
+ * omits `delegationPolicy`.
+ */
+export function allowAllDelegations(opts) {
+    return { audienceFor: originAudienceFor(opts.default) };
+}
+/**
+ * Allowlist: only mint for audiences `allow` returns true for. Matches
+ * `RedirectPolicy`'s `allowlistPolicy` shape for symmetry.
+ *
+ * `delegation`, when supplied, is the expression applied to every mint
+ * this policy produces; per-call overrides via `ClientSessionCallOptions.delegation`
+ * still win. Same for `attestation`.
+ */
+export function allowlistDelegations(opts) {
+    return {
+        audienceFor: originAudienceFor(opts.default),
+        ...(opts.delegation !== undefined ? { delegationFor: () => opts.delegation } : {}),
+        ...(opts.attestation !== undefined ? { attestationFor: () => opts.attestation } : {}),
+        decide: (audience) => {
+            if (opts.allow(audience))
+                return { allow: true };
+            return { allow: false, reason: `audience not in allowlist: ${audience}` };
+        },
+    };
+}
+/**
+ * UI prompt: ask the consumer for each new audience. Races `onPrompt`
+ * against the caller's `signal` so aborting the top-level call cancels
+ * the prompt.
+ *
+ * `allow` is a fast-path predicate (pre-approved audiences). Returning
+ * `false` from `allow` falls through to `onPrompt`.
+ *
+ * `onPrompt` receives the full mint shape (audience + delegation +
+ * attestation + ctx) so the UI can render what's actually being minted,
+ * not just the audience. This matters when the policy narrows by method:
+ * the user should see "write to partner kernel as self with READ | WRITE
+ * on nodes [X, Y]," not just "trust partner kernel."
+ */
+export function promptDelegations(opts) {
+    return {
+        audienceFor: originAudienceFor(opts.default),
+        ...(opts.delegation !== undefined ? { delegationFor: () => opts.delegation } : {}),
+        ...(opts.attestation !== undefined ? { attestationFor: () => opts.attestation } : {}),
+        decide: async (audience, delegation, attestation, ctx, signal) => {
+            if (opts.allow?.(audience))
+                return { allow: true };
+            // Short-circuit a pre-aborted signal before opening the prompt —
+            // otherwise the consumer's UI flashes for a call the caller already cancelled.
+            if (signal?.aborted)
+                throw signal.reason instanceof Error ? signal.reason : new Error('aborted');
+            const accepted = await raceAgainstSignal(opts.onPrompt(audience, delegation, attestation, ctx), signal);
+            if (accepted)
+                return { allow: true };
+            return { allow: false, reason: `consumer declined delegation for "${audience}"` };
+        },
+    };
+}
+// ─── Sugar — no new capability, just the common self+scope shape ─────────────
+/**
+ * Build `{ kind: 'scope', scopes, expr: { kind: 'identity', self: true } }`
+ * — a self-delegation narrowed to the given scope set. This is the shape
+ * that was the *entire* delegation surface in an earlier draft of the
+ * spec, now expressible as one case of the full `UnresolvedIdentityExpr`
+ * algebra.
+ *
+ * Use for the common "vary perms by method" pattern. Reach for the raw
+ * `UnresolvedIdentityExpr` constructors when composing identities
+ * (union/intersect/exclude) or chaining credentials.
+ */
+export function scopedSelf(scopes) {
+    return {
+        kind: 'scope',
+        scopes: [...scopes],
+        expr: { kind: 'identity', self: true },
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Build an `audienceFor` function that returns the target's origin when
+ * it differs from the default kernel's origin, `undefined` otherwise.
+ * Shared across every factory — origin-compare is the default heuristic.
+ */
+function originAudienceFor(defaultUrl) {
+    const defaultOrigin = safeOrigin(defaultUrl);
+    return (target) => {
+        const origin = safeOrigin(target);
+        if (origin === undefined || origin === defaultOrigin)
+            return undefined;
+        return origin;
+    };
+}
+function safeOrigin(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/delegation/policy.js.map

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

package/dist/errors/errors.d.ts

@@ -0,0 +1,103 @@
+import type { CallRedirection, FieldError, InvariantError } from '@astrale-os/kernel-api';
+import type { TransportName, WireMeta } from '../wire/meta';
+/**
+ * Context attached to every `WebOSError` thrown by the client. An
+ * orchestrator reads this to retry on a different client, inspect a
+ * redirection, read a step-up challenge, or correlate logs. The typed
+ * fields `redirection` and `challenge` carry the same payloads the
+ * corresponding thrown-error subclasses expose as structured properties;
+ * the client never dumps raw server `data` here.
+ *
+ * Populated once at the transport → error boundary. `url` is the URL
+ * *actually dispatched to* — when the orchestrator (future layer D)
+ * follows a redirect, each hop's error carries that hop's `url`.
+ */
+export type ClientErrorDetails = {
+    method: string;
+    params: unknown;
+    url: string;
+    transport: TransportName;
+    correlationId?: string;
+    meta?: WireMeta;
+    redirection?: CallRedirection;
+};
+export declare class WebOSError extends Error {
+    details?: ClientErrorDetails;
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ConnectionError extends WebOSError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class DisconnectedError extends WebOSError {
+    constructor(message?: string);
+}
+export declare class TimeoutError extends WebOSError {
+    readonly requestId: string;
+    readonly timeoutMs: number;
+    constructor(requestId: string, timeoutMs: number);
+}
+/**
+ * Caller forced a transport that the resolved method cannot use (e.g.
+ * an envelope transport on a routed-only method, or `routed` on a
+ * method without `binding.route`). Thrown synchronously before wire
+ * dispatch.
+ */
+export declare class InvalidTransportError extends WebOSError {
+    constructor(message: string);
+}
+/**
+ * A transport was asked to serve an operation it does not express —
+ * `batch` on a routed transport, duplex binary stream on envelope, etc.
+ */
+export declare class UnsupportedTransportError extends WebOSError {
+    constructor(message: string);
+}
+export type AuthReason = 'missing' | 'invalid' | 'expired';
+export declare class AuthenticationError extends WebOSError {
+    readonly reason: AuthReason;
+    constructor(message: string, reason: AuthReason);
+}
+export declare class PermissionDeniedError extends WebOSError {
+    constructor(message?: string);
+}
+export declare class KernelError extends WebOSError {
+    readonly code: number;
+    readonly type: string;
+    readonly data?: unknown;
+    constructor(message: string, code: number, type?: string, data?: unknown);
+}
+/**
+ * Validation error. `errors` holds the server-reported `FieldError[]`,
+ * orthogonal to the inherited `WebOSError.details` (which carries
+ * invocation context — method/url/transport/correlationId). Two axes,
+ * two fields; neither overwrites the other.
+ */
+export declare class ValidationError extends KernelError {
+    readonly errors: FieldError[];
+    constructor(message: string, errors: FieldError[]);
+    getFieldError(field: string): FieldError | undefined;
+    hasFieldError(field: string): boolean;
+}
+export declare class InvariantViolationError extends KernelError {
+    readonly errors: InvariantError[];
+    constructor(message: string, errors: InvariantError[]);
+    getError(code: string): InvariantError | undefined;
+    hasError(code: string): boolean;
+}
+export declare class NotFoundError extends WebOSError {
+    constructor(message?: string);
+}
+/**
+ * Map a `{ code, message, data }` envelope error to a typed `WebOSError`.
+ * The caller is responsible for attaching `ClientErrorDetails` via
+ * `withDetails` after mapping.
+ */
+export declare function mapServerError(code: number, message: string, data?: unknown): WebOSError;
+/**
+ * Attach a full `ClientErrorDetails` record to an error. Typed to require
+ * completeness — partial calls fail at compile time — so every thrown
+ * error surfaces the invariant set from spec §9.5. Call exactly once per
+ * error at the transport → client boundary.
+ */
+export declare function withDetails<E extends WebOSError>(error: E, details: ClientErrorDetails): E;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors/errors.d.ts.map

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

package/dist/errors/errors.js

@@ -0,0 +1,170 @@
+import { KERNEL_ERROR_CODES } from '@astrale-os/kernel-api';
+// ─── Base ───────────────────────────────────────────────
+export class WebOSError extends Error {
+    details;
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'WebOSError';
+    }
+}
+// ─── Transport ──────────────────────────────────────────
+export class ConnectionError extends WebOSError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ConnectionError';
+    }
+}
+export class DisconnectedError extends WebOSError {
+    constructor(message = 'Disconnected while request was pending') {
+        super(message);
+        this.name = 'DisconnectedError';
+    }
+}
+export class TimeoutError extends WebOSError {
+    requestId;
+    timeoutMs;
+    constructor(requestId, timeoutMs) {
+        super(`Request ${requestId} timed out after ${timeoutMs}ms`);
+        this.requestId = requestId;
+        this.timeoutMs = timeoutMs;
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Caller forced a transport that the resolved method cannot use (e.g.
+ * an envelope transport on a routed-only method, or `routed` on a
+ * method without `binding.route`). Thrown synchronously before wire
+ * dispatch.
+ */
+export class InvalidTransportError extends WebOSError {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidTransportError';
+    }
+}
+/**
+ * A transport was asked to serve an operation it does not express —
+ * `batch` on a routed transport, duplex binary stream on envelope, etc.
+ */
+export class UnsupportedTransportError extends WebOSError {
+    constructor(message) {
+        super(message);
+        this.name = 'UnsupportedTransportError';
+    }
+}
+export class AuthenticationError extends WebOSError {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = 'AuthenticationError';
+    }
+}
+export class PermissionDeniedError extends WebOSError {
+    constructor(message = 'Permission denied') {
+        super(message);
+        this.name = 'PermissionDeniedError';
+    }
+}
+// ─── Kernel ─────────────────────────────────────────────
+export class KernelError extends WebOSError {
+    code;
+    type;
+    data;
+    constructor(message, code, type = 'KERNEL_ERROR', data) {
+        super(message);
+        this.code = code;
+        this.type = type;
+        this.data = data;
+        this.name = 'KernelError';
+    }
+}
+/**
+ * Validation error. `errors` holds the server-reported `FieldError[]`,
+ * orthogonal to the inherited `WebOSError.details` (which carries
+ * invocation context — method/url/transport/correlationId). Two axes,
+ * two fields; neither overwrites the other.
+ */
+export class ValidationError extends KernelError {
+    errors;
+    constructor(message, errors) {
+        super(message, KERNEL_ERROR_CODES.VALIDATION_ERROR, 'VALIDATION_ERROR', errors);
+        this.name = 'ValidationError';
+        this.errors = errors;
+    }
+    getFieldError(field) {
+        return this.errors.find((e) => e.path.includes(field));
+    }
+    hasFieldError(field) {
+        return this.errors.some((e) => e.path.includes(field));
+    }
+}
+export class InvariantViolationError extends KernelError {
+    errors;
+    constructor(message, errors) {
+        super(message, KERNEL_ERROR_CODES.INVARIANT_VIOLATION, 'INVARIANT_VIOLATION', errors);
+        this.name = 'InvariantViolationError';
+        this.errors = errors;
+    }
+    getError(code) {
+        return this.errors.find((e) => e.code === code);
+    }
+    hasError(code) {
+        return this.errors.some((e) => e.code === code);
+    }
+}
+export class NotFoundError extends WebOSError {
+    constructor(message = 'Not found') {
+        super(message);
+        this.name = 'NotFoundError';
+    }
+}
+// ─── Error mapping ──────────────────────────────────────
+const AUTH_REASON_BY_CODE = {
+    [KERNEL_ERROR_CODES.AUTH_MISSING]: 'missing',
+    [KERNEL_ERROR_CODES.AUTH_INVALID]: 'invalid',
+    [KERNEL_ERROR_CODES.AUTH_EXPIRED]: 'expired',
+};
+/**
+ * Map a `{ code, message, data }` envelope error to a typed `WebOSError`.
+ * The caller is responsible for attaching `ClientErrorDetails` via
+ * `withDetails` after mapping.
+ */
+export function mapServerError(code, message, data) {
+    const authReason = AUTH_REASON_BY_CODE[code];
+    if (authReason)
+        return new AuthenticationError(message, authReason);
+    if (code === KERNEL_ERROR_CODES.PERMISSION_DENIED)
+        return new PermissionDeniedError(message);
+    if (code === KERNEL_ERROR_CODES.NOT_FOUND || code === KERNEL_ERROR_CODES.METHOD_NOT_FOUND) {
+        return new NotFoundError(message);
+    }
+    if (code === KERNEL_ERROR_CODES.VALIDATION_ERROR) {
+        return new ValidationError(message, readErrors(data));
+    }
+    if (code === KERNEL_ERROR_CODES.INVARIANT_VIOLATION) {
+        return new InvariantViolationError(message, readErrors(data));
+    }
+    return new KernelError(message, code, 'KERNEL_ERROR', data);
+}
+function readErrors(data) {
+    if (Array.isArray(data))
+        return data;
+    if (data && typeof data === 'object') {
+        const errs = data.errors;
+        if (Array.isArray(errs))
+            return errs;
+    }
+    return [];
+}
+/**
+ * Attach a full `ClientErrorDetails` record to an error. Typed to require
+ * completeness — partial calls fail at compile time — so every thrown
+ * error surfaces the invariant set from spec §9.5. Call exactly once per
+ * error at the transport → client boundary.
+ */
+export function withDetails(error, details) {
+    error.details = details;
+    return error;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors/errors.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,4 @@
+export { AuthenticationError, ConnectionError, DisconnectedError, InvalidTransportError, InvariantViolationError, KernelError, NotFoundError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, mapServerError, withDetails, } from './errors';
+export type { AuthReason, ClientErrorDetails } from './errors';
+export { ClientSessionError } from './session-error';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/errors/index.js

@@ -0,0 +1,3 @@
+export { AuthenticationError, ConnectionError, DisconnectedError, InvalidTransportError, InvariantViolationError, KernelError, NotFoundError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, mapServerError, withDetails, } from './errors';
+export { ClientSessionError } from './session-error';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/errors/session-error.d.ts

@@ -0,0 +1,21 @@
+import { WebOSError } from './errors';
+/**
+ * Base class for every error ClientSession adds on top of the wire client's
+ * `WebOSError` hierarchy.
+ *
+ * Instances carry a string `kind` discriminator that narrows across
+ * every ClientSessionError subclass — consumers can `switch (e.kind)` as a
+ * one-namespace alternative to chains of `instanceof`. The choice of
+ * `kind` (not `type`) avoids ambiguity with `KernelError.type` which
+ * carries server-error-category strings.
+ *
+ * Lives in `@astrale-os/kernel-client/errors` (alongside `WebOSError`)
+ * rather than `session/errors` so that helper subpaths (`redirect`,
+ * `delegation`) can extend it without importing from `session/` —
+ * keeping the `session → helpers → errors` dep graph (§17.3) intact.
+ */
+export declare class ClientSessionError extends WebOSError {
+    readonly kind: string;
+    constructor(message: string, kind: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=session-error.d.ts.map

package/dist/errors/session-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-error.d.ts","sourceRoot":"","sources":["../../src/errors/session-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;aAG9B,IAAI,EAAE,MAAM;IAF9B,YACE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EAC5B,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF"}

package/dist/errors/session-error.js

@@ -0,0 +1,25 @@
+import { WebOSError } from './errors';
+/**
+ * Base class for every error ClientSession adds on top of the wire client's
+ * `WebOSError` hierarchy.
+ *
+ * Instances carry a string `kind` discriminator that narrows across
+ * every ClientSessionError subclass — consumers can `switch (e.kind)` as a
+ * one-namespace alternative to chains of `instanceof`. The choice of
+ * `kind` (not `type`) avoids ambiguity with `KernelError.type` which
+ * carries server-error-category strings.
+ *
+ * Lives in `@astrale-os/kernel-client/errors` (alongside `WebOSError`)
+ * rather than `session/errors` so that helper subpaths (`redirect`,
+ * `delegation`) can extend it without importing from `session/` —
+ * keeping the `session → helpers → errors` dep graph (§17.3) intact.
+ */
+export class ClientSessionError extends WebOSError {
+    kind;
+    constructor(message, kind, options) {
+        super(message, options);
+        this.kind = kind;
+        this.name = 'ClientSessionError';
+    }
+}
+//# sourceMappingURL=session-error.js.map

package/dist/errors/session-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-error.js","sourceRoot":"","sources":["../../src/errors/session-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAG9B,IAAI;IAFtB,YACE,OAAe,EACC,IAAY,EAC5B,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;oBAHP,IAAI;QAIpB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { KernelClient } from './client/client';
+export type { BoundClientView } from './client/bound';
+export type { CallOptions, ClientConfig, ClientLogger, Protocol, CallTransport, } from './client/config';
+export type { AfterReceiveCtx, AfterSignalCtx, BeforeSendCtx, ClientHooks, ErrorCtx, StreamFrameCtx, } from './client/hooks';
+export type { BinaryFns, CallFns, FnEntry, FnMap, SendBinaryResult, SendResult, SendStreamResult, SignalFns, StreamFns, } from './client/fn-map';
+export type { BatchResults, TypedBatchRequest } from './client/batch';
+export type { TransportName, WireMeta, WireProtocolMeta } from './wire/meta';
+export { RETRY_DEFAULTS, QUEUE_DEFAULTS, BATCH_DEFAULTS, RATE_LIMIT_DEFAULTS, kernelRetry, createQueue, createBatcher, createRateLimiter, } from './pacer';
+export type { KernelRetryOptions, KernelQueueOptions, KernelBatchOptions, KernelRateLimitOptions, } from './pacer';
+export { AuthenticationError, ConnectionError, DisconnectedError, InvalidTransportError, InvariantViolationError, KernelError, NotFoundError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, mapServerError, withDetails, } from './errors/errors';
+export type { AuthReason, ClientErrorDetails } from './errors/errors';
+export { SchemaRegistry } from './schema/registry';
+export { toFunctionSchemas } from './schema/from-entries';
+export type { FunctionSchema } from './schema/types';
+export type { ClassProxy, NodeProxy, ProxyCallOptions, SchemaTypedClient, } from './schema/proxy-types';
+export type { CredentialInput } from '@astrale-os/kernel-core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGrD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,gBAAgB,CAAA;AAGvB,YAAY,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,SAAS,GACV,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGrE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG5E,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,YAAY,EACV,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAG7B,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// ─── Client ─────────────────────────────────────────────
+export { KernelClient } from './client/client';
+// ─── Pacer (retry / queue / batcher / rate-limiter) ────
+export { RETRY_DEFAULTS, QUEUE_DEFAULTS, BATCH_DEFAULTS, RATE_LIMIT_DEFAULTS, kernelRetry, createQueue, createBatcher, createRateLimiter, } from './pacer';
+// ─── Errors ─────────────────────────────────────────────
+export { AuthenticationError, ConnectionError, DisconnectedError, InvalidTransportError, InvariantViolationError, KernelError, NotFoundError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, mapServerError, withDetails, } from './errors/errors';
+// ─── Schema ─────────────────────────────────────────────
+export { SchemaRegistry } from './schema/registry';
+export { toFunctionSchemas } from './schema/from-entries';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAqC9C,0DAA0D;AAC1D,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAQhB,2DAA2D;AAC3D,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,iBAAiB,CAAA;AAGxB,2DAA2D;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/pacer/batcher.d.ts

@@ -0,0 +1,11 @@
+import { AsyncBatcher, type AsyncBatcherOptions } from '@tanstack/pacer';
+export type KernelBatchOptions<TValue> = Omit<AsyncBatcherOptions<TValue>, 'maxSize' | 'wait'> & {
+    maxSize?: number;
+    wait?: number;
+};
+/**
+ * Create an AsyncBatcher pre-configured with kernel defaults.
+ * `maxSize` defaults to 50, `wait` to 16 ms (one frame).
+ */
+export declare function createBatcher<TValue>(fn: (items: TValue[]) => Promise<unknown>, opts?: KernelBatchOptions<TValue>): AsyncBatcher<TValue>;
+//# sourceMappingURL=batcher.d.ts.map

package/dist/pacer/batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batcher.d.ts","sourceRoot":"","sources":["../../src/pacer/batcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAIxE,MAAM,MAAM,kBAAkB,CAAC,MAAM,IAAI,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAClC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EACzC,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAChC,YAAY,CAAC,MAAM,CAAC,CAOtB"}

package/dist/pacer/batcher.js

@@ -0,0 +1,15 @@
+import { AsyncBatcher } from '@tanstack/pacer';
+import { BATCH_DEFAULTS } from './defaults';
+/**
+ * Create an AsyncBatcher pre-configured with kernel defaults.
+ * `maxSize` defaults to 50, `wait` to 16 ms (one frame).
+ */
+export function createBatcher(fn, opts) {
+    const { maxSize, wait, ...rest } = opts ?? {};
+    return new AsyncBatcher(fn, {
+        ...rest,
+        maxSize: maxSize ?? BATCH_DEFAULTS.maxSize,
+        wait: wait ?? BATCH_DEFAULTS.wait,
+    });
+}
+//# sourceMappingURL=batcher.js.map

package/dist/pacer/batcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batcher.js","sourceRoot":"","sources":["../../src/pacer/batcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA4B,MAAM,iBAAiB,CAAA;AAExE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAO3C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,EAAyC,EACzC,IAAiC;IAEjC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IAC7C,OAAO,IAAI,YAAY,CAAC,EAAE,EAAE;QAC1B,GAAG,IAAI;QACP,OAAO,EAAE,OAAO,IAAI,cAAc,CAAC,OAAO;QAC1C,IAAI,EAAE,IAAI,IAAI,cAAc,CAAC,IAAI;KAClC,CAAC,CAAA;AACJ,CAAC"}

package/dist/pacer/defaults.d.ts

@@ -0,0 +1,18 @@
+export declare const RETRY_DEFAULTS: {
+    maxAttempts: number;
+    baseWait: number;
+    maxWait: number;
+    jitter: number;
+};
+export declare const QUEUE_DEFAULTS: {
+    concurrency: number;
+};
+export declare const BATCH_DEFAULTS: {
+    maxSize: number;
+    wait: number;
+};
+export declare const RATE_LIMIT_DEFAULTS: {
+    limit: number;
+    window: number;
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/pacer/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/pacer/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;IACzB,WAAW;IACX,QAAQ;IACR,OAAO;IACP,MAAM;CACP,CAAA;AAED,eAAO,MAAM,cAAc;IACzB,WAAW;CACZ,CAAA;AAED,eAAO,MAAM,cAAc;IACzB,OAAO;IACP,IAAI;CACL,CAAA;AAED,eAAO,MAAM,mBAAmB;IAC9B,KAAK;IACL,MAAM;CACP,CAAA"}

package/dist/pacer/defaults.js

@@ -0,0 +1,18 @@
+export const RETRY_DEFAULTS = {
+    maxAttempts: 3,
+    baseWait: 1_000,
+    maxWait: 30_000,
+    jitter: 0.2,
+};
+export const QUEUE_DEFAULTS = {
+    concurrency: 10,
+};
+export const BATCH_DEFAULTS = {
+    maxSize: 50,
+    wait: 16,
+};
+export const RATE_LIMIT_DEFAULTS = {
+    limit: 300,
+    window: 60_000,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/pacer/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/pacer/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,GAAG;CACZ,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,WAAW,EAAE,EAAE;CAChB,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,EAAE;CACT,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,GAAG;IACV,MAAM,EAAE,MAAM;CACf,CAAA"}

package/dist/pacer/index.d.ts

@@ -0,0 +1,10 @@
+export { RETRY_DEFAULTS, QUEUE_DEFAULTS, BATCH_DEFAULTS, RATE_LIMIT_DEFAULTS } from './defaults';
+export { kernelRetry } from './retry';
+export type { KernelRetryOptions } from './retry';
+export { createQueue } from './queue';
+export type { KernelQueueOptions } from './queue';
+export { createBatcher } from './batcher';
+export type { KernelBatchOptions } from './batcher';
+export { createRateLimiter } from './rate-limiter';
+export type { KernelRateLimitOptions } from './rate-limiter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pacer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGhG,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAGnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/pacer/index.js

@@ -0,0 +1,11 @@
+// ─── Defaults ────────────────────────────────────────────
+export { RETRY_DEFAULTS, QUEUE_DEFAULTS, BATCH_DEFAULTS, RATE_LIMIT_DEFAULTS } from './defaults';
+// ─── Retry ───────────────────────────────────────────────
+export { kernelRetry } from './retry';
+// ─── Queue ───────────────────────────────────────────────
+export { createQueue } from './queue';
+// ─── Batcher ─────────────────────────────────────────────
+export { createBatcher } from './batcher';
+// ─── Rate Limiter ────────────────────────────────────────
+export { createRateLimiter } from './rate-limiter';
+//# sourceMappingURL=index.js.map

package/dist/pacer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pacer/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEhG,4DAA4D;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAGrC,4DAA4D;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAGrC,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAGzC,4DAA4D;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}