@genesislcap/ai-assistant 14.403.0-ai-assistant.1

package/src/styles/styles.ts

@@ -0,0 +1,238 @@
+import { css } from '@genesislcap/web-core';
+
+/**
+ * @beta
+ */
+export const FoundationAiAssistantStyles = css`
+  :host {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    box-sizing: border-box;
+  }
+
+  .chat-wrapper {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    overflow: hidden;
+    background: var(--neutral-fill-layer-rest, var(--neutral-layer-1));
+    border-radius: calc(var(--design-unit, 4) * 1px);
+    border: 1px solid var(--neutral-stroke-rest);
+  }
+
+  .chat-header {
+    display: flex;
+    align-items: center;
+    gap: calc(var(--design-unit, 4) * 3px);
+    padding: calc(var(--design-unit, 4) * 1.5px) calc(var(--design-unit, 4) * 3px);
+    border-bottom: 1px solid var(--neutral-stroke-rest);
+    background: var(--neutral-fill-stealth-rest);
+    font-size: var(--type-ramp-minus-1-font-size);
+    color: var(--neutral-foreground-rest);
+  }
+
+  .chat-title {
+    flex: 1;
+    font-weight: 600;
+    font-size: var(--type-ramp-base-font-size);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .toggle-label {
+    display: flex;
+    align-items: center;
+    gap: calc(var(--design-unit, 4) * 1px);
+    cursor: pointer;
+    user-select: none;
+  }
+
+  .toggle-label input[type='checkbox'] {
+    cursor: pointer;
+    accent-color: var(--accent-fill-rest);
+  }
+
+  .download-button {
+    margin-left: auto;
+  }
+
+  .messages {
+    flex: 1;
+    overflow-y: auto;
+    padding: calc(var(--design-unit, 4) * 3px);
+    display: flex;
+    flex-direction: column;
+    gap: calc(var(--design-unit, 4) * 2px);
+  }
+
+  .message {
+    padding: calc(var(--design-unit, 4) * 2px) calc(var(--design-unit, 4) * 3px);
+    border-radius: calc(var(--design-unit, 4) * 2px);
+    max-width: 80%;
+    word-break: break-word;
+    font-size: var(--type-ramp-base-font-size);
+    line-height: var(--type-ramp-base-line-height);
+  }
+
+  .message--user {
+    align-self: flex-end;
+    background: var(--accent-fill-rest);
+    color: var(--foreground-on-accent-rest);
+    border-bottom-right-radius: calc(var(--design-unit, 4) * 0.5px);
+  }
+
+  .message--assistant {
+    align-self: flex-start;
+    background: var(--neutral-fill-rest);
+    color: var(--neutral-foreground-rest);
+    border-bottom-left-radius: calc(var(--design-unit, 4) * 0.5px);
+  }
+
+  .thinking-block {
+    margin-bottom: calc(var(--design-unit, 4) * 1px);
+    border: 1px solid var(--neutral-stroke-rest);
+    border-radius: calc(var(--design-unit, 4) * 1px);
+    overflow: hidden;
+  }
+
+  .thinking-summary {
+    cursor: pointer;
+    padding: calc(var(--design-unit, 4) * 1px) calc(var(--design-unit, 4) * 2px);
+    font-size: var(--type-ramp-minus-1-font-size);
+    color: var(--neutral-foreground-hint);
+    user-select: none;
+    list-style: none;
+  }
+
+  .thinking-summary::marker,
+  .thinking-summary::-webkit-details-marker {
+    display: none;
+  }
+
+  .thinking-summary::before {
+    content: '▶ ';
+    font-size: 0.6em;
+    vertical-align: middle;
+  }
+
+  details[open] .thinking-summary::before {
+    content: '▼ ';
+  }
+
+  .thinking-content {
+    padding: calc(var(--design-unit, 4) * 2px);
+    font-size: var(--type-ramp-minus-1-font-size);
+    color: var(--neutral-foreground-hint);
+    border-top: 1px solid var(--neutral-stroke-rest);
+  }
+
+  .tool-calls {
+    font-size: var(--type-ramp-minus-1-font-size);
+    color: var(--neutral-foreground-hint);
+    font-family: monospace;
+  }
+
+  .message--tool {
+    align-self: flex-start;
+    background: var(--neutral-fill-stealth-rest);
+    color: var(--neutral-foreground-hint);
+    font-size: var(--type-ramp-minus-1-font-size);
+    font-family: monospace;
+    max-width: 100%;
+    border-radius: calc(var(--design-unit, 4) * 1px);
+  }
+
+  .empty-state {
+    flex: 1;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: var(--neutral-foreground-hint);
+    font-size: var(--type-ramp-base-font-size);
+  }
+
+  .thinking {
+    align-self: flex-start;
+    padding: calc(var(--design-unit, 4) * 1px);
+  }
+
+  .file-input {
+    display: none;
+  }
+
+  .attachment-chips {
+    display: flex;
+    flex-wrap: wrap;
+    gap: calc(var(--design-unit, 4) * 1px);
+    padding: calc(var(--design-unit, 4) * 1px) calc(var(--design-unit, 4) * 2px);
+    border-top: 1px solid var(--neutral-stroke-rest);
+  }
+
+  .attachment-chip {
+    display: inline-flex;
+    align-items: center;
+    gap: calc(var(--design-unit, 4) * 1px);
+    padding: calc(var(--design-unit, 4) * 0.5px) calc(var(--design-unit, 4) * 1.5px);
+    background: var(--neutral-fill-rest);
+    border: 1px solid var(--neutral-stroke-rest);
+    border-radius: calc(var(--design-unit, 4) * 4px);
+    font-size: var(--type-ramp-minus-1-font-size);
+    color: var(--neutral-foreground-rest);
+    max-width: 200px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .attachment-chip-error {
+    background: var(--error-fill-rest, #fde8e8);
+    border-color: var(--error-stroke-rest, #f87171);
+    color: var(--error-foreground-rest, #b91c1c);
+  }
+
+  .chip-remove {
+    flex-shrink: 0;
+    background: none;
+    border: none;
+    cursor: pointer;
+    padding: 0;
+    line-height: 1;
+    color: inherit;
+    opacity: 0.6;
+    font-size: 0.9em;
+  }
+
+  .chip-remove:hover {
+    opacity: 1;
+  }
+
+  .input-row {
+    display: flex;
+    gap: calc(var(--design-unit, 4) * 2px);
+    padding: calc(var(--design-unit, 4) * 2px);
+    border-top: 1px solid var(--neutral-stroke-rest);
+    align-items: flex-end;
+  }
+
+  .attach-button {
+    flex-shrink: 0;
+    align-self: flex-end;
+  }
+
+  .chat-input {
+    flex: 1;
+  }
+
+  .chat-input::part(control) {
+    resize: none;
+    min-height: calc(var(--base-height-multiplier, 10) * 1px + var(--design-unit, 4) * 4px);
+    max-height: calc(var(--base-height-multiplier, 10) * 5px);
+  }
+
+  .send-button {
+    flex-shrink: 0;
+    align-self: flex-end;
+  }
+`;

