@ai-ecoverse/slicc-spectrum 1.0.0 → 1.2.0

package/dist/types/model/types.d.ts

@@ -0,0 +1,455 @@
+import type { TerminalBackend } from '../backend.js';
+import type { Subscribable } from './emitter.js';
+export type AgentKind = 'cone' | 'scoop';
+export type AgentStatus = 'idle' | 'thinking' | 'working' | 'waiting' | 'error';
+export interface Agent {
+    id: string;
+    name: string;
+    kind: AgentKind;
+    parentId: string | null;
+    status: AgentStatus;
+    model: string;
+    contextFill: number;
+    unread: number;
+}
+export type ToolStatus = 'running' | 'done' | 'error' | 'cancelled';
+export interface ToolCall {
+    id: string;
+    name: string;
+    title: string;
+    input: string;
+    output: string;
+    status: ToolStatus;
+    paths: string[];
+    image?: string;
+}
+export type AttachmentKind = 'image' | 'text' | 'file' | 'secret';
+export interface Attachment {
+    id: string;
+    name: string;
+    kind: AttachmentKind;
+    mimeType: string;
+    size: number;
+    url?: string;
+    text?: string;
+    path?: string;
+    error?: string;
+}
+export type MediaKind = 'image' | 'video' | 'audio';
+export interface Media {
+    kind: MediaKind;
+    src: string;
+    alt: string;
+    poster?: string;
+    width?: number;
+    height?: number;
+}
+export type CardTone = 'neutral' | 'informative' | 'positive' | 'notice' | 'negative';
+export type ActionCard = {
+    variant: 'tool';
+    title: string;
+    badge: string;
+    status: string;
+    files: string[];
+    tone: CardTone;
+} | {
+    variant: 'pr';
+    number: number;
+    title: string;
+    branch: string;
+    checks: string;
+    additions: number;
+    deletions: number;
+    files: number;
+    tone: CardTone;
+} | {
+    variant: 'light';
+    title: string;
+    detail: string;
+    tone: CardTone;
+};
+export type QuestionKind = 'yes-no' | 'choice' | 'text' | 'number' | 'date' | 'email';
+export type QuestionState = 'open' | 'answered' | 'inert';
+export interface Question {
+    id: string;
+    kind: QuestionKind;
+    question: string;
+    options: string[];
+    state: QuestionState;
+    answer?: string;
+}
+export type DelegationKind = 'feed' | 'scoop' | 'drop' | 'sprinkle';
+export type ErrorAction = 'retry' | 'settings' | 'change-model' | 'login';
+export interface CheckItem {
+    text: string;
+    tone?: CardTone;
+}
+export type MessagePart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'thinking';
+    text: string;
+} | {
+    type: 'tool';
+    tool: ToolCall;
+} | {
+    type: 'media';
+    items: Media[];
+} | {
+    type: 'card';
+    card: ActionCard;
+} | {
+    type: 'plan';
+    items: string[];
+} | {
+    type: 'check';
+    items: CheckItem[];
+} | {
+    type: 'diff';
+    path: string;
+    before: string | null;
+    after: string | null;
+} | {
+    type: 'question';
+    question: Question;
+} | {
+    type: 'delegation';
+    kind: DelegationKind;
+    scoop: string;
+    text: string;
+} | {
+    type: 'link';
+    url: string;
+    title: string;
+    description: string;
+} | {
+    type: 'error';
+    message: string;
+    action?: ErrorAction;
+};
+export type SendMode = 'send' | 'steer' | 'queue';
+export interface UserMessage {
+    id: string;
+    role: 'user';
+    text: string;
+    createdAt: number;
+    attachments?: Attachment[];
+    mode?: SendMode;
+    queued?: boolean;
+    from?: string;
+}
+export type AssistantStatus = 'streaming' | 'done' | 'stopped' | 'error';
+export interface Usage {
+    input: number;
+    output: number;
+    cost: number;
+}
+export interface AssistantMessage {
+    id: string;
+    role: 'assistant';
+    parts: MessagePart[];
+    status: AssistantStatus;
+    createdAt: number;
+    model?: string;
+    usage?: Usage;
+}
+export type SystemKind = 'compaction' | 'error' | 'notice';
+export type CompactionState = 'summarizing' | 'summarized' | 'fallback' | 'discarded';
+export interface SystemMessage {
+    id: string;
+    role: 'system';
+    kind: SystemKind;
+    text: string;
+    createdAt: number;
+    title?: string;
+    trigger?: 'threshold' | 'overflow' | 'idle' | 'manual';
+    state?: CompactionState;
+    action?: ErrorAction;
+}
+export interface ToolMessage {
+    id: string;
+    role: 'tool';
+    tool: ToolCall;
+    createdAt: number;
+}
+export type LickChannel = 'webhook' | 'cron' | 'sprinkle' | 'fswatch' | 'session-reload' | 'navigate' | 'discovery' | 'upgrade' | 'workflow' | 'bash' | 'jshd' | 'preview' | 'cherry' | 'scoop-notify' | 'scoop-idle' | 'scoop-wait' | 'sudo-request';
+export type LickState = 'pending' | 'confirmed' | 'dismissed';
+export interface LickMessage {
+    id: string;
+    role: 'lick';
+    channel: LickChannel;
+    title: string;
+    text: string;
+    createdAt: number;
+    body?: string;
+    count?: number;
+    state?: LickState;
+}
+export type Message = UserMessage | AssistantMessage | SystemMessage | ToolMessage | LickMessage;
+export interface Outgoing {
+    text: string;
+    attachments?: Attachment[];
+    mode?: SendMode;
+}
+export interface AgentEvents {
+    agents: readonly Agent[];
+    active: string;
+    message: {
+        agentId: string;
+        message: Message;
+    };
+    messages: string;
+    frozen: readonly FrozenCone[];
+}
+export interface AgentPort extends Subscribable<AgentEvents> {
+    list(): readonly Agent[];
+    active(): string;
+    select(id: string): void;
+    messages(agentId: string): readonly Message[];
+    send(agentId: string, input: string | Outgoing): Promise<void>;
+    stop(agentId: string): void;
+    busy(agentId: string): boolean;
+    queue(agentId: string): readonly UserMessage[];
+    unqueue(agentId: string, messageId: string): void;
+    suggestion(agentId: string): string | null;
+    answer(agentId: string, questionId: string, answer: string): void;
+    resolveLick(agentId: string, messageId: string, state: Exclude<LickState, 'pending'>): void;
+    compact(agentId: string): void;
+    clear(agentId: string): void;
+    setModel(agentId: string, model: string): void;
+    createScoop(parentId: string, name: string): Agent;
+    frozen(): readonly FrozenCone[];
+    freeze(agentId: string): void;
+    thaw(id: string): Agent | null;
+    discard(id: string): void;
+}
+export interface FrozenCone {
+    id: string;
+    name: string;
+    title: string;
+    model: string;
+    messages: number;
+    frozenAt: number;
+}
+export type FileKind = 'file' | 'directory';
+export interface FileEntry {
+    path: string;
+    kind: FileKind;
+    size: number;
+    modified: number;
+}
+export type ChangeStatus = 'added' | 'modified' | 'deleted';
+export interface Change {
+    path: string;
+    status: ChangeStatus;
+    before: string | null;
+    after: string | null;
+    agentId: string | null;
+}
+export interface FileEvents {
+    files: readonly FileEntry[];
+    file: string;
+    changes: readonly Change[];
+}
+export interface FilePort extends Subscribable<FileEvents> {
+    list(): Promise<readonly FileEntry[]>;
+    read(path: string): Promise<string>;
+    write(path: string, text: string, agentId?: string | null): Promise<void>;
+    remove(path: string, agentId?: string | null): Promise<void>;
+    changes(): readonly Change[];
+    accept(path: string): void;
+    revert(path: string): Promise<void>;
+}
+export interface TerminalInfo {
+    id: string;
+    title: string;
+    cwd: string;
+    agentId: string | null;
+}
+export interface TerminalEvents {
+    terminals: readonly TerminalInfo[];
+}
+export interface TerminalPort extends Subscribable<TerminalEvents> {
+    list(): readonly TerminalInfo[];
+    open(options?: {
+        cwd?: string;
+        agentId?: string | null;
+    }): TerminalInfo;
+    close(id: string): void;
+    backend(id: string): TerminalBackend;
+}
+export type TabStatus = 'loading' | 'complete';
+export interface BrowserTab {
+    id: string;
+    title: string;
+    url: string;
+    status: TabStatus;
+    agentId: string | null;
+}
+export interface BrowserEvents {
+    tabs: readonly BrowserTab[];
+    active: string | null;
+}
+export interface BrowserPort extends Subscribable<BrowserEvents> {
+    list(): readonly BrowserTab[];
+    active(): string | null;
+    activate(id: string): void;
+    open(url: string, agentId?: string | null): BrowserTab;
+    navigate(id: string, url: string): void;
+    close(id: string): void;
+    screenshot(id: string): Promise<string>;
+}
+export type ColorScheme = 'light' | 'dark' | 'system';
+export type Thinking = 'off' | 'low' | 'medium' | 'high';
+export interface Settings {
+    color: ColorScheme;
+    model: string;
+    thinking: Thinking;
+    sendOnEnter: boolean;
+    showThinking: boolean;
+    diffStyle: 'unified' | 'split';
+}
+export type AccountStatus = 'connected' | 'expired' | 'disconnected';
+export interface Account {
+    id: string;
+    provider: string;
+    identity: string;
+    status: AccountStatus;
+}
+export interface ModelOption {
+    id: string;
+    label: string;
+    provider: string;
+}
+export interface SettingsEvents {
+    settings: Settings;
+    accounts: readonly Account[];
+}
+export interface SettingsPort extends Subscribable<SettingsEvents> {
+    get(): Settings;
+    update(patch: Partial<Settings>): void;
+    models(): readonly ModelOption[];
+    accounts(): readonly Account[];
+    connect(id: string): Promise<void>;
+    disconnect(id: string): void;
+}
+export type MemoryTag = 'user' | 'feedback' | 'project';
+export interface Memory {
+    id: string;
+    scope: string;
+    section: string;
+    title: string;
+    body: string;
+    tag: MemoryTag | null;
+    updatedAt: number;
+}
+export type MemoryDraft = Omit<Memory, 'id' | 'updatedAt'> & {
+    id?: string;
+};
+export interface MemoryEvents {
+    memories: readonly Memory[];
+}
+export interface MemoryPort extends Subscribable<MemoryEvents> {
+    list(): readonly Memory[];
+    save(memory: MemoryDraft): Memory;
+    remove(id: string): void;
+}
+export type MonitorStatus = 'active' | 'idle' | 'warn' | 'error';
+export interface MonitorVital {
+    id: string;
+    label: string;
+    value: string;
+    unit?: string;
+    delta?: string;
+    series?: number[];
+    ratio?: number;
+}
+export interface MonitorRow {
+    name: string;
+    meta: string;
+    status: MonitorStatus;
+    badges?: string[];
+}
+export interface MonitorSection {
+    id: string;
+    label: string;
+    rows: MonitorRow[];
+}
+export interface MonitorAlert {
+    id: string;
+    title: string;
+    detail: string;
+    severity: 'warn' | 'error';
+}
+export interface MonitorSnapshot {
+    vitals: MonitorVital[];
+    alerts: MonitorAlert[];
+    sections: MonitorSection[];
+    updatedAt: number;
+}
+export interface MonitorEvents {
+    snapshot: MonitorSnapshot;
+}
+export interface MonitorPort extends Subscribable<MonitorEvents> {
+    snapshot(): MonitorSnapshot;
+    resync(): void;
+}
+export interface Sprinkle {
+    id: string;
+    name: string;
+    title: string;
+    icon: string;
+    agentId: string;
+    html: string;
+}
+export interface SprinkleEvents {
+    sprinkles: readonly Sprinkle[];
+}
+export interface SprinklePort extends Subscribable<SprinkleEvents> {
+    list(): readonly Sprinkle[];
+    send(id: string, payload: unknown): void;
+}
+export type TrayConnection = 'offline' | 'connecting' | 'live' | 'stalled' | 'reconnecting' | 'error';
+export type FloatKind = 'npx' | 'sliccstart' | 'extension' | 'standalone' | 'cherry' | 'electron' | 'hosted';
+export type TrayRole = 'none' | 'leader' | 'follower';
+export interface Follower {
+    id: string;
+    name: string;
+    device: 'browser' | 'phone' | 'extension';
+    since: number;
+}
+export interface TrayStatus {
+    name: string;
+    kind: FloatKind;
+    connection: TrayConnection;
+    role: TrayRole;
+    followers: Follower[];
+    spent: number;
+    rate: number;
+    budget: {
+        percent: number;
+        window: 'daily' | 'weekly' | 'monthly';
+        resets: string;
+    };
+    joinUrl: string;
+}
+export interface TrayEvents {
+    status: TrayStatus;
+}
+export interface TrayPort extends Subscribable<TrayEvents> {
+    status(): TrayStatus;
+    reconnect(): void;
+    disconnect(): void;
+}
+export interface SliccModel {
+    agent: AgentPort;
+    files: FilePort;
+    terminals: TerminalPort;
+    browser: BrowserPort;
+    settings: SettingsPort;
+    memory: MemoryPort;
+    monitor: MonitorPort;
+    sprinkles: SprinklePort;
+    tray: TrayPort;
+}

