@compilr-dev/sdk 0.1.17 → 0.1.19

package/dist/index.d.ts

@@ -45,7 +45,7 @@ export { type ModelTier, type TierInfo, type ProviderModelMap, MODEL_TIERS, TIER
 export { assembleTools, deduplicateTools } from './tools.js';
 export { MetaToolsRegistry, createMetaTools, META_TOOLS_SYSTEM_PROMPT_PREFIX, } from './meta-tools/index.js';
 export type { MetaToolStats, MetaTools } from './meta-tools/index.js';
-export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './system-prompt/index.js';
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, FACTORY_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './system-prompt/index.js';
 export type { SystemPromptContext, BuildResult, SystemPromptModule, ModuleConditions, } from './system-prompt/index.js';
 export type { ProjectType, ProjectStatus, RepoPattern, WorkflowMode, LifecycleState, WorkItemType, WorkItemStatus, WorkItemPriority, GuidedStep, DocumentType, PlanStatus, Project, WorkItem, ProjectDocument, Plan, PlanSummary, PlanWithWorkItem, HistoryEntry, CreateProjectInput, UpdateProjectInput, ProjectListOptions, CreateWorkItemInput, UpdateWorkItemInput, QueryWorkItemsInput, CreateDocumentInput, UpdateDocumentInput, CreatePlanInput, UpdatePlanInput, ListPlansOptions, WorkItemQueryResult, ProjectListResult, BulkCreateItem, IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, IAnchorService, IArtifactService, IEpisodeService, AnchorData, ArtifactType, ArtifactData, ArtifactSummaryData, WorkEpisode, ProjectWorkSummary, PlatformContext, PlatformToolsConfig, PlatformHooks, StepCriteria, } from './platform/index.js';
 export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, } from './platform/index.js';

package/dist/index.js

@@ -71,7 +71,7 @@ export {
 // Builder
 SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, 
 // Module constants
-ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, 
+ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, FACTORY_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, 
 // Module utilities
 shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './system-prompt/index.js';
 // =============================================================================

package/dist/provider.d.ts

@@ -16,6 +16,7 @@ export declare function createProviderFromType(type: ProviderType, options?: {
     apiKey?: string;
     baseUrl?: string;
     siteName?: string;
+    estimateTokens?: (text: string) => number;
 }): LLMProvider;
 /**
  * Resolve a provider from config.

package/dist/provider.js

@@ -32,29 +32,29 @@ export function detectProviderFromEnv() {
  * Create an LLM provider from a provider type string.
  */
 export function createProviderFromType(type, options) {
-    const { model, apiKey, baseUrl, siteName } = options ?? {};
+    const { model, apiKey, baseUrl, siteName, estimateTokens } = options ?? {};
     switch (type) {
         case 'claude':
-            return createClaudeProvider({ model, apiKey });
+            return createClaudeProvider({ model, apiKey, estimateTokens });
         case 'openai':
-            return createOpenAIProvider({ model, apiKey });
+            return createOpenAIProvider({ model, apiKey, estimateTokens });
         case 'gemini':
-            return createGeminiNativeProvider({ model, apiKey });
+            return createGeminiNativeProvider({ model, apiKey, estimateTokens });
         case 'ollama':
-            return createOllamaProvider({ model, baseUrl });
+            return createOllamaProvider({ model, baseUrl, estimateTokens });
         case 'together':
-            return createTogetherProvider({ model, apiKey });
+            return createTogetherProvider({ model, apiKey, estimateTokens });
         case 'groq':
-            return createGroqProvider({ model, apiKey });
+            return createGroqProvider({ model, apiKey, estimateTokens });
         case 'fireworks':
-            return createFireworksProvider({ model, apiKey });
+            return createFireworksProvider({ model, apiKey, estimateTokens });
         case 'perplexity':
-            return createPerplexityProvider({ model, apiKey });
+            return createPerplexityProvider({ model, apiKey, estimateTokens });
         case 'openrouter':
-            return createOpenRouterProvider({ model, apiKey, siteName });
+            return createOpenRouterProvider({ model, apiKey, siteName, estimateTokens });
         case 'custom':
             // Custom endpoints use OpenAI-compatible format
-            return createOpenAIProvider({ model, apiKey });
+            return createOpenAIProvider({ model, apiKey, estimateTokens });
     }
 }
 /**

package/dist/system-prompt/index.d.ts

@@ -31,4 +31,4 @@
  * ```
  */
 export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, type SystemPromptContext, type BuildResult, } from './builder.js';
