@bikdotai/bik-component-library 0.0.821-beta.4 → 0.0.821-beta.6

package/dist/esm/components/agent-builder/components/StepRail.js

@@ -0,0 +1,35 @@
+import { jsx as t, jsxs as s } from "react/jsx-runtime";
+import { TitleSmall as S, BodySecondary as p } from "../../TypographyStyle.js";
+import { COLORS as v } from "../../../constants/Theme.js";
+import { RailList as y, RailItem as x, StepBadge as f } from "../AgentBuilder.styled.js";
+import { STEP_DEFINITIONS as g } from "../constants/steps.js";
+import { useAgentBuilderContext as k } from "../context/AgentBuilderContext.js";
+const T = () => {
+  const {
+    activeStep: a,
+    activeIndex: n,
+    validation: c,
+    goToStep: l,
+    disableStepNavigation: i
+  } = k();
+  return /* @__PURE__ */ t(y, { children: g.map((e) => {
+    const o = e.key === a, r = e.index - 1 < n && c[e.key], d = o ? "active" : r ? "complete" : "inactive", m = o ? S : p;
+    return /* @__PURE__ */ s(
+      x,
+      {
+        "data-test": `agent-step-${e.key}`,
+        disabled: i,
+        onClick: i ? void 0 : () => l(e.key),
+        children: [
+          /* @__PURE__ */ t(f, { state: d, children: r ? "✓" : e.index }),
+          /* @__PURE__ */ t(m, { color: v.content.primary, children: e.title })
+        ]
+      },
+      e.key
+    );
+  }) });
+};
+export {
+  T as StepRail
+};
+//# sourceMappingURL=StepRail.js.map

package/dist/esm/components/agent-builder/components/StepRail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepRail.js","sources":["../../../../../src/components/agent-builder/components/StepRail.tsx"],"sourcesContent":["import React from 'react';\nimport { BodySecondary, TitleSmall } from '@src/components/TypographyStyle';\nimport { COLORS } from '@src/constants/Theme';\nimport { RailItem, RailList, StepBadge } from '../AgentBuilder.styled';\nimport { STEP_DEFINITIONS } from '../constants/steps';\nimport { useAgentBuilderContext } from '../context/AgentBuilderContext';\n\nexport const StepRail: React.FC = () => {\n\tconst {\n\t\tactiveStep,\n\t\tactiveIndex,\n\t\tvalidation,\n\t\tgoToStep,\n\t\tdisableStepNavigation,\n\t} = useAgentBuilderContext();\n\n\treturn (\n\t\t<RailList>\n\t\t\t{STEP_DEFINITIONS.map((step) => {\n\t\t\t\tconst isActive = step.key === activeStep;\n\t\t\t\tconst isComplete = step.index - 1 < activeIndex && validation[step.key];\n\t\t\t\tconst badgeState = isActive\n\t\t\t\t\t? 'active'\n\t\t\t\t\t: isComplete\n\t\t\t\t\t? 'complete'\n\t\t\t\t\t: 'inactive';\n\n\t\t\t\tconst Label = isActive ? TitleSmall : BodySecondary;\n\n\t\t\t\treturn (\n\t\t\t\t\t<RailItem\n\t\t\t\t\t\tkey={step.key}\n\t\t\t\t\t\tdata-test={`agent-step-${step.key}`}\n\t\t\t\t\t\tdisabled={disableStepNavigation}\n\t\t\t\t\t\tonClick={\n\t\t\t\t\t\t\tdisableStepNavigation ? undefined : () => goToStep(step.key)\n\t\t\t\t\t\t}\n\t\t\t\t\t>\n\t\t\t\t\t\t<StepBadge state={badgeState}>\n\t\t\t\t\t\t\t{isComplete ? '✓' : step.index}\n\t\t\t\t\t\t</StepBadge>\n\t\t\t\t\t\t<Label color={COLORS.content.primary}>{step.title}</Label>\n\t\t\t\t\t</RailItem>\n\t\t\t\t);\n\t\t\t})}\n\t\t</RailList>\n\t);\n};\n"],"names":["StepRail","activeStep","activeIndex","validation","goToStep","disableStepNavigation","useAgentBuilderContext","jsx","RailList","STEP_DEFINITIONS","step","isActive","isComplete","badgeState","Label","TitleSmall","BodySecondary","jsxs","RailItem","StepBadge","COLORS"],"mappings":";;;;;;AAOO,MAAMA,IAAqB,MAAM;AACvC,QAAM;AAAA,IACL,YAAAC;AAAA,IACA,aAAAC;AAAA,IACA,YAAAC;AAAA,IACA,UAAAC;AAAA,IACA,uBAAAC;AAAA,EAAA,IACGC,EAAA;AAEJ,SACC,gBAAAC,EAACC,GAAA,EACC,UAAAC,EAAiB,IAAI,CAACC,MAAS;AAC/B,UAAMC,IAAWD,EAAK,QAAQT,GACxBW,IAAaF,EAAK,QAAQ,IAAIR,KAAeC,EAAWO,EAAK,GAAG,GAChEG,IAAaF,IAChB,WACAC,IACA,aACA,YAEGE,IAAQH,IAAWI,IAAaC;AAEtC,WACC,gBAAAC;AAAA,MAACC;AAAA,MAAA;AAAA,QAEA,aAAW,cAAcR,EAAK,GAAG;AAAA,QACjC,UAAUL;AAAA,QACV,SACCA,IAAwB,SAAY,MAAMD,EAASM,EAAK,GAAG;AAAA,QAG5D,UAAA;AAAA,UAAA,gBAAAH,EAACY,KAAU,OAAON,GAChB,UAAAD,IAAa,MAAMF,EAAK,OAC1B;AAAA,4BACCI,GAAA,EAAM,OAAOM,EAAO,QAAQ,SAAU,YAAK,MAAA,CAAM;AAAA,QAAA;AAAA,MAAA;AAAA,MAV7CV,EAAK;AAAA,IAAA;AAAA,EAab,CAAC,EAAA,CACF;AAEF;"}

package/dist/esm/components/agent-builder/components/StepSectionHeader.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+interface StepSectionHeaderProps {
+    title: string;
+    helper?: string;
+}
+export declare const StepSectionHeader: React.FC<StepSectionHeaderProps>;
+export {};

package/dist/esm/components/agent-builder/components/StepSectionHeader.js

@@ -0,0 +1,15 @@
+import { jsxs as c, jsx as r } from "react/jsx-runtime";
+import { TitleRegular as n, BodySecondary as i } from "../../TypographyStyle.js";
+import { COLORS as e } from "../../../constants/Theme.js";
+import { SectionHeaderWrap as m } from "../AgentBuilder.styled.js";
+const s = ({
+  title: t,
+  helper: o
+}) => /* @__PURE__ */ c(m, { children: [
+  /* @__PURE__ */ r(n, { color: e.content.primary, children: t }),
+  o && /* @__PURE__ */ r(i, { color: e.content.secondary, children: o })
+] });
+export {
+  s as StepSectionHeader
+};
+//# sourceMappingURL=StepSectionHeader.js.map

