Skip to content

Gateway design docs + submodule pointers (#57) - #72

Open
pplupo wants to merge 44 commits into
Euro-Office:mainfrom
pplupo:feature/cdp-gateway-cli
Open

Gateway design docs + submodule pointers (#57)#72
pplupo wants to merge 44 commits into
Euro-Office:mainfrom
pplupo:feature/cdp-gateway-cli

Conversation

@pplupo

@pplupo pplupo commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Gateway design docs + submodule pointers for #57

Documentation and submodule pointer bumps for #57 (Local API / Daemon Mode) — the
actual implementation lives in the companion desktop-sdk and desktop-apps PRs;
this PR carries the design/reference docs and points the submodules at their
gateway-ready commits.

What's here

  • cdp-gateway-cli-plan.md — architecture plan: in-process CDP bridge, transport,
    auth, build/test workflow.
  • gateway-test-case-designs.md — the full test matrix each command family was
    built against, including every correction made against the real sdkjs/*/apiBuilder.js
    source where the original design didn't match the actual API (wrong param shapes,
    unserializable return types, id- vs range-based addressing, etc.) — each correction
    cites the specific source file/line that motivated it.
  • gateway-api-reference.md — full command reference: wire protocol, CLI and MCP
    usage, every implemented command's scope fields/return shape/examples, and a
    table of commands deliberately left unimplemented (with the reason why).
  • Submodule pointers: desktop-apps and desktop-sdk bumped to the commits landing in
    the companion PRs.

See #57 for the original request this implements.


Companion PRs: desktop-sdk#12 · desktop-apps#40

pplupo added 30 commits August 18, 2026 20:32
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…ances

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…objects

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…Index

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
… only

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…m insertion

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
… space

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…-wide search

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…xists

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…ow behavior

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…gles

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…tion API

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…ing option

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…dicated collection

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…rray

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…bjects

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…tation

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
pplupo added 14 commits August 18, 2026 20:32
…ition

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…question

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
… is singular

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Documents every implemented command (13 Word, 16 Cell, 11 Slide -
40 total across the three editors done so far) with scope parameters,
types, required/optional, return shapes, and request/response
examples, generated directly from the committed command source
(wordcommands.cpp/cellcommands.cpp/slidecommands.cpp) rather than from
memory. Covers the wire protocol (request/response JSON, error codes),
eo-ctl CLI usage, and lists the 5 deliberately-deferred commands with
what they're blocked on.

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Adds required rect param and the pdf.getAllAnnots read-back mechanism;
defers pdf.addStamp (AscPDF.STAMP_TYPES enum values not locatable in the
vendored source); simplifies the ink annotation example to [x,y]-pair
paths, converted to the {x,y} object shape by the command's own script.

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
… apiBuilder.js

Renames pdf.search to pdf.searchText; corrects getSelectedText's
non-existent rect param to the real setSelection+getSelectedText
sequence; corrects recognizeContent's expected OCR-text output to
ApiDrawing[] class-type strings, matching what the method actually
returns.

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Splits the original single-call pdf.applyRedact{page,rect} into the real
two-step workflow: pdf.addRedact (creates a pending annotation) then
pdf.applyRedact{} (document-wide, no params, throws if nothing pending).
Documents pdf.searchAndRedact's SearchProps shape and count-based result.

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…lder.js

Converts addPage's ApiPage result to an index and removePage's false-on-
out-of-range return to a thrown error, matching the established
SCRIPT_EXCEPTION contract; replaces E5.3's unverifiable 'remove the only
page' scenario with a confirmed out-of-range case; adds pdf.getPageCount
as the verification path for page-count changes.

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Documents all implemented pdf.* commands (§E1-E5: form fields,
annotations, text search/selection/extraction, redaction, page
operations), a PDF CLI example session, and moves pdf.addStamp into the
not-yet-implemented table. Renumbers the not-yet-implemented section to
§7 and removes the stale 'PDF not yet implemented' note.

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
…reference.md

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
desktop-apps -> 3bad911fb (full gateway command set through PDF, eo-ctl,
gateway.connect, eo-mcp).
desktop-sdk -> 81df5a084 (in-process CDP bridge for the gateway).

Signed-off-by: Peter P. Lupo <pplupo@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant