@assistant-ui/core 0.2.18 → 0.2.19

package/dist/react/client/Interactables.js.map

@@ -1 +1 @@
-{"version":3,"file":"Interactables.js","names":["useState","useEffect","useCallback","useRef","useMemo","resource","useAssistantClientRef","ClientOutput","attachTransformScopes","InteractablesState","InteractableRegistration","InteractableStateSchema","InteractablePersistedState","InteractablePersistenceAdapter","toJSONSchema","toPartialJSONSchema","ModelContext","buildInteractableModelContext","PERSISTENCE_DEBOUNCE_MS","useInteractables","state","setState","definitions","persistence","clientRef","stateRef","current","subscribersRef","Set","partialSchemaCacheRef","Map","detachedStateRef","adapterRef","undefined","debounceTimerRef","ReturnType","setTimeout","syncSeqRef","hasPendingLocalChangeRef","flushResolversRef","Array","dirtyIdsRef","runPersistence","adapter","resolve","seq","dirtyIds","clear","exported","payload","id","def","Object","entries","name","prev","fromEntries","map","isPending","error","save","e","size","schedulePersistence","add","clearTimeout","exportState","result","importState","saved","entry","set","changed","setPersistenceAdapter","flush","p","Promise","push","flushIfPending","setDefState","updater","existing","setDefSelected","selected","provider","getModelContext","defs","subscribe","callback","delete","cb","modelContext","register","jsonSchema","stateSchema","console","warn","detached","get","description","initialState","_","rest","__","restPersistence","getState","setSelected","Interactables","scopes","parent","source"],"sources":["../../../src/react/client/Interactables.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useRef, useMemo } from \"react\";\nimport { resource } from \"@assistant-ui/tap\";\nimport {\n  useAssistantClientRef,\n  type ClientOutput,\n  attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type {\n  InteractablesState,\n  InteractableRegistration,\n  InteractableStateSchema,\n  InteractablePersistedState,\n  InteractablePersistenceAdapter,\n} from \"../types/scopes/interactables\";\nimport { toJSONSchema, toPartialJSONSchema } from \"assistant-stream\";\nimport { ModelContext } from \"../../store\";\nimport { buildInteractableModelContext } from \"./interactable-model-context\";\n\nconst PERSISTENCE_DEBOUNCE_MS = 500;\n\nconst useInteractables = (): ClientOutput<\"interactables\"> => {\n  const [state, setState] = useState<InteractablesState>(() => ({\n    definitions: {},\n    persistence: {},\n  }));\n\n  const clientRef = useAssistantClientRef();\n\n  const stateRef = useRef(state);\n  useEffect(() => {\n    stateRef.current = state;\n  }, [state]);\n\n  const subscribersRef = useRef(new Set<() => void>());\n  const partialSchemaCacheRef = useRef(\n    new Map<string, InteractableStateSchema>(),\n  );\n  const detachedStateRef = useRef(new Map<string, unknown>());\n\n  const adapterRef = useRef<InteractablePersistenceAdapter | undefined>(\n    undefined,\n  );\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined,\n  );\n  const syncSeqRef = useRef(0);\n  const hasPendingLocalChangeRef = useRef(false);\n  const flushResolversRef = useRef<Array<() => void>>([]);\n  const dirtyIdsRef = useRef(new Set<string>());\n\n  const runPersistence = useCallback(async () => {\n    const adapter = adapterRef.current;\n    if (!adapter) {\n      for (const resolve of flushResolversRef.current) resolve();\n      flushResolversRef.current = [];\n      return;\n    }\n\n    const seq = ++syncSeqRef.current;\n    const dirtyIds = new Set(dirtyIdsRef.current);\n    dirtyIdsRef.current.clear();\n    hasPendingLocalChangeRef.current = true;\n\n    // Snapshot before any await so unregistered definitions are still included.\n    const exported = stateRef.current.definitions;\n    const payload: InteractablePersistedState = {};\n    for (const [id, def] of Object.entries(exported)) {\n      payload[id] = { name: def.name, state: def.state };\n    }\n\n    setState((prev) => ({\n      ...prev,\n      persistence: {\n        ...prev.persistence,\n        ...Object.fromEntries(\n          [...dirtyIds].map((id) => [\n            id,\n            { isPending: true, error: undefined },\n          ]),\n        ),\n      },\n    }));\n\n    try {\n      await adapter.save(payload);\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setState((prev) => {\n          const persistence = { ...prev.persistence };\n          for (const id of dirtyIds) delete persistence[id];\n          return { ...prev, persistence };\n        });\n      }\n    } catch (e) {\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setState((prev) => ({\n          ...prev,\n          persistence: {\n            ...prev.persistence,\n            ...Object.fromEntries(\n              [...dirtyIds].map((id) => [id, { isPending: false, error: e }]),\n            ),\n          },\n        }));\n      }\n    } finally {\n      if (dirtyIdsRef.current.size > 0 && adapterRef.current) {\n        runPersistence();\n      } else {\n        for (const resolve of flushResolversRef.current) resolve();\n        flushResolversRef.current = [];\n      }\n    }\n  }, []);\n\n  const schedulePersistence = useCallback(\n    (id: string) => {\n      if (!adapterRef.current) return;\n      dirtyIdsRef.current.add(id);\n      if (debounceTimerRef.current !== undefined) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = undefined;\n        if (!hasPendingLocalChangeRef.current) {\n          runPersistence();\n        } else {\n          debounceTimerRef.current = setTimeout(() => {\n            debounceTimerRef.current = undefined;\n            runPersistence();\n          }, PERSISTENCE_DEBOUNCE_MS);\n        }\n      }, PERSISTENCE_DEBOUNCE_MS);\n    },\n    [runPersistence],\n  );\n\n  const exportState = useCallback((): InteractablePersistedState => {\n    const result: InteractablePersistedState = {};\n    for (const [id, def] of Object.entries(stateRef.current.definitions)) {\n      result[id] = { name: def.name, state: def.state };\n    }\n    return result;\n  }, []);\n\n  const importState = useCallback((saved: InteractablePersistedState) => {\n    for (const [id, entry] of Object.entries(saved)) {\n      detachedStateRef.current.set(id, entry.state);\n    }\n    setState((prev) => {\n      let changed = false;\n      const definitions = { ...prev.definitions };\n      for (const [id, entry] of Object.entries(saved)) {\n        if (definitions[id]) {\n          definitions[id] = { ...definitions[id], state: entry.state };\n          changed = true;\n        }\n      }\n      return changed ? { ...prev, definitions } : prev;\n    });\n  }, []);\n\n  const setPersistenceAdapter = useCallback(\n    (adapter: InteractablePersistenceAdapter | undefined) => {\n      adapterRef.current = adapter;\n    },\n    [],\n  );\n\n  const flush = useCallback(async () => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    if (!adapterRef.current) return;\n    if (!hasPendingLocalChangeRef.current && dirtyIdsRef.current.size === 0)\n      return;\n    const p = new Promise<void>((resolve) => {\n      flushResolversRef.current.push(resolve);\n    });\n    if (!hasPendingLocalChangeRef.current) {\n      runPersistence();\n    }\n    return p;\n  }, [runPersistence]);\n\n  const flushIfPending = useCallback(() => {\n    if (adapterRef.current && debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n      runPersistence();\n    }\n  }, [runPersistence]);\n\n  const setDefState = useCallback(\n    (id: string, updater: (prev: unknown) => unknown) => {\n      setState((prev) => {\n        const existing = prev.definitions[id];\n        if (!existing) return prev;\n        return {\n          ...prev,\n          definitions: {\n            ...prev.definitions,\n            [id]: { ...existing, state: updater(existing.state) },\n          },\n        };\n      });\n      if (stateRef.current.definitions[id]) schedulePersistence(id);\n    },\n    [schedulePersistence],\n  );\n\n  const setDefSelected = useCallback((id: string, selected: boolean) => {\n    setState((prev) => {\n      const existing = prev.definitions[id];\n      if (!existing) return prev;\n      return {\n        ...prev,\n        definitions: {\n          ...prev.definitions,\n          [id]: { ...existing, selected },\n        },\n      };\n    });\n  }, []);\n\n  const provider = useMemo(\n    () => ({\n      getModelContext: () => {\n        const defs = stateRef.current.definitions;\n        return (\n          buildInteractableModelContext(\n            defs,\n            partialSchemaCacheRef.current,\n            setDefState,\n          ) ?? {}\n        );\n      },\n      subscribe: (callback: () => void) => {\n        subscribersRef.current.add(callback);\n        return () => {\n          subscribersRef.current.delete(callback);\n        };\n      },\n    }),\n    [setDefState],\n  );\n\n  useEffect(() => {\n    for (const cb of subscribersRef.current) cb();\n  }, [state]);\n\n  useEffect(() => {\n    return clientRef.current!.modelContext().register(provider);\n  }, [clientRef, provider]);\n\n  const register = useCallback(\n    (def: InteractableRegistration) => {\n      try {\n        const jsonSchema = toJSONSchema(def.stateSchema);\n        partialSchemaCacheRef.current.set(\n          def.id,\n          toPartialJSONSchema(jsonSchema),\n        );\n      } catch (e) {\n        console.warn(\n          `[Interactables] Failed to create partial schema for \"${def.name}\". The update tool will require all fields.`,\n          e,\n        );\n      }\n\n      const detached = detachedStateRef.current.get(def.id);\n      detachedStateRef.current.delete(def.id);\n\n      setState((prev) => ({\n        ...prev,\n        definitions: {\n          ...prev.definitions,\n          [def.id]: {\n            id: def.id,\n            name: def.name,\n            description: def.description,\n            stateSchema: def.stateSchema,\n            state:\n              prev.definitions[def.id]?.state ?? detached ?? def.initialState,\n            selected: def.selected,\n          },\n        },\n      }));\n\n      return () => {\n        flushIfPending();\n        setState((prev) => {\n          const existing = prev.definitions[def.id];\n          if (existing) {\n            detachedStateRef.current.set(def.id, existing.state);\n          }\n          partialSchemaCacheRef.current.delete(def.id);\n          const { [def.id]: _, ...rest } = prev.definitions;\n          const { [def.id]: __, ...restPersistence } = prev.persistence;\n          return { ...prev, definitions: rest, persistence: restPersistence };\n        });\n      };\n    },\n    [flushIfPending],\n  );\n\n  return {\n    getState: () => state,\n    register,\n    setState: setDefState,\n    setSelected: setDefSelected,\n    exportState,\n    importState,\n    setPersistenceAdapter,\n    flush,\n  };\n};\n\nexport const Interactables = resource(useInteractables);\n\nattachTransformScopes(useInteractables, (scopes, parent) => {\n  if (!scopes.modelContext && parent.modelContext.source === null) {\n    scopes.modelContext = ModelContext();\n  }\n});\n"],"mappings":"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"}
+{"version":3,"file":"Interactables.js","names":["useState","useEffect","useCallback","useRef","useMemo","resource","useAssistantClientRef","ClientOutput","attachTransformScopes","Unstable_InteractablesState","Unstable_InteractableRegistration","Unstable_InteractablePersistedState","Unstable_InteractablePersistenceAdapter","Unstable_InteractablesConfig","toJSONSchema","toPartialJSONSchema","ModelContext","buildInteractableModelContext","PartialJSONSchema","findModelKnownState","interactableToolName","PERSISTENCE_DEBOUNCE_MS","RestorePersistedStateOptions","stash","Map","shouldStash","id","shouldApply","def","ToolCallLikePart","type","toolCallId","toolName","MessageLike","role","content","InternalInteractableRegistration","scope","hasInteractableCreateCall","messages","name","some","message","part","p","useInteractablesResource","persistence","state","setState","definitions","clientRef","stateRef","subscribersRef","Set","partialSchemaCacheRef","streamBaselinesRef","targetId","detachedAppStateRef","detachedThreadStateRef","registrationCountsRef","updateToolUIsRef","count","unsubscribe","loadedStateRef","touchedIdsRef","adapterRef","undefined","debounceTimerRef","ReturnType","setTimeout","syncSeqRef","hasPendingLocalChangeRef","flushResolversRef","Array","dirtyIdsRef","setStateAndRef","updater","prev","next","current","exportState","result","Object","entries","runPersistence","adapter","resolve","seq","dirtyIds","clear","payload","fromEntries","map","isPending","error","save","e","size","schedulePersistence","add","clearTimeout","restorePersistedState","saved","options","entry","set","changed","importState","applyLoadedState","has","loadFromAdapter","load","console","warn","setPersistenceAdapter","getCurrentThreadId","client","threadListItem","source","getState","threads","mainThreadId","flush","Promise","push","flushIfPending","setDefState","existing","provider","getModelContext","defs","subscribe","callback","delete","cb","modelContext","register","threadAccessor","thread","threadMessages","process","env","NODE_ENV","get","releaseUpdateToolUI","updateRender","toolsAccessor","tools","setToolUI","standalone","jsonSchema","stateSchema","threadId","detached","loaded","known","description","initialState","remaining","stateById","_","rest","__","restPersistence","unstable_Interactables","scopes","parent"],"sources":["../../../src/react/client/Interactables.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useRef, useMemo } from \"react\";\nimport { resource } from \"@assistant-ui/tap\";\nimport {\n  useAssistantClientRef,\n  type ClientOutput,\n  attachTransformScopes,\n} from \"@assistant-ui/store\";\nimport type {\n  Unstable_InteractablesState,\n  Unstable_InteractableRegistration,\n  Unstable_InteractablePersistedState,\n  Unstable_InteractablePersistenceAdapter,\n  Unstable_InteractablesConfig,\n} from \"../types/scopes/interactables\";\nimport { toJSONSchema, toPartialJSONSchema } from \"assistant-stream\";\nimport { ModelContext } from \"../../store\";\nimport {\n  buildInteractableModelContext,\n  type PartialJSONSchema,\n} from \"./interactable-model-context\";\nimport {\n  findModelKnownState,\n  interactableToolName,\n} from \"../../model-context/interactable-composer-metadata\";\n\nconst PERSISTENCE_DEBOUNCE_MS = 500;\n\ntype RestorePersistedStateOptions = {\n  stash: Map<string, unknown>;\n  shouldStash?: (id: string) => boolean;\n  shouldApply?: (\n    id: string,\n    def: Unstable_InteractablesState[\"definitions\"][string],\n  ) => boolean;\n};\n\ntype ToolCallLikePart = {\n  type?: string;\n  toolCallId?: string;\n  toolName?: string;\n};\n\ntype MessageLike = {\n  role?: string;\n  content?: readonly unknown[] | undefined;\n};\n\ntype InternalInteractableRegistration = Unstable_InteractableRegistration & {\n  scope?: \"thread\" | undefined;\n};\n\nconst hasInteractableCreateCall = (\n  messages: readonly MessageLike[],\n  id: string,\n  name: string,\n) =>\n  messages.some(\n    (message) =>\n      message.role === \"assistant\" &&\n      message.content?.some((part) => {\n        if (!part || typeof part !== \"object\") return false;\n        const p = part as ToolCallLikePart;\n        return (\n          p.type === \"tool-call\" && p.toolCallId === id && p.toolName === name\n        );\n      }),\n  );\n\nconst useInteractablesResource = ({\n  persistence,\n}: Unstable_InteractablesConfig = {}): ClientOutput<\"unstable_interactables\"> => {\n  const [state, setState] = useState<Unstable_InteractablesState>(() => ({\n    definitions: {},\n    persistence: {},\n  }));\n\n  const clientRef = useAssistantClientRef();\n\n  const stateRef = useRef(state);\n\n  const subscribersRef = useRef(new Set<() => void>());\n  const partialSchemaCacheRef = useRef(new Map<string, PartialJSONSchema>());\n  const streamBaselinesRef = useRef(\n    new Map<string, { targetId: string; state: unknown }>(),\n  );\n  const detachedAppStateRef = useRef(new Map<string, unknown>());\n  const detachedThreadStateRef = useRef(\n    new Map<string, Map<string, unknown>>(),\n  );\n  // An instance may be registered from several anchors (its creating tool\n  // call plus update_* calls); the definition lives until the last one leaves.\n  const registrationCountsRef = useRef(new Map<string, number>());\n  // One update-tool UI per interactable name, alive while any registrant\n  // that supplied an updateRender is mounted.\n  const updateToolUIsRef = useRef(\n    new Map<string, { count: number; unsubscribe: () => void }>(),\n  );\n  // App-scoped state restored via adapter.load(), consumed as components register.\n  const loadedStateRef = useRef(new Map<string, unknown>());\n  // Ids edited locally this session — a local edit always wins over a slow load.\n  const touchedIdsRef = useRef(new Set<string>());\n\n  const adapterRef = useRef<\n    Unstable_InteractablePersistenceAdapter | undefined\n  >(undefined);\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined,\n  );\n  const syncSeqRef = useRef(0);\n  const hasPendingLocalChangeRef = useRef(false);\n  const flushResolversRef = useRef<Array<() => void>>([]);\n  const dirtyIdsRef = useRef(new Set<string>());\n\n  const setStateAndRef = useCallback(\n    (\n      updater: (\n        prev: Unstable_InteractablesState,\n      ) => Unstable_InteractablesState,\n    ) => {\n      const next = updater(stateRef.current);\n      stateRef.current = next;\n      setState(next);\n    },\n    [],\n  );\n\n  const exportState = useCallback((): Unstable_InteractablePersistedState => {\n    const result: Unstable_InteractablePersistedState = {};\n    for (const [id, def] of Object.entries(stateRef.current.definitions)) {\n      if (def.scope === \"thread\") continue; // thread items persist via snapshot, not the adapter\n      result[id] = { name: def.name, state: def.state };\n    }\n    return result;\n  }, []);\n\n  const runPersistence = useCallback(async () => {\n    const adapter = adapterRef.current;\n    if (!adapter) {\n      for (const resolve of flushResolversRef.current) resolve();\n      flushResolversRef.current = [];\n      return;\n    }\n\n    const seq = ++syncSeqRef.current;\n    const dirtyIds = new Set(dirtyIdsRef.current);\n    dirtyIdsRef.current.clear();\n    hasPendingLocalChangeRef.current = true;\n\n    // Snapshot before any await so unregistered definitions are still included.\n    const payload = exportState();\n\n    setStateAndRef((prev) => ({\n      ...prev,\n      persistence: {\n        ...prev.persistence,\n        ...Object.fromEntries(\n          [...dirtyIds].map((id) => [\n            id,\n            { isPending: true, error: undefined },\n          ]),\n        ),\n      },\n    }));\n\n    try {\n      await adapter.save(payload);\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setStateAndRef((prev) => {\n          const persistence = { ...prev.persistence };\n          for (const id of dirtyIds) delete persistence[id];\n          return { ...prev, persistence };\n        });\n      }\n    } catch (e) {\n      if (syncSeqRef.current === seq) {\n        hasPendingLocalChangeRef.current = false;\n        setStateAndRef((prev) => ({\n          ...prev,\n          persistence: {\n            ...prev.persistence,\n            ...Object.fromEntries(\n              [...dirtyIds].map((id) => [id, { isPending: false, error: e }]),\n            ),\n          },\n        }));\n      }\n    } finally {\n      if (dirtyIdsRef.current.size > 0 && adapterRef.current) {\n        runPersistence();\n      } else {\n        for (const resolve of flushResolversRef.current) resolve();\n        flushResolversRef.current = [];\n      }\n    }\n  }, [exportState, setStateAndRef]);\n\n  const schedulePersistence = useCallback(\n    (id: string) => {\n      if (!adapterRef.current) return;\n      dirtyIdsRef.current.add(id);\n      if (debounceTimerRef.current !== undefined) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = undefined;\n        if (!hasPendingLocalChangeRef.current) {\n          runPersistence();\n        } else {\n          debounceTimerRef.current = setTimeout(() => {\n            debounceTimerRef.current = undefined;\n            runPersistence();\n          }, PERSISTENCE_DEBOUNCE_MS);\n        }\n      }, PERSISTENCE_DEBOUNCE_MS);\n    },\n    [runPersistence],\n  );\n\n  const restorePersistedState = useCallback(\n    (\n      saved: Unstable_InteractablePersistedState,\n      options: RestorePersistedStateOptions,\n    ) => {\n      const shouldStash = options.shouldStash ?? (() => true);\n      const shouldApply = options.shouldApply ?? (() => true);\n\n      for (const [id, entry] of Object.entries(saved)) {\n        if (shouldStash(id)) options.stash.set(id, entry.state);\n      }\n      setStateAndRef((prev) => {\n        let changed = false;\n        const definitions = { ...prev.definitions };\n        for (const [id, entry] of Object.entries(saved)) {\n          const def = definitions[id];\n          if (!def || !shouldApply(id, def)) continue;\n          definitions[id] = { ...def, state: entry.state };\n          changed = true;\n        }\n        if (!changed) return prev;\n        return { ...prev, definitions };\n      });\n    },\n    [setStateAndRef],\n  );\n\n  const importState = useCallback(\n    (saved: Unstable_InteractablePersistedState) => {\n      restorePersistedState(saved, { stash: detachedAppStateRef.current });\n    },\n    [restorePersistedState],\n  );\n\n  // Applies adapter.load() output: a local edit made while the load was in\n  // flight wins, and thread-scoped items never restore from the adapter.\n  const applyLoadedState = useCallback(\n    (saved: Unstable_InteractablePersistedState) => {\n      restorePersistedState(saved, {\n        stash: loadedStateRef.current,\n        shouldStash: (id) => !touchedIdsRef.current.has(id),\n        shouldApply: (id, def) =>\n          !touchedIdsRef.current.has(id) && def.scope !== \"thread\",\n      });\n    },\n    [restorePersistedState],\n  );\n\n  const loadFromAdapter = useCallback(\n    async (adapter: Unstable_InteractablePersistenceAdapter) => {\n      if (!adapter.load) return;\n      try {\n        const saved = await adapter.load();\n        if (!saved || adapterRef.current !== adapter) return;\n        applyLoadedState(saved);\n      } catch (e) {\n        console.warn(\"[Interactables] Persistence load failed.\", e);\n      }\n    },\n    [applyLoadedState],\n  );\n\n  const setPersistenceAdapter = useCallback(\n    (adapter: Unstable_InteractablePersistenceAdapter | undefined) => {\n      adapterRef.current = adapter;\n      if (adapter) void loadFromAdapter(adapter);\n    },\n    [loadFromAdapter],\n  );\n\n  const getCurrentThreadId = useCallback((): string | undefined => {\n    const client = clientRef.current;\n    if (!client) return undefined;\n\n    const threadListItem = client.threadListItem;\n    if (threadListItem.source != null) {\n      return threadListItem().getState().id;\n    }\n\n    const threads = client.threads;\n    if (threads.source != null) {\n      return threads().getState().mainThreadId;\n    }\n\n    return undefined;\n  }, [clientRef]);\n\n  useEffect(() => {\n    if (!persistence) return;\n    setPersistenceAdapter(persistence);\n    return () => {\n      if (adapterRef.current === persistence) {\n        adapterRef.current = undefined;\n      }\n    };\n  }, [persistence, setPersistenceAdapter]);\n\n  const flush = useCallback(async () => {\n    if (debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n    }\n    if (!adapterRef.current) return;\n    if (!hasPendingLocalChangeRef.current && dirtyIdsRef.current.size === 0)\n      return;\n    const p = new Promise<void>((resolve) => {\n      flushResolversRef.current.push(resolve);\n    });\n    if (!hasPendingLocalChangeRef.current) {\n      runPersistence();\n    }\n    return p;\n  }, [runPersistence]);\n\n  const flushIfPending = useCallback(() => {\n    if (adapterRef.current && debounceTimerRef.current !== undefined) {\n      clearTimeout(debounceTimerRef.current);\n      debounceTimerRef.current = undefined;\n      runPersistence();\n    }\n  }, [runPersistence]);\n\n  const setDefState = useCallback(\n    (id: string, updater: (prev: unknown) => unknown) => {\n      touchedIdsRef.current.add(id);\n      setStateAndRef((prev) => {\n        const existing = prev.definitions[id];\n        if (!existing) return prev;\n        return {\n          ...prev,\n          definitions: {\n            ...prev.definitions,\n            [id]: { ...existing, state: updater(existing.state) },\n          },\n        };\n      });\n      if (stateRef.current.definitions[id]?.scope !== \"thread\") {\n        schedulePersistence(id);\n      }\n    },\n    [schedulePersistence, setStateAndRef],\n  );\n\n  const provider = useMemo(\n    () => ({\n      getModelContext: () => {\n        const defs = stateRef.current.definitions;\n        return (\n          buildInteractableModelContext(\n            defs,\n            partialSchemaCacheRef.current,\n            setDefState,\n            streamBaselinesRef.current,\n          ) ?? {}\n        );\n      },\n      subscribe: (callback: () => void) => {\n        subscribersRef.current.add(callback);\n        return () => {\n          subscribersRef.current.delete(callback);\n        };\n      },\n    }),\n    [setDefState],\n  );\n\n  useEffect(() => {\n    for (const cb of subscribersRef.current) cb();\n  }, [state]);\n\n  useEffect(() => {\n    return clientRef.current!.modelContext().register(provider);\n  }, [clientRef, provider]);\n\n  const register = useCallback(\n    (def: InternalInteractableRegistration) => {\n      const threadAccessor = clientRef.current?.thread;\n      const threadMessages =\n        threadAccessor && threadAccessor.source != null\n          ? (threadAccessor().getState().messages ?? [])\n          : [];\n      const scope =\n        def.scope ??\n        (hasInteractableCreateCall(threadMessages, def.id, def.name)\n          ? \"thread\"\n          : \"app\");\n\n      if (\n        process.env.NODE_ENV !== \"production\" &&\n        stateRef.current.definitions[def.id] &&\n        scope !== \"thread\"\n      ) {\n        console.warn(\n          `[Interactables] \"${def.name}\" (${def.id}) is already registered. ` +\n            `Register an app-scoped interactable once (unstable_useInteractable) and ` +\n            `read it from other components with unstable_useInteractableState.`,\n        );\n      }\n\n      registrationCountsRef.current.set(\n        def.id,\n        (registrationCountsRef.current.get(def.id) ?? 0) + 1,\n      );\n\n      let releaseUpdateToolUI: (() => void) | undefined;\n      if (def.updateRender) {\n        const toolsAccessor = clientRef.current?.tools;\n        if (toolsAccessor && toolsAccessor.source != null) {\n          const toolName = interactableToolName(def.name);\n          const existing = updateToolUIsRef.current.get(def.name);\n          if (existing) {\n            existing.count++;\n          } else {\n            updateToolUIsRef.current.set(def.name, {\n              count: 1,\n              unsubscribe: toolsAccessor().setToolUI(\n                toolName,\n                def.updateRender,\n                { standalone: true },\n              ),\n            });\n          }\n          releaseUpdateToolUI = () => {\n            const entry = updateToolUIsRef.current.get(def.name);\n            if (!entry) return;\n            if (--entry.count === 0) {\n              updateToolUIsRef.current.delete(def.name);\n              entry.unsubscribe();\n            }\n          };\n        } else if (process.env.NODE_ENV !== \"production\") {\n          console.warn(\n            `[Interactables] \"${def.name}\" supplied an updateRender, but no ` +\n              `tools scope is available to install it into.`,\n          );\n        }\n      }\n\n      // The same id re-registers once per anchor (its create call + each update_*).\n      if (!partialSchemaCacheRef.current.has(def.id)) {\n        try {\n          const jsonSchema = toJSONSchema(def.stateSchema);\n          partialSchemaCacheRef.current.set(\n            def.id,\n            toPartialJSONSchema(jsonSchema),\n          );\n        } catch (e) {\n          console.warn(\n            `[Interactables] Failed to create partial schema for \"${def.name}\". The update tool will accept arbitrary fields without validation.`,\n            e,\n          );\n        }\n      }\n\n      const threadId = scope === \"thread\" ? getCurrentThreadId() : undefined;\n      const detached =\n        scope === \"thread\"\n          ? threadId\n            ? detachedThreadStateRef.current.get(threadId)?.get(def.id)\n            : undefined\n          : detachedAppStateRef.current.get(def.id);\n      if (scope === \"thread\") {\n        if (threadId)\n          detachedThreadStateRef.current.get(threadId)?.delete(def.id);\n      } else {\n        detachedAppStateRef.current.delete(def.id);\n      }\n      const loaded =\n        scope === \"thread\" ? undefined : loadedStateRef.current.get(def.id);\n\n      // Tool-created items restore from what the model already knows in this\n      // thread (the creating call's args, sent snapshots, and the model's own\n      // update_* calls) on a fresh reload; detached (in-session remount) still\n      // wins so an unsent edit survives a scroll/virtualization cycle.\n      const known =\n        scope === \"thread\"\n          ? findModelKnownState(threadMessages, def.id, def.name)\n          : undefined;\n\n      setStateAndRef((prev) => ({\n        ...prev,\n        definitions: {\n          ...prev.definitions,\n          [def.id]: {\n            id: def.id,\n            name: def.name,\n            description: def.description,\n            stateSchema: def.stateSchema,\n            initialState: def.initialState,\n            scope,\n            state:\n              prev.definitions[def.id]?.state ??\n              detached ??\n              known?.state ??\n              loaded ??\n              def.initialState,\n          },\n        },\n      }));\n\n      return () => {\n        releaseUpdateToolUI?.();\n\n        const remaining = (registrationCountsRef.current.get(def.id) ?? 1) - 1;\n        if (remaining > 0) {\n          registrationCountsRef.current.set(def.id, remaining);\n          return;\n        }\n        registrationCountsRef.current.delete(def.id);\n\n        flushIfPending();\n        setStateAndRef((prev) => {\n          const existing = prev.definitions[def.id];\n          if (existing) {\n            if (existing.scope === \"thread\") {\n              const threadId = getCurrentThreadId();\n              if (threadId) {\n                let stateById = detachedThreadStateRef.current.get(threadId);\n                if (!stateById) {\n                  stateById = new Map();\n                  detachedThreadStateRef.current.set(threadId, stateById);\n                }\n                stateById.set(def.id, existing.state);\n              }\n            } else {\n              detachedAppStateRef.current.set(def.id, existing.state);\n            }\n          }\n          partialSchemaCacheRef.current.delete(def.id);\n          const { [def.id]: _, ...rest } = prev.definitions;\n          const { [def.id]: __, ...restPersistence } = prev.persistence;\n          return { ...prev, definitions: rest, persistence: restPersistence };\n        });\n      };\n    },\n    [flushIfPending, clientRef, getCurrentThreadId, setStateAndRef],\n  );\n\n  return {\n    getState: () => stateRef.current,\n    register,\n    setState: setDefState,\n    exportState,\n    importState,\n    setPersistenceAdapter,\n    flush,\n  };\n};\n\n/**\n * Registers the unstable interactables store scope.\n *\n * @deprecated Unstable / Experimental (not actually removed).\n */\nexport const unstable_Interactables = resource(useInteractablesResource);\n\nattachTransformScopes(useInteractablesResource, (scopes, parent) => {\n  if (!scopes.modelContext && parent.modelContext.source === null) {\n    scopes.modelContext = ModelContext();\n  }\n});\n"],"mappings":";;;;;;;;AAyBA,MAAMqB,0BAA0B;AA0BhC,MAAMiB,6BACJC,UACAb,IACAc,SAEAD,SAASE,MACNC,YACCA,QAAQR,SAAS,eACjBQ,QAAQP,SAASM,MAAME,SAAS;CAC9B,IAAI,CAACA,QAAQ,OAAOA,SAAS,UAAU,OAAO;CAC9C,MAAMC,IAAID;CACV,OACEC,EAAEd,SAAS,eAAec,EAAEb,eAAeL,MAAMkB,EAAEZ,aAAaQ;AAEpE,CAAC,CACL;AAEF,MAAMK,4BAA4B,EAChCC,gBACgC,CAAC,MAA8C;CAC/E,MAAM,CAACC,OAAOC,YAAYhD,gBAA6C;EACrEiD,aAAa,CAAC;EACdH,aAAa,CAAC;CAChB,EAAE;CAEF,MAAMI,YAAY5C,sBAAsB;CAExC,MAAM6C,WAAWhD,OAAO4C,KAAK;CAE7B,MAAMK,iBAAiBjD,uBAAO,IAAIkD,IAAgB,CAAC;CACnD,MAAMC,wBAAwBnD,uBAAO,IAAIqB,IAA+B,CAAC;CACzE,MAAM+B,qBAAqBpD,uBACzB,IAAIqB,IAAkD,CACxD;CACA,MAAMiC,sBAAsBtD,uBAAO,IAAIqB,IAAqB,CAAC;CAC7D,MAAMkC,yBAAyBvD,uBAC7B,IAAIqB,IAAkC,CACxC;CAGA,MAAMmC,wBAAwBxD,uBAAO,IAAIqB,IAAoB,CAAC;CAG9D,MAAMoC,mBAAmBzD,uBACvB,IAAIqB,IAAwD,CAC9D;CAEA,MAAMuC,iBAAiB5D,uBAAO,IAAIqB,IAAqB,CAAC;CAExD,MAAMwC,gBAAgB7D,uBAAO,IAAIkD,IAAY,CAAC;CAE9C,MAAMY,aAAa9D,OAEjB+D,KAAAA,CAAS;CACX,MAAMC,mBAAmBhE,OACvB+D,KAAAA,CACF;CACA,MAAMI,aAAanE,OAAO,CAAC;CAC3B,MAAMoE,2BAA2BpE,OAAO,KAAK;CAC7C,MAAMqE,oBAAoBrE,OAA0B,CAAA,CAAE;CACtD,MAAMuE,cAAcvE,uBAAO,IAAIkD,IAAY,CAAC;CAE5C,MAAMsB,iBAAiBzE,aAEnB0E,YAGG;EACH,MAAME,OAAOF,QAAQzB,SAAS4B,OAAO;EACrC5B,SAAS4B,UAAUD;EACnB9B,SAAS8B,IAAI;CACf,GACA,CAAA,CACF;CAEA,MAAME,cAAc9E,kBAAuD;EACzE,MAAM+E,SAA8C,CAAC;EACrD,KAAK,MAAM,CAACvD,IAAIE,QAAQsD,OAAOC,QAAQhC,SAAS4B,QAAQ9B,WAAW,GAAG;GACpE,IAAIrB,IAAIS,UAAU,UAAU;GAC5B4C,OAAOvD,MAAM;IAAEc,MAAMZ,IAAIY;IAAMO,OAAOnB,IAAImB;GAAM;EAClD;EACA,OAAOkC;CACT,GAAG,CAAA,CAAE;CAEL,MAAMG,iBAAiBlF,YAAY,YAAY;EAC7C,MAAMmF,UAAUpB,WAAWc;EAC3B,IAAI,CAACM,SAAS;GACZ,KAAK,MAAMC,WAAWd,kBAAkBO,SAASO,QAAQ;GACzDd,kBAAkBO,UAAU,CAAA;GAC5B;EACF;EAEA,MAAMQ,MAAM,EAAEjB,WAAWS;EACzB,MAAMS,WAAW,IAAInC,IAAIqB,YAAYK,OAAO;EAC5CL,YAAYK,QAAQU,MAAM;EAC1BlB,yBAAyBQ,UAAU;EAGnC,MAAMW,UAAUV,YAAY;EAE5BL,gBAAgBE,UAAU;GACxB,GAAGA;GACH/B,aAAa;IACX,GAAG+B,KAAK/B;IACR,GAAGoC,OAAOS,YACR,CAAC,GAAGH,QAAQ,CAAC,CAACI,KAAKlE,SAAO,CACxBA,MACA;KAAEmE,WAAW;KAAMC,OAAO5B,KAAAA;IAAU,CAAC,CACtC,CACH;GACF;EACF,EAAE;EAEF,IAAI;GACF,MAAMmB,QAAQU,KAAKL,OAAO;GAC1B,IAAIpB,WAAWS,YAAYQ,KAAK;IAC9BhB,yBAAyBQ,UAAU;IACnCJ,gBAAgBE,WAAS;KACvB,MAAM/B,gBAAc,EAAE,GAAG+B,OAAK/B,YAAY;KAC1C,KAAK,MAAMpB,QAAM8D,UAAU,OAAO1C,cAAYpB;KAC9C,OAAO;MAAE,GAAGmD;MAAM/B,aAAAA;KAAY;IAChC,CAAC;GACH;EACF,SAASkD,GAAG;GACV,IAAI1B,WAAWS,YAAYQ,KAAK;IAC9BhB,yBAAyBQ,UAAU;IACnCJ,gBAAgBE,YAAU;KACxB,GAAGA;KACH/B,aAAa;MACX,GAAG+B,OAAK/B;MACR,GAAGoC,OAAOS,YACR,CAAC,GAAGH,QAAQ,CAAC,CAACI,KAAKlE,SAAO,CAACA,MAAI;OAAEmE,WAAW;OAAOC,OAAOE;MAAE,CAAC,CAAC,CAChE;KACF;IACF,EAAE;GACJ;EACF,UAAU;GACR,IAAItB,YAAYK,QAAQkB,OAAO,KAAKhC,WAAWc,SAC7CK,eAAe;QACV;IACL,KAAK,MAAME,WAAWd,kBAAkBO,SAASO,QAAQ;IACzDd,kBAAkBO,UAAU,CAAA;GAC9B;EACF;CACF,GAAG,CAACC,aAAaL,cAAc,CAAC;CAEhC,MAAMuB,sBAAsBhG,aACzBwB,SAAe;EACd,IAAI,CAACuC,WAAWc,SAAS;EACzBL,YAAYK,QAAQoB,IAAIzE,IAAE;EAC1B,IAAIyC,iBAAiBY,YAAYb,KAAAA,GAC/BkC,aAAajC,iBAAiBY,OAAO;EAEvCZ,iBAAiBY,UAAUV,iBAAiB;GAC1CF,iBAAiBY,UAAUb,KAAAA;GAC3B,IAAI,CAACK,yBAAyBQ,SAC5BK,eAAe;QAEfjB,iBAAiBY,UAAUV,iBAAiB;IAC1CF,iBAAiBY,UAAUb,KAAAA;IAC3BkB,eAAe;GACjB,GAAG/D,uBAAuB;EAE9B,GAAGA,uBAAuB;CAC5B,GACA,CAAC+D,cAAc,CACjB;CAEA,MAAMiB,wBAAwBnG,aAE1BoG,OACAC,YACG;EACH,MAAM9E,cAAc8E,QAAQ9E,sBAAsB;EAClD,MAAME,cAAc4E,QAAQ5E,sBAAsB;EAElD,KAAK,MAAM,CAACD,MAAI8E,UAAUtB,OAAOC,QAAQmB,KAAK,GAC5C,IAAI7E,YAAYC,IAAE,GAAG6E,QAAQhF,MAAMkF,IAAI/E,MAAI8E,MAAMzD,KAAK;EAExD4B,gBAAgBE,WAAS;GACvB,IAAI6B,UAAU;GACd,MAAMzD,cAAc,EAAE,GAAG4B,OAAK5B,YAAY;GAC1C,KAAK,MAAM,CAACvB,MAAI8E,YAAUtB,OAAOC,QAAQmB,KAAK,GAAG;IAC/C,MAAM1E,QAAMqB,YAAYvB;IACxB,IAAI,CAACE,SAAO,CAACD,YAAYD,MAAIE,KAAG,GAAG;IACnCqB,YAAYvB,QAAM;KAAE,GAAGE;KAAKmB,OAAOyD,QAAMzD;IAAM;IAC/C2D,UAAU;GACZ;GACA,IAAI,CAACA,SAAS,OAAO7B;GACrB,OAAO;IAAE,GAAGA;IAAM5B;GAAY;EAChC,CAAC;CACH,GACA,CAAC0B,cAAc,CACjB;CAEA,MAAMgC,cAAczG,aACjBoG,YAA+C;EAC9CD,sBAAsBC,SAAO,EAAE/E,OAAOkC,oBAAoBsB,QAAQ,CAAC;CACrE,GACA,CAACsB,qBAAqB,CACxB;CAIA,MAAMO,mBAAmB1G,aACtBoG,YAA+C;EAC9CD,sBAAsBC,SAAO;GAC3B/E,OAAOwC,eAAegB;GACtBtD,cAAcC,SAAO,CAACsC,cAAce,QAAQ8B,IAAInF,IAAE;GAClDC,cAAcD,MAAIE,UAChB,CAACoC,cAAce,QAAQ8B,IAAInF,IAAE,KAAKE,MAAIS,UAAU;EACpD,CAAC;CACH,GACA,CAACgE,qBAAqB,CACxB;CAEA,MAAMS,kBAAkB5G,YACtB,OAAOmF,cAAqD;EAC1D,IAAI,CAACA,UAAQ0B,MAAM;EACnB,IAAI;GACF,MAAMT,UAAQ,MAAMjB,UAAQ0B,KAAK;GACjC,IAAI,CAACT,WAASrC,WAAWc,YAAYM,WAAS;GAC9CuB,iBAAiBN,OAAK;EACxB,SAASN,KAAG;GACVgB,QAAQC,KAAK,4CAA4CjB,GAAC;EAC5D;CACF,GACA,CAACY,gBAAgB,CACnB;CAEA,MAAMM,wBAAwBhH,aAC3BmF,cAAiE;EAChEpB,WAAWc,UAAUM;EACrB,IAAIA,WAAS,gBAAqBA,SAAO;CAC3C,GACA,CAACyB,eAAe,CAClB;CAEA,MAAMK,qBAAqBjH,kBAAsC;EAC/D,MAAMkH,SAASlE,UAAU6B;EACzB,IAAI,CAACqC,QAAQ,OAAOlD,KAAAA;EAEpB,MAAMmD,iBAAiBD,OAAOC;EAC9B,IAAIA,eAAeC,UAAU,MAC3B,OAAOD,eAAe,CAAC,CAACE,SAAS,CAAC,CAAC7F;EAGrC,MAAM8F,UAAUJ,OAAOI;EACvB,IAAIA,QAAQF,UAAU,MACpB,OAAOE,QAAQ,CAAC,CAACD,SAAS,CAAC,CAACE;CAIhC,GAAG,CAACvE,SAAS,CAAC;CAEdjD,gBAAgB;EACd,IAAI,CAAC6C,aAAa;EAClBoE,sBAAsBpE,WAAW;EACjC,aAAa;GACX,IAAImB,WAAWc,YAAYjC,aACzBmB,WAAWc,UAAUb,KAAAA;EAEzB;CACF,GAAG,CAACpB,aAAaoE,qBAAqB,CAAC;CAEvC,MAAMQ,QAAQxH,YAAY,YAAY;EACpC,IAAIiE,iBAAiBY,YAAYb,KAAAA,GAAW;GAC1CkC,aAAajC,iBAAiBY,OAAO;GACrCZ,iBAAiBY,UAAUb,KAAAA;EAC7B;EACA,IAAI,CAACD,WAAWc,SAAS;EACzB,IAAI,CAACR,yBAAyBQ,WAAWL,YAAYK,QAAQkB,SAAS,GACpE;EACF,MAAMrD,IAAI,IAAI+E,SAAerC,cAAY;GACvCd,kBAAkBO,QAAQ6C,KAAKtC,SAAO;EACxC,CAAC;EACD,IAAI,CAACf,yBAAyBQ,SAC5BK,eAAe;EAEjB,OAAOxC;CACT,GAAG,CAACwC,cAAc,CAAC;CAEnB,MAAMyC,iBAAiB3H,kBAAkB;EACvC,IAAI+D,WAAWc,WAAWZ,iBAAiBY,YAAYb,KAAAA,GAAW;GAChEkC,aAAajC,iBAAiBY,OAAO;GACrCZ,iBAAiBY,UAAUb,KAAAA;GAC3BkB,eAAe;EACjB;CACF,GAAG,CAACA,cAAc,CAAC;CAEnB,MAAM0C,cAAc5H,aACjBwB,MAAYkD,cAAwC;EACnDZ,cAAce,QAAQoB,IAAIzE,IAAE;EAC5BiD,gBAAgBE,WAAS;GACvB,MAAMkD,WAAWlD,OAAK5B,YAAYvB;GAClC,IAAI,CAACqG,UAAU,OAAOlD;GACtB,OAAO;IACL,GAAGA;IACH5B,aAAa;KACX,GAAG4B,OAAK5B;MACPvB,OAAK;MAAE,GAAGqG;MAAUhF,OAAO6B,UAAQmD,SAAShF,KAAK;KAAE;IACtD;GACF;EACF,CAAC;EACD,IAAII,SAAS4B,QAAQ9B,YAAYvB,KAAG,EAAEW,UAAU,UAC9C6D,oBAAoBxE,IAAE;CAE1B,GACA,CAACwE,qBAAqBvB,cAAc,CACtC;CAEA,MAAMqD,WAAW5H,eACR;EACL6H,uBAAuB;GACrB,MAAMC,OAAO/E,SAAS4B,QAAQ9B;GAC9B,OACEhC,8BACEiH,MACA5E,sBAAsByB,SACtB+C,aACAvE,mBAAmBwB,OACrB,KAAK,CAAC;EAEV;EACAoD,YAAYC,aAAyB;GACnChF,eAAe2B,QAAQoB,IAAIiC,QAAQ;GACnC,aAAa;IACXhF,eAAe2B,QAAQsD,OAAOD,QAAQ;GACxC;EACF;CACF,IACA,CAACN,WAAW,CACd;CAEA7H,gBAAgB;EACd,KAAK,MAAMqI,MAAMlF,eAAe2B,SAASuD,GAAG;CAC9C,GAAG,CAACvF,KAAK,CAAC;CAEV9C,gBAAgB;EACd,OAAOiD,UAAU6B,QAASwD,aAAa,CAAC,CAACC,SAASR,QAAQ;CAC5D,GAAG,CAAC9E,WAAW8E,QAAQ,CAAC;CAsKxB,OAAO;EACLT,gBAAgBpE,SAAS4B;EACzByD,UAtKetI,aACd0B,UAA0C;GACzC,MAAM6G,iBAAiBvF,UAAU6B,SAAS2D;GAC1C,MAAMC,iBACJF,kBAAkBA,eAAenB,UAAU,OACtCmB,eAAe,CAAC,CAAClB,SAAS,CAAC,CAAChF,YAAY,CAAA,IACzC,CAAA;GACN,MAAMF,QACJT,MAAIS,UACHC,0BAA0BqG,gBAAgB/G,MAAIF,IAAIE,MAAIY,IAAI,IACvD,WACA;GAEN,IACEoG,QAAQC,IAAIC,aAAa,gBACzB3F,SAAS4B,QAAQ9B,YAAYrB,MAAIF,OACjCW,UAAU,UAEV2E,QAAQC,KACN,oBAAoBrF,MAAIY,KAAI,KAAMZ,MAAIF,GAAE,mKAG1C;GAGFiC,sBAAsBoB,QAAQ0B,IAC5B7E,MAAIF,KACHiC,sBAAsBoB,QAAQgE,IAAInH,MAAIF,EAAE,KAAK,KAAK,CACrD;GAEA,IAAIsH;GACJ,IAAIpH,MAAIqH,cAAc;IACpB,MAAMC,gBAAgBhG,UAAU6B,SAASoE;IACzC,IAAID,iBAAiBA,cAAc5B,UAAU,MAAM;KACjD,MAAMtF,WAAWZ,qBAAqBQ,MAAIY,IAAI;KAC9C,MAAMuF,aAAWnE,iBAAiBmB,QAAQgE,IAAInH,MAAIY,IAAI;KACtD,IAAIuF,YACFA,WAASlE;UAETD,iBAAiBmB,QAAQ0B,IAAI7E,MAAIY,MAAM;MACrCqB,OAAO;MACPC,aAAaoF,cAAc,CAAC,CAACE,UAC3BpH,UACAJ,MAAIqH,cACJ,EAAEI,YAAY,KAAK,CACrB;KACF,CAAC;KAEHL,4BAA4B;MAC1B,MAAMxC,UAAQ5C,iBAAiBmB,QAAQgE,IAAInH,MAAIY,IAAI;MACnD,IAAI,CAACgE,SAAO;MACZ,IAAI,EAAEA,QAAM3C,UAAU,GAAG;OACvBD,iBAAiBmB,QAAQsD,OAAOzG,MAAIY,IAAI;OACxCgE,QAAM1C,YAAY;MACpB;KACF;IACF,OAAO,IAAI8E,QAAQC,IAAIC,aAAa,cAClC9B,QAAQC,KACN,oBAAoBrF,MAAIY,KAAI,gFAE9B;GAEJ;GAGA,IAAI,CAACc,sBAAsByB,QAAQ8B,IAAIjF,MAAIF,EAAE,GAC3C,IAAI;IACF,MAAM4H,aAAaxI,aAAac,MAAI2H,WAAW;IAC/CjG,sBAAsByB,QAAQ0B,IAC5B7E,MAAIF,IACJX,oBAAoBuI,UAAU,CAChC;GACF,SAAStD,KAAG;IACVgB,QAAQC,KACN,wDAAwDrF,MAAIY,KAAI,sEAChEwD,GACF;GACF;GAGF,MAAMwD,WAAWnH,UAAU,WAAW8E,mBAAmB,IAAIjD,KAAAA;GAC7D,MAAMuF,WACJpH,UAAU,WACNmH,WACE9F,uBAAuBqB,QAAQgE,IAAIS,QAAQ,CAAC,EAAET,IAAInH,MAAIF,EAAE,IACxDwC,KAAAA,IACFT,oBAAoBsB,QAAQgE,IAAInH,MAAIF,EAAE;GAC5C,IAAIW,UAAU;QACRmH,UACF9F,uBAAuBqB,QAAQgE,IAAIS,QAAQ,CAAC,EAAEnB,OAAOzG,MAAIF,EAAE;GAAA,OAE7D+B,oBAAoBsB,QAAQsD,OAAOzG,MAAIF,EAAE;GAE3C,MAAMgI,SACJrH,UAAU,WAAW6B,KAAAA,IAAYH,eAAegB,QAAQgE,IAAInH,MAAIF,EAAE;GAMpE,MAAMiI,QACJtH,UAAU,WACNlB,oBAAoBwH,gBAAgB/G,MAAIF,IAAIE,MAAIY,IAAI,IACpD0B,KAAAA;GAENS,gBAAgBE,YAAU;IACxB,GAAGA;IACH5B,aAAa;KACX,GAAG4B,OAAK5B;MACPrB,MAAIF,KAAK;MACRA,IAAIE,MAAIF;MACRc,MAAMZ,MAAIY;MACVoH,aAAahI,MAAIgI;MACjBL,aAAa3H,MAAI2H;MACjBM,cAAcjI,MAAIiI;MAClBxH;MACAU,OACE8B,OAAK5B,YAAYrB,MAAIF,GAAG,EAAEqB,SAC1B0G,YACAE,OAAO5G,SACP2G,UACA9H,MAAIiI;KACR;IACF;GACF,EAAE;GAEF,aAAa;IACXb,sBAAsB;IAEtB,MAAMc,aAAanG,sBAAsBoB,QAAQgE,IAAInH,MAAIF,EAAE,KAAK,KAAK;IACrE,IAAIoI,YAAY,GAAG;KACjBnG,sBAAsBoB,QAAQ0B,IAAI7E,MAAIF,IAAIoI,SAAS;KACnD;IACF;IACAnG,sBAAsBoB,QAAQsD,OAAOzG,MAAIF,EAAE;IAE3CmG,eAAe;IACflD,gBAAgBE,WAAS;KACvB,MAAMkD,aAAWlD,OAAK5B,YAAYrB,MAAIF;KACtC,IAAIqG,YACF,IAAIA,WAAS1F,UAAU,UAAU;MAC/B,MAAMmH,aAAWrC,mBAAmB;MACpC,IAAIqC,YAAU;OACZ,IAAIO,YAAYrG,uBAAuBqB,QAAQgE,IAAIS,UAAQ;OAC3D,IAAI,CAACO,WAAW;QACdA,4BAAY,IAAIvI,IAAI;QACpBkC,uBAAuBqB,QAAQ0B,IAAI+C,YAAUO,SAAS;OACxD;OACAA,UAAUtD,IAAI7E,MAAIF,IAAIqG,WAAShF,KAAK;MACtC;KACF,OACEU,oBAAoBsB,QAAQ0B,IAAI7E,MAAIF,IAAIqG,WAAShF,KAAK;KAG1DO,sBAAsByB,QAAQsD,OAAOzG,MAAIF,EAAE;KAC3C,MAAM,GAAGE,MAAIF,KAAKsI,GAAG,GAAGC,SAASpF,OAAK5B;KACtC,MAAM,GAAGrB,MAAIF,KAAKwI,IAAI,GAAGC,oBAAoBtF,OAAK/B;KAClD,OAAO;MAAE,GAAG+B;MAAM5B,aAAagH;MAAMnH,aAAaqH;KAAgB;IACpE,CAAC;GACH;EACF,GACA;GAACtC;GAAgB3E;GAAWiE;GAAoBxC;EAAc,CAK9D6D;EACAxF,UAAU8E;EACV9C;EACA2B;EACAO;EACAQ;CACF;AACF;;;;;;AAOA,MAAa0C,yBAAyB/J,SAASwC,wBAAwB;AAEvErC,sBAAsBqC,2BAA2BwH,QAAQC,WAAW;CAClE,IAAI,CAACD,OAAO9B,gBAAgB+B,OAAO/B,aAAajB,WAAW,MACzD+C,OAAO9B,eAAevH,aAAa;AAEvC,CAAC"}

