fullstackgtm 0.52.2 → 0.52.3

package/CHANGELOG.md

@@ -7,6 +7,14 @@ The path to 1.0 is planned in [docs/roadmap-to-1.0.md](https://github.com/fullst
 
 ## [Unreleased]
 
+## [0.52.3] — 2026-07-11
+
+### Changed
+
+- OpenRouter ICP derivation replaces numeric reasoning-token heartbeats with
+  safe, subject-aware progress summaries inferred transiently from the model's
+  reasoning stream; raw chain-of-thought is never displayed or retained.
+
 ## [0.52.2] — 2026-07-11
 
 ### Fixed

package/dist/icpDerive.js

@@ -98,7 +98,7 @@ DOMAIN: ${target.domain}
             model,
             ...(isOpenRouter ? {
                 onReasoningSummary: (summary) => args.onProgress?.({ stage: "model", message: `${model} reasoning summary: ${summary.slice(0, 240)}` }),
-                onReasoningActivity: (characters) => args.onProgress?.({ stage: "model", message: `${model} reasoning · ~${Math.max(1, Math.round(characters / 4)).toLocaleString("en-US")} tokens received` }),
+                onReasoningPhase: (phase) => args.onProgress?.({ stage: "model", message: `${model}: ${phase}` }),
             } : {}),
         });
     const companyName = typeof raw.companyName === "string" ? raw.companyName.trim().slice(0, 100) : target.domain;

package/dist/llm.d.ts

