udi-yac 0.1.0

package/dist/features/tool-calls/components/ToolCallRenderer.d.ts

@@ -0,0 +1,11 @@
+import { FlatToolCall, Message } from '../../../types/messages';
+interface ToolCallRendererProps {
+    toolCall: FlatToolCall;
+    isPinned?: boolean;
+    onSelectSuggestion?: (suggestion: string) => void;
+    message?: Message;
+    messageIndex?: number;
+    toolCallIndex?: number;
+}
+export declare function ToolCallRenderer({ toolCall, isPinned, onSelectSuggestion, message, messageIndex, toolCallIndex, }: ToolCallRendererProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/tool-calls/components/VisualizationCard.d.ts

@@ -0,0 +1,10 @@
+import { UDIGrammar } from 'udi-toolkit/react';
+interface VisualizationCardProps {
+    spec: UDIGrammar;
+    isPinned: boolean;
+    title?: string;
+    messageIndex?: number;
+    toolCallIndex?: number;
+}
+export declare function VisualizationCard({ spec, isPinned, title, messageIndex, toolCallIndex, }: VisualizationCardProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/tool-calls/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public API of the `tool-calls` feature. Cross-feature and app-layer imports
+ * must go through this barrel; intra-feature imports use relative paths.
+ */
+export { ToolCallRenderer } from './components/ToolCallRenderer';
+export type { FreeTextExplainArgs, RebuffArgs, ClarifyVariableArgs, FilterDataArgs, TextSegment, CreateVisualizationArgs, } from './types';

package/dist/features/tool-calls/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * TypeScript interfaces for orchestrator tool call arguments.
+ *
+ * These match the OpenAI function-calling schemas defined in the backend's
+ * ORCHESTRATOR_TOOLS list and represent the payload the frontend receives
+ * inside `tool_calls[].function.arguments`.
+ */
+export interface RebuffArgs {
+    message: string;
+    suggestions: string[];
+}
+export interface ClarifyCandidate {
+    field_name: string;
+    entity: string;
+    description?: string;
+}
+export interface AmbiguousVariable {
+    query_term: string;
+    candidates: ClarifyCandidate[];
+}
+export interface ClarifyVariableArgs {
+    message: string;
+    ambiguous_variables: AmbiguousVariable[];
+}
+export type FreeTextResponseType = 'capabilities' | 'data_summary' | 'general';
+export interface StructuredTextElement {
+    value: string;
+    [key: string]: unknown;
+}
+export type TextSegment = string | StructuredTextElement;
+export interface FreeTextExplainArgs {
+    response_type: FreeTextResponseType;
+    text: TextSegment[];
+    has_structured_elements: boolean;
+}
+export interface FilterDataArgs {
+    title: string;
+    entity: string;
+    field: string;
+    filter: {
+        filterType: 'point' | 'interval';
+        intervalRange: {
+            min: number;
+            max: number;
+        };
+        pointValues: string[];
+    };
+}
+export interface CreateVisualizationArgs {
+    description: string;
+    title: string;
+}

package/dist/icons.svg

@@ -0,0 +1,24 @@
+<svg xmlns="http://www.w3.org/2000/svg">
+  <symbol id="bluesky-icon" viewBox="0 0 16 17">
+    <g clip-path="url(#bluesky-clip)"><path fill="#08060d" d="M7.75 7.735c-.693-1.348-2.58-3.86-4.334-5.097-1.68-1.187-2.32-.981-2.74-.79C.188 2.065.1 2.812.1 3.251s.241 3.602.398 4.13c.52 1.744 2.367 2.333 4.07 2.145-2.495.37-4.71 1.278-1.805 4.512 3.196 3.309 4.38-.71 4.987-2.746.608 2.036 1.307 5.91 4.93 2.746 2.72-2.746.747-4.143-1.747-4.512 1.702.189 3.55-.4 4.07-2.145.156-.528.397-3.691.397-4.13s-.088-1.186-.575-1.406c-.42-.19-1.06-.395-2.741.79-1.755 1.24-3.64 3.752-4.334 5.099"/></g>
+    <defs><clipPath id="bluesky-clip"><path fill="#fff" d="M.1.85h15.3v15.3H.1z"/></clipPath></defs>
+  </symbol>
+  <symbol id="discord-icon" viewBox="0 0 20 19">
+    <path fill="#08060d" d="M16.224 3.768a14.5 14.5 0 0 0-3.67-1.153c-.158.286-.343.67-.47.976a13.5 13.5 0 0 0-4.067 0c-.128-.306-.317-.69-.476-.976A14.4 14.4 0 0 0 3.868 3.77C1.546 7.28.916 10.703 1.231 14.077a14.7 14.7 0 0 0 4.5 2.306q.545-.748.965-1.587a9.5 9.5 0 0 1-1.518-.74q.191-.14.372-.293c2.927 1.369 6.107 1.369 8.999 0q.183.152.372.294-.723.437-1.52.74.418.838.963 1.588a14.6 14.6 0 0 0 4.504-2.308c.37-3.911-.63-7.302-2.644-10.309m-9.13 8.234c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.894 0 1.614.82 1.599 1.82.001 1-.705 1.82-1.6 1.82m5.91 0c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.893 0 1.614.82 1.599 1.82 0 1-.706 1.82-1.6 1.82"/>
+  </symbol>
+  <symbol id="documentation-icon" viewBox="0 0 21 20">
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="m15.5 13.333 1.533 1.322c.645.555.967.833.967 1.178s-.322.623-.967 1.179L15.5 18.333m-3.333-5-1.534 1.322c-.644.555-.966.833-.966 1.178s.322.623.966 1.179l1.534 1.321"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M17.167 10.836v-4.32c0-1.41 0-2.117-.224-2.68-.359-.906-1.118-1.621-2.08-1.96-.599-.21-1.349-.21-2.848-.21-2.623 0-3.935 0-4.983.369-1.684.591-3.013 1.842-3.641 3.428C3 6.449 3 7.684 3 10.154v2.122c0 2.558 0 3.838.706 4.726q.306.383.713.671c.76.536 1.79.64 3.581.66"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M3 10a2.78 2.78 0 0 1 2.778-2.778c.555 0 1.209.097 1.748-.047.48-.129.854-.503.982-.982.145-.54.048-1.194.048-1.749a2.78 2.78 0 0 1 2.777-2.777"/>
+  </symbol>
+  <symbol id="github-icon" viewBox="0 0 19 19">
+    <path fill="#08060d" fill-rule="evenodd" d="M9.356 1.85C5.05 1.85 1.57 5.356 1.57 9.694a7.84 7.84 0 0 0 5.324 7.44c.387.079.528-.168.528-.376 0-.182-.013-.805-.013-1.454-2.165.467-2.616-.935-2.616-.935-.349-.91-.864-1.143-.864-1.143-.71-.48.051-.48.051-.48.787.051 1.2.805 1.2.805.695 1.194 1.817.857 2.268.649.064-.507.27-.857.49-1.052-1.728-.182-3.545-.857-3.545-3.87 0-.857.31-1.558.8-2.104-.078-.195-.349-1 .077-2.078 0 0 .657-.208 2.14.805a7.5 7.5 0 0 1 1.946-.26c.657 0 1.328.092 1.946.26 1.483-1.013 2.14-.805 2.14-.805.426 1.078.155 1.883.078 2.078.502.546.799 1.247.799 2.104 0 3.013-1.818 3.675-3.558 3.87.284.247.528.714.528 1.454 0 1.052-.012 1.896-.012 2.156 0 .208.142.455.528.377a7.84 7.84 0 0 0 5.324-7.441c.013-4.338-3.48-7.844-7.773-7.844" clip-rule="evenodd"/>
+  </symbol>
+  <symbol id="social-icon" viewBox="0 0 20 20">
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M12.5 6.667a4.167 4.167 0 1 0-8.334 0 4.167 4.167 0 0 0 8.334 0"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M2.5 16.667a5.833 5.833 0 0 1 8.75-5.053m3.837.474.513 1.035c.07.144.257.282.414.309l.93.155c.596.1.736.536.307.965l-.723.73a.64.64 0 0 0-.152.531l.207.903c.164.715-.213.991-.84.618l-.872-.52a.63.63 0 0 0-.577 0l-.872.52c-.624.373-1.003.094-.84-.618l.207-.903a.64.64 0 0 0-.152-.532l-.723-.729c-.426-.43-.289-.864.306-.964l.93-.156a.64.64 0 0 0 .412-.31l.513-1.034c.28-.562.735-.562 1.012 0"/>
+  </symbol>
+  <symbol id="x-icon" viewBox="0 0 19 19">
+    <path fill="#08060d" fill-rule="evenodd" d="M1.893 1.98c.052.072 1.245 1.769 2.653 3.77l2.892 4.114c.183.261.333.48.333.486s-.068.089-.152.183l-.522.593-.765.867-3.597 4.087c-.375.426-.734.834-.798.905a1 1 0 0 0-.118.148c0 .01.236.017.664.017h.663l.729-.83c.4-.457.796-.906.879-.999a692 692 0 0 0 1.794-2.038c.034-.037.301-.34.594-.675l.551-.624.345-.392a7 7 0 0 1 .34-.374c.006 0 .93 1.306 2.052 2.903l2.084 2.965.045.063h2.275c1.87 0 2.273-.003 2.266-.021-.008-.02-1.098-1.572-3.894-5.547-2.013-2.862-2.28-3.246-2.273-3.266.008-.019.282-.332 2.085-2.38l2-2.274 1.567-1.782c.022-.028-.016-.03-.65-.03h-.674l-.3.342a871 871 0 0 1-1.782 2.025c-.067.075-.405.458-.75.852a100 100 0 0 1-.803.91c-.148.172-.299.344-.99 1.127-.304.343-.32.358-.345.327-.015-.019-.904-1.282-1.976-2.808L6.365 1.85H1.8zm1.782.91 8.078 11.294c.772 1.08 1.413 1.973 1.425 1.984.016.017.241.02 1.05.017l1.03-.004-2.694-3.766L7.796 5.75 5.722 2.852l-1.039-.004-1.039-.004z" clip-rule="evenodd"/>
+  </symbol>
+</svg>

package/dist/images/yac-mascot.svg

@@ -0,0 +1,22 @@
+<svg width="228" height="201" viewBox="0 0 228 201" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="68.1169" height="110.326" transform="matrix(-1 0 0 1 122.628 24.4895)" fill="black"/>
+<rect width="103.954" height="89.8096" transform="matrix(4.42268e-08 -1 -1 -4.3202e-08 211.374 148.233)" fill="black"/>
+<rect width="31.0632" height="44.0713" transform="matrix(-1 0 0 1 131.04 120.704)" fill="black"/>
+<rect width="13.3442" height="31.4281" transform="matrix(-1 0 0 1 205.192 147.407)" fill="black"/>
+<rect width="13.3442" height="31.4281" transform="matrix(-1 0 0 1 122.628 157.056)" fill="black"/>
+<rect width="17.9186" height="12.1301" transform="matrix(-1 0 0 1 203.923 178.834)" fill="black"/>
+<rect width="17.9186" height="12.1301" transform="matrix(-1 0 0 1 124.468 188.484)" fill="black"/>
+<rect width="17.9186" height="12.1301" transform="matrix(-1 0 0 1 91.4121 184.9)" fill="black"/>
+<rect width="13.3442" height="23.4332" transform="matrix(-1 0 0 1 89.2246 161.466)" fill="black"/>
+<path d="M15.0644 35.5426C15.2803 39.6533 41.2177 38.1897 50.4195 37.0025L50.4192 44.6928L51.2377 58.0953L37.6969 56.6849C26.7709 56.2424 1.14031 47.7274 0.0295581 34.1057C-0.859046 23.2083 18.5004 11.8219 28.2912 7.49093C23.7923 15.1287 14.8485 31.4318 15.0644 35.5426Z" fill="#57B4E9"/>
+<path d="M89.8105 2.53698C94.7488 3.82333 102.208 6.40017 108.561 9.96733C111.737 11.7506 114.679 13.8046 116.892 16.1013C119.102 18.3945 120.655 21.0033 120.889 23.8843C121.178 27.4241 119.794 30.6198 117.513 33.4035C115.24 36.1789 112.032 38.6014 108.531 40.6489C101.546 44.7341 93.1787 47.448 88.0444 48.5041L75.6992 51.8597L74.847 52.0913L74.5109 51.274L70.1157 40.5585L67.449 36.0323L66.5949 34.5819L68.2775 34.525C72.585 34.3818 82.099 33.3658 90.4864 31.9024C94.6813 31.1705 98.5512 30.3345 101.33 29.4522C102.728 29.0082 103.792 28.5702 104.474 28.1582C104.816 27.9513 105.008 27.783 105.101 27.6685C105.116 27.6503 105.124 27.634 105.131 27.6229C105.083 27.2996 104.924 26.8 104.611 26.1151C104.285 25.4018 103.826 24.5561 103.259 23.6056C102.124 21.7055 100.585 19.4455 98.8816 17.0889C95.4765 12.3786 91.4544 7.34248 88.7903 4.14504L86.7973 1.75214L89.8105 2.53698Z" fill="#57B4E9" stroke="white" stroke-width="2"/>
+<rect width="31.0632" height="44.0713" transform="matrix(-1 0 0 1 91.4121 117.395)" fill="black"/>
+<rect width="44.3591" height="43.8421" transform="matrix(-1 0 0 1 84.7998 40.4111)" fill="black"/>
+<rect width="30.9491" height="10.4551" transform="matrix(-1 0 0 1 74.8291 29.9563)" fill="black"/>
+<rect width="35.348" height="14.5105" transform="matrix(-1 0 0 1 78.0957 84.2534)" fill="black"/>
+<rect width="20.3335" height="20.6172" transform="matrix(-1 0 0 1 71.3896 84.2534)" fill="black"/>
+<rect width="16.2667" height="55.7096" transform="matrix(-1 0 0 1 227.273 70.1934)" fill="black"/>
+<rect width="9.97089" height="13.1067" transform="matrix(-1 0 0 1 40.4414 51.3379)" fill="black"/>
+<rect width="9.97089" height="12.5623" transform="matrix(-1 0 0 1 94.7705 46.4106)" fill="black"/>
+<path d="M51.0579 105.181H71.4275V99.1139H78.459V84.0837H84.8209V59.1253H95.0059V46.715H84.8209V40.5098H75.0545V30.03H42.9378V39.8679H39.3644V51.422H29.3587V55.4719" stroke="white" stroke-width="2"/>
+</svg>

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { UDIChat } from './app/UDIChat';
+export type { UDIChatConfig } from './app/UDIChatConfig';
+export type { DataPackage, DataPackageResource, DataFieldDomain, IntervalDomain, CategoricalDomain, } from './types/dataPackage';
+export { joinDataPath } from './features/data-package/utils/joinDataPath';
+export type { LoadingPhase } from './features/data-package/stores/dataPackageStore';

package/dist/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/stores/globalStore.d.ts

@@ -0,0 +1,6 @@
+export interface GlobalState {
+    debugMode: boolean;
+    isProduction: boolean;
+    toggleDebugMode: () => void;
+}
+export declare function createGlobalStore(): import('zustand').StoreApi<GlobalState>;

package/dist/stores/globalStore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/dataPackage.d.ts

@@ -0,0 +1,64 @@
+export interface IntervalDomain {
+    min: number;
+    max: number;
+}
+export interface CategoricalDomain {
+    values: string[];
+}
+export interface DataFieldDomain {
+    entity: string;
+    field: string;
+    type: 'interval' | 'point';
+    domain: IntervalDomain | CategoricalDomain;
+    fieldDescription: string;
+}
+export interface DataPackageResource {
+    name: string;
+    path: string;
+    schema: {
+        fields: Array<{
+            name: string;
+            description?: string;
+            type?: string;
+            'udi:cardinality'?: number;
+            'udi:data_type'?: string;
+            'udi:overlapping_fields'?: string[] | 'all';
+            'udi:unique'?: boolean;
+        }>;
+        primaryKey?: string[];
+        foreignKeys?: Array<{
+            fields: string[];
+            'udi:cardinality'?: {
+                from: 'one' | 'many';
+                to: 'one' | 'many';
+            };
+            reference: {
+                resource: string;
+                fields: string[];
+            };
+        }>;
+    };
+    encoding?: string;
+    format?: string;
+    mediatype?: string;
+    scheme?: string;
+    type?: string;
+    'udi:column_count'?: number;
+    'udi:row_count'?: number;
+}
+export interface DataPackage {
+    'udi:path': string;
+    resources: DataPackageResource[];
+}
+export type Row = Record<string, unknown>;
+export type ExportRowSet = {
+    displayRows: Row[];
+    allRows: Row[];
+};
+export interface ValidStatus {
+    isValid: 'yes' | 'no' | 'unknown';
+}
+export interface EntityRelationship {
+    originKey: string;
+    targetKey: string;
+}

package/dist/types/messages.d.ts

@@ -0,0 +1,24 @@
+export interface Message {
+    role: 'user' | 'system' | 'assistant';
+    content: string;
+    tool_calls?: ToolCall[];
+    linkedVisFilterId?: string;
+}
+export interface ToolCall {
+    function: FlatToolCall;
+    name?: string;
+    arguments?: Arguments;
+}
+export interface FlatToolCall {
+    name: string;
+    arguments: Arguments;
+    meta?: Record<string, unknown>;
+}
+/**
+ * Tool-call arguments can contain arbitrary nested JSON values (e.g.
+ * `filter: { intervalRange: { min, max } }` on FilterData, or `spec: string`
+ * on RenderVisualization). The previous `{ [key: string]: string }` typing
+ * did not match the reality. Callers should narrow to a specific
+ * tool-call-args interface from `@/features/tool-calls/types` before use.
+ */
+export type Arguments = Record<string, unknown>;