@inf-monkeys-tech/monkeys 1.0.20 → 1.0.22

package/lib/esm/contracts/index.mjs

@@ -6712,7 +6712,11 @@ var AgentSessionCapabilitySchema = z3.enum([
   "diff",
   "workspaceFiles",
   "terminal",
-  "testResults"
+  "testResults",
+  "threadForking",
+  "editAndRerun",
+  "steering",
+  "summary"
 ]);
 var AgentSessionCapabilitiesSchema = z3.object({
   text: z3.boolean().default(true),
@@ -6731,7 +6735,11 @@ var AgentSessionCapabilitiesSchema = z3.object({
   diff: z3.boolean().default(false),
   workspaceFiles: z3.boolean().default(false),
   terminal: z3.boolean().default(false),
-  testResults: z3.boolean().default(false)
+  testResults: z3.boolean().default(false),
+  threadForking: z3.boolean().default(false),
+  editAndRerun: z3.boolean().default(false),
+  steering: z3.boolean().default(false),
+  summary: z3.boolean().default(false)
 }).strict();
 var AGENT_SESSION_RUNTIME_CAPABILITIES = Object.freeze({
   chatbot: AgentSessionCapabilitiesSchema.parse({ text: true, tools: true, mcp: true, skills: true, approval: true, usage: true }),
@@ -6757,7 +6765,11 @@ var AGENT_SESSION_CAPABILITY_EVIDENCE = Object.freeze({
   diff: { eventTypes: ["diff"], commandTypes: [] },
   workspaceFiles: { eventTypes: ["workspace-file"], commandTypes: [] },
   terminal: { eventTypes: ["terminal"], commandTypes: [] },
-  testResults: { eventTypes: ["test-result"], commandTypes: [] }
+  testResults: { eventTypes: ["test-result"], commandTypes: [] },
+  threadForking: { eventTypes: [], commandTypes: ["fork"] },
+  editAndRerun: { eventTypes: [], commandTypes: ["edit-and-rerun"] },
+  steering: { eventTypes: [], commandTypes: ["steer"] },
+  summary: { eventTypes: ["summary"], commandTypes: [] }
 });
 function findUnsupportedAgentSessionCapabilities(capabilities, evidence) {
   const eventTypes = new Set(evidence.eventTypes || []);
@@ -6782,11 +6794,98 @@ var AgentSessionStatusSchema = z3.enum([
   "completed",
   "failed"
 ]);
-var AgentSessionCommandTypeSchema = z3.enum(["stop", "resume", "retry", "approval"]);
+var AgentSessionTerminalStatusSchema = z3.enum(["stopped", "completed", "failed"]);
+var AgentSessionLineageSchema = z3.object({
+  forkedFromThreadId: ContractIdentifierSchema,
+  forkedFromMessageId: ContractIdentifierSchema,
+  sourceRunId: ContractIdentifierSchema
+}).strict();
+var AgentSessionContextInheritanceSchema = z3.object({
+  messages: z3.enum(["through-source-message", "exclude"]),
+  attachments: z3.enum(["inherit", "exclude"]),
+  summaries: z3.enum(["inherit", "exclude"]),
+  toolResults: z3.enum(["inherit", "exclude"]),
+  codeChanges: z3.enum(["inherit", "exclude"])
+}).strict();
+var AgentSessionActiveBranchSchema = z3.object({
+  branchId: ContractIdentifierSchema,
+  threadId: ContractIdentifierSchema,
+  sourceMessageId: ContractIdentifierSchema,
+  runId: ContractIdentifierSchema,
+  lineage: AgentSessionLineageSchema.optional(),
+  createdAt: IsoDateTimeSchema
+}).strict();
+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",
+  "fork",
+  "edit-and-rerun",
+  "steer"
+]);
 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
@@ -6809,10 +6908,41 @@ var AgentSessionCommandSchema = z3.discriminatedUnion("commandType", [
     approvalId: ContractIdentifierSchema,
     decision: z3.enum(["approved", "rejected"]),
     reason: z3.string().trim().min(1).optional()
+  }),
+  sessionCommand("fork", {
+    sourceThreadId: ContractIdentifierSchema,
+    sourceMessageId: ContractIdentifierSchema,
+    sourceRunId: ContractIdentifierSchema,
+    inheritance: AgentSessionContextInheritanceSchema
+  }),
+  sessionCommand("edit-and-rerun", {
+    sourceThreadId: ContractIdentifierSchema,
+    sourceMessageId: ContractIdentifierSchema,
+    sourceRunId: ContractIdentifierSchema,
+    replacementParts: z3.array(JsonValueSchema).min(1),
+    inheritance: AgentSessionContextInheritanceSchema
+  }),
+  sessionCommand("steer", {
+    targetRunId: ContractIdentifierSchema,
+    guidanceParts: z3.array(JsonValueSchema).min(1)
   })
-]);
+]).superRefine((value, context) => {
+  if (value.commandType === "steer" && value.runId !== value.payload.targetRunId) {
+    context.addIssue({
+      code: "custom",
+      path: ["payload", "targetRunId"],
+      message: "Steering targetRunId must match the command runId."
+    });
+  }
+});
+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",
@@ -6821,17 +6951,28 @@ var AgentSessionCommandErrorCodeSchema = z3.enum([
   "TARGET_EVENT_NOT_RETRYABLE",
   "APPROVAL_NOT_FOUND",
   "APPROVAL_ALREADY_RESOLVED",
+  "SOURCE_THREAD_NOT_FOUND",
+  "SOURCE_MESSAGE_NOT_FOUND",
+  "SOURCE_RUN_NOT_FOUND",
+  "SOURCE_LINEAGE_INVALID",
+  "ACTIVE_BRANCH_NOT_FOUND",
   "COMMAND_EXECUTION_FAILED"
 ]);
 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([]),