package/dist/esm/components/agent-builder/components/StepSectionHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepSectionHeader.js","sources":["../../../../../src/components/agent-builder/components/StepSectionHeader.tsx"],"sourcesContent":["import React from 'react';\nimport { BodySecondary, TitleRegular } from '@src/components/TypographyStyle';\nimport { COLORS } from '@src/constants/Theme';\nimport { SectionHeaderWrap } from '../AgentBuilder.styled';\n\ninterface StepSectionHeaderProps {\n\ttitle: string;\n\thelper?: string;\n}\n\nexport const StepSectionHeader: React.FC<StepSectionHeaderProps> = ({\n\ttitle,\n\thelper,\n}) => (\n\t<SectionHeaderWrap>\n\t\t<TitleRegular color={COLORS.content.primary}>{title}</TitleRegular>\n\t\t{helper && (\n\t\t\t<BodySecondary color={COLORS.content.secondary}>{helper}</BodySecondary>\n\t\t)}\n\t</SectionHeaderWrap>\n);\n"],"names":["StepSectionHeader","title","helper","SectionHeaderWrap","jsx","TitleRegular","COLORS","BodySecondary"],"mappings":";;;;AAUO,MAAMA,IAAsD,CAAC;AAAA,EACnE,OAAAC;AAAA,EACA,QAAAC;AACD,wBACEC,GAAA,EACA,UAAA;AAAA,EAAA,gBAAAC,EAACC,GAAA,EAAa,OAAOC,EAAO,QAAQ,SAAU,UAAAL,GAAM;AAAA,EACnDC,KACA,gBAAAE,EAACG,GAAA,EAAc,OAAOD,EAAO,QAAQ,WAAY,UAAAJ,EAAA,CAAO;AAAA,EAAA,CAE1D;"}

package/dist/esm/components/agent-builder/components/UndoToast.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+/**
+ * Top-right toast shown after a tool / sub-agent is removed, offering an Undo.
+ * Re-keyed per removal so each one restarts the auto-close timer. Uses the
+ * shared `Toaster` (which mounts its own ToastContainer).
+ */
+export declare const UndoToast: React.FC;

package/dist/esm/components/agent-builder/components/UndoToast.js

@@ -0,0 +1,27 @@
+import { jsx as n } from "react/jsx-runtime";
+import { useAgentBuilderContext as r } from "../context/AgentBuilderContext.js";
+import { Toaster as s } from "../../toaster/Toaster.js";
+const m = () => {
+  const { undoToast: o, undoRemoval: t, dismissUndo: e } = r();
+  return o ? /* @__PURE__ */ n(
+    s,
+    {
+      text: o.message,
+      type: "info",
+      position: "top-right",
+      autoClose: 5e3,
+      hideCloseButton: !0,
+      buttonProps: {
+        buttonText: "Undo",
+        showButton: !0,
+        onButtonClick: () => (t(), {})
+      },
+      onCloseToast: () => e()
+    },
+    o.id
+  ) : null;
+};
+export {
+  m as UndoToast
+};
+//# sourceMappingURL=UndoToast.js.map

package/dist/esm/components/agent-builder/components/UndoToast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UndoToast.js","sources":["../../../../../src/components/agent-builder/components/UndoToast.tsx"],"sourcesContent":["import React from 'react';\nimport { Toaster } from '@src/components/toaster';\nimport { useAgentBuilderContext } from '../context/AgentBuilderContext';\n\n/**\n * Top-right toast shown after a tool / sub-agent is removed, offering an Undo.\n * Re-keyed per removal so each one restarts the auto-close timer. Uses the\n * shared `Toaster` (which mounts its own ToastContainer).\n */\nexport const UndoToast: React.FC = () => {\n\tconst { undoToast, undoRemoval, dismissUndo } = useAgentBuilderContext();\n\n\tif (!undoToast) {\n\t\treturn null;\n\t}\n\n\treturn (\n\t\t<Toaster\n\t\t\tkey={undoToast.id}\n\t\t\ttext={undoToast.message}\n\t\t\ttype=\"info\"\n\t\t\tposition=\"top-right\"\n\t\t\tautoClose={5000}\n\t\t\thideCloseButton\n\t\t\tbuttonProps={{\n\t\t\t\tbuttonText: 'Undo',\n\t\t\t\tshowButton: true,\n\t\t\t\tonButtonClick: () => {\n\t\t\t\t\tundoRemoval();\n\t\t\t\t\treturn {} as Record<string, never>;\n\t\t\t\t},\n\t\t\t}}\n\t\t\tonCloseToast={() => dismissUndo()}\n\t\t/>\n\t);\n};\n"],"names":["UndoToast","undoToast","undoRemoval","dismissUndo","useAgentBuilderContext","jsx","Toaster"],"mappings":";;;AASO,MAAMA,IAAsB,MAAM;AACxC,QAAM,EAAE,WAAAC,GAAW,aAAAC,GAAa,aAAAC,EAAA,IAAgBC,EAAA;AAEhD,SAAKH,IAKJ,gBAAAI;AAAA,IAACC;AAAA,IAAA;AAAA,MAEA,MAAML,EAAU;AAAA,MAChB,MAAK;AAAA,MACL,UAAS;AAAA,MACT,WAAW;AAAA,MACX,iBAAe;AAAA,MACf,aAAa;AAAA,QACZ,YAAY;AAAA,QACZ,YAAY;AAAA,QACZ,eAAe,OACdC,EAAA,GACO,CAAA;AAAA,MACR;AAAA,MAED,cAAc,MAAMC,EAAA;AAAA,IAAY;AAAA,IAd3BF,EAAU;AAAA,EAAA,IALT;AAsBT;"}

package/dist/esm/components/agent-builder/constants/charLimits.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Character limits for AgentBuilder fields.
+ *
+ * `name` and `description` are taken directly from the Figma spec. The rest are
+ * sized to match the 0/1000 counters shown on the response/handover steps; adjust
+ * here if product changes them.
+ */
+export declare const AGENT_CHAR_LIMITS: {
+    /** Step 1 — Agent name. */
+    readonly name: 60;
+    /** Step 1 — "What it does". */
+    readonly description: 1000;
+    /** Step 2 — custom intent free text. */
+    readonly customIntent: 1000;
+    /** Step 3 — Instructions (BikEditor `maxCharacters`). */
+    readonly instructions: 1000;
+    /** Step 3 — Guardrails. */
+    readonly guardrail: 1000;
+    /** Step 4 — "Handover when". */
+    readonly handoverWhen: 1000;
+};

package/dist/esm/components/agent-builder/constants/charLimits.js

@@ -0,0 +1,18 @@
+const e = {
+  /** Step 1 — Agent name. */
+  name: 60,
+  /** Step 1 — "What it does". */
+  description: 1e3,
+  /** Step 2 — custom intent free text. */
+  customIntent: 1e3,
+  /** Step 3 — Instructions (BikEditor `maxCharacters`). */
+  instructions: 1e3,
+  /** Step 3 — Guardrails. */
+  guardrail: 1e3,
+  /** Step 4 — "Handover when". */
+  handoverWhen: 1e3
+};
+export {
+  e as AGENT_CHAR_LIMITS
+};
+//# sourceMappingURL=charLimits.js.map

