@compilr-dev/sdk 0.9.10 → 0.9.12

package/dist/index.d.ts

@@ -36,10 +36,10 @@
 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, ToolConfig as TeamToolConfig, ToolTier, ToolGroup, ProfileInfo, } 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 { 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 { getToolsForProfile, detectProfileFromTools, isProfileReadOnly, generateToolAwarenessPrompt, generateCoordinatorGuidance, generateSpecialistGuidance, createDefaultToolConfig, validateToolConfig, getAllGroupIds, getGroupInfo, getGroupsByTier, getGroupsForProfile, assignMascot, generateCustomAgentSystemPrompt, getCustomAgentToolFilter, getCustomAgentProfileLabel, validateAgentId, isAgentIdTaken, createCustomAgentDefinition, 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 { 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';
 export type { AnyTool } from './presets/types.js';

package/dist/index.js

@@ -52,6 +52,8 @@ getToolsForProfile, detectProfileFromTools, isProfileReadOnly, generateToolAware
 createDefaultToolConfig, validateToolConfig, getAllGroupIds, getGroupInfo, getGroupsByTier, getGroupsForProfile, 
 // Custom agents
 assignMascot, generateCustomAgentSystemPrompt, getCustomAgentToolFilter, getCustomAgentProfileLabel, validateAgentId, isAgentIdTaken, createCustomAgentDefinition, 
+// Agent templates
+listTemplates, getTemplate, saveTemplate, updateTemplate, deleteTemplate, createAgentFromTemplate, 
 // Mention parsing
 parseInputForMentions, getReferencedAgents, hasReferences, buildMessageWithContext, buildContextMap, 
 // Agent selection

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

@@ -0,0 +1,38 @@
+/**
+ * Agent Templates — Reusable custom agent configurations.
+ *
+ * Stored globally in ~/.compilr-dev/agent-templates.json (not per-project).
+ * Templates include all agent config except ID and mascot (assigned at creation).
+ */
+import type { CustomAgentDefinition } from './custom-agents.js';
+export interface AgentTemplate {
+    /** Unique template ID (auto-generated) */
+    id: string;
+    /** Template name (user-facing) */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** When created */
+    createdAt: string;
+    /** When last updated */
+    updatedAt: string;
+    displayName: string;
+    specialty: string;
+    personality?: string;
+    systemPromptAddition?: string;
+    toolProfile?: string;
+    enabledSkills?: string[];
+    modelTier?: string;
+}
+/** List all saved templates */
+export declare function listTemplates(): AgentTemplate[];
+/** Get a template by ID */
+export declare function getTemplate(id: string): AgentTemplate | null;
+/** Save a new template from a custom agent definition */
+export declare function saveTemplate(name: string, agent: CustomAgentDefinition, description?: string): AgentTemplate;
+/** Update an existing template */
+export declare function updateTemplate(id: string, updates: Partial<Omit<AgentTemplate, 'id' | 'createdAt'>>): AgentTemplate | null;
+/** Delete a template */
+export declare function deleteTemplate(id: string): boolean;
+/** Create a CustomAgentDefinition from a template */
+export declare function createAgentFromTemplate(template: AgentTemplate, agentId: string, existingAgents: CustomAgentDefinition[]): CustomAgentDefinition;

package/dist/team/agent-templates.js

@@ -0,0 +1,107 @@
+/**
+ * Agent Templates — Reusable custom agent configurations.
+ *
+ * Stored globally in ~/.compilr-dev/agent-templates.json (not per-project).
+ * Templates include all agent config except ID and mascot (assigned at creation).
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { assignMascot } from './custom-agents.js';
+// =============================================================================
+// Storage
+// =============================================================================
+function getTemplatesPath() {
+    return join(homedir(), '.compilr-dev', 'agent-templates.json');
+}
+function readTemplates() {
+    const path = getTemplatesPath();
+    if (!existsSync(path))
+        return [];
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return [];
+    }
+}
+function writeTemplates(templates) {
+    const dir = join(homedir(), '.compilr-dev');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(getTemplatesPath(), JSON.stringify(templates, null, 2));
+}
+function generateId() {
+    return `tmpl-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+}
+// =============================================================================
+// CRUD Operations
+// =============================================================================
+/** List all saved templates */
+export function listTemplates() {
+    return readTemplates();
+}
+/** Get a template by ID */
+export function getTemplate(id) {
+    return readTemplates().find((t) => t.id === id) ?? null;
+}
+/** Save a new template from a custom agent definition */
+export function saveTemplate(name, agent, description) {
+    const templates = readTemplates();
+    const now = new Date().toISOString();
+    const template = {
+        id: generateId(),
+        name,
+        description,
+        createdAt: now,
+        updatedAt: now,
+        displayName: agent.displayName,
+        specialty: agent.specialty,
+        personality: agent.personality,
+        systemPromptAddition: agent.systemPromptAddition,
+        toolProfile: agent.toolConfig?.profile,
+        enabledSkills: agent.enabledSkills,
+        modelTier: agent.modelTier,
+    };
+    templates.push(template);
+    writeTemplates(templates);
+    return template;
+}
+/** Update an existing template */
+export function updateTemplate(id, updates) {
+    const templates = readTemplates();
+    const idx = templates.findIndex((t) => t.id === id);
+    if (idx < 0)
+        return null;
+    templates[idx] = {
+        ...templates[idx],
+        ...updates,
+        updatedAt: new Date().toISOString(),
+    };
+    writeTemplates(templates);
+    return templates[idx];
+}
+/** Delete a template */
+export function deleteTemplate(id) {
+    const templates = readTemplates();
+    const filtered = templates.filter((t) => t.id !== id);
+    if (filtered.length === templates.length)
+        return false;
+    writeTemplates(filtered);
+    return true;
+}
+/** Create a CustomAgentDefinition from a template */
+export function createAgentFromTemplate(template, agentId, existingAgents) {
+    return {
+        id: agentId,
+        displayName: template.displayName,
+        specialty: template.specialty,
+        personality: template.personality,
+        systemPromptAddition: template.systemPromptAddition,
+        mascot: assignMascot(existingAgents),
+        createdAt: new Date().toISOString(),
+        toolConfig: template.toolProfile ? { profile: template.toolProfile } : undefined,
+        enabledSkills: template.enabledSkills,
+        modelTier: template.modelTier,
+    };
+}

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

@@ -18,6 +18,8 @@ export type { ToolConfig, ToolTier, ToolGroup, ProfileInfo } from './tool-config
 export { createDefaultToolConfig, validateToolConfig, getAllGroupIds, getGroupInfo, getGroupsByTier, getGroupsForProfile, } from './tool-config.js';
 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 { 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

@@ -14,6 +14,7 @@ export { ROLE_METADATA, ROLE_EXPERTISE, PREDEFINED_ROLE_IDS } from './types.js';
 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 { parseInputForMentions, getReferencedAgents, hasReferences, buildMessageWithContext, } from './mention-parser.js';
 export { ContextResolver, buildContextMap } from './context-resolver.js';
 // Agent selection

package/package.json

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