Initial public release — AIR SDK v0.2.9

Author: FransDevelopment

.gitignore

@@ -0,0 +1,63 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# Test coverage
+coverage/
+
+# TypeScript build info
+*.tsbuildinfo
+
+# Environment variables
+.env
+.env.*
+!.env.example
+
+# OS files
+.DS_Store
+Thumbs.db
+*.swp
+*~
+
+# IDE
+.vscode/
+.idea/
+*.sublime-*
+
+# Claude Code
+.claude/
+
+# Internal documents — strategy, architecture, revenue, specs
+briefs/
+PRODUCTION_CHECKLIST.md
+QA_REVIEW.md
+air-sdk-product-spec.md
+DISTRIBUTION_MAP.md
+test-suite.md
+*.internal.md
+
+# Internal test scripts (contain hardcoded API keys)
+examples/generate-telemetry.ts
+examples/manual-test.ts
+
+# E2E tests that require live API keys
+tests/e2e/cloud.test.ts
+tests/e2e/real-world.test.ts
+
+# Package lock (library — consumers use their own)
+package-lock.json
+
+# npm
+.npmrc
+*.tgz
+
+# Benchmark results (generated, not committed)
+benchmark/results.txt
+benchmark/README_SECTION.md
+
+# Debug logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.2.9] - 2026-03-20
+
+### Fixed
+- report_outcome schema: `success` and `selectorMatched` now accept both boolean and string types (LLM agents often send `"true"` instead of `true`)
+- Cross-request correlation: execute_capability generates a `requestId` that links to report_outcome for richer telemetry
+- Heuristic execution hints for description_only capabilities — keeps agents in the AIR workflow even without verified macros
+
+### Added
+- Benchmarks: real API latency measurements across 8 domains, cost/speed comparison tables
+- Benchmark script (`benchmark/run.ts`) for independent verification
+
+## [0.1.1] - 2026-03-19
+
+### Fixed
+- Unified MCP server with extract_url tool
+- Telemetry field mapping for cloud ingestion
+- Version reporting consistency
+
+## [0.1.0] - 2026-03-18
+
+### Added
+- Initial release
+- Playwright, Puppeteer, and Browser Use adapters
+- Smart selector resolution with fallback cascading
+- Privacy-first telemetry with PII filtering
+- Capability discovery and macro execution
+- MCP server for Claude Code and Cursor
+- CLI init for zero-config setup
+- Machine Payments Protocol (MPP) support

CONTRIBUTING.md

@@ -0,0 +1,29 @@
+# Contributing to AIR SDK
+
+Thanks for your interest in contributing! Here's how to get started.
+
+## Development Setup
+
+```bash
+git clone https://github.com/ArcedeDev/air-sdk.git
+cd air-sdk
+npm install
+npm test
+```
+
+## Code Style
+
+- TypeScript with strict mode enabled
+- Run `npm run lint` before submitting changes
+- Run `npm run typecheck` to verify type correctness
+
+## Pull Request Process
+
+1. Fork the repository and create a feature branch from `main`
+2. Make your changes and ensure all tests pass (`npm test`)
+3. Run `npm run lint` and `npm run typecheck` with no errors
+4. Open a pull request against `main` with a clear description of the change
+
+## Reporting Issues
+
+Please open an issue on GitHub with steps to reproduce, expected behavior, and actual behavior.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arcede
+
+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.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.