@salsita-ai/sdk 0.0.0-stage → 0.49.0-develop.cbee856178

package/dist/application-spec/parse-application-files/spec/sections/assistant/assistant-schema.js

@@ -0,0 +1 @@
+import{GraphQLBoolean as e,GraphQLID as t,GraphQLInputObjectType as n,GraphQLInterfaceType as i,GraphQLList as r,GraphQLNonNull as o,GraphQLObjectType as s,GraphQLSchema as a,GraphQLString as p,getNullableType as l,isInputType as d,printSchema as c,validateSchema as h}from"graphql";import{DiagnosticCode as f,diagnosticMessages as y}from"../../../../errors/index.js";import{ASSISTANT_HINTS as u}from"../../../raw-spec/index.js";import{GraphQLJSON as g,assistantFieldType as m,createAssistantRefResolver as S}from"./assistant-field-type.js";let T="AnyDomainEntity",w="RootEntity",N="RecipeGroup",E="Recipe",A="RecipeDryRun",_="RecipeDryRunError",I="FieldOption",O={section:"childRecipes",component:"childEntityRecipes",mutation:"addChild"},v={section:"replaceRecipes",component:"replaceEntityRecipes",mutation:"replaceEntity"},b=new Set(["id","type","meta"]),$=new Set(["Query","Mutation","Navigation",N,E,A,_,I,"JSON","String","Int","Float","Boolean","ID"]),R=(e,t)=>{if(!t||0===t.length)return e;let n=`One of: ${t.map(e=>`"${e}"`).join(", ")}.`;return e?/[.!?]$/.test(e)?`${e} ${n}`:`${e}. ${n}`:n},M=new Set(["id","type"]),j="The raw stored value: a string, a message descriptor or a multilingual object.",D=(e,t)=>Object.entries(e).find(([e])=>e===t)?.[1],P=(e,t,{model:n,components:i})=>{let r=new Set([e,...[...n.aliases].filter(([,t])=>t.includes(e)).map(([e])=>e)]);return i.filter(({componentName:e,typeOrAlias:n})=>e===t&&r.has(n)).map(({instanceName:e})=>String(e))},U=(...e)=>u.filter(t=>e.some(e=>e?.includes(t))),C=(e,t,n,i)=>{let{model:r}=n,o=new Map,s=new Map;for(let[a,{groups:p,hints:l}]of Object.entries(e)){let e=r.entityTypes.find(e=>e===a),d=e?[e]:[...r.aliases].find(([e])=>e===a)?.[1];if(!d){i.at(a).error(f.ASSISTANT_UNKNOWN_TYPE,y.ASSISTANT_UNKNOWN_TYPE(t.section,a));continue}for(let[e,r]of(d.forEach(e=>s.set(e,U(s.get(e),l))),Object.entries(p))){let s=i.at(a,"groups",e),p=`${a}.groups.${e}`,l={groupId:r?.as??e,instanceName:e,...r?.description===void 0?{}:{description:r.description},dryRuns:r?.allowDryRuns??!0};for(let i of d){let r=P(i,t.component,n),d=o.get(i)??[],c=d.find(e=>e.group.groupId===l.groupId);r.includes(e)?c?s.error(f.ASSISTANT_DUPLICATE_RECIPE_GROUP,y.ASSISTANT_DUPLICATE_RECIPE_GROUP(t,i,l.groupId,[c.entry,p])):o.set(i,[...d,{group:l,entry:p,entryCtx:s}]):s.error(f.ASSISTANT_UNKNOWN_RECIPE_GROUP,y.ASSISTANT_UNKNOWN_RECIPE_GROUP(t,a,e,i,r))}}}let a=r.entityTypes.flatMap(e=>{let t=o.get(e);return t?[{entityType:e,groups:t}]:[]});return{groups:Object.fromEntries(a.map(({entityType:e,groups:t})=>[e,t.map(({group:e})=>e)])),hints:s,metaEntries:new Map(a.flatMap(({entityType:e,groups:[t]})=>t?[[e,t.entryCtx]]:[]))}},k=e=>`${e}Meta`,W={sameForAllInstances:e=>`All ${e} instances have the same recipe groups and recipes.`,stable:()=>"They do not change during the session."},L={sameForAllInstances:e=>`All ${e} instances have the same options.`,stable:()=>"The options do not change during the session."},F=(e,t,n)=>e.map(e=>` ${t[e](n)}`).join(""),K=({section:e},{groups:t,hints:n},{entityType:i,purpose:s,recipeGroup:a})=>{let p=t.filter(({dryRuns:e})=>!e).map(({groupId:e})=>e);return 0===t.length?{}:{[e]:{type:new o(new r(new o(a))),description:`The recipe groups for ${s} this ${i}: ${t.map(({groupId:e})=>e).join(", ")}. A group is listed only while the configurator offers it on the entity.${p.length>0?` Recipes of these groups cannot be dry-run: ${p.join(", ")}.`:""}${F(n,W,i)}`}}},G=({entityType:e,childRecipes:t,replaceRecipes:n,optionsEdges:i},{recipeGroup:a,fieldOption:p})=>new s({name:k(e),fields:Object.assign(K(O,t,{entityType:e,purpose:"adding children to",recipeGroup:a}),K(v,n,{entityType:e,purpose:"replacing",recipeGroup:a}),...i.map(({options:{edgeName:t,field:n,validate:i},hints:s})=>({[t]:{type:new r(new o(p)),description:`The values "${n}" of this ${e} can take, as the configurator offers them in the current state of the entity. Null when the configurator does not offer a choice on this entity. ${i?`modify${e} rejects a "${n}" value that is not in the list.`:`modify${e} does not check "${n}" against the list.`}${F(s,L,e)}`}})))}),Y=e=>Object.entries(e).map(([e,t])=>`${e} (${t.map(({groupId:e})=>e).join(", ")})`),V=(e,t)=>{let{type:n,enumValues:i,localized:r,description:o}=m(e,t);return{type:{kind:"value",type:n},localized:!0===r,description:o,enumValues:i}},x=(e,t,n,i,r)=>{let o=t.startsWith("$")?((e,t,n,i)=>{let r=((e,t,{expressions:n,entityTypes:i})=>{let r=i.find(t=>t===e);for(let i of void 0===r?[e]:n.entityExpressions.get(r)?.shapeGroups??[]){let e=[...n.expressions.get(i)?.values()??[]].find(e=>e.name===t);if(e?.declaredSchema)return{implementation:e.implementation,declaredSchema:e.declaredSchema}}})(e.name,t,n);if(!r)return void i.error(f.ASSISTANT_UNKNOWN_FIELD,y.ASSISTANT_UNKNOWN_FIELD("entities",e.name,t));let{implementation:o}=r;if("violations"===o.kind)return void i.error(f.ASSISTANT_UNSUPPORTED_EXPRESSION,y.ASSISTANT_UNSUPPORTED_EXPRESSION(e.name,t));if("relation"===o.kind){let[{target:e,cardinality:t}]=o.params;return{type:{kind:"edge",target:e,cardinality:t},localized:!1,description:void 0}}return V(r.declaredSchema,n.resolveRef)})(e,t,i,r):((e,t,{resolveRef:n},i)=>{let r=Object.entries(e.shape.properties).find(([e])=>e===t)?.[1];return r?V(r,n):void i.error(f.ASSISTANT_UNKNOWN_FIELD,y.ASSISTANT_UNKNOWN_FIELD("entities",e.name,t))})(e,t,i,r);if(!o)return;let s=n?.as??(t.startsWith("$")?`_${t.slice(1)}`:t);return b.has(s)?void r.error(f.ASSISTANT_RESERVED_FIELD_NAME,y.ASSISTANT_RESERVED_FIELD_NAME(e.name,t,s)):{name:s,source:t,type:o.type,localized:o.localized,description:R(n?.description??o.description,o.enumValues),describedByManifest:n?.description!==void 0}},B=(e,t,n,i)=>{let r=new Map,o=new Set(n);for(let s of[...t.flat(),...n]){let t=r.get(s.name);t?t.source!==s.source?i.error(f.ASSISTANT_FIELD_NAME_CONFLICT,y.ASSISTANT_FIELD_NAME_CONFLICT(e,s.name,[t.source,s.source])):o.has(s)&&s.describedByManifest&&r.set(s.name,{...t,description:s.description,describedByManifest:!0}):r.set(s.name,s)}return[...r.values()]},q=({target:e,cardinality:t},n)=>{let i=n(e);switch(t){case"1-1":return new o(i);case"0-1":return i;case"0-N":case"1-N":return new o(new r(new o(i)))}},z=(e,n,i)=>{let r={id:{type:new o(t),description:i?`Unique id of the entity, e.g. "${i}-1".`:void 0},type:{type:new o(p),description:i?`Entity type name, e.g. "${i}".`:void 0}};for(let t of e)r[t.name]={type:"edge"===t.type.kind?q(t.type,n):t.type.type,description:t.description};return r},H=e=>Object.fromEntries(e.map(({name:e,source:t,localized:n})=>[e,n?{source:t,localized:!0}:{source:t}]));export const createAssistantSchema=(u,{model:b,states:W,phxDefinitions:L,expressions:F,components:K},V)=>{let q,Q,X,J,Z=V.errors.length,ee=V.at("entities"),et=S(b.commonTypes,L),en=b.rootEntityTypes[0]??b.entityTypes[0];for(let e of b.resolvedShapes.keys())$.has(e)&&V.error(f.ASSISTANT_RESERVED_TYPE_NAME,y.ASSISTANT_RESERVED_TYPE_NAME(e,[...$]));let ei=((e,t,n)=>{let i=new Map;for(let r of e){let e=[];for(let[i,o]of Object.entries(r.entries)){let s=x(r,i,o,t,n.at(r.name,i));s&&e.push(s)}i.set(r.name,e)}return i})(((e,t,n)=>{let i=[];for(let[n,r]of t.resolvedShapes){let t=e[n];t&&i.push({name:n,shape:r,entries:t})}let r=new Set(t.resolvedShapes.keys());for(let t of Object.keys(e))r.has(t)||n.at(t).error(f.ASSISTANT_UNKNOWN_TYPE,y.ASSISTANT_UNKNOWN_TYPE("entities",t));return i})(u.entities??{},b,ee),{resolveRef:et,expressions:F,entityTypes:b.entityTypes},ee),er=B(T,[],ei.get(T)??[],V),eo=new Map,es=C(u.childRecipes??{},O,{model:b,components:K},V.at(O.section)),ea=C(u.replaceRecipes??{},v,{model:b,components:K},V.at(v.section)),ep=es.groups,el=ea.groups,ed=new Map,ec=e=>{let[t,...n]=[...b.aliases].find(([t])=>t===e)?.[1]??[];return(t&&0===n.length?eo.get(t):void 0)??ey.get(e)??ef},eh=e=>eo.get(e)??ec(e),ef=new i({name:T,description:"Every domain entity.",fields:()=>z(er,eh,en)}),ey=new Map([[T,ef]]),eu=new Map([[T,er]]);for(let e of b.aliases.keys()){if(e===T)continue;let t=B(e,[er],ei.get(e)??[],V);eu.set(e,t),ey.set(e,new i({name:e,interfaces:[ef],fields:()=>z(t,eh)}))}let eg={};for(let e of b.entityTypes){let t=[T,...[...b.aliases].filter(([t,n])=>t!==T&&n.includes(e)).map(([e])=>e)],n=B(e,t.map(e=>eu.get(e)??[]),ei.get(e)??[],V);eg[e]=H(n),eo.set(e,new s({name:e,interfaces:t.flatMap(e=>ey.get(e)??[]),fields:()=>{let t=ed.get(e);return{...z(n,eh),...t?{meta:{type:new o(t),description:"What the configurator offers on this entity besides its fields."}}:{}}}}))}let em=((e,t,n)=>{let i=new Set;for(let r of Object.keys(e)){let e=t.entityTypes.find(e=>e===r),o=e?[e]:[...t.aliases].find(([e])=>e===r)?.[1];o?o.forEach(e=>i.add(e)):n.at(r).error(f.ASSISTANT_UNKNOWN_TYPE,y.ASSISTANT_UNKNOWN_TYPE("deletable",r))}return t.entityTypes.filter(e=>i.has(e))})(u.deletable??{},b,V.at("deletable")),eS=((e,t,n)=>{let{model:i}=t,r=((e,t,n)=>{let i=new Map;for(let[r,o]of Object.entries(e)){let e=t.entityTypes.find(e=>e===r),s=e?[e]:[...t.aliases].find(([e])=>e===r)?.[1],a=[...t.resolvedShapes].find(([e])=>e===r)?.[1];if(!s||!a){n.at(r).error(f.ASSISTANT_UNKNOWN_TYPE,y.ASSISTANT_UNKNOWN_TYPE("writable",r));continue}for(let e of Object.keys(o)){let t=n.at(r,e);e.startsWith("$")||M.has(e)?t.error(f.ASSISTANT_NOT_WRITABLE,y.ASSISTANT_NOT_WRITABLE(r,e)):D(a.properties,e)?s.forEach(t=>{let n=i.get(t)??new Map;i.set(t,n.has(e)?n:n.set(e,r))}):t.error(f.ASSISTANT_UNKNOWN_FIELD,y.ASSISTANT_UNKNOWN_FIELD("writable",r,e))}}return i})(e,i,n);return i.entityTypes.flatMap(e=>{let o=[...i.resolvedShapes].find(([t])=>t===e)?.[1],s=[...r.get(e)??[]].flatMap(([i,r])=>{let s=o&&D(o.properties,i);return(s&&((e,{property:t,writableKey:n},i,{resolveRef:r,exposed:o,sources:s},a)=>{let p=Object.entries(D(s,e)??{}),c=o.get(e)?.find(({source:e})=>e===t)?.name??p.find(([,{source:e}])=>e===t)?.[0],h=void 0===c?p.find(([e])=>e===t)?.[1]:void 0;if(h)return void a.at(n,t).error(f.ASSISTANT_FIELD_NAME_CONFLICT,y.ASSISTANT_FIELD_NAME_CONFLICT(e,t,[h.source,t],`${n}.${t}`));let{type:u,enumValues:S,localized:T,description:w}=m(i,r),N=l(u),E=c??t,A=void 0===c?R(w,S):void 0;return T?{name:E,property:t,type:g,description:A?`${A} ${j}`:j}:{name:E,property:t,type:d(N)?N:g,description:A}})(e,{property:i,writableKey:r},s,t,n))??[]});return s.length>0?[{entityType:e,fields:s}]:[]})})(u.writable??{},{model:b,resolveRef:et,exposed:ei,sources:eg},V.at("writable")),eT=((e,t,n,i)=>{let{model:r}=n,o=new Map;for(let[s,a]of Object.entries(e)){let e=r.entityTypes.find(e=>e===s),p=e?[e]:[...r.aliases].find(([e])=>e===s)?.[1]??[];for(let[e,r]of Object.entries(a)){let a=r?.options;if(!a)continue;let l=i.at(s,e,"options"),d=`${s}.${e}`;for(let i of p){let r=t.find(e=>e.entityType===i)?.fields.find(t=>t.property===e);if(!r)continue;let s=a.as??`${r.name}Options`,p=P(i,a.componentType,n),c=o.get(i)??[],h=c.find(e=>e.options.edgeName===s||e.options.field===r.name);if(p.includes(a.instanceName))if(s===O.section||s===v.section)l.error(f.ASSISTANT_RESERVED_OPTIONS_EDGE_NAME,y.ASSISTANT_RESERVED_OPTIONS_EDGE_NAME(d,s,r.name));else if(h)l.error(f.ASSISTANT_DUPLICATE_OPTIONS_EDGE,y.ASSISTANT_DUPLICATE_OPTIONS_EDGE(i,h.options.edgeName===s?{edgeName:s}:{field:r.name},[h.entry,d]));else{let e={field:r.name,edgeName:s,componentType:a.componentType,instanceName:a.instanceName,validate:a.validate??!0};o.set(i,[...c,{options:e,hints:U(a.hints),entry:d,entryCtx:l}])}else l.error(f.ASSISTANT_UNKNOWN_OPTIONS_COMPONENT,y.ASSISTANT_UNKNOWN_OPTIONS_COMPONENT(d,a,i,p))}}}return o})(u.writable??{},eS,{model:b,components:K},V.at("writable"));var ew,eN,eE,eA=[es.metaEntries,ea.metaEntries,new Map([...eT].flatMap(([e,[t]])=>t?[[e,t.entryCtx]]:[]))];for(let e of b.entityTypes){let t=eA.flatMap(t=>t.get(e)??[])[0],n=k(e);t&&[...b.resolvedShapes.keys()].some(e=>e===n)&&t.error(f.ASSISTANT_META_TYPE_NAME_CONFLICT,y.ASSISTANT_META_TYPE_NAME_CONFLICT(e,n))}let e_={recipeGroup:(ew=[...Object.keys(ep).length>0?[O.mutation]:[],...Object.keys(el).length>0?[v.mutation]:[]],eN=()=>ec(ey.has(w)?w:T),eE=()=>ec(T),q=ew.join(" or "),Q=new s({name:_,description:"One reason a recipe cannot be used right now.",fields:{type:{type:new o(p),description:'Kind of the problem, or "uncaught".'},entityId:{type:t,description:"The entity the problem is on, when it is on one."},message:{type:p,description:"The problem as the configurator words it for the user."}}}),X=new s({name:A,description:"What using a recipe would do, tried out on the configuration the query reads. Nothing is changed.",fields:()=>({ok:{type:new o(e),description:`Whether ${q} would succeed with this recipe.`},root:{type:eN(),description:"The root entity of the configuration as it would be after the change; null when ok is false. Everything selected under it reads that configuration."},newEntities:{type:new o(new r(new o(eE()))),description:`The entities ${q} would return, read from that configuration; empty when ok is false.`},errors:{type:new o(new r(new o(Q))),description:"Why the recipe cannot be used; empty when ok is true."}})}),J=new s({name:E,description:"One recipe of a recipe group: something that can be added to the entity, or something the entity can be replaced with, depending on the edge the group is listed under.",fields:{key:{type:new o(p),description:`Identifies the recipe within its group; pass it to ${q} as recipeKey. Keys can change with the configuration and with the language, so read them from the listing rather than remembering them.`},name:{type:new o(p),description:"Name shown to the user."},description:{type:p},imageUrl:{type:p,description:"Thumbnail shown to the user."},entityType:{type:new o(p),description:"Type of the entity the recipe adds under the parent, or of the entity it replaces the current one with."},dryRun:{type:X,description:"Tries the recipe out. Each selected dry-run costs a full recalculation, so select it only on the recipes you are deciding between. Null for a group whose recipes cannot be dry-run."}}}),new s({name:N,description:"A group of recipes of an entity, as the configurator offers them to the user.",fields:{groupId:{type:new o(p),description:`Identifies the group on its entity; pass it to ${q} as recipeGroupId.`},name:{type:new o(p),description:"Name shown to the user."},description:{type:p},recipes:{type:new o(new r(new o(J)))}}})),fieldOption:new s({name:I,description:"One choice of a field, as the configurator offers it to the user.",fields:{value:{type:new o(g),description:"The value to write to the field."},name:{type:p,description:"Name shown to the user."},description:{type:p},imageUrl:{type:p,description:"Image shown to the user."},color:{type:p,description:'Color shown to the user, as "#rrggbb".'}}})};for(let e of b.entityTypes){let t=D(ep,e)??[],n=D(el,e)??[],i=eT.get(e)??[];(t.length>0||n.length>0||i.length>0)&&ed.set(e,G({entityType:e,childRecipes:{groups:t,hints:es.hints.get(e)??[]},replaceRecipes:{groups:n,hints:ea.hints.get(e)??[]},optionsEdges:i},e_))}let eI=Object.fromEntries(b.entityTypes.flatMap(e=>{let t=eT.get(e);return t?[[e,t.map(({options:e})=>e)]]:[]}));if(V.errors.length>Z)return;let eO=((e,t)=>{let n;try{let t=e();if(n=h(t).map(e=>e.message),0===n.length)return c(t)}catch(e){n=[e instanceof Error?e.message:String(e)]}t.error(f.ASSISTANT_INVALID_SCHEMA,y.ASSISTANT_INVALID_SCHEMA(n))})(()=>{var e,i;let l;return new a({query:(e=ec(ey.has(w)?w:T),i=ec(T),l=(e=>{let t={};for(let[n,i,r]of[["navigationState","Active navigation state.",e.navigationStates],["viewState","Active view state.",e.viewStates],["toolState","Active tool state.",e.toolStates]])r.length>1&&(t[n]={type:new o(p),description:R(i,r)});if(0!==Object.keys(t).length)return new s({name:"Navigation",description:"The active UI states of the configurator.",fields:t})})(W),new s({name:"Query",fields:{root:{type:new o(e),description:"The root entity of the configuration."},entities:{type:new o(new r(i)),args:{ids:{type:new r(new o(t))}},description:`Every entity of the configuration, or, when ids are given, those entities in the same order with null for an unknown id. Ids have the form "<Type>-<number>"${en?`, e.g. "${en}-1"`:""}; any other id is an error.`},selectedEntity:{type:new o(i),description:"The selected entity, or the root entity when nothing is selected."},...l?{navigation:{type:new o(l)}}:{}}})),mutation:(({deletableTypes:e,writableTypes:i,childRecipes:a,replaceRecipes:l,objectTypes:d,anyDomainEntity:c})=>{let h,f;if(0!==e.length||0!==i.length||0!==Object.keys(a).length||0!==Object.keys(l).length)return new s({name:"Mutation",fields:Object.assign(0===e.length?{}:{deleteEntity:{type:new o(new r(new o(t))),args:{id:{type:new o(t)}},description:`Deletes the entity with the given id, together with the entities composed into it, and returns the ids of every entity the deletion removed, the given one first. Deletable entity types: ${e.join(", ")}. Nothing can be read from removed entities afterwards, so query what you need from them before deleting.`}},0===(h=Y(a)).length?{}:{addChild:{type:new o(new r(new o(c))),args:{parentId:{type:new o(t)},recipeGroupId:{type:new o(p)},recipeKey:{type:new o(p)}},description:`Adds a child to the entity with the id parentId by one recipe of one of its recipe groups. Entity types with recipe groups: ${h.join("; ")}. Read the groupId and the recipe key from "meta { childRecipes }" of the parent. Returns every entity the change added, the recipe's own first and then whatever the configurator added in response, such as a part the new child needs; the list is empty when the configurator removed them again.`}},0===(f=Y(l)).length?{}:{replaceEntity:{type:new o(new r(new o(c))),args:{entityId:{type:new o(t)},recipeGroupId:{type:new o(p)},recipeKey:{type:new o(p)}},description:`Replaces the entity with the id entityId by one recipe of one of its replace recipe groups. Entity types with replace recipe groups: ${f.join("; ")}. Read the groupId and the recipe key from "meta { replaceRecipes }" of the entity. The replacement is a new entity with a new id: the id passed in no longer exists afterwards, and the replacement has the field values of its recipe, not those of the entity it replaces. Returns every entity the change added, the replacement first and then whatever the configurator added in response, such as a part the replacement needs; the list is empty when the configurator removed them again.`}},...i.flatMap(e=>{let i=d.get(e.entityType);return i?[(({entityType:e,fields:i},r)=>{let s=Object.fromEntries(i.map(({name:e,type:t,description:n})=>[e,{type:t,description:n}]));return{[`modify${e}`]:{type:r,args:{id:{type:new o(t)},delta:{type:new o(new n({name:`${e}Delta`,fields:s}))}},description:`Changes writable fields of the one ${e} with the given id: ${i.map(({name:e})=>e).join(", ")}. The delta sets only the fields it names and needs at least one; values are in stored units, as the field descriptions say. Returns the entity as it is after the change, including what the configurator adjusted in response, or null when the change caused the entity to be removed.`}}})(e,i)]:[]}))})})({deletableTypes:em,writableTypes:eS,childRecipes:ep,replaceRecipes:el,objectTypes:eo,anyDomainEntity:ec(T)}),types:[...ey.values(),...eo.values()]})},V);return void 0===eO?void 0:{sdl:eO,fields:eg,deletableTypes:em,writableFields:Object.fromEntries(eS.map(({entityType:e,fields:t})=>[e,Object.fromEntries(t.map(({name:e,property:t})=>[e,t]))])),childRecipes:ep,replaceRecipes:el,fieldOptions:eI}};

