@compilr-dev/sdk 0.25.1 → 0.27.0

package/dist/team/team-agent.js

@@ -203,6 +203,19 @@ export class TeamAgent {
      * from the profile name alone.
      */
     customGroups;
+    /**
+     * Skills this agent may CHOOSE. `undefined` = never asked, reaches everything eligible;
+     * `[]` = granted nothing. Same contract as `mcpServers`.
+     *
+     * ⚠️ THERE USED TO BE A SECOND FIELD, `enabledSkills`, AND IT HELD SOMETHING ELSE ENTIRELY.
+     * MACRO ids — the 13 its picker offered were `code-review`, `debug`, `design`, `prd` and
+     * friends, all things a user types. 0.25.0 wired Skills enforcement onto it and produced a
+     * live hazard: ticking "Code Review" wrote a name no installed skill has, so the agent
+     * silently got zero skills. It is deleted now. The MCP-style reading is legitimate HERE
+     * only because this
+     * field is new and nothing has a prior meaning.
+     */
+    grantedSkills;
     /**
      * MCP servers this agent may reach. `undefined` = a pre-grants agent, which reaches all;
      * `[]` = granted nothing. See `TeamAgentConfig.mcpServers`.
@@ -215,7 +228,6 @@ export class TeamAgent {
     /**
      * Enabled skills (empty = all skills)
      */
-    enabledSkills;
     /**
      * How the agent should sound. Tone only — never capability.
      *
@@ -271,7 +283,7 @@ export class TeamAgent {
         this.toolProfile = config.toolProfile;
         this.customGroups = config.customGroups;
         this.mcpServers = config.mcpServers;
-        this.enabledSkills = config.enabledSkills;
+        this.grantedSkills = config.grantedSkills;
         this.personality = config.personality;
         this.autoApproveHandoff = config.autoApproveHandoff;
         this._modelTier = config.modelTier;
@@ -405,9 +417,8 @@ export class TeamAgent {
             (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)) ||
-            (patch.mcpServers !== undefined && !sameStrings(patch.mcpServers, this.mcpServers));
+            (patch.mcpServers !== undefined && !sameStrings(patch.mcpServers, this.mcpServers)) ||
+            (patch.grantedSkills !== undefined && !sameStrings(patch.grantedSkills, this.grantedSkills));
         /*
           Delegated: `setModelTier` no-ops when the tier is unchanged and stashes for rebuild
           when it is not. Its `rebuilt` contribution is folded in below.
@@ -446,6 +457,8 @@ export class TeamAgent {
             this.personality = patch.personality;
         if (patch.mcpServers !== undefined)
             this.mcpServers = patch.mcpServers;
+        if (patch.grantedSkills !== undefined)
+            this.grantedSkills = patch.grantedSkills;
         /*
           ⚠️ THE PROFILE IS A LABEL; `toolFilter` IS THE ENFORCEMENT. `initialize()` passes
           `toolFilter` to the factory and never looks at `toolProfile`, so setting the profile
@@ -468,8 +481,6 @@ export class TeamAgent {
         }
         if (patch.toolFilter !== undefined)
             this.toolFilter = patch.toolFilter;
-        if (patch.enabledSkills !== undefined)
-            this.enabledSkills = patch.enabledSkills;
         if (needsRebuild)
             this.stashForRebuild();
         return { rebuilt: needsRebuild || tierChanged };
@@ -758,7 +769,7 @@ export class TeamAgent {
             toolProfile: this.toolProfile,
             customGroups: this.customGroups,
             mcpServers: this.mcpServers,
-            enabledSkills: this.enabledSkills,
+            grantedSkills: this.grantedSkills,
             modelTier: this.modelTier,
             autoApproveHandoff: this.autoApproveHandoff,
             agentState,
@@ -815,7 +826,7 @@ export class TeamAgent {
             toolProfile: data.toolProfile,
             customGroups: data.customGroups,
             mcpServers: data.mcpServers,
-            enabledSkills: data.enabledSkills,
+            grantedSkills: data.grantedSkills,
             modelTier: data.modelTier,
             autoApproveHandoff: data.autoApproveHandoff,
         });
@@ -898,7 +909,6 @@ export class TeamAgent {
             toolFilter, // Pass tool filter from custom agent config
             toolProfile: def.toolConfig?.profile, // Store profile for display
             customGroups: def.toolConfig?.customGroups,
-            enabledSkills: def.enabledSkills, // Store skills for display
             modelTier: def.modelTier, // Store model tier
         });
     }

package/dist/team/types.d.ts

@@ -148,10 +148,14 @@ export interface TeamAgentConfig {
      */
     mcpServers?: string[];
     /**
-     * Enabled skills for this agent
-     * Empty array means all skills, non-empty means filtered
+     * Skills this agent may choose. undefined = never asked, [] = none.
+     *
+     * ⚠️ THERE USED TO BE A SECOND FIELD HERE, `enabledSkills`, holding MACRO ids with the
+     * OPPOSITE empty-semantics ("empty = all"). It was collected by a picker in both hosts,
+     * serialised, displayed — and never reached an agent factory in its life. Both pickers are
+     * deleted and the field with them. Old team files may still carry the key; it is ignored.
      */
-    enabledSkills?: string[];
+    grantedSkills?: string[];
     /**
      * Model tier for this agent (fast/balanced/powerful)
      * Determines which model is used based on provider
@@ -188,7 +192,8 @@ export interface SerializedTeamAgent {
     customGroups?: string[];
     /** See TeamAgentConfig.mcpServers — undefined means a pre-grants agent, which reaches all. */
     mcpServers?: string[];
-    enabledSkills?: string[];
+    /** Skills this agent may choose. undefined = never asked, [] = none. */
+    grantedSkills?: string[];
     modelTier?: ModelTier;
     autoApproveHandoff?: boolean;
     agentState?: AgentState;

package/dist/team/workshop-data.d.ts

@@ -32,7 +32,19 @@ export interface WorkshopModelTier {
     label: string;
     description: string;
 }
-export interface WorkshopSkillDef {
+/**
+ * A MACRO, with the tools its text assumes.
+ *
+ * ⚠️ IT WAS CALLED WorkshopSkillDef, AND THAT NAME BUILT A WHOLE WRONG SCREEN. The contents are
+ * `MACRO_REQUIREMENTS` verbatim — the same 13 ids — but the field was called `skills`, so both
+ * agent editors rendered it as a catalogue of Skills the agent may use. It is not: these are
+ * macros, which a USER types, and an agent cannot "be restricted to" one. That is why the
+ * resulting control could only ever offer 13 of ~55 and why it enforced nothing.
+ *
+ * Skills — the kind a model chooses — come from `loadInstalledSkills()` and are granted per
+ * agent through `grantedSkills`. A grants UI must read THAT, never this.
+ */
+export interface WorkshopMacroDef {
     id: string;
     label: string;
     category: string;
@@ -50,10 +62,10 @@ export interface AgentWorkshopData {
     toolProfiles: WorkshopToolProfile[];
     /** Model tiers */
     modelTiers: WorkshopModelTier[];
-    /** Skills with tool requirements */
-    skills: WorkshopSkillDef[];
-    /** Skill category names in display order */
-    skillCategories: string[];
+    /** Macros with the tools their text assumes. NOT Skills — see WorkshopMacroDef. */
+    macros: WorkshopMacroDef[];
+    /** Macro category names in display order */
+    macroCategories: string[];
 }
 /**
  * Build the complete workshop data from SDK constants.

package/dist/team/workshop-data.js

@@ -7,7 +7,7 @@
  */
 import { PREDEFINED_ROLE_IDS, ROLE_METADATA, ROLE_EXPERTISE, ROLE_GROUPS, ROLE_COPY, } from './types.js';
 import { PROFILE_INFO } from './tool-config.js';
-import { SKILL_REQUIREMENTS, getSkillsByCategory } from './skill-requirements.js';
+import { MACRO_REQUIREMENTS, getMacrosByCategory } from './macro-requirements.js';
 // =============================================================================
 // Builder
 // =============================================================================
@@ -25,7 +25,7 @@ function getRoleGroup(roleId) {
  * Prettify a skill ID into a human-readable label.
  * "code-review" → "Code Review", "prd" → "PRD"
  */
-function skillLabel(id) {
+function macroLabel(id) {
     // Special cases
     const special = { prd: 'PRD' };
     if (special[id])
@@ -35,9 +35,9 @@ function skillLabel(id) {
 /**
  * Find which category a skill belongs to.
  */
-function getSkillCategory(skillId, categories) {
-    for (const [cat, skills] of Object.entries(categories)) {
-        if (skills.includes(skillId)) {
+function getMacroCategory(macroId, categories) {
+    for (const [cat, members] of Object.entries(categories)) {
+        if (members.includes(macroId)) {
             // Capitalize category name
             return cat.charAt(0).toUpperCase() + cat.slice(1);
         }
@@ -88,24 +88,24 @@ export function buildAgentWorkshopData(suggestedRolesMap) {
         },
         { id: 'powerful', label: 'Powerful', description: 'Best reasoning for complex tasks' },
     ];
-    // Skills
-    const categories = getSkillsByCategory();
-    const skills = Object.entries(SKILL_REQUIREMENTS).map(([id, req]) => ({
+    // Macros
+    const categories = getMacrosByCategory();
+    const macros = Object.entries(MACRO_REQUIREMENTS).map(([id, req]) => ({
         id,
-        label: skillLabel(id),
-        category: getSkillCategory(id, categories),
+        label: macroLabel(id),
+        category: getMacroCategory(id, categories),
         requiredTools: req.required,
         optionalTools: req.optional ?? [],
     }));
-    const skillCategories = Object.keys(categories).map((c) => c.charAt(0).toUpperCase() + c.slice(1));
+    const macroCategories = Object.keys(categories).map((c) => c.charAt(0).toUpperCase() + c.slice(1));
     return {
         roles,
         roleGroupOrder,
         suggestedRoles: suggestedRolesMap ?? {},
         toolProfiles,
         modelTiers,
-        skills,
-        skillCategories,
+        macros,
+        macroCategories,
     };
 }
 /**

package/package.json

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

package/dist/project-types/skill-meta.d.ts

@@ -1,17 +0,0 @@
-/**
- * Skill Metadata Registry
- *
- * Maps skill IDs to UI metadata (label, icon, category).
- * This is the single source of truth — the desktop reads this via IPC.
- */
-import type { SkillMeta } from './types.js';
-/** All skill UI metadata — platform skills + builtin skills */
-export declare const SKILL_META_REGISTRY: Record<string, SkillMeta>;
-/**
- * Get skill metadata by ID.
- */
-export declare function getSkillMeta(skillId: string): SkillMeta | undefined;
-/**
- * Get all skill metadata entries.
- */
-export declare function getAllSkillMeta(): SkillMeta[];

package/dist/skills/book-skills.d.ts

@@ -1,10 +0,0 @@
-/**
- * Book Skills
- *
- * book-outline, character-design, plot-threads, scene-breakdown, book-review
- */
-export declare const bookOutlineSkill: import("@compilr-dev/agents").Skill;
-export declare const characterDesignSkill: import("@compilr-dev/agents").Skill;
-export declare const plotThreadsSkill: import("@compilr-dev/agents").Skill;
-export declare const sceneBreakdownSkill: import("@compilr-dev/agents").Skill;
-export declare const bookReviewSkill: import("@compilr-dev/agents").Skill;

package/dist/skills/business-skills.d.ts

@@ -1,11 +0,0 @@
-/**
- * Business Plan Skills
- *
- * business-vision, market-analysis, competitor-analysis, financial-model, pitch-outline, business-review
- */
-export declare const businessVisionSkill: import("@compilr-dev/agents").Skill;
-export declare const marketAnalysisSkill: import("@compilr-dev/agents").Skill;
-export declare const competitorAnalysisSkill: import("@compilr-dev/agents").Skill;
-export declare const financialModelSkill: import("@compilr-dev/agents").Skill;
-export declare const pitchOutlineSkill: import("@compilr-dev/agents").Skill;
-export declare const businessReviewSkill: import("@compilr-dev/agents").Skill;

package/dist/skills/canvas-skills.d.ts

@@ -1,11 +0,0 @@
-/**
- * Canvas Skills
- *
- * canvas — author and edit a visual canvas (infographic, carousel, or board)
- * rendered from sandboxed HTML/SVG, optionally with live "Tweaks" controls.
- */
-export declare const canvasSkill: import("@compilr-dev/agents").Skill;
-export declare const infographicSkill: import("@compilr-dev/agents").Skill;
-export declare const carouselSkill: import("@compilr-dev/agents").Skill;
-export declare const boardSkill: import("@compilr-dev/agents").Skill;
-export declare const canvasStylesSkill: import("@compilr-dev/agents").Skill;

package/dist/skills/content-skills.d.ts

@@ -1,10 +0,0 @@
-/**
- * Content & Marketing Skills
- *
- * brand-setup, content-strategy, content-calendar, create-content, content-review
- */
-export declare const brandSetupSkill: import("@compilr-dev/agents").Skill;
-export declare const contentStrategySkill: import("@compilr-dev/agents").Skill;
-export declare const contentCalendarSkill: import("@compilr-dev/agents").Skill;
-export declare const createContentSkill: import("@compilr-dev/agents").Skill;
-export declare const contentReviewSkill: import("@compilr-dev/agents").Skill;

package/dist/skills/course-skills.d.ts

@@ -1,9 +0,0 @@
-/**
- * Course / Training Skills
- *
- * curriculum-design, lesson-plan, assessment-design, course-review
- */
-export declare const curriculumDesignSkill: import("@compilr-dev/agents").Skill;
-export declare const lessonPlanSkill: import("@compilr-dev/agents").Skill;
-export declare const assessmentDesignSkill: import("@compilr-dev/agents").Skill;
-export declare const courseReviewSkill: import("@compilr-dev/agents").Skill;

package/dist/skills/platform-skills.d.ts

@@ -1,20 +0,0 @@
-/**
- * Platform Skills — Aggregate
- *
- * Re-exports all domain-specific skills and provides the combined platformSkills array.
- * Individual skill files: software-skills.ts, research-skills.ts, business-skills.ts, content-skills.ts
- */
-import type { Skill } from '@compilr-dev/agents';
-export { designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, } from './software-skills.js';
-export { outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, } from './research-skills.js';
-export { businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './business-skills.js';
-export { brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, } from './content-skills.js';
-export { curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, } from './course-skills.js';
-export { bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './book-skills.js';
-export { canvasSkill, infographicSkill, carouselSkill, boardSkill, canvasStylesSkill, } from './canvas-skills.js';
-export { canvasExemplarInfographicSkill, canvasExemplarAppScreenSkill, } from './canvas-exemplars.js';
-export { canvasIconsSkill } from './canvas-icons.js';
-/**
- * All platform-specific skills (38 total).
- */
-export declare const platformSkills: Skill[];

package/dist/skills/platform-skills.js

@@ -1,87 +0,0 @@
-/**
- * Platform Skills — Aggregate
- *
- * Re-exports all domain-specific skills and provides the combined platformSkills array.
- * Individual skill files: software-skills.ts, research-skills.ts, business-skills.ts, content-skills.ts
- */
-// Software Development
-export { designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, } from './software-skills.js';
-// Research Paper
-export { outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, } from './research-skills.js';
-// Business Plan
-export { businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './business-skills.js';
-// Content & Marketing
-export { brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, } from './content-skills.js';
-// Course / Training
-export { curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, } from './course-skills.js';
-// Book
-export { bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './book-skills.js';
-// Canvas (visual)
-export { canvasSkill, infographicSkill, carouselSkill, boardSkill, canvasStylesSkill, } from './canvas-skills.js';
-// Canvas exemplars — generated from the design handoff; see canvas-exemplars.ts.
-export { canvasExemplarInfographicSkill, canvasExemplarAppScreenSkill, } from './canvas-exemplars.js';
-export { canvasIconsSkill } from './canvas-icons.js';
-// Import all for the aggregate array
-import { designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, } from './software-skills.js';
-import { outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, } from './research-skills.js';
-import { businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './business-skills.js';
-import { brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, } from './content-skills.js';
-import { curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, } from './course-skills.js';
-import { bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './book-skills.js';
-import { canvasSkill, infographicSkill, carouselSkill, boardSkill, canvasStylesSkill, } from './canvas-skills.js';
-import { canvasExemplarInfographicSkill, canvasExemplarAppScreenSkill, } from './canvas-exemplars.js';
-import { canvasIconsSkill } from './canvas-icons.js';
-/**
- * All platform-specific skills (38 total).
- */
-export const platformSkills = [
-    // Software (9)
-    designSkill,
-    sketchSkill,
-    prdSkill,
-    refineSkill,
-    refineItemSkill,
-    architectureSkill,
-    sessionNotesSkill,
-    buildSkill,
-    scaffoldSkill,
-    // Research (5)
-    outlineSkill,
-    literatureReviewSkill,
-    draftSectionSkill,
-    peerReviewSkill,
-    researchScaffoldSkill,
-    // Business (6)
-    businessVisionSkill,
-    marketAnalysisSkill,
-    competitorAnalysisSkill,
-    financialModelSkill,
-    pitchOutlineSkill,
-    businessReviewSkill,
-    // Content (5)
-    brandSetupSkill,
-    contentStrategySkill,
-    contentCalendarSkill,
-    createContentSkill,
-    contentReviewSkill,
-    // Course (4)
-    curriculumDesignSkill,
-    lessonPlanSkill,
-    assessmentDesignSkill,
-    courseReviewSkill,
-    // Book (5)
-    bookOutlineSkill,
-    characterDesignSkill,
-    plotThreadsSkill,
-    sceneBreakdownSkill,
-    bookReviewSkill,
-    // Canvas (4)
-    canvasSkill,
-    infographicSkill,
-    carouselSkill,
-    boardSkill,
-    canvasStylesSkill,
-    canvasExemplarInfographicSkill,
-    canvasExemplarAppScreenSkill,
-    canvasIconsSkill,
-];

package/dist/skills/research-skills.d.ts

@@ -1,10 +0,0 @@
-/**
- * Research Paper Skills
- *
- * outline, literature-review, draft-section, peer-review, research-scaffold
- */
-export declare const outlineSkill: import("@compilr-dev/agents").Skill;
-export declare const literatureReviewSkill: import("@compilr-dev/agents").Skill;
-export declare const draftSectionSkill: import("@compilr-dev/agents").Skill;
-export declare const peerReviewSkill: import("@compilr-dev/agents").Skill;
-export declare const researchScaffoldSkill: import("@compilr-dev/agents").Skill;

package/dist/skills/software-skills.d.ts

@@ -1,14 +0,0 @@
-/**
- * Software Development Skills
- *
- * design, sketch, prd, refine, refine-item, architecture, session-notes, build, scaffold
- */
-export declare const designSkill: import("@compilr-dev/agents").Skill;
-export declare const refineSkill: import("@compilr-dev/agents").Skill;
-export declare const sketchSkill: import("@compilr-dev/agents").Skill;
-export declare const refineItemSkill: import("@compilr-dev/agents").Skill;
-export declare const architectureSkill: import("@compilr-dev/agents").Skill;
-export declare const prdSkill: import("@compilr-dev/agents").Skill;
-export declare const sessionNotesSkill: import("@compilr-dev/agents").Skill;
-export declare const buildSkill: import("@compilr-dev/agents").Skill;
-export declare const scaffoldSkill: import("@compilr-dev/agents").Skill;