@ai-matrx/messaging 0.10.0 → 0.10.1

package/dist/react.d.cts

@@ -331,7 +331,13 @@ interface MessagingAiOptions {
     transport: MatrxTransport;
     organizationId: string;
     agents: MessagingAgents;
-    /** Stable source slugs so server-side analytics can see where a run came from. */
+    /**
+     * The producer slugs stamped on every run. 🚨 The AI Matrx server keeps a
+     * REGISTER of legal producers and refuses an unregistered one with a 422, so
+     * the defaults below are placeholders that will NOT survive a real server —
+     * only the host knows its registered slugs. Not analytics garnish: an
+     * unstamped or unregistered run is a refused run.
+     */
     sourceApp?: string | undefined;
     sourceFeature?: string | undefined;
     /** Cap on how much transcript is sent. Default 200 messages. */
@@ -987,6 +993,15 @@ interface MessagingProviderProps {
      * number so an organization can decide.
      */
     maxTranscriptMessages?: number | undefined;
+    /**
+     * 🚨 REQUIRED IN PRACTICE FOR AI. The producer slugs stamped on every AI run.
+     * The AI Matrx server keeps a REGISTER of legal producers and REFUSES an
+     * unregistered one with a 422 — so this package's placeholder defaults
+     * (`ai-matrx` / `messaging.<capability>`) fail every call against a real
+     * server. Only the host knows its registered slugs; pass them.
+     */
+    sourceApp?: string | undefined;
+    sourceFeature?: string | undefined;
     /** Handlers for actionable messages. Registered once per handler identity. */
     actions?: readonly ActionHandler<never>[] | undefined;
     /**

package/dist/react.d.ts

@@ -331,7 +331,13 @@ interface MessagingAiOptions {
     transport: MatrxTransport;
     organizationId: string;
     agents: MessagingAgents;
-    /** Stable source slugs so server-side analytics can see where a run came from. */
+    /**
+     * The producer slugs stamped on every run. 🚨 The AI Matrx server keeps a
+     * REGISTER of legal producers and refuses an unregistered one with a 422, so
+     * the defaults below are placeholders that will NOT survive a real server —
+     * only the host knows its registered slugs. Not analytics garnish: an
+     * unstamped or unregistered run is a refused run.
+     */
     sourceApp?: string | undefined;
     sourceFeature?: string | undefined;
     /** Cap on how much transcript is sent. Default 200 messages. */
@@ -987,6 +993,15 @@ interface MessagingProviderProps {
      * number so an organization can decide.
      */
     maxTranscriptMessages?: number | undefined;
+    /**
+     * 🚨 REQUIRED IN PRACTICE FOR AI. The producer slugs stamped on every AI run.
+     * The AI Matrx server keeps a REGISTER of legal producers and REFUSES an
+     * unregistered one with a 422 — so this package's placeholder defaults
+     * (`ai-matrx` / `messaging.<capability>`) fail every call against a real
+     * server. Only the host knows its registered slugs; pass them.
+     */
+    sourceApp?: string | undefined;
+    sourceFeature?: string | undefined;
     /** Handlers for actionable messages. Registered once per handler identity. */
     actions?: readonly ActionHandler<never>[] | undefined;
     /**

package/dist/react.js

@@ -1817,15 +1817,27 @@ function MessagingRuntime(props) {
   const transport = props.transport;
   const agents = props.agents;
   const maxTranscriptMessages = props.maxTranscriptMessages;
+  const sourceApp = props.sourceApp;
+  const sourceFeature = props.sourceFeature;
   const ai = useMemo(() => {
     if (transport === void 0 || agents === void 0 || !ready) return null;
     return createMessagingAi({
       transport,
       organizationId,
       agents,
-      ...maxTranscriptMessages !== void 0 ? { maxTranscriptMessages } : {}
+      ...maxTranscriptMessages !== void 0 ? { maxTranscriptMessages } : {},
+      ...sourceApp !== void 0 ? { sourceApp } : {},
+      ...sourceFeature !== void 0 ? { sourceFeature } : {}
     });
-  }, [transport, agents, ready, organizationId, maxTranscriptMessages]);
+  }, [
+    transport,
+    agents,
+    ready,
+    organizationId,
+    maxTranscriptMessages,
+    sourceApp,
+    sourceFeature
+  ]);
   const renderers = props.actionRenderers;
   const rendererMap = useMemo(() => {
     const map = /* @__PURE__ */ new Map();