package/dist/esm/components/agent-builder/constants/charLimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charLimits.js","sources":["../../../../../src/components/agent-builder/constants/charLimits.ts"],"sourcesContent":["/**\n * Character limits for AgentBuilder fields.\n *\n * `name` and `description` are taken directly from the Figma spec. The rest are\n * sized to match the 0/1000 counters shown on the response/handover steps; adjust\n * here if product changes them.\n */\nexport const AGENT_CHAR_LIMITS = {\n\t/** Step 1 — Agent name. */\n\tname: 60,\n\t/** Step 1 — \"What it does\". */\n\tdescription: 1000,\n\t/** Step 2 — custom intent free text. */\n\tcustomIntent: 1000,\n\t/** Step 3 — Instructions (BikEditor `maxCharacters`). */\n\tinstructions: 1000,\n\t/** Step 3 — Guardrails. */\n\tguardrail: 1000,\n\t/** Step 4 — \"Handover when\". */\n\thandoverWhen: 1000,\n} as const;\n"],"names":["AGENT_CHAR_LIMITS"],"mappings":"AAOO,MAAMA,IAAoB;AAAA;AAAA,EAEhC,MAAM;AAAA;AAAA,EAEN,aAAa;AAAA;AAAA,EAEb,cAAc;AAAA;AAAA,EAEd,cAAc;AAAA;AAAA,EAEd,WAAW;AAAA;AAAA,EAEX,cAAc;AACf;"}

package/dist/esm/components/agent-builder/constants/editorStyle.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+/**
+ * Inline ProseMirror style applied to the agent-builder BikEditors so the rich
+ * inputs (Instructions, Guardrails) render in the SAME font/metrics as the plain
+ * `AiTextAreaInput` textarea (Inter 14/20). `.ProseMirror` itself sets no
+ * font-family, so without this it inherits the host default and looks different.
+ */
+export declare const AGENT_EDITOR_STYLE: React.CSSProperties;

package/dist/esm/components/agent-builder/constants/editorStyle.js

@@ -0,0 +1,10 @@
+const n = {
+  padding: 0,
+  fontFamily: "Inter",
+  fontSize: "14px",
+  lineHeight: "20px"
+};
+export {
+  n as AGENT_EDITOR_STYLE
+};
+//# sourceMappingURL=editorStyle.js.map

package/dist/esm/components/agent-builder/constants/editorStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorStyle.js","sources":["../../../../../src/components/agent-builder/constants/editorStyle.ts"],"sourcesContent":["import type React from 'react';\n\n/**\n * Inline ProseMirror style applied to the agent-builder BikEditors so the rich\n * inputs (Instructions, Guardrails) render in the SAME font/metrics as the plain\n * `AiTextAreaInput` textarea (Inter 14/20). `.ProseMirror` itself sets no\n * font-family, so without this it inherits the host default and looks different.\n */\nexport const AGENT_EDITOR_STYLE: React.CSSProperties = {\n\tpadding: 0,\n\tfontFamily: 'Inter',\n\tfontSize: '14px',\n\tlineHeight: '20px',\n};\n"],"names":["AGENT_EDITOR_STYLE"],"mappings":"AAQO,MAAMA,IAA0C;AAAA,EACtD,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,YAAY;AACb;"}

package/dist/esm/components/agent-builder/constants/steps.d.ts

@@ -0,0 +1,13 @@
+import { StepKey } from '../AgentBuilder.model';
+export interface StepDefinition {
+    key: StepKey;
+    /** 1-based number shown in the rail. */
+    index: number;
+    /** Rail label + content section title. */
+    title: string;
+    /** Helper text under the section title. */
+    helper: string;
+}
+export declare const STEP_DEFINITIONS: StepDefinition[];
+export declare const STEP_KEYS: StepKey[];
+export declare const getStepIndex: (key: StepKey) => number;

package/dist/esm/components/agent-builder/constants/steps.js

@@ -0,0 +1,32 @@
+const t = [
+  {
+    key: "about",
+    index: 1,
+    title: "About this agent",
+    helper: "Give it a name and one clear job. One agent → one job, that’s what keeps answers sharp."
+  },
+  {
+    key: "trigger",
+    index: 2,
+    title: "When it steps in",
+    helper: "Choose how Manifest knows when to route a conversation to this agent."
+  },
+  {
+    key: "response",
+    index: 3,
+    title: "How it responds",
+    helper: "Write what this agent should do. Type @ to reference a tool, add a condition, or hand off to a sub-agent."
+  },
+  {
+    key: "handover",
+    index: 4,
+    title: "Handover rules",
+    helper: "Define when this agent passes the conversation to a human, and how."
+  }
+], n = t.map((e) => e.key), o = (e) => n.indexOf(e);
+export {
+  t as STEP_DEFINITIONS,
+  n as STEP_KEYS,
+  o as getStepIndex
+};
+//# sourceMappingURL=steps.js.map

package/dist/esm/components/agent-builder/constants/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sources":["../../../../../src/components/agent-builder/constants/steps.ts"],"sourcesContent":["import { StepKey } from '../AgentBuilder.model';\n\nexport interface StepDefinition {\n\tkey: StepKey;\n\t/** 1-based number shown in the rail. */\n\tindex: number;\n\t/** Rail label + content section title. */\n\ttitle: string;\n\t/** Helper text under the section title. */\n\thelper: string;\n}\n\nexport const STEP_DEFINITIONS: StepDefinition[] = [\n\t{\n\t\tkey: 'about',\n\t\tindex: 1,\n\t\ttitle: 'About this agent',\n\t\thelper:\n\t\t\t'Give it a name and one clear job. One agent → one job, that’s what keeps answers sharp.',\n\t},\n\t{\n\t\tkey: 'trigger',\n\t\tindex: 2,\n\t\ttitle: 'When it steps in',\n\t\thelper:\n\t\t\t'Choose how Manifest knows when to route a conversation to this agent.',\n\t},\n\t{\n\t\tkey: 'response',\n\t\tindex: 3,\n\t\ttitle: 'How it responds',\n\t\thelper:\n\t\t\t'Write what this agent should do. Type @ to reference a tool, add a condition, or hand off to a sub-agent.',\n\t},\n\t{\n\t\tkey: 'handover',\n\t\tindex: 4,\n\t\ttitle: 'Handover rules',\n\t\thelper:\n\t\t\t'Define when this agent passes the conversation to a human, and how.',\n\t},\n];\n\nexport const STEP_KEYS: StepKey[] = STEP_DEFINITIONS.map((s) => s.key);\n\nexport const getStepIndex = (key: StepKey): number => STEP_KEYS.indexOf(key);\n"],"names":["STEP_DEFINITIONS","STEP_KEYS","s","getStepIndex","key"],"mappings":"AAYO,MAAMA,IAAqC;AAAA,EACjD;AAAA,IACC,KAAK;AAAA,IACL,OAAO;AAAA,IACP,OAAO;AAAA,IACP,QACC;AAAA,EAAA;AAAA,EAEF;AAAA,IACC,KAAK;AAAA,IACL,OAAO;AAAA,IACP,OAAO;AAAA,IACP,QACC;AAAA,EAAA;AAAA,EAEF;AAAA,IACC,KAAK;AAAA,IACL,OAAO;AAAA,IACP,OAAO;AAAA,IACP,QACC;AAAA,EAAA;AAAA,EAEF;AAAA,IACC,KAAK;AAAA,IACL,OAAO;AAAA,IACP,OAAO;AAAA,IACP,QACC;AAAA,EAAA;AAEH,GAEaC,IAAuBD,EAAiB,IAAI,CAACE,MAAMA,EAAE,GAAG,GAExDC,IAAe,CAACC,MAAyBH,EAAU,QAAQG,CAAG;"}