package/dist/types/ui.d.ts

@@ -0,0 +1,23 @@
+import './app/spectrum.ts';
+import { SliccAgents } from './app/agents.js';
+import { SliccApp } from './app/app.js';
+import { SliccBrowser } from './app/browser.js';
+import { SliccChanges, SliccDiffPanel } from './app/changes.js';
+import { SliccChat } from './app/chat.js';
+import { SliccComposer } from './app/composer.js';
+import { SliccFiles, SliccFileView } from './app/files.js';
+import { SliccCodeView, SliccDiffView } from './components/code-view.js';
+import { SliccDock } from './components/dock.js';
+import { SliccFileTree } from './components/file-tree.js';
+export type { Color } from './app/base.js';
+export { resolveColor } from './app/base.js';
+export type { Placement, Surface } from './app/panels.js';
+export { surfaces } from './app/panels.js';
+export type { CodeColor, DiffStyle } from './components/code-view.js';
+export type { PanelFactory, PanelParams } from './components/dock.js';
+export type { GitStatusEntry } from './components/file-tree.js';
+export type { Listener, Subscribable } from './model/emitter.js';
+export { Emitter } from './model/emitter.js';
+export type * from './model/types.js';
+export { SliccAgents, SliccApp, SliccBrowser, SliccChanges, SliccChat, SliccCodeView, SliccComposer, SliccDiffPanel, SliccDiffView, SliccDock, SliccFiles, SliccFileTree, SliccFileView, };
+export declare function define(): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-ecoverse/slicc-spectrum",
-  "version": "1.0.0",
-  "description": "A terminal web component for SLICC, built on wterm, that talks to slicc-kernel",
+  "version": "1.2.0",
+  "description": "Web components for SLICC on Spectrum Web Components: the terminal, the app shell and its surfaces",
   "type": "module",
   "license": "Apache-2.0",
   "repository": {
@@ -25,6 +25,14 @@
     ".": {
       "types": "./dist/types/index.d.ts",
       "default": "./dist/slicc-terminal.js"
+    },
+    "./ui": {
+      "types": "./dist/types/ui.d.ts",
+      "default": "./dist/slicc-ui.js"
+    },
+    "./dummy": {
+      "types": "./dist/types/dummy.d.ts",
+      "default": "./dist/slicc-dummy.js"
     }
   },
   "files": [
@@ -37,29 +45,44 @@
     "trust": "npx fledgling sync -y --skip-publish",
     "trust:dry": "npx fledgling sync --dry-run -y --skip-publish",
     "release": "semantic-release",
-    "start": "npm run build && node test/integration/server.mjs",
+    "start": "npm run build && node test/integration/chrome.mjs",
     "pretest": "npm run build && playwright-core install --no-shell chromium",
-    "test": "node --test --test-global-setup=test/integration/global.mjs 'test/integration/*.test.mjs'",
-    "test:unit": "NODE_NO_WARNINGS=1 mcr -c mcr.config.mjs node --test 'test/unit/**/*.test.mjs'",
-    "coverage:staged": "npm run --silent test:unit && uvx diff-cover@10.6.0 coverage/unit/lcov.info --compare-branch HEAD --ignore-unstaged --fail-under 100",
+    "test": "node --test --test-global-setup=node_modules/@ai-ecoverse/slicc-shared-web/harness/global.mjs 'test/integration/*.test.mjs'",
+    "test:unit": "NODE_NO_WARNINGS=1 mcr -c node_modules/@ai-ecoverse/slicc-shared-web/mcr.config.mjs node --test 'test/unit/**/*.test.mjs'",
     "typecheck": "tsc",
-    "lint": "biome check . && npm run typecheck && npm run lint:comments && npm run lint:no-unit-tests",
-    "lint:comments": "d=node_modules/.cache/no-comment-9cc7617; [ -f $d/check.mjs ] || { mkdir -p $d && for f in lib comments marker check; do curl -fsSL -o $d/$f.mjs https://raw.githubusercontent.com/ai-ecoverse/slicc/9cc7617c94c24b84c4d6fd8edf92441378257d07/packages/dev-tools/no-comment/$f.mjs || exit 1; done; } && node $d/check.mjs --force",
-    "lint:no-unit-tests": "! git ls-files --cached --others --exclude-standard | grep -E '(^|/)(tests?|__tests__)/|\\.(test|spec)\\.' | grep -vE '^test/integration/'",
+    "lint": "slicc-lint",
     "format": "biome check --write ."
   },
   "devDependencies": {
-    "@ai-ecoverse/slicc-kernel": "1.1.0",
+    "@ai-ecoverse/slicc-kernel": "1.7.2",
+    "@ai-ecoverse/slicc-shared-web": "1.4.1",
     "@ai-ecoverse/wasm-bash": "5.3.0-7",
     "@ai-ecoverse/wasm-coreutils": "9.7.0-3",
     "@biomejs/biome": "2.5.15",
+    "@fontsource/source-code-pro": "5.3.0",
     "@happy-dom/global-registrator": "20.14.5",
+    "@pierre/diffs": "1.5.1",
+    "@pierre/trees": "1.0.0-beta.6",
+    "@spectrum-web-components/action-button": "1.12.4",
+    "@spectrum-web-components/action-group": "1.12.4",
+    "@spectrum-web-components/action-menu": "1.12.4",
+    "@spectrum-web-components/badge": "1.12.4",
+    "@spectrum-web-components/button": "1.12.4",
+    "@spectrum-web-components/icons-workflow": "1.12.4",
+    "@spectrum-web-components/menu": "1.12.4",
+    "@spectrum-web-components/picker": "1.12.4",
+    "@spectrum-web-components/progress-circle": "1.12.4",
+    "@spectrum-web-components/search": "1.12.4",
+    "@spectrum-web-components/switch": "1.12.4",
+    "@spectrum-web-components/textfield": "1.12.4",
+    "@spectrum-web-components/theme": "1.12.4",
     "@types/node": "26.6.4",
     "@wterm/core": "0.5.4",
     "@wterm/dom": "0.5.4",
+    "dockview-core": "8.4.0",
     "esbuild": "0.28.2",
     "happy-dom": "20.14.5",
-    "lefthook": "2.1.16",
+    "lefthook": "2.1.17",
     "monocart-coverage-reports": "2.13.0",
     "playwright-core": "1.63.0",
     "semantic-release": "25.0.9",