@salsita-ai/sdk 0.50.0-develop.b7caacb493 → 0.50.0-develop.b929a82a82

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

@@ -0,0 +1,3 @@
+export { ExpressionRuntime, type ExpressionImplementations, type InvariantImplementations, type MissingExpression, } from './expression-runtime.js';
+export { evaluateStaticMemoEvalPlan, generateMemoEvalPlanRuntime } from './generate-memo-eval-plan-runtime.js';
+export { evaluateReflectionConstants, findReflectionConstants } from './reflection-constants-runtime.js';

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

@@ -0,0 +1 @@
+export{ExpressionRuntime}from"./expression-runtime.js";export{evaluateStaticMemoEvalPlan,generateMemoEvalPlanRuntime}from"./generate-memo-eval-plan-runtime.js";export{evaluateReflectionConstants,findReflectionConstants}from"./reflection-constants-runtime.js";

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

@@ -1,4 +1,5 @@
-import type { ExpressionName, Expressions, MemoEvalPlan } from '../../../parse-application-files/index.js';
+import type { Expressions, MemoEvalPlan } from '../../expressions/index.js';
+import type { ExpressionName } from '../../model/index.js';
 import type { SpecCodeMap } from '../spec-code/index.js';
 /** The self-free `constants:` plans declared on one entity or alias, or `undefined` when it has none. */
 export declare const findReflectionConstants: (expressions: Expressions, entityOrAlias: string) => ReadonlyMap<ExpressionName, MemoEvalPlan> | undefined;

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

@@ -1,7 +1,8 @@
 import { Branded } from '@salsita-ai/common/utils';
