@salsita-ai/sdk 0.50.0-develop.eb204e0da4 → 0.50.0-develop.f42416a4e6

package/dist/phoenix/services/index.d.ts

@@ -11,6 +11,7 @@ export { patchConsole, type PatchConsoleOptions } from './console-capture.js';
 export { WebhookTunnelMonitor, type TunnelEvent, type TunnelRequestEntry, type TunnelRequestSummary, type TunnelStatus, type TunnelStatusState, } from './webhook-tunnel-monitor.js';
 export { compileWithSwc, watchWithSwc } from './swc.js';
 export { STORY_DEV_MARKER_PATH, readActiveStoryDevMarker, type StoryDevMarker } from './story-dev-marker.js';
+export { composeDefaultBanner } from './phx-banner-plugin.js';
 export { getViteBuildConfigs, getViteDevConfig, setViteLogSink, type ViteLogSink, type ViteLogSinkOptions, } from './vite-config.js';
 export { getServerCredentials, removeServerCredentials, saveServerCredentials } from './cli-credentials.js';
 export { createSourceArchive, extractSourceArchive } from './source-archive.js';

package/dist/phoenix/services/index.js

@@ -1 +1 @@
-export{PhoenixPubSub}from"./phoenix-pubsub.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";
+export{PhoenixPubSub}from"./phoenix-pubsub.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{composeDefaultBanner}from"./phx-banner-plugin.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";

package/dist/phoenix/services/phx-banner-plugin.d.ts

@@ -0,0 +1,32 @@
+import type { Plugin } from 'vite';
+export interface BannerBundleChunk {
+    readonly type: 'chunk';
+    readonly fileName: string;
+    code: string;
+}
+export interface BannerBundleAsset {
+    readonly type: 'asset';
+    readonly fileName: string;
+    source: string | Uint8Array;
+}
+export type BannerBundleItem = BannerBundleChunk | BannerBundleAsset;
+export type BannerBundle = Record<string, BannerBundleItem>;
+/** What the comment at the top of every frontend JavaScript file is composed from. */
+export interface BannerCommentProps {
+    /** Version of the SDK running the build, named in the Salsita notice. */
+    readonly sdkVersion: string;
+    /** The caller's `--banner` text, or the default line when the option is not given. It is public in every bundle. */
+    readonly banner: string | undefined;
+}
+/** What `phoenix build` knows about the application on its own, for the banner line used when `--banner` is not given. */
+export interface DefaultBannerProps {
+    /** `applicationVersion` of the application spec. */
+    readonly applicationVersion: string | undefined;
+    /** Commit checked out in the project; undefined when the build does not run in a git checkout. */
+    readonly commit: string | undefined;
+}
+export declare const composeDefaultBanner: (props: DefaultBannerProps) => string | undefined;
+export declare const composeBannerComment: (props: BannerCommentProps) => string;
+export declare const prependBannerToBundle: (bundle: BannerBundle, comment: string) => void;
+/** Must be the last plugin of a build config: whatever prepends to a bundle after it takes byte 0 from the comment. */
+export declare const phxBannerPlugin: (props: BannerCommentProps) => Plugin;

package/dist/phoenix/services/phx-banner-plugin.js

@@ -0,0 +1 @@
+import{THIRD_PARTY_LICENSES_FILE_NAME as e}from"./phx-licenses-plugin.js";let n=/\r\n|[\n\r\u2028\u2029]/,o=e=>e.split(n).map(e=>e.trim()).filter(e=>e.length>0).map(e=>` * ${e.replaceAll("*/","*\\/")}`);export const composeDefaultBanner=e=>{let n=[...void 0===e.applicationVersion?[]:[`App version: ${e.applicationVersion}`],...void 0===e.commit?[]:[`Commit: ${e.commit}`]];return 0===n.length?void 0:n.join("; ")};export const composeBannerComment=n=>["/*!",...o(n.banner??""),...o(`Built with Salsita SDK ${n.sdkVersion}. Copyright (c) Salsita s.r.o. All rights reserved.`),...o(`Third-party licences: ${e}`)," */",""].join("\n");export const prependBannerToBundle=(e,n)=>{for(let o of Object.values(e))o.fileName.endsWith(".js")&&("chunk"===o.type?o.code=`${n}${o.code}`:"string"==typeof o.source?o.source=`${n}${o.source}`:o.source=Buffer.concat([Buffer.from(n),o.source]))};export const phxBannerPlugin=e=>{let n=composeBannerComment(e);return{name:"vite:phx-banner",enforce:"post",generateBundle(e,o){prependBannerToBundle(o,n)}}};

package/dist/phoenix/services/phx-licenses-plugin.d.ts

