@ai-ecoverse/slicc-spectrum 1.50.0 → 1.52.0

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

@@ -0,0 +1,51 @@
+import '@adobe/spectrum-wc/components/button/swc-button.js';
+import '@adobe/spectrum-wc-icons/swc-icon-alert-triangle.js';
+import '@spectrum-web-components/alert-dialog/sp-alert-dialog.js';
+import { type PropertyValues } from 'lit';
+import type { Approval, ApprovalDecision, SliccModel } from '../model/types.js';
+import { ModelElement } from './base.js';
+export declare function countdown(ms: number): string;
+export declare function asking(approval: Approval): string;
+export declare function sudo(approval: Approval): string;
+export declare function waiting(model: SliccModel | null, now: number): Approval[];
+export declare class SliccApprovals extends ModelElement {
+    #private;
+    static properties: {
+        model: {
+            attribute: boolean;
+        };
+        now: {
+            state: boolean;
+        };
+        busy: {
+            state: boolean;
+        };
+        failure: {
+            state: boolean;
+        };
+        gone: {
+            state: boolean;
+        };
+    };
+    now: number;
+    busy: ApprovalDecision | '';
+    failure: {
+        id: string;
+        message: string;
+    } | null;
+    gone: {
+        approval: Approval;
+        reason: 'elsewhere' | 'expired';
+    } | null;
+    arming: number;
+    constructor();
+    static styles: import("lit").CSSResult[];
+    protected subscribe(model: SliccModel): Array<() => void>;
+    disconnectedCallback(): void;
+    decide(approval: Approval, decision: ApprovalDecision): Promise<void>;
+    protected willUpdate(changed: PropertyValues): void;
+    protected updated(changed: PropertyValues): void;
+    close(): void;
+    render(): unknown;
+}
+export declare function deadline(at: number): string;

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

@@ -21,6 +21,8 @@ export interface PromptOptions {
     trigger?: HTMLElement | null;
     submit?: (value: string) => Promise<void>;
 }
