@economic/agents 0.0.1-alpha.4 → 0.0.1-alpha.5

package/dist/index.d.mts

@@ -105,6 +105,14 @@ interface SkillsConfig {
   tools: ToolSet;
   /** All available skills that can be loaded on demand */
   skills: Skill[];
+  /**
+   * The base system prompt for the agent. When provided, createSkills uses
+   * this to compose the full system string (base + guidance) returned by
+   * getSystem() and from prepareStep. Guidance is kept in the system
+   * parameter rather than the messages array — Anthropic/Gemini only allow
+   * system messages at the start of the conversation.
+   */
+  systemPrompt?: string;
   /**
    * Skill names that were loaded in previous turns, read from D1 at turn
    * start. Seeds the in-memory loadedSkills set so prior state is restored
@@ -149,14 +157,17 @@ interface SkillContext {
   /** Currently active tool names — spread into streamText */
   activeTools: string[];
   /**
-   * Updates active tools and the guidance system message before each LLM step.
-   * Spread into streamText.
+   * Updates activeTools before each LLM step. Spread into streamText.
    */
   prepareStep: ai.PrepareStepFunction;
   /**
-   * Conversation messages read from D1 with current skill guidance already
-   * injected just before the last message (the current user turn). Pass
-   * directly as the `messages` param of streamText.
+   * Guidance text from all currently-loaded skills. Compose your system
+   * prompt as: `${myBase}${guidance ? '\n\n' + guidance : ''}`
+   */
+  guidance: string;
+  /**
+   * Plain conversation history from DO SQLite — no guidance injected.
+   * Pass directly as the `messages` param of streamText.
    */
   messages: ai.ModelMessage[];
 }
@@ -169,6 +180,12 @@ interface SkillsResult {
   getLoadedGuidance(): string;
   /** Current loaded skill names */
   getLoadedSkills(): string[];
+  /**
+   * Full system string: base system prompt concatenated with guidance from
+   * all currently-loaded skills. Only meaningful when `systemPrompt` was
+   * passed to createSkills. Use as the `system` param of streamText.
+   */
+  getSystem(): string;
 }
 //#endregion
 //#region src/agents/chat/AIChatAgentBase.d.ts
@@ -331,13 +348,14 @@ declare abstract class AIChatAgentBase<Env extends Cloudflare.Env = Cloudflare.E
   /**
    * Called by the @withSkills decorator at the start of each turn.
    *
-   * Reads loaded skill state from D1, seeds createSkills, injects guidance,
-   * and returns a SkillContext ready to use in a streamText call.
+   * Reads loaded skill state from D1, seeds createSkills, and returns a
+   * SkillContext ready to use in a streamText call.
+   *
+   * Guidance is exposed as `ctx.guidance` — compose your system prompt as:
+   * `${myBase}${ctx.guidance ? '\n\n' + ctx.guidance : ''}`
    *
-   * The returned `messages` already has guidance injected just before the
-   * current user turn — pass it directly as the `messages` param of streamText.
-   * Guidance is never stored in DO SQLite, so loaded_skills in D1 is the
-   * single source of truth for which skills are active.
+   * Messages are plain (no guidance injected). Guidance stays out of the
+   * messages array — Anthropic/Gemini only allow system messages at position 0.
    */
   protected _prepareSkillContext(): Promise<SkillContext>;
 }
