exp-runtime-creator 0.6.0__py3-none-any.whl

exp_runtime/creator/kiwi-hammer.svg

@@ -0,0 +1,73 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512" role="img" aria-labelledby="title desc">
+  <title id="title">EXP Runtime Creator kiwi and hammer</title>
+  <desc id="desc">The EXP Runtime green kiwi slice with a steel claw hammer and a warm wooden handle, representing the episode creator.</desc>
+  <defs>
+    <linearGradient id="skin" x1="92" y1="90" x2="416" y2="434" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#be9256"/>
+      <stop offset="1" stop-color="#74502e"/>
+    </linearGradient>
+    <linearGradient id="flesh" x1="144" y1="92" x2="376" y2="428" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#cfed68"/>
+      <stop offset="0.5" stop-color="#a7d84b"/>
+      <stop offset="1" stop-color="#6ca438"/>
+    </linearGradient>
+    <linearGradient id="wood" x1="-22" y1="80" x2="22" y2="80" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#f4c372"/>
+      <stop offset="0.5" stop-color="#dfa451"/>
+      <stop offset="1" stop-color="#b67638"/>
+    </linearGradient>
+    <linearGradient id="steel" x1="0" y1="-38" x2="0" y2="25" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#e2e9ea"/>
+      <stop offset="0.5" stop-color="#aabcc3"/>
+      <stop offset="1" stop-color="#718b98"/>
+    </linearGradient>
+  </defs>
+  <g transform="rotate(-22 256 256)">
+    <!-- The offset rind gives the slice a little depth without a background. -->
+    <ellipse cx="256" cy="267" rx="201" ry="214" fill="#69472c"/>
+    <ellipse cx="256" cy="247" rx="201" ry="214" fill="url(#skin)"/>
+    <ellipse cx="256" cy="247" rx="184" ry="197" fill="#e0d996"/>
+    <ellipse cx="256" cy="247" rx="177" ry="190" fill="url(#flesh)"/>
+    <g fill="none" stroke="#e3ef9d" stroke-width="7" stroke-linecap="round" opacity="0.48">
+      <path d="M256 76 L256 166 M300 83 L275 166 M342 104 L291 181 M378 141 L305 199 M409 191 L315 222 M414 247 L317 247 M409 302 L311 269 M378 352 L299 289 M342 392 L282 310 M299 414 L267 319 M256 418 L251 322 M211 411 L234 319 M170 390 L220 306 M135 353 L209 288 M106 303 L200 269 M98 247 L197 247 M106 190 L201 225 M135 141 L211 205 M170 103 L225 186 M211 81 L241 168"/>
+    </g>
+    <g transform="translate(256 247) scale(1 1.12)" fill="#293c27">
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(18)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(36)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(54)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(72)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(90)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(108)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(126)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(144)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(162)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(180)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(198)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(216)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(234)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(252)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(270)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(288)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(306)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(324)"/>
+      <path d="M0 -84 C-4 -91 -8 -98 -7 -105 C-6 -114 6 -114 7 -105 C8 -98 4 -91 0 -84Z" transform="rotate(342)"/>
+    </g>
+    <path d="M256 167 C270 161 278 177 283 192 C290 201 282 216 289 228 C296 242 288 250 289 262 C294 279 281 285 278 301 C274 317 263 330 251 324 C239 328 230 313 229 300 C219 290 225 277 219 265 C214 252 223 242 219 231 C216 216 227 211 229 196 C232 180 241 165 256 167Z" fill="#f3efc5"/>
+    <path d="M131 134 C153 101 187 82 224 76" fill="none" stroke="#f5f4c9" stroke-width="8" stroke-linecap="round" opacity="0.65"/>
+  </g>
+  <!-- A light keyline keeps the tool readable over the fruit and at icon sizes. -->
+  <g transform="translate(385 286) rotate(33)" stroke-linejoin="round" stroke-linecap="round">
+    <g fill="none" stroke="#faf3d8" stroke-width="19">
+      <path d="M-15 0 H15 L23 172 Q24 190 6 190 H-6 Q-24 190 -23 172Z"/>
+      <path d="M-24 -32 H35 V-39 H66 Q74 -39 74 -31 V18 Q74 26 66 26 H35 V17 H15 C1 17 -8 11 -20 3 C-39 -11 -62 -7 -87 14 L-103 29 L-97 1 C-88 -24 -68 -36 -42 -36Z"/>
+    </g>
+    <path d="M-15 0 H15 L23 172 Q24 190 6 190 H-6 Q-24 190 -23 172Z" fill="url(#wood)" stroke="#433c32" stroke-width="7"/>
+    <path d="M-5 48 L-10 165" fill="none" stroke="#ffdb94" stroke-width="5"/>
+    <path d="M-21 168 Q0 176 21 168" fill="none" stroke="#a66c36" stroke-width="6"/>
+    <path d="M-24 -32 H35 V-39 H66 Q74 -39 74 -31 V18 Q74 26 66 26 H35 V17 H15 C1 17 -8 11 -20 3 C-39 -11 -62 -7 -87 14 L-103 29 L-97 1 C-88 -24 -68 -36 -42 -36Z" fill="url(#steel)" stroke="#304550" stroke-width="7"/>
+    <path d="M35 -30 V16" fill="none" stroke="#637e8c" stroke-width="5"/>
+    <path d="M-68 -20 Q-45 -29 -23 -23 H23" fill="none" stroke="#f3f7ee" stroke-width="5"/>
+    <path d="M48 -29 H62" fill="none" stroke="#f3f7ee" stroke-width="5"/>
+  </g>
+</svg>

