@agentorg/cli 0.0.4 → 0.0.6

package/dist/node_modules/@agentorg/hub/dist/src/state.d.ts

@@ -1,50 +1,13 @@
 import { type DescribedInterface } from "@agentorg/sdk";
-import { type Manifest } from "@agentorg/sdk/manifest";
 /** The built-in Actor that exports management. */
 export declare const HUB = "hub";
-/** The built-in Actor that keeps state: `kv@1`, one store per consumer slot. */
-export declare const STORAGE = "storage";
-/** The built-in Actor that reaches the public internet: `http.egress@1`, over HTTPS only. */
-export declare const NET = "net";
 /** The person's Actor, created at first start with every `hub.*` binding. */
 export declare const PERSON = "person";
 /** The hub's exports, each the authority for its own part of management. */
 declare const HUB_EXPORTS: {
-    packages: import("@agentorg/sdk").RpcInterface<"hub.packages", {
-        add: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            path: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            hash: import("zod").ZodString;
-            manifest: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>;
-        }, import("zod/v4/core").$strip>>;
-        list: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            packages: import("zod").ZodArray<import("zod").ZodObject<{
-                hash: import("zod").ZodString;
-                name: import("zod").ZodString;
-                version: import("zod").ZodString;
-            }, import("zod/v4/core").$strip>>;
-        }, import("zod/v4/core").$strip>>;
-        get: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            hash: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            hash: import("zod").ZodString;
-            manifest: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>;
-        }, import("zod/v4/core").$strip>>;
-        remove: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            hash: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{}, import("zod/v4/core").$strip>>;
-        build: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            files: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            hash: import("zod").ZodString;
-            manifest: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>;
-        }, import("zod/v4/core").$strip>>;
-    }, {}, 1>;
     actors: import("@agentorg/sdk").RpcInterface<"hub.actors", {
         create: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
             name: import("zod").ZodString;
-            package: import("zod").ZodOptional<import("zod").ZodString>;
-            for: import("zod").ZodOptional<import("zod").ZodString>;
             bindings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                 slot: import("zod").ZodString;
                 provider: import("zod").ZodString;
@@ -52,7 +15,7 @@ declare const HUB_EXPORTS: {
             }, import("zod/v4/core").$strip>>>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             actorId: import("zod").ZodString;
-            credential: import("zod").ZodOptional<import("zod").ZodString>;
+            credential: import("zod").ZodString;
         }, import("zod/v4/core").$strip>>;
         list: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             actors: import("zod").ZodArray<import("zod").ZodObject<{
@@ -66,18 +29,6 @@ declare const HUB_EXPORTS: {
                     stopped: "stopped";
                 }>;
                 connected: import("zod").ZodBoolean;
-                restarts: import("zod").ZodNumber;
-                lastExit: import("zod").ZodOptional<import("zod").ZodObject<{
-                    code: import("zod").ZodNullable<import("zod").ZodNumber>;
-                    signal: import("zod").ZodNullable<import("zod").ZodString>;
-                    at: import("zod").ZodString;
-                }, import("zod/v4/core").$strip>>;
-                host: import("zod").ZodOptional<import("zod").ZodObject<{
-                    available: import("zod").ZodBoolean;
-                    reason: import("zod").ZodOptional<import("zod").ZodString>;
-                }, import("zod/v4/core").$strip>>;
-                views: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-                installedFor: import("zod").ZodOptional<import("zod").ZodString>;
             }, import("zod/v4/core").$strip>>;
         }, import("zod/v4/core").$strip>>;
         get: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
@@ -93,44 +44,10 @@ declare const HUB_EXPORTS: {
                 stopped: "stopped";
             }>;
             connected: import("zod").ZodBoolean;
-            restarts: import("zod").ZodNumber;
-            lastExit: import("zod").ZodOptional<import("zod").ZodObject<{
-                code: import("zod").ZodNullable<import("zod").ZodNumber>;
-                signal: import("zod").ZodNullable<import("zod").ZodString>;
-                at: import("zod").ZodString;
-            }, import("zod/v4/core").$strip>>;
-            host: import("zod").ZodOptional<import("zod").ZodObject<{
-                available: import("zod").ZodBoolean;
-                reason: import("zod").ZodOptional<import("zod").ZodString>;
-            }, import("zod/v4/core").$strip>>;
-            views: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-            installedFor: import("zod").ZodOptional<import("zod").ZodString>;
         }, import("zod/v4/core").$strip>>;
