@ai-matrx/chat 0.1.77 → 0.2.0

package/dist/utils/callbackManager.js

@@ -0,0 +1,260 @@
+import { v4 as uuidv4 } from "uuid";
+class CallbackManager {
+  callbacks;
+  groups;
+  registryListeners;
+  constructor() {
+    this.callbacks = /* @__PURE__ */ new Map();
+    this.groups = /* @__PURE__ */ new Map();
+    this.registryListeners = /* @__PURE__ */ new Set();
+  }
+  /**
+   * Observe the registry itself: `listener` runs after any entry is added or
+   * removed (register, trigger-and-remove, remove, removeGroup). This is what
+   * lets a view that resolves ids with `get` re-render when an id goes away —
+   * the shape `useSyncExternalStore` needs. Returns the unsubscribe.
+   */
+  subscribeToRegistry(listener) {
+    this.registryListeners.add(listener);
+    return () => {
+      this.registryListeners.delete(listener);
+    };
+  }
+  notifyRegistry() {
+    for (const listener of [...this.registryListeners]) listener();
+  }
+  /**
+   * Original method - maintains backwards compatibility
+   */
+  register(callback) {
+    const callbackId = uuidv4();
+    this.callbacks.set(callbackId, { callback });
+    this.notifyRegistry();
+    return callbackId;
+  }
+  /**
+   * Enhanced register with optional context and group support
+   */
+  registerWithContext(callback, options = {}) {
+    const callbackId = uuidv4();
+    const { context, groupId } = options;
+    this.callbacks.set(callbackId, {
+      callback,
+      context,
+      groupId
+    });
+    if (groupId) {
+      const group = this.groups.get(groupId) || /* @__PURE__ */ new Set();
+      group.add(callbackId);
+      this.groups.set(groupId, group);
+    }
+    this.notifyRegistry();
+    return callbackId;
+  }
+  /**
+   * Subscribe to results for a specific callback ID
+   */
+  subscribe(callbackId, listener) {
+    const entry = this.callbacks.get(callbackId);
+    if (!entry) return false;
+    if (!entry.listeners) {
+      entry.listeners = [];
+    }
+    entry.listeners.push(listener);
+    return true;
+  }
+  /**
+   * Unsubscribe a listener from a callback ID
+   */
+  unsubscribe(callbackId, listener) {
+    const entry = this.callbacks.get(callbackId);
+    if (!entry || !entry.listeners) return false;
+    const index = entry.listeners.indexOf(listener);
+    if (index === -1) return false;
+    entry.listeners.splice(index, 1);
+    return true;
+  }
+  /**
+   * Original method - maintains backwards compatibility
+   */
+  trigger(callbackId, data) {
+    const entry = this.callbacks.get(callbackId);
+    if (entry) {
+      entry.callback(data);
+      if (entry.listeners && entry.listeners.length > 0) {
+        entry.listeners.forEach((listener) => listener(data));
+      }
+      this.callbacks.delete(callbackId);
+      this.notifyRegistry();
+      this.removeFromGroups(callbackId);
+    }
+  }
+  /**
+   * Enhanced trigger with context and progress support
+   */
+  triggerWithContext(callbackId, data, options) {
+    const entry = this.callbacks.get(callbackId);
+    if (entry) {
+      const mergedContext = {
+        ...entry.context,
+        ...options?.context,
+        ...options?.progress && { progress: options.progress }
+      };
+      entry.callback(data, mergedContext);
+      if (entry.listeners && entry.listeners.length > 0) {
+        entry.listeners.forEach((listener) => listener(data, mergedContext));
+      }
+      if (options?.removeAfterTrigger !== false) {
+        this.callbacks.delete(callbackId);
+        this.notifyRegistry();
+        this.removeFromGroups(callbackId);
+      }
+    }
+  }
+  /**
+   * Trigger all callbacks in a group
+   */
+  triggerGroup(groupId, data, options) {
+    const group = this.groups.get(groupId);
+    if (group) {
+      group.forEach((callbackId) => {
+        this.triggerWithContext(callbackId, data, options);
+      });
+      if (options?.removeAfterTrigger !== false) {
+        this.groups.delete(groupId);
+      }
+    }
+  }
+  /**
+   * Run the one durable command registered for a group. This is deliberately
+   * separate from the legacy notification API above: a command is retained on
+   * rejection so its caller can retry, and is removed only after its promise
+   * settles successfully.
+   */
+  async triggerGroupCommand(groupId, data, options) {
+    const group = this.groups.get(groupId);
+    const callbackIds = group ? [...group] : [];
+    if (callbackIds.length !== 1) {
+      throw new Error(
+        `Expected exactly one command callback for group "${groupId}", found ${callbackIds.length}`
+      );
+    }
+    const callbackId = callbackIds[0];
+    const entry = this.callbacks.get(callbackId);
+    if (!entry) {
+      throw new Error(`Command callback "${callbackId}" is no longer available`);
+    }
+    const mergedContext = { ...entry.context, ...options?.context };
+    await entry.callback(data, mergedContext);
+    for (const listener of entry.listeners ?? []) {
+      try {
+        await listener(data, mergedContext);
+      } catch (error) {
+        console.error("[CallbackManager] command observer failed", error);
+      }
+    }
+    if (options?.removeAfterSuccess !== false) {
+      this.callbacks.delete(callbackId);
+      this.notifyRegistry();
+      this.groups.delete(groupId);
+    }
+  }
+  /**
+   * Update progress for a callback or group
+   */
+  updateProgress(id, progress, options) {
+    const progressInfo = {
+      progress,
+      status: options?.status || "running",
+      error: options?.error
+    };
+    if (options?.groupId) {
+      this.triggerGroup(id, null, {
+        progress: progressInfo,
+        removeAfterTrigger: false
+      });
+    } else {
+      this.triggerWithContext(id, null, {
+        progress: progressInfo,
+        removeAfterTrigger: false
+      });
+    }
+  }
+  /**
+   * Create a new group and return its ID
+   */
+  createGroup() {
+    const groupId = uuidv4();
+    this.groups.set(groupId, /* @__PURE__ */ new Set());
+    return groupId;
+  }
+  /**
+   * Original method - maintains backwards compatibility
+   */
+  remove(callbackId) {
+    this.callbacks.delete(callbackId);
+    this.notifyRegistry();
+    this.removeFromGroups(callbackId);
+  }
+  /**
+   * Alias of `remove`. Preferred call-site name when unregistering a single
+   * entry (e.g. on widget unmount) — reads more clearly than `remove` and
+   * grep-separates widget-handle unregistrations from callback lifecycle.
+   */
+  unregister(callbackId) {
+    this.remove(callbackId);
+  }
+  /**
+   * Look up a stored callback or object by id without invoking it.
+   * Used by the widget dispatcher to resolve the WidgetHandle on demand,
+   * and by the submit-body assembler to derive `client_tools` per turn.
+   * Returns undefined if the id is unknown or already unregistered.
+   */
+  get(callbackId) {
+    const entry = this.callbacks.get(callbackId);
+    return entry?.callback;
+  }
+  /**
+   * Register a WidgetHandle. Typed wrapper around `register` so call sites
+   * stay declarative, `grep registerWidgetHandle` finds all widget handles,
+   * and the handle is stored directly in the `callback` slot (never
+   * invoked via `trigger` — always retrieved via `get`).
+   */
+  registerWidgetHandle(handle) {
+    const callbackId = uuidv4();
+    this.callbacks.set(callbackId, {
+      // MATRX-EXCEPTION: CallbackEntry.callback is a heterogeneous slot (fn | WidgetHandle);
+      // this entry is retrieved only via `get<WidgetHandle>()`, never invoked as a Callback.
+      callback: handle
+    });
+    this.notifyRegistry();
+    return callbackId;
+  }
+  /**
+   * Remove a group and all its callbacks
+   */
+  removeGroup(groupId) {
+    const group = this.groups.get(groupId);
+    if (group) {
+      group.forEach((callbackId) => {
+        this.callbacks.delete(callbackId);
+      });
+      this.groups.delete(groupId);
+      this.notifyRegistry();
+    }
+  }
+  removeFromGroups(callbackId) {
+    const entry = this.callbacks.get(callbackId);
+    if (entry?.groupId) {
+      const group = this.groups.get(entry.groupId);
+      group?.delete(callbackId);
+      if (group?.size === 0) {
+        this.groups.delete(entry.groupId);
+      }
+    }
+  }
+}
+const callbackManager = new CallbackManager();
+export {
+  callbackManager
+};

