@qilin-agent/client-product-analytics 3.1.6 → 3.1.7

package/README.i18n.yaml

@@ -15,8 +15,11 @@
   en: 4e53164159b5ce41
   zh: adba5f78f4fe4801
 /qilin-agent-client-product-analytics/use-this-package:
-  en: 43b4c57162dc9f6a
-  zh: b87d9f39b133d9bd
+  en: 503c509109436d53
+  zh: 14bb613b0c5dfee9
+/qilin-agent-client-product-analytics/use-this-package/navigation-preset-and-new-session-events:
+  en: c269d108e192046e
+  zh: 479fabd322c0f842
 /qilin-agent-client-product-analytics/dev-note:
   en: 3155a54154dfbdd4
   zh: a80fb690600452fd

package/README.md

@@ -25,6 +25,14 @@ English | [中文](README.zh.md)
 
 Import the map where an event is declared and the event type where one is sent:
 
+### Navigation, preset, and new-session events
+
+Official navigation reports New Session, Plugins, Automation tasks, and More clicks with their physical placement: `sidebar`, `sidebar_more`, or `titlebar`. Opening Automation tasks from the left sidebar More menu counts as `sidebar_more`, not as a direct sidebar click. Historical `sidebar_menu_click` records without `position` remain unattributed. More-menu actions distinguish the sidebar, conversation, and rightbar regions. Third-party entry identifiers and custom preset names are excluded.
+
+Direct preset switches report accepted different choices in the mode picker: an unbound staged choice, or Host application for a blank Session. Custom source modes are `other`, and only built-in targets are reported. Default changes, automatic fallback, restoration, and Creator launchers are excluded. Each switch records the Coding Tools setting known at the action; an unknown setting reports nothing. `code_work_view_toggle` reports a successful change of that setting.
+
+`send_button_click` carries `is_new_session`, which is true while the submitting Session is still blank, and `agent_preset`, the Session's preset as `creator`, `ptc`, `minimal`, `standard`, or `other` for a custom preset; `agent_preset` is omitted while the preset is unknown.
+
 
 <a id="dev-note"></a>
 ## Dev Note

package/README.zh.md

@@ -25,6 +25,14 @@ kind: "package-reference"
 
 在声明事件处引用映射，在发送处引用事件类型：
 
+### 导航、预设与新会话事件
+
+官方导航上报 New Session、插件、自动化任务与「更多」点击，并携带其物理位置：`sidebar`、`sidebar_more` 或 `titlebar`。从左侧栏「更多」菜单打开自动化任务记为 `sidebar_more`，而非直接的侧栏点击。缺少 `position` 的历史 `sidebar_menu_click` 记录保持无归属。「更多」菜单的动作区分侧栏、会话与右侧栏三个区域。第三方入口标识与自定义预设名不采集。
+
+模式选择器中直接切换预设时，上报被接受且确实不同的选择：未绑定 Session 的暂存选择，或空白 Session 由 Host 应用的选择。自定义来源模式记为 `other`，只上报内置目标。默认值变更、自动回退、恢复与 Creator 入口不在此列。每次切换记录动作时已知的代码工作工具设置；设置未知时不上报。`code_work_view_toggle` 上报该设置的成功变更。
+
+`send_button_click` 携带 `is_new_session`（提交的 Session 仍为空白时为 true）与 `agent_preset`（会话预设，内置值为 `creator`、`ptc`、`minimal`、`standard`，自定义预设为 `other`）；预设未知时省略 `agent_preset`。
+
 
 <a id="dev-note"></a>
 ## 开发备注

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

@@ -10,7 +10,7 @@
 import { Service, type Context } from '@qilin-agent/kylin';
 import type { RemoteResult, RemoteStreamHandle } from '@qilin-agent/typert-protocol';
 import type { ProductEvent, ProductEventMap } from '../events.ts';
-export type { ProductEvent, ProductEventMap, TrackProductEvent } from '../events.ts';
+export type { AnalyticsPreset, EntryAnalyticsRegion, ProductEvent, ProductEventMap, SidebarAnalyticsEntry, SidebarAnalyticsPosition, TrackProductEvent, } from '../events.ts';
 /** The authenticated analytics namespace mounted by the desktop Client assembly. */
 declare module '@qilin-agent/typert-protocol' {
     interface TypertRemoteNamespaceMap {

package/lib/types/events.d.ts

@@ -36,6 +36,10 @@ export interface ProductEventMap {
         thinking_effort?: string;
         run_mode: 'plan' | 'goal' | 'default';
         msg_type: 'default' | 'steer' | 'queue';
+        /** Whether the message is the first one of a blank Session. */
+        is_new_session: boolean;
+        /** Fixed category of the Session's Agent preset, when known. */
+        agent_preset?: AnalyticsPreset | 'other';
     };
     model_switch: {
         session_id?: SessionId;
@@ -59,7 +63,20 @@ export interface ProductEventMap {
         click_position: 'footer' | 'sidebar';
     };
     sidebar_menu_click: {
-        menu_name: 'plugin' | 'cron';
+        menu_name: SidebarAnalyticsEntry;
+        position?: SidebarAnalyticsPosition;
+    };
+    more_menu_item_click: {
+        region: EntryAnalyticsRegion;
+        action: 'browse_plugins' | 'create_plugin';
+    };
+    agent_preset_switch: {
+        switch_from: AnalyticsPreset | 'other';
+        switch_to: AnalyticsPreset;
+        code_work_view_enabled: boolean;
+    };
+    code_work_view_toggle: {
+        is_enabled: boolean;
     };
     plugin_toggle: {
         plugin_name: string;
@@ -82,6 +99,14 @@ export interface ProductEventMap {
         plugin_name: string;
     };
 }
+/** Official navigation entries; third-party identifiers are never analytics dimensions. */
+export type SidebarAnalyticsEntry = 'new_session' | 'plugin' | 'cron' | 'more';
+/** Physical navigation placement, independent of the selected destination. */
+export type SidebarAnalyticsPosition = 'sidebar' | 'sidebar_more' | 'titlebar';
+/** Entry-customization menu regions. */
+export type EntryAnalyticsRegion = 'sidebar' | 'conversation' | 'rightbar';
+/** Built-in presets, independent of localized names and custom preset identifiers. */
+export type AnalyticsPreset = 'creator' | 'ptc' | 'minimal' | 'standard';
 /** Public page names independent of internal onboarding state names. */
 export type OnboardingPage = 'onboarding_welcome' | 'onboarding_recharge' | 'onboarding_use_case' | 'onboarding_process';
 /** Correlated event name and attributes for the authenticated analytics RPC. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-product-analytics",
   "description": "Desktop product event collection and authenticated Host reporting",
-  "version": "3.1.6",
+  "version": "3.1.7",
   "publishConfig": {
     "access": "public"
   },
@@ -33,13 +33,13 @@
     "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
+    "@qilin-agent/api-gateway": "3.1.7",
+    "@qilin-agent/app-boot": "3.1.7",
     "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/llm": "3.1.7",
     "@qilin-agent/kylin-plugin-loader": "~1.0.6",
-    "@qilin-agent/app-boot": "3.1.6",
-    "@qilin-agent/session": "3.1.6",
-    "@qilin-agent/llm": "3.1.6",
-    "@qilin-agent/api-gateway": "3.1.6",
-    "@qilin-agent/typert-protocol": "3.1.6"
+    "@qilin-agent/session": "3.1.7",
+    "@qilin-agent/typert-protocol": "3.1.7"
   },
   "dependencies": {},
   "optionalDependencies": {},