@inf-monkeys-tech/monkeys 1.0.20 → 1.0.21

package/lib/esm/index.mjs

@@ -6819,11 +6819,70 @@ var AgentSessionStatusSchema = z3.enum([
   "completed",
   "failed"
 ]);
+var AgentSessionTerminalStatusSchema = z3.enum(["stopped", "completed", "failed"]);
+var AgentSessionRunSchema = z3.object({
+  runId: ContractIdentifierSchema,
+  sessionId: ContractIdentifierSchema,
+  sourceMessageId: ContractIdentifierSchema,
+  status: AgentSessionStatusSchema,
+  startedAt: IsoDateTimeSchema,
+  stoppingRequestedAt: IsoDateTimeSchema.optional(),
+  stoppedAt: IsoDateTimeSchema.optional(),
+  completedAt: IsoDateTimeSchema.optional(),
+  failedAt: IsoDateTimeSchema.optional(),
+  durationMs: z3.number().nonnegative().optional()
+}).strict().superRefine((value, context) => {
+  const terminalTimestamps = [value.stoppedAt, value.completedAt, value.failedAt].filter(Boolean);
+  if (terminalTimestamps.length > 1) {
+    context.addIssue({
+      code: "custom",
+      path: ["status"],
+      message: "A run may declare only one terminal timestamp."
+    });
+  }
+  const expectedTimestamp = value.status === "stopped" ? value.stoppedAt : value.status === "completed" ? value.completedAt : value.status === "failed" ? value.failedAt : void 0;
+  if (AgentSessionTerminalStatusSchema.safeParse(value.status).success && !expectedTimestamp) {
+    context.addIssue({
+      code: "custom",
+      path: [value.status === "stopped" ? "stoppedAt" : value.status === "completed" ? "completedAt" : "failedAt"],
+      message: `Run status ${value.status} requires its matching terminal timestamp.`
+    });
+  }
+  if (!AgentSessionTerminalStatusSchema.safeParse(value.status).success && terminalTimestamps.length > 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["status"],
+      message: "A non-terminal run must not declare a terminal timestamp."
+    });
+  }
+  if ((value.status === "stopping" || value.status === "stopped") && !value.stoppingRequestedAt) {
+    context.addIssue({
+      code: "custom",
+      path: ["stoppingRequestedAt"],
+      message: `Run status ${value.status} requires stoppingRequestedAt.`
+    });
+  }
+  if (!isAgentSessionTerminalStatus(value.status) && value.durationMs !== void 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["durationMs"],
+      message: "Only a terminal run may declare durationMs."
+    });
+  }
+  if (isAgentSessionTerminalStatus(value.status) && value.durationMs === void 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["durationMs"],
+      message: `Terminal run status ${value.status} requires durationMs.`
+    });
+  }
+});
 var AgentSessionCommandTypeSchema = z3.enum(["stop", "resume", "retry", "approval"]);
 var AgentSessionCommandHeaderSchema = z3.object({
   contract: z3.literal("AgentSessionCommand"),
   commandId: ContractIdentifierSchema,
   sessionId: ContractIdentifierSchema,
+  runId: ContractIdentifierSchema.optional(),
   idempotencyKey: ContractIdentifierSchema,
   expectedSequence: z3.number().int().min(-1),
   issuedAt: IsoDateTimeSchema
@@ -6848,8 +6907,14 @@ var AgentSessionCommandSchema = z3.discriminatedUnion("commandType", [
     reason: z3.string().trim().min(1).optional()
   })
 ]);
