@design.estate/dees-catalog 3.91.0 → 3.92.0

package/dist_ts_web/elements/00group-harness/harness.markdown.js

@@ -0,0 +1,147 @@
+import { css } from '@design.estate/dees-element';
+import * as domtools from '@design.estate/dees-domtools';
+/**
+ * Markdown service for harness messages. Uses smartmarkdown (already in the
+ * dependency graph via dees-domtools; GFM-capable, sanitized-by-default) so
+ * the group adds zero dependencies. Results are LRU-cached because streaming
+ * re-parses the same growing text repeatedly. Swap seam: if the parser ever
+ * changes, only this file does.
+ */
+export class HarnessMarkdown {
+    static instance;
+    static getInstance() {
+        HarnessMarkdown.instance ??= new HarnessMarkdown();
+        return HarnessMarkdown.instance;
+    }
+    cache = new Map();
+    static maxCacheEntries = 200;
+    async renderToHtml(markdownText) {
+        const cached = this.cache.get(markdownText);
+        if (cached !== undefined) {
+            // refresh LRU position
+            this.cache.delete(markdownText);
+            this.cache.set(markdownText, cached);
+            return cached;
+        }
+        const html = await domtools.plugins.smartmarkdown.SmartMarkdown.easyMarkdownToHtml(markdownText);
+        const processed = this.postProcess(html);
+        this.cache.set(markdownText, processed);
+        if (this.cache.size > HarnessMarkdown.maxCacheEntries) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined)
+                this.cache.delete(oldestKey);
+        }
+        return processed;
+    }
+    /** External links open in a new context and never leak the opener. */
+    postProcess(html) {
+        return html.replaceAll('<a href=', '<a target="_blank" rel="noopener noreferrer" href=');
+    }
+}
+/**
+ * Token-based typography for rendered markdown. Included by components that
+ * render HarnessMarkdown output inside a `.markdown-body` container. Code
+ * fence syntax colors reuse the codebox palette convention (dark defaults,
+ * `:host([gobright])` for light) — kept in the consuming component's styles
+ * where :host is available; this block covers structure and rhythm.
+ */
+export const markdownStyles = css `
+  .markdown-body {
+    color: var(--dees-color-text-primary);
+    font-size: var(--dees-font-control-size, 13px);
+    line-height: 1.55;
+    overflow-wrap: anywhere;
+  }
+  .markdown-body > :first-child {
+    margin-top: 0;
+  }
+  .markdown-body > :last-child {
+    margin-bottom: 0;
+  }
+  .markdown-body h1,
+  .markdown-body h2,
+  .markdown-body h3,
+  .markdown-body h4 {
+    margin: var(--dees-spacing-lg) 0 var(--dees-spacing-sm);
+    color: var(--dees-color-text-primary);
+    font-weight: 600;
+    line-height: 1.3;
+  }
+  .markdown-body h1 { font-size: 1.35em; }
+  .markdown-body h2 { font-size: 1.2em; }
+  .markdown-body h3 { font-size: 1.05em; }
+  .markdown-body h4 { font-size: 1em; }
+  .markdown-body p {
+    margin: var(--dees-spacing-sm) 0;
+  }
+  .markdown-body ul,
+  .markdown-body ol {
+    margin: var(--dees-spacing-sm) 0;
+    padding-left: 1.4em;
+  }
+  .markdown-body li {
+    margin: 2px 0;
+  }
+  .markdown-body a {
+    color: var(--dees-color-link);
+    text-decoration: none;
+  }
+  .markdown-body a:hover {
+    color: var(--dees-color-link-hover);
+    text-decoration: underline;
+  }
+  .markdown-body blockquote {
+    margin: var(--dees-spacing-sm) 0;
+    padding: var(--dees-spacing-xs) var(--dees-spacing-md);
+    border-left: 3px solid var(--dees-color-border-strong);
+    color: var(--dees-color-text-secondary);
+  }
+  .markdown-body code {
+    padding: 1px 5px;
+    border-radius: var(--dees-radius-xs);
+    background: var(--dees-color-code-bg);
+    font-family: var(--dees-font-family-mono);
+    font-size: 0.92em;
+  }
+  .markdown-body pre {
+    margin: var(--dees-spacing-sm) 0;
+    padding: var(--dees-spacing-md);
+    border: 1px solid var(--dees-color-border-subtle);
+    border-radius: var(--dees-radius-md);
+    corner-shape: var(--dees-corner-shape);
+    background: var(--dees-color-code-block-bg);
+    overflow: auto;
+  }
+  .markdown-body pre code {
+    padding: 0;
+    border-radius: 0;
+    background: transparent;
+    font-size: var(--dees-font-control-size-sm, 12px);
+    line-height: 1.5;
+  }
+  .markdown-body table {
+    margin: var(--dees-spacing-sm) 0;
+    border-collapse: collapse;
+    font-size: 0.95em;
+  }
+  .markdown-body th,
+  .markdown-body td {
+    padding: 4px 10px;
+    border: 1px solid var(--dees-color-border-default);
+    text-align: left;
+  }
+  .markdown-body th {
+    background: var(--dees-color-bg-tertiary);
+    font-weight: 600;
+  }
+  .markdown-body img {
+    max-width: 100%;
+    border-radius: var(--dees-radius-md);
+  }
+  .markdown-body hr {
+    margin: var(--dees-spacing-md) 0;
+    border: 0;
+    border-top: 1px solid var(--dees-color-border-subtle);
+  }
+`;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGFybmVzcy5tYXJrZG93bi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzX3dlYi9lbGVtZW50cy8wMGdyb3VwLWhhcm5lc3MvaGFybmVzcy5tYXJrZG93bi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsR0FBRyxFQUFrQixNQUFNLDZCQUE2QixDQUFDO0FBQ2xFLE9BQU8sS0FBSyxRQUFRLE1BQU0sOEJBQThCLENBQUM7QUFFekQ7Ozs7OztHQU1HO0FBQ0gsTUFBTSxPQUFPLGVBQWU7SUFDbEIsTUFBTSxDQUFDLFFBQVEsQ0FBOEI7SUFFOUMsTUFBTSxDQUFDLFdBQVc7UUFDdkIsZUFBZSxDQUFDLFFBQVEsS0FBSyxJQUFJLGVBQWUsRUFBRSxDQUFDO1FBQ25ELE9BQU8sZUFBZSxDQUFDLFFBQVEsQ0FBQztJQUNsQyxDQUFDO0lBRU8sS0FBSyxHQUFHLElBQUksR0FBRyxFQUFrQixDQUFDO0lBQ2xDLE1BQU0sQ0FBVSxlQUFlLEdBQUcsR0FBRyxDQUFDO0lBRXZDLEtBQUssQ0FBQyxZQUFZLENBQUMsWUFBb0I7UUFDNUMsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsWUFBWSxDQUFDLENBQUM7UUFDNUMsSUFBSSxNQUFNLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDekIsdUJBQXVCO1lBQ3ZCLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLFlBQVksQ0FBQyxDQUFDO1lBQ2hDLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLFlBQVksRUFBRSxNQUFNLENBQUMsQ0FBQztZQUNyQyxPQUFPLE1BQU0sQ0FBQztRQUNoQixDQUFDO1FBQ0QsTUFBTSxJQUFJLEdBQUcsTUFBTSxRQUFRLENBQUMsT0FBTyxDQUFDLGFBQWEsQ0FBQyxhQUFhLENBQUMsa0JBQWtCLENBQUMsWUFBWSxDQUFDLENBQUM7UUFDakcsTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUN6QyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxZQUFZLEVBQUUsU0FBUyxDQUFDLENBQUM7UUFDeEMsSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksR0FBRyxlQUFlLENBQUMsZUFBZSxFQUFFLENBQUM7WUFDdEQsTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxLQUFLLENBQUM7WUFDakQsSUFBSSxTQUFTLEtBQUssU0FBUztnQkFBRSxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUM1RCxDQUFDO1FBQ0QsT0FBTyxTQUFTLENBQUM7SUFDbkIsQ0FBQztJQUVELHNFQUFzRTtJQUM5RCxXQUFXLENBQUMsSUFBWTtRQUM5QixPQUFPLElBQUksQ0FBQyxVQUFVLENBQUMsVUFBVSxFQUFFLG9EQUFvRCxDQUFDLENBQUM7SUFDM0YsQ0FBQzs7QUFHSDs7Ozs7O0dBTUc7QUFDSCxNQUFNLENBQUMsTUFBTSxjQUFjLEdBQWMsR0FBRyxDQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQWtHM0MsQ0FBQyJ9

