@linxin666/dsh-client-ui-task-board 0.1.1

package/src/index.ts

@@ -0,0 +1,94 @@
+/**
+ * Host loader entry for the task-board plugin.
+ *
+ * Everything the board does is browser work (DOM, localStorage, driving the
+ * client runtime's session services over the wire), so the host half's main
+ * behavior is a system-prompt section announcing the plugin to every agent.
+ * The section registers while this plugin is in the host composition (mount /
+ * DSH restart) and disappears when the plugin leaves it (unmount / restart),
+ * so agents always know the board exists and how to cooperate with it. The
+ * announcement can be turned off through the web settings plugin-configuration
+ * surface (`announceToAgent`); the section then disappears live.
+ */
+
+import type { Context } from '@deepseek-ai/cordis'
+import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings'
+import z from 'schemastery'
+import type {} from '@deepseek-ai/dsh-system-prompt'
+
+/** Order of the announcement section within the tool-guidance band. */
+const SECTION_ORDER = 200
+
+export const inject = ['systemPrompt']
+
+/** Model-facing announcement: plugin presence, capabilities, and limits. */
+export const TASK_BOARD_GUIDANCE = '本机已安装 dsh-task-board 插件（DSH Web GUI 的任务看板）：侧边栏「任务看板」入口；在 dsh-web-ui 插件全家桶仓库（packages/dsh-task-board）统一维护，经聚合包 web-ui-all 一键安装。能力：多列看板管理任务；任务可真实执行（驱动 agent 会话）；任务支持 5 段 cron 定时执行（如 0 23 * * *）；数据存浏览器 localStorage（键 dsh.taskBoard.v1）。限制：定时调度在浏览器端，需 GUI 标签页打开，错过即跳过；执行消耗 API 额度。用户提到「任务看板 / 看板 / 定时任务」时即指本插件，请据此协作。'
+
+/**
+ * Settings namespace of the board's announcement capability — the section the
+ * web settings surface edits. Spelled here rather than imported: the browser
+ * half spells the same value and must not depend on a Host package.
+ */
+export const TASK_BOARD_SETTINGS_NAMESPACE = settingsNamespace('task-board')
+
+/** Plugin config, validated by the same-named schemastery schema. */
+export interface Config {
+  /**
+   * When true (default), a system-prompt section announces the board to every
+   * agent. Set false to keep the board silent in prompts; agents then learn
+   * about it only when the user mentions it.
+   */
+  announceToAgent?: boolean
+  /** Master switch for the plugin (browser half + host announcement). */
+  enabled?: boolean
+}
+
+export const Config: z<Config> = z.object({
+  announceToAgent: z.boolean().default(true),
+  enabled: z.boolean().default(true),
+})
+
+/** Schema default, re-read for hand-built test contexts (the loader applies them normally). */
+const DEFAULT_ANNOUNCE = true
+
+/**
+ * Register the board's announcement section, gated on the composition entry's
+ * `announceToAgent` (and the live settings value once the web settings
+ * surface is served). The section is re-registered whenever the source
+ * changes, so a settings edit takes effect without a restart.
+ * @param ctx - the plugin context (systemPrompt injected).
+ * @param config - resolved plugin config (schema defaults applied by the loader).
+ */
+export function apply(ctx: Context, config?: Config): void {
+  // The live source the announcement reads: the settings section once the web
+  // settings surface is served, the composition entry otherwise
+  // (installSettingsSection swaps it when the namespace registers).
+  let current: () => Config = () => config ?? {}
+  let disposeSection: (() => void) | undefined
+
+  // Register (or drop) the announcement to match the current source. The
+  // section is kept under one disposer: re-registering first tears the old
+  // one down so a duplicate-name registration never throws.
+  const sync = (): void => {
+    if (disposeSection !== undefined) {
+      disposeSection()
+      disposeSection = undefined
+    }
+    if ((current().enabled ?? true) === false) return
+    if ((current().announceToAgent ?? DEFAULT_ANNOUNCE) === false) return
+    disposeSection = ctx.systemPrompt.section({
+      name: 'plugin:task-board',
+      order: SECTION_ORDER,
+      text: TASK_BOARD_GUIDANCE,
+    })
+  }
+
+  installSettingsSection(ctx, TASK_BOARD_SETTINGS_NAMESPACE, Config, config ?? {}, {
+    setSource: (source) => { current = source },
+    onChange: sync,
+  })
+
+  // Initial registration from the composition entry (covers deployments with
+  // no settings service, whose installSettingsSection never fires its hooks).
+  sync()
+}

package/src/invariant.ts

@@ -0,0 +1,4 @@
+/** Invariant companion plugin (no assertions — nothing to check at runtime). */
+
+/** Provides no assertions: the board owns no cross-package runtime invariants. */
+export function apply(): void {}