@ai-ecoverse/slicc-agent 5.0.3 → 5.2.0

package/dist/types/host.d.ts

@@ -1,5 +1,6 @@
 import { type Context, type Host, 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';
@@ -27,6 +28,7 @@ export interface AgentHost {
     readonly agent: Agent;
     readonly users?: UserClients;
     readonly pages: Pages;
+    readonly approvals: Approvals;
     connect(endpoint: PortEndpoint, options?: ConnectOptions): void;
     close(): Promise<void>;
 }
@@ -54,6 +56,8 @@ export declare function hostAgent(agent: Agent, options?: {
     uploads?: Uploads;
     thumbnail?: Thumbnail;
     labels?: LabelsRuntime;
+    approvals?: Approvals;
+    judge?: ApprovalJudge;
 }): Promise<AgentHost>;
 interface Served {
     trusted: AgentControl;
@@ -63,6 +67,7 @@ interface Served {
     settings: AgentSettings;
     remote: AgentRemote;
     pages: Pages;
+    decide: (by: DecidedBy) => AgentControl['decide'];
 }
 export declare function serveAgent(serving: Served): Host;
 export {};

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export { ADOBE, ADOBE_PROXY, type AdobeConfig, type AdobeModelInfo, adobeClassifiers, adobeConfig, adobeIdentity, adobeModel, adobeProvider, adobeUsage, type Budget, SESSION_HEADER, VERSION_HEADER, withAdobeIdentity, } from './adobe.ts';
 export { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts';
+export { APPROVAL_MS, type Approval, type ApprovalAnswer, type ApprovalDecided, type ApprovalDraft, type ApprovalJudge, type ApprovalKind, type ApprovalRequester, type ApprovalState, type Approvals, ApprovalsDoc, type ApprovalTier, type ApprovalVerdict, approvalJudge, attachApprovals, DEFAULT_POLICY, type DecidedBy, JUDGE_ALLOW, JUDGE_DENY, JUDGE_KIND, JUDGE_MODEL, JUDGE_QUESTIONS, type Judgement, judgeModelOf, judgeSpender, judgeState, type OwnerIntent, ownerIntent, POLICY_FILE, REASONS, seedPolicy, VERDICT_REASONS, verdictOf, verdictRecorder, } from './approvals/index.ts';
 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';

package/dist/types/services.d.ts

@@ -1,5 +1,6 @@
 import type { Context, JsonValue, RemoteContract, ReplicatedState } from '@earendil-works/chord';
 import type { ConversationView } from '@earendil-works/pi-durable';
+import type { Approval, ApprovalAnswer, ApprovalDecided } from './approvals/index.ts';
 import type { SendAttachment, ShownAttachment } from './attachments.ts';
 import type { ChangesView } from './changes/git.ts';
 import type { FrozenCone } from './freezer/index.ts';
@@ -87,6 +88,7 @@ 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>;
+    decide(id: string, decision: ApprovalAnswer, reason: string | null, context: Context): Promise<ApprovalDecided>;
 }
 export interface ImageRef {
     entry: number;
@@ -231,7 +233,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" | "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" | "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';
@@ -250,6 +252,7 @@ export interface AgentTranscript {
     readonly monitor: ReplicatedState<MonitorFeed>;
     readonly vault: ReplicatedState<VaultState>;
     readonly labels: ReplicatedState<Record<string, string>>;
+    readonly approvals: ReplicatedState<Approval[]>;
 }
 export interface PrivateRevision {
     revision: number;
@@ -259,7 +262,7 @@ export interface Command {
     description: string;
     kind: 'prompt' | 'skill' | 'action';
 }
-export declare const TRANSCRIPT_STATES: ("agents" | "changes" | "commands" | "deliveries" | "frozen" | "labels" | "memories" | "memoryScopes" | "monitor" | "privateRevision" | "sprinkles" | "state" | "vault" | "views")[];
+export declare const TRANSCRIPT_STATES: ("agents" | "approvals" | "changes" | "commands" | "deliveries" | "frozen" | "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)[];

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

@@ -0,0 +1,13 @@
+import type { Approval, ApprovalDecision, ApprovalsEvents, ApprovalsPort } from '@ai-ecoverse/slicc-spectrum/ui';
+import type { Approval as Item } from '../approvals/record.ts';
+import type { AgentConnection } from '../client.ts';
+import { Emitter } from './emitter.ts';
+export declare function shown(item: Item, agentName: string | undefined): Approval;
+export type HostApprovals = ApprovalsPort;
+export declare const NOT_HERE = "This request can't be answered in this tab.";
+export declare class ApprovalsAdapter extends Emitter<ApprovalsEvents> implements ApprovalsPort {
+    #private;
+    readonly decide?: (id: string, decision: ApprovalDecision, reason?: string) => Promise<void>;
+    constructor(connection: AgentConnection, host?: HostApprovals);
+    list(): readonly Approval[];
+}

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

@@ -1,6 +1,7 @@
 import type { MonitorSection } from '@ai-ecoverse/slicc-spectrum/ui';
 import type { AgentConnection } from '../client.ts';
 import { AgentAdapter } from './agent-port.ts';
+import { ApprovalsAdapter, type HostApprovals } from './approvals-port.ts';
 import { ChangesAdapter } from './changes-port.ts';
 import { MemoryAdapter } from './memory-port.ts';
 import { MonitorAdapter } from './monitor-port.ts';
@@ -10,6 +11,7 @@ import { type Login, SettingsAdapter } from './settings-port.ts';
 import { SprinkleAdapter } from './sprinkle-port.ts';
 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 { MemoryAdapter } from './memory-port.ts';
 export { assistant, errorAction, errorPart, isBusy, queued, textOf, toMessages, } from './messages.ts';
@@ -26,9 +28,11 @@ export declare function createAgentModel(connection: AgentConnection, options?:
         extra?: () => readonly MonitorSection[];
     };
     page?: PageOptions;
+    approvals?: HostApprovals;
     notices?: HostNotices;
 }): {
     agent: AgentAdapter;
+    approvals: ApprovalsAdapter;
     settings: SettingsAdapter;
     tray: TrayAdapter;
     sprinkles: SprinkleAdapter;

package/dist/types/titles/labels.d.ts

@@ -1,5 +1,6 @@
 import { type Context, type ReplicatedState } from '@earendil-works/chord';
-import { type ConversationView, type Harness } from '@earendil-works/pi-durable';
+import type { AssistantMessage } from '@earendil-works/pi-ai';
+import { type ConversationId, type ConversationView, type Harness, type Tx } from '@earendil-works/pi-durable';
 import type { Agents } from '../agents.ts';
 import type { VaultState } from '../secrets/vault.ts';
 import { type Labeler } from './generate.ts';
@@ -16,6 +17,7 @@ export declare function visibleLabels(labels: ReplicatedState<Record<string, str
 };
 export declare function watchLabel(labels: ReplicatedState<Record<string, string>>, waitMs?: number): (_agentId: string, callIds: readonly string[]) => Promise<string | null>;
 export declare function cleanLabel(text: string): string;
+export declare function spend(tx: Tx, conversation: ConversationId, answer: Pick<AssistantMessage, 'provider' | 'model' | 'usage'>): Promise<void>;
 export interface LabelsAttach {
     harness: Pick<Harness, 'commit'>;
     agents: Pick<Agents, 'conversation'>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "5.0.3",
+  "version": "5.2.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -53,6 +53,7 @@
     "test": "node --test ${TEST_CONCURRENCY:+--test-concurrency=$TEST_CONCURRENCY} --test-timeout=120000 --test-global-setup=node_modules/@ai-ecoverse/slicc-shared-web/harness/global.mjs 'test/integration/*.test.mjs'",
     "test:unit": "NODE_NO_WARNINGS=1 mcr -c node_modules/@ai-ecoverse/slicc-shared-web/mcr.config.mjs node --test 'test/unit/**/*.test.mjs'",
     "typecheck": "tsc",
+    "eval:judge": "node evals/judge.mjs",
     "lint": "slicc-lint && npm run lint:patches",
     "lint:patches": "node scripts/check-patches.mjs",
     "format": "biome check --write .",
@@ -63,8 +64,8 @@
   "devDependencies": {
     "@ai-ecoverse/slicc-kernel": "1.94.0",
     "@ai-ecoverse/slicc-scrub": "1.0.0",
-    "@ai-ecoverse/slicc-shared-web": "1.20.0",
-    "@ai-ecoverse/slicc-spectrum": "1.77.1",
+    "@ai-ecoverse/slicc-shared-web": "1.21.0",
+    "@ai-ecoverse/slicc-spectrum": "1.79.1",
     "@ai-ecoverse/wasm-bash": "5.3.0-18",
     "@ai-ecoverse/wasm-coreutils": "9.12.0-6",
     "@ai-ecoverse/wasm-git": "2.55.0-15",
@@ -92,7 +93,7 @@
   },
   "peerDependencies": {
     "@ai-ecoverse/slicc-kernel": ">=1.90.0 <2",
-    "@ai-ecoverse/slicc-spectrum": "^1.75.0"
+    "@ai-ecoverse/slicc-spectrum": "^1.78.0"
   },
   "peerDependenciesMeta": {
     "@ai-ecoverse/slicc-spectrum": {