@astrale-os/sdk 0.5.0-beta.13 → 0.5.0-beta.131

package/dist/index.d.ts

@@ -1,23 +1,21 @@
-/** Worker-safe schema-first SDK authoring surface. */
-export { defineDomain, implement } from './domain/index.js';
-export type { AnonymousCaller, AuthenticatedCaller, CapabilityProviderFactory, Caller, DefineDomainInput, DepsFactory, DomainApp, DomainDefinition, DomainEnvironment, DomainHandle, DomainHandlers, HandlerDependencies, HandlerOf, Kernel, Receiver, HandlerImplementation, PublicDomainDefinition, RuntimeDomainHandlers, } from './domain/index.js';
-export { defineCapability } from './capability/index.js';
-export type { CapabilityClient, CapabilityClients, CapabilityDefinition, CapabilityExecution, CapabilityImplementation, CapabilityInput, CapabilityOperation, CapabilityOperations, CapabilityOutput, CapabilityProvider, CapabilityProviders, CapabilityReplay, CapabilityReplayDecision, CapabilityRequirements, DefineCapability, } from './capability/index.js';
-export { defineAdapter, deploy } from './deployment/provider/index.js';
-export type { AdapterSpec, BuildCtx, DeployConfig, DeployCtx, DeployResult, DomainAdapter, WatchCtx, WatchHandle, } from './deployment/provider/index.js';
-export { defineQuery, QueryPaginationError } from './query/index.js';
-export type { CompositeQueryDefinition, PaginatedQueryDefinition, QueryDefinition, QueryBindingOptions, QueryExecutor, QueryFailure, QueryInputOf, QueryOutputOf, QueryPages, QueryPagination, QueryPaginationErrorCode, SingleQueryDefinition, } from './query/index.js';
-export { defineMutation } from './mutation/index.js';
-export type { MutationDefinition, MutationExecutor, MutationFailure } from './mutation/index.js';
-export { defineStateMachine } from './state/index.js';
-export type { StateMachine, TransitionMap } from './state/index.js';
-export { compileFrontend, compileFrontendRoutes, externalFrontend, frontendArtifact, frontendManifest, frontendViewBindings, viteFrontend, } from './view/index.js';
-export type { CompiledFrontendArtifact, CompiledFrontendRoute, ExternalFrontendSource, FrontendArtifact, FrontendArtifactInput, FrontendHandshake, FrontendFile, FrontendProvenance, FrontendPublication, FrontendRoute, FrontendRouteInput, FrontendRouteOverrides, FrontendRoutes, FrontendSource, ViewNames, ViteFrontendSource, } from './view/index.js';
-export { bindWorkflow, defineWorkflow, withTriggers } from './workflow/index.js';
-export type { ScheduleTrigger, WorkflowBinding, WorkflowContext, WorkflowDefinition, WorkflowRunner, WorkflowStep, WorkflowTriggers, } from './workflow/index.js';
-export { err, ok } from './result/index.js';
-export type { Result } from './result/index.js';
-export type { Deployment, HttpRouteDeclaration } from './deployment/index.js';
-export { InvocationError } from './invocation/index.js';
-export type { InvocationErrorCode, InvocationErrorOptions } from './invocation/index.js';
-//# sourceMappingURL=index.d.ts.map
+/** Curated SDK authoring journey. Semantic values remain available from focused subpaths. */
+export { defineAction } from './application/action/index.js';
+export type { Action, ActionContext, ActionOutputOf, Caller, DeclaredErrorDefinition, DeclaredErrorFactory, DeclaredErrorFamily, DeclaredErrorOptions, DeclaredErrors, } from './application/action/index.js';
+export { defineApplication, defineFrontend, external, requirements, route, routes, vite, } from './application/index.js';
+export type { Application, Frontend, Requirements, Route, Routes } from './application/index.js';
+export { defineIntegration, defineProvider } from './application/integration/index.js';
+export type { IntegrationClient, IntegrationDefinition, Provider, } from './application/integration/index.js';
+export { defineMutation, executeMutation } from './application/mutation/index.js';
+export type { Mutation, MutationFailure } from './application/mutation/index.js';
+export { defineCollectionQuery, defineCompositeQuery, defineQuery, executeQuery, } from './application/query/index.js';
+export type { CollectionQueryDefinition, QueryDefinition, QueryFailure, } from './application/query/index.js';
+export { defineRuntime } from './application/runtime/index.js';
+export type { Runtime } from './application/runtime/index.js';
+export { defineWorkflow } from './application/workflow/index.js';
+export type { Workflow, WorkflowContext } from './application/workflow/index.js';
+export { compile, deploy, runtime } from './deployment/index.js';
+export type { Build, Deployment, Release } from './deployment/index.js';
+export { defineProject } from './project/index.js';
+export type { Project } from './project/index.js';
+export { serve } from './execution/index.js';
+export type { ServedApplication } from './execution/index.js';