package/dist/application-spec/parse-application-files/spec/sections/assistant/assistant-server-settings.d.ts

@@ -0,0 +1,15 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { AssistantAiSettings } from '@salsita-ai/contracts/assistant';
+import type { MergedAssistant } from '../../../merge/index.js';
+/**
+ * The part of the assistant manifest only the server reads: the integrator's instructions for the
+ * assistant and the AI settings it runs with. It is kept beside `AssistantSpec`, never inside it,
+ * because `AssistantSpec` is serialized into the application bundle and into hot reload, and these
+ * must not reach the browser of a customer. Deployment registration uploads them. `null` when the
+ * application declares no `assistant` section.
+ */
+export type AssistantServerSettings = Branded<'AssistantServerSettings', {
+    readonly instructions: string | null;
+    readonly ai: AssistantAiSettings;
+}> | null;
+export declare const AssistantServerSettings: ({ manifest }: MergedAssistant) => AssistantServerSettings;

package/dist/application-spec/parse-application-files/spec/sections/assistant/assistant-server-settings.js

@@ -0,0 +1 @@
+import{Branded as t}from"@salsita-ai/common/utils";export const AssistantServerSettings=({manifest:i})=>i?t({instructions:i.instructions??null,ai:i.ai}):null;

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

@@ -0,0 +1,25 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ParseContext } from '../../../../core/index.js';
+import type { MergedAssistant } from '../../../merge/index.js';
+import type { EntityTypeName } from '../../model/index.js';
+import { type AssistantFieldOptionsByType, type AssistantFieldSources, type AssistantRecipeGroups, type AssistantSchemaInput, type AssistantWritableFields } from './assistant-schema.js';
+/**
+ * The experimental assistant manifest with its GraphQL SDL, prepared once at parse time so the
+ * `.phoenix` codegen, the in-browser hot-reload runtime and deployment registration all carry the
+ * exact same schema text. `fields` maps exposed GraphQL fields back to the stored fields and
+ * expressions the runtime resolvers read; `deletableTypes` lists the entity types `deleteEntity`
+ * may delete; `writableFields` maps the delta fields of each `modify<Type>` mutation to the stored
+ * properties they write; `childRecipes` and `replaceRecipes` list the recipe groups each entity type exposes; `fieldOptions` lists
+ * the options edges of each entity type's writable fields. `null` when the application declares no
+ * `assistant` section or it is invalid.
+ */
+export type AssistantSpec = Branded<'AssistantSpec', {
+    readonly sdl: string;
+    readonly fields: AssistantFieldSources;
+    readonly deletableTypes: readonly EntityTypeName[];
+    readonly writableFields: AssistantWritableFields;
+    readonly childRecipes: AssistantRecipeGroups;
+    readonly replaceRecipes: AssistantRecipeGroups;
+    readonly fieldOptions: AssistantFieldOptionsByType;
+}> | null;
+export declare const AssistantSpec: (merged: MergedAssistant, input: AssistantSchemaInput, ctx: ParseContext) => AssistantSpec;

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

