Skip to content

CiteCiter v0.1.0

Choose a tag to compare

@kirkchinese kirkchinese released this 17 Aug 15:21
· 10 commits to main since this release

CiteCiter v0.1.0

CiteCiter v0.1.0 is the first public release of the selection-scoped explanation sidebar for DeepSeek Harness Web.

Packaging notice: the npm 0.1.0 artifact omitted the DSH bundle declaration and therefore installed only as a plain dependency. Use 0.1.1 or later for one-command DSH profile installation.

CiteCiter is still in early development. Many features need further work, and APIs, compatibility, and installation details may change. Issues and pull requests are welcome.

Highlights

  • Select text inside a completed assistant reply and open the Citer! context-menu action.
  • Resolve the selected conversation node through the parent snapshot and fork at its real completed-turn anchorSeq.
  • Switch the forked child to /permission read-only and fail closed unless DSH reports a successful matched command.
  • Keep all explanation prompts, model output, cancellation, and errors in the child session; CiteCiter does not write to the parent log.
  • Stream the result in DSH's resizable details column with Markdown, code, KaTeX, safe SVG previews, and sandboxed network-free HTML previews.
  • Dispose listeners, slot registrations, subscriptions, and in-flight lifecycle work with the owning Cordis fiber; support client-plugin HMR during development.

Compatibility

  • Node.js ^22.19.0 || >=24.0.0
  • DeepSeek Harness Web, tested with the public 0.1.0-rc.6 DSH client packages
  • Cordis ^4.0.1
  • React ^18.2.0

Known limitations

  • Only assistant reply nodes in DSH Web are supported.
  • Explanation children are durable DSH sessions and are not automatically deleted.
  • DSH is still in a prerelease API cycle, so future versions may require CiteCiter changes.
  • There is no settings UI, mobile-specific adaptation, or cross-platform browser CI yet.
  • Unsafe or incomplete HTML/SVG fences intentionally fall back to Markdown code blocks.

Install

dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.1.1

Restart the corresponding DSH Web process and refresh the page after installation.

Verification performed for this release

  • TypeScript typecheck and production build
  • 16 focused Node tests for session lookup, read-only fail-closed behavior, lifecycle races, stale-answer suppression, rich-content safety, and subscriber isolation
  • Real rendered-session browser smoke with parent-log revision checks
  • Cordis client-HMR smoke with old-fiber teardown and new-fiber interaction
  • A real-provider explanation run that settled successfully while leaving the parent session log unchanged
  • npm package allowlist inspection before publication