package/dist/index.js

@@ -1,12 +1,11 @@
-/** Worker-safe schema-first SDK authoring surface. */
-export { defineDomain, implement } from './domain/index.js';
-export { defineCapability } from './capability/index.js';
-export { defineAdapter, deploy } from './deployment/provider/index.js';
-export { defineQuery, QueryPaginationError } from './query/index.js';
-export { defineMutation } from './mutation/index.js';
-export { defineStateMachine } from './state/index.js';
-export { compileFrontend, compileFrontendRoutes, externalFrontend, frontendArtifact, frontendManifest, frontendViewBindings, viteFrontend, } from './view/index.js';
-export { bindWorkflow, defineWorkflow, withTriggers } from './workflow/index.js';
-export { err, ok } from './result/index.js';
-export { InvocationError } from './invocation/index.js';
-//# sourceMappingURL=index.js.map
+/** Curated SDK authoring journey. Semantic values remain available from focused subpaths. */
+export { defineAction } from './application/action/index.js';
+export { defineApplication, defineFrontend, external, requirements, route, routes, vite, } from './application/index.js';
+export { defineIntegration, defineProvider } from './application/integration/index.js';
+export { defineMutation, executeMutation } from './application/mutation/index.js';
+export { defineCollectionQuery, defineCompositeQuery, defineQuery, executeQuery, } from './application/query/index.js';
+export { defineRuntime } from './application/runtime/index.js';
+export { defineWorkflow } from './application/workflow/index.js';
+export { compile, deploy, runtime } from './deployment/index.js';
+export { defineProject } from './project/index.js';
+export { serve } from './execution/index.js';

package/dist/platform/auth/exchange/configuration.d.ts

@@ -0,0 +1,3 @@
+/** Canonical issuer discovery paths and admitted exchange configuration. */
+export { acceptConfiguration, type Configuration, } from '@astrale-os/kernel-protocol/issuer/configuration';
+export { paths } from '@astrale-os/kernel-protocol/issuer/paths';

package/dist/platform/auth/exchange/configuration.js

@@ -0,0 +1,3 @@
+/** Canonical issuer discovery paths and admitted exchange configuration. */
+export { acceptConfiguration, } from '@astrale-os/kernel-protocol/issuer/configuration';
+export { paths } from '@astrale-os/kernel-protocol/issuer/paths';

package/dist/platform/auth/exchange/index.d.ts

@@ -0,0 +1,2 @@
+export * from './configuration.js';
+export * from './response.js';

package/dist/platform/auth/exchange/index.js

@@ -0,0 +1,2 @@
+export * from './configuration.js';
+export * from './response.js';

package/dist/platform/auth/exchange/response.d.ts

@@ -0,0 +1,2 @@
+/** Canonical token-exchange media type and admitted response values. */
+export { acceptErrorResponse, acceptResponse, MEDIA_TYPE, type ErrorResponse, type Response, } from '@astrale-os/kernel-protocol/issuer/exchange';

package/dist/platform/auth/exchange/response.js

@@ -0,0 +1,2 @@
+/** Canonical token-exchange media type and admitted response values. */
+export { acceptErrorResponse, acceptResponse, MEDIA_TYPE, } from '@astrale-os/kernel-protocol/issuer/exchange';

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

@@ -0,0 +1,4 @@
+/** Canonical authentication and authority values. */
+export * from '@astrale-os/kernel-core/auth';
+export { createAuth, type AuthApi, type PolicyDecisionInput, type RegisterRequest, type RegisterIdentity, } from '@astrale-os/kernel-client/auth';
+export * as exchange from './exchange/index.js';

package/dist/platform/auth/index.js

@@ -0,0 +1,4 @@
+/** Canonical authentication and authority values. */
+export * from '@astrale-os/kernel-core/auth';
+export { createAuth, } from '@astrale-os/kernel-client/auth';
+export * as exchange from './exchange/index.js';

