pycodex-ws 0.4.8__tar.gz → 0.5.0__tar.gz

pycodex_ws-0.5.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.1
+Name: pycodex-ws
+Version: 0.5.0
+Summary: Browser workspace and optional Feishu integration for python-codex
+License-File: LICENSE
+Requires-Python: >=3.7
+Requires-Dist: pillow>=9.0.0
+Requires-Dist: python-codex==0.5.0
+Requires-Dist: websockets<16,>=11
+Description-Content-Type: text/markdown
+
+# pycodex-ws
+
+Browser conversations, a live HTML Canvas, read-only file/diff viewers and
+optional Feishu integration for
+[`python-codex`](https://pypi.org/project/python-codex/).
+Requires Python 3.7+ and installs the matching core version.
+
+## Quick start
+
+```bash
+python3 -m pip install pycodex-ws
+```
+
+Create `workspaces.json`:
+
+```json
+{
+  "workspaces": [
+    {"id": "demo", "work_dir": ".", "state_path": "demo", "enable_board": true}
+  ]
+}
+```
+
+```bash
+pycodex-ws --listen 127.0.0.1:6007 --workspace-config workspaces.json
+```
+
+Open `http://127.0.0.1:6007`. Use `python3 -m workspace_server` if the command
+is not on `PATH`. Keep stdin open while the server runs; EOF initiates shutdown.
+Model configuration comes from `~/.codex/config.toml`.
+
+## Conversations and views
+
+The session sidebar starts collapsed. Hover to preview it, click to keep it
+open, and click the toggle or empty space again to close it. Expansion narrows
+the conversation while keeping the board fixed. On phones, use the header
+buttons to switch between chat and board.
+
+Use the expanded sidebar to create, rename or close sessions. Status dots show
+running sessions and unread replies. `/cd <directory>` changes the current
+session's working directory while idle; `/model`, `/resume`, `/compact` and
+other core session commands are also available.
+
+Click Markdown links to open files and comparisons, for example
+`[source](app.py:42)` or `[changes](diff:HEAD:app.py)`. In a code or diff view,
+select text and choose **Insert into chat** to add editable context to the draft.
+Click a context block to edit or remove it before sending.
+See [view links and supported formats](../../docs/RUNTIME.md#workspace-content-views).
+
+When using a router, its directory groups workspaces by device and lists unread
+workspaces at the top. Device handles reorder the list; pencil buttons edit
+device names.
+
+The [VS Code extension](extensions/vscode/README.md) uses this backend and is
+distributed separately as a VSIX.
+
+## Customize the interface
+
+Click the gear button to start a customization conversation with the Agent.
+Custom files live in the server user's `~/.pycodex/frontend/`:
+
+- `custom.css` and `custom.js`: optional styles and an ES module, loaded automatically.
+- `workspace.html`: optional full-page override; otherwise the packaged page is used.
+- Other files: available at workspace-relative `frontend/<path>` URLs.
+
+Refresh to apply changes and keep the selected conversation. Open the workspace
+with `?builtin=1` to bypass all customizations; click “Re-enable customizations”
+to return. Changes apply to all workspaces for that OS user.
+See the [customization contract](../../docs/RUNTIME.md#frontend-customization).
+
+## Storage
+
+Paths in `workspaces.json` resolve from the configuration directory.
+`state_path` is a unique filename prefix: the example saves sessions in
+`demo.pycodex-ws.json`, file views in `demo.pycodex-views.json`, and Canvas in
+`demo.html`. Suffixes are appended to the complete prefix, including any dots.
+
+Set `enable_board` to `false` to disable Canvas while retaining conversations
+and file views. Session directories and history survive server restarts;
+changing a session's directory does not move Canvas or workspace state files.
+Configuration and restoration details are in the [runtime guide](../../docs/RUNTIME.md).
+
+## Feishu
+
+Install the optional SDK in the workspace's Python environment, then authorize:
+
+```bash
+python3 -m pip install lark-oapi
+python3 -m pycodex_ws.feishu_oauth
+```
+
+Authorization reads app credentials from `~/.codex/.env` and stores the refresh
+token in `~/.codex/.feishu_refresh_token`. In a workspace session, use
+`/link <feishu-email|open_id|chat_id>` to connect a card and `/unlink` to disconnect.
+Other workspace features work without the SDK.
+
+## Development
+
+From the repository root:
+
+```bash
+uv sync --dev
+uv run pycodex-ws --help
+uv run --dev pytest packages/pycodex-ws/tests
+uv build packages/pycodex-ws
+```
+
+Python integrations use `pycodex_ws.build_runtime(agent)` to include workspace
+commands. See [runtime contracts](../../docs/RUNTIME.md) and
+[test documentation](../../tests/TESTS.md).

pycodex_ws-0.5.0/README.md

@@ -0,0 +1,110 @@
+# pycodex-ws
+
+Browser conversations, a live HTML Canvas, read-only file/diff viewers and
+optional Feishu integration for
+[`python-codex`](https://pypi.org/project/python-codex/).
+Requires Python 3.7+ and installs the matching core version.
+
+## Quick start
+
+```bash
+python3 -m pip install pycodex-ws
+```
+
+Create `workspaces.json`:
+
+```json
+{
+  "workspaces": [
+    {"id": "demo", "work_dir": ".", "state_path": "demo", "enable_board": true}
+  ]
+}
+```
+
+```bash
+pycodex-ws --listen 127.0.0.1:6007 --workspace-config workspaces.json
+```
+
+Open `http://127.0.0.1:6007`. Use `python3 -m workspace_server` if the command
+is not on `PATH`. Keep stdin open while the server runs; EOF initiates shutdown.
+Model configuration comes from `~/.codex/config.toml`.
+
+## Conversations and views
+
+The session sidebar starts collapsed. Hover to preview it, click to keep it
+open, and click the toggle or empty space again to close it. Expansion narrows
+the conversation while keeping the board fixed. On phones, use the header
+buttons to switch between chat and board.
+
+Use the expanded sidebar to create, rename or close sessions. Status dots show
+running sessions and unread replies. `/cd <directory>` changes the current
+session's working directory while idle; `/model`, `/resume`, `/compact` and
+other core session commands are also available.
+
+Click Markdown links to open files and comparisons, for example
+`[source](app.py:42)` or `[changes](diff:HEAD:app.py)`. In a code or diff view,
+select text and choose **Insert into chat** to add editable context to the draft.
+Click a context block to edit or remove it before sending.
+See [view links and supported formats](../../docs/RUNTIME.md#workspace-content-views).
+
+When using a router, its directory groups workspaces by device and lists unread
+workspaces at the top. Device handles reorder the list; pencil buttons edit
+device names.
+
+The [VS Code extension](extensions/vscode/README.md) uses this backend and is
+distributed separately as a VSIX.
+
+## Customize the interface
+
+Click the gear button to start a customization conversation with the Agent.
+Custom files live in the server user's `~/.pycodex/frontend/`:
+
+- `custom.css` and `custom.js`: optional styles and an ES module, loaded automatically.
+- `workspace.html`: optional full-page override; otherwise the packaged page is used.
+- Other files: available at workspace-relative `frontend/<path>` URLs.
+
+Refresh to apply changes and keep the selected conversation. Open the workspace
+with `?builtin=1` to bypass all customizations; click “Re-enable customizations”
+to return. Changes apply to all workspaces for that OS user.
+See the [customization contract](../../docs/RUNTIME.md#frontend-customization).
+
+## Storage
+
+Paths in `workspaces.json` resolve from the configuration directory.
+`state_path` is a unique filename prefix: the example saves sessions in
+`demo.pycodex-ws.json`, file views in `demo.pycodex-views.json`, and Canvas in
+`demo.html`. Suffixes are appended to the complete prefix, including any dots.
+
+Set `enable_board` to `false` to disable Canvas while retaining conversations
+and file views. Session directories and history survive server restarts;
+changing a session's directory does not move Canvas or workspace state files.
+Configuration and restoration details are in the [runtime guide](../../docs/RUNTIME.md).
+
+## Feishu
+
+Install the optional SDK in the workspace's Python environment, then authorize:
+
+```bash
+python3 -m pip install lark-oapi
+python3 -m pycodex_ws.feishu_oauth
+```
+
+Authorization reads app credentials from `~/.codex/.env` and stores the refresh
+token in `~/.codex/.feishu_refresh_token`. In a workspace session, use
+`/link <feishu-email|open_id|chat_id>` to connect a card and `/unlink` to disconnect.
+Other workspace features work without the SDK.
+
+## Development
+
+From the repository root:
+
+```bash
+uv sync --dev
+uv run pycodex-ws --help
+uv run --dev pytest packages/pycodex-ws/tests
+uv build packages/pycodex-ws
+```
+
+Python integrations use `pycodex_ws.build_runtime(agent)` to include workspace
+commands. See [runtime contracts](../../docs/RUNTIME.md) and
+[test documentation](../../tests/TESTS.md).

{pycodex_ws-0.4.8 → pycodex_ws-0.5.0}/pycodex_router/index.html

@@ -19,6 +19,8 @@
       --danger: #b54739;
       --unread-bg: #fff7f4;
       --unread-line: #ead0c8;
+      --breathing-duration: 1.2s;
+      --breathing-ease: cubic-bezier(0.4, 0, 0.2, 1);
       font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
     }
     @media (prefers-color-scheme: dark) {
@@ -97,7 +99,7 @@
     .activity-badge[hidden] { display: none; }
     .workspace-group-name .device-working { margin-left: 8px; white-space: nowrap; }
     .activity-badge[data-state="working"] { color: var(--green); background: var(--green-soft); }
-    .activity-badge[data-state="working"]::before { content: ""; width: 5px; height: 5px; border-radius: 50%; background: currentColor; animation: spinner-pulse 1.2s cubic-bezier(0.4, 0, 0.2, 1) infinite; }
+    .activity-badge[data-state="working"]::before { content: ""; width: 5px; height: 5px; border-radius: 50%; background: currentColor; animation: spinner-pulse var(--breathing-duration) var(--breathing-ease) infinite; }
     @keyframes spinner-pulse {
       0%, 100% { opacity: .45; transform: scale(.82); }
       50% { opacity: 1; transform: scale(1.08); }
@@ -643,6 +645,14 @@
         document.getElementById("activity").textContent = running ? `${running} working` : "";
       }
 
+      document.addEventListener("animationstart", event => {
+        if (event.animationName !== "spinner-pulse") return;
+        // Include pseudo-elements and anchor new indicators to the page's breathing phase.
+        for (const animation of event.target.getAnimations({subtree: true})) {
+          if (animation.animationName === event.animationName) animation.startTime = 0;
+        }
+      });
+
       async function refresh() {
         if (refreshing) return;
         refreshing = true;

{pycodex_ws-0.4.8 → pycodex_ws-0.5.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pycodex-ws"
-version = "0.4.8"
+version = "0.5.0"
 description = "Browser workspace and optional Feishu integration for python-codex"
 readme = "README.md"
 requires-python = ">=3.7"
 dependencies = [
-    "python-codex==0.4.8",
+    "python-codex==0.5.0",
     "pillow>=9.0.0",
     "websockets>=11,<16",
 ]

{pycodex_ws-0.4.8 → pycodex_ws-0.5.0}/workspace_server/app.py

@@ -68,6 +68,7 @@ from pycodex.events import (
 )
 from pycodex.model import DEFAULT_CODEX_CONFIG_PATH
 from pycodex.utils import uuid7_string
+from pycodex.utils.compat import importlib_metadata
 from pycodex.utils.event_helpers import (
     completed_history,
     shorten_title,
@@ -76,6 +77,11 @@ from pycodex.utils.session_persist import load_display_history
 from pycodex_ws import build_runtime
 from pycodex_router.protocol import trusted_agent_request
 
+from .customization import (
+    frontend_asset_response,
+    frontend_directory,
+    load_workspace_template,
+)
 from .runtime_info import runtime_info_prompt
 from .workspace_views import WorkspaceViewOpener
 from .workspaces import (
@@ -950,6 +956,7 @@ def create_multi_workspace_app(
                 entry.definition.board_path,
                 title=entry.definition.workspace_id,
                 work_dir=entry.definition.work_dir,
+                builtin=request.query_params.get("builtin") == "1",
             )
         )
 
@@ -996,7 +1003,11 @@ def create_multi_workspace_app(
 
     async def workspace_new_session(request: Request) -> JSONResponse:
         entry = _workspace_entry_or_404(registry, request.path_params["workspace_id"])
-        return await _new_session_response(entry.manager)
+        return await _new_session_response(entry.manager, request)
+
+    def workspace_frontend_asset(request: Request) -> Response:
+        _workspace_entry_or_404(registry, request.path_params["workspace_id"])
+        return frontend_asset_response(request.path_params["asset_path"])
 
     async def workspace_delete_session(request: Request) -> JSONResponse:
         entry = _workspace_entry_or_404(registry, request.path_params["workspace_id"])
@@ -1082,6 +1093,10 @@ def create_multi_workspace_app(
         ),
         Route("/w/{workspace_id}/api/sessions", workspace_sessions, methods=["GET"]),
         Route("/w/{workspace_id}/api/sessions", workspace_new_session, methods=["POST"]),
+        Route(
+            "/w/{workspace_id}/frontend/{asset_path:path}",
+            workspace_frontend_asset, methods=["GET", "HEAD"],
+        ),
         Route(
             "/w/{workspace_id}/api/sessions/{session_id}",
             workspace_delete_session, methods=["DELETE"],
@@ -1368,7 +1383,10 @@ def _install_workspace_routes(
     view_asset_cache = {}
 
     async def index(request: Request) -> HTMLResponse:
-        return _html_response(_render_workspace_shell(board_path, work_dir=work_dir))
+        return _html_response(_render_workspace_shell(
+            board_path, work_dir=work_dir,
+            builtin=request.query_params.get("builtin") == "1",
+        ))
 
     async def favicon(request: Request) -> Response:
         return Response(status_code=204)
@@ -1404,7 +1422,10 @@ def _install_workspace_routes(
         return _sessions_response(manager)
 
     async def new_session(request: Request) -> JSONResponse:
-        return await _new_session_response(manager)
+        return await _new_session_response(manager, request)
+
+    def frontend_asset(request: Request) -> Response:
+        return frontend_asset_response(request.path_params["asset_path"])
 
     async def delete_session(request: Request) -> JSONResponse:
         return await _delete_session_response(manager, request.path_params["session_id"])
@@ -1449,6 +1470,7 @@ def _install_workspace_routes(
         Route("/ws/session", websocket_backend_hint, methods=["GET"]),
         Route("/api/sessions", sessions, methods=["GET"]),
         Route("/api/sessions", new_session, methods=["POST"]),
+        Route("/frontend/{asset_path:path}", frontend_asset, methods=["GET", "HEAD"]),
         Route("/api/sessions/{session_id}", delete_session, methods=["DELETE"]),
         Route("/api/sessions/{session_id}/read", read_session, methods=["POST"]),
         Route("/api/session", session, methods=["GET"]),
@@ -1619,15 +1641,27 @@ def _read_session_response(
     return _sessions_response(manager)
 
 
-async def _new_session_response(manager: "WorkspaceSessionManager") -> JSONResponse:
-    session_id = await manager.create_session()
+async def _new_session_response(
+    manager: "WorkspaceSessionManager", request: Request,
+) -> JSONResponse:
+    payload = await _json_object_body(request) if await request.body() else {}
+    title = payload.get("title", "")
+    prompt = payload.get("prompt", "")
+    if not isinstance(title, str) or not isinstance(prompt, str):
+        raise HTTPException(status_code=422, detail="title and prompt must be strings")
+    session_id = await manager.create_session(title=title)
+    result = (
+        await manager.get(session_id).submit(prompt, sender="web")
+        if prompt else {"ok": True}
+    )
     return JSONResponse(
         {
-            "ok": True,
+            **result,
             "session_id": session_id,
             "sessions": manager.list_sessions(),
             "snapshot": session_snapshot(manager.get(session_id)),
-        }
+        },
+        status_code=200 if result["ok"] else 400,
     )
 
 
@@ -2034,17 +2068,21 @@ def _render_workspace_shell(
     board_path: "typing.Union[Path, None]",
     title: "typing.Union[str, None]" = None,
     work_dir: "typing.Union[Path, None]" = None,
+    builtin: bool = False,
 ) -> str:
     board_label = str(board_path) if board_path is not None else "No board"
     cwd_label = str(work_dir or Path.cwd())
     page_title = str(title or "pycodex workspace")
-    template = (Path(__file__).with_name("workspace.html")).read_text(encoding="utf-8")
+    template = load_workspace_template(builtin)
     return (
         template.replace("__WORKSPACE_TITLE__", html.escape(page_title))
         .replace("__BOARD_LABEL__", html.escape(board_label))
         .replace("__CWD_LABEL__", html.escape(cwd_label))
         .replace("__ENABLE_BOARD__", "true" if board_path is not None else "false")
         .replace("__BOARD_URL__", "board" if board_path is not None else "about:blank")
+        .replace("__FRONTEND_DIRECTORY__", html.escape(str(frontend_directory())))
+        .replace("__PACKAGE_DIRECTORY__", html.escape(str(Path(__file__).resolve().parent)))
+        .replace("__PACKAGE_VERSION__", html.escape(importlib_metadata.version("pycodex-ws")))
     )
 
 

{pycodex_ws-0.4.8 → pycodex_ws-0.5.0}/workspace_server/content_views.mjs

@@ -26,6 +26,6 @@ Click to edit context; Backspace / Delete to remove`,this.element.append(n,docum
         type: "workspace-preview-ready", generation,
       }, "*"));
     })();`,e.head.prepend(s);let n=e.doctype?new this.window.XMLSerializer().serializeToString(e.doctype)+`
-`:"";this.frame.srcdoc=n+e.documentElement.outerHTML,this.generation=i,this.source=t}capture(){return this.position}destroy(){this.window.removeEventListener("message",this.receive)}},P=class{constructor({content:t,renderMarkdown:e,loadEditor:i=null,onInsertContext:s=null,createHtmlPreview:n=(o,r)=>new O(o,r)}){this.content=t,this.document=t.ownerDocument,this.renderMarkdown=e,this.onInsertContext=s,this.loadEditor=i||(()=>this.loadEditorAssets()),this.editorAssets=null,this.createHtmlPreview=n,this.activeId=null,this.editor=null,this.htmlPreview=null,this.generation=0,this.remaining=new Set,this.editorStates=new Map,this.previews=new Map,this.scrollPositions=new Map,this.sourceViews=new Set,this.pendingSelection=null,this.selectionRevision=0}loadEditorAssets(){if(!this.editorAssets){let t=this.document.createElement("link");t.rel="stylesheet",t.href=new URL("./editor.css",import.meta.url).href;let e=new Promise((i,s)=>{t.addEventListener("load",i,{once:!0}),t.addEventListener("error",()=>s(new Error("Editor stylesheet request failed.")),{once:!0})});this.document.head.appendChild(t),this.editorAssets=Promise.all([import("./editor.mjs"),e]).then(([i])=>i).catch(i=>{throw t.remove(),this.editorAssets=null,i})}return this.editorAssets}retain(t){this.remaining=new Set(t);for(let e of[this.editorStates,this.previews,this.scrollPositions,this.sourceViews])for(let i of e.keys())this.remaining.has(i)||e.delete(i)}clear(t=""){this.generation+=1,this.editor?(this.remaining.has(this.activeId)&&this.editorStates.set(this.activeId,this.editor.capture()),this.editor.destroy(),this.editor=null):this.htmlPreview?(this.remaining.has(this.activeId)&&this.scrollPositions.set(this.activeId,this.htmlPreview.capture()),this.htmlPreview.destroy(),this.htmlPreview=null):this.remaining.has(this.activeId)&&this.previews.has(this.activeId)&&this.scrollPositions.set(this.activeId,[this.content.scrollLeft,this.content.scrollTop]),this.activeId=null,this.content.classList.remove("code-view"),this.content.classList.remove("html-view"),this.content.textContent="",t&&this.content.appendChild(y(this.document,"div","content-placeholder",t))}async show(t,e,i=null,s=null){i&&e.revision<i.contentRevision&&(i=null),this.pendingSelection=i,s==="preview"?this.sourceViews.delete(t):(i||s==="source")&&this.sourceViews.add(t);let n=e.documents[0],o=e.kind==="file"&&!this.sourceViews.has(t),r=o&&/\.(md|markdown)$/i.test(n.label)&&this.renderMarkdown,d=o&&/\.html?$/i.test(n.label);if(this.activeId===t&&this.htmlPreview&&d)return this.htmlPreview.update(n.text);if(this.activeId===t&&this.editor&&!r&&!d){let m=this.generation;try{await this.editor.update(e),m===this.generation&&await this.applySelection(t,i)}catch(v){if(m===this.generation)throw v}return}this.clear(),this.activeId=t;let h=this.generation;if(e.kind==="diff"||!n.image_url&&!r&&!d){this.content.classList.add("code-view"),this.content.appendChild(y(this.document,"div","content-placeholder","Loading code viewer\u2026"));try{let m=await this.loadEditor();if(h!==this.generation)return;this.content.textContent="";let v=y(this.document,"div","workspace-editor");this.content.appendChild(v);let g=this.onInsertContext&&(E=>{h===this.generation&&this.activeId===t&&this.onInsertContext(E)}),S=await m.createSnapshotEditor(v,e,this.editorStates.get(t),g);if(h!==this.generation){S.destroy();return}this.editor=S}catch(m){if(h!==this.generation)return;this.content.textContent="",this.content.appendChild(y(this.document,"div","content-placeholder","Unable to load code viewer: "+m.message));return}await this.applySelection(t,i);return}if(d)return this.content.classList.add("html-view"),this.htmlPreview=this.createHtmlPreview(this.content,this.scrollPositions.get(t)),this.htmlPreview.update(n.text);if(!this.previews.has(t)){let m=y(this.document,"div","snapshot"),v=y(this.document,"div","snapshot-heading");if(v.appendChild(y(this.document,"span","snapshot-label",n.label)),v.appendChild(y(this.document,"span","snapshot-stamp","Read only")),m.appendChild(v),n.image_url){let g=y(this.document,"img","snapshot-image");g.alt=n.label,m.appendChild(g)}else m.appendChild(y(this.document,"div","snapshot-markdown markdown"));this.previews.set(t,m)}this.content.appendChild(this.previews.get(t));let u=this.content.querySelector(".snapshot-image");if(u&&u.src!==n.image_url&&(u.src=n.image_url),r){let m=this.content.querySelector(".snapshot-markdown");n.source&&m.setAttribute("data-src-path",n.source.path),this.renderMarkdown(m,n.text)}let[p,k]=this.scrollPositions.get(t)||[0,0];this.content.scrollLeft=p,this.content.scrollTop=k}async applySelection(t,e){if(!e||e.revision<=this.selectionRevision)return;let i=this.editor,s=()=>this.activeId===t&&this.editor===i&&this.pendingSelection===e&&e.revision>this.selectionRevision;s()&&await i.revealLine(e.document,e.line,s)&&(this.selectionRevision=e.revision)}};function F({tabs:c,frame:t,content:e,status:i,request:s,renderMarkdown:n,onInsertContext:o,enableBoard:r=!0}){let d=c.ownerDocument,h=new P({content:e,renderMarkdown:n,onInsertContext:o}),u,p=null,k=!1,m=null,v=null,g;function S(a){let C=d.getElementById("content-tab-"+a);C&&(C.focus({preventScroll:!0}),C.scrollIntoView({block:"nearest",inline:"nearest"}))}function E(a){let C=a.snapshot?a.snapshot.documents.map(l=>l.error):[];i.textContent=[a.error,...C].filter(Boolean).join("; ")||(a.openRequest?"Opening view\u2026":""),i.title=i.textContent,i.hidden=!i.textContent;let R=new Map(Array.from(c.children,l=>[l.dataset.viewId,l])),J=(r?[{id:"board",title:"Canvas",kind:"board"}]:[]).concat(a.views),T=U(a.views);T.set("board",{name:"Canvas",description:""}),J.forEach((l,I)=>{let f=R.get(l.id);if(!f){f=y(d,"div","tab content-tab"),f.dataset.viewId=l.id,f.id="content-tab-"+l.id,f.setAttribute("role","tab"),f.setAttribute("aria-controls",l.id==="board"?t.id:e.id);let D=y(d,"span","tab-label content-tab-label");if(D.appendChild(y(d,"span","content-tab-name")),D.appendChild(y(d,"span","content-tab-description")),f.appendChild(D),f.addEventListener("click",()=>g.select(l.id)),f.addEventListener("keydown",w=>{if(w.target!==f)return;let b=(r?["board"]:[]).concat(g.views.map($=>$.id)),j=b.indexOf(l.id),x=null;w.key==="ArrowRight"&&(x=b[(j+1)%b.length]),w.key==="ArrowLeft"&&(x=b[(j+b.length-1)%b.length]),w.key==="Home"&&(x=b[0]),w.key==="End"&&(x=b[b.length-1]),(w.key==="Enter"||w.key===" ")&&(x=l.id),w.key==="Delete"&&l.id!=="board"&&(w.preventDefault(),g.close(l.id)),x!==null&&(w.preventDefault(),g.select(x),d.getElementById("content-tab-"+x).focus())}),l.id!=="board"){let w=y(d,"button","tab-close content-tab-close");w.type="button",w.title="Close tab",w.setAttribute("aria-label","Close "+l.title),w.innerHTML='<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" aria-hidden="true"><path d="M4 4l8 8M12 4l-8 8"/></svg>',w.addEventListener("click",b=>{b.stopPropagation(),g.close(l.id)}),f.appendChild(w)}}R.delete(l.id);let L=T.get(l.id);f.querySelector(".content-tab-name").textContent=L.name;let V=f.querySelector(".content-tab-description");V.textContent=L.description,V.hidden=!L.description,f.className="tab content-tab"+(l.id===a.activeId?" active":""),f.tabIndex=l.id===a.activeId?0:-1,f.title=l.id==="board"?c.dataset.boardTitle:l.title+(l.live?`
+`:"";this.frame.srcdoc=n+e.documentElement.outerHTML,this.generation=i,this.source=t}capture(){return this.position}destroy(){this.window.removeEventListener("message",this.receive)}},P=class{constructor({content:t,renderMarkdown:e,loadEditor:i=null,onInsertContext:s=null,createHtmlPreview:n=(o,r)=>new O(o,r)}){this.content=t,this.document=t.ownerDocument,this.renderMarkdown=e,this.onInsertContext=s,this.loadEditor=i||(()=>this.loadEditorAssets()),this.editorAssets=null,this.createHtmlPreview=n,this.activeId=null,this.editor=null,this.htmlPreview=null,this.generation=0,this.remaining=new Set,this.editorStates=new Map,this.previews=new Map,this.scrollPositions=new Map,this.sourceViews=new Set,this.pendingSelection=null,this.selectionRevision=0}loadEditorAssets(){if(!this.editorAssets){let t=this.document.createElement("link");t.rel="stylesheet",t.href=new URL("./editor.css",import.meta.url).href;let e=new Promise((i,s)=>{t.addEventListener("load",i,{once:!0}),t.addEventListener("error",()=>s(new Error("Editor stylesheet request failed.")),{once:!0})});this.document.head.insertBefore(t,this.document.head.querySelector("[data-pycodex-custom-style]")),this.editorAssets=Promise.all([import("./editor.mjs"),e]).then(([i])=>i).catch(i=>{throw t.remove(),this.editorAssets=null,i})}return this.editorAssets}retain(t){this.remaining=new Set(t);for(let e of[this.editorStates,this.previews,this.scrollPositions,this.sourceViews])for(let i of e.keys())this.remaining.has(i)||e.delete(i)}clear(t=""){this.generation+=1,this.editor?(this.remaining.has(this.activeId)&&this.editorStates.set(this.activeId,this.editor.capture()),this.editor.destroy(),this.editor=null):this.htmlPreview?(this.remaining.has(this.activeId)&&this.scrollPositions.set(this.activeId,this.htmlPreview.capture()),this.htmlPreview.destroy(),this.htmlPreview=null):this.remaining.has(this.activeId)&&this.previews.has(this.activeId)&&this.scrollPositions.set(this.activeId,[this.content.scrollLeft,this.content.scrollTop]),this.activeId=null,this.content.classList.remove("code-view"),this.content.classList.remove("html-view"),this.content.textContent="",t&&this.content.appendChild(y(this.document,"div","content-placeholder",t))}async show(t,e,i=null,s=null){i&&e.revision<i.contentRevision&&(i=null),this.pendingSelection=i,s==="preview"?this.sourceViews.delete(t):(i||s==="source")&&this.sourceViews.add(t);let n=e.documents[0],o=e.kind==="file"&&!this.sourceViews.has(t),r=o&&/\.(md|markdown)$/i.test(n.label)&&this.renderMarkdown,d=o&&/\.html?$/i.test(n.label);if(this.activeId===t&&this.htmlPreview&&d)return this.htmlPreview.update(n.text);if(this.activeId===t&&this.editor&&!r&&!d){let m=this.generation;try{await this.editor.update(e),m===this.generation&&await this.applySelection(t,i)}catch(v){if(m===this.generation)throw v}return}this.clear(),this.activeId=t;let h=this.generation;if(e.kind==="diff"||!n.image_url&&!r&&!d){this.content.classList.add("code-view"),this.content.appendChild(y(this.document,"div","content-placeholder","Loading code viewer\u2026"));try{let m=await this.loadEditor();if(h!==this.generation)return;this.content.textContent="";let v=y(this.document,"div","workspace-editor");this.content.appendChild(v);let g=this.onInsertContext&&(E=>{h===this.generation&&this.activeId===t&&this.onInsertContext(E)}),S=await m.createSnapshotEditor(v,e,this.editorStates.get(t),g);if(h!==this.generation){S.destroy();return}this.editor=S}catch(m){if(h!==this.generation)return;this.content.textContent="",this.content.appendChild(y(this.document,"div","content-placeholder","Unable to load code viewer: "+m.message));return}await this.applySelection(t,i);return}if(d)return this.content.classList.add("html-view"),this.htmlPreview=this.createHtmlPreview(this.content,this.scrollPositions.get(t)),this.htmlPreview.update(n.text);if(!this.previews.has(t)){let m=y(this.document,"div","snapshot"),v=y(this.document,"div","snapshot-heading");if(v.appendChild(y(this.document,"span","snapshot-label",n.label)),v.appendChild(y(this.document,"span","snapshot-stamp","Read only")),m.appendChild(v),n.image_url){let g=y(this.document,"img","snapshot-image");g.alt=n.label,m.appendChild(g)}else m.appendChild(y(this.document,"div","snapshot-markdown markdown"));this.previews.set(t,m)}this.content.appendChild(this.previews.get(t));let u=this.content.querySelector(".snapshot-image");if(u&&u.src!==n.image_url&&(u.src=n.image_url),r){let m=this.content.querySelector(".snapshot-markdown");n.source&&m.setAttribute("data-src-path",n.source.path),this.renderMarkdown(m,n.text)}let[p,k]=this.scrollPositions.get(t)||[0,0];this.content.scrollLeft=p,this.content.scrollTop=k}async applySelection(t,e){if(!e||e.revision<=this.selectionRevision)return;let i=this.editor,s=()=>this.activeId===t&&this.editor===i&&this.pendingSelection===e&&e.revision>this.selectionRevision;s()&&await i.revealLine(e.document,e.line,s)&&(this.selectionRevision=e.revision)}};function F({tabs:c,frame:t,content:e,status:i,request:s,renderMarkdown:n,onInsertContext:o,enableBoard:r=!0}){let d=c.ownerDocument,h=new P({content:e,renderMarkdown:n,onInsertContext:o}),u,p=null,k=!1,m=null,v=null,g;function S(a){let C=d.getElementById("content-tab-"+a);C&&(C.focus({preventScroll:!0}),C.scrollIntoView({block:"nearest",inline:"nearest"}))}function E(a){let C=a.snapshot?a.snapshot.documents.map(l=>l.error):[];i.textContent=[a.error,...C].filter(Boolean).join("; ")||(a.openRequest?"Opening view\u2026":""),i.title=i.textContent,i.hidden=!i.textContent;let R=new Map(Array.from(c.children,l=>[l.dataset.viewId,l])),J=(r?[{id:"board",title:"Canvas",kind:"board"}]:[]).concat(a.views),T=U(a.views);T.set("board",{name:"Canvas",description:""}),J.forEach((l,I)=>{let f=R.get(l.id);if(!f){f=y(d,"div","tab content-tab"),f.dataset.viewId=l.id,f.id="content-tab-"+l.id,f.setAttribute("role","tab"),f.setAttribute("aria-controls",l.id==="board"?t.id:e.id);let D=y(d,"span","tab-label content-tab-label");if(D.appendChild(y(d,"span","content-tab-name")),D.appendChild(y(d,"span","content-tab-description")),f.appendChild(D),f.addEventListener("click",()=>g.select(l.id)),f.addEventListener("keydown",w=>{if(w.target!==f)return;let b=(r?["board"]:[]).concat(g.views.map($=>$.id)),j=b.indexOf(l.id),x=null;w.key==="ArrowRight"&&(x=b[(j+1)%b.length]),w.key==="ArrowLeft"&&(x=b[(j+b.length-1)%b.length]),w.key==="Home"&&(x=b[0]),w.key==="End"&&(x=b[b.length-1]),(w.key==="Enter"||w.key===" ")&&(x=l.id),w.key==="Delete"&&l.id!=="board"&&(w.preventDefault(),g.close(l.id)),x!==null&&(w.preventDefault(),g.select(x),d.getElementById("content-tab-"+x).focus())}),l.id!=="board"){let w=y(d,"button","tab-close content-tab-close");w.type="button",w.title="Close tab",w.setAttribute("aria-label","Close "+l.title),w.innerHTML='<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" aria-hidden="true"><path d="M4 4l8 8M12 4l-8 8"/></svg>',w.addEventListener("click",b=>{b.stopPropagation(),g.close(l.id)}),f.appendChild(w)}}R.delete(l.id);let L=T.get(l.id);f.querySelector(".content-tab-name").textContent=L.name;let V=f.querySelector(".content-tab-description");V.textContent=L.description,V.hidden=!L.description,f.className="tab content-tab"+(l.id===a.activeId?" active":""),f.tabIndex=l.id===a.activeId?0:-1,f.title=l.id==="board"?c.dataset.boardTitle:l.title+(l.live?`
 Read only \xB7 follows file changes \xB7 `:`
 Read-only snapshot \xB7 `)+new Date(l.created_at).toLocaleString(),f.setAttribute("aria-selected",String(l.id===a.activeId)),f.setAttribute("aria-label",l.title);let A=f.querySelector(".content-tab-close");A&&(A.disabled=a.closing.has(l.id),A.setAttribute("aria-label","Close "+l.title)),c.children[I]!==f&&c.insertBefore(f,c.children[I]||null)}),R.forEach(l=>l.remove()),h.retain(a.views.map(l=>l.id));let q=a.activeId==="board",z=u!==a.activeId,B=z||p!==a.snapshot||k!==a.loading||m!==a.selection||v!==a.displayMode;if(q&&B&&h.clear(),t.hidden=!q,e.hidden=q,!!B&&(u=a.activeId,p=a.snapshot,k=a.loading,m=a.selection,v=a.displayMode,a.activeId?e.setAttribute("aria-labelledby","content-tab-"+a.activeId):e.removeAttribute("aria-labelledby"),e.setAttribute("aria-busy",String(a.loading)),!q)){if(a.snapshot){let l=a.activeId,I=a.snapshot;h.show(l,I,a.selection,a.displayMode).catch(f=>{u!==l||p!==I||(p=null,a.error="Unable to update view: "+f.message,i.textContent=i.title=a.error,i.hidden=!1)})}else h.clear(a.loading?"Loading view\u2026":a.activeId?"View unavailable.":"Open a file link to view it here.");z&&S(a.activeId)}}return g=new N({request:s,enableBoard:r,onChange:E,onSelect:a=>{e.closest(".workspace").dataset.mobilePane="board",S(a)}}),E(g),{start(){g.start(),E(g)},stop(){g.stop(),h.clear(),u=null},poll(){return g.poll()},open(a,C,R){return g.open(a,C,R)}}}export{M as Composer,N as ContentTabs,P as SnapshotDisplay,X as isWorkspaceLink,F as mountContentViews};

pycodex_ws-0.5.0/workspace_server/customization.py

@@ -0,0 +1,80 @@
+"""Workspace frontend template and static resource loading."""
+
+import mimetypes
+from html.parser import HTMLParser
+from pathlib import Path
+
+from starlette.exceptions import HTTPException
+from starlette.responses import FileResponse
+
+
+class _AssetInsertions(HTMLParser):
+    def __init__(self, template: str, additions: dict) -> None:
+        super().__init__()
+        self.lines = template.splitlines(keepends=True)
+        self.additions = additions
+        self.positions = []
+
+    def handle_endtag(self, tag: str) -> None:
+        markup = self.additions.pop(tag, None)
+        if markup is not None:
+            line, column = self.getpos()
+            offset = sum(len(row) for row in self.lines[:line - 1]) + column
+            self.positions.append((offset, markup))
+
+
+def frontend_directory() -> Path:
+    return Path.home() / ".pycodex" / "frontend"
+
+
+def frontend_file(name: str) -> Path:
+    directory = frontend_directory().resolve()
+    path = (directory / name).resolve()
+    try:
+        path.relative_to(directory)
+    except ValueError:
+        raise HTTPException(status_code=404, detail="frontend file not found")
+    return path
+
+
+def load_workspace_template(builtin: bool = False) -> str:
+    packaged = Path(__file__).with_name("workspace.html")
+    if builtin:
+        return packaged.read_text(encoding="utf-8")
+    try:
+        template = frontend_file("workspace.html").read_text(
+            encoding="utf-8", errors="replace"
+        )
+    except FileNotFoundError:
+        template = packaged.read_text(encoding="utf-8")
+    additions = {}
+    for name, closing_tag, markup in [
+        ("custom.css", "head", '<link rel="stylesheet" href="frontend/custom.css" data-pycodex-custom-style>'),
+        ("custom.js", "body", '<script type="module" src="frontend/custom.js"></script>'),
+    ]:
+        try:
+            frontend_file(name).stat()
+        except FileNotFoundError:
+            continue
+        additions[closing_tag] = markup
+    if additions:
+        parser = _AssetInsertions(template, additions)
+        parser.feed(template)
+        for offset, markup in reversed(parser.positions):
+            template = template[:offset] + markup + "\n" + template[offset:]
+    return template
+
+
+def frontend_asset_response(name: str) -> FileResponse:
+    path = frontend_file(name)
+    if not path.is_file():
+        raise HTTPException(status_code=404, detail="frontend file not found")
+    media_type = (
+        "text/javascript" if path.suffix.lower() in {".js", ".mjs"}
+        else mimetypes.guess_type(str(path))[0] or "application/octet-stream"
+    )
+    return FileResponse(
+        str(path),
+        media_type=media_type,
+        headers={"Cache-Control": "no-store", "X-Content-Type-Options": "nosniff"},
+    )

{pycodex_ws-0.4.8 → pycodex_ws-0.5.0}/workspace_server/frontend/content_views.mjs

@@ -328,7 +328,9 @@ export class SnapshotDisplay {
         stylesheet.addEventListener("error",
           () => reject(new Error("Editor stylesheet request failed.")), {once: true});
       });
-      this.document.head.appendChild(stylesheet);
+      this.document.head.insertBefore(
+        stylesheet, this.document.head.querySelector("[data-pycodex-custom-style]")
+      );
       this.editorAssets = Promise.all([import("./editor.mjs"), styles])
         .then(([module]) => module)
         .catch(error => {