matimo 0.1.0-alpha.1 → 0.1.0-alpha.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "matimo",
-  "version": "0.1.0-alpha.1",
-  "description": "Framework-agnostic YAML-driven tool ecosystem for AI agents. Define tools once in YAML, use them everywhere: SDK, MCP, CLI, REST API.",
+  "version": "0.1.0-alpha.3",
+  "description": "Universal tool provider SDK: Framework-agnostic YAML-driven tool ecosystem for AI agents. Execute 50+ pre-built tools (Slack, Gmail, GitHub, AWS, etc.) or define your own in YAML.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -45,9 +45,9 @@
   },
   "files": [
     "dist",
+    "tools",
     "README.md",
-    "LICENSE",
-    "docs"
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"

package/tools/calculator/calculator.ts

@@ -0,0 +1,78 @@
+// Calculator implementation
+// This script is executed by the calculator tool
+
+const [operation, aStr, bStr] = process.argv.slice(2);
+const a = parseFloat(aStr);
+const b = parseFloat(bStr);
+
+// Normalize operation name to handle variations
+const normalizeOperation = (op: string): string => {
+  const normalized = op.toLowerCase().trim();
+  
+  // Map variations to canonical operation names
+  const operationMap: Record<string, string> = {
+    // Addition variants
+    'add': 'add',
+    'addition': 'add',
+    'sum': 'add',
+    'plus': 'add',
+    '+': 'add',
+    
+    // Subtraction variants
+    'subtract': 'subtract',
+    'subtraction': 'subtract',
+    'minus': 'subtract',
+    'sub': 'subtract',
+    '-': 'subtract',
+    
+    // Multiplication variants
+    'multiply': 'multiply',
+    'multiplication': 'multiply',
+    'times': 'multiply',
+    'product': 'multiply',
+    'mul': 'multiply',
+    '*': 'multiply',
+    'x': 'multiply',
+    
+    // Division variants
+    'divide': 'divide',
+    'division': 'divide',
+    'div': 'divide',
+    '/': 'divide',
+  };
+  
+  return operationMap[normalized] || normalized;
+};
+
+const normalizedOp = normalizeOperation(operation);
+
+let result: number;
+
+switch (normalizedOp) {
+  case 'add':
+    result = a + b;
+    break;
+  case 'subtract':
+    result = a - b;
+    break;
+  case 'multiply':
+    result = a * b;
+    break;
+  case 'divide':
+    if (b === 0) {
+      console.error('Division by zero');
+      process.exit(1);
+    }
+    result = a / b;
+    break;
+  default:
+    console.error(`Unknown operation: ${operation}`);
+    process.exit(1);
+}
+
+console.log(JSON.stringify({
+  result,
+  operation: normalizedOp,
+  original_operation: operation,
+  operands: { a, b }
+}));

package/tools/calculator/definition.yaml

@@ -0,0 +1,71 @@
+name: calculator
+version: "1.0.0"
+description: "Perform basic arithmetic operations"
+
+parameters:
+  operation:
+    type: string
+    description: "The operation to perform. Accepts: add (addition, sum, plus), subtract (subtraction, minus), multiply (multiplication, times, product), divide (division)"
+    required: true
+  a:
+    type: number
+    description: "First operand"
+    required: true
+  b:
+    type: number
+    description: "Second operand"
+    required: true
+
+execution:
+  type: command
+  command: "tsx"
+  args: ["tools/calculator/calculator.ts", "{operation}", "{a}", "{b}"]
+
+output_schema:
+  type: object
+  properties:
+    result:
+      type: number
+      description: "Result of the operation"
+    operation:
+      type: string
+    operands:
+      type: object
+      properties:
+        a:
+          type: number
+        b:
+          type: number
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - name: "Simple addition"
+    description: "Add 5 and 3"
+    params:
+      operation: "add"
+      a: 5
+      b: 3
+  - name: "Addition with variant"
+    description: "Add using 'addition' keyword"
+    params:
+      operation: "addition"
+      a: 10
+      b: 20
+  - name: "Subtraction"
+    description: "Subtract 3 from 10"
+    params:
+      operation: "subtract"
+      a: 10
+      b: 3
+  - name: "Multiplication"
+    description: "Multiply 4 and 7"
+    params:
+      operation: "multiply"
+      a: 4
+      b: 7
+
+tags: [math, arithmetic, basic]

package/tools/echo-tool/definition.yaml

@@ -0,0 +1,35 @@
+name: echo-tool
+version: "1.0.0"
+description: "Echo back the input message - useful for testing"
+
+parameters:
+  message:
+    type: string
+    description: "The message to echo"
+    required: true
+
+execution:
+  type: command
+  command: "echo"
+  args: ["{message}"]
+
+output_schema:
+  type: object
+  properties:
+    message:
+      type: string
+      description: "The echoed message"
+    timestamp:
+      type: string
+      description: "ISO timestamp of execution"
+
+error_handling:
+  retry: 1
+
+examples:
+  - name: "Echo hello"
+    description: "Echo a greeting message"
+    params:
+      message: "Hello, Matimo!"
+
+tags: [test, echo, basic]

package/tools/examples/calculator.yaml

@@ -0,0 +1,54 @@
+name: calculator
+version: "1.0.0"
+description: "Perform basic arithmetic operations"
+
+parameters:
+  operation:
+    type: string
+    description: "The operation to perform: add, subtract, multiply, divide"
+    required: true
+    enum: [add, subtract, multiply, divide]
+  a:
+    type: number
+    description: "First operand"
+    required: true
+  b:
+    type: number
+    description: "Second operand"
+    required: true
+
+execution:
+  type: command
+  command: "node"
+  args: ["scripts/calculator.js", "{operation}", "{a}", "{b}"]
+
+output_schema:
+  type: object
+  properties:
+    result:
+      type: number
+      description: "Result of the operation"
+    operation:
+      type: string
+    operands:
+      type: object
+      properties:
+        a:
+          type: number
+        b:
+          type: number
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+
+examples:
+  - parameters:
+      operation: "add"
+      a: 5
+      b: 3
+    result:
+      result: 8
+
+tags: [math, arithmetic, basic]

package/tools/examples/echo-tool.yaml

@@ -0,0 +1,35 @@
+name: echo-tool
+version: "1.0.0"
+description: "Echo back the input message - useful for testing"
+
+parameters:
+  message:
+    type: string
+    description: "The message to echo"
+    required: true
+
+execution:
+  type: command
+  command: "echo"
+  args: ["{message}"]
+
+output_schema:
+  type: object
+  properties:
+    message:
+      type: string
+      description: "The echoed message"
+    timestamp:
+      type: string
+      description: "ISO timestamp of execution"
+
+error_handling:
+  retry: 1
+
+examples:
+  - parameters:
+      message: "Hello, Matimo!"
+    result:
+      message: "Hello, Matimo!"
+
+tags: [test, echo, basic]

package/tools/examples/http-client.yaml

@@ -0,0 +1,66 @@
+name: http-client
+version: "1.0.0"
+description: "Generic HTTP client for making API requests"
+
+parameters:
+  url:
+    type: string
+    description: "The URL to request"
+    required: true
+  method:
+    type: string
+    description: "HTTP method: GET, POST, PUT, DELETE"
+    required: false
+    default: "GET"
+    enum: [GET, POST, PUT, DELETE, PATCH]
+  headers:
+    type: object
+    description: "HTTP headers as key-value pairs"
+    required: false
+  body:
+    type: object
+    description: "Request body (for POST/PUT/PATCH)"
+    required: false
+
+execution:
+  type: http
+  method: GET
+  url: "{url}"
+  headers: "{headers}"
+  body: "{body}"
+
+output_schema:
+  type: object
+  properties:
+    status:
+      type: number
+      description: "HTTP status code"
+    statusText:
+      type: string
+    headers:
+      type: object
+    data:
+      type: object
+      description: "Response body"
+
+error_handling:
+  retry: 3
+  backoff_type: exponential
+  initial_delay_ms: 1000
+  max_delay_ms: 10000
+
+rate_limiting:
+  enabled: true
+  requests_per_minute: 60
+
+examples:
+  - parameters:
+      url: "https://api.example.com/users"
+      method: "GET"
+    result:
+      status: 200
+      statusText: "OK"
+      data:
+        users: []
+
+tags: [http, api, network, client]

package/tools/github/definition.yaml

@@ -0,0 +1,41 @@
+# GitHub OAuth2 Provider Definition
+#
+# This file defines the OAuth2 configuration for GitHub.
+# All GitHub tools reference this provider definition.
+#
+# Users can override endpoints via environment variables or runtime config.
+
+name: github-provider
+type: provider
+version: '1.0.0'
+
+description: |
+  GitHub OAuth2 Provider Configuration
+  
+  All GitHub tools use these endpoints for OAuth2 authentication.
+  
+  Setup:
+  1. Go to GitHub Settings → Developer settings → OAuth Apps
+  2. Create new OAuth App
+  3. Note the Client ID and Client Secret
+  4. Set GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET environment variables
+  5. Set GITHUB_REDIRECT_URI to your callback URL
+
+provider:
+  name: github
+  displayName: GitHub
+  
+  # OAuth2 Endpoints
+  endpoints:
+    authorizationUrl: https://github.com/login/oauth/authorize
+    tokenUrl: https://github.com/login/oauth/access_token
+  
+  # Standard scopes for GitHub API access
+  # Tools can override with their own scopes
+  defaultScopes:
+    - user:email
+    - repo
+  
+  # Additional metadata
+  documentation: https://docs.github.com/en/developers/apps/building-oauth-apps
+  learnMore: https://github.com/settings/developers