@prettier-ai/dsh-client-ui-trajectory 0.1.2-alpha.1

package/lib/index.js

@@ -0,0 +1,6 @@
+//#region lib/types/index.js
+/** Host loader entry for the browser-only trajectory plugin. */
+/** Provides no host-side behavior. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@prettier-ai/dsh-client-ui-trajectory`.
+* @module @prettier-ai/dsh-client-ui-trajectory/invariant
+*/
+const PACKAGE_NAME = "@prettier-ai/dsh-client-ui-trajectory";
+/** Cordis companion plugin name. */
+const name = "client-ui-trajectory-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: a pure-consumer plugin — it emits no cordis events
+* and owns no mutable cross-plugin state; its view-slot registration is a
+* plain effect whose disposal the slot ledger's own specs and this
+* package's behavior specs observe directly.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/client/TrajectoryCell.d.ts

@@ -0,0 +1,13 @@
+import { formatElapsedSeconds, type TrajectoryCellProps } from './trajectory-record.ts';
+import type { TrajectoryTranslate } from './locales.ts';
+export { formatElapsedSeconds };
+export type { AssistantMetricDetail, TrajectoryCellKind, TrajectoryCellProps, } from './trajectory-record.ts';
+/**
+ * Render one trajectory step cell.
+ * @param props - index, kind, text, time, and optional Message metrics.
+ * @returns the cell element.
+ */
+export declare function TrajectoryCell({ t, index, kind, text, inputDetail: _inputDetail, promptDetail: _promptDetail, previousPromptDetail: _previousPromptDetail, outputDetail: _outputDetail, thinkingDetail: _thinkingDetail, sourceBlocks: _sourceBlocks, outputBlocks: _outputBlocks, schemaDetail: _schemaDetail, assistantMetrics: _assistantMetrics, result: _result, callId: _callId, isError: _isError, timeSeconds, startedAt: _startedAt, input, output, think, selected, className, ...rest }: TrajectoryCellProps & {
+    t: TrajectoryTranslate;
+}): import("react").JSX.Element;
+//# sourceMappingURL=TrajectoryCell.d.ts.map

package/lib/types/client/TrajectoryGroupHeader.d.ts

@@ -0,0 +1,13 @@
+export interface TrajectoryGroupHeaderProps {
+    /** Group title (`Message`, `Step 1`, …). */
+    title: string;
+    /** Secondary summary (`49 s`, `2.2 s skill`, …). */
+    description?: string;
+}
+/**
+ * Render a Message/Step group header inside a turn body.
+ * @param props - title and optional description.
+ * @returns the group header element.
+ */
+export declare function TrajectoryGroupHeader({ title, description }: TrajectoryGroupHeaderProps): import("react").JSX.Element;
+//# sourceMappingURL=TrajectoryGroupHeader.d.ts.map

package/lib/types/client/TrajectoryTable.d.ts

