@compilr-dev/sdk 0.1.25 → 0.1.27

package/dist/capabilities/catalog.js

@@ -18,11 +18,12 @@ export function generateCapabilityCatalog(catalog, loadedPackIds) {
     const lines = [
         '## Available Capabilities',
         '',
-        'Call `load_capability("name")` to activate additional tools:',
+        'These tools are available but not yet loaded. Just call any tool by name — it will auto-load:',
     ];
     for (const entry of catalog) {
         const readOnlySuffix = entry.readOnly ? ', read-only' : '';
-        lines.push(`- ${entry.id}: ${entry.label} (${String(entry.toolCount)} tools${readOnlySuffix})`);
+        const toolList = entry.tools.join(', ');
+        lines.push(`- **${entry.label}** (${entry.id}${readOnlySuffix}): ${toolList}`);
     }
     if (loadedPackIds.length > 0) {
         lines.push('');

package/dist/capabilities/manager.js

@@ -158,6 +158,7 @@ export class CapabilityManager {
                     label: pack.label,
                     toolCount: pack.tools.length,
                     readOnly: pack.readOnly,
+                    tools: pack.tools,
                 });
             }
         }

package/dist/capabilities/types.d.ts

@@ -49,6 +49,8 @@ export interface CapabilityCatalogEntry {
     label: string;
     toolCount: number;
     readOnly: boolean;
+    /** Tool names in this pack (for agent awareness — enables auto-load on first call) */
+    tools: readonly string[];
 }
 /**
  * Result of attempting to load capabilities (e.g., for a skill invocation).

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

@@ -22,8 +22,12 @@ export interface SystemPromptContext {
     enableMetaTools?: boolean;
     /** Does the agent have a role-specific identity? (team agents) */
     hasRoleIdentity?: boolean;
-    /** Active project name (for explicit identification) */
+    /** Active project display name (human-readable, e.g. "Hr Manager") */
     projectName?: string;
+    /** Active project slug (unique identifier, e.g. "hr-manager") */
+    projectSlug?: string;
+    /** Active project ID (numeric database identifier) */
+    projectId?: number;
     /** Project context from COMPILR.md (appended at end) */
     projectContext?: string;
     /** Guided mode context (appended at end) */
@@ -79,6 +83,10 @@ export declare class SystemPromptBuilder {
      * Build the system prompt based on current context
      */
     build(): BuildResult;
+    /**
+     * Build project metadata lines (name, slug, ID) for the system prompt.
+     */
+    private buildProjectMeta;
     /**
      * Build and return just the prompt string
      */

package/dist/system-prompt/builder.js

@@ -168,10 +168,12 @@ export class SystemPromptBuilder {
             const projectHeader = this.context.projectName
                 ? `## Project Context (${this.context.projectName})`
                 : '## Project Context';
-            prompt += `\n\n---\n\n${projectHeader}\n\nThe following is project-specific context loaded from COMPILR.md:\n\n${this.context.projectContext}`;
+            const projectMeta = this.buildProjectMeta();
+            prompt += `\n\n---\n\n${projectHeader}${projectMeta}\n\nThe following is project-specific context loaded from COMPILR.md:\n\n${this.context.projectContext}`;
         }
         else if (this.context.projectName) {
-            prompt += `\n\n---\n\n## Active Project\n\nThe current project is: **${this.context.projectName}**`;
+            const projectMeta = this.buildProjectMeta();
+            prompt += `\n\n---\n\n## Active Project${projectMeta}`;
         }
         // Append guided mode context if provided
         if (this.context.guidedModeContext) {
@@ -196,6 +198,22 @@ export class SystemPromptBuilder {
             estimatedTokens: baseTokens + appendedTokens,
         };
     }
+    /**
+     * Build project metadata lines (name, slug, ID) for the system prompt.
+     */
+    buildProjectMeta() {
+        const lines = [];
+        if (this.context.projectName) {
+            lines.push(`- **Name:** ${this.context.projectName}`);
+        }
+        if (this.context.projectSlug) {
+            lines.push(`- **Slug:** \`${this.context.projectSlug}\` (unique identifier — use this for tool lookups)`);
+        }
+        if (this.context.projectId !== undefined) {
+            lines.push(`- **ID:** ${String(this.context.projectId)}`);
+        }
+        return lines.length > 0 ? '\n\n' + lines.join('\n') : '';
+    }
     /**
      * Build and return just the prompt string
      */

package/package.json

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