shotops-mcp 0.6.1 → 0.7.0

package/LICENSE

@@ -0,0 +1,97 @@
+ShotOps CLI and Local MCP License
+Version 1.1 — 11 August 2026
+
+Copyright (c) 2026 Rasmus Gehrke. All rights reserved.
+
+This license governs the `shotops-mcp` software package, including the bundled
+ShotOps rendering engine (the "Software"). "You" means the individual or legal
+entity exercising the rights granted below. The Software is licensed, not sold.
+Third-party components and assets are excluded from the definition of Software
+and are governed by their own licenses and notices.
+
+GRANT
+
+Subject to this license, you are granted a free, worldwide, royalty-free,
+non-exclusive, non-transferable right to:
+
+1. install and run the Software, without limit, in computing environments you
+   own, control, or are authorized to use, including via `npx` and in CI;
+2. use the Software to render device mockups, screenshot strips, and store
+   bundles from content you are authorized to use; and
+3. use, publish, and commercialize the output the Software produces from that
+   content, subject to any rights in your content, third-party components,
+   assets, device designs, and trademarks.
+
+As between you and the copyright holder, the copyright holder claims no
+ownership in your content or in output created from it. This license does not
+grant rights in third-party content, assets, designs, or trademarks that may
+appear in the output.
+
+Use of ShotOps hosted services through the Software is additionally governed
+by the ShotOps Terms of Service at https://shotops.dev/terms.
+
+RESTRICTIONS
+
+You may not:
+
+1. redistribute, republish, sell, rent, sublicense, or otherwise provide the
+   Software or any part of it (including the bundled rendering engine) to a
+   third party;
+2. modify the Software or create derivative works from it;
+3. extract, copy, or reuse components of the Software — including the
+   rendering engine — in another product or service;
+4. offer the Software's functionality to third parties as a service, or use
+   it to build a product or service that competes with ShotOps; or
+5. reverse engineer, decompile, disassemble, or otherwise attempt to derive
+   the source code of the Software; or
+6. remove or obscure copyright, license, or attribution notices.
+
+These restrictions apply only to the extent permitted by law. Nothing in this
+license limits a right that cannot lawfully be waived or restricted. In
+particular, where Directive 2009/24/EC or equivalent national law applies, this
+license does not restrict the lawful user's rights to make a necessary backup
+copy, to observe, study, or test the functioning of the Software while
+performing authorized acts, or to reproduce or translate code where that is
+indispensable to achieve interoperability and all statutory conditions are met.
+
+THIRD-PARTY COMPONENTS
+
+The Software depends on and may bundle third-party components and assets.
+Their copyright notices and license terms are identified in the files,
+metadata, or THIRD_PARTY_NOTICES distributed with the package. Those terms,
+not this license, govern the relevant third-party material. Nothing in this
+license restricts rights granted under a third-party license.
+
+TERMINATION
+
+If you materially breach this license, your rights terminate if you do not cure
+the breach within 14 days after receiving notice. Rights terminate immediately
+for a breach that cannot be cured or that involves intentional unauthorized
+redistribution or provision of the Software as a service. On termination, you
+must stop using the Software and delete your copies. Provisions that by their
+nature should survive termination, including ownership, restrictions,
+warranty, and liability provisions, remain effective.
+
+NO WARRANTY; LIABILITY
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
+NON-INFRINGEMENT. TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE COPYRIGHT HOLDER
+IS NOT LIABLE FOR INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE
+DAMAGES, OR FOR LOSS OF DATA, REVENUE, OR PROFITS, ARISING FROM OR IN CONNECTION
+WITH THE SOFTWARE OR ITS USE.
+
+NOTHING IN THIS LICENSE EXCLUDES OR LIMITS MANDATORY STATUTORY RIGHTS OR
+REMEDIES, INCLUDING CONSUMER RIGHTS RELATING TO CONFORMITY OF DIGITAL CONTENT,
+OR LIABILITY THAT CANNOT LAWFULLY BE EXCLUDED OR LIMITED.
+
+GOVERNING LAW
+
+This license is governed by the law of Denmark, without regard to conflict-of-
+laws rules. If you are a consumer, this choice does not deprive you of mandatory
+protections provided by the law that would apply without this choice, and
+jurisdiction is determined by mandatory consumer-jurisdiction rules. In all
+other cases, disputes are subject to the exclusive jurisdiction of the courts
+of Denmark.
+
+Contact: support@shotops.dev

package/README.md

@@ -432,24 +432,40 @@ manifest through the Studio control plane, downloads only the resolved cells, an
 
 | | Local (free, `npx shotops-mcp`) | Hosted (`shotops_…` token) |
 |---|---|---|
-| Render compute | **your machine** ($0, no timeout) | our servers |
+| Render compute | **your machine** ($0, no timeout) | our servers — spends your ShotOps credits: 1,000 per preview panel, 4,000 per full-resolution panel |
 | Auth | none (the process runs as you) | account + API token |
 | Saved looks / editable projects / project read+re-render / share links | new project: pending claim; existing/account state: token (below); share links: hosted | ✅ |
 | Screenshot input | local `{ path }` off disk | `request_screenshot_upload` → `{ ref }` |
 
 ### Optional: bridge a local render into your hosted account
 