package/dist/platform/client/index.d.ts

@@ -0,0 +1,5 @@
+/** Canonical transport, invocation, and caller-owned Client lifecycle. */
+export * from '@astrale-os/kernel-client';
+export type { BoundEdge, BoundGraphValue, BoundNode, BoundNodeFor, DomainBinding, GraphApi, GraphMutationOptions, } from '@astrale-os/kernel-client/graph';
+export { createGraph, NodeUnavailableError, QueryAST, type QueryPageRequest, } from '@astrale-os/kernel-client/graph';
+export * as session from './session/index.js';

package/dist/platform/client/index.js

@@ -0,0 +1,4 @@
+/** Canonical transport, invocation, and caller-owned Client lifecycle. */
+export * from '@astrale-os/kernel-client';
+export { createGraph, NodeUnavailableError, QueryAST, } from '@astrale-os/kernel-client/graph';
+export * as session from './session/index.js';

package/dist/platform/client/schema/index.d.ts

@@ -0,0 +1,2 @@
+/** Canonical installed-Schema Client observations and lifecycle values. */
+export * from '@astrale-os/kernel-client/schema';

package/dist/platform/client/schema/index.js

@@ -0,0 +1,2 @@
+/** Canonical installed-Schema Client observations and lifecycle values. */
+export * from '@astrale-os/kernel-client/schema';

package/dist/platform/client/session/index.d.ts

@@ -0,0 +1,2 @@
+/** Canonical Client Session, bound view, and typed callable-reference journey. */
+export * from '@astrale-os/kernel-client/session';

package/dist/platform/client/session/index.js

@@ -0,0 +1,2 @@
+/** Canonical Client Session, bound view, and typed callable-reference journey. */
+export * from '@astrale-os/kernel-client/session';

package/dist/platform/client/store/index.d.ts

@@ -0,0 +1,2 @@
+/** Canonical reactive graph Store lifecycle and snapshots. */
+export * from '@astrale-os/kernel-client/store';

package/dist/platform/client/store/index.js

@@ -0,0 +1,2 @@
+/** Canonical reactive graph Store lifecycle and snapshots. */
+export * from '@astrale-os/kernel-client/store';

package/dist/platform/graph/alias.d.ts

@@ -0,0 +1,6 @@
+/** Graph-local names retain the canonical Kernel type and constructor identity. */
+export { LocalBinding as LocalAlias, isLocalBinding as isLocalAlias, } from '@astrale-os/kernel-core/graph/graph';
+/** @deprecated Use LocalAlias. */
+export { LocalBinding } from '@astrale-os/kernel-core/graph/graph';
+/** @deprecated Use isLocalAlias. */
+export { isLocalBinding } from '@astrale-os/kernel-core/graph/graph';

package/dist/platform/graph/alias.js

@@ -0,0 +1,6 @@
+/** Graph-local names retain the canonical Kernel type and constructor identity. */
+export { LocalBinding as LocalAlias, isLocalBinding as isLocalAlias, } from '@astrale-os/kernel-core/graph/graph';
+/** @deprecated Use LocalAlias. */
+export { LocalBinding } from '@astrale-os/kernel-core/graph/graph';
+/** @deprecated Use isLocalAlias. */
+export { isLocalBinding } from '@astrale-os/kernel-core/graph/graph';

package/dist/platform/graph/class/index.d.ts

@@ -0,0 +1,4 @@
+/** DSL-owned Class addressing and resolved Class semantics used by graph authoring. */
+export { ClassKey } from '@astrale-os/kernel-dsl/v1/addressing';
+export type { ClassRef } from '@astrale-os/kernel-dsl/v1/addressing';
+export type { AnyResolvedClass, ResolvedClass } from '@astrale-os/kernel-dsl/v1/language';

package/dist/platform/graph/class/index.js

@@ -0,0 +1,2 @@
+/** DSL-owned Class addressing and resolved Class semantics used by graph authoring. */
+export { ClassKey } from '@astrale-os/kernel-dsl/v1/addressing';

package/dist/platform/graph/document/index.d.ts

@@ -0,0 +1,3 @@
+/** Canonical graph documents and local aliases. */
+export * from '@astrale-os/kernel-core/graph/graph';
+export { LocalAlias, isLocalAlias, LocalBinding, isLocalBinding } from '../alias.js';

package/dist/platform/graph/document/index.js

