@ai-ecoverse/slicc-spectrum 1.58.2 → 1.59.0

package/dist/types/app/app.d.ts

@@ -3,6 +3,7 @@ import type { SliccDock } from '../components/dock.js';
 import type { SliccModel } from '../model/types.js';
 import { ThemedElement } from './base.js';
 import { Dips } from './dips.js';
+import { Panels } from './panel-command.js';
 import { type DocumentKind, type ScreenClass, type Surface } from './panels.js';
 import { TerminalPanels } from './terminals.js';
 export declare function changeCount(count: number): string;
@@ -33,6 +34,7 @@ export declare class SliccApp extends ThemedElement {
     layoutKey: string;
     readonly dips: Dips;
     readonly terminalPanels: TerminalPanels;
+    readonly panels: Panels;
     constructor();
     static styles: import("lit").CSSResult[];
     get dock(): SliccDock;

package/dist/types/app/base.d.ts

@@ -20,6 +20,11 @@ export declare class ModelElement extends LitElement {
 export declare function changesOf(model: SliccModel): ChangesPort;
 export type Color = 'light' | 'dark';
 export declare function resolveColor(scheme: ColorScheme, prefersDark: boolean): Color;
+export interface DocumentHold {
+    paint(color: Color): void;
+    release(): void;
+}
+export declare function holdDocument(doc: Document): DocumentHold;
 export declare class ThemedElement extends ModelElement {
     #private;
     get color(): Color;

package/dist/types/app/chat.d.ts

@@ -24,5 +24,6 @@ export declare class SliccChat extends ThemedElement {
     disconnectedCallback(): void;
     protected firstUpdated(): void;
     focus(): void;
+    get busyReason(): string | null;
     render(): TemplateResult;
 }

package/dist/types/app/panel-command.d.ts

@@ -0,0 +1,71 @@
+import type { SliccDock } from '../components/dock.js';
+import type { Agent, SliccModel, Sprinkle } from '../model/types.js';
+import { type Direction, type ScreenClass, type Side, type Surface } from './panels.js';
+export type PanelKind = 'surface' | 'chat' | 'terminal' | 'sprinkle' | 'file' | 'diff';
+export interface PanelInfo {
+    id: string;
+    title: string;
+    kind: PanelKind;
+    side: Side;
+    agent: string | null;
+    open: boolean;
+    visible: boolean;
+    active: boolean;
+    busy: string | null;
+}
+export type PanelPlace = Side | {
+    direction: Direction;
+    ref: string;
+};
+export interface PanelResult {
+    code: 0 | 1 | 2 | 5;
+    message: string;
+}
+export interface PanelOpenOptions {
+    place?: PanelPlace;
+    section?: string;
+}
+export interface PanelsHost {
+    dock(): SliccDock;
+    screen(): ScreenClass;
+    model(): SliccModel | null | undefined;
+    surfaces(): readonly Surface[];
+    sprinkles(): readonly Sprinkle[];
+    open(id: string, focus: boolean, section?: string): void;
+    reset(): void;
+    typing(): boolean;
+}
+export interface PanelCaller {
+    agentId: string | null;
+    cone?: string | null;
+    readOnly?: boolean;
+}
+export interface PanelOutput {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+export declare class Panels {
+    #private;
+    constructor(host: PanelsHost);
+    quietly<T>(run: () => T): T;
+    closed(id: string): void;
+    closedAgo(id: string): number | null;
+    recentClose(): {
+        id: string;
+        ago: number;
+    } | null;
+    typing(): boolean;
+    agents(): readonly Agent[];
+    active(): string | null;
+    list(): PanelInfo[];
+    find(id: string): PanelInfo | undefined;
+    open(id: string, options?: PanelOpenOptions): PanelResult;
+    focus(id: string, options?: PanelOpenOptions): PanelResult;
+    close(id: string): PanelResult;
+    move(id: string, place: PanelPlace): PanelResult;
+    reset(): PanelResult;
+}
+export declare function panelCommand(app: {
+    panels: Panels;
+}, argv: readonly string[], caller: PanelCaller): PanelOutput;

package/dist/types/app/panels.d.ts

@@ -32,7 +32,8 @@ export declare function screenClass(width: number): ScreenClass;
 export declare function surface(id: string, items?: readonly Surface[]): Surface | undefined;
 export declare function create(tag: string, model: SliccModel, params?: PanelParams): HTMLElement;
 export declare function placement(dock: SliccDock, side: Side, screen: ScreenClass): Placement;
-export declare function openSurface(dock: SliccDock, item: Surface, screen: ScreenClass): void;
+export declare function destination(dock: SliccDock, id: string, side: Side, screen: ScreenClass): Placement;
+export declare function openSurface(dock: SliccDock, item: Surface, screen: ScreenClass, focus?: boolean): void;
 export declare function chatId(agentId: string): string;
 export declare function chatAgent(id: string | null | undefined): string | null;
 export declare function chats(dock: SliccDock): string[];
@@ -40,7 +41,7 @@ export declare function openChat(dock: SliccDock, agent: {
     id: string;
     name: string;
 }, screen: ScreenClass, focus?: boolean, reveal?: boolean): string;
-export declare function openDocument(dock: SliccDock, kind: DocumentKind, path: string, screen: ScreenClass): string;
+export declare function openDocument(dock: SliccDock, kind: DocumentKind, path: string, screen: ScreenClass, focus?: boolean): string;
 export declare function terminalPanel(terminal: string): string;
 export declare function terminalOf(id: string | null | undefined): string | null;
 export declare function terminalPanels(dock: SliccDock): string[];
@@ -53,4 +54,4 @@ export declare function defaultLayout(dock: SliccDock, screen: ScreenClass, agen
 export declare function shown(dock: SliccDock, id: string): boolean;
 export declare function sprinkleSurface(sprinkle: Sprinkle): Surface;
 export declare function dropPlacement(panel: string | null, position: string): Placement | null;
-export declare function openSprinkle(dock: SliccDock, sprinkle: Sprinkle, screen: ScreenClass, place?: Placement | null): string;
+export declare function openSprinkle(dock: SliccDock, sprinkle: Sprinkle, screen: ScreenClass, place?: Placement | null, focus?: boolean): string;

package/dist/types/app/settings.d.ts

@@ -31,5 +31,6 @@ export declare class SliccSettings extends ModelElement {
     protected subscribe(model: SliccModel): Array<() => void>;
     focus(): void;
     connect(id: string, secret?: string): Promise<void>;
+    get busyReason(): string | null;
     render(): TemplateResult;
 }

package/dist/types/app/updates.d.ts

@@ -38,6 +38,7 @@ export declare class SliccUpdates extends ModelElement {
     busy: ReadonlyMap<string, PackageAction>;
     problems: Failures;
     constructor();
+    get busyReason(): string | null;
     static styles: import("lit").CSSResult[];
     protected subscribe(model: SliccModel): Array<() => void>;
     focus(): void;

package/dist/types/dummy/settings.d.ts

@@ -1,9 +1,10 @@
 import { Emitter } from '../model/emitter.js';
 import type { Account, ModelOption, Settings, SettingsEvents, SettingsPort } from '../model/types.js';
 import type { Clock } from './clock.js';
+export declare const dummySettingsKey = "slicc-ui.settings";
 export declare class DummySettings extends Emitter<SettingsEvents> implements SettingsPort {
     #private;
-    constructor(defaults: Settings, models: readonly ModelOption[], accounts: readonly Account[], storage: Storage | null, clock: Clock);
+    constructor(defaults: Settings, models: readonly ModelOption[], accounts: readonly Account[], storage: Storage | null, clock: Clock, keys?: readonly string[]);
     get(): Settings;
     update(patch: Partial<Settings>): void;
     models(): readonly ModelOption[];

package/dist/types/kernel/index.d.ts

@@ -13,5 +13,6 @@ export interface KernelModel extends SliccModel {
     files: KernelFiles;
     terminals: KernelTerminals;
 }
+export declare const settingsKey = "slicc-agent.settings";
 export declare function idleModel(storage?: Storage | null): Omit<SliccModel, 'files' | 'terminals'>;
 export declare function createKernelModel({ kernel, root, files, terminals, storage, }: KernelModelOptions): KernelModel;

package/dist/types/kernel.d.ts

@@ -2,6 +2,6 @@ export type { KernelFilesOptions } from './kernel/files.js';
 export { KernelFiles } from './kernel/files.js';
 export { IdleAgent, IdleBrowser, IdleMemory, IdleMonitor, IdleSprinkles, IdleTray, } from './kernel/idle.js';
 export type { KernelModel, KernelModelOptions } from './kernel/index.js';
-export { createKernelModel, idleModel } from './kernel/index.js';
+export { createKernelModel, idleModel, settingsKey } from './kernel/index.js';
 export type { KernelTerminalsOptions } from './kernel/terminals.js';
 export { KernelTerminals } from './kernel/terminals.js';

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

@@ -521,7 +521,7 @@ export type TrayRole = 'none' | 'leader' | 'follower';
 export interface Follower {
     id: string;
     name: string;
-    device: 'browser' | 'phone' | 'extension';
+    device: 'browser' | 'phone' | 'extension' | 'cli';
     since: number;
 }
 export interface TrayBudget {

package/dist/types/ui.d.ts

@@ -21,6 +21,8 @@ export type { ConfirmOptions, ConfirmVariant, PromptOptions } from './app/confir
 export { confirm, prompt } from './app/confirm.js';
 export type { GrammarKind } from './app/grammars.js';
 export { grammarBase, setGrammarBase } from './app/grammars.js';
+export type { PanelCaller, PanelInfo, PanelKind, PanelOpenOptions, PanelOutput, PanelPlace, PanelResult, PanelsHost, } from './app/panel-command.js';
+export { Panels, panelCommand } from './app/panel-command.js';
 export type { Placement, Surface } from './app/panels.js';
 export { surfaces } from './app/panels.js';
 export type { CodeColor, DiffStyle } from './components/code-view.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-spectrum",
-  "version": "1.58.2",
+  "version": "1.59.0",
   "description": "Web components for SLICC on Spectrum Web Components: the terminal, the app shell and its surfaces",
   "type": "module",
   "license": "Apache-2.0",
@@ -72,8 +72,8 @@
   "devDependencies": {
     "@adobe/spectrum-wc": "2.0.0-beta.4",
     "@adobe/spectrum-wc-icons": "2.0.0-beta.4",
-    "@ai-ecoverse/slicc-kernel": "1.61.0",
-    "@ai-ecoverse/slicc-shared-web": "1.12.3",
+    "@ai-ecoverse/slicc-kernel": "1.64.0",
+    "@ai-ecoverse/slicc-shared-web": "1.13.0",
     "@ai-ecoverse/wasm-bash": "5.3.0-17",
     "@ai-ecoverse/wasm-coreutils": "9.7.0-3",
     "@biomejs/biome": "2.5.15",

package/dist/chunk-IHW76JXM.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/dummy/clock.ts", "../src/dummy/settings.ts"],
-  "sourcesContent": ["export interface Clock {\n  delay: number;\n  sleep(ticks?: number): Promise<void>;\n}\n\nexport function clock(delay: number): Clock {\n  return {\n    delay,\n    sleep: (ticks = 1) => new Promise((resolve) => setTimeout(resolve, delay * ticks)),\n  };\n}\n", "import { Emitter } from '../model/emitter.ts';\nimport type {\n  Account,\n  AccountStatus,\n  ModelOption,\n  Settings,\n  SettingsEvents,\n  SettingsPort,\n} from '../model/types.ts';\nimport type { Clock } from './clock.ts';\n\nconst key = 'slicc-ui.settings';\n\nexport class DummySettings extends Emitter<SettingsEvents> implements SettingsPort {\n  #settings: Settings;\n  #accounts: Account[];\n  #models: readonly ModelOption[];\n  #storage: Storage | null;\n  #clock: Clock;\n  #signIns = new Map<string, { before: AccountStatus; stop: () => void }>();\n\n  constructor(\n    defaults: Settings,\n    models: readonly ModelOption[],\n    accounts: readonly Account[],\n    storage: Storage | null,\n    clock: Clock\n  ) {\n    super();\n    this.#storage = storage;\n    this.#clock = clock;\n    this.#models = models;\n    this.#accounts = accounts.map((account) => ({ ...account }));\n    this.#settings = { ...defaults, ...this.#load() };\n  }\n\n  #load(): Partial<Settings> {\n    try {\n      return JSON.parse(this.#storage?.getItem(key) ?? '{}');\n    } catch {\n      return {};\n    }\n  }\n\n  get(): Settings {\n    return { ...this.#settings };\n  }\n\n  update(patch: Partial<Settings>): void {\n    this.#settings = { ...this.#settings, ...patch };\n    this.#storage?.setItem(key, JSON.stringify(this.#settings));\n    this.emit('settings', this.get());\n  }\n\n  models(): readonly ModelOption[] {\n    return this.#models;\n  }\n\n  accounts(): readonly Account[] {\n    return this.#accounts.map((account) => ({ ...account }));\n  }\n\n  #set(id: string, patch: Partial<Account>): void {\n    this.#accounts = this.#accounts.map((account) =>\n      account.id === id ? { ...account, ...patch } : account\n    );\n    this.emit('accounts', this.accounts());\n  }\n\n  async connect(id: string, secret?: string): Promise<void> {\n    const account = this.#accounts.find((candidate) => candidate.id === id);\n    if (account && account.auth !== 'api-key' && !(await this.#signIn(account))) return;\n    if (account?.auth === 'api-key' || !account) await this.#clock.sleep(10);\n    if (account?.auth === 'api-key' && !secret)\n      throw new Error(\n        `${account.provider} needs ${account.secret === 'token' ? 'a token' : 'an API key'}`\n      );\n    const identity =\n      account?.group === 'mcp'\n        ? account.identity\n        : account?.auth === 'api-key'\n          ? 'API key'\n          : account?.identity || `${id}-user@example.com`;\n    this.#set(id, { status: 'connected', identity });\n  }\n\n  #signIn(account: Account): Promise<boolean> {\n    const before = this.#signIns.get(account.id)?.before ?? account.status;\n    this.#signIns.get(account.id)?.stop();\n    this.#set(account.id, { status: 'signing-in' });\n    return new Promise((resolve) => {\n      const stop = () => {\n        this.#signIns.delete(account.id);\n        this.#set(account.id, { status: before });\n        resolve(false);\n      };\n      this.#signIns.set(account.id, { before, stop });\n      void this.#clock.sleep(100).then(() => {\n        if (this.#signIns.get(account.id)?.stop !== stop) return;\n        this.#signIns.delete(account.id);\n        resolve(true);\n      });\n    });\n  }\n\n  cancel(id: string): void {\n    this.#signIns.get(id)?.stop();\n  }\n\n  disconnect(id: string): void {\n    this.#set(id, { status: 'disconnected' });\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["clock"]
-}