+export declare function focused(): HTMLElement | null;
+export declare const dialogStyles: import("lit").CSSResult;
 export declare class SliccConfirm extends LitElement {
     #private;
     static properties: {

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

@@ -0,0 +1,60 @@
+import '@adobe/spectrum-wc/components/action-button/swc-action-button.js';
+import '@adobe/spectrum-wc/components/button/swc-button.js';
+import '@adobe/spectrum-wc/components/popover/swc-popover.js';
+import '@adobe/spectrum-wc/components/progress-circle/swc-progress-circle.js';
+import '@adobe/spectrum-wc/components/status-light/swc-status-light.js';
+import '@adobe/spectrum-wc/components/tooltip/swc-tooltip.js';
+import '@adobe/spectrum-wc-icons/swc-icon-alert-triangle.js';
+import '@adobe/spectrum-wc-icons/swc-icon-user-following.js';
+import { nothing, type TemplateResult } from 'lit';
+import type { FollowState, SliccModel } from '../model/types.js';
+import { ModelElement } from './base.js';
+export type FollowVariant = 'info' | 'positive' | 'notice' | 'negative';
+export interface FollowLight {
+    variant: FollowVariant;
+    text: string;
+}
+export declare function followLight(state: FollowState): FollowLight;
+export type FollowPageKind = 'connecting' | 'waiting' | 'unlinked' | 'failed';
+export interface FollowPage {
+    kind: FollowPageKind;
+    title: string;
+    body: string;
+}
+export declare function followPage(state: FollowState | undefined): FollowPage | null;
+export declare function followCan(state: FollowState): string;
+export declare function following(model: SliccModel | null | undefined): FollowState | null;
+export declare function watchOnly(model: SliccModel | null | undefined): string;
+export declare function terminalsAllowed(model: SliccModel | null | undefined): boolean;
+export declare class SliccFollow extends ModelElement {
+    #private;
+    static properties: {
+        model: {
+            attribute: boolean;
+        };
+        page: {
+            type: BooleanConstructor;
+            reflect: boolean;
+        };
+        compact: {
+            type: BooleanConstructor;
+            reflect: boolean;
+        };
+        busy: {
+            state: boolean;
+        };
+        error: {
+            state: boolean;
+        };
+    };
+    page: boolean;
+    compact: boolean;
+    busy: '' | 'leave' | 'retry';
+    error: string;
+    constructor();
+    static styles: import("lit").CSSResult[];
+    protected subscribe(model: SliccModel): Array<() => void>;
+    leave(): Promise<void>;
+    retry(): Promise<void>;
+    render(): TemplateResult | typeof nothing;
+}

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

@@ -10,8 +10,9 @@ import '@adobe/spectrum-wc-icons/swc-icon-cloud-state-slow-connection.js';
 import '@adobe/spectrum-wc-icons/swc-icon-copy.js';
 import '@adobe/spectrum-wc-icons/swc-icon-info-circle.js';
 import { type TemplateResult } from 'lit';
-import type { BrowserAutomation, LinkedDevice, LinkState, NetworkExit, NetworkLinks, NetworkRoute, NetworkStatus, RemoteControlMode, SliccModel, TailnetState, TailnetStatus } from '../model/types.js';
+import type { AccessKey, BrowserAutomation, DeviceAccess, LinkedDevice, LinkState, NetworkExit, NetworkLinks, NetworkPort, NetworkRoute, NetworkStatus, RemoteControlMode, SliccModel, TailnetState, TailnetStatus } from '../model/types.js';
 import { ModelElement } from './base.js';
+import { type ConfirmOptions } from './confirm.js';
 export { command } from './reach.js';
 export declare const networkHealth: Record<NetworkStatus['health'], readonly ['positive' | 'notice' | 'negative', string]>;
 export declare const automation: Record<NonNullable<BrowserAutomation['via']> | 'none', string>;
@@ -22,11 +23,18 @@ export declare function tailnetAddress(addresses: readonly string[]): string | u
 export declare function exitNodeValue(tailnet: TailnetStatus): string;
 export declare const linkStates: Record<LinkState, readonly ['neutral' | 'info' | 'positive' | 'notice', string]>;
 export declare const controlBadges: Record<RemoteControlMode, string>;
+export declare const accessLabels: Record<AccessKey, string>;
+export declare function accessShown(access: DeviceAccess): AccessKey[];
+export declare function terminalsText(count: number): string;
+export declare function accessConfirm(device: LinkedDevice, key: AccessKey | 'follow'): ConfirmOptions;
 export interface RemoteLight {
-    mode: RemoteControlMode;
+    mode: RemoteControlMode | 'terminal' | 'ask';
+    variant: 'info' | 'notice';
     text: string;
     tooltip: string;
 }
+export declare function deviceName(name: string): string;
+export declare function networkStatus(port: NetworkPort): NetworkStatus;
 export declare function remoteLight(status: NetworkStatus | undefined): RemoteLight | null;
 export type LinksSummary = 'permission' | 'none' | 'reconnecting' | 'connecting' | 'offline' | 'linked';
 export declare function linksSummary(links: NetworkLinks): LinksSummary;

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

@@ -0,0 +1,6 @@
+import { type TemplateResult } from 'lit';
+export declare function qrPath(text: string): {
+    size: number;
+    path: string;
+};
+export declare function qrCode(text: string, label: string): TemplateResult;

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

@@ -0,0 +1,13 @@
+import { Emitter } from '../model/emitter.js';
+import type { Approval, ApprovalDecision, ApprovalEnd, ApprovalsEvents, ApprovalsPort } from '../model/types.js';
+import type { Clock } from './clock.js';
+export type ApprovalScenario = 'agent' | 'user' | 'many' | 'follower' | 'fail' | 'soon' | 'elsewhere' | 'withdrawn';
+export declare function approvalFixtures(scenario: ApprovalScenario, now?: number): Approval[];
+export declare class DummyApprovals extends Emitter<ApprovalsEvents> implements ApprovalsPort {
+    #private;
+    decisions: Array<[string, ApprovalDecision]>;
+    decide?: (id: string, decision: ApprovalDecision) => Promise<void>;
+    constructor(scenario: ApprovalScenario, time: Clock);
+    end(id: string, reason: ApprovalEnd): void;
+    list(): readonly Approval[];
+}

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

@@ -0,0 +1,16 @@
+import { Emitter } from '../model/emitter.js';
+import type { FollowPort, FollowState } from '../model/types.js';
+import type { Clock } from './clock.js';
+export type FollowScenario = 'connecting' | 'waiting' | 'watch' | 'control' | 'full' | 'reconnecting' | 'unlinked' | 'failed';
+export declare function followFixtures(scenario: FollowScenario): FollowState;
+export declare class DummyFollow extends Emitter<{
+    follow: FollowState;
+}> implements FollowPort {
+    #private;
+    left: number;
+    constructor(scenario: FollowScenario, time: Clock);
+    state(): FollowState;
+    setScenario(scenario: FollowScenario): void;
+    leave(): Promise<void>;
+    retry(): Promise<void>;
+}

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

@@ -1,7 +1,9 @@
 import type { SliccModel } from '../model/types.js';
+import { type ApprovalScenario, DummyApprovals } from './approvals.js';
 import { type BrowserScenario, DummyBrowser } from './browser.js';
 import { type ChangesScenario } from './changes.js';
 import { type MountScenario } from './files.js';
+import { DummyFollow, type FollowScenario } from './follow.js';
 import { DummyNetwork, type LinksScenario, type NetworkScenario, type TailnetScenario } from './network.js';
 import { DummyNotices, type NoticeScenario } from './notices.js';
 import { DummyTabs, type TabsScenario } from './tabs.js';
@@ -19,6 +21,8 @@ export interface DummyOptions {
     changes?: ChangesScenario;
     notices?: NoticeScenario | 'off';
     tabs?: TabsScenario | 'off';
+    approvals?: ApprovalScenario | 'off';
+    follow?: FollowScenario | 'off';
     browser?: BrowserScenario;
 }
 export interface DummyModel extends SliccModel {
@@ -27,5 +31,7 @@ export interface DummyModel extends SliccModel {
     network?: DummyNetwork;
     notices?: DummyNotices;
     tabs?: DummyTabs;
+    approvals?: DummyApprovals;
+    follow?: DummyFollow;
 }
-export declare function createDummyModel({ delay, storage, updates, packages, confirm, mounts, network, tailnet, links, changes, notices, tabs, browser: scenario, }?: DummyOptions): DummyModel;
+export declare function createDummyModel({ delay, storage, updates, packages, confirm, mounts, network, tailnet, links, changes, notices, tabs, approvals, follow, browser: scenario, }?: DummyOptions): DummyModel;

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

@@ -1,12 +1,14 @@
 import { Emitter } from '../model/emitter.js';
-import type { NetworkExit, NetworkLinks, NetworkPort, NetworkStatus, TailnetStatus } from '../model/types.js';
+import type { AccessKey, LinkedDevice, NetworkExit, NetworkLinks, NetworkPort, NetworkStatus, TailnetStatus } from '../model/types.js';
 import type { Clock } from './clock.js';
 export type NetworkScenario = 'ok' | 'limited' | 'failing';
 export type TailnetScenario = 'off' | 'needs-login' | 'running' | 'failed';
-export type LinksScenario = 'none' | 'preparing' | 'linked' | 'reconnecting' | 'exit' | 'prompt' | 'denied' | 'remote';
+export type LinksScenario = 'none' | 'preparing' | 'linked' | 'reconnecting' | 'exit' | 'prompt' | 'denied' | 'remote' | 'followers';
 export declare function networkFixtures(scenario: NetworkScenario, now?: number): NetworkStatus;
 export declare function tailnetFixtures(scenario: TailnetScenario): TailnetStatus;
 export declare function joinUrl(rotation?: number): string;
+export declare function followUrl(rotation?: number): string;
+export declare function grant(device: LinkedDevice, key: AccessKey, allowed: boolean): LinkedDevice;
 export declare function linksFixtures(scenario: LinksScenario, rotation?: number): {
     links: NetworkLinks;
     exit: NetworkExit;
@@ -19,6 +21,7 @@ export declare class DummyNetwork extends Emitter<{
     setExit?: (exit: NetworkExit) => Promise<void>;
     unlink?: (id: string) => Promise<void>;
     setRemoteControl?: (id: string, allowed: boolean) => Promise<void>;
+    setAccess?: (id: string, key: AccessKey, allowed: boolean) => Promise<void>;
     rotateJoinUrl?: () => Promise<void>;
     retryLinks?: () => Promise<void>;
     constructor(scenario: NetworkScenario, clock: Clock, tailnet?: TailnetScenario, links?: LinksScenario);

package/dist/types/dummy.d.ts

@@ -1,8 +1,12 @@
+export type { ApprovalScenario } from './dummy/approvals.js';
+export { approvalFixtures, DummyApprovals } from './dummy/approvals.js';
 export type { ActionDraft, BrowserScenario } from './dummy/browser.js';
 export { browserHistory, DummyBrowser, page } from './dummy/browser.js';
 export type { ChangesScenario } from './dummy/changes.js';
 export { DummyChanges } from './dummy/changes.js';
 export type { DummyMount, MountScenario } from './dummy/files.js';
+export type { FollowScenario } from './dummy/follow.js';
+export { DummyFollow, followFixtures } from './dummy/follow.js';
 export type { DummyModel, DummyOptions } from './dummy/index.js';
 export { createDummyModel } from './dummy/index.js';
 export type { NetworkScenario, TailnetScenario } from './dummy/network.js';

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

@@ -624,6 +624,14 @@ export interface RemoteControl {
     fixed?: boolean;
 }
 export type RemoteControlMode = 'prompt' | 'watch';
+export type LinkKind = 'cli' | 'seven';
+export type AccessKey = 'view' | 'control' | 'terminal';
+export interface DeviceAccess {
+    view?: boolean;
+    control?: boolean;
+    terminal?: boolean;
+    fixed?: boolean;
+}
 export interface LinkedBrowser {
     runtime: string;
     name: string;
@@ -641,10 +649,15 @@ export interface LinkedDevice {
     browsers?: readonly LinkedBrowser[];
     control?: RemoteControl;
     controlling?: RemoteControlMode;
+    kind?: LinkKind;
+    access?: DeviceAccess;
+    asking?: boolean;
+    terminals?: number;
 }
 export interface NetworkLinks {
     joinUrl: string | null;
     joinCommand: string | null;
+    followUrl?: string | null;
     devices: readonly LinkedDevice[];
     permission?: 'prompt' | 'denied' | null;
 }
@@ -687,6 +700,7 @@ export interface NetworkPort extends Subscribable<{
     setExit?(exit: NetworkExit): Promise<void>;
     unlink?(id: string): Promise<void>;
     setRemoteControl?(id: string, allowed: boolean): Promise<void>;
+    setAccess?(id: string, key: AccessKey, allowed: boolean): Promise<void>;
     rotateJoinUrl?(): Promise<void>;
     retryLinks?(): Promise<void>;
 }
@@ -708,6 +722,37 @@ export interface NoticesPort extends Subscribable<{
     act(id: string, action: string): Promise<void>;
     dismiss(id: string): void;
 }
+export type ApprovalDecision = 'once' | 'always' | 'deny';
+export interface ApprovalRequester {
+    kind: 'agent' | 'user';
+    name: string;
+    agentId?: string;
+    where?: string;
+}
+export interface SudoApproval {
+    id: string;
+    kind: 'sudo';
+    requester: ApprovalRequester;
+    command: string;
+    target?: string;
+    cwd?: string;
+    createdAt: number;
+    expiresAt: number;
+    always: boolean;
+}
+export type Approval = SudoApproval;
+export type ApprovalEnd = 'answered' | 'withdrawn' | 'expired';
+export interface ApprovalsEvents {
+    approvals: readonly Approval[];
+    ended: {
+        id: string;
+        reason: ApprovalEnd;
+    };
+}
+export interface ApprovalsPort extends Subscribable<ApprovalsEvents> {
+    list(): readonly Approval[];
+    decide?(id: string, decision: ApprovalDecision): Promise<void>;
+}
 export type TabRole = 'owner' | 'follower' | 'connecting' | 'alone';
 export type TabSkew = 'newer' | 'older';
 export interface TabsState {
@@ -721,6 +766,21 @@ export interface TabsPort extends Subscribable<{
     state(): TabsState;
     reload(): void;
 }
+export type FollowLink = 'connecting' | 'connected' | 'reconnecting' | 'unlinked' | 'failed';
+export interface FollowState {
+    owner: string;
+    link: FollowLink;
+    access: DeviceAccess;
+    name?: string;
+    error?: string;
+}
+export interface FollowPort extends Subscribable<{
+    follow: FollowState;
+}> {
+    state(): FollowState;
+    leave(): Promise<void>;
+    retry?(): Promise<void>;
+}
 export interface SliccModel {
     agent: AgentPort;
     files: FilePort;
@@ -736,4 +796,6 @@ export interface SliccModel {
     changes?: ChangesPort;
     notices?: NoticesPort;
     tabs?: TabsPort;
+    approvals?: ApprovalsPort;
+    follow?: FollowPort;
 }

package/dist/types/ui.d.ts

@@ -1,12 +1,14 @@
 import './app/spectrum.ts';
 import { SliccAgents } from './app/agents.js';
 import { SliccApp } from './app/app.js';
+import { SliccApprovals } from './app/approvals.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 { SliccConfirm, SliccPrompt } from './app/confirm.js';
 import { SliccFiles, SliccFileView } from './app/files.js';
+import { SliccFollow } from './app/follow.js';
 import { SliccNetwork } from './app/network.js';
 import { SliccNotices } from './app/notices.js';
 import { SliccUpdates } from './app/updates.js';
@@ -27,5 +29,5 @@ 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, SliccConfirm, SliccDiffPanel, SliccDiffView, SliccDock, SliccFiles, SliccFileTree, SliccFileView, SliccNetwork, SliccNotices, SliccPrompt, SliccUpdates, };
+export { SliccAgents, SliccApp, SliccApprovals, SliccBrowser, SliccChanges, SliccChat, SliccCodeView, SliccComposer, SliccConfirm, SliccDiffPanel, SliccDiffView, SliccDock, SliccFiles, SliccFileTree, SliccFileView, SliccFollow, SliccNetwork, SliccNotices, SliccPrompt, SliccUpdates, };
 export declare function define(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-spectrum",
-  "version": "1.50.0",
+  "version": "1.52.0",
   "description": "Web components for SLICC on Spectrum Web Components: the terminal, the app shell and its surfaces",
   "type": "module",
   "license": "Apache-2.0",
@@ -107,6 +107,7 @@
     "monocart-coverage-reports": "2.13.0",
     "playwright-core": "1.63.0",
     "semantic-release": "25.0.9",
-    "typescript": "7.0.2"
+    "typescript": "7.0.2",
+    "uqr": "0.1.3"
   }
 }