@compilr-dev/sdk 0.9.11 → 0.9.13

package/dist/index.d.ts

@@ -36,9 +36,9 @@
 export { createCompilrAgent } from './agent.js';
 export type { CompilrAgentConfig, CompilrAgent, RunOptions, RunResult, ToolCallRecord, ToolConfig, UsageInfo, ProviderType, PermissionCallback, GuardrailConfig, ContextConfig, CapabilitiesConfig, } from './config.js';
 export { AgentTeam, TeamAgent, SharedContextManager, ArtifactStore, DelegationTracker, ContextResolver, } from './team/index.js';
-export type { AgentTeamConfig, TeamAgentConfig, ITeamPersistence, IArtifactStorage, ISessionRegistry, CustomAgentDefinition, AgentTemplate, ToolConfig as TeamToolConfig, ToolTier, ToolGroup, ProfileInfo, } from './team/index.js';
+export type { AgentTeamConfig, TeamAgentConfig, ITeamPersistence, IArtifactStorage, ISessionRegistry, CustomAgentDefinition, AgentTemplate, AgentWorkshopData, WorkshopRoleDef, WorkshopToolProfile, WorkshopModelTier, WorkshopSkillDef, ToolConfig as TeamToolConfig, ToolTier, ToolGroup, ProfileInfo, } from './team/index.js';
 export type { AgentRole, RoleMetadata, ToolProfile, MascotExpression, BackgroundSessionInfo, SerializedTeam, SerializedTeamAgent, TeamMetadata, TeamEvent, TeamEventType, TeamEventHandler, Artifact, ArtifactType as TeamArtifactType, ArtifactSummary as TeamArtifactSummary, CreateArtifactOptions, UpdateArtifactOptions, SerializedArtifact, SharedContext, SharedProjectInfo, SharedTeamInfo, TeamRosterEntry, TeamActivity, TeamActivityType, SharedDecision, TokenBudget, SerializedSharedContext, ParsedMention, ParsedInput, ResolvedMention, ResolveOptions, ResolutionSource, Delegation, DelegationStatus, DelegationResult, CompletionEvent, CreateDelegationOptions, DelegationStats, DelegationTrackerEvents, SkillToolRequirement, } from './team/index.js';
-export { ROLE_METADATA, ROLE_EXPERTISE, PREDEFINED_ROLE_IDS, TOOL_GROUPS, TOOL_PROFILES, PROFILE_INFO, SKILL_REQUIREMENTS, CUSTOM_MASCOTS, } from './team/index.js';
+export { ROLE_METADATA, ROLE_EXPERTISE, ROLE_GROUPS, PREDEFINED_ROLE_IDS, TOOL_GROUPS, TOOL_PROFILES, PROFILE_INFO, SKILL_REQUIREMENTS, CUSTOM_MASCOTS, buildAgentWorkshopData, buildSuggestedRolesMap, } from './team/index.js';
 export { getToolsForProfile, detectProfileFromTools, isProfileReadOnly, generateToolAwarenessPrompt, generateCoordinatorGuidance, generateSpecialistGuidance, createDefaultToolConfig, validateToolConfig, getAllGroupIds, getGroupInfo, getGroupsByTier, getGroupsForProfile, assignMascot, generateCustomAgentSystemPrompt, getCustomAgentToolFilter, getCustomAgentProfileLabel, validateAgentId, isAgentIdTaken, createCustomAgentDefinition, listTemplates, getTemplate, saveTemplate, updateTemplate, deleteTemplate, createAgentFromTemplate, parseInputForMentions, getReferencedAgents, hasReferences, buildMessageWithContext, buildContextMap, findAgentForRole, findAgentById, getAvailableSpecialists, getSpecialistsSummary, hasSpecialists, suggestOwner, suggestOwners, matchesAgentExpertise, wouldCreateLoop, recordAssignment, getAssignmentHistory, clearAssignmentHistory, clearAllAssignmentHistory, canReassign, resolveAgentIdCollision, setActiveSharedContext, getActiveSharedContext, recordTeamActivity, getDefinedSkillNames, getSkillRequirements, checkSkillCompatibility, getCompatibleSkills, getAllRequiredTools, getSkillsByCategory, } from './team/index.js';
 export { codingPreset, readOnlyPreset, resolvePreset } from './presets/index.js';
 export type { Preset } from './presets/index.js';

package/dist/index.js

@@ -43,7 +43,7 @@ export { createCompilrAgent } from './agent.js';
 // Core classes
 export { AgentTeam, TeamAgent, SharedContextManager, ArtifactStore, DelegationTracker, ContextResolver, } from './team/index.js';
 // Constants
