@compilr-dev/sdk 0.9.9 → 0.9.11

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.d.ts

@@ -19,6 +19,8 @@ export interface CustomAgentDefinition {
     toolConfig?: ToolConfig;
     enabledSkills?: string[];
     modelTier?: ModelTier;
+    /** Custom instructions appended to the agent's system prompt (max 2000 chars) */
+    systemPromptAddition?: string;
 }
 export type { ToolConfig, ToolProfile };
 /**
@@ -65,4 +67,4 @@ export declare function isAgentIdTaken(id: string, existingCustomAgents: CustomA
 /**
  * Create a new CustomAgentDefinition with auto-assigned mascot.
  */
-export declare function createCustomAgentDefinition(id: string, displayName: string, specialty: string, personality: string | undefined, existingAgents: CustomAgentDefinition[], toolConfig?: ToolConfig, enabledSkills?: string[], modelTier?: ModelTier): CustomAgentDefinition;
+export declare function createCustomAgentDefinition(id: string, displayName: string, specialty: string, personality: string | undefined, existingAgents: CustomAgentDefinition[], toolConfig?: ToolConfig, enabledSkills?: string[], modelTier?: ModelTier, systemPromptAddition?: string): CustomAgentDefinition;

package/dist/team/custom-agents.js

@@ -62,6 +62,15 @@ export function generateCustomAgentSystemPrompt(agent) {
     }
     lines.push('');
     lines.push('Focus on your area of expertise. When questions fall outside your specialty, suggest which team member might be better suited to help.');
+    // Append custom instructions if provided
+    if (agent.systemPromptAddition?.trim()) {
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+        lines.push('## Custom Instructions');
+        lines.push('');
+        lines.push(agent.systemPromptAddition.trim());
+    }
     // Add tool awareness if agent has tool restrictions
     const toolConfig = agent.toolConfig ?? createDefaultToolConfig();
     if (toolConfig.profile !== 'full') {
@@ -135,7 +144,7 @@ export function isAgentIdTaken(id, existingCustomAgents, teamAgentIds, predefine
 /**
  * Create a new CustomAgentDefinition with auto-assigned mascot.
  */
-export function createCustomAgentDefinition(id, displayName, specialty, personality, existingAgents, toolConfig, enabledSkills, modelTier) {
+export function createCustomAgentDefinition(id, displayName, specialty, personality, existingAgents, toolConfig, enabledSkills, modelTier, systemPromptAddition) {
     return {
         id,
         displayName,
@@ -146,5 +155,6 @@ export function createCustomAgentDefinition(id, displayName, specialty, personal
         toolConfig: toolConfig ?? createDefaultToolConfig(),
         enabledSkills: enabledSkills ?? [], // Empty = all skills
         modelTier: modelTier ?? 'balanced', // Default tier
+        systemPromptAddition: systemPromptAddition?.trim() || undefined,
     };
 }

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.9",
+  "version": "0.9.11",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",