Files
deepseek-harness/packages/experimental/plugin-recommendations/src/skill.ts
T
ZiyaZhang fcb7340be1 refactor(experimental): register plugin recommendations as an action card kind
Plugin recommendations now proposes through the shared propose_action tool
instead of a dsh-action answer block. The Host registers the
enable_official_plugin kind with the action card service: the
official-plugins skill, details holding the plugin name, the Enable verb
with global access, and the enabled, already-enabled and failed phases,
whose data carries the application outcome and the management error code.
The package drops its own projection, Remote act, status notice and
persisted record; it keeps the describe Remote for card text. The bundle
inserts the shared card rows beside its own, as Personalized pages does.
The browser half registers a card body in the shared frame that keeps the
catalog text cache, the reserved loading lines, the single details target
and the Enable and Not now footer. The skill's submission section now asks
for one propose_action call.
2026-10-22 07:18:05 -07:00

46 lines
2.6 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/** On-demand official-plugin catalog for explicit product-use needs. */
import { readFile } from 'node:fs/promises'
import type { Context } from '@deepseek-ai/cordis'
import { BUNDLED_SKILL_RANK, type SkillCandidate } from '@deepseek-ai/dsh-skill'
import type { BundleInfo } from '@deepseek-ai/dsh-plugin-manager/types'
/** Shipped optional plugins only; no arbitrary install target is accepted.
* @param bundle - a profile bundle as the plugin manager reports it.
* @returns whether a card may offer and enable it.
*/
export function eligible(bundle: BundleInfo): boolean {
return bundle.official && bundle.optional && bundle.availability !== 'missing'
&& bundle.readOnlyReason === undefined && bundle.error === undefined
}
/** The eligible plugins as the skill lists them: name, title, description and selection. */
function catalogOf(bundles: readonly BundleInfo[]): string {
return JSON.stringify(bundles.filter(eligible).map(bundle => ({
name: bundle.name, title: bundle.meta?.title ?? bundle.name,
description: bundle.meta?.description ?? bundle.description ?? '', enabled: bundle.enabled,
})))
}
/** Register the experiment's skill without adding a model tool or a system-prompt section.
* @param ctx - Owning plugin context with skill and plugin registries.
*/
export function registerOfficialPluginsSkill(ctx: Context): void {
const candidate: SkillCandidate = {
name: 'official-plugins',
description: 'Check DSH’s optional plugins when the user asks how to do or use something in this app, whether it can, or says a capability is missing or should change: tools, input, thinking or title display, session search, terminals, worktrees, agent teams, desktop control, automation, access, approvals, badges or signatures, plugins or plugin sources. Not a request to develop DSH, even in its own repository: load before reading files or source. Not for ordinary tasks, quoted wishes or declined offers.',
invocation: { modelInvocable: true, userInvocable: false },
provider: 'dsh-official-plugins', source: 'bundled', rank: BUNDLED_SKILL_RANK, locator: null,
}
ctx.skills.registerProvider(() => ({
name: candidate.provider,
list: () => Promise.resolve([candidate]),
async get(_candidate, { signal }) {
const policy = await readFile(new URL('../skills/official-plugins.md', import.meta.url), { encoding: 'utf8', signal })
const catalog = catalogOf(await ctx.pluginManager.listBundles())
signal?.throwIfAborted()
const { rank: _rank, locator: _locator, ...entry } = candidate
return { ...entry, content: `${policy}\n## Official plugins\n\n${catalog}` }
},
}))
}