@ai-ecoverse/slicc-spectrum 1.58.3 → 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/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/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.3",
+  "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",