@@ -0,0 +1 @@
+import{Branded as t}from"@salsita-ai/common/utils";import{createAssistantSchema as s}from"./assistant-schema.js";export const AssistantSpec=(i,a,n)=>{let{manifest:l,origin:r}=i;if(!l)return null;let e=s(l,a,(r?n.inFile(r):n).at("assistant"));return e?t(e):null};

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

@@ -0,0 +1,3 @@
+export { AssistantSpec } from './assistant.js';
+export type { AssistantFieldSources } from './assistant-schema.js';
+export { AssistantServerSettings } from './assistant-server-settings.js';

package/dist/application-spec/parse-application-files/spec/sections/assistant/index.js

@@ -0,0 +1 @@
+export{AssistantSpec}from"./assistant.js";export{AssistantServerSettings}from"./assistant-server-settings.js";

package/dist/application-spec/parse-application-files/spec/sections/bundle-size-budgets.d.ts

@@ -0,0 +1,10 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { MergedBudgets } from '../../merge/index.js';
+/** A gzip-size limit represented in bytes after parsing application-spec megabytes. */
+export type BundleSizeBytes = Branded<'BundleSizeBytes', number>;
+/** Optional limits for the deployable bundles produced by `phoenix build`. */
+export type BundleSizeBudgets = Branded<'BundleSizeBudgets', {
+    readonly webhookGzipBytes?: BundleSizeBytes;
+    readonly configuratorGzipBytes?: BundleSizeBytes;
+}>;
+export declare const BundleSizeBudgets: (merged: MergedBudgets) => BundleSizeBudgets;

