@astrale-os/kernel-client 0.2.0

package/dist/pacer/queue.d.ts

@@ -0,0 +1,11 @@
+import { AsyncQueuer, type AsyncQueuerOptions } from '@tanstack/pacer';
+export type KernelQueueOptions<TValue> = Omit<AsyncQueuerOptions<TValue>, 'concurrency'> & {
+    concurrency?: number;
+};
+/**
+ * Create an AsyncQueuer pre-configured with kernel defaults.
+ * The caller provides the processing function; concurrency defaults to
+ * `QUEUE_DEFAULTS.concurrency` (10).
+ */
+export declare function createQueue<TValue>(fn: (item: TValue) => Promise<unknown>, opts?: KernelQueueOptions<TValue>): AsyncQueuer<TValue>;
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/pacer/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAItE,MAAM,MAAM,kBAAkB,CAAC,MAAM,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,GAAG;IACzF,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAChC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACtC,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAChC,WAAW,CAAC,MAAM,CAAC,CAMrB"}

package/dist/pacer/queue.js

@@ -0,0 +1,15 @@
+import { AsyncQueuer } from '@tanstack/pacer';
+import { QUEUE_DEFAULTS } from './defaults';
+/**
+ * Create an AsyncQueuer pre-configured with kernel defaults.
+ * The caller provides the processing function; concurrency defaults to
+ * `QUEUE_DEFAULTS.concurrency` (10).
+ */
+export function createQueue(fn, opts) {
+    const { concurrency, ...rest } = opts ?? {};
+    return new AsyncQueuer(fn, {
+        ...rest,
+        concurrency: concurrency ?? QUEUE_DEFAULTS.concurrency,
+    });
+}
+//# sourceMappingURL=queue.js.map

package/dist/pacer/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/pacer/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA2B,MAAM,iBAAiB,CAAA;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAM3C;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,EAAsC,EACtC,IAAiC;IAEjC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IAC3C,OAAO,IAAI,WAAW,CAAC,EAAE,EAAE;QACzB,GAAG,IAAI;QACP,WAAW,EAAE,WAAW,IAAI,cAAc,CAAC,WAAW;KACvD,CAAC,CAAA;AACJ,CAAC"}

package/dist/pacer/rate-limiter.d.ts

@@ -0,0 +1,11 @@
+import { AsyncRateLimiter, type AnyAsyncFunction, type AsyncRateLimiterOptions } from '@tanstack/pacer';
+export type KernelRateLimitOptions<TFn extends AnyAsyncFunction> = Omit<AsyncRateLimiterOptions<TFn>, 'limit' | 'window'> & {
+    limit?: number;
+    window?: number;
+};
+/**
+ * Create an AsyncRateLimiter pre-configured with kernel defaults.
+ * `limit` defaults to 300 calls per `window` (60 s).
+ */
+export declare function createRateLimiter<TFn extends AnyAsyncFunction>(fn: TFn, opts?: KernelRateLimitOptions<TFn>): AsyncRateLimiter<TFn>;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/pacer/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/pacer/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAA;AAIxB,MAAM,MAAM,sBAAsB,CAAC,GAAG,SAAS,gBAAgB,IAAI,IAAI,CACrE,uBAAuB,CAAC,GAAG,CAAC,EAC5B,OAAO,GAAG,QAAQ,CACnB,GAAG;IACF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,SAAS,gBAAgB,EAC5D,EAAE,EAAE,GAAG,EACP,IAAI,CAAC,EAAE,sBAAsB,CAAC,GAAG,CAAC,GACjC,gBAAgB,CAAC,GAAG,CAAC,CAOvB"}

package/dist/pacer/rate-limiter.js