exp_runtime/creator/live.py

@@ -0,0 +1,116 @@
+"""Qt-thread bridge from local MCP requests to the open desktop document."""
+import json
+from pathlib import Path
+import secrets
+import struct
+import time
+
+from PySide6.QtCore import QTimer, Qt
+from PySide6.QtNetwork import QHostAddress, QTcpServer
+from PySide6.QtWidgets import QAbstractSpinBox, QApplication
+
+from .model import ProjectError, project_bytes, project_from_record, project_record
+from .sharing import (MAX_MESSAGE, TIMEOUT, Lease, ProjectBusy, SharingError,
+                      digest, encode_message)
+
+
+class LiveEditor:
+    def __init__(self, editor):
+        self.editor, self.lease = editor, None
+        self.server = QTcpServer(editor)
+        self.connections = {}
+        self.server.newConnection.connect(self.accept)
+
+    def attach(self, path):
+        path = Path(path).resolve() if path else None
+        if self.lease and self.lease.path == path: return
+        if path is not None:
+            if not self.server.isListening() and not self.server.listen(QHostAddress.SpecialAddress.LocalHost, 0):
+                raise SharingError('Cannot start local desktop sharing: ' + self.server.errorString())
+            lease = Lease(path, self.server.serverPort())
+        else:
+            lease = None
+        previous, self.lease = self.lease, lease
+        if previous is not None: previous.close()
+
+    def close(self):
+        self.attach(None)
+        self.server.close()
+        for connection in list(self.connections): connection.abort()
+
+    def accept(self):
+        while self.server.hasPendingConnections():
+            connection = self.server.nextPendingConnection()
+            if len(self.connections) >= 8:
+                connection.abort(); connection.deleteLater(); continue
+            self.connections[connection] = [bytearray(), time.monotonic()]
+            connection.setReadBufferSize(MAX_MESSAGE + 4)
+            connection.readyRead.connect(lambda c=connection: self.receive(c))
+            connection.disconnected.connect(lambda c=connection: self.disconnected(c))
+            timer = QTimer(connection)
+            timer.setSingleShot(True)
+            timer.timeout.connect(lambda c=connection: c.abort())
+            timer.start((TIMEOUT - 2) * 1000)
+
+    def disconnected(self, connection):
+        self.connections.pop(connection, None)
+        connection.deleteLater()
+
+    def receive(self, connection):
+        if connection not in self.connections: return
+        buffer, started = self.connections[connection]
+        buffer.extend(bytes(connection.readAll()))
+        if time.monotonic() - started > TIMEOUT - 3 or len(buffer) > MAX_MESSAGE + 4:
+            connection.abort(); return
+        if len(buffer) < 4: return
+        size, = struct.unpack('>I', buffer[:4])
+        if not 0 < size <= MAX_MESSAGE:
+            connection.abort(); return
+        if len(buffer) < size + 4: return
+        try:
+            message = json.loads(buffer[4:])
+            response = self.dispatch(message)
+        except (ProjectError, ValueError, TypeError, KeyError, OSError, RecursionError) as error:
+            response = dict(error=str(error), code=getattr(error, 'code', 'invalid_request'))
+        # One request per connection; dispatch and all UI changes run on the
+        # Qt thread, so a revision check and replacement cannot interleave.
+        self.connections.pop(connection, None)
+        connection.write(encode_message(response))
+        connection.disconnectFromHost()
+
+    def dispatch(self, message):
+        if (not isinstance(message, dict) or self.lease is None
+                or not isinstance(message.get('token'), str)
+                or not secrets.compare_digest(message['token'], self.lease.record['token'])
+                or message.get('path') != str(self.lease.path)):
+            raise ProjectError('Unknown desktop session')
+        editor, path = self.editor, self.lease.path
+        if Path(editor.path).resolve() != path: raise SharingError('Desktop project changed; reread the project')
+        if QApplication.activeModalWidget() is not None or QApplication.mouseButtons() != Qt.MouseButton.NoButton:
+            raise ProjectBusy('Desktop is editing a dialog or dragging a selection; retry after it finishes.')
+        focus = QApplication.focusWidget()
+        if focus is not None:
+            spin = focus if isinstance(focus, QAbstractSpinBox) else focus.parentWidget()
+            if isinstance(spin, QAbstractSpinBox) and not spin.hasAcceptableInput():
+                raise ProjectBusy('Finish entering the number in the desktop editor, then retry.')
+        revision = digest(project_bytes(editor.project, path))
+        if message.get('action') == 'read':
+            return dict(project=project_record(editor.project), revision=revision, unsaved=editor.dirty)
+        if message.get('action') != 'commit': raise ProjectError('Unknown desktop operation')
+        if message.get('revision') != revision:
+            raise ProjectError('Project changed; read its current revision before editing')
+        candidate = project_from_record(message['project'])
+        encoded = project_bytes(candidate, path)
+        # The workspace validates edit operations before submission. A full
+        # checkpoint restore may contain unfinished connections, just as a
+        # desktop undo can; retain the model's structural validation here.
+        # Recover the entire accepted transaction even if the app exits before
+        # the periodic autosave. Failure leaves the live document untouched.
+        editor.recovery.write(candidate, path)
+        editor.remember()
+        editor.project = candidate
+        if editor.selected not in {node.id for node in candidate.nodes}:
+            editor.selected = candidate.start if any(n.id == candidate.start for n in candidate.nodes) else candidate.nodes[0].id
+        editor.refresh(preserve_focus=True)
+        editor.statusBar().showMessage('Model edits applied. Undo reverses this edit; Save writes the shared project.')
+        return dict(revision=digest(encoded), live=True, unsaved=True)

