@rubytech/create-maxy-code 0.1.290 → 0.1.291

package/payload/platform/services/claude-session-manager/dist/webchat-channel-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webchat-channel-mcp.js","sourceRoot":"","sources":["../src/webchat-channel-mcp.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,yEAAyE;AACzE,+EAA+E;AAC/E,eAAe;AACf,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAEhF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAA;AAkB5D,MAAM,UAAU,6BAA6B,CAC3C,CAA0B;IAE1B,OAAO;QACL,CAAC,2BAA2B,CAAC,EAAE;YAC7B,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;YACpB,GAAG,EAAE;gBACH,mBAAmB,EAAE,CAAC,CAAC,GAAG;gBAC1B,2BAA2B,EAAE,CAAC,CAAC,UAAU;gBACzC,0BAA0B,EAAE,CAAC,CAAC,SAAS;aACxC;SACF;KACF,CAAA;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,6BAA6B;IAC3C,OAAO,CAAC,yCAAyC,EAAE,UAAU,2BAA2B,EAAE,CAAC,CAAA;AAC7F,CAAC;AAED;;;kCAGkC;AAClC,MAAM,UAAU,2BAA2B,CAAC,SAAiB,EAAE,GAAW;IACxE,OAAO,IAAI,CAAC,GAAG,EAAE,wBAAwB,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;AAC5F,CAAC;AAED;4EAC4E;AAC5E,MAAM,UAAU,uBAAuB,CAAC,aAAqB;IAC3D,OAAO,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,6BAA6B,EAAE,CAAC,CAAA;AAC5E,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { Logger } from './types.js';
+/** The three launch fields the channel argv is rebuilt from. */
+export interface WebchatChannelBinding {
+    key: string;
+    gatewayUrl: string;
+    serverPath: string;
+}
+export interface WebchatChannelEntry extends WebchatChannelBinding {
+    boundAt: string;
+}
+export declare class WebchatChannelStore {
+    private readonly bySessionId;
+    private readonly filePath;
+    private readonly logger;
+    constructor(filePath: string, logger: Logger);
+    /** Read the persisted file into the in-memory map. Boot-resilient: any
+     *  failure (missing file, malformed JSON, permission denied) is logged and
+     *  the store starts empty. Never throws. */
+    loadFromDisk(): void;
+    get(sessionId: string): WebchatChannelEntry | undefined;
+    /** Write-through `binding` for `sessionId`; refreshes boundAt each call. */
+    set(sessionId: string, binding: WebchatChannelBinding): WebchatChannelEntry;
+    /** Remove the entry for `sessionId` if present. Returns true when removed. */
+    remove(sessionId: string): boolean;
+    /** Current in-memory snapshot — diagnostic only. */
+    size(): number;
+    private persistAtomic;
+}
+//# sourceMappingURL=webchat-channel-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webchat-channel-store.d.ts","sourceRoot":"","sources":["../src/webchat-channel-store.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,OAAO,EAAE,MAAM,CAAA;CAChB;AAYD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK5C;;gDAE4C;IAC5C,YAAY,IAAI,IAAI;IA0CpB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIvD,4EAA4E;IAC5E,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,mBAAmB;IAO3E,8EAA8E;IAC9E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMlC,oDAAoD;IACpD,IAAI,IAAI,MAAM;IAId,OAAO,CAAC,aAAa;CAatB"}

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

