@geometra/agent 1.17.0

package/dist/agent-app.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Main entry point for the Geometra agent runtime.
+ *
+ * `createAgentApp()` wires together a WebSocket server, reactive state, and
+ * a chat view so that building an LLM-powered agent UI is a single function call.
+ */
+import type { AgentAppOptions, AgentApp } from './types.js';
+/**
+ * Create a Geometra agent application.
+ *
+ * Sets up a WebSocket server with a reactive chat UI. The `onMessage` callback
+ * is invoked when the user submits text; use the provided helpers to stream a
+ * response back.
+ *
+ * ```ts
+ * const app = await createAgentApp({
+ *   port: 3000,
+ *   onMessage: async (text, { append, setStatus, done }) => {
+ *     setStatus('thinking')
+ *     for await (const chunk of myLLM(text)) append(chunk)
+ *     done()
+ *   },
+ * })
+ * ```
+ */
+export declare function createAgentApp(options: AgentAppOptions): Promise<AgentApp>;
+//# sourceMappingURL=agent-app.d.ts.map

package/dist/agent-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-app.d.ts","sourceRoot":"","sources":["../src/agent-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EAKT,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiHhF"}

package/dist/agent-app.js

@@ -0,0 +1,133 @@
+/**
+ * Main entry point for the Geometra agent runtime.
+ *
+ * `createAgentApp()` wires together a WebSocket server, reactive state, and
+ * a chat view so that building an LLM-powered agent UI is a single function call.
+ */
+import { signal, batch, streamText } from '@geometra/core';
+import { createServer } from '@geometra/server';
+import { chatView } from './chat-view.js';
+/**
+ * Create a Geometra agent application.
+ *
+ * Sets up a WebSocket server with a reactive chat UI. The `onMessage` callback
+ * is invoked when the user submits text; use the provided helpers to stream a
+ * response back.
+ *
+ * ```ts
+ * const app = await createAgentApp({
+ *   port: 3000,
+ *   onMessage: async (text, { append, setStatus, done }) => {
+ *     setStatus('thinking')
+ *     for await (const chunk of myLLM(text)) append(chunk)
+ *     done()
+ *   },
+ * })
+ * ```
+ */
+export async function createAgentApp(options) {
+    // ---- State ---------------------------------------------------------------
+    const messages = signal([]);
+    const status = signal('idle');
+    const error = signal(null);
+    const streaming = streamText();
+    const state = {
+        messages,
+        status,
+        streamingText: streaming,
+        error,
+    };
+    // ---- System prompt -------------------------------------------------------
+    if (options.systemPrompt) {
+        messages.set([
+            {
+                role: 'system',
+                content: options.systemPrompt,
+                timestamp: new Date().toISOString(),
+            },
+        ]);
+    }
+    // ---- onMessage handler ---------------------------------------------------
+    function handleUserMessage(text) {
+        // Add user message
+        batch(() => {
+            const current = messages.peek();
+            messages.set([
+                ...current,
+                { role: 'user', content: text, timestamp: new Date().toISOString() },
+            ]);
+            error.set(null);
+            streaming.clear();
+            status.set('thinking');
+        });
+        server.update();
+        // Build callbacks for the agent
+        const callbacks = {
+            append(chunk) {
+                status.set('streaming');
+                streaming.append(chunk);
+                server.update();
+            },
+            set(text) {
+                status.set('streaming');
+                streaming.set(text);
+                server.update();
+            },
+            setStatus(s) {
+                status.set(s);
+                server.update();
+            },
+            done(metadata) {
+                const finalText = streaming.signal.peek();
+                streaming.done();
+                batch(() => {
+                    if (finalText.length > 0) {
+                        const current = messages.peek();
+                        messages.set([
+                            ...current,
+                            {
+                                role: 'assistant',
+                                content: finalText,
+                                timestamp: new Date().toISOString(),
+                                metadata,
+                            },
+                        ]);
+                    }
+                    streaming.clear();
+                    streaming.done(); // reset to not-streaming after clear
+                    status.set('idle');
+                });
+                server.update();
+            },
+        };
+        // Invoke the user's handler (async-safe)
+        Promise.resolve()
+            .then(() => options.onMessage(text, callbacks))
+            .catch((err) => {
+            batch(() => {
+                status.set('error');
+                error.set(err instanceof Error ? err.message : String(err));
+                streaming.done();
+            });
+            server.update();
+        });
+    }
+    // ---- View ----------------------------------------------------------------
+    const viewFn = options.view
+        ? () => options.view(state)
+        : chatView(state, {
+            title: options.title,
+            onSubmit: handleUserMessage,
+        });
+    // ---- Server --------------------------------------------------------------
+    const server = await createServer(viewFn, {
+        port: options.port ?? 3000,
+        width: options.width ?? 800,
+        height: options.height ?? 'auto',
+        onConnection: options.onConnection,
+        onDisconnect: options.onDisconnect,
+        onError: options.onError,
+    });
+    return { server, state };
+}
+//# sourceMappingURL=agent-app.js.map

