@compilr-dev/sdk 0.1.22 → 0.1.24

package/dist/capabilities/types.d.ts

@@ -39,7 +39,7 @@ export type CapabilityTier = 'upfront' | 'loadable' | 'forbidden';
 export interface LoadedCapability {
     packId: string;
     loadedAt: number;
-    trigger: 'upfront' | 'slash-command' | 'agent-self' | 'auto-detect';
+    trigger: 'upfront' | 'slash-command' | 'agent-self' | 'auto-detect' | 'auto-load';
 }
 /**
  * Catalog entry shown in the agent's system prompt for self-loading.

package/dist/index.d.ts

@@ -44,7 +44,7 @@ export { DEFAULT_MODELS, getContextWindow, DEFAULT_CONTEXT_WINDOW } from './mode
 export { type ModelTier, type TierInfo, type ProviderModelMap, MODEL_TIERS, TIER_INFO, isValidTier, type ThinkingFormat, type ModelStatus, type ModelInfo, MODEL_REGISTRY, getModelsForProvider, getModelsSortedForDisplay, getModelInfo, isKnownModel, isModelSupported, getThinkingFormat, getStatusIndicator, getStatusLabel, getDefaultModelForTier, areThinkingFormatsCompatible, shouldClearHistoryOnModelChange, getModelContextWindow, getModelDisplayName, getModelDescription, getModelForTier, getTierMappings, getTierDisplayName, getShortModelName, getDefaultTierMappings, type ProviderMetadata, type OthersProviderModel, PROVIDER_METADATA, TOGETHER_MODELS, GROQ_MODELS, FIREWORKS_MODELS, PERPLEXITY_MODELS, OPENROUTER_MODELS, getModelsForOthersProvider, getOthersProviders, getProviderMetadata, isOthersProvider, } from './models/index.js';
 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 type { MetaToolStats, MetaTools, FallbackOptions } from './meta-tools/index.js';
 export { CapabilityManager, CAPABILITY_PACKS, FORBIDDEN_PACK_SUGGESTIONS, getPackCount, getAllPackIds, createLoadCapabilityTool, generateCapabilityCatalog, } from './capabilities/index.js';
 export type { CapabilityPack, CapabilityTier, LoadedCapability, CapabilityCatalogEntry, CapabilityLoadResult, CapabilityManagerConfig, } from './capabilities/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';

package/dist/meta-tools/index.d.ts

@@ -13,4 +13,4 @@
  * // Use metaTools.createFallback() for transparent routing
  * ```
  */
-export { MetaToolsRegistry, createMetaTools, META_TOOLS_SYSTEM_PROMPT_PREFIX, type MetaToolStats, type MetaTools, } from './registry.js';
+export { MetaToolsRegistry, createMetaTools, META_TOOLS_SYSTEM_PROMPT_PREFIX, type MetaToolStats, type MetaTools, type FallbackOptions, } from './registry.js';

package/dist/meta-tools/registry.d.ts

@@ -21,6 +21,14 @@ export interface MetaToolStats {
     /** Estimated token savings vs declaring all tools directly */
     estimatedTokenSavings: number;
 }
+/**
+ * Options for the fallback handler created by createFallback().
+ */
+export interface FallbackOptions {
+    /** Called when a tool exists in the registry but is blocked by the filter.
+     *  Return true if the filter was updated and the tool should be retried. */
+    onFilteredTool?: (toolName: string) => boolean;
+}
 /**
  * The set of meta-tools and fallback handler returned by createMetaTools().
  */
@@ -32,7 +40,7 @@ export interface MetaTools {
     /** Executes any registered tool by name */
     useToolTool: Tool;
     /** Creates a fallback handler for transparent tool routing */
-    createFallback: () => (name: string, input: Record<string, unknown>) => Promise<ToolExecutionResult | null>;
+    createFallback: (options?: FallbackOptions) => (name: string, input: Record<string, unknown>) => Promise<ToolExecutionResult | null>;
 }
 export declare class MetaToolsRegistry {
     private readonly toolRegistry;

package/dist/meta-tools/registry.js

@@ -293,7 +293,7 @@ export function createMetaTools(registry) {
     // -------------------------------------------------------------------------
     // Fallback handler factory
     // -------------------------------------------------------------------------
-    function createFallback() {
+    function createFallback(options) {
         return async (name, input) => {
             // Check if tool exists in registry
             const tool = registry.getTool(name);
@@ -302,12 +302,18 @@ export function createMetaTools(registry) {
             }
             // Check tool filter
             if (!registry.isToolAllowed(name)) {
-                const filter = registry.getFilter();
-                const allowedTools = filter
-                    ? Array.from(filter).filter((t) => registry.getTool(t) !== undefined)
-                    : [];
-                return createErrorResult(`Tool '${name}' is not available for this agent. ` +
-                    `Available tools: ${allowedTools.slice(0, 10).join(', ')}${allowedTools.length > 10 ? '...' : ''}`);
+                // Give consumer a chance to load the capability and update the filter
+                if (options?.onFilteredTool?.(name) && registry.isToolAllowed(name)) {
+                    // Filter updated — fall through to execute
+                }
+                else {
+                    const filter = registry.getFilter();
+                    const allowedTools = filter
+                        ? Array.from(filter).filter((t) => registry.getTool(t) !== undefined)
+                        : [];
+                    return createErrorResult(`Tool '${name}' is not available for this agent. ` +
+                        `Available tools: ${allowedTools.slice(0, 10).join(', ')}${allowedTools.length > 10 ? '...' : ''}`);
+                }
             }
             // Coerce arguments before validation (handles LLM mistakes without guided decoding)
             const toolSchema = tool.definition.inputSchema;

package/dist/platform/tools/document-tools.js

@@ -7,6 +7,15 @@
  * Ported from CLI's src/tools/document-db.ts.
  */
 import { defineTool, createSuccessResult, createErrorResult } from '@compilr-dev/agents';
+/** All valid document types — keep in sync with DocumentType. */
+const DOC_TYPE_ENUM = [
+    'prd',
+    'architecture',
+    'design',
+    'notes',
+    'plan',
+    'app-model',
+];
 // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export function createDocumentTools(config) {
     const { context: ctx } = config;
@@ -21,7 +30,7 @@ export function createDocumentTools(config) {
             properties: {
                 doc_type: {
                     type: 'string',
-                    enum: ['prd', 'architecture', 'design', 'notes'],
+                    enum: DOC_TYPE_ENUM,
                     description: 'Document type',
                 },
                 title: {
@@ -80,7 +89,7 @@ export function createDocumentTools(config) {
             properties: {
                 doc_type: {
                     type: 'string',
-                    enum: ['prd', 'architecture', 'design', 'notes'],
+                    enum: DOC_TYPE_ENUM,
                     description: 'Document type to retrieve',
                 },
                 project_id: {
@@ -174,7 +183,7 @@ export function createDocumentTools(config) {
             properties: {
                 doc_type: {
                     type: 'string',
-                    enum: ['prd', 'architecture', 'design', 'notes'],
+                    enum: DOC_TYPE_ENUM,
                     description: 'Document type to delete',
                 },
                 project_id: {

package/package.json

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