glchat-a2ui-react-renderer 0.3.1 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -17,8 +17,10 @@ export type ProviderProps = {
17
17
  */
18
18
  messages?: A2UIMessage[];
19
19
  /**
20
- * A2UI protocol version. When omitted, defaults to `v0.9` until messages
21
- * arrive, then auto-detects from the first message.
20
+ * A2UI protocol version. When omitted, renders as `v0.9` provisionally until
21
+ * messages arrive, then auto-detects and locks from the first detectable
22
+ * message. The provisional default is not locked, so streaming can start
23
+ * empty and still settle on `v0.8` or `v0.9`.
22
24
  */
23
25
  version?: A2UIVersion;
24
26
  onAction?: ActionHandler;
@@ -1 +1 @@
1
- {"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../src/Provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,WAAW,EAGjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAChD,uEAAuE;IACvE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wDAAwD;IACxD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,CAAC;AAgBF,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,QAAQ,EACR,OAAO,EACP,KAAK,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,GACT,EAAE,QAAQ,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,+BAkE5C;AAED,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
1
+ {"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../src/Provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,WAAW,EAGjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAChD,uEAAuE;IACvE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wDAAwD;IACxD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,CAAC;AAoBF,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,QAAQ,EACR,OAAO,EACP,KAAK,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,GACT,EAAE,QAAQ,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,+BAuE5C;AAED,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
@@ -5,15 +5,18 @@ import { detectMessagesVersion, } from './utils/detectVersion.js';
5
5
  import { V08Provider } from './v0_8/Provider.js';
6
6
  import { V09Provider } from './v0_9/Provider.js';
7
7
  const A2UIVersionContext = createContext('v0.9');
8
- function resolveVersion(versionProp, messages) {
8
+ /**
9
+ * Returns a definitive version when the caller set `version`, or when messages
10
+ * contain a detectable protocol version. Returns `null` while still provisional
11
+ * (no prop and no detectable messages yet) so we do not lock the default.
12
+ */
13
+ function resolveKnownVersion(versionProp, messages) {
9
14
  if (versionProp)
10
15
  return versionProp;
11
16
  if (messages?.length) {
12
- const detected = detectMessagesVersion(messages);
13
- if (detected)
14
- return detected;
17
+ return detectMessagesVersion(messages);
15
18
  }
16
- return 'v0.9';
19
+ return null;
17
20
  }
18
21
  export function Provider({ messages, version: versionProp, onAction, onError, theme, catalog, registry, children, }) {
19
22
  const onErrorRef = useRef(onError);
@@ -21,16 +24,19 @@ export function Provider({ messages, version: versionProp, onAction, onError, th
21
24
  useEffect(() => {
22
25
  onErrorRef.current = onError;
23
26
  }, [onError]);
24
- const resolvedVersion = useMemo(() => resolveVersion(versionProp, messages), [versionProp, messages]);
25
- const [activeVersion, setActiveVersion] = useState(resolvedVersion);
27
+ const knownVersion = useMemo(() => resolveKnownVersion(versionProp, messages), [versionProp, messages]);
28
+ const [activeVersion, setActiveVersion] = useState(() => knownVersion ?? 'v0.9');
26
29
  useEffect(() => {
30
+ // Empty / undetectable messages stay provisional — do not lock to v0.9.
31
+ if (knownVersion === null)
32
+ return;
27
33
  if (lockedVersionRef.current === null) {
28
- lockedVersionRef.current = resolvedVersion;
29
- setActiveVersion(resolvedVersion);
34
+ lockedVersionRef.current = knownVersion;
35
+ setActiveVersion(knownVersion);
30
36
  return;
31
37
  }
32
- if (resolvedVersion !== lockedVersionRef.current) {
33
- const error = new Error(`A2UI version mismatch: Provider is locked to ${lockedVersionRef.current}, but messages indicate ${resolvedVersion}.`);
38
+ if (knownVersion !== lockedVersionRef.current) {
39
+ const error = new Error(`A2UI version mismatch: Provider is locked to ${lockedVersionRef.current}, but messages indicate ${knownVersion}.`);
34
40
  if (onErrorRef.current) {
35
41
  onErrorRef.current(error);
36
42
  }
@@ -40,8 +46,8 @@ export function Provider({ messages, version: versionProp, onAction, onError, th
40
46
  }
41
47
  return;
42
48
  }
43
- setActiveVersion(resolvedVersion);
44
- }, [resolvedVersion]);
49
+ setActiveVersion(knownVersion);
50
+ }, [knownVersion]);
45
51
  if (activeVersion === 'v0.8') {
46
52
  return (_jsx(A2UIVersionContext.Provider, { value: "v0.8", children: _jsx(V08Provider, { messages: messages, theme: theme, onAction: onAction, onError: onError, registry: registry, children: children }) }));
47
53
  }
@@ -1 +1 @@
1
- {"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../src/v0_9/Provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,EAAmB,KAAK,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAChD,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAClF,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;CACjD,CAAC;AAMF,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,OAAO,EACP,QAAQ,GACT,EAAE,QAAQ,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,+BA6D/C;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CAAC,4BAA4B,CAAC,CAIjF"}
1
+ {"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../src/v0_9/Provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,EAAmB,KAAK,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAChD,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAClF,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;CACjD,CAAC;AAMF,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,OAAO,EACP,QAAQ,GACT,EAAE,QAAQ,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,+BAgE/C;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CAAC,4BAA4B,CAAC,CAIjF"}
@@ -5,7 +5,7 @@ import { MarkdownContext } from '@a2ui/react/v0_9';
5
5
  import { MessageProcessor, } from '@a2ui/web_core/v0_9';
6
6
  import { injectBasicCatalogStyles } from '@a2ui/web_core/v0_9/basic_catalog';
7
7
  import { renderMarkdown } from '@a2ui/markdown-it';
8
- import { createGlchatCatalog } from './catalog.js';
8
+ import { createGlchatCatalog, GLCHAT_CATALOG_ID, withFallbackCatalogId } from './catalog.js';
9
9
  const SurfaceGroupContext = createContext(null);
10
10
  export function V09Provider({ messages, onAction, onError, catalog, children, }) {
11
11
  const onActionRef = useRef(onAction);
@@ -40,7 +40,7 @@ export function V09Provider({ messages, onAction, onError, catalog, children, })
40
40
  }
41
41
  if (processedCountRef.current >= messages.length)
42
42
  return;
43
- const pending = messages.slice(processedCountRef.current);
43
+ const pending = withFallbackCatalogId(messages.slice(processedCountRef.current), catalog?.id ?? GLCHAT_CATALOG_ID);
44
44
  processedCountRef.current = messages.length;
45
45
  try {
46
46
  processor.processMessages(pending);
@@ -1,5 +1,5 @@
1
1
  import { type ReactComponentImplementation } from '@a2ui/react/v0_9';
2
- import { Catalog } from '@a2ui/web_core/v0_9';
2
+ import { Catalog, type A2uiMessage } from '@a2ui/web_core/v0_9';
3
3
  /**
4
4
  * Catalog identifier for the GLChat extended A2UI v0.9 catalog.
5
5
  */
@@ -15,4 +15,10 @@ export declare const GLCHAT_CATALOG_EXTENSIONS: readonly ["TagInput", "Timeout"]
15
15
  * - Reuses basic catalog functions unchanged.
16
16
  */
17
17
  export declare function createGlchatCatalog(): Catalog<ReactComponentImplementation>;
18
+ /**
19
+ * Rewrites `createSurface.catalogId` to the given `registeredId` when the
20
+ * message uses an unrecognized catalog. This prevents "Catalog not found"
21
+ * errors from the upstream `MessageProcessor`.
22
+ */
23
+ export declare function withFallbackCatalogId(messages: A2uiMessage[], registeredId: string): A2uiMessage[];
18
24
  //# sourceMappingURL=catalog.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/v0_9/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAO9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,iIACkG,CAAC;AAKjI,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,qBAAsB,CAAC;AAE5D,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,kCAAmC,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAgB3E"}
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/v0_9/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOhE;;GAEG;AACH,eAAO,MAAM,iBAAiB,iIACkG,CAAC;AAKjI,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,qBAAsB,CAAC;AAE5D,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,kCAAmC,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAgB3E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,EAAE,EACvB,YAAY,EAAE,MAAM,GACnB,WAAW,EAAE,CAqBf"}
@@ -32,3 +32,28 @@ export function createGlchatCatalog() {
32
32
  const functions = Array.from(basicCatalog.functions.values());
33
33
  return new Catalog(GLCHAT_CATALOG_ID, components, functions);
34
34
  }
35
+ /**
36
+ * Rewrites `createSurface.catalogId` to the given `registeredId` when the
37
+ * message uses an unrecognized catalog. This prevents "Catalog not found"
38
+ * errors from the upstream `MessageProcessor`.
39
+ */
40
+ export function withFallbackCatalogId(messages, registeredId) {
41
+ return messages.map((msg) => {
42
+ if (msg &&
43
+ typeof msg === 'object' &&
44
+ 'createSurface' in msg &&
45
+ msg.createSurface &&
46
+ typeof msg.createSurface === 'object' &&
47
+ 'catalogId' in msg.createSurface &&
48
+ msg.createSurface.catalogId !== registeredId) {
49
+ return {
50
+ ...msg,
51
+ createSurface: {
52
+ ...msg.createSurface,
53
+ catalogId: registeredId,
54
+ },
55
+ };
56
+ }
57
+ return msg;
58
+ });
59
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "glchat-a2ui-react-renderer",
3
- "version": "0.3.1",
3
+ "version": "0.3.2",
4
4
  "description": "A2UI (Agent-to-UI) React renderer for GLChat — render declarative UI from AI agent messages",
5
5
  "author": {
6
6
  "name": "GDP Labs",