@astrale-os/sdk 0.4.18 → 0.5.0-beta.1

package/README.md

@@ -1,9 +1,11 @@
 # SDK
 
-Astrale Remote Domain SDK — define and deploy domains as standalone Hono servers.
+Schema-first SDK for defining, composing, and deploying Astrale Domains. The public authoring
+surface covers Domain handlers, provider-neutral Capabilities, Workflows, Query, Mutation, State,
+and deployment adapters without coupling business code to one host runtime.
 
 [![CI](https://github.com/astrale-os/sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/astrale-os/sdk/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 
 ## Install
 
@@ -15,8 +17,8 @@ npm install @astrale-os/sdk
 
 ### Prerequisites
 
-- Node.js 22+
-- pnpm 10+
+- Node.js 24.18.0
+- pnpm 11.13.1
 
 ### Setup
 
@@ -39,4 +41,4 @@ pnpm format         # Format
 
 ## License
 
-MIT License — see [LICENSE](LICENSE) for details.
+Apache License 2.0 — see [LICENSE](LICENSE) for details.

package/dist/auth/index.d.ts

@@ -1,16 +1,4 @@
-export type { RemoteIdentityConfig } from './identity.js';
-export type { VerifiedInbound } from './verify.js';
-export type { AuthenticateResult } from './authenticate.js';
-export { authenticateRequest } from './authenticate.js';
-export { resolveInboundAuth, buildAuthContext, type ResolvedAuth } from './resolve.js';
-export { verifyInboundCredential } from './verify.js';
-export { buildComposedGrant } from './compose.js';
-export { signCredential } from './sign.js';
-export { makeDomainAuthority } from './issuer-mint.js';
-export type { DomainAuthority, MintIssuedParams } from './issuer-mint.js';
-export { makeFunctionContext } from './function-context.js';
-export type { FunctionContextApi, FunctionCredentialOptions, FunctionKernelOptions, } from './function-context.js';
-export { bindKernel } from './kernel-client.js';
-export { AuthMissingError, AuthInvalidError } from './errors.js';
-export { assertPerm, requireOwnership, READ, EDIT, USE, SHARE, ALL } from './check.js';
+/** Authentication values and the caller-bound observation API used by Domain authors. */
+export * from '@astrale-os/kernel-core/auth';
+export type { AuthApi } from '@astrale-os/kernel-client/auth';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,cAAc,8BAA8B,CAAA;AAC5C,YAAY,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/auth/index.js

@@ -1,11 +1,3 @@
-export { authenticateRequest } from './authenticate.js';
-export { resolveInboundAuth, buildAuthContext } from './resolve.js';
-export { verifyInboundCredential } from './verify.js';
-export { buildComposedGrant } from './compose.js';
-export { signCredential } from './sign.js';
-export { makeDomainAuthority } from './issuer-mint.js';
-export { makeFunctionContext } from './function-context.js';
-export { bindKernel } from './kernel-client.js';
-export { AuthMissingError, AuthInvalidError } from './errors.js';
-export { assertPerm, requireOwnership, READ, EDIT, USE, SHARE, ALL } from './check.js';
+/** Authentication values and the caller-bound observation API used by Domain authors. */
+export * from '@astrale-os/kernel-core/auth';
 //# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAqB,MAAM,cAAc,CAAA;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAM3D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,cAAc,8BAA8B,CAAA"}

package/dist/capability/client.d.ts

@@ -0,0 +1,25 @@
+import type { CapabilityClients, CapabilityProviders, CapabilityReplayDecision, CapabilityRequirements } from './contract.js';
+export interface CapabilityCallCoordinates {
+    readonly callId: string;
+    readonly signal: AbortSignal;
+    readonly deadline: number;
+}
+export interface CapabilityAttempt<Output> {
+    readonly capability: string;
+    readonly operation: string;
+    readonly replay: CapabilityReplayDecision;
+    attempt(coordinates: CapabilityCallCoordinates): Promise<Output>;
+}
+export interface CapabilityInvocationOwner {
+    invoke<Output>(call: CapabilityAttempt<Output>): Promise<Output>;
+}
+export interface CapabilityClientFactory<Requirements extends CapabilityRequirements> {
+    (owner: CapabilityInvocationOwner): CapabilityClients<Requirements>;
+}
+/** SDK-internal admission and immutable capture of one exact requirement map. */
+export declare function captureCapabilityRequirements<Requirements extends CapabilityRequirements>(requirements: Requirements): Requirements;
+/** SDK-internal validation of exact providers before request handling begins. */
+export declare function bindCapabilityProviders<Requirements extends CapabilityRequirements>(requirements: Requirements, providers: CapabilityProviders<Requirements>): CapabilityClientFactory<Requirements>;
+/** SDK-internal construction of invocation-scoped clients from exact provider bindings. */
+export declare function createCapabilityClients<Requirements extends CapabilityRequirements>(requirements: Requirements, providers: CapabilityProviders<Requirements>, owner: CapabilityInvocationOwner): CapabilityClients<Requirements>;
+//# sourceMappingURL=client.d.ts.map

package/dist/capability/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/capability/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAEjB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,eAAe,CAAA;AAItB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB,CAAC,MAAM;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;IACzC,OAAO,CAAC,WAAW,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,uBAAuB,CAAC,YAAY,SAAS,sBAAsB;IAClF,CAAC,KAAK,EAAE,yBAAyB,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAA;CACpE;AAED,iFAAiF;AACjF,wBAAgB,6BAA6B,CAAC,YAAY,SAAS,sBAAsB,EACvF,YAAY,EAAE,YAAY,GACzB,YAAY,CAYd;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,YAAY,SAAS,sBAAsB,EACjF,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,mBAAmB,CAAC,YAAY,CAAC,GAC3C,uBAAuB,CAAC,YAAY,CAAC,CAkBvC;AAED,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,YAAY,SAAS,sBAAsB,EACjF,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAC5C,KAAK,EAAE,yBAAyB,GAC/B,iBAAiB,CAAC,YAAY,CAAC,CAEjC"}

package/dist/capability/client.js

@@ -0,0 +1,147 @@
+import { requireCapabilityDefinition, requireProviderBinding, resolveReplay } from './define.js';
+/** SDK-internal admission and immutable capture of one exact requirement map. */
+export function captureCapabilityRequirements(requirements) {
+    const source = acceptMap(requirements, 'Capability requirements');
+    const names = ownStringKeys(source, 'Capability requirements');
+    const captured = Object.create(null);
+    for (const name of names) {
+        captured[name] = requireCapabilityDefinition(ownDataValue(source, name, 'Capability requirements'));
+    }
+    return Object.freeze(captured);
+}
+/** SDK-internal validation of exact providers before request handling begins. */
+export function bindCapabilityProviders(requirements, providers) {
+    const required = captureCapabilityRequirements(requirements);
+    const supplied = acceptMap(providers, 'Capability providers');
+    const names = ownStringKeys(required, 'Capability requirements');
+    exactKeys(supplied, names, 'Capability providers');
+    const bindings = names.map((name) => {
+        const definition = requireCapabilityDefinition(ownDataValue(required, name, 'Capability requirements'));
+        const binding = requireProviderBinding(ownDataValue(supplied, name, 'Capability providers'));
+        if (binding.capability !== definition) {
+            throw new TypeError(`Capability provider ${name} implements a different definition.`);
+        }
+        return Object.freeze({ name, definition, binding });
+    });
+    return (owner) => createBoundCapabilityClients(bindings, owner);
+}
+/** SDK-internal construction of invocation-scoped clients from exact provider bindings. */
+export function createCapabilityClients(requirements, providers, owner) {
+    return bindCapabilityProviders(requirements, providers)(owner);
+}
+function createBoundCapabilityClients(bindings, owner) {
+    if (owner === null ||
+        typeof owner !== 'object' ||
+        Array.isArray(owner) ||
+        typeof ownDataValue(owner, 'invoke', 'Capability invocation owner') !== 'function') {
+        throw new TypeError('Capability invocation owner is invalid.');
+    }
+    const invoke = ownDataValue(owner, 'invoke', 'Capability invocation owner').bind(owner);
+    const clients = Object.create(null);
+    for (const { name, definition, binding } of bindings) {
+        const operations = Object.create(null);
+        for (const operationName of Object.keys(definition.operations)) {
+            const operation = definition.operations[operationName];
+            const implementation = binding.implementation[operationName];
+            operations[operationName] = async (...input) => {
+                if (input.length > 1) {
+                    throw new TypeError('Capability operations accept at most one semantic input value.');
+                }
+                const value = input[0];
+                const replay = resolveReplay(operation, value);
+                let attempts = 0;
+                let callId;
+                let active = true;
+                try {
+                    return await invoke({
+                        capability: definition.id,
+                        operation: operationName,
+                        replay,
+                        async attempt(coordinates) {
+                            if (!active) {
+                                throw new TypeError('Settled Capability operation cannot be attempted again.');
+                            }
+                            if (replay.kind === 'unsafe' && attempts > 0) {
+                                throw new TypeError('Unsafe Capability operation cannot be attempted again.');
+                            }
+                            const accepted = acceptCoordinates(coordinates);
+                            attempts += 1;
+                            if (callId === undefined)
+                                callId = accepted.callId;
+                            else if (accepted.callId !== callId) {
+                                throw new TypeError('Capability replay must retain the logical call id.');
+                            }
+                            const execution = executionFor(accepted, replay);
+                            return input.length === 0
+                                ? Reflect.apply(implementation, undefined, [execution])
+                                : Reflect.apply(implementation, undefined, [value, execution]);
+                        },
+                    });
+                }
+                finally {
+                    active = false;
+                }
+            };
+        }
+        clients[name] = Object.freeze(operations);
+    }
+    return Object.freeze(clients);
+}
+function executionFor(coordinates, replay) {
+    const idempotencyKey = replay.kind !== 'keyed'
+        ? undefined
+        : replay.source === 'execution'
+            ? coordinates.callId
+            : replay.key;
+    return Object.freeze({
+        callId: coordinates.callId,
+        signal: coordinates.signal,
+        deadline: coordinates.deadline,
+        ...(idempotencyKey === undefined ? {} : { idempotencyKey }),
+    });
+}
+function acceptCoordinates(input) {
+    const coordinates = acceptMap(input, 'Capability call coordinates');
+    exactKeys(coordinates, ['callId', 'signal', 'deadline'], 'Capability call coordinates');
+    const callId = ownDataValue(coordinates, 'callId', 'Capability call coordinates');
+    const signal = ownDataValue(coordinates, 'signal', 'Capability call coordinates');
+    const deadline = ownDataValue(coordinates, 'deadline', 'Capability call coordinates');
+    if (typeof callId !== 'string' || callId.length === 0 || callId.trim() !== callId) {
+        throw new TypeError('Capability call id must be a non-empty stable string.');
+    }
+    if (!(signal instanceof AbortSignal)) {
+        throw new TypeError('Capability call signal must be an AbortSignal.');
+    }
+    if (typeof deadline !== 'number' || !Number.isFinite(deadline)) {
+        throw new TypeError('Capability call deadline must be a finite number.');
+    }
+    return { callId, signal, deadline };
+}
+function acceptMap(input, label) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new TypeError(`${label} must be an object.`);
+    }
+    return input;
+}
+function exactKeys(input, expected, label) {
+    const actual = ownStringKeys(input, label);
+    const expectedSet = new Set(expected);
+    if (actual.length === expected.length && actual.every((key) => expectedSet.has(key)))
+        return;
+    throw new TypeError(`${label} must contain exactly: ${expected.join(', ') || '(none)'}.`);
+}
+function ownStringKeys(input, label) {
+    const keys = Reflect.ownKeys(input);
+    if (keys.some((key) => typeof key !== 'string')) {
+        throw new TypeError(`${label} cannot contain symbol fields.`);
+    }
+    return keys;
+}
+function ownDataValue(input, key, label) {
+    const descriptor = Object.getOwnPropertyDescriptor(input, key);
+    if (descriptor === undefined || !Object.hasOwn(descriptor, 'value')) {
+        throw new TypeError(`${label}.${key} must be a data field.`);
+    }
+    return descriptor.value;
+}
+//# sourceMappingURL=client.js.map

