@ai-matrx/chat 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @ai-matrx/chat
 
+## 0.2.3
+### The frontend's last in-flight chat edit, carried at the P27 cutover
+
+- `run-headless-agent-json.ts`: an edit another lane had uncommitted in matrx-frontend's
+  `packages/chat` when that copy was deleted, carried here verbatim.
+- Consumer action: none.
+
 ## 0.2.2
 ### Last re-sync before matrx-frontend consumes the published package (P27)
 

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.d.ts

@@ -28,12 +28,21 @@
 import type { ChatDispatch, ChatRootState } from "../../../../store/root-state.js";
 import type { MessagePart } from "@ai-matrx/agents/generated/stream-events";
 import type { ContextAnchor, SourceFeature, RequestInitiation } from "../../../types/instance.types.js";
+import type { ApplicationScope } from "../../../types/scope.types.js";
 import type { AnyMandateKey } from "@ai-matrx/agents/mandates";
 export interface HeadlessAgentJsonOptions {
-    /** Exact agent to run. Mutually exclusive with mandateKey. */
+    /** Exact agent to run. Mutually exclusive with mandateKey and shortcutId. */
     agentId?: string;
     /** Swappable mandate to resolve inside the canonical launcher, preserving config_overrides. */
     mandateKey?: AnyMandateKey;
+    /**
+     * A saved shortcut to run: the launcher resolves its agent, config and scope
+     * mappings exactly as a menu click would. Mutually exclusive with agentId and
+     * mandateKey. Pair with `applicationScope` for the shortcut's mapped values.
+     */
+    shortcutId?: string;
+    /** UI-captured scope values a shortcut's scopeMappings read (selection, content, …). */
+    applicationScope?: ApplicationScope;
     /** Stable surface key for telemetry + the focus registry. */
     surfaceKey: string;
     /** UI feature that triggered the run. */

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.js

@@ -176,7 +176,7 @@ async function runHeadlessAgentJson(dispatch, getState, opts) {
     {
       onResult: opts.onResult,
       surfaceKey: opts.surfaceKey,
-      agentRef: opts.agentId ?? opts.mandateKey ?? "unknown"
+      agentRef: opts.agentId ?? opts.mandateKey ?? opts.shortcutId ?? "unknown"
     },
     result
   );
@@ -244,20 +244,20 @@ async function launchAndWait(dispatch, getState, opts) {
   };
   try {
     let executionIdentity;
+    const identities = [opts.agentId, opts.mandateKey, opts.shortcutId].filter((v) => v !== void 0);
+    if (identities.length !== 1) {
+      throw new Error("runHeadlessAgentJson requires exactly one of agentId, mandateKey or shortcutId");
+    }
     if (opts.mandateKey !== void 0) {
-      if (opts.agentId !== void 0) {
-        throw new Error("runHeadlessAgentJson accepts agentId or mandateKey, never both");
-      }
       executionIdentity = { mandateKey: opts.mandateKey };
+    } else if (opts.shortcutId !== void 0) {
+      executionIdentity = { shortcutId: opts.shortcutId };
     } else {
-      if (opts.agentId === void 0) {
-        throw new Error("runHeadlessAgentJson requires agentId or mandateKey");
-      }
       executionIdentity = { agentId: opts.agentId };
     }
     screamIfDeclaredFlattening(
       opts,
-      opts.agentId ?? opts.mandateKey ?? "unknown"
+      opts.agentId ?? opts.mandateKey ?? opts.shortcutId ?? "unknown"
     );
     const launch = await dispatch(
       launchAgentExecution({
@@ -282,7 +282,8 @@ async function launchAndWait(dispatch, getState, opts) {
         runtime: {
           ...opts.surfaceName !== void 0 ? { surfaceName: opts.surfaceName } : {},
           ...opts.variables ? { variables: opts.variables } : {},
-          ...opts.userInput !== void 0 ? { userInput: opts.userInput } : {}
+          ...opts.userInput !== void 0 ? { userInput: opts.userInput } : {},
+          ...opts.applicationScope ? { applicationScope: opts.applicationScope } : {}
         },
         // `callerExecutes` is the deliberate half of `autoRun: !twoStep`. A
         // headless launch normally IGNORES autoRun (no interface = nothing to
@@ -335,7 +336,7 @@ async function launchAndWait(dispatch, getState, opts) {
       pollMs,
       settleMs,
       surfaceKey: opts.surfaceKey,
-      agentRef: opts.agentId ?? opts.mandateKey ?? "unknown",
+      agentRef: opts.agentId ?? opts.mandateKey ?? opts.shortcutId ?? "unknown",
       msgs,
       expect: opts.expect ?? "json",
       ...opts.signal ? { signal: opts.signal } : {},
@@ -351,7 +352,7 @@ async function launchAndWait(dispatch, getState, opts) {
       conversationId: conversationId ?? void 0,
       raw: {
         surfaceKey: opts.surfaceKey,
-        agent: opts.agentId ?? opts.mandateKey ?? "unknown",
+        agent: opts.agentId ?? opts.mandateKey ?? opts.shortcutId ?? "unknown",
         detail,
         // Only when nothing readable came out: the raw shape, so a throw this
         // helper cannot read is a bug report rather than a shrug.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "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; plus the kernel compatibility entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) until P28.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -201,24 +201,24 @@
     "server-only": "^0.0.1",
     "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/associations": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
-    "@ai-matrx/data": "latest",
+    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
+    "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
-    "@ai-matrx/diff": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/kit": "latest",
-    "@ai-matrx/design-system": "latest",
-    "@ai-matrx/tap-target": "latest"
+    "@ai-matrx/tap-target": "latest",
+    "@ai-matrx/agents": "latest",
+    "@ai-matrx/data": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",