@apolloyh/apollo-agent 0.1.10 → 0.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -55,6 +55,7 @@ Commands: `/help` · `/skill` · `/simplify` · `/verify` · `/debug` · `/agent
55
55
 
56
56
  - [完整使用指南](docs/guide.md)
57
57
  - [SDK 接入指南](docs/sdk.md)
58
+ - [npm 打包与发布手册](docs/npm-release.md)
58
59
  - [高级功能与恢复机制](docs/features-cc.md)
59
60
 
60
61
  ## SDK
package/dist/brand.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  /** Product identity — single source of truth for display strings. */
2
2
  export declare const PRODUCT: {
3
3
  readonly name: "Apollo";
4
- readonly version: "0.1.10";
4
+ readonly version: "0.1.11";
5
5
  readonly tagline: "Your personal agent — answer first, act when needed.";
6
6
  readonly packageName: "@apolloyh/apollo-agent";
7
7
  readonly userAgent: "ApolloAgent/0.1";
package/dist/brand.js CHANGED
@@ -1,7 +1,7 @@
1
1
  /** Product identity — single source of truth for display strings. */
2
2
  export const PRODUCT = {
3
3
  name: "Apollo",
4
- version: "0.1.10",
4
+ version: "0.1.11",
5
5
  tagline: "Your personal agent — answer first, act when needed.",
6
6
  packageName: "@apolloyh/apollo-agent",
7
7
  userAgent: "ApolloAgent/0.1",
package/dist/index.js CHANGED
@@ -21,6 +21,7 @@ let liveStatus;
21
21
  let runningTaskCount = 0;
22
22
  let activeVerb = "Thinking";
23
23
  let assistantResponseStarted = false;
24
+ let liveThinkingPreview = "";
24
25
  /** Prevent double green/red outcome lines in one user turn */
25
26
  let outcomePrintedThisTurn = false;
26
27
  let pastedTextSequence = 0;
@@ -97,31 +98,19 @@ async function main() {
97
98
  // never reaches the interactive `runtime` binding). Also lets SIGINT close whichever is active.
98
99
  let activeRuntime;
99
100
  const traceSink = (event) => {
100
- // Collect process into collapsible Thought (always, even when quiet)
101
+ let completedThought = null;
102
+ // Collect only model thinking tokens into the collapsible Thought.
101
103
  if (event.type === "llm_request") {
102
104
  thoughtFold.beginTurn();
103
- thoughtFold.note(`turn ${event.turn} · ${event.toolCount} tools available`);
104
105
  }
105
- else if (event.type === "llm_retry") {
106
- thoughtFold.note(`retry ${event.attempt} · ${event.mode} · ${event.reason}`);
107
- }
108
- else if (event.type === "tool_call") {
109
- thoughtFold.noteTool(event.tool);
110
- }
111
- else if (event.type === "tool_result") {
112
- thoughtFold.note(`${event.tool} ${event.isError ? "failed" : "ok"}`);
113
- }
114
- else if (event.type === "task_start") {
115
- thoughtFold.note(`Task(${event.subagentType}): ${event.description}`);
116
- }
117
- else if (event.type === "task_finish") {
118
- thoughtFold.note(`Task(${event.subagentType}) finished`);
106
+ else if (event.type === "thinking_delta") {
107
+ thoughtFold.appendThinking(event.text);
119
108
  }
120
109
  else if (event.type === "assistant_delta") {
121
- thoughtFold.finalizeAndPrint();
110
+ completedThought = thoughtFold.finalizeAndPrint();
122
111
  }
123
112
  else if (event.type === "llm_response" && event.stopReason !== "tool_use") {
124
- thoughtFold.finalizeAndPrint();
113
+ completedThought = thoughtFold.finalizeAndPrint();
125
114
  }
126
115
  if (event.type === "workflow_status") {
127
116
  const bar = workflowStatusBar({
@@ -166,6 +155,8 @@ async function main() {
166
155
  if (renderBeforeStatus)
167
156
  rendererSink(event);
168
157
  updateLiveStatus(event, interactiveMode);
158
+ if (interactiveMode && completedThought)
159
+ thoughtFold.printPreview(completedThought);
169
160
  taskActivity.record(event);
170
161
  if (!renderBeforeStatus)
171
162
  rendererSink(event);
@@ -513,10 +504,6 @@ async function main() {
513
504
  stdout.write(notes.map((n) => `- ${n.id} ${n.title}\n ${n.content.slice(0, 120).replace(/\n/g, " ")}`).join("\n") + "\n");
514
505
  continue;
515
506
  }
516
- if (text === "/thought" || text === "/think" || text === "/t") {
517
- thoughtFold.toggle();
518
- continue;
519
- }
520
507
  if (text.startsWith("/verbose")) {
521
508
  const value = text.split(/\s+/)[1];
522
509
  traceOptions.verbose = value === "on" ? true : value === "off" ? false : !traceOptions.verbose;
@@ -756,8 +743,19 @@ function updateLiveStatus(event, enabled) {
756
743
  switch (event.type) {
757
744
  case "llm_request":
758
745
  assistantResponseStarted = false;
746
+ liveThinkingPreview = "";
759
747
  startLiveStatus(runningTaskCount > 0 ? formatRunningTasks() : activeVerb);
760
748
  break;
749
+ case "thinking_delta": {
750
+ liveThinkingPreview = stripTerminalEscapes(`${liveThinkingPreview}${event.text}`)
751
+ .replace(/\s+/g, " ")
752
+ .trimStart()
753
+ .slice(0, 1000);
754
+ if (liveStatus)
755
+ liveStatus.text = "Thinking";
756
+ paintLiveStatus();
757
+ break;
758
+ }
761
759
  case "llm_retry":
762
760
  startLiveStatus(event.mode === "after-compaction"
763
761
  ? "Retrying after compaction"
@@ -1038,6 +1036,9 @@ async function readCliLine(options) {
1038
1036
  const liveStatusLine = renderLiveStatusLine(options.color);
1039
1037
  if (liveStatusLine)
1040
1038
  lines.push(liveStatusLine);
1039
+ if (liveStatus?.text === "Thinking" && liveThinkingPreview) {
1040
+ lines.push(...renderLiveThinkingLines(liveThinkingPreview, options.color));
1041
+ }
1041
1042
  lines.push(renderInputBorder("top", options.color));
1042
1043
  const view = renderInputView(buffer, cursor, inputContentWidth(), pastedTextBlocks);
1043
1044
  const idleQueue = options.queueMode && !buffer;
@@ -1614,6 +1615,37 @@ function renderLiveStatusLine(useColor) {
1614
1615
  : `${liveStatus.text}...`;
1615
1616
  return formatWaitLine({ frame: liveStatus.frame, label, elapsed, useColor });
1616
1617
  }
1618
+ function renderLiveThinkingLines(value, useColor) {
1619
+ const prefixWidth = 4;
1620
+ const width = Math.max(24, Math.min((stdout.columns ?? 100) - prefixWidth, 96));
1621
+ const lines = [];
1622
+ let current = "";
1623
+ let currentWidth = 0;
1624
+ let consumed = 0;
1625
+ const characters = Array.from(value);
1626
+ for (const char of characters) {
1627
+ const charWidth = displayLength(char);
1628
+ if (current && currentWidth + charWidth > width) {
1629
+ lines.push(current);
1630
+ if (lines.length === 3)
1631
+ break;
1632
+ current = "";
1633
+ currentWidth = 0;
1634
+ }
1635
+ current += char;
1636
+ currentWidth += charWidth;
1637
+ consumed += 1;
1638
+ }
1639
+ if (lines.length < 3 && current)
1640
+ lines.push(current);
1641
+ if (consumed < characters.length && lines.length) {
1642
+ const last = truncateDisplay(lines[lines.length - 1], Math.max(1, width - 1)).replace(/…$/, "");
1643
+ lines[lines.length - 1] = `${last}…`;
1644
+ }
1645
+ const dim = useColor ? "\x1b[90m" : "";
1646
+ const reset = useColor ? "\x1b[0m" : "";
1647
+ return lines.map((line, index) => `${dim}${index === 0 ? " └ " : " "}${line}${reset}`);
1648
+ }
1617
1649
  function renderInputBorder(position, useColor) {
1618
1650
  const terminalWidth = Math.max(48, Math.min(stdout.columns ?? 100, 100));
1619
1651
  const left = position === "top" ? "╭" : "╰";
@@ -1641,7 +1673,7 @@ function renderWelcomeBanner(options) {
1641
1673
  `${dim}trace${reset} ${options.quiet ? "quiet" : "verbose"}`,
1642
1674
  `${dim}approval${reset} ${options.yolo ? `${green}yolo${reset}` : "ask"}`,
1643
1675
  "",
1644
- `${dim}Type / to search · /thought expands Thought · /help${reset}`,
1676
+ `${dim}Type / to search · /help${reset}`,
1645
1677
  "",
1646
1678
  "",
1647
1679
  ].join("\n");
@@ -18,6 +18,9 @@ export type ToolInputDelta = {
18
18
  tool?: string;
19
19
  detail?: string;
20
20
  };
21
+ export type ThinkingDelta = {
22
+ text: string;
23
+ };
21
24
  export declare class MalformedStreamError extends Error {
22
25
  constructor(message: string, cause?: unknown);
23
26
  }
@@ -40,6 +43,7 @@ export declare class AnthropicClient {
40
43
  stream?: boolean;
41
44
  signal?: AbortSignal;
42
45
  onTextDelta?: (text: string) => void;
46
+ onThinkingDelta?: (event: ThinkingDelta) => void;
43
47
  onToolInputDelta?: (event: ToolInputDelta) => void;
44
48
  }): Promise<AnthropicResponse>;
45
49
  }
@@ -1 +1 @@
1
- {"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/llm/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,EAAE,MAAM,CAAC;IACpC,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAMF,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,uBAAwB,SAAQ,oBAAoB;gBACnD,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAIxD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,MAAM,EAAE,MAAM;aACd,YAAY,EAAE,MAAM;aACpB,eAAe,EAAE,OAAO;gBAFxB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,OAAO;CAK3C;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAExC,aAAa,CAAC,KAAK,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,KAAK,EAAE,aAAa,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QACrC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;KACpD,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAqC/B"}
1
+ {"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/llm/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,EAAE,MAAM,CAAC;IACpC,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAOF,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/E,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,uBAAwB,SAAQ,oBAAoB;gBACnD,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAIxD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,MAAM,EAAE,MAAM;aACd,YAAY,EAAE,MAAM;aACpB,eAAe,EAAE,OAAO;gBAFxB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,OAAO;CAK3C;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAExC,aAAa,CAAC,KAAK,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,KAAK,EAAE,aAAa,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QACrC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;QACjD,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;KACpD,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAsC/B"}
@@ -48,6 +48,7 @@ export class AnthropicClient {
48
48
  cache_control: this.config.cacheTtl === "1h"
49
49
  ? { type: "ephemeral", ttl: "1h" }
50
50
  : { type: "ephemeral" },
51
+ ...(supportsThinking(this.config) ? { thinking: { type: "enabled" } } : {}),
51
52
  stream: input.stream ?? false,
52
53
  }),
53
54
  signal: input.signal
@@ -59,12 +60,12 @@ export class AnthropicClient {
59
60
  throw new AnthropicApiError(response.status, errorText, response.headers);
60
61
  }
61
62
  if (input.stream) {
62
- return readStreamingResponse(response, input.onTextDelta, input.onToolInputDelta);
63
+ return readStreamingResponse(response, input.onTextDelta, input.onToolInputDelta, input.onThinkingDelta);
63
64
  }
64
65
  return (await response.json());
65
66
  }
66
67
  }
67
- async function readStreamingResponse(response, onTextDelta, onToolInputDelta) {
68
+ async function readStreamingResponse(response, onTextDelta, onToolInputDelta, onThinkingDelta) {
68
69
  if (!response.body)
69
70
  throw new Error("Anthropic API returned an empty stream body.");
70
71
  const reader = response.body.getReader();
@@ -100,7 +101,7 @@ async function readStreamingResponse(response, onTextDelta, onToolInputDelta) {
100
101
  stopReason = reason;
101
102
  }, (part) => {
102
103
  usage = mergeUsage(usage, part);
103
- }, onTextDelta, onToolInputDelta);
104
+ }, onTextDelta, onToolInputDelta, onThinkingDelta);
104
105
  }
105
106
  separator = buffer.match(/\r?\n\r?\n/);
106
107
  }
@@ -119,7 +120,7 @@ async function readStreamingResponse(response, onTextDelta, onToolInputDelta) {
119
120
  stopReason = reason;
120
121
  }, (part) => {
121
122
  usage = mergeUsage(usage, part);
122
- }, onTextDelta, onToolInputDelta);
123
+ }, onTextDelta, onToolInputDelta, onThinkingDelta);
123
124
  }
124
125
  }
125
126
  if (blocks.size === 0) {
@@ -161,7 +162,7 @@ function parseStreamEvent(data) {
161
162
  throw new MalformedStreamError("Model returned malformed JSON in the event stream.", error);
162
163
  }
163
164
  }
164
- function applyStreamEvent(event, blocks, setResponseId, setStopReason, setUsage, onTextDelta, onToolInputDelta) {
165
+ function applyStreamEvent(event, blocks, setResponseId, setStopReason, setUsage, onTextDelta, onToolInputDelta, onThinkingDelta) {
165
166
  if (event.type === "message_start") {
166
167
  const message = event.message;
167
168
  if (message?.id)
@@ -186,6 +187,13 @@ function applyStreamEvent(event, blocks, setResponseId, setStopReason, setUsage,
186
187
  if (contentBlock.type === "text") {
187
188
  blocks.set(index, { type: "text", text: contentBlock.text ?? "" });
188
189
  }
190
+ else if (contentBlock.type === "thinking") {
191
+ blocks.set(index, {
192
+ type: "thinking",
193
+ thinking: contentBlock.thinking ?? "",
194
+ signature: contentBlock.signature,
195
+ });
196
+ }
189
197
  else if (contentBlock.type === "tool_use") {
190
198
  const block = {
191
199
  type: "tool_use",
@@ -203,12 +211,26 @@ function applyStreamEvent(event, blocks, setResponseId, setStopReason, setUsage,
203
211
  const index = Number(event.index);
204
212
  const block = blocks.get(index);
205
213
  const delta = event.delta;
206
- if (!block || !delta)
214
+ if (!delta)
215
+ return;
216
+ const publicThinking = delta.type === "summary_delta"
217
+ ? delta.summary
218
+ : delta.type === "reasoning_delta" || delta.type === "reasoning_summary_delta"
219
+ ? (delta.reasoning_summary ?? delta.reasoning)
220
+ : delta.type === "thinking_delta"
221
+ ? delta.thinking
222
+ : undefined;
223
+ if (publicThinking)
224
+ onThinkingDelta?.({ text: publicThinking });
225
+ if (!block)
207
226
  return;
208
227
  if (block.type === "text" && delta.type === "text_delta" && delta.text) {
209
228
  block.text += delta.text;
210
229
  onTextDelta?.(delta.text);
211
230
  }
231
+ else if (block.type === "thinking" && delta.type === "thinking_delta" && delta.thinking) {
232
+ block.thinking += delta.thinking;
233
+ }
212
234
  else if (block.type === "tool_use" && delta.type === "input_json_delta" && delta.partial_json) {
213
235
  block.inputJson += delta.partial_json;
214
236
  block.detail ??= partialToolDetail(block.inputJson);
@@ -258,7 +280,7 @@ function mergeUsage(current, part) {
258
280
  }, { ...next });
259
281
  }
260
282
  function finalizeStreamBlock(block) {
261
- if (block.type === "text")
283
+ if (block.type === "text" || block.type === "thinking")
262
284
  return block;
263
285
  let input = {};
264
286
  if (block.inputJson.trim()) {
@@ -276,3 +298,6 @@ function finalizeStreamBlock(block) {
276
298
  input,
277
299
  };
278
300
  }
301
+ function supportsThinking(config) {
302
+ return /(?:^glm-|bigmodel\.cn)/i.test(`${config.model} ${config.baseUrl}`);
303
+ }
@@ -79,6 +79,13 @@ export declare class QueryEngine {
79
79
  conversationSize(): number;
80
80
  getUsageStats(): UsageStats;
81
81
  getCacheMode(): string;
82
+ getRuntimeInfo(): {
83
+ model: string;
84
+ baseUrl: string;
85
+ maxTokens: number;
86
+ contextMaxChars: number;
87
+ workspaceRoot: string;
88
+ };
82
89
  close(): Promise<void>;
83
90
  ensureSession(title?: string): Promise<SessionSnapshot>;
84
91
  saveCurrentSession(): Promise<string | null>;
@@ -1 +1 @@
1
- {"version":3,"file":"query-engine.d.ts","sourceRoot":"","sources":["../../src/runtime/query-engine.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"query-engine.d.ts","sourceRoot":"","sources":["../../src/runtime/query-engine.ts"],"names":[],"mappings":"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"}
@@ -133,6 +133,15 @@ export class QueryEngine {
133
133
  }
134
134
  return `Anthropic-compatible (${this.options.llmConfig.cacheTtl ?? "5m"} requested)`;
135
135
  }
136
+ getRuntimeInfo() {
137
+ return {
138
+ model: this.options.llmConfig.model,
139
+ baseUrl: this.options.llmConfig.baseUrl,
140
+ maxTokens: this.options.llmConfig.maxTokens,
141
+ contextMaxChars: this.options.agentConfig.context.maxChars,
142
+ workspaceRoot: this.options.agentConfig.workspaceRoot,
143
+ };
144
+ }
136
145
  async close() {
137
146
  await this.mcpManager.closeAll();
138
147
  }
@@ -526,12 +535,18 @@ export class QueryEngine {
526
535
  streamedText += text;
527
536
  this.options.emit({ type: "assistant_delta", text });
528
537
  };
538
+ const onThinkingDelta = isSubagent
539
+ ? undefined
540
+ : (event) => {
541
+ this.options.emit({ type: "thinking_delta", text: event.text });
542
+ };
529
543
  const buildRequest = (useStream) => ({
530
544
  system: prompt,
531
545
  messages: this.messages,
532
546
  tools: toolDefinitions,
533
547
  stream: useStream,
534
548
  onTextDelta: useStream ? onTextDelta : undefined,
549
+ onThinkingDelta: useStream ? onThinkingDelta : undefined,
535
550
  onToolInputDelta: useStream && !isSubagent
536
551
  ? (event) => {
537
552
  const now = Date.now();
@@ -1,19 +1,10 @@
1
1
  /**
2
- * Terminal collapsible Thought blocks (like web ProcessTimeline).
3
- * Default: one line “◆ Thought for 0.5s ▸”
4
- * Expand: /thought or key `t` → show detail lines under it.
2
+ * Bounded terminal preview for model thinking tokens.
5
3
  */
6
4
  export type ThoughtBlock = {
7
- id: string;
8
5
  startedAt: number;
9
6
  endedAt?: number;
10
- /** Short lines shown when expanded */
11
- lines: string[];
12
- tools: string[];
13
- expanded: boolean;
14
- /** Printed to terminal already (collapsed header) */
15
- printed: boolean;
16
- /** true if turn failed */
7
+ thinking: string;
17
8
  failed?: boolean;
18
9
  };
19
10
  export type ThoughtFoldOptions = {
@@ -21,28 +12,22 @@ export type ThoughtFoldOptions = {
21
12
  out: (text: string) => void;
22
13
  };
23
14
  export declare class ThoughtFoldManager {
24
- private blocks;
25
15
  private current;
26
16
  private options;
27
17
  constructor(options: ThoughtFoldOptions);
28
18
  setColor(color: boolean): void;
29
19
  /** Start a new thought window for this user turn. */
30
20
  beginTurn(): void;
31
- note(line: string): void;
32
- noteTool(tool: string): void;
21
+ appendThinking(text: string): void;
22
+ printPreview(block: ThoughtBlock, maxChars?: number): void;
33
23
  /**
34
- * Finalize current thought and print collapsed header (once).
24
+ * Finalize current thought and optionally print a failure header.
35
25
  * Call before streaming the final answer, or at end of turn.
36
26
  */
37
- finalizeAndPrint(defaultDetail?: string, failed?: boolean, printHeader?: boolean): ThoughtBlock | null;
38
- /** Toggle expand/collapse of the last thought (or by id). */
39
- toggle(id?: string): void;
40
- expandLast(): void;
41
- lastSummary(): string | null;
27
+ finalizeAndPrint(_defaultDetail?: string, failed?: boolean, printHeader?: boolean): ThoughtBlock | null;
42
28
  clear(): void;
43
29
  private duration;
44
30
  private printHeader;
45
- private printExpanded;
46
31
  private dim;
47
32
  }
48
33
  //# sourceMappingURL=thought-fold.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"thought-fold.d.ts","sourceRoot":"","sources":["../src/thought-fold.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,CAAC;AAQF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,EAAE,kBAAkB;IAIvC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,qDAAqD;IACrD,SAAS,IAAI,IAAI;IAWjB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM5B;;;OAGG;IACH,gBAAgB,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,UAAQ,EAAE,WAAW,UAAQ,GAAG,YAAY,GAAG,IAAI;IA0BlG,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBzB,UAAU,IAAI,IAAI;IAclB,WAAW,IAAI,MAAM,GAAG,IAAI;IAO5B,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,GAAG;CAIZ"}
1
+ {"version":3,"file":"thought-fold.d.ts","sourceRoot":"","sources":["../src/thought-fold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,CAAC;AAOF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,EAAE,kBAAkB;IAIvC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,qDAAqD;IACrD,SAAS,IAAI,IAAI;IAQjB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,SAAM,GAAG,IAAI;IAevD;;;OAGG;IACH,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,UAAQ,EAAE,WAAW,UAAQ,GAAG,YAAY,GAAG,IAAI;IAWnG,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,GAAG;CAIZ"}
@@ -1,15 +1,12 @@
1
1
  /**
2
- * Terminal collapsible Thought blocks (like web ProcessTimeline).
3
- * Default: one line “◆ Thought for 0.5s ▸”
4
- * Expand: /thought or key `t` → show detail lines under it.
2
+ * Bounded terminal preview for model thinking tokens.
5
3
  */
4
+ import { stripTerminalEscapes } from "./trace.js";
6
5
  const DIM = "\x1b[90m";
7
6
  const RESET = "\x1b[0m";
8
- const AMBER = "\x1b[38;2;251;191;36m";
9
7
  const GREEN = "\x1b[32m";
10
8
  const RED = "\x1b[31m";
11
9
  export class ThoughtFoldManager {
12
- blocks = [];
13
10
  current = null;
14
11
  options;
15
12
  constructor(options) {
@@ -20,103 +17,47 @@ export class ThoughtFoldManager {
20
17
  }
21
18
  /** Start a new thought window for this user turn. */
22
19
  beginTurn() {
20
+ if (this.current)
21
+ return;
23
22
  this.current = {
24
- id: `th-${Date.now()}`,
25
23
  startedAt: Date.now(),
26
- lines: [],
27
- tools: [],
28
- expanded: false,
29
- printed: false,
24
+ thinking: "",
30
25
  };
31
26
  }
32
- note(line) {
33
- if (!this.current)
34
- return;
35
- const t = line.trim();
36
- if (!t)
37
- return;
38
- // de-dupe consecutive
39
- if (this.current.lines[this.current.lines.length - 1] === t)
27
+ appendThinking(text) {
28
+ if (!this.current || !text)
40
29
  return;
41
- this.current.lines.push(t);
30
+ this.current.thinking = `${this.current.thinking}${text}`.slice(-6000);
42
31
  }
43
- noteTool(tool) {
44
- if (!this.current)
32
+ printPreview(block, maxChars = 300) {
33
+ const characters = Array.from(stripTerminalEscapes(block.thinking).replace(/\s+/g, " ").trim());
34
+ if (!characters.length)
45
35
  return;
46
- if (!this.current.tools.includes(tool))
47
- this.current.tools.push(tool);
48
- this.note(`used ${tool}`);
36
+ const visible = characters.slice(0, maxChars);
37
+ for (let index = 0; index < visible.length; index += 100) {
38
+ const line = visible.slice(index, index + 100).join("");
39
+ this.options.out(this.dim(`${index === 0 ? " └ " : " "}${line}\n`));
40
+ }
41
+ if (characters.length > maxChars) {
42
+ this.options.out(this.dim(" … more hidden\n"));
43
+ }
49
44
  }
50
45
  /**
51
- * Finalize current thought and print collapsed header (once).
46
+ * Finalize current thought and optionally print a failure header.
52
47
  * Call before streaming the final answer, or at end of turn.
53
48
  */
54
- finalizeAndPrint(defaultDetail, failed = false, printHeader = false) {
49
+ finalizeAndPrint(_defaultDetail, failed = false, printHeader = false) {
55
50
  if (!this.current)
56
51
  return null;
57
- if (this.current.printed)
58
- return this.current;
59
52
  this.current.endedAt = Date.now();
60
53
  this.current.failed = failed;
61
- if (this.current.lines.length === 0 && defaultDetail) {
62
- this.current.lines.push(defaultDetail);
63
- }
64
- if (this.current.lines.length === 0) {
65
- this.current.lines.push("Processed the request and prepared a reply.");
66
- }
67
- this.blocks.push(this.current);
68
- // Only the most recent block is ever toggled/expanded; cap history so a long-lived
69
- // interactive session doesn't grow this array (and its retained lines) without bound.
70
- if (this.blocks.length > 50)
71
- this.blocks.splice(0, this.blocks.length - 50);
72
- if (printHeader) {
54
+ if (printHeader)
73
55
  this.printHeader(this.current);
74
- this.current.printed = true;
75
- }
76
56
  const done = this.current;
77
57
  this.current = null;
78
58
  return done;
79
59
  }
80
- /** Toggle expand/collapse of the last thought (or by id). */
81
- toggle(id) {
82
- const block = id
83
- ? this.blocks.find((b) => b.id === id)
84
- : this.blocks[this.blocks.length - 1];
85
- if (!block) {
86
- this.options.out(this.dim("(no thought to expand yet)\n"));
87
- return;
88
- }
89
- block.expanded = !block.expanded;
90
- if (block.expanded) {
91
- this.printExpanded(block);
92
- }
93
- else {
94
- this.options.out(this.dim(" (thought collapsed — /thought to expand again)\n"));
95
- }
96
- }
97
- expandLast() {
98
- const block = this.blocks[this.blocks.length - 1];
99
- if (!block) {
100
- this.options.out(this.dim("(no thought to expand yet)\n"));
101
- return;
102
- }
103
- if (!block.expanded) {
104
- block.expanded = true;
105
- this.printExpanded(block);
106
- }
107
- else {
108
- this.printExpanded(block); // re-print
109
- }
110
- }
111
- lastSummary() {
112
- const b = this.blocks[this.blocks.length - 1];
113
- if (!b)
114
- return null;
115
- const sec = ((b.endedAt ?? Date.now()) - b.startedAt) / 1000;
116
- return `Thought for ${sec.toFixed(1)}s · ${b.tools.length} tools · ${b.expanded ? "expanded" : "collapsed"}`;
117
- }
118
60
  clear() {
119
- this.blocks = [];
120
61
  this.current = null;
121
62
  }
122
63
  duration(block) {
@@ -124,29 +65,13 @@ export class ThoughtFoldManager {
124
65
  return `${(ms / 1000).toFixed(1)}s`;
125
66
  }
126
67
  printHeader(block) {
127
- const arrow = block.expanded ? "▾" : "▸";
128
- // CC style: green ● success, red ● failure (not amber while done)
129
68
  const color = block.failed ? RED : GREEN;
130
69
  const dot = this.options.color ? `${color}●${RESET}` : "●";
131
70
  const label = block.failed
132
71
  ? `Failed · ${this.duration(block)}`
133
72
  : `Thought for ${this.duration(block)}`;
134
73
  const labelPainted = this.options.color ? `${color}${label}${RESET}` : label;
135
- const hint = this.dim(` ${arrow} /thought to expand`);
136
- this.options.out(`\n${dot} ${labelPainted}${hint}\n`);
137
- }
138
- printExpanded(block) {
139
- const color = block.failed ? RED : GREEN;
140
- const dot = this.options.color ? `${color}●${RESET}` : "●";
141
- const head = block.failed ? `Failed · ${this.duration(block)}` : `Thought for ${this.duration(block)}`;
142
- this.options.out(`\n${dot} ${head} ▾\n`);
143
- if (block.tools.length) {
144
- this.options.out(this.dim(` tools: ${block.tools.join(", ")}\n`));
145
- }
146
- for (const line of block.lines) {
147
- this.options.out(this.dim(` │ ${line}\n`));
148
- }
149
- this.options.out(this.dim(" └ /thought to collapse\n\n"));
74
+ this.options.out(`\n${dot} ${labelPainted}\n`);
150
75
  }
151
76
  dim(text) {
152
77
  if (!this.options.color)
@@ -1 +1 @@
1
- {"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiBxD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,qBAAa,gBAAgB;IAiBf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhBpC,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,mBAAmB,CAAM;IACjC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAoE;gBAE1D,OAAO,EAAE,eAAe;IAErD,IAAI,IAAI,SAAS;IAIjB,SAAS,IAAI,IAAI;IAajB,UAAU,IAAI,IAAI;IAelB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IA6H/B,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAUlB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAsBtB,yEAAyE;IACzE,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,2BAA2B;IAgBnC,OAAO,CAAC,gBAAgB;IAwCxB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,GAAG;CAKZ;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAOxD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAO9D;AA4ED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY1D"}
1
+ {"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiBxD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,qBAAa,gBAAgB;IAiBf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhBpC,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,mBAAmB,CAAM;IACjC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAoE;gBAE1D,OAAO,EAAE,eAAe;IAErD,IAAI,IAAI,SAAS;IAIjB,SAAS,IAAI,IAAI;IAajB,UAAU,IAAI,IAAI;IAelB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IA6H/B,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAUlB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAsBtB,yEAAyE;IACzE,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,gBAAgB;IAwCxB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,GAAG;CAKZ;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAOxD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAO9D;AA4ED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY1D"}
package/dist/trace.js CHANGED
@@ -280,14 +280,12 @@ export class CliTraceRenderer {
280
280
  }
281
281
  renderInteractiveToolResult(event, denied) {
282
282
  this.bullet(formatInteractiveToolResult(event.tool, event.content, event.isError, event.input), denied ? "yellow" : event.isError ? "red" : "green");
283
- if (event.tool !== "shell_exec" || event.isError || event.content === "(no output)")
283
+ if (event.isError || event.content === "(no output)")
284
284
  return;
285
- const lines = stripTerminalEscapes(event.content).split(/\r?\n/);
286
- for (const [index, line] of lines.slice(0, 6).entries()) {
285
+ const lines = toolOutputLines(event.tool, event.content);
286
+ for (const [index, line] of lines.entries()) {
287
287
  this.out(` ${this.paint(index === 0 ? "└" : " ", "gray")} ${this.paint(truncateDisplayLine(line, 140), "gray")}\n`);
288
288
  }
289
- if (lines.length > 6)
290
- this.out(` ${this.paint(`… +${lines.length - 6} lines`, "gray")}\n`);
291
289
  }
292
290
  renderCodeChange(change) {
293
291
  const width = Math.max(40, Math.min(this.options.stdout?.columns ?? 120, 160));
@@ -597,6 +595,22 @@ function toolLabel(tool) {
597
595
  .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)
598
596
  .join(" ");
599
597
  }
598
+ function toolOutputLines(tool, content) {
599
+ if (tool === "web_search") {
600
+ try {
601
+ const results = JSON.parse(content).results ?? [];
602
+ return results.slice(0, 5).map((result) => [result.title, result.url].filter(Boolean).join(" — "));
603
+ }
604
+ catch {
605
+ return [compactValue(content, 140)];
606
+ }
607
+ }
608
+ const lines = stripTerminalEscapes(content).split(/\r?\n/);
609
+ const visible = lines.slice(0, 6);
610
+ if (lines.length > 6)
611
+ visible.push(`… +${lines.length - 6} lines`);
612
+ return visible;
613
+ }
600
614
  function isPermissionDenied(content) {
601
615
  return content.startsWith("Permission denied for tool ");
602
616
  }
package/dist/types.d.ts CHANGED
@@ -2,6 +2,10 @@ export type JsonObject = Record<string, unknown>;
2
2
  export type ContentBlock = {
3
3
  type: "text";
4
4
  text: string;
5
+ } | {
6
+ type: "thinking";
7
+ thinking: string;
8
+ signature?: string;
5
9
  } | {
6
10
  type: "tool_use";
7
11
  id: string;
@@ -59,6 +63,9 @@ export type TraceEvent = {
59
63
  } | {
60
64
  type: "assistant_delta";
61
65
  text: string;
66
+ } | {
67
+ type: "thinking_delta";
68
+ text: string;
62
69
  } | {
63
70
  type: "llm_tool_delta";
64
71
  bytes: number;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,251 @@
1
+ # Apollo npm 打包与发布手册
2
+
3
+ 本文说明如何把 `@apolloyh/apollo-agent` 构建为 npm tarball、发布到 npm,并把同一份 tarball 上传到 GitHub Release。
4
+
5
+ ## 前置条件
6
+
7
+ - Node.js 20 或更高版本
8
+ - npm 发布账号拥有 `@apolloyh/apollo-agent` 权限
9
+ - npm 已登录:`npm whoami`
10
+ - GitHub CLI 已登录:`gh auth status`
11
+ - 工作目录为 Apollo 仓库的 `agent/`
12
+
13
+ 不要把 npm token、模型密钥、`.env` 或用户配置提交到仓库或放进安装包。
14
+
15
+ ## 1. 确定新版本号
16
+
17
+ 先查看 registry 当前版本:
18
+
19
+ ```bash
20
+ npm view @apolloyh/apollo-agent version dist-tags.latest --json --prefer-online
21
+ ```
22
+
23
+ npm 不允许覆盖已经发布的同名版本。按语义化版本选择升级类型:
24
+
25
+ ```bash
26
+ npm version patch --no-git-tag-version # 0.1.10 -> 0.1.11
27
+ npm version minor --no-git-tag-version # 0.1.10 -> 0.2.0
28
+ npm version major --no-git-tag-version # 0.1.10 -> 1.0.0
29
+ ```
30
+
31
+ 该命令会更新 `package.json` 和 `package-lock.json`。Apollo 还在 `src/brand.ts` 中显示版本号,必须同步修改:
32
+
33
+ ```ts
34
+ export const PRODUCT = {
35
+ version: "0.1.11",
36
+ // ...
37
+ };
38
+ ```
39
+
40
+ 确认三处一致:
41
+
42
+ ```bash
43
+ node -p "require('./package.json').version"
44
+ node -p "require('./package-lock.json').version"
45
+ rg 'version:' src/brand.ts
46
+ ```
47
+
48
+ ## 2. 构建与验证
49
+
50
+ ```bash
51
+ npm run typecheck
52
+ npm test
53
+ git diff --check
54
+ git status --short
55
+ ```
56
+
57
+ `npm test` 会先清理并重新生成 `dist/`,然后执行回归测试。发布前必须确认测试全部通过,并检查工作区没有混入无关修改或秘密。
58
+
59
+ ## 3. 打包 tarball
60
+
61
+ Apollo 将历史安装包集中在 `releases/npm-packages/`。直接输出到该目录:
62
+
63
+ ```bash
64
+ mkdir -p releases/npm-packages
65
+ npm pack --json --pack-destination releases/npm-packages
66
+ ```
67
+
68
+ `prepack` 会再次运行构建。生成文件形如:
69
+
70
+ ```text
71
+ releases/npm-packages/apolloyh-apollo-agent-0.1.11.tgz
72
+ ```
73
+
74
+ 检查包内容:
75
+
76
+ ```bash
77
+ tar -tzf releases/npm-packages/apolloyh-apollo-agent-0.1.11.tgz
78
+ ```
79
+
80
+ 重点确认包含:
81
+
82
+ - `dist/`
83
+ - `bundled-skills/`
84
+ - `README.md`
85
+ - `docs/`
86
+ - `.apollo/config.example.json`
87
+ - `.apollo/hooks.example.json`
88
+ - `.env.example`
89
+
90
+ 同时确认不包含:
91
+
92
+ - `.env`、API key、token
93
+ - `node_modules/`
94
+ - `.apollo/config.json`、sessions、memory、logs
95
+ - 用户工作区的 `skills/`
96
+ - 源码仓库中无关的大文件
97
+
98
+ 可先使用 `npm pack --dry-run` 只预览,不生成 tarball:
99
+
100
+ ```bash
101
+ npm pack --dry-run
102
+ ```
103
+
104
+ ## 4. 本地安装冒烟测试
105
+
106
+ 在临时目录安装刚生成的真实 tarball:
107
+
108
+ ```bash
109
+ VERSION=$(node -p "require('./package.json').version")
110
+ TARBALL="releases/npm-packages/apolloyh-apollo-agent-${VERSION}.tgz"
111
+ PREFIX=$(mktemp -d)
112
+
113
+ npm install --prefix "$PREFIX" "$TARBALL" --ignore-scripts
114
+ test -x "$PREFIX/node_modules/.bin/apollo"
115
+ node --input-type=module -e "await import('$PREFIX/node_modules/@apolloyh/apollo-agent/dist/sdk.js'); console.log('SDK import ok')"
116
+ rm -rf "$PREFIX"
117
+ ```
118
+
119
+ ## 5. 提交并推送源码
120
+
121
+ 发布前让 GitHub 的 `main` 与将要发布的代码一致:
122
+
123
+ ```bash
124
+ git add package.json package-lock.json src/brand.ts README.md docs
125
+ git commit -m "Release v$(node -p \"require('./package.json').version\")"
126
+ git push origin main
127
+ ```
128
+
129
+ 不要使用 `git add -f skills/`。项目级 skills 属于用户工作区,不应跟踪或打进 npm 包;只有源码目录 `bundled-skills/` 属于产品内置资源。
130
+
131
+ ## 6. 发布到 npm
132
+
133
+ Apollo 使用 npm 的浏览器 WebAuthn 流程,不需要 OTP:
134
+
135
+ ```bash
136
+ VERSION=$(node -p "require('./package.json').version")
137
+ TARBALL="releases/npm-packages/apolloyh-apollo-agent-${VERSION}.tgz"
138
+
139
+ npx --yes npm@12.0.1 publish "$TARBALL" \
140
+ --access public \
141
+ --auth-type=web
142
+ ```
143
+
144
+ 终端显示 npm 官方授权地址后:
145
+
146
+ 1. 按 Enter 打开浏览器。
147
+ 2. 使用 Touch ID 或本机安全密钥确认。
148
+ 3. 保持终端运行,直到看到 `+ @apolloyh/apollo-agent@<version>`。
149
+
150
+ 不要复制浏览器授权链接到公开日志;该链接是临时登录流程的一部分。
151
+
152
+ ## 7. 验证 npm registry
153
+
154
+ 发布后 registry 可能需要数秒传播:
155
+
156
+ ```bash
157
+ VERSION=$(node -p "require('./package.json').version")
158
+
159
+ npm view "@apolloyh/apollo-agent@${VERSION}" \
160
+ version dist.shasum --json --prefer-online
161
+
162
+ npm view @apolloyh/apollo-agent \
163
+ version dist-tags.latest --json --prefer-online
164
+ ```
165
+
166
+ 只有目标版本可查询且 `latest` 指向目标版本,才算 npm 发布完成。
167
+
168
+ 最后进行公开安装验证:
169
+
170
+ ```bash
171
+ npm install -g @apolloyh/apollo-agent@latest --prefer-online
172
+ apollo
173
+ ```
174
+
175
+ ## 8. 创建 GitHub Release
176
+
177
+ 把与 npm 发布完全相同的 tarball 作为 Release 附件:
178
+
179
+ ```bash
180
+ VERSION=$(node -p "require('./package.json').version")
181
+ TARBALL="releases/npm-packages/apolloyh-apollo-agent-${VERSION}.tgz"
182
+
183
+ gh release create "v${VERSION}" "$TARBALL" \
184
+ --target main \
185
+ --title "Apollo v${VERSION}" \
186
+ --generate-notes
187
+ ```
188
+
189
+ 验证 Release 和附件:
190
+
191
+ ```bash
192
+ gh release view "v${VERSION}" \
193
+ --json tagName,name,isDraft,isPrerelease,url,assets
194
+ ```
195
+
196
+ 如果 Release 已存在,只补传或替换附件:
197
+
198
+ ```bash
199
+ gh release upload "v${VERSION}" "$TARBALL" --clobber
200
+ ```
201
+
202
+ ## 9. 完整发布清单
203
+
204
+ - [ ] npm registry 上的旧版本已确认
205
+ - [ ] `package.json`、`package-lock.json`、`src/brand.ts` 版本一致
206
+ - [ ] 类型检查、构建和测试通过
207
+ - [ ] tarball 内容正确且不含秘密
208
+ - [ ] 真实 tarball 本地安装通过
209
+ - [ ] 源码已提交并推送到 `main`
210
+ - [ ] npm WebAuthn 发布成功
211
+ - [ ] 目标版本可从 registry 查询
212
+ - [ ] `latest` 指向目标版本
213
+ - [ ] GitHub Release 已创建并附加同一 tarball
214
+ - [ ] 工作区干净且本地分支与远端同步
215
+
216
+ ## 常见错误
217
+
218
+ ### `E403` 或版本已存在
219
+
220
+ npm 版本不可覆盖。重新增加版本号、重新测试并打包,不要尝试覆盖旧版本。
221
+
222
+ ### `E404 Not Found`
223
+
224
+ 发布后短时间查询不到通常是 registry 传播延迟。等待几秒并使用 `--prefer-online` 重试。如果持续失败,再检查包权限和登录账号。
225
+
226
+ ### `EEXIST .../bin/apollo`
227
+
228
+ 本机已有旧的命令或手动软链接:
229
+
230
+ ```bash
231
+ which apollo
232
+ npm uninstall -g @apolloyh/apollo-agent
233
+ ```
234
+
235
+ 确认旧路径后再重新安装。不要直接使用 `--force`,除非已确认覆盖目标。
236
+
237
+ ### npm 要求 OTP
238
+
239
+ 本项目使用 WebAuthn 发布,应指定 `--auth-type=web`。按 Enter 打开 npm 官方授权页,然后使用 Touch ID 或安全密钥,不需要输入 OTP。
240
+
241
+ ### npm 发布成功但 GitHub Release 失败
242
+
243
+ 不要重新发布 npm。修复 GitHub 登录或网络问题后,重新执行 `gh release create` 或 `gh release upload` 即可。
244
+
245
+ ### 发布了有问题的版本
246
+
247
+ 已发布版本不能安全地原地替换。修复问题并发布新的 patch 版本。必要时可先标记旧版本:
248
+
249
+ ```bash
250
+ npm deprecate @apolloyh/apollo-agent@0.1.11 "Please upgrade to a newer version."
251
+ ```
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "@apolloyh/apollo-agent",
3
- "version": "0.1.10",
3
+ "version": "0.1.11",
4
4
  "type": "module",
5
5
  "description": "Apollo — your personal agent. Answer first, act when needed, with tools, skills, and isolated Task subagents.",
6
6
  "bin": {
7
- "apollo": "./dist/index.js"
7
+ "apollo": "dist/index.js"
8
8
  },
9
9
  "main": "./dist/sdk.js",
10
10
  "types": "./dist/sdk.d.ts",
@@ -24,6 +24,7 @@
24
24
  "README.md",
25
25
  "docs/guide.md",
26
26
  "docs/features-cc.md",
27
+ "docs/npm-release.md",
27
28
  "docs/sdk.md",
28
29
  ".apollo/config.example.json",
29
30
  ".apollo/hooks.example.json",