@agent-surface/react 0.13.0 → 0.16.0

package/README.md

@@ -1,48 +1,12 @@
-# @agent-surface/react
+# `@agent-surface/react`
 
-React bindings for [agent-surface](https://github.com/Wiseair-srl/agent-surface): lifecycle-correct hooks that tie capability registrations to component mounts. Registration happens once per mount in an effect; handlers are read through a ref at invocation time — no dependency arrays, no `useCallback`, no stale closures. Strict Mode, Suspense, SSR and concurrent rendering all work without special cases.
-
-Docs: https://agent-surface-docs.vercel.app
-
-## Install
-
-```bash
-pnpm add @agent-surface/core @agent-surface/react
-```
-
-## Use
+Lifecycle-correct runtime bindings for compiler-generated contracts.
 
 ```tsx
-import { AgentSurfaceProvider, useAgentComponent, usePendingConfirmations } from "@agent-surface/react";
-import { action, observation } from "@agent-surface/core";
-
-function DevicesTable() {
-  const [selectedIds, setSelectedIds] = useState<string[]>([]);
-  useAgentComponent({
-    type: "devices.table",
-    description: "Table of the devices visible on the current page",
-    observations: {
-      readState: observation({
-        description: "Visible rows and selection",
-        output: TableStateSchema,
-        read: () => ({ visibleRows, selectedIds }),
-      }),
-    },
-    actions: {
-      selectRows: action({
-        description: "Replace the current row selection",
-        input: SelectRowsSchema,
-        effect: "local-state",
-        execute: ({ ids }) => setSelectedIds(ids),
-      }),
-    },
-  });
-  return <Table />;
-}
+useAgentComponent(devicesTableContract, {
+  observations: { readState: { read: () => state } },
+  actions: { selectRows: { execute: ({ ids }) => setSelected(ids) } },
+});
 ```
 
-While mounted, an agent sees two typed capabilities; on unmount they are gone and late invocations fail with typed `COMPONENT_UNMOUNTED`. Availability (`when`, `enabled`) is re-evaluated per commit and pushed to the registry.
-
-Full specification: [docs](https://github.com/Wiseair-srl/agent-surface/tree/main/docs).
-
-MIT © Wiseair S.r.l.
+Static identity/governance stays in the contract; handlers, state and availability stay in React. See [React API](../../docs/04-react-api.md).

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { AgentSurfaceRegistry, AgentComponentDefinition, PendingConfirmation, JsonValue, AgentActionDefinition, AgentObservationDefinition } from '@agent-surface/core';
+import { AgentSurfaceRegistry, AgentComponentDefinition, AgentComponentContract, AgentComponentRuntimeBindings, PendingConfirmation, JsonValue, AgentActionDefinition, AgentObservationDefinition } from '@agent-surface/core';
 
 interface AgentSurfaceProviderProps {
     registry: AgentSurfaceRegistry;
@@ -35,6 +35,8 @@ interface AgentComponentHandle {
  * stale closures. Structure is frozen per registration (D2): changing it on a
  * live registration logs an error and re-registers.
  */
+declare function useAgentComponent<TObservations extends Record<string, any>, TActions extends Record<string, any>>(contract: AgentComponentContract<TObservations, TActions>, bindings: AgentComponentRuntimeBindings<TObservations, TActions>): AgentComponentHandle;
+/** @deprecated Use a compiler-generated contract plus runtime bindings. */
 declare function useAgentComponent(config: UseAgentComponentConfig): AgentComponentHandle;
 
 interface PendingConfirmationView extends PendingConfirmation {

package/dist/index.js

@@ -18,6 +18,7 @@ function useAgentSurface() {
 
 // src/use-agent-component.ts
 import { useEffect, useRef, useState } from "react";
+import { COMPILED_CAPABILITY_PROVENANCE } from "@agent-surface/core";
 
 // src/render-scope.ts
 var current = null;
@@ -33,7 +34,10 @@ function readRenderScopeContext() {
 }
 
 // src/use-agent-component.ts
-function useAgentComponent(config) {
+function useAgentComponent(contractOrConfig, runtimeBindings) {
+  const config = "kind" in contractOrConfig && contractOrConfig.kind === "agent-component-contract" ? contractOrConfig.bind(
+    runtimeBindings ?? {}
+  ) : contractOrConfig;
   const registry = useAgentSurface();
   const type = config.type;
   const instanceId = config.instanceId ?? "default";
@@ -134,7 +138,7 @@ function buildDelegatingDefinition(latest) {
       ...act.timeoutMs !== void 0 ? { timeoutMs: act.timeoutMs } : {}
     };
   }
-  return {
+  const definition = {
     type: cfg.type,
     ...cfg.instanceId !== void 0 ? { instanceId: cfg.instanceId } : {},
     description: cfg.description,
@@ -148,6 +152,14 @@ function buildDelegatingDefinition(latest) {
     ...Object.keys(observations).length > 0 ? { observations } : {},
     ...Object.keys(actions).length > 0 ? { actions } : {}
   };
+  const provenance = cfg[COMPILED_CAPABILITY_PROVENANCE];
+  if (provenance) {
+    Object.defineProperty(definition, COMPILED_CAPABILITY_PROVENANCE, {
+      value: provenance,
+      enumerable: false
+    });
+  }
+  return definition;
 }
 function evaluateReason(reason) {
   try {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/context.ts","../src/use-agent-component.ts","../src/render-scope.ts","../src/confirmations.ts","../src/granular.ts"],"sourcesContent":["import { createContext, createElement, useContext, type ReactNode } from \"react\";\nimport type { AgentSurfaceRegistry } from \"@agent-surface/core\";\n\nconst AgentSurfaceContext = createContext<AgentSurfaceRegistry | null>(null);\n\nexport interface AgentSurfaceProviderProps {\n  registry: AgentSurfaceRegistry;\n  children: ReactNode;\n}\n\n/**\n * The application creates the registry ONCE (module scope or top-level\n * useState initializer) and passes it down — registry creation is where\n * environment, policies, audit and route wiring live (docs/04).\n */\nexport function AgentSurfaceProvider(props: AgentSurfaceProviderProps): ReactNode {\n  return createElement(AgentSurfaceContext.Provider, { value: props.registry }, props.children);\n}\n\n/** Access the registry from context. Throws if no provider is mounted. */\nexport function useAgentSurface(): AgentSurfaceRegistry {\n  const registry = useContext(AgentSurfaceContext);\n  if (!registry) {\n    throw new Error(\n      \"useAgentSurface: no <AgentSurfaceProvider> found above this component. Wrap your app in a provider with an explicitly created registry.\",\n    );\n  }\n  return registry;\n}\n","import { useEffect, useRef, useState } from \"react\";\nimport type {\n  AgentActionContext,\n  AgentActionDefinition,\n  AgentComponentDefinition,\n  AgentObservationDefinition,\n  AgentReadContext,\n  AgentRegistrationHandle,\n  JsonValue,\n} from \"@agent-surface/core\";\nimport { useAgentSurface } from \"./context.js\";\nimport { setRenderScopeContext } from \"./render-scope.js\";\n\nexport interface UseAgentComponentConfig\n  extends Omit<AgentComponentDefinition, \"procedures\"> {\n  /**\n   * Gate for \"mounted but not presented\" (inactive tab, keep-alive, exit\n   * animation). false ⇒ all capabilities visible-disabled. Default true.\n   */\n  enabled?: boolean;\n}\n\nexport interface AgentComponentHandle {\n  /** Current registrationId; changes on remount/re-register. */\n  registrationId: string | undefined;\n  status: \"active\" | \"rejected\" | \"unregistered\" | \"pending\";\n}\n\n/**\n * One aggregated hook per agent component (docs/04, the recommended default):\n * one registration, one atomic descriptor, one lifecycle.\n *\n * Registration happens once per mount, in an effect; handlers are read through\n * a ref at invocation time (D3) — no dependency arrays, no useCallback, no\n * stale closures. Structure is frozen per registration (D2): changing it on a\n * live registration logs an error and re-registers.\n */\nexport function useAgentComponent(config: UseAgentComponentConfig): AgentComponentHandle {\n  const registry = useAgentSurface();\n  const type = config.type;\n  const instanceId = config.instanceId ?? \"default\";\n\n  // D3 latest-ref: every render writes the fresh config; the registered\n  // definition's handlers delegate through it at invocation time.\n  const latest = useRef(config);\n  latest.current = config;\n\n  // Record the render-scope link for a following useAgentProcedure call.\n  setRenderScopeContext({ type, instanceId });\n\n  const [nonce, setNonce] = useState(0);\n  const handleRef = useRef<AgentRegistrationHandle | null>(null);\n  const fingerprintRef = useRef<string | null>(null);\n  const lastPushedAvailability = useRef<Record<string, { available: boolean; reason?: string }>>({});\n  const lastPushedEnabled = useRef<boolean | null>(null);\n  const [state, setState] = useState<AgentComponentHandle>({\n    registrationId: undefined,\n    status: \"pending\",\n  });\n\n  useEffect(() => {\n    const definition = buildDelegatingDefinition(latest);\n    const handle = registry.register(definition);\n    handleRef.current = handle;\n    fingerprintRef.current = structuralFingerprint(latest.current);\n    lastPushedAvailability.current = {};\n    lastPushedEnabled.current = latest.current.enabled !== false;\n    const registrationId = handle.status === \"active\" ? handle.registrationId : undefined;\n    const status = handle.status === \"active\" ? \"active\" : \"rejected\";\n    setState((prev) =>\n      prev.registrationId === registrationId && prev.status === status\n        ? prev\n        : { registrationId, status },\n    );\n    if (handle.status === \"active\") {\n      pushAvailability(handle, latest.current, lastPushedAvailability, lastPushedEnabled);\n    }\n    return () => {\n      handle.unregister();\n      handleRef.current = null;\n      fingerprintRef.current = null;\n    };\n    // Identity keys: (registry, type, instanceId) + explicit re-register nonce.\n  }, [registry, type, instanceId, nonce]);\n\n  // Availability is reactive (docs/04): re-evaluated on every commit and\n  // PUSHED on change, so the surface version bumps and adapters refresh.\n  useEffect(() => {\n    const handle = handleRef.current;\n    if (!handle || handle.status !== \"active\") return;\n    const fingerprint = structuralFingerprint(latest.current);\n    if (fingerprintRef.current !== null && fingerprint !== fingerprintRef.current) {\n      // Structural change on a live registration violates D2. Re-register so\n      // the surface never lies about what this registrationId can do.\n      // eslint-disable-next-line no-console\n      console.error(\n        `[agent-surface] structural config change detected on live registration \"${type}\" (${instanceId}). ` +\n          \"Structure (names, schemas, descriptions, effects, policies) is frozen per registration (D2); \" +\n          \"keep it static per mount and put dynamism in when/enabled/handlers. Re-registering with a new registrationId.\",\n      );\n      setNonce((n) => n + 1);\n      return;\n    }\n    pushAvailability(handle, latest.current, lastPushedAvailability, lastPushedEnabled);\n  });\n\n  return state;\n}\n\n/* ────────────────────────────── internals ────────────────────────────── */\n\ntype LatestRef = { current: UseAgentComponentConfig };\n\nfunction buildDelegatingDefinition(latest: LatestRef): AgentComponentDefinition {\n  const cfg = latest.current;\n  const observations: Record<string, AgentObservationDefinition<any>> = {};\n  for (const [name, obs] of Object.entries(cfg.observations ?? {})) {\n    observations[name] = {\n      description: obs.description,\n      output: obs.output,\n      read: (ctx: AgentReadContext) => {\n        const live = latest.current.observations?.[name];\n        if (!live) throw new Error(`observation \"${name}\" disappeared from the config`);\n        return live.read(ctx);\n      },\n      ...(obs.when !== undefined\n        ? { when: () => latest.current.observations?.[name]?.when?.() !== false }\n        : {}),\n      ...(obs.unavailableReason !== undefined\n        ? {\n            unavailableReason: () =>\n              evaluateReason(latest.current.observations?.[name]?.unavailableReason),\n          }\n        : {}),\n      ...(obs.policies ? { policies: obs.policies } : {}),\n      ...(obs.meta ? { meta: obs.meta } : {}),\n      ...(obs.timeoutMs !== undefined ? { timeoutMs: obs.timeoutMs } : {}),\n    };\n  }\n  const actions: Record<string, AgentActionDefinition<any, any>> = {};\n  for (const [name, act] of Object.entries(cfg.actions ?? {})) {\n    actions[name] = {\n      description: act.description,\n      input: act.input,\n      ...(act.output ? { output: act.output } : {}),\n      effect: act.effect,\n      ...(act.idempotent !== undefined ? { idempotent: act.idempotent } : {}),\n      ...(act.reversible !== undefined ? { reversible: act.reversible } : {}),\n      ...(act.confirmation !== undefined ? { confirmation: act.confirmation } : {}),\n      ...(act.audit !== undefined ? { audit: act.audit } : {}),\n      ...(act.when !== undefined\n        ? { when: () => latest.current.actions?.[name]?.when?.() !== false }\n        : {}),\n      ...(act.unavailableReason !== undefined\n        ? {\n            unavailableReason: () =>\n              evaluateReason(latest.current.actions?.[name]?.unavailableReason),\n          }\n        : {}),\n      ...(act.precondition !== undefined\n        ? {\n            precondition: (input: JsonValue, ctx: AgentReadContext) =>\n              latest.current.actions?.[name]?.precondition?.(input, ctx),\n          }\n        : {}),\n      execute: (input: JsonValue, ctx: AgentActionContext) => {\n        const live = latest.current.actions?.[name];\n        if (!live) throw new Error(`action \"${name}\" disappeared from the config`);\n        return live.execute(input, ctx);\n      },\n      ...(act.policies ? { policies: act.policies } : {}),\n      ...(act.meta ? { meta: act.meta } : {}),\n      ...(act.timeoutMs !== undefined ? { timeoutMs: act.timeoutMs } : {}),\n    };\n  }\n  return {\n    type: cfg.type,\n    ...(cfg.instanceId !== undefined ? { instanceId: cfg.instanceId } : {}),\n    description: cfg.description,\n    ...(cfg.parent ? { parent: cfg.parent } : {}),\n    ...(cfg.meta ? { meta: cfg.meta } : {}),\n    ...(cfg.internal ? { internal: cfg.internal } : {}),\n    ...(cfg.policies ? { policies: cfg.policies } : {}),\n    ...(cfg.origin !== undefined ? { origin: cfg.origin } : {}),\n    ...(cfg.priority !== undefined ? { priority: cfg.priority } : {}),\n    ...(cfg.enabled !== undefined ? { enabled: cfg.enabled } : {}),\n    ...(Object.keys(observations).length > 0 ? { observations } : {}),\n    ...(Object.keys(actions).length > 0 ? { actions } : {}),\n  };\n}\n\nfunction evaluateReason(\n  reason: string | (() => string) | undefined,\n): string {\n  try {\n    if (typeof reason === \"function\") return reason();\n    if (typeof reason === \"string\") return reason;\n  } catch {\n    /* fall through */\n  }\n  return \"Currently unavailable\";\n}\n\n/** Structural fingerprint per D2 (handlers and when() results excluded). */\nfunction structuralFingerprint(cfg: UseAgentComponentConfig): string {\n  const capability = (\n    def:\n      | AgentObservationDefinition<any>\n      | AgentActionDefinition<any, any>,\n  ): unknown => ({\n    description: def.description,\n    output: \"output\" in def && def.output ? def.output.jsonSchema : undefined,\n    input: \"input\" in def ? def.input.jsonSchema : undefined,\n    effect: \"effect\" in def ? def.effect : undefined,\n    idempotent: \"idempotent\" in def ? def.idempotent : undefined,\n    reversible: \"reversible\" in def ? def.reversible : undefined,\n    confirmation: \"confirmation\" in def ? def.confirmation : undefined,\n    audit: \"audit\" in def ? def.audit : undefined,\n    timeoutMs: def.timeoutMs,\n    hasWhen: def.when !== undefined,\n    hasPrecondition: \"precondition\" in def && def.precondition !== undefined,\n    policies: (def.policies ?? []).map((p) => p.name),\n  });\n  return JSON.stringify({\n    type: cfg.type,\n    instanceId: cfg.instanceId ?? \"default\",\n    description: cfg.description,\n    parent: cfg.parent,\n    meta: cfg.meta,\n    origin: cfg.origin,\n    priority: cfg.priority,\n    policies: (cfg.policies ?? []).map((p) => p.name),\n    observations: Object.fromEntries(\n      Object.entries(cfg.observations ?? {}).map(([name, def]) => [name, capability(def)]),\n    ),\n    actions: Object.fromEntries(\n      Object.entries(cfg.actions ?? {}).map(([name, def]) => [name, capability(def)]),\n    ),\n  });\n}\n\nfunction pushAvailability(\n  handle: AgentRegistrationHandle,\n  cfg: UseAgentComponentConfig,\n  lastPushed: { current: Record<string, { available: boolean; reason?: string }> },\n  lastEnabled: { current: boolean | null },\n): void {\n  const patch: {\n    enabled?: boolean;\n    availability?: Record<string, { available: boolean; reason?: string }>;\n  } = {};\n\n  const enabled = cfg.enabled !== false;\n  if (lastEnabled.current !== enabled) {\n    patch.enabled = enabled;\n    lastEnabled.current = enabled;\n  }\n\n  const availability: Record<string, { available: boolean; reason?: string }> = {};\n  const evaluate = (\n    name: string,\n    def: { when?: () => boolean; unavailableReason?: string | (() => string) },\n  ): void => {\n    if (!def.when) return; // no predicate ⇒ availability governed by enabled only\n    let available = true;\n    try {\n      available = def.when() !== false;\n    } catch {\n      available = false;\n    }\n    const entry = available\n      ? { available: true as const }\n      : { available: false as const, reason: evaluateReason(def.unavailableReason) };\n    const prev = lastPushed.current[name];\n    if (!prev || prev.available !== entry.available || prev.reason !== entry.reason) {\n      availability[name] = entry;\n      lastPushed.current[name] = entry;\n    }\n  };\n  for (const [name, def] of Object.entries(cfg.observations ?? {})) evaluate(name, def);\n  for (const [name, def] of Object.entries(cfg.actions ?? {})) evaluate(name, def);\n\n  if (Object.keys(availability).length > 0) patch.availability = availability;\n  if (patch.enabled !== undefined || patch.availability) handle.update(patch);\n}\n","/**\n * Best-effort render-scope link between useAgentComponent and a following\n * useAgentProcedure in the SAME component function (docs/05): the component\n * hook records its identity during render; the procedure hook reads it.\n *\n * React exposes no public per-instance identity shared across independent\n * hook calls, so this is a heuristic: it is precise for the canonical\n * pattern (both hooks in one component) and clears itself at the end of the\n * synchronous render pass. A sibling component rendering later in the same\n * pass with only useAgentProcedure may pick up a stale link — cosmetic only\n * (the link is descriptor metadata, never authority).\n */\n\nexport interface RenderScopeContext {\n  type: string;\n  instanceId: string;\n}\n\ninterface Slot {\n  context: RenderScopeContext;\n  token: object;\n}\n\nlet current: Slot | null = null;\n\nexport function setRenderScopeContext(context: RenderScopeContext): void {\n  const token = {};\n  current = { context, token };\n  queueMicrotask(() => {\n    if (current?.token === token) current = null;\n  });\n}\n\nexport function readRenderScopeContext(): RenderScopeContext | undefined {\n  return current?.context;\n}\n","import { useEffect, useState } from \"react\";\nimport type { PendingConfirmation } from \"@agent-surface/core\";\nimport { useAgentSurface } from \"./context.js\";\n\nexport interface PendingConfirmationView extends PendingConfirmation {\n  approve(): void;\n  deny(reason?: string): void;\n}\n\n/**\n * Reactive list of pending confirmations for host-rendered dialogs. The\n * dialog is representation, not policy: approving calls\n * registry.confirmations.resolve, which mints the single-use evidence\n * (docs/04, docs/06).\n */\nexport function usePendingConfirmations(): PendingConfirmationView[] {\n  const registry = useAgentSurface();\n  const [pending, setPending] = useState<PendingConfirmation[]>(() =>\n    registry.confirmations.pending(),\n  );\n\n  useEffect(() => {\n    setPending(registry.confirmations.pending());\n    return registry.confirmations.subscribe((next) => {\n      setPending(next);\n    });\n  }, [registry]);\n\n  return pending.map((record) => ({\n    ...record,\n    approve: () => registry.confirmations.resolve(record.confirmationId, { approved: true }),\n    deny: (reason?: string) =>\n      registry.confirmations.resolve(record.confirmationId, {\n        approved: false,\n        ...(reason !== undefined ? { reason } : {}),\n      }),\n  }));\n}\n","import {\n  createContext,\n  createElement,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport type {\n  AgentActionDefinition,\n  AgentObservationDefinition,\n  JsonValue,\n} from \"@agent-surface/core\";\nimport { useAgentComponent, type UseAgentComponentConfig } from \"./use-agent-component.js\";\n\n/**\n * Granular composition — Experimental (docs/04): capabilities contributed\n * from separate files/subcomponents. Late-added capabilities are structural\n * changes, so each attach/detach re-registers the scope (new registrationId).\n * The aggregated useAgentComponent hook remains the recommended default.\n */\n\ninterface ScopeStore {\n  observations: Map<string, AgentObservationDefinition<any>>;\n  actions: Map<string, AgentActionDefinition<any, any>>;\n  bump(): void;\n  add(kind: \"observation\" | \"action\", name: string, def: unknown): () => void;\n}\n\nconst ScopeContext = createContext<ScopeStore | null>(null);\n\nexport interface AgentComponentScopeProps {\n  config: Omit<UseAgentComponentConfig, \"observations\" | \"actions\">;\n  children: ReactNode;\n}\n\n/** Establishes a component scope; children attach capabilities to it. */\nexport function AgentComponentScope(props: AgentComponentScopeProps): ReactNode {\n  const [, setVersion] = useState(0);\n  const store = useMemo<ScopeStore>(() => {\n    const observations = new Map<string, AgentObservationDefinition<any>>();\n    const actions = new Map<string, AgentActionDefinition<any, any>>();\n    const bump = (): void => setVersion((v) => v + 1);\n    return {\n      observations,\n      actions,\n      bump,\n      add(kind, name, def) {\n        const map = kind === \"observation\" ? observations : actions;\n        map.set(name, def as never);\n        bump();\n        return () => {\n          map.delete(name);\n          bump();\n        };\n      },\n    };\n  }, []);\n\n  return createElement(\n    ScopeContext.Provider,\n    { value: store },\n    createElement(ScopeRegistrar, { store, config: props.config }),\n    props.children,\n  );\n}\n\nfunction ScopeRegistrar(props: {\n  store: ScopeStore;\n  config: Omit<UseAgentComponentConfig, \"observations\" | \"actions\">;\n}): null {\n  // Child effects run before this parent effect, so attachments within one\n  // commit are coalesced into a single (re-)registration.\n  useAgentComponent({\n    ...props.config,\n    observations: Object.fromEntries(props.store.observations),\n    actions: Object.fromEntries(props.store.actions),\n  });\n  return null;\n}\n\nfunction useScope(hook: string): ScopeStore {\n  const store = useContext(ScopeContext);\n  if (!store) {\n    throw new Error(`${hook} must be used inside an <AgentComponentScope>`);\n  }\n  return store;\n}\n\nexport function useAgentAction<TIn extends JsonValue, TOut extends JsonValue | void = void>(\n  name: string,\n  def: AgentActionDefinition<TIn, TOut>,\n): void {\n  const store = useScope(\"useAgentAction\");\n  // Keep the stored definition fresh without re-registering (D3 handlers are\n  // read through the aggregated hook's latest-ref at invocation time).\n  if (store.actions.has(name)) store.actions.set(name, def as AgentActionDefinition<any, any>);\n  useEffect(() => store.add(\"action\", name, def), [store, name]);\n}\n\nexport function useAgentObservation<TOut extends JsonValue>(\n  name: string,\n  def: AgentObservationDefinition<TOut>,\n): void {\n  const store = useScope(\"useAgentObservation\");\n  if (store.observations.has(name)) {\n    store.observations.set(name, def as AgentObservationDefinition<any>);\n  }\n  useEffect(() => store.add(\"observation\", name, def), [store, name]);\n}\n"],"mappings":"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","names":["useEffect","useState","useState","useEffect","createContext","createElement","useContext","useEffect","useState","createContext","useState","createElement","useContext","useEffect"]}
+{"version":3,"sources":["../src/context.ts","../src/use-agent-component.ts","../src/render-scope.ts","../src/confirmations.ts","../src/granular.ts"],"sourcesContent":["import { createContext, createElement, useContext, type ReactNode } from \"react\";\nimport type { AgentSurfaceRegistry } from \"@agent-surface/core\";\n\nconst AgentSurfaceContext = createContext<AgentSurfaceRegistry | null>(null);\n\nexport interface AgentSurfaceProviderProps {\n  registry: AgentSurfaceRegistry;\n  children: ReactNode;\n}\n\n/**\n * The application creates the registry ONCE (module scope or top-level\n * useState initializer) and passes it down — registry creation is where\n * environment, policies, audit and route wiring live (docs/04).\n */\nexport function AgentSurfaceProvider(props: AgentSurfaceProviderProps): ReactNode {\n  return createElement(AgentSurfaceContext.Provider, { value: props.registry }, props.children);\n}\n\n/** Access the registry from context. Throws if no provider is mounted. */\nexport function useAgentSurface(): AgentSurfaceRegistry {\n  const registry = useContext(AgentSurfaceContext);\n  if (!registry) {\n    throw new Error(\n      \"useAgentSurface: no <AgentSurfaceProvider> found above this component. Wrap your app in a provider with an explicitly created registry.\",\n    );\n  }\n  return registry;\n}\n","import { useEffect, useRef, useState } from \"react\";\nimport { COMPILED_CAPABILITY_PROVENANCE } from \"@agent-surface/core\";\nimport type {\n  AgentActionContext,\n  AgentActionDefinition,\n  AgentComponentDefinition,\n  AgentObservationDefinition,\n  AgentReadContext,\n  AgentRegistrationHandle,\n  AgentComponentContract,\n  AgentComponentRuntimeBindings,\n  JsonValue,\n} from \"@agent-surface/core\";\nimport { useAgentSurface } from \"./context.js\";\nimport { setRenderScopeContext } from \"./render-scope.js\";\n\nexport interface UseAgentComponentConfig\n  extends Omit<AgentComponentDefinition, \"procedures\"> {\n  /**\n   * Gate for \"mounted but not presented\" (inactive tab, keep-alive, exit\n   * animation). false ⇒ all capabilities visible-disabled. Default true.\n   */\n  enabled?: boolean;\n}\n\nexport interface AgentComponentHandle {\n  /** Current registrationId; changes on remount/re-register. */\n  registrationId: string | undefined;\n  status: \"active\" | \"rejected\" | \"unregistered\" | \"pending\";\n}\n\n/**\n * One aggregated hook per agent component (docs/04, the recommended default):\n * one registration, one atomic descriptor, one lifecycle.\n *\n * Registration happens once per mount, in an effect; handlers are read through\n * a ref at invocation time (D3) — no dependency arrays, no useCallback, no\n * stale closures. Structure is frozen per registration (D2): changing it on a\n * live registration logs an error and re-registers.\n */\nexport function useAgentComponent<\n  TObservations extends Record<string, any>,\n  TActions extends Record<string, any>,\n>(\n  contract: AgentComponentContract<TObservations, TActions>,\n  bindings: AgentComponentRuntimeBindings<TObservations, TActions>,\n): AgentComponentHandle;\n/** @deprecated Use a compiler-generated contract plus runtime bindings. */\nexport function useAgentComponent(config: UseAgentComponentConfig): AgentComponentHandle;\nexport function useAgentComponent<\n  TObservations extends Record<string, any>,\n  TActions extends Record<string, any>,\n>(\n  contractOrConfig: AgentComponentContract<TObservations, TActions> | UseAgentComponentConfig,\n  runtimeBindings?: AgentComponentRuntimeBindings<TObservations, TActions>,\n): AgentComponentHandle {\n  const config: UseAgentComponentConfig =\n    \"kind\" in contractOrConfig && contractOrConfig.kind === \"agent-component-contract\"\n      ? contractOrConfig.bind(\n          (runtimeBindings ?? {}) as AgentComponentRuntimeBindings<TObservations, TActions>,\n        ) as UseAgentComponentConfig\n      : contractOrConfig;\n  const registry = useAgentSurface();\n  const type = config.type;\n  const instanceId = config.instanceId ?? \"default\";\n\n  // D3 latest-ref: every render writes the fresh config; the registered\n  // definition's handlers delegate through it at invocation time.\n  const latest = useRef(config);\n  latest.current = config;\n\n  // Record the render-scope link for a following useAgentProcedure call.\n  setRenderScopeContext({ type, instanceId });\n\n  const [nonce, setNonce] = useState(0);\n  const handleRef = useRef<AgentRegistrationHandle | null>(null);\n  const fingerprintRef = useRef<string | null>(null);\n  const lastPushedAvailability = useRef<Record<string, { available: boolean; reason?: string }>>({});\n  const lastPushedEnabled = useRef<boolean | null>(null);\n  const [state, setState] = useState<AgentComponentHandle>({\n    registrationId: undefined,\n    status: \"pending\",\n  });\n\n  useEffect(() => {\n    const definition = buildDelegatingDefinition(latest);\n    const handle = registry.register(definition);\n    handleRef.current = handle;\n    fingerprintRef.current = structuralFingerprint(latest.current);\n    lastPushedAvailability.current = {};\n    lastPushedEnabled.current = latest.current.enabled !== false;\n    const registrationId = handle.status === \"active\" ? handle.registrationId : undefined;\n    const status = handle.status === \"active\" ? \"active\" : \"rejected\";\n    setState((prev) =>\n      prev.registrationId === registrationId && prev.status === status\n        ? prev\n        : { registrationId, status },\n    );\n    if (handle.status === \"active\") {\n      pushAvailability(handle, latest.current, lastPushedAvailability, lastPushedEnabled);\n    }\n    return () => {\n      handle.unregister();\n      handleRef.current = null;\n      fingerprintRef.current = null;\n    };\n    // Identity keys: (registry, type, instanceId) + explicit re-register nonce.\n  }, [registry, type, instanceId, nonce]);\n\n  // Availability is reactive (docs/04): re-evaluated on every commit and\n  // PUSHED on change, so the surface version bumps and adapters refresh.\n  useEffect(() => {\n    const handle = handleRef.current;\n    if (!handle || handle.status !== \"active\") return;\n    const fingerprint = structuralFingerprint(latest.current);\n    if (fingerprintRef.current !== null && fingerprint !== fingerprintRef.current) {\n      // Structural change on a live registration violates D2. Re-register so\n      // the surface never lies about what this registrationId can do.\n      // eslint-disable-next-line no-console\n      console.error(\n        `[agent-surface] structural config change detected on live registration \"${type}\" (${instanceId}). ` +\n          \"Structure (names, schemas, descriptions, effects, policies) is frozen per registration (D2); \" +\n          \"keep it static per mount and put dynamism in when/enabled/handlers. Re-registering with a new registrationId.\",\n      );\n      setNonce((n) => n + 1);\n      return;\n    }\n    pushAvailability(handle, latest.current, lastPushedAvailability, lastPushedEnabled);\n  });\n\n  return state;\n}\n\n/* ────────────────────────────── internals ────────────────────────────── */\n\ntype LatestRef = { current: UseAgentComponentConfig };\n\nfunction buildDelegatingDefinition(latest: LatestRef): AgentComponentDefinition {\n  const cfg = latest.current;\n  const observations: Record<string, AgentObservationDefinition<any>> = {};\n  for (const [name, obs] of Object.entries(cfg.observations ?? {})) {\n    observations[name] = {\n      description: obs.description,\n      output: obs.output,\n      read: (ctx: AgentReadContext) => {\n        const live = latest.current.observations?.[name];\n        if (!live) throw new Error(`observation \"${name}\" disappeared from the config`);\n        return live.read(ctx);\n      },\n      ...(obs.when !== undefined\n        ? { when: () => latest.current.observations?.[name]?.when?.() !== false }\n        : {}),\n      ...(obs.unavailableReason !== undefined\n        ? {\n            unavailableReason: () =>\n              evaluateReason(latest.current.observations?.[name]?.unavailableReason),\n          }\n        : {}),\n      ...(obs.policies ? { policies: obs.policies } : {}),\n      ...(obs.meta ? { meta: obs.meta } : {}),\n      ...(obs.timeoutMs !== undefined ? { timeoutMs: obs.timeoutMs } : {}),\n    };\n  }\n  const actions: Record<string, AgentActionDefinition<any, any>> = {};\n  for (const [name, act] of Object.entries(cfg.actions ?? {})) {\n    actions[name] = {\n      description: act.description,\n      input: act.input,\n      ...(act.output ? { output: act.output } : {}),\n      effect: act.effect,\n      ...(act.idempotent !== undefined ? { idempotent: act.idempotent } : {}),\n      ...(act.reversible !== undefined ? { reversible: act.reversible } : {}),\n      ...(act.confirmation !== undefined ? { confirmation: act.confirmation } : {}),\n      ...(act.audit !== undefined ? { audit: act.audit } : {}),\n      ...(act.when !== undefined\n        ? { when: () => latest.current.actions?.[name]?.when?.() !== false }\n        : {}),\n      ...(act.unavailableReason !== undefined\n        ? {\n            unavailableReason: () =>\n              evaluateReason(latest.current.actions?.[name]?.unavailableReason),\n          }\n        : {}),\n      ...(act.precondition !== undefined\n        ? {\n            precondition: (input: JsonValue, ctx: AgentReadContext) =>\n              latest.current.actions?.[name]?.precondition?.(input, ctx),\n          }\n        : {}),\n      execute: (input: JsonValue, ctx: AgentActionContext) => {\n        const live = latest.current.actions?.[name];\n        if (!live) throw new Error(`action \"${name}\" disappeared from the config`);\n        return live.execute(input, ctx);\n      },\n      ...(act.policies ? { policies: act.policies } : {}),\n      ...(act.meta ? { meta: act.meta } : {}),\n      ...(act.timeoutMs !== undefined ? { timeoutMs: act.timeoutMs } : {}),\n    };\n  }\n  const definition: AgentComponentDefinition = {\n    type: cfg.type,\n    ...(cfg.instanceId !== undefined ? { instanceId: cfg.instanceId } : {}),\n    description: cfg.description,\n    ...(cfg.parent ? { parent: cfg.parent } : {}),\n    ...(cfg.meta ? { meta: cfg.meta } : {}),\n    ...(cfg.internal ? { internal: cfg.internal } : {}),\n    ...(cfg.policies ? { policies: cfg.policies } : {}),\n    ...(cfg.origin !== undefined ? { origin: cfg.origin } : {}),\n    ...(cfg.priority !== undefined ? { priority: cfg.priority } : {}),\n    ...(cfg.enabled !== undefined ? { enabled: cfg.enabled } : {}),\n    ...(Object.keys(observations).length > 0 ? { observations } : {}),\n    ...(Object.keys(actions).length > 0 ? { actions } : {}),\n  };\n  const provenance = (cfg as UseAgentComponentConfig & {\n    [COMPILED_CAPABILITY_PROVENANCE]?: unknown;\n  })[COMPILED_CAPABILITY_PROVENANCE];\n  if (provenance) {\n    Object.defineProperty(definition, COMPILED_CAPABILITY_PROVENANCE, {\n      value: provenance,\n      enumerable: false,\n    });\n  }\n  return definition;\n}\n\nfunction evaluateReason(\n  reason: string | (() => string) | undefined,\n): string {\n  try {\n    if (typeof reason === \"function\") return reason();\n    if (typeof reason === \"string\") return reason;\n  } catch {\n    /* fall through */\n  }\n  return \"Currently unavailable\";\n}\n\n/** Structural fingerprint per D2 (handlers and when() results excluded). */\nfunction structuralFingerprint(cfg: UseAgentComponentConfig): string {\n  const capability = (\n    def:\n      | AgentObservationDefinition<any>\n      | AgentActionDefinition<any, any>,\n  ): unknown => ({\n    description: def.description,\n    output: \"output\" in def && def.output ? def.output.jsonSchema : undefined,\n    input: \"input\" in def ? def.input.jsonSchema : undefined,\n    effect: \"effect\" in def ? def.effect : undefined,\n    idempotent: \"idempotent\" in def ? def.idempotent : undefined,\n    reversible: \"reversible\" in def ? def.reversible : undefined,\n    confirmation: \"confirmation\" in def ? def.confirmation : undefined,\n    audit: \"audit\" in def ? def.audit : undefined,\n    timeoutMs: def.timeoutMs,\n    hasWhen: def.when !== undefined,\n    hasPrecondition: \"precondition\" in def && def.precondition !== undefined,\n    policies: (def.policies ?? []).map((p) => p.name),\n  });\n  return JSON.stringify({\n    type: cfg.type,\n    instanceId: cfg.instanceId ?? \"default\",\n    description: cfg.description,\n    parent: cfg.parent,\n    meta: cfg.meta,\n    origin: cfg.origin,\n    priority: cfg.priority,\n    policies: (cfg.policies ?? []).map((p) => p.name),\n    observations: Object.fromEntries(\n      Object.entries(cfg.observations ?? {}).map(([name, def]) => [name, capability(def)]),\n    ),\n    actions: Object.fromEntries(\n      Object.entries(cfg.actions ?? {}).map(([name, def]) => [name, capability(def)]),\n    ),\n  });\n}\n\nfunction pushAvailability(\n  handle: AgentRegistrationHandle,\n  cfg: UseAgentComponentConfig,\n  lastPushed: { current: Record<string, { available: boolean; reason?: string }> },\n  lastEnabled: { current: boolean | null },\n): void {\n  const patch: {\n    enabled?: boolean;\n    availability?: Record<string, { available: boolean; reason?: string }>;\n  } = {};\n\n  const enabled = cfg.enabled !== false;\n  if (lastEnabled.current !== enabled) {\n    patch.enabled = enabled;\n    lastEnabled.current = enabled;\n  }\n\n  const availability: Record<string, { available: boolean; reason?: string }> = {};\n  const evaluate = (\n    name: string,\n    def: { when?: () => boolean; unavailableReason?: string | (() => string) },\n  ): void => {\n    if (!def.when) return; // no predicate ⇒ availability governed by enabled only\n    let available = true;\n    try {\n      available = def.when() !== false;\n    } catch {\n      available = false;\n    }\n    const entry = available\n      ? { available: true as const }\n      : { available: false as const, reason: evaluateReason(def.unavailableReason) };\n    const prev = lastPushed.current[name];\n    if (!prev || prev.available !== entry.available || prev.reason !== entry.reason) {\n      availability[name] = entry;\n      lastPushed.current[name] = entry;\n    }\n  };\n  for (const [name, def] of Object.entries(cfg.observations ?? {})) evaluate(name, def);\n  for (const [name, def] of Object.entries(cfg.actions ?? {})) evaluate(name, def);\n\n  if (Object.keys(availability).length > 0) patch.availability = availability;\n  if (patch.enabled !== undefined || patch.availability) handle.update(patch);\n}\n","/**\n * Best-effort render-scope link between useAgentComponent and a following\n * useAgentProcedure in the SAME component function (docs/05): the component\n * hook records its identity during render; the procedure hook reads it.\n *\n * React exposes no public per-instance identity shared across independent\n * hook calls, so this is a heuristic: it is precise for the canonical\n * pattern (both hooks in one component) and clears itself at the end of the\n * synchronous render pass. A sibling component rendering later in the same\n * pass with only useAgentProcedure may pick up a stale link — cosmetic only\n * (the link is descriptor metadata, never authority).\n */\n\nexport interface RenderScopeContext {\n  type: string;\n  instanceId: string;\n}\n\ninterface Slot {\n  context: RenderScopeContext;\n  token: object;\n}\n\nlet current: Slot | null = null;\n\nexport function setRenderScopeContext(context: RenderScopeContext): void {\n  const token = {};\n  current = { context, token };\n  queueMicrotask(() => {\n    if (current?.token === token) current = null;\n  });\n}\n\nexport function readRenderScopeContext(): RenderScopeContext | undefined {\n  return current?.context;\n}\n","import { useEffect, useState } from \"react\";\nimport type { PendingConfirmation } from \"@agent-surface/core\";\nimport { useAgentSurface } from \"./context.js\";\n\nexport interface PendingConfirmationView extends PendingConfirmation {\n  approve(): void;\n  deny(reason?: string): void;\n}\n\n/**\n * Reactive list of pending confirmations for host-rendered dialogs. The\n * dialog is representation, not policy: approving calls\n * registry.confirmations.resolve, which mints the single-use evidence\n * (docs/04, docs/06).\n */\nexport function usePendingConfirmations(): PendingConfirmationView[] {\n  const registry = useAgentSurface();\n  const [pending, setPending] = useState<PendingConfirmation[]>(() =>\n    registry.confirmations.pending(),\n  );\n\n  useEffect(() => {\n    setPending(registry.confirmations.pending());\n    return registry.confirmations.subscribe((next) => {\n      setPending(next);\n    });\n  }, [registry]);\n\n  return pending.map((record) => ({\n    ...record,\n    approve: () => registry.confirmations.resolve(record.confirmationId, { approved: true }),\n    deny: (reason?: string) =>\n      registry.confirmations.resolve(record.confirmationId, {\n        approved: false,\n        ...(reason !== undefined ? { reason } : {}),\n      }),\n  }));\n}\n","import {\n  createContext,\n  createElement,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport type {\n  AgentActionDefinition,\n  AgentObservationDefinition,\n  JsonValue,\n} from \"@agent-surface/core\";\nimport { useAgentComponent, type UseAgentComponentConfig } from \"./use-agent-component.js\";\n\n/**\n * Granular composition — Experimental (docs/04): capabilities contributed\n * from separate files/subcomponents. Late-added capabilities are structural\n * changes, so each attach/detach re-registers the scope (new registrationId).\n * The aggregated useAgentComponent hook remains the recommended default.\n */\n\ninterface ScopeStore {\n  observations: Map<string, AgentObservationDefinition<any>>;\n  actions: Map<string, AgentActionDefinition<any, any>>;\n  bump(): void;\n  add(kind: \"observation\" | \"action\", name: string, def: unknown): () => void;\n}\n\nconst ScopeContext = createContext<ScopeStore | null>(null);\n\nexport interface AgentComponentScopeProps {\n  config: Omit<UseAgentComponentConfig, \"observations\" | \"actions\">;\n  children: ReactNode;\n}\n\n/** Establishes a component scope; children attach capabilities to it. */\nexport function AgentComponentScope(props: AgentComponentScopeProps): ReactNode {\n  const [, setVersion] = useState(0);\n  const store = useMemo<ScopeStore>(() => {\n    const observations = new Map<string, AgentObservationDefinition<any>>();\n    const actions = new Map<string, AgentActionDefinition<any, any>>();\n    const bump = (): void => setVersion((v) => v + 1);\n    return {\n      observations,\n      actions,\n      bump,\n      add(kind, name, def) {\n        const map = kind === \"observation\" ? observations : actions;\n        map.set(name, def as never);\n        bump();\n        return () => {\n          map.delete(name);\n          bump();\n        };\n      },\n    };\n  }, []);\n\n  return createElement(\n    ScopeContext.Provider,\n    { value: store },\n    createElement(ScopeRegistrar, { store, config: props.config }),\n    props.children,\n  );\n}\n\nfunction ScopeRegistrar(props: {\n  store: ScopeStore;\n  config: Omit<UseAgentComponentConfig, \"observations\" | \"actions\">;\n}): null {\n  // Child effects run before this parent effect, so attachments within one\n  // commit are coalesced into a single (re-)registration.\n  useAgentComponent({\n    ...props.config,\n    observations: Object.fromEntries(props.store.observations),\n    actions: Object.fromEntries(props.store.actions),\n  });\n  return null;\n}\n\nfunction useScope(hook: string): ScopeStore {\n  const store = useContext(ScopeContext);\n  if (!store) {\n    throw new Error(`${hook} must be used inside an <AgentComponentScope>`);\n  }\n  return store;\n}\n\nexport function useAgentAction<TIn extends JsonValue, TOut extends JsonValue | void = void>(\n  name: string,\n  def: AgentActionDefinition<TIn, TOut>,\n): void {\n  const store = useScope(\"useAgentAction\");\n  // Keep the stored definition fresh without re-registering (D3 handlers are\n  // read through the aggregated hook's latest-ref at invocation time).\n  if (store.actions.has(name)) store.actions.set(name, def as AgentActionDefinition<any, any>);\n  useEffect(() => store.add(\"action\", name, def), [store, name]);\n}\n\nexport function useAgentObservation<TOut extends JsonValue>(\n  name: string,\n  def: AgentObservationDefinition<TOut>,\n): void {\n  const store = useScope(\"useAgentObservation\");\n  if (store.observations.has(name)) {\n    store.observations.set(name, def as AgentObservationDefinition<any>);\n  }\n  useEffect(() => store.add(\"observation\", name, def), [store, name]);\n}\n"],"mappings":";;;AAAA,SAAS,eAAe,eAAe,kBAAkC;AAGzE,IAAM,sBAAsB,cAA2C,IAAI;AAYpE,SAAS,qBAAqB,OAA6C;AAChF,SAAO,cAAc,oBAAoB,UAAU,EAAE,OAAO,MAAM,SAAS,GAAG,MAAM,QAAQ;AAC9F;AAGO,SAAS,kBAAwC;AACtD,QAAM,WAAW,WAAW,mBAAmB;AAC/C,MAAI,CAAC,UAAU;AACb,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;AC5BA,SAAS,WAAW,QAAQ,gBAAgB;AAC5C,SAAS,sCAAsC;;;ACsB/C,IAAI,UAAuB;AAEpB,SAAS,sBAAsB,SAAmC;AACvE,QAAM,QAAQ,CAAC;AACf,YAAU,EAAE,SAAS,MAAM;AAC3B,iBAAe,MAAM;AACnB,QAAI,SAAS,UAAU,MAAO,WAAU;AAAA,EAC1C,CAAC;AACH;AAEO,SAAS,yBAAyD;AACvE,SAAO,SAAS;AAClB;;;ADcO,SAAS,kBAId,kBACA,iBACsB;AACtB,QAAM,SACJ,UAAU,oBAAoB,iBAAiB,SAAS,6BACpD,iBAAiB;AAAA,IACd,mBAAmB,CAAC;AAAA,EACvB,IACA;AACN,QAAM,WAAW,gBAAgB;AACjC,QAAM,OAAO,OAAO;AACpB,QAAM,aAAa,OAAO,cAAc;AAIxC,QAAM,SAAS,OAAO,MAAM;AAC5B,SAAO,UAAU;AAGjB,wBAAsB,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,CAAC;AACpC,QAAM,YAAY,OAAuC,IAAI;AAC7D,QAAM,iBAAiB,OAAsB,IAAI;AACjD,QAAM,yBAAyB,OAAgE,CAAC,CAAC;AACjG,QAAM,oBAAoB,OAAuB,IAAI;AACrD,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA+B;AAAA,IACvD,gBAAgB;AAAA,IAChB,QAAQ;AAAA,EACV,CAAC;AAED,YAAU,MAAM;AACd,UAAM,aAAa,0BAA0B,MAAM;AACnD,UAAM,SAAS,SAAS,SAAS,UAAU;AAC3C,cAAU,UAAU;AACpB,mBAAe,UAAU,sBAAsB,OAAO,OAAO;AAC7D,2BAAuB,UAAU,CAAC;AAClC,sBAAkB,UAAU,OAAO,QAAQ,YAAY;AACvD,UAAM,iBAAiB,OAAO,WAAW,WAAW,OAAO,iBAAiB;AAC5E,UAAM,SAAS,OAAO,WAAW,WAAW,WAAW;AACvD;AAAA,MAAS,CAAC,SACR,KAAK,mBAAmB,kBAAkB,KAAK,WAAW,SACtD,OACA,EAAE,gBAAgB,OAAO;AAAA,IAC/B;AACA,QAAI,OAAO,WAAW,UAAU;AAC9B,uBAAiB,QAAQ,OAAO,SAAS,wBAAwB,iBAAiB;AAAA,IACpF;AACA,WAAO,MAAM;AACX,aAAO,WAAW;AAClB,gBAAU,UAAU;AACpB,qBAAe,UAAU;AAAA,IAC3B;AAAA,EAEF,GAAG,CAAC,UAAU,MAAM,YAAY,KAAK,CAAC;AAItC,YAAU,MAAM;AACd,UAAM,SAAS,UAAU;AACzB,QAAI,CAAC,UAAU,OAAO,WAAW,SAAU;AAC3C,UAAM,cAAc,sBAAsB,OAAO,OAAO;AACxD,QAAI,eAAe,YAAY,QAAQ,gBAAgB,eAAe,SAAS;AAI7E,cAAQ;AAAA,QACN,2EAA2E,IAAI,MAAM,UAAU;AAAA,MAGjG;AACA,eAAS,CAAC,MAAM,IAAI,CAAC;AACrB;AAAA,IACF;AACA,qBAAiB,QAAQ,OAAO,SAAS,wBAAwB,iBAAiB;AAAA,EACpF,CAAC;AAED,SAAO;AACT;AAMA,SAAS,0BAA0B,QAA6C;AAC9E,QAAM,MAAM,OAAO;AACnB,QAAM,eAAgE,CAAC;AACvE,aAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,IAAI,gBAAgB,CAAC,CAAC,GAAG;AAChE,iBAAa,IAAI,IAAI;AAAA,MACnB,aAAa,IAAI;AAAA,MACjB,QAAQ,IAAI;AAAA,MACZ,MAAM,CAAC,QAA0B;AAC/B,cAAM,OAAO,OAAO,QAAQ,eAAe,IAAI;AAC/C,YAAI,CAAC,KAAM,OAAM,IAAI,MAAM,gBAAgB,IAAI,+BAA+B;AAC9E,eAAO,KAAK,KAAK,GAAG;AAAA,MACtB;AAAA,MACA,GAAI,IAAI,SAAS,SACb,EAAE,MAAM,MAAM,OAAO,QAAQ,eAAe,IAAI,GAAG,OAAO,MAAM,MAAM,IACtE,CAAC;AAAA,MACL,GAAI,IAAI,sBAAsB,SAC1B;AAAA,QACE,mBAAmB,MACjB,eAAe,OAAO,QAAQ,eAAe,IAAI,GAAG,iBAAiB;AAAA,MACzE,IACA,CAAC;AAAA,MACL,GAAI,IAAI,WAAW,EAAE,UAAU,IAAI,SAAS,IAAI,CAAC;AAAA,MACjD,GAAI,IAAI,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAAA,MACrC,GAAI,IAAI,cAAc,SAAY,EAAE,WAAW,IAAI,UAAU,IAAI,CAAC;AAAA,IACpE;AAAA,EACF;AACA,QAAM,UAA2D,CAAC;AAClE,aAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,IAAI,WAAW,CAAC,CAAC,GAAG;AAC3D,YAAQ,IAAI,IAAI;AAAA,MACd,aAAa,IAAI;AAAA,MACjB,OAAO,IAAI;AAAA,MACX,GAAI,IAAI,SAAS,EAAE,QAAQ,IAAI,OAAO,IAAI,CAAC;AAAA,MAC3C,QAAQ,IAAI;AAAA,MACZ,GAAI,IAAI,eAAe,SAAY,EAAE,YAAY,IAAI,WAAW,IAAI,CAAC;AAAA,MACrE,GAAI,IAAI,eAAe,SAAY,EAAE,YAAY,IAAI,WAAW,IAAI,CAAC;AAAA,MACrE,GAAI,IAAI,iBAAiB,SAAY,EAAE,cAAc,IAAI,aAAa,IAAI,CAAC;AAAA,MAC3E,GAAI,IAAI,UAAU,SAAY,EAAE,OAAO,IAAI,MAAM,IAAI,CAAC;AAAA,MACtD,GAAI,IAAI,SAAS,SACb,EAAE,MAAM,MAAM,OAAO,QAAQ,UAAU,IAAI,GAAG,OAAO,MAAM,MAAM,IACjE,CAAC;AAAA,MACL,GAAI,IAAI,sBAAsB,SAC1B;AAAA,QACE,mBAAmB,MACjB,eAAe,OAAO,QAAQ,UAAU,IAAI,GAAG,iBAAiB;AAAA,MACpE,IACA,CAAC;AAAA,MACL,GAAI,IAAI,iBAAiB,SACrB;AAAA,QACE,cAAc,CAAC,OAAkB,QAC/B,OAAO,QAAQ,UAAU,IAAI,GAAG,eAAe,OAAO,GAAG;AAAA,MAC7D,IACA,CAAC;AAAA,MACL,SAAS,CAAC,OAAkB,QAA4B;AACtD,cAAM,OAAO,OAAO,QAAQ,UAAU,IAAI;AAC1C,YAAI,CAAC,KAAM,OAAM,IAAI,MAAM,WAAW,IAAI,+BAA+B;AACzE,eAAO,KAAK,QAAQ,OAAO,GAAG;AAAA,MAChC;AAAA,MACA,GAAI,IAAI,WAAW,EAAE,UAAU,IAAI,SAAS,IAAI,CAAC;AAAA,MACjD,GAAI,IAAI,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAAA,MACrC,GAAI,IAAI,cAAc,SAAY,EAAE,WAAW,IAAI,UAAU,IAAI,CAAC;AAAA,IACpE;AAAA,EACF;AACA,QAAM,aAAuC;AAAA,IAC3C,MAAM,IAAI;AAAA,IACV,GAAI,IAAI,eAAe,SAAY,EAAE,YAAY,IAAI,WAAW,IAAI,CAAC;AAAA,IACrE,aAAa,IAAI;AAAA,IACjB,GAAI,IAAI,SAAS,EAAE,QAAQ,IAAI,OAAO,IAAI,CAAC;AAAA,IAC3C,GAAI,IAAI,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAAA,IACrC,GAAI,IAAI,WAAW,EAAE,UAAU,IAAI,SAAS,IAAI,CAAC;AAAA,IACjD,GAAI,IAAI,WAAW,EAAE,UAAU,IAAI,SAAS,IAAI,CAAC;AAAA,IACjD,GAAI,IAAI,WAAW,SAAY,EAAE,QAAQ,IAAI,OAAO,IAAI,CAAC;AAAA,IACzD,GAAI,IAAI,aAAa,SAAY,EAAE,UAAU,IAAI,SAAS,IAAI,CAAC;AAAA,IAC/D,GAAI,IAAI,YAAY,SAAY,EAAE,SAAS,IAAI,QAAQ,IAAI,CAAC;AAAA,IAC5D,GAAI,OAAO,KAAK,YAAY,EAAE,SAAS,IAAI,EAAE,aAAa,IAAI,CAAC;AAAA,IAC/D,GAAI,OAAO,KAAK,OAAO,EAAE,SAAS,IAAI,EAAE,QAAQ,IAAI,CAAC;AAAA,EACvD;AACA,QAAM,aAAc,IAEjB,8BAA8B;AACjC,MAAI,YAAY;AACd,WAAO,eAAe,YAAY,gCAAgC;AAAA,MAChE,OAAO;AAAA,MACP,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEA,SAAS,eACP,QACQ;AACR,MAAI;AACF,QAAI,OAAO,WAAW,WAAY,QAAO,OAAO;AAChD,QAAI,OAAO,WAAW,SAAU,QAAO;AAAA,EACzC,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAGA,SAAS,sBAAsB,KAAsC;AACnE,QAAM,aAAa,CACjB,SAGa;AAAA,IACb,aAAa,IAAI;AAAA,IACjB,QAAQ,YAAY,OAAO,IAAI,SAAS,IAAI,OAAO,aAAa;AAAA,IAChE,OAAO,WAAW,MAAM,IAAI,MAAM,aAAa;AAAA,IAC/C,QAAQ,YAAY,MAAM,IAAI,SAAS;AAAA,IACvC,YAAY,gBAAgB,MAAM,IAAI,aAAa;AAAA,IACnD,YAAY,gBAAgB,MAAM,IAAI,aAAa;AAAA,IACnD,cAAc,kBAAkB,MAAM,IAAI,eAAe;AAAA,IACzD,OAAO,WAAW,MAAM,IAAI,QAAQ;AAAA,IACpC,WAAW,IAAI;AAAA,IACf,SAAS,IAAI,SAAS;AAAA,IACtB,iBAAiB,kBAAkB,OAAO,IAAI,iBAAiB;AAAA,IAC/D,WAAW,IAAI,YAAY,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI;AAAA,EAClD;AACA,SAAO,KAAK,UAAU;AAAA,IACpB,MAAM,IAAI;AAAA,IACV,YAAY,IAAI,cAAc;AAAA,IAC9B,aAAa,IAAI;AAAA,IACjB,QAAQ,IAAI;AAAA,IACZ,MAAM,IAAI;AAAA,IACV,QAAQ,IAAI;AAAA,IACZ,UAAU,IAAI;AAAA,IACd,WAAW,IAAI,YAAY,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI;AAAA,IAChD,cAAc,OAAO;AAAA,MACnB,OAAO,QAAQ,IAAI,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAAA,IACrF;AAAA,IACA,SAAS,OAAO;AAAA,MACd,OAAO,QAAQ,IAAI,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAAA,IAChF;AAAA,EACF,CAAC;AACH;AAEA,SAAS,iBACP,QACA,KACA,YACA,aACM;AACN,QAAM,QAGF,CAAC;AAEL,QAAM,UAAU,IAAI,YAAY;AAChC,MAAI,YAAY,YAAY,SAAS;AACnC,UAAM,UAAU;AAChB,gBAAY,UAAU;AAAA,EACxB;AAEA,QAAM,eAAwE,CAAC;AAC/E,QAAM,WAAW,CACf,MACA,QACS;AACT,QAAI,CAAC,IAAI,KAAM;AACf,QAAI,YAAY;AAChB,QAAI;AACF,kBAAY,IAAI,KAAK,MAAM;AAAA,IAC7B,QAAQ;AACN,kBAAY;AAAA,IACd;AACA,UAAM,QAAQ,YACV,EAAE,WAAW,KAAc,IAC3B,EAAE,WAAW,OAAgB,QAAQ,eAAe,IAAI,iBAAiB,EAAE;AAC/E,UAAM,OAAO,WAAW,QAAQ,IAAI;AACpC,QAAI,CAAC,QAAQ,KAAK,cAAc,MAAM,aAAa,KAAK,WAAW,MAAM,QAAQ;AAC/E,mBAAa,IAAI,IAAI;AACrB,iBAAW,QAAQ,IAAI,IAAI;AAAA,IAC7B;AAAA,EACF;AACA,aAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,IAAI,gBAAgB,CAAC,CAAC,EAAG,UAAS,MAAM,GAAG;AACpF,aAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,IAAI,WAAW,CAAC,CAAC,EAAG,UAAS,MAAM,GAAG;AAE/E,MAAI,OAAO,KAAK,YAAY,EAAE,SAAS,EAAG,OAAM,eAAe;AAC/D,MAAI,MAAM,YAAY,UAAa,MAAM,aAAc,QAAO,OAAO,KAAK;AAC5E;;;AE9TA,SAAS,aAAAA,YAAW,YAAAC,iBAAgB;AAe7B,SAAS,0BAAqD;AACnE,QAAM,WAAW,gBAAgB;AACjC,QAAM,CAAC,SAAS,UAAU,IAAIC;AAAA,IAAgC,MAC5D,SAAS,cAAc,QAAQ;AAAA,EACjC;AAEA,EAAAC,WAAU,MAAM;AACd,eAAW,SAAS,cAAc,QAAQ,CAAC;AAC3C,WAAO,SAAS,cAAc,UAAU,CAAC,SAAS;AAChD,iBAAW,IAAI;AAAA,IACjB,CAAC;AAAA,EACH,GAAG,CAAC,QAAQ,CAAC;AAEb,SAAO,QAAQ,IAAI,CAAC,YAAY;AAAA,IAC9B,GAAG;AAAA,IACH,SAAS,MAAM,SAAS,cAAc,QAAQ,OAAO,gBAAgB,EAAE,UAAU,KAAK,CAAC;AAAA,IACvF,MAAM,CAAC,WACL,SAAS,cAAc,QAAQ,OAAO,gBAAgB;AAAA,MACpD,UAAU;AAAA,MACV,GAAI,WAAW,SAAY,EAAE,OAAO,IAAI,CAAC;AAAA,IAC3C,CAAC;AAAA,EACL,EAAE;AACJ;;;ACrCA;AAAA,EACE,iBAAAC;AAAA,EACA,iBAAAC;AAAA,EACA,cAAAC;AAAA,EACA,aAAAC;AAAA,EACA;AAAA,EACA,YAAAC;AAAA,OAEK;AAsBP,IAAM,eAAeC,eAAiC,IAAI;AAQnD,SAAS,oBAAoB,OAA4C;AAC9E,QAAM,CAAC,EAAE,UAAU,IAAIC,UAAS,CAAC;AACjC,QAAM,QAAQ,QAAoB,MAAM;AACtC,UAAM,eAAe,oBAAI,IAA6C;AACtE,UAAM,UAAU,oBAAI,IAA6C;AACjE,UAAM,OAAO,MAAY,WAAW,CAAC,MAAM,IAAI,CAAC;AAChD,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA,IAAI,MAAM,MAAM,KAAK;AACnB,cAAM,MAAM,SAAS,gBAAgB,eAAe;AACpD,YAAI,IAAI,MAAM,GAAY;AAC1B,aAAK;AACL,eAAO,MAAM;AACX,cAAI,OAAO,IAAI;AACf,eAAK;AAAA,QACP;AAAA,MACF;AAAA,IACF;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,SAAOC;AAAA,IACL,aAAa;AAAA,IACb,EAAE,OAAO,MAAM;AAAA,IACfA,eAAc,gBAAgB,EAAE,OAAO,QAAQ,MAAM,OAAO,CAAC;AAAA,IAC7D,MAAM;AAAA,EACR;AACF;AAEA,SAAS,eAAe,OAGf;AAGP,oBAAkB;AAAA,IAChB,GAAG,MAAM;AAAA,IACT,cAAc,OAAO,YAAY,MAAM,MAAM,YAAY;AAAA,IACzD,SAAS,OAAO,YAAY,MAAM,MAAM,OAAO;AAAA,EACjD,CAAC;AACD,SAAO;AACT;AAEA,SAAS,SAAS,MAA0B;AAC1C,QAAM,QAAQC,YAAW,YAAY;AACrC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,GAAG,IAAI,+CAA+C;AAAA,EACxE;AACA,SAAO;AACT;AAEO,SAAS,eACd,MACA,KACM;AACN,QAAM,QAAQ,SAAS,gBAAgB;AAGvC,MAAI,MAAM,QAAQ,IAAI,IAAI,EAAG,OAAM,QAAQ,IAAI,MAAM,GAAsC;AAC3F,EAAAC,WAAU,MAAM,MAAM,IAAI,UAAU,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC;AAC/D;AAEO,SAAS,oBACd,MACA,KACM;AACN,QAAM,QAAQ,SAAS,qBAAqB;AAC5C,MAAI,MAAM,aAAa,IAAI,IAAI,GAAG;AAChC,UAAM,aAAa,IAAI,MAAM,GAAsC;AAAA,EACrE;AACA,EAAAA,WAAU,MAAM,MAAM,IAAI,eAAe,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC;AACpE;","names":["useEffect","useState","useState","useEffect","createContext","createElement","useContext","useEffect","useState","createContext","useState","createElement","useContext","useEffect"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-surface/react",
-  "version": "0.13.0",
+  "version": "0.16.0",
   "description": "React bindings for agent-surface: lifecycle-correct registration hooks",
   "license": "MIT",
   "type": "module",
@@ -18,7 +18,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@agent-surface/core": "^0.13.0"
+    "@agent-surface/core": "^0.16.0"
   },
   "peerDependencies": {
     "react": ">=18.2"