exp_runtime/creator/mcp_results.py

@@ -0,0 +1,53 @@
+"""Consistent MCP results with a bounded view and recoverable full output."""
+from functools import wraps
+import json
+import uuid
+
+from .model import ProjectError
+
+
+def register(server, workspace, annotations):
+    from mcp.types import CallToolResult, TextContent
+    def response(value, *, error=False):
+        encoded = json.dumps(value, ensure_ascii=False, allow_nan=False)
+        if len(encoded.encode()) > 18000:
+            key = uuid.uuid4().hex
+            workspace.responses[key] = encoded
+            while len(workspace.responses) > 8: workspace.responses.pop(next(iter(workspace.responses)))
+            value = {k: value[k] for k in ('revision', 'valid', 'passed', 'session', 'live', 'unsaved', 'error') if k in value}
+            value.update(result_id=key, truncated=True, characters=len(encoded), next_offset=0,
+                         preview=encoded[:800], next_action='Use result_read to retrieve bounded slices of the full JSON.')
+            encoded = json.dumps(value, ensure_ascii=False)
+        return CallToolResult(content=[TextContent(type='text', text=encoded)], structuredContent=value, isError=error)
+    def tool(*, name=None, title=None):
+        def decorate(fn):
+            @wraps(fn)
+            def invoke(*args, **kwargs):
+                try:
+                    with workspace.lock:
+                        result = fn(*args, **kwargs)
+                    return result if isinstance(result, CallToolResult) else response(result)
+                except (ProjectError, ValueError, KeyError, TypeError, OSError) as error:
+                    from .sharing import SharingError
+                    message = str(error)
+                    stale = 'changed;' in message.lower()
+                    code = 'stale_revision' if stale else getattr(error, 'code', 'invalid_request')
+                    recovery = ('Call project_get and reapply against its revision.' if stale else
+                                'Finish the desktop interaction, then call project_get and retry.' if code == 'project_busy' else
+                                'Reopen the project in the desktop creator, then call project_get before retrying.'
+                                if isinstance(error, SharingError) else
+                                'Check the indicated IDs, paths and schema_get requirements, then retry.')
+                    return response(dict(error=dict(code=code, message=message, recovery=recovery)), error=True)
+            server.tool(name=name, title=title, annotations=annotations)(invoke)
+            return invoke
+        return decorate
+    return tool
+
+
+def media_result(data, mime_type, metadata):
+    import base64
+    from mcp.types import AudioContent, CallToolResult, ImageContent, TextContent
+    block = ImageContent if mime_type.startswith('image/') else AudioContent
+    return CallToolResult(content=[TextContent(type='text', text=json.dumps(metadata)),
+        block(type='image' if mime_type.startswith('image/') else 'audio',
+              data=base64.b64encode(data).decode(), mimeType=mime_type)], structuredContent=metadata)