package/dist_ts_web/elements/00group-harness/harness.styles.d.ts

@@ -0,0 +1,9 @@
+import { type CSSResult } from '@design.estate/dees-element';
+/**
+ * Shared visual vocabulary for harness components: card chrome, status
+ * pills, and monospace output blocks. Tokens only — both themes flip
+ * automatically.
+ */
+export declare const harnessCardStyles: CSSResult;
+export declare const harnessPillStyles: CSSResult;
+export declare const harnessMonoStyles: CSSResult;

package/dist_ts_web/elements/00group-harness/harness.styles.js

@@ -0,0 +1,94 @@
+import { css } from '@design.estate/dees-element';
+/**
+ * Shared visual vocabulary for harness components: card chrome, status
+ * pills, and monospace output blocks. Tokens only — both themes flip
+ * automatically.
+ */
+export const harnessCardStyles = css `
+  .harness-card {
+    border: 1px solid var(--dees-color-border-subtle);
+    border-left: 2px solid var(--dees-color-border-default);
+    border-radius: var(--dees-radius-lg);
+    corner-shape: var(--dees-corner-shape);
+    background: var(--dees-color-bg-secondary);
+    overflow: hidden;
+  }
+  .harness-card.status-running,
+  .harness-card.status-pending {
+    border-left-color: var(--dees-color-accent-primary);
+  }
+  .harness-card.status-completed {
+    border-left-color: var(--dees-color-accent-success);
+  }
+  .harness-card.status-error {
+    border-left-color: var(--dees-color-accent-error);
+  }
+  .harness-card.destructive {
+    border-left-color: var(--dees-color-accent-error);
+  }
+`;
+export const harnessPillStyles = css `
+  .harness-pill {
+    flex: 0 0 auto;
+    padding: 2px 8px;
+    border-radius: var(--dees-radius-full);
+    background: var(--dees-color-badge-default-bg);
+    color: var(--dees-color-badge-default-fg);
+    font-size: 10px;
+    font-weight: 700;
+    letter-spacing: 0.04em;
+    text-transform: uppercase;
+    white-space: nowrap;
+  }
+  .harness-pill.tone-running,
+  .harness-pill.tone-pending {
+    background: var(--dees-color-fill-secondary);
+    color: var(--dees-color-accent-primary);
+  }
+  .harness-pill.tone-success {
+    background: var(--dees-color-badge-success-bg);
+    color: var(--dees-color-badge-success-fg);
+  }
+  .harness-pill.tone-warning {
+    background: var(--dees-color-badge-warning-bg);
+    color: var(--dees-color-badge-warning-fg);
+  }
+  .harness-pill.tone-error {
+    background: var(--dees-color-badge-error-bg);
+    color: var(--dees-color-badge-error-fg);
+  }
+`;
+export const harnessMonoStyles = css `
+  .harness-mono {
+    margin: 0;
+    padding: var(--dees-spacing-sm) var(--dees-spacing-md);
+    border: 1px solid var(--dees-color-border-subtle);
+    border-radius: var(--dees-radius-md);
+    corner-shape: var(--dees-corner-shape);
+    background: var(--dees-color-code-block-bg);
+    color: var(--dees-color-text-primary);
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+    overflow: auto;
+    font-family: var(--dees-font-family-mono);
+    font-size: var(--dees-font-control-size-sm, 12px);
+    line-height: 1.5;
+  }
+  .harness-mono.tone-error {
+    color: var(--dees-color-text-error);
+  }
+  .harness-mono-expand {
+    margin-top: var(--dees-spacing-xs);
+    padding: 0;
+    border: 0;
+    background: transparent;
+    color: var(--dees-color-link);
+    cursor: pointer;
+    font-size: var(--dees-font-control-size-sm, 12px);
+  }
+  .harness-mono-expand:hover {
+    color: var(--dees-color-link-hover);
+    text-decoration: underline;
+  }
+`;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGFybmVzcy5zdHlsZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90c193ZWIvZWxlbWVudHMvMDBncm91cC1oYXJuZXNzL2hhcm5lc3Muc3R5bGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxHQUFHLEVBQWtCLE1BQU0sNkJBQTZCLENBQUM7QUFFbEU7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFjLEdBQUcsQ0FBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQXNCOUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFjLEdBQUcsQ0FBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0NBOEI5QyxDQUFDO0FBRUYsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQWMsR0FBRyxDQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQWdDOUMsQ0FBQyJ9

