@agentorg/cli 0.0.1 → 0.0.2

package/dist/src/domain/attention.js

@@ -1,12 +1,13 @@
 /**
  * What concerns an Actor, read from the audited writes after its position, by the next mover.
- * On its records: Work given to it or changed by its requester, an answer to its
- * submission, an answer to its ask or the ask's raise, and a message to it. Routed to it, or to a
- * closed Actor it stands in for: an ask from a report or raised to it while the ask is open and
- * with it, and a submission of Work it requested while the submission waits. Closing an Actor gives
- * its stand-in an ask for each open ask the close re-routes and a review_due for each waiting
- * submission, from the Actor that closed it; a stand-in that closed it gets none, as its own
- * write. A read that finds nothing waits for the next audited write, up to `wait` seconds.
+ * On its records: Work given to it or changed by its requester, an answer to its submission, an
+ * answer to its ask, and a message to it. Routed to it: an ask on Work it requested while the ask
+ * is open and still routed to it, and a submission of Work it requested while the submission
+ * waits. The person also gets the asks on Work their asker requested itself or on no Work, and
+ * stands in for closed Actors: closing one gives it an ask for each open ask the close re-routes
+ * and a review_due for each waiting submission, from the Actor that closed it, or none when the
+ * person closed it, as its own write. A read that finds nothing waits for the next audited write,
+ * up to `wait` seconds.
  */
 import { Invalid, Refusal } from "./errors.js";
 import { ATTENTION } from "./model/index.js";
@@ -44,11 +45,17 @@ export function attention(registry, audit, workspace) {
             throw error;
         }
     }
-    /** The Actor an open ask waits on: its last raiser's, else its asker's, nearest open manager. */
-    function routeOf(ask) {
-        const origin = ask.raises.at(-1)?.actorID ?? ask.requesterID;
-        const manager = registry.get(origin)?.manager;
-        return ask.status === "open" && manager ? registry.standIn(manager) : undefined;
+    /**
+     * The Actor an open ask waits on: its Work's requester, or the person when its asker requested
+     * the Work itself or it names no Work. A closed requester's asks go to the person.
+     */
+    function routeOf(ask, reads) {
+        if (ask.status !== "open")
+            return undefined;
+        const requester = ask.workID === undefined ? undefined : reads.work(ask.workID)?.requesterID;
+        return requester !== undefined && requester !== ask.requesterID
+            ? registry.standIn(requester)
+            : registry.root()?.id;
     }
     /**
      * Asks and Work as the caller reads them, with history, and what one read derives from them:
@@ -139,14 +146,8 @@ export function attention(registry, audit, workspace) {
                     }));
                 return works.get(id);
             },
-            /** The open asks routed to the caller, and submitted Work requested in its branch. */
+            /** The open asks routed to the caller. */
             routing: once(() => all(caller, (clients, after) => clients.work.asks({ routedTo: caller.id, limit: 100, after }))),
-            submitted: once(() => all(caller, (clients, after) => clients.work.list({
-                requesterWithin: caller.id,
-                status: ["submitted"],
-                limit: 100,
-                after,
-            }))),
         };
     }
     /** Every page of a list the caller reads; none where it can't read it. */
@@ -162,17 +163,6 @@ export function attention(registry, audit, workspace) {
             after = found.next;
         }
     }
