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

package/dist/session/routing/request.d.ts

@@ -0,0 +1,9 @@
+import type { invocation } from '@astrale-os/kernel-protocol';
+import type { SessionControlOptions } from '../context/index.js';
+export type SessionEnvelopeTransport = 'auto' | 'http' | 'websocket';
+export interface SessionRequestOptions extends SessionControlOptions {
+    readonly idempotencyKey?: invocation.IdempotencyKey;
+}
+export declare function admitRequestOptions(input?: SessionRequestOptions): Readonly<SessionRequestOptions>;
+export declare function admitEnvelopeTransport(input: SessionEnvelopeTransport): SessionEnvelopeTransport;
+//# sourceMappingURL=request.d.ts.map

package/dist/session/routing/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../session/routing/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAI7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAIhE,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAA;AAEpE,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,cAAc,CAAA;CACpD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,GAAE,qBAA0B,GAChC,QAAQ,CAAC,qBAAqB,CAAC,CAiBjC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,wBAAwB,GAAG,wBAAwB,CAKhG"}

package/dist/session/routing/request.js

@@ -0,0 +1,26 @@
+import { invocation as invocationProtocol } from '@astrale-os/kernel-protocol';
+import { admitControlOptions } from '../context/index.js';
+export function admitRequestOptions(input = {}) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new TypeError('Session request options are invalid.');
+    }
+    const control = admitControlOptions(input);
+    const fields = Reflect.ownKeys(input);
+    if (fields.some((field) => !['signal', 'timeoutMs', 'idempotencyKey'].includes(String(field)))) {
+        throw new TypeError('Session request options contain unsupported fields.');
+    }
+    const idempotencyKey = input.idempotencyKey === undefined
+        ? undefined
+        : invocationProtocol.acceptIdempotencyKey(input.idempotencyKey, 'request.idempotencyKey');
+    return Object.freeze({
+        ...control,
+        ...(idempotencyKey === undefined ? {} : { idempotencyKey }),
+    });
+}
+export function admitEnvelopeTransport(input) {
+    if (input !== 'auto' && input !== 'http' && input !== 'websocket') {
+        throw new TypeError('Session envelope transport is invalid.');
+    }
+    return input;
+}
+//# sourceMappingURL=request.js.map

package/dist/session/routing/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../session/routing/request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAI9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAQzD,MAAM,UAAU,mBAAmB,CACjC,KAAK,GAA0B,EAAE;IAEjC,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,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAA;IAC5E,CAAC;IACD,MAAM,cAAc,GAClB,KAAK,CAAC,cAAc,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,KAAK,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAA;IAC7F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,OAAO;QACV,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;KAC5D,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAA+B;IACpE,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/session/session.d.ts

