summer-engine 4.6.0 → 4.8.0

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 (101) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +3 -2
  3. package/.codex-plugin/plugin.json +5 -4
  4. package/.cursor-plugin/plugin.json +4 -3
  5. package/.factory-plugin/plugin.json +4 -3
  6. package/CHANGELOG.md +37 -0
  7. package/README.md +3 -3
  8. package/commands/start.md +1 -1
  9. package/dist/cli/commands/api.d.ts +43 -0
  10. package/dist/cli/commands/api.js +191 -0
  11. package/dist/cli/commands/login.d.ts +2 -5
  12. package/dist/cli/commands/login.js +10 -81
  13. package/dist/cli/commands/token.d.ts +17 -0
  14. package/dist/cli/commands/token.js +25 -0
  15. package/dist/cli/index.js +4 -0
  16. package/dist/core/api-client.d.ts +5 -1
  17. package/dist/core/api-client.js +21 -0
  18. package/dist/core/capabilities/doctor.d.ts +1 -1
  19. package/dist/core/capabilities/doctor.js +1 -1
  20. package/dist/core/capabilities/game-task-plan.d.ts +2 -2
  21. package/dist/core/capabilities/navigation/open.d.ts +3 -0
  22. package/dist/core/capabilities/navigation/open.js +53 -0
  23. package/dist/core/capabilities/projects-local.js +2 -1
  24. package/dist/core/capabilities/runtime-control.d.ts +2 -2
  25. package/dist/core/capabilities/seeing/args.d.ts +4 -4
  26. package/dist/core/capabilities/tool-dispatch.js +37 -0
  27. package/dist/core/capabilities/ui-control.d.ts +2 -2
  28. package/dist/core/capabilities/view-set.d.ts +11 -0
  29. package/dist/core/capabilities/view-set.js +15 -0
  30. package/dist/core/capability-skew.d.ts +8 -0
  31. package/dist/core/capability-skew.js +18 -0
  32. package/dist/core/cli-session.d.ts +25 -0
  33. package/dist/core/cli-session.js +97 -0
  34. package/dist/core/engine-self-start.d.ts +20 -0
  35. package/dist/core/engine-self-start.js +108 -5
  36. package/dist/core/oauth.d.ts +15 -2
  37. package/dist/core/oauth.js +26 -3
  38. package/dist/core/ops/areas.d.ts +1 -1
  39. package/dist/core/ops/areas.js +5 -3
  40. package/dist/core/ops/engine-answer.js +5 -2
  41. package/dist/core/ops/engine.js +6 -0
  42. package/dist/core/ops/save-files.d.ts +2 -0
  43. package/dist/core/ops/save-files.js +13 -0
  44. package/dist/core/ops/studio-page.d.ts +22 -0
  45. package/dist/core/ops/studio-page.js +63 -0
  46. package/dist/core/sign-in-link.d.ts +38 -0
  47. package/dist/core/sign-in-link.js +106 -0
  48. package/dist/core/store.js +19 -1
  49. package/dist/core/summer-api.d.ts +114 -0
  50. package/dist/core/summer-api.js +281 -0
  51. package/dist/mcp/ops-surface.d.ts +3 -0
  52. package/dist/mcp/ops-surface.js +6 -0
  53. package/dist/mcp/server.js +16 -4
  54. package/dist/mcp/tool-results.d.ts +9 -0
  55. package/dist/mcp/tool-results.js +64 -0
  56. package/dist/mcp/tool-surface.js +7 -1
  57. package/dist/mcp/tools/api-tools.d.ts +50 -0
  58. package/dist/mcp/tools/api-tools.js +65 -0
  59. package/dist/mcp/tools/local-project-tools.d.ts +14 -0
  60. package/dist/mcp/tools/local-project-tools.js +13 -2
  61. package/dist/mcp/tools/navigation-tools.js +1 -0
  62. package/dist/mcp/tools/scene-tools.js +7 -0
  63. package/gemini-extension.json +3 -2
  64. package/library/references/mcp-tools-reference/mcp-tools-reference.md +15 -2
  65. package/library/references/mcp-tools-reference/resource.yaml +1 -1
  66. package/library/skills/README.md +6 -5
  67. package/library/skills/design-npc/SKILL.md +1 -1
  68. package/library/skills/design-npc/resource.yaml +2 -1
  69. package/library/skills/navigate-summer/SKILL.md +23 -2
  70. package/library/skills/navigate-summer/resource.yaml +5 -3
  71. package/library/skills/summer-api/SKILL.md +198 -0
  72. package/library/skills/summer-api/resource.yaml +38 -0
  73. package/library/skills/summer-assets/SKILL.md +1 -1
  74. package/library/skills/summer-assets/resource.yaml +3 -2
  75. package/library/skills/summer-router/SKILL.md +251 -0
  76. package/library/skills/summer-router/resource.yaml +35 -0
  77. package/library/tools/api-batch/resource.yaml +82 -0
  78. package/library/tools/api-estimate/resource.yaml +52 -0
  79. package/library/tools/api-job/resource.yaml +58 -0
  80. package/library/tools/api-models/resource.yaml +57 -0
  81. package/library/tools/api-run/resource.yaml +70 -0
  82. package/library/tools/view-set/GUIDE.md +3 -0
  83. package/library/tools/view-set/resource.yaml +78 -0
  84. package/package.json +3 -3
  85. package/registry/generated/aliases.json +7 -0
  86. package/registry/generated/counts.json +3 -3
  87. package/registry/generated/gemini-extension.json +3 -2
  88. package/registry/generated/index.json +316 -51
  89. package/registry/generated/marketplace.claude.json +1 -1
  90. package/registry/generated/plugin.claude-directory.json +4 -3
  91. package/registry/generated/plugin.claude.json +3 -2
  92. package/registry/generated/plugin.codex.json +5 -4
  93. package/registry/generated/plugin.cursor.json +4 -3
  94. package/registry/generated/plugin.factory.json +4 -3
  95. package/registry/generated/server.json +2 -2
  96. package/registry/generated/skills-index.md +6 -5
  97. package/registry/generated/skills-registry.json +29 -15
  98. package/registry/operations/legacy-names.json +30 -0
  99. package/registry/operations/public-catalog.json +9169 -4926
  100. package/library/skills/ai-characters-in-games/SKILL.md +0 -235
  101. package/library/skills/ai-characters-in-games/resource.yaml +0 -30
