prompt-skill-armory 0.4.1

package/packages/client-ui-switchblade/src/client/locales.ts

@@ -0,0 +1,106 @@
+/**
+ * Switchblade management page dictionaries.
+ * @module @deepseek-ai/dsh-client-ui-switchblade
+ */
+
+/** Locale namespace owned by this plugin (settings.* prefix per the slot contract). */
+export const NS = 'settings.switchblade'
+
+/** Keys translated by this plugin. */
+export type SwitchbladeKey =
+  | 'nav' | 'skillsTitle' | 'presetsTitle' | 'promptsTitle' | 'commandsTitle'
+  | 'empty' | 'enabled' | 'disabled' | 'installed'
+  | 'refresh' | 'setDefault' | 'loadFailed'
+  | 'globalHint' | 'promptNamePlaceholder' | 'promptDescPlaceholder' | 'promptContentPlaceholder'
+  | 'addPrompt' | 'enable' | 'disable' | 'delete'
+  | 'installSkill' | 'skillNamePlaceholder' | 'skillDescPlaceholder' | 'skillContentPlaceholder'
+  | 'install' | 'uninstall' | 'pickSkillFile' | 'searchPlaceholder'
+  | 'installedSkills' | 'installedSkillsGoRight' | 'manage'
+  | 'localSkills' | 'agentPresetsTitle' | 'edit' | 'save' | 'cancel' | 'addSkill'
+  | 'pickZipFile' | 'cliHint'
+
+/** zh-CN copy. */
+export const zh: Record<SwitchbladeKey, string> = {
+  nav: 'Prompt-SkillArmory',
+  skillsTitle: '技能',
+  presetsTitle: '提示词预设',
+  promptsTitle: '提示词',
+  commandsTitle: '命令',
+  empty: '(空)',
+  enabled: '启用',
+  disabled: '停用',
+  installed: '已装',
+  refresh: '刷新',
+  setDefault: '设为默认',
+  loadFailed: '加载失败',
+  globalHint: '· 全局生效',
+  promptNamePlaceholder: '提示词名称',
+  promptDescPlaceholder: '描述（可选）',
+  promptContentPlaceholder: '提示词内容…',
+  addPrompt: '添加提示词',
+  enable: '启用',
+  disable: '停用',
+  delete: '删除',
+  installSkill: '技能',
+  skillNamePlaceholder: '技能名称（kebab-case）',
+  skillDescPlaceholder: '描述（可选）',
+  skillContentPlaceholder: '技能指令内容…',
+  install: '安装',
+  uninstall: '卸载',
+  pickSkillFile: '选择本地 .md 技能文件导入',
+  searchPlaceholder: '搜索…',
+  installedSkills: '本地化技能',
+  installedSkillsGoRight: '已安装的技能在右侧第四列管理',
+  manage: '托管',
+  localSkills: '本地扫描技能',
+  agentPresetsTitle: 'Agent预设',
+  edit: '编辑',
+  save: '保存',
+  cancel: '取消',
+  addSkill: '添加技能',
+  pickZipFile: '导入 .zip 技能包',
+  cliHint: 'CLI 直接安装（在会话里输入）：',
+}
+
+/** en-US copy. */
+export const en: Record<SwitchbladeKey, string> = {
+  nav: 'Prompt-SkillArmory',
+  skillsTitle: 'Skills',
+  presetsTitle: 'Prompt Presets',
+  promptsTitle: 'Prompts',
+  commandsTitle: 'Commands',
+  empty: '(empty)',
+  enabled: 'enabled',
+  disabled: 'disabled',
+  installed: 'installed',
+  refresh: 'Refresh',
+  setDefault: 'Set default',
+  loadFailed: 'Failed to load',
+  globalHint: '· global',
+  promptNamePlaceholder: 'Prompt name',
+  promptDescPlaceholder: 'Description (optional)',
+  promptContentPlaceholder: 'Prompt content…',
+  addPrompt: 'Add prompt',
+  enable: 'Enable',
+  disable: 'Disable',
+  delete: 'Delete',
+  installSkill: 'Skills',
+  skillNamePlaceholder: 'Skill name (kebab-case)',
+  skillDescPlaceholder: 'Description (optional)',
+  skillContentPlaceholder: 'Skill instructions…',
+  install: 'Install',
+  uninstall: 'Uninstall',
+  pickSkillFile: 'Pick a local .md skill file',
+  searchPlaceholder: 'Search…',
+  installedSkills: 'Local skills',
+  installedSkillsGoRight: 'Installed skills are managed in the right column',
+  manage: 'Manage',
+  localSkills: 'Scanned skills',
+  agentPresetsTitle: 'Agent Presets',
+  edit: 'Edit',
+  save: 'Save',
+  cancel: 'Cancel',
+  addSkill: 'Add skill',
+  pickZipFile: 'Import .zip skill bundle',
+  cliHint: 'Install via CLI (type in a session):',
+}

