agentic-engineering-harness 0.6.27 → 0.6.29

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 (202) hide show
  1. package/README.md +3 -3
  2. package/dist/agents/permissions.js +12 -0
  3. package/dist/agents/permissions.js.map +1 -1
  4. package/dist/audit/run.js +2 -0
  5. package/dist/audit/run.js.map +1 -1
  6. package/dist/cli.js +12 -13
  7. package/dist/cli.js.map +1 -1
  8. package/dist/context/budget.d.ts +4 -0
  9. package/dist/context/budget.js +19 -0
  10. package/dist/context/budget.js.map +1 -0
  11. package/dist/context/classifier.d.ts +4 -0
  12. package/dist/context/classifier.js +14 -0
  13. package/dist/context/classifier.js.map +1 -0
  14. package/dist/context/compression/headroom.d.ts +18 -0
  15. package/dist/context/compression/headroom.js +53 -0
  16. package/dist/context/compression/headroom.js.map +1 -0
  17. package/dist/context/compression/index.d.ts +3 -0
  18. package/dist/context/compression/index.js +4 -0
  19. package/dist/context/compression/index.js.map +1 -0
  20. package/dist/context/compression/lifecycle.d.ts +20 -0
  21. package/dist/context/compression/lifecycle.js +70 -0
  22. package/dist/context/compression/lifecycle.js.map +1 -0
  23. package/dist/context/compression/types.d.ts +27 -0
  24. package/dist/context/compression/types.js +2 -0
  25. package/dist/context/compression/types.js.map +1 -0
  26. package/dist/context/envelope.d.ts +4 -0
  27. package/dist/context/envelope.js +20 -0
  28. package/dist/context/envelope.js.map +1 -0
  29. package/dist/context/estimator.d.ts +3 -0
  30. package/dist/context/estimator.js +10 -0
  31. package/dist/context/estimator.js.map +1 -0
  32. package/dist/context/eval.d.ts +19 -0
  33. package/dist/context/eval.js +12 -0
  34. package/dist/context/eval.js.map +1 -0
  35. package/dist/context/gateway.d.ts +22 -0
  36. package/dist/context/gateway.js +202 -0
  37. package/dist/context/gateway.js.map +1 -0
  38. package/dist/context/index.d.ts +15 -0
  39. package/dist/context/index.js +16 -0
  40. package/dist/context/index.js.map +1 -0
  41. package/dist/context/policy.d.ts +6 -0
  42. package/dist/context/policy.js +40 -0
  43. package/dist/context/policy.js.map +1 -0
  44. package/dist/context/preflight.d.ts +13 -0
  45. package/dist/context/preflight.js +25 -0
  46. package/dist/context/preflight.js.map +1 -0
  47. package/dist/context/projectors/audit.d.ts +2 -0
  48. package/dist/context/projectors/audit.js +30 -0
  49. package/dist/context/projectors/audit.js.map +1 -0
  50. package/dist/context/projectors/diff.d.ts +2 -0
  51. package/dist/context/projectors/diff.js +8 -0
  52. package/dist/context/projectors/diff.js.map +1 -0
  53. package/dist/context/projectors/explorer.d.ts +2 -0
  54. package/dist/context/projectors/explorer.js +5 -0
  55. package/dist/context/projectors/explorer.js.map +1 -0
  56. package/dist/context/projectors/index.d.ts +8 -0
  57. package/dist/context/projectors/index.js +9 -0
  58. package/dist/context/projectors/index.js.map +1 -0
  59. package/dist/context/projectors/operation.d.ts +3 -0
  60. package/dist/context/projectors/operation.js +26 -0
  61. package/dist/context/projectors/operation.js.map +1 -0
  62. package/dist/context/projectors/planner.d.ts +2 -0
  63. package/dist/context/projectors/planner.js +5 -0
  64. package/dist/context/projectors/planner.js.map +1 -0
  65. package/dist/context/projectors/source.d.ts +2 -0
  66. package/dist/context/projectors/source.js +5 -0
  67. package/dist/context/projectors/source.js.map +1 -0
  68. package/dist/context/projectors/structured.d.ts +2 -0
  69. package/dist/context/projectors/structured.js +24 -0
  70. package/dist/context/projectors/structured.js.map +1 -0
  71. package/dist/context/projectors/validation.d.ts +3 -0
  72. package/dist/context/projectors/validation.js +25 -0
  73. package/dist/context/projectors/validation.js.map +1 -0
  74. package/dist/context/provenance.d.ts +3 -0
  75. package/dist/context/provenance.js +13 -0
  76. package/dist/context/provenance.js.map +1 -0
  77. package/dist/context/repository/graphify.d.ts +3 -0
  78. package/dist/context/repository/graphify.js +7 -0
  79. package/dist/context/repository/graphify.js.map +1 -0
  80. package/dist/context/repository/index.d.ts +6 -0
  81. package/dist/context/repository/index.js +7 -0
  82. package/dist/context/repository/index.js.map +1 -0
  83. package/dist/context/repository/map.d.ts +6 -0
  84. package/dist/context/repository/map.js +34 -0
  85. package/dist/context/repository/map.js.map +1 -0
  86. package/dist/context/repository/rank.d.ts +3 -0
  87. package/dist/context/repository/rank.js +43 -0
  88. package/dist/context/repository/rank.js.map +1 -0
  89. package/dist/context/repository/render.d.ts +8 -0
  90. package/dist/context/repository/render.js +21 -0
  91. package/dist/context/repository/render.js.map +1 -0
  92. package/dist/context/repository/serena.d.ts +11 -0
  93. package/dist/context/repository/serena.js +26 -0
  94. package/dist/context/repository/serena.js.map +1 -0
  95. package/dist/context/repository/types.d.ts +34 -0
  96. package/dist/context/repository/types.js +2 -0
  97. package/dist/context/repository/types.js.map +1 -0
  98. package/dist/context/retrieval/authorization.d.ts +11 -0
  99. package/dist/context/retrieval/authorization.js +9 -0
  100. package/dist/context/retrieval/authorization.js.map +1 -0
  101. package/dist/context/retrieval/gateway.d.ts +33 -0
  102. package/dist/context/retrieval/gateway.js +69 -0
  103. package/dist/context/retrieval/gateway.js.map +1 -0
  104. package/dist/context/retrieval/index.d.ts +5 -0
  105. package/dist/context/retrieval/index.js +6 -0
  106. package/dist/context/retrieval/index.js.map +1 -0
  107. package/dist/context/retrieval/mcp.d.ts +3 -0
  108. package/dist/context/retrieval/mcp.js +8 -0
  109. package/dist/context/retrieval/mcp.js.map +1 -0
  110. package/dist/context/retrieval/persisted.d.ts +3 -0
  111. package/dist/context/retrieval/persisted.js +22 -0
  112. package/dist/context/retrieval/persisted.js.map +1 -0
  113. package/dist/context/retrieval/server.d.ts +1 -0
  114. package/dist/context/retrieval/server.js +52 -0
  115. package/dist/context/retrieval/server.js.map +1 -0
  116. package/dist/context/telemetry.d.ts +3 -0
  117. package/dist/context/telemetry.js +9 -0
  118. package/dist/context/telemetry.js.map +1 -0
  119. package/dist/context/types.d.ts +243 -0
  120. package/dist/context/types.js +29 -0
  121. package/dist/context/types.js.map +1 -0
  122. package/dist/core/config.js +19 -1
  123. package/dist/core/config.js.map +1 -1
  124. package/dist/core/doctor.js +23 -2
  125. package/dist/core/doctor.js.map +1 -1
  126. package/dist/core/run.js +35 -14
  127. package/dist/core/run.js.map +1 -1
  128. package/dist/core/types.d.ts +52 -0
  129. package/dist/core/verify.d.ts +2 -0
  130. package/dist/core/verify.js +1 -1
  131. package/dist/core/verify.js.map +1 -1
  132. package/dist/entry.js +30 -0
  133. package/dist/entry.js.map +1 -1
  134. package/dist/evals/fullStack.d.ts +17 -0
  135. package/dist/evals/fullStack.js +42 -0
  136. package/dist/evals/fullStack.js.map +1 -0
  137. package/dist/main.js +1 -0
  138. package/dist/main.js.map +1 -1
  139. package/dist/operations/change.js +2 -0
  140. package/dist/operations/change.js.map +1 -1
  141. package/dist/paseo/launchSpec.d.ts +3 -0
  142. package/dist/paseo/launchSpec.js +17 -0
  143. package/dist/paseo/launchSpec.js.map +1 -1
  144. package/dist/provenance/generate.d.ts +19 -0
  145. package/dist/provenance/generate.js +94 -8
  146. package/dist/provenance/generate.js.map +1 -1
  147. package/dist/providers/engram.d.ts +26 -1
  148. package/dist/providers/engram.js +110 -6
  149. package/dist/providers/engram.js.map +1 -1
  150. package/dist/providers/graphify.d.ts +9 -1
  151. package/dist/providers/graphify.js +34 -16
  152. package/dist/providers/graphify.js.map +1 -1
  153. package/dist/providers/graphifyModel.d.ts +23 -0
  154. package/dist/providers/graphifyModel.js +101 -0
  155. package/dist/providers/graphifyModel.js.map +1 -0
  156. package/dist/providers/headroom.d.ts +2 -0
  157. package/dist/providers/headroom.js +3 -0
  158. package/dist/providers/headroom.js.map +1 -0
  159. package/dist/providers/memory.d.ts +1 -0
  160. package/dist/providers/memory.js +2 -0
  161. package/dist/providers/memory.js.map +1 -0
  162. package/dist/providers/serena.d.ts +1 -0
  163. package/dist/providers/serena.js +2 -0
  164. package/dist/providers/serena.js.map +1 -0
  165. package/dist/providers/types.d.ts +25 -2
  166. package/dist/telemetry/events.d.ts +1 -0
  167. package/dist/telemetry/events.js +19 -2
  168. package/dist/telemetry/events.js.map +1 -1
  169. package/dist/telemetry/otlp.d.ts +6 -1
  170. package/dist/telemetry/otlp.js +2 -2
  171. package/dist/telemetry/otlp.js.map +1 -1
  172. package/dist/toolchain/config.js +10 -1
  173. package/dist/toolchain/config.js.map +1 -1
  174. package/dist/toolchain/resolve.js +8 -0
  175. package/dist/toolchain/resolve.js.map +1 -1
  176. package/dist/validators/external.js +24 -3
  177. package/dist/validators/external.js.map +1 -1
  178. package/dist/validators/graphify.js +5 -73
  179. package/dist/validators/graphify.js.map +1 -1
  180. package/dist/validators/opa.d.ts +14 -1
  181. package/dist/validators/opa.js +6 -2
  182. package/dist/validators/opa.js.map +1 -1
  183. package/dist/validators/toolEvidence.d.ts +29 -0
  184. package/dist/validators/toolEvidence.js +104 -0
  185. package/dist/validators/toolEvidence.js.map +1 -0
  186. package/dist/workers/agentPrompt.d.ts +9 -0
  187. package/dist/workers/agentPrompt.js +133 -4
  188. package/dist/workers/agentPrompt.js.map +1 -1
  189. package/docs/ARCHITECTURE.md +20 -1
  190. package/docs/COMPONENT_MATURITY.md +43 -0
  191. package/docs/CONTEXT_EFFICIENCY.md +48 -0
  192. package/docs/MEMORY.md +9 -0
  193. package/docs/OBSERVABILITY.md +6 -1
  194. package/docs/OSS_STACK.md +10 -2
  195. package/docs/SECURITY.md +12 -0
  196. package/package.json +2 -2
  197. package/policies/core/trust-boundary.rego +14 -4
  198. package/presets/agents/default.jsonc +4 -4
  199. package/presets/agents/orchestration.jsonc +2 -2
  200. package/schemas/project.schema.json +14 -0
  201. package/templates/project.yaml +42 -0
  202. package/templates/toolchain.yaml +34 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/context/compression/lifecycle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import type { ContextFragment } from "../types.js";