-        start: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            actorId: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{}, import("zod/v4/core").$strip>>;
-        stop: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            actorId: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{}, import("zod/v4/core").$strip>>;
         close: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
             actorId: import("zod").ZodString;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{}, import("zod/v4/core").$strip>>;
-        logs: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            actorId: import("zod").ZodString;
-            limit: import("zod").ZodOptional<import("zod").ZodNumber>;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            lines: import("zod").ZodArray<import("zod").ZodObject<{
-                level: import("zod").ZodEnum<{
-                    error: "error";
-                    info: "info";
-                    warn: "warn";
-                }>;
-                message: import("zod").ZodString;
-                data: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>>;
-                module: import("zod").ZodOptional<import("zod").ZodString>;
-                at: import("zod").ZodString;
-            }, import("zod/v4/core").$strip>>;
-        }, import("zod/v4/core").$strip>>;
     }, {
         changed: import("@agentorg/sdk").EventSpec<import("zod").ZodObject<{
             actor: import("zod").ZodString;
@@ -158,12 +75,9 @@ declare const HUB_EXPORTS: {
             slot: import("zod").ZodString;
             provider: import("zod").ZodString;
             export: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, import("zod").ZodUnion<readonly [import("zod").ZodObject<{
-            bound: import("zod").ZodLiteral<true>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            bound: import("zod").ZodLiteral<false>;
-            requestId: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>]>>;
+            bound: import("zod").ZodLiteral<true>;
+        }, import("zod/v4/core").$strip>>;
         unbind: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
             consumer: import("zod").ZodString;
             slot: import("zod").ZodString;
@@ -173,111 +87,15 @@ declare const HUB_EXPORTS: {
             export: import("zod").ZodString;
             to: import("zod").ZodString;
             as: import("zod").ZodOptional<import("zod").ZodString>;
-        }, import("zod/v4/core").$strip>, import("zod").ZodUnion<readonly [import("zod").ZodObject<{
-            exposed: import("zod").ZodLiteral<true>;
-            slot: import("zod").ZodString;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            exposed: import("zod").ZodLiteral<false>;
+            exposed: import("zod").ZodLiteral<true>;
             slot: import("zod").ZodString;
-            requestId: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>]>>;
+        }, import("zod/v4/core").$strip>>;
         unexpose: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
             to: import("zod").ZodString;
             slot: import("zod").ZodString;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{}, import("zod/v4/core").$strip>>;
-        request: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            consumer: import("zod").ZodString;
-            slot: import("zod").ZodString;
-            provider: import("zod").ZodString;
-            export: import("zod").ZodString;
-            reason: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            requestId: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>>;
-        requests: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            requests: import("zod").ZodArray<import("zod").ZodObject<{
-                consumer: import("zod").ZodString;
-                slot: import("zod").ZodString;
-                provider: import("zod").ZodString;
-                export: import("zod").ZodString;
-                requestId: import("zod").ZodString;
-                needs: import("zod").ZodEnum<{
-                    export: "export";
-                    slot: "slot";
-                }>;
-                reason: import("zod").ZodString;
-                requestedBy: import("zod").ZodString;
-                at: import("zod").ZodString;
-                exposed: import("zod").ZodOptional<import("zod").ZodLiteral<true>>;
-            }, import("zod/v4/core").$strip>>;
-        }, import("zod/v4/core").$strip>>;
-        decline: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            requestId: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{}, import("zod/v4/core").$strip>>;
-        mine: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
-            limit: import("zod").ZodOptional<import("zod").ZodNumber>;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            requests: import("zod").ZodArray<import("zod").ZodObject<{
-                consumer: import("zod").ZodString;
-                slot: import("zod").ZodString;
-                provider: import("zod").ZodString;
-                export: import("zod").ZodString;
-                requestId: import("zod").ZodString;
-                needs: import("zod").ZodEnum<{
-                    export: "export";
-                    slot: "slot";
-                }>;
-                reason: import("zod").ZodString;
-                requestedBy: import("zod").ZodString;
-                at: import("zod").ZodString;
-                exposed: import("zod").ZodOptional<import("zod").ZodLiteral<true>>;
-                status: import("zod").ZodEnum<{
-                    approved: "approved";
-                    closed: "closed";
-                    declined: "declined";
-                    open: "open";
-                }>;
-            }, import("zod/v4/core").$strip>>;
-        }, import("zod/v4/core").$strip>>;
-    }, {
-        requested: import("@agentorg/sdk").EventSpec<import("zod").ZodObject<{
-            consumer: import("zod").ZodString;
-            slot: import("zod").ZodString;
-            provider: import("zod").ZodString;
-            export: import("zod").ZodString;
-            requestId: import("zod").ZodString;
-            needs: import("zod").ZodEnum<{
-                export: "export";
-                slot: "slot";
-            }>;
-            reason: import("zod").ZodString;
-            requestedBy: import("zod").ZodString;
-            at: import("zod").ZodString;
-            exposed: import("zod").ZodOptional<import("zod").ZodLiteral<true>>;
-        }, import("zod/v4/core").$strip>>;
-        decided: import("@agentorg/sdk").EventSpec<import("zod").ZodObject<{
-            request: import("zod").ZodObject<{
-                consumer: import("zod").ZodString;
-                slot: import("zod").ZodString;
-                provider: import("zod").ZodString;
-                export: import("zod").ZodString;
-                requestId: import("zod").ZodString;
-                needs: import("zod").ZodEnum<{
-                    export: "export";
-                    slot: "slot";
-                }>;
-                reason: import("zod").ZodString;
-                requestedBy: import("zod").ZodString;
-                at: import("zod").ZodString;
-                exposed: import("zod").ZodOptional<import("zod").ZodLiteral<true>>;
-            }, import("zod/v4/core").$strip>;
-            status: import("zod").ZodEnum<{
-                approved: "approved";
-                closed: "closed";
-                declined: "declined";
-            }>;
-        }, import("zod/v4/core").$strip>>;
-    }, 1>;
+    }, {}, 1>;
     exports: import("@agentorg/sdk").RpcInterface<"hub.exports", {
         list: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
             actor: import("zod").ZodOptional<import("zod").ZodString>;
@@ -287,7 +105,6 @@ declare const HUB_EXPORTS: {
                 export: import("zod").ZodString;
                 interface: import("zod").ZodString;
                 hash: import("zod").ZodString;
-                dynamic: import("zod").ZodBoolean;
             }, import("zod/v4/core").$strip>>;
         }, import("zod/v4/core").$strip>>;
     }, {
@@ -320,23 +137,12 @@ declare const HUB_EXPORTS: {
     }, 1>;
 };
 export type ActorState = "created" | "running" | "stopped" | "closed";
