oui-spec 0.2.0 → 0.3.0

package/dist/chunk-NYCJZQSP.js

@@ -0,0 +1,92 @@
+import { createContext, createElement, useContext, useRef, useEffect, useCallback, useMemo } from 'react';
+
+// src/react/use-surface.ts
+var SurfaceRuntimeContext = createContext(null);
+function SurfaceRuntimeProvider({
+  runtime,
+  children
+}) {
+  return createElement(
+    SurfaceRuntimeContext.Provider,
+    { value: runtime },
+    children
+  );
+}
+function useSurfaceRuntime() {
+  const runtime = useContext(SurfaceRuntimeContext);
+  if (!runtime) {
+    throw new Error(
+      "[OUI] useSurface needs a SurfaceRuntimeProvider above it. Create one runtime per client with createSurfaceRuntime() and provide it at the root."
+    );
+  }
+  return runtime;
+}
+var localRequestSeq = 0;
+function useSurface(options) {
+  const { surface, context, active = true } = options;
+  const runtime = useSurfaceRuntime();
+  const contextRef = useRef(context);
+  contextRef.current = context;
+  const mountedRef = useRef(null);
+  const pendingRef = useRef(/* @__PURE__ */ new Map());
+  useEffect(() => {
+    if (!active) return;
+    const mounted = runtime.mount(surface, () => contextRef.current);
+    mountedRef.current = mounted;
+    for (const [observationId, value] of pendingRef.current) {
+      mounted.pushObservation(observationId, value);
+    }
+    pendingRef.current.clear();
+    return () => {
+      mounted.unmount();
+      if (mountedRef.current === mounted) mountedRef.current = null;
+    };
+  }, [runtime, surface, active]);
+  const pushObservation = useCallback(
+    (observationId, value) => {
+      const mounted = mountedRef.current;
+      if (mounted) mounted.pushObservation(observationId, value);
+      else pendingRef.current.set(observationId, value);
+    },
+    []
+  );
+  const execute = useCallback(
+    (actionId, params = {}) => runtime.execute({
+      requestId: `local_${Date.now()}_${++localRequestSeq}`,
+      surfaceId: surface.id,
+      actionId,
+      params,
+      timestamp: Date.now()
+    }),
+    [runtime, surface.id]
+  );
+  return useMemo(
+    () => ({ surfaceId: surface.id, pushObservation, execute }),
+    [surface.id, pushObservation, execute]
+  );
+}
+function useObservation(surface, observationId, value) {
+  const { pushObservation } = surface;
+  let serialized;
+  try {
+    serialized = JSON.stringify(value) ?? "undefined";
+  } catch {
+    serialized = String(value);
+  }
+  const valueRef = useRef(value);
+  valueRef.current = value;
+  useEffect(() => {
+    pushObservation(observationId, valueRef.current);
+  }, [pushObservation, observationId, serialized]);
+}
+function useSurfaceHold(busy) {
+  const runtime = useSurfaceRuntime();
+  useEffect(() => {
+    if (!busy) return;
+    return runtime.hold();
+  }, [runtime, busy]);
+}
+
+export { SurfaceRuntimeProvider, useObservation, useSurface, useSurfaceHold, useSurfaceRuntime };
+//# sourceMappingURL=chunk-NYCJZQSP.js.map
+//# sourceMappingURL=chunk-NYCJZQSP.js.map

