@ai-ecoverse/slicc-agent 5.9.0 → 5.10.0

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

@@ -25,16 +25,21 @@ export interface Approvals {
     }, context: Context): Promise<Approval>;
     decide(id: string, answer: unknown, reason: string | null, by: Decider, context: Context): Promise<ApprovalDecided>;
     settled(id: string, context: Context): Promise<Approval>;
+    assign(id: string, reviewer: string, context: Context): Promise<Approval | undefined>;
     withdraw(id: string, reason: string | null, context: Context): Promise<Approval | undefined>;
     withdrawSeat(seat: string, context: Context): Promise<number>;
     expire(id: string, context: Context): Promise<Approval | undefined>;
     close(): void;
 }
+export interface ScoopRouter {
+    route(item: Approval): Promise<void>;
+}
 export interface ApprovalsAttach {
     harness: Pick<Harness, 'commit' | 'documentState'>;
     now?: () => number;
     ttlMs?: number;
     judge?: ApprovalJudge;
+    scoops?: ScoopRouter;
     guestAlways?: (kind: ApprovalKind) => boolean;
     sudoApprover?: () => unknown;
 }

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

@@ -2,7 +2,7 @@ export type ApprovalKind = 'guest-message' | 'guest-tool' | 'sudo';
 export type ApprovalState = 'pending' | 'approved' | 'rejected' | 'unanswered' | 'withdrawn';
 export type ApprovalTier = 'user' | 'agent' | 'cone' | `scoop:${string}`;
 export type ApprovalAnswer = 'once' | 'always' | 'deny';
