dsh-agent-plugins-market 0.12.0 → 0.13.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 (35) hide show
  1. package/README.md +5 -4
  2. package/README.zh.md +14 -13
  3. package/client/client.js +827 -83
  4. package/client/client.js.map +1 -1
  5. package/lib/packages/market-bundle/src/application/catalog.js +12 -3
  6. package/lib/packages/market-bundle/src/application/instructions.js +521 -0
  7. package/lib/packages/market-bundle/src/index.js +51 -20
  8. package/lib/packages/market-bundle/src/routes-instructions.js +141 -0
  9. package/lib/packages/market-bundle/src/routes-tab-layout.js +118 -0
  10. package/lib/packages/market-contracts/src/contracts/instructions.js +26 -0
  11. package/lib/packages/market-contracts/src/contracts/market.js +7 -1
  12. package/lib/packages/market-contracts/src/contracts/tab-layout.js +70 -0
  13. package/lib/packages/market-runtime/src/application/state/tab-layout.js +96 -0
  14. package/lib/packages/market-runtime/src/index.js +2 -0
  15. package/lib/packages/market-runtime/src/runtime/core/source-auto-update.js +27 -9
  16. package/lib/packages/market-runtime/src/runtime/host/extension-session-state.js +36 -5
  17. package/lib/packages/market-runtime/src/runtime/host/tab-layout-service.js +73 -0
  18. package/lib/packages/market-translation/src/application/translation/localizer.js +10 -1
  19. package/lib/packages/market-translation/src/application/translation/service.js +6 -2
  20. package/lib/types/packages/market-bundle/src/application/catalog.d.ts +11 -2
  21. package/lib/types/packages/market-bundle/src/application/instructions.d.ts +70 -0
  22. package/lib/types/packages/market-bundle/src/index.d.ts +19 -0
  23. package/lib/types/packages/market-bundle/src/routes-instructions.d.ts +14 -0
  24. package/lib/types/packages/market-bundle/src/routes-tab-layout.d.ts +15 -0
  25. package/lib/types/packages/market-contracts/src/contracts/instructions.d.ts +123 -0
  26. package/lib/types/packages/market-contracts/src/contracts/market.d.ts +6 -0
  27. package/lib/types/packages/market-contracts/src/contracts/tab-layout.d.ts +66 -0
  28. package/lib/types/packages/market-runtime/src/application/state/tab-layout.d.ts +49 -0
  29. package/lib/types/packages/market-runtime/src/index.d.ts +3 -0
  30. package/lib/types/packages/market-runtime/src/runtime/core/source-auto-update.d.ts +17 -3
  31. package/lib/types/packages/market-runtime/src/runtime/host/extension-session-state.d.ts +18 -2
  32. package/lib/types/packages/market-runtime/src/runtime/host/tab-layout-service.d.ts +51 -0
  33. package/lib/types/packages/market-translation/src/application/translation/localizer.d.ts +10 -1
  34. package/lib/types/packages/market-translation/src/application/translation/service.d.ts +6 -2
  35. package/package.json +6 -4