package/dist/capability/client.js.map

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

package/dist/capability/contract.d.ts

@@ -0,0 +1,70 @@
+declare const capabilityDefinition: unique symbol;
+declare const capabilityOperation: unique symbol;
+declare const capabilityProvider: unique symbol;
+export type CapabilityReplayDecision = {
+    readonly kind: 'safe';
+} | {
+    readonly kind: 'keyed';
+    readonly source: 'execution';
+} | {
+    readonly kind: 'keyed';
+    readonly source: 'input';
+    readonly key: string;
+} | {
+    readonly kind: 'unsafe';
+};
+export type CapabilityReplay<Input> = CapabilityReplayDecision | ((input: Input) => CapabilityReplayDecision);
+export interface CapabilityExecution {
+    readonly callId: string;
+    readonly signal: AbortSignal;
+    readonly deadline: number;
+    readonly idempotencyKey?: string;
+}
+export interface CapabilityOperation<Input = unknown, Output = unknown> {
+    readonly replay: CapabilityReplay<Input>;
+    readonly [capabilityOperation]: Readonly<{
+        input: Input;
+        output: Output;
+    }>;
+}
+export type CapabilityOperations = Readonly<Record<string, CapabilityOperation<any, any>>>;
+export interface CapabilityDefinition<Id extends string = string, Operations extends CapabilityOperations = CapabilityOperations> {
+    readonly kind: 'capability';
+    readonly id: Id;
+    readonly operations: Operations;
+    readonly [capabilityDefinition]: Readonly<{
+        id: Id;
+        operations: Operations;
+    }>;
+}
+export type CapabilityInput<Operation> = Operation extends CapabilityOperation<infer Input, any> ? Input : never;
+export type CapabilityOutput<Operation> = Operation extends CapabilityOperation<any, infer Output> ? Output : never;
+export type CapabilityClient<Definition extends CapabilityDefinition<any, any>> = Readonly<{
+    [Name in keyof Definition['operations']]: Definition['operations'][Name] extends CapabilityOperation<infer Input, infer Output> ? [Input] extends [void] ? () => Promise<Output> : (input: Input) => Promise<Output> : never;
+}>;
+export type CapabilityImplementation<Definition extends CapabilityDefinition<any, any>> = Readonly<{
+    [Name in keyof Definition['operations']]: Definition['operations'][Name] extends CapabilityOperation<infer Input, infer Output> ? [Input] extends [void] ? (execution: CapabilityExecution) => Promise<Output> : (input: Input, execution: CapabilityExecution) => Promise<Output> : never;
+}>;
+export interface CapabilityProvider<Definition extends CapabilityDefinition<any, any>> {
+    readonly capability: Definition;
+    readonly [capabilityProvider]: Definition;
+}
+export type CapabilityRequirements = Readonly<Record<string, CapabilityDefinition<any, any>>>;
+export type CapabilityClients<Requirements extends CapabilityRequirements> = Readonly<{
+    [Name in keyof Requirements]: CapabilityClient<Requirements[Name]>;
+}>;
+export type CapabilityProviders<Requirements extends CapabilityRequirements> = Readonly<{
+    [Name in keyof Requirements]: CapabilityProvider<Requirements[Name]>;
+}>;
+export interface DefineCapability {
+    <Id extends string, Operations extends CapabilityOperations>(input: Readonly<{
+        id: Id;
+        operations: Operations;
+    }>): CapabilityDefinition<Id, Operations>;
+    operation<Input = void, Output = void>(input: Readonly<{
+        replay: CapabilityReplay<Input>;
+    }>): CapabilityOperation<Input, Output>;
+    implement<Definition extends CapabilityDefinition>(definition: Definition, implementation: CapabilityImplementation<Definition>): CapabilityProvider<Definition>;
+}
+export {};
+//# sourceMappingURL=contract.d.ts.map

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

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

