scios-cli 0.1.0__tar.gz

scios_cli-0.1.0/LICENSE

@@ -0,0 +1,191 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2024 Google LLC
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

scios_cli-0.1.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: scios-cli
+Version: 0.1.0
+Summary: Scios Local Agent Workspace Sync CLI — bridge your terminal to the Scios Cloud backend
+Author: Scios Team
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/google-octo/science-studio
+Project-URL: Repository, https://github.com/google-octo/science-studio
+Project-URL: Documentation, https://github.com/google-octo/science-studio/tree/main/packages/cli
+Keywords: scios,cli,agent,sync,science,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: watchdog>=3.0.0
+Dynamic: license-file
+
+# Scios CLI 🚀
+
+The local workspace engine bridging your terminal natively to the Scios Cloud backend.
+
+Instead of hunting for logs scattered across web panels or modifying long agent prompts in narrow browser textboxes, you can now push a button on the Web UI to magically download the entire codebase to your machine and hot-reload changes as you type!
+
+## Overview
+By installing this lightweight Python package, whenever you click the **"Open in Antigravity"** button in Scios Web:
+1. Your browser will spawn an interactive Terminal securely connected to your session.
+2. The entire project is downloaded and formatted into a structured local directory (`sync_<idea_id>/agents/`).
+3. You can use native VS Code, your own linter, and formatting extensions to iterate on the Agent architecture.
+4. When you press `CMD+S` locally, the `scios-cli` instantly pushes the diff back to the live Cloud instances seamlessly!
+
+---
+
+## 💻 Installation
+
+Scios CLI requires **Python 3.9+** and can be quickly installed alongside your standard developer tools:
+
+```bash
+# 1. Clone or step into the Scios project (if building from source)
+cd packages/cli 
+
+# 2. Install the `scios-cli` pip package globally 
+pip install -e .
+```
+
+### Install Deep Link Handler (Critical) 🔗
+Web Browsers strictly sandbox their environment for security. To enable true one-click magical execution without copying and pasting terminal commands, you must register the native OS Protocol handler (`scios://`). 
+
+Run this command **once** anywhere in your terminal after installation:
+
+```bash
+scios-init
+```
+This is fully cross-platform and will instantly register exactly what your OS needs:
+- 🍎 **macOS**: An AppleScript wrapper app is loaded to Launch Services.
+- 🐧 **Linux**: An `.desktop` MimeType handler explicitly set.
+- 🪟 **Windows**: The protocol hooks injected correctly into `HKEY_CURRENT_USER`.
+
+---
+
+## 🏃 Usage & Workflow
+
+### 1. Activating the Live Sync
+1. In the Scios Web App, navigate to any specific **Idea** or Workflow node.
+2. Next to the "Run Pipeline" button in the header, click **Open in Antigravity**.
+3. A popup will ask you *"Allow this site to open SciosSync?"* — Click **Open**.
+
+Your system Terminal will spawn, authenticate with your specific user session automatically behind the scenes, and print:
+```text
+🔗 Received Deep Link: scios://sync?id=...
+✨ Successfully pulled Scios project down over API.
+👀 Watching /sync_1234abcd/agents for live agent code changes... (Press Ctrl+C to exit)
+```
+
+### 2. Modifying Code Locally
+Your OS will now have a `/sync_<idea_id>` directory precisely at the root of where your terminal spawned.
+Simply drag that folder right into VS Code:
+- Tweak the pandas logic, alter an LLM system prompt, or build an entire new reasoning strategy in `agents/MyAgent.py`.
+- **Hit Save:** Your terminal will blink immediately: `✅ Successfully updated agent code over API!`
+
+### 3. Remote Triggering (`--local`)
+If you don't want to use the web application to trigger an execution loop and you just want to launch your new logic:
+```bash
+scios-sync 1234-5678-your-idea-id --endpoint "https://api.scios.ai/v1" --token "eyJh..." --local
+```
+Passing `--local` directly triggers the Cloud APIs to launch that pipeline on the heavy GPUs immediately without ever having to touch a web button.
+
+---
+
+### Manual Fallback Commands
+If for some reason your organization blocks Deep Links, the "Open in Antigravity" button also copies a fail-safe execution string to your OS Clipboard:
+```bash
+scios-sync <idea_id> --endpoint "..." --token "..."
+```
+You can simply paste this string straight into your terminal after installing the pip package to achieve exact feature parity!

