@chipschat/protocol 1.0.3 → 1.0.5

package/generated/schema/hello.json

@@ -117,7 +117,7 @@
           "description": "The server's own version."
         },
         "takes": {
-          "description": "What this server keeps of what a person's client may send beyond the base set, by the names in `SERVER_TAKES`. `held_yes` is `for_minutes` and `until_stopped` on `approval.resolved`. A server older than the field says nothing, and drops those fields, so a client offers neither to it (ADR 0281).",
+          "description": "What this server keeps of what a person's client may send beyond the base set, by the names in `SERVER_TAKES`. `held_yes` is `for_minutes` and `until_stopped` on `approval.resolved`. A server older than the field says nothing, and drops those fields, so a client offers neither to it (ADR 0281). `spend_no_cap` is No cap and amounts past $100 on a room's Spend per job (ADR 0292).",
           "maxItems": 32,
           "type": "array",
           "items": {

package/generated/schema/message.handed.json

@@ -90,9 +90,30 @@
       "description": "Who it is handed to."
     },
     "lead": {
-      "description": "Handed to the room's lead because it was nobody's turn and the room went still (ADR 0104), rather than held by the referee.",
+      "description": "Handed to the room's lead because it was nobody's turn and the room went still (ADR 0104), or because the agent it was for did not pick it up (`unanswered_by`), rather than held by the referee.",
       "type": "boolean",
       "const": true
+    },
+    "unanswered_by": {
+      "description": "The agent the message was for that did not pick it up (ADR 0291): no turn of its on it, no word and no pass, a minute after it was said. The message is handed to the room's lead, or, when the lead said it or is the one that did not pick it up, back to the agent that said it.",
+      "type": "string",
+      "pattern": "^(?:agt|hrn)_[0-7][0-9A-HJKMNP-TV-Z]{25}$"
+    },
+    "why": {
+      "description": "With `unanswered_by`, why: its harness is `offline`, or says something is wrong (`trouble`); its turn on the message `failed`; or it is connected and nothing has been heard from it (`silent`).",
+      "type": "string",
+      "enum": [
+        "offline",
+        "trouble",
+        "failed",
+        "silent"
+      ]
+    },
+    "reason": {
+      "description": "For `trouble`, what its harness said is wrong; for `failed`, the run's error.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
     }
   },
   "required": [

package/generated/schema/message.new.json

@@ -1161,6 +1161,46 @@
               "minutes"
             ]
           }
