@banbolee/dsh-fish-shell 0.4.1 → 0.5.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.
@@ -1,241 +0,0 @@
1
- # The `standard` agent preset: the full coding agent, mounted once per process.
2
- #
3
- # This file is an AGENT-PLANE composition. The roster mounts it ONCE under a
4
- # standing scope; every session naming it joins by scope parentage, so the
5
- # tools and prompt sections registered here cover each joined agent while a
6
- # session's own state stays keyed per Session/Agent inside the plugins. The
7
- # host composition (`base.cordis.yml` + `web.cordis.yml`) keeps everything a
8
- # preset must not own: the registries themselves, the sandbox and approval
9
- # stack, persistence, and the model route.
10
- #
11
- # A service row here MUST sit inside a group carrying an `isolate` realm.
12
- # Without one it publishes into the root realm, where it is process-global —
13
- # another preset publishing the same name collides, and a host reader would
14
- # resolve one preset's instance for every session; `dsh-agent-presets` rejects
15
- # that at mount. `true` means an entry-local realm: this standing mount's own
16
- # private instance, apart from every other preset's. (A shared label does NOT
17
- # pool instances — `provide()` throws on the second registration under the
18
- # same realm symbol; labels join REALMS, and are not what this file needs.)
19
-
20
- # ── identity ────────────────────────────────────────────────────────────────
21
-
22
- # The preset's own persona, shadowing the deployment default for this agent.
23
- # `{{model}}` and `{{cwd}}` resolve from the agent's own route and workspace.
24
- - id: persona
25
- name: '@deepseek-ai/dsh-persona'
26
- config:
27
- prefix: >-
28
- You are a coding agent powered by the {{model}} model. Your working directory is {{cwd}}.
29
-
30
- - id: agent-instructions
31
- name: '@deepseek-ai/dsh-agent-instructions'
32
- config:
33
- maxBytes: 65536
34
-
35
- # ── shell ───────────────────────────────────────────────────────────────────
36
-
37
- # The @banbolee/dsh-fish-shell bundle mounts the model-facing `fish` tool on the HOST
38
- # plane (global), so this preset carries no shell tool row — agents here see
39
- # exactly one shell tool, `fish`, and no bash tool. The fish executor
40
- # (FishSandboxExecutor) supplies ctx.shell on the host plane.
41
- # ── filesystem ──────────────────────────────────────────────────────────────
42
-
43
- # Both register into the host `tools` registry and provide nothing, so
44
- # they need no realm. The `fs` service and its policy stay in the host.
45
- - id: tool-fs
46
- name: '@deepseek-ai/dsh-tool-fs'
47
-
48
- - id: tool-fs-search
49
- name: '@deepseek-ai/dsh-tool-fs-search'
50
- config:
51
- sampleOverCapGlobResults: false
52
-
53
- # ── background jobs ────────────────────────────────────────────────────────
54
-
55
- # Only the model-facing controls. The task REGISTRY stays on the host plane:
56
- # its producers sit outside any realm this file could put it in — `tool-bash`
57
- # above resolves it with `ctx.get`, and an entry-local realm here is invisible
58
- # to every sibling row, so `run_in_background` would answer "background jobs
59
- # unavailable" while these controls sat in the catalog. The registry is keyed by
60
- # owning agent anyway, so one host instance serves every session. What a preset
61
- # chooses is whether its agent can collect and stop background work at all.
62
- - id: tool-jobs
63
- name: '@deepseek-ai/dsh-tool-jobs'
64
-
65
- # ── skills ──────────────────────────────────────────────────────────────────
66
-
67
- # The skill REGISTRY lives in the host composition and is layered per scope:
68
- # these rows register into THIS preset's layer of it, so they need no realm.
69
- # `skill-filesystem` contributes local-root discovery for agents on this preset, and
70
- # `tool-skill` gives them the catalog and loader; the merged catalog also
71
- # carries whatever the deployment registered globally (repository plugins).
72
- - id: skill-filesystem
73
- name: '@deepseek-ai/dsh-skill-filesystem'
74
-
75
- - id: tool-skill
76
- name: '@deepseek-ai/dsh-tool-skill'
77
-
78
- # ── goals ───────────────────────────────────────────────────────────────────
79
-
80
- # Only the model-facing tool. The goal SERVICE, its session driver, and the
81
- # `/goal` command stay on the host plane: the Gateway serves the goal domain as
82
- # Remote endpoints whose receiver comes from a generated descriptor, so it
83
- # resolves `goals` on the host and an entry-local realm here would hide it. The
84
- # registry is keyed by session anyway, so one host instance serves every
85
- # session. What a preset chooses is whether its agent can call the goal tool.
86
- - id: tool-goal
87
- name: '@deepseek-ai/dsh-tool-goal'
88
-
89
- # ── plan mode ───────────────────────────────────────────────────────────────
90
-
91
- # Plan state is per-agent by nature, so an entry-local realm is not a
92
- # workaround here — it is the correct lifetime.
93
- - id: planning
94
- name: cordis:group
95
- group: true
96
- isolate:
97
- planMode: true
98
- config:
99
- - id: plan-mode
100
- name: '@deepseek-ai/dsh-plan-mode'
101
- config:
102
- section: |
103
- You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
104
-
105
- Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
106
-
107
- The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
108
-
109
- Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
110
-
111
- Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
112
-
113
- When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
114
-
115
- # ── compaction ──────────────────────────────────────────────────────────────
116
-
117
- # `compaction-basic` reads `toolResultPrune` through `ctx.get`, so the pruner must
118
- # share this realm rather than sit outside it.
119
- #
120
- # `tokenMeter` is deliberately NOT in this realm: the meter stays on the HOST
121
- # plane, and the rows here resolve that one instance. It takes no configuration,
122
- # keys every fold by Session, and owns the context-meter projection units the
123
- # browser reads for every session — behind a realm those units would come and go
124
- # with whichever presets happen to be mounted. What a preset chooses is whether
125
- # its agent compacts at all, which is `compaction-basic` below.
126
- - id: compaction
127
- name: cordis:group
128
- group: true
129
- isolate:
130
- compaction: true
131
- toolResultPruner: true
132
- config:
133
- - id: compaction-basic
134
- name: '@deepseek-ai/dsh-compaction-basic'
135
-
136
- - id: command-compact
137
- name: '@deepseek-ai/dsh-command-compact'
138
-
139
- - id: tool-result-pruner
140
- name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
141
- config:
142
- thresholdChars: 8192
143
- headChars: 4096
144
- tailChars: 1024
145
-
146
- # ── delegation and workflows ────────────────────────────────────────────────
147
-
148
- # The `subagents` registry and its spawn/fork backends live in the HOST
149
- # composition: the registry is a process singleton whose cross-session queries
150
- # the api-proxy serves to the browser, and a provider name may only be
151
- # registered once. This preset contributes the delegation TOOLS, which resolve
152
- # that host registry.
153
- #
154
- # `workflows` is different — nothing outside an agent reads it — so every row
155
- # that reaches it shares one entry-local realm here, and a consumer left
156
- # outside would resolve a host registry this preset does not populate.
157
- #
158
- # `tool-subagent-report` is host-plane for the same reason as the registry,
159
- # not because a preset may not want it: it registers a CONTINUABLE SETUP on
160
- # that singleton rather than a tool this agent calls, and the setup list is
161
- # not scope-aware — one copy per mounted preset means every child gets
162
- # `report` registered once per live session, which throws on the second.
163
- - id: delegation
164
- name: cordis:group
165
- group: true
166
- isolate:
167
- workflowEngine: true
168
- config:
169
- - id: tool-subagent-control
170
- name: '@deepseek-ai/dsh-tool-subagent-control'
171
-
172
- - id: tool-subagent-list-agents
173
- name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
174
-
175
- - id: tool-subagent
176
- name: '@deepseek-ai/dsh-tool-subagent'
177
- config:
178
- provider: spawn
179
- toolName: subagent
180
- backgroundMode: continuable
181
-
182
- - id: tool-subagent-fork
183
- name: '@deepseek-ai/dsh-tool-subagent'
184
- config:
185
- provider: fork
186
- toolName: subagent_fork
187
- backgroundMode: continuable
188
-
189
- # Production dsh does not install these optional providers. Install the
190
- # matching Bundle in this Profile and restart the Host, then copy this
191
- # preset and remove `disabled` from the matching tool row. Host availability
192
- # alone grants no tool.
193
- - id: tool-subagent-codex
194
- name: '@deepseek-ai/dsh-tool-subagent'
195
- disabled: true
196
- config:
197
- provider: codex
198
- toolName: subagent_codex
199
- backgroundMode: one-shot
200
- maxDepth: provider-managed
201
-
202
- - id: tool-subagent-claude-code
203
- name: '@deepseek-ai/dsh-tool-subagent'
204
- disabled: true
205
- config:
206
- provider: claude-code
207
- toolName: subagent_claude_code
208
- backgroundMode: one-shot
209
- maxDepth: provider-managed
210
-
211
- - id: workflow-worker-thread
212
- name: '@deepseek-ai/dsh-workflow-worker-thread'
213
- config:
214
- provider: spawn
215
-
216
- - id: tool-workflow
217
- name: '@deepseek-ai/dsh-tool-workflow'
218
-
219
- - id: tool-ralph
220
- name: '@deepseek-ai/dsh-tool-ralph'
221
- config:
222
- subagentProvider: spawn
223
- maxRounds: 64
224
-
225
- # ── remaining model-facing rows ─────────────────────────────────────────────
226
-
227
- - id: tool-ask-user
228
- name: '@deepseek-ai/dsh-tool-ask-user'
229
-
230
- - id: tool-todo
231
- name: '@deepseek-ai/dsh-tool-todo'
232
- config:
233
- allowParallelInProgress: true
234
-
235
- # The `web` service and its search provider stay in the host composition; only
236
- # the model-facing tool is per-session.
237
- - id: tool-web
238
- name: '@deepseek-ai/dsh-tool-web'
239
- config:
240
- fetch: false
241
- searchTimeoutMs: 60000