@getmagical/cli 0.3.0 → 0.3.1

package/dist/index.js

@@ -14592,8 +14592,8 @@ var automationRunStartConfigSchema = automationRunConfigBaseSchema.omit({
 });
 
 // ../common/dist/src/utils/custom-instructions-command.util.js
-var MAX_CUSTOM_COMMAND_COUNT = 1;
-var MAX_CUSTOM_INSTRUCTIONS_LENGTH = 280;
+var MAX_CUSTOM_COMMAND_COUNT = 3;
+var MAX_CUSTOM_INSTRUCTIONS_LENGTH = 560;
 var STANDARD_COMMAND_NAMES = [
   "callSpecializedAgent",
   "checkpoint",
@@ -14633,22 +14633,20 @@ function assertCustomInstructionsCommand({ commands, path: path9 }) {
     return;
   }
   if (customCommands.length > MAX_CUSTOM_COMMAND_COUNT) {
-    throw createInvalidValueError(`${path9} contains ${customCommands.length.toString()} custom commands. Use at most one short custom command per agent. Split policy, decision, outreach, and multi-step work into catalog commands or child agents instead.`);
+    throw createInvalidValueError(`${path9} contains ${customCommands.length.toString()} custom commands. Use at most ${MAX_CUSTOM_COMMAND_COUNT.toString()} short custom commands per agent. Split policy, decision, outreach, and multi-step work into catalog commands or child agents instead.`);
   }
-  const [customCommand] = customCommands;
-  if (!customCommand) {
-    return;
-  }
-  const instructions = getCustomInstructions(customCommand.command);
-  if (instructions.length === 0) {
-    throw createInvalidValueError(`${customCommand.path}.arguments.instructions must be a non-empty string for custom commands.`);
-  }
-  if (instructions.length > MAX_CUSTOM_INSTRUCTIONS_LENGTH) {
-    throw createInvalidValueError(`${customCommand.path}.arguments.instructions is ${instructions.length.toString()} characters. Custom commands must be short single-action instructions (max ${MAX_CUSTOM_INSTRUCTIONS_LENGTH.toString()} chars). Move policy/template/context text into description, inputSchema, or child agents, and express executable work with catalog commands.`);
-  }
-  const mentionedCommand = getMentionedStandardCommand(instructions);
-  if (mentionedCommand !== null) {
-    throw createInvalidValueError(`${customCommand.path}.arguments.instructions mentions "${mentionedCommand}". Use the "${mentionedCommand}" catalog command directly instead of wrapping it in custom prose.`);
+  for (const customCommand of customCommands) {
+    const instructions = getCustomInstructions(customCommand.command);
+    if (instructions.length === 0) {
+      throw createInvalidValueError(`${customCommand.path}.arguments.instructions must be a non-empty string for custom commands.`);
+    }
+    if (instructions.length > MAX_CUSTOM_INSTRUCTIONS_LENGTH) {
+      throw createInvalidValueError(`${customCommand.path}.arguments.instructions is ${instructions.length.toString()} characters. Custom commands must be short single-action instructions (max ${MAX_CUSTOM_INSTRUCTIONS_LENGTH.toString()} chars). Move policy/template/context text into description, inputSchema, or child agents, and express executable work with catalog commands.`);
+    }
+    const mentionedCommand = getMentionedStandardCommand(instructions);
+    if (mentionedCommand !== null) {
+      throw createInvalidValueError(`${customCommand.path}.arguments.instructions mentions "${mentionedCommand}". Use the "${mentionedCommand}" catalog command directly instead of wrapping it in custom prose.`);
+    }
   }
 }
 
@@ -14997,6 +14995,60 @@ var agentLimitationsSelection = `      limitations {
         maxToolCalls
         allowedUrlRegexes
       }`;
+var automationRunsInputSchema = z27.object({
+  automationId: z27.string().min(1).optional(),
+  from: z27.string().min(1).optional(),
+  status: z27.array(z27.string().min(1)).optional(),
+  invocationType: z27.array(z27.string().min(1)).optional(),
+  limit: z27.number().int().positive().optional(),
+  orderBy: z27.enum(["createdAtAsc", "createdAtDesc", "random"]).optional(),
+  page: z27.number().int().nonnegative().optional(),
+  to: z27.string().min(1).optional()
+}).refine(({ orderBy, page }) => orderBy !== "random" || (page ?? 0) === 0, {
+  message: "Random ordering reshuffles on every call, so --page cannot be combined with --order-by random."
+});
+var automationRunsCliOptions = [
+  stringOption({
+    inputKey: "automationId",
+    flagName: "automation-id",
+    description: "Optional automation ID."
+  }),
+  stringOption({
+    inputKey: "from",
+    flagName: "from",
+    description: "Optional inclusive createdAt lower bound ISO timestamp."
+  }),
+  stringArrayOption({
+    inputKey: "status",
+    flagName: "status",
+    description: "Optional run statuses."
+  }),
+  stringArrayOption({
+    inputKey: "invocationType",
+    flagName: "invocation-type",
+    description: "Optional invocation types."
+  }),
+  numberOption({
+    inputKey: "limit",
+    flagName: "limit",
+    description: "Maximum number of runs to return."
+  }),
+  stringOption({
+    inputKey: "orderBy",
+    flagName: "order-by",
+    description: "Run ordering. Use random for sampling; it reshuffles on every call."
+  }),
+  numberOption({
+    inputKey: "page",
+    flagName: "page",
+    description: "Zero-based page number."
+  }),
+  stringOption({
+    inputKey: "to",
+    flagName: "to",
+    description: "Optional inclusive createdAt upper bound ISO timestamp."
+  })
+];
 var operationSpecs = [
   createOperationSpec({
     operationName: "GetCaptureContext",
@@ -15686,57 +15738,13 @@ query InspectPausedAutomationStep($runId: ID!) {
   createOperationSpec({
     operationName: "GetAutomationRuns",
     kind: "query",
-    inputSchema: z27.object({
-      automationId: z27.string().min(1).optional(),
-      from: z27.string().min(1).optional(),
-      status: z27.array(z27.string().min(1)).optional(),
-      invocationType: z27.array(z27.string().min(1)).optional(),
-      limit: z27.number().int().positive().optional(),
-      page: z27.number().int().nonnegative().optional(),
-      to: z27.string().min(1).optional()
-    }),
+    inputSchema: automationRunsInputSchema,
     cli: {
       name: "get-automation-runs",
       path: ["automation-runs", "list"],
       description: "Fetch automation run history.",
       resultKey: "automationRuns",
-      options: [
-        stringOption({
-          inputKey: "automationId",
-          flagName: "automation-id",
-          description: "Optional automation ID."
-        }),
-        stringOption({
-          inputKey: "from",
-          flagName: "from",
-          description: "Optional inclusive createdAt lower bound ISO timestamp."
-        }),
-        stringArrayOption({
-          inputKey: "status",
-          flagName: "status",
-          description: "Optional run statuses."
-        }),
-        stringArrayOption({
-          inputKey: "invocationType",
-          flagName: "invocation-type",
-          description: "Optional invocation types."
-        }),
-        numberOption({
-          inputKey: "limit",
-          flagName: "limit",
-          description: "Maximum number of runs to return."
-        }),
-        numberOption({
-          inputKey: "page",
-          flagName: "page",
-          description: "Zero-based page number."
-        }),
-        stringOption({
-          inputKey: "to",
-          flagName: "to",
-          description: "Optional inclusive createdAt upper bound ISO timestamp."
-        })
-      ]
+      options: automationRunsCliOptions
     },
     mcp: { fileName: "automationRuns.graphql" },
     document: `# Query automation run history with optional automation and time-window filters
@@ -15746,6 +15754,7 @@ query GetAutomationRuns(
   $status: [RunStatus!]
   $invocationType: [InvocationType!]
   $limit: Int
+  $orderBy: AutomationRunOrderBy
   $page: Int
   $to: String
 ) {
@@ -15755,6 +15764,7 @@ query GetAutomationRuns(
     status: $status
     invocationType: $invocationType
     limit: $limit
+    orderBy: $orderBy
     page: $page
     to: $to
   ) {
@@ -15770,6 +15780,59 @@ query GetAutomationRuns(
     pausedAt
     finishedAt
   }
+}`
+  }),
+  createOperationSpec({
+    operationName: "GetAutomationRunsPage",
+    kind: "query",
+    inputSchema: automationRunsInputSchema,
+    cli: {
+      name: "get-automation-runs-page",
+      path: ["automation-runs", "list-page"],
+      description: "Fetch automation run history with bounded total metadata. When isTotalTruncated is true, total is a lower bound.",
+      resultKey: "automationRunsPage",
+      options: automationRunsCliOptions
+    },
+    mcp: { fileName: "automationRunsPage.graphql" },
+    document: `# Query automation run history with optional filters and a bounded total
+query GetAutomationRunsPage(
+  $automationId: ID
+  $from: String
+  $status: [RunStatus!]
+  $invocationType: [InvocationType!]
+  $limit: Int
+  $orderBy: AutomationRunOrderBy
+  $page: Int
+  $to: String
+) {
+  automationRunsPage(
+    automationId: $automationId
+    from: $from
+    status: $status
+    invocationType: $invocationType
+    limit: $limit
+    orderBy: $orderBy
+    page: $page
+    to: $to
+  ) {
+    items {
+      id
+      automationId
+      parentAutomationRunId
+      status
+      statusDetail
+      invocationType
+      summary
+      createdAt
+      startedAt
+      pausedAt
+      finishedAt
+    }
+    total
+    page
+    pageSize
+    isTotalTruncated
+  }
 }`
   }),
   createOperationSpec({