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.
Files changed (35) hide show
  1. {nowrun-2.0.2 → nowrun-2.1.0}/PKG-INFO +7 -6
  2. {nowrun-2.0.2 → nowrun-2.1.0}/README.md +6 -5
  3. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/appmeta.py +17 -8
  4. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/cli.py +26 -12
  5. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/admin.py +25 -6
  6. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/app.py +46 -8
  7. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/deploy.py +1 -1
  8. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/validate.py +8 -7
  9. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/config.py +5 -5
  10. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/fields.py +8 -4
  11. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/output.py +3 -3
  12. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/skill/SKILL.md +44 -19
  13. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/PKG-INFO +7 -6
  14. {nowrun-2.0.2 → nowrun-2.1.0}/setup.py +1 -1
  15. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/__init__.py +0 -0
  16. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/__main__.py +0 -0
  17. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/apk.py +0 -0
  18. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/client.py +0 -0
  19. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/__init__.py +0 -0
  20. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/inspect.py +0 -0
  21. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/legacy.py +0 -0
  22. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/login.py +0 -0
  23. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/mcp.py +0 -0
  24. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/mode.py +0 -0
  25. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/setup.py +0 -0
  26. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/skill.py +0 -0
  27. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/commands/update.py +0 -0
  28. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/passthrough.py +0 -0
  29. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun/upload.py +0 -0
  30. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/SOURCES.txt +0 -0
  31. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/dependency_links.txt +0 -0
  32. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/entry_points.txt +0 -0
  33. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/requires.txt +0 -0
  34. {nowrun-2.0.2 → nowrun-2.1.0}/nowrun.egg-info/top_level.txt +0 -0
  35. {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.2
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 ... --pitch ... --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 --pitch ... --icon icon.png` | change any of an app's metadata |
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 which deployed apps are listed in ChatGPT.
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 panel is
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 visibility / status (bulk) |
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 ... --pitch ... --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 --pitch ... --icon icon.png` | change any of an app's metadata |
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 which deployed apps are listed in ChatGPT.
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 panel is
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 visibility / status (bulk) |
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
- 'description': 'catalog.blurb',
27
- 'pitch': 'catalog.pitch',
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
- ('description', 'a description is required'),
39
- ('pitch', 'a one-line pitch is required'),
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
- 'description': 'description', 'blurb': 'description',
52
- 'pitch': 'pitch',
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), ('pitch', 200), ('description', 500)):
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'), ('description', 'blurb'), ('pitch', 'pitch'),
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, pitch, intents, kind and orientation (plus the package for '
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', type=str, help=f'What the app is/does, up to 500 chars (catalog.blurb){req}')
333
- p.add_argument('--pitch', type=str, help=f'One-line pitch, up to 200 chars{req}')
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", "description", "pitch", '
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 panel: apps, users, audit (admin mode only)', formatter_class=fmt)
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': 'List apps in the ChatGPT catalog (must be deployed + complete)',
379
- 'set-private': 'Remove apps from the catalog listing',
380
- 'disable': 'Disable apps: out of the catalog, read-only, no deploys (asks to confirm)',
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
- 'description': args.description,
446
- 'pitch': args.pitch,
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, status=args.status,
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 panel from the CLI (admin mode only).
1
+ """`nowrun admin ...` - the nowrun admin console from the CLI (admin mode only).
2
2
 
3
- apps list/show and set-public|set-private|disable|enable|unpublish; users list/show and
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}{'STATUS':<10}READINESS")
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(f"Public : {'yes' if a.get('is_public') else 'no'}")
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')}" + (" (listed)" if readiness.get('listed') else ""))
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 \"...\" --pitch \"...\" "
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 'listed in ChatGPT' if (app.get('catalog_readiness') or {}).get('listed') else 'public'
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 once deployed.")
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 whether it's listed in ChatGPT.")
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}" + (" (listed in ChatGPT)" if readiness.get('listed') else ""))
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
- if catalog.get('pitch'):
458
- logger.info(f"Pitch : {catalog['pitch']}")
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 dashboard's deploy panel."""
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. Whether a deployed app is listed in ChatGPT is a nowrun admin's
8
- decision (`is_public`), shown as `listed`.
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.blurb': bool(catalog.get('blurb')),
25
- 'catalog.pitch': bool(catalog.get('pitch')),
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, --pitch, --intent), then deploy.")
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("Listed in ChatGPT.")
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 whether it's listed in ChatGPT.")
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 dashboard at DOMAIN/console.
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 (dashboard) URL where `nowrun login` opens the browser. Only the
40
- # exceptions live here: local serves its dashboard on a different port. Every other
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 (dashboard) URL for the current API host."""
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 (dashboard) URL for the current API host, e.g. https://qa.nowrun.io.
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.blurb`, `app_logo_url`,
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.blurb': '--description',
19
- 'catalog.pitch': '--pitch',
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.blurb): reason'."""
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 dashboard (a $0 authorization, no charge "
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 dashboard, then "
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 dashboard before deploying.",
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 dashboard.
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 dashboard's CLI sessions) and clears the local credentials. The
45
- human can likewise revoke any device from the dashboard (Settings -> CLI sessions); once
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. **Delete (end of life)** - `nowrun app delete -a <app_id> --yes` permanently removes the
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` | What the app is/does (up to 500 chars) |
126
- | `--pitch` | One-line pitch (up to 200 chars) |
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 description, pitch,
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`, `description`, `pitch`, `intents`, `kind`, `orientation`, `icon`, ...); flags
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 "Play chess against friends or the computer." --pitch "Quick chess, right in chat" \
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 --pitch "Now with puzzles" --intent "chess puzzle" # workspace app; only these change
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**: whether it is listed in ChatGPT is decided by a nowrun admin, not by you
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 dashboard. For SDK integration details, use the
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 dashboard (the error
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 dashboard's deploy panel. Use `nowrun status -s <submission_id>` to check one
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 dashboard (one-time, $0 authorization), then retry the deploy.
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.2
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 ... --pitch ... --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 --pitch ... --icon icon.png` | change any of an app's metadata |
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 which deployed apps are listed in ChatGPT.
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 panel is
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 visibility / status (bulk) |
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.2',
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