package/dist/esm/components/agent-builder/context/AgentBuilderContext.d.ts

@@ -0,0 +1,91 @@
+import { ApplicationType } from '@bikdotai/bik-models/growth';
+import { default as React } from 'react';
+import { AgentTool, AgentValue, IntentOption, ModelOption, StepKey, StepValidation, SubAgentDraft, SubAgentRef } from '../AgentBuilder.model';
+/** Mention-capable text fields in Step 3 (both store firebase token text). */
+export type MentionFieldKey = 'instructions' | 'guardrail';
+type MentionInsertFn = (kind: 'tool' | 'subagent', id: string, label?: string) => void;
+/** Toast shown after a tool / sub-agent is removed, offering an undo. */
+export interface UndoToastState {
+    /** Bumped per removal so the toast timer restarts. */
+    id: number;
+    message: string;
+}
+export interface AgentBuilderContextShape {
+    /** Controlled value relayed from props. */
+    value: AgentValue;
+    /** Patch one or more fields. */
+    patch: (partial: Partial<AgentValue>) => void;
+    /** Patch a single field. */
+    updateField: <K extends keyof AgentValue>(key: K, val: AgentValue[K]) => void;
+    /**
+     * Remove a tool / sub-agent everywhere: drops it from the list AND strips ALL
+     * its `{{tool:KEY}}` / `{{subagent:ID}}` tokens from BOTH the instructions and
+     * the guardrails, remounts the editors, and raises an undo toast.
+     */
+    removeReference: (kind: 'tool' | 'subagent', id: string) => void;
+    /** Remount signal for the mention editors after an external edit. */
+    mentionResetKey: number;
+    /**
+     * Insert a tool / sub-agent mention chip at the last cursor position of
+     * whichever mention field was focused most recently (Instructions or
+     * Guardrails). `label` overrides the chip text (e.g. a just-created sub-agent
+     * not yet in the available list).
+     */
+    insertMention: (kind: 'tool' | 'subagent', id: string, label?: string) => void;
+    /** A mention field registers its editor-backed insert here (internal). */
+    registerMentionField: (fieldKey: MentionFieldKey, fn: MentionInsertFn | null) => void;
+    /** A mention field reports focus so inserts target it (internal). */
+    notifyMentionFocus: (fieldKey: MentionFieldKey) => void;
+    /** Non-null while the undo toast should be visible. */
+    undoToast: UndoToastState | null;
+    /** Restore the last removed tool / sub-agent (list + stripped tokens). */
+    undoRemoval: () => void;
+    /** Dismiss the undo toast without restoring. */
+    dismissUndo: () => void;
+    activeStep: StepKey;
+    activeIndex: number;
+    goToStep: (step: StepKey) => void;
+    goNext: () => void;
+    goPrev: () => void;
+    isFirstStep: boolean;
+    isLastStep: boolean;
+    validation: StepValidation;
+    isActiveStepValid: boolean;
+    availableTools: AgentTool[];
+    availableSubAgents: SubAgentRef[];
+    availableIntents: IntentOption[];
+    availableModels: ModelOption[];
+    /** Host application context (e.g. MANIFEST) — drives tool-chip labelling. */
+    applicationType?: ApplicationType;
+    /** When true, step-rail items are not clickable (Back / Next only). */
+    disableStepNavigation: boolean;
+    /** Persist a new sub-agent and resolve with its ref. Omit to hide the create flow. */
+    onCreateSubAgent?: (draft: SubAgentDraft) => Promise<SubAgentRef>;
+    /** Fetch a sub-agent's editable data (Configure). Omit to hide Configure. */
+    onFetchSubAgent?: (id: string) => Promise<SubAgentDraft>;
+    /** Persist edits to an existing sub-agent. */
+    onUpdateSubAgent?: (id: string, draft: SubAgentDraft) => Promise<SubAgentRef>;
+    /** Optional "Improve with AI" for the drawer's instructions / guardrails. */
+    onImproveSubAgent?: (kind: 'instructions' | 'guardrail', text: string) => Promise<string>;
+}
+export declare const useAgentBuilderContext: () => AgentBuilderContextShape;
+interface ProviderProps {
+    value: AgentValue;
+    onChange: (patch: Partial<AgentValue>) => void;
+    activeStep?: StepKey;
+    onStepChange?: (step: StepKey) => void;
+    availableTools: AgentTool[];
+    availableSubAgents: SubAgentRef[];
+    availableIntents: IntentOption[];
+    availableModels: ModelOption[];
+    validation?: Partial<StepValidation>;
+    applicationType?: ApplicationType;
+    disableStepNavigation?: boolean;
+    onCreateSubAgent?: (draft: SubAgentDraft) => Promise<SubAgentRef>;
+    onFetchSubAgent?: (id: string) => Promise<SubAgentDraft>;
+    onUpdateSubAgent?: (id: string, draft: SubAgentDraft) => Promise<SubAgentRef>;
+    onImproveSubAgent?: (kind: 'instructions' | 'guardrail', text: string) => Promise<string>;
+    children: React.ReactNode;
+}
+export declare const AgentBuilderProvider: React.FC<ProviderProps>;
+export {};

package/dist/esm/components/agent-builder/context/AgentBuilderContext.js

