@compilr-dev/sdk 0.20.3 → 0.21.0

package/dist/team/team-agent.d.ts

@@ -31,6 +31,8 @@ export interface TeamAgentUpdate {
     mascot?: MascotExpression;
     description?: string;
     systemPromptAddition?: string;
+    /** Tone only. Composed into the prompt at build time — see `TeamAgent.personality`. */
+    personality?: string;
     toolProfile?: TeamAgentConfig['toolProfile'];
     toolFilter?: string[];
     enabledSkills?: string[];
@@ -149,6 +151,16 @@ export declare class TeamAgent {
      * Enabled skills (empty = all skills)
      */
     enabledSkills?: string[];
+    /**
+     * How the agent should sound. Tone only — never capability.
+     *
+     * ⚠️ COMPOSED AT `initialize()`, NEVER STORED INSIDE `systemPromptAddition`. Baking it in
+     * at write time is what leaves a stale sentence behind after an edit — the same defect the
+     * custom-agent path has, where a display name rendered once at creation survives every
+     * later rename. Composing it on each build means it cannot go stale, and editing your
+     * instructions cannot silently delete it.
+     */
+    personality?: string;
     /**
      * Auto-approve handoffs from this agent without user confirmation
      */

package/dist/team/team-agent.js

@@ -149,6 +149,16 @@ export class TeamAgent {
      * Enabled skills (empty = all skills)
      */
     enabledSkills;
+    /**
+     * How the agent should sound. Tone only — never capability.
+     *
+     * ⚠️ COMPOSED AT `initialize()`, NEVER STORED INSIDE `systemPromptAddition`. Baking it in
+     * at write time is what leaves a stale sentence behind after an edit — the same defect the
+     * custom-agent path has, where a display name rendered once at creation survives every
+     * later rename. Composing it on each build means it cannot go stale, and editing your
+     * instructions cannot silently delete it.
+     */
+    personality;
     /**
      * Auto-approve handoffs from this agent without user confirmation
      */
@@ -193,6 +203,7 @@ export class TeamAgent {
         this.toolFilter = config.toolFilter;
         this.toolProfile = config.toolProfile;
         this.enabledSkills = config.enabledSkills;
+        this.personality = config.personality;
         this.autoApproveHandoff = config.autoApproveHandoff;
         this._modelTier = config.modelTier;
         this.agentConfig = config.agentConfig ?? {};
@@ -281,6 +292,7 @@ export class TeamAgent {
     applyUpdate(patch) {
         const needsRebuild = (patch.systemPromptAddition !== undefined &&
             patch.systemPromptAddition !== this.systemPromptAddition) ||
+            (patch.personality !== undefined && patch.personality !== this.personality) ||
             (patch.toolProfile !== undefined && patch.toolProfile !== this.toolProfile) ||
             (patch.toolFilter !== undefined && !sameStrings(patch.toolFilter, this.toolFilter)) ||
             (patch.enabledSkills !== undefined && !sameStrings(patch.enabledSkills, this.enabledSkills));
@@ -299,6 +311,8 @@ export class TeamAgent {
             this.description = patch.description;
         if (patch.systemPromptAddition !== undefined)
             this.systemPromptAddition = patch.systemPromptAddition;
+        if (patch.personality !== undefined)
+            this.personality = patch.personality;
         /*
           ⚠️ THE PROFILE IS A LABEL; `toolFilter` IS THE ENFORCEMENT. `initialize()` passes
           `toolFilter` to the factory and never looks at `toolProfile`, so setting the profile
@@ -361,6 +375,15 @@ export class TeamAgent {
         finalSystemPromptAddition = finalSystemPromptAddition
             ? `${identityBlock}\n\n${finalSystemPromptAddition}`
             : identityBlock;
+        /*
+          ⚠️ TONE, COMPOSED HERE RATHER THAN STORED. Appending it to the stored
+          `systemPromptAddition` at write time would leave a stale sentence behind on the next
+          edit, and would put generated text inside the field the user edits by hand — where
+          their next save silently deletes it.
+        */
+        if (this.personality?.trim()) {
+            finalSystemPromptAddition += `\n\nYour manner: ${this.personality.trim()} This affects tone only, never what you are willing or able to do.`;
+        }
         // Inject shared context if provided (excluding roster — that goes via anchor for live updates)
         if (sharedContext) {
             const sharedContextBlock = sharedContext.format({ excludeRoster: true });
@@ -547,6 +570,7 @@ export class TeamAgent {
             role: this.role,
             description: this.description,
             systemPromptAddition: this.systemPromptAddition,
+            personality: this.personality,
             useMinimalSystemPrompt: this.useMinimalSystemPrompt,
             noTools: this.noTools,
             toolFilter: this.toolFilter,
@@ -571,6 +595,7 @@ export class TeamAgent {
             role: data.role,
             description: data.description,
             systemPromptAddition: data.systemPromptAddition,
+            personality: data.personality,
             useMinimalSystemPrompt: data.useMinimalSystemPrompt,
             noTools: data.noTools,
             toolFilter,

package/dist/team/types.d.ts

@@ -112,6 +112,11 @@ export interface TeamAgentConfig {
      * Appended to the base system prompt
      */
     systemPromptAddition?: string;
+    /**
+     * How the agent should sound. Tone only — composed into the prompt at build time so it
+     * cannot go stale and cannot be deleted by editing the instructions.
+     */
+    personality?: string;
     /**
      * Use minimal system prompt - skip all modules, just use role prompt
      */
@@ -162,6 +167,8 @@ export interface SerializedTeamAgent {
     role: AgentRole;
     description?: string;
     systemPromptAddition?: string;
+    /** Tone. See TeamAgentConfig.personality. */
+    personality?: string;
     useMinimalSystemPrompt?: boolean;
     noTools?: boolean;
     toolFilter?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.20.3",
+  "version": "0.21.0",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",