site-operator 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# Site Operator (Core)
+
+The core Web Component library for Site Operator. It provides the `<agent-chat>` custom element and the `chatPortalService`.
+
+This package is framework-agnostic.
+
+## Installation
+
+```bash
+npm install site-operator
+```
+
+## Usage
+
+### Vanilla JS
+
+```javascript
+import { mount } from 'site-operator';
+
+// Mount the chat widget
+mount(document.body, {
+  backendUrl: 'http://localhost:8001/ag_ui',
+  appName: 'My App'
+});
+
+// Register portal actions (Copilot)
+import { chatPortalService } from 'site-operator';
+
+chatPortalService.registerPortal({
+  actions: {
+    navigate: (args) => console.log('Navigating to', args.url)
+  }
+});
+```
+
+### HTML
+
+You can also use it directly if loaded via script tag (assuming UMD build):
+
+```html
+<script src="path/to/site-operator.umd.js"></script>
+<agent-chat backend-url="..." app-name="..."></agent-chat>
+```

package/dist/index.d.ts

@@ -0,0 +1,140 @@
+import { CSSResult } from 'lit';
+import { LitElement } from 'lit';
+import { TemplateResult } from 'lit-html';
+
+export declare class AgentChat extends LitElement {
+    static styles: CSSResult;
+    private _chatController;
+    backendUrl: string;
+    appName: string;
+    agentAvatar: string;
+    private _historyOpen;
+    private _inspectorOpen;
+    private _inspectorEnabled;
+    willUpdate(changedProperties: Map<string, any>): void;
+    private _handleSend;
+    private _handleNewThread;
+    /**
+     * API Pública para establecer el contexto de la aplicación.
+     * @param appContext Contexto de la aplicación (AgentState)
+     */
+    setAppContext(appContext: AgentState): void;
+    private _toggleHistory;
+    private _handleSelectThread;
+    private _toggleInspector;
+    render(): TemplateResult<1>;
+}
+
+/**
+ * Representa el estado del agente y el contexto de la aplicación
+ * donde se encuentra embebido el chat.
+ */
+export declare interface AgentState {
+    /** Nombre del portal donde se ejecuta el chat */
+    appName: string;
+    /** Nombre de la página donde se está ejecutando */
+    currentPage: string;
+    /** Habilita la ventana de inspección */
+    inspector?: boolean;
+}
+
+export declare interface ChatPortalAPI {
+    registerPortal(spec: PortalSpec): void;
+    executePlan(plan: NavPlan): Promise<{
+        status: "ok" | "error";
+        details?: any;
+    }>;
+}
+
+export declare class ChatPortalService implements ChatPortalAPI {
+    private _spec;
+    private static _instance;
+    private constructor();
+    static getInstance(): ChatPortalService;
+    registerPortal(spec: PortalSpec): void;
+    executePlan(plan: NavPlan): Promise<{
+        status: "ok" | "error";
+        details?: any;
+    }>;
+    get specs(): PortalSpec | null;
+}
+
+export declare const chatPortalService: ChatPortalService;
+
+export declare interface ChatThread {
+    id: string;
+    messages: Message[];
+    isRunning: boolean;
+}
+
+export declare interface ConversationSummary {
+    id: string;
+    title: string;
+}
+
+export declare interface InspectorEvent {
+    event: string;
+    content: any;
+    time: string;
+}
+
+export declare interface Message {
+    id: string;
+    role: Role;
+    content: string;
+    createdAt: number;
+    isThinking?: boolean;
+}
+
+/**
+ * Mounts the Agent Chat component to a target element.
+ * @param element The DOM element to mount the chat into.
+ * @param options Configuration options for the chat.
+ */
+export declare function mount(element: HTMLElement, options?: any): AgentChat;
+
+export declare interface NavAction {
+    action: string;
+    args?: any;
+}
+
+export declare interface NavGraph {
+    nodes: NavNode[];
+    edges: {
+        from: string;
+        to: string;
+        label?: string;
+    }[];
+}
+
+export declare interface NavNode {
+    id: string;
+    description: string;
+}
+
+export declare interface NavPlan {
+    steps: NavAction[];
+    rationale?: string;
+}
+
+export declare interface PortalSpec {
+    graph: NavGraph;
+    actions: Record<string, (args: any) => Promise<any>>;
+    state?: {
+        get: () => Promise<{
+            route: string;
+            pageId?: string;
+            selection?: any;
+        }>;
+    };
+}
+
+/**
+ * Registers the web component.
+ * (It's already registered by import, but this can be a safe-guard re-export or initialization function)
+ */
+export declare function register(): void;
+
+export declare type Role = "user" | "assistant";
+
+export { }