@qilin-agent/client-ui-trajectory 0.0.0-stage → 3.1.4

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

@@ -0,0 +1,293 @@
+/** `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.wrapLines': "自动换行";
+    readonly 'code.source': "代码";
+    readonly 'code.output': "输出";
+    readonly 'code.copySource': "复制代码";
+    readonly 'code.copyOutput': "复制输出";
+    readonly 'code.originalJson': "原始 JSON";
+    readonly 'code.running': "执行中…";
+    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.lastAttemptError': "上次尝试错误";
+    readonly 'details.failure.auth': "API 密钥无效";
+    readonly 'details.retry': "重试";
+    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 'attachment.list': "附件";
+    readonly 'attachment.imageName': "图片 {index}";
+    readonly 'layout.imageCount': "图片 ×{count}";
+    readonly 'layout.toolAdded': "已添加工具：{name}";
+    readonly 'layout.toolRemoved': "已移除工具：{name}";
+    readonly 'layout.toolUpdateNotice': "工具已更新";
+    readonly 'layout.toolsAdded': "新增：{names}";
+    readonly 'layout.toolsAddedCount': "新增 {count} 个";
+    readonly 'layout.toolsChanged': "新增 {added} 个，移除 {removed} 个";
+    readonly 'layout.toolsRemoved': "移除：{names}";
+    readonly 'layout.toolsRemovedCount': "移除 {count} 个";
+    readonly 'layout.fileAttachments': "文件 ×{count}";
+    readonly 'layout.initialSystemPrompt': "初始系统提示词";
+    readonly 'layout.systemPromptUpdated': "系统提示词已更新";
+    readonly 'layout.toolsUpdated': "工具已更新";
+    readonly 'layout.systemPromptAndToolsUpdated': "系统提示词和工具已更新";
+    readonly 'layout.compactionInterrupted': "上下文压缩在完成前被中断。";
+    readonly 'view.trajectoryGraph': "轨迹图";
+    readonly 'guide.graphDescription': "把轨迹账本画成节点与边的实时流动图";
+    readonly 'graph.toolbar': "轨迹图工具栏";
+    readonly 'graph.fit': "适应视图";
+    readonly 'graph.follow': "跟随最新";
+    readonly 'graph.pause': "暂停流动";
+    readonly 'graph.resume': "继续流动";
+    readonly 'graph.canvas': "轨迹图画布";
+    readonly 'graph.empty': "暂无可绘制的轨迹记录";
+    readonly 'graph.windowed': "仅显示最近 {count} 条记录";
+    readonly 'graph.hint': "点击节点查看参数与结果";
+    readonly 'graph.openLedger': "账本";
+    readonly 'graph.nodeAria': "{kind}节点：{label}";
+    readonly 'graph.live': "进行中";
+    readonly 'graph.sequence': "序号";
+    readonly 'graph.time': "时间";
+    readonly 'graph.duration': "耗时";
+    readonly 'graph.tokens': "令牌";
+    readonly 'graph.parameters': "参数";
+    readonly 'graph.result': "结果";
+    readonly 'graph.closeDetails': "关闭详情";
+    readonly 'graph.unrecorded': "未记录";
+    readonly 'graph.stats.nodes': "{count} 节点";
+    readonly 'graph.stats.edges': "{count} 边";
+    readonly 'graph.stats.turns': "{count} 轮";
+    readonly 'graph.stats.tokens': "{count} 令牌";
+    readonly 'graph.lane.input': "输入";
+    readonly 'graph.lane.model': "模型";
+    readonly 'graph.lane.tool': "工具";
+    readonly 'graph.context.inject': "注入";
+    readonly 'graph.context.recall': "召回";
+    readonly 'graph.status.idle': "空闲";
+    readonly 'graph.status.running': "进行中";
+    readonly 'graph.status.interrupted': "已中断";
+    readonly 'graph.node.system': "系统提示词";
+    readonly 'graph.node.user': "用户消息";
+    readonly 'graph.node.steering': "插话";
+    readonly 'graph.node.context': "上下文";
+    readonly 'graph.node.command': "命令";
+    readonly 'graph.node.request': "模型请求";
+    readonly 'graph.node.compactionRequest': "压缩请求";
+    readonly 'graph.node.assistant': "助手消息";
+    readonly 'graph.node.streaming': "流式输出";
+    readonly 'graph.node.compaction': "上下文压缩";
+    readonly 'graph.node.retryScheduled': "等待重试";
+    readonly 'graph.node.retryStarted': "重试中";
+    readonly 'graph.node.retryCancelled': "重试已取消";
+    readonly 'graph.node.error': "错误";
+    readonly 'graph.node.maxTokens': "输出上限";
+    readonly 'graph.node.tool': "工具";
+    readonly 'graph.node.runningCall': "调用中";
+    readonly 'graph.node.unknown': "未知事件";
+    readonly 'graph.search': "搜索记录";
+    readonly 'graph.search.count': "{index}/{total}";
+    readonly 'graph.search.none': "无匹配";
+    readonly 'graph.zoom.in': "放大";
+    readonly 'graph.zoom.out': "缩小";
+    readonly 'graph.replay': "回放";
+    readonly 'graph.replay.pause': "暂停回放";
+    readonly 'graph.replay.speed': "回放速度";
+    readonly 'graph.replay.stop': "停止回放";
+    readonly 'graph.edge.prompt': "提示";
+    readonly 'graph.edge.result': "结果";
+    readonly 'graph.edge.dispatch': "派发";
+    readonly 'graph.edge.subcall': "子调用";
+    readonly 'graph.edge.loop': "循环";
+    readonly 'graph.edge.hint': "悬停高亮，点击固定";
+    readonly 'graph.stats.slowest': "最慢 {name} {duration}";
+    readonly 'graph.stats.leader': "{name} {duration}";
+    readonly 'graph.tool.args': "参数 JSON";
+    readonly 'graph.tool.pending': "等待结果";
+    readonly 'graph.markdown.copy': "复制";
+    readonly 'graph.markdown.copied': "复制成功";
+    readonly 'graph.markdown.diagram': "Mermaid 图";
+    readonly 'graph.markdown.enlarged': "Mermaid 图（放大）";
+    readonly 'graph.markdown.footnotes': "脚注";
+    readonly 'graph.lightbox': "图片预览";
+    readonly 'graph.lightbox.close': "关闭图片预览";
+    readonly 'graph.attachment.file': "文件";
+    readonly 'graph.attachment.offloaded': "已卸载";
+    readonly 'graph.attachment.counts': "图片 {images} · 文件 {files}";
+    readonly 'graph.attachment.view': "查看大图";
+};
+/** The trajectory dictionary key union. */
+export type TrajectoryKey = keyof typeof zh;
+declare module '@qilin-agent/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('@qilin-agent/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/string-wrapping-store.d.ts

