@salsita-ai/sdk 0.50.0-develop.514d19d58c → 0.50.0-develop.538edd3280

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.514d19d58c",
+  "version": "0.50.0-develop.538edd3280",
   "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.514d19d58c",
-    "@salsita-ai/contracts": "0.50.0-develop.514d19d58c"
+    "@salsita-ai/contracts": "0.50.0-develop.538edd3280",
+    "@salsita-ai/common": "0.50.0-develop.538edd3280"
   },
   "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";