@grafana/assistant 0.1.16 → 0.1.18

package/dist/inline/index.d.ts

@@ -0,0 +1,4 @@
+export { useInlineAssistant } from './useInlineAssistant';
+export type { InlineAssistantOptions, InlineAssistantResult, InlineAssistantState, StreamEvent, MessageStreamStartEvent, MessageContentDeltaEvent, MessageStreamCompleteEvent, } from './types';
+export { setInlineAssistantFactory, setInlineAssistantInitializer, getInlineAssistantFactory, ensureInlineAssistantInitialized, type InlineAssistant, type InlineAssistantFactory, type InlineAssistantInitializer, type InlineAssistantPromptOptions, } from './inlineAssistant';
+//# sourceMappingURL=index.d.ts.map

package/dist/inline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,yBAAyB,EACzB,gCAAgC,EAChC,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,GAClC,MAAM,mBAAmB,CAAC"}

package/dist/inline/inlineAssistant.d.ts

@@ -0,0 +1,40 @@
+import type { InlineToolRunnable } from '../tools/types';
+export interface InlineAssistantPromptOptions {
+    prompt: string;
+    systemPrompt?: string;
+    tools?: InlineToolRunnable[];
+    onStart?: () => void;
+    onDelta?: (delta: string) => void;
+    onComplete?: (text: string) => void;
+    onError?: (error: Error) => void;
+}
+export interface InlineAssistant {
+    sendPrompt(options: InlineAssistantPromptOptions): Promise<void>;
+    cancel(): void;
+    dispose(): void;
+}
+declare global {
+    interface Window {
+        [key: string]: any;
+    }
+}
+export type InlineAssistantFactory = (origin: string) => Promise<InlineAssistant>;
+export type InlineAssistantInitializer = () => Promise<void>;
+export declare function setInlineAssistantFactory(fn: InlineAssistantFactory): void;
+/**
+ * Register a lazy initializer that will be called on first use.
+ * The plugin code should register this to enable lazy loading of the inline assistant.
+ *
+ * This uses global storage (window) so that all plugins share the same initializer,
+ * regardless of which plugin instance or package version loads first.
+ */
+export declare function setInlineAssistantInitializer(fn: InlineAssistantInitializer): void;
+/**
+ * Ensure the inline assistant is initialized. If an initializer is registered,
+ * it will be called on first use. Otherwise, checks if factory is already registered.
+ *
+ * Uses global storage (window) so that initialization is shared across all plugins.
+ */
+export declare function ensureInlineAssistantInitialized(): Promise<void>;
+export declare function getInlineAssistantFactory(): InlineAssistantFactory;
+//# sourceMappingURL=inlineAssistant.d.ts.map

package/dist/inline/inlineAssistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineAssistant.d.ts","sourceRoot":"","sources":["../../src/inline/inlineAssistant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;CACjB;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB;CACF;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAClF,MAAM,MAAM,0BAA0B,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAO7D,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,sBAAsB,GAAG,IAAI,CAS1E;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,0BAA0B,GAAG,IAAI,CASlF;AAED;;;;;GAKG;AACH,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAkCtE;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CAMlE"}

package/dist/inline/types.d.ts