package/dist/capability/contract.js

@@ -0,0 +1,3 @@
+/* oxlint-disable typescript/no-explicit-any -- exact heterogeneous operation inference requires an erased constraint */
+export {};
+//# sourceMappingURL=contract.js.map

package/dist/capability/contract.js.map

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

package/dist/capability/define.d.ts

@@ -0,0 +1,14 @@
+import type { CapabilityDefinition, CapabilityOperation, CapabilityOperations, CapabilityReplayDecision, DefineCapability } from './contract.js';
+type RuntimeOperation = CapabilityOperation<unknown, unknown>;
+type RuntimeDefinition = CapabilityDefinition<string, CapabilityOperations>;
+type RuntimeImplementation = Readonly<Record<string, (...input: readonly unknown[]) => unknown>>;
+export interface ProviderBinding {
+    readonly capability: RuntimeDefinition;
+    readonly implementation: RuntimeImplementation;
+}
+export declare const defineCapability: DefineCapability;
+export declare function requireCapabilityDefinition(input: unknown): RuntimeDefinition;
+export declare function requireProviderBinding(input: unknown): ProviderBinding;
+export declare function resolveReplay(operation: RuntimeOperation, input: unknown): CapabilityReplayDecision;
+export {};
+//# sourceMappingURL=define.d.ts.map

