oui-spec 0.1.0 → 0.2.0

package/dist/{chunk-WZXUKJ7E.cjs → chunk-MTMEW6MM.cjs}

@@ -101,110 +101,6 @@ function createWebSocketTransport(socket, config) {
   };
 }
 
-// src/transport/direct.ts
-function createDirectTransportPair() {
-  const actionHandlers = [];
-  const observationHandlers = [];
-  const surfaceRegisterHandlers = [];
-  const surfaceDeregisterHandlers = [];
-  const server = {
-    dispatch(surfaceId, actionId, params) {
-      actionHandlers.forEach((h) => h(surfaceId, actionId, params));
-    },
-    onAction() {
-      return () => {
-      };
-    },
-    // Server doesn't receive dispatches
-    pushObservation() {
-    },
-    // Server doesn't push observations
-    onObservation(handler) {
-      observationHandlers.push(handler);
-      return () => {
-        const i = observationHandlers.indexOf(handler);
-        if (i >= 0) observationHandlers.splice(i, 1);
-      };
-    },
-    registerSurface() {
-    },
-    deregisterSurface() {
-    },
-    onSurfaceRegister(handler) {
-      surfaceRegisterHandlers.push(handler);
-      return () => {
-        const i = surfaceRegisterHandlers.indexOf(handler);
-        if (i >= 0) surfaceRegisterHandlers.splice(i, 1);
-      };
-    },
-    onSurfaceDeregister(handler) {
-      surfaceDeregisterHandlers.push(handler);
-      return () => {
-        const i = surfaceDeregisterHandlers.indexOf(handler);
-        if (i >= 0) surfaceDeregisterHandlers.splice(i, 1);
-      };
-    },
-    get connected() {
-      return true;
-    },
-    async connect() {
-    },
-    disconnect() {
-    },
-    onConnectionChange() {
-      return () => {
-      };
-    }
-  };
-  const client = {
-    dispatch() {
-    },
-    // Client doesn't dispatch
-    onAction(handler) {
-      actionHandlers.push(handler);
-      return () => {
-        const i = actionHandlers.indexOf(handler);
-        if (i >= 0) actionHandlers.splice(i, 1);
-      };
-    },
-    pushObservation(update) {
-      observationHandlers.forEach((h) => h(update));
-    },
-    onObservation() {
-      return () => {
-      };
-    },
-    // Client doesn't receive observations
-    registerSurface(surface) {
-      surfaceRegisterHandlers.forEach((h) => h(surface));
-    },
-    deregisterSurface(surfaceId) {
-      surfaceDeregisterHandlers.forEach((h) => h(surfaceId));
-    },
-    onSurfaceRegister() {
-      return () => {
-      };
-    },
-    onSurfaceDeregister() {
-      return () => {
-      };
-    },
-    get connected() {
-      return true;
-    },
-    async connect() {
-    },
-    disconnect() {
-    },
-    onConnectionChange() {
-      return () => {
-      };
-    }
-  };
-  return { server, client };
-}
-
-exports.createDirectTransportPair = createDirectTransportPair;
 exports.createWebSocketTransport = createWebSocketTransport;
-//# sourceMappingURL=chunk-WZXUKJ7E.cjs.map
-//# sourceMappingURL=chunk-WZXUKJ7E.cjs.map
+//# sourceMappingURL=chunk-MTMEW6MM.cjs.map
+//# sourceMappingURL=chunk-MTMEW6MM.cjs.map

