@shumkov/orchestra 0.4.1 → 0.4.2

package/lib/process/factory.js

@@ -105,6 +105,15 @@ function _maybeWarnR12Migration({ rawPm, canonical, chatId, threadId, chatCfg, t
  * @param {string} [opts.channelsClaudeBin] — absolute path to pinned claude binary;
  *   required when ANY chat routes to 'cli'. (Name kept for back-compat with
  *   existing wiring; can be renamed to `claudeBin` in a future refactor.)
+ * @param {string|Function} [opts.displayHint] — surface-rendering hint prepended to
+ *   the CliProcess system prompt. Accepts EITHER a static string (applied to every
+ *   session) OR a resolver `(chatId, threadId, config) => string` invoked once per
+ *   spawn, just before the CliProcess is constructed. The resolver receives the
+ *   spawning chat/topic and the factory's config so the consumer can implement its
+ *   own per-chat/topic precedence (e.g. a per-chat rich-text toggle) without the
+ *   engine knowing anything about the consumer's config shape. The resolved string
+ *   is what reaches CliProcess. Only the 'cli' backend uses this; the 'sdk' backend
+ *   gets its per-chat hint via spawnFn instead.
  * @returns {Function} processFactory(sessionKey, ctx) → Process
  */
 function createProcessFactory({
@@ -153,13 +162,20 @@ function createProcessFactory({
           `falling back to SdkProcess. Pass these to createProcessFactory.`,
         );
       } else {
+        // displayHint may be a static string (same hint for every session) or a
+        // resolver called per spawn with the current chat/topic and config, so the
+        // consumer can vary the hint per chat (e.g. a per-chat rich-text toggle).
+        // The string form is passed through unchanged.
+        const resolvedDisplayHint = typeof displayHint === 'function'
+          ? displayHint(chatId, threadId, config)
+          : displayHint;
         return new CliProcess({
           sessionKey, chatId, threadId, label,
           tmuxRunner,
           botName,
           claudeBin: channelsClaudeBin,
           toolDispatcher,
-          displayHint,
+          displayHint: resolvedDisplayHint,
           maxOutboundFileBytes,
           sessionPrefix, bridgeServerName, appDataDir, attachmentBase, productName, surfaceName,
           logger,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shumkov/orchestra",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Drive interactive Claude Code CLI sessions: spawn, inject messages via the MCP channels bridge, observe turns, recover. The transport-agnostic session engine extracted from polygram, shared by polygram (Telegram) and water (WhatsApp).",
   "type": "commonjs",
   "main": "index.js",