package/dist/capability/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/capability/define.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EAEpB,mBAAmB,EACnB,oBAAoB,EAGpB,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,eAAe,CAAA;AAEtB,KAAK,gBAAgB,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC7D,KAAK,iBAAiB,GAAG,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;AAC3E,KAAK,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,EAAE,SAAS,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAA;AAEhG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACtC,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAA;CAC/C;AA0FD,eAAO,MAAM,gBAAgB,EAKxB,gBAAgB,CAAA;AAErB,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAK7E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAKtE;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,OAAO,GACb,wBAAwB,CAM1B"}

package/dist/capability/define.js

@@ -0,0 +1,145 @@
+/* oxlint-disable typescript/no-explicit-any -- implementation must exactly realize the public heterogeneous contract */
+const operations = new WeakSet();
+const definitions = new WeakSet();
+const providers = new WeakMap();
+function capability(input) {
+    const definition = acceptRecord(input, 'Capability definition');
+    exactKeys(definition, ['id', 'operations'], 'Capability definition');
+    const id = ownDataValue(definition, 'id', 'Capability definition');
+    acceptStableText(id, 'Capability id');
+    const authoredOperations = acceptRecord(ownDataValue(definition, 'operations', 'Capability definition'), 'Capability operations');
+    const names = ownStringKeys(authoredOperations, 'Capability operations');
+    if (names.length === 0)
+        throw new TypeError('Capability must declare at least one operation.');
+    const retained = Object.create(null);
+    for (const name of names) {
+        acceptStableText(name, 'Capability operation name');
+        const authored = ownDataValue(authoredOperations, name, 'Capability operations');
+        if (!isObject(authored) || !operations.has(authored)) {
+            throw new TypeError(`Capability operation ${name} must be created by defineCapability.operation.`);
+        }
+        retained[name] = authored;
+    }
+    const result = Object.freeze({
+        kind: 'capability',
+        id,
+        operations: Object.freeze(retained),
+    });
+    definitions.add(result);
+    return result;
+}
+function operation(input) {
+    const descriptor = acceptRecord(input, 'Capability operation');
+    exactKeys(descriptor, ['replay'], 'Capability operation');
+    const authoredReplay = ownDataValue(descriptor, 'replay', 'Capability operation');
+    const replay = typeof authoredReplay === 'function'
+        ? authoredReplay
+        : acceptReplayDecision(authoredReplay);
+    const result = Object.freeze({ replay });
+    operations.add(result);
+    return result;
+}
+function implement(definition, implementation) {
+    if (!isObject(definition) || !definitions.has(definition)) {
+        throw new TypeError('Capability provider requires a definition created by defineCapability.');
+    }
+    const source = acceptRecord(implementation, 'Capability implementation');
+    const names = Object.keys(definition.operations);
+    exactKeys(source, names, 'Capability implementation');
+    const retained = Object.create(null);
+    for (const name of names) {
+        const candidate = ownDataValue(source, name, 'Capability implementation');
+        if (typeof candidate !== 'function') {
+            throw new TypeError(`Capability implementation ${name} must be a function.`);
+        }
+        retained[name] = candidate;
+    }
+    const provider = Object.freeze({ capability: definition });
+    providers.set(provider, Object.freeze({
+        capability: definition,
+        implementation: Object.freeze(retained),
+    }));
+    return provider;
+}
+export const defineCapability = Object.assign((input) => capability(input), { operation, implement });
+export function requireCapabilityDefinition(input) {
+    if (!isObject(input) || !definitions.has(input)) {
+        throw new TypeError('Capability requirement must be created by defineCapability.');
+    }
+    return input;
+}
+export function requireProviderBinding(input) {
+    if (!isObject(input))
+        throw new TypeError('Capability provider is invalid.');
+    const binding = providers.get(input);
+    if (binding === undefined)
+        throw new TypeError('Capability provider is invalid.');
+    return binding;
+}
+export function resolveReplay(operation, input) {
+    const authored = typeof operation.replay === 'function'
+        ? Reflect.apply(operation.replay, undefined, [input])
+        : operation.replay;
+    return acceptReplayDecision(authored);
+}
+function acceptReplayDecision(input) {
+    const decision = acceptRecord(input, 'Capability replay decision');
+    const kind = decision.kind;
+    if (kind === 'safe' || kind === 'unsafe') {
+        exactKeys(decision, ['kind'], 'Capability replay decision');
+        return Object.freeze({ kind });
+    }
+    if (kind !== 'keyed') {
+        throw new TypeError('Capability replay kind must be safe, keyed, or unsafe.');
+    }
+    if (decision.source === 'execution') {
+        exactKeys(decision, ['kind', 'source'], 'Capability replay decision');
+        return Object.freeze({ kind, source: 'execution' });
+    }
+    if (decision.source === 'input') {
+        exactKeys(decision, ['kind', 'source', 'key'], 'Capability replay decision');
+        acceptNonEmptyText(decision.key, 'Capability replay input key');
+        return Object.freeze({ kind, source: 'input', key: decision.key });
+    }
+    throw new TypeError('Keyed Capability replay source must be execution or input.');
+}
+function acceptRecord(input, label) {
+    if (!isObject(input) || Array.isArray(input))
+        throw new TypeError(`${label} must be an object.`);
+    return input;
+}
+function exactKeys(input, expected, label) {
+    const actual = ownStringKeys(input, label);
+    const expectedSet = new Set(expected);
+    if (actual.length === expected.length && actual.every((key) => expectedSet.has(key)))
+        return;
+    throw new TypeError(`${label} must contain exactly: ${expected.join(', ') || '(none)'}.`);
+}
+function ownStringKeys(input, label) {
+    const keys = Reflect.ownKeys(input);
+    if (keys.some((key) => typeof key !== 'string')) {
+        throw new TypeError(`${label} cannot contain symbol fields.`);
+    }
+    return keys;
+}
+function ownDataValue(input, key, label) {
+    const descriptor = Object.getOwnPropertyDescriptor(input, key);
+    if (descriptor === undefined || !Object.hasOwn(descriptor, 'value')) {
+        throw new TypeError(`${label}.${key} must be a data field.`);
+    }
+    return descriptor.value;
+}
+function acceptStableText(input, label) {
+    if (typeof input !== 'string' || input.length === 0 || input.trim() !== input) {
+        throw new TypeError(`${label} must be a non-empty stable string.`);
+    }
+}
+function acceptNonEmptyText(input, label) {
+    if (typeof input !== 'string' || input.trim().length === 0) {
+        throw new TypeError(`${label} must be a non-empty string.`);
+    }
+}
+function isObject(input) {
+    return input !== null && typeof input === 'object';
+}
+//# sourceMappingURL=define.js.map