@@ -0,0 +1,3 @@
+/** Canonical graph documents and local aliases. */
+export * from '@astrale-os/kernel-core/graph/graph';
+export { LocalAlias, isLocalAlias, LocalBinding, isLocalBinding } from '../alias.js';

package/dist/platform/graph/edge/index.d.ts

@@ -0,0 +1,2 @@
+/** Canonical graph Edge identity and model values. */
+export * from '@astrale-os/kernel-core/graph/edge';

package/dist/platform/graph/edge/index.js

@@ -0,0 +1,2 @@
+/** Canonical graph Edge identity and model values. */
+export * from '@astrale-os/kernel-core/graph/edge';

package/dist/platform/graph/index.d.ts

@@ -0,0 +1,14 @@
+/** Curated aggregate over canonical graph values. */
+export { GraphData, GraphDataDecodeError, GraphSpec, GraphSpecDecodeError, } from '@astrale-os/kernel-core/graph/graph';
+export { LocalAlias, isLocalAlias, LocalBinding, isLocalBinding } from './alias.js';
+export type { AnonymousNodeSpec, GraphDataJson, GraphSpecEdge, GraphSpecEndpoint, GraphSpecJson, GraphSpecNode, } from '@astrale-os/kernel-core/graph/graph';
+export * from './edge/index.js';
+export * from './node/index.js';
+export * from './path/index.js';
+export * from './properties/index.js';
+export * as classes from './class/index.js';
+export * as documents from './document/index.js';
+export * as edges from './edge/index.js';
+export * as nodes from './node/index.js';
+export * as paths from './path/index.js';
+export * as properties from './properties/index.js';

package/dist/platform/graph/index.js

@@ -0,0 +1,13 @@
+/** Curated aggregate over canonical graph values. */
+export { GraphData, GraphDataDecodeError, GraphSpec, GraphSpecDecodeError, } from '@astrale-os/kernel-core/graph/graph';
+export { LocalAlias, isLocalAlias, LocalBinding, isLocalBinding } from './alias.js';
+export * from './edge/index.js';
+export * from './node/index.js';
+export * from './path/index.js';
+export * from './properties/index.js';
+export * as classes from './class/index.js';
+export * as documents from './document/index.js';
+export * as edges from './edge/index.js';
+export * as nodes from './node/index.js';
+export * as paths from './path/index.js';
+export * as properties from './properties/index.js';

package/dist/platform/graph/node/index.d.ts

@@ -0,0 +1,2 @@
+/** Canonical graph Node identity and model values. */
+export * from '@astrale-os/kernel-core/graph/node';

package/dist/platform/graph/node/index.js

@@ -0,0 +1,2 @@
+/** Canonical graph Node identity and model values. */
+export * from '@astrale-os/kernel-core/graph/node';

package/dist/platform/graph/path/index.d.ts

@@ -0,0 +1,2 @@
+/** Canonical NodePath language and rich Path authoring value. */
+export * from '@astrale-os/kernel-core/path';

package/dist/platform/graph/path/index.js

@@ -0,0 +1,2 @@
+/** Canonical NodePath language and rich Path authoring value. */
+export * from '@astrale-os/kernel-core/path';

package/dist/platform/graph/properties/index.d.ts

@@ -0,0 +1,2 @@
+/** Canonical graph Property values, conditions, deltas, and merge operations. */
+export * from '@astrale-os/kernel-core/graph/properties';

package/dist/platform/graph/properties/index.js

@@ -0,0 +1,2 @@
+/** Canonical graph Property values, conditions, deltas, and merge operations. */
+export * from '@astrale-os/kernel-core/graph/properties';

package/dist/platform/invocation/index.d.ts

@@ -0,0 +1,2 @@
+/** Canonical Invocation wire contract and identity admission owned by the Astrale platform. */
+export { invocation } from '@astrale-os/kernel-protocol';

package/dist/platform/invocation/index.js

@@ -0,0 +1,2 @@
+/** Canonical Invocation wire contract and identity admission owned by the Astrale platform. */
+export { invocation } from '@astrale-os/kernel-protocol';

package/dist/platform/publication/index.d.ts

@@ -0,0 +1,2 @@
+/** Canonical Publication wire contract and admission owned by the Astrale platform. */
+export { publication } from '@astrale-os/kernel-protocol';

package/dist/platform/publication/index.js

@@ -0,0 +1,2 @@
+/** Canonical Publication wire contract and admission owned by the Astrale platform. */
+export { publication } from '@astrale-os/kernel-protocol';

