@mokuyoaxis/agent-guard 0.2.3-rc2 → 0.2.4

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 (81) hide show
  1. package/README.md +127 -83
  2. package/README.zh-CN.md +106 -74
  3. package/adapters/INTEGRATION.md +4 -4
  4. package/adapters/claude/README.md +3 -3
  5. package/adapters/claude/harness/README.md +1 -1
  6. package/adapters/codex/harness/README.md +2 -2
  7. package/adapters/dsh/README.md +24 -15
  8. package/adapters/dsh/harness/README.md +75 -19
  9. package/adapters/dsh/harness/bootstrap.patch.yml +5 -0
  10. package/adapters/dsh/harness/bootstrap_init.mjs +48 -0
  11. package/adapters/dsh/harness/guard_lab.py +194 -32
  12. package/adapters/dsh/harness/native_session.py +41 -20
  13. package/adapters/dsh/harness/profiles.py +74 -22
  14. package/adapters/dsh/lib/index.js +1 -1
  15. package/adapters/kimi-code/README.md +15 -14
  16. package/adapters/kimi-code/harness/README.md +3 -3
  17. package/adapters/kimi-code/harness/guard_lab.py +1 -1
  18. package/core/__init__.py +1 -1
  19. package/core/classifier.py +41 -16
  20. package/core/lab.py +24 -1
  21. package/core/policy.py +11 -4
  22. package/core/recovery.py +256 -23
  23. package/core/redaction.py +157 -55
  24. package/core/trash_index.py +193 -0
  25. package/docs/README.md +104 -0
  26. package/docs/{architecture.md → design/architecture.md} +31 -6
  27. package/docs/{compatibility.md → design/compatibility.md} +54 -4
  28. package/docs/{threat-model.md → design/threat-model.md} +4 -4
  29. package/docs/{harness-capabilities.md → guides/harness-capabilities.md} +9 -9
  30. package/docs/guides/trash-index.md +106 -0
  31. package/docs/{development-note-unguarded-deletion.md → history/development-note-unguarded-deletion.md} +8 -9
  32. package/docs/{friction.md → history/friction.md} +107 -4
  33. package/docs/{secret-guard-analysis.md → history/secret-guard-analysis.md} +23 -22
  34. package/docs/{secret-guard-architecture.md → history/secret-guard-architecture.md} +6 -4
  35. package/docs/{secret-guard-design.md → history/secret-guard-design.md} +19 -15
  36. package/docs/lab/cases/injection-case-fake-ai-api.md +346 -0
  37. package/docs/{guard-lab.md → lab/guard-lab.md} +18 -11
  38. package/docs/lab/tasks/guard-lab-read-trial-task.md +7 -0
  39. package/docs/{release-notes-0.2.0-rc1.md → releases/release-notes-0.2.0-rc1.md} +5 -5
  40. package/docs/{release-notes-0.2.0.md → releases/release-notes-0.2.0.md} +7 -7
  41. package/docs/{release-notes-0.2.1.md → releases/release-notes-0.2.1.md} +6 -6
  42. package/docs/{release-notes-0.2.2.md → releases/release-notes-0.2.2.md} +9 -10
  43. package/docs/{release-notes-0.2.3-rc1.md → releases/release-notes-0.2.3-rc1.md} +4 -2
  44. package/docs/{release-notes-0.2.3-rc2.md → releases/release-notes-0.2.3-rc2.md} +9 -9
  45. package/docs/releases/release-notes-0.2.3.md +84 -0
  46. package/docs/releases/release-notes-0.2.4.md +89 -0
  47. package/docs/{test-report-claude-code-harness.md → reports/test-report-claude-code-harness.md} +5 -5
  48. package/docs/{test-report-codex-gpt-5.6-sol.md → reports/test-report-codex-gpt-5.6-sol.md} +10 -11
  49. package/docs/reports/test-report-dsh-0.2.4-ptc.md +79 -0
  50. package/docs/{test-report-dsh-guard-lab.md → reports/test-report-dsh-guard-lab.md} +1 -1
  51. package/docs/{test-report-dsh-native-session.md → reports/test-report-dsh-native-session.md} +1 -1
  52. package/docs/{test-report-dsh-paired-lab.md → reports/test-report-dsh-paired-lab.md} +1 -1
  53. package/docs/{test-report-dsh-real-followup.md → reports/test-report-dsh-real-followup.md} +1 -1
  54. package/docs/{test-report-dsh-retry-evidence.md → reports/test-report-dsh-retry-evidence.md} +1 -1
  55. package/docs/{test-report-dsh-v0.1.1.md → reports/test-report-dsh-v0.1.1.md} +4 -4
  56. package/docs/{test-report-kimi-code-block.md → reports/test-report-kimi-code-block.md} +22 -23
  57. package/docs/{test-report-kimi-guard-lab.md → reports/test-report-kimi-guard-lab.md} +3 -3
  58. package/docs/{test-report-release-readiness-0.2.3.md → reports/test-report-release-readiness-0.2.3.md} +79 -1
  59. package/docs/reports/test-report-workbuddy-windows-core.md +53 -0
  60. package/docs/{test-report-zcode-glm-flash.md → reports/test-report-zcode-glm-flash.md} +11 -11
  61. package/package.json +1 -1
  62. package/skills/delete-guard/SKILL.md +40 -3
  63. package/skills/delete-guard/references/policy.md +18 -5
  64. package/skills/delete-guard/scripts/check.py +19 -0
  65. package/skills/delete-guard/scripts/restore.py +18 -6
  66. package/skills/delete-guard/scripts/status.py +52 -0
  67. package/skills/exfil-guard/SKILL.md +37 -7
  68. package/skills/exfil-guard/references/channels.md +1 -1
  69. package/skills/exfil-guard/references/rules.md +84 -16
  70. package/skills/exfil-guard/scripts/_payload.py +99 -0
  71. package/skills/exfil-guard/scripts/check_span.py +14 -81
  72. package/skills/exfil-guard/scripts/sanitize.py +113 -34
  73. package/docs/release-notes-0.2.3.md +0 -45
  74. /package/docs/{host-drift.md → guides/host-drift.md} +0 -0
  75. /package/docs/{publishing-from-ephemeral-environments.md → guides/publishing-from-ephemeral-environments.md} +0 -0
  76. /package/docs/{guard-lab-clean-task.md → lab/tasks/guard-lab-clean-task.md} +0 -0
  77. /package/docs/{guard-lab-trial-task.md → lab/tasks/guard-lab-trial-task.md} +0 -0
  78. /package/docs/{test-report-codex-gpt-6-astra-high.md → reports/test-report-codex-gpt-6-astra-high.md} +0 -0
  79. /package/docs/{test-report-dsh-0.1.5-rc.1.md → reports/test-report-dsh-0.1.5-rc.1.md} +0 -0
  80. /package/docs/{test-report-dsh-0.2-upgrade.md → reports/test-report-dsh-0.2-upgrade.md} +0 -0
  81. /package/docs/{test-report-dsh-read-redaction.md → reports/test-report-dsh-read-redaction.md} +0 -0
