@salsita-ai/sdk 0.50.0-develop.4599bc222f → 0.50.0-develop.4c59c65881

package/dist/{application-spec/caching → domain/spec/runtime}/runtime-reference-store.d.ts

@@ -43,8 +43,4 @@ export declare class RuntimeReferenceStore {
     /** Clears all stored references. Use when the pipeline must force a complete rebuild. */
     clear(): void;
 }
-/**
- * @deprecated Use {@link RuntimeReferenceStore}. This compatibility alias will be removed in a
- * future breaking project-sdk release.
- */
-export { RuntimeReferenceStore as ApplicationSpecCache };
+export {};

package/dist/domain/spec/runtime/runtime-reference-store.js

@@ -0,0 +1 @@
+export class RuntimeReferenceStore{scopes=new Map;createBuilder(e,t){let{build:s,getKey:r,compare:l}=t;this.scopes.has(e)||this.scopes.set(e,new Map);let u=this.scopes.get(e);return{build:e=>{let t=r(e),c=u.get(t);if(c&&l(c.input,e))return{output:c.output,changed:!1};let o=s(e);return u.set(t,{input:e,output:o}),{output:o,changed:!0}},cleanup:e=>{let t=!1;for(let s of u.keys())e.has(s)||(u.delete(s),t=!0);return t},getKey:r}}clear(){for(let e of this.scopes.values())e.clear()}}

package/dist/{application-spec/generate-application → domain/spec}/runtime/sections/actions-runtime.d.ts

@@ -1,7 +1,7 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { ActionDefinitions } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { Actions } from '../../../parse-application-files/index.js';
+import type { ActionDefinitions } from '../../../core/index.js';
+import type { Actions } from '../../sections/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 /**
  * The declared actions as the runtime spec slice holds them, with change tracking: the definitions
  * are rebuilt only when their declaration changes, so a hot reload of an unrelated section keeps

package/dist/{application-spec/generate-application → domain/spec}/runtime/sections/assistant-runtime.d.ts

