@kici-dev/engine 0.1.15 → 0.1.17

package/dist/protocol/messages/orchestrator-agent.d.ts

@@ -352,6 +352,28 @@ export declare const cacheUserSaveCompleteSchema: z.ZodObject<{
     tarHash: z.ZodString;
     sizeBytes: z.ZodNumber;
 }, z.core.$strip>;
+/** Agent -> Orchestrator: request a presigned PUT URL for a provenance bundle. */
+export declare const provenanceUploadRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"provenance.upload.request">;
+    messageId: z.ZodString;
+    jobId: z.ZodString;
+    subjectDigest: z.ZodString;
+}, z.core.$strip>;
+/** Orchestrator -> Agent: presigned PUT URL for the provenance bundle. */
+export declare const provenanceUploadResponseSchema: z.ZodObject<{
+    type: z.ZodLiteral<"provenance.upload.response">;
+    requestId: z.ZodString;
+    uploadUrl: z.ZodString;
+}, z.core.$strip>;
+/** Agent -> Orchestrator: confirm a provenance bundle upload (records an attestations row). */
+export declare const provenanceUploadCompleteSchema: z.ZodObject<{
+    type: z.ZodLiteral<"provenance.upload.complete">;
+    messageId: z.ZodString;
+    jobId: z.ZodString;
+    subjectName: z.ZodString;
+    subjectDigest: z.ZodString;
+    mediaType: z.ZodString;
+}, z.core.$strip>;
 /** Agent -> Orchestrator: emit a custom event from a running workflow step. */
 export declare const eventEmitSchema: z.ZodObject<{
     type: z.ZodLiteral<"event.emit">;
@@ -424,6 +446,81 @@ export declare const agentApiResponseSchema: z.ZodObject<{
     result: z.ZodOptional<z.ZodUnknown>;
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** Orchestrator asks an agent for its log/diagnostic mini-bundle. */
+export declare const fleetLogsRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"fleet.logs.request">;
+    requestId: z.ZodString;
+    logWindowHours: z.ZodNumber;
+    maxBytes: z.ZodNumber;
+}, z.core.$strip>;
+/** One base64 frame of an agent's mini-bundle ZIP. */
+export declare const fleetBundleChunkSchema: z.ZodObject<{
+    type: z.ZodLiteral<"fleet.bundle.chunk">;
+    requestId: z.ZodString;
+    seq: z.ZodNumber;
+    isLast: z.ZodBoolean;
+    dataB64: z.ZodString;
+}, z.core.$strip>;
+/** Agent failed to build/stream its mini-bundle. */
+export declare const fleetBundleErrorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"fleet.bundle.error">;
+    requestId: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+/** Outcome of a step-level approval hold, sent back to the waiting agent. */
+export declare const StepApprovalOutcome: z.ZodEnum<{
+    rejected: "rejected";
+    approved: "approved";
+    expired: "expired";
+}>;
+export type StepApprovalOutcome = z.infer<typeof StepApprovalOutcome>;
+/**
+ * Agent -> Orchestrator: a step carrying `requireApproval` is about to run and
+ * the agent is blocking its step loop until the orchestrator resolves the
+ * approval. The orchestrator creates a step-scoped `held_runs` row from the
+ * normalized requirement and replies with `step.approval-resolved` once the
+ * hold is approved, rejected, or expired. The agent keeps heartbeats flowing
+ * during the wait so it is not reaped as stale.
+ *
+ * NOT fast-pathed — the `log.chunk` / `heartbeat` manual-validator invariant is
+ * untouched by this message.
+ */
+export declare const stepApprovalRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"step.approval-request">;
+    messageId: z.ZodString;
+    runId: z.ZodString;
+    jobId: z.ZodString;
+    stepIndex: z.ZodNumber;
+    stepName: z.ZodString;
+    clauses: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        team: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        user: z.ZodString;
+    }, z.core.$strict>]>>;
+    reason: z.ZodString;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type StepApprovalRequest = z.infer<typeof stepApprovalRequestSchema>;
+/**
+ * Orchestrator -> Agent: resolution of a step-level approval hold. `requestId`
+ * correlates to the originating `step.approval-request.messageId`. On
+ * `approved` the agent runs the step with its live workspace intact; on
+ * `rejected`/`expired` it fails the job with a clear reason.
+ */
+export declare const stepApprovalResolvedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"step.approval-resolved">;
+    requestId: z.ZodString;
+    runId: z.ZodString;
+    jobId: z.ZodString;
+    stepIndex: z.ZodNumber;
+    outcome: z.ZodEnum<{
+        rejected: "rejected";
+        approved: "approved";
+        expired: "expired";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StepApprovalResolved = z.infer<typeof stepApprovalResolvedSchema>;
 /** All messages that flow from Orchestrator to Agent. */
 export declare const orchestratorToAgentMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"job.dispatch">;
@@ -526,6 +623,10 @@ export declare const orchestratorToAgentMessageSchema: z.ZodDiscriminatedUnion<[
     requestId: z.ZodString;
     uploadUrl: z.ZodOptional<z.ZodString>;
     skip: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"provenance.upload.response">;
+    requestId: z.ZodString;
+    uploadUrl: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"event.emit.response">;
     requestId: z.ZodString;
@@ -542,6 +643,23 @@ export declare const orchestratorToAgentMessageSchema: z.ZodDiscriminatedUnion<[
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"auth.failure">;
     reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"fleet.logs.request">;
+    requestId: z.ZodString;
+    logWindowHours: z.ZodNumber;
+    maxBytes: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"step.approval-resolved">;
+    requestId: z.ZodString;
+    runId: z.ZodString;
+    jobId: z.ZodString;
+    stepIndex: z.ZodNumber;
+    outcome: z.ZodEnum<{
+        rejected: "rejected";
+        approved: "approved";
+        expired: "expired";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">;
 /** All messages that flow from Agent to Orchestrator. */
 export declare const agentToOrchestratorMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -712,6 +830,18 @@ export declare const agentToOrchestratorMessageSchema: z.ZodDiscriminatedUnion<[
     key: z.ZodString;
     tarHash: z.ZodString;
     sizeBytes: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"provenance.upload.request">;
+    messageId: z.ZodString;
+    jobId: z.ZodString;
+    subjectDigest: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"provenance.upload.complete">;
+    messageId: z.ZodString;
+    jobId: z.ZodString;
+    subjectName: z.ZodString;
+    subjectDigest: z.ZodString;
+    mediaType: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"event.emit">;
     jobId: z.ZodString;
@@ -752,6 +882,30 @@ export declare const agentToOrchestratorMessageSchema: z.ZodDiscriminatedUnion<[
     type: z.ZodLiteral<"auth.request">;
     token: z.ZodString;
     protocolVersion: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"fleet.bundle.chunk">;
+    requestId: z.ZodString;
+    seq: z.ZodNumber;
+    isLast: z.ZodBoolean;
+    dataB64: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"fleet.bundle.error">;
+    requestId: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"step.approval-request">;
+    messageId: z.ZodString;
+    runId: z.ZodString;
+    jobId: z.ZodString;
+    stepIndex: z.ZodNumber;
+    stepName: z.ZodString;
+    clauses: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        team: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        user: z.ZodString;
+    }, z.core.$strict>]>>;
+    reason: z.ZodString;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>], "type">;
 export type JobDispatch = z.infer<typeof jobDispatchSchema>;
 export type JobCancel = z.infer<typeof jobCancelSchema>;
@@ -766,5 +920,12 @@ export type CacheUserRestoreResponse = z.infer<typeof cacheUserRestoreResponseSc
 export type CacheUserSaveRequest = z.infer<typeof cacheUserSaveRequestSchema>;
 export type CacheUserSaveResponse = z.infer<typeof cacheUserSaveResponseSchema>;
 export type CacheUserSaveComplete = z.infer<typeof cacheUserSaveCompleteSchema>;
+export type ProvenanceUploadRequest = z.infer<typeof provenanceUploadRequestSchema>;
+export type ProvenanceUploadResponse = z.infer<typeof provenanceUploadResponseSchema>;
+export type ProvenanceUploadComplete = z.infer<typeof provenanceUploadCompleteSchema>;
+export type FleetLogsRequest = z.infer<typeof fleetLogsRequestSchema>;
+export type FleetBundleChunk = z.infer<typeof fleetBundleChunkSchema>;
+export type FleetBundleError = z.infer<typeof fleetBundleErrorSchema>;
+export type OrchestratorToAgentMessage = z.infer<typeof orchestratorToAgentMessageSchema>;
 export type AgentToOrchestratorMessage = z.infer<typeof agentToOrchestratorMessageSchema>;
 //# sourceMappingURL=orchestrator-agent.d.ts.map

package/dist/protocol/messages/orchestrator-agent.js

@@ -1,5 +1,6 @@
-import "../../chunk-gOLHoazu.js";
+import "../../chunk-BTugEXQM.js";
 import { ExecutionJobStatus, ExecutionStepStatus } from "./execution-status.js";
+import { approverClauseSchema } from "../../approval/types.js";
 import { z } from "zod";
 //#region src/protocol/messages/orchestrator-agent.ts
 /**
@@ -470,6 +471,34 @@ const cacheUserSaveCompleteSchema = z.object({
 	/** Tarball size in bytes (drives quota accounting). */
 	sizeBytes: z.number().int().nonnegative()
 });
+/** Agent -> Orchestrator: request a presigned PUT URL for a provenance bundle. */
+const provenanceUploadRequestSchema = z.object({
+	type: z.literal("provenance.upload.request"),
+	messageId: z.string(),
+	/** Job producing the attestation (ownership-checked; runId resolved server-side). */
+	jobId: z.string(),
+	/** Primary subject digest (lowercase hex) — the storage-key discriminator. */
+	subjectDigest: z.string()
+});
+/** Orchestrator -> Agent: presigned PUT URL for the provenance bundle. */
+const provenanceUploadResponseSchema = z.object({
+	type: z.literal("provenance.upload.response"),
+	requestId: z.string(),
+	/** Presigned PUT URL, or '' when storage is unavailable. */
+	uploadUrl: z.string()
+});
+/** Agent -> Orchestrator: confirm a provenance bundle upload (records an attestations row). */
+const provenanceUploadCompleteSchema = z.object({
+	type: z.literal("provenance.upload.complete"),
+	messageId: z.string(),
+	jobId: z.string(),
+	/** Caller-supplied artifact name. */
+	subjectName: z.string(),
+	/** Primary subject digest (lowercase hex). */
+	subjectDigest: z.string(),
+	/** Bundle media type. */
+	mediaType: z.string()
+});
 /** Agent -> Orchestrator: emit a custom event from a running workflow step. */
 const eventEmitSchema = z.object({
 	type: z.literal("event.emit"),
@@ -554,6 +583,82 @@ const agentApiResponseSchema = z.object({
 	/** Error description (present on failure). */
 	error: z.string().optional()
 });
+/** Orchestrator asks an agent for its log/diagnostic mini-bundle. */
+const fleetLogsRequestSchema = z.object({
+	type: z.literal("fleet.logs.request"),
+	/** UUID correlating the chunked response. */
+	requestId: z.string(),
+	/** Hours of log history to include. */
+	logWindowHours: z.number(),
+	/** Per-node cap on raw log bytes. */
+	maxBytes: z.number()
+});
+/** One base64 frame of an agent's mini-bundle ZIP. */
+const fleetBundleChunkSchema = z.object({
+	type: z.literal("fleet.bundle.chunk"),
+	requestId: z.string(),
+	seq: z.number().int().nonnegative(),
+	isLast: z.boolean(),
+	dataB64: z.string()
+});
+/** Agent failed to build/stream its mini-bundle. */
+const fleetBundleErrorSchema = z.object({
+	type: z.literal("fleet.bundle.error"),
+	requestId: z.string(),
+	message: z.string()
+});
+/** Outcome of a step-level approval hold, sent back to the waiting agent. */
+const StepApprovalOutcome = z.enum([
+	"approved",
+	"rejected",
+	"expired"
+]);
+/**
+* Agent -> Orchestrator: a step carrying `requireApproval` is about to run and
+* the agent is blocking its step loop until the orchestrator resolves the
+* approval. The orchestrator creates a step-scoped `held_runs` row from the
+* normalized requirement and replies with `step.approval-resolved` once the
+* hold is approved, rejected, or expired. The agent keeps heartbeats flowing
+* during the wait so it is not reaped as stale.
+*
+* NOT fast-pathed — the `log.chunk` / `heartbeat` manual-validator invariant is
+* untouched by this message.
+*/
+const stepApprovalRequestSchema = z.object({
+	type: z.literal("step.approval-request"),
+	messageId: z.string(),
+	runId: z.string(),
+	jobId: z.string(),
+	stepIndex: z.number().int().nonnegative(),
+	stepName: z.string(),
+	/** AND-list of approver clauses (empty = any approval-capable member). */
+	clauses: z.array(approverClauseSchema),
+	/** Human label for the gate (from the SDK `requireApproval` reason). */
+	reason: z.string(),
+	/**
+	* Per-gate timeout override (seconds) from the SDK `requireApproval.timeout`.
+	* Absent ⇒ the orchestrator uses the org-default `approval_expiry_seconds`.
+	* The orchestrator owns the authoritative `expiresAt` computation.
+	*/
+	timeoutSeconds: z.number().int().positive().optional()
+});
+/**
+* Orchestrator -> Agent: resolution of a step-level approval hold. `requestId`
+* correlates to the originating `step.approval-request.messageId`. On
+* `approved` the agent runs the step with its live workspace intact; on
+* `rejected`/`expired` it fails the job with a clear reason.
+*/
+const stepApprovalResolvedSchema = z.object({
+	type: z.literal("step.approval-resolved"),
+	/** Correlates to the originating step.approval-request messageId. */
+	requestId: z.string(),
+	runId: z.string(),
+	jobId: z.string(),
+	stepIndex: z.number().int().nonnegative(),
+	outcome: StepApprovalOutcome,
+	/** Optional human reason (e.g. the reject reason). */
+	reason: z.string().optional()
+});
 /** All messages that flow from Orchestrator to Agent. */
 const orchestratorToAgentMessageSchema = z.discriminatedUnion("type", [
 	jobDispatchSchema,
@@ -563,10 +668,13 @@ const orchestratorToAgentMessageSchema = z.discriminatedUnion("type", [
 	cacheUploadResponseSchema,
 	cacheUserRestoreResponseSchema,
 	cacheUserSaveResponseSchema,
+	provenanceUploadResponseSchema,
 	eventEmitResponseSchema,
 	agentApiResponseSchema,
 	agentAuthSuccessSchema,
-	agentAuthFailureSchema
+	agentAuthFailureSchema,
+	fleetLogsRequestSchema,
+	stepApprovalResolvedSchema
 ]);
 /** All messages that flow from Agent to Orchestrator. */
 const agentToOrchestratorMessageSchema = z.discriminatedUnion("type", [
@@ -586,12 +694,17 @@ const agentToOrchestratorMessageSchema = z.discriminatedUnion("type", [
 	cacheUserRestoreRequestSchema,
 	cacheUserSaveRequestSchema,
 	cacheUserSaveCompleteSchema,
+	provenanceUploadRequestSchema,
+	provenanceUploadCompleteSchema,
 	eventEmitSchema,
 	agentApiRequestSchema,
 	agentMetricsSchema,
-	agentAuthRequestSchema
+	agentAuthRequestSchema,
+	fleetBundleChunkSchema,
+	fleetBundleErrorSchema,
+	stepApprovalRequestSchema
 ]);
 //#endregion
-export { CacheRefScope, JobRejectReason, agentApiRequestSchema, agentApiResponseSchema, agentAuthFailureSchema, agentAuthRequestSchema, agentAuthSuccessSchema, agentLogChunkSchema, agentMetricsSchema, agentRegisterSchema, agentStatusSchema, agentStepStatusSchema, agentToOrchestratorMessageSchema, cacheUserRestoreRequestSchema, cacheUserRestoreResponseSchema, cacheUserSaveCompleteSchema, cacheUserSaveRequestSchema, cacheUserSaveResponseSchema, configAckSchema, eventEmitResponseSchema, eventEmitSchema, gitAuthSchema, jobAckSchema, jobCancelSchema, jobConcurrencyAckSchema, jobConcurrencyReportSchema, jobDispatchSchema, jobRejectSchema, jobStatusSchema, orchestratorToAgentMessageSchema, registerAckSchema };
+export { CacheRefScope, JobRejectReason, StepApprovalOutcome, agentApiRequestSchema, agentApiResponseSchema, agentAuthFailureSchema, agentAuthRequestSchema, agentAuthSuccessSchema, agentLogChunkSchema, agentMetricsSchema, agentRegisterSchema, agentStatusSchema, agentStepStatusSchema, agentToOrchestratorMessageSchema, cacheUserRestoreRequestSchema, cacheUserRestoreResponseSchema, cacheUserSaveCompleteSchema, cacheUserSaveRequestSchema, cacheUserSaveResponseSchema, configAckSchema, eventEmitResponseSchema, eventEmitSchema, fleetBundleChunkSchema, fleetBundleErrorSchema, fleetLogsRequestSchema, gitAuthSchema, jobAckSchema, jobCancelSchema, jobConcurrencyAckSchema, jobConcurrencyReportSchema, jobDispatchSchema, jobRejectSchema, jobStatusSchema, orchestratorToAgentMessageSchema, provenanceUploadCompleteSchema, provenanceUploadRequestSchema, provenanceUploadResponseSchema, registerAckSchema, stepApprovalRequestSchema, stepApprovalResolvedSchema };
 
 //# sourceMappingURL=orchestrator-agent.js.map

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

@@ -302,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">;
@@ -568,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;
@@ -816,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;
@@ -856,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

@@ -1,4 +1,4 @@
-import "../../chunk-gOLHoazu.js";
+import "../../chunk-BTugEXQM.js";
 import { ExecutionJobStatus } from "./execution-status.js";
 import { ScalerEventType } from "./scaler-event.js";
 import { z } from "zod";
@@ -316,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"),
@@ -377,6 +406,9 @@ const peerToPeerMessageSchema = z.discriminatedUnion("type", [
 	peerCacheUploadResponseSchema,
 	peerConfigReloadSchema,
 	peerConfigReloadResponseSchema,
+	peerLogsCollectRequestSchema,
+	peerLogsCollectChunkSchema,
+	peerLogsCollectErrorSchema,
 	peerLeavingSchema,
 	peerAgentTokenRevokeSchema,
 	peerScalerEventSchema
@@ -400,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