package/dist/platform/result/index.d.ts

@@ -0,0 +1,2 @@
+export { err, ok } from './result.js';
+export type { Result } from './result.js';

package/dist/platform/result/index.js

@@ -0,0 +1 @@
+export { err, ok } from './result.js';

package/dist/platform/result/result.d.ts

@@ -0,0 +1,10 @@
+/** Explicit success or expected failure without exception remapping. */
+export type Result<Value, Failure> = {
+    readonly ok: true;
+    readonly value: Value;
+} | {
+    readonly ok: false;
+    readonly error: Failure;
+};
+export declare function ok<const Value>(value: Value): Result<Value, never>;
+export declare function err<const Failure>(error: Failure): Result<never, Failure>;

package/dist/platform/result/result.js

@@ -0,0 +1,6 @@
+export function ok(value) {
+    return Object.freeze({ ok: true, value });
+}
+export function err(error) {
+    return Object.freeze({ ok: false, error });
+}

package/dist/platform/schema/addressing/index.d.ts

@@ -0,0 +1,3 @@
+/** Runtime-safe callable addressing without loading the Schema authoring and compiler facade. */
+export { callableAddress } from '@astrale-os/kernel-dsl/v1/addressing';
+export type { MethodAddress } from '@astrale-os/kernel-dsl/v1/addressing';

package/dist/platform/schema/addressing/index.js

@@ -0,0 +1,2 @@
+/** Runtime-safe callable addressing without loading the Schema authoring and compiler facade. */
+export { callableAddress } from '@astrale-os/kernel-dsl/v1/addressing';

package/dist/platform/schema/class-authoring.d.ts

@@ -0,0 +1,37 @@
+import { nodeClass as kernelNodeClass, type DirectedEdgeClass, type DirectedEdgeInput, type NodeClass, type NodeClassInput as KernelNodeClassInput, type UndirectedEdgeClass, type UndirectedEdgeInput } from '@astrale-os/kernel-dsl/v1/builder';
+import { type ClassIcon } from './class-icon.js';
+/** SDK Node Class input: every author must make an explicit, admitted icon choice. */
+export type NodeClassInput = Omit<KernelNodeClassInput, 'icon'> & {
+    readonly icon: ClassIcon;
+};
+/** Preserve authored input instead of serializing expanded inheritance projections in consumers. */
+export interface AuthoredNodeClass<Config extends NodeClassInput> extends ReturnType<typeof kernelNodeClass<Config>> {
+}
+type NodeInput = {
+    readonly kind: 'node';
+    readonly abstract: boolean;
+} & NodeClassInput;
+type DirectedInput = {
+    readonly kind: 'edge';
+    readonly orientation: 'directed';
+    readonly abstract: boolean;
+} & Omit<DirectedEdgeInput, 'orientation'>;
+type UndirectedInput = {
+    readonly kind: 'edge';
+    readonly orientation: 'undirected';
+    readonly abstract: boolean;
+} & Omit<UndirectedEdgeInput, 'orientation'>;
+/**
+ * Author a Node Class whose materialized configuration always carries an explicitly selected,
+ * admitted SVG icon. The mapped input retains inference while expanding package-private
+ * Config interface names into portable structure for downstream declaration emit.
+ */
+export declare function nodeClass<const Config extends NodeClassInput>(config: Config & Record<Exclude<keyof Config, keyof NodeClassInput>, never>): AuthoredNodeClass<{
+    [Key in keyof Config]: Key extends 'properties' | 'methods' | 'policies' ? {
+        [Member in keyof NonNullable<Config[Key]>]: NonNullable<Config[Key]>[Member];
+    } | Extract<Config[Key], undefined> : Key extends 'extends' ? Config[Key] extends infer Parents extends NodeClassInput['extends'] ? Parents extends readonly unknown[] ? readonly [...Parents] : Parents : never : Config[Key];
+}>;
+export declare function defineClass(config: NodeInput): NodeClass;
+export declare function defineClass(config: DirectedInput): DirectedEdgeClass;
+export declare function defineClass(config: UndirectedInput): UndirectedEdgeClass;
+export {};

package/dist/platform/schema/class-authoring.js

