@agent-native/core 0.112.0 → 0.113.0

package/corpus/core/src/client/chat/ChatHistoryList.tsx

@@ -1,404 +1,7 @@
-import {
-  IconDots,
-  IconPencil,
-  IconPinned,
-  IconPinnedOff,
-  IconSearch,
-  IconTrash,
-} from "@tabler/icons-react";
-import React, { useEffect, useRef, useState } from "react";
-
-import { cn } from "../utils.js";
-
-/** A single row in a chat history list. Purely data — no fetching, no
- * assistant-ui context. Formatting (relative time, "Active"/"Open" labels,
- * status spinners) is the caller's responsibility; hand in the already
- * rendered node via `timestamp`. */
-export interface ChatHistoryItem {
-  id: string;
-  title: React.ReactNode;
-  /** Plain-text form of `title`, used to seed the inline rename input.
-   * Only needed when `onRename` is supplied. */
-  titleText?: string;
-  /** Secondary line — e.g. a message preview. */
-  subtitle?: React.ReactNode;
-  /** Tertiary line — e.g. a scope/folder label. */
-  detail?: React.ReactNode;
-  /** Pre-formatted trailing value: a relative time, "Active"/"Open", or a
-   * status node (spinner, unread dot). This component does not format
-   * dates or compute status itself. */
-  timestamp?: React.ReactNode;
-  pinned?: boolean;
-  disabled?: boolean;
-}
-
-export interface ChatHistorySection {
-  id: string;
-  label?: React.ReactNode;
-  items: ChatHistoryItem[];
-}
-
-export interface ChatHistoryListProps {
-  /** Flat item list. Ignored when `sections` is provided. */
-  items?: ChatHistoryItem[];
-  /** Grouped item list (e.g. "This deck" / "All chats", or pinned/recent). */
-  sections?: ChatHistorySection[];
-  /** Id of the currently active/selected item — highlighted in the list. */
-  activeId?: string | null;
-  onSelect: (id: string) => void;
-  /** Fired on double-click / explicit "open" gesture, distinct from select. */
-  onOpen?: (id: string) => void;
-  /** Presence enables the pin/unpin row action. */
-  onTogglePin?: (id: string) => void;
-  /** Presence enables the inline "Rename" row action. */
-  onRename?: (id: string, nextTitle: string) => void;
-  /** Presence enables the "Delete" row action. */
-  onDelete?: (id: string) => void;
-  /** Escape hatch: fully custom row action menu content, replacing the
-   * built-in rename/pin/delete items. Still gated by the trigger button,
-   * which shows whenever this or any of the on* callbacks above is set. */
-  renderRowActions?: (item: ChatHistoryItem) => React.ReactNode;
-
-  /** Controlled search input. Omit `onSearchChange` to hide the search box
-   * entirely and let the host render its own (results are always supplied
-   * by the caller via `items`/`sections` either way). */
-  searchValue?: string;
-  onSearchChange?: (value: string) => void;
-  searchPlaceholder?: string;
-  searchInputRef?: React.Ref<HTMLInputElement>;
-
-  /** True while results are being fetched — shows `loadingLabel` instead of
-   * the list. */
-  loading?: boolean;
-  loadingLabel?: React.ReactNode;
-  /** Shown instead of the list when set (takes priority over `loading`). */
-  error?: React.ReactNode;
-  emptyLabel?: React.ReactNode;
-  /** Shown instead of `emptyLabel` when `searchValue` is non-empty. */
-  emptySearchLabel?: React.ReactNode;
-
-  /** Rendered after the list, inside the scroll container (e.g. a
-   * "Load older chats" button). */
-  footer?: React.ReactNode;
-
-  /** "popover" (default) matches core's compact HistoryPopover list.
-   * "rail" is a denser variant with a solid active background, closer to
-   * a sidebar run rail. */
-  variant?: "popover" | "rail";
-  className?: string;
-  listClassName?: string;
-}
-
-/**
- * Presentational chat history list shared by core's `HistoryPopover`
- * (MultiTabAssistantChat.tsx) and Agent-Native Code's run rail
- * (code-agents-ui). Styling is driven by stable `an-chat-history*` class
- * names (see `styles/chat-history-list.css`) rather than Tailwind utilities
- * so the same component renders correctly in a Tailwind host and in
- * code-agents-ui's plain-CSS host.
- *
- * This component owns no data: search filtering, pin/rename persistence,
- * and time formatting all stay with the caller. It only renders whatever
- * `items`/`sections` it is given, plus the optional search box and
- * loading/empty/error states.
- */
-export function ChatHistoryList({
-  items,
-  sections,
-  activeId = null,
-  onSelect,
-  onOpen,
-  onTogglePin,
-  onRename,
-  onDelete,
-  renderRowActions,
-  searchValue,
-  onSearchChange,
-  searchPlaceholder = "Search chats...",
-  searchInputRef,
-  loading = false,
-  loadingLabel = "Searching...",
-  error,
-  emptyLabel = "No chats yet",
-  emptySearchLabel = "No matching chats",
-  footer,
-  variant = "popover",
-  className,
-  listClassName,
-}: ChatHistoryListProps) {
-  const resolvedSections: ChatHistorySection[] =
-    sections ?? (items ? [{ id: "default", items }] : []);
-  const totalCount = resolvedSections.reduce(
-    (sum, section) => sum + section.items.length,
-    0,
-  );
-  const hasSearchValue = Boolean(searchValue?.trim());
-
-  return (
-    <div
-      className={cn(
-        "an-chat-history",
-        variant === "rail" && "an-chat-history--rail",
-        className,
-      )}
-      data-agent-native="chat-history-list"
-    >
-      {onSearchChange && (
-        <div className="an-chat-history__search">
-          <IconSearch size={13} className="an-chat-history__search-icon" />
-          <input
-            ref={searchInputRef}
-            type="text"
-            value={searchValue ?? ""}
-            onChange={(event) => onSearchChange(event.target.value)}
-            placeholder={searchPlaceholder}
-            aria-label={searchPlaceholder}
-            className="an-chat-history__search-input"
-          />
-        </div>
-      )}
-      <div className={cn("an-chat-history__list", listClassName)}>
-        {error ? (
-          <div className="an-chat-history__state an-chat-history__state--error">
-            {error}
-          </div>
-        ) : loading ? (
-          <div className="an-chat-history__state">{loadingLabel}</div>
-        ) : totalCount === 0 ? (
-          <div className="an-chat-history__state">
-            {hasSearchValue ? emptySearchLabel : emptyLabel}
-          </div>
-        ) : (
-          resolvedSections.map(
-            (section) =>
-              section.items.length > 0 && (
-                <div key={section.id} className="an-chat-history__section">
-                  {section.label && (
-                    <div className="an-chat-history__section-label">
-                      {section.label}
-                    </div>
-                  )}
-                  {section.items.map((item) => (
-                    <ChatHistoryRow
-                      key={item.id}
-                      item={item}
-                      active={item.id === activeId}
-                      onSelect={onSelect}
-                      onOpen={onOpen}
-                      onTogglePin={onTogglePin}
-                      onRename={onRename}
-                      onDelete={onDelete}
-                      renderRowActions={renderRowActions}
-                    />
-                  ))}
-                </div>
-              ),
-          )
-        )}
-        {footer}
-      </div>
-    </div>
-  );
-}
-
-function ChatHistoryRow({
-  item,
-  active,
-  onSelect,
-  onOpen,
-  onTogglePin,
-  onRename,
-  onDelete,
-  renderRowActions,
-}: {
-  item: ChatHistoryItem;
-  active: boolean;
-  onSelect: (id: string) => void;
-  onOpen?: (id: string) => void;
-  onTogglePin?: (id: string) => void;
-  onRename?: (id: string, nextTitle: string) => void;
-  onDelete?: (id: string) => void;
-  renderRowActions?: (item: ChatHistoryItem) => React.ReactNode;
-}) {
-  const [isRenaming, setIsRenaming] = useState(false);
-  const [draftTitle, setDraftTitle] = useState("");
-  const [menuOpen, setMenuOpen] = useState(false);
-  const renameInputRef = useRef<HTMLInputElement | null>(null);
-  const menuRef = useRef<HTMLDivElement | null>(null);
-
-  const hasMenu = Boolean(
-    onTogglePin || onRename || onDelete || renderRowActions,
-  );
-
-  useEffect(() => {
-    if (!menuOpen) return;
-    function handlePointerDown(event: PointerEvent) {
-      if (menuRef.current && !menuRef.current.contains(event.target as Node)) {
-        setMenuOpen(false);
-      }
-    }
-    function handleKeyDown(event: KeyboardEvent) {
-      if (event.key === "Escape") setMenuOpen(false);
-    }
-    document.addEventListener("pointerdown", handlePointerDown);
-    document.addEventListener("keydown", handleKeyDown);
-    return () => {
-      document.removeEventListener("pointerdown", handlePointerDown);
-      document.removeEventListener("keydown", handleKeyDown);
-    };
-  }, [menuOpen]);
-
-  function startRename() {
-    setDraftTitle(item.titleText ?? "");
-    setIsRenaming(true);
-    setMenuOpen(false);
-    window.requestAnimationFrame(() => {
-      renameInputRef.current?.select();
-    });
-  }
-
-  function commitRename() {
-    const trimmed = draftTitle.trim();
-    setIsRenaming(false);
-    if (trimmed && trimmed !== item.titleText) {
-      onRename?.(item.id, trimmed);
-    }
-  }
-
-  function handleRenameKeyDown(event: React.KeyboardEvent<HTMLInputElement>) {
-    if (event.key === "Enter") {
-      event.preventDefault();
-      commitRename();
-    } else if (event.key === "Escape") {
-      event.preventDefault();
-      setIsRenaming(false);
-    }
-  }
-
-  return (
-    <div
-      className={cn(
-        "an-chat-history-row",
-        active && "an-chat-history-row--active",
-        item.pinned && "an-chat-history-row--pinned",
-        isRenaming && "an-chat-history-row--renaming",
-        item.disabled && "an-chat-history-row--disabled",
-      )}
-    >
-      {isRenaming ? (
-        <div className="an-chat-history-row__rename">
-          <input
-            ref={renameInputRef}
-            className="an-chat-history-row__rename-input"
-            value={draftTitle}
-            onChange={(event) => setDraftTitle(event.target.value)}
-            onKeyDown={handleRenameKeyDown}
-            onBlur={commitRename}
-            autoFocus
-            aria-label="Rename chat"
-          />
-        </div>
-      ) : (
-        <button
-          type="button"
-          className="an-chat-history-row__button"
-          onClick={() => !item.disabled && onSelect(item.id)}
-          onDoubleClick={() => !item.disabled && onOpen?.(item.id)}
-          disabled={item.disabled}
-        >
-          <div className="an-chat-history-row__topline">
-            <span className="an-chat-history-row__title">{item.title}</span>
-            {item.timestamp != null && (
-              <span className="an-chat-history-row__timestamp">
-                {item.timestamp}
-              </span>
-            )}
-          </div>
-          {item.subtitle != null && (
-            <div className="an-chat-history-row__subtitle">{item.subtitle}</div>
-          )}
-          {item.detail != null && (
-            <div className="an-chat-history-row__detail">{item.detail}</div>
-          )}
-        </button>
-      )}
-
-      {!isRenaming && hasMenu && (
-        <div className="an-chat-history-row__menu" ref={menuRef}>
-          <button
-            type="button"
-            className={cn(
-              "an-chat-history-row__menu-trigger",
-              item.pinned && "an-chat-history-row__menu-trigger--pinned",
-            )}
-            aria-label="Chat options"
-            aria-haspopup="menu"
-            aria-expanded={menuOpen}
-            onClick={() => setMenuOpen((open) => !open)}
-          >
-            {item.pinned ? (
-              <IconPinned size={13} strokeWidth={1.8} />
-            ) : (
-              <IconDots size={14} strokeWidth={1.8} />
-            )}
-          </button>
-          {menuOpen && (
-            <div className="an-chat-history-row__menu-content" role="menu">
-              {renderRowActions ? (
-                renderRowActions(item)
-              ) : (
-                <>
-                  {onRename && (
-                    <button
-                      type="button"
-                      role="menuitem"
-                      className="an-chat-history-row__menu-item"
-                      onClick={startRename}
-                    >
-                      <IconPencil size={13} strokeWidth={1.8} />
-                      <span>Rename</span>
-                    </button>
-                  )}
-                  {onTogglePin && (
-                    <button
-                      type="button"
-                      role="menuitem"
-                      className="an-chat-history-row__menu-item"
-                      onClick={() => {
-                        setMenuOpen(false);
-                        onTogglePin(item.id);
-                      }}
-                    >
-                      {item.pinned ? (
-                        <IconPinnedOff size={13} strokeWidth={1.8} />
-                      ) : (
-                        <IconPinned size={13} strokeWidth={1.8} />
-                      )}
-                      <span>
-                        {item.pinned ? "Unpin from top" : "Pin to top"}
-                      </span>
-                    </button>
-                  )}
-                  {onDelete && (
-                    <button
-                      type="button"
-                      role="menuitem"
-                      className="an-chat-history-row__menu-item an-chat-history-row__menu-item--danger"
-                      onClick={() => {
-                        setMenuOpen(false);
-                        onDelete(item.id);
-                      }}
-                    >
-                      <IconTrash size={13} strokeWidth={1.8} />
-                      <span>Delete</span>
-                    </button>
-                  )}
-                </>
-              )}
-            </div>
-          )}
-        </div>
-      )}
-    </div>
-  );
-}
+export {
+  ChatHistoryList,
+  type ChatHistoryItem,
+  type ChatHistoryListLabels,
+  type ChatHistoryListProps,
+  type ChatHistorySection,
+} from "@agent-native/toolkit/chat-history";