package/README.md CHANGED
@@ -67,24 +67,25 @@ Terminal alternative: `dsh plugin --profile <name> add dsh-agent-plugins-market`
67
67
  - **Ten suite layouts.** Claude Code, Codex, Cursor, Kimi Code, ZCode, Qoder CLI, GitHub Copilot CLI, Universal `.plugin/`, [agent-plugins](https://agent-plugins.org) and manifest-less skill collections.
68
68
  - **Sources and downloads.** Add a Git repository, a local directory or an archive, adopt a checkout you cloned yourself, and refresh on demand. Pick a global or China mainland mirror, and refresh every source on a 6-hour timer if you want.
69
69
  - **Runtime injection.** Enabled suites add skills to the catalog and slash menu, commands as `/name`, agent personas to the subagent catalog, MCP tools as `mcp__*`, hooks to lifecycle events, and language servers to the `lsp` tool. Installing the plugin is the whole LSP setup.
70
- - **One workspace.** Seven tabs cover the market, the resources you author, and the services that run. Every tab has search, filters and a grid or list view.
70
+ - **One workspace.** Eight tabs cover the market, the instructions injected into a session, the resources you author, and the services that run. Every tab has search, filters and a grid or list view.
71
71
 
72
72
  ### Advanced
73
73
 
74
74
  - **MCP OAuth with nothing to declare.** A remote MCP server that answers `401` starts RFC 9728 discovery, dynamic client registration and PKCE authorization in your browser, and the granted token persists. OAuth is on by default, so a suite needs no declaration for it.
75
75
  - **Per-server MCP control.** Override a declaration without editing its source, switch one tool off, and set the tool-call and startup timeouts.
76
76
  - **Project and personal resources.** Turn on **Scan project Agent layouts** to read skills, commands, roles, MCP servers and hooks from the project's own directories. Author your own under `~/.agents/` as Markdown, and disable a resource without deleting its file.
77
- - **Per-workspace control.** Each workspace switches the six mounted surfaces off or on, keeps its own resource filters, and saves a resource-window setup as a favorite that works across projects.
77
+ - **Per-workspace control.** Each workspace switches the six mounted surfaces off or on, keeps its own resource filters, saves a resource-window setup as a favorite that works across projects, and stows tabs it does not need into the menu at the end of the tab row.
78
78
  - **Hooks that decide, not just observe.** Ten events apply what the hook returns: tool deny, ask and allow, added context, corrective feedback, a forced continuation, and a real halt for `continue: false`. A hook row opens a declaration card with its event, matcher and timeout, plus a dry run in your home directory. [Hook event coverage](docs/reference/hooks-event-coverage.md) lists every event and the three reference fields the host cannot apply yet.
79
79
  - **Bilingual by default.** The interface and the injected prompts follow the host language. Descriptions and documents show the original, a translation or both, and stay cached until you clear them.
80
80
 
81
81
  ## Everyday use
82
82
 
83
- The workspace has seven tabs:
83
+ The workspace has eight tabs:
84
84
 
85
85
  | Tab | Use it to |
86
86
  | -------------- | ----------------------------------------------------------------------------------- |
87
87
  | Market | Add sources, preview suites, install or remove them, and switch them on or off. |
88
+ | Instructions | See the AGENTS.md chain a session injects, and create, edit or delete those files. |
88
89
  | Skills | Browse skills and create or edit your own reusable instructions. |
89
90
  | Commands | Manage prompt templates invoked as `/name`. |
90
91
  | Agent personas | Save role instructions and model settings, then delegate to them. |
@@ -94,7 +95,7 @@ The workspace has seven tabs:
94
95
 
95
96
  A **source** is where content comes from. A **suite** is an installable unit discovered there. Adding a source discovers its suites. Enabling a suite turns its runtime capabilities on.
96
97
 
97
- Your own content lives under `~/.agents/`: skills, commands and personas as Markdown, hooks in `hooks.json`, and the MCP and LSP services you add in `mcp.json` and `lsp.json`. Project-native resources stay in the project. See [storage and discovery](https://sivan757.github.io/dsh-agent-plugins-market/docs/resources/#storage-and-discovery).
98
+ Your own content lives under `~/.agents/`: skills, commands and personas as Markdown, hooks in `hooks.json`, and the MCP and LSP services you add in `mcp.json` and `lsp.json`. The [instructions guide](https://sivan757.github.io/dsh-agent-plugins-market/docs/instructions/) explains the AGENTS.md chain the host injects and the page that edits it. Project-native resources stay in the project. See [storage and discovery](https://sivan757.github.io/dsh-agent-plugins-market/docs/resources/#storage-and-discovery).
98
99
 
99
100
  ## Compatibility
100
101
 
package/README.zh.md CHANGED
@@ -67,34 +67,35 @@
67
67
  - **十种套件布局。** Claude Code、Codex、Cursor、Kimi Code、ZCode、Qoder CLI、GitHub Copilot CLI、通用 `.plugin/`、[agent-plugins](https://agent-plugins.org) 以及无清单的技能集合。
68
68
  - **来源与下载。** 添加 Git 仓库、本地目录或压缩包,也可以接管你自己克隆的检出目录并随时刷新。镜像线路可选全球或中国大陆;需要时还可以每 6 小时自动刷新全部来源。
69
69
  - **运行时注入。** 启用套件后,技能进入技能目录与斜杠菜单,命令成为 `/名称`,代理角色进入子代理目录,MCP 工具以 `mcp__*` 前缀出现,hooks 挂到宿主生命周期事件,语言服务器接入 `lsp` 工具;LSP 装上插件即完成配置。
70
- - **一个工作区。** 七个页签覆盖市场、你自己创作的内容与正在运行的服务,都支持搜索、筛选和卡片或列表视图。
70
+ - **一个工作区。** 八个页签覆盖市场、注入会话的指令、你自己创作的内容与正在运行的服务,都支持搜索、筛选和卡片或列表视图。
71
71
 
72
72
  ### 进阶能力
73
73
 
74
74
  - **MCP OAuth,无需声明。** 远端 MCP 服务返回 `401` 时,自动完成 RFC 9728 发现、动态客户端注册与 PKCE 授权,浏览器授权后令牌持久保存。OAuth 默认开启,套件不需要为此写任何声明。
75
75
  - **逐个 MCP 服务精调。** 不改动来源就能覆盖某条声明,单独关闭某个工具,并设置工具调用与启动超时。
76
76
  - **项目资源与自己创作的内容。** 打开**扫描项目 Agent 布局**后,无需安装即可读取项目自身目录中的技能、命令、角色、MCP 服务与 hooks。自己的内容放在 `~/.agents/` 下,以 Markdown 编写;停用资源不必删除文件。
77
- - **按工作区生效的控制。** 每个工作区可以单独开关六类挂载能力,保留自己的资源筛选条件,并把资源窗口配置存为可跨项目使用的收藏。
77
+ - **按工作区生效的控制。** 每个工作区可以单独开关六类挂载能力,保留自己的资源筛选条件,把资源窗口配置存为可跨项目使用的收藏,还可以把用不到的页签收纳进页签行末尾的菜单。
78
78
  - **Hooks 会真正生效,而不只是旁观。** 十个事件会应用 hook 返回的结果:工具拦截、确认与放行,补充上下文,纠正反馈,强制续跑,以及 `continue: false` 带来的真正中止。每个 hook 行都能打开声明卡,查看事件、匹配条件与超时,并在用户根目录试运行一次。[Hook 事件覆盖](docs/reference/hooks-event-coverage.md)列出了全部事件,以及宿主暂时无法应用的三个字段。
79
79
  - **默认双语。** 界面与注入的提示词跟随宿主语言。描述与文档可显示原文、译文或双语,结果缓存在本地直到你清空缓存。
80
80
 
81
81
  ## 日常使用
82
82
 
83
- 工作区包含七个页签:
83
+ 工作区包含八个页签:
84
84
 
85
- | 页签 | 可以做什么 |
86
- | -------- | ------------------------------------------------ |
87
- | 插件市场 | 添加来源、预览套件、安装或卸载,以及启用或停用。 |
88
- | 技能 | 浏览技能,创建或编辑自己的可复用指令。 |
89
- | 命令 | 管理通过 `/名称` 调用的提示词模板。 |
90
- | 代理角色 | 保存角色指令与模型配置,然后委派给它们。 |
91
- | MCP 服务 | 新增服务,或配置已安装的服务及其凭据与授权。 |
92
- | LSP 服务 | 新增并配置语言服务器,查看运行状态。 |
93
- | Hooks | 查看已配置的 hook 及其事件、匹配条件与超时。 |
85
+ | 页签 | 可以做什么 |
86
+ | -------- | ----------------------------------------------------------- |
87
+ | 插件市场 | 添加来源、预览套件、安装或卸载,以及启用或停用。 |
88
+ | 指令 | 查看会话注入的 AGENTS.md 链条,并创建、编辑或删除这些文件。 |
89
+ | 技能 | 浏览技能,创建或编辑自己的可复用指令。 |
90
+ | 命令 | 管理通过 `/名称` 调用的提示词模板。 |
91
+ | 代理角色 | 保存角色指令与模型配置,然后委派给它们。 |
92
+ | MCP 服务 | 新增服务,或配置已安装的服务及其凭据与授权。 |
93
+ | LSP 服务 | 新增并配置语言服务器,查看运行状态。 |
94
+ | Hooks | 查看已配置的 hook 及其事件、匹配条件与超时。 |
94
95
 
95
96
  **来源(source)**表示内容来自哪里,**套件(suite)**是从中发现的可安装单元。添加来源用于发现套件,启用套件决定其运行时能力是否生效。
96
97
 
97
- 你自己创作的内容都放在 `~/.agents/` 下:技能、命令和角色是 Markdown 文件,hooks 放在 `hooks.json`,工作区里新增的 MCP 与 LSP 服务分别保存在 `mcp.json` 与 `lsp.json`。项目原生资源继续保留在项目中。路径与优先级见[存储与发现](https://sivan757.github.io/dsh-agent-plugins-market/docs/zh/resources/#存储与发现)。
98
+ 你自己创作的内容都放在 `~/.agents/` 下:技能、命令和角色是 Markdown 文件,hooks 放在 `hooks.json`,工作区里新增的 MCP 与 LSP 服务分别保存在 `mcp.json` 与 `lsp.json`。[指令指南](https://sivan757.github.io/dsh-agent-plugins-market/docs/zh/instructions/)说明宿主注入的 AGENTS.md 链条与编辑它的页面。项目原生资源继续保留在项目中。路径与优先级见[存储与发现](https://sivan757.github.io/dsh-agent-plugins-market/docs/zh/resources/#存储与发现)。
98
99
 
99
100
  ## 兼容性
100
101