@@ -0,0 +1,20 @@
+import { defineClass as defineKernelClass, nodeClass as kernelNodeClass, } from '@astrale-os/kernel-dsl/v1/builder';
+import { classIcon } from './class-icon.js';
+export function nodeClass(config) {
+    if (config === undefined || config.icon === undefined) {
+        throw new TypeError('Node Class icon is required; use classIcon.neutral to make an explicit neutral choice.');
+    }
+    return kernelNodeClass({
+        ...config,
+        icon: classIcon.svg(config.icon),
+    });
+}
+export function defineClass(config) {
+    if (config.kind === 'node') {
+        const { kind: _, ...input } = config;
+        return nodeClass(input);
+    }
+    if (config.orientation === 'directed')
+        return defineKernelClass(config);
+    return defineKernelClass(config);
+}

package/dist/platform/schema/class-icon.d.ts

@@ -0,0 +1,15 @@
+import type { LucideIconData } from '@lucide/icons';
+declare const CLASS_ICON: unique symbol;
+/** An admitted, self-contained SVG suitable for a Node Class presentation icon. */
+export type ClassIcon = string & {
+    readonly [CLASS_ICON]: true;
+};
+/** Stable empty SVG used when an author explicitly chooses to render no icon glyph. */
+export declare const NEUTRAL_CLASS_ICON_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\"></svg>";
+/** Framework-neutral constructors for canonical Node Class icons. */
+export declare const classIcon: Readonly<{
+    readonly neutral: ClassIcon;
+    svg(source: string): ClassIcon;
+    lucide(icon: LucideIconData): ClassIcon;
+}>;
+export {};

package/dist/platform/schema/class-icon.js

@@ -0,0 +1,46 @@
+import { buildLucideSvg } from '@lucide/icons/build';
+const MAX_CLASS_ICON_LENGTH = 8_000;
+const SVG_ROOT = /^<svg(?:\s[^>]*)?>[\s\S]*<\/svg>$/u;
+const SVG_ROOT_OPEN = /<svg(?:\s|>)/gu;
+const SVG_ROOT_CLOSE = /<\/svg\s*>/gu;
+const SVG_GRAPHIC = /<(?:circle|ellipse|line|path|polygon|polyline|rect)\b/iu;
+const UNSAFE_SVG = /<\s*(?:animate|discard|embed|foreignObject|iframe|image|object|script|set|style|use)\b|<!DOCTYPE\b|<!ENTITY\b|\son[a-z][\w:.-]*\s*=|(?:href|xlink:href)\s*=|javascript\s*:|url\s*\(/iu;
+/** Stable empty SVG used when an author explicitly chooses to render no icon glyph. */
+export const NEUTRAL_CLASS_ICON_SVG = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"></svg>';
+function svg(source) {
+    if (typeof source !== 'string') {
+        throw new TypeError('Class icon must be an inline SVG string.');
+    }
+    const value = source.trim();
+    if (Array.from(value).length > MAX_CLASS_ICON_LENGTH) {
+        throw new TypeError(`Class icon must contain at most ${MAX_CLASS_ICON_LENGTH} characters.`);
+    }
+    if (!SVG_ROOT.test(value) ||
+        (value.match(SVG_ROOT_OPEN)?.length ?? 0) !== 1 ||
+        (value.match(SVG_ROOT_CLOSE)?.length ?? 0) !== 1) {
+        throw new TypeError('Class icon must be one complete inline <svg> element.');
+    }
+    if (UNSAFE_SVG.test(value)) {
+        throw new TypeError('Class icon SVG must be self-contained and contain no executable content.');
+    }
+    if (value !== NEUTRAL_CLASS_ICON_SVG && !SVG_GRAPHIC.test(value)) {
+        throw new TypeError('Class icon SVG must contain a visible vector element.');
+    }
+    return value;
+}
+function lucide(icon) {
+    let source;
+    try {
+        source = buildLucideSvg(icon, { color: 'currentColor' });
+    }
+    catch (cause) {
+        throw new TypeError('Class icon must be valid Lucide icon data.', { cause });
+    }
+    return svg(source);
+}
+/** Framework-neutral constructors for canonical Node Class icons. */
+export const classIcon = Object.freeze({
+    neutral: svg(NEUTRAL_CLASS_ICON_SVG),
+    svg,
+    lucide,
+});

package/dist/platform/schema/error.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export type DeclaredErrorFamily = 'VALIDATION_ERROR' | 'NOT_FOUND' | 'CONFLICT' | 'UNSUPPORTED';
+export interface DeclaredErrorDefinition<out Details extends z.ZodType = z.ZodType> {
+    readonly family: DeclaredErrorFamily;
+    readonly message: string;
+    readonly details: Details;
+}
+/** Declare a reusable business-error contract. Its registration key supplies the code. */
+export declare function error<const Definition extends DeclaredErrorDefinition>(definition: Definition & Record<Exclude<keyof Definition, keyof DeclaredErrorDefinition>, never>): Readonly<Definition>;
+/** Shared admission for Schema declarations and Action/Workflow registration. */
+export declare function acceptErrorDefinition(input: unknown, label?: string): DeclaredErrorDefinition;

package/dist/platform/schema/error.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+const MAXIMUM_MESSAGE_BYTES = 512;
+const FAMILIES = new Set([
+    'VALIDATION_ERROR',
+    'NOT_FOUND',
+    'CONFLICT',
+    'UNSUPPORTED',
+]);
+/** Declare a reusable business-error contract. Its registration key supplies the code. */
+export function error(definition) {
+    return acceptErrorDefinition(definition);
+}
+/** Shared admission for Schema declarations and Action/Workflow registration. */
+export function acceptErrorDefinition(input, label = 'Error declaration') {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new TypeError(`${label} is invalid.`);
+    }
+    const candidate = input;
+    if (Reflect.ownKeys(candidate).length !== 3 ||
+        !Object.hasOwn(candidate, 'family') ||
+        !Object.hasOwn(candidate, 'message') ||
+        !Object.hasOwn(candidate, 'details')) {
+        throw new TypeError(`${label} is invalid.`);
+    }
+    const { family, message, details } = candidate;
+    if (!FAMILIES.has(family) ||
+        typeof message !== 'string' ||
+        message.trim() === '' ||
+        new TextEncoder().encode(message).byteLength > MAXIMUM_MESSAGE_BYTES ||
+        !(details instanceof z.ZodType)) {
+        throw new TypeError(`${label} is invalid.`);
+    }
+    return Object.freeze({ family: family, message, details });
+}

