@economic/agents 2.3.27 → 2.5.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
@@ -263,6 +286,7 @@ type Chat = {
   durable_object_name: string;
   title?: string;
   summary?: string;
+  title_set_by_user: number;
   created_at: number;
   updated_at: number;
   positive_feedback_count: number;
@@ -279,6 +303,7 @@ declare abstract class Assistant<State = unknown> extends Agent$1<Cloudflare.Env
   onConnect(connection: Connection, ctx: ConnectionContext): Promise<void>;
   createChat(): Promise<string>;
   deleteChat(id: string): Promise<void>;
+  renameChat(id: string, title: string): Promise<void>;
   getChats(): Promise<Chat[]>;
   getChatAgentClassName(): Promise<string>;
   recordChatTurn(durableObjectName: string, messages: UIMessage[]): Promise<void>;
@@ -340,4 +365,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);
@@ -459,6 +504,7 @@ function ensureChatsTableExists(sql) {
         durable_object_name TEXT NOT NULL,
         title               TEXT,
         summary             TEXT,
+        title_set_by_user   INTEGER NOT NULL DEFAULT 0,
         created_at          INTEGER NOT NULL,
         updated_at          INTEGER NOT NULL,
         positive_feedback_count INTEGER NOT NULL DEFAULT 0,
@@ -466,6 +512,7 @@ function ensureChatsTableExists(sql) {
         PRIMARY KEY (durable_object_name)
       )`;
 		ensureChatsFeedbackColumnsExist(sql);
+		ensureChatsTitleSetByUserColumnExists(sql);
 		ensureChatMessageFeedbackTableExists(sql);
 	} catch (error) {
 		console.error("[Agent] Failed to create chats table", error);
@@ -479,6 +526,11 @@ function ensureChatsFeedbackColumnsExist(sql) {
 		sql`ALTER TABLE chats ADD COLUMN negative_feedback_count INTEGER NOT NULL DEFAULT 0`;
 	} catch {}
 }
+function ensureChatsTitleSetByUserColumnExists(sql) {
+	try {
+		sql`ALTER TABLE chats ADD COLUMN title_set_by_user INTEGER NOT NULL DEFAULT 0`;
+	} catch {}
+}
 function ensureChatMessageFeedbackTableExists(sql) {
 	sql`CREATE TABLE IF NOT EXISTS chat_message_feedback (
       chat_id    TEXT NOT NULL,
@@ -507,6 +559,19 @@ function registerChatWithMetadata(sql, durableObjectName, metadata) {
     VALUES (${durableObjectName}, ${title ?? null}, ${summary ?? null}, ${createdAt}, ${updatedAt})
     ON CONFLICT (durable_object_name) DO NOTHING`;
 }
+/**
+* Sets a chat's title on the user's behalf. Marks the title as user-set so
+* the AI summariser stops overwriting it (it keeps updating the summary).
+*/
+function renameChat(sql, durableObjectName, title, dateTime = Date.now()) {
+	const trimmed = title.trim();
+	if (!trimmed) throw new Error("Chat title cannot be empty");
+	sql`UPDATE chats
+    SET title = ${trimmed},
+        title_set_by_user = 1,
+        updated_at = ${dateTime}
+    WHERE durable_object_name = ${durableObjectName}`;
+}
 function deleteChat(sql, durableObjectName) {
 	sql`DELETE FROM chats WHERE durable_object_name = ${durableObjectName}`;
 	sql`DELETE FROM chat_message_feedback WHERE chat_id = ${durableObjectName}`;
@@ -578,7 +643,7 @@ async function summariseChatWithAI(sql, durableObjectName, messages, model) {
 			return;
 		}
 		sql`UPDATE chats
-      SET title = ${title},
+      SET title = CASE WHEN title_set_by_user = 1 THEN title ELSE ${title} END,
           summary = ${summary},
           updated_at = ${Date.now()}
       WHERE durable_object_name = ${durableObjectName}`;
@@ -825,6 +890,11 @@ var Assistant = class extends Agent$1 {
 				2,
 				"deleteChat"
 			],
+			[
+				callable(),
+				2,
+				"renameChat"
+			],
 			[
 				callable(),
 				2,
@@ -888,6 +958,9 @@ var Assistant = class extends Agent$1 {
 		await this.deleteSubAgent(this.agent, id);
 		deleteChat(this.sql.bind(this), id);
 	}
+	async renameChat(id, title) {
+		renameChat(this.sql.bind(this), id, title);
+	}
 	async getChats() {
 		return getChats(this.sql.bind(this));
 	}

package/package.json

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