Draft
Conversation
Move and reorganize runtime JS into a new _scripts collection and add a full transcription-assist tool. Renamed/_moved tpen-api.js from _tools to _scripts and updated its candidate/unit handling (accepts pct/percent, normalizes unit handling, changes selector prefix), returns manifestUri and canvas dimensions. Add new runtime modules: message-bridge.js (origin allow-list, context + separate ID token request/subscribe flows), prompt-builder.js (tool-call JSON prompt generator), and transcription-assist.js (UI orchestration, canvas resolution, prompt generation, ID token request, candidate parsing/normalization and save flow). Update _pages/transcription-assist.html to load the new script path, add ID token UI button and metadata. Update docs (CONTRIBUTING.md, README.md and generated _site files) to reflect new _scripts layout, prompt schema, save flow, and security notes. Add several _tools markdown docs (COMMON_TASKS, HANDWRITING_TEXT_RECOGNITION, IMAGE_ANALYSIS, TPEN_API). Remove old generated /_site tool JS artifacts. Update _config.yml to publish the new scripts collection.
Add a browser-side fallback for read-only LLM outputs that can only GET resources: UI, handlers, and docs to let users paste serialized JSON payloads and submit Update Page/Columns/Lines requests to TPEN. Includes: - UI/CSS: Manual TPEN Update panel with three payload cards (Page, Columns, Lines) and responsive layout. - JS: new API_BASE, textarea parsing, fetch helpers, method inference for columns, and submit handlers wired to buttons; status updates and token checks included. - Prompt changes: update prompt-builder to reference authoritative instruction files and require a single JSON tool-call response. - Docs: COMMON_TASKS.md and TPEN_API.md updated to document the browser-submit fallback contract and user workflow. - Minor fix: tighten unit validation in tpen-api.js to only allow empty/percent/pct when rawUnit is present. This change enables models that cannot perform writes to still produce save-ready payloads which the user can submit from the browser using their authenticated session.
Add helpers to build the tools base URL and derive instruction file URLs (handles /split-tools/ paths and server-side fallback). Include idToken in the transcription prompt context and replace hardcoded _tools paths with generated URLs. Tighten instructions: prevent fabricating transcription lines or bounds, only emit save-ready JSON when explicitly requested, and ask to report missing resources instead of inventing data.
Open
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request introduces the initial implementation of the TPEN-Prompts split-tool scaffold for manuscript transcription with LLM assistance. It establishes the project structure, adds a comprehensive contribution guide, and implements the first split-screen interface with supporting JavaScript modules for context handling, prompt building, and secure messaging. The most important changes are:
Project Structure and Documentation
CONTRIBUTING.mdoutlining interface contracts, message formats, candidate requirements, save flow, runtime module responsibilities, security requirements, and PR expectations.README.mdto describe the project layout, source directories, and example interface usage._config.ymlto define collections for pages, scripts, and tools, and to ensure proper site generation.Split-Tool Interface Implementation
_pages/transcription-assist.html, a split-screen tool interface that receives TPEN context, generates LLM prompts, and provides manual fallback for updating TPEN via JSON. Includes UI for context display, prompt generation, and manual API submission.JavaScript Module Scaffolding
_scripts/message-bridge.jsfor secure message passing with origin validation, context and ID token request/response handling, and context validation._scripts/prompt-builder.jsto generate context-aware, instruction-driven LLM prompts, including authoritative instruction file links and sample save-ready JSON payloads.