@midscene/core 1.12.4-beta-20260904065253.0 → 1.12.4

package/dist/lib/agent/insight.js

@@ -43,6 +43,17 @@ const defaultQueryOptions = {
     screenshotIncluded: true
 };
 class Insight {
+    resolveContext(apiName, options) {
+        return this.resolveAgentContext(apiName, options?.context);
+    }
+    withContext(apiName, options) {
+        const resolvedContext = this.resolveContext(apiName, options);
+        if (void 0 === resolvedContext) return options;
+        return {
+            ...options,
+            context: resolvedContext
+        };
+    }
     executionOptions(options, includeAbortSignal = false) {
         const uiContext = this.getUIContext?.();
         if (!uiContext && !includeAbortSignal && !options?.abortSignal) return;
@@ -58,32 +69,35 @@ class Insight {
     async aiQuery(demand, options = defaultQueryOptions) {
         const modelRuntime = this.resolveModelRuntime();
         const executionOptions = this.executionOptions();
-        const { output } = executionOptions ? await this.taskExecutor.createTypeQueryExecution('Query', demand, modelRuntime, options, void 0, executionOptions) : await this.taskExecutor.createTypeQueryExecution('Query', demand, modelRuntime, options);
+        const serviceOptions = this.withContext('aiQuery', options);
+        const { output } = executionOptions ? await this.taskExecutor.createTypeQueryExecution('Query', demand, modelRuntime, serviceOptions, void 0, executionOptions) : await this.taskExecutor.createTypeQueryExecution('Query', demand, modelRuntime, serviceOptions);
         return output;
     }
     async aiBoolean(prompt, options = defaultQueryOptions) {
-        return this.queryPrimitive('Boolean', prompt, options);
+        return this.queryPrimitive('Boolean', 'aiBoolean', prompt, options);
     }
     async aiNumber(prompt, options = defaultQueryOptions) {
-        return this.queryPrimitive('Number', prompt, options);
+        return this.queryPrimitive('Number', 'aiNumber', prompt, options);
     }
     async aiString(prompt, options = defaultQueryOptions) {
-        return this.queryPrimitive('String', prompt, options);
+        return this.queryPrimitive('String', 'aiString', prompt, options);
     }
     async aiAsk(prompt, options = defaultQueryOptions) {
-        return this.aiString(prompt, options);
+        return this.queryPrimitive('String', 'aiAsk', prompt, options);
     }
-    async queryPrimitive(type, prompt, options) {
+    async queryPrimitive(type, apiName, prompt, options) {
         const { textPrompt, multimodalPrompt } = (0, external_utils_js_namespaceObject.parsePrompt)(prompt);
-        const { output } = await this.taskExecutor.createTypeQueryExecution(type, textPrompt, this.resolveModelRuntime(), options, multimodalPrompt, this.executionOptions());
+        const serviceOptions = this.withContext(apiName, options);
+        const { output } = await this.taskExecutor.createTypeQueryExecution(type, textPrompt, this.resolveModelRuntime(), serviceOptions, multimodalPrompt, this.executionOptions());
         return output;
     }
     async aiAssert(assertion, message, options) {
+        const contextOptions = this.withContext('aiAssert', options ?? {});
         const serviceOptions = {
             domIncluded: options?.domIncluded ?? defaultQueryOptions.domIncluded,
             screenshotIncluded: options?.screenshotIncluded ?? defaultQueryOptions.screenshotIncluded,
-            ...options?.context !== void 0 ? {
-                context: options.context
+            ...void 0 !== contextOptions.context ? {
+                context: contextOptions.context
             } : {}
         };
         const { textPrompt, multimodalPrompt } = (0, external_utils_js_namespaceObject.parsePrompt)(assertion);
@@ -116,12 +130,14 @@ class Insight {
             throw error;
         }
     }
-    constructor(taskExecutor, resolveModelRuntime, getUIContext){
+    constructor(taskExecutor, resolveModelRuntime, resolveAgentContext, getUIContext){
         _define_property(this, "taskExecutor", void 0);
         _define_property(this, "resolveModelRuntime", void 0);
+        _define_property(this, "resolveAgentContext", void 0);
         _define_property(this, "getUIContext", void 0);
         this.taskExecutor = taskExecutor;
         this.resolveModelRuntime = resolveModelRuntime;
+        this.resolveAgentContext = resolveAgentContext;
         this.getUIContext = getUIContext;
     }
 }

package/dist/lib/agent/insight.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent/insight.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/agent/insight.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { TUserPrompt } from '@/ai-model/index';\nimport type { ModelRuntime } from '@/ai-model/models';\nimport type {\n  AgentAssertResult,\n  AssertOptions,\n  InsightAPI,\n  QueryOptions,\n  ServiceExtractParam,\n  UIContext,\n} from '@/types';\nimport { TaskExecutionError, type TaskExecutor } from './tasks';\nimport { parsePrompt } from './utils';\n\nconst defaultQueryOptions: QueryOptions = {\n  domIncluded: false,\n  screenshotIncluded: true,\n};\n\ntype InsightTaskExecutor = Pick<TaskExecutor, 'createTypeQueryExecution'>;\n\n/** Execute read-only AI operations against either live or fixed UI context. */\nexport class Insight implements InsightAPI {\n  constructor(\n    private readonly taskExecutor: InsightTaskExecutor,\n    private readonly resolveModelRuntime: () => ModelRuntime,\n    private readonly getUIContext?: () => UIContext,\n  ) {}\n\n  private executionOptions(\n    options?: AssertOptions,\n    includeAbortSignal = false,\n  ): { abortSignal?: AbortSignal; uiContext?: UIContext } | undefined {\n    const uiContext = this.getUIContext?.();\n    if (!uiContext && !includeAbortSignal && !options?.abortSignal) {\n      return undefined;\n    }\n    return {\n      ...(includeAbortSignal || options?.abortSignal\n        ? { abortSignal: options?.abortSignal }\n        : {}),\n      ...(uiContext ? { uiContext } : {}),\n    };\n  }\n\n  async aiQuery<ReturnType = any>(\n    demand: ServiceExtractParam,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<ReturnType> {\n    const modelRuntime = this.resolveModelRuntime();\n    const executionOptions = this.executionOptions();\n    const { output } = executionOptions\n      ? await this.taskExecutor.createTypeQueryExecution(\n          'Query',\n          demand,\n          modelRuntime,\n          options,\n          undefined,\n          executionOptions,\n        )\n      : await this.taskExecutor.createTypeQueryExecution(\n          'Query',\n          demand,\n          modelRuntime,\n          options,\n        );\n    return output as ReturnType;\n  }\n\n  async aiBoolean(\n    prompt: TUserPrompt,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<boolean> {\n    return this.queryPrimitive('Boolean', prompt, options);\n  }\n\n  async aiNumber(\n    prompt: TUserPrompt,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<number> {\n    return this.queryPrimitive('Number', prompt, options);\n  }\n\n  async aiString(\n    prompt: TUserPrompt,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<string> {\n    return this.queryPrimitive('String', prompt, options);\n  }\n\n  async aiAsk(\n    prompt: TUserPrompt,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<string> {\n    return this.aiString(prompt, options);\n  }\n\n  private async queryPrimitive<ReturnType>(\n    type: 'Boolean' | 'Number' | 'String',\n    prompt: TUserPrompt,\n    options: QueryOptions,\n  ): Promise<ReturnType> {\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      type,\n      textPrompt,\n      this.resolveModelRuntime(),\n      options,\n      multimodalPrompt,\n      this.executionOptions(),\n    );\n    return output as ReturnType;\n  }\n\n  async aiAssert(\n    assertion: TUserPrompt,\n    message?: string,\n    options?: AssertOptions,\n  ): Promise<AgentAssertResult | undefined> {\n    const serviceOptions: QueryOptions = {\n      domIncluded: options?.domIncluded ?? defaultQueryOptions.domIncluded,\n      screenshotIncluded:\n        options?.screenshotIncluded ?? defaultQueryOptions.screenshotIncluded,\n      ...(options?.context !== undefined ? { context: options.context } : {}),\n    };\n    const { textPrompt, multimodalPrompt } = parsePrompt(assertion);\n    const assertionText =\n      typeof assertion === 'string' ? assertion : assertion.prompt;\n\n    try {\n      const { output, thought } =\n        await this.taskExecutor.createTypeQueryExecution<boolean>(\n          'Assert',\n          textPrompt,\n          this.resolveModelRuntime(),\n          serviceOptions,\n          multimodalPrompt,\n          this.executionOptions(options, true),\n        );\n\n      const pass = Boolean(output);\n      const failureMessage = pass\n        ? undefined\n        : `Assertion failed: ${message || assertionText}\\nReason: ${thought || '(no_reason)'}`;\n\n      if (options?.keepRawResponse) {\n        return { pass, thought, message: failureMessage };\n      }\n      if (!pass) {\n        throw new Error(failureMessage);\n      }\n    } catch (error) {\n      if (error instanceof TaskExecutionError) {\n        const thought = error.task?.thought;\n        const diagnosticMessage =\n          error.task?.errorMessage || error.cause.message;\n        const reason = thought || diagnosticMessage || '(no_reason)';\n        const failureMessage = `Assertion failed: ${message || assertionText}\\nReason: ${reason}`;\n\n        if (options?.keepRawResponse) {\n          return { pass: false, thought, message: failureMessage };\n        }\n        throw new Error(failureMessage, { cause: error.cause });\n      }\n      throw error;\n    }\n  }\n}\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","defaultQueryOptions","Insight","options","includeAbortSignal","uiContext","demand","modelRuntime","executionOptions","output","undefined","prompt","type","textPrompt","multimodalPrompt","parsePrompt","assertion","message","serviceOptions","assertionText","thought","pass","Boolean","failureMessage","Error","error","TaskExecutionError","diagnosticMessage","reason","taskExecutor","resolveModelRuntime","getUIContext"],"mappings":"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"}
+{"version":3,"file":"agent/insight.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/agent/insight.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { TUserPrompt } from '@/ai-model/index';\nimport type { ModelRuntime } from '@/ai-model/models';\nimport type {\n  AgentAssertResult,\n  AssertOptions,\n  InsightAPI,\n  QueryOptions,\n  ServiceExtractParam,\n  UIContext,\n} from '@/types';\nimport type { AiApiName } from '@midscene/shared/agent-tools/agent-context';\nimport { TaskExecutionError, type TaskExecutor } from './tasks';\nimport { parsePrompt } from './utils';\n\nconst defaultQueryOptions: QueryOptions = {\n  domIncluded: false,\n  screenshotIncluded: true,\n};\n\ntype InsightTaskExecutor = Pick<TaskExecutor, 'createTypeQueryExecution'>;\n\ntype InsightContextOptions = { context?: string };\n\n/** Execute read-only AI operations against either live or fixed UI context. */\nexport class Insight implements InsightAPI {\n  constructor(\n    private readonly taskExecutor: InsightTaskExecutor,\n    private readonly resolveModelRuntime: () => ModelRuntime,\n    private readonly resolveAgentContext: (\n      apiName: AiApiName,\n      callContext?: string,\n    ) => string | undefined,\n    private readonly getUIContext?: () => UIContext,\n  ) {}\n\n  private resolveContext(\n    apiName: AiApiName,\n    options?: InsightContextOptions,\n  ): string | undefined {\n    return this.resolveAgentContext(apiName, options?.context);\n  }\n\n  private withContext<T extends InsightContextOptions>(\n    apiName: AiApiName,\n    options: T,\n  ): T {\n    const resolvedContext = this.resolveContext(apiName, options);\n    if (resolvedContext === undefined) {\n      return options;\n    }\n\n    return {\n      ...options,\n      context: resolvedContext,\n    };\n  }\n\n  private executionOptions(\n    options?: AssertOptions,\n    includeAbortSignal = false,\n  ): { abortSignal?: AbortSignal; uiContext?: UIContext } | undefined {\n    const uiContext = this.getUIContext?.();\n    if (!uiContext && !includeAbortSignal && !options?.abortSignal) {\n      return undefined;\n    }\n    return {\n      ...(includeAbortSignal || options?.abortSignal\n        ? { abortSignal: options?.abortSignal }\n        : {}),\n      ...(uiContext ? { uiContext } : {}),\n    };\n  }\n\n  async aiQuery<ReturnType = any>(\n    demand: ServiceExtractParam,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<ReturnType> {\n    const modelRuntime = this.resolveModelRuntime();\n    const executionOptions = this.executionOptions();\n    const serviceOptions = this.withContext('aiQuery', options);\n    const { output } = executionOptions\n      ? await this.taskExecutor.createTypeQueryExecution(\n          'Query',\n          demand,\n          modelRuntime,\n          serviceOptions,\n          undefined,\n          executionOptions,\n        )\n      : await this.taskExecutor.createTypeQueryExecution(\n          'Query',\n          demand,\n          modelRuntime,\n          serviceOptions,\n        );\n    return output as ReturnType;\n  }\n\n  async aiBoolean(\n    prompt: TUserPrompt,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<boolean> {\n    return this.queryPrimitive('Boolean', 'aiBoolean', prompt, options);\n  }\n\n  async aiNumber(\n    prompt: TUserPrompt,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<number> {\n    return this.queryPrimitive('Number', 'aiNumber', prompt, options);\n  }\n\n  async aiString(\n    prompt: TUserPrompt,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<string> {\n    return this.queryPrimitive('String', 'aiString', prompt, options);\n  }\n\n  async aiAsk(\n    prompt: TUserPrompt,\n    options: QueryOptions = defaultQueryOptions,\n  ): Promise<string> {\n    return this.queryPrimitive('String', 'aiAsk', prompt, options);\n  }\n\n  private async queryPrimitive<ReturnType>(\n    type: 'Boolean' | 'Number' | 'String',\n    apiName: 'aiBoolean' | 'aiNumber' | 'aiString' | 'aiAsk',\n    prompt: TUserPrompt,\n    options: QueryOptions,\n  ): Promise<ReturnType> {\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const serviceOptions = this.withContext(apiName, options);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      type,\n      textPrompt,\n      this.resolveModelRuntime(),\n      serviceOptions,\n      multimodalPrompt,\n      this.executionOptions(),\n    );\n    return output as ReturnType;\n  }\n\n  async aiAssert(\n    assertion: TUserPrompt,\n    message?: string,\n    options?: AssertOptions,\n  ): Promise<AgentAssertResult | undefined> {\n    const contextOptions = this.withContext('aiAssert', options ?? {});\n    const serviceOptions: QueryOptions = {\n      domIncluded: options?.domIncluded ?? defaultQueryOptions.domIncluded,\n      screenshotIncluded:\n        options?.screenshotIncluded ?? defaultQueryOptions.screenshotIncluded,\n      ...(contextOptions.context !== undefined\n        ? { context: contextOptions.context }\n        : {}),\n    };\n    const { textPrompt, multimodalPrompt } = parsePrompt(assertion);\n    const assertionText =\n      typeof assertion === 'string' ? assertion : assertion.prompt;\n\n    try {\n      const { output, thought } =\n        await this.taskExecutor.createTypeQueryExecution<boolean>(\n          'Assert',\n          textPrompt,\n          this.resolveModelRuntime(),\n          serviceOptions,\n          multimodalPrompt,\n          this.executionOptions(options, true),\n        );\n\n      const pass = Boolean(output);\n      const failureMessage = pass\n        ? undefined\n        : `Assertion failed: ${message || assertionText}\\nReason: ${thought || '(no_reason)'}`;\n\n      if (options?.keepRawResponse) {\n        return { pass, thought, message: failureMessage };\n      }\n      if (!pass) {\n        throw new Error(failureMessage);\n      }\n    } catch (error) {\n      if (error instanceof TaskExecutionError) {\n        const thought = error.task?.thought;\n        const diagnosticMessage =\n          error.task?.errorMessage || error.cause.message;\n        const reason = thought || diagnosticMessage || '(no_reason)';\n        const failureMessage = `Assertion failed: ${message || assertionText}\\nReason: ${reason}`;\n\n        if (options?.keepRawResponse) {\n          return { pass: false, thought, message: failureMessage };\n        }\n        throw new Error(failureMessage, { cause: error.cause });\n      }\n      throw error;\n    }\n  }\n}\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","defaultQueryOptions","Insight","apiName","options","resolvedContext","undefined","includeAbortSignal","uiContext","demand","modelRuntime","executionOptions","serviceOptions","output","prompt","type","textPrompt","multimodalPrompt","parsePrompt","assertion","message","contextOptions","assertionText","thought","pass","Boolean","failureMessage","Error","error","TaskExecutionError","diagnosticMessage","reason","taskExecutor","resolveModelRuntime","resolveAgentContext","getUIContext"],"mappings":"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"}

package/dist/lib/agent/prompt-context.js

@@ -25,13 +25,19 @@ var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     buildLocatePromptWithContext: ()=>buildLocatePromptWithContext,
-    buildPromptWithContext: ()=>buildPromptWithContext
+    buildPromptWithContext: ()=>buildPromptWithContext,
+    renderAIContext: ()=>renderAIContext
 });
-const buildPromptWithContext = (prompt, context)=>{
+const renderAIContext = (context)=>{
     const trimmedContext = context?.trim();
-    if (!trimmedContext) return prompt;
+    if (trimmedContext) return `<CONTEXT>\n${trimmedContext}\n</CONTEXT>`;
+    return void 0 === context ? void 0 : '';
+};
+const buildPromptWithContext = (prompt, context)=>{
+    const renderedContext = renderAIContext(context);
+    if (!renderedContext) return prompt;
     const promptText = 'string' == typeof prompt ? prompt : prompt.prompt;
-    const promptWithContext = `Context for this request:\n${trimmedContext}\n\n${promptText}`;
+    const promptWithContext = `${renderedContext}\n\n${promptText}`;
     if ('string' == typeof prompt) return promptWithContext;
     return {
         ...prompt,
@@ -39,10 +45,10 @@ const buildPromptWithContext = (prompt, context)=>{
     };
 };
 const buildLocatePromptWithContext = (prompt, context)=>{
-    const trimmedContext = context?.trim();
-    if (!trimmedContext) return prompt;
+    const renderedContext = renderAIContext(context);
+    if (!renderedContext) return prompt;
     const promptText = 'string' == typeof prompt ? prompt : prompt.prompt;
-    const promptWithContext = `<CONTEXT>\n${trimmedContext}\n</CONTEXT>\n\n<LOCATE_TARGET>\n${promptText}\n</LOCATE_TARGET>`;
+    const promptWithContext = `${renderedContext}\n\n<LOCATE_TARGET>\n${promptText}\n</LOCATE_TARGET>`;
     if ('string' == typeof prompt) return promptWithContext;
     return {
         ...prompt,
@@ -51,9 +57,11 @@ const buildLocatePromptWithContext = (prompt, context)=>{
 };
 exports.buildLocatePromptWithContext = __webpack_exports__.buildLocatePromptWithContext;
 exports.buildPromptWithContext = __webpack_exports__.buildPromptWithContext;
+exports.renderAIContext = __webpack_exports__.renderAIContext;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "buildLocatePromptWithContext",
-    "buildPromptWithContext"
+    "buildPromptWithContext",
+    "renderAIContext"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/lib/agent/prompt-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent/prompt-context.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/agent/prompt-context.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { TUserPrompt } from '@/ai-model';\n\nexport const buildPromptWithContext = (\n  prompt: TUserPrompt,\n  context: string | undefined,\n): TUserPrompt => {\n  const trimmedContext = context?.trim();\n  if (!trimmedContext) {\n    return prompt;\n  }\n\n  const promptText = typeof prompt === 'string' ? prompt : prompt.prompt;\n  const promptWithContext = `Context for this request:\\n${trimmedContext}\\n\\n${promptText}`;\n\n  if (typeof prompt === 'string') {\n    return promptWithContext;\n  }\n\n  return {\n    ...prompt,\n    prompt: promptWithContext,\n  };\n};\n\nexport const buildLocatePromptWithContext = (\n  prompt: TUserPrompt,\n  context: string | undefined,\n): TUserPrompt => {\n  const trimmedContext = context?.trim();\n  if (!trimmedContext) {\n    return prompt;\n  }\n\n  const promptText = typeof prompt === 'string' ? prompt : prompt.prompt;\n  const promptWithContext = `<CONTEXT>\\n${trimmedContext}\\n</CONTEXT>\\n\\n<LOCATE_TARGET>\\n${promptText}\\n</LOCATE_TARGET>`;\n\n  if (typeof prompt === 'string') {\n    return promptWithContext;\n  }\n\n  return {\n    ...prompt,\n    prompt: promptWithContext,\n  };\n};\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","buildPromptWithContext","prompt","context","trimmedContext","promptText","promptWithContext","buildLocatePromptWithContext"],"mappings":";;;IAAAA,oBAAoB,CAAC,GAAG,CAAC,UAASC;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGD,oBAAoB,CAAC,CAACC,YAAYC,QAAQ,CAACF,oBAAoB,CAAC,CAAC,UAASE,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAF,oBAAoB,CAAC,GAAG,CAACI,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFL,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,eAAlB,OAAOM,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;ACJO,MAAMI,yBAAyB,CACpCC,QACAC;IAEA,MAAMC,iBAAiBD,SAAS;IAChC,IAAI,CAACC,gBACH,OAAOF;IAGT,MAAMG,aAAa,AAAkB,YAAlB,OAAOH,SAAsBA,SAASA,OAAO,MAAM;IACtE,MAAMI,oBAAoB,CAAC,2BAA2B,EAAEF,eAAe,IAAI,EAAEC,YAAY;IAEzF,IAAI,AAAkB,YAAlB,OAAOH,QACT,OAAOI;IAGT,OAAO;QACL,GAAGJ,MAAM;QACT,QAAQI;IACV;AACF;AAEO,MAAMC,+BAA+B,CAC1CL,QACAC;IAEA,MAAMC,iBAAiBD,SAAS;IAChC,IAAI,CAACC,gBACH,OAAOF;IAGT,MAAMG,aAAa,AAAkB,YAAlB,OAAOH,SAAsBA,SAASA,OAAO,MAAM;IACtE,MAAMI,oBAAoB,CAAC,WAAW,EAAEF,eAAe,iCAAiC,EAAEC,WAAW,kBAAkB,CAAC;IAExH,IAAI,AAAkB,YAAlB,OAAOH,QACT,OAAOI;IAGT,OAAO;QACL,GAAGJ,MAAM;QACT,QAAQI;IACV;AACF"}
+{"version":3,"file":"agent/prompt-context.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/agent/prompt-context.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { TUserPrompt } from '@/ai-model';\n\n/** Render user-provided AI guidance at the model prompt boundary. */\nexport const renderAIContext = (\n  context: string | undefined,\n): string | undefined => {\n  const trimmedContext = context?.trim();\n  if (trimmedContext) {\n    return `<CONTEXT>\\n${trimmedContext}\\n</CONTEXT>`;\n  }\n\n  return context === undefined ? undefined : '';\n};\n\nexport const buildPromptWithContext = (\n  prompt: TUserPrompt,\n  context: string | undefined,\n): TUserPrompt => {\n  const renderedContext = renderAIContext(context);\n  if (!renderedContext) {\n    return prompt;\n  }\n\n  const promptText = typeof prompt === 'string' ? prompt : prompt.prompt;\n  const promptWithContext = `${renderedContext}\\n\\n${promptText}`;\n\n  if (typeof prompt === 'string') {\n    return promptWithContext;\n  }\n\n  return {\n    ...prompt,\n    prompt: promptWithContext,\n  };\n};\n\nexport const buildLocatePromptWithContext = (\n  prompt: TUserPrompt,\n  context: string | undefined,\n): TUserPrompt => {\n  const renderedContext = renderAIContext(context);\n  if (!renderedContext) {\n    return prompt;\n  }\n\n  const promptText = typeof prompt === 'string' ? prompt : prompt.prompt;\n  const promptWithContext = `${renderedContext}\\n\\n<LOCATE_TARGET>\\n${promptText}\\n</LOCATE_TARGET>`;\n\n  if (typeof prompt === 'string') {\n    return promptWithContext;\n  }\n\n  return {\n    ...prompt,\n    prompt: promptWithContext,\n  };\n};\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","renderAIContext","context","trimmedContext","undefined","buildPromptWithContext","prompt","renderedContext","promptText","promptWithContext","buildLocatePromptWithContext"],"mappings":";;;IAAAA,oBAAoB,CAAC,GAAG,CAAC,UAASC;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGD,oBAAoB,CAAC,CAACC,YAAYC,QAAQ,CAACF,oBAAoB,CAAC,CAAC,UAASE,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAF,oBAAoB,CAAC,GAAG,CAACI,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFL,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,eAAlB,OAAOM,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;ACHO,MAAMI,kBAAkB,CAC7BC;IAEA,MAAMC,iBAAiBD,SAAS;IAChC,IAAIC,gBACF,OAAO,CAAC,WAAW,EAAEA,eAAe,YAAY,CAAC;IAGnD,OAAOD,AAAYE,WAAZF,UAAwBE,SAAY;AAC7C;AAEO,MAAMC,yBAAyB,CACpCC,QACAJ;IAEA,MAAMK,kBAAkBN,gBAAgBC;IACxC,IAAI,CAACK,iBACH,OAAOD;IAGT,MAAME,aAAa,AAAkB,YAAlB,OAAOF,SAAsBA,SAASA,OAAO,MAAM;IACtE,MAAMG,oBAAoB,GAAGF,gBAAgB,IAAI,EAAEC,YAAY;IAE/D,IAAI,AAAkB,YAAlB,OAAOF,QACT,OAAOG;IAGT,OAAO;QACL,GAAGH,MAAM;QACT,QAAQG;IACV;AACF;AAEO,MAAMC,+BAA+B,CAC1CJ,QACAJ;IAEA,MAAMK,kBAAkBN,gBAAgBC;IACxC,IAAI,CAACK,iBACH,OAAOD;IAGT,MAAME,aAAa,AAAkB,YAAlB,OAAOF,SAAsBA,SAASA,OAAO,MAAM;IACtE,MAAMG,oBAAoB,GAAGF,gBAAgB,qBAAqB,EAAEC,WAAW,kBAAkB,CAAC;IAElG,IAAI,AAAkB,YAAlB,OAAOF,QACT,OAAOG;IAGT,OAAO;QACL,GAAGH,MAAM;QACT,QAAQG;IACV;AACF"}

package/dist/lib/agent/run-gherkin-scenario.js

@@ -126,7 +126,7 @@ const runGherkinScenario = async (agent, scenarioText, opt)=>{
         const prompt = buildStepPrompt(step);
         try {
             if ('aiAct' === action) await agent.aiAct(prompt, aiActOptions);
-            else if (opt?.context || opt?.abortSignal) await agent.aiAssert(prompt, void 0, {
+            else if (opt?.context !== void 0 || opt?.abortSignal) await agent.aiAssert(prompt, void 0, {
                 context: opt.context,
                 abortSignal: opt.abortSignal
             });

package/dist/lib/agent/run-gherkin-scenario.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent/run-gherkin-scenario.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/agent/run-gherkin-scenario.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { AiActOptions } from './agent';\n\nexport type GherkinStepKeyword = 'Given' | 'When' | 'Then' | 'And' | 'But';\n\ntype RunGherkinScenarioStepAction = 'aiAct' | 'aiAssert';\n\nexport type RunGherkinScenarioOptions = AiActOptions & {\n  context?: string;\n};\n\ntype GherkinPrimaryKeyword = 'Given' | 'When' | 'Then';\n\ntype ParsedGherkinStep = {\n  keyword: GherkinStepKeyword;\n  effectiveKeyword: GherkinPrimaryKeyword;\n  text: string;\n  lineNumber: number;\n};\n\ntype RawGherkinStep = {\n  keyword: GherkinStepKeyword;\n  text: string;\n  lineNumber: number;\n};\n\ntype ParsedGherkinScenario = {\n  scenario?: string;\n  steps: ParsedGherkinStep[];\n};\n\ntype GherkinScenarioAgent = {\n  aiAct: (taskPrompt: string, opt?: AiActOptions) => Promise<unknown>;\n  aiAssert: (\n    assertion: string,\n    msg?: string,\n    opt?: { context?: string; abortSignal?: AbortSignal },\n  ) => Promise<unknown>;\n};\n\nconst stepKeywordPattern = /^(Given|When|Then|And|But)\\s+(.+)$/i;\nconst headerPattern = /^(Scenario):\\s*(.*)$/i;\nconst unsupportedHeaderPattern =\n  /^(Feature|Background|Scenario Outline|Scenario Template|Examples|Rule):/i;\n\nconst normalizeStepKeyword = (keyword: string): GherkinStepKeyword => {\n  const lowerKeyword = keyword.toLowerCase();\n  if (lowerKeyword === 'given') return 'Given';\n  if (lowerKeyword === 'when') return 'When';\n  if (lowerKeyword === 'then') return 'Then';\n  if (lowerKeyword === 'and') return 'And';\n  return 'But';\n};\n\nconst isPrimaryKeyword = (\n  keyword: GherkinStepKeyword,\n): keyword is GherkinPrimaryKeyword => {\n  return keyword === 'Given' || keyword === 'When' || keyword === 'Then';\n};\n\nconst resolveSteps = (steps: RawGherkinStep[]): ParsedGherkinStep[] => {\n  let previousPrimaryKeyword: GherkinPrimaryKeyword | undefined;\n\n  return steps.map((step) => {\n    const effectiveKeyword = isPrimaryKeyword(step.keyword)\n      ? step.keyword\n      : previousPrimaryKeyword;\n\n    if (!effectiveKeyword) {\n      throw new Error(\n        `runGherkinScenario cannot resolve \"${step.keyword}\" at line ${step.lineNumber}; use Given, When, or Then before ${step.keyword}.`,\n      );\n    }\n\n    previousPrimaryKeyword = effectiveKeyword;\n\n    return {\n      ...step,\n      effectiveKeyword,\n    };\n  });\n};\n\nconst throwIfAborted = (abortSignal: AbortSignal | undefined) => {\n  if (!abortSignal?.aborted) {\n    return;\n  }\n\n  if (typeof abortSignal.throwIfAborted === 'function') {\n    abortSignal.throwIfAborted();\n  }\n\n  throw new Error(\n    `runGherkinScenario aborted: ${abortSignal.reason || 'signal already aborted'}`,\n  );\n};\n\nexport const parseGherkinScenario = (\n  scenarioText: string,\n): ParsedGherkinScenario => {\n  const lines = scenarioText.split(/\\r?\\n/);\n  const scenarioSteps: RawGherkinStep[] = [];\n  const anonymousSteps: RawGherkinStep[] = [];\n  let scenario: string | undefined;\n  let scenarioCount = 0;\n  let section: 'prelude' | 'scenario' = 'prelude';\n\n  for (const [lineIndex, rawLine] of lines.entries()) {\n    const lineNumber = lineIndex + 1;\n    const line = rawLine.trim();\n\n    if (!line || line.startsWith('#') || line.startsWith('@')) {\n      continue;\n    }\n\n    if (line === '\"\"\"' || line === \"'''\") {\n      throw new Error(\n        `runGherkinScenario does not support doc strings; found one at line ${lineNumber}.`,\n      );\n    }\n\n    if (line.startsWith('|')) {\n      throw new Error(\n        `runGherkinScenario does not support data tables; found one at line ${lineNumber}.`,\n      );\n    }\n\n    if (unsupportedHeaderPattern.test(line)) {\n      throw new Error(\n        `runGherkinScenario does not support \"${line}\" at line ${lineNumber}.`,\n      );\n    }\n\n    const headerMatch = line.match(headerPattern);\n    if (headerMatch) {\n      scenarioCount += 1;\n      scenario = headerMatch[2].trim() || undefined;\n      section = 'scenario';\n      continue;\n    }\n\n    const stepMatch = line.match(stepKeywordPattern);\n    if (stepMatch) {\n      const step = {\n        keyword: normalizeStepKeyword(stepMatch[1]),\n        text: stepMatch[2].trim(),\n        lineNumber,\n      };\n\n      if (section === 'scenario') {\n        scenarioSteps.push(step);\n      } else {\n        anonymousSteps.push(step);\n      }\n\n      continue;\n    }\n\n    throw new Error(\n      `runGherkinScenario does not support content at line ${lineNumber}: ${line}`,\n    );\n  }\n\n  if (scenarioCount > 1) {\n    throw new Error(\n      `runGherkinScenario expects exactly one Scenario, but found ${scenarioCount}.`,\n    );\n  }\n\n  if (scenarioCount === 1 && anonymousSteps.length > 0) {\n    throw new Error(\n      'runGherkinScenario cannot mix anonymous steps with a Scenario block.',\n    );\n  }\n\n  const rawSteps = scenarioCount === 1 ? scenarioSteps : anonymousSteps;\n\n  if (rawSteps.length === 0) {\n    throw new Error('runGherkinScenario requires at least one Gherkin step.');\n  }\n\n  return {\n    scenario,\n    steps: resolveSteps(rawSteps),\n  };\n};\n\nconst buildStepPrompt = (step: ParsedGherkinStep) => {\n  if (step.effectiveKeyword === 'Given') {\n    return `Set up this precondition: ${step.text}`;\n  }\n\n  if (step.effectiveKeyword === 'When') {\n    return `Perform this user action: ${step.text}`;\n  }\n\n  return `Verify that ${step.text}`;\n};\n\nconst describeStepExecution = (\n  step: ParsedGherkinStep,\n  action: RunGherkinScenarioStepAction,\n) => {\n  const keywordMapping =\n    step.keyword === step.effectiveKeyword\n      ? step.keyword\n      : `${step.keyword} as ${step.effectiveKeyword}`;\n\n  if (step.effectiveKeyword === 'Given') {\n    return `setting up the precondition (${keywordMapping} -> ${action})`;\n  }\n\n  if (step.effectiveKeyword === 'When') {\n    return `performing the user action (${keywordMapping} -> ${action})`;\n  }\n\n  return `verifying the expected result (${keywordMapping} -> ${action})`;\n};\n\nconst describeErrorCause = (error: unknown) => {\n  if (error instanceof Error && error.message) {\n    return ` Original error: ${error.message}`;\n  }\n\n  return '';\n};\n\nexport const runGherkinScenario = async (\n  agent: GherkinScenarioAgent,\n  scenarioText: string,\n  opt?: RunGherkinScenarioOptions,\n): Promise<void> => {\n  const parsedScenario = parseGherkinScenario(scenarioText);\n  const aiActOptions: AiActOptions = {\n    ...opt,\n    cacheable: false,\n  };\n\n  for (const step of parsedScenario.steps) {\n    throwIfAborted(opt?.abortSignal);\n\n    const action: RunGherkinScenarioStepAction =\n      step.effectiveKeyword === 'Then' ? 'aiAssert' : 'aiAct';\n    const prompt = buildStepPrompt(step);\n\n    try {\n      if (action === 'aiAct') {\n        await agent.aiAct(prompt, aiActOptions);\n      } else if (opt?.context || opt?.abortSignal) {\n        await agent.aiAssert(prompt, undefined, {\n          context: opt.context,\n          abortSignal: opt.abortSignal,\n        });\n      } else {\n        await agent.aiAssert(prompt);\n      }\n    } catch (error) {\n      throw new Error(\n        `runGherkinScenario failed while ${describeStepExecution(\n          step,\n          action,\n        )} at line ${step.lineNumber}: ${step.keyword} ${step.text}.${describeErrorCause(\n          error,\n        )}`,\n        {\n          cause: error,\n        },\n      );\n    }\n  }\n};\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","stepKeywordPattern","headerPattern","unsupportedHeaderPattern","normalizeStepKeyword","keyword","lowerKeyword","isPrimaryKeyword","resolveSteps","steps","previousPrimaryKeyword","step","effectiveKeyword","Error","throwIfAborted","abortSignal","parseGherkinScenario","scenarioText","lines","scenarioSteps","anonymousSteps","scenario","scenarioCount","section","lineIndex","rawLine","lineNumber","line","headerMatch","undefined","stepMatch","rawSteps","buildStepPrompt","describeStepExecution","action","keywordMapping","describeErrorCause","error","runGherkinScenario","agent","opt","parsedScenario","aiActOptions","prompt"],"mappings":"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"}
+{"version":3,"file":"agent/run-gherkin-scenario.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/agent/run-gherkin-scenario.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { AiActOptions } from './agent';\n\nexport type GherkinStepKeyword = 'Given' | 'When' | 'Then' | 'And' | 'But';\n\ntype RunGherkinScenarioStepAction = 'aiAct' | 'aiAssert';\n\nexport type RunGherkinScenarioOptions = AiActOptions & {\n  /** Additional AI guidance applied to every step in this scenario run. */\n  context?: string;\n};\n\ntype GherkinPrimaryKeyword = 'Given' | 'When' | 'Then';\n\ntype ParsedGherkinStep = {\n  keyword: GherkinStepKeyword;\n  effectiveKeyword: GherkinPrimaryKeyword;\n  text: string;\n  lineNumber: number;\n};\n\ntype RawGherkinStep = {\n  keyword: GherkinStepKeyword;\n  text: string;\n  lineNumber: number;\n};\n\ntype ParsedGherkinScenario = {\n  scenario?: string;\n  steps: ParsedGherkinStep[];\n};\n\ntype GherkinScenarioAgent = {\n  aiAct: (taskPrompt: string, opt?: AiActOptions) => Promise<unknown>;\n  aiAssert: (\n    assertion: string,\n    msg?: string,\n    opt?: { context?: string; abortSignal?: AbortSignal },\n  ) => Promise<unknown>;\n};\n\nconst stepKeywordPattern = /^(Given|When|Then|And|But)\\s+(.+)$/i;\nconst headerPattern = /^(Scenario):\\s*(.*)$/i;\nconst unsupportedHeaderPattern =\n  /^(Feature|Background|Scenario Outline|Scenario Template|Examples|Rule):/i;\n\nconst normalizeStepKeyword = (keyword: string): GherkinStepKeyword => {\n  const lowerKeyword = keyword.toLowerCase();\n  if (lowerKeyword === 'given') return 'Given';\n  if (lowerKeyword === 'when') return 'When';\n  if (lowerKeyword === 'then') return 'Then';\n  if (lowerKeyword === 'and') return 'And';\n  return 'But';\n};\n\nconst isPrimaryKeyword = (\n  keyword: GherkinStepKeyword,\n): keyword is GherkinPrimaryKeyword => {\n  return keyword === 'Given' || keyword === 'When' || keyword === 'Then';\n};\n\nconst resolveSteps = (steps: RawGherkinStep[]): ParsedGherkinStep[] => {\n  let previousPrimaryKeyword: GherkinPrimaryKeyword | undefined;\n\n  return steps.map((step) => {\n    const effectiveKeyword = isPrimaryKeyword(step.keyword)\n      ? step.keyword\n      : previousPrimaryKeyword;\n\n    if (!effectiveKeyword) {\n      throw new Error(\n        `runGherkinScenario cannot resolve \"${step.keyword}\" at line ${step.lineNumber}; use Given, When, or Then before ${step.keyword}.`,\n      );\n    }\n\n    previousPrimaryKeyword = effectiveKeyword;\n\n    return {\n      ...step,\n      effectiveKeyword,\n    };\n  });\n};\n\nconst throwIfAborted = (abortSignal: AbortSignal | undefined) => {\n  if (!abortSignal?.aborted) {\n    return;\n  }\n\n  if (typeof abortSignal.throwIfAborted === 'function') {\n    abortSignal.throwIfAborted();\n  }\n\n  throw new Error(\n    `runGherkinScenario aborted: ${abortSignal.reason || 'signal already aborted'}`,\n  );\n};\n\nexport const parseGherkinScenario = (\n  scenarioText: string,\n): ParsedGherkinScenario => {\n  const lines = scenarioText.split(/\\r?\\n/);\n  const scenarioSteps: RawGherkinStep[] = [];\n  const anonymousSteps: RawGherkinStep[] = [];\n  let scenario: string | undefined;\n  let scenarioCount = 0;\n  let section: 'prelude' | 'scenario' = 'prelude';\n\n  for (const [lineIndex, rawLine] of lines.entries()) {\n    const lineNumber = lineIndex + 1;\n    const line = rawLine.trim();\n\n    if (!line || line.startsWith('#') || line.startsWith('@')) {\n      continue;\n    }\n\n    if (line === '\"\"\"' || line === \"'''\") {\n      throw new Error(\n        `runGherkinScenario does not support doc strings; found one at line ${lineNumber}.`,\n      );\n    }\n\n    if (line.startsWith('|')) {\n      throw new Error(\n        `runGherkinScenario does not support data tables; found one at line ${lineNumber}.`,\n      );\n    }\n\n    if (unsupportedHeaderPattern.test(line)) {\n      throw new Error(\n        `runGherkinScenario does not support \"${line}\" at line ${lineNumber}.`,\n      );\n    }\n\n    const headerMatch = line.match(headerPattern);\n    if (headerMatch) {\n      scenarioCount += 1;\n      scenario = headerMatch[2].trim() || undefined;\n      section = 'scenario';\n      continue;\n    }\n\n    const stepMatch = line.match(stepKeywordPattern);\n    if (stepMatch) {\n      const step = {\n        keyword: normalizeStepKeyword(stepMatch[1]),\n        text: stepMatch[2].trim(),\n        lineNumber,\n      };\n\n      if (section === 'scenario') {\n        scenarioSteps.push(step);\n      } else {\n        anonymousSteps.push(step);\n      }\n\n      continue;\n    }\n\n    throw new Error(\n      `runGherkinScenario does not support content at line ${lineNumber}: ${line}`,\n    );\n  }\n\n  if (scenarioCount > 1) {\n    throw new Error(\n      `runGherkinScenario expects exactly one Scenario, but found ${scenarioCount}.`,\n    );\n  }\n\n  if (scenarioCount === 1 && anonymousSteps.length > 0) {\n    throw new Error(\n      'runGherkinScenario cannot mix anonymous steps with a Scenario block.',\n    );\n  }\n\n  const rawSteps = scenarioCount === 1 ? scenarioSteps : anonymousSteps;\n\n  if (rawSteps.length === 0) {\n    throw new Error('runGherkinScenario requires at least one Gherkin step.');\n  }\n\n  return {\n    scenario,\n    steps: resolveSteps(rawSteps),\n  };\n};\n\nconst buildStepPrompt = (step: ParsedGherkinStep) => {\n  if (step.effectiveKeyword === 'Given') {\n    return `Set up this precondition: ${step.text}`;\n  }\n\n  if (step.effectiveKeyword === 'When') {\n    return `Perform this user action: ${step.text}`;\n  }\n\n  return `Verify that ${step.text}`;\n};\n\nconst describeStepExecution = (\n  step: ParsedGherkinStep,\n  action: RunGherkinScenarioStepAction,\n) => {\n  const keywordMapping =\n    step.keyword === step.effectiveKeyword\n      ? step.keyword\n      : `${step.keyword} as ${step.effectiveKeyword}`;\n\n  if (step.effectiveKeyword === 'Given') {\n    return `setting up the precondition (${keywordMapping} -> ${action})`;\n  }\n\n  if (step.effectiveKeyword === 'When') {\n    return `performing the user action (${keywordMapping} -> ${action})`;\n  }\n\n  return `verifying the expected result (${keywordMapping} -> ${action})`;\n};\n\nconst describeErrorCause = (error: unknown) => {\n  if (error instanceof Error && error.message) {\n    return ` Original error: ${error.message}`;\n  }\n\n  return '';\n};\n\nexport const runGherkinScenario = async (\n  agent: GherkinScenarioAgent,\n  scenarioText: string,\n  opt?: RunGherkinScenarioOptions,\n): Promise<void> => {\n  const parsedScenario = parseGherkinScenario(scenarioText);\n  const aiActOptions: AiActOptions = {\n    ...opt,\n    cacheable: false,\n  };\n\n  for (const step of parsedScenario.steps) {\n    throwIfAborted(opt?.abortSignal);\n\n    const action: RunGherkinScenarioStepAction =\n      step.effectiveKeyword === 'Then' ? 'aiAssert' : 'aiAct';\n    const prompt = buildStepPrompt(step);\n\n    try {\n      if (action === 'aiAct') {\n        await agent.aiAct(prompt, aiActOptions);\n      } else if (opt?.context !== undefined || opt?.abortSignal) {\n        await agent.aiAssert(prompt, undefined, {\n          context: opt.context,\n          abortSignal: opt.abortSignal,\n        });\n      } else {\n        await agent.aiAssert(prompt);\n      }\n    } catch (error) {\n      throw new Error(\n        `runGherkinScenario failed while ${describeStepExecution(\n          step,\n          action,\n        )} at line ${step.lineNumber}: ${step.keyword} ${step.text}.${describeErrorCause(\n          error,\n        )}`,\n        {\n          cause: error,\n        },\n      );\n    }\n  }\n};\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","stepKeywordPattern","headerPattern","unsupportedHeaderPattern","normalizeStepKeyword","keyword","lowerKeyword","isPrimaryKeyword","resolveSteps","steps","previousPrimaryKeyword","step","effectiveKeyword","Error","throwIfAborted","abortSignal","parseGherkinScenario","scenarioText","lines","scenarioSteps","anonymousSteps","scenario","scenarioCount","section","lineIndex","rawLine","lineNumber","line","headerMatch","undefined","stepMatch","rawSteps","buildStepPrompt","describeStepExecution","action","keywordMapping","describeErrorCause","error","runGherkinScenario","agent","opt","parsedScenario","aiActOptions","prompt"],"mappings":"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"}

package/dist/lib/agent/tasks.js

@@ -42,6 +42,7 @@ const utils_namespaceObject = require("@midscene/shared/utils");
 const external_execution_session_js_namespaceObject = require("./execution-session.js");
 const external_file_chooser_js_namespaceObject = require("./file-chooser.js");
 const external_progress_index_js_namespaceObject = require("./progress/index.js");
+const external_prompt_context_js_namespaceObject = require("./prompt-context.js");
 const external_task_builder_js_namespaceObject = require("./task-builder.js");
 const external_task_timing_js_namespaceObject = require("../task-timing.js");
 const extractor_namespaceObject = require("@midscene/shared/extractor");
@@ -292,7 +293,7 @@ class TaskExecutor {
                         (0, external_task_timing_js_namespaceObject.setTimingFieldOnce)(timing, 'callAiStart');
                         planResult = await planImpl(preparedUserPrompt, {
                             context: planningUiContext,
-                            actionContext: aiActContext,
+                            actionContext: (0, external_prompt_context_js_namespaceObject.renderAIContext)(aiActContext),
                             actionSpace,
                             modelRuntime: planningModel,
                             conversationHistory,