+        },
+        "away": {
+          "description": "The room's agents that can't answer as Chips sends this turn (ADR 0291): offline, or their harness says something is wrong. Work handed to one of them waits.",
+          "maxItems": 500,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "participant_id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120
+              },
+              "why": {
+                "type": "string",
+                "enum": [
+                  "offline",
+                  "trouble"
+                ],
+                "description": "`offline`: no connection of its harness is open. `trouble`: its harness is connected and says something is wrong on its side (ADR 0083)."
+              },
+              "reason": {
+                "description": "For `trouble`: what its harness said is wrong, in its own words.",
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              },
+              "minutes": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991,
+                "description": "For how long, in whole minutes."
+              }
+            },
+            "required": [
+              "participant_id",
+              "why",
+              "minutes"
+            ]
+          }
         }
       },
       "required": [

package/generated/schema/run.status.json

@@ -102,6 +102,10 @@
       "type": "integer",
       "minimum": 0,
       "maximum": 9007199254740991
+    },
+    "pausable": {
+      "description": "This run holds where it is when a person pauses it (ADR 0293): on `run.pause` the harness stops the run's work within a few seconds without ending it, on `run.resume` it carries on in the same conversation, and on `run.cancel` while paused it ends quietly. Said once, on any status of the run; clients offer Pause only on a run that said it.",
+      "type": "boolean"
     }
   },
   "required": [

package/generated/schema/space.spend_ceiling_lifted.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "v": {
+      "type": "number",
+      "const": 1,
+      "description": "Protocol major version."
+    },
+    "type": {
+      "type": "string",
+      "const": "space.spend_ceiling_lifted"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^evt_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "The event's own id. Stable across a retry of the same event."
+    },
+    "ts": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+      "description": "When it happened, by Chips' clock. Stamped on the way in; a value the sender writes is replaced."
+    },
+    "workspace_id": {
+      "type": "string",
+      "pattern": "^ws_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
+      "description": "A workspace identifier: `ws_` followed by a ULID."
+    },
+    "space_id": {
+      "description": "The space, when the event belongs to one.",
+      "type": "string",
+      "pattern": "^spc_[0-7][0-9A-HJKMNP-TV-Z]{25}$"
+    },
+    "run_id": {
+      "description": "The run, when the event belongs to one.",
+      "type": "string",
+      "pattern": "^run_[0-7][0-9A-HJKMNP-TV-Z]{25}$"
+    },
+    "seq": {
+      "description": "Assigned by the server on append, monotonic per workspace. Absent on the way in.",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "idempotency_key": {
+      "description": "Required on every client-originated write. Sending the same key twice is a no-op.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "actor": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "person",
+            "harness",
+            "agent",
+            "system"
+          ],
+          "description": "Whether a person, a harness, one of a harness's agents or Chips itself acted."
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The participant id, or `system` for Chips."
+        },
+        "harness_id": {
+          "description": "For an agent: the harness it speaks through, whose budget and runs are the agent's (ADR 0087). Filled in by Chips.",
+          "type": "string",
+          "pattern": "^hrn_[0-7][0-9A-HJKMNP-TV-Z]{25}$"
+        }
+      },
+      "required": [
+        "kind",
+        "id"
+      ],
+      "description": "The participant an event is attributed to."
+    }
+  },
+  "required": [
+    "v",
+    "type",
+    "id",
+    "ts",
+    "workspace_id",
+    "actor"
+  ],
+  "description": "A room's cap on what a job may spend was taken off: No cap.",
+  "$id": "https://chipschat.ai/schema/v1/space.spend_ceiling_lifted.json",
+  "title": "SpaceSpendCeilingLifted"
+}

package/generated/schema/space.spend_ceiling_set.json

