langflower 0.0.7 → 0.0.9

package/vendor/server/skeleton/skills/langflower-workflow-writer/SKILL.md

@@ -24,6 +24,9 @@ You help the user **author valid Langflower workflow JSON** under
   `write`, `create`, `delete`, `bash` — never `Bash(ls)`-style strings.
 - LLM `rolePreset` values are only: `custom` | `plan` | `coder` | `explorer`.
   Unknown values silently become `custom`.
+- Recompile is opt-in: wire `common-langflower-tools` `tools` → agent
+  `tools`. Do **not** add that pack to every agent unless the user wants
+  `compile_custom_nodes`. Do not invent editor mutation tools on that pack.
 
 ## On-disk shape
 
@@ -49,16 +52,17 @@ Schema: `.langflower/schemas/workflow.schema.json`. Samples:
 
 ## Ports you must get right
 
-| Node type                               | Key ports                                                                                                            |
-| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
-| `common-chat-input`                     | out `message` (no wireable in)                                                                                       |
-| `common-openai-llm` / `common-fake-llm` | in `userPrompt`, `systemPrompt`, `feedback`, `subagentRegistration`, `subagentResult`; out `response`, `subagent`, … |
-| `common-hitl-review-gate`               | in `result`; out `response`, `feedback`                                                                              |
-| `common-merge`                          | in/out **`value`** only (not `step` / `output`)                                                                      |
-| `common-review`                         | in `task`, `result`, `systemPrompt`; out `response`, `feedback`                                                      |
-| `common-sub-agent`                      | out `registration`, `result`; in `task`, `systemPrompt`                                                              |
-| `common-finish`                         | in `value`                                                                                                           |
-| `common-string`                         | in/out `value`                                                                                                       |
+| Node type                               | Key ports                                                                                                                                                                                                              |
+| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `common-chat-input`                     | out `message` (no wireable in)                                                                                                                                                                                         |
+| `common-openai-llm` / `common-fake-llm` | in `userPrompt`, `systemPrompt`, `feedback`, `subagentRegistration`, `subagentResult`; out `response`, `subagent`, …                                                                                                   |
+| `common-hitl-review-gate`               | in `result`; out `response`, `feedback`                                                                                                                                                                                |
+| `common-merge`                          | in/out **`value`** only (not `step` / `output`)                                                                                                                                                                        |
+| `common-review`                         | in `task`, `result`, `systemPrompt`; out `response`, `feedback`                                                                                                                                                        |
+| `common-sub-agent`                      | out `registration`, `result`; in `task`, `systemPrompt`                                                                                                                                                                |
+| `common-finish`                         | in `value`                                                                                                                                                                                                             |
+| `common-string`                         | in/out `value`                                                                                                                                                                                                         |
+| `common-langflower-tools`               | out **`tools`** only — wire into an agent `tools` port to opt in to **`compile_custom_nodes`** (unsafe; starter Helper / Writer already wired). Not ambient. Canvas add/remove node or edge tools are **not** shipped. |
 
 ## Soft↔Hard loops
 

package/vendor/server/skeleton/workflows/starter.json

@@ -4,7 +4,7 @@
 		"name": "Starter",
 		"description": "Chat loop with an onboarding agent (skill langflower-helper) plus a Writer Sub-Agent (workflow-writer + node-writer). After bootstrap — product capabilities, workflows, editor chrome, and custom nodes.",
 		"createdAt": "2026-07-24T00:00:00.000Z",