@@ -0,0 +1,7 @@
+import { type SnapshotStore } from '@qilin-agent/client-store';
+/**
+ * Create the browser-wide default for expanded JSON strings.
+ * @returns A persisted preference sampled only when a string is expanded.
+ */
+export declare function createTrajectoryStringWrappingStore(): SnapshotStore<boolean>;
+//# sourceMappingURL=string-wrapping-store.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 '@qilin-agent/kylin';
+/**
+ * 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 '@qilin-agent/kylin';
+/**
+ * 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

package/lib/types/client/trajectory-contract.d.ts

@@ -0,0 +1,96 @@
+import type { AssistantMessageNode, ConversationLocation, ConversationNode, ConversationPromptSnapshot, ConversationViewNode, MessageImagesOwnerProps, PartialAssistant, RequestPromptChange, RequestView, RunningToolCall, SystemPromptNode, ToolCallBlock } from '@qilin-agent/client-ui-conversation/client';
+import type { SnapshotSelectorHook } from '@qilin-agent/client-ui-slots';
+/** Request-header facts retained by the Trajectory target. */
+export interface TrajectoryRequestHeaderState {
+    readonly seq: number;
+    readonly time: number;
+    readonly prompt: ConversationPromptSnapshot;
+    readonly change?: RequestPromptChange;
+    readonly location: ConversationLocation;
+}
+/** In-flight assistant output with the loaded Step start and first token timestamps. */
+export interface TrajectoryPartialAssistant extends PartialAssistant {
+    readonly timing?: Pick<NonNullable<AssistantMessageNode['timing']>, 'stepStartTime' | 'firstTokenTime'>;
+}
+/** One independently assembled contribution to the legacy Trajectory ledger. */
+export type TrajectoryContribution = {
+    readonly kind: 'system-prompt';
+    readonly prompt: SystemPromptNode;
+} | {
+    readonly kind: 'node';
+    readonly node: ConversationNode;
+} | {
+    readonly kind: 'assistant';
+    readonly node?: AssistantMessageNode;
+    readonly partial: TrajectoryPartialAssistant | null;
+    readonly request?: Extract<RequestView, {
+        purpose: 'assistant';
+    }>;
+} | {
+    readonly kind: 'tool';
+    readonly root: ToolCallBlock;
+} | {
+    readonly kind: 'request-header';
+    readonly header: TrajectoryRequestHeaderState;
+} | {
+    readonly kind: 'compaction';
+    readonly request: Extract<RequestView, {
+        purpose: 'compaction';
+    }>;
+} | {
+    readonly kind: 'session-end';
+    readonly seq: number;
+    readonly time: number;
+} | {
+    readonly kind: 'turn-end';
+    readonly turn: number;
+    readonly time: number;
+    readonly error?: string;
+    readonly errorCode?: string;
+};
+/** Target envelope consumed by the Trajectory snapshot builder. */
+export interface TrajectoryConversationViewNode extends ConversationViewNode {
+    readonly target: 'trajectory';
+    readonly anchorSeq: number;
+    readonly location: ConversationLocation;
+    readonly data: TrajectoryContribution;
+}
+/** Stage-oriented Trajectory data assembled from registered business Contexts. */
+export interface TrajectorySnapshot {
+    /** Complete loaded prompt text whose request header is outside the window. */
+    readonly systemPrompts?: readonly SystemPromptNode[];
+    readonly eventNodes: readonly ConversationNode[];
+    readonly eventLocations: ReadonlyMap<number, ConversationLocation>;
+    readonly requests: readonly RequestView[];
+    readonly callSchemas: ReadonlyMap<string, ConversationPromptSnapshot['tools'][number]>;
+    readonly partial: TrajectoryPartialAssistant | null;
+    readonly runningCalls: readonly RunningToolCall[];
+}
+/** Selector hook over the current Conversation binding's Trajectory target. */
+export type UseTrajectory = SnapshotSelectorHook<TrajectorySnapshot>;
+declare module '@qilin-agent/client-ui-conversation/client' {
+    interface ConversationViewSnapshotMap {
+        /** Independently assembled data consumed by the Trajectory view. */
+        trajectory: TrajectorySnapshot;
+    }
+}
+declare module '@qilin-agent/client-ui-slots' {
+    interface SessionStandardProps {
+        /** Selector hook over the current Conversation binding's Trajectory target. */
+        useTrajectory: UseTrajectory;
+    }
+    interface SlotMap {
+        /**
+         * Renderer for one group of durable record images in the Trajectory
+         * ledger. The owner supplies image references, an authorized loader, and
+         * alignment. A registration replaces the shipped gallery; without one,
+         * images are omitted.
+         */
+        'conversation.trajectory.images': {
+            kind: 'single';
+            scope: 'session';
+            owner: MessageImagesOwnerProps;
+        };
+    }
+}
+//# sourceMappingURL=trajectory-contract.d.ts.map

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