package/src/types/ai-chat-widget.ts

@@ -0,0 +1,11 @@
+/**
+ * Interface that AI inline interaction components can implement.
+ * The `AiChatInteractionWrapper` always sets `data` and `resolved` on the rendered element.
+ *
+ * @beta
+ */
+export interface AiChatWidget {
+  data: unknown;
+  /** When true, the interaction has already been resolved. Components should render read-only. */
+  resolved?: boolean;
+}

package/src/utils/index.ts

@@ -0,0 +1 @@
+export * from './logger';

package/src/utils/logger.ts

@@ -0,0 +1,3 @@
+import { createLogger } from '@genesislcap/foundation-logger';
+
+export const logger = createLogger('ai-assistant');

package/temp/api-report.md.api.md

@@ -0,0 +1,280 @@
+## API Report File for "@genesislcap/ai-assistant"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+import { AIProvider } from '@genesislcap/foundation-ai';
+import type { ChatAttachment } from '@genesislcap/foundation-ai';
+import type { ChatConfig } from '@genesislcap/foundation-ai';
+import type { ChatMessage } from '@genesislcap/foundation-ai';
+import type { ChatToolDefinition } from '@genesislcap/foundation-ai';
+import type { ChatToolHandlers } from '@genesislcap/foundation-ai';
+import { GenesisElement } from '@genesislcap/web-core';
+import { InterfaceSymbol } from '@microsoft/fast-foundation';
+import { PartialGenesisElementDefinition } from '@genesislcap/web-core';
+import { ViewTemplate } from '@genesislcap/web-core';
+
+// @public (undocumented)
+export const AI_ACTIVITY_CHANNEL_NAME = "foundation-ai-activity";
+
+// @public (undocumented)
+export type AiActivityEvents = {
+    'halo-start': {
+        toolNames: string[];
+    };
+    'halo-stop': void;
+    'chat-popout': {
+        state: AiAssistantSerializedState;
+    };
+    'chat-popin': {
+        state: AiAssistantSerializedState;
+    };
+};
+
+// @beta
+export class AiActivityHalo extends GenesisElement {
+    channelName: string;
+    // (undocumented)
+    connectedCallback(): void;
+    // (undocumented)
+    disconnectedCallback(): void;
+    // (undocumented)
+    haloActive: boolean;
+    minShowTime: number;
+    tools: string;
+}
+
+// @beta
+export type AiAssistantAnimation = keyof typeof ANIMATION_DEFS;
+
+// @beta
+export interface AiAssistantAnimationDef {
+    label: string;
+    tooltip: string;
+}
+
+// Warning: (ae-internal-mixed-release-tag) Mixed release tags are not allowed for "AiAssistantConfig" because one of its declarations is marked as @internal
+//
+// @beta
+export interface AiAssistantConfig extends PartialGenesisElementDefinition {
+    chatConfig: ChatConfig;
+    debugStateFactory?: () => unknown;
+    headerTitle?: string;
+    systemPrompt?: string;
+    toolDefinitions?: ChatToolDefinition[];
+    toolHandlers?: ChatToolHandlers;
+}
+
+// @internal
+export const AiAssistantConfig: InterfaceSymbol<AiAssistantConfig>;
+
+// @beta
+export interface AiAssistantSerializedState {
+    // (undocumented)
+    enabledAnimations: AiAssistantAnimation[];
+    // (undocumented)
+    messages: ChatMessage[];
+    // (undocumented)
+    showThinkingSteps: boolean;
+    // (undocumented)
+    showToolCalls: boolean;
+}
+
+// @beta
+export type AiAssistantState = 'idle' | 'loading' | 'error';
+
+// @public (undocumented)
+export class AiChatBubble extends GenesisElement {
+    // (undocumented)
+    bubbleLeft: number;
+    // (undocumented)
+    bubbleTop: number;
+    // (undocumented)
+    channelName: string;
+    // (undocumented)
+    connectedCallback(): void;
+    // (undocumented)
+    designSystemPrefix: string;
+    // (undocumented)
+    dialogContent: HTMLElement[];
+    // (undocumented)
+    dialogContentChanged(_: HTMLElement[], next: HTMLElement[]): void;
+    // (undocumented)
+    dialogHeight: number;
+    // (undocumented)
+    dialogLeft: number;
+    // (undocumented)
+    dialogOpen: boolean;
+    // (undocumented)
+    dialogOpenChanged(_: boolean, next: boolean): void;
+    // (undocumented)
+    dialogTop: number;
+    // (undocumented)
+    dialogWidth: number;
+    // (undocumented)
+    disconnectedCallback(): void;
+    // (undocumented)
+    hovered: boolean;
+    // (undocumented)
+    imageSrc?: string;
+    // (undocumented)
+    onBubbleMouseDown(e: MouseEvent): void;
+    // (undocumented)
+    onCloseDialog(): void;
+    // (undocumented)
+    onDialogHeaderMouseDown(e: CustomEvent<{
+        clientX: number;
+        clientY: number;
+    }>): void;
+    // (undocumented)
+    onPopout(): void;
+    // (undocumented)
+    title: string;
+    // (undocumented)
+    get tooltipStyle(): string;
+}
+
+// @beta
+export interface AiChatWidget {
+    // (undocumented)
+    data: unknown;
+    resolved?: boolean;
+}
+
+// Warning: (ae-internal-missing-underscore) The name "ALL_ANIMATIONS" should be prefixed with an underscore because the declaration is marked as @internal
+//
+// @internal
+export const ALL_ANIMATIONS: AiAssistantAnimation[];
+
+// @beta
+export const ANIMATION_DEFS: {
+    loading: {
+        label: string;
+        tooltip: string;
+    };
+    halo: {
+        label: string;
+        tooltip: string;
+    };
+};
+
+// @beta
+export class ChatDriver extends EventTarget {
+    constructor(aiProvider: AIProvider, toolHandlers?: ChatToolHandlers, toolDefinitions?: ChatToolDefinition[], systemPrompt?: string);
+    // (undocumented)
+    getHistory(): ReadonlyArray<ChatMessage>;
+    // (undocumented)
+    isBusy(): boolean;
+    loadHistory(messages: ChatMessage[]): void;
+    requestInteraction<T>(componentName: string, data: any): Promise<T>;
+    resolveInteraction(interactionId: string, result: any): void;
+    // (undocumented)
+    sendMessage(userInput: string, attachments?: ChatAttachment[]): Promise<void>;
+}
+
+// @beta
+export type ChatHistoryUpdatedEvent = CustomEvent<ReadonlyArray<ChatMessage>>;
+
+// @beta
+export const defaultAiAssistantConfig: AiAssistantConfig;
+
+// @beta
+export class FoundationAiAssistant extends GenesisElement {
+    // (undocumented)
+    aiProvider: AIProvider;
+    applyState(state: AiAssistantSerializedState): void;
+    // (undocumented)
+    attachmentErrors: string[];
+    // (undocumented)
+    attachments: ChatAttachment[];
+    // (undocumented)
+    channelName: string;
+    // (undocumented)
+    chatConfig: ChatConfig;
+    // (undocumented)
+    connectedCallback(): void;
+    // (undocumented)
+    debugStateFactory?: () => unknown;
+    // (undocumented)
+    designSystemPrefix: string;
+    // (undocumented)
+    disconnectedCallback(): void;
+    // (undocumented)
+    downloadHistory(): void;
+    enabledAnimations: AiAssistantAnimation[];
+    // (undocumented)
+    handleFileSelect(e: Event): void;
+    // (undocumented)
+    handleInteractionCompleted(e: Event): void;
+    handlePopout(): void;
+    // (undocumented)
+    handleSendClick(): void;
+    get hasActivePendingInteraction(): boolean;
+    // (undocumented)
+    headerTitle?: string;
+    // (undocumented)
+    imageSrc?: string;
+    // (undocumented)
+    inputValue: string;
+    // (undocumented)
+    messages: ChatMessage[];
+    // (undocumented)
+    messagesChanged(): void;
+    // (undocumented)
+    onChatHeaderMouseDown(e: MouseEvent): void;
+    // (undocumented)
+    placeholder: string;
+    popoutMode?: PopoutMode;
+    // (undocumented)
+    removeAttachment(attachment: ChatAttachment): void;
+    // (undocumented)
+    removeAttachmentError(message: string): void;
+    // (undocumented)
+    setEnabledAnimations(animations: AiAssistantAnimation[]): void;
+    settingsOpen: boolean;
+    showHalo: boolean;
+    // (undocumented)
+    showHaloChanged(): void;
+    showLoadingIndicator: boolean;
+    // (undocumented)
+    showLoadingIndicatorChanged(): void;
+    showThinkingSteps: boolean;
+    showToolCalls: boolean;
+    // (undocumented)
+    state: AiAssistantState;
+    // (undocumented)
+    stateChanged(): void;
+    // (undocumented)
+    systemPrompt?: string;
+    // (undocumented)
+    toggleSettings(): void;
+    // (undocumented)
+    toggleShowThinkingSteps(): void;
+    // (undocumented)
+    toggleShowToolCalls(): void;
+    // (undocumented)
+    toolDefinitions?: ChatToolDefinition[];
+    // (undocumented)
+    toolHandlers?: ChatToolHandlers;
+    // (undocumented)
+    triggerFileInput(): void;
+    get visibleMessages(): ChatMessage[];
+}
+
+// Warning: (ae-incompatible-release-tags) The symbol "FoundationAiAssistantTemplate" is marked as @public, but its signature references "FoundationAiAssistant" which is marked as @beta
+//
+// @public (undocumented)
+export const FoundationAiAssistantTemplate: (designSystemPrefix: string) => ViewTemplate<FoundationAiAssistant>;
+
+// @beta
+export type PopoutMode = 'expand' | 'collapse';
+
+// Warnings were encountered during analysis:
+//
+// src/channel/ai-activity-channel.ts:27:20 - (ae-incompatible-release-tags) The symbol "state" is marked as @public, but its signature references "AiAssistantSerializedState" which is marked as @beta
+// src/channel/ai-activity-channel.ts:29:19 - (ae-incompatible-release-tags) The symbol "state" is marked as @public, but its signature references "AiAssistantSerializedState" which is marked as @beta
+
+// (No @packageDocumentation comment for this package)
+
+```

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../../../tsconfig.json",
+  "compilerOptions": {
+    "declarationDir": "./dist/dts",
+    "outDir": "./dist/esm",
+    "rootDir": "./src"
+  },
+  "include": [
+    "src/**/*"
+  ]
+}