@economic/agents 2.3.27 → 2.4.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { n as JwtAuthConfig, t as routeAgentRequest } from "./route-agent-request-D2ll--nF.mjs";
 import { Agent as Agent$1, Connection, ConnectionContext, SubAgentClass } from "agents";
 import { ChatResponseResult, PrepareStepContext, Session, Think, ToolCallContext, ToolCallDecision, TurnConfig, TurnContext, skills } from "@cloudflare/think";
-import { JSONValue, LanguageModel, Tool as Tool$1, UIMessage } from "ai";
+import { JSONValue, LanguageModel, ModelMessage, Tool as Tool$1, UIMessage } from "ai";
 import { createCompactFunction } from "agents/experimental/memory/utils";
 import { SkillSource as SkillSource$1 } from "agents/skills";
 
@@ -34,6 +34,15 @@ type Tool<Context extends Record<string, unknown> = Record<string, unknown>, INP
 declare function tool<Context extends Record<string, unknown> = Record<string, unknown>, INPUT extends JSONValue | unknown | never = any, OUTPUT extends JSONValue | unknown | never = any>(tool: Tool<Context, INPUT, OUTPUT>): Tool$1<INPUT, OUTPUT>;
 //#endregion
 //#region src/server/agents/Agent.d.ts
+/** What the model would see on its next step — returned by {@link Agent.inspectTurn}. */
+interface TurnSnapshot {
+  system: string;
+  tools: ToolSet;
+  activeTools: string[];
+  /** Tools provided by the framework (session/skill meta-tools, MCP), not the agent. */
+  frameworkToolNames: string[];
+  messages: ModelMessage[];
+}
 declare abstract class Agent<RequestContext extends Record<string, unknown> = Record<string, unknown>, UserContext extends Record<string, unknown> = Record<string, unknown>, State = unknown> extends Think<Cloudflare.Env & AgentEnv, State> {
   protected agentType: AgentConnectionType;
   protected clientIp?: string;
@@ -75,6 +84,19 @@ declare abstract class Agent<RequestContext extends Record<string, unknown> = Re
   }>;
   beforeToolCall(ctx: ToolCallContext): Promise<ToolCallDecision | void>;
   getTools(): ToolSet;
+  /**
+   * Read-only: what the model would see on its next step for the given history
+   * — the assembled system prompt, the skill-gated toolset, and pruned
+   * messages. Runs no turn (nothing admitted, persisted, executed; no model
+   * call). Skill gating is derived from the history, so a history with an
+   * `activate_skill` call yields that skill's tools. For eval harnesses and
+   * prompt-preview tooling; call it inside the DO context.
+   */
+  inspectTurn(input?: {
+    messages?: ModelMessage[];
+    requestContext?: RequestContext;
+    userContext?: UserContext;
+  }): Promise<TurnSnapshot>;
   workspaceBash: boolean;
   getSkillScriptRunner(): skills.SkillScriptRunner | null;
   /**
@@ -82,6 +104,7 @@ declare abstract class Agent<RequestContext extends Record<string, unknown> = Re
    * @returns The remote skills to be loaded from SKILLS_BUCKET.
    */
   protected getRemoteSkills(): string[];
