@huaweidevtools/aishell-dsh-huaweicloud-docs 0.0.15 → 0.0.16

package/README.md

@@ -20,13 +20,9 @@ authority.
 
 The index itself is ~35 KB of product names — real value, but a per-turn cost of roughly 9k tokens, of which any one task needs a single entry. So the section carries the pointer, and the model fetches the index — and then the one product under it — with the web-fetch tool it already has. That is the shape `llms.txt` exists for.
 
-The URL answers: `https://support.huaweicloud.com/llms.txt` returns the index as `text/plain` (~35 KB), and each product entry links to that product's own file — ECS, for one, resolves to ~500 KB of real documentation. `web_fetch`'s User-Agent is `deepseek-harness/0.0.1 (+https://github.com/deepseek-ai)`.
-
-That User-Agent is not something the model can set. `web_fetch` exposes no header parameter — the value is a plugin `Config` field (`userAgent`) defaulting to the constant above. So any instruction to fetch with a particular browser User-Agent is unactionable for the model, and this package issues none.
-
 ## Where it sits in the prompt
 
-Early — immediately after the deployment persona prefix, ahead of every policy and tool section. Background knowledge is worth having before the model starts planning, rather than discovering it once it reaches the tool list.
+Early — immediately after the deployment persona prefix, ahead of every policy and tool section. Background knowledge belongs before the model starts planning, rather than arriving once it has already reached the tool list.
 
 Measured against the real `SystemPrompt` service, the assembled prompt reads:
 
