@agentorg/cli 0.0.3 → 0.0.5

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

@@ -44,6 +44,7 @@ declare const HUB_EXPORTS: {
         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;
@@ -76,6 +77,7 @@ declare const HUB_EXPORTS: {
                     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<{
@@ -102,6 +104,7 @@ declare const HUB_EXPORTS: {
                 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;
@@ -112,6 +115,17 @@ declare const HUB_EXPORTS: {
         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>>;
+        upgrade: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
+            actorId: import("zod").ZodString;
+            package: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            dropped: import("zod").ZodArray<import("zod").ZodObject<{
+                consumer: import("zod").ZodString;
+                slot: import("zod").ZodString;
+                provider: import("zod").ZodString;
+                export: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>>;
         logs: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
             actorId: import("zod").ZodString;
             limit: import("zod").ZodOptional<import("zod").ZodNumber>;
@@ -145,6 +159,7 @@ declare const HUB_EXPORTS: {
                 interface: import("zod").ZodString;
                 madeBy: 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>>;
     }, {}, 1>;
@@ -164,6 +179,23 @@ declare const HUB_EXPORTS: {
             consumer: import("zod").ZodString;
             slot: import("zod").ZodString;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{}, import("zod/v4/core").$strip>>;
+        expose: import("@agentorg/sdk").MethodSpec<import("zod").ZodObject<{
+            provider: import("zod").ZodString;
+            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>;
+            slot: import("zod").ZodString;
+            requestId: import("zod").ZodString;
+        }, 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;
@@ -187,6 +219,7 @@ declare const HUB_EXPORTS: {
                 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<{
@@ -208,6 +241,7 @@ declare const HUB_EXPORTS: {
                 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";
@@ -230,6 +264,7 @@ declare const HUB_EXPORTS: {
             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<{
@@ -245,6 +280,7 @@ declare const HUB_EXPORTS: {
                 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";
@@ -310,6 +346,8 @@ export interface ActorRecord {
     /** 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;
@@ -321,6 +359,8 @@ export interface BindingRecord extends Wiring {
     interface: string;
     madeBy: string;
     at: string;
+    /** Its slot was made at run time by `expose`, and goes with it. */
+    exposed?: true;
 }
 /** The two ends of a binding: the export side gives the export, the slot side takes it. */
 export type Side = "export" | "slot";
@@ -336,6 +376,8 @@ export interface RequestRecord extends Wiring {
     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;
@@ -374,6 +416,12 @@ export interface StateEvents {
     closed?(actorId: string): void;
     audited?(entry: AuditRecord): void;
 }
+/**
+ * The default name of a slot exposing `exportName` of the Actor named `providerName`: the name's
+ * ASCII words camelCased, `_`, and the export's last part; the export's part alone when the name
+ * has no ASCII letters.
+ */
+export declare function exposedName(providerName: string, exportName: string): string;
 /**
  * The core's state in its home folder: Actors, packages, declarations, bindings, binding requests
  * and the audit trail, in `node:sqlite`. Every method that changes something takes its caller, and
@@ -402,6 +450,8 @@ export declare class HubState {
         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;
@@ -418,6 +468,8 @@ export declare class HubState {
          * 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;
@@ -431,6 +483,16 @@ export declare class HubState {
     stop(caller: string, actorId: string): void;
     /** Close an Actor for good: its bindings both ways, its declarations and its open requests go. */
     closeActor(caller: string, actorId: string): void;
+    /** Refused unless the caller may upgrade the Actor to the package now; changes nothing. */
+    checkUpgrade(caller: string, actorId: string, hash: string): ActorRecord;
+    /**
+     * Run another package as the same Actor: its id, its stores and every binding whose interfaces
+     * still match stay; a binding through a slot or export the new package drops or declares as
+     * another interface is dropped, audited and returned. The new package's own wiring is applied
+     * where its slot is unbound. The process isn't touched here: a running Actor is stopped first
+     * and started after, by whoever runs processes.
+     */
+    upgrade(caller: string, actorId: string, hash: string): Wiring[];
     /** 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;
@@ -452,8 +514,9 @@ export declare class HubState {
     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>;
@@ -508,6 +571,28 @@ export declare class HubState {
     };
     /** 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.
+     */
+    expose(caller: string, input: {
+        provider: string;
+        export: string;
+        to: string;
+        as?: string;
+    }): {
+        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.