@ai-ecoverse/slicc-agent 5.2.0 → 5.4.0

package/dist/spectrum/proposals.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/spectrum/proposals.ts"],
+  "sourcesContent": ["import type { Message, SystemMessage, UserMessage } from '@ai-ecoverse/slicc-spectrum/ui';\nimport type { GuestProposal } from '../services.ts';\n\nexport const UNANSWERED = 'Nobody approved this in time.';\nexport const DECLINED = 'It was declined.';\nexport const WITHDRAWN = 'It was withdrawn.';\n\nconst ENDED: Record<string, string> = {\n  unanswered: UNANSWERED,\n  rejected: DECLINED,\n  withdrawn: WITHDRAWN,\n};\n\nexport function proposalQueue(\n  proposals: readonly GuestProposal[] | undefined,\n  label: string\n): UserMessage[] {\n  return (proposals ?? [])\n    .filter((proposal) => proposal.state === 'pending')\n    .map((proposal) => ({\n      id: `g${proposal.id}`,\n      role: 'user',\n      text: proposal.text,\n      createdAt: proposal.createdAt,\n      queued: true,\n      mode: 'queue',\n      from: label,\n      origin: 'guest',\n    }));\n}\n\nexport function proposalNotices(proposals: readonly GuestProposal[] | undefined): SystemMessage[] {\n  return (proposals ?? []).flatMap((proposal) => {\n    const title = ENDED[proposal.state];\n    if (!title) return [];\n    return [\n      {\n        id: `g${proposal.id}`,\n        role: 'system',\n        kind: 'notice',\n        title,\n        text: proposal.text,\n        createdAt: proposal.decidedAt ?? proposal.createdAt,\n      },\n    ];\n  });\n}\n\nexport function merged(messages: readonly Message[], notices: readonly SystemMessage[]): Message[] {\n  if (!notices.length) return [...messages];\n  const out: Message[] = [];\n  const left = [...notices].sort((a, b) => a.createdAt - b.createdAt);\n  for (const message of messages) {\n    while (left.length && (left[0] as SystemMessage).createdAt < message.createdAt)\n      out.push(left.shift() as SystemMessage);\n    out.push(message);\n  }\n  return [...out, ...left];\n}\n"],
+  "mappings": "AAGO,MAAM,aAAa;AACnB,MAAM,WAAW;AACjB,MAAM,YAAY;AAEzB,MAAM,QAAgC;AAAA,EACpC,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,WAAW;AACb;AAEO,SAAS,cACd,WACA,OACe;AACf,UAAQ,aAAa,CAAC,GACnB,OAAO,CAAC,aAAa,SAAS,UAAU,SAAS,EACjD,IAAI,CAAC,cAAc;AAAA,IAClB,IAAI,IAAI,SAAS,EAAE;AAAA,IACnB,MAAM;AAAA,IACN,MAAM,SAAS;AAAA,IACf,WAAW,SAAS;AAAA,IACpB,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ;AAAA,EACV,EAAE;AACN;AAEO,SAAS,gBAAgB,WAAkE;AAChG,UAAQ,aAAa,CAAC,GAAG,QAAQ,CAAC,aAAa;AAC7C,UAAM,QAAQ,MAAM,SAAS,KAAK;AAClC,QAAI,CAAC,MAAO,QAAO,CAAC;AACpB,WAAO;AAAA,MACL;AAAA,QACE,IAAI,IAAI,SAAS,EAAE;AAAA,QACnB,MAAM;AAAA,QACN,MAAM;AAAA,QACN;AAAA,QACA,MAAM,SAAS;AAAA,QACf,WAAW,SAAS,aAAa,SAAS;AAAA,MAC5C;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEO,SAAS,OAAO,UAA8B,SAA8C;AACjG,MAAI,CAAC,QAAQ,OAAQ,QAAO,CAAC,GAAG,QAAQ;AACxC,QAAM,MAAiB,CAAC;AACxB,QAAM,OAAO,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,SAAS;AAClE,aAAW,WAAW,UAAU;AAC9B,WAAO,KAAK,UAAW,KAAK,CAAC,EAAoB,YAAY,QAAQ;AACnE,UAAI,KAAK,KAAK,MAAM,CAAkB;AACxC,QAAI,KAAK,OAAO;AAAA,EAClB;AACA,SAAO,CAAC,GAAG,KAAK,GAAG,IAAI;AACzB;",
+  "names": []
+}