@@ -0,0 +1,62 @@
+import type { IssuerId } from '@astrale-os/kernel-core/auth';
+import type { PathLike } from '@astrale-os/kernel-core/path';
+import type { Key } from '@astrale-os/kernel-dsl/v1';
+import type { Input, Result } from '@astrale-os/kernel-ports/functions';
+import type { Call } from '../client/index.js';
+import type { ClientFactory, ClientPool as ClientPoolType } from '../pool/index.js';
+import type { ReadyInstallation, SchemaApi } from '../schema/index.js';
+import type { ClientWarning } from '../transport/auto/index.js';
+import type { Fetch } from '../transport/http/index.js';
+import type { WebSocketConstructor } from '../transport/websocket/index.js';
+import type { SessionControlOptions, SessionPolicy } from './context/index.js';
+import type { SessionSnapshot } from './discovery/index.js';
+import type { SessionAuth, BoundTarget, SessionEnvelopeTransport, SessionRequestOptions } from './routing/index.js';
+import type { ViewCatalog } from './views/index.js';
+export interface ClientSessionOptions {
+    /** Exact canonical source Kernel identity; its invocation and discovery endpoints are derived. */
+    readonly kernel: string;
+    readonly fetch?: Fetch;
+    readonly client?: ClientFactory;
+    readonly pool?: Pick<ClientPoolType, 'clientFor'>;
+    readonly websocket?: WebSocketConstructor;
+    readonly auth?: SessionAuth;
+    readonly policy: SessionPolicy;
+    readonly envelopeTransport?: SessionEnvelopeTransport;
+    readonly onWarning?: (warning: ClientWarning) => void;
+    readonly maximumPublicationBytes?: number;
+    readonly maximumBundleBytes?: number;
+    readonly maximumResponseBytes?: number;
+    readonly timeoutMs?: number;
+}
+export type ConnectOptions = Omit<ClientSessionOptions, 'policy'> & {
+    readonly policy?: SessionPolicy;
+};
+/** Package-private exact-Publication dispatch used by Domain bindings. */
+export declare function dispatchBound(session: ClientSession, call: Call, expected: BoundTarget, options?: SessionRequestOptions): Promise<Result>;
+/** Caller-owned discovery and redirect-following conversation with one exact source Kernel. */
+export declare class ClientSession {
+    readonly kernel: IssuerId;
+    readonly schema: SchemaApi;
+    private readonly ownedPool?;
+    private readonly discovery;
+    private readonly dispatcher;
+    private readonly lifecycle;
+    private readonly timeoutMs;
+    private readonly routes;
+    private readonly admitTargetViews;
+    private closed;
+    constructor(options: ClientSessionOptions);
+    snapshot(options?: SessionControlOptions): Promise<SessionSnapshot>;
+    viewsFor(target: PathLike, options?: SessionControlOptions): Promise<ViewCatalog>;
+    installed(origin: Key.Origin, options?: SessionControlOptions): Promise<ReadyInstallation>;
+    dispatch(call: Call, options?: SessionRequestOptions): Promise<Result>;
+    call(call: Call, options?: SessionRequestOptions): Promise<Input>;
+    stream(call: Call, options?: SessionRequestOptions): Promise<import("@astrale-os/kernel-ports/functions").Stream>;
+    binary(call: Call, options?: SessionRequestOptions): Promise<import("@astrale-os/kernel-ports/functions").Binary>;
+    close(): void;
+    private requireOpen;
+    private operation;
+}
+/** Open one caller-owned conversation with a Kernel using secure defaults. */
+export declare function connect(options: ConnectOptions): ClientSession;
+//# sourceMappingURL=session.d.ts.map

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

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

package/dist/session/session.js