@@ -1,6 +1,6 @@
1
1
  # Summer skills
2
2
 
3
- > 132 skills, grouped by their primary domain. **Generated** by `npm run generate:registry` from each skill's `resource.yaml`; `--check` fails when this file and the library disagree. Do not edit by hand.
3
+ > 133 skills, grouped by their primary domain. **Generated** by `npm run generate:registry` from each skill's `resource.yaml`; `--check` fails when this file and the library disagree. Do not edit by hand.
4
4
 
5
5
  The folder is flat on purpose (`docs/design/DECISIONS.md`, D3): a skill usually belongs to several domains, so categories live in each skill's `facets.domains` and this index is rendered from them. The first domain listed is the primary one. `summer skills list --by-domain` prints the same grouping; `summer skills info <slug>` shows one skill.
6
6
 
@@ -13,7 +13,7 @@ Status: **stable** unless marked; *preview* = not yet exercised in-engine by the
13
13
  - [agent-workflow](#agent-workflow) (19)
14
14
  - [ai](#ai) (2)
15
15
  - [animation](#animation) (7)
16
- - [assets](#assets) (4)
16
+ - [assets](#assets) (5)
17
17
  - [audio](#audio) (6)
18
18
  - [character-controller](#character-controller) (2)
19
19
  - [creator](#creator) (7)
@@ -89,8 +89,8 @@ Status: **stable** unless marked; *preview* = not yet exercised in-engine by the
89
89
 
90
90
  | skill | when to use | also |
91
91
  |---|---|---|
92
- | [*ai-characters-in-games*](./ai-characters-in-games/SKILL.md) (preview) | Safe AI characters in published games: no keys in the build, Summer's player AI gateway, moderation, caps. | npc |
93
92
  | [design-npc](./design-npc/SKILL.md) ★ | Design enemy, NPC, boss or companion behavior: perception, state machine, telegraphs, script stub. | npc |
93
+ | [*summer-router*](./summer-router/SKILL.md) (preview) | AI characters for games on Summer Games: Summer Router replies, tools, speech, images. | npc, multiplayer |
94
94
 
95
95
  ## animation
96
96
 
@@ -111,7 +111,8 @@ Status: **stable** unless marked; *preview* = not yet exercised in-engine by the
111
111
  | [asset-strategy](./asset-strategy/SKILL.md) ★ | Route any 'I need a [thing]' asset request to the right skill: 2D, 3D, audio, video, VFX or animation. | pipeline |
112
112
  | [*lumera-single-image-scene-reconstruction*](./lumera-single-image-scene-reconstruction/SKILL.md) (preview) (library only) | Lumera-style single image to editable 3D scene — VLM-parsed object boxes and parametric lights, per-object meshes, HDR probe, .tscn assembly, refinement loop. | pipeline, 3d, scenes |
113
113
  | [*skintokens-auto-rigging*](./skintokens-auto-rigging/SKILL.md) (preview) (library only) | Offline auto-rigging with skin-tokens.cpp (GGML SkinTokens/TokenRig port) — skeleton and skin weights from a static GLB mesh on CPU/Vulkan, into Summer Engine. | pipeline, 3d, animation |
114
- | [summer-assets](./summer-assets/SKILL.md) | Make game assets with Summer, no Summer Engine: find, generate and download 3D models, images, audio and video for any engine or app. | agent-workflow |
114
+ | [*summer-api*](./summer-api/SKILL.md) (preview) | Summer API game assets: models, estimate, one job or a batch, download the files. | agent-workflow |
115
+ | [summer-assets](./summer-assets/SKILL.md) | Game assets for any engine, no Summer Engine: find, generate and download them. | agent-workflow |
115
116
 
116
117
  ## audio
117
118
 
@@ -207,7 +208,7 @@ Status: **stable** unless marked; *preview* = not yet exercised in-engine by the
207
208
 
208
209
  | skill | when to use | also |
209
210
  |---|---|---|
210
- | [navigate-summer](./navigate-summer/SKILL.md) ★ | Open a Summer web page or editor surface for the user (billing, their games, a scene) with studio.open. | agent-workflow, meta |
211
+ | [navigate-summer](./navigate-summer/SKILL.md) ★ | Open a Summer page or editor view for the person: studio.open, and engine.view_set while you work. | agent-workflow, meta |
211
212
 
212
213
  ## performance
213
214
 
@@ -42,19 +42,6 @@
42
42
  "agent-workflow"
43
43
  ]
44
44
  },
45
- {
46
- "id": "skill/ai-characters-in-games",
47
- "name": "ai-characters-in-games",
48
- "description": "Safe AI characters in published games: no keys in the build, Summer's player AI gateway, moderation, caps.",
49
- "clients": "all",
50
- "recommended": false,
51
- "status": "preview",
52
- "path": "library/skills/ai-characters-in-games/",
53
- "domains": [
54
- "ai",
55
- "npc"
56
- ]
57
- },
58
45
  {
59
46
  "id": "skill/ambient-bed",
60
47
  "name": "ambient-bed",
@@ -822,7 +809,7 @@
822
809
  {
823
810
  "id": "skill/navigate-summer",
824
811
  "name": "navigate-summer",
825
- "description": "Open a Summer web page or editor surface for the user (billing, their games, a scene) with studio.open.",
812
+ "description": "Open a Summer page or editor view for the person: studio.open, and engine.view_set while you work.",
826
813
  "clients": "all",
827
814
  "recommended": true,
828
815
  "status": "stable",
@@ -1268,6 +1255,19 @@
1268
1255
  "scripting"
1269
1256
  ]
1270
1257
  },
1258
+ {
1259
+ "id": "skill/summer-api",
1260
+ "name": "summer-api",
1261
+ "description": "Summer API game assets: models, estimate, one job or a batch, download the files.",
1262
+ "clients": "all",
1263
+ "recommended": false,
1264
+ "status": "preview",
1265
+ "path": "library/skills/summer-api/",
1266
+ "domains": [
1267
+ "assets",
1268
+ "agent-workflow"
1269
+ ]
1270
+ },
1271
1271
  {
1272
1272
  "id": "skill/summer-apps",
1273
1273
  "name": "summer-apps",
@@ -1298,7 +1298,7 @@
1298
1298
  {
1299
1299
  "id": "skill/summer-assets",
1300
1300
  "name": "summer-assets",
1301
- "description": "Make game assets with Summer, no Summer Engine: find, generate and download 3D models, images, audio and video for any engine or app.",
1301
+ "description": "Game assets for any engine, no Summer Engine: find, generate and download them.",
1302
1302
  "clients": "all",
1303
1303
  "recommended": false,
1304
1304
  "status": "stable",
@@ -1400,6 +1400,20 @@
1400
1400
  "scripting"
1401
1401
  ]
1402
1402
  },
1403
+ {
1404
+ "id": "skill/summer-router",
1405
+ "name": "summer-router",
1406
+ "description": "AI characters for games on Summer Games: Summer Router replies, tools, speech, images.",
1407
+ "clients": "all",
1408
+ "recommended": false,
1409
+ "status": "preview",
1410
+ "path": "library/skills/summer-router/",
1411
+ "domains": [
1412
+ "ai",
1413
+ "npc",
1414
+ "multiplayer"
1415
+ ]
1416
+ },
1403
1417
  {
1404
1418
  "id": "skill/summer-store",
1405
1419
  "name": "summer-store",
@@ -16,11 +16,36 @@
16
16
  "note": "",
17
17
  "op": "engine.align_distribute_3d"
18
18
  },
19
+ "summer_api_batch": {
20
+ "kind": "keep",
21
+ "note": "local: the Summer API (/v1) with the Summer sign-in on this computer",
22
+ "op": "models.batch"
23
+ },
19
24
  "summer_api_docs": {
20
25
  "kind": "keep",
21
26
  "note": "offline engine class reference",
22
27
  "op": "docs.engine_api"
23
28
  },
29
+ "summer_api_estimate": {
30
+ "kind": "keep",
31
+ "note": "local: the Summer API (/v1) with the Summer sign-in on this computer",
32
+ "op": "models.estimate"
33
+ },
34
+ "summer_api_job": {
35
+ "kind": "keep",
36
+ "note": "local: the Summer API (/v1) with the Summer sign-in on this computer",
37
+ "op": "models.job"
38
+ },
39
+ "summer_api_models": {
40
+ "kind": "keep",
41
+ "note": "local: the Summer API (/v1) with the Summer sign-in on this computer",
42
+ "op": "models.list"
43
+ },
44
+ "summer_api_run": {
45
+ "kind": "keep",
46
+ "note": "local: the Summer API (/v1) with the Summer sign-in on this computer",
47
+ "op": "models.run"
48
+ },
24
49
  "summer_app_call": {
25
50
  "kind": "same",
26
51
  "note": "generic executor: legacy and /mcp only, never in store profiles",
@@ -886,6 +911,11 @@
886
911
  "note": "",
887
912
  "op": "engine.select_node"
888
913
  },
914
+ "summer_view_set": {
915
+ "kind": "keep",
916
+ "note": "",
917
+ "op": "engine.view_set"
918
+ },
889
919
  "summer_set_prop": {
890
920
  "kind": "keep",
891
921
  "note": "",