package/dist/types/client.d.ts

@@ -3,11 +3,12 @@ import type { ConversationView } from '@earendil-works/pi-durable';
 import type { Approval } from './approvals/record.ts';
 import type { ChangesView } from './changes/git.ts';
 import type { FrozenCone } from './freezer/index.ts';
+import type { GuestSeat } from './guests/seats.ts';
 import type { MemoryEntry, MemoryScope } from './memory/format.ts';
 import type { AgentRemote } from './remote/host.ts';
 import type { AgentPages } from './remote/pages.ts';
 import type { VaultState } from './secrets/vault.ts';
-import { AgentControl, AgentSettings, type AgentsSummary, type Command, type Delivered, type MonitorFeed, type PrivateRevision, type SendMode } from './services.ts';
+import { AgentControl, AgentSettings, type AgentsSummary, type Command, type Delivered, type GuestProposal, type GuestShown, type MonitorFeed, type PrivateRevision, type SendMode } from './services.ts';
 import type { Sprinkle } from './sprinkles/kind.ts';
 import { type PortEndpoint } from './wire.ts';
 export interface AgentConnection {
@@ -27,12 +28,16 @@ export interface AgentConnection {
     readonly monitor?: ReplicatedState<MonitorFeed>;
     readonly vault?: ReplicatedState<VaultState>;
     readonly labels?: ReplicatedState<Record<string, string>>;
+    readonly guests?: ReplicatedState<GuestSeat[]>;
+    readonly viewOnly?: boolean;
+    readonly guest?: GuestShown;
+    readonly proposals?: ReplicatedState<GuestProposal[]>;
+    readonly owner?: boolean;
     readonly approvals?: ReplicatedState<Approval[]>;
     readonly settings: AgentSettings;
     readonly remote?: AgentRemote;
     readonly pages?: AgentPages;
     readonly closed: Promise<Error | undefined>;
-    readonly mismatch?: string;
     readonly readOnly?: boolean;
     prompt(text: string, whenBusy?: SendMode): Promise<string>;
     webhook(name: string, delivery: {

package/dist/types/control.d.ts

@@ -3,6 +3,7 @@ import type { ChangesRuntime } from './changes/index.ts';
 import type { Cones } from './cone.ts';
 import type { Deliveries } from './deliveries.ts';
 import type { FreezerRuntime } from './freezer/index.ts';
+import type { Guests } from './guests/index.ts';
 import type { LickSources, Licks } from './licks/index.ts';
 import type { MemoryRuntime } from './memory/index.ts';
 import type { Monitor } from './monitor/index.ts';
@@ -23,4 +24,4 @@ export interface HostScoops {
 }
 export declare function readable(out: string): string;
 export declare function submissionId(value: string): SubmissionId | undefined;
-export declare function createAgentControl(harness: Harness, target: Conversation | Cones, deliveries?: Deliveries, licks?: HostLicks, scoops?: HostScoops, skills?: Pick<SkillsRuntime, 'expand' | 'commandsFor'>, sprinkles?: Pick<SprinklesRuntime, 'send' | 'call'>, memory?: Pick<MemoryRuntime, 'save' | 'remove'>, freezer?: Pick<FreezerRuntime, 'freeze' | 'newChat' | 'thaw' | 'discard'>, changes?: Pick<ChangesRuntime, 'open' | 'accept' | 'revert'>, monitor?: Pick<Monitor, 'open' | 'close'>, secrets?: () => readonly SecretName[], uploads?: Uploads, labels?: Pick<LabelsRuntime, 'label'>): AgentControl;
+export declare function createAgentControl(harness: Harness, target: Conversation | Cones, deliveries?: Deliveries, licks?: HostLicks, scoops?: HostScoops, skills?: Pick<SkillsRuntime, 'expand' | 'commandsFor'>, sprinkles?: Pick<SprinklesRuntime, 'send' | 'call'>, memory?: Pick<MemoryRuntime, 'save' | 'remove'>, freezer?: Pick<FreezerRuntime, 'freeze' | 'newChat' | 'thaw' | 'discard'>, changes?: Pick<ChangesRuntime, 'open' | 'accept' | 'revert'>, monitor?: Pick<Monitor, 'open' | 'close'>, secrets?: () => readonly SecretName[], uploads?: Uploads, labels?: Pick<LabelsRuntime, 'label'>, guests?: Pick<Guests, 'open' | 'revoke'>): AgentControl;

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

@@ -0,0 +1,9 @@
+export declare const GUEST_INPUT_KIND = "slicc.guest-input";
+export type GuestInput = {
+    seat: string;
+    name: string;
+    approval: string | null;
+};
+export declare function guestContent(name: string, text: string): string;
+export declare function guestHeader(name: string): string;
+export declare function guestText(text: string, name: string): string;

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

@@ -0,0 +1,12 @@
+import { type AgentConnection } from '../client.ts';
+import { type GuestShown } from '../services.ts';
+import { type PortEndpoint } from '../wire.ts';
+import type { Proposed, ProposeRequest } from './index.ts';
+export declare const GUEST_ONLY = "a guest can only watch and send messages";
+export declare const SEAT_REFUSED = "This guest link isn't valid any more.";
+export declare const proposedSentence: (reason: string) => string;
+export interface GuestConnection extends AgentConnection {
+    readonly guest: GuestShown;
+    propose(request: ProposeRequest): Promise<Proposed>;
+}
+export declare function connectGuest(endpoint: PortEndpoint): Promise<GuestConnection>;

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

@@ -0,0 +1,5 @@
+import { type Extension, type Harness } from '@earendil-works/pi-durable';
+export declare const GUEST_GUARD = "slicc-guest-guard";
+export declare const GUEST_REQUEST = "guest:";
+export declare const GUEST_TOOLS_BLOCKED = "Tool calls in a run a guest started need a review, which this agent can't do yet.";
+export declare function guestGuard(harness: () => Pick<Harness, 'submission'> | undefined): Extension;

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

@@ -0,0 +1,54 @@
+import { type Context, type ReplicatedState } from '@earendil-works/chord';
+import { type Harness } from '@earendil-works/pi-durable';
+import type { Agents } from '../agents.ts';
+import type { Approvals } from '../approvals/index.ts';
+import type { GuestPrincipal } from '../serving.ts';
+import { type GuestDraft, type GuestSeat, type SeatRecord } from './seats.ts';
+export type GuestOpened = {
+    seat: GuestSeat;
+    error: null;
+} | {
+    seat: null;
+    error: string;
+};
+export type Proposed = {
+    state: 'submitted';
+    submissionId: string;
+    reason: null;
+} | {
+    state: 'pending';
+    submissionId: null;
+    approval: string;
+    reason: null;
+} | {
+    state: 'unanswered';
+    submissionId: null;
+    reason: string;
+};
+export interface ProposeRequest {
+    text: string;
+    requestId: string | null;
+}
+export interface Guests {
+    readonly seats: ReplicatedState<GuestSeat[]>;
+    open(draft: GuestDraft, context: Context): Promise<GuestOpened>;
+    revoke(id: string, context: Context): Promise<{
+        revoked: boolean;
+    }>;
+    admit(id: string, label: string): GuestPrincipal | null;
+    record(id: string): SeatRecord | undefined;
+    current(guest: GuestPrincipal): SeatRecord | undefined;
+    joined(id: string): () => void;
+    onEnd(listener: (id: string) => void): () => void;
+    propose(guest: GuestPrincipal, request: ProposeRequest, context: Context): Promise<Proposed>;
+    dispose(): void;
+}
+export interface GuestsOptions {
+    harness: Pick<Harness, 'commit' | 'abortSubmission'>;
+    agents: Pick<Agents, 'state' | 'conversation'>;
+    approvals?: Pick<Approvals, 'state' | 'request' | 'withdrawSeat'>;
+    now?: () => number;
+    context?: Context;
+}
+export declare const MAX_PROPOSAL = 32000;
+export declare function createGuests(options: GuestsOptions): Promise<Guests>;

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

@@ -0,0 +1,39 @@
+import type { ApprovalTier } from '../approvals/record.ts';
+export type GuestGate = ApprovalTier | 'off';
+export type GuestGates = {
+    messages: GuestGate;
+    tools: GuestGate;
+};
+export type GuestDraft = {
+    id: string;
+    label: string;
+    agentId: string;
+    expiresAt: number | null;
+    gates: GuestGates;
+};
+export type SeatRecord = GuestDraft & {
+    createdAt: number;
+    epoch: number;
+    revoked: number | null;
+    delivered?: string[];
+};
+export interface GuestSeat {
+    id: string;
+    label: string;
+    agentId: string;
+    createdAt: number;
+    expiresAt: number | null;
+    gates: GuestGates;
+    connected: boolean;
+    pending: number;
+}
+export type GuestsState = {
+    seats: Record<string, SeatRecord>;
+};
+export declare const GuestsDoc: import("@earendil-works/pi-durable").SessionDocToken<GuestsState>;
+export declare const MAX_SEAT_MS: number;
+export declare const MAX_LABEL = 64;
+export declare function cleanLabel(raw: unknown): string;
+export declare function isGate(value: unknown): value is GuestGate;
+export declare function checkDraft(draft: GuestDraft, now: number): string | null;
+export declare function liveSeat(seat: SeatRecord | undefined, now: number): boolean;

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

@@ -0,0 +1,17 @@
+import type { Context, Host, ReplicatedState } from '@earendil-works/chord';
+import type { ConversationView } from '@earendil-works/pi-durable';
+import type { Agents } from '../agents.ts';
+import type { Approval } from '../approvals/index.ts';
+import type { AgentGuest, GuestProposal } from '../services.ts';
+import type { GuestPrincipal } from '../serving.ts';
+import { type PortEndpoint } from '../wire.ts';
+import type { Guests } from './index.ts';
+export declare function proposalsOf(items: readonly Approval[] | undefined, seat: string): GuestProposal[];
+export declare function guestOpener(guests: Guests, agents: Pick<Agents, 'state'>, views: ReplicatedState<Record<string, ConversationView>>, context: Context, approvals?: ReplicatedState<Approval[]>): (principal: GuestPrincipal) => {
+    value: AgentGuest;
+    dispose(): void;
+} | undefined;
+export declare function admitGuest(guests: Guests, endpoint: PortEndpoint, asked: {
+    id: string;
+    label: string;
+}, serverId: string, link: number, host: Pick<Host, 'accept'>): void;

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

@@ -0,0 +1,3 @@
+import type { ConversationView } from '@earendil-works/pi-durable';
+export declare const EMPTY_VIEW: ConversationView;
+export declare function guestView(view: ConversationView | undefined, seat: string): ConversationView;

package/dist/types/host.d.ts

@@ -1,9 +1,10 @@
-import { type Context, type Host, type ReplicatedState } from '@earendil-works/chord';
+import { type Context, type Host, type Readable, type ReplicatedState } from '@earendil-works/chord';
 import type { Agent } from './agent.ts';
 import { type ApprovalJudge, type Approvals, type DecidedBy } from './approvals/index.ts';
 import type { ChangesRuntime } from './changes/index.ts';
 import { type HostLicks, type HostScoops } from './control.ts';
 import type { FreezerRuntime } from './freezer/index.ts';
+import { type Guests } from './guests/index.ts';
 import type { UserClients } from './kernel/users.ts';
 import type { McpRuntime } from './mcp/index.ts';
 import type { MemoryRuntime } from './memory/index.ts';
@@ -12,7 +13,8 @@ import { type AgentRemote } from './remote/host.ts';
 import { type Pages } from './remote/pages.ts';
 import type { SecretName } from './secrets/names.ts';
 import type { VaultState } from './secrets/vault.ts';
-import { AgentControl, AgentSettings, AgentTranscript } from './services.ts';
+import { AgentControl, type AgentGuest, AgentSettings, AgentTranscript } from './services.ts';
+import { type GuestPrincipal, type Seat } from './serving.ts';
 import type { SkillsRuntime } from './skills/index.ts';
 import type { SprinklesRuntime } from './sprinkles/index.ts';
 import { type Thumbnail } from './thumbs.ts';
@@ -22,12 +24,17 @@ import { type PortEndpoint } from './wire.ts';
 export interface ConnectOptions {
     readOnly?: boolean;
     pages?: boolean;
+    guest?: {
+        id: string;
+        label: string;
+    };
 }
 export interface AgentHost {
     readonly serverId: string;
     readonly agent: Agent;
     readonly users?: UserClients;
     readonly pages: Pages;
+    readonly guests: Guests;
     readonly approvals: Approvals;
     connect(endpoint: PortEndpoint, options?: ConnectOptions): void;
     close(): Promise<void>;
@@ -67,7 +74,17 @@ interface Served {
     settings: AgentSettings;
     remote: AgentRemote;
     pages: Pages;
+    guest?: (principal: GuestPrincipal) => {
+        value: AgentGuest;
+        dispose(): void;
+    } | undefined;
     decide: (by: DecidedBy) => AgentControl['decide'];
 }
+export declare const CLOSED_TO_GUESTS = "a guest seat has only its transcript and propose";
+export declare const openToGuests: <F extends object>(factory: F) => F;
+export declare function closedToGuests(host: Host): Host;
+export declare function lazily<T>(state: () => ReplicatedState<T>): Readable<T>;
+export declare const GUEST_MANAGERS: ReadonlySet<Seat>;
+export declare const OWNER_GUESTS = "only the owner can invite or revoke guests";
 export declare function serveAgent(serving: Served): Host;
 export {};

package/dist/types/index.d.ts

@@ -4,6 +4,9 @@ export { APPROVAL_MS, type Approval, type ApprovalAnswer, type ApprovalDecided,
 export { FILE_LIMIT, IMAGE_LIMIT, type SendAttachment, type ShownAttachment, splitUser, TOTAL_LIMIT, userParts, } from './attachments.ts';
 export { type AgentConnection, connectAgent } from './client.ts';
 export { createAgentControl } from './control.ts';
+export { connectGuest, GUEST_ONLY, type GuestConnection, SEAT_REFUSED, } from './guests/client.ts';
+export type { GuestOpened, Proposed, ProposeRequest } from './guests/index.ts';
+export type { GuestDraft, GuestGate, GuestGates, GuestSeat } from './guests/seats.ts';
 export { type AgentHost, type ConnectOptions, hostAgent } from './host.ts';
 export type { KernelClient, KernelFs, KernelProcess, KernelStat, SpawnOptions, } from './kernel/client.ts';
 export { HOME, type KernelEnvOptions, kernelEnvironment, SliccKernelEnv } from './kernel/env.ts';
@@ -18,5 +21,5 @@ export { BEDROCK, createAgentSettings, createSliccModels, DEFAULT_MODEL, DEFAULT
 export { AGENT_DIRECTORY, type OpfsSqliteOptions, openMemorySqliteStorage, openOpfsSqliteStorage, WasmSqliteDatabase, } from './sqlite.ts';
 export { type SystemFacts, systemSection } from './system.ts';
 export { UPLOADS, type Uploads, upload } from './uploads.ts';
-export { LINK_PROTOCOL, type PortEndpoint, PortLink } from './wire.ts';
+export { type PortEndpoint, PortLink } from './wire.ts';
 export { type KernelPorts, kernelPort, kernelPorts, serveConnections, type WorkerScope, } from './worker.ts';

package/dist/types/owner.d.ts

@@ -9,6 +9,10 @@ export interface AgentWorker {
 export interface PortOptions {
     readOnly?: boolean;
     pages?: boolean;
+    guest?: {
+        id: string;
+        label: string;
+    };
 }
 export interface AgentOwner {
     connect(options?: PortOptions): Promise<AgentConnection>;

package/dist/types/page.d.ts

@@ -1,4 +1,5 @@
 export { type AgentConnection, connectAgent } from './client.ts';
+export { connectGuest, GUEST_ONLY, type GuestConnection, SEAT_REFUSED, } from './guests/client.ts';
 export { type ByteSink, bridgePort, encodeFrame, FrameReader, type LinkEnd, linkEndpoint, MAX_FRAME, } from './link.ts';
 export { AGENT_LOCK, type AgentOwner, type AgentWorker, type KernelSource, type OwnerOptions, type PortOptions, startAgent, } from './owner.ts';
 export { type RemoteControl, type RemoteEvent, type RemoteOptions, remoteControl, } from './remote/client.ts';

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/agent-port.d.ts

@@ -5,7 +5,6 @@ import type { Command } from '../services.ts';
 import { Emitter } from './emitter.ts';
 export declare const CONE = "cone";
 export declare function slashCommand({ kind, ...command }: Command): SlashCommand;
-export declare const WATCH_ONLY = "Watch only.";
 export type AgentHold = VaultHold;
 export type AgentAdapterEvents = AgentEvents & {
     hold: AgentHold | null;
@@ -16,7 +15,6 @@ export declare class AgentAdapter extends Emitter<AgentAdapterEvents> implements
     notify(text: string, agentId?: string): void;
     ready(): Promise<void>;
     hold(): AgentHold | null;
-    readOnly(): string | null;
     list(): readonly Agent[];
     active(): string;
     select(id: string): void;

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,14 +15,22 @@ 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';
-export { type HostNotices, KEYS_MOVED, MISMATCH, mismatchBanner, movedList, movedNotice, NoticesAdapter, } from './notices-port.ts';
+export { type HostNotices, KEYS_MOVED, movedList, movedNotice, NoticesAdapter, } from './notices-port.ts';
 export { PageAdapter, type PageDocument, type PageOptions, type PageRun, type PageTarget, } from './page-port.ts';
 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/notices-port.d.ts

@@ -4,8 +4,6 @@ import type { AgentSettings } from '../services.ts';
 import { type Report } from './attempt.ts';
 import { Emitter } from './emitter.ts';
 export declare const KEYS_MOVED = "keys-moved";
-export declare const MISMATCH = "agent-mismatch";
-export declare function mismatchBanner(text: string): Notice;
 export declare function movedList(accounts: readonly MovedName[]): string;
 export declare function movedNotice(accounts: readonly MovedName[]): Notice;
 export type HostNotices = Pick<NoticesPort, 'list' | 'act' | 'dismiss' | 'on'>;
@@ -13,7 +11,7 @@ export declare class NoticesAdapter extends Emitter<{
     notices: readonly Notice[];
 }> implements NoticesPort {
     #private;
-    constructor(settings: AgentSettings, report: Report, mismatch?: string, host?: HostNotices);
+    constructor(settings: AgentSettings, report: Report, host?: HostNotices);
     list(): readonly Notice[];
     act(id: string, action: string): Promise<void>;
     dismiss(id: string): void;

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/types/wire.d.ts

@@ -11,13 +11,6 @@ export type Frame = {
 } | {
     close: true;
 } | Uint8Array;
-export declare const LINK_PROTOCOL = 2;
-export interface Greeting {
-    protocol: number;
-    serverId: string;
-}
-export declare const greeting: (serverId: string) => string;
-export declare function greeted(hello: string): Greeting;
 export declare class PortLink implements Link {
     #private;
     readonly hello: Promise<string>;

package/dist/wire.js

@@ -1,10 +1,3 @@
-const LINK_PROTOCOL = 2;
-const GREETING = /^slicc-agent-link\/(\d+) (.+)$/;
-const greeting = (serverId) => `slicc-agent-link/${LINK_PROTOCOL} ${serverId}`;
-function greeted(hello) {
-  const found = GREETING.exec(hello);
-  return found ? { protocol: Number(found[1]), serverId: found[2] } : { protocol: 1, serverId: hello };
-}
 const encoder = new TextEncoder();
 const decoder = new TextDecoder();
 function parse(chunk) {
@@ -45,7 +38,7 @@ class PortLink {
     return this.#closed;
   }
   greet(serverId) {
-    this.#endpoint.postMessage({ hello: greeting(serverId) });
+    this.#endpoint.postMessage({ hello: serverId });
   }
   send(frame) {
     if (this.#closed) return;
@@ -98,9 +91,6 @@ class PortLink {
   }
 }
 export {
-  LINK_PROTOCOL,
-  PortLink,
-  greeted,
-  greeting
+  PortLink
 };
 //# sourceMappingURL=wire.js.map

package/dist/wire.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/wire.ts"],
-  "sourcesContent": ["import type { Frame as ChordFrame, Link } from '@earendil-works/chord';\n\nexport interface PortEndpoint {\n  postMessage(message: unknown, transfer?: Transferable[]): void;\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n  addEventListener(\n    type: 'close' | 'messageerror' | 'error',\n    listener: (event: Event) => void\n  ): void;\n  start?(): void;\n  close?(): void;\n}\n\nexport type Frame = { hello: string } | { close: true } | Uint8Array;\n\nexport const LINK_PROTOCOL = 2;\n\nconst GREETING = /^slicc-agent-link\\/(\\d+) (.+)$/;\n\nexport interface Greeting {\n  protocol: number;\n  serverId: string;\n}\n\nexport const greeting = (serverId: string): string =>\n  `slicc-agent-link/${LINK_PROTOCOL} ${serverId}`;\n\nexport function greeted(hello: string): Greeting {\n  const found = GREETING.exec(hello);\n  return found\n    ? { protocol: Number(found[1]), serverId: found[2] as string }\n    : { protocol: 1, serverId: hello };\n}\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\n\nfunction parse(chunk: Uint8Array): ChordFrame {\n  const frame = JSON.parse(decoder.decode(chunk)) as { t?: unknown } | null;\n  if (frame === null || typeof frame !== 'object' || typeof frame.t !== 'string')\n    throw new TypeError('not a chord frame');\n  return frame as ChordFrame;\n}\n\nexport class PortLink implements Link {\n  readonly hello: Promise<string>;\n  readonly ended: Promise<Error | undefined>;\n  readonly #endpoint: PortEndpoint;\n  readonly #queue: Uint8Array[] = [];\n  readonly #closers = new Set<(reason: string) => void>();\n  #handler: ((frame: ChordFrame) => void) | undefined;\n  #closed = false;\n  #greet!: (hello: string) => void;\n  #refuse!: (error: Error) => void;\n  #finish!: (reason: Error | undefined) => void;\n\n  constructor(endpoint: PortEndpoint) {\n    this.#endpoint = endpoint;\n    this.hello = new Promise((greet, refuse) => {\n      this.#greet = greet;\n      this.#refuse = refuse;\n    });\n    this.hello.catch(() => undefined);\n    this.ended = new Promise((finish) => {\n      this.#finish = finish;\n    });\n    endpoint.addEventListener('message', ({ data }) => this.#receive(data as Frame));\n    const failed = (event: Event) => this.#end(`agent port ${event.type}`, true);\n    endpoint.addEventListener('messageerror', failed);\n    endpoint.addEventListener('error', failed);\n    endpoint.addEventListener('close', () => this.#end('peer closed', false));\n    endpoint.start?.();\n  }\n\n  get closed(): boolean {\n    return this.#closed;\n  }\n\n  greet(serverId: string): void {\n    this.#endpoint.postMessage({ hello: greeting(serverId) } satisfies Frame);\n  }\n\n  send(frame: ChordFrame): void {\n    if (this.#closed) return;\n    const bytes = encoder.encode(JSON.stringify(frame));\n    this.#endpoint.postMessage(bytes, [bytes.buffer]);\n  }\n\n  receive(handler: (frame: ChordFrame) => void): void {\n    this.#handler = handler;\n    for (const chunk of this.#queue.splice(0)) this.#deliver(chunk);\n  }\n\n  onClose(handler: (reason: string) => void): void {\n    if (this.#closed) handler('closed');\n    else this.#closers.add(handler);\n  }\n\n  close(reason = 'closed'): void {\n    if (this.#closed) return;\n    this.send({ t: 'bye', reason });\n    this.#endpoint.postMessage({ close: true } satisfies Frame);\n    this.#end(reason, false);\n  }\n\n  #receive(frame: Frame): void {\n    if (this.#closed) return;\n    if (frame instanceof Uint8Array) {\n      if (this.#handler) this.#deliver(frame);\n      else this.#queue.push(frame);\n    } else if ('hello' in frame) this.#greet(frame.hello);\n    else this.#end('peer closed', false);\n  }\n\n  #deliver(chunk: Uint8Array): void {\n    let frame: ChordFrame;\n    try {\n      frame = parse(chunk);\n    } catch {\n      this.close('protocol error');\n      return;\n    }\n    if (frame.t === 'bye') this.#end(frame.reason ?? 'peer closed', false);\n    else this.#handler?.(frame);\n  }\n\n  #end(reason: string, failed: boolean): void {\n    if (this.#closed) return;\n    this.#closed = true;\n    this.#queue.length = 0;\n    this.#endpoint.close?.();\n    const error = new Error(reason);\n    this.#refuse(new Error(`agent port closed before hello: ${reason}`));\n    this.#finish(failed ? error : undefined);\n    for (const handler of [...this.#closers]) handler(reason);\n    this.#closers.clear();\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { Frame as ChordFrame, Link } from '@earendil-works/chord';\n\nexport interface PortEndpoint {\n  postMessage(message: unknown, transfer?: Transferable[]): void;\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n  addEventListener(\n    type: 'close' | 'messageerror' | 'error',\n    listener: (event: Event) => void\n  ): void;\n  start?(): void;\n  close?(): void;\n}\n\nexport type Frame = { hello: string } | { close: true } | Uint8Array;\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\n\nfunction parse(chunk: Uint8Array): ChordFrame {\n  const frame = JSON.parse(decoder.decode(chunk)) as { t?: unknown } | null;\n  if (frame === null || typeof frame !== 'object' || typeof frame.t !== 'string')\n    throw new TypeError('not a chord frame');\n  return frame as ChordFrame;\n}\n\nexport class PortLink implements Link {\n  readonly hello: Promise<string>;\n  readonly ended: Promise<Error | undefined>;\n  readonly #endpoint: PortEndpoint;\n  readonly #queue: Uint8Array[] = [];\n  readonly #closers = new Set<(reason: string) => void>();\n  #handler: ((frame: ChordFrame) => void) | undefined;\n  #closed = false;\n  #greet!: (hello: string) => void;\n  #refuse!: (error: Error) => void;\n  #finish!: (reason: Error | undefined) => void;\n\n  constructor(endpoint: PortEndpoint) {\n    this.#endpoint = endpoint;\n    this.hello = new Promise((greet, refuse) => {\n      this.#greet = greet;\n      this.#refuse = refuse;\n    });\n    this.hello.catch(() => undefined);\n    this.ended = new Promise((finish) => {\n      this.#finish = finish;\n    });\n    endpoint.addEventListener('message', ({ data }) => this.#receive(data as Frame));\n    const failed = (event: Event) => this.#end(`agent port ${event.type}`, true);\n    endpoint.addEventListener('messageerror', failed);\n    endpoint.addEventListener('error', failed);\n    endpoint.addEventListener('close', () => this.#end('peer closed', false));\n    endpoint.start?.();\n  }\n\n  get closed(): boolean {\n    return this.#closed;\n  }\n\n  greet(serverId: string): void {\n    this.#endpoint.postMessage({ hello: serverId } satisfies Frame);\n  }\n\n  send(frame: ChordFrame): void {\n    if (this.#closed) return;\n    const bytes = encoder.encode(JSON.stringify(frame));\n    this.#endpoint.postMessage(bytes, [bytes.buffer]);\n  }\n\n  receive(handler: (frame: ChordFrame) => void): void {\n    this.#handler = handler;\n    for (const chunk of this.#queue.splice(0)) this.#deliver(chunk);\n  }\n\n  onClose(handler: (reason: string) => void): void {\n    if (this.#closed) handler('closed');\n    else this.#closers.add(handler);\n  }\n\n  close(reason = 'closed'): void {\n    if (this.#closed) return;\n    this.send({ t: 'bye', reason });\n    this.#endpoint.postMessage({ close: true } satisfies Frame);\n    this.#end(reason, false);\n  }\n\n  #receive(frame: Frame): void {\n    if (this.#closed) return;\n    if (frame instanceof Uint8Array) {\n      if (this.#handler) this.#deliver(frame);\n      else this.#queue.push(frame);\n    } else if ('hello' in frame) this.#greet(frame.hello);\n    else this.#end('peer closed', false);\n  }\n\n  #deliver(chunk: Uint8Array): void {\n    let frame: ChordFrame;\n    try {\n      frame = parse(chunk);\n    } catch {\n      this.close('protocol error');\n      return;\n    }\n    if (frame.t === 'bye') this.#end(frame.reason ?? 'peer closed', false);\n    else this.#handler?.(frame);\n  }\n\n  #end(reason: string, failed: boolean): void {\n    if (this.#closed) return;\n    this.#closed = true;\n    this.#queue.length = 0;\n    this.#endpoint.close?.();\n    const error = new Error(reason);\n    this.#refuse(new Error(`agent port closed before hello: ${reason}`));\n    this.#finish(failed ? error : undefined);\n    for (const handler of [...this.#closers]) handler(reason);\n    this.#closers.clear();\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

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?.()
     );
   });