@re-cinq/floor-contracts 0.2.0 → 0.4.0

package/dist/definitions.d.ts

@@ -92,6 +92,8 @@ export interface StationBody {
     conversationKey?: string;
     outcomes: string[];
     mustChange?: boolean;
+    /** Agent kind only: an agent that ends with neither a `LORE_NODE_RESULT:` line nor a `REVIEW_RESULT:` verdict has failed its visit, instead of being read as `success`. */
+    resultRequired?: boolean;
     needs: NeedSpec[];
     produces: ProduceSpec[];
     /** Service kind only. */

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export type { AgentDefinitionBody, AgentSettings, Brief, Item, ItemKind, LineArgSpec, LineBody, LineEdge, LineNode, LineNodeReport, LineStart, ModelPrice, NeedSpec, ProduceSpec, Report, ScheduleBody, StationBody, StationKind, WhenValue, } from "./definitions.js";
-export type { BlobRef, BriefConversation, BriefNeed, BriefSettings, ClaimedEvent, DefinitionKind, ExecutorSettings, FileNeed, GitCredential, GitNeed, McpServerSettings, PodResources, MigrationBody, Problem, PutResult, ValueNeed, VisitBrief, } from "./wire.js";
+export type { AgentPresence, AgentRecipes, BlobRef, BriefConversation, BriefNeed, BriefSettings, ClaimedEvent, ClusterHolding, ClusterPresence, DefinitionKind, ExecutorSettings, FileNeed, GitCredential, GitNeed, McpServerSettings, PodResources, PresenceState, MigrationBody, Problem, PutResult, ValueNeed, VisitBrief, } from "./wire.js";
 export type { CostsRow, DefinitionRowFields, DefinitionRowView, FloorEventFields, FloorEventView, FloorFrame, LiveFrame, RecordKind, RunFields, RunView, StationRunRecordFields, StationRunRecordView, VisitFields, VisitView, } from "./views.js";

package/dist/wire.d.ts

@@ -63,10 +63,12 @@ export interface PodResources {
     requests?: Record<string, string>;
     limits?: Record<string, string>;
 }
+/** `timeoutMinutes` is the definition's own work budget, the same for every visit; `VisitBrief.deadlineMinutes` is what is left of this visit's. */
 export type BriefSettings = ExecutorSettings & {
     model?: string;
     prompt: string;
     image: string;
+    timeoutMinutes?: number;
 };
 /** `GET /station-runs/:id/brief`: everything an executor needs to run one visit, and a token that reaches only this visit. */
 export interface VisitBrief {
@@ -87,15 +89,57 @@ export interface VisitBrief {
     conversation: BriefConversation;
     modelSecretKey?: string;
 }
-/** `POST /events/claim` answers only the two events a worker may take, and both name the visit they are about. */
-export interface ClaimedEvent {
+interface ClaimedFields {
     id: string;
+    tags: string[];
+    attempts: number;
+}
+/** `POST /events/claim` answers only what a worker may take: a visit to dispatch or abort, or an agent definition whose latest version this cluster should hold. */
+export type ClaimedEvent = (ClaimedFields & {
     name: "station_run.dispatch" | "station_run.abort";
     payload: {
         visitId: string;
     };
-    tags: string[];
-    attempts: number;
+}) | (ClaimedFields & {
+    name: "agent_definition.changed";
+    payload: {
+        id: string;
+        hash: string;
+    };
+});
+/** all: every live cluster holds the latest version. some: a cluster holds a version, but not every one the latest. none: no cluster holds any. */
+export type PresenceState = "all" | "some" | "none";
+export interface ClusterPresence {
+    id: string;
+    /** The version this cluster's kube holds; null when it holds none. */
+    hash: string | null;
+    current: boolean;
+}
+/** `GET /agent-definitions/presence`, by agent definition id. */
+export interface AgentPresence {
+    state: PresenceState;
+    latest: string;
+    clusters: ClusterPresence[];
+}
+/** `GET /agent-definitions/{id}/clusters`: what one cluster read back out of its kube. */
+export interface ClusterHolding<Body = unknown> {
+    clusterId: string;
+    hash: string;
+    body: Body;
+    appliedAt: string;
+}
+/** `GET /agent-definitions/{id}/recipes`: the latest version, and the settings a visit of each variant is briefed with. `variant` null is the base. */
+export interface AgentRecipes<Body = unknown> {
+    id: string;
+    hash: string;
+    body: Body;
+    /** The floor as a pod reaches it, as a visit's brief says it. */
+    floorBaseUrl: string;
+    recipes: {
+        variant: string | null;
+        settings: BriefSettings;
+        modelSecretKey?: string;
+    }[];
 }
 /** What a floor answers for bytes it now keeps: `POST /blobs`, and a saved conversation. */
 export interface BlobRef {
@@ -117,3 +161,4 @@ export interface GitCredential {
     username: string;
     password: string;
 }
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@re-cinq/floor-contracts",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "The floor's wire, as types: what its HTTP routes and its live socket take and answer, and nothing else. No runtime, no dependencies.",
   "license": "Apache-2.0",
   "repository": {