@rubytech/create-maxy-code 0.1.40 → 0.1.43

package/payload/platform/services/claude-session-manager/dist/session-store.d.ts

@@ -1,63 +1,38 @@
 import type { PtyHandle, Role, Channel } from './types.js';
 export interface StoredSession {
-    /** URL bridge suffix captured from the /remote-control URL. Stable for
-     *  the row's entire alive lifetime — never null, never replaced. Surfaced
-     *  as the row's `sessionId` on every wire response so the UI mounts its
-     *  pane against this identifier from t=0 (URL capture). */
+    /** Intrinsic Claude session id (UUID). Stable for the row's lifetime. */
+    sessionId: string;
+    /** "session_<suffix>" form from the PID file. Stable, never null after
+     *  /spawn returns (the spawn promise resolves on PID-file event). */
+    bridgeSessionId: string;
+    /** Suffix-only convenience field (no "session_" prefix). */
     bridgeSuffix: string;
-    /** Intrinsic claude session id — the JSONL basename Claude Code wrote.
-     *  Null between URL capture and the first turn the operator types (claude
-     *  defers JSONL write to the first turn). Filled when the jsonl-observer
-     *  fires; thereafter equals the intrinsic id forever. */
-    claudeSessionId: string | null;
     pid: number;
-    url: string;
+    /** URL from the `/remote-control` banner. Null until url-capture fires;
+     *  may stay null forever if the banner never lands. The UI tolerates
+     *  null. */
+    url: string | null;
     startedAt: string;
     senderId: string;
     role: Role;
     channel: Channel;
-    /** Path of the JSONL Claude Code wrote, observed from disk by the
-     *  jsonl-observer. Null until promotion fires (mirrors claudeSessionId). */
+    /** Set on the JSONL CREATE event the http-server subscribes to. Null
+     *  until the operator types the first turn. */
     jsonlPath: string | null;
     pty: PtyHandle;
     exited: boolean;
-    /** Background spawns (per-turn database-operator recorder, future
-     *  out-of-band specialists) set `hidden: true` at /spawn time. /list
-     *  filters them out by default so they never appear in the sidebar,
-     *  the operator URL, or the artefact pane; /list?includeHidden=1
-     *  surfaces them for diagnostics. Defaults to false. */
     hidden: boolean;
-    /** Specialist agent name passed as `--agent <name>` to claude when the
-     *  spawn should land inside a specific specialist (database-operator,
-     *  etc.). Null on user-facing spawns. */
     specialist: string | null;
 }
 export declare class SessionStore {
-    /** Keyed by the row's stable surface id (bridge suffix). Lookup-by-bridge
-     *  is the alive-row contract. */
-    private readonly byBridge;
-    /** Filled at promotion time so /list, /meta, /log routes resolve the
-     *  intrinsic id to the same StoredSession the bridge id resolves to. */
-    private readonly byClaude;
-    /** Register a freshly-spawned session (claudeSessionId null, jsonlPath
-     *  null). The row becomes visible to /list immediately. */
-    addPending(s: StoredSession): void;
-    /** Resolve by either the bridge suffix or the intrinsic claudeSessionId.
-     *  Returns the same StoredSession in either case once promotion has
-     *  fired. */
-    get(id: string): StoredSession | undefined;
-    /** Remove by either id. Drops both index entries. */
-    remove(id: string): StoredSession | undefined;
+    private readonly bySessionId;
+    add(s: StoredSession): void;
+    get(sessionId: string): StoredSession | undefined;
+    remove(sessionId: string): StoredSession | undefined;
     listBySender(senderId: string, opts?: {
         includeHidden?: boolean;
     }): StoredSession[];
     all(): StoredSession[];
     size(): number;
-    /** Bind a pending row to its newly-observed `claudeSessionId` + JSONL
-     *  path. Idempotent: a second call on an already-promoted row updates
-     *  nothing. Returns the StoredSession on success, null when no row
-     *  exists for the bridge suffix (operator already deleted it, or the
-     *  PTY exited before observation fired). */
-    promote(bridgeSuffix: string, claudeSessionId: string, jsonlPath: string): StoredSession | null;
 }
 //# sourceMappingURL=session-store.d.ts.map