@@ -0,0 +1,166 @@
+import { jsx as rt } from "react/jsx-runtime";
+import et, { useState as I, useRef as p, useCallback as o, useMemo as X, useContext as ot } from "react";
+import { AGENT_CHAR_LIMITS as Z } from "../constants/charLimits.js";
+import { getStepIndex as st, STEP_KEYS as x } from "../constants/steps.js";
+const a = et.createContext(null), gt = () => {
+  const t = ot(a);
+  if (!t)
+    throw new Error(
+      "useAgentBuilderContext must be used within an AgentBuilderProvider"
+    );
+  return t;
+}, it = (t) => {
+  const s = t.trigger.mode === "custom_intent" ? (t.trigger.customIntent ?? "").trim().length > 0 : t.trigger.intents.length > 0;
+  return {
+    about: t.name.trim().length > 0 && t.name.length <= Z.name && t.description.length <= Z.description,
+    trigger: s,
+    // At least one of Instructions / Guardrails must be filled.
+    response: t.instructions.trim().length > 0 || (t.guardrail ?? "").trim().length > 0,
+    // Optional until specced further — never blocks go-live.
+    handover: !0
+  };
+}, lt = ({
+  value: t,
+  onChange: s,
+  activeStep: R,
+  onStepChange: B,
+  availableTools: u,
+  availableSubAgents: m,
+  availableIntents: F,
+  availableModels: P,
+  validation: S,
+  applicationType: E,
+  disableStepNavigation: $ = !0,
+  onCreateSubAgent: w,
+  onFetchSubAgent: y,
+  onUpdateSubAgent: T,
+  onImproveSubAgent: V,
+  children: O
+}) => {
+  const [C, b] = I("about"), g = R ?? C, i = st(g), [j, K] = I(0), _ = p({}), L = p("instructions"), N = o(
+    (n, e) => {
+      e ? _.current[n] = e : delete _.current[n];
+    },
+    []
+  ), A = o((n) => {
+    L.current = n;
+  }, []), G = o((n, e, f) => {
+    const d = _.current;
+    (d[L.current] ?? d.instructions)?.(n, e, f);
+  }, []), [H, h] = I(null), l = p(null), U = p(0), c = o(
+    (n) => {
+      R === void 0 && b(n), B?.(n);
+    },
+    [R, B]
+  ), Y = o(() => {
+    const n = x[Math.min(i + 1, x.length - 1)];
+    c(n);
+  }, [i, c]), k = o(() => {
+    const n = x[Math.max(i - 1, 0)];
+    c(n);
+  }, [i, c]), q = o(
+    (n) => s(n),
+    [s]
+  ), z = o(
+    (n, e) => s({ [n]: e }),
+    [s]
+  ), D = o(
+    (n, e) => {
+      const f = n === "tool" ? (() => {
+        const r = u.find((nt) => nt.tool_id === e);
+        return r ? `{{tool:${r.function_key}}}` : null;
+      })() : `{{subagent:${e}}}`, d = (r) => f ? r.split(f).join("") : r;
+      l.current = {
+        tools: t.tools,
+        subagents: t.subagents,
+        instructions: t.instructions,
+        guardrail: t.guardrail
+      };
+      const W = {
+        instructions: d(t.instructions),
+        guardrail: d(t.guardrail ?? ""),
+        ...n === "tool" ? { tools: t.tools.filter((r) => r !== e) } : { subagents: t.subagents.filter((r) => r !== e) }
+      };
+      s(W), K((r) => r + 1);
+      const tt = n === "tool" ? u.find((r) => r.tool_id === e)?.displayName ?? "Tool" : m.find((r) => r.id === e)?.name ?? "Sub-agent";
+      U.current += 1, h({
+        id: U.current,
+        message: `${n === "tool" ? "Tool" : "Sub-agent"} "${tt}" removed`
+      });
+    },
+    [u, m, t, s]
+  ), J = o(() => {
+    l.current && (s(l.current), l.current = null, K((n) => n + 1)), h(null);
+  }, [s]), Q = o(() => h(null), []), M = X(
+    () => ({ ...it(t), ...S }),
+    [t, S]
+  ), v = X(
+    () => ({
+      value: t,
+      patch: q,
+      updateField: z,
+      removeReference: D,
+      mentionResetKey: j,
+      insertMention: G,
+      registerMentionField: N,
+      notifyMentionFocus: A,
+      undoToast: H,
+      undoRemoval: J,
+      dismissUndo: Q,
+      activeStep: g,
+      activeIndex: i,
+      goToStep: c,
+      goNext: Y,
+      goPrev: k,
+      isFirstStep: i === 0,
+      isLastStep: i === x.length - 1,
+      validation: M,
+      isActiveStepValid: M[g],
+      availableTools: u,
+      availableSubAgents: m,
+      availableIntents: F,
+      availableModels: P,
+      applicationType: E,
+      disableStepNavigation: $,
+      onCreateSubAgent: w,
+      onFetchSubAgent: y,
+      onUpdateSubAgent: T,
+      onImproveSubAgent: V
+    }),
+    [
+      t,
+      q,
+      z,
+      D,
+      j,
+      G,
+      N,
+      A,
+      H,
+      J,
+      Q,
+      g,
+      i,
+      c,
+      Y,
+      k,
+      M,
+      u,
+      m,
+      F,
+      P,
+      E,
+      $,
+      w,
+      y,
+      T,
+      V
+    ]
+  );
+  return /* @__PURE__ */ rt(a.Provider, { value: v, children: O });
+};
+export {
+  lt as AgentBuilderProvider,
+  gt as useAgentBuilderContext
+};
+//# sourceMappingURL=AgentBuilderContext.js.map