@@ -0,0 +1,121 @@
+// Persistent per-session webchat native-channel binding. Mirror of
+// wa-channel-store.ts with the webchat identity (key instead of senderId).
+// One webchat session resumes through the manager's `/rc-spawn`, but only the
+// gateway path carries `webchatChannel`. Persisting the binding here lets
+// every resume path re-apply the channel argv so
+// `mcp__webchat-channel__reply` is present on every live PTY for the session.
+//
+// Lifecycle:
+//   - Boot reads `<accountDir>/webchat-channel-bindings.json` into the Map.
+//   - `set(sessionId, binding)` write-throughs and atomically persists; called
+//     on every gateway `/rc-spawn` so gatewayUrl/serverPath stay current.
+//   - `get(sessionId)` reads the in-memory map for the resume read-back.
+//   - `remove(sessionId)` on session purge / delete cascade.
+//   - Corruption / missing file / permission errors at boot are logged and
+//     treated as an empty map; the manager NEVER refuses to start.
+//
+// File format (UTF-8 JSON):
+//   { "<sessionId>": { "key": "...", "gatewayUrl": "...", "serverPath": "...", "boundAt": "ISO-8601" } }
+import { existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+function isValidBinding(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const o = v;
+    return (typeof o.key === 'string' && o.key.length > 0 &&
+        typeof o.gatewayUrl === 'string' && o.gatewayUrl.length > 0 &&
+        typeof o.serverPath === 'string' && o.serverPath.length > 0);
+}
+export class WebchatChannelStore {
+    bySessionId = new Map();
+    filePath;
+    logger;
+    constructor(filePath, logger) {
+        this.filePath = filePath;
+        this.logger = logger;
+    }
+    /** Read the persisted file into the in-memory map. Boot-resilient: any
+     *  failure (missing file, malformed JSON, permission denied) is logged and
+     *  the store starts empty. Never throws. */
+    loadFromDisk() {
+        if (!existsSync(this.filePath)) {
+            this.logger(`[claude-session-manager] webchat-channel-store-load empty reason=file-missing path=${this.filePath}`);
+            return;
+        }
+        let raw;
+        try {
+            raw = readFileSync(this.filePath, 'utf-8');
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            this.logger(`[claude-session-manager] webchat-channel-store-load failed reason=read-error detail=${detail.slice(0, 200)} — starting empty`);
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            this.logger(`[claude-session-manager] webchat-channel-store-load failed reason=malformed-json detail=${detail.slice(0, 200)} — starting empty`);
+            return;
+        }
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            this.logger(`[claude-session-manager] webchat-channel-store-load failed reason=not-an-object — starting empty`);
+            return;
+        }
+        let loaded = 0;
+        for (const [sessionId, value] of Object.entries(parsed)) {
+            if (typeof sessionId !== 'string' || sessionId.length === 0)
+                continue;
+            if (!isValidBinding(value))
+                continue;
+            const rawBoundAt = value.boundAt;
+            const boundAt = typeof rawBoundAt === 'string' && rawBoundAt.length > 0 ? rawBoundAt : new Date(0).toISOString();
+            this.bySessionId.set(sessionId, {
+                key: value.key,
+                gatewayUrl: value.gatewayUrl,
+                serverPath: value.serverPath,
+                boundAt,
+            });
+            loaded += 1;
+        }
+        this.logger(`[claude-session-manager] webchat-channel-store-load ok entries=${loaded} path=${this.filePath}`);
+    }
+    get(sessionId) {
+        return this.bySessionId.get(sessionId);
+    }
+    /** Write-through `binding` for `sessionId`; refreshes boundAt each call. */
+    set(sessionId, binding) {
+        const entry = { ...binding, boundAt: new Date().toISOString() };
+        this.bySessionId.set(sessionId, entry);
+        this.persistAtomic();
+        return entry;
+    }
+    /** Remove the entry for `sessionId` if present. Returns true when removed. */
+    remove(sessionId) {
+        const had = this.bySessionId.delete(sessionId);
+        if (had)
+            this.persistAtomic();
+        return had;
+    }
+    /** Current in-memory snapshot — diagnostic only. */
+    size() {
+        return this.bySessionId.size;
+    }
+    persistAtomic() {
+        const obj = {};
+        for (const [sessionId, entry] of this.bySessionId)
+            obj[sessionId] = entry;
+        const tmp = `${this.filePath}.tmp`;
+        try {
+            writeFileSync(tmp, JSON.stringify(obj, null, 2), 'utf-8');
+            renameSync(tmp, this.filePath);
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            this.logger(`[claude-session-manager] webchat-channel-store-persist failed detail=${detail.slice(0, 200)}`);
+            // No rethrow — reads still serve from the in-memory map until next boot.
+        }
+    }
+}
+//# sourceMappingURL=webchat-channel-store.js.map

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

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