-    /** Whether the walk from `actorID` up to its nearest open Actor passes `closed`. */
-    function through(actorID, closed) {
-        for (let at = actorID ? registry.get(actorID) : undefined; at;) {
-            if (at.id === closed)
-                return true;
-            if (at.closed_at === null)
-                return false;
-            at = at.manager === null ? undefined : registry.get(at.manager);
-        }
-        return false;
-    }
     /** What one entry did: the parties and records it touched, and the item it makes, if any. */
     function factOf(caller, entry, reads) {
         const touched = {
@@ -195,16 +185,18 @@ export function attention(registry, audit, workspace) {
             }
         }
         else if (entry.operation === "actor_create" || entry.operation === "actor_close") {
-            touched.actorIDs.push(id, registry.get(id)?.manager);
-            // A closed Actor's part passes to its nearest open manager: what was routed to it,
-            // or on its way through it, is the caller's now.
+            touched.actorIDs.push(id);
+            // A closed Actor's part passes to the person: the asks on Work it requested, and the
+            // submissions of that Work, are the person's now.
             if (entry.operation === "actor_close" && registry.standIn(id) === caller.id) {
                 for (const ask of reads.routing())
-                    if (through(registry.get(ask.raises.at(-1)?.actorID ?? ask.requesterID)?.manager, id))
+                    if (ask.requesterID !== id &&
+                        ask.workID !== undefined &&
+                        reads.work(ask.workID)?.requesterID === id)
                         items.push({ kind: "ask", title: ask.title, recordID: ask.formID });
-                for (const work of reads.submitted())
-                    if (through(work.requesterID, id))
-                        items.push({ kind: "review_due", title: work.title, recordID: work.ticketID });
+                const submitted = all(caller, (clients, after) => clients.work.list({ requesterID: id, status: ["submitted"], limit: 100, after }));
+                for (const work of submitted)
+                    items.push({ kind: "review_due", title: work.title, recordID: work.ticketID });
             }
         }
         else if (entry.operation.startsWith("work_")) {
@@ -219,21 +211,13 @@ export function attention(registry, audit, workspace) {
                     touched.workIDs.push(ask.workID);
                 title = ask.title;
                 const asker = ask.requesterID === caller.id;
-                const routed = routeOf(ask) === caller.id;
+                const routed = routeOf(ask, reads) === caller.id;
                 // Only its asker and the Actor it routes to get items from an ask.
                 const action = asker || routed ? reads.event(entry, ask.history)?.action : undefined;
-                // Once raised, the ask reaches its route from the raise that sent it there.
-                if (action === "created" && routed && ask.raises.length === 0)
+                if (action === "created" && routed)
                     kind = "ask";
                 else if (action === "responded" && asker)
                     kind = "answer";
-                else if (action === "raised") {
-                    const raisedTo = registry.get(entry.actor)?.manager;
-                    if (asker)
-                        kind = "raised";
-                    else if (routed && raisedTo && registry.standIn(raisedTo) === caller.id)
-                        kind = "ask";
-                }
             }
             else if (work) {
                 touched.workIDs.push(id);

package/dist/src/domain/capabilities.js

@@ -24,7 +24,6 @@ export function capabilities(tools) {
                     long_running: false,
                 },
                 read_only: !operation.definition.writes,
-                level: operation.definition.level,
             },
         })),
     }));

package/dist/src/domain/claims.js