package/dist/esm/components/agent-builder/context/AgentBuilderContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentBuilderContext.js","sources":["../../../../../src/components/agent-builder/context/AgentBuilderContext.tsx"],"sourcesContent":["import type { ApplicationType } from '@bikdotai/bik-models/growth';\nimport React, {\n\tuseCallback,\n\tuseContext,\n\tuseMemo,\n\tuseRef,\n\tuseState,\n} from 'react';\nimport {\n\tAgentTool,\n\tAgentValue,\n\tIntentOption,\n\tModelOption,\n\tStepKey,\n\tStepValidation,\n\tSubAgentDraft,\n\tSubAgentRef,\n} from '../AgentBuilder.model';\nimport { AGENT_CHAR_LIMITS } from '../constants/charLimits';\nimport { getStepIndex, STEP_KEYS } from '../constants/steps';\n\n/** Mention-capable text fields in Step 3 (both store firebase token text). */\nexport type MentionFieldKey = 'instructions' | 'guardrail';\ntype MentionInsertFn = (\n\tkind: 'tool' | 'subagent',\n\tid: string,\n\tlabel?: string,\n) => void;\n\n/** Toast shown after a tool / sub-agent is removed, offering an undo. */\nexport interface UndoToastState {\n\t/** Bumped per removal so the toast timer restarts. */\n\tid: number;\n\tmessage: string;\n}\n\nexport interface AgentBuilderContextShape {\n\t/** Controlled value relayed from props. */\n\tvalue: AgentValue;\n\t/** Patch one or more fields. */\n\tpatch: (partial: Partial<AgentValue>) => void;\n\t/** Patch a single field. */\n\tupdateField: <K extends keyof AgentValue>(key: K, val: AgentValue[K]) => void;\n\t/**\n\t * Remove a tool / sub-agent everywhere: drops it from the list AND strips ALL\n\t * its `{{tool:KEY}}` / `{{subagent:ID}}` tokens from BOTH the instructions and\n\t * the guardrails, remounts the editors, and raises an undo toast.\n\t */\n\tremoveReference: (kind: 'tool' | 'subagent', id: string) => void;\n\t/** Remount signal for the mention editors after an external edit. */\n\tmentionResetKey: number;\n\t/**\n\t * Insert a tool / sub-agent mention chip at the last cursor position of\n\t * whichever mention field was focused most recently (Instructions or\n\t * Guardrails). `label` overrides the chip text (e.g. a just-created sub-agent\n\t * not yet in the available list).\n\t */\n\tinsertMention: (\n\t\tkind: 'tool' | 'subagent',\n\t\tid: string,\n\t\tlabel?: string,\n\t) => void;\n\t/** A mention field registers its editor-backed insert here (internal). */\n\tregisterMentionField: (\n\t\tfieldKey: MentionFieldKey,\n\t\tfn: MentionInsertFn | null,\n\t) => void;\n\t/** A mention field reports focus so inserts target it (internal). */\n\tnotifyMentionFocus: (fieldKey: MentionFieldKey) => void;\n\n\t// Undo (post-removal)\n\t/** Non-null while the undo toast should be visible. */\n\tundoToast: UndoToastState | null;\n\t/** Restore the last removed tool / sub-agent (list + stripped tokens). */\n\tundoRemoval: () => void;\n\t/** Dismiss the undo toast without restoring. */\n\tdismissUndo: () => void;\n\n\t// Navigation\n\tactiveStep: StepKey;\n\tactiveIndex: number;\n\tgoToStep: (step: StepKey) => void;\n\tgoNext: () => void;\n\tgoPrev: () => void;\n\tisFirstStep: boolean;\n\tisLastStep: boolean;\n\n\t// Validation\n\tvalidation: StepValidation;\n\tisActiveStepValid: boolean;\n\n\t// Reference data\n\tavailableTools: AgentTool[];\n\tavailableSubAgents: SubAgentRef[];\n\tavailableIntents: IntentOption[];\n\tavailableModels: ModelOption[];\n\t/** Host application context (e.g. MANIFEST) — drives tool-chip labelling. */\n\tapplicationType?: ApplicationType;\n\t/** When true, step-rail items are not clickable (Back / Next only). */\n\tdisableStepNavigation: boolean;\n\n\t// Sub-agent creation (Step 3 drawer)\n\t/** Persist a new sub-agent and resolve with its ref. Omit to hide the create flow. */\n\tonCreateSubAgent?: (draft: SubAgentDraft) => Promise<SubAgentRef>;\n\t/** Fetch a sub-agent's editable data (Configure). Omit to hide Configure. */\n\tonFetchSubAgent?: (id: string) => Promise<SubAgentDraft>;\n\t/** Persist edits to an existing sub-agent. */\n\tonUpdateSubAgent?: (id: string, draft: SubAgentDraft) => Promise<SubAgentRef>;\n\t/** Optional \"Improve with AI\" for the drawer's instructions / guardrails. */\n\tonImproveSubAgent?: (\n\t\tkind: 'instructions' | 'guardrail',\n\t\ttext: string,\n\t) => Promise<string>;\n}\n\nconst AgentBuilderContext =\n\tReact.createContext<AgentBuilderContextShape | null>(null);\n\nexport const useAgentBuilderContext = (): AgentBuilderContextShape => {\n\tconst ctx = useContext(AgentBuilderContext);\n\tif (!ctx) {\n\t\tthrow new Error(\n\t\t\t'useAgentBuilderContext must be used within an AgentBuilderProvider',\n\t\t);\n\t}\n\treturn ctx;\n};\n\n/** Validity derived purely from the current value (no effects). */\nconst deriveValidation = (value: AgentValue): StepValidation => {\n\tconst triggerValid =\n\t\tvalue.trigger.mode === 'custom_intent'\n\t\t\t? (value.trigger.customIntent ?? '').trim().length > 0\n\t\t\t: value.trigger.intents.length > 0;\n\n\treturn {\n\t\tabout:\n\t\t\tvalue.name.trim().length > 0 &&\n\t\t\tvalue.name.length <= AGENT_CHAR_LIMITS.name &&\n\t\t\tvalue.description.length <= AGENT_CHAR_LIMITS.description,\n\t\ttrigger: triggerValid,\n\t\t// At least one of Instructions / Guardrails must be filled.\n\t\tresponse:\n\t\t\tvalue.instructions.trim().length > 0 ||\n\t\t\t(value.guardrail ?? '').trim().length > 0,\n\t\t// Optional until specced further — never blocks go-live.\n\t\thandover: true,\n\t};\n};\n\ninterface ProviderProps {\n\tvalue: AgentValue;\n\tonChange: (patch: Partial<AgentValue>) => void;\n\tactiveStep?: StepKey;\n\tonStepChange?: (step: StepKey) => void;\n\tavailableTools: AgentTool[];\n\tavailableSubAgents: SubAgentRef[];\n\tavailableIntents: IntentOption[];\n\tavailableModels: ModelOption[];\n\tvalidation?: Partial<StepValidation>;\n\tapplicationType?: ApplicationType;\n\tdisableStepNavigation?: boolean;\n\tonCreateSubAgent?: (draft: SubAgentDraft) => Promise<SubAgentRef>;\n\tonFetchSubAgent?: (id: string) => Promise<SubAgentDraft>;\n\tonUpdateSubAgent?: (id: string, draft: SubAgentDraft) => Promise<SubAgentRef>;\n\tonImproveSubAgent?: (\n\t\tkind: 'instructions' | 'guardrail',\n\t\ttext: string,\n\t) => Promise<string>;\n\tchildren: React.ReactNode;\n}\n\nexport const AgentBuilderProvider: React.FC<ProviderProps> = ({\n\tvalue,\n\tonChange,\n\tactiveStep: controlledStep,\n\tonStepChange,\n\tavailableTools,\n\tavailableSubAgents,\n\tavailableIntents,\n\tavailableModels,\n\tvalidation: validationOverride,\n\tapplicationType,\n\tdisableStepNavigation = true,\n\tonCreateSubAgent,\n\tonFetchSubAgent,\n\tonUpdateSubAgent,\n\tonImproveSubAgent,\n\tchildren,\n}) => {\n\tconst [internalStep, setInternalStep] = useState<StepKey>('about');\n\tconst activeStep = controlledStep ?? internalStep;\n\tconst activeIndex = getStepIndex(activeStep);\n\n\t// Bumped when a mention field is edited from OUTSIDE its editor (removing a\n\t// tool from the side list, undo), forcing the mention editors to remount.\n\tconst [mentionResetKey, setMentionResetKey] = useState(0);\n\n\t// Each mention field registers an editor-backed insert fn + reports focus, so\n\t// side-panel adds drop a chip into the last-focused field at its cursor.\n\tconst mentionInsertersRef = useRef<\n\t\tPartial<Record<MentionFieldKey, MentionInsertFn>>\n\t>({});\n\tconst lastFocusedFieldRef = useRef<MentionFieldKey>('instructions');\n\tconst registerMentionField = useCallback(\n\t\t(fieldKey: MentionFieldKey, fn: MentionInsertFn | null) => {\n\t\t\tif (fn) {\n\t\t\t\tmentionInsertersRef.current[fieldKey] = fn;\n\t\t\t} else {\n\t\t\t\tdelete mentionInsertersRef.current[fieldKey];\n\t\t\t}\n\t\t},\n\t\t[],\n\t);\n\tconst notifyMentionFocus = useCallback((fieldKey: MentionFieldKey) => {\n\t\tlastFocusedFieldRef.current = fieldKey;\n\t}, []);\n\tconst insertMention = useCallback<MentionInsertFn>((kind, id, label) => {\n\t\tconst inserters = mentionInsertersRef.current;\n\t\tconst target =\n\t\t\tinserters[lastFocusedFieldRef.current] ?? inserters.instructions;\n\t\ttarget?.(kind, id, label);\n\t}, []);\n\n\t// Undo state for the most recent removal.\n\tconst [undoToast, setUndoToast] = useState<UndoToastState | null>(null);\n\tconst undoSnapshotRef = useRef<Partial<AgentValue> | null>(null);\n\tconst undoIdRef = useRef(0);\n\n\tconst goToStep = useCallback(\n\t\t(step: StepKey) => {\n\t\t\tif (controlledStep === undefined) {\n\t\t\t\tsetInternalStep(step);\n\t\t\t}\n\t\t\tonStepChange?.(step);\n\t\t},\n\t\t[controlledStep, onStepChange],\n\t);\n\n\tconst goNext = useCallback(() => {\n\t\tconst next = STEP_KEYS[Math.min(activeIndex + 1, STEP_KEYS.length - 1)];\n\t\tgoToStep(next);\n\t}, [activeIndex, goToStep]);\n\n\tconst goPrev = useCallback(() => {\n\t\tconst prev = STEP_KEYS[Math.max(activeIndex - 1, 0)];\n\t\tgoToStep(prev);\n\t}, [activeIndex, goToStep]);\n\n\tconst patch = useCallback(\n\t\t(partial: Partial<AgentValue>) => onChange(partial),\n\t\t[onChange],\n\t);\n\n\tconst updateField = useCallback(\n\t\t<K extends keyof AgentValue>(key: K, val: AgentValue[K]) =>\n\t\t\tonChange({ [key]: val } as Partial<AgentValue>),\n\t\t[onChange],\n\t);\n\n\tconst removeReference = useCallback(\n\t\t(kind: 'tool' | 'subagent', id: string) => {\n\t\t\tconst token =\n\t\t\t\tkind === 'tool'\n\t\t\t\t\t? (() => {\n\t\t\t\t\t\t\tconst tool = availableTools.find((t) => t.tool_id === id);\n\t\t\t\t\t\t\treturn tool ? `{{tool:${tool.function_key}}}` : null;\n\t\t\t\t\t  })()\n\t\t\t\t\t: `{{subagent:${id}}}`;\n\t\t\tconst strip = (text: string) =>\n\t\t\t\ttoken ? text.split(token).join('') : text;\n\n\t\t\t// Snapshot the four fields a removal touches, for undo.\n\t\t\tundoSnapshotRef.current = {\n\t\t\t\ttools: value.tools,\n\t\t\t\tsubagents: value.subagents,\n\t\t\t\tinstructions: value.instructions,\n\t\t\t\tguardrail: value.guardrail,\n\t\t\t};\n\n\t\t\tconst next: Partial<AgentValue> = {\n\t\t\t\tinstructions: strip(value.instructions),\n\t\t\t\tguardrail: strip(value.guardrail ?? ''),\n\t\t\t\t...(kind === 'tool'\n\t\t\t\t\t? { tools: value.tools.filter((t) => t !== id) }\n\t\t\t\t\t: { subagents: value.subagents.filter((s) => s !== id) }),\n\t\t\t};\n\t\t\tonChange(next);\n\t\t\tsetMentionResetKey((k) => k + 1);\n\n\t\t\tconst label =\n\t\t\t\tkind === 'tool'\n\t\t\t\t\t? availableTools.find((t) => t.tool_id === id)?.displayName ?? 'Tool'\n\t\t\t\t\t: availableSubAgents.find((s) => s.id === id)?.name ?? 'Sub-agent';\n\t\t\tundoIdRef.current += 1;\n\t\t\tsetUndoToast({\n\t\t\t\tid: undoIdRef.current,\n\t\t\t\tmessage: `${kind === 'tool' ? 'Tool' : 'Sub-agent'} \"${label}\" removed`,\n\t\t\t});\n\t\t},\n\t\t[availableTools, availableSubAgents, value, onChange],\n\t);\n\n\tconst undoRemoval = useCallback(() => {\n\t\tif (undoSnapshotRef.current) {\n\t\t\tonChange(undoSnapshotRef.current);\n\t\t\tundoSnapshotRef.current = null;\n\t\t\tsetMentionResetKey((k) => k + 1);\n\t\t}\n\t\tsetUndoToast(null);\n\t}, [onChange]);\n\n\tconst dismissUndo = useCallback(() => setUndoToast(null), []);\n\n\tconst validation: StepValidation = useMemo(\n\t\t() => ({ ...deriveValidation(value), ...validationOverride }),\n\t\t[value, validationOverride],\n\t);\n\n\tconst ctx = useMemo<AgentBuilderContextShape>(\n\t\t() => ({\n\t\t\tvalue,\n\t\t\tpatch,\n\t\t\tupdateField,\n\t\t\tremoveReference,\n\t\t\tmentionResetKey,\n\t\t\tinsertMention,\n\t\t\tregisterMentionField,\n\t\t\tnotifyMentionFocus,\n\t\t\tundoToast,\n\t\t\tundoRemoval,\n\t\t\tdismissUndo,\n\t\t\tactiveStep,\n\t\t\tactiveIndex,\n\t\t\tgoToStep,\n\t\t\tgoNext,\n\t\t\tgoPrev,\n\t\t\tisFirstStep: activeIndex === 0,\n\t\t\tisLastStep: activeIndex === STEP_KEYS.length - 1,\n\t\t\tvalidation,\n\t\t\tisActiveStepValid: validation[activeStep],\n\t\t\tavailableTools,\n\t\t\tavailableSubAgents,\n\t\t\tavailableIntents,\n\t\t\tavailableModels,\n\t\t\tapplicationType,\n\t\t\tdisableStepNavigation,\n\t\t\tonCreateSubAgent,\n\t\t\tonFetchSubAgent,\n\t\t\tonUpdateSubAgent,\n\t\t\tonImproveSubAgent,\n\t\t}),\n\t\t[\n\t\t\tvalue,\n\t\t\tpatch,\n\t\t\tupdateField,\n\t\t\tremoveReference,\n\t\t\tmentionResetKey,\n\t\t\tinsertMention,\n\t\t\tregisterMentionField,\n\t\t\tnotifyMentionFocus,\n\t\t\tundoToast,\n\t\t\tundoRemoval,\n\t\t\tdismissUndo,\n\t\t\tactiveStep,\n\t\t\tactiveIndex,\n\t\t\tgoToStep,\n\t\t\tgoNext,\n\t\t\tgoPrev,\n\t\t\tvalidation,\n\t\t\tavailableTools,\n\t\t\tavailableSubAgents,\n\t\t\tavailableIntents,\n\t\t\tavailableModels,\n\t\t\tapplicationType,\n\t\t\tdisableStepNavigation,\n\t\t\tonCreateSubAgent,\n\t\t\tonFetchSubAgent,\n\t\t\tonUpdateSubAgent,\n\t\t\tonImproveSubAgent,\n\t\t],\n\t);\n\n\treturn (\n\t\t<AgentBuilderContext.Provider value={ctx}>\n\t\t\t{children}\n\t\t</AgentBuilderContext.Provider>\n\t);\n};\n"],"names":["AgentBuilderContext","React","useAgentBuilderContext","ctx","useContext","deriveValidation","value","triggerValid","AGENT_CHAR_LIMITS","AgentBuilderProvider","onChange","controlledStep","onStepChange","availableTools","availableSubAgents","availableIntents","availableModels","validationOverride","applicationType","disableStepNavigation","onCreateSubAgent","onFetchSubAgent","onUpdateSubAgent","onImproveSubAgent","children","internalStep","setInternalStep","useState","activeStep","activeIndex","getStepIndex","mentionResetKey","setMentionResetKey","mentionInsertersRef","useRef","lastFocusedFieldRef","registerMentionField","useCallback","fieldKey","fn","notifyMentionFocus","insertMention","kind","id","label","inserters","undoToast","setUndoToast","undoSnapshotRef","undoIdRef","goToStep","step","goNext","next","STEP_KEYS","goPrev","prev","patch","partial","updateField","key","val","removeReference","token","tool","t","strip","text","s","k","undoRemoval","dismissUndo","validation","useMemo"],"mappings":"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"}

package/dist/esm/components/agent-builder/hooks/useAgentDraft.d.ts

@@ -0,0 +1,24 @@
+import { AgentValue } from '../AgentBuilder.model';
+export interface AgentDraft {
+    /** Current draft value — pass straight to `<AgentBuilder value={...} />`. */
+    value: AgentValue;
+    /** Merge a partial — pass straight to `<AgentBuilder onChange={...} />`. */
+    onChange: (patch: Partial<AgentValue>) => void;
+    /** Replace the whole value (e.g. after an async edit-mode load). */
+    setValue: (value: AgentValue) => void;
+    /** Reset back to the initial value this hook was created with. */
+    reset: () => void;
+}
+/**
+ * `useReducer`-based state helper for driving a controlled `<AgentBuilder />` from
+ * the consumer (e.g. merchantAdminReact) without hand-writing the patch/merge logic.
+ *
+ * The consumer remains the single source of truth — this just packages the reducer.
+ * For edit mode where the agent loads asynchronously, either key the host component
+ * on the agent id, or call `setValue` once the data arrives.
+ *
+ * @example
+ * const { value, onChange } = useAgentDraft(mapDocToAgentValue(doc));
+ * <AgentBuilder value={value} onChange={onChange} onSaveDraft={() => save(value)} ... />
+ */
+export declare const useAgentDraft: (initial: AgentValue) => AgentDraft;

package/dist/esm/components/agent-builder/hooks/useAgentDraft.js

@@ -0,0 +1,27 @@
+import { useRef as o, useReducer as l, useCallback as u } from "react";
+const h = (e, t) => {
+  switch (t.type) {
+    case "patch":
+      return { ...e, ...t.patch };
+    case "set":
+      return t.value;
+    default:
+      return e;
+  }
+}, d = (e) => {
+  const t = o(e), [c, s] = l(h, e), a = u(
+    (r) => s({ type: "patch", patch: r }),
+    []
+  ), n = u(
+    (r) => s({ type: "set", value: r }),
+    []
+  ), p = u(
+    () => s({ type: "set", value: t.current }),
+    []
+  );
+  return { value: c, onChange: a, setValue: n, reset: p };
+};
+export {
+  d as useAgentDraft
+};
+//# sourceMappingURL=useAgentDraft.js.map

package/dist/esm/components/agent-builder/hooks/useAgentDraft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentDraft.js","sources":["../../../../../src/components/agent-builder/hooks/useAgentDraft.ts"],"sourcesContent":["import { useCallback, useReducer, useRef } from 'react';\nimport { AgentValue } from '../AgentBuilder.model';\n\ntype DraftAction =\n\t| { type: 'patch'; patch: Partial<AgentValue> }\n\t| { type: 'set'; value: AgentValue };\n\nconst reducer = (state: AgentValue, action: DraftAction): AgentValue => {\n\tswitch (action.type) {\n\t\tcase 'patch':\n\t\t\treturn { ...state, ...action.patch };\n\t\tcase 'set':\n\t\t\treturn action.value;\n\t\tdefault:\n\t\t\treturn state;\n\t}\n};\n\nexport interface AgentDraft {\n\t/** Current draft value — pass straight to `<AgentBuilder value={...} />`. */\n\tvalue: AgentValue;\n\t/** Merge a partial — pass straight to `<AgentBuilder onChange={...} />`. */\n\tonChange: (patch: Partial<AgentValue>) => void;\n\t/** Replace the whole value (e.g. after an async edit-mode load). */\n\tsetValue: (value: AgentValue) => void;\n\t/** Reset back to the initial value this hook was created with. */\n\treset: () => void;\n}\n\n/**\n * `useReducer`-based state helper for driving a controlled `<AgentBuilder />` from\n * the consumer (e.g. merchantAdminReact) without hand-writing the patch/merge logic.\n *\n * The consumer remains the single source of truth — this just packages the reducer.\n * For edit mode where the agent loads asynchronously, either key the host component\n * on the agent id, or call `setValue` once the data arrives.\n *\n * @example\n * const { value, onChange } = useAgentDraft(mapDocToAgentValue(doc));\n * <AgentBuilder value={value} onChange={onChange} onSaveDraft={() => save(value)} ... />\n */\nexport const useAgentDraft = (initial: AgentValue): AgentDraft => {\n\tconst initialRef = useRef(initial);\n\tconst [value, dispatch] = useReducer(reducer, initial);\n\n\tconst onChange = useCallback(\n\t\t(patch: Partial<AgentValue>) => dispatch({ type: 'patch', patch }),\n\t\t[],\n\t);\n\tconst setValue = useCallback(\n\t\t(next: AgentValue) => dispatch({ type: 'set', value: next }),\n\t\t[],\n\t);\n\tconst reset = useCallback(\n\t\t() => dispatch({ type: 'set', value: initialRef.current }),\n\t\t[],\n\t);\n\n\treturn { value, onChange, setValue, reset };\n};\n"],"names":["reducer","state","action","useAgentDraft","initial","initialRef","useRef","value","dispatch","useReducer","onChange","useCallback","patch","setValue","next","reset"],"mappings":";AAOA,MAAMA,IAAU,CAACC,GAAmBC,MAAoC;AACvE,UAAQA,EAAO,MAAA;AAAA,IACd,KAAK;AACJ,aAAO,EAAE,GAAGD,GAAO,GAAGC,EAAO,MAAA;AAAA,IAC9B,KAAK;AACJ,aAAOA,EAAO;AAAA,IACf;AACC,aAAOD;AAAA,EAAA;AAEV,GAyBaE,IAAgB,CAACC,MAAoC;AACjE,QAAMC,IAAaC,EAAOF,CAAO,GAC3B,CAACG,GAAOC,CAAQ,IAAIC,EAAWT,GAASI,CAAO,GAE/CM,IAAWC;AAAA,IAChB,CAACC,MAA+BJ,EAAS,EAAE,MAAM,SAAS,OAAAI,GAAO;AAAA,IACjE,CAAA;AAAA,EAAC,GAEIC,IAAWF;AAAA,IAChB,CAACG,MAAqBN,EAAS,EAAE,MAAM,OAAO,OAAOM,GAAM;AAAA,IAC3D,CAAA;AAAA,EAAC,GAEIC,IAAQJ;AAAA,IACb,MAAMH,EAAS,EAAE,MAAM,OAAO,OAAOH,EAAW,SAAS;AAAA,IACzD,CAAA;AAAA,EAAC;AAGF,SAAO,EAAE,OAAAE,GAAO,UAAAG,GAAU,UAAAG,GAAU,OAAAE,EAAA;AACrC;"}

package/dist/esm/components/agent-builder/index.d.ts

@@ -0,0 +1,7 @@
+export { AgentBuilder } from './AgentBuilder';
+export { useAgentDraft } from './hooks/useAgentDraft';
+export type { AgentDraft } from './hooks/useAgentDraft';
+export { AGENT_CHAR_LIMITS } from './constants/charLimits';
+export { STEP_DEFINITIONS } from './constants/steps';
+export { buildAgentMentionItems, editorDocToInstructions, instructionsToEditorHtml, } from './utils/mentionSerialization';
+export type { AgentBuilderProps, AgentBuilderConfig, AgentValue, AgentStatus as AgentBuilderStatus, StepKey, StepValidation, TriggerMode, AgentTriggerValue, AgentHandoverConfig, HandoverMethod, AgentTool, SubAgentRef, SubAgentDraft, IntentOption, ModelOption, } from './AgentBuilder.model';

package/dist/esm/components/agent-builder/steps/Step1About.d.ts

@@ -0,0 +1,2 @@
+import { default as React } from 'react';
+export declare const Step1About: React.FC;