package/dist/platform/schema/errors/index.d.ts

@@ -0,0 +1,3 @@
+/** Runtime-safe business-error declarations shared by Schema and handlers. */
+export { error } from '../error.js';
+export type { DeclaredErrorDefinition, DeclaredErrorFamily } from '../error.js';

package/dist/platform/schema/errors/index.js

@@ -0,0 +1,2 @@
+/** Runtime-safe business-error declarations shared by Schema and handlers. */
+export { error } from '../error.js';

package/dist/platform/schema/icons/index.d.ts

@@ -0,0 +1,2 @@
+/** Framework-neutral Lucide icon data accepted by `classIcon.lucide`. */
+export * from '@lucide/icons';

package/dist/platform/schema/icons/index.js

@@ -0,0 +1,2 @@
+/** Framework-neutral Lucide icon data accepted by `classIcon.lucide`. */
+export * from '@lucide/icons';

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

@@ -0,0 +1,23 @@
+/** Canonical Schema authoring, compilation, loading, and resolved Domain surface. */
+export * from '@astrale-os/kernel-dsl/v1';
+export { defineSchema } from './schema-authoring.js';
+export type { AuthoredSchema, AuthoredDomain } from './schema-authoring.js';
+export { stateProperty } from './state-property.js';
+export type { StateProperty } from './state-property.js';
+export { patterns } from '@astrale-os/kernel-dsl/v1/addressing';
+export { defineClass, nodeClass } from './class-authoring.js';
+export type { AuthoredNodeClass, NodeClassInput } from './class-authoring.js';
+export { error } from './error.js';
+export type { DeclaredErrorDefinition, DeclaredErrorFamily } from './error.js';
+export { classIcon } from './class-icon.js';
+export type { ClassIcon } from './class-icon.js';
+export type { CallablePolicyBuilder, CallablePolicyContext, CallableProjection, AuthoredMethodProjection, AuthoredPropertyProjection, ClassIdentityProjection, ClassOwnerProjection, CoreEdge, CoreEndpoint, CoreNode, DefinedSchema, DirectedEdgeClass, ClassReferenceProjection, ClassProjection, FunctionProjection, EdgeClass, Function, Method, MethodProjection, Lazy, NodeClass, Policy, PolicyExistsContext, PolicyNodeBinder, PolicyPatternContext, Property, PropertyProjection, ResolvedDomainOfInput, View, } from '@astrale-os/kernel-dsl/v1/builder';
+export type { Array, Object, Value } from '@astrale-os/kernel-dsl/value';
+export type { ClassKind, DirectedEdgeContract, EdgeClassPolicies, NodeClassDefinition, PolicyCheckObject, PolicyObjectRef, PropertyFacet, StateTopology, UndirectedEdgeContract, } from '@astrale-os/kernel-dsl/v1/language';
+export type { DomainSchema } from '@astrale-os/kernel-dsl/v1/schema';
+/** Kernel-owned Schema values used by authored product Schemas and graph operations. */
+export { AuthorityOperationOrder, AuthorityOperations, AuthorityRelations, KernelRootFunctions, OperationCore, operationOf, } from '@astrale-os/kernel-core/schema';
+export type { AuthorityOperation, AuthorityRelation } from '@astrale-os/kernel-core/schema';
+export { K, KernelSchema } from './kernel.js';
+export type { Kernel, KernelClass, KernelDomain } from './kernel.js';
+export { nodeId } from './node-id.js';