+var AgentSessionTargetedCommandSchema = AgentSessionCommandSchema.and(
+  z3.object({ runId: ContractIdentifierSchema })
+);
 var AgentSessionCommandErrorCodeSchema = z3.enum([
   "SESSION_NOT_FOUND",
+  "RUN_NOT_FOUND",
+  "RUN_ALREADY_FINISHED",
+  "STOP_TIMEOUT",
   "COMMAND_NOT_SUPPORTED",
   "CAPABILITY_UNAVAILABLE",
   "SEQUENCE_CONFLICT",
@@ -6864,11 +6929,13 @@ var AgentSessionCommandResultSchema = z3.object({
   contract: z3.literal("AgentSessionCommandResult"),
   commandId: ContractIdentifierSchema,
   sessionId: ContractIdentifierSchema,
+  runId: ContractIdentifierSchema.optional(),
   idempotencyKey: ContractIdentifierSchema,
   outcome: z3.enum(["accepted", "duplicate", "rejected", "failed"]),
   sessionStatus: AgentSessionStatusSchema,
   acceptedSequence: z3.number().int().nonnegative().optional(),
   resultEventIds: z3.array(ContractIdentifierSchema).default([]),
+  termination: z3.enum(["requested", "confirmed"]).optional(),
   error: z3.object({
     code: AgentSessionCommandErrorCodeSchema,
     message: z3.string(),
@@ -6884,6 +6951,20 @@ var AgentSessionCommandResultSchema = z3.object({
       message: requiresError ? "Rejected and failed command results require an error." : "Accepted and duplicate command results must not contain an error."
     });
   }
+  if (value.termination === "requested" && value.sessionStatus !== "stopping") {
+    context.addIssue({
+      code: "custom",
+      path: ["termination"],
+      message: "A requested termination must leave the run in stopping status."
+    });
+  }
+  if (value.termination === "confirmed" && !isAgentSessionTerminalStatus(value.sessionStatus)) {
+    context.addIssue({
+      code: "custom",
+      path: ["termination"],
+      message: "A confirmed termination requires a terminal run status."
+    });
+  }
 });
 var AGENT_SESSION_COMMAND_TRANSITIONS = {
   stop: { queued: "stopping", running: "stopping", waiting_approval: "stopping" },
@@ -6894,10 +6975,28 @@ var AGENT_SESSION_COMMAND_TRANSITIONS = {
 function resolveAgentSessionCommandTransition(status, commandType) {
   return AGENT_SESSION_COMMAND_TRANSITIONS[commandType][status];
 }
+function isAgentSessionTerminalStatus(status) {
+  return AgentSessionTerminalStatusSchema.safeParse(status).success;
+}
+function canApplyAgentSessionRunStatus(current, next) {
+  if (current === next) return true;
+  const transitions = {
+    queued: ["running", "stopping", "failed"],
+    running: ["waiting_approval", "stopping", "completed", "failed"],
+    waiting_approval: ["running", "stopping", "failed"],
+    stopping: ["stopped", "completed", "failed"],
+    stopped: [],
+    completed: [],
+    failed: []
+  };
+  return transitions[current].includes(next);
+}
 var AgentSessionEventHeaderSchema = z3.object({
   contract: z3.literal("AgentSessionEvent"),
   eventId: ContractIdentifierSchema,
   sessionId: ContractIdentifierSchema,
+  runId: ContractIdentifierSchema.optional(),
+  sourceMessageId: ContractIdentifierSchema.optional(),
   sequence: z3.number().int().nonnegative(),
   idempotencyKey: ContractIdentifierSchema,
   occurredAt: IsoDateTimeSchema
@@ -6957,7 +7056,13 @@ var AgentSessionEventSchema = z3.discriminatedUnion("eventType", [
   }),
   sessionEvent("status", {
     status: AgentSessionStatusSchema,
-    detail: z3.string().optional()
+    detail: z3.string().optional(),
+    startedAt: IsoDateTimeSchema.optional(),
+    stoppingRequestedAt: IsoDateTimeSchema.optional(),
+    stoppedAt: IsoDateTimeSchema.optional(),
+    completedAt: IsoDateTimeSchema.optional(),
+    failedAt: IsoDateTimeSchema.optional(),
+    durationMs: z3.number().nonnegative().optional()
   }),
   sessionEvent("artifact", {
     artifactId: ContractIdentifierSchema,
@@ -7013,6 +7118,34 @@ var AgentSessionEventSchema = z3.discriminatedUnion("eventType", [
     output: z3.string().optional()
   })
 ]);
+var AgentSessionRunEventSchema = AgentSessionEventSchema.superRefine((value, context) => {
+  if (!value.runId) {
+    context.addIssue({ code: "custom", path: ["runId"], message: "Run events require runId." });
+  }
+  if (!value.sourceMessageId) {
+    context.addIssue({
+      code: "custom",
+      path: ["sourceMessageId"],
+      message: "Run events require sourceMessageId."
+    });
+  }
+  if (value.eventType !== "status") return;
+  const requiredTimeField = value.payload.status === "running" ? "startedAt" : value.payload.status === "stopping" ? "stoppingRequestedAt" : value.payload.status === "stopped" ? "stoppedAt" : value.payload.status === "completed" ? "completedAt" : value.payload.status === "failed" ? "failedAt" : void 0;
+  if (requiredTimeField && !value.payload[requiredTimeField]) {
+    context.addIssue({
+      code: "custom",
+      path: ["payload", requiredTimeField],
+      message: `Run status ${value.payload.status} requires ${requiredTimeField}.`
+    });
+  }
+  if (isAgentSessionTerminalStatus(value.payload.status) && value.payload.durationMs === void 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["payload", "durationMs"],
+      message: `Terminal run status ${value.payload.status} requires durationMs.`
+    });
+  }
+});
 var AgentSessionViewModelSchema = z3.object({
   contract: z3.literal("AgentSessionViewModel"),
   sessionId: ContractIdentifierSchema,
@@ -11732,8 +11865,11 @@ var WorkflowCompletionReceiptSchema = z15.object({
 // src/schemas/index.ts
 var canonicalContractSchemas = {
   "agent-session-command": AgentSessionCommandSchema,
+  "agent-session-targeted-command": AgentSessionTargetedCommandSchema,
   "agent-session-command-result": AgentSessionCommandResultSchema,
   "agent-session-event": AgentSessionEventSchema,
+  "agent-session-run-event": AgentSessionRunEventSchema,
+  "agent-session-run": AgentSessionRunSchema,
   "agent-session-view-model": AgentSessionViewModelSchema,
   "agent-runtime-event": AgentRuntimeEventSchema,
   "application-run": ApplicationRunSchema,
@@ -13040,8 +13176,12 @@ export {
   AgentSessionCommandSchema,
   AgentSessionCommandTypeSchema,
   AgentSessionEventSchema,
+  AgentSessionRunEventSchema,
+  AgentSessionRunSchema,
   AgentSessionSnapshotSchema,
   AgentSessionStatusSchema,
+  AgentSessionTargetedCommandSchema,
+  AgentSessionTerminalStatusSchema,
   AgentSessionViewModelSchema,
   ApplicationHandoffEndpointSchema,
   ApplicationHandoffSchema,
@@ -13186,6 +13326,7 @@ export {
   assertThemeTokensDocumentStructure,
   buildApplicationHandoffUrl,
   buildChangeImpactGraph,
+  canApplyAgentSessionRunStatus,
   canonicalContractSchemas,
   compileCapabilityRegistry,
   compileConductorWorkflowDefinition,
@@ -13210,6 +13351,7 @@ export {
   getAgentModeCapabilities,
   getAgentSessionRuntimeCapabilities,
   isAgentResourceModeCompatible,
+  isAgentSessionTerminalStatus,
   mergeThemeTokenDocuments,
   normalizeAgentExecutionMode,
   normalizeAgentMode,