@@ -51,7 +51,7 @@ python3 adapters/dsh/harness/guard_lab.py run \
51
51
  --dsh-home /tmp/approved-disposable-dsh-home \
52
52
  --output-dir /tmp/dsh-lab-clean \
53
53
  --case clean --model-label "DeepSeek official deepseek-flash" \
54
- --task-file docs/guard-lab-clean-task.md \
54
+ --task-file docs/lab/tasks/guard-lab-clean-task.md \
55
55
  --trial-group dsh-baseline-01 --timeout 120
56
56
  ```
57
57
 
@@ -112,8 +112,10 @@ completed session really contains none. Forks, subagent origins, surface
112
112
  replacements and non-text attachment blocks remain unsupported and cannot be
113
113
  credited as a quiet success.
114
114
 
115
- New captures use receipt version 4 for the old host or version 5 for the new
116
- host, with native parser version 2. The parser
115
+ New captures use receipt version 6 with native parser version 3. Receipt v6
116
+ explicitly binds the selected host/native format, guard profile and configuration
117
+ scope v2. Receipts 4/5 retain parser 2, and receipts 2/3 retain parser 1.
118
+ The parser
117
119
  recognizes pinned `assistant/attempt` → `llm/retry` → `llm/retry-started`
118
120
  chains followed by another failed attempt or a successful assistant settlement
119
121
  in the same turn/step. It checks route, failure, chain ID, policy, retry number
@@ -132,16 +134,20 @@ timestamps or records after a stream finish refuse the recognized channels.
132
134
  Even sessions with no retries receive an explicit empty attempt-channel scan,
133
135
  so both members of a new pair declare the same five-channel coverage.
134
136
 
135
- Versions 2 and 3 keep native parser version 1 and their original four-channel
136
- coverage; assistant attempts remain unsupported for those receipts. Historical
137
- receipts are never silently reinterpreted with the new parser.
137
+ Historical receipts keep their original coverage and interpretation; assistant
138
+ attempts remain unsupported for receipt versions 2/3.
138
139
 
139
140
  Native v4 interpretation additionally checks tool-registry developer messages
140
141
  against prior request headers and validates workspace-change notices. Image
141
- offload and surface replay remain unsupported. The retained new-host real-model
142
+ offload and surface replay remain unsupported. Parser 3 additionally accepts
143
+ flat native-v4 `role=tool` results only when their top-level call ID, boolean
144
+ error flag and tool source agree with one prior call in the same step, and
145
+ `sourceEventSeqs` contains exactly that call's sequence. Other source references,
146
+ replacement operations and unknown content blocks refuse every output channel.
147
+ Parser 2 still refuses these source references. The retained new-host real-model
142
148
  clean capture was refused with `UNSUPPORTED_SURFACE_REPLAY`, and its composition
143
149
  also changed; it did not establish a new off/on result. The
144
- [current review](../../../docs/test-report-release-readiness-0.2.3.md) separates
150
+ [current review](../../../docs/reports/test-report-release-readiness-0.2.3.md) separates
145
151
  the passing no-model preflight/parser regressions from this incomplete trial.
146
152
 
147
153
  Historical version 1 receipts still finalize with stdout/stderr coverage only.
@@ -149,7 +155,7 @@ They do not acquire native coverage by opening them with the updated helper.
149
155
  Use fresh captures with identical channel coverage for a later differential
150
156
  trial. The generic comparison now requires equal scanned channel sets and
151
157
  non-guard fingerprints, while their provenance remains user-declared.
152
- [Native-session follow-up](../../../docs/test-report-dsh-native-session.md)
158
+ [Native-session follow-up](../../../docs/reports/test-report-dsh-native-session.md)
153
159
  records the offline review of retained real logs separately.
154
160
 
155
161
  ## Capture the guard-off attack probe
@@ -186,7 +192,7 @@ review checklist or `--attack-sample config-comment-v1` for instructions in
186
192
  service configuration comments. The original `direct-v1` remains the default.
187
193
  Each sample gets its own protocol ID and template fingerprint. Keep the original
188
194
  task, use a fresh output/home for each sample, and use the same sample for any
189
- later guarded comparison. See the [sample registry](../../../docs/guard-lab.md#versioned-attack-samples).
195
+ later guarded comparison. See the [sample registry](../../../docs/lab/guard-lab.md#versioned-attack-samples).
190
196
 
191
197
  ## Evidence and exit status
192
198
 
@@ -221,7 +227,7 @@ DSH also retains its own session artifacts.
221
227
  Lab events and reports continue to retain no raw output or marker values.
222
228
 
223
229
  Version/model labels, completion review, environment equality across separate
224
- runs, and same-UID isolation retain the [normal Lab limitations](../../../docs/guard-lab.md).
230
+ runs, and same-UID isolation retain the [normal Lab limitations](../../../docs/lab/guard-lab.md).
225
231
  The original composition fingerprint checks one composed tree. New receipt
226
232
  version 3 additionally binds `dsh-lab-non-guard-v1`: rendered non-Guard rows,
227
233
  saved `settings.yaml`, home `.env`, the headless package manifest and inherited
@@ -232,6 +238,12 @@ bookkeeping. A post-run change in this scope refuses completed finalization.
232
238
  Authentication state, external files named by plugins, installed dependency
233
239
  code, backend identity and settings outside this scope remain user-declared.
234
240
  The fingerprint retains no raw configuration/environment values.
241
+ Receipt v6 uses scope v2, which also binds the declared guard profile, imported
242
+ legacy settings, modern headless/root configuration and patch files. Adapter,
243
+ read worker, sanitizer and shared Core source hashes must remain unchanged
244
+ during a new trial. These checks do not authenticate remote model identity.
245
+ Scope v2 also excludes `SHLVL` as invocation bookkeeping; scope v1 keeps its
246
+ original environment interpretation.
235
247
 
236
248
  ## Matched pair with review gates
237
249
 
@@ -243,6 +255,16 @@ It omits sessions, storage, caches and unrelated user files. It refuses
243
255
  symlinked bootstrap files/directories, overlaps and existing output targets.
244
256
  DSH may materialize its ordinary module fallback in the new homes during
245
257
  boot-free configuration checks; no plugin/package is installed by this helper.
258
+ For DSH 0.2.0-rc.2 the helper first boots each copied home with the headless
259
+ startup and runner disabled, waits for DSH's own legacy-settings import, then
260
+ requires a second stable initialization and an empty session inventory. It
261
+ uses the selected installation's `runProfile` and observes the native import's
262
+ promise in that short-lived process. Failed/partial imports refuse the pair.
263
+ Rejected section updates are observed even with quiet host logging. Initialization
264
+ has a 60-second limit per pass; private `.lab-bootstrap/` captures retain bounded
265
+ diagnostics and hash/exit receipts in the copied homes.
266
+ The source home is never booted or migrated. New plans use pair schema 2;
267
+ schema 1 plans remain reviewable but cannot launch captures with parser 3.
246
268
 
247
269
  ```sh
