feat(web): add session diagnostic export by wbxl2000 · Pull Request #1646 · MoonshotAI/kimi-code

wbxl2000 · 2026-07-13T21:22:15Z

Related Issue

No linked issue. The Web UI had no equivalent of the TUI diagnostic session export.

Problem

Web users could not download a session archive with browser-side diagnostics, which made failures in the REST/WebSocket/UI path difficult to investigate. Reusing the existing export code also required tighter resource ownership because active logs can grow or rotate while an archive is being written, and browser downloads buffer the final ZIP in memory.

What changed

Add the Web /export command and POST /api/v1/sessions/{session_id}/export, returning either a ZIP or the existing JSON error envelope.
Add a separate always-on, metadata-only browser event ring. Prompt text, WebSocket payloads, and console arguments remain in the opt-in debug trace and are never included in the session archive.
Stream session files from bounded, lazily opened file sources; keep at most one session source open, snapshot active log sizes, propagate cancellation, and clean up source handles and temporary archives on every exit path.
Limit Web archives to 64 MiB because the browser buffers the response before saving it; larger sessions can still use the CLI or TUI export.
Document the command in English and Chinese, update OpenAPI coverage, and add a changeset.

Verification

pnpm --filter @moonshot-ai/agent-core-v2 exec vitest run test/app/sessionExport/sessionExport.test.ts (11 tests; repeated serially, including 320 files, append, abort, and size-limit cases)
Three isolated RSS samples for that suite: 167,215,104 / 165,134,336 / 166,510,592 bytes
pnpm exec vitest run test/sessions.test.ts test/openapi.test.ts test/apiSurface.snapshot.test.ts in packages/kap-server (58 tests)
pnpm test in apps/kimi-web (497 tests)
pnpm test in packages/protocol (524 tests)
Typecheck: protocol, agent-core-v2, kap-server, kimi-web
Build: kimi-web, docs
pnpm exec oxlint --type-aware --quiet (0 errors)
pnpm lint:domain in packages/agent-core-v2
git diff --check

Checklist

I have read the CONTRIBUTING document.
I have linked a related issue, or explained the problem above.
I have added tests that prove my feature works.
Ran gen-changesets skill, or this PR needs no changeset.
Ran gen-docs skill, or this PR needs no doc update.

changeset-bot · 2026-07-13T21:22:21Z

🦋 Changeset detected

Latest commit: 106ead4

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@moonshot-ai/kimi-code	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

wbxl2000 · 2026-07-13T21:22:58Z

@codex review

pkg-pr-new · 2026-07-13T21:25:02Z

pnpm dlx https://pkg.pr.new/@moonshot-ai/kimi-code@106ead4

npx https://pkg.pr.new/@moonshot-ai/kimi-code@106ead4

commit: 106ead4

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3631a0f555

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

wbxl2000 · 2026-07-13T22:17:46Z

@codex review

chatgpt-codex-connector · 2026-07-13T22:23:15Z

Codex Review: Didn't find any major issues. 🎉

Reviewed commit: 14530835e8

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

wbxl2000 · 2026-07-14T04:32:59Z

@codex

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 106ead4e81

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector · 2026-07-14T04:41:30Z

+      rawResponse: {
+        200: { type: 'string', format: 'binary' },
+      },


Avoid using a binary 200 schema for JSON error replies

In the validation, missing-session, and too-large cases this route sends an errEnvelope without changing the status, so those failures are still 200 responses. Because the route registers the only 200 response schema as a binary string, Fastify will select that serializer for the envelope object instead of the JSON envelope shape that postZip() expects, so users can receive a malformed/opaque error rather than the intended SESSION_NOT_FOUND or FILE_TOO_LARGE code. Either send error envelopes with non-200 statuses or avoid installing a binary-only 200 serializer for the error path.

Useful? React with 👍 / 👎.

