@ai-ecoverse/slicc-agent 5.7.0 → 5.8.1

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

@@ -1,5 +1,32 @@
 import { type Extension, type Harness } from '@earendil-works/pi-durable';
+import type { Approval, Approvals } from '../approvals/index.ts';
+import { type GuestPolicy } from './policy.ts';
 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;
+export declare const GUEST_TOOL_MEMO = "slicc.guest-tool";
+export declare const SUMMARY_LENGTH = 2000;
+export declare const GATE_REASONS: {
+    readonly unknown: 'A guest started this run, and its seat names no review for tool calls that this agent knows.';
+    readonly ended: "A guest started this run, and that guest's seat has ended.";
+    readonly rejected: 'The owner declined this tool call in a run a guest started.';
+    readonly judged: 'The automatic check declined this tool call in a run a guest started';
+    readonly unanswered: 'Nobody approved this tool call in a run a guest started in time.';
+    readonly unroutable: "The cone can't review a tool call it is itself waiting on.";
+    readonly scoop: "No scoop can review a guest's tool call yet, so this one is denied.";
+    readonly withdrawn: 'The review of this tool call was withdrawn.';
+};
+export interface GateHost {
+    approvals: Pick<Approvals, 'state' | 'request' | 'settled' | 'withdraw'>;
+    policy(): GuestPolicy;
+    now?: () => number;
+}
+export interface GuestToolGate {
+    readonly extension: Extension;
+    bind(host: GateHost): void;
+}
+type Held = Pick<Harness, 'submission' | 'commit' | 'waitForTask'>;
+export declare function canonical(value: unknown): string;
+export declare function summaryOf(args: Record<string, unknown>): string;
+export declare function reasonOf(item: Approval): string;
+export declare function guestToolGate(harness: () => Held | undefined): GuestToolGate;
+export {};

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

@@ -39,6 +39,9 @@ export interface Guests {
     revoke(id: string, context: Context): Promise<{
         revoked: boolean;
     }>;
+    forgetAlways(id: string, approval: string, context: Context): Promise<{
+        removed: boolean;
+    }>;
     admit(id: string, label: string): GuestPrincipal | null;
     record(id: string): SeatRecord | undefined;
     current(guest: GuestPrincipal): SeatRecord | undefined;

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

@@ -17,6 +17,13 @@ export type SeatSubmission = {
     approval: string | null;
     tools: GuestGate;
 };
+export type AlwaysTool = {
+    approval: string;
+    tool: string;
+    arguments: string;
+    by: DecidedBy | null;
+    at: number;
+};
 export type SeatRecord = GuestDraft & {
     createdAt: number;
     epoch: number;
@@ -28,6 +35,7 @@ export type SeatRecord = GuestDraft & {
         approval: string;
         at: number;
     };
+    alwaysTools?: AlwaysTool[];
 };
 export interface GuestSeat {
     id: string;
@@ -38,6 +46,7 @@ export interface GuestSeat {
     gates: GuestGates;
     connected: boolean;
     pending: number;
+    alwaysTools: AlwaysTool[];
 }
 export type GuestsState = {
     seats: Record<string, SeatRecord>;

package/dist/types/services.d.ts

@@ -95,6 +95,9 @@ export interface AgentControl {
     guestRevoke(id: string, context: Context): Promise<{
         revoked: boolean;
     }>;
+    guestAlwaysForget(seat: string, approval: string, context: Context): Promise<{
+        removed: boolean;
+    }>;
     approvalPolicySet(change: ApprovalPolicyChange, context: Context): Promise<ApprovalPolicySet>;
     decide(id: string, decision: ApprovalAnswer, reason: string | null, context: Context): Promise<ApprovalDecided>;
 }
@@ -241,7 +244,7 @@ export interface AgentSettingsChange {
     thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
     agentId?: string | null;
 }
-export declare const CONTROL_METHODS: ("abort" | "agentCommands" | "approvalPolicySet" | "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_METHODS: ("abort" | "agentCommands" | "approvalPolicySet" | "changeAccept" | "changeRevert" | "changesOpen" | "compact" | "compactAgent" | "configure" | "createCone" | "createScoop" | "decide" | "discard" | "drop" | "freeze" | "guestAlwaysForget" | "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 OWNER_DEVICE_METHODS: readonly (keyof AgentControl & string)[];
 export declare const CONTROL_READS: readonly (keyof AgentControl & string)[];
 export declare const AgentControl: RemoteContract;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "5.7.0",
+  "version": "5.8.1",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -65,8 +65,8 @@
   "devDependencies": {
     "@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.81.0",
+    "@ai-ecoverse/slicc-shared-web": "1.21.1",
+    "@ai-ecoverse/slicc-spectrum": "1.83.0",
     "@ai-ecoverse/wasm-bash": "5.3.0-18",
     "@ai-ecoverse/wasm-coreutils": "9.12.0-7",
     "@ai-ecoverse/wasm-git": "2.55.0-15",
@@ -81,7 +81,7 @@
     "typescript": "7.0.2"
   },
   "dependencies": {
-    "@ai-ecoverse/slicc-browsers": "1.7.3",
+    "@ai-ecoverse/slicc-browsers": "1.7.5",
     "@ai-ecoverse/slicc-vault": "1.9.1",
     "@earendil-works/chord": "1.2.0",
     "@earendil-works/pi-ai": "1.3.0",