@@ -0,0 +1,12 @@
+import type { ConversationNodeContext } from '@qilin-agent/client-ui-conversation/client';
+import type { TrajectoryContribution, TrajectoryConversationViewNode } from './trajectory-contract.ts';
+/**
+ * Wrap one contribution in the Engine-owned target envelope.
+ *
+ * @param context - Context that owns the contribution identity.
+ * @param anchorSeq - Sequence used to order the contribution.
+ * @param data - Trajectory-specific contribution payload.
+ * @returns The contribution wrapped as a Trajectory view node.
+ */
+export declare function trajectoryNode(context: ConversationNodeContext, anchorSeq: number, data: TrajectoryContribution): TrajectoryConversationViewNode;
+//# sourceMappingURL=trajectory-definition-common.d.ts.map

package/lib/types/client/trajectory-event-projection.d.ts

@@ -0,0 +1,51 @@
+/** Trajectory-owned conversion from durable Session events to ledger view data. */
+import type { ContentBlock, StreamChunk } from '@qilin-agent/llm/types';
+import type { AssistantBlock, ContextProducerView, KnownContextForm } from '@qilin-agent/client-ui-conversation/client';
+/**
+ * Read the target-supported presentation form from a durable message source.
+ * @param source - Logged `user/message` source.
+ * @returns Supported form, or null for the opaque presentation.
+ */
+export declare function contextForm(source: unknown): KnownContextForm | null;
+/**
+ * Project a durable message source to the Trajectory row's role and producer label.
+ * @param source - Logged `user/message` source.
+ * @returns Role and label rendered by Trajectory.
+ */
+export declare function contextProducer(source: unknown): ContextProducerView;
+/**
+ * Classify finalized Assistant content for Trajectory rendering.
+ * @param content - Core content blocks.
+ * @returns Trajectory blocks in source order.
+ */
+export declare function toAssistantBlocks(content: readonly ContentBlock[]): AssistantBlock[];
+/**
+ * Classify one finalized Assistant block for Trajectory rendering.
+ * @param block - Core content block.
+ * @returns Trajectory block.
+ */
+export declare function toAssistantBlock(block: ContentBlock): AssistantBlock;
+/**
+ * Create the initial Trajectory block for one streamed Assistant block kind.
+ * @param blockType - Wire block kind.
+ * @returns Empty block ready to receive deltas.
+ */
+export declare function emptyAssistantBlock(blockType: string): AssistantBlock;
+/** Display-safe failure fields retained by Trajectory projections. */
+export interface DisplayFailure {
+    readonly code?: string;
+    readonly message: string;
+}
+/**
+ * Convert a durable failure to locale-independent fields safe for Trajectory.
+ * @param failure - Failure preserved by a Session event.
+ * @returns Sanitized message and optional stable provider code.
+ */
+export declare function displayFailure(failure: unknown): DisplayFailure;
+/**
+ * Whether a stream chunk carries visible model output for Trajectory timing.
+ * @param chunk - Stream chunk to inspect.
+ * @returns true for a non-empty text, reasoning, or Tool-call delta.
+ */
+export declare function isTokenDelta(chunk: StreamChunk): boolean;
+//# sourceMappingURL=trajectory-event-projection.d.ts.map

