@assistant-ui/core 0.2.17 → 0.2.19

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":"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"}

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"}