-		"updatedAt": "2026-08-05T16:18:12.801Z"
+		"updatedAt": "2026-08-15T00:00:00.000Z"
 	},
 	"graph": {
 		"viewport": {
@@ -15,6 +15,19 @@
 			"height": 1005.328125
 		},
 		"nodes": [
+			{
+				"id": "compile",
+				"type": "common-langflower-tools",
+				"params": {},
+				"inputs": {},
+				"ui": {
+					"position": {
+						"x": 40,
+						"y": 40
+					},
+					"label": "Langflower Tools"
+				}
+			},
 			{
 				"id": "chat",
 				"type": "common-chat-input",
@@ -50,7 +63,7 @@
 					}
 				},
 				"inputs": {
-					"systemPrompt": "You are the Langflower onboarding assistant. Use the langflower-helper skill. The user already started Langflower and configured a provider — do not lead with CLI start or provider setup. Help with what Langflower can do, workflows, editor chrome, and custom nodes. Keep answers short and actionable.\n\nWhen the user asks to draft or edit a workflow JSON or a custom node pack, spawn_subagent the Writer specialist (skills langflower-workflow-writer and langflower-node-writer) with a clear task; then summarize the Writer result for the user."
+					"systemPrompt": "You are the Langflower onboarding assistant. Use the langflower-helper skill. The user already started Langflower and configured a provider — do not lead with CLI start or provider setup. Help with what Langflower can do, workflows, editor chrome, and custom nodes. Keep answers short and actionable.\n\nLangflower Tools is wired: after custom-node file changes (yours or Writer's), call compile_custom_nodes (no args). Do not send the user to Custom → Update as the only path. You cannot place a new type on the canvas mid-run; already-placed custom types hot-swap, and already-wired custom tools can be invoked later in this run.\n\nWhen the user asks to draft or edit a workflow JSON or a custom node pack, spawn_subagent the Writer specialist (skills langflower-workflow-writer and langflower-node-writer) with a clear task; then compile if nodes changed, and summarize for the user."
 				},
 				"ui": {
 					"position": {
@@ -88,7 +101,7 @@
 					}
 				},
 				"inputs": {
-					"systemPrompt": "You are Writer. Follow langflower-workflow-writer and/or langflower-node-writer for the task. Prefer editing files under .langflower/workflows/ and .langflower/nodes/. Use only catalog node types and real ports. Return a short summary of files changed and any open risks."
+					"systemPrompt": "You are Writer. Follow langflower-workflow-writer and/or langflower-node-writer for the task. Prefer editing files under .langflower/workflows/ and .langflower/nodes/. Use only catalog node types and real ports. After writing or editing .langflower/nodes/ files, call compile_custom_nodes (no args) and report status / COMPILATION_ERRORS.md — do not only remind the user to click Update. Wire common-langflower-tools into an agent only when they should be allowed to recompile. Return a short summary of files changed and any open risks."
 				},
 				"ui": {
 					"position": {
@@ -113,6 +126,20 @@
 			}
 		],
 		"edges": [
+			{
+				"edgeId": "e-compile-helper",
+				"fromNodeId": "compile",
+				"fromPort": ["tools", 0],
+				"toNodeId": "helper",
+				"toPort": ["tools", 0]
+			},
+			{
+				"edgeId": "e-compile-writer",
+				"fromNodeId": "compile",
+				"fromPort": ["tools", 0],
+				"toNodeId": "writer",
+				"toPort": ["tools", 0]
+			},
 			{
 				"edgeId": "e-chat-helper",
 				"fromNodeId": "chat",

package/vendor/shared/dist/execution/derive-run-settle-outcome.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeRunnerEvent, RuntimeRunnerStatus } from '@langflower/runtime';
+import { type RuntimeRunnerEvent, type RuntimeRunnerStatus } from '@langflower/runtime';
 import type { ExecutionProgressStatus } from '../types/langflower-server.js';
 /** Terminal settle values of {@link ExecutionProgressStatus}. */
 export type TerminalExecutionProgressStatus = Extract<ExecutionProgressStatus, 'completed' | 'failed' | 'completed_with_errors'>;

package/vendor/shared/dist/execution/derive-run-settle-outcome.js

@@ -1,3 +1,4 @@
+import { isPortTelemetry, } from '@langflower/runtime';
 /**
  * Derive coarse execution progress from runner status + the recorded feed.
  *
@@ -12,9 +13,9 @@ export const deriveExecutionProgressStatus = (runnerStatus, events) => {
     if (runnerStatus === 'stopped') {
         return 'stopped';
     }
-    const portEvents = events.filter((event) => event.kind === 'output-emitted' || event.kind === 'input-received');
-    const hasError = portEvents.some((event) => event.state === 'error');
-    const hasValue = portEvents.some((event) => event.state === 'value');
+    const portEvents = events.filter(isPortTelemetry);
+    const hasError = portEvents.some((event) => event[3] === 'error');
+    const hasValue = portEvents.some((event) => event[3] === 'value');
     if (hasError && hasValue) {
         return 'completed_with_errors';
     }

package/vendor/shared/dist/execution/derive-run-settle-outcome.test.js

@@ -1,15 +1,15 @@
 import { describe, expect, it } from 'vitest';
 import { deriveExecutionProgressStatus, formatRunSettleLine, terminalExecutionProgressStatus, } from './derive-run-settle-outcome.js';
-const output = (state) => ({
-    kind: 'output-emitted',
-    runId: 'run-1',
-    nodeId: 'n1',
-    portId: 'out',
-    portIdx: 0,
-    edgeIds: [],
+const output = (state) => [
+    'out',
+    'n1',
+    'out',
     state,
-    value: state === 'error' ? new Error('boom') : 'ok',
-});
+    state === 'error' ? new Error('boom') : 'ok',
+    0,
+    [],
+    null,
+];
 describe('deriveExecutionProgressStatus', () => {
     it('passes through running and stopped', () => {
         expect(deriveExecutionProgressStatus('running', [])).toBe('running');

package/vendor/shared/dist/langflower-bus-config.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeEdge, RuntimeRunnerEvent } from '@langflower/runtime';
+import type { PortTelemetry, RuntimeDoneTelemetry, RuntimeEdge } from '@langflower/runtime';
 import type { DividerPositions, ExecutionFeedSnapshotPayload, RunnerSnapshotPayload, SessionStateSnapshotPayload, ToolConfigSnapshotPayload } from './types/langflower-bootstrap.js';
 import type { LangflowerConfigDraftDiscardRequestedPayload, LangflowerConfigDraftPatchRequestedPayload, LangflowerConfigDraftSnapshotPayload, LangflowerConfigSaveRequestedPayload, LangflowerConfigSnapshotPayload, LangflowerModelsCatalogSnapshotPayload, RunnerPermissionAskPayload, RunnerPermissionReplyPayload } from './types/langflower-config.js';
 import type { RunnerCheckpointDiscardRequestedPayload, RunnerCheckpointsSnapshotPayload, RunnerResumeFailedPayload, RunnerResumeRequestedPayload, WorkflowCheckpointSummary } from './types/workflow-checkpoint.js';
@@ -53,8 +53,7 @@ import type { CanvasViewport, WorkflowCurrentSnapshotPayload, WorkflowCurrentSta
  * broadcast `workflow.*.snapshot`.
  *
  * **Runtime after reconnect:** hydrate the log / port state from
- * `executionFeed.snapshot`, then append live `runner.output-emitted`,
- * `runner.input-received`, `runner.done`, … — no replay of the full runner
+ * `executionFeed.snapshot`, then append live `runner.port`, `runner.done`, … — no replay of the full runner
  * history on every mutation, only the dedicated feed snapshot plus new frames.
  *
  * Partials: {@link editorConfig} | {@link runnerConfig} |
@@ -404,21 +403,14 @@ export declare const langflowerWsConfig: {
          */
         readonly 'runner.interrupted': import("@langflower/websocket-bridge").WsBridgeMessageDefinition<"cancel">;
         /**
-         * Output port signal — {@link RuntimeRunnerEvent} with
-         * `kind === 'output-emitted'`.
+         * Port signal — {@link PortTelemetry}; direction at `payload[0]` (`'in'` | `'out'`).
          */
-        readonly 'runner.output-emitted': import("@langflower/websocket-bridge").WsBridgeMessageDefinition<RuntimeRunnerEvent>;
+        readonly 'runner.port': import("@langflower/websocket-bridge").WsBridgeMessageDefinition<PortTelemetry>;
         /**
-         * Input port signal — {@link RuntimeRunnerEvent} with
-         * `kind === 'input-received'` (wires, seeds).
-         */
-        readonly 'runner.input-received': import("@langflower/websocket-bridge").WsBridgeMessageDefinition<RuntimeRunnerEvent>;
-        /**
-         * Natural run end — {@link RuntimeRunnerEvent} with `kind === 'done'`
-         * (empty graph, {@link RuntimeNode.stopsRun}, or forced complete).
+         * Natural run end — {@link RuntimeDoneTelemetry}.
          * Runner status becomes `'idle'`.
          */
-        readonly 'runner.done': import("@langflower/websocket-bridge").WsBridgeMessageDefinition<RuntimeRunnerEvent>;
+        readonly 'runner.done': import("@langflower/websocket-bridge").WsBridgeMessageDefinition<RuntimeDoneTelemetry>;
         /**
          * Runtime permission ask for a gated harness tool call (feed + composer).
          * Stays inside the internal tool loop — not a graph HITL edge.

package/vendor/shared/dist/langflower-bus-config.js

@@ -242,18 +242,11 @@ const runnerConfig = {
          */
         'runner.interrupted': message(),
         /**
-         * Output port signal — {@link RuntimeRunnerEvent} with
-         * `kind === 'output-emitted'`.
+         * Port signal — {@link PortTelemetry}; direction at `payload[0]` (`'in'` | `'out'`).
          */
-        'runner.output-emitted': message(),
+        'runner.port': message(),
         /**
-         * Input port signal — {@link RuntimeRunnerEvent} with
-         * `kind === 'input-received'` (wires, seeds).
-         */
-        'runner.input-received': message(),
-        /**
-         * Natural run end — {@link RuntimeRunnerEvent} with `kind === 'done'`
-         * (empty graph, {@link RuntimeNode.stopsRun}, or forced complete).
+         * Natural run end — {@link RuntimeDoneTelemetry}.
          * Runner status becomes `'idle'`.
          */
         'runner.done': message(),
@@ -595,8 +588,7 @@ const workflowManagerConfig = {
  * broadcast `workflow.*.snapshot`.
  *
  * **Runtime after reconnect:** hydrate the log / port state from
- * `executionFeed.snapshot`, then append live `runner.output-emitted`,
- * `runner.input-received`, `runner.done`, … — no replay of the full runner
+ * `executionFeed.snapshot`, then append live `runner.port`, `runner.done`, … — no replay of the full runner
  * history on every mutation, only the dedicated feed snapshot plus new frames.
  *
  * Partials: {@link editorConfig} | {@link runnerConfig} |

package/vendor/shared/dist/langflower-config/resolve-wired-tool-options.js

@@ -35,6 +35,12 @@ export const DOMAIN_PACK_TOOL_OPTIONS = {
         { value: 'update_memory_section', title: 'update_memory_section' },
         { value: 'create_memory_file', title: 'create_memory_file' },
     ],
+    'common-langflower-tools': [
+        {
+            value: 'compile_custom_nodes',
+            title: 'compile_custom_nodes',
+        },
+    ],
 };
 const readToolMetaFromNode = (node) => {
     const toolId = String(node.inputs.toolId ?? '').trim();

package/vendor/shared/dist/langflower-config/resolve-wired-tool-options.test.js

@@ -38,6 +38,36 @@ describe('resolveWiredToolOptions', () => {
             'update_memory_section',
         ].sort());
     });
+    it('expands langflower tools pack into compile_custom_nodes', () => {
+        const options = resolveWiredToolOptions({
+            nodes: [
+                {
+                    id: 'compile',
+                    type: 'common-langflower-tools',
+                    params: {},
+                    inputs: {},
+                    ui: { position: { x: 0, y: 0 } },
+                },
+                {
+                    id: 'llm',
+                    type: 'common-fake-llm',
+                    params: {},
+                    inputs: {},
+                    ui: { position: { x: 0, y: 0 } },
+                },
+            ],
+            edges: [
+                {
+                    edgeId: 'e1',
+                    fromNodeId: 'compile',
+                    fromPort: ['tools', 0],
+                    toNodeId: 'llm',
+                    toPort: ['tools', 0],
+                },
+            ],
+        }, 'llm');
+        expect(options.map((o) => o.value)).toEqual(['compile_custom_nodes']);
+    });
     it('maps wired tool-registration edges to select options with description', () => {
         const options = resolveWiredToolOptions({
             nodes: [

package/vendor/shared/dist/langflower-ws-waits.d.ts

@@ -2,7 +2,7 @@
  * Wait / request helpers over {@link langflowerWsConfig} client subjects.
  * Shared by integration tests and `@langflower/mcp` (no filesystem I/O).
  */
-import type { NodeId, RunId, RuntimeRunnerEvent } from '@langflower/runtime';
+import type { NodeId, PortTelemetry, RunId, RuntimeRunnerEvent } from '@langflower/runtime';
 import type { WsBridgeClientApi } from '@langflower/websocket-bridge';
 import { type Observable } from 'rxjs';
 import { langflowerWsConfig } from './langflower-bus-config.js';
@@ -35,23 +35,16 @@ export declare const requestWorkflowDeleteSnapshot: (client: LangflowerWsClient,
 export declare const startRunner: (client: LangflowerWsClient) => Promise<RunId>;
 export declare const startRunnerFromNode: (client: LangflowerWsClient, nodeId: NodeId) => Promise<RunId>;
 export declare const interruptRunner: (client: LangflowerWsClient) => Promise<void>;
-type InputReceivedEvent = Extract<RuntimeRunnerEvent, {
-    kind: 'input-received';
-}>;
-export declare const sendHitlInput: (client: LangflowerWsClient, payload: Parameters<LangflowerWsClient["runner.hitl.event"]["next"]>[0], runId?: string) => Promise<InputReceivedEvent>;
-type OutputEmittedEvent = Extract<RuntimeRunnerEvent, {
-    kind: 'output-emitted';
-    state: 'value';
-}>;
+export declare const sendHitlInput: (client: LangflowerWsClient, payload: Parameters<LangflowerWsClient["runner.hitl.event"]["next"]>[0]) => Promise<PortTelemetry>;
+type OutputPortTelemetry = PortTelemetry & {
+    readonly 3: 'value';
+};
 export declare const waitForRunnerOutput: (client: LangflowerWsClient, match: {
     readonly nodeId: string;
     readonly portId: string;
-    readonly runId?: string;
     readonly predicate?: (value: unknown) => boolean;
-}) => Promise<OutputEmittedEvent>;
-export declare const waitForRunnerDone: (client: LangflowerWsClient, runId?: string) => Promise<Extract<RuntimeRunnerEvent, {
-    kind: "done";
-}>>;
+}) => Promise<OutputPortTelemetry>;
+export declare const waitForRunnerDone: (client: LangflowerWsClient, runId?: string) => Promise<Extract<RuntimeRunnerEvent, readonly ["done"] | readonly ["done", RunId]>>;
 export declare const waitExecutionFeedSnapshot: (client: LangflowerWsClient, predicate?: (snap: ExecutionFeedSnapshotPayload | null) => boolean) => Promise<ExecutionFeedSnapshotPayload | null>;
 /**
  * Await the next value on a typed inbound bus stream (with optional timeout).

package/vendor/shared/dist/langflower-ws-waits.js

@@ -2,6 +2,7 @@
  * Wait / request helpers over {@link langflowerWsConfig} client subjects.
  * Shared by integration tests and `@langflower/mcp` (no filesystem I/O).
  */
+import { isPortTelemetry, isRuntimeDone } from '@langflower/runtime';
 import { filter, firstValueFrom, take, timeout } from 'rxjs';
 const asRunId = (value) => {
     if (value === false) {
@@ -85,24 +86,23 @@ export const interruptRunner = async (client) => {
     client['runner.interrupt.requested'].next('cancel');
     await interrupted$;
 };
-export const sendHitlInput = async (client, payload, runId) => {
-    const received$ = firstValueFrom(client['runner.input-received'].pipe(filter((event) => event.kind === 'input-received' &&
-        event.nodeId === payload.nodeId &&
-        event.portId === payload.portId &&
-        (runId === undefined || event.runId === runId)), take(1)));
+export const sendHitlInput = async (client, payload) => {
+    const received$ = firstValueFrom(client['runner.port'].pipe(filter((event) => isPortTelemetry(event) &&
+        event[0] === 'in' &&
+        event[1] === payload.nodeId &&
+        event[2] === payload.portId), take(1)));
     client['runner.hitl.event'].next(payload);
     return received$;
 };
-export const waitForRunnerOutput = async (client, match) => firstValueFrom(client['runner.output-emitted'].pipe(filter((event) => event.kind === 'output-emitted' &&
-    event.state === 'value' &&
-    event.nodeId === match.nodeId &&
-    event.portId === match.portId &&
-    (match.runId === undefined ||
-        event.runId === match.runId) &&
+export const waitForRunnerOutput = async (client, match) => firstValueFrom(client['runner.port'].pipe(filter((event) => isPortTelemetry(event) &&
+    event[0] === 'out' &&
+    event[3] === 'value' &&
+    event[1] === match.nodeId &&
+    event[2] === match.portId &&
     (match.predicate === undefined ||
-        match.predicate(event.value))), take(1)));
-export const waitForRunnerDone = async (client, runId) => firstValueFrom(client['runner.done'].pipe(filter((event) => event.kind === 'done' &&
-    (runId === undefined || event.runId === runId)), take(1)));
+        match.predicate(event[4]))), take(1)));
+export const waitForRunnerDone = async (client, runId) => firstValueFrom(client['runner.done'].pipe(filter((event) => isRuntimeDone(event) &&
+    (runId === undefined || event[1] === runId)), take(1)));
 export const waitExecutionFeedSnapshot = async (client, predicate = () => true) => firstValueFrom(client['executionFeed.snapshot'].pipe(filter(predicate), take(1)));
 /**
  * Await the next value on a typed inbound bus stream (with optional timeout).

package/vendor/websocket-bridge/dist/bridge-codec.d.ts

@@ -1,2 +1,3 @@
 import type { WsBridgeCodec } from './bridge-types.js';
+export declare const encodeBridgeFrame: (transportDir: "in" | "out", busType: string, payload: unknown, ts?: string) => string;
 export declare const defaultWsBridgeCodec: WsBridgeCodec;

package/vendor/websocket-bridge/dist/bridge-codec.js

@@ -1,22 +1,22 @@
+const isBridgeFrame = (value) => Array.isArray(value) &&
+    value.length === 4 &&
+    typeof value[0] === 'string' &&
+    (value[1] === 'in' || value[1] === 'out') &&
+    typeof value[2] === 'string';
+export const encodeBridgeFrame = (transportDir, busType, payload, ts = new Date().toISOString()) => JSON.stringify([ts, transportDir, busType, payload]);
 export const defaultWsBridgeCodec = {
-    encode(event) {
-        return JSON.stringify(event);
+    encode(event, transportDir) {
+        return encodeBridgeFrame(transportDir, event.type, event.payload);
     },
     decode(raw) {
         try {
             const parsed = JSON.parse(raw);
-            if (typeof parsed !== 'object' ||
-                parsed === null ||
-                Array.isArray(parsed)) {
-                return null;
-            }
-            const record = parsed;
-            if (typeof record['type'] !== 'string' || !('payload' in record)) {
+            if (!isBridgeFrame(parsed)) {
                 return null;
             }
             return {
-                type: record['type'],
-                payload: record['payload'],
+                type: parsed[2],
+                payload: parsed[3],
             };
         }
         catch {

package/vendor/websocket-bridge/dist/bridge-frame.js

@@ -19,6 +19,6 @@ export function decodeInboundFrame(config, codec, raw, section) {
         };
     }
     return {
-        error: createWsBridgeError('INVALID_ENVELOPE', 'Frame must be a { type, payload } object'),
+        error: createWsBridgeError('INVALID_ENVELOPE', 'Frame must be a bridge tuple [ts, transportDir, busType, payload]'),
     };
 }

package/vendor/websocket-bridge/dist/bridge-subjects.d.ts

@@ -5,6 +5,6 @@ export type WsBridgeMessageSection = keyof Pick<WsBridgeConfig, 'fromClientToSer
 export declare function readMessageKeys(config: WsBridgeConfig, section: WsBridgeMessageSection): readonly string[];
 export declare function createSubjectMap(keys: readonly string[]): Record<string, Subject<unknown>>;
 export declare function toObservables(subjects: Record<string, Subject<unknown>>): Record<string, Observable<unknown>>;
-export declare function wireOutgoingSubjects(subjects: Record<string, Subject<unknown>>, send: (event: WsBridgeEvent) => void): Subscription[];
+export declare function wireOutgoingSubjects(subjects: Record<string, Subject<unknown>>, send: (event: WsBridgeEvent, transportDir: 'in' | 'out') => void, transportDir: 'in' | 'out'): Subscription[];
 export declare function routeInboundEvent(event: WsBridgeEvent, subjects: Record<string, Subject<unknown>>, clientId?: string): boolean;
 export declare function completeSubjects(subjects: Record<string, Subject<unknown>>): void;

package/vendor/websocket-bridge/dist/bridge-subjects.js

@@ -16,9 +16,9 @@ export function toObservables(subjects) {
     }
     return observables;
 }
-export function wireOutgoingSubjects(subjects, send) {
+export function wireOutgoingSubjects(subjects, send, transportDir) {
     return Object.entries(subjects).map(([type, subject]) => subject.subscribe((payload) => {
-        send({ type, payload });
+        send({ type, payload }, transportDir);
     }));
 }
 export function routeInboundEvent(event, subjects, clientId) {

package/vendor/websocket-bridge/dist/bridge-types.d.ts

@@ -12,8 +12,15 @@ export type WsBridgeEvent<Payload = unknown> = {
     readonly type: string;
     readonly payload: Payload;
 };
+/** Wire + log line: `[ts, transportDir, busType, payload]`. */
+export type BridgeFrame = readonly [
+    ts: string,
+    transportDir: 'in' | 'out',
+    busType: string,
+    payload: unknown
+];
 export type WsBridgeCodec = {
-    encode(event: WsBridgeEvent): string;
+    encode(event: WsBridgeEvent, transportDir: 'in' | 'out'): string;
     decode(raw: string): WsBridgeEvent | null;
 };
 export type WsBridgeConfig<ClientToServer extends WsBridgeMessageConfig = WsBridgeMessageConfig, ServerToClient extends WsBridgeMessageConfig = WsBridgeMessageConfig> = {
@@ -84,6 +91,11 @@ export type WsBridgeServer<C extends WsBridgeConfig> = {
     readonly errors$: Observable<WsBridgeError>;
     readonly status$: Observable<WsBridgeStatus>;
     close(): void;
+    /**
+     * Push a client-to-server event as if a socket sent it (in-process
+     * hosts). Inbound channels stay Observables — not Subjects.
+     */
+    injectInbound<K extends WsBridgeServerInboundKey<C>>(type: K, payload: WsBridgeServerInboundPayload<C, K>, clientId?: string): void;
 };
 export type WsBridgeServerApi<C extends WsBridgeConfig> = WsBridgeServer<C> & WsBridgeServerIncoming<C> & WsBridgeServerOutgoing<C>;
 /** Type carrier for config entries — no casts in consumer config. */

package/vendor/websocket-bridge/dist/create-client.js

@@ -89,7 +89,7 @@ export function createClient(config, options = {}) {
     const errorsSubject = new Subject();
     const statusSubject = new BehaviorSubject('connecting');
     const socket = connectSocket(url);
-    const sendEvent = (event) => {
+    const sendEvent = (event, transportDir) => {
         if (socket.readyState !== OPEN) {
             errorsSubject.next({
                 code: 'TRANSPORT_NOT_OPEN',
@@ -97,11 +97,11 @@ export function createClient(config, options = {}) {
             });
             return;
         }
-        socket.send(codec.encode(event));
+        socket.send(codec.encode(event, transportDir));
     };
     // Wire at construction so early `.next` is not silently dropped; sendEvent
     // still rejects until the socket is OPEN.
-    const wireSubscriptions = wireOutgoingSubjects(outgoingSubjects, sendEvent);
+    const wireSubscriptions = wireOutgoingSubjects(outgoingSubjects, sendEvent, 'in');
     socket.onOpen(() => {
         statusSubject.next('connected');
     });

package/vendor/websocket-bridge/dist/create-server.js

@@ -18,14 +18,14 @@ export function createServer(config, options = {}) {
     const errorsSubject = new Subject();
     const statusSubject = new BehaviorSubject('connecting');
     const clients = new Set();
-    const wireSubscriptions = wireOutgoingSubjects(broadcastSubjects, (event) => {
-        const raw = codec.encode(event);
+    const wireSubscriptions = wireOutgoingSubjects(broadcastSubjects, (event, transportDir) => {
+        const raw = codec.encode(event, transportDir);
         for (const client of clients) {
             if (client.ws.readyState === client.ws.OPEN) {
                 client.ws.send(raw);
             }
         }
-    });
+    }, 'out');
     const wss = options.httpServer !== undefined
         ? new WebSocketServer({ server: options.httpServer, path })
         : new WebSocketServer({ host, port, path });
@@ -57,12 +57,12 @@ export function createServer(config, options = {}) {
         const outgoingSubjects = createSubjectMap(serverToClientKeys);
         const disconnectedSubject = new Subject();
         const connectedSubject = new BehaviorSubject(true);
-        const subscriptions = wireOutgoingSubjects(outgoingSubjects, (event) => {
+        const subscriptions = wireOutgoingSubjects(outgoingSubjects, (event, transportDir) => {
             if (ws.readyState !== ws.OPEN) {
                 return;
             }
-            ws.send(codec.encode(event));
-        });
+            ws.send(codec.encode(event, transportDir));
+        }, 'out');
         const closeClient = () => {
             if (ws.readyState === ws.OPEN || ws.readyState === ws.CONNECTING) {
                 ws.close();
@@ -108,6 +108,12 @@ export function createServer(config, options = {}) {
         connections$: connectionsSubject.asObservable(),
         errors$: errorsSubject.asObservable(),
         status$: statusSubject.asObservable(),
+        injectInbound(type, payload, clientId = 'in-process') {
+            const routed = routeInboundEvent({ type, payload }, inboundSubjects, clientId);
+            if (!routed) {
+                throw new Error(`Unknown inbound event: ${String(type)}`);
+            }
+        },
         close() {
             statusSubject.next('disconnected');
             for (const client of [...clients]) {

package/vendor/websocket-bridge/package.json

@@ -14,6 +14,14 @@
 		"./create-server": {
 			"types": "./dist/create-server.d.ts",
 			"import": "./dist/create-server.js"
+		},
+		"./bridge-codec": {
+			"types": "./dist/bridge-codec.d.ts",
+			"import": "./dist/bridge-codec.js"
+		},
+		"./bridge-codec.js": {
+			"types": "./dist/bridge-codec.d.ts",
+			"import": "./dist/bridge-codec.js"
 		}
 	},
 	"dependencies": {