@@ -0,0 +1,84 @@
+import type { InlineToolRunnable } from '../tools/types';
+/**
+ * Options for inline assistant generation
+ */
+export interface InlineAssistantOptions {
+    /** The prompt to send to the assistant */
+    prompt: string;
+    /** Origin of the request for analytics tracking (e.g., 'grafana/panel-editor/title', 'grafana-slo-app/slo-form/description') */
+    origin: string;
+    /** Optional system prompt to guide the assistant's behavior */
+    systemPrompt?: string;
+    /** Optional array of tools to make available to the assistant for this generation */
+    tools?: InlineToolRunnable[];
+    /** Callback invoked when generation completes successfully */
+    onComplete?: (text: string) => void;
+    /** Callback invoked if an error occurs during generation */
+    onError?: (error: Error) => void;
+    /** Callback invoked when streaming tokens are received */
+    onDelta?: (delta: string) => void;
+}
+/**
+ * State for the inline assistant hook
+ */
+export interface InlineAssistantState {
+    /** Whether generation is currently in progress */
+    isGenerating: boolean;
+    /** Accumulated content from streaming */
+    content: string;
+    /** Error that occurred during generation, if any */
+    error: Error | null;
+}
+/**
+ * Return type of the useInlineAssistant hook
+ */
+export interface InlineAssistantResult {
+    /** Start generating content with the given options */
+    generate: (options: InlineAssistantOptions) => Promise<void>;
+    /** Whether generation is currently in progress */
+    isGenerating: boolean;
+    /** Accumulated streaming content (updates in real-time) */
+    content: string;
+    /** Error that occurred during generation, if any */
+    error: Error | null;
+    /** Cancel the current generation */
+    cancel: () => void;
+    /** Clear error and content state */
+    reset: () => void;
+}
+/**
+ * Streaming event types from the backend
+ */
+export interface MessageStreamStartEvent {
+    type: 'message.stream.start';
+    payload: {
+        messageId: string;
+        chatId: string;
+        role: string;
+    };
+}
+export interface MessageContentDeltaEvent {
+    type: 'message.content.delta';
+    payload: {
+        messageId: string;
+        chatId: string;
+        contentIndex: number;
+        contentType: string;
+        delta?: string;
+        toolUse?: unknown;
+    };
+}
+export interface MessageStreamCompleteEvent {
+    type: 'message.stream.complete';
+    payload: {
+        messageId: string;
+        chatId: string;
+        stopReason: string;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+        };
+    };
+}
+export type StreamEvent = MessageStreamStartEvent | MessageContentDeltaEvent | MessageStreamCompleteEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/inline/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/inline/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,gIAAgI;IAChI,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,QAAQ,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,oCAAoC;IACpC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,oCAAoC;IACpC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE;YACL,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GAAG,uBAAuB,GAAG,wBAAwB,GAAG,0BAA0B,CAAC"}

package/dist/inline/useInlineAssistant.d.ts

@@ -0,0 +1,65 @@
+import { InlineAssistantResult } from './types';
+/**
+ * React hook for inline assistant generation with streaming support.
+ *
+ * This hook enables generating content (like panel titles or descriptions) inline
+ * without opening the assistant sidebar. Each hook instance creates its own chat
+ * conversation, so all generations from the same instance are grouped together.
+ * Generated content is ephemeral - it won't appear in the user's chat history
+ * but will be tracked in the admin UI for analytics.
+ *
+ * Uses the full BaseMultiStepAgent infrastructure for tool execution and multi-step workflows.
+ *
+ * The implementation is lazy-loaded on first use to reduce initial bundle size.
+ *
+ * @example
+ * ```typescript
+ * function PanelEditor() {
+ *   const { generate, isGenerating, content, error, reset } = useInlineAssistant();
+ *   const [title, setTitle] = useState('');
+ *
+ *   const handleGenerate = () => {
+ *     generate({
+ *       prompt: 'Generate a panel title for CPU metrics',
+ *       origin: 'grafana/panel-editor/title',
+ *       systemPrompt: 'Generate only the title text, no explanation',
+ *       onComplete: (text) => setTitle(text.trim()),
+ *       onError: (err) => console.error(err)
+ *     });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input value={title} onChange={(e) => setTitle(e.target.value)} />
+ *       <button onClick={handleGenerate} disabled={isGenerating}>
+ *         {isGenerating ? 'Generating...' : 'Generate with Assistant'}
+ *       </button>
+ *       {isGenerating && <div>{content}</div>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using tools with inline assistant
+ * import { lokiQueryHandlerTool } from 'agent/tools';
+ *
+ * function ComponentWithTools() {
+ *   const { generate } = useInlineAssistant();
+ *
+ *   const handleGenerate = async () => {
+ *     await generate({
+ *       prompt: 'Query Loki for error logs from the last hour',
+ *       origin: 'my-app/component',
+ *       tools: [lokiQueryHandlerTool],
+ *       onComplete: (text) => console.log('Generated:', text),
+ *     });
+ *   };
+ *
+ *   return <button onClick={handleGenerate}>Generate</button>;
+ * }
+ * ```
+ */
+export declare function useInlineAssistant(): InlineAssistantResult;
+//# sourceMappingURL=useInlineAssistant.d.ts.map

package/dist/inline/useInlineAssistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInlineAssistant.d.ts","sourceRoot":"","sources":["../../src/inline/useInlineAssistant.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,CA6F1D"}

package/dist/investigations.d.ts

