@primusclaw/personal-agent 0.1.1 → 0.3.0

package/dist/types/routing/turn-start.d.ts

@@ -3,8 +3,6 @@ import type { InboundFile } from "../ports/surface.js";
 import type { Chat } from "./chat.js";
 import type { RouterContext } from "./context.js";
 import type { ReviewRunFields, TurnOutcome } from "./turn-runner.js";
-/** What a waiting message gives the turn in front to start running in Claw (`_queue_behind`). */
-export declare const SUBMIT_WAIT_SECONDS = 15;
 /** Teams on a phone or a tablet: its own Stop under a reply is greyed out, and its own thumbs never reach the worker. */
 export declare function isMobile(clientPlatform: string): boolean;
 /** A review the review service starts as a turn here (its item runs in Claw already; the turn only follows it). */
@@ -47,7 +45,8 @@ export interface StartTurn {
 /**
  * Starting and following a turn (the Python `Agent._start_turn`, `_queue_behind`, `_guarded`, `_record_session`,
  * `_record_turn`): a new task is admitted under the person's task limit; a message sent while the chat's turn runs is
- * queued in Claw behind it (one at most); a review has a session of its own and is neither queued nor queued behind.
+ * queued behind it (up to `QUEUED_TURNS_MAX`, in order, each told its place) and goes to Claw once every turn in front of it
+ * is over, so `/stop` can still give it up; a review has a session of its own and is neither queued nor queued behind.
  */
 export declare class TurnStarter {
     private readonly ctx;
@@ -57,11 +56,20 @@ export declare class TurnStarter {
     settled(): Promise<void>;
     /** The turn that runs (its end is `done`), or undefined when none was started (the person was told why). */
     start(request: StartTurn): Promise<RunningTurn | undefined>;
+    private track;
+    /** The turn goes to Claw now; its end is `done`. */
+    private launch;
+    /**
+     * A queued turn: it goes once every turn in front of it is over, or stopped (Claw took its interrupt: Claw is free for the next
+     * message, whether or not that turn ever reports its end); the caller does not wait for it. Not at all when it was given up
+     * meanwhile (`/stop`, said there).
+     */
+    private afterFront;
     /** True when admitted as the chat's first turn; false when the chat has one (queue behind it); undefined: refused. */
     private admit;
     /**
-     * Registers `turn` behind the chat's running one; false (the person is told why) when it may not go. It is sent only
-     * once Claw runs the turn in front: then Claw names that turn as the one it waits behind.
+     * Registers `turn` behind the chat's running one: "front" when the chat has none after all (it runs now), "waiting" when it
+     * is queued (the person is told its place), "refused" (and told why) when it may not wait.
      */
     private queueBehind;
     private sessionOf;

package/dist/types/subscriptions/subscriptions.d.ts

@@ -51,8 +51,12 @@ export declare class Subscriptions {
      * mended first and the user id filled in, so what is said is the state after trying. Never throws.
      */
     reachable(aadId: string): Promise<Unreachable>;
-    /** Make sure this linked person has a subscription (with the assistant's types when it is on). Never throws. */
-    ensure(aadId: string): Promise<void>;
+    /**
+     * Make sure this person has a subscription (with the assistant's types when it is on). It is made and mended with
+     * `credential` when one is given (a person with no link, whose chats run on an exchanged token), else with their linked
+     * key. Never throws.
+     */
+    ensure(aadId: string, credential?: string): Promise<void>;
     private create;
     /**
      * With the assistant on, the recorded subscription must be there in Claw, enabled and asking for the assistant's events: looked

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primusclaw/personal-agent",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "The personal agent's channel-neutral core: domain logic, ports and plugin interfaces.",
   "license": "MIT",
   "repository": {