package/payload/platform/services/webchat-channel/dist/notification.d.ts

@@ -0,0 +1,55 @@
+export interface InboundPayload {
+    /** The webchat conversation key this payload is for. */
+    key: string;
+    /** The operator's typed message, verbatim — multi-line content is preserved. */
+    text: string;
+    /** Per-message id, for dedup/observability. */
+    messageId: string;
+}
+/** The composed content the agent receives, plus the inner payload's byte
+ *  length for the observability line. */
+export interface ComposedInbound {
+    content: string;
+    payloadBytes: number;
+}
+/** Deliver the operator's text plain. The admin webchat is an operator
+ *  surface; it does NOT get the Task 753 customer reframe. */
+export declare function composeContent(p: InboundPayload): ComposedInbound;
+/** Defence in depth: this server serves exactly one key. Even though the
+ *  gateway only streams that key's messages, refuse anything else before it
+ *  reaches the session. */
+export declare function acceptsKey(myKey: string, p: {
+    key: string;
+}): boolean;
+/** Build the body for POST /webchat-channel/reply. The reply tool exposes only
+ *  `text` to the model; the key is the server's fixed key (from spawn env),
+ *  never trusted from the model, so a compromised turn cannot redirect a reply
+ *  to a different conversation. */
+export declare function buildReplyPostBody(myKey: string, text: string): {
+    key: string;
+    text: string;
+};
+/** Build the body for POST /webchat-channel/received — the receipt ack the
+ *  channel server sends after it has emitted a drained inbound to the agent,
+ *  so the gateway marks it delivered instead of sweeping it as
+ *  drain-undelivered. The key is the server's fixed key, never model-supplied. */
+export declare function buildReceivedPostBody(myKey: string, messageId: string): {
+    key: string;
+    messageId: string;
+};
+/** Retry an idempotent POST until it is accepted or the attempt cap is
+ *  reached. `attempt` returns whether the POST was accepted; the helper
+ *  returns on the first acceptance, otherwise sleeps `delayMs` and retries,
+ *  up to `attempts` total. `sleep` is injected so tests run without real
+ *  timers. */
+export declare function postWithRetry(attempt: () => Promise<boolean>, opts: {
+    attempts: number;
+    delayMs: number;
+    sleep: (ms: number) => Promise<void>;
+}): Promise<boolean>;
+/** Map a non-OK /webchat-channel/reply response into an actionable MCP error
+ *  string. Falls back to the bare status when the body carries no usable
+ *  reason. (No terminal/logged-out branch — there is no external transport to
+ *  log out of.) */
+export declare function buildReplyError(status: number, body: unknown): string;
+//# sourceMappingURL=notification.d.ts.map

package/payload/platform/services/webchat-channel/dist/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;IACX,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;yCACyC;AACzC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;8DAC8D;AAC9D,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,eAAe,CAEjE;AAED;;2BAE2B;AAC3B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAErE;AAED;;;mCAGmC;AACnC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAE7F;AAED;;;kFAGkF;AAClF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAEpC;AAED;;;;cAIc;AACd,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAChF,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;mBAGmB;AACnB,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAIrE"}

package/payload/platform/services/webchat-channel/dist/notification.js