package/lib/types/client/trajectory-graph-canvas.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Pure playback pacing and canvas-zoom arithmetic for the trajectory graph.
+ *
+ * The replay walks the ledger in the order the events actually happened,
+ * pacing each hop by the recorded timestamps: the gap between two adjacent
+ * records, clamped so a long tool call cannot freeze the replay and a burst
+ * of records cannot blur past, then divided by the selected speed. The zoom
+ * helpers keep the canvas point under the pointer fixed while the scale
+ * changes. The module carries no React and no DOM.
+ */
+import type { TrajectoryTimelineStep } from './trajectory-graph.ts';
+/** Recorded-gap clamp for one replay hop, in milliseconds. */
+export declare const HOP_MIN_MS = 90;
+/** Upper bound of one replay hop's recorded gap, in milliseconds. */
+export declare const HOP_MAX_MS = 1100;
+/** Replay speeds, in the order the speed button cycles them. */
+export declare const REPLAY_SPEEDS: readonly number[];
+/** Zoom bounds for the canvas scale. */
+export declare const ZOOM_MIN = 0.4;
+/** Upper bound of the canvas scale. */
+export declare const ZOOM_MAX = 2.4;
+/** Scale applied per wheel notch. */
+export declare const ZOOM_WHEEL_STEP = 1.1;
+/**
+ * Keep a value inside a closed range.
+ * @param value - the number to confine.
+ * @param min - the inclusive lower bound.
+ * @param max - the inclusive upper bound.
+ * @returns `value` when inside the range, otherwise the violated bound.
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Replay pacing of one hop: the recorded gap to the previous record, clamped
+ * and scaled by the replay speed.
+ * @param timeline - the ledger-order walk with each record's timestamp.
+ * @param index - the hop whose pacing to read.
+ * @param speed - the replay speed divisor.
+ * @returns The delay in milliseconds before the hop's record lights up.
+ */
+export declare function hopDelay(timeline: readonly TrajectoryTimelineStep[], index: number, speed: number): number;
+/**
+ * The next speed in the cycle after the given one.
+ * @param speed - the currently selected replay speed.
+ * @returns The following entry of `REPLAY_SPEEDS`, wrapping to the first.
+ */
+export declare function nextSpeed(speed: number): number;
+/**
+ * Multiplicative zoom step, clamped to the canvas bounds.
+ * @param scale - the current scale.
+ * @param factor - the growth factor; values below 1 shrink.
+ * @returns The new scale inside `ZOOM_MIN`..`ZOOM_MAX`.
+ */
+export declare function zoomedBy(scale: number, factor: number): number;
+/**
+ * The scroll offset that keeps one content point fixed while the scale
+ * changes from `oldScale` to `newScale`.
+ * @param offsetInViewport - distance from the scroller's leading edge to the anchor point.
+ * @param scroll - the scroller's current scroll offset along the same axis.
+ * @param oldScale - the scale the current scroll offset was measured at.
+ * @param newScale - the scale to move to.
+ * @returns The scroll offset that leaves the anchored content point under the same viewport position.
+ */
+export declare function anchoredScroll(offsetInViewport: number, scroll: number, oldScale: number, newScale: number): number;
+//# sourceMappingURL=trajectory-graph-canvas.d.ts.map

