@google/gemini-cli-core 0.9.0-nightly.20251002.aa8b2abe → 0.9.0-nightly.20251004.7db79e14

package/README.md

@@ -128,7 +128,7 @@ gemini
 
 ```bash
 # Set your Google Cloud Project
-export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_NAME"
+export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
 gemini
 ```
 
@@ -294,6 +294,7 @@ Check our [Official Roadmap](https://github.com/orgs/google-gemini/projects/11)
 ## 📖 Resources
 
 - **[Official Roadmap](./ROADMAP.md)** - See what's coming next.
+- **[Changelog](./docs/changelogs/index.md)** - See recent notable updates.
 - **[NPM Package](https://www.npmjs.com/package/@google/gemini-cli)** - Package registry.
 - **[GitHub Issues](https://github.com/google-gemini/gemini-cli/issues)** - Report bugs or request features.
 - **[Security Advisories](https://github.com/google-gemini/gemini-cli/security/advisories)** - Security updates.

package/dist/index.d.ts

@@ -15,3 +15,5 @@ export { makeFakeConfig } from './src/test-utils/config.js';
 export * from './src/utils/pathReader.js';
 export { ClearcutLogger } from './src/telemetry/clearcut-logger/clearcut-logger.js';
 export { logModelSlashCommand } from './src/telemetry/loggers.js';
+export * from './src/utils/googleQuotaErrors.js';
+export type { GoogleApiError } from './src/utils/googleErrors.js';

package/dist/index.js

@@ -15,4 +15,5 @@ export { makeFakeConfig } from './src/test-utils/config.js';
 export * from './src/utils/pathReader.js';
 export { ClearcutLogger } from './src/telemetry/clearcut-logger/clearcut-logger.js';
 export { logModelSlashCommand } from './src/telemetry/loggers.js';
+export * from './src/utils/googleQuotaErrors.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,GAI1B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,kCAAkC,EAClC,sCAAsC,GACvC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,GAI1B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,kCAAkC,EAClC,sCAAsC,GACvC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,cAAc,kCAAkC,CAAC"}

package/dist/src/agents/codebase-investigator.d.ts

@@ -4,8 +4,43 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { AgentDefinition } from './types.js';
+import { z } from 'zod';
+declare const CodebaseInvestigationReportSchema: z.ZodObject<{
+    SummaryOfFindings: z.ZodString;
+    ExplorationTrace: z.ZodArray<z.ZodString, "many">;
+    RelevantLocations: z.ZodArray<z.ZodObject<{
+        FilePath: z.ZodString;
+        Reasoning: z.ZodString;
+        KeySymbols: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        FilePath: string;
+        Reasoning: string;
+        KeySymbols: string[];
+    }, {
+        FilePath: string;
+        Reasoning: string;
+        KeySymbols: string[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    SummaryOfFindings: string;
+    ExplorationTrace: string[];
+    RelevantLocations: {
+        FilePath: string;
+        Reasoning: string;
+        KeySymbols: string[];
+    }[];
+}, {
+    SummaryOfFindings: string;
+    ExplorationTrace: string[];
+    RelevantLocations: {
+        FilePath: string;
+        Reasoning: string;
+        KeySymbols: string[];
+    }[];
+}>;
 /**
  * A Proof-of-Concept subagent specialized in analyzing codebase structure,
  * dependencies, and technologies.
  */
-export declare const CodebaseInvestigatorAgent: AgentDefinition;
+export declare const CodebaseInvestigatorAgent: AgentDefinition<typeof CodebaseInvestigationReportSchema>;
+export {};

package/dist/src/agents/codebase-investigator.js

@@ -8,50 +8,23 @@ import { ReadFileTool } from '../tools/read-file.js';
 import { GLOB_TOOL_NAME } from '../tools/tool-names.js';
 import { GrepTool } from '../tools/grep.js';
 import { DEFAULT_GEMINI_MODEL } from '../config/models.js';
-const CODEBASE_REPORT_MARKDOWN = `<CodebaseReport>
-  <SummaryOfFindings>
-    The user's objective is to remove an optional \`config\` property from the command context. The investigation identified that the \`CommandContext\` interface, defined in \`packages/cli/src/ui/commands/types.ts\`, contains a nullable \`config: Config | null\` property. A \`TODO\` comment confirms the intent to make this property non-nullable.
-    The primary challenge is that numerous tests throughout the codebase rely on this property being optional, often setting it to \`null\` during the creation of mock \`CommandContext\` objects. The key to resolving this is to update the mock creation utility, \`createMockCommandContext\`, to provide a default mock \`Config\` object instead of \`null\`.
-    The \`Config\` class, defined in \`packages/core/src/config/config.ts\`, is the type of the \`config\` property. To facilitate the required changes, a mock \`Config\` object can be created based on the \`ConfigParameters\` interface from the same file.
-    The plan involves three main steps:
-    1.  Update the \`CommandContext\` interface to make the \`config\` property non-nullable.
-    2.  Modify \`createMockCommandContext\` to use a default mock \`Config\` object.
-    3.  Update all test files that currently rely on a null \`config\` to use the updated mock creation utility.
-  </SummaryOfFindings>
-  <ExplorationTrace>
-    1.  Searched for "CommandContext" to locate its definition.
-    2.  Read \`packages/cli/src/ui/commands/types.ts\` and identified the \`config: Config | null\` property.
-    3.  Searched for \`config: null\` to find all instances where the config is explicitly set to null.
-    4.  Read \`packages/cli/src/test-utils/mockCommandContext.ts\` to understand how mock contexts are created.
-    5.  Searched for \`createMockCommandContext\` to find all its usages.
-    6.  Searched for the definition of the \`Config\` interface to understand how to create a mock object.
-    7.  Read \`packages/core/src/config/config.ts\` to understand the \`Config\` class and \`ConfigParameters\` interface.
-  </ExplorationTrace>
-  <RelevantLocations>
-    <Location>
-      <FilePath>packages/cli/src/ui/commands/types.ts</FilePath>
-      <Reasoning>This file contains the definition of the \`CommandContext\` interface, which is the central piece of this investigation. The property \`config: Config | null\` needs to be changed to \`config: Config\` here.</Reasoning>
-      <KeySymbols>
-        <Symbol>CommandContext</Symbol>
-      </KeySymbols>
-    </Location>
-    <Location>
-      <FilePath>packages/cli/src/test-utils/mockCommandContext.ts</FilePath>
-      <Reasoning>This file contains the \`createMockCommandContext\` function, which is used in many tests to create mock \`CommandContext\` objects. This function needs to be updated to provide a default mock \`Config\` object instead of \`null\`.</Reasoning>
-      <KeySymbols>
-        <Symbol>createMockCommandContext</Symbol>
-      </KeySymbols>
-    </Location>
-    <Location>
-      <FilePath>packages/core/src/config/config.ts</FilePath>
-      <Reasoning>This file defines the \`Config\` class and the \`ConfigParameters\` interface. This information is needed to create a proper mock \`Config\` object to be used in the updated \`createMockCommandContext\` function.</Reasoning>
-      <KeySymbols>
-        <Symbol>Config</Symbol>
-        <Symbol>ConfigParameters</Symbol>
-      </KeySymbols>
-    </Location>
-  </RelevantLocations>
-</CodebaseReport>`;
+import { z } from 'zod';
+// Define a type that matches the outputConfig schema for type safety.
+const CodebaseInvestigationReportSchema = z.object({
+    SummaryOfFindings: z
+        .string()
+        .describe("A summary of the investigation's conclusions and insights for the main agent."),
+    ExplorationTrace: z
+        .array(z.string())
+        .describe('A step-by-step list of actions and tools used during the investigation.'),
+    RelevantLocations: z
+        .array(z.object({
+        FilePath: z.string(),
+        Reasoning: z.string(),
+        KeySymbols: z.array(z.string()),
+    }))
+        .describe('A list of relevant files and the key symbols within them.'),
+});
 /**
  * A Proof-of-Concept subagent specialized in analyzing codebase structure,
  * dependencies, and technologies.
@@ -59,9 +32,10 @@ const CODEBASE_REPORT_MARKDOWN = `<CodebaseReport>
 export const CodebaseInvestigatorAgent = {
     name: 'codebase_investigator',
     displayName: 'Codebase Investigator Agent',
-    description: `Invoke this agent to delegates complex codebase exploration to an autonomous subagent. 
-    Use for vague user requests that require searching multiple files to understand a feature or find context. 
-    Returns a structured xml report with key file paths, symbols, architectural map and insights to solve a task.`,
+    description: `Your primary tool for multifile search tasks and codebase exploration. 
+    Invoke this tool to delegate search tasks to an autonomous subagent. 
+    Use this to find features, understand context, or locate specific files, functions, or symbols. 
+    Returns a structured Json report with key file paths, symbols, architectural map and insights to solve a task or answer questions`,
     inputConfig: {
         inputs: {
             objective: {
@@ -73,18 +47,12 @@ export const CodebaseInvestigatorAgent = {
         },
     },
     outputConfig: {
-        description: `A detailed markdown report summarizing the findings of the codebase investigation and insights that are the foundation for planning and executing any code modification related to the objective.
-      # Report Format
-The final report should be structured markdown, clearly answering the investigation focus, citing the files, symbols, architectural patterns and how they relate to the given investigation focus.
-The report should strictly follow a format like this example: 
-${CODEBASE_REPORT_MARKDOWN}
-`,
-        completion_criteria: [
-            'The report must directly address the initial `objective`.',
-            'Cite specific files, functions, or configuration snippets and symbols as evidence for your findings.',
-            'Conclude with a xml markdown summary of the key files, symbols, technologies, architectural patterns, and conventions discovered.',
-        ],
+        outputName: 'report',
+        description: 'The final investigation report as a JSON object.',
+        schema: CodebaseInvestigationReportSchema,
     },
+    // The 'output' parameter is now strongly typed as CodebaseInvestigationReportSchema
+    processOutput: (output) => JSON.stringify(output, null, 2),
     modelConfig: {
         model: DEFAULT_GEMINI_MODEL,
         temp: 0.1,
@@ -127,37 +95,41 @@ You operate in a non-interactive loop and must reason based on the information p
 **This is your most critical function. Your scratchpad is your memory and your plan.**
 1.  **Initialization:** On your very first turn, you **MUST** create the \`<scratchpad>\` section. Analyze the \`task\` and create an initial \`Checklist\` of investigation goals and a \`Questions to Resolve\` section for any initial uncertainties.
 2.  **Constant Updates:** After **every** \`<OBSERVATION>\`, you **MUST** update the scratchpad.
-    *   Mark checklist items as complete: \`[x]\`.
-    *   Add new checklist items as you trace the architecture.
-    *   **Explicitly log questions in \`Questions to Resolve\`** (e.g., \`[ ] What is the purpose of the 'None' element in this list?\`). Do not consider your investigation complete until this list is empty.
-    *   Record \`Key Findings\` with file paths and notes about their purpose and relevance.
-    *   Update \`Irrelevant Paths to Ignore\` to avoid re-investigating dead ends.
+    * Mark checklist items as complete: \`[x]\`.
+    * Add new checklist items as you trace the architecture.
+    * **Explicitly log questions in \`Questions to Resolve\`** (e.g., \`[ ] What is the purpose of the 'None' element in this list?\`). Do not consider your investigation complete until this list is empty.
+    * Record \`Key Findings\` with file paths and notes about their purpose and relevance.
+    * Update \`Irrelevant Paths to Ignore\` to avoid re-investigating dead ends.
 3.  **Thinking on Paper:** The scratchpad must show your reasoning process, including how you resolve your questions.
 ---
-## Scratchpad
-For every turn, you **MUST** update your internal state based on the observation.
-Scratchpad example:
-<SCRATCHPAD>
-**Checklist:**
-- [x] Find the main translation loading logic.
-- [ ] **(New)** Investigate the \`gettext.translation\` function to understand its arguments.
-- [ ] **(New)** Check the signature of \`locale.init\` and its callers for type consistency.
-**Questions to Resolve:**
-- [x] ~~What is the purpose of the 'None' element in the \`locale_dirs\` list?~~ **Finding:** It's for system-wide gettext catalogs.
-**Key Findings:**
-- \`sphinx/application.py\`: Assembles the \`locale_dirs\` list. The order is critical.
-- \`sphinx/locale/__init__.py\`: Consumes \`locale_dirs\`. Its \`init\` function signature might need a type hint update if \`None\` is passed.
-**Irrelevant Paths to Ignore:**
-- \`README.md\`
-**Next Step:**
-- I will use \`web_fetch\` to search for "python gettext translation localedir None" to resolve my open question.
-</SCRATCHPAD>
 ## Termination
-Your mission is complete **ONLY** when your \`Questions to Resolve\` list is empty and you are confident you have identified all files and necessary change *considerations*.
-# Report Format
-The final report should be structured markdown, clearly answering the investigation focus, citing the files, symbols, architectural patterns and how they relate to the given investigation focus.
-The report should strictly follow a format like this example: 
-${CODEBASE_REPORT_MARKDOWN}
+Your mission is complete **ONLY** when your \`Questions to Resolve\` list is empty and you have identified all files and necessary change *considerations*.
+When you are finished, you **MUST** call the \`complete_task\` tool. The \`report\` argument for this tool **MUST** be a valid JSON object containing your findings.
+
+**Example of the final report**
+\`\`\`json
+{
+  "SummaryOfFindings": "The core issue is a race condition in the \`updateUser\` function. The function reads the user's state, performs an asynchronous operation, and then writes the state back. If another request modifies the user state during the async operation, that change will be overwritten. The fix requires implementing a transactional read-modify-write pattern, potentially using a database lock or a versioning system.",
+  "ExplorationTrace": [
+    "Used \`grep\` to search for \`updateUser\` to locate the primary function.",
+    "Read the file \`src/controllers/userController.js\` to understand the function's logic.",
+    "Used \`ls -R\` to look for related files, such as services or database models.",
+    "Read \`src/services/userService.js\` and \`src/models/User.js\` to understand the data flow and how state is managed."
+  ],
+  "RelevantLocations": [
+    {
+      "FilePath": "src/controllers/userController.js",
+      "Reasoning": "This file contains the \`updateUser\` function which has the race condition. It's the entry point for the problematic logic.",
+      "KeySymbols": ["updateUser", "getUser", "saveUser"]
+    },
+    {
+      "FilePath": "src/services/userService.js",
+      "Reasoning": "This service is called by the controller and handles the direct interaction with the data layer. Any locking mechanism would likely be implemented here.",
+      "KeySymbols": ["updateUserData"]
+    }
+  ]
+}
+\`\`\`
 `,
     },
 };

package/dist/src/agents/codebase-investigator.js.map

@@ -1 +1 @@
-{"version":3,"file":"codebase-investigator.js","sourceRoot":"","sources":["../../../src/agents/codebase-investigator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2Cf,CAAC;AAEnB;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,6BAA6B;IAC1C,WAAW,EAAE;;kHAEmG;IAChH,WAAW,EAAE;QACX,MAAM,EAAE;YACN,SAAS,EAAE;gBACT,WAAW,EAAE;4HACuG;gBACpH,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD,YAAY,EAAE;QACZ,WAAW,EAAE;;;;EAIf,wBAAwB;CACzB;QACG,mBAAmB,EAAE;YACnB,2DAA2D;YAC3D,sGAAsG;YACtG,mIAAmI;SACpI;KACF;IAED,WAAW,EAAE;QACX,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,CAAC,CAAC;KACnB;IAED,SAAS,EAAE;QACT,gBAAgB,EAAE,CAAC;QACnB,SAAS,EAAE,EAAE;KACd;IAED,UAAU,EAAE;QACV,wCAAwC;QACxC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC;KACvE;IAED,YAAY,EAAE;QACZ,KAAK,EAAE;;;aAGE;QACT,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDhB,wBAAwB;CACzB;KACE;CACF,CAAC"}
+{"version":3,"file":"codebase-investigator.js","sourceRoot":"","sources":["../../../src/agents/codebase-investigator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sEAAsE;AACtE,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,CACP,+EAA+E,CAChF;IACH,gBAAgB,EAAE,CAAC;SAChB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CACP,yEAAyE,CAC1E;IACH,iBAAiB,EAAE,CAAC;SACjB,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAChC,CAAC,CACH;SACA,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAElC;IACF,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,6BAA6B;IAC1C,WAAW,EAAE;;;sIAGuH;IACpI,WAAW,EAAE;QACX,MAAM,EAAE;YACN,SAAS,EAAE;gBACT,WAAW,EAAE;4HACuG;gBACpH,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,kDAAkD;QAC/D,MAAM,EAAE,iCAAiC;KAC1C;IAED,oFAAoF;IACpF,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,WAAW,EAAE;QACX,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,CAAC,CAAC;KACnB;IAED,SAAS,EAAE;QACT,gBAAgB,EAAE,CAAC;QACnB,SAAS,EAAE,EAAE;KACd;IAED,UAAU,EAAE;QACV,wCAAwC;QACxC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC;KACvE;IAED,YAAY,EAAE;QACZ,KAAK,EAAE;;;aAGE;QACT,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DjB;KACE;CACF,CAAC"}

package/dist/src/agents/executor.d.ts

@@ -5,19 +5,17 @@
  */
 import type { Config } from '../config/config.js';
 import type { AgentDefinition, AgentInputs, OutputObject, SubagentActivityEvent } from './types.js';
+import { type z } from 'zod';
 /** A callback function to report on agent activity. */
 export type ActivityCallback = (activity: SubagentActivityEvent) => void;
 /**
  * Executes an agent loop based on an {@link AgentDefinition}.
  *
- * This executor uses a simplified two-phase approach:
- * 1.  **Work Phase:** The agent runs in a loop, calling tools until it has
- * gathered all necessary information to fulfill its goal.
- * 2.  **Extraction Phase:** A final prompt is sent to the model to summarize
- * the work and extract the final result in the desired format.
+ * This executor runs the agent in a loop, calling tools until it calls the
+ * mandatory `complete_task` tool to signal completion.
  */
-export declare class AgentExecutor {
-    readonly definition: AgentDefinition;
+export declare class AgentExecutor<TOutput extends z.ZodTypeAny> {
+    readonly definition: AgentDefinition<TOutput>;
     private readonly agentId;
     private readonly toolRegistry;
     private readonly runtimeContext;
@@ -33,7 +31,7 @@ export declare class AgentExecutor {
      * @param onActivity An optional callback to receive activity events.
      * @returns A promise that resolves to a new `AgentExecutor` instance.
      */
-    static create(definition: AgentDefinition, runtimeContext: Config, onActivity?: ActivityCallback): Promise<AgentExecutor>;
+    static create<TOutput extends z.ZodTypeAny>(definition: AgentDefinition<TOutput>, runtimeContext: Config, onActivity?: ActivityCallback): Promise<AgentExecutor<TOutput>>;
     /**
      * Constructs a new AgentExecutor instance.
      *
@@ -60,7 +58,7 @@ export declare class AgentExecutor {
     /**
      * Executes function calls requested by the model and returns the results.
      *
-     * @returns A new `Content` object to be added to the chat history.
+     * @returns A new `Content` object for history, any submitted output, and completion status.
      */
     private processFunctionCalls;
     /**
@@ -69,8 +67,6 @@ export declare class AgentExecutor {
     private prepareToolsList;
     /** Builds the system prompt from the agent definition and inputs. */
     private buildSystemPrompt;
-    /** Builds the final message for the extraction phase. */
-    private buildExtractionMessage;
     /**
      * Applies template strings to initial messages.
      *