@@ -0,0 +1,108 @@
+/** Turn-aware trajectory event ledger with a local record inspector. */
+import type { AssistantRequestConfig, RenderMessageImages } from '@prettier-ai/dsh-client-ui-conversation/client';
+import type { TrajectoryCellProps } from './trajectory-record.ts';
+import type { TrajectoryTurnModel } from './layout.ts';
+import type { TrajectoryTranslate } from './locales.ts';
+/** Props for the trajectory ledger. */
+export interface TrajectoryTableProps {
+    /** Trajectory locale seat. */
+    t: TrajectoryTranslate;
+    /** Slot-backed durable image renderer shared with the Chat gallery. */
+    renderImages: RenderMessageImages;
+    /** Session-global request numbers for the request groups visible in this context. */
+    requestNumbers?: readonly TrajectoryRequestNumber[];
+    /** Grouped records in display order. */
+    turns: readonly TrajectoryTurnModel[];
+    /** In-flight cells whose content replaces the matching structural record index. */
+    streamingCells?: readonly TrajectoryCellProps[];
+    /** Record indexes emphasized by the active timeline focus. */
+    timelineFocusIndexes?: ReadonlySet<number> | null;
+    /** Record indexes retained by the active live search, or null without a query. */
+    searchMatchIndexes?: ReadonlySet<number> | null;
+    /** Report the record currently selected in the local inspector. */
+    onSelectedIndexChange?: (index: number | null) => void;
+    /** Report a direct user selection from a ledger row. */
+    onRecordSelect?: (index: number) => void;
+    /** One externally requested record selection; a new object repeats the request. */
+    recordSelection?: {
+        readonly index: number;
+    } | null;
+    /** One externally requested record focus without changing inspector selection. */
+    recordFocus?: {
+        readonly index: number;
+    } | null;
+    /** Whether the initial history tail is still loading. */
+    historyLoading?: boolean;
+    /** Whether one older history page request is pending anywhere. */
+    olderHistoryLoading?: boolean;
+    /** First loaded raw event, used to preserve scroll position after prepending a page. */
+    historyStartSeq?: number | undefined;
+    /** Whether one older history page can be requested. */
+    hasOlderRecords?: boolean;
+    /** Load one older history page. */
+    onLoadOlder?: () => Promise<boolean>;
+    /** Clear selection state owned by the ledger host. */
+    onClearSelection?: () => void;
+    /** Turn ids whose rows after the first are folded into a summary. */
+    collapsedTurns: ReadonlySet<number>;
+    /** Toggle one turn between folded and expanded. */
+    onToggleTurn: (turn: number) => void;
+    /** Stable Assistant record ids whose tool calls are folded. */
+    collapsedAssistants: ReadonlySet<string>;
+    /** Toggle tool calls under one assistant record. */
+    onToggleAssistant: (id: string) => void;
+    /** One-shot cross-view inspect: open and scroll to this call's record. */
+    inspectCallId?: string | null;
+    /** Acknowledge a consumed (or unresolvable) inspect request. */
+    onInspectApplied?: (() => void) | undefined;
+}
+/** Request-inspector fields shared by ordinary generation and compaction. */
+interface TrajectoryRequestNumberBase {
+    group: string;
+    number: number;
+    status?: 'complete' | 'running' | 'error';
+    startedAt?: number;
+    completedAt?: number | null;
+    error?: string;
+    errorCode?: string;
+    retry?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    resultSeq?: number;
+    provider?: string;
+    model?: string;
+    requestConfig?: AssistantRequestConfig;
+    usage?: TrajectoryUsage;
+    cumulativeUsage?: TrajectoryUsage;
+}
+/** One purpose-discriminated request identity paired with its session-global number. */
+export type TrajectoryRequestNumber = TrajectoryRequestNumberBase & ({
+    purpose?: 'assistant';
+    /** Request anchor event sequence; absent for the currently streaming request. */
+    seq?: number;
+    turn: number;
+    step: number;
+} | {
+    purpose: 'compaction';
+    /** Request anchor event sequence and stable compaction identity. */
+    seq: number;
+    turn: number | null;
+    step: 0;
+});
+/** Disjoint provider token buckets for one request or a session prefix. */
+export interface TrajectoryUsage {
+    input?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    output?: number;
+    reasoning?: number;
+}
+/**
+ * Render trajectory events as a dense ledger with turn and step separators.
+ * Clicking ledger whitespace clears the active record or request selection.
+ * @param props - Grouped trajectory data and whole-ledger fold state.
+ * @returns The ledger and an optional local record inspector.
+ */
+export declare function TrajectoryTable({ t, renderImages, requestNumbers: sessionRequestNumbers, turns, streamingCells, timelineFocusIndexes, searchMatchIndexes, onSelectedIndexChange, onRecordSelect, recordSelection, recordFocus, historyLoading, olderHistoryLoading, historyStartSeq, hasOlderRecords, onLoadOlder, onClearSelection, collapsedTurns, onToggleTurn, collapsedAssistants, onToggleAssistant, inspectCallId, onInspectApplied, }: TrajectoryTableProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=TrajectoryTable.d.ts.map

package/lib/types/client/TrajectoryTimeline.d.ts

@@ -0,0 +1,26 @@
+/** Chrome-Network-style overview timeline for focusing the trajectory ledger. */
+import type { TrajectoryTurnModel } from './layout.ts';
+import type { TrajectoryTranslate } from './locales.ts';
+import { type TrajectoryTimelineMode, type TrajectoryTimeRange } from './timeline.ts';
+/** Props for the fixed full-domain overview above the trajectory ledger. */
+export interface TrajectoryTimelineProps {
+    t: TrajectoryTranslate;
+    turns: readonly TrajectoryTurnModel[];
+    mode: TrajectoryTimelineMode;
+    range: TrajectoryTimeRange | null;
+    /** Whether the loaded timeline omits an earlier history prefix. */
+    hasEarlierRecords?: boolean;
+    /** Load one earlier history page from the truncation control. */
+    onLoadEarlier?: () => Promise<boolean>;
+    selectedIndex?: number | null;
+    /** Record indexes matching the active ledger search, or null without a query. */
+    searchMatchIndexes?: ReadonlySet<number> | null;
+    onRangeChange: (range: TrajectoryTimeRange | null) => void;
+    /** Select a directly clicked timeline block. */
+    onRecordSelect?: (index: number) => void;
+    /** Bring the nearest record into view after clicking timeline whitespace. */
+    onRecordFocus?: (index: number) => void;
+}
+/** Overview renderer with drag ranges, click-sized focus, and Escape reset. */
+export declare const TrajectoryTimeline: import("react").MemoExoticComponent<({ t, turns, mode, range, hasEarlierRecords, onLoadEarlier, selectedIndex, searchMatchIndexes, onRangeChange, onRecordSelect, onRecordFocus, }: TrajectoryTimelineProps) => import("react").JSX.Element>;
+//# sourceMappingURL=TrajectoryTimeline.d.ts.map

package/lib/types/client/TrajectoryToolbar.d.ts

@@ -0,0 +1,34 @@
+/** Trajectory toolbar: timeline and ledger fold controls. */
+import type { TranslateNS } from '@prettier-ai/dsh-client-ui-slots';
+import type { NS } from './locales.ts';
+export interface TrajectoryToolbarProps {
+    /** Whether timeline blocks use recorded durations instead of equal widths. */
+    actualDuration: boolean;
+    /** Select recorded-duration or equal-width blocks. */
+    onActualDurationChange: (actualDuration: boolean) => void;
+    /** Whether recorded timing retains idle gaps between operations. */
+    actualTime: boolean;
+    /** Select complete wall-clock timing or idle-compressed timing. */
+    onActualTimeChange: (actualTime: boolean) => void;
+    /** Whether every collapsible turn is currently folded. */
+    allTurnsCollapsed: boolean;
+    /** Fold or expand every collapsible turn. */
+    onToggleAllTurns: () => void;
+    /** Whether every collapsible assistant's tool calls are currently folded. */
+    allAssistantsCollapsed: boolean;
+    /** Fold or expand tool calls under every collapsible assistant. */
+    onToggleAllAssistants: () => void;
+    /** Current live ledger search query. */
+    searchQuery: string;
+    /** Update the live ledger search query. */
+    onSearchQueryChange: (query: string) => void;
+    /** Translate a toolbar dictionary key. */
+    t: TranslateNS<typeof NS>;
+}
+/**
+ * Render the sticky trajectory toolbar.
+ * @param props - rendered counts and whole-list fold state.
+ * @returns the toolbar element.
+ */
+export declare function TrajectoryToolbar({ actualDuration, onActualDurationChange, actualTime, onActualTimeChange, allTurnsCollapsed, onToggleAllTurns, allAssistantsCollapsed, onToggleAllAssistants, searchQuery, onSearchQueryChange, t, }: TrajectoryToolbarProps): import("react").JSX.Element;
+//# sourceMappingURL=TrajectoryToolbar.d.ts.map

package/lib/types/client/TrajectoryTurn.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from 'react';
+import type { TrajectoryTranslate } from './locales.ts';
+export interface TrajectoryTurnProps {
+    /** 1-based turn index for the sticky header. */
+    turn: number;
+    /** Message / Step headers and TrajectoryCell rows. */
+    children?: ReactNode;
+    /** Trajectory locale seat. */
+    t: TrajectoryTranslate;
+}
+/**
+ * Render one turn section (sticky header + body).
+ * @param props - turn index and body children.
+ * @returns the turn section element.
+ */
+export declare function TrajectoryTurn({ turn, children, t }: TrajectoryTurnProps): import("react").JSX.Element;
+//# sourceMappingURL=TrajectoryTurn.d.ts.map

package/lib/types/client/TrajectoryTurnHeader.d.ts

@@ -0,0 +1,14 @@
+import type { TrajectoryTranslate } from './locales.ts';
+export interface TrajectoryTurnHeaderProps {
+    /** 1-based turn index shown as `Turn N`. */
+    turn: number;
+    /** Trajectory locale seat. */
+    t: TrajectoryTranslate;
+}
+/**
+ * Render the sticky turn header row.
+ * @param props.turn - turn index.
+ * @returns the sticky header element.
+ */
+export declare function TrajectoryTurnHeader({ turn, t }: TrajectoryTurnHeaderProps): import("react").JSX.Element;
+//# sourceMappingURL=TrajectoryTurnHeader.d.ts.map

package/lib/types/client/TrajectoryView.d.ts

@@ -0,0 +1,15 @@
+/** Trajectory view: compact summary over a turn-aware event ledger. */
+import type { ConvViewProps, MessageImageLoader } from '@prettier-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale, PropsRenderSlots } from '@prettier-ai/dsh-client-ui-slots';
+import type { SnapshotStore } from '@prettier-ai/dsh-client-store';
+/** Session-bound controls not already supplied by the conversation view slot. */
+export interface TrajectoryViewInjected {
+    hooks: {
+        duration: SnapshotStore<boolean>;
+    };
+    loadOlder: () => Promise<boolean>;
+    loadImage: MessageImageLoader;
+    setActualDuration: (actualDuration: boolean) => void;
+}
+export declare function TrajectoryView({ useSession, useTrajectory, useDuration, loadOlder, loadImage, setActualDuration, viewRequest, completeViewRequest, renderSlot, t, }: ConvViewProps & PropsRenderSlots<'conversation.trajectory.images'> & InjectFace<TrajectoryViewInjected> & PropsLocale<'trajectory'>): import("react").JSX.Element;
+//# sourceMappingURL=TrajectoryView.d.ts.map

package/lib/types/client/copy-codes.d.ts

@@ -0,0 +1,4 @@
+/** Stable non-display markers for client-synthesized trajectory copy. */
+/** Error marker localized only when the trajectory renders it. */
+export declare const COMPACTION_INTERRUPTED_ERROR = "trajectory.compaction-interrupted";
+//# sourceMappingURL=copy-codes.d.ts.map

package/lib/types/client/duration-store.d.ts

@@ -0,0 +1,7 @@
+import { type SnapshotStore } from '@prettier-ai/dsh-client-store';
+/**
+ * Create the browser-wide trajectory duration preference source.
+ * @returns a persisted source shared by every session view in one plugin lifecycle.
+ */
+export declare function createTrajectoryDurationStore(): SnapshotStore<boolean>;
+//# sourceMappingURL=duration-store.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Browser trajectory plugin contributing one entry to the conversation view
+ * slot without defining a service.
+ */
+import type { Context } from '@prettier-ai/cordis';
+export type { TrajectoryKey } from './locales.ts';
+export type { TrajectoryContribution, TrajectoryConversationViewNode, TrajectoryRequestHeaderState, TrajectorySnapshot, UseTrajectory, } from './trajectory-contract.ts';
+/** Required services: the conversation slot, registries, ordinary Session paging, and the locale service. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the trajectory view tab. The registration
+ * rides the slot service's effect wrapper, so plugin unload removes the tab.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/layout.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Trajectory list fold: expand assistant blocks, attach usage to Message,
+ * own-duration times, in-flight partial/runningCalls, and group descriptions.
+ */
+import type { ConversationLocation, RequestInspectionSnapshot, RequestView } from '@prettier-ai/dsh-client-ui-conversation/client';
+import type { TrajectoryCellProps } from './trajectory-record.ts';
+import type { TrajectorySnapshot } from './trajectory-contract.ts';
+import type { TrajectoryTranslate } from './locales.ts';
+/** One Message or Step group inside a turn. */
+export interface TrajectoryGroupModel {
+    title: string;
+    description?: string;
+    cells: readonly TrajectoryCellProps[];
+}
+/** One sticky turn, or a standalone compaction section between turns. */
+export interface TrajectoryTurnModel {
+    turn: number | null;
+    groups: readonly TrajectoryGroupModel[];
+}
+/** Snapshot slice the trajectory view folds. */
+export interface TrajectoryLayoutInput {
+    nodes: TrajectorySnapshot['eventNodes'];
+    eventLocations?: ReadonlyMap<number, ConversationLocation>;
+    partial: TrajectorySnapshot['partial'];
+    runningCalls: TrajectorySnapshot['runningCalls'];
+    requests?: readonly RequestView[];
+    callSchemas?: RequestInspectionSnapshot['callSchemas'];
+}
+/**
+ * Fold a snapshot into turn → Message/Step groups with expanded cells.
+ * @param input - nodes plus in-flight partial/runningCalls.
+ * @param t - Trajectory locale translator.
+ * @returns turns ordered by first appearance.
+ */
+export declare function deriveTrajectoryLayout(input: TrajectoryLayoutInput, t: TrajectoryTranslate): readonly TrajectoryTurnModel[];
+/**
+ * Append the changing in-flight assistant cells to a stable finalized layout.
+ * @param turns - Finalized layout derived with an empty-block partial anchor.
+ * @param partial - Current in-flight assistant projection.
+ * @param lastIndex - Highest cell index in the finalized layout.
+ * @param t - Trajectory locale translator.
+ * @returns The original layout without a partial, otherwise a layout sharing every unaffected turn.
+ */
+export declare function appendTrajectoryPartialLayout(turns: readonly TrajectoryTurnModel[], partial: TrajectorySnapshot['partial'], lastIndex: number, t: TrajectoryTranslate): readonly TrajectoryTurnModel[];
+//# sourceMappingURL=layout.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,193 @@
+/** `trajectory` namespace dictionaries for the complete trajectory surface. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "trajectory";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    readonly 'view.trajectory': "轨迹";
+    readonly 'toolbar.aria': "轨迹工具栏";
+    readonly 'toolbar.duration': "时长";
+    readonly 'toolbar.useActualDuration': "使用实际时长";
+    readonly 'toolbar.useEqualWidth': "使用等宽操作";
+    readonly 'toolbar.actualTime': "实际时间";
+    readonly 'toolbar.turns': "轮次";
+    readonly 'toolbar.expandTurns': "展开所有轮次";
+    readonly 'toolbar.collapseTurns': "收起所有轮次";
+    readonly 'toolbar.calls': "调用";
+    readonly 'toolbar.expandCalls': "展开所有调用";
+    readonly 'toolbar.collapseCalls': "收起所有调用";
+    readonly 'toolbar.search': "搜索轨迹";
+    readonly 'toolbar.searchPlaceholder': "搜索";
+    readonly 'kind.system': "系统";
+    readonly 'kind.user': "用户";
+    readonly 'kind.context': "上下文";
+    readonly 'kind.compacted': "已压缩";
+    readonly 'kind.message': "消息";
+    readonly 'kind.assistant': "助手";
+    readonly 'kind.tool': "工具";
+    readonly 'kind.subtool': "子工具";
+    readonly 'kind.sub': "子项";
+    readonly 'column.input': "输入";
+    readonly 'column.output': "输出";
+    readonly 'column.think': "思考";
+    readonly 'column.time': "时间";
+    readonly 'column.model': "模型";
+    readonly 'column.tools': "工具";
+    readonly 'turn.label': "第 {turn} 轮";
+    readonly 'section.betweenTurns': "轮次之间";
+    readonly 'group.message': "消息";
+    readonly 'group.step': "步骤 {step}";
+    readonly 'group.compaction': "压缩 {seq}";
+    readonly 'status.failed': "失败";
+    readonly 'status.pending': "等待中";
+    readonly 'status.completed': "已完成";
+    readonly 'timing.notAvailable': "不可用";
+    readonly 'timing.notRecorded': "未记录";
+    readonly 'timing.stepStartUnavailable': "步骤开始时间不可用";
+    readonly 'timing.firstTokenUnavailable': "首 token 时间不可用";
+    readonly 'timing.usageUnavailable': "用量不可用";
+    readonly 'timing.outputTokensUnavailable': "输出 token 数不可用";
+    readonly 'timing.durationTooShort': "时长过短";
+    readonly 'timing.showLocalTime': "显示本地时间";
+    readonly 'timing.showUnixTimestamp': "显示 Unix 时间戳";
+    readonly 'timing.started': "开始时间";
+    readonly 'timing.totalDuration': "总时长";
+    readonly 'timing.ttft': "首 token 延迟";
+    readonly 'timing.generation': "生成";
+    readonly 'timing.throughput': "吞吐量";
+    readonly 'timing.duration': "时长";
+    readonly 'timing.source': "计时来源";
+    readonly 'timing.sessionTimestamps': "会话时间戳";
+    readonly 'timing.sessionTimestampsRunning': "会话时间戳（运行中）";
+    readonly 'timing.request': "请求计时";
+    readonly 'unit.milliseconds': "{value} 毫秒";
+    readonly 'unit.seconds': "{value} 秒";
+    readonly 'unit.tokens': "{value} tok";
+    readonly 'unit.tokensPerSecond': "{value} tok/s";
+    readonly 'usage.tokens': "Token";
+    readonly 'usage.reasoning': "推理";
+    readonly 'usage.content': "内容";
+    readonly 'usage.notReported': "未报告用量";
+    readonly 'usage.input': "输入";
+    readonly 'usage.cached': "缓存读取";
+    readonly 'usage.cacheCreated': "缓存写入";
+    readonly 'usage.other': "其他";
+    readonly 'usage.output': "输出";
+    readonly 'usage.thisRequest': "本次请求";
+    readonly 'usage.sessionCumulative': "会话累计";
+    readonly 'options.notRecorded': "未记录选项";
+    readonly 'options.json': "请求选项 JSON";
+    readonly 'source.unknown': "未知";
+    readonly 'source.user': "用户";
+    readonly 'source.plugin': "插件";
+    readonly 'source.pluginNamed': "插件 · {plugin}";
+    readonly 'source.goal': "目标";
+    readonly 'source.goalRound': "目标 · Round {round}";
+    readonly 'source.notRecorded': "未记录来源";
+    readonly 'source.messageJson': "消息来源 JSON";
+    readonly 'tab.summary': "概述";
+    readonly 'tab.rawOutput': "原始输出";
+    readonly 'tab.preview': "预览";
+    readonly 'tab.raw': "原始内容";
+    readonly 'tab.source': "来源";
+    readonly 'tab.payload': "参数";
+    readonly 'tab.result': "结果";
+    readonly 'tab.schema': "Schema";
+    readonly 'tab.timing': "计时";
+    readonly 'tab.diff': "差异";
+    readonly 'tab.systemPrompt': "系统提示词";
+    readonly 'tab.tools': "工具";
+    readonly 'tab.options': "选项";
+    readonly 'tab.usage': "用量";
+    readonly 'record.toolCallOnly': "（仅工具调用）";
+    readonly 'record.noContent': "无内容";
+    readonly 'record.noPayload': "未捕获参数";
+    readonly 'record.noResult': "未捕获结果";
+    readonly 'record.noOutput': "无输出";
+    readonly 'record.schemaUnavailable': "Schema 不可用";
+    readonly 'record.parameters': "参数";
+    readonly 'record.resultJson': "结果 JSON";
+    readonly 'record.json': "JSON";
+    readonly 'record.parametersJson': "参数 JSON";
+    readonly 'record.namedParametersJson': "{name} 参数 JSON";
+    readonly 'record.payloadJson': "参数 JSON";
+    readonly 'record.outputJson': "结果 JSON";
+    readonly 'record.thinking': "思考";
+    readonly 'record.systemPromptMissing': "本次请求没有系统提示词";
+    readonly 'record.toolsMissing': "本次请求没有工具";
+    readonly 'record.systemPrompt': "系统提示词";
+    readonly 'record.tools': "工具";
+    readonly 'block.openSummary': "打开第 {index} 个块的工具调用概述";
+    readonly 'block.openSummaryTitle': "打开工具调用概述";
+    readonly 'block.label': "块 #{index} {type}";
+    readonly 'history.loadingTrajectory': "正在加载轨迹…";
+    readonly 'history.loadingEarlier': "正在加载更早的历史…";
+    readonly 'history.loadingEarlierAria': "正在加载更早的历史…";
+    readonly 'history.loadEarlier': "加载更早的历史";
+    readonly 'history.clickToLoadEarlier': "点击加载更早的历史";
+    readonly 'request.label': "请求 #{request}";
+    readonly 'request.labelCompaction': "请求 #{request} · 压缩";
+    readonly 'request.compaction': "压缩 · {section}";
+    readonly 'request.compactionPurpose': "压缩";
+    readonly 'request.retryProgress': "{retry}/{maximum}";
+    readonly 'request.collapsedSummary': "已收起的{kind}概述，{summary}";
+    readonly 'request.collapsedTurn': "轮次";
+    readonly 'request.collapsedAssistant': "助手";
+    readonly 'request.rowAria': "{request}{kind}，{content}";
+    readonly 'request.rowPrefix': "请求 {request}，";
+    readonly 'request.rowAriaCompaction': "请求 {request}，压缩";
+    readonly 'request.noContent': "无内容";
+    readonly 'summary.toolCalls.one': "{count} 个工具调用";
+    readonly 'summary.toolCalls.other': "{count} 个工具调用";
+    readonly 'summary.steps.one': "{count} 个步骤";
+    readonly 'summary.steps.other': "{count} 个步骤";
+    readonly 'details.event': "事件详情";
+    readonly 'details.resize': "调整事件详情宽度";
+    readonly 'details.resizeTitle': "拖动调整大小；双击恢复默认值。";
+    readonly 'details.close': "关闭详情";
+    readonly 'details.status': "状态";
+    readonly 'details.purpose': "用途";
+    readonly 'details.provider': "提供方";
+    readonly 'details.model': "模型";
+    readonly 'details.toolCalls': "工具调用";
+    readonly 'details.subtoolCalls': "子工具调用";
+    readonly 'details.error': "错误";
+    readonly 'details.failure.auth': "API 密钥无效";
+    readonly 'details.retry': "重试";
+    readonly 'details.scheduled': "已计划";
+    readonly 'details.retryDelay': "重试延迟";
+    readonly 'details.result': "结果";
+    readonly 'details.compacted': "已压缩";
+    readonly 'details.assistantMessage': "助手消息";
+    readonly 'details.source': "来源";
+    readonly 'details.hierarchy': "层级";
+    readonly 'details.toolCall': "工具调用";
+    readonly 'timeline.aria': "轨迹时间线";
+    readonly 'timeline.overviewAria': "时间线概览；水平拖动可聚焦事件";
+    readonly 'timeline.noTimingData': "无计时数据";
+    readonly 'timeline.total': "总计 {duration}";
+    readonly 'timeline.started': "开始于 {time}";
+    readonly 'timeline.ttftDecoding': "首 token {ttft} · 解码 {decoding}";
+    readonly 'layout.compacting': "正在压缩上下文…";
+    readonly 'layout.compactionFailed': "上下文压缩失败";
+    readonly 'layout.compacted': "上下文已压缩";
+    readonly 'layout.toolCallOnly': "仅工具调用";
+    readonly 'layout.imageOnly': "图片 ×{count}";
+    readonly 'layout.initialSystemPrompt': "初始系统提示词";
+    readonly 'layout.systemPromptUpdated': "系统提示词已更新";
+    readonly 'layout.toolsUpdated': "工具已更新";
+    readonly 'layout.systemPromptAndToolsUpdated': "系统提示词和工具已更新";
+    readonly 'layout.compactionInterrupted': "上下文压缩在完成前被中断。";
+};
+/** The trajectory dictionary key union. */
+export type TrajectoryKey = keyof typeof zh;
+declare module '@prettier-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The complete trajectory ledger, timeline, inspector, and toolbar copy. */
+        trajectory: TrajectoryKey;
+    }
+}
+/** Namespace-bound translator threaded through trajectory presentation code. */
+export type TrajectoryTranslate = import('@prettier-ai/dsh-client-ui-slots').TranslateNS<typeof NS>;
+/** English dictionary, checked complete against the Chinese source of truth. */
+export declare const en: Record<TrajectoryKey, string>;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/timeline.d.ts