package/dist_ts_web/elements/00group-harness/index.d.ts

@@ -0,0 +1,18 @@
+export * from './interfaces.js';
+export * from './toolregistry.js';
+export * from './harness.helpers.js';
+export { HarnessMarkdown, markdownStyles } from './harness.markdown.js';
+export { harnessCardStyles, harnessPillStyles, harnessMonoStyles } from './harness.styles.js';
+export * from './harness.demodata.js';
+export * from './dees-harness-chat/index.js';
+export * from './dees-harness-composer/index.js';
+export * from './dees-harness-content-blocks/index.js';
+export * from './dees-harness-message/index.js';
+export * from './dees-harness-permission-card/index.js';
+export * from './dees-harness-message-list/index.js';
+export * from './dees-harness-reasoning/index.js';
+export * from './dees-harness-session-list/index.js';
+export * from './dees-harness-status/index.js';
+export * from './dees-harness-todos/index.js';
+export * from './dees-harness-tool-card/index.js';
+export * from './dees-harness-usage/index.js';

package/dist_ts_web/elements/00group-harness/index.js

@@ -0,0 +1,22 @@
+// Agentic Chat (harness) Components
+// Renders what an agent harness produces: messages, reasoning, tool calls,
+// MCP content, permissions — plus the composer and session chrome around it.
+export * from './interfaces.js';
+export * from './toolregistry.js';
+export * from './harness.helpers.js';
+export { HarnessMarkdown, markdownStyles } from './harness.markdown.js';
+export { harnessCardStyles, harnessPillStyles, harnessMonoStyles } from './harness.styles.js';
+export * from './harness.demodata.js';
+export * from './dees-harness-chat/index.js';
+export * from './dees-harness-composer/index.js';
+export * from './dees-harness-content-blocks/index.js';
+export * from './dees-harness-message/index.js';
+export * from './dees-harness-permission-card/index.js';
+export * from './dees-harness-message-list/index.js';
+export * from './dees-harness-reasoning/index.js';
+export * from './dees-harness-session-list/index.js';
+export * from './dees-harness-status/index.js';
+export * from './dees-harness-todos/index.js';
+export * from './dees-harness-tool-card/index.js';
+export * from './dees-harness-usage/index.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90c193ZWIvZWxlbWVudHMvMDBncm91cC1oYXJuZXNzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLG9DQUFvQztBQUNwQywyRUFBMkU7QUFDM0UsNkVBQTZFO0FBQzdFLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLE9BQU8sRUFBRSxlQUFlLEVBQUUsY0FBYyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDeEUsT0FBTyxFQUFFLGlCQUFpQixFQUFFLGlCQUFpQixFQUFFLGlCQUFpQixFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDOUYsY0FBYyx1QkFBdUIsQ0FBQztBQUV0QyxjQUFjLDhCQUE4QixDQUFDO0FBQzdDLGNBQWMsa0NBQWtDLENBQUM7QUFDakQsY0FBYyx3Q0FBd0MsQ0FBQztBQUN2RCxjQUFjLGlDQUFpQyxDQUFDO0FBQ2hELGNBQWMseUNBQXlDLENBQUM7QUFDeEQsY0FBYyxzQ0FBc0MsQ0FBQztBQUNyRCxjQUFjLG1DQUFtQyxDQUFDO0FBQ2xELGNBQWMsc0NBQXNDLENBQUM7QUFDckQsY0FBYyxnQ0FBZ0MsQ0FBQztBQUMvQyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsbUNBQW1DLENBQUM7QUFDbEQsY0FBYywrQkFBK0IsQ0FBQyJ9