package/dist/platform/schema/index.js

@@ -0,0 +1,12 @@
+/** Canonical Schema authoring, compilation, loading, and resolved Domain surface. */
+export * from '@astrale-os/kernel-dsl/v1';
+export { defineSchema } from './schema-authoring.js';
+export { stateProperty } from './state-property.js';
+export { patterns } from '@astrale-os/kernel-dsl/v1/addressing';
+export { defineClass, nodeClass } from './class-authoring.js';
+export { error } from './error.js';
+export { classIcon } from './class-icon.js';
+/** Kernel-owned Schema values used by authored product Schemas and graph operations. */
+export { AuthorityOperationOrder, AuthorityOperations, AuthorityRelations, KernelRootFunctions, OperationCore, operationOf, } from '@astrale-os/kernel-core/schema';
+export { K, KernelSchema } from './kernel.js';
+export { nodeId } from './node-id.js';

package/dist/platform/schema/kernel.d.ts

@@ -0,0 +1,22 @@
+import type { ResolvedClass } from '@astrale-os/kernel-dsl/v1';
+import type { DefinedSchema } from '@astrale-os/kernel-dsl/v1/builder';
+import { KernelSchema as CoreKernelSchema } from '@astrale-os/kernel-core/schema';
+import { schema } from '@astrale-os/kernel-dsl/v1';
+type KernelClasses = schema.DomainOf<CoreKernelSchema>['classes'];
+/** A Kernel Class retains its canonical name instead of copying its resolved collections. */
+export interface KernelClass<Name extends keyof KernelClasses> extends Pick<KernelClasses[Name], keyof ResolvedClass> {
+    readonly key: `${CoreKernelSchema['origin']}:class.${Name}`;
+}
+/** The canonical Kernel Domain with reusable Class references. */
+export interface KernelDomain extends schema.DomainOf<CoreKernelSchema> {
+    readonly classes: {
+        readonly [Name in keyof KernelClasses]: KernelClass<Name>;
+    };
+}
+/** SDK-owned portable name for the Kernel Schema's exact contract. */
+export interface KernelSchema extends DefinedSchema<CoreKernelSchema['origin'], KernelDomain> {
+}
+export declare const KernelSchema: KernelSchema;
+export declare const K: schema.ResolvedDomainOf<KernelSchema>;
+export type Kernel = typeof K;
+export {};

package/dist/platform/schema/kernel.js

@@ -0,0 +1,5 @@
+import { K as CoreKernel, KernelSchema as CoreKernelSchema } from '@astrale-os/kernel-core/schema';
+import { schema } from '@astrale-os/kernel-dsl/v1';
+// Admission belongs to the SDK's DSL instance, even when Core uses a different package instance.
+export const KernelSchema = schema.accept(CoreKernelSchema);
+export const K = CoreKernel;

package/dist/platform/schema/node-id.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+/** Bare Kernel node identity. Does not assert existence, Class, or authority. */
+export declare function nodeId(): z.ZodString;

package/dist/platform/schema/node-id.js

@@ -0,0 +1,6 @@
+import { fullMatch } from '@astrale-os/kernel-dsl/v1';
+import { z } from 'zod';
+/** Bare Kernel node identity. Does not assert existence, Class, or authority. */
+export function nodeId() {
+    return z.string().min(1).max(255).check(fullMatch('[A-Za-z0-9._-]+'));
+}