package/dist/chunk-NYCJZQSP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/use-surface.ts"],"names":[],"mappings":"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","file":"chunk-NYCJZQSP.js","sourcesContent":["import {\n  createContext,\n  createElement,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  type ReactNode,\n} from \"react\";\nimport type {\n  DefinedSurface,\n  SurfaceRuntime,\n  MountedSurface,\n} from \"../core/index.js\";\nimport type { OUIActionResult } from \"../spec/index.js\";\n\n// ─── Runtime context ─────────────────────────────────────────────────────────\n\nconst SurfaceRuntimeContext = createContext<SurfaceRuntime | null>(null);\n\nexport interface SurfaceRuntimeProviderProps {\n  runtime: SurfaceRuntime;\n  children?: ReactNode;\n}\n\n/** Makes one surface runtime available to every `useSurface` below it. */\nexport function SurfaceRuntimeProvider({\n  runtime,\n  children,\n}: SurfaceRuntimeProviderProps) {\n  return createElement(\n    SurfaceRuntimeContext.Provider,\n    { value: runtime },\n    children,\n  );\n}\n\n/** The surface runtime from the nearest `SurfaceRuntimeProvider`. */\nexport function useSurfaceRuntime(): SurfaceRuntime {\n  const runtime = useContext(SurfaceRuntimeContext);\n  if (!runtime) {\n    throw new Error(\n      \"[OUI] useSurface needs a SurfaceRuntimeProvider above it. Create one runtime per client with \" +\n        \"createSurfaceRuntime() and provide it at the root.\",\n    );\n  }\n  return runtime;\n}\n\n// ─── useSurface ──────────────────────────────────────────────────────────────\n\nexport interface UseSurfaceOptions<TContext> {\n  /** The defined surface (from defineSurface()) */\n  surface: DefinedSurface<TContext>;\n\n  /** Passed to action handlers. Read when an action runs, so it is always current. */\n  context: TContext;\n\n  /** Mount the surface only while true. Default true. */\n  active?: boolean;\n}\n\nexport interface UseSurfaceResult {\n  surfaceId: string;\n  /** Record an observation value on this surface. Unchanged values are ignored. */\n  pushObservation(observationId: string, value: unknown): void;\n  /** Run one of this surface's actions locally, exactly as a dispatched request would. */\n  execute(\n    actionId: string,\n    params?: Record<string, unknown>,\n  ): Promise<OUIActionResult>;\n}\n\nlet localRequestSeq = 0;\n\n/**\n * Mount a surface into the client's surface runtime for as long as the\n * component is mounted (and `active`). The runtime answers dispatched requests\n * for it, so the component needs no listener of its own.\n */\nexport function useSurface<TContext>(\n  options: UseSurfaceOptions<TContext>,\n): UseSurfaceResult {\n  const { surface, context, active = true } = options;\n  const runtime = useSurfaceRuntime();\n\n  const contextRef = useRef(context);\n  contextRef.current = context;\n\n  const mountedRef = useRef<MountedSurface | null>(null);\n  // Observations pushed before the mount effect ran (effects declared earlier\n  // in the same component run first) are kept and delivered on mount rather\n  // than lost.\n  const pendingRef = useRef(new Map<string, unknown>());\n\n  useEffect(() => {\n    if (!active) return;\n    const mounted = runtime.mount(surface, () => contextRef.current);\n    mountedRef.current = mounted;\n    for (const [observationId, value] of pendingRef.current) {\n      mounted.pushObservation(observationId, value);\n    }\n    pendingRef.current.clear();\n    return () => {\n      mounted.unmount();\n      if (mountedRef.current === mounted) mountedRef.current = null;\n    };\n  }, [runtime, surface, active]);\n\n  const pushObservation = useCallback(\n    (observationId: string, value: unknown) => {\n      const mounted = mountedRef.current;\n      if (mounted) mounted.pushObservation(observationId, value);\n      else pendingRef.current.set(observationId, value);\n    },\n    [],\n  );\n\n  const execute = useCallback(\n    (actionId: string, params: Record<string, unknown> = {}) =>\n      runtime.execute({\n        requestId: `local_${Date.now()}_${++localRequestSeq}`,\n        surfaceId: surface.id,\n        actionId,\n        params,\n        timestamp: Date.now(),\n      }),\n    [runtime, surface.id],\n  );\n\n  return useMemo(\n    () => ({ surfaceId: surface.id, pushObservation, execute }),\n    [surface.id, pushObservation, execute],\n  );\n}\n\n// ─── useObservation ──────────────────────────────────────────────────────────\n\n/** Keep an observation on a mounted surface equal to `value`. */\nexport function useObservation(\n  surface: Pick<UseSurfaceResult, \"pushObservation\">,\n  observationId: string,\n  value: unknown,\n): void {\n  const { pushObservation } = surface;\n  let serialized: string;\n  try {\n    serialized = JSON.stringify(value) ?? \"undefined\";\n  } catch {\n    serialized = String(value);\n  }\n  const valueRef = useRef(value);\n  valueRef.current = value;\n\n  useEffect(() => {\n    pushObservation(observationId, valueRef.current);\n  }, [pushObservation, observationId, serialized]);\n}\n\n// ─── useSurfaceHold ──────────────────────────────────────────────────────────\n\n/**\n * Keep the UI unsettled while `busy` is true: an action's result waits for it.\n * For work mounting cannot show, such as a route's code or a page's data still\n * loading.\n */\nexport function useSurfaceHold(busy: boolean): void {\n  const runtime = useSurfaceRuntime();\n  useEffect(() => {\n    if (!busy) return;\n    return runtime.hold();\n  }, [runtime, busy]);\n}\n"]}

package/dist/chunk-ROGKEMLL.cjs

