@itechchoice/prime-chatkit 0.1.0-alpha.0

package/dist/types/core/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * View model of PrimeChatKit. Backend-agnostic: adapters turn their wire format into these shapes,
+ * the UI only reads these shapes.
+ */
+export type RunStatus = "running" | "waiting" | "completed" | "failed" | "cancelled";
+export type ToolStatus = "running" | "success" | "error";
+export type ToolCall = {
+    /** Stable id: occurrenceId, else callId */
+    id: string;
+    callId?: string;
+    /** Raw capability name, e.g. "mcp:thaleonmcp:uta_get_portfolio_xray" or "artifact_search" */
+    capability: string;
+    /** Short tool name shown in mono, e.g. "uta_get_portfolio_xray" */
+    name: string;
+    /** MCP server code, e.g. "thaleonmcp"; undefined for built-in tools */
+    server?: string;
+    kind: "mcp" | "tool" | "agent" | "other";
+    /** One-line human summary, from the tool definition or its arguments */
+    summary?: string;
+    status: ToolStatus;
+    /** ms since epoch, client clock */
+    startedAt: number;
+    durationMs?: number;
+    args?: unknown;
+    result?: unknown;
+    error?: string;
+};
+export type ModelCall = {
+    model?: string;
+    status: "running" | "done";
+    startedAt: number;
+    durationMs?: number;
+    tokens?: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    cachedPromptTokens?: number;
+    stopReason?: string;
+};
+/** One model iteration: what the model said and the tools it called in that turn */
+export type Turn = {
+    iteration: number;
+    outputId?: string;
+    model?: ModelCall;
+    /** Public text streamed in this turn (ASSISTANT_MESSAGE_DELTA) */
+    text: string;
+    /** Reasoning text, when the provider streams it */
+    thinking: string;
+    tools: ToolCall[];
+};
+export type PrepareInfo = {
+    status: "running" | "done";
+    agent?: {
+        name: string;
+        model?: string;
+        description?: string;
+    };
+    capabilities?: {
+        tools?: number;
+        mcpTools?: number;
+        mcpServers?: number;
+        agents?: number;
+        skills?: number;
+    };
+    context?: {
+        windowTokens?: number;
+        toolsTokens?: number;
+        historyBudget?: number;
+        memoryRows?: number;
+    };
+    discovery?: {
+        total?: number;
+        visible?: number;
+        promoted: string[];
+        durationMs?: number;
+    };
+};
+/** A clarifying question the agent wants answered, with quick options */
+export type Ask = {
+    id: string;
+    question: string;
+    header?: string;
+    options: {
+        id: string;
+        label: string;
+        description?: string;
+    }[];
+    allowCustom?: boolean;
+};
+export type RunSummary = {
+    durationMs?: number;
+    steps?: number;
+    tokens?: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    costUsd?: number;
+};
+export type Run = {
+    taskId: string;
+    status: RunStatus;
+    startedAt: number;
+    endedAt?: number;
+    prepare: PrepareInfo;
+    turns: Turn[];
+    answer: {
+        text: string;
+        /** outputId the answer was taken from */
+        outputId?: string;
+        /** true once FINAL_MESSAGE_COMPLETED (or history) confirmed it */
+        final: boolean;
+        /** FINAL_MESSAGE_DELTA text collected until FINAL_MESSAGE_COMPLETED swaps it in */
+        finalBuffer?: string;
+    };
+    summary?: RunSummary;
+    asks: Ask[];
+    followUps: {
+        id: string;
+        label: string;
+        message: string;
+    }[];
+    /** Waiting on the user (HITL); details come from the task endpoint */
+    suspension?: {
+        id?: string;
+        reason?: string;
+        gateType?: string;
+    };
+    error?: string;
+    /** Highest event id applied, as a decimal string (ids are snowflakes) */
+    lastEventId?: string;
+};
+export type Attachment = {
+    id: string;
+    name: string;
+    mimeType?: string;
+    size?: number;
+};
+export type ChatMessage = {
+    id: string;
+    role: "user";
+    text: string;
+    createdAt: number;
+    attachments?: Attachment[];
+} | {
+    id: string;
+    role: "assistant";
+    createdAt: number;
+    run: Run;
+};
+export type StreamEvent = {
+    id?: string;
+    event: string;
+    data: Record<string, unknown>;
+};

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from "./provider/PrimeViaChat";
+export { PrimeViaChatProvider } from "./provider/PrimeViaChatProvider";
+export { PrimeViaChatShell } from "./provider/PrimeViaChatShell";
+export { usePrimeViaChat, usePrimeViaConfig, useProvisioning, usePanelState, useChatScope, useChatLocale, useAvailability, useProcessView, } from "./provider/hooks";
+export { CHAT_SCOPE_TYPE, scopeKeyOf } from "./core/scope";
+export type { PrimeViaHttpConfig, PrimeViaAvailability, PrimeViaScopeType, PrimeViaScope, PrimeViaCreditBalance, PrimeViaStartPrompt, PrimeViaPanelState, PrimeViaProcessView, PrimeViaChatProviderProps, } from "./provider/config";

