@salsita-ai/sdk 0.50.0-develop.662fa65a4c → 0.50.0-develop.6806625cca

package/dist/phoenix/services/telemetry/telemetry-event.d.ts

@@ -0,0 +1,44 @@
+import type { TelemetryCommand } from './telemetry-command.js';
+import type { TelemetryIdentity } from './telemetry-state.js';
+export type TelemetryOutcome = 'succeeded' | 'failed';
+export type TelemetryFailureCategory = 'command_failed';
+export type TelemetrySource = 'cli' | 'studio' | 'backend' | 'preview';
+export type TelemetryClassification = 'internal' | 'beta' | 'general' | 'unknown';
+export interface TelemetryEvent {
+    /** Unique event delivery identity, mapped to Amplitude's insert_id. */
+    readonly eventId: string;
+    readonly name: 'cli_command_started' | 'cli_dev_server_ready' | 'cli_command_completed';
+    readonly occurredAt: Date;
+    readonly deviceId: string;
+    readonly userId?: string;
+    readonly properties: {
+        readonly schema_version: 1;
+        readonly source: TelemetrySource;
+        readonly command: TelemetryCommand;
+        readonly attempt_id: string;
+        readonly phase: 'started' | 'ready' | 'completed';
+        readonly outcome: 'unknown' | TelemetryOutcome;
+        readonly duration_ms?: number;
+        readonly failure_category?: TelemetryFailureCategory;
+        readonly sdk_version: string;
+        readonly classification: TelemetryClassification;
+        readonly work_session_id: string;
+        readonly workspace_id?: string;
+    };
+}
+interface CreateCommandEventProps {
+    readonly identity: TelemetryIdentity;
+    readonly sdkVersion: string;
+    readonly command: TelemetryCommand;
+    readonly attemptId: string;
+    readonly phase: 'started' | 'ready' | 'completed';
+    readonly outcome: 'unknown' | TelemetryOutcome;
+    readonly occurredAt: Date;
+    readonly durationMs?: number;
+    readonly failureCategory?: TelemetryFailureCategory;
+}
+interface TelemetryEventContext {
+    readonly createId: () => string;
+}
+export declare const createCommandEvent: (props: CreateCommandEventProps, context: TelemetryEventContext) => TelemetryEvent;
+export {};

package/dist/phoenix/services/telemetry/telemetry-event.js

@@ -0,0 +1 @@
+export const createCommandEvent=(e,t)=>({eventId:t.createId(),name:"ready"===e.phase?"cli_dev_server_ready":"started"===e.phase?"cli_command_started":"cli_command_completed",occurredAt:e.occurredAt,deviceId:e.identity.installationId,..."userId"in e.identity?{userId:e.identity.userId}:{},properties:{schema_version:1,source:"cli",command:e.command,attempt_id:e.attemptId,phase:e.phase,outcome:e.outcome,...void 0===e.durationMs?{}:{duration_ms:e.durationMs},...void 0===e.failureCategory?{}:{failure_category:e.failureCategory},sdk_version:e.sdkVersion,classification:"userId"in e.identity?"general":"unknown",work_session_id:e.identity.workSessionId,..."workspaceId"in e.identity?{workspace_id:e.identity.workspaceId}:{}}});

package/dist/phoenix/services/telemetry/telemetry-state.d.ts

@@ -0,0 +1,25 @@
+export interface AnonymousTelemetryIdentity {
+    /** Random identifier for one operating-system user profile, without machine or account data. */
+    readonly installationId: string;
+    /** Random identifier for CLI activity separated by less than thirty minutes. */
+    readonly workSessionId: string;
+}
+export interface TelemetryAssociation {
+    /** Stable authenticated builder user ID, mapped to Amplitude's user_id after authentication. */
+    readonly userId: string;
+    /** Internal UUID of the SDK-builder workspace the CLI authenticated against. */
+    readonly workspaceId: string;
+}
+export type TelemetryIdentity = AnonymousTelemetryIdentity | (AnonymousTelemetryIdentity & TelemetryAssociation);
+interface TelemetryStateContext {
+    readonly createId: () => string;
+    readonly now: () => Date;
+}
+export declare const getTelemetryStatePath: () => string;
+/**
+ * Loads the anonymous CLI identity and records current activity. Broken or unwritable state never blocks a command:
+ * the invocation gets an ephemeral identity, while an invalid existing file is left untouched for inspection.
+ */
+export declare const loadTelemetryIdentity: (context?: TelemetryStateContext) => Promise<TelemetryIdentity>;
+export declare const saveTelemetryAssociation: (identity: TelemetryIdentity, association: TelemetryAssociation) => Promise<void>;
+export {};

package/dist/phoenix/services/telemetry/telemetry-state.js

@@ -0,0 +1,2 @@
+import{randomUUID as t}from"node:crypto";import{chmod as e,mkdir as i,readFile as n,writeFile as a}from"node:fs/promises";import{homedir as s}from"node:os";import{dirname as r,join as o}from"node:path";import{z as d}from"zod";let l=d.object({installationId:d.string().uuid(),workSessionId:d.string().uuid(),lastActiveAt:d.string().datetime()}),c=d.union([l.extend({userId:d.string().min(5),workspaceId:d.string().uuid()}),l.strict()]),I={createId:t,now:()=>new Date};export const getTelemetryStatePath=()=>process.env.PHOENIX_TELEMETRY_FILE??o(s(),".phoenix","telemetry.json");let u=async(t,n)=>{await i(r(t),{recursive:!0,mode:448}),await a(t,`${JSON.stringify(n,null,2)}
+`,{mode:384}),await e(t,384)},w=async t=>{let e;try{e=await n(t,"utf8")}catch(t){return t instanceof Error&&"code"in t&&"ENOENT"===t.code?{kind:"missing"}:{kind:"invalid"}}try{let t=c.safeParse(JSON.parse(e));return t.success?{kind:"valid",state:t.data}:{kind:"invalid"}}catch{return{kind:"invalid"}}};export const loadTelemetryIdentity=async(t=I)=>{let e=getTelemetryStatePath(),i=await w(e),n="valid"===i.kind?i.state:null,a=t.now(),s=null===n?null:Date.parse(n.lastActiveAt),r=null===s||a.getTime()-s>=18e5,o=null===n?{installationId:t.createId(),workSessionId:t.createId(),lastActiveAt:a.toISOString()}:{...n,workSessionId:r?t.createId():n.workSessionId,lastActiveAt:a.toISOString()};try{"invalid"!==i.kind&&await u(e,o)}catch{return{installationId:o.installationId,workSessionId:o.workSessionId}}return{installationId:o.installationId,workSessionId:o.workSessionId,..."userId"in o&&"workspaceId"in o?{userId:o.userId,workspaceId:o.workspaceId}:{}}};export const saveTelemetryAssociation=async(t,e)=>{let i=getTelemetryStatePath(),n=await w(i);"valid"===n.kind&&n.state.installationId===t.installationId&&n.state.workSessionId===t.workSessionId&&await u(i,{...n.state,...e})};

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

