@modelprofile.com/flexharness 6.1.0 → 7.0.0

package/ts_chat_web/flexchat-window.ts

@@ -0,0 +1,416 @@
+import { LitElement, html, css } from './plugins.js';
+import type { CSSResult, TemplateResult, IChatSession, IAgentRunResult, PropertyValues } from './plugins.js';
+import './flexchat-message.js';
+import './flexchat-input.js';
+
+interface IDisplayMessage {
+  role: 'user' | 'assistant' | 'tool';
+  content: string;
+  toolName?: string;
+  timestamp?: number;
+}
+
+export class FlexChatWindow extends LitElement {
+  declare chatSession: IChatSession;
+  declare placeholder: string;
+  declare headerTitle: string;
+  private messages: IDisplayMessage[] = [];
+  private busy = false;
+  private streamingText = '';
+  private unsubscribe: (() => void) | undefined;
+
+  static properties = {
+    chatSession: { attribute: false },
+    placeholder: { type: String },
+    headerTitle: { type: String, attribute: 'header-title' },
+  };
+
+  static styles: CSSResult = css`
+    :host {
+      display: flex;
+      flex-direction: column;
+      height: 100%;
+      background: var(--flexchat-bg, #0c0c14);
+      color: var(--flexchat-text, #e4e4e7);
+      font-family: var(--flexchat-font, 'Inter', system-ui, -apple-system, sans-serif);
+      font-size: 14px;
+      line-height: 1.6;
+      border-radius: var(--flexchat-radius, 16px);
+      overflow: hidden;
+    }
+
+    /* ── Header ── */
+    .header {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      padding: 14px 20px;
+      background: var(--flexchat-header-bg, rgba(255, 255, 255, 0.025));
+      border-bottom: 1px solid rgba(255, 255, 255, 0.06);
+      flex-shrink: 0;
+    }
+
+    .header-icon {
+      width: 34px;
+      height: 34px;
+      border-radius: 50%;
+      background: linear-gradient(135deg, #6366f1, #7c3aed);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 15px;
+      color: #fff;
+      flex-shrink: 0;
+      box-shadow: 0 2px 10px rgba(99, 102, 241, 0.35);
+    }
+
+    .header-info {
+      display: flex;
+      flex-direction: column;
+      gap: 1px;
+    }
+
+    .header-title {
+      font-weight: 600;
+      font-size: 14px;
+      color: #f0f0f3;
+      letter-spacing: -0.01em;
+    }
+
+    .header-status {
+      font-size: 11px;
+      color: #71717a;
+      display: flex;
+      align-items: center;
+      gap: 5px;
+    }
+
+    .status-dot {
+      width: 7px;
+      height: 7px;
+      border-radius: 50%;
+      background: #22c55e;
+      box-shadow: 0 0 6px rgba(34, 197, 94, 0.5);
+    }
+
+    .status-dot.busy {
+      background: #f59e0b;
+      box-shadow: 0 0 6px rgba(245, 158, 11, 0.5);
+      animation: pulse-dot 1.4s ease-in-out infinite;
+    }
+
+    @keyframes pulse-dot {
+      0%, 100% { opacity: 1; }
+      50% { opacity: 0.35; }
+    }
+
+    /* ── Message List ── */
+    .message-list {
+      flex: 1;
+      overflow-y: auto;
+      padding: 16px 20px;
+      display: flex;
+      flex-direction: column;
+      gap: 0;
+      scroll-behavior: smooth;
+      overscroll-behavior: contain;
+    }
+
+    .message-list::-webkit-scrollbar {
+      width: 5px;
+    }
+
+    .message-list::-webkit-scrollbar-track {
+      background: transparent;
+    }
+
+    .message-list::-webkit-scrollbar-thumb {
+      background: rgba(255, 255, 255, 0.07);
+      border-radius: 3px;
+    }
+
+    .message-list::-webkit-scrollbar-thumb:hover {
+      background: rgba(255, 255, 255, 0.14);
+    }
+
+    /* ── Empty State ── */
+    .empty-state {
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      flex: 1;
+      gap: 14px;
+      padding: 40px 20px;
+      text-align: center;
+    }
+
+    .empty-icon {
+      width: 56px;
+      height: 56px;
+      border-radius: 50%;
+      background: linear-gradient(135deg, rgba(99, 102, 241, 0.12), rgba(124, 58, 237, 0.06));
+      border: 1px solid rgba(99, 102, 241, 0.12);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 22px;
+      color: #818cf8;
+    }
+
+    .empty-title {
+      font-size: 15px;
+      font-weight: 600;
+      color: #e4e4e7;
+    }
+
+    .empty-subtitle {
+      font-size: 13px;
+      color: #52525b;
+      max-width: 260px;
+      line-height: 1.5;
+    }
+
+    /* ── Streaming ── */
+    .streaming-row {
+      display: flex;
+      gap: 10px;
+      align-items: flex-end;
+      margin-bottom: 4px;
+      padding-top: 4px;
+    }
+
+    .stream-avatar {
+      width: 28px;
+      height: 28px;
+      border-radius: 50%;
+      background: linear-gradient(135deg, #6366f1, #7c3aed);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 12px;
+      color: #fff;
+      flex-shrink: 0;
+    }
+
+    .stream-bubble {
+      background: #1e1e2e;
+      border: 1px solid rgba(255, 255, 255, 0.08);
+      color: #d1d5db;
+      padding: 10px 14px;
+      border-radius: 18px;
+      border-bottom-left-radius: 6px;
+      max-width: min(75%, 480px);
+      white-space: pre-wrap;
+      word-break: break-word;
+      font-size: 14px;
+      line-height: 1.55;
+    }
+
+    .cursor {
+      display: inline-block;
+      width: 2px;
+      height: 1.1em;
+      background: #818cf8;
+      vertical-align: text-bottom;
+      margin-left: 1px;
+      animation: cursor-blink 0.8s step-end infinite;
+    }
+
+    @keyframes cursor-blink {
+      50% { opacity: 0; }
+    }
+
+    /* ── Thinking Indicator ── */
+    .thinking-bubble {
+      display: inline-flex;
+      align-items: center;
+      gap: 5px;
+      padding: 12px 18px;
+      background: #1e1e2e;
+      border: 1px solid rgba(255, 255, 255, 0.08);
+      border-radius: 18px;
+      border-bottom-left-radius: 6px;
+    }
+
+    .thinking-dot {
+      width: 7px;
+      height: 7px;
+      border-radius: 50%;
+      background: #6366f1;
+      animation: thinking-bounce 1.4s ease-in-out infinite;
+    }
+
+    .thinking-dot:nth-child(2) { animation-delay: 0.16s; }
+    .thinking-dot:nth-child(3) { animation-delay: 0.32s; }
+
+    @keyframes thinking-bounce {
+      0%, 60%, 100% {
+        transform: translateY(0);
+        opacity: 0.3;
+      }
+      30% {
+        transform: translateY(-5px);
+        opacity: 1;
+      }
+    }
+
+    /* ── Input Area ── */
+    .input-area {
+      padding: 12px 20px 16px;
+      border-top: 1px solid rgba(255, 255, 255, 0.06);
+      background: var(--flexchat-input-area-bg, rgba(255, 255, 255, 0.015));
+      flex-shrink: 0;
+    }
+  `;
+
+  constructor() {
+    super();
+    this.placeholder = 'Type a message...';
+    this.headerTitle = 'FlexChat';
+  }
+
+  connectedCallback() {
+    super.connectedCallback();
+    this.bindSession();
+  }
+
+  disconnectedCallback() {
+    this.unsubscribe?.();
+    this.unsubscribe = undefined;
+    super.disconnectedCallback();
+  }
+
+  protected updated(changed: PropertyValues<this>) {
+    if (changed.has('chatSession')) this.bindSession();
+  }
+
+  private bindSession() {
+    this.unsubscribe?.();
+    this.unsubscribe = undefined;
+    if (this.isConnected && this.chatSession) {
+      this.unsubscribe = this.chatSession.subscribe({
+        onToken: (delta: string) => {
+          this.streamingText += delta;
+          this.requestUpdate();
+          this.scrollToBottom();
+        },
+        onToolCall: (name: string) => {
+          this.messages = [
+            ...this.messages,
+            { role: 'tool', content: '', toolName: name, timestamp: Date.now() },
+          ];
+          this.requestUpdate();
+          this.scrollToBottom();
+        },
+      });
+    }
+  }
+
+  private scrollToBottom() {
+    requestAnimationFrame(() => {
+      const list = this.shadowRoot?.querySelector('.message-list');
+      if (list) {
+        list.scrollTop = list.scrollHeight;
+      }
+    });
+  }
+
+  private async handleSend(e: CustomEvent<{ text: string }>) {
+    if (this.busy) return;
+
+    const text = e.detail.text;
+    this.messages = [...this.messages, { role: 'user', content: text, timestamp: Date.now() }];
+    this.busy = true;
+    this.streamingText = '';
+    this.requestUpdate();
+    this.scrollToBottom();
+
+    try {
+      const result = await this.chatSession.send(text);
+      this.streamingText = '';
+      this.messages = [...this.messages, { role: 'assistant', content: result.text, timestamp: Date.now() }];
+    } catch (error) {
+      const errMsg = error instanceof Error ? error.message : String(error);
+      this.messages = [
+        ...this.messages,
+        { role: 'assistant', content: `Error: ${errMsg}`, timestamp: Date.now() },
+      ];
+    } finally {
+      this.busy = false;
+      this.requestUpdate();
+      this.scrollToBottom();
+    }
+  }
+
+  render(): TemplateResult {
+    return html`
+      <div class="header">
+        <div class="header-icon">✦</div>
+        <div class="header-info">
+          <div class="header-title">${this.headerTitle}</div>
+          <div class="header-status">
+            <span class="status-dot ${this.busy ? 'busy' : ''}"></span>
+            ${this.busy ? 'Thinking...' : 'Online'}
+          </div>
+        </div>
+      </div>
+
+      <div class="message-list">
+        ${this.messages.length === 0 && !this.busy
+          ? html`
+              <div class="empty-state">
+                <div class="empty-icon">✦</div>
+                <div class="empty-title">Start a conversation</div>
+                <div class="empty-subtitle">
+                  Send a message below to begin chatting.
+                </div>
+              </div>
+            `
+          : ''}
+        ${this.messages.map(
+          (msg) => html`
+            <flexchat-message
+              role=${msg.role}
+              content=${msg.content}
+              .toolName=${msg.toolName ?? ''}
+              .timestamp=${msg.timestamp ?? 0}
+            ></flexchat-message>
+          `,
+        )}
+        ${this.busy && this.streamingText
+          ? html`
+              <div class="streaming-row">
+                <div class="stream-avatar">✦</div>
+                <div class="stream-bubble">
+                  ${this.streamingText}<span class="cursor"></span>
+                </div>
+              </div>
+            `
+          : ''}
+        ${this.busy && !this.streamingText
+          ? html`
+              <div class="streaming-row">
+                <div class="stream-avatar">✦</div>
+                <div class="thinking-bubble">
+                  <span class="thinking-dot"></span>
+                  <span class="thinking-dot"></span>
+                  <span class="thinking-dot"></span>
+                </div>
+              </div>
+            `
+          : ''}
+      </div>
+
+      <div class="input-area">
+        <flexchat-input
+          ?disabled=${this.busy}
+          placeholder=${this.placeholder}
+          @send=${this.handleSend}
+        ></flexchat-input>
+      </div>
+    `;
+  }
+}
+
+customElements.define('flexchat-window', FlexChatWindow);