package/lib/types/client/trajectory-graph-inspector.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Presentation helpers for the trajectory graph's record inspector: the
+ * ordered attachment rows (localized names and recorded metadata) and the
+ * pretty-printed JSON the arguments disclosure renders.
+ */
+import type { TrajectoryTranslate } from './locales.ts';
+import type { TrajectoryAttachment } from './trajectory-graph.ts';
+/** One inspector attachment row's resolved copy. */
+export interface AttachmentPresentation {
+    readonly kind: 'image' | 'file';
+    /** Recorded name, or the localized ordinal/backup label. */
+    readonly name: string;
+    /** One line of recorded metadata: size, media type, dimensions, offload marker. */
+    readonly meta: string;
+}
+/**
+ * Resolve one attachment's display copy.
+ * @param attachment - the recorded reference.
+ * @param ordinal - one-based position among this record's attachments, for unnamed images.
+ * @param t - namespace-bound translate for the backup and metadata labels.
+ * @returns The row's kind, name, and metadata line (empty when nothing was recorded).
+ */
+export declare function attachmentPresentation(attachment: TrajectoryAttachment, ordinal: number, t: TrajectoryTranslate): AttachmentPresentation;
+/**
+ * Pretty-print a JSON payload for the collapsible arguments disclosure.
+ * @param raw - the recorded payload, verbatim.
+ * @returns The payload re-printed with two-space indent, or the raw text when it is not JSON.
+ */
+export declare function prettyJson(raw: string): string;
+//# sourceMappingURL=trajectory-graph-inspector.d.ts.map