@fragments-sdk/context 0.3.2 → 0.3.3

package/LICENSE

@@ -1,10 +1,7 @@
 Functional Source License, Version 1.1, MIT Future License
 
 Licensor:  Conan McNicholl
-Software:  Fragments SDK (@fragments-sdk/cli, @fragments-sdk/mcp, @fragments-sdk/context)
-
-IMPORTANT: The @fragments-sdk/ui package is licensed separately under the MIT License.
-See libs/ui/LICENSE for details.
+Software:  @fragments-sdk/context
 
 ---
 

package/README.md

@@ -60,3 +60,5 @@ pnpm add @fragments-sdk/context
 ```
 
 Requires Node.js 18+. Tree-sitter WASM grammars are included as dependencies.
+
+<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=a02beb71-df11-498d-8e1f-39de2e64ce5b" />

package/dist/{chunk-HAJWPNLU.js → chunk-NECSN43I.js}

@@ -38,9 +38,18 @@ var MCP_TOOL_DEFINITIONS = [
         type: "boolean",
         description: "If true, includes code examples for each variant"
       },
+      limit: {
+        type: "number",
+        description: "Maximum number of results to return (default: 10 for useCase mode)"
+      },
       includeRelations: {
         type: "boolean",
         description: "If true, includes component relationships"
+      },
+      verbosity: {
+        type: "string",
+        enum: ["compact", "standard", "full"],
+        description: 'Response detail level: "compact" (names only), "standard" (default), "full" (everything including code)'
       }
     }
   },
@@ -55,7 +64,7 @@ var MCP_TOOL_DEFINITIONS = [
       fields: {
         type: "array",
         items: { type: "string" },
-        description: 'Specific fields to return (e.g., ["meta", "usage.when", "contract.propsSummary", "props", "examples", "guidelines"]). If omitted, returns everything. Supports dot notation.'
+        description: 'Specific fields to return (e.g., ["meta", "guidelines.when", "contract.propsSummary", "props", "examples"]). If omitted, returns everything. Supports dot notation. Aliases: "usage" \u2192 "guidelines".'
       },
       variant: {
         type: "string",
@@ -68,6 +77,11 @@ var MCP_TOOL_DEFINITIONS = [
       maxLines: {
         type: "number",
         description: "Maximum lines per code example (truncates longer examples)"
+      },
+      verbosity: {
+        type: "string",
+        enum: ["compact", "standard", "full"],
+        description: 'Response detail level: "compact" (meta + prop names), "standard" (default), "full" (everything)'
       }
     },
     required: ["component"]
@@ -91,6 +105,15 @@ var MCP_TOOL_DEFINITIONS = [
       category: {
         type: "string",
         description: 'Filter by category (e.g., "authentication", "marketing", "dashboard", "settings", "ecommerce", "ai")'
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of blocks to return (default: all matching)"
+      },
+      verbosity: {
+        type: "string",
+        enum: ["compact", "standard", "full"],
+        description: 'Response detail level: "compact" (no code), "standard" (default, code preview for long blocks), "full" (full code)'
       }
     }
   },
@@ -105,6 +128,10 @@ var MCP_TOOL_DEFINITIONS = [
       search: {
         type: "string",
         description: 'Search token names (e.g., "accent", "hover", "padding")'
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of tokens to return per category (default: 25 for search, unlimited for category browsing)"
       }
     }
   },
@@ -115,6 +142,15 @@ var MCP_TOOL_DEFINITIONS = [
       useCase: {
         type: "string",
         description: 'What you want to implement (e.g., "login form", "data table with sorting", "streaming chat messages")'
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of components to return (default: 5)"
+      },
+      verbosity: {
+        type: "string",
+        enum: ["compact", "standard", "full"],
+        description: 'Response detail level: "compact" (names only), "standard" (default), "full" (all props + examples + full block code)'
       }
     },
     required: ["useCase"]
@@ -151,7 +187,7 @@ var MCP_TOOL_DEFINITIONS = [
       },
       variant: {
         type: "string",
-        description: "Variant name for compare mode"
+        description: "Variant name to render (uses the variant's render function from the fragment definition). Works in both render and compare modes."
       },
       threshold: {
         type: "number",
@@ -182,7 +218,7 @@ var MCP_TOOL_DEFINITIONS = [
   },
   {
     key: "graph",
-    description: 'Query the component relationship graph. Understand dependencies, impact analysis, composition trees, alternatives, and design system health. Use "health" for an overview, "dependencies"/"dependents" for direct relationships, "impact" for change analysis, "composition" for compound component trees.',
+    description: 'Query the component relationship graph. Understand dependencies, impact analysis, composition trees, alternatives, and design system health. Use "health" for an overview, "dependencies"/"dependents" for composition and declared relationships (not code-level imports), "impact" for change analysis, "composition" for compound component trees.',
     params: {
       mode: {
         type: "string",

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   MCP_TOOL_DEFINITIONS,
   buildMcpTools,
   buildToolNames
-} from "./chunk-HAJWPNLU.js";
+} from "./chunk-NECSN43I.js";
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES

package/dist/mcp-tools/index.js

@@ -3,7 +3,7 @@ import {
   MCP_TOOL_DEFINITIONS,
   buildMcpTools,
   buildToolNames
-} from "../chunk-HAJWPNLU.js";
+} from "../chunk-NECSN43I.js";
 export {
   CLI_TOOL_EXTENSIONS,
   MCP_TOOL_DEFINITIONS,

package/package.json

@@ -1,8 +1,10 @@
 {
   "name": "@fragments-sdk/context",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "license": "FSL-1.1-MIT",
   "description": "Code intelligence and RAG primitives for design system and codebase indexing",
+  "author": "Conan McNicholl",
+  "homepage": "https://usefragments.com",
   "repository": {
     "type": "git",
     "url": "https://github.com/ConanMcN/fragments"
@@ -73,7 +75,11 @@
   "files": [
     "dist"
   ],
+  "scarfSettings": {
+    "defaultOptIn": true
+  },
   "dependencies": {
+    "@scarf/scarf": "^1.4.0",
     "tree-sitter-go": "^0.25.0",
     "tree-sitter-java": "^0.23.5",
     "tree-sitter-javascript": "^0.25.0",