@inf-monkeys-tech/monkeys 1.0.21 → 1.0.23

package/lib/esm/schemas/index.mjs

@@ -7142,7 +7142,11 @@ var AgentSessionCapabilitySchema = z5.enum([
   "diff",
   "workspaceFiles",
   "terminal",
-  "testResults"
+  "testResults",
+  "threadForking",
+  "editAndRerun",
+  "steering",
+  "summary"
 ]);
 var AgentSessionCapabilitiesSchema = z5.object({
   text: z5.boolean().default(true),
@@ -7161,11 +7165,15 @@ var AgentSessionCapabilitiesSchema = z5.object({
   diff: z5.boolean().default(false),
   workspaceFiles: z5.boolean().default(false),
   terminal: z5.boolean().default(false),
-  testResults: z5.boolean().default(false)
+  testResults: z5.boolean().default(false),
+  threadForking: z5.boolean().default(false),
+  editAndRerun: z5.boolean().default(false),
+  steering: z5.boolean().default(false),
+  summary: z5.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 }),
-  agent: AgentSessionCapabilitiesSchema.parse({ text: true, tools: true, mcp: true, shell: true, fileChange: true, skills: true, approval: true, artifacts: true, usage: true, resume: true })
+  chatbot: AgentSessionCapabilitiesSchema.parse({ text: true, tools: true, mcp: true, skills: true, approval: true, usage: true, summary: true }),
+  agent: AgentSessionCapabilitiesSchema.parse({ text: true, tools: true, mcp: true, shell: true, fileChange: true, skills: true, approval: true, artifacts: true, usage: true, resume: true, summary: true })
 });
 var AGENT_SESSION_CAPABILITY_EVIDENCE = Object.freeze({
   text: { eventTypes: ["message"], commandTypes: [] },
@@ -7184,7 +7192,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: [] }
 });
 var AgentSessionSnapshotSchema = z5.object({
   mode: AgentModeSchema,
@@ -7201,6 +7213,26 @@ var AgentSessionStatusSchema = z5.enum([
   "failed"
 ]);
 var AgentSessionTerminalStatusSchema = z5.enum(["stopped", "completed", "failed"]);
+var AgentSessionLineageSchema = z5.object({
+  forkedFromThreadId: ContractIdentifierSchema,
+  forkedFromMessageId: ContractIdentifierSchema,
+  sourceRunId: ContractIdentifierSchema
+}).strict();
+var AgentSessionContextInheritanceSchema = z5.object({
+  messages: z5.enum(["through-source-message", "exclude"]),
+  attachments: z5.enum(["inherit", "exclude"]),
+  summaries: z5.enum(["inherit", "exclude"]),
+  toolResults: z5.enum(["inherit", "exclude"]),
+  codeChanges: z5.enum(["inherit", "exclude"])
+}).strict();
+var AgentSessionActiveBranchSchema = z5.object({
+  branchId: ContractIdentifierSchema,
+  threadId: ContractIdentifierSchema,
+  sourceMessageId: ContractIdentifierSchema,
+  runId: ContractIdentifierSchema,
+  lineage: AgentSessionLineageSchema.optional(),
+  createdAt: IsoDateTimeSchema
+}).strict();
 var AgentSessionRunSchema = z5.object({
   runId: ContractIdentifierSchema,
   sessionId: ContractIdentifierSchema,
@@ -7258,7 +7290,15 @@ var AgentSessionRunSchema = z5.object({
     });
   }
 });
-var AgentSessionCommandTypeSchema = z5.enum(["stop", "resume", "retry", "approval"]);
+var AgentSessionCommandTypeSchema = z5.enum([
+  "stop",
+  "resume",
+  "retry",
+  "approval",
+  "fork",
+  "edit-and-rerun",
+  "steer"
+]);
 var AgentSessionCommandHeaderSchema = z5.object({
   contract: z5.literal("AgentSessionCommand"),
   commandId: ContractIdentifierSchema,
@@ -7286,8 +7326,33 @@ var AgentSessionCommandSchema = z5.discriminatedUnion("commandType", [
     approvalId: ContractIdentifierSchema,
     decision: z5.enum(["approved", "rejected"]),
     reason: z5.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: z5.array(JsonValueSchema).min(1),
+    inheritance: AgentSessionContextInheritanceSchema
+  }),
+  sessionCommand("steer", {
+    targetRunId: ContractIdentifierSchema,
+    guidanceParts: z5.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(
   z5.object({ runId: ContractIdentifierSchema })
 );
@@ -7304,6 +7369,11 @@ var AgentSessionCommandErrorCodeSchema = z5.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 = z5.object({
@@ -7316,6 +7386,10 @@ var AgentSessionCommandResultSchema = z5.object({
   sessionStatus: AgentSessionStatusSchema,
   acceptedSequence: z5.number().int().nonnegative().optional(),
   resultEventIds: z5.array(ContractIdentifierSchema).default([]),
+  operation: z5.object({
+    lineage: AgentSessionLineageSchema,
+    activeBranch: AgentSessionActiveBranchSchema
+  }).strict().optional(),
   termination: z5.enum(["requested", "confirmed"]).optional(),
   error: z5.object({
     code: AgentSessionCommandErrorCodeSchema,
@@ -7346,6 +7420,97 @@ var AgentSessionCommandResultSchema = z5.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 AgentSessionCommandPolicySchema = z5.object({
+  capability: AgentSessionCapabilitySchema.optional(),
+  allowedStatuses: z5.array(AgentSessionStatusSchema).min(1),
+  requiresRunId: z5.boolean(),
+  sourceSessionEffect: z5.enum(["transition", "preserve"]),
+  idempotencyScope: z5.literal("session-command"),
+  sequenceRule: z5.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 isAgentSessionTerminalStatus(status) {
   return AgentSessionTerminalStatusSchema.safeParse(status).success;
@@ -7475,8 +7640,24 @@ var AgentSessionEventSchema = z5.discriminatedUnion("eventType", [
     status: z5.enum(["running", "passed", "failed", "skipped"]),
     durationMs: z5.number().nonnegative().optional(),
     output: z5.string().optional()
+  }),
+  sessionEvent("summary", {
+    summaryId: ContractIdentifierSchema,
+    runId: ContractIdentifierSchema,
+    text: z5.string(),
+    highlights: z5.array(z5.string()),
+    pendingItems: z5.array(z5.string()),
+    status: z5.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." });
@@ -7512,7 +7693,9 @@ var AgentSessionViewModelSchema = z5.object({
   status: AgentSessionStatusSchema,
   events: z5.array(AgentSessionEventSchema),
   lastSequence: z5.number().int().min(-1),
-  resumable: z5.boolean().default(false)
+  resumable: z5.boolean().default(false),
+  lineage: AgentSessionLineageSchema.optional(),
+  activeBranch: AgentSessionActiveBranchSchema.optional()
 }).strict().superRefine((value, context) => {
   const eventIds = /* @__PURE__ */ new Set();
   const idempotencyKeys = /* @__PURE__ */ new Set();
@@ -11814,13 +11997,17 @@ export {
   AgentModeSchema,
   AgentResourceModeSupportSchema,
   AgentRuntimeEventSchema,
+  AgentSessionActiveBranchSchema,
   AgentSessionCapabilitiesSchema,
   AgentSessionCapabilitySchema,
   AgentSessionCommandErrorCodeSchema,
+  AgentSessionCommandPolicySchema,
   AgentSessionCommandResultSchema,
   AgentSessionCommandSchema,
   AgentSessionCommandTypeSchema,
+  AgentSessionContextInheritanceSchema,
   AgentSessionEventSchema,
+  AgentSessionLineageSchema,
   AgentSessionRunEventSchema,
   AgentSessionRunSchema,
   AgentSessionSnapshotSchema,