@astrale-os/kernel-client 0.5.1 → 0.6.0-beta.2

package/dist/pool/index.js

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

package/dist/pool/index.js.map

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

package/dist/pool/pool.d.ts

@@ -1,63 +1,24 @@
-import type { KernelClient } from '../client/client.js';
-import type { FnMap } from '../client/fn-map.js';
-/**
- * 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;
+import type { Client } from '../client/index.js';
+import type { ClientTarget } from './target.js';
+export type ClientFactory = (target: ClientTarget) => Client;
+export interface ClientPoolOptions {
+    readonly client: ClientFactory;
+    /** Maximum retained endpoint/transport Clients. Default: 32. */
+    readonly maximumSize?: number;
+}
+/** Bounded LRU pool for shareable one-hop Clients; eviction closes the selected Client. */
+export declare class ClientPool {
+    private readonly clients;
+    private readonly createClient;
+    private readonly maximumSize;
     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. */
+    constructor(options: ClientPoolOptions);
+    clientFor(target: ClientTarget): Client;
+    evict(target: ClientTarget): void;
+    close(): void;
     get size(): number;
-    /** Whether `disconnect()` has been called. */
     get isClosed(): boolean;
-    private evictLeastRecentlyUsed;
+    private evictOldest;
+    private requireOpen;
 }
 //# sourceMappingURL=pool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/pool/pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAIhD;;;;;;;;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"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../pool/pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK/C,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAA;AAE5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,2FAA2F;AAC3F,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGrB;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,MAAM,CAAQ;IAEtB,YAAY,OAAO,EAAE,iBAAiB,EASrC;IAED,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CActC;IAED,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAOhC;IAED,KAAK,IAAI,IAAI,CAKZ;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/pool/pool.js

