Fix package.json verison, and update examples (#2)

* Fix package.json verison, and update examples

* Update package-lock.json

* Updating linting GHA to check package-lock.json

Author: peteski22

.github/workflows/lint.yaml

@@ -22,6 +22,15 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Check package-lock.json is up to date
+        run: |
+          npm install --package-lock-only
+          if [ -n "$(git status --porcelain package-lock.json)" ]; then
+            echo "Error: package-lock.json is out of date. Please run 'npm install' locally and commit the changes."
+            git diff package-lock.json
+            exit 1
+          fi
+
       - name: Run linting and typecheck
         run: npm run lint
 

examples/basic/README.md

@@ -0,0 +1,71 @@
+# Basic mcpd SDK Example
+
+Basic example demonstrating core features of the mcpd JavaScript/TypeScript SDK.
+
+## Features Demonstrated
+
+- Connecting to an mcpd daemon
+- Listing available servers
+- Checking server health
+- Listing tools for a specific server
+- Calling tools dynamically
+- Error handling
+
+## Prerequisites
+
+- Node.js 22 LTS or higher
+- mcpd daemon running locally on port 8090
+- At least one MCP server configured (example uses 'time' server)
+
+## Installation
+
+```bash
+npm install
+```
+
+## Running
+
+```bash
+npm start
+```
+
+Or with auto-reload during development:
+
+```bash
+npm run dev
+```
+
+## What This Example Shows
+
+The example connects to a local mcpd daemon and demonstrates:
+
+1. **Server Discovery** - Lists all configured MCP servers
+2. **Health Checking** - Checks health status of all servers
+3. **Tool Discovery** - Lists available tools on the 'time' server
+4. **Dynamic Tool Calls** - Calls the `get_current_time` tool with different timezones
+5. **Error Handling** - Demonstrates proper error handling with typed exceptions
+
+## Expected Output
+
+```
+Available servers:
+[ 'time', 'fetch', ... ]
+
+Server health:
+  time: ok
+  fetch: ok
+
+Time server tools:
+  - get_current_time: Get current time in a specific timezone
+
+Getting current time in different timezones:
+  UTC: { content: [...], isError: false }
+  Tokyo: { content: [...], isError: false }
+  New York: { content: [...], isError: false }
+```
+
+## Learn More
+
+- [Main SDK Documentation](../../README.md)
+- [LangChain Example](../langchain/)
+- [Vercel AI Example](../vercel-ai/)

examples/basic/package-lock.json

@@ -0,0 +1,22 @@
+{
+  "name": "mcpd-basic-example",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "description": "Basic example of using the mcpd SDK",
+  "scripts": {
+    "start": "node index.js",
+    "dev": "node --watch index.js"
+  },
+  "dependencies": {
+    "@mozilla-ai/mcpd": "file:../.."
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "mcpd",
+    "example"
+  ]
+}

examples/basic/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mozilla-ai/mcpd",
-  "version": "0.1.0",
+  "version": "0.0.1",
   "description": "JavaScript/TypeScript SDK for interacting with mcpd",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",