package/dist/agent-app.js.map

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

package/dist/chat-view.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Default chat view for the agent UI.
+ *
+ * Renders a message list with streaming response, status indicator, and
+ * input field. Fully built from `@geometra/core` and `@geometra/ui` primitives.
+ */
+import type { UIElement } from '@geometra/core';
+import type { AgentState } from './types.js';
+export interface ChatViewOptions {
+    /** Header title (default: 'Agent'). */
+    title?: string;
+    /** Called when user submits a message. */
+    onSubmit?: (text: string) => void;
+}
+/**
+ * Build the default chat view. Returns a function `() => UIElement` suitable
+ * as a view for `createServer`.
+ */
+export declare function chatView(state: AgentState, options?: ChatViewOptions): () => UIElement;
+//# sourceMappingURL=chat-view.d.ts.map

package/dist/chat-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-view.d.ts","sourceRoot":"","sources":["../src/chat-view.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,gBAAgB,CAAA;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,YAAY,CAAA;AAuEzD,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,eAAoB,GAC5B,MAAM,SAAS,CAwIjB"}

package/dist/chat-view.js

@@ -0,0 +1,179 @@
+/**
+ * Default chat view for the agent UI.
+ *
+ * Renders a message list with streaming response, status indicator, and
+ * input field. Fully built from `@geometra/core` and `@geometra/ui` primitives.
+ */
+import { box, text, signal } from '@geometra/core';
+import { button, input } from '@geometra/ui';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function statusLabel(status) {
+    switch (status) {
+        case 'thinking':
+            return 'Thinking...';
+        case 'streaming':
+            return 'Responding...';
+        case 'tool-use':
+            return 'Using tool...';
+        case 'error':
+            return 'Error';
+        default:
+            return '';
+    }
+}
+function statusColor(status) {
+    switch (status) {
+        case 'thinking':
+        case 'streaming':
+            return '#38bdf8';
+        case 'tool-use':
+            return '#a78bfa';
+        case 'error':
+            return '#ef4444';
+        default:
+            return '#64748b';
+    }
+}
+function messageBubble(role, content) {
+    const isUser = role === 'user';
+    return box({
+        alignSelf: isUser ? 'flex-end' : 'flex-start',
+        maxWidth: '75%',
+        paddingLeft: 12,
+        paddingRight: 12,
+        paddingTop: 8,
+        paddingBottom: 8,
+        borderRadius: 12,
+        backgroundColor: isUser ? '#2563eb' : '#1e293b',
+    }, [
+        text({
+            text: content,
+            font: '14px Inter, system-ui',
+            lineHeight: 20,
+            color: isUser ? '#ffffff' : '#e2e8f0',
+        }),
+    ]);
+}
+// ---------------------------------------------------------------------------
+// Input state (module-level signals for the controlled input)
+// ---------------------------------------------------------------------------
+const inputValue = signal('');
+const inputFocused = signal(true);
+const inputCaret = signal(0);
+/**
+ * Build the default chat view. Returns a function `() => UIElement` suitable
+ * as a view for `createServer`.
+ */
+export function chatView(state, options = {}) {
+    const title = options.title ?? 'Agent';
+    const handleSubmit = () => {
+        const val = inputValue.peek().trim();
+        if (val.length === 0)
+            return;
+        inputValue.set('');
+        inputCaret.set(0);
+        options.onSubmit?.(val);
+    };
+    const handleKeyDown = (e) => {
+        if (e.key === 'Enter' && !e.shiftKey) {
+            handleSubmit();
+        }
+    };
+    return () => {
+        const messages = state.messages.value;
+        const status = state.status.value;
+        const streaming = state.streamingText.value;
+        const error = state.error.value;
+        // Message list
+        const messageElements = messages.map((m) => messageBubble(m.role, m.content));
+        // Streaming response in progress
+        if (streaming.length > 0) {
+            messageElements.push(messageBubble('assistant', streaming));
+        }
+        // Status indicator
+        const statusText = statusLabel(status);
+        return box({
+            flexDirection: 'column',
+            width: '100%',
+            height: '100%',
+            backgroundColor: '#0f172a',
+        }, [
+            // Header
+            box({
+                paddingLeft: 16,
+                paddingRight: 16,
+                paddingTop: 12,
+                paddingBottom: 12,
+                borderColor: '#1e293b',
+                borderWidth: 1,
+            }, [
+                text({
+                    text: title,
+                    font: 'bold 16px Inter, system-ui',
+                    lineHeight: 22,
+                    color: '#f8fafc',
+                }),
+            ]),
+            // Messages area
+            box({
+                flexDirection: 'column',
+                flexGrow: 1,
+                gap: 8,
+                padding: 16,
+                overflow: 'scroll',
+            }, messageElements),
+            // Status bar
+            ...(statusText.length > 0
+                ? [
+                    box({ paddingLeft: 16, paddingRight: 16, paddingBottom: 4 }, [
+                        text({
+                            text: statusText,
+                            font: '12px Inter, system-ui',
+                            lineHeight: 16,
+                            color: statusColor(status),
+                        }),
+                    ]),
+                ]
+                : []),
+            // Error bar
+            ...(error
+                ? [
+                    box({
+                        paddingLeft: 16,
+                        paddingRight: 16,
+                        paddingBottom: 4,
+                    }, [
+                        text({
+                            text: error,
+                            font: '12px Inter, system-ui',
+                            lineHeight: 16,
+                            color: '#ef4444',
+                        }),
+                    ]),
+                ]
+                : []),
+            // Input area
+            box({
+                flexDirection: 'row',
+                gap: 8,
+                padding: 12,
+                borderColor: '#1e293b',
+                borderWidth: 1,
+                alignItems: 'center',
+            }, [
+                box({ flexGrow: 1 }, [
+                    input(inputValue.value, 'Type a message...', {
+                        focused: inputFocused.value,
+                        caretOffset: inputCaret.value,
+                        onCaretOffsetChange: (offset) => inputCaret.set(offset),
+                        onKeyDown: handleKeyDown,
+                    }),
+                ]),
+                button('Send', handleSubmit),
+            ]),
+        ]);
+    };
+}
+//# sourceMappingURL=chat-view.js.map

