@ai-ecoverse/slicc-agent 5.2.0 → 5.3.0

package/dist/types/services.d.ts

@@ -4,6 +4,8 @@ import type { Approval, ApprovalAnswer, ApprovalDecided } from './approvals/inde
 import type { SendAttachment, ShownAttachment } from './attachments.ts';
 import type { ChangesView } from './changes/git.ts';
 import type { FrozenCone } from './freezer/index.ts';
+import type { GuestOpened, Proposed, ProposeRequest } from './guests/index.ts';
+import type { GuestDraft, GuestGates, GuestSeat } from './guests/seats.ts';
 import type { MemoryEntry, MemoryScope, MemoryTag } from './memory/format.ts';
 import type { AgentRemote } from './remote/host.ts';
 import type { VaultState } from './secrets/vault.ts';
@@ -88,6 +90,10 @@ export interface AgentControl {
     image(ref: ImageRef, context: Context): Promise<StoredImage>;
     agentCommands(agentId: string, context: Context): Promise<Command[]>;
     toolLabel(agentId: string, callIds: string[], context: Context): Promise<string | null>;
+    guestOpen(draft: GuestDraft, context: Context): Promise<GuestOpened>;
+    guestRevoke(id: string, context: Context): Promise<{
+        revoked: boolean;
+    }>;
     decide(id: string, decision: ApprovalAnswer, reason: string | null, context: Context): Promise<ApprovalDecided>;
 }
 export interface ImageRef {
@@ -233,7 +239,7 @@ export interface AgentSettingsChange {
     thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
     agentId?: string | null;
 }
-export declare const CONTROL_METHODS: ("abort" | "agentCommands" | "changeAccept" | "changeRevert" | "changesOpen" | "compact" | "compactAgent" | "configure" | "createCone" | "createScoop" | "decide" | "discard" | "drop" | "freeze" | "image" | "memoryRemove" | "memorySave" | "monitorClose" | "monitorOpen" | "newChat" | "reset" | "resolveAgentLick" | "resolveLick" | "rewind" | "rewindAgent" | "selectCone" | "send" | "sprinkleCall" | "sprinkleSend" | "stopAgent" | "thaw" | "toolLabel" | "unqueue" | "wait" | "webhook" | "withdraw")[];
+export declare const CONTROL_METHODS: ("abort" | "agentCommands" | "changeAccept" | "changeRevert" | "changesOpen" | "compact" | "compactAgent" | "configure" | "createCone" | "createScoop" | "decide" | "discard" | "drop" | "freeze" | "guestOpen" | "guestRevoke" | "image" | "memoryRemove" | "memorySave" | "monitorClose" | "monitorOpen" | "newChat" | "reset" | "resolveAgentLick" | "resolveLick" | "rewind" | "rewindAgent" | "selectCone" | "send" | "sprinkleCall" | "sprinkleSend" | "stopAgent" | "thaw" | "toolLabel" | "unqueue" | "wait" | "webhook" | "withdraw")[];
 export declare const CONTROL_READS: readonly (keyof AgentControl & string)[];
 export declare const AgentControl: RemoteContract;
 export type Delivered = 'run' | 'steer' | 'follow-up';
@@ -252,6 +258,7 @@ export interface AgentTranscript {
     readonly monitor: ReplicatedState<MonitorFeed>;
     readonly vault: ReplicatedState<VaultState>;
     readonly labels: ReplicatedState<Record<string, string>>;
+    readonly guests: ReplicatedState<GuestSeat[]>;
     readonly approvals: ReplicatedState<Approval[]>;
 }
 export interface PrivateRevision {
@@ -262,10 +269,35 @@ export interface Command {
     description: string;
     kind: 'prompt' | 'skill' | 'action';
 }
-export declare const TRANSCRIPT_STATES: ("agents" | "approvals" | "changes" | "commands" | "deliveries" | "frozen" | "labels" | "memories" | "memoryScopes" | "monitor" | "privateRevision" | "sprinkles" | "state" | "vault" | "views")[];
+export declare const TRANSCRIPT_STATES: ("agents" | "approvals" | "changes" | "commands" | "deliveries" | "frozen" | "guests" | "labels" | "memories" | "memoryScopes" | "monitor" | "privateRevision" | "sprinkles" | "state" | "vault" | "views")[];
 export declare const AgentTranscript: RemoteContract;
 export declare const REMOTE_METHODS: ("abort" | "close" | "next" | "prompt" | "watch")[];
 export declare const REMOTE_READS: readonly (keyof AgentRemote & string)[];
+export interface GuestShown {
+    id: string;
+    label: string;
+    agentId: string;
+    name: string;
+    expiresAt: number | null;
+    gates: GuestGates;
+}
+export interface GuestProposal {
+    id: string;
+    text: string;
+    state: 'pending' | 'approved' | 'rejected' | 'unanswered' | 'withdrawn';
+    reason: string | null;
+    createdAt: number;
+    decidedAt: number | null;
+}
+export interface AgentGuest {
+    readonly transcript: ReplicatedState<ConversationView>;
+    readonly seat: ReplicatedState<GuestShown>;
+    readonly proposals: ReplicatedState<GuestProposal[]>;
+    propose(request: ProposeRequest, context: Context): Promise<Proposed>;
+}
+export declare const GUEST_STATES: readonly ['transcript', 'seat', 'proposals'];
+export declare const GUEST_METHODS: readonly ['propose'];
+export declare const AgentGuestService: RemoteContract;
 export declare const AgentRemoteService: RemoteContract;
 export declare const PAGE_METHODS: ("answer" | "close" | "next" | "open" | "report")[];
 export declare const AgentPagesService: RemoteContract;

package/dist/types/serving.d.ts

@@ -1,12 +1,19 @@
 import { type Ctx, type Principal, type Readable, type RemoteContract, type ReplicatedState } from '@earendil-works/chord';
 import { type Context } from '@earendil-works/chord/context';
 export declare const AGENT_HOST = "agent";
-export type Seat = 'owner' | 'control' | 'view';
+export type Seat = 'owner' | 'control' | 'view' | 'guest';
+export interface GuestPrincipal {
+    id: string;
+    name: string;
+    epoch: number;
+}
 export interface AgentPrincipal {
     seat: Seat;
     link: number;
+    guest?: GuestPrincipal;
 }
 export declare const seatOf: (principal: Principal) => Seat;
+export declare const guestOf: (principal: Principal) => GuestPrincipal | undefined;
 export declare const principalKey: (principal: Principal) => string;
 export interface Members {
     methods?: readonly string[];

package/dist/types/spectrum/guest-port.d.ts

@@ -0,0 +1,26 @@
+import type { GuestDraft, GuestEvents, GuestPort, GuestSeat } from '@ai-ecoverse/slicc-spectrum/ui';
+import type { AgentConnection } from '../client.ts';
+import { Emitter } from './emitter.ts';
+export interface GuestHub {
+    mint(request: GuestDraft & {
+        agentId: string;
+    }): Promise<{
+        id: string;
+        url: string;
+    }>;
+    revoke(id: string): Promise<void>;
+}
+export declare const NO_HUB = "Inviting guests needs the tray hub.";
+export declare const NO_CONTROL = "Only a tab with Control can invite guests.";
+export declare const NO_OWNER = "Only the owner's tab can invite guests.";
+export declare class GuestAdapter extends Emitter<GuestEvents> implements GuestPort {
+    #private;
+    constructor(connection: AgentConnection, hub: GuestHub | null);
+    list(): readonly GuestSeat[];
+    unavailable(): string | null;
+    mint(agentId: string, draft: GuestDraft): Promise<{
+        seat: GuestSeat;
+        url: string;
+    }>;
+    revoke(id: string): Promise<void>;
+}

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

@@ -1,8 +1,10 @@
 import type { MonitorSection } from '@ai-ecoverse/slicc-spectrum/ui';
 import type { AgentConnection } from '../client.ts';
+import type { GuestGates } from '../guests/seats.ts';
 import { AgentAdapter } from './agent-port.ts';
 import { ApprovalsAdapter, type HostApprovals } from './approvals-port.ts';
 import { ChangesAdapter } from './changes-port.ts';
+import { GuestAdapter, type GuestHub } from './guest-port.ts';
 import { MemoryAdapter } from './memory-port.ts';
 import { MonitorAdapter } from './monitor-port.ts';
 import { type HostNotices, NoticesAdapter } from './notices-port.ts';
@@ -13,6 +15,7 @@ import { TrayAdapter } from './tray-port.ts';
 export { AgentAdapter, CONE } from './agent-port.ts';
 export { ApprovalsAdapter, type HostApprovals, NOT_HERE, shown as shownApproval, } from './approvals-port.ts';
 export { ChangesAdapter, type ChangesEvents } from './changes-port.ts';
+export { GuestAdapter, type GuestHub, NO_CONTROL, NO_HUB, NO_OWNER, } from './guest-port.ts';
 export { MemoryAdapter } from './memory-port.ts';
 export { assistant, errorAction, errorPart, isBusy, queued, textOf, toMessages, } from './messages.ts';
 export { MonitorAdapter, type MonitorAdapterOptions, type MonitorInput, monitorSnapshot, } from './monitor-port.ts';
@@ -21,6 +24,13 @@ export { PageAdapter, type PageDocument, type PageOptions, type PageRun, type Pa
 export { type Login, SETTINGS_KEY, SettingsAdapter } from './settings-port.ts';
 export { SprinkleAdapter } from './sprinkle-port.ts';
 export { TrayAdapter } from './tray-port.ts';
+export interface GuestSeatShown {
+    id: string;
+    label: string;
+    agentId: string;
+    expiresAt: number | null;
+    gates: GuestGates;
+}
 export declare function createAgentModel(connection: AgentConnection, options?: {
     storage?: Pick<Storage, 'getItem' | 'setItem'> | null;
     login?: Login;
@@ -28,6 +38,7 @@ export declare function createAgentModel(connection: AgentConnection, options?:
         extra?: () => readonly MonitorSection[];
     };
     page?: PageOptions;
+    guests?: GuestHub;
     approvals?: HostApprovals;
     notices?: HostNotices;
 }): {
@@ -41,4 +52,6 @@ export declare function createAgentModel(connection: AgentConnection, options?:
     monitor: MonitorAdapter;
     notices: NoticesAdapter;
     page: PageAdapter | null;
+    guests: GuestAdapter;
+    seat?: GuestSeatShown;
 };

package/dist/types/spectrum/proposals.d.ts

@@ -0,0 +1,8 @@
+import type { Message, SystemMessage, UserMessage } from '@ai-ecoverse/slicc-spectrum/ui';
+import type { GuestProposal } from '../services.ts';
+export declare const UNANSWERED = "Nobody approved this in time.";
+export declare const DECLINED = "It was declined.";
+export declare const WITHDRAWN = "It was withdrawn.";
+export declare function proposalQueue(proposals: readonly GuestProposal[] | undefined, label: string): UserMessage[];
+export declare function proposalNotices(proposals: readonly GuestProposal[] | undefined): SystemMessage[];
+export declare function merged(messages: readonly Message[], notices: readonly SystemMessage[]): Message[];

package/dist/worker.js

@@ -4,8 +4,9 @@ function serveConnections(scope, host) {
     const port = message?.connect;
     if (!port) return;
     const pages = message?.pages === false ? { pages: false } : {};
+    const guest = message?.guest ? { guest: message.guest } : {};
     host.then(
-      (ready) => ready.connect(port, { readOnly: message?.readOnly === true, ...pages }),
+      (ready) => ready.connect(port, { readOnly: message?.readOnly === true, ...pages, ...guest }),
       () => port.close?.()
     );
   });

package/dist/worker.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/worker.ts"],
-  "sourcesContent": ["import type { AgentHost } from './host.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface WorkerScope {\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n}\n\nexport function serveConnections(scope: WorkerScope, host: Promise<AgentHost>): void {\n  scope.addEventListener('message', ({ data }) => {\n    const message = data as { connect?: PortEndpoint; readOnly?: boolean; pages?: boolean } | null;\n    const port = message?.connect;\n    if (!port) return;\n    const pages = message?.pages === false ? { pages: false } : {};\n    host.then(\n      (ready) => ready.connect(port, { readOnly: message?.readOnly === true, ...pages }),\n      () => port.close?.()\n    );\n  });\n}\n\nexport interface KernelPorts {\n  kernel: MessagePort;\n  admin?: MessagePort;\n}\n\nexport function kernelPorts(scope: WorkerScope): Promise<KernelPorts> {\n  return new Promise((resolve) => {\n    scope.addEventListener('message', ({ data }) => {\n      const message = data as { kernel?: MessagePort; admin?: MessagePort } | null;\n      const kernel = message?.kernel;\n      if (!kernel) return;\n      resolve(message.admin ? { kernel, admin: message.admin } : { kernel });\n    });\n  });\n}\n\nexport function kernelPort(scope: WorkerScope): Promise<MessagePort> {\n  return kernelPorts(scope).then((ports) => ports.kernel);\n}\n"],
-  "mappings": "AAOO,SAAS,iBAAiB,OAAoB,MAAgC;AACnF,QAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,UAAM,UAAU;AAChB,UAAM,OAAO,SAAS;AACtB,QAAI,CAAC,KAAM;AACX,UAAM,QAAQ,SAAS,UAAU,QAAQ,EAAE,OAAO,MAAM,IAAI,CAAC;AAC7D,SAAK;AAAA,MACH,CAAC,UAAU,MAAM,QAAQ,MAAM,EAAE,UAAU,SAAS,aAAa,MAAM,GAAG,MAAM,CAAC;AAAA,MACjF,MAAM,KAAK,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;AAOO,SAAS,YAAY,OAA0C;AACpE,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,YAAM,UAAU;AAChB,YAAM,SAAS,SAAS;AACxB,UAAI,CAAC,OAAQ;AACb,cAAQ,QAAQ,QAAQ,EAAE,QAAQ,OAAO,QAAQ,MAAM,IAAI,EAAE,OAAO,CAAC;AAAA,IACvE,CAAC;AAAA,EACH,CAAC;AACH;AAEO,SAAS,WAAW,OAA0C;AACnE,SAAO,YAAY,KAAK,EAAE,KAAK,CAAC,UAAU,MAAM,MAAM;AACxD;",
+  "sourcesContent": ["import type { AgentHost } from './host.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface WorkerScope {\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n}\n\nexport function serveConnections(scope: WorkerScope, host: Promise<AgentHost>): void {\n  scope.addEventListener('message', ({ data }) => {\n    const message = data as {\n      connect?: PortEndpoint;\n      readOnly?: boolean;\n      pages?: boolean;\n      guest?: { id: string; label: string };\n    } | null;\n    const port = message?.connect;\n    if (!port) return;\n    const pages = message?.pages === false ? { pages: false } : {};\n    const guest = message?.guest ? { guest: message.guest } : {};\n    host.then(\n      (ready) => ready.connect(port, { readOnly: message?.readOnly === true, ...pages, ...guest }),\n      () => port.close?.()\n    );\n  });\n}\n\nexport interface KernelPorts {\n  kernel: MessagePort;\n  admin?: MessagePort;\n}\n\nexport function kernelPorts(scope: WorkerScope): Promise<KernelPorts> {\n  return new Promise((resolve) => {\n    scope.addEventListener('message', ({ data }) => {\n      const message = data as { kernel?: MessagePort; admin?: MessagePort } | null;\n      const kernel = message?.kernel;\n      if (!kernel) return;\n      resolve(message.admin ? { kernel, admin: message.admin } : { kernel });\n    });\n  });\n}\n\nexport function kernelPort(scope: WorkerScope): Promise<MessagePort> {\n  return kernelPorts(scope).then((ports) => ports.kernel);\n}\n"],
+  "mappings": "AAOO,SAAS,iBAAiB,OAAoB,MAAgC;AACnF,QAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,UAAM,UAAU;AAMhB,UAAM,OAAO,SAAS;AACtB,QAAI,CAAC,KAAM;AACX,UAAM,QAAQ,SAAS,UAAU,QAAQ,EAAE,OAAO,MAAM,IAAI,CAAC;AAC7D,UAAM,QAAQ,SAAS,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAC3D,SAAK;AAAA,MACH,CAAC,UAAU,MAAM,QAAQ,MAAM,EAAE,UAAU,SAAS,aAAa,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAAA,MAC3F,MAAM,KAAK,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;AAOO,SAAS,YAAY,OAA0C;AACpE,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,YAAM,UAAU;AAChB,YAAM,SAAS,SAAS;AACxB,UAAI,CAAC,OAAQ;AACb,cAAQ,QAAQ,QAAQ,EAAE,QAAQ,OAAO,QAAQ,MAAM,IAAI,EAAE,OAAO,CAAC;AAAA,IACvE,CAAC;AAAA,EACH,CAAC;AACH;AAEO,SAAS,WAAW,OAA0C;AACnE,SAAO,YAAY,KAAK,EAAE,KAAK,CAAC,UAAU,MAAM,MAAM;AACxD;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "5.2.0",
+  "version": "5.3.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -62,12 +62,12 @@
     "release": "semantic-release"
   },
   "devDependencies": {
-    "@ai-ecoverse/slicc-kernel": "1.94.0",
+    "@ai-ecoverse/slicc-kernel": "1.100.3",
     "@ai-ecoverse/slicc-scrub": "1.0.0",
     "@ai-ecoverse/slicc-shared-web": "1.21.0",
-    "@ai-ecoverse/slicc-spectrum": "1.79.1",
+    "@ai-ecoverse/slicc-spectrum": "1.79.2",
     "@ai-ecoverse/wasm-bash": "5.3.0-18",
-    "@ai-ecoverse/wasm-coreutils": "9.12.0-6",
+    "@ai-ecoverse/wasm-coreutils": "9.12.0-7",
     "@ai-ecoverse/wasm-git": "2.55.0-15",
     "@biomejs/biome": "2.5.15",
     "@types/node": "24.19.1",
@@ -93,7 +93,7 @@
   },
   "peerDependencies": {
     "@ai-ecoverse/slicc-kernel": ">=1.90.0 <2",
-    "@ai-ecoverse/slicc-spectrum": "^1.78.0"
+    "@ai-ecoverse/slicc-spectrum": "^1.79.0"
   },
   "peerDependenciesMeta": {
     "@ai-ecoverse/slicc-spectrum": {