-export { ROLE_METADATA, ROLE_EXPERTISE, PREDEFINED_ROLE_IDS, TOOL_GROUPS, TOOL_PROFILES, PROFILE_INFO, SKILL_REQUIREMENTS, CUSTOM_MASCOTS, } from './team/index.js';
+export { ROLE_METADATA, ROLE_EXPERTISE, ROLE_GROUPS, PREDEFINED_ROLE_IDS, TOOL_GROUPS, TOOL_PROFILES, PROFILE_INFO, SKILL_REQUIREMENTS, CUSTOM_MASCOTS, buildAgentWorkshopData, buildSuggestedRolesMap, } from './team/index.js';
 // Utility functions
 export { 
 // Tool config

package/dist/team/custom-agents.js

@@ -112,10 +112,10 @@ export function validateAgentId(id) {
     if (id.length > 20) {
         return { valid: false, error: 'Agent ID must be 20 characters or less' };
     }
-    if (!/^[a-z][a-z0-9_]*$/.test(id)) {
+    if (!/^[a-z][a-z0-9_-]*$/.test(id)) {
         return {
             valid: false,
-            error: 'Must be lowercase letters, numbers, underscore (start with letter)',
+            error: 'Must be lowercase letters, numbers, underscore, dash (start with letter)',
         };
     }
     return { valid: true };

package/dist/team/index.d.ts

@@ -12,7 +12,7 @@ export type { SharedContext, SharedProjectInfo, SharedTeamInfo, TeamRosterEntry,
 export { ArtifactStore } from './artifacts.js';
 export type { Artifact, ArtifactType, ArtifactSummary, CreateArtifactOptions, UpdateArtifactOptions, SerializedArtifact, } from './artifacts.js';
 export type { TeamAgentConfig, SerializedTeamAgent, TeamMetadata, SerializedTeam, TeamEvent, TeamEventType, TeamEventHandler, AgentRole, RoleMetadata, MascotExpression, ToolProfile, BackgroundSessionInfo, } from './types.js';
-export { ROLE_METADATA, ROLE_EXPERTISE, PREDEFINED_ROLE_IDS } from './types.js';
+export { ROLE_METADATA, ROLE_EXPERTISE, ROLE_GROUPS, PREDEFINED_ROLE_IDS } from './types.js';
 export { TOOL_GROUPS, TOOL_PROFILES, PROFILE_INFO, getToolsForProfile, detectProfileFromTools, isProfileReadOnly, generateToolAwarenessPrompt, generateCoordinatorGuidance, generateSpecialistGuidance, } from './tool-config.js';
 export type { ToolConfig, ToolTier, ToolGroup, ProfileInfo } from './tool-config.js';
 export { createDefaultToolConfig, validateToolConfig, getAllGroupIds, getGroupInfo, getGroupsByTier, getGroupsForProfile, } from './tool-config.js';
@@ -20,6 +20,8 @@ export type { CustomAgentDefinition } from './custom-agents.js';
 export { CUSTOM_MASCOTS, assignMascot, generateCustomAgentSystemPrompt, getCustomAgentToolFilter, getCustomAgentProfileLabel, validateAgentId, isAgentIdTaken, createCustomAgentDefinition, } from './custom-agents.js';
 export type { AgentTemplate } from './agent-templates.js';
 export { listTemplates, getTemplate, saveTemplate, updateTemplate, deleteTemplate, createAgentFromTemplate, } from './agent-templates.js';
+export type { AgentWorkshopData, WorkshopRoleDef, WorkshopToolProfile, WorkshopModelTier, WorkshopSkillDef, } from './workshop-data.js';
+export { buildAgentWorkshopData, buildSuggestedRolesMap } from './workshop-data.js';
 export type { ITeamPersistence, IArtifactStorage, ISessionRegistry } from './interfaces.js';
 export type { ParsedMention, ParsedInput } from './mention-parser.js';
 export { parseInputForMentions, getReferencedAgents, hasReferences, buildMessageWithContext, } from './mention-parser.js';

package/dist/team/index.js

@@ -9,12 +9,13 @@ export { AgentTeam } from './team.js';
 export { TeamAgent } from './team-agent.js';
 export { SharedContextManager } from './shared-context.js';
 export { ArtifactStore } from './artifacts.js';
-export { ROLE_METADATA, ROLE_EXPERTISE, PREDEFINED_ROLE_IDS } from './types.js';
+export { ROLE_METADATA, ROLE_EXPERTISE, ROLE_GROUPS, PREDEFINED_ROLE_IDS } from './types.js';
 // Tool configuration
 export { TOOL_GROUPS, TOOL_PROFILES, PROFILE_INFO, getToolsForProfile, detectProfileFromTools, isProfileReadOnly, generateToolAwarenessPrompt, generateCoordinatorGuidance, generateSpecialistGuidance, } from './tool-config.js';
 export { createDefaultToolConfig, validateToolConfig, getAllGroupIds, getGroupInfo, getGroupsByTier, getGroupsForProfile, } from './tool-config.js';
 export { CUSTOM_MASCOTS, assignMascot, generateCustomAgentSystemPrompt, getCustomAgentToolFilter, getCustomAgentProfileLabel, validateAgentId, isAgentIdTaken, createCustomAgentDefinition, } from './custom-agents.js';
 export { listTemplates, getTemplate, saveTemplate, updateTemplate, deleteTemplate, createAgentFromTemplate, } from './agent-templates.js';
+export { buildAgentWorkshopData, buildSuggestedRolesMap } from './workshop-data.js';
 export { parseInputForMentions, getReferencedAgents, hasReferences, buildMessageWithContext, } from './mention-parser.js';
 export { ContextResolver, buildContextMap } from './context-resolver.js';
 // Agent selection

package/dist/team/types.d.ts

@@ -34,6 +34,11 @@ export type MascotExpression = '[•_•]' | '[◈_◈]' | '[▣_▣]' | '[◉_
  * Predefined agent roles with default configurations
  */
 export type AgentRole = 'default' | 'pm' | 'arch' | 'qa' | 'dev' | 'ops' | 'docs' | 'ba' | 'researcher' | 'reviewer' | 'editor' | 'writer' | 'analyst' | 'strategist' | 'instructor' | 'custom';
+/**
+ * Role groups for UI display (Workshop, team overlay).
+ * Groups roles by domain — used for visual categorization.
+ */
+export declare const ROLE_GROUPS: Record<string, AgentRole[]>;
 /**
  * List of predefined role IDs (for validation against custom agent IDs)
  */

package/dist/team/types.js

@@ -3,6 +3,15 @@
  *
  * Type definitions for the multi-agent team system.
  */
+/**
+ * Role groups for UI display (Workshop, team overlay).
+ * Groups roles by domain — used for visual categorization.
+ */
+export const ROLE_GROUPS = {
+    Software: ['dev', 'arch', 'qa', 'pm', 'ops'],
+    'Writing & Analysis': ['writer', 'editor', 'reviewer', 'researcher', 'analyst', 'docs', 'ba'],
+    'Business & Education': ['strategist', 'instructor'],
+};
 /**
  * List of predefined role IDs (for validation against custom agent IDs)
  */

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

@@ -0,0 +1,66 @@
+/**
+ * Workshop Data Builder — Assembles all agent/skill/tool metadata
+ * into a single UI-friendly structure for the Agent Workshop.
+ *
+ * Used by both Desktop (via IPC) and CLI (direct import).
+ * Single source of truth — no hardcoded data in UI components.
+ */
+export interface WorkshopRoleDef {
+    id: string;
+    displayName: string;
+    mascot: string;
+    description: string;
+    group: string;
+    expertise: string[];
+    defaultToolProfile: string;
+    defaultModelTier: string;
+}
+export interface WorkshopToolProfile {
+    id: string;
+    label: string;
+    description: string;
+    isReadOnly: boolean;
+}
+export interface WorkshopModelTier {
+    id: string;
+    label: string;
+    description: string;
+}
+export interface WorkshopSkillDef {
+    id: string;
+    label: string;
+    category: string;
+    requiredTools: string[];
+    optionalTools: string[];
+}
+export interface AgentWorkshopData {
+    /** Predefined roles with metadata */
+    roles: WorkshopRoleDef[];
+    /** Role group names in display order */
+    roleGroupOrder: string[];
+    /** Suggested role IDs per project type */
+    suggestedRoles: Record<string, string[]>;
+    /** Available tool profiles */
+    toolProfiles: WorkshopToolProfile[];
+    /** Model tiers */
+    modelTiers: WorkshopModelTier[];
+    /** Skills with tool requirements */
+    skills: WorkshopSkillDef[];
+    /** Skill category names in display order */
+    skillCategories: string[];
+}
+/**
+ * Build the complete workshop data from SDK constants.
+ * This is a pure function — no side effects, fully testable.
+ */
+export declare function buildAgentWorkshopData(suggestedRolesMap?: Record<string, string[]>): AgentWorkshopData;
+/**
+ * Build the suggested roles map from project type configs.
+ * Call this from the host app (needs access to PROJECT_TYPES).
+ */
+export declare function buildSuggestedRolesMap(projectTypes: Array<{
+    id: string;
+    suggestedAgents?: Array<{
+        role: string;
+    }>;
+}>): Record<string, string[]>;

package/dist/team/workshop-data.js

@@ -0,0 +1,119 @@
+/**
+ * Workshop Data Builder — Assembles all agent/skill/tool metadata
+ * into a single UI-friendly structure for the Agent Workshop.
+ *
+ * Used by both Desktop (via IPC) and CLI (direct import).
+ * Single source of truth — no hardcoded data in UI components.
+ */
+import { PREDEFINED_ROLE_IDS, ROLE_METADATA, ROLE_EXPERTISE, ROLE_GROUPS, } from './types.js';
+import { PROFILE_INFO } from './tool-config.js';
+import { SKILL_REQUIREMENTS, getSkillsByCategory } from './skill-requirements.js';
+// =============================================================================
+// Builder
+// =============================================================================
+/**
+ * Find which group a role belongs to.
+ */
+function getRoleGroup(roleId) {
+    for (const [group, roles] of Object.entries(ROLE_GROUPS)) {
+        if (roles.includes(roleId))
+            return group;
+    }
+    return 'Other';
+}
+/**
+ * Prettify a skill ID into a human-readable label.
+ * "code-review" → "Code Review", "prd" → "PRD"
+ */
+function skillLabel(id) {
+    // Special cases
+    const special = { prd: 'PRD' };
+    if (special[id])
+        return special[id];
+    return id.replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/**
+ * Find which category a skill belongs to.
+ */
+function getSkillCategory(skillId, categories) {
+    for (const [cat, skills] of Object.entries(categories)) {
+        if (skills.includes(skillId)) {
+            // Capitalize category name
+            return cat.charAt(0).toUpperCase() + cat.slice(1);
+        }
+    }
+    return 'Other';
+}
+/**
+ * Build the complete workshop data from SDK constants.
+ * This is a pure function — no side effects, fully testable.
+ */
+export function buildAgentWorkshopData(suggestedRolesMap) {
+    // Roles (exclude 'default' — it's the coordinator, not selectable)
+    const roles = PREDEFINED_ROLE_IDS.filter((id) => id !== 'default').map((id) => {
+        const meta = ROLE_METADATA[id];
+        return {
+            id,
+            displayName: meta.displayName,
+            mascot: meta.mascot,
+            description: meta.description,
+            group: getRoleGroup(id),
+            expertise: ROLE_EXPERTISE[id],
+            defaultToolProfile: meta.defaultToolProfile ?? 'full',
+            defaultModelTier: meta.defaultModelTier ?? 'balanced',
+        };
+    });
+    // Role groups in display order
+    const roleGroupOrder = Object.keys(ROLE_GROUPS);
+    // Tool profiles
+    const toolProfiles = Object.entries(PROFILE_INFO)
+        .filter(([id]) => id !== 'custom') // Custom is handled separately in UI
+        .map(([id, info]) => ({
+        id,
+        label: info.label,
+        description: info.description,
+        isReadOnly: info.isReadOnly,
+    }));
+    // Model tiers
+    const modelTiers = [
+        { id: 'fast', label: 'Fast', description: 'Quick responses, lower cost' },
+        {
+            id: 'balanced',
+            label: 'Balanced',
+            description: 'Best mix of speed and capability (default)',
+        },
+        { id: 'powerful', label: 'Powerful', description: 'Best reasoning for complex tasks' },
+    ];
+    // Skills
+    const categories = getSkillsByCategory();
+    const skills = Object.entries(SKILL_REQUIREMENTS).map(([id, req]) => ({
+        id,
+        label: skillLabel(id),
+        category: getSkillCategory(id, categories),
+        requiredTools: req.required,
+        optionalTools: req.optional ?? [],
+    }));
+    const skillCategories = Object.keys(categories).map((c) => c.charAt(0).toUpperCase() + c.slice(1));
+    return {
+        roles,
+        roleGroupOrder,
+        suggestedRoles: suggestedRolesMap ?? {},
+        toolProfiles,
+        modelTiers,
+        skills,
+        skillCategories,
+    };
+}
+/**
+ * Build the suggested roles map from project type configs.
+ * Call this from the host app (needs access to PROJECT_TYPES).
+ */
+export function buildSuggestedRolesMap(projectTypes) {
+    const map = {};
+    for (const pt of projectTypes) {
+        if (pt.suggestedAgents) {
+            map[pt.id] = pt.suggestedAgents.map((a) => a.role);
+        }
+    }
+    return map;
+}

package/package.json

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