package/dist/application-spec/parse-application-files/spec/sections/bundle-size-budgets.js

@@ -0,0 +1 @@
+import{Branded as o}from"@salsita-ai/common/utils";export const BundleSizeBudgets=i=>o({webhookGzipBytes:void 0===i.webhookGzipMb?void 0:o(1048576*i.webhookGzipMb),configuratorGzipBytes:void 0===i.configuratorGzipMb?void 0:o(1048576*i.configuratorGzipMb)});

package/dist/application-spec/parse-application-files/spec/sections/data-spec/chunks.d.ts

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

package/dist/application-spec/parse-application-files/spec/sections/data-spec/chunks.js

@@ -0,0 +1 @@
+import{Branded as e}from"@salsita-ai/common/utils";import{DiagnosticCode as t,diagnosticMessages as r}from"../../../../errors/index.js";let o=/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/,i="system";export const ChunkName=(i,n)=>o.test(i)?e(i):void n.error(t.INVALID_CHUNK_KEY,r.INVALID_CHUNK_KEY(i));export const Chunks=(o,n)=>{let s={},E=Object.keys(o),m=!1;if(0===E.length)return s;for(let e of E){if(e===i){n.error(t.RESERVED_CHUNK_KEY,r.RESERVED_CHUNK_KEY()),m=!0;continue}let E=ChunkName(e,n);if(!E){m=!0;continue}s[E]=o[e]}if(!m)return s[e(i)]={scope:"public"},s};

package/dist/application-spec/parse-application-files/spec/sections/data-spec/custom-data-spec.d.ts

@@ -0,0 +1,29 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { DataCellValue, DataSchema } from '#package/domain';
+import { type ParseContext } from '../../../../core/index.js';
+import type { MergedDataSpec } from '../../../merge/index.js';
+import { type ChunkDefinition, ChunkName } from './chunks.js';
+import { DataEntryKey } from './data-entry-key.js';
+/** Parsed `$data.custom` entry with validated definition and normalized row values. */
+export interface CustomDataSpecEntry {
+    /** Column/property schema for a custom data row, used by admin pages and published-data schemas. */
+    readonly definition: DataSchema;
+    /** Optional published-data chunk that receives this entry as an array property. */
+    readonly chunk?: string;
+    /** Ownership mode deciding whether data is manual, externally connected, or admin-generated. */
+    readonly kind: 'manual' | 'connected' | 'generated';
+    /** Optional human-readable label used by inferred admin pages and connected-data UI. */
+    readonly title?: string;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Default rows normalized to the same column order as `definition`. */
+    readonly values?: ReadonlyArray<readonly DataCellValue[]>;
+}
+/**
+ * Validated `$data.custom` section.
+ * Every key is a validated data entry key, every definition field has a valid
+ * column name, inline values have been checked against the raw definition, and
+ * row values are normalized into definition order for admin/runtime consumers.
+ */
+export type CustomDataSpec = Branded<'CustomDataSpec', Readonly<Record<DataEntryKey, CustomDataSpecEntry>>>;
+export declare const CustomDataSpec: (merged: MergedDataSpec, userChunks: Readonly<Record<ChunkName, ChunkDefinition>>, ctx: ParseContext) => CustomDataSpec | undefined;

package/dist/application-spec/parse-application-files/spec/sections/data-spec/custom-data-spec.js

