@hagicode/hagitask 0.1.0-dev.11 → 0.1.0-dev.13

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 (2) hide show
  1. package/README.md +42 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -151,6 +151,48 @@ command preludes remain supported.
151
151
  Community packages use the identical values, so a package can move between
152
152
  `presets/<presetTaskId>/` and the community repository without rewriting references.
153
153
 
154
+ ## Well-Known Input: `omitNonInteractiveHints`
155
+
156
+ `omitNonInteractiveHints` is a reserved, optional, boolean system input for prompt
157
+ packages. It tells the template whether interactive control is enabled for the agent CLI
158
+ that runs the task. A package that wants to follow the switch declares the input in
159
+ `backend/prompts.json`:
160
+
161
+ ```json
162
+ {
163
+ "name": "omitNonInteractiveHints",
164
+ "source": "system",
165
+ "required": false,
166
+ "description": "Optional. True when interactive control is enabled for the agent CLI running this prompt."
167
+ }
168
+ ```
169
+
170
+ and gates its run-mode declaration in each template that carries one:
171
+
172
+ ```handlebars
173
+ {{#unless omitNonInteractiveHints}}
174
+ ## Run mode
175
+ This prompt is running in a non-interactive environment.
176
+ {{/unless}}
177
+ ```
178
+
179
+ - **What to gate.** The whole run-mode section: the "non-interactive" declaration, its
180
+ prohibitions of interactive tools or follow-up questions, and the default-choice rules
181
+ written inside it. Keep everything outside that section, including scope boundaries,
182
+ output format, and inline body requirements such as "if details are missing, make a
183
+ reasonable assumption". A statement that the package's own requirements demand (for
184
+ example "do not claim extra skills configuration is required") may stay under an
185
+ `{{else}}` branch with a neutral heading.
186
+ - **Absent means today's prompt.** A value that is absent, or `false`, renders exactly the
187
+ prompt that existed before the gate. A package that never references the input renders
188
+ the same way with any value.
189
+ - **The backend supplies the value.** The host reads the stored interactive-control entry
190
+ of the agent CLI that runs the task and passes it at render time. It is not a creation
191
+ parameter: package panels, `inputBindings` and create requests must not declare or send it.
192
+ Packages that adopt the input should keep it out of their panel and binding definitions.
193
+ - **Wording only.** The switch never changes which runs may ask the user a question. It
194
+ only decides whether the gated run-mode text is rendered.
195
+
154
196
  ## Publication Data Flow
155
197
 
156
198
  ```mermaid
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hagicode/hagitask",
3
- "version": "0.1.0-dev.11",
3
+ "version": "0.1.0-dev.13",
4
4
  "description": "Offline HagiTask package schemas, validation API, and CLI.",
5
5
  "license": "MIT",
6
6
  "type": "module",