@salsita-ai/sdk 0.50.0-develop.85e8f9df39 → 0.50.0-develop.8876e19a19

package/dist/application-spec/generate-application/runtime-spec/runtime-spec.d.ts

@@ -1,48 +1,145 @@
-import type { AdminSpec, ApplicationSpec, ConfiguratorSpec, EntitySchema, Infra, ModelVersion, ResolvedModelVersion, ResolvedVersions } from '../../parse-application-files/index.js';
+import type { Acl, Actions, AdminPages, AdminStates, AppMetadata, AssistantResolvedManifest, Chunks, CommonTypes, Components, ConfiguratorStates, Defaults, EntityOrAliasName, EntityTypeName, EntityTypes, Expressions, Invariants, JsonSchema, ModelVersionKey, ParsedDataSpecEntries, Presets, ResourceEntry, SpecAliases, SpecResourcesConfig, SpecTransformers, Theme, Ui } from '#package/domain';
 /**
  * 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 type RuntimeEntitySchema = Pick<EntitySchema, 'entityType' | 'shapeSchema'>;
+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 raw shapes and resolved shapes only serve the
- * parser and the type generator.
+ * 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 type RuntimeModelVersion = Pick<ModelVersion, 'versionKey' | 'entityTypes' | 'rootEntityTypes' | 'aliases' | 'commonTypes'> & {
+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[];
-};
-/** One model version of a domain as the runtime reads it, with the migration file that leads to it. */
-export type RuntimeResolvedModelVersion = Omit<ResolvedModelVersion, 'modelVersion'> & {
+}
+/**
+ * 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;
-};
-/** Every model version of a domain as the runtime reads it; it builds the domain's migrations from them. */
-export type RuntimeResolvedVersions = Pick<ResolvedVersions, 'latestVersion'> & {
+    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: RuntimeModelVersion;
+    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 type RuntimeConfiguratorSpec = Pick<ConfiguratorSpec, 'components' | 'presets' | 'expressions' | 'actions' | 'invariants' | 'dataSchemas' | 'defaults' | 'states' | 'theme' | 'ui' | 'transformers' | 'assistant'> & RuntimeDomainModel;
+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 type RuntimeAdminSpec = Pick<AdminSpec, 'components' | 'presets' | 'expressions' | 'invariants' | 'defaults' | 'states' | 'adminPages'> & RuntimeDomainModel;
+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 type RuntimeInfra = Pick<Infra, 'acl' | 'resources' | 'resourcesConfig'>;
+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
@@ -50,19 +147,22 @@ export type RuntimeInfra = Pick<Infra, 'acl' | 'resources' | 'resourcesConfig'>;
  * schemas, admin pages). `phoenix sync` and `phoenix build` write it to
  * `.phoenix/application-spec.json` with `encodeRuntimeSpec`.
  *
- * It is derived from the parsed types, so a section the runtime reads keeps the parser's type. 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.
+ * 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 extends Pick<ApplicationSpec, 'appMetadata' | 'dataSpec'> {
+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. The sections it keeps are the
- * parsed values themselves, not copies; only the model versions are rebuilt without what the
- * runtime does not read.
+ * 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: ApplicationSpec) => RuntimeSpec;
+export declare const toRuntimeSpec: (spec: RuntimeSpec) => RuntimeSpec;
 export {};

package/dist/application-spec/generate-application/runtime-spec/runtime-spec.js