-Pass a personal ShotOps API token (Studio → account menu → **API tokens** — the same
-`shotops_…` token the hosted server takes as a bearer) and `save_project` / `read_look` /
-`save_look` / `read_project` / `render_project` start working too — **rendering still happens
-locally and for free.** A deliberate save also uploads its local source PNGs privately so the
-project reopens with screenshots on another device; normal renders and exports never upload:
+Connect your account and `save_project` / `read_look` / `save_look` / `read_project` /
+`render_project` start working too — **rendering still happens locally and for free.** A
+deliberate save also uploads its local source PNGs privately so the project reopens with
+screenshots on another device; normal renders and exports never upload.
+
+Sign in through your browser, once per machine:
+
+```bash
+npx shotops-mcp login     # opens ShotOps in your browser, saves the token it gets back
+npx shotops-mcp whoami    # which account is connected, and its plan
+npx shotops-mcp logout    # revokes that token and removes it from this machine
+```
+
+The token lands in `~/.shotops/credentials.json`, readable only by you, and every later
+`npx shotops-mcp` picks it up — nothing to paste into a client config. It is an ordinary
+ShotOps API token: revoke it any time from Studio → account menu → **API tokens**.
+
+For CI, or to point one client at a different account, pass the token explicitly instead:
 
 ```bash
 SHOTOPS_TOKEN=shotops_… claude mcp add shotops -- npx -y shotops-mcp
 # or: npx shotops-mcp --token shotops_…
 ```
 
+`--token` wins over `SHOTOPS_TOKEN`, which wins over a saved browser login — so a token in the
+environment is never quietly shadowed by whoever last signed in on that machine.
+
 The saved project remembers the exact on-disk folder your screenshots came from (not just their
 filenames), so re-opening it on the SAME machine can point right back at it. Share links aren't
 bridged yet — they'd need a hosted rendering step, which would defeat local rendering's whole

package/THIRD_PARTY_NOTICES

@@ -0,0 +1,156 @@
+Third-Party Notices for shotops-mcp
+
+This file identifies third-party software, font files and 3D models bundled
+directly in the shotops-mcp package. Dependencies installed as separate npm
+packages carry their own license files.
+
+-------------------------------------------------------------------------------
+iPhone 17 Pro 3D model
+-------------------------------------------------------------------------------
+
+"iPhone 17 Pro" by Ranguel (https://sketchfab.com/Ranguel)
+Source: https://sketchfab.com/3d-models/iphone-17-pro-4541aa8a28324b33a2baaf81d263aaec
+Licensed under Creative Commons Attribution 4.0 International (CC BY 4.0):
+https://creativecommons.org/licenses/by/4.0/
+
+The model file bundled here (dist/harness assets) is a converted and optimized
+derivative of that work, produced with glTF-Transform. CC BY 4.0 permits both
+commercial use and redistribution of the model, including in modified form,
+provided the author is credited — which is what this notice is for. Keep it in
+any redistribution of this package.
+
+Apple and iPhone are trademarks of Apple Inc. Google and Pixel are trademarks
+of Google LLC. Neither company sponsors or endorses ShotOps.
+
+-------------------------------------------------------------------------------
+Three.js
+-------------------------------------------------------------------------------
+
+Copyright (c) 2010-2024 three.js authors
+
+The MIT License
+
+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.
+
+-------------------------------------------------------------------------------
+Bundled caption fonts
+-------------------------------------------------------------------------------
+
+The package includes unmodified, Latin-subset WOFF2 files from these font
+families:
+
+Inter
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+Manrope
+Copyright 2018 The Manrope Project Authors (https://github.com/sharanda/manrope)
+
+Poppins
+Copyright 2020 The Poppins Project Authors (https://github.com/itfoundry/Poppins)
+
+Fraunces
+Copyright 2018 The Fraunces Project Authors (https://github.com/undercasetype/Fraunces)
+
+Space Grotesk
+Copyright 2020 The Space Grotesk Project Authors (https://github.com/floriankarsten/space-grotesk)
+
+Each font is licensed under the SIL Open Font License, Version 1.1:
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The fonts,
+including any derivative works, can be bundled, embedded, redistributed
+and/or sold with any software provided that any reserved names are not used
+by derivative works. The fonts and derivatives, however, cannot be released
+under any other type of license. The requirement for fonts to remain under
+this license does not apply to any document created using the fonts or their
+derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may include
+source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical writer or
+other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the Font Software, to use, study, copy, merge, embed, modify, redistribute,
+and sell modified and unmodified copies of the Font Software, subject to the
+following conditions:
+
+1) Neither the Font Software nor any of its individual components, in
+Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy contains
+the above copyright notice and this license. These can be included either as
+stand-alone text files, human-readable headers or in the appropriate
+machine-readable metadata fields within text or binary files as long as those
+fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font Name(s)
+unless explicit written permission is granted by the corresponding Copyright
+Holder. This restriction only applies to the primary font name as presented
+to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any Modified
+Version, except to acknowledge the contribution(s) of the Copyright Holder(s)
+and the Author(s) or with their explicit written permission.
+
+5) The Font Software, modified or unmodified, in part or in whole, must be
+distributed entirely under this license, and must not be distributed under
+any other license. The requirement for fonts to remain under this license
+does not apply to any document created using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,
+TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR
+ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL, SPECIAL,
+INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER IN AN ACTION OF
+CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF THE USE OR INABILITY TO USE
+THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.