package/ts_chat_web/index.ts

@@ -0,0 +1,3 @@
+export { FlexChatWindow } from './flexchat-window.js';
+export { FlexChatMessage } from './flexchat-message.js';
+export { FlexChatInput } from './flexchat-input.js';

package/ts_chat_web/plugins.ts

@@ -0,0 +1,9 @@
+// Lit
+import { LitElement, html, css } from 'lit';
+export { LitElement, html, css };
+export type { TemplateResult, CSSResult, PropertyValues } from 'lit';
+
+// Core (cross-folder import)
+export type { IChatSession } from '@modelprofile.com/flexharness/chat';
+export type { IChatSessionOptions, IChatCallbacks, IChatUsage } from '@modelprofile.com/flexharness/chat';
+export type { IAgentRunResult } from '@modelprofile.com/flexharness-agent';

package/ts_chat_web/readme.md

@@ -0,0 +1,46 @@
+Lit chat elements for a caller-owned FlexHarness chat session.
+
+```sh
+pnpm add @modelprofile.com/flexharness lit
+```
+
+```typescript
+import { ChatSession } from '@modelprofile.com/flexharness/chat';
+import { FlexChatWindow } from '@modelprofile.com/flexharness/chat/web';
+
+const element = new FlexChatWindow();
+element.chatSession = new ChatSession({ model });
+element.headerTitle = 'Project assistant';
+document.body.append(element);
+```
+
+The model can use your application's authenticated server transport. Do not embed a private provider key in a browser bundle. Alternatively, implement `IChatSession` for a remote session. The element accepts its session before or after connection and detaches its callback subscription on disconnect.
+
+Exports: `FlexChatWindow`, `FlexChatMessage`, `FlexChatInput`. Importing this component registers `flexchat-window`, `flexchat-message`, and `flexchat-input`. This subpath preserves element-registration side effects and contains no terminal UI imports.
+
+This replaces `@push.rocks/smartchat/web`. Rename `SmartchatWindow`, `SmartchatMessage` and `SmartchatInput` to `FlexChatWindow`, `FlexChatMessage` and `FlexChatInput`, custom elements from `smartchat-*` to `flexchat-*`, and CSS custom properties from `--smartchat-*` to `--flexchat-*`. The window exposes `chatSession`, `headerTitle` and `placeholder` properties. Give the window an explicit height or place it in a sized flex container.
+
+## Issue Reporting and Security
+
+Report issues and security concerns through [community.foss.global](https://community.foss.global).
+
+## License and Legal Information
+
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the repository license file.
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
+
+### Company Information
+
+Task Venture Capital GmbH<br>
+Registered at District Court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/ts_compaction/index.ts

@@ -0,0 +1,2 @@
+export { compactMessages } from './smartagent.compaction.js';
+export type { ICompactMessagesOptions } from './smartagent.compaction.js';

package/ts_compaction/plugins.ts

@@ -0,0 +1,6 @@
+import { generateText } from 'ai';
+
+export { generateText };
+
+export type { ModelMessage } from 'ai';
+export type { TSmartAiLanguageModel } from '@modelprofile.com/flexharness-models';

package/ts_compaction/readme.md

@@ -0,0 +1,37 @@
+Opt-in model-driven conversation compaction.
+
+Part of the [FlexHarness toolbox](https://code.foss.global/modelprofile.com/flexharness).
+Install the components your project uses. Provider adapters are registered explicitly;
+the agent and harness do not install or register vendor SDKs.
+
+```sh
+pnpm add @modelprofile.com/flexharness
+```
+
+See the [toolbox usage and migration guide](https://code.foss.global/modelprofile.com/flexharness#readme)
+for composition examples and the SmartAI/SmartAgent migration map.
+
+## Issue Reporting and Security
+
+Report issues and security concerns through [community.foss.global](https://community.foss.global).
+
+## License and Legal Information
+
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the repository license file.
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
+
+### Company Information
+
+Task Venture Capital GmbH<br>
+Registered at District Court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/ts_compaction/smartagent.compaction.ts

@@ -0,0 +1,59 @@
+import * as plugins from './plugins.js';
+
+const COMPACTION_PROMPT = `Provide a detailed prompt for continuing our conversation above.
+Focus on information that would be helpful for continuing the conversation, including what we did, what we're doing, which files we're working on, and what we're going to do next.
+The summary that you construct will be used so that another agent can read it and continue the work.
+
+When constructing the summary, try to stick to this template:
+---
+## Goal
+[What goal(s) is the user trying to accomplish?]
+
+## Instructions
+- [What important instructions did the user give you that are relevant]
+
+## Discoveries
+[What notable things were learned during this conversation that would be useful for the next agent to know]
+
+## Accomplished
+[What work has been completed, what work is still in progress, and what work is left?]
+
+## Relevant files / directories
+[A structured list of relevant files that have been read, edited, or created]
+---`;
+
+export interface ICompactMessagesOptions {
+  abortSignal?: AbortSignal;
+}
+
+/**
+ * Compacts a message history into a summary.
+ * Pass this as the onContextOverflow handler in IAgentRunOptions.
+ *
+ * @param model    The same model used by runAgent, or a cheaper small model
+ * @param messages The full message history that overflowed
+ * @param options  Invocation options, including cancellation
+ * @returns A minimal ModelMessage[] containing the summary as context
+ */
+export async function compactMessages(
+  model: plugins.TSmartAiLanguageModel,
+  messages: plugins.ModelMessage[],
+  options: ICompactMessagesOptions = {},
+): Promise<plugins.ModelMessage[]> {
+  const result = await plugins.generateText({
+    model,
+    abortSignal: options.abortSignal,
+    allowSystemInMessages: true,
+    messages: [
+      ...messages,
+      { role: 'user', content: COMPACTION_PROMPT },
+    ],
+  });
+
+  return [
+    {
+      role: 'user',
+      content: `[Previous conversation summary]\n\n${result.text}\n\n[End of summary. Continue from here.]`,
+    },
+  ];
+}

package/ts_document/index.ts

@@ -0,0 +1,82 @@
+import * as plugins from './plugins.js';
+import type { ModelMessage } from 'ai';
+import type { TSmartAiLanguageModel } from '@modelprofile.com/flexharness-models';
+
+let smartpdfInstance: InstanceType<typeof plugins.smartpdf.SmartPdf> | null = null;
+
+async function ensureSmartpdf(): Promise<InstanceType<typeof plugins.smartpdf.SmartPdf>> {
+  if (!smartpdfInstance) {
+    smartpdfInstance = new plugins.smartpdf.SmartPdf();
+    await smartpdfInstance.start();
+  }
+  return smartpdfInstance;
+}
+
+export interface IDocumentOptions {
+  model: TSmartAiLanguageModel;
+  systemMessage?: string;
+  userMessage: string;
+  pdfDocuments: Uint8Array[];
+  messageHistory?: ModelMessage[];
+}
+
+export interface IPdfTextExtractionOptions {
+  model: TSmartAiLanguageModel;
+  systemMessage?: string;
+  userMessage?: string;
+  messageHistory?: ModelMessage[];
+}
+
+/** The model-based PDF OCR recipe formerly provided by SmartOCR. */
+export async function extractTextFromPdf(
+  pdfDocument: Uint8Array,
+  options: IPdfTextExtractionOptions,
+): Promise<string> {
+  return analyzeDocuments({
+    model: options.model,
+    systemMessage: options.systemMessage ?? 'You are a precise OCR engine. Extract text faithfully and do not summarize.',
+    userMessage: options.userMessage ?? 'Extract all readable text from this PDF. Preserve page order, line breaks, table structure, and obvious headings. Return only the extracted text.',
+    pdfDocuments: [pdfDocument],
+    messageHistory: options.messageHistory,
+  });
+}
+
+export async function analyzeDocuments(options: IDocumentOptions): Promise<string> {
+  const pdf = await ensureSmartpdf();
+
+  const imagePages: Uint8Array[] = [];
+  for (const doc of options.pdfDocuments) {
+    const pages = await pdf.convertPDFToPngBytes(doc);
+    imagePages.push(...pages);
+  }
+
+  // Filter out empty buffers
+  const validPages = imagePages.filter(page => page && page.length > 0);
+
+  const result = await plugins.generateText({
+    model: options.model,
+    instructions: options.systemMessage,
+    messages: [
+      ...(options.messageHistory ?? []),
+      {
+        role: 'user',
+        content: [
+          { type: 'text', text: options.userMessage },
+          ...validPages.map(page => ({
+            type: 'file' as const,
+            data: page,
+            mediaType: 'image/png' as const,
+          })),
+        ],
+      },
+    ],
+  });
+  return result.text;
+}
+
+export async function stopSmartpdf(): Promise<void> {
+  if (smartpdfInstance) {
+    await smartpdfInstance.stop();
+    smartpdfInstance = null;
+  }
+}

package/ts_document/plugins.ts

@@ -0,0 +1,3 @@
+import { generateText } from 'ai';
+import * as smartpdf from '@push.rocks/smartpdf';
+export { generateText, smartpdf };