@@ -1 +1 @@
-let e=e=>({versionKey:e.versionKey,entityTypes:e.entityTypes,rootEntityTypes:e.rootEntityTypes,aliases:e.aliases,commonTypes:e.commonTypes,entitySchemas:e.entitySchemas.map(e=>({entityType:e.entityType,shapeSchema:e.shapeSchema}))}),s=s=>({latestModel:e(s.latestModel),resolvedVersions:{latestVersion:s.resolvedVersions.latestVersion,versionedModels:s.resolvedVersions.versionedModels.map(s=>({version:s.version,key:s.key,isLatest:s.isLatest,migrationFile:s.migrationFile,modelVersion:e(s.modelVersion)}))}});export const toRuntimeSpec=e=>{let{configurator:t,admin:a,infra:n}=e;return{configurator:{components:t.components,presets:t.presets,expressions:t.expressions,actions:t.actions,invariants:t.invariants,dataSchemas:t.dataSchemas,defaults:t.defaults,states:t.states,theme:t.theme,ui:t.ui,transformers:t.transformers,assistant:t.assistant,...s(t)},admin:{components:a.components,presets:a.presets,expressions:a.expressions,invariants:a.invariants,defaults:a.defaults,states:a.states,adminPages:a.adminPages,...s(a)},appMetadata:e.appMetadata,infra:{acl:n.acl,resources:n.resources,resourcesConfig:n.resourcesConfig},dataSpec:e.dataSpec}};
+let e=e=>({versionKey:e.versionKey,entityTypes:e.entityTypes,rootEntityTypes:e.rootEntityTypes,aliases:e.aliases,commonTypes:e.commonTypes,entitySchemas:e.entitySchemas.map(e=>({entityType:e.entityType,shapeSchema:e.shapeSchema}))}),s=e=>({runtimeSchema:e.runtimeSchema}),a=s=>{let a;return{latestModel:{...e(a=s.latestModel),shapes:new Map([...a.shapes].map(([e,s])=>[e,{name:s.name,runtimeSchema:s.runtimeSchema}]))},resolvedVersions:{latestVersion:s.resolvedVersions.latestVersion,versionedModels:s.resolvedVersions.versionedModels.map(s=>({version:s.version,key:s.key,isLatest:s.isLatest,migrationFile:s.migrationFile,modelVersion:e(s.modelVersion)}))}}};export const toRuntimeSpec=e=>{let t,{configurator:n,admin:i,infra:r}=e;return{configurator:{components:n.components,presets:n.presets,expressions:n.expressions,actions:n.actions,invariants:n.invariants,dataSchemas:{publishedDataHash:(t=n.dataSchemas).publishedDataHash,publishedData:s(t.publishedData),sessionData:s(t.sessionData),frontendData:s(t.frontendData),backendData:t.backendData&&s(t.backendData),finalizeData:s(t.finalizeData),prefetchedFinalizeData:s(t.prefetchedFinalizeData),finalizeResult:s(t.finalizeResult),callbackData:s(t.callbackData)},defaults:n.defaults,states:n.states,theme:n.theme,ui:n.ui,transformers:n.transformers,assistant:n.assistant&&{resolved:n.assistant.resolved},...a(n)},admin:{components:i.components,presets:i.presets,expressions:i.expressions,invariants:i.invariants,defaults:i.defaults,states:i.states,adminPages:i.adminPages,...a(i)},appMetadata:e.appMetadata,infra:{acl:r.acl,resources:r.resources,resourcesConfig:r.resourcesConfig},dataSpec:{entries:e.dataSpec.entries,chunks:e.dataSpec.chunks}}};

package/dist/application-spec/generate-application/runtime-spec/spec-code-id.d.ts

@@ -1,4 +1,4 @@
-import type { MemoEvalPlan } from '../../parse-application-files/index.js';
+import type { MemoEvalPlan } from '#package/domain';
 /**
  * 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/application-spec/parse-application-files/merge/merged-assistant.d.ts

@@ -1,13 +1,22 @@
 import { Branded } from '@salsita-ai/common/utils';
+import type { AssistantAiSettings } from '@salsita-ai/contracts/assistant';
 import type { ParseContext } from '../../core/index.js';
 import type { RawAssistant } from '../raw-spec/index.js';
 import type { ClassifiedSpecFile } from './classified-spec-file.js';
 /**
- * The singular `assistant` manifest after merge, or `null` when no spec file declares one. `origin`
- * names the declaring spec file so manifest diagnostics point at it.
+ * The assistant manifest merged from every spec file that declares an `assistant` block. Each file
+ * may leave `ai` out, but the merged manifest has it: the deployment cannot run its assistant
+ * without the provider, model tier and reasoning level.
+ */
+export type MergedAssistantManifest = RawAssistant & {
+    readonly ai: AssistantAiSettings;
+};
+/**
+ * The `assistant` manifest merged from every spec file that declares an `assistant` block, or `null`
+ * when none does or when none of them declares `ai`. Manifest diagnostics raised after the merge
+ * carry the YAML path but no file, as in every other merged section.
  */
 export type MergedAssistant = Branded<'MergedAssistant', {
-    readonly manifest: RawAssistant | null;
-    readonly origin: string | null;
+    readonly manifest: MergedAssistantManifest | null;
 }>;
 export declare const MergedAssistant: (files: readonly ClassifiedSpecFile[], ctx: ParseContext) => MergedAssistant;

package/dist/application-spec/parse-application-files/merge/merged-assistant.js

@@ -1 +1 @@
-import{Branded as t}from"@salsita-ai/common/utils";import{DiagnosticCode as n,diagnosticMessages as o}from"../../errors/index.js";export const MergedAssistant=(r,i)=>{let s,e=null;for(let t of r)if(void 0!==t.content.assistant){if(s){i.error(n.CONFLICTING_ASSISTANT,o.CONFLICTING_ASSISTANT(s,t.name));continue}s=t.name,e=t.content.assistant}return t({manifest:e,origin:s??null})};
+import{Branded as e}from"@salsita-ai/common/utils";import{DiagnosticCode as t,diagnosticMessages as s}from"../../errors/index.js";let i=(e,i,n,r)=>{let l=i.flatMap(e=>{let t=n(e.manifest);return t?[{file:e.file,entries:t}]:[]});if(0===l.length)return;let a={},o=new Map;for(let{file:i,entries:n}of l)for(let[l,f]of Object.entries(n)){let n=o.get(l);if(n){r.at("assistant",e,l).error(t.ASSISTANT_MERGE_CONFLICT,s.ASSISTANT_MERGE_CONFLICT(e,l,n,i));continue}o.set(l,i),a[l]=f}return a},n=(e,i,n,r)=>{let l,a;for(let o of i){let i=n(o.manifest);if(void 0!==i){if(l){r.at("assistant",e).error(t.DUPLICATE_ASSISTANT_FIELD,s.DUPLICATE_ASSISTANT_FIELD(e,l,o.file));continue}l=o.file,a=i}}return a};export const MergedAssistant=(r,l)=>{let a=r.flatMap(e=>e.content.assistant?[{file:e.name,manifest:e.content.assistant}]:[]);if(0===a.length)return e({manifest:null});let o={entities:i("entities",a,e=>e.entities,l),deletable:i("deletable",a,e=>e.deletable,l),writable:i("writable",a,e=>e.writable,l),childRecipes:i("childRecipes",a,e=>e.childRecipes,l),replaceRecipes:i("replaceRecipes",a,e=>e.replaceRecipes,l),actions:i("actions",a,e=>e.actions,l),screenshots:i("screenshots",a,e=>e.screenshots,l),formElements:i("formElements",a,e=>e.formElements,l),lenses:n("lenses",a,e=>e.lenses,l),instructions:n("instructions",a,e=>e.instructions,l),ai:n("ai",a,e=>e.ai,l)},{ai:f}=o;return f?e({manifest:{...o,ai:f}}):(l.at("assistant","ai").error(t.ASSISTANT_MISSING_AI,s.ASSISTANT_MISSING_AI()),e({manifest:null}))};

