@compilr-dev/sdk 0.1.13 → 0.1.15

package/LICENSE

@@ -1,13 +1,100 @@
-MIT License
+Functional Source License, Version 1.1, MIT Future License
 
-Copyright (c) 2026 Carmelo Scozzola
+Abbreviation: FSL-1.1-MIT
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Notice
+
+Copyright 2026 Carmelo Scozzola
+
+Terms and Conditions
+
+Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.

package/README.md

@@ -13,7 +13,7 @@
 > Universal agent runtime for building AI-powered applications
 
 [![npm version](https://img.shields.io/npm/v/@compilr-dev/sdk.svg)](https://www.npmjs.com/package/@compilr-dev/sdk)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![License: FSL-1.1-MIT](https://img.shields.io/badge/License-FSL--1.1--MIT-blue.svg)](https://fsl.software/)
 
 > [!WARNING]
 > This package is in beta. APIs may change between minor versions.
@@ -127,7 +127,7 @@ await team.run('Add rate limiting to the API');
 
 ## License
 
-MIT - See [LICENSE](LICENSE) for details.
+[FSL-1.1-MIT](https://fsl.software/) - See [LICENSE](LICENSE) for details. Converts to MIT after 2 years per version.
 
 ---
 

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

@@ -27,7 +27,7 @@ export interface MetaToolStats {
 export interface MetaTools {
     /** Lists available tools by category */
     listToolsTool: Tool;
-    /** Returns the JSON schema for a tool's parameters */
+    /** Returns compact parameter info for a tool */
     getToolInfoTool: Tool;
     /** Executes any registered tool by name */
     useToolTool: Tool;
@@ -91,4 +91,4 @@ export declare class MetaToolsRegistry {
  * Create the three meta-tools + fallback handler, all bound to a registry instance.
  */
 export declare function createMetaTools(registry: MetaToolsRegistry): MetaTools;
-export declare const META_TOOLS_SYSTEM_PROMPT_PREFIX = "\n## Tool Index (Specialized Tools)\n\nThese tools are called **exactly like direct tools** \u2014 just use the tool name with parameters. No special syntax or wrapper needed. The system routes them automatically.\n\n**IMPORTANT \u2014 These are CLI system tools, NOT your project's backend. Never use localhost/curl to access them.**\n\n**Parameter Rules:**\n- For **zero-parameter calls**: call the tool directly (e.g., `workitem_query()`, `git_status()`).\n- For **calls WITH parameters**: you MUST call `get_tool_info(\"tool_name\")` first to get the exact JSON schema. The signatures below are summaries only \u2014 do NOT guess parameter structure from them.\n- After a failed tool call, always call `get_tool_info()` before retrying.\n\n";
+export declare const META_TOOLS_SYSTEM_PROMPT_PREFIX = "\n## Tool Index (Specialized Tools)\n\nThese tools are called **exactly like direct tools** \u2014 just use the tool name with parameters. No special syntax or wrapper needed. The system routes them automatically.\n\n**IMPORTANT \u2014 These are CLI system tools, NOT your project's backend. Never use localhost/curl to access them.**\n\n**Parameter Rules:**\n- For **zero-parameter calls**: call the tool directly (e.g., `workitem_query()`, `git_status()`).\n- For **calls WITH parameters**: you MUST call `get_tool_info(\"tool_name\")` first to get parameter details. The signatures below are summaries only \u2014 do NOT guess parameter structure from them.\n- After a failed tool call, always call `get_tool_info()` before retrying.\n\n";

package/dist/meta-tools/registry.js

@@ -187,7 +187,7 @@ export function createMetaTools(registry) {
     // -------------------------------------------------------------------------
     const getToolInfoTool = defineTool({
         name: 'get_tool_info',
-        description: "Get the exact JSON schema for a tool's parameters. " +
+        description: "Get a tool's parameter signature and descriptions. " +
             'MUST be called before passing any parameters to a Tool Index tool. ' +
             'Zero-parameter calls do not need this.',
         inputSchema: {
@@ -211,11 +211,7 @@ export function createMetaTools(registry) {
                     `Available tools include: ${availableTools.join(', ')}... ` +
                     `Check the Tool Index for the full list.`));
             }
-            return Promise.resolve(createSuccessResult({
-                name: tool.definition.name,
-                description: tool.definition.description,
-                parameters: tool.definition.inputSchema,
-            }));
+            return Promise.resolve(createSuccessResult(buildCompactSchema(tool)));
         },
     });
     // -------------------------------------------------------------------------
@@ -267,9 +263,8 @@ export function createMetaTools(registry) {
             // 2. Validate args
             const validationError = registry.validateArgs(tool_name, args);
             if (validationError) {
-                return createErrorResult(`Invalid arguments for '${tool_name}': ${validationError}. ` +
-                    `Expected schema: ${JSON.stringify(tool.definition.inputSchema, null, 2)}. ` +
-                    `Hint: Call get_tool_info("${tool_name}") to see full parameter details.`);
+                return createErrorResult(`Invalid arguments for '${tool_name}': ${validationError}.\n` +
+                    `Expected:\n${buildCompactSchema(tool)}`);
             }
             // 3. Execute the tool
             try {
@@ -347,7 +342,7 @@ These tools are called **exactly like direct tools** — just use the tool name
 
 **Parameter Rules:**
 - For **zero-parameter calls**: call the tool directly (e.g., \`workitem_query()\`, \`git_status()\`).
-- For **calls WITH parameters**: you MUST call \`get_tool_info("tool_name")\` first to get the exact JSON schema. The signatures below are summaries only — do NOT guess parameter structure from them.
+- For **calls WITH parameters**: you MUST call \`get_tool_info("tool_name")\` first to get parameter details. The signatures below are summaries only — do NOT guess parameter structure from them.
 - After a failed tool call, always call \`get_tool_info()\` before retrying.
 
 `;
@@ -372,6 +367,22 @@ function getCategoryName(prefix) {
     };
     return categoryMap[prefix] ?? 'Other';
 }
+/**
+ * Resolve a compact type string from a JSON Schema property.
+ */
+function resolveCompactType(prop) {
+    const type = typeof prop.type === 'string' ? prop.type : 'any';
+    if (type === 'array') {
+        const items = prop.items;
+        const itemType = typeof items?.type === 'string' ? items.type : 'any';
+        return `${itemType}[]`;
+    }
+    if (type === 'boolean')
+        return 'bool';
+    if (type === 'integer')
+        return 'int';
+    return type;
+}
 /**
  * Build a concise signature for a tool.
  * e.g., "git_commit(message: string, files?: string[]) - Create a commit"
@@ -383,7 +394,7 @@ function buildToolSignature(tool) {
         const required = new Set(schema.required ?? []);
         for (const [name, prop] of Object.entries(schema.properties)) {
             const isRequired = required.has(name);
-            const type = prop.type ?? 'any';
+            const type = resolveCompactType(prop);
             params.push(isRequired ? `${name}: ${type}` : `${name}?: ${type}`);
         }
     }
@@ -391,6 +402,51 @@ function buildToolSignature(tool) {
     const desc = tool.definition.description.split('.')[0]; // First sentence
     return `${tool.definition.name}(${paramsStr}) - ${desc}`;
 }
+/**
+ * Build a compact schema string for get_tool_info responses.
+ * Includes signature, full description, and per-parameter details.
+ *
+ * Example output:
+ *   git_commit(message: string, files?: string[], amend?: bool)
+ *     Create a git commit with the specified message.
+ *     - message: The commit message (required)
+ *     - files: Files to stage before committing
+ *     - amend: Amend the last commit instead of creating new
+ */
+function buildCompactSchema(tool) {
+    const schema = tool.definition.inputSchema;
+    const required = new Set(schema.required ?? []);
+    const params = [];
+    const paramDetails = [];
+    if (schema.properties) {
+        for (const [name, prop] of Object.entries(schema.properties)) {
+            const isRequired = required.has(name);
+            const type = resolveCompactType(prop);
+            params.push(isRequired ? `${name}: ${type}` : `${name}?: ${type}`);
+            // Build parameter detail line
+            const desc = prop.description;
+            const enumValues = prop.enum;
+            let detail = `- ${name}`;
+            if (desc) {
+                detail += `: ${desc}`;
+            }
+            if (enumValues) {
+                detail += ` (${enumValues.map((v) => `"${v}"`).join('|')})`;
+            }
+            if (isRequired) {
+                detail += ' (required)';
+            }
+            paramDetails.push(detail);
+        }
+    }
+    const paramsStr = params.join(', ');
+    const lines = [`${tool.definition.name}(${paramsStr})`];
+    lines.push(`  ${tool.definition.description}`);
+    for (const detail of paramDetails) {
+        lines.push(`  ${detail}`);
+    }
+    return lines.join('\n');
+}
 /**
  * Format AJV validation errors into a readable string.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -44,7 +44,7 @@
     "anthropic"
   ],
   "author": "Carmelo Scozzola",
-  "license": "MIT",
+  "license": "FSL-1.1-MIT",
   "bugs": {
     "url": "https://github.com/compilr-dev/sdk/issues"
   },