@@ -0,0 +1,59 @@
+// Pure helpers for the webchat channel server. No MCP SDK import here, so
+// these unit-test without the SDK and keep server.ts's transport wiring
+// separable from its message shaping. Mirrors whatsapp-channel/notification.ts
+// with the deliberate divergences below.
+//
+// Divergence from whatsapp-channel (Task 772): the admin webchat is an
+// OPERATOR surface, so the inbound is delivered PLAIN — no Task 753
+// `## Context / ## Instruction` customer reframe. There is no media weaving
+// (the browser POST carries text only) and no reply-document — the browser
+// reader renders agent replies straight from the session JSONL.
+/** Deliver the operator's text plain. The admin webchat is an operator
+ *  surface; it does NOT get the Task 753 customer reframe. */
+export function composeContent(p) {
+    return { content: p.text, payloadBytes: Buffer.byteLength(p.text, 'utf8') };
+}
+/** Defence in depth: this server serves exactly one key. Even though the
+ *  gateway only streams that key's messages, refuse anything else before it
+ *  reaches the session. */
+export function acceptsKey(myKey, p) {
+    return p.key === myKey;
+}
+/** Build the body for POST /webchat-channel/reply. The reply tool exposes only
+ *  `text` to the model; the key is the server's fixed key (from spawn env),
+ *  never trusted from the model, so a compromised turn cannot redirect a reply
+ *  to a different conversation. */
+export function buildReplyPostBody(myKey, text) {
+    return { key: myKey, text };
+}
+/** Build the body for POST /webchat-channel/received — the receipt ack the
+ *  channel server sends after it has emitted a drained inbound to the agent,
+ *  so the gateway marks it delivered instead of sweeping it as
+ *  drain-undelivered. The key is the server's fixed key, never model-supplied. */
+export function buildReceivedPostBody(myKey, messageId) {
+    return { key: myKey, messageId };
+}
+/** Retry an idempotent POST until it is accepted or the attempt cap is
+ *  reached. `attempt` returns whether the POST was accepted; the helper
+ *  returns on the first acceptance, otherwise sleeps `delayMs` and retries,
+ *  up to `attempts` total. `sleep` is injected so tests run without real
+ *  timers. */
+export async function postWithRetry(attempt, opts) {
+    for (let i = 0; i < opts.attempts; i++) {
+        if (await attempt())
+            return true;
+        if (i < opts.attempts - 1)
+            await opts.sleep(opts.delayMs);
+    }
+    return false;
+}
+/** Map a non-OK /webchat-channel/reply response into an actionable MCP error
+ *  string. Falls back to the bare status when the body carries no usable
+ *  reason. (No terminal/logged-out branch — there is no external transport to
+ *  log out of.) */
+export function buildReplyError(status, body) {
+    const b = body;
+    const reason = typeof b?.error === 'string' && b.error.length > 0 ? b.error : null;
+    return reason ? `reply: ${reason}` : `reply: gateway returned ${status}`;
+}
+//# sourceMappingURL=notification.js.map

package/payload/platform/services/webchat-channel/dist/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wEAAwE;AACxE,+EAA+E;AAC/E,yCAAyC;AACzC,EAAE;AACF,uEAAuE;AACvE,oEAAoE;AACpE,4EAA4E;AAC5E,2EAA2E;AAC3E,gEAAgE;AAkBhE;8DAC8D;AAC9D,MAAM,UAAU,cAAc,CAAC,CAAiB;IAC9C,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAA;AAC7E,CAAC;AAED;;2BAE2B;AAC3B,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,CAAkB;IAC1D,OAAO,CAAC,CAAC,GAAG,KAAK,KAAK,CAAA;AACxB,CAAC;AAED;;;mCAGmC;AACnC,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,IAAY;IAC5D,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AAC7B,CAAC;AAED;;;kFAGkF;AAClF,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,SAAiB;IAEjB,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AAClC,CAAC;AAED;;;;cAIc;AACd,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAA+B,EAC/B,IAAiF;IAEjF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,MAAM,OAAO,EAAE;YAAE,OAAO,IAAI,CAAA;QAChC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;mBAGmB;AACnB,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,IAAa;IAC3D,MAAM,CAAC,GAAG,IAAkC,CAAA;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IAClF,OAAO,MAAM,CAAC,CAAC,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC,CAAC,2BAA2B,MAAM,EAAE,CAAA;AAC1E,CAAC"}

