@itechchoice/prime-chatkit 0.1.0-alpha.0 → 0.1.0-alpha.10

package/dist/types/components/ui/setup-guide-clean.d.ts

@@ -0,0 +1,22 @@
+export type SetupTask = {
+    id: string;
+    label: string;
+    done?: boolean;
+};
+export type SetupGroup = {
+    id: string;
+    title: string;
+    tasks: SetupTask[];
+};
+export type SetupGuideProps = {
+    title?: string;
+    groups: SetupGroup[];
+    /** Shows an "Edit" link in the header */
+    onEdit?: () => void;
+    /** Shows a close button in the header */
+    onClose?: () => void;
+    /** Called with the ids of all finished tasks */
+    onChange?: (done: string[]) => void;
+    className?: string;
+};
+export declare function SetupGuide({ title, groups, onEdit, onClose, onChange, className }: SetupGuideProps): import("react").JSX.Element;

package/dist/types/components/ui/text-field-clean.d.ts

@@ -0,0 +1,28 @@
+import { type ComponentPropsWithRef, type ReactNode } from "react";
+export type TextFieldProps = Omit<ComponentPropsWithRef<"input">, "size" | "prefix"> & {
+    /** Shown above the field and tied to it */
+    label?: ReactNode;
+    /** A quiet line under the field – the error takes its place while there is one */
+    hint?: ReactNode;
+    /** Marks the field invalid and shows this under it, in place of the hint */
+    error?: ReactNode;
+    /** Text or an icon inside the field, before the value – e.g. "https://" or a search icon */
+    prefix?: ReactNode;
+    /** Text or an icon inside the field, after the value – e.g. ".acme.app" or "USD" */
+    suffix?: ReactNode;
+    /** sm 28 · md 32 · lg 36 high */
+    size?: "sm" | "md" | "lg";
+    /** "Optional" next to the label */
+    optional?: boolean;
+    /** A small × that empties the field while it has a value */
+    clearable?: boolean;
+    /** A copy button – for API keys, links and IDs, usually with readOnly */
+    copyable?: boolean;
+    /** Shows "12/40" under the field; needs maxLength */
+    counter?: boolean;
+    /** Called after the × emptied the field (onChange fires too) */
+    onClear?: () => void;
+    /** Extra class on the input itself; className goes on the wrapper */
+    inputClassName?: string;
+};
+export declare function TextField({ label, hint, error, prefix, suffix, size, optional, clearable, copyable, counter, onClear, onKeyDown, className, inputClassName, id, type, value, defaultValue, onChange, disabled, readOnly, maxLength, ref, "aria-describedby": describedBy, ...rest }: TextFieldProps): import("react").JSX.Element;

package/dist/types/components/ui/thinking-loader-clean.d.ts

@@ -0,0 +1,19 @@
+export type ThinkingLoaderProps = {
+    /** Labels to walk through, one after another */
+    phases?: string[];
+    /** Time per phase, in ms */
+    interval?: number;
+    /** Show a specific phase instead of advancing on a timer – e.g. from your stream events */
+    phase?: number;
+    /** Start over after the last phase instead of holding it */
+    loop?: boolean;
+    /** Finished: the spinner turns into a check and the label into doneLabel */
+    done?: boolean;
+    /** Label once done – a string, or a function that gets the seconds since the loader started */
+    doneLabel?: string | ((seconds: number) => string);
+    size?: "sm" | "md";
+    /** "pill" = bordered capsule, "plain" = just the spinner and the label, e.g. inside a chat bubble */
+    variant?: "pill" | "plain";
+    className?: string;
+};
+export declare function ThinkingLoader({ phases: phasesProp, interval: intervalProp, phase, loop, done, doneLabel, size, variant, className, }: ThinkingLoaderProps): import("react").JSX.Element;

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

@@ -1,3 +1,5 @@
 import type { ChatMessage } from "./types";
+/** Only the last assistant segment for each task may remain running or waiting. */
+export declare function settleEarlierSegments(messages: ChatMessage[]): ChatMessage[];
 /** Map a chronological history page without mutating records or consulting the clock. */
 export declare function messagesFromHistory(records: unknown[]): ChatMessage[];

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