2
+ export interface ProviderHealth {
3
+ ok: boolean;
4
+ message: string;
5
+ version?: string;
6
+ }
7
+ export interface ContextCompressionRequest {
8
+ operationId: string;
9
+ fragment: ContextFragment;
10
+ maxTokens?: number;
11
+ sourceSha256: string;
12
+ }
13
+ export interface ContextCompressionResult {
14
+ content: string;
15
+ provider: string;
16
+ providerVersion?: string;
17
+ reversible: boolean;
18
+ handle?: string;
19
+ originalTokens: number;
20
+ compressedTokens: number;
21
+ }
22
+ export interface ContextCompressionProvider {
23
+ readonly name: string;
24
+ doctor(root: string): Promise<ProviderHealth>;
25
+ compress(root: string, request: ContextCompressionRequest): Promise<ContextCompressionResult>;
26
+ }
27
+ export type { HeadroomRuntimeHandle, HeadroomRuntimeOptions } from "./lifecycle.js";
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/context/compression/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import type { ContextEnvelope } from "./types.js";
2
+ export declare function buildContextEnvelope(input: Omit<ContextEnvelope, "provenance">): ContextEnvelope;
3
+ export declare function verifyContextEnvelope(envelope: ContextEnvelope): boolean;
4
+ export declare function renderContextEnvelope(envelope: ContextEnvelope): string;
@@ -0,0 +1,20 @@
1
+ import { assertContextEnvelope } from "./types.js";
2
+ import { CONTEXT_PROJECTION_VERSION, sha256, stableJson } from "./provenance.js";
3
+ export function buildContextEnvelope(input) {
4
+ const base = { ...input, provenance: { sha256: "", createdAt: new Date().toISOString(), projectionVersion: CONTEXT_PROJECTION_VERSION } };
5
+ const digest = sha256(stableJson({ ...base, provenance: { ...base.provenance, sha256: undefined } }));
6
+ return assertContextEnvelope({ ...base, provenance: { ...base.provenance, sha256: digest } });
7
+ }
8
+ export function verifyContextEnvelope(envelope) {
9
+ const expected = sha256(stableJson({ ...envelope, provenance: { ...envelope.provenance, sha256: undefined } }));
10
+ return expected === envelope.provenance.sha256;
11
+ }
12
+ export function renderContextEnvelope(envelope) {
13
+ const sections = envelope.fragments.map((fragment) => {
14
+ const source = fragment.source?.artifact ? ` source=${fragment.source.artifact}` : "";
15
+ const mode = fragment.compressed ? "compressed" : fragment.projected ? "projected" : fragment.preservation.toLowerCase();
16
+ return `### ${fragment.kind}:${fragment.id} [${mode}, ${fragment.estimatedTokens} tokens]${source}\n${fragment.content}`;
17
+ });
18
+ return [`AEH ContextEnvelope v${envelope.version} operation=${envelope.operationId} agent=${envelope.logicalAgent} phase=${envelope.phase}`, ...sections, envelope.retrieval.available ? "AEH raw context is retrievable only through authorized fragment IDs." : "Raw context retrieval is not exposed by this transport; use the delivered bounded projections."].join("\n\n");
19
+ }
20
+ //# sourceMappingURL=envelope.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/context/envelope.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEjF,MAAM,UAAU,oBAAoB,CAAC,KAA0C;IAC7E,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,EAAE,CAAC;IAC1I,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IACtG,OAAO,qBAAqB,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAyB;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;IAChH,OAAO,QAAQ,KAAK,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAyB;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAmC,EAAE,EAAE;QAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QACzH,OAAO,OAAO,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,EAAE,KAAK,IAAI,KAAK,QAAQ,CAAC,eAAe,WAAW,MAAM,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC3H,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,wBAAwB,QAAQ,CAAC,OAAO,cAAc,QAAQ,CAAC,WAAW,UAAU,QAAQ,CAAC,YAAY,UAAU,QAAQ,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,sEAAsE,CAAC,CAAC,CAAC,gGAAgG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnX,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** Deterministic, dependency-free estimate used for selection. Provider token usage remains authoritative when available. */
2
+ export declare function estimateTokens(value: string): number;
3
+ export declare function estimateBytes(value: string): number;
@@ -0,0 +1,10 @@
1
+ /** Deterministic, dependency-free estimate used for selection. Provider token usage remains authoritative when available. */
2
+ export function estimateTokens(value) {
3
+ if (!value)
4
+ return 0;
5
+ return Math.max(1, Math.ceil(value.replace(/\r\n/g, "\n").length / 4));
6
+ }
7
+ export function estimateBytes(value) {
8
+ return Buffer.byteLength(value, "utf8");
9
+ }
10
+ //# sourceMappingURL=estimator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"estimator.js","sourceRoot":"","sources":["../../src/context/estimator.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAC7H,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}
@@ -0,0 +1,19 @@
1
+ import type { ContextMetrics } from "./types.js";
2
+ export interface ContextEvaluationSample {
3
+ variant: "baseline" | "observe" | "enforce" | string;
4
+ success: boolean;
5
+ costUsd?: number;
6
+ metrics: ContextMetrics;
7
+ }
8
+ export interface ContextEvaluationSummary {
9
+ variant: string;
10
+ sampleSize: number;
11
+ successfulOperations: number;
12
+ successRate: number;
13
+ medianDeliveredTokenReduction: number;
14
+ uncachedInputReduction?: number;
15
+ costPerSuccessfulOperation?: number;
16
+ tokensPerSuccessfulOperation?: number;
17
+ projectionEscapeRate: number;
18
+ }
19
+ export declare function summarizeContextEvaluation(samples: ContextEvaluationSample[], variant: string): ContextEvaluationSummary;
@@ -0,0 +1,12 @@
1
+ export function summarizeContextEvaluation(samples, variant) {
2
+ const selected = samples.filter((sample) => sample.variant === variant);
3
+ const successful = selected.filter((sample) => sample.success);
4
+ const reductions = selected.map((sample) => sample.metrics.estimatedRawTokens ? 1 - sample.metrics.estimatedDeliveredTokens / sample.metrics.estimatedRawTokens : 0).sort((a, b) => a - b);
5
+ const costs = successful.map((sample) => sample.costUsd).filter((value) => value !== undefined);
6
+ const tokens = successful.map((sample) => sample.metrics.estimatedDeliveredTokens);
7
+ return { variant, sampleSize: selected.length, successfulOperations: successful.length, successRate: selected.length ? successful.length / selected.length : 0, medianDeliveredTokenReduction: median(reductions), uncachedInputReduction: selected.length ? average(selected.map((sample) => sample.metrics.estimatedRawTokens ? 1 - sample.metrics.estimatedDeliveredTokens / sample.metrics.estimatedRawTokens : 0)) : undefined, costPerSuccessfulOperation: costs.length && successful.length ? costs.reduce((sum, value) => sum + value, 0) / successful.length : undefined, tokensPerSuccessfulOperation: tokens.length ? tokens.reduce((sum, value) => sum + value, 0) / tokens.length : undefined, projectionEscapeRate: selected.length ? average(selected.map((sample) => sample.metrics.retrievedFragments ? sample.metrics.retrievalEscapes / sample.metrics.retrievedFragments : 0)) : 0 };
8
+ }
9
+ function median(values) { if (!values.length)
10
+ return 0; const middle = Math.floor(values.length / 2); return values.length % 2 ? values[middle] : (values[middle - 1] + values[middle]) / 2; }
11
+ function average(values) { return values.length ? values.reduce((sum, value) => sum + value, 0) / values.length : 0; }
12
+ //# sourceMappingURL=eval.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"eval.js","sourceRoot":"","sources":["../../src/context/eval.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import type { HarnessProjectConfig } from "../core/types.js";
2
+ import type { ContextCompressionProvider } from "./compression/types.js";
3
+ import type { ContextPreparationRequest, ContextPreparationResult } from "./types.js";
4
+ export interface ContextBudgetGatewayOptions {
5
+ compressor?: ContextCompressionProvider;
6
+ persist?: boolean;
7
+ telemetry?: boolean;
8
+ }
9
+ export declare class ContextBudgetGateway {
10
+ private readonly root;
11
+ private readonly config;
12
+ private readonly compressor?;
13
+ private readonly persist;
14
+ private readonly telemetry;
15
+ constructor(root: string, config: HarnessProjectConfig, options?: ContextBudgetGatewayOptions);
16
+ prepare(request: ContextPreparationRequest): Promise<ContextPreparationResult>;
17
+ private optimizeFragment;
18
+ private persistRawFragment;
19
+ private persistEnvelope;
20
+ private emitTelemetry;
21
+ }
22
+ export declare function prepareContext(root: string, config: HarnessProjectConfig, request: ContextPreparationRequest, options?: ContextBudgetGatewayOptions): Promise<ContextPreparationResult>;
@@ -0,0 +1,202 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { recordEvent } from "../telemetry/events.js";
4
+ import { resolveContextBudget } from "./budget.js";
5
+ import { canLossyCompress, classifyFragment, isRequired as isRequiredFragment } from "./classifier.js";
6
+ import { estimateBytes, estimateTokens } from "./estimator.js";
7
+ import { buildContextEnvelope, renderContextEnvelope } from "./envelope.js";
8
+ import { resolveContextPolicy } from "./policy.js";
9
+ import { sha256 } from "./provenance.js";
10
+ import { projectAudit, projectDiff, projectOperation, projectSource, projectValidation } from "./projectors/index.js";
11
+ import { authorizeRetrieval } from "./retrieval/authorization.js";
12
+ import { ContextRetrievalGateway } from "./retrieval/gateway.js";
13
+ import { HeadroomCompressionProvider } from "./compression/headroom.js";
14
+ import { recordContextMetrics } from "./telemetry.js";
15
+ export class ContextBudgetGateway {
16
+ root;
17
+ config;
18
+ compressor;
19
+ persist;
20
+ telemetry;
21
+ constructor(root, config, options = {}) {
22
+ this.root = root;
23
+ this.config = config;
24
+ const provider = config.context?.compression?.provider ?? "headroom";
25
+ this.compressor = options.compressor ?? (provider === "headroom" ? new HeadroomCompressionProvider(config.context?.compression?.command ? { command: config.context.compression.command } : {}) : undefined);
26
+ this.persist = options.persist ?? true;
27
+ this.telemetry = options.telemetry ?? true;
28
+ }
29
+ async prepare(request) {
30
+ const policy = resolveContextPolicy(this.config);
31
+ const budget = resolveContextBudget(this.config, request.role ?? request.logicalAgent, request.phase);
32
+ const durable = await Promise.all(request.fragments.map((fragment) => this.persistRawFragment(request.operationId, fragment)));
33
+ const rawBytes = durable.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
34
+ const rawTokens = durable.reduce((sum, fragment) => sum + estimateTokens(fragment.content), 0);
35
+ const candidates = [];
36
+ for (const fragment of durable) {
37
+ classifyFragment(fragment);
38
+ const optimized = await this.optimizeFragment(fragment, request.operationId, policy.compression.minTokens, request.capabilities?.authorizedRetrieval !== false);
39
+ candidates.push({ raw: fragment, optimized });
40
+ }
41
+ const enforced = policy.mode === "enforce";
42
+ const delivered = enforced ? selectWithinBudget(candidates.map((candidate) => candidate.optimized), budget.maxTokens - budget.reserved.response) : durable.map(projectSource);
43
+ const deliveredIds = new Set(delivered.map((fragment) => fragment.id));
44
+ const discarded = durable.filter((fragment) => !deliveredIds.has(fragment.id));
45
+ const retrievalAvailable = request.capabilities?.authorizedRetrieval !== false;
46
+ const envelope = buildContextEnvelope({ version: 1, operationId: request.operationId, logicalAgent: request.logicalAgent, phase: request.phase, budget: { maximum: budget.maxTokens, estimatedDelivered: delivered.reduce((sum, fragment) => sum + fragment.estimatedTokens, 0) }, fragments: delivered, retrieval: { available: retrievalAvailable, allowedFragmentIds: retrievalAvailable ? delivered.map((fragment) => fragment.id) : [] } });
47
+ if (this.persist)
48
+ await this.persistEnvelope(request.operationId, envelope);
49
+ const rendered = renderContextEnvelope(envelope);
50
+ const metrics = metricsFor(durable, candidates.map((candidate) => candidate.optimized), delivered, discarded);
51
+ const retrieval = new ContextRetrievalGateway(authorizeRetrieval({ root: this.root, operationId: request.operationId, logicalAgent: request.logicalAgent, allowedFragmentIds: retrievalAvailable ? delivered.map((fragment) => fragment.id) : [], fragments: durable }), policy.retrieval);
52
+ if (this.telemetry && this.config.telemetry?.enabled !== false)
53
+ await this.emitTelemetry(request, metrics, envelope);
54
+ return { envelope, rendered, metrics, retrieval: { root: this.root, operationId: request.operationId, logicalAgent: request.logicalAgent, allowedFragmentIds: [...envelope.retrieval.allowedFragmentIds] } };
55
+ }
56
+ async optimizeFragment(fragment, operationId, minCompressionTokens, authorizedRetrieval) {
57
+ const originalTokens = estimateTokens(fragment.content);
58
+ if (isRequiredFragment(fragment))
59
+ return projectSource(fragment);
60
+ if (fragment.preservation === "DISCARDABLE")
61
+ return { ...fragment, content: "", estimatedTokens: 0, originalTokens, projected: true };
62
+ if (fragment.preservation === "RETRIEVABLE" && authorizedRetrieval) {
63
+ const content = `[Retrievable ${fragment.kind} '${fragment.id}' (${originalTokens} tokens); use aeh_context_retrieve for the authorized raw artifact.]`;
64
+ return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens, projected: true };
65
+ }
66
+ // Direct Codex and hardened Podman do not necessarily expose the AEH MCP
67
+ // retrieval server. Deliver an equivalent bounded projection instead of
68
+ // advertising a tool the transport cannot call.
69
+ if (fragment.preservation === "RETRIEVABLE")
70
+ return genericProjection(fragment);
71
+ let projected;
72
+ switch (fragment.kind) {
73
+ case "validation":
74
+ projected = projectValidation(fragment);
75
+ break;
76
+ case "audit":
77
+ projected = projectAudit(fragment);
78
+ break;
79
+ case "operation":
80
+ projected = projectOperation(fragment);
81
+ break;
82
+ case "diff":
83
+ projected = projectDiff(fragment);
84
+ break;
85
+ case "source":
86
+ projected = projectSource(fragment);
87
+ break;
88
+ case "repository-map":
89
+ projected = projectSource(fragment);
90
+ break;
91
+ case "tool-output":
92
+ projected = genericProjection(fragment);
93
+ break;
94
+ case "memory":
95
+ projected = genericProjection(fragment);
96
+ break;
97
+ case "instruction":
98
+ case "execution-envelope":
99
+ case "agent-charter":
100
+ case "skill":
101
+ case "handoff":
102
+ case "delivery":
103
+ case "normative":
104
+ projected = projectSource(fragment);
105
+ break;
106
+ case "raw-evidence":
107
+ projected = genericProjection(fragment);
108
+ break;
109
+ default: projected = projectSource(fragment);
110
+ }
111
+ if (this.compressor && canLossyCompress(fragment) && originalTokens >= minCompressionTokens) {
112
+ try {
113
+ const compression = await this.compressor.compress(this.root, { operationId, fragment, maxTokens: Math.max(1, Math.floor(originalTokens * 0.7)), sourceSha256: fragment.source?.sha256 ?? sha256(fragment.content) });
114
+ if (compression.compressedTokens < projected.estimatedTokens)
115
+ return { ...projected, content: compression.content, estimatedTokens: compression.compressedTokens, compressed: true, compression: { provider: compression.provider, providerVersion: compression.providerVersion, reversible: compression.reversible, handle: compression.handle } };
116
+ }
117
+ catch (error) {
118
+ if (this.config.context?.compression?.required !== false)
119
+ throw error;
120
+ // Optional compression failure falls back to deterministic projection.
121
+ }
122
+ }
123
+ return projected;
124
+ }
125
+ async persistRawFragment(operationId, fragment) {
126
+ if (!this.persist)
127
+ return { ...fragment, source: { ...fragment.source, sha256: fragment.source?.sha256 ?? sha256(fragment.content) } };
128
+ const relative = fragment.source?.artifact ?? path.posix.join(".harness", "context", safeSegment(operationId), `${safeSegment(fragment.id)}.raw`);
129
+ const absolute = safePath(this.root, relative);
130
+ await fs.mkdir(path.dirname(absolute), { recursive: true });
131
+ let actual;
132
+ try {
133
+ const existing = await fs.readFile(absolute);
134
+ actual = sha256(existing);
135
+ if (fragment.source?.sha256 && fragment.source.sha256 !== actual)
136
+ throw new Error(`Context source hash mismatch for '${relative}'.`);
137
+ if (!fragment.source?.sha256 && existing.toString("utf8") !== fragment.content)
138
+ throw new Error(`Context source artifact '${relative}' does not match the supplied content.`);
139
+ }
140
+ catch (error) {
141
+ if (error instanceof Error && error.message.includes("Context source"))
142
+ throw error;
143
+ await fs.writeFile(absolute, fragment.content, { encoding: "utf8", flag: "wx" }).catch(async (writeError) => {
144
+ if (writeError.code !== "EEXIST")
145
+ throw writeError;
146
+ });
147
+ actual = sha256(fragment.content);
148
+ }
149
+ return { ...fragment, source: { ...fragment.source, artifact: relative, sha256: actual } };
150
+ }
151
+ async persistEnvelope(operationId, envelope) {
152
+ const file = safePath(this.root, path.posix.join(".harness", "context", safeSegment(operationId), "envelope.json"));
153
+ await fs.mkdir(path.dirname(file), { recursive: true });
154
+ await fs.writeFile(file, `${JSON.stringify(envelope, null, 2)}\n`, "utf8");
155
+ }
156
+ async emitTelemetry(request, metrics, envelope) {
157
+ const attributes = { operationId: request.operationId, logicalAgent: request.logicalAgent, phase: request.phase, envelopeSha256: envelope.provenance.sha256, rawBytes: metrics.rawBytes, projectedBytes: metrics.projectedBytes, deliveredBytes: metrics.deliveredBytes, estimatedRawTokens: metrics.estimatedRawTokens, estimatedDeliveredTokens: metrics.estimatedDeliveredTokens, deliveredFragments: metrics.deliveredFragments, compressedFragments: metrics.compressedFragments, discardedFragments: metrics.discardedFragments, projectionRatio: metrics.projectionRatio ?? 0, compressionRatio: metrics.compressionRatio ?? 0 };
158
+ await recordEvent(this.root, this.config, "harness.context.prepare", attributes);
159
+ await recordContextMetrics(this.root, this.config, envelope, metrics);
160
+ await recordEvent(this.root, this.config, "harness.context.deliver", { ...attributes, retrievalAvailable: envelope.retrieval.available });
161
+ }
162
+ }
163
+ export async function prepareContext(root, config, request, options = {}) {
164
+ return new ContextBudgetGateway(root, config, options).prepare(request);
165
+ }
166
+ function selectWithinBudget(fragments, maxTokens) {
167
+ const ordered = [...fragments].filter((fragment) => fragment.estimatedTokens > 0).sort((a, b) => Number(isRequiredProjection(b)) - Number(isRequiredProjection(a)) || b.priority - a.priority || a.id.localeCompare(b.id));
168
+ const selected = [];
169
+ let used = 0;
170
+ for (const fragment of ordered) {
171
+ if (used + fragment.estimatedTokens <= maxTokens) {
172
+ selected.push(fragment);
173
+ used += fragment.estimatedTokens;
174
+ continue;
175
+ }
176
+ if (isRequiredProjection(fragment))
177
+ throw new Error(`CONTEXT_BUDGET_EXCEEDED: required fragment '${fragment.id}' cannot be delivered without loss.`);
178
+ }
179
+ return selected;
180
+ }
181
+ function genericProjection(fragment) {
182
+ const lines = fragment.content.split(/\r?\n/);
183
+ const selected = lines.length <= 64 ? lines : [...lines.slice(0, 16), ...lines.filter((line) => /error|fail|warn|diagnostic|exception|stack/i.test(line)).slice(0, 32), ...lines.slice(-16)];
184
+ const content = [...new Set(selected)].join("\n") + (lines.length > selected.length ? "\n[non-authoritative repetitive lines projected; raw artifact is retrievable]" : "");
185
+ return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: lines.length > selected.length };
186
+ }
187
+ function metricsFor(raw, optimized, delivered, discarded) {
188
+ const rawTokens = raw.reduce((sum, fragment) => sum + estimateTokens(fragment.content), 0);
189
+ const projectedTokens = optimized.reduce((sum, fragment) => sum + estimateTokens(fragment.content), 0);
190
+ const deliveredTokens = delivered.reduce((sum, fragment) => sum + fragment.estimatedTokens, 0);
191
+ const rawBytes = raw.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
192
+ const projectedBytes = optimized.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
193
+ const deliveredBytes = delivered.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
194
+ const compressed = optimized.filter((fragment) => fragment.compressed).length;
195
+ return { rawBytes, projectedBytes, deliveredBytes, estimatedRawTokens: rawTokens, estimatedDeliveredTokens: deliveredTokens, retrievedFragments: 0, deliveredFragments: delivered.length, compressedFragments: compressed, discardedFragments: discarded.length, retrievalRequests: 0, retrievalRetries: 0, retrievalEscapes: 0, compressionRatio: rawTokens ? deliveredTokens / rawTokens : undefined, projectionRatio: rawTokens ? projectedTokens / rawTokens : undefined };
196
+ }
197
+ function safeSegment(value) { const sanitized = value.replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, ""); return sanitized || "fragment"; }
198
+ function safePath(root, relative) { if (path.isAbsolute(relative))
199
+ throw new Error("Context artifact paths must be relative to the project root."); const absoluteRoot = path.resolve(root); const absolute = path.resolve(absoluteRoot, relative); if (absolute !== absoluteRoot && !absolute.startsWith(`${absoluteRoot}${path.sep}`))
200
+ throw new Error("Context artifact path escapes the project root."); return absolute; }
201
+ function isRequiredProjection(fragment) { return fragment.preservation === "VERBATIM" || fragment.kind === "normative"; }
202
+ //# sourceMappingURL=gateway.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/context/gateway.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ export * from "./budget.js";
2
+ export * from "./classifier.js";
3
+ export * from "./compression/index.js";
4
+ export * from "./envelope.js";
5
+ export * from "./estimator.js";
6
+ export * from "./eval.js";
7
+ export * from "./gateway.js";
8
+ export * from "./policy.js";
9
+ export * from "./preflight.js";
10
+ export * from "./provenance.js";
11
+ export * from "./projectors/index.js";
12
+ export * from "./repository/index.js";
13
+ export * from "./retrieval/index.js";
14
+ export * from "./telemetry.js";
15
+ export * from "./types.js";
@@ -0,0 +1,16 @@
1
+ export * from "./budget.js";
2
+ export * from "./classifier.js";
3
+ export * from "./compression/index.js";
4
+ export * from "./envelope.js";
5
+ export * from "./estimator.js";
6
+ export * from "./eval.js";
7
+ export * from "./gateway.js";
8
+ export * from "./policy.js";
9
+ export * from "./preflight.js";
10
+ export * from "./provenance.js";
11
+ export * from "./projectors/index.js";
12
+ export * from "./repository/index.js";
13
+ export * from "./retrieval/index.js";
14
+ export * from "./telemetry.js";
15
+ export * from "./types.js";
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
@@ -0,0 +1,6 @@
1
+ import type { ContextConfiguration, HarnessProjectConfig } from "../core/types.js";
2
+ import type { ContextPolicy } from "./types.js";
3
+ export declare function resolveContextPolicy(config: HarnessProjectConfig | ContextConfiguration | undefined): ContextPolicy;
4
+ export declare function outputMode(policy: ContextPolicy, role: string | undefined): "terse" | "compact" | "normal";
5
+ export declare function isCompressionConfigured(policy: ContextPolicy): boolean;
6
+ export declare function outputPolicyInstruction(policy: ContextPolicy, role: string | undefined): string | undefined;
@@ -0,0 +1,40 @@
1
+ const defaultModes = {
2
+ explorer: "terse",
3
+ planner: "compact",
4
+ "spec-manager": "compact",
5
+ implementer: "compact",
6
+ reviewer: "compact",
7
+ "operation-supervisor": "terse"
8
+ };
9
+ export function resolveContextPolicy(config) {
10
+ const value = "context" in (config ?? {}) ? config.context : config;
11
+ const compression = value?.compression;
12
+ return {
13
+ mode: value?.mode ?? "enforce",
14
+ defaultBudget: value?.budgets?.default ?? { inputTokens: 16_000 },
15
+ agentBudgets: value?.budgets?.agents ?? {},
16
+ phaseBudgets: value?.budgets?.phases ?? {},
17
+ repositoryMap: { enabled: value?.repositoryMap?.enabled ?? true, tokenBudget: value?.repositoryMap?.tokenBudget ?? 2_000, maxGraphHops: value?.repositoryMap?.maxGraphHops ?? 2 },
18
+ semanticRetrieval: { provider: value?.semanticRetrieval?.provider ?? "serena", required: value?.semanticRetrieval?.required ?? true, editing: value?.semanticRetrieval?.editing ?? false },
19
+ compression: { provider: compression?.provider ?? "headroom", required: compression?.required ?? true, minTokens: compression?.minTokens ?? 2_000, reversible: compression?.reversible ?? true, command: compression?.command },
20
+ retrieval: { maxRequestsPerTurn: value?.retrieval?.maxRequestsPerTurn ?? 8, maxTokensPerRequest: value?.retrieval?.maxTokensPerRequest ?? 6_000, maxTotalTokensPerTurn: value?.retrieval?.maxTotalTokensPerTurn ?? 20_000 },
21
+ outputPolicy: { enabled: value?.outputPolicy?.enabled ?? true, modes: { ...defaultModes, ...(value?.outputPolicy?.modes ?? {}) } }
22
+ };
23
+ }
24
+ export function outputMode(policy, role) {
25
+ return policy.outputPolicy.modes[role ?? ""] ?? "compact";
26
+ }
27
+ export function isCompressionConfigured(policy) {
28
+ return policy.compression.provider === "headroom";
29
+ }
30
+ export function outputPolicyInstruction(policy, role) {
31
+ if (!policy.outputPolicy.enabled)
32
+ return undefined;
33
+ const mode = outputMode(policy, role);
34
+ if (mode === "terse")
35
+ return "Output policy: terse. Do not restate the assignment or narrate trivial successful tool calls. Prefer durable artifact references; preserve evidence, uncertainty, blockers and exact structured-result contracts.";
36
+ if (mode === "compact")
37
+ return "Output policy: compact. Explain meaningful decisions and blockers, omit ceremony and repetitive summaries, and preserve everything required for safe implementation/review. Never shorten structured-result JSON.";
38
+ return "Output policy: normal. Be concise but complete; preserve exact evidence and structured-result contracts.";
39
+ }
40
+ //# sourceMappingURL=policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/context/policy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { HarnessProjectConfig } from "../core/types.js";
2
+ export interface ContextReadiness {
3
+ ok: boolean;
4
+ checks: Array<{
5
+ component: string;
6
+ ok: boolean;
7
+ required: boolean;
8
+ message: string;
9
+ version?: string;
10
+ }>;
11
+ }
12
+ export declare function checkContextReadiness(root: string, config: HarnessProjectConfig): Promise<ContextReadiness>;
13
+ export declare function assertContextReadiness(root: string, config: HarnessProjectConfig): Promise<void>;
@@ -0,0 +1,25 @@
1
+ import { HeadroomCompressionProvider } from "./compression/headroom.js";
2
+ import { SerenaSemanticProvider } from "./repository/serena.js";
3
+ export async function checkContextReadiness(root, config) {
4
+ if (!config.context)
5
+ return { ok: true, checks: [] };
6
+ const checks = [];
7
+ const semanticProvider = config.context.semanticRetrieval?.provider ?? "serena";
8
+ if (semanticProvider !== "none") {
9
+ const semantic = await new SerenaSemanticProvider().doctor(root);
10
+ checks.push({ component: "serena", required: config.context.semanticRetrieval?.required ?? true, ...semantic });
11
+ }
12
+ const compressionProvider = config.context.compression?.provider ?? "headroom";
13
+ if (compressionProvider !== "none") {
14
+ const compression = await new HeadroomCompressionProvider({ command: config.context.compression?.command }).doctor(root);
15
+ checks.push({ component: "headroom", required: config.context.compression?.required ?? true, ...compression });
16
+ }
17
+ return { ok: checks.every((check) => !check.required || check.ok), checks };
18
+ }
19
+ export async function assertContextReadiness(root, config) {
20
+ const readiness = await checkContextReadiness(root, config);
21
+ const failures = readiness.checks.filter((check) => check.required && !check.ok);
22
+ if (failures.length)
23
+ throw new Error(`BLOCKED_EXTERNAL: mandatory context provider readiness failed. ${failures.map((failure) => `${failure.component}: ${failure.message}`).join("; ")}`);
24
+ }
25
+ //# sourceMappingURL=preflight.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/context/preflight.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAA4B;IACpF,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrD,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,IAAI,QAAQ,CAAC;IAChF,IAAI,gBAAgB,KAAK,MAAM,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,sBAAsB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,IAAI,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,IAAI,UAAU,CAAC;IAC/E,IAAI,mBAAmB,KAAK,MAAM,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,MAAM,IAAI,2BAA2B,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzH,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,IAAI,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAA4B;IACrF,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7L,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { ContextFragment, ContextFragmentProjection } from "../types.js";
2
+ export declare function projectAudit(fragment: ContextFragment): ContextFragmentProjection;
@@ -0,0 +1,30 @@
1
+ import { estimateTokens } from "../estimator.js";
2
+ export function projectAudit(fragment) {
3
+ const source = parseJson(fragment.content);
4
+ const findings = Array.isArray(source?.findings) ? source.findings : [];
5
+ const lines = findings.map((finding) => {
6
+ const item = record(finding);
7
+ return [item.id, item.severity, item.location, item.evidence, item.status].filter(Boolean).join(" | ");
8
+ });
9
+ const content = [
10
+ `findings=${findings.length}`,
11
+ ...lines,
12
+ "authoritative raw audit evidence is available through the fragment source"
13
+ ].join("\n");
14
+ return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: true };
15
+ }
16
+ function parseJson(content) { try {
17
+ const value = JSON.parse(content);
18
+ return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
19
+ }
20
+ catch {
21
+ return undefined;
22
+ } }
23
+ function record(value) {
24
+ if (!value || typeof value !== "object" || Array.isArray(value))
25
+ return {};
26
+ const item = value;
27
+ const location = item.location && typeof item.location === "object" ? JSON.stringify(item.location) : String(item.location ?? "");
28
+ return { id: String(item.id ?? ""), severity: String(item.severity ?? ""), location, evidence: String(item.evidence ?? item.summary ?? ""), status: String(item.status ?? "") };
29
+ }
30
+ //# sourceMappingURL=audit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/context/projectors/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG;QACd,YAAY,QAAQ,CAAC,MAAM,EAAE;QAC7B,GAAG,KAAK;QACR,2EAA2E;KAC5E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/I,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,IAAyC,IAAI,CAAC;IAAC,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAAC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,SAAS,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,SAAS,CAAC;AAAC,CAAC,CAAC,CAAC;AAC/Q,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3E,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAClI,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;AAClL,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { ContextFragment, ContextFragmentProjection } from "../types.js";
2
+ export declare function projectDiff(fragment: ContextFragment): ContextFragmentProjection;
@@ -0,0 +1,8 @@
1
+ import { estimateTokens } from "../estimator.js";
2
+ export function projectDiff(fragment) {
3
+ const lines = fragment.content.split(/\r?\n/);
4
+ const selected = lines.filter((line) => /^(diff --git|\+\+\+|---|@@|\+[^+]|-[^-])/.test(line));
5
+ const content = [...new Set(selected)].join("\n") || "No selected diff hunks; retrieve the authoritative diff artifact for exact anchors.";
6
+ return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: true };
7
+ }
8
+ //# sourceMappingURL=diff.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/context/projectors/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,WAAW,CAAC,QAAyB;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,0CAA0C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,qFAAqF,CAAC;IAC3I,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/I,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { ContextFragment, ContextFragmentProjection } from "../types.js";
2
+ export declare function projectExplorer(fragment: ContextFragment): ContextFragmentProjection;