package/dist/application-spec/parse-application-files/merge/merged-infra.d.ts

@@ -1,8 +1,7 @@
 import { Branded } from '@salsita-ai/common/utils';
+import type { Acl, ResourceEntry, SpecResourcesConfig } from '#package/domain';
 import type { ParseContext } from '../../core/index.js';
-import type { AclRole } from '../raw-spec/raw-acl.js';
 import type { RawEnvVarEntry } from '../raw-spec/raw-env.js';
-import type { RawResourceEntry } from '../raw-spec/raw-resources.js';
 import type { ClassifiedSpecFile } from './classified-spec-file.js';
 /** Merged infrastructure settings (env, ACL, resources). */
 export type MergedInfra = Branded<'MergedInfra', {
@@ -10,14 +9,8 @@ export type MergedInfra = Branded<'MergedInfra', {
         readonly frontend?: Readonly<Record<string, RawEnvVarEntry>>;
         readonly webhook?: Readonly<Record<string, RawEnvVarEntry>>;
     };
-    readonly acl: {
-        readonly canCreate: readonly AclRole[];
-    };
-    readonly resources?: readonly RawResourceEntry[];
-    readonly resourcesConfig?: {
-        readonly baseResourcesUrl?: string;
-        readonly prefetchTextureUrls?: readonly string[];
-        readonly deploymentQueryDisabled?: boolean;
-    };
+    readonly acl: Acl;
+    readonly resources?: readonly ResourceEntry[];
+    readonly resourcesConfig?: SpecResourcesConfig;
 }>;
 export declare const MergedInfra: (files: readonly ClassifiedSpecFile[], ctx: ParseContext) => MergedInfra;

package/dist/application-spec/parse-application-files/merge/merged-transformers.d.ts

@@ -1,10 +1,8 @@
 import { Branded } from '@salsita-ai/common/utils';
+import type { TransformerEntry } from '#package/domain';
 import type { ParseContext } from '../../core/index.js';
 import type { ClassifiedSpecFile } from './classified-spec-file.js';
-export interface TransformerEntry {
-    readonly name: string;
-    readonly priority?: number;
-}
+export type { TransformerEntry } from '#package/domain';
 /** Merged transformers. The "transformers" section is singular — only one file may declare it. */
 export type MergedTransformers = Branded<'MergedTransformers', readonly TransformerEntry[]>;
 export declare const MergedTransformers: (files: readonly ClassifiedSpecFile[], ctx: ParseContext) => MergedTransformers;

package/dist/application-spec/parse-application-files/parse-application-files.js

