@netlify/agent-runner-cli 1.151.0 → 1.152.0-EX-2670.1

package/dist/skills/asking-questions/SKILL.md

@@ -9,6 +9,11 @@ description:
 
 When a decision is genuinely the user's to make and would change what you build, ask rather than assume.
 
-Use the `ask` tool: pass one to three questions, each with a short `header`, the `question` text, and `options` when
-there is a clear set of choices. Calling it pauses the process until the user answers, so ask everything you need in a
-single call and stop. A plain-text question does not reach the user.
+Use the `ask` tool: pass one to three questions, each with a short `header`, the `question` text, and two or three
+`options` when there is a clear set of choices. Add `multiSelect: true` when several of those options can apply at once.
+Never write an option like "Other", "Something else", or "None of these". The UI adds an "Other" choice and a free-text
+field to give extra context to every question that has options, so if you added an "other" option it would be a
+duplicate. Leave `options` out to ask an open question the user answers in their own words.
+
+Calling the tool pauses the process until the user answers, so ask everything you need in a single call and stop. A
+plain-text question does not reach the user.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@netlify/agent-runner-cli",
   "type": "module",
-  "version": "1.151.0",
+  "version": "1.152.0-EX-2670.1",
   "description": "CLI tool for running Netlify agents",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/scripts/scenarios/interactions-stub-server.mjs

@@ -0,0 +1,71 @@
+import { readFileSync, appendFileSync, writeFileSync, existsSync } from 'node:fs'
+import path from 'node:path'
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { createJiti } from 'jiti'
+
+const jiti = createJiti(import.meta.url, { interopDefault: true })
+const { ASK_TOOL_DESCRIPTION, askQuestionsShape, formatAskAnswerBlock } = await jiti.import(
+  '../../src/lib/ask-schema.js',
+)
+const {
+  ASK_LOG_FILENAME,
+  ASK_SERVER_READY_FILENAME,
+  CANNED_ANSWERS_FILENAME,
+  INTERACTIONS_MCP_SERVER,
+  UNANTICIPATED_QUESTION_ANSWER,
+} = await jiti.import('../../scenarios/helpers/interactions-stub-contract.js')
+
+const WORKSPACE = process.cwd()
+const CANNED_ANSWERS_FILE = path.join(WORKSPACE, CANNED_ANSWERS_FILENAME)
+const ASK_LOG_FILE = path.join(WORKSPACE, ASK_LOG_FILENAME)
+const ASK_SERVER_READY_FILE = path.join(WORKSPACE, ASK_SERVER_READY_FILENAME)
+
+const PREAMBLE = 'The user answered, and the run has resumed — the pause is over.'
+
+const loadCannedAnswersOrThrow = () => {
+  if (!existsSync(CANNED_ANSWERS_FILE)) {
+    throw new Error(
+      `${CANNED_ANSWERS_FILE} is missing. scenarioCannedAnswersSetup should have written it into the workspace (cwd=${WORKSPACE}).`,
+    )
+  }
+  const parsed = JSON.parse(readFileSync(CANNED_ANSWERS_FILE, 'utf8'))
+  if (!Array.isArray(parsed.answers) || parsed.answers.length === 0) {
+    throw new Error(`${CANNED_ANSWERS_FILE} has no non-empty "answers" array.`)
+  }
+  return parsed.answers
+}
+
+const logAskCall = (questions) => {
+  appendFileSync(ASK_LOG_FILE, `${JSON.stringify({ at: new Date().toISOString(), questions })}\n`)
+}
+
+const server = new McpServer({ name: INTERACTIONS_MCP_SERVER, version: '1.0.0' })
+
+server.registerTool(
+  'ask',
+  {
+    description: ASK_TOOL_DESCRIPTION,
+    inputSchema: askQuestionsShape,
+  },
+  ({ questions }) => {
+    logAskCall(questions)
+    const answersByPosition = loadCannedAnswersOrThrow()
+    const pairs = questions.map((question, index) => ({
+      question: question.question,
+      answer: answersByPosition[index] ?? UNANTICIPATED_QUESTION_ANSWER,
+    }))
+    return { content: [{ type: 'text', text: formatAskAnswerBlock(pairs, { preamble: PREAMBLE }) }] }
+  },
+)
+
+const shutdown = () => process.exit(0)
+process.stdin.on('close', shutdown)
+process.stdin.on('end', shutdown)
+
+loadCannedAnswersOrThrow()
+
+await server.connect(new StdioServerTransport())
+
+writeFileSync(ASK_SERVER_READY_FILE, `${new Date().toISOString()}\n`)