package/dist/chat-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-view.js","sourceRoot":"","sources":["../src/chat-view.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @packageDocumentation
+ * `@geometra/agent` — AI agent UI runtime for Geometra.
+ *
+ * Provides `createAgentApp()` to wire up a WebSocket server with reactive
+ * chat state and a default chat view, plus building blocks for custom agent UIs.
+ */
+export { createAgentApp } from './agent-app.js';
+export { chatView } from './chat-view.js';
+export type { ChatViewOptions } from './chat-view.js';
+export type { AgentAppOptions, AgentApp, AgentState, AgentMessage, AgentCallbacks, AgentStatus, MessageRole, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAG/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGrD,YAAY,EACV,eAAe,EACf,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @packageDocumentation
+ * `@geometra/agent` — AI agent UI runtime for Geometra.
+ *
+ * Provides `createAgentApp()` to wire up a WebSocket server with reactive
+ * chat state and a default chat view, plus building blocks for custom agent UIs.
+ */
+// Main entry
+export { createAgentApp } from './agent-app.js';
+// Default chat view (can be used standalone or swapped)
+export { chatView } from './chat-view.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,wDAAwD;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Types for the Geometra agent UI runtime.
+ */
+import type { Signal } from '@geometra/core';
+import type { StreamText } from '@geometra/core';
+import type { UIElement } from '@geometra/core';
+import type { TexturaServerOptions } from '@geometra/server';
+export type MessageRole = 'user' | 'assistant' | 'system';
+export interface AgentMessage {
+    readonly role: MessageRole;
+    readonly content: string;
+    /** ISO timestamp. */
+    readonly timestamp: string;
+    /** Optional metadata (tool names, model, etc.) */
+    readonly metadata?: Record<string, unknown>;
+}
+export type AgentStatus = 'idle' | 'thinking' | 'streaming' | 'tool-use' | 'error';
+export interface AgentState {
+    /** Full message history. */
+    readonly messages: Signal<AgentMessage[]>;
+    /** Current agent status. */
+    readonly status: Signal<AgentStatus>;
+    /** Active streaming text (assistant's in-progress response). */
+    readonly streamingText: StreamText;
+    /** Last error message, if any. */
+    readonly error: Signal<string | null>;
+}
+export interface AgentCallbacks {
+    /** Append a text chunk to the streaming response. */
+    append(chunk: string): void;
+    /** Replace the streaming text entirely. */
+    set(text: string): void;
+    /** Update the agent status indicator. */
+    setStatus(status: AgentStatus): void;
+    /** Finalize the current response and add it to message history. */
+    done(metadata?: Record<string, unknown>): void;
+}
+export interface AgentAppOptions {
+    /**
+     * Called when the user submits a message. Use the callbacks to stream a
+     * response back.
+     */
+    onMessage: (text: string, callbacks: AgentCallbacks) => void | Promise<void>;
+    /** Port for the WebSocket server (default: 3000). */
+    port?: number;
+    /** Root layout width (default: 800). */
+    width?: number;
+    /** Root layout height (default: 'auto'). */
+    height?: number | 'auto';
+    /** System prompt shown as the first message (optional). */
+    systemPrompt?: string;
+    /** Custom view function. Receives agent state, returns UI tree. */
+    view?: (state: AgentState) => UIElement;
+    /** Title shown in the chat header (default: 'Agent'). */
+    title?: string;
+    /** Server hooks forwarded to createServer. */
+    onConnection?: TexturaServerOptions['onConnection'];
+    onDisconnect?: TexturaServerOptions['onDisconnect'];
+    onError?: TexturaServerOptions['onError'];
+}
+export interface AgentApp {
+    /** The underlying Geometra server. */
+    readonly server: {
+        update(): void;
+        broadcastData(channel: string, payload: unknown): void;
+        close(): void;
+    };
+    /** Reactive agent state — read or mutate from outside. */
+    readonly state: AgentState;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAM5D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEzD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC5C;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAA;AAMlF,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;IACzC,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;IACpC,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAA;IAClC,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CACtC;AAMD,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,2CAA2C;IAC3C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,yCAAyC;IACzC,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,mEAAmE;IACnE,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC/C;AAMD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5E,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,SAAS,CAAA;IACvC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAA;IACnD,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAA;IACnD,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,IAAI,CAAC;QAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;QAAC,KAAK,IAAI,IAAI,CAAA;KAAE,CAAA;IAC1G,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAC3B"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the Geometra agent UI runtime.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@geometra/agent",
+  "version": "1.17.0",
+  "description": "AI agent UI runtime — wire up LLM agents with server-streamed Geometra UIs",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/razroo/geometra",
+    "directory": "packages/agent"
+  },
+  "homepage": "https://razroo.github.io/geometra",
+  "keywords": [
+    "geometra",
+    "agent",
+    "ai",
+    "llm",
+    "server-driven-ui"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@geometra/core": "^1.17.0",
+    "@geometra/server": "^1.17.0",
+    "@geometra/ui": "^1.17.0"
+  }
+}