@inf-monkeys-tech/monkeys 1.0.11 → 1.0.13

package/lib/esm/index.mjs

@@ -6690,6 +6690,48 @@ var OutputRecordSchema = z2.object({
 // src/contracts/agent.ts
 import { z as z3 } from "zod";
 var AgentModeSchema = z3.enum(["chatbot", "agent"]);
+var AgentConfigurationCapabilitySchema = z3.enum([
+  "models",
+  "skills",
+  "tools",
+  "mcp",
+  "reasoning"
+]);
+var AgentModeCapabilitiesSchema = z3.object({
+  models: z3.boolean(),
+  skills: z3.boolean(),
+  tools: z3.boolean(),
+  mcp: z3.boolean(),
+  reasoning: z3.boolean()
+}).strict();
+var AgentResourceModeSupportSchema = z3.object({
+  modes: z3.array(AgentModeSchema).min(1)
+}).strict();
+var AGENT_MODE_CAPABILITIES = Object.freeze({
+  chatbot: AgentModeCapabilitiesSchema.parse({
+    models: true,
+    skills: true,
+    tools: true,
+    mcp: true,
+    reasoning: false
+  }),
+  agent: AgentModeCapabilitiesSchema.parse({
+    models: true,
+    skills: true,
+    tools: true,
+    mcp: true,
+    reasoning: true
+  })
+});
+function getAgentModeCapabilities(mode) {
+  return AGENT_MODE_CAPABILITIES[mode];
+}
+function agentModeHasCapability(mode, capability) {
+  return getAgentModeCapabilities(mode)[capability];
+}
+function isAgentResourceModeCompatible(support, mode) {
+  return support?.modes.includes(mode) ?? false;
+}
 var AgentSessionCapabilitySchema = z3.enum([
   "text",
   "reasoning",
@@ -6733,6 +6775,90 @@ var AgentSessionSnapshotSchema = z3.object({
   modelId: z3.string().trim().min(1),
   capabilities: AgentSessionCapabilitiesSchema
 }).strict();
+var AgentSessionStatusSchema = z3.enum([
+  "queued",
+  "running",
+  "waiting_approval",
+  "stopping",
+  "stopped",
+  "completed",
+  "failed"
+]);
+var AgentSessionCommandTypeSchema = z3.enum(["stop", "resume", "retry", "approval"]);
+var AgentSessionCommandHeaderSchema = z3.object({
+  contract: z3.literal("AgentSessionCommand"),
+  commandId: ContractIdentifierSchema,
+  sessionId: ContractIdentifierSchema,
+  idempotencyKey: ContractIdentifierSchema,
+  expectedSequence: z3.number().int().min(-1),
+  issuedAt: IsoDateTimeSchema
+}).strict();
+var sessionCommand = (commandType, payload) => AgentSessionCommandHeaderSchema.extend({
+  commandType: z3.literal(commandType),
+  payload: z3.object(payload).strict()
+}).strict();
+var AgentSessionCommandSchema = z3.discriminatedUnion("commandType", [
+  sessionCommand("stop", {
+    reason: z3.string().trim().min(1).optional()
+  }),
+  sessionCommand("resume", {
+    resumeEventId: ContractIdentifierSchema.optional()
+  }),
+  sessionCommand("retry", {
+    sourceEventId: ContractIdentifierSchema
+  }),
+  sessionCommand("approval", {
+    approvalId: ContractIdentifierSchema,
+    decision: z3.enum(["approved", "rejected"]),
+    reason: z3.string().trim().min(1).optional()
+  })
+]);
+var AgentSessionCommandErrorCodeSchema = z3.enum([
+  "SESSION_NOT_FOUND",
+  "COMMAND_NOT_SUPPORTED",
+  "CAPABILITY_UNAVAILABLE",
+  "SEQUENCE_CONFLICT",
+  "INVALID_SESSION_STATE",
+  "TARGET_EVENT_NOT_FOUND",
+  "TARGET_EVENT_NOT_RETRYABLE",
+  "APPROVAL_NOT_FOUND",
+  "APPROVAL_ALREADY_RESOLVED",
+  "COMMAND_EXECUTION_FAILED"
+]);
+var AgentSessionCommandResultSchema = z3.object({
+  contract: z3.literal("AgentSessionCommandResult"),
+  commandId: ContractIdentifierSchema,
+  sessionId: ContractIdentifierSchema,
+  idempotencyKey: ContractIdentifierSchema,
+  outcome: z3.enum(["accepted", "duplicate", "rejected", "failed"]),
+  sessionStatus: AgentSessionStatusSchema,
+  acceptedSequence: z3.number().int().nonnegative().optional(),
+  resultEventIds: z3.array(ContractIdentifierSchema).default([]),
+  error: z3.object({
+    code: AgentSessionCommandErrorCodeSchema,
+    message: z3.string(),
+    retryable: z3.boolean()
+  }).strict().optional(),
+  occurredAt: IsoDateTimeSchema
+}).strict().superRefine((value, context) => {
+  const requiresError = value.outcome === "rejected" || value.outcome === "failed";
+  if (requiresError !== Boolean(value.error)) {
+    context.addIssue({
+      code: "custom",
+      path: ["error"],
+      message: requiresError ? "Rejected and failed command results require an error." : "Accepted and duplicate command results must not contain an error."
+    });
+  }
+});
+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" }
+};
+function resolveAgentSessionCommandTransition(status, commandType) {
+  return AGENT_SESSION_COMMAND_TRANSITIONS[commandType][status];
+}
 var AgentSessionEventHeaderSchema = z3.object({
   contract: z3.literal("AgentSessionEvent"),
   eventId: ContractIdentifierSchema,
@@ -6795,7 +6921,7 @@ var AgentSessionEventSchema = z3.discriminatedUnion("eventType", [
     requestedAction: JsonValueSchema.optional()
   }),
   sessionEvent("status", {
-    status: z3.enum(["queued", "running", "waiting_approval", "stopping", "stopped", "completed", "failed"]),
+    status: AgentSessionStatusSchema,
     detail: z3.string().optional()
   }),
   sessionEvent("artifact", {
@@ -6856,7 +6982,7 @@ var AgentSessionViewModelSchema = z3.object({
   contract: z3.literal("AgentSessionViewModel"),
   sessionId: ContractIdentifierSchema,
   snapshot: AgentSessionSnapshotSchema,
-  status: z3.enum(["queued", "running", "waiting_approval", "stopping", "stopped", "completed", "failed"]),
+  status: AgentSessionStatusSchema,
   events: z3.array(AgentSessionEventSchema),
   lastSequence: z3.number().int().min(-1),
   resumable: z3.boolean().default(false)
@@ -11357,6 +11483,8 @@ var WorkflowDefinitionSchema = z14.object({
 
 // src/schemas/index.ts
 var canonicalContractSchemas = {
+  "agent-session-command": AgentSessionCommandSchema,
+  "agent-session-command-result": AgentSessionCommandResultSchema,
   "agent-session-event": AgentSessionEventSchema,
   "agent-session-view-model": AgentSessionViewModelSchema,
   "agent-runtime-event": AgentRuntimeEventSchema,
@@ -12550,15 +12678,24 @@ var compileWorkflowPersistenceProjection = (input) => {
   });
 };
 export {
+  AGENT_MODE_CAPABILITIES,
   APPLICATION_HANDOFF_QUERY_PARAMETER,
   ActorRefSchema,
+  AgentConfigurationCapabilitySchema,
   AgentExecutionModeSchema,
+  AgentModeCapabilitiesSchema,
   AgentModeSchema,
+  AgentResourceModeSupportSchema,
   AgentRuntimeEventSchema,
   AgentSessionCapabilitiesSchema,
   AgentSessionCapabilitySchema,
+  AgentSessionCommandErrorCodeSchema,
+  AgentSessionCommandResultSchema,
+  AgentSessionCommandSchema,
+  AgentSessionCommandTypeSchema,
   AgentSessionEventSchema,
   AgentSessionSnapshotSchema,
+  AgentSessionStatusSchema,
   AgentSessionViewModelSchema,
   ApplicationHandoffEndpointSchema,
   ApplicationHandoffSchema,
@@ -12693,6 +12830,7 @@ export {
   WorkflowTriggerSchema,
   WorkflowTriggerType,
   WorkflowValidationIssueSchema,
+  agentModeHasCapability,
   applyViewRuntimeBindings,
   assertMonkeysThemeTokensComplete,
   assertThemeTokensDocumentStructure,
@@ -12717,12 +12855,15 @@ export {
   createToolCapabilityManifest,
   createWorkflowCapabilityManifest,
   extractOpenApiCapabilityManifests,
+  getAgentModeCapabilities,
+  isAgentResourceModeCompatible,
   mergeThemeTokenDocuments,
   normalizeAgentExecutionMode,
   normalizeAgentMode,
   parseApplicationHandoff,
   publishOpenApiToolCapabilityManifests,
   readApplicationHandoffFromUrl,
+  resolveAgentSessionCommandTransition,
   resolveThemeTokens,
   serializeApplicationHandoff,
   validateDomainCommand,