scios_cli-0.1.0/README.md

@@ -0,0 +1,77 @@
+# Scios CLI 🚀
+
+The local workspace engine bridging your terminal natively to the Scios Cloud backend.
+
+Instead of hunting for logs scattered across web panels or modifying long agent prompts in narrow browser textboxes, you can now push a button on the Web UI to magically download the entire codebase to your machine and hot-reload changes as you type!
+
+## Overview
+By installing this lightweight Python package, whenever you click the **"Open in Antigravity"** button in Scios Web:
+1. Your browser will spawn an interactive Terminal securely connected to your session.
+2. The entire project is downloaded and formatted into a structured local directory (`sync_<idea_id>/agents/`).
+3. You can use native VS Code, your own linter, and formatting extensions to iterate on the Agent architecture.
+4. When you press `CMD+S` locally, the `scios-cli` instantly pushes the diff back to the live Cloud instances seamlessly!
+
+---
+
+## 💻 Installation
+
+Scios CLI requires **Python 3.9+** and can be quickly installed alongside your standard developer tools:
+
+```bash
+# 1. Clone or step into the Scios project (if building from source)
+cd packages/cli 
+
+# 2. Install the `scios-cli` pip package globally 
+pip install -e .
+```
+
+### Install Deep Link Handler (Critical) 🔗
+Web Browsers strictly sandbox their environment for security. To enable true one-click magical execution without copying and pasting terminal commands, you must register the native OS Protocol handler (`scios://`). 
+
+Run this command **once** anywhere in your terminal after installation:
+
+```bash
+scios-init
+```
+This is fully cross-platform and will instantly register exactly what your OS needs:
+- 🍎 **macOS**: An AppleScript wrapper app is loaded to Launch Services.
+- 🐧 **Linux**: An `.desktop` MimeType handler explicitly set.
+- 🪟 **Windows**: The protocol hooks injected correctly into `HKEY_CURRENT_USER`.
+
+---
+
+## 🏃 Usage & Workflow
+
+### 1. Activating the Live Sync
+1. In the Scios Web App, navigate to any specific **Idea** or Workflow node.
+2. Next to the "Run Pipeline" button in the header, click **Open in Antigravity**.
+3. A popup will ask you *"Allow this site to open SciosSync?"* — Click **Open**.
+
+Your system Terminal will spawn, authenticate with your specific user session automatically behind the scenes, and print:
+```text
+🔗 Received Deep Link: scios://sync?id=...
+✨ Successfully pulled Scios project down over API.
+👀 Watching /sync_1234abcd/agents for live agent code changes... (Press Ctrl+C to exit)
+```
+
+### 2. Modifying Code Locally
+Your OS will now have a `/sync_<idea_id>` directory precisely at the root of where your terminal spawned.
+Simply drag that folder right into VS Code:
+- Tweak the pandas logic, alter an LLM system prompt, or build an entire new reasoning strategy in `agents/MyAgent.py`.
+- **Hit Save:** Your terminal will blink immediately: `✅ Successfully updated agent code over API!`
+
+### 3. Remote Triggering (`--local`)
+If you don't want to use the web application to trigger an execution loop and you just want to launch your new logic:
+```bash
+scios-sync 1234-5678-your-idea-id --endpoint "https://api.scios.ai/v1" --token "eyJh..." --local
+```
+Passing `--local` directly triggers the Cloud APIs to launch that pipeline on the heavy GPUs immediately without ever having to touch a web button.
+
+---
+
+### Manual Fallback Commands
+If for some reason your organization blocks Deep Links, the "Open in Antigravity" button also copies a fail-safe execution string to your OS Clipboard:
+```bash
+scios-sync <idea_id> --endpoint "..." --token "..."
+```
+You can simply paste this string straight into your terminal after installing the pip package to achieve exact feature parity!

