@re-cinq/floor-client 0.3.0 → 0.4.0

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AgentDefinitionBody, LineBody, MigrationBody, PutResult, ScheduleBody, StationBody, DefinitionRowView, FloorEventView } from "@re-cinq/floor-contracts";
+import type { AgentDefinitionBody, AgentPresence, AgentRecipes, ClusterHolding, LineBody, MigrationBody, PutResult, ScheduleBody, StationBody, DefinitionRowView, FloorEventView } from "@re-cinq/floor-contracts";
 import { type BlobsApi, type ConversationApi } from "./blobs.js";
 import { type DefinitionApi } from "./definitions.js";
 import { type EventsApi } from "./events.js";
@@ -19,6 +19,18 @@ export interface LinesApi extends DefinitionApi<LineBody> {
     /** Answers the run already open on this subject, joined, rather than opening a second one. */
     start(lineId: string, starting: StartRun): Promise<StartedRun>;
 }
+export interface AgentDefinitionsApi extends DefinitionApi<AgentDefinitionBody> {
+    /** Every agent definition's presence on the clusters, by id. */
+    presence(): Promise<Record<string, AgentPresence>>;
+    /** What each cluster read back out of its kube for this agent definition. */
+    clusters(id: string): Promise<ClusterHolding<AgentDefinitionBody>[]>;
+    /** Null when nothing of that id is there. */
+    recipes(id: string): Promise<AgentRecipes<AgentDefinitionBody> | null>;
+}
+export interface ClustersApi {
+    /** Registers this cluster, or tells the floor it is still there. */
+    register(id: string, tags: string[]): Promise<void>;
+}
 export interface SchedulesApi extends DefinitionApi<ScheduleBody> {
     /** Posts this schedule's event now, without waiting for its cron. */
     trigger(id: string): Promise<FloorEventView | null>;
@@ -44,7 +56,8 @@ export interface FloorClient {
     readonly health: HealthApi;
     readonly lines: LinesApi;
     readonly stations: DefinitionApi<StationBody>;
-    readonly agentDefinitions: DefinitionApi<AgentDefinitionBody>;
+    readonly agentDefinitions: AgentDefinitionsApi;
+    readonly clusters: ClustersApi;
     readonly schedules: SchedulesApi;
     readonly migrations: MigrationsApi;
     readonly runs: RunsApi;

package/dist/client.js

@@ -2,7 +2,7 @@ import { blobsApi, conversationApi } from "./blobs.js";
 import { definitionApi } from "./definitions.js";
 import { eventsApi } from "./events.js";
 import { costsApi, runsApi } from "./runs.js";
-import { asked, reach } from "./send.js";
+import { asked, done, reach } from "./send.js";
 import { stationRunsApi } from "./station-runs.js";
 const HTTP_NOT_FOUND = 404;
 export function createFloorClient(access) {
@@ -11,7 +11,12 @@ export function createFloorClient(access) {
         health: healthApi(floor),
         lines: { ...definitionApi(floor, "assembly-lines"), start: (lineId, starting) => startRun(floor, lineId, starting) },
         stations: definitionApi(floor, "stations"),
-        agentDefinitions: definitionApi(floor, "agent-definitions"),
+        agentDefinitions: agentDefinitionsApi(floor),
+        clusters: {
+            register: async (id, tags) => {
+                await done(floor, { method: "PUT", path: `/clusters/${id}`, body: { tags } });
+            },
+        },
         schedules: { ...definitionApi(floor, "schedules"), trigger: (id) => asked(floor, { method: "POST", path: `/schedules/${id}/trigger` }, [HTTP_NOT_FOUND]) },
         migrations: migrationsApi(floor),
         runs: runsApi(floor),
@@ -49,4 +54,12 @@ function healthApi(floor) {
         version: async () => (await asked(floor, { method: "GET", path: "/version" })),
     };
 }
+function agentDefinitionsApi(floor) {
+    return {
+        ...definitionApi(floor, "agent-definitions"),
+        presence: async () => (await asked(floor, { method: "GET", path: "/agent-definitions/presence" })) ?? {},
+        clusters: async (id) => (await asked(floor, { method: "GET", path: `/agent-definitions/${id}/clusters` }))?.items ?? [],
+        recipes: (id) => asked(floor, { method: "GET", path: `/agent-definitions/${id}/recipes` }, [HTTP_NOT_FOUND]),
+    };
+}
 //# sourceMappingURL=client.js.map

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { FloorProblem, isFloorProblem } from "./problem.js";
 export { reach, asked, send } from "./send.js";
 export { CLOSE, watchRun } from "./live.js";
 export { watchFloor } from "./floor-live.js";
-export type { FloorAccess, FloorClient, HealthApi, LinesApi, MigrationsApi, SchedulesApi, Version } from "./client.js";
+export type { AgentDefinitionsApi, ClustersApi, FloorAccess, FloorClient, HealthApi, LinesApi, MigrationsApi, SchedulesApi, Version } from "./client.js";
 export type { AppendRecord, GitCredentialOutcome, VisitAccess, VisitClient } from "./visit.js";
 export type { ServiceToken, VisitToken } from "./tokens.js";
 export type { Asking, Reachable } from "./send.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@re-cinq/floor-client",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The floor over HTTP and its live socket, typed: definitions, runs, visits, blobs, events, schedules and costs, plus a watch that replays a run from a cursor and reconnects without losing a frame.",
   "license": "Apache-2.0",
   "repository": {
@@ -45,7 +45,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@re-cinq/floor-contracts": "0.3.0"
+    "@re-cinq/floor-contracts": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",