package/dist/types/layout/DockShell.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import { type LayoutApi, type PanelMode } from './useLayout';
+import './dock.css';
+export interface DockShellProps {
+    enabled: boolean;
+    panelVisible: boolean;
+    panelMode?: string;
+    onPanelModeChange: (mode: PanelMode) => void;
+    onRestore: () => void;
+    labels: {
+        resizeHandle: string;
+        resizeCorner: string;
+        restore: string;
+        restoreText: string;
+    };
+    children: (layout: LayoutApi) => ReactNode;
+    className?: string;
+}
+export declare function DockShell({ enabled, panelVisible, panelMode, onPanelModeChange, onRestore, labels, children, className, }: DockShellProps): import("react").JSX.Element;

package/dist/types/layout/constants.d.ts

@@ -0,0 +1,22 @@
+/**
+ * dock/split 布局常量。
+ * 从 prime-via/src/layout/constants.js 原样移植数值与解析规则。
+ *
+ * 复制自 src/components/ChatKit/constants/config.js —— ChatKit 的常量文件里还混着
+ * traceId、鉴权、主题等与布局无关的东西，整份引进来会把宿主依赖一起拖进包里，
+ * 所以这里只挑布局用得上的数值。ChatKit 下线后原文件可直接删。
+ */
+export declare const SPLIT_BREAKPOINT = 1440;
+export declare const MIN_SPLIT_WIDTH = 1280;
+export declare const DOCK_INTERACTIVE_BREAKPOINT = 768;
+export declare const MIN_SPLIT_CONTENT_WIDTH = 620;
+export declare const HEADER_HEIGHT_FALLBACK = 64;
+export declare const DOCK_EDGE_GAP = 12;
+export declare const DOCK_DEFAULT_WIDTH = 720;
+export declare const DOCK_DEFAULT_HEIGHT = 760;
+export declare const DOCK_MIN_WIDTH = 420;
+export declare const DOCK_MIN_HEIGHT = 620;
+export declare const DOCK_MAX_WIDTH = 960;
+export declare const DOCK_GEOMETRY_STORAGE_KEY = "abcPrimeDockGeometry:v1";
+/** 解析 CSS 像素值（逐行对齐原 @/utils/widthGovernance.parseCssPixel 的行为） */
+export declare const parseCssPixel: (rawValue: unknown, fallback?: number) => number;

package/dist/types/layout/index.d.ts

@@ -0,0 +1,3 @@
+export * from './constants';
+export { clampDockGeometry, getDefaultDockGeometry, readDockGeometry, persistDockGeometry, useLayout, type DockGeometry, type PanelMode, type LayoutApi, } from './useLayout';
+export { DockShell, type DockShellProps } from './DockShell';

package/dist/types/layout/useLayout.d.ts