package/dist_ts_web/elements/00group-harness/interfaces.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Normalized data contract for the harness (agentic chat) component group.
+ *
+ * Producers vary widely — smartagent callbacks, IDE runtime wire models,
+ * OpenCode-style part arrays, raw MCP results — so these interfaces define
+ * the ONE shape the components render. Consumers adapt their runtime's
+ * events into these types; everything here is plain data (no DOM, no
+ * framework types) so adapters can live anywhere.
+ */
+export type THarnessRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface IHarnessReasoningPart {
+    id: string;
+    text: string;
+    /** epoch ms; adapters convert wire ISO strings */
+    startedAt?: number;
+    /** undefined while the model is still thinking */
+    endedAt?: number;
+}
+export interface IHarnessAttachment {
+    id: string;
+    name: string;
+    mediaType: string;
+    /** bytes */
+    size: number;
+    kind: 'image' | 'text' | 'binary';
+    /** base64 payload for images and binary previews */
+    dataBase64?: string;
+    /** inline payload for text attachments */
+    text?: string;
+    truncated?: boolean;
+}
+export interface IHarnessUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface IHarnessMessage {
+    /** stable id — used as the keyed-repeat key; never reuse across messages */
+    id: string;
+    role: THarnessRole;
+    text: string;
+    /** epoch ms */
+    createdAt: number;
+    updatedAt?: number;
+    /** gates the streaming cursor and markdown parse throttling */
+    streaming?: boolean;
+    /** defaults to role === 'assistant' when undefined */
+    markdown?: boolean;
+    reasoning?: IHarnessReasoningPart[];
+    attachments?: IHarnessAttachment[];
+    /** role 'tool' messages render as a tool card */
+    toolCall?: IHarnessToolCall;
+    usage?: IHarnessUsage;
+    error?: string;
+    /** consumer passthrough; never interpreted by the components */
+    meta?: Record<string, unknown>;
+}
+export type THarnessToolStatus = 'pending' | 'running' | 'completed' | 'error';
+/**
+ * MCP-aligned content blocks (mirrors @modelcontextprotocol/sdk
+ * CallToolResult.content entries) so tool results keep their structure
+ * instead of being string-flattened.
+ */
+export type THarnessContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'audio';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+        blob?: string;
+    };
+} | {
+    type: 'resource_link';
+    uri: string;
+    name: string;
+    title?: string;
+    description?: string;
+    mimeType?: string;
+    size?: number;
+};
+export interface IHarnessMcpAnnotations {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+export interface IHarnessMcpMeta {
+    serverName: string;
+    /** un-namespaced tool name (the part after `server__`) */
+    toolName: string;
+    annotations?: IHarnessMcpAnnotations;
+}
+/**
+ * Tool calls are deliberately generic-plus-kind rather than a closed
+ * discriminated union: the set of tools is open (arbitrary MCP servers,
+ * app-specific tools), so classification happens at render time through the
+ * tool registry. `kind` is an optional explicit override.
+ */
+export interface IHarnessToolCall {
+    id: string;
+    /** raw tool name as invoked, including `server__tool` MCP namespacing */
+    name: string;
+    kind?: string;
+    status: THarnessToolStatus;
+    input?: unknown;
+    output?: unknown;
+    /** MCP CallToolResult.content, rendered structurally when present */
+    contentBlocks?: THarnessContentBlock[];
+    /** MCP CallToolResult.structuredContent */
+    structuredContent?: unknown;
+    /** MCP CallToolResult.isError */
+    isError?: boolean;
+    errorText?: string;
+    mcp?: IHarnessMcpMeta;
+    /** epoch ms */
+    startedAt?: number;
+    finishedAt?: number;
+}
+export interface IHarnessPermissionRequest {
+    id: string;
+    sessionId?: string;
+    /** epoch ms */
+    createdAt?: number;
+    title: string;
+    /** open set; well-known values today: write | delete | shell | browser */
+    type: string;
+    metadata?: Record<string, unknown>;
+}
+export type THarnessPermissionResponse = 'once' | 'always' | 'reject';
+export interface IHarnessPermissionResponseDetail {
+    requestId: string;
+    response: THarnessPermissionResponse;
+    remember: boolean;
+    request: IHarnessPermissionRequest;
+}
+export interface IHarnessSessionMeta {
+    id: string;
+    title: string;
+    createdAt?: number;
+    updatedAt?: number;
+    messageCount?: number;
+    preview?: string;
+}
+export type THarnessTodoStatus = 'pending' | 'in_progress' | 'completed';
+export interface IHarnessTodoItem {
+    id?: string;
+    content: string;
+    status: THarnessTodoStatus;
+}
+export interface IHarnessStatus {
+    type: 'idle' | 'busy' | 'error';
+    message?: string;
+}
+export interface IHarnessComposerSendDetail {
+    text: string;
+    attachments: IHarnessAttachment[];
+    model?: string;
+    reasoningEffort?: string;
+}
+/**
+ * Incremental updates for the `applyDelta()` fast path. Deltas mutate the
+ * message object already held in `.messages` (so a later full property
+ * re-assignment is idempotent) and re-render only the affected message
+ * element.
+ */
+export type THarnessStreamDelta = {
+    type: 'text';
+    messageId: string;
+    delta: string;
+} | {
+    type: 'reasoning-start';
+    messageId: string;
+    partId: string;
+    startedAt?: number;
+} | {
+    type: 'reasoning';
+    messageId: string;
+    partId: string;
+    delta: string;
+} | {
+    type: 'reasoning-end';
+    messageId: string;
+    partId: string;
+    endedAt?: number;
+} | {
+    type: 'tool-update';
+    messageId: string;
+    tool: Partial<IHarnessToolCall> & {
+        id: string;
+    };
+} | {
+    type: 'message-end';
+    messageId: string;
+    usage?: IHarnessUsage;
+    error?: string;
+};

package/dist_ts_web/elements/00group-harness/interfaces.js

@@ -0,0 +1,11 @@
+/**
+ * Normalized data contract for the harness (agentic chat) component group.
+ *
+ * Producers vary widely — smartagent callbacks, IDE runtime wire models,
+ * OpenCode-style part arrays, raw MCP results — so these interfaces define
+ * the ONE shape the components render. Consumers adapt their runtime's
+ * events into these types; everything here is plain data (no DOM, no
+ * framework types) so adapters can live anywhere.
+ */
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzX3dlYi9lbGVtZW50cy8wMGdyb3VwLWhhcm5lc3MvaW50ZXJmYWNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7R0FRRyJ9

package/dist_ts_web/elements/00group-harness/toolregistry.d.ts

@@ -0,0 +1,76 @@
+import type { TemplateResult } from '@design.estate/dees-element';
+import type { IHarnessToolCall, THarnessContentBlock } from './interfaces.js';
+/**
+ * Render helpers handed to tool body renderers. Implemented by
+ * dees-harness-tool-card (which owns the templates); typed here so custom
+ * descriptors can be authored against a stable surface.
+ */
+export interface IHarnessToolRenderHelpers {
+    /** highlighted code block (dees-dataview-codebox) with optional filename */
+    codeBlock(code: string, language?: string, filename?: string): TemplateResult;
+    /** before/after diff (dees-dataview-codebox diff mode) */
+    diffBlock(before: string, after: string, options?: {
+        language?: string;
+        filename?: string;
+        view?: 'inline' | 'split';
+    }): TemplateResult;
+    /** plain monospace block with truncation + expand */
+    monoBlock(text: string, options?: {
+        maxChars?: number;
+        tone?: 'default' | 'error';
+    }): TemplateResult;
+    /** two-column key/value summary */
+    keyValues(pairs: Array<[string, string]>): TemplateResult;
+    /** MCP content blocks (dees-harness-content-blocks) */
+    contentBlocks(blocks: THarnessContentBlock[]): TemplateResult;
+    /** constrained inline image from base64 */
+    image(dataBase64: string, mimeType: string, alt?: string): TemplateResult;
+}
+export interface IHarnessToolDescriptor {
+    /** stable kind id, e.g. 'terminal', 'file-read', 'mcp', 'unknown' */
+    kind: string;
+    /** exact raw-name matches (fast path); lowercased on registration */
+    names?: string[];
+    /** fallback matcher when no name matched */
+    match?: (call: IHarnessToolCall) => boolean;
+    label: string | ((call: IHarnessToolCall) => string);
+    /** lucide icon spec, e.g. 'lucide:Terminal' */
+    icon: string;
+    subtitle?: (call: IHarnessToolCall) => string;
+    /**
+     * Custom body renderer. Built-in kinds leave this unset — the tool card
+     * ships body templates for them — so descriptors stay DOM-free unless a
+     * consumer wants a bespoke body.
+     */
+    renderBody?: (call: IHarnessToolCall, helpers: IHarnessToolRenderHelpers) => TemplateResult;
+    defaultExpanded?: boolean | ((call: IHarnessToolCall) => boolean);
+    /** styles the card with a destructive accent regardless of status */
+    destructive?: boolean;
+}
+/** Splits smartagent's MCP namespacing convention `server__tool`. */
+export declare const parseMcpName: (rawName: string) => {
+    serverName: string;
+    toolName: string;
+} | undefined;
+/**
+ * Maps raw tool calls to render descriptors. A pre-seeded singleton covers
+ * the built-in and MCP conventions; apps register custom tools once at boot
+ * (`DeesHarnessToolRegistry.default.register(...)`) or hand an isolated
+ * `fork()` to individual elements via their `.toolRegistry` property.
+ */
+export declare class DeesHarnessToolRegistry {
+    static readonly default: DeesHarnessToolRegistry;
+    private descriptors;
+    private byName;
+    private byKind;
+    constructor(seedDescriptors?: IHarnessToolDescriptor[]);
+    /** Registers (or replaces, by kind) a descriptor. Later wins on names. */
+    register(descriptor: IHarnessToolDescriptor): this;
+    unregister(kind: string): this;
+    descriptorForKind(kind: string): IHarnessToolDescriptor | undefined;
+    /** Never returns undefined — falls back to the 'unknown' descriptor. */
+    resolve(call: IHarnessToolCall): IHarnessToolDescriptor;
+    resolveKind(name: string): string;
+    /** Isolated copy for demos, tests, or per-pane toolsets. */
+    fork(): DeesHarnessToolRegistry;
+}