@@ -0,0 +1 @@
+import{Branded as e}from"@salsita-ai/common/utils";import{isJsonArray as r,isJsonObject as t,sortedEntries as i}from"../../../../core/index.js";import{DiagnosticCode as n,diagnosticMessages as o}from"../../../../errors/index.js";import{ChunkName as u}from"./chunks.js";import{DataDefinitionFieldKey as f}from"./data-definition-field-key.js";import{DataEntryKey as l}from"./data-entry-key.js";let s=e=>"object"==typeof e&&!Array.isArray(e),a=e=>s(e)&&"array"===e.type,y=e=>s(e)&&"array"!==e.type&&"localized"!==e.type,m=e=>Array.isArray(e)?e[0]:s(e)?e.type:e,p=e=>!!t(e)&&Object.values(e).every(e=>"string"==typeof e),c=(e,t,i,u)=>{let f=Object.entries(t),l=[],s=!1;return i.forEach((t,i)=>{let c=f.map(([f,l])=>{var c;let d=t[f];((e,t)=>{if(void 0===e)return!0;if(null===e)return Array.isArray(t)&&"null"===t[1];if(a(t))return r(e)&&e.every(e=>{var r;return"string"===(r=t.items)?"string"==typeof e:"number"===r?"number"==typeof e:"boolean"==typeof e});if("localized"===m(t))return p(e);let i=m(t);return!("string"===i&&"string"!=typeof e||"number"===i&&"number"!=typeof e||"boolean"===i&&"boolean"!=typeof e||y(t)&&("integer"===t.type&&(!Number.isInteger(e)||"number"!=typeof e)||t.enum&&("string"!=typeof e&&"number"!=typeof e||!t.enum.includes(e))))&&!0})(d,l)||(u.error(n.INVALID_DATA_VALUE,o.INVALID_DATA_VALUE(e,i,f,a(c=l)?`${c.items}[]`:y(c)&&c.enum?c.enum.map(String).join(" | "):Array.isArray(c)?c.join(" | "):m(c))),s=!0);if(null==d)return"";if(a(l)&&r(d))return d.filter(e=>"object"!=typeof e&&null!==e);if("localized"===m(l)&&p(d)){let e={};for(let[r,t]of Object.entries(d))"string"==typeof t&&(e[r]=t);return{$lang:e}}return"string"==typeof d||"number"==typeof d||"boolean"==typeof d?d:""});l.push(c)}),{values:l,hasError:s}},d=(e,r,t)=>{let i={},n=!1;for(let[o,u]of Object.entries(r)){let r=f(e,o,t);if(!r){n=!0;continue}i[r]=u}return{definition:i,hasError:n}};export const CustomDataSpec=(r,t,f)=>{let s={},a=!1;for(let[e,y]of i(r.custom)){let r=l("custom",e,f);if(!r){a=!0;continue}if(void 0!==y.chunk){let e=u(y.chunk,f);e&&!t[e]&&(f.error(n.UNKNOWN_DATA_CHUNK,o.UNKNOWN_DATA_CHUNK("custom",r,y.chunk)),a=!0),e||(a=!0)}let i=d(r,y.definition,f),m=c(r,y.definition,y.values,f);(i.hasError||m.hasError)&&(a=!0);let p={definition:i.definition,chunk:y.chunk,kind:y.kind,...void 0===y.title?{}:{title:y.title},...void 0===y.icon?{}:{icon:y.icon},values:m.values};s[r]=p}if(!a)return e(s)};

package/dist/application-spec/parse-application-files/spec/sections/data-spec/data-definition-field-key.d.ts

@@ -0,0 +1,11 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ParseContext } from '../../../../core/index.js';
+import type { DataEntryKey } from './data-entry-key.js';
+/**
+ * Validated field key inside a custom $data definition.
+ * These keys define the columns/properties of one custom data row. They are used
+ * to validate inline values, generate published-data schemas, and map tabular
+ * values back into record objects at runtime.
+ */
+export type DataDefinitionFieldKey = Branded<'DataDefinitionFieldKey', string>;
+export declare const DataDefinitionFieldKey: (entryKey: DataEntryKey, fieldKey: string, ctx: ParseContext) => DataDefinitionFieldKey | undefined;

package/dist/application-spec/parse-application-files/spec/sections/data-spec/data-definition-field-key.js

@@ -0,0 +1 @@
+import{Branded as o}from"@salsita-ai/common/utils";import{DiagnosticCode as I,diagnosticMessages as i}from"../../../../errors/index.js";let r=/^\$?[a-z][\w.-]*$/;export const DataDefinitionFieldKey=(t,D,e)=>r.test(D)?o(D):void e.error(I.INVALID_DATA_DEFINITION_FIELD_KEY,i.INVALID_DATA_DEFINITION_FIELD_KEY(t,D));

package/dist/application-spec/parse-application-files/spec/sections/data-spec/data-entry-key.d.ts

@@ -0,0 +1,13 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ParseContext } from '../../../../core/index.js';
+/** `$data` subsection that owns a data entry key and determines its raw entry shape. */
+export type DataEntrySection = 'custom' | 'swatchOptions';
+/**
+ * Validated `$data` entry key.
+ * This is the stable identifier for a data collection declared under `$data.custom`
+ * or `$data.swatchOptions`. The same key is used when extending published data,
+ * wiring connected/generated admin pages, and linking explicit admin pages through
+ * `connectedDataEntry`.
+ */
+export type DataEntryKey = Branded<'DataEntryKey', string>;
+export declare const DataEntryKey: (section: DataEntrySection, key: string, ctx: ParseContext) => DataEntryKey | undefined;

package/dist/application-spec/parse-application-files/spec/sections/data-spec/data-entry-key.js

@@ -0,0 +1 @@
+import{Branded as r}from"@salsita-ai/common/utils";import{DiagnosticCode as o,diagnosticMessages as t}from"../../../../errors/index.js";let e=/^[A-Za-z]\w*$/;export const DataEntryKey=(i,s,A)=>e.test(s)?r(s):void A.error(o.INVALID_DATA_ENTRY_KEY,t.INVALID_DATA_ENTRY_KEY(i,s));

package/dist/application-spec/parse-application-files/spec/sections/data-spec/data-spec.d.ts

@@ -0,0 +1,67 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { DataCellValue, DataSchema } from '#package/domain';
+import { type ParseContext } from '../../../../core/index.js';
+import type { MergedChunks, MergedDataSpec } from '../../../merge/index.js';
+import { Chunks } from './chunks.js';
+import { type CustomDataSpecEntry } from './custom-data-spec.js';
+import type { DataEntryKey } from './data-entry-key.js';
+import { type SwatchDataSpecEntry } from './swatch-data-spec.js';
+/** Validated `$data` entries grouped by their source section. */
+export interface ParsedDataSpecEntries {
+    /** Custom data entries with user-declared schemas. */
+    readonly custom: Readonly<Record<DataEntryKey, CustomDataSpecEntry>>;
+    /** Swatch data entries with the built-in swatch schema. */
+    readonly swatchOptions: Readonly<Record<DataEntryKey, SwatchDataSpecEntry>>;
+}
+export interface DataSpecDataEntry {
+    /** Data entry identifier used as published-data property and admin page navigation state. */
+    readonly key: DataEntryKey;
+    /** Row schema used for published-data schema generation and connected/generated admin UI. */
+    readonly definition: DataSchema;
+    /** Data ownership mode driving admin page inference and runtime data source selection. */
+    readonly kind: 'manual' | 'connected' | 'generated';
+    /** Optional human-readable label used by inferred admin pages and connected-data UI. */
+    readonly title?: string;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Optional target published-data chunk for this entry. */
+    readonly chunk?: string;
+    /** Optional default rows normalized to `definition` column order. */
+    readonly values?: ReadonlyArray<readonly DataCellValue[]>;
+}
+/** Inferred admin page descriptor derived from a `$data` entry. */
+export interface DataSpecAdminPage {
+    /** Navigation state and data entry key for the inferred admin page. */
+    readonly key: DataEntryKey;
+    /** Label displayed in admin navigation and page UI. */
+    readonly title: string;
+    /** Data ownership mode determining whether the page edits rows or connects a workbook. */
+    readonly kind: DataSpecDataEntry['kind'];
+    /** Row schema passed to admin page factories. */
+    readonly definition: DataSchema;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Default rows passed to admin page factories. */
+    readonly values?: ReadonlyArray<readonly DataCellValue[]>;
+}
+/**
+ * Validated application `$data` specification.
+ * This is the semantic data model used by codegen, published-data schema
+ * extension, runtime data refresh detection, and admin page inference.
+ */
+export type DataSpec = Branded<'DataSpec', {
+    /** 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;
+    /** Flattened lookup of all custom and swatch data entries by data entry key. */
+    readonly dataEntries: Readonly<Record<DataEntryKey, DataSpecDataEntry>>;
+    /** Admin pages inferred from data entries when the admin spec opts in. */
+    readonly adminDataPages: readonly DataSpecAdminPage[];
+}>;
+interface DataSpecProps {
+    readonly mergedDataSpec: MergedDataSpec;
+    readonly mergedChunks: MergedChunks;
+}
+export declare const DataSpec: (props: DataSpecProps, ctx: ParseContext) => DataSpec | undefined;
+export {};

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