package/dist/capability/define.js.map

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

package/dist/capability/index.d.ts

@@ -0,0 +1,3 @@
+export { defineCapability } from './define.js';
+export type { CapabilityClient, CapabilityClients, CapabilityDefinition, CapabilityExecution, CapabilityImplementation, CapabilityInput, CapabilityOperation, CapabilityOperations, CapabilityOutput, CapabilityProvider, CapabilityProviders, CapabilityReplay, CapabilityReplayDecision, CapabilityRequirements, DefineCapability, } from './contract.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,eAAe,CAAA"}

package/dist/capability/index.js

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

package/dist/capability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/cli/arguments.d.ts

@@ -0,0 +1,21 @@
+import type { LintReportFormat } from '../linter/index.js';
+export interface ParsedArgs {
+    readonly command: 'dev' | 'build' | 'deploy' | 'publish' | 'lint';
+    readonly env: string;
+    readonly watch: boolean;
+    readonly fix?: boolean;
+    readonly format?: LintReportFormat;
+    readonly dryRun?: boolean;
+    readonly schemaOnly?: boolean;
+    readonly otp?: string;
+    readonly skipSchema?: boolean;
+    readonly port?: number;
+    readonly host?: string;
+    readonly publish?: boolean;
+    readonly name?: string;
+    readonly installByDefault?: boolean;
+    readonly publicUrl?: string;
+}
+/** Parse the frozen `astrale-domain` command grammar without performing effects. */
+export declare function parseArgs(argv: readonly string[]): ParsedArgs;
+//# sourceMappingURL=arguments.d.ts.map

package/dist/cli/arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.d.ts","sourceRoot":"","sources":["../../src/cli/arguments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAqL7D"}