@cheemsup/dsh-plugin-console 0.0.0-stage → 0.2.0

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.
Files changed (101) hide show
  1. package/LICENSE +23 -0
  2. package/README.md +95 -3
  3. package/cordis.patch.yml +5 -0
  4. package/icon.svg +203 -0
  5. package/lib/client.activity.js +222 -0
  6. package/lib/client.apply.js +171 -0
  7. package/lib/client.changes.js +206 -0
  8. package/lib/client.cleanup.js +270 -0
  9. package/lib/client.control.js +247 -0
  10. package/lib/client.dialog.js +77 -0
  11. package/lib/client.disable-preview.js +904 -0
  12. package/lib/client.draft.js +280 -0
  13. package/lib/client.editor-messages.js +421 -0
  14. package/lib/client.editor-store.js +266 -0
  15. package/lib/client.editor.js +433 -0
  16. package/lib/client.effects.js +115 -0
  17. package/lib/client.impact-tree.js +487 -0
  18. package/lib/client.influence.js +361 -0
  19. package/lib/client.js +246 -0
  20. package/lib/client.page.js +646 -0
  21. package/lib/client.plugin-filters.js +62 -0
  22. package/lib/client.plugins.js +506 -0
  23. package/lib/client.preview-messages.js +506 -0
  24. package/lib/client.preview-raw.js +132 -0
  25. package/lib/client.preview-store.js +128 -0
  26. package/lib/client.preview-tools.js +194 -0
  27. package/lib/client.preview.js +448 -0
  28. package/lib/client.relation-graph.js +364 -0
  29. package/lib/client.schema.js +327 -0
  30. package/lib/client.search.js +409 -0
  31. package/lib/client.session-detail.js +503 -0
  32. package/lib/client.sessions.js +495 -0
  33. package/lib/client.shared.js +562 -0
  34. package/lib/client.store.js +452 -0
  35. package/lib/client.styles.js +589 -0
  36. package/lib/client.template-card.js +240 -0
  37. package/lib/client.tools.js +366 -0
  38. package/lib/client.workspace-picker.js +204 -0
  39. package/lib/host/activity.js +252 -0
  40. package/lib/host/assembly-preview.js +244 -0
  41. package/lib/host/attribution.js +341 -0
  42. package/lib/host/catalog.js +133 -0
  43. package/lib/host/categorize.js +40 -0
  44. package/lib/host/config-layers.js +589 -0
  45. package/lib/host/constants.js +69 -0
  46. package/lib/host/control.js +159 -0
  47. package/lib/host/disable-preview.js +651 -0
  48. package/lib/host/entries.js +289 -0
  49. package/lib/host/fiber.js +86 -0
  50. package/lib/host/fs.js +99 -0
  51. package/lib/host/health.js +178 -0
  52. package/lib/host/http.js +65 -0
  53. package/lib/host/impact.js +138 -0
  54. package/lib/host/injection-owners.js +60 -0
  55. package/lib/host/layers.js +132 -0
  56. package/lib/host/masks.js +145 -0
  57. package/lib/host/modes.js +96 -0
  58. package/lib/host/names.js +44 -0
  59. package/lib/host/patch-config.js +554 -0
  60. package/lib/host/patch-scan.js +103 -0
  61. package/lib/host/preview-conditions.js +281 -0
  62. package/lib/host/preview-contexts.js +174 -0
  63. package/lib/host/preview-envelope.js +31 -0
  64. package/lib/host/preview-instructions.js +450 -0
  65. package/lib/host/preview-messages.js +284 -0
  66. package/lib/host/preview-modules.js +233 -0
  67. package/lib/host/preview-skills.js +200 -0
  68. package/lib/host/prompt.js +213 -0
  69. package/lib/host/recipe-overlay.js +209 -0
  70. package/lib/host/request-preview.js +114 -0
  71. package/lib/host/routes/activation.js +96 -0
  72. package/lib/host/routes/activity.js +22 -0
  73. package/lib/host/routes/apply.js +93 -0
  74. package/lib/host/routes/cleanup.js +62 -0
  75. package/lib/host/routes/control.js +22 -0
  76. package/lib/host/routes/disable-preview.js +19 -0
  77. package/lib/host/routes/impact.js +19 -0
  78. package/lib/host/routes/operations.js +22 -0
  79. package/lib/host/routes/preview.js +58 -0
  80. package/lib/host/routes/session-influence.js +23 -0
  81. package/lib/host/routes/snapshot.js +21 -0
  82. package/lib/host/routes/template.js +54 -0
  83. package/lib/host/routes/templates.js +28 -0
  84. package/lib/host/scope-impact.js +125 -0
  85. package/lib/host/session-events.js +39 -0
  86. package/lib/host/session-influence.js +467 -0
  87. package/lib/host/sessions.js +293 -0
  88. package/lib/host/snapshot.js +218 -0
  89. package/lib/host/source-scan.js +225 -0
  90. package/lib/host/templates/cleanup.js +219 -0
  91. package/lib/host/templates/inheritance.js +144 -0
  92. package/lib/host/templates/materialize.js +317 -0
  93. package/lib/host/templates/message-overlay.js +184 -0
  94. package/lib/host/templates/repository.js +323 -0
  95. package/lib/host/templates/store.js +131 -0
  96. package/lib/host/tool-set.js +150 -0
  97. package/lib/host/tools.js +129 -0
  98. package/lib/index.js +106 -0
  99. package/locale/en.json +6 -0
  100. package/locale/zh.json +6 -0
  101. package/package.json +124 -6