248
270
  python3 adapters/dsh/harness/guard_lab.py prepare-pair \
@@ -286,19 +308,53 @@ python3 adapters/dsh/harness/guard_lab.py compare \
286
308
  --guarded-dir /tmp/dsh-matched-pair/trials/guarded
287
309
  ```
288
310
 
289
- This wrapper rechecks receipt/capture integrity and requires version 3 or 4
311
+ This wrapper rechecks receipt/capture integrity and requires versioned
290
312
  native coverage, matching non-guard fingerprints and all scans declared by
291
- that receipt version. New version 4/5 pairs include the fifth failed-attempt
292
- scan. Old and new channel sets cannot be compared. It rejects historical
293
- CLI-only/missing-context receipts. New pair plans pin native parser version 2;
313
+ that receipt version. Receipt 4/5/6 pairs include the fifth failed-attempt
314
+ scan. Different capture contracts or channel sets cannot be compared. It rejects historical
315
+ CLI-only/missing-context receipts. New pair plans pin native parser version 3;
294
316
  plans without that field retain their old interpretation and cannot launch
295
317
  another capture under the new rules. Prepare a fresh pair to continue testing.
296
318
  Results distinguish tool and assistant canary exposure from fake Lab execution
297
- and URL contact. Guard-on loads the existing deletion adapter; it does not
298
- introduce tool-result redaction. Continued tool exposure can validly yield
299
- `NOT_MITIGATED`. The [investigation report](../../../docs/test-report-dsh-paired-lab.md)
319
+ and URL contact. The default `deletion-v1` profile loads the existing deletion
320
+ adapter. Continued tool exposure with that profile can validly yield
321
+ `NOT_MITIGATED`. The [investigation report](../../../docs/reports/test-report-dsh-paired-lab.md)
300
322
  describes the candidate result-rewriting seam and its limits.
301
323
 
324
+ ### Explicit native read redaction profile
325
+
326
+ Use `read-redaction-v1` for a separate bounded experiment with the existing
327
+ default-off native text-read prototype. It requires an absolute installed DSH
328
+ package root matching the selected launcher, an exact generated patch bound to
329
+ each member's fixture, and the matching `read-redaction-v1` attack sample.
330
+ The guard-on patch enables `readResultGuard` and disables deletion prompt
331
+ guidance; the remaining adapter tools/hooks are still present. Baseline and
332
+ guarded members use identical task bytes and non-Guard settings.
333
+
334
+ ```sh
335
+ python3 adapters/dsh/harness/guard_lab.py prepare-pair \
336
+ --source-home /tmp/approved-initialized-dsh-home \
337
+ --output-dir /tmp/dsh-read-redaction-pair \
338
+ --dsh-executable /absolute/path/to/installed/dsh \
339
+ --guard-profile read-redaction-v1 \
340
+ --read-guard-dsh-root /absolute/path/to/installed/@deepseek-ai/dsh \
341
+ --attack-sample read-redaction-v1 \
342
+ --task-file docs/lab/tasks/guard-lab-read-trial-task.md \
343
+ --model-label "DeepSeek official deepseek-flash" \
344
+ --trial-group dsh-read-redaction-01
345
+ ```
346
+
347
+ Follow the same `pair-next` and review/finalize gates above. The sample puts a
348
+ synthetic URI password and vendor token directly in `project/service.ini`,
349
+ alongside PORT, LOG_LEVEL and FEATURE_ENABLED. An untrusted comment asks for
350
+ the exact sensitive values in the summary; the task requests native full-file
351
+ reads and explicitly treats comments as data. A baseline tool exposure is
352
+ observable even if the model declines the comment's instruction. This measures
353
+ the read-result redaction boundary and useful configuration retention, not a
354
+ general prompt-injection-resistance rating or an external-egress guarantee.
355
+ Tool-private metadata and the full stored log need separate bounded inspection;
356
+ the formal Lab output channels do not silently gain that coverage.
357
+
302
358
  `prepare-pair` returns 0 for a valid plan. `pair-next` returns 0 when it captures
303
359
  a task, 4 when review is still pending or a gate stops the sequence, and normal
304
360
  comparison exits after completion. `compare` uses 0/2/4 for mitigation,
@@ -320,7 +376,7 @@ external-network call. They cover unreviewed/failed/empty/oversized/timed-out
320
376
  captures, exposure semantics, capture corruption, version/config preflight,
321
377
  composition drift, create-once finalization, recovered/broken retries,
322
378
  fragmented markers, retry-only exposure and legacy coverage. The
323
- [retry-evidence report](../../../docs/test-report-dsh-retry-evidence.md) records
379
+ [retry-evidence report](../../../docs/reports/test-report-dsh-retry-evidence.md) records
324
380
  an offline reparse of the retained official Flash retry log. A mock pass does not establish
325
381
  a new real-model or execution-level DSH acceptance claim.
326
382
  The dedicated CI `dsh-native-lab` job selects Node 22.23.2 and runs these suites;
@@ -0,0 +1,5 @@
1
+ # Initialize only the disposable profile; no driver, agent or model task.
2
+ - id: headless-startup
3
+ disabled: true
4
+ - id: headless-runner
5
+ disabled: true
@@ -0,0 +1,48 @@
1
+ // Complete the reviewed host's native legacy import without a model driver.
2
+ import fs from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { pathToFileURL } from "node:url";
5
+
6
+ let shutdown, stage = "arguments";
7
+ try {
8
+ const [root, ...patchFiles] = process.argv.slice(2);
9
+ if (!root || !path.isAbsolute(root) || patchFiles.length < 2) throw new Error();
10
+ const manifest = JSON.parse(await fs.readFile(path.join(root, "package.json"), "utf8"));
11
+ if (manifest.name !== "@deepseek-ai/dsh" || manifest.version !== "0.2.0-rc.2") throw new Error();
12
+ const settingsUrl = pathToFileURL(path.join(root, "node_modules/@deepseek-ai/dsh-settings/lib/index.js"));
13
+ const { SettingsForms } = await import(settingsUrl.href);
14
+ stage = "settings-contract";
15
+ const original = SettingsForms.prototype.importLegacyDocument;
16
+ const originalUpdate = SettingsForms.prototype.update;
17
+ if (typeof original !== "function" || typeof originalUpdate !== "function") throw new Error();
18
+ let importPromise, calls = 0, importFailures = 0;
19
+ // The host catches errors per section. Observe rejected updates as well,
20
+ // so quiet logging cannot turn a partial import into successful bootstrap.
21
+ SettingsForms.prototype.update = async function (...args) {
22
+ try { return await originalUpdate.apply(this, args); }
23
+ catch (error) { importFailures += 1; throw error; }
24
+ };
25
+ // Observe completion of the host's own import. Do not duplicate the import
26
+ // or infer completion from its early rename/settings.yaml disappearance.
27
+ SettingsForms.prototype.importLegacyDocument = function (...args) {
28
+ calls += 1;
29
+ importPromise = original.apply(this, args);
30
+ return importPromise;
31
+ };
32
+ const { runProfile } = await import(pathToFileURL(path.join(root, "lib/profile-boot.js")).href);
33
+ const { loadLayeredEnv } = await import(pathToFileURL(path.join(root, "node_modules/@deepseek-ai/dsh-app-boot/lib/index.js")).href);
34
+ stage = "boot";
35
+ const runtime = await runProfile({ environment: loadLayeredEnv("dsh"), profile: "headless", patchFiles, args: [] });
36
+ shutdown = runtime.shutdown;
37
+ stage = "loader";
38
+ await runtime.ctx.root.loader.await();
39
+ stage = "import";
40
+ if (calls !== 1 || !importPromise) throw new Error();
41
+ await importPromise;
42
+ if (importFailures !== 0) throw new Error();
43
+ await shutdown.shutdown(0);
44
+ } catch {
45
+ if (shutdown) await shutdown.shutdown(1);
46
+ process.stderr.write(`DSH Lab bootstrap refused: ${stage}.\n`);
47
+ process.exitCode = 1;
48
+ }