@@ -0,0 +1 @@
+import{Branded as e}from"@salsita-ai/common/utils";import{SWATCH_DEFINITION as i}from"#package/domain";import{sortedEntries as t}from"../../../../core/index.js";import{Chunks as o}from"./chunks.js";import{CustomDataSpec as n}from"./custom-data-spec.js";import{SwatchDataSpec as c}from"./swatch-data-spec.js";let l=i=>e(i);export const DataSpec=(r,s)=>{let a=o(r.mergedChunks,s);if(!a)return;let d=(i=>{let t={};for(let[o,n]of Object.entries(i))"system"!==o&&(t[e(o)]=n);return t})(a),u=n(r.mergedDataSpec,d,s),m=c(r.mergedDataSpec,d,s);if(!u||!m)return;let k={custom:u,swatchOptions:m},v=(e=>{let o={};for(let[i,n]of t(e.custom??{})){let e=l(i);o[i]={key:e,definition:n.definition,kind:n.kind,...void 0===n.title?{}:{title:n.title},...void 0===n.icon?{}:{icon:n.icon},...void 0===n.chunk?{}:{chunk:n.chunk},...void 0===n.values?{}:{values:n.values}}}for(let[n,c]of t(e.swatchOptions??{})){let e=l(n);o[n]={key:e,definition:i,kind:c.kind,...void 0===c.title?{}:{title:c.title},...void 0===c.icon?{}:{icon:c.icon},...void 0===c.chunk?{}:{chunk:c.chunk},...void 0===c.values?{}:{values:c.values}}}return o})(k),f=Object.values(v).map(e=>({key:e.key,title:e.title??e.key,kind:e.kind,definition:e.definition,...void 0===e.icon?{}:{icon:e.icon},...void 0===e.values?{}:{values:e.values}}));return e({entries:k,chunks:a,dataEntries:v,adminDataPages:f})};

package/dist/application-spec/parse-application-files/spec/sections/data-spec/index.d.ts

@@ -0,0 +1,8 @@
+export { ChunkName, Chunks } from './chunks.js';
+export type { ChunkDefinition } from './chunks.js';
+export { DataSpec } from './data-spec.js';
+export type { DataSpecAdminPage, DataSpecDataEntry } from './data-spec.js';
+export { DataDefinitionFieldKey } from './data-definition-field-key.js';
+export { DataEntryKey } from './data-entry-key.js';
+export type { DataDefinitionFieldKey as DataDefinitionFieldKeyType } from './data-definition-field-key.js';
+export type { DataEntrySection } from './data-entry-key.js';

package/dist/application-spec/parse-application-files/spec/sections/data-spec/index.js

@@ -0,0 +1 @@
+export{ChunkName,Chunks}from"./chunks.js";export{DataSpec}from"./data-spec.js";export{DataDefinitionFieldKey}from"./data-definition-field-key.js";export{DataEntryKey}from"./data-entry-key.js";

package/dist/application-spec/parse-application-files/spec/sections/data-spec/swatch-data-spec.d.ts

@@ -0,0 +1,27 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { CellValue } from '@salsita-ai/contracts/webhook';
+import { type ParseContext } from '../../../../core/index.js';
+import type { MergedDataSpec } from '../../../merge/index.js';
+import { type ChunkDefinition, ChunkName } from './chunks.js';
+import { DataEntryKey } from './data-entry-key.js';
+/** Parsed `$data.swatchOptions` entry using the fixed swatch data shape. */
+export interface SwatchDataSpecEntry {
+    /** Optional published-data chunk that receives this swatch entry as an array property. */
+    readonly chunk?: string;
+    /** Ownership mode deciding whether swatches are manual, externally connected, or admin-generated. */
+    readonly kind: 'manual' | 'connected' | 'generated';
+    /** Optional human-readable label used by inferred admin pages and connected-data UI. */
+    readonly title?: string;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Default swatch rows normalized to `SWATCH_DEFINITION` column order. */
+    readonly values?: ReadonlyArray<readonly CellValue[]>;
+}
+/**
+ * Validated `$data.swatchOptions` section.
+ * Every key is a validated data entry key and default swatch values are
+ * normalized into the fixed swatch column order consumed by admin data pages and
+ * published-data mapping.
+ */
+export type SwatchDataSpec = Branded<'SwatchDataSpec', Readonly<Record<DataEntryKey, SwatchDataSpecEntry>>>;
+export declare const SwatchDataSpec: (merged: MergedDataSpec, userChunks: Readonly<Record<ChunkName, ChunkDefinition>>, ctx: ParseContext) => SwatchDataSpec | undefined;

package/dist/application-spec/parse-application-files/spec/sections/data-spec/swatch-data-spec.js

@@ -0,0 +1 @@
+import{Branded as t}from"@salsita-ai/common/utils";import{sortedEntries as o}from"../../../../core/index.js";import{DiagnosticCode as i,diagnosticMessages as e}from"../../../../errors/index.js";import{ChunkName as r}from"./chunks.js";import{DataEntryKey as n}from"./data-entry-key.js";let c=["color","swatchName","label","thumbnailUrl"];export const SwatchDataSpec=(a,s,l)=>{let m={},h=!1;for(let[t,p]of o(a.swatchOptions)){let o=n("swatchOptions",t,l);if(!o){h=!0;continue}if(void 0!==p.chunk){let t=r(p.chunk,l);t&&!s[t]&&(l.error(i.UNKNOWN_DATA_CHUNK,e.UNKNOWN_DATA_CHUNK("swatchOptions",o,p.chunk)),h=!0),t||(h=!0)}let a={chunk:p.chunk,kind:p.kind,...void 0===p.title?{}:{title:p.title},...void 0===p.icon?{}:{icon:p.icon},values:p.values.map(t=>c.map(o=>t[o]))};m[o]=a}if(!h)return t(m)};

package/dist/application-spec/parse-application-files/spec/sections/env.d.ts

@@ -0,0 +1,15 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ParseContext } from '../../../core/index.js';
+import type { RawEnvVarEntry } from '../../raw-spec/index.js';
+interface RawEnv {
+    readonly frontend?: Readonly<Record<string, RawEnvVarEntry>>;
+    readonly webhook?: Readonly<Record<string, RawEnvVarEntry>>;
+}
+/**
+ * Validated environment variable declarations for frontend and webhook contexts.
+ * Keys are POSIX-style uppercase identifiers; entries carry `envalid`-compatible
+ * options (type, default, devDefault, required) consumed by env-reader codegen.
+ */
+export type Env = Branded<'Env', RawEnv>;
+export declare const Env: (raw: RawEnv, ctx: ParseContext) => Env | undefined;
+export {};

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

@@ -0,0 +1 @@
+import{Branded as r}from"@salsita-ai/common/utils";import{DiagnosticCode as e,diagnosticMessages as o}from"../../../errors/index.js";let t=/^[A-Z_][A-Z0-9_]*$/,n=(r,n,i)=>{if(void 0===n)return{entries:void 0,hasError:!1};let s={},f=!1;for(let[E,_]of Object.entries(n)){if(!t.test(E)){i.error(e.INVALID_ENV_VAR_KEY,o.INVALID_ENV_VAR_KEY(r,E)),f=!0;continue}s[E]=_}return{entries:s,hasError:f}};export const Env=(e,o)=>{let t=n("frontend",e.frontend,o),i=n("webhook",e.webhook,o);if(!t.hasError&&!i.hasError)return r({frontend:t.entries,webhook:i.entries})};