scios_cli-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "scios-cli"
+version = "0.1.0"
+description = "Scios Local Agent Workspace Sync CLI — bridge your terminal to the Scios Cloud backend"
+readme = "README.md"
+license = {text = "Apache-2.0"}
+requires-python = ">=3.9"
+authors = [
+    {name = "Scios Team"},
+]
+keywords = ["scios", "cli", "agent", "sync", "science", "workflow"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Software Development :: Libraries",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "requests>=2.31.0",
+    "watchdog>=3.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/google-octo/science-studio"
+Repository = "https://github.com/google-octo/science-studio"
+Documentation = "https://github.com/google-octo/science-studio/tree/main/packages/cli"
+
+[project.scripts]
+scios-sync = "scios_cli.main:cli_entry"
+scios-init = "scios_cli.install:cli_install_protocol"
+
+[tool.setuptools.packages.find]
+include = ["scios_cli*"]

scios_cli-0.1.0/scios_cli/install.py

@@ -0,0 +1,126 @@
+import os
+import sys
+import subprocess
+from pathlib import Path
+import stat
+
+def install_mac():
+    print("🚀 Installing Scios Custom URI Handler (scios://) for macOS...")
+    app_dir = Path.home() / "Applications"
+    app_dir.mkdir(exist_ok=True)
+    scios_app = app_dir / "SciosSync.app"
+    
+    applescript_code = """
+on open location this_url
+    tell application "Terminal"
+        activate
+        do script "scios-sync '" & this_url & "'"
+    end tell
+end open location
+"""
+    print(f"🏗️ Compiling AppleScript to {scios_app}...")
+    subprocess.run(["osacompile", "-o", str(scios_app)], input=applescript_code.encode("utf-8"), check=True)
+    
+    info_plist_path = scios_app / "Contents" / "Info.plist"
+    try:
+        subprocess.run(["plutil", "-convert", "xml1", str(info_plist_path)], check=True)
+        with open(info_plist_path, "r") as f:
+            plist_data = f.read()
+            
+        url_type_xml = """	<key>CFBundleURLTypes</key>
+	<array>
+		<dict>
+			<key>CFBundleURLName</key>
+			<string>com.scios.sync</string>
+			<key>CFBundleURLSchemes</key>
+			<array>
+				<string>scios</string>
+			</array>
+		</dict>
+	</array>
+"""
+        if "<key>CFBundleURLTypes</key>" not in plist_data:
+            plist_data = plist_data.replace("</dict>\n</plist>", url_type_xml + "</dict>\n</plist>")
+            with open(info_plist_path, "w") as f:
+                f.write(plist_data)
+    except Exception as e:
+        print(f"❌ Failed to patch Info.plist: {e}")
+        sys.exit(1)
+        
+    print(f"🔄 Registering app with macOS Launch Services...")
+    lsregister = "/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister"
+    if os.path.exists(lsregister):
+        subprocess.run([lsregister, "-f", str(scios_app)], check=True)
+    else:
+        subprocess.run(["open", "-R", str(scios_app)], check=True)
+    print(f"✅ Successfully installed Scios Protocol handler at {scios_app}")
+
+
+def install_linux():
+    print("🚀 Installing Scios Custom URI Handler (scios://) for Linux...")
+    apps_dir = Path.home() / ".local" / "share" / "applications"
+    apps_dir.mkdir(exist_ok=True, parents=True)
+    
+    desktop_file = apps_dir / "scios-sync.desktop"
+    
+    desktop_content = """[Desktop Entry]
+Name=Scios Sync Local Handler
+Exec=scios-sync %u
+Type=Application
+Terminal=true
+MimeType=x-scheme-handler/scios;
+"""
+    with open(desktop_file, "w") as f:
+        f.write(desktop_content)
+        
+    os.chmod(desktop_file, os.stat(desktop_file).st_mode | stat.S_IEXEC)
+    
+    print("🔄 Registering x-scheme-handler with xdg-mime...")
+    try:
+        subprocess.run(["xdg-mime", "default", "scios-sync.desktop", "x-scheme-handler/scios"], check=True)
+        subprocess.run(["update-desktop-database", str(apps_dir)], check=False)
+        print(f"✅ Successfully installed Scios Protocol handler at {desktop_file}")
+    except FileNotFoundError:
+        print("⚠️ xdg-mime or update-desktop-database not found. Is this a GUI Linux environment?")
+        print(f"✅ Desktop file created manually at {desktop_file}")
+
+
+def install_windows():
+    print("🚀 Installing Scios Custom URI Handler (scios://) for Windows...")
+    import winreg
+    
+    try:
+        # Create HKEY_CURRENT_USER\Software\Classes\scios
+        key = winreg.CreateKey(winreg.HKEY_CURRENT_USER, r"Software\Classes\scios")
+        winreg.SetValue(key, "", winreg.REG_SZ, "URL:Scios Custom Protocol")
+        winreg.SetValueEx(key, "URL Protocol", 0, winreg.REG_SZ, "")
+        
+        # Create shell\open\command
+        cmd_key = winreg.CreateKey(key, r"shell\open\command")
+        # Use cmd.exe /k to keep the window open after execution
+        winreg.SetValue(cmd_key, "", winreg.REG_SZ, f'cmd.exe /k scios-sync "%1"')
+        
+        winreg.CloseKey(cmd_key)
+        winreg.CloseKey(key)
+        print("✅ Successfully installed Scios Protocol handler in Windows Registry!")
+    except Exception as e:
+        print(f"❌ Failed to modify registry: {e}")
+        print("You may need to run this command as Administrator.")
+        sys.exit(1)
+
+
+def cli_install_protocol():
+    if sys.platform == "darwin":
+        install_mac()
+    elif sys.platform.startswith("linux"):
+        install_linux()
+    elif sys.platform == "win32":
+        install_windows()
+    else:
+        print(f"❌ Unsupported platform: {sys.platform}")
+        sys.exit(1)
+        
+    print("\n🎉 You can now click 'Open in Antigravity' buttons securely on the Web UI.")
+
+if __name__ == "__main__":
+    cli_install_protocol()

scios_cli-0.1.0/scios_cli/main.py

@@ -0,0 +1,212 @@
+#!/usr/bin/env python3
+import time
+import argparse
+import sys
+import json
+import base64
+from pathlib import Path
+
+try:
+    import requests
+    from watchdog.observers import Observer
+    from watchdog.events import FileSystemEventHandler
+except ImportError:
+    print("Dependencies missing! Run: pip install requests watchdog")
+    sys.exit(1)
+
+def setup_vscode_workspace(workspace_dir: Path):
+    vscode_dir = workspace_dir / ".vscode"
+    vscode_dir.mkdir(exist_ok=True, parents=True)
+    settings = {
+        "python.analysis.extraPaths": ["./agents"],
+        "editor.formatOnSave": True
+    }
+    with open(vscode_dir / "settings.json", "w") as f:
+        json.dump(settings, f, indent=4)
+
+def generate_trace_summary(trace_data: dict, output_path: Path):
+    if not trace_data or "node_executions" not in trace_data:
+        return
+    try:
+        nodes = trace_data.get("node_executions", [])
+        with open(output_path, "w") as f:
+            f.write("# Execution Trace Summary\n\n| Node | Agent Name | Status | Duration (s) | Error |\n|------|------------|--------|--------------|-------|\n")
+            for node in nodes:
+                node_id = node.get("node_id", "Unknown")
+                agent_name = node.get("agent_name", "N/A")
+                status = node.get("status", "unknown")
+                duration = round(node.get("duration", 0), 2)
+                error_str = str(node.get("error", "")).replace("\n", " ")[:100]
+                f.write(f"| `{node_id}` | **{agent_name}** | {status} | {duration} | {error_str} |\n")
+    except Exception as e:
+        print(f"Failed to generate trace summary: {e}")
+
+class AgentSyncHandler(FileSystemEventHandler):
+    def __init__(self, endpoint: str, headers: dict):
+        self.endpoint = endpoint
+        self.headers = headers
+        self.last_syncs = {}
+
+    def on_modified(self, event):
+        if event.is_directory or not event.src_path.endswith('.py'):
+            return
+            
+        current_time = time.time()
+        if current_time - self.last_syncs.get(event.src_path, 0) < 1.0:
+            return  # Debounce updates
+            
+        self.last_syncs[event.src_path] = current_time
+        self.sync_file(Path(event.src_path))
+        
+    def sync_file(self, file_path: Path):
+        try:
+            with open(file_path, "r") as f:
+                content = f.read()
+                
+            first_line = content.split('\n')[0]
+            if not first_line.startswith("# AGENT_ID:"):
+                return
+                
+            agent_id = first_line.replace("# AGENT_ID:", "").strip()
+            print(f"\n📝 Change detected in {file_path.name}! Syncing to Scios cloud...")
+            
+            res = requests.patch(
+                f"{self.endpoint}/agents/{agent_id}/code",
+                headers=self.headers,
+                json={"code_content": content}
+            )
+            
+            if res.status_code in (200, 204):
+                print(f"✅ Successfully updated agent code over API!")
+            else:
+                print(f"❌ Error syncing {file_path.name}: {res.status_code} - {res.text}")
+                
+        except Exception as e:
+            print(f"❌ Error reading {file_path.name}: {e}")
+
+def cli_entry():
+    # Detect Deep Link Intercept from our MacOS Handler App
+    import urllib.parse
+    if len(sys.argv) == 2 and sys.argv[1].startswith("scios://sync"):
+        url = sys.argv[1]
+        print(f"🔗 Received Deep Link: {url[:30]}...")
+        parsed = urllib.parse.urlparse(url)
+        qs = urllib.parse.parse_qs(parsed.query)
+        sys.argv = [
+            sys.argv[0], 
+            qs.get('id', [''])[0], 
+            '--endpoint', qs.get('endpoint', [''])[0], 
+            '--token', qs.get('token', [''])[0]
+        ]
+        if 'local' in qs and qs['local'][0].lower() == 'true':
+            sys.argv.append('--local')
+
+    parser = argparse.ArgumentParser(description="Scios Public CLI - Local Agent Sync")
+    parser.add_argument("idea_id", help="UUID of the Idea to mount")
+    parser.add_argument("--endpoint", required=True, help="Base API endpoint (e.g., https://api.scios.ai/api/v1)")
+    parser.add_argument("--token", required=True, help="Authentication Bearer token")
+    parser.add_argument("--local", action="store_true", help="Trigger execution via API instead of syncing")
+    args = parser.parse_args()
+    
+    headers = {
+        "Authorization": f"Bearer {args.token}",
+        "Content-Type": "application/json"
+    }
+
+    if args.local:
+        print(f"\n🚀 Launching Workflow Execution remotely via API...")
+        # To run execution we need active_workflow_id, let's fetch manifest first
+        res = requests.get(f"{args.endpoint}/ideas/{args.idea_id}/sync-manifest", headers=headers)
+        if res.status_code != 200:
+            print(f"❌ Failed to fetch workflow: {res.text}")
+            sys.exit(1)
+            
+        manifest = res.json()
+        workflow_id = manifest["active_workflow_id"]
+        
+        exec_res = requests.post(f"{args.endpoint}/workflows/{workflow_id}/execute", headers=headers, json={"input_data": {}})
+        if exec_res.status_code in (200, 201):
+            ex_id = exec_res.json().get("execution_id")
+            print(f"✅ Remote Execution Triggered: {ex_id}")
+            print("To view real-time logs, look at the Web UI 'Idea Details' panel.")
+        else:
+            print(f"❌ Failed to trigger execution: {exec_res.text}")
+        return
+
+    # Handle standard Sync
+    print(f"🔗 Connecting to Scios API ({args.endpoint}) for Idea {args.idea_id}...")
+    res = requests.get(f"{args.endpoint}/ideas/{args.idea_id}/sync-manifest", headers=headers)
+    
+    if res.status_code != 200:
+        print(f"❌ Failed to retrieve sync manifest! Status: {res.status_code}")
+        print(res.text)
+        sys.exit(1)
+        
+    data = res.json()
+    workspace_dir = Path.cwd() / f"sync_{args.idea_id}"
+    agents_dir = workspace_dir / "agents"
+    exec_dir = workspace_dir / "execution"
+    wf_dir = workspace_dir / "workflows"
+    data_dir = workspace_dir / "datasets"
+    
+    for d in [workspace_dir, agents_dir, exec_dir, wf_dir, data_dir]:
+        d.mkdir(parents=True, exist_ok=True)
+    setup_vscode_workspace(workspace_dir)
+    
+    if data.get("workflow_definition"):
+        with open(wf_dir / "definition.json", "w") as f:
+            json.dump(data["workflow_definition"], f, indent=2)
+            
+    for agent in data.get("agents", []):
+        code = agent.get("vibe_code", {}).get("code")
+        if not code: continue
+        safe_name = "".join(c if c.isalnum() else "_" for c in agent["name"])
+        with open(agents_dir / f"{safe_name}.py", "w") as f:
+            f.write(f"# AGENT_ID: {agent['id']}\n{code}")
+    print(f"✓ Loaded {len(data.get('agents', []))} native agents into {agents_dir.name}/")
+    
+    if data.get("execution"):
+        ex = data["execution"]
+        with open(exec_dir / "metrics.json", "w") as f:
+            json.dump(ex.get("metrics"), f, indent=2)
+        if ex.get("trace"):
+            with open(exec_dir / "trace.json", "w") as f:
+                json.dump(ex["trace"], f, indent=2)
+            generate_trace_summary(ex["trace"], exec_dir / "trace_summary.md")
+        if ex.get("logs"):
+            with open(exec_dir / "logs.json", "w") as f:
+                json.dump(ex["logs"], f, indent=2)
+                
+    if data.get("datasets"):
+        for ds in data["datasets"]:
+            name = "".join(c if c.isalnum() or c in ".-_" else "_" for c in ds["name"])
+            if ds["type"] == "inline":
+                header, b64_data = ds["content"].split(",", 1)
+                raw = base64.b64decode(b64_data)
+                mode = "w" if "text" in ds["mime_type"] or ds["data_type"] in ["csv", "json"] else "wb"
+                with open(data_dir / name, mode) as f:
+                    f.write(raw.decode('utf-8') if mode == "w" else raw)
+            elif ds["type"] == "gcs":
+                with open(data_dir / f"{name}.url", "w") as f:
+                    f.write(f"[InternetShortcut]\nURL={ds['content']}\n# ID: {ds['id']}")
+            else:
+                with open(data_dir / f"{name}.metadata.json", "w") as f:
+                    json.dump(ds, f, indent=2)
+                    
+    print(f"✨ Successfully pulled Scios project down over API.")
+    print(f"\n👀 Watching {agents_dir} for live agent code changes... (Press Ctrl+C to exit)")
+    
+    observer = Observer()
+    observer.schedule(AgentSyncHandler(args.endpoint, headers), str(agents_dir), recursive=False)
+    observer.start()
+    
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        observer.stop()
+        print("\nStopping watcher...")
+    observer.join()
+
+if __name__ == "__main__":
+    cli_entry()

scios_cli-0.1.0/scios_cli.egg-info/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: scios-cli
+Version: 0.1.0
+Summary: Scios Local Agent Workspace Sync CLI — bridge your terminal to the Scios Cloud backend
+Author: Scios Team
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/google-octo/science-studio
+Project-URL: Repository, https://github.com/google-octo/science-studio
+Project-URL: Documentation, https://github.com/google-octo/science-studio/tree/main/packages/cli
+Keywords: scios,cli,agent,sync,science,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: watchdog>=3.0.0
+Dynamic: license-file
+
+# Scios CLI 🚀
+
+The local workspace engine bridging your terminal natively to the Scios Cloud backend.
+
+Instead of hunting for logs scattered across web panels or modifying long agent prompts in narrow browser textboxes, you can now push a button on the Web UI to magically download the entire codebase to your machine and hot-reload changes as you type!
+
+## Overview
+By installing this lightweight Python package, whenever you click the **"Open in Antigravity"** button in Scios Web:
+1. Your browser will spawn an interactive Terminal securely connected to your session.
+2. The entire project is downloaded and formatted into a structured local directory (`sync_<idea_id>/agents/`).
+3. You can use native VS Code, your own linter, and formatting extensions to iterate on the Agent architecture.
+4. When you press `CMD+S` locally, the `scios-cli` instantly pushes the diff back to the live Cloud instances seamlessly!
+
+---
+
+## 💻 Installation
+
+Scios CLI requires **Python 3.9+** and can be quickly installed alongside your standard developer tools:
+
+```bash
+# 1. Clone or step into the Scios project (if building from source)
+cd packages/cli 
+
+# 2. Install the `scios-cli` pip package globally 
+pip install -e .
+```
+
+### Install Deep Link Handler (Critical) 🔗
+Web Browsers strictly sandbox their environment for security. To enable true one-click magical execution without copying and pasting terminal commands, you must register the native OS Protocol handler (`scios://`). 
+
+Run this command **once** anywhere in your terminal after installation:
+
+```bash
+scios-init
+```
+This is fully cross-platform and will instantly register exactly what your OS needs:
+- 🍎 **macOS**: An AppleScript wrapper app is loaded to Launch Services.
+- 🐧 **Linux**: An `.desktop` MimeType handler explicitly set.
+- 🪟 **Windows**: The protocol hooks injected correctly into `HKEY_CURRENT_USER`.
+
+---
+
+## 🏃 Usage & Workflow
+
+### 1. Activating the Live Sync
+1. In the Scios Web App, navigate to any specific **Idea** or Workflow node.
+2. Next to the "Run Pipeline" button in the header, click **Open in Antigravity**.
+3. A popup will ask you *"Allow this site to open SciosSync?"* — Click **Open**.
+
+Your system Terminal will spawn, authenticate with your specific user session automatically behind the scenes, and print:
+```text
+🔗 Received Deep Link: scios://sync?id=...
+✨ Successfully pulled Scios project down over API.
+👀 Watching /sync_1234abcd/agents for live agent code changes... (Press Ctrl+C to exit)
+```
+
+### 2. Modifying Code Locally
+Your OS will now have a `/sync_<idea_id>` directory precisely at the root of where your terminal spawned.
+Simply drag that folder right into VS Code:
+- Tweak the pandas logic, alter an LLM system prompt, or build an entire new reasoning strategy in `agents/MyAgent.py`.
+- **Hit Save:** Your terminal will blink immediately: `✅ Successfully updated agent code over API!`
+
+### 3. Remote Triggering (`--local`)
+If you don't want to use the web application to trigger an execution loop and you just want to launch your new logic:
+```bash
+scios-sync 1234-5678-your-idea-id --endpoint "https://api.scios.ai/v1" --token "eyJh..." --local
+```
+Passing `--local` directly triggers the Cloud APIs to launch that pipeline on the heavy GPUs immediately without ever having to touch a web button.
+
+---
+
+### Manual Fallback Commands
+If for some reason your organization blocks Deep Links, the "Open in Antigravity" button also copies a fail-safe execution string to your OS Clipboard:
+```bash
+scios-sync <idea_id> --endpoint "..." --token "..."
+```
+You can simply paste this string straight into your terminal after installing the pip package to achieve exact feature parity!

scios_cli-0.1.0/scios_cli.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+scios_cli/__init__.py
+scios_cli/install.py
+scios_cli/main.py
+scios_cli.egg-info/PKG-INFO
+scios_cli.egg-info/SOURCES.txt
+scios_cli.egg-info/dependency_links.txt
+scios_cli.egg-info/entry_points.txt
+scios_cli.egg-info/requires.txt
+scios_cli.egg-info/top_level.txt

scios_cli-0.1.0/scios_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

scios_cli-0.1.0/scios_cli.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+scios-init = scios_cli.install:cli_install_protocol
+scios-sync = scios_cli.main:cli_entry

scios_cli-0.1.0/scios_cli.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests>=2.31.0
+watchdog>=3.0.0

scios_cli-0.1.0/scios_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+scios_cli

scios_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

scios_cli-0.1.0/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="scios-cli",
+    version="0.1.0",
+    description="Scios Local Agent Workspace Sync CLI",
+    author="Scios",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.31.0",
+        "watchdog>=3.0.0"
+    ],
+    entry_points={
+        "console_scripts": [
+            "scios-sync=scios_cli.main:cli_entry",
+            "scios-init=scios_cli.install:cli_install_protocol",
+        ],
+    },
+)