-export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, type SystemPromptModule, type ModuleConditions, } from './modules.js';
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, FACTORY_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, type SystemPromptModule, type ModuleConditions, } from './modules.js';

package/dist/system-prompt/index.js

@@ -31,4 +31,4 @@
  * ```
  */
 export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, } from './builder.js';
-export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './modules.js';
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, FACTORY_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './modules.js';

package/dist/system-prompt/modules.d.ts

@@ -74,6 +74,11 @@ export declare const TOOL_USAGE_HINTS_MODULE: SystemPromptModule;
  * Only included when meta-tools are enabled
  */
 export declare const PLATFORM_TOOL_HINTS_MODULE: SystemPromptModule;
+/**
+ * Factory tool hints module - behavioral guidance for app_model_* and factory_* tools
+ * Only included when meta-tools are enabled
+ */
+export declare const FACTORY_TOOL_HINTS_MODULE: SystemPromptModule;
 /**
  * Tool usage module (meta-tools) - only if enableMetaTools=true
  * Explains how to use specialized tools via meta-tools

package/dist/system-prompt/modules.js

@@ -179,6 +179,26 @@ export const PLATFORM_TOOL_HINTS_MODULE = {
 - **Artifacts**: Types: design, plan, review, decision, note. Names must be unique within team.
 - **recall_work**: Check before destructive ops to see what work would be affected.`,
 };
+/**
+ * Factory tool hints module - behavioral guidance for app_model_* and factory_* tools
+ * Only included when meta-tools are enabled
+ */
+export const FACTORY_TOOL_HINTS_MODULE = {
+    id: 'factory-tool-hints',
+    name: 'Factory Tool Hints',
+    estimatedTokens: 180,
+    conditions: { enableMetaTools: true },
+    content: `## Factory Tool Hints (app_model_update)
+
+Common operations:
+- **updateIdentity**: \`{ op: "updateIdentity", updates: { name: "My App", description: "..." } }\`
+- **updateTechStack**: \`{ op: "updateTechStack", updates: { toolkit: "react-node" } }\` — toolkits: react-node, next-prisma, static-landing, react-fastapi, react-go
+- **addEntity**: \`{ op: "addEntity", entity: { name: "Task", pluralName: "Tasks", icon: "📋", fields: [{ name: "title", label: "Title", type: "string", required: true }], views: ["list","detail","card"], relationships: [] } }\`
+- **addField**: \`{ op: "addField", entity: "Task", field: { name: "dueDate", label: "Due Date", type: "date", required: false } }\` — types: string, number, boolean, date, enum
+- **addRelationship**: \`{ op: "addRelationship", entity: "Task", relationship: { type: "belongsTo", target: "Project" } }\` — types: belongsTo, hasMany
+- **Section updates**: updateFeatures, updateTheme, updateLayout — pass \`updates\` object with partial changes
+- **Destructive**: removeEntity (use force:true), removeField, removeRelationship`,
+};
 /**
  * Tool usage module (meta-tools) - only if enableMetaTools=true
  * Explains how to use specialized tools via meta-tools
@@ -332,6 +352,7 @@ export const ALL_MODULES = [
     TOOL_USAGE_DIRECT_MODULE,
     TOOL_USAGE_HINTS_MODULE,
     PLATFORM_TOOL_HINTS_MODULE, // Conditional: enableMetaTools
+    FACTORY_TOOL_HINTS_MODULE, // Conditional: enableMetaTools
     TOOL_USAGE_META_MODULE, // Conditional: enableMetaTools
     DELEGATION_MODULE,
     GIT_SAFETY_MODULE, // Conditional: hasGit

package/package.json

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