package/dist/application-spec/parse-application-files/spec/sections/index.d.ts

@@ -0,0 +1,11 @@
+export * from './app-metadata.js';
+export * from './assistant/index.js';
+export * from './application-version.js';
+export * from './bundle-size-budgets.js';
+export * from './data-spec/index.js';
+export * from './env.js';
+export * from './infra.js';
+export * from './state-value.js';
+export * from './theme.js';
+export * from './transformers.js';
+export * from './ui.js';

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

@@ -0,0 +1 @@
+export*from"./app-metadata.js";export*from"./assistant/index.js";export*from"./application-version.js";export*from"./bundle-size-budgets.js";export*from"./data-spec/index.js";export*from"./env.js";export*from"./infra.js";export*from"./state-value.js";export*from"./theme.js";export*from"./transformers.js";export*from"./ui.js";

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

@@ -0,0 +1,17 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ParseContext } from '../../../core/index.js';
+import type { MergedInfra } from '../../merge/index.js';
+import { Env } from './env.js';
+/**
+ * Validated infrastructure settings — env vars, ACL, resources.
+ * Used by codegen for builder chain methods and env reader generation.
+ * `env` is a `Env`-branded value once validated (keys conform to
+ * `/^[A-Z_][A-Z0-9_]*$/`), or `undefined` when no `env:` block was declared.
+ */
+export type Infra = Branded<'Infra', {
+    readonly env?: Env;
+    readonly acl: MergedInfra['acl'];
+    readonly resources: MergedInfra['resources'];
+    readonly resourcesConfig: MergedInfra['resourcesConfig'];
+}>;
+export declare const Infra: (merged: MergedInfra, ctx: ParseContext) => Infra | undefined;

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

@@ -0,0 +1 @@
+import{Branded as o}from"@salsita-ai/common/utils";import{Env as r}from"./env.js";export const Infra=(e,s)=>{let i;if(void 0===e.env||void 0!==(i=r(e.env,s)))return o({env:i,acl:e.acl,resources:e.resources,resourcesConfig:e.resourcesConfig})};

package/dist/application-spec/parse-application-files/spec/sections/state-value.d.ts

@@ -0,0 +1,9 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ParseContext } from '../../../core/index.js';
+/**
+ * Branded state value — a valid identifier used as a state enum entry
+ * (e.g. "Default", "overview", "detailView").
+ * Used across navigation, view, tool, and export state dimensions.
+ */
+export type StateValue = Branded<'StateValue', string>;
+export declare const StateValue: (value: string, field: string, ctx: ParseContext) => StateValue | undefined;

package/dist/application-spec/parse-application-files/spec/sections/state-value.js

@@ -0,0 +1 @@
+import{Branded as o}from"@salsita-ai/common/utils";import{DiagnosticCode as r,diagnosticMessages as t}from"../../../errors/index.js";let e=/^[a-zA-Z][\w]*$/;export const StateValue=(i,s,a)=>e.test(i)?o(i):void a.error(r.INVALID_STATE_KEY,t.INVALID_STATE_KEY(s,i));

package/dist/application-spec/parse-application-files/spec/sections/theme.d.ts

@@ -0,0 +1,12 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { MergedTheme } from '../../merge/index.js';
+/**
+ * Validated theme configuration for the configurator UI.
+ * Preset identifies a built-in theme from getPhoenixThemes(),
+ * options provides partial overrides passed to the theme factory.
+ */
+export type Theme = Branded<'Theme', {
+    readonly preset: string;
+    readonly options: Readonly<Record<string, unknown>>;
+}>;
+export declare const Theme: (merged: MergedTheme) => Theme;

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

@@ -0,0 +1 @@
+import{Branded as o}from"@salsita-ai/common/utils";export const Theme=t=>o({preset:t.preset,options:t.options});

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

@@ -0,0 +1,13 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { ParseContext } from '../../../core/index.js';
+import type { MergedTransformers, TransformerEntry } from '../../merge/index.js';
+/**
+ * Validated transformer declarations. Each transformer is applied during
+ * domain state transitions to enforce business rules (e.g. "fixLegsForCircleTop").
+ * Every entry's name must match a file basename in `src/transformers/`
+ * (modulo case + dashes — kebab-case files and camelCase YAML names are
+ * treated as equivalent since runtime matching happens on the `.build('name')`
+ * label, not the filename).
+ */
+export type Transformers = Branded<'Transformers', readonly TransformerEntry[]>;
+export declare const Transformers: (merged: MergedTransformers, transformerFiles: readonly string[], ctx: ParseContext) => Transformers;

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