@@ -0,0 +1,128 @@
1
+ /**
2
+ * 首请求预演的请求状态:模式 + 工作区 + 权限预设,以及一次按条件求值。
3
+ *
4
+ * 单独一个 chunk 而不是留在 `client.store.js`:这三个条件只服务预演页,而且条件之间
5
+ * 会互相触发重算(换个工作区就得重跑),状态与重跑逻辑放在一起才不会漂移。
6
+ * 快照、模板两块 store 的失败语义各不相同,也不该被预演条件拖着一起长。
7
+ *
8
+ * 本文件是一个包内 chunk:入口用 `require.async('./client.preview-store.js')` 取它。
9
+ */
10
+
11
+ window.__ModuleLoader__.load({
12
+ id: '@cheemsup/dsh-plugin-console',
13
+ chunk: 'client.preview-store.js',
14
+ factory: (require) => {
15
+ const React = require('react')
16
+ const { useCallback, useRef, useState } = React
17
+
18
+ return function create(deps) {
19
+ const { PREVIEW_ROUTE, browserTimeZone } = deps.shared
20
+
21
+ /**
22
+ * @param {object[]} workspaces - 快照里的工作区,已按最近活跃排序。
23
+ * @returns {object} 预演状态、条件与动作。
24
+ */
25
+ function usePreviewStore(workspaces) {
26
+ const [preset, setPreset] = useState(null)
27
+ // undefined = 还没选过(默认取最近活跃的工作区);null 不是合法值,路径总以字符串出现。
28
+ const [workspace, setWorkspace] = useState(undefined)
29
+ const [permission, setPermission] = useState(null)
30
+ const [preview, setPreview] = useState(null)
31
+ const [status, setStatus] = useState('idle')
32
+ const [error, setError] = useState(null)
33
+ const [tab, setTab] = useState('prompt')
34
+ // 首条消息草稿:不进请求就不影响结果,所以只作为条件的一部分。
35
+ const [draft, setDraft] = useState('')
36
+ // 条件变化可能连发几次请求;只认最后一次的响应,否则旧结果会盖掉新条件。
37
+ const ticket = useRef(0)
38
+
39
+ /** 没选过就用最近活跃的工作区:新会话默认就落在那里。 */
40
+ const workspacePath = workspace === undefined ? (workspaces?.[0]?.path ?? null) : workspace
41
+
42
+ const fetchPreview = useCallback(async (conditions) => {
43
+ const response = await fetch(new URL(PREVIEW_ROUTE, document.baseURI).href, {
44
+ method: 'POST',
45
+ headers: { 'content-type': 'application/json' },
46
+ credentials: 'same-origin',
47
+ body: JSON.stringify(conditions),
48
+ })
49
+ const data = await response.json()
50
+ if (!response.ok || data.error !== undefined) throw new Error(data.error ?? `HTTP ${response.status}`)
51
+ return data
52
+ }, [])
53
+
54
+ /**
55
+ * @param {string | null} presetId - 目标模式;null 表示宿主默认模式。
56
+ * @param {object} [overrides] - 本次请求要覆盖的条件(换工作区时用)。
57
+ * @returns {Promise<void>} 结果写进 state。
58
+ */
59
+ const runPreview = useCallback(async (presetId, overrides = {}) => {
60
+ const draftText = overrides.draft ?? draft
61
+ const conditions = {
62
+ presetId: presetId ?? undefined,
63
+ // `undefined` 表示沿用当前条件;空串是「清掉工作区」这个显式选择,不能被覆盖。
64
+ workspacePath: overrides.workspacePath !== undefined ? overrides.workspacePath : (workspacePath ?? undefined),
65
+ permissionPreset: overrides.permissionPreset ?? permission ?? undefined,
66
+ clientTimeZone: browserTimeZone(),
67
+ // 空草稿与「没有草稿」是同一件事,不要往请求里塞一个空串。
68
+ ...(draftText.trim().length > 0 ? { draft: draftText } : {}),
69
+ }
70
+ const mine = ++ticket.current
71
+ setStatus('loading')
72
+ setError(null)
73
+ try {
74
+ const next = await fetchPreview(conditions)
75
+ if (mine !== ticket.current) return
76
+ setPreview(next)
77
+ setStatus('ready')
78
+ } catch (cause) {
79
+ if (mine !== ticket.current) return
80
+ setError(cause instanceof Error ? cause.message : String(cause))
81
+ setStatus('error')
82
+ }
83
+ }, [fetchPreview, workspacePath, permission, draft])
84
+
85
+ // 工作区与权限直接改变模型看到的内容,选中即重算,不需要再点一次按钮。
86
+ const chooseWorkspace = useCallback((path) => {
87
+ const next = typeof path === 'string' ? path.trim() : path
88
+ setWorkspace(next)
89
+ void runPreview(preset, { workspacePath: next })
90
+ }, [runPreview, preset])
91
+
92
+ const choosePermission = useCallback((name) => {
93
+ setPermission(name)
94
+ void runPreview(preset, { permissionPreset: name })
95
+ }, [runPreview, preset])
96
+
97
+ // 草稿不随输入重算:每敲一个字都跑一次 skill 扫描与文件读取太贵,
98
+ // 由用户决定「这条消息现在算一遍」。
99
+ const applyDraft = useCallback(() => {
100
+ void runPreview(preset, { draft })
101
+ }, [runPreview, preset, draft])
102
+
103
+ return {
104
+ previewPreset: preset,
105
+ setPreviewPreset: setPreset,
106
+ preview,
107
+ previewStatus: status,
108
+ previewError: error,
109
+ previewTab: tab,
110
+ setPreviewTab: setTab,
111
+ previewWorkspaces: workspaces ?? [],
112
+ previewWorkspacePath: workspacePath,
113
+ setPreviewWorkspacePath: chooseWorkspace,
114
+ // 权限预设的默认值由宿主给出(部署默认),所以未选时先显示服务端解析结果。
115
+ previewPermissionPreset: permission ?? preview?.conditions?.permission?.preset ?? null,
116
+ setPreviewPermissionPreset: choosePermission,
117
+ previewDraft: draft,
118
+ setPreviewDraft: setDraft,
119
+ applyDraft,
120
+ fetchPreview,
121
+ runPreview,
122
+ }
123
+ }
124
+
125
+ return { usePreviewStore }
126
+ }
127
+ },
128
+ })
@@ -0,0 +1,194 @@
1
+ /**
2
+ * 预演页的「工具 schema」:按名字来源分组,每个工具默认就展示名字与描述。
3
+ *
4
+ * 分组只看名字:全局工具视图里就有的 → 全局层;只在当前模式 preset scope 出现的
5
+ * → 预设层;两边都没有 → 未分类。不比较描述或参数,避免把「模式重新注册了同名
6
+ * 工具」误标成替换。层级由 host 的 `classifyPreviewTools` 给出,前端只负责展示。
7
+ *
8
+ * 每个工具行是一块占满宽度的摘要:名字 + 最多两行的描述,展开才是完整说明与
9
+ * 参数契约。只展示名字时,一列几十个工具读起来只是一份名单,看不出该不该用。
10
+ *
11
+ * 本文件是一个包内 chunk:入口用 `require.async('./client.preview-tools.js')` 取它。
12
+ */
13
+
14
+ window.__ModuleLoader__.load({
15
+ id: '@cheemsup/dsh-plugin-console',
16
+ chunk: 'client.preview-tools.js',
17
+ factory: (require) => {
18
+ const React = require('react')
19
+ const { createElement: h } = React
20
+
21
+ return function create(deps) {
22
+ const { shortName, schema } = deps
23
+
24
+ /** 每一层的展示名、悬停说明与展示顺序。 */
25
+ const TOOL_SCOPES = {
26
+ global: { label: '全局层' },
27
+ preset: {
28
+ label: '预设层(模式)',
29
+ hint: '只在当前模式的 preset scope 出现,本会话的 agent scope 沿 scope 链继承它们',
30
+ },
31
+ unknown: { label: '未分类' },
32
+ }
33
+ const TOOL_SCOPE_ORDER = ['global', 'preset', 'unknown']
34
+
35
+ /**
36
+ * 工具的归属标签:注册表不记 owner,按快照里的源码扫描索引回填。
37
+ * 扫不到就标「未归属」,不硬凑近似结果。
38
+ * @param {string[] | undefined} owners - 注册行 id。
39
+ * @param {Map<string, object>} byRow - 行 id → 条目。
40
+ * @param {object} vc - 视图上下文。
41
+ * @returns {Array<object>} 标签节点。
42
+ */
43
+ function ownerTags(owners, byRow, vc) {
44
+ if (!Array.isArray(owners) || owners.length === 0) {
45
+ return [h('span', { className: 'ptTag', 'data-tone': 'warn', title: '未归属:源码扫描没有找到注册点' }, '未归属')]
46
+ }
47
+ return owners.map((rowId) => {
48
+ const entry = byRow.get(rowId)
49
+ return h(
50
+ 'button',
51
+ {
52
+ key: rowId,
53
+ type: 'button',
54
+ className: 'ptTag ptLink',
55
+ title: `注册插件:${entry?.packageName ?? entry?.moduleName ?? rowId};点击查看这个插件`,
56
+ onClick: (event) => {
57
+ event.preventDefault()
58
+ event.stopPropagation()
59
+ vc.gotoPlugin(rowId)
60
+ },
61
+ },
62
+ entry ? shortName(entry) : rowId,
63
+ )
64
+ })
65
+ }
66
+
67
+ /**
68
+ * 一个工具:摘要本身就是一块内容(名字 + 最多两行描述),展开是完整说明。
69
+ *
70
+ * 所在层级不重复标在行上——分组标题已经说明了;行内只留会影响判断的标记
71
+ * (有指导 / lazy)与归属。
72
+ * @param {object} tool - 工具 schema。
73
+ * @param {object} ctx - `{ guided, byRow, ownersByName, vc }`。
74
+ * @returns {object} React 节点。
75
+ */
76
+ function toolRow(tool, ctx) {
77
+ const { guided, byRow, ownersByName, vc } = ctx
78
+ const description = typeof tool.description === 'string' ? tool.description : ''
79
+ return h(
80
+ 'li',
81
+ { key: tool.name },
82
+ h(
83
+ 'details',
84
+ { className: 'ptToolBlock ptFold ptFoldable ptPreviewTool' },
85
+ h(
86
+ 'summary',
87
+ null,
88
+ h('span', { className: 'ptPreviewToolName' }, tool.name),
89
+ guided?.has(tool.name)
90
+ ? h('span', { className: 'ptTag', title: '系统提示词里有 tool:' + tool.name + ' 段落,内容是用法建议' }, '有指导')
91
+ : null,
92
+ tool.deferLoading ? h('span', { className: 'ptTag', title: '延迟加载:模型真正需要时才载入这份 schema' }, 'lazy') : null,
93
+ ...ownerTags(ownersByName.get(tool.name), byRow, vc),
94
+ // 描述放在标签之后并独占一行:读工具时先看它能做什么,而不是先读归属。
95
+ description.length > 0 ? h('span', { className: 'ptPreviewToolDesc', title: description }, description) : null,
96
+ ),
97
+ h(
98
+ 'div',
99
+ { className: 'ptFoldBody' },
100
+ description.length > 0
101
+ ? h('p', { className: 'ptToolDesc', style: { margin: 0 } }, description)
102
+ : h('p', { className: 'ptSub', style: { margin: 0 } }, '(无描述)'),
103
+ tool.parameters !== undefined
104
+ ? schema.renderParameters(tool, { vc: ctx.vc, source: 'preview' })
105
+ : h('p', { className: 'ptSub', style: { margin: '6px 0 0' } }, '(无参数 schema)'),
106
+ ),
107
+ ),
108
+ )
109
+ }
110
+
111
+ /** 一个 scope 层:折叠头 + 该层的工具行;层内没有工具时不渲染。 */
112
+ function scopeFold(layer, tools, ctx) {
113
+ if (tools.length === 0) return null
114
+ const scope = TOOL_SCOPES[layer] ?? { label: layer }
115
+ return h(
116
+ 'details',
117
+ { key: layer, className: 'ptFold ptFoldable', style: { marginTop: '8px' }, open: true },
118
+ h(
119
+ 'summary',
120
+ scope.hint === undefined ? null : { title: scope.hint },
121
+ h('span', null, scope.label),
122
+ h('span', { className: 'ptCount' }, tools.length + ' 个'),
123
+ ),
124
+ h(
125
+ 'ul',
126
+ { className: 'ptList', style: { padding: '6px 12px 10px' } },
127
+ tools.map((tool) => toolRow(tool, ctx)),
128
+ ),
129
+ )
130
+ }
131
+
132
+ /**
133
+ * 工具 schema 的按 scope 分组视图。
134
+ *
135
+ * `tools` 是已按搜索词筛过的结果;分组只重排展示,不改变 host 给的顺序。
136
+ * 没有分层数据时退回平铺:工具服务缺席也不该让这一标签变成空白。
137
+ * @param {object} input - `{ tools, toolSet, guided, snapshot, vc }`。
138
+ * @returns {object} React 节点。
139
+ */
140
+ function renderToolScopeGroups({ tools, toolSet, guided, snapshot, vc }) {
141
+ const byRow = new Map((snapshot?.entries ?? []).map((entry) => [entry.rowId, entry]))
142
+ const ownersByName = new Map((snapshot?.tools?.attributed ?? []).map((tool) => [tool.name, tool.owners ?? []]))
143
+ const ctx = {
144
+ guided,
145
+ byRow,
146
+ ownersByName,
147
+ vc,
148
+ }
149
+
150
+ const layers = toolSet?.layers
151
+ if (layers === undefined || layers === null) {
152
+ return h('ul', { className: 'ptList' }, tools.map((tool) => toolRow(tool, ctx)))
153
+ }
154
+
155
+ const byName = new Map(tools.map((tool) => [tool.name, tool]))
156
+ const grouped = { global: [], preset: [], unknown: [] }
157
+ const placed = new Set()
158
+ for (const name of Object.values(layers).flat()) {
159
+ const tool = byName.get(name)
160
+ if (tool === undefined || placed.has(name)) continue
161
+ const declared = toolSet.layerByName?.[name]
162
+ const layer = TOOL_SCOPES[declared] === undefined ? 'unknown' : declared
163
+ grouped[layer].push(tool)
164
+ placed.add(name)
165
+ }
166
+ // host 没覆盖到的名字(理论上不会出现)也算未分类,而不是从界面上消失。
167
+ for (const tool of tools) {
168
+ if (!placed.has(tool.name)) grouped.unknown.push(tool)
169
+ }
170
+
171
+ const counts = TOOL_SCOPE_ORDER
172
+ .map((layer) => TOOL_SCOPES[layer].label + ' ' + grouped[layer].length)
173
+ .join(' · ')
174
+ return h(
175
+ 'details',
176
+ { className: 'ptFold ptFoldable', style: { marginTop: '8px' }, open: true },
177
+ h(
178
+ 'summary',
179
+ { title: '此处仅作分组,不代表最终请求发出的tool顺序' },
180
+ h('span', null, '按 scope 分组的工具 schema'),
181
+ h('span', { className: 'ptFoldMeta' }, counts),
182
+ ),
183
+ h(
184
+ 'div',
185
+ { className: 'ptFoldBody', style: { padding: '8px 12px 12px' } },
186
+ TOOL_SCOPE_ORDER.map((layer) => scopeFold(layer, grouped[layer], ctx)),
187
+ ),
188
+ )
189
+ }
190
+
191
+ return { renderToolScopeGroups }
192
+ }
193
+ },
194
+ })