llmist 0.1.6 → 0.2.0

package/README.md

@@ -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/cli.cjs

@@ -4253,7 +4253,7 @@ var import_commander3 = require("commander");
 // package.json
 var package_default = {
   name: "llmist",
-  version: "0.1.6",
+  version: "0.2.0",
   description: "Universal TypeScript LLM client with streaming-first agent framework. Works with any model - no structured outputs or native tool calling required. Implements its own flexible grammar for function calling.",
   type: "module",
   main: "dist/index.cjs",
@@ -4295,7 +4295,8 @@ var package_default = {
     "test:e2e:watch": "bun test src/e2e --watch --timeout 60000",
     "test:all": "bun run test && bun run test:e2e",
     clean: "rimraf dist",
-    prepare: "node scripts/install-hooks.js || true"
+    prepare: "node scripts/install-hooks.js || true",
+    "release:dry": "bunx semantic-release --dry-run"
   },
   bin: {
     llmist: "dist/cli.js"
@@ -4344,11 +4345,16 @@ var package_default = {
   },
   devDependencies: {
     "@biomejs/biome": "^2.3.2",
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.12.7",
     "bun-types": "^1.3.2",
     dotenv: "^17.2.3",
     rimraf: "^5.0.5",
+    "semantic-release": "^25.0.2",
     tsup: "^8.3.5",
     typescript: "^5.4.5"
   }