Add D&D location extractor

internal/modules/dnd/extract/locations/assets/prompts/dnd.locations.yaml

@@ -0,0 +1,42 @@
+id: dnd.locations
+version: "v1"
+default_profile: dnd-extraction
+inputs:
+  - name: transcript
+    required: true
+    content_type: application/json
+  - name: players
+    required: false
+    content_type: text/plain
+  - name: party
+    required: false
+    content_type: text/plain
+  - name: glossary
+    required: false
+    content_type: text/plain
+messages:
+  - role: system
+    content_file: ./sharedassets/common-dnd-system.md
+  - role: user
+    content_file: ./sharedassets/common-dnd-identity.md
+  - role: user
+    content_file: ./sharedassets/common-dnd-references.md
+    cache_control:
+      type: ephemeral
+  - role: user
+    content_file: ./sharedassets/common-dnd-transcript.md
+    cache_control:
+      type: ephemeral
+  - role: user
+    content_file: ./sharedassets/common-dnd-extraction-evidence.md
+  - role: user
+    content_file: ./task.md
+  - role: user
+    content_file: ./instructions.md
+    cache_control:
+      type: ephemeral
+output:
+  format: json
+  validation_mode: json_schema
+  schema_path: dnd_locations_llm.v1.json
+  repair_attempts: 0

internal/modules/dnd/extract/locations/assets/prompts/instructions.md

@@ -0,0 +1,6 @@
+Return only observed location display names and narrow transcript source ranges.
+
+Exclude people, creatures, objects, organizations, abstract concepts, and
+places merely inferred from an event. Omit uncertain or unsupported places.
+Campaign references may clarify terms already present in the transcript, but
+they are not evidence and must never supply a source range.

internal/modules/dnd/extract/locations/assets/prompts/task.md

@@ -0,0 +1,8 @@
+Extract physical places established by the provided Dungeons & Dragons
+transcript and cite where each place is identified.
+
+Include planes, regions, settlements, districts, buildings, rooms, landmarks,
+routes, and geographic features. A generic label such as "the tavern" is
+allowed only when the transcript uses it for a specific place. Keep aliases and
+nested places when the transcript identifies them; do not merge or invent
+qualifiers for similarly named places.

internal/modules/dnd/extract/locations/assets/schemas/dnd_locations_llm.v1.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "notarius.dnd.locations.llm",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["locations"],
+  "properties": {
+    "locations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "source_refs"],
+        "properties": {
+          "name": {"type": "string"},
+          "source_refs": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["start_unit_id", "end_unit_id"],
+              "properties": {
+                "start_unit_id": {"type": "integer"},
+                "end_unit_id": {"type": "integer"}
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}