@@ -1 +1 @@
-import{Branded as e}from"@salsita-ai/common/utils";import{ParseContext as s}from"../core/index.js";import{CategorizedFiles as t}from"./categorize/index.js";import{MergedSpec as i}from"./merge/index.js";import{RawSpecFiles as r}from"./raw-spec/parse-raw-spec.js";import{RawMockTemplates as p}from"./raw-spec/raw-mock-templates.js";import{ResolvedSpecFiles as a}from"./resolve/index.js";import{ApplicationSpec as o}from"./spec/index.js";export const parseApplicationFiles=(l,n)=>{let{rawProjectFiles:m,phxDefinitions:c}=l,{evalExpressionParser:d,referenceStore:f,parsingContext:F}=n,u=F??new s,S=u.startSpan("parseApplicationFiles","build","parse-application-files.ts"),g=t(m,f,u,n);if(!g)return S(),u.toResult(void 0);let w=u.startSpan("RawSpecFiles","parseApplicationFiles","parse-raw-spec.ts"),A=r(g.spec,u);w();let R=u.startSpan("RawMockTemplates","parseApplicationFiles","raw-mock-templates.ts"),j=p(g.mockTemplates,u);if(R(),!A)return S(),u.toResult(void 0);let v=u.startSpan("ResolvedSpecFiles","parseApplicationFiles","resolved-spec-files.ts"),x=a(A,m,u);v();let k=u.startSpan("MergedSpec","parseApplicationFiles","merged-spec.ts"),M=i(x,u);if(k(),u.hasErrors)return S(),u.toResult(void 0);let T=u.startSpan("ApplicationSpec","parseApplicationFiles","application-spec.ts"),b=o({merged:M,migrationFiles:g.migrations,adminMigrationFiles:g.adminMigrations,transformerFiles:g.transformers.map(e=>e.file.name),phxDefinitions:c,evalExpressionParser:d},u);return(T(),b)?(S(),u.toResult(e({rawProjectFiles:m,categorizedFiles:g,rawMockTemplates:j,applicationSpec:b}))):(S(),u.toResult(void 0))};
+import{Branded as e}from"@salsita-ai/common/utils";import{ParseContext as s}from"../core/index.js";import{DiagnosticCode as t,diagnosticMessages as r}from"../errors/index.js";import{CategorizedFiles as i}from"./categorize/index.js";import{MergedSpec as a}from"./merge/index.js";import{RawSpecFiles as p}from"./raw-spec/parse-raw-spec.js";import{RawMockTemplates as o}from"./raw-spec/raw-mock-templates.js";import{ResolvedSpecFiles as l}from"./resolve/index.js";import{ApplicationSpec as n}from"./spec/index.js";export const parseApplicationFiles=(m,c)=>{let{rawProjectFiles:d,phxDefinitions:f}=m,{evalExpressionParser:u,referenceStore:F,parsingContext:A}=c,g=A??new s,w=g.startSpan("parseApplicationFiles","build","parse-application-files.ts"),R=i(d,F,g,c);if(!R)return w(),g.toResult(void 0);let S=g.startSpan("RawSpecFiles","parseApplicationFiles","parse-raw-spec.ts"),T=p(R.spec,g);S();let j=g.startSpan("RawMockTemplates","parseApplicationFiles","raw-mock-templates.ts"),O=o(R.mockTemplates,g);if(j(),!T)return w(),g.toResult(void 0);let k=g.startSpan("ResolvedSpecFiles","parseApplicationFiles","resolved-spec-files.ts"),v=l(T,d,g);k();let x=g.startSpan("MergedSpec","parseApplicationFiles","merged-spec.ts"),H=a(v,g);if(x(),g.hasErrors)return w(),g.toResult(void 0);let E=g.startSpan("ApplicationSpec","parseApplicationFiles","application-spec.ts"),M=n({merged:H,migrationFiles:R.migrations,adminMigrationFiles:R.adminMigrations,transformerFiles:R.transformers.map(e=>e.file.name),phxDefinitions:f,evalExpressionParser:u},g);return(E(),M)?(!R.hasWebhookEntry&&(M.appMetadata.useAuthHook||M.appMetadata.useClerk)&&g.warning(t.AUTH_WITHOUT_PROJECT_WEBHOOK,r.AUTH_WITHOUT_PROJECT_WEBHOOK()),w(),g.toResult(e({rawProjectFiles:d,categorizedFiles:R,rawMockTemplates:O,applicationSpec:M}))):(w(),g.toResult(void 0))};

package/dist/application-spec/parse-application-files/raw-spec/raw-acl.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-export declare const aclRoles: readonly ['anonymous', 'user', 'admin', 'superadmin'];
-export type AclRole = (typeof aclRoles)[number];
+import { type AclRole } from '#package/domain';
+export { type AclRole, aclRoles } from '#package/domain';
 export type RawAcl = {
     readonly canCreate?: readonly AclRole[];
 };

package/dist/application-spec/parse-application-files/raw-spec/raw-acl.js

@@ -1 +1 @@
-import{z as o}from"zod";export const aclRoles=["anonymous","user","admin","superadmin"];export const rawAclSchema=o.object({canCreate:o.array(o.enum(aclRoles)).optional()});
+import{z as o}from"zod";import{aclRoles as a}from"#package/domain";export{aclRoles}from"#package/domain";export const rawAclSchema=o.object({canCreate:o.array(o.enum(a)).optional()});

package/dist/application-spec/parse-application-files/raw-spec/raw-admin-pages.d.ts

@@ -1,26 +1,5 @@
 import { z } from 'zod';
-export interface RawAdminPages {
-    readonly presets?: boolean | {
-        readonly categoryNavigationState?: string;
-        readonly presetNavigationState?: string;
-    };
-    readonly recipes?: ReadonlyArray<{
-        readonly name: string;
-        readonly navigationState?: string;
-    }>;
-    readonly pages?: ReadonlyArray<{
-        readonly key: string;
-        readonly title: string;
-        readonly icon?: string;
-        readonly navigationState?: string;
-        readonly entity?: string;
-        readonly component?: string;
-        readonly actionsComponent?: string;
-        readonly connectedDataEntry?: string;
-        readonly sidebar?: {
-            readonly title: string;
-            readonly component: string;
-        };
-    }>;
-}
+import type { AdminPagesSection } from '#package/domain';
+/** The `$adminPages` section of an admin spec file as written; see {@link AdminPagesSection} in `domain`. */
+export type RawAdminPages = AdminPagesSection;
 export declare const rawAdminPagesSchema: z.ZodType<RawAdminPages, z.ZodTypeDef, unknown>;

