October 2026 main drop: mirror from GitHub
Browse files- .gitignore +19 -0
- LICENSE +661 -0
- README.md +15 -0
- app/android/README.md +34 -0
- app/android/build.gradle.kts +45 -0
- app/android/src/main/AndroidManifest.xml +20 -0
- app/android/src/main/kotlin/cc/android/CommandCenterViewModel.kt +102 -0
- app/android/src/main/kotlin/cc/android/MainActivity.kt +78 -0
- app/android/src/main/kotlin/cc/android/ui/ChatScreen.kt +75 -0
- app/android/src/main/kotlin/cc/android/ui/ServerAdminScreen.kt +84 -0
- app/build.gradle.kts +15 -0
- app/core/build.gradle.kts +38 -0
- app/core/src/main/kotlin/cc/core/AgentClient.kt +71 -0
- app/core/src/main/kotlin/cc/core/Config.kt +53 -0
- app/core/src/main/kotlin/cc/core/Models.kt +58 -0
- app/core/src/main/kotlin/cc/core/SshClient.kt +86 -0
- app/core/src/main/kotlin/cc/core/WebSocketBridge.kt +192 -0
- app/core/src/test/kotlin/cc/core/AgentClientTest.kt +150 -0
- app/core/src/test/kotlin/cc/core/WebSocketBridgeTest.kt +159 -0
- app/desktop/build.gradle.kts +15 -0
- app/desktop/src/main/kotlin/cc/desktop/Main.kt +83 -0
- app/gradle.properties +4 -0
- app/settings.gradle.kts +21 -0
- server/ACCESS_SETUP.md +61 -0
- server/config.yml +20 -0
- server/setup.sh +92 -0
- worker/worker.js +115 -0
- worker/wrangler.toml +21 -0
.gitignore
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Gradle / build outputs
|
| 2 |
+
.gradle/
|
| 3 |
+
build/
|
| 4 |
+
out/
|
| 5 |
+
*.class
|
| 6 |
+
|
| 7 |
+
# Wrapper jar (regenerate with `gradle wrapper` on your machine)
|
| 8 |
+
gradle/wrapper/gradle-wrapper.jar
|
| 9 |
+
|
| 10 |
+
# IDE
|
| 11 |
+
.idea/
|
| 12 |
+
*.iml
|
| 13 |
+
.DS_Store
|
| 14 |
+
|
| 15 |
+
# Local secrets — never commit
|
| 16 |
+
local.properties
|
| 17 |
+
*.jks
|
| 18 |
+
*.keystore
|
| 19 |
+
.env
|
LICENSE
ADDED
|
@@ -0,0 +1,661 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
GNU AFFERO GENERAL PUBLIC LICENSE
|
| 2 |
+
Version 3, 19 November 2007
|
| 3 |
+
|
| 4 |
+
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
| 5 |
+
Everyone is permitted to copy and distribute verbatim copies
|
| 6 |
+
of this license document, but changing it is not allowed.
|
| 7 |
+
|
| 8 |
+
Preamble
|
| 9 |
+
|
| 10 |
+
The GNU Affero General Public License is a free, copyleft license for
|
| 11 |
+
software and other kinds of works, specifically designed to ensure
|
| 12 |
+
cooperation with the community in the case of network server software.
|
| 13 |
+
|
| 14 |
+
The licenses for most software and other practical works are designed
|
| 15 |
+
to take away your freedom to share and change the works. By contrast,
|
| 16 |
+
our General Public Licenses are intended to guarantee your freedom to
|
| 17 |
+
share and change all versions of a program--to make sure it remains free
|
| 18 |
+
software for all its users.
|
| 19 |
+
|
| 20 |
+
When we speak of free software, we are referring to freedom, not
|
| 21 |
+
price. Our General Public Licenses are designed to make sure that you
|
| 22 |
+
have the freedom to distribute copies of free software (and charge for
|
| 23 |
+
them if you wish), that you receive source code or can get it if you
|
| 24 |
+
want it, that you can change the software or use pieces of it in new
|
| 25 |
+
free programs, and that you know you can do these things.
|
| 26 |
+
|
| 27 |
+
Developers that use our General Public Licenses protect your rights
|
| 28 |
+
with two steps: (1) assert copyright on the software, and (2) offer
|
| 29 |
+
you this License which gives you legal permission to copy, distribute
|
| 30 |
+
and/or modify the software.
|
| 31 |
+
|
| 32 |
+
A secondary benefit of defending all users' freedom is that
|
| 33 |
+
improvements made in alternate versions of the program, if they
|
| 34 |
+
receive widespread use, become available for other developers to
|
| 35 |
+
incorporate. Many developers of free software are heartened and
|
| 36 |
+
encouraged by the resulting cooperation. However, in the case of
|
| 37 |
+
software used on network servers, this result may fail to come about.
|
| 38 |
+
The GNU General Public License permits making a modified version and
|
| 39 |
+
letting the public access it on a server without ever releasing its
|
| 40 |
+
source code to the public.
|
| 41 |
+
|
| 42 |
+
The GNU Affero General Public License is designed specifically to
|
| 43 |
+
ensure that, in such cases, the modified source code becomes available
|
| 44 |
+
to the community. It requires the operator of a network server to
|
| 45 |
+
provide the source code of the modified version running there to the
|
| 46 |
+
users of that server. Therefore, public use of a modified version, on
|
| 47 |
+
a publicly accessible server, gives the public access to the source
|
| 48 |
+
code of the modified version.
|
| 49 |
+
|
| 50 |
+
An older license, called the Affero General Public License and
|
| 51 |
+
published by Affero, was designed to accomplish similar goals. This is
|
| 52 |
+
a different license, not a version of the Affero GPL, but Affero has
|
| 53 |
+
released a new version of the Affero GPL which permits relicensing under
|
| 54 |
+
this license.
|
| 55 |
+
|
| 56 |
+
The precise terms and conditions for copying, distribution and
|
| 57 |
+
modification follow.
|
| 58 |
+
|
| 59 |
+
TERMS AND CONDITIONS
|
| 60 |
+
|
| 61 |
+
0. Definitions.
|
| 62 |
+
|
| 63 |
+
"This License" refers to version 3 of the GNU Affero General Public License.
|
| 64 |
+
|
| 65 |
+
"Copyright" also means copyright-like laws that apply to other kinds of
|
| 66 |
+
works, such as semiconductor masks.
|
| 67 |
+
|
| 68 |
+
"The Program" refers to any copyrightable work licensed under this
|
| 69 |
+
License. Each licensee is addressed as "you". "Licensees" and
|
| 70 |
+
"recipients" may be individuals or organizations.
|
| 71 |
+
|
| 72 |
+
To "modify" a work means to copy from or adapt all or part of the work
|
| 73 |
+
in a fashion requiring copyright permission, other than the making of an
|
| 74 |
+
exact copy. The resulting work is called a "modified version" of the
|
| 75 |
+
earlier work or a work "based on" the earlier work.
|
| 76 |
+
|
| 77 |
+
A "covered work" means either the unmodified Program or a work based
|
| 78 |
+
on the Program.
|
| 79 |
+
|
| 80 |
+
To "propagate" a work means to do anything with it that, without
|
| 81 |
+
permission, would make you directly or secondarily liable for
|
| 82 |
+
infringement under applicable copyright law, except executing it on a
|
| 83 |
+
computer or modifying a private copy. Propagation includes copying,
|
| 84 |
+
distribution (with or without modification), making available to the
|
| 85 |
+
public, and in some countries other activities as well.
|
| 86 |
+
|
| 87 |
+
To "convey" a work means any kind of propagation that enables other
|
| 88 |
+
parties to make or receive copies. Mere interaction with a user through
|
| 89 |
+
a computer network, with no transfer of a copy, is not conveying.
|
| 90 |
+
|
| 91 |
+
An interactive user interface displays "Appropriate Legal Notices"
|
| 92 |
+
to the extent that it includes a convenient and prominently visible
|
| 93 |
+
feature that (1) displays an appropriate copyright notice, and (2)
|
| 94 |
+
tells the user that there is no warranty for the work (except to the
|
| 95 |
+
extent that warranties are provided), that licensees may convey the
|
| 96 |
+
work under this License, and how to view a copy of this License. If
|
| 97 |
+
the interface presents a list of user commands or options, such as a
|
| 98 |
+
menu, a prominent item in the list meets this criterion.
|
| 99 |
+
|
| 100 |
+
1. Source Code.
|
| 101 |
+
|
| 102 |
+
The "source code" for a work means the preferred form of the work
|
| 103 |
+
for making modifications to it. "Object code" means any non-source
|
| 104 |
+
form of a work.
|
| 105 |
+
|
| 106 |
+
A "Standard Interface" means an interface that either is an official
|
| 107 |
+
standard defined by a recognized standards body, or, in the case of
|
| 108 |
+
interfaces specified for a particular programming language, one that
|
| 109 |
+
is widely used among developers working in that language.
|
| 110 |
+
|
| 111 |
+
The "System Libraries" of an executable work include anything, other
|
| 112 |
+
than the work as a whole, that (a) is included in the normal form of
|
| 113 |
+
packaging a Major Component, but which is not part of that Major
|
| 114 |
+
Component, and (b) serves only to enable use of the work with that
|
| 115 |
+
Major Component, or to implement a Standard Interface for which an
|
| 116 |
+
implementation is available to the public in source code form. A
|
| 117 |
+
"Major Component", in this context, means a major essential component
|
| 118 |
+
(kernel, window system, and so on) of the specific operating system
|
| 119 |
+
(if any) on which the executable work runs, or a compiler used to
|
| 120 |
+
produce the work, or an object code interpreter used to run it.
|
| 121 |
+
|
| 122 |
+
The "Corresponding Source" for a work in object code form means all
|
| 123 |
+
the source code needed to generate, install, and (for an executable
|
| 124 |
+
work) run the object code and to modify the work, including scripts to
|
| 125 |
+
control those activities. However, it does not include the work's
|
| 126 |
+
System Libraries, or general-purpose tools or generally available free
|
| 127 |
+
programs which are used unmodified in performing those activities but
|
| 128 |
+
which are not part of the work. For example, Corresponding Source
|
| 129 |
+
includes interface definition files associated with source files for
|
| 130 |
+
the work, and the source code for shared libraries and dynamically
|
| 131 |
+
linked subprograms that the work is specifically designed to require,
|
| 132 |
+
such as by intimate data communication or control flow between those
|
| 133 |
+
subprograms and other parts of the work.
|
| 134 |
+
|
| 135 |
+
The Corresponding Source need not include anything that users
|
| 136 |
+
can regenerate automatically from other parts of the Corresponding
|
| 137 |
+
Source.
|
| 138 |
+
|
| 139 |
+
The Corresponding Source for a work in source code form is that
|
| 140 |
+
same work.
|
| 141 |
+
|
| 142 |
+
2. Basic Permissions.
|
| 143 |
+
|
| 144 |
+
All rights granted under this License are granted for the term of
|
| 145 |
+
copyright on the Program, and are irrevocable provided the stated
|
| 146 |
+
conditions are met. This License explicitly affirms your unlimited
|
| 147 |
+
permission to run the unmodified Program. The output from running a
|
| 148 |
+
covered work is covered by this License only if the output, given its
|
| 149 |
+
content, constitutes a covered work. This License acknowledges your
|
| 150 |
+
rights of fair use or other equivalent, as provided by copyright law.
|
| 151 |
+
|
| 152 |
+
You may make, run and propagate covered works that you do not
|
| 153 |
+
convey, without conditions so long as your license otherwise remains
|
| 154 |
+
in force. You may convey covered works to others for the sole purpose
|
| 155 |
+
of having them make modifications exclusively for you, or provide you
|
| 156 |
+
with facilities for running those works, provided that you comply with
|
| 157 |
+
the terms of this License in conveying all material for which you do
|
| 158 |
+
not control copyright. Those thus making or running the covered works
|
| 159 |
+
for you must do so exclusively on your behalf, under your direction
|
| 160 |
+
and control, on terms that prohibit them from making any copies of
|
| 161 |
+
your copyrighted material outside their relationship with you.
|
| 162 |
+
|
| 163 |
+
Conveying under any other circumstances is permitted solely under
|
| 164 |
+
the conditions stated below. Sublicensing is not allowed; section 10
|
| 165 |
+
makes it unnecessary.
|
| 166 |
+
|
| 167 |
+
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
| 168 |
+
|
| 169 |
+
No covered work shall be deemed part of an effective technological
|
| 170 |
+
measure under any applicable law fulfilling obligations under article
|
| 171 |
+
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
| 172 |
+
similar laws prohibiting or restricting circumvention of such
|
| 173 |
+
measures.
|
| 174 |
+
|
| 175 |
+
When you convey a covered work, you waive any legal power to forbid
|
| 176 |
+
circumvention of technological measures to the extent such circumvention
|
| 177 |
+
is effected by exercising rights under this License with respect to
|
| 178 |
+
the covered work, and you disclaim any intention to limit operation or
|
| 179 |
+
modification of the work as a means of enforcing, against the work's
|
| 180 |
+
users, your or third parties' legal rights to forbid circumvention of
|
| 181 |
+
technological measures.
|
| 182 |
+
|
| 183 |
+
4. Conveying Verbatim Copies.
|
| 184 |
+
|
| 185 |
+
You may convey verbatim copies of the Program's source code as you
|
| 186 |
+
receive it, in any medium, provided that you conspicuously and
|
| 187 |
+
appropriately publish on each copy an appropriate copyright notice;
|
| 188 |
+
keep intact all notices stating that this License and any
|
| 189 |
+
non-permissive terms added in accord with section 7 apply to the code;
|
| 190 |
+
keep intact all notices of the absence of any warranty; and give all
|
| 191 |
+
recipients a copy of this License along with the Program.
|
| 192 |
+
|
| 193 |
+
You may charge any price or no price for each copy that you convey,
|
| 194 |
+
and you may offer support or warranty protection for a fee.
|
| 195 |
+
|
| 196 |
+
5. Conveying Modified Source Versions.
|
| 197 |
+
|
| 198 |
+
You may convey a work based on the Program, or the modifications to
|
| 199 |
+
produce it from the Program, in the form of source code under the
|
| 200 |
+
terms of section 4, provided that you also meet all of these conditions:
|
| 201 |
+
|
| 202 |
+
a) The work must carry prominent notices stating that you modified
|
| 203 |
+
it, and giving a relevant date.
|
| 204 |
+
|
| 205 |
+
b) The work must carry prominent notices stating that it is
|
| 206 |
+
released under this License and any conditions added under section
|
| 207 |
+
7. This requirement modifies the requirement in section 4 to
|
| 208 |
+
"keep intact all notices".
|
| 209 |
+
|
| 210 |
+
c) You must license the entire work, as a whole, under this
|
| 211 |
+
License to anyone who comes into possession of a copy. This
|
| 212 |
+
License will therefore apply, along with any applicable section 7
|
| 213 |
+
additional terms, to the whole of the work, and all its parts,
|
| 214 |
+
regardless of how they are packaged. This License gives no
|
| 215 |
+
permission to license the work in any other way, but it does not
|
| 216 |
+
invalidate such permission if you have separately received it.
|
| 217 |
+
|
| 218 |
+
d) If the work has interactive user interfaces, each must display
|
| 219 |
+
Appropriate Legal Notices; however, if the Program has interactive
|
| 220 |
+
interfaces that do not display Appropriate Legal Notices, your
|
| 221 |
+
work need not make them do so.
|
| 222 |
+
|
| 223 |
+
A compilation of a covered work with other separate and independent
|
| 224 |
+
works, which are not by their nature extensions of the covered work,
|
| 225 |
+
and which are not combined with it such as to form a larger program,
|
| 226 |
+
in or on a volume of a storage or distribution medium, is called an
|
| 227 |
+
"aggregate" if the compilation and its resulting copyright are not
|
| 228 |
+
used to limit the access or legal rights of the compilation's users
|
| 229 |
+
beyond what the individual works permit. Inclusion of a covered work
|
| 230 |
+
in an aggregate does not cause this License to apply to the other
|
| 231 |
+
parts of the aggregate.
|
| 232 |
+
|
| 233 |
+
6. Conveying Non-Source Forms.
|
| 234 |
+
|
| 235 |
+
You may convey a covered work in object code form under the terms
|
| 236 |
+
of sections 4 and 5, provided that you also convey the
|
| 237 |
+
machine-readable Corresponding Source under the terms of this License,
|
| 238 |
+
in one of these ways:
|
| 239 |
+
|
| 240 |
+
a) Convey the object code in, or embodied in, a physical product
|
| 241 |
+
(including a physical distribution medium), accompanied by the
|
| 242 |
+
Corresponding Source fixed on a durable physical medium
|
| 243 |
+
customarily used for software interchange.
|
| 244 |
+
|
| 245 |
+
b) Convey the object code in, or embodied in, a physical product
|
| 246 |
+
(including a physical distribution medium), accompanied by a
|
| 247 |
+
written offer, valid for at least three years and valid for as
|
| 248 |
+
long as you offer spare parts or customer support for that product
|
| 249 |
+
model, to give anyone who possesses the object code either (1) a
|
| 250 |
+
copy of the Corresponding Source for all the software in the
|
| 251 |
+
product that is covered by this License, on a durable physical
|
| 252 |
+
medium customarily used for software interchange, for a price no
|
| 253 |
+
more than your reasonable cost of physically performing this
|
| 254 |
+
conveying of source, or (2) access to copy the
|
| 255 |
+
Corresponding Source from a network server at no charge.
|
| 256 |
+
|
| 257 |
+
c) Convey individual copies of the object code with a copy of the
|
| 258 |
+
written offer to provide the Corresponding Source. This
|
| 259 |
+
alternative is allowed only occasionally and noncommercially, and
|
| 260 |
+
only if you received the object code with such an offer, in accord
|
| 261 |
+
with subsection 6b.
|
| 262 |
+
|
| 263 |
+
d) Convey the object code by offering access from a designated
|
| 264 |
+
place (gratis or for a charge), and offer equivalent access to the
|
| 265 |
+
Corresponding Source in the same way through the same place at no
|
| 266 |
+
further charge. You need not require recipients to copy the
|
| 267 |
+
Corresponding Source along with the object code. If the place to
|
| 268 |
+
copy the object code is a network server, the Corresponding Source
|
| 269 |
+
may be on a different server (operated by you or a third party)
|
| 270 |
+
that supports equivalent copying facilities, provided you maintain
|
| 271 |
+
clear directions next to the object code saying where to find the
|
| 272 |
+
Corresponding Source. Regardless of what server hosts the
|
| 273 |
+
Corresponding Source, you remain obligated to ensure that it is
|
| 274 |
+
available for as long as needed to satisfy these requirements.
|
| 275 |
+
|
| 276 |
+
e) Convey the object code using peer-to-peer transmission, provided
|
| 277 |
+
you inform other peers where the object code and Corresponding
|
| 278 |
+
Source of the work are being offered to the general public at no
|
| 279 |
+
charge under subsection 6d.
|
| 280 |
+
|
| 281 |
+
A separable portion of the object code, whose source code is excluded
|
| 282 |
+
from the Corresponding Source as a System Library, need not be
|
| 283 |
+
included in conveying the object code work.
|
| 284 |
+
|
| 285 |
+
A "User Product" is either (1) a "consumer product", which means any
|
| 286 |
+
tangible personal property which is normally used for personal, family,
|
| 287 |
+
or household purposes, or (2) anything designed or sold for incorporation
|
| 288 |
+
into a dwelling. In determining whether a product is a consumer product,
|
| 289 |
+
doubtful cases shall be resolved in favor of coverage. For a particular
|
| 290 |
+
product received by a particular user, "normally used" refers to a
|
| 291 |
+
typical or common use of that class of product, regardless of the status
|
| 292 |
+
of the particular user or of the way in which the particular user
|
| 293 |
+
actually uses, or expects or is expected to use, the product. A product
|
| 294 |
+
is a consumer product regardless of whether the product has substantial
|
| 295 |
+
commercial, industrial or non-consumer uses, unless such uses represent
|
| 296 |
+
the only significant mode of use of the product.
|
| 297 |
+
|
| 298 |
+
"Installation Information" for a User Product means any methods,
|
| 299 |
+
procedures, authorization keys, or other information required to install
|
| 300 |
+
and execute modified versions of a covered work in that User Product from
|
| 301 |
+
a modified version of its Corresponding Source. The information must
|
| 302 |
+
suffice to ensure that the continued functioning of the modified object
|
| 303 |
+
code is in no case prevented or interfered with solely because
|
| 304 |
+
modification has been made.
|
| 305 |
+
|
| 306 |
+
If you convey an object code work under this section in, or with, or
|
| 307 |
+
specifically for use in, a User Product, and the conveying occurs as
|
| 308 |
+
part of a transaction in which the right of possession and use of the
|
| 309 |
+
User Product is transferred to the recipient in perpetuity or for a
|
| 310 |
+
fixed term (regardless of how the transaction is characterized), the
|
| 311 |
+
Corresponding Source conveyed under this section must be accompanied
|
| 312 |
+
by the Installation Information. But this requirement does not apply
|
| 313 |
+
if neither you nor any third party retains the ability to install
|
| 314 |
+
modified object code on the User Product (for example, the work has
|
| 315 |
+
been installed in ROM).
|
| 316 |
+
|
| 317 |
+
The requirement to provide Installation Information does not include a
|
| 318 |
+
requirement to continue to provide support service, warranty, or updates
|
| 319 |
+
for a work that has been modified or installed by the recipient, or for
|
| 320 |
+
the User Product in which it has been modified or installed. Access to a
|
| 321 |
+
network may be denied when the modification itself materially and
|
| 322 |
+
adversely affects the operation of the network or violates the rules and
|
| 323 |
+
protocols for communication across the network.
|
| 324 |
+
|
| 325 |
+
Corresponding Source conveyed, and Installation Information provided,
|
| 326 |
+
in accord with this section must be in a format that is publicly
|
| 327 |
+
documented (and with an implementation available to the public in
|
| 328 |
+
source code form), and must require no special password or key for
|
| 329 |
+
unpacking, reading or copying.
|
| 330 |
+
|
| 331 |
+
7. Additional Terms.
|
| 332 |
+
|
| 333 |
+
"Additional permissions" are terms that supplement the terms of this
|
| 334 |
+
License by making exceptions from one or more of its conditions.
|
| 335 |
+
Additional permissions that are applicable to the entire Program shall
|
| 336 |
+
be treated as though they were included in this License, to the extent
|
| 337 |
+
that they are valid under applicable law. If additional permissions
|
| 338 |
+
apply only to part of the Program, that part may be used separately
|
| 339 |
+
under those permissions, but the entire Program remains governed by
|
| 340 |
+
this License without regard to the additional permissions.
|
| 341 |
+
|
| 342 |
+
When you convey a copy of a covered work, you may at your option
|
| 343 |
+
remove any additional permissions from that copy, or from any part of
|
| 344 |
+
it. (Additional permissions may be written to require their own
|
| 345 |
+
removal in certain cases when you modify the work.) You may place
|
| 346 |
+
additional permissions on material, added by you to a covered work,
|
| 347 |
+
for which you have or can give appropriate copyright permission.
|
| 348 |
+
|
| 349 |
+
Notwithstanding any other provision of this License, for material you
|
| 350 |
+
add to a covered work, you may (if authorized by the copyright holders of
|
| 351 |
+
that material) supplement the terms of this License with terms:
|
| 352 |
+
|
| 353 |
+
a) Disclaiming warranty or limiting liability differently from the
|
| 354 |
+
terms of sections 15 and 16 of this License; or
|
| 355 |
+
|
| 356 |
+
b) Requiring preservation of specified reasonable legal notices or
|
| 357 |
+
author attributions in that material or in the Appropriate Legal
|
| 358 |
+
Notices displayed by works containing it; or
|
| 359 |
+
|
| 360 |
+
c) Prohibiting misrepresentation of the origin of that material, or
|
| 361 |
+
requiring that modified versions of such material be marked in
|
| 362 |
+
reasonable ways as different from the original version; or
|
| 363 |
+
|
| 364 |
+
d) Limiting the use for publicity purposes of names of licensors or
|
| 365 |
+
authors of the material; or
|
| 366 |
+
|
| 367 |
+
e) Declining to grant rights under trademark law for use of some
|
| 368 |
+
trade names, trademarks, or service marks; or
|
| 369 |
+
|
| 370 |
+
f) Requiring indemnification of licensors and authors of that
|
| 371 |
+
material by anyone who conveys the material (or modified versions of
|
| 372 |
+
it) with contractual assumptions of liability to the recipient, for
|
| 373 |
+
any liability that these contractual assumptions directly impose on
|
| 374 |
+
those licensors and authors.
|
| 375 |
+
|
| 376 |
+
All other non-permissive additional terms are considered "further
|
| 377 |
+
restrictions" within the meaning of section 10. If the Program as you
|
| 378 |
+
received it, or any part of it, contains a notice stating that it is
|
| 379 |
+
governed by this License along with a term that is a further
|
| 380 |
+
restriction, you may remove that term. If a license document contains
|
| 381 |
+
a further restriction but permits relicensing or conveying under this
|
| 382 |
+
License, you may add to a covered work material governed by the terms
|
| 383 |
+
of that license document, provided that the further restriction does
|
| 384 |
+
not survive such relicensing or conveying.
|
| 385 |
+
|
| 386 |
+
If you add terms to a covered work in accord with this section, you
|
| 387 |
+
must place, in the relevant source files, a statement of the
|
| 388 |
+
additional terms that apply to those files, or a notice indicating
|
| 389 |
+
where to find the applicable terms.
|
| 390 |
+
|
| 391 |
+
Additional terms, permissive or non-permissive, may be stated in the
|
| 392 |
+
form of a separately written license, or stated as exceptions;
|
| 393 |
+
the above requirements apply either way.
|
| 394 |
+
|
| 395 |
+
8. Termination.
|
| 396 |
+
|
| 397 |
+
You may not propagate or modify a covered work except as expressly
|
| 398 |
+
provided under this License. Any attempt otherwise to propagate or
|
| 399 |
+
modify it is void, and will automatically terminate your rights under
|
| 400 |
+
this License (including any patent licenses granted under the third
|
| 401 |
+
paragraph of section 11).
|
| 402 |
+
|
| 403 |
+
However, if you cease all violation of this License, then your
|
| 404 |
+
license from a particular copyright holder is reinstated (a)
|
| 405 |
+
provisionally, unless and until the copyright holder explicitly and
|
| 406 |
+
finally terminates your license, and (b) permanently, if the copyright
|
| 407 |
+
holder fails to notify you of the violation by some reasonable means
|
| 408 |
+
prior to 60 days after the cessation.
|
| 409 |
+
|
| 410 |
+
Moreover, your license from a particular copyright holder is
|
| 411 |
+
reinstated permanently if the copyright holder notifies you of the
|
| 412 |
+
violation by some reasonable means, this is the first time you have
|
| 413 |
+
received notice of violation of this License (for any work) from that
|
| 414 |
+
copyright holder, and you cure the violation prior to 30 days after
|
| 415 |
+
your receipt of the notice.
|
| 416 |
+
|
| 417 |
+
Termination of your rights under this section does not terminate the
|
| 418 |
+
licenses of parties who have received copies or rights from you under
|
| 419 |
+
this License. If your rights have been terminated and not permanently
|
| 420 |
+
reinstated, you do not qualify to receive new licenses for the same
|
| 421 |
+
material under section 10.
|
| 422 |
+
|
| 423 |
+
9. Acceptance Not Required for Having Copies.
|
| 424 |
+
|
| 425 |
+
You are not required to accept this License in order to receive or
|
| 426 |
+
run a copy of the Program. Ancillary propagation of a covered work
|
| 427 |
+
occurring solely as a consequence of using peer-to-peer transmission
|
| 428 |
+
to receive a copy likewise does not require acceptance. However,
|
| 429 |
+
nothing other than this License grants you permission to propagate or
|
| 430 |
+
modify any covered work. These actions infringe copyright if you do
|
| 431 |
+
not accept this License. Therefore, by modifying or propagating a
|
| 432 |
+
covered work, you indicate your acceptance of this License to do so.
|
| 433 |
+
|
| 434 |
+
10. Automatic Licensing of Downstream Recipients.
|
| 435 |
+
|
| 436 |
+
Each time you convey a covered work, the recipient automatically
|
| 437 |
+
receives a license from the original licensors, to run, modify and
|
| 438 |
+
propagate that work, subject to this License. You are not responsible
|
| 439 |
+
for enforcing compliance by third parties with this License.
|
| 440 |
+
|
| 441 |
+
An "entity transaction" is a transaction transferring control of an
|
| 442 |
+
organization, or substantially all assets of one, or subdividing an
|
| 443 |
+
organization, or merging organizations. If propagation of a covered
|
| 444 |
+
work results from an entity transaction, each party to that
|
| 445 |
+
transaction who receives a copy of the work also receives whatever
|
| 446 |
+
licenses to the work the party's predecessor in interest had or could
|
| 447 |
+
give under the previous paragraph, plus a right to possession of the
|
| 448 |
+
Corresponding Source of the work from the predecessor in interest, if
|
| 449 |
+
the predecessor has it or can get it with reasonable efforts.
|
| 450 |
+
|
| 451 |
+
You may not impose any further restrictions on the exercise of the
|
| 452 |
+
rights granted or affirmed under this License. For example, you may
|
| 453 |
+
not impose a license fee, royalty, or other charge for exercise of
|
| 454 |
+
rights granted under this License, and you may not initiate litigation
|
| 455 |
+
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
| 456 |
+
any patent claim is infringed by making, using, selling, offering for
|
| 457 |
+
sale, or importing the Program or any portion of it.
|
| 458 |
+
|
| 459 |
+
11. Patents.
|
| 460 |
+
|
| 461 |
+
A "contributor" is a copyright holder who authorizes use under this
|
| 462 |
+
License of the Program or a work on which the Program is based. The
|
| 463 |
+
work thus licensed is called the contributor's "contributor version".
|
| 464 |
+
|
| 465 |
+
A contributor's "essential patent claims" are all patent claims
|
| 466 |
+
owned or controlled by the contributor, whether already acquired or
|
| 467 |
+
hereafter acquired, that would be infringed by some manner, permitted
|
| 468 |
+
by this License, of making, using, or selling its contributor version,
|
| 469 |
+
but do not include claims that would be infringed only as a
|
| 470 |
+
consequence of further modification of the contributor version. For
|
| 471 |
+
purposes of this definition, "control" includes the right to grant
|
| 472 |
+
patent sublicenses in a manner consistent with the requirements of
|
| 473 |
+
this License.
|
| 474 |
+
|
| 475 |
+
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
| 476 |
+
patent license under the contributor's essential patent claims, to
|
| 477 |
+
make, use, sell, offer for sale, import and otherwise run, modify and
|
| 478 |
+
propagate the contents of its contributor version.
|
| 479 |
+
|
| 480 |
+
In the following three paragraphs, a "patent license" is any express
|
| 481 |
+
agreement or commitment, however denominated, not to enforce a patent
|
| 482 |
+
(such as an express permission to practice a patent or covenant not to
|
| 483 |
+
sue for patent infringement). To "grant" such a patent license to a
|
| 484 |
+
party means to make such an agreement or commitment not to enforce a
|
| 485 |
+
patent against the party.
|
| 486 |
+
|
| 487 |
+
If you convey a covered work, knowingly relying on a patent license,
|
| 488 |
+
and the Corresponding Source of the work is not available for anyone
|
| 489 |
+
to copy, free of charge and under the terms of this License, through a
|
| 490 |
+
publicly available network server or other readily accessible means,
|
| 491 |
+
then you must either (1) cause the Corresponding Source to be so
|
| 492 |
+
available, or (2) arrange to deprive yourself of the benefit of the
|
| 493 |
+
patent license for this particular work, or (3) arrange, in a manner
|
| 494 |
+
consistent with the requirements of this License, to extend the patent
|
| 495 |
+
license to downstream recipients. "Knowingly relying" means you have
|
| 496 |
+
actual knowledge that, but for the patent license, your conveying the
|
| 497 |
+
covered work in a country, or your recipient's use of the covered work
|
| 498 |
+
in a country, would infringe one or more identifiable patents in that
|
| 499 |
+
country that you have reason to believe are valid.
|
| 500 |
+
|
| 501 |
+
If, pursuant to or in connection with a single transaction or
|
| 502 |
+
arrangement, you convey, or propagate by procuring conveyance of, a
|
| 503 |
+
covered work, and grant a patent license to some of the parties
|
| 504 |
+
receiving the covered work authorizing them to use, propagate, modify
|
| 505 |
+
or convey a specific copy of the covered work, then the patent license
|
| 506 |
+
you grant is automatically extended to all recipients of the covered
|
| 507 |
+
work and works based on it.
|
| 508 |
+
|
| 509 |
+
A patent license is "discriminatory" if it does not include within
|
| 510 |
+
the scope of its coverage, prohibits the exercise of, or is
|
| 511 |
+
conditioned on the non-exercise of one or more of the rights that are
|
| 512 |
+
specifically granted under this License. You may not convey a covered
|
| 513 |
+
work if you are a party to an arrangement with a third party that is
|
| 514 |
+
in the business of distributing software, under which you make payment
|
| 515 |
+
to the third party based on the extent of your activity of conveying
|
| 516 |
+
the work, and under which the third party grants, to any of the
|
| 517 |
+
parties who would receive the covered work from you, a discriminatory
|
| 518 |
+
patent license (a) in connection with copies of the covered work
|
| 519 |
+
conveyed by you (or copies made from those copies), or (b) primarily
|
| 520 |
+
for and in connection with specific products or compilations that
|
| 521 |
+
contain the covered work, unless you entered into that arrangement,
|
| 522 |
+
or that patent license was granted, prior to 28 March 2007.
|
| 523 |
+
|
| 524 |
+
Nothing in this License shall be construed as excluding or limiting
|
| 525 |
+
any implied license or other defenses to infringement that may
|
| 526 |
+
otherwise be available to you under applicable patent law.
|
| 527 |
+
|
| 528 |
+
12. No Surrender of Others' Freedom.
|
| 529 |
+
|
| 530 |
+
If conditions are imposed on you (whether by court order, agreement or
|
| 531 |
+
otherwise) that contradict the conditions of this License, they do not
|
| 532 |
+
excuse you from the conditions of this License. If you cannot convey a
|
| 533 |
+
covered work so as to satisfy simultaneously your obligations under this
|
| 534 |
+
License and any other pertinent obligations, then as a consequence you may
|
| 535 |
+
not convey it at all. For example, if you agree to terms that obligate you
|
| 536 |
+
to collect a royalty for further conveying from those to whom you convey
|
| 537 |
+
the Program, the only way you could satisfy both those terms and this
|
| 538 |
+
License would be to refrain entirely from conveying the Program.
|
| 539 |
+
|
| 540 |
+
13. Remote Network Interaction; Use with the GNU General Public License.
|
| 541 |
+
|
| 542 |
+
Notwithstanding any other provision of this License, if you modify the
|
| 543 |
+
Program, your modified version must prominently offer all users
|
| 544 |
+
interacting with it remotely through a computer network (if your version
|
| 545 |
+
supports such interaction) an opportunity to receive the Corresponding
|
| 546 |
+
Source of your version by providing access to the Corresponding Source
|
| 547 |
+
from a network server at no charge, through some standard or customary
|
| 548 |
+
means of facilitating copying of software. This Corresponding Source
|
| 549 |
+
shall include the Corresponding Source for any work covered by version 3
|
| 550 |
+
of the GNU General Public License that is incorporated pursuant to the
|
| 551 |
+
following paragraph.
|
| 552 |
+
|
| 553 |
+
Notwithstanding any other provision of this License, you have
|
| 554 |
+
permission to link or combine any covered work with a work licensed
|
| 555 |
+
under version 3 of the GNU General Public License into a single
|
| 556 |
+
combined work, and to convey the resulting work. The terms of this
|
| 557 |
+
License will continue to apply to the part which is the covered work,
|
| 558 |
+
but the work with which it is combined will remain governed by version
|
| 559 |
+
3 of the GNU General Public License.
|
| 560 |
+
|
| 561 |
+
14. Revised Versions of this License.
|
| 562 |
+
|
| 563 |
+
The Free Software Foundation may publish revised and/or new versions of
|
| 564 |
+
the GNU Affero General Public License from time to time. Such new versions
|
| 565 |
+
will be similar in spirit to the present version, but may differ in detail to
|
| 566 |
+
address new problems or concerns.
|
| 567 |
+
|
| 568 |
+
Each version is given a distinguishing version number. If the
|
| 569 |
+
Program specifies that a certain numbered version of the GNU Affero General
|
| 570 |
+
Public License "or any later version" applies to it, you have the
|
| 571 |
+
option of following the terms and conditions either of that numbered
|
| 572 |
+
version or of any later version published by the Free Software
|
| 573 |
+
Foundation. If the Program does not specify a version number of the
|
| 574 |
+
GNU Affero General Public License, you may choose any version ever published
|
| 575 |
+
by the Free Software Foundation.
|
| 576 |
+
|
| 577 |
+
If the Program specifies that a proxy can decide which future
|
| 578 |
+
versions of the GNU Affero General Public License can be used, that proxy's
|
| 579 |
+
public statement of acceptance of a version permanently authorizes you
|
| 580 |
+
to choose that version for the Program.
|
| 581 |
+
|
| 582 |
+
Later license versions may give you additional or different
|
| 583 |
+
permissions. However, no additional obligations are imposed on any
|
| 584 |
+
author or copyright holder as a result of your choosing to follow a
|
| 585 |
+
later version.
|
| 586 |
+
|
| 587 |
+
15. Disclaimer of Warranty.
|
| 588 |
+
|
| 589 |
+
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
| 590 |
+
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
| 591 |
+
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
| 592 |
+
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
| 593 |
+
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
| 594 |
+
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
| 595 |
+
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
| 596 |
+
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
| 597 |
+
|
| 598 |
+
16. Limitation of Liability.
|
| 599 |
+
|
| 600 |
+
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
| 601 |
+
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
| 602 |
+
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
| 603 |
+
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
| 604 |
+
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
| 605 |
+
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
| 606 |
+
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
| 607 |
+
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
| 608 |
+
SUCH DAMAGES.
|
| 609 |
+
|
| 610 |
+
17. Interpretation of Sections 15 and 16.
|
| 611 |
+
|
| 612 |
+
If the disclaimer of warranty and limitation of liability provided
|
| 613 |
+
above cannot be given local legal effect according to their terms,
|
| 614 |
+
reviewing courts shall apply local law that most closely approximates
|
| 615 |
+
an absolute waiver of all civil liability in connection with the
|
| 616 |
+
Program, unless a warranty or assumption of liability accompanies a
|
| 617 |
+
copy of the Program in return for a fee.
|
| 618 |
+
|
| 619 |
+
END OF TERMS AND CONDITIONS
|
| 620 |
+
|
| 621 |
+
How to Apply These Terms to Your New Programs
|
| 622 |
+
|
| 623 |
+
If you develop a new program, and you want it to be of the greatest
|
| 624 |
+
possible use to the public, the best way to achieve this is to make it
|
| 625 |
+
free software which everyone can redistribute and change under these terms.
|
| 626 |
+
|
| 627 |
+
To do so, attach the following notices to the program. It is safest
|
| 628 |
+
to attach them to the start of each source file to most effectively
|
| 629 |
+
state the exclusion of warranty; and each file should have at least
|
| 630 |
+
the "copyright" line and a pointer to where the full notice is found.
|
| 631 |
+
|
| 632 |
+
<one line to give the program's name and a brief idea of what it does.>
|
| 633 |
+
Copyright (C) <year> <name of author>
|
| 634 |
+
|
| 635 |
+
This program is free software: you can redistribute it and/or modify
|
| 636 |
+
it under the terms of the GNU Affero General Public License as published by
|
| 637 |
+
the Free Software Foundation, either version 3 of the License, or
|
| 638 |
+
(at your option) any later version.
|
| 639 |
+
|
| 640 |
+
This program is distributed in the hope that it will be useful,
|
| 641 |
+
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
| 642 |
+
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
| 643 |
+
GNU Affero General Public License for more details.
|
| 644 |
+
|
| 645 |
+
You should have received a copy of the GNU Affero General Public License
|
| 646 |
+
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
| 647 |
+
|
| 648 |
+
Also add information on how to contact you by electronic and paper mail.
|
| 649 |
+
|
| 650 |
+
If your software can interact with users remotely through a computer
|
| 651 |
+
network, you should also make sure that it provides a way for users to
|
| 652 |
+
get its source. For example, if your program is a web application, its
|
| 653 |
+
interface could display a "Source" link that leads users to an archive
|
| 654 |
+
of the code. There are many ways you could offer source, and different
|
| 655 |
+
solutions will be better for different programs; see section 13 for the
|
| 656 |
+
specific requirements.
|
| 657 |
+
|
| 658 |
+
You should also get your employer (if you work as a programmer) or school,
|
| 659 |
+
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
| 660 |
+
For more information on this, and how to apply and follow the GNU AGPL, see
|
| 661 |
+
<https://www.gnu.org/licenses/>.
|
README.md
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: agpl-3.0
|
| 3 |
+
tags:
|
| 4 |
+
- snapkitty
|
| 5 |
+
- october-2026-drop
|
| 6 |
+
- kotlin
|
| 7 |
+
- android
|
| 8 |
+
- ollama
|
| 9 |
+
- agents
|
| 10 |
+
- server-admin
|
| 11 |
+
- developer-tools
|
| 12 |
+
---
|
| 13 |
+
|
| 14 |
+
> Mirrored from [https://github.com/SNAPKITTYWEST/kotlin-command-center](https://github.com/SNAPKITTYWEST/kotlin-command-center) at commit `6849123`. Part of the **SnapKitty October 2026 main drop**.
|
| 15 |
+
|
app/android/README.md
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# :android — status: source-complete, NOT compiled here
|
| 2 |
+
|
| 3 |
+
This module is the phone UI: a Compose chat screen (agent) and a server-admin
|
| 4 |
+
screen (SSH quick actions + custom commands), both driven by `:core` through
|
| 5 |
+
`CommandCenterViewModel`.
|
| 6 |
+
|
| 7 |
+
## Why it is not in the build
|
| 8 |
+
|
| 9 |
+
The build box has **no Android SDK** (no `ANDROID_HOME`, no platform
|
| 10 |
+
tooling), so `settings.gradle.kts` deliberately excludes `:android`.
|
| 11 |
+
Claiming it compiles here would be dishonest — it does not, and cannot,
|
| 12 |
+
until it runs under a real SDK.
|
| 13 |
+
|
| 14 |
+
## How to build it for real
|
| 15 |
+
|
| 16 |
+
1. Open `app/` in Android Studio (or set `ANDROID_HOME` on a machine with
|
| 17 |
+
the SDK + `platforms;android-34`).
|
| 18 |
+
2. Add `include(":android")` to `settings.gradle.kts`.
|
| 19 |
+
3. Add to `gradle.properties` (or `local.properties`):
|
| 20 |
+
`android.useAndroidX=true`
|
| 21 |
+
4. Sync and run — the module applies `com.android.application` and depends
|
| 22 |
+
on `:core` like `:desktop` does.
|
| 23 |
+
|
| 24 |
+
## Before shipping to a phone
|
| 25 |
+
|
| 26 |
+
- **Secrets**: `MainActivity` currently calls `CommandCenterConfig.fromEnv()`
|
| 27 |
+
as a placeholder. On device, store `APP_SECRET`, the Cloudflare service
|
| 28 |
+
token, and the SSH key in **EncryptedSharedPreferences** (or the
|
| 29 |
+
Keystore-backed equivalent) behind a settings screen — never in
|
| 30 |
+
`BuildConfig`, never in plain prefs.
|
| 31 |
+
- **SSH key**: generate on-device or import via the system file picker;
|
| 32 |
+
keep it out of app backups (`android:allowBackup="false"` for the key).
|
| 33 |
+
- **known_hosts**: ship a pinned entry for `ssh.yourdomain.com` (see the
|
| 34 |
+
`SshClient` docs) and refuse to connect without it.
|
app/android/build.gradle.kts
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
// SPDX-License-Identifier: AGPL-3.0-or-later
|
| 2 |
+
// Copyright (C) 2026 SnapKitty Collective
|
| 3 |
+
//
|
| 4 |
+
// Android module. Requires the Android SDK — NOT compiled on the build box
|
| 5 |
+
// (see android/README.md). On a machine with the SDK, add `include(":android")`
|
| 6 |
+
// to settings.gradle.kts and sync in Android Studio.
|
| 7 |
+
|
| 8 |
+
plugins {
|
| 9 |
+
id("com.android.application")
|
| 10 |
+
kotlin("android")
|
| 11 |
+
}
|
| 12 |
+
|
| 13 |
+
android {
|
| 14 |
+
namespace = "cc.android"
|
| 15 |
+
compileSdk = 34
|
| 16 |
+
|
| 17 |
+
defaultConfig {
|
| 18 |
+
applicationId = "cc.android.commandcenter"
|
| 19 |
+
minSdk = 26
|
| 20 |
+
targetSdk = 34
|
| 21 |
+
versionCode = 1
|
| 22 |
+
versionName = "1.0.0"
|
| 23 |
+
}
|
| 24 |
+
|
| 25 |
+
buildFeatures {
|
| 26 |
+
compose = true
|
| 27 |
+
}
|
| 28 |
+
composeOptions {
|
| 29 |
+
kotlinCompilerExtensionVersion = "1.5.14"
|
| 30 |
+
}
|
| 31 |
+
}
|
| 32 |
+
|
| 33 |
+
dependencies {
|
| 34 |
+
implementation(project(":core"))
|
| 35 |
+
val composeBom = platform("androidx.compose:compose-bom:2024.06.00")
|
| 36 |
+
implementation(composeBom)
|
| 37 |
+
androidTestImplementation(composeBom)
|
| 38 |
+
implementation("androidx.core:core-ktx:1.13.1")
|
| 39 |
+
implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.8.3")
|
| 40 |
+
implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.8.3")
|
| 41 |
+
implementation("androidx.lifecycle:lifecycle-runtime-compose:2.8.3")
|
| 42 |
+
implementation("androidx.activity:activity-compose:1.9.2")
|
| 43 |
+
implementation("androidx.compose.ui:ui")
|
| 44 |
+
implementation("androidx.compose.material3:material3")
|
| 45 |
+
}
|
app/android/src/main/AndroidManifest.xml
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
<?xml version="1.0" encoding="utf-8"?>
|
| 2 |
+
<!-- SPDX-License-Identifier: AGPL-3.0-or-later -->
|
| 3 |
+
<!-- Copyright (C) 2026 SnapKitty Collective -->
|
| 4 |
+
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
|
| 5 |
+
<!-- WebSocket + HTTPS to the Cloudflare edge only. -->
|
| 6 |
+
<uses-permission android:name="android.permission.INTERNET" />
|
| 7 |
+
|
| 8 |
+
<application
|
| 9 |
+
android:label="Command Center"
|
| 10 |
+
android:theme="@android:style/Theme.Material.NoActionBar">
|
| 11 |
+
<activity
|
| 12 |
+
android:name=".MainActivity"
|
| 13 |
+
android:exported="true">
|
| 14 |
+
<intent-filter>
|
| 15 |
+
<action android:name="android.intent.action.MAIN" />
|
| 16 |
+
<category android:name="android.intent.category.LAUNCHER" />
|
| 17 |
+
</intent-filter>
|
| 18 |
+
</activity>
|
| 19 |
+
</application>
|
| 20 |
+
</manifest>
|
app/android/src/main/kotlin/cc/android/CommandCenterViewModel.kt
ADDED
|
@@ -0,0 +1,102 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.android
|
| 6 |
+
|
| 7 |
+
import androidx.lifecycle.ViewModel
|
| 8 |
+
import androidx.lifecycle.viewModelScope
|
| 9 |
+
import cc.android.ui.UiChatMessage
|
| 10 |
+
import cc.core.AgentClient
|
| 11 |
+
import cc.core.ChatMessage
|
| 12 |
+
import cc.core.CommandCenterConfig
|
| 13 |
+
import cc.core.SshClient
|
| 14 |
+
import kotlinx.coroutines.Dispatchers
|
| 15 |
+
import kotlinx.coroutines.flow.MutableStateFlow
|
| 16 |
+
import kotlinx.coroutines.flow.StateFlow
|
| 17 |
+
import kotlinx.coroutines.flow.asStateFlow
|
| 18 |
+
import kotlinx.coroutines.flow.update
|
| 19 |
+
import kotlinx.coroutines.launch
|
| 20 |
+
import kotlinx.coroutines.withContext
|
| 21 |
+
|
| 22 |
+
data class CommandCenterUiState(
|
| 23 |
+
val gatewayOk: Boolean? = null,
|
| 24 |
+
val chat: List<UiChatMessage> = emptyList(),
|
| 25 |
+
val chatBusy: Boolean = false,
|
| 26 |
+
val sshOutput: String = "",
|
| 27 |
+
val sshBusy: Boolean = false,
|
| 28 |
+
val error: String? = null,
|
| 29 |
+
)
|
| 30 |
+
|
| 31 |
+
/**
|
| 32 |
+
* Owns the [AgentClient] (Ollama via Worker) and [SshClient] (SSH over
|
| 33 |
+
* WebSocket) and exposes them as Compose state. Secrets live in
|
| 34 |
+
* [CommandCenterConfig] — never in the UI state, never logged.
|
| 35 |
+
*/
|
| 36 |
+
class CommandCenterViewModel(
|
| 37 |
+
private val config: CommandCenterConfig,
|
| 38 |
+
private val model: String = "llama3",
|
| 39 |
+
) : ViewModel() {
|
| 40 |
+
|
| 41 |
+
private val agent = AgentClient(config)
|
| 42 |
+
private val ssh = SshClient(config)
|
| 43 |
+
|
| 44 |
+
private val _state = MutableStateFlow(CommandCenterUiState())
|
| 45 |
+
val state: StateFlow<CommandCenterUiState> = _state.asStateFlow()
|
| 46 |
+
|
| 47 |
+
fun checkHealth() {
|
| 48 |
+
viewModelScope.launch {
|
| 49 |
+
_state.update { it.copy(gatewayOk = agent.health(), error = null) }
|
| 50 |
+
}
|
| 51 |
+
}
|
| 52 |
+
|
| 53 |
+
fun sendChat(text: String) {
|
| 54 |
+
val trimmed = text.trim()
|
| 55 |
+
if (trimmed.isEmpty() || _state.value.chatBusy) return
|
| 56 |
+
viewModelScope.launch {
|
| 57 |
+
_state.update {
|
| 58 |
+
it.copy(
|
| 59 |
+
chat = it.chat + UiChatMessage("user", trimmed),
|
| 60 |
+
chatBusy = true,
|
| 61 |
+
error = null,
|
| 62 |
+
)
|
| 63 |
+
}
|
| 64 |
+
try {
|
| 65 |
+
val history = _state.value.chat.map { m -> ChatMessage(m.role, m.content) }
|
| 66 |
+
val resp = agent.chat(model, history)
|
| 67 |
+
_state.update {
|
| 68 |
+
it.copy(
|
| 69 |
+
chat = it.chat + UiChatMessage("assistant", resp.message.content),
|
| 70 |
+
chatBusy = false,
|
| 71 |
+
)
|
| 72 |
+
}
|
| 73 |
+
} catch (e: Exception) {
|
| 74 |
+
_state.update { it.copy(chatBusy = false, error = "agent: ${e.message}") }
|
| 75 |
+
}
|
| 76 |
+
}
|
| 77 |
+
}
|
| 78 |
+
|
| 79 |
+
/** Runs a remote command; SSH I/O stays off the main thread. */
|
| 80 |
+
fun runSshCommand(command: String) {
|
| 81 |
+
val trimmed = command.trim()
|
| 82 |
+
if (trimmed.isEmpty() || _state.value.sshBusy) return
|
| 83 |
+
viewModelScope.launch {
|
| 84 |
+
_state.update { it.copy(sshBusy = true, error = null, sshOutput = "") }
|
| 85 |
+
try {
|
| 86 |
+
val result = withContext(Dispatchers.IO) { ssh.exec(trimmed) }
|
| 87 |
+
val out = buildString {
|
| 88 |
+
append(result.stdout)
|
| 89 |
+
if (result.stderr.isNotBlank()) append("\n[stderr]\n").append(result.stderr)
|
| 90 |
+
append("\n[exit ${result.exitCode}]")
|
| 91 |
+
}
|
| 92 |
+
_state.update { it.copy(sshBusy = false, sshOutput = out) }
|
| 93 |
+
} catch (e: Exception) {
|
| 94 |
+
_state.update { it.copy(sshBusy = false, error = "ssh: ${e.message}") }
|
| 95 |
+
}
|
| 96 |
+
}
|
| 97 |
+
}
|
| 98 |
+
|
| 99 |
+
fun clearError() {
|
| 100 |
+
_state.update { it.copy(error = null) }
|
| 101 |
+
}
|
| 102 |
+
}
|
app/android/src/main/kotlin/cc/android/MainActivity.kt
ADDED
|
@@ -0,0 +1,78 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.android
|
| 6 |
+
|
| 7 |
+
import android.os.Bundle
|
| 8 |
+
import androidx.activity.ComponentActivity
|
| 9 |
+
import androidx.activity.compose.setContent
|
| 10 |
+
import androidx.compose.foundation.layout.Column
|
| 11 |
+
import androidx.compose.foundation.layout.fillMaxSize
|
| 12 |
+
import androidx.compose.foundation.layout.padding
|
| 13 |
+
import androidx.compose.material3.MaterialTheme
|
| 14 |
+
import androidx.compose.material3.Surface
|
| 15 |
+
import androidx.compose.material3.Tab
|
| 16 |
+
import androidx.compose.material3.TabRow
|
| 17 |
+
import androidx.compose.material3.Text
|
| 18 |
+
import androidx.compose.runtime.Composable
|
| 19 |
+
import androidx.compose.runtime.collectAsState
|
| 20 |
+
import androidx.compose.runtime.getValue
|
| 21 |
+
import androidx.compose.runtime.mutableIntStateOf
|
| 22 |
+
import androidx.compose.runtime.remember
|
| 23 |
+
import androidx.compose.runtime.setValue
|
| 24 |
+
import androidx.compose.ui.Modifier
|
| 25 |
+
import androidx.compose.ui.unit.dp
|
| 26 |
+
import androidx.lifecycle.viewmodel.compose.viewModel
|
| 27 |
+
import cc.android.ui.ChatScreen
|
| 28 |
+
import cc.android.ui.ServerAdminScreen
|
| 29 |
+
import cc.core.CommandCenterConfig
|
| 30 |
+
|
| 31 |
+
/**
|
| 32 |
+
* Entry point. In production the [CommandCenterConfig] comes from
|
| 33 |
+
* EncryptedSharedPreferences (see android/README.md); here it is passed in
|
| 34 |
+
* so previews and tests stay secret-free.
|
| 35 |
+
*/
|
| 36 |
+
class MainActivity : ComponentActivity() {
|
| 37 |
+
override fun onCreate(savedInstanceState: Bundle?) {
|
| 38 |
+
super.onCreate(savedInstanceState)
|
| 39 |
+
// TODO: load from EncryptedSharedPreferences via a settings screen.
|
| 40 |
+
val config = CommandCenterConfig.fromEnv()
|
| 41 |
+
setContent {
|
| 42 |
+
MaterialTheme {
|
| 43 |
+
Surface(modifier = Modifier.fillMaxSize()) {
|
| 44 |
+
CommandCenterApp(config)
|
| 45 |
+
}
|
| 46 |
+
}
|
| 47 |
+
}
|
| 48 |
+
}
|
| 49 |
+
}
|
| 50 |
+
|
| 51 |
+
@Composable
|
| 52 |
+
fun CommandCenterApp(config: CommandCenterConfig) {
|
| 53 |
+
val vm: CommandCenterViewModel = viewModel { CommandCenterViewModel(config) }
|
| 54 |
+
val state by vm.state.collectAsState()
|
| 55 |
+
var tab by remember { mutableIntStateOf(0) }
|
| 56 |
+
|
| 57 |
+
Column(modifier = Modifier.fillMaxSize().padding(8.dp)) {
|
| 58 |
+
TabRow(selectedTabIndex = tab) {
|
| 59 |
+
Tab(selected = tab == 0, onClick = { tab = 0 }, text = { Text("Agent") })
|
| 60 |
+
Tab(selected = tab == 1, onClick = { tab = 1 }, text = { Text("Server") })
|
| 61 |
+
}
|
| 62 |
+
when (tab) {
|
| 63 |
+
0 -> ChatScreen(
|
| 64 |
+
messages = state.chat,
|
| 65 |
+
busy = state.chatBusy,
|
| 66 |
+
onSend = vm::sendChat,
|
| 67 |
+
)
|
| 68 |
+
1 -> ServerAdminScreen(
|
| 69 |
+
output = state.sshOutput,
|
| 70 |
+
busy = state.sshBusy,
|
| 71 |
+
onRun = vm::runSshCommand,
|
| 72 |
+
)
|
| 73 |
+
}
|
| 74 |
+
state.error?.let { err ->
|
| 75 |
+
Text("Error: $err", color = MaterialTheme.colorScheme.error)
|
| 76 |
+
}
|
| 77 |
+
}
|
| 78 |
+
}
|
app/android/src/main/kotlin/cc/android/ui/ChatScreen.kt
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.android.ui
|
| 6 |
+
|
| 7 |
+
import androidx.compose.foundation.layout.Arrangement
|
| 8 |
+
import androidx.compose.foundation.layout.Column
|
| 9 |
+
import androidx.compose.foundation.layout.Row
|
| 10 |
+
import androidx.compose.foundation.layout.fillMaxSize
|
| 11 |
+
import androidx.compose.foundation.layout.fillMaxWidth
|
| 12 |
+
import androidx.compose.foundation.layout.padding
|
| 13 |
+
import androidx.compose.foundation.lazy.LazyColumn
|
| 14 |
+
import androidx.compose.foundation.lazy.items
|
| 15 |
+
import androidx.compose.material3.Button
|
| 16 |
+
import androidx.compose.material3.Card
|
| 17 |
+
import androidx.compose.material3.CircularProgressIndicator
|
| 18 |
+
import androidx.compose.material3.OutlinedTextField
|
| 19 |
+
import androidx.compose.material3.Text
|
| 20 |
+
import androidx.compose.runtime.Composable
|
| 21 |
+
import androidx.compose.runtime.getValue
|
| 22 |
+
import androidx.compose.runtime.mutableStateOf
|
| 23 |
+
import androidx.compose.runtime.remember
|
| 24 |
+
import androidx.compose.runtime.setValue
|
| 25 |
+
import androidx.compose.ui.Modifier
|
| 26 |
+
import androidx.compose.ui.unit.dp
|
| 27 |
+
|
| 28 |
+
data class UiChatMessage(val role: String, val content: String)
|
| 29 |
+
|
| 30 |
+
@Composable
|
| 31 |
+
fun ChatScreen(
|
| 32 |
+
messages: List<UiChatMessage>,
|
| 33 |
+
busy: Boolean,
|
| 34 |
+
onSend: (String) -> Unit,
|
| 35 |
+
) {
|
| 36 |
+
var draft by remember { mutableStateOf("") }
|
| 37 |
+
|
| 38 |
+
Column(modifier = Modifier.fillMaxSize().padding(8.dp)) {
|
| 39 |
+
LazyColumn(
|
| 40 |
+
modifier = Modifier.weight(1f).fillMaxWidth(),
|
| 41 |
+
verticalArrangement = Arrangement.spacedBy(6.dp),
|
| 42 |
+
) {
|
| 43 |
+
items(messages) { msg ->
|
| 44 |
+
Card(modifier = Modifier.fillMaxWidth()) {
|
| 45 |
+
Text(
|
| 46 |
+
text = "${msg.role}: ${msg.content}",
|
| 47 |
+
modifier = Modifier.padding(8.dp),
|
| 48 |
+
)
|
| 49 |
+
}
|
| 50 |
+
}
|
| 51 |
+
}
|
| 52 |
+
Row(
|
| 53 |
+
modifier = Modifier.fillMaxWidth().padding(top = 8.dp),
|
| 54 |
+
horizontalArrangement = Arrangement.spacedBy(8.dp),
|
| 55 |
+
) {
|
| 56 |
+
OutlinedTextField(
|
| 57 |
+
value = draft,
|
| 58 |
+
onValueChange = { draft = it },
|
| 59 |
+
modifier = Modifier.weight(1f),
|
| 60 |
+
placeholder = { Text("Ask the agent…") },
|
| 61 |
+
singleLine = true,
|
| 62 |
+
)
|
| 63 |
+
Button(
|
| 64 |
+
onClick = {
|
| 65 |
+
onSend(draft)
|
| 66 |
+
draft = ""
|
| 67 |
+
},
|
| 68 |
+
enabled = !busy && draft.isNotBlank(),
|
| 69 |
+
) {
|
| 70 |
+
Text("Send")
|
| 71 |
+
}
|
| 72 |
+
}
|
| 73 |
+
if (busy) CircularProgressIndicator(modifier = Modifier.padding(top = 8.dp))
|
| 74 |
+
}
|
| 75 |
+
}
|
app/android/src/main/kotlin/cc/android/ui/ServerAdminScreen.kt
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.android.ui
|
| 6 |
+
|
| 7 |
+
import androidx.compose.foundation.layout.Arrangement
|
| 8 |
+
import androidx.compose.foundation.layout.Column
|
| 9 |
+
import androidx.compose.foundation.layout.Row
|
| 10 |
+
import androidx.compose.foundation.layout.fillMaxSize
|
| 11 |
+
import androidx.compose.foundation.layout.fillMaxWidth
|
| 12 |
+
import androidx.compose.foundation.layout.padding
|
| 13 |
+
import androidx.compose.foundation.rememberScrollState
|
| 14 |
+
import androidx.compose.foundation.verticalScroll
|
| 15 |
+
import androidx.compose.material3.Button
|
| 16 |
+
import androidx.compose.material3.CircularProgressIndicator
|
| 17 |
+
import androidx.compose.material3.OutlinedTextField
|
| 18 |
+
import androidx.compose.material3.Text
|
| 19 |
+
import androidx.compose.runtime.Composable
|
| 20 |
+
import androidx.compose.runtime.getValue
|
| 21 |
+
import androidx.compose.runtime.mutableStateOf
|
| 22 |
+
import androidx.compose.runtime.remember
|
| 23 |
+
import androidx.compose.runtime.setValue
|
| 24 |
+
import androidx.compose.ui.Modifier
|
| 25 |
+
import androidx.compose.ui.text.font.FontFamily
|
| 26 |
+
import androidx.compose.ui.unit.dp
|
| 27 |
+
|
| 28 |
+
/** One-tap admin actions — the dangerous ones ask for the custom command. */
|
| 29 |
+
private val QUICK_COMMANDS = listOf(
|
| 30 |
+
"System status" to "systemctl --no-pager --failed; uptime",
|
| 31 |
+
"Ollama status" to "systemctl --no-pager status ollama",
|
| 32 |
+
"Disk + memory" to "df -h / && free -h",
|
| 33 |
+
)
|
| 34 |
+
|
| 35 |
+
@Composable
|
| 36 |
+
fun ServerAdminScreen(
|
| 37 |
+
output: String,
|
| 38 |
+
busy: Boolean,
|
| 39 |
+
onRun: (String) -> Unit,
|
| 40 |
+
) {
|
| 41 |
+
var custom by remember { mutableStateOf("") }
|
| 42 |
+
val scroll = rememberScrollState()
|
| 43 |
+
|
| 44 |
+
Column(modifier = Modifier.fillMaxSize().padding(8.dp)) {
|
| 45 |
+
Text("Quick actions", modifier = Modifier.padding(bottom = 4.dp))
|
| 46 |
+
QUICK_COMMANDS.forEach { (label, cmd) ->
|
| 47 |
+
Button(
|
| 48 |
+
onClick = { onRun(cmd) },
|
| 49 |
+
enabled = !busy,
|
| 50 |
+
modifier = Modifier.fillMaxWidth().padding(bottom = 4.dp),
|
| 51 |
+
) {
|
| 52 |
+
Text(label)
|
| 53 |
+
}
|
| 54 |
+
}
|
| 55 |
+
Row(
|
| 56 |
+
modifier = Modifier.fillMaxWidth().padding(top = 4.dp),
|
| 57 |
+
horizontalArrangement = Arrangement.spacedBy(8.dp),
|
| 58 |
+
) {
|
| 59 |
+
OutlinedTextField(
|
| 60 |
+
value = custom,
|
| 61 |
+
onValueChange = { custom = it },
|
| 62 |
+
modifier = Modifier.weight(1f),
|
| 63 |
+
placeholder = { Text("custom command…") },
|
| 64 |
+
singleLine = true,
|
| 65 |
+
)
|
| 66 |
+
Button(
|
| 67 |
+
onClick = { onRun(custom) },
|
| 68 |
+
enabled = !busy && custom.isNotBlank(),
|
| 69 |
+
) {
|
| 70 |
+
Text("Run")
|
| 71 |
+
}
|
| 72 |
+
}
|
| 73 |
+
if (busy) CircularProgressIndicator(modifier = Modifier.padding(top = 8.dp))
|
| 74 |
+
Text(
|
| 75 |
+
text = output.ifBlank { "no output yet" },
|
| 76 |
+
fontFamily = FontFamily.Monospace,
|
| 77 |
+
modifier = Modifier
|
| 78 |
+
.fillMaxWidth()
|
| 79 |
+
.weight(1f)
|
| 80 |
+
.verticalScroll(scroll)
|
| 81 |
+
.padding(top = 8.dp),
|
| 82 |
+
)
|
| 83 |
+
}
|
| 84 |
+
}
|
app/build.gradle.kts
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
// SPDX-License-Identifier: AGPL-3.0-or-later
|
| 2 |
+
// Copyright (C) 2026 SnapKitty Collective
|
| 3 |
+
|
| 4 |
+
plugins {
|
| 5 |
+
kotlin("jvm") version "2.0.21" apply false
|
| 6 |
+
kotlin("plugin.serialization") version "2.0.21" apply false
|
| 7 |
+
application apply false
|
| 8 |
+
}
|
| 9 |
+
|
| 10 |
+
// Shared dependency versions for all modules.
|
| 11 |
+
ext["ktorVersion"] = "2.3.12"
|
| 12 |
+
ext["coroutinesVersion"] = "1.8.1"
|
| 13 |
+
ext["serializationVersion"] = "1.7.3"
|
| 14 |
+
ext["jschVersion"] = "0.2.21"
|
| 15 |
+
ext["junitVersion"] = "5.10.3"
|
app/core/build.gradle.kts
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
// SPDX-License-Identifier: AGPL-3.0-or-later
|
| 2 |
+
// Copyright (C) 2026 SnapKitty Collective
|
| 3 |
+
|
| 4 |
+
plugins {
|
| 5 |
+
kotlin("jvm")
|
| 6 |
+
kotlin("plugin.serialization")
|
| 7 |
+
}
|
| 8 |
+
|
| 9 |
+
val ktorVersion: String by rootProject.extra
|
| 10 |
+
val coroutinesVersion: String by rootProject.extra
|
| 11 |
+
val serializationVersion: String by rootProject.extra
|
| 12 |
+
val jschVersion: String by rootProject.extra
|
| 13 |
+
val junitVersion: String by rootProject.extra
|
| 14 |
+
|
| 15 |
+
dependencies {
|
| 16 |
+
// HTTP client (Worker gateway) + WebSocket client (SSH bridge)
|
| 17 |
+
implementation("io.ktor:ktor-client-core:$ktorVersion")
|
| 18 |
+
implementation("io.ktor:ktor-client-cio:$ktorVersion")
|
| 19 |
+
implementation("io.ktor:ktor-client-content-negotiation:$ktorVersion")
|
| 20 |
+
implementation("io.ktor:ktor-client-websockets:$ktorVersion")
|
| 21 |
+
implementation("io.ktor:ktor-serialization-kotlinx-json:$ktorVersion")
|
| 22 |
+
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutinesVersion")
|
| 23 |
+
implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:$serializationVersion")
|
| 24 |
+
// SSH — maintained fork of JSch
|
| 25 |
+
implementation("com.github.mwiede:jsch:$jschVersion")
|
| 26 |
+
|
| 27 |
+
// Test-only: MockEngine stands in for the Worker gateway and a fake
|
| 28 |
+
// ClientWebSocketSession stands in for the SSH tunnel, so the suite
|
| 29 |
+
// needs no live TCP sockets (this sandbox blocks JVM loopback).
|
| 30 |
+
testImplementation("io.ktor:ktor-client-mock:$ktorVersion")
|
| 31 |
+
testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
|
| 32 |
+
testImplementation("org.junit.jupiter:junit-jupiter:$junitVersion")
|
| 33 |
+
testRuntimeOnly("org.junit.platform:junit-platform-launcher")
|
| 34 |
+
}
|
| 35 |
+
|
| 36 |
+
tasks.withType<Test> {
|
| 37 |
+
useJUnitPlatform()
|
| 38 |
+
}
|
app/core/src/main/kotlin/cc/core/AgentClient.kt
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.core
|
| 6 |
+
|
| 7 |
+
import io.ktor.client.HttpClient
|
| 8 |
+
import io.ktor.client.call.body
|
| 9 |
+
import io.ktor.client.engine.cio.CIO
|
| 10 |
+
import io.ktor.client.plugins.contentnegotiation.ContentNegotiation
|
| 11 |
+
import io.ktor.client.plugins.websocket.WebSockets
|
| 12 |
+
import io.ktor.client.request.get
|
| 13 |
+
import io.ktor.client.request.header
|
| 14 |
+
import io.ktor.client.request.post
|
| 15 |
+
import io.ktor.client.request.setBody
|
| 16 |
+
import io.ktor.http.ContentType
|
| 17 |
+
import io.ktor.http.HttpHeaders
|
| 18 |
+
import io.ktor.http.contentType
|
| 19 |
+
import io.ktor.http.isSuccess
|
| 20 |
+
import io.ktor.serialization.kotlinx.json.json
|
| 21 |
+
import kotlinx.serialization.json.Json
|
| 22 |
+
|
| 23 |
+
/** Shared Ktor client: JSON content negotiation + WebSocket support. */
|
| 24 |
+
fun defaultHttpClient(): HttpClient = HttpClient(CIO) {
|
| 25 |
+
install(ContentNegotiation) {
|
| 26 |
+
json(Json { ignoreUnknownKeys = true })
|
| 27 |
+
}
|
| 28 |
+
install(WebSockets)
|
| 29 |
+
}
|
| 30 |
+
|
| 31 |
+
/**
|
| 32 |
+
* Talks to Ollama through the Cloudflare Worker gateway.
|
| 33 |
+
*
|
| 34 |
+
* Every API call carries `Authorization: Bearer <APP_SECRET>`; the Worker
|
| 35 |
+
* verifies it before forwarding to the tunnel. `/health` is the only
|
| 36 |
+
* unauthenticated route (used by uptime checks).
|
| 37 |
+
*/
|
| 38 |
+
class AgentClient(
|
| 39 |
+
private val config: CommandCenterConfig,
|
| 40 |
+
private val http: HttpClient = defaultHttpClient(),
|
| 41 |
+
) {
|
| 42 |
+
/** Unauthenticated liveness probe of the Worker gateway. */
|
| 43 |
+
suspend fun health(): Boolean = try {
|
| 44 |
+
val resp: HealthResponse = http.get("${config.workerUrl}/health").body()
|
| 45 |
+
resp.ok
|
| 46 |
+
} catch (_: Exception) {
|
| 47 |
+
false
|
| 48 |
+
}
|
| 49 |
+
|
| 50 |
+
/** Single completion via Ollama /api/generate (non-streaming). */
|
| 51 |
+
suspend fun prompt(model: String, prompt: String): GenerateResponse {
|
| 52 |
+
val resp = http.post("${config.workerUrl}/api/generate") {
|
| 53 |
+
header(HttpHeaders.Authorization, "Bearer ${config.appSecret}")
|
| 54 |
+
contentType(ContentType.Application.Json)
|
| 55 |
+
setBody(GenerateRequest(model, prompt, stream = false))
|
| 56 |
+
}
|
| 57 |
+
check(resp.status.isSuccess()) { "gateway returned ${resp.status}" }
|
| 58 |
+
return resp.body()
|
| 59 |
+
}
|
| 60 |
+
|
| 61 |
+
/** Multi-turn chat via Ollama /api/chat (non-streaming). */
|
| 62 |
+
suspend fun chat(model: String, messages: List<ChatMessage>): ChatResponse {
|
| 63 |
+
val resp = http.post("${config.workerUrl}/api/chat") {
|
| 64 |
+
header(HttpHeaders.Authorization, "Bearer ${config.appSecret}")
|
| 65 |
+
contentType(ContentType.Application.Json)
|
| 66 |
+
setBody(ChatRequest(model, messages, stream = false))
|
| 67 |
+
}
|
| 68 |
+
check(resp.status.isSuccess()) { "gateway returned ${resp.status}" }
|
| 69 |
+
return resp.body()
|
| 70 |
+
}
|
| 71 |
+
}
|
app/core/src/main/kotlin/cc/core/Config.kt
ADDED
|
@@ -0,0 +1,53 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.core
|
| 6 |
+
|
| 7 |
+
/**
|
| 8 |
+
* All secrets and endpoints for the command center.
|
| 9 |
+
*
|
| 10 |
+
* Secrets come from the environment (or an env map you supply, e.g. loaded
|
| 11 |
+
* from a `local.properties`-style file on Android). They are NEVER hardcoded
|
| 12 |
+
* and NEVER logged.
|
| 13 |
+
*/
|
| 14 |
+
data class CommandCenterConfig(
|
| 15 |
+
/** Public Worker gateway URL, e.g. https://api.yourdomain.com */
|
| 16 |
+
val workerUrl: String,
|
| 17 |
+
/** Shared secret the phone presents to the Worker (Bearer token). */
|
| 18 |
+
val appSecret: String,
|
| 19 |
+
/** SSH-over-WebSocket endpoint, e.g. wss://ssh.yourdomain.com */
|
| 20 |
+
val sshWsUrl: String,
|
| 21 |
+
/** Cloudflare Access service token, used on the SSH WS handshake. */
|
| 22 |
+
val cfClientId: String,
|
| 23 |
+
val cfClientSecret: String,
|
| 24 |
+
/** SSH login details for the server behind the tunnel. */
|
| 25 |
+
val sshUser: String,
|
| 26 |
+
val sshHost: String,
|
| 27 |
+
val sshPort: Int = 22,
|
| 28 |
+
/** Path to the SSH private key (OpenSSH format). */
|
| 29 |
+
val sshKeyPath: String,
|
| 30 |
+
/** Path to known_hosts. Host keys are PINNED — see SshClient. */
|
| 31 |
+
val knownHostsPath: String,
|
| 32 |
+
) {
|
| 33 |
+
companion object {
|
| 34 |
+
fun fromEnv(env: Map<String, String> = System.getenv()): CommandCenterConfig {
|
| 35 |
+
fun req(name: String): String =
|
| 36 |
+
env[name]?.takeIf { it.isNotBlank() }
|
| 37 |
+
?: throw IllegalStateException("missing required config: $name")
|
| 38 |
+
|
| 39 |
+
return CommandCenterConfig(
|
| 40 |
+
workerUrl = req("CC_WORKER_URL").trimEnd('/'),
|
| 41 |
+
appSecret = req("CC_APP_SECRET"),
|
| 42 |
+
sshWsUrl = req("CC_SSH_WS_URL"),
|
| 43 |
+
cfClientId = req("CC_CF_CLIENT_ID"),
|
| 44 |
+
cfClientSecret = req("CC_CF_CLIENT_SECRET"),
|
| 45 |
+
sshUser = req("CC_SSH_USER"),
|
| 46 |
+
sshHost = req("CC_SSH_HOST"),
|
| 47 |
+
sshPort = env["CC_SSH_PORT"]?.toIntOrNull() ?: 22,
|
| 48 |
+
sshKeyPath = req("CC_SSH_KEY"),
|
| 49 |
+
knownHostsPath = req("CC_KNOWN_HOSTS"),
|
| 50 |
+
)
|
| 51 |
+
}
|
| 52 |
+
}
|
| 53 |
+
}
|
app/core/src/main/kotlin/cc/core/Models.kt
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.core
|
| 6 |
+
|
| 7 |
+
import kotlinx.serialization.Serializable
|
| 8 |
+
|
| 9 |
+
// --- Ollama /api/generate ----------------------------------------------------
|
| 10 |
+
|
| 11 |
+
@Serializable
|
| 12 |
+
data class GenerateRequest(
|
| 13 |
+
val model: String,
|
| 14 |
+
val prompt: String,
|
| 15 |
+
val stream: Boolean = false,
|
| 16 |
+
)
|
| 17 |
+
|
| 18 |
+
@Serializable
|
| 19 |
+
data class GenerateResponse(
|
| 20 |
+
val model: String = "",
|
| 21 |
+
val response: String = "",
|
| 22 |
+
val done: Boolean = false,
|
| 23 |
+
)
|
| 24 |
+
|
| 25 |
+
// --- Ollama /api/chat --------------------------------------------------------
|
| 26 |
+
|
| 27 |
+
@Serializable
|
| 28 |
+
data class ChatMessage(
|
| 29 |
+
val role: String, // "system" | "user" | "assistant"
|
| 30 |
+
val content: String,
|
| 31 |
+
)
|
| 32 |
+
|
| 33 |
+
@Serializable
|
| 34 |
+
data class ChatRequest(
|
| 35 |
+
val model: String,
|
| 36 |
+
val messages: List<ChatMessage>,
|
| 37 |
+
val stream: Boolean = false,
|
| 38 |
+
)
|
| 39 |
+
|
| 40 |
+
@Serializable
|
| 41 |
+
data class ChatResponse(
|
| 42 |
+
val model: String = "",
|
| 43 |
+
val message: ChatMessage = ChatMessage("assistant", ""),
|
| 44 |
+
val done: Boolean = false,
|
| 45 |
+
)
|
| 46 |
+
|
| 47 |
+
// --- Worker /health ----------------------------------------------------------
|
| 48 |
+
|
| 49 |
+
@Serializable
|
| 50 |
+
data class HealthResponse(val ok: Boolean = false)
|
| 51 |
+
|
| 52 |
+
// --- SSH exec result ---------------------------------------------------------
|
| 53 |
+
|
| 54 |
+
data class SshResult(
|
| 55 |
+
val exitCode: Int,
|
| 56 |
+
val stdout: String,
|
| 57 |
+
val stderr: String,
|
| 58 |
+
)
|
app/core/src/main/kotlin/cc/core/SshClient.kt
ADDED
|
@@ -0,0 +1,86 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.core
|
| 6 |
+
|
| 7 |
+
import com.jcraft.jsch.ChannelExec
|
| 8 |
+
import com.jcraft.jsch.JSch
|
| 9 |
+
import com.jcraft.jsch.SocketFactory
|
| 10 |
+
import java.io.ByteArrayOutputStream
|
| 11 |
+
|
| 12 |
+
/**
|
| 13 |
+
* Runs commands on the server behind the Cloudflare Tunnel, over
|
| 14 |
+
* SSH carried inside a WebSocket (see [WebSocketSocketFactory]).
|
| 15 |
+
*
|
| 16 |
+
* ## Host-key verification (read this)
|
| 17 |
+
*
|
| 18 |
+
* The sketch this was built from used `StrictHostKeyChecking=no`, which
|
| 19 |
+
* silently accepts ANY server key — a textbook man-in-the-middle hole, made
|
| 20 |
+
* worse here because the connection traverses a third-party edge.
|
| 21 |
+
*
|
| 22 |
+
* This client instead requires a `known_hosts` file and sets
|
| 23 |
+
* `StrictHostKeyChecking=yes`:
|
| 24 |
+
* - server key in known_hosts and matching → connect
|
| 25 |
+
* - anything else → [com.jcraft.jsch.JSchException], fail closed
|
| 26 |
+
*
|
| 27 |
+
* Generate the entry once, over a trusted path:
|
| 28 |
+
* `ssh-keyscan -t rsa ssh.yourdomain.com >> ~/.ssh/command_center_known_hosts`
|
| 29 |
+
* (verify the fingerprint out-of-band before trusting it).
|
| 30 |
+
*/
|
| 31 |
+
class SshClient(
|
| 32 |
+
private val config: CommandCenterConfig,
|
| 33 |
+
private val socketFactory: SocketFactory = WebSocketSocketFactory(
|
| 34 |
+
webSocketUrl = config.sshWsUrl,
|
| 35 |
+
handshakeHeaders = mapOf(
|
| 36 |
+
"CF-Access-Client-Id" to config.cfClientId,
|
| 37 |
+
"CF-Access-Client-Secret" to config.cfClientSecret,
|
| 38 |
+
),
|
| 39 |
+
ownsClient = true,
|
| 40 |
+
),
|
| 41 |
+
) {
|
| 42 |
+
/**
|
| 43 |
+
* Executes [command] on the remote host and captures its output.
|
| 44 |
+
* Throws on connect/auth/host-key failure or when the command
|
| 45 |
+
* does not finish within [timeoutMs].
|
| 46 |
+
*/
|
| 47 |
+
fun exec(command: String, timeoutMs: Long = 30_000): SshResult {
|
| 48 |
+
val jsch = JSch()
|
| 49 |
+
// Throws if the file is missing or malformed — fail closed.
|
| 50 |
+
jsch.setKnownHosts(config.knownHostsPath)
|
| 51 |
+
jsch.addIdentity(config.sshKeyPath)
|
| 52 |
+
|
| 53 |
+
val session = jsch.getSession(config.sshUser, config.sshHost, config.sshPort)
|
| 54 |
+
// "yes": unknown/changed host key aborts instead of prompting.
|
| 55 |
+
// Never "no", never "ask" (no UI to answer the prompt on a phone).
|
| 56 |
+
session.setConfig("StrictHostKeyChecking", "yes")
|
| 57 |
+
session.setSocketFactory(socketFactory)
|
| 58 |
+
try {
|
| 59 |
+
session.connect(timeoutMs.toInt())
|
| 60 |
+
|
| 61 |
+
val channel = session.openChannel("exec") as ChannelExec
|
| 62 |
+
val stdout = ByteArrayOutputStream()
|
| 63 |
+
val stderr = ByteArrayOutputStream()
|
| 64 |
+
channel.outputStream = stdout
|
| 65 |
+
channel.setErrStream(stderr)
|
| 66 |
+
channel.setCommand(command)
|
| 67 |
+
channel.connect(timeoutMs.toInt())
|
| 68 |
+
try {
|
| 69 |
+
val deadline = System.currentTimeMillis() + timeoutMs
|
| 70 |
+
while (!channel.isClosed && System.currentTimeMillis() < deadline) {
|
| 71 |
+
Thread.sleep(50)
|
| 72 |
+
}
|
| 73 |
+
check(channel.isClosed) { "remote command did not finish within ${timeoutMs}ms" }
|
| 74 |
+
return SshResult(
|
| 75 |
+
exitCode = channel.exitStatus,
|
| 76 |
+
stdout = stdout.toString(Charsets.UTF_8),
|
| 77 |
+
stderr = stderr.toString(Charsets.UTF_8),
|
| 78 |
+
)
|
| 79 |
+
} finally {
|
| 80 |
+
channel.disconnect()
|
| 81 |
+
}
|
| 82 |
+
} finally {
|
| 83 |
+
session.disconnect()
|
| 84 |
+
}
|
| 85 |
+
}
|
| 86 |
+
}
|
app/core/src/main/kotlin/cc/core/WebSocketBridge.kt
ADDED
|
@@ -0,0 +1,192 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.core
|
| 6 |
+
|
| 7 |
+
import com.jcraft.jsch.SocketFactory
|
| 8 |
+
import io.ktor.client.HttpClient
|
| 9 |
+
import io.ktor.client.plugins.websocket.ClientWebSocketSession
|
| 10 |
+
import io.ktor.client.plugins.websocket.webSocketSession
|
| 11 |
+
import io.ktor.client.request.header
|
| 12 |
+
import io.ktor.websocket.Frame
|
| 13 |
+
import io.ktor.websocket.close
|
| 14 |
+
import io.ktor.websocket.readBytes
|
| 15 |
+
import io.ktor.websocket.readText
|
| 16 |
+
import io.ktor.websocket.send
|
| 17 |
+
import java.io.InputStream
|
| 18 |
+
import java.io.OutputStream
|
| 19 |
+
import java.io.PipedInputStream
|
| 20 |
+
import java.io.PipedOutputStream
|
| 21 |
+
import java.net.Socket
|
| 22 |
+
import kotlinx.coroutines.CoroutineScope
|
| 23 |
+
import kotlinx.coroutines.Dispatchers
|
| 24 |
+
import kotlinx.coroutines.SupervisorJob
|
| 25 |
+
import kotlinx.coroutines.cancel
|
| 26 |
+
import kotlinx.coroutines.isActive
|
| 27 |
+
import kotlinx.coroutines.launch
|
| 28 |
+
import kotlinx.coroutines.runBlocking
|
| 29 |
+
|
| 30 |
+
/**
|
| 31 |
+
* A [SocketFactory] for JSch that tunnels SSH over a WebSocket.
|
| 32 |
+
*
|
| 33 |
+
* Cloudflare Access can route `ssh://` origins, but Android cannot easily run
|
| 34 |
+
* the `cloudflared` binary — so the app opens `wss://ssh.yourdomain.com`
|
| 35 |
+
* itself (with the Access service-token headers on the WS handshake) and
|
| 36 |
+
* hands JSch a [Socket] whose byte streams are bridged to WebSocket frames:
|
| 37 |
+
*
|
| 38 |
+
* JSch --bytes--> pipe --> WS binary frames --> cloudflared --> sshd
|
| 39 |
+
* JSch <--bytes-- pipe <-- WS binary frames <-- cloudflared <-- sshd
|
| 40 |
+
*
|
| 41 |
+
* WebSocket is message-oriented and SSH is stream-oriented; the bridge
|
| 42 |
+
* concatenates incoming binary frames into one continuous stream and emits
|
| 43 |
+
* one binary frame per writer flush batch. Ordering is preserved.
|
| 44 |
+
*
|
| 45 |
+
* JSch assumes a TCP socket (it calls `setTcpNoDelay` and `setSoTimeout` in
|
| 46 |
+
* `Session.connect`), so [WebSocketBackedSocket] overrides those as safe
|
| 47 |
+
* no-ops / stored values instead of throwing "Socket is not connected".
|
| 48 |
+
*
|
| 49 |
+
* @param sessionOpener how the WebSocket session is established; the default
|
| 50 |
+
* opens a real Ktor `webSocketSession` with [handshakeHeaders]. Tests inject
|
| 51 |
+
* a fake to avoid needing a live server.
|
| 52 |
+
*/
|
| 53 |
+
class WebSocketSocketFactory(
|
| 54 |
+
private val webSocketUrl: String,
|
| 55 |
+
private val handshakeHeaders: Map<String, String> = emptyMap(),
|
| 56 |
+
private val httpClient: HttpClient = defaultHttpClient(),
|
| 57 |
+
/** If true, [shutdown] also closes [httpClient]. */
|
| 58 |
+
private val ownsClient: Boolean = false,
|
| 59 |
+
private val sessionOpener: suspend (client: HttpClient, url: String, headers: Map<String, String>) -> ClientWebSocketSession =
|
| 60 |
+
{ client, url, headers ->
|
| 61 |
+
client.webSocketSession(url) {
|
| 62 |
+
headers.forEach { (name, value) -> header(name, value) }
|
| 63 |
+
}
|
| 64 |
+
},
|
| 65 |
+
) : SocketFactory {
|
| 66 |
+
|
| 67 |
+
private val scope = CoroutineScope(SupervisorJob() + Dispatchers.IO)
|
| 68 |
+
|
| 69 |
+
/**
|
| 70 |
+
* Opens the WebSocket (blocking — JSch calls this from its connecting
|
| 71 |
+
* thread, which is already blocking) and returns the bridged socket.
|
| 72 |
+
*/
|
| 73 |
+
override fun createSocket(host: String, port: Int): Socket {
|
| 74 |
+
val session = runBlocking {
|
| 75 |
+
sessionOpener(httpClient, webSocketUrl, handshakeHeaders)
|
| 76 |
+
}
|
| 77 |
+
return WebSocketBackedSocket(session, scope)
|
| 78 |
+
}
|
| 79 |
+
|
| 80 |
+
override fun getInputStream(socket: Socket): InputStream =
|
| 81 |
+
(socket as WebSocketBackedSocket).bridgedInput
|
| 82 |
+
|
| 83 |
+
override fun getOutputStream(socket: Socket): OutputStream =
|
| 84 |
+
(socket as WebSocketBackedSocket).bridgedOutput
|
| 85 |
+
|
| 86 |
+
/** Releases the factory's coroutines (and the HTTP client if owned). */
|
| 87 |
+
fun shutdown() {
|
| 88 |
+
scope.cancel("WebSocketSocketFactory.shutdown")
|
| 89 |
+
if (ownsClient) httpClient.close()
|
| 90 |
+
}
|
| 91 |
+
}
|
| 92 |
+
|
| 93 |
+
/**
|
| 94 |
+
* A [Socket] whose streams are piped to/from a WebSocket session.
|
| 95 |
+
*
|
| 96 |
+
* Not a real TCP socket — it only exists so JSch has something to call
|
| 97 |
+
* `getInputStream()`/`getOutputStream()`/`setTcpNoDelay()` on.
|
| 98 |
+
*/
|
| 99 |
+
class WebSocketBackedSocket internal constructor(
|
| 100 |
+
private val session: ClientWebSocketSession,
|
| 101 |
+
scope: CoroutineScope,
|
| 102 |
+
) : Socket() {
|
| 103 |
+
|
| 104 |
+
companion object {
|
| 105 |
+
/** Pipe buffer; large enough that SSH window traffic rarely blocks. */
|
| 106 |
+
const val PIPE_SIZE = 65536
|
| 107 |
+
}
|
| 108 |
+
|
| 109 |
+
// Inbound: WS reader coroutine -> JSch.
|
| 110 |
+
private val inboundSink = PipedOutputStream()
|
| 111 |
+
val bridgedInput: InputStream = PipedInputStream(inboundSink, PIPE_SIZE)
|
| 112 |
+
|
| 113 |
+
// Outbound: JSch -> WS writer coroutine.
|
| 114 |
+
private val outboundSource = PipedInputStream(PIPE_SIZE)
|
| 115 |
+
val bridgedOutput: OutputStream = PipedOutputStream(outboundSource)
|
| 116 |
+
|
| 117 |
+
@Volatile private var closed = false
|
| 118 |
+
private var storedSoTimeout: Int = 0
|
| 119 |
+
|
| 120 |
+
private val readerJob = scope.launch {
|
| 121 |
+
try {
|
| 122 |
+
for (frame in session.incoming) {
|
| 123 |
+
if (!isActive) break
|
| 124 |
+
val bytes = when (frame) {
|
| 125 |
+
is Frame.Binary -> frame.readBytes()
|
| 126 |
+
is Frame.Text -> frame.readText().toByteArray(Charsets.UTF_8)
|
| 127 |
+
else -> null
|
| 128 |
+
}
|
| 129 |
+
if (bytes != null && bytes.isNotEmpty()) {
|
| 130 |
+
inboundSink.write(bytes)
|
| 131 |
+
inboundSink.flush()
|
| 132 |
+
}
|
| 133 |
+
if (frame is Frame.Close) break
|
| 134 |
+
}
|
| 135 |
+
} catch (_: Exception) {
|
| 136 |
+
// WebSocket dropped: fall through and signal EOF to JSch.
|
| 137 |
+
} finally {
|
| 138 |
+
runCatching { inboundSink.close() }
|
| 139 |
+
}
|
| 140 |
+
}
|
| 141 |
+
|
| 142 |
+
private val writerJob = scope.launch {
|
| 143 |
+
val buf = ByteArray(32768)
|
| 144 |
+
try {
|
| 145 |
+
while (isActive) {
|
| 146 |
+
// Blocking read on Dispatchers.IO; returns -1 once JSch's
|
| 147 |
+
// write end is closed during socket teardown.
|
| 148 |
+
val n = outboundSource.read(buf)
|
| 149 |
+
if (n < 0) break
|
| 150 |
+
if (n > 0) session.send(buf.copyOf(n))
|
| 151 |
+
}
|
| 152 |
+
} catch (_: Exception) {
|
| 153 |
+
// JSch went away mid-write.
|
| 154 |
+
} finally {
|
| 155 |
+
runCatching { session.close() }
|
| 156 |
+
}
|
| 157 |
+
}
|
| 158 |
+
|
| 159 |
+
// -- Socket overrides: JSch's TCP assumptions, made safe -------------
|
| 160 |
+
|
| 161 |
+
override fun getInputStream(): InputStream = bridgedInput
|
| 162 |
+
|
| 163 |
+
override fun getOutputStream(): OutputStream = bridgedOutput
|
| 164 |
+
|
| 165 |
+
/** No Nagle algorithm on a WebSocket; Ktor frames promptly. No-op. */
|
| 166 |
+
override fun setTcpNoDelay(on: Boolean) { /* intentionally no-op */ }
|
| 167 |
+
|
| 168 |
+
/** Stored, not applied — there is no underlying TCP socket to tune. */
|
| 169 |
+
override fun setSoTimeout(timeout: Int) {
|
| 170 |
+
storedSoTimeout = timeout
|
| 171 |
+
}
|
| 172 |
+
|
| 173 |
+
override fun getSoTimeout(): Int = storedSoTimeout
|
| 174 |
+
|
| 175 |
+
/** True once the WS handshake completed and until [close]. */
|
| 176 |
+
override fun isConnected(): Boolean = !closed
|
| 177 |
+
|
| 178 |
+
override fun isClosed(): Boolean = closed
|
| 179 |
+
|
| 180 |
+
override fun close() {
|
| 181 |
+
if (closed) return
|
| 182 |
+
closed = true
|
| 183 |
+
// Unblock the writer (read -> -1) and the reader (channel closes),
|
| 184 |
+
// then stop the coroutines and close the WebSocket.
|
| 185 |
+
runCatching { bridgedOutput.close() }
|
| 186 |
+
runCatching { inboundSink.close() }
|
| 187 |
+
readerJob.cancel()
|
| 188 |
+
writerJob.cancel()
|
| 189 |
+
runCatching { runBlocking { session.close() } }
|
| 190 |
+
runCatching { super.close() }
|
| 191 |
+
}
|
| 192 |
+
}
|
app/core/src/test/kotlin/cc/core/AgentClientTest.kt
ADDED
|
@@ -0,0 +1,150 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.core
|
| 6 |
+
|
| 7 |
+
import io.ktor.client.HttpClient
|
| 8 |
+
import io.ktor.client.engine.mock.MockEngine
|
| 9 |
+
import io.ktor.client.engine.mock.respond
|
| 10 |
+
import io.ktor.http.HttpHeaders
|
| 11 |
+
import io.ktor.http.HttpStatusCode
|
| 12 |
+
import io.ktor.http.content.TextContent
|
| 13 |
+
import io.ktor.http.headersOf
|
| 14 |
+
import io.ktor.serialization.kotlinx.json.json
|
| 15 |
+
import io.ktor.client.plugins.contentnegotiation.ContentNegotiation
|
| 16 |
+
import kotlin.test.Test
|
| 17 |
+
import kotlin.test.assertEquals
|
| 18 |
+
import kotlin.test.assertFailsWith
|
| 19 |
+
import kotlin.test.assertFalse
|
| 20 |
+
import kotlin.test.assertTrue
|
| 21 |
+
import kotlinx.coroutines.runBlocking
|
| 22 |
+
import kotlinx.serialization.json.Json
|
| 23 |
+
|
| 24 |
+
private const val TEST_SECRET = "test-secret"
|
| 25 |
+
|
| 26 |
+
private fun mockClient(): HttpClient {
|
| 27 |
+
val engine = MockEngine {
|
| 28 |
+
val path = it.url.encodedPath
|
| 29 |
+
val authorized = it.headers[HttpHeaders.Authorization] == "Bearer $TEST_SECRET"
|
| 30 |
+
when {
|
| 31 |
+
path == "/health" ->
|
| 32 |
+
respond(
|
| 33 |
+
"""{"ok":true}""",
|
| 34 |
+
HttpStatusCode.OK,
|
| 35 |
+
headersOf(HttpHeaders.ContentType, "application/json"),
|
| 36 |
+
)
|
| 37 |
+
!authorized ->
|
| 38 |
+
respond(
|
| 39 |
+
"""{"error":"unauthorized"}""",
|
| 40 |
+
HttpStatusCode.Unauthorized,
|
| 41 |
+
headersOf(HttpHeaders.ContentType, "application/json"),
|
| 42 |
+
)
|
| 43 |
+
path == "/api/generate" ->
|
| 44 |
+
respond(
|
| 45 |
+
"""{"model":"llama3","response":"echo:hello","done":true}""",
|
| 46 |
+
HttpStatusCode.OK,
|
| 47 |
+
headersOf(HttpHeaders.ContentType, "application/json"),
|
| 48 |
+
)
|
| 49 |
+
path == "/api/chat" ->
|
| 50 |
+
respond(
|
| 51 |
+
"""{"model":"llama3","message":{"role":"assistant","content":"msgs:2"},"done":true}""",
|
| 52 |
+
HttpStatusCode.OK,
|
| 53 |
+
headersOf(HttpHeaders.ContentType, "application/json"),
|
| 54 |
+
)
|
| 55 |
+
else ->
|
| 56 |
+
respond(
|
| 57 |
+
"""{"error":"not found"}""",
|
| 58 |
+
HttpStatusCode.NotFound,
|
| 59 |
+
headersOf(HttpHeaders.ContentType, "application/json"),
|
| 60 |
+
)
|
| 61 |
+
}
|
| 62 |
+
}
|
| 63 |
+
return HttpClient(engine) {
|
| 64 |
+
install(ContentNegotiation) { json(Json { ignoreUnknownKeys = true }) }
|
| 65 |
+
}
|
| 66 |
+
}
|
| 67 |
+
|
| 68 |
+
private fun testConfig(workerUrl: String = "https://worker.example") =
|
| 69 |
+
CommandCenterConfig(
|
| 70 |
+
workerUrl = workerUrl,
|
| 71 |
+
appSecret = TEST_SECRET,
|
| 72 |
+
sshWsUrl = "wss://ssh.example",
|
| 73 |
+
cfClientId = "id",
|
| 74 |
+
cfClientSecret = "secret",
|
| 75 |
+
sshUser = "u",
|
| 76 |
+
sshHost = "h",
|
| 77 |
+
sshKeyPath = "/nonexistent",
|
| 78 |
+
knownHostsPath = "/nonexistent",
|
| 79 |
+
)
|
| 80 |
+
|
| 81 |
+
/**
|
| 82 |
+
* Proves AgentClient without any TCP: Ktor's MockEngine stands in for the
|
| 83 |
+
* Worker gateway. Verifies the Authorization header, JSON request/response
|
| 84 |
+
* mapping, the unauthenticated /health route, and 401 handling.
|
| 85 |
+
*
|
| 86 |
+
* (The CIO engine's socket layer is Ktor's own tested code; what this
|
| 87 |
+
* project owns — URLs, headers, payloads — is all covered here.)
|
| 88 |
+
*/
|
| 89 |
+
class AgentClientTest {
|
| 90 |
+
|
| 91 |
+
@Test
|
| 92 |
+
fun `health is true without auth`() = runBlocking {
|
| 93 |
+
val client = AgentClient(testConfig(), mockClient())
|
| 94 |
+
assertTrue(client.health())
|
| 95 |
+
}
|
| 96 |
+
|
| 97 |
+
@Test
|
| 98 |
+
fun `health is false when the gateway is down`() = runBlocking {
|
| 99 |
+
val dead = HttpClient(
|
| 100 |
+
MockEngine { throw java.io.IOException("connection refused") }
|
| 101 |
+
)
|
| 102 |
+
val client = AgentClient(testConfig(), dead)
|
| 103 |
+
assertFalse(client.health())
|
| 104 |
+
}
|
| 105 |
+
|
| 106 |
+
@Test
|
| 107 |
+
fun `prompt sends bearer auth and parses the response`() = runBlocking {
|
| 108 |
+
val client = AgentClient(testConfig(), mockClient())
|
| 109 |
+
val resp = client.prompt("llama3", "hello")
|
| 110 |
+
assertEquals("llama3", resp.model)
|
| 111 |
+
assertEquals("echo:hello", resp.response)
|
| 112 |
+
assertTrue(resp.done)
|
| 113 |
+
}
|
| 114 |
+
|
| 115 |
+
@Test
|
| 116 |
+
fun `chat posts the message history`() = runBlocking {
|
| 117 |
+
var sawBody = ""
|
| 118 |
+
val engine = MockEngine { request ->
|
| 119 |
+
sawBody = (request.body as? TextContent)?.text ?: ""
|
| 120 |
+
respond(
|
| 121 |
+
"""{"model":"llama3","message":{"role":"assistant","content":"msgs:2"},"done":true}""",
|
| 122 |
+
HttpStatusCode.OK,
|
| 123 |
+
headersOf(HttpHeaders.ContentType, "application/json"),
|
| 124 |
+
)
|
| 125 |
+
}
|
| 126 |
+
val http = HttpClient(engine) {
|
| 127 |
+
install(ContentNegotiation) { json(Json { ignoreUnknownKeys = true }) }
|
| 128 |
+
}
|
| 129 |
+
val client = AgentClient(testConfig(), http)
|
| 130 |
+
val resp = client.chat(
|
| 131 |
+
"llama3",
|
| 132 |
+
listOf(ChatMessage("user", "one"), ChatMessage("user", "two")),
|
| 133 |
+
)
|
| 134 |
+
assertEquals("assistant", resp.message.role)
|
| 135 |
+
assertEquals("msgs:2", resp.message.content)
|
| 136 |
+
// The request body really carried both messages as JSON.
|
| 137 |
+
assertTrue(sawBody.contains("\"one\"") && sawBody.contains("\"two\""), sawBody)
|
| 138 |
+
}
|
| 139 |
+
|
| 140 |
+
@Test
|
| 141 |
+
fun `wrong app secret is rejected`() {
|
| 142 |
+
runBlocking {
|
| 143 |
+
val bad = AgentClient(
|
| 144 |
+
testConfig().copy(appSecret = "wrong-secret"),
|
| 145 |
+
mockClient(),
|
| 146 |
+
)
|
| 147 |
+
assertFailsWith<IllegalStateException> { bad.prompt("llama3", "hello") }
|
| 148 |
+
}
|
| 149 |
+
}
|
| 150 |
+
}
|
app/core/src/test/kotlin/cc/core/WebSocketBridgeTest.kt
ADDED
|
@@ -0,0 +1,159 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.core
|
| 6 |
+
|
| 7 |
+
import com.jcraft.jsch.JSch
|
| 8 |
+
import com.jcraft.jsch.JSchException
|
| 9 |
+
import io.ktor.client.HttpClient
|
| 10 |
+
import io.ktor.client.call.HttpClientCall
|
| 11 |
+
import io.ktor.client.engine.mock.MockEngine
|
| 12 |
+
import io.ktor.http.HttpHeaders
|
| 13 |
+
import io.ktor.client.plugins.websocket.ClientWebSocketSession
|
| 14 |
+
import io.ktor.websocket.CloseReason
|
| 15 |
+
import io.ktor.websocket.Frame
|
| 16 |
+
import io.ktor.websocket.WebSocketExtension
|
| 17 |
+
import java.io.ByteArrayOutputStream
|
| 18 |
+
import java.net.Socket
|
| 19 |
+
import java.util.Properties
|
| 20 |
+
import kotlin.coroutines.CoroutineContext
|
| 21 |
+
import kotlin.random.Random
|
| 22 |
+
import kotlin.test.Test
|
| 23 |
+
import kotlin.test.assertContentEquals
|
| 24 |
+
import kotlin.test.assertEquals
|
| 25 |
+
import kotlin.test.assertFailsWith
|
| 26 |
+
import kotlin.test.assertTrue
|
| 27 |
+
import kotlinx.coroutines.Dispatchers
|
| 28 |
+
import kotlinx.coroutines.SupervisorJob
|
| 29 |
+
import kotlinx.coroutines.channels.Channel
|
| 30 |
+
import kotlinx.coroutines.channels.ReceiveChannel
|
| 31 |
+
import kotlinx.coroutines.channels.SendChannel
|
| 32 |
+
|
| 33 |
+
/**
|
| 34 |
+
* A fake [ClientWebSocketSession] that echoes every binary/text frame back to
|
| 35 |
+
* the client, standing in for the cloudflared ssh-over-websocket tunnel.
|
| 36 |
+
* Records all bytes it received so tests can assert on them.
|
| 37 |
+
*/
|
| 38 |
+
private class FakeEchoWebSocketSession : ClientWebSocketSession {
|
| 39 |
+
val received = ByteArrayOutputStream()
|
| 40 |
+
private val incomingChannel = Channel<Frame>(Channel.UNLIMITED)
|
| 41 |
+
|
| 42 |
+
override var masking: Boolean = true
|
| 43 |
+
override var maxFrameSize: Long = Long.MAX_VALUE
|
| 44 |
+
override val incoming: ReceiveChannel<Frame> = incomingChannel
|
| 45 |
+
override val outgoing: SendChannel<Frame> = Channel(Channel.UNLIMITED)
|
| 46 |
+
override val extensions: List<WebSocketExtension<*>> = emptyList()
|
| 47 |
+
override val coroutineContext: CoroutineContext = SupervisorJob() + Dispatchers.Default
|
| 48 |
+
override val call: HttpClientCall
|
| 49 |
+
get() = throw UnsupportedOperationException("fake session has no call")
|
| 50 |
+
|
| 51 |
+
override suspend fun send(frame: Frame) {
|
| 52 |
+
when (frame) {
|
| 53 |
+
is Frame.Binary, is Frame.Text -> {
|
| 54 |
+
received.write(frame.data)
|
| 55 |
+
// Echo, exactly like the tunnel would return the SSH server's reply.
|
| 56 |
+
incomingChannel.send(Frame.Binary(true, frame.data))
|
| 57 |
+
}
|
| 58 |
+
is Frame.Close -> incomingChannel.close()
|
| 59 |
+
else -> Unit
|
| 60 |
+
}
|
| 61 |
+
}
|
| 62 |
+
|
| 63 |
+
override suspend fun flush() = Unit
|
| 64 |
+
|
| 65 |
+
override fun terminate() {
|
| 66 |
+
incomingChannel.close()
|
| 67 |
+
}
|
| 68 |
+
}
|
| 69 |
+
|
| 70 |
+
/** A client whose session opener can only be the injected fake. */
|
| 71 |
+
private fun dummyClient(): HttpClient =
|
| 72 |
+
HttpClient(MockEngine { error("no real HTTP in bridge tests") })
|
| 73 |
+
|
| 74 |
+
/**
|
| 75 |
+
* Proves the WebSocket↔stream bridge without any TCP: the fake session echoes
|
| 76 |
+
* frames, and the test drives the socket end the way JSch would. Covers the
|
| 77 |
+
* 256 KiB corruption-free round trip, the handshake URL/headers the factory
|
| 78 |
+
* passes to the session opener, and a real JSch instance emitting its
|
| 79 |
+
* SSH-2.0 banner through the bridge.
|
| 80 |
+
*/
|
| 81 |
+
class WebSocketBridgeTest {
|
| 82 |
+
|
| 83 |
+
@Test
|
| 84 |
+
fun `factory passes url and access headers to the session opener`() {
|
| 85 |
+
var seenUrl = ""
|
| 86 |
+
var seenHeaders: Map<String, String> = emptyMap()
|
| 87 |
+
val factory = WebSocketSocketFactory(
|
| 88 |
+
webSocketUrl = "wss://ssh.example/ssh",
|
| 89 |
+
handshakeHeaders = mapOf(
|
| 90 |
+
HttpHeaders.Authorization to "Bearer test-secret",
|
| 91 |
+
"CF-Access-Client-Id" to "test-client-id",
|
| 92 |
+
"CF-Access-Client-Secret" to "test-client-secret",
|
| 93 |
+
),
|
| 94 |
+
httpClient = dummyClient(),
|
| 95 |
+
sessionOpener = { _, url, headers ->
|
| 96 |
+
seenUrl = url
|
| 97 |
+
seenHeaders = headers
|
| 98 |
+
FakeEchoWebSocketSession()
|
| 99 |
+
},
|
| 100 |
+
)
|
| 101 |
+
val socket = factory.createSocket("ignored", 0)
|
| 102 |
+
socket.close()
|
| 103 |
+
assertEquals("wss://ssh.example/ssh", seenUrl)
|
| 104 |
+
assertEquals("test-client-id", seenHeaders["CF-Access-Client-Id"])
|
| 105 |
+
assertEquals("test-client-secret", seenHeaders["CF-Access-Client-Secret"])
|
| 106 |
+
assertEquals("Bearer test-secret", seenHeaders[HttpHeaders.Authorization])
|
| 107 |
+
}
|
| 108 |
+
|
| 109 |
+
@Test
|
| 110 |
+
fun `socket round-trips 256 KiB through the bridge without corruption`() {
|
| 111 |
+
val factory = WebSocketSocketFactory(
|
| 112 |
+
webSocketUrl = "wss://ssh.example/ssh",
|
| 113 |
+
httpClient = dummyClient(),
|
| 114 |
+
sessionOpener = { _, _, _ -> FakeEchoWebSocketSession() },
|
| 115 |
+
)
|
| 116 |
+
val socket = factory.createSocket("ignored", 0)
|
| 117 |
+
try {
|
| 118 |
+
val payload = Random(42).nextBytes(256 * 1024)
|
| 119 |
+
socket.getOutputStream().write(payload)
|
| 120 |
+
socket.getOutputStream().flush()
|
| 121 |
+
val echoed = socket.getInputStream().readNBytes(payload.size)
|
| 122 |
+
assertContentEquals(payload, echoed)
|
| 123 |
+
} finally {
|
| 124 |
+
socket.close()
|
| 125 |
+
}
|
| 126 |
+
}
|
| 127 |
+
|
| 128 |
+
@Test
|
| 129 |
+
fun `real JSch emits its SSH banner through the bridge`() {
|
| 130 |
+
val sessions = mutableListOf<FakeEchoWebSocketSession>()
|
| 131 |
+
val factory = WebSocketSocketFactory(
|
| 132 |
+
webSocketUrl = "wss://ssh.example/ssh",
|
| 133 |
+
httpClient = dummyClient(),
|
| 134 |
+
sessionOpener = { _, _, _ ->
|
| 135 |
+
FakeEchoWebSocketSession().also { sessions += it }
|
| 136 |
+
},
|
| 137 |
+
)
|
| 138 |
+
val socket = factory.createSocket("ignored", 0)
|
| 139 |
+
try {
|
| 140 |
+
val jsch = JSch()
|
| 141 |
+
val session = jsch.getSession("user", "ignored-host", 0)
|
| 142 |
+
session.setConfig(Properties().apply { setProperty("StrictHostKeyChecking", "no") })
|
| 143 |
+
session.setSocketFactory(object : com.jcraft.jsch.SocketFactory {
|
| 144 |
+
override fun createSocket(host: String, port: Int): Socket = socket
|
| 145 |
+
override fun getInputStream(s: Socket) = s.getInputStream()
|
| 146 |
+
override fun getOutputStream(s: Socket) = s.getOutputStream()
|
| 147 |
+
})
|
| 148 |
+
session.setTimeout(10_000)
|
| 149 |
+
// The fake is not an SSH server: the handshake MUST fail — but only
|
| 150 |
+
// after JSch has pushed its real "SSH-2.0-..." banner through the
|
| 151 |
+
// bridge, which is what this test proves.
|
| 152 |
+
assertFailsWith<JSchException> { session.connect(10_000) }
|
| 153 |
+
val sent = sessions.single().received.toByteArray().toString(Charsets.UTF_8)
|
| 154 |
+
assertTrue(sent.startsWith("SSH-2.0-"), "no SSH banner seen, got: ${sent.take(40)}")
|
| 155 |
+
} finally {
|
| 156 |
+
socket.close()
|
| 157 |
+
}
|
| 158 |
+
}
|
| 159 |
+
}
|
app/desktop/build.gradle.kts
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
// SPDX-License-Identifier: AGPL-3.0-or-later
|
| 2 |
+
// Copyright (C) 2026 SnapKitty Collective
|
| 3 |
+
|
| 4 |
+
plugins {
|
| 5 |
+
kotlin("jvm")
|
| 6 |
+
application
|
| 7 |
+
}
|
| 8 |
+
|
| 9 |
+
dependencies {
|
| 10 |
+
implementation(project(":core"))
|
| 11 |
+
}
|
| 12 |
+
|
| 13 |
+
application {
|
| 14 |
+
mainClass.set("cc.desktop.MainKt")
|
| 15 |
+
}
|
app/desktop/src/main/kotlin/cc/desktop/Main.kt
ADDED
|
@@ -0,0 +1,83 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*/
|
| 5 |
+
package cc.desktop
|
| 6 |
+
|
| 7 |
+
import cc.core.AgentClient
|
| 8 |
+
import cc.core.ChatMessage
|
| 9 |
+
import cc.core.CommandCenterConfig
|
| 10 |
+
import cc.core.SshClient
|
| 11 |
+
import kotlinx.coroutines.runBlocking
|
| 12 |
+
|
| 13 |
+
private val USAGE = """
|
| 14 |
+
Kotlin Command Center — terminal edition.
|
| 15 |
+
|
| 16 |
+
Configuration comes from the environment (never from flags, so secrets
|
| 17 |
+
stay out of shell history):
|
| 18 |
+
CC_WORKER_URL https://api.yourdomain.com (Worker gateway)
|
| 19 |
+
CC_APP_SECRET shared secret for the Worker
|
| 20 |
+
CC_SSH_WS_URL wss://ssh.yourdomain.com (SSH over WebSocket)
|
| 21 |
+
CC_CF_CLIENT_ID / CC_CF_CLIENT_SECRET (Access service token)
|
| 22 |
+
CC_SSH_USER / CC_SSH_HOST / CC_SSH_PORT (server login)
|
| 23 |
+
CC_SSH_KEY path to SSH private key
|
| 24 |
+
CC_KNOWN_HOSTS path to known_hosts (host key is pinned)
|
| 25 |
+
|
| 26 |
+
Commands:
|
| 27 |
+
health Check the Worker gateway (no auth needed)
|
| 28 |
+
prompt <model> <text...> One completion via Ollama
|
| 29 |
+
chat <model> Interactive chat (blank line quits)
|
| 30 |
+
ssh <command...> Run a remote command over SSH-over-WebSocket
|
| 31 |
+
""".trimIndent()
|
| 32 |
+
|
| 33 |
+
fun main(args: Array<String>) = runBlocking {
|
| 34 |
+
if (args.isEmpty()) {
|
| 35 |
+
println(USAGE)
|
| 36 |
+
return@runBlocking
|
| 37 |
+
}
|
| 38 |
+
val config = try {
|
| 39 |
+
CommandCenterConfig.fromEnv()
|
| 40 |
+
} catch (e: IllegalStateException) {
|
| 41 |
+
System.err.println("configuration error: ${e.message}")
|
| 42 |
+
System.err.println(USAGE)
|
| 43 |
+
return@runBlocking
|
| 44 |
+
}
|
| 45 |
+
|
| 46 |
+
when (args[0]) {
|
| 47 |
+
"health" -> {
|
| 48 |
+
val ok = AgentClient(config).health()
|
| 49 |
+
println(if (ok) "gateway: OK" else "gateway: UNREACHABLE")
|
| 50 |
+
}
|
| 51 |
+
"prompt" -> {
|
| 52 |
+
require(args.size >= 3) { "usage: prompt <model> <text...>" }
|
| 53 |
+
val resp = AgentClient(config).prompt(args[1], args.drop(2).joinToString(" "))
|
| 54 |
+
println(resp.response)
|
| 55 |
+
}
|
| 56 |
+
"chat" -> {
|
| 57 |
+
require(args.size >= 2) { "usage: chat <model>" }
|
| 58 |
+
val model = args[1]
|
| 59 |
+
val client = AgentClient(config)
|
| 60 |
+
val history = mutableListOf<ChatMessage>()
|
| 61 |
+
println("chat with $model (blank line quits)")
|
| 62 |
+
while (true) {
|
| 63 |
+
print("you> ")
|
| 64 |
+
val line = readlnOrNull()?.trim().orEmpty()
|
| 65 |
+
if (line.isEmpty()) break
|
| 66 |
+
history += ChatMessage("user", line)
|
| 67 |
+
val resp = client.chat(model, history.toList())
|
| 68 |
+
history += resp.message
|
| 69 |
+
println("agent> ${resp.message.content}")
|
| 70 |
+
}
|
| 71 |
+
}
|
| 72 |
+
"ssh" -> {
|
| 73 |
+
require(args.size >= 2) { "usage: ssh <command...>" }
|
| 74 |
+
val result = SshClient(config).exec(args.drop(1).joinToString(" "))
|
| 75 |
+
if (result.stderr.isNotBlank()) System.err.print(result.stderr)
|
| 76 |
+
print(result.stdout)
|
| 77 |
+
if (result.exitCode != 0) {
|
| 78 |
+
System.err.println("(exit ${result.exitCode})")
|
| 79 |
+
}
|
| 80 |
+
}
|
| 81 |
+
else -> println(USAGE)
|
| 82 |
+
}
|
| 83 |
+
}
|
app/gradle.properties
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# SPDX-License-Identifier: AGPL-3.0-or-later
|
| 2 |
+
# Copyright (C) 2026 SnapKitty Collective
|
| 3 |
+
org.gradle.jvmargs=-Xmx2g
|
| 4 |
+
kotlin.code.style=official
|
app/settings.gradle.kts
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
// SPDX-License-Identifier: AGPL-3.0-or-later
|
| 2 |
+
// Copyright (C) 2026 SnapKitty Collective
|
| 3 |
+
|
| 4 |
+
pluginManagement {
|
| 5 |
+
repositories {
|
| 6 |
+
gradlePluginPortal()
|
| 7 |
+
mavenCentral()
|
| 8 |
+
}
|
| 9 |
+
}
|
| 10 |
+
|
| 11 |
+
dependencyResolutionManagement {
|
| 12 |
+
repositories {
|
| 13 |
+
mavenCentral()
|
| 14 |
+
}
|
| 15 |
+
}
|
| 16 |
+
|
| 17 |
+
// NOTE: the :android module is intentionally NOT included here. It needs the
|
| 18 |
+
// Android SDK, which this build box does not have (see app/android/README.md).
|
| 19 |
+
// Add `include(":android")` on a machine with the SDK / Android Studio.
|
| 20 |
+
rootProject.name = "kotlin-command-center"
|
| 21 |
+
include(":core", ":desktop")
|
server/ACCESS_SETUP.md
ADDED
|
@@ -0,0 +1,61 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Cloudflare Access setup — service-token auth for the app
|
| 2 |
+
|
| 3 |
+
Both tunnel hostnames must sit behind Cloudflare Access so the open internet
|
| 4 |
+
cannot reach Ollama or SSH. The Kotlin app authenticates with a **service
|
| 5 |
+
token** (Client ID + Client Secret) — programmatic, no browser login on the
|
| 6 |
+
phone.
|
| 7 |
+
|
| 8 |
+
## 1. Create the Access applications
|
| 9 |
+
|
| 10 |
+
Cloudflare dashboard → **Zero Trust → Access → Applications → Add an application → Self-hosted**.
|
| 11 |
+
|
| 12 |
+
Create one for each hostname (replace `yourdomain.com` with your domain):
|
| 13 |
+
|
| 14 |
+
| Application name | Domain |
|
| 15 |
+
|---|---|
|
| 16 |
+
| command-center-ollama | `ollama-internal.yourdomain.com` |
|
| 17 |
+
| command-center-ssh | `ssh.yourdomain.com` |
|
| 18 |
+
|
| 19 |
+
Session duration: 24h is fine (service tokens are not interactive sessions).
|
| 20 |
+
|
| 21 |
+
## 2. Create the service token
|
| 22 |
+
|
| 23 |
+
**Zero Trust → Access → Service Tokens → Create Service Token.**
|
| 24 |
+
|
| 25 |
+
- Name: `kotlin-command-center`
|
| 26 |
+
- It shows a **Client ID** and **Client Secret** exactly once. Copy both now —
|
| 27 |
+
the secret cannot be retrieved later (generate a new token if lost).
|
| 28 |
+
|
| 29 |
+
## 3. Attach the Allow policy to both applications
|
| 30 |
+
|
| 31 |
+
For each application → **Policies → Add a policy**:
|
| 32 |
+
|
| 33 |
+
- Policy name: `app-service-token`
|
| 34 |
+
- Action: **Allow**
|
| 35 |
+
- Configure rules → **Add require → Service Token** → select `kotlin-command-center`
|
| 36 |
+
- (Optional but recommended) Add an `AND` rule: **IP ranges** limited to the
|
| 37 |
+
egress ranges you actually use, if they are stable.
|
| 38 |
+
|
| 39 |
+
Result: any request without a valid `CF-Access-Client-Id` /
|
| 40 |
+
`CF-Access-Client-Secret` pair is rejected at the edge before it ever touches
|
| 41 |
+
your tunnel.
|
| 42 |
+
|
| 43 |
+
## 4. Wire the secrets into the stack
|
| 44 |
+
|
| 45 |
+
| Secret | Where it goes |
|
| 46 |
+
|---|---|
|
| 47 |
+
| Client ID + Client Secret | `worker/` via `wrangler secret put CF_CLIENT_ID` / `CF_CLIENT_SECRET` (Worker attaches them when calling the tunnel) |
|
| 48 |
+
| Client ID + Client Secret | Kotlin app config (`CC_CF_CLIENT_ID`, `CC_CF_CLIENT_SECRET`) — used on the **SSH WebSocket handshake** (`wss://ssh.yourdomain.com`) |
|
| 49 |
+
| `APP_SECRET` (you invent) | `wrangler secret put APP_SECRET` and the app's `CC_APP_SECRET` — authenticates the phone to the Worker |
|
| 50 |
+
|
| 51 |
+
The phone never talks to `ollama-internal.yourdomain.com` directly; only the
|
| 52 |
+
Worker holds the service token for that hostname. The phone uses the service
|
| 53 |
+
token only for the SSH WebSocket handshake.
|
| 54 |
+
|
| 55 |
+
## 5. Rotation
|
| 56 |
+
|
| 57 |
+
- Service token compromised or phone lost: **Access → Service Tokens → delete**
|
| 58 |
+
the token and create a new one, then `wrangler secret put` the new values and
|
| 59 |
+
update the app config. The old token stops working immediately.
|
| 60 |
+
- `APP_SECRET`: pick a fresh 32+ byte random value
|
| 61 |
+
(`openssl rand -hex 32`), rotate the same way.
|
server/config.yml
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# SPDX-License-Identifier: AGPL-3.0-or-later
|
| 2 |
+
# Copyright (C) 2026 SnapKitty Collective
|
| 3 |
+
#
|
| 4 |
+
# cloudflared tunnel ingress template for the Kotlin Command Center.
|
| 5 |
+
# Placeholders only — setup.sh renders this with your real tunnel UUID.
|
| 6 |
+
# Copy to /etc/cloudflared/config.yml on the server.
|
| 7 |
+
|
| 8 |
+
tunnel: TUNNEL_UUID
|
| 9 |
+
credentials-file: /etc/cloudflared/TUNNEL_UUID.json
|
| 10 |
+
|
| 11 |
+
ingress:
|
| 12 |
+
# Ollama API behind the Worker gateway (internal hostname; the Worker
|
| 13 |
+
# attaches the Cloudflare Access service token, so no browser login needed).
|
| 14 |
+
- hostname: ollama-internal.yourdomain.com
|
| 15 |
+
service: http://localhost:11434
|
| 16 |
+
# SSH over WebSocket for the Kotlin app's JSch bridge.
|
| 17 |
+
- hostname: ssh.yourdomain.com
|
| 18 |
+
service: ssh://localhost:22
|
| 19 |
+
# Catch-all: refuse anything else.
|
| 20 |
+
- service: http_status:404
|
server/setup.sh
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
#!/usr/bin/env bash
|
| 2 |
+
# SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
# Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
#
|
| 5 |
+
# Provision cloudflared on the server that runs Ollama:
|
| 6 |
+
# 1. installs cloudflared
|
| 7 |
+
# 2. creates a tunnel and routes DNS for the API + SSH hostnames
|
| 8 |
+
# 3. renders /etc/cloudflared/config.yml from config.yml
|
| 9 |
+
# 4. installs + starts a systemd unit (outbound-only: no inbound firewall ports)
|
| 10 |
+
#
|
| 11 |
+
# Usage:
|
| 12 |
+
# sudo DOMAIN=yourdomain.com TUNNEL_NAME=command-center ./setup.sh
|
| 13 |
+
#
|
| 14 |
+
# DOMAIN is required and must be YOUR domain. Nothing here phones home;
|
| 15 |
+
# cloudflared only ever opens outbound connections to Cloudflare's edge.
|
| 16 |
+
set -euo pipefail
|
| 17 |
+
|
| 18 |
+
DOMAIN="${DOMAIN:-}"
|
| 19 |
+
TUNNEL_NAME="${TUNNEL_NAME:-command-center}"
|
| 20 |
+
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
| 21 |
+
|
| 22 |
+
if [[ -z "$DOMAIN" ]]; then
|
| 23 |
+
echo "error: set DOMAIN to your real domain, e.g. DOMAIN=example.com $0" >&2
|
| 24 |
+
exit 1
|
| 25 |
+
fi
|
| 26 |
+
if [[ "$EUID" -ne 0 ]]; then
|
| 27 |
+
echo "error: run as root (needs apt + /etc/cloudflared)" >&2
|
| 28 |
+
exit 1
|
| 29 |
+
fi
|
| 30 |
+
|
| 31 |
+
echo "==> Installing cloudflared"
|
| 32 |
+
if ! command -v cloudflared >/dev/null 2>&1; then
|
| 33 |
+
mkdir -p /usr/share/keyrings
|
| 34 |
+
curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg \
|
| 35 |
+
| tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
|
| 36 |
+
echo 'deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared any main' \
|
| 37 |
+
| tee /etc/apt/sources.list.d/cloudflared.list >/dev/null
|
| 38 |
+
apt-get update -qq && apt-get install -y -qq cloudflared
|
| 39 |
+
fi
|
| 40 |
+
cloudflared --version
|
| 41 |
+
|
| 42 |
+
echo "==> Authenticating (opens a browser URL; on a headless box copy ~/.cloudflared/cert.pem from a machine where you ran 'cloudflared tunnel login')"
|
| 43 |
+
cloudflared tunnel login
|
| 44 |
+
|
| 45 |
+
echo "==> Creating tunnel '$TUNNEL_NAME'"
|
| 46 |
+
if cloudflared tunnel list 2>/dev/null | grep -q "$TUNNEL_NAME"; then
|
| 47 |
+
echo " tunnel already exists, reusing"
|
| 48 |
+
else
|
| 49 |
+
cloudflared tunnel create "$TUNNEL_NAME"
|
| 50 |
+
fi
|
| 51 |
+
TUNNEL_ID="$(cloudflared tunnel list --output json 2>/dev/null \
|
| 52 |
+
| python3 -c "import json,sys; print([t['id'] for t in json.load(sys.stdin) if t['name']=='$TUNNEL_NAME'][0])")"
|
| 53 |
+
echo " tunnel id: $TUNNEL_ID"
|
| 54 |
+
|
| 55 |
+
echo "==> Routing DNS"
|
| 56 |
+
cloudflared tunnel route dns "$TUNNEL_ID" "ollama-internal.$DOMAIN" || true
|
| 57 |
+
cloudflared tunnel route dns "$TUNNEL_ID" "ssh.$DOMAIN" || true
|
| 58 |
+
|
| 59 |
+
echo "==> Rendering /etc/cloudflared/config.yml"
|
| 60 |
+
mkdir -p /etc/cloudflared
|
| 61 |
+
sed -e "s/TUNNEL_UUID/$TUNNEL_ID/g" \
|
| 62 |
+
-e "s/yourdomain\.com/$DOMAIN/g" \
|
| 63 |
+
"$SCRIPT_DIR/config.yml" > /etc/cloudflared/config.yml
|
| 64 |
+
chmod 600 /etc/cloudflared/config.yml
|
| 65 |
+
echo " wrote /etc/cloudflared/config.yml"
|
| 66 |
+
|
| 67 |
+
echo "==> Installing systemd unit"
|
| 68 |
+
cat > /etc/systemd/system/cloudflared.service <<'UNIT'
|
| 69 |
+
[Unit]
|
| 70 |
+
Description=cloudflared tunnel for Kotlin Command Center
|
| 71 |
+
After=network-online.target
|
| 72 |
+
Wants=network-online.target
|
| 73 |
+
|
| 74 |
+
[Service]
|
| 75 |
+
Type=notify
|
| 76 |
+
ExecStart=/usr/bin/cloudflared tunnel --config /etc/cloudflared/config.yml run
|
| 77 |
+
Restart=on-failure
|
| 78 |
+
RestartSec=5s
|
| 79 |
+
# Harden: no new privileges, private /tmp
|
| 80 |
+
NoNewPrivileges=true
|
| 81 |
+
PrivateTmp=true
|
| 82 |
+
|
| 83 |
+
[Install]
|
| 84 |
+
WantedBy=multi-user.target
|
| 85 |
+
UNIT
|
| 86 |
+
systemctl daemon-reload
|
| 87 |
+
systemctl enable --now cloudflared
|
| 88 |
+
systemctl --no-pager status cloudflared | head -8
|
| 89 |
+
|
| 90 |
+
echo
|
| 91 |
+
echo "==> Done. Next: follow ACCESS_SETUP.md to lock both hostnames behind"
|
| 92 |
+
echo " Cloudflare Access with a service token, then deploy worker/."
|
worker/worker.js
ADDED
|
@@ -0,0 +1,115 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/*
|
| 2 |
+
* SPDX-License-Identifier: AGPL-3.0-or-later
|
| 3 |
+
* Copyright (C) 2026 SnapKitty Collective
|
| 4 |
+
*
|
| 5 |
+
* Kotlin Command Center — Cloudflare Worker API gateway.
|
| 6 |
+
*
|
| 7 |
+
* The phone never talks to Ollama directly. It authenticates to this Worker
|
| 8 |
+
* with `Authorization: Bearer <APP_SECRET>`; the Worker then forwards to the
|
| 9 |
+
* internal tunnel hostname, attaching the Cloudflare Access service token
|
| 10 |
+
* (CF-Access-Client-Id / CF-Access-Client-Secret) so the request passes the
|
| 11 |
+
* Zero Trust screen without a browser login.
|
| 12 |
+
*
|
| 13 |
+
* Secrets: APP_SECRET, CF_CLIENT_ID, CF_CLIENT_SECRET.
|
| 14 |
+
* Set with `wrangler secret put <NAME>` — nothing secret lives in this repo.
|
| 15 |
+
* TUNNEL_BASE is a plain (non-secret) variable: the internal tunnel hostname,
|
| 16 |
+
* which is useless without the Access service token.
|
| 17 |
+
*
|
| 18 |
+
* Rate limiting is an in-memory per-isolate sliding window. That is correct
|
| 19 |
+
* for a single-phone command center; the production upgrade path is a
|
| 20 |
+
* Durable Object keyed by client IP (see note below).
|
| 21 |
+
*/
|
| 22 |
+
|
| 23 |
+
const WINDOW_MS = 60_000; // sliding window
|
| 24 |
+
const MAX_REQUESTS = 60; // per IP per window
|
| 25 |
+
|
| 26 |
+
// ip -> array of request timestamps (ms). Per-isolate memory only.
|
| 27 |
+
const hits = new Map();
|
| 28 |
+
|
| 29 |
+
function rateLimited(ip) {
|
| 30 |
+
const now = Date.now();
|
| 31 |
+
const recent = (hits.get(ip) || []).filter((t) => now - t < WINDOW_MS);
|
| 32 |
+
recent.push(now);
|
| 33 |
+
hits.set(ip, recent);
|
| 34 |
+
// Occasionally prune dead entries so the map cannot grow unbounded.
|
| 35 |
+
if (hits.size > 10000) {
|
| 36 |
+
for (const [k, v] of hits) {
|
| 37 |
+
if (v.length === 0 || now - v[v.length - 1] > WINDOW_MS) hits.delete(k);
|
| 38 |
+
}
|
| 39 |
+
}
|
| 40 |
+
return recent.length > MAX_REQUESTS;
|
| 41 |
+
// PRODUCTION: replace with a Durable Object (one per client IP) so the
|
| 42 |
+
// limit is enforced globally across all isolates, not per isolate.
|
| 43 |
+
}
|
| 44 |
+
|
| 45 |
+
function jsonError(message, status) {
|
| 46 |
+
return new Response(JSON.stringify({ error: message }), {
|
| 47 |
+
status,
|
| 48 |
+
headers: { "Content-Type": "application/json" },
|
| 49 |
+
});
|
| 50 |
+
}
|
| 51 |
+
|
| 52 |
+
export default {
|
| 53 |
+
async fetch(request, env) {
|
| 54 |
+
const url = new URL(request.url);
|
| 55 |
+
const path = url.pathname;
|
| 56 |
+
|
| 57 |
+
// Liveness probe — no auth, so uptime monitors and the app's health
|
| 58 |
+
// check work without secrets.
|
| 59 |
+
if (path === "/health") {
|
| 60 |
+
return new Response(JSON.stringify({ ok: true }), {
|
| 61 |
+
headers: { "Content-Type": "application/json" },
|
| 62 |
+
});
|
| 63 |
+
}
|
| 64 |
+
|
| 65 |
+
const OLLAMA_ROUTES = ["/api/generate", "/api/chat"];
|
| 66 |
+
if (!OLLAMA_ROUTES.includes(path)) {
|
| 67 |
+
return jsonError("not found", 404);
|
| 68 |
+
}
|
| 69 |
+
|
| 70 |
+
// Ollama's API is POST-only; reject anything else explicitly.
|
| 71 |
+
if (request.method !== "POST") {
|
| 72 |
+
return jsonError("method not allowed", 405);
|
| 73 |
+
}
|
| 74 |
+
|
| 75 |
+
// 1. App authentication.
|
| 76 |
+
const auth = request.headers.get("Authorization");
|
| 77 |
+
if (!env.APP_SECRET || auth !== `Bearer ${env.APP_SECRET}`) {
|
| 78 |
+
return jsonError("unauthorized", 401);
|
| 79 |
+
}
|
| 80 |
+
|
| 81 |
+
// 2. Rate limit (after auth: only authenticated callers consume budget).
|
| 82 |
+
const ip =
|
| 83 |
+
request.headers.get("CF-Connecting-IP") ||
|
| 84 |
+
request.headers.get("X-Forwarded-For") ||
|
| 85 |
+
"unknown";
|
| 86 |
+
if (rateLimited(ip)) {
|
| 87 |
+
return jsonError("rate limited", 429);
|
| 88 |
+
}
|
| 89 |
+
|
| 90 |
+
// 3. Forward to the internal tunnel hostname, preserving path, query
|
| 91 |
+
// and the (possibly streaming) body. Attach the Access service token.
|
| 92 |
+
if (!env.TUNNEL_BASE) {
|
| 93 |
+
return jsonError("gateway misconfigured", 500);
|
| 94 |
+
}
|
| 95 |
+
const upstream = new Request(env.TUNNEL_BASE + path + url.search, {
|
| 96 |
+
method: request.method,
|
| 97 |
+
headers: {
|
| 98 |
+
"Content-Type": "application/json",
|
| 99 |
+
"CF-Access-Client-Id": env.CF_CLIENT_ID || "",
|
| 100 |
+
"CF-Access-Client-Secret": env.CF_CLIENT_SECRET || "",
|
| 101 |
+
},
|
| 102 |
+
body: request.body,
|
| 103 |
+
// Keep the body streaming end-to-end (Ollama stream:true responses
|
| 104 |
+
// flow back to the phone without buffering here).
|
| 105 |
+
duplex: "half",
|
| 106 |
+
});
|
| 107 |
+
|
| 108 |
+
const upstreamResp = await fetch(upstream);
|
| 109 |
+
// Stream the upstream response straight back; copy status + headers.
|
| 110 |
+
return new Response(upstreamResp.body, {
|
| 111 |
+
status: upstreamResp.status,
|
| 112 |
+
headers: upstreamResp.headers,
|
| 113 |
+
});
|
| 114 |
+
},
|
| 115 |
+
};
|
worker/wrangler.toml
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# SPDX-License-Identifier: AGPL-3.0-or-later
|
| 2 |
+
# Copyright (C) 2026 SnapKitty Collective
|
| 3 |
+
#
|
| 4 |
+
# Wrangler config for the command-center API gateway.
|
| 5 |
+
#
|
| 6 |
+
# TUNNEL_BASE below is a plain (non-secret) variable: it is only the internal
|
| 7 |
+
# tunnel hostname, which is useless without passing the Cloudflare Access
|
| 8 |
+
# service-token screen. The actual secrets are set with:
|
| 9 |
+
# wrangler secret put APP_SECRET
|
| 10 |
+
# wrangler secret put CF_CLIENT_ID
|
| 11 |
+
# wrangler secret put CF_CLIENT_SECRET
|
| 12 |
+
# Never commit real secret values to this file.
|
| 13 |
+
|
| 14 |
+
name = "command-center-gateway"
|
| 15 |
+
main = "worker.js"
|
| 16 |
+
compatibility_date = "2024-01-01"
|
| 17 |
+
|
| 18 |
+
# Non-secret: the internal tunnel hostname for Ollama. Protected by the
|
| 19 |
+
# Access service-token policy, so the hostname alone grants nothing.
|
| 20 |
+
[vars]
|
| 21 |
+
TUNNEL_BASE = "https://ollama-internal.yourdomain.com"
|