-/** How a process ended on its own: its exit code or signal, and when. */
-export interface Exit {
-    code: number | null;
-    signal: string | null;
-    at: string;
-}
 export interface ActorRecord {
     actorId: string;
     name: string;
-    /** A package hash, `external` for a program that connects itself, or `builtin` for the hub. */
+    /** `external` for a program that connects itself, `builtin` for the hub; an earlier release's package Actor keeps its hash. */
     package: string;
     state: ActorState;
-    /** Times its process was restarted after a crash. */
-    restarts: number;
-    lastExit?: Exit;
-    /** The Actor a manager made it for: provenance, never authority. */
-    installedFor?: string;
 }
 export interface Wiring {
     consumer: string;
@@ -353,21 +159,6 @@ export interface BindingRecord extends Wiring {
 }
 /** The two ends of a binding: the export side gives the export, the slot side takes it. */
 export type Side = "export" | "slot";
-/**
- * How a request ended: `approved` (its binding was made), `declined`, or `closed` (its slot was
- * bound to something else, or one end went away).
- */
-export type Decision = "approved" | "declined" | "closed";
-export interface RequestRecord extends Wiring {
-    requestId: string;
-    /** The side the requester lacks, whose approvers decide. */
-    needs: Side;
-    reason: string;
-    requestedBy: string;
-    at: string;
-    /** A request to expose: `slot` is made on `consumer` when it is approved. */
-    exposed?: true;
-}
 export interface AuditRecord {
     seq: number;
     at: string;
@@ -393,13 +184,10 @@ export type CallOutcome = "ok" | "invalid" | "bad_output" | "refused" | "not_con
  */
 export interface StateEvents {
     bound?(binding: BindingRecord): void;
-    /** Bindings that ended, by unbind, withdrawal, redeclaration, disconnection or closing. */
+    /** Bindings that ended, by unbind, redeclaration or closing. */
     unbound?(bindings: BindingRecord[]): void;
-    requested?(request: RequestRecord, approvers: string[]): void;
-    /** A request was approved, declined or closed: to its approvers and its requester. */
-    decided?(request: RequestRecord, status: Decision, approvers: string[]): void;
     exportsChanged?(actor: string): void;
-    /** An Actor's record changed: it was made, started, stopped or closed, or its process exited. */
+    /** An Actor's record changed: it was made or closed. */
     actorChanged?(actorId: string): void;
     /** An Actor was closed for good: its channel should go too. */
     closed?(actorId: string): void;
@@ -412,7 +200,7 @@ export interface StateEvents {
  */
 export declare function exposedName(providerName: string, exportName: string): string;
 /**
- * The core's state in its home folder: Actors, packages, declarations, bindings, binding requests
+ * The core's state in its home folder: Actors, declarations, bindings
  * and the audit trail, in `node:sqlite`. Every method that changes something takes its caller, and
  * each is checked against bindings: there is no other authority.
  */
@@ -427,91 +215,55 @@ export declare class HubState {
      */
     static open(home: string, events?: StateEvents): HubState;
     close(): void;
-    /** Record something the Hub itself saw happen, such as the host sandbox's status changing. */
-    auditHub(kind: string, details: Record<string, unknown>, actor?: string): void;
-    /** A package Actor's process exited: kept as its `lastExit`, and counted when it is restarted. */
-    recordExit(actorId: string, exit: Exit, restarted: boolean): void;
     /** Record a call's metadata: who, through which binding, which method, and how it ended. */
     auditCall(caller: string, 
     /** The binding the call went through; an unbound slot has only its consumer and slot. */
     binding: Pick<Wiring, "consumer" | "slot"> & Partial<Wiring>, call: {
-        op: "call" | "subscribe" | "open" | "http";
+        op: "call" | "subscribe";
         method?: string;
         outcome: CallOutcome;
     }): void;
     /** An Actor as a refusal names it: "Name (id)", or the id alone when there's no such Actor. */
     named(actorId: string): string;
     actor(actorId: string): ActorRecord;
-    /** The host sandbox's status changed: every package Actor's record (its `host`) differs. */
-    hostChanged(): void;
     actors(): ActorRecord[];
     /** Whether the caller is bound to one of the hub's exports: the authority for that part. */
     holds(caller: string, hubExport: keyof typeof HUB_EXPORTS): boolean;
-    /** Create an Actor: one that runs a package, or an external one, whose credential comes back once. */
+    /** Create an Actor: a program that connects itself, with a credential that comes back once. */
     createActor(caller: string, input: {
         name: string;
-        package?: string;
         /**
          * Initial bindings for the new Actor's slots, made with the caller's export-side authority;
          * the creation is the slot side's yes. An external Actor's slot is declared with the
          * export's interface, and its hello must declare it the same way to keep it.
          */
         bindings?: Omit<Wiring, "consumer">[];
-        /** The Actor it is made for: given only by a manager, recorded as provenance. */
-        for?: string;
     }): {
         actorId: string;
-        credential?: string;
+        credential: string;
     };
     /** Whether an external Actor's credential is right, compared in constant time. */
     authenticate(actorId: string, credential: string): boolean;
-    /** Refused unless the caller may start the Actor and it can be started now; changes nothing. */
-    checkStart(caller: string, actorId: string): void;
-    /** Start a package Actor: recorded as running; the Hub spawns its process. */
-    start(caller: string, actorId: string): void;
-    stop(caller: string, actorId: string): void;
-    /** Close an Actor for good: its bindings both ways, its declarations and its open requests go. */
+    /** Close an Actor for good: its bindings both ways and its declarations go. */
     closeActor(caller: string, actorId: string): void;
-    /** Add a `.agentorg` archive from a path on this machine, verified; adding it again is a no-op. */
-    addPackage(caller: string, path: string): {
-        hash: string;
-        manifest: Manifest;
-    };
-    packages(): {
-        hash: string;
-        name: string;
-        version: string;
-    }[];
-    package(hash: string): {
-        hash: string;
-        manifest: Manifest;
-    };
-    /** Remove a package no live Actor runs. Its files stay until a later clean-up. */
-    removePackage(caller: string, hash: string): void;
     /** How many slots an Actor declares. */
     slotCount(actor: string): number;
     declaration(actor: string, side: "slot" | "export", name: string): Declaration | undefined;
     /**
      * An external Actor's slots and static exports, as it declares them when it connects; they
-     * replace what it declared before. A bound name keeps its interface: redeclaring it as another is
-     * refused. A name it no longer declares is dropped, with its bindings.
+     * replace what it declared before. A name redeclared as another interface loses its bindings
+     * (audited as `binding.drop`), since a binding holds only while both ends declare the same one.
+     * A name it no longer declares is dropped, with its bindings.
      */
     declareExternal(actorId: string, declares: {
         slots: Record<string, DescribedInterface>;
         exports: Record<string, DescribedInterface>;
     }): void;
-    /** Offer an export at run time; it lasts until withdrawn or until the Actor disconnects. */
-    offer(actorId: string, name: string, iface: DescribedInterface): void;
-    /** Withdraw an export offered at run time: the bindings to it end. */
-    withdraw(actorId: string, name: string): void;
-    /** An Actor's connection ended: what it offered at run time goes, with the bindings to it. */
-    disconnected(actorId: string): void;
     exports(actor?: string): {
         actor: string;
         export: string;
         interface: string;
         hash: string;
-        dynamic: boolean;
     }[];
     binding(consumer: string, slot: string): BindingRecord | undefined;
     /**
@@ -531,30 +283,16 @@ export declare class HubState {
      * itself, or a manager.
      */
     sides(caller: string, wiring: Wiring): Record<Side, boolean>;
-    /** Who can give the side a request needs: exactly the Actors `sides` grants it to. */
-    approvers(request: Wiring & {
-        needs: Side;
-    }): string[];
-    /**
-     * Bind a slot to an export. A caller with both ends binds. A caller with one end approves an
-     * open request for this binding from the other end, if its requester still holds that end;
-     * otherwise its call becomes a request to the other end's approvers. A caller with neither end
-     * is refused.
-     */
+    /** Bind a slot to an export: the caller must hold both ends. */
     bind(caller: string, wiring: Wiring): {
         bound: true;
-    } | {
-        bound: false;
-        requestId: string;
     };
     /** Unbind a slot: its consumer, its provider or a manager may. */
     unbind(caller: string, consumer: string, slot: string): void;
     /**
      * Expose an export to one Actor: a slot made on `to` at run time, typed by the export's
-     * interface and bound to it, in one step. The authority is a binding's, with `to` as the
-     * consumer: with both ends it is made (approving any open request for it); with one, it is a
-     * request to the other end's approvers, who approve by exposing the same; with neither, it is
-     * refused. The same export already exposed to `to` gives that slot back.
+     * interface and bound to it, in one step. The caller must hold both ends, with `to` as the
+     * consumer. The same export already exposed to `to` gives that slot back.
      */
     expose(caller: string, input: {
         provider: string;
@@ -564,25 +302,9 @@ export declare class HubState {
     }): {
         exposed: true;
         slot: string;
-    } | {
-        exposed: false;
-        slot: string;
-        requestId: string;
     };
     /** Remove a slot made by `expose`, with its binding: its consumer, its provider or a manager may. */
     unexpose(caller: string, to: string, slot: string): void;
-    /**
-     * Ask for a binding the caller holds one end of; it goes to the other end's approvers. Asking
-     * again for the same wiring while a request is open returns that request.
-     */
-    request(caller: string, wiring: Wiring, reason: string): RequestRecord;
-    /** The open requests the caller could approve. */
-    requests(caller: string): RequestRecord[];
-    /** The caller's own requests with how each stands, newest first. */
-    mine(caller: string, limit?: number): (RequestRecord & {
-        status: "open" | Decision;
-    })[];
-    decline(caller: string, requestId: string): void;
     audit(since?: number, limit?: number): {
         entries: AuditRecord[];
         next: number;