package/dist/application-spec/parse-application-files/raw-spec/raw-assistant.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { type AssistantAiSettings } from '@salsita-ai/contracts/assistant';
-import { ASSISTANT_HINTS } from '#package/domain';
+import { ASSISTANT_HINTS, type AssistantFormAttribute, type AssistantFormRole } from '#package/domain';
 /**
  * One whitelisted field in the assistant manifest. `description` overrides the JSON Schema
  * description of the shape property; `as` exposes the field under a different GraphQL name; `lenses`
@@ -12,6 +12,21 @@ export interface RawAssistantField {
     readonly as?: string;
     readonly lenses?: readonly string[];
 }
+/**
+ * One of the project's own elements of an assistant form, keyed under `assistant.formElements` by
+ * its tag, and implemented by the component a file in `src/elements/` registers under the same name
+ * with `phx.frontend.createAssistantFormElement`. `role` decides the props the component gets, how
+ * the form collects it into the answer and where the prompt lists it, with `description` after its
+ * signature. `attributes` are flat scalars beside the built-in `label`, each a JSON Schema of the
+ * keywords `AssistantFormAttribute` allows, and `required` names those the model must write. An
+ * option or an input that takes a `value` declares it like any other attribute.
+ */
+export interface RawAssistantFormElement {
+    readonly description: string;
+    readonly role: AssistantFormRole;
+    readonly attributes?: Readonly<Record<string, AssistantFormAttribute>>;
+    readonly required?: readonly string[];
+}
 /**
  * One lens of the assistant `lenses` map, keyed by the name the agent spreads it by: a named
  * selection made of the `entities` entries tagged with that name. `description` tells the agent when
@@ -42,12 +57,15 @@ export type AssistantHint = (typeof ASSISTANT_HINTS)[number];
  * system component `componentType` on the entity type. It generates the `<field>Options` edge under
  * `meta`, named by `as` when given, and makes `modify<Type>` reject a value outside the choices
  * unless `validate` is `false`. `allowDryRuns: false` turns the dry-run of the choices off, for
- * fields with too many of them to try out. The component is named explicitly and never inferred from
- * a `$bind`.
+ * fields with too many of them to try out. `componentType` and `instanceName` are given together or
+ * not at all: without them the component is the one `materialSwatch`, `attributeSelection` or
+ * `distanceDimensionSelect` instance on the entity type, or on an alias containing it, that writes
+ * the field through `$bind` or `$write`. Naming it chooses between several such instances, or gives
+ * the agent another list than the user's control shows.
  */
 export interface RawAssistantFieldOptions {
-    readonly componentType: AssistantOptionComponentType;
-    readonly instanceName: string;
+    readonly componentType?: AssistantOptionComponentType;
+    readonly instanceName?: string;
     readonly as?: string;
     readonly validate?: boolean;
     readonly allowDryRuns?: boolean;
@@ -55,30 +73,26 @@ export interface RawAssistantFieldOptions {
 }
 /**
  * One writable field of the assistant `writable` map. An empty entry (`width:` in YAML) declares the
- * stored field writable; `options` links it to the component that holds its choices.
+ * stored field writable, linked to the component that holds its choices when one instance writes it;
+ * `options` sets up that link, and `options: null` declares the field without one.
  */
 export interface RawAssistantWritableField {
-    readonly options?: RawAssistantFieldOptions;
+    readonly options?: RawAssistantFieldOptions | null;
 }
 /**
  * One recipe group of the assistant `childRecipes` or `replaceRecipes` map, keyed by the instance
- * name of a `childEntityRecipes` or a `replaceEntityRecipes` component. `as` is the id the agent addresses the group by, the instance name
- * by default; `description` replaces the component's group description; `allowDryRuns: false` turns
- * the dry-run of the group's recipes off, for groups too large to try out. An empty entry
- * (`cabinets:` in YAML) exposes the group with its defaults.
+ * name of a `childEntityRecipes` or a `replaceEntityRecipes` component. It becomes a field of the
+ * entity type's `<Type>ChildRecipes` or `<Type>ReplaceRecipes` type, named by `as`, the instance
+ * name by default, which is also the id the agent passes to `addChild` or `replaceEntity`.
+ * `description` describes that field; `allowDryRuns: false` turns the dry-run of the group's recipes
+ * off, for groups too large to try out; `hints` say when the agent can reuse what it read. An empty
+ * entry (`cabinets:` in YAML) exposes the group with its defaults.
  */
 export interface RawAssistantRecipeGroup {
     readonly as?: string;
     readonly description?: string;
     readonly allowDryRuns?: boolean;
-}
-/**
- * The recipes of one entity type or alias in the assistant `childRecipes` or `replaceRecipes` map:
- * its recipe groups under `groups`, and the `hints` that hold for the whole edge of the type.
- */
-export interface RawAssistantRecipes {
     readonly hints?: readonly AssistantHint[];
-    readonly groups: Readonly<Record<string, RawAssistantRecipeGroup | null>>;
 }
 /**
  * One entry of the assistant `actions` map, keyed by the name of an action declared under the
@@ -90,6 +104,16 @@ export interface RawAssistantAction {
     readonly description?: string;
     readonly as?: string;
 }
+/**
+ * One view of the assistant `screenshots` map, keyed by the instance name of an `agentScreenshot`
+ * component: it lets the agent take a screenshot of the entity from that view under `meta`.
+ * `description` tells the agent what the view shows; `as` is the name the agent asks for the view
+ * by, the instance name by default.
+ */
+export interface RawAssistantScreenshot {
+    readonly description: string;
+    readonly as?: string;
+}
 /**
  * Experimental assistant manifest authored under the `assistant` root key. `entities` whitelists the
  * stored fields the generated GraphQL schema exposes, keyed by entity type or alias name and then by
@@ -100,8 +124,15 @@ export interface RawAssistantAction {
  * entity type or alias, the `childEntityRecipes` groups whose recipes the agent may list and add
  * with `addChild`. `replaceRecipes` names, per entity type or alias, the `replaceEntityRecipes`
  * groups whose recipes the agent may list and replace the entity by with `replaceEntity`. `actions`
- * names the declared actions the agent may run as custom mutations. Nothing is exposed without an
- * entry. `lenses` declares the named selections that `entities` entries are tagged with.
+ * names the declared actions the agent may run as custom mutations. `screenshots` names, per entity
+ * type or alias, the `agentScreenshot` views the agent may take a screenshot of the entity from.
+ * Nothing is exposed without an entry. `lenses` declares the named selections that `entities`
+ * entries are tagged with, and `formElements` the project's own elements of the forms the agent
+ * asks the user with.
+ *
+ * The manifest can be split across spec files: each section keyed by entity type, action or form
+ * element name merges per key, while `ai`, `instructions` and `lenses` are declared in one file
+ * each, and `ai` in exactly one.
  *
  * `ai` and `instructions` are for the server only: the provider, model tier and reasoning level the
  * deployment's assistant runs with, and the integrator's own guidance for it, appended to the system
@@ -111,11 +142,15 @@ export interface RawAssistant {
     readonly entities?: Readonly<Record<string, Readonly<Record<string, RawAssistantField | null>>>>;
     readonly deletable?: Readonly<Record<string, RawAssistantDeletable | null>>;
     readonly writable?: Readonly<Record<string, Readonly<Record<string, RawAssistantWritableField | null>>>>;
-    readonly childRecipes?: Readonly<Record<string, RawAssistantRecipes>>;
-    readonly replaceRecipes?: Readonly<Record<string, RawAssistantRecipes>>;
+    readonly childRecipes?: Readonly<Record<string, Readonly<Record<string, RawAssistantRecipeGroup | null>>>>;
+    readonly replaceRecipes?: Readonly<Record<string, Readonly<Record<string, RawAssistantRecipeGroup | null>>>>;
     readonly actions?: Readonly<Record<string, RawAssistantAction | null>>;
+    readonly screenshots?: Readonly<Record<string, Readonly<Record<string, RawAssistantScreenshot>>>>;
     readonly lenses?: Readonly<Record<string, RawAssistantLens>>;
+    readonly formElements?: Readonly<Record<string, RawAssistantFormElement>>;
     readonly instructions?: string;
-    readonly ai: AssistantAiSettings;
+    readonly ai?: AssistantAiSettings;
 }
+/** A GraphQL name the schema may use for a field or type: letters, digits and `_`, not starting with a digit or `__`. */
+export declare const GRAPHQL_NAME_PATTERN: RegExp;
 export declare const rawAssistantSchema: z.ZodType<RawAssistant>;

package/dist/application-spec/parse-application-files/raw-spec/raw-assistant.js

@@ -1 +1 @@
-import{z as e}from"zod";import{ASSISTANT_AI_PROVIDERS as t,ASSISTANT_MODEL_TIERS as o,ASSISTANT_REASONING_LEVELS as i}from"@salsita-ai/contracts/assistant";import{ASSISTANT_HINTS as n}from"#package/domain";export const ASSISTANT_OPTION_COMPONENT_TYPES=["materialSwatch","attributeSelection","distanceDimensionSelect"];let r=e.string().regex(/^(?!__)[_A-Za-z][_0-9A-Za-z]*$/,'must be a GraphQL name: letters, digits and "_", not starting with a digit or "__"'),s=t=>e.enum(t,{errorMap:()=>({message:`must be one of: ${t.join(", ")}`})}),a=e.object({description:e.string().optional(),as:r.optional(),lenses:e.array(e.string()).optional()}).strict(),l="must be a whole number of at least 1; remove the key to nest tagged relations one level",c=e.object({description:e.string().trim().min(1,"must not be empty; say when the agent should use the lens"),maxDepth:e.number({invalid_type_error:l}).int(l).min(1,l).optional()}).strict(),p=r.refine(e=>!e.includes("__"),'must not contain "__", which names the generated copies of a lens'),m=e.array(s(n)),d=e.object({options:e.object({componentType:s(ASSISTANT_OPTION_COMPONENT_TYPES),instanceName:e.string().min(1,"must not be empty; name the component instance that holds the choices"),as:r.optional(),validate:e.boolean().optional(),allowDryRuns:e.boolean().optional(),hints:m.optional()}).strict().optional()}).strict(),u=e.object({as:e.string().trim().min(1,"must not be empty; remove the key to use the instance name").optional(),description:e.string().optional(),allowDryRuns:e.boolean().optional()}).strict(),h=t=>e.object({hints:m.optional(),groups:e.record(e.string(),u.nullable(),{required_error:`is required: the recipe groups of the type go under "groups", keyed by the instance name of a "${t}" component`})}).strict(),b=e.object({description:e.string().optional(),as:r.optional()}).strict(),g=`is required: declare provider (${t.join(", ")}), model (${o.join(", ")}) and reasoning (${i.join(", ")})`,_="must be a positive whole number of input tokens; remove the key to use the default of the server",y=e.object({provider:s(t),model:s(o),reasoning:s(i),maxThreadSize:e.number({invalid_type_error:_}).int(_).positive(_).optional()},{required_error:g,invalid_type_error:g}).strict();export const rawAssistantSchema=e.object({entities:e.record(e.string(),e.record(e.string(),a.nullable())).optional(),deletable:e.record(e.string(),e.object({}).strict().nullable()).optional(),writable:e.record(e.string(),e.record(e.string(),d.nullable())).optional(),childRecipes:e.record(e.string(),h("childEntityRecipes")).optional(),replaceRecipes:e.record(e.string(),h("replaceEntityRecipes")).optional(),actions:e.record(e.string(),b.nullable()).optional(),lenses:e.record(p,c).optional(),instructions:e.string().trim().min(1,"must not be empty; remove the key when there are no instructions").optional(),ai:y}).strict();
+import{z as e}from"zod";import{ASSISTANT_AI_PROVIDERS as t,ASSISTANT_MODEL_TIERS as o,ASSISTANT_REASONING_LEVELS as n}from"@salsita-ai/contracts/assistant";import{ASSISTANT_FORM_NAME_PATTERN as i,ASSISTANT_HINTS as r}from"#package/domain";export const ASSISTANT_OPTION_COMPONENT_TYPES=["materialSwatch","attributeSelection","distanceDimensionSelect"];export const GRAPHQL_NAME_PATTERN=/^(?!__)[_A-Za-z][_0-9A-Za-z]*$/;let a=e.string().regex(GRAPHQL_NAME_PATTERN,'must be a GraphQL name: letters, digits and "_", not starting with a digit or "__"'),s=t=>e.enum(t,{errorMap:()=>({message:`must be one of: ${t.join(", ")}`})}),l=e.object({description:e.string().optional(),as:a.optional(),lenses:e.array(e.string()).optional()}).strict(),m="must be a whole number of at least 1; remove the key to nest tagged relations one level",p=e.object({description:e.string().trim().min(1,"must not be empty; say when the agent should use the lens"),maxDepth:e.number({invalid_type_error:m}).int(m).min(1,m).optional()}).strict(),c=a.refine(e=>!e.includes("__"),'must not contain "__", which names the generated copies of a lens'),u=e.array(s(r)),d=e.object({options:e.object({componentType:s(ASSISTANT_OPTION_COMPONENT_TYPES).optional(),instanceName:e.string().min(1,"must not be empty; name the component instance that holds the choices").optional(),as:a.optional(),validate:e.boolean().optional(),allowDryRuns:e.boolean().optional(),hints:u.optional()}).strict().refine(({componentType:e,instanceName:t})=>void 0===e==(void 0===t),'must give "componentType" and "instanceName" together, or neither to use the one option component instance that writes the field').nullable().optional()}).strict(),g=e.object({as:a.optional(),description:e.string().optional(),allowDryRuns:e.boolean().optional(),hints:u.optional()},{errorMap:(t,o)=>({message:t.code===e.ZodIssueCode.unrecognized_keys?`${o.defaultError}. A recipe group takes "as", "description", "allowDryRuns" and "hints"; the groups of a type go directly under it, keyed by instance name, with no "groups" level`:o.defaultError})}).strict(),h=e.object({description:e.string().optional(),as:a.optional()}).strict(),b=["enum","pattern","minimum","maximum","minLength","maxLength"],y=["enum","pattern","minLength","maxLength"],f=["enum","minimum","maximum"],_=e.object({type:s(["string","number","integer","boolean"]),enum:e.array(e.union([e.string(),e.number()])).min(1,"must list at least one value").optional(),pattern:e.string().refine(e=>{try{return RegExp(e,"u"),!0}catch{return!1}},"must be a regular expression, as in JSON Schema").optional(),minimum:e.number().optional(),maximum:e.number().optional(),minLength:e.number().int().nonnegative().optional(),maxLength:e.number().int().nonnegative().optional()}).strict().superRefine((t,o)=>{let n="string"===t.type?y:"boolean"===t.type?[]:f;for(let i of b)void 0===t[i]||n.includes(i)||o.addIssue({code:e.ZodIssueCode.custom,path:[i],message:`does not apply to an attribute of type "${t.type}"; remove it or change the type`});let i="string"===t.type?"string":"number";for(let[n,r]of("boolean"!==t.type&&t.enum?.some(e=>typeof e!==i||"integer"===t.type&&!Number.isInteger(e))&&o.addIssue({code:e.ZodIssueCode.custom,path:["enum"],message:`must list only ${"integer"===t.type?"whole number":i}s, since the attribute is of type "${t.type}"`}),[["minimum","maximum"],["minLength","maxLength"]])){let[i,a]=[t[n],t[r]];void 0!==i&&void 0!==a&&i>a&&o.addIssue({code:e.ZodIssueCode.custom,path:[n],message:`must not be greater than "${r}", or no value could satisfy the attribute`})}}),v=e.string().regex(i,'must start with a lowercase letter and hold only lowercase letters, digits and "-", since the panel reads form markup in lowercase'),w=e.object({description:e.string().trim().min(1,"must not be empty; say what the element is for and where the agent may use it"),role:s(["group","choice","choices","option","input"]),attributes:e.record(v,_).optional(),required:e.array(e.string()).optional()}).strict(),j=e.object({description:e.string().trim().min(1,"must not be empty; say what the view shows"),as:a.optional()}).strict(),x=`must be an object: declare provider (${t.join(", ")}), model (${o.join(", ")}) and reasoning (${n.join(", ")})`,T="must be a positive whole number of input tokens; remove the key to use the default of the server",N=e.object({provider:s(t),model:s(o),reasoning:s(n),maxThreadSize:e.number({invalid_type_error:T}).int(T).positive(T).optional()},{invalid_type_error:x}).strict();export const rawAssistantSchema=e.object({entities:e.record(e.string(),e.record(e.string(),l.nullable())).optional(),deletable:e.record(e.string(),e.object({}).strict().nullable()).optional(),writable:e.record(e.string(),e.record(e.string(),d.nullable())).optional(),childRecipes:e.record(e.string(),e.record(e.string(),g.nullable())).optional(),replaceRecipes:e.record(e.string(),e.record(e.string(),g.nullable())).optional(),actions:e.record(e.string(),h.nullable()).optional(),screenshots:e.record(e.string(),e.record(e.string(),j)).optional(),lenses:e.record(c,p).optional(),formElements:e.record(v,w).optional(),instructions:e.string().trim().min(1,"must not be empty; remove the key when there are no instructions").optional(),ai:N.optional()}).strict();

package/dist/application-spec/parse-application-files/raw-spec/raw-expressions.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
+import { type EnhancedJsonValue } from '#package/domain';
 import { type EnhancedJsonSchemaType } from '../../core/enhanced-json-schema.js';
-import { type EnhancedJsonValue } from '../../core/enhanced-json-value.js';
 /**
  * Discriminator tag for a single parsed expression entry.
  *

package/dist/application-spec/parse-application-files/raw-spec/raw-expressions.js

@@ -1 +1 @@
-import{z as r}from"zod";import{enhancedJsonSchema as e,extendEnhancedJsonSchema as s}from"../../core/enhanced-json-schema.js";import{EVAL_MARKER_KEY as n,evalMarkerSchema as o}from"../../core/markers/eval-marker.js";import{MSG_ID_MARKER_KEY as a,MSG_MARKER_KEY as t,msgMarkerSchema as i}from"../../core/markers/msg-marker.js";export const RawExpressionKind={User:"user",Value:"value"};let m=s(o),c=s(i),d=[n,t,a],l=r=>{let e={};for(let[s,n]of Object.entries(r))d.includes(s)||(e[s]=n);return e};export const rawExpressionEntrySchema=r.union([m,c,e]).transform(r=>{if(n in r)return{kind:RawExpressionKind.Value,constant:!1,value:{[n]:r.$eval},schema:l(r)};if(t in r){let e=void 0!==r.$msgId?{[t]:r.$msg,[a]:r.$msgId}:{[t]:r.$msg};return{kind:RawExpressionKind.Value,constant:!1,value:e,schema:l(r)}}return{kind:RawExpressionKind.User,schema:r}});export const rawExpressionsSchema=r.record(r.string(),r.record(r.string(),rawExpressionEntrySchema).readonly()).readonly();
+import{z as e}from"zod";import{EVAL_MARKER_KEY as r,MSG_ID_MARKER_KEY as n,MSG_MARKER_KEY as s,evalMarkerSchema as o,msgMarkerSchema as a}from"#package/domain";import{enhancedJsonSchema as i,extendEnhancedJsonSchema as t}from"../../core/enhanced-json-schema.js";export const RawExpressionKind={User:"user",Value:"value"};let c=t(o),m=t(a),d=[r,s,n],p=e=>{let r={};for(let[n,s]of Object.entries(e))d.includes(n)||(r[n]=s);return r};export const rawExpressionEntrySchema=e.union([c,m,i]).transform(e=>{if(r in e)return{kind:RawExpressionKind.Value,constant:!1,value:{[r]:e.$eval},schema:p(e)};if(s in e){let r=void 0!==e.$msgId?{[s]:e.$msg,[n]:e.$msgId}:{[s]:e.$msg};return{kind:RawExpressionKind.Value,constant:!1,value:r,schema:p(e)}}return{kind:RawExpressionKind.User,schema:e}});export const rawExpressionsSchema=e.record(e.string(),e.record(e.string(),rawExpressionEntrySchema).readonly()).readonly();