package/dist/chunk-MTMEW6MM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/websocket.ts"],"names":[],"mappings":";;;AAaO,SAAS,wBAAA,CACd,QACA,MAAA,EACc;AACd,EAAA,MAAM,EAAA,GAAK,QAAQ,SAAA,IAAa,KAAA;AAChC,EAAA,MAAM,SAAkD,EAAC;AACzD,EAAA,MAAM,SAAA,GAAY,QAAQ,aAAA,IAAiB,GAAA;AAC3C,EAAA,MAAM,YAAA,GAAe,QAAQ,uBAAA,IAA2B,IAAA;AAExD,EAAA,IAAI,SAAA,GAAY,OAAO,SAAA,IAAa,KAAA;AACpC,EAAA,MAAM,qBAAkD,EAAC;AAGzD,EAAA,MAAA,CAAO,EAAA,CAAG,WAAW,MAAM;AACzB,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,kBAAA,CAAmB,OAAA,CAAQ,CAAA,CAAA,KAAK,CAAA,CAAE,IAAI,CAAC,CAAA;AAEvC,IAAA,IAAI,YAAA,EAAc;AAChB,MAAA,OAAO,MAAA,CAAO,SAAS,CAAA,EAAG;AACxB,QAAA,MAAM,GAAA,GAAM,OAAO,KAAA,EAAM;AACzB,QAAA,MAAA,CAAO,IAAA,CAAK,GAAA,CAAI,KAAA,EAAO,GAAA,CAAI,IAAI,CAAA;AAAA,MACjC;AAAA,IACF;AAAA,EACF,CAAC,CAAA;AAED,EAAA,MAAA,CAAO,EAAA,CAAG,cAAc,MAAM;AAC5B,IAAA,SAAA,GAAY,KAAA;AACZ,IAAA,kBAAA,CAAmB,OAAA,CAAQ,CAAA,CAAA,KAAK,CAAA,CAAE,KAAK,CAAC,CAAA;AAAA,EAC1C,CAAC,CAAA;AAED,EAAA,SAAS,IAAA,CAAK,OAAe,IAAA,EAAe;AAC1C,IAAA,IAAI,SAAA,EAAW;AACb,MAAA,MAAA,CAAO,IAAA,CAAK,OAAO,IAAI,CAAA;AAAA,IACzB,CAAA,MAAA,IAAW,YAAA,IAAgB,MAAA,CAAO,MAAA,GAAS,SAAA,EAAW;AACpD,MAAA,MAAA,CAAO,IAAA,CAAK,EAAE,KAAA,EAAO,IAAA,EAAM,CAAA;AAAA,IAC7B;AAAA,EACF;AAEA,EAAA,OAAO;AAAA;AAAA,IAEL,QAAA,CAAS,SAAA,EAAW,QAAA,EAAU,MAAA,EAAQ;AACpC,MAAA,IAAA,CAAK,CAAA,EAAG,EAAE,CAAA,SAAA,CAAA,EAAa,EAAE,SAAA,EAAW,QAAA,EAAU,MAAA,EAAQ,SAAA,EAAW,IAAA,CAAK,GAAA,EAAI,EAAG,CAAA;AAAA,IAC/E,CAAA;AAAA,IAEA,SAAS,OAAA,EAA2B;AAClC,MAAA,MAAM,QAAA,GAAW,CAAC,IAAA,KAAmF;AACnG,QAAA,OAAA,CAAQ,IAAA,CAAK,SAAA,EAAW,IAAA,CAAK,QAAA,EAAU,KAAK,MAAM,CAAA;AAAA,MACpD,CAAA;AACA,MAAA,MAAA,CAAO,EAAA,CAAG,CAAA,EAAG,EAAE,CAAA,SAAA,CAAA,EAAa,QAAQ,CAAA;AACpC,MAAA,OAAO,MAAM,MAAA,CAAO,GAAA,CAAI,CAAA,EAAG,EAAE,aAAa,QAAQ,CAAA;AAAA,IACpD,CAAA;AAAA;AAAA,IAGA,gBAAgB,MAAA,EAA8B;AAC5C,MAAA,IAAA,CAAK,CAAA,EAAG,EAAE,CAAA,YAAA,CAAA,EAAgB,MAAM,CAAA;AAAA,IAClC,CAAA;AAAA,IAEA,cAAc,OAAA,EAAgC;AAC5C,MAAA,MAAM,QAAA,GAAW,CAAC,IAAA,KAA+B,OAAA,CAAQ,IAAI,CAAA;AAC7D,MAAA,MAAA,CAAO,EAAA,CAAG,CAAA,EAAG,EAAE,CAAA,YAAA,CAAA,EAAgB,QAAQ,CAAA;AACvC,MAAA,OAAO,MAAM,MAAA,CAAO,GAAA,CAAI,CAAA,EAAG,EAAE,gBAAgB,QAAQ,CAAA;AAAA,IACvD,CAAA;AAAA;AAAA,IAGA,gBAAgB,OAAA,EAAqB;AACnC,MAAA,IAAA,CAAK,CAAA,EAAG,EAAE,CAAA,iBAAA,CAAA,EAAqB,EAAE,SAAS,SAAA,EAAW,IAAA,CAAK,GAAA,EAAI,EAAG,CAAA;AAAA,IACnE,CAAA;AAAA,IAEA,kBAAkB,SAAA,EAAmB;AACnC,MAAA,IAAA,CAAK,CAAA,EAAG,EAAE,CAAA,mBAAA,CAAA,EAAuB,EAAE,WAAW,SAAA,EAAW,IAAA,CAAK,GAAA,EAAI,EAAG,CAAA;AAAA,IACvE,CAAA;AAAA,IAEA,kBAAkB,OAAA,EAAwC;AACxD,MAAA,MAAM,QAAA,GAAW,CAAC,IAAA,KAAkC,OAAA,CAAQ,KAAK,OAAO,CAAA;AACxE,MAAA,MAAA,CAAO,EAAA,CAAG,CAAA,EAAG,EAAE,CAAA,iBAAA,CAAA,EAAqB,QAAQ,CAAA;AAC5C,MAAA,OAAO,MAAM,MAAA,CAAO,GAAA,CAAI,CAAA,EAAG,EAAE,qBAAqB,QAAQ,CAAA;AAAA,IAC5D,CAAA;AAAA,IAEA,oBAAoB,OAAA,EAAsC;AACxD,MAAA,MAAM,QAAA,GAAW,CAAC,IAAA,KAAgC,OAAA,CAAQ,KAAK,SAAS,CAAA;AACxE,MAAA,MAAA,CAAO,EAAA,CAAG,CAAA,EAAG,EAAE,CAAA,mBAAA,CAAA,EAAuB,QAAQ,CAAA;AAC9C,MAAA,OAAO,MAAM,MAAA,CAAO,GAAA,CAAI,CAAA,EAAG,EAAE,uBAAuB,QAAQ,CAAA;AAAA,IAC9D,CAAA;AAAA;AAAA,IAGA,IAAI,SAAA,GAAY;AAAE,MAAA,OAAO,SAAA;AAAA,IAAW,CAAA;AAAA,IAEpC,MAAM,OAAA,GAAU;AACd,MAAA,IAAI,SAAA,EAAW;AACf,MAAA,OAAO,IAAI,OAAA,CAAc,CAAC,OAAA,EAAS,MAAA,KAAW;AAC5C,QAAA,MAAM,OAAA,GAAU,WAAW,MAAM;AAC/B,UAAA,MAAA,CAAO,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,QAAQ,gBAAA,IAAoB,GAAK,KAAK,CAAC,CAAA;AAAA,QAC5F,CAAA,EAAG,MAAA,EAAQ,gBAAA,IAAoB,GAAK,CAAA;AAEpC,QAAA,MAAA,CAAO,IAAA,CAAK,WAAW,MAAM;AAC3B,UAAA,YAAA,CAAa,OAAO,CAAA;AACpB,UAAA,OAAA,EAAQ;AAAA,QACV,CAAC,CAAA;AAED,QAAA,IAAI,OAAO,MAAA,CAAO,OAAA,KAAY,UAAA,EAAY;AACxC,UAAA,MAAA,CAAO,OAAA,EAAQ;AAAA,QACjB;AAAA,MACF,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,UAAA,GAAa;AACX,MAAA,IAAI,OAAO,MAAA,CAAO,UAAA,KAAe,UAAA,EAAY;AAC3C,QAAA,MAAA,CAAO,UAAA,EAAW;AAAA,MACpB;AAAA,IACF,CAAA;AAAA,IAEA,mBAAmB,OAAA,EAA+B;AAChD,MAAA,kBAAA,CAAmB,KAAK,OAAO,CAAA;AAC/B,MAAA,OAAO,MAAM;AACX,QAAA,MAAM,GAAA,GAAM,kBAAA,CAAmB,OAAA,CAAQ,OAAO,CAAA;AAC9C,QAAA,IAAI,GAAA,IAAO,CAAA,EAAG,kBAAA,CAAmB,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,MAChD,CAAA;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-MTMEW6MM.cjs","sourcesContent":["import type { OUITransport, OUITransportConfig, OUIActionHandler, OUIObservationHandler } from './types.js';\nimport type { OUISurface, OUIObservationUpdate } from '../spec/index.js';\n\n/**\n * WebSocket transport using Socket.IO.\n * Maps OUI protocol events to socket events with a configurable namespace prefix.\n *\n * Events emitted:\n *   {ns}:dispatch        — action dispatch (server → client)\n *   {ns}:observation     — observation update (client → server)\n *   {ns}:surface:register   — surface registration (client → server)\n *   {ns}:surface:deregister — surface deregistration (client → server)\n */\nexport function createWebSocketTransport(\n  socket: SocketLike,\n  config?: OUITransportConfig,\n): OUITransport {\n  const ns = config?.namespace ?? 'oui';\n  const buffer: Array<{ event: string; data: unknown }> = [];\n  const maxBuffer = config?.maxBufferSize ?? 100;\n  const shouldBuffer = config?.bufferWhileDisconnected ?? true;\n\n  let connected = socket.connected ?? false;\n  const connectionHandlers: Array<(c: boolean) => void> = [];\n\n  // Track connection state\n  socket.on('connect', () => {\n    connected = true;\n    connectionHandlers.forEach(h => h(true));\n    // Flush buffer\n    if (shouldBuffer) {\n      while (buffer.length > 0) {\n        const msg = buffer.shift()!;\n        socket.emit(msg.event, msg.data);\n      }\n    }\n  });\n\n  socket.on('disconnect', () => {\n    connected = false;\n    connectionHandlers.forEach(h => h(false));\n  });\n\n  function emit(event: string, data: unknown) {\n    if (connected) {\n      socket.emit(event, data);\n    } else if (shouldBuffer && buffer.length < maxBuffer) {\n      buffer.push({ event, data });\n    }\n  }\n\n  return {\n    // ─── Dispatch Channel ───────────────────────────────────────\n    dispatch(surfaceId, actionId, params) {\n      emit(`${ns}:dispatch`, { surfaceId, actionId, params, timestamp: Date.now() });\n    },\n\n    onAction(handler: OUIActionHandler) {\n      const listener = (data: { surfaceId: string; actionId: string; params: Record<string, unknown> }) => {\n        handler(data.surfaceId, data.actionId, data.params);\n      };\n      socket.on(`${ns}:dispatch`, listener);\n      return () => socket.off(`${ns}:dispatch`, listener);\n    },\n\n    // ─── Observation Channel ────────────────────────────────────\n    pushObservation(update: OUIObservationUpdate) {\n      emit(`${ns}:observation`, update);\n    },\n\n    onObservation(handler: OUIObservationHandler) {\n      const listener = (data: OUIObservationUpdate) => handler(data);\n      socket.on(`${ns}:observation`, listener);\n      return () => socket.off(`${ns}:observation`, listener);\n    },\n\n    // ─── Surface Lifecycle ──────────────────────────────────────\n    registerSurface(surface: OUISurface) {\n      emit(`${ns}:surface:register`, { surface, timestamp: Date.now() });\n    },\n\n    deregisterSurface(surfaceId: string) {\n      emit(`${ns}:surface:deregister`, { surfaceId, timestamp: Date.now() });\n    },\n\n    onSurfaceRegister(handler: (surface: OUISurface) => void) {\n      const listener = (data: { surface: OUISurface }) => handler(data.surface);\n      socket.on(`${ns}:surface:register`, listener);\n      return () => socket.off(`${ns}:surface:register`, listener);\n    },\n\n    onSurfaceDeregister(handler: (surfaceId: string) => void) {\n      const listener = (data: { surfaceId: string }) => handler(data.surfaceId);\n      socket.on(`${ns}:surface:deregister`, listener);\n      return () => socket.off(`${ns}:surface:deregister`, listener);\n    },\n\n    // ─── Connection ─────────────────────────────────────────────\n    get connected() { return connected; },\n\n    async connect() {\n      if (connected) return;\n      return new Promise<void>((resolve, reject) => {\n        const timeout = setTimeout(() => {\n          reject(new Error(`OUI transport connect timeout (${config?.connectTimeoutMs ?? 10000}ms)`));\n        }, config?.connectTimeoutMs ?? 10000);\n\n        socket.once('connect', () => {\n          clearTimeout(timeout);\n          resolve();\n        });\n\n        if (typeof socket.connect === 'function') {\n          socket.connect();\n        }\n      });\n    },\n\n    disconnect() {\n      if (typeof socket.disconnect === 'function') {\n        socket.disconnect();\n      }\n    },\n\n    onConnectionChange(handler: (c: boolean) => void) {\n      connectionHandlers.push(handler);\n      return () => {\n        const idx = connectionHandlers.indexOf(handler);\n        if (idx >= 0) connectionHandlers.splice(idx, 1);\n      };\n    },\n  };\n}\n\n/**\n * Minimal socket interface — compatible with Socket.IO client or server socket.\n * Only the methods OUI actually uses.\n */\nexport interface SocketLike {\n  readonly connected?: boolean;\n  emit(event: string, data: unknown): void;\n  on(event: string, handler: (...args: any[]) => void): void;\n  off(event: string, handler: (...args: any[]) => void): void;\n  once(event: string, handler: (...args: any[]) => void): void;\n  connect?(): void;\n  disconnect?(): void;\n}\n"]}

package/dist/chunk-O6EI77LD.js

@@ -0,0 +1,106 @@
+// src/transport/direct.ts
+function createDirectTransportPair() {
+  const actionHandlers = [];
+  const observationHandlers = [];
+  const surfaceRegisterHandlers = [];
+  const surfaceDeregisterHandlers = [];
+  const server = {
+    dispatch(surfaceId, actionId, params) {
+      actionHandlers.forEach((h) => h(surfaceId, actionId, params));
+    },
+    onAction() {
+      return () => {
+      };
+    },
+    // Server doesn't receive dispatches
+    pushObservation() {
+    },
+    // Server doesn't push observations
+    onObservation(handler) {
+      observationHandlers.push(handler);
+      return () => {
+        const i = observationHandlers.indexOf(handler);
+        if (i >= 0) observationHandlers.splice(i, 1);
+      };
+    },
+    registerSurface() {
+    },
+    deregisterSurface() {
+    },
+    onSurfaceRegister(handler) {
+      surfaceRegisterHandlers.push(handler);
+      return () => {
+        const i = surfaceRegisterHandlers.indexOf(handler);
+        if (i >= 0) surfaceRegisterHandlers.splice(i, 1);
+      };
+    },
+    onSurfaceDeregister(handler) {
+      surfaceDeregisterHandlers.push(handler);
+      return () => {
+        const i = surfaceDeregisterHandlers.indexOf(handler);
+        if (i >= 0) surfaceDeregisterHandlers.splice(i, 1);
+      };
+    },
+    get connected() {
+      return true;
+    },
+    async connect() {
+    },
+    disconnect() {
+    },
+    onConnectionChange() {
+      return () => {
+      };
+    }
+  };
+  const client = {
+    dispatch() {
+    },
+    // Client doesn't dispatch
+    onAction(handler) {
+      actionHandlers.push(handler);
+      return () => {
+        const i = actionHandlers.indexOf(handler);
+        if (i >= 0) actionHandlers.splice(i, 1);
+      };
+    },
+    pushObservation(update) {
+      observationHandlers.forEach((h) => h(update));
+    },
+    onObservation() {
+      return () => {
+      };
+    },
+    // Client doesn't receive observations
+    registerSurface(surface) {
+      surfaceRegisterHandlers.forEach((h) => h(surface));
+    },
+    deregisterSurface(surfaceId) {
+      surfaceDeregisterHandlers.forEach((h) => h(surfaceId));
+    },
+    onSurfaceRegister() {
+      return () => {
+      };
+    },
+    onSurfaceDeregister() {
+      return () => {
+      };
+    },
+    get connected() {
+      return true;
+    },
+    async connect() {
+    },
+    disconnect() {
+    },
+    onConnectionChange() {
+      return () => {
+      };
+    }
+  };
+  return { server, client };
+}
+
+export { createDirectTransportPair };
+//# sourceMappingURL=chunk-O6EI77LD.js.map
+//# sourceMappingURL=chunk-O6EI77LD.js.map

package/dist/chunk-O6EI77LD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/direct.ts"],"names":[],"mappings":"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","file":"chunk-O6EI77LD.js","sourcesContent":["import type { OUITransport, OUIActionHandler, OUIObservationHandler } from './types.js';\nimport type { OUISurface, OUIObservationUpdate } from '../spec/index.js';\n\n/**\n * Direct transport — for same-process communication.\n * Used for API surfaces (where the agent runtime and surface are in the same Lambda)\n * and for testing (where you want synchronous, in-memory communication).\n *\n * Creates a paired (server, client) transport where messages sent on one\n * side are immediately received on the other.\n */\nexport function createDirectTransportPair(): { server: OUITransport; client: OUITransport } {\n  const actionHandlers: OUIActionHandler[] = [];\n  const observationHandlers: OUIObservationHandler[] = [];\n  const surfaceRegisterHandlers: Array<(s: OUISurface) => void> = [];\n  const surfaceDeregisterHandlers: Array<(id: string) => void> = [];\n\n  const server: OUITransport = {\n    dispatch(surfaceId, actionId, params) {\n      // Server dispatches → client receives\n      actionHandlers.forEach(h => h(surfaceId, actionId, params));\n    },\n    onAction() { return () => {}; }, // Server doesn't receive dispatches\n    pushObservation() {}, // Server doesn't push observations\n    onObservation(handler) {\n      observationHandlers.push(handler);\n      return () => { const i = observationHandlers.indexOf(handler); if (i >= 0) observationHandlers.splice(i, 1); };\n    },\n    registerSurface() {},\n    deregisterSurface() {},\n    onSurfaceRegister(handler) {\n      surfaceRegisterHandlers.push(handler);\n      return () => { const i = surfaceRegisterHandlers.indexOf(handler); if (i >= 0) surfaceRegisterHandlers.splice(i, 1); };\n    },\n    onSurfaceDeregister(handler) {\n      surfaceDeregisterHandlers.push(handler);\n      return () => { const i = surfaceDeregisterHandlers.indexOf(handler); if (i >= 0) surfaceDeregisterHandlers.splice(i, 1); };\n    },\n    get connected() { return true; },\n    async connect() {},\n    disconnect() {},\n    onConnectionChange() { return () => {}; },\n  };\n\n  const client: OUITransport = {\n    dispatch() {}, // Client doesn't dispatch\n    onAction(handler) {\n      actionHandlers.push(handler);\n      return () => { const i = actionHandlers.indexOf(handler); if (i >= 0) actionHandlers.splice(i, 1); };\n    },\n    pushObservation(update: OUIObservationUpdate) {\n      // Client pushes → server receives\n      observationHandlers.forEach(h => h(update));\n    },\n    onObservation() { return () => {}; }, // Client doesn't receive observations\n    registerSurface(surface) {\n      surfaceRegisterHandlers.forEach(h => h(surface));\n    },\n    deregisterSurface(surfaceId) {\n      surfaceDeregisterHandlers.forEach(h => h(surfaceId));\n    },\n    onSurfaceRegister() { return () => {}; },\n    onSurfaceDeregister() { return () => {}; },\n    get connected() { return true; },\n    async connect() {},\n    disconnect() {},\n    onConnectionChange() { return () => {}; },\n  };\n\n  return { server, client };\n}\n"]}

package/dist/{chunk-7EXSMPGR.js → chunk-YDMGV72W.js}

@@ -99,109 +99,6 @@ function createWebSocketTransport(socket, config) {
   };
 }
 
-// src/transport/direct.ts
-function createDirectTransportPair() {
-  const actionHandlers = [];
-  const observationHandlers = [];
-  const surfaceRegisterHandlers = [];
-  const surfaceDeregisterHandlers = [];
-  const server = {
-    dispatch(surfaceId, actionId, params) {
-      actionHandlers.forEach((h) => h(surfaceId, actionId, params));
-    },
-    onAction() {
-      return () => {
-      };
-    },
-    // Server doesn't receive dispatches
-    pushObservation() {
-    },
-    // Server doesn't push observations
-    onObservation(handler) {
-      observationHandlers.push(handler);
-      return () => {
-        const i = observationHandlers.indexOf(handler);
-        if (i >= 0) observationHandlers.splice(i, 1);
-      };
-    },
-    registerSurface() {
-    },
-    deregisterSurface() {
-    },
-    onSurfaceRegister(handler) {
-      surfaceRegisterHandlers.push(handler);
-      return () => {
-        const i = surfaceRegisterHandlers.indexOf(handler);
-        if (i >= 0) surfaceRegisterHandlers.splice(i, 1);
-      };
-    },
-    onSurfaceDeregister(handler) {
-      surfaceDeregisterHandlers.push(handler);
-      return () => {
-        const i = surfaceDeregisterHandlers.indexOf(handler);
-        if (i >= 0) surfaceDeregisterHandlers.splice(i, 1);
-      };
-    },
-    get connected() {
-      return true;
-    },
-    async connect() {
-    },
-    disconnect() {
-    },
-    onConnectionChange() {
-      return () => {
-      };
-    }
-  };
-  const client = {
-    dispatch() {
-    },
-    // Client doesn't dispatch
-    onAction(handler) {
-      actionHandlers.push(handler);
-      return () => {
-        const i = actionHandlers.indexOf(handler);
-        if (i >= 0) actionHandlers.splice(i, 1);
-      };
-    },
-    pushObservation(update) {
-      observationHandlers.forEach((h) => h(update));
-    },
-    onObservation() {
-      return () => {
-      };
-    },
-    // Client doesn't receive observations
-    registerSurface(surface) {
-      surfaceRegisterHandlers.forEach((h) => h(surface));
-    },
-    deregisterSurface(surfaceId) {
-      surfaceDeregisterHandlers.forEach((h) => h(surfaceId));
-    },
-    onSurfaceRegister() {
-      return () => {
-      };
-    },
-    onSurfaceDeregister() {
-      return () => {
-      };
-    },
-    get connected() {
-      return true;
-    },
-    async connect() {
-    },
-    disconnect() {
-    },
-    onConnectionChange() {
-      return () => {
-      };
-    }
-  };
-  return { server, client };
-}
-
-export { createDirectTransportPair, createWebSocketTransport };
-//# sourceMappingURL=chunk-7EXSMPGR.js.map
-//# sourceMappingURL=chunk-7EXSMPGR.js.map
+export { createWebSocketTransport };
+//# sourceMappingURL=chunk-YDMGV72W.js.map
+//# sourceMappingURL=chunk-YDMGV72W.js.map

package/dist/chunk-YDMGV72W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/websocket.ts"],"names":[],"mappings":"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","file":"chunk-YDMGV72W.js","sourcesContent":["import type { OUITransport, OUITransportConfig, OUIActionHandler, OUIObservationHandler } from './types.js';\nimport type { OUISurface, OUIObservationUpdate } from '../spec/index.js';\n\n/**\n * WebSocket transport using Socket.IO.\n * Maps OUI protocol events to socket events with a configurable namespace prefix.\n *\n * Events emitted:\n *   {ns}:dispatch        — action dispatch (server → client)\n *   {ns}:observation     — observation update (client → server)\n *   {ns}:surface:register   — surface registration (client → server)\n *   {ns}:surface:deregister — surface deregistration (client → server)\n */\nexport function createWebSocketTransport(\n  socket: SocketLike,\n  config?: OUITransportConfig,\n): OUITransport {\n  const ns = config?.namespace ?? 'oui';\n  const buffer: Array<{ event: string; data: unknown }> = [];\n  const maxBuffer = config?.maxBufferSize ?? 100;\n  const shouldBuffer = config?.bufferWhileDisconnected ?? true;\n\n  let connected = socket.connected ?? false;\n  const connectionHandlers: Array<(c: boolean) => void> = [];\n\n  // Track connection state\n  socket.on('connect', () => {\n    connected = true;\n    connectionHandlers.forEach(h => h(true));\n    // Flush buffer\n    if (shouldBuffer) {\n      while (buffer.length > 0) {\n        const msg = buffer.shift()!;\n        socket.emit(msg.event, msg.data);\n      }\n    }\n  });\n\n  socket.on('disconnect', () => {\n    connected = false;\n    connectionHandlers.forEach(h => h(false));\n  });\n\n  function emit(event: string, data: unknown) {\n    if (connected) {\n      socket.emit(event, data);\n    } else if (shouldBuffer && buffer.length < maxBuffer) {\n      buffer.push({ event, data });\n    }\n  }\n\n  return {\n    // ─── Dispatch Channel ───────────────────────────────────────\n    dispatch(surfaceId, actionId, params) {\n      emit(`${ns}:dispatch`, { surfaceId, actionId, params, timestamp: Date.now() });\n    },\n\n    onAction(handler: OUIActionHandler) {\n      const listener = (data: { surfaceId: string; actionId: string; params: Record<string, unknown> }) => {\n        handler(data.surfaceId, data.actionId, data.params);\n      };\n      socket.on(`${ns}:dispatch`, listener);\n      return () => socket.off(`${ns}:dispatch`, listener);\n    },\n\n    // ─── Observation Channel ────────────────────────────────────\n    pushObservation(update: OUIObservationUpdate) {\n      emit(`${ns}:observation`, update);\n    },\n\n    onObservation(handler: OUIObservationHandler) {\n      const listener = (data: OUIObservationUpdate) => handler(data);\n      socket.on(`${ns}:observation`, listener);\n      return () => socket.off(`${ns}:observation`, listener);\n    },\n\n    // ─── Surface Lifecycle ──────────────────────────────────────\n    registerSurface(surface: OUISurface) {\n      emit(`${ns}:surface:register`, { surface, timestamp: Date.now() });\n    },\n\n    deregisterSurface(surfaceId: string) {\n      emit(`${ns}:surface:deregister`, { surfaceId, timestamp: Date.now() });\n    },\n\n    onSurfaceRegister(handler: (surface: OUISurface) => void) {\n      const listener = (data: { surface: OUISurface }) => handler(data.surface);\n      socket.on(`${ns}:surface:register`, listener);\n      return () => socket.off(`${ns}:surface:register`, listener);\n    },\n\n    onSurfaceDeregister(handler: (surfaceId: string) => void) {\n      const listener = (data: { surfaceId: string }) => handler(data.surfaceId);\n      socket.on(`${ns}:surface:deregister`, listener);\n      return () => socket.off(`${ns}:surface:deregister`, listener);\n    },\n\n    // ─── Connection ─────────────────────────────────────────────\n    get connected() { return connected; },\n\n    async connect() {\n      if (connected) return;\n      return new Promise<void>((resolve, reject) => {\n        const timeout = setTimeout(() => {\n          reject(new Error(`OUI transport connect timeout (${config?.connectTimeoutMs ?? 10000}ms)`));\n        }, config?.connectTimeoutMs ?? 10000);\n\n        socket.once('connect', () => {\n          clearTimeout(timeout);\n          resolve();\n        });\n\n        if (typeof socket.connect === 'function') {\n          socket.connect();\n        }\n      });\n    },\n\n    disconnect() {\n      if (typeof socket.disconnect === 'function') {\n        socket.disconnect();\n      }\n    },\n\n    onConnectionChange(handler: (c: boolean) => void) {\n      connectionHandlers.push(handler);\n      return () => {\n        const idx = connectionHandlers.indexOf(handler);\n        if (idx >= 0) connectionHandlers.splice(idx, 1);\n      };\n    },\n  };\n}\n\n/**\n * Minimal socket interface — compatible with Socket.IO client or server socket.\n * Only the methods OUI actually uses.\n */\nexport interface SocketLike {\n  readonly connected?: boolean;\n  emit(event: string, data: unknown): void;\n  on(event: string, handler: (...args: any[]) => void): void;\n  off(event: string, handler: (...args: any[]) => void): void;\n  once(event: string, handler: (...args: any[]) => void): void;\n  connect?(): void;\n  disconnect?(): void;\n}\n"]}

package/dist/core/index.cjs

@@ -1,13 +1,18 @@
 'use strict';
 
-var chunkLEXIU2MH_cjs = require('../chunk-LEXIU2MH.cjs');
+var chunkHK7OXB2W_cjs = require('../chunk-HK7OXB2W.cjs');
 var chunk3DCIL4FV_cjs = require('../chunk-3DCIL4FV.cjs');
+require('../chunk-MTMEW6MM.cjs');
 
 
 
+Object.defineProperty(exports, "createOUI", {
+  enumerable: true,
+  get: function () { return chunkHK7OXB2W_cjs.createOUI; }
+});
 Object.defineProperty(exports, "defineSurface", {
   enumerable: true,
-  get: function () { return chunkLEXIU2MH_cjs.defineSurface; }
+  get: function () { return chunkHK7OXB2W_cjs.defineSurface; }
 });
 Object.defineProperty(exports, "OUI_PROTOCOL_EVENTS", {
   enumerable: true,

package/dist/core/index.d.cts

@@ -1,120 +1,134 @@
-import { JSONSchema, OUIActionPolling, OUIActivation, OUISurface } from '../spec/index.cjs';
-export { OUIAction, OUIActionRequest, OUIActionResult, OUIObservation, OUIObservationUpdate, OUIProtocolEvent, OUISurfaceDeregistration, OUISurfaceRegistration, OUI_PROTOCOL_EVENTS } from '../spec/index.cjs';
+import { OUISurface } from '../spec/index.cjs';
+export { JSONSchema, OUIAction, OUIActionPolling, OUIActionRequest, OUIActionResult, OUIActivation, OUIObservation, OUIObservationUpdate, OUIProtocolEvent, OUISurfaceDeregistration, OUISurfaceRegistration, OUI_PROTOCOL_EVENTS } from '../spec/index.cjs';
+import { D as DefinedSurface, O as OUIBranded } from '../define-surface-D6XPtoqu.cjs';
+export { A as ActionDefinition, a as ActionHandlerResult, b as ActionPollingConfig, c as ObservationDefinition, S as SurfaceDefinition, d as defineSurface } from '../define-surface-D6XPtoqu.cjs';
+import { S as SocketLike, c as OUITransportConfig, b as OUITransport } from '../websocket-CrI0yRNo.cjs';
 
 /**
- * Configuration for defining an OUI surface with handlers.
- * This is the "integration file" an app provides — it declares both
- * the schema (what the agent sees) and the implementation (what executes).
+ * Compile-time validation for a createOUI configuration.
+ *
+ * These types resolve to a descriptive error type when a rule is broken, so the
+ * failure surfaces at the call site with a message naming the offending id —
+ * not as `Type 'X' is not assignable to type 'never'`.
+ *
+ * Everything here was previously a runtime `throw` inside defineSurface, or
+ * nothing at all. A duplicate action id threw when the surface was constructed,
+ * which in a React app means at render, in a browser, after a deploy. The same
+ * mistake is now a red squiggle.
  */
-interface SurfaceDefinition<TContext = unknown> {
-    id: string;
-    name: string;
-    description: string;
-    version?: string;
-    activation?: OUIActivation;
-    actions: ActionDefinition<TContext>[];
-    observations?: ObservationDefinition[];
-    metadata?: Record<string, unknown>;
-}
+/** A readable compile error. The message lands in the tooltip. */
+type OUIConfigError<TMessage extends string> = {
+    readonly __ouiError: TMessage;
+};
+/** Ids appearing more than once in a tuple of string literals. */
+type Duplicates<T extends readonly string[], Seen extends string = never> = T extends readonly [
+    infer Head extends string,
+    ...infer Rest extends readonly string[]
+] ? Head extends Seen ? Head | Duplicates<Rest, Seen | Head> : Duplicates<Rest, Seen | Head> : never;
 /**
- * Polling config with an optional resolve handler.
- * The spec's OUIActionPolling is the manifest shape (no functions).
- * The core extends it with the resolve implementation for the runtime.
+ * `never` when every id is unique, otherwise the duplicated ids.
+ * Exported for tests — a validation type nobody can assert against is a
+ * validation type nobody can trust.
  */
-interface ActionPollingConfig<TContext = unknown> extends OUIActionPolling {
-    /**
-     * Called on each poll interval. Receives the dispatch result from the handler
-     * plus the current context. Return { done: true, data } to stop polling,
-     * or { done: false, data } to continue.
-     */
-    resolve?: (dispatchResult: unknown, context: TContext) => Promise<{
-        done: boolean;
-        data: unknown;
-    }>;
-}
+type DuplicateIds<T extends readonly string[]> = Duplicates<T>;
+type IsEmpty<T extends readonly unknown[]> = T extends readonly [] ? true : false;
 /**
- * An action definition includes both the schema (for the agent) and
- * the handler (for execution). This is the single source of truth —
- * no separate YAML, no separate listener, no drift possible.
+ * Validate the surface list, returning the config type when it passes and an
+ * OUIConfigError when it does not.
+ *
+ * The rules, and why each exists:
+ *
+ *   Non-empty — an OUI instance with no surfaces registers nothing and
+ *   dispatches nowhere. It looks connected and does nothing, which is the
+ *   failure mode this whole design is trying to eliminate.
+ *
+ *   Unique surface ids — registration is keyed by surface id, so a duplicate
+ *   silently replaces the first surface's manifest. The agent then sees one
+ *   surface's actions attributed to the other.
+ */
+type ValidateSurfaceIds<TIds extends readonly string[]> = IsEmpty<TIds> extends true ? OUIConfigError<"createOUI requires at least one surface. An instance with no surfaces registers nothing and dispatches nowhere."> : [DuplicateIds<TIds>] extends [never] ? unknown : OUIConfigError<`Duplicate surface id: "${DuplicateIds<TIds>}". Surface registration is keyed by id, so the second would silently replace the first.`>;
+
+/**
+ * createOUI — the only supported way to instantiate OUI.
+ *
+ * WHY THIS EXISTS
+ *
+ * OUI shipped a correct protocol and a correct transport, and its first
+ * integrator used neither. studio-ui imported only the `SocketLike` TYPE from
+ * oui-spec and rebuilt the wire by hand: a literal map of protocol types to
+ * socket names, `oui:` hardcoded so the configurable namespace was unreachable,
+ * payload interfaces re-declared on the server, and an `action:result` channel
+ * mapped but never sent — duplicating the observation channel that already
+ * carries results.
+ *
+ * Nothing was wrong with the spec. Nothing enforced it. Structural typing meant
+ * every hand-rolled piece type-checked, and both ends agreed only by the
+ * coincidence of matching string literals. Rename one and the other keeps
+ * compiling and silently stops receiving.
+ *
+ * So the requirements are gated here:
+ *
+ *   OUI owns the wire. The integrator provides a socket; it cannot provide a
+ *   transport, because `OUITransport` values are branded and only this module
+ *   brands them.
+ *
+ *   OUI owns the result path. Results return through the observation channel,
+ *   as `use-surface` already implements. An integrator cannot add a parallel
+ *   channel because it cannot construct a transport to add one to.
+ *
+ *   The integrator owns content. Surfaces, action schemas, observation schemas
+ *   and handlers all arrive through `defineSurface`, whose output is branded —
+ *   so a plain object shaped like a surface will not compile.
+ *
+ *   Violations fail at compile time with a message naming the offending id.
  */
-interface ActionDefinition<TContext = unknown> {
-    id: string;
-    description: string;
-    input: JSONSchema;
-    output?: JSONSchema;
-    confirm?: boolean;
-    async?: boolean;
+
+/** A transport OUI constructed. Integrators cannot produce one. */
+type OwnedTransport = OUITransport & OUIBranded<"transport">;
+/** Surface ids as literal types, for the duplicate check. */
+type SurfaceIds<T extends readonly DefinedSurface<never>[]> = {
+    [K in keyof T]: T[K]["id"];
+};
+interface OUIConfig<TSurfaces extends readonly DefinedSurface<never>[]> {
     /**
-     * Polling/subscription config for async actions.
-     * After the handler returns, the OUI runtime starts polling or subscribing
-     * and pushes observation updates until the operation completes.
-     * Extends the spec's OUIActionPolling with an optional resolve handler.
+     * The socket OUI will speak over. The integrator owns the connection —
+     * auth, reconnection, lifecycle — and OUI owns what travels on it.
      */
-    polling?: ActionPollingConfig<TContext>;
-    usage?: string;
-    preconditions?: string;
-    estimatedDuration?: string;
-    tags?: string[];
+    socket: SocketLike;
     /**
-     * The handler that executes when the agent invokes this action.
-     * Receives typed params and a context object (app-specific state/utilities).
-     * Returns a result that the agent sees as the tool output.
+     * Surfaces produced by `defineSurface`. A plain object with the same shape
+     * will not compile: DefinedSurface is branded.
      */
-    handler: (params: Record<string, unknown>, context: TContext) => Promise<ActionHandlerResult>;
-}
-interface ActionHandlerResult {
-    success: boolean;
-    data?: unknown;
-    error?: {
-        code: string;
-        message: string;
-        details?: unknown;
+    surfaces: TSurfaces;
+    /**
+     * Wire configuration. `namespace` defaults to 'oui' and is the supported way
+     * to change the event prefix — hardcoding it at the call site is what made
+     * this option unreachable in the first integration.
+     */
+    transport?: Omit<OUITransportConfig, "namespace"> & {
+        namespace?: string;
     };
-    /** For async actions: metadata passed to the polling resolver */
-    dispatchMeta?: Record<string, unknown>;
 }
-interface ObservationDefinition {
-    id: string;
-    description: string;
-    schema: JSONSchema;
-    /** Function that returns the current observation value */
-    getValue?: () => unknown;
+/** A live OUI instance. */
+interface OUIInstance {
+    /** The transport OUI owns. Exposed for wiring, not for reimplementation. */
+    readonly transport: OwnedTransport;
+    /** Manifests for every registered surface, as the agent sees them. */
+    readonly manifests: readonly OUISurface[];
+    /** Register every surface and connect. */
+    start(): Promise<void>;
+    /** Deregister every surface and disconnect. */
+    stop(): void;
+    /** Look up a registered surface by id. */
+    getSurface(id: string): DefinedSurface<never> | undefined;
 }
 /**
- * Define an OUI surface — the single entry point for integrating
- * an application feature with the OUI protocol.
- *
- * This function validates the definition and returns a typed surface
- * object that can be registered with an agent runtime or transport layer.
+ * Instantiate OUI.
  *
- * @example
- * ```typescript
- * const mySurface = defineSurface({
- *   id: 'my-feature',
- *   name: 'My Feature',
- *   description: 'Does something cool',
- *   actions: [
- *     {
- *       id: 'do_thing',
- *       description: 'Does the thing',
- *       input: { type: 'object', properties: { name: { type: 'string' } }, required: ['name'] },
- *       handler: async (params) => {
- *         const result = await doTheThing(params.name);
- *         return { success: true, data: result };
- *       },
- *     },
- *   ],
- * });
- * ```
+ * `const` on the type parameter captures surface ids as literal types, which is
+ * what allows duplicate detection to name the offending id rather than failing
+ * with an unassignable-to-never error.
  */
-declare function defineSurface<TContext = unknown>(definition: SurfaceDefinition<TContext>): DefinedSurface<TContext>;
-/** A fully defined surface with both manifest extraction and execution capabilities */
-interface DefinedSurface<TContext = unknown> extends SurfaceDefinition<TContext> {
-    toManifest(): OUISurface;
-    executeAction(actionId: string, params: Record<string, unknown>, context: TContext): Promise<ActionHandlerResult>;
-    getActionIds(): string[];
-    /** Get the polling config for an action (if async) */
-    getPollingConfig(actionId: string): OUIActionPolling | undefined;
-}
+declare function createOUI<const TSurfaces extends readonly DefinedSurface<never>[]>(config: OUIConfig<TSurfaces> & ValidateSurfaceIds<SurfaceIds<TSurfaces>>): OUIInstance;
 
-export { type ActionDefinition, type ActionHandlerResult, type ActionPollingConfig, type DefinedSurface, JSONSchema, OUIActivation, OUISurface, type ObservationDefinition, type SurfaceDefinition, defineSurface };
+export { DefinedSurface, type DuplicateIds, OUIBranded, type OUIConfig, type OUIConfigError, type OUIInstance, OUISurface, type OwnedTransport, type ValidateSurfaceIds, createOUI };