package/payload/platform/services/webchat-channel/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/payload/platform/services/webchat-channel/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/payload/platform/services/webchat-channel/dist/server.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+// Per-conversation webchat channel MCP server. Spawned as a stdio child of one
+// `claude` session (so it dies when that session dies — no bound port, no
+// orphan). It:
+//   - subscribes to the gateway for ITS key's inbound (SSE) and emits each
+//     message as a notifications/claude/channel event;
+//   - exposes a `reply` tool. The reply's text reaches the operator through
+//     the browser reader, which tails the session JSONL and renders the
+//     tool_use — the gateway POST exists only to stamp the op=reply lifeline.
+//
+// Transport glue only — message shaping and the post bodies are the
+// unit-tested pure helpers in ./notification. Mirrors
+// whatsapp-channel/server.ts minus the outbound transport (no Baileys, no
+// reply-document) and minus the Task 753 reframe (operator surface).
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { acceptsKey, composeContent, buildReplyPostBody, buildReceivedPostBody, buildReplyError, postWithRetry, } from './notification.js';
+function requireEnv(name) {
+    const v = process.env[name];
+    if (!v)
+        throw new Error(`webchat-channel: missing required env ${name}`);
+    return v;
+}
+const KEY = requireEnv('WEBCHAT_CHANNEL_KEY');
+const GATEWAY_URL = requireEnv('WEBCHAT_CHANNEL_GATEWAY_URL').replace(/\/$/, '');
+// Receipt-ack retry budget. 5 attempts × 2000ms = up to ~8s of sleeping,
+// comfortably inside the gateway's 30s ack window (ACK_THRESHOLD_MS), so a
+// recovered ack lands before the sweep would emit a false drain-undelivered.
+const RECEIPT_ACK_ATTEMPTS = 5;
+const RECEIPT_ACK_DELAY_MS = 2000;
+// Operator surface: the typed message IS the operator's instruction. The reply
+// tool is the delivery path back to the browser chat (the reader renders the
+// tool call's text), so every turn must end with it.
+const INSTRUCTIONS = `You are connected to the operator's admin webchat. Every ` +
+    `<channel source="webchat"> event is a message the operator has typed to you directly — treat it ` +
+    `EXACTLY as if they typed it in this session, and act on it immediately as their instruction. ` +
+    `Do NOT describe it as an "incoming message", do NOT summarise it, and do NOT ask whether to ` +
+    `reply — the answer is always yes. For every such event: (1) do the work or answer the question, ` +
+    `then (2) call the reply tool with your response so it is delivered to the operator's chat. ` +
+    `Always finish by calling the reply tool; never wait for confirmation before replying.`;
+const mcp = new Server({ name: 'webchat', version: '0.1.0' }, {
+    capabilities: { experimental: { 'claude/channel': {} }, tools: {} },
+    instructions: INSTRUCTIONS,
+});
+mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: 'reply',
+            description: 'Send your reply text to the operator in this admin webchat conversation.',
+            inputSchema: {
+                type: 'object',
+                properties: { text: { type: 'string', description: 'The message to send to the operator' } },
+                required: ['text'],
+            },
+        },
+    ],
+}));
+mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
+    if (req.params.name === 'reply') {
+        const text = req.params.arguments?.text;
+        if (typeof text !== 'string')
+            throw new Error('reply: text must be a string');
+        const res = await fetch(`${GATEWAY_URL}/webchat-channel/reply`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(buildReplyPostBody(KEY, text)),
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => null);
+            throw new Error(buildReplyError(res.status, body));
+        }
+        return { content: [{ type: 'text', text: 'sent' }] };
+    }
+    throw new Error(`unknown tool: ${req.params.name}`);
+});
+// Subscribe to this key's inbound stream and emit each message as an event.
+// Reconnect loop: the channel server must stay alive — and its reply tool
+// available — for the whole claude session. If the SSE link to the gateway
+// drops (gateway restart, idle close, transient blip), reconnect instead of
+// returning. The process still dies with the session because claude SIGTERMs
+// its stdio child.
+async function postReady() {
+    await fetch(`${GATEWAY_URL}/webchat-channel/ready`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ key: KEY }),
+    }).catch(() => { });
+}
+async function subscribeInbound() {
+    const url = `${GATEWAY_URL}/webchat-channel/inbound?key=${encodeURIComponent(KEY)}`;
+    for (;;) {
+        try {
+            const res = await fetch(url, { headers: { accept: 'text/event-stream' } });
+            if (!res.ok || !res.body)
+                throw new Error(`subscribe failed: ${res.status}`);
+            // The SSE link is established. Only NOW announce readiness, so the
+            // gateway drains any cold-start queue ONTO this live subscription rather
+            // than into a stream the channel server is not yet consuming.
+            await postReady();
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+            for (;;) {
+                const { value, done } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const frames = buffer.split('\n\n');
+                buffer = frames.pop() ?? '';
+                for (const frame of frames) {
+                    const dataLine = frame.split('\n').find((l) => l.startsWith('data:'));
+                    if (!dataLine)
+                        continue;
+                    const data = dataLine.slice('data:'.length).trim();
+                    if (!data)
+                        continue; // ping/keepalive
+                    let payload;
+                    try {
+                        payload = JSON.parse(data);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (!acceptsKey(KEY, payload))
+                        continue;
+                    // Operator surface — deliver plain, no reframe (Task 772 divergence
+                    // from the WhatsApp channel's Task 753 composeAdminContent).
+                    const composed = composeContent(payload);
+                    console.error(`[webchat:inbound] op=delivered key=${KEY.slice(0, 8)} role=admin payloadBytes=${composed.payloadBytes}`);
+                    await mcp.notification({
+                        method: 'notifications/claude/channel',
+                        params: { content: composed.content },
+                    });
+                    // Confirm receipt so the gateway marks this message delivered
+                    // instead of timing out as drain-undelivered. Retry within the
+                    // gateway's ack window; log only on final give-up.
+                    const acked = await postWithRetry(async () => {
+                        try {
+                            const r = await fetch(`${GATEWAY_URL}/webchat-channel/received`, {
+                                method: 'POST',
+                                headers: { 'content-type': 'application/json' },
+                                body: JSON.stringify(buildReceivedPostBody(KEY, payload.messageId)),
+                            });
+                            return r.ok;
+                        }
+                        catch {
+                            return false;
+                        }
+                    }, {
+                        attempts: RECEIPT_ACK_ATTEMPTS,
+                        delayMs: RECEIPT_ACK_DELAY_MS,
+                        sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
+                    });
+                    if (!acked) {
+                        console.error(`[webchat:inbound] op=receipt-ack-failed key=${KEY} messageId=${payload.messageId} attempts=${RECEIPT_ACK_ATTEMPTS}`);
+                    }
+                }
+            }
+            console.error('[webchat-channel] inbound stream closed by gateway; reconnecting');
+        }
+        catch (err) {
+            console.error(`[webchat-channel] inbound stream error: ${err instanceof Error ? err.message : String(err)}; reconnecting`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+    }
+}
+async function main() {
+    await mcp.connect(new StdioServerTransport());
+    // Readiness is announced inside subscribeInbound, after the SSE link is up —
+    // never before, or the gateway would drain into a stream this server is not
+    // yet consuming.
+    await subscribeInbound();
+}
+main().catch((err) => {
+    console.error(`[webchat-channel] fatal: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/payload/platform/services/webchat-channel/dist/server.js.map

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

package/payload/platform/services/webchat-channel/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@maxy/webchat-channel",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/server.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "vitest": "^4.1.2"
+  }
+}

package/payload/platform/services/whatsapp-channel/dist/notification.d.ts

@@ -17,24 +17,27 @@ export interface InboundPayload {
     media: MediaInbound[];
 }
 /**
- * Task 753 — the standing select-and-dispatch instruction prepended to every
- * channel turn. The inbound message is demoted to payload and the turn becomes
- * a routing question: pick the owning specialist (dispatch via the Agent tool),
- * else load the owning skill, else answer directly. Freestyle inline authoring
- * is the `direct` floor, reached only when nothing owns the work — which is why
- * a greeting/confirmation needs no separate skip: it falls through to `direct`.
+ * Task 753 — the standing select-and-dispatch instruction. The inbound message
+ * is demoted to payload and the turn becomes a routing question: pick the owning
+ * specialist (dispatch via the Agent tool), else load the owning skill, else
+ * answer directly. Freestyle inline authoring is the `direct` floor, reached only
+ * when nothing owns the work — which is why a greeting/confirmation needs no
+ * separate skip: it falls through to `direct`. The turn is now framed in two
+ * markdown sections (see {@link composeAdminContent}): `## Context` carries the
+ * inbound payload first, then `## Instruction` carries this directive — so the
+ * agent reads the request, then how to act on it.
  *
  * Task 761 — the cadence clause. A long turn (e.g. building a quote across many
  * Write/Bash/Edit steps) was producing one channel message, dispatched only at
  * turn-end, leaving the sender in silence for minutes. The agent's interim
  * narration is surfaced in the dashboard but is never dispatched to the channel;
  * only `reply`-tool calls reach WhatsApp. So the clause directs the agent to use
- * the reply tool for an early acknowledgement and mid-turn progress on slow work,
- * not just for the final result. Outcome, not script.
+ * the reply tool for an early acknowledgement and mid-turn progress, then the
+ * result — not just the final message. Outcome, not script.
  *
  * Exported so the unit tests assert the exact wrapped shape.
  */
-export declare const REFRAME_PREFIX: string;
+export declare const REFRAME_INSTRUCTION: string;
 /** Task 753 — the reframe decision for one inbound: the wrapped `content` the
  *  agent receives, and `payloadBytes`, the byte length of the inner payload
  *  (message + woven media notes, excluding the wrapper) for the observability
@@ -61,12 +64,14 @@ export declare function buildInboundNotification(p: InboundPayload): {
     };
 };
 /**
- * Task 753 — wrap the composed payload in {@link REFRAME_PREFIX} so the agent
- * routes the request instead of authoring it inline. Every channel turn is
- * wrapped — there is no deterministic trivia-skip (operator decision): a
- * greeting is handled by the cascade's `direct` branch, not by a pre-classifier
- * here. Returns the wrapped `content` plus `payloadBytes` (the inner payload's
- * byte length) for the channel server's `[reframe]` observability line.
+ * Task 753 — frame the composed payload as two markdown sections so the agent
+ * routes the request instead of authoring it inline: `## Context` carries the
+ * inbound payload, then `## Instruction` carries {@link REFRAME_INSTRUCTION}.
+ * Every channel turn is framed — there is no deterministic trivia-skip (operator
+ * decision): a greeting is handled by the cascade's `direct` branch, not by a
+ * pre-classifier here. Returns the framed `content` plus `payloadBytes` (the
+ * inner payload's byte length) for the channel server's `[reframe]`
+ * observability line.
  */
 export declare function composeAdminContent(p: InboundPayload): ComposedInbound;
 /**

package/payload/platform/services/whatsapp-channel/dist/notification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAA;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAA;IACnB;;;kFAG8E;IAC9E,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,QAQP,CAAA;AAEpB;;;YAGY;AACZ,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,cAAc;;;;;EAOzD;AA0BD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,cAAc,GAAG,eAAe,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAEvG;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAIzD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAE3C;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAChF,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;gCAIgC;AAChC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAMrE"}
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAA;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAA;IACnB;;;kFAG8E;IAC9E,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,mBAAmB,QAOI,CAAA;AAEpC;;;YAGY;AACZ,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,cAAc;;;;;EAOzD;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,cAAc,GAAG,eAAe,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAEvG;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAIzD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAE3C;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAChF,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;gCAIgC;AAChC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAMrE"}