+  private _pruneTurnMessages;
   private _getAuthorizedTools;
   /**
    * Wrap each tool's `execute` so it falls back to the current turn's tool
@@ -340,4 +363,4 @@ declare function skill<Context extends Record<string, unknown> = Record<string,
 //#region src/server/index.d.ts
 declare function getCurrentToolContext(): any;
 //#endregion
-export { Agent, type AgentConnectionStatus, type AgentConnectionType, type AgentEnv, Assistant, ChatAgent, type FacetStub, type LegacyChatStub, type LegacyMessageFeedback, type MigrationDeps, type Skill, type SkillSource, type Tool, type ToolContext, type ToolSet, getCurrentToolContext, migrateUserFromV1, routeAgentRequest, skill, tool };
+export { Agent, type AgentConnectionStatus, type AgentConnectionType, type AgentEnv, Assistant, ChatAgent, type FacetStub, type LegacyChatStub, type LegacyMessageFeedback, type MigrationDeps, type Skill, type SkillSource, type Tool, type ToolContext, type ToolSet, type TurnSnapshot, getCurrentToolContext, migrateUserFromV1, routeAgentRequest, skill, tool };

package/dist/index.mjs

@@ -238,16 +238,7 @@ var Agent = class extends Think {
 		return {
 			system: await this.session.refreshSystemPrompt(),
 			model: this.getModel(this._toolContextForCurrentTurn),
-			messages: pruneMessages({
-				messages: ctx.messages,
-				toolCalls: [{
-					type: "before-last-2-messages",
-					tools: []
-				}, {
-					type: "before-last-5-messages",
-					tools: ["activate_skill"]
-				}]
-			}),
+			messages: this._pruneTurnMessages(ctx.messages),
 			tools: this._withTurnContextFallback(tools),
 			activeTools,
 			experimental_transform: buildSourcesTransform(),
@@ -301,6 +292,48 @@ var Agent = class extends Think {
 	getTools() {
 		return {};
 	}
+	/**
+	* Read-only: what the model would see on its next step for the given history
+	* — the assembled system prompt, the skill-gated toolset, and pruned
+	* messages. Runs no turn (nothing admitted, persisted, executed; no model
+	* call). Skill gating is derived from the history, so a history with an
+	* `activate_skill` call yields that skill's tools. For eval harnesses and
+	* prompt-preview tooling; call it inside the DO context.
+	*/
+	async inspectTurn(input = {}) {
+		const messages = input.messages ?? [];
+		await this.__unsafe_ensureInitialized();
+		const previousContext = this._toolContextForCurrentTurn;
+		this._toolContextForCurrentTurn = {
+			...input.requestContext ?? {},
+			_userContext: input.userContext
+		};
+		const previousAuthorizedTools = this._authorizedToolsForCurrentTurn;
+		try {
+			const system = await this.session.refreshSystemPrompt();
+			const think = this;
+			const frameworkTools = {
+				...await this.session.tools(),
+				...think._skillRegistry?.tools(),
+				...think.mcp?.getAITools?.()
+			};
+			const { tools, activeTools } = await this._getAuthorizedTools({
+				...this.getTools(),
+				...frameworkTools
+			}, this._getLastActivatedSkillName(messages));
+			const snapshotContext = this._toolContextForCurrentTurn;
+			return {
+				system,
+				tools: withFallbackToolContext(tools, () => snapshotContext),
+				activeTools,
+				frameworkToolNames: Object.keys(frameworkTools),
+				messages: this._pruneTurnMessages(messages)
+			};
+		} finally {
+			this._toolContextForCurrentTurn = previousContext;
+			this._authorizedToolsForCurrentTurn = previousAuthorizedTools;
+		}
+	}
 	workspaceBash = false;
 	getSkillScriptRunner() {
 		if (!("LOADER" in this.env)) return null;
@@ -313,6 +346,18 @@ var Agent = class extends Think {
 	getRemoteSkills() {
 		return [];
 	}
+	_pruneTurnMessages(messages) {
+		return pruneMessages({
+			messages,
+			toolCalls: [{
+				type: "before-last-2-messages",
+				tools: []
+			}, {
+				type: "before-last-5-messages",
+				tools: ["activate_skill"]
+			}]
+		});
+	}
 	async _getAuthorizedTools(availableTools, activeSkillName) {
 		const tools = { ...availableTools };
 		const activeTools = Object.keys(tools);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@economic/agents",
-  "version": "2.3.27",
+  "version": "2.4.0",
   "description": "A starter for creating a TypeScript package.",
   "license": "MIT",
   "files": [