package/dist/utils/connectors/marks.d.ts

@@ -0,0 +1,35 @@
+import type { LucideIcon } from "lucide-react";
+import type { ConnectorLogo, ConnectorLogoProps } from "./types.js";
+/** Google — the multicolor G. Used for any Google account connection. */
+export declare function GoogleMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+/** Gmail — the four-color M. `colored={false}` keeps a single-ink envelope. */
+export declare function GmailMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+/** Notion — the N. Brand color is black, so it always rides `currentColor`. */
+export declare function NotionMark({ className }: ConnectorLogoProps): import("react").JSX.Element;
+/**
+ * Adapt a Lucide icon into a connector mark — the sanctioned fallback for a
+ * product with no local brand mark. Lucide strokes `currentColor`, so it looks
+ * right in both themes and ignores `colored`.
+ */
+export declare function lucideMark(Icon: LucideIcon): ConnectorLogo;
+/**
+ * Google product marks for the connect dialog and Settings. Each is the
+ * product's own color artwork; with `colored={false}` they fall back to a
+ * single-ink silhouette so a muted row still reads in both themes.
+ */
+export declare function GoogleDriveMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+export declare function GoogleCalendarMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+export declare function GoogleContactsMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+export declare function GoogleTasksMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+export declare function SearchConsoleMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+export declare function GoogleAnalyticsMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+export declare function TagManagerMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+export declare function YouTubeMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+/** Google Docs — the blue page with text lines. */
+export declare function GoogleDocsMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+/** Google Sheets — the green page with a grid. */
+export declare function GoogleSheetsMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
+/** GitHub — the octocat. Brand color is black, so it always rides `currentColor`. */
+export declare function GitHubMark({ className }: ConnectorLogoProps): import("react").JSX.Element;
+/** Microsoft — the four squares. */
+export declare function MicrosoftMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;