-import type { AnyEntityReflections, DomainEntity, DomainEntityReflection } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { Defaults, Invariants } from '../../../parse-application-files/index.js';
+import type { AnyEntityReflections, DomainEntity, DomainEntityReflection } from '../../../core/index.js';
+import type { Invariants } from '../../invariants/index.js';
+import type { Defaults } from '../../model/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 import { type RecipeDefaults } from './recipe-defaults.js';
 import { type StaticViolations } from './static-violations.js';
 interface FactoryDataRuntimeFields {

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

@@ -1,4 +1,4 @@
-import type { Defaults } from '../../../parse-application-files/index.js';
+import type { Defaults } from '../../model/index.js';
 /**
  * The default property values of each entity type, keyed by entity type: what
  * `phx.domain.createRecipe` puts into a new recipe before the caller's overrides. Alias entries are

package/dist/{application-spec/generate-application → domain/spec}/runtime/factory-data/recipe-defaults.js

@@ -1 +1 @@
-import{createMessageDescriptor as e,isEvalMarker as t,isMsgMarker as r}from"../../../core/index.js";let s=(a,i)=>{if(null===a||"object"!=typeof a)return a;if(r(a))return e(a);if(t(a))throw Error(`The default at ${i} is an $eval expression. Defaults are static values; the parser rejects $eval in them, so the spec given to the runtime was not produced by it. Parse the spec again and pass the result.`);return Array.isArray(a)?a.map((e,t)=>s(e,`${i}[${t}]`)):Object.fromEntries(Object.entries(a).map(([e,t])=>[e,s(t,`${i}.${e}`)]))};export const createRecipeDefaults=e=>Object.fromEntries(Object.entries(e.entries).map(([e,t])=>[e,Object.fromEntries(Object.entries(t).map(([t,r])=>[t,s(r,`${e}.${t}`)]))]));
+import{createMessageDescriptor as e,isEvalMarker as t,isMsgMarker as r}from"../../markers/index.js";let s=(a,i)=>{if(null===a||"object"!=typeof a)return a;if(r(a))return e(a);if(t(a))throw Error(`The default at ${i} is an $eval expression. Defaults are static values; the parser rejects $eval in them, so the spec given to the runtime was not produced by it. Parse the spec again and pass the result.`);return Array.isArray(a)?a.map((e,t)=>s(e,`${i}[${t}]`)):Object.fromEntries(Object.entries(a).map(([e,t])=>[e,s(t,`${i}.${e}`)]))};export const createRecipeDefaults=e=>Object.fromEntries(Object.entries(e.entries).map(([e,t])=>[e,Object.fromEntries(Object.entries(t).map(([t,r])=>[t,s(r,`${e}.${t}`)]))]));

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

@@ -1,5 +1,5 @@
-import type { Violation } from '#package/domain';
-import type { Invariants } from '../../../parse-application-files/index.js';
+import type { Violation } from '../../../core/index.js';
+import type { Invariants } from '../../invariants/index.js';
 /**
  * The violation each static invariant of a domain reports when its implementation returns `false`,
  * by entity type or alias and by invariant name. `phx.domain.implementCustomInvariants` closes over

package/dist/{application-spec/generate-application → domain/spec}/runtime/factory-data/static-violations.js

@@ -1 +1 @@
-import{createMessageDescriptor as t}from"../../../core/index.js";export const createStaticViolations=e=>{let i={};for(let[o,r]of Object.entries(e.entries))for(let e of Object.values(r)){if("static"!==e.kind)continue;let r={type:String(e.violationType),severity:e.severity,message:"string"==typeof e.message?e.message:t(e.message),...void 0===e.controlViolationPriority?{}:{controlViolationPriority:e.controlViolationPriority}};i[o]={...i[o],[String(e.name)]:r}}return i};
+import{createMessageDescriptor as t}from"../../markers/index.js";export const createStaticViolations=e=>{let i={};for(let[o,r]of Object.entries(e.entries))for(let e of Object.values(r)){if("static"!==e.kind)continue;let r={type:String(e.violationType),severity:e.severity,message:"string"==typeof e.message?e.message:t(e.message),...void 0===e.controlViolationPriority?{}:{controlViolationPriority:e.controlViolationPriority}};i[o]={...i[o],[String(e.name)]:r}}return i};

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

@@ -1,2 +1,2 @@
-import { ApplicationInstance } from '../../core/index.js';
+import { ApplicationInstance } from '../application/index.js';
 export declare const generateRuntimeInstance: (applicationInstance: ApplicationInstance) => ApplicationInstance;

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

@@ -0,0 +1 @@
+import{ApplicationInstance as n}from"../application/index.js";export const generateRuntimeInstance=e=>n(e.applicationVersion);

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

@@ -0,0 +1,13 @@
+export { ApplicationRuntime, type ApplicationRuntimeResult } from './application-runtime.js';
+export { applicationSpecSlice, type ApplicationSpecSliceModules } from './application-spec-slice.js';
+export { type ApplicationModules, createApplication } from './create-application.js';
+export { generateRuntimeInstance } from './generate-runtime-instance.js';
+export { SpecRuntime } from './spec-runtime.js';
+export * from './expressions/index.js';
+export * from './factory-data/index.js';
+export * from './migrations/index.js';
+export * from './model/index.js';
+export * from './optics/index.js';
+export * from './runtime-reference-store.js';
+export * from './sections/index.js';
+export * from './spec-code/index.js';

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

@@ -0,0 +1 @@
+export{ApplicationRuntime}from"./application-runtime.js";export{applicationSpecSlice}from"./application-spec-slice.js";export{createApplication}from"./create-application.js";export{generateRuntimeInstance}from"./generate-runtime-instance.js";export{SpecRuntime}from"./spec-runtime.js";export*from"./expressions/index.js";export*from"./factory-data/index.js";export*from"./migrations/index.js";export*from"./model/index.js";export*from"./optics/index.js";export*from"./runtime-reference-store.js";export*from"./sections/index.js";export*from"./spec-code/index.js";

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

@@ -1,7 +1,7 @@
 import { Branded } from '@salsita-ai/common/utils';
-import { type AnyEntityReflections, type DomainEntity, type MigrateFunction, type Migration } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
+import { type AnyEntityReflections, type DomainEntity, type MigrateFunction, type Migration } from '../../../core/index.js';
 import type { RuntimeResolvedVersions } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 type AnyEntity = DomainEntity<string>;
 type AnyMigration = Migration<AnyEntity, AnyEntity>;
 /**

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

@@ -0,0 +1 @@
+import e from"lodash-es/isEqual.js";import{Branded as i}from"@salsita-ai/common/utils";import{DomainEntityReflection as t,createMigrateFunction as s}from"../../../core/index.js";let o=e=>"function"==typeof e,r=e=>`migrateToV${e}`,n=e=>{let{resolvedVersions:i,latestEntities:n,migrationModules:l}=e,a={},m={},d=[];for(let e of i.versionedModels){if(e.isLatest)a[e.version]=n;else{let i={};for(let s of e.modelVersion.entitySchemas)i[String(s.entityType)]=new t(String(s.entityType),[s.shapeSchema]);a[e.version]=i}if(void 0===e.migrationFile)continue;let i=r(e.version),s=l[e.migrationFile]?.[i];o(s)?m[e.version]=s:d.push(`${e.migrationFile}#${i}`)}return{modelVersions:a,migrations:m,migrate:s(a,i.latestVersion,m),missingMigrations:d}},l=e=>e.versionedModels.map(e=>({version:e.version,isLatest:e.isLatest,migrationFile:e.migrationFile,schemas:e.isLatest?[]:e.modelVersion.entitySchemas.map(e=>e.shapeSchema)})),a=(i,t)=>i.latestEntities===t.latestEntities&&i.resolvedVersions.latestVersion===t.resolvedVersions.latestVersion&&e(l(i.resolvedVersions),l(t.resolvedVersions))&&i.resolvedVersions.versionedModels.every(e=>void 0===e.migrationFile||i.migrationModules[e.migrationFile]===t.migrationModules[e.migrationFile]);export const MigrationRuntime=(e,t)=>{let s=e.createBuilder(t.referenceScope,{build:n,getKey:()=>"singleton",compare:a}).build({resolvedVersions:t.resolvedVersions,latestEntities:t.latestEntities,migrationModules:t.migrationModules});return i({...s.output,changed:s.changed})};

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

@@ -1,8 +1,9 @@
 import { Branded } from '@salsita-ai/common/utils';
-import { type $DomainEntity, $DomainEntityReflection, DomainBuilder, type DomainEntity, DomainEntityReflection, RawAliasReflection, SchemaReflection } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { Expressions } from '../../../parse-application-files/index.js';
+import { type $DomainEntity, $DomainEntityReflection, type DomainEntity, DomainEntityReflection, RawAliasReflection, SchemaReflection } from '../../../core/index.js';
+import { DomainBuilder } from '../../../domain-builder/index.js';
+import type { Expressions } from '../../expressions/index.js';
 import type { RuntimeDataSchemas, RuntimeModelVersion, RuntimeResolvedVersions } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 import type { SpecCodeMap } from '../spec-code/index.js';
 type AnyEntity = DomainEntity<string>;
 type AnyAliases = Record<string, AnyEntity>;

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

@@ -0,0 +1 @@
+import e from"lodash-es/isEqual.js";import{Branded as t}from"@salsita-ai/common/utils";import{$DomainEntityReflection as s,DomainEntityReflection as a,RawAliasReflection as i,SchemaReflection as n}from"../../../core/index.js";import{DomainBuilder as o}from"../../../domain-builder/index.js";import{evaluateReflectionConstants as r,findReflectionConstants as m}from"../expressions/index.js";let l=e=>({latestVersion:e.resolvedVersions.latestVersion,versionedModels:e.resolvedVersions.versionedModels.map(e=>({version:e.version,key:e.key,isLatest:e.isLatest,migrationFile:e.migrationFile}))}),p=e=>{let t=[];for(let[s,a]of e.expressions.entityExpressions)t.push({entityType:String(s),shapeGroups:a.shapeGroups.map(String),expressionNamesByGroup:a.shapeGroups.map(t=>{let s=e.expressions.expressions.get(t);return{group:String(t),names:s?[...s.keys()].map(String):[]}}),constants:[...m(e.expressions,String(s))??[]].map(([e,t])=>[String(e),t])});return t},d=(t,s)=>{let a,i;return t.code===s.code&&(a=t.domainSpec,i=s.domainSpec,e(a.latestModel.entitySchemas.map(e=>e.shapeSchema),i.latestModel.entitySchemas.map(e=>e.shapeSchema))&&e([...a.latestModel.aliases],[...i.latestModel.aliases])&&e([...a.latestModel.commonTypes],[...i.latestModel.commonTypes])&&e(l(a),l(i))&&e(p(a),p(i)))&&e(t.dataSchemas.publishedData.runtimeSchema,s.dataSchemas.publishedData.runtimeSchema)&&e(t.dataSchemas.sessionData.runtimeSchema,s.dataSchemas.sessionData.runtimeSchema)&&e(t.dataSchemas.frontendData.runtimeSchema,s.dataSchemas.frontendData.runtimeSchema)},S=e=>{let{latestModel:t,resolvedVersions:m,expressions:l}=e.domainSpec,p={};for(let e of t.entitySchemas)p[String(e.entityType)]=new a(String(e.entityType),[e.shapeSchema]);let d={};for(let[e,s]of t.commonTypes){let t=s.runtimeSchema;d[String(e)]=new n(String(e),t)}let S=[...t.aliases],c={},h={};for(let[e,t]of S){let s=t.map(e=>p[String(e)]),a=new i(String(e),s);c[String(e)]=a,h[String(e)]=a.types}let u={};for(let a of t.entityTypes){let t=String(a),i=l.entityExpressions.get(a),n=[];if(i)for(let e of i.shapeGroups){let t=l.expressions.get(e);t&&n.push(...t.keys())}u[t]=new s(t,n,r(l,t,e.code))}let y=S.map(([e])=>String(e)).includes("RootEntity")?"RootEntity":"AnyDomainEntity",g=c[y]?.types??[],f=m.latestVersion,x=e.dataSchemas.publishedData.runtimeSchema,D=e.dataSchemas.sessionData.runtimeSchema,M=e.dataSchemas.frontendData.runtimeSchema,v=o.from(p,h,u,g,f,x,D,M,void 0,!0);return{entities:p,aliasReflections:c,commonTypeReflections:d,aliases:h,$entityReflections:u,rootEntityTypes:g,modelVersion:f,domainBuilder:v}};export const AdminModelRuntime=(e,s,a,i)=>{let n=a.createBuilder("modelRuntime:admin",{build:S,getKey:()=>"singleton",compare:d}).build({domainSpec:e,dataSchemas:s,code:i});return t({...n.output,schemaChanged:n.changed})};

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

@@ -1,8 +1,9 @@
 import { Branded } from '@salsita-ai/common/utils';
-import { type $DomainEntity, $DomainEntityReflection, DomainBuilder, type DomainEntity, DomainEntityReflection, RawAliasReflection, SchemaReflection } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { Expressions } from '../../../parse-application-files/index.js';
+import { type $DomainEntity, $DomainEntityReflection, type DomainEntity, DomainEntityReflection, RawAliasReflection, SchemaReflection } from '../../../core/index.js';
+import { DomainBuilder } from '../../../domain-builder/index.js';
+import type { Expressions } from '../../expressions/index.js';
 import type { RuntimeDataSchemas, RuntimeModelVersion, RuntimeResolvedVersions } from '../../runtime-spec/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 import type { SpecCodeMap } from '../spec-code/index.js';
 type AnyEntity = DomainEntity<string>;
 type AnyAliases = Record<string, AnyEntity>;

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

@@ -0,0 +1 @@
+import e from"lodash-es/isEqual.js";import{Branded as t}from"@salsita-ai/common/utils";import{$DomainEntityReflection as s,DomainEntityReflection as o,RawAliasReflection as i,SchemaReflection as n}from"../../../core/index.js";import{DomainBuilder as r}from"../../../domain-builder/index.js";import{evaluateReflectionConstants as a,findReflectionConstants as m}from"../expressions/index.js";let l=e=>({latestVersion:e.resolvedVersions.latestVersion,versionedModels:e.resolvedVersions.versionedModels.map(e=>({version:e.version,key:e.key,isLatest:e.isLatest,migrationFile:e.migrationFile}))}),p=e=>{let t=[];for(let[s,o]of e.expressions.entityExpressions)t.push({entityType:String(s),shapeGroups:o.shapeGroups.map(String),expressionNamesByGroup:o.shapeGroups.map(t=>{let s=e.expressions.expressions.get(t);return{group:String(t),names:s?[...s.keys()].map(String):[]}}),constants:[...m(e.expressions,String(s))??[]].map(([e,t])=>[String(e),t])});return t};export const isConfiguratorModelSchemaCompatible=(t,s)=>e(t.latestModel.entitySchemas.map(e=>e.shapeSchema),s.latestModel.entitySchemas.map(e=>e.shapeSchema))&&e([...t.latestModel.aliases],[...s.latestModel.aliases])&&e([...t.latestModel.commonTypes],[...s.latestModel.commonTypes])&&e(l(t),l(s))&&e(p(t),p(s))&&e(t.dataSchemas,s.dataSchemas);let d=e=>{let{latestModel:t,resolvedVersions:m,dataSchemas:l,expressions:p}=e.domainSpec,d={};for(let e of t.entitySchemas)d[String(e.entityType)]=new o(String(e.entityType),[e.shapeSchema]);let c={};for(let[e,s]of t.commonTypes){let t=s.runtimeSchema;c[String(e)]=new n(String(e),t)}let S=[...t.aliases],u={},g={};for(let[e,t]of S){let s=t.map(e=>d[String(e)]),o=new i(String(e),s);u[String(e)]=o,g[String(e)]=o.types}let h={};for(let o of t.entityTypes){let t=String(o),i=p.entityExpressions.get(o),n=[];if(i)for(let e of i.shapeGroups){let t=p.expressions.get(e);t&&n.push(...t.keys())}h[t]=new s(t,n,a(p,t,e.code))}let y=S.map(([e])=>String(e)).includes("RootEntity")?"RootEntity":"AnyDomainEntity",f=u[y]?.types??[],x=m.latestVersion,M=l.publishedData.runtimeSchema,b=l.sessionData.runtimeSchema,T=l.frontendData.runtimeSchema,v=l.backendData?.runtimeSchema,C=r.from(d,g,h,f,x,M,b,T,v,!1);return{entities:d,aliasReflections:u,commonTypeReflections:c,aliases:g,$entityReflections:h,rootEntityTypes:f,modelVersion:x,domainBuilder:C}};export const ConfiguratorModelRuntime=(e,s,o)=>{let i=s.createBuilder("modelRuntime:configurator",{build:d,getKey:()=>"singleton",compare:(e,t)=>e.code===t.code&&isConfiguratorModelSchemaCompatible(e.domainSpec,t.domainSpec)}).build({domainSpec:e,code:o});return t({...i.output,schemaChanged:i.changed})};

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

@@ -0,0 +1,2 @@
+export { AdminModelRuntime } from './admin-model-runtime.js';
+export { ConfiguratorModelRuntime, isConfiguratorModelSchemaCompatible } from './configurator-model-runtime.js';

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

@@ -0,0 +1 @@
+export{AdminModelRuntime}from"./admin-model-runtime.js";export{ConfiguratorModelRuntime,isConfiguratorModelSchemaCompatible}from"./configurator-model-runtime.js";

package/dist/domain/spec/runtime/optics/build-sdk-optic.d.ts

@@ -0,0 +1,7 @@
+import { type ComponentEntry, type ComponentImplementation } from '../../components/index.js';
+import type { AdminModelRuntime, ConfiguratorModelRuntime } from '../model/index.js';
+import { type SpecCodeMap } from '../spec-code/index.js';
+import type { ComponentOptic } from './built-component-optic.js';
+export declare const buildSdkOptic: (entry: ComponentEntry, impl: ComponentImplementation & {
+    readonly kind: 'sdk';
+}, aliasMap: Record<string, readonly string[]>, configuratorModel: AdminModelRuntime | ConfiguratorModelRuntime, code: SpecCodeMap | undefined) => ComponentOptic;

package/dist/domain/spec/runtime/optics/build-sdk-optic.js

@@ -0,0 +1 @@
+import{Branded as t}from"@salsita-ai/common/utils";import{createAdminCustomPageRead as e,createAdminCustomSidebarRead as o,createAdminDataPageRead as i,createAdminDataTableSidebarRead as n,createAdminNavigationPanelRead as a,createAdminPresetCategoryPageRead as r,createAdminPresetCategorySelectionRead as s,createAdminPresetCategorySelectionWrite as m,createAdminPresetCategorySidebarRead as c,createAdminPresetListPageRead as p,createAdminPresetSidebarRead as d,createAdminRecipeCollectionPageRead as l,createAdminRecipeSidebarRead as f}from"../../../application/index.js";import{componentsByName as u}from"../../../available-system-components/index.js";import{DomainComponentOpticBuilder as h,composedOfComponent as g,createEmptyWrite as y,createMultipleCompositionRead as w,createMultipleReferenceRead as S,createMultipleReferenceWrite as N,createSingleCompositionRead as v,createSingleReferenceRead as x,createSingleReferenceWrite as A,referenceComponent as b}from"../../../core/index.js";import{adminSidebarComponent as j,attributeSelectionComponent as k,navigationPageComponent as O,navigationPanelListComponent as F}from"../../../system-components/index.js";import{FILTER_CRITERION_KEYS as R,isSdkCodeRef as $}from"../../components/index.js";import{specCodeComponentKey as E,specCodeFilterId as T}from"../../runtime-spec/index.js";import{resolveSpecCode as D}from"../spec-code/index.js";let K=new Map([["reference",b],["composedOf",g],["adminSidebar",j],["attributeSelection",k],["navigationPage",O],["navigationPanelList",F]]),M={createAdminCustomPageRead:e,createAdminCustomSidebarRead:o,createAdminDataPageRead:i,createAdminDataTableSidebarRead:n,createAdminNavigationPanelRead:a,createAdminPresetCategoryPageRead:r,createAdminPresetCategorySelectionRead:s,createAdminPresetCategorySelectionWrite:m,createAdminPresetCategorySidebarRead:c,createAdminPresetListPageRead:p,createAdminPresetSidebarRead:d,createAdminRecipeCollectionPageRead:l,createAdminRecipeSidebarRead:f,createEmptyWrite:y,createMultipleCompositionRead:w,createMultipleReferenceRead:S,createMultipleReferenceWrite:N,createSingleCompositionRead:v,createSingleReferenceRead:x,createSingleReferenceWrite:A},P=(t,e)=>{let o=M[t.sdkFunction];if("function"!=typeof o)throw Error(`SDK factory function "${t.sdkFunction}" not found. The spec names a factory that the factory map of build-sdk-optic.ts does not list. Add the factory to that map.`);return o(...t.params.map(t=>{if($(t)){let o=e.entities[t.$codeRef]??e.aliasReflections[t.$codeRef];if(!o)throw Error(`Reflection "${t.$codeRef}" not found in ModelRuntime. This is a bug — the target was validated at parse time.`);return o}return t}))};export const buildSdkOptic=(e,o,i,n,a)=>{let r=h.from(i),s=u.get(e.componentName)??K.get(e.componentName);if(!s)throw Error(`SDK component "${e.componentName}" not found. This is a bug — the component was validated at parse time.`);let m=r.withComponent(s,e.instanceName,!0),c=e.isAlias?m.withAlias(String(e.typeOrAlias)):m.withEntity(String(e.typeOrAlias)),p=E(String(e.typeOrAlias),String(e.instanceName),e.componentName);for(let[t,e]of o.filters.items.entries()){if("root"===e.kind){let t=e.target,o=e=>e[t];c=c.withFilter(o);continue}let o={};for(let i of R){let n=e[i];void 0!==n&&("dynamic"===n.kind?o[i]=t=>t[n.target]:"eval"===n.kind?o[i]=D(a,T(p,t,i,n.code),n.code):o[i]=n.value)}c=c.withGradualFilter(o)}let d=P(o.readFactory,n),l=P(o.writeFactory,n),f=c.attach(d,l);return t({typeOrAlias:String(e.typeOrAlias),componentName:e.componentName,instanceName:String(e.instanceName),optic:f})};

package/dist/domain/spec/runtime/optics/build-user-bound-optic.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentEntry, ComponentImplementation } from '../../components/index.js';
+import type { AdminModelRuntime, ConfiguratorModelRuntime } from '../model/index.js';
+import { type SpecCodeMap } from '../spec-code/index.js';
+import type { ComponentOptic } from './built-component-optic.js';
+export declare const buildUserBoundOptic: (entry: ComponentEntry, impl: ComponentImplementation & {
+    readonly kind: 'userBound';
+}, model: AdminModelRuntime | ConfiguratorModelRuntime, code: SpecCodeMap | undefined) => ComponentOptic | undefined;

package/dist/domain/spec/runtime/optics/build-user-bound-optic.js

@@ -0,0 +1 @@
+import{match as e}from"ts-pattern";import{Branded as t}from"@salsita-ai/common/utils";import{componentsByName as i}from"../../../available-system-components/index.js";import{DomainComponentOpticBuilder as n,assertBoolean as r,assertNumber as o,assertString as a}from"../../../core/index.js";import{specCodeComponentKey as s,specCodeFilterId as l}from"../../runtime-spec/index.js";import{generateMemoEvalPlanRuntime as m}from"../expressions/index.js";import{resolveSpecCode as d}from"../spec-code/index.js";let p=(e,t,i)=>{if("dynamic"===e.kind){let t=e.target;return e=>e[t]}if("eval"===e.kind){let n=l(i.componentKey,i.branch,t,e.code);return d(i.code,n,e.code)}return e.value},c=(e,t)=>{let i={};for(let[n,r]of Object.entries(e))"kind"!==n&&void 0!==r&&(i[n]=p(r,n,t));return i},f={assertString:a,assertNumber:o,assertBoolean:r},h=(e,t)=>{let i=t.commonTypeReflections[e]??t.entities[e]??t.aliasReflections[e];if(!i)throw Error(`Reflection "${e}" not found in ModelRuntime for write assertion. This is a bug — the type was resolved at parse time.`);return i},u=(e,t)=>{let i=t.entities[e]??t.aliasReflections[e];if(!i)throw Error(`Entity reflection "${e}" not found in ModelRuntime for write assertion. This is a bug — the type was resolved at parse time.`);return i},w=(t,i,n)=>e(t).with({kind:"primitive"},({assertFn:e})=>typeof i==("assertNumber"===e?"number":"assertBoolean"===e?"boolean":"string")).with({kind:"declaredType"},({typeName:e})=>h(e,n).is(i)).with({kind:"declaredTypeId"},({referencedType:e})=>u(e,n).isId(i)).with({kind:"literal"},({value:e})=>i===e).with({kind:"anyOf"},({assertions:e})=>e.some(e=>w(e,i,n))).with({kind:"none"},()=>!0).exhaustive(),y=(t,i,n)=>{e(t).with({kind:"primitive"},({assertFn:e})=>{f[e](i)}).with({kind:"declaredType"},({typeName:e})=>{h(e,n).assert(i)}).with({kind:"declaredTypeId"},({referencedType:e})=>{u(e,n).assertId(i)}).with({kind:"literal"},e=>{if(!w(e,i,n))throw Error(`Expected value to match its declared schema but got ${i}`)}).with({kind:"anyOf"},e=>{if(!w(e,i,n))throw Error(`Expected value to match one of its declared schemas but got ${i}`)}).with({kind:"none"},()=>{}).exhaustive()};export const buildUserBoundOptic=(e,r,o,a)=>{let l,d=(l=o.aliases,n.from(l)),p=i.get(e.componentName);if(!p)return void console.warn(`[ComponentOptic] Unknown component: ${e.componentName}`);let f=d.withComponent(p,e.instanceName,!0),h=e.isAlias?f.withAlias(String(e.typeOrAlias)):f.withEntity(String(e.typeOrAlias)),u=s(String(e.typeOrAlias),String(e.instanceName),e.componentName);for(let[e,t]of r.filters.items.entries()){if("root"===t.kind){let e=t.target,i=t=>t[e];h=h.withFilter(i);continue}h=h.withGradualFilter(c(t,{componentKey:u,branch:e,code:a}))}let w=m(r.plan,u,a),k="composite"===r.implementation.kind?r.implementation.writeBindings:[],g=k.length>0?e=>{let t={};for(let i of k)y(i.assertion,e[i.propKey],o),t[i.entityField]=e[i.propKey];return t}:()=>({}),v=h.attach(w,g);return t({typeOrAlias:String(e.typeOrAlias),componentName:e.componentName,instanceName:String(e.instanceName),optic:v})};

package/dist/domain/spec/runtime/optics/built-component-optic.d.ts

@@ -0,0 +1,11 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { DomainComponentOptic, SystemComponentTypeConstraint } from '../../../core/index.js';
+/** A component optic of any project, for any component type. */
+export type AnyComponentOptic = DomainComponentOptic<any, any, any, any, any, any, SystemComponentTypeConstraint>;
+/** A single built component optic with its identifying metadata. */
+export type ComponentOptic = Branded<'ComponentOptic', {
+    readonly typeOrAlias: string;
+    readonly componentName: string;
+    readonly instanceName: string;
+    readonly optic: AnyComponentOptic;
+}>;

package/dist/domain/spec/runtime/optics/built-component-optic.js

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

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

@@ -1,19 +1,9 @@
 import { Branded } from '@salsita-ai/common/utils';
-import { type DomainComponentOptic, type SystemComponentTypeConstraint } from '#package/domain';
-import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { ComponentEntry } from '../../../parse-application-files/spec/index.js';
-import type { AdminModelRuntime } from '../admin-runtime/admin-model-runtime.js';
-import type { ConfiguratorModelRuntime } from '../configurator-runtime/configurator-model-runtime.js';
+import type { ComponentEntry } from '../../components/index.js';
+import type { AdminModelRuntime, ConfiguratorModelRuntime } from '../model/index.js';
+import type { RuntimeReferenceStore } from '../runtime-reference-store.js';
 import type { SpecCodeMap } from '../spec-code/index.js';
-/** A component optic of any project, for any component type. */
-export type AnyComponentOptic = DomainComponentOptic<any, any, any, any, any, any, SystemComponentTypeConstraint>;
-/** A single built component optic with its identifying metadata. */
-export type ComponentOptic = Branded<'ComponentOptic', {
-    readonly typeOrAlias: string;
-    readonly componentName: string;
-    readonly instanceName: string;
-    readonly optic: AnyComponentOptic;
-}>;
+import type { ComponentOptic } from './built-component-optic.js';
 /** Collection of built component optics with change tracking. */
 export type ComponentOptics = Branded<'ComponentOptics', {
     readonly optics: readonly ComponentOptic[];

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

@@ -0,0 +1,2 @@
+export type { ComponentOptic } from './built-component-optic.js';
+export { ComponentOptics } from './component-optic.js';

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

@@ -0,0 +1 @@
+export{ComponentOptics}from"./component-optic.js";

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{};