package/dist/react/client/Tools.js

@@ -1,7 +1,7 @@
 import { ModelContext } from "../../store/clients/model-context-client.js";
 import { isStandaloneToolDisplay, makeToolCallTextComponent } from "../model-context/toolbox.js";
-import { useEffect, useState } from "@assistant-ui/tap/react-shim";
 import { attachTransformScopes, useAssistantClientRef } from "@assistant-ui/store";
+import { useEffect, useState } from "@assistant-ui/tap/react-shim";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
 import { resource, useResources, withKey } from "@assistant-ui/tap";
 //#region src/react/client/Tools.ts

package/dist/react/client/interactable-model-context.d.ts

@@ -1,12 +1,15 @@
-import { InteractableDefinition, InteractableStateSchema } from "../types/scopes/interactables.js";
-import { Tool } from "assistant-stream";
+import { Unstable_InteractableDefinition } from "../types/scopes/interactables.js";
+import { Tool, toJSONSchema } from "assistant-stream";
 
 //#region src/react/client/interactable-model-context.d.ts
-declare function shallowMerge(prev: unknown, partial: unknown): unknown;
-declare function buildInteractableModelContext(definitions: Record<string, InteractableDefinition>, partialSchemaCache: Map<string, InteractableStateSchema>, setDefState: (id: string, updater: (prev: unknown) => unknown) => void): {
-  system: string;
+type PartialJSONSchema = ReturnType<typeof toJSONSchema>;
+declare function buildInteractableModelContext(definitions: Record<string, Unstable_InteractableDefinition>, partialSchemaCache: Map<string, PartialJSONSchema>, setDefState: (id: string, updater: (prev: unknown) => unknown) => void, streamBaselines?: Map<string, {
+  targetId: string;
+  state: unknown;
+}>): {
   tools: Record<string, Tool<any, any>>;
+  unstable_composerMetadata?: Record<string, unknown>;
 } | undefined;
 //#endregion
-export { buildInteractableModelContext, shallowMerge };
+export { PartialJSONSchema, buildInteractableModelContext };
 //# sourceMappingURL=interactable-model-context.d.ts.map

package/dist/react/client/interactable-model-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactable-model-context.d.ts","names":[],"sources":["../../../src/react/client/interactable-model-context.ts"],"mappings":";;;;iBAMgB,YAAA,CAAa,IAAA,WAAe,OAAgB;AAAA,iBAiB5C,6BAAA,CACd,WAAA,EAAa,MAAA,SAAe,sBAAA,GAC5B,kBAAA,EAAoB,GAAA,SAAY,uBAAA,GAChC,WAAA,GAAc,EAAA,UAAY,OAAA,GAAU,IAAA;EACjC,MAAA;EAAgB,KAAA,EAAO,MAAA,SAAe,IAAA;AAAA"}
+{"version":3,"file":"interactable-model-context.d.ts","names":[],"sources":["../../../src/react/client/interactable-model-context.ts"],"mappings":";;;;KAWY,iBAAA,GAAoB,UAAU,QAAQ,YAAA;AAAA,iBA2HlC,6BAAA,CACd,WAAA,EAAa,MAAA,SAAe,+BAAA,GAC5B,kBAAA,EAAoB,GAAA,SAAY,iBAAA,GAChC,WAAA,GAAc,EAAA,UAAY,OAAA,GAAU,IAAA,gCACpC,eAAA,GAAe,GAAA;;;;EAGX,KAAA,EAAO,MAAA,SAAe,IAAA;EACtB,yBAAA,GAA4B,MAAA;AAAA"}

package/dist/react/client/interactable-model-context.js

@@ -1,12 +1,85 @@
+import { isRecord } from "../../utils/json/is-json.js";
+import { interactableToolName, shallowMergeInteractableState } from "../../model-context/interactable-composer-metadata.js";
+import { generateId } from "../../utils/id.js";
 //#region src/react/client/interactable-model-context.ts
-function shallowMerge(prev, partial) {
-	if (typeof prev !== "object" || prev === null || typeof partial !== "object" || partial === null || Array.isArray(prev) || Array.isArray(partial)) return partial;
+const ID_PROPERTY = {
+	type: "string",
+	description: "The id of the instance to update, as shown in its state snapshot in the conversation."
+};
+const hasIdProperty = (schema) => {
+	const properties = schema.properties;
+	return isRecord(properties) && properties.id !== void 0;
+};
+const withRequiredItemId = (schema) => ({
+	...schema,
+	required: ["id"]
+});
+const withoutItemId = (schema) => {
+	const { id: _omitted, ...properties } = isRecord(schema.properties) ? schema.properties : {};
+	const required = Array.isArray(schema.required) ? schema.required.filter((key) => key !== "id") : schema.required;
 	return {
-		...prev,
-		...partial
+		...schema,
+		properties,
+		required
+	};
+};
+const toArrayUpdateSchema = (schema, field) => {
+	if (!isRecord(schema) || schema.type !== "array") return schema;
+	const itemSchema = schema.items;
+	if (Array.isArray(itemSchema) || !isRecord(itemSchema)) return schema;
+	const idKeyed = hasIdProperty(itemSchema);
+	const properties = {
+		add: {
+			type: "array",
+			items: idKeyed ? withoutItemId(itemSchema) : itemSchema
+		},
+		remove: {
+			type: "array",
+			items: idKeyed ? ID_PROPERTY : itemSchema
+		},
+		clear: { type: "boolean" }
+	};
+	if (idKeyed) properties.update = {
+		type: "array",
+		items: withRequiredItemId(itemSchema)
+	};
+	return {
+		type: "object",
+		description: `Operations for array field "${field}". To change one item use update with its id; add new items (their ids are assigned for you), remove items by id, or clear to empty. Change only the items you mean to — never resend the whole array to edit one item.`,
+		properties,
+		additionalProperties: false
+	};
+};
+const idKeyedArrayFieldNames = (properties) => {
+	const names = /* @__PURE__ */ new Set();
+	for (const [key, value] of Object.entries(properties)) if (isRecord(value) && value.type === "array" && isRecord(value.items) && hasIdProperty(value.items)) names.add(key);
+	return names;
+};
+const withArrayUpdateSchemas = (properties) => Object.fromEntries(Object.entries(properties).map(([key, value]) => [key, toArrayUpdateSchema(value, key)]));
+/**
+* Wraps an interactable's partial state schema with the required `id`
+* parameter. Falls back to a permissive schema when the partial conversion
+* failed at registration time.
+*/
+function withRequiredId(partial) {
+	if (!partial || typeof partial !== "object" || partial.type !== "object") return {
+		type: "object",
+		properties: { id: ID_PROPERTY },
+		required: ["id"],
+		additionalProperties: true
+	};
+	if (process.env.NODE_ENV !== "production" && partial.properties?.id) console.warn("[Interactables] a top-level \"id\" field in an interactable's stateSchema is reserved for instance addressing by the update tool and cannot be updated by the model. Rename the field to make it model-writable.");
+	const { id: _reserved, ...properties } = partial.properties ?? {};
+	return {
+		...partial,
+		properties: {
+			id: ID_PROPERTY,
+			...withArrayUpdateSchemas(properties)
+		},
+		required: ["id"]
 	};
 }
-function buildInteractableModelContext(definitions, partialSchemaCache, setDefState) {
+function buildInteractableModelContext(definitions, partialSchemaCache, setDefState, streamBaselines = /* @__PURE__ */ new Map()) {
 	const entries = Object.values(definitions);
 	if (entries.length === 0) return void 0;
 	const byName = /* @__PURE__ */ new Map();
@@ -15,40 +88,89 @@ function buildInteractableModelContext(definitions, partialSchemaCache, setDefSt
 		list.push(def);
 		byName.set(def.name, list);
 	}
-	const systemParts = [];
 	const tools = {};
 	for (const [name, instances] of byName) {
-		const isMulti = instances.length > 1;
-		for (const def of instances) {
-			const selectedTag = def.selected ? " (SELECTED)" : "";
-			const idTag = isMulti ? ` [id="${def.id}"]` : "";
-			systemParts.push(`Interactable component "${name}"${idTag}${selectedTag} (${def.description}). Current state: ${JSON.stringify(def.state)}`);
-			const safeName = name.replace(/[^a-zA-Z0-9_-]/g, "_");
-			const safeId = def.id.replace(/[^a-zA-Z0-9_-]/g, "_");
-			const toolName = isMulti ? `update_${safeName}_${safeId}` : `update_${safeName}`;
-			const partialSchema = partialSchemaCache.get(def.id) ?? def.stateSchema;
-			tools[toolName] = {
-				type: "frontend",
-				description: `Update the state of interactable component "${name}"${isMulti ? ` (id: ${def.id})` : ""}. Only include the fields you want to change; omitted fields keep their current values. ${def.description}`,
-				parameters: partialSchema,
-				streamCall: async (reader) => {
-					try {
-						for await (const partialArgs of reader.args.streamValues()) setDefState(def.id, (prev) => shallowMerge(prev, partialArgs));
-					} catch {}
-				},
-				execute: async (partialState) => {
-					setDefState(def.id, (prev) => shallowMerge(prev, partialState));
-					return { success: true };
-				}
-			};
+		const toolName = interactableToolName(name);
+		if (tools[toolName]) {
+			if (process.env.NODE_ENV !== "production") console.warn(`[Interactables] interactable names "${name}" and another registered name both sanitize to the tool name "${toolName}". Rename one of them.`);
+			continue;
 		}
+		const first = instances[0];
+		const partialSchema = partialSchemaCache.get(first.id);
+		const idKeyedFields = partialSchema && isRecord(partialSchema.properties) ? idKeyedArrayFieldNames(partialSchema.properties) : /* @__PURE__ */ new Set();
+		const resolveTarget = (id) => {
+			if (typeof id === "string") {
+				const def = definitions[id];
+				return def?.name === name ? def : void 0;
+			}
+			return instances.length === 1 ? first : void 0;
+		};
+		tools[toolName] = {
+			type: "frontend",
+			description: `Update the state of interactable component "${name}". ${first.description} Pass the id of the instance to update — instance ids and current state appear in the conversation as state snapshots. Only include the fields you want to change; omitted fields keep their current values.`,
+			parameters: withRequiredId(partialSchema),
+			streamCall: async (reader, { toolCallId }) => {
+				try {
+					for await (const partialArgs of reader.args.streamValues()) {
+						if (!partialArgs || typeof partialArgs !== "object") continue;
+						const args = partialArgs;
+						const keys = Object.keys(args);
+						if (keys.indexOf("id") === keys.length - 1) continue;
+						const { id, ...partial } = args;
+						if (Object.keys(partial).length === 0) continue;
+						const target = resolveTarget(id);
+						if (!target) continue;
+						const baseline = streamBaselines.get(toolCallId);
+						const arrayBaseline = baseline?.targetId === target.id ? baseline.state : target.state;
+						if (!baseline || baseline.targetId !== target.id) streamBaselines.set(toolCallId, {
+							targetId: target.id,
+							state: target.state
+						});
+						setDefState(target.id, (prev) => shallowMergeInteractableState(prev, partial, { arrayBaseline }));
+					}
+				} catch {}
+			},
+			execute: async (args, { toolCallId }) => {
+				const { id, ...partial } = args ?? {};
+				const target = resolveTarget(id);
+				if (!target) {
+					const validIds = instances.map((d) => d.id);
+					return {
+						success: false,
+						error: `Unknown id ${JSON.stringify(id)} for interactable "${name}". Valid ids: ${validIds.join(", ")}`
+					};
+				}
+				const baseline = streamBaselines.get(toolCallId);
+				streamBaselines.delete(toolCallId);
+				const addedItemIds = {};
+				setDefState(target.id, (prev) => shallowMergeInteractableState(prev, partial, {
+					arrayBaseline: baseline?.targetId === target.id ? baseline.state : void 0,
+					idFactory: (field) => {
+						const itemId = generateId();
+						(addedItemIds[field] ??= []).push(itemId);
+						return itemId;
+					},
+					idKeyedFields
+				}));
+				const result = {
+					success: true,
+					id: target.id
+				};
+				if (Object.keys(addedItemIds).length > 0) result.addedItemIds = addedItemIds;
+				return result;
+			}
+		};
 	}
 	return {
-		system: systemParts.join("\n"),
-		tools
+		tools,
+		unstable_composerMetadata: { interactables: entries.map((def) => ({
+			id: def.id,
+			name: def.name,
+			state: def.state
+		})) }
 	};
 }
 //#endregion
-export { buildInteractableModelContext, shallowMerge };
+export { buildInteractableModelContext };
 
 //# sourceMappingURL=interactable-model-context.js.map

package/dist/react/client/interactable-model-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactable-model-context.js","names":["Tool","InteractableDefinition","InteractableStateSchema","shallowMerge","prev","partial","Array","isArray","Record","buildInteractableModelContext","definitions","partialSchemaCache","Map","setDefState","id","updater","system","tools","entries","Object","values","length","undefined","byName","def","list","get","name","push","set","systemParts","instances","isMulti","selectedTag","selected","idTag","description","JSON","stringify","state","safeName","replace","safeId","toolName","partialSchema","stateSchema","type","const","parameters","streamCall","reader","partialArgs","args","streamValues","execute","partialState","success","join"],"sources":["../../../src/react/client/interactable-model-context.ts"],"sourcesContent":["import type { Tool } from \"assistant-stream\";\nimport type {\n  InteractableDefinition,\n  InteractableStateSchema,\n} from \"../types/scopes/interactables\";\n\nexport function shallowMerge(prev: unknown, partial: unknown): unknown {\n  if (\n    typeof prev !== \"object\" ||\n    prev === null ||\n    typeof partial !== \"object\" ||\n    partial === null ||\n    Array.isArray(prev) ||\n    Array.isArray(partial)\n  ) {\n    return partial;\n  }\n  return {\n    ...(prev as Record<string, unknown>),\n    ...(partial as Record<string, unknown>),\n  };\n}\n\nexport function buildInteractableModelContext(\n  definitions: Record<string, InteractableDefinition>,\n  partialSchemaCache: Map<string, InteractableStateSchema>,\n  setDefState: (id: string, updater: (prev: unknown) => unknown) => void,\n): { system: string; tools: Record<string, Tool<any, any>> } | undefined {\n  const entries = Object.values(definitions);\n  if (entries.length === 0) return undefined;\n\n  const byName = new Map<string, InteractableDefinition[]>();\n  for (const def of entries) {\n    const list = byName.get(def.name) ?? [];\n    list.push(def);\n    byName.set(def.name, list);\n  }\n\n  const systemParts: string[] = [];\n  const tools: Record<string, Tool<any, any>> = {};\n\n  for (const [name, instances] of byName) {\n    const isMulti = instances.length > 1;\n\n    for (const def of instances) {\n      const selectedTag = def.selected ? \" (SELECTED)\" : \"\";\n      const idTag = isMulti ? ` [id=\"${def.id}\"]` : \"\";\n\n      systemParts.push(\n        `Interactable component \"${name}\"${idTag}${selectedTag} (${def.description}). Current state: ${JSON.stringify(def.state)}`,\n      );\n\n      const safeName = name.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n      const safeId = def.id.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n      const toolName = isMulti\n        ? `update_${safeName}_${safeId}`\n        : `update_${safeName}`;\n\n      const partialSchema = partialSchemaCache.get(def.id) ?? def.stateSchema;\n\n      tools[toolName] = {\n        type: \"frontend\" as const,\n        description: `Update the state of interactable component \"${name}\"${isMulti ? ` (id: ${def.id})` : \"\"}. Only include the fields you want to change; omitted fields keep their current values. ${def.description}`,\n        parameters: partialSchema,\n        streamCall: async (reader) => {\n          try {\n            for await (const partialArgs of reader.args.streamValues()) {\n              setDefState(def.id, (prev) => shallowMerge(prev, partialArgs));\n            }\n          } catch {\n            // Non-fatal: execute handles the final state\n          }\n        },\n        execute: async (partialState: unknown) => {\n          setDefState(def.id, (prev) => shallowMerge(prev, partialState));\n          return { success: true };\n        },\n      };\n    }\n  }\n\n  return { system: systemParts.join(\"\\n\"), tools };\n}\n"],"mappings":";AAMA,SAAgBG,aAAaC,MAAeC,SAA2B;CACrE,IACE,OAAOD,SAAS,YAChBA,SAAS,QACT,OAAOC,YAAY,YACnBA,YAAY,QACZC,MAAMC,QAAQH,IAAI,KAClBE,MAAMC,QAAQF,OAAO,GAErB,OAAOA;CAET,OAAO;EACL,GAAID;EACJ,GAAIC;CACN;AACF;AAEA,SAAgBI,8BACdC,aACAC,oBACAE,aACuE;CACvE,MAAMK,UAAUC,OAAOC,OAAOV,WAAW;CACzC,IAAIQ,QAAQG,WAAW,GAAG,OAAOC,KAAAA;CAEjC,MAAMC,yBAAS,IAAIX,IAAsC;CACzD,KAAK,MAAMY,OAAON,SAAS;EACzB,MAAMO,OAAOF,OAAOG,IAAIF,IAAIG,IAAI,KAAK,CAAA;EACrCF,KAAKG,KAAKJ,GAAG;EACbD,OAAOM,IAAIL,IAAIG,MAAMF,IAAI;CAC3B;CAEA,MAAMK,cAAwB,CAAA;CAC9B,MAAMb,QAAwC,CAAC;CAE/C,KAAK,MAAM,CAACU,MAAMI,cAAcR,QAAQ;EACtC,MAAMS,UAAUD,UAAUV,SAAS;EAEnC,KAAK,MAAMG,OAAOO,WAAW;GAC3B,MAAME,cAAcT,IAAIU,WAAW,gBAAgB;GACnD,MAAMC,QAAQH,UAAU,SAASR,IAAIV,GAAE,MAAO;GAE9CgB,YAAYF,KACV,2BAA2BD,KAAI,GAAIQ,QAAQF,YAAW,IAAKT,IAAIY,YAAW,oBAAqBC,KAAKC,UAAUd,IAAIe,KAAK,GACzH;GAEA,MAAMC,WAAWb,KAAKc,QAAQ,mBAAmB,GAAG;GACpD,MAAMC,SAASlB,IAAIV,GAAG2B,QAAQ,mBAAmB,GAAG;GACpD,MAAME,WAAWX,UACb,UAAUQ,SAAQ,GAAIE,WACtB,UAAUF;GAEd,MAAMI,gBAAgBjC,mBAAmBe,IAAIF,IAAIV,EAAE,KAAKU,IAAIqB;GAE5D5B,MAAM0B,YAAY;IAChBG,MAAM;IACNV,aAAa,+CAA+CT,KAAI,GAAIK,UAAU,SAASR,IAAIV,GAAE,KAAM,GAAE,0FAA2FU,IAAIY;IACpMY,YAAYJ;IACZK,YAAY,OAAOC,WAAW;KAC5B,IAAI;MACF,WAAW,MAAMC,eAAeD,OAAOE,KAAKC,aAAa,GACvDxC,YAAYW,IAAIV,KAAKV,SAASD,aAAaC,MAAM+C,WAAW,CAAC;KAEjE,QAAQ,CACN;IAEJ;IACAG,SAAS,OAAOC,iBAA0B;KACxC1C,YAAYW,IAAIV,KAAKV,SAASD,aAAaC,MAAMmD,YAAY,CAAC;KAC9D,OAAO,EAAEC,SAAS,KAAK;IACzB;GACF;EACF;CACF;CAEA,OAAO;EAAExC,QAAQc,YAAY2B,KAAK,IAAI;EAAGxC;CAAM;AACjD"}
+{"version":3,"file":"interactable-model-context.js","names":["Tool","toJSONSchema","Unstable_InteractableDefinition","interactableToolName","shallowMergeInteractableState","Unstable_InteractableSnapshotEntry","generateId","isRecord","PartialJSONSchema","ReturnType","ID_PROPERTY","type","const","description","hasIdProperty","schema","Record","properties","id","undefined","withRequiredItemId","required","withoutItemId","_omitted","Array","isArray","filter","key","toArrayUpdateSchema","field","itemSchema","items","idKeyed","add","remove","clear","update","additionalProperties","idKeyedArrayFieldNames","Set","names","value","Object","entries","withArrayUpdateSchemas","fromEntries","map","withRequiredId","partial","process","env","NODE_ENV","console","warn","_reserved","buildInteractableModelContext","definitions","partialSchemaCache","Map","setDefState","updater","prev","streamBaselines","targetId","state","tools","unstable_composerMetadata","values","length","byName","def","list","get","name","push","set","instances","toolName","first","partialSchema","idKeyedFields","resolveTarget","parameters","streamCall","reader","toolCallId","partialArgs","args","streamValues","keys","idIndex","indexOf","target","baseline","arrayBaseline","execute","validIds","d","success","error","JSON","stringify","join","delete","addedItemIds","idFactory","itemId","result","interactables"],"sources":["../../../src/react/client/interactable-model-context.ts"],"sourcesContent":["import type { Tool } from \"assistant-stream\";\nimport { toJSONSchema } from \"assistant-stream\";\nimport type { Unstable_InteractableDefinition } from \"../types/scopes/interactables\";\nimport {\n  interactableToolName,\n  shallowMergeInteractableState,\n  type Unstable_InteractableSnapshotEntry,\n} from \"../../model-context/interactable-composer-metadata\";\nimport { generateId } from \"../../utils/id\";\nimport { isRecord } from \"../../utils/json/is-json\";\n\nexport type PartialJSONSchema = ReturnType<typeof toJSONSchema>;\n\nconst ID_PROPERTY = {\n  type: \"string\" as const,\n  description:\n    \"The id of the instance to update, as shown in its state snapshot in the conversation.\",\n};\n\nconst hasIdProperty = (schema: Record<string, unknown>) => {\n  const properties = schema.properties;\n  return isRecord(properties) && properties.id !== undefined;\n};\n\nconst withRequiredItemId = (schema: Record<string, unknown>) => ({\n  ...schema,\n  required: [\"id\"],\n});\n\n// The framework assigns ids to new items, so the model never sees the `id`\n// field when adding (it can't address an item that doesn't exist yet).\nconst withoutItemId = (schema: Record<string, unknown>) => {\n  const { id: _omitted, ...properties } = isRecord(schema.properties)\n    ? schema.properties\n    : {};\n  const required = Array.isArray(schema.required)\n    ? schema.required.filter((key) => key !== \"id\")\n    : schema.required;\n  return { ...schema, properties, required };\n};\n\nconst toArrayUpdateSchema = (schema: unknown, field: string) => {\n  if (!isRecord(schema) || schema.type !== \"array\") return schema;\n  const itemSchema = schema.items;\n  if (Array.isArray(itemSchema) || !isRecord(itemSchema)) return schema;\n\n  const idKeyed = hasIdProperty(itemSchema);\n  const properties: Record<string, unknown> = {\n    add: {\n      type: \"array\",\n      items: idKeyed ? withoutItemId(itemSchema) : itemSchema,\n    },\n    remove: {\n      type: \"array\",\n      items: idKeyed ? ID_PROPERTY : itemSchema,\n    },\n    clear: { type: \"boolean\" },\n  };\n\n  if (idKeyed) {\n    properties.update = {\n      type: \"array\",\n      items: withRequiredItemId(itemSchema),\n    };\n  }\n\n  return {\n    type: \"object\" as const,\n    description:\n      `Operations for array field \"${field}\". To change one item use update ` +\n      `with its id; add new items (their ids are assigned for you), remove items ` +\n      `by id, or clear to empty. Change only the items you mean to — never resend ` +\n      `the whole array to edit one item.`,\n    properties,\n    additionalProperties: false,\n  };\n};\n\n// Top-level array fields whose items carry an `id` — the fields the framework\n// mints ids for on add.\nconst idKeyedArrayFieldNames = (\n  properties: Record<string, unknown>,\n): Set<string> => {\n  const names = new Set<string>();\n  for (const [key, value] of Object.entries(properties)) {\n    if (\n      isRecord(value) &&\n      value.type === \"array\" &&\n      isRecord(value.items) &&\n      hasIdProperty(value.items)\n    ) {\n      names.add(key);\n    }\n  }\n  return names;\n};\n\nconst withArrayUpdateSchemas = (properties: Record<string, unknown>) =>\n  Object.fromEntries(\n    Object.entries(properties).map(([key, value]) => [\n      key,\n      toArrayUpdateSchema(value, key),\n    ]),\n  );\n\n/**\n * Wraps an interactable's partial state schema with the required `id`\n * parameter. Falls back to a permissive schema when the partial conversion\n * failed at registration time.\n */\nfunction withRequiredId(partial: PartialJSONSchema | undefined) {\n  if (!partial || typeof partial !== \"object\" || partial.type !== \"object\") {\n    return {\n      type: \"object\" as const,\n      properties: { id: ID_PROPERTY },\n      required: [\"id\"],\n      additionalProperties: true,\n    };\n  }\n  if (process.env.NODE_ENV !== \"production\" && partial.properties?.id) {\n    console.warn(\n      `[Interactables] a top-level \"id\" field in an interactable's stateSchema is ` +\n        `reserved for instance addressing by the update tool and cannot be updated ` +\n        `by the model. Rename the field to make it model-writable.`,\n    );\n  }\n  const { id: _reserved, ...properties } = partial.properties ?? {};\n  return {\n    ...partial,\n    properties: { id: ID_PROPERTY, ...withArrayUpdateSchemas(properties) },\n    required: [\"id\"],\n  };\n}\n\nexport function buildInteractableModelContext(\n  definitions: Record<string, Unstable_InteractableDefinition>,\n  partialSchemaCache: Map<string, PartialJSONSchema>,\n  setDefState: (id: string, updater: (prev: unknown) => unknown) => void,\n  streamBaselines = new Map<string, { targetId: string; state: unknown }>(),\n):\n  | {\n      tools: Record<string, Tool<any, any>>;\n      unstable_composerMetadata?: Record<string, unknown>;\n    }\n  | undefined {\n  const entries = Object.values(definitions);\n  if (entries.length === 0) return undefined;\n\n  const byName = new Map<string, Unstable_InteractableDefinition[]>();\n  for (const def of entries) {\n    const list = byName.get(def.name) ?? [];\n    list.push(def);\n    byName.set(def.name, list);\n  }\n\n  const tools: Record<string, Tool<any, any>> = {};\n\n  for (const [name, instances] of byName) {\n    const toolName = interactableToolName(name);\n    if (tools[toolName]) {\n      if (process.env.NODE_ENV !== \"production\") {\n        console.warn(\n          `[Interactables] interactable names \"${name}\" and another registered name ` +\n            `both sanitize to the tool name \"${toolName}\". Rename one of them.`,\n        );\n      }\n      continue;\n    }\n\n    const first = instances[0]!;\n    const partialSchema = partialSchemaCache.get(first.id);\n    const idKeyedFields =\n      partialSchema && isRecord(partialSchema.properties)\n        ? idKeyedArrayFieldNames(partialSchema.properties)\n        : new Set<string>();\n\n    // `id` resolves to a definition of this name; an id-less call is accepted\n    // only while exactly one instance exists.\n    const resolveTarget = (\n      id: unknown,\n    ): Unstable_InteractableDefinition | undefined => {\n      if (typeof id === \"string\") {\n        const def = definitions[id];\n        return def?.name === name ? def : undefined;\n      }\n      return instances.length === 1 ? first : undefined;\n    };\n\n    tools[toolName] = {\n      type: \"frontend\",\n      description:\n        `Update the state of interactable component \"${name}\". ${first.description} ` +\n        `Pass the id of the instance to update — instance ids and current state ` +\n        `appear in the conversation as state snapshots. Only include the fields ` +\n        `you want to change; omitted fields keep their current values.`,\n      parameters: withRequiredId(partialSchema),\n      streamCall: async (reader, { toolCallId }) => {\n        try {\n          for await (const partialArgs of reader.args.streamValues()) {\n            if (!partialArgs || typeof partialArgs !== \"object\") continue;\n            const args = partialArgs as Record<string, unknown>;\n            const keys = Object.keys(args);\n            const idIndex = keys.indexOf(\"id\");\n            if (idIndex === keys.length - 1) continue;\n\n            const { id, ...partial } = args;\n            if (Object.keys(partial).length === 0) continue;\n            const target = resolveTarget(id);\n            if (!target) continue;\n\n            const baseline = streamBaselines.get(toolCallId);\n            const arrayBaseline =\n              baseline?.targetId === target.id ? baseline.state : target.state;\n            if (!baseline || baseline.targetId !== target.id) {\n              streamBaselines.set(toolCallId, {\n                targetId: target.id,\n                state: target.state,\n              });\n            }\n\n            setDefState(target.id, (prev) =>\n              shallowMergeInteractableState(prev, partial, { arrayBaseline }),\n            );\n          }\n        } catch {\n          // Non-fatal: execute handles the final state\n        }\n      },\n      execute: async (args: unknown, { toolCallId }) => {\n        const { id, ...partial } = (args ?? {}) as Record<string, unknown>;\n        const target = resolveTarget(id);\n        if (!target) {\n          const validIds = instances.map((d) => d.id);\n          return {\n            success: false,\n            error: `Unknown id ${JSON.stringify(id)} for interactable \"${name}\". Valid ids: ${validIds.join(\", \")}`,\n          };\n        }\n        const baseline = streamBaselines.get(toolCallId);\n        streamBaselines.delete(toolCallId);\n        const addedItemIds: Record<string, string[]> = {};\n        setDefState(target.id, (prev) =>\n          shallowMergeInteractableState(prev, partial, {\n            arrayBaseline:\n              baseline?.targetId === target.id ? baseline.state : undefined,\n            idFactory: (field) => {\n              const itemId = generateId();\n              (addedItemIds[field] ??= []).push(itemId);\n              return itemId;\n            },\n            idKeyedFields,\n          }),\n        );\n        // The resolved id lets an id-less call's UI (and the model) address\n        // the instance that was actually updated.\n        const result: {\n          success: true;\n          id: string;\n          addedItemIds?: Record<string, string[]>;\n        } = { success: true, id: target.id };\n        if (Object.keys(addedItemIds).length > 0) {\n          result.addedItemIds = addedItemIds;\n        }\n        return result;\n      },\n    };\n  }\n\n  const interactables: Unstable_InteractableSnapshotEntry[] = entries.map(\n    (def) => ({\n      id: def.id,\n      name: def.name,\n      state: def.state,\n    }),\n  );\n  return { tools, unstable_composerMetadata: { interactables } };\n}\n"],"mappings":";;;;AAaA,MAAMU,cAAc;CAClBC,MAAM;CACNE,aACE;AACJ;AAEA,MAAMC,iBAAiBC,WAAoC;CACzD,MAAME,aAAaF,OAAOE;CAC1B,OAAOV,SAASU,UAAU,KAAKA,WAAWC,OAAOC,KAAAA;AACnD;AAEA,MAAMC,sBAAsBL,YAAqC;CAC/D,GAAGA;CACHM,UAAU,CAAC,IAAI;AACjB;AAIA,MAAMC,iBAAiBP,WAAoC;CACzD,MAAM,EAAEG,IAAIK,UAAU,GAAGN,eAAeV,SAASQ,OAAOE,UAAU,IAC9DF,OAAOE,aACP,CAAC;CACL,MAAMI,WAAWG,MAAMC,QAAQV,OAAOM,QAAQ,IAC1CN,OAAOM,SAASK,QAAQC,QAAQA,QAAQ,IAAI,IAC5CZ,OAAOM;CACX,OAAO;EAAE,GAAGN;EAAQE;EAAYI;CAAS;AAC3C;AAEA,MAAMO,uBAAuBb,QAAiBc,UAAkB;CAC9D,IAAI,CAACtB,SAASQ,MAAM,KAAKA,OAAOJ,SAAS,SAAS,OAAOI;CACzD,MAAMe,aAAaf,OAAOgB;CAC1B,IAAIP,MAAMC,QAAQK,UAAU,KAAK,CAACvB,SAASuB,UAAU,GAAG,OAAOf;CAE/D,MAAMiB,UAAUlB,cAAcgB,UAAU;CACxC,MAAMb,aAAsC;EAC1CgB,KAAK;GACHtB,MAAM;GACNoB,OAAOC,UAAUV,cAAcQ,UAAU,IAAIA;EAC/C;EACAI,QAAQ;GACNvB,MAAM;GACNoB,OAAOC,UAAUtB,cAAcoB;EACjC;EACAK,OAAO,EAAExB,MAAM,UAAU;CAC3B;CAEA,IAAIqB,SACFf,WAAWmB,SAAS;EAClBzB,MAAM;EACNoB,OAAOX,mBAAmBU,UAAU;CACtC;CAGF,OAAO;EACLnB,MAAM;EACNE,aACE,+BAA+BgB,MAAK;EAItCZ;EACAoB,sBAAsB;CACxB;AACF;AAIA,MAAMC,0BACJrB,eACgB;CAChB,MAAMuB,wBAAQ,IAAID,IAAY;CAC9B,KAAK,MAAM,CAACZ,KAAKc,UAAUC,OAAOC,QAAQ1B,UAAU,GAClD,IACEV,SAASkC,KAAK,KACdA,MAAM9B,SAAS,WACfJ,SAASkC,MAAMV,KAAK,KACpBjB,cAAc2B,MAAMV,KAAK,GAEzBS,MAAMP,IAAIN,GAAG;CAGjB,OAAOa;AACT;AAEA,MAAMI,0BAA0B3B,eAC9ByB,OAAOG,YACLH,OAAOC,QAAQ1B,UAAU,CAAC,CAAC6B,KAAK,CAACnB,KAAKc,WAAW,CAC/Cd,KACAC,oBAAoBa,OAAOd,GAAG,CAAC,CAChC,CACH;;;;;;AAOF,SAASoB,eAAeC,SAAwC;CAC9D,IAAI,CAACA,WAAW,OAAOA,YAAY,YAAYA,QAAQrC,SAAS,UAC9D,OAAO;EACLA,MAAM;EACNM,YAAY,EAAEC,IAAIR,YAAY;EAC9BW,UAAU,CAAC,IAAI;EACfgB,sBAAsB;CACxB;CAEF,IAAIY,QAAQC,IAAIC,aAAa,gBAAgBH,QAAQ/B,YAAYC,IAC/DkC,QAAQC,KACN,kNAGF;CAEF,MAAM,EAAEnC,IAAIoC,WAAW,GAAGrC,eAAe+B,QAAQ/B,cAAc,CAAC;CAChE,OAAO;EACL,GAAG+B;EACH/B,YAAY;GAAEC,IAAIR;GAAa,GAAGkC,uBAAuB3B,UAAU;EAAE;EACrEI,UAAU,CAAC,IAAI;CACjB;AACF;AAEA,SAAgBkC,8BACdC,aACAC,oBACAE,aACAG,kCAAkB,IAAIJ,IAAkD,GAM5D;CACZ,MAAMf,UAAUD,OAAOyB,OAAOX,WAAW;CACzC,IAAIb,QAAQyB,WAAW,GAAG,OAAOjD,KAAAA;CAEjC,MAAMkD,yBAAS,IAAIX,IAA+C;CAClE,KAAK,MAAMY,OAAO3B,SAAS;EACzB,MAAM4B,OAAOF,OAAOG,IAAIF,IAAIG,IAAI,KAAK,CAAA;EACrCF,KAAKG,KAAKJ,GAAG;EACbD,OAAOM,IAAIL,IAAIG,MAAMF,IAAI;CAC3B;CAEA,MAAMN,QAAwC,CAAC;CAE/C,KAAK,MAAM,CAACQ,MAAMG,cAAcP,QAAQ;EACtC,MAAMQ,WAAW1E,qBAAqBsE,IAAI;EAC1C,IAAIR,MAAMY,WAAW;GACnB,IAAI5B,QAAQC,IAAIC,aAAa,cAC3BC,QAAQC,KACN,uCAAuCoB,KAAI,gEACNI,SAAQ,uBAC/C;GAEF;EACF;EAEA,MAAMC,QAAQF,UAAU;EACxB,MAAMG,gBAAgBtB,mBAAmBe,IAAIM,MAAM5D,EAAE;EACrD,MAAM8D,gBACJD,iBAAiBxE,SAASwE,cAAc9D,UAAU,IAC9CqB,uBAAuByC,cAAc9D,UAAU,oBAC/C,IAAIsB,IAAY;EAItB,MAAM0C,iBACJ/D,OACgD;GAChD,IAAI,OAAOA,OAAO,UAAU;IAC1B,MAAMoD,MAAMd,YAAYtC;IACxB,OAAOoD,KAAKG,SAASA,OAAOH,MAAMnD,KAAAA;GACpC;GACA,OAAOyD,UAAUR,WAAW,IAAIU,QAAQ3D,KAAAA;EAC1C;EAEA8C,MAAMY,YAAY;GAChBlE,MAAM;GACNE,aACE,+CAA+C4D,KAAI,KAAMK,MAAMjE,YAAW;GAI5EqE,YAAYnC,eAAegC,aAAa;GACxCI,YAAY,OAAOC,QAAQ,EAAEC,iBAAiB;IAC5C,IAAI;KACF,WAAW,MAAMC,eAAeF,OAAOG,KAAKC,aAAa,GAAG;MAC1D,IAAI,CAACF,eAAe,OAAOA,gBAAgB,UAAU;MACrD,MAAMC,OAAOD;MACb,MAAMG,OAAO/C,OAAO+C,KAAKF,IAAI;MAE7B,IADgBE,KAAKE,QAAQ,IACzBD,MAAYD,KAAKrB,SAAS,GAAG;MAEjC,MAAM,EAAElD,IAAI,GAAG8B,YAAYuC;MAC3B,IAAI7C,OAAO+C,KAAKzC,OAAO,CAAC,CAACoB,WAAW,GAAG;MACvC,MAAMwB,SAASX,cAAc/D,EAAE;MAC/B,IAAI,CAAC0E,QAAQ;MAEb,MAAMC,WAAW/B,gBAAgBU,IAAIa,UAAU;MAC/C,MAAMS,gBACJD,UAAU9B,aAAa6B,OAAO1E,KAAK2E,SAAS7B,QAAQ4B,OAAO5B;MAC7D,IAAI,CAAC6B,YAAYA,SAAS9B,aAAa6B,OAAO1E,IAC5C4C,gBAAgBa,IAAIU,YAAY;OAC9BtB,UAAU6B,OAAO1E;OACjB8C,OAAO4B,OAAO5B;MAChB,CAAC;MAGHL,YAAYiC,OAAO1E,KAAK2C,SACtBzD,8BAA8ByD,MAAMb,SAAS,EAAE8C,cAAc,CAAC,CAChE;KACF;IACF,QAAQ,CACN;GAEJ;GACAC,SAAS,OAAOR,MAAe,EAAEF,iBAAiB;IAChD,MAAM,EAAEnE,IAAI,GAAG8B,YAAauC,QAAQ,CAAC;IACrC,MAAMK,SAASX,cAAc/D,EAAE;IAC/B,IAAI,CAAC0E,QAAQ;KACX,MAAMI,WAAWpB,UAAU9B,KAAKmD,MAAMA,EAAE/E,EAAE;KAC1C,OAAO;MACLgF,SAAS;MACTC,OAAO,cAAcC,KAAKC,UAAUnF,EAAE,EAAC,qBAAsBuD,KAAI,gBAAiBuB,SAASM,KAAK,IAAI;KACtG;IACF;IACA,MAAMT,WAAW/B,gBAAgBU,IAAIa,UAAU;IAC/CvB,gBAAgByC,OAAOlB,UAAU;IACjC,MAAMmB,eAAyC,CAAC;IAChD7C,YAAYiC,OAAO1E,KAAK2C,SACtBzD,8BAA8ByD,MAAMb,SAAS;KAC3C8C,eACED,UAAU9B,aAAa6B,OAAO1E,KAAK2E,SAAS7B,QAAQ7C,KAAAA;KACtDsF,YAAY5E,UAAU;MACpB,MAAM6E,SAASpG,WAAW;MAC1B,CAACkG,aAAa3E,WAAW,CAAA,EAAA,CAAI6C,KAAKgC,MAAM;MACxC,OAAOA;KACT;KACA1B;IACF,CAAC,CACH;IAGA,MAAM2B,SAIF;KAAET,SAAS;KAAMhF,IAAI0E,OAAO1E;IAAG;IACnC,IAAIwB,OAAO+C,KAAKe,YAAY,CAAC,CAACpC,SAAS,GACrCuC,OAAOH,eAAeA;IAExB,OAAOG;GACT;EACF;CACF;CASA,OAAO;EAAE1C;EAAOC,2BAA2B,EAAE0C,eAPejE,QAAQG,KACjEwB,SAAS;GACRpD,IAAIoD,IAAIpD;GACRuD,MAAMH,IAAIG;GACVT,OAAOM,IAAIN;EACb,EAE2C4C,EAAc;CAAE;AAC/D"}

package/dist/react/index.d.ts

@@ -2,18 +2,19 @@
 /// <reference path="./types/store-augmentation.d.ts" />
 import { AssistantContextConfig } from "../model-context/types.js";
 import { PartState } from "../store/scopes/part.js";
+import { StreamingTimingAccessors, StreamingTimingOptions, StreamingTimingState } from "../runtime/utils/streaming-timing.js";
 import { AssistantProviderBase, AssistantProviderBaseProps, getRenderComponent } from "./AssistantProvider.js";
 import { AssistantRuntimeProvider } from "./AssistantRuntimeProvider.js";
 import { RuntimeAdapter } from "./RuntimeAdapter.js";
 import { TitleGenerationAdapter, createSimpleTitleAdapter } from "./adapters/TitleGenerationAdapter.js";
 import { AsyncStorageLike, createLocalStorageAdapter } from "./adapters/LocalStorageThreadListAdapter.js";
 import { DataRenderers } from "./client/DataRenderers.js";
-import { Interactables } from "./client/Interactables.js";
 import { DataMessagePartComponent, DataMessagePartProps, EmptyMessagePartComponent, EmptyMessagePartProps, FileMessagePartComponent, FileMessagePartProps, GenerativeUIComponentRegistry, GenerativeUIMessagePartComponent, GenerativeUIMessagePartProps, GenerativeUIRenderProps, ImageMessagePartComponent, ImageMessagePartProps, QuoteMessagePartComponent, QuoteMessagePartProps, ReasoningGroupComponent, ReasoningGroupProps, ReasoningMessagePartComponent, ReasoningMessagePartProps, SourceMessagePartComponent, SourceMessagePartProps, TextMessagePartComponent, TextMessagePartProps, ToolCallMessagePartComponent, ToolCallMessagePartProps, Unstable_AudioMessagePartComponent, Unstable_AudioMessagePartProps } from "./types/MessagePartComponentTypes.js";
+import { Unstable_InteractableDefinition, Unstable_InteractablePersistedState, Unstable_InteractablePersistenceAdapter, Unstable_InteractablePersistenceStatus, Unstable_InteractableRegistration, Unstable_InteractableStateSchema, Unstable_InteractablesClientSchema, Unstable_InteractablesConfig, Unstable_InteractablesMethods, Unstable_InteractablesState } from "./types/scopes/interactables.js";
+import { unstable_Interactables } from "./client/Interactables.js";
 import { McpAppResourceOutput, ToolsClientSchema, ToolsMethods, ToolsState } from "./types/scopes/tools.js";
 import { ToolCallText, ToolDefinition, Toolkit, ToolkitDefinition, ToolkitDefinitionEntry } from "./model-context/toolbox.js";
 import { Tools } from "./client/Tools.js";
-import { InteractableDefinition, InteractablePersistedState, InteractablePersistenceAdapter, InteractablePersistenceStatus, InteractableRegistration, InteractableStateSchema, InteractablesClientSchema, InteractablesMethods, InteractablesState } from "./types/scopes/interactables.js";
 import { AssistantToolProps, useAssistantTool } from "./model-context/useAssistantTool.js";
 import { AssistantTool, makeAssistantTool } from "./model-context/makeAssistantTool.js";
 import { AssistantToolUIProps, useAssistantToolUI } from "./model-context/useAssistantToolUI.js";
@@ -30,9 +31,15 @@ import { useAuiToolOverrides } from "./model-context/useAuiToolOverrides.js";
 import { hitl, hitlTool, humanTool } from "./model-context/human-tool.js";
 import { ProviderToolConfig, providerTool } from "./model-context/provider-tool.js";
 import { McpToolkitDefinition, defineMcpToolkit } from "./model-context/define-mcp-toolkit.js";
-import { AssistantInteractableProps, useAssistantInteractable } from "./model-context/useAssistantInteractable.js";
-import { useInteractableState } from "./model-context/useInteractableState.js";
+import { InteractableDefinition, InteractablePersistedState, InteractablePersistenceAdapter, InteractablePersistenceStatus, InteractableRegistration, InteractableStateSchema, InteractablesClientSchema, InteractablesMethods, InteractablesState } from "./interactables-legacy/scopes.js";
+import { AssistantInteractableProps, useAssistantInteractable } from "./interactables-legacy/useAssistantInteractable.js";
+import { useInteractableState } from "./interactables-legacy/useInteractableState.js";
+import { Unstable_InferInteractableState, Unstable_InteractableConfig, Unstable_InteractableVersionInfo, unstable_useInteractable } from "./model-context/useInteractable.js";
+import { unstable_useInteractableState } from "./model-context/useInteractableState.js";
+import { unstable_useInteractableVersions } from "./model-context/useInteractableVersions.js";
+import { Unstable_InteractableToolConfig, Unstable_InteractableToolRenderProps, unstable_interactableTool } from "./model-context/interactableTool.js";
 import { ToolArgsStatus, useToolArgsStatus } from "./model-context/useToolArgsStatus.js";
+import { Interactables } from "./interactables-legacy/Interactables.js";
 import { DataRenderersClientSchema, DataRenderersMethods, DataRenderersState } from "./types/scopes/dataRenderers.js";
 import { ComposerAttachmentByIndexProvider, MessageAttachmentByIndexProvider } from "./providers/AttachmentByIndexProvider.js";
 import { ThreadListItemRuntimeProvider } from "./providers/ThreadListItemRuntimeProvider.js";
@@ -50,13 +57,14 @@ import { useExternalStoreRuntime } from "./runtimes/useExternalStoreRuntime.js";
 import { useExternalStoreSharedOptions } from "./runtimes/useExternalStoreSharedOptions.js";
 import { JoinStrategy, convertExternalMessages, useExternalMessageConverter } from "./runtimes/external-message-converter.js";
 import { createMessageConverter } from "./runtimes/createMessageConverter.js";
+import { useStreamingTiming } from "./runtimes/useStreamingTiming.js";
 import { RemoteThreadListHookInstanceManager } from "./runtimes/RemoteThreadListHookInstanceManager.js";
 import { RemoteThreadListThreadListRuntimeCore } from "./runtimes/RemoteThreadListThreadListRuntimeCore.js";
 import { useRemoteThreadListRuntime } from "./runtimes/useRemoteThreadListRuntime.js";
 import { useCloudThreadListAdapter } from "./runtimes/cloud/useCloudThreadListAdapter.js";
 import { useAssistantCloudThreadHistoryAdapter } from "./runtimes/cloud/AssistantCloudThreadHistoryAdapter.js";
 import { CloudFileAttachmentAdapter } from "./runtimes/cloud/CloudFileAttachmentAdapter.js";
-import { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl } from "./primitives/thread/ThreadMessages.js";
+import { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveUnstable_MessageById } from "./primitives/thread/ThreadMessages.js";
 import { EnrichedPartState, MessagePartComponent, MessagePrimitivePartByIndex, MessagePrimitiveParts, defaultComponents } from "./primitives/message/MessageParts.js";
 import { GroupByContext, groupPartByType } from "./utils/groupParts.js";
 import { MessagePrimitiveGroupedParts } from "./primitives/message/MessageGroupedParts.js";
@@ -74,6 +82,7 @@ import { ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPri
 import { ComposerPrimitiveIf, UseComposerIfProps } from "./primitives/composer/ComposerIf.js";
 import { getMessageQuote } from "./utils/getMessageQuote.js";
 import { useThreadMessages } from "./primitive-hooks/useThreadMessages.js";
+import { unstable_useThreadMessageIds } from "./primitive-hooks/useThreadMessageIds.js";
 import { useThreadIsRunning } from "./primitive-hooks/useThreadIsRunning.js";
 import { useThreadIsEmpty } from "./primitive-hooks/useThreadIsEmpty.js";
 import { useComposerSend } from "./primitive-hooks/useComposerSend.js";
@@ -102,4 +111,4 @@ import { useEditComposerCancel } from "./primitive-hooks/useEditComposerCancel.j
 import { useEditComposerSend } from "./primitive-hooks/useEditComposerSend.js";
 import { useMessageError } from "./primitive-hooks/useMessageError.js";
 import { LocalRuntimeOptions, splitLocalRuntimeOptions, useLocalRuntime } from "./runtimes/useLocalRuntime.js";
-export { type AssistantContextConfig, type AssistantDataUI, type AssistantDataUIProps, type AssistantInteractableProps, AssistantProviderBase, type AssistantProviderBaseProps, AssistantRuntimeProvider, type AssistantTool, type AssistantToolProps, type AssistantToolUI, type AssistantToolUIProps, type AsyncStorageLike, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, type DataMessagePartComponent, type DataMessagePartProps, DataRenderers, type DataRenderersClientSchema, type DataRenderersMethods, type DataRenderersState, type EmptyMessagePartComponent, type EmptyMessagePartProps, type EnrichedPartState, type FileMessagePartComponent, type FileMessagePartProps, type GenerativeUIComponentRegistry, type GenerativeUIMessagePartComponent, type GenerativeUIMessagePartProps, GenerativeUIRender, GenerativeUIRenderError, type GenerativeUIRenderProps, type GroupByContext, type ImageMessagePartComponent, type ImageMessagePartProps, type InteractableDefinition, type InteractablePersistedState, type InteractablePersistenceAdapter, type InteractablePersistenceStatus, type InteractableRegistration, type InteractableStateSchema, Interactables, type InteractablesClientSchema, type InteractablesMethods, type InteractablesState, type JoinStrategy, type LocalRuntimeOptions, type McpAppResourceOutput, type McpToolkitDefinition, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, type PartState, type ProviderToolConfig, QueueItemByIndexProvider, type QueueItemByIndexProviderProps, type QuoteMessagePartComponent, type QuoteMessagePartProps, ReadonlyThreadProvider, type ReasoningGroupComponent, type ReasoningGroupProps, type ReasoningMessagePartComponent, type ReasoningMessagePartProps, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, type RuntimeAdapters, type SourceMessagePartComponent, type SourceMessagePartProps, SuggestionByIndexProvider, type SuggestionByIndexProviderProps, type TextMessagePartComponent, type TextMessagePartProps, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, type TitleGenerationAdapter, type ToolArgsStatus, type ToolCallMessagePartComponent, type ToolCallMessagePartProps, type ToolCallText, type ToolDefinition, type Toolkit, type ToolkitDefinition, type ToolkitDefinitionEntry, Tools, type ToolsClientSchema, type ToolsMethods, type ToolsState, type Unstable_AudioMessagePartComponent, type Unstable_AudioMessagePartProps, type UseActionBarCopyOptions, type UseComposerIfProps, type UseSuggestionTriggerOptions, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, defineMcpToolkit, defineToolkit, externalTool, getMessageQuote, getRenderComponent, groupPartByType, hitl, hitlTool, humanTool, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, providerTool, splitLocalRuntimeOptions, stubTool, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useAuiToolOverrides, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useExternalStoreSharedOptions, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };
+export { type AssistantContextConfig, type AssistantDataUI, type AssistantDataUIProps, type AssistantInteractableProps, AssistantProviderBase, type AssistantProviderBaseProps, AssistantRuntimeProvider, type AssistantTool, type AssistantToolProps, type AssistantToolUI, type AssistantToolUIProps, type AsyncStorageLike, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, type DataMessagePartComponent, type DataMessagePartProps, DataRenderers, type DataRenderersClientSchema, type DataRenderersMethods, type DataRenderersState, type EmptyMessagePartComponent, type EmptyMessagePartProps, type EnrichedPartState, type FileMessagePartComponent, type FileMessagePartProps, type GenerativeUIComponentRegistry, type GenerativeUIMessagePartComponent, type GenerativeUIMessagePartProps, GenerativeUIRender, GenerativeUIRenderError, type GenerativeUIRenderProps, type GroupByContext, type ImageMessagePartComponent, type ImageMessagePartProps, type InteractableDefinition, type InteractablePersistedState, type InteractablePersistenceAdapter, type InteractablePersistenceStatus, type InteractableRegistration, type InteractableStateSchema, Interactables, type InteractablesClientSchema, type InteractablesMethods, type InteractablesState, type JoinStrategy, type LocalRuntimeOptions, type McpAppResourceOutput, type McpToolkitDefinition, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, type PartState, type ProviderToolConfig, QueueItemByIndexProvider, type QueueItemByIndexProviderProps, type QuoteMessagePartComponent, type QuoteMessagePartProps, ReadonlyThreadProvider, type ReasoningGroupComponent, type ReasoningGroupProps, type ReasoningMessagePartComponent, type ReasoningMessagePartProps, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, type RuntimeAdapters, type SourceMessagePartComponent, type SourceMessagePartProps, type StreamingTimingAccessors, type StreamingTimingOptions, type StreamingTimingState, SuggestionByIndexProvider, type SuggestionByIndexProviderProps, type TextMessagePartComponent, type TextMessagePartProps, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, ThreadPrimitiveUnstable_MessageById, type TitleGenerationAdapter, type ToolArgsStatus, type ToolCallMessagePartComponent, type ToolCallMessagePartProps, type ToolCallText, type ToolDefinition, type Toolkit, type ToolkitDefinition, type ToolkitDefinitionEntry, Tools, type ToolsClientSchema, type ToolsMethods, type ToolsState, type Unstable_AudioMessagePartComponent, type Unstable_AudioMessagePartProps, type Unstable_InferInteractableState, type Unstable_InteractableConfig, type Unstable_InteractableDefinition, type Unstable_InteractablePersistedState, type Unstable_InteractablePersistenceAdapter, type Unstable_InteractablePersistenceStatus, type Unstable_InteractableRegistration, type Unstable_InteractableStateSchema, type Unstable_InteractableToolConfig, type Unstable_InteractableToolRenderProps, type Unstable_InteractableVersionInfo, type Unstable_InteractablesClientSchema, type Unstable_InteractablesConfig, type Unstable_InteractablesMethods, type Unstable_InteractablesState, type UseActionBarCopyOptions, type UseComposerIfProps, type UseSuggestionTriggerOptions, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, defineMcpToolkit, defineToolkit, externalTool, getMessageQuote, getRenderComponent, groupPartByType, hitl, hitlTool, humanTool, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, providerTool, splitLocalRuntimeOptions, stubTool, unstable_Interactables, unstable_interactableTool, unstable_useInteractable, unstable_useInteractableState, unstable_useInteractableVersions, unstable_useThreadMessageIds, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useAuiToolOverrides, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useExternalStoreSharedOptions, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useStreamingTiming, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };

package/dist/react/index.js

@@ -19,10 +19,15 @@ import { useAuiToolOverrides } from "./model-context/useAuiToolOverrides.js";
 import { hitl, hitlTool, humanTool } from "./model-context/human-tool.js";
 import { providerTool } from "./model-context/provider-tool.js";
 import { defineMcpToolkit } from "./model-context/define-mcp-toolkit.js";
-import { useAssistantInteractable } from "./model-context/useAssistantInteractable.js";
-import { useInteractableState } from "./model-context/useInteractableState.js";
+import { useAssistantInteractable } from "./interactables-legacy/useAssistantInteractable.js";
+import { useInteractableState } from "./interactables-legacy/useInteractableState.js";
+import { unstable_useInteractableState } from "./model-context/useInteractableState.js";
+import { unstable_useInteractable } from "./model-context/useInteractable.js";
+import { unstable_useInteractableVersions } from "./model-context/useInteractableVersions.js";
+import { unstable_interactableTool } from "./model-context/interactableTool.js";
 import { useToolArgsStatus } from "./model-context/useToolArgsStatus.js";
-import { Interactables } from "./client/Interactables.js";
+import { Interactables } from "./interactables-legacy/Interactables.js";
+import { unstable_Interactables } from "./client/Interactables.js";
 import { ComposerAttachmentByIndexProvider, MessageAttachmentByIndexProvider } from "./providers/AttachmentByIndexProvider.js";
 import { ThreadListItemRuntimeProvider } from "./providers/ThreadListItemRuntimeProvider.js";
 import { MessageByIndexProvider } from "./providers/MessageByIndexProvider.js";
@@ -39,6 +44,7 @@ import { useExternalStoreRuntime } from "./runtimes/useExternalStoreRuntime.js";
 import { useExternalStoreSharedOptions } from "./runtimes/useExternalStoreSharedOptions.js";
 import { convertExternalMessages, useExternalMessageConverter } from "./runtimes/external-message-converter.js";
 import { createMessageConverter } from "./runtimes/createMessageConverter.js";
+import { useStreamingTiming } from "./runtimes/useStreamingTiming.js";
 import { RemoteThreadListHookInstanceManager } from "./runtimes/RemoteThreadListHookInstanceManager.js";
 import { RemoteThreadListThreadListRuntimeCore } from "./runtimes/RemoteThreadListThreadListRuntimeCore.js";
 import { useRemoteThreadListRuntime } from "./runtimes/useRemoteThreadListRuntime.js";
@@ -47,7 +53,7 @@ import { CloudFileAttachmentAdapter } from "./runtimes/cloud/CloudFileAttachment
 import { useCloudThreadListAdapter } from "./runtimes/cloud/useCloudThreadListAdapter.js";
 import { createLocalStorageAdapter } from "./adapters/LocalStorageThreadListAdapter.js";
 import { createSimpleTitleAdapter } from "./adapters/TitleGenerationAdapter.js";
-import { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl } from "./primitives/thread/ThreadMessages.js";
+import { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveUnstable_MessageById } from "./primitives/thread/ThreadMessages.js";
 import { getMessageQuote } from "./utils/getMessageQuote.js";
 import { GenerativeUIRender, GenerativeUIRenderError, MessagePrimitiveGenerativeUI } from "./primitives/generativeUI/GenerativeUI.js";
 import { MessagePartComponent, MessagePrimitivePartByIndex, MessagePrimitiveParts, defaultComponents } from "./primitives/message/MessageParts.js";
@@ -65,6 +71,7 @@ import { ThreadListItemPrimitiveTitle } from "./primitives/threadListItem/Thread
 import { ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl } from "./primitives/thread/ThreadSuggestions.js";
 import { ComposerPrimitiveIf } from "./primitives/composer/ComposerIf.js";
 import { useThreadMessages } from "./primitive-hooks/useThreadMessages.js";
+import { unstable_useThreadMessageIds } from "./primitive-hooks/useThreadMessageIds.js";
 import { useThreadIsRunning } from "./primitive-hooks/useThreadIsRunning.js";
 import { useThreadIsEmpty } from "./primitive-hooks/useThreadIsEmpty.js";
 import { useComposerSend } from "./primitive-hooks/useComposerSend.js";
@@ -93,4 +100,4 @@ import { useEditComposerCancel } from "./primitive-hooks/useEditComposerCancel.j
 import { useEditComposerSend } from "./primitive-hooks/useEditComposerSend.js";
 import { useMessageError } from "./primitive-hooks/useMessageError.js";
 import { splitLocalRuntimeOptions, useLocalRuntime } from "./runtimes/useLocalRuntime.js";
-export { AssistantProviderBase, AssistantRuntimeProvider, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, DataRenderers, GenerativeUIRender, GenerativeUIRenderError, Interactables, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, QueueItemByIndexProvider, ReadonlyThreadProvider, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, SuggestionByIndexProvider, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, Tools, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, defineMcpToolkit, defineToolkit, externalTool, getMessageQuote, getRenderComponent, groupPartByType, hitl, hitlTool, humanTool, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, providerTool, splitLocalRuntimeOptions, stubTool, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useAuiToolOverrides, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useExternalStoreSharedOptions, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };
+export { AssistantProviderBase, AssistantRuntimeProvider, ChainOfThoughtByIndicesProvider, ChainOfThoughtPartByIndexProvider, ChainOfThoughtPrimitiveParts, CloudFileAttachmentAdapter, ComposerAttachmentByIndexProvider, ComposerPrimitiveAttachmentByIndex, ComposerPrimitiveAttachments, ComposerPrimitiveIf, ComposerPrimitiveQueue, DataRenderers, GenerativeUIRender, GenerativeUIRenderError, Interactables, MessageAttachmentByIndexProvider, MessageByIndexProvider, MessagePartComponent, MessagePartPrimitiveInProgress, MessagePrimitiveAttachmentByIndex, MessagePrimitiveAttachments, MessagePrimitiveGenerativeUI, MessagePrimitiveGroupedParts, MessagePrimitivePartByIndex, MessagePrimitiveParts, MessagePrimitiveQuote, PartByIndexProvider, PartPrimitiveMessages, PartPrimitiveMessagesImpl, QueueItemByIndexProvider, ReadonlyThreadProvider, RemoteThreadListHookInstanceManager, RemoteThreadListThreadListRuntimeCore, RuntimeAdapter, RuntimeAdapterProvider, SuggestionByIndexProvider, TextMessagePartProvider, ThreadListItemByIndexProvider, ThreadListItemPrimitiveTitle, ThreadListItemRuntimeProvider, ThreadListPrimitiveItemByIndex, ThreadListPrimitiveItems, ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, ThreadPrimitiveUnstable_MessageById, Tools, convertExternalMessages, createLocalStorageAdapter, createMessageConverter, createSimpleTitleAdapter, defineMcpToolkit, defineToolkit, externalTool, getMessageQuote, getRenderComponent, groupPartByType, hitl, hitlTool, humanTool, makeAssistantDataUI, makeAssistantTool, makeAssistantToolUI, defaultComponents as messagePartsDefaultComponents, providerTool, splitLocalRuntimeOptions, stubTool, unstable_Interactables, unstable_interactableTool, unstable_useInteractable, unstable_useInteractableState, unstable_useInteractableVersions, unstable_useThreadMessageIds, useActionBarCopy, useActionBarEdit, useActionBarFeedbackNegative, useActionBarFeedbackPositive, useActionBarReload, useActionBarSpeak, useActionBarStopSpeaking, useAssistantCloudThreadHistoryAdapter, useAssistantContext, useAssistantDataUI, useAssistantInstructions, useAssistantInteractable, useAssistantTool, useAssistantToolUI, useAuiToolOverrides, useBranchPickerNext, useBranchPickerPrevious, useCloudThreadListAdapter, useComposerAddAttachment, useComposerCancel, useComposerDictate, useComposerSend, useEditComposerCancel, useEditComposerSend, useExternalMessageConverter, useExternalStoreRuntime, useExternalStoreSharedOptions, useInlineRender, useInteractableState, useLocalRuntime, useMessageBranching, useMessageError, useMessageReload, useRemoteThreadListRuntime, useRuntimeAdapters, useStreamingTiming, useSuggestionTrigger, useThreadIsEmpty, useThreadIsRunning, useThreadListItemArchive, useThreadListItemDelete, useThreadListItemTrigger, useThreadListItemUnarchive, useThreadListLoadMore, useThreadListNew, useThreadMessages, useToolArgsStatus, useVoiceControls, useVoiceState, useVoiceVolume };

package/dist/react/interactables-legacy/Interactables.d.ts

@@ -0,0 +1,12 @@
+import { ClientOutput } from "@assistant-ui/store";
+
+//#region src/react/interactables-legacy/Interactables.d.ts
+/**
+ * @deprecated Since 2026-06-14 — migrate to the Unstable / Experimental API.
+ * Scheduled for removal on/after 2026-09-14. See
+ * {@link https://www.assistant-ui.com/docs/tools/interactables#migrating-from-the-previous-api | Interactables migration guide}.
+ */
+declare const Interactables: import("@assistant-ui/tap").Resource<ClientOutput<"interactables">, []>;
+//#endregion
+export { Interactables };
+//# sourceMappingURL=Interactables.d.ts.map

package/dist/react/interactables-legacy/Interactables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Interactables.d.ts","names":[],"sources":["../../../src/react/interactables-legacy/Interactables.ts"],"mappings":";;;;;AAqUA;;;cAAa,aAAA,8BAAa,QAAA,CAAA,YAAA"}