@@ -0,0 +1,52 @@
+/** Operation-sequence and recorded-time projections for the trajectory overview. */
+import type { TrajectoryTurnModel } from './layout.ts';
+import type { TrajectoryTranslate } from './locales.ts';
+import type { TrajectoryCellKind } from './trajectory-record.ts';
+/** Horizontal projection used by the trajectory timeline. */
+export type TrajectoryTimelineMode = 'sequence' | 'duration' | 'time' | 'actual';
+/** Inclusive selection in the active timeline projection's domain. */
+export interface TrajectoryTimeRange {
+    start: number;
+    end: number;
+}
+/** One ledger record projected into the active timeline domain. */
+export interface TrajectoryTimelineSpan extends TrajectoryTimeRange {
+    index: number;
+    isError: boolean;
+    kind: TrajectoryCellKind;
+    label: string;
+    lane: number;
+}
+/** One turn boundary in the active timeline domain. */
+export interface TrajectoryTimelineTurnBoundary {
+    turn: number;
+    time: number;
+}
+/** Full-domain model used by the overview. */
+export interface TrajectoryTimelineModel extends TrajectoryTimeRange {
+    spans: readonly TrajectoryTimelineSpan[];
+    turnBoundaries: readonly TrajectoryTimelineTurnBoundary[];
+}
+/**
+ * Format a timeline duration as an integer-millisecond label.
+ * @param milliseconds - Non-negative duration in milliseconds.
+ * @param t - Trajectory locale translator.
+ * @returns Millisecond label with thousands separators.
+ */
+export declare function formatTimelineOffset(milliseconds: number, t: TrajectoryTranslate): string;
+/**
+ * Project every visible record into a stable three-lane timeline.
+ * @param turns - Unfiltered trajectory layout.
+ * @param mode - Independent equal/recorded duration and compressed/complete time projection.
+ * @returns Timeline model, or `null` when no record is visible.
+ */
+export declare function deriveTrajectoryTimeline(turns: readonly TrajectoryTurnModel[], mode?: TrajectoryTimelineMode): TrajectoryTimelineModel | null;
+/**
+ * Identify records active at any point inside an inclusive selected interval.
+ * @param turns - Unfiltered trajectory layout.
+ * @param range - Selected interval in the active projection.
+ * @param mode - Independent equal/recorded duration and compressed/complete time projection.
+ * @returns Record indexes inside the focus interval.
+ */
+export declare function trajectoryTimelineFocusIndexes(turns: readonly TrajectoryTurnModel[], range: TrajectoryTimeRange, mode?: TrajectoryTimelineMode): ReadonlySet<number>;
+//# sourceMappingURL=timeline.d.ts.map

package/lib/types/client/trajectory-assistant-definition.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from '@prettier-ai/cordis';
+/**
+ * Register the Trajectory Assistant lifecycle.
+ *
+ * @param ctx - Plugin context receiving the Definitions.
+ */
+export declare function registerTrajectoryAssistantDefinition(ctx: Context): void;
+//# sourceMappingURL=trajectory-assistant-definition.d.ts.map

package/lib/types/client/trajectory-compaction-definition.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from '@prettier-ai/cordis';
+/**
+ * Register Trajectory compaction requests and session boundaries.
+ *
+ * @param ctx - Plugin context receiving the Definitions.
+ */
+export declare function registerTrajectoryCompactionDefinitions(ctx: Context): void;
+//# sourceMappingURL=trajectory-compaction-definition.d.ts.map