@economic/agents 0.0.1-beta.2 → 0.0.1-beta.3

package/dist/index.d.mts

@@ -16,8 +16,9 @@ interface Skill {
   description: string;
   /**
    * Guidance text for this skill — e.g. rate limits, preferred patterns,
-   * when to use each tool. Appended to the `system` prompt each turn for any
-   * skill that is loaded, keeping `system` mostly cacheable.
+   * when to use each tool. Injected into the `## Tools` section of the
+   * system prompt via `buildSystemPrompt` in `llm.ts` whenever this skill
+   * is loaded.
    */
   guidance?: string;
   tools: ToolSet;

package/dist/index.mjs

@@ -40,12 +40,7 @@ function buildActivateSkillDescription(skills) {
 	].join("\n");
 }
 function buildAvailableSkillList(skills) {
-	return [
-		"**Loading More Tools:**",
-		"Use `activate_skill` to load these categories (BE PROACTIVE on requesting tools based on the user's request AND you DON'T need to mention that you are loading more tools):",
-		"",
-		skills.map((s) => `**${s.name}**: ${s.description}`).join("\n")
-	].join("\n");
+	return skills.map((s) => `**${s.name}**: ${s.description}`).join("\n");
 }
 const LIST_CAPABILITIES_DESCRIPTION = "List all tools currently available to you, which skills are loaded, and which can still be loaded. Call this when the user asks about your capabilities or what you can do.";
 /**
@@ -95,20 +90,7 @@ function createSkills(config) {
 			return [`**${skill.name}**\n${skill.guidance}`];
 		});
 		if (sections.length === 0) return "";
-		return [
-			"**Loaded skill instructions**",
-			"The following skills are currently active. Apply their instructions when using the corresponding tools.",
-			"",
-			sections.join("\n\n")
-		].join("\n");
-	}
-	function getSystem() {
-		const guidance = getLoadedGuidance();
-		return [
-			config.systemPrompt,
-			availableSkillList,
-			guidance
-		].filter(Boolean).join("\n\n");
+		return sections.join("\n\n");
 	}
 	allTools[ACTIVATE_SKILL] = tool({
 		description: buildActivateSkillDescription(skills),
@@ -155,17 +137,14 @@ function createSkills(config) {
 		}
 	});
 	const prepareStep = async () => {
-		return {
-			activeTools: getActiveToolNames(),
-			...config.systemPrompt !== void 0 && { system: getSystem() }
-		};
+		return { activeTools: getActiveToolNames() };
 	};
 	return {
 		tools: allTools,
 		activeTools: getActiveToolNames(),
 		prepareStep,
+		availableSkillList,
 		getLoadedGuidance,
-		getSystem,
 		getLoadedSkills() {
 			return [...loadedSkills];
 		}
@@ -304,6 +283,47 @@ async function compactIfNeeded(messages, model, tailSize) {
 //#endregion
 //#region src/server/llm.ts
 /**
+* Composes the full system prompt from its three parts: the consumer's base
+* string, the static skill roster, and the dynamic loaded-skill guidance.
+*
+* The full shape, at a glance:
+*
+*   {base}
+*
+*   ## Tools
+*
+*   Use `activate_skill` to load these skills (BE PROACTIVE on requesting
+*   tools based on the user's request AND you DON'T need to mention that you
+*   are loading more tools):
+*
+*   **{name}**: {description}
+*   ...
+*
+*   **Loaded skill instructions**
+*   The following skills are currently active. Apply their instructions when
+*   using the corresponding tools.
+*
+*   **{name}**
+*   {guidance body}
+*/
+function buildSystemPrompt(basePrompt, availableSkillList, loadedGuidance) {
+	let prompt = `${basePrompt}
+
+## Tools
+
+### Loading More Tools:
+Use \`activate_skill\` to load these skills (BE PROACTIVE on requesting tools based on the user's request AND you DON'T need to mention that you are loading more tools):
+
+${availableSkillList}`;
+	if (loadedGuidance) prompt += `
+
+### Loaded skill instructions:
+The following skills are currently active. Apply their instructions when using the corresponding tools.
+
+${loadedGuidance}`;
+	return prompt.trim();
+}
+/**
 * Builds the parameter object for a Vercel AI SDK `streamText` or `generateText` call.
 *
 * Handles message conversion, optional compaction, skill wiring (`activate_skill`,
@@ -329,22 +349,21 @@ async function buildLLMParams(config) {
 		stopWhen: rest.stopWhen ?? stepCountIs(20)
 	};
 	if (!skills?.length) return baseParams;
+	const base = typeof rest.system === "string" ? rest.system : void 0;
 	const skillsCtx = createSkills({
 		tools: rest.tools ?? {},
 		skills,
-		initialLoadedSkills: activeSkills,
-		systemPrompt: typeof rest.system === "string" ? rest.system : void 0
+		initialLoadedSkills: activeSkills
 	});
 	const prepareStep = async (stepOptions) => {
-		const skillsResult = await skillsCtx.prepareStep(stepOptions) ?? {};
 		return {
-			activeTools: skillsResult.activeTools ?? [],
-			system: skillsResult.system
+			activeTools: (await skillsCtx.prepareStep(stepOptions) ?? {}).activeTools ?? [],
+			system: buildSystemPrompt(base, skillsCtx.availableSkillList, skillsCtx.getLoadedGuidance())
 		};
 	};
 	return {
 		...baseParams,
-		system: skillsCtx.getSystem() || rest.system,
+		system: buildSystemPrompt(base, skillsCtx.availableSkillList, skillsCtx.getLoadedGuidance()),
 		tools: skillsCtx.tools,
 		activeTools: skillsCtx.activeTools,
 		prepareStep

package/package.json

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