package/packages/client-ui-switchblade/src/client/store.ts

@@ -0,0 +1,350 @@
+/**
+ * Switchblade section data controller: reads the skill catalog and the prompt
+ * preset roster through the existing connection RPC surface (no Typert
+ * generation needed — these methods are already wired).
+ * @module @deepseek-ai/dsh-client-ui-switchblade
+ */
+
+import type { ConnectionHandle, SessionId } from '@deepseek-ai/dsh-api-remotes/client'
+import { createSnapshotStore, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client'
+
+/** A skill row as reported by skill.list. */
+export interface SkillRow {
+  readonly name: string
+  readonly description: string
+  readonly modelInvocable: boolean
+}
+
+/** A prompt-preset row as reported by agentPreset.list. */
+export interface PresetRow {
+  readonly id: string
+  readonly name?: string
+  readonly description?: string
+  readonly isDefault: boolean
+  readonly trust: string
+  readonly broken?: string
+}
+
+/** A command row (not yet wired to an RPC; kept for the section's third group). */
+export interface CommandRow {
+  readonly name: string
+  readonly description: string
+}
+
+/** One user-authored prompt (mirrors the Host ManagedPrompt). */
+export interface PromptRow {
+  readonly id: string
+  readonly name: string
+  readonly description: string
+  readonly content: string
+  readonly order: number
+  readonly enabled: boolean
+  readonly isDefault: boolean
+}
+
+/** An installed skill row. */
+export interface InstalledSkillRow {
+  readonly name: string
+  readonly description: string
+  readonly content: string
+  /** Whether this skill is currently registered (enabled) as a runtime skill. */
+  readonly enabled: boolean
+}
+
+/** The section's loaded view state. */
+export interface SwitchbladeSectionState {
+  readonly status: 'idle' | 'loading' | 'ready' | 'error'
+  readonly message?: string
+  readonly skills: readonly SkillRow[]
+  readonly presets: readonly PresetRow[]
+  readonly commands: readonly CommandRow[]
+  readonly prompts: readonly PromptRow[]
+  readonly installedSkills: readonly InstalledSkillRow[]
+}
+
+/** Initial (idle) state. */
+const IDLE: SwitchbladeSectionState = {
+  status: 'idle',
+  skills: [],
+  presets: [],
+  commands: [],
+  prompts: [],
+  installedSkills: [],
+}
+
+/** Normalize a thrown wire error to a message. */
+function messageOf(error: unknown): string {
+  return error instanceof Error ? error.message : String(error)
+}
+
+/**
+ * Data controller bound to one session's connection.
+ * @param api - the connection's API client.
+ * @param sessionId - session the skill catalog resolves against.
+ */
+export class SwitchbladeSectionController {
+  /** Snapshot store backing the section's view state. */
+  readonly store: SnapshotStore<SwitchbladeSectionState> = createSnapshotStore(IDLE)
+
+  constructor(
+    private readonly api: ConnectionHandle['api'],
+    private readonly sessionId?: () => SessionId | undefined,
+  ) {}
+
+  /**
+   * Load skills, presets, prompts, and installed skills. Prompts and installed
+   * skills come from the `switchblade` settings namespace (the Host watches
+   * it and re-injects on change).
+   */
+  async load(): Promise<void> {
+    this.store.set({ ...IDLE, status: 'loading' })
+    try {
+      // skill.list requires a live session; without one we skip it (never
+      // hang). Presets + settings always resolve, so the panel opens reliably.
+      const sessionId = this.sessionId?.()
+      const calls: Promise<unknown>[] = [
+        this.api.agentPresets.list({}),
+        this.api.settings.describe({}),
+      ]
+      if (sessionId !== undefined) calls.push(this.api.skills.list({ sessionId }))
+      const [presetRes, settingsRes, skillRes] = await Promise.all(calls) as [
+        Awaited<ReturnType<ConnectionHandle['api']['agentPresets']['list']>>,
+        Awaited<ReturnType<ConnectionHandle['api']['settings']['describe']>>,
+        Awaited<ReturnType<ConnectionHandle['api']['skills']['list']>> | undefined,
+      ]
+      if (!presetRes.result.ok) throw new Error(`agentPreset.list: ${presetRes.result.error.message}`)
+      if (!settingsRes.result.ok) throw new Error(`settings.describe: ${settingsRes.result.error.message}`)
+
+      const skills: SkillRow[] = skillRes !== undefined && skillRes.result.ok
+        ? skillRes.result.value.skills.map((skill) => ({
+          name: skill.name,
+          description: skill.description,
+          modelInvocable: skill.modelInvocable,
+        }))
+        : []
+
+      const presets: PresetRow[] = presetRes.result.value.presets.map((preset) => ({
+        id: preset.id,
+        isDefault: preset.isDefault,
+        trust: preset.trust,
+        ...preset.name === undefined ? {} : { name: preset.name },
+        ...preset.description === undefined ? {} : { description: preset.description },
+        ...preset.broken === undefined ? {} : { broken: preset.broken },
+      }))
+
+      const switchbladeSection = this.sectionFromSettings(settingsRes.result.value, 'switchblade')
+      const prompts: PromptRow[] = Array.isArray(switchbladeSection?.prompts) ? switchbladeSection.prompts : []
+      const installedSkills: InstalledSkillRow[] = Array.isArray(switchbladeSection?.installedSkills)
+        ? switchbladeSection.installedSkills.map((s: { name?: string; description?: string; content?: string; enabled?: boolean }) => ({
+          name: s.name ?? '',
+          description: s.description ?? '',
+          content: s.content ?? '',
+          enabled: s.enabled ?? true,
+        }))
+        : []
+
+      this.store.set({
+        status: 'ready',
+        skills,
+        presets,
+        commands: [],
+        prompts,
+        installedSkills,
+      })
+    } catch (error) {
+      this.store.set({ ...IDLE, status: 'error', message: messageOf(error) })
+    }
+  }
+
+  /** Read one namespace's user section from a settings.describe value. */
+  private sectionFromSettings(value: unknown, ns: string): Record<string, unknown> | undefined {
+    if (typeof value !== 'object' || value === null) return undefined
+    const entries = (value as { namespaces?: unknown }).namespaces
+    if (!Array.isArray(entries)) return undefined
+    for (const entry of entries) {
+      const row = entry as { ns?: unknown; value?: unknown }
+      if (row.ns === ns) {
+        const section = row.value
+        return typeof section === 'object' && section !== null ? section as Record<string, unknown> : undefined
+      }
+    }
+    return undefined
+  }
+
+  // ---------------------------------------------------------------------------
+  // Prompt CRUD (writes to the switchblade settings namespace; Host re-injects)
+  // ---------------------------------------------------------------------------
+
+  /** Add a prompt. */
+  async addPrompt(input: { name: string; description: string; content: string }): Promise<void> {
+    const res = await this.api.settings.mutate({
+      ns: 'switchblade',
+      ops: [{ op: 'set', path: ['prompts'], value: [...this.currentPrompts(), {
+        id: this.slugify(input.name),
+        name: input.name,
+        description: input.description,
+        content: input.content,
+        order: this.currentPrompts().length,
+        enabled: true,
+        isDefault: this.currentPrompts().length === 0,
+      }] }],
+    })
+    if (!res.result.ok) throw new Error(res.result.error.message)
+    await this.load()
+  }
+
+  /** Toggle one prompt's enabled state. */
+  async setPromptEnabled(id: string, enabled: boolean): Promise<void> {
+    const next = this.currentPrompts().map((p) => p.id === id ? { ...p, enabled } : p)
+    await this.writePrompts(next)
+  }
+
+  /** Mark one prompt default; clears others. */
+  async setDefaultPrompt(id: string): Promise<void> {
+    const next = this.currentPrompts().map((p) => ({ ...p, isDefault: p.id === id }))
+    await this.writePrompts(next)
+  }
+
+  /** Delete one prompt. */
+  async deletePrompt(id: string): Promise<void> {
+    const next = this.currentPrompts().filter((p) => p.id !== id)
+    await this.writePrompts(next)
+  }
+
+  /** Update a prompt's name/description/content. */
+  async updatePrompt(id: string, patch: { name?: string; description?: string; content?: string }): Promise<void> {
+    const next = this.currentPrompts().map((p) => p.id === id ? {
+      ...p,
+      name: patch.name?.trim() || p.name,
+      description: patch.description ?? p.description,
+      content: patch.content ?? p.content,
+    } : p)
+    await this.writePrompts(next)
+  }
+
+  /** Persist the prompt list through the settings RPC. */
+  private async writePrompts(prompts: readonly PromptRow[]): Promise<void> {
+    const res = await this.api.settings.mutate({
+      ns: 'switchblade',
+      ops: [{ op: 'set', path: ['prompts'], value: prompts }],
+    })
+    if (!res.result.ok) throw new Error(res.result.error.message)
+    await this.load()
+  }
+
+  /** Current prompt list from the loaded snapshot. */
+  private currentPrompts(): readonly PromptRow[] {
+    return this.store.getSnapshot().prompts
+  }
+
+  /** Sluggify a name into an id. */
+  private slugify(value: string): string {
+    const slug = value.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '')
+    return slug.length > 0 ? slug : `prompt-${Date.now()}`
+  }
+
+  // ---------------------------------------------------------------------------
+  // Skill install/uninstall (writes to the switchblade settings namespace)
+  // ---------------------------------------------------------------------------
+
+  /** Install a skill from a name + content (enabled by default). */
+  async installSkill(input: { name: string; description: string; content: string }): Promise<void> {
+    const next = [...this.currentInstalledSkills(), {
+      name: input.name,
+      description: input.description,
+      content: input.content,
+      enabled: true,
+    }]
+    const res = await this.api.settings.mutate({
+      ns: 'switchblade',
+      ops: [{ op: 'set', path: ['installedSkills'], value: next }],
+    })
+    if (!res.result.ok) throw new Error(res.result.error.message)
+    await this.load()
+  }
+
+  /** Toggle one installed skill's enabled state. */
+  async setSkillEnabled(name: string, enabled: boolean): Promise<void> {
+    const next = this.currentInstalledSkills().map((s) => s.name === name ? { ...s, enabled } : s)
+    const res = await this.api.settings.mutate({
+      ns: 'switchblade',
+      ops: [{ op: 'set', path: ['installedSkills'], value: next }],
+    })
+    if (!res.result.ok) throw new Error(res.result.error.message)
+    await this.load()
+  }
+
+  /** Uninstall one installed skill. */
+  async uninstallSkill(name: string): Promise<void> {
+    const next = this.currentInstalledSkills().filter((s) => s.name !== name)
+    const res = await this.api.settings.mutate({
+      ns: 'switchblade',
+      ops: [{ op: 'set', path: ['installedSkills'], value: next }],
+    })
+    if (!res.result.ok) throw new Error(res.result.error.message)
+    await this.load()
+  }
+
+  /** Update an installed skill's name/description/content. */
+  async updateSkill(name: string, patch: { name?: string; description?: string; content?: string }): Promise<void> {
+    const next = this.currentInstalledSkills().map((s) => s.name === name ? {
+      ...s,
+      name: patch.name?.trim() || s.name,
+      description: patch.description ?? s.description,
+      content: patch.content ?? s.content,
+    } : s)
+    const res = await this.api.settings.mutate({
+      ns: 'switchblade',
+      ops: [{ op: 'set', path: ['installedSkills'], value: next }],
+    })
+    if (!res.result.ok) throw new Error(res.result.error.message)
+    await this.load()
+  }
+
+  /** Current installed skills from the loaded snapshot. */
+  private currentInstalledSkills(): readonly InstalledSkillRow[] {
+    return this.store.getSnapshot().installedSkills
+  }
+
+  /**
+   * Queue a zip archive (base64) for extraction into ~/.dsh/skills. The Host
+   * watch sees pendingZip and installs it (skil-filesystem then discovers it).
+   */
+  async installSkillFromZip(name: string, dataBase64: string): Promise<void> {
+    const res = await this.api.settings.mutate({
+      ns: 'switchblade',
+      ops: [{ op: 'set', path: ['pendingZip'], value: { name, dataBase64 } }],
+    })
+    if (!res.result.ok) throw new Error(res.result.error.message)
+    // Wait a tick for the Host watch to extract, then refresh.
+    await new Promise((r) => setTimeout(r, 500))
+    await this.load()
+  }
+
+  /** Set the default prompt preset. */
+  async setDefaultPreset(id: string): Promise<void> {
+    const res = await this.api.settings.update({ ns: 'agent-presets', patch: { default: id } })
+    if (!res.result.ok) throw new Error(res.result.error.message)
+    await this.load()
+  }
+}
+
+/** The section's injected face: hooks (snapshot store) + actions. */
+export interface SwitchbladeSectionInjected {
+  hooks: {
+    /** Page snapshot bound by the renderer as useSwitchblade. */
+    switchblade: SnapshotStore<SwitchbladeSectionState>
+  }
+  load: () => Promise<void>
+  setDefaultPreset: (id: string) => Promise<void>
+  addPrompt: (input: { name: string; description: string; content: string }) => Promise<void>
+  updatePrompt: (id: string, patch: { name?: string; description?: string; content?: string }) => Promise<void>
+  setPromptEnabled: (id: string, enabled: boolean) => Promise<void>
+  setDefaultPrompt: (id: string) => Promise<void>
+  deletePrompt: (id: string) => Promise<void>
+  installSkill: (input: { name: string; description: string; content: string }) => Promise<void>
+  updateSkill: (name: string, patch: { name?: string; description?: string; content?: string }) => Promise<void>
+  setSkillEnabled: (name: string, enabled: boolean) => Promise<void>
+  uninstallSkill: (name: string) => Promise<void>
+  installSkillFromZip: (name: string, dataBase64: string) => Promise<void>
+}

package/packages/client-ui-switchblade/src/css-modules.d.ts

@@ -0,0 +1,5 @@
+/** CSS module type shim for .module.css imports (unused; kept for parity). */
+declare module '*.module.css' {
+  const classes: Record<string, string>
+  export default classes
+}

package/packages/client-ui-switchblade/src/index.ts

@@ -0,0 +1,12 @@
+/**
+ * Switchblade management page, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+
+/** Host plugin body — no host-side behavior for this UI plugin. */
+export function apply(): void {}
+
+/** Cordis plugin identity (host face). */
+export const name = 'ui-switchblade'

package/packages/client-ui-switchblade/src/invariant.ts

@@ -0,0 +1,10 @@
+/**
+ * Validation invariants for `@deepseek-ai/dsh-client-ui-switchblade`.
+ * @module @deepseek-ai/dsh-client-ui-switchblade
+ */
+
+/** The settings.section id this package registers. */
+export const SECTION_ID = 'switchblade'
+
+/** Display order in the settings nav (after Models/Agent Presets). */
+export const SECTION_ORDER = 30