@@ -80,7 +80,7 @@
       "description": "The participant an event is attributed to."
     },
     "usd": {
-      "description": "What the room allows a job now, in US dollars, from 0.25 to 100 in steps of 0.25; `null` for the default (3).",
+      "description": "What the room allows a job now, in US dollars, from 0.25 to 1000 in steps of 0.25; `null` for the default (3).",
       "type": [
         "number",
         "null"

package/generated/types.ts

@@ -191,6 +191,8 @@ export interface RunStatus {
   progress?: number;
   /** Seconds remaining, when the harness knows. */
   estimate_seconds?: number;
+  /** This run holds where it is when a person pauses it (ADR 0293): on `run.pause` the harness stops the run's work within a few seconds without ending it, on `run.resume` it carries on in the same conversation, and on `run.cancel` while paused it ends quietly. Said once, on any status of the run; clients offer Pause only on a run that said it. */
+  pausable?: boolean;
 }
 
 /** `run.plan` — The plan changed. Replaces the steps not yet done; the ones already done or failed keep their place. */
@@ -1015,7 +1017,7 @@ export interface Hello {
     name: string;
     /** The server's own version. */
     version: string;
-    /** What this server keeps of what a person's client may send beyond the base set, by the names in `SERVER_TAKES`. `held_yes` is `for_minutes` and `until_stopped` on `approval.resolved`. A server older than the field says nothing, and drops those fields, so a client offers neither to it (ADR 0281). */
+    /** What this server keeps of what a person's client may send beyond the base set, by the names in `SERVER_TAKES`. `held_yes` is `for_minutes` and `until_stopped` on `approval.resolved`. A server older than the field says nothing, and drops those fields, so a client offers neither to it (ADR 0281). `spend_no_cap` is No cap and amounts past $100 on a room's Spend per job (ADR 0292). */
     takes?: string[];
   };
   /** The harness the token belongs to, and only that one. One connection speaks for all of the harness's agents (ADR 0087), which `agents` lists. A harness running inside another is a lane, not a duplicate. */
@@ -1443,6 +1445,16 @@ export interface MessageNew {
       /** How long since its last turn here ended, in whole minutes. */
       minutes: number;
     }[];
+    /** The room's agents that can't answer as Chips sends this turn (ADR 0291): offline, or their harness says something is wrong. Work handed to one of them waits. */
+    away?: {
+      participant_id: string;
+      /** `offline`: no connection of its harness is open. `trouble`: its harness is connected and says something is wrong on its side (ADR 0083). */
+      why: "offline" | "trouble";
+      /** For `trouble`: what its harness said is wrong, in its own words. */
+      reason?: string;
+      /** For how long, in whole minutes. */
+      minutes: number;
+    }[];
   };
   /** How the agents' talk in the room stands, once it is worth a word (ADR 0097): from eight messages between agents since a person last acted or an agent last made something new. A harness puts `note` at the top of the turn, as Chips's, ahead of the room's note. Absent below that, and worked out from the log, so a replay hands over the same facts. */
   exchange?: {
@@ -3122,8 +3134,14 @@ export interface MessageHanded {
   message_id: string;
   /** Who it is handed to. */
   agent_id: string;
-  /** Handed to the room's lead because it was nobody's turn and the room went still (ADR 0104), rather than held by the referee. */
+  /** Handed to the room's lead because it was nobody's turn and the room went still (ADR 0104), or because the agent it was for did not pick it up (`unanswered_by`), rather than held by the referee. */
   lead?: true;
+  /** The agent the message was for that did not pick it up (ADR 0291): no turn of its on it, no word and no pass, a minute after it was said. The message is handed to the room's lead, or, when the lead said it or is the one that did not pick it up, back to the agent that said it. */
+  unanswered_by?: string;
+  /** With `unanswered_by`, why: its harness is `offline`, or says something is wrong (`trouble`); its turn on the message `failed`; or it is connected and nothing has been heard from it (`silent`). */
+  why?: "offline" | "trouble" | "failed" | "silent";
+  /** For `trouble`, what its harness said is wrong; for `failed`, the run's error. */
+  reason?: string;
 }
 
 /** `space.lead_set` — A room's lead was chosen, or taken away. */
@@ -3186,10 +3204,40 @@ export interface SpaceSpendCeilingSet {
     /** For an agent: the harness it speaks through, whose budget and runs are the agent's (ADR 0087). Filled in by Chips. */
     harness_id?: string;
   };
-  /** What the room allows a job now, in US dollars, from 0.25 to 100 in steps of 0.25; `null` for the default (3). */
+  /** What the room allows a job now, in US dollars, from 0.25 to 1000 in steps of 0.25; `null` for the default (3). */
   usd: unknown;
 }
 
+/** `space.spend_ceiling_lifted` — A room's cap on what a job may spend was taken off: No cap. */
+export interface SpaceSpendCeilingLifted {
+  /** Protocol major version. */
+  v: 1;
+  type: "space.spend_ceiling_lifted";
+  /** The event's own id. Stable across a retry of the same event. */
+  id: string;
+  /** When it happened, by Chips' clock. Stamped on the way in; a value the sender writes is replaced. */
+  ts: string;
+  /** A workspace identifier: `ws_` followed by a ULID. */
+  workspace_id: string;
+  /** The space, when the event belongs to one. */
+  space_id?: string;
+  /** The run, when the event belongs to one. */
+  run_id?: string;
+  /** Assigned by the server on append, monotonic per workspace. Absent on the way in. */
+  seq?: number;
+  /** Required on every client-originated write. Sending the same key twice is a no-op. */
+  idempotency_key?: string;
+  /** The participant an event is attributed to. */
+  actor: {
+    /** Whether a person, a harness, one of a harness's agents or Chips itself acted. */
+    kind: "person" | "harness" | "agent" | "system";
+    /** The participant id, or `system` for Chips. */
+    id: string;
+    /** For an agent: the harness it speaks through, whose budget and runs are the agent's (ADR 0087). Filled in by Chips. */
+    harness_id?: string;
+  };
+}
+
 /** `space.lock_set` — A room's changes were locked, or let go: while locked, no person renames, archives or deletes it. */
 export interface SpaceLockSet {
   /** Protocol major version. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chipschat/protocol",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Agent Connect: the canonical Zod schemas, the identifier vocabulary, and everything generated from them.",
   "license": "Apache-2.0",
   "homepage": "https://chipschat.ai/reference/",