@@ -0,0 +1,91 @@
+'use strict';
+
+// src/transport/direct.ts
+function createDirectTransportPair() {
+  const actionHandlers = [];
+  const resultHandlers = [];
+  const observationHandlers = [];
+  const surfaceRegisterHandlers = [];
+  const surfaceDeregisterHandlers = [];
+  function subscribe(list, handler) {
+    list.push(handler);
+    return () => {
+      const i = list.indexOf(handler);
+      if (i >= 0) list.splice(i, 1);
+    };
+  }
+  const noop = () => {
+  };
+  const unsubscribed = () => noop;
+  const server = {
+    dispatch(request) {
+      actionHandlers.forEach((h) => h(request));
+    },
+    onAction: unsubscribed,
+    // Server doesn't receive dispatches
+    sendResult: noop,
+    // Server doesn't answer requests
+    onResult(handler) {
+      return subscribe(resultHandlers, handler);
+    },
+    pushObservation: noop,
+    // Server doesn't push observations
+    onObservation(handler) {
+      return subscribe(observationHandlers, handler);
+    },
+    registerSurface: noop,
+    deregisterSurface: noop,
+    onSurfaceRegister(handler) {
+      return subscribe(surfaceRegisterHandlers, handler);
+    },
+    onSurfaceDeregister(handler) {
+      return subscribe(surfaceDeregisterHandlers, handler);
+    },
+    get connected() {
+      return true;
+    },
+    async connect() {
+    },
+    disconnect: noop,
+    onConnectionChange: unsubscribed,
+    dispose: noop
+  };
+  const client = {
+    dispatch: noop,
+    // Client doesn't dispatch
+    onAction(handler) {
+      return subscribe(actionHandlers, handler);
+    },
+    sendResult(result) {
+      resultHandlers.forEach((h) => h(result));
+    },
+    onResult: unsubscribed,
+    // Client doesn't receive results
+    pushObservation(update) {
+      observationHandlers.forEach((h) => h(update));
+    },
+    onObservation: unsubscribed,
+    // Client doesn't receive observations
+    registerSurface(surface) {
+      surfaceRegisterHandlers.forEach((h) => h(surface));
+    },
+    deregisterSurface(surfaceId) {
+      surfaceDeregisterHandlers.forEach((h) => h(surfaceId));
+    },
+    onSurfaceRegister: unsubscribed,
+    onSurfaceDeregister: unsubscribed,
+    get connected() {
+      return true;
+    },
+    async connect() {
+    },
+    disconnect: noop,
+    onConnectionChange: unsubscribed,
+    dispose: noop
+  };
+  return { server, client };
+}
+
+exports.createDirectTransportPair = createDirectTransportPair;
+//# sourceMappingURL=chunk-ROGKEMLL.cjs.map
+//# sourceMappingURL=chunk-ROGKEMLL.cjs.map

package/dist/chunk-ROGKEMLL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/direct.ts"],"names":[],"mappings":"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","file":"chunk-ROGKEMLL.cjs","sourcesContent":["import type {\n  OUITransport,\n  OUIActionHandler,\n  OUIObservationHandler,\n  OUIResultHandler,\n} 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(): {\n  server: OUITransport;\n  client: OUITransport;\n} {\n  const actionHandlers: OUIActionHandler[] = [];\n  const resultHandlers: OUIResultHandler[] = [];\n  const observationHandlers: OUIObservationHandler[] = [];\n  const surfaceRegisterHandlers: Array<(s: OUISurface) => void> = [];\n  const surfaceDeregisterHandlers: Array<(id: string) => void> = [];\n\n  function subscribe<T>(list: T[], handler: T): () => void {\n    list.push(handler);\n    return () => {\n      const i = list.indexOf(handler);\n      if (i >= 0) list.splice(i, 1);\n    };\n  }\n\n  const noop = () => {};\n  const unsubscribed = () => noop;\n\n  const server: OUITransport = {\n    dispatch(request) {\n      // Server dispatches → client receives\n      actionHandlers.forEach((h) => h(request));\n    },\n    onAction: unsubscribed, // Server doesn't receive dispatches\n    sendResult: noop, // Server doesn't answer requests\n    onResult(handler) {\n      return subscribe(resultHandlers, handler);\n    },\n    pushObservation: noop, // Server doesn't push observations\n    onObservation(handler) {\n      return subscribe(observationHandlers, handler);\n    },\n    registerSurface: noop,\n    deregisterSurface: noop,\n    onSurfaceRegister(handler) {\n      return subscribe(surfaceRegisterHandlers, handler);\n    },\n    onSurfaceDeregister(handler) {\n      return subscribe(surfaceDeregisterHandlers, handler);\n    },\n    get connected() {\n      return true;\n    },\n    async connect() {},\n    disconnect: noop,\n    onConnectionChange: unsubscribed,\n    dispose: noop,\n  };\n\n  const client: OUITransport = {\n    dispatch: noop, // Client doesn't dispatch\n    onAction(handler) {\n      return subscribe(actionHandlers, handler);\n    },\n    sendResult(result) {\n      // Client answers → server receives\n      resultHandlers.forEach((h) => h(result));\n    },\n    onResult: unsubscribed, // Client doesn't receive results\n    pushObservation(update: OUIObservationUpdate) {\n      // Client pushes → server receives\n      observationHandlers.forEach((h) => h(update));\n    },\n    onObservation: unsubscribed, // 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: unsubscribed,\n    onSurfaceDeregister: unsubscribed,\n    get connected() {\n      return true;\n    },\n    async connect() {},\n    disconnect: noop,\n    onConnectionChange: unsubscribed,\n    dispose: noop,\n  };\n\n  return { server, client };\n}\n"]}