Skip to content

docs: dsh 0.1.5-rc.1: Session log format v3 with new event vocabulary - #18

Open
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/sync
Open

github-actions[bot] wants to merge 1 commit into
mainfrom
docs/sync

Conversation

@github-actions

@github-actions github-actions Bot commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

dsh 0.1.5-rc.1 lands a structural change to the Session log — the durable,
on-disk record of every agent interaction — so this release warrants a
human review pass. The persisted event vocabulary changed (assistant/chunk
is gone; system/message and assistant/attempt are new; SurfaceOp.replace
renamed its payload fields), the format writer is now a versioned generation
chain (v0/v1/v2 migrate forward to the current writer) instead of the old
"pre-release, pinned at 0, no compatibility implied" stance, and the docs add
a dedicated version-and-release-status page plus a cookbook for adding the next
edge. Anyone with sessions written by an older dsh will hit translation on open,
and anything parsing the JSONL directly (or merging event types from an
out-of-tree plugin) will break. The npm release also moved, which is itself the
signal this shipped.

Highlights, most interesting first:

  • Session log format is now versioned and migrated: current writers stamp
    SESSION_FORMAT_VERSION (= 3), and released historical formats v0/v1/v2 are
    translated to the current vocabulary on stat/list/open. Historical
    migration refuses unknown event types even when marked ignorable: true;
    current-format restoration still honors them. Old logs are read without
    mutating the source file — a write open publishes the up-converted generation.
  • New session-format-status.md is now the single authority for "what format
    is current / next / released" (checkout writer in code, latestReleasedVersion
    in a release record, evidence tag dsh-v0.1.5-alpha.1). Docs elsewhere link
    to it instead of restating a number — worth a look because it is the new
    contract for anyone reasoning about log compatibility.
  • Event vocabulary broke: assistant/chunk removed in favor of per-attempt
    compact stream records embedded in assistant/message and a new
    assistant/attempt event for failed/retried/cancelled attempts that produce
    no surface message; system/message added as surface node 0 (the system
    prompt is no longer part of request/header); SurfaceOp replace now uses
    startSeq/endSeq; session/end-seed carries { inherited?: true }.
  • SessionHandle.read() now returns SessionHandleReadResult ({ eventState, events }) rather than a bare array — an interface change for any out-of-tree
    persistence backend. RestoredSessionOptions.seedSource became eventState
    (detached | shared-frozen).
  • request/header is stricter: a system field is forbidden, tools: [] and
    adapterDefaults: {} must be omitted; noncanonical headers are rejected at
    seed/append/load instead of normalized.
  • npm moved to latest 0.1.5-rc.1 / alpha 0.1.5-alpha.2 (from latest 0.1.1-rc.2), giving the new Session-format obligations a real published
    release.
  • New str_replace_editor opt-in for the Python SDK repo: sdk-minimal no
    longer ships the editor (nor the filesystem provider); users pass a
    cordis.patch.yml via patches= or $DSH_HOME/profiles/... to add it back.
  • New web-client subsystem pages: client-resources.md (address-based
    dsh-resource:// protocol + useResource hook) and sidebar-right.md
    (per-Session docking surface, tab-type registry, navigation service).
  • New user guide network-proxy.md: HTTP(S)_PROXY support, NO_PROXY
    exclusions, credentials-in-URL, and the paths that stay direct (with a
    warning that a project .env cannot set proxy vars).
  • Attachments widened from image-only to generic files (ctx.fileUploads,
    admitPromptContent, saveFile), and feedback moved into the canonical log
    as feedback/message-put/feedback/message-delete log-only events.
  • Smaller additions: new present tool (deliverables/presented), a Windows
    and WSL 2 development section, provider reasoning-effort configuration
    (reasoningEfforts, compat.thinkingFormat: deepseek), and a workspace-files
    API/service.

@github-actions github-actions Bot changed the title docs: Offline tokenizer zip bumped to v4 in token_usage docs docs: token_usage tokenizer zip bumped from deepseek-v3 to deepseek-v4 Aug 28, 2026
@github-actions github-actions Bot changed the title docs: token_usage tokenizer zip bumped from deepseek-v3 to deepseek-v4 docs: dsh 0.1.2-alpha.2: RemoteError code namespaces, ignorable session events, new Remote API surfaces Aug 30, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-alpha.2: RemoteError code namespaces, ignorable session events, new Remote API surfaces docs: dsh Remote API reworked: RemoteError code namespace, sessionProjections requirement, 0.1.2-alpha.2 Aug 30, 2026
@github-actions github-actions Bot changed the title docs: dsh Remote API reworked: RemoteError code namespace, sessionProjections requirement, 0.1.2-alpha.2 docs: dsh refresh: RemoteError failure vocabulary, mandatory sessionProjections seam, 0.1.2-alpha.2 Aug 31, 2026
@github-actions github-actions Bot changed the title docs: dsh refresh: RemoteError failure vocabulary, mandatory sessionProjections seam, 0.1.2-alpha.2 docs: dsh 0.1.2-alpha.2: RemoteError taxonomy rename, sessionProjections now a required inject across ~20 plugins, new API surface Aug 31, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-alpha.2: RemoteError taxonomy rename, sessionProjections now a required inject across ~20 plugins, new API surface docs: dsh 0.1.2-alpha.3: Remote error codes renamespaced, SQLite persistence dropped, new Remote API cookbook Aug 31, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-alpha.3: Remote error codes renamespaced, SQLite persistence dropped, new Remote API cookbook docs: dsh 0.1.2-alpha: RemoteError code overhaul, ignorable session events, SQLite backend dropped Sep 1, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-alpha: RemoteError code overhaul, ignorable session events, SQLite backend dropped docs: dsh 0.1.2-alpha: RemoteError wire codes, sessionProjections service requirement, new alpha npm release Sep 1, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-alpha: RemoteError wire codes, sessionProjections service requirement, new alpha npm release docs: dsh 0.1.2-alpha: Remote API cookbook, namespaced gateway error codes, subagent/session API overhaul Sep 1, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-alpha: Remote API cookbook, namespaced gateway error codes, subagent/session API overhaul docs: dsh 0.1.2-alpha.4 lands RemoteError taxonomy, session-log format changes, and a sessionProjections core service Sep 1, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-alpha.4 lands RemoteError taxonomy, session-log format changes, and a sessionProjections core service docs: dsh 0.1.2-alpha line lands: report tool removed, send_message takes agent_id, plugins now require sessionProjections Sep 2, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-alpha line lands: report tool removed, send_message takes agent_id, plugins now require sessionProjections docs: dsh 0.1.2-alpha line: handle-based session persistence, subagent messaging rewrite, bundle/package renames Sep 2, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-alpha line: handle-based session persistence, subagent messaging rewrite, bundle/package renames docs: dsh 0.1.2 alpha: session-event format and settings API break, new Remote API cookbook Sep 2, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2 alpha: session-event format and settings API break, new Remote API cookbook docs: dsh 0.1.2-rc.1 (next) adds network-proxy support via new http-proxy util package Sep 3, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1 (next) adds network-proxy support via new http-proxy util package docs: dsh 0.1.2-rc.1 lands HTTP-proxy support; new network-proxy guide and http-proxy package Sep 3, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1: session-log v2 + migrations, generic file attachments, agent/assistant-stream events docs: dsh 0.1.2-rc.1: session-log format v2, generic file uploads, network proxy support Sep 5, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1: session-log format v2, generic file uploads, network proxy support docs: dsh 0.1.2-rc.1 sync: session-log v2 (assistant/chunk → embedded attempt streams), durable file attachments, and new network-proxy guide Sep 5, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1 sync: session-log v2 (assistant/chunk → embedded attempt streams), durable file attachments, and new network-proxy guide docs: dsh 0.1.2-rc.1: session-log v2 format, file uploads, network proxy Sep 5, 2026
@github-actions
github-actions Bot force-pushed the docs/sync branch 2 times, most recently from 186a397 to d4e8da0 Compare September 5, 2026 20:28
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1: session-log v2 format, file uploads, network proxy docs: dsh 0.1.2-rc.1: session-log v2 (embedded assistant streams), generic-file attachments, network-proxy support Sep 5, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1: session-log v2 (embedded assistant streams), generic-file attachments, network-proxy support docs: dsh 0.1.2-rc.1: released session format v2 + new network-proxy/file-attachment docs Sep 6, 2026
@github-actions
github-actions Bot force-pushed the docs/sync branch 2 times, most recently from cc2e8e2 to 56594df Compare September 6, 2026 11:05
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1: released session format v2 + new network-proxy/file-attachment docs docs: dsh 0.1.2-rc.1 lands: session-log format v2 with released migrations, generic file attachments, proxy support Sep 6, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1 lands: session-log format v2 with released migrations, generic file attachments, proxy support docs: dsh 0.1.2-rc.1: session-log format v2 replaces assistant/chunk with embedded streams; generic file uploads and network-proxy support land Sep 6, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1: session-log format v2 replaces assistant/chunk with embedded streams; generic file uploads and network-proxy support land docs: dsh 0.1.2-rc.1: session log v2 embedded assistant streams + generic file attachments Sep 6, 2026
@github-actions
github-actions Bot force-pushed the docs/sync branch 2 times, most recently from 33ae61c to 2dd2428 Compare September 7, 2026 04:51
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1: session log v2 embedded assistant streams + generic file attachments docs: dsh 0.1.2-rc.1: session log v2 (assistant/chunk removed), generic file uploads, and proxy support Sep 7, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1: session log v2 (assistant/chunk removed), generic file uploads, and proxy support docs: dsh 0.1.2-rc.1: session log format v2, generic file attachments, proxy support Sep 7, 2026
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1: session log format v2, generic file attachments, proxy support docs: dsh refresh: attachments widened to generic files, new client-resource and right-sidebar subsystems, npm bumps to 0.1.2-rc.1 Sep 7, 2026
@github-actions github-actions Bot changed the title docs: dsh refresh: attachments widened to generic files, new client-resource and right-sidebar subsystems, npm bumps to 0.1.2-rc.1 docs: dsh 0.1.2-rc.1/0.1.3-alpha.2: session log v1 migration, file attachments, right-sidebar client subsystems Sep 8, 2026
@github-actions
github-actions Bot force-pushed the docs/sync branch 2 times, most recently from 4d94f92 to 45aad1d Compare September 8, 2026 11:26
@github-actions github-actions Bot changed the title docs: dsh 0.1.2-rc.1/0.1.3-alpha.2: session log v1 migration, file attachments, right-sidebar client subsystems docs: dsh npm 0.1.2-rc/0.1.3-alpha: session-log format v2 embeds assistant streams, attachments widen to files, new client-resources/sidebar/proxy docs Sep 8, 2026
@github-actions github-actions Bot changed the title docs: dsh npm 0.1.2-rc/0.1.3-alpha: session-log format v2 embeds assistant streams, attachments widen to files, new client-resources/sidebar/proxy docs docs: dsh session log moves to versioned V3 format with embedded assistant streams (npm 0.1.2-rc.1) Sep 8, 2026
@github-actions github-actions Bot changed the title docs: dsh session log moves to versioned V3 format with embedded assistant streams (npm 0.1.2-rc.1) docs: dsh refresh: session-log format v3, system prompt moved into the log, durable file uploads, network-proxy support Sep 8, 2026
dsh 0.1.5-rc.1 lands a structural change to the Session log — the durable,
on-disk record of every agent interaction — so this release warrants a
human review pass. The persisted event vocabulary changed (`assistant/chunk`
is gone; `system/message` and `assistant/attempt` are new; `SurfaceOp.replace`
renamed its payload fields), the format writer is now a versioned generation
chain (`v0/v1/v2` migrate forward to the current writer) instead of the old
"pre-release, pinned at 0, no compatibility implied" stance, and the docs add
a dedicated version-and-release-status page plus a cookbook for adding the next
edge. Anyone with sessions written by an older dsh will hit translation on open,
and anything parsing the JSONL directly (or merging event types from an
out-of-tree plugin) will break. The npm release also moved, which is itself the
signal this shipped.

Highlights, most interesting first:

- Session log format is now versioned and migrated: current writers stamp
  `SESSION_FORMAT_VERSION` (= 3), and released historical formats v0/v1/v2 are
  translated to the current vocabulary on `stat`/`list`/`open`. Historical
  migration refuses unknown event types even when marked `ignorable: true`;
  current-format restoration still honors them. Old logs are read without
  mutating the source file — a write open publishes the up-converted generation.
- New `session-format-status.md` is now the single authority for "what format
  is current / next / released" (checkout writer in code, `latestReleasedVersion`
  in a release record, evidence tag `dsh-v0.1.5-alpha.1`). Docs elsewhere link
  to it instead of restating a number — worth a look because it is the new
  contract for anyone reasoning about log compatibility.