@@ -0,0 +1,55 @@
+import type { Plugin } from 'vite';
+/** Name of the licences file the frontend build writes next to its bundles; the banner comment points to it. */
+export declare const THIRD_PARTY_LICENSES_FILE_NAME = "THIRD-PARTY-LICENSES.txt";
+/** A third-party package whose code ended up in a frontend bundle, as it is listed in the licences file. */
+export interface LicensedPackage {
+    readonly name: string;
+    readonly version: string;
+    /** Licence declared in the package's `package.json`; `UNKNOWN` when it declares none. */
+    readonly license: string;
+    /** Content of the package's licence file; undefined when the package ships none. */
+    readonly text: string | undefined;
+}
+/**
+ * Packages found so far by one `phoenix build`. Its frontend builds share one collection, so the licences file each
+ * of them writes into the common output folder is cumulative and the last one is complete.
+ */
+export interface LicenseCollection {
+    /** Listed packages by `name@version`. */
+    readonly packages: Map<string, LicensedPackage>;
+    /** Resolution cache by module directory, so a package's files are read once per build command. */
+    readonly packageByDirectory: Map<string, LicensedPackage | undefined>;
+}
+export interface LicensesBundleChunk {
+    readonly type: 'chunk';
+    readonly modules: Readonly<Record<string, {
+        readonly renderedLength: number;
+    }>>;
+}
+export interface LicensesBundleAsset {
+    readonly type: 'asset';
+}
+export type LicensesBundle = Record<string, LicensesBundleChunk | LicensesBundleAsset>;
+/**
+ * Finds the package a bundled module belongs to: the nearest named `package.json` above the module's real path that
+ * is still under a `node_modules` folder. Project source, workspace-linked packages and virtual modules have none.
+ */
+export declare const resolvePackageForModule: (id: string) => LicensedPackage | undefined;
+export declare const createLicenseCollection: () => LicenseCollection;
+/**
+ * Adds the packages behind every module that left code or styles in the bundle; tree-shaken modules are not listed.
+ *
+ * Known gap: only Rollup modules are seen. What a stylesheet pulls in itself (CSS `@import`, Sass `@use`, files behind
+ * `url()`) is inlined or emitted by Vite's CSS handling without becoming a module, so those packages are not listed.
+ */
+export declare const addBundlePackages: (bundle: LicensesBundle, collection: LicenseCollection) => void;
+export declare const formatLicenses: (packages: readonly LicensedPackage[]) => string;
+/**
+ * Lists the third-party packages bundled into the frontend output. Create one instance per `phoenix build` and add it
+ * to every frontend build config, so all of them contribute to the one file.
+ *
+ * Known gap: packages used only inside a web worker are not listed. Vite bundles a worker in a build of its own that
+ * runs `worker.plugins` instead of these; registering the plugin there would make every worker build emit a partial
+ * file under the same name.
+ */
+export declare const phxLicensesPlugin: () => Plugin;

package/dist/phoenix/services/phx-licenses-plugin.js

