flyto-core 1.7.4__tar.gz

flyto_core-1.7.4/CHANGELOG.md

@@ -0,0 +1,333 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Changed
+- **Loop Module Consolidation** - Simplified loop module registrations
+  - Consolidated from 4 IDs (`core.flow.loop`, `flow.loop`, `loop`, `foreach`) to 2 clear modules
+  - `flow.loop` - Repeat N times (params: `times`, `target`)
+  - `flow.foreach` - Iterate over list (params: `items`, `steps`)
+
+### Added
+- **Execution Environment Safety System** (Security Feature)
+  - `ExecutionEnvironment` enum: `LOCAL` | `CLOUD` | `ALL`
+  - `LOCAL_ONLY_CATEGORIES` set for automatic environment detection
+  - `MODULE_ENVIRONMENT_OVERRIDES` dict for per-module overrides
+  - `get_module_environment()` function to determine module environment
+  - `is_module_allowed_in_environment()` function for runtime checks
+  - **LOCAL_ONLY Categories** (blocked in cloud deployment):
+    - `browser.*` - Browser automation (security risk, resource heavy)
+    - `page.*` - Browser page operations
+    - `scraper.*` - Web scraping operations
+    - `element.*` - DOM element operations
+    - `file.*` - Local filesystem access
+    - `desktop.*`, `app.*` - Desktop automation (future)
+  - **Specific LOCAL_ONLY Modules** (in otherwise cloud-safe categories):
+    - `database.sqlite_query`, `database.sqlite_execute` - Local SQLite
+    - `image.read_local` - Local file image reading
+    - `utility.shell_exec`, `utility.run_command` - Shell execution
+
+- **P2 Feature Modules** (9 new modules)
+  - `image.resize` - Resize images with multiple algorithms (lanczos, bilinear, bicubic, nearest)
+  - `image.compress` - Compress images with quality control and target file size
+  - `pdf.generate` - Generate PDF from HTML or text content using reportlab
+  - `word.parse` - Parse Word documents (docx) to extract text, tables, images, metadata
+  - `email.read` - Read emails via IMAP with folder/filter support
+  - `slack.send` - Send Slack messages via incoming webhook with blocks/attachments
+  - `webhook.trigger` - Send HTTP requests to webhook endpoints (GET/POST/PUT/PATCH/DELETE)
+  - `database.insert` - Insert data into database tables (PostgreSQL, MySQL, SQLite)
+  - `database.update` - Update data in database tables with WHERE conditions
+
+- **P1 Feature Modules** (7 new modules)
+  - `image.download` - Download images from URL with custom headers
+  - `image.convert` - Convert images between formats (PNG, JPEG, WEBP, etc.)
+  - `pdf.parse` - Extract text and metadata from PDF files
+  - `excel.read` - Read data from Excel files (xlsx, xls)
+  - `excel.write` - Write data to Excel files with auto-width columns
+  - `email.send` - Send emails via SMTP with attachments support
+  - `database.query` - Execute SQL queries on PostgreSQL, MySQL, SQLite
+
+- **Module Tiered Architecture** (ADR-001)
+  - `UIVisibility` enum for module UI visibility control (DEFAULT/EXPERT/HIDDEN)
+  - `ContextType` enum for module context requirements (browser/page/file/data/api_response)
+  - `requires_context` and `provides_context` fields in `@register_module`
+  - `ui_visibility`, `ui_label`, `ui_description`, `ui_group`, `ui_icon`, `ui_color` fields
+  - `ui_params_schema` for automatic UI form generation in composites
+  - `ConnectionValidator` class for workflow validation
+  - `can_connect()` and `validate_workflow()` helper functions
+  - `DEFAULT_CONTEXT_REQUIREMENTS` and `DEFAULT_CONTEXT_PROVISIONS` for category-based defaults
+
+- **Smart UI Visibility Auto-Detection**
+  - `DEFAULT_VISIBILITY_CATEGORIES` mapping in `types.py` for category-based visibility
+  - `get_default_visibility(category)` helper function
+  - Categories automatically classified:
+    - **DEFAULT** (shown to all users): `ai`, `agent`, `notification`, `communication`, `api`, `browser`, `cloud`, `database`, `db`, `productivity`, `payment`, `image`
+    - **EXPERT** (advanced users): `string`, `text`, `array`, `object`, `math`, `datetime`, `file`, `element`, `flow`, `data`, `utility`, `meta`, `test`, `atomic`
+
+- **Architecture Documentation**
+  - `docs/architecture/ADR_001_MODULE_TIERED_ARCHITECTURE.md`
+
+### Changed
+- `@register_module` decorator now supports context-based connection validation
+- `@register_module` decorator now auto-detects `ui_visibility` based on category when not specified
+- `@register_composite` decorator now supports UI form generation via `ui_params_schema`
+- `ModuleLevel` enum extended with COMPOSITE, TEMPLATE, PATTERN levels
+- Composite modules now default to `ui_visibility=DEFAULT` (visible to normal users)
+- Atomic modules visibility now depends on category (see Smart UI Visibility above)
+
+### Deprecated
+- Legacy `label`, `description`, `icon`, `color` fields in favor of `ui_*` prefixed versions
+
+### Important Notes for Module Developers
+
+**UI Visibility Classification:**
+
+When creating new modules, the `ui_visibility` is now auto-detected based on category:
+
+```python
+# These categories will show in the main module list (DEFAULT):
+# ai, agent, notification, api, browser, cloud, database, productivity, payment, image
+
+@register_module(
+    module_id="ai.my_new_model",
+    category="ai",
+    # ui_visibility auto-detected as DEFAULT (user-facing)
+)
+
+# These categories will show in Expert Mode only (EXPERT):
+# string, array, object, math, datetime, file, element, flow, data, utility, meta, test
+
+@register_module(
+    module_id="string.custom_parser",
+    category="string",
+    # ui_visibility auto-detected as EXPERT (programming primitive)
+)
+
+# To override auto-detection:
+@register_module(
+    module_id="browser.internal_helper",
+    category="browser",
+    ui_visibility=UIVisibility.HIDDEN,  # Explicitly hide from UI
+)
+```
+
+**Visibility Guidelines:**
+- **DEFAULT**: Complete, standalone features users can use directly (e.g., "Send Slack Message", "Generate Image with DALL-E")
+- **EXPERT**: Low-level operations requiring programming knowledge (e.g., "Split String", "Filter Array", "Click Element")
+- **HIDDEN**: Internal system modules not meant for direct user access
+
+---
+
+## [1.5.0] - 2025-12-04
+
+### Added
+- **Level 4: Advanced Patterns** - Enterprise-grade execution patterns (`src/core/modules/patterns/`)
+  - `BasePattern` base class for all patterns
+  - `PatternRegistry` for managing patterns
+  - `PatternExecutor` for unified pattern execution
+  - `@register_pattern` decorator for easy registration
+  - `PatternResult` and `PatternState` for execution tracking
+
+- **Retry Patterns**
+  - `pattern.retry.exponential_backoff` - Exponential backoff with jitter
+  - `pattern.retry.linear_backoff` - Linear delay increase
+
+- **Parallel Patterns**
+  - `pattern.parallel.map` - Parallel execution with concurrency control
+  - `pattern.parallel.race` - Execute multiple functions, return first success
+
+- **Resilience Patterns**
+  - `pattern.circuit_breaker` - Circuit breaker with CLOSED/OPEN/HALF_OPEN states
+
+- **Rate Limiting Patterns**
+  - `pattern.rate_limiter.token_bucket` - Token bucket algorithm
+  - `pattern.rate_limiter.sliding_window` - Sliding window algorithm
+
+- **Batch Patterns**
+  - `pattern.batch.processor` - Batch processing with chunking
+  - `pattern.batch.aggregator` - Aggregate items and flush on threshold
+
+### Changed
+- Four-Level Module Architecture now complete:
+  - Level 1: Workflow Templates (6 templates)
+  - Level 2: Atomic Modules (150+ modules)
+  - Level 3: Composite Modules (7 modules)
+  - Level 4: Advanced Patterns (9 patterns)
+
+---
+
+## [1.4.0] - 2025-12-04
+
+### Added
+- **Four-Level Module Architecture Implementation**
+  - Level 3: Composite Modules (7 modules across 4 categories)
+  - Level 1: Workflow Templates (6 marketplace-ready templates)
+
+- **Composite Module System** (`src/core/modules/composite/`)
+  - `CompositeModule` base class for high-level workflows
+  - `CompositeRegistry` for managing composite modules
+  - `CompositeExecutor` for executing composite workflows
+  - `@register_composite` decorator for easy module registration
+
+- **Browser Composites**
+  - `composite.browser.search_and_notify` - Web search with notification
+  - `composite.browser.scrape_to_json` - Web scraping to JSON
+  - `composite.browser.screenshot_and_save` - Screenshot capture
+
+- **Developer Composites**
+  - `composite.developer.github_daily_digest` - GitHub repo monitoring
+  - `composite.developer.api_to_notification` - API to notification pipeline
+
+- **Notification Composites**
+  - `composite.notification.multi_channel_alert` - Multi-channel alerts
+  - `composite.notification.scheduled_report` - Scheduled report delivery
+
+- **Data Composites**
+  - `composite.data.csv_to_json` - CSV to JSON conversion
+  - `composite.data.json_transform_notify` - JSON transform with notification
+
+- **Level 1 Workflow Templates** (`workflows/templates/`)
+  - `google_search_to_slack.yaml` - Google search to Slack
+  - `github_repo_monitor.yaml` - GitHub repository monitoring
+  - `webpage_screenshot.yaml` - Webpage screenshot capture
+  - `multi_channel_alert.yaml` - Multi-channel alert system
+  - `web_scraper.yaml` - Web scraping workflow
+  - `api_monitor.yaml` - API health monitoring
+
+### Changed
+- Updated `composite/__init__.py` to export all composite modules
+- Composite modules now support variable resolution with `${params.*}`, `${steps.*}`, `${env.*}`
+
+---
+
+## [1.3.0] - 2025-12-04
+
+### Added
+- New constants for AI models: `DEFAULT_ANTHROPIC_MODEL`, `DEFAULT_GEMINI_MODEL`
+- Environment variable constants: `GOOGLE_AI_API_KEY`, `SLACK_WEBHOOK_URL`, `DISCORD_WEBHOOK_URL`, `TELEGRAM_BOT_TOKEN`
+- Logging to all third-party integration modules
+
+### Changed
+- **third_party/ai/agents.py**: Use `OLLAMA_DEFAULT_URL`, `APIEndpoints.DEFAULT_OPENAI_MODEL`, `EnvVars.OPENAI_API_KEY`, `DEFAULT_LLM_MAX_TOKENS`
+- **third_party/ai/local_ollama.py**: Use `OLLAMA_DEFAULT_URL` instead of hardcoded URL
+- **third_party/ai/openai_integration.py**: Use `APIEndpoints.DEFAULT_OPENAI_MODEL`, `EnvVars.OPENAI_API_KEY`
+- **third_party/ai/services.py**: Use centralized API endpoints for Anthropic and Google Gemini
+- **third_party/communication/twilio.py**: Use `APIEndpoints.twilio_messages()`, `EnvVars.TWILIO_*`
+- **third_party/communication/messaging.py**: Use `EnvVars` for Slack, Discord, Telegram
+- **third_party/developer/github.py**: Use `APIEndpoints.github_*()`, `EnvVars.GITHUB_TOKEN`
+- **third_party/payment/stripe.py**: Use `APIEndpoints.STRIPE_*`, `EnvVars.STRIPE_API_KEY`
+- **third_party/productivity/airtable.py**: Use `APIEndpoints.airtable_table()`, `EnvVars.AIRTABLE_API_KEY`
+- **third_party/productivity/tools.py**: Use `APIEndpoints.notion_*()`, `EnvVars.NOTION_API_KEY`
+- Moved all inline `import os` statements to file-level imports
+- All error messages now use f-strings with constant names for clarity
+
+### Fixed
+- Removed duplicate `import json` statements
+- Consistent logging pattern across all modules
+
+---
+
+## [1.2.0] - 2025-12-04
+
+### Added
+- Browser constants: `DEFAULT_BROWSER_TIMEOUT_MS`, `DEFAULT_VIEWPORT_WIDTH`, `DEFAULT_VIEWPORT_HEIGHT`, `DEFAULT_USER_AGENT`
+- LLM constants: `DEFAULT_LLM_MAX_TOKENS`, `OLLAMA_DEFAULT_URL`, `OLLAMA_EMBEDDINGS_ENDPOINT`
+- Validation constants: `MIN_DESCRIPTION_LENGTH`, `MAX_DESCRIPTION_LENGTH`, `MAX_TIMEOUT_LIMIT`, `MAX_RETRIES_LIMIT`
+- Extended `APIEndpoints` class with Anthropic, Notion, Twilio, OpenAI endpoints
+- Extended `EnvVars` class with database and cloud storage variables
+- New utility functions: `truncate_string()`, `ensure_list()`, `ensure_dict()`, `safe_execute()`, `log_execution()`
+
+### Changed
+- **browser/driver.py**: Use constants instead of hardcoded timeouts and viewport sizes
+- **vector/auto_archive.py**: Replace `print()` with `logger.debug()`/`logger.error()`
+- **vector/embeddings.py**: Use constants and improved exception handling
+- **string/*.py**: Convert absolute imports to relative imports
+- **cli/main.py**: Extract constants, use logging, remove `os.system()`
+
+### Fixed
+- **utility/not.py**: Implement complete logical negation (was TODO placeholder)
+- Security issue: Replaced `os.system('clear')` with ANSI escape sequence
+
+---
+
+## [1.1.0] - 2025-12-04
+
+### Added
+- `src/core/constants.py` - Centralized constants management
+  - `DEFAULT_MAX_RETRIES`, `DEFAULT_RETRY_DELAY_MS`, `DEFAULT_TIMEOUT_SECONDS`
+  - `EXPONENTIAL_BACKOFF_BASE`, `MAX_LOG_RESULT_LENGTH`
+  - `WorkflowStatus` enum class
+  - `APIEndpoints` class for API URL management
+  - `EnvVars` class for environment variable names
+  - `ErrorMessages` class for error message templates
+- `src/core/utils.py` - Shared utility functions
+  - `get_api_key()` - Retrieve API keys from environment
+  - `validate_api_key()` - Validate API key presence
+  - `validate_required_param()` - Validate required parameters
+  - `get_param()` - Get parameter with default value
+  - `auto_convert_type()` - Automatic type conversion
+
+### Changed
+- **base.py**: Added `get_param()` and `require_param()` methods
+- **workflow_engine.py**: Use constants and relative imports
+- **registry.py**: Use logger instead of print statements
+- All hardcoded magic numbers moved to constants
+- Unified relative import paths across modules
+
+---
+
+## [1.0.0] - 2025-12-04
+
+### Added
+- Initial release of Flyto Core
+- YAML workflow automation engine
+- 127+ atomic modules across categories:
+  - `string.*` - Text manipulation (8 modules)
+  - `array.*` - Array operations (10 modules)
+  - `object.*` - Object manipulation (5 modules)
+  - `file.*` - File system operations (6 modules)
+  - `datetime.*` - Date/time operations (4 modules)
+  - `math.*` - Mathematical operations (7 modules)
+  - `data.*` - Data parsing (5 modules)
+  - `browser.*` - Browser automation (9 modules)
+  - `utility.*` - Utilities (7 modules)
+  - `ai.*` - AI integrations (4 modules)
+- CLI interface with interactive mode
+- Variable resolution with `${step_id.field}` syntax
+- Error handling with retry support
+- Internationalization (en, zh, ja)
+- Playwright integration for browser automation
+- Third-party integrations:
+  - AI: OpenAI, Anthropic, Ollama
+  - Communication: Twilio, Slack, Discord, Telegram
+  - Developer: GitHub, HTTP APIs
+  - Payment: Stripe
+  - Productivity: Notion, Airtable, Google Sheets
+
+---
+
+## Version History Summary
+
+| Version | Date | Highlights |
+|---------|------|------------|
+| 1.5.0 | 2025-12-04 | Level 4 Advanced Patterns (Enterprise) |
+| 1.4.0 | 2025-12-04 | Level 3 Composite Modules + Level 1 Templates |
+| 1.3.0 | 2025-12-04 | Third-party module refactoring |
+| 1.2.0 | 2025-12-04 | Browser/LLM constants, utility functions |
+| 1.1.0 | 2025-12-04 | Constants and utils infrastructure |
+| 1.0.0 | 2025-12-04 | Initial release |
+
+---
+
+[Unreleased]: https://github.com/flytohub/flyto-core/compare/v1.5.0...HEAD
+[1.5.0]: https://github.com/flytohub/flyto-core/compare/v1.4.0...v1.5.0
+[1.4.0]: https://github.com/flytohub/flyto-core/compare/v1.3.0...v1.4.0
+[1.3.0]: https://github.com/flytohub/flyto-core/compare/v1.2.0...v1.3.0
+[1.2.0]: https://github.com/flytohub/flyto-core/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/flytohub/flyto-core/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/flytohub/flyto-core/releases/tag/v1.0.0

flyto_core-1.7.4/LICENSE

@@ -0,0 +1,262 @@
+# Flyto Core License
+
+## Source Available License v1.0
+
+**Copyright (c) 2025 Flyto. All Rights Reserved.**
+
+---
+
+## Summary
+
+| Permission | Status |
+|------------|--------|
+| ✅ View source code | Allowed |
+| ✅ Use for personal projects | Allowed |
+| ✅ Use for internal business operations | Allowed |
+| ✅ Modify for personal/internal use | Allowed |
+| ✅ Educational and research use | Allowed |
+| ❌ Sell the software | **Not Allowed** |
+| ❌ Offer as a commercial service | **Not Allowed** |
+| ❌ Include in commercial products | **Not Allowed** |
+| ❌ Redistribute for profit | **Not Allowed** |
+
+For commercial licensing, see [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md).
+
+---
+
+## 1. Definitions
+
+**1.1 "Software"** means the Flyto Core source code, documentation, configuration files, and any associated materials made available under this License.
+
+**1.2 "Licensor"** means Flyto and its affiliates, the copyright holder of the Software.
+
+**1.3 "You" (or "Your")** means the individual or legal entity exercising permissions granted by this License.
+
+**1.4 "Commercial Use"** means any use of the Software that is primarily intended for or directed toward commercial advantage or monetary compensation. This includes, but is not limited to:
+
+- (a) Selling the Software or any derivative works;
+- (b) Offering the Software as a hosted service, SaaS, PaaS, or any cloud-based service;
+- (c) Integrating the Software into products or services that are sold or licensed for a fee;
+- (d) Using the Software to provide paid consulting, implementation, or support services where the Software is a primary component of the service offering;
+- (e) Bundling the Software with commercial hardware or software packages.
+
+**1.5 "Non-Commercial Use"** means any use that does not constitute Commercial Use, including:
+
+- (a) Personal projects and learning;
+- (b) Academic research and education;
+- (c) Internal business operations where the Software is not offered to third parties;
+- (d) Non-profit organizational use;
+- (e) Open-source projects that are themselves non-commercial.
+
+**1.6 "Derivative Works"** means any work that is based on or derived from the Software, including modifications, translations, adaptations, or any work that would constitute a derivative work under copyright law.
+
+**1.7 "Contribution"** means any work of authorship submitted to the Licensor for inclusion in the Software.
+
+---
+
+## 2. Grant of Rights
+
+Subject to the terms and conditions of this License, the Licensor hereby grants You a worldwide, royalty-free, non-exclusive, non-transferable license to:
+
+**2.1 View and Study**
+- Access and read the source code;
+- Study the Software's design, architecture, and implementation.
+
+**2.2 Use for Non-Commercial Purposes**
+- Execute and run the Software for Non-Commercial Use;
+- Use the Software for personal projects, education, and research;
+- Use the Software for internal business operations.
+
+**2.3 Modify for Non-Commercial Purposes**
+- Create Derivative Works for Non-Commercial Use;
+- Adapt the Software to Your specific non-commercial needs.
+
+**2.4 Distribute for Non-Commercial Purposes**
+- Share the Software with others for Non-Commercial Use;
+- Publish Derivative Works under the same license terms.
+
+---
+
+## 3. Restrictions
+
+**3.1 Commercial Use Prohibited**
+You may NOT use the Software for any Commercial Use without obtaining a separate commercial license from the Licensor. Any Commercial Use without proper licensing is a violation of this License and may result in legal action.
+
+**3.2 No Sublicensing for Commercial Purposes**
+You may NOT grant sublicenses that permit Commercial Use of the Software.
+
+**3.3 No Removal of Notices**
+You may NOT remove, alter, or obscure any copyright, trademark, or attribution notices included in the Software.
+
+**3.4 No Misrepresentation**
+You may NOT misrepresent the origin of the Software or claim that You created the original Software.
+
+**3.5 No Trademark Rights**
+This License does NOT grant You any rights to use the Licensor's trademarks, trade names, logos, or service marks.
+
+---
+
+## 4. Attribution Requirements
+
+**4.1 Retention of Notices**
+You must retain all copyright, patent, trademark, and attribution notices present in the Software.
+
+**4.2 Derivative Works Attribution**
+If You create Derivative Works, You must:
+- (a) Include a prominent notice stating that You have modified the Software;
+- (b) Retain this License file in its entirety;
+- (c) Include the following attribution in Your documentation or user interface:
+
+```
+Powered by Flyto Core (https://github.com/flytohub/flyto-core)
+Licensed under the Flyto Source Available License
+```
+
+---
+
+## 5. Contributions
+
+**5.1 Contribution License**
+By submitting a Contribution to the Licensor, You agree that:
+- (a) Your Contribution is Your original work or You have the right to submit it;
+- (b) You grant the Licensor a perpetual, worldwide, non-exclusive, royalty-free license to use, modify, and distribute Your Contribution;
+- (c) Your Contribution may be included in both open-source and commercial versions of the Software.
+
+**5.2 No Compensation**
+Unless separately agreed in writing, Contributions are provided without expectation of compensation.
+
+---
+
+## 6. Disclaimer of Warranty
+
+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, TITLE, AND NON-INFRINGEMENT.
+
+THE LICENSOR DOES NOT WARRANT THAT:
+- (a) The Software will meet Your requirements;
+- (b) The Software will be uninterrupted, timely, secure, or error-free;
+- (c) The results obtained from using the Software will be accurate or reliable;
+- (d) Any errors in the Software will be corrected.
+
+---
+
+## 7. Limitation of Liability
+
+IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY:
+- (a) Indirect, incidental, special, consequential, or punitive damages;
+- (b) Loss of profits, revenue, data, or business opportunities;
+- (c) Cost of procurement of substitute goods or services;
+- (d) Business interruption;
+
+ARISING OUT OF OR IN CONNECTION WITH THIS LICENSE OR THE USE OR INABILITY TO USE THE SOFTWARE, EVEN IF THE LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+THE LICENSOR'S TOTAL LIABILITY SHALL NOT EXCEED THE AMOUNT YOU PAID FOR THE SOFTWARE (IF ANY), OR ONE HUNDRED DOLLARS ($100 USD), WHICHEVER IS GREATER.
+
+---
+
+## 8. Term and Termination
+
+**8.1 Term**
+This License is effective until terminated.
+
+**8.2 Automatic Termination**
+This License terminates automatically if You:
+- (a) Fail to comply with any term of this License;
+- (b) Engage in Commercial Use without proper licensing;
+- (c) Initiate patent litigation against the Licensor regarding the Software.
+
+**8.3 Effect of Termination**
+Upon termination:
+- (a) All rights granted under this License cease immediately;
+- (b) You must destroy all copies of the Software in Your possession;
+- (c) Sections 6, 7, 9, and 10 survive termination.
+
+**8.4 Reinstatement**
+If You cure a violation within 30 days of becoming aware of it, Your rights under this License may be reinstated at the Licensor's discretion.
+
+---
+
+## 9. Governing Law and Dispute Resolution
+
+**9.1 Governing Law**
+This License shall be governed by and construed in accordance with the laws of the jurisdiction in which the Licensor is incorporated, without regard to conflict of law principles.
+
+**9.2 Dispute Resolution**
+Any disputes arising under this License shall be resolved through:
+- (a) Good faith negotiation between the parties;
+- (b) If negotiation fails, binding arbitration under internationally recognized arbitration rules;
+- (c) The prevailing party shall be entitled to recover reasonable attorneys' fees.
+
+**9.3 Injunctive Relief**
+The Licensor may seek injunctive relief in any court of competent jurisdiction to prevent unauthorized Commercial Use.
+
+---
+
+## 10. General Provisions
+
+**10.1 Entire Agreement**
+This License constitutes the entire agreement between You and the Licensor regarding the Software and supersedes all prior agreements.
+
+**10.2 Severability**
+If any provision of this License is held to be unenforceable, the remaining provisions shall remain in full force and effect.
+
+**10.3 No Waiver**
+Failure to enforce any provision of this License does not constitute a waiver of that provision or any other provision.
+
+**10.4 Assignment**
+You may not assign or transfer this License without the Licensor's prior written consent. The Licensor may assign this License without restriction.
+
+**10.5 Amendments**
+The Licensor may publish revised versions of this License. You may choose to use the Software under the terms of the version under which You originally received it.
+
+---
+
+## 11. Commercial Licensing
+
+For Commercial Use, You must obtain a commercial license from the Licensor.
+
+**Contact Information:**
+- Email: licensing@flyto.dev
+- Website: https://flyto.dev/licensing
+- See: [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md)
+
+Commercial licenses are available with:
+- Full commercial use rights
+- Priority support
+- Custom terms and conditions
+- Enterprise deployment options
+
+---
+
+## 12. Quick Reference
+
+### What You CAN Do (Non-Commercial)
+
+| Activity | Allowed |
+|----------|---------|
+| Read and study the source code | ✅ |
+| Use for personal projects | ✅ |
+| Use for learning and education | ✅ |
+| Use for academic research | ✅ |
+| Use internally within your company | ✅ |
+| Modify for your own use | ✅ |
+| Share with attribution | ✅ |
+| Contribute improvements | ✅ |
+
+### What You CANNOT Do (Without Commercial License)
+
+| Activity | Prohibited |
+|----------|------------|
+| Sell the software | ❌ |
+| Offer as SaaS/cloud service | ❌ |
+| Include in commercial products | ❌ |
+| Provide paid services using the software | ❌ |
+| Remove copyright notices | ❌ |
+| Claim you created it | ❌ |
+
+---
+
+**Flyto Core — Source Available License v1.0**
+
+Copyright (c) 2025 Flyto. All Rights Reserved.
+
+For questions about this license, contact: licensing@flyto2.com