@@ -1,7 +1,7 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { AssistantResolvedManifest } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
 import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import type { AssistantResolvedManifest } from '../../sections/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 /** Resolved assistant manifest with change tracking, carried to the runtime spec on hot reload. */
 export type AssistantRuntime = Branded<'AssistantRuntime', {
     readonly assistant: AssistantResolvedManifest | null;

package/dist/{application-spec/generate-application → domain/spec}/runtime/sections/data-runtime.d.ts

@@ -1,6 +1,6 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
 import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 type ParsedDataSpecEntries = RuntimeSpec['dataSpec']['entries'];
 type ParsedChunks = RuntimeSpec['dataSpec']['chunks'];
 export type DataRuntime = Branded<'DataRuntime', {

package/dist/domain/spec/runtime/sections/index.d.ts

@@ -0,0 +1,6 @@
+export { ActionsRuntime } from './actions-runtime.js';
+export { AssistantRuntime } from './assistant-runtime.js';
+export { DataRuntime } from './data-runtime.js';
+export { PresetRuntime } from './preset-runtime.js';
+export { ThemeRuntime } from './theme-runtime.js';
+export { TransformersRuntime } from './transformers-runtime.js';

package/dist/domain/spec/runtime/sections/index.js

@@ -0,0 +1 @@
+export{ActionsRuntime}from"./actions-runtime.js";export{AssistantRuntime}from"./assistant-runtime.js";export{DataRuntime}from"./data-runtime.js";export{PresetRuntime}from"./preset-runtime.js";export{ThemeRuntime}from"./theme-runtime.js";export{TransformersRuntime}from"./transformers-runtime.js";

package/dist/{application-spec/generate-application → domain/spec}/runtime/sections/preset-runtime.d.ts

@@ -1,7 +1,7 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { DomainEntity, ProductPreset } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { Preset } from '../../../parse-application-files/index.js';
+import type { DomainEntity, ProductPreset } from '../../../core/index.js';
+import type { SpecPreset } from '../../model/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 type AnyProductPreset = ProductPreset<DomainEntity<string>, DomainEntity<string>>;
 /** Collection of runtime presets with change tracking. */
 export type PresetRuntime = Branded<'PresetRuntime', {
@@ -10,7 +10,7 @@ export type PresetRuntime = Branded<'PresetRuntime', {
 }>;
 interface PresetRuntimeProps {
     readonly referenceScope: string;
-    readonly presets: readonly Preset[];
+    readonly presets: readonly SpecPreset[];
 }
 /**
  * Builds preset runtime objects with per-item reference stability.

package/dist/{application-spec/generate-application → domain/spec}/runtime/sections/theme-runtime.d.ts

@@ -1,6 +1,6 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
 import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 /** Resolved theme spec with change tracking — no UI deps, just preset + options. */
 export type ThemeRuntime = Branded<'ThemeRuntime', {
     readonly preset: string;

package/dist/{application-spec/generate-application → domain/spec}/runtime/sections/transformers-runtime.d.ts

@@ -1,7 +1,7 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { ImportedTransformer } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
+import type { ImportedTransformer } from '../../../application/index.js';
 import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 /**
  * Runtime section for transformers. Combines two sources of truth:
  * - `importedTransformers` — factory functions from src/transformers/*.ts

package/dist/{application-spec/generate-application → domain/spec}/runtime/spec-code/resolve-spec-code.d.ts

@@ -1,4 +1,4 @@
-import type { SelfAccessor } from '../../../core/index.js';
+import type { SelfAccessor } from '../../enhanced-json/index.js';
 import type { SpecCodeId } from '../../runtime-spec/index.js';
 import type { SpecCodeMap } from './spec-code-module.js';
 /**

package/dist/domain/spec/runtime/spec-code/spec-code-module.js

@@ -0,0 +1 @@
+export{};

package/dist/{application-spec/generate-application → domain/spec}/runtime/spec-runtime.d.ts

@@ -1,8 +1,8 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { RuntimeReferenceStore } from '../../caching/index.js';
 import type { RuntimeSpec } from '../runtime-spec/index.js';
-import { AdminSpecRuntime } from './admin-runtime/admin-spec-runtime.js';
-import { ConfiguratorSpecRuntime } from './configurator-runtime/configurator-spec-runtime.js';
+import { AdminSpecRuntime } from './admin-runtime/index.js';
+import { ConfiguratorSpecRuntime } from './configurator-runtime/index.js';
+import type { RuntimeReferenceStore } from './runtime-reference-store.js';
 import type { SpecCodeModule } from './spec-code/index.js';
 /**
  * The sections of both domains that the spec alone determines, without a project module: each

package/dist/domain/spec/runtime/spec-runtime.js

@@ -0,0 +1 @@
+import{Branded as i}from"@salsita-ai/common/utils";import{AdminSpecRuntime as o}from"./admin-runtime/index.js";import{ConfiguratorSpecRuntime as r}from"./configurator-runtime/index.js";export const SpecRuntime=(m,n,t)=>i({configurator:r(m,n,t?.configurator),admin:o(m,n,t?.admin)});

package/dist/domain/spec/runtime-spec/index.d.ts

@@ -0,0 +1,4 @@
+export { decodeRuntimeSpec } from './decode-runtime-spec.js';
+export { encodeRuntimeSpec } from './encode-runtime-spec.js';
+export { type RuntimeAdminSpec, type RuntimeAssistantSpec, type RuntimeConfiguratorSpec, type RuntimeDataSchemaEntry, type RuntimeDataSchemas, type RuntimeDataSpec, type RuntimeEntitySchema, type RuntimeInfra, type RuntimeLatestModelVersion, type RuntimeModelVersion, type RuntimeResolvedModelVersion, type RuntimeResolvedVersions, type RuntimeShapeSchema, type RuntimeSpec, toRuntimeSpec, } from './runtime-spec.js';
+export { type SpecCodeId, specCodeComponentKey, specCodeEvalIds, specCodeExpressionKey, specCodeFilterId, } from './spec-code-id.js';

package/dist/domain/spec/runtime-spec/index.js

@@ -0,0 +1 @@
+export{decodeRuntimeSpec}from"./decode-runtime-spec.js";export{encodeRuntimeSpec}from"./encode-runtime-spec.js";export{toRuntimeSpec}from"./runtime-spec.js";export{specCodeComponentKey,specCodeEvalIds,specCodeExpressionKey,specCodeFilterId}from"./spec-code-id.js";

package/dist/domain/spec/runtime-spec/runtime-spec.d.ts

@@ -0,0 +1,174 @@
+import type { AdminPages, AdminStates, ConfiguratorStates } from '../application/index.js';
+import type { Components } from '../components/index.js';
+import type { Expressions } from '../expressions/index.js';
+import type { Invariants } from '../invariants/index.js';
+import type { JsonSchema } from '../json-schema.js';
+import type { CommonTypes, Defaults, EntityOrAliasName, EntityTypeName, EntityTypes, ModelVersionKey, Presets, SpecAliases } from '../model/index.js';
+import type { Acl, Actions, AppMetadata, AssistantResolvedManifest, Chunks, ParsedDataSpecEntries, ResourceEntry, SpecResourcesConfig, SpecTransformers, Theme, Ui } from '../sections/index.js';
+/**
+ * The part of a parsed entity schema the runtime reads: the entity type and the schema of its
+ * shape, from which it builds the entity's reflection. The full schema with `id` and `type` is
+ * only registered with a deployment, and the compiled shape validators only check presets and
+ * defaults while parsing.
+ */
+export interface RuntimeEntitySchema {
+    readonly entityType: EntityTypeName;
+    readonly shapeSchema: JsonSchema;
+}
+/**
+ * The part of a parsed model version the runtime reads: the entity types, the aliases, the common
+ * types and the schema of every entity's shape. The shapes and the resolved shapes only serve the
+ * parser and the type generator, except the runtime schemas of the latest version's shapes (see
+ * `RuntimeLatestModelVersion`).
+ */
+export interface RuntimeModelVersion {
+    readonly versionKey: ModelVersionKey;
+    readonly entityTypes: EntityTypes;
+    /** Entity types allowed as preset root — members of the RootEntity alias, or all entity types if no RootEntity alias. */
+    readonly rootEntityTypes: readonly EntityTypeName[];
+    readonly aliases: SpecAliases;
+    readonly commonTypes: CommonTypes;
+    readonly entitySchemas: readonly RuntimeEntitySchema[];
+}
+/**
+ * The latest model version of a domain as the runtime reads it: a model version plus the runtime
+ * schema of every shape, which `phx.domain.model` reflects as `<Name>Shape`.
+ */
+export interface RuntimeLatestModelVersion extends RuntimeModelVersion {
+    readonly shapes: ReadonlyMap<EntityOrAliasName, RuntimeShapeSchema>;
+}
+/** The part of a parsed shape the runtime reads: its name and its runtime JSON schema. */
+export interface RuntimeShapeSchema {
+    readonly name: EntityOrAliasName;
+    readonly runtimeSchema: JsonSchema;
+}
+/**
+ * One model version of a domain as the runtime reads it, with the migration file that leads to it.
+ * `version` is the integer version number (1, 2, 3, …), `key` is always `v{N}`, never `latest`,
+ * `isLatest` marks the version of the `latest` model key, and `migrationFile` is the path of the
+ * migration file, present from v2 on.
+ */
+export interface RuntimeResolvedModelVersion {
+    readonly version: number;
+    readonly key: string;
+    readonly isLatest: boolean;
+    readonly modelVersion: RuntimeModelVersion;
+    readonly migrationFile: string | undefined;
+}
+/**
+ * Every model version of a domain as the runtime reads it; it builds the domain's migrations from
+ * them. `latestVersion` is the integer of the `latest` key, and `versionedModels` is sorted
+ * ascending by version number.
+ */
+export interface RuntimeResolvedVersions {
+    readonly latestVersion: number;
+    readonly versionedModels: readonly RuntimeResolvedModelVersion[];
+}
+/** The model of a domain as the runtime reads it: the latest version and every earlier one. */
+interface RuntimeDomainModel {
+    readonly latestModel: RuntimeLatestModelVersion;
+    readonly resolvedVersions: RuntimeResolvedVersions;
+}
+/** The part of a parsed data schema the runtime reads: the JSON schema it validates the data with. */
+export interface RuntimeDataSchemaEntry {
+    readonly runtimeSchema: JsonSchema;
+}
+/**
+ * The data schemas as the runtime reads them: the JSON schema of each kind of data and the hash of
+ * the published data. The enhanced schemas, with Phoenix references, only serve the type generator.
+ */
+export interface RuntimeDataSchemas {
+    readonly publishedData: RuntimeDataSchemaEntry;
+    readonly publishedDataHash: string;
+    readonly sessionData: RuntimeDataSchemaEntry;
+    readonly frontendData: RuntimeDataSchemaEntry;
+    readonly backendData: RuntimeDataSchemaEntry | undefined;
+    readonly finalizeData: RuntimeDataSchemaEntry;
+    readonly prefetchedFinalizeData: RuntimeDataSchemaEntry;
+    readonly finalizeResult: RuntimeDataSchemaEntry;
+    readonly callbackData: RuntimeDataSchemaEntry;
+}
+/**
+ * The assistant as the runtime reads it: its resolved manifest. The parsed assistant schema the
+ * manifest is resolved from only serves the parser.
+ */
+export type RuntimeAssistantSpec = {
+    readonly resolved: AssistantResolvedManifest;
+} | null;
+/**
+ * The data spec as the runtime reads it: the data entries and their chunks. The data entries and
+ * admin data pages the parser derives from them only serve the admin spec and the type generator.
+ */
+export interface RuntimeDataSpec {
+    /** Validated entries grouped by their source `$data` subsection for generated SDK config. */
+    readonly entries: ParsedDataSpecEntries;
+    /** Validated published-data chunks, including the auto-injected `system` chunk when needed. */
+    readonly chunks: Chunks;
+}
+/**
+ * The configurator part of the runtime spec. It leaves out the configuration schema and its
+ * version, which only a deployment registers, and the assistant's server settings (instructions
+ * and AI settings), which must never reach the browser of a customer.
+ */
+export interface RuntimeConfiguratorSpec extends RuntimeDomainModel {
+    readonly components: Components;
+    readonly presets: Presets;
+    readonly expressions: Expressions;
+    readonly actions: Actions;
+    readonly invariants: Invariants;
+    readonly defaults: Defaults;
+    readonly states: ConfiguratorStates;
+    readonly theme: Theme;
+    readonly ui: Ui;
+    readonly transformers: SpecTransformers;
+    readonly dataSchemas: RuntimeDataSchemas;
+    readonly assistant: RuntimeAssistantSpec;
+}
+/**
+ * The admin part of the runtime spec. It leaves out the configuration schema and its version, which
+ * only a deployment registers.
+ */
+export interface RuntimeAdminSpec extends RuntimeDomainModel {
+    readonly components: Components;
+    readonly presets: Presets;
+    readonly expressions: Expressions;
+    readonly invariants: Invariants;
+    readonly defaults: Defaults;
+    readonly states: AdminStates;
+    readonly adminPages: AdminPages;
+}
+/**
+ * The infrastructure settings the runtime reads: access control and resources. The environment
+ * variable declarations only drive the generated environment readers.
+ */
+export interface RuntimeInfra {
+    readonly acl: Acl;
+    readonly resources: readonly ResourceEntry[] | undefined;
+    readonly resourcesConfig: SpecResourcesConfig | undefined;
+}
+/**
+ * The parsed application spec as the runtime reads it: what `ApplicationRuntime` builds the
+ * configurator and admin runtimes from, and the sections an application needs besides its domains
+ * (data spec, app metadata, resources, access control, user interface settings, webhook data
+ * schemas, admin pages). `phoenix sync` and `phoenix build` write it to
+ * `.phoenix/application-spec.json` with `encodeRuntimeSpec`.
+ *
+ * Its sections are the spec data types of `domain`, the types the parser produces, so a parsed
+ * `ApplicationSpec` is assignable to it. It leaves out what only the parser, the type generator or
+ * a deployment use, and holds plain data, Maps and Sets only, so it can be encoded as JSON.
+ */
+export interface RuntimeSpec {
+    readonly appMetadata: AppMetadata;
+    readonly dataSpec: RuntimeDataSpec;
+    readonly configurator: RuntimeConfiguratorSpec;
+    readonly admin: RuntimeAdminSpec;
+    readonly infra: RuntimeInfra;
+}
+/**
+ * Takes from a parsed application spec the part the runtime reads. It reuses the sections it keeps
+ * whole, and builds trimmed copies of the model versions, data schemas, assistant and data spec
+ * without what the runtime does not read. It takes any `RuntimeSpec`, which a parsed
+ * `ApplicationSpec` is, and copies only what the type declares.
+ */
+export declare const toRuntimeSpec: (spec: RuntimeSpec) => RuntimeSpec;
+export {};

package/dist/{application-spec/generate-application → domain/spec}/runtime-spec/spec-code-id.d.ts

@@ -1,4 +1,4 @@
-import type { MemoEvalPlan } from '../../parse-application-files/index.js';
+import type { MemoEvalPlan } from '../expressions/index.js';
 /**
  * The id under which the generated `.phoenix/spec-code.ts` holds one piece of code written in YAML,
  * and under which the runtime looks it up. Ids are unique within one domain; the configurator and

package/dist/domain/spec/sections/actions.d.ts

@@ -0,0 +1,23 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { EnhancedJsonSchemaType } from '../../core/index.js';
+import type { JsonSchema } from '../json-schema.js';
+import type { ActionName } from '../model/index.js';
+/** One parameter of an action: its declared schema, and whether a call has to pass it (a nullable param is optional). */
+export interface ActionParam {
+    readonly schema: EnhancedJsonSchemaType;
+    readonly required: boolean;
+}
+/**
+ * One validated action declaration. `params` and `result` keep the enhanced schemas for codegen and
+ * for consumers that expose the action; `paramsSchema` is the AJV-ready object schema of the parameters, with the
+ * refs resolved into `$defs`, which the action system validates the arguments of a call against.
+ */
+export type Action = Branded<'Action', {
+    readonly name: ActionName;
+    readonly description?: string;
+    readonly params: Readonly<Record<string, ActionParam>>;
+    readonly result: Readonly<Record<string, EnhancedJsonSchemaType>>;
+    readonly paramsSchema: JsonSchema;
+}>;
+/** The validated `actions` section: every declared action by name, in declaration order; empty when the spec declares none. */
+export type Actions = Branded<'Actions', ReadonlyMap<ActionName, Action>>;

package/dist/domain/spec/sections/actions.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/app-metadata.d.ts

@@ -0,0 +1,19 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { ApplicationVersion } from './application-version.js';
+/**
+ * Validated application metadata — version, auth, infrastructure settings.
+ * Used by codegen for ApplicationVersion export and builder chain methods.
+ */
+export type AppMetadata = Branded<'AppMetadata', {
+    readonly applicationVersion: ApplicationVersion;
+    readonly workspace: boolean;
+    readonly webComponentTag: string | undefined;
+    readonly pageTitle: string | undefined;
+    readonly useAuthHook: boolean;
+    readonly useClerk: boolean;
+    readonly useCognito: boolean;
+    readonly enableAdminRelease: boolean;
+    readonly jsonSchemaValidator: 'ajv' | 'csp-compatible';
+    readonly gltfDecoder: 'js' | 'wasm';
+    readonly collectFinalizeData: boolean;
+}>;

package/dist/domain/spec/sections/app-metadata.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/application-version.d.ts

@@ -0,0 +1,7 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded semantic version (x.y.z) of the application.
+ * Exported by codegen as the `ApplicationVersion` constant and stored as
+ * `applicationVersion` on the deployment record.
+ */
+export type ApplicationVersion = Branded<'ApplicationVersion', string>;

package/dist/domain/spec/sections/application-version.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/{application → spec/sections}/assistant/assistant-manifest.d.ts

@@ -8,18 +8,28 @@ export interface AssistantFieldSource {
     readonly source: string;
     readonly localized?: true;
 }
+/**
+ * What the integrator promises about a list of choices, so the agent can read it once and reuse it:
+ * `sameForAllInstances` when every entity of the type gets the same list, `constantDuringSession`
+ * when the list does not change during a session. A hint only adds a sentence to the description of
+ * the recipe group or options edge it is declared on; nothing verifies it.
+ */
+export declare const ASSISTANT_HINTS: readonly ['sameForAllInstances', 'constantDuringSession'];
+export type AssistantResolvedHint = (typeof ASSISTANT_HINTS)[number];
 /**
  * One recipe group the assistant manifest exposes on an entity type: a `childEntityRecipes` instance
  * under `childRecipes`, a `replaceEntityRecipes` instance under `replaceRecipes`. `groupId` is the
- * name the agent addresses the group by, `instanceName` the component instance it reads,
- * `description` the manifest's text replacing the component's group description, and `dryRuns`
- * whether the recipes of the group can be dry-run.
+ * name of its field on `<Type>ChildRecipes` or `<Type>ReplaceRecipes` and the id the agent passes to
+ * `addChild` or `replaceEntity`, `instanceName` the component instance it reads, `description` the
+ * manifest's text for that field, `dryRuns` whether the recipes of the group can be dry-run, and
+ * `hints` the sentences of the field's description saying when the agent can reuse what it read.
  */
 export interface AssistantRecipeGroup {
     readonly groupId: string;
     readonly instanceName: string;
     readonly description?: string;
     readonly dryRuns: boolean;
+    readonly hints: readonly AssistantResolvedHint[];
 }
 /**
  * The options edge of one writable field the assistant manifest links to its component. `field` is

package/dist/domain/{application → spec/sections}/assistant/assistant-resolved-manifest.d.ts

@@ -1,4 +1,4 @@
-import type { AssistantFieldOptions, AssistantRecipeGroup, AssistantScreenshotView } from './assistant-manifest.js';
+import type { AssistantFieldOptions, AssistantRecipeGroup, AssistantResolvedHint, AssistantScreenshotView } from './assistant-manifest.js';
 import type { AssistantFormElementDescriptor } from './form/index.js';
 /** JSON description of a scalar or recursively nested list, including nullability at each level. */
 export type AssistantValueType = {
@@ -10,11 +10,16 @@ export type AssistantValueType = {
     readonly item: AssistantValueType;
     readonly nonNull: boolean;
 };
-/** A relation edge resolved against the model at parse time, linked to GraphQL types only during building. */
-export interface AssistantRelationType {
+/**
+ * An entity edge resolved at parse time, linked to GraphQL types only during building: a relation,
+ * an entity-returning expression or an action result member. `target` is an entity type or alias,
+ * `list` makes it `[Target!]` and `nullable` drops the outer non-null.
+ */
+export interface AssistantEdgeType {
     readonly kind: 'edge';
     readonly target: string;
-    readonly cardinality: '1-1' | '0-1' | '0-N' | '1-N';
+    readonly list: boolean;
+    readonly nullable: boolean;
 }
 /**
  * A field's source and resolved type, carried in the application bundle without GraphQL instances.
@@ -27,7 +32,7 @@ export interface AssistantResolvedField {
     readonly type: {
         readonly kind: 'value';
         readonly type: AssistantValueType;
-    } | AssistantRelationType;
+    } | AssistantEdgeType;
     readonly localized: boolean;
     readonly description?: string;
     readonly lenses?: readonly string[];
@@ -54,6 +59,8 @@ export interface AssistantResolvedManifest {
     /** The screenshot views of each entity type with at least one, aliases expanded, in manifest order. */
     readonly screenshots: Readonly<Record<string, readonly AssistantScreenshotView[]>>;
     readonly actionFields: readonly AssistantResolvedAction[];
+    /** The entity types that declare invariants, whose `meta` lists the warnings and notices they hold. */
+    readonly invariantTypes: readonly string[];
     /** The declared lenses by name: when to use each, and how many levels its tagged relations nest. */
     readonly lenses: Readonly<Record<string, {
         readonly description: string;
@@ -74,27 +81,17 @@ export interface AssistantWritableType {
     readonly entityType: string;
     readonly fields: readonly AssistantWritableField[];
 }
-/** Description hints resolved from recipe/option entries; no parse context is retained. */
-export declare const ASSISTANT_HINTS: readonly ['sameForAllInstances', 'constantDuringSession'];
-export type AssistantResolvedHint = (typeof ASSISTANT_HINTS)[number];
-/** Recipe groups and their description hints for one entity type. */
-export interface AssistantResolvedRecipes {
-    readonly groups: readonly AssistantRecipeGroup[];
-    readonly hints: readonly AssistantResolvedHint[];
-}
+/** The recipe groups of one kind on one entity type or alias key, in manifest order, each with its own hints. */
+export type AssistantResolvedRecipes = readonly AssistantRecipeGroup[];
 /** One options edge, carrying the write-validation contract and schema description hints. */
 export interface AssistantResolvedOptionsEdge {
     readonly options: AssistantFieldOptions;
     readonly hints: readonly AssistantResolvedHint[];
 }
 /** An action result field, either an entity edge or a plain JSON-described value. */
-export type AssistantResolvedActionResult = {
-    readonly kind: 'edge';
-    readonly target: string;
-    readonly list: boolean;
-    readonly nullable: boolean;
+export type AssistantResolvedActionResult = (AssistantEdgeType & {
     readonly description?: string;
-} | {
+}) | {
     readonly kind: 'value';
     readonly type: AssistantValueType;
     readonly description?: string;

package/dist/domain/spec/sections/assistant/assistant-resolved-manifest.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/assistant/index.d.ts

@@ -0,0 +1,4 @@
+export { ASSISTANT_HINTS } from './assistant-manifest.js';
+export type { AssistantResolvedManifest, AssistantDeclaredField, AssistantDeclarations, AssistantDeclaredWrite, AssistantResolvedField, AssistantValueType, AssistantEdgeType, AssistantStates, AssistantWritableType, AssistantWritableField, AssistantResolvedRecipes, AssistantResolvedOptionsEdge, AssistantResolvedAction, AssistantResolvedActionResult, } from './assistant-resolved-manifest.js';
+export type { AssistantFieldSource, AssistantResolvedHint, AssistantRecipeGroup, AssistantFieldOptions, AssistantScreenshotView, AssistantManifest, } from './assistant-manifest.js';
+export * from './form/index.js';

package/dist/domain/spec/sections/assistant/index.js

@@ -0,0 +1 @@
+export{ASSISTANT_HINTS}from"./assistant-manifest.js";export*from"./form/index.js";

package/dist/domain/spec/sections/data-spec/chunks.d.ts

@@ -0,0 +1,23 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated published-data chunk name.
+ * Chunk names identify top-level partitions in generated `publishedData`. Data
+ * entries point to these names through their `chunk` field, and the parser adds
+ * the reserved `system` chunk when user chunks exist.
+ */
+export type ChunkName = Branded<'ChunkName', string>;
+/**
+ * A named partition of published data with a scope.
+ * `scope` is typically `'project'` (per-project data) or `'public'` (shared).
+ */
+export interface ChunkDefinition {
+    /** Visibility/storage scope used by runtime data publishing for this chunk. */
+    readonly scope: string;
+}
+/**
+ * Validated chunk definitions, keyed by chunk name.
+ * When any user-defined chunks are present, the reserved `system` chunk is
+ * auto-injected with `scope: 'public'` to carry admin presets/recipes schemas.
+ * When the input is empty, no system injection happens (mirrors domain-spec behavior).
+ */
+export type Chunks = Readonly<Record<ChunkName, ChunkDefinition>>;

package/dist/domain/spec/sections/data-spec/chunks.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/custom-data-spec-entry.d.ts

@@ -0,0 +1,16 @@
+import type { DataCellValue, DataSchema } from '../../../core/index.js';
+/** Parsed `$data.custom` entry with validated definition and normalized row values. */
+export interface CustomDataSpecEntry {
+    /** Column/property schema for a custom data row, used by admin pages and published-data schemas. */
+    readonly definition: DataSchema;
+    /** Optional published-data chunk that receives this entry as an array property. */
+    readonly chunk?: string;
+    /** Ownership mode deciding whether data is manual, externally connected, or admin-generated. */
+    readonly kind: 'manual' | 'connected' | 'generated';
+    /** Optional human-readable label used by inferred admin pages and connected-data UI. */
+    readonly title?: string;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Default rows normalized to the same column order as `definition`. */
+    readonly values?: ReadonlyArray<readonly DataCellValue[]>;
+}

package/dist/domain/spec/sections/data-spec/custom-data-spec-entry.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/data-entry-key.d.ts

@@ -0,0 +1,9 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated `$data` entry key.
+ * This is the stable identifier for a data collection declared under `$data.custom`
+ * or `$data.swatchOptions`. The same key is used when extending published data,
+ * wiring connected/generated admin pages, and linking explicit admin pages through
+ * `connectedDataEntry`.
+ */
+export type DataEntryKey = Branded<'DataEntryKey', string>;

package/dist/domain/spec/sections/data-spec/data-entry-key.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/index.d.ts

@@ -0,0 +1,5 @@
+export type * from './chunks.js';
+export type * from './custom-data-spec-entry.js';
+export type * from './data-entry-key.js';
+export type * from './parsed-data-spec-entries.js';
+export type * from './swatch-data-spec-entry.js';

package/dist/domain/spec/sections/data-spec/index.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/parsed-data-spec-entries.d.ts

@@ -0,0 +1,10 @@
+import type { CustomDataSpecEntry } from './custom-data-spec-entry.js';
+import type { DataEntryKey } from './data-entry-key.js';
+import type { SwatchDataSpecEntry } from './swatch-data-spec-entry.js';
+/** Validated `$data` entries grouped by their source section. */
+export interface ParsedDataSpecEntries {
+    /** Custom data entries with user-declared schemas. */
+    readonly custom: Readonly<Record<DataEntryKey, CustomDataSpecEntry>>;
+    /** Swatch data entries with the built-in swatch schema. */
+    readonly swatchOptions: Readonly<Record<DataEntryKey, SwatchDataSpecEntry>>;
+}

package/dist/domain/spec/sections/data-spec/parsed-data-spec-entries.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/swatch-data-spec-entry.d.ts

@@ -0,0 +1,14 @@
+import type { CellValue } from '@salsita-ai/contracts/webhook';
+/** Parsed `$data.swatchOptions` entry using the fixed swatch data shape. */
+export interface SwatchDataSpecEntry {
+    /** Optional published-data chunk that receives this swatch entry as an array property. */
+    readonly chunk?: string;
+    /** Ownership mode deciding whether swatches are manual, externally connected, or admin-generated. */
+    readonly kind: 'manual' | 'connected' | 'generated';
+    /** Optional human-readable label used by inferred admin pages and connected-data UI. */
+    readonly title?: string;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Default swatch rows normalized to `SWATCH_DEFINITION` column order. */
+    readonly values?: ReadonlyArray<readonly CellValue[]>;
+}

package/dist/domain/spec/sections/data-spec/swatch-data-spec-entry.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/index.d.ts

@@ -0,0 +1,10 @@
+export type * from './actions.js';
+export type * from './app-metadata.js';
+export type * from './application-version.js';
+export * from './assistant/index.js';
+export type * from './data-spec/index.js';
+export * from './infra/index.js';
+export type * from './state-value.js';
+export type * from './theme.js';
+export type * from './transformers.js';
+export type * from './ui.js';

package/dist/domain/spec/sections/index.js

@@ -0,0 +1 @@
+export*from"./assistant/index.js";export*from"./infra/index.js";