Skip to content

jev-setup.md

Latest commit

 

History

History
66 lines (45 loc) · 3.37 KB

jev-setup.md

File metadata and controls

66 lines (45 loc) · 3.37 KB
Raw

Set up JEV assistance

Back to README · Architecture

JEV is optional assistance for SYNAPSE. It uses a TypeSafe API key, separate from your generation model's credentials.

Add your key

  1. Open Connect models → JEV / TypeSafe key setup.
  2. Paste the key into the masked TypeSafe API key field.
  3. Choose Save session key.

The saved key stays in memory until Houdini closes. Closing the dialog or refreshing the panel keeps it. Closing the dialog discards any unsaved text.

Saving does not verify the key, enable JEV or grant permission. The status explicitly says Validity has not been checked.

Enable the assistance you want

Choose an option, then Save JEV preferences:

Option What it does
Rank selected-network actions When you request suggestions, ranks available actions. Choosing one prepares editable prompt text.
Measure routing Records advisory routing judgments. It does not switch your generation model.

Open JEV permissions… to review TypeSafe access for the current project. Your selected generation model stays in place.

flowchart TD
    accTitle: Enable optional JEV assistance
    accDescr: Save a session key, choose assistance preferences, and allow the required TypeSafe access. Ranking prepares a draft; routing measurement records advice. Neither sends a build automatically.
    K["Save TypeSafe<br/>session key"] --> P["Choose assistance<br/>and save preferences"]
    P --> A["Review JEV permissions"]
    A --> R["Request action suggestions"]
    A --> M["Measure routing<br/>during eligible requests"]
    R --> D["Choose a suggestion;<br/>edit the prompt"]
    D --> U["You decide when to send"]
    M --> L["Record advisory judgment;<br/>keep selected model"]
    classDef default fill:#282828,stroke:#555555,color:#E5E5E5
    classDef synapse fill:#FF7457,stroke:#FF7457,color:#1F1F1F
    classDef artist fill:#87CDA5,stroke:#87CDA5,color:#1F1F1F
    class K synapse
    class U artist
Loading

What leaves the panel

Both modes can send the latest request text. Requests over 4,096 characters are skipped rather than truncated. They omit scene snapshots, conversation history and attachments. Only use them with text you permit TypeSafe to receive.

Filters skip detected code and credentials. Action ranking also checks for scene/file paths; routing measurement does not use that extra path filter. These heuristics cannot recognize every secret.

Sources: action ranking, routing projection, TypeSafe adapter.

Clear or replace a key

Clear session key removes the override saved in this dialog. To replace it, paste a new key and save again.

Credential lookup uses this order:

  1. Saved session key.
  2. TYPESAFE_API_KEY in the process environment.
  3. TYPESAFE_API_KEY in the Windows user environment.

Clearing a session key leaves environment configuration intact. SYNAPSE reports when it falls back to that configuration. The key is never written into panel settings or prefilled into the field.

Implementation: credentials, connection dialog, TypeSafe API documentation.