@@ -0,0 +1,41 @@
+import { BusEventWithPayload } from '@grafana/data';
+/**
+ * Payload for the InvestigationCreatedEvent
+ */
+export interface InvestigationCreatedPayload {
+    /** The ID of the newly created investigation */
+    investigationId: string;
+}
+/**
+ * Event emitted when an investigation is created.
+ * External integrations can subscribe to this event to react to new investigations.
+ */
+export declare class InvestigationCreatedEvent extends BusEventWithPayload<InvestigationCreatedPayload> {
+    static type: string;
+}
+/**
+ * Emit an InvestigationCreatedEvent to notify subscribers that a new investigation was created.
+ *
+ * @param investigationId - The ID of the newly created investigation
+ */
+export declare function emitInvestigationCreated(investigationId: string): void;
+/**
+ * Subscribe to investigation created events.
+ *
+ * @param callback - Function to call when an investigation is created
+ * @returns Unsubscribe function to stop listening for events
+ *
+ * @example
+ * ```typescript
+ * import { onInvestigationCreated } from '@grafana/assistant';
+ *
+ * const unsubscribe = onInvestigationCreated((payload) => {
+ *   console.log('Investigation created:', payload.investigationId);
+ * });
+ *
+ * // Later, when you want to stop listening
+ * unsubscribe();
+ * ```
+ */
+export declare function onInvestigationCreated(callback: (payload: InvestigationCreatedPayload) => void): () => void;
+//# sourceMappingURL=investigations.d.ts.map

package/dist/investigations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"investigations.d.ts","sourceRoot":"","sources":["../src/investigations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,mBAAmB,CAAC,2BAA2B,CAAC;IAC7F,MAAM,CAAC,IAAI,SAA6C;CACzD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAGtE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,IAAI,GAAG,MAAM,IAAI,CAM3G"}

package/dist/limits/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Event name dispatched when limits are updated via SSE.
+ * Other components can listen to this event to get real-time updates.
+ */
+export declare const LIMITS_UPDATED_EVENT = "grafana-assistant-limits-updated";
+/**
+ * Detail payload for the LIMITS_UPDATED_EVENT custom event.
+ */
+export interface LimitsUpdatedEventDetail {
+    count: number;
+    limit: number;
+}
+/**
+ * Result type for limits data.
+ */
+export interface LimitsData {
+    /** Current prompt count for the month */
+    count: number;
+    /** Monthly prompt limit (0 = unlimited) */
+    limit: number;
+    /** Current month in YYYY-MM format */
+    month: string;
+    /** Whether the limit has been reached */
+    isLimitReached: boolean;
+}
+/**
+ * Checks whether the user has reached their monthly prompt limit.
+ *
+ * @returns A promise that resolves to `true` if limits are reached, `false` otherwise
+ * @throws Error if the API call fails
+ *
+ * @example
+ * ```typescript
+ * import { checkLimits } from '@grafana/assistant';
+ *
+ * const data = await checkLimits();
+ * if (data.isLimitReached) {
+ *   console.log('Monthly limit reached');
+ * }
+ * ```
+ */
+export declare function checkLimits(): Promise<LimitsData>;
+/**
+ * React hook to check user prompt limits.
+ * Automatically fetches limits data on mount and listens to real-time updates
+ * via the LIMITS_UPDATED_EVENT custom event.
+ *
+ * @returns An object containing limit data, loading state, error state, and refetch function
+ *
+ * @example
+ * ```typescript
+ * import { useLimits } from '@grafana/assistant';
+ *
+ * function MyComponent() {
+ *   const { count, limit, isLimitReached, loading, error, refetch } = useLimits();
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error}</div>;
+ *   if (isLimitReached) return <div>Monthly limit reached ({count}/{limit})</div>;
+ *   return <div>Prompts used: {count}/{limit || 'unlimited'}</div>;
+ * }
+ * ```
+ */
+export declare function useLimits(): {
+    count: number;
+    limit: number;
+    month: string;
+    isLimitReached: boolean;
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/limits/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/limits/index.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,qCAAqC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,cAAc,EAAE,OAAO,CAAC;CACzB;AAkCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC,CAMvD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS;;;;;;;;EA8DxB"}

package/dist/plugin.d.ts

@@ -0,0 +1,9 @@
+import { Observable } from 'rxjs';
+export declare const ASSISTANT_PLUGIN_ID = "grafana-assistant-app";
+export declare const ASSISTANT_PLUGIN_TITLE = "Grafana Assistant";
+/**
+ * Check if the assistant is available.
+ * @returns An observable that emits true if the assistant is available, false otherwise.
+ */
+export declare function isAssistantAvailable(): Observable<boolean>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,UAAU,EAAgC,MAAM,MAAM,CAAC;AAExF,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAC3D,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAM1D;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAAC,OAAO,CAAC,CA+C1D"}

package/dist/sidebar.d.ts

@@ -0,0 +1,26 @@
+import { ChatContextItem } from './context/types';
+export type OpenAssistantProps = {
+    origin: string;
+    prompt?: string;
+    context?: ChatContextItem[];
+    autoSend?: boolean;
+    /** Mode to open the assistant in. Built-in modes: 'assistant', 'investigation', 'dashboarding'. Can also be a backend agent ID. */
+    mode?: string;
+};
+/**
+ * Open the Grafana Assistant sidebar with a given initial prompt.
+ *
+ * @param props - The props to pass to the assistant.
+ * @param props.origin - The origin of the request that opened the assistant. This is used to track the source of the request. Should be a structured string using forward slashes, with the first part as a namespace. Examples: 'grafana-datasources/prometheus/query-builder', 'grafana-slo-app/slo-editor-overview', 'grafana/trace-view-analyzer`.
+ * @param props.prompt - The initial prompt to display in the assistant.
+ * @param props.context - The initial context to display in the assistant. Created with `createContext`.
+ * @param props.autoSend - Whether to automatically send the initial prompt. When true, opens a chat and sends the initial prompt right away. When false, opens chat and updates user message without sending it. Defaults to true.
+ * @param props.mode - The mode to open the assistant in. Built-in modes: 'assistant', 'investigation', 'dashboarding'. Can also be a backend agent ID. Defaults to 'assistant'.
+ */
+export declare function openAssistant(props: OpenAssistantProps): void;
+/**
+ * Close the Grafana Assistant sidebar.
+ */
+export declare function closeAssistant(): void;
+export declare function toggleAssistant(props: OpenAssistantProps): void;
+//# sourceMappingURL=sidebar.d.ts.map

package/dist/sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../src/sidebar.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AA4ClD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mIAAmI;IACnI,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,QAatD;AAED;;GAEG;AACH,wBAAgB,cAAc,SAE7B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,QAaxD"}

package/dist/terms/index.d.ts

@@ -0,0 +1,60 @@
+import type { components } from './settings.gen';
+/**
+ * The type of terms that apply to a tenant.
+ * - 'msa': Master Service Agreement - only requires acceptance, no version checking
+ * - 'termsAndConditions': Full terms and conditions - requires acceptance AND version checking
+ */
+export type TermsType = components['schemas']['TermsAndConditionsResponse']['termsType'];
+/**
+ * Event name that is dispatched when terms and conditions are accepted.
+ * Other components can listen to this event to refresh their UI.
+ */
+export declare const TERMS_AND_CONDITIONS_REFRESH_EVENT = "grafana-assistant-terms-and-conditions-refresh";
+/**
+ * Checks whether terms and conditions are accepted and up-to-date.
+ * This function verifies that:
+ * 1. Terms have been accepted
+ * 2. The accepted version matches or exceeds the current version
+ *
+ * @returns A promise that resolves to `true` if terms are accepted and up-to-date, `false` otherwise
+ * @throws Error if the API call fails
+ *
+ * @example
+ * ```typescript
+ * import { checkTerms } from '@grafana/assistant';
+ *
+ * const accepted = await checkTerms();
+ * if (!accepted) {
+ *   // Show terms acceptance UI
+ *   console.log('Terms need to be accepted');
+ * }
+ * ```
+ */
+export declare function checkTerms(): Promise<boolean>;
+/**
+ * React hook to check terms and conditions acceptance status.
+ * Automatically fetches terms data on mount and re-fetches when terms change
+ * (via TERMS_AND_CONDITIONS_REFRESH_EVENT).
+ *
+ * @returns An object containing whether terms are accepted, the terms type, loading state, and error state
+ *
+ * @example
+ * ```typescript
+ * import { useTerms } from '@grafana/assistant';
+ *
+ * function MyComponent() {
+ *   const { accepted, termsType, loading, error } = useTerms();
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error}</div>;
+ *   return <div>Terms accepted</div>;
+ * }
+ * ```
+ */
+export declare function useTerms(): {
+    accepted: boolean;
+    termsType: "msa" | "termsAndConditions" | null;
+    loading: boolean;
+    error: string | null;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/terms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/terms/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,4BAA4B,CAAC,CAAC,WAAW,CAAC,CAAC;AAUzF;;;GAGG;AACH,eAAO,MAAM,kCAAkC,mDAAmD,CAAC;AA2CnG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAQnD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ;;;;;EA0CvB"}