package/dist/utils/connectors/marks.js

@@ -0,0 +1,233 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { cn } from "@ai-matrx/design-system";
+function MarkSvg({
+  className,
+  children
+}) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      viewBox: "0 0 24 24",
+      "aria-hidden": true,
+      focusable: "false",
+      className: cn("shrink-0", className),
+      children
+    }
+  );
+}
+function BrandSvg({
+  className,
+  viewBox = "0 0 48 48",
+  children
+}) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      viewBox,
+      "aria-hidden": true,
+      focusable: "false",
+      className: cn("shrink-0", className),
+      children
+    }
+  );
+}
+function GoogleMark({ colored = false, className }) {
+  if (!colored) {
+    return /* @__PURE__ */ jsx(MarkSvg, { className, children: /* @__PURE__ */ jsx(
+      "path",
+      {
+        fill: "currentColor",
+        d: "M12 11.09v2.94h4.1a3.51 3.51 0 0 1-1.53 2.3l2.47 1.92A7.44 7.44 0 0 0 19.4 12c0-.54-.05-1.06-.14-1.56H12Zm-6.2 1.9a4.4 4.4 0 0 1 0-1.98V9.05H3.32a7.5 7.5 0 0 0 0 6.72l2.48-1.93ZM12 6.6a4.1 4.1 0 0 1 2.9 1.13l2.16-2.16A7.24 7.24 0 0 0 12 3.5a7.5 7.5 0 0 0-6.7 4.1L7.8 9.5A4.47 4.47 0 0 1 12 6.6Zm0 13.9a7.15 7.15 0 0 0 4.96-1.81l-2.47-1.92c-.67.45-1.53.72-2.49.72a4.47 4.47 0 0 1-4.2-3.06L5.3 16.4A7.49 7.49 0 0 0 12 20.5Z"
+      }
+    ) });
+  }
+  return /* @__PURE__ */ jsxs(MarkSvg, { className, children: [
+    /* @__PURE__ */ jsx(
+      "path",
+      {
+        fill: "#4285F4",
+        d: "M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92a5.06 5.06 0 0 1-2.2 3.32v2.77h3.56c2.08-1.92 3.28-4.74 3.28-8.1Z"
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "path",
+      {
+        fill: "#34A853",
+        d: "M12 23c2.97 0 5.46-.98 7.28-2.65l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84A11 11 0 0 0 12 23Z"
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "path",
+      {
+        fill: "#FBBC05",
+        d: "M5.84 14.11a6.6 6.6 0 0 1 0-4.22V7.05H2.18a11 11 0 0 0 0 9.9l3.66-2.84Z"
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "path",
+      {
+        fill: "#EA4335",
+        d: "M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1a11 11 0 0 0-9.82 6.05l3.66 2.84C6.71 7.31 9.14 5.38 12 5.38Z"
+      }
+    )
+  ] });
+}
+function GmailMark({ colored = false, className }) {
+  if (!colored) {
+    return /* @__PURE__ */ jsx(MarkSvg, { className, children: /* @__PURE__ */ jsx(
+      "path",
+      {
+        fill: "currentColor",
+        d: "M24 5.457v13.909c0 .904-.732 1.636-1.636 1.636h-3.819V11.73L12 16.64l-6.545-4.91v9.273H1.636A1.636 1.636 0 0 1 0 19.366V5.457c0-2.023 2.309-3.178 3.927-1.964L5.455 4.64 12 9.548l6.545-4.91 1.528-1.145C21.69 2.28 24 3.434 24 5.457Z"
+      }
+    ) });
+  }
+  return /* @__PURE__ */ jsxs(BrandSvg, { className, children: [
+    /* @__PURE__ */ jsx("path", { fill: "#4caf50", d: "M45 16.2l-5 2.75-5 4.75V40h7a3 3 0 0 0 3-3V16.2z" }),
+    /* @__PURE__ */ jsx("path", { fill: "#1e88e5", d: "M3 16.2l3.614 1.71L13 23.7V40H6a3 3 0 0 1-3-3V16.2z" }),
+    /* @__PURE__ */ jsx("path", { fill: "#e53935", d: "M35 11.2l-11 8.25-11-8.25-1 5.8 1 6.7 11 8.25 11-8.25 1-6.7z" }),
+    /* @__PURE__ */ jsx("path", { fill: "#c62828", d: "M3 12.298V16.2l10 7.5V11.2L9.876 8.859A4.298 4.298 0 0 0 7.298 8 4.298 4.298 0 0 0 3 12.298z" }),
+    /* @__PURE__ */ jsx("path", { fill: "#fbc02d", d: "M45 12.298V16.2l-10 7.5V11.2l3.124-2.341A4.298 4.298 0 0 1 40.702 8 4.298 4.298 0 0 1 45 12.298z" })
+  ] });
+}
+function NotionMark({ className }) {
+  return /* @__PURE__ */ jsx(MarkSvg, { className, children: /* @__PURE__ */ jsx(
+    "path",
+    {
+      fill: "currentColor",
+      d: "M4.459 4.208c.746.606 1.026.56 2.428.466l13.215-.793c.28 0 .047-.28-.046-.326L17.86 1.968c-.42-.326-.981-.7-2.055-.607L3.01 2.295c-.466.046-.56.28-.374.466zm.793 3.08v13.904c0 .747.373 1.027 1.214.98l14.523-.84c.841-.046.935-.56.935-1.167V6.354c0-.606-.233-.933-.748-.887l-15.177.887c-.56.047-.747.327-.747.933zm14.337.745c.093.42 0 .84-.42.888l-.7.14v10.264c-.608.327-1.168.514-1.635.514-.748 0-.935-.234-1.495-.933l-4.577-7.186v6.952L12.21 19s0 .84-1.168.84l-3.222.186c-.093-.186 0-.653.327-.746l.84-.233V9.854L7.822 9.76c-.094-.42.14-1.026.793-1.073l3.456-.233 4.764 7.279v-6.44l-1.215-.139c-.093-.514.28-.887.747-.933zM1.936 1.035l13.31-.98c1.634-.14 2.055-.047 3.082.7l4.249 2.986c.7.513.934.653.934 1.213v16.378c0 1.026-.373 1.634-1.681 1.726l-15.458.934c-.98.047-1.448-.093-1.962-.747L1.278 19.5c-.56-.747-.793-1.306-.793-1.96V2.667c0-.839.374-1.54 1.451-1.632z"
+    }
+  ) });
+}
+function lucideMark(Icon) {
+  function LucideConnectorMark({ className }) {
+    return /* @__PURE__ */ jsx(Icon, { className: cn("shrink-0", className), "aria-hidden": true });
+  }
+  LucideConnectorMark.displayName = `LucideConnectorMark(${Icon.displayName ?? "icon"})`;
+  return LucideConnectorMark;
+}
+function GoogleDriveMark({ colored = false, className }) {
+  const ink = colored ? void 0 : "currentColor";
+  return /* @__PURE__ */ jsxs(BrandSvg, { className, viewBox: "0 0 87.3 78", children: [
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#0066da", d: "m6.6 66.85 3.85 6.65c.8 1.4 1.95 2.5 3.3 3.3l13.75-23.8h-27.5c0 1.55.4 3.1 1.2 4.5z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#00ac47", d: "m43.65 25-13.75-23.8c-1.35.8-2.5 1.9-3.3 3.3l-25.4 44a9.06 9.06 0 0 0 -1.2 4.5h27.5z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#ea4335", d: "m73.55 76.8c1.35-.8 2.5-1.9 3.3-3.3l1.6-2.75 7.65-13.25c.8-1.4 1.2-2.95 1.2-4.5h-27.502l5.852 11.5z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#00832d", d: "m43.65 25 13.75-23.8c-1.35-.8-2.9-1.2-4.5-1.2h-18.5c-1.6 0-3.15.45-4.5 1.2z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#2684fc", d: "m59.8 53h-32.3l-13.75 23.8c1.35.8 2.9 1.2 4.5 1.2h50.8c1.6 0 3.15-.45 4.5-1.2z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#ffba00", d: "m73.4 26.5-12.7-22c-.8-1.4-1.95-2.5-3.3-3.3l-13.75 23.8 16.15 28h27.45c0-1.55-.4-3.1-1.2-4.5z" })
+  ] });
+}
+function GoogleCalendarMark({ colored = false, className }) {
+  const ink = colored ? void 0 : "currentColor";
+  return /* @__PURE__ */ jsxs(BrandSvg, { className, children: [
+    /* @__PURE__ */ jsx("path", { fill: colored ? "#fff" : "none", d: "M13 13h22v22H13z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#1e88e5", d: "M25.68 20.92l1.008 1.44 1.584-1.152v8.352H30V18.616h-1.44zM22.943 23.745c.625-.574 1.013-1.37 1.013-2.249 0-1.747-1.533-3.168-3.417-3.168-1.602 0-2.972 1.009-3.33 2.453l1.657.421c.165-.664.868-1.146 1.673-1.146.942 0 1.709.646 1.709 1.44 0 .794-.767 1.44-1.709 1.44h-.997v1.728h.997c1.081 0 1.993.751 1.993 1.64 0 .904-.866 1.64-1.931 1.64-.962 0-1.784-.61-1.914-1.418L17 26.802c.262 1.636 1.81 2.87 3.6 2.87 2.007 0 3.64-1.511 3.64-3.368 0-1.023-.504-1.941-1.297-2.559z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#fbc02d", d: "M34 42H14l-1-4 1-4h20l1 4z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#4caf50", d: "M38 35l4-1V14l-4-1-4 1v20z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#1e88e5", d: "M34 14l1-4-1-4H9a3 3 0 0 0-3 3v25l4 1 4-1V14h20z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#e53935", d: "M34 34v8l8-8z" }),
+    /* @__PURE__ */ jsx("path", { fill: ink ?? "#1565c0", d: "M39 6h-5v8h8V9a3 3 0 0 0-3-3zM9 42h5v-8H6v5a3 3 0 0 0 3 3z" })
+  ] });
+}
+function GoogleContactsMark({ colored = false, className }) {
+  return /* @__PURE__ */ jsxs(BrandSvg, { className, children: [
+    /* @__PURE__ */ jsx("circle", { cx: "24", cy: "16", r: "8", fill: colored ? "#1a73e8" : "currentColor" }),
+    /* @__PURE__ */ jsx("path", { fill: colored ? "#1a73e8" : "currentColor", d: "M8 38c0-7.2 7.2-12 16-12s16 4.8 16 12v2a2 2 0 0 1-2 2H10a2 2 0 0 1-2-2z" }),
+    colored ? /* @__PURE__ */ jsx("path", { fill: "#8ab4f8", d: "M8 36h32v4a2 2 0 0 1-2 2H10a2 2 0 0 1-2-2z" }) : null
+  ] });
+}
+function GoogleTasksMark({ colored = false, className }) {
+  return /* @__PURE__ */ jsxs(BrandSvg, { className, children: [
+    /* @__PURE__ */ jsx("circle", { cx: "24", cy: "24", r: "20", fill: colored ? "#1a73e8" : "currentColor" }),
+    /* @__PURE__ */ jsx("path", { fill: "none", stroke: colored ? "#fff" : "var(--background, #fff)", strokeWidth: "4.5", strokeLinecap: "round", strokeLinejoin: "round", d: "M15 24.5l6 6 12-13" }),
+    colored ? /* @__PURE__ */ jsx("circle", { cx: "37", cy: "37", r: "6", fill: "#fbbc04" }) : null
+  ] });
+}
+function SearchConsoleMark({ colored = false, className }) {
+  return /* @__PURE__ */ jsxs(BrandSvg, { className, children: [
+    /* @__PURE__ */ jsx("path", { fill: "none", stroke: colored ? "#4285f4" : "currentColor", strokeWidth: "5", d: "M20 8a12 12 0 1 1 0 24 12 12 0 0 1 0-24z" }),
+    /* @__PURE__ */ jsx("path", { fill: "none", stroke: colored ? "#34a853" : "currentColor", strokeWidth: "6", strokeLinecap: "round", d: "M29.5 29.5 40 40" }),
+    colored ? /* @__PURE__ */ jsx("path", { fill: "#fbbc04", d: "M15 23h3v4h-3zM19 19h3v8h-3zM23 16h3v11h-3z" }) : null
+  ] });
+}
+function GoogleAnalyticsMark({ colored = false, className }) {
+  return /* @__PURE__ */ jsxs(BrandSvg, { className, children: [
+    /* @__PURE__ */ jsx("rect", { x: "30", y: "5", width: "11", height: "38", rx: "5.5", fill: colored ? "#f9ab00" : "currentColor" }),
+    /* @__PURE__ */ jsx("rect", { x: "18.5", y: "18", width: "11", height: "25", rx: "5.5", fill: colored ? "#e37400" : "currentColor" }),
+    /* @__PURE__ */ jsx("circle", { cx: "12.5", cy: "37.5", r: "5.5", fill: colored ? "#e37400" : "currentColor" })
+  ] });
+}
+function TagManagerMark({ colored = false, className }) {
+  return /* @__PURE__ */ jsxs(BrandSvg, { className, children: [
+    /* @__PURE__ */ jsx("path", { fill: colored ? "#8ab4f8" : "currentColor", d: "M21.2 4.8a4 4 0 0 1 5.6 0l16.4 16.4a4 4 0 0 1 0 5.6L26.8 43.2a4 4 0 0 1-5.6 0L4.8 26.8a4 4 0 0 1 0-5.6z" }),
+    colored ? /* @__PURE__ */ jsx("path", { fill: "#4285f4", d: "M24 9.5 38.5 24 24 38.5 9.5 24z" }) : null,
+    /* @__PURE__ */ jsx("circle", { cx: "24", cy: "31", r: "4.5", fill: colored ? "#246fdb" : "var(--background, #fff)" })
+  ] });
+}
+function YouTubeMark({ colored = false, className }) {
+  return /* @__PURE__ */ jsxs(BrandSvg, { className, children: [
+    /* @__PURE__ */ jsx("path", { fill: colored ? "#ff0000" : "currentColor", d: "M44.1 14.1a5.5 5.5 0 0 0-3.9-3.9C36.8 9.3 24 9.3 24 9.3s-12.8 0-16.2.9a5.5 5.5 0 0 0-3.9 3.9C3 17.5 3 24 3 24s0 6.5.9 9.9a5.5 5.5 0 0 0 3.9 3.9c3.4.9 16.2.9 16.2.9s12.8 0 16.2-.9a5.5 5.5 0 0 0 3.9-3.9c.9-3.4.9-9.9.9-9.9s0-6.5-.9-9.9z" }),
+    /* @__PURE__ */ jsx("path", { fill: colored ? "#fff" : "var(--background, #fff)", d: "M20 30.5 30.8 24 20 17.5z" })
+  ] });
+}
+function GoogleDocsMark({ colored = false, className }) {
+  const page = colored ? "#4285F4" : "currentColor";
+  const ink = colored ? "#ffffff" : "var(--background, #fff)";
+  return /* @__PURE__ */ jsxs(MarkSvg, { className, children: [
+    /* @__PURE__ */ jsx("path", { fill: page, d: "M14.5 1H6a2 2 0 0 0-2 2v18a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V6.5L14.5 1Z" }),
+    colored ? /* @__PURE__ */ jsx("path", { fill: "#A1C2FA", d: "M14.5 1v4a1.5 1.5 0 0 0 1.5 1.5h4L14.5 1Z" }) : null,
+    /* @__PURE__ */ jsx("path", { fill: ink, d: "M8 11h8v1.4H8zM8 14h8v1.4H8zM8 17h5.5v1.4H8z" })
+  ] });
+}
+function GoogleSheetsMark({ colored = false, className }) {
+  const page = colored ? "#0F9D58" : "currentColor";
+  const ink = colored ? "#ffffff" : "var(--background, #fff)";
+  return /* @__PURE__ */ jsxs(MarkSvg, { className, children: [
+    /* @__PURE__ */ jsx("path", { fill: page, d: "M14.5 1H6a2 2 0 0 0-2 2v18a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V6.5L14.5 1Z" }),
+    colored ? /* @__PURE__ */ jsx("path", { fill: "#87CEAC", d: "M14.5 1v4a1.5 1.5 0 0 0 1.5 1.5h4L14.5 1Z" }) : null,
+    /* @__PURE__ */ jsx(
+      "path",
+      {
+        fill: ink,
+        d: "M7.5 10.5h9v8h-9v-8Zm1.3 1.3v2h2.6v-2H8.8Zm3.9 0v2h2.5v-2h-2.5Zm-3.9 3.3v2.1h2.6v-2.1H8.8Zm3.9 0v2.1h2.5v-2.1h-2.5Z",
+        fillRule: "evenodd"
+      }
+    )
+  ] });
+}
+function GitHubMark({ className }) {
+  return /* @__PURE__ */ jsx(MarkSvg, { className, children: /* @__PURE__ */ jsx(
+    "path",
+    {
+      fill: "currentColor",
+      d: "M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.07 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"
+    }
+  ) });
+}
+function MicrosoftMark({ colored = false, className }) {
+  const c = (hex) => colored ? hex : "currentColor";
+  return /* @__PURE__ */ jsxs(MarkSvg, { className, children: [
+    /* @__PURE__ */ jsx("path", { fill: c("#F25022"), d: "M2 2h9.5v9.5H2z" }),
+    /* @__PURE__ */ jsx("path", { fill: c("#7FBA00"), d: "M12.5 2H22v9.5h-9.5z" }),
+    /* @__PURE__ */ jsx("path", { fill: c("#00A4EF"), d: "M2 12.5h9.5V22H2z" }),
+    /* @__PURE__ */ jsx("path", { fill: c("#FFB900"), d: "M12.5 12.5H22V22h-9.5z" })
+  ] });
+}
+export {
+  GitHubMark,
+  GmailMark,
+  GoogleAnalyticsMark,
+  GoogleCalendarMark,
+  GoogleContactsMark,
+  GoogleDocsMark,
+  GoogleDriveMark,
+  GoogleMark,
+  GoogleSheetsMark,
+  GoogleTasksMark,
+  MicrosoftMark,
+  NotionMark,
+  SearchConsoleMark,
+  TagManagerMark,
+  YouTubeMark,
+  lucideMark
+};

package/dist/utils/connectors/types.d.ts

@@ -0,0 +1,77 @@
+import type { ComponentType } from "react";
+/** Stable connector id. Kebab-case, provider-scoped, never renamed. */
+export type ConnectorId = string;
+/**
+ * Where a connector is allowed to appear.
+ *
+ * - `strip`     — the one-line reminder under the agent input. Reserved for the
+ *                 few connections that change what a normal conversation can do.
+ * - `directory` — the full "all your connections" surface. Everything lives
+ *                 here; niche connectors live ONLY here.
+ *
+ * A connector with `["directory"]` is not lesser — it is simply too specific to
+ * earn a slot under the input.
+ */
+export type ConnectorSurface = "strip" | "directory";
+/** What the user's account looks like for this connector, right now. */
+export type ConnectorStatus = 
+/** Attached and usable. */
+"connected"
+/**
+ * Attached but only the user can restore it — an expired authorization
+ * that cannot be renewed automatically, or a failed refresh. Never shown
+ * as connected: that is exactly the lie a green checkmark told over an MCP
+ * the agent could not reach (Arman, 2026-09-13).
+ */
+ | "needs_reauth"
+/** Not attached — the one-click offer. */
+ | "not_connected"
+/** We do not support it yet; the config names the coming-soon promise. */
+ | "unavailable";
+export interface ConnectorLogoProps {
+    /** Brand color when true; `currentColor` when false. */
+    colored?: boolean;
+    className?: string;
+}
+/** A local brand mark. Dynamic MCP providers use their catalogue artwork. */
+export type ConnectorLogo = ComponentType<ConnectorLogoProps>;
+export interface ConnectorDefinition {
+    /** Stable id, generic to the provider — never bakes today's feature set in. */
+    id: ConnectorId;
+    /** Display name. Carries today's truth; may widen as the capability widens. */
+    name: string;
+    /** One user-facing line: what connecting unlocks. No jargon, no feature list. */
+    blurb: string;
+    /** Local first-party brand mark. */
+    logo?: ConnectorLogo;
+    /** Canonical MCP catalogue artwork for dynamically discovered providers. */
+    iconUrl?: string | null;
+    /** Ordered backup artwork candidates for dynamically discovered providers. */
+    fallbackIconUrls?: string[];
+    /** Canonical provider color, used only if its artwork fails to load. */
+    brandColor?: string | null;
+    /** Surfaces this connector may appear on. Explicit, never inferred. */
+    surfaces: ConnectorSurface[];
+    /**
+     * Where the user manages an existing connection. Rendered as a real door on
+     * a connected chip (CLAUDE.md § NO DEAD ENDS).
+     */
+    manageHref?: string;
+    /**
+     * Set ONLY when the connector is not connectable yet. The id must exist in
+     * `lib/coming-soon/registry.ts`; clicking announces that registered promise
+     * instead of raising a connect intent.
+     */
+    comingSoonId?: string;
+}
+/**
+ * How a surface tells the strip what is connected. Supply either — a set of
+ * connected ids (the common case) or a resolver (when a surface computes
+ * per-connector health itself). `resolveStatus` wins where both are given.
+ */
+export interface ConnectorStatusSource {
+    /** Ids the signed-in user has already connected. */
+    connectedIds?: Iterable<ConnectorId>;
+    /** Full per-connector resolver. Overrides `connectedIds`. */
+    resolveStatus?: (connector: ConnectorDefinition) => ConnectorStatus;
+}

package/dist/utils/content-ir/decision-answers-ids.d.ts

@@ -0,0 +1,3 @@
+/** The decision-answers block's stable wire ids (render-block type and kind slug). */
+export declare const DECISION_ANSWERS_KIND = "decision_answers";
+export declare const DECISION_ANSWERS_BLOCK_TYPE = "decision_answers";

package/dist/utils/content-ir/decision-answers-ids.js

@@ -0,0 +1,6 @@
+const DECISION_ANSWERS_KIND = "decision_answers";
+const DECISION_ANSWERS_BLOCK_TYPE = "decision_answers";
+export {
+  DECISION_ANSWERS_BLOCK_TYPE,
+  DECISION_ANSWERS_KIND
+};

package/dist/utils/content-ir/envelope-parity.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Pure envelope helpers the chat package needs (chat-package-move P14): the Phase-2 shadow
+ * parity check ("does the envelope, reconstructed, deep-equal what JSON.parse sees?").
+ *
+ * A COMPARISON, NEVER A TRANSFORM — the one lawful shape of `stripKindDeep` outside the two doors.
+ * Markers are removed from BOTH sides, symmetrically, inside this predicate, so a marker the parser
+ * INJECTED (speculation / expectedRootKind) is not reported as a mismatch against a source that did
+ * not carry one. Only a boolean leaves; neither input is mutated and neither reduced value is ever
+ * returned, stored, or rendered (KINDS_EVERYWHERE_PLAN §4.2).
+ */
+import { type CanonicalBlockIR } from "@ai-matrx/content-ir";
+export declare function envelopeMatchesParsedSource(envelope: CanonicalBlockIR, parsedSource: unknown): boolean;

package/dist/utils/content-ir/envelope-parity.js

@@ -0,0 +1,32 @@
+import { reconstructRegionValue, stripKindDeep } from "@ai-matrx/content-ir";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function deepEqual(left, right) {
+  if (Object.is(left, right)) return true;
+  if (Array.isArray(left) && Array.isArray(right)) {
+    if (left.length !== right.length) return false;
+    for (let i = 0; i < left.length; i++) {
+      if (!deepEqual(left[i], right[i])) return false;
+    }
+    return true;
+  }
+  if (isRecord(left) && isRecord(right)) {
+    const leftKeys = Object.keys(left);
+    const rightKeys = Object.keys(right);
+    if (leftKeys.length !== rightKeys.length) return false;
+    for (const key of leftKeys) {
+      if (!(key in right)) return false;
+      if (!deepEqual(left[key], right[key])) return false;
+    }
+    return true;
+  }
+  return false;
+}
+function envelopeMatchesParsedSource(envelope, parsedSource) {
+  if (!isRecord(parsedSource)) return false;
+  return deepEqual(stripKindDeep(reconstructRegionValue(envelope)), stripKindDeep(parsedSource));
+}
+export {
+  envelopeMatchesParsedSource
+};