+  operation: z3.object({
+    lineage: AgentSessionLineageSchema,
+    activeBranch: AgentSessionActiveBranchSchema
+  }).strict().optional(),
+  termination: z3.enum(["requested", "confirmed"]).optional(),
   error: z3.object({
     code: AgentSessionCommandErrorCodeSchema,
     message: z3.string(),
@@ -6847,20 +6988,152 @@ 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."
+    });
+  }
+  if (value.operation && !value.operation.activeBranch.lineage) {
+    context.addIssue({
+      code: "custom",
+      path: ["operation", "activeBranch", "lineage"],
+      message: "A branch operation result requires lineage on its active branch."
+    });
+  }
+  const operation = value.operation;
+  if (operation?.activeBranch.lineage) {
+    const { lineage } = operation;
+    const branchLineage = operation.activeBranch.lineage;
+    if (lineage.forkedFromThreadId !== branchLineage.forkedFromThreadId || lineage.forkedFromMessageId !== branchLineage.forkedFromMessageId || lineage.sourceRunId !== branchLineage.sourceRunId) {
+      context.addIssue({
+        code: "custom",
+        path: ["operation", "activeBranch", "lineage"],
+        message: "Active branch lineage must match the operation lineage."
+      });
+    }
+  }
+  if (value.operation && value.runId !== value.operation.activeBranch.runId) {
+    context.addIssue({
+      code: "custom",
+      path: ["operation", "activeBranch", "runId"],
+      message: "Active branch runId must match the command result runId."
+    });
+  }
 });
 var AGENT_SESSION_COMMAND_TRANSITIONS = {
   stop: { queued: "stopping", running: "stopping", waiting_approval: "stopping" },
   resume: { stopped: "queued", completed: "queued", failed: "queued" },
   retry: { failed: "queued" },
-  approval: { waiting_approval: "running" }
+  approval: { waiting_approval: "running" },
+  fork: {},
+  "edit-and-rerun": {},
+  steer: {}
 };
+var AgentSessionCommandPolicySchema = z3.object({
+  capability: AgentSessionCapabilitySchema.optional(),
+  allowedStatuses: z3.array(AgentSessionStatusSchema).min(1),
+  requiresRunId: z3.boolean(),
+  sourceSessionEffect: z3.enum(["transition", "preserve"]),
+  idempotencyScope: z3.literal("session-command"),
+  sequenceRule: z3.literal("match-current")
+}).strict();
+var sessionCommandPolicy = (policy) => AgentSessionCommandPolicySchema.parse(policy);
+var AGENT_SESSION_COMMAND_POLICIES = Object.freeze({
+  stop: sessionCommandPolicy({
+    allowedStatuses: ["queued", "running", "waiting_approval"],
+    requiresRunId: true,
+    sourceSessionEffect: "transition",
+    idempotencyScope: "session-command",
+    sequenceRule: "match-current"
+  }),
+  resume: sessionCommandPolicy({
+    capability: "resume",
+    allowedStatuses: ["stopped", "completed", "failed"],
+    requiresRunId: true,
+    sourceSessionEffect: "transition",
+    idempotencyScope: "session-command",
+    sequenceRule: "match-current"
+  }),
+  retry: sessionCommandPolicy({
+    allowedStatuses: ["failed"],
+    requiresRunId: true,
+    sourceSessionEffect: "transition",
+    idempotencyScope: "session-command",
+    sequenceRule: "match-current"
+  }),
+  approval: sessionCommandPolicy({
+    capability: "approval",
+    allowedStatuses: ["waiting_approval"],
+    requiresRunId: true,
+    sourceSessionEffect: "transition",
+    idempotencyScope: "session-command",
+    sequenceRule: "match-current"
+  }),
+  fork: sessionCommandPolicy({
+    capability: "threadForking",
+    allowedStatuses: AgentSessionStatusSchema.options,
+    requiresRunId: false,
+    sourceSessionEffect: "preserve",
+    idempotencyScope: "session-command",
+    sequenceRule: "match-current"
+  }),
+  "edit-and-rerun": sessionCommandPolicy({
+    capability: "editAndRerun",
+    allowedStatuses: ["stopped", "completed", "failed"],
+    requiresRunId: false,
+    sourceSessionEffect: "preserve",
+    idempotencyScope: "session-command",
+    sequenceRule: "match-current"
+  }),
+  steer: sessionCommandPolicy({
+    capability: "steering",
+    allowedStatuses: ["queued", "running"],
+    requiresRunId: true,
+    sourceSessionEffect: "preserve",
+    idempotencyScope: "session-command",
+    sequenceRule: "match-current"
+  })
+});
+function getAgentSessionCommandPolicy(commandType) {
+  return AGENT_SESSION_COMMAND_POLICIES[commandType];
+}
+function canIssueAgentSessionCommand(status, commandType) {
+  return getAgentSessionCommandPolicy(commandType).allowedStatuses.includes(status);
+}
 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
