plotagon-director 0.9.2__tar.gz → 0.10.0__tar.gz

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotagon-director
-Version: 0.9.2
+Version: 0.10.0
 Summary: Génération de films Plotagon Studio Desktop (.plot) avec voix Edge TTS et synchro labiale
 Author: Mohamed Amine Ben Mallessa
 License: MIT
@@ -90,6 +90,13 @@ plotagon-director batch scenarios/ sorties/   # tous les .yaml d'un dossier
 
 # Importer mon-film.plot dans Plotagon Studio (menu import)
 
+# Personnages custom (créés dans le créateur de Plotagon Studio)
+plotagon-director casting add export.plot     # récolte les persos d'un export
+plotagon-director casting list [--json]       # registre local (./casting)
+#   puis dans le cast du yaml : `custom: Leo` au lieu de `character: ...`
+#   (clé racine `casting_dir:` optionnelle ; défaut ./casting, sinon
+#   variable PLOTAGON_CASTING_DIR) — voix TTS et synchro labiale incluses
+
 # Analyse / rétro-ingénierie
 plotagon-director parse export.plot           # JSON brut d'un .plot
 plotagon-director decompile export.plot film.yaml   # .plot -> YAML éditable
@@ -165,6 +172,8 @@ Bibliothèque embarquée : 205 scènes (953 positions), 53 personnages,
 - `plotagon_director/audio/` — Edge TTS → WAV conforme (cache + parallèle),
   phonèmes/lip-sync
 - `plotagon_director/library/` — builder du catalogue + `data/library.json`