package/payload/platform/services/claude-session-manager/dist/session-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,WAAW,aAAa;IAC5B;;;+DAG2D;IAC3D,YAAY,EAAE,MAAM,CAAA;IACpB;;;6DAGyD;IACzD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB;gFAC4E;IAC5E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,GAAG,EAAE,SAAS,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf;;;;4DAIwD;IACxD,MAAM,EAAE,OAAO,CAAA;IACf;;6CAEyC;IACzC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,qBAAa,YAAY;IACvB;qCACiC;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D;4EACwE;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAE5D;+DAC2D;IAC3D,UAAU,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;IAIlC;;iBAEa;IACb,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,qDAAqD;IACrD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAQ7C,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,aAAa,EAAE;IAWvF,GAAG,IAAI,aAAa,EAAE;IAItB,IAAI,IAAI,MAAM;IAId;;;;gDAI4C;IAC5C,OAAO,CACL,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,IAAI;CASxB"}
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;IACjB;yEACqE;IACrE,eAAe,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX;;gBAEY;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB;mDAC+C;IAC/C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,GAAG,EAAE,SAAS,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;IAE/D,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;IAI3B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAOpD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,aAAa,EAAE;IAWvF,GAAG,IAAI,aAAa,EAAE;IAItB,IAAI,IAAI,MAAM;CAGf"}

package/payload/platform/services/claude-session-manager/dist/session-store.js

@@ -1,64 +1,41 @@
-// In-memory session store. One identifier per Claude process, but the
-// spawn-time window between PTY creation and Claude Code writing its first
-// JSONL line is now unbounded: claude does not write the JSONL until the
-// operator types the first turn (verified Pi 2.1.143 and Mac 2.1.128).
+// In-memory PTY-handle store. The canonical row index now lives in the
+// fs-watcher (sessions/<pid>.json + projects/<slug>/<sid>.jsonl). This
+// store only tracks the live PTY handles the manager itself spawned —
+// the watcher cannot expose those (they aren't on disk). Lookups by
+// alternative identifiers (bridgeSuffix, pid, bridgeSessionId) go through
+// the watcher first to resolve to the canonical sessionId; the store is
+// then keyed solely on sessionId.
 //
