spriteforge 0.1.1__py3-none-any.whl

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 (218) hide show
  1. spriteforge/__init__.py +1 -0
  2. spriteforge/__main__.py +3 -0
  3. spriteforge/agents/__init__.py +0 -0
  4. spriteforge/agents/assets.py +109 -0
  5. spriteforge/agents/cancellation.py +12 -0
  6. spriteforge/agents/director.py +50 -0
  7. spriteforge/agents/models.py +63 -0
  8. spriteforge/agents/roles/art-director.md +15 -0
  9. spriteforge/agents/roles/art-reviewer.md +14 -0
  10. spriteforge/agents/roles/director.md +14 -0
  11. spriteforge/agents/roles/game-designer.md +15 -0
  12. spriteforge/agents/roles/level-tile-designer.md +16 -0
  13. spriteforge/agents/roles/librarian.md +13 -0
  14. spriteforge/agents/roles/menu-designer.md +15 -0
  15. spriteforge/agents/roles/pixel-artist.md +14 -0
  16. spriteforge/agents/roles/programmer.md +14 -0
  17. spriteforge/agents/roles/qa-playtester.md +13 -0
  18. spriteforge/agents/roles/sound-director.md +14 -0
  19. spriteforge/agents/roles.py +39 -0
  20. spriteforge/agents/router.py +233 -0
  21. spriteforge/agents/router_eval.py +145 -0
  22. spriteforge/agents/routing_state.py +133 -0
  23. spriteforge/agents/runtime.py +430 -0
  24. spriteforge/agents/workflow.py +389 -0
  25. spriteforge/app/__init__.py +0 -0
  26. spriteforge/app/agents_view.py +248 -0
  27. spriteforge/app/chat.py +114 -0
  28. spriteforge/app/extensions.py +115 -0
  29. spriteforge/app/index.html +279 -0
  30. spriteforge/app/local_only.py +49 -0
  31. spriteforge/app/server.py +358 -0
  32. spriteforge/app/static/assets/index-L2s1wlcp.css +1 -0
  33. spriteforge/app/static/assets/index-aBfzgLQl.js +71 -0
  34. spriteforge/app/static/assets/press-start-2p-latin-400-normal-BKfmdmKK.woff +0 -0
  35. spriteforge/app/static/assets/press-start-2p-latin-400-normal-xj9lRvVs.woff2 +0 -0
  36. spriteforge/app/static/index.html +13 -0
  37. spriteforge/app/static/press-start-2p-LICENSE.txt +93 -0
  38. spriteforge/app/studio.py +278 -0
  39. spriteforge/app/workers.py +73 -0
  40. spriteforge/cli.py +241 -0
  41. spriteforge/config.py +193 -0
  42. spriteforge/config.yaml +157 -0
  43. spriteforge/core/__init__.py +0 -0
  44. spriteforge/core/acting.py +16 -0
  45. spriteforge/core/cost.py +236 -0
  46. spriteforge/core/credentials.py +24 -0
  47. spriteforge/core/demo.py +79 -0
  48. spriteforge/core/forms.py +20 -0
  49. spriteforge/core/gates.py +175 -0
  50. spriteforge/core/security.py +42 -0
  51. spriteforge/core/state.py +222 -0
  52. spriteforge/core/team.py +15 -0
  53. spriteforge/core/usage.py +68 -0
  54. spriteforge/game/__init__.py +0 -0
  55. spriteforge/game/actors.py +377 -0
  56. spriteforge/game/agent_tools.py +178 -0
  57. spriteforge/game/art.py +2097 -0
  58. spriteforge/game/art_checks.py +190 -0
  59. spriteforge/game/art_review.py +518 -0
  60. spriteforge/game/build.py +134 -0
  61. spriteforge/game/bundle.py +1178 -0
  62. spriteforge/game/cli.py +119 -0
  63. spriteforge/game/codegen.py +433 -0
  64. spriteforge/game/codeinfo.py +154 -0
  65. spriteforge/game/dbsource.py +137 -0
  66. spriteforge/game/design.py +342 -0
  67. spriteforge/game/export.py +62 -0
  68. spriteforge/game/gamedb.py +191 -0
  69. spriteforge/game/image_cache.py +61 -0
  70. spriteforge/game/lessons.py +259 -0
  71. spriteforge/game/level_gen.py +118 -0
  72. spriteforge/game/level_preview.py +97 -0
  73. spriteforge/game/levels.py +934 -0
  74. spriteforge/game/loops.py +38 -0
  75. spriteforge/game/menus.py +712 -0
  76. spriteforge/game/mock_game.js +109 -0
  77. spriteforge/game/mock_platformer.js +58 -0
  78. spriteforge/game/motion.py +881 -0
  79. spriteforge/game/pipeline.py +1768 -0
  80. spriteforge/game/plan.py +502 -0
  81. spriteforge/game/playtest.py +318 -0
  82. spriteforge/game/qa.py +664 -0
  83. spriteforge/game/qa_checks.py +223 -0
  84. spriteforge/game/qa_runtime.py +565 -0
  85. spriteforge/game/reach.py +807 -0
  86. spriteforge/game/record.py +138 -0
  87. spriteforge/game/research.py +262 -0
  88. spriteforge/game/revision.py +225 -0
  89. spriteforge/game/sdk/API.md +104 -0
  90. spriteforge/game/sdk/FLOW.md +19 -0
  91. spriteforge/game/sdk/LEVELS.md +65 -0
  92. spriteforge/game/sdk/sf.js +418 -0
  93. spriteforge/game/sdk/sfflow.js +442 -0
  94. spriteforge/game/sdk/sflevel.js +683 -0
  95. spriteforge/game/sdk/sfsound-editor.js +225 -0
  96. spriteforge/game/sdk/sfsound.js +260 -0
  97. spriteforge/game/sdk/sounds.html +67 -0
  98. spriteforge/game/sounds.py +793 -0
  99. spriteforge/game/story.py +188 -0
  100. spriteforge/game/structure.py +98 -0
  101. spriteforge/game/team_reports.py +394 -0
  102. spriteforge/game/tilesets.py +70 -0
  103. spriteforge/game/title_art.py +186 -0
  104. spriteforge/genres/__init__.py +0 -0
  105. spriteforge/library/__init__.py +15 -0
  106. spriteforge/library/cli.py +126 -0
  107. spriteforge/library/describe.py +242 -0
  108. spriteforge/library/looks.py +154 -0
  109. spriteforge/library/models.py +79 -0
  110. spriteforge/library/store.py +422 -0
  111. spriteforge/library/tilesets/README.md +32 -0
  112. spriteforge/library/tilesets/gandalf-seasons.json +111 -0
  113. spriteforge/library/tilesets/pixel-crawler-dungeon.json +66 -0
  114. spriteforge/mcp/__init__.py +0 -0
  115. spriteforge/mcp/cli.py +58 -0
  116. spriteforge/mcp/client.py +57 -0
  117. spriteforge/mcp/filesystem_read.py +32 -0
  118. spriteforge/mcp/gamedb.py +56 -0
  119. spriteforge/mcp/library.py +179 -0
  120. spriteforge/mcp/memory.py +37 -0
  121. spriteforge/mcp/pixel_tools.py +145 -0
  122. spriteforge/mcp/registry.py +145 -0
  123. spriteforge/mcp/service.py +224 -0
  124. spriteforge/mcp/templates/context7.json +6 -0
  125. spriteforge/mcp/templates/fetch.json +6 -0
  126. spriteforge/mcp/templates/filesystem-read.json +6 -0
  127. spriteforge/mcp/templates/pixel-tools.json +6 -0
  128. spriteforge/memory/README.md +10 -0
  129. spriteforge/memory/__init__.py +0 -0
  130. spriteforge/memory/cli.py +131 -0
  131. spriteforge/memory/okf/__init__.py +1 -0
  132. spriteforge/memory/okf/catalog.py +331 -0
  133. spriteforge/memory/okf/codec.py +63 -0
  134. spriteforge/memory/okf/git.py +104 -0
  135. spriteforge/memory/okf/indexes.py +50 -0
  136. spriteforge/memory/okf/models.py +114 -0
  137. spriteforge/memory/okf/search.py +53 -0
  138. spriteforge/memory/okf/seed.py +81 -0
  139. spriteforge/memory/okf/seeds/genres.yaml +121 -0
  140. spriteforge/memory/okf/seeds/other.yaml +150 -0
  141. spriteforge/memory/okf/store.py +402 -0
  142. spriteforge/memory/okf/validate.py +115 -0
  143. spriteforge/pixel/__init__.py +17 -0
  144. spriteforge/pixel/atlas.py +110 -0
  145. spriteforge/pixel/grid.py +174 -0
  146. spriteforge/pixel/palette.py +156 -0
  147. spriteforge/pixel/palettes/dungeon.json +9 -0
  148. spriteforge/pixel/postprocess.py +170 -0
  149. spriteforge/pixel/preview.py +40 -0
  150. spriteforge/pixel/schemas.py +139 -0
  151. spriteforge/pixel/source.py +237 -0
  152. spriteforge/pixel/terrain.py +48 -0
  153. spriteforge/pixel/validate.py +138 -0
  154. spriteforge/prompts/anim_frame.txt +1 -0
  155. spriteforge/prompts/character.txt +1 -0
  156. spriteforge/prompts/item.txt +1 -0
  157. spriteforge/prompts/tile.txt +1 -0
  158. spriteforge/prompts/ui.txt +1 -0
  159. spriteforge/providers/__init__.py +0 -0
  160. spriteforge/providers/base.py +97 -0
  161. spriteforge/providers/http.py +38 -0
  162. spriteforge/providers/mock.py +111 -0
  163. spriteforge/providers/muse_image.py +60 -0
  164. spriteforge/providers/muse_search.py +91 -0
  165. spriteforge/providers/muse_spark.py +66 -0
  166. spriteforge/skills/__init__.py +0 -0
  167. spriteforge/skills/builtin/LICENSE-awesome-gamedev-agent-skills.txt +201 -0
  168. spriteforge/skills/builtin/NOTICE-awesome-gamedev-agent-skills.txt +15 -0
  169. spriteforge/skills/builtin/THIRD_PARTY.md +21 -0
  170. spriteforge/skills/builtin/audio-design/SKILL.md +190 -0
  171. spriteforge/skills/builtin/game-feel/SKILL.md +174 -0
  172. spriteforge/skills/builtin/game-ui-ux/SKILL.md +167 -0
  173. spriteforge/skills/builtin/level-design/SKILL.md +169 -0
  174. spriteforge/skills/builtin/phaser-arcade-physics/SKILL.md +17 -0
  175. spriteforge/skills/builtin/physics-tuning/SKILL.md +164 -0
  176. spriteforge/skills/builtin/pixel-art-prompting/SKILL.md +12 -0
  177. spriteforge/skills/builtin/platformer/SKILL.md +153 -0
  178. spriteforge/skills/builtin/puzzle/SKILL.md +143 -0
  179. spriteforge/skills/builtin/sprite-animation-frames/SKILL.md +11 -0
  180. spriteforge/skills/builtin/tileset-design/SKILL.md +10 -0
  181. spriteforge/skills/catalog.py +200 -0
  182. spriteforge/skills/cli.py +41 -0
  183. spriteforge/stages/__init__.py +0 -0
  184. spriteforge/stages/asset_context.py +301 -0
  185. spriteforge/stages/asset_models.py +192 -0
  186. spriteforge/stages/asset_render.py +366 -0
  187. spriteforge/stages/asset_review.py +140 -0
  188. spriteforge/stages/asset_store.py +94 -0
  189. spriteforge/stages/chat_changes.py +236 -0
  190. spriteforge/stages/concept.py +42 -0
  191. spriteforge/stages/game.py +1699 -0
  192. spriteforge/stages/game_confirm.py +112 -0
  193. spriteforge/stages/game_final.py +220 -0
  194. spriteforge/stages/game_record.py +246 -0
  195. spriteforge/stages/gameplay.py +218 -0
  196. spriteforge/stages/intake.py +372 -0
  197. spriteforge/stages/preview_assets.py +212 -0
  198. spriteforge/stages/preview_models.py +167 -0
  199. spriteforge/stages/preview_render.py +169 -0
  200. spriteforge/stages/preview_repair.py +61 -0
  201. spriteforge/stages/preview_review.py +169 -0
  202. spriteforge/stages/production.py +170 -0
  203. spriteforge/stages/references.py +105 -0
  204. spriteforge/stages/rewind.py +128 -0
  205. spriteforge/stages/workflow.py +440 -0
  206. spriteforge/templates/phaser/audit.js +45 -0
  207. spriteforge/templates/phaser/font.png +0 -0
  208. spriteforge/templates/phaser/font.xml +1 -0
  209. spriteforge/templates/phaser/preview.html +9 -0
  210. spriteforge/templates/phaser/room.js +49 -0
  211. spriteforge/templates/phaser/vendor/LICENSE.md +20 -0
  212. spriteforge/templates/phaser/vendor/phaser.min.js +1 -0
  213. spriteforge-0.1.1.dist-info/METADATA +364 -0
  214. spriteforge-0.1.1.dist-info/RECORD +218 -0
  215. spriteforge-0.1.1.dist-info/WHEEL +5 -0
  216. spriteforge-0.1.1.dist-info/entry_points.txt +2 -0
  217. spriteforge-0.1.1.dist-info/licenses/LICENSE +27 -0
  218. spriteforge-0.1.1.dist-info/top_level.txt +1 -0
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: sprite-animation-frames
3
+ description: Plan consistent pixel sprite animation frames, registration points, timing and atlas keys.
4
+ ---
5
+ Keep canvas, palette, light direction and foot pivot fixed across frames. Plan key
6
+ poses before in-betweens: contact, passing, recoil and anticipation must be readable
7
+ at native resolution. Reuse the accepted character as the reference for pose edits.
8
+ Inspect the animation loop for foot sliding, silhouette jitter, accidental size
9
+ changes and duplicate holds. Specify durations and stable keys such as hero/walk/0.
10
+ Validate atlas metadata against actual packed keys. A contact sheet supplements,
11
+ but does not replace, playback. Never regenerate unrelated accepted frames.
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: tileset-design
3
+ description: Design coherent 16x16 terrain tiles with readable collision edges and repeatable seams.
4
+ ---
5
+ Start from the approved palette, perspective and lighting. Enumerate floor, edge,
6
+ inner corner, outer corner and transition tiles before drawing variations. Keep
7
+ walkable ground quieter than actors. Use a tile adjacency table and assemble a
8
+ 3x3 repeated preview to check seams in both axes. Collision belongs to explicit
9
+ tile metadata, not guessed pixel colors. Avoid unique features on every tile;
10
+ place rare props separately. Preserve tile IDs when revising a targeted seam.
@@ -0,0 +1,200 @@
1
+ """Workspace skill installation and role-scoped progressive disclosure."""
2
+
3
+ import shutil
4
+ import subprocess
5
+ import tempfile
6
+ from pathlib import Path
7
+
8
+ import yaml
9
+ from pydantic import BaseModel, ConfigDict, Field
10
+
11
+ from spriteforge.core.security import redact
12
+ from spriteforge.memory.okf.git import write_lock
13
+
14
+
15
+ class SkillHeader(BaseModel):
16
+ model_config = ConfigDict(extra="allow")
17
+ name: str = Field(pattern=r"^[a-z0-9][a-z0-9-]{0,62}$")
18
+ description: str = Field(min_length=1, max_length=4096)
19
+
20
+
21
+ class Skill(BaseModel):
22
+ header: SkillHeader
23
+ directory: Path
24
+ body: str
25
+
26
+
27
+ class Grants(BaseModel):
28
+ roles: dict[str, list[str]] = Field(default_factory=dict)
29
+
30
+
31
+ def read_skill(directory: Path) -> Skill:
32
+ if directory.is_symlink():
33
+ raise ValueError("Skill directories cannot be symlinks")
34
+ directory = directory.resolve()
35
+ for path in directory.rglob("*"):
36
+ if path.is_symlink() or not path.resolve().is_relative_to(directory):
37
+ raise ValueError("Skill resources must stay inside the skill folder")
38
+ text = (directory / "SKILL.md").read_text(encoding="utf-8-sig")
39
+ if not text.startswith("---\n"):
40
+ raise ValueError("SKILL.md requires YAML frontmatter")
41
+ _, front, body = text.split("---", 2)
42
+ header = SkillHeader.model_validate(yaml.safe_load(front))
43
+ if not body.strip():
44
+ raise ValueError("Skill body must not be empty")
45
+ if redact(text) != text:
46
+ raise ValueError("Skill contains a credential from the environment")
47
+ return Skill(header=header, directory=directory, body=body.strip())
48
+
49
+
50
+ class SkillCatalog:
51
+ def __init__(self, workspace: Path):
52
+ self.workspace = workspace.resolve()
53
+ self.root = self.workspace / "skills"
54
+ self.root.mkdir(parents=True, exist_ok=True)
55
+ self.grants_path = self.workspace / "skill-grants.json"
56
+
57
+ def all(self):
58
+ result = {}
59
+ for root in (Path(__file__).with_name("builtin"), self.root):
60
+ for path in sorted(root.glob("*/SKILL.md")):
61
+ skill = read_skill(path.parent)
62
+ if skill.header.name in result:
63
+ raise ValueError(f"Duplicate skill: {skill.header.name}")
64
+ result[skill.header.name] = skill
65
+ return result
66
+
67
+ def grants(self):
68
+ return (
69
+ Grants.model_validate_json(self.grants_path.read_text())
70
+ if self.grants_path.exists()
71
+ else Grants()
72
+ )
73
+
74
+ def available(self, role):
75
+ allowed = set(role.allowed_skills) | set(self.grants().roles.get(role.name, []))
76
+ return {n: s for n, s in self.all().items() if n in allowed}
77
+
78
+ def summaries(self, role):
79
+ return [
80
+ {"name": n, "description": s.header.description}
81
+ for n, s in self.available(role).items()
82
+ ]
83
+
84
+ def headers(self, role):
85
+ """Read only frontmatter for routing; never read unselected bodies."""
86
+ allowed = set(role.allowed_skills) | set(self.grants().roles.get(role.name, []))
87
+ result = {}
88
+ for root in (Path(__file__).with_name("builtin"), self.root):
89
+ for path in sorted(root.glob("*/SKILL.md")):
90
+ if path.is_symlink() or path.parent.is_symlink():
91
+ raise ValueError("Skill resources cannot be symlinks")
92
+ with path.open(encoding="utf-8-sig") as stream:
93
+ if stream.readline().strip() != "---":
94
+ raise ValueError("SKILL.md requires YAML frontmatter")
95
+ lines = []
96
+ for line in stream:
97
+ if line.strip() == "---":
98
+ break
99
+ lines.append(line)
100
+ if sum(map(len, lines)) > 16384:
101
+ raise ValueError("Skill frontmatter too large")
102
+ else:
103
+ raise ValueError("Unterminated skill frontmatter")
104
+ header = SkillHeader.model_validate(yaml.safe_load("".join(lines)))
105
+ if header.name in allowed:
106
+ if header.name in result:
107
+ raise ValueError(f"Duplicate skill: {header.name}")
108
+ result[header.name] = (header, path.parent)
109
+ return result
110
+
111
+ def load(self, role, name, resource="SKILL.md"):
112
+ skills = self.headers(role)
113
+ if name not in skills:
114
+ raise PermissionError(f"Skill not allowed: {name}")
115
+ skill = read_skill(skills[name][1])
116
+ if resource == "SKILL.md":
117
+ return skill.body
118
+ path = (skill.directory / resource).resolve()
119
+ if not path.is_relative_to(skill.directory) or Path(resource).parts[0] not in {
120
+ "references",
121
+ "scripts",
122
+ "assets",
123
+ }:
124
+ raise ValueError("Only skill references and scripts may be read")
125
+ return path.read_text(encoding="utf-8") # Never execute bundled scripts.
126
+
127
+ def add(self, source: str, role="Pixel Artist", subdir="", revision: str | None = None):
128
+ from spriteforge.agents.roles import load_roles
129
+
130
+ if role not in load_roles():
131
+ raise ValueError("Unknown role")
132
+ with tempfile.TemporaryDirectory(dir=self.workspace) as temp:
133
+ if source.startswith("https://"):
134
+ from urllib.parse import urlsplit
135
+
136
+ url = urlsplit(source)
137
+ if url.username or url.password or url.query or url.fragment:
138
+ raise ValueError("Use a credential-free Git URL")
139
+ checkout = Path(temp) / "checkout"
140
+ result = subprocess.run(
141
+ [
142
+ "git",
143
+ "-c",
144
+ "core.hooksPath=/dev/null",
145
+ "clone",
146
+ "--depth",
147
+ "1",
148
+ "--",
149
+ source,
150
+ str(checkout),
151
+ ],
152
+ capture_output=True,
153
+ text=True,
154
+ check=False,
155
+ )
156
+ if result.returncode:
157
+ raise ValueError(redact(result.stderr))
158
+ if revision:
159
+ for args in (
160
+ ["fetch", "--depth", "1", "origin", revision],
161
+ ["checkout", "--detach", "FETCH_HEAD"],
162
+ ):
163
+ result = subprocess.run(
164
+ ["git", "-C", str(checkout), *args],
165
+ capture_output=True,
166
+ text=True,
167
+ check=False,
168
+ )
169
+ if result.returncode:
170
+ raise ValueError(redact(result.stderr))
171
+ else:
172
+ checkout = Path(source).resolve()
173
+ directory = (checkout / subdir).resolve()
174
+ if not directory.is_relative_to(checkout.resolve()):
175
+ raise ValueError("Skill subdirectory escapes source")
176
+ skill = read_skill(directory)
177
+ with write_lock(self.workspace / ".skills.lock"):
178
+ if skill.header.name in self.all():
179
+ raise ValueError(
180
+ "Skill already installed; remove it explicitly before replacing"
181
+ )
182
+ target = self.root / skill.header.name
183
+ shutil.copytree(
184
+ directory, target, ignore=shutil.ignore_patterns(".git", "__pycache__")
185
+ )
186
+ grants = self.grants()
187
+ grants.roles.setdefault(role, []).append(skill.header.name)
188
+ self.grants_path.write_text(grants.model_dump_json(indent=2), encoding="utf-8")
189
+ return skill.header.name
190
+
191
+ def remove(self, name):
192
+ SkillHeader(name=name, description="remove")
193
+ target = (self.root / name).resolve()
194
+ if target.parent != self.root.resolve() or not target.is_dir():
195
+ raise ValueError("Only installed workspace skills can be removed")
196
+ with write_lock(self.workspace / ".skills.lock"):
197
+ shutil.rmtree(target)
198
+ grants = self.grants()
199
+ grants.roles = {r: [n for n in names if n != name] for r, names in grants.roles.items()}
200
+ self.grants_path.write_text(grants.model_dump_json(indent=2), encoding="utf-8")
@@ -0,0 +1,41 @@
1
+ from pathlib import Path
2
+
3
+ import typer
4
+
5
+ from spriteforge.agents.roles import load_roles
6
+ from spriteforge.config import init_workspace, load_config
7
+
8
+ from .catalog import SkillCatalog
9
+
10
+ app = typer.Typer(no_args_is_help=True)
11
+
12
+
13
+ def catalog(workspace):
14
+ return SkillCatalog(init_workspace(workspace or load_config().workspace))
15
+
16
+
17
+ @app.command("list")
18
+ def list_skills(workspace: Path | None = None, role: str | None = None):
19
+ skills = catalog(workspace)
20
+ for name, skill in (skills.available(load_roles()[role]) if role else skills.all()).items():
21
+ typer.echo(f"{name}: {skill.header.description}")
22
+
23
+
24
+ @app.command()
25
+ def add(
26
+ source: str,
27
+ workspace: Path | None = None,
28
+ role: str = "Pixel Artist",
29
+ subdir: str = "",
30
+ revision: str | None = None,
31
+ ):
32
+ try:
33
+ typer.echo(catalog(workspace).add(source, role, subdir, revision))
34
+ except (ValueError, OSError) as exc:
35
+ raise typer.BadParameter(str(exc)) from None
36
+
37
+
38
+ @app.command()
39
+ def remove(name: str, workspace: Path | None = None):
40
+ catalog(workspace).remove(name)
41
+ typer.echo(f"Removed {name}")
File without changes
@@ -0,0 +1,301 @@
1
+ """Role proposals and selected skill/prompt context for production."""
2
+
3
+ import asyncio
4
+ import json
5
+ from pathlib import Path
6
+
7
+ from spriteforge.agents.roles import load_roles
8
+ from spriteforge.agents.router import build_catalog
9
+ from spriteforge.agents.routing_state import RoutingStore
10
+ from spriteforge.agents.runtime import invoke
11
+ from spriteforge.config import BudgetConfig, Config
12
+ from spriteforge.core.cost import Budget
13
+ from spriteforge.mcp.registry import Registry
14
+ from spriteforge.memory.okf.seed import seed
15
+ from spriteforge.memory.okf.store import KnowledgeStore
16
+ from spriteforge.pixel.schemas import Style
17
+ from spriteforge.providers.base import ChatRequest, Message, chat_json
18
+ from spriteforge.providers.mock import MockImageProvider, MockLLMProvider
19
+ from spriteforge.providers.muse_image import MuseImageProvider
20
+ from spriteforge.providers.muse_spark import MuseSparkProvider
21
+ from spriteforge.skills.catalog import SkillCatalog
22
+
23
+ from .asset_models import AssetSpec, FrameState, Manifest, ManifestProposal, ProposedAsset
24
+ from .asset_store import ProductionStore
25
+ from .intake import GameBrief
26
+
27
+
28
+ class ProductionContext(ProductionStore):
29
+ def __init__(self, store, run_id):
30
+ super().__init__(store, run_id)
31
+ self.run = store.get_run(run_id)
32
+ self.cfg = Config.model_validate(self.run.config["settings"])
33
+ self.budget = Budget(store, run_id, BudgetConfig.model_validate(self.run.config["budget"]))
34
+ self.style = Style.model_validate(self.read("style.json"))
35
+ self.brief = GameBrief.model_validate(self.read("brief.json"))
36
+ from spriteforge.core.gates import Gates
37
+
38
+ notes = [
39
+ g.response.text
40
+ for g in Gates(store).all(run_id)
41
+ if g.stage in {"genre", "brief", "followups"} and g.response and g.response.text.strip()
42
+ ]
43
+ self.brief.notes = list(dict.fromkeys([*self.brief.notes, *notes]))
44
+
45
+ def image_provider(self):
46
+ return (
47
+ MockImageProvider(self.budget)
48
+ if self.run.config["mock"]
49
+ else MuseImageProvider(self.cfg.image, self.budget)
50
+ )
51
+
52
+ def ask(self, name, role, prompt, schema, fallback, images=()):
53
+ if name in self.artifacts:
54
+ return schema.model_validate(self.read(name))
55
+ provider = (
56
+ MockLLMProvider(self.budget, [fallback.model_dump()])
57
+ if self.run.config["mock"]
58
+ else MuseSparkProvider(self.cfg.llm, self.budget)
59
+ )
60
+ routing = None
61
+ try:
62
+ routing = self.route_context(name, role, prompt, provider)
63
+ result = chat_json(
64
+ provider,
65
+ ChatRequest(
66
+ messages=[
67
+ Message(
68
+ role="system",
69
+ content=str(load_roles()[role].model_dump())
70
+ + "\nHuman brief notes override untouched genre defaults. Return only the requested JSON.",
71
+ ),
72
+ Message(
73
+ role="user",
74
+ content=prompt
75
+ + "\nSelected skill guidance:\n"
76
+ + json.dumps(routing.state.bodies),
77
+ images=list(images),
78
+ ),
79
+ ]
80
+ ),
81
+ schema,
82
+ )
83
+ self.save(name, result.model_dump(), role)
84
+ routing.outcome("completed")
85
+ return result
86
+ except Exception:
87
+ if routing:
88
+ routing.outcome("failed")
89
+ raise
90
+ finally:
91
+ if hasattr(provider, "close"):
92
+ provider.close()
93
+
94
+ def route_context(self, name, role_name, goal, provider):
95
+ """Structured/image stages consume skill context; they do not execute MCP calls."""
96
+ role = load_roles()[role_name]
97
+ skills = SkillCatalog(self.store.path.parent)
98
+ catalog = build_catalog(
99
+ role, skills, {}, {}, Registry(self.store.path.parent).allowed(role)
100
+ )
101
+ routing = RoutingStore(self.store, self.run_id, "context:" + name)
102
+ asyncio.run(
103
+ routing.prepare(role, goal, catalog, self.cfg.router, provider, invoke, skills, {})
104
+ )
105
+ for selected in routing.state.decision.selected_skills:
106
+ routing.used("skills", selected)
107
+ return routing
108
+
109
+ def prompt_context(self, task):
110
+ name = f"production/context/{task.spec.type}-{'frame' if task.base else 'base'}.json"
111
+ if name not in self.artifacts:
112
+ memory = KnowledgeStore(self.store.path.parent / "memory", self.store, self.run_id)
113
+ seed(memory)
114
+ snippets = memory.retrieve(
115
+ "prompt-patterns chunky pixel " + task.spec.type, token_budget=1800
116
+ )
117
+ patterns = [
118
+ memory.show(s.id).body for s in snippets if s.id.startswith("prompt-patterns/")
119
+ ]
120
+ provider = (
121
+ MockLLMProvider(self.budget)
122
+ if self.run.config["mock"]
123
+ else MuseSparkProvider(self.cfg.llm, self.budget)
124
+ )
125
+ try:
126
+ goal = f"Prepare Muse pixel-art prompt guidance for {task.spec.type} " + (
127
+ "animation frames" if task.base else "base artwork"
128
+ )
129
+ routing = self.route_context(name, "Pixel Artist", goal, provider)
130
+ skills = list(routing.state.bodies.values())
131
+ for selected in routing.state.decision.selected_skills:
132
+ self.store.append_event(
133
+ self.run_id, "Pixel Artist", "skill.loaded", {"name": selected}
134
+ )
135
+ self.save(name, {"patterns": patterns, "skills": skills})
136
+ routing.outcome("completed")
137
+ finally:
138
+ if hasattr(provider, "close"):
139
+ provider.close()
140
+ return str(self.read(name))
141
+
142
+ def prompt(self, task, instruction):
143
+ template = (
144
+ "anim_frame" if task.base else ("item" if task.spec.type == "fx" else task.spec.type)
145
+ )
146
+ body = (Path(__file__).parents[1] / "prompts" / f"{template}.txt").read_text(
147
+ encoding="utf-8"
148
+ )
149
+ return (
150
+ body
151
+ + "\nAsset: "
152
+ + task.model_dump_json()
153
+ + "\nApproved style rules: "
154
+ + self.style.model_dump_json()
155
+ + "\nGame brief: "
156
+ + self.brief.model_dump_json()
157
+ + "\nRetrieved guidance: "
158
+ + self.prompt_context(task)
159
+ + "\nConfirmed revision: "
160
+ + (instruction or "Initial production")
161
+ + (
162
+ f"\nPose {task.index + 1} of {task.spec.frames[task.state]} in the {task.state} cycle. "
163
+ "Space poses evenly around one cycle; change limb/pedal positions while preserving the accepted subject."
164
+ if task.base
165
+ else ""
166
+ )
167
+ )
168
+
169
+
170
+ def mock_manifest(brief, style):
171
+ """Small, explicit offline fixture. Live manifests come from the two designer roles."""
172
+ specs = [
173
+ ("hero", "character", style.character_canvas, {"idle": 1, "walk": 4}, brief.character),
174
+ ("enemy", "character", style.character_canvas, {"idle": 1, "walk": 2}, "A readable enemy"),
175
+ ("ground", "tile", style.tile_canvas, {"idle": 1}, "Repeatable ground material"),
176
+ ("wall", "tile", style.tile_canvas, {"idle": 1}, "Repeatable wall material"),
177
+ ("reward", "item", (16, 16), {"idle": 1}, "A reward pickup"),
178
+ ("health", "ui", (16, 16), {"idle": 1}, "A heart icon"),
179
+ ("impact", "fx", (16, 16), {"idle": 1, "burst": 2}, "An impact spark"),
180
+ ]
181
+ return ManifestProposal(
182
+ assets=[
183
+ ProposedAsset(
184
+ id=i,
185
+ type=t,
186
+ size=s,
187
+ frames=[FrameState(state=k, count=v) for k, v in frames.items()],
188
+ desc=desc + "; " + brief.environment,
189
+ depends_on=[],
190
+ refs=["anchor"],
191
+ )
192
+ for i, t, s, frames, desc in specs
193
+ ]
194
+ )
195
+
196
+
197
+ def make_manifest(ctx):
198
+ name = "production/manifest.json"
199
+ if name in ctx.artifacts:
200
+ return Manifest.model_validate(ctx.read(name))
201
+ if "genre.json" in ctx.artifacts:
202
+ genre_body = ctx.read("genre.json")["body"]
203
+ else:
204
+ memory = KnowledgeStore(ctx.store.path.parent / "memory", ctx.store, ctx.run_id)
205
+ seed(memory)
206
+ genre_body = memory.show(ctx.brief.genre).body
207
+ locked = (
208
+ Manifest.model_validate(ctx.read(ctx.read("approval.json")["manifest"]))
209
+ if "preview/locked-assets.json" in ctx.artifacts
210
+ else None
211
+ )
212
+ prompt = (
213
+ "Produce a complete but small AssetSpec manifest for this brief using the genre asset checklist. "
214
+ "Human notes override default descriptions. Include actors, terrain, items, UI and effects as needed. "
215
+ "Idle frame zero is the base for every asset; animation states list total frame counts, including any additional idle frames. "
216
+ "refs are other manifest asset ids or anchor, never file paths. Dependencies must be acyclic. "
217
+ "At most 64 base assets and 256 total frames; fit the available image-call cap. "
218
+ "No sprite sheets: each generated output is one frame.\nBrief: "
219
+ + ctx.brief.model_dump_json()
220
+ + "\nGenre checklist and mechanics:\n"
221
+ + genre_body
222
+ + "\nStyle: "
223
+ + ctx.style.model_dump_json()
224
+ + f"\nImage cap: {ctx.budget.config.max_image_calls}"
225
+ + "\nThe hero needs a four-frame walk/movement cycle. For a bike rider this is a pedal cycle, not walking beside the bike."
226
+ + (
227
+ "\nReuse these LOCKED Gate 2 base assets and their exact ids/descriptions. "
228
+ "Add the hero's four-frame cycle; add other assets only if necessary for the approved brief. "
229
+ "Do not duplicate existing enemies, tiles or items under new ids:\n"
230
+ + locked.model_dump_json()
231
+ if locked
232
+ else ""
233
+ )
234
+ )
235
+ design = ctx.ask(
236
+ "production/game-design-manifest.json",
237
+ "Game Designer",
238
+ prompt,
239
+ ManifestProposal,
240
+ (
241
+ ManifestProposal(
242
+ assets=[
243
+ ProposedAsset(
244
+ **{
245
+ k: v for k, v in a.model_dump().items() if k not in {"frames", "locked"}
246
+ },
247
+ frames=[
248
+ FrameState(state=k, count=v)
249
+ for k, v in (
250
+ {**a.frames, "walk": 4} if a.id == "hero" else a.frames
251
+ ).items()
252
+ ],
253
+ )
254
+ for a in locked.assets
255
+ ]
256
+ )
257
+ if locked
258
+ else mock_manifest(ctx.brief, ctx.style)
259
+ ),
260
+ )
261
+ proposal = ctx.ask(
262
+ "production/level-design-manifest.json",
263
+ "Level/Tile Designer",
264
+ prompt
265
+ + "\nReview the Game Designer's proposal, correct dependencies and add the necessary tiles. Return the complete merged manifest:\n"
266
+ + design.model_dump_json(),
267
+ ManifestProposal,
268
+ design,
269
+ )
270
+ assets = []
271
+ for item in proposal.assets:
272
+ if len({f.state for f in item.frames}) != len(item.frames):
273
+ raise ValueError("Duplicate animation states")
274
+ values = item.model_dump()
275
+ values["frames"] = {f.state: f.count for f in item.frames}
276
+ if item.id == "hero":
277
+ values["frames"]["walk"] = max(4, values["frames"].get("walk", 0))
278
+ if item.type == "character":
279
+ values["size"] = ctx.style.character_canvas
280
+ elif item.type == "tile":
281
+ values["size"] = ctx.style.tile_canvas
282
+ assets.append(AssetSpec.model_validate(values))
283
+ manifest = Manifest(assets=assets)
284
+ if locked:
285
+ # Keep accepted base specs; new animation states may extend them later.
286
+ proposals = {a.id: a for a in manifest.assets}
287
+ for asset in locked.assets:
288
+ if asset.id in proposals:
289
+ asset.frames = {**asset.frames, **proposals[asset.id].frames}
290
+ if asset.id == "hero":
291
+ asset.frames["walk"] = max(4, asset.frames.get("walk", 0))
292
+ asset.locked = True
293
+ proposals[asset.id] = asset
294
+ manifest = Manifest(assets=list(proposals.values()))
295
+ order = {t.id: i for i, t in enumerate(manifest.tasks())}
296
+ manifest.assets.sort(key=lambda a: order[a.id])
297
+ ctx.save(name, manifest.model_dump(), "Level/Tile Designer")
298
+ ctx.save(
299
+ "production/tasks.json", [t.model_dump() for t in manifest.tasks()], "Level/Tile Designer"
300
+ )
301
+ return manifest