+- `plotagon_director/casting.py` — registre des personnages custom
+  (récolte des `.pcd` d'un export, résolution du cast `custom:`)
 - `plotagon_director/storyteller.py` — pipeline vidéo/transcription → .plot
   (`plotagon-storyteller`)
 - `plotagon_director/mcp_server.py` / `http_api.py` — serveur MCP
@@ -193,7 +202,7 @@ Le projet expose plusieurs surfaces pour les agents :
 - **Serveur MCP** : `pip install plotagon-director[mcp]` puis
   `plotagon-director mcp` (stdio). Outils : search_library, list_category,
   scene_positions, list_voices, validate_project, preview_durations,
-  build_film, storytell. Compatible Claude Desktop/Code, Cursor, VS Code,
+  build_film, storytell, casting_add, casting_list. Compatible Claude Desktop/Code, Cursor, VS Code,
   Gemini CLI... Exemple de config client :
   `{"command": "plotagon-director", "args": ["mcp"]}`
 - **API HTTP + OpenAPI** : `pip install plotagon-director[http]` puis

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/README.md

@@ -51,6 +51,13 @@ plotagon-director batch scenarios/ sorties/   # tous les .yaml d'un dossier
 
 # Importer mon-film.plot dans Plotagon Studio (menu import)
 
+# Personnages custom (créés dans le créateur de Plotagon Studio)
+plotagon-director casting add export.plot     # récolte les persos d'un export
+plotagon-director casting list [--json]       # registre local (./casting)
+#   puis dans le cast du yaml : `custom: Leo` au lieu de `character: ...`
+#   (clé racine `casting_dir:` optionnelle ; défaut ./casting, sinon
+#   variable PLOTAGON_CASTING_DIR) — voix TTS et synchro labiale incluses
+
 # Analyse / rétro-ingénierie
 plotagon-director parse export.plot           # JSON brut d'un .plot
 plotagon-director decompile export.plot film.yaml   # .plot -> YAML éditable
@@ -126,6 +133,8 @@ Bibliothèque embarquée : 205 scènes (953 positions), 53 personnages,
 - `plotagon_director/audio/` — Edge TTS → WAV conforme (cache + parallèle),
   phonèmes/lip-sync
 - `plotagon_director/library/` — builder du catalogue + `data/library.json`
+- `plotagon_director/casting.py` — registre des personnages custom
+  (récolte des `.pcd` d'un export, résolution du cast `custom:`)
 - `plotagon_director/storyteller.py` — pipeline vidéo/transcription → .plot
   (`plotagon-storyteller`)
 - `plotagon_director/mcp_server.py` / `http_api.py` — serveur MCP
@@ -154,7 +163,7 @@ Le projet expose plusieurs surfaces pour les agents :
 - **Serveur MCP** : `pip install plotagon-director[mcp]` puis
   `plotagon-director mcp` (stdio). Outils : search_library, list_category,
   scene_positions, list_voices, validate_project, preview_durations,
-  build_film, storytell. Compatible Claude Desktop/Code, Cursor, VS Code,
+  build_film, storytell, casting_add, casting_list. Compatible Claude Desktop/Code, Cursor, VS Code,
   Gemini CLI... Exemple de config client :
   `{"command": "plotagon-director", "args": ["mcp"]}`
 - **API HTTP + OpenAPI** : `pip install plotagon-director[http]` puis

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/plotagon_director/__init__.py

@@ -1,3 +1,3 @@
-"""plotagon_director — generation de films Plotagon Studio Desktop (.plot)."""
-
-__version__ = "0.9.2"
+"""plotagon_director — generation de films Plotagon Studio Desktop (.plot)."""
+
+__version__ = "0.10.0"

plotagon_director-0.10.0/plotagon_director/casting.py

@@ -0,0 +1,135 @@
+"""Personnages custom : registre local et integration au build.
+
+Un personnage custom est cree dans le createur de Plotagon Studio puis
+exporte dans un .plot : l'archive contient "customcharacters/<Nom>_<guid>.pcd"
+(recette JSON "TmpL" + geometrie 3D bakee) et sa vignette .png. Le registre
+local (un dossier + registry.json) conserve ces fichiers pour les reutiliser
+dans les films generes : il suffit de referencer le GUID dans les
+instructions et d'embarquer les fichiers dans l'archive.
+
+Resolution du dossier de casting (premier trouve) :
+1. cle `casting_dir` du project.yaml (absolue, ou relative au yaml) ;
+2. dossier `casting/` a cote du project.yaml ;
+3. variable d'environnement PLOTAGON_CASTING_DIR.
+"""
+
+import json
+import os
+import zipfile
+from pathlib import Path
+
+REGISTRY_NAME = "registry.json"
+
+
+def parse_recipe(pcd_bytes):
+    """Extrait la recette JSON (chunk TmpL) d'un fichier .pcd."""
+    start = pcd_bytes.find(b"{")
+    if start < 0:
+        raise ValueError("recette TmpL introuvable dans le .pcd")
+    depth = 0
+    for i in range(start, len(pcd_bytes)):
+        char = pcd_bytes[i:i + 1]
+        if char == b"{":
+            depth += 1
+        elif char == b"}":
+            depth -= 1
+            if depth == 0:
+                return json.loads(pcd_bytes[start:i + 1])
+    raise ValueError("recette TmpL tronquee dans le .pcd")
+
+
+def casting_dir(data=None, project_path=None):
+    """Retourne le dossier de casting applicable (Path) ou None."""
+    if isinstance(data, dict) and data.get("casting_dir"):
+        base = Path(project_path).parent if project_path else Path(".")
+        path = Path(data["casting_dir"])
+        return path if path.is_absolute() else base / path
+    if project_path:
+        local = Path(project_path).parent / "casting"
+        if local.is_dir():
+            return local
+    env = os.environ.get("PLOTAGON_CASTING_DIR")
+    if env:
+        return Path(env)
+    return None
+
+
+def load_registry(directory):
+    """Charge registry.json d'un dossier de casting -> {nom: entree}."""
+    if not directory:
+        return {}
+    path = Path(directory) / REGISTRY_NAME
+    if not path.is_file():
+        return {}
+    with open(path, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def harvest(plot_path, directory):
+    """Recolte les personnages custom d'un .plot exporte vers le registre.
+
+    Copie les customcharacters/*.pcd|png dans `directory` et met a jour
+    registry.json. Retourne la liste des noms ajoutes/mis a jour.
+    """
+    directory = Path(directory)
+    directory.mkdir(parents=True, exist_ok=True)
+    registry = load_registry(directory)
+    added = []
+    with zipfile.ZipFile(plot_path) as zf:
+        for name in zf.namelist():
+            if not name.startswith("customcharacters/"):
+                continue
+            filename = name.split("/", 1)[1]
+            payload = zf.read(name)
+            (directory / filename).write_bytes(payload)
+            if filename.endswith(".pcd"):
+                recipe = parse_recipe(payload)
+                registry[recipe["name"]] = {
+                    "id": recipe["id"],
+                    "gender": recipe.get("gender", ""),
+                    "pcd": filename,
+                    "png": filename[:-4] + ".png",
+                    "definition": recipe.get("definition", {}),
+                }
+                added.append(recipe["name"])
+    with open(directory / REGISTRY_NAME, "w", encoding="utf-8") as f:
+        json.dump(registry, f, indent=1, ensure_ascii=False)
+    return added
+
+
+def apply_casting(data, project_path=None):
+    """Resout les membres du cast declares avec `custom: <Nom>`.
+
+    Mutations en place : `character` devient le GUID du personnage et `name`
+    prend le nom du registre par defaut. Retourne les fichiers a embarquer
+    dans l'archive : {chemin_zip: bytes}. Leve ValueError si un nom est
+    introuvable dans le registre.
+    """
+    members = [m for m in (data or {}).get("cast", [])
+               if isinstance(m, dict) and m.get("custom")]
+    if not members:
+        return {}
+    directory = casting_dir(data, project_path)
+    registry = load_registry(directory)
+    if not registry:
+        raise ValueError(
+            "Cast custom mais aucun registre trouve (casting_dir, dossier "
+            "casting/ a cote du yaml, ou PLOTAGON_CASTING_DIR). Recoltez "
+            "d'abord un export: plotagon-director casting add <export.plot>"
+        )
+    extra_files = {}
+    for member in members:
+        name = member["custom"]
+        entry = registry.get(name)
+        if entry is None:
+            raise ValueError(
+                "Personnage custom '%s' absent du registre %s (disponibles: "
+                "%s)." % (name, directory, ", ".join(sorted(registry)))
+            )
+        member["character"] = entry["id"]
+        member.setdefault("name", name)
+        for key in ("pcd", "png"):
+            filename = entry[key]
+            path = Path(directory) / filename
+            extra_files["customcharacters/" + filename] = path.read_bytes()
+    return extra_files

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/plotagon_director/cli.py

@@ -108,7 +108,10 @@ def do_build(project_path, output, no_voices=False, strict=False, srt=None,
     errors, warnings = validate_project(project_path)
     if errors or (strict and warnings):
         print_report(errors, warnings, strict)
-    plotdoc, voice_jobs = build_plotdoc(load_project(project_path), load_library())
+    from .casting import apply_casting
+    data = load_project(project_path)
+    extra_files = apply_casting(data, project_path)
+    plotdoc, voice_jobs = build_plotdoc(data, load_library())
 
     media = {}
     durations = {}
@@ -137,9 +140,10 @@ def do_build(project_path, output, no_voices=False, strict=False, srt=None,
             instr["parameters"]["isRecorded"] = False
             instr["parameters"]["playRecording"] = False
 
-    write_plot(plotdoc, output, media)
-    print("OK  %s (%d instructions, %d voix)" % (
-        output, len(plotdoc["contents"]["instructions"]), len(media)
+    write_plot(plotdoc, output, media, extra_files=extra_files)
+    print("OK  %s (%d instructions, %d voix%s)" % (
+        output, len(plotdoc["contents"]["instructions"]), len(media),
+        ", %d perso(s) custom" % (len(extra_files) // 2) if extra_files else "",
     ))
 
     if srt:
@@ -346,6 +350,19 @@ def main():
         "preview", help="durees estimees d'un project.yaml sans builder")
     pprev.add_argument("project")
 
+    pcast = sub.add_parser(
+        "casting",
+        help="registre des personnages custom (crees dans l'appli)")
+    cast_sub = pcast.add_subparsers(dest="casting_command", required=True)
+    pcadd = cast_sub.add_parser(
+        "add", help="recolte les personnages custom d'un .plot exporte")
+    pcadd.add_argument("plot")
+    pcadd.add_argument("--dir", dest="directory", default="casting",
+                       help="dossier du registre (defaut: ./casting)")
+    pclist = cast_sub.add_parser("list", help="liste le registre de casting")
+    pclist.add_argument("--dir", dest="directory", default="casting")
+    pclist.add_argument("--json", action="store_true", dest="as_json")
+
     sub.add_parser(
         "storytell", add_help=False,
         help="pipeline video/transcription -> .plot (alias plotagon-storyteller)")
@@ -463,6 +480,26 @@ def main():
     elif args.command == "preview":
         do_preview(args.project)
 
+    elif args.command == "casting":
+        from .casting import harvest, load_registry
+        if args.casting_command == "add":
+            added = harvest(args.plot, args.directory)
+            if added:
+                print("OK  %d personnage(s) dans %s : %s" % (
+                    len(added), args.directory, ", ".join(added)))
+            else:
+                print("Aucun personnage custom dans %s." % args.plot)
+        elif args.casting_command == "list":
+            registry = load_registry(args.directory)
+            if args.as_json:
+                print(json.dumps(registry, indent=1, ensure_ascii=False))
+            elif not registry:
+                print("Registre vide ou absent (%s)." % args.directory)
+            else:
+                for name, entry in sorted(registry.items()):
+                    print("%-16s %-7s %s" % (name, entry.get("gender", "?"),
+                                             entry["id"]))
+
     elif args.command == "say":
         from .audio.tts import synthesize_wav
         wav = synthesize_wav(args.text, args.voice)

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/plotagon_director/core/archive.py

@@ -9,10 +9,12 @@ import json
 import zipfile
 
 
-def write_plot(plotdoc, out_path, media=None):
+def write_plot(plotdoc, out_path, media=None, extra_files=None):
     """Ecrit un .plot.
 
     media : dict {guid_instruction: {"wav": bytes, "phonemes": bytes}}.
+    extra_files : dict {chemin_dans_le_zip: bytes} — p. ex. les
+    customcharacters/*.pcd|png des personnages custom.
     """
     inner_name = "%s.plotdoc" % plotdoc["id"]
     payload = json.dumps(plotdoc, ensure_ascii=False, indent=2)
@@ -23,6 +25,8 @@ def write_plot(plotdoc, out_path, media=None):
             zf.writestr(base + ".wav", files["wav"])
             if files.get("phonemes"):
                 zf.writestr(base + ".phonemes", files["phonemes"])
+        for name, payload_bytes in (extra_files or {}).items():
+            zf.writestr(name, payload_bytes)
 
 
 def read_plot(path):

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/plotagon_director/core/validator.py

@@ -59,6 +59,9 @@ def validate_project(path):
     if not scenes:
         errors.append("No scenes defined.")
 
+    from ..casting import casting_dir, load_registry
+    registry = load_registry(casting_dir(data, path))
+
     refs = {}
     for member in cast:
         if not isinstance(member, dict) or not member.get("ref"):
@@ -68,7 +71,28 @@ def validate_project(path):
             errors.append("Duplicate cast ref '%s'." % member["ref"])
         refs[member["ref"]] = member
         character = member.get("character")
-        if not character:
+        custom = member.get("custom")
+        if custom:
+            if character:
+                errors.append(
+                    "Cast '%s': 'character' et 'custom' sont exclusifs."
+                    % member["ref"]
+                )
+            elif not registry:
+                errors.append(
+                    "Cast '%s': personnage custom '%s' mais aucun registre "
+                    "de casting trouve (casting_dir, dossier casting/ a cote "
+                    "du yaml, ou PLOTAGON_CASTING_DIR)."
+                    % (member["ref"], custom)
+                )
+            elif custom not in registry:
+                errors.append(
+                    "Cast '%s': personnage custom '%s' absent du registre "
+                    "(disponibles: %s).%s"
+                    % (member["ref"], custom, ", ".join(sorted(registry)),
+                       _did_you_mean(custom, registry))
+                )
+        elif not character:
             errors.append("Cast '%s': missing character id." % member["ref"])
         elif library and character not in library["characters"]:
             errors.append(

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/plotagon_director/mcp_server.py

@@ -122,6 +122,23 @@ def create_server():
                 "errors": _structured(errors),
                 "warnings": _structured(warnings)}
 
+    @server.tool()
+    def casting_add(plot_path: str, directory: str) -> dict:
+        """Recolte les personnages custom d'un .plot exporte depuis Plotagon
+        Studio vers un registre de casting local (dossier + registry.json).
+        Ils deviennent utilisables dans le cast via `custom: <Nom>` (avec
+        `casting_dir` absolu dans le project.yaml)."""
+        from .casting import harvest
+        return {"added": harvest(plot_path, directory)}
+
+    @server.tool()
+    def casting_list(directory: str) -> dict:
+        """Liste le registre de casting local {nom: {id, gender, ...}}."""
+        from .casting import load_registry
+        registry = load_registry(directory)
+        return {name: {"id": e["id"], "gender": e.get("gender", "")}
+                for name, e in registry.items()}
+
     @server.tool()
     def preview_durations(yaml_text: str) -> dict:
         """Durees estimees par replique et totale d'un project.yaml, sans

plotagon_director-0.10.0/plotagon_director/schemas/project.schema.json

@@ -0,0 +1,217 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://github.com/mohamed-amine-ben-mallessa/plotagon-director/blob/main/schemas/project.schema.json",
+ "title": "Plotagon Director project",
+ "description": "Scenario YAML pour plotagon-director. Les IDs (scene, character, expression, music, action, position) doivent exister dans la bibliotheque embarquee : les valider avec `plotagon-director validate --strict` ou explorer avec `plotagon-director search/list/positions`.",
+ "type": "object",
+ "required": [
+  "project",
+  "cast",
+  "scenes"
+ ],
+ "additionalProperties": false,
+ "properties": {
+  "project": {
+   "type": "object",
+   "required": [
+    "title"
+   ],
+   "additionalProperties": false,
+   "properties": {
+    "title": {
+     "type": "string",
+     "minLength": 1
+    },
+    "language": {
+     "type": "string",
+     "description": "Locale BCP 47, ex. fr-FR, en-US",
+     "pattern": "^[a-z]{2}(-[A-Z]{2})?$",
+     "default": "fr-FR"
+    }
+   }
+  },
+  "cast_file": {
+   "type": "string",
+   "description": "Chemin (relatif au project.yaml) d'un cast partage ; fusionne avant le cast local"
+  },
+  "cast": {
+   "type": "array",
+   "items": {
+    "type": "object",
+    "required": [
+     "ref"
+    ],
+    "additionalProperties": false,
+    "properties": {
+     "ref": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Identifiant local reference par scenes[].actors et dialogue[].actor"
+     },
+     "character": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+\\.[a-z0-9]+$",
+      "description": "ID bibliotheque, ex. office.steve (53 disponibles : `plotagon-director list characters`)"
+     },
+     "name": {
+      "type": "string",
+      "description": "Nom affiche dans le film"
+     },
+     "voice": {
+      "type": "string",
+      "pattern": "^[a-z]{2}-[A-Z]{2}-[A-Za-z]+Neural$",
+      "description": "Voix Edge TTS, ex. fr-FR-HenriNeural (docs/VOICES.md)"
+     },
+     "rate": {
+      "type": "string",
+      "pattern": "^[+-]\\d+%$",
+      "description": "Debit TTS, ex. +10%"
+     },
+     "pitch": {
+      "type": "string",
+      "pattern": "^[+-]\\d+Hz$",
+      "description": "Hauteur TTS, ex. -5Hz"
+     },
+     "custom": {
+      "type": "string",
+      "description": "Nom d'un personnage custom du registre de casting (exclusif avec `character`). Cree dans le createur de Plotagon Studio puis recolte via `plotagon-director casting add`."
+     }
+    },
+    "anyOf": [
+     {
+      "required": [
+       "character"
+      ]
+     },
+     {
+      "required": [
+       "custom"
+      ]
+     }
+    ]
+   }
+  },
+  "scenes": {
+   "type": "array",
+   "minItems": 1,
+   "items": {
+    "type": "object",
+    "required": [
+     "scene"
+    ],
+    "additionalProperties": false,
+    "properties": {
+     "scene": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+\\.[a-z0-9]+$",
+      "description": "ID bibliotheque, ex. office.ceooffice (205 disponibles)"
+     },
+     "music": {
+      "type": "string",
+      "pattern": "^music\\.[a-z0-9]+$",
+      "description": "38 pistes + music.stopmusic"
+     },
+     "actors": {
+      "type": "array",
+      "maxItems": 2,
+      "items": {
+       "type": "object",
+       "required": [
+        "ref"
+       ],
+       "additionalProperties": false,
+       "properties": {
+        "ref": {
+         "type": "string"
+        },
+        "position": {
+         "type": "string",
+         "description": "Slot propre a la scene (`plotagon-director positions <scene>`) ; omis = premier slot"
+        }
+       }
+      }
+     },
+     "dialogue": {
+      "type": "array",
+      "items": {
+       "oneOf": [
+        {
+         "type": "object",
+         "required": [
+          "actor",
+          "text"
+         ],
+         "additionalProperties": false,
+         "properties": {
+          "actor": {
+           "type": "string"
+          },
+          "expression": {
+           "type": "string",
+           "default": "neutral",
+           "description": "88 expressions (`plotagon-director list expressions`)"
+          },
+          "text": {
+           "type": "string",
+           "description": "Vide accepte (mime sans parole)"
+          },
+          "camera": {
+           "type": "string",
+           "enum": [
+            "default",
+            "establishing shot",
+            "in dialogue mode",
+            "in interaction mode",
+            "moving right",
+            "moving left",
+            "moving forward",
+            "moving backward",
+            "wide shot",
+            "still"
+           ],
+           "description": "'in dialogue/interaction mode' exigent 2 acteurs ; 'moving *' exigent camera_position ET camera_target"
+          },
+          "camera_position": {
+           "type": "string",
+           "description": "ex. EstablishingLocation"
+          },
+          "camera_target": {
+           "type": "string",
+           "description": "Slot de position de la scene"
+          }
+         }
+        },
+        {
+         "type": "object",
+         "required": [
+          "actor",
+          "action",
+          "target"
+         ],
+         "additionalProperties": false,
+         "properties": {
+          "actor": {
+           "type": "string"
+          },
+          "action": {
+           "type": "string",
+           "description": "15 interactions a 2 personnages (`plotagon-director list actions`)"
+          },
+          "target": {
+           "type": "string",
+           "description": "ref de l'autre acteur"
+          }
+         }
+        }
+       ]
+      }
+     }
+    }
+   }
+  },
+  "casting_dir": {
+   "type": "string",
+   "description": "Dossier du registre de personnages custom (registry.json + .pcd/.png recoltes via `plotagon-director casting add <export.plot>`). Absolu, ou relatif au project.yaml. Defauts : dossier casting/ a cote du yaml, puis variable PLOTAGON_CASTING_DIR."
+  }
+ }
+}

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/plotagon_director.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotagon-director
-Version: 0.9.2
+Version: 0.10.0
 Summary: Génération de films Plotagon Studio Desktop (.plot) avec voix Edge TTS et synchro labiale
 Author: Mohamed Amine Ben Mallessa
 License: MIT
@@ -90,6 +90,13 @@ plotagon-director batch scenarios/ sorties/   # tous les .yaml d'un dossier
 
 # Importer mon-film.plot dans Plotagon Studio (menu import)
 
+# Personnages custom (créés dans le créateur de Plotagon Studio)
+plotagon-director casting add export.plot     # récolte les persos d'un export
+plotagon-director casting list [--json]       # registre local (./casting)
+#   puis dans le cast du yaml : `custom: Leo` au lieu de `character: ...`
+#   (clé racine `casting_dir:` optionnelle ; défaut ./casting, sinon
+#   variable PLOTAGON_CASTING_DIR) — voix TTS et synchro labiale incluses
+
 # Analyse / rétro-ingénierie
 plotagon-director parse export.plot           # JSON brut d'un .plot
 plotagon-director decompile export.plot film.yaml   # .plot -> YAML éditable
@@ -165,6 +172,8 @@ Bibliothèque embarquée : 205 scènes (953 positions), 53 personnages,
 - `plotagon_director/audio/` — Edge TTS → WAV conforme (cache + parallèle),
   phonèmes/lip-sync
 - `plotagon_director/library/` — builder du catalogue + `data/library.json`
+- `plotagon_director/casting.py` — registre des personnages custom
+  (récolte des `.pcd` d'un export, résolution du cast `custom:`)
 - `plotagon_director/storyteller.py` — pipeline vidéo/transcription → .plot
   (`plotagon-storyteller`)
 - `plotagon_director/mcp_server.py` / `http_api.py` — serveur MCP
@@ -193,7 +202,7 @@ Le projet expose plusieurs surfaces pour les agents :
 - **Serveur MCP** : `pip install plotagon-director[mcp]` puis
   `plotagon-director mcp` (stdio). Outils : search_library, list_category,
   scene_positions, list_voices, validate_project, preview_durations,
-  build_film, storytell. Compatible Claude Desktop/Code, Cursor, VS Code,
+  build_film, storytell, casting_add, casting_list. Compatible Claude Desktop/Code, Cursor, VS Code,
   Gemini CLI... Exemple de config client :
   `{"command": "plotagon-director", "args": ["mcp"]}`
 - **API HTTP + OpenAPI** : `pip install plotagon-director[http]` puis

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/plotagon_director.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ LICENSE
 README.md
 pyproject.toml
 plotagon_director/__init__.py
+plotagon_director/casting.py
 plotagon_director/cli.py
 plotagon_director/http_api.py
 plotagon_director/mcp_server.py

{plotagon_director-0.9.2 → plotagon_director-0.10.0}/pyproject.toml

@@ -1,52 +1,52 @@
-[build-system]
-requires = ["setuptools>=68"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "plotagon-director"
-version = "0.9.2"
-description = "Génération de films Plotagon Studio Desktop (.plot) avec voix Edge TTS et synchro labiale"
-readme = "README.md"
-license = { text = "MIT" }
-authors = [{ name = "Mohamed Amine Ben Mallessa" }]
-requires-python = ">=3.10"
-keywords = ["plotagon", "tts", "video", "animation"]
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-]
-dependencies = [
-    "pyyaml",
-    "edge-tts",
-    "soundfile",
-    "numpy",
-    "truststore",
-]
-
-[project.optional-dependencies]
-library = ["UnityPy"]
-storyteller = ["yt-dlp", "yapsnap"]
-mcp = ["mcp"]
-http = ["fastapi", "uvicorn"]
-dev = ["pytest", "UnityPy", "mcp", "fastapi", "uvicorn", "httpx", "jsonschema"]
-
-[project.urls]
-LinkedIn = "https://www.linkedin.com/in/benmallessa/"
-
-[project.scripts]
-plotagon-director = "plotagon_director.cli:main"
-plotagon-storyteller = "plotagon_director.storyteller:main"
-
-[tool.pytest.ini_options]
-testpaths = [
-    "skills/plotagon-director/tests",
-    "skills/plotagon-storyteller/tests",
-]
-
-[tool.setuptools.packages.find]
-include = ["plotagon_director*"]
-
-[tool.setuptools.package-data]
-"plotagon_director.library" = ["data/*.json"]
-"plotagon_director" = ["schemas/*.json"]
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "plotagon-director"
+version = "0.10.0"
+description = "Génération de films Plotagon Studio Desktop (.plot) avec voix Edge TTS et synchro labiale"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Mohamed Amine Ben Mallessa" }]
+requires-python = ">=3.10"
+keywords = ["plotagon", "tts", "video", "animation"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "pyyaml",
+    "edge-tts",
+    "soundfile",
+    "numpy",
+    "truststore",
+]
+
+[project.optional-dependencies]
+library = ["UnityPy"]
+storyteller = ["yt-dlp", "yapsnap"]
+mcp = ["mcp"]
+http = ["fastapi", "uvicorn"]
+dev = ["pytest", "UnityPy", "mcp", "fastapi", "uvicorn", "httpx", "jsonschema"]
+
+[project.urls]
+LinkedIn = "https://www.linkedin.com/in/benmallessa/"
+
+[project.scripts]
+plotagon-director = "plotagon_director.cli:main"
+plotagon-storyteller = "plotagon_director.storyteller:main"
+
+[tool.pytest.ini_options]
+testpaths = [
+    "skills/plotagon-director/tests",
+    "skills/plotagon-storyteller/tests",
+]
+
+[tool.setuptools.packages.find]
+include = ["plotagon_director*"]
+
+[tool.setuptools.package-data]
+"plotagon_director.library" = ["data/*.json"]
+"plotagon_director" = ["schemas/*.json"]

plotagon_director-0.9.2/plotagon_director/schemas/project.schema.json

@@ -1,105 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/mohamed-amine-ben-mallessa/plotagon-director/blob/main/schemas/project.schema.json",
-  "title": "Plotagon Director project",
-  "description": "Scenario YAML pour plotagon-director. Les IDs (scene, character, expression, music, action, position) doivent exister dans la bibliotheque embarquee : les valider avec `plotagon-director validate --strict` ou explorer avec `plotagon-director search/list/positions`.",
-  "type": "object",
-  "required": ["project", "cast", "scenes"],
-  "additionalProperties": false,
-  "properties": {
-    "project": {
-      "type": "object",
-      "required": ["title"],
-      "additionalProperties": false,
-      "properties": {
-        "title": {"type": "string", "minLength": 1},
-        "language": {
-          "type": "string",
-          "description": "Locale BCP 47, ex. fr-FR, en-US",
-          "pattern": "^[a-z]{2}(-[A-Z]{2})?$",
-          "default": "fr-FR"
-        }
-      }
-    },
-    "cast_file": {
-      "type": "string",
-      "description": "Chemin (relatif au project.yaml) d'un cast partage ; fusionne avant le cast local"
-    },
-    "cast": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["ref", "character"],
-        "additionalProperties": false,
-        "properties": {
-          "ref": {"type": "string", "minLength": 1, "description": "Identifiant local reference par scenes[].actors et dialogue[].actor"},
-          "character": {"type": "string", "pattern": "^[a-z0-9]+\\.[a-z0-9]+$", "description": "ID bibliotheque, ex. office.steve (53 disponibles : `plotagon-director list characters`)"},
-          "name": {"type": "string", "description": "Nom affiche dans le film"},
-          "voice": {"type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}-[A-Za-z]+Neural$", "description": "Voix Edge TTS, ex. fr-FR-HenriNeural (docs/VOICES.md)"},
-          "rate": {"type": "string", "pattern": "^[+-]\\d+%$", "description": "Debit TTS, ex. +10%"},
-          "pitch": {"type": "string", "pattern": "^[+-]\\d+Hz$", "description": "Hauteur TTS, ex. -5Hz"}
-        }
-      }
-    },
-    "scenes": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "required": ["scene"],
-        "additionalProperties": false,
-        "properties": {
-          "scene": {"type": "string", "pattern": "^[a-z0-9]+\\.[a-z0-9]+$", "description": "ID bibliotheque, ex. office.ceooffice (205 disponibles)"},
-          "music": {"type": "string", "pattern": "^music\\.[a-z0-9]+$", "description": "38 pistes + music.stopmusic"},
-          "actors": {
-            "type": "array",
-            "maxItems": 2,
-            "items": {
-              "type": "object",
-              "required": ["ref"],
-              "additionalProperties": false,
-              "properties": {
-                "ref": {"type": "string"},
-                "position": {"type": "string", "description": "Slot propre a la scene (`plotagon-director positions <scene>`) ; omis = premier slot"}
-              }
-            }
-          },
-          "dialogue": {
-            "type": "array",
-            "items": {
-              "oneOf": [
-                {
-                  "type": "object",
-                  "required": ["actor", "text"],
-                  "additionalProperties": false,
-                  "properties": {
-                    "actor": {"type": "string"},
-                    "expression": {"type": "string", "default": "neutral", "description": "88 expressions (`plotagon-director list expressions`)"},
-                    "text": {"type": "string", "description": "Vide accepte (mime sans parole)"},
-                    "camera": {
-                      "type": "string",
-                      "enum": ["default", "establishing shot", "in dialogue mode", "in interaction mode", "moving right", "moving left", "moving forward", "moving backward", "wide shot", "still"],
-                      "description": "'in dialogue/interaction mode' exigent 2 acteurs ; 'moving *' exigent camera_position ET camera_target"
-                    },
-                    "camera_position": {"type": "string", "description": "ex. EstablishingLocation"},
-                    "camera_target": {"type": "string", "description": "Slot de position de la scene"}
-                  }
-                },
-                {
-                  "type": "object",
-                  "required": ["actor", "action", "target"],
-                  "additionalProperties": false,
-                  "properties": {
-                    "actor": {"type": "string"},
-                    "action": {"type": "string", "description": "15 interactions a 2 personnages (`plotagon-director list actions`)"},
-                    "target": {"type": "string", "description": "ref de l'autre acteur"}
-                  }
-                }
-              ]
-            }
-          }
-        }
-      }
-    }
-  }
-}