nowrun 2.0.2__tar.gz → 2.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {nowrun-2.0.2 → nowrun-2.1.0}/PKG-INFO +7 -6
- {nowrun-2.0.2 → nowrun-2.1.0}/README.md +6 -5
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/appmeta.py +17 -8
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/cli.py +26 -12
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/admin.py +25 -6
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/app.py +46 -8
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/deploy.py +1 -1
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/validate.py +8 -7
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/config.py +5 -5
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/fields.py +8 -4
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/output.py +3 -3
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/skill/SKILL.md +44 -19
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/PKG-INFO +7 -6
- {nowrun-2.0.2 → nowrun-2.1.0}/setup.py +1 -1
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/__init__.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/__main__.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/apk.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/client.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/__init__.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/inspect.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/legacy.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/login.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/mcp.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/mode.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/setup.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/skill.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/update.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/passthrough.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/upload.py +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/SOURCES.txt +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/dependency_links.txt +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/entry_points.txt +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/requires.txt +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/top_level.txt +0 -0
- {nowrun-2.0.2 → nowrun-2.1.0}/setup.cfg +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.1
|
|
2
2
|
Name: nowrun
|
|
3
|
-
Version: 2.0
|
|
3
|
+
Version: 2.1.0
|
|
4
4
|
Summary: CLI to deploy and manage Android and HTML5 apps on nowrun.
|
|
5
5
|
Home-page: https://nowrun.io
|
|
6
6
|
Author: nowrun
|
|
@@ -51,8 +51,8 @@ They're here for reference (and the occasional manual run):
|
|
|
51
51
|
| Command | Does |
|
|
52
52
|
|---------|------|
|
|
53
53
|
| `nowrun app categories` | the categories an app can have |
|
|
54
|
-
| `nowrun app create --title "My App" -p com.foo.bar --category Tools --description ... --
|
|
55
|
-
| `nowrun app update --
|
|
54
|
+
| `nowrun app create --title "My App" -p com.foo.bar --category Tools --short-description ... --long-description ... --intent ... --kind app --orientation portrait --icon icon.png` | create an app with its full listing - every field is required (or `--from-apk app.apk` to read the package and icon from the build; `--data app.json` to pass the fields as JSON) |
|
|
55
|
+
| `nowrun app update --short-description ... --icon icon.png` | change any of an app's metadata |
|
|
56
56
|
| `nowrun app list` / `nowrun app show` | list your apps / show one, with its visibility and readiness |
|
|
57
57
|
| `nowrun inspect app.apk` | read a build's package + version, no Android SDK needed |
|
|
58
58
|
| `nowrun validate` | check what's missing before deploying |
|
|
@@ -65,7 +65,8 @@ doesn't match the app**, so you never publish to the wrong place. It also **refu
|
|
|
65
65
|
code that isn't higher than the one currently live** (like the Play Store), so you can't ship a
|
|
66
66
|
downgrade. Add `--json` (in any position) to any command for machine-readable output.
|
|
67
67
|
|
|
68
|
-
New apps are private; a nowrun admin decides
|
|
68
|
+
New apps are private; a nowrun admin decides who can use each app and whether nowrun's public
|
|
69
|
+
plugin shows it.
|
|
69
70
|
You stay signed in: the CLI refreshes its session automatically (for 30 days after last use).
|
|
70
71
|
|
|
71
72
|
## nowrun admins
|
|
@@ -77,14 +78,14 @@ current one. Every command prints the active mode (`[ADMIN MODE] you@... - chang
|
|
|
77
78
|
audited` or `[personal] you@...`), and `--json` output carries a top-level `"mode"`.
|
|
78
79
|
|
|
79
80
|
In admin mode the regular `app` / `build` / `deploy` / `status` commands act on
|
|
80
|
-
**nowrun-managed apps** (owned by no user, public once deployed), and the admin
|
|
81
|
+
**nowrun-managed apps** (owned by no user, public once deployed), and the admin console is
|
|
81
82
|
available:
|
|
82
83
|
|
|
83
84
|
| Command | Does |
|
|
84
85
|
|---------|------|
|
|
85
86
|
| `nowrun admin apps list [--q ... --owner-email ... --admin-managed/--user-owned --public/--private --status ... --readiness ... --all]` | search every app |
|
|
86
87
|
| `nowrun admin apps show <app_id>` | any app, with its owner |
|
|
87
|
-
| `nowrun admin apps set-public\|set-private\|disable\|enable\|unpublish <app_id>... [--reason ...] [--yes]` | change
|
|
88
|
+
| `nowrun admin apps set-public\|set-private\|show-on-public-plugin\|hide-from-public-plugin\|disable\|enable\|unpublish <app_id>... [--reason ...] [--yes]` | change who can use apps, the public plugin, or status (bulk) |
|
|
88
89
|
| `nowrun admin apps remove <app_id>... [--reason ...] [--yes]` | remove any apps: out of every list and the catalog, package freed, record kept |
|
|
89
90
|
| `nowrun admin apps delete <app_id>... [--reason ...] [--yes]` | permanently erase nowrun-managed apps and their builds (cannot be undone; use `remove` for a user's app) |
|
|
90
91
|
| `nowrun admin apps fetch-apk -a <app_id> --url <link> [--expected-package <pkg>] [--deploy]` | download an APK from a link into the deploy bucket and report what it is; `--deploy` then deploys it (unreviewed third-party build) |
|
|
@@ -37,8 +37,8 @@ They're here for reference (and the occasional manual run):
|
|
|
37
37
|
| Command | Does |
|
|
38
38
|
|---------|------|
|
|
39
39
|
| `nowrun app categories` | the categories an app can have |
|
|
40
|
-
| `nowrun app create --title "My App" -p com.foo.bar --category Tools --description ... --
|
|
41
|
-
| `nowrun app update --
|
|
40
|
+
| `nowrun app create --title "My App" -p com.foo.bar --category Tools --short-description ... --long-description ... --intent ... --kind app --orientation portrait --icon icon.png` | create an app with its full listing - every field is required (or `--from-apk app.apk` to read the package and icon from the build; `--data app.json` to pass the fields as JSON) |
|
|
41
|
+
| `nowrun app update --short-description ... --icon icon.png` | change any of an app's metadata |
|
|
42
42
|
| `nowrun app list` / `nowrun app show` | list your apps / show one, with its visibility and readiness |
|
|
43
43
|
| `nowrun inspect app.apk` | read a build's package + version, no Android SDK needed |
|
|
44
44
|
| `nowrun validate` | check what's missing before deploying |
|
|
@@ -51,7 +51,8 @@ doesn't match the app**, so you never publish to the wrong place. It also **refu
|
|
|
51
51
|
code that isn't higher than the one currently live** (like the Play Store), so you can't ship a
|
|
52
52
|
downgrade. Add `--json` (in any position) to any command for machine-readable output.
|
|
53
53
|
|
|
54
|
-
New apps are private; a nowrun admin decides
|
|
54
|
+
New apps are private; a nowrun admin decides who can use each app and whether nowrun's public
|
|
55
|
+
plugin shows it.
|
|
55
56
|
You stay signed in: the CLI refreshes its session automatically (for 30 days after last use).
|
|
56
57
|
|
|
57
58
|
## nowrun admins
|
|
@@ -63,14 +64,14 @@ current one. Every command prints the active mode (`[ADMIN MODE] you@... - chang
|
|
|
63
64
|
audited` or `[personal] you@...`), and `--json` output carries a top-level `"mode"`.
|
|
64
65
|
|
|
65
66
|
In admin mode the regular `app` / `build` / `deploy` / `status` commands act on
|
|
66
|
-
**nowrun-managed apps** (owned by no user, public once deployed), and the admin
|
|
67
|
+
**nowrun-managed apps** (owned by no user, public once deployed), and the admin console is
|
|
67
68
|
available:
|
|
68
69
|
|
|
69
70
|
| Command | Does |
|
|
70
71
|
|---------|------|
|
|
71
72
|
| `nowrun admin apps list [--q ... --owner-email ... --admin-managed/--user-owned --public/--private --status ... --readiness ... --all]` | search every app |
|
|
72
73
|
| `nowrun admin apps show <app_id>` | any app, with its owner |
|
|
73
|
-
| `nowrun admin apps set-public\|set-private\|disable\|enable\|unpublish <app_id>... [--reason ...] [--yes]` | change
|
|
74
|
+
| `nowrun admin apps set-public\|set-private\|show-on-public-plugin\|hide-from-public-plugin\|disable\|enable\|unpublish <app_id>... [--reason ...] [--yes]` | change who can use apps, the public plugin, or status (bulk) |
|
|
74
75
|
| `nowrun admin apps remove <app_id>... [--reason ...] [--yes]` | remove any apps: out of every list and the catalog, package freed, record kept |
|
|
75
76
|
| `nowrun admin apps delete <app_id>... [--reason ...] [--yes]` | permanently erase nowrun-managed apps and their builds (cannot be undone; use `remove` for a user's app) |
|
|
76
77
|
| `nowrun admin apps fetch-apk -a <app_id> --url <link> [--expected-package <pkg>] [--deploy]` | download an APK from a link into the deploy bucket and report what it is; `--deploy` then deploys it (unreviewed third-party build) |
|
|
@@ -23,8 +23,8 @@ API_FIELD = {
|
|
|
23
23
|
'lang': 'default_app_language',
|
|
24
24
|
'tier': 'app_tier',
|
|
25
25
|
'kind': 'catalog.kind',
|
|
26
|
-
'
|
|
27
|
-
'
|
|
26
|
+
'short_description': 'catalog.shortDescription',
|
|
27
|
+
'long_description': 'catalog.longDescription',
|
|
28
28
|
'intents': 'catalog.intents',
|
|
29
29
|
'orientation': 'catalog.orientation',
|
|
30
30
|
}
|
|
@@ -35,8 +35,8 @@ REQUIRED = (
|
|
|
35
35
|
('category', 'a category is required (see `nowrun app categories`)'),
|
|
36
36
|
('icon', 'an icon is required (an image path, or --from-apk to extract one)'),
|
|
37
37
|
('kind', "must be 'app' or 'game'"),
|
|
38
|
-
('
|
|
39
|
-
('
|
|
38
|
+
('short_description', 'a short description is required'),
|
|
39
|
+
('long_description', 'a long description is required'),
|
|
40
40
|
('intents', 'at least one intent phrase is required'),
|
|
41
41
|
('orientation', "must be 'portrait' or 'landscape'"),
|
|
42
42
|
)
|
|
@@ -48,8 +48,11 @@ _ALIASES = {
|
|
|
48
48
|
'package': 'package', 'app_pkg_name': 'package',
|
|
49
49
|
'category': 'category', 'app_category': 'category',
|
|
50
50
|
'icon': 'icon', 'app_logo_url': 'icon',
|
|
51
|
-
'
|
|
52
|
-
'
|
|
51
|
+
'shortDescription': 'short_description', 'short_description': 'short_description',
|
|
52
|
+
'longDescription': 'long_description', 'long_description': 'long_description',
|
|
53
|
+
# Deprecated names (before the ChatGPT-aligned rename); still accepted.
|
|
54
|
+
'pitch': 'short_description',
|
|
55
|
+
'description': 'long_description', 'blurb': 'long_description',
|
|
53
56
|
'intents': 'intents', 'intent': 'intents',
|
|
54
57
|
'kind': 'kind',
|
|
55
58
|
'orientation': 'orientation',
|
|
@@ -57,6 +60,10 @@ _ALIASES = {
|
|
|
57
60
|
'tier': 'tier', 'app_tier': 'tier',
|
|
58
61
|
}
|
|
59
62
|
|
|
63
|
+
# Same limits as ChatGPT's app listing form.
|
|
64
|
+
SHORT_DESCRIPTION_MAX = 80
|
|
65
|
+
LONG_DESCRIPTION_MAX = 2000
|
|
66
|
+
|
|
60
67
|
# Can't be changed by `app update` (the server's PATCH allowlist excludes them).
|
|
61
68
|
CREATE_ONLY = ('game_type', 'package', 'tier')
|
|
62
69
|
|
|
@@ -162,7 +169,8 @@ def check(fields, create=True):
|
|
|
162
169
|
intents = fields['intents']
|
|
163
170
|
if not isinstance(intents, list) or not all(isinstance(i, str) for i in intents):
|
|
164
171
|
problems.append(_problem('intents', 'must be a list of phrases'))
|
|
165
|
-
for key, limit in (('title', 100), ('
|
|
172
|
+
for key, limit in (('title', 100), ('short_description', SHORT_DESCRIPTION_MAX),
|
|
173
|
+
('long_description', LONG_DESCRIPTION_MAX)):
|
|
166
174
|
if present(key) and isinstance(fields[key], str) and len(fields[key].strip()) > limit:
|
|
167
175
|
problems.append(_problem(key, f'must be at most {limit} characters'))
|
|
168
176
|
icon = fields.get('icon')
|
|
@@ -184,7 +192,8 @@ def canonical_category(value, categories):
|
|
|
184
192
|
|
|
185
193
|
def _catalog(fields):
|
|
186
194
|
catalog = {}
|
|
187
|
-
for key, api in (('kind', 'kind'), ('
|
|
195
|
+
for key, api in (('kind', 'kind'), ('short_description', 'shortDescription'),
|
|
196
|
+
('long_description', 'longDescription'),
|
|
188
197
|
('orientation', 'orientation')):
|
|
189
198
|
if not _blank(fields.get(key)):
|
|
190
199
|
catalog[api] = fields[key].strip() if isinstance(fields[key], str) else fields[key]
|
|
@@ -60,7 +60,7 @@ WORKFLOW = [
|
|
|
60
60
|
"deploy -f app.apk ... # upload + deploy a build (runnable in ChatGPT once live)",
|
|
61
61
|
"status # poll until it's live",
|
|
62
62
|
"mode [admin|personal] # nowrun admins: show/switch mode (admin = nowrun-managed apps, audited)",
|
|
63
|
-
"admin apps list ... # nowrun admins (admin mode): review apps, set-public/disable/..., users, audit",
|
|
63
|
+
"admin apps list ... # nowrun admins (admin mode): review apps, set-public/show-on-public-plugin/disable/..., users, audit",
|
|
64
64
|
]
|
|
65
65
|
|
|
66
66
|
|
|
@@ -244,7 +244,7 @@ def build_parser():
|
|
|
244
244
|
app_create_parser = app_sub.add_parser(
|
|
245
245
|
'create', help='Create a new app (every metadata field is required)', formatter_class=fmt,
|
|
246
246
|
description='Create an app. All metadata is required: title, category, icon, '
|
|
247
|
-
'description,
|
|
247
|
+
'short and long description, intents, kind and orientation (plus the package for '
|
|
248
248
|
'Android). Any of them can come from --data; '
|
|
249
249
|
'flags override it. In admin mode this creates a nowrun-managed app.')
|
|
250
250
|
app_create_parser.add_argument('-t', '--title', type=str, help='App title (required)')
|
|
@@ -329,8 +329,13 @@ def _metadata_args(p, required):
|
|
|
329
329
|
"""The app metadata flags shared by `app create` (all required) and `app update`."""
|
|
330
330
|
req = ' (required)' if required else ''
|
|
331
331
|
p.add_argument('--category', type=str, help=f'Category, one of `nowrun app categories` (case-insensitive){req}')
|
|
332
|
-
p.add_argument('--description',
|
|
333
|
-
|
|
332
|
+
p.add_argument('--short-description', dest='short_description', type=str,
|
|
333
|
+
help=f'One-line summary, up to 80 chars (ChatGPT short description){req}')
|
|
334
|
+
p.add_argument('--long-description', dest='long_description', type=str,
|
|
335
|
+
help=f'What the app is/does, up to 2000 chars (ChatGPT long description){req}')
|
|
336
|
+
# Deprecated aliases (pre-rename names), hidden from help but still accepted.
|
|
337
|
+
p.add_argument('--pitch', dest='short_description', type=str, help=argparse.SUPPRESS)
|
|
338
|
+
p.add_argument('--description', dest='long_description', type=str, help=argparse.SUPPRESS)
|
|
334
339
|
p.add_argument('--intent', dest='intents', action='append', metavar='PHRASE',
|
|
335
340
|
help='An intent phrase users might ask for, e.g. "play chess"; repeat for more'
|
|
336
341
|
+ (' (at least one required)' if required else ' (replaces the list)'))
|
|
@@ -338,14 +343,15 @@ def _metadata_args(p, required):
|
|
|
338
343
|
p.add_argument('--orientation', choices=['portrait', 'landscape'], help=f'Screen orientation{req}')
|
|
339
344
|
p.add_argument('--icon', type=str, help='Icon image: square PNG/JPEG/WebP, >=192px, <=1MB'
|
|
340
345
|
+ (' (required; or --from-apk extracts one)' if required else ''))
|
|
341
|
-
_data_arg(p, hint='any of the fields above as {"title", "category", "
|
|
346
|
+
_data_arg(p, hint='any of the fields above as {"title", "category", "shortDescription", '
|
|
347
|
+
'"longDescription", '
|
|
342
348
|
'"intents": [...], "kind", "orientation", "icon", ...}; flags override it')
|
|
343
349
|
|
|
344
350
|
|
|
345
351
|
def _admin_parsers(subparsers):
|
|
346
352
|
"""`nowrun admin apps|users|audit ...` (nowrun admins, admin mode only)."""
|
|
347
353
|
admin_parser = subparsers.add_parser(
|
|
348
|
-
'admin', help='nowrun admin
|
|
354
|
+
'admin', help='nowrun admin console: apps, users, audit (admin mode only)', formatter_class=fmt)
|
|
349
355
|
admin_sub = admin_parser.add_subparsers(title='admin commands', dest='admin_command')
|
|
350
356
|
|
|
351
357
|
def _paging(p):
|
|
@@ -367,6 +373,11 @@ def _admin_parsers(subparsers):
|
|
|
367
373
|
vis = ls.add_mutually_exclusive_group()
|
|
368
374
|
vis.add_argument('--public', dest='public', action='store_const', const=True, help='Only public apps')
|
|
369
375
|
vis.add_argument('--private', dest='public', action='store_const', const=False, help='Only private apps')
|
|
376
|
+
plug = ls.add_mutually_exclusive_group()
|
|
377
|
+
plug.add_argument('--on-public-plugin', dest='public_plugin', action='store_const', const=True,
|
|
378
|
+
help='Only apps the public plugin shows')
|
|
379
|
+
plug.add_argument('--off-public-plugin', dest='public_plugin', action='store_const', const=False,
|
|
380
|
+
help='Only apps the public plugin does not show')
|
|
370
381
|
ls.add_argument('--status', choices=['active', 'disabled', 'removed'], help='App status (default: not removed)')
|
|
371
382
|
ls.add_argument('--type', dest='game_type', choices=['android', 'h5'], help='App type')
|
|
372
383
|
ls.add_argument('--category', type=str, help='Category (exact)')
|
|
@@ -375,9 +386,11 @@ def _admin_parsers(subparsers):
|
|
|
375
386
|
show = apps_sub.add_parser('show', help='Any app, any status, with its owner', formatter_class=fmt)
|
|
376
387
|
show.add_argument('target_id', metavar='APP_ID', help='The app id')
|
|
377
388
|
helps = {
|
|
378
|
-
'set-public': '
|
|
379
|
-
'set-private': '
|
|
380
|
-
'
|
|
389
|
+
'set-public': 'Make apps public: anyone signed in can use them on their own ChatGPT link',
|
|
390
|
+
'set-private': 'Make apps private: only their owner and admins can use them (also off the public plugin)',
|
|
391
|
+
'show-on-public-plugin': 'Show public apps on the public plugin too',
|
|
392
|
+
'hide-from-public-plugin': 'Take apps off the public plugin (their own links keep working)',
|
|
393
|
+
'disable': 'Disable apps: off the public plugin and their links, read-only, no deploys (asks to confirm)',
|
|
381
394
|
'enable': 'Re-enable disabled apps',
|
|
382
395
|
'unpublish': 'Take the live deployment down (private; removed from ChatGPT; asks to confirm)',
|
|
383
396
|
'remove': 'Remove any apps: out of every list and the catalog, package freed, record kept (asks to confirm)',
|
|
@@ -442,8 +455,8 @@ def _app_metadata_flags(args):
|
|
|
442
455
|
'game_type': getattr(args, 'game_type', None),
|
|
443
456
|
'package': getattr(args, 'app_pkg_name', None),
|
|
444
457
|
'category': args.category,
|
|
445
|
-
'
|
|
446
|
-
'
|
|
458
|
+
'short_description': args.short_description,
|
|
459
|
+
'long_description': args.long_description,
|
|
447
460
|
'intents': args.intents,
|
|
448
461
|
'kind': args.kind,
|
|
449
462
|
'orientation': args.orientation,
|
|
@@ -459,7 +472,8 @@ def _dispatch_admin(args, groups):
|
|
|
459
472
|
sub = args.admin_apps_command
|
|
460
473
|
if sub == 'list':
|
|
461
474
|
admin_cmd.apps_list(q=args.q, owner_email=args.owner_email, owner_user_id=args.owner_user_id,
|
|
462
|
-
admin_managed=args.admin_managed, public=args.public,
|
|
475
|
+
admin_managed=args.admin_managed, public=args.public,
|
|
476
|
+
public_plugin=args.public_plugin, status=args.status,
|
|
463
477
|
game_type=args.game_type, category=args.category, readiness=args.readiness,
|
|
464
478
|
limit=args.limit, cursor=args.cursor, fetch_all=args.fetch_all)
|
|
465
479
|
elif sub == 'show':
|
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
"""`nowrun admin ...` - the nowrun admin
|
|
1
|
+
"""`nowrun admin ...` - the nowrun admin console from the CLI (admin mode only).
|
|
2
2
|
|
|
3
|
-
apps list/show and set-public|set-private|
|
|
3
|
+
apps list/show and set-public|set-private|show-on-public-plugin|hide-from-public-plugin|
|
|
4
|
+
disable|enable|unpublish; users list/show and
|
|
4
5
|
suspend|reactivate; audit. All under /v2/admin/*, which the server refuses outside admin mode
|
|
5
6
|
(ADMIN_MODE_REQUIRED) - the CLI checks the local mode first so the fix (`nowrun mode admin`)
|
|
6
7
|
is given before any request. Every change is audited server-side, one entry per item.
|
|
@@ -28,6 +29,8 @@ MAX_PAGES = 500 # safety stop for --all
|
|
|
28
29
|
APP_ACTIONS = {
|
|
29
30
|
'set-public': 'set_public',
|
|
30
31
|
'set-private': 'set_private',
|
|
32
|
+
'show-on-public-plugin': 'show_on_public_plugin',
|
|
33
|
+
'hide-from-public-plugin': 'hide_from_public_plugin',
|
|
31
34
|
'disable': 'disable',
|
|
32
35
|
'enable': 'enable',
|
|
33
36
|
'unpublish': 'unpublish',
|
|
@@ -182,7 +185,7 @@ def _print_results(d):
|
|
|
182
185
|
|
|
183
186
|
# --- apps -----------------------------------------------------------------------------
|
|
184
187
|
|
|
185
|
-
def apps_list(q=None, owner_email=None, owner_user_id=None, admin_managed=None, public=None,
|
|
188
|
+
def apps_list(q=None, owner_email=None, owner_user_id=None, admin_managed=None, public=None, public_plugin=None,
|
|
186
189
|
status=None, game_type=None, category=None, readiness=None, limit=None,
|
|
187
190
|
cursor=None, fetch_all=False):
|
|
188
191
|
if not require_admin_mode():
|
|
@@ -190,6 +193,7 @@ def apps_list(q=None, owner_email=None, owner_user_id=None, admin_managed=None,
|
|
|
190
193
|
gt = {'android': 'ANDROID_APP', 'h5': 'HTML5_APP'}.get(game_type, game_type)
|
|
191
194
|
params = {"q": q, "owner_email": owner_email, "owner_user_id": owner_user_id,
|
|
192
195
|
"admin_managed": _bool_param(admin_managed), "is_public": _bool_param(public),
|
|
196
|
+
"public_plugin": _bool_param(public_plugin),
|
|
193
197
|
"status": status, "game_type": gt, "category": category,
|
|
194
198
|
"readiness": readiness, "cursor": cursor}
|
|
195
199
|
data, ok = _paged('/v2/admin/apps', params, 'apps', fetch_all=fetch_all, limit=limit)
|
|
@@ -212,12 +216,14 @@ def _print_admin_apps(d):
|
|
|
212
216
|
if not apps:
|
|
213
217
|
logger.info("No apps match.")
|
|
214
218
|
else:
|
|
215
|
-
logger.info(f"{'APP_ID':<14}{'TITLE':<24}{'TYPE':<13}{'OWNER':<28}{'PUBLIC':<8}{'
|
|
219
|
+
logger.info(f"{'APP_ID':<14}{'TITLE':<24}{'TYPE':<13}{'OWNER':<28}{'PUBLIC':<8}{'PLUGIN':<8}"
|
|
220
|
+
f"{'STATUS':<10}READINESS")
|
|
216
221
|
for a in apps:
|
|
217
222
|
title = first_locale_value(a.get('app_title')) or a.get('app_pkg_name') or ''
|
|
218
223
|
readiness = (a.get('catalog_readiness') or {}).get('state', '')
|
|
219
224
|
logger.info(f"{str(a.get('app_id', '')):<14}{str(title)[:22]:<24}{str(a.get('game_type', '')):<13}"
|
|
220
225
|
f"{_owner(a)[:26]:<28}{('yes' if a.get('is_public') else 'no'):<8}"
|
|
226
|
+
f"{('yes' if a.get('public_plugin') else 'no'):<8}"
|
|
221
227
|
f"{str(a.get('status', '')):<10}{readiness}")
|
|
222
228
|
if d.get('next_cursor'):
|
|
223
229
|
logger.info(color(f"More: --cursor {d['next_cursor']} (or --all)", 'dim'))
|
|
@@ -239,14 +245,27 @@ def _print_admin_app(a):
|
|
|
239
245
|
logger.info(f"Owner : {_owner(a)}")
|
|
240
246
|
if a.get('created_by_email'):
|
|
241
247
|
logger.info(f"Created by: {a['created_by_email']}")
|
|
242
|
-
logger.info(
|
|
248
|
+
logger.info("Public : " + ("yes - anyone signed in can use it" if a.get('is_public')
|
|
249
|
+
else "no - only its owner and the admins can use it"))
|
|
250
|
+
logger.info(f"Plugin : {'on the public plugin' if a.get('public_plugin') else 'not on the public plugin'}")
|
|
243
251
|
status = a.get('status', '')
|
|
244
252
|
logger.info(f"Status : {status}" + (f" - {a.get('disabled_reason')}" if status == 'disabled' and a.get('disabled_reason') else ""))
|
|
245
253
|
if a.get('app_url'):
|
|
246
254
|
logger.info(f"Live URL : {a['app_url']}")
|
|
255
|
+
mcp = a.get('mcp') or {}
|
|
256
|
+
chatgpt = a.get('chatgpt') or {}
|
|
257
|
+
if 'chatgpt' in a:
|
|
258
|
+
from nowrun.commands.app import chatgpt_status_label # avoid an import cycle
|
|
259
|
+
logger.info(f"ChatGPT : {chatgpt_status_label(chatgpt.get('status'))}")
|
|
260
|
+
if a.get('mcp_url'):
|
|
261
|
+
logger.info(f"MCP URL : {a['mcp_url']}")
|
|
262
|
+
elif mcp.get('url'):
|
|
263
|
+
# Admins see the URL before it works; it answers 404 until testing is approved.
|
|
264
|
+
logger.info(f"MCP URL : {mcp['url']} (not active)")
|
|
247
265
|
readiness = a.get('catalog_readiness') or {}
|
|
248
266
|
if readiness:
|
|
249
|
-
logger.info(f"Readiness : {readiness.get('state')}"
|
|
267
|
+
logger.info(f"Readiness : {readiness.get('state')}"
|
|
268
|
+
+ (" (on the public plugin)" if readiness.get('listed') else ""))
|
|
250
269
|
for item in fieldmap.annotate(readiness.get('missing') or []):
|
|
251
270
|
logger.info(f" - {fieldmap.describe(item)}")
|
|
252
271
|
|
|
@@ -217,7 +217,7 @@ def update_app(app_id, flags, data=None):
|
|
|
217
217
|
lang_given = fields.pop('lang', None)
|
|
218
218
|
if not fields and not problems:
|
|
219
219
|
emit_error("Nothing to update.",
|
|
220
|
-
hint="Pass the fields to change, e.g. --description \"...\" --
|
|
220
|
+
hint="Pass the fields to change, e.g. --short-description \"...\" --long-description \"...\" "
|
|
221
221
|
"(see `nowrun app update -h`).")
|
|
222
222
|
return
|
|
223
223
|
problems += appmeta.check(fields, create=False)
|
|
@@ -387,18 +387,18 @@ def delete_app(app_id, assume_yes=False):
|
|
|
387
387
|
|
|
388
388
|
def visibility(app):
|
|
389
389
|
if app.get('is_public'):
|
|
390
|
-
return '
|
|
390
|
+
return 'public, on the public plugin' if (app.get('catalog_readiness') or {}).get('listed') else 'public'
|
|
391
391
|
return 'private'
|
|
392
392
|
|
|
393
393
|
|
|
394
394
|
def _print_created_app(app, bound=False):
|
|
395
395
|
app_id = app.get('app_id', '')
|
|
396
396
|
if app.get('admin_managed') or output.in_admin_mode():
|
|
397
|
-
logger.info(f"Created admin-managed app {app_id} ({app.get('game_type', '')}) - "
|
|
398
|
-
"public
|
|
397
|
+
logger.info(f"Created admin-managed app {app_id} ({app.get('game_type', '')}) - private; "
|
|
398
|
+
"make it public and show it on the public plugin with `nowrun admin apps ...`.")
|
|
399
399
|
else:
|
|
400
400
|
logger.info(f"Created app {app_id} ({app.get('game_type', '')}) - private; a nowrun admin "
|
|
401
|
-
"decides
|
|
401
|
+
"decides who can use it and whether the public plugin shows it.")
|
|
402
402
|
title = first_locale_value(app.get('app_title'))
|
|
403
403
|
if title:
|
|
404
404
|
logger.info(f"Title : {title}")
|
|
@@ -430,11 +430,44 @@ def _print_readiness(app):
|
|
|
430
430
|
if not isinstance(readiness, dict):
|
|
431
431
|
return
|
|
432
432
|
state = readiness.get('state', '')
|
|
433
|
-
logger.info(f"Readiness: {state}" + (" (
|
|
433
|
+
logger.info(f"Readiness: {state}" + (" (on the public plugin)" if readiness.get('listed') else ""))
|
|
434
434
|
for item in fieldmap.annotate(readiness.get('missing') or []):
|
|
435
435
|
logger.info(f" - {fieldmap.describe(item)}")
|
|
436
436
|
|
|
437
437
|
|
|
438
|
+
CHATGPT_STATUS_LABELS = {
|
|
439
|
+
'none': 'link turned off by nowrun',
|
|
440
|
+
'testing': 'not requested (test it with its MCP URL; request in the console)',
|
|
441
|
+
'in_review': 'publish request in review by nowrun',
|
|
442
|
+
'changes_requested': 'changes asked for by nowrun',
|
|
443
|
+
'submitted_to_openai': 'with OpenAI for review',
|
|
444
|
+
'published': 'live in the ChatGPT store',
|
|
445
|
+
}
|
|
446
|
+
|
|
447
|
+
|
|
448
|
+
def chatgpt_status_label(status):
|
|
449
|
+
"""The Publish to ChatGPT stage as the console names it."""
|
|
450
|
+
# No status (and the retired testing_requested) reads as testing, as on the server.
|
|
451
|
+
if not status or status == 'testing_requested':
|
|
452
|
+
status = 'testing'
|
|
453
|
+
return CHATGPT_STATUS_LABELS.get(status, status)
|
|
454
|
+
|
|
455
|
+
|
|
456
|
+
def _print_chatgpt(app):
|
|
457
|
+
"""
|
|
458
|
+
Where the app is in Publish to ChatGPT, and its MCP URL while the URL works
|
|
459
|
+
(from the first deploy, unless nowrun turned it off).
|
|
460
|
+
"""
|
|
461
|
+
chatgpt = app.get('chatgpt') or {}
|
|
462
|
+
if 'chatgpt' in app or 'mcp_url' in app:
|
|
463
|
+
logger.info(f"ChatGPT : {chatgpt_status_label(chatgpt.get('status'))}")
|
|
464
|
+
url = app.get('mcp_url') or chatgpt.get('mcp_url')
|
|
465
|
+
if url:
|
|
466
|
+
logger.info(f"MCP URL : {url}")
|
|
467
|
+
if chatgpt.get('review_note'):
|
|
468
|
+
logger.info(f"Review : {chatgpt['review_note']}")
|
|
469
|
+
|
|
470
|
+
|
|
438
471
|
def _print_app_detail(app):
|
|
439
472
|
title = first_locale_value(app.get('app_title'))
|
|
440
473
|
logger.info(f"App ID : {app.get('app_id', '')}")
|
|
@@ -454,8 +487,13 @@ def _print_app_detail(app):
|
|
|
454
487
|
if category:
|
|
455
488
|
logger.info(f"Category : {category}")
|
|
456
489
|
catalog = app.get('catalog') or {}
|
|
457
|
-
|
|
458
|
-
|
|
490
|
+
short_desc = catalog.get('shortDescription') or catalog.get('pitch')
|
|
491
|
+
if short_desc:
|
|
492
|
+
logger.info(f"Short desc: {short_desc}")
|
|
493
|
+
long_desc = catalog.get('longDescription') or catalog.get('blurb')
|
|
494
|
+
if long_desc:
|
|
495
|
+
logger.info(f"Long desc : {long_desc}")
|
|
459
496
|
if app.get('app_url'):
|
|
460
497
|
logger.info(f"Live URL : {app.get('app_url')}")
|
|
498
|
+
_print_chatgpt(app)
|
|
461
499
|
_print_readiness(app)
|
|
@@ -241,7 +241,7 @@ def cancel(app_id, submission_id=None):
|
|
|
241
241
|
|
|
242
242
|
def deployment_overview(app_id):
|
|
243
243
|
"""Show what is live and what is building for an app: the live version, any in-progress
|
|
244
|
-
build, and recent deployment history - the same view as the
|
|
244
|
+
build, and recent deployment history - the same view as the console's deploy panel."""
|
|
245
245
|
ok, body, http_status = StudioClient().request(
|
|
246
246
|
'GET', '/v2/console/app/deploy/status', params={'app_id': app_id})
|
|
247
247
|
if not ok:
|
|
@@ -4,8 +4,9 @@ Reads the app's `catalog_readiness` from the server ({state: unpublished|incompl
|
|
|
4
4
|
listed, missing[{field, reason}]}) and maps each missing field to the CLI flag that sets it.
|
|
5
5
|
`ready` means the app's metadata is complete and it isn't disabled - i.e. it can be deployed.
|
|
6
6
|
Publication items (no successful deploy / live URL yet) are reported but don't block that:
|
|
7
|
-
a deploy is what fixes them.
|
|
8
|
-
|
|
7
|
+
a deploy is what fixes them. Who can use an app (`is_public`) and whether nowrun's public
|
|
8
|
+
plugin shows it (`public_plugin`) are a nowrun admin's decisions; `listed` is whether the
|
|
9
|
+
public plugin shows it right now.
|
|
9
10
|
"""
|
|
10
11
|
from nowrun import appmeta
|
|
11
12
|
from nowrun import fields as fieldmap
|
|
@@ -21,8 +22,8 @@ def _legacy_missing(app):
|
|
|
21
22
|
'app_category': bool(first_locale_value(app.get('app_category'))),
|
|
22
23
|
'app_logo_url': bool(app.get('app_logo_url') or app.get('app_assets')),
|
|
23
24
|
'catalog.kind': bool(catalog.get('kind')),
|
|
24
|
-
'catalog.
|
|
25
|
-
'catalog.
|
|
25
|
+
'catalog.shortDescription': bool(catalog.get('shortDescription') or catalog.get('pitch')),
|
|
26
|
+
'catalog.longDescription': bool(catalog.get('longDescription') or catalog.get('blurb')),
|
|
26
27
|
'catalog.intents': bool(catalog.get('intents')),
|
|
27
28
|
'catalog.orientation': bool(catalog.get('orientation')),
|
|
28
29
|
}
|
|
@@ -78,10 +79,10 @@ def _print_validate(d):
|
|
|
78
79
|
logger.info(f" - {fieldmap.describe(item)}")
|
|
79
80
|
if d['missing']:
|
|
80
81
|
logger.info("Set the missing fields with `nowrun app update -a <app_id> ...` "
|
|
81
|
-
"(e.g. --description, --
|
|
82
|
+
"(e.g. --short-description, --long-description, --intent), then deploy.")
|
|
82
83
|
for item in d.get('publication') or []:
|
|
83
84
|
logger.info(f" · {fieldmap.describe(item)}")
|
|
84
85
|
if d.get('listed'):
|
|
85
|
-
logger.info("
|
|
86
|
+
logger.info("On nowrun's public plugin.")
|
|
86
87
|
elif d.get('is_public') is False:
|
|
87
|
-
logger.info("Private: a nowrun admin decides
|
|
88
|
+
logger.info("Private: a nowrun admin decides who can use it and whether the public plugin shows it.")
|
|
@@ -27,7 +27,7 @@ _CACHE_FILE = os.path.join(_CONFIG_DIR, 'cache')
|
|
|
27
27
|
_LOCK_FILE = os.path.join(_CONFIG_DIR, 'refresh.lock')
|
|
28
28
|
WORKSPACE_FILE = 'nowrun.json' # per-project app binding (stays in the cwd)
|
|
29
29
|
|
|
30
|
-
# nowrun-backend topology: the API is served at DOMAIN/api, the
|
|
30
|
+
# nowrun-backend topology: the API is served at DOMAIN/api, the console at DOMAIN/console.
|
|
31
31
|
PROD_HOST = 'https://nowrun.io/api'
|
|
32
32
|
LOCAL_HOST = 'http://localhost:3000/api'
|
|
33
33
|
|
|
@@ -36,8 +36,8 @@ LOCAL_HOST = 'http://localhost:3000/api'
|
|
|
36
36
|
# there are no named shorthands. See resolve_host.
|
|
37
37
|
DEFAULT_HOST = PROD_HOST
|
|
38
38
|
|
|
39
|
-
# API host -> console
|
|
40
|
-
# exceptions live here: local serves its
|
|
39
|
+
# API host -> console URL where `nowrun login` opens the browser. Only the
|
|
40
|
+
# exceptions live here: local serves its console on a different port. Every other
|
|
41
41
|
# host's console is DOMAIN/console, derived in console_url().
|
|
42
42
|
_CONSOLE_URLS = {
|
|
43
43
|
LOCAL_HOST: 'http://localhost:3002',
|
|
@@ -47,7 +47,7 @@ _cache = None
|
|
|
47
47
|
|
|
48
48
|
|
|
49
49
|
def console_url():
|
|
50
|
-
"""nowrun console
|
|
50
|
+
"""nowrun console URL for the current API host."""
|
|
51
51
|
host = get_host().rstrip('/')
|
|
52
52
|
if host in _CONSOLE_URLS:
|
|
53
53
|
return _CONSOLE_URLS[host]
|
|
@@ -68,7 +68,7 @@ def oauth_base():
|
|
|
68
68
|
|
|
69
69
|
|
|
70
70
|
def ui_host():
|
|
71
|
-
"""Base UI (
|
|
71
|
+
"""Base UI (console) URL for the current API host, e.g. https://qa.nowrun.io.
|
|
72
72
|
This is what we show users instead of the internal API host."""
|
|
73
73
|
from urllib.parse import urlsplit
|
|
74
74
|
u = urlsplit(console_url())
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
"""App field names as the server reports them, mapped to the CLI flag that sets them.
|
|
2
2
|
|
|
3
|
-
The backend names a missing/invalid field by its API path (`catalog.
|
|
3
|
+
The backend names a missing/invalid field by its API path (`catalog.longDescription`,
|
|
4
|
+
`app_logo_url`,
|
|
4
5
|
...) in `details.missing[{field, reason}]` (APP_INCOMPLETE / APP_INVALID) and in an app's
|
|
5
6
|
`catalog_readiness.missing`. Users and agents act on CLI flags, so every place that shows
|
|
6
7
|
those fields maps them through here.
|
|
@@ -15,8 +16,11 @@ FIELD_FLAGS = {
|
|
|
15
16
|
'default_app_language': '--lang',
|
|
16
17
|
'app_tier': '--tier',
|
|
17
18
|
'catalog.kind': '--kind',
|
|
18
|
-
'catalog.
|
|
19
|
-
'catalog.
|
|
19
|
+
'catalog.shortDescription': '--short-description',
|
|
20
|
+
'catalog.longDescription': '--long-description',
|
|
21
|
+
# Deprecated paths reported by older backends.
|
|
22
|
+
'catalog.pitch': '--short-description',
|
|
23
|
+
'catalog.blurb': '--long-description',
|
|
20
24
|
'catalog.intents': '--intent',
|
|
21
25
|
'catalog.orientation': '--orientation',
|
|
22
26
|
# Publication problems (catalog_readiness) are fixed by deploying, not by a flag.
|
|
@@ -60,7 +64,7 @@ def annotate(missing):
|
|
|
60
64
|
|
|
61
65
|
|
|
62
66
|
def describe(item):
|
|
63
|
-
"""One human line for a missing-field item: '--description (catalog.
|
|
67
|
+
"""One human line for a missing-field item: '--long-description (catalog.longDescription): reason'."""
|
|
64
68
|
field = item.get('field') or '?'
|
|
65
69
|
reason = item.get('reason') or 'invalid'
|
|
66
70
|
flag = item.get('flag') or flag_for(field)
|
|
@@ -246,11 +246,11 @@ def emit_error(message, http_status=None, code=None, detail=None, hint=None):
|
|
|
246
246
|
_CODE_GUIDANCE = {
|
|
247
247
|
'CARD_NOT_VERIFIED': (
|
|
248
248
|
"The account has no verified payment card yet, so deploying is blocked.",
|
|
249
|
-
"Ask the human to verify a card in the nowrun
|
|
249
|
+
"Ask the human to verify a card in the nowrun console (a $0 authorization, no charge "
|
|
250
250
|
"on the free plan), then retry. This is a one-time step before the first deploy."),
|
|
251
251
|
'APP_LIMIT_REACHED': (
|
|
252
252
|
"The account has reached its plan's limit on the number of apps, so a new app can't be created.",
|
|
253
|
-
"Ask the human to remove an unused app or upgrade the plan in the nowrun
|
|
253
|
+
"Ask the human to remove an unused app or upgrade the plan in the nowrun console, then "
|
|
254
254
|
"retry - do not keep retrying `app create`."),
|
|
255
255
|
'NOT_ADMIN': (
|
|
256
256
|
"This account is not a nowrun admin, so admin mode is not available.",
|
|
@@ -314,7 +314,7 @@ def _status_hint(http_status):
|
|
|
314
314
|
return {
|
|
315
315
|
400: "Invalid request - check the fields in `detail`.",
|
|
316
316
|
401: "Not signed in (token missing or expired) - ask the human to run `nowrun login`.",
|
|
317
|
-
402: "Payment required - the human must verify a card in the nowrun
|
|
317
|
+
402: "Payment required - the human must verify a card in the nowrun console before deploying.",
|
|
318
318
|
403: "Not authorized - your account lacks permission for this action (check `nowrun mode`), or the session is invalid; try `nowrun login` again.",
|
|
319
319
|
404: "Not found - verify the app_id / submission_id (in admin mode, console commands only see nowrun-managed apps).",
|
|
320
320
|
409: "Conflict - a matching resource/submission may already exist.",
|
|
@@ -8,7 +8,7 @@ description: Deploy and manage Android apps on nowrun using the `nowrun` CLI. Us
|
|
|
8
8
|
The `nowrun` CLI deploys **Android** apps (a compiled `.apk`, or an `.apk` inside a `.zip`)
|
|
9
9
|
to nowrun, so people can run them inside ChatGPT (and other AI assistants that connect to
|
|
10
10
|
nowrun). The human signs in once with `nowrun login` (browser); you operate the CLI, and the
|
|
11
|
-
human handles account setup and app configuration in the
|
|
11
|
+
human handles account setup and app configuration in the console.
|
|
12
12
|
|
|
13
13
|
## First: discover the tool (don't guess commands)
|
|
14
14
|
|
|
@@ -41,8 +41,8 @@ server in one step. You can't do this for them; just prompt them to run it and p
|
|
|
41
41
|
enter when done. There's no token to copy or paste - `nowrun login` is the only way in.
|
|
42
42
|
|
|
43
43
|
Run `nowrun logout` to sign out - it revokes this device's session on the server (so it
|
|
44
|
-
also disappears from the
|
|
45
|
-
human can likewise revoke any device from the
|
|
44
|
+
also disappears from the console's CLI sessions) and clears the local credentials. The
|
|
45
|
+
human can likewise revoke any device from the console (Settings -> CLI sessions); once
|
|
46
46
|
revoked, `nowrun whoami` reports the session is no longer valid.
|
|
47
47
|
|
|
48
48
|
The session stays signed in: access tokens refresh automatically (for 30 days after the last
|
|
@@ -88,7 +88,28 @@ Follow this sequence end to end; each step is expanded in the sections below.
|
|
|
88
88
|
`nowrun status -s <submission_id>` until it goes live (or pass `--wait`). Once live, the
|
|
89
89
|
app is runnable in ChatGPT. `nowrun status` (no `-s`) shows what's live and what's building;
|
|
90
90
|
`nowrun cancel` stops a build in progress so you can start another.
|
|
91
|
-
6. **
|
|
91
|
+
6. **Test and publish to ChatGPT** - done by the human in the console (the app page's
|
|
92
|
+
"Test on ChatGPT" and "Publish to ChatGPT" steps); you guide them and read progress with
|
|
93
|
+
`nowrun app show` (`ChatGPT` line):
|
|
94
|
+
1. *Test it* - once the app is live, `nowrun app show` prints its `MCP URL`. It only works
|
|
95
|
+
in ChatGPT on desktop (chatgpt.com or the desktop app, not the phone app). The human
|
|
96
|
+
opens Plugins, clicks Add in the top-right corner, then Add custom MCP server, names
|
|
97
|
+
it after the app, pastes the URL as the Server URL, accepts the warning and clicks
|
|
98
|
+
Create. ChatGPT then shows a Connect button with the app's name: they click it and
|
|
99
|
+
sign in to nowrun. In a new chat they type `@<app name>` and click Open on the card.
|
|
100
|
+
While the app is private only its owner and the nowrun team can use the URL; once
|
|
101
|
+
it's public, anyone with a nowrun account can.
|
|
102
|
+
2. *Request publishing* - in the console the human sends icons (dark, optional light),
|
|
103
|
+
starter prompts, screenshots, a demo video link and test prompts. The name and
|
|
104
|
+
descriptions come from the app's title and `--short-description` /
|
|
105
|
+
`--long-description`, so fix them with `nowrun app update`; nowrun fills in the policy
|
|
106
|
+
links and the test login.
|
|
107
|
+
3. *Review* - nowrun checks it, then approves and sends it to OpenAI, asks for changes,
|
|
108
|
+
or declines it.
|
|
109
|
+
4. *Live* - in the ChatGPT store, for anyone in ChatGPT.
|
|
110
|
+
If `nowrun app show` says changes were asked for, show the human the `Review` note.
|
|
111
|
+
This is not `nowrun mcp`, which is the docs MCP server for you.
|
|
112
|
+
7. **Delete (end of life)** - `nowrun app delete -a <app_id> --yes` permanently removes the
|
|
92
113
|
app and frees a plan app slot. Destructive and irreversible: only on an explicit user
|
|
93
114
|
request, and confirm the exact `app_id` first.
|
|
94
115
|
|
|
@@ -122,32 +143,34 @@ requires all of these (and `app update` changes any subset):
|
|
|
122
143
|
|------|------|
|
|
123
144
|
| `-t/--title` | App title |
|
|
124
145
|
| `--category` | One of `nowrun app categories` (case-insensitive) |
|
|
125
|
-
| `--description` |
|
|
126
|
-
| `--
|
|
146
|
+
| `--short-description` | One-line summary (up to 80 chars; ChatGPT's "Short description") |
|
|
147
|
+
| `--long-description` | What the app is/does (up to 2000 chars; ChatGPT's "Long description") |
|
|
127
148
|
| `--intent "phrase"` | What a user might ask for, e.g. `--intent "play chess"`; repeat, at least one |
|
|
128
149
|
| `--kind app\|game` | App or game |
|
|
129
150
|
| `--orientation portrait\|landscape` | Screen orientation |
|
|
130
151
|
| `--icon PATH` | Square PNG/JPEG/WebP, at least 192px, at most 1 MB (`--from-apk` extracts one) |
|
|
131
152
|
| `-p/--package` | Android package name (Android only; or `--from-apk`) |
|
|
132
153
|
|
|
133
|
-
Ask the human for anything you can't infer from the project (the
|
|
134
|
-
intents, and the icon especially) - don't invent marketing copy they haven't
|
|
154
|
+
Ask the human for anything you can't infer from the project (the short and long
|
|
155
|
+
descriptions, intents, and the icon especially) - don't invent marketing copy they haven't
|
|
135
156
|
approved. You can also pass the fields as JSON with `--data file.json` (keys: `title`,
|
|
136
|
-
`category`, `
|
|
137
|
-
override it.
|
|
157
|
+
`category`, `shortDescription`, `longDescription`, `intents`, `kind`, `orientation`, `icon`,
|
|
158
|
+
...); flags override it. `--pitch` / `--description` (and the `pitch` / `description` /
|
|
159
|
+
`blurb` JSON keys) are deprecated aliases that still work; use the new names.
|
|
138
160
|
|
|
139
161
|
```bash
|
|
140
162
|
nowrun app create -t "Chess Pro" -p com.foo.chess --category Board \
|
|
141
|
-
--description "
|
|
163
|
+
--short-description "Quick chess, right in chat" \
|
|
164
|
+
--long-description "Play chess against friends or the computer." \
|
|
142
165
|
--intent "play chess" --intent "chess puzzle" --kind game --orientation portrait \
|
|
143
166
|
--icon icon.png
|
|
144
|
-
nowrun app update --
|
|
167
|
+
nowrun app update --short-description "Now with puzzles" --intent "chess puzzle" # workspace app; only these change
|
|
145
168
|
```
|
|
146
169
|
|
|
147
170
|
If create/update fails with `APP_INCOMPLETE` or `APP_INVALID`, `error.detail.missing` lists
|
|
148
171
|
each field with its `reason` and the `flag` that fixes it - fix those and retry. A new app is
|
|
149
|
-
**private**:
|
|
150
|
-
(`app show` shows the visibility and readiness).
|
|
172
|
+
**private**: who can use it and whether nowrun's public plugin shows it are decided by a nowrun
|
|
173
|
+
admin, not by you (`app show` shows the visibility and readiness).
|
|
151
174
|
|
|
152
175
|
## What you do vs. what the human does
|
|
153
176
|
|
|
@@ -156,7 +179,9 @@ each field with its `reason` and the `flag` that fixes it - fix those and retry.
|
|
|
156
179
|
an app when asked (`nowrun app delete`).
|
|
157
180
|
- **Human:** creates the account and signs the CLI in with `nowrun login`. A **payment card
|
|
158
181
|
must be verified before the first deploy** (a $0 authorization, no charge on the free
|
|
159
|
-
plan) - the human does this in the nowrun
|
|
182
|
+
plan) - the human does this in the nowrun console. To try a live app before it is
|
|
183
|
+
listed, the human adds its `MCP URL` (from `nowrun app show`) to ChatGPT on desktop as a
|
|
184
|
+
custom MCP server (see lifecycle step 6). For SDK integration details, use the
|
|
160
185
|
**nowrun-docs MCP server** (`nowrun login` / `nowrun setup` install it).
|
|
161
186
|
|
|
162
187
|
Run `nowrun validate` first - it reports whether the app has every required field, naming
|
|
@@ -184,11 +209,11 @@ human; only a nowrun admin can re-enable it.
|
|
|
184
209
|
live; once live, the app is runnable in ChatGPT. Add `--wait` to have `deploy` block until it
|
|
185
210
|
settles (no polling loop needed).
|
|
186
211
|
If deploy fails with error code `CARD_NOT_VERIFIED` (HTTP 402), the human hasn't
|
|
187
|
-
verified a payment card yet - tell them to add one in the nowrun
|
|
212
|
+
verified a payment card yet - tell them to add one in the nowrun console (the error
|
|
188
213
|
message includes the link), then retry. This is required only once, before the first deploy.
|
|
189
214
|
- **See what's deployed / building:** `nowrun status` (no `-s`) shows the current live
|
|
190
215
|
version and URL, any build in progress, and recent deployment history for the app - the same
|
|
191
|
-
view as the
|
|
216
|
+
view as the console's deploy panel. Use `nowrun status -s <submission_id>` to check one
|
|
192
217
|
specific submission.
|
|
193
218
|
- **Cancel a deployment:** `nowrun cancel` stops the build in progress for the app so you can
|
|
194
219
|
start a new one (there's only one deployment per app at a time). Only one build can run at a
|
|
@@ -240,7 +265,7 @@ error object tells you what to do - act on it, don't just surface a raw code to
|
|
|
240
265
|
|
|
241
266
|
Common cases:
|
|
242
267
|
- **`CARD_NOT_VERIFIED` (402):** no verified payment card yet. Tell the human to add one in
|
|
243
|
-
the
|
|
268
|
+
the console (one-time, $0 authorization), then retry the deploy.
|
|
244
269
|
- **`APP_LIMIT_REACHED`:** the plan's app limit is reached. Tell the human to remove an app
|
|
245
270
|
or upgrade - don't keep retrying `app create`.
|
|
246
271
|
- **`APP_INCOMPLETE` / `APP_INVALID`:** fix each item in `detail.missing` (it names the flag).
|
|
@@ -269,7 +294,7 @@ Common cases:
|
|
|
269
294
|
`app_id`, and pass `--yes` when running non-interactively (it otherwise asks to confirm).
|
|
270
295
|
- **Admin tools are for nowrun admins only**, in admin mode, and only when the human asks:
|
|
271
296
|
`nowrun admin apps list [--q ... --owner-email ... --readiness ... --all]`,
|
|
272
|
-
`nowrun admin apps show <app_id>`, `nowrun admin apps set-public|set-private|disable|enable|unpublish <app_id>... [--reason ...] [--yes]`,
|
|
297
|
+
`nowrun admin apps show <app_id>`, `nowrun admin apps set-public|set-private|show-on-public-plugin|hide-from-public-plugin|disable|enable|unpublish <app_id>... [--reason ...] [--yes]`,
|
|
273
298
|
`nowrun admin apps remove <app_id>...` (any app: out of every list and the catalog, package
|
|
274
299
|
freed, record kept), `nowrun admin apps delete <app_id>...` (nowrun-managed apps only: erased
|
|
275
300
|
with their builds, **permanent**; a user's app fails with `NOT_ADMIN_MANAGED` - use `remove`),
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.1
|
|
2
2
|
Name: nowrun
|
|
3
|
-
Version: 2.0
|
|
3
|
+
Version: 2.1.0
|
|
4
4
|
Summary: CLI to deploy and manage Android and HTML5 apps on nowrun.
|
|
5
5
|
Home-page: https://nowrun.io
|
|
6
6
|
Author: nowrun
|
|
@@ -51,8 +51,8 @@ They're here for reference (and the occasional manual run):
|
|
|
51
51
|
| Command | Does |
|
|
52
52
|
|---------|------|
|
|
53
53
|
| `nowrun app categories` | the categories an app can have |
|
|
54
|
-
| `nowrun app create --title "My App" -p com.foo.bar --category Tools --description ... --
|
|
55
|
-
| `nowrun app update --
|
|
54
|
+
| `nowrun app create --title "My App" -p com.foo.bar --category Tools --short-description ... --long-description ... --intent ... --kind app --orientation portrait --icon icon.png` | create an app with its full listing - every field is required (or `--from-apk app.apk` to read the package and icon from the build; `--data app.json` to pass the fields as JSON) |
|
|
55
|
+
| `nowrun app update --short-description ... --icon icon.png` | change any of an app's metadata |
|
|
56
56
|
| `nowrun app list` / `nowrun app show` | list your apps / show one, with its visibility and readiness |
|
|
57
57
|
| `nowrun inspect app.apk` | read a build's package + version, no Android SDK needed |
|
|
58
58
|
| `nowrun validate` | check what's missing before deploying |
|
|
@@ -65,7 +65,8 @@ doesn't match the app**, so you never publish to the wrong place. It also **refu
|
|
|
65
65
|
code that isn't higher than the one currently live** (like the Play Store), so you can't ship a
|
|
66
66
|
downgrade. Add `--json` (in any position) to any command for machine-readable output.
|
|
67
67
|
|
|
68
|
-
New apps are private; a nowrun admin decides
|
|
68
|
+
New apps are private; a nowrun admin decides who can use each app and whether nowrun's public
|
|
69
|
+
plugin shows it.
|
|
69
70
|
You stay signed in: the CLI refreshes its session automatically (for 30 days after last use).
|
|
70
71
|
|
|
71
72
|
## nowrun admins
|
|
@@ -77,14 +78,14 @@ current one. Every command prints the active mode (`[ADMIN MODE] you@... - chang
|
|
|
77
78
|
audited` or `[personal] you@...`), and `--json` output carries a top-level `"mode"`.
|
|
78
79
|
|
|
79
80
|
In admin mode the regular `app` / `build` / `deploy` / `status` commands act on
|
|
80
|
-
**nowrun-managed apps** (owned by no user, public once deployed), and the admin
|
|
81
|
+
**nowrun-managed apps** (owned by no user, public once deployed), and the admin console is
|
|
81
82
|
available:
|
|
82
83
|
|
|
83
84
|
| Command | Does |
|
|
84
85
|
|---------|------|
|
|
85
86
|
| `nowrun admin apps list [--q ... --owner-email ... --admin-managed/--user-owned --public/--private --status ... --readiness ... --all]` | search every app |
|
|
86
87
|
| `nowrun admin apps show <app_id>` | any app, with its owner |
|
|
87
|
-
| `nowrun admin apps set-public\|set-private\|disable\|enable\|unpublish <app_id>... [--reason ...] [--yes]` | change
|
|
88
|
+
| `nowrun admin apps set-public\|set-private\|show-on-public-plugin\|hide-from-public-plugin\|disable\|enable\|unpublish <app_id>... [--reason ...] [--yes]` | change who can use apps, the public plugin, or status (bulk) |
|
|
88
89
|
| `nowrun admin apps remove <app_id>... [--reason ...] [--yes]` | remove any apps: out of every list and the catalog, package freed, record kept |
|
|
89
90
|
| `nowrun admin apps delete <app_id>... [--reason ...] [--yes]` | permanently erase nowrun-managed apps and their builds (cannot be undone; use `remove` for a user's app) |
|
|
90
91
|
| `nowrun admin apps fetch-apk -a <app_id> --url <link> [--expected-package <pkg>] [--deploy]` | download an APK from a link into the deploy bucket and report what it is; `--deploy` then deploys it (unreviewed third-party build) |
|
|
@@ -5,7 +5,7 @@ long_description = (this_directory / "README.md").read_text(encoding="utf-8")
|
|
|
5
5
|
|
|
6
6
|
setup(
|
|
7
7
|
name='nowrun',
|
|
8
|
-
version='v2.0
|
|
8
|
+
version='v2.1.0',
|
|
9
9
|
description='CLI to deploy and manage Android and HTML5 apps on nowrun.',
|
|
10
10
|
long_description=long_description,
|
|
11
11
|
long_description_content_type='text/markdown',
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|