package/corpus/core/src/integrations/index.ts

@@ -18,6 +18,13 @@ export type {
   PlatformDeliveryReceipt,
 } from "./types.js";
 export { assertPlatformCapability } from "./types.js";
+export {
+  deliverJsonWebhook,
+  escapeSlackMrkdwn,
+  isWebhookUrlAllowed,
+  type DeliverJsonWebhookOptions,
+  type JsonWebhookDeliveryResult,
+} from "./webhook-delivery.js";
 
 export { resolveDefaultIntegrationExecutionContext } from "./identity.js";
 export {
@@ -150,6 +157,8 @@ export type {
 } from "./installations-store.js";
 
 export {
+  SLACK_AUTHORIZE_URL,
+  SLACK_TOKEN_URL,
   assertSlackInstallAccess,
   buildSlackAuthorizeUrl,
   exchangeSlackOAuthCode,
@@ -157,6 +166,7 @@ export {
   slackInstallationKey,
   slackOAuthResponseToInstallation,
   testSlackAuth,
+  type SlackOAuthAccessResponse,
 } from "./slack-oauth.js";
 
 export {

package/corpus/core/src/integrations/slack-oauth.ts

@@ -14,6 +14,7 @@ export const SLACK_AUTH_TEST_URL = "https://slack.com/api/auth.test";
 export const SLACK_AGENT_BOT_SCOPES = [
   "assistant:write",
   "app_mentions:read",
+  "channels:join",
   "channels:read",
   "channels:history",
   "chat:write",

package/corpus/core/src/integrations/webhook-delivery.ts

@@ -0,0 +1,55 @@
+import {
+  isBlockedExtensionUrl,
+  ssrfSafeFetch,
+} from "../extensions/url-safety.js";
+
+export function escapeSlackMrkdwn(value: string): string {
+  return value
+    .replace(/&/g, "&")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;");
+}
+
+export function isWebhookUrlAllowed(url: string): boolean {
+  return !isBlockedExtensionUrl(url);
+}
+
+export interface DeliverJsonWebhookOptions {
+  url: string;
+  payload: unknown;
+  headers?: Record<string, string>;
+  timeoutMs?: number;
+  maxRedirects?: number;
+}
+
+export type JsonWebhookDeliveryResult =
+  | { ok: true; status: number }
+  | { ok: false; blocked: true }
+  | { ok: false; blocked: false; status?: number; error?: unknown };
+
+export async function deliverJsonWebhook(
+  options: DeliverJsonWebhookOptions,
+): Promise<JsonWebhookDeliveryResult> {
+  if (!isWebhookUrlAllowed(options.url)) return { ok: false, blocked: true };
+
+  try {
+    const response = await ssrfSafeFetch(
+      options.url,
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...options.headers,
+        },
+        body: JSON.stringify(options.payload),
+        signal: AbortSignal.timeout(options.timeoutMs ?? 10_000),
+      },
+      { maxRedirects: options.maxRedirects ?? 3 },
+    );
+    return response.ok
+      ? { ok: true, status: response.status }
+      : { ok: false, blocked: false, status: response.status };
+  } catch (error) {
+    return { ok: false, blocked: false, error };
+  }
+}

package/corpus/core/src/notifications/channels.ts

@@ -28,6 +28,7 @@
  */
 
 import { ssrfSafeFetch } from "../extensions/url-safety.js";
+import { escapeSlackMrkdwn } from "../integrations/webhook-delivery.js";
 import {
   getKeyAllowlist,
   getResolvedKeyAllowlist,
@@ -140,7 +141,7 @@ function createSlackWebhookChannel(
                 type: "section",
                 text: {
                   type: "mrkdwn",
-                  text: `*${escapeSlack(input.title)}*`,
+                  text: `*${escapeSlackMrkdwn(input.title)}*`,
                 },
               },
               ...(input.body
@@ -149,7 +150,7 @@ function createSlackWebhookChannel(
                       type: "section",
                       text: {
                         type: "mrkdwn",
-                        text: escapeSlack(input.body),
+                        text: escapeSlackMrkdwn(input.body),
                       },
                     },
                   ]
@@ -159,7 +160,7 @@ function createSlackWebhookChannel(
                 elements: [
                   {
                     type: "mrkdwn",
-                    text: `Severity: \`${input.severity}\`  Owner: ${escapeSlack(meta.owner)}`,
+                    text: `Severity: \`${input.severity}\`  Owner: ${escapeSlackMrkdwn(meta.owner)}`,
                   },
                 ],
               },
@@ -375,13 +376,6 @@ function slackText(
   return `[${severity}] ${title}${body ? `\n${body}` : ""}`;
 }
 
-function escapeSlack(value: string): string {
-  return value
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;");
-}
-
 function escapeHtml(value: string): string {
   return value
     .replace(/&/g, "&amp;")