@@ -8,8 +8,9 @@ export declare const setViteLogSink: (sink: ViteLogSink, options?: ViteLogSinkOp
 /**
  * Get the inline Vite configuration for Phoenix projects
  */
-export declare const getViteDevConfig: (options?: {
+export declare const getViteDevConfig: (options: {
     readonly templateFiles?: readonly string[];
+    readonly agentMode: boolean;
 }) => Promise<InlineConfig>;
 /**
  * Get the inline Vite configuration for Phoenix projects

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

@@ -1 +1 @@
-import{getConfig as e}from"@lingui/conf";import{lingui as i}from"@lingui/vite-plugin";import t from"@vitejs/plugin-react";import{mkdir as n,readFile as r,writeFile as o}from"fs/promises";import a from"lodash-es/camelCase.js";import{createRequire as s}from"node:module";import{dirname as l,resolve as m}from"path";import{createLogger as f}from"vite";import p from"vite-plugin-css-injected-by-js";import{isUsingLocalSdk as d}from"../utils/package-info.js";import{loadFrontendConfigModule as c}from"./frontend-config.js";import{LINGUI_CONFIG_PATH as g}from"./lingui.js";import{phxBannerPlugin as u}from"./phx-banner-plugin.js";import{phxCspNoncePlugin as h}from"./phx-csp-nonce-plugin.js";import{phxGlobalIsolationPlugin as b}from"./phx-global-isolation-plugin.js";import{phxLicensesPlugin as S}from"./phx-licenses-plugin.js";import{phxVariantPreviewsPlugin as y}from"./phx-variant-previews-plugin.js";let O=null;export const setViteLogSink=(e,i={})=>{O={sink:e,echo:i.echo??!1}};let x=["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"],D=()=>[s(import.meta.url).resolve("@lingui/babel-plugin-lingui-macro"),{linguiConfig:e({configPath:g})}],E=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 e=>{var n,r;let o,a,p=d(),u=c(),h=u.readRuntimeConfig(),S=u.frontendBuildConfig,v=D(),j=Object.fromEntries((e?.templateFiles??[]).map(e=>[e,`.phoenix/${e}`]));return{...O&&{customLogger:(n=O.sink,r=O.echo,o=f(),{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)}),...O.echo?{}:{clearScreen:!1}},mode:"development",optimizeDeps:{exclude:["@swc/wasm-web"],...p&&{entries:["index.html","admin.html",...e?.templateFiles??[]],force:!0}},...p&&{resolve:{alias:(a=s(m(process.cwd(),"package.json")),x.flatMap(e=>{try{let i=l(a.resolve(`${e}/package.json`));return[{find:RegExp(`^${e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}(/|$)`),replacement:`${i}$1`}]}catch{return[]}}))}},plugins:[t({babel:{plugins:[v]}}),i({configPath:g}),{name:"vite:runtime-config",apply:(e,i)=>"build"===i.command||"development"===i.mode,config:e=>{let i=u.readRuntimeConfig(),t=u.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)}}}},b({getDeploymentId:()=>E(u.readRuntimeConfig())}),y()],define:{"process.env":{},"import.meta.env.DEV":!0,"import.meta.env.PROD":!1,"phx.frontendEnv":JSON.stringify(h),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(S.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(S.gltfDecoder)},build:{rollupOptions:{input:{index:".phoenix/index.html",admin:".phoenix/admin.html",...j}}},root:m(process.cwd(),"./.phoenix"),server:{watch:{ignored:["./**/*.{ts,tsx}","./.swc/**","../spec/**","../src/**"]}}}};export const getViteBuildConfigs=async e=>{let s=c(),f=s.readRuntimeConfig(),d=s.frontendBuildConfig,y=D(),O=S(),x=u({sdkVersion:e.sdkVersion,banner:e.banner}),v=[{name:"salsita-configurator",entryFile:"./configurator.ts",mainScriptPath:"./configurator.ts",htmlFiles:["./index.html",...{templateFiles:e.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:[t({babel:{plugins:[y]}}),i({configPath:g}),p({useStrictCSP:!0}),h(),b({getDeploymentId:()=>E(s.readRuntimeConfig())}),{name:"vite:lib-index",writeBundle:async()=>{if(!c.htmlFiles.length)return;let i="iife"===c.format?`${c.name}.iife.js`:`${c.name}.js`;for(let t of c.htmlFiles){if(c.main&&e.enableEditor&&"./index.html"===t)continue;let a=m("./.phoenix",t),s=m("./.phoenix/dist/frontend",t);await n(l(s),{recursive:!0});let f=(await r(a,"utf-8")).replace(c.mainScriptPath,i);await o(s,f,"utf-8")}}},O,x],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,lib:{entry:c.entryFile,name:a(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(d.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(d.gltfDecoder)}}));return e.enableEditor?[...v,{plugins:[t({babel:{plugins:[y]}}),i({configPath:g}),p({useStrictCSP:!0}),h(),O,x],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(d.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(d.gltfDecoder)}}]:v};
+import{getConfig as e}from"@lingui/conf";import{lingui as i}from"@lingui/vite-plugin";import t from"@vitejs/plugin-react";import{mkdir as n,readFile as r,writeFile as o}from"fs/promises";import a from"lodash-es/camelCase.js";import{createHash as s}from"node:crypto";import{readFileSync as l,rmSync as m,writeFileSync as p}from"node:fs";import{createRequire as d}from"node:module";import{dirname as f,resolve as c}from"path";import{createLogger as g}from"vite";import u from"vite-plugin-css-injected-by-js";import{LINGUI_CONFIG_PATH as h}from"../lingui/index.js";import{isUsingLocalSdk as y}from"../utils/package-info.js";import{loadFrontendConfigModule as b}from"./frontend-config.js";import{phxBannerPlugin as S}from"./phx-banner-plugin.js";import{phxCspNoncePlugin as x}from"./phx-csp-nonce-plugin.js";import{phxGlobalIsolationPlugin as O}from"./phx-global-isolation-plugin.js";import{phxLicensesPlugin as D}from"./phx-licenses-plugin.js";import{phxVariantPreviewsPlugin as E}from"./phx-variant-previews-plugin.js";let v=null;export const setViteLogSink=(e,i={})=>{v={sink:e,echo:i.echo??!1}};let P=["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"],j=()=>{let t=l(h),n=s("sha256").update(t).digest("hex"),r=c(`${h}.${process.pid}.${n}.json`);try{return p(r,t),{macroPlugin:[d(import.meta.url).resolve("@lingui/babel-plugin-lingui-macro"),{linguiConfig:e({configPath:r})}],catalogPlugin:i({configPath:r})}}finally{m(r,{force:!0})}},C=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 e=>{var i,n;let r,o,a=y(),s=b(),l=s.readRuntimeConfig(),m=s.frontendBuildConfig,p=j(),u=Object.fromEntries((e.templateFiles??[]).map(e=>[e,`.phoenix/${e}`]));return{...v&&{customLogger:(i=v.sink,n=v.echo,r=g(),{get hasWarned(){return r.hasWarned},info:(e,t)=>{i("info",e),n&&r.info(e,t)},warn:(e,t)=>{i("warn",e),n&&r.warn(e,t)},warnOnce:(e,t)=>{i("warn",e),n&&r.warnOnce(e,t)},error:(e,t)=>{i("error",e),n&&r.error(e,t)},clearScreen:e=>{n&&r.clearScreen(e)},hasErrorLogged:e=>r.hasErrorLogged(e)}),...v.echo?{}:{clearScreen:!1}},mode:"development",optimizeDeps:{exclude:["@swc/wasm-web"],...a&&{entries:["index.html","admin.html",...e.templateFiles??[]],force:!0}},...a&&{resolve:{alias:(o=d(c(process.cwd(),"package.json")),P.flatMap(e=>{try{let i=f(o.resolve(`${e}/package.json`));return[{find:RegExp(`^${e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}(/|$)`),replacement:`${i}$1`}]}catch{return[]}}))}},plugins:[t({babel:{plugins:[p.macroPlugin]}}),p.catalogPlugin,{name:"vite:runtime-config",apply:(e,i)=>"build"===i.command||"development"===i.mode,config:e=>{let i=s.readRuntimeConfig(),t=s.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)}}}},O({getDeploymentId:()=>C(s.readRuntimeConfig())}),E()],define:{"process.env":{},"import.meta.env.DEV":!0,"import.meta.env.PROD":!1,"phx.frontendEnv":JSON.stringify(l),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(m.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(m.gltfDecoder)},build:{rollupOptions:{input:{index:".phoenix/index.html",admin:".phoenix/admin.html",...u}}},root:c(process.cwd(),"./.phoenix"),server:{watch:{ignored:["./**/*.{ts,tsx}","./.swc/**","../spec/**","../src/**"]},hmr:{overlay:!e.agentMode}}}};export const getViteBuildConfigs=async e=>{let i=b(),s=i.readRuntimeConfig(),l=i.frontendBuildConfig,m=j(),p=D(),d=S({sdkVersion:e.sdkVersion,banner:e.banner}),g=[{name:"salsita-configurator",entryFile:"./configurator.ts",mainScriptPath:"./configurator.ts",htmlFiles:["./index.html",...{templateFiles:e.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(g=>({plugins:[t({babel:{plugins:[m.macroPlugin]}}),m.catalogPlugin,u({useStrictCSP:!0}),x(),O({getDeploymentId:()=>C(i.readRuntimeConfig())}),{name:"vite:lib-index",writeBundle:async()=>{if(!g.htmlFiles.length)return;let i="iife"===g.format?`${g.name}.iife.js`:`${g.name}.js`;for(let t of g.htmlFiles){if(g.main&&e.enableEditor&&"./index.html"===t)continue;let a=c("./.phoenix",t),s=c("./.phoenix/dist/frontend",t);await n(f(s),{recursive:!0});let l=(await r(a,"utf-8")).replace(g.mainScriptPath,i);await o(s,l,"utf-8")}}},p,d],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,lib:{entry:g.entryFile,name:a(g.name),formats:[g.format],fileName:()=>"iife"===g.format?`${g.name}.iife.js`:`${g.name}.js`},rollupOptions:{external:[],output:{assetFileNames:`${g.name}.[ext]`}},minify:!0,emptyOutDir:!1},root:c(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(s),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(l.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(l.gltfDecoder)}}));return e.enableEditor?[...g,{plugins:[t({babel:{plugins:[m.macroPlugin]}}),m.catalogPlugin,u({useStrictCSP:!0}),x(),p,d],build:{outDir:"./dist/frontend",chunkSizeWarningLimit:4e3,rollupOptions:{external:[]},minify:!0,emptyOutDir:!1},root:c(process.cwd(),"./.phoenix"),define:{"process.env":{},"process.env.NODE_ENV":JSON.stringify("production"),"phx.frontendEnv":JSON.stringify(s),"globalThis.PHX_SCHEMA_VALIDATOR":JSON.stringify(l.jsonSchemaValidator),"globalThis.PHX_GLTF_DECODER":JSON.stringify(l.gltfDecoder)}}]:g};

package/dist/phoenix/services/webhook-service/transport.js

@@ -1 +1 @@
-import{createApiBaseClient as e}from"#package/client";import{getDevelopmentHeaders as t}from"../development-credential.js";let o=(e,t)=>({ok:!1,status:t.status,message:e.message});export const createWebhookTunnelTransport=({serverUrl:a,credential:n,projectSlug:l,environmentSlug:r})=>{let s=e(a),p=t(n,{projectSlug:l,environmentSlug:r});return{poll:async({deploymentId:e,sessionId:t,signal:a})=>{let{data:n,error:l,response:r}=await s.POST("/deployments/{deploymentId}/webhook-tunnel/poll",{params:{path:{deploymentId:e}},body:{sessionId:t},headers:p,signal:a});return l?o(l,r):{ok:!0,value:n?.request??null}},respond:async({deploymentId:e,sessionId:t,requestId:a,status:n,headers:l,body:r,signal:d})=>{let{error:m,response:u}=await s.POST("/deployments/{deploymentId}/webhook-tunnel/respond",{params:{path:{deploymentId:e}},body:{sessionId:t,requestId:a,status:n,headers:l,body:r},headers:p,signal:d});return m?o(m,u):{ok:!0,value:void 0}}}};
+import{createApiBaseClient as e}from"#package/client";import{getDevelopmentHeaders as t}from"../development-credential.js";let n=(e,t)=>({ok:!1,status:t.status,message:e.message});export const createWebhookTunnelTransport=({serverUrl:o,credential:s,projectSlug:a,environmentSlug:r})=>{let l=e(o),d=t(s,{projectSlug:a,environmentSlug:r});return{poll:async({deploymentId:e,sessionId:t,signal:o})=>{let{data:s,error:a,response:r}=await l.POST("/deployments/{deploymentId}/webhook-tunnel/poll",{params:{path:{deploymentId:e}},body:{sessionId:t,acceptResponseEncoding:"gzip"},headers:d,signal:o});return a?n(a,r):{ok:!0,value:s?.request??null}},respond:async({deploymentId:e,sessionId:t,requestId:o,status:s,headers:a,body:r,isBase64Encoded:p,signal:u})=>{let i={sessionId:t,requestId:o,status:s,headers:a,body:r,isBase64Encoded:p};if(Buffer.byteLength(JSON.stringify(i),"utf8")>5242880)return{ok:!1,status:413,message:"Webhook tunnel response exceeds the 5 MiB encoded request limit. Reduce the backend data and retry."};let{error:m,response:c}=await l.POST("/deployments/{deploymentId}/webhook-tunnel/respond",{params:{path:{deploymentId:e}},body:i,headers:d,signal:u});return m?n(m,c):{ok:!0,value:void 0}}}};

package/dist/phoenix/services/webhook-service/tunnel.d.ts

@@ -46,6 +46,7 @@ export interface TunnelRespondRequest {
     readonly status: number;
     readonly headers?: Readonly<Record<string, string>>;
     readonly body: string;
+    readonly isBase64Encoded?: boolean;
     readonly signal: AbortSignal;
 }
 /** Server boundary used by the package-independent tunnel lifecycle. */

package/dist/phoenix/services/webhook-service/tunnel.js

@@ -1 +1 @@
-import{execute as e,getLogger as t,webhookLogContext as r}from"../../webhooks/index.js";export class TunnelTerminalError extends Error{kind;constructor(e,t){super(t),this.kind=e}}let n=async e=>{e.aborted||await new Promise(t=>{let r=()=>{clearTimeout(n),t()},n=setTimeout(()=>{e.removeEventListener("abort",r),t()},5e3);e.addEventListener("abort",r,{once:!0})})},o=e=>new URL(e.url,"http://webhook-tunnel.invalid").searchParams.get("o")??"finalize",s=async(t,n,o)=>{if(o.aborted)return null;let s=()=>void 0,a=new Promise(e=>{(s=()=>e(null),o.aborted)?s():o.addEventListener("abort",s,{once:!0})}),i=(async()=>{try{var o,s;let a=await r.run("webhook",()=>{let r;return e({lambdaPath:n.bundle,lambdaHandler:n.handler,esm:!1,event:(r=new URL(t.url,"http://webhook-tunnel.invalid"),{version:"2.0",routeKey:"$default",rawPath:r.pathname,rawQueryString:r.search,cookies:[],headers:t.headers,queryStringParameters:Object.fromEntries(r.searchParams),requestContext:{accountId:"123456789012",apiId:"api-id",authentication:{},authorizer:{},http:{method:t.method,path:r.pathname,protocol:"HTTP/1.1",sourceIp:"127.0.0.1",userAgent:"phoenix-webhook-tunnel"},requestId:t.requestId,routeKey:"$default",stage:"$default",time:new Date().toISOString(),timeEpoch:Date.now()},body:t.body??void 0,isBase64Encoded:!1}),verboseLevel:n.verbosity??0,timeoutMs:6e4})});if((o=a)&&"object"==typeof o&&"statusCode"in o&&"number"==typeof o.statusCode&&(!("headers"in o)||void 0===o.headers||(s=o.headers)&&"object"==typeof s&&Object.values(s).every(e=>"string"==typeof e)))return{status:a.statusCode,headers:a.headers,body:"string"==typeof a.body?a.body:JSON.stringify(a.body??""),error:null};return{status:200,body:JSON.stringify(a)??"",error:null}}catch(t){let e=t instanceof Error?t.message:String(t);return{status:500,body:JSON.stringify({message:e}),error:e}}})(),l=await Promise.race([i,a]);return o.removeEventListener("abort",s),l};export const startTunnel=e=>{let{transport:r,rejectionHint:a,environmentSlug:i,deploymentId:l,sessionId:d,pollLoops:u=2,onStatus:c,onRequest:h}=e,m=t(),f=new AbortController,p=!1,y=!1,w=!1,b=0,g=null,v=null,$=[],k=new Set,T=e=>void 0,q=new Promise((e,t)=>{T=t}),E=(e,t)=>{m.log(e,t)},I=(e,t)=>{try{c?.(e,t)}catch{}},S=e=>{try{h?.(e)}catch{}},P=e=>(g||(g=e,p=!0,f.abort(),E("error",e.message),I("conflict"===e.kind?"conflict":"error",e.message)),g),x=e=>{w=!0,E("warn",e),I("error",e)},W=()=>new TunnelTerminalError("conflict",`Webhook tunnel for environment ${i} (deployment ${l}) is owned by another phoenix dev session. Stop the other session and restart.`),R=e=>new TunnelTerminalError("rejected",`${e} ${a}`),D=async(e,t)=>{for(;!p;){try{let n=await r.respond({deploymentId:l,sessionId:d,requestId:e.requestId,status:t.status,headers:t.headers,body:t.body,signal:f.signal});if(n.ok)return;if(403===n.status)throw P(W());if(404===n.status)throw P(new TunnelTerminalError("stale",n.message));if(n.status<500)throw P(R(n.message));x(`Webhook tunnel response could not reach the server: ${n.message} Retrying in 5 seconds.`)}catch(e){if(e instanceof TunnelTerminalError)throw e;if(p)return;x(`Webhook tunnel response could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`)}await n(f.signal)}},L=e=>{let t=o(e),r=Date.now();w&&(b+=1),E("warn",`Tunneled ${t} request ${e.requestId} skipped because its deadline expired.`),S({requestId:e.requestId,operation:t,method:e.method,url:e.url,startedAt:r,durationMs:0,outcome:"skipped-expired",responseStatus:null,requestBody:e.body,responseBody:null,error:"Request deadline expired before phoenix dev picked it up."})},j=async t=>{let r=o(t),n=Date.now(),a=await s(t,e,f.signal);if(!a)return;let i=Date.now()-n,l=a.error?"failed":"served";E(a.error?"warn":"info",`Tunneled ${r} request ${t.requestId} ${l} in ${i}ms (status ${a.status}).`),S({requestId:t.requestId,operation:r,method:t.method,url:t.url,startedAt:n,durationMs:i,outcome:l,responseStatus:a.status,requestBody:t.body,responseBody:a.body,error:a.error}),await D(t,a)},O=()=>{for(;!p&&k.size<u;){let e=$.shift();if(!e)return;if(e.deadline<Date.now()){L(e);continue}let t=j(e);k.add(t),t.then(()=>{k.delete(t),O()},e=>{k.delete(t),T(e)})}},B=async e=>{let t=0;for(;!p;)try{let o=await r.poll({deploymentId:l,sessionId:d,signal:f.signal});if(!o.ok){if(409===o.status){if(y||t>=3)throw P(W());t+=1,0===e&&E("warn",`Webhook tunnel for environment ${i} is already claimed. Retrying in 5 seconds (${t}/3).`)}else if(403===o.status)throw P(R(o.message));else if(404===o.status)throw P(new TunnelTerminalError("stale",o.message));else if(o.status<500)throw P(R(o.message));else x(`Webhook tunnel poll failed: ${o.message} Retrying in 5 seconds.`);await n(f.signal);continue}t=0;let s=o.value,a=!!s&&s.deadline<Date.now();s&&a&&L(s),y||(y=!0,E("info",`Webhook tunnel connected for environment ${i} (deployment ${l}, session ${d}).`)),w&&(E("info",`Webhook tunnel reconnected${b>0?`; ${b} queued request(s) expired and were skipped during the interruption.`:"."}`),w=!1,b=0),I("connected"),s&&!a&&($.push(s),O())}catch(e){if(e instanceof TunnelTerminalError)throw e;if(p)return;x(`Webhook tunnel poll could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`),await n(f.signal)}};I("waiting");let C=Promise.race([Promise.all(Array.from({length:u},(e,t)=>B(t))).then(async()=>{await Promise.all(k)}),q]);return{sessionId:d,stop:()=>v||(p=!0,f.abort(),E("info",`Webhook tunnel stopped for environment ${i} (deployment ${l}).`),I("stopped"),v=C.catch(e=>{if(!(e instanceof TunnelTerminalError))throw e})),stopped:C}};
+import{execute as e,getLogger as t,webhookLogContext as r}from"../../webhooks/index.js";export class TunnelTerminalError extends Error{kind;constructor(e,t){super(t),this.kind=e}}let n=async e=>{e.aborted||await new Promise(t=>{let r=()=>{clearTimeout(n),t()},n=setTimeout(()=>{e.removeEventListener("abort",r),t()},5e3);e.addEventListener("abort",r,{once:!0})})},o=e=>new URL(e.url,"http://webhook-tunnel.invalid").searchParams.get("o")??"finalize",s=async(t,n,o)=>{if(o.aborted)return null;let s=()=>void 0,a=new Promise(e=>{(s=()=>e(null),o.aborted)?s():o.addEventListener("abort",s,{once:!0})}),i=(async()=>{try{var o,s;let a=await r.run("webhook",()=>{let r;return e({lambdaPath:n.bundle,lambdaHandler:n.handler,esm:!1,event:(r=new URL(t.url,"http://webhook-tunnel.invalid"),{version:"2.0",routeKey:"$default",rawPath:r.pathname,rawQueryString:r.search,cookies:[],headers:t.headers,queryStringParameters:Object.fromEntries(r.searchParams),requestContext:{accountId:"123456789012",apiId:"api-id",authentication:{},authorizer:{},http:{method:t.method,path:r.pathname,protocol:"HTTP/1.1",sourceIp:"127.0.0.1",userAgent:"phoenix-webhook-tunnel"},requestId:t.requestId,routeKey:"$default",stage:"$default",time:new Date().toISOString(),timeEpoch:Date.now()},body:t.body??void 0,isBase64Encoded:!1}),verboseLevel:n.verbosity??0,timeoutMs:6e4})});if((o=a)&&"object"==typeof o&&"statusCode"in o&&"number"==typeof o.statusCode&&(!("headers"in o)||void 0===o.headers||(s=o.headers)&&"object"==typeof s&&Object.values(s).every(e=>"string"==typeof e)))return{status:a.statusCode,...void 0!==a.isBase64Encoded&&{isBase64Encoded:a.isBase64Encoded},headers:a.headers,body:"string"==typeof a.body?a.body:JSON.stringify(a.body??""),error:null};return{status:200,body:JSON.stringify(a)??"",error:null}}catch(t){let e=t instanceof Error?t.message:String(t);return{status:500,body:JSON.stringify({message:e}),error:e}}})(),d=await Promise.race([i,a]);return o.removeEventListener("abort",s),d};export const startTunnel=e=>{let{transport:r,rejectionHint:a,environmentSlug:i,deploymentId:d,sessionId:l,pollLoops:u=2,onStatus:c,onRequest:h}=e,m=t(),f=new AbortController,y=!1,p=!1,w=!1,b=0,g=null,v=null,$=[],E=new Set,T=e=>void 0,k=new Promise((e,t)=>{T=t}),q=(e,t)=>{m.log(e,t)},B=(e,t)=>{try{c?.(e,t)}catch{}},I=e=>{try{h?.(e)}catch{}},S=e=>(g||(g=e,y=!0,f.abort(),q("error",e.message),B("conflict"===e.kind?"conflict":"error",e.message)),g),P=e=>{w=!0,q("warn",e),B("error",e)},x=()=>new TunnelTerminalError("conflict",`Webhook tunnel for environment ${i} (deployment ${d}) is owned by another phoenix dev session. Stop the other session and restart.`),W=e=>new TunnelTerminalError("rejected",`${e} ${a}`),L=async(e,t)=>{for(;!y;){try{let n=await r.respond({deploymentId:d,sessionId:l,requestId:e.requestId,status:t.status,headers:t.headers,body:t.body,...void 0!==t.isBase64Encoded&&{isBase64Encoded:t.isBase64Encoded},signal:f.signal});if(n.ok)return;if(413===n.status)throw S(new TunnelTerminalError("rejected",n.message));if(403===n.status)throw S(x());if(404===n.status)throw S(new TunnelTerminalError("stale",n.message));if(n.status<500)throw S(W(n.message));P(`Webhook tunnel response could not reach the server: ${n.message} Retrying in 5 seconds.`)}catch(e){if(e instanceof TunnelTerminalError)throw e;if(y)return;P(`Webhook tunnel response could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`)}await n(f.signal)}},R=e=>{let t=o(e),r=Date.now();w&&(b+=1),q("warn",`Tunneled ${t} request ${e.requestId} skipped because its deadline expired.`),I({requestId:e.requestId,operation:t,method:e.method,url:e.url,startedAt:r,durationMs:0,outcome:"skipped-expired",responseStatus:null,requestBody:e.body,responseBody:null,error:"Request deadline expired before phoenix dev picked it up."})},j=async t=>{let r=o(t),n=Date.now(),a=await s(t,e,f.signal);if(!a)return;let i=Date.now()-n,d=a.error?"failed":"served";q(a.error?"warn":"info",`Tunneled ${r} request ${t.requestId} ${d} in ${i}ms (status ${a.status}).`),I({requestId:t.requestId,operation:r,method:t.method,url:t.url,startedAt:n,durationMs:i,outcome:d,responseStatus:a.status,requestBody:t.body,responseBody:a.isBase64Encoded?`[Binary response omitted: ${Buffer.byteLength(a.body,"utf8")} encoded bytes]`:a.body,error:a.error}),await L(t,a)},D=()=>{for(;!y&&E.size<u;){let e=$.shift();if(!e)return;if(e.deadline<Date.now()){R(e);continue}let t=j(e);E.add(t),t.then(()=>{E.delete(t),D()},e=>{E.delete(t),T(e)})}},O=async e=>{let t=0;for(;!y;)try{let o=await r.poll({deploymentId:d,sessionId:l,signal:f.signal});if(!o.ok){if(409===o.status){if(p||t>=3)throw S(x());t+=1,0===e&&q("warn",`Webhook tunnel for environment ${i} is already claimed. Retrying in 5 seconds (${t}/3).`)}else if(403===o.status)throw S(W(o.message));else if(404===o.status)throw S(new TunnelTerminalError("stale",o.message));else if(o.status<500)throw S(W(o.message));else P(`Webhook tunnel poll failed: ${o.message} Retrying in 5 seconds.`);await n(f.signal);continue}t=0;let s=o.value,a=!!s&&s.deadline<Date.now();s&&a&&R(s),p||(p=!0,q("info",`Webhook tunnel connected for environment ${i} (deployment ${d}, session ${l}).`)),w&&(q("info",`Webhook tunnel reconnected${b>0?`; ${b} queued request(s) expired and were skipped during the interruption.`:"."}`),w=!1,b=0),B("connected"),s&&!a&&($.push(s),D())}catch(e){if(e instanceof TunnelTerminalError)throw e;if(y)return;P(`Webhook tunnel poll could not reach the server: ${e instanceof Error?e.message:String(e)} Retrying in 5 seconds.`),await n(f.signal)}};B("waiting");let C=Promise.race([Promise.all(Array.from({length:u},(e,t)=>O(t))).then(async()=>{await Promise.all(E)}),k]);return{sessionId:l,stop:()=>v||(y=!0,f.abort(),q("info",`Webhook tunnel stopped for environment ${i} (deployment ${d}).`),B("stopped"),v=C.catch(e=>{if(!(e instanceof TunnelTerminalError))throw e})),stopped:C}};

package/dist/react-sdk/application-runtime/common-services/analytics/analytics-service.d.ts

@@ -17,5 +17,5 @@ export declare const CommonAnalyticsFactory: {
     Initialized: typeof Initialized;
     ConfigurationLoaded: typeof ConfigurationLoaded;
 };
-export declare const initializeAnalyticsService: (config: AnyApplicationConfig, logger: Logger, isDev: boolean) => AnalyticsSystem;
+export declare const initializeAnalyticsService: (config: Pick<AnyApplicationConfig, 'services' | 'defaultEnvs'>, logger: Logger, isDev: boolean) => AnalyticsSystem;
 export {};

package/dist/react-sdk/application-runtime/common-services/initialize.d.ts

@@ -2,6 +2,6 @@ import type { I18n } from '@lingui/core';
 import { QueryClient } from '@tanstack/react-query';
 import { type Logger } from '@salsita-ai/common/utils';
 import type { AnyApplicationConfig } from '#package/domain';
-export declare const initializeLogger: (config: AnyApplicationConfig, isDev: boolean) => Logger;
-export declare const initializeI18n: (config: AnyApplicationConfig) => I18n;
+export declare const initializeLogger: (config: Pick<AnyApplicationConfig, 'services' | 'defaultEnvs' | 'version'>, isDev: boolean) => Logger;
+export declare const initializeI18n: (config: Pick<AnyApplicationConfig, 'services'>) => I18n;
 export declare const createQueryClient: (logger: Logger) => QueryClient;

package/dist/react-sdk/application-runtime/domain-application-context/chat-system.d.ts

@@ -29,7 +29,7 @@ export interface SendVoiceMessageParams<CHAT_CONTEXT extends Record<string, unkn
  * Runtime chat service consumed only by the legacy configurator chat UI. Its user-facing consumers
  * live under `configurator/ui/legacy/`: `Chat` is reached through `MobileChat`, `TabsSidebar`,
  * `StepsSideBar`, and `SimpleSidebar`, with availability gated by
- * `configurator/configurator-context/configurator-hooks/chat-hooks.ts`.
+ * `react-sdk/domain-application-context/chat-hooks.ts`.
  *
  * `sendMessage` deliberately retains a known reinitialization race. Its `ChunkType.calls`
  * continuation does not recheck the captured generation after `processToolCalls` before publishing

package/dist/react-sdk/application-runtime/hooks/responsive/use-responsive-application.d.ts

@@ -16,6 +16,8 @@ export declare const useResponsiveApplication: () => {
         setViewport: (viewport: import("../../index.js").ResponsiveViewport) => void;
         setBreakpoints: (breakpoints: import("../../index.js").ResponsiveBreakpoints) => void;
         setCanvasPadding: (canvasPadding: import("../../index.js").CanvasPadding) => void;
+        setSceneSafeArea: (sceneSafeArea: import("../../index.js").CanvasPadding) => void;
+        clearSceneSafeArea: (sceneSafeArea: import("../../index.js").CanvasPadding) => void;
         expand: () => void;
         collapse: () => void;
         hide: () => void;

package/dist/react-sdk/application-runtime/hooks/responsive/use-responsive-store.js

@@ -1 +1 @@
-import{useMemo as e}from"react";import{useResponsiveApplication as t}from"./use-responsive-application.js";export const useResponsiveStore=()=>{let{runtime:s,selectors:i,actions:a}=t();return e(()=>({setViewport:a.setViewport,setBreakpoints:a.setBreakpoints,setCanvasPadding:a.setCanvasPadding,expand:a.expand,collapse:a.collapse,hide:a.hide,show:a.show,setAnimating:a.setAnimating,subscribe:s.subscribe,getState:i.getResponsiveState,getViewportSize:i.getViewportSize,getCanvasPadding:i.getCanvasPadding}),[s,i,a])};
+import{useMemo as e}from"react";import{useResponsiveApplication as t}from"./use-responsive-application.js";export const useResponsiveStore=()=>{let{runtime:a,selectors:s,actions:i}=t();return e(()=>({setViewport:i.setViewport,setBreakpoints:i.setBreakpoints,setCanvasPadding:i.setCanvasPadding,setSceneSafeArea:i.setSceneSafeArea,clearSceneSafeArea:i.clearSceneSafeArea,expand:i.expand,collapse:i.collapse,hide:i.hide,show:i.show,setAnimating:i.setAnimating,subscribe:a.subscribe,getState:s.getResponsiveState,getViewportSize:s.getViewportSize,getCanvasPadding:s.getCanvasPadding}),[a,s,i])};

package/dist/react-sdk/application-runtime/hooks/use-environment.d.ts

@@ -8,5 +8,12 @@ export declare const usePersistenceConfig: () => {
     readonly type: 'memory';
 };
 export declare const useEditorMode: () => boolean;
+/**
+ * Whether the application runs under `phoenix dev` in agent mode, where the dev error pages show the
+ * "Agent at work" screen.
+ *
+ * @internal
+ */
+export declare const useAgentMode: () => boolean;
 export declare const useGodMode: () => boolean;
 export declare const useIsDev: () => boolean;

package/dist/react-sdk/application-runtime/hooks/use-environment.js

@@ -1 +1 @@
-import{useApplicationRuntime as e}from"../provider/index.js";import{useApplicationRuntimeSelector as o}from"./use-application-runtime-selector.js";export const useDeploymentId=()=>o(e().selectors.environment.getDeploymentId);export const usePersistenceConfig=()=>o(e().selectors.environment.getPersistenceConfig);export const useEditorMode=()=>o(e().selectors.environment.getEditorMode);export const useGodMode=()=>o(e().selectors.environment.getGodMode);export const useIsDev=()=>o(e().selectors.environment.getEnvironmentIsDev);
+import{useApplicationRuntime as e}from"../provider/index.js";import{useApplicationRuntimeSelector as o}from"./use-application-runtime-selector.js";export const useDeploymentId=()=>o(e().selectors.environment.getDeploymentId);export const usePersistenceConfig=()=>o(e().selectors.environment.getPersistenceConfig);export const useEditorMode=()=>o(e().selectors.environment.getEditorMode);export const useAgentMode=()=>o(e().selectors.environment.getAgentMode);export const useGodMode=()=>o(e().selectors.environment.getGodMode);export const useIsDev=()=>o(e().selectors.environment.getEnvironmentIsDev);

package/dist/react-sdk/application-runtime/mocks/create-mock-application-runtime.js

@@ -1 +1 @@
-import{memoOnce as e}from"@salsita-ai/common/utils";import{AccessLevel as t}from"@salsita-ai/contracts/api";import{createDomainRuntime as o,createMockDomainRuntimeServices as n,createMockSessionContext as i}from"#package/domain";import{createCommonServicesSelectors as s}from"../common-services/index.js";import{createDomainApplicationContextSelectors as a}from"../domain-application-context/index.js";import{connectHostProperties as r,createHostPropertiesActions as c,createHostPropertiesSelectors as m,initializeHostProperties as p}from"../host-properties/index.js";import{createIntegrationActions as d,createIntegrationSelectors as l,initializeIntegration as g}from"../integration/index.js";import{createLoadingActions as S,createLoadingSelectors as f,initializeLoading as v}from"../loading/index.js";import{createResponsiveActions as u,createResponsiveSelectors as C,initializeResponsive as x}from"../responsive/index.js";import{createRoutingActions as b,createRoutingSelectors as y,initializeRouting as w}from"../routing/index.js";import{SessionService as A,createSessionRuntimeActions as D,createSessionRuntimeSelectors as R,initializeSessionRuntime as h}from"../session/index.js";import{createMockWebComponentApi as j}from"../web-component/index.js";export const createMockApplicationRuntime=(T,k)=>{var E;let I,L,O,M,F,P,U,V,z,H,q,B,G,J,K,N,Q,W,X,Y,Z,$,_,ee,{sessionData:et,mode:eo,role:en}=k,ei=n(),es=(E={webComponentOptions:k.webComponentOptions??T.mount.options,webComponentApi:k.webComponentApi??j()},O=h(),M=o({config:T,services:ei,getExtensionSystems:e=>ee[e].getInitializableSystems()}),F=new Set,P=()=>{F.forEach(e=>{e()})},U=d({setIntegration:e=>{I=e(I),P()}}),I=g(),V=l({getState:()=>({integration:I}),actions:U}),z=b({setRouting:e=>{L=e(L),P()}}),L=w(),H=y({getState:()=>({...M.getState(),routing:L}),actions:z,accessActions:M.actions.access,loadedDataActions:M.actions.loadedData,domainServicesSelectors:M.selectors.domainServices,overridesSelectors:M.selectors.overrides}),q=x(),B=u({setResponsive:e=>{let t=e(q);t!==q&&(q=t,P())}}),G={configurator:C({getState:()=>({responsive:q}),applicationType:"configurator"}),admin:C({getState:()=>({responsive:q}),applicationType:"admin"})},J=v(),K=S({setLoading:e=>{let t=e(J);t!==J&&(J=t,P())}}),N={configurator:f({getState:()=>({loading:J}),applicationType:"configurator"}),admin:f({getState:()=>({loading:J}),applicationType:"admin"})},Q=p(E.webComponentApi),W=c({setHostProperties:e=>{let t=e(Q);t!==Q&&(Q=t,P())}}),X=m({getState:()=>({hostProperties:Q})}),r({webComponentApi:E.webComponentApi,actions:W,domainSelectors:M.selectors.webComponent,domainActions:{setReadonly:M.actions.webComponent.setReadonly,setLocale:M.hostMirrorActions.setLocale}}),Y=s({getState:()=>({...M.getState(),session:O}),environmentSelectors:M.selectors.environment,specSelectors:M.selectors.spec,accessSelectors:M.selectors.access,domainServicesSelectors:M.selectors.domainServices,webComponentOptions:E.webComponentOptions,webComponentApi:E.webComponentApi,getSessionService:()=>_(),routingSelectors:H}),Z=D({setSessionRuntime:e=>{O=e(O),P()}}),$=R({getState:()=>({...M.getState(),session:O}),sessionContextSelectors:M.selectors.sessionContext}),_=e(()=>new A({getLogger:()=>M.selectors.domainServices.getLogger(),getAnalyticsService:()=>M.selectors.domainServices.getAnalyticsService(),getUnauthenticatedClient:Y.getUnauthenticatedClient,environmentSelectors:M.selectors.environment,sessionActions:Z,setSessionContext:M.actions.sessionContext.setSessionContext,sessionSelectors:$,specSelectors:M.selectors.spec})),ee={configurator:a({applicationType:"configurator",commonServicesSelectors:Y,domainServicesSelectors:M.selectors.domainServices,domainContextSelectors:M.selectors.domainContext.configurator,getApplicationRuntimeExtensions:()=>[]}),admin:a({applicationType:"admin",commonServicesSelectors:Y,domainServicesSelectors:M.selectors.domainServices,domainContextSelectors:M.selectors.domainContext.admin,getApplicationRuntimeExtensions:()=>[]})},{subscribe:e=>{F.add(e);let t=M.subscribe(e);return()=>{F.delete(e),t()}},getState:()=>({...M.getState(),hostProperties:Q,integration:I,loading:J,responsive:q,routing:L,session:O}),selectors:{...M.selectors,commonServices:Y,hostProperties:X,integration:V,loading:N,responsive:G,routing:H,session:$,domainApplicationContext:ee},actions:{...M.actions,integration:U,loading:K,responsive:B,routing:z,session:Z}}),ea=es.getState().spec;return es.actions.spec.updateSpec({...ea,configurator:{...ea.configurator,createTransformers:e=>k.transformers.map(t=>t.transformer.register(e,t.priority??1/0))}}),es.actions.sessionContext.setSessionContext(i(en,et)),es.actions.access.setConfiguratorAccessInfo({raw:"mock-access-token",access:"read"===eo?t.Read:t.Owner,viewMode:"read"===eo,revisionId:void 0,configurationId:"mock"}),es.actions.domainData.setDomainData({publishedData:k.publishedData,frontendData:k.frontendData,backendData:k.backendData}),es.actions.loadedData.completeConfiguratorLoad({initialRevisionId:"mock-revision",initialEntities:k.entities,modelVersion:T.domain.domainFactory.modelVersion,rootEntityType:k.rootEntityType,schemaIdentity:T.domain.domainFactory}),es};
+import{memoOnce as e}from"@salsita-ai/common/utils";import{AccessLevel as t}from"@salsita-ai/contracts/api";import{createDomainRuntime as o,createMockDomainRuntimeServices as n,createMockSessionContext as i}from"#package/domain";import{createCommonServicesSelectors as s}from"../common-services/index.js";import{createDomainApplicationContextSelectors as a}from"../domain-application-context/index.js";import{connectHostProperties as r,createHostPropertiesActions as c,createHostPropertiesSelectors as m,initializeHostProperties as p}from"../host-properties/index.js";import{createIntegrationActions as d,createIntegrationSelectors as l,initializeIntegration as g}from"../integration/index.js";import{createLoadingActions as S,createLoadingSelectors as f,initializeLoading as v}from"../loading/index.js";import{createResponsiveActions as u,createResponsiveSelectors as C,initializeResponsive as x}from"../responsive/index.js";import{createRoutingActions as b,createRoutingSelectors as y,initializeRouting as w}from"../routing/index.js";import{SessionService as A,createSessionRuntimeActions as D,createSessionRuntimeSelectors as R,initializeSessionRuntime as h}from"../session/index.js";import{createMockWebComponentApi as j}from"../web-component/index.js";export const createMockApplicationRuntime=(T,k)=>{var E;let I,L,O,M,F,H,P,U,V,z,q,B,G,J,K,N,Q,W,X,Y,Z,$,_,ee,{sessionData:et,mode:eo,role:en}=k,ei=n(),es=(E={webComponentOptions:k.webComponentOptions??T.mount.options,webComponentApi:k.webComponentApi??j()},O=h(),M=o({config:T,services:ei,getExtensionSystems:e=>ee[e].getInitializableSystems(),getHostSystems:e=>ee[e].getSystems()}),F=new Set,H=()=>{F.forEach(e=>{e()})},P=d({setIntegration:e=>{I=e(I),H()}}),I=g(),U=l({getState:()=>({integration:I}),actions:P}),V=b({setRouting:e=>{L=e(L),H()}}),L=w(),z=y({getState:()=>({...M.getState(),routing:L}),actions:V,accessActions:M.actions.access,loadedDataActions:M.actions.loadedData,domainServicesSelectors:M.selectors.domainServices,overridesSelectors:M.selectors.overrides}),q=x(),B=u({setResponsive:e=>{let t=e(q);t!==q&&(q=t,H())}}),G={configurator:C({getState:()=>({responsive:q}),applicationType:"configurator"}),admin:C({getState:()=>({responsive:q}),applicationType:"admin"})},J=v(),K=S({setLoading:e=>{let t=e(J);t!==J&&(J=t,H())}}),N={configurator:f({getState:()=>({loading:J}),applicationType:"configurator"}),admin:f({getState:()=>({loading:J}),applicationType:"admin"})},Q=p(E.webComponentApi),W=c({setHostProperties:e=>{let t=e(Q);t!==Q&&(Q=t,H())}}),X=m({getState:()=>({hostProperties:Q})}),r({webComponentApi:E.webComponentApi,actions:W,domainSelectors:M.selectors.webComponent,domainActions:{setReadonly:M.actions.webComponent.setReadonly,setLocale:M.hostMirrorActions.setLocale}}),Y=s({getState:()=>({...M.getState(),session:O}),environmentSelectors:M.selectors.environment,specSelectors:M.selectors.spec,accessSelectors:M.selectors.access,domainServicesSelectors:M.selectors.domainServices,webComponentOptions:E.webComponentOptions,webComponentApi:E.webComponentApi,getSessionService:()=>_(),routingSelectors:z}),Z=D({setSessionRuntime:e=>{O=e(O),H()}}),$=R({getState:()=>({...M.getState(),session:O}),sessionContextSelectors:M.selectors.sessionContext}),_=e(()=>new A({getLogger:()=>M.selectors.domainServices.getLogger(),getAnalyticsService:()=>M.selectors.domainServices.getAnalyticsService(),getUnauthenticatedClient:Y.getUnauthenticatedClient,environmentSelectors:M.selectors.environment,sessionActions:Z,setSessionContext:M.actions.sessionContext.setSessionContext,sessionSelectors:$,specSelectors:M.selectors.spec})),ee={configurator:a({applicationType:"configurator",commonServicesSelectors:Y,domainServicesSelectors:M.selectors.domainServices,domainContextSelectors:M.selectors.domainContext.configurator,getApplicationRuntimeExtensions:()=>[]}),admin:a({applicationType:"admin",commonServicesSelectors:Y,domainServicesSelectors:M.selectors.domainServices,domainContextSelectors:M.selectors.domainContext.admin,getApplicationRuntimeExtensions:()=>[]})},{subscribe:e=>{F.add(e);let t=M.subscribe(e);return()=>{F.delete(e),t()}},getState:()=>({...M.getState(),hostProperties:Q,integration:I,loading:J,responsive:q,routing:L,session:O}),selectors:{...M.selectors,commonServices:Y,hostProperties:X,integration:U,loading:N,responsive:G,routing:z,session:$,domainApplicationContext:ee},actions:{...M.actions,integration:P,loading:K,responsive:B,routing:V,session:Z}}),ea=es.getState().spec;return es.actions.spec.updateSpec({...ea,configurator:{...ea.configurator,createTransformers:e=>k.transformers.map(t=>t.transformer.register(e,t.priority??1/0))}}),es.actions.sessionContext.setSessionContext(i(en,et)),es.actions.access.setConfiguratorAccessInfo({raw:"mock-access-token",access:"read"===eo?t.Read:t.Owner,viewMode:"read"===eo,revisionId:void 0,configurationId:"mock"}),es.actions.domainData.setDomainData({publishedData:k.publishedData,frontendData:k.frontendData,backendData:k.backendData}),es.actions.loadedData.completeConfiguratorLoad({initialRevisionId:"mock-revision",initialEntities:k.entities,modelVersion:T.domain.domainFactory.modelVersion,rootEntityType:k.rootEntityType,schemaIdentity:T.domain.domainFactory}),es};

package/dist/react-sdk/application-runtime/responsive/actions.d.ts

@@ -11,6 +11,8 @@ declare const createApplicationActions: (context: Context, applicationType: Doma
     setViewport: (viewport: ResponsiveViewport) => void;
     setBreakpoints: (breakpoints: ResponsiveBreakpoints) => void;
     setCanvasPadding: (canvasPadding: CanvasPadding) => void;
+    setSceneSafeArea: (sceneSafeArea: CanvasPadding) => void;
+    clearSceneSafeArea: (sceneSafeArea: CanvasPadding) => void;
     expand: () => void;
     collapse: () => void;
     hide: () => void;
@@ -24,6 +26,8 @@ export declare const createResponsiveActions: (context: Context) => {
         setViewport: (viewport: ResponsiveViewport) => void;
         setBreakpoints: (breakpoints: ResponsiveBreakpoints) => void;
         setCanvasPadding: (canvasPadding: CanvasPadding) => void;
+        setSceneSafeArea: (sceneSafeArea: CanvasPadding) => void;
+        clearSceneSafeArea: (sceneSafeArea: CanvasPadding) => void;
         expand: () => void;
         collapse: () => void;
         hide: () => void;
@@ -35,6 +39,8 @@ export declare const createResponsiveActions: (context: Context) => {
         setViewport: (viewport: ResponsiveViewport) => void;
         setBreakpoints: (breakpoints: ResponsiveBreakpoints) => void;
         setCanvasPadding: (canvasPadding: CanvasPadding) => void;
+        setSceneSafeArea: (sceneSafeArea: CanvasPadding) => void;
+        clearSceneSafeArea: (sceneSafeArea: CanvasPadding) => void;
         expand: () => void;
         collapse: () => void;
         hide: () => void;

package/dist/react-sdk/application-runtime/responsive/actions.js

@@ -1 +1 @@
-import{initializeResponsiveApplication as t}from"./initialize.js";let e=(e,i)=>{let n=t=>{e.setResponsive(e=>{let n=e[i],s=t(n);return s===n?e:{...e,[i]:s}})},s=t=>{n(e=>e.isExpanded===t?e:{...e,isExpanded:t})},r=t=>{n(e=>e.isHidden===t?e:{...e,isHidden:t})};return{setViewport:t=>{n(e=>{let i;return(i=e.viewport,null!==i&&i.width===t.width&&i.height===t.height&&i.isLandscape===t.isLandscape&&i.isPortrait===t.isPortrait)?e:{...e,viewport:t}})},setBreakpoints:t=>{n(e=>{let i;return(i=e.breakpoints,i.sm===t.sm&&i.md===t.md&&i.lg===t.lg)?e:{...e,breakpoints:t}})},setCanvasPadding:t=>{n(e=>{let i;return(i=e.canvasPadding,i.top===t.top&&i.right===t.right&&i.bottom===t.bottom&&i.left===t.left)?e:{...e,canvasPadding:t}})},expand:()=>{s(!0)},collapse:()=>{s(!1)},hide:()=>{r(!0)},show:()=>{r(!1)},setAnimating:t=>{n(e=>e.isAnimating===t?e:{...e,isAnimating:t})},reset:()=>{n(()=>t())}}};export const createResponsiveActions=t=>({configurator:e(t,"configurator"),admin:e(t,"admin")});
+import{initializeResponsiveApplication as e}from"./initialize.js";let t=(e,t)=>e.top===t.top&&e.right===t.right&&e.bottom===t.bottom&&e.left===t.left,a=(a,i)=>{let n=e=>{a.setResponsive(t=>{let a=t[i],n=e(a);return n===a?t:{...t,[i]:n}})},s=e=>{n(t=>t.isExpanded===e?t:{...t,isExpanded:e})},r=e=>{n(t=>t.isHidden===e?t:{...t,isHidden:e})};return{setViewport:e=>{n(t=>{let a;return(a=t.viewport,null!==a&&a.width===e.width&&a.height===e.height&&a.isLandscape===e.isLandscape&&a.isPortrait===e.isPortrait)?t:{...t,viewport:e}})},setBreakpoints:e=>{n(t=>{let a;return(a=t.breakpoints,a.sm===e.sm&&a.md===e.md&&a.lg===e.lg)?t:{...t,breakpoints:e}})},setCanvasPadding:e=>{n(a=>t(a.canvasPadding,e)?a:{...a,canvasPadding:e})},setSceneSafeArea:e=>{n(a=>null!==a.sceneSafeArea&&t(a.sceneSafeArea,e)?a:{...a,sceneSafeArea:e})},clearSceneSafeArea:e=>{n(a=>null!==a.sceneSafeArea&&t(a.sceneSafeArea,e)?{...a,sceneSafeArea:null}:a)},expand:()=>{s(!0)},collapse:()=>{s(!1)},hide:()=>{r(!0)},show:()=>{r(!1)},setAnimating:e=>{n(t=>t.isAnimating===e?t:{...t,isAnimating:e})},reset:()=>{n(()=>e())}}};export const createResponsiveActions=e=>({configurator:a(e,"configurator"),admin:a(e,"admin")});

package/dist/react-sdk/application-runtime/responsive/initialize.js

@@ -1 +1 @@
-export const initializeResponsiveApplication=()=>({viewport:null,breakpoints:{sm:480,md:768,lg:1024},canvasPadding:{top:0,right:0,bottom:0,left:0},isExpanded:!1,isHidden:!1,isAnimating:!1});export const initializeResponsive=()=>({configurator:initializeResponsiveApplication(),admin:initializeResponsiveApplication()});
+export const initializeResponsiveApplication=()=>({viewport:null,breakpoints:{sm:480,md:768,lg:1024},canvasPadding:{top:0,right:0,bottom:0,left:0},sceneSafeArea:null,isExpanded:!1,isHidden:!1,isAnimating:!1});export const initializeResponsive=()=>({configurator:initializeResponsiveApplication(),admin:initializeResponsiveApplication()});

package/dist/react-sdk/application-runtime/responsive/selectors.js

@@ -1 +1 @@
-import{createSelector as e}from"@salsita-ai/common/utils";export const createResponsiveSelectors=i=>{let{getState:s,applicationType:t}=i,a=e.withTypes(),o=a.leaf(e=>null!==e.responsive[t].viewport),n=a.leaf(e=>e.responsive[t].viewport?.width??0),r=a.leaf(e=>e.responsive[t].viewport?.height??0),p=a.leaf(e=>e.responsive[t].viewport?.isLandscape??!1),l=a.leaf(e=>e.responsive[t].viewport?.isPortrait??!1),v=a.leaf(e=>e.responsive[t].breakpoints),d=a.leaf(e=>e.responsive[t].canvasPadding),f=a.leaf(e=>e.responsive[t].isExpanded),g=a.leaf(e=>e.responsive[t].isHidden),h=a.leaf(e=>e.responsive[t].isAnimating),m=a([o,n,v],(e,i,s)=>e&&i<s.sm),w=a([o,n,v],(e,i,s)=>e&&i<=s.md),c=a([o,n,v],(e,i,s)=>e&&i<s.lg&&i>s.sm),u=a([o,n,v],(e,i,s)=>e&&i>s.md),P=a([m,w,c,u,p,l,d,f,g,h],(e,i,s,t,a,o,n,r,p,l)=>({isPhone:e,isMobile:i,isTablet:s,isDesktop:t,isLandscape:a,isPortrait:o,canvasPadding:n,isExpanded:r,isHidden:p,isAnimating:l})),S=a([n,r],(e,i)=>({width:Math.ceil(e),height:Math.ceil(i)}));return{selectResponsiveState:P,selectViewportSize:S,selectCanvasPadding:d,getResponsiveState:()=>P(s()),getViewportSize:()=>S(s()),getCanvasPadding:()=>d(s())}};
+import{createSelector as e}from"@salsita-ai/common/utils";export const createResponsiveSelectors=s=>{let{getState:i,applicationType:a}=s,t=e.withTypes(),n=t.leaf(e=>null!==e.responsive[a].viewport),o=t.leaf(e=>e.responsive[a].viewport?.width??0),r=t.leaf(e=>e.responsive[a].viewport?.height??0),p=t.leaf(e=>e.responsive[a].viewport?.isLandscape??!1),l=t.leaf(e=>e.responsive[a].viewport?.isPortrait??!1),v=t.leaf(e=>e.responsive[a].breakpoints),d=t.leaf(e=>e.responsive[a].canvasPadding),f=t.leaf(e=>e.responsive[a].sceneSafeArea),c=t.leaf(e=>e.responsive[a].isExpanded),g=t.leaf(e=>e.responsive[a].isHidden),h=t.leaf(e=>e.responsive[a].isAnimating),m=t([n,o,v],(e,s,i)=>e&&s<i.sm),w=t([n,o,v],(e,s,i)=>e&&s<=i.md),S=t([n,o,v],(e,s,i)=>e&&s<i.lg&&s>i.sm),u=t([n,o,v],(e,s,i)=>e&&s>i.md),P=t([m,w,S,u,p,l,d,f,c,g,h],(e,s,i,a,t,n,o,r,p,l,v)=>({isPhone:e,isMobile:s,isTablet:i,isDesktop:a,isLandscape:t,isPortrait:n,canvasPadding:o,sceneSafeArea:r,isExpanded:p,isHidden:l,isAnimating:v})),x=t([o,r],(e,s)=>({width:Math.ceil(e),height:Math.ceil(s)}));return{selectResponsiveState:P,selectViewportSize:x,selectCanvasPadding:d,getResponsiveState:()=>P(i()),getViewportSize:()=>x(i()),getCanvasPadding:()=>d(i())}};

package/dist/react-sdk/application-runtime/responsive/types.d.ts

@@ -62,6 +62,8 @@ export interface ResponsiveApplicationState {
     readonly viewport: ResponsiveViewport | null;
     readonly breakpoints: ResponsiveBreakpoints;
     readonly canvasPadding: CanvasPadding;
+    /** `null` until a layout measures its safe area; see {@link ResponsiveState.sceneSafeArea}. */
+    readonly sceneSafeArea: CanvasPadding | null;
     readonly isExpanded: boolean;
     readonly isHidden: boolean;
     readonly isAnimating: boolean;
@@ -98,6 +100,13 @@ export interface ResponsiveState {
     readonly isLandscape: boolean;
     readonly isPortrait: boolean;
     readonly canvasPadding: CanvasPadding;
+    /**
+     * The part of the root container, in pixels from each edge, that the layout's own UI covers, as
+     * the layout measured it. Unlike `canvasPadding`, a project's `canvasPadding` fractions do not
+     * scale it, so UI that must sit beside the layout's sidebar or panel, such as the assistant's
+     * image view, is placed inside it. `null` while no layout measures one, as with the legacy layouts.
+     */
+    readonly sceneSafeArea: CanvasPadding | null;
     readonly isExpanded: boolean;
     readonly isHidden: boolean;
     readonly isAnimating: boolean;

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

@@ -1,5 +1,5 @@
 import { BehaviorSubject } from 'rxjs';
-import { type AnyApplicationConfig, type DomainRuntimeState, type WebComponentOptions } from '#package/domain';
+import { type AnyApplicationConfig, type Application, type DomainRuntimeState, type WebComponentOptions } from '#package/domain';
 import { type AnyApplicationRuntimeExtension, type DomainApplicationContextSelectors } from '../domain-application-context/index.js';
 import { type HostPropertiesState } from '../host-properties/index.js';
 import { type IntegrationState } from '../integration/index.js';
@@ -23,8 +23,19 @@ export interface ApplicationRuntimeBootConfig {
     readonly webComponentOptions: WebComponentOptions;
     readonly webComponentApi: WebComponentApi;
 }
-interface Props<State extends ApplicationRuntimeState, CONFIGURATOR_EXTENSIONS extends readonly AnyApplicationRuntimeExtension[]> {
+/**
+ * What an application runtime starts from: an application, or the config of a project built with
+ * `ConfiguratorBuilder`, which the runtime converts with `applicationFromConfig` when it creates its
+ * slices.
+ */
+type ApplicationRuntimeSource = {
+    readonly application: Application;
+    readonly config?: undefined;
+} | {
     readonly config: AnyApplicationConfig;
+    readonly application?: undefined;
+};
+type Props<State extends ApplicationRuntimeState, CONFIGURATOR_EXTENSIONS extends readonly AnyApplicationRuntimeExtension[]> = ApplicationRuntimeSource & {
     readonly bootConfig: ApplicationRuntimeBootConfig;
     readonly getSubject: () => BehaviorSubject<State>;
     /**
@@ -32,7 +43,7 @@ interface Props<State extends ApplicationRuntimeState, CONFIGURATOR_EXTENSIONS e
      * breaks the construction cycle while the extension factory receives the base runtime slices.
      */
     readonly getConfiguratorExtensions: () => CONFIGURATOR_EXTENSIONS | null;
-}
+};
 /**
  * The domain-application layer: the domain runtime plus the browser-application concerns React
  * needs — common services, host properties, integration, routing, session, loading — and the
@@ -196,6 +207,7 @@ export declare function createApplicationRuntimeSlices<State extends Application
             selectEnvironmentIsDev: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean>;
             selectGodMode: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean>;
             selectEditorMode: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean>;
+            selectAgentMode: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean>;
             selectDeploymentId: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, string>;
             selectDatadogEnabled: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean | undefined>;
             selectDatadogSite: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, string | undefined>;
@@ -219,6 +231,7 @@ export declare function createApplicationRuntimeSlices<State extends Application
             getEnvironmentIsDev: () => boolean;
             getGodMode: () => boolean;
             getEditorMode: () => boolean;
+            getAgentMode: () => boolean;
             getDeploymentId: () => string;
             getDatadogEnabled: () => boolean | undefined;
             getDatadogSite: () => string | undefined;
@@ -480,6 +493,7 @@ export declare function createApplicationRuntimeSlices<State extends Application
                 getBlenderProjections: () => import("#package/domain").AnyBlenderProjections;
                 getExpressionContext: () => import("#package/domain").AnyExpressionContext;
                 getDomainSystems: () => import("#package/domain").AnyDomainContextSystems;
+                getHostSystems: () => object;
                 getDomainContext: () => import("#package/domain").DomainContext;
             };
             admin: {
@@ -590,6 +604,7 @@ export declare function createApplicationRuntimeSlices<State extends Application
                 getBlenderProjections: () => import("#package/domain").AnyBlenderProjections;
                 getExpressionContext: () => import("#package/domain").AnyExpressionContext;
                 getDomainSystems: () => import("#package/domain").AnyDomainContextSystems;
+                getHostSystems: () => object;
                 getDomainContext: () => import("#package/domain").DomainContext;
             };
         };
@@ -768,6 +783,7 @@ export declare function createApplicationRuntimeSlices<State extends Application
             updateEnvironment: (environment: import("#package/domain").ApplicationEnvironmentConfig) => void;
             setGodMode: (godMode: boolean) => void;
             setEditorMode: (editorMode: boolean) => void;
+            setAgentMode: (agentMode: boolean) => void;
         };
         loadedData: {
             startConfiguratorLoad: () => void;
@@ -837,6 +853,8 @@ export declare function createApplicationRuntimeSlices<State extends Application
                 setViewport: (viewport: import("../index.js").ResponsiveViewport) => void;
                 setBreakpoints: (breakpoints: import("../index.js").ResponsiveBreakpoints) => void;
                 setCanvasPadding: (canvasPadding: import("../index.js").CanvasPadding) => void;
+                setSceneSafeArea: (sceneSafeArea: import("../index.js").CanvasPadding) => void;
+                clearSceneSafeArea: (sceneSafeArea: import("../index.js").CanvasPadding) => void;
                 expand: () => void;
                 collapse: () => void;
                 hide: () => void;
@@ -848,6 +866,8 @@ export declare function createApplicationRuntimeSlices<State extends Application
                 setViewport: (viewport: import("../index.js").ResponsiveViewport) => void;
                 setBreakpoints: (breakpoints: import("../index.js").ResponsiveBreakpoints) => void;
                 setCanvasPadding: (canvasPadding: import("../index.js").CanvasPadding) => void;
+                setSceneSafeArea: (sceneSafeArea: import("../index.js").CanvasPadding) => void;
+                clearSceneSafeArea: (sceneSafeArea: import("../index.js").CanvasPadding) => void;
                 expand: () => void;
                 collapse: () => void;
                 hide: () => void;
@@ -872,7 +892,7 @@ export type CreateApplicationRuntimeExtensions<EXTENSIONS extends readonly AnyAp
  * The application runtime owns the subject and merges a caller-defined system extension into the
  * built-in domain-application systems. Every extension system participates in initialization.
  */
-declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyApplicationRuntimeExtension[]>(config: AnyApplicationConfig, bootConfig: ApplicationRuntimeBootConfig, createExtensions?: CreateApplicationRuntimeExtensions<EXTENSIONS>) => {
+declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyApplicationRuntimeExtension[]>(source: AnyApplicationConfig | Application, bootConfig: ApplicationRuntimeBootConfig, createExtensions?: CreateApplicationRuntimeExtensions<EXTENSIONS>) => {
     selectors: {
         domainServices: {
             getAnalyticsService: () => import("#package/domain").AnalyticsSystem;
@@ -1002,6 +1022,7 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
             selectEnvironmentIsDev: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean>;
             selectGodMode: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean>;
             selectEditorMode: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean>;
+            selectAgentMode: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean>;
             selectDeploymentId: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, string>;
             selectDatadogEnabled: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, boolean | undefined>;
             selectDatadogSite: import("@salsita-ai/common/utils").Selector<import("#package/domain").EnvironmentSelectorState, string | undefined>;
@@ -1025,6 +1046,7 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
             getEnvironmentIsDev: () => boolean;
             getGodMode: () => boolean;
             getEditorMode: () => boolean;
+            getAgentMode: () => boolean;
             getDeploymentId: () => string;
             getDatadogEnabled: () => boolean | undefined;
             getDatadogSite: () => string | undefined;
@@ -1286,6 +1308,7 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
                 getBlenderProjections: () => import("#package/domain").AnyBlenderProjections;
                 getExpressionContext: () => import("#package/domain").AnyExpressionContext;
                 getDomainSystems: () => import("#package/domain").AnyDomainContextSystems;
+                getHostSystems: () => object;
                 getDomainContext: () => import("#package/domain").DomainContext;
             };
             admin: {
@@ -1396,6 +1419,7 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
                 getBlenderProjections: () => import("#package/domain").AnyBlenderProjections;
                 getExpressionContext: () => import("#package/domain").AnyExpressionContext;
                 getDomainSystems: () => import("#package/domain").AnyDomainContextSystems;
+                getHostSystems: () => object;
                 getDomainContext: () => import("#package/domain").DomainContext;
             };
         };
@@ -1574,6 +1598,7 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
             updateEnvironment: (environment: import("#package/domain").ApplicationEnvironmentConfig) => void;
             setGodMode: (godMode: boolean) => void;
             setEditorMode: (editorMode: boolean) => void;
+            setAgentMode: (agentMode: boolean) => void;
         };
         loadedData: {
             startConfiguratorLoad: () => void;
@@ -1643,6 +1668,8 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
                 setViewport: (viewport: import("../index.js").ResponsiveViewport) => void;
                 setBreakpoints: (breakpoints: import("../index.js").ResponsiveBreakpoints) => void;
                 setCanvasPadding: (canvasPadding: import("../index.js").CanvasPadding) => void;
+                setSceneSafeArea: (sceneSafeArea: import("../index.js").CanvasPadding) => void;
+                clearSceneSafeArea: (sceneSafeArea: import("../index.js").CanvasPadding) => void;
                 expand: () => void;
                 collapse: () => void;
                 hide: () => void;
@@ -1654,6 +1681,8 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
                 setViewport: (viewport: import("../index.js").ResponsiveViewport) => void;
                 setBreakpoints: (breakpoints: import("../index.js").ResponsiveBreakpoints) => void;
                 setCanvasPadding: (canvasPadding: import("../index.js").CanvasPadding) => void;
+                setSceneSafeArea: (sceneSafeArea: import("../index.js").CanvasPadding) => void;
+                clearSceneSafeArea: (sceneSafeArea: import("../index.js").CanvasPadding) => void;
                 expand: () => void;
                 collapse: () => void;
                 hide: () => void;
@@ -1674,6 +1703,6 @@ declare const createApplicationRuntimeImpl: <EXTENSIONS extends readonly AnyAppl
     subscribe: (callback: () => void) => () => void;
 };
 export type CreatedApplicationRuntime<EXTENSIONS extends readonly AnyApplicationRuntimeExtension[]> = ReturnType<typeof createApplicationRuntimeImpl<EXTENSIONS>>;
-export declare function createApplicationRuntime(config: AnyApplicationConfig, bootConfig: ApplicationRuntimeBootConfig): CreatedApplicationRuntime<readonly []>;
-export declare function createApplicationRuntime<EXTENSIONS extends readonly AnyApplicationRuntimeExtension[]>(config: AnyApplicationConfig, bootConfig: ApplicationRuntimeBootConfig, createExtensions: CreateApplicationRuntimeExtensions<EXTENSIONS>): CreatedApplicationRuntime<EXTENSIONS>;
+export declare function createApplicationRuntime(source: AnyApplicationConfig | Application, bootConfig: ApplicationRuntimeBootConfig): CreatedApplicationRuntime<readonly []>;
+export declare function createApplicationRuntime<EXTENSIONS extends readonly AnyApplicationRuntimeExtension[]>(source: AnyApplicationConfig | Application, bootConfig: ApplicationRuntimeBootConfig, createExtensions: CreateApplicationRuntimeExtensions<EXTENSIONS>): CreatedApplicationRuntime<EXTENSIONS>;
 export {};

package/dist/react-sdk/application-runtime/runtime/create-application-runtime.js

@@ -1 +1 @@
-import{BehaviorSubject as e}from"rxjs";import{memoOnce as t}from"@salsita-ai/common/utils";import{ImplementationErrors as o,createDomainRuntimeSlices as i,findAssistantFormElementErrors as n,resolveIsDev as s}from"#package/domain";import{initializeAnalyticsService as a}from"../common-services/analytics/analytics-service.js";import{initializeI18n as r,initializeLogger as l}from"../common-services/initialize.js";import{createCommonServicesSelectors as c}from"../common-services/selectors.js";import{createDomainApplicationContextSelectors as p}from"../domain-application-context/index.js";import{connectHostProperties as m,createHostPropertiesActions as u,createHostPropertiesSelectors as d,initializeHostProperties as g}from"../host-properties/index.js";import{createIntegrationActions as v,createIntegrationSelectors as S,initializeIntegration as x}from"../integration/index.js";import{createLoadingActions as f,createLoadingSelectors as C,initializeLoading as y}from"../loading/index.js";import{createResponsiveActions as b,createResponsiveSelectors as A,initializeResponsive as w}from"../responsive/index.js";import{createRoutingActions as h,createRoutingSelectors as j,initializeRouting as R}from"../routing/index.js";import{SessionService as T,createSessionRuntimeActions as E,createSessionRuntimeSelectors as I,initializeSessionRuntime as P}from"../session/index.js";export function createApplicationRuntimeSlices(e){let{config:L,bootConfig:z,getSubject:D,getConfiguratorExtensions:H}=e,O=s(L),U=l(L,O),k={analyticsService:a(L,U,O),i18n:r(L),logger:U},{initialize:G,selectors:$,actions:q,hostMirrorActions:B}=i({config:L,services:k,getSubject:D,getExtensionSystems:e=>em[e].getInitializableSystems()}),F=G(),{assistant:J,elements:K}=F.spec.configurator,M=n(J?.formElements??[],K);if(M.length>0)throw new o(M);let N=u({setHostProperties:e=>{let t=D(),o=e(t.value.hostProperties);o!==t.value.hostProperties&&t.next({...t.value,hostProperties:o})}}),Q=d({getState:()=>D().value}),V=v({setIntegration:e=>{let t=D(),o=e(t.value.integration);t.next({...t.value,integration:o})}}),W=S({getState:()=>D().value,actions:V}),X=x(),Y=h({setRouting:e=>{let t=D(),o=e(t.value.routing);t.next({...t.value,routing:o})}}),Z=j({getState:()=>D().value,actions:Y,accessActions:q.access,loadedDataActions:q.loadedData,domainServicesSelectors:$.domainServices,overridesSelectors:$.overrides}),_=R(),ee=b({setResponsive:e=>{let t=D(),o=e(t.value.responsive);o!==t.value.responsive&&t.next({...t.value,responsive:o})}}),et={configurator:A({getState:()=>D().value,applicationType:"configurator"}),admin:A({getState:()=>D().value,applicationType:"admin"})},eo=w(),ei=f({setLoading:e=>{let t=D(),o=e(t.value.loading);o!==t.value.loading&&t.next({...t.value,loading:o})}}),en={configurator:C({getState:()=>D().value,applicationType:"configurator"}),admin:C({getState:()=>D().value,applicationType:"admin"})},es=y(),ea=c({getState:()=>D().value,environmentSelectors:$.environment,specSelectors:$.spec,accessSelectors:$.access,domainServicesSelectors:$.domainServices,webComponentOptions:z.webComponentOptions,webComponentApi:z.webComponentApi,getSessionService:()=>ep(),routingSelectors:Z}),er=E({setSessionRuntime:e=>{let t=D(),o=e(t.value.session);t.next({...t.value,session:o})}}),el=I({getState:()=>D().value,sessionContextSelectors:$.sessionContext}),ec=P(),ep=t(()=>new T({getLogger:()=>$.domainServices.getLogger(),getAnalyticsService:()=>$.domainServices.getAnalyticsService(),getUnauthenticatedClient:ea.getUnauthenticatedClient,environmentSelectors:$.environment,sessionActions:er,setSessionContext:q.sessionContext.setSessionContext,sessionSelectors:el,specSelectors:$.spec})),em={configurator:p({applicationType:"configurator",commonServicesSelectors:ea,domainServicesSelectors:$.domainServices,domainContextSelectors:$.domainContext.configurator,getApplicationRuntimeExtensions:H}),admin:p({applicationType:"admin",commonServicesSelectors:ea,domainServicesSelectors:$.domainServices,domainContextSelectors:$.domainContext.admin,getApplicationRuntimeExtensions:()=>[]})};return U.info(`Configurator Application loaded with deployment ID: ${L.deploymentId}!`),U.appendToGlobalContext({deploymentId:L.deploymentId}),{getState:()=>D().value,initialize:()=>({...F,hostProperties:g(z.webComponentApi),integration:X,loading:es,responsive:eo,routing:_,session:ec}),connectHost:()=>m({webComponentApi:z.webComponentApi,actions:N,domainSelectors:$.webComponent,domainActions:{setReadonly:q.webComponent.setReadonly,setLocale:B.setLocale}}),selectors:{...$,commonServices:ea,hostProperties:Q,integration:W,loading:en,responsive:et,routing:Z,session:el,domainApplicationContext:em},actions:{...q,integration:V,loading:ei,responsive:ee,routing:Y,session:er}}}export function createApplicationRuntime(t,o,i){return((t,o,i)=>{let n=null,s=null,a=()=>{if(!n)throw Error("Subject not yet initialized!");return n},{initialize:r,connectHost:l,...c}=createApplicationRuntimeSlices({config:t,bootConfig:o,getSubject:a,getConfiguratorExtensions:()=>s});return s=i?i(c):[],c.selectors.domainApplicationContext.configurator.getSystems(),n=new e(r()),l(),{...c,getState:()=>a().value,subscribe:e=>{let t=a().subscribe(()=>e());return()=>t.unsubscribe()}}})(t,o,i)}
+import{BehaviorSubject as e}from"rxjs";import{memoOnce as t}from"@salsita-ai/common/utils";import{ImplementationErrors as o,applicationFromConfig as i,createDomainRuntimeSlices as n,findAssistantFormElementErrors as s,resolveIsDev as a}from"#package/domain";import{initializeAnalyticsService as r}from"../common-services/analytics/analytics-service.js";import{initializeI18n as c,initializeLogger as l}from"../common-services/initialize.js";import{createCommonServicesSelectors as p}from"../common-services/selectors.js";import{createDomainApplicationContextSelectors as m}from"../domain-application-context/index.js";import{connectHostProperties as g,createHostPropertiesActions as u,createHostPropertiesSelectors as v,initializeHostProperties as d}from"../host-properties/index.js";import{createIntegrationActions as S,createIntegrationSelectors as x,initializeIntegration as f}from"../integration/index.js";import{createLoadingActions as C,createLoadingSelectors as y,initializeLoading as b}from"../loading/index.js";import{createResponsiveActions as A,createResponsiveSelectors as w,initializeResponsive as h}from"../responsive/index.js";import{createRoutingActions as j,createRoutingSelectors as R,initializeRouting as T}from"../routing/index.js";import{SessionService as E,createSessionRuntimeActions as I,createSessionRuntimeSelectors as P,initializeSessionRuntime as L}from"../session/index.js";export function createApplicationRuntimeSlices(e){let{bootConfig:z,getSubject:D,getConfiguratorExtensions:H}=e,O=e.application??i(e.config),U={...O.environment,services:O.services,version:O.spec.version},k=a(U),G=l(U,k),{initialize:$,selectors:q,actions:B,hostMirrorActions:F}=n({application:O,services:{analyticsService:r(U,G,k),i18n:c(U),logger:G},getSubject:D,getExtensionSystems:e=>eg[e].getInitializableSystems(),getHostSystems:e=>eg[e].getSystems()}),J=$(),{assistant:K,elements:M}=J.spec.configurator,N=s(K?.formElements??[],M);if(N.length>0)throw new o(N);let Q=u({setHostProperties:e=>{let t=D(),o=e(t.value.hostProperties);o!==t.value.hostProperties&&t.next({...t.value,hostProperties:o})}}),V=v({getState:()=>D().value}),W=S({setIntegration:e=>{let t=D(),o=e(t.value.integration);t.next({...t.value,integration:o})}}),X=x({getState:()=>D().value,actions:W}),Y=f(),Z=j({setRouting:e=>{let t=D(),o=e(t.value.routing);t.next({...t.value,routing:o})}}),_=R({getState:()=>D().value,actions:Z,accessActions:B.access,loadedDataActions:B.loadedData,domainServicesSelectors:q.domainServices,overridesSelectors:q.overrides}),ee=T(),et=A({setResponsive:e=>{let t=D(),o=e(t.value.responsive);o!==t.value.responsive&&t.next({...t.value,responsive:o})}}),eo={configurator:w({getState:()=>D().value,applicationType:"configurator"}),admin:w({getState:()=>D().value,applicationType:"admin"})},ei=h(),en=C({setLoading:e=>{let t=D(),o=e(t.value.loading);o!==t.value.loading&&t.next({...t.value,loading:o})}}),es={configurator:y({getState:()=>D().value,applicationType:"configurator"}),admin:y({getState:()=>D().value,applicationType:"admin"})},ea=b(),er=p({getState:()=>D().value,environmentSelectors:q.environment,specSelectors:q.spec,accessSelectors:q.access,domainServicesSelectors:q.domainServices,webComponentOptions:z.webComponentOptions,webComponentApi:z.webComponentApi,getSessionService:()=>em(),routingSelectors:_}),ec=I({setSessionRuntime:e=>{let t=D(),o=e(t.value.session);t.next({...t.value,session:o})}}),el=P({getState:()=>D().value,sessionContextSelectors:q.sessionContext}),ep=L(),em=t(()=>new E({getLogger:()=>q.domainServices.getLogger(),getAnalyticsService:()=>q.domainServices.getAnalyticsService(),getUnauthenticatedClient:er.getUnauthenticatedClient,environmentSelectors:q.environment,sessionActions:ec,setSessionContext:B.sessionContext.setSessionContext,sessionSelectors:el,specSelectors:q.spec})),eg={configurator:m({applicationType:"configurator",commonServicesSelectors:er,domainServicesSelectors:q.domainServices,domainContextSelectors:q.domainContext.configurator,getApplicationRuntimeExtensions:H}),admin:m({applicationType:"admin",commonServicesSelectors:er,domainServicesSelectors:q.domainServices,domainContextSelectors:q.domainContext.admin,getApplicationRuntimeExtensions:()=>[]})};return G.info(`Configurator Application loaded with deployment ID: ${U.deploymentId}!`),G.appendToGlobalContext({deploymentId:U.deploymentId}),{getState:()=>D().value,initialize:()=>({...J,hostProperties:d(z.webComponentApi),integration:Y,loading:ea,responsive:ei,routing:ee,session:ep}),connectHost:()=>g({webComponentApi:z.webComponentApi,actions:Q,domainSelectors:q.webComponent,domainActions:{setReadonly:B.webComponent.setReadonly,setLocale:F.setLocale}}),selectors:{...q,commonServices:er,hostProperties:V,integration:X,loading:es,responsive:eo,routing:_,session:el,domainApplicationContext:eg},actions:{...B,integration:W,loading:en,responsive:et,routing:Z,session:ec}}}export function createApplicationRuntime(t,o,i){return((t,o,i)=>{let n=null,s=null,a=()=>{if(!n)throw Error("Subject not yet initialized!");return n},{initialize:r,connectHost:c,...l}=createApplicationRuntimeSlices({..."spec"in t?{application:t}:{config:t},bootConfig:o,getSubject:a,getConfiguratorExtensions:()=>s});return s=i?i(l):[],l.selectors.domainApplicationContext.configurator.getSystems(),n=new e(r()),c(),{...l,getState:()=>a().value,subscribe:e=>{let t=a().subscribe(()=>e());return()=>t.unsubscribe()}}})(t,o,i)}

package/dist/{configurator/configurator-context → react-sdk}/configurator-routing/ConfiguratorRoutingProvider.d.ts

@@ -3,7 +3,7 @@ import type { ReactNode } from 'react';
  * This is probably a temporary solution, we may need an actual routing library in the future.
  * @beta
  */
-export declare const useConfiguratorRouting: () => import("#package/react-sdk").RoutingService;
+export declare const useConfiguratorRouting: () => import("../index.js").RoutingService;
 export type UseConfiguratorRouting = typeof useConfiguratorRouting;
 export interface ConfiguratorRoutingProviderProps {
     readonly children: ReactNode;

package/dist/react-sdk/configurator-routing/ConfiguratorRoutingProvider.js

@@ -0,0 +1 @@
+import{jsx as r,Fragment as t}from"react/jsx-runtime";import{useCallback as o,useEffect as e,useLayoutEffect as n,useState as i}from"react";import{standardWebComponentEvents as a,standardWebComponentProperties as u}from"#package/domain";import{ApplicationRoutes as g,INTEGRATION_MODE_SETTINGS as s,setConfigurationIdQuery as m,useDispatchWebComponentEvent as d,useRoutingSelectors as l,useRoutingService as c,useWebComponentProperty$ as f,useWebComponentPropertyValue as p}from"../application-runtime/index.js";import{useOnGoToIndexHandler as x}from"./OnGoToIndexHandler.js";export const useConfiguratorRouting=()=>c();export const ConfiguratorRoutingProvider=T=>{let{children:b}=T,j=c(),v=l(),C=x(),I=p(u.integrationMode),O=f(u.route),R=d(a.navigated),h=o(r=>{O.next(r),s[I].writeCidToUrl&&(r.route===g.Configuration?m(r.configurationId):m(null)),R(r)},[R,I,O]),[G,k]=i(!1),w=C?.handler;return(e(()=>{if(w)return j.registerOnGoToIndex(w)},[j,w]),e(()=>j.registerOnNavigated(h),[j,h]),n(()=>{j.routeTo(O.value),k(!0)},[j,O,I]),e(()=>{let r=O.subscribe(r=>{v.getRoutingState()!==r&&j.routeTo(r)});return()=>{r.unsubscribe()}},[j,v,O]),G)?r(t,{children:b}):null};