@@ -12,6 +12,8 @@ export declare function idGreater(a: string, b: string): boolean;
 export declare function createRun(taskId: string, now?: number): Run;
 /** Text the user should read as the answer right now: the confirmed final text, else the newest turn still writing */
 export declare function answerText(run: Run): string;
+/** The backend joins reasoning sections without separators; restore blank lines before their headings. */
+export declare function reasoningText(text: string): string;
 export type AnswerSource = {
     label: string;
     href?: string;

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

@@ -10,11 +10,13 @@ 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 SPLIT_PANEL_MIN_WIDTH = 480;
+export declare const SPLIT_PANEL_MAX_WIDTH = 720;
 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_DEFAULT_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";

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

@@ -7,6 +7,8 @@ import { type OlderMessages } from "./useFollowLatest";
 import { type GetAttachmentUrls } from "./useAttachmentDownload";
 export type BlocksPanelProps = {
     messages: ChatMessage[];
+    loading?: boolean;
+    title?: string;
     history?: {
         sessions?: ControllerState["sessions"];
         currentId?: string;
@@ -51,6 +53,7 @@ export type BlocksPanelProps = {
     onSend: (text: string, attachments: UploadedAttachment[]) => void;
     onStop?: () => void;
     onNewChat?: () => void;
+    layout?: "split" | "float";
     onToggleLayout?: () => void;
     onClose?: () => void;
     onCreditsClick?: () => void;
@@ -67,4 +70,4 @@ export type BlocksPanelProps = {
     };
     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;
+export declare function BlocksPanel({ messages, loading, title, history, start, availability, provisioning, older, suspension, onAnswerSuspension, onCancelSuspension, error, locale, credits, branding, onSend, onStop, onNewChat, layout, onToggleLayout, onClose, onCreditsClick, onHeaderPointerDown, processView, onRegenerate, onFeedback, onNavigate, upload, attachmentLimits, getAttachmentUrls, className }: BlocksPanelProps): import("react").JSX.Element;

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

@@ -0,0 +1,12 @@
+import type { Run } from "../../core/types";
+import type { BlocksCopy, ThreadCopy } from "../i18n";
+/** The prototype's phase precedence, preferring concise tool names for the live status. */
+export declare function phaseLabel(run: Run, live: BlocksCopy["live"], copy: ThreadCopy, options?: {
+    hideTools?: boolean;
+}): string;
+export declare function LiveStatus({ run, live, copy, hideTools }: {
+    run: Run;
+    live: BlocksCopy["live"];
+    copy: ThreadCopy;
+    hideTools?: boolean;
+}): import("react").JSX.Element | null;

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

@@ -3,10 +3,11 @@ export type OlderMessages = {
     loading: boolean;
     onLoad: () => void;
 };
-/** Layout glue: only follow while the reader remains at the bottom. */
+/** Layout glue: follow at the bottom and resume when the reader sends or explicitly jumps. */
 export declare function useFollowLatest({ messages, older, active }: {
     messages: readonly {
         id: string;
+        role: "user" | "assistant";
     }[];
     older?: OlderMessages;
     active?: boolean;

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

@@ -1,4 +1,6 @@
+import type { ThreadLabels, ThreadLabelsFull } from "../components/agent-thread";
 import type { ChatComposerLabels } from "../components/ui/chat-composer-clean";
+import type { MessageActionsLabels } from "../components/ui/message-actions-clean";
 import type { ToolCallLabels } from "../components/ui/tool-call-card-clean";
 /** Copy used only by the view-model → thread mapping. */
 export type ThreadCopy = {
@@ -12,85 +14,10 @@ export type ThreadCopy = {
 export declare const zhThreadCopy: ThreadCopy;
 export declare const enThreadCopy: ThreadCopy;
 export declare const zhComposerLabels: ChatComposerLabels;
+export declare const zhMessageActionsLabels: MessageActionsLabels;
 export declare const zhToolCallLabels: ToolCallLabels;
-type ThreadLabels = {
-    composer?: Partial<ChatComposerLabels>;
-    toolCall?: Partial<ToolCallLabels>;
-};
-export declare const zhThreadLabels: {
-    composer: {
-        placeholder: string;
-        requestApproval: string;
-        requestApprovalDescription: string;
-        approveForMe: string;
-        approveForMeDescription: string;
-        fullAccess: string;
-        fullAccessDescription: string;
-        add: string;
-        files: string;
-        attachClaude: string;
-        workInFolder: string;
-        chooseFolder: string;
-        goal: string;
-        goalDescription: string;
-        planMode: string;
-        planOnDescription: string;
-        recordSkill: string;
-        draw: string;
-        drawDescription: string;
-        plugins: string;
-        documents: string;
-        documentsDescription: string;
-        pdf: string;
-        pdfDescription: string;
-        noFolder: string;
-        planOff: string;
-        planOn: string;
-        recording: string;
-        recordingAdded: string;
-        recordingDiscarded: string;
-        messageSent: string;
-        composer: string;
-        message: string;
-        voiceInput: string;
-        sendMessage: string;
-        discardRecording: string;
-        useRecording: string;
-        connectApps: string;
-        addToChat: string;
-        planOffDescription: string;
-        approvalQuestion: string;
-        learnMore: string;
-        selectModel: string;
-        apps: string;
-        workingIn: (folder: string) => string;
-        appConnection: (name: string | undefined, connected: boolean) => string;
-        selected: (name: string | undefined) => string;
-        connectedCount: (n: number) => string;
-    };
-    toolCall: {
-        failed: string;
-        error: string;
-        retry: string;
-        arguments: string;
-        result: string;
-        waiting: string;
-        empty: string;
-        showAll: string;
-        showLess: string;
-        copied: string;
-        copyArguments: string;
-        copyResult: string;
-        running: (name: string) => string;
-        finished: (name: string) => string;
-        failedAnnouncement: (name: string, error?: string) => string;
-        duration: (ms: number, live: boolean) => string;
-        usingTools: string;
-        usedTools: (n: number) => string;
-        failedTools: (n: number) => string;
-        groupAnnouncement: (count: string, failed: number) => string;
-    };
-};
+export declare const zhThreadLabels: ThreadLabelsFull;
+export declare const enThreadLabels: Pick<ThreadLabelsFull, "toolsRunning" | "toolsStopped" | "toolsRan" | "toolsFailed">;
 export declare function threadLabelsFor(locale?: string): {
     labels: ThreadLabels;
     copy: ThreadCopy;
@@ -99,13 +26,20 @@ export declare function threadLabelsFor(locale?: string): {
 export type PanelCopy = {
     credits: (balance: number, locale: string) => string;
     history: string;
+    backToChat: string;
+    historyTitle: string;
+    loadingSession: string;
     newChat: string;
     switchLayout: string;
+    layoutFloat: string;
+    layoutSplit: string;
     close: string;
     placeholder: string;
     unavailable: string;
     provisionTitle: string;
     provisionAction: string;
+    startGreeting: string;
+    startBody: string;
 };
 export declare const zhPanelCopy: PanelCopy;
 export declare const enPanelCopy: PanelCopy;
@@ -155,6 +89,14 @@ export declare function historyLabelsFor(locale?: string): Partial<import("../co
 import { type AIAnswerLabels } from "../components/ui/ai-answer-clean";
 import { type DropzoneLabels } from "../components/ui/dropzone-clean";
 export type BlocksCopy = {
+    live: {
+        ready: string;
+        thinking: string;
+        tool: (name: string) => string;
+        writing: string;
+        waiting: string;
+        working: string;
+    };
     attachments: {
         dropzone: DropzoneLabels;
         collapse: string;

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

@@ -30,6 +30,9 @@ export type ThreadDecision = {
 export type ThreadPart = {
     kind: "text";
     text: string;
+} | {
+    kind: "note";
+    text: string;
 } | {
     kind: "tools";
     id: string;

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@itechchoice/prime-chatkit",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.10",
   "description": "PrimeChatKit: React chat UI for products built on the prime-chatkit SDK BFF contract. Shows the agent's work: thinking, tool calls, approvals, sources and cost.",
-  "license": "UNLICENSED",
+  "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "type": "module",
   "module": "./dist/index.js",

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

@@ -1,7 +0,0 @@
-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;