@ai-matrx/chat 0.5.16 → 0.5.17

package/CHANGELOG.md

@@ -1,9 +1,9 @@
 # @ai-matrx/chat
 
-## 0.5.16
+## 0.5.17
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
-`git diff npm/chat/v0.5.15..npm/chat/v0.5.16 -- apps/shared/chat`).
+`git diff npm/chat/v0.5.16..npm/chat/v0.5.17 -- apps/shared/chat`).
 No source changes intended and no consumer action required.
 
 ## 0.5.10 — message Print is the one message print

package/dist/agents/redux/execution-system/thunks/smart-execute.thunk.js

@@ -66,7 +66,11 @@ import { markResourcesSubmitted } from "../instance-resources/instance-resources
 import { flushRemarkWrites, hasPendingRemarkWrites } from "../instance-resources/remarks.js";
 import { withFreshRemarkRefs } from "../instance-resources/remarks-wire.js";
 import { isOrganizationSelectionCancelled } from "../../../../host/org.js";
-import { runBeforeSend } from "../../../../host/conversation-hooks.js";
+import {
+  runBeforeSend,
+  startHostConversation,
+  startsConversationOnFirstSend
+} from "../../../../host/conversation-hooks.js";
 function hasConversationAtExecutionBoundary(state, conversationId) {
   return state.conversations.byConversationId[conversationId] !== void 0;
 }
@@ -154,6 +158,35 @@ function holdBehindInFlightSend(dispatch, getState, args) {
 const smartExecute = createAsyncThunk(
   "instances/smartExecute",
   async ({ conversationId, surfaceKey, whileRunning = "queue", submission: handed }, { getState, dispatch }) => {
+    if (!handed && startsConversationOnFirstSend(conversationId)) {
+      const draft = captureSubmission(getState(), conversationId);
+      if (isEmptySubmission(draft)) return;
+      if (draft.resources.length > 0) {
+        toast.info("Attachments can't be added yet", {
+          description: "Send your first message as text \u2014 attachments work from the next one."
+        });
+        return;
+      }
+      detachFromComposer(dispatch, getState, conversationId, draft);
+      let realId = null;
+      try {
+        realId = await startHostConversation(conversationId, { text: draft.text });
+      } catch (error) {
+        returnToComposer(dispatch, getState, conversationId, draft);
+        toast.error("Message not sent", {
+          description: error instanceof Error ? error.message : String(error)
+        });
+        return;
+      }
+      if (!realId) {
+        returnToComposer(dispatch, getState, conversationId, draft);
+        toast.error("Message not sent", { description: "The conversation could not be started." });
+        return;
+      }
+      dispatch(setUserInputText({ conversationId: realId, text: draft.text, userValues: draft.userValues }));
+      await dispatch(smartExecute({ conversationId: realId, surfaceKey, whileRunning }));
+      return;
+    }
     if (!handed && !hasConversationAtExecutionBoundary(getState(), conversationId)) {
       await awaitLaunchingConversation(getState, conversationId);
     }

package/dist/host/conversation-hooks.d.ts

@@ -15,6 +15,13 @@
  *                      it. Must not throw (a throw is reported and swallowed).
  *   startConversation  the host names the next conversation's id; the client
  *                      never mints one.
+ *   startsOnFirstSend  this conversation is a DRAFT: it has no server-side
+ *                      conversation yet (the thing it talks about does not
+ *                      exist). The first send calls `startConversation` — the
+ *                      host creates what it must and names the REAL
+ *                      conversation (instance already in the store) — and the
+ *                      words travel to that one. Text only; the draft is
+ *                      never sent to a server under its own id.
  *   everyTurnThroughMandate
  *                      every turn (not only turn 1) POSTs the mandate route,
  *                      with the gate's variables + context — for a mandate
@@ -45,7 +52,11 @@ export interface ConversationHostHooks {
     beforeSend?: (input: HostBeforeSendInput) => Promise<HostTurnExtras | HostSendRefused>;
     held?: HostHeld;
     onEvent?: (event: TypedStreamEvent, ctx: HostStreamTapContext) => void;
-    startConversation?: () => Promise<string>;
+    startConversation?: (input?: {
+        text: string;
+    }) => Promise<string>;
+    /** With `startConversation`: this id is a draft; the first send goes through `startConversation`. */
+    startsOnFirstSend?: boolean;
     everyTurnThroughMandate?: boolean;
     /** How a stored user turn reads on screen (display only; the record is unchanged). */
     displayUserText?: (text: string) => string;
@@ -81,8 +92,12 @@ export declare function takeTurnExtras(conversationId: string): HostTurnExtras |
 export declare function tapStreamEvent(conversationId: string, requestId: string, event: unknown): void;
 /** Should this conversation's later turns also POST the mandate route? */
 export declare function continuesThroughMandate(conversationId: string): boolean;
+/** Is this id a draft whose first send must first create the real conversation? */
+export declare function startsConversationOnFirstSend(conversationId: string): boolean;
 /** Ask the conversation's host for the next conversation id; null when it has no say. */
-export declare function startHostConversation(conversationId: string): Promise<string | null>;
+export declare function startHostConversation(conversationId: string, input?: {
+    text: string;
+}): Promise<string | null>;
 /**
  * Subscribe to changes of this conversation's held sentence: the host's own
  * source, and the registry (a registration swaps which source is listened to).

package/dist/host/conversation-hooks.js

@@ -58,9 +58,13 @@ function tapStreamEvent(conversationId, requestId, event) {
 function continuesThroughMandate(conversationId) {
   return hooksByConversation.get(conversationId)?.everyTurnThroughMandate === true;
 }
-async function startHostConversation(conversationId) {
+function startsConversationOnFirstSend(conversationId) {
+  const hooks = hooksByConversation.get(conversationId);
+  return hooks?.startsOnFirstSend === true && typeof hooks.startConversation === "function";
+}
+async function startHostConversation(conversationId, input) {
   const start = hooksByConversation.get(conversationId)?.startConversation;
-  return start ? start() : null;
+  return start ? start(input) : null;
 }
 function subscribeConversationHeld(conversationId, listener) {
   let current;
@@ -93,6 +97,7 @@ export {
   registerConversationHooks,
   runBeforeSend,
   startHostConversation,
+  startsConversationOnFirstSend,
   subscribeConversationHeld,
   subscribeConversationHooks,
   takeTurnExtras,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.5.16",
+  "version": "0.5.17",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as per-module subpaths @ai-matrx/chat/<domain>/<module> over a host contract (/host, /host/react) whose only required value is a db. One chat, one renderer: the old kernel entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) are retired.",
   "type": "module",
   "license": "MIT",
@@ -167,24 +167,24 @@
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
     "@ai-matrx/agents": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
+    "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/design-system": "latest",
-    "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
-    "@ai-matrx/media": "latest",
-    "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
-    "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
+    "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/alchemy": "latest",
-    "@ai-matrx/diff": "latest"
+    "@ai-matrx/print": "latest",
+    "@ai-matrx/icons": "latest",
+    "@ai-matrx/media": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -299,5 +299,6 @@
     "deps:write": "node ./scripts/finish-build.mjs --write-deps",
     "check:side-panel-bundle": "node ./scripts/check-side-panel-bundle.mjs",
     "check:side-effects": "node ../scripts/check-side-effects-listed.mjs . && node ../scripts/check-side-effects-listed.mjs --self-test"
-  }
+  },
+  "gitHead": "72c166ca9e3b90dc0f6648754257142aba4756b6"
 }