Merge pull request #7039 from deepseek-harness/fix/independent-session-forks

fix(session): 普通 fork 独立运行并保留子代理创建者语义
This commit is contained in:
Dudu-0223 authored and GitHub committed 2026-10-23 15:35:17 +08:00
commit 92f6c1320b
81 files changed
+697 -368

No files matched your search

@@ -0,0 +1,22 @@
# Bilingual-pair consistency record for 2026-10-23-independent-session-forks.md (docs/i18n/README.md): per heading
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write .agents/notes/implemented/architecture/2026-10-23-independent-session-forks.md
/agent-note-ordinary-forks-have-no-durable-creator-relationship:
en: 543a84d51e8aea24
zh: 24aeec7c3cdf5900
/agent-note-ordinary-forks-have-no-durable-creator-relationship/problem:
en: d2edaafdd83e5974
zh: 57ce9ad368c404c2
/agent-note-ordinary-forks-have-no-durable-creator-relationship/decision:
en: aae0053e9dc3be9f
zh: bd37095fd5c43c3d
/agent-note-ordinary-forks-have-no-durable-creator-relationship/compatibility:
en: 8393e8526f927134
zh: c957cbde9dc6712d
/agent-note-ordinary-forks-have-no-durable-creator-relationship/alternatives-considered:
en: 748aa21283186e02
zh: 51d3b0207b250784
/agent-note-ordinary-forks-have-no-durable-creator-relationship/consequences:
en: adcb06ccf7503e55
zh: 30e02c6104eefe01
@@ -0,0 +1,35 @@
# Agent Note: Ordinary forks have no durable creator relationship
Status: implemented
English | [中文](2026-10-23-independent-session-forks.zh.md)
## Problem
Using `parentSession` for both copied history and delegation makes an ordinary fork appear to be a subagent. Consumers can emit false child-start notifications, hide resumable sessions, or impose source-relative ordering. Removing the writer alone leaves historical ordinary forks misclassified and exposes a V4 reader assumption: inherited delivery acknowledgements require a parent id even though the validated seed range already identifies copied events.
## Decision
Ordinary forks preserve their complete selected prefix, `isSeeded`, `inheritedEventCount`, and inherited end-seed marker, but record no source id. Subagents retain their direct creator, including when their backend copies history. `origin: subagent` supplies coarse classification; a valid own-range descriptor separately supplies continuation identity. Historical parent metadata remains readable and unchanged. Runtime Agent ownership remains governed by the [explicit identity decision](2026-08-31-explicit-agent-runtime-identity.md).
The V4 reader permits another Session's delivery id only inside the validated inherited range. Own-range markers still require the current id, and every active-generation `throughSeq` must precede its marker. These checks do not require a persistent source relationship.
## Compatibility
This is a same-version behavior change with no declared persistence-type change. The generated inventory reports no schema transitions, so no new type acknowledgement or finalization checkpoint is needed. Existing ordinary forks and subagent logs retain their meanings, and the new reader accepts both parent-bearing and parentless seeds without rewriting either. Frozen schemas and historical generations remain untouched.
The released `dsh-v0.2.0-rc.2` validator and the reviewed master baseline share the parent-dependent delivery check. Before changing that check, real plain and compressed JSONL probes verified rejection through both read and write opens for parentless ordinary and nested forks, with byte-identical files afterward. Rejection occurs during completed-log relationship validation, before a handle is granted or tail repair runs. Older readers report corruption rather than an upgrade diagnostic; that diagnostic limitation is explicit in the [upgrade guide](../../../../docs/upgrade-guide/v0.2.1-rc.3/independent-session-forks/guide.md). Parentless seeds without active inherited delivery markers remain readable. This observed admission behavior meets the [safe-refusal rule](../process/2026-10-08-session-reader-compatibility-review.md); optionality alone is not the justification.
## Alternatives considered
**Keep the source under another field.** A replacement such as `forkSourceId` preserves the durable relationship the user chose to remove, along with its downstream maintenance cost.
**Erase parent metadata from existing logs.** Historical mutation loses recorded information and violates immutable-generation guarantees. Consumers distinguish old ordinary forks without cleanup.
**Bump the format solely because older readers reject some new logs.** The existing inherited range and complete-log check prevent unsafe execution and truncation. A global bump and adjacent copy add no protection to this transition; same-version refusal has a documented diagnostic limitation.
## Consequences
Ordinary-fork source tracing is intentionally unavailable in new data. Manual ordering preserves saved positions and treats new forks like other ordinary sessions. Operation-local source access preserves title increments and workspace selection. The [side-session proposal](../../proposed/feature/2026-07-08-interactive-side-sessions.md) retains its separate handback idea but cannot use a stored ordinary-fork parent. Runtime ownership, projection-cache identity, and Team membership decisions remain independently useful and are not superseded.
Verification covers real fork/persist/reopen paths for ordinary, nested, historical, and subagent seeds, rejection without writes for foreign own-range delivery and invalid coordinates, SDK notification classification, ACP resume, client ordering, and title generation. TypeScript and Python recorded SDK scenarios create ordinary and nested forks plus historical parent-bearing metadata while retaining the expected real-subagent lifecycle.
@@ -0,0 +1,35 @@
# Agent Note: 普通 fork 不保留持久创建者关系
Status: implemented
[English](2026-10-23-independent-session-forks.md) | 中文
## 问题
同时用 `parentSession` 表示复制历史和委派,会让普通 fork 看起来像子代理。消费方可能发送错误的子代理启动通知、隐藏可恢复会话,或施加相对来源的排序。仅删除写入仍会误分类历史普通 fork,并暴露 V4 reader 的一项假设:继承投递确认要求父 ID,尽管已验证的 seed 区间已经标识复制事件。
## 决策
普通 fork 保留完整的选定前缀、`isSeeded`、`inheritedEventCount` 及继承结束标记,但不记录来源 ID。子代理保留直接创建者,包括 backend 复制历史的情况。`origin: subagent` 提供粗粒度分类;有效的自身区间 descriptor 单独提供继续运行身份。历史父元数据保持可读且不变。运行时 Agent 归属仍遵循[显式身份决策](2026-08-31-explicit-agent-runtime-identity.zh.md)。
V4 reader 仅在已验证的继承区间中允许其他 Session 的投递 ID。自身区间标记仍要求当前 ID,每个活动代际的 `throughSeq` 必须早于其标记。这些检查不需要持久来源关系。
## 兼容性
这是没有声明持久化类型变化的同版本行为变更。生成清单报告没有 schema 转换,因此不需要新增类型确认或定稿检查点。已有普通 fork 和子代理日志保留其含义,新 reader 接受有父关系及无父关系的 seed,且不改写任一种。冻结 schema 与历史代际保持不变。
已发布的 `dsh-v0.2.0-rc.2` 校验器与所审查 master 基线具有相同的依赖父关系的投递检查。修改此检查之前,真实的普通及压缩 JSONL 探针验证:无父关系的普通和嵌套 fork 在 read、write 打开时都被拒绝,之后文件字节完全一致。拒绝发生在完整日志的关系校验期间,早于授予句柄或尾部修复。旧 reader 报告损坏而非升级诊断;[升级指南](../../../../docs/upgrade-guide/v0.2.1-rc.3/independent-session-forks/guide.zh.md)明确说明这一诊断限制。没有活动继承投递标记的无父关系 seed 仍然可读。这一已观察到的接纳行为满足[安全拒绝规则](../process/2026-10-08-session-reader-compatibility-review.zh.md);可选字段本身不是依据。
## 考虑过的替代方案
**用其他字段保留来源。** `forkSourceId` 等替代字段保留了用户决定移除的持久关系及其下游维护成本。
**清除已有日志的父元数据。** 修改历史会丢失已记录信息,并违反代际不可变保证。消费方可以在不清理的情况下区分旧普通 fork。
**仅因旧 reader 拒绝部分新日志就升级格式。** 现有继承区间和完整日志检查阻止不安全执行与截断。全局升级和相邻复制不会为这次转换增加保护;同版本拒绝的诊断限制已有明确记录。
## 影响
新数据有意不支持普通 fork 的来源追踪。手动排序保留已保存位置,将新 fork 当作其他普通会话处理。操作期间访问来源保留标题递增和工作区选择。[侧会话提案](../../proposed/feature/2026-07-08-interactive-side-sessions.zh.md)保留独立的交回设想,但不能使用普通 fork 的持久父字段。运行时归属、投影缓存身份和 Team 成员关系决策仍分别有用,未被取代。
验证覆盖普通、嵌套、历史及子代理 seed 的真实 fork/持久化/重新打开路径,自身区间外来投递及非法坐标的无写入拒绝,SDK 通知分类、ACP 恢复、客户端排序与标题生成。TypeScript 和 Python 录制 SDK 场景创建普通及嵌套 fork 和携带历史父元数据的会话,同时保留真正子代理的预期生命周期。
@@ -9,14 +9,14 @@
en: 212258ada8f174eb
zh: 9a02b100533118fe
/agent-note-interactive-side-sessions-and-merge-back/proposal:
en: 5fa7d2000db6b265
zh: a892b74299e0f984
en: 7f24e61247bf2d84
zh: aaa397f7d4aaf351
/agent-note-interactive-side-sessions-and-merge-back/alternatives-considered:
en: de50cab213a61b91
zh: 85b912193092dfe2
/agent-note-interactive-side-sessions-and-merge-back/acceptance-criteria:
en: 17d0937a1f28b1ac
zh: 9710ab0af3268da1
en: 3dbfd9c97279519f
zh: 719f54d2c0a68e0a
/agent-note-interactive-side-sessions-and-merge-back/risks:
en: 2435d8e2aba0d1c1
zh: 3854c476bea061d4
@@ -12,7 +12,7 @@ A user may want to explore a question from a live session without changing its m
A **side session** is an ordinary live session forked at the source's last completed turn, attached to its own agent, framed as a read-only advisor, and able to **merge back** one condensed note.
- **Fork and attach:** create the child with the parent's balanced completed-turn prefix, `parentSession`, `meta.isSeeded: true`, and the exact sibling `inheritedEventCount`. This composes `ctx.agents.create({ seed, inheritedEventCount, meta })`; it adds no core service or session-store method.
- **Fork and attach:** create the child with the parent's balanced completed-turn prefix, `meta.isSeeded: true`, and the exact sibling `inheritedEventCount`. The caller retains any handback target separately from the copied Session under the [independent-fork decision](../../implemented/architecture/2026-10-23-independent-session-forks.md). This composes `ctx.agents.create({ seed, inheritedEventCount, meta })`; it adds no core service or session-store method.
- **Advisor framing:** inject one plugin-sourced `context/message` after creation that tells the child to explain without mutating or continuing the task. Keeping the system prompt byte-identical preserves the provider prefix cache over inherited history.
- **Merge-back:** ask the child for a length-capped handback, then inject one plugin-sourced `context/message` into the parent. The next parent request sees it at its logged position, preserving replay and [request reconstructability](../../implemented/architecture/2026-07-05-reconstructable-requests.md) without a new session event.
- **Presentation:** invocation, session switching, and handback rendering belong to the first client UI. This Agent Note specifies only the client-independent mechanics.
@@ -28,7 +28,7 @@ Rewind productization, session-tree views, a model-facing side-session tool, and
## Acceptance criteria
- Forking leaves the source untouched and creates a child with the balanced completed-turn prefix, `parentSession`, `isSeeded: true`, the exact `inheritedEventCount`, and a byte-identical system prompt.
- Forking leaves the source untouched and creates a child with the balanced completed-turn prefix, `isSeeded: true`, the exact `inheritedEventCount`, and a byte-identical system prompt.
- Advisor framing adds exactly one plugin-sourced `context/message` at the head of the child's appended history, rather than changing its system prompt.
- Merge-back adds exactly one length-capped `context/message` with source `plugin: sidechat`; the next parent request and replay see it at the same position.
- Parent and child run concurrently without log or stream cross-talk.
@@ -12,7 +12,7 @@ Status: proposed
**侧会话(side session)**是一个普通的活跃会话,从源会话的最后一个已完成轮次 fork 而来,绑定到自己的 agent(智能体),定位为只读顾问,并能**合并回写**一条精简笔记。
- **Fork 并绑定:**用 parent 的平衡 completed-turn prefix、`parentSession`、`meta.isSeeded: true` 与精确 sibling `inheritedEventCount` 创建 child。这组合 `ctx.agents.create({ seed, inheritedEventCount, meta })`;不新增 core service 或 Session-store method。
- **Fork 并绑定:**用 parent 的平衡 completed-turn prefix、`meta.isSeeded: true` 与精确 sibling `inheritedEventCount` 创建 child。这组合 `ctx.agents.create({ seed, inheritedEventCount, meta })`;不新增 core service 或 Session-store method。 依据[独立 fork 决策](../../implemented/architecture/2026-10-23-independent-session-forks.zh.md),调用方将交回目标保存在所复制 Session 之外。
- **顾问定位:**创建后注入一条插件来源的 `context/message`,告知子会话只做解释,不执行变更或继续任务。保持系统提示词逐字节一致,可在继承的历史上保留提供方的前缀缓存。
- **合并回写:**向子会话请求一条有长度上限的 handback,然后向父会话注入一条插件来源的 `context/message`。父会话的下一次请求在日志所记录的位置看到该消息,保持回放与[请求可重建性](../../implemented/architecture/2026-07-05-reconstructable-requests.zh.md),无需新增会话事件。
- **呈现:**调用方式、会话切换与 handback 渲染属于首个客户端拥有的界面。本 Agent Note 仅规定与界面无关的机制。
@@ -28,7 +28,7 @@ Status: proposed
## 验收标准
- Fork 不改变 source Session,创建的 child 带有平衡 completed-turn prefix、`parentSession`、`isSeeded: true`、精确 `inheritedEventCount` 与逐字节相同 system prompt。
- Fork 不改变 source Session,创建的 child 带有平衡 completed-turn prefix、`isSeeded: true`、精确 `inheritedEventCount` 与逐字节相同 system prompt。
- 顾问定位在子会话追加历史的头部恰好添加一条插件来源的 `context/message`,而非修改其系统提示词。
- 合并回写恰好添加一条有长度上限的 `context/message`,来源为 `plugin: sidechat`;父会话的下一次请求与回放在相同位置看到它。
- 父会话与子会话并发运行,日志和流之间无串扰。
+4 -2
View File
@@ -307,15 +307,17 @@ describe('web e2e: long Chat interaction contract', () => {
await expect.poll(() => page.evaluate(() => navigator.clipboard.readText()), { timeout: 5_000 })
.toBe(expectedUserText)
const existing = new Set(scaffold.ctx.agents.list().map(agent => agent.id))
await turnTailRow.hover()
await turnTailRow.getByRole('button', { name: 'Branch into a new conversation', exact: true }).click()
await expect.poll(
() => scaffold.ctx.agents.list().find(agent => agent.session.header.parentSession === SessionId(SESSION_ID)),
() => scaffold.ctx.agents.list().find(agent => !existing.has(agent.id)),
{ timeout: 15_000 },
).toBeDefined()
const child = scaffold.ctx.agents.list()
.find(agent => agent.session.header.parentSession === SessionId(SESSION_ID))
.find(agent => !existing.has(agent.id))
if (child === undefined) throw new Error('message branch did not create a child session')
expect(child.session.header.parentSession).toBeUndefined()
expect(child.session.inheritedEventCount).toBe(boundary.seq + 1)
expect(child.session.snapshotEvents().some(event => carries(event, branchAssistantMarker))).toBe(true)
expect(child.session.snapshotEvents().some(event => carries(event, FIXTURE.markers.user(BRANCH_TURN + 1)))).toBe(false)
+1 -1
View File
@@ -114,7 +114,7 @@ describe('web e2e: exact-boundary fork seeds branch closers and continues', () =
const child = scaffold.ctx.sessions.get(childId)
if (child === undefined) throw new Error('fork did not publish a live child session')
expect(child.header.parentSession).toBe(SessionId(SEED_ID))
expect(child.header.parentSession).toBeUndefined()
// inheritedEventCount counts only the copied parent prefix; the closers are child work.
expect(child.inheritedEventCount).toBe(forkAt + 1)
expect(child.snapshotEvents()[forkAt]?.type).toBe('tool/call')
+13 -6
View File
@@ -371,13 +371,15 @@ describe('web e2e: message IconActions and clocks on settled history', () => {
it.skipIf(MODE === 'record')('forks through the settled-message and session-row actions', async () => {
onTestFailed(() => saveFailureShot(page, 'web-e2e-message-fork'))
// The second answer is followed by another completed user turn in the source.
const existing = new Set(scaffold.ctx.agents.list().map(agent => agent.id))
await page.getByRole('button', { name: 'Branch into a new conversation' }).nth(1).click()
await expect.poll(
() => scaffold.ctx.agents.list().find(agent => agent.session.header.parentSession === SessionId(SEED_ID)),
() => scaffold.ctx.agents.list().find(agent => !existing.has(agent.id)),
{ timeout: 15_000 },
).toBeDefined()
const child = scaffold.ctx.agents.list().find(agent =>
agent.session.header.parentSession === SessionId(SEED_ID))!
!existing.has(agent.id))!
expect(child.session.header.parentSession).toBeUndefined()
expect(child.inbox.nextTurn).toEqual([])
expect(child.session.snapshotEvents().some(event => event.type === 'agent/inbox/spliced'
&& event.data.inserted.some(message => message.content.some(part =>
@@ -405,11 +407,13 @@ describe('web e2e: message IconActions and clocks on settled history', () => {
const buttonBox = await actionButton.boundingBox()
if (buttonBox === null) throw new Error('fork source row action has no layout box')
await page.mouse.click(buttonBox.x + buttonBox.width / 2, buttonBox.y + buttonBox.height / 2)
const beforeNested = new Set(scaffold.ctx.agents.list().map(agent => agent.id))
await page.getByRole('menuitem', { name: 'Fork session' }).click()
await expect.poll(
() => scaffold.ctx.agents.list().filter(agent => agent.session.header.parentSession !== undefined).length,
() => scaffold.ctx.agents.list().filter(agent => !beforeNested.has(agent.id)).length,
{ timeout: 15_000 },
).toBe(2)
).toBe(1)
expect(scaffold.ctx.agents.list().find(agent => !beforeNested.has(agent.id))!.session.header.parentSession).toBeUndefined()
await expect.poll(
() => page.locator('[role="treeitem"]').count(),
{ timeout: 10_000 },
@@ -445,8 +449,10 @@ describe('web e2e: message IconActions and clocks on settled history', () => {
expect(scaffold.ctx.agents.get(id)).toBeUndefined()
await row.hover()
await row.locator('button[aria-label^="Session actions for "]').click()
const existing = new Set(scaffold.ctx.agents.list().map(agent => agent.id))
await page.getByRole('menuitem', { name: 'Fork session', exact: true }).click()
await expect.poll(() => scaffold.ctx.agents.list().some(agent => agent.session.header.parentSession === id)).toBe(true)
await expect.poll(() => scaffold.ctx.agents.list().some(agent => !existing.has(agent.id))).toBe(true)
expect(scaffold.ctx.agents.list().find(agent => !existing.has(agent.id))!.session.header.parentSession).toBeUndefined()
expect(scaffold.ctx.agents.get(id)).toBeUndefined()
expect(await row.getAttribute('aria-selected')).not.toBe('true')
})
@@ -481,6 +487,7 @@ describe('web e2e: message IconActions and clocks on settled history', () => {
if (path === '/api/session/fork') forkRequests.push(path)
}
page.on('request', trackFork)
const existing = new Set(scaffold.ctx.agents.list().map(agent => agent.id))
try {
await row.hover()
await row.locator('button[aria-label^="Session actions for "]').click()
@@ -501,7 +508,7 @@ describe('web e2e: message IconActions and clocks on settled history', () => {
expect(await readdir(directory)).toContain(`session.v${SESSION_FORMAT_VERSION}.jsonl.zstd`)
expect(await readFile(predecessor)).toEqual(source)
expect(forkRequests).toEqual(['/api/session/fork'])
expect(scaffold.ctx.agents.list().filter(agent => agent.session.header.parentSession === id)).toEqual([])
expect(scaffold.ctx.agents.list().filter(agent => !existing.has(agent.id) && agent.id !== id)).toEqual([])
} finally {
page.off('request', trackFork)
}
+1 -1
View File
@@ -1209,7 +1209,7 @@ async function assertReplaySession(
let expectedPath = fixturePath
const userPrompts = fixtureUserPrompts(expected)
const candidates = sessions.filter((session) => {
if (session.header.parentSession !== undefined) return false
if (session.header.origin === 'subagent' || session.header.isSeeded) return false
const actual = session.snapshotEvents().flatMap((event) => {
if (event.type !== 'user/message' || event.data.source.kind !== 'user') return []
const text = event.data.content.filter(block => block.type === 'text').map(block => block.text).join('')
+10 -5
View File
@@ -93,14 +93,17 @@ describe.skipIf(mode === 'record')('web e2e: workspace shortcuts', () => {
await bind('Fork session')
const original = await readPersistedEvents(scaffold, sourceId)
const lastEnd = original.findLastIndex(event => event.type === 'turn/end')
const existing = new Set(scaffold.ctx.agents.list().map(agent => agent.id))
await page.keyboard.press('Meta+Shift+Comma')
await expect.poll(() => scaffold.ctx.agents.list().find(agent => agent.session.header.parentSession === sourceId)).toBeDefined()
const child = scaffold.ctx.agents.list().find(agent => agent.session.header.parentSession === sourceId)!
await expect.poll(() => scaffold.ctx.agents.list().find(agent => !existing.has(agent.id))).toBeDefined()
const child = scaffold.ctx.agents.list().find(agent => !existing.has(agent.id))!
expect(child.session.header.parentSession).toBeUndefined()
const childId = child.session.header.id
await expect.poll(async () => (await readPersistedEvents(scaffold, childId)).some(event => event.type === 'session/title' && event.data.title === 'T4 source (1)')).toBe(true)
const copied = await readPersistedEvents(scaffold, childId)
expect(copied.slice(0, lastEnd + 1)).toEqual(original.slice(0, lastEnd + 1))
const sourceRow = page.getByRole('treeitem').filter({ has: page.getByText('T4 source', { exact: true }) })
expect(child.session.header.parentSession).toBeUndefined()
const childRow = page.getByRole('treeitem').filter({ has: page.getByText('T4 source (1)', { exact: true }) })
await childRow.waitFor()
expect(await sourceRow.getAttribute('aria-selected')).toBe('true')
@@ -218,6 +221,7 @@ it.skipIf(mode === 'record')('explains a first-turn fork refusal and retries fro
await connectFreshWorkspace(page, scaffold.workspaceCwd)
const source = scaffold.ctx.agents.list().find(agent => !before.has(agent.id))
if (source === undefined) throw new Error('The workspace did not create a Session')
const existing = new Set(scaffold.ctx.agents.list().map(agent => agent.id))
source.session.append('turn/start', { turn: 1 })
const user = source.session.append('user/message', createUserMessage({
content: [{ type: 'text', text: 'The first turn has not ended.' }], source: { kind: 'user' },
@@ -240,7 +244,7 @@ it.skipIf(mode === 'record')('explains a first-turn fork refusal and retries fro
await compareOrRefreshGolden(join(root, 'fork-unavailable.expected.md'),
await unavailable.ariaSnapshot(), mode)
expect(await selected.textContent()).toContain('First turn')
expect(scaffold.ctx.agents.list().filter(agent => agent.session.header.parentSession === source.id)).toHaveLength(0)
expect(scaffold.ctx.agents.list().filter(agent => !existing.has(agent.id))).toHaveLength(0)
expect(forkWarnings).toEqual([])
source.session.append('turn/end', { turn: 1, reason: { kind: 'completed' } })
@@ -252,8 +256,9 @@ it.skipIf(mode === 'record')('explains a first-turn fork refusal and retries fro
await scaffold.ctx.sessions.flush(source.session)
await page.getByText('The second turn has not ended.', { exact: true }).waitFor()
await page.keyboard.press('Meta+Shift+Comma')
await expect.poll(() => scaffold.ctx.agents.list().find(agent => agent.session.header.parentSession === source.id)).toBeDefined()
const child = scaffold.ctx.agents.list().find(agent => agent.session.header.parentSession === source.id)!
await expect.poll(() => scaffold.ctx.agents.list().find(agent => !existing.has(agent.id))).toBeDefined()
const child = scaffold.ctx.agents.list().find(agent => !existing.has(agent.id))!
expect(child.session.header.parentSession).toBeUndefined()
const childRow = page.getByRole('treeitem').filter({ has: page.getByText('First turn (1)', { exact: true }) })
await childRow.waitFor()
expect(await childRow.getAttribute('aria-selected')).toBe('false')
+2 -2
View File
@@ -33,5 +33,5 @@
en: a5bc20c3f2a1b370
zh: 91773a281410b2f4
/deepseek-harness-architecture/where-new-behavior-goes:
en: 9b2eb0539a9cd0d6
zh: 4f575277b91d4e5c
en: ee73b1861378b099
zh: 9a182be609485f67
+1 -1
View File
@@ -162,7 +162,7 @@ New behavior attaches to a documented extension point. Changing the loop itself
| Add durable session state | extend `SessionEventMap`; render and replay from the log |
| Generate session titles | register the sole `ctx.sessionTitle` provider |
| Manage a same-session objective | use `ctx.goals`; continue through `agent/*` |
| Fork a session at a turn boundary | `ctx.agents.create({ sessionId, seed, meta: { parentSession, seedLength } })` — only agent-loop-published sessions persist |
| Fork at a turn boundary | `ctx.agents.create({ sessionId, seed, inheritedEventCount, meta: { isSeeded: true } })` — only agent-loop-published sessions persist |
| Store sessions in a new backend | implement `SessionPersistence` (`create`/`open`/`stat`/`list`/`export`) over the shared handle scaffolding |
| Scope a registration to one agent | use that agent's `agent.ctx` |
+1 -1
View File
@@ -166,7 +166,7 @@ seam 正是替换一个提供方就能改变整个产品的原因。文件系统
| 添加持久会话状态 | 扩展 `SessionEventMap`;从日志渲染和回放 |
| 生成会话标题 | 注册唯一的 `ctx.sessionTitle` 提供方 |
| 管理同会话目标 | 使用 `ctx.goals`;通过 `agent/*` 续跑 |
| 在轮次边界 fork 会话 | `ctx.agents.create({ sessionId, seed, meta: { parentSession, seedLength } })`——只有经 agent-loop 发布的会话才会持久化 |
| 在轮次边界 fork 会话 | `ctx.agents.create({ sessionId, seed, inheritedEventCount, meta: { isSeeded: true } })`——只有经 agent-loop 发布的会话才会持久化 |
| 在新后端存储会话 | 基于共享的句柄脚手架实现 `SessionPersistence`(`create`/`open`/`stat`/`list`/`export`) |
| 将注册项限定到单个 agent | 使用该 agent 的 `agent.ctx` |
+92 -92
View File
@@ -12,8 +12,8 @@
en: 3e24343c4745793d
zh: 90f808fd6b79c5a3
/session-persistence-event-catalog/event-envelope:
en: 534866c6916c3fca
zh: 75bdeae58a3ddc20
en: 56414ffd00cdc32a
zh: 6dc11eb013e95e41
/session-persistence-event-catalog/events:
en: f4776ba3d0fd53ce
zh: e86769f50a69055a
@@ -45,11 +45,11 @@
en: 44426b6cd0dc01cf
zh: 44426b6cd0dc01cf
/session-persistence-event-catalog/events/assistant/assistant-attempt-log-only:
en: d5bb28e89c4ade31
zh: 89e520bc5cdcb1e7
en: f330b2521ca12383
zh: cdc6912a9244677d
/session-persistence-event-catalog/events/assistant/assistant-message-surface:
en: 386dfc397abbc397
zh: 5da0c1921b80d753
en: 95916897e677eee6
zh: e1ea8b17e5af9f35
/session-persistence-event-catalog/events/command:
en: 2cecb5b0ee955732
zh: 2cecb5b0ee955732
@@ -84,8 +84,8 @@
en: 3344204b1858edb1
zh: 3344204b1858edb1
/session-persistence-event-catalog/events/developer/developer-message-surface:
en: 927f25c5dbd69c82
zh: 9c0331f6e61d7e2b
en: fd716cfc669a05a0
zh: 8693a334958ab3cf
/session-persistence-event-catalog/events/feedback:
en: f50dbac6867fa64d
zh: f50dbac6867fa64d
@@ -159,11 +159,11 @@
en: a8df82440ebdf5f8
zh: a8df82440ebdf5f8
/session-persistence-event-catalog/events/request/request-context-log-only:
en: 338d89f911e73657
zh: 3a3248a5f5186222
en: 22abf9a3f69d498f
zh: 94055a136b641207
/session-persistence-event-catalog/events/request/request-header-log-only:
en: a9e0243440ceff1c
zh: a7a822c4593773ed
en: 6c506b420662b60e
zh: 823513802c2cc394
/session-persistence-event-catalog/events/sandbox:
en: ec841ab8439335b0
zh: ec841ab8439335b0
@@ -180,8 +180,8 @@
en: a1ac8f2660a4f61e
zh: a1ac8f2660a4f61e
/session-persistence-event-catalog/events/session/session-end-seed-log-only:
en: 0bf42de8776a1521
zh: 5176eb8530abae29
en: 20645a60e921f012
zh: 7141cafe3a0e71d7
/session-persistence-event-catalog/events/session/session-title-log-only:
en: 6c6a27578dff5828
zh: 9a5add2bc0df2d0a
@@ -198,11 +198,11 @@
en: bd0dcbbc352b771a
zh: bd0dcbbc352b771a
/session-persistence-event-catalog/events/step/step-end-log-only:
en: 24bc99ca25809609
zh: 420384e753feba64
en: b30d8571ba611386
zh: 42e45b49142c306c
/session-persistence-event-catalog/events/step/step-start-log-only:
en: 269a493d00348184
zh: 80feab63a0431c60
en: 161a661514649037
zh: 5a2e3ec5af378746
/session-persistence-event-catalog/events/subagent:
en: 9630752e97ddbfbc
zh: 9630752e97ddbfbc
@@ -219,8 +219,8 @@
en: 8cac41d2fb575975
zh: 8cac41d2fb575975
/session-persistence-event-catalog/events/system/system-message-surface:
en: 78a40d681313dbd4
zh: 45e38b05e0e7521f
en: f08085060f967358
zh: 4d77a8636d9bfef5
/session-persistence-event-catalog/events/team:
en: a640800a38b3c874
zh: a640800a38b3c874
@@ -246,8 +246,8 @@
en: 28a24430609494b2
zh: 28a24430609494b2
/session-persistence-event-catalog/events/tool/tool-call-log-only:
en: d73a3ecfb593be69
zh: 17a26c407097fc6d
en: 2edbe249bcd484fc
zh: fa838ad8325507b4
/session-persistence-event-catalog/events/tool/tool-ptc-dispatch-log-only:
en: a62b38c00afed655
zh: 793bef93e856eafa
@@ -255,8 +255,8 @@
en: da841b1ed3b22c87
zh: 4c9a4d4bc5bd76b6
/session-persistence-event-catalog/events/tool/tool-result-surface:
en: f75f51e576680a18
zh: 83ce9c72a3e81687
en: e5fdf9592ffa86b4
zh: 7455727a8f208a1c
/session-persistence-event-catalog/events/tool-workflow:
en: 1eac7deac6af15f3
zh: 1eac7deac6af15f3
@@ -276,17 +276,17 @@
en: d7e8c999a0851a0c
zh: d7e8c999a0851a0c
/session-persistence-event-catalog/events/turn/turn-end-log-only:
en: 38d2280f449d3112
zh: 0f7f05475ea514a3
en: 7d5bacee7392ed18
zh: 65b8eb8ab9b10ccd
/session-persistence-event-catalog/events/turn/turn-start-log-only:
en: 853b7f23d092c48a
zh: 53e312793b609198
en: 1b5d3369f6178575
zh: 34550bedca73336a
/session-persistence-event-catalog/events/user:
en: d864a88c03e8971c
zh: d864a88c03e8971c
/session-persistence-event-catalog/events/user/user-message-surface:
en: ba681b5ec685d6e8
zh: e4b14b585d2b5804
en: 836d2e0de5f33816
zh: 67055e83e820f5f5
/session-persistence-event-catalog/events/web:
en: d278748103cf1640
zh: d278748103cf1640
@@ -984,8 +984,8 @@
en: e393deed01de3665
zh: 0fa98ad93c22ce79
/session-persistence-event-catalog/resolved-persistence-types/commandsource:
en: 53feeeb70547e7df
zh: 99d9e901d9b4afe5
en: 459a6f8c8800d3e5
zh: f1b2626c08c62b4d
/session-persistence-event-catalog/resolved-persistence-types/compactioncheckpointsource:
en: 87f2aaf2b23a5249
zh: 3d6c5ed6603bee31
@@ -1014,8 +1014,8 @@
en: 3d8a393be23efcde
zh: f95f337d816dbbe7
/session-persistence-event-catalog/resolved-persistence-types/epochheader:
en: c804cb9e2e31c5ec
zh: 3ed7ac59cd1441b7
en: 3bdc8ecd0bdf0c9c
zh: 0fe5b75c174ebab4
/session-persistence-event-catalog/resolved-persistence-types/everyscheduledispatchchange:
en: 54c487394ce0db1d
zh: 48d7c9affbe841cb
@@ -1182,11 +1182,11 @@
en: 488050ba0b6438b4
zh: 2bf607b5ad51e39d
/session-persistence-event-catalog/resolved-persistence-types/requestcontext:
en: 00058b6c2220cdcb
zh: a3426a8c69123e2e
en: 544039047a28b6bb
zh: c691f0bb1e23db08
/session-persistence-event-catalog/resolved-persistence-types/requestheaderreason:
en: 8e563a11c123255f
zh: ebf891f6a3cb93d3
en: 1f691c223f54ab2c
zh: f88fef3ee9745c91
/session-persistence-event-catalog/resolved-persistence-types/sandboxmode:
en: c9fa5343ea99733b
zh: d6de41351c57a73f
@@ -1239,8 +1239,8 @@
en: d34acab659e74957
zh: 25cabc6c9fb44a7e
/session-persistence-event-catalog/resolved-persistence-types/surfaceop:
en: c11d8b2b50526799
zh: faf34df622a5cc26
en: 737806b6ec54263d
zh: b4e44293950ddf8c
/session-persistence-event-catalog/resolved-persistence-types/systemmessage:
en: 94876079d6696df9
zh: d25c7ad9f5054eb7
@@ -1314,11 +1314,11 @@
en: 54090e169899c573
zh: 530ea8d0d0f8cf68
/session-persistence-event-catalog/resolved-persistence-types/turnendcancelcause:
en: 4dc89c072fe5d0d1
zh: 4ed2c9e9e8b4f7e2
en: 778debd61e0284a2
zh: 2cc82ad9e80f18b1
/session-persistence-event-catalog/resolved-persistence-types/turnendreason:
en: e39f2f99ea109af9
zh: f95ec41c72738f3e
en: 933770adc9ee2780
zh: 8d8462c33ed6029e
/session-persistence-event-catalog/resolved-persistence-types/usermessage:
en: 79b3ac6c731859aa
zh: 81058fe7edf61bdb
@@ -1413,8 +1413,8 @@
en: a117573a5d58cb3c
zh: d5ad59e17a3a815d
/session-persistence-event-catalog/resolved-persistence-types/arguments-callid-name-step:
en: e1a214636f575420
zh: f9dcaf765f078672
en: 1cd530a4f45fcb4f
zh: 0bf7c0f53d10a5ec
/session-persistence-event-catalog/resolved-persistence-types/callid-files-turn:
en: 5f4d3f66ed86a14d
zh: 7c729360fa1279e6
@@ -1446,8 +1446,8 @@
en: a1f188c9058cf621
zh: eb43c0f045fb9afb
/session-persistence-event-catalog/resolved-persistence-types/code-name-reason:
en: 9a8f0387d2ee5b7c
zh: 4d80c1e4c7eba497
en: 25df2af19bc9c46d
zh: ebb6ecbeee25c9be
/session-persistence-event-catalog/resolved-persistence-types/commandid-kind-sourceeventseq-text:
en: 87b03e1c73d2a326
zh: d7b9f06863cad891
@@ -1488,14 +1488,14 @@
en: 4b7a8793663d3fef
zh: 249459c825d330c3
/session-persistence-event-catalog/resolved-persistence-types/endseq-op-startseq:
en: 0c95e94b801c4c26
zh: 7399f10a656803f8
en: 766772dfbbb2e164
zh: 09973d26e68004cb
/session-persistence-event-catalog/resolved-persistence-types/error-kind-error:
en: 8d0448ef77e0da08
zh: 25770329c9db129a
en: e0833e1b1cdb29d0
zh: 6244880c79509016
/session-persistence-event-catalog/resolved-persistence-types/error-message-meta-step:
en: b982b76e4d0bb8e3
zh: 86ef1baffceffd16
en: d019b2909673d2a7
zh: cc16e9c055ea603d
/session-persistence-event-catalog/resolved-persistence-types/failure-kind-aborted:
en: 349cd90f2598fd12
zh: 1eda02d520ad5d76
@@ -1503,11 +1503,11 @@
en: 51af619ed8532a43
zh: a5ad878c63d0e046
/session-persistence-event-catalog/resolved-persistence-types/header-reason-startsseries:
en: e0804db40c883638
zh: f31a882a983cdc81
en: e4a915fcd4cca68b
zh: 04a70157c20a2f80
/session-persistence-event-catalog/resolved-persistence-types/headerseq-message-step-turn:
en: 174b2c8332e397b2
zh: 31b94e9a33b9bdac
en: 0f367699daf0d4de
zh: 58b980af0f365374
/session-persistence-event-catalog/resolved-persistence-types/height-width:
en: a5df50710083ac25
zh: aad3ccf6f6de70e4
@@ -1524,17 +1524,17 @@
en: 41f73c58a77dfa28
zh: af77f4aee3cb4a40
/session-persistence-event-catalog/resolved-persistence-types/inherited:
en: cf7517f76b54ade6
zh: db73ce625add8c8c
en: 0e761849881f1b90
zh: 62f72209fb941192
/session-persistence-event-catalog/resolved-persistence-types/inserted-outcome-removedcount-start:
en: 1750502af87d698c
zh: 382a3356f0a61546
/session-persistence-event-catalog/resolved-persistence-types/interrupted-message-step-stream:
en: 97e05240bd01deff
zh: 4b26c5956152676d
en: 8e86cd838e3e4a49
zh: f5fec2a8adf1f3cc
/session-persistence-event-catalog/resolved-persistence-types/kind-aborted-reason:
en: 8bdd31bfea14a015
zh: 203d7ebf5ea4d352
en: d2b0ef9a4e2b9be5
zh: 44ad13fbbf836ac7
/session-persistence-event-catalog/resolved-persistence-types/kind-action-cards:
en: 8d057f0bd0b88fc6
zh: 500d1e3d54e6d7c4
@@ -1557,17 +1557,17 @@
en: 4e030b06ef900819
zh: 27532bbabe118206
/session-persistence-event-catalog/resolved-persistence-types/kind-blocked:
en: 2fad818b19823c48
zh: a6b33dee21c3fdc9
en: 9db831e991ef17ce
zh: 332002f65d191b68
/session-persistence-event-catalog/resolved-persistence-types/kind-completed:
en: e8f76b61a39ebeb0
zh: e61a304be00b4490
en: 9affe5d5dac75c57
zh: 8db62dcb41e804c8
/session-persistence-event-catalog/resolved-persistence-types/kind-cordis-host-runner:
en: fb7b8207a6ef3b81
zh: 9d6f112181d90701
/session-persistence-event-catalog/resolved-persistence-types/kind-disposed:
en: e3c9527803bc6de3
zh: 375c82ce2ac5282b
en: 9a3ce668c21d6c90
zh: f661c7ce62c44a60
/session-persistence-event-catalog/resolved-persistence-types/kind-dsh-session-title-llm:
en: 428529e5dedc761d
zh: 3ca0b54c9c521ea0
@@ -1593,11 +1593,11 @@
en: 78e34e6d0d70339e
zh: 072127e40cfb9686
/session-persistence-event-catalog/resolved-persistence-types/kind-forked:
en: e2588043ee1a8d50
zh: d87a5bff12b9190f
en: 4663f6c1a2634822
zh: 3a2e4f61195759a0
/session-persistence-event-catalog/resolved-persistence-types/kind-hook:
en: 78278a869370695f
zh: 6cdc47f1876f3b23
en: 669685ab52bb7b68
zh: 94325f99ba96dec5
/session-persistence-event-catalog/resolved-persistence-types/kind-hooks-claude-code:
en: 5eb383a67f11ac4d
zh: 1943747cb4995dbc
@@ -1641,14 +1641,14 @@
en: a8a338be3b91008f
zh: c7632c42c869c2f6
/session-persistence-event-catalog/resolved-persistence-types/kind-interrupted:
en: 452b4a96d072a9b9
zh: d63c8ab84bd37dbb
en: 8f5585c1e90d6ca3
zh: 78329cf995882344
/session-persistence-event-catalog/resolved-persistence-types/kind-legacy:
en: c6f68741f8631d4f
zh: 090b58f2b86c02d0
en: 673110c18ee48238
zh: e8dd81d68e1a4ee0
/session-persistence-event-catalog/resolved-persistence-types/kind-max-tokens:
en: f85b7a64a6a5f1f7
zh: 3f4ad5183e1020fd
en: 337ebe760096729a
zh: bd35a401103a3071
/session-persistence-event-catalog/resolved-persistence-types/kind-model-selection:
en: a5165486dca91116
zh: b7051ca8167806ef
@@ -1671,8 +1671,8 @@
en: 509f9a91aedb2da1
zh: db1071678bfb98d1
/session-persistence-event-catalog/resolved-persistence-types/kind-parent:
en: 7a3ac2238405913d
zh: b249a4d6d0508d40
en: 5ab43c283829de53
zh: 5ed4e90922a3a88b
/session-persistence-event-catalog/resolved-persistence-types/kind-plan-mode:
en: 9758304800b717df
zh: dccf14f3a5d0d861
@@ -1896,8 +1896,8 @@
en: 82b0989dad6bbfc0
zh: 0789b63f1d59b2ed
/session-persistence-event-catalog/resolved-persistence-types/message-step-turn:
en: d770df02f76ad0a6
zh: c983c5289c8efe29
en: 86fe91fe83eeb08a
zh: 2ebf2f1904829753
/session-persistence-event-catalog/resolved-persistence-types/message-teamid-version:
en: f778769acb264dd5
zh: eba9b81d04e9f57b
@@ -1914,8 +1914,8 @@
en: 8ebd37343b638773
zh: bf7ffa9a60ca42a8
/session-persistence-event-catalog/resolved-persistence-types/reason-turn:
en: 2d45d5c5e3959d12
zh: df4d0d7fca4e26bc
en: b8d80b4b1e6441ad
zh: d5c52e1bfe560297
/session-persistence-event-catalog/resolved-persistence-types/role-user:
en: 04b34b8ffe7e7764
zh: a792d5371516fd9d
@@ -1926,11 +1926,11 @@
en: 7a2ab7b62244f43b
zh: 1084e3f8876feebc
/session-persistence-event-catalog/resolved-persistence-types/step-stream-turn:
en: 2d13a85441b0ff5b
zh: 495c58cbb9c76445
en: 59f11c6d124335cb
zh: 5bbdd6c88612fcff
/session-persistence-event-catalog/resolved-persistence-types/step-turn:
en: 4bbf63488cce88c9
zh: 46b40433a749c133
en: 8f9e774f89087efa
zh: 72474e7e556e2469
/session-persistence-event-catalog/resolved-persistence-types/targets:
en: 5360af614fe753e3
zh: 96427c489cc71de6
@@ -1941,8 +1941,8 @@
en: 8ab873d30e062fd5
zh: a138832c6e299ebb
/session-persistence-event-catalog/resolved-persistence-types/turn:
en: ea32b4165dbfb182
zh: 57f48af06cfa201c
en: 374b8adee8d571fa
zh: b21057efc58e6490
/session-persistence-event-catalog/resolved-persistence-types/type-agent-preset-selected:
en: 6a59f1cd472759e9
zh: 1db67f4f97207efc
+46 -46
View File
@@ -160,7 +160,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
}[T]
```
Sources: [`packages/core/session/src/types.ts:435`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:443`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:466`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:497`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:439`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:447`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:470`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:501`](../packages/core/session/src/types.ts)
## Events
@@ -290,7 +290,7 @@ Source: [`packages/interaction/user-approval/src/index.ts:41`](../packages/inter
'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[] }
```
Source: [`packages/core/session/src/types.ts:359`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:363`](../packages/core/session/src/types.ts)
<a id="assistantmessage--surface"></a>
@@ -320,7 +320,7 @@ Source: [`packages/core/session/src/types.ts:359`](../packages/core/session/src/
Types: [TokenUsage](subsystems/llm-streaming.md)
Source: [`packages/core/session/src/types.ts:345`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:349`](../packages/core/session/src/types.ts)
### `command/*`
@@ -508,7 +508,7 @@ Source: [`packages/deliverables/tool-present/src/types.ts:15`](../packages/deliv
}
```
Source: [`packages/core/session/src/types.ts:313`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:317`](../packages/core/session/src/types.ts)
### `feedback/*`
@@ -753,7 +753,7 @@ Source: [`packages/plan/plan-mode/src/index.ts:53`](../packages/plan/plan-mode/s
'request/context': RequestContext
```
Source: [`packages/core/session/src/types.ts:406`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:410`](../packages/core/session/src/types.ts)
<a id="requestheader--log-only"></a>
@@ -772,7 +772,7 @@ Source: [`packages/core/session/src/types.ts:406`](../packages/core/session/src/
}
```
Source: [`packages/core/session/src/types.ts:394`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:398`](../packages/core/session/src/types.ts)
### `sandbox/*`
@@ -849,7 +849,7 @@ Source: [`packages/schedule/schedule/src/types.ts:371`](../packages/schedule/sch
'session/end-seed': { inherited?: true }
```
Source: [`packages/core/session/src/types.ts:431`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:435`](../packages/core/session/src/types.ts)
<a id="sessiontitle--log-only"></a>
@@ -911,7 +911,7 @@ Source: [`packages/session/session-log-deepseek/src/types.ts:81`](../packages/se
'step/end': { turn: number; step: number }
```
Source: [`packages/core/session/src/types.ts:303`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:307`](../packages/core/session/src/types.ts)
<a id="stepstart--log-only"></a>
@@ -922,7 +922,7 @@ Source: [`packages/core/session/src/types.ts:303`](../packages/core/session/src/
'step/start': { turn: number; step: number }
```
Source: [`packages/core/session/src/types.ts:301`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:305`](../packages/core/session/src/types.ts)
### `subagent/*`
@@ -1000,7 +1000,7 @@ Source: [`packages/subagent/tool-subagent/src/model-selection-state.ts:17`](../p
'system/message': { turn: number; step: number; message: SystemMessage }
```
Source: [`packages/core/session/src/types.ts:334`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:338`](../packages/core/session/src/types.ts)
### `team/*`
@@ -1093,7 +1093,7 @@ Source: [`packages/todo/tool-todo/src/types.ts:33`](../packages/todo/tool-todo/s
Types: [ToolCallId](subsystems/core.md)
Source: [`packages/core/session/src/types.ts:365`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:369`](../packages/core/session/src/types.ts)
<a id="toolptc-dispatch--log-only"></a>
@@ -1174,7 +1174,7 @@ Source: [`packages/core/tool-executor-ptc/src/types.ts:45`](../packages/core/too
}
```
Source: [`packages/core/session/src/types.ts:379`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:383`](../packages/core/session/src/types.ts)
### `tool-workflow/*`
@@ -1254,7 +1254,7 @@ Source: [`packages/workflow/tool-workflow/src/types.ts:47`](../packages/workflow
Types: [TurnEndReason](subsystems/session.md)
Source: [`packages/core/session/src/types.ts:299`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:303`](../packages/core/session/src/types.ts)
<a id="turnstart--log-only"></a>
@@ -1270,7 +1270,7 @@ Source: [`packages/core/session/src/types.ts:299`](../packages/core/session/src/
'turn/start': { turn: number }
```
Source: [`packages/core/session/src/types.ts:290`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:294`](../packages/core/session/src/types.ts)
### `user/*`
@@ -1289,7 +1289,7 @@ Source: [`packages/core/session/src/types.ts:290`](../packages/core/session/src/
'user/message': UserMessage
```
Source: [`packages/core/session/src/types.ts:311`](../packages/core/session/src/types.ts)
Source: [`packages/core/session/src/types.ts:315`](../packages/core/session/src/types.ts)
### `web/*`
@@ -3232,7 +3232,7 @@ Array of [`AssistantStreamRecord`](#persistence-type-sha256-33341aac09312300de5a
SHA-256: `ada310bf0bdb8fed51f3b56ea63f6ea6b18bbd587f04fccb63a14ab0b2a24e05`
Sources: [`packages/core/session/src/types.ts:191`](../packages/core/session/src/types.ts) · [`packages/interaction/commands/src/types.ts:75`](../packages/interaction/commands/src/types.ts) · [`packages/interaction/commands/src/types.ts:79`](../packages/interaction/commands/src/types.ts) · [`packages/llm/llm/src/message.ts:111`](../packages/llm/llm/src/message.ts) · [`packages/session/session-title/src/types.ts:35`](../packages/session/session-title/src/types.ts)
Sources: [`packages/core/session/src/types.ts:195`](../packages/core/session/src/types.ts) · [`packages/interaction/commands/src/types.ts:75`](../packages/interaction/commands/src/types.ts) · [`packages/interaction/commands/src/types.ts:79`](../packages/interaction/commands/src/types.ts) · [`packages/llm/llm/src/message.ts:111`](../packages/llm/llm/src/message.ts) · [`packages/session/session-title/src/types.ts:35`](../packages/session/session-title/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -3408,7 +3408,7 @@ Attribution-only additions: `action-cards`, `tmux-context`, `user-question-reply
SHA-256: `9a930283b91d493d6347146f2475bb107294b379415ca02162354f46a64164f7`
Sources: [`packages/core/session/src/types.ts:242`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:246`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -4545,7 +4545,7 @@ Sources: [`packages/llm/llm/src/types.ts:448`](../packages/llm/llm/src/types.ts)
SHA-256: `b158f3ff6923714807c0d73882f0b05dc87f8fa85c9e90814852d48bbc866081`
Sources: [`packages/core/session/src/types.ts:256`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:260`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -4564,7 +4564,7 @@ Sources: [`packages/core/session/src/types.ts:256`](../packages/core/session/src
SHA-256: `530da6c0267813bb4511af72883cc518834e624e3b3220a7062955fd57a788a6`
Sources: [`packages/core/session/src/types.ts:275`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:279`](../packages/core/session/src/types.ts)
One of:
@@ -4902,7 +4902,7 @@ Sources: [`packages/subagent/subagent/src/continuation-messages.ts:29`](../packa
SHA-256: `335e242de1fcc17b6ca920fc420d71bec2d76e53e37955c00948b65ab77f05c5`
Sources: [`packages/core/session/src/types.ts:466`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:470`](../packages/core/session/src/types.ts)
One of:
@@ -5347,7 +5347,7 @@ Sources: [`packages/workflow/tool-workflow/src/types.ts:14`](../packages/workflo
SHA-256: `1f8c126cfab3df812cd115cfc23e3256f0fa2383400f4ce91ecad313577e59b0`
Sources: [`packages/core/session/src/types.ts:197`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:201`](../packages/core/session/src/types.ts)
| kind | Form property | Other required fields | Full definition |
|---|---|---|---|
@@ -5367,7 +5367,7 @@ Sources: [`packages/core/session/src/types.ts:197`](../packages/core/session/src
SHA-256: `f1687f982fa3d41ef29e159feed154ecd13af4dd209acaee16038f223f2e9402`
Sources: [`packages/core/session/src/types.ts:234`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:238`](../packages/core/session/src/types.ts)
| kind | Form property | Other required fields | Full definition |
|---|---|---|---|
@@ -5837,7 +5837,7 @@ Sources: [`packages/interaction/commands/src/types.ts:105`](../packages/interact
SHA-256: `e4c18e294232c3ba6c9f1999f168263cc55956147cfe4121720899be8e52edd1`
Sources: [`packages/core/session/src/types.ts:365`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:369`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -5996,7 +5996,7 @@ SHA-256: `cbbe8377ee744964537dbafd83607219e58ba79a13f6db0d0645c7ad3d5e8a09`
SHA-256: `a81059ca06999da1e712414520c2c65e491d052fcf9640fae20aa38f0a5dc735`
Sources: [`packages/core/session/src/types.ts:387`](../packages/core/session/src/types.ts) · [`packages/core/tool-executor-ptc/src/types.ts:27`](../packages/core/tool-executor-ptc/src/types.ts)
Sources: [`packages/core/session/src/types.ts:391`](../packages/core/session/src/types.ts) · [`packages/core/tool-executor-ptc/src/types.ts:27`](../packages/core/tool-executor-ptc/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6216,7 +6216,7 @@ Sources: [`packages/compaction/compaction/src/types.ts:38`](../packages/compacti
SHA-256: `bcf0caf62d964b2fcf5404bd5c909cfa9a21c3f3c96e6b7e36d9e33565223825`
Sources: [`packages/core/session/src/types.ts:468`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:472`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6230,7 +6230,7 @@ Sources: [`packages/core/session/src/types.ts:468`](../packages/core/session/src
SHA-256: `79650cfa10aa3c52440328d85e8a25f0ffadc8d7efd784e3c0819d8bb74a1985`
Sources: [`packages/core/session/src/types.ts:214`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:218`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6243,7 +6243,7 @@ Sources: [`packages/core/session/src/types.ts:214`](../packages/core/session/src
SHA-256: `5302e763151277614b97e77f00e3b326694c6c1247b916a20503c344dc970777`
Sources: [`packages/core/session/src/types.ts:379`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:383`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6285,7 +6285,7 @@ Sources: [`packages/llm/llm/src/types.ts:161`](../packages/llm/llm/src/types.ts)
SHA-256: `ad0c38a0adb82a94c925456df41586d9b5f9202fca18593eae2213d4445b4585`
Sources: [`packages/core/session/src/types.ts:394`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:398`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6299,7 +6299,7 @@ Sources: [`packages/core/session/src/types.ts:394`](../packages/core/session/src
SHA-256: `7404c6123fdaa591474a37979a5a8ae70d1387af7c9f09bfe568b218935a974d`
Sources: [`packages/core/session/src/types.ts:313`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:317`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6382,7 +6382,7 @@ SHA-256: `e3e77b26f0148755a505f5b8ea843a3be117827d4703bb5754d9dc8ddbef521f`
SHA-256: `17d1afb770d9941936130996da00dc86782cfef731d8d6526162c301256a4ac3`
Sources: [`packages/core/session/src/types.ts:431`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:435`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6410,7 +6410,7 @@ Sources: [`packages/core/agent/src/types.ts:110`](../packages/core/agent/src/typ
SHA-256: `1ccb56061942f5ccb0d30c9e4f2883b9d115ff906560029de637b61d3cde896d`
Sources: [`packages/core/session/src/types.ts:345`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:349`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6427,7 +6427,7 @@ Sources: [`packages/core/session/src/types.ts:345`](../packages/core/session/src
SHA-256: `0a30c3be336cdd4f8f34e66543a3d46d611c43986edd9b3ce6cbb9b721d3b5d3`
Sources: [`packages/core/session/src/types.ts:205`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:209`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6525,7 +6525,7 @@ SHA-256: `3247e566f4340029325b70e4366b56fa9719977f1e39033b769a2ec221ab22a9`
SHA-256: `023a355b2be0d688fb6e4df8388dadb942761d46cfe96d0f499aae9631a159d4`
Sources: [`packages/core/session/src/types.ts:207`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:211`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6537,7 +6537,7 @@ Sources: [`packages/core/session/src/types.ts:207`](../packages/core/session/src
SHA-256: `b6ef9c6210be8350cd465f485cf520031fffa6bf3809c61a1e713e834c5982d0`
Sources: [`packages/core/session/src/types.ts:203`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:207`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6561,7 +6561,7 @@ Sources: [`packages/extensions/cordis-host-runner/src/index.ts:14`](../packages/
SHA-256: `4bb451330ff699f36b45539ceb0eb2606ead72084e2c5bb637c36cc80e2252db`
Sources: [`packages/core/session/src/types.ts:194`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:198`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6663,7 +6663,7 @@ Sources: [`packages/session/session-title/src/types.ts:29`](../packages/session/
SHA-256: `ec8b5ff7c77ca6893ac7ba5a0c5b2aefeb52f12c64450b7359660c2a7e8a53d7`
Sources: [`packages/core/session/src/types.ts:230`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:234`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6675,7 +6675,7 @@ Sources: [`packages/core/session/src/types.ts:230`](../packages/core/session/src
SHA-256: `6c5a37d42ebdb12db4410699259335f1e149e3a0260425684c00b153afc8990d`
Sources: [`packages/core/session/src/types.ts:193`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:197`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6844,7 +6844,7 @@ SHA-256: `88841202942c7683b3b7e5ea6a796047ec326b6701ac23e58cc236d85613b9fa`
SHA-256: `56b7c047694875a843ba020dfea3c8380d54ae4ff88ab349e72004dc21e07c23`
Sources: [`packages/core/session/src/types.ts:223`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:227`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6856,7 +6856,7 @@ Sources: [`packages/core/session/src/types.ts:223`](../packages/core/session/src
SHA-256: `eaa71be0fbf0f702df8ea6c11d0aa2f9782263d45a10d0fb14eda662f4bfe04c`
Sources: [`packages/core/session/src/types.ts:197`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:201`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6868,7 +6868,7 @@ Sources: [`packages/core/session/src/types.ts:197`](../packages/core/session/src
SHA-256: `ab7ec5f9eb2c6dfacca5da4c37cf7ba85d04172053ee6b1ebf1709ffcd99c1a7`
Sources: [`packages/core/session/src/types.ts:216`](../packages/core/session/src/types.ts) · [`packages/llm/llm/src/types.ts:159`](../packages/llm/llm/src/types.ts)
Sources: [`packages/core/session/src/types.ts:220`](../packages/core/session/src/types.ts) · [`packages/llm/llm/src/types.ts:159`](../packages/llm/llm/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -6958,7 +6958,7 @@ SHA-256: `52c6113cb0e53f345324bf84f01928bea5d5df57ee80bc0dd65407b8bc5a3734`
SHA-256: `6c03546143cdf6ae88f1745ac98c5139efa1588d1415249bbc5f3104d32ab800`
Sources: [`packages/core/session/src/types.ts:192`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:196`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -7823,7 +7823,7 @@ Sources: [`packages/experimental/agent-team/src/types.ts:230`](../packages/exper
SHA-256: `6bc8e51124d0874bc89e1d0ceff381a9c3cd0fc240667d69f841ce4f60f65fe5`
Sources: [`packages/core/session/src/types.ts:334`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:338`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -7904,7 +7904,7 @@ Sources: [`packages/interaction/permission-presets/src/index.ts:53`](../packages
SHA-256: `e481c46af3813e0010558e93f578b2986acd658404cec2d1679e3ac2a6c48654`
Sources: [`packages/core/session/src/types.ts:299`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:303`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -7958,7 +7958,7 @@ Sources: [`packages/compaction/compaction/src/types.ts:82`](../packages/compacti
SHA-256: `54f9276a1617d7c12594722c89cfe864bcbe4517e9a6f9c98bab14f199a135e0`
Sources: [`packages/core/session/src/types.ts:359`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:363`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -7972,7 +7972,7 @@ Sources: [`packages/core/session/src/types.ts:359`](../packages/core/session/src
SHA-256: `ef11a3b7fa2033ae4279545ff8a8a2ee4e301b9b73e5b91654c48e6d08283545`
Sources: [`packages/core/session/src/types.ts:301`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:303`](../packages/core/session/src/types.ts)
Sources: [`packages/core/session/src/types.ts:305`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:307`](../packages/core/session/src/types.ts)
| Property | Presence | Type |
|---|---|---|
@@ -8023,7 +8023,7 @@ Sources: [`packages/todo/tool-todo/src/types.ts:33`](../packages/todo/tool-todo/
SHA-256: `f90eb4ab2d3897bc20c521a038e3119d581f791ec974b1a0004f63a8ab9e232d`
Sources: [`packages/core/session/src/types.ts:290`](../packages/core/session/src/types.ts) · [`packages/deliverables/workspace-changes/src/types.ts:106`](../packages/deliverables/workspace-changes/src/types.ts)
Sources: [`packages/core/session/src/types.ts:294`](../packages/core/session/src/types.ts) · [`packages/deliverables/workspace-changes/src/types.ts:106`](../packages/deliverables/workspace-changes/src/types.ts)
| Property | Presence | Type |
|---|---|---|
+46 -46
View File
@@ -162,7 +162,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
}[T]
```
来源:[`packages/core/session/src/types.ts:435`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:443`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:466`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:497`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:439`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:447`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:470`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:501`](../packages/core/session/src/types.ts)
## 事件
@@ -292,7 +292,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[] }
```
来源:[`packages/core/session/src/types.ts:359`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:363`](../packages/core/session/src/types.ts)
<a id="assistantmessage--surface"></a>
@@ -322,7 +322,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
类型:[TokenUsage](subsystems/llm-streaming.zh.md)
来源:[`packages/core/session/src/types.ts:345`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:349`](../packages/core/session/src/types.ts)
### `command/*`
@@ -510,7 +510,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
}
```
来源:[`packages/core/session/src/types.ts:313`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:317`](../packages/core/session/src/types.ts)
### `feedback/*`
@@ -755,7 +755,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
'request/context': RequestContext
```
来源:[`packages/core/session/src/types.ts:406`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:410`](../packages/core/session/src/types.ts)
<a id="requestheader--log-only"></a>
@@ -774,7 +774,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
}
```
来源:[`packages/core/session/src/types.ts:394`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:398`](../packages/core/session/src/types.ts)
### `sandbox/*`
@@ -851,7 +851,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
'session/end-seed': { inherited?: true }
```
来源:[`packages/core/session/src/types.ts:431`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:435`](../packages/core/session/src/types.ts)
<a id="sessiontitle--log-only"></a>
@@ -913,7 +913,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
'step/end': { turn: number; step: number }
```
来源:[`packages/core/session/src/types.ts:303`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:307`](../packages/core/session/src/types.ts)
<a id="stepstart--log-only"></a>
@@ -924,7 +924,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
'step/start': { turn: number; step: number }
```
来源:[`packages/core/session/src/types.ts:301`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:305`](../packages/core/session/src/types.ts)
### `subagent/*`
@@ -1002,7 +1002,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
'system/message': { turn: number; step: number; message: SystemMessage }
```
来源:[`packages/core/session/src/types.ts:334`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:338`](../packages/core/session/src/types.ts)
### `team/*`
@@ -1095,7 +1095,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
类型:[ToolCallId](subsystems/core.zh.md)
来源:[`packages/core/session/src/types.ts:365`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:369`](../packages/core/session/src/types.ts)
<a id="toolptc-dispatch--log-only"></a>
@@ -1176,7 +1176,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
}
```
来源:[`packages/core/session/src/types.ts:379`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:383`](../packages/core/session/src/types.ts)
### `tool-workflow/*`
@@ -1256,7 +1256,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
类型:[TurnEndReason](subsystems/session.zh.md)
来源:[`packages/core/session/src/types.ts:299`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:303`](../packages/core/session/src/types.ts)
<a id="turnstart--log-only"></a>
@@ -1272,7 +1272,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
'turn/start': { turn: number }
```
来源:[`packages/core/session/src/types.ts:290`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:294`](../packages/core/session/src/types.ts)
### `user/*`
@@ -1291,7 +1291,7 @@ export type SessionEvent<T extends SessionEventType = SessionEventType> = {
'user/message': UserMessage
```
来源:[`packages/core/session/src/types.ts:311`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:315`](../packages/core/session/src/types.ts)
### `web/*`
@@ -3234,7 +3234,7 @@ SHA-256: `84bbfdce7d2eab5b0c53e72ff7406db856c8bfd621b965b72fd86598ba493bf7`
SHA-256: `ada310bf0bdb8fed51f3b56ea63f6ea6b18bbd587f04fccb63a14ab0b2a24e05`
来源:[`packages/core/session/src/types.ts:191`](../packages/core/session/src/types.ts) · [`packages/interaction/commands/src/types.ts:75`](../packages/interaction/commands/src/types.ts) · [`packages/interaction/commands/src/types.ts:79`](../packages/interaction/commands/src/types.ts) · [`packages/llm/llm/src/message.ts:111`](../packages/llm/llm/src/message.ts) · [`packages/session/session-title/src/types.ts:35`](../packages/session/session-title/src/types.ts)
来源:[`packages/core/session/src/types.ts:195`](../packages/core/session/src/types.ts) · [`packages/interaction/commands/src/types.ts:75`](../packages/interaction/commands/src/types.ts) · [`packages/interaction/commands/src/types.ts:79`](../packages/interaction/commands/src/types.ts) · [`packages/llm/llm/src/message.ts:111`](../packages/llm/llm/src/message.ts) · [`packages/session/session-title/src/types.ts:35`](../packages/session/session-title/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -3410,7 +3410,7 @@ SHA-256: `7580e7d96dc8475fffe813a42af499665de3d4517fcdb3bc2337d0340e98d616`
SHA-256: `9a930283b91d493d6347146f2475bb107294b379415ca02162354f46a64164f7`
来源:[`packages/core/session/src/types.ts:242`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:246`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -4547,7 +4547,7 @@ SHA-256: `0acd94fe8794574c9ae72c7855ee16d29c546096d4af760d16d1225385764555`
SHA-256: `b158f3ff6923714807c0d73882f0b05dc87f8fa85c9e90814852d48bbc866081`
来源:[`packages/core/session/src/types.ts:256`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:260`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -4566,7 +4566,7 @@ SHA-256: `b158f3ff6923714807c0d73882f0b05dc87f8fa85c9e90814852d48bbc866081`
SHA-256: `530da6c0267813bb4511af72883cc518834e624e3b3220a7062955fd57a788a6`
来源:[`packages/core/session/src/types.ts:275`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:279`](../packages/core/session/src/types.ts)
以下类型之一:
@@ -4904,7 +4904,7 @@ SHA-256: `4e97c3d85c0fc817ee58873c38c25a2474abaaa0af4839311b50b68db3b8cf1a`
SHA-256: `335e242de1fcc17b6ca920fc420d71bec2d76e53e37955c00948b65ab77f05c5`
来源:[`packages/core/session/src/types.ts:466`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:470`](../packages/core/session/src/types.ts)
以下类型之一:
@@ -5349,7 +5349,7 @@ SHA-256: `a6da9ad5d42ae83a6833a8288b076688e8e0801633ea36cbdd8a30a6d9f3160c`
SHA-256: `1f8c126cfab3df812cd115cfc23e3256f0fa2383400f4ce91ecad313577e59b0`
来源:[`packages/core/session/src/types.ts:197`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:201`](../packages/core/session/src/types.ts)
| kind | form 属性 | 其他必需字段 | 完整定义 |
|---|---|---|---|
@@ -5369,7 +5369,7 @@ SHA-256: `1f8c126cfab3df812cd115cfc23e3256f0fa2383400f4ce91ecad313577e59b0`
SHA-256: `f1687f982fa3d41ef29e159feed154ecd13af4dd209acaee16038f223f2e9402`
来源:[`packages/core/session/src/types.ts:234`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:238`](../packages/core/session/src/types.ts)
| kind | form 属性 | 其他必需字段 | 完整定义 |
|---|---|---|---|
@@ -5839,7 +5839,7 @@ SHA-256: `a853902cfab417b8f08aa51ad6855fea46f34ed4588a74e47403035111d0fb86`
SHA-256: `e4c18e294232c3ba6c9f1999f168263cc55956147cfe4121720899be8e52edd1`
来源:[`packages/core/session/src/types.ts:365`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:369`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -5998,7 +5998,7 @@ SHA-256: `cbbe8377ee744964537dbafd83607219e58ba79a13f6db0d0645c7ad3d5e8a09`
SHA-256: `a81059ca06999da1e712414520c2c65e491d052fcf9640fae20aa38f0a5dc735`
来源:[`packages/core/session/src/types.ts:387`](../packages/core/session/src/types.ts) · [`packages/core/tool-executor-ptc/src/types.ts:27`](../packages/core/tool-executor-ptc/src/types.ts)
来源:[`packages/core/session/src/types.ts:391`](../packages/core/session/src/types.ts) · [`packages/core/tool-executor-ptc/src/types.ts:27`](../packages/core/tool-executor-ptc/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6218,7 +6218,7 @@ SHA-256: `9e41386b3a0c9572b0d63078492ebb3997da7d3a830d44e0259418bd02f4bcb2`
SHA-256: `bcf0caf62d964b2fcf5404bd5c909cfa9a21c3f3c96e6b7e36d9e33565223825`
来源:[`packages/core/session/src/types.ts:468`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:472`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6232,7 +6232,7 @@ SHA-256: `bcf0caf62d964b2fcf5404bd5c909cfa9a21c3f3c96e6b7e36d9e33565223825`
SHA-256: `79650cfa10aa3c52440328d85e8a25f0ffadc8d7efd784e3c0819d8bb74a1985`
来源:[`packages/core/session/src/types.ts:214`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:218`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6245,7 +6245,7 @@ SHA-256: `79650cfa10aa3c52440328d85e8a25f0ffadc8d7efd784e3c0819d8bb74a1985`
SHA-256: `5302e763151277614b97e77f00e3b326694c6c1247b916a20503c344dc970777`
来源:[`packages/core/session/src/types.ts:379`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:383`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6287,7 +6287,7 @@ SHA-256: `693f4952fb5565da96c06bace8924b098ac2fbc915fde0ff8019701183abc057`
SHA-256: `ad0c38a0adb82a94c925456df41586d9b5f9202fca18593eae2213d4445b4585`
来源:[`packages/core/session/src/types.ts:394`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:398`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6301,7 +6301,7 @@ SHA-256: `ad0c38a0adb82a94c925456df41586d9b5f9202fca18593eae2213d4445b4585`
SHA-256: `7404c6123fdaa591474a37979a5a8ae70d1387af7c9f09bfe568b218935a974d`
来源:[`packages/core/session/src/types.ts:313`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:317`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6384,7 +6384,7 @@ SHA-256: `e3e77b26f0148755a505f5b8ea843a3be117827d4703bb5754d9dc8ddbef521f`
SHA-256: `17d1afb770d9941936130996da00dc86782cfef731d8d6526162c301256a4ac3`
来源:[`packages/core/session/src/types.ts:431`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:435`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6412,7 +6412,7 @@ SHA-256: `b2a948a5340a9341fa3bab99507c7090c5b0456de72ec28b5b157b8df3f1d640`
SHA-256: `1ccb56061942f5ccb0d30c9e4f2883b9d115ff906560029de637b61d3cde896d`
来源:[`packages/core/session/src/types.ts:345`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:349`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6429,7 +6429,7 @@ SHA-256: `1ccb56061942f5ccb0d30c9e4f2883b9d115ff906560029de637b61d3cde896d`
SHA-256: `0a30c3be336cdd4f8f34e66543a3d46d611c43986edd9b3ce6cbb9b721d3b5d3`
来源:[`packages/core/session/src/types.ts:205`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:209`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6527,7 +6527,7 @@ SHA-256: `3247e566f4340029325b70e4366b56fa9719977f1e39033b769a2ec221ab22a9`
SHA-256: `023a355b2be0d688fb6e4df8388dadb942761d46cfe96d0f499aae9631a159d4`
来源:[`packages/core/session/src/types.ts:207`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:211`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6539,7 +6539,7 @@ SHA-256: `023a355b2be0d688fb6e4df8388dadb942761d46cfe96d0f499aae9631a159d4`
SHA-256: `b6ef9c6210be8350cd465f485cf520031fffa6bf3809c61a1e713e834c5982d0`
来源:[`packages/core/session/src/types.ts:203`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:207`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6563,7 +6563,7 @@ SHA-256: `02b2c23f2d94b028c9588a8faace3fce1217405db346da3389368b495457bf79`
SHA-256: `4bb451330ff699f36b45539ceb0eb2606ead72084e2c5bb637c36cc80e2252db`
来源:[`packages/core/session/src/types.ts:194`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:198`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6665,7 +6665,7 @@ SHA-256: `1b5649238876e28811e80f10ec67a00c197ad3babd4ecc61a22b09064b88c597`
SHA-256: `ec8b5ff7c77ca6893ac7ba5a0c5b2aefeb52f12c64450b7359660c2a7e8a53d7`
来源:[`packages/core/session/src/types.ts:230`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:234`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6677,7 +6677,7 @@ SHA-256: `ec8b5ff7c77ca6893ac7ba5a0c5b2aefeb52f12c64450b7359660c2a7e8a53d7`
SHA-256: `6c5a37d42ebdb12db4410699259335f1e149e3a0260425684c00b153afc8990d`
来源:[`packages/core/session/src/types.ts:193`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:197`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6846,7 +6846,7 @@ SHA-256: `88841202942c7683b3b7e5ea6a796047ec326b6701ac23e58cc236d85613b9fa`
SHA-256: `56b7c047694875a843ba020dfea3c8380d54ae4ff88ab349e72004dc21e07c23`
来源:[`packages/core/session/src/types.ts:223`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:227`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6858,7 +6858,7 @@ SHA-256: `56b7c047694875a843ba020dfea3c8380d54ae4ff88ab349e72004dc21e07c23`
SHA-256: `eaa71be0fbf0f702df8ea6c11d0aa2f9782263d45a10d0fb14eda662f4bfe04c`
来源:[`packages/core/session/src/types.ts:197`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:201`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6870,7 +6870,7 @@ SHA-256: `eaa71be0fbf0f702df8ea6c11d0aa2f9782263d45a10d0fb14eda662f4bfe04c`
SHA-256: `ab7ec5f9eb2c6dfacca5da4c37cf7ba85d04172053ee6b1ebf1709ffcd99c1a7`
来源:[`packages/core/session/src/types.ts:216`](../packages/core/session/src/types.ts) · [`packages/llm/llm/src/types.ts:159`](../packages/llm/llm/src/types.ts)
来源:[`packages/core/session/src/types.ts:220`](../packages/core/session/src/types.ts) · [`packages/llm/llm/src/types.ts:159`](../packages/llm/llm/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -6960,7 +6960,7 @@ SHA-256: `52c6113cb0e53f345324bf84f01928bea5d5df57ee80bc0dd65407b8bc5a3734`
SHA-256: `6c03546143cdf6ae88f1745ac98c5139efa1588d1415249bbc5f3104d32ab800`
来源:[`packages/core/session/src/types.ts:192`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:196`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -7825,7 +7825,7 @@ SHA-256: `b1ebd5cda47d90d980bb05bffc3f970c51537b9aff15b3bc3d639811727741b1`
SHA-256: `6bc8e51124d0874bc89e1d0ceff381a9c3cd0fc240667d69f841ce4f60f65fe5`
来源:[`packages/core/session/src/types.ts:334`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:338`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -7906,7 +7906,7 @@ SHA-256: `8a9c990773f798eac10ca8878e6bcc531ee080bc589cac956730e462cc6a09ad`
SHA-256: `e481c46af3813e0010558e93f578b2986acd658404cec2d1679e3ac2a6c48654`
来源:[`packages/core/session/src/types.ts:299`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:303`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -7960,7 +7960,7 @@ SHA-256: `5dd766ccd1702a1142ad8b4bd44f2242f8e8a6752669ad3de0a5d224329b1438`
SHA-256: `54f9276a1617d7c12594722c89cfe864bcbe4517e9a6f9c98bab14f199a135e0`
来源:[`packages/core/session/src/types.ts:359`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:363`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -7974,7 +7974,7 @@ SHA-256: `54f9276a1617d7c12594722c89cfe864bcbe4517e9a6f9c98bab14f199a135e0`
SHA-256: `ef11a3b7fa2033ae4279545ff8a8a2ee4e301b9b73e5b91654c48e6d08283545`
来源:[`packages/core/session/src/types.ts:301`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:303`](../packages/core/session/src/types.ts)
来源:[`packages/core/session/src/types.ts:305`](../packages/core/session/src/types.ts) · [`packages/core/session/src/types.ts:307`](../packages/core/session/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
@@ -8025,7 +8025,7 @@ SHA-256: `79ddc907312f97cf9553d4841e8b3fc937097bd8d97900a790efad3c05255e99`
SHA-256: `f90eb4ab2d3897bc20c521a038e3119d581f791ec974b1a0004f63a8ab9e232d`
来源:[`packages/core/session/src/types.ts:290`](../packages/core/session/src/types.ts) · [`packages/deliverables/workspace-changes/src/types.ts:106`](../packages/deliverables/workspace-changes/src/types.ts)
来源:[`packages/core/session/src/types.ts:294`](../packages/core/session/src/types.ts) · [`packages/deliverables/workspace-changes/src/types.ts:106`](../packages/deliverables/workspace-changes/src/types.ts)
| 属性 | 存在性 | 类型 |
|---|---|---|
+31 -31
View File
@@ -71,7 +71,7 @@
{"digest":"0116b1f89c05221d56b0ba35c83d302bf4857bc7277d247e9bbaf74b27d2c66e","names":[],"sources":[]},
{"digest":"0203243b72fc867afc81aff5f4cf2167e564ed342534eb612fc92f295cf07789","names":[],"sources":[]},
{"digest":"022623b9ef98ec47ec3c3bae0c51027c70d2601141c5e92e26a0d83d1b4cef06","names":[],"sources":[]},
{"digest":"023a355b2be0d688fb6e4df8388dadb942761d46cfe96d0f499aae9631a159d4","names":[],"sources":["packages/core/session/src/types.ts:207"]},
{"digest":"023a355b2be0d688fb6e4df8388dadb942761d46cfe96d0f499aae9631a159d4","names":[],"sources":["packages/core/session/src/types.ts:211"]},
{"digest":"02b2c23f2d94b028c9588a8faace3fce1217405db346da3389368b495457bf79","names":[],"sources":["packages/extensions/cordis-host-runner/src/index.ts:14"]},
{"digest":"0341d4c3dfcd53253cdc1e789d9130d3cd848b6f8b0706bf92f313a68b39ff23","names":[],"sources":[]},
{"digest":"05205074b24d8340cfd7995f6cb64779c7f1241490954700115601e264178877","names":[],"sources":[]},
@@ -82,7 +82,7 @@
{"digest":"07eccc9ea2f9b5439d76cc77d5e062936677d43f07a23da749819b0a22ee36b7","names":[],"sources":[]},
{"digest":"09655b34d7f3cf1e9005974de2357de2d4a60deea165d16dac1eadaa6ec539a8","names":[],"sources":[]},
{"digest":"09f3f8dc417f278257202714132f98ba7b52957d7b558c4a04456603890eb363","names":["packages/llm/llm/src/message.ts#SystemMessage"],"sources":["packages/llm/llm/src/message.ts:151"]},
{"digest":"0a30c3be336cdd4f8f34e66543a3d46d611c43986edd9b3ce6cbb9b721d3b5d3","names":[],"sources":["packages/core/session/src/types.ts:205"]},
{"digest":"0a30c3be336cdd4f8f34e66543a3d46d611c43986edd9b3ce6cbb9b721d3b5d3","names":[],"sources":["packages/core/session/src/types.ts:209"]},
{"digest":"0a8a062bc9c3c0d97fd97742262f2ea53dd32297f834e81114870d38ac3dc6da","names":[],"sources":[]},
{"digest":"0aa62ab51b36c0e64b134bd03ba8725d758744180a1a447da49beaad194f219f","names":[],"sources":[]},
{"digest":"0acd94fe8794574c9ae72c7855ee16d29c546096d4af760d16d1225385764555","names":["packages/llm/llm/src/types.ts#ReplayEnvelope"],"sources":["packages/llm/llm/src/types.ts:448"]},
@@ -120,7 +120,7 @@
{"digest":"15d5dfdd822aa35e115afd74a8982825a493880457774e6850bc1520b50875e4","names":[],"sources":[]},
{"digest":"16d0507cb94b4cfc84a87446b1ba7652d6ec1d65ee1684789e747e30d542800e","names":[],"sources":[]},
{"digest":"17aae616ef020b8b9f011ec398ec935450fb06d3e2a0722c456f63aeaf5ff728","names":[],"sources":[]},
{"digest":"17d1afb770d9941936130996da00dc86782cfef731d8d6526162c301256a4ac3","names":[],"sources":["packages/core/session/src/types.ts:431"]},
{"digest":"17d1afb770d9941936130996da00dc86782cfef731d8d6526162c301256a4ac3","names":[],"sources":["packages/core/session/src/types.ts:435"]},
{"digest":"18dc21f12bbac8ade8377e6fbb54179e20c3d955d73fba3244c57fb6bf001df0","names":["packages/schedule/schedule/src/types.ts#ScheduleDeleteChange"],"sources":["packages/schedule/schedule/src/types.ts:230"]},
{"digest":"18ee62b8900a4c3d046700f05d7a4d49d6cab2a660a020c87481d1603dd8bd4f","names":["packages/session/session-persistence-jsonl/src/format.ts#HeaderLine"],"sources":["packages/session/session-persistence-jsonl/src/format.ts:83"]},
{"digest":"18fcdd273a2f2f9d813a3be5e71df5903a963a5c88e46b90b14de6e2db890da0","names":[],"sources":[]},
@@ -135,7 +135,7 @@
{"digest":"1b912703e2d64f91c99c675b8f805b01076c8325b905c1218ad81ef0b24909d5","names":[],"sources":[]},
{"digest":"1c2686c0682e7bc51d61117b2652bd4a80707e331aa276d6ef915ae32534a330","names":[],"sources":[]},
{"digest":"1c5a58f4599bd4a9711712551ffe2442a5e5fcd0758bafe630cc4ead850bdaa7","names":[],"sources":[]},
{"digest":"1ccb56061942f5ccb0d30c9e4f2883b9d115ff906560029de637b61d3cde896d","names":[],"sources":["packages/core/session/src/types.ts:345"]},
{"digest":"1ccb56061942f5ccb0d30c9e4f2883b9d115ff906560029de637b61d3cde896d","names":[],"sources":["packages/core/session/src/types.ts:349"]},
{"digest":"1cde1bedde79c5e8a56aee9c05c8e0a579cf5bc611deb85b93fa331a16ca978f","names":["packages/compaction/compaction-image-offload/src/projection.ts#ImageOffloadTarget"],"sources":["packages/compaction/compaction-image-offload/src/projection.ts:9"]},
{"digest":"1d5f04a03ea75fc8eeece544129eba0f49f0c82046e9c404461920390135c7b2","names":[],"sources":[]},
{"digest":"1d76406cbb2ddadb0dbbb51e9d8bc6cf678fed455cf8eb512f36f7c86d37a62f","names":[],"sources":["packages/llm/llm/src/types.ts:157"]},
@@ -148,7 +148,7 @@
{"digest":"1ebc6f9ff3aa9e3a38f8695f49bacdab1f8b7a3832741853ca46f40af56ccd01","names":[],"sources":[]},
{"digest":"1f0133217eeeffd8d387baf1ec8ed9856e719bcd999dc08e48624cba96d75fd7","names":[],"sources":[]},
{"digest":"1f1385dbc3e875c021e387c7096d671d606f22daec51b25c80348735b6bbfa10","names":[],"sources":[]},
{"digest":"1f8c126cfab3df812cd115cfc23e3256f0fa2383400f4ce91ecad313577e59b0","names":["packages/core/session/src/types.ts#TurnEndCancelCause"],"sources":["packages/core/session/src/types.ts:197"]},
{"digest":"1f8c126cfab3df812cd115cfc23e3256f0fa2383400f4ce91ecad313577e59b0","names":["packages/core/session/src/types.ts#TurnEndCancelCause"],"sources":["packages/core/session/src/types.ts:201"]},
{"digest":"1fdad624334d354820dfb3a26e28d0bc9fc1b62a33f87bab63f715b3f4391bfd","names":[],"sources":[]},
{"digest":"20a57544bbf204dacd1ae6beb2ab29444365c3c869f2afdf489dcdcbc3d9c8c5","names":[],"sources":["packages/plan/plan-mode/src/index.ts:53"]},
{"digest":"2142e391b9ccb60d487afcf373ce74db98d952f69e8289eddb352a7e16e996c5","names":[],"sources":[]},
@@ -193,7 +193,7 @@
{"digest":"326a9bfda27dda5882fb3cbe6e715df41dae2298fdae3d66437457268a665693","names":["packages/llm/llm/src/call-config.ts#LlmCallConfigAdapterDefaults"],"sources":["packages/llm/llm/src/call-config.ts:54"]},
{"digest":"3305a4bb6b6c29b482ba91d59c60b47e8f98282d3dacc8c29e4a4c2712209bdd","names":[],"sources":[]},
{"digest":"33341aac09312300de5a178e6cc6f6544a4876f7f710cfea55eda473c8d329ef","names":["packages/llm/llm/src/assistant-stream.ts#AssistantStreamRecord"],"sources":["packages/llm/llm/src/assistant-stream.ts:20"]},
{"digest":"335e242de1fcc17b6ca920fc420d71bec2d76e53e37955c00948b65ab77f05c5","names":["packages/core/session/src/types.ts#SurfaceOp"],"sources":["packages/core/session/src/types.ts:466"]},
{"digest":"335e242de1fcc17b6ca920fc420d71bec2d76e53e37955c00948b65ab77f05c5","names":["packages/core/session/src/types.ts#SurfaceOp"],"sources":["packages/core/session/src/types.ts:470"]},
{"digest":"347de3380f2da308d0c74e08821f9e85559f55af4c5010795b110d00f7fc9dbd","names":[],"sources":[]},
{"digest":"34d1ab5c5df378186d6054b1a1beea9a41e41965d6f336f0bc0025c441a82e66","names":[],"sources":[]},
{"digest":"35203ba7ad5ef6f97d556b85df20ae98f04f09c65748cecdf8eefdb8b6405ffc","names":[],"sources":[]},
@@ -248,7 +248,7 @@
{"digest":"4b1e632e05776982a2d21c25a50c7c04c199d311c5675218fa73ff9fe30d22cd","names":["packages/schedule/schedule/src/types.ts#LegacyScheduleRecord"],"sources":["packages/schedule/schedule/src/types.ts:185"]},
{"digest":"4b259f7f8f0a44ad5e90b70a73553ced1df27012d126921d397ff403b6c86731","names":["packages/llm/llm/src/message.ts#ToolResultMessage"],"sources":["packages/llm/llm/src/message.ts:173"]},
{"digest":"4b7ddaf3710b88ff9b8df66304f5f97bf03688fd19730eedc2e9535203c820ea","names":[],"sources":[]},
{"digest":"4bb451330ff699f36b45539ceb0eb2606ead72084e2c5bb637c36cc80e2252db","names":[],"sources":["packages/core/session/src/types.ts:194"]},
{"digest":"4bb451330ff699f36b45539ceb0eb2606ead72084e2c5bb637c36cc80e2252db","names":[],"sources":["packages/core/session/src/types.ts:198"]},
{"digest":"4cd48f3e5108bd6ebedf7301c3638839b8b2b9db8dbd493974177fbdeb91a01b","names":["packages/api/session-controller/src/types.ts#SessionRequestId","packages/attachment/attachment/src/brand.ts#AttachmentId","packages/compaction/compaction/src/brand.ts#CompactionId","packages/core/session/src/types.ts#SessionId","packages/experimental/agent-team/src/types.ts#TeamId","packages/experimental/agent-team/src/types.ts#TeamMessageId","packages/experimental/agent-team/src/types.ts#TeamTaskId","packages/experimental/webhook/src/brand.ts#WebhookDeliveryId","packages/experimental/webhook/src/brand.ts#WebhookRuleId","packages/experimental/webhook/src/brand.ts#WebhookSourceId","packages/feedback/message-feedback/src/types.ts#MessageFeedbackVersion","packages/goal/goal/src/types.ts#GoalId","packages/interaction/commands/src/brand.ts#CommandId","packages/interaction/user-approval/src/types.ts#ApprovalRequestId","packages/jobs/jobs/src/brand.ts#JobId","packages/llm/llm-retry/src/brand.ts#RetryId","packages/llm/llm/src/brand.ts#MessageId","packages/llm/llm/src/brand.ts#ProviderRequestId","packages/llm/llm/src/brand.ts#ReasoningEffortId","packages/llm/llm/src/brand.ts#ToolCallId","packages/schedule/schedule/src/types.ts#ScheduleId","packages/session/session-title/src/index.ts#SessionTitleProviderId","packages/session/session-title/src/types.ts#SessionTitleProviderId","packages/workflow/workflow/src/types.ts#WorkflowRunId"],"sources":["packages/api/session-controller/src/types.ts:380","packages/attachment/attachment/src/brand.ts:6","packages/compaction/compaction/src/brand.ts:4","packages/core/session/src/types.ts:21","packages/experimental/agent-team/src/types.ts:21","packages/experimental/agent-team/src/types.ts:33","packages/experimental/agent-team/src/types.ts:9","packages/experimental/webhook/src/brand.ts:12","packages/experimental/webhook/src/brand.ts:6","packages/experimental/webhook/src/brand.ts:9","packages/feedback/message-feedback/src/types.ts:14","packages/goal/goal/src/types.ts:17","packages/interaction/commands/src/brand.ts:31","packages/interaction/user-approval/src/types.ts:17","packages/jobs/jobs/src/brand.ts:19","packages/llm/llm-retry/src/brand.ts:4","packages/llm/llm/src/brand.ts:16","packages/llm/llm/src/brand.ts:31","packages/llm/llm/src/brand.ts:43","packages/llm/llm/src/brand.ts:67","packages/schedule/schedule/src/types.ts:14","packages/session/session-title/src/index.ts:42","packages/session/session-title/src/types.ts:17","packages/workflow/workflow/src/types.ts:13"]},
{"digest":"4e011753f8263f436efaabfbb3b4db53a98fc55342c5ded2daf7208b217be159","names":[],"sources":[]},
{"digest":"4e44c9118152f6829634bfd508e47669ab0497caffa380c94b4be91f9390d35d","names":[],"sources":[]},
@@ -265,14 +265,14 @@
{"digest":"525254db03b1d1e6b74cf55aced52817568331ac1f96c0818728910b6692e336","names":[],"sources":[]},
{"digest":"529e0ccd0e34079ab4ff21ed87f810cee0388246263bf22e8aba5986b56fae05","names":[],"sources":["packages/util/values/src/index.ts:4"]},
{"digest":"52c6113cb0e53f345324bf84f01928bea5d5df57ee80bc0dd65407b8bc5a3734","names":[],"sources":[]},
{"digest":"5302e763151277614b97e77f00e3b326694c6c1247b916a20503c344dc970777","names":[],"sources":["packages/core/session/src/types.ts:379"]},
{"digest":"530da6c0267813bb4511af72883cc518834e624e3b3220a7062955fd57a788a6","names":["packages/core/session/src/types.ts#RequestHeaderReason"],"sources":["packages/core/session/src/types.ts:275"]},
{"digest":"5302e763151277614b97e77f00e3b326694c6c1247b916a20503c344dc970777","names":[],"sources":["packages/core/session/src/types.ts:383"]},
{"digest":"530da6c0267813bb4511af72883cc518834e624e3b3220a7062955fd57a788a6","names":["packages/core/session/src/types.ts#RequestHeaderReason"],"sources":["packages/core/session/src/types.ts:279"]},
{"digest":"53750b9abf61efb7992b0aadc3e247ec927449c63266df28230fd1139f5590ac","names":[],"sources":[]},
{"digest":"53cf1704ae0709c7678bcf070c83c619fc48ca1b5c173b74cfa8702f22a8e492","names":[],"sources":[]},
{"digest":"54f9276a1617d7c12594722c89cfe864bcbe4517e9a6f9c98bab14f199a135e0","names":[],"sources":["packages/core/session/src/types.ts:359"]},
{"digest":"54f9276a1617d7c12594722c89cfe864bcbe4517e9a6f9c98bab14f199a135e0","names":[],"sources":["packages/core/session/src/types.ts:363"]},
{"digest":"557e148d30b79ee48645850832b30c717d7c3b64641deb5d6133b8b4e91ee0b8","names":[],"sources":[]},
{"digest":"5654685d7557ec747e74887237065e626a5bdfa426ca43f7fbb0b6fee9b0916c","names":[],"sources":[]},
{"digest":"56b7c047694875a843ba020dfea3c8380d54ae4ff88ab349e72004dc21e07c23","names":[],"sources":["packages/core/session/src/types.ts:223"]},
{"digest":"56b7c047694875a843ba020dfea3c8380d54ae4ff88ab349e72004dc21e07c23","names":[],"sources":["packages/core/session/src/types.ts:227"]},
{"digest":"570e85022434613394418ad33e77e9f1f7a05699b33d0b62eae0677a638c3833","names":[],"sources":[]},
{"digest":"576a2de8355eb09850963ff5953420b172e274d9283666eb7d889097db120796","names":[],"sources":[]},
{"digest":"5776e5553ff2dfe3f5bc202dbb1e7c9f93e35a531aebb7764c23b2b6153b2ccc","names":[],"sources":[]},
@@ -326,10 +326,10 @@
{"digest":"6ab45ac76839722df912f3ba50f1c6b41f2d614bde11f1aabfae04117ccdc80d","names":[],"sources":[]},
{"digest":"6b23ed9ce1b397e602788dbe033693bf97642a69e23fcab1cc45bf6f13b6d619","names":[],"sources":[]},
{"digest":"6bbe793f6a93dc8d50a4d4d3fbb6f8ed15650bcb7e151d28669628f7b7c3fc25","names":["packages/goal/goal/src/types.ts#GoalSnapshot"],"sources":["packages/goal/goal/src/types.ts:60"]},
{"digest":"6bc8e51124d0874bc89e1d0ceff381a9c3cd0fc240667d69f841ce4f60f65fe5","names":[],"sources":["packages/core/session/src/types.ts:334"]},
{"digest":"6c03546143cdf6ae88f1745ac98c5139efa1588d1415249bbc5f3104d32ab800","names":[],"sources":["packages/core/session/src/types.ts:192"]},
{"digest":"6bc8e51124d0874bc89e1d0ceff381a9c3cd0fc240667d69f841ce4f60f65fe5","names":[],"sources":["packages/core/session/src/types.ts:338"]},
{"digest":"6c03546143cdf6ae88f1745ac98c5139efa1588d1415249bbc5f3104d32ab800","names":[],"sources":["packages/core/session/src/types.ts:196"]},
{"digest":"6c1cccb433ddc153facb380c7dda956237ba5c31f8a532a69142dc277890cc9b","names":[],"sources":[]},
{"digest":"6c5a37d42ebdb12db4410699259335f1e149e3a0260425684c00b153afc8990d","names":[],"sources":["packages/core/session/src/types.ts:193"]},
{"digest":"6c5a37d42ebdb12db4410699259335f1e149e3a0260425684c00b153afc8990d","names":[],"sources":["packages/core/session/src/types.ts:197"]},
{"digest":"6ccb6bc423fb3952458abf9c1b1c3284208b7e660344b612cc55da773d61afe4","names":[],"sources":[]},
{"digest":"6cda0d6d3b4336d83998fe580628426df81c2afbab5d768b8813b56d569120e8","names":[],"sources":[]},
{"digest":"6cf082d0fb6034dea61636787ff0ddf43b6e59aad71e644435a479bc9b83ad65","names":[],"sources":[]},
@@ -349,7 +349,7 @@
{"digest":"71bb3254ec8f1e491ce63b762a7b5f18709de23aa4e8abcc8b886f4b6ce051dd","names":[],"sources":["packages/llm/llm/src/assistant-stream.ts:28"]},
{"digest":"72ec79127a9c0d0241b1106a74cc2b24c81ce467170f1c3c93f7b71a9496d227","names":[],"sources":[]},
{"digest":"7382c4fc95fe8c5db65ca4d9da572b115d0dbb818b7f32c22ab040318ffbb4bc","names":[],"sources":[]},
{"digest":"7404c6123fdaa591474a37979a5a8ae70d1387af7c9f09bfe568b218935a974d","names":[],"sources":["packages/core/session/src/types.ts:313"]},
{"digest":"7404c6123fdaa591474a37979a5a8ae70d1387af7c9f09bfe568b218935a974d","names":[],"sources":["packages/core/session/src/types.ts:317"]},
{"digest":"750a2b129d67704df675c06823c20c80b65cbae89d5aaa914fd5a72e3df395b5","names":["packages/jobs/jobs/src/types.ts#JobSettleCause"],"sources":["packages/jobs/jobs/src/types.ts:247"]},
{"digest":"7554565be416b0342053ee6a46256c9dab07c487349b4a5f10bab1edc151c619","names":[],"sources":[]},
{"digest":"756b5e23a5cb2c7f486f366a828f7461c88902af21125bd6810881f4ccbff6cc","names":[],"sources":[]},
@@ -359,7 +359,7 @@
{"digest":"76632533f67879dcb346fcae640540dbc89b2472b0bce88c59f7e48fc5c0e668","names":[],"sources":[]},
{"digest":"78a9be340090b735a39980e7222ce730c972fbcf1de7c9e0aef2125884b7caee","names":[],"sources":[]},
{"digest":"78b9204976ab9faaf133c3488b73d1dfb6f1a4bb6c0903e3473cd41a5e1e39e1","names":[],"sources":[]},
{"digest":"79650cfa10aa3c52440328d85e8a25f0ffadc8d7efd784e3c0819d8bb74a1985","names":[],"sources":["packages/core/session/src/types.ts:214"]},
{"digest":"79650cfa10aa3c52440328d85e8a25f0ffadc8d7efd784e3c0819d8bb74a1985","names":[],"sources":["packages/core/session/src/types.ts:218"]},
{"digest":"79ddc907312f97cf9553d4841e8b3fc937097bd8d97900a790efad3c05255e99","names":[],"sources":["packages/todo/tool-todo/src/types.ts:33"]},
{"digest":"7a5b68bd1a5118c827df9e2466acc5e4d16b83e3f97a2304d992958647592690","names":["packages/llm/llm/src/message.ts#MessageSource"],"sources":["packages/llm/llm/src/message.ts:136"]},
{"digest":"7a651f3b672c52fb615f22c0ce9cb3cc5b22aad92e6bbeefb0808fd7b9233a50","names":[],"sources":[]},
@@ -440,7 +440,7 @@
{"digest":"99f0e98184709ad10f27bfdeaafb4457d9d2b413f402331764798cdb7d3cbe4d","names":[],"sources":[]},
{"digest":"9a2a9029f8d7ede05336980d8342737557f487b913bfd28853d0ab5214600ab5","names":[],"sources":["packages/web/web-search-deepseek/src/provider.ts:64"]},
{"digest":"9a410ddf56792b2b7cd4a224a2e54dc4dee30a8e8e6b1c2b9a1d19992b217adc","names":["packages/workflow/tool-workflow/src/types.ts#ToolWorkflowAgentStartData"],"sources":["packages/workflow/tool-workflow/src/types.ts:20"]},
{"digest":"9a930283b91d493d6347146f2475bb107294b379415ca02162354f46a64164f7","names":["packages/core/session/src/types.ts#EpochHeader"],"sources":["packages/core/session/src/types.ts:242"]},
{"digest":"9a930283b91d493d6347146f2475bb107294b379415ca02162354f46a64164f7","names":["packages/core/session/src/types.ts#EpochHeader"],"sources":["packages/core/session/src/types.ts:246"]},
{"digest":"9ac52f0f84fec2eb9f71c2937e497d759db5ca0da4836d93a679d113684141f2","names":[],"sources":[]},
{"digest":"9acbe713f3f641921dd3333b240aa72e176d795327c24e8d9db9b68b16771b49","names":[],"sources":[]},
{"digest":"9b4fd974c124c83743efe030ba4e1250e087505f3f74588716a521fb8d453267","names":[],"sources":[]},
@@ -472,7 +472,7 @@
{"digest":"a6da9ad5d42ae83a6833a8288b076688e8e0801633ea36cbdd8a30a6d9f3160c","names":["packages/workflow/tool-workflow/src/types.ts#ToolWorkflowRunStartData"],"sources":["packages/workflow/tool-workflow/src/types.ts:14"]},
{"digest":"a720757f704a2512e9d2f20da4a093e582472176236a75ab8b8eb7aaff17d85a","names":[],"sources":[]},
{"digest":"a7cf43ce7c2a4c038feed1885cd7a00d5c6ee2d90a7e0d56b46f78a3e1ca327f","names":[],"sources":[]},
{"digest":"a81059ca06999da1e712414520c2c65e491d052fcf9640fae20aa38f0a5dc735","names":[],"sources":["packages/core/session/src/types.ts:387","packages/core/tool-executor-ptc/src/types.ts:27"]},
{"digest":"a81059ca06999da1e712414520c2c65e491d052fcf9640fae20aa38f0a5dc735","names":[],"sources":["packages/core/session/src/types.ts:391","packages/core/tool-executor-ptc/src/types.ts:27"]},
{"digest":"a853902cfab417b8f08aa51ad6855fea46f34ed4588a74e47403035111d0fb86","names":[],"sources":["packages/interaction/commands/src/types.ts:105"]},
{"digest":"a8a2b9011fc067862df7ce40748868467e5778283d7ac193c13f77684a914c57","names":[],"sources":[]},
{"digest":"a9059a81430b320792bbb7c2ee1f8f6c77ff71e40ee44c18aec72e157c522694","names":[],"sources":[]},
@@ -485,14 +485,14 @@
{"digest":"aa93010d0e521ad7c42273f58d5c9b8bf1dfc94edf1b805a3971b364a35c1877","names":[],"sources":[]},
{"digest":"aacda84a69739238aa782eea902d3073017d9d74b9808de2bf5a83c9738cbdc6","names":[],"sources":[]},
{"digest":"aae343bc3d663c83f2e8b5e1c7eea5d509dc7a5361bc8bd8b5ac3bb8d3b1ed56","names":[],"sources":[]},
{"digest":"ab7ec5f9eb2c6dfacca5da4c37cf7ba85d04172053ee6b1ebf1709ffcd99c1a7","names":[],"sources":["packages/core/session/src/types.ts:216","packages/llm/llm/src/types.ts:159"]},
{"digest":"ab7ec5f9eb2c6dfacca5da4c37cf7ba85d04172053ee6b1ebf1709ffcd99c1a7","names":[],"sources":["packages/core/session/src/types.ts:220","packages/llm/llm/src/types.ts:159"]},
{"digest":"aba175fb20ffc71112c55efe70458ff5d7dbfb83501892b4ba8d077f0ea5d7ba","names":[],"sources":[]},
{"digest":"abd6ca62a5ab166553848324a23fef90eed7f59c8021bd63e7ea5bc6fd666b0c","names":["packages/web/web-search-deepseek/src/provider.ts#DeepSeekSearchLlmRequest"],"sources":["packages/web/web-search-deepseek/src/provider.ts:55"]},
{"digest":"ad0c38a0adb82a94c925456df41586d9b5f9202fca18593eae2213d4445b4585","names":[],"sources":["packages/core/session/src/types.ts:394"]},
{"digest":"ad0c38a0adb82a94c925456df41586d9b5f9202fca18593eae2213d4445b4585","names":[],"sources":["packages/core/session/src/types.ts:398"]},
{"digest":"ad22a5ca5bbaab2e1440779cd3648e85ddfc6f73b5207394eda699555cf31430","names":[],"sources":[]},
{"digest":"ad3b56aa2fc1ad4250e7399295d34a8eae592e1907e85852e2291b2e498a30bc","names":[],"sources":[]},
{"digest":"ad92f473a03ae72599ff26c86e897c25e16269519ad2a87340f0bea946517af8","names":[],"sources":[]},
{"digest":"ada310bf0bdb8fed51f3b56ea63f6ea6b18bbd587f04fccb63a14ab0b2a24e05","names":["packages/interaction/commands/src/types.ts#CommandSource"],"sources":["packages/core/session/src/types.ts:191","packages/interaction/commands/src/types.ts:75","packages/interaction/commands/src/types.ts:79","packages/llm/llm/src/message.ts:111","packages/session/session-title/src/types.ts:35"]},
{"digest":"ada310bf0bdb8fed51f3b56ea63f6ea6b18bbd587f04fccb63a14ab0b2a24e05","names":["packages/interaction/commands/src/types.ts#CommandSource"],"sources":["packages/core/session/src/types.ts:195","packages/interaction/commands/src/types.ts:75","packages/interaction/commands/src/types.ts:79","packages/llm/llm/src/message.ts:111","packages/session/session-title/src/types.ts:35"]},
{"digest":"ade057f4fdc387aec6426f48704a1f9359cfc6fee13f27735b07f9b215ec16ca","names":[],"sources":[]},
{"digest":"ae63d9d1080ed8945031594d93f8d96651d7101b848719cc3e1475875cd3d649","names":[],"sources":[]},
{"digest":"aec150797b655c5f15ebb7a501454b0c208fbaccec9ace49d7de2171fc02f47d","names":[],"sources":[]},
@@ -502,7 +502,7 @@
{"digest":"b0127044ab31a702bddfd785d345f5abd7a70876746e895ce443afa3e60ddf2d","names":[],"sources":[]},
{"digest":"b062078e899958f99ae464514578b8c093924dfe34bd9a835932b420ff2150b1","names":[],"sources":[]},
{"digest":"b0b0eb1b16490f6bee135b2377e8f8c39227974c799ad7d49ff418af23ecbc35","names":["packages/attachment/attachment/src/types.ts#ImageAttachmentRef"],"sources":["packages/attachment/attachment/src/types.ts:11"]},
{"digest":"b158f3ff6923714807c0d73882f0b05dc87f8fa85c9e90814852d48bbc866081","names":["packages/core/session/src/types.ts#RequestContext"],"sources":["packages/core/session/src/types.ts:256"]},
{"digest":"b158f3ff6923714807c0d73882f0b05dc87f8fa85c9e90814852d48bbc866081","names":["packages/core/session/src/types.ts#RequestContext"],"sources":["packages/core/session/src/types.ts:260"]},
{"digest":"b1664fa89f8eab49a14e7e3168d8bc4da4aa9fd76332f6c4a053d839e5276ae7","names":[],"sources":[]},
{"digest":"b1ebd5cda47d90d980bb05bffc3f970c51537b9aff15b3bc3d639811727741b1","names":[],"sources":["packages/experimental/agent-team/src/types.ts:230"]},
{"digest":"b1f62380f6746fedd629e71065e3583cef83334875b499ac9665c2eb87acfbf5","names":[],"sources":[]},
@@ -524,7 +524,7 @@
{"digest":"b613f83572fe2fbf7259c72308cafd008f4fceea897749128a48bcd158f290aa","names":[],"sources":[]},
{"digest":"b63b089a00b3b9357675b3e0c3d3e9aa4fdbda1fba9c91a6b0c59ffdbb89f505","names":["packages/schedule/schedule/src/types.ts#LegacyAtScheduleRecord"],"sources":["packages/schedule/schedule/src/types.ts:167"]},
{"digest":"b6896938660a1dfe4ddd100fb3164d9f8fa57feeabfe37441a80106c9942697a","names":[],"sources":[]},
{"digest":"b6ef9c6210be8350cd465f485cf520031fffa6bf3809c61a1e713e834c5982d0","names":[],"sources":["packages/core/session/src/types.ts:203"]},
{"digest":"b6ef9c6210be8350cd465f485cf520031fffa6bf3809c61a1e713e834c5982d0","names":[],"sources":["packages/core/session/src/types.ts:207"]},
{"digest":"b6f94c17dd9bbd7cd57015198b7c7c88407f0e3b89faab176ca3c11c3d864d3e","names":[],"sources":[]},
{"digest":"b70f3e81fe11b7a5f2504fb47a4502fb8d9c8f0731fdfe8ddcaf9b41f5a6e196","names":[],"sources":[]},
{"digest":"b765ee31033cea463863faf3fc6a0a1b85c47c6a2f13fe1ce833abe56105114b","names":[],"sources":[]},
@@ -547,7 +547,7 @@
{"digest":"bb1ab3d08f49a9f3b265f844cd78d5c49813062a7b34b54904b426f85d0ff6e3","names":[],"sources":[]},
{"digest":"bb94f3217aa56c8876bbff0b8460d6a73cbead545659abb29e76cd0cf2cb92d6","names":[],"sources":[]},
{"digest":"bbc5696e3f13c758237b316e3cf08cda0b9fd51ffe672539883457769faa185d","names":[],"sources":[]},
{"digest":"bcf0caf62d964b2fcf5404bd5c909cfa9a21c3f3c96e6b7e36d9e33565223825","names":[],"sources":["packages/core/session/src/types.ts:468"]},
{"digest":"bcf0caf62d964b2fcf5404bd5c909cfa9a21c3f3c96e6b7e36d9e33565223825","names":[],"sources":["packages/core/session/src/types.ts:472"]},
{"digest":"bd499eac047efe091a4df7382eadd06d25cf0cb31fee3981e8b24d85762841cd","names":[],"sources":[]},
{"digest":"bf16d2e98a7f13894ded2cffe5ce857bf473954a0e3c0ed9bc7739e2e1c7b78a","names":[],"sources":[]},
{"digest":"c0ea97bc89dfc46fa94eab956f5c3ee6af2f964aa7db6327cb18b451f207bef7","names":["packages/workflow/tool-workflow/src/types.ts#ToolWorkflowAgentEndData"],"sources":["packages/workflow/tool-workflow/src/types.ts:29"]},
@@ -621,8 +621,8 @@
{"digest":"e41bdebe246abe17154de7e7a1d81035437eee8d20e7f1edff0d91e2598ad828","names":[],"sources":[]},
{"digest":"e42b0f40b5d0b628c6e1c44a8fb9eda0780037a81959e1b93d2dfb47b46b0e87","names":[],"sources":[]},
{"digest":"e438a9d4fb883b3e4a8d9fc8913aa1550ed50eb384bfbf943100a5605b537498","names":[],"sources":[]},
{"digest":"e481c46af3813e0010558e93f578b2986acd658404cec2d1679e3ac2a6c48654","names":[],"sources":["packages/core/session/src/types.ts:299"]},
{"digest":"e4c18e294232c3ba6c9f1999f168263cc55956147cfe4121720899be8e52edd1","names":[],"sources":["packages/core/session/src/types.ts:365"]},
{"digest":"e481c46af3813e0010558e93f578b2986acd658404cec2d1679e3ac2a6c48654","names":[],"sources":["packages/core/session/src/types.ts:303"]},
{"digest":"e4c18e294232c3ba6c9f1999f168263cc55956147cfe4121720899be8e52edd1","names":[],"sources":["packages/core/session/src/types.ts:369"]},
{"digest":"e4cac694f8b6e1d52e48c699464f1c4c26111ef87e558f7931040d00fdc8d486","names":[],"sources":[]},
{"digest":"e5d3828df1ec3e2a66879de0659e0f4866d9cfffc00825ee731a66f8a0c03d98","names":[],"sources":[]},
{"digest":"e6063d0451dc02026fd9b54ad3f77c7b1b6392ad3e872a7737ac84e13ca72344","names":["packages/schedule/schedule/src/types.ts#EveryScheduleDispatchChange"],"sources":["packages/schedule/schedule/src/types.ts:244"]},
@@ -636,22 +636,22 @@
{"digest":"e8de0f457fed5b9ff94dc4950b59ef75fd8ba8af665cc7899485924a62653367","names":[],"sources":[]},
{"digest":"e95f957154b2b1b58692af53d4131180b6dd19e2264869f876dbaa959991494e","names":[],"sources":[]},
{"digest":"ea08ec1df0c33108fd03345b9af199cf04dea450aa045d3c683f216311403403","names":[],"sources":["packages/experimental/agent-team/src/types.ts:234"]},
{"digest":"eaa71be0fbf0f702df8ea6c11d0aa2f9782263d45a10d0fb14eda662f4bfe04c","names":[],"sources":["packages/core/session/src/types.ts:197"]},
{"digest":"eaa71be0fbf0f702df8ea6c11d0aa2f9782263d45a10d0fb14eda662f4bfe04c","names":[],"sources":["packages/core/session/src/types.ts:201"]},
{"digest":"ebb768d85ec87fb68e42fc14fd7d8535b5ac11791b14d04c6770180f0a719bf8","names":[],"sources":[]},
{"digest":"ec38b5949af8eacaf00df002f4acbe344f934f8a061e9cdc65a52a48e5f6dd93","names":[],"sources":[]},
{"digest":"ec8b5ff7c77ca6893ac7ba5a0c5b2aefeb52f12c64450b7359660c2a7e8a53d7","names":[],"sources":["packages/core/session/src/types.ts:230"]},
{"digest":"ec8b5ff7c77ca6893ac7ba5a0c5b2aefeb52f12c64450b7359660c2a7e8a53d7","names":[],"sources":["packages/core/session/src/types.ts:234"]},
{"digest":"edbbfff1128099fda7b792c56330d2cb04debc9790988e66d1c3f4026e813e0e","names":[],"sources":[]},
{"digest":"edd37b1e4974af648633014435572089b1e8fb71910468a0767a7e28fdd22abf","names":[],"sources":[]},
{"digest":"ee577a0cc18664c9daee50e9455153321155604f8f1817362f8f4a4b6fb9e1ad","names":[],"sources":[]},
{"digest":"eea687d437880bd5f55fb447a561112800ca34334c0724d9cecb98493059d9e4","names":["packages/schedule/schedule/src/types.ts#ScheduleCreateChange"],"sources":["packages/schedule/schedule/src/types.ts:223"]},
{"digest":"eefbea819caeeea91ccb02dfafc16c68dd7f961cf9c1b2be25a2084509cf5c5a","names":[],"sources":[]},
{"digest":"ef11a3b7fa2033ae4279545ff8a8a2ee4e301b9b73e5b91654c48e6d08283545","names":[],"sources":["packages/core/session/src/types.ts:301","packages/core/session/src/types.ts:303"]},
{"digest":"ef11a3b7fa2033ae4279545ff8a8a2ee4e301b9b73e5b91654c48e6d08283545","names":[],"sources":["packages/core/session/src/types.ts:305","packages/core/session/src/types.ts:307"]},
{"digest":"ef226a90ddac6cd8e631a3a337a3a3e27f9494be92befb7c718b404681d75e21","names":[],"sources":[]},
{"digest":"ef4f00923b9edbae15c7ef05320280bf61147ca17146cf59690359bfd5e5da45","names":[],"sources":[]},
{"digest":"efa1a091017ce533e38b0ef3e14d11a5c102ff1793229b18dad719a4268d9adc","names":[],"sources":[]},
{"digest":"f05fb85e715af4ab4de0b6ba111166dd0435bd8bb74a0fa0f32b9d174113fc7c","names":[],"sources":[]},
{"digest":"f09e5e7acf5ff5ccd193ff2eeec015fa2ff7c29d98bc465f8c3302058d47e29b","names":["packages/core/agent/src/types.ts#ModelSelection"],"sources":["packages/core/agent/src/types.ts:79"]},
{"digest":"f1687f982fa3d41ef29e159feed154ecd13af4dd209acaee16038f223f2e9402","names":["packages/core/session/src/types.ts#TurnEndReason"],"sources":["packages/core/session/src/types.ts:234"]},
{"digest":"f1687f982fa3d41ef29e159feed154ecd13af4dd209acaee16038f223f2e9402","names":["packages/core/session/src/types.ts#TurnEndReason"],"sources":["packages/core/session/src/types.ts:238"]},
{"digest":"f1996af2602e6f62b5ab179ca5c4af00d8753938b74cc6ef102de09e99e74a7e","names":[],"sources":[]},
{"digest":"f19bee84bf3d20904553cdcd57465232bc1c2a194f54c4d195292ba0487223a6","names":["packages/attachment/attachment/src/types.ts#FileAttachmentRef"],"sources":["packages/attachment/attachment/src/types.ts:39"]},
{"digest":"f1a96afe7503ac1817de769cd0ba13d9b80111c7034c50106b3344ecc14cc515","names":[],"sources":["packages/llm/llm/src/types.ts:476"]},
@@ -672,7 +672,7 @@
{"digest":"f731ffe80810b0289b3e694d8f40af6f01865c02a622ee457be90ca808b66e87","names":["packages/subagent/subagent/src/catalog.ts#SubagentCatalogEvent"],"sources":["packages/subagent/subagent/src/catalog.ts:28"]},
{"digest":"f789af5ab844827eb5a4f357c0afae1eeed108c6c22d8ca1a56e586b349a7c85","names":[],"sources":[]},
{"digest":"f88f1b7b6bb733f685f5fb6a8744a5db9199fa53c90463ea1a33bad51153671d","names":[],"sources":[]},
{"digest":"f90eb4ab2d3897bc20c521a038e3119d581f791ec974b1a0004f63a8ab9e232d","names":[],"sources":["packages/core/session/src/types.ts:290","packages/deliverables/workspace-changes/src/types.ts:106"]},
{"digest":"f90eb4ab2d3897bc20c521a038e3119d581f791ec974b1a0004f63a8ab9e232d","names":[],"sources":["packages/core/session/src/types.ts:294","packages/deliverables/workspace-changes/src/types.ts:106"]},
{"digest":"f97f47b0eb87905ed77cc27c5e4ed75ef805cb372c98905253709de1aab9b63c","names":[],"sources":[]},
{"digest":"f9cfc89e8fe085b4fcc9cd32b74b6f103608c54d7d8cd97b47c01de34f252ba3","names":[],"sources":[]},
{"digest":"fa87537f4a9c1e25602990a8bf686b383e9e00352ec8946e16ae24ba7c1625be","names":["packages/llm/llm/src/message.ts#AssistantMessage"],"sources":["packages/llm/llm/src/message.ts:167"]},
+5 -1
View File
@@ -156,7 +156,11 @@ interface SessionHeader {
readonly createdAt: number
/** Absolute working directory the session was created in (if any). */
readonly cwd?: string
/** The session this one was forked from (seed lineage), if any. */
/**
* Direct creator of a subagent Session. Ordinary forks omit this field;
* historical ordinary forks may retain their source id here. Presence alone
* does not classify a Session as a subagent; use `origin` for that distinction.
*/
readonly parentSession?: SessionId
/**
* Whether this Session contains a fork-inherited event prefix. The exact prefix
+5 -1
View File
@@ -156,7 +156,11 @@ interface SessionHeader {
readonly createdAt: number
/** Absolute working directory the session was created in (if any). */
readonly cwd?: string
/** The session this one was forked from (seed lineage), if any. */
/**
* Direct creator of a subagent Session. Ordinary forks omit this field;
* historical ordinary forks may retain their source id here. Presence alone
* does not classify a Session as a subagent; use `origin` for that distinction.
*/
readonly parentSession?: SessionId
/**
* Whether this Session contains a fork-inherited event prefix. The exact prefix
+2 -2
View File
@@ -45,8 +45,8 @@
en: 45d1a9ee6d610ac5
zh: 79c061252fde4ceb
/sessions/live-session-fork-api:
en: c72c73ce4b4c697c
zh: 8a34785a92df0ad5
en: 06189884c62a80a1
zh: 30121aed7a011c72
/sessions/why-a-turn-ended-turnendreasonmap:
en: 966cc60273fb3911
zh: de5123ea9dbb0df2
+2 -2
View File
@@ -685,7 +685,7 @@ Everything else (`turn/*`, `step/*`, `assistant/attempt`, plugin-owned `llm/retr
`ctx.sessions.create(id, { seed, meta })` is the low-level replay/fork primitive. For ordinary live-session forks, `SessionStore` exposes one policy API:
- `fork(source, boundary?, childSessionId?)` accepts a live `Session` object or live `SessionId`, selects source events through the inclusive `SessionSeq` boundary (default: current last event), requires the selected prefix to end outside an open turn, then creates a live child session with deep-cloned seed events, `parentSession`, `isSeeded: true`, the exact `inheritedEventCount`, and inherited `cwd`.
- `fork(source, boundary?, childSessionId?)` accepts a live `Session` object or live `SessionId`, selects source events through the inclusive `SessionSeq` boundary (default: current last event), closes any open tail, then creates an independent live session with deep-cloned seed events, `isSeeded: true`, the exact `inheritedEventCount`, and inherited `cwd`, without `parentSession`.
An explicit `boundary` lets callers fork from any stable between-turn position, including a previous `turn/end` or a later standalone log-only event, even if the source has newer events or an open current turn. The API rejects a prefix that ends inside an open turn instead of clipping silently. `dsh-subagent-fork-in-process` keeps its completed-prefix clipping because tool-time delegation usually starts while the parent turn is open; ordinary session branching should make the requested boundary explicit.
@@ -1130,7 +1130,7 @@ get(id: SessionId): Session | undefined
list(): Session[]
/**
* Create a live child session from an exact prefix of a live source.
* Create an independent live session from an exact prefix of a live source.
* `boundary` is an inclusive source event seq; omitted means the source's
* current last event. An open tail receives synthetic tool results and
* step/turn closers with the forked cause. Closed steps and turns remain
+2 -2
View File
@@ -687,7 +687,7 @@ declare class Session {
`ctx.sessions.create(id, { seed, meta })` 是底层的回放/fork 原语。对于普通的活跃会话 fork,`SessionStore` 暴露一个策略 API:
- `fork(source, boundary?, childSessionId?)` 接受一个活跃的 `Session` 对象或活跃的 `SessionId`,选取到 `SessionSeq` boundary(含)为止的源事件(默认为当前最后一个事件),要求所选前缀结束时没有开放轮次,然后创建一个活跃的子会话,包含深克隆的 seed event、`parentSession`、`isSeeded: true`、精确 `inheritedEventCount` 及继承的 `cwd`。
- `fork(source, boundary?, childSessionId?)` 接受一个活跃的 `Session` 对象或活跃的 `SessionId`,选取到 `SessionSeq` boundary(含)为止的源事件(默认为当前最后一个事件),闭合任何开放尾部,然后创建一个独立的活跃会话,包含深克隆的 seed event、`isSeeded: true`、精确 `inheritedEventCount` 及继承的 `cwd`,不含 `parentSession`。
显式 `boundary` 允许调用者从任意稳定的轮次间位置 fork,包括之前的 `turn/end` 或更晚的独立纯日志事件,即使源会话有更新的事件或正在进行的轮次。API 拒绝结束于开放轮次内的前缀,而不是静默截断。`dsh-subagent-fork-in-process` 保留其已完成前缀截断逻辑,因为工具调用时的委托通常在父轮次仍然打开时启动;普通的会话分支应显式指定请求的 boundary。
@@ -1134,7 +1134,7 @@ get(id: SessionId): Session | undefined
list(): Session[]
/**
* Create a live child session from an exact prefix of a live source.
* Create an independent live session from an exact prefix of a live source.
* `boundary` is an inclusive source event seq; omitted means the source's
* current last event. An open tail receives synthetic tool results and
* step/turn closers with the forked cause. Closed steps and turns remain
@@ -0,0 +1,16 @@
# Bilingual-pair consistency record for guide.md (docs/i18n/README.md): per heading
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/upgrade-guide/v0.2.1-rc.3/independent-session-forks/guide.md
/:
en: 68f919837577038b
zh: 6ae8223b1542c369
/ordinary-forks-are-independent-sessions:
en: 4556d51bd8086cfe
zh: 8811b03db9225739
/ordinary-forks-are-independent-sessions/change:
en: 0a2790279aec9e24
zh: 5cca673af988a228
/ordinary-forks-are-independent-sessions/migration:
en: 53b586ad6498fdb8
zh: dfa70928e17478e2
@@ -0,0 +1,23 @@
---
kind: upgrade-guide
description: "Ordinary Session forks stop recording their source relationship and stop appearing as subagents."
---
# Ordinary forks are independent Sessions
English | [中文](guide.zh.md)
## Change
Ordinary forks copy the selected history and continue independently. They omit `SessionHeader.parentSession` and the Client's `parentSessionId`; no replacement source field is written. Subagents, including fork-backend subagents, retain their direct creator. Existing logs retain their recorded metadata.
SDK `subagent.started` excludes ordinary forks, including historical ones carrying a parent id. ACP list/resume admits ordinary forks; headless adoption also accepts them when cwd and preset checks pass. Client lists no longer indent them or insert newly discovered forks before their sources; saved manual positions remain intact. Source-based trace queries, parent filters, telemetry, and remote logs cannot recover the source of new ordinary forks. Workspace binding, optional title increments, inherited history, and seed boundaries remain available.
The Session format stays V4. Older V4 readers may reject a parentless fork containing inherited delivery acknowledgements as a corrupt log with `current-generation delivery marker names the wrong Session`. The tested readers refuse before granting a handle or truncating the file. They do not provide an upgrade-specific diagnostic. See the [compatibility decision](../../../../.agents/notes/implemented/architecture/2026-10-23-independent-session-forks.md).
## Migration
1. Upgrade every reader and writer sharing the Session directory before resuming newly created forks. Do not edit old headers or delete delivery records to bypass an older reader's rejection.
2. Replace consumer checks that treat any `parentSession` as a subagent with `origin === 'subagent'`. Continuation still requires a valid descriptor from the Session's own event range; inherited descriptors do not establish its identity.
3. Remove any ordinary-fork workflow that requires persistent source tracing. Keep source-dependent actions such as workspace selection within the fork operation.
4. Confirm that an ordinary fork has no parent field, survives restart with inherited delivery records, and produces no `subagent.started`; confirm that real subagents retain their creator and notification.
@@ -0,0 +1,23 @@
---
kind: upgrade-guide
description: "普通 Session fork 停止记录来源关系,也不再显示为子代理。"
---
# 普通 fork 是独立 Session
[English](guide.md) | 中文
## 变更
普通 fork 复制选定历史并独立继续运行。它们省略 `SessionHeader.parentSession` 及客户端的 `parentSessionId`,不写入替代来源字段。子代理(包括使用 fork backend 的子代理)保留直接创建者。已有日志保留记录中的元数据。
SDK 的 `subagent.started` 排除普通 fork,包括携带父 ID 的历史会话。ACP 列表和恢复允许普通 fork;通过 cwd 和 preset 检查的普通 fork 也可由 headless 沿用。客户端列表不再将它们缩进,也不再把新发现的 fork 插到来源之前;已保存的手动位置保持不变。基于来源的追踪查询、父关系筛选、遥测和远端日志无法还原新普通 fork 的来源。工作区绑定、可选标题递增、继承历史和 seed 边界仍然可用。
Session 格式保持 V4。旧 V4 reader 可能将包含继承投递确认的无父关系 fork 作为损坏日志拒绝,报错为 `current-generation delivery marker names the wrong Session`。已测试的 reader 在授予句柄或截断文件之前拒绝,不提供专门的升级诊断。参见[兼容性决策](../../../../.agents/notes/implemented/architecture/2026-10-23-independent-session-forks.zh.md)。
## 迁移
1. 在恢复新建 fork 之前,升级共享 Session 目录的全部 reader 和 writer。不要编辑旧 header 或删除投递记录来绕过旧 reader 的拒绝。
2. 将消费方中把任意 `parentSession` 视为子代理的检查替换为 `origin === 'subagent'`。继续运行仍要求来自 Session 自身事件区间的有效 descriptor;继承的 descriptor 不建立其身份。
3. 移除依赖持久化来源追踪的普通 fork 工作流。工作区选择等依赖来源的动作保留在 fork 操作期间。
4. 确认普通 fork 不含父字段、携带继承投递记录也能在重启后恢复,且不产生 `subagent.started`;确认真正子代理保留创建者及通知。
+2 -2
View File
@@ -27,8 +27,8 @@
en: 4ed8e37834267edb
zh: a32d5dedb4e8e919
/deepseek-ai-dsh-acp/use-this-package/protocol-contract:
en: 8f358b006f93f6ab
zh: a02dc9640cac4edd
en: 195315c12edf895f
zh: de307288858a8ece
/deepseek-ai-dsh-acp/understand-the-implementation:
en: ea8afe89dbdd1934
zh: 6567979f92f34afd
+2
View File
@@ -73,6 +73,8 @@ One connection can run several sessions at once, each independent. The calls a c
| `session/update` | Committed assistant messages and thoughts, generic tool lifecycle, configuration changes, and context usage, serialized per session. |
| `session/request_permission` | A permission prompt with one-shot allow/reject choices; your client can answer automatically. |
Session listing and resume admit ordinary forks, including historical logs with `parentSession`; `origin: subagent` remains excluded.
A prompt remains in flight while managed descendants run, while their results trigger later root turns, and while committed output drains. Root work accepted during that output drain joins the same activity interval before completion. Its completion includes the latest root stop reason and any assistant output delivery failure; only the original prompt turn pins the model selection captured at admission. Cancellation stops the root activity present at that call and waits for that activity and its queued output. Later child messages may start autonomous work and do not delay the cancelled response; the session remains available for later prompts. Idle descendants with parked inbox messages remain resident but do not delay prompt completion. Closing the session also drains its descendants.
A failure to append `turn/start` or `turn/end` rejects the prompt even when a preceding turn completed.
+2
View File
@@ -73,6 +73,8 @@ kind: "package-reference"
| `session/update` | 已提交 assistant 消息与 thought、通用工具生命周期、配置变化与上下文用量,按会话串行交付。 |
| `session/request_permission` | 带一次性允许/拒绝选项的权限提示;你的客户端可以自动回答。 |
会话列表和恢复允许普通 fork,包括含有 `parentSession` 的历史日志;`origin: subagent` 仍被排除。
受管理后代运行期间、它们的结果触发根 Agent 后续轮次期间,以及已提交输出仍在交付期间,提示词保持进行中。输出交付期间接受的根 Agent 工作会加入同一活动区间,并在该区间完成后结算。最终结果包含最新根轮次的停止原因与所有助手输出交付错误;只有原始提示词轮次固定使用接受时捕获的模型选择。取消会停止调用时已有的根 Agent 活动,并等待该活动及其已排队输出完成。之后到达的子 Agent 消息可以启动自主工作,但不会延迟取消响应;会话仍可接受后续提示词。收件箱消息处于停放状态的空闲后代继续驻留,但不延迟提示词完成。关闭会话还会释放其后代。
即使前一轮已经完成,追加 `turn/start` 或 `turn/end` 失败仍会使提示词请求失败。
+1 -2
View File
@@ -248,7 +248,7 @@ export function apply(ctx: Context, config: AcpConfig): void {
activating.add(sessionId)
return (async (): Promise<ResumeSessionResponse> => {
const persisted = (await persistence.stat(sessionId, { signal }))?.header
if (persisted === undefined || persisted.origin === 'subagent' || persisted.parentSession !== undefined) {
if (persisted === undefined || persisted.origin === 'subagent') {
throw invalidParams(`session is not resumable: ${sessionId}`)
}
if (!await sameDirectory(persisted.cwd, params.cwd)) {
@@ -308,7 +308,6 @@ export function apply(ctx: Context, config: AcpConfig): void {
|| activating.has(header.id)
|| ctx.sessions.get(header.id) !== undefined
|| header.origin === 'subagent'
|| header.parentSession !== undefined
|| header.cwd === undefined
|| !isAbsolute(header.cwd)
) return undefined
+18 -1
View File
@@ -6,7 +6,7 @@ import { join } from 'node:path'
import { fileURLToPath } from 'node:url'
import { AttachmentError } from '@deepseek-ai/dsh-attachment'
import { ToolCallId, type StreamChunk } from '@deepseek-ai/dsh-llm'
import { SESSION_FORMAT_VERSION, SessionId } from '@deepseek-ai/dsh-session'
import { SESSION_FORMAT_VERSION, SessionId, SessionLogOffset, SessionSeq } from '@deepseek-ai/dsh-session'
import type { SessionHeader } from '@deepseek-ai/dsh-session'
import { SessionPersistenceRevision, type SessionPersistenceSnapshot } from '@deepseek-ai/dsh-session-persistence'
import { defineContentToolFixture } from '@deepseek-ai/dsh-tool-testkit'
@@ -388,6 +388,22 @@ describe('automation-only ACP bridge', () => {
await expect(harness.client.listSessions({ cursor: 'not-a-cursor' })).rejects.toThrow(/cursor is invalid/)
})
it.each([false, true])('resumes an ordinary fork with legacy parent metadata=%s', async (legacy) => {
harness = await makeBridgeHarness()
await harness.client.initialize({ protocolVersion: PROTOCOL_VERSION, clientCapabilities: {} })
const id = SessionId('ordinary-fork')
const writer = await harness.ctx.sessionPersistence.create({
version: SESSION_FORMAT_VERSION, id, createdAt: 1, isSeeded: true,
cwd: process.cwd(), ...(legacy ? { parentSession: SessionId('source') } : {}),
}, { inheritedEventCount: SessionLogOffset(0) })
try {
await writer.append([{ type: 'session/end-seed', seq: SessionSeq(0), time: 1, data: { inherited: true } }])
} finally { await writer.close() }
await expect(harness.client.listSessions({})).resolves.toMatchObject({ sessions: [{ sessionId: id }] })
await harness.client.resumeSession({ sessionId: id, cwd: process.cwd() })
expect(harness.ctx.agents.get(id)?.session.header.parentSession).toBe(legacy ? 'source' : undefined)
})
it('filters non-resumable headers and canonical missing workspaces', async () => {
harness = await makeBridgeHarness()
await harness.client.initialize({ protocolVersion: PROTOCOL_VERSION, clientCapabilities: {} })
@@ -411,6 +427,7 @@ describe('automation-only ACP bridge', () => {
await expect(harness.client.listSessions({ cwd: 'relative' })).rejects.toThrow(/absolute path/)
await expect(harness.client.listSessions({ cwd: '/missing/filter' })).resolves.toEqual({
sessions: [
{ sessionId: 'fork', cwd: '/missing/filter' },
{ sessionId: 'valid-a', cwd: '/missing/filter' },
{ sessionId: 'valid-b', cwd: '/missing/filter' },
],
@@ -15,8 +15,8 @@
en: 1fdf707322fb6996
zh: 0204f7e9d4aa3cce
/session-controller/use-this-package:
en: aabd5be911e477f5
zh: 2f7fdb44bc8777bc
en: 966e2852184146bf
zh: 31e3587651d991be
/session-controller/client-references:
en: 41bdda1ac32df558
zh: aa5d0e325924066b
+1 -1
View File
@@ -62,7 +62,7 @@ During uninterrupted following, transcript and steering echoes stay in Chat thro
The user-invocable `skills/list` metadata includes the winning provider’s optional instruction-file `path`. The composer can preview that file without loading every skill body or activating a cold Agent.
Fork copies the exact inclusive event prefix selected by `atSeq`, including a cut inside an open turn. The child records its inherited marker before synthetic fork results and closing events. Omitting `atSeq` selects the latest completed turn and its standalone tail, stopping before the next turn or queued input; a nonexistent event is rejected. The chat action selects a completed turn.
Fork copies the exact inclusive event prefix selected by `atSeq`, including a cut inside an open turn, into an independent Session without `parentSession`. Client placeholders likewise omit `parentSessionId`; list indentation applies only to subagent-origin rows, including when historical ordinary forks retain a parent id. Workspace attachment and optional title increments use the source selected for the operation. The child records its inherited marker before synthetic fork results and closing events. Omitting `atSeq` selects the latest completed turn and its standalone tail, stopping before the next turn or queued input; a nonexistent event is rejected. The chat action selects a completed turn.
A resume blocked by an existing write handle returns `session/writer-held` with the Session id; other resume failures retain `gateway/internal`.
+1 -1
View File
@@ -62,7 +62,7 @@ Session 对象还承载本地提交回显:`session.beginSubmission` 在调用
面向用户调用的 `skills/list` 元数据包含胜出提供方可选的指令文件 `path`。输入框可据此预览文件,无需加载每个 skill 的正文或激活冷态 Agent。
Fork 复制 `atSeq` 所选的精确事件前缀,包含切点事件,允许在开放轮次内截取。子会话在合成的 fork 结果和结束事件之前记录继承标记。省略 `atSeq` 时选择最近已结束轮次及其独立尾部,在下一轮次或排队输入之前停止;不存在的事件会被拒绝。聊天操作选择已结束轮次。
Fork 将 `atSeq` 选定的含边界事件前缀(包括开放轮次内的截点)复制到不带 `parentSession` 的独立 Session。客户端占位项同样省略 `parentSessionId`;列表缩进仅适用于 subagent 来源的行,历史普通 fork 即使保留父 ID 也不缩进。工作区绑定及可选标题递增使用本次操作选定的源会话。子会话在合成的 fork 结果和结束事件之前记录继承标记。省略 `atSeq` 时选择最近已结束轮次及其独立尾部,在下一轮次或排队输入之前停止;不存在的事件会被拒绝。聊天操作选择已结束轮次。
恢复会话时若已有写句柄占用,返回 `session/writer-held`,并携带会话 id;其他恢复失败仍返回 `gateway/internal`。
@@ -60,7 +60,8 @@ export function flattenLineage(
const children = new Map<SessionId, TitledSessionSummary[]>()
const roots: TitledSessionSummary[] = []
for (const s of summaries) {
if (s.parentSessionId !== undefined && byId.has(s.parentSessionId)) {
// Historical ordinary forks may retain a parent id without being subagents.
if (s.origin === 'subagent' && s.parentSessionId !== undefined && byId.has(s.parentSessionId)) {
const list = children.get(s.parentSessionId) ?? []
list.push(s)
children.set(s.parentSessionId, list)
@@ -553,7 +553,7 @@ export class SessionManager {
* immediately (same synchronous-addressability guarantee as create).
* Blankness starts provisionally true so the authoritative Host summary can
* preserve it or lower it after an exact cut before the first `turn/start`;
* lineage rides parentSessionId. A child published before Workspace
* the fork has no durable source relationship. A child published before Workspace
* attachment fails is also reconciled into the list.
* @param opts - source session, optional exact inclusive boundary seq, and permission to start migration.
* @returns the fork result (the child session id).
@@ -573,7 +573,6 @@ export class SessionManager {
if (childId !== undefined) {
this.recordMutation({ kind: 'placeholder', summary: { agentAvailable: true,
sessionId: childId, updatedAt: Date.now(), running: false, blank: true,
parentSessionId: opts.sessionId,
...(source?.cwd !== undefined ? { cwd: source.cwd } : {}),
} })
}
@@ -273,7 +273,6 @@ export class SessionCommandController {
inheritedEventCount: SessionLogOffset(boundary + 1),
meta: {
...(source.header.cwd === undefined ? {} : { cwd: source.header.cwd }),
parentSession: source.header.id,
isSeeded: true,
...(composition.agentPreset === undefined
? {}
@@ -9,7 +9,7 @@ import { flattenLineage } from '../src/client/sessions/lineage.ts'
const s = (id: string, updatedAt: number, parent?: string): SessionSummary => ({ agentAvailable: true,
sessionId: id as SessionId, updatedAt, running: false, blank: false,
...(parent !== undefined ? { parentSessionId: parent as SessionId } : {}),
...(parent !== undefined ? { parentSessionId: parent as SessionId, origin: 'subagent' as const } : {}),
})
describe('Session lineage flattening', () => {
@@ -26,6 +26,16 @@ describe('Session lineage flattening', () => {
])
})
it('keeps historical ordinary forks at root level in input order', () => {
const out = flattenLineage([
s('source', 10), s('unrelated', 20),
{ ...s('legacy-fork', 30), parentSessionId: 'source' as SessionId },
])
expect(out.map(row => [row.sessionId, row.depth])).toEqual([
['source', 0], ['unrelated', 0], ['legacy-fork', 0],
])
})
it('degrades an orphan (absent parent) to root level without dropping it', () => {
const out = flattenLineage([s('orphan', 20, 'ghost-parent'), s('root', 10)])
expect(out.map(e => [e.sessionId, e.depth])).toEqual([['orphan', 0], ['root', 0]])
@@ -1261,7 +1261,8 @@ describe('remaining branches', () => {
expect(remote.session.fork).toHaveBeenCalledExactlyOnceWith({ sessionId: S1, atSeq: 7, ...permission })
expect(remote.session.follow).not.toHaveBeenCalled()
expect(manager.getListSnapshot().items[0]).toMatchObject({ sessionId: S2, parentSessionId: S1 })
expect(manager.getListSnapshot().items[0]).toMatchObject({ sessionId: S2 })
expect(manager.getListSnapshot().items[0]).not.toHaveProperty('parentSessionId')
})
it('reconciles a fork child published before workspace attachment fails', async ({ mock, remote }) => {
@@ -1273,13 +1274,12 @@ describe('remaining branches', () => {
expect(result).toMatchObject({ ok: false, error: { code: 'session/workspace-attach-failed' } })
expect(manager.getListSnapshot().items).toEqual([expect.objectContaining({
sessionId: S2,
parentSessionId: S1,
blank: true,
})])
manager.handleSessionAdded(summary(S2, { blank: true, parentSessionId: S1 }))
manager.handleSessionAdded(summary(S2, { blank: true }))
expect(manager.getListSnapshot().items[0]?.blank).toBe(true)
manager.handleSessionAdded(summary(S2, { blank: false, parentSessionId: S1 }))
manager.handleSessionAdded(summary(S2, { blank: false }))
expect(manager.getListSnapshot().items[0]?.blank).toBe(false)
})
@@ -328,7 +328,7 @@ describe('sessions.fork', () => {
},
)
it('cuts exactly at a completed turn and records lineage and cwd', async () => {
it('cuts exactly at a completed turn and retains cwd without source lineage', async () => {
const ctx = await composed()
const source = await liveAgent(ctx, 'session-source', 2)
const response = await (await remote(ctx)).fork(request({ sessionId: source.id, atSeq: 2 }))
@@ -338,7 +338,7 @@ describe('sessions.fork', () => {
expect(child?.snapshotEvents().map(event => event.type)).toEqual([
'turn/start', 'user/message', 'turn/end', 'session/end-seed',
])
expect(child?.header.parentSession).toBe(source.id)
expect(child?.header.parentSession).toBeUndefined()
expect(child?.header.cwd).toBe('/proj')
await ctx.fiber.dispose()
})
@@ -379,10 +379,10 @@ describe('sessions.fork', () => {
if (!response.ok) return
expect(attachSession).toHaveBeenCalledWith(response.value.sessionId)
expect(ctx.sessions.get(response.value.sessionId)?.header).toMatchObject({
parentSession: grandchild.id,
cwd: '/proj',
})
expect(ctx.sessions.get(response.value.sessionId)?.header.origin).toBeUndefined()
expect(ctx.sessions.get(response.value.sessionId)?.header.parentSession).toBeUndefined()
await ctx.fiber.dispose()
})
@@ -435,10 +435,10 @@ describe('sessions.fork', () => {
expect(resume).not.toHaveBeenCalled()
expect(ctx.agents.get(sourceId)).toBeUndefined()
expect(ctx.sessions.get(response.value.sessionId)?.header).toMatchObject({
parentSession: sourceId,
cwd: '/proj',
})
expect(ctx.sessions.get(response.value.sessionId)?.header.origin).toBeUndefined()
expect(ctx.sessions.get(response.value.sessionId)?.header.parentSession).toBeUndefined()
await ctx.fiber.dispose()
})
@@ -1002,10 +1002,10 @@ describe('fork', () => {
expect(b.svc.binding(sid('child'))).toBeUndefined()
expect(b.svc.retainInfo(sid('child')).getSnapshot().referenceCount).toBe(0)
await Promise.resolve()
expect(b.svc.list.getSnapshot().byId[sid('child')]).not.toHaveProperty('parentId')
expect(b.svc.list.getSnapshot().byId[sid('child')]).toMatchObject({
title: childTitle,
displayTitle: childTitle,
parentId: 'source',
})
})
+4 -4
View File
@@ -24,8 +24,8 @@
en: ca8217837ee9c698
zh: fa20daf27d4e09ef
/deepseek-ai-dsh-headless/use-this-package/choosing-the-session-identity:
en: 0ef0c533ef9aebea
zh: fcb267b61bd23437
en: 85120c2d6db2cac4
zh: bac532df6c84e755
/deepseek-ai-dsh-headless/use-this-package/supervising-implementation-tasks:
en: b10dee3026e8d999
zh: 63eda004e228a48a
@@ -66,8 +66,8 @@
en: 0b0f74b412c7c6d8
zh: 6e8f918d0c4bf342
/deepseek-ai-dsh-headless/known-limitations-and-deferred-work:
en: ff000db625d2d0db
zh: 7d08a158aade75f9
en: 94d8c7731c1435c3
zh: d0ddc9dd4e030b3f
/deepseek-ai-dsh-headless/known-limitations-and-deferred-work/dev-note:
en: e67f633dc6fe7773
zh: 3bb0c20c93f16f98
+2 -2
View File
@@ -72,7 +72,7 @@ The restored store uses [saved credentials before environment fallbacks](../../c
### Choosing the session identity
Every invocation defaults to a fresh `session-<uuid>` identity, which `--json` reports in its opening `session` event. Pass `--session-id <id>` to continue that conversation: the runner adopts the persisted Session with that id, and an id with no stored Session fails before the task runs rather than quietly opening an empty history. Adoption requires the composed `sessionPersistence` and `sessionQuery` services, so a profile that omits either fails loudly instead of returning an id whose history dies with the process. An Agent already live under the requested id in this process is refused: another owner may still drive it, so the runner cannot claim an exclusive run interval over it. The identity is opaque, so the exact string is used, whitespace included. The working directory is resolved through the mounted filesystem provider (`fs.resolve('.')` and `fs.processPath()`), or the process cwd when no filesystem service is mounted; new Sessions record that directory. Adoption compares the recorded cwd with the same provider-resolved directory and refuses a Session that is a subagent or forked session, that recorded no working directory, that runs under an agent preset this profile does not compose, or whose preset record is malformed — the check reads the preset the Session log currently records, so a Session that switched preset while blank is rejected too. A supervisor therefore cannot silently drive someone else's conversation under a different composition; any mismatch fails before the task runs.
Every invocation defaults to a fresh `session-<uuid>` identity, which `--json` reports in its opening `session` event. Pass `--session-id <id>` to continue that conversation: the runner adopts the persisted Session with that id, and an id with no stored Session fails before the task runs rather than quietly opening an empty history. Adoption requires the composed `sessionPersistence` and `sessionQuery` services, so a profile that omits either fails loudly instead of returning an id whose history dies with the process. An Agent already live under the requested id in this process is refused: another owner may still drive it, so the runner cannot claim an exclusive run interval over it. The identity is opaque, so the exact string is used, whitespace included. The working directory is resolved through the mounted filesystem provider (`fs.resolve('.')` and `fs.processPath()`), or the process cwd when no filesystem service is mounted; new Sessions record that directory. Adoption compares the recorded cwd with the same provider-resolved directory and refuses a Session that is a subagent session, that recorded no working directory, that runs under an agent preset this profile does not compose, or whose preset record is malformed — the check reads the preset the Session log currently records, so a Session that switched preset while blank is rejected too. A supervisor therefore cannot silently drive someone else's conversation under a different composition; any mismatch fails before the task runs.
On adoption, the runner records the current deployment route before submitting the task. An omitted effort preserves an explicit saved effort only for the same route. A step already prepared in this process keeps its captured route; subsequent steps read the shared Session selection.
@@ -186,7 +186,7 @@ These limits tell you when headless does not fit and what it needs from the `dsh
- **No pre-token heartbeat** — in default mode stderr stays silent until the provider emits a non-empty reasoning delta; a delayed first token exposes no earlier progress signal.
- **Reasoning enters stderr logs** — in default mode, redirection and supervisors may retain substantially more and potentially sensitive model output; route stderr to a controlled sink when needed.
- **Default stdout carries only the final answer** — a run without an assistant message prints an empty stdout line and exits 1; intermediate tool output is not printed unless you opt into `--json`.
- **Adoption is cwd-, ownership-, and preset-scoped** — `--session-id` refuses a Session recorded in another working directory, one that recorded no working directory, one that is a subagent or forked session, or one that runs under an agent preset this profile does not compose or whose preset record is malformed, and requires the composed Session query and persistence services; an identity already live in the process is refused too, because the runner cannot own an exclusive run interval over it.
- **Adoption is cwd-, ownership-, and preset-scoped** — `--session-id` refuses a Session recorded in another working directory, one that recorded no working directory, one that is a subagent session, or one that runs under an agent preset this profile does not compose or whose preset record is malformed, and requires the composed Session query and persistence services; an identity already live in the process is refused too, because the runner cannot own an exclusive run interval over it.
- **The event stream is a projection, not the log** — `--json` caps every string except the terminal `final` at 8 KiB and omits events the projection does not model, so it is not a lossless copy of the Session log.
<a id="dev-note"></a>
+2 -2
View File
@@ -72,7 +72,7 @@ agent 会完成该任务,把提供方的每个非空推理(reasoning)增
### 选择 Session 标识
每次调用默认使用全新的 `session-<uuid>` 标识,`--json` 会在开头的 `session` 事件里报告它。传入 `--session-id <id>` 延续这段对话:runner 沿用该 id 对应的持久化 Session,而该 id 没有持久化 Session 时会在任务运行前失败,而不是悄悄开出一段空历史。沿用要求已组合 `sessionPersistence` 与 `sessionQuery` 服务,因此缺少任一服务的 profile 会显式失败,而不会返回一个历史随进程消失的 id。本进程中已存在持有该 id 的存活 Agent 时会被拒绝:它的原 owner 可能仍在驱动它,runner 无法取得独占的运行区间。标识是不透明的,因此会原样使用调用方给出的字符串,包括空白字符。工作目录通过已挂载的文件系统提供方解析(`fs.resolve('.')` 与 `fs.processPath()`);未挂载文件系统服务时使用进程 cwd,新 Session 会记录该目录。沿用会将已记录 cwd 与同一提供方解析出的目录比较,并拒绝子 agent 或 fork 会话、未记录工作目录的会话、运行在本 profile 不组合的 agent preset 下的会话,以及 preset 记录畸形的会话——该检查读取 Session 日志当前记录的 preset,因此在空白期切换过 preset 的会话同样会被拒绝。因此监督进程无法在另一套组合下悄悄驱动他人的会话;任一不匹配都会在任务运行前失败。
每次调用默认使用全新的 `session-<uuid>` 标识,`--json` 会在开头的 `session` 事件里报告它。传入 `--session-id <id>` 延续这段对话:runner 沿用该 id 对应的持久化 Session,而该 id 没有持久化 Session 时会在任务运行前失败,而不是悄悄开出一段空历史。沿用要求已组合 `sessionPersistence` 与 `sessionQuery` 服务,因此缺少任一服务的 profile 会显式失败,而不会返回一个历史随进程消失的 id。本进程中已存在持有该 id 的存活 Agent 时会被拒绝:它的原 owner 可能仍在驱动它,runner 无法取得独占的运行区间。标识是不透明的,因此会原样使用调用方给出的字符串,包括空白字符。工作目录通过已挂载的文件系统提供方解析(`fs.resolve('.')` 与 `fs.processPath()`);未挂载文件系统服务时使用进程 cwd,新 Session 会记录该目录。沿用会将已记录 cwd 与同一提供方解析出的目录比较,并拒绝子 agent 会话、未记录工作目录的会话、运行在本 profile 不组合的 agent preset 下的会话,以及 preset 记录畸形的会话——该检查读取 Session 日志当前记录的 preset,因此在空白期切换过 preset 的会话同样会被拒绝。因此监督进程无法在另一套组合下悄悄驱动他人的会话;任一不匹配都会在任务运行前失败。
接管会话时,运行器会在提交任务前记录当前部署路由。未声明推理强度时,仅在路由相同的情况下保留已保存的显式强度。本进程中已准备的步骤保留捕获的路由,后续步骤读取共享的 Session 选择。
@@ -186,7 +186,7 @@ runner 不向请求前缀添加任何内容;它只是驱动组合出的配置
- **首个 token 前没有心跳**——默认模式下,提供方发出第一个非空推理增量前,stderr 保持静默;延迟首个 token 的提供方不会更早给出进度信号。
- **推理进入 stderr 日志**——默认模式下,重定向与监督进程可能保留显著更多且可能敏感的模型输出;需要时应把 stderr 路由到受控位置。
- **默认 stdout 只承载最终答案**——没有 assistant 消息的运行向 stdout 打印空行并以 1 退出;中间工具输出不会打印,除非显式启用 `--json`。
- **沿用受 cwd、归属与 preset 限制**——`--session-id` 会拒绝记录在其他工作目录、未记录工作目录、属于子 agent 或 fork 会话,或运行在本 profile 不组合的 agent preset 下的 Session、preset 记录畸形的 Session,并要求已组合的 Session 查询与持久化服务;本进程中已存活的身份同样会被拒绝,因为 runner 无法对它取得独占的运行区间。
- **沿用受 cwd、归属与 preset 限制**——`--session-id` 会拒绝记录在其他工作目录、未记录工作目录、属于子 agent 会话,或运行在本 profile 不组合的 agent preset 下的 Session、preset 记录畸形的 Session,并要求已组合的 Session 查询与持久化服务;本进程中已存活的身份同样会被拒绝,因为 runner 无法对它取得独占的运行区间。
- **事件流是投影而非日志**——`--json` 除终止 `final` 外把每个字符串与对象键限制在 8 KiB,并省略投影未建模的事件,因此它不是 Session 日志的无损副本。
<a id="dev-note"></a>
+2 -3
View File
@@ -180,7 +180,6 @@ function streamReasoning(
interface AdoptableHeader {
cwd?: string | undefined
origin?: 'subagent' | undefined
parentSession?: SessionId | undefined
agentPreset?: string | undefined
}
@@ -231,8 +230,8 @@ function assertAdoptable(header: AdoptableHeader, events: Iterable<SessionEvent>
`session "${sessionId}" runs under agent preset "${preset}", which the one-shot runner does not compose`,
)
}
if (header.origin === 'subagent' || header.parentSession !== undefined) {
throw new Error(`session "${sessionId}" is a subagent or forked session and cannot be driven directly`)
if (header.origin === 'subagent') {
throw new Error(`session "${sessionId}" is a subagent session and cannot be driven directly`)
}
if (header.cwd === undefined) {
throw new Error(`session "${sessionId}" recorded no working directory, so it cannot be adopted`)
+18 -14
View File
@@ -14,7 +14,7 @@ import type {
} from '@deepseek-ai/dsh-agent'
import AgentDefaultModelConfig from '@deepseek-ai/dsh-agent-default-model'
import { LlmAttemptId, ReasoningEffortId, ToolCallId, createAssistantMessage, createToolResultMessage, createUserMessage, type MessageId, type StreamChunk } from '@deepseek-ai/dsh-llm'
import SessionStore from '@deepseek-ai/dsh-session'
import SessionStore, { SessionLogOffset } from '@deepseek-ai/dsh-session'
import SessionProjectionRegistry from '@deepseek-ai/dsh-session-projection'
import SandboxPolicyService from '@deepseek-ai/dsh-sandbox-policy'
import ApprovalService, { setApprovalPolicy, type ApprovalPolicy } from '@deepseek-ai/dsh-user-approval'
@@ -987,7 +987,7 @@ describe('headless runner', () => {
})
const result = await test.run()
expect(result.code).toBe(1)
expect(result.err).toContain('is a subagent or forked session')
expect(result.err).toContain('is a subagent session')
await test.ctx.fiber.dispose()
})
@@ -1055,7 +1055,7 @@ describe('headless runner', () => {
})
const result = await test.run()
expect(result.code).toBe(1)
expect(result.err).toContain('is a subagent or forked session')
expect(result.err).toContain('is a subagent session')
await test.ctx.fiber.dispose()
})
@@ -1161,19 +1161,23 @@ describe('headless runner', () => {
await test.ctx.fiber.dispose()
})
it('rejects a persisted Session linked to a parent', async () => {
const test = await bench({ afterPrompt: () => {} }, {
it.each([false, true])('resumes an ordinary fork with historical parent metadata: %s', async (legacy) => {
const header = { cwd: process.cwd(), ...(legacy ? { parentSession: brandString<SessionId>('parent-1') } : {}) }
const test = await bench({
afterPrompt(session, message) { appendTurn(session, 1, message, 'fork resumed', true) },
}, {
sessionId: 'session-exact',
observe: () => Promise.resolve({
header: { cwd: process.cwd(), origin: 'user', parentSession: 'parent-1' },
events: [],
[Symbol.dispose]() {},
}),
observe: () => Promise.resolve({ header, events: [], [Symbol.dispose]() {} }),
})
const result = await test.run()
expect(result.code).toBe(1)
expect(result.err).toContain('is a subagent or forked session')
await test.ctx.fiber.dispose()
try {
const session = test.ctx.sessions.create(brandString<SessionId>('session-exact'), {
seed: [], inheritedEventCount: SessionLogOffset(0), meta: { ...header, isSeeded: true },
})
expect(await test.run()).toMatchObject({ code: 0, out: 'fork resumed\n', err: '' })
expect(session.header.parentSession).toBe(header.parentSession)
} finally {
await test.ctx.fiber.dispose()
}
})
it('propagates a Session query failure that is not a missing log', async () => {
@@ -18,8 +18,8 @@
en: 650a0b951c92626e
zh: 8b059c0678656a79
/deepseek-ai-dsh-client-ui-workspace/use-this-package/reordering-and-view-options:
en: 8673afc1d72ad077
zh: 9fbb83a4029c5d10
en: 55054408b8593c70
zh: 9fdf9861a48abba3
/deepseek-ai-dsh-client-ui-workspace/use-this-package/workspace-hierarchy:
en: a94394a5a9f70ed8
zh: 62ce596a95395ad8
+1 -1
View File
@@ -35,7 +35,7 @@ History rows without a stored title use the localized unnamed label (未命名 /
Pinned Sessions lead ordinary Sessions in both grouped and flat views. **Last updated** sorts each partition strictly by the latest user prompt or steer time, newest first; pin time does not affect it. **Manual** uses the relative positions in one complete Session sequence, including hidden archives. Returning to Last updated discards the manual layout, and entering Manual again freezes the then-current chronological order. The browser defaults to Last updated and remembers the selected mode across reloads.
Pinning moves the Session to the front of its complete saved sequence without changing the selected mode. It leads the pinned partition in Manual but need not lead it in Last updated. Unpinning leaves the saved position unchanged. Dragging either a pinned or ordinary row edits that same complete sequence and selects Manual; hidden archived members are retained. Missing pinned members prepend in pin-array order. New ordinary forks precede their sources in the complete sequence without inheriting pin membership; visible pins still lead ordinary rows. Other missing members append by recency with missing archives last. Supplementation stays in memory until a Session-order write records the complete result. Archive filtering alone changes neither saved positions nor account membership.
Pinning moves the Session to the front of its complete saved sequence without changing the selected mode. It leads the pinned partition in Manual but need not lead it in Last updated. Unpinning leaves the saved position unchanged. Dragging either a pinned or ordinary row edits that same complete sequence and selects Manual; hidden archived members are retained. Missing pinned members prepend in pin-array order. New ordinary forks follow the same supplementation rule as other Sessions and do not inherit pin membership. Missing ordinary members append by recency with missing archives last; visible pins still lead ordinary rows. Supplementation stays in memory until a Session-order write records the complete result. Archive filtering alone changes neither saved positions nor account membership.
The selected blank **New Session** retains its provisional first slot and cannot be dragged; after its first prompt it becomes an ordinary draggable row, retaining that position in Manual or following its current timestamp in Last updated. A collapsed-group drag uses the target Session identity and keeps the source visible. Session display orders for real Workspaces, Ungrouped, and the flat list are browser-local; Workspace group drag order remains Host-durable.
+1 -1
View File
@@ -35,7 +35,7 @@ kind: "package-reference"
分组和平铺视图都先显示置顶 Session,再显示普通 Session。**最近更新**在各分区内严格按最近一次用户提示词或 steering(中途引导)时间降序排列,置顶时间不影响它。**手动排序**使用同一条完整 Session 序列中的相对位置,包括隐藏的归档项。返回最近更新会丢弃手动布局,再次进入手动排序时冻结当时的时间顺序。浏览器默认采用最近更新,并在重新加载后记住所选模式。
置顶把 Session 移到完整保存序列的首位,但不切换所选模式。它在手动模式下排在置顶区最前,在最近更新模式下则不一定。取消置顶不改变保存的位置。拖拽置顶行或普通行都修改同一条完整序列并选择手动模式,隐藏的归档成员始终保留。缺失的置顶成员按置顶数组顺序补到头部。新增的普通 fork 在完整序列中插在来源之前,不继承置顶成员关系;可见置顶行仍排在普通行之前。其他缺失成员按最近更新时间追加,缺失归档项放在最后。补齐仅在内存中完成,直到一次 Session 顺序写入保存完整结果。单纯切换归档筛选既不改变保存的位置,也不改变成员关系。
置顶把 Session 移到完整保存序列的首位,但不切换所选模式。它在手动模式下排在置顶区最前,在最近更新模式下则不一定。取消置顶不改变保存的位置。拖拽置顶行或普通行都修改同一条完整序列并选择手动模式,隐藏的归档成员始终保留。缺失的置顶成员按置顶数组顺序补到头部。新增的普通 fork 使用与其他 Session 相同的补齐规则,不继承置顶成员关系。缺失的普通成员按最近更新时间追加,缺失归档项放在最后;可见置顶行仍排在普通行之前。补齐仅在内存中完成,直到一次 Session 顺序写入保存完整结果。单纯切换归档筛选既不改变保存的位置,也不改变成员关系。
当前选中的空白**新会话**保留临时首位且无法拖拽;首条提示词落地后,它成为可拖拽的普通行,在手动排序中保留该位置,在最近更新中按当前时间戳排列。折叠分组的拖拽使用目标 Session 身份,并保持来源行可见。真实 Workspace、Ungrouped 与单列表的 Session 显示顺序都保留在浏览器本地;Workspace 分组的拖拽顺序仍由 Host 持久化。
@@ -160,12 +160,12 @@ export function orderByRecency(
/**
* Reconcile a browser-local manual order with current account membership.
* New ordinary forks precede their sources without changing saved entries' relative order.
* Saved entries retain their relative order; new ordinary members follow them by recency.
* @param memberIds - authoritative account membership.
* @param savedOrder - previously saved browser-local order.
* @param summaries - current Session metadata; unknown new members wait for their summaries.
* @param rowState - global pin and archive membership; only account members can supplement the order.
* @returns saved relative positions plus missing members ordered by pin, fork source, recency, and archive status.
* @returns saved relative positions plus missing members ordered by pin, recency, and archive status.
*/
export function reconcileManualOrder(
memberIds: readonly SessionId[],
@@ -196,18 +196,7 @@ export function reconcileManualOrder(
if (archived.has(id)) archives.push(id)
else ordinary.push(id)
}
const result = [...pins, ...ordered, ...ordinary, ...archives]
const pending = new Set(ordinary)
const placeFork = (id: SessionId): void => {
if (!pending.delete(id)) return
const parentId = summaries[id]?.parentId
if (parentId === undefined || parentId === id || !result.includes(parentId)) return
placeFork(parentId)
result.splice(result.indexOf(id), 1)
result.splice(result.indexOf(parentId), 0, id)
}
for (const id of [...ordinary].reverse()) placeFork(id)
return result
return [...pins, ...ordered, ...ordinary, ...archives]
}
/**
@@ -184,26 +184,26 @@ describe('Session ordering', () => {
expect(saved).toEqual(['saved-archive', 'saved-plain', 'saved-pin'])
})
it('inserts new forks before their saved source while preserving saved positions', () => {
it('appends new forks by recency while preserving saved positions', () => {
const sessions = list(
summary('source', 1), summary('other', 2),
{ ...summary('older-fork', 3), parentId: sid('source') },
{ ...summary('newer-fork', 4), parentId: sid('source') },
)
const order = reconcileManualOrder(sessions.ids, ['other', 'source'], sessions.byId)
expect(order).toEqual(['other', 'older-fork', 'newer-fork', 'source'])
expect(order).toEqual(['other', 'source', 'newer-fork', 'older-fork'])
expect(reconcileManualOrder(sessions.ids, ['source', 'other', 'older-fork', 'newer-fork'], sessions.byId))
.toEqual(['source', 'other', 'older-fork', 'newer-fork'])
})
it('places nested new forks before their parents even when catalog recency differs', () => {
it('orders unsaved nested forks by recency regardless of historical sources', () => {
const sessions = list(
summary('source', 1), summary('other', 2),
{ ...summary('parent', 4), parentId: sid('source') },
{ ...summary('child', 3), parentId: sid('parent') },
)
expect(reconcileManualOrder(sessions.ids, ['source', 'other'], sessions.byId))
.toEqual(['child', 'parent', 'source', 'other'])
.toEqual(['source', 'other', 'parent', 'child'])
})
it('appends forks with absent or self-referencing parents without duplicating rows', () => {
@@ -229,7 +229,7 @@ describe('Session ordering', () => {
sessions, mode === 'workspace' ? [workspace('alpha', order)] : [], state, noAttention,
view([mode === 'workspace' ? 'alpha' : UNGROUPED_KEY], order),
)[0]!.sessions
expect(rows.map(row => row.id)).toEqual(['source', 'other-pin', 'fork', 'ordinary'])
expect(rows.map(row => row.id)).toEqual(['source', 'other-pin', 'ordinary', 'fork'])
})
it('keeps archive filtering out of complete flat membership', () => {
+16 -2
View File
@@ -3,17 +3,31 @@ import { randomUUID } from 'node:crypto'
import { setImmediate } from 'node:timers/promises'
export const name = 'serial-created-fixture'
export const inject = ['agents']
export const inject = ['agents', 'sessions']
/** Install ordered creation listeners whose context must precede the first turn. */
export function apply(ctx) {
const ready = new WeakSet()
ctx.on('agent/created', async ({ agent }) => {
await setImmediate()
let forkSummary = ''
if (agent.session.header.origin !== 'subagent') {
const fork = ctx.sessions.fork(agent.session)
const nested = ctx.sessions.fork(fork)
for (const independent of [fork, nested]) {
if (independent.header.parentSession !== undefined || independent.header.origin !== undefined
|| !independent.header.isSeeded) throw new Error('ordinary fork retained a creator relationship')
}
ctx.sessions.create(undefined, {
seed: agent.session.snapshotEvents(), inheritedEventCount: agent.session.seq,
meta: { parentSession: agent.id, isSeeded: true },
})
forkSummary = ' Ordinary and nested forks are independent; historical fork metadata remains readable.'
}
agent.inject({
id: randomUUID(),
role: 'user',
content: [{ type: 'text', text: 'Serial agent creation completed.' }],
content: [{ type: 'text', text: 'Serial agent creation completed.' + forkSummary }],
source: { kind: `plugin:${name}` },
})
ready.add(agent)
+2 -2
View File
@@ -18,8 +18,8 @@
en: 0882d4056c45aa75
zh: fcee78e9845b78b3
/deepseek-ai-dsh-session/use-this-package/create-and-inspect-sessions:
en: 05dac2b797457bab
zh: 9dbbcfcb9ea7d2d2
en: 971e583b3d6c1af8
zh: c7da934ecb8f1e87
/deepseek-ai-dsh-session/use-this-package/append-and-derive:
en: c9ad40c8a8f2cd0b
zh: 0b76ae73f39bbb18
+1 -1
View File
@@ -29,7 +29,7 @@ Mount `dsh-session` wherever a session must exist. It creates and holds event-so
### Create and inspect sessions
`ctx.sessions.create()` builds a live session bound to the calling fiber; `get(id)` and `list()` find sessions, and `fork()` creates a child session from a stable prefix of a live one.
`ctx.sessions.create()` builds a live session bound to the calling fiber; `get(id)` and `list()` find sessions, and `fork()` creates an independent session from a stable prefix of a live one. It copies history, `cwd`, `isSeeded`, and the inherited event count without recording a source relationship. `parentSession` records a subagent’s direct creator; historical ordinary forks may retain their source there, so classification uses `origin`.
Independent `Session.create()` and `Session.fromRestore()` instances accept events and plugin records without sending `session/event`. A `SessionStore` takes ownership through `prepare()` or `enter()`; writes then require store membership and a completed synchronous `session/created` announcement. Creation listeners are read-only and see all existing history; entering an independent instance does not replay that history as `session/event`. Failed announcement or removal leaves writes disabled. Removal emits `session/disposed` only if `session/created` began, including a failed announcement; an entered but never announced instance emits neither notification.
+1 -1
View File
@@ -29,7 +29,7 @@ kind: "package-reference"
### 创建与检查会话
`ctx.sessions.create()` 构建绑定到调用方 fiber 的实时会话;`get(id)` 与 `list()` 查找会话,`fork()` 从实时会话的精确前缀创建子会话。
`ctx.sessions.create()` 构建绑定到调用方 fiber 的实时会话;`get(id)` 与 `list()` 查找会话,`fork()` 从实时会话的精确前缀创建独立会话。它复制历史、`cwd`、`isSeeded` 和继承事件数,不记录来源关系。`parentSession` 记录子代理的直接创建者;历史普通 fork 可能仍在此字段保留来源,因此分类使用 `origin`。
独立的 `Session.create()` 和 `Session.fromRestore()` 实例接受事件和插件记录,但不发送 `session/event`。`SessionStore` 通过 `prepare()` 或 `enter()` 接管实例;此后只有实例仍在 Store 中且同步 `session/created` 宣告已完成时才能写入。创建监听器只能读取,并能看到全部已有历史;独立实例进入 Store 时不会把已有历史重放为 `session/event`。宣告失败或移除后仍禁止写入。只有开始过 `session/created` 宣告的实例在移除时发出 `session/disposed`,宣告失败也不例外;进入 Store 但从未宣告的实例不发出这两个通知。
+1 -2
View File
@@ -1385,7 +1385,7 @@ export class SessionStore extends Service {
}
/**
* Create a live child session from an exact prefix of a live source.
* Create an independent live session from an exact prefix of a live source.
* `boundary` is an inclusive source event seq; omitted means the source's
* current last event. An open tail receives synthetic tool results and
* step/turn closers with the forked cause. Closed steps and turns remain
@@ -1414,7 +1414,6 @@ export class SessionStore extends Service {
inheritedEventCount: SessionLogOffset(resolved === undefined ? 0 : resolved + 1),
meta: {
...liveSource.header.cwd !== undefined ? { cwd: liveSource.header.cwd } : {},
parentSession: liveSource.id,
isSeeded: true,
},
})
+5 -1
View File
@@ -104,7 +104,11 @@ export interface SessionHeader {
readonly createdAt: number
/** Absolute working directory the session was created in (if any). */
readonly cwd?: string
/** The session this one was forked from (seed lineage), if any. */
/**
* Direct creator of a subagent Session. Ordinary forks omit this field;
* historical ordinary forks may retain their source id here. Presence alone
* does not classify a Session as a subagent; use `origin` for that distinction.
*/
readonly parentSession?: SessionId
/**
* Whether this Session contains a fork-inherited event prefix. The exact prefix
+3 -3
View File
@@ -59,17 +59,17 @@ function inherited(session: Session): readonly SessionEvent[] {
}
describe('SessionStore.fork', () => {
it('forks an empty live session as an empty child with lineage metadata', async () => {
it('forks an empty live session as an independent empty seeded session', async () => {
const { ctx, sessions } = await setup()
const source = ctx.sessions.create(SessionId('empty-parent'), { meta: { cwd: '/workspace' } })
const child = sessions.fork(source, undefined, SessionId('empty-child'))
expect(inherited(child)).toEqual([])
expect(child.header).not.toHaveProperty('parentSession')
expect(child.header).toMatchObject({
id: SessionId('empty-child'),
cwd: '/workspace',
parentSession: SessionId('empty-parent'),
isSeeded: true,
})
expect(child.inheritedEventCount).toBe(0)
@@ -91,10 +91,10 @@ describe('SessionStore.fork', () => {
}).toThrow(TypeError)
expect(firstUserMessage(source.snapshotEvents()).data.content).toEqual([{ type: 'text', text: 'hello' }])
expect(firstUserMessage(child.snapshotEvents()).data.content).toEqual([{ type: 'text', text: 'hello' }])
expect(child.header).not.toHaveProperty('parentSession')
expect(child.header).toMatchObject({
id: SessionId('child'),
cwd: '/workspace',
parentSession: SessionId('parent'),
isSeeded: true,
})
expect(child.inheritedEventCount).toBe(source.seq)
@@ -2759,7 +2759,7 @@ export const SERVICE_API: readonly ServiceApiEntry[] = [
},
{
signature: 'fork(source: SessionForkSource, boundary?: SessionSeq, childSessionId?: SessionId): Session',
description: 'Create a live child session from an exact prefix of a live source. `boundary` is an inclusive source event seq; omitted means the source\'s current last event. An open tail receives synthetic tool results and step/turn closers with the forked cause. Closed steps and turns remain unchanged, including any failed tool calls already missing results. `inheritedEventCount` counts only copied source events, excluding these closers.',
description: 'Create an independent live session from an exact prefix of a live source. `boundary` is an inclusive source event seq; omitted means the source\'s current last event. An open tail receives synthetic tool results and step/turn closers with the forked cause. Closed steps and turns remain unchanged, including any failed tool calls already missing results. `inheritedEventCount` counts only copied source events, excluding these closers.',
parameters: [{ name: 'source', description: 'Live source session object or id.' }, { name: 'boundary', description: 'Inclusive source event seq to fork through; omitted means the source\'s current last event, and omitted on an empty source forks an empty child.' }, { name: 'childSessionId', description: 'Optional child session id; omitted delegates to `SessionStore`\'s id policy.' }],
returns: 'The created live child session.',
},
+1 -1
View File
@@ -241,7 +241,7 @@ describe('GoalService creation and replay', () => {
roundsStarted: 1,
activation: 'disarmed',
})
expect(child.session.header.parentSession).toBe(parent.session.id)
expect(child.session.header.parentSession).toBeUndefined()
expect(child.session.header.isSeeded).toBe(true)
expect(child.session.inheritedEventCount).toBe(parent.session.seq)
})
+2 -2
View File
@@ -39,8 +39,8 @@
en: eca39e7027d67d8f
zh: dd3f494276322857
/deepseek-ai-dsh-sdk-jsonrpc-server/understand-the-implementation/design-concept:
en: e83e01184c1a45ee
zh: d54ed126d31ee6f1
en: d1d0cd8ac2ff2f45
zh: 229c811e2bcf1acc
/deepseek-ai-dsh-sdk-jsonrpc-server/understand-the-implementation/source-map:
en: 783bd2b6628c0680
zh: ca5b6b730893ddec
+1 -1
View File
@@ -78,7 +78,7 @@ This section explains the design behind the serving plugin; the observable behav
### Design concept
The plugin is a thin presentation adapter: [`HarnessSdkJsonRpcServer`](src/server.ts) owns the protocol methods and notifications, while the transport and the named wire types come from `dsh-sdk-protocol`, shared with the client SDKs. It subscribes to session, agent, and subagent lifecycle events and forwards them as wire notifications; subagent completions are forwarded only when the service-snapshotted lifecycle `local` flag is true — provider names, child ids, and durable lineage never establish locality.
The plugin is a thin presentation adapter: [`HarnessSdkJsonRpcServer`](src/server.ts) owns the protocol methods and notifications, while the transport and the named wire types come from `dsh-sdk-protocol`, shared with the client SDKs. It subscribes to session, agent, and subagent lifecycle events and forwards them as wire notifications. `subagent.started` requires `origin: subagent` and a direct creator id; ordinary forks, including historical ones with a parent id, produce no such notification; subagent completions are forwarded only when the service-snapshotted lifecycle `local` flag is true — provider names, child ids, and durable lineage never establish locality.
### Source map
+1 -1
View File
@@ -78,7 +78,7 @@ Stdout 只承载 JSON-RPC 帧,客户端可以逐字节解析;诊断信息应
### 设计理念
本插件是轻量的展示适配器:[`HarnessSdkJsonRpcServer`](src/server.ts) 负责协议方法与通知,传输与具名协议类型来自 `dsh-sdk-protocol`,与客户端 SDK 共享。它订阅会话、agent 与 subagent 生命周期事件,并把它们作为协议通知转发;只有当服务在生命周期建立快照时记录的 `local` 标志为 true 时才转发 subagent 完成事件——提供方名称、子级 id 与持久化谱系均不能证明本地性。
本插件是轻量的展示适配器:[`HarnessSdkJsonRpcServer`](src/server.ts) 负责协议方法与通知,传输与具名协议类型来自 `dsh-sdk-protocol`,与客户端 SDK 共享。它订阅会话、agent 与 subagent 生命周期事件,并把它们作为协议通知转发;只有当服务在生命周期建立快照时记录的 `local` 标志为 true 时才转发 subagent 完成事件——提供方名称、子级 id 与持久化谱系均不能证明本地性。 `subagent.started` 要求 `origin: subagent` 和直接创建者 ID;普通 fork(包括保留父 ID 的历史会话)不产生此通知。
### 源码地图
+1 -1
View File
@@ -170,7 +170,7 @@ export class HarnessSdkJsonRpcServer {
}))
this.disposers.push(ctx.on('session/created', (session) => {
const parentSession = session.header.parentSession
if (parentSession === undefined) return
if (session.header.origin !== 'subagent' || parentSession === undefined) return
const payload: SubagentStartedNotification = {
parentSessionId: String(parentSession),
childSessionId: String(session.id),
+10 -4
View File
@@ -479,7 +479,7 @@ describe('HarnessSdkJsonRpcServer', () => {
await ctx.fiber.dispose()
})
it('notifies the host when a child session is created with parent lineage', async () => {
it('notifies the host only for subagent sessions with a direct creator', async () => {
const storageDir = await mkdtemp(join(tmpdir(), 'dsh-jsonrpc-subagent-'))
const ctx = await makeHarness(storageDir)
try {
@@ -490,16 +490,22 @@ describe('HarnessSdkJsonRpcServer', () => {
meta: { cwd: storageDir },
})
ctx.sessions.create(SessionId('child-session'), {
meta: { cwd: storageDir, parentSession: SessionId('main') },
meta: { cwd: storageDir, parentSession: SessionId('main'), origin: 'subagent' },
})
expect(transport.notifications).toContainEqual({
ctx.sessions.create(SessionId('legacy-fork'), {
meta: { cwd: storageDir, parentSession: SessionId('main') },
})
ctx.sessions.fork(SessionId('child-session'), undefined, SessionId('ordinary-fork'))
ctx.sessions.create(SessionId('unparented-subagent'), { meta: { origin: 'subagent' } })
expect(transport.notifications.filter(item => item.method === 'subagent.started')).toEqual([{
method: 'subagent.started',
params: {
parentSessionId: 'main',
childSessionId: 'child-session',
},
})
}])
await server.shutdown()
} finally {
@@ -39,8 +39,8 @@
en: 8543a15b3c24cd43
zh: 5eacb6ffd009d1bc
/deepseek-ai-dsh-session-format-v3-to-v4/v3-to-v4-specification/delivery-generations:
en: 1af75967fd8296c7
zh: 4efd2a3a3a288610
en: c362f394977bdeb3
zh: f8d35950bc2e1efa
/deepseek-ai-dsh-session-format-v3-to-v4/v3-to-v4-specification/source-audit-and-refusal:
en: bfc56afb05348d19
zh: 21afbb4ced91e87f
@@ -51,8 +51,8 @@
en: 610f35b8c44538a2
zh: 17e5c07f09783106
/deepseek-ai-dsh-session-format-v3-to-v4/native-v4-admission/lifecycle-and-reference-relationships:
en: bae15764867cf91c
zh: 09a56ed1a8c9622a
en: 7dd4a236075233c7
zh: 988e67acdd32d2ba
/deepseek-ai-dsh-session-format-v3-to-v4/native-v4-admission/developer-changes-and-deferred-schemas:
en: 471f0e087806057a
zh: 76b2ee1f58118d71
@@ -174,7 +174,7 @@ For a seeded Session, the last `session/end-seed` carrying `inherited: true` ide
| V3 source marker claiming generation 4 | Refuse: advancing the header must not activate a target-generation watermark. |
| V3 source marker for generation 3 | Require a nonempty Session id and nonnegative safe-integer `throughSeq` before the marker; a foreign id is allowed only before the inherited cut with `parentSession`. |
| Other source generations, including values above 4 | Retain their event type and payload coordinates unchanged; they remain inactive in V4. |
| Native V4 marker for generation 4 | Apply the same earlier-coordinate and Session-ownership checks using V4 as current. |
| Native V4 marker for generation 4 | Require an earlier `throughSeq` and nonempty Session id; a foreign id is allowed only before the validated inherited cut, without requiring `parentSession`. |
| Native V4 historical marker, including generation 3 | Retain recorded coordinates and identity; it is not a V4 acceptance watermark. |
No delivery payload or event type is rewritten. Higher-version migrations own any future activation checks; this edge checks only promotion to V4. The marker’s envelope sequence follows insertion remapping; source-generation ownership is checked against the original V3 sequence and inherited cut.
@@ -246,7 +246,7 @@ Current common admission does not validate each user/tool/developer content bloc
| `compaction/prune` | Its span names exact current-surface nodes and excludes the protected head; it does not require a compaction transaction or its owner fields. |
| Compact checkpoint replacement | Its `compact-checkpoint` source identifies the active compaction. |
| Native `subagent/catalog` | Validates own version-0/version-1/version-2 payloads after the inherited cut. Each child id must be unique. Native reads neither collect child logs nor compare their physical facts; inherited entries do not establish own membership. |
| Inherited cut and delivery | Apply the marker, coordinate, and generation-ownership rules stated above. |
| Inherited cut and delivery | Apply the native V4 marker, coordinate, and generation-ownership rules above. |
These checks are generation-owned in [relationships.ts](src/relationships.ts). Full common message/envelope acceptance and plugin-owned message projections additionally use the installed Session; the exported V4 restorer alone is not a replacement for complete catalog restoration.
@@ -174,7 +174,7 @@ Stage 只把最终继承截点之后的父目录记录作为候选。每个 inhe
| V3 源 marker 声明 generation 4 | 拒绝:提升 header 不得激活目标代际的 watermark。 |
| generation 3 的 V3 源 marker | 要求非空 Session id 和早于 marker 的非负安全整数 `throughSeq`;只有在继承截点之前且带 `parentSession` 时才允许其他 Session id。 |
| 其他源代际,包括高于 4 的值 | 原样保留事件类型及 payload 坐标;它们在 V4 中仍未激活。 |
| generation 4 的原生 V4 marker | 以 V4 为当前代际,应用同样的较早坐标和 Session 归属检查。 |
| generation 4 的原生 V4 marker | 要求更早的 `throughSeq` 和非空 Session id;外来 id 仅在已验证的继承截点之前被接受,不要求 `parentSession`。 |
| 原生 V4 中的历史 marker,包括 generation 3 | 保留记录的坐标与身份;它不是 V4 接纳 watermark。 |
不改写投递 payload 或事件类型。未来的激活检查归对应的更高版本迁移所有,本边只检查向 V4 的提升。标记的信封序号随插入重映射;源代际归属仍按原 V3 序号和继承截点校验。
@@ -246,7 +246,7 @@ System image 接纳要求非空 attachment id、PNG/JPEG/WebP/GIF MIME 类
| `compaction/prune` | 其区间引用精确的当前表面节点且排除 protected head;它不要求存在 compaction 事务或其所有者字段。 |
| Compact checkpoint 替换 | 其 `compact-checkpoint` 来源标识活动 compaction。 |
| 原生 `subagent/catalog` | 校验继承截点之后的自身 version-0/version-1/version-2 载荷。每个子 id 必须唯一。原生读取不收集子日志,也不比较其物理事实;继承条目不建立自身成员关系。 |
| 继承截点与 delivery | 应用上文的 marker、坐标及代际归属规则。 |
| 继承截点与投递 | 应用上文的原生 V4 标记、坐标及代际归属规则。 |
这些检查由 [relationships.ts](src/relationships.ts) 按代际拥有。完整的通用消息/信封接纳与插件拥有的消息投影还使用已安装 Session;单独的导出 V4 恢复器不能替代完整 catalog 恢复。
@@ -115,7 +115,7 @@ export function assertReleasedV4Relationships(artifact: SessionFormatArtifact, k
assertV4MessageSources(event)
const deliveryId = validateDeliveryAccepted(event, 4)
if (deliveryId !== undefined
&& !(artifact.header.parentSession !== undefined && event.seq < artifact.inheritedEventCount)
&& event.seq >= artifact.inheritedEventCount
&& deliveryId !== artifact.header.id) {
throw new SessionFormatError('current-generation delivery marker names the wrong Session')
}
@@ -0,0 +1,86 @@
/** Fork history retains delivery ownership without requiring a source relationship. */
import { Context } from '@deepseek-ai/cordis'
import SessionStore, { Session, SessionId, SessionSeq } from '@deepseek-ai/dsh-session'
import * as JsonlSessionPersistence from '@deepseek-ai/dsh-session-persistence-jsonl'
import { mkdtemp, readFile, rm } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { describe, expect, it, onTestFinished } from 'vitest'
import { generationLogPath } from '../src/format.ts'
async function fixture(compression: 'none' | 'zstd') {
const root = await mkdtemp(join(tmpdir(), 'dsh-fork-delivery-'))
const ctx = new Context()
onTestFinished(async () => {
await ctx.fiber.dispose()
await rm(root, { recursive: true, force: true })
})
await ctx.plugin(SessionStore)
await ctx.plugin(JsonlSessionPersistence, { root, compression })
async function persist(session: Session) {
const writer = await ctx.sessionPersistence.create(session.header, { inheritedEventCount: session.inheritedEventCount })
try { await writer.append(session.snapshotEvents()) } finally { await writer.close() }
return generationLogPath(root, undefined, session.id, 4, compression)
}
return { ctx, persist }
}
function delivered(session: Session): void {
const start = session.append('turn/start', { turn: 1 })
session.append('turn/end', { turn: 1, reason: { kind: 'completed' } })
session.append('session-log-deepseek/delivery-accepted', {
sessionId: session.id, sessionFormatVersion: 4, throughSeq: start.seq,
})
}
describe.each(['none', 'zstd'] as const)('fork delivery persistence (%s)', (compression) => {
it.each(['ordinary', 'nested', 'subagent', 'legacy'] as const)('restores %s fork history through read and write access', async (kind) => {
const { ctx, persist } = await fixture(compression)
const source = ctx.sessions.create(SessionId('source'))
delivered(source)
const ordinary = ctx.sessions.fork(source, undefined, SessionId('ordinary'))
const child = kind === 'ordinary' ? ordinary : kind === 'nested'
? ctx.sessions.fork(ordinary, undefined, SessionId('nested'))
: ctx.sessions.create(SessionId(kind), {
seed: source.snapshotEvents(), inheritedEventCount: source.seq,
meta: { parentSession: source.id, isSeeded: true, ...(kind === 'subagent' ? { origin: 'subagent' } : {}) },
})
const path = await persist(child)
const bytes = await readFile(path)
for (const access of ['read', 'write'] as const) {
try {
const handle = await ctx.sessionPersistence.open(child.id, access)
try {
const stored = await handle.read()
const restored = Session.fromRestore(child.id, stored.events, handle.header, handle.inheritedEventCount, stored.eventState)
expect(restored.snapshotEvents()).toEqual(child.snapshotEvents())
expect(restored.inheritedEventCount).toBe(child.inheritedEventCount)
expect(restored.header.parentSession).toBe(kind === 'subagent' || kind === 'legacy' ? source.id : undefined)
} finally { await handle.close() }
} finally {
expect(await readFile(path)).toEqual(bytes)
}
}
})
it.each(['foreign-own', 'invalid-through', 'inherited-through'] as const)('refuses %s delivery without modifying the file', async (damage) => {
const { ctx, persist } = await fixture(compression)
const source = ctx.sessions.create(SessionId('source'))
delivered(source)
const invalidTarget = damage === 'inherited-through' ? source : ctx.sessions.fork(source, undefined, SessionId('child'))
invalidTarget.append('session-log-deepseek/delivery-accepted', {
sessionId: damage === 'foreign-own' ? source.id : invalidTarget.id,
sessionFormatVersion: 4,
throughSeq: damage === 'foreign-own' ? SessionSeq(0) : SessionSeq(invalidTarget.seq),
})
const child = damage === 'inherited-through' ? ctx.sessions.fork(source) : invalidTarget
const path = await persist(child)
const bytes = await readFile(path)
for (const access of ['read', 'write'] as const) {
await expect(ctx.sessionPersistence.open(child.id, access)).rejects.toThrow(
damage === 'foreign-own' ? 'wrong Session' : 'throughSeq must precede',
)
expect(await readFile(path)).toEqual(bytes)
}
})
})
@@ -24,8 +24,8 @@
en: f72239b38a91783b
zh: 07e22375c09906a6
/deepseek-ai-dsh-session-title/use-this-package/adding-a-provider:
en: cda41e431e48f914
zh: c6347ef731b0036e
en: 1a5891de185c8378
zh: abec81a6da07706d
/deepseek-ai-dsh-session-title/use-this-package/reading-titles:
en: 34148c23c20ee6f4
zh: b0d10677722f3f63
+1 -1
View File
@@ -54,7 +54,7 @@ The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-a
### Adding a provider
One optional asynchronous provider may be registered through `ctx.sessionTitle.register(provider)`; a second registration throws until the first provider's disposal starts, so a replacement can activate while the previous provider drains, and the previous provider's late results never commit. The shipped model-backed providers are [first-prompt](../session-title-first-prompt-llm/README.md) and [all-prompts](../../experimental/session-title-all-prompts-llm/README.md), both using the shared [LLM execution module](../session-title-llm/README.md). Immediately before each call the service captures the latest accepted title snapshot, including the fallback it just ensured, and passes it as `request.currentTitle`; the provider owns whether and how to use it. A provider starts only after a marked loop-built request's exact route matches the logged `request/header`, and a newer revision supersedes and aborts older work. For unchanged routes, an active marked request starts pending automatic generation without a new header event; accepted human messages may follow the current `step/start`.
One optional asynchronous provider may be registered through `ctx.sessionTitle.register(provider)`; a second registration throws until the first provider's disposal starts, so a replacement can activate while the previous provider drains, and the previous provider's late results never commit. The shipped model-backed providers are [first-prompt](../session-title-first-prompt-llm/README.md) and [all-prompts](../../experimental/session-title-all-prompts-llm/README.md), both using the shared [LLM execution module](../session-title-llm/README.md). Immediately before each call the service captures the latest accepted title snapshot, including the fallback it just ensured, and passes it as `request.currentTitle`; the provider owns whether and how to use it. A provider starts only after a marked loop-built request's exact route matches the logged `request/header`, and a newer revision supersedes and aborts older work. For unchanged routes, an active marked request starts pending automatic generation without a new header event; accepted human messages may follow the current `step/start`. First-prompt generation excludes seeded Sessions and subagent-origin Sessions; an independent fork does not become eligible when its source relationship is absent.
### Reading titles
+1 -1
View File
@@ -54,7 +54,7 @@ kind: "package-reference"
### 添加提供方
可选异步提供方可通过 `ctx.sessionTitle.register(provider)` 注册一个;在前一个提供方开始释放之前,第二次注册会立即抛出。因此替代提供方可以在前一个提供方排空期间激活,前一个提供方迟到的结果不会提交。随附的模型支持提供方是[首消息](../session-title-first-prompt-llm/README.zh.md)与[全消息](../../experimental/session-title-all-prompts-llm/README.zh.md),两者都使用共享的 [LLM(大语言模型)执行模块](../session-title-llm/README.zh.md)。每次调用前,服务会捕获最新已接纳标题快照(包括它刚刚确保的回退),并作为 `request.currentTitle` 传入;提供方自行决定是否以及如何使用。提供方只有在带标记、由循环构建的请求的确切路由与已记录 `request/header` 匹配时才启动,较新的修订会取代并中止旧工作。路由不变时,活跃步骤中带标记的请求会启动待处理的自动生成,无需新的 header 事件;已接受的人类消息可以位于当前 `step/start` 之后。
可选异步提供方可通过 `ctx.sessionTitle.register(provider)` 注册一个;在前一个提供方开始释放之前,第二次注册会立即抛出。因此替代提供方可以在前一个提供方排空期间激活,前一个提供方迟到的结果不会提交。随附的模型支持提供方是[首消息](../session-title-first-prompt-llm/README.zh.md)与[全消息](../../experimental/session-title-all-prompts-llm/README.zh.md),两者都使用共享的 [LLM(大语言模型)执行模块](../session-title-llm/README.zh.md)。每次调用前,服务会捕获最新已接纳标题快照(包括它刚刚确保的回退),并作为 `request.currentTitle` 传入;提供方自行决定是否以及如何使用。提供方只有在带标记、由循环构建的请求的确切路由与已记录 `request/header` 匹配时才启动,较新的修订会取代并中止旧工作。路由不变时,活跃步骤中带标记的请求会启动待处理的自动生成,无需新的 header 事件;已接受的人类消息可以位于当前 `step/start` 之后。 首提示词生成排除带继承前缀及 subagent 来源的 Session;独立 fork 不会因缺少来源关系而变为符合条件。
### 读取标题
+1 -1
View File
@@ -521,7 +521,7 @@ export class SessionTitleService extends Service {
if (registration !== undefined && !registration.closing) {
const count = this.titleInputOf(session).count
const shouldSchedule = registration.provider.automatic === 'all-prompts'
|| (session.header.parentSession === undefined && count === 1 && this.get(session) === undefined)
|| (!session.header.isSeeded && session.header.origin !== 'subagent' && count === 1 && this.get(session) === undefined)
if (shouldSchedule) {
const state = this.stateFor(session)
const revision = this.supersede(state, 'newer user message superseded title generation')
@@ -52,6 +52,26 @@ function appendRoute(session: ReturnType<Context['sessions']['create']>, reason:
}
describe('SessionTitleService Provider lifecycle', () => {
it.each(['fork', 'subagent'] as const)('does not schedule first-prompt generation for an empty %s', async (kind) => {
const ctx = new Context()
onTestFinished(() => ctx.fiber.dispose())
await ctx.plugin(SessionStore)
await ctx.plugin(SessionProjectionRegistry)
await ctx.plugin(AgentRegistry)
await ctx.plugin(SessionTitleService, CONFIG)
const generate = vi.fn(async () => ({ title: 'Unexpected', messageSeqs: [] }))
ctx.sessionTitle.register({ id: SessionTitleProviderId('first'), automatic: 'first-prompt', generate })
const source = ctx.sessions.create(SessionId('empty-source'))
const child = kind === 'fork' ? ctx.sessions.fork(source) : ctx.sessions.create(SessionId('child'), {
meta: { origin: 'subagent', parentSession: source.id },
})
expect(child.header.parentSession).toBe(kind === 'fork' ? undefined : source.id)
appendHumanPrompt(child, 'First own prompt')
appendRoute(child)
await settle()
expect(generate).not.toHaveBeenCalled()
})
it('inherits title events across forks, skips first-prompt retitling, and lets all-messages update later', async () => {
const ctx = new Context()
await ctx.plugin(SessionStore)
@@ -98,7 +98,7 @@
"content": [
{
"type": "text",
"text": "Serial agent creation completed."
"text": "Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."
}
],
"source": {
@@ -1156,7 +1156,7 @@
"content": [
{
"type": "text",
"text": "Serial agent creation completed."
"text": "Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."
}
],
"source": {
@@ -2,14 +2,14 @@
{"type":"permission/preset","data":{"preset":"danger-full-access"}}
{"type":"sandbox/mode","data":{"mode":"danger-full-access"}}
{"type":"approval/policy","data":{"policy":"never"}}
{"type":"agent/inbox/spliced","data":{"target":"next-step","start":0,"inserted":[{"id":"{{messageId}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed."}],"source":{"kind":"plugin:serial-created-fixture"}}]}}
{"type":"agent/inbox/spliced","data":{"target":"next-step","start":0,"inserted":[{"id":"{{messageId}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."}],"source":{"kind":"plugin:serial-created-fixture"}}]}}
{"type":"agent/inbox/spliced","data":{"target":"next-turn","start":0,"inserted":[{"content":[{"type":"text","text":"Run the advanced packaged-runtime snapshot scenario."}],"source":{"kind":"user"},"role":"user","id":"{{messageId}}"}]}}
{"type":"turn/start","data":{"turn":1}}
{"type":"agent/inbox/spliced","data":{"target":"next-step","start":0,"removedCount":1,"inserted":[]}}
{"type":"agent/inbox/spliced","data":{"target":"next-turn","start":0,"removedCount":1,"inserted":[]}}
{"type":"step/start","data":{"turn":1,"step":1}}
{"type":"system/message","data":{"turn":1,"step":1,"message":{"role":"system","content":[{"type":"text","text":"{{system}}"}],"source":{"kind":"system-prompt"},"id":"{{messageId}}"}},"surfaceOp":"append"}
{"type":"user/message","data":{"id":"{{messageId}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed."}],"source":{"kind":"plugin:serial-created-fixture"}},"surfaceOp":"append"}
{"type":"user/message","data":{"id":"{{messageId}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."}],"source":{"kind":"plugin:serial-created-fixture"}},"surfaceOp":"append"}
{"type":"user/message","data":{"content":[{"type":"text","text":"Run the advanced packaged-runtime snapshot scenario."}],"source":{"kind":"user"},"role":"user","id":"{{messageId}}"},"surfaceOp":"append"}
{"type":"user/message","data":{"content":[{"type":"text","text":"Current runtime context. This snapshot supersedes earlier runtime-context snapshots.\n\nCurrent working directory: \"{{cwd}}\".\n\nCurrent DSH file policy: danger-full-access. The DSH file sandbox does not restrict file modifications by available operations.\n\nApproval prompts are disabled in this session: actions that require approval are rejected automatically — do not request sandbox escalation (do not set `sandbox_permissions`)."}],"source":{"kind":"runtime-context","form":"snapshot","sections":[{"name":"working-directory:current","text":"Current working directory: \"{{cwd}}\"."},{"name":"sandbox:policy","text":"Current DSH file policy: danger-full-access. The DSH file sandbox does not restrict file modifications by available operations."},{"name":"approval:policy","text":"Approval prompts are disabled in this session: actions that require approval are rejected automatically — do not request sandbox escalation (do not set `sandbox_permissions`)."}]},"role":"user","id":"{{messageId}}"},"surfaceOp":"append"}
{"type":"user/message","data":{"id":"{{messageId}}","role":"user","content":[{"type":"image","attachment":{"attachmentId":"sha256:b1ff9c8ea3a780bad09b346c423d2d0e46815926879b18e841d928376a946640","mediaType":"image/png","width":1,"height":1,"bytes":69}}],"source":{"kind":"python-snapshot-image-offload"}},"surfaceOp":"append"}
@@ -98,7 +98,7 @@
"content": [
{
"type": "text",
"text": "Serial agent creation completed."
"text": "Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."
}
],
"source": {
@@ -1628,7 +1628,7 @@
"content": [
{
"type": "text",
"text": "Serial agent creation completed."
"text": "Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."
}
],
"source": {
@@ -2,14 +2,14 @@
{"type":"permission/preset","data":{"preset":"danger-full-access"}}
{"type":"sandbox/mode","data":{"mode":"danger-full-access"}}
{"type":"approval/policy","data":{"policy":"never"}}
{"type":"agent/inbox/spliced","data":{"target":"next-step","start":0,"inserted":[{"id":"{{messageId}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed."}],"source":{"kind":"plugin:serial-created-fixture"}}]}}
{"type":"agent/inbox/spliced","data":{"target":"next-step","start":0,"inserted":[{"id":"{{messageId}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."}],"source":{"kind":"plugin:serial-created-fixture"}}]}}
{"type":"agent/inbox/spliced","data":{"target":"next-turn","start":0,"inserted":[{"content":[{"type":"text","text":"Run the advanced packaged-runtime snapshot scenario."}],"source":{"kind":"user"},"role":"user","id":"{{messageId}}"}]}}
{"type":"turn/start","data":{"turn":1}}
{"type":"agent/inbox/spliced","data":{"target":"next-step","start":0,"removedCount":1,"inserted":[]}}
{"type":"agent/inbox/spliced","data":{"target":"next-turn","start":0,"removedCount":1,"inserted":[]}}
{"type":"step/start","data":{"turn":1,"step":1}}
{"type":"system/message","data":{"turn":1,"step":1,"message":{"role":"system","content":[{"type":"text","text":"{{system}}"}],"source":{"kind":"system-prompt"},"id":"{{messageId}}"}},"surfaceOp":"append"}
{"type":"user/message","data":{"id":"{{messageId}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed."}],"source":{"kind":"plugin:serial-created-fixture"}},"surfaceOp":"append"}
{"type":"user/message","data":{"id":"{{messageId}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."}],"source":{"kind":"plugin:serial-created-fixture"}},"surfaceOp":"append"}
{"type":"user/message","data":{"content":[{"type":"text","text":"Run the advanced packaged-runtime snapshot scenario."}],"source":{"kind":"user"},"role":"user","id":"{{messageId}}"},"surfaceOp":"append"}
{"type":"user/message","data":{"content":[{"type":"text","text":"Current runtime context. This snapshot supersedes earlier runtime-context snapshots.\n\nCurrent working directory: \"{{cwd}}\".\n\nCurrent DSH file policy: danger-full-access. The DSH file sandbox does not restrict file modifications by available operations.\n\nApproval prompts are disabled in this session: actions that require approval are rejected automatically — do not request sandbox escalation (do not set `sandbox_permissions`)."}],"source":{"kind":"runtime-context","form":"snapshot","sections":[{"name":"working-directory:current","text":"Current working directory: \"{{cwd}}\"."},{"name":"sandbox:policy","text":"Current DSH file policy: danger-full-access. The DSH file sandbox does not restrict file modifications by available operations."},{"name":"approval:policy","text":"Approval prompts are disabled in this session: actions that require approval are rejected automatically — do not request sandbox escalation (do not set `sandbox_permissions`)."}]},"role":"user","id":"{{messageId}}"},"surfaceOp":"append"}
{"type":"user/message","data":{"id":"{{messageId}}","role":"user","content":[{"type":"image","attachment":{"attachmentId":"sha256:b1ff9c8ea3a780bad09b346c423d2d0e46815926879b18e841d928376a946640","mediaType":"image/png","width":1,"height":1,"bytes":69}}],"source":{"kind":"python-snapshot-image-offload"}},"surfaceOp":"append"}
+3
View File
@@ -1295,6 +1295,9 @@ describe('TypeScript SDK snapshots over the jsonrpc runtime', () => {
for (const clause of assertions.runtimeContext.includes) expect(system).not.toContain(clause)
}
}
if (scenario.name === 'serial-created') {
expect(observedMethods.has('subagent.started')).toBe(false)
}
if (ordered.length > 1 && assertions.dshSdkChild === undefined) {
expect(observedMethods.has('subagent.started')).toBe(true)
expect(observedMethods.has('subagent.finished')).toBe(true)
@@ -2,14 +2,14 @@
{"type":"permission/preset","data":{"preset":"workspace-write"}}
{"type":"sandbox/mode","data":{"mode":"workspace-write"}}
{"type":"approval/policy","data":{"policy":"ask"}}
{"type":"agent/inbox/spliced","data":{"target":"next-step","start":0,"inserted":[{"id":"{{message:1}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed."}],"source":{"kind":"plugin:serial-created-fixture"}}]}}
{"type":"agent/inbox/spliced","data":{"target":"next-step","start":0,"inserted":[{"id":"{{message:1}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."}],"source":{"kind":"plugin:serial-created-fixture"}}]}}
{"type":"agent/inbox/spliced","data":{"target":"next-turn","start":0,"inserted":[{"content":[{"type":"text","text":"Reply with exactly: SDK snapshot OK"}],"source":{"kind":"user"},"role":"user","id":"{{message:2}}"}]}}
{"type":"turn/start","data":{"turn":1}}
{"type":"agent/inbox/spliced","data":{"target":"next-step","start":0,"removedCount":1,"inserted":[]}}
{"type":"agent/inbox/spliced","data":{"target":"next-turn","start":0,"removedCount":1,"inserted":[]}}
{"type":"step/start","data":{"turn":1,"step":1}}
{"type":"system/message","data":{"turn":1,"step":1,"message":{"role":"system","content":[{"type":"text","text":"{{system}}"}],"source":{"kind":"system-prompt"},"id":"{{message:3}}"}},"surfaceOp":"append"}
{"type":"user/message","data":{"id":"{{message:1}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed."}],"source":{"kind":"plugin:serial-created-fixture"}},"surfaceOp":"append"}
{"type":"user/message","data":{"id":"{{message:1}}","role":"user","content":[{"type":"text","text":"Serial agent creation completed. Ordinary and nested forks are independent; historical fork metadata remains readable."}],"source":{"kind":"plugin:serial-created-fixture"}},"surfaceOp":"append"}
{"type":"user/message","data":{"content":[{"type":"text","text":"Reply with exactly: SDK snapshot OK"}],"source":{"kind":"user"},"role":"user","id":"{{message:2}}"},"surfaceOp":"append"}
{"type":"user/message","data":{"content":[{"type":"text","text":"Current runtime context. This snapshot supersedes earlier runtime-context snapshots.\n\nCurrent working directory: \"{{cwd}}\".\n\nCurrent DSH file policy: workspace-write. Any available operation enforced by the DSH file sandbox may modify files under the session workspace: \"{{cwd}}\". Some platform temporary areas may also be writable.\n\nApproval prompts are enabled in this session: operations that require approval may ask through the configured answerers; without an available answerer, the request fails closed."}],"source":{"kind":"runtime-context","form":"snapshot","sections":[{"name":"working-directory:current","text":"Current working directory: \"{{cwd}}\"."},{"name":"sandbox:policy","text":"Current DSH file policy: workspace-write. Any available operation enforced by the DSH file sandbox may modify files under the session workspace: \"{{cwd}}\". Some platform temporary areas may also be writable."},{"name":"approval:policy","text":"Approval prompts are enabled in this session: operations that require approval may ask through the configured answerers; without an available answerer, the request fails closed."}]},"role":"user","id":"{{message:4}}"},"surfaceOp":"append"}
{"type":"request/header","data":{"header":{"config":{"provider":"deepseek-official","model":"deepseek-v4-flash"},"tools":"{{tools}}"},"reason":"initial"}}