@ai37/copilotkit-chat-helpers 0.1.0 → 0.2.0

package/README.md

@@ -56,7 +56,12 @@ export function Providers({ children }) {
 - `createCollapsibleA2uiRenderer(base, options?)` — оборачивает renderer из
   `createA2UIMessageRenderer`: переопределяет только `render` (обёртка в
   `CollapsibleForm` по `message.id`), `activityType`/`content` наследуются.
-  `options.title` — заголовок свёрнутой формы (по умолчанию `"Форма"`).
+  Заголовок аккордеона берётся из данных агента: title первого компонента в
+  операциях A2UI (у FormCard/ChoiceCard обязателен по схеме каталога). Пока
+  операций нет (стрим) или title отсутствует — фолбэк `options.title`
+  (по умолчанию `"Форма"`).
+- `extractA2uiTitle(operations)` — сам извлекатель заголовка из операций A2UI
+  v0.9 (`content.a2ui_operations`); `undefined`, если titled-компонента нет.
 - `FormAccordionProvider` / `useFormAccordion` — стейт аккордеона
   (`openId`/`register`/`toggle`): новая форма открывается, прежние сворачиваются;
   ручной toggle переживает перерендер.

package/dist/createCollapsibleA2uiRenderer.d.ts

@@ -1,8 +1,14 @@
 import type { ComponentType } from "react";
 type Options = {
-    /** Заголовок свёрнутой формы. По умолчанию — "Форма". */
+    /** Фолбэк-заголовок, когда в операциях нет компонента с title. По умолчанию — "Форма". */
     title?: string;
 };
+/**
+ * Заголовок из операций A2UI v0.9: title первого компонента updateComponents,
+ * у которого он непустая строка (пропы лежат плоско рядом с `component`).
+ * Незнакомая форма данных → undefined (фолбэк у вызывающего), не бросаем.
+ */
+export declare function extractA2uiTitle(operations: unknown[] | undefined): string | undefined;
 export declare function createCollapsibleA2uiRenderer<T extends {
     render: ComponentType<any>;
 }>(base: T, options?: Options): T;

package/dist/createCollapsibleA2uiRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createCollapsibleA2uiRenderer.d.ts","sourceRoot":"","sources":["../src/createCollapsibleA2uiRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAkB1C,KAAK,OAAO,GAAG;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAID,wBAAgB,6BAA6B,CAC3C,CAAC,SAAS;IAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;CAAE,EACxC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAY/B"}
+{"version":3,"file":"createCollapsibleA2uiRenderer.d.ts","sourceRoot":"","sources":["../src/createCollapsibleA2uiRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AA2B1C,KAAK,OAAO,GAAG;IACb,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAYtF;AAED,wBAAgB,6BAA6B,CAC3C,CAAC,SAAS;IAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;CAAE,EACxC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAiB/B"}

package/dist/createCollapsibleA2uiRenderer.js

@@ -2,13 +2,36 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { CollapsibleForm } from "./CollapsibleForm";
 const A2UI_TITLE = "Форма";
+/**
+ * Заголовок из операций A2UI v0.9: title первого компонента updateComponents,
+ * у которого он непустая строка (пропы лежат плоско рядом с `component`).
+ * Незнакомая форма данных → undefined (фолбэк у вызывающего), не бросаем.
+ */
+export function extractA2uiTitle(operations) {
+    if (!Array.isArray(operations))
+        return undefined;
+    for (const op of operations) {
+        const components = op
+            ?.updateComponents?.components;
+        if (!Array.isArray(components))
+            continue;
+        for (const component of components) {
+            const title = component?.title;
+            if (typeof title === "string" && title.trim() !== "")
+                return title;
+        }
+    }
+    return undefined;
+}
 export function createCollapsibleA2uiRenderer(base, options) {
-    const title = options?.title ?? A2UI_TITLE;
+    const fallbackTitle = options?.title ?? A2UI_TITLE;
     // Сужение до минимального контракта: точный тип пропов знает только консюмер.
     const Base = base.render;
     return {
         ...base,
-        render: (props) => (_jsx(CollapsibleForm, { id: props.message.id, title: title, children: _jsx(Base, { ...props }) })),
+        // Заголовок считаем на каждый рендер: content меняется по мере стрима —
+        // сначала операций нет (фолбэк), потом приходит title от агента.
+        render: (props) => (_jsx(CollapsibleForm, { id: props.message.id, title: extractA2uiTitle(props.content?.a2ui_operations) ?? fallbackTitle, children: _jsx(Base, { ...props }) })),
     };
 }
 //# sourceMappingURL=createCollapsibleA2uiRenderer.js.map

package/dist/createCollapsibleA2uiRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCollapsibleA2uiRenderer.js","sourceRoot":"","sources":["../src/createCollapsibleA2uiRenderer.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAGZ,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAsBnD,MAAM,UAAU,GAAG,OAAO,CAAA;AAE1B,MAAM,UAAU,6BAA6B,CAE3C,IAAO,EAAE,OAAiB;IAC1B,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,UAAU,CAAA;IAC1C,8EAA8E;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,MAA2C,CAAA;IAC7D,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,CAAC,KAAyB,EAAE,EAAE,CAAC,CACrC,KAAC,eAAe,IAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,YACjD,KAAC,IAAI,OAAK,KAAK,GAAI,GACH,CACnB;KACG,CAAA;AACR,CAAC"}
+{"version":3,"file":"createCollapsibleA2uiRenderer.js","sourceRoot":"","sources":["../src/createCollapsibleA2uiRenderer.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAGZ,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AA+BnD,MAAM,UAAU,GAAG,OAAO,CAAA;AAE1B;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAiC;IAChE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAA;IAChD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAI,EAA+D;YACjF,EAAE,gBAAgB,EAAE,UAAU,CAAA;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;YAAE,SAAQ;QACxC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,KAAK,GAAI,SAAwC,EAAE,KAAK,CAAA;YAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,OAAO,KAAK,CAAA;QACpE,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAE3C,IAAO,EAAE,OAAiB;IAC1B,MAAM,aAAa,GAAG,OAAO,EAAE,KAAK,IAAI,UAAU,CAAA;IAClD,8EAA8E;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,MAA2C,CAAA;IAC7D,OAAO;QACL,GAAG,IAAI;QACP,wEAAwE;QACxE,iEAAiE;QACjE,MAAM,EAAE,CAAC,KAAyB,EAAE,EAAE,CAAC,CACrC,KAAC,eAAe,IACd,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,EACpB,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,aAAa,YAExE,KAAC,IAAI,OAAK,KAAK,GAAI,GACH,CACnB;KACG,CAAA;AACR,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { FormAccordionProvider, useFormAccordion } from "./FormAccordionContext";
 export { CollapsibleForm } from "./CollapsibleForm";
-export { createCollapsibleA2uiRenderer } from "./createCollapsibleA2uiRenderer";
+export { createCollapsibleA2uiRenderer, extractA2uiTitle, } from "./createCollapsibleA2uiRenderer";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,GACjB,MAAM,iCAAiC,CAAA"}

package/dist/index.js

@@ -1,4 +1,4 @@
 export { FormAccordionProvider, useFormAccordion } from "./FormAccordionContext";
 export { CollapsibleForm } from "./CollapsibleForm";
-export { createCollapsibleA2uiRenderer } from "./createCollapsibleA2uiRenderer";
+export { createCollapsibleA2uiRenderer, extractA2uiTitle, } from "./createCollapsibleA2uiRenderer";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,GACjB,MAAM,iCAAiC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai37/copilotkit-chat-helpers",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CopilotKit v2 chat helpers: accordion wrapper for A2UI activity message renderers (one form open at a time).",
   "license": "Apache-2.0",
   "type": "module",