- Event vocabulary broke: `assistant/chunk` removed in favor of per-attempt
  compact stream records embedded in `assistant/message` and a new
  `assistant/attempt` event for failed/retried/cancelled attempts that produce
  no surface message; `system/message` added as surface node 0 (the system
  prompt is no longer part of `request/header`); `SurfaceOp` replace now uses
  `startSeq`/`endSeq`; `session/end-seed` carries `{ inherited?: true }`.
- `SessionHandle.read()` now returns `SessionHandleReadResult` (`{ eventState,
  events }`) rather than a bare array — an interface change for any out-of-tree
  persistence backend. `RestoredSessionOptions.seedSource` became `eventState`
  (`detached` | `shared-frozen`).
- `request/header` is stricter: a `system` field is forbidden, `tools: []` and
  `adapterDefaults: {}` must be omitted; noncanonical headers are rejected at
  seed/append/load instead of normalized.
- npm moved to `latest 0.1.5-rc.1` / `alpha 0.1.5-alpha.2` (from `latest
  0.1.1-rc.2`), giving the new Session-format obligations a real published
  release.
- New `str_replace_editor` opt-in for the Python SDK repo: `sdk-minimal` no
  longer ships the editor (nor the filesystem provider); users pass a
  `cordis.patch.yml` via `patches=` or `$DSH_HOME/profiles/...` to add it back.
- New web-client subsystem pages: `client-resources.md` (address-based
  `dsh-resource://` protocol + `useResource` hook) and `sidebar-right.md`
  (per-Session docking surface, tab-type registry, navigation service).
- New user guide `network-proxy.md`: `HTTP(S)_PROXY` support, `NO_PROXY`
  exclusions, credentials-in-URL, and the paths that stay direct (with a
  warning that a project `.env` cannot set proxy vars).
- Attachments widened from image-only to generic files (`ctx.fileUploads`,
  `admitPromptContent`, `saveFile`), and feedback moved into the canonical log
  as `feedback/message-put`/`feedback/message-delete` log-only events.
- Smaller additions: new `present` tool (`deliverables/presented`), a Windows
  and WSL 2 development section, provider reasoning-effort configuration
  (`reasoningEfforts`, `compat.thinkingFormat: deepseek`), and a workspace-files
  API/service.
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.

0 participants