@@ -40,6 +40,9 @@ export type LlmCallOptions = {
      * deliberately not exposed; only provider-authored summaries and activity. */
     onReasoningSummary?: (summary: string) => void;
     onReasoningActivity?: (receivedCharacters: number) => void;
+    /** Safe, coarse phase inferred transiently from reasoning text. The raw text
+     * is never passed to callers, logged, or retained after the request. */
+    onReasoningPhase?: (phase: string) => void;
 };
 export type LlmExtractedInsight = ExtractedCallInsight & {
     owner?: string;

package/dist/llm.js

@@ -315,7 +315,7 @@ export async function forcedToolCall(prompt, toolName, schema, model, options) {
         tools: [{ type: "function", function: { name: toolName, parameters: schema } }],
         tool_choice: { type: "function", function: { name: toolName } },
     };
-    if (options.onReasoningSummary || options.onReasoningActivity) {
+    if (options.onReasoningSummary || options.onReasoningActivity || options.onReasoningPhase) {
         return streamOpenAiToolCall(fetchImpl, openaiUrl, requestBody, options);
     }
     const response = await llmFetch(fetchImpl, openaiUrl, {
@@ -352,7 +352,9 @@ async function streamOpenAiToolCall(fetchImpl, url, body, options) {
     let argumentsJson = "";
     let reasoningCharacters = 0;
     let lastActivityReport = 0;
+    let recentReasoning = "";
     const seenSummaries = new Set();
+    const seenPhases = new Set();
     while (true) {
         const { value, done } = await reader.read();
         buffer += decoder.decode(value, { stream: !done });
@@ -373,9 +375,18 @@ async function streamOpenAiToolCall(fetchImpl, url, body, options) {
             }
             const delta = chunk.choices?.[0]?.delta;
             argumentsJson += delta?.tool_calls?.[0]?.function?.arguments ?? "";
-            reasoningCharacters += delta?.reasoning?.length ?? 0;
+            const detailText = (delta?.reasoning_details ?? []).filter((detail) => detail.type === "reasoning.text").map((detail) => detail.text ?? "").join("");
+            const reasoningText = delta?.reasoning || detailText;
+            reasoningCharacters += reasoningText.length;
+            if (reasoningText) {
+                recentReasoning = `${recentReasoning}${reasoningText}`.slice(-600);
+                const phase = reasoningPhase(recentReasoning);
+                if (phase && !seenPhases.has(phase)) {
+                    seenPhases.add(phase);
+                    options.onReasoningPhase?.(phase);
+                }
+            }
             for (const detail of delta?.reasoning_details ?? []) {
-                reasoningCharacters += detail.text?.length ?? detail.summary?.length ?? 0;
                 if (detail.type !== "reasoning.summary" || !detail.summary)
                     continue;
                 const summary = detail.summary.replace(/\s+/g, " ").trim();
@@ -396,6 +407,18 @@ async function streamOpenAiToolCall(fetchImpl, url, body, options) {
         throw new Error("OpenAI-compatible model returned no streamed tool call — try again or a different --model.");
     return JSON.parse(argumentsJson);
 }
+function reasoningPhase(text) {
+    const normalized = text.toLowerCase();
+    const phases = [
+        [/quote|evidence|verbatim|source text|supporting claim/, "checking candidate evidence against website quotes"],
+        [/buyer|persona|job title|seniority|department|decision.?maker/, "resolving likely buyer roles, departments, and seniority"],
+        [/industr|employee|company size|firmographic|geograph|target account/, "narrowing target-account industries, size, and geography"],
+        [/intent|trigger|timing|why now|signal/, "identifying intent and timing signals"],
+        [/offer|product|service|value proposition|capabilit/, "interpreting the company offer and value proposition"],
+        [/schema|structured|json|field|assemble|final/, "assembling the structured ICP response"],
+    ];
+    return phases.find(([pattern]) => pattern.test(normalized))?.[1];
+}
 async function llmFetch(fetchImpl, url, init) {
     let response;
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fullstackgtm",
-  "version": "0.52.2",
+  "version": "0.52.3",
   "description": "Open-source agentic GTM ops framework: canonical GTM data model, pluggable deterministic audits, reviewable dry-run patch plans, approval-gated write-back with conflict detection, and cross-system entity resolution. HubSpot, Salesforce, and Stripe connectors included.",
   "license": "Apache-2.0",
   "author": "Full Stack GTM LLC <ryan@fullstackgtm.com> (https://fullstackgtm.com)",

package/src/icpDerive.ts

@@ -112,7 +112,7 @@ DOMAIN: ${target.domain}
       model,
       ...(isOpenRouter ? {
         onReasoningSummary: (summary: string) => args.onProgress?.({ stage: "model", message: `${model} reasoning summary: ${summary.slice(0, 240)}` }),
-        onReasoningActivity: (characters: number) => args.onProgress?.({ stage: "model", message: `${model} reasoning · ~${Math.max(1, Math.round(characters / 4)).toLocaleString("en-US")} tokens received` }),
+        onReasoningPhase: (phase: string) => args.onProgress?.({ stage: "model", message: `${model}: ${phase}` }),
       } : {}),
     }) as Record<string, unknown>;
   const companyName = typeof raw.companyName === "string" ? raw.companyName.trim().slice(0, 100) : target.domain;

package/src/llm.ts

@@ -123,6 +123,9 @@ export type LlmCallOptions = {
    * deliberately not exposed; only provider-authored summaries and activity. */
   onReasoningSummary?: (summary: string) => void;
   onReasoningActivity?: (receivedCharacters: number) => void;
+  /** Safe, coarse phase inferred transiently from reasoning text. The raw text
+   * is never passed to callers, logged, or retained after the request. */
+  onReasoningPhase?: (phase: string) => void;
 };
 
 export type LlmExtractedInsight = ExtractedCallInsight & {
@@ -458,7 +461,7 @@ export async function forcedToolCall(
     tools: [{ type: "function", function: { name: toolName, parameters: schema } }],
     tool_choice: { type: "function", function: { name: toolName } },
   };
-  if (options.onReasoningSummary || options.onReasoningActivity) {
+  if (options.onReasoningSummary || options.onReasoningActivity || options.onReasoningPhase) {
     return streamOpenAiToolCall(fetchImpl, openaiUrl, requestBody, options);
   }
   const response = await llmFetch(fetchImpl, openaiUrl, {
@@ -497,7 +500,9 @@ async function streamOpenAiToolCall(
   let argumentsJson = "";
   let reasoningCharacters = 0;
   let lastActivityReport = 0;
+  let recentReasoning = "";
   const seenSummaries = new Set<string>();
+  const seenPhases = new Set<string>();
   while (true) {
     const { value, done } = await reader.read();
     buffer += decoder.decode(value, { stream: !done });
@@ -511,9 +516,15 @@ async function streamOpenAiToolCall(
       try { chunk = JSON.parse(data); } catch { continue; }
       const delta = chunk.choices?.[0]?.delta;
       argumentsJson += delta?.tool_calls?.[0]?.function?.arguments ?? "";
-      reasoningCharacters += delta?.reasoning?.length ?? 0;
+      const detailText = (delta?.reasoning_details ?? []).filter((detail) => detail.type === "reasoning.text").map((detail) => detail.text ?? "").join("");
+      const reasoningText = delta?.reasoning || detailText;
+      reasoningCharacters += reasoningText.length;
+      if (reasoningText) {
+        recentReasoning = `${recentReasoning}${reasoningText}`.slice(-600);
+        const phase = reasoningPhase(recentReasoning);
+        if (phase && !seenPhases.has(phase)) { seenPhases.add(phase); options.onReasoningPhase?.(phase); }
+      }
       for (const detail of delta?.reasoning_details ?? []) {
-        reasoningCharacters += detail.text?.length ?? detail.summary?.length ?? 0;
         if (detail.type !== "reasoning.summary" || !detail.summary) continue;
         const summary = detail.summary.replace(/\s+/g, " ").trim();
         if (summary && !seenSummaries.has(summary)) { seenSummaries.add(summary); options.onReasoningSummary?.(summary); }
@@ -529,6 +540,19 @@ async function streamOpenAiToolCall(
   return JSON.parse(argumentsJson);
 }
 
+function reasoningPhase(text: string): string | undefined {
+  const normalized = text.toLowerCase();
+  const phases: Array<[RegExp, string]> = [
+    [/quote|evidence|verbatim|source text|supporting claim/, "checking candidate evidence against website quotes"],
+    [/buyer|persona|job title|seniority|department|decision.?maker/, "resolving likely buyer roles, departments, and seniority"],
+    [/industr|employee|company size|firmographic|geograph|target account/, "narrowing target-account industries, size, and geography"],
+    [/intent|trigger|timing|why now|signal/, "identifying intent and timing signals"],
+    [/offer|product|service|value proposition|capabilit/, "interpreting the company offer and value proposition"],
+    [/schema|structured|json|field|assemble|final/, "assembling the structured ICP response"],
+  ];
+  return phases.find(([pattern]) => pattern.test(normalized))?.[1];
+}
+
 async function llmFetch(fetchImpl: typeof fetch, url: string, init: RequestInit): Promise<unknown> {
   let response: Response;
   try {