@webless/agent 0.6.3 → 0.6.4

package/dist/manifest-Cad-TQJw.d.cts

@@ -0,0 +1,391 @@
+import * as react from 'react';
+
+declare const AGENT_TOOL_UI_SCHEMA_VERSION: "webless.tool-ui.v1";
+type AgentToolUiFieldKind = "text" | "textarea" | "email" | "number" | "select" | "multi-select" | "checkbox" | "confirmation" | "radio" | "date" | "time" | "date-time" | "calendar" | "range" | "json";
+type AgentToolUiOption = {
+    label: string;
+    value: AgentToolResultJsonValue;
+};
+type AgentToolUiField = {
+    description?: string;
+    kind: AgentToolUiFieldKind;
+    label: string;
+    max?: number;
+    maxItems?: number;
+    maxLength?: number;
+    min?: number;
+    minLength?: number;
+    options?: readonly AgentToolUiOption[];
+    path: string;
+    placeholder?: string;
+    required?: boolean;
+    step?: number;
+    defaultValue?: AgentToolResultJsonValue;
+};
+type AgentToolUiStep = {
+    description?: string;
+    fieldPaths: readonly string[];
+    id: string;
+    label: string;
+};
+type AgentToolUiAction = {
+    id: "submit" | "back" | "next" | "reset";
+    label: string;
+};
+type AgentToolUiSurface = {
+    actions?: readonly AgentToolUiAction[];
+    description?: string;
+    fields: readonly AgentToolUiField[];
+    id: string;
+    operationId?: string;
+    requestId?: string;
+    schemaVersion: typeof AGENT_TOOL_UI_SCHEMA_VERSION;
+    steps?: readonly AgentToolUiStep[];
+    submitLabel?: string;
+    title: string;
+    toolSlug: string;
+    values?: Readonly<Record<string, AgentToolResultJsonValue>>;
+};
+
+type AgentToolResultJsonValue = null | boolean | number | string | AgentToolResultJsonValue[] | {
+    [key: string]: AgentToolResultJsonValue;
+};
+type AgentToolResultEnvelope = {
+    schemaVersion: "webless.tool-result.v1";
+    output: AgentToolResultJsonValue;
+    presentationKinds: string[];
+    ui?: AgentToolUiSurface;
+};
+
+type AgentIndexVersion = "published" | "unpublished";
+type AgentInputOption = {
+    id: string;
+    label: string;
+    description?: string;
+    style?: "default" | "primary" | "danger";
+};
+type AgentInputRequest = {
+    requestId: string;
+    kind: "question" | "session-limit" | "tool-approval";
+    prompt: string;
+    display?: "confirmation" | "select" | "text";
+    allowFreeform?: boolean;
+    options?: readonly AgentInputOption[];
+    ui?: AgentToolUiSurface;
+    action: {
+        callId: string;
+        kind: "tool-call";
+        toolName: string;
+    };
+};
+type AgentInputResponse = {
+    requestId: string;
+    optionId?: string;
+    text?: string;
+    value?: AgentToolResultJsonValue;
+};
+type AgentToolResult = {
+    callId: string;
+    toolName: string;
+    status: "completed" | "failed" | "rejected";
+    output?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+
+type ComposerFormFieldKind = "text" | "email" | "tel" | "textarea";
+type ComposerFormField = {
+    id: string;
+    kind: ComposerFormFieldKind;
+    label: string;
+    placeholder: string;
+    required: boolean;
+    autocomplete?: string;
+};
+type VisitorFormCard = {
+    type: "visitor_form";
+    fields: ComposerFormField[];
+};
+
+type VisitorBooking = {
+    eventUri: string;
+    inviteeUri?: string;
+    inviteeEmail?: string;
+    startTime?: string;
+};
+type BookingOfferEventType = {
+    name: string;
+    uri: string;
+    duration?: number;
+    locationKind?: string;
+    location?: string;
+};
+type BookingOfferSlot = {
+    startTime: string;
+    eventTypeUri?: string;
+};
+type BookingOffer = {
+    type: "booking_offer";
+    eventTypes: BookingOfferEventType[];
+    slots: BookingOfferSlot[];
+};
+type BookingConfirmed = VisitorBooking & {
+    type: "booking_confirmed";
+};
+type BookingCanceled = {
+    type: "booking_canceled";
+    eventUri: string;
+};
+type ToolCard = BookingOffer | BookingConfirmed | BookingCanceled | VisitorFormCard;
+
+type VisitorToolResultLink = {
+    label: string;
+    href: string;
+};
+type VisitorToolResultDetail = {
+    label: string;
+    value: string;
+};
+type VisitorToolResultPresentation = {
+    id: string;
+    toolName: string;
+    status: AgentToolResult["status"];
+    kind: "summary";
+    title: string;
+    description?: string;
+    details?: readonly VisitorToolResultDetail[];
+    links?: readonly VisitorToolResultLink[];
+};
+type VisitorEntityResultPresentation = {
+    id: string;
+    toolName: string;
+    status: AgentToolResult["status"];
+    kind: "entity";
+    title: string;
+    description?: string;
+    details?: readonly VisitorToolResultDetail[];
+    links?: readonly VisitorToolResultLink[];
+};
+type VisitorCollectionItemPresentation = {
+    title: string;
+    description?: string;
+    details?: readonly VisitorToolResultDetail[];
+    href?: string;
+};
+type VisitorCollectionResultPresentation = {
+    id: string;
+    toolName: string;
+    status: AgentToolResult["status"];
+    kind: "collection";
+    title: string;
+    items: readonly VisitorCollectionItemPresentation[];
+};
+type VisitorSignatureResultPresentation = {
+    id: string;
+    toolName: string;
+    status: AgentToolResult["status"];
+    kind: "signature";
+    title: string;
+    description?: string;
+    statusLabel?: string;
+    links?: readonly VisitorToolResultLink[];
+};
+type VisitorBookingResultPresentation = {
+    id: string;
+    toolName: string;
+    status: AgentToolResult["status"];
+    kind: "booking";
+    card: ToolCard;
+};
+type VisitorToolInputResultPresentation = {
+    id: string;
+    toolName: string;
+    status: AgentToolResult["status"];
+    kind: "input";
+    surface: AgentToolUiSurface;
+};
+type VisitorHiddenToolResultPresentation = {
+    id: string;
+    toolName: string;
+    status: AgentToolResult["status"];
+    kind: "hidden";
+};
+type ResolvedVisitorToolResultPresentation = VisitorToolResultPresentation | VisitorEntityResultPresentation | VisitorCollectionResultPresentation | VisitorSignatureResultPresentation | VisitorBookingResultPresentation | VisitorToolInputResultPresentation | VisitorHiddenToolResultPresentation;
+type VisitorToolResultPresenterOutput = Omit<VisitorToolResultPresentation, "id" | "toolName" | "status"> | Omit<VisitorEntityResultPresentation, "id" | "toolName" | "status"> | Omit<VisitorCollectionResultPresentation, "id" | "toolName" | "status"> | Omit<VisitorSignatureResultPresentation, "id" | "toolName" | "status"> | {
+    kind: "booking";
+    card: ToolCard;
+};
+type VisitorToolResultPresenter = {
+    kind: string;
+    present: (input: {
+        envelope: AgentToolResultEnvelope;
+        presentationKind: string;
+        result: AgentToolResult;
+    }) => VisitorToolResultPresenterOutput | null;
+};
+type VisitorToolResultRegistry = readonly VisitorToolResultPresenter[];
+declare const builtInVisitorToolResultRegistry: VisitorToolResultRegistry;
+declare function presentVisitorToolResult(result: AgentToolResult, registry?: VisitorToolResultRegistry): ResolvedVisitorToolResultPresentation;
+
+type ToolStepState = "completed" | "active" | "pending" | "error";
+type ToolStep = {
+    id: string;
+    kind: "planning" | "search" | "specialist";
+    label: string;
+    state: ToolStepState;
+    detail?: string;
+};
+type Citation = {
+    id: string;
+    label: string;
+    url: string;
+};
+type FollowUpSuggestion = {
+    id: string;
+    label: string;
+};
+type JourneyContext = {
+    id: string;
+    name: string;
+    currentStep?: number;
+    totalSteps?: number;
+    stepLabel?: string;
+};
+type ConversationMessage = {
+    id: string;
+    role: "visitor";
+    text: string;
+    createdAt: number;
+    runtimeText?: string;
+} | {
+    id: string;
+    role: "agent";
+    text: string;
+    createdAt: number;
+    citations?: Citation[];
+    toolReceipts?: string[];
+    streaming?: boolean;
+};
+type AgentRailPhase = "idle" | "thinking" | "running-tools" | "waiting-input" | "streaming" | "error" | "complete";
+type AgentRailState = {
+    phase: AgentRailPhase;
+    messages: ConversationMessage[];
+    toolSteps: ToolStep[];
+    journey: JourneyContext | null;
+    followUps: FollowUpSuggestion[];
+    streamingText: string;
+    pendingOffer: BookingOffer | null;
+    pendingInputs?: AgentInputRequest[];
+    toolResults?: (VisitorToolResultPresentation | VisitorEntityResultPresentation | VisitorCollectionResultPresentation | VisitorSignatureResultPresentation | VisitorToolInputResultPresentation)[];
+    error: string | null;
+};
+type AgentRailTheme = {
+    railMaxWidth: string;
+    brand: string;
+    brandSoft: string;
+    brandDeep: string;
+    surface: string;
+    surfaceMuted: string;
+    text: string;
+    textMuted: string;
+    textSubtle: string;
+    border: string;
+    visitorBubble: string;
+    visitorText: string;
+    success: string;
+    danger: string;
+    fontBody: string;
+    fontDisplay: string;
+};
+type AgentColorScheme = "auto" | "light" | "dark";
+declare const defaultAgentRailTheme: AgentRailTheme;
+declare const defaultDarkAgentRailTheme: AgentRailTheme;
+
+type AssistTabVariant = "outline" | "ask" | "fill";
+type AssistTabSide = "right" | "left" | "top" | "bottom";
+declare function AssistEdgeTab({ variant, side, along, inset, visible, label, customIconUrl, logoUrl, brandColor, brandForeground, borderColor, fontFamily, mobile, surfaceColor, textColor, colorScheme, onOpen, }: {
+    variant: AssistTabVariant;
+    side: AssistTabSide;
+    along: number;
+    inset: number;
+    visible: boolean;
+    label?: string;
+    customIconUrl?: string;
+    logoUrl?: string;
+    brandColor?: string;
+    brandForeground?: string;
+    borderColor?: string;
+    fontFamily?: string;
+    mobile?: boolean;
+    surfaceColor?: string;
+    textColor?: string;
+    colorScheme?: AgentColorScheme;
+    onOpen: () => void;
+}): react.JSX.Element;
+
+type AgentPlacementConfig = {
+    side: AssistTabSide;
+    along: number;
+    inset: number;
+    variant: AssistTabVariant;
+};
+declare const DEFAULT_AGENT_PLACEMENT: AgentPlacementConfig;
+declare function normalizeAgentPlacement(placement?: Partial<AgentPlacementConfig>): AgentPlacementConfig;
+
+type AgentMountStrategy = "body" | "selector" | "script-parent";
+type AgentTabVariant = AgentPlacementConfig["variant"];
+type AgentTabSide = AgentPlacementConfig["side"];
+type AgentBrandingConfig = {
+    agentName?: string;
+    tabLabel?: string;
+    tabIconUrl?: string;
+    logoUrl?: string;
+    greeting?: string;
+    composerPlaceholder?: string;
+    poweredByLabel?: string;
+    fontFamily?: string;
+    colors?: {
+        primary?: string;
+        primarySoft?: string;
+        primaryForeground?: string;
+        surface?: string;
+        surfaceMuted?: string;
+        text?: string;
+        textMuted?: string;
+        border?: string;
+    };
+};
+type AgentTagManifest = {
+    customerId: string;
+    indexId: string;
+    runtimeOrigin?: string;
+    version?: AgentIndexVersion;
+    mount?: {
+        selector?: string;
+        strategy?: AgentMountStrategy;
+    };
+    placement?: Partial<AgentPlacementConfig>;
+    pageShift?: boolean;
+    colorScheme?: AgentColorScheme;
+    branding?: AgentBrandingConfig;
+};
+
+declare function normalizeAgentTagManifest(manifest: AgentTagManifest): {
+    branding?: AgentBrandingConfig | undefined;
+    customerId: string;
+    indexId: string;
+    runtimeOrigin: string;
+    version: AgentIndexVersion;
+    mount: {
+        selector: string | undefined;
+        strategy: AgentMountStrategy;
+    };
+    placement: AgentPlacementConfig;
+    pageShift: boolean;
+    colorScheme: AgentColorScheme;
+};
+type NormalizedAgentTagManifest = ReturnType<typeof normalizeAgentTagManifest>;
+
+export { type AgentBrandingConfig as A, type VisitorBookingResultPresentation as B, type Citation as C, DEFAULT_AGENT_PLACEMENT as D, type VisitorToolInputResultPresentation as E, type FollowUpSuggestion as F, type VisitorToolResultLink as G, type VisitorToolResultPresentation as H, type VisitorToolResultPresenter as I, type JourneyContext as J, type VisitorToolResultPresenterOutput as K, type VisitorToolResultRegistry as L, builtInVisitorToolResultRegistry as M, type NormalizedAgentTagManifest as N, defaultAgentRailTheme as O, defaultDarkAgentRailTheme as P, normalizeAgentPlacement as Q, type ResolvedVisitorToolResultPresentation as R, normalizeAgentTagManifest as S, type ToolStep as T, presentVisitorToolResult as U, type VisitorBooking as V, type AgentColorScheme as a, type AgentIndexVersion as b, type AgentInputOption as c, type AgentInputRequest as d, type AgentInputResponse as e, type AgentMountStrategy as f, type AgentPlacementConfig as g, type AgentRailPhase as h, type AgentRailState as i, type AgentRailTheme as j, type AgentTabSide as k, type AgentTabVariant as l, type AgentTagManifest as m, type AgentToolResult as n, type AgentToolResultJsonValue as o, type AgentToolUiAction as p, type AgentToolUiField as q, type AgentToolUiFieldKind as r, type AgentToolUiOption as s, type AgentToolUiStep as t, type AgentToolUiSurface as u, AssistEdgeTab as v, type AssistTabSide as w, type AssistTabVariant as x, type ConversationMessage as y, type ToolStepState as z };