@ai-ecoverse/slicc-spectrum 1.77.1 → 1.79.0

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

@@ -1,6 +1,7 @@
 import '@adobe/spectrum-wc/components/action-button/swc-action-button.js';
 import '@adobe/spectrum-wc/components/tooltip/swc-tooltip.js';
 import '@adobe/spectrum-wc-icons/swc-icon-add.js';
+import '@adobe/spectrum-wc-icons/swc-icon-chevron-right.js';
 import '@adobe/spectrum-wc-icons/swc-icon-close.js';
 import '@adobe/spectrum-wc-icons/swc-icon-delete.js';
 import { type TemplateResult } from 'lit';
@@ -10,6 +11,7 @@ export declare function ordered(agents: readonly Agent[]): Agent[];
 export declare function creatable(model: SliccModel | null | undefined): boolean;
 export declare function createCone(model: SliccModel, trigger: HTMLElement): Promise<Agent | undefined>;
 export declare function scoopSummary(scoops: readonly Agent[]): string;
+export declare function scoopBrief(scoops: readonly Agent[]): string;
 export declare function unreadCount(unread: number): string;
 export declare function fillShown(fill: number): boolean;
 export declare class SliccAgents extends ModelElement {
@@ -27,5 +29,6 @@ export declare class SliccAgents extends ModelElement {
     static styles: import("lit").CSSResult[];
     protected subscribe(model: SliccModel): Array<() => void>;
     focus(): void;
+    protected updated(): void;
     render(): TemplateResult;
 }

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

@@ -2,18 +2,20 @@ 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 type { Approval, ApprovalDecision, GuestMessageApproval, GuestToolApproval, SliccModel, SudoApproval } 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 asking(approval: SudoApproval): string;
+export declare function sudo(approval: SudoApproval): string;
 export declare const certain: (rules: string) => boolean;
 export interface SecretRulesVerdict {
     certain: string | null;
     maybe: string | null;
 }
 export declare function secretRules(command: string, cwd?: string | null): SecretRulesVerdict;
-export declare function alwaysHint(approval: Approval): string;
+export declare function alwaysHint(approval: SudoApproval): string;
+export declare function guestAsking(approval: GuestMessageApproval | GuestToolApproval): string;
+export declare function guestWaiting(approval: GuestMessageApproval | GuestToolApproval): string;
 export declare function waiting(model: SliccModel | null, now: number): Approval[];
 export declare class SliccApprovals extends ModelElement {
     #private;

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

@@ -22,6 +22,7 @@ export interface PromptOptions {
     submit?: (value: string) => Promise<void>;
 }
 export declare function focused(): HTMLElement | null;
+export declare function themeOf(node: Node | null): Element;
 export declare const dialogStyles: import("lit").CSSResult;
 export declare class SliccConfirm extends LitElement {
     #private;

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

@@ -0,0 +1,98 @@
+import '@adobe/spectrum-wc/components/action-button/swc-action-button.js';
+import '@adobe/spectrum-wc/components/button/swc-button.js';
+import '@adobe/spectrum-wc-icons/swc-icon-alert-triangle.js';
+import '@adobe/spectrum-wc-icons/swc-icon-copy.js';
+import '@spectrum-web-components/alert-dialog/sp-alert-dialog.js';
+import '@spectrum-web-components/field-label/sp-field-label.js';
+import '@spectrum-web-components/help-text/sp-help-text.js';
+import '@spectrum-web-components/menu/sp-menu-item.js';
+import '@spectrum-web-components/picker/sp-picker.js';
+import '@spectrum-web-components/textfield/sp-textfield.js';
+import { LitElement, type TemplateResult } from 'lit';
+import type { Agent, GuestGate, GuestPort, GuestSeat } from '../model/types.js';
+export declare const guestExpiries: ReadonlyArray<readonly [string, string, number]>;
+export declare const guestNameLimit = 40;
+export interface GuestCone {
+    id: string;
+    name: string;
+    scoops: readonly string[];
+}
+export interface GateOption {
+    value: GuestGate;
+    label: string;
+    description: string;
+}
+export type GateField = 'messages' | 'tools';
+export declare function gateOptions(field: GateField, cone: GuestCone): GateOption[];
+export declare function guestCones(agents: readonly Agent[]): GuestCone[];
+export declare function activeCone(agents: readonly Agent[], active: string): string;
+export declare function guestNameProblem(label: string): string | null;
+export declare function guestExpiry(seat: GuestSeat, now?: number): string;
+export declare function pendingLabel(count: number): string;
+export declare class SliccGuestInvite extends LitElement {
+    #private;
+    static properties: {
+        cone: {
+            state: boolean;
+        };
+        label: {
+            state: boolean;
+        };
+        expiry: {
+            state: boolean;
+        };
+        messages: {
+            state: boolean;
+        };
+        tools: {
+            state: boolean;
+        };
+        pending: {
+            state: boolean;
+        };
+        error: {
+            state: boolean;
+        };
+        problem: {
+            state: boolean;
+        };
+        url: {
+            state: boolean;
+        };
+        copied: {
+            state: boolean;
+        };
+        uncopied: {
+            state: boolean;
+        };
+    };
+    cone: string;
+    label: string;
+    expiry: string;
+    messages: GuestGate;
+    tools: GuestGate;
+    pending: boolean;
+    error: string;
+    problem: string;
+    url: string;
+    copied: boolean;
+    uncopied: boolean;
+    port: GuestPort | null;
+    cones: readonly GuestCone[];
+    trigger: HTMLElement | null;
+    constructor();
+    static styles: import("lit").CSSResult[];
+    get result(): Promise<GuestSeat | null>;
+    protected firstUpdated(): void;
+    disconnectedCallback(): void;
+    create(): Promise<void>;
+    copy(): Promise<void>;
+    render(): TemplateResult;
+}
+export interface InviteOptions {
+    port: GuestPort;
+    agents: readonly Agent[];
+    active: string;
+    trigger?: HTMLElement | null;
+}
+export declare function invite(options: InviteOptions): Promise<GuestSeat | null>;

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

@@ -13,7 +13,7 @@ import '@adobe/spectrum-wc-icons/swc-icon-info-circle.js';
 import '@adobe/spectrum-wc-icons/swc-icon-visibility.js';
 import '@adobe/spectrum-wc-icons/swc-icon-visibility-off.js';
 import { type TemplateResult } from 'lit';
-import type { AccessKey, BrowserAutomation, DeviceAccess, Leader, LeaderState, LinkedDevice, LinkState, NetworkExit, NetworkLinks, NetworkPort, NetworkRoute, NetworkStatus, RemoteControlMode, SliccModel, TailnetState, TailnetStatus } from '../model/types.js';
+import type { AccessKey, BrowserAutomation, DeviceAccess, GuestSeat, Leader, LeaderState, 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';
@@ -43,6 +43,7 @@ export declare function deviceName(name: string): string;
 export declare function networkStatus(port: NetworkPort): NetworkStatus;
 export declare const leaderStates: Record<LeaderState, readonly ['neutral' | 'info' | 'positive' | 'notice' | 'negative', string]>;
 export declare function leaderConfirm(leader: Leader): ConfirmOptions;
+export declare function guestConfirm(seat: GuestSeat): ConfirmOptions;
 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;
@@ -97,6 +98,12 @@ export declare class SliccNetwork extends ModelElement {
         leaderError: {
             state: boolean;
         };
+        guestError: {
+            state: boolean;
+        };
+        guestsOff: {
+            state: boolean;
+        };
     };
     checking: boolean;
     copied: string | null;
@@ -109,6 +116,8 @@ export declare class SliccNetwork extends ModelElement {
     linksError: string;
     syncError: string;
     leaderError: string;
+    guestError: string;
+    guestsOff: string | null;
     constructor();
     static styles: import("lit").CSSResult[];
     protected subscribe(model: SliccModel): Array<() => void>;

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

@@ -1,7 +1,7 @@
 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' | 'secrets' | 'none';
+export type ApprovalScenario = 'agent' | 'user' | 'many' | 'follower' | 'fail' | 'soon' | 'elsewhere' | 'withdrawn' | 'secrets' | 'guest' | 'guest-follower' | 'none';
 export declare function approvalFixtures(scenario: ApprovalScenario, now?: number): Approval[];
 export declare class DummyApprovals extends Emitter<ApprovalsEvents> implements ApprovalsPort {
     #private;

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

@@ -0,0 +1,20 @@
+import { Emitter } from '../model/emitter.js';
+import type { GuestDraft, GuestEvents, GuestPort, GuestSeat } from '../model/types.js';
+import type { Clock } from './clock.js';
+export type GuestsScenario = 'on' | 'none' | 'unavailable' | 'fail';
+export declare const guestsUnavailable = "Guests need the tray hub. Connect this SLICC to a tray to invite one.";
+export declare const guestsRefused = "The hub couldn\u2019t make a link right now. Try again in a minute.";
+export declare function guestsFixtures(scenario: GuestsScenario, now?: number): GuestSeat[];
+export declare class DummyGuests extends Emitter<GuestEvents> implements GuestPort {
+    #private;
+    scenario: GuestsScenario;
+    constructor(scenario: GuestsScenario, clock: Clock);
+    list(): readonly GuestSeat[];
+    unavailable(): string | null;
+    setScenario(scenario: GuestsScenario): void;
+    mint(agentId: string, draft: GuestDraft): Promise<{
+        seat: GuestSeat;
+        url: string;
+    }>;
+    revoke(id: string): Promise<void>;
+}

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

@@ -4,6 +4,7 @@ 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 { DummyGuests, type GuestsScenario } from './guests.js';
 import { DummyNetwork, type LeadersScenario, type LinksScenario, type NetworkScenario, type TailnetScenario } from './network.js';
 import { DummyNotices, type NoticeScenario } from './notices.js';
 import { DummyTabs, type TabsScenario } from './tabs.js';
@@ -26,6 +27,7 @@ export interface DummyOptions {
     approvals?: ApprovalScenario | 'off';
     follow?: FollowScenario | 'off';
     vault?: VaultScenario | 'off';
+    guests?: GuestsScenario | 'off';
     accounts?: 'settings' | 'vault';
     providers?: 'connected' | 'none';
     hold?: AgentHold['reason'] | 'off';
@@ -43,6 +45,7 @@ export interface DummyModel extends SliccModel {
     approvals?: DummyApprovals;
     follow?: DummyFollow;
     vault?: DummyVault;
+    guests?: DummyGuests;
 }
 export declare function vaultAccounts(accounts: readonly Account[]): Account[];
-export declare function createDummyModel({ delay, storage, updates, packages, confirm, mounts, network, tailnet, links, leaders, changes, notices, tabs, approvals, follow, vault, accounts, providers, hold, readonly, browser: scenario, sprinkles, monitor, }?: DummyOptions): DummyModel;
+export declare function createDummyModel({ delay, storage, updates, packages, confirm, mounts, network, tailnet, links, leaders, changes, notices, tabs, approvals, follow, vault, guests, accounts, providers, hold, readonly, browser: scenario, sprinkles, monitor, }?: DummyOptions): DummyModel;

package/dist/types/dummy.d.ts

@@ -7,6 +7,8 @@ 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 { GuestsScenario } from './dummy/guests.js';
+export { DummyGuests, guestsFixtures, guestsRefused, guestsUnavailable, } from './dummy/guests.js';
 export type { DummyModel, DummyOptions } from './dummy/index.js';
 export { createDummyModel } from './dummy/index.js';
 export type { LeadersScenario, NetworkScenario, TailnetScenario } from './dummy/network.js';

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

@@ -791,11 +791,15 @@ export interface NoticesPort extends Subscribable<{
 }
 export type ApprovalDecision = 'once' | 'always' | 'deny';
 export interface ApprovalRequester {
-    kind: 'agent' | 'user';
+    kind: 'agent' | 'user' | 'guest';
     name: string;
     agentId?: string;
     where?: string;
 }
+export interface ApprovalVerdict {
+    decision: 'allow' | 'deny';
+    reason: string;
+}
 export interface SudoApproval {
     id: string;
     kind: 'sudo';
@@ -808,7 +812,37 @@ export interface SudoApproval {
     always: boolean;
     alwaysScope?: 'cwd';
 }
-export type Approval = SudoApproval;
+export interface GuestMessageApproval {
+    id: string;
+    kind: 'guest-message';
+    requester: ApprovalRequester;
+    agentId: string;
+    agentName?: string;
+    text: string;
+    attachments?: readonly {
+        name: string;
+        mimeType: string;
+        size: number;
+    }[];
+    createdAt: number;
+    expiresAt: number;
+    always: false;
+    verdict?: ApprovalVerdict;
+}
+export interface GuestToolApproval {
+    id: string;
+    kind: 'guest-tool';
+    requester: ApprovalRequester;
+    agentId: string;
+    agentName?: string;
+    tool: string;
+    summary: string;
+    createdAt: number;
+    expiresAt: number;
+    always: false;
+    verdict?: ApprovalVerdict;
+}
+export type Approval = SudoApproval | GuestMessageApproval | GuestToolApproval;
 export type ApprovalEnd = 'answered' | 'withdrawn' | 'expired';
 export interface ApprovalsEvents {
     approvals: readonly Approval[];
@@ -819,7 +853,7 @@ export interface ApprovalsEvents {
 }
 export interface ApprovalsPort extends Subscribable<ApprovalsEvents> {
     list(): readonly Approval[];
-    decide?(id: string, decision: ApprovalDecision): Promise<void>;
+    decide?(id: string, decision: ApprovalDecision, reason?: string): Promise<void>;
 }
 export type TabRole = 'owner' | 'follower' | 'connecting' | 'alone';
 export type TabSkew = 'newer' | 'older';
@@ -1207,6 +1241,39 @@ export interface VaultPort extends Subscribable<VaultEvents> {
     dismissBackupReminder?(): Promise<void>;
     button(): VaultButton;
 }
+export type GuestGate = 'user' | 'cone' | 'agent' | `scoop:${string}` | 'off';
+export interface GuestGates {
+    messages: GuestGate;
+    tools: GuestGate;
+}
+export interface GuestSeat {
+    id: string;
+    label: string;
+    agentId: string;
+    createdAt: number;
+    expiresAt: number | null;
+    gates: GuestGates;
+    connected: boolean;
+    pending: number;
+}
+export interface GuestDraft {
+    label: string;
+    expiresAt: number | null;
+    gates: GuestGates;
+}
+export interface GuestEvents {
+    seats: readonly GuestSeat[];
+    unavailable: string | null;
+}
+export interface GuestPort extends Subscribable<GuestEvents> {
+    list(): readonly GuestSeat[];
+    mint(agentId: string, draft: GuestDraft): Promise<{
+        seat: GuestSeat;
+        url: string;
+    }>;
+    revoke(id: string): Promise<void>;
+    unavailable?(): string | null;
+}
 export interface SliccModel {
     agent: AgentPort;
     files: FilePort;
@@ -1225,5 +1292,6 @@ export interface SliccModel {
     approvals?: ApprovalsPort;
     follow?: FollowPort;
     vault?: VaultPort;
+    guests?: GuestPort;
 }
 export {};

package/dist/types/ui.d.ts

@@ -9,6 +9,7 @@ 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 { SliccGuestInvite } from './app/guests.js';
 import { SliccNetwork } from './app/network.js';
 import { SliccNotices } from './app/notices.js';
 import { SliccSecrets } from './app/secrets.js';
@@ -37,5 +38,5 @@ export type { Listener, Subscribable } from './model/emitter.js';
 export { Emitter } from './model/emitter.js';
 export type * from './model/types.js';
 export { isVaultFailure } from './model/values.js';
-export { SliccAgents, SliccApp, SliccApprovals, SliccBrowser, SliccChanges, SliccChat, SliccCodeView, SliccComposer, SliccConfirm, SliccDiffPanel, SliccDiffView, SliccDock, SliccFiles, SliccFileTree, SliccFileView, SliccFollow, SliccNetwork, SliccNotices, SliccPrompt, SliccSecrets, SliccUpdates, SliccValueRequest, SliccVaultButton, };
+export { SliccAgents, SliccApp, SliccApprovals, SliccBrowser, SliccChanges, SliccChat, SliccCodeView, SliccComposer, SliccConfirm, SliccDiffPanel, SliccDiffView, SliccDock, SliccFiles, SliccFileTree, SliccFileView, SliccFollow, SliccGuestInvite, SliccNetwork, SliccNotices, SliccPrompt, SliccSecrets, SliccUpdates, SliccValueRequest, SliccVaultButton, };
 export declare function define(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-spectrum",
-  "version": "1.77.1",
+  "version": "1.79.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,14 +72,14 @@
   "devDependencies": {
     "@adobe/spectrum-wc": "2.0.0-beta.5",
     "@adobe/spectrum-wc-icons": "2.0.0-beta.5",
-    "@ai-ecoverse/slicc-kernel": "1.97.1",
+    "@ai-ecoverse/slicc-kernel": "1.98.2",
     "@ai-ecoverse/slicc-shared-web": "1.20.0",
     "@ai-ecoverse/slicc-vault": "1.9.1",
     "@ai-ecoverse/wasm-bash": "5.3.0-18",
     "@ai-ecoverse/wasm-coreutils": "9.12.0-7",
     "@biomejs/biome": "2.5.15",
     "@fontsource/source-code-pro": "5.3.0",
-    "@happy-dom/global-registrator": "20.14.5",
+    "@happy-dom/global-registrator": "20.14.6",
     "@pierre/diffs": "1.5.2",
     "@pierre/trees": "1.0.0-beta.6",
     "@spectrum-web-components/action-button": "1.12.4",
@@ -102,7 +102,7 @@
     "@wterm/dom": "0.5.4",
     "dockview-core": "8.4.1",
     "esbuild": "0.28.2",
-    "happy-dom": "20.14.5",
+    "happy-dom": "20.14.6",
     "lefthook": "2.2.1",
     "lucide": "1.53.0",
     "monocart-coverage-reports": "2.13.2",