@@ -0,0 +1,15 @@
+import { AsyncRateLimiter, } from '@tanstack/pacer';
+import { RATE_LIMIT_DEFAULTS } from './defaults';
+/**
+ * Create an AsyncRateLimiter pre-configured with kernel defaults.
+ * `limit` defaults to 300 calls per `window` (60 s).
+ */
+export function createRateLimiter(fn, opts) {
+    const { limit, window, ...rest } = opts ?? {};
+    return new AsyncRateLimiter(fn, {
+        ...rest,
+        limit: limit ?? RATE_LIMIT_DEFAULTS.limit,
+        window: window ?? RATE_LIMIT_DEFAULTS.window,
+    });
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/pacer/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/pacer/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAGjB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAUhD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAO,EACP,IAAkC;IAElC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IAC7C,OAAO,IAAI,gBAAgB,CAAC,EAAE,EAAE;QAC9B,GAAG,IAAI;QACP,KAAK,EAAE,KAAK,IAAI,mBAAmB,CAAC,KAAK;QACzC,MAAM,EAAE,MAAM,IAAI,mBAAmB,CAAC,MAAM;KAC7C,CAAC,CAAA;AACJ,CAAC"}

package/dist/pacer/retry.d.ts

@@ -0,0 +1,14 @@
+export type KernelRetryOptions = {
+    maxAttempts?: number;
+    baseWait?: number;
+    maxWait?: number;
+    jitter?: number;
+    shouldRetry?: (error: Error, attempt: number) => boolean;
+};
+/**
+ * Retry an async function with kernel defaults (exponential backoff, jitter,
+ * capped delay). The optional `shouldRetry` predicate lets transports opt out
+ * of retrying non-transient errors (e.g. 4xx responses).
+ */
+export declare function kernelRetry<T>(fn: () => Promise<T>, opts?: KernelRetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/pacer/retry.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAA;CACzD,CAAA;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CA0ChG"}

package/dist/pacer/retry.js

@@ -0,0 +1,50 @@
+import { AsyncRetryer } from '@tanstack/pacer';
+import { RETRY_DEFAULTS } from './defaults';
+/**
+ * Retry an async function with kernel defaults (exponential backoff, jitter,
+ * capped delay). The optional `shouldRetry` predicate lets transports opt out
+ * of retrying non-transient errors (e.g. 4xx responses).
+ */
+export async function kernelRetry(fn, opts) {
+    const { shouldRetry, ...rest } = opts ?? {};
+    // `AsyncRetryer.execute()` has silent-undefined paths the pacer library
+    // calls "cancellation outcomes": it catches `AbortError` (by name) and
+    // resolves with `undefined` without firing any hook, and `retryer.abort()`
+    // triggered from `onRetry` does the same. Both violate the kernelRetry
+    // contract — the caller expects "resolve with the value OR throw the
+    // last error", never silent undefined.
+    //
+    // Capture every failure in the inner wrapper itself (belt-and-braces:
+    // onError fires for non-abort, our wrapper covers everything). Rethrow
+    // on undefined when we saw an error.
+    let lastSeenError;
+    const wrapped = async () => {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastSeenError = err instanceof Error ? err : new Error(String(err));
+            throw err;
+        }
+    };
+    const retryerOpts = {
+        maxAttempts: rest.maxAttempts ?? RETRY_DEFAULTS.maxAttempts,
+        baseWait: rest.baseWait ?? RETRY_DEFAULTS.baseWait,
+        maxWait: rest.maxWait ?? RETRY_DEFAULTS.maxWait,
+        jitter: rest.jitter ?? RETRY_DEFAULTS.jitter,
+        backoff: 'exponential',
+        throwOnError: 'last',
+        onRetry(attempt, error, retryer) {
+            if (shouldRetry && !shouldRetry(error, attempt)) {
+                retryer.abort();
+            }
+        },
+    };
+    // oxlint-disable-next-line @typescript-eslint/no-explicit-any
+    const retryer = new AsyncRetryer(wrapped, retryerOpts);
+    const result = await retryer.execute();
+    if (result === undefined && lastSeenError)
+        throw lastSeenError;
+    return result;
+}
+//# sourceMappingURL=retry.js.map

package/dist/pacer/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/pacer/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAU3C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,EAAoB,EAAE,IAAyB;IAClF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IAE3C,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,uEAAuE;IACvE,qEAAqE;IACrE,uCAAuC;IACvC,EAAE;IACF,sEAAsE;IACtE,uEAAuE;IACvE,qCAAqC;IACrC,IAAI,aAAgC,CAAA;IAEpC,MAAM,OAAO,GAAG,KAAK,IAAsB,EAAE;QAC3C,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,aAAa,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YACnE,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CAAA;IAED,MAAM,WAAW,GAAG;QAClB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;QAC3D,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ;QAClD,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;QAC/C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM;QAC5C,OAAO,EAAE,aAAsB;QAC/B,YAAY,EAAE,MAAe;QAC7B,OAAO,CAAC,OAAe,EAAE,KAAY,EAAE,OAA8B;YACnE,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;gBAChD,OAAO,CAAC,KAAK,EAAE,CAAA;YACjB,CAAC;QACH,CAAC;KACF,CAAA;IACD,8DAA8D;IAC9D,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,OAAO,EAAE,WAAkB,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;IACtC,IAAI,MAAM,KAAK,SAAS,IAAI,aAAa;QAAE,MAAM,aAAa,CAAA;IAC9D,OAAO,MAAW,CAAA;AACpB,CAAC"}

package/dist/persistence/index.d.ts

@@ -0,0 +1,3 @@
+export type { SchemaPersistence } from './persistence';
+export { MemorySchemaStore } from './persistence';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/persistence/index.js

@@ -0,0 +1,2 @@
+export { MemorySchemaStore } from './persistence';
+//# sourceMappingURL=index.js.map

package/dist/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/persistence/persistence.d.ts

@@ -0,0 +1,52 @@
+import type { FunctionSchema } from '../schema/types';
+/**
+ * Storage adapter for learned schemas. Pure I/O — the `SchemaRegistry`
+ * handles dedupe and contract-drift detection internally; persistence
+ * just moves opaque `FunctionSchema` records between memory and a
+ * durable medium.
+ *
+ * Spec §9.5.
+ */
+export interface SchemaPersistence {
+    /**
+     * Load every persisted schema. Called once at ClientSession construction
+     * (when `ClientSessionConfig.schemaStore` is configured). Throws wrap as
+     * `PersistenceLoadFailedError` at the ClientSession boundary.
+     */
+    load(): Promise<FunctionSchema[]>;
+    /**
+     * Persist one schema. Called from ClientSession's registry-save path after a
+     * redirect learns a new entry. The implementation decides durability
+     * (write-through, debounced, etc.); ClientSession awaits it only to surface
+     * errors through the hook surface.
+     */
+    save(schema: FunctionSchema): Promise<void>;
+    /**
+     * Drop every persisted schema. Rarely the right answer — provided
+     * for test fixtures and explicit "reset" flows. ClientSession's
+     * `disconnect()` does NOT call this (spec §13.6).
+     */
+    clear(): Promise<void>;
+}
+/**
+ * In-memory reference implementation. Useful for tests and for
+ * ephemeral orchestrators where "persistence" across ClientSession lifetimes
+ * inside one process is the goal.
+ *
+ * Not durable across process restarts. Consumers wanting filesystem /
+ * IndexedDB / remote-kv persistence implement `SchemaPersistence`
+ * against their own backing store.
+ */
+export declare class MemorySchemaStore implements SchemaPersistence {
+    private readonly entries;
+    /**
+     * Optional preloaded entries. Useful for tests and for round-tripping
+     * a snapshot across ClientSession lifetimes in-process. `load()` returns these
+     * verbatim until the first `save()` mutates the map.
+     */
+    constructor(initial?: readonly FunctionSchema[]);
+    load(): Promise<FunctionSchema[]>;
+    save(schema: FunctionSchema): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/persistence/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IAEjC;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3C;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAE5D;;;;OAIG;IACH,YAAY,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,EAE9C;IAEK,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAEtC;IAEK,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}

package/dist/persistence/persistence.js

@@ -0,0 +1,32 @@
+/**
+ * In-memory reference implementation. Useful for tests and for
+ * ephemeral orchestrators where "persistence" across ClientSession lifetimes
+ * inside one process is the goal.
+ *
+ * Not durable across process restarts. Consumers wanting filesystem /
+ * IndexedDB / remote-kv persistence implement `SchemaPersistence`
+ * against their own backing store.
+ */
+export class MemorySchemaStore {
+    entries = new Map();
+    /**
+     * Optional preloaded entries. Useful for tests and for round-tripping
+     * a snapshot across ClientSession lifetimes in-process. `load()` returns these
+     * verbatim until the first `save()` mutates the map.
+     */
+    constructor(initial) {
+        if (initial)
+            for (const schema of initial)
+                this.entries.set(schema.ref, schema);
+    }
+    async load() {
+        return Array.from(this.entries.values());
+    }
+    async save(schema) {
+        this.entries.set(schema.ref, schema);
+    }
+    async clear() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=persistence.js.map

package/dist/persistence/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../src/persistence/persistence.ts"],"names":[],"mappings":"AAkCA;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAA;IAE5D;;;;OAIG;IACH,YAAY,OAAmC;QAC7C,IAAI,OAAO;YAAE,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACjF,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAsB;QAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;CACF"}

package/dist/pool/errors.d.ts

@@ -0,0 +1,13 @@
+import { WebOSError } from '../errors/errors';
+/**
+ * Any `pool.clientFor(url)` call after `pool.disconnect()` (or any
+ * `session.call` after `session.disconnect()`).
+ *
+ * The pool is single-use post-disconnect — resurrection is a consumer
+ * responsibility (construct a new ClientSession / pool). Spec §10.3.6.
+ */
+export declare class PoolClosedError extends WebOSError {
+    readonly kind: 'POOL_CLOSED';
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/pool/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAS;IAEtC,YAAY,OAAO,SAA+B,EAGjD;CACF"}

package/dist/pool/errors.js

@@ -0,0 +1,16 @@
+import { WebOSError } from '../errors/errors';
+/**
+ * Any `pool.clientFor(url)` call after `pool.disconnect()` (or any
+ * `session.call` after `session.disconnect()`).
+ *
+ * The pool is single-use post-disconnect — resurrection is a consumer
+ * responsibility (construct a new ClientSession / pool). Spec §10.3.6.
+ */
+export class PoolClosedError extends WebOSError {
+    kind = 'POOL_CLOSED';
+    constructor(message = 'ClientPool is disconnected') {
+        super(message);
+        this.name = 'PoolClosedError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/pool/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/pool/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IACpC,IAAI,GAAG,aAAsB,CAAA;IAEtC,YAAY,OAAO,GAAG,4BAA4B;QAChD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF"}

package/dist/pool/index.d.ts

@@ -0,0 +1,4 @@
+export type { ClientFactory, ClientPoolConfig } from './pool';
+export { ClientPool } from './pool';
+export { PoolClosedError } from './errors';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pool/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA"}

package/dist/pool/index.js

@@ -0,0 +1,3 @@
+export { ClientPool } from './pool';
+export { PoolClosedError } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pool/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA"}

package/dist/pool/pool.d.ts

@@ -0,0 +1,63 @@
+import type { KernelClient } from '../client/client';
+import type { FnMap } from '../client/fn-map';
+/**
+ * Factory for constructing a `KernelClient` bound to a given URL.
+ *
+ * The ClientSession's default factory wires `fetch`, `codec`, `requestTimeout`,
+ * `defaultTransport`, `defaultProtocol`, `schema`, `hooks`, `retry` from a single
+ * base config. Consumers who need custom wire-layer config replace the
+ * factory — it is the one wiring seam between ClientSession's config and the
+ * client's.
+ */
+export type ClientFactory<M extends FnMap = FnMap> = (url: string) => KernelClient<M>;
+/**
+ * `ClientPool` configuration. Spec §9.1.
+ */
+export type ClientPoolConfig<M extends FnMap = FnMap> = {
+    /** How to build a `KernelClient` for a URL the pool hasn't seen. */
+    clientFactory: ClientFactory<M>;
+    /**
+     * Maximum cached clients. Least-recently-used is evicted when
+     * exceeded. Default: `32`.
+     */
+    maxSize?: number;
+};
+/**
+ * URL → `KernelClient` map with bounded LRU eviction. Spec §9.1.
+ *
+ * Invariants:
+ * - Idempotent `disconnect()` — subsequent calls are no-ops.
+ * - Post-disconnect `clientFor` throws `PoolClosedError`.
+ * - Eviction cascades `disconnect()` to the evicted client.
+ * - Calls to `clientFor(url)` return the same instance for the same
+ *   URL (until eviction), so pooled-client hook registration is stable.
+ */
+export declare class ClientPool<M extends FnMap = FnMap> {
+    private readonly entries;
+    private readonly factory;
+    private readonly maxSize;
+    private closed;
+    private clock;
+    constructor(config: ClientPoolConfig<M>);
+    /**
+     * Resolve or create a client for `url`. Throws `PoolClosedError` if
+     * the pool has been disconnected.
+     */
+    clientFor(url: string): KernelClient<M>;
+    /**
+     * Evict a specific URL and call its client's `disconnect()`.
+     * Idempotent — no-op for unknown URLs.
+     */
+    evict(url: string): void;
+    /**
+     * Tear down every cached client. Idempotent. After disconnect,
+     * `clientFor` throws `PoolClosedError`.
+     */
+    disconnect(): void;
+    /** Current number of cached clients — pool introspection helper. */
+    get size(): number;
+    /** Whether `disconnect()` has been called. */
+    get isClosed(): boolean;
+    private evictLeastRecentlyUsed;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/pool/pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAI7C;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,CAAA;AAErF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI;IACtD,oEAAoE;IACpE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAQD;;;;;;;;;GASG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,KAAK,CAAI;IAEjB,YAAY,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAMtC;IAED;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAWtC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKvB;IAED;;;OAGG;IACH,UAAU,IAAI,IAAI,CAKjB;IAED,oEAAoE;IACpE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,8CAA8C;IAC9C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,CAAC,sBAAsB;CAW/B"}

package/dist/pool/pool.js

@@ -0,0 +1,87 @@
+import { PoolClosedError } from './errors';
+/**
+ * URL → `KernelClient` map with bounded LRU eviction. Spec §9.1.
+ *
+ * Invariants:
+ * - Idempotent `disconnect()` — subsequent calls are no-ops.
+ * - Post-disconnect `clientFor` throws `PoolClosedError`.
+ * - Eviction cascades `disconnect()` to the evicted client.
+ * - Calls to `clientFor(url)` return the same instance for the same
+ *   URL (until eviction), so pooled-client hook registration is stable.
+ */
+export class ClientPool {
+    entries = new Map();
+    factory;
+    maxSize;
+    closed = false;
+    clock = 0;
+    constructor(config) {
+        this.factory = config.clientFactory;
+        this.maxSize = config.maxSize ?? 32;
+        if (this.maxSize < 1) {
+            throw new Error(`ClientPool.maxSize must be >= 1 (got ${this.maxSize})`);
+        }
+    }
+    /**
+     * Resolve or create a client for `url`. Throws `PoolClosedError` if
+     * the pool has been disconnected.
+     */
+    clientFor(url) {
+        if (this.closed)
+            throw new PoolClosedError();
+        const existing = this.entries.get(url);
+        if (existing) {
+            existing.lastUsed = ++this.clock;
+            return existing.client;
+        }
+        if (this.entries.size >= this.maxSize)
+            this.evictLeastRecentlyUsed();
+        const client = this.factory(url);
+        this.entries.set(url, { client, lastUsed: ++this.clock });
+        return client;
+    }
+    /**
+     * Evict a specific URL and call its client's `disconnect()`.
+     * Idempotent — no-op for unknown URLs.
+     */
+    evict(url) {
+        const entry = this.entries.get(url);
+        if (!entry)
+            return;
+        this.entries.delete(url);
+        entry.client.disconnect();
+    }
+    /**
+     * Tear down every cached client. Idempotent. After disconnect,
+     * `clientFor` throws `PoolClosedError`.
+     */
+    disconnect() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const { client } of this.entries.values())
+            client.disconnect();
+        this.entries.clear();
+    }
+    /** Current number of cached clients — pool introspection helper. */
+    get size() {
+        return this.entries.size;
+    }
+    /** Whether `disconnect()` has been called. */
+    get isClosed() {
+        return this.closed;
+    }
+    evictLeastRecentlyUsed() {
+        let oldestUrl;
+        let oldestTs = Number.POSITIVE_INFINITY;
+        for (const [url, entry] of this.entries) {
+            if (entry.lastUsed < oldestTs) {
+                oldestTs = entry.lastUsed;
+                oldestUrl = url;
+            }
+        }
+        if (oldestUrl !== undefined)
+            this.evict(oldestUrl);
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/pool/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/pool/pool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAgC1C;;;;;;;;;GASG;AACH,MAAM,OAAO,UAAU;IACJ,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAA;IACzC,OAAO,CAAkB;IACzB,OAAO,CAAQ;IACxB,MAAM,GAAG,KAAK,CAAA;IACd,KAAK,GAAG,CAAC,CAAA;IAEjB,YAAY,MAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,aAAa,CAAA;QACnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAA;QACnC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,GAAW;QACnB,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,eAAe,EAAE,CAAA;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,QAAQ,GAAG,EAAE,IAAI,CAAC,KAAK,CAAA;YAChC,OAAO,QAAQ,CAAC,MAAM,CAAA;QACxB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,sBAAsB,EAAE,CAAA;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QACzD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAW;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK;YAAE,OAAM;QAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACxB,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,UAAU,EAAE,CAAA;QACnE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED,oEAAoE;IACpE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED,8CAA8C;IAC9C,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAEO,sBAAsB;QAC5B,IAAI,SAA6B,CAAA;QACjC,IAAI,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAA;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;gBAC9B,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;gBACzB,SAAS,GAAG,GAAG,CAAA;YACjB,CAAC;QACH,CAAC;QACD,IAAI,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACpD,CAAC;CACF"}

package/dist/redirect/errors.d.ts

@@ -0,0 +1,45 @@
+import type { CallRedirection } from '@astrale-os/kernel-api';
+import { ClientSessionError } from '../errors/session-error';
+/**
+ * Redirect policy refused to follow a redirection.
+ *
+ * Thrown by ClientSession's dispatch loop after `RedirectPolicy.decide` returns
+ * `{ follow: false, reason }`. The refused `redirection` is preserved so
+ * consumers can surface the URL to the user or retry explicitly via
+ * `session.call(..., { url: e.redirection.url })`. Spec §10.3.
+ */
+export declare class RedirectRefusedError extends ClientSessionError {
+    readonly redirection: CallRedirection;
+    readonly reason: string;
+    constructor(redirection: CallRedirection, reason: string, options?: ErrorOptions);
+}
+/**
+ * Redirect chain exceeded the configured `maxHops`.
+ *
+ * Thrown by ClientSession's dispatch loop before calling `RedirectPolicy.decide`
+ * on the would-be (N+1)-th hop. `hops` carries the full chain to that
+ * point — first element is the initial target, last is the hop that
+ * returned the cap-triggering redirect. Spec §10.3.
+ */
+export declare class HopLimitExceededError extends ClientSessionError {
+    readonly method: string;
+    readonly hops: ReadonlyArray<{
+        url: string;
+        at: number;
+    }>;
+    constructor(method: string, hops: ReadonlyArray<{
+        url: string;
+        at: number;
+    }>);
+}
+/**
+ * A `RedirectPolicy.decide` implementation itself threw.
+ *
+ * Programmer error at the policy layer. The thrown error wraps as
+ * `cause`. Consumers treating this as "refused" is safe. Spec §10.3.
+ */
+export declare class RedirectPolicyError extends ClientSessionError {
+    readonly redirection: CallRedirection;
+    constructor(redirection: CallRedirection, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/redirect/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAE5D;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,kBAAkB;aAExC,WAAW,EAAE,eAAe;aAC5B,MAAM,EAAE,MAAM;IAFhC,YACkB,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,MAAM,EAC9B,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,kBAAkB;aAEzC,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAFlE,YACkB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAIjE;CACF;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;aAEvC,WAAW,EAAE,eAAe;IAD9C,YACkB,WAAW,EAAE,eAAe,EAC5C,OAAO,CAAC,EAAE,YAAY,EAQvB;CACF"}

package/dist/redirect/errors.js

@@ -0,0 +1,52 @@
+import { ClientSessionError } from '../errors/session-error';
+/**
+ * Redirect policy refused to follow a redirection.
+ *
+ * Thrown by ClientSession's dispatch loop after `RedirectPolicy.decide` returns
+ * `{ follow: false, reason }`. The refused `redirection` is preserved so
+ * consumers can surface the URL to the user or retry explicitly via
+ * `session.call(..., { url: e.redirection.url })`. Spec §10.3.
+ */
+export class RedirectRefusedError extends ClientSessionError {
+    redirection;
+    reason;
+    constructor(redirection, reason, options) {
+        super(`Redirect to ${redirection.url} refused: ${reason}`, 'REDIRECT_REFUSED', options);
+        this.redirection = redirection;
+        this.reason = reason;
+        this.name = 'RedirectRefusedError';
+    }
+}
+/**
+ * Redirect chain exceeded the configured `maxHops`.
+ *
+ * Thrown by ClientSession's dispatch loop before calling `RedirectPolicy.decide`
+ * on the would-be (N+1)-th hop. `hops` carries the full chain to that
+ * point — first element is the initial target, last is the hop that
+ * returned the cap-triggering redirect. Spec §10.3.
+ */
+export class HopLimitExceededError extends ClientSessionError {
+    method;
+    hops;
+    constructor(method, hops) {
+        super(`Hop limit exceeded for "${method}": ${hops.length} hops`, 'HOP_LIMIT_EXCEEDED');
+        this.method = method;
+        this.hops = hops;
+        this.name = 'HopLimitExceededError';
+    }
+}
+/**
+ * A `RedirectPolicy.decide` implementation itself threw.
+ *
+ * Programmer error at the policy layer. The thrown error wraps as
+ * `cause`. Consumers treating this as "refused" is safe. Spec §10.3.
+ */
+export class RedirectPolicyError extends ClientSessionError {
+    redirection;
+    constructor(redirection, options) {
+        super(`Redirect policy threw while deciding → ${redirection.url}`, 'REDIRECT_POLICY_THREW', options);
+        this.redirection = redirection;
+        this.name = 'RedirectPolicyError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/redirect/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/redirect/errors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAE5D;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAqB,SAAQ,kBAAkB;IAExC,WAAW;IACX,MAAM;IAFxB,YACkB,WAA4B,EAC5B,MAAc,EAC9B,OAAsB;QAEtB,KAAK,CAAC,eAAe,WAAW,CAAC,GAAG,aAAa,MAAM,EAAE,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAA;2BAJvE,WAAW;sBACX,MAAM;QAItB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,kBAAkB;IAEzC,MAAM;IACN,IAAI;IAFtB,YACkB,MAAc,EACd,IAAgD;QAEhE,KAAK,CAAC,2BAA2B,MAAM,MAAM,IAAI,CAAC,MAAM,OAAO,EAAE,oBAAoB,CAAC,CAAA;sBAHtE,MAAM;oBACN,IAAI;QAGpB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,kBAAkB;IAEvC,WAAW;IAD7B,YACkB,WAA4B,EAC5C,OAAsB;QAEtB,KAAK,CACH,0CAA0C,WAAW,CAAC,GAAG,EAAE,EAC3D,uBAAuB,EACvB,OAAO,CACR,CAAA;2BAPe,WAAW;QAQ3B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}

package/dist/redirect/index.d.ts

@@ -0,0 +1,4 @@
+export type { RedirectDecision, RedirectHop, RedirectPolicy } from './policy';
+export { allowAllPolicy, allowlistPolicy, promptPolicy, strictPolicy } from './policy';
+export { HopLimitExceededError, RedirectPolicyError, RedirectRefusedError } from './errors';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redirect/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC7E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACtF,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}

package/dist/redirect/index.js

@@ -0,0 +1,3 @@
+export { allowAllPolicy, allowlistPolicy, promptPolicy, strictPolicy } from './policy';
+export { HopLimitExceededError, RedirectPolicyError, RedirectRefusedError } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/redirect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/redirect/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACtF,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}