@@ -39,7 +35,9 @@ tool:*                    1000+
 deployment:persona-suffix   10200
 ```
 
-So it lands inside the persona envelope (the prefix opens at `0`, the suffix closes at `10200`) and before every policy and tool slot. The position is a number (`HUAWEICLOUD_DOCS_ORDER = 100`) rather than one of the framework's named slots, because its placement table is closed: `PromptSectionOrderName` is `keyof` a fixed constant, so a `HUAWEICLOUD_DOCS` name has nowhere to go. The table leaves the gap between `0` and `500` empty, and `100` sits inside it.
+So it lands inside the persona envelope (the prefix opens at `0`, the suffix closes at `10200`) and before every policy and tool slot.
+
+The position is a number (`HUAWEICLOUD_DOCS_ORDER = 100`) rather than one of the framework's named slots, because its placement table is closed: `PromptSectionOrderName` is `keyof` a fixed constant, so a `HUAWEICLOUD_DOCS` name has nowhere to go. The table leaves the gap between `0` and `500` empty, and `100` sits inside it. The orders bracketing that gap are the only two available — below `0` is before the persona opens, and at or above `500` is inside the policy band, where background reads as an instruction.
 
 A section rather than a runtime context because the URL never changes. `context()` is for facts that flip — the read-only policy uses it for exactly that reason — and a constant belongs in a section.
 

package/lib/index.js

@@ -2,18 +2,18 @@
 /**
 * Position of the documentation pointer in the assembled prompt.
 *
-* A number, not a name, because the framework's placement table is closed:
-* `PromptSectionOrderName` is `keyof` a fixed constant, and
-* `getSectionOrder('HUAWEICLOUD_DOCS')` would return `undefined` — there is no
-* slot for product-domain background. Every shipped plugin reads a name from
-* that table, so this is the one place this package departs from them.
+* A number rather than one of the framework's named slots, because its
+* placement table is closed: `PromptSectionOrderName` is `keyof` a fixed
+* constant, so `getSectionOrder('HUAWEICLOUD_DOCS')` returns `undefined` —
+* there is no slot for product-domain background.
 *
-* The table's own entries leave the gap between the persona prefix (0) and the
-* first policy (500) empty, and 100 sits inside it. Note that "ahead of the
-* persona" would be wrong as well as worse: the persona opens at 0, so the only
-* order that precedes it is a negative one — before `harness:identity` at
-* -1000, i.e. before the prompt has said what it is. 100 puts this after the
-* persona and before anything the model is asked to reason about.
+* The table leaves the gap between the persona prefix (0) and the first policy
+* (500) empty, and 100 sits inside it. The two orders that bracket that gap are
+* the only two that exist: below 0 is before the persona opens, which is before
+* `harness:identity` at -1000 — ahead of the prompt having said what it is —
+* and at or above 500 is inside the policy band, where background reads as an
+* instruction. 100 puts this after the persona opens and before anything the
+* model is asked to reason about.
 */
 const HUAWEICLOUD_DOCS_ORDER = 100;
 /** Name this contribution registers under; unique across the assembled prompt. */
@@ -23,8 +23,8 @@ const DOCS_INDEX_URL = "https://support.huaweicloud.com/llms.txt";
 /**
 * What the model reads.
 *
-* The last sentence is the load-bearing one: a model asked about a product's
-* quotas or billing will otherwise answer from memory, and those numbers move
+* The last sentence carries the weight: a model asked about a product's quotas
+* or billing answers from memory unless told not to, and those numbers move
 * between releases. Naming the authority is what makes the pointer worth
 * carrying.
 */

package/lib/types/index.d.ts

@@ -22,13 +22,13 @@
  * ## Where it sits in the prompt
  *
  * Early: immediately after the deployment persona prefix, ahead of every policy
- * and tool section. Background knowledge is worth reading before the model
- * starts planning — it should know where to look things up, not discover it
- * once it has reached the tool list.
+ * and tool section. Background knowledge belongs before the model starts
+ * planning — it should know where to look things up, not discover it once it has
+ * reached the tool list.
  *
- * Measured, not asserted — mounting this plugin against the real `SystemPrompt`
- * service renders, in order: `harness:identity`, the persona prefix, this
- * section, then the policy and tool slots, then the persona suffix.
+ * Measured against the real `SystemPrompt` service, the assembled prompt reads
+ * `harness:identity`, the persona prefix, this section, then the policy and
+ * tool slots, then the persona suffix.
  *
  * @module @huaweidevtools/aishell-dsh-huaweicloud-docs
  */
@@ -36,18 +36,18 @@ import type { Context } from '@deepseek-ai/cordis';
 /**
  * Position of the documentation pointer in the assembled prompt.
  *
- * A number, not a name, because the framework's placement table is closed:
- * `PromptSectionOrderName` is `keyof` a fixed constant, and
- * `getSectionOrder('HUAWEICLOUD_DOCS')` would return `undefined` — there is no
- * slot for product-domain background. Every shipped plugin reads a name from
- * that table, so this is the one place this package departs from them.
+ * A number rather than one of the framework's named slots, because its
+ * placement table is closed: `PromptSectionOrderName` is `keyof` a fixed
+ * constant, so `getSectionOrder('HUAWEICLOUD_DOCS')` returns `undefined` —
+ * there is no slot for product-domain background.
  *
- * The table's own entries leave the gap between the persona prefix (0) and the
- * first policy (500) empty, and 100 sits inside it. Note that "ahead of the
- * persona" would be wrong as well as worse: the persona opens at 0, so the only
- * order that precedes it is a negative one — before `harness:identity` at
- * -1000, i.e. before the prompt has said what it is. 100 puts this after the
- * persona and before anything the model is asked to reason about.
+ * The table leaves the gap between the persona prefix (0) and the first policy
+ * (500) empty, and 100 sits inside it. The two orders that bracket that gap are
+ * the only two that exist: below 0 is before the persona opens, which is before
+ * `harness:identity` at -1000 — ahead of the prompt having said what it is —
+ * and at or above 500 is inside the policy band, where background reads as an
+ * instruction. 100 puts this after the persona opens and before anything the
+ * model is asked to reason about.
  */
 export declare const HUAWEICLOUD_DOCS_ORDER = 100;
 /** Name this contribution registers under; unique across the assembled prompt. */
@@ -57,8 +57,8 @@ export declare const DOCS_INDEX_URL = "https://support.huaweicloud.com/llms.txt"
 /**
  * What the model reads.
  *
- * The last sentence is the load-bearing one: a model asked about a product's
- * quotas or billing will otherwise answer from memory, and those numbers move
+ * The last sentence carries the weight: a model asked about a product's quotas
+ * or billing answers from memory unless told not to, and those numbers move
  * between releases. Naming the authority is what makes the pointer worth
  * carrying.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@huaweidevtools/aishell-dsh-huaweicloud-docs",
   "description": "Points DSH's model at Huawei Cloud's product documentation index (support.huaweicloud.com/llms.txt)",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "publishConfig": {
     "access": "public"
   },