dsh-opencode-session

Configuration

The plugin row lives in the bundle's cordis.patch.yml; all keys are optional:

- insert:
    - id: opencode-go-session-header
      name: dsh-opencode-session
      config:
        providers: [opencode, opencode-go]   # route keys to attach the header to
        mode: session-id                     # 'session-id' | 'uuid'
        debug: false
        debugFile: null                      # optional absolute path

• providers — provider route keys whose requests get the header. The defaults cover the pi-ai catalog ids opencode and opencode-go; add your own route key when you serve OpenCode through a custom provider name.
• mode
  • session-id (default) — header value = the DSH session id of the model call. Unique per conversation, stable across turns, compaction, retries and process restarts.
  • uuid — a random UUID derived once per DSH session id (opaque; kept in memory, so it resets when the process restarts).
• debug — log every streamed call that receives the header via ctx.logger (the dsh process console).
• debugFile — optional absolute path. When set, every streamed call that receives the header appends one JSON line ({"ts","provider","model","session","header","value"}) to that file — handy when the dsh console is not visible.

To override configuration in a profile without editing the package, add a row with the same id in the profile's own cordis.patch.yml (it replaces the whole config, so restate every key).