llmist 0.1.6 → 0.2.1

package/README.md

@@ -110,13 +110,13 @@ console.log(answer); // "15 times 23 equals 345"
 ```typescript
 // Use model shortcuts
 .withModel('gpt-5-nano')    // OpenAI gpt-5-nano
-.withModel('sonnet')       // Claude 3.5 Sonnet
-.withModel('haiku')        // Claude 3.5 Haiku
+.withModel('sonnet')       // Claude Sonnet 4.5
+.withModel('haiku')        // Claude Haiku 4.5
 .withModel('flash')        // Gemini 2.0 Flash
 
 // Or full names
 .withModel('openai:gpt-5-nano')
-.withModel('anthropic:claude-3-5-sonnet-latest')
+.withModel('anthropic:claude-sonnet-4-5')
 .withModel('gemini:gemini-2.0-flash')
 ```
 
@@ -288,7 +288,7 @@ for await (const event of agent.run()) {
 ### 🧪 Mock Testing
 
 ```typescript
-import { mockLLM, createMockClient } from 'llmist';
+import { LLMist, mockLLM, createMockClient } from 'llmist';
 
 mockLLM()
   .forModel('gpt-5')
@@ -296,8 +296,8 @@ mockLLM()
   .returns('The answer is 42')
   .register();
 
-const answer = await LLMist.createAgent()
-  .withClient(createMockClient())
+const mockClient = createMockClient();
+const answer = await mockClient.createAgent()
   .withModel('gpt-5')
   .askAndCollect('Calculate 2 + 2');
 
@@ -312,12 +312,12 @@ console.log(answer); // "The answer is 42" - no API call made!
 const client = new LLMist();
 
 // Get model specs
-const gpt4 = client.modelRegistry.getModelSpec('openai:gpt-4');
-console.log(gpt4.contextWindow);    // 128000
-console.log(gpt4.pricing.input);    // 10.0 per 1M tokens
+const gpt5 = client.modelRegistry.getModelSpec('gpt-5');
+console.log(gpt5.contextWindow);    // 272000
+console.log(gpt5.pricing.input);    // 1.25 per 1M tokens
 
 // Estimate costs
-const cost = client.modelRegistry.estimateCost('openai:gpt-4', 10_000, 2_000);
+const cost = client.modelRegistry.estimateCost('gpt-5', 10_000, 2_000);
 console.log(`$${cost.totalCost.toFixed(4)}`);
 
 // Find cheapest model
@@ -335,7 +335,7 @@ const messages = [
 ];
 
 const tokens = await client.countTokens('openai:gpt-5', messages);
-const cost = client.modelRegistry.estimateCost('openai:gpt-5', tokens, 1000);
+const cost = client.modelRegistry.estimateCost('gpt-5', tokens, 1000);
 ```
 
 Uses provider-specific methods (tiktoken for OpenAI, native APIs for Anthropic/Gemini).
@@ -438,6 +438,53 @@ Contributions welcome! Please ensure:
 4. ✅ Types are properly defined
 5. ✅ Examples/docs updated for API changes
 
+### Commit Message Convention
+
+This project follows [Conventional Commits](https://www.conventionalcommits.org/) specification. All commit messages must be formatted as:
+
+```
+<type>(<scope>): <subject>
+```
+
+**Types:**
+- `feat:` - New feature (triggers minor version bump)
+- `fix:` - Bug fix (triggers patch version bump)
+- `docs:` - Documentation only changes
+- `style:` - Code style changes (formatting, missing semi-colons, etc)
+- `refactor:` - Code refactoring without feature changes
+- `perf:` - Performance improvements
+- `test:` - Adding or updating tests
+- `build:` - Build system or dependency changes
+- `ci:` - CI configuration changes
+- `chore:` - Other changes that don't modify src or test files
+
+**Breaking Changes:** Add `BREAKING CHANGE:` in the footer to trigger major version bump.
+
+**Examples:**
+```bash
+feat(agent): add support for streaming tool calls
+fix(cli): prevent crash on invalid gadget path
+docs: update API documentation for v2
+```
+
+**Note:** Git hooks will validate your commit messages locally.
+
+### Release Process
+
+Releases are fully automated using [semantic-release](https://github.com/semantic-release/semantic-release):
+
+1. Merge PR to `main` branch
+2. CI workflow runs automatically
+3. If CI passes, release workflow:
+   - Analyzes commits since last release
+   - Determines version bump based on commit types
+   - Updates `package.json` and `CHANGELOG.md`
+   - Creates git tag and GitHub release
+   - Publishes to npm
+   - Syncs changes back to `dev` branch
+
+**No manual version bumps needed!**
+
 ---
 
 ## 📄 License

package/dist/{chunk-MO5ONHPZ.js → chunk-I55AV3WV.js}

@@ -1,6 +1,6 @@
 import {
   BaseGadget
-} from "./chunk-J3NCIWMY.js";
+} from "./chunk-VYBRYR2S.js";
 
 // src/gadgets/create-gadget.ts
 function createGadget(config) {
@@ -19,4 +19,4 @@ function createGadget(config) {
 export {
   createGadget
 };
-//# sourceMappingURL=chunk-MO5ONHPZ.js.map
+//# sourceMappingURL=chunk-I55AV3WV.js.map

package/dist/{chunk-PVHHXDCV.js → chunk-VRTKJK2X.js}

@@ -7,7 +7,7 @@ import {
   init_client,
   init_constants,
   init_logger
-} from "./chunk-J3NCIWMY.js";
+} from "./chunk-VYBRYR2S.js";
 
 // src/gadgets/validation.ts
 function validateAndApplyDefaults(schema, params) {
@@ -898,4 +898,4 @@ export {
   MockGadgetBuilder,
   mockGadget
 };
-//# sourceMappingURL=chunk-PVHHXDCV.js.map
+//# sourceMappingURL=chunk-VRTKJK2X.js.map

package/dist/{chunk-J3NCIWMY.js → chunk-VYBRYR2S.js}

@@ -91,17 +91,17 @@ var init_model_shortcuts = __esm({
       "gpt5-mini": "openai:gpt-5-mini",
       "gpt5-nano": "openai:gpt-5-nano",
       // Anthropic aliases
-      sonnet: "anthropic:claude-3-5-sonnet-latest",
-      "claude-sonnet": "anthropic:claude-3-5-sonnet-latest",
-      haiku: "anthropic:claude-3-5-haiku-latest",
-      "claude-haiku": "anthropic:claude-3-5-haiku-latest",
-      opus: "anthropic:claude-3-opus-latest",
-      "claude-opus": "anthropic:claude-3-opus-latest",
+      sonnet: "anthropic:claude-sonnet-4-5",
+      "claude-sonnet": "anthropic:claude-sonnet-4-5",
+      haiku: "anthropic:claude-haiku-4-5",
+      "claude-haiku": "anthropic:claude-haiku-4-5",
+      opus: "anthropic:claude-opus-4-5",
+      "claude-opus": "anthropic:claude-opus-4-5",
       // Gemini aliases
       flash: "gemini:gemini-2.0-flash",
       "gemini-flash": "gemini:gemini-2.0-flash",
-      "gemini-pro": "gemini:gemini-2.0-pro",
-      pro: "gemini:gemini-2.0-pro"
+      "gemini-pro": "gemini:gemini-2.5-pro",
+      pro: "gemini:gemini-2.5-pro"
     };
     KNOWN_MODEL_PATTERNS = [
       /^gpt-?\d/i,
@@ -1707,30 +1707,6 @@ var init_anthropic_models = __esm({
   "src/providers/anthropic-models.ts"() {
     "use strict";
     ANTHROPIC_MODELS = [
-      {
-        provider: "anthropic",
-        modelId: "claude-opus-4-5-20251124",
-        displayName: "Claude Opus 4.5",
-        contextWindow: 2e5,
-        maxOutputTokens: 64e3,
-        pricing: {
-          input: 5,
-          output: 25,
-          cachedInput: 0.5
-        },
-        knowledgeCutoff: "2025-03",
-        features: {
-          streaming: true,
-          functionCalling: true,
-          vision: true,
-          reasoning: true
-        },
-        metadata: {
-          family: "Claude 4",
-          releaseDate: "2025-11-24",
-          notes: "Most powerful model. 80.9% SWE-bench Verified, 66.3% OSWorld. Best for coding and computer use."
-        }
-      },
       {
         provider: "anthropic",
         modelId: "claude-sonnet-4-5-20250929",
@@ -1919,6 +1895,79 @@ var init_anthropic_models = __esm({
           releaseDate: "2024-03-07",
           notes: "Legacy model - upgrade to Haiku 4.5 for better performance"
         }
+      },
+      // Modern aliases (recommended by Anthropic)
+      {
+        provider: "anthropic",
+        modelId: "claude-haiku-4-5",
+        displayName: "Claude Haiku 4.5",
+        contextWindow: 2e5,
+        maxOutputTokens: 64e3,
+        pricing: {
+          input: 1,
+          output: 5,
+          cachedInput: 0.1
+        },
+        knowledgeCutoff: "2025-02",
+        features: {
+          streaming: true,
+          functionCalling: true,
+          vision: true,
+          reasoning: true
+        },
+        metadata: {
+          family: "Claude 4",
+          releaseDate: "2025-10-01",
+          notes: "Alias for claude-haiku-4-5-20251001. Fastest model with near-frontier intelligence."
+        }
+      },
+      {
+        provider: "anthropic",
+        modelId: "claude-sonnet-4-5",
+        displayName: "Claude Sonnet 4.5",
+        contextWindow: 2e5,
+        maxOutputTokens: 64e3,
+        pricing: {
+          input: 3,
+          output: 15,
+          cachedInput: 0.3
+        },
+        knowledgeCutoff: "2025-01",
+        features: {
+          streaming: true,
+          functionCalling: true,
+          vision: true,
+          reasoning: true
+        },
+        metadata: {
+          family: "Claude 4",
+          releaseDate: "2025-09-29",
+          notes: "Alias for claude-sonnet-4-5-20250929. Smartest model for complex agents and coding."
+        }
+      },
+      {
+        provider: "anthropic",
+        modelId: "claude-opus-4-5",
+        displayName: "Claude Opus 4.5",
+        contextWindow: 2e5,
+        maxOutputTokens: 64e3,
+        pricing: {
+          input: 5,
+          output: 25,
+          cachedInput: 0.5
+        },
+        knowledgeCutoff: "2025-03",
+        features: {
+          streaming: true,
+          functionCalling: true,
+          vision: true,
+          reasoning: true
+        },
+        metadata: {
+          family: "Claude 4",
+          releaseDate: "2025-11-24",
+          notes: "Alias for claude-opus-4-5-20251124. Most powerful model for coding and computer use."
+        }
       }
     ];
   }
@@ -4445,4 +4494,4 @@ export {
   init_builder,
   BaseGadget
 };
-//# sourceMappingURL=chunk-J3NCIWMY.js.map
+//# sourceMappingURL=chunk-VYBRYR2S.js.map