@@ -0,0 +1,8 @@
+import{readFileSync as e,readdirSync as t,realpathSync as s}from"fs";import{dirname as n,isAbsolute as r,join as a}from"path";import{z as i}from"zod";export const THIRD_PARTY_LICENSES_FILE_NAME="THIRD-PARTY-LICENSES.txt";let c=/[\\/]node_modules[\\/]/,o=[/^license/i,/^licence/i,/^copying/i],l="-".repeat(80),p=/\.(css|scss|sass|less|styl|stylus|pcss|postcss|sss)(\?|$)/,u=i.object({name:i.string().min(1),version:i.string().min(1),license:i.unknown(),licenses:i.unknown()}),f=i.object({type:i.string().min(1)}),m=s=>{let n,r;try{n=e(a(s,"package.json"),"utf-8")}catch{return}try{r=JSON.parse(n)}catch{return}let c=u.safeParse(r);if(c.success)return{name:c.data.name,version:c.data.version,license:(e=>{if("string"==typeof e.license&&e.license.length>0)return e.license;let t=i.array(f).safeParse(Array.isArray(e.licenses)?e.licenses:[e.license]);return t.success&&0!==t.data.length?t.data.map(e=>e.type).join(" OR "):"UNKNOWN"})(c.data),text:(s=>{let n=t(s,{withFileTypes:!0}).filter(e=>e.isFile()).map(e=>e.name).sort();for(let t of o){let r=n.find(e=>t.test(e));if(void 0!==r)return e(a(s,r),"utf-8").trim()}})(s)}},d=(e,t)=>e.name!==t.name?e.name<t.name?-1:1:e.version.localeCompare(t.version,"en",{numeric:!0});export const resolvePackageForModule=e=>{let t=e.replace(/[?#].*$/,"");if(e.startsWith("\0")||!r(t))return;let a=n((e=>{try{return s(e)}catch{return e}})(t));for(;c.test(a);){let e=m(a);if(void 0!==e)return e;a=n(a)}};export const createLicenseCollection=()=>({packages:new Map,packageByDirectory:new Map});export const addBundlePackages=(e,t)=>{for(let s of Object.values(e))if("chunk"===s.type)for(let[e,r]of Object.entries(s.modules)){if(0===r.renderedLength&&!p.test(e))continue;let s=n(e);t.packageByDirectory.has(s)||t.packageByDirectory.set(s,resolvePackageForModule(e));let a=t.packageByDirectory.get(s);if(void 0===a)continue;let i=`${a.name}@${a.version}`;t.packages.has(i)||t.packages.set(i,a)}};export const formatLicenses=e=>["Third-party software bundled into the JavaScript files in this folder, with the licence of each package.",...[...e].sort(d).map(e=>{let t=`${e.name} ${e.version}
+License: ${e.license}`;return void 0===e.text?t:`${t}
+
+${e.text}`})].join(`
+
+${l}
+
+`).concat("\n");export const phxLicensesPlugin=()=>{let e=createLicenseCollection();return{name:"vite:phx-licenses",enforce:"post",generateBundle(t,s){addBundlePackages(s,e),this.emitFile({type:"asset",fileName:"THIRD-PARTY-LICENSES.txt",source:formatLicenses([...e.packages.values()])})}}};

package/dist/phoenix/services/vite-config.d.ts

@@ -17,4 +17,6 @@ export declare const getViteDevConfig: (options?: {
 export declare const getViteBuildConfigs: (options: {
     enableEditor?: boolean;
     templateFiles: readonly string[];
+    sdkVersion: string;
+    banner: string | undefined;
 }) => Promise<InlineConfig[]>;

package/dist/phoenix/services/vite-config.js

@@ -1 +1 @@
-import{lingui as e}from"@lingui/vite-plugin";import i from"@vitejs/plugin-react";import{mkdir as t,readFile as n,writeFile as r}from"fs/promises";import o from"lodash-es/camelCase.js";import{createRequire as a}from"node:module";import{dirname as s,resolve as m}from"path";import{createLogger as l}from"vite";import d from"vite-plugin-css-injected-by-js";import{isUsingLocalSdk as f}from"../utils/package-info.js";import{loadFrontendConfigModule as c}from"./frontend-config.js";import{phxCspNoncePlugin as p}from"./phx-csp-nonce-plugin.js";import{phxGlobalIsolationPlugin as g}from"./phx-global-isolation-plugin.js";let u=null;export const setViteLogSink=(e,i={})=>{u={sink:e,echo:i.echo??!1}};let h=["react","react-dom","three","@react-three/fiber","@react-three/drei","@react-three/postprocessing","its-fine","@emotion/react","@emotion/styled","@mui/material","@mui/system","@tanstack/react-query","rxjs"],S=e=>{let i=e.DEPLOYMENT_ID;if("string"!=typeof i)throw Error("DEPLOYMENT_ID is required in runtime config");return i};export const getViteDevConfig=async t=>{var n,r;let o,d,p=f(),y=c(),O=y.readRuntimeConfig(),b=y.frontendBuildConfig,D=Object.fromEntries((t?.templateFiles??[]).map(e=>[e,`.phoenix/${e}`]));return{...u&&{customLogger:(n=u.sink,r=u.echo,o=l(),{get hasWarned(){return o.hasWarned},info:(e,i)=>{n("info",e),r&&o.info(e,i)},warn:(e,i)=>{n("warn",e),r&&o.warn(e,i)},warnOnce:(e,i)=>{n("warn",e),r&&o.warnOnce(e,i)},error:(e,i)=>{n("error",e),r&&o.error(e,i)},clearScreen:e=>{r&&o.clearScreen(e)},hasErrorLogged:e=>o.hasErrorLogged(e)}),...u.echo?{}:{clearScreen:!1}},mode:"development",optimizeDeps:{exclude:["@swc/wasm-web"],...p&&{entries:["index.html","admin.html",...t?.templateFiles??[]],force:!0}},...p&&{resolve:{alias:(d=a(m(process.cwd(),"package.json")),h.flatMap(e=>{try{let i=s(d.resolve(`${e}/package.json`));return[{find:RegExp(`^${e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}(/|$)`),replacement:`${i}$1`}]}catch{return[]}}))}},plugins:[i({babel:{plugins:["macros"]}}),e(),{name:"vite:runtime-config",apply:(e,i)=>"build"===i.command||"development"===i.mode,config:e=>{let i=y.readRuntimeConfig(),t=y.frontendBuildConfig;return{...e,define:{...e.define,"phx.frontendEnv":JSON.stringify(i),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(t.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(t.gltfDecoder)}}}},g({getDeploymentId:()=>S(y.readRuntimeConfig())})],define:{"process.env":{},"import.meta.env.DEV":!0,"import.meta.env.PROD":!1,"phx.frontendEnv":JSON.stringify(O),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(b.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(b.gltfDecoder)},build:{rollupOptions:{input:{index:".phoenix/index.html",admin:".phoenix/admin.html",...D}}},root:m(process.cwd(),"./.phoenix"),server:{watch:{ignored:["./**/*.{ts,tsx}","./.swc/**","../spec/**","../src/**"]}}}};export const getViteBuildConfigs=async a=>{let l=c(),f=l.readRuntimeConfig(),u=l.frontendBuildConfig,h=[{name:"salsita-configurator",entryFile:"./configurator.ts",mainScriptPath:"./configurator.ts",htmlFiles:["./index.html",...{templateFiles:a.templateFiles}.templateFiles],main:!0,format:"iife"},{name:"salsita-admin",entryFile:"./admin.ts",mainScriptPath:"./admin.ts",htmlFiles:["./admin.html"],main:!1,format:"iife"},{name:"salsita-embedded-admin",entryFile:"./embedded-admin.ts",mainScriptPath:"./embedded-admin.ts",htmlFiles:[],main:!1,format:"es"},{name:"salsita-embedded-configurator",entryFile:"./embedded-configurator.ts",mainScriptPath:"./embedded-configurator.ts",htmlFiles:[],main:!1,format:"es"}].map(c=>({plugins:[i({babel:{plugins:["macros"]}}),e(),d({useStrictCSP:!0}),p(),g({getDeploymentId:()=>S(l.readRuntimeConfig())}),{name:"vite:lib-index",writeBundle:async()=>{if(!c.htmlFiles.length)return;let e="iife"===c.format?`${c.name}.iife.js`:`${c.name}.js`;for(let i of c.htmlFiles){if(c.main&&a.enableEditor&&"./index.html"===i)continue;let o=m("./.phoenix",i),l=m("./.phoenix/dist/frontend",i);await t(s(l),{recursive:!0});let d=(await n(o,"utf-8")).replace(c.mainScriptPath,e);await r(l,d,"utf-8")}}}],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,lib:{entry:c.entryFile,name:o(c.name),formats:[c.format],fileName:()=>"iife"===c.format?`${c.name}.iife.js`:`${c.name}.js`},rollupOptions:{external:[],output:{assetFileNames:`${c.name}.[ext]`}},minify:!0,emptyOutDir:!1},root:m(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(f),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(u.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(u.gltfDecoder)}}));return a.enableEditor?[...h,{plugins:[i({babel:{plugins:["macros"]}}),e(),d({useStrictCSP:!0}),p()],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,rollupOptions:{external:[]},minify:!0,emptyOutDir:!1},root:m(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(f),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(u.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(u.gltfDecoder)}}]:h};
+import{lingui as e}from"@lingui/vite-plugin";import i from"@vitejs/plugin-react";import{mkdir as t,readFile as n,writeFile as r}from"fs/promises";import o from"lodash-es/camelCase.js";import{createRequire as a}from"node:module";import{dirname as s,resolve as m}from"path";import{createLogger as l}from"vite";import d from"vite-plugin-css-injected-by-js";import{isUsingLocalSdk as f}from"../utils/package-info.js";import{loadFrontendConfigModule as p}from"./frontend-config.js";import{phxBannerPlugin as c}from"./phx-banner-plugin.js";import{phxCspNoncePlugin as g}from"./phx-csp-nonce-plugin.js";import{phxGlobalIsolationPlugin as u}from"./phx-global-isolation-plugin.js";import{phxLicensesPlugin as h}from"./phx-licenses-plugin.js";let S=null;export const setViteLogSink=(e,i={})=>{S={sink:e,echo:i.echo??!1}};let b=["react","react-dom","three","@react-three/fiber","@react-three/drei","@react-three/postprocessing","its-fine","@emotion/react","@emotion/styled","@mui/material","@mui/system","@tanstack/react-query","rxjs"],y=e=>{let i=e.DEPLOYMENT_ID;if("string"!=typeof i)throw Error("DEPLOYMENT_ID is required in runtime config");return i};export const getViteDevConfig=async t=>{var n,r;let o,d,c=f(),g=p(),h=g.readRuntimeConfig(),O=g.frontendBuildConfig,x=Object.fromEntries((t?.templateFiles??[]).map(e=>[e,`.phoenix/${e}`]));return{...S&&{customLogger:(n=S.sink,r=S.echo,o=l(),{get hasWarned(){return o.hasWarned},info:(e,i)=>{n("info",e),r&&o.info(e,i)},warn:(e,i)=>{n("warn",e),r&&o.warn(e,i)},warnOnce:(e,i)=>{n("warn",e),r&&o.warnOnce(e,i)},error:(e,i)=>{n("error",e),r&&o.error(e,i)},clearScreen:e=>{r&&o.clearScreen(e)},hasErrorLogged:e=>o.hasErrorLogged(e)}),...S.echo?{}:{clearScreen:!1}},mode:"development",optimizeDeps:{exclude:["@swc/wasm-web"],...c&&{entries:["index.html","admin.html",...t?.templateFiles??[]],force:!0}},...c&&{resolve:{alias:(d=a(m(process.cwd(),"package.json")),b.flatMap(e=>{try{let i=s(d.resolve(`${e}/package.json`));return[{find:RegExp(`^${e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}(/|$)`),replacement:`${i}$1`}]}catch{return[]}}))}},plugins:[i({babel:{plugins:["macros"]}}),e(),{name:"vite:runtime-config",apply:(e,i)=>"build"===i.command||"development"===i.mode,config:e=>{let i=g.readRuntimeConfig(),t=g.frontendBuildConfig;return{...e,define:{...e.define,"phx.frontendEnv":JSON.stringify(i),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(t.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(t.gltfDecoder)}}}},u({getDeploymentId:()=>y(g.readRuntimeConfig())})],define:{"process.env":{},"import.meta.env.DEV":!0,"import.meta.env.PROD":!1,"phx.frontendEnv":JSON.stringify(h),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(O.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(O.gltfDecoder)},build:{rollupOptions:{input:{index:".phoenix/index.html",admin:".phoenix/admin.html",...x}}},root:m(process.cwd(),"./.phoenix"),server:{watch:{ignored:["./**/*.{ts,tsx}","./.swc/**","../spec/**","../src/**"]}}}};export const getViteBuildConfigs=async a=>{let l=p(),f=l.readRuntimeConfig(),S=l.frontendBuildConfig,b=h(),O=c({sdkVersion:a.sdkVersion,banner:a.banner}),x=[{name:"salsita-configurator",entryFile:"./configurator.ts",mainScriptPath:"./configurator.ts",htmlFiles:["./index.html",...{templateFiles:a.templateFiles}.templateFiles],main:!0,format:"iife"},{name:"salsita-admin",entryFile:"./admin.ts",mainScriptPath:"./admin.ts",htmlFiles:["./admin.html"],main:!1,format:"iife"},{name:"salsita-embedded-admin",entryFile:"./embedded-admin.ts",mainScriptPath:"./embedded-admin.ts",htmlFiles:[],main:!1,format:"es"},{name:"salsita-embedded-configurator",entryFile:"./embedded-configurator.ts",mainScriptPath:"./embedded-configurator.ts",htmlFiles:[],main:!1,format:"es"}].map(p=>({plugins:[i({babel:{plugins:["macros"]}}),e(),d({useStrictCSP:!0}),g(),u({getDeploymentId:()=>y(l.readRuntimeConfig())}),{name:"vite:lib-index",writeBundle:async()=>{if(!p.htmlFiles.length)return;let e="iife"===p.format?`${p.name}.iife.js`:`${p.name}.js`;for(let i of p.htmlFiles){if(p.main&&a.enableEditor&&"./index.html"===i)continue;let o=m("./.phoenix",i),l=m("./.phoenix/dist/frontend",i);await t(s(l),{recursive:!0});let d=(await n(o,"utf-8")).replace(p.mainScriptPath,e);await r(l,d,"utf-8")}}},b,O],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,lib:{entry:p.entryFile,name:o(p.name),formats:[p.format],fileName:()=>"iife"===p.format?`${p.name}.iife.js`:`${p.name}.js`},rollupOptions:{external:[],output:{assetFileNames:`${p.name}.[ext]`}},minify:!0,emptyOutDir:!1},root:m(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(f),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(S.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(S.gltfDecoder)}}));return a.enableEditor?[...x,{plugins:[i({babel:{plugins:["macros"]}}),e(),d({useStrictCSP:!0}),g(),b,O],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,rollupOptions:{external:[]},minify:!0,emptyOutDir:!1},root:m(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(f),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(S.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(S.gltfDecoder)}}]:x};

package/dist/phoenix/utils/index.d.ts

@@ -7,5 +7,6 @@ export { FileLogger } from './file-logger.js';
 export { type Logger, type CreateLoggerOptions, createLogger } from './logger.js';
 export { addWorkspaceOverrides, ensureWorkspaceInstallSettings, getLocalOverrides, getSdkPackages, getWorkspaceDir, hasLocalOverrides, readPackageJson, removeWorkspaceOverrides, } from './package-info.js';
 export { toPascalCase } from './pascal-case.js';
+export { readGitCommit } from './read-git-commit.js';
 export { type RunCommandProps, runCommand } from './run-command.js';
 export { type FileUploadInfo, type UploadLinksData, uploadFilesWithPresignedUrls, readUploadLinks, } from './upload-utils.js';

package/dist/phoenix/utils/index.js

@@ -1 +1 @@
-export{askQuestion}from"./ask-question.js";export{checkBundleSizeBudgets}from"./check-bundle-size-budgets.js";export{formatEnvContent,formatEnvLine}from"./env-file.js";export{parseChangelog,getLatestVersion,getVersion,paginateVersions,getVersionNumbers}from"./changelog-parser.js";export{createDirectoryFromYaml,exists,scanFolderForFiles,syncChangedFiles,syncExistingFolders,validateFolders,writeFileIfNotExists,writeFilesIfNotExists,writeRawFiles}from"./file-system.js";export{FileLogger}from"./file-logger.js";export{createLogger}from"./logger.js";export{addWorkspaceOverrides,ensureWorkspaceInstallSettings,getLocalOverrides,getSdkPackages,getWorkspaceDir,hasLocalOverrides,readPackageJson,removeWorkspaceOverrides}from"./package-info.js";export{toPascalCase}from"./pascal-case.js";export{runCommand}from"./run-command.js";export{uploadFilesWithPresignedUrls,readUploadLinks}from"./upload-utils.js";
+export{askQuestion}from"./ask-question.js";export{checkBundleSizeBudgets}from"./check-bundle-size-budgets.js";export{formatEnvContent,formatEnvLine}from"./env-file.js";export{parseChangelog,getLatestVersion,getVersion,paginateVersions,getVersionNumbers}from"./changelog-parser.js";export{createDirectoryFromYaml,exists,scanFolderForFiles,syncChangedFiles,syncExistingFolders,validateFolders,writeFileIfNotExists,writeFilesIfNotExists,writeRawFiles}from"./file-system.js";export{FileLogger}from"./file-logger.js";export{createLogger}from"./logger.js";export{addWorkspaceOverrides,ensureWorkspaceInstallSettings,getLocalOverrides,getSdkPackages,getWorkspaceDir,hasLocalOverrides,readPackageJson,removeWorkspaceOverrides}from"./package-info.js";export{toPascalCase}from"./pascal-case.js";export{readGitCommit}from"./read-git-commit.js";export{runCommand}from"./run-command.js";export{uploadFilesWithPresignedUrls,readUploadLinks}from"./upload-utils.js";

package/dist/phoenix/utils/read-git-commit.d.ts

@@ -0,0 +1,14 @@
+export interface ReadGitCommitProps {
+    readonly directory: string;
+    /**
+     * A file of the project, relative to `directory`, that its repository tracks. git looks for a repository in every
+     * parent folder, so sources unpacked inside an unrelated checkout would otherwise report that checkout's commit.
+     */
+    readonly trackedFile: string;
+}
+/**
+ * Full SHA of the commit checked out in the project's own repository. Undefined when git cannot read one: no
+ * checkout, git missing or refusing the repository, no commit yet, or the project is not tracked by the repository
+ * around it. That is normal for a build from uploaded sources.
+ */
+export declare const readGitCommit: (props: ReadGitCommitProps) => Promise<string | undefined>;

package/dist/phoenix/utils/read-git-commit.js

@@ -0,0 +1 @@
+import{execFile as t}from"node:child_process";import{promisify as e}from"node:util";let r=e(t),i=/^[0-9a-f]{40,64}$/;export const readGitCommit=async t=>{let e={cwd:t.directory,timeout:5e3,windowsHide:!0};try{await r("git",["ls-files","--error-unmatch","--",t.trackedFile],e);let{stdout:o}=await r("git",["rev-parse","HEAD"],e),a=o.trim();return i.test(a)?a:void 0}catch{return}};

package/dist/react-sdk/application-runtime/runtime/create-application-runtime.d.ts

@@ -404,6 +404,8 @@ export declare function createApplicationRuntimeSlices<State extends Application
                 getActiveConfigurationId: () => string;
                 getFactory: () => import("#package/domain").AnyDomainFactory;
                 getDomainExpressions: () => import("#package/domain").AnyExpressions;
+                getActionDefinitions: () => Readonly<Record<string, import("#package/domain").ActionDefinition>>;
+                getActionImplementations: () => Readonly<Record<string, import("#package/domain").AnyActionImplementation>>;
                 getModelVersion: () => number;
                 getAliasMap: () => import("#package/domain").AnyAliasMap;
                 getAllowedRootEntityTypes: () => import("#package/domain").AnyAllowedRootEntityTypes;
@@ -444,6 +446,7 @@ export declare function createApplicationRuntimeSlices<State extends Application
                 getNavigationSystem: () => import("../../../domain/domain-context/navigation-system/navigation-system.js").AnyNavigationSystem;
                 getUndoSystem: () => import("../../../domain/domain-context/undo-system.js").AnyUndoSystem;
                 getRecipeCookerSystem: () => import("#package/domain").AnyRecipeCookerSystem;
+                getActionSystem: () => import("#package/domain").AnyActionSystem;
                 getBlenderProjections: () => import("#package/domain").AnyBlenderProjections;
                 getExpressionContext: () => import("#package/domain").AnyExpressionContext;
                 getDomainSystems: () => import("#package/domain").AnyDomainContextSystems;
@@ -510,6 +513,8 @@ export declare function createApplicationRuntimeSlices<State extends Application
                 getActiveConfigurationId: () => string;
                 getFactory: () => import("#package/domain").AnyDomainFactory;
                 getDomainExpressions: () => import("#package/domain").AnyExpressions;
+                getActionDefinitions: () => Readonly<Record<string, import("#package/domain").ActionDefinition>>;
+                getActionImplementations: () => Readonly<Record<string, import("#package/domain").AnyActionImplementation>>;
                 getModelVersion: () => number;
                 getAliasMap: () => import("#package/domain").AnyAliasMap;
                 getAllowedRootEntityTypes: () => import("#package/domain").AnyAllowedRootEntityTypes;
@@ -550,6 +555,7 @@ export declare function createApplicationRuntimeSlices<State extends Application
                 getNavigationSystem: () => import("../../../domain/domain-context/navigation-system/navigation-system.js").AnyNavigationSystem;
                 getUndoSystem: () => import("../../../domain/domain-context/undo-system.js").AnyUndoSystem;
                 getRecipeCookerSystem: () => import("#package/domain").AnyRecipeCookerSystem;
+                getActionSystem: () => import("#package/domain").AnyActionSystem;
                 getBlenderProjections: () => import("#package/domain").AnyBlenderProjections;
                 getExpressionContext: () => import("#package/domain").AnyExpressionContext;
                 getDomainSystems: () => import("#package/domain").AnyDomainContextSystems;
@@ -1058,6 +1064,8 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
                 getActiveConfigurationId: () => string;
                 getFactory: () => import("#package/domain").AnyDomainFactory;
                 getDomainExpressions: () => import("#package/domain").AnyExpressions;
+                getActionDefinitions: () => Readonly<Record<string, import("#package/domain").ActionDefinition>>;
+                getActionImplementations: () => Readonly<Record<string, import("#package/domain").AnyActionImplementation>>;
                 getModelVersion: () => number;
                 getAliasMap: () => import("#package/domain").AnyAliasMap;
                 getAllowedRootEntityTypes: () => import("#package/domain").AnyAllowedRootEntityTypes;
@@ -1098,6 +1106,7 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
                 getNavigationSystem: () => import("../../../domain/domain-context/navigation-system/navigation-system.js").AnyNavigationSystem;
                 getUndoSystem: () => import("../../../domain/domain-context/undo-system.js").AnyUndoSystem;
                 getRecipeCookerSystem: () => import("#package/domain").AnyRecipeCookerSystem;
+                getActionSystem: () => import("#package/domain").AnyActionSystem;
                 getBlenderProjections: () => import("#package/domain").AnyBlenderProjections;
                 getExpressionContext: () => import("#package/domain").AnyExpressionContext;
                 getDomainSystems: () => import("#package/domain").AnyDomainContextSystems;
@@ -1164,6 +1173,8 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
                 getActiveConfigurationId: () => string;
                 getFactory: () => import("#package/domain").AnyDomainFactory;
                 getDomainExpressions: () => import("#package/domain").AnyExpressions;
+                getActionDefinitions: () => Readonly<Record<string, import("#package/domain").ActionDefinition>>;
+                getActionImplementations: () => Readonly<Record<string, import("#package/domain").AnyActionImplementation>>;
                 getModelVersion: () => number;
                 getAliasMap: () => import("#package/domain").AnyAliasMap;
                 getAllowedRootEntityTypes: () => import("#package/domain").AnyAllowedRootEntityTypes;
@@ -1204,6 +1215,7 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
                 getNavigationSystem: () => import("../../../domain/domain-context/navigation-system/navigation-system.js").AnyNavigationSystem;
                 getUndoSystem: () => import("../../../domain/domain-context/undo-system.js").AnyUndoSystem;
                 getRecipeCookerSystem: () => import("#package/domain").AnyRecipeCookerSystem;
+                getActionSystem: () => import("#package/domain").AnyActionSystem;
                 getBlenderProjections: () => import("#package/domain").AnyBlenderProjections;
                 getExpressionContext: () => import("#package/domain").AnyExpressionContext;
                 getDomainSystems: () => import("#package/domain").AnyDomainContextSystems;

package/dist/react-sdk/domain-context/common-hooks/use-domain-context.d.ts

@@ -60,6 +60,8 @@ export declare const useDomainContextSelectors: () => {
     getActiveConfigurationId: () => string;
     getFactory: () => import("#package/domain").AnyDomainFactory;
     getDomainExpressions: () => import("#package/domain").AnyExpressions;
+    getActionDefinitions: () => Readonly<Record<string, import("#package/domain").ActionDefinition>>;
+    getActionImplementations: () => Readonly<Record<string, import("#package/domain").AnyActionImplementation>>;
     getModelVersion: () => number;
     getAliasMap: () => import("#package/domain").AnyAliasMap;
     getAllowedRootEntityTypes: () => import("#package/domain").AnyAllowedRootEntityTypes;
@@ -100,6 +102,7 @@ export declare const useDomainContextSelectors: () => {
     getNavigationSystem: () => import("../../../domain/domain-context/navigation-system/navigation-system.js").AnyNavigationSystem;
     getUndoSystem: () => import("../../../domain/domain-context/undo-system.js").AnyUndoSystem;
     getRecipeCookerSystem: () => import("#package/domain").AnyRecipeCookerSystem;
+    getActionSystem: () => import("#package/domain").AnyActionSystem;
     getBlenderProjections: () => import("#package/domain").AnyBlenderProjections;
     getExpressionContext: () => import("#package/domain").AnyExpressionContext;
     getDomainSystems: () => import("#package/domain").AnyDomainContextSystems;

package/dist/ui-sdk/theme/types.d.ts

@@ -44,6 +44,7 @@ declare module '@mui/material/styles' {
         PhxChat: 'root';
         PhxChatFooter: 'root' | 'formLayout' | 'input';
         PhxChatMessage: 'base' | 'assistant' | 'user' | 'widget' | 'error' | 'helper';
+        PhxAssistantPanel: 'root' | 'header' | 'title' | 'closeButton' | 'thread' | 'greeting' | 'messages' | 'userMessage' | 'assistantMessage' | 'chips' | 'activity' | 'activityIcon' | 'chip' | 'status' | 'notice' | 'newReplyButton' | 'composer' | 'inputFrame' | 'input' | 'sendButton' | 'stopButton' | 'hint';
         PhxTopNavigation: 'root' | 'stepper' | 'step';
         PhxListSelector: 'root';
         PhxListSelectorItem: 'root' | 'radio' | 'title' | 'description' | 'formControlLabel';
@@ -109,6 +110,9 @@ declare module '@mui/material/styles' {
         PhxChatMessage?: {
             styleOverrides?: ComponentsOverrides<Theme>['PhxChatMessage'];
         };
+        PhxAssistantPanel?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxAssistantPanel'];
+        };
         PhxPreviewLayout?: {
             styleOverrides?: ComponentsOverrides<Theme>['PhxPreviewLayout'];
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salsita-ai/sdk",
-  "version": "0.50.0-develop.eb204e0da4",
+  "version": "0.50.0-develop.f42416a4e6",
   "description": "TypeScript SDK and CLI for building, running, and deploying Phoenix configurator applications.",
   "keywords": [
     "salsita",
@@ -149,10 +149,6 @@
       "import": "./dist/extras/ai-preview/index.js",
       "types": "./dist/extras/ai-preview/index.d.ts"
     },
-    "./extras/assistant": {
-      "import": "./dist/extras/assistant/index.js",
-      "types": "./dist/extras/assistant/index.d.ts"
-    },
     "./common/utils": {
       "import": "./dist/common/utils.js",
       "types": "./dist/common/utils.d.ts"
@@ -275,6 +271,7 @@
     "react-json-tree": "0.20.0",
     "react-markdown": "9.0.1",
     "remark": "15.0.1",
+    "remark-gfm": "4.0.0",
     "rxjs": "7.8.2",
     "semver": "7.6.3",
     "spark-md5": "3.0.2",
@@ -295,8 +292,8 @@
     "yaml": "2.9.0",
     "yargs": "17.7.2",
     "zod": "3.25.76",
-    "@salsita-ai/common": "0.50.0-develop.eb204e0da4",
-    "@salsita-ai/contracts": "0.50.0-develop.eb204e0da4"
+    "@salsita-ai/contracts": "0.50.0-develop.f42416a4e6",
+    "@salsita-ai/common": "0.50.0-develop.f42416a4e6"
   },
   "devDependencies": {
     "@clerk/clerk-react": "5.61.8",

package/schema/domain-spec.json

@@ -18586,6 +18586,30 @@
           "required": ["kind"],
           "additionalProperties": false
         },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": ["assistantToolbarButton"]
+            },
+            "props": {
+              "type": "object",
+              "properties": {
+                "showTitle": {
+                  "type": "boolean"
+                },
+                "icon": {
+                  "type": "string"
+                }
+              },
+              "required": [],
+              "additionalProperties": false
+            }
+          },
+          "required": ["kind"],
+          "additionalProperties": false
+        },
         {
           "type": "object",
           "properties": {

package/dist/configurator/assistant/browser-details.js

@@ -1 +0,0 @@
-import{browserDetailsTool as e}from"@salsita-ai/contracts/assistant";let t=e=>{let t=[];for(let i=0;i<e.length;i+=64)t.push(e.slice(i,i+64));return t};export const browserDetailsClientTool=e.client(()=>{let e=(()=>{let e=[`User agent: ${navigator.userAgent}`,`Viewport: ${window.innerWidth} x ${window.innerHeight} px`,`Screen: ${window.screen.width} x ${window.screen.height} px`,`Device pixel ratio: ${window.devicePixelRatio}`,`Language: ${navigator.language}`,`Time zone: ${Intl.DateTimeFormat().resolvedOptions().timeZone}`].flatMap(t),i=document.createElement("canvas");i.width=720,i.height=48+26*e.length;let n=i.getContext("2d");if(!n)throw Error("The browser details capture failed because the canvas has no 2D context. Retry in another browser.");return n.fillStyle="#ffffff",n.fillRect(0,0,i.width,i.height),n.fillStyle="#111111",n.font="16px monospace",n.textBaseline="top",e.forEach((e,t)=>n.fillText(e,24,24+26*t)),i.toDataURL("image/png")})();return[{type:"image",source:{type:"data",value:e.slice(e.indexOf(",")+1),mimeType:"image/png"}}]});

package/dist/configurator/assistant/graphql-tools.js

@@ -1 +0,0 @@
-import{AssistantGraphQLToolInput as e,applyTool as t,queryTool as o}from"@salsita-ai/contracts/assistant";let a=e=>({results:[],committed:!1,message:e}),s=e=>JSON.parse(JSON.stringify(e)),i=t=>{let o=e.safeParse(t);if(!o.success){let e=o.error.issues.map(e=>`${e.path.join(".")}: ${e.message}`).join("; ");return{ok:!1,refusal:a(`Nothing was run, because the tool input is not a list of operations (${e}). Send { "operations": [{ "query": "<one GraphQL operation>" }] } with at least one item.`)}}return{ok:!0,operations:o.data.operations.map(({query:e,variables:t,operationName:o})=>({document:e,variables:t??void 0,operationName:o??void 0}))}};export const queryClientTool=o.client(async(e,{context:t})=>{let o=i(e);return o.ok?t.storeSystem.isInitialized?s({results:(await t.graphQLSystem.prepare(t.storeSystem.stateSlices.committed.value.state,o.operations)).map(({result:e})=>e),committed:!1}):a("Nothing was run, because the configuration is not loaded yet, so there is no state to query. Call the tool again once the configurator has finished loading."):o.refusal});export const applyClientTool=t.client(async(e,{context:t})=>{if("owner"!==t.getActiveMode())return a("Nothing was run, because changes cannot be applied in this session: the user may view this configuration but not change it. The query tool still works here, including mutations, to show what a change would do without keeping it.");let o=i(e);return o.ok?s(await t.graphQLSystem.execute(o.operations)):o.refusal});

package/dist/extras/assistant/AssistantChat.d.ts

@@ -1,6 +0,0 @@
-/**
- * Experimental, unstyled assistant chat for the current configuration: streamed replies, reasoning
- * summaries, tool calls with their payloads, a pending indicator and a stop button. It renders
- * nothing, and contacts no server, when the application spec has no `assistant` section.
- */
-export declare const AssistantChat: () => import("react/jsx-runtime").JSX.Element | null;

package/dist/extras/assistant/AssistantChat.js

@@ -1 +0,0 @@
-import{jsx as e,jsxs as t}from"react/jsx-runtime";import{Alert as r,Box as a,Button as i,LinearProgress as n,Stack as o,TextField as l,Typography as s}from"@mui/material";import{useState as c}from"react";import{useAssistantChat as p}from"#package/configurator";import{useSpecAssistant as m}from"#package/react-sdk";let d=({part:t})=>{switch(t.type){case"text":return e(s,{sx:{whiteSpace:"pre-wrap"},children:t.content});case"thinking":return e(s,{variant:"body2",color:"text.secondary",sx:{fontStyle:"italic",whiteSpace:"pre-wrap"},children:t.content});case"tool-call":return e(s,{variant:"caption",component:"pre",sx:{m:0,whiteSpace:"pre-wrap"},children:`${t.name}(${JSON.stringify(t.input??t.arguments)}) \xb7 ${t.state}`});case"tool-result":{let r=(e=>{if("string"!=typeof e){for(let t of e)if("image"===t.type&&"data"===t.source.type)return`data:${t.source.mimeType};base64,${t.source.value}`}})(t.content);return r?e(a,{component:"img",src:r,alt:"Tool result",sx:{maxWidth:"100%",border:1}}):e(s,{variant:"caption",children:`Tool result \xb7 ${t.state}`})}default:return null}},u=()=>{let{messages:m,send:u,stop:h,isLoading:f,error:x}=p(),[g,v]=c("");return t(o,{spacing:1.5,sx:{p:2},children:[m.map(r=>t(a,{component:"div",sx:{alignSelf:"user"===r.role?"flex-end":"flex-start",maxWidth:"85%"},children:[e(s,{variant:"overline",children:r.role}),r.parts.map((t,r)=>e(d,{part:t},r))]},r.id)),f&&e(n,{"aria-label":"Assistant is responding"}),x&&e(r,{severity:"warning",children:x.message}),e("form",{onSubmit:e=>{e.preventDefault();let t=g.trim();t&&(v(""),u(t))},children:t(o,{direction:"row",spacing:1,children:[e(l,{size:"small",fullWidth:!0,placeholder:"Ask the assistant…",value:g,onChange:e=>v(e.target.value)}),f?e(i,{onClick:()=>void h(),children:"Stop"}):e(i,{type:"submit",variant:"contained",disabled:!g.trim(),children:"Send"})]})})]})};export const AssistantChat=()=>m()?e(u,{}):null;

package/dist/extras/assistant/index.d.ts

@@ -1 +0,0 @@
-export { AssistantChat } from './AssistantChat.js';

package/dist/extras/assistant/index.js

@@ -1 +0,0 @@
-export{AssistantChat}from"./AssistantChat.js";