@kici-dev/engine 0.1.14 → 0.1.16

package/dist/protocol/messages/peer.d.ts

@@ -14,6 +14,7 @@ declare const scalerCapacitySummarySchema: z.ZodObject<{
     labelSets: z.ZodArray<z.ZodArray<z.ZodString>>;
     maxAgents: z.ZodNumber;
     activeCount: z.ZodNumber;
+    spawnsOnLocalHost: z.ZodOptional<z.ZodBoolean>;
     mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 /** Peer hello: initiator sends ephemeral X25519 public key and nonce. */
@@ -57,6 +58,7 @@ export declare const peerAuthResponseSchema: z.ZodObject<{
         platform: z.ZodString;
         arch: z.ZodString;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        scalerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
     scalerCapacity: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
@@ -64,6 +66,7 @@ export declare const peerAuthResponseSchema: z.ZodObject<{
         labelSets: z.ZodArray<z.ZodArray<z.ZodString>>;
         maxAgents: z.ZodNumber;
         activeCount: z.ZodNumber;
+        spawnsOnLocalHost: z.ZodOptional<z.ZodBoolean>;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>>>;
     capabilities: z.ZodOptional<z.ZodObject<{
@@ -89,6 +92,7 @@ export declare const peerHeartbeatSchema: z.ZodObject<{
         platform: z.ZodString;
         arch: z.ZodString;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        scalerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
     capabilities: z.ZodObject<{
         s3LogAccess: z.ZodBoolean;
@@ -103,6 +107,7 @@ export declare const peerHeartbeatSchema: z.ZodObject<{
         labelSets: z.ZodArray<z.ZodArray<z.ZodString>>;
         maxAgents: z.ZodNumber;
         activeCount: z.ZodNumber;
+        spawnsOnLocalHost: z.ZodOptional<z.ZodBoolean>;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>>>;
     configVersion: z.ZodOptional<z.ZodNumber>;
@@ -297,6 +302,38 @@ export declare const peerConfigReloadResponseSchema: z.ZodObject<{
     restartRequired: z.ZodOptional<z.ZodArray<z.ZodString>>;
     fieldsChanged: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
+/** Which of THIS peer's downstream nodes to gather. all=true ignores the id lists. */
+export declare const fleetSelectionSchema: z.ZodObject<{
+    all: z.ZodBoolean;
+    agentIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    workerInstanceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/** Ask a peer to assemble and stream back its subtree bundle. */
+export declare const peerLogsCollectRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"peer.logs.collect.request">;
+    messageId: z.ZodString;
+    logWindowHours: z.ZodNumber;
+    includeCoordinatorMesh: z.ZodBoolean;
+    selection: z.ZodObject<{
+        all: z.ZodBoolean;
+        agentIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        workerInstanceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** One base64 frame of a peer's subtree ZIP. */
+export declare const peerLogsCollectChunkSchema: z.ZodObject<{
+    type: z.ZodLiteral<"peer.logs.collect.chunk">;
+    messageId: z.ZodString;
+    seq: z.ZodNumber;
+    isLast: z.ZodBoolean;
+    dataB64: z.ZodString;
+}, z.core.$strip>;
+/** Peer failed to assemble/stream its subtree. */
+export declare const peerLogsCollectErrorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"peer.logs.collect.error">;
+    messageId: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
 /** Graceful shutdown announcement. Peers remove sender from registry immediately. */
 export declare const peerLeavingSchema: z.ZodObject<{
     type: z.ZodLiteral<"peer.leaving">;
@@ -373,6 +410,7 @@ export declare const peerToPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         platform: z.ZodString;
         arch: z.ZodString;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        scalerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
     scalerCapacity: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
@@ -380,6 +418,7 @@ export declare const peerToPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         labelSets: z.ZodArray<z.ZodArray<z.ZodString>>;
         maxAgents: z.ZodNumber;
         activeCount: z.ZodNumber;
+        spawnsOnLocalHost: z.ZodOptional<z.ZodBoolean>;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>>>;
     capabilities: z.ZodOptional<z.ZodObject<{
@@ -403,6 +442,7 @@ export declare const peerToPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         platform: z.ZodString;
         arch: z.ZodString;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        scalerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
     capabilities: z.ZodObject<{
         s3LogAccess: z.ZodBoolean;
@@ -417,6 +457,7 @@ export declare const peerToPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         labelSets: z.ZodArray<z.ZodArray<z.ZodString>>;
         maxAgents: z.ZodNumber;
         activeCount: z.ZodNumber;
+        spawnsOnLocalHost: z.ZodOptional<z.ZodBoolean>;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>>>;
     configVersion: z.ZodOptional<z.ZodNumber>;
@@ -559,6 +600,26 @@ export declare const peerToPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
     errors: z.ZodOptional<z.ZodArray<z.ZodString>>;
     restartRequired: z.ZodOptional<z.ZodArray<z.ZodString>>;
     fieldsChanged: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"peer.logs.collect.request">;
+    messageId: z.ZodString;
+    logWindowHours: z.ZodNumber;
+    includeCoordinatorMesh: z.ZodBoolean;
+    selection: z.ZodObject<{
+        all: z.ZodBoolean;
+        agentIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        workerInstanceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"peer.logs.collect.chunk">;
+    messageId: z.ZodString;
+    seq: z.ZodNumber;
+    isLast: z.ZodBoolean;
+    dataB64: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"peer.logs.collect.error">;
+    messageId: z.ZodString;
+    message: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"peer.leaving">;
     instanceId: z.ZodString;
@@ -617,6 +678,7 @@ export declare const peerFromPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
         platform: z.ZodString;
         arch: z.ZodString;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        scalerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>>;
     scalerCapacity: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
@@ -624,6 +686,7 @@ export declare const peerFromPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
         labelSets: z.ZodArray<z.ZodArray<z.ZodString>>;
         maxAgents: z.ZodNumber;
         activeCount: z.ZodNumber;
+        spawnsOnLocalHost: z.ZodOptional<z.ZodBoolean>;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>>>;
     capabilities: z.ZodOptional<z.ZodObject<{
@@ -647,6 +710,7 @@ export declare const peerFromPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
         platform: z.ZodString;
         arch: z.ZodString;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        scalerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
     capabilities: z.ZodObject<{
         s3LogAccess: z.ZodBoolean;
@@ -661,6 +725,7 @@ export declare const peerFromPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
         labelSets: z.ZodArray<z.ZodArray<z.ZodString>>;
         maxAgents: z.ZodNumber;
         activeCount: z.ZodNumber;
+        spawnsOnLocalHost: z.ZodOptional<z.ZodBoolean>;
         mandatoryLabels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>>>;
     configVersion: z.ZodOptional<z.ZodNumber>;
@@ -803,6 +868,26 @@ export declare const peerFromPeerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     errors: z.ZodOptional<z.ZodArray<z.ZodString>>;
     restartRequired: z.ZodOptional<z.ZodArray<z.ZodString>>;
     fieldsChanged: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"peer.logs.collect.request">;
+    messageId: z.ZodString;
+    logWindowHours: z.ZodNumber;
+    includeCoordinatorMesh: z.ZodBoolean;
+    selection: z.ZodObject<{
+        all: z.ZodBoolean;
+        agentIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        workerInstanceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"peer.logs.collect.chunk">;
+    messageId: z.ZodString;
+    seq: z.ZodNumber;
+    isLast: z.ZodBoolean;
+    dataB64: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"peer.logs.collect.error">;
+    messageId: z.ZodString;
+    message: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"peer.leaving">;
     instanceId: z.ZodString;
@@ -843,6 +928,10 @@ export type PeerConfigReload = z.infer<typeof peerConfigReloadSchema>;
 export type PeerConfigReloadResponse = z.infer<typeof peerConfigReloadResponseSchema>;
 export type PeerLeaving = z.infer<typeof peerLeavingSchema>;
 export type PeerAgentTokenRevoke = z.infer<typeof peerAgentTokenRevokeSchema>;
+export type FleetSelection = z.infer<typeof fleetSelectionSchema>;
+export type PeerLogsCollectRequest = z.infer<typeof peerLogsCollectRequestSchema>;
+export type PeerLogsCollectChunk = z.infer<typeof peerLogsCollectChunkSchema>;
+export type PeerLogsCollectError = z.infer<typeof peerLogsCollectErrorSchema>;
 export type PeerToPeerMessage = z.infer<typeof peerToPeerMessageSchema>;
 export {};
 //# sourceMappingURL=peer.d.ts.map

package/dist/protocol/messages/peer.js

@@ -22,7 +22,14 @@ const peerAgentSummarySchema = z.object({
 	* predate the gate omit the field, and the coordinator falls back to
 	* "no gate" routing for those agents (matching pre-gate behavior).
 	*/
-	mandatoryLabels: z.array(z.string()).optional().default([])
+	mandatoryLabels: z.array(z.string()).optional().default([]),
+	/**
+	* Name of the scaler backend that spawned this agent, or null/omitted for
+	* static (stateful) agents not bound to any scaler. Carried so the dashboard
+	* diagnostics tree can group a worker peer's agents under the correct scaler
+	* row (and the stateful-agents row) without a second round trip.
+	*/
+	scalerName: z.string().nullable().optional()
 });
 /** Peer capabilities advertised during heartbeat and auth response. */
 const peerCapabilitiesSchema = z.object({
@@ -42,6 +49,12 @@ const scalerCapacitySummarySchema = z.object({
 	/** Current active count for this backend */
 	activeCount: z.number(),
 	/**
+	* Whether this backend spawns its agents on the peer's own host (bare-metal,
+	* Firecracker, container on a local runtime socket). Lets diagnostics
+	* surface the peer's hostname as the scaler's spawning host.
+	*/
+	spawnsOnLocalHost: z.boolean().optional(),
+	/**
 	* Labels a job MUST declare in `runsOn` to be allowed on this backend
 	* (Kubernetes-taint-style opt-in gate). When omitted (legacy peer) or
 	* empty the backend has no gate. Cross-peer routing applies the same
@@ -303,6 +316,35 @@ const peerConfigReloadResponseSchema = z.object({
 	restartRequired: z.array(z.string()).optional(),
 	fieldsChanged: z.array(z.string()).optional()
 });
+/** Which of THIS peer's downstream nodes to gather. all=true ignores the id lists. */
+const fleetSelectionSchema = z.object({
+	all: z.boolean(),
+	agentIds: z.array(z.string()).default([]),
+	workerInstanceIds: z.array(z.string()).default([])
+});
+/** Ask a peer to assemble and stream back its subtree bundle. */
+const peerLogsCollectRequestSchema = z.object({
+	type: z.literal("peer.logs.collect.request"),
+	messageId: z.string(),
+	logWindowHours: z.number(),
+	/** Loop guard: false on every downstream request so the coordinator mesh never echoes. */
+	includeCoordinatorMesh: z.boolean(),
+	selection: fleetSelectionSchema
+});
+/** One base64 frame of a peer's subtree ZIP. */
+const peerLogsCollectChunkSchema = z.object({
+	type: z.literal("peer.logs.collect.chunk"),
+	messageId: z.string(),
+	seq: z.number().int().nonnegative(),
+	isLast: z.boolean(),
+	dataB64: z.string()
+});
+/** Peer failed to assemble/stream its subtree. */
+const peerLogsCollectErrorSchema = z.object({
+	type: z.literal("peer.logs.collect.error"),
+	messageId: z.string(),
+	message: z.string()
+});
 /** Graceful shutdown announcement. Peers remove sender from registry immediately. */
 const peerLeavingSchema = z.object({
 	type: z.literal("peer.leaving"),
@@ -364,6 +406,9 @@ const peerToPeerMessageSchema = z.discriminatedUnion("type", [
 	peerCacheUploadResponseSchema,
 	peerConfigReloadSchema,
 	peerConfigReloadResponseSchema,
+	peerLogsCollectRequestSchema,
+	peerLogsCollectChunkSchema,
+	peerLogsCollectErrorSchema,
 	peerLeavingSchema,
 	peerAgentTokenRevokeSchema,
 	peerScalerEventSchema
@@ -387,11 +432,14 @@ const peerFromPeerMessageSchema = z.discriminatedUnion("type", [
 	peerCacheUploadResponseSchema,
 	peerConfigReloadSchema,
 	peerConfigReloadResponseSchema,
+	peerLogsCollectRequestSchema,
+	peerLogsCollectChunkSchema,
+	peerLogsCollectErrorSchema,
 	peerLeavingSchema,
 	peerAgentTokenRevokeSchema,
 	peerScalerEventSchema
 ]);
 //#endregion
-export { jobProgressSchema, jobRerouteAckSchema, jobRerouteSchema, peerAgentTokenRevokeSchema, peerAuthRequestSchema, peerAuthResponseSchema, peerCapabilitiesSchema, peerConfigReloadResponseSchema, peerConfigReloadSchema, peerFromPeerMessageSchema, peerHeartbeatSchema, peerHelloResponseSchema, peerHelloSchema, peerJobCancelSchema, peerLeavingSchema, peerScalerEventSchema, peerToPeerMessageSchema, raftAppendEntriesSchema, raftVoteRequestSchema, raftVoteResponseSchema };
+export { fleetSelectionSchema, jobProgressSchema, jobRerouteAckSchema, jobRerouteSchema, peerAgentTokenRevokeSchema, peerAuthRequestSchema, peerAuthResponseSchema, peerCapabilitiesSchema, peerConfigReloadResponseSchema, peerConfigReloadSchema, peerFromPeerMessageSchema, peerHeartbeatSchema, peerHelloResponseSchema, peerHelloSchema, peerJobCancelSchema, peerLeavingSchema, peerLogsCollectChunkSchema, peerLogsCollectErrorSchema, peerLogsCollectRequestSchema, peerScalerEventSchema, peerToPeerMessageSchema, raftAppendEntriesSchema, raftVoteRequestSchema, raftVoteResponseSchema };
 
 //# sourceMappingURL=peer.js.map