-// Lifecycle spans the full PTY lifetime:
-//
-//   pending   — created when /spawn captures the /remote-control URL.
-//               The row is keyed by the URL `bridgeSuffix` (the substring
-//               after `session_` in the URL). `claudeSessionId` is null;
-//               `jsonlPath` is null. The /spawn response returns at this
-//               point, so the operator sees a usable row inside ~2 s even
-//               when they never type.
-//
-//   promoted  — fires later (seconds or minutes, gated on operator typing)
-//               when `jsonl-observer` matches a JSONL on disk whose head
-//               bytes carry the bridge suffix. `claudeSessionId` is filled
-//               with the intrinsic JSONL basename, `jsonlPath` is set, and
-//               the same StoredSession is also registered under the
-//               intrinsic id so GET routes resolve either id to the same
-//               row.
-//
-//   ended     — operator deletes the row, the PTY exits, or the manager
-//               restarts. Promoted rows stay enumerable from disk via the
-//               JSONL transcript. Pending rows that never promoted have no
-//               JSONL and disappear cleanly on delete.
-//
-// The store mints zero ids of its own. The bridge suffix is claude's, the
-// intrinsic id is claude's. The manager only observes them.
+// Lifecycle:
+//   - pty-spawner awaits the PID-file CREATE event from the watcher
+//     before returning a /spawn response. The store row is registered at
+//     that point with sessionId known and bridgeSessionId carried from
+//     the PID file. There is no "pre-promotion" pending state — by the
+//     time /spawn returns, sessionId is final.
+//   - URL capture continues in parallel; the row's `url` field is
+//     mutated in place when the URL banner fires (may arrive before or
+//     after the PID-file event; both orderings are safe).
+//   - JSONL appears on first operator turn; the watcher fills the row's
+//     jsonlPath via direct mutation from the http-server's subscriber.
 export class SessionStore {
-    /** Keyed by the row's stable surface id (bridge suffix). Lookup-by-bridge
-     *  is the alive-row contract. */
-    byBridge = new Map();
-    /** Filled at promotion time so /list, /meta, /log routes resolve the
-     *  intrinsic id to the same StoredSession the bridge id resolves to. */
-    byClaude = new Map();
-    /** Register a freshly-spawned session (claudeSessionId null, jsonlPath
-     *  null). The row becomes visible to /list immediately. */
-    addPending(s) {
-        this.byBridge.set(s.bridgeSuffix, s);
+    bySessionId = new Map();
+    add(s) {
+        this.bySessionId.set(s.sessionId, s);
     }
-    /** Resolve by either the bridge suffix or the intrinsic claudeSessionId.
-     *  Returns the same StoredSession in either case once promotion has
-     *  fired. */
-    get(id) {
-        return this.byBridge.get(id) ?? this.byClaude.get(id);
+    get(sessionId) {
+        return this.bySessionId.get(sessionId);
     }
-    /** Remove by either id. Drops both index entries. */
-    remove(id) {
-        const s = this.get(id);
+    remove(sessionId) {
+        const s = this.bySessionId.get(sessionId);
         if (!s)
             return undefined;
-        this.byBridge.delete(s.bridgeSuffix);
-        if (s.claudeSessionId !== null)
-            this.byClaude.delete(s.claudeSessionId);
+        this.bySessionId.delete(sessionId);
         return s;
     }
     listBySender(senderId, opts = {}) {
         const includeHidden = opts.includeHidden === true;
         const out = [];
-        for (const s of this.byBridge.values()) {
+        for (const s of this.bySessionId.values()) {
             if (s.senderId !== senderId)
                 continue;
             if (!includeHidden && s.hidden)
@@ -68,26 +45,10 @@ export class SessionStore {
         return out;
     }
     all() {
-        return [...this.byBridge.values()];
+        return [...this.bySessionId.values()];
     }
     size() {
-        return this.byBridge.size;
-    }
-    /** Bind a pending row to its newly-observed `claudeSessionId` + JSONL
-     *  path. Idempotent: a second call on an already-promoted row updates
-     *  nothing. Returns the StoredSession on success, null when no row
-     *  exists for the bridge suffix (operator already deleted it, or the
-     *  PTY exited before observation fired). */
-    promote(bridgeSuffix, claudeSessionId, jsonlPath) {
-        const s = this.byBridge.get(bridgeSuffix);
-        if (!s)
-            return null;
-        if (s.claudeSessionId !== null)
-            return s;
-        s.claudeSessionId = claudeSessionId;
-        s.jsonlPath = jsonlPath;
-        this.byClaude.set(claudeSessionId, s);
-        return s;
+        return this.bySessionId.size;
     }
 }
 //# sourceMappingURL=session-store.js.map

package/payload/platform/services/claude-session-manager/dist/session-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,2EAA2E;AAC3E,yEAAyE;AACzE,uEAAuE;AACvE,EAAE;AACF,yCAAyC;AACzC,EAAE;AACF,sEAAsE;AACtE,0EAA0E;AAC1E,yEAAyE;AACzE,yEAAyE;AACzE,0EAA0E;AAC1E,sCAAsC;AACtC,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,oEAAoE;AACpE,yEAAyE;AACzE,qBAAqB;AACrB,EAAE;AACF,wEAAwE;AACxE,0EAA0E;AAC1E,2EAA2E;AAC3E,uDAAuD;AACvD,EAAE;AACF,0EAA0E;AAC1E,4DAA4D;AAsC5D,MAAM,OAAO,YAAY;IACvB;qCACiC;IAChB,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAA;IAC5D;4EACwE;IACvD,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAA;IAE5D;+DAC2D;IAC3D,UAAU,CAAC,CAAgB;QACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA;IACtC,CAAC;IAED;;iBAEa;IACb,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,qDAAqD;IACrD,MAAM,CAAC,EAAU;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACtB,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAA;QACxB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;QACpC,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI;YAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAA;QACvE,OAAO,CAAC,CAAA;IACV,CAAC;IAED,YAAY,CAAC,QAAgB,EAAE,OAAoC,EAAE;QACnE,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,KAAK,IAAI,CAAA;QACjD,MAAM,GAAG,GAAoB,EAAE,CAAA;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;gBAAE,SAAQ;YACrC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,MAAM;gBAAE,SAAQ;YACxC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACb,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IACpC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAA;IAC3B,CAAC;IAED;;;;gDAI4C;IAC5C,OAAO,CACL,YAAoB,EACpB,eAAuB,EACvB,SAAiB;QAEjB,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QACzC,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAA;QACnB,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI;YAAE,OAAO,CAAC,CAAA;QACxC,CAAC,CAAC,eAAe,GAAG,eAAe,CAAA;QACnC,CAAC,CAAC,SAAS,GAAG,SAAS,CAAA;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAA;QACrC,OAAO,CAAC,CAAA;IACV,CAAC;CACF"}
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,uEAAuE;AACvE,sEAAsE;AACtE,oEAAoE;AACpE,0EAA0E;AAC1E,wEAAwE;AACxE,kCAAkC;AAClC,EAAE;AACF,aAAa;AACb,oEAAoE;AACpE,yEAAyE;AACzE,uEAAuE;AACvE,uEAAuE;AACvE,+CAA+C;AAC/C,kEAAkE;AAClE,uEAAuE;AACvE,0DAA0D;AAC1D,wEAAwE;AACxE,uEAAuE;AA8BvE,MAAM,OAAO,YAAY;IACN,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAA;IAE/D,GAAG,CAAC,CAAgB;QAClB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IACtC,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACxC,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACzC,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAA;QACxB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAClC,OAAO,CAAC,CAAA;IACV,CAAC;IAED,YAAY,CAAC,QAAgB,EAAE,OAAoC,EAAE;QACnE,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,KAAK,IAAI,CAAA;QACjD,MAAM,GAAG,GAAoB,EAAE,CAAA;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;gBAAE,SAAQ;YACrC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,MAAM;gBAAE,SAAQ;YACxC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACb,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IACvC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAC9B,CAAC;CACF"}

package/payload/premium-plugins/real-agent/lib/mcp-stderr-tee/dist/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * MCP server stderr tee — dual-destination log capture.
+ *
+ * Claude Code spawns MCP servers as child processes and consumes their stderr
+ * internally. The platform cannot intercept at the spawn level. Each server
+ * must tee its own stderr so diagnostic output is retrievable.
+ *
+ * ┌─────────────────────────┐
+ * │ MCP server process      │
+ * │                         │
+ * │ console.error("[x] ..") │
+ * │           │             │
+ * │           ▼             │
+ * │ patched stderr.write()  │
+ * │     │                   │
+ * │     ├──► original stderr (consumed by Claude Code — opaque)
+ * │     │
+ * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks, per-plugin)
+ * │     │
+ * │     └──► $STREAM_LOG_PATH                      (per-line, prefixed)
+ * │           "[<iso>] [mcp:{name}] <line>"
+ * └─────────────────────────┘
+ *
+ * $STREAM_LOG_PATH is set by the spawner (`getMcpServers` in `claude-agent.ts`)
+ * to the per-conversation stream log file. The MCP server code itself knows
+ * nothing about conversations — it just trusts the spawner's path. This is
+ * the scope boundary introduced: the tee is attached per spawn,
+ * not per MCP-server process lifetime. Servers spawned for conversation A
+ * write to conversation A's file; servers for B write to B's file.
+ *
+ * Every decision is logged via `[mcp-tee-*]` markers on both the target file
+ * and the original stderr so an investigator can confirm from the stream log
+ * which tees were wired up, which were skipped, and why.
+ */
+/**
+ * Patch process.stderr.write to tee to:
+ *   1. Per-server raw log (`mcp-<serverName>-stderr-<date>.log` under LOG_DIR).
+ *   2. The per-conversation stream log at `STREAM_LOG_PATH` — per-line, prefixed.
+ *   3. The original stderr (consumed by Claude Code) — always preserved.
+ *
+ * LOG_DIR absent → skip per-server raw file (dev mode / tool discovery).
+ * STREAM_LOG_PATH absent → skip stream-log destination (older spawner or
+ *   standalone invocation). In both absent cases, stderr works unchanged —
+ *   a `[mcp-tee-skip]` marker is written to original stderr so the skip is
+ *   visible to journalctl-level readers.
+ *
+ * Safe to call once at MCP server module load. Refused on second call to
+ * prevent stacking patches.
+ */
+export declare function initStderrTee(serverName: string): void;
+//# sourceMappingURL=index.d.ts.map

package/payload/premium-plugins/real-agent/lib/mcp-stderr-tee/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAeH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CA8ItD"}

package/payload/premium-plugins/real-agent/lib/mcp-stderr-tee/dist/index.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * MCP server stderr tee — dual-destination log capture.
+ *
+ * Claude Code spawns MCP servers as child processes and consumes their stderr
+ * internally. The platform cannot intercept at the spawn level. Each server
+ * must tee its own stderr so diagnostic output is retrievable.
+ *
+ * ┌─────────────────────────┐
+ * │ MCP server process      │
+ * │                         │
+ * │ console.error("[x] ..") │
+ * │           │             │
+ * │           ▼             │
+ * │ patched stderr.write()  │
+ * │     │                   │
+ * │     ├──► original stderr (consumed by Claude Code — opaque)
+ * │     │
+ * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks, per-plugin)
+ * │     │
+ * │     └──► $STREAM_LOG_PATH                      (per-line, prefixed)
+ * │           "[<iso>] [mcp:{name}] <line>"
+ * └─────────────────────────┘
+ *
+ * $STREAM_LOG_PATH is set by the spawner (`getMcpServers` in `claude-agent.ts`)
+ * to the per-conversation stream log file. The MCP server code itself knows
+ * nothing about conversations — it just trusts the spawner's path. This is
+ * the scope boundary introduced: the tee is attached per spawn,
+ * not per MCP-server process lifetime. Servers spawned for conversation A
+ * write to conversation A's file; servers for B write to B's file.
+ *
+ * Every decision is logged via `[mcp-tee-*]` markers on both the target file
+ * and the original stderr so an investigator can confirm from the stream log
+ * which tees were wired up, which were skipped, and why.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initStderrTee = initStderrTee;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_string_decoder_1 = require("node:string_decoder");
+// Marker on process.stderr.write so repeat calls to initStderrTee() are
+// detected at runtime, not just warned about in the docstring. A second
+// call would stack patches and double-log every chunk.
+const INIT_MARKER = Symbol.for("maxy.mcpStderrTee.installed");
+/**
+ * Patch process.stderr.write to tee to:
+ *   1. Per-server raw log (`mcp-<serverName>-stderr-<date>.log` under LOG_DIR).
+ *   2. The per-conversation stream log at `STREAM_LOG_PATH` — per-line, prefixed.
+ *   3. The original stderr (consumed by Claude Code) — always preserved.
+ *
+ * LOG_DIR absent → skip per-server raw file (dev mode / tool discovery).
+ * STREAM_LOG_PATH absent → skip stream-log destination (older spawner or
+ *   standalone invocation). In both absent cases, stderr works unchanged —
+ *   a `[mcp-tee-skip]` marker is written to original stderr so the skip is
+ *   visible to journalctl-level readers.
+ *
+ * Safe to call once at MCP server module load. Refused on second call to
+ * prevent stacking patches.
+ */
+function initStderrTee(serverName) {
+    const logDir = process.env.LOG_DIR;
+    const streamLogPath = process.env.STREAM_LOG_PATH;
+    // Refuse repeat patches — stacking them would double-log every chunk
+    // and corrupt the re-entrancy guard (originalWrite would capture the
+    // already-patched function on the second call).
+    if (process.stderr.write[INIT_MARKER])
+        return;
+    // Keep a direct reference to the unpatched writer. All diagnostic output
+    // from inside this module MUST go through originalWrite to avoid
+    // re-entering the patched writer (which would recurse on a tee failure).
+    const originalWrite = process.stderr.write.bind(process.stderr);
+    const tsPrefix = () => `[${new Date().toISOString()}]`;
+    const skipTee = (reason, destination) => {
+        originalWrite(`${tsPrefix()} [platform] [mcp-tee-skip] server=${serverName} destination=${destination} reason=${JSON.stringify(reason)}\n`);
+    };
+    // --- Destination 1: per-server raw file (optional, existing behaviour)
+    let perServerStream;
+    if (logDir) {
+        try {
+            (0, node_fs_1.mkdirSync)(logDir, { recursive: true });
+            const date = new Date().toISOString().slice(0, 10);
+            perServerStream = (0, node_fs_1.createWriteStream)((0, node_path_1.resolve)(logDir, `mcp-${serverName}-stderr-${date}.log`), { flags: "a" });
+            perServerStream.on("error", (err) => {
+                originalWrite(`${tsPrefix()} [platform] [mcp-tee-error] server=${serverName} destination=per-server reason=${JSON.stringify(err.message)}\n`);
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            skipTee(msg, "per-server");
+            perServerStream = undefined;
+        }
+    }
+    else {
+        skipTee("LOG_DIR not set", "per-server");
+    }
+    // --- Destination 2: per-conversation stream log
+    let streamLogStream;
+    if (streamLogPath) {
+        try {
+            (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(streamLogPath), { recursive: true });
+            const s = (0, node_fs_1.createWriteStream)(streamLogPath, { flags: "a" });
+            s.on("error", (err) => {
+                originalWrite(`${tsPrefix()} [platform] [mcp-tee-error] server=${serverName} destination=stream-log reason=${JSON.stringify(err.message)}\n`);
+            });
+            streamLogStream = s;
+            // Attach marker lands in the stream log itself so investigators can
+            // confirm per-conversation the tee was wired up.
+            s.write(`${tsPrefix()} [platform] [mcp-tee-attach] server=${serverName} streamLogPath=${streamLogPath}\n`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            skipTee(msg, "stream-log");
+            streamLogStream = undefined;
+        }
+    }
+    else {
+        skipTee("STREAM_LOG_PATH not set", "stream-log");
+    }
+    // If neither tee target is available, leave stderr untouched — patching
+    // the writer to a no-op tee would still consume event-loop cycles on
+    // every write for zero observability gain.
+    if (!perServerStream && !streamLogStream) {
+        return;
+    }
+    // Line buffer — accumulates characters written to stderr so complete
+    // newline-terminated lines can be prefixed and emitted to the stream log.
+    // Partial chunks are held until a newline arrives (or beforeExit flushes).
+    let lineBuffer = "";
+    // StringDecoder buffers trailing UTF-8 continuation bytes across chunks.
+    // Without it, a multi-byte codepoint that straddles a write boundary would
+    // render as two U+FFFD replacement characters in the stream log. Only
+    // matters when a caller writes Uint8Array chunks directly — console.error
+    // produces strings — but plugins piping child-process stderr can hit this.
+    const utf8 = new node_string_decoder_1.StringDecoder("utf8");
+    const emitCompleteLinesToStreamLog = (chunk) => {
+        if (!streamLogStream)
+            return;
+        lineBuffer += chunk;
+        let newlineIndex;
+        // eslint-disable-next-line no-cond-assign
+        while ((newlineIndex = lineBuffer.indexOf("\n")) !== -1) {
+            const line = lineBuffer.slice(0, newlineIndex);
+            lineBuffer = lineBuffer.slice(newlineIndex + 1);
+            if (line.length === 0)
+                continue; // skip blank lines
+            if (streamLogStream.destroyed || streamLogStream.writableEnded)
+                continue;
+            streamLogStream.write(`${tsPrefix()} [mcp:${serverName}] ${line}\n`);
+        }
+    };
+    process.stderr.write = (chunk, ...args) => {
+        // 1. Per-server raw file — behaviour (no prefix).
+        if (perServerStream && !perServerStream.destroyed) {
+            perServerStream.write(chunk);
+        }
+        // 2. Stream log — per-line, prefixed.
+        if (streamLogStream) {
+            try {
+                const text = typeof chunk === "string"
+                    ? chunk
+                    : utf8.write(Buffer.from(chunk));
+                emitCompleteLinesToStreamLog(text);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                originalWrite(`${tsPrefix()} [platform] [mcp-tee-emit-error] server=${serverName} reason=${JSON.stringify(msg)}\n`);
+            }
+        }
+        // 3. Original stderr — Claude Code still gets what it's always got.
+        return originalWrite(chunk, ...args);
+    };
+    // Mark the patch so a second initStderrTee() call is refused at the top.
+    process.stderr.write[INIT_MARKER] = true;
+    // Flush any trailing unterminated segment on graceful event-loop drain.
+    // `beforeExit` can fire repeatedly: each async write to `streamLogStream`
+    // schedules I/O that keeps the event loop alive, which drains, which fires
+    // `beforeExit` again. With N MCP servers attached, the handler can emit
+    // thousands of detach lines per second. The `detached` flag gates the
+    // drain+detach emission to a single invocation; subsequent firings are
+    // no-ops. Buffer flushing also runs only once — partial-line state at true
+    // process exit doesn't change across re-fires.
+    let detached = false;
+    process.on("beforeExit", () => {
+        if (detached)
+            return;
+        detached = true;
+        if (streamLogStream && !streamLogStream.destroyed && !streamLogStream.writableEnded) {
+            if (lineBuffer.length > 0) {
+                streamLogStream.write(`${tsPrefix()} [mcp:${serverName}] ${lineBuffer}\n`);
+            }
+            streamLogStream.write(`${tsPrefix()} [platform] [mcp-tee-detach] server=${serverName} reason=process-before-exit\n`);
+        }
+        lineBuffer = "";
+    });
+}
+//# sourceMappingURL=index.js.map

package/payload/premium-plugins/real-agent/lib/mcp-stderr-tee/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/payload/premium-plugins/real-agent/lib/mcp-stderr-tee/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@maxy/mcp-stderr-tee",
+  "version": "0.1.0",
+  "private": true,
+  "type": "commonjs",
+  "main": "dist/index.js"
+}