@@ -0,0 +1 @@
+import{Branded as e}from"@salsita-ai/common/utils";import{DiagnosticCode as r,diagnosticMessages as o}from"../../../errors/index.js";let t=e=>e.replace(/^.*\//,"").replace(/\.tsx?$/,""),s=e=>e.toLowerCase().replace(/-/g,"");export const Transformers=(a,n,R)=>{let l=n.map(t),i=new Map;for(let[e,t]of l.entries()){let a=n[e],l=s(t),m=i.get(l);if(void 0!==m){R.error(r.DUPLICATE_TRANSFORMER_FILE,o.DUPLICATE_TRANSFORMER_FILE(m,a));continue}i.set(l,a)}let m=new Set(i.keys());for(let e of a)m.has(s(e.name))||R.error(r.UNMATCHED_TRANSFORMER,o.UNMATCHED_TRANSFORMER(e.name,l));return e([...a])};

package/dist/application-spec/parse-application-files/spec/sections/ui.d.ts

@@ -0,0 +1,14 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { MergedUi } from '../../merge/index.js';
+/**
+ * Validated UI configuration for the configurator.
+ * Controls preview behavior, expansion mode, and locale settings.
+ */
+export type Ui = Branded<'Ui', {
+    readonly preview?: 'always' | 'never' | 'auto' | 'hide';
+    readonly alwaysExpand?: boolean;
+    readonly appLoader?: 'legacy' | 'universal';
+    readonly availableLocales: readonly string[];
+    readonly textLanguages?: readonly string[];
+}>;
+export declare const Ui: (merged: MergedUi) => Ui;

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

@@ -0,0 +1 @@
+import{Branded as a}from"@salsita-ai/common/utils";export const Ui=e=>a({preview:e.preview,alwaysExpand:e.alwaysExpand,appLoader:e.appLoader,availableLocales:e.availableLocales,textLanguages:e.textLanguages});

package/dist/application-spec/webhook-boundary.d.ts

@@ -0,0 +1,2 @@
+export declare const isClientOnlySdkImport: (specifier: string) => boolean;
+export declare const isClientAssetImport: (specifier: string) => boolean;

package/dist/application-spec/webhook-boundary.js

@@ -0,0 +1 @@
+let t=/^@salsita-ai\/sdk\/(admin|application|react|configurator|ui|editor|extras\/clerk)(\/|$)/,s=/\.(css|scss|sass|less|woff2?|ttf|otf|eot|png|jpe?g|gif|svg|webp|avif)(\?.*)?$/i;export const isClientOnlySdkImport=s=>t.test(s);export const isClientAssetImport=t=>s.test(t);

package/dist/client/authenticated-client.d.ts

@@ -0,0 +1,29 @@
+import { type AuthenticatedClientPhoenixApiClient, type ConfigurationPayload, type GoogleOAuthConfig, type OAuthAccessTokenResult, type OAuthProvider, type ReleaseToProductionResult, type SharePointSiteConfig } from './contract.js';
+import type { components } from './phoenix-api.js';
+export declare class AuthenticatedClient implements AuthenticatedClientPhoenixApiClient {
+    private readonly _baseUrl;
+    private readonly _getSessionToken;
+    private readonly _client;
+    constructor(_baseUrl: string, _getSessionToken: () => Promise<string>);
+    createConfiguration: (configurationPayload: ConfigurationPayload) => Promise<{
+        readonly accessToken: string;
+        readonly configurationId: components['schemas']['ConfigurationUuid'];
+        readonly readToken: string;
+        readonly revisionId: components['schemas']['RevisionUuid'];
+    }>;
+    getConfigurations: () => Promise<{
+        readonly rows: readonly {
+            readonly accessToken: string;
+            readonly configurationId: components['schemas']['ConfigurationUuid'];
+            readonly rootEntityType: string;
+        }[];
+    }>;
+    getBackendData: (frontendData: Record<string, unknown>) => Promise<{
+        readonly [key: string]: unknown;
+    }>;
+    getPublishedChunk: (chunkKey: string, publishedDataHash?: string) => Promise<unknown | null>;
+    getOAuthAccessToken: (provider: OAuthProvider) => Promise<OAuthAccessTokenResult | null>;
+    getGoogleOAuthConfig: () => Promise<GoogleOAuthConfig>;
+    getSharePointSiteConfig: () => Promise<SharePointSiteConfig | null>;
+    releaseToProduction: () => Promise<ReleaseToProductionResult>;
+}

package/dist/client/authenticated-client.js

@@ -0,0 +1 @@
+import{OAUTH_STALE_CONNECTION_CODE as e}from"@salsita-ai/contracts/domain";import{createApiBaseClient as t}from"./base-client.js";import{ConfigurationSchemaMismatchError as r,OAuthStaleConnectionError as i}from"./contract.js";export class AuthenticatedClient{_baseUrl;_getSessionToken;_client;constructor(e,r){this._baseUrl=e,this._getSessionToken=r,this._client=t(this._baseUrl)}createConfiguration=async e=>{let t=await this._getSessionToken(),i=await this._client.POST("/configurations",{body:e,headers:{Authorization:`Bearer ${t}`}});if(i.error){if(400===i.error.statusCode&&i.error.message?.startsWith("Configuration is not valid"))throw new r(i.error.message);throw Error(`createConfiguration API request failed: ${JSON.stringify(i.error)}`)}return i.data};getConfigurations=async()=>{let e=await this._getSessionToken(),t=await this._client.GET("/configurations",{headers:{Authorization:`Bearer ${e}`}});if(t.error)throw Error(`getConfiguration API request failed: ${JSON.stringify(t.error)}`);return t.data};getBackendData=async e=>{let t=await this._getSessionToken(),r=await this._client.POST("/session/backend-data",{headers:{Authorization:`Bearer ${t}`},body:{frontendData:e}});if(r.error)throw Error(`getBackendData API request failed: ${JSON.stringify(r.error)}`);return r.data.backendData};getPublishedChunk=async(e,t)=>{let r=await this._getSessionToken(),i=`${this._baseUrl}/published-data/chunks/${encodeURIComponent(e)}${null!=t?`?hash=${encodeURIComponent(t)}`:""}`,a=await fetch(i,{headers:{Authorization:`Bearer ${r}`}});if(204===a.status)return null;if(!a.ok)throw Error(`getPublishedChunk API request failed: ${a.status} ${a.statusText}`);return a.json()};getOAuthAccessToken=async t=>{let r=await this._getSessionToken(),a=await this._client.GET("/admin/oauth/token",{params:{query:{provider:t}},headers:{Authorization:`Bearer ${r}`}});if(204===a.response.status)return null;if(a.error){if(a.error.message===e)throw new i;throw Error(`getOAuthAccessToken API request failed: ${JSON.stringify(a.error)}`)}return{accessToken:String(a.data.accessToken),expiresAt:Number(a.data.expiresAt)}};getGoogleOAuthConfig=async()=>{let e=await this._getSessionToken(),t=await this._client.GET("/admin/oauth/google/config",{headers:{Authorization:`Bearer ${e}`}});if(t.error)throw Error(`getGoogleOAuthConfig API request failed: ${JSON.stringify(t.error)}`);return{clientId:t.data.clientId,pickerApiKey:t.data.pickerApiKey,pickerAppId:t.data.pickerAppId}};getSharePointSiteConfig=async()=>{let e=await this._getSessionToken(),t=await this._client.GET("/admin/sharepoint/site",{headers:{Authorization:`Bearer ${e}`}});if(t.error)throw Error(`getSharePointSiteConfig API request failed: ${JSON.stringify(t.error)}`);return t.data.site};releaseToProduction=async()=>{let e=await this._getSessionToken(),t=await this._client.POST("/environments/release-to-production",{headers:{Authorization:`Bearer ${e}`,"Content-Type":null}});if(void 0!==t.error||void 0===t.data){let e=t.error?.message??`the server returned status ${t.response.status} without details`;throw Error(`Release to production failed: ${e}`)}return t.data}}

package/dist/client/authorized-client.d.ts

@@ -0,0 +1,54 @@
+import type { AccessLevel } from '@salsita-ai/contracts/api';
+import { type ChatStreamChunk } from '@salsita-ai/contracts/chat';
+import { type AssistantChatConnection, type AuthorizedPhoenixApiClient, type ChatToolCall, type ChatToolCallResult, type ConfigurationPayload, type ConfigurationSchema, type waitForFinalizationResultSettings } from './contract.js';
+import type { components } from './phoenix-api.js';
+export declare class AuthorizedClient<FINALIZE_DATA extends Record<string, unknown>, FINALIZE_RESULT extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>> implements AuthorizedPhoenixApiClient<FINALIZE_DATA, FINALIZE_RESULT, FRONTEND_DATA> {
+    private readonly _baseUrl;
+    private readonly _getAccessToken;
+    private readonly _getSessionToken;
+    private readonly _client;
+    constructor(_baseUrl: string, _getAccessToken: () => string, _getSessionToken: () => Promise<string>);
+    private readonly _authHeaders;
+    getConfiguration: (configurationId: string) => Promise<ConfigurationSchema>;
+    updateConfiguration: (configurationId: string, configurationPayload: ConfigurationPayload) => Promise<{
+        readonly revisionId: components['schemas']['RevisionUuid'];
+    }>;
+    finalize: (configurationId: string, finalizationUuid: string, finalizeData: FINALIZE_DATA, locale?: string, frontendData?: FRONTEND_DATA) => Promise<void>;
+    waitForFinalizationToComplete: (configurationId: string, finalizationUuid: string, settings?: waitForFinalizationResultSettings) => Promise<FINALIZE_RESULT>;
+    getConfigurationRevision: (configurationId: string, revisionId: string) => Promise<ConfigurationSchema>;
+    getChatConversation: (configurationId: string) => Promise<readonly {
+        readonly augmentation?: components['schemas']['ChatMessageAugmentation'];
+        readonly content?: string;
+        readonly name?: string;
+        readonly role: 'user' | 'assistant';
+        readonly tool_calls?: readonly components['schemas']['ChatToolCall'][];
+    }[]>;
+    getSpeechToText: (configurationId: string, blob: Blob) => Promise<string>;
+    getTextToSpeech: (configurationId: string, content: string) => Promise<Blob>;
+    getAssistantChatConnection: (configurationId: string) => AssistantChatConnection;
+    sendMessage: (configurationId: string, content: string, context?: Record<string, string>) => Promise<ReadableStream<ChatStreamChunk>>;
+    sendToolCallResults: (configurationId: string, calls: ChatToolCall[], results: ChatToolCallResult[], agent?: string) => Promise<ReadableStream<ChatStreamChunk>>;
+    generateShareLink: (configurationId: string, revisionId: string, expiration: number, access: AccessLevel, baseUrl: string | undefined) => Promise<{
+        readonly link: string;
+    }>;
+    generateUploadLinks: (configurationId: string, finalizationUuid: string, names: string[]) => Promise<readonly {
+        readonly name: string;
+        readonly url: string;
+    }[]>;
+    getConfigurationPublicUploadLink: (configurationId: string, key: string) => Promise<{
+        readonly uploadUrl: string;
+        readonly url: string;
+    }>;
+    getConfigurationPrivateUploadLink: (configurationId: string, key: string) => Promise<{
+        readonly uploadUrl: string;
+    }>;
+    getConfigurationPrivateResourceLink: (configurationId: string, key: string) => Promise<{
+        readonly url: string;
+    }>;
+    cloneConfiguration: (configurationId: string, revisionId: string) => Promise<{
+        readonly accessToken: string;
+        readonly configurationId: components['schemas']['ConfigurationUuid'];
+        readonly readToken: string;
+        readonly revisionId: components['schemas']['RevisionUuid'];
+    }>;
+}