@@ -358,10 +376,11 @@ declare abstract class AIChatAgentBase<Env extends Cloudflare.Env = Cloudflare.E
  *   ctx: SkillContext,
  *   options?: OnChatMessageOptions,
  * ) {
- *   const { messages, ...skillArgs } = ctx;
+ *   const { messages, guidance, ...skillArgs } = ctx;
+ *   const base = "Your base prompt";
  *   return streamText({
  *     model: this.getModel(),
- *     system: "Your base prompt — static, never includes guidance",
+ *     system: guidance ? `${base}\n\n${guidance}` : base,
  *     messages,
  *     ...skillArgs,
  *     onFinish,

package/dist/index.mjs

@@ -80,7 +80,11 @@ function createSkills(config) {
 	function getLoadedGuidance() {
 		return [...loadedSkills].map((name) => skillMap.get(name)?.guidance).filter((g) => Boolean(g)).join("\n\n");
 	}
-	let previousGuidance = getLoadedGuidance();
+	function getSystem() {
+		const guidance = getLoadedGuidance();
+		if (!config.systemPrompt) return guidance;
+		return guidance ? `${config.systemPrompt}\n\n${guidance}` : config.systemPrompt;
+	}
 	allTools[ACTIVATE_SKILL] = tool({
 		description: buildActivateSkillDescription(skills),
 		inputSchema: jsonSchema({
@@ -136,13 +140,10 @@ function createSkills(config) {
 			].join("\n");
 		}
 	});
-	const prepareStep = async ({ messages }) => {
-		const guidance = getLoadedGuidance();
-		const updatedMessages = injectGuidance(messages, guidance, previousGuidance);
-		previousGuidance = guidance;
+	const prepareStep = async () => {
 		return {
 			activeTools: getActiveToolNames(),
-			messages: updatedMessages
+			...config.systemPrompt !== void 0 && { system: getSystem() }
 		};
 	};
 	return {
@@ -150,6 +151,7 @@ function createSkills(config) {
 		activeTools: getActiveToolNames(),
 		prepareStep,
 		getLoadedGuidance,
+		getSystem,
 		getLoadedSkills() {
 			return [...loadedSkills];
 		}
@@ -237,13 +239,14 @@ function filterEphemeralMessages(messages, guidanceToStrip) {
 function injectGuidance(messages, guidance, previousGuidance) {
 	if (!guidance) return messages;
 	const base = previousGuidance ? messages.filter((m) => !(m.role === "system" && m.content === previousGuidance)) : messages;
+	const insertAt = base.findLastIndex((m) => m.role === "user");
 	return [
-		...base.slice(0, -1),
+		...base.slice(0, insertAt),
 		{
 			role: "system",
 			content: guidance
 		},
-		base.at(-1)
+		...base.slice(insertAt)
 	];
 }
 //#endregion
@@ -565,13 +568,14 @@ var AIChatAgentBase = class extends AIChatAgent$1 {
 	/**
 	* Called by the @withSkills decorator at the start of each turn.
 	*
-	* Reads loaded skill state from D1, seeds createSkills, injects guidance,
-	* and returns a SkillContext ready to use in a streamText call.
+	* Reads loaded skill state from D1, seeds createSkills, and returns a
+	* SkillContext ready to use in a streamText call.
+	*
+	* Guidance is exposed as `ctx.guidance` — compose your system prompt as:
+	* `${myBase}${ctx.guidance ? '\n\n' + ctx.guidance : ''}`
 	*
-	* The returned `messages` already has guidance injected just before the
-	* current user turn — pass it directly as the `messages` param of streamText.
-	* Guidance is never stored in DO SQLite, so loaded_skills in D1 is the
-	* single source of truth for which skills are active.
+	* Messages are plain (no guidance injected). Guidance stays out of the
+	* messages array — Anthropic/Gemini only allow system messages at position 0.
 	*/
 	async _prepareSkillContext() {
 		const loadedSkills = await this._readSkillState();
@@ -584,13 +588,12 @@ var AIChatAgentBase = class extends AIChatAgent$1 {
 			},
 			filterSkill: (name) => this.filterSkill(name)
 		});
-		const guidance = skills.getLoadedGuidance();
-		const messages = injectGuidance(await convertToModelMessages(this.messages), guidance);
 		return {
 			tools: skills.tools,
 			activeTools: skills.activeTools,
 			prepareStep: skills.prepareStep,
-			messages
+			guidance: skills.getLoadedGuidance(),
+			messages: await convertToModelMessages(this.messages)
 		};
 	}
 };
@@ -648,18 +651,17 @@ var AIChatAgent = class extends AIChatAgentBase {
 		const skills = createSkills({
 			tools: this.getTools(),
 			skills: this.getSkills(),
+			systemPrompt: this.getSystemPrompt(),
 			initialLoadedSkills: loadedSkills,
 			onSkillsChanged: async (updated) => {
 				this._pendingSkills = updated;
 			},
 			filterSkill: (name) => this.filterSkill(name)
 		});
-		const guidance = skills.getLoadedGuidance();
-		const messages = injectGuidance(await convertToModelMessages(this.messages), guidance);
 		return streamText({
 			model: this.getModel(),
-			system: this.getSystemPrompt(),
-			messages,
+			system: skills.getSystem(),
+			messages: await convertToModelMessages(this.messages),
 			tools: skills.tools,
 			activeTools: skills.activeTools,
 			prepareStep: skills.prepareStep,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@economic/agents",
-  "version": "0.0.1-alpha.4",
+  "version": "0.0.1-alpha.5",
   "description": "A starter for creating a TypeScript package.",
   "homepage": "https://github.com/author/library#readme",
   "bugs": {