@@ -6920,7 +7193,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,
@@ -6974,8 +7253,52 @@ var AgentSessionEventSchema = z3.discriminatedUnion("eventType", [
     status: z3.enum(["running", "passed", "failed", "skipped"]),
     durationMs: z3.number().nonnegative().optional(),
     output: z3.string().optional()
+  }),
+  sessionEvent("summary", {
+    summaryId: ContractIdentifierSchema,
+    runId: ContractIdentifierSchema,
+    text: z3.string(),
+    highlights: z3.array(z3.string()),
+    pendingItems: z3.array(z3.string()),
+    status: z3.enum(["generating", "completed", "failed"])
   })
-]);
+]).superRefine((value, context) => {
+  if (value.eventType === "summary" && value.runId !== value.payload.runId) {
+    context.addIssue({
+      code: "custom",
+      path: ["payload", "runId"],
+      message: "Summary payload runId must match the event runId."
+    });
+  }
+});
+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,
@@ -6983,7 +7306,9 @@ var AgentSessionViewModelSchema = z3.object({
   status: AgentSessionStatusSchema,
   events: z3.array(AgentSessionEventSchema),
   lastSequence: z3.number().int().min(-1),
-  resumable: z3.boolean().default(false)
+  resumable: z3.boolean().default(false),
+  lineage: AgentSessionLineageSchema.optional(),
+  activeBranch: AgentSessionActiveBranchSchema.optional()
 }).strict().superRefine((value, context) => {
   const eventIds = /* @__PURE__ */ new Set();
   const idempotencyKeys = /* @__PURE__ */ new Set();
@@ -11661,6 +11986,7 @@ var WorkflowCompletionReceiptSchema = z15.object({
 export {
   AGENT_MODE_CAPABILITIES,
   AGENT_SESSION_CAPABILITY_EVIDENCE,
+  AGENT_SESSION_COMMAND_POLICIES,
   AGENT_SESSION_RUNTIME_CAPABILITIES,
   ActorRefSchema,
   AgentConfigurationCapabilitySchema,
@@ -11669,15 +11995,23 @@ export {
   AgentModeSchema,
   AgentResourceModeSupportSchema,
   AgentRuntimeEventSchema,
+  AgentSessionActiveBranchSchema,
   AgentSessionCapabilitiesSchema,
   AgentSessionCapabilitySchema,
   AgentSessionCommandErrorCodeSchema,
+  AgentSessionCommandPolicySchema,
   AgentSessionCommandResultSchema,
   AgentSessionCommandSchema,
   AgentSessionCommandTypeSchema,
+  AgentSessionContextInheritanceSchema,
   AgentSessionEventSchema,
+  AgentSessionLineageSchema,
+  AgentSessionRunEventSchema,
+  AgentSessionRunSchema,
   AgentSessionSnapshotSchema,
   AgentSessionStatusSchema,
+  AgentSessionTargetedCommandSchema,
+  AgentSessionTerminalStatusSchema,
   AgentSessionViewModelSchema,
   ApplicationHandoffEndpointSchema,
   ApplicationHandoffSchema,
@@ -11809,10 +12143,14 @@ export {
   WorkflowTriggerSchema,
   WorkflowValidationIssueSchema,
   agentModeHasCapability,
+  canApplyAgentSessionRunStatus,
+  canIssueAgentSessionCommand,
   findUnsupportedAgentSessionCapabilities,
   getAgentModeCapabilities,
+  getAgentSessionCommandPolicy,
   getAgentSessionRuntimeCapabilities,
   isAgentResourceModeCompatible,
+  isAgentSessionTerminalStatus,
   normalizeAgentExecutionMode,
   normalizeAgentMode,
   resolveAgentSessionCommandTransition