@@ -1,87 +1,70 @@
-import { PoolClosedError } from './errors.js';
-/**
- * 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.
- */
+import { ClientError } from '../errors/index.js';
+import { admitTarget, targetKey } from './target.js';
+/** Bounded LRU pool for shareable one-hop Clients; eviction closes the selected Client. */
 export class ClientPool {
-    entries = new Map();
-    factory;
-    maxSize;
+    clients = new Map();
+    createClient;
+    maximumSize;
     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})`);
+    constructor(options) {
+        if (typeof options?.client !== 'function') {
+            throw new TypeError('ClientPool client factory is invalid.');
+        }
+        this.createClient = options.client;
+        this.maximumSize = options.maximumSize ?? 32;
+        if (!Number.isSafeInteger(this.maximumSize) || this.maximumSize < 1) {
+            throw new TypeError('ClientPool maximumSize must be a positive safe integer.');
         }
     }
-    /**
-     * 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);
+    clientFor(target) {
+        this.requireOpen();
+        const admitted = admitTarget(target);
+        const key = targetKey(admitted);
+        const existing = this.clients.get(key);
         if (existing) {
-            existing.lastUsed = ++this.clock;
+            this.clients.delete(key);
+            this.clients.set(key, existing);
             return existing.client;
         }
-        if (this.entries.size >= this.maxSize)
-            this.evictLeastRecentlyUsed();
-        const client = this.factory(url);
-        this.entries.set(url, { client, lastUsed: ++this.clock });
+        if (this.clients.size === this.maximumSize)
+            this.evictOldest();
+        const client = this.createClient(admitted);
+        this.clients.set(key, { target: admitted, client });
         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);
+    evict(target) {
+        const admitted = admitTarget(target);
+        const key = targetKey(admitted);
+        const entry = this.clients.get(key);
         if (!entry)
             return;
-        this.entries.delete(url);
-        entry.client.disconnect();
+        this.clients.delete(key);
+        entry.client.close();
     }
-    /**
-     * Tear down every cached client. Idempotent. After disconnect,
-     * `clientFor` throws `PoolClosedError`.
-     */
-    disconnect() {
+    close() {
         if (this.closed)
             return;
         this.closed = true;
-        for (const { client } of this.entries.values())
-            client.disconnect();
-        this.entries.clear();
+        for (const { client } of this.clients.values())
+            client.close();
+        this.clients.clear();
     }
-    /** Current number of cached clients — pool introspection helper. */
     get size() {
-        return this.entries.size;
+        return this.clients.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);
+    evictOldest() {
+        const oldest = this.clients.entries().next().value;
+        if (!oldest)
+            return;
+        this.clients.delete(oldest[0]);
+        oldest[1].client.close();
+    }
+    requireOpen() {
+        if (this.closed)
+            throw new ClientError('ClientPool is closed.');
     }
 }
 //# sourceMappingURL=pool.js.map

package/dist/pool/pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/pool/pool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAgC7C;;;;;;;;;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"}
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../pool/pool.ts"],"names":[],"mappings":"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"}

package/dist/pool/target.d.ts

@@ -0,0 +1,16 @@
+export type ClientTarget = {
+    readonly transport: 'http';
+    readonly url: string;
+} | {
+    readonly transport: 'websocket';
+    readonly url: string;
+} | {
+    readonly transport: 'auto';
+    readonly endpoints: {
+        readonly http: string;
+        readonly websocket: string;
+    };
+};
+export declare function admitTarget(input: ClientTarget): ClientTarget;
+export declare function targetKey(target: ClientTarget): string;
+//# sourceMappingURL=target.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../pool/target.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzD;IACE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1E,CAAA;AAEL,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAuB7D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAItD"}

package/dist/pool/target.js

@@ -0,0 +1,50 @@
+export function admitTarget(input) {
+    if (input === null || typeof input !== 'object') {
+        throw new TypeError('Client target must be an object.');
+    }
+    if (input.transport === 'http') {
+        return Object.freeze({ transport: 'http', url: endpoint(input.url, ['http:', 'https:']) });
+    }
+    if (input.transport === 'websocket') {
+        const url = new URL(endpoint(input.url, ['http:', 'https:', 'ws:', 'wss:']));
+        if (url.protocol === 'http:')
+            url.protocol = 'ws:';
+        if (url.protocol === 'https:')
+            url.protocol = 'wss:';
+        return Object.freeze({ transport: 'websocket', url: url.toString() });
+    }
+    if (input.transport === 'auto' && input.endpoints && typeof input.endpoints === 'object') {
+        return Object.freeze({
+            transport: 'auto',
+            endpoints: Object.freeze({
+                http: endpoint(input.endpoints.http, ['http:', 'https:']),
+                websocket: endpoint(input.endpoints.websocket, ['http:', 'https:', 'ws:', 'wss:']),
+            }),
+        });
+    }
+    throw new TypeError('Client target transport is invalid.');
+}
+export function targetKey(target) {
+    return target.transport === 'auto'
+        ? `auto\u0000${target.endpoints.http}\u0000${target.endpoints.websocket}`
+        : `${target.transport}\u0000${target.url}`;
+}
+function endpoint(input, protocols) {
+    if (typeof input !== 'string')
+        throw new TypeError('Client target URL must be a string.');
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch (cause) {
+        throw new TypeError('Client target URL is invalid.', { cause });
+    }
+    if (!protocols.includes(url.protocol) ||
+        url.username !== '' ||
+        url.password !== '' ||
+        url.hash !== '') {
+        throw new TypeError('Client target URL is invalid.');
+    }
+    return url.toString();
+}
+//# sourceMappingURL=target.js.map

package/dist/pool/target.js.map

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

package/dist/schema/admission.d.ts

@@ -0,0 +1,10 @@
+import type { schema as dslSchema } from '@astrale-os/kernel-dsl/v1';
+/** Admit one value result against the exact Kernel syscall declaration that owns it. */
+interface ValueSyscall {
+    readonly declaration: {
+        readonly output: dslSchema.CallableOutput;
+    };
+}
+export declare function acceptOutput<T>(owner: ValueSyscall, input: unknown): T;
+export {};
+//# sourceMappingURL=admission.d.ts.map

package/dist/schema/admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../../schema/admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAOpE,wFAAwF;AACxF,UAAU,YAAY;IACpB,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,cAAc,CAAA;KAC1C,CAAA;CACF;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAetE"}

package/dist/schema/admission.js

@@ -0,0 +1,23 @@
+import { KernelSchema } from '@astrale-os/kernel-core/schema';
+import { schema } from '@astrale-os/kernel-dsl/v1';
+import * as portable from '@astrale-os/kernel-dsl/value';
+export function acceptOutput(owner, input) {
+    if (owner.declaration.output.mode !== 'value') {
+        throw new TypeError('Schema Client expected a value-producing Kernel syscall.');
+    }
+    const value = portable.accept(input);
+    const diagnostics = schema.values.validate(KernelSchema, owner.declaration.output.schema, value, '/output');
+    if (diagnostics.length > 0) {
+        throw new TypeError(`Kernel returned an invalid Schema result: ${diagnostics[0].message}`);
+    }
+    return freeze(value);
+}
+function freeze(input) {
+    if (input !== null && typeof input === 'object' && !Object.isFrozen(input)) {
+        for (const value of Object.values(input))
+            freeze(value);
+        Object.freeze(input);
+    }
+    return input;
+}
+//# sourceMappingURL=admission.js.map

package/dist/schema/admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.js","sourceRoot":"","sources":["../../schema/admission.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAClD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAA;AASxD,MAAM,UAAU,YAAY,CAAI,KAAmB,EAAE,KAAc;IACjE,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9C,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAA;IACjF,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAU,CAAA;IAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CACxC,YAAY,EACZ,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAC/B,KAAK,EACL,SAAS,CACV,CAAA;IACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,SAAS,CAAC,6CAA6C,WAAW,CAAC,CAAC,CAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IAC7F,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAM,CAAA;AAC3B,CAAC;AAED,SAAS,MAAM,CAAkB,KAAQ;IACvC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACvD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/schema/index.d.ts

@@ -1,16 +1,4 @@
-export { SCHEMA_REGISTRY_BRAND, SchemaRegistry } from './registry.js';
-export { createSchemaClient } from './typed-client.js';
-export { createClassProxy } from './class-proxy.js';
-export { createNodeProxy, createInstanceProxy } from './node-proxy.js';
-export { resolveMethodKey } from './resolve.js';
-export { resolveCallArgs } from './call-args.js';
-export { createKnownInstanceDispatch, createKnownStaticDispatch } from './known-dispatch.js';
-export { extractMethodsByClass, extractMethodsByType } from './extract.js';
-export type { TypeMethods } from './extract.js';
-export { toFunctionSchemas } from './from-entries.js';
-export type { FunctionSchema } from './types.js';
-export type { SchemaPersistence } from './persistence.js';
-export type { ClassNames, ClassProxy, DefOf, InstanceDispatch, NodeProxy, ProxyCallOptions, ProxyCaller, SchemaTypedClient, StaticDispatch, TypeNames, } from './proxy-types.js';
-export { BindTypeMismatchError, createBoundNode, createNodeBinder, createSchemaBoundView, defaultCaller, resolveNeighbors, normalizeRef, } from './bound/index.js';
-export type { AnyBoundNode, BindCtx, BindOptions, BoundLinks, BoundNode, BoundNodeOperations, BoundPaged, BoundSnapshot, ClassHandle, CreatableClassNames, CreateProps, CreateSchemaBoundViewOpts, EdgeNames, EndpointsOf, NodeBinder, NodeRefInput, SchemaBoundView, SchemaClasses, } from './bound/index.js';
+export { createSchema, type SchemaApi, type SchemaCall, type SchemaOptions, type ReadyInstallation, } from './schema.js';
+export type { DesiredInstallation, InstallReceipt, InstallRequest, UninstallReceipt, UninstallRequest, } from '@astrale-os/kernel-ports/schema';
+export type { Operation, OperationId } from '@astrale-os/kernel-ports/schema/installation';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC5F,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAC1E,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,YAAY,EACV,UAAU,EACV,UAAU,EACV,KAAK,EACL,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,WAAW,EAGX,iBAAiB,EACjB,cAAc,EACd,SAAS,GACV,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,YAAY,EACZ,OAAO,EACP,WAAW,EACX,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,yBAAyB,EACzB,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAA;AAEpB,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAA"}

package/dist/schema/index.js

@@ -1,12 +1,2 @@
-export { SCHEMA_REGISTRY_BRAND, SchemaRegistry } from './registry.js';
-export { createSchemaClient } from './typed-client.js';
-export { createClassProxy } from './class-proxy.js';
-export { createNodeProxy, createInstanceProxy } from './node-proxy.js';
-export { resolveMethodKey } from './resolve.js';
-export { resolveCallArgs } from './call-args.js';
-export { createKnownInstanceDispatch, createKnownStaticDispatch } from './known-dispatch.js';
-export { extractMethodsByClass, extractMethodsByType } from './extract.js';
-export { toFunctionSchemas } from './from-entries.js';
-// ─── Schema-bound surface (SchemaBoundView / BoundNode / binder) ────────────
-export { BindTypeMismatchError, createBoundNode, createNodeBinder, createSchemaBoundView, defaultCaller, resolveNeighbors, normalizeRef, } from './bound/index.js';
+export { createSchema, } from './schema.js';
 //# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC5F,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAE1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAkBrD,+EAA+E;AAC/E,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,GAKb,MAAM,aAAa,CAAA"}

package/dist/schema/introspection.d.ts

@@ -0,0 +1,6 @@
+import type { introspection as language } from '@astrale-os/kernel-core/schema';
+import type { schema as protocol } from '@astrale-os/kernel-protocol';
+import type { RequestOptions } from '../transport/index.js';
+import type { SchemaCall, SchemaOptions } from './schema.js';
+export declare function introspect<InputType extends language.Introspection>(invoke: SchemaCall, limits: SchemaOptions, request: InputType, options?: RequestOptions): Promise<protocol.installation.introspection.ResultFor<InputType>>;
+//# sourceMappingURL=introspection.d.ts.map

package/dist/schema/introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.d.ts","sourceRoot":"","sources":["../../schema/introspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAE/E,OAAO,KAAK,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAMrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAM5D,wBAAsB,UAAU,CAAC,SAAS,SAAS,QAAQ,CAAC,aAAa,EACvE,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,SAAS,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CASnE"}

package/dist/schema/introspection.js

@@ -0,0 +1,16 @@
+import { Path } from '@astrale-os/kernel-core/path';
+import { syscalls } from '@astrale-os/kernel-core/schema';
+import { schema } from '@astrale-os/kernel-protocol';
+import { call } from '../client/index.js';
+const INTROSPECT_PATH = Path.project(syscalls.introspect.ref).raw;
+export async function introspect(invoke, limits, request, options) {
+    const result = await invoke(call(INTROSPECT_PATH, request), options);
+    if (result.kind !== 'binary') {
+        throw new TypeError('Schema introspection returned a non-binary result.');
+    }
+    if (result.value.mediaType !== schema.installation.introspection.MEDIA_TYPE) {
+        throw new TypeError('Schema introspection returned an unsupported media type.');
+    }
+    return schema.installation.introspection.decode(request, result.value.body, limits);
+}
+//# sourceMappingURL=introspection.js.map

package/dist/schema/introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.js","sourceRoot":"","sources":["../../schema/introspection.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAKpD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAEzC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAA;AAEjE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAkB,EAClB,MAAqB,EACrB,OAAkB,EAClB,OAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,OAA2B,CAAC,EAAE,OAAO,CAAC,CAAA;IACxF,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAA;IAC3E,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;QAC5E,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAA;IACjF,CAAC;IACD,OAAO,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AACrF,CAAC"}

package/dist/schema/schema.d.ts

@@ -0,0 +1,21 @@
+import type { introspection } from '@astrale-os/kernel-core/schema';
+import type { Result } from '@astrale-os/kernel-ports/functions';
+import type { InstallReceipt, InstallRequest, UninstallReceipt, UninstallRequest } from '@astrale-os/kernel-ports/schema';
+import type { schema as protocolSchema } from '@astrale-os/kernel-protocol';
+import type { Call } from '../client/index.js';
+import type { RequestOptions } from '../transport/index.js';
+export type SchemaCall = (call: Call, options?: RequestOptions) => Promise<Result>;
+export interface SchemaOptions extends protocolSchema.installation.introspection.Limits {
+}
+export type ReadyInstallation = protocolSchema.installation.introspection.Installation & {
+    readonly state: 'ready';
+    readonly readiness: protocolSchema.installation.introspection.Digest;
+};
+export interface SchemaApi {
+    install(request: InstallRequest, options?: RequestOptions): Promise<InstallReceipt>;
+    uninstall(request: UninstallRequest, options?: RequestOptions): Promise<UninstallReceipt>;
+    introspect<Input extends introspection.Introspection>(request: Input, options?: RequestOptions): Promise<protocolSchema.installation.introspection.ResultFor<Input>>;
+}
+/** Bind the canonical Schema lifecycle syscalls to one caller-scoped value-call capability. */
+export declare function createSchema(call: SchemaCall, limits: SchemaOptions): SchemaApi;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../schema/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAS,MAAM,EAAE,MAAM,oCAAoC,CAAA;AACvE,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAK3E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAM3D,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAElF,MAAM,WAAW,aAAc,SAAQ,cAAc,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM;CAAG;AAE1F,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,YAAY,CAAC,aAAa,CAAC,YAAY,GAAG;IACvF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAA;CACrE,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACnF,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACzF,UAAU,CAAC,KAAK,SAAS,aAAa,CAAC,aAAa,EAClD,OAAO,EAAE,KAAK,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;CACvE;AAKD,+FAA+F;AAC/F,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,CAuB/E"}

package/dist/schema/schema.js

@@ -0,0 +1,43 @@
+import { Path } from '@astrale-os/kernel-core/path';
+import { syscalls } from '@astrale-os/kernel-core/schema';
+import { call as invocation } from '../client/index.js';
+import { acceptOutput } from './admission.js';
+import { introspect as inspect } from './introspection.js';
+const INSTALL_PATH = Path.project(syscalls.install.ref).raw;
+const UNINSTALL_PATH = Path.project(syscalls.uninstall.ref).raw;
+/** Bind the canonical Schema lifecycle syscalls to one caller-scoped value-call capability. */
+export function createSchema(call, limits) {
+    if (typeof call !== 'function')
+        throw new TypeError('Schema call capability is invalid.');
+    const admittedLimits = admitLimits(limits);
+    return Object.freeze({
+        async install(request, options) {
+            const output = value(await call(invocation(INSTALL_PATH, request), options));
+            return acceptOutput(syscalls.install, output);
+        },
+        async uninstall(request, options) {
+            const output = value(await call(invocation(UNINSTALL_PATH, request), options));
+            return acceptOutput(syscalls.uninstall, output);
+        },
+        async introspect(request, options) {
+            return inspect(call, admittedLimits, request, options);
+        },
+    });
+}
+function value(result) {
+    if (result.kind !== 'value')
+        throw new TypeError('Schema syscall returned a non-value result.');
+    return result.value;
+}
+function admitLimits(input) {
+    if (input === null ||
+        typeof input !== 'object' ||
+        !Number.isSafeInteger(input.maximumPublicationBytes) ||
+        input.maximumPublicationBytes < 1 ||
+        !Number.isSafeInteger(input.maximumBundleBytes) ||
+        input.maximumBundleBytes < 1) {
+        throw new TypeError('Schema introspection limits are invalid.');
+    }
+    return Object.freeze({ ...input });
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../schema/schema.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAKzD,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAoB1D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAA;AAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAA;AAE/D,+FAA+F;AAC/F,MAAM,UAAU,YAAY,CAAC,IAAgB,EAAE,MAAqB;IAClE,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAA;IACzF,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,CAAC,OAAO,CAAC,OAAuB,EAAE,OAAwB;YAC7D,MAAM,MAAM,GAAG,KAAK,CAClB,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,OAA2B,CAAC,EAAE,OAAO,CAAC,CAC3E,CAAA;YACD,OAAO,YAAY,CAAiB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC/D,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,OAAyB,EAAE,OAAwB;YACjE,MAAM,MAAM,GAAG,KAAK,CAClB,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,OAA2B,CAAC,EAAE,OAAO,CAAC,CAC7E,CAAA;YACD,OAAO,YAAY,CAAmB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QACnE,CAAC;QACD,KAAK,CAAC,UAAU,CACd,OAAc,EACd,OAAwB;YAExB,OAAO,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QACxD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,MAAc;IAC3B,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAA;IAC/F,OAAO,MAAM,CAAC,KAAK,CAAA;AACrB,CAAC;AAED,SAAS,WAAW,CAAC,KAAoB;IACvC,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,uBAAuB,CAAC;QACpD,KAAK,CAAC,uBAAuB,GAAG,CAAC;QACjC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,kBAAkB,CAAC;QAC/C,KAAK,CAAC,kBAAkB,GAAG,CAAC,EAC5B,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;AACpC,CAAC"}

package/dist/session/context/control.d.ts

@@ -0,0 +1,6 @@
+export interface SessionControlOptions {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+export declare function admitControlOptions(input: SessionControlOptions | undefined): Readonly<SessionControlOptions>;
+//# sourceMappingURL=control.d.ts.map

package/dist/session/context/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../../session/context/control.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GACvC,QAAQ,CAAC,qBAAqB,CAAC,CAcjC"}

package/dist/session/context/control.js

@@ -0,0 +1,18 @@
+import { platformDuration } from './limits.js';
+export function admitControlOptions(input) {
+    if (input === undefined)
+        return Object.freeze({});
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new TypeError('Session control options are invalid.');
+    }
+    if (input.signal !== undefined && !(input.signal instanceof AbortSignal)) {
+        throw new TypeError('Session cancellation signal is invalid.');
+    }
+    return Object.freeze({
+        ...(input.signal === undefined ? {} : { signal: input.signal }),
+        ...(input.timeoutMs === undefined
+            ? {}
+            : { timeoutMs: platformDuration(input.timeoutMs, 'timeoutMs') }),
+    });
+}
+//# sourceMappingURL=control.js.map

package/dist/session/context/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../../session/context/control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAO9C,MAAM,UAAU,mBAAmB,CACjC,KAAwC;IAExC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACjD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAA;IAC7D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,YAAY,WAAW,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS;YAC/B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC;KACnE,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+export { admitControlOptions, type SessionControlOptions } from './control.js';
+export { DEFAULT_MAXIMUM_BUNDLE_BYTES, DEFAULT_MAXIMUM_PUBLICATION_BYTES, DEFAULT_MAXIMUM_RESPONSE_BYTES, DEFAULT_MAXIMUM_ROUTES, DEFAULT_TIMEOUT_MS, platformDuration, positive, } from './limits.js';
+export { createSessionOperation, runSessionOperation, sessionTransportOptions, type SessionOperation, } from './operation.js';
+export { admitKernel, admitPolicy, allowEndpoint, kernelInvocationEndpoint, type SessionPolicy, } from './policy.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../session/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,8BAA8B,EAC9B,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,GACT,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,wBAAwB,EACxB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAA"}

package/dist/session/context/index.js

@@ -0,0 +1,5 @@
+export { admitControlOptions } from './control.js';
+export { DEFAULT_MAXIMUM_BUNDLE_BYTES, DEFAULT_MAXIMUM_PUBLICATION_BYTES, DEFAULT_MAXIMUM_RESPONSE_BYTES, DEFAULT_MAXIMUM_ROUTES, DEFAULT_TIMEOUT_MS, platformDuration, positive, } from './limits.js';
+export { createSessionOperation, runSessionOperation, sessionTransportOptions, } from './operation.js';
+export { admitKernel, admitPolicy, allowEndpoint, kernelInvocationEndpoint, } from './policy.js';
+//# sourceMappingURL=index.js.map

package/dist/session/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../session/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA8B,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,8BAA8B,EAC9B,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,GACT,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,wBAAwB,GAEzB,MAAM,aAAa,CAAA"}

package/dist/session/context/limits.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_MAXIMUM_PUBLICATION_BYTES: number;
+export declare const DEFAULT_MAXIMUM_BUNDLE_BYTES: number;
+export declare const DEFAULT_MAXIMUM_RESPONSE_BYTES: number;
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const DEFAULT_MAXIMUM_ROUTES = 256;
+export declare function positive(input: number, label: string): number;
+export declare function platformDuration(input: number, label: string): number;
+//# sourceMappingURL=limits.d.ts.map