@@ -32,8 +32,8 @@ export function claims(claimStore, registry, now) {
         const held = heldClaim(request.resource);
         if (!held)
             throw new NotFound(`nobody holds ${request.resource}`);
-        if (held.holder !== actor.id && actor.manager !== null) {
-            throw new Forbidden(`${heldMessage(held)}; only it or the root releases it`);
+        if (held.holder !== actor.id && registry.root()?.id !== actor.id) {
+            throw new Forbidden(`${heldMessage(held)}; only it or the person releases it`);
         }
         claimStore.remove(request.resource);
         return held;

package/dist/src/domain/errors.d.ts

@@ -14,7 +14,7 @@ export declare class Invalid extends Refusal {
 export declare class Forbidden extends Refusal {
     readonly code = "forbidden";
 }
-/** The records' state does not allow it, such as closing a position with open reports. */
+/** The records' state does not allow it, such as a handle an open Actor already has. */
 export declare class Conflict extends Refusal {
     readonly code = "conflict";
 }

package/dist/src/domain/errors.js

@@ -13,7 +13,7 @@ export class Invalid extends Refusal {
 export class Forbidden extends Refusal {
     code = "forbidden";
 }
-/** The records' state does not allow it, such as closing a position with open reports. */
+/** The records' state does not allow it, such as a handle an open Actor already has. */
 export class Conflict extends Refusal {
     code = "conflict";
 }

package/dist/src/domain/index.d.ts

@@ -15,7 +15,6 @@ export declare function organization(store: Store, options?: OrganizationOptions
             id: string;
             name: string;
             purpose: string;
-            manager: string | null;
             created_at: string;
             closed_at: string | null;
             credential_hash: string;
@@ -24,7 +23,7 @@ export declare function organization(store: Store, options?: OrganizationOptions
             root: import("./ports.ts").ActorRow;
             credential: string;
         }>;
-        create: (manager: string, name: string, purpose: string) => Promise<{
+        create: (name: string, purpose: string) => Promise<{
             actor: import("./ports.ts").ActorRow;
             credential: string;
         }>;
@@ -33,7 +32,6 @@ export declare function organization(store: Store, options?: OrganizationOptions
             id: string;
             name: string;
             purpose: string;
-            manager: string | null;
             created_at: string;
             closed_at: string | null;
             credential_hash: string;
@@ -41,31 +39,19 @@ export declare function organization(store: Store, options?: OrganizationOptions
         found: (id: string) => import("./ports.ts").ActorRow;
         byCredential: (credential: string) => Promise<import("./ports.ts").ActorRow | undefined>;
         identify: (credential: string) => Promise<string | undefined>;
-        reports: (manager: string) => {
-            id: string;
-            name: string;
-            purpose: string;
-            manager: string | null;
-            created_at: string;
-            closed_at: string | null;
-            credential_hash: string;
-        }[];
         open: () => {
             id: string;
             name: string;
             purpose: string;
-            manager: string | null;
             created_at: string;
             closed_at: string | null;
             credential_hash: string;
         }[];
-        within: (actorID: string, ancestorID: string) => boolean;
         standIn: (actorID: string) => string | undefined;
         close: (caller: import("./ports.ts").ActorRow, id: string) => {
             actor: import("./ports.ts").ActorRow;
             changed: boolean;
         };
-        path: (actor: import("./ports.ts").ActorRow) => string;
         names: (ids: Iterable<string>) => Record<string, string>;
     };
     connections: {

package/dist/src/domain/model/attention.d.ts

@@ -10,7 +10,6 @@ export declare const AttentionItem: z.ZodObject<{
         ask: "ask";
         assigned: "assigned";
         message: "message";
-        raised: "raised";
         review_due: "review_due";
         reviewed: "reviewed";
         updated: "updated";
@@ -30,7 +29,6 @@ export declare const Attention: z.ZodObject<{
             ask: "ask";
             assigned: "assigned";
             message: "message";
-            raised: "raised";
             review_due: "review_due";
             reviewed: "reviewed";
             updated: "updated";
@@ -56,7 +54,6 @@ export declare const ATTENTION: {
     interfaces: {
         readonly attention: {
             readonly writes: false;
-            readonly level: "report";
             readonly request: z.ZodObject<{
                 since: z.ZodOptional<z.ZodString>;
                 wait: z.ZodDefault<z.ZodNumber>;
@@ -68,7 +65,6 @@ export declare const ATTENTION: {
                         ask: "ask";
                         assigned: "assigned";
                         message: "message";
-                        raised: "raised";
                         review_due: "review_due";
                         reviewed: "reviewed";
                         updated: "updated";
@@ -88,7 +84,7 @@ export declare const ATTENTION: {
                 }, z.core.$strict>;
                 next: z.ZodString;
             }, z.core.$strict>;
-            readonly description: "Read what concerns you since your last read. On your records: Work given to you or changed by its requester, an answer to your submission, an answer to your ask or its raise, and a message to you. Routed to you: an ask from a report or raised to you, and a submission of Work you requested, with those of a closed Actor you stand in for. Your own writes are not items. changed names the Actors, Work and conversations anyone's writes touched.\n\nReturns at once when there is something; otherwise it waits up to wait seconds. Pass the returned next as since to continue, and give the call a timeout longer than wait.";
+            readonly description: "Read what concerns you since your last read. On your records: Work given to you or changed by its requester, an answer to your submission, an answer to your ask, and a message to you. Routed to you: an ask on Work you requested, and a submission of Work you requested. The person also gets the asks on Work their asker requested itself or on no Work, and stands in for closed Actors. Your own writes are not items. changed names the Actors, Work and conversations anyone's writes touched.\n\nReturns at once when there is something; otherwise it waits up to wait seconds. Pass the returned next as since to continue, and give the call a timeout longer than wait.";
         };
     };
 };

package/dist/src/domain/model/attention.js

@@ -21,11 +21,11 @@ export const AttentionRequest = z
 export const AttentionItem = z
     .strictObject({
     kind: z
-        .enum(["assigned", "updated", "reviewed", "answer", "raised", "message", "ask", "review_due"])
-        .describe("On your records: assigned (Work given to you), updated (Work you own, changed or cancelled by its requester), reviewed (your submission answered), answer (your ask answered, one per responder), raised (your ask passed one manager up), message (one to you). Routed to you: ask (from a report, raised to you, or passed to you by the close of an Actor it waited on, while it is open and still routed to you), review_due (a submission of Work you requested, or that a closed requester you stand in for requested, while it waits)."),
+        .enum(["assigned", "updated", "reviewed", "answer", "message", "ask", "review_due"])
+        .describe("On your records: assigned (Work given to you), updated (Work you own, changed or cancelled by its requester), reviewed (your submission answered), answer (your ask answered, one per responder), message (one to you). Routed to you: ask (on Work you requested; for the person, also on Work its asker requested itself or on no Work, or passed by the close of the Actor it waited on; while it is open and still routed to you), review_due (a submission of Work you requested, or for the person of Work a closed Actor requested, while it waits)."),
     recordID: z
         .string()
-        .describe("The ticketID for assigned, updated, reviewed and review_due; the askID for answer, raised and ask; the messageID for message."),
+        .describe("The ticketID for assigned, updated, reviewed and review_due; the askID for answer and ask; the messageID for message."),
     from: z.strictObject({ actorID: Id, name: z.string() }).describe("Who wrote it."),
     title: z.string().describe("The ask's or the Work's title, or the message's first line."),
     at: Timestamp,
@@ -40,7 +40,7 @@ export const Attention = z
         .strictObject({
         actorIDs: z
             .array(Id)
-            .describe("The parties of each write: a Work's owner, requester and previous owner, an ask's asker, a message's two Actors, and an Actor created or closed with its manager."),
+            .describe("The parties of each write: a Work's owner, requester and previous owner, an ask's asker, a message's two Actors, and an Actor created or closed."),
         workIDs: z.array(z.string()).describe("Work written, and the Work each written ask is on."),
         conversationIDs: z.array(z.string()).describe("Conversations a message was sent in."),
     })
@@ -51,10 +51,9 @@ export const Attention = z
 export const ATTENTION = toolDefinition("attention", {
     attention: {
         writes: false,
-        level: "report",
         request: AttentionRequest,
         response: Attention,
-        description: `Read what concerns you since your last read. On your records: Work given to you or changed by its requester, an answer to your submission, an answer to your ask or its raise, and a message to you. Routed to you: an ask from a report or raised to you, and a submission of Work you requested, with those of a closed Actor you stand in for. Your own writes are not items. changed names the Actors, Work and conversations anyone's writes touched.
+        description: `Read what concerns you since your last read. On your records: Work given to you or changed by its requester, an answer to your submission, an answer to your ask, and a message to you. Routed to you: an ask on Work you requested, and a submission of Work you requested. The person also gets the asks on Work their asker requested itself or on no Work, and stands in for closed Actors. Your own writes are not items. changed names the Actors, Work and conversations anyone's writes touched.
 
 Returns at once when there is something; otherwise it waits up to wait seconds. Pass the returned next as since to continue, and give the call a timeout longer than wait.`,
     },