@signalflare-ai/ui 0.5.0

package/dist/src/blocks/agent-harness/agent-harness.d.ts

@@ -0,0 +1,177 @@
+import { ComponentProps, ReactNode } from 'react';
+import { AgentHarnessState, AgentMessage, AgentNotice, AgentOMActivity, AgentQuestion, AgentPlanApproval, AgentSubagent, AgentTaskList, AgentToolCall, AgentUsage, HarnessAdapter, HarnessEvent, UseAgentHarnessReturn, createAgentHarnessState, fromMastraHarness, useAgentHarness } from '../../components/use-agent-harness';
+export declare const SF_AGENT_HARNESS_VARIANTS: {
+    readonly hitlPlacement: {
+        readonly inline: {
+            readonly description: "Render approval/question cards inline in the conversation stream";
+        };
+        readonly "back-layer": {
+            readonly description: "Render approval/question cards in the PromptInput back layer";
+        };
+        readonly both: {
+            readonly description: "Render approval/question cards both inline and in the back layer";
+        };
+    };
+};
+export declare const SF_AGENT_HARNESS_DEFAULT_VARIANTS: {
+    readonly hitlPlacement: "inline";
+};
+export type SFAgentHarnessHitlPlacement = keyof typeof SF_AGENT_HARNESS_VARIANTS.hitlPlacement;
+export interface AgentHarnessProps extends ComponentProps<"div"> {
+    /**
+     * A HarnessAdapter to subscribe to, OR a raw Mastra Harness instance.
+     * Pass `null` to render in "static/demo" mode with no live events.
+     * Ignored when `state` is provided.
+     */
+    adapter?: HarnessAdapter | null;
+    /**
+     * Provide your own `AgentHarnessState` to fully control rendering.
+     * When set, `adapter` is ignored and all action callbacks must be provided.
+     *
+     * Build state from any source — Durable Streams, Zustand, Redux, a Mastra
+     * harness mapped through your own reducer, etc. Use `createAgentHarnessState()`
+     * to create the initial empty state.
+     *
+     * @example
+     * ```tsx
+     * const state = useMastraToAgentState(harness);
+     * <AgentHarness
+     *   state={state}
+     *   onSendMessage={({ content }) => harness.send(content)}
+     *   onApproveToolCall={(d) => harness.approve(d)}
+     * />
+     * ```
+     */
+    state?: AgentHarnessState;
+    /**
+     * Send a user message. Required in controlled mode.
+     */
+    onSendMessage?: (params: {
+        content: string;
+        files?: Array<{
+            url: string;
+            mediaType: string;
+            filename: string;
+        }>;
+    }) => void | Promise<void>;
+    /**
+     * Respond to a pending tool approval. Required in controlled mode when tool approvals are used.
+     */
+    onApproveToolCall?: (decision: "approve" | "decline") => void | Promise<void>;
+    /**
+     * Answer a pending question. Required in controlled mode when questions are used.
+     */
+    onAnswerQuestion?: (questionId: string, answer: string) => void | Promise<void>;
+    /**
+     * Respond to a pending plan approval. Required in controlled mode when plan approvals are used.
+     */
+    onApprovePlan?: (planId: string, response: {
+        action: "approved" | "rejected";
+        feedback?: string;
+    }) => void | Promise<void>;
+    /**
+     * Abort any in-progress generation. Required in controlled mode.
+     */
+    onAbort?: () => void;
+    /**
+     * Placement for interactive HITL elements (approvals, questions, plans).
+     * @default "inline"
+     */
+    hitlPlacement?: SFAgentHarnessHitlPlacement;
+    /**
+     * Show the mode badge in the header (mode name + color dot).
+     * @default true
+     */
+    showMode?: boolean;
+    /**
+     * Show the model badge in the header.
+     * @default true
+     */
+    showModel?: boolean;
+    /**
+     * Show token usage bar above the prompt input.
+     * @default true
+     */
+    showUsage?: boolean;
+    /**
+     * Show the task list in the back layer when tasks are present.
+     * @default true
+     */
+    showTaskList?: boolean;
+    /**
+     * Placeholder text for the prompt input.
+     * @default "Ask anything..."
+     */
+    placeholder?: string;
+    /**
+     * Header slot — rendered at the top of the block (e.g., mode picker, model
+     * dropdown, thread list trigger). When omitted, a minimal default header is
+     * rendered showing the current mode + model.
+     */
+    header?: ReactNode;
+    /**
+     * Footer slot — rendered below the prompt input (e.g., disclaimer text).
+     */
+    footer?: ReactNode;
+    /**
+     * Empty state — rendered when there are no messages.
+     */
+    emptyState?: ReactNode;
+    /**
+     * Override the submit button. Receives the current harness state.
+     */
+    renderSubmit?: (state: AgentHarnessState) => ReactNode;
+    /**
+     * Suggestions to show when the conversation is empty.
+     */
+    suggestions?: string[];
+    /**
+     * Callback when a suggestion is clicked — defaults to sending the suggestion
+     * as a message.
+     */
+    onSuggestionClick?: (suggestion: string) => void;
+    /**
+     * Allow file attachments in the prompt input.
+     * @default false
+     */
+    allowAttachments?: boolean;
+    /**
+     * Allow speech input in the prompt input.
+     * @default false
+     */
+    allowSpeech?: boolean;
+    /**
+     * Available modes for the mode selector in the toolbar.
+     * When provided, a mode selector will be shown in the prompt input toolbar.
+     */
+    availableModes?: {
+        modeId: string;
+        modeName: string;
+    }[];
+}
+/**
+ * `AgentHarness` — a full-chrome agent chat UI block.
+ *
+ * Composes all SignalFlare AI components into a complete, event-driven chat
+ * experience driven by a `HarnessAdapter` (or Mastra Harness instance).
+ *
+ * **State is decoupled** — use `useAgentHarness` directly when you need a
+ * custom layout or headless control.
+ *
+ * @example
+ * ```tsx
+ * import { AgentHarness, fromMastraHarness } from "./components/sf/agent-harness/agent-harness";
+ *
+ * export function App() {
+ *   const adapter = fromMastraHarness(harness);
+ *   return <AgentHarness adapter={adapter} />;
+ * }
+ * ```
+ */
+export declare function AgentHarness({ adapter, state: controlledState, onSendMessage, onApproveToolCall, onAnswerQuestion, onApprovePlan, onAbort, hitlPlacement, showMode, showModel, showUsage, showTaskList, placeholder, header, footer, emptyState, renderSubmit, suggestions, onSuggestionClick, allowAttachments, allowSpeech, availableModes, className, ...props }: AgentHarnessProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace AgentHarness {
+    var displayName: string;
+}
+export { createAgentHarnessState, fromMastraHarness, useAgentHarness };
+export type { AgentHarnessState, AgentMessage, AgentToolCall, AgentSubagent, AgentOMActivity, AgentQuestion, AgentPlanApproval, AgentTaskList, AgentUsage, AgentNotice, HarnessAdapter, HarnessEvent, UseAgentHarnessReturn, };
+//# sourceMappingURL=agent-harness.d.ts.map

package/dist/src/blocks/agent-harness/agent-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-harness.d.ts","sourceRoot":"","sources":["../../../../src/blocks/agent-harness/agent-harness.tsx"],"names":[],"mappings":"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"}