False positive for kap-server: schema.response never drives runtime serialization here. start.ts replaces both compilers with pass-throughs (app.setSerializerCompiler(() => (data) => JSON.stringify(data))), so error envelopes are serialized as plain JSON regardless of the binary 200 schema. This is covered by tests: test/sessions.test.ts asserts the missing-session path returns the 40401 envelope and the oversized-web-log path returns 40001 with details.

The response schema is only used for the OpenAPI document, and the served document is already accurate: openapi/transforms.ts rewrites this route's 200 response to describe both application/zip (binary) and application/json (error envelope) — see GET /openapi.json ("Session export archive or JSON error envelope").

wbxl2000 · 2026-07-14T05:06:47Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5eb62178b3

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

chatgpt-codex-connector · 2026-07-14T05:13:53Z

+  try {
+    sessionLogSource = await openOptionalZipSource(sessionLogPath, input.signal);
+    if (input.request.includeGlobalLog === true && input.globalLogPath !== undefined) {
+      globalSource = await openOptionalZipSource(input.globalLogPath, input.signal);


Keep optional global-log failures from aborting export

When includeGlobalLog is true and the configured global log path exists but cannot be opened or is not a regular file (for example EACCES or EISDIR), this call rethrows through openOptionalZipSource and the whole session export fails. The global log is optional and the previous best-effort path omitted it on read failures, so a bad app log should not prevent users from downloading the session archive; catch non-abort global-log errors here and leave globalLogPath unset.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-07-14T05:13:53Z

+export const exportSessionRequestSchema = z
+  .object({


Accept an omitted export request body

Because the route installs validateBody with this schema, a POST /sessions/{id}/export that has no JSON body parses undefined and returns 40001 before the handler runs. Since web_log is optional and exporting does not otherwise require a body, direct REST clients or generated clients that omit the optional request body cannot download an archive unless they know to send {}; mirror the compact request schema by preprocessing undefined to {}.

Useful? React with 👍 / 👎.

wbxl2000 added 2 commits July 14, 2026 04:12

feat(web): add session diagnostic export

357771d

fix(web): bound session export resources

3631a0f

chatgpt-codex-connector Bot reviewed Jul 13, 2026

View reviewed changes

Comment thread packages/agent-core-v2/src/app/sessionExport/zip.ts Outdated

fix(web): make session export atomic

1453083

wbxl2000 added 2 commits July 14, 2026 11:48

Merge origin/main into codex/web-session-export

f6a1555

feat(web): add session export entry to session menus with item icons

106ead4

chatgpt-codex-connector Bot reviewed Jul 14, 2026

View reviewed changes

wbxl2000 merged commit 5eb6217 into main Jul 14, 2026
14 checks passed

wbxl2000 deleted the codex/web-session-export branch July 14, 2026 04:48

github-actions Bot mentioned this pull request Jul 14, 2026

ci: release packages #1583

Merged

chatgpt-codex-connector Bot reviewed Jul 14, 2026

View reviewed changes

wbxl2000 mentioned this pull request Jul 14, 2026

fix(kap-server): use HTTP error statuses for session export #1670

Open

5 tasks

Uh oh!

Conversation

wbxl2000 commented Jul 13, 2026

Related Issue

Problem

What changed

Verification

Checklist

Uh oh!

changeset-bot Bot commented Jul 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

wbxl2000 commented Jul 13, 2026

Uh oh!

pkg-pr-new Bot commented Jul 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

wbxl2000 commented Jul 13, 2026

Uh oh!

chatgpt-codex-connector Bot commented Jul 13, 2026

Uh oh!

wbxl2000 commented Jul 14, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Jul 14, 2026

Choose a reason for hiding this comment

Uh oh!

wbxl2000 Jul 14, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

wbxl2000 commented Jul 14, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Jul 14, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Jul 14, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

changeset-bot Bot commented Jul 13, 2026 •

edited

Loading

pkg-pr-new Bot commented Jul 13, 2026 •

edited

Loading