@@ -0,0 +1,52 @@
+/**
+ * dock/split 布局管理 Hook。
+ *
+ * 移植自 prime-via/src/layout/useLayout.js，保留调用方注入的 setPanelMode。
+ * 除 TypeScript 类型外，唯一行为差异是 WO-M3.1-2 裁决授权的分屏拖宽卸载清理。
+ */
+import { type CSSProperties, type PointerEvent as ReactPointerEvent } from 'react';
+export interface DockGeometry {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export type PanelMode = 'auto' | 'dock' | 'split';
+export type LayoutApi = ReturnType<typeof useLayout>;
+type DockViewport = {
+    viewportWidth: number;
+    viewportHeight: number;
+    headerHeight: number;
+};
+type DockStorage = Partial<Pick<Storage, 'getItem' | 'setItem'>>;
+type LayoutStyle = CSSProperties & {
+    [name: `--${string}`]: string | number | undefined;
+};
+export declare const clampDockGeometry: (geometry: DockGeometry | null, { viewportWidth, viewportHeight, headerHeight }: DockViewport) => DockGeometry | null;
+export declare const getDefaultDockGeometry: ({ viewportWidth, viewportHeight, headerHeight }: DockViewport) => DockGeometry | null;
+export declare const readDockGeometry: (storageLike?: DockStorage | undefined) => DockGeometry | null;
+export declare const persistDockGeometry: (geometry: DockGeometry | null, storageLike?: DockStorage | undefined) => void;
+/**
+ * 管理 ChatKit 面板的布局状态
+ * @param {boolean} isPanelVisible - 面板是否可见
+ * @param {string} panelMode - 面板模式 ('auto' | 'split' | 'dock')
+ * @returns {Object} 布局状态和方法
+ */
+export declare const useLayout: (isPanelVisible: boolean, panelMode: string | undefined, setPanelMode: (mode: PanelMode) => void) => {
+    isSplitLayout: boolean;
+    isSplitActive: boolean;
+    isResizeReady: boolean;
+    isResizing: boolean;
+    isDockInteractive: boolean;
+    isDockDragging: boolean;
+    isDockResizing: boolean;
+    shellRef: import("react").RefObject<HTMLDivElement | null>;
+    shellStyle: LayoutStyle;
+    toggleLayout: () => void;
+    handleResizeStart: (event: ReactPointerEvent<HTMLElement>) => void;
+    handleResizeEnter: () => void;
+    handleResizeLeave: () => void;
+    handleDockDragStart: (event: ReactPointerEvent<HTMLElement>) => void;
+    handleDockResizeStart: (event: ReactPointerEvent<HTMLElement>) => void;
+};
+export {};

package/dist/types/provider/PrimeViaChat.d.ts

@@ -0,0 +1,2 @@
+declare const PrimeViaChat: import("react").NamedExoticComponent<object>;
+export default PrimeViaChat;

package/dist/types/provider/PrimeViaChatProvider.d.ts

@@ -0,0 +1,2 @@
+import { type PrimeViaChatProviderProps } from "./config";
+export declare function PrimeViaChatProvider(props: PrimeViaChatProviderProps): import("react").JSX.Element;

package/dist/types/provider/PrimeViaChatShell.d.ts

@@ -0,0 +1,5 @@
+export declare function PrimeViaChatShell({ enabled, panelMode, panelVisible }: {
+    enabled: boolean;
+    panelMode?: string;
+    panelVisible: boolean;
+}): import("react").JSX.Element;

package/dist/types/provider/config.d.ts

@@ -0,0 +1,92 @@
+import type { ReactNode } from "react";
+import type { BffHttp } from "../adapters/bff/client";
+import type { ChatScope, ChatScopeType } from "../core/scope";
+export type PrimeViaHttpConfig = BffHttp;
+export type PrimeViaScope = ChatScope;
+export type PrimeViaScopeType = ChatScopeType;
+export interface PrimeViaAvailability {
+    available?: boolean;
+    message?: string;
+}
+export interface PrimeViaCreditBalance {
+    plan?: {
+        allowance: number;
+        used: number;
+        remaining: number;
+    };
+    available: number;
+}
+export interface PrimeViaStartPrompt {
+    icon?: string;
+    label: string;
+    prompt: string;
+}
+export interface PrimeViaPanelState {
+    enabled: boolean;
+    visible: boolean;
+    mode?: string;
+}
+export type PrimeViaProcessView = "replies" | "full";
+export interface PrimeViaChatProviderProps {
+    http: PrimeViaHttpConfig;
+    locale?: string;
+    getTraceId?: () => string;
+    availability?: PrimeViaAvailability;
+    scope?: PrimeViaScope;
+    credit?: PrimeViaCreditBalance | null;
+    startScreen?: {
+        greeting?: string;
+        prompts?: PrimeViaStartPrompt[];
+    };
+    branding?: {
+        title?: string;
+        logo?: string | null;
+    };
+    onNavigate?: (target: string | {
+        path: string;
+    }) => void;
+    panel?: PrimeViaPanelState | null;
+    onPanelChange?: (next: Partial<PrimeViaPanelState>) => void;
+    processView?: PrimeViaProcessView;
+    children?: ReactNode;
+}
+export declare function normalizeConfig(props?: Omit<PrimeViaChatProviderProps, "http" | "children">): {
+    locale: string;
+    getTraceId: () => string;
+    onNavigate: (target: string | {
+        path: string;
+    }) => void;
+    availability: {
+        available: boolean;
+        message: string;
+    };
+    scope: {
+        scopeType: ChatScopeType;
+        scopeId: string;
+        pending: boolean;
+    };
+    credit: {
+        plan?: {
+            allowance: number;
+            used: number;
+            remaining: number;
+        } | undefined;
+        available: number;
+    } | null;
+    startScreen: {
+        greeting: string;
+        prompts: PrimeViaStartPrompt[];
+    };
+    branding: {
+        title: string;
+        logo: string | null;
+    };
+    panel: {
+        enabled: boolean;
+        visible: boolean;
+        mode: string | undefined;
+    } | null;
+    onPanelChange: (next: Partial<PrimeViaPanelState>) => void;
+    processView: "replies" | "full";
+};
+export type PrimeViaConfig = ReturnType<typeof normalizeConfig>;

package/dist/types/provider/context.d.ts

@@ -0,0 +1,53 @@
+import type { BffClient } from "../adapters/bff/client";
+import type { createChatController } from "../adapters/bff/controller";
+import type { PrimeViaPanelState } from "./config";
+export type ChatRuntime = {
+    client: BffClient;
+    controller: ReturnType<typeof createChatController>;
+};
+export declare const ConfigContext: import("react").Context<{
+    locale: string;
+    getTraceId: () => string;
+    onNavigate: (target: string | {
+        path: string;
+    }) => void;
+    availability: {
+        available: boolean;
+        message: string;
+    };
+    scope: {
+        scopeType: import("../core/scope").ChatScopeType;
+        scopeId: string;
+        pending: boolean;
+    };
+    credit: {
+        plan?: {
+            allowance: number;
+            used: number;
+            remaining: number;
+        } | undefined;
+        available: number;
+    } | null;
+    startScreen: {
+        greeting: string;
+        prompts: import("./config").PrimeViaStartPrompt[];
+    };
+    branding: {
+        title: string;
+        logo: string | null;
+    };
+    panel: {
+        enabled: boolean;
+        visible: boolean;
+        mode: string | undefined;
+    } | null;
+    onPanelChange: (next: Partial<PrimeViaPanelState>) => void;
+    processView: "replies" | "full";
+} | null>;
+export declare const RuntimeContext: import("react").Context<ChatRuntime | null>;
+export declare const PanelContext: import("react").Context<{
+    panel: PrimeViaPanelState;
+    patch: (next: Partial<PrimeViaPanelState>) => void;
+} | null>;
+export declare function useRequiredContext<T>(context: React.Context<T | null>): T;
+export declare const useChatRuntime: () => ChatRuntime;

package/dist/types/provider/hooks.d.ts

@@ -0,0 +1,82 @@
+import type { PrimeViaPanelState } from "./config";
+export declare const usePrimeViaConfig: () => {
+    locale: string;
+    getTraceId: () => string;
+    onNavigate: (target: string | {
+        path: string;
+    }) => void;
+    availability: {
+        available: boolean;
+        message: string;
+    };
+    scope: {
+        scopeType: import("../core/scope").ChatScopeType;
+        scopeId: string;
+        pending: boolean;
+    };
+    credit: {
+        plan?: {
+            allowance: number;
+            used: number;
+            remaining: number;
+        } | undefined;
+        available: number;
+    } | null;
+    startScreen: {
+        greeting: string;
+        prompts: import("./config").PrimeViaStartPrompt[];
+    };
+    branding: {
+        title: string;
+        logo: string | null;
+    };
+    panel: {
+        enabled: boolean;
+        visible: boolean;
+        mode: string | undefined;
+    } | null;
+    onPanelChange: (next: Partial<PrimeViaPanelState>) => void;
+    processView: "replies" | "full";
+};
+export declare const useChatScope: () => {
+    scopeType: import("../core/scope").ChatScopeType;
+    scopeId: string;
+    pending: boolean;
+};
+export declare const useAvailability: () => {
+    available: boolean;
+    message: string;
+};
+export declare const useChatLocale: () => string;
+export declare const useProcessView: () => "replies" | "full";
+export declare function usePrimeViaChat(): {
+    state: import("../adapters/bff/controller").ControllerState;
+    send: (text: string, opts?: {
+        attachments?: import("../adapters/bff/client").UploadedAttachment[];
+        requestMetadata?: Omit<import("../adapters/bff/client").TaskRequestMetadata, "attachments">;
+    }) => Promise<void>;
+    stop: () => Promise<void>;
+    newChat: () => void;
+    openSession: (sessionId: string) => Promise<void>;
+    answer: (a: import("../core/suspension").SuspensionAnswer) => Promise<void>;
+    cancelSuspension: () => Promise<void>;
+    upload: (file: Blob & {
+        name?: string;
+    }, onProgress?: (p: number) => void, signal?: AbortSignal) => Promise<import("../adapters/bff/client").UploadedAttachment>;
+};
+export declare function useProvisioning(): {
+    checked: boolean;
+    ready: boolean;
+    overallStatus: string | null;
+    lastFailedReason: string | null;
+    triggering: boolean;
+    provision: () => Promise<void>;
+};
+export declare function usePanelState(): {
+    enabled: boolean;
+    visible: boolean;
+    mode: string;
+    setPanelMode: (mode: string) => void;
+    hidePanel: () => void;
+    showPanel: () => void;
+};

package/dist/types/ui/HistoryPanel.d.ts

@@ -0,0 +1,11 @@
+import type { ControllerState } from "../adapters/bff/controller";
+export type HistoryPanelProps = {
+    sessions?: ControllerState["sessions"];
+    currentId?: string;
+    locale?: string;
+    onOpen: (id: string) => void;
+    onRename: (id: string, title: string) => void;
+    onDelete: (id: string) => void;
+    onClose: () => void;
+};
+export declare function HistoryPanel({ sessions, currentId, locale, onOpen, onRename, onDelete, onClose }: HistoryPanelProps): import("react").JSX.Element;

package/dist/types/ui/blocks/BlocksPanel.d.ts

@@ -0,0 +1,70 @@
+import { type PointerEvent } from "react";
+import type { UploadedAttachment } from "../../adapters/bff/client";
+import type { ControllerState } from "../../adapters/bff/controller";
+import type { ChatMessage } from "../../core/types";
+import type { Suspension, SuspensionAnswer } from "../../core/suspension";
+import { type OlderMessages } from "./useFollowLatest";
+import { type GetAttachmentUrls } from "./useAttachmentDownload";
+export type BlocksPanelProps = {
+    messages: ChatMessage[];
+    history?: {
+        sessions?: ControllerState["sessions"];
+        currentId?: string;
+        onLoad: () => void;
+        onOpen: (id: string) => void;
+        onRename: (id: string, title: string) => void;
+        onDelete: (id: string) => void;
+    };
+    start?: {
+        greeting?: string;
+        prompts?: {
+            icon?: string;
+            label: string;
+            prompt: string;
+        }[];
+    };
+    availability?: {
+        available?: boolean;
+        message?: string;
+    };
+    onNavigate?: (path: string) => void;
+    provisioning?: {
+        checked: boolean;
+        ready: boolean;
+        triggering: boolean;
+        lastFailedReason: string | null;
+        onProvision: () => void;
+    };
+    suspension?: Suspension;
+    onAnswerSuspension?: (a: SuspensionAnswer) => void;
+    onCancelSuspension?: () => void;
+    error?: {
+        code: string;
+        status?: number;
+    };
+    locale?: string;
+    credits?: number;
+    branding?: {
+        title?: string;
+        avatar?: string;
+    };
+    onSend: (text: string, attachments: UploadedAttachment[]) => void;
+    onStop?: () => void;
+    onNewChat?: () => void;
+    onToggleLayout?: () => void;
+    onClose?: () => void;
+    onCreditsClick?: () => void;
+    onRegenerate?: (messageId: string) => void;
+    onFeedback?: (messageId: string, kind: "up" | "down" | null, reason?: string) => void;
+    upload?: (file: File, progress: (p: number) => void, signal: AbortSignal) => Promise<UploadedAttachment>;
+    onHeaderPointerDown?: (event: PointerEvent<HTMLElement>) => void;
+    processView?: "full" | "replies";
+    className?: string;
+    older?: OlderMessages;
+    attachmentLimits?: {
+        allowedExtensions: string[];
+        maxSizeBytes?: number;
+    };
+    getAttachmentUrls?: GetAttachmentUrls;
+};
+export declare function BlocksPanel({ messages, history, start, availability, provisioning, older, suspension, onAnswerSuspension, onCancelSuspension, error, locale, credits, branding, onSend, onStop, onNewChat, onToggleLayout, onClose, onCreditsClick, onHeaderPointerDown, processView, onRegenerate, onFeedback, onNavigate, upload, attachmentLimits, getAttachmentUrls, className }: BlocksPanelProps): import("react").JSX.Element;

package/dist/types/ui/blocks/Process.d.ts

@@ -0,0 +1,7 @@
+import type { ThreadTool } from "../thread";
+import type { Run } from "../../core/types";
+export declare function Process({ tools, run, locale }: {
+    tools: ThreadTool[];
+    run: Run;
+    locale: string;
+}): import("react").JSX.Element | null;

package/dist/types/ui/blocks/Questions.d.ts

@@ -0,0 +1,25 @@
+import type { ThreadDecision } from "../thread";
+import { type Decision, type DecisionAnswer } from "../../components/ui/decision-card-clean";
+import type { Suspension, SuspensionAnswer } from "../../core/suspension";
+type QuestionDraft = {
+    values: Record<string, string | string[]>;
+    custom: Record<string, string>;
+};
+export declare function cardDecisions(decisions: ThreadDecision[]): Decision[];
+/** Accumulate one answer per schema field; only the final draft is submitted. */
+export declare function nextQuestionDraft(s: Extract<Suspension, {
+    kind: "questions";
+}>, draft: QuestionDraft, id: string, answer: DecisionAnswer): QuestionDraft | undefined;
+type QuestionsProps = {
+    suspension: Suspension;
+    locale: string;
+    onAnswer?: (answer: SuspensionAnswer) => void | Promise<unknown>;
+    error?: {
+        code: string;
+        status?: number;
+    };
+    onCancel?: () => void;
+    onNavigate?: (path: string) => void;
+};
+export declare function Questions(props: QuestionsProps): import("react").JSX.Element;
+export {};

package/dist/types/ui/blocks/SentAttachments.d.ts

@@ -0,0 +1,11 @@
+import type { Attachment } from "../../core/types";
+import type { BlocksCopy } from "../i18n";
+import type { GetAttachmentUrls } from "./useAttachmentDownload";
+type SentAttachmentsProps = {
+    files: Attachment[];
+    getAttachmentUrls?: GetAttachmentUrls;
+    onDownload: (id: string) => Promise<void>;
+    copy: BlocksCopy["attachments"];
+};
+export declare function SentAttachments({ files, getAttachmentUrls, onDownload, copy }: SentAttachmentsProps): import("react").JSX.Element;
+export {};

package/dist/types/ui/blocks/useAttachmentDownload.d.ts

@@ -0,0 +1,9 @@
+export type GetAttachmentUrls = (id: string) => Promise<{
+    url?: string;
+    originalUrl?: string;
+}>;
+/** Keep navigation inside an invisible frame, with a fresh signed URL per click. */
+export declare function useAttachmentDownload(getUrls?: GetAttachmentUrls): {
+    download: (id: string) => Promise<void>;
+    failed: boolean;
+};

package/dist/types/ui/blocks/useAttachments.d.ts

@@ -0,0 +1,15 @@
+import type { UploadedAttachment } from "../../adapters/bff/client";
+import type { UploadItem } from "../../components/ui/dropzone-clean";
+import type { BlocksPanelProps } from "./BlocksPanel";
+/** Dropzone owns the queue; this hook associates each row with its cancellable upload. */
+export declare function useAttachments(upload: BlocksPanelProps["upload"], uploadFailed: string): {
+    open: boolean;
+    setOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    generation: number;
+    onUpload: (file: File, onProgress: (progress: number) => void) => Promise<void>;
+    onChange: (next: UploadItem[]) => void;
+    reset: () => void;
+    completed: () => UploadedAttachment[];
+    uploading: boolean;
+    failed: boolean;
+};