@inf-monkeys-tech/monkeys 1.0.21 → 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 || []);
@@ -6783,6 +6795,26 @@ var AgentSessionStatusSchema = z3.enum([
   "failed"
 ]);
 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,
@@ -6840,7 +6872,15 @@ var AgentSessionRunSchema = z3.object({
     });
   }
 });
-var AgentSessionCommandTypeSchema = z3.enum(["stop", "resume", "retry", "approval"]);
+var AgentSessionCommandTypeSchema = z3.enum([
+  "stop",
+  "resume",
+  "retry",
+  "approval",
+  "fork",
+  "edit-and-rerun",
+  "steer"
+]);
 var AgentSessionCommandHeaderSchema = z3.object({
   contract: z3.literal("AgentSessionCommand"),
   commandId: ContractIdentifierSchema,
@@ -6868,8 +6908,33 @@ 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 })
 );
@@ -6886,6 +6951,11 @@ 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({
@@ -6898,6 +6968,10 @@ var AgentSessionCommandResultSchema = z3.object({
   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,
@@ -6928,13 +7002,113 @@ var AgentSessionCommandResultSchema = z3.object({
       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];
 }
@@ -7079,8 +7253,24 @@ 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." });
@@ -7116,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();
@@ -11794,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,
@@ -11802,13 +11995,17 @@ export {
   AgentModeSchema,
   AgentResourceModeSupportSchema,
   AgentRuntimeEventSchema,
+  AgentSessionActiveBranchSchema,
   AgentSessionCapabilitiesSchema,
   AgentSessionCapabilitySchema,
   AgentSessionCommandErrorCodeSchema,
+  AgentSessionCommandPolicySchema,
   AgentSessionCommandResultSchema,
   AgentSessionCommandSchema,
   AgentSessionCommandTypeSchema,
+  AgentSessionContextInheritanceSchema,
   AgentSessionEventSchema,
+  AgentSessionLineageSchema,
   AgentSessionRunEventSchema,
   AgentSessionRunSchema,
   AgentSessionSnapshotSchema,
@@ -11947,8 +12144,10 @@ export {
   WorkflowValidationIssueSchema,
   agentModeHasCapability,
   canApplyAgentSessionRunStatus,
+  canIssueAgentSessionCommand,
   findUnsupportedAgentSessionCapabilities,
   getAgentModeCapabilities,
+  getAgentSessionCommandPolicy,
   getAgentSessionRuntimeCapabilities,
   isAgentResourceModeCompatible,
   isAgentSessionTerminalStatus,