@@ -0,0 +1,225 @@
+import { Client } from '../client/index.js';
+import { ClientError } from '../errors/index.js';
+import { ClientPool } from '../pool/index.js';
+import { createSchema } from '../schema/index.js';
+import { AutoTransport } from '../transport/auto/index.js';
+import { HttpTransport } from '../transport/http/index.js';
+import { WebSocketTransport } from '../transport/websocket/index.js';
+import { admitControlOptions, admitPolicy, createSessionOperation, DEFAULT_MAXIMUM_BUNDLE_BYTES, DEFAULT_MAXIMUM_PUBLICATION_BYTES, DEFAULT_MAXIMUM_RESPONSE_BYTES, DEFAULT_TIMEOUT_MS, admitKernel, kernelInvocationEndpoint, platformDuration, positive, } from './context/index.js';
+import { createSessionDiscovery } from './discovery/index.js';
+import { admitEnvelopeTransport, admitRequestOptions, admitSessionAuth, requireResultKind, RouteCache, SessionDispatcher, } from './routing/index.js';
+import { resolveViewsFor, targetViewCatalog } from './views/index.js';
+const DEFAULT_SESSION_POLICY = Object.freeze({ maximumRouteAgeMs: 60_000 });
+const boundDispatch = new WeakMap();
+/** Package-private exact-Publication dispatch used by Domain bindings. */
+export function dispatchBound(session, call, expected, options) {
+    const dispatch = boundDispatch.get(session);
+    if (dispatch === undefined)
+        throw new TypeError('Bound dispatch requires an owned ClientSession.');
+    return dispatch(call, expected, options);
+}
+/** Caller-owned discovery and redirect-following conversation with one exact source Kernel. */
+export class ClientSession {
+    kernel;
+    schema;
+    ownedPool;
+    discovery;
+    dispatcher;
+    lifecycle = new AbortController();
+    timeoutMs;
+    routes;
+    admitTargetViews;
+    closed = false;
+    constructor(options) {
+        if (options === null || typeof options !== 'object') {
+            throw new TypeError('ClientSession options are invalid.');
+        }
+        const policy = admitPolicy(options.policy);
+        this.admitTargetViews = (input) => targetViewCatalog(input, policy);
+        this.kernel = admitKernel(options.kernel, policy.allowInsecureHttp === true);
+        const sourceEndpoint = kernelInvocationEndpoint(this.kernel);
+        const fetch = options.fetch ?? globalThis.fetch;
+        if (typeof fetch !== 'function')
+            throw new TypeError('ClientSession requires Fetch.');
+        const fetchImpl = options.fetch === undefined ? fetch.bind(globalThis) : fetch;
+        if (options.client !== undefined && options.pool !== undefined) {
+            throw new TypeError('ClientSession accepts either client or pool, not both.');
+        }
+        const maximumPublicationBytes = positive(options.maximumPublicationBytes ?? DEFAULT_MAXIMUM_PUBLICATION_BYTES, 'maximumPublicationBytes');
+        const maximumBundleBytes = positive(options.maximumBundleBytes ?? DEFAULT_MAXIMUM_BUNDLE_BYTES, 'maximumBundleBytes');
+        const maximumResponseBytes = positive(options.maximumResponseBytes ?? DEFAULT_MAXIMUM_RESPONSE_BYTES, 'maximumResponseBytes');
+        const timeoutMs = platformDuration(options.timeoutMs ?? DEFAULT_TIMEOUT_MS, 'timeoutMs');
+        this.timeoutMs = timeoutMs;
+        const websocketAvailable = options.client !== undefined ||
+            options.pool !== undefined ||
+            options.websocket !== undefined ||
+            typeof globalThis.WebSocket === 'function';
+        const client = options.client ??
+            defaultClientFactory({
+                fetch: fetchImpl,
+                ...(options.websocket === undefined ? {} : { websocket: options.websocket }),
+                ...(options.onWarning === undefined ? {} : { onWarning: options.onWarning }),
+                maximumResponseBytes,
+                timeoutMs,
+            });
+        let pool;
+        if (options.pool === undefined) {
+            const ownedPool = new ClientPool({ client });
+            this.ownedPool = ownedPool;
+            pool = admitClientPool(ownedPool);
+        }
+        else {
+            pool = admitClientPool(options.pool);
+        }
+        this.discovery = createSessionDiscovery({
+            kernel: this.kernel,
+            fetch: fetchImpl,
+            policy,
+            maximumPublicationBytes,
+            maximumBundleBytes,
+            requireOpen: () => this.requireOpen(),
+            acquisitionOperation: () => this.operation(undefined),
+        });
+        this.routes = new RouteCache(policy.maximumRouteAgeMs);
+        this.dispatcher = new SessionDispatcher({
+            kernel: this.kernel,
+            sourceEndpoint,
+            pool,
+            websocketAvailable,
+            auth: admitSessionAuth(options.auth),
+            cache: this.routes,
+            policy,
+            envelopeTransport: admitEnvelopeTransport(options.envelopeTransport ?? 'http'),
+            discovery: this.discovery,
+            requireOpen: () => this.requireOpen(),
+        });
+        this.schema = createSchema((request, options) => this.dispatch(request, options), {
+            maximumPublicationBytes,
+            maximumBundleBytes,
+        });
+        boundDispatch.set(this, (request, expected, options) => {
+            const admitted = admitRequestOptions(options);
+            return this.dispatcher.dispatch(request, admitted, this.operation(admitted), expected);
+        });
+    }
+    snapshot(options) {
+        return this.discovery.snapshot(this.operation(admitControlOptions(options)));
+    }
+    viewsFor(target, options) {
+        this.requireOpen();
+        return resolveViewsFor(async (call, operation) => requireResultKind('value', await this.dispatcher.dispatch(call, {}, operation)).value, this.admitTargetViews, target, this.operation(admitControlOptions(options)));
+    }
+    async installed(origin, options) {
+        const result = await this.schema.introspect({
+            from: { kind: 'installation', origin },
+            select: {
+                state: true,
+                target: true,
+                source: true,
+                bundle: true,
+                readiness: true,
+                capabilities: true,
+            },
+        }, options);
+        if (result?.state !== 'ready' || result.readiness === null) {
+            throw new ClientError(`Domain ${origin} is not ready on this Kernel.`);
+        }
+        return result;
+    }
+    dispatch(call, options) {
+        const admitted = admitRequestOptions(options);
+        return this.dispatcher.dispatch(call, admitted, this.operation(admitted));
+    }
+    async call(call, options) {
+        const result = await this.dispatch(call, options);
+        return requireResultKind('value', result).value;
+    }
+    async stream(call, options) {
+        const result = await this.dispatch(call, options);
+        return requireResultKind('stream', result).stream;
+    }
+    async binary(call, options) {
+        const result = await this.dispatch(call, options);
+        return requireResultKind('binary', result).value;
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.lifecycle.abort(new ClientError('ClientSession is closed.'));
+        this.ownedPool?.close();
+        this.routes.clear();
+        this.discovery.clear();
+    }
+    requireOpen() {
+        if (this.closed)
+            throw new ClientError('ClientSession is closed.');
+    }
+    operation(options) {
+        this.requireOpen();
+        return createSessionOperation(this.lifecycle.signal, options, this.timeoutMs);
+    }
+}
+/** Open one caller-owned conversation with a Kernel using secure defaults. */
+export function connect(options) {
+    return new ClientSession({
+        ...options,
+        policy: options.policy ?? DEFAULT_SESSION_POLICY,
+    });
+}
+function admitClientPool(input) {
+    if (input === null ||
+        typeof input !== 'object' ||
+        typeof input.clientFor !== 'function') {
+        throw new TypeError('Session client pool capability is invalid.');
+    }
+    return Object.freeze({
+        clientFor: (target) => admitPooledClient(input.clientFor.call(input, target)),
+    });
+}
+function admitPooledClient(input) {
+    if (input === null ||
+        typeof input !== 'object' ||
+        typeof input.dispatch !== 'function' ||
+        typeof input.as !== 'function' ||
+        typeof input.close !== 'function') {
+        throw new TypeError('Session client pool capability returned an invalid Client.');
+    }
+    return input;
+}
+function defaultClientFactory(options) {
+    return (target) => {
+        switch (target.transport) {
+            case 'http':
+                return new Client({
+                    transport: new HttpTransport({
+                        url: target.url,
+                        fetch: options.fetch,
+                        timeoutMs: options.timeoutMs,
+                        maximumResponseBytes: options.maximumResponseBytes,
+                    }),
+                });
+            case 'websocket':
+                return new Client({
+                    transport: new WebSocketTransport({
+                        url: target.url,
+                        timeoutMs: options.timeoutMs,
+                        maximumResponseBytes: options.maximumResponseBytes,
+                        ...(options.websocket === undefined ? {} : { websocket: options.websocket }),
+                    }),
+                });
+            case 'auto':
+                return new Client({
+                    transport: new AutoTransport({
+                        endpoints: target.endpoints,
+                        fetch: options.fetch,
+                        timeoutMs: options.timeoutMs,
+                        maximumResponseBytes: options.maximumResponseBytes,
+                        ...(options.websocket === undefined ? {} : { websocket: options.websocket }),
+                        ...(options.onWarning === undefined ? {} : { onWarning: options.onWarning }),
+                    }),
+                });
+        }
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/session/session.js.map

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

package/dist/session/session.typecheck.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.typecheck.d.ts.map

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

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

package/dist/session/session.typecheck.js

@@ -0,0 +1,10 @@
+import { ClientSession } from './index.js';
+void new ClientSession(options);
+void auth;
+void control;
+void envelope;
+void policy;
+void request;
+void snapshot;
+void {};
+//# sourceMappingURL=session.typecheck.js.map

package/dist/session/session.typecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.typecheck.js","sourceRoot":"","sources":["../../session/session.typecheck.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAU1C,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAAA;AAC/B,KAAK,IAAI,CAAA;AACT,KAAK,OAAO,CAAA;AACZ,KAAK,QAAQ,CAAA;AACb,KAAK,MAAM,CAAA;AACX,KAAK,OAAO,CAAA;AACZ,KAAK,QAAQ,CAAA;AAIb,KAAM,EAAwB,CAAA"}

package/dist/session/views/catalog.d.ts

@@ -0,0 +1,16 @@
+import type { Key, bundle } from '@astrale-os/kernel-dsl/v1';
+import type { publication } from '@astrale-os/kernel-protocol';
+import { syscalls } from '@astrale-os/kernel-core/schema';
+import type { SessionPolicy } from '../context/index.js';
+/** One verified View declaration joined with its owning Publication and provenance. */
+export type ResolvedView = syscalls.view.ResolvedView;
+/** Immutable canonical-key-ordered inventory of Views resolved under one Session revision. */
+export interface ViewCatalog {
+    readonly entrypoint?: ResolvedView;
+    readonly views: readonly ResolvedView[];
+}
+export declare function rootViewCatalog(publication: publication.Publication, artifact: bundle.Bundle, policy: Readonly<SessionPolicy>): ViewCatalog;
+export declare function catalogFromKeys(root: ViewCatalog, keys: readonly Key.View[]): ViewCatalog;
+/** Re-admit one Runtime-resolved heterogeneous View catalog at the Client trust boundary. */
+export declare function targetViewCatalog(input: unknown, policy: Readonly<SessionPolicy>): ViewCatalog;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/session/views/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../session/views/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAGzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAKxD,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAA;AAErD,8FAA8F;AAC9F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;CACxC;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,WAAW,CAAC,WAAW,EACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EACvB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC9B,WAAW,CAgCb;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,GAAG,CAAC,IAAI,EAAE,GAAG,WAAW,CASzF;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,WAAW,CAS9F"}

package/dist/session/views/catalog.js

@@ -0,0 +1,63 @@
+import { syscalls } from '@astrale-os/kernel-core/schema';
+import { Key as ViewKey, Ref } from '@astrale-os/kernel-dsl/v1';
+import { ClientError } from '../../errors/index.js';
+import { allowEndpoint } from '../context/index.js';
+export function rootViewCatalog(publication, artifact, policy) {
+    const views = publication.bindings.views
+        .map((binding) => {
+        allowEndpoint(binding.href, policy);
+        const declaration = artifact.root.views[Ref.member(ViewKey.ref(binding.view))];
+        if (declaration === undefined) {
+            throw new ClientError('Published View has no verified root declaration.');
+        }
+        return Object.freeze({
+            key: binding.view,
+            declaration,
+            href: binding.href,
+            handshake: binding.handshake,
+            issuer: publication.identity.issuer,
+            etag: publication.etag,
+            revision: publication.schema.revision,
+        });
+    })
+        .sort((left, right) => compareKeys(left.key, right.key));
+    const catalogViews = Object.freeze(views);
+    const entrypointRef = publication.manifest?.entrypoint;
+    const entrypoint = entrypointRef === undefined
+        ? undefined
+        : catalogViews.find(({ key }) => key === ViewKey.of(publication.origin, entrypointRef));
+    if (entrypointRef !== undefined && entrypoint === undefined) {
+        throw new ClientError('Published View entrypoint has no verified Publication binding.');
+    }
+    return Object.freeze({
+        ...(entrypoint === undefined ? {} : { entrypoint }),
+        views: catalogViews,
+    });
+}
+export function catalogFromKeys(root, keys) {
+    const selected = new Set(keys);
+    const views = Object.freeze(root.views.filter(({ key }) => selected.has(key)));
+    return Object.freeze({
+        ...(root.entrypoint !== undefined && selected.has(root.entrypoint.key)
+            ? { entrypoint: root.entrypoint }
+            : {}),
+        views,
+    });
+}
+/** Re-admit one Runtime-resolved heterogeneous View catalog at the Client trust boundary. */
+export function targetViewCatalog(input, policy) {
+    let resolution;
+    try {
+        resolution = syscalls.view.acceptResolution(input);
+    }
+    catch (cause) {
+        throw new ClientError('Resolved View catalog is invalid.', { cause });
+    }
+    for (const view of resolution.views)
+        allowEndpoint(view.href, policy);
+    return Object.freeze({ views: resolution.views });
+}
+function compareKeys(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/session/views/catalog.js.map

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

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

@@ -0,0 +1,3 @@
+export { catalogFromKeys, rootViewCatalog, targetViewCatalog, type ResolvedView, type ViewCatalog, } from './catalog.js';
+export { resolveViewsFor, type ViewCatalogAdmission, type ViewInvoker } from './resolve.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../session/views/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA"}

package/dist/session/views/index.js

@@ -0,0 +1,3 @@
+export { catalogFromKeys, rootViewCatalog, targetViewCatalog, } from './catalog.js';
+export { resolveViewsFor } from './resolve.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../session/views/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,GAGlB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,eAAe,EAA+C,MAAM,cAAc,CAAA"}

package/dist/session/views/resolve.d.ts

@@ -0,0 +1,13 @@
+import type { PathLike } from '@astrale-os/kernel-core/path';
+import type { Input } from '@astrale-os/kernel-ports/functions';
+import type { Call } from '../../client/index.js';
+import type { SessionOperation } from '../context/index.js';
+import type { ViewCatalog } from './catalog.js';
+export type ViewInvoker = (call: Call, operation: SessionOperation) => Promise<Input>;
+export type ViewCatalogAdmission = (input: unknown) => ViewCatalog;
+/**
+ * Invoke Runtime-owned target View resolution through the canonical source Kernel call, then admit
+ * its heterogeneous installed-Publication projection.
+ */
+export declare function resolveViewsFor(invoke: ViewInvoker, admitCatalog: ViewCatalogAdmission, target: PathLike, operation: SessionOperation): Promise<ViewCatalog>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/session/views/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../session/views/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oCAAoC,CAAA;AAK/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAI/C,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;AACrF,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,WAAW,CAAA;AAElE;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,oBAAoB,EAClC,MAAM,EAAE,QAAQ,EAChB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAGtB"}

package/dist/session/views/resolve.js

@@ -0,0 +1,12 @@
+import { Path } from '@astrale-os/kernel-core/path';
+import { K } from '@astrale-os/kernel-core/schema';
+import { call } from '../../client/index.js';
+/**
+ * Invoke Runtime-owned target View resolution through the canonical source Kernel call, then admit
+ * its heterogeneous installed-Publication projection.
+ */
+export async function resolveViewsFor(invoke, admitCatalog, target, operation) {
+    const path = Path.from(target).raw;
+    return admitCatalog(await invoke(call(K.View.resolve.path, { target: path }), operation));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/session/views/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../session/views/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,gCAAgC,CAAA;AAMlD,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAK5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAmB,EACnB,YAAkC,EAClC,MAAgB,EAChB,SAA2B;IAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAA;IAClC,OAAO,YAAY,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;AAC3F,CAAC"}

package/dist/store/entity-index.d.ts

@@ -0,0 +1,23 @@
+import type { Edge, EdgeKey } from '@astrale-os/kernel-core/graph/edge';
+import type { Node, NodeId } from '@astrale-os/kernel-core/graph/node';
+import type { QueryResult } from '@astrale-os/kernel-core/graph/query';
+export interface FactReferences {
+    readonly nodes: readonly NodeId[];
+    readonly edges: readonly string[];
+}
+export interface Integration {
+    readonly references: FactReferences;
+    readonly changedNodes: ReadonlySet<NodeId>;
+    readonly changedEdges: ReadonlySet<string>;
+}
+export declare class EntityIndex {
+    private readonly nodes;
+    private readonly edges;
+    integrate(result: QueryResult): Integration;
+    node(id: NodeId): Node | undefined;
+    edge(key: string): Edge | undefined;
+    sweep(reachableNodes: ReadonlySet<NodeId>, reachableEdges: ReadonlySet<string>): void;
+    clear(): void;
+}
+export declare function edgeIdentity(key: EdgeKey): string;
+//# sourceMappingURL=entity-index.d.ts.map

package/dist/store/entity-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-index.d.ts","sourceRoot":"","sources":["../../store/entity-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAA;AACvE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AAItE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAA;IACnC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC3C;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAEhD,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAsD1C;IAED,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEjC;IAED,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAElC;IAED,KAAK,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAGpF;IAED,KAAK,IAAI,IAAI,CAGZ;CACF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEjD"}