-export type DecidedBy = 'owner' | 'follower' | 'judge' | 'host';
+export type DecidedBy = 'owner' | 'follower' | 'judge' | 'host' | `scoop:${string}`;
 export type ApprovalRequester = {
     kind: 'guest' | 'agent' | 'user';
     name: string;
@@ -49,6 +49,7 @@ type Base = {
     decidedBy: DecidedBy | null;
     device?: string;
     answer?: 'once' | 'always';
+    reviewer?: string;
     reason?: string;
     verdict?: ApprovalVerdict;
     always: boolean;
@@ -93,13 +94,18 @@ export declare const REASONS: {
     readonly revoked: 'revoked';
     readonly aborted: 'aborted';
     readonly disconnected: 'disconnected';
+    readonly noScoop: 'no-scoop';
+    readonly scoopStopped: 'scoop-stopped';
+    readonly scoopAsked: 'scoop-asked';
+    readonly scoopUndecided: 'scoop-undecided';
 };
 export declare const guestKind: (kind: ApprovalKind) => boolean;
+export declare const scoopTier: (tier: unknown) => tier is `scoop:${string}`;
 export declare function knownTier(tier: unknown): tier is ApprovalTier;
 export declare function routable(kind: ApprovalKind, tier: ApprovalTier): boolean;
 export declare function answerOf(value: unknown): ApprovalAnswer | null;
 export declare const personal: (by: DecidedBy) => boolean;
-export declare function answerer(by: DecidedBy, tier: string): boolean;
+export declare function answerer(by: DecidedBy, item: Pick<Approval, 'tier' | 'reviewer'>): boolean;
 export type SudoApprover = 'user' | 'agent';
 export declare const sudoApprover: (value: unknown) => SudoApprover;
 export declare const tierOf: (kind: ApprovalKind, tier: string, sudo: SudoApprover) => string;

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

@@ -1,6 +1,8 @@
-import { type Extension, type Harness } from '@earendil-works/pi-durable';
+import type { Context } from '@earendil-works/chord';
+import { type Extension, type Harness, type SubmissionId } from '@earendil-works/pi-durable';
 import type { Approval, Approvals } from '../approvals/index.ts';
 import { type GuestPolicy } from './policy.ts';
+import { type SeatRecord } from './seats.ts';
 export declare const GUEST_GUARD = "slicc-guest-guard";
 export declare const GUEST_REQUEST = "guest:";
 export declare const GUEST_TOOL_MEMO = "slicc.guest-tool";
@@ -12,7 +14,6 @@ export declare const GATE_REASONS: {
     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: "This review isn't available yet.";
     readonly withdrawn: 'The review of this tool call was withdrawn.';
 };
 export interface GateHost {
@@ -25,8 +26,13 @@ export interface GuestToolGate {
     bind(host: GateHost): void;
 }
 type Held = Pick<Harness, 'submission' | 'commit' | 'waitForTask'>;
+type Taint = {
+    seat: SeatRecord | null;
+    tier: string;
+};
 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 taintsOf(inputs: readonly SubmissionId[], seats: Readonly<Record<string, SeatRecord>>, harness: Pick<Harness, 'submission'>, context: Context): Promise<Taint[]>;
 export declare function guestToolGate(harness: () => Held | undefined): GuestToolGate;
 export {};

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

@@ -13,7 +13,6 @@ export type GuestPolicy = {
 export type GuestPolicyChange = Partial<GuestPolicy>;
 export declare const GATE_KINDS: readonly GateKind[];
 export declare const DEFAULT_GUEST_POLICY: GuestPolicy;
-export declare const SCOOP_REVIEW_LATER = "This review isn't available yet.";
 export declare const MAX_SEAT_DAYS = 365;
 export declare const DAY_MS: number;
 export declare const GUESTS_MANAGE_DENIED = "The owner's guest policy doesn't let guests manage guests.";

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

@@ -0,0 +1,45 @@
+import type { Context } from '@earendil-works/chord';
+import { type Extension, type Harness } from '@earendil-works/pi-durable';
+import { type AgentsState, type ScoopRecord } from '../agents.ts';
+import type { Approval, Approvals } from '../approvals/index.ts';
+import { type OwnerIntent } from '../approvals/judge.ts';
+export declare const SCOOP_DECIDE = "approval_decide";
+export declare const SCOOP_APPROVALS = "slicc-scoop-approvals";
+export declare const SCOOP_REVIEW_TASK = "slicc.scoop-approval";
+export declare const SCOOP_REQUEST = "scoop-approval:";
+export type ScoopReview = {
+    approval: string;
+    scoop: string;
+    name: string;
+};
+export declare const ScoopReviewDoc: import("@earendil-works/pi-durable").ConversationDocToken<ScoopReview>;
+export declare const ScoopRoutesDoc: import("@earendil-works/pi-durable").SessionDocToken<{
+    routes: Record<string, number>;
+}>;
+export interface ScoopReviewHost {
+    approvals: Pick<Approvals, 'decide' | 'assign'>;
+    agents: {
+        state(): Readonly<AgentsState>;
+    };
+    harness: Pick<Harness, 'commit'>;
+    intent?: (item: Approval, context: Context) => Promise<OwnerIntent | null>;
+    nonce?: () => string;
+}
+export interface ScoopReviews {
+    readonly extension: Extension;
+    route(item: Approval): Promise<void>;
+    bind(host: ScoopReviewHost): void;
+}
+export type Reviewer = {
+    id: string;
+    record: ScoopRecord;
+};
+export declare function reviewerOf(state: Readonly<AgentsState>, agentId: string, tier: string): Reviewer | undefined;
+export declare function askedOf(item: Approval, reviewer: Reviewer): boolean;
+export declare function reviewersOf(harness: Pick<Harness, 'snapshot' | 'submission'>, state: Readonly<AgentsState>, cone: string, context: Context): Promise<string[]>;
+export declare function reviewPrompt(item: Approval, name: string, seat: {
+    id: string;
+    label: string;
+    gates: object;
+} | null, intent: OwnerIntent | null, nonce: string): string;
+export declare function scoopReviews(): ScoopReviews;

package/dist/types/host.d.ts

@@ -6,6 +6,7 @@ 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 { ScoopReviewHost } from './guests/scoop.ts';
 import type { UserClients } from './kernel/users.ts';
 import type { McpRuntime } from './mcp/index.ts';
 import type { MemoryRuntime } from './memory/index.ts';
@@ -67,6 +68,8 @@ export declare function hostAgent(agent: Agent, options?: {
     labels?: LabelsRuntime;
     approvals?: Approvals;
     judge?: ApprovalJudge;
+    intent?: ScoopReviewHost['intent'];
+    approvalMs?: number;
 }): Promise<AgentHost>;
 interface Served {
     trusted: AgentControl;

package/dist/types/main.d.ts

@@ -31,6 +31,7 @@ export interface AgentWorkerOptions {
     catalog?: string;
     users?: boolean;
     mcpRedirect?: string;
+    approvalMs?: number;
 }
 export declare function usersOf(admin: MessagePort | undefined, wanted: boolean | undefined, attach: KernelAttach): UserClients | undefined;
 export declare const STORE_DIR = "/.slicc";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "5.9.0",
+  "version": "5.10.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -71,7 +71,7 @@
     "@ai-ecoverse/wasm-coreutils": "9.12.0-8",
     "@ai-ecoverse/wasm-git": "2.55.0-15",
     "@biomejs/biome": "2.5.15",
-    "@types/node": "24.